New: utmpname(3) returns interger but man page says void

http://bugzilla.kernel.org/show_bug.cgi?id=11011

Summary: utmpname(3) returns interger but man page says void
Product: Documentation
Version: unspecified
KernelVersion: 2.6.9-1.667
Platform: All
OS/Version: Linux
Tree: Mainline
Status: NEW
Severity: normal
Priority: P1
Component: man-pages
AssignedTo: documentation_man-pages-ztI5WcYan/[email protected]
ReportedBy: [email protected]

In the link
http://www.gnu.org/software/libtool/manual/libc/Manipulating-the-Database.html

It has mentioned that
"The utmpname function returns a value of 0 if the new name was successfully stored, and a value of -1 to indicate an error. Note that utmpname does not try to open the database, and that therefore the return value does not say anything about whether the database can be successfully opened."

But in man page it says it return void in its prototype.

  void utmpname(const char *file);

In source code I have verified it returns int.

int
__utmpname (const char *file)
{
....
....
}

This is conflicting one and man page of utmpnae(3) needs to be fixed.

Configure bugmail: http://bugzilla.kernel.org/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
You are the assignee for the bug, or are watching the assignee.
--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to [email protected]
More majordomo info at  http://vger.kernel.org/majordomo-info.html

http://bugzilla.kernel.org/show_bug.cgi?id=11011

------- Comment #1 from [email protected] 2008-06-29 23:59 ------- Created an attachment (id=16659)
--> (http://bugzilla.kernel.org/attachment.cgi?id=16659&action=view)
Patch to fix the utmpname(3) man page.

Configure bugmail: http://bugzilla.kernel.org/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
You are the assignee for the bug, or are watching the assignee.
--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to [email protected]
More majordomo info at  http://vger.kernel.org/majordomo-info.html

http://bugzilla.kernel.org/show_bug.cgi?id=11011

[email protected] changed:

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

         AssignedTo|documentation_man-          |[email protected]
                   |pages-ztI5WcYan/[email protected]  |
             Status|NEW                         |ASSIGNED

Configure bugmail: http://bugzilla.kernel.org/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
You are the assignee for the bug, or are watching the assignee.
You are the assignee for the bug, or are watching the assignee.
--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to [email protected]
More majordomo info at  http://vger.kernel.org/majordomo-info.html