mirror of https://github.com/mkerrisk/man-pages
getgrnam.3: Clarify RETURN VALUE description
The page was a bit fuzzy in describing the return values for various cases. In particular, it needed to be more explicit in describing what happens for the "not found" case. http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=504708 Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com> Reported-by: Andreas Henriksson <andreas@fatal.se>
This commit is contained in:
parent
a6915393f0
commit
b006e083a0
|
@ -28,7 +28,7 @@
|
|||
.\" Modified 1993-07-24 by Rik Faith (faith@cs.unc.edu)
|
||||
.\" Modified 2003-11-15 by aeb
|
||||
.\"
|
||||
.TH GETGRNAM 3 2008-08-29 "" "Linux Programmer's Manual"
|
||||
.TH GETGRNAM 3 2008-11-07 "" "Linux Programmer's Manual"
|
||||
.SH NAME
|
||||
getgrnam, getgrnam_r, getgrgid, getgrgid_r \- get group file entry
|
||||
.SH SYNOPSIS
|
||||
|
@ -140,13 +140,19 @@ by subsequent calls to
|
|||
or
|
||||
.BR getgrnam ().
|
||||
.LP
|
||||
The
|
||||
On sucess,
|
||||
.BR getgrnam_r ()
|
||||
and
|
||||
.BR getgrgid_r ()
|
||||
functions return
|
||||
zero on success.
|
||||
In case of error, an error number is returned.
|
||||
return zero, and set
|
||||
.IR *gbufp
|
||||
to
|
||||
.IR gbuf .
|
||||
If no matching group record was found,
|
||||
these functions return 0 and store NULL in
|
||||
.IR *gbufp .
|
||||
In case of error, an error number is returned, and NULL is stored in
|
||||
.IR *gbufp .
|
||||
.SH ERRORS
|
||||
.TP
|
||||
.BR 0 " or " ENOENT " or " ESRCH " or " EBADF " or " EPERM " or ... "
|
||||
|
|
Loading…
Reference in New Issue