[Bug 220192] New: Duplicate size parameter in setxattr manpage

[Bug 220192] New: Duplicate size parameter in setxattr manpage

[bugzilla-daemon]

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: documentation_man-pages@kernel-bugs.osdl.org
          Reporter: paul.f.fee@gmail.com
        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.

-- 
You may reply to this email to add a comment.

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

[Bug 220192] Duplicate size parameter in setxattr manpage

[bugzilla-daemon]

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

Mark Naughton (mnaughto@redhat.com) changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
                 CC|                            |mnaughto@redhat.com

--- Comment #1 from Mark Naughton (mnaughto@redhat.com) ---
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

-- 
You may reply to this email to add a comment.

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

[Bug 220192] Duplicate size parameter in setxattr manpage

[bugzilla-daemon]

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

Paul Fee (paul.f.fee@gmail.com) changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
             Status|NEW                         |RESOLVED
         Resolution|---                         |ANSWERED

--- Comment #2 from Paul Fee (paul.f.fee@gmail.com) ---
Thanks for the prompt response and link to the explanation.  Closing as this is
not a bug.

-- 
You may reply to this email to add a comment.

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

[Bug 220192] Duplicate size parameter in setxattr manpage

[bugzilla-daemon]

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

Paul Fee (paul.f.fee@gmail.com) changed:

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

-- 
You may reply to this email to add a comment.

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