You can search the group database for information about a specific
group using getgrgid
or getgrnam
. These functions are
declared in `grp.h'.
getgrgid
.
A null pointer indicates there is no group with ID gid.
getgrgid
in that it returns
information about the group whose group ID is gid. However, it
fills the user supplied structure pointed to by result_buf with
the information instead of using a static buffer. The first
buflen bytes of the additional buffer pointed to by buffer
are used to contain additional information, normally strings which are
pointed to by the elements of the result structure.
If a group with ID gid is found, the pointer returned in
result points to the record which contains the wanted data (i.e.,
result contains the value result_buf). If no group is found
or if an error occurred, the pointer returned in result is a null
pointer. The function returns zero or an error code. If the buffer
buffer is too small to contain all the needed information, the
error code ERANGE
is returned and errno is set to
ERANGE
.
getgrnam
.
A null pointer indicates there is no group named name.
getgrnam
in that is returns
information about the group whose group name is name. Like
getgrgid_r
, it uses the user supplied buffers in
result_buf and buffer, not a static buffer.
The return values are the same as for getgrgid_r
ERANGE
.
Go to the first, previous, next, last section, table of contents.