getpwent.3, getpwnam.3: Note that pw_gecos is not in POSIX

And change the comment describing this field

Reported-by: Reuben Thomas <rrt@sc3d.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
This commit is contained in:
Michael Kerrisk 2010-10-21 11:31:23 +02:00
parent 59f65cfddc
commit 958680cd75
2 changed files with 8 additions and 2 deletions

View File

@ -89,7 +89,7 @@ struct passwd {
char *pw_passwd; /* user password */
uid_t pw_uid; /* user ID */
gid_t pw_gid; /* group ID */
char *pw_gecos; /* real name */
char *pw_gecos; /* user information */
char *pw_dir; /* home directory */
char *pw_shell; /* shell program */
};
@ -148,6 +148,9 @@ Insufficient buffer space supplied.
local password database file
.SH "CONFORMING TO"
SVr4, 4.3BSD, POSIX.1-2001.
The
.I pw_gecos
field is not specified in POSIX, but is present on most implementations.
.SH "SEE ALSO"
.BR fgetpwent (3),
.BR getpw (3),

View File

@ -93,7 +93,7 @@ struct passwd {
char *pw_passwd; /* user password */
uid_t pw_uid; /* user ID */
gid_t pw_gid; /* group ID */
char *pw_gecos; /* real name */
char *pw_gecos; /* user information */
char *pw_dir; /* home directory */
char *pw_shell; /* shell program */
};
@ -208,6 +208,9 @@ Insufficient buffer space supplied.
local password database file
.SH "CONFORMING TO"
SVr4, 4.3BSD, POSIX.1-2001.
The
.I pw_gecos
field is not specified in POSIX, but is present on most implementations.
.SH NOTES
The formulation given above under "RETURN VALUE" is from POSIX.1-2001.
It does not call "not found" an error, and hence does not specify what value