LDP
/
man-pages
mirror of https://github.com/mkerrisk/man-pages
0
1
Fork 0
Code Releases Activity

getgrnam.3: Rename arguments to getgrnam_r() and getgrgid_r() 

s/gbuf/grp/ and s/gbufp/result/, for consistency
with POSIX.1 argument names.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
This commit is contained in:
Michael Kerrisk 2008-11-07 16:32:52 -05:00
parent 3adc12e97f
commit 3b11a49415
1 changed files with 10 additions and 10 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

20
man3/getgrnam.3
View File

@ -40,13 +40,13 @@ getgrnam, getgrnam_r, getgrgid, getgrgid_r \- get group file entry
.sp
.BI "struct group *getgrgid(gid_t " gid );
.sp
.BI "int getgrnam_r(const char *" name ", struct group *" gbuf ,
.BI "int getgrnam_r(const char *" name ", struct group *" grp ,
.br
.BI " char *" buf ", size_t " buflen ", struct group **" gbufp );
.BI " char *" buf ", size_t " buflen ", struct group **" result );
.sp
.BI "int getgrgid_r(gid_t " gid ", struct group *" gbuf ,
.BI "int getgrgid_r(gid_t " gid ", struct group *" grp ,
.br
.BI " char *" buf ", size_t " buflen ", struct group **" gbufp );
.BI " char *" buf ", size_t " buflen ", struct group **" result );
.fi
.sp
.in -4n
@ -86,7 +86,7 @@ functions obtain the same information, but store the retrieved
.I group
structure
in the space pointed to by
.IR gbuf .
.IR grp .
This
.I group
structure contains pointers to strings, and these strings
@ -96,7 +96,7 @@ of size
.IR buflen .
A pointer to the result (in case of success) or NULL (in case no entry
was found or an error occurred) is stored in
.IR *gbufp .
.IR *result .
.PP
The \fIgroup\fP structure is defined in \fI<grp.h>\fP as follows:
.sp
@ -145,14 +145,14 @@ On success,
and
.BR getgrgid_r ()
return zero, and set
.IR *gbufp
.IR *result
to
.IR gbuf .
.IR grp .
If no matching group record was found,
these functions return 0 and store NULL in
.IR *gbufp .
.IR *result .
In case of error, an error number is returned, and NULL is stored in
.IR *gbufp .
.IR *result .
.SH ERRORS
.TP
.BR 0 " or " ENOENT " or " ESRCH " or " EBADF " or " EPERM " or ... "