Skip to contentSkip to conversation

New: Duplicate size parameter in setxattr manpage

Bug 220192 [email protected] 1 participant 4 messages Jun 4, 2025 Man-pages: manual pages for Linux -- Sections 2, 3, 4, 5, and 7

lore
Share & tools
lore
#0 lore raw

https://bugzilla.kernel.org/show_bug.cgi?id=220192

Bug ID: 220192
Summary: Duplicate size parameter in setxattr manpage
Product: Documentation
Version: unspecified
Hardware: All
OS: Linux
Status: NEW
Severity: normal
Priority: P3
Component: man-pages
Assignee: [email protected]
Reporter: [email protected]
Regression: No

The 6.14 man pages document the API of setxattr as:

int setxattr(size_t size;
const char *path, const char *name, const void value[size], size_t size, int flags);

The first parameter shouldn't be there, it should read:

int setxattr(const char *path, const char *name,

             const void *value[size], size_t size, int flags);

Detected on OpenSUSE Tumbleweed, package: man-pages-6.14-1.1.noarch.rpm Confirmed same issue in upstream tar file:
https://mirrors.edge.kernel.org/pub/linux/docs/man-pages/man-pages-6.14.tar.gz

Not present in 6.8 man pages (as used by Ubuntu 24.04). Flaw was introduced sometime afterwards.

Signature · 4 lines
You may reply to this email to add a comment.

You are receiving this mail because:
You are watching the assignee of the bug.
#1 lore raw

[Bug 220192] Duplicate size parameter in setxattr manpage

https://bugzilla.kernel.org/show_bug.cgi?id=220192

Mark Naughton ([email protected]) changed:

What |Removed |Added
----------------------------------------------------------------------------
CC| |[email protected]

--- Comment #1 from Mark Naughton ([email protected]) ---
This is a recent change made to the man pages to include a forward declaration before the arguments.

Please see this thread:
https://lore.kernel.org/linux-man/CACdZg2WJtzBYJS06vy4uLNaH2_N73Wn0HHJSSThD-F8QnX3d8Q@mail.gmail.com/T/#mc8f93664403f9eacc0add8f02bea4c760dc26499

I agree this is a confusing change and will cause problems as it gets rolled out to more distros.

Mark

Signature · 4 lines
You may reply to this email to add a comment.

You are receiving this mail because:
You are watching the assignee of the bug.
#2 lore raw

[Bug 220192] Duplicate size parameter in setxattr manpage

In reply to [email protected]

https://bugzilla.kernel.org/show_bug.cgi?id=220192

Paul Fee ([email protected]) changed:

What |Removed |Added
----------------------------------------------------------------------------

             Status|NEW                         |RESOLVED
         Resolution|---                         |ANSWERED

--- Comment #2 from Paul Fee ([email protected]) ---
Thanks for the prompt response and link to the explanation. Closing as this is not a bug.

Signature · 4 lines
You may reply to this email to add a comment.

You are receiving this mail because:
You are watching the assignee of the bug.
#3 lore raw

[Bug 220192] Duplicate size parameter in setxattr manpage

In reply to [email protected]

https://bugzilla.kernel.org/show_bug.cgi?id=220192

Paul Fee ([email protected]) changed:

What |Removed |Added
----------------------------------------------------------------------------
Status|RESOLVED |CLOSED

Signature · 4 lines
You may reply to this email to add a comment.

You are receiving this mail because:
You are watching the assignee of the bug.