Warning: main(/www/www/htdocs/style/globals.php) [function.main]: failed to open stream: No such file or directory in /www/www/docs/6.4.1/neutrino/lib_ref/g/getgrnam_r.html on line 1
Warning: main() [function.include]: Failed opening '/www/www/htdocs/style/globals.php' for inclusion (include_path='.:/www/www/common:/www/www/php/lib/php') in /www/www/docs/6.4.1/neutrino/lib_ref/g/getgrnam_r.html on line 1
Warning: main(/www/www/htdocs/style/header.php) [function.main]: failed to open stream: No such file or directory in /www/www/docs/6.4.1/neutrino/lib_ref/g/getgrnam_r.html on line 8
Warning: main() [function.include]: Failed opening '/www/www/htdocs/style/header.php' for inclusion (include_path='.:/www/www/common:/www/www/php/lib/php') in /www/www/docs/6.4.1/neutrino/lib_ref/g/getgrnam_r.html on line 8
Get information about the group with a given name
#include <sys/types.h>
#include <grp.h>
int getgrnam_r( const char* name,
struct group* grp,
char* buffer,
size_t bufsize,
struct group** result );
- name
- The name of the group you want to get information about.
- grp
- A pointer to a group structure where the function can
store information about the group.
- buffer
- A buffer from which to allocate any memory required.
- bufsize
- The size of the buffer.
- result
- The address of a pointer that getgrgid_r() sets to the same
pointer as grp on success, or to NULL if the
function can't find the group.
libc
Use the -l c option to
qcc
to link against this library.
This library is usually included automatically.
If _POSIX_THREAD_SAFE_FUNCTIONS is defined, the
getgrnam_r() function updates the group structure pointed
by grp and stores a pointer to that structure at the
location pointed by result. The structure contains an entry
from the group database with a matching name.
This function allocates storage referenced by the group structure from the
memory
provided with the buffer parameter, which is
bufsize characters in size.
You can determine the maximum size needed for
this buffer by calling
sysconf()
with an argument of _SC_GETGR_R_SIZE_MAX.
The getgrnam_r() stores a NULL pointer at the
location pointed by result on error or if the requested entry
isn't found.
Zero for success, or an error number if an error occurred.
- ERANGE
- Insufficient storage was supplied via buffer
and bufsize to contain the group structure.
The getgrnam_r() function uses the following functions, and as a
result,
errno
can be set to an error for any of these calls:
POSIX 1003.1 TSF
Safety: | |
Cancellation point |
Yes |
Interrupt handler |
No |
Signal handler |
No |
Thread |
Yes |
getgrgid(),
getgrgid_r(),
getgrnam(),
getlogin(),
sysconf()
Warning: main(/www/www/htdocs/style/footer.php) [function.main]: failed to open stream: No such file or directory in /www/www/docs/6.4.1/neutrino/lib_ref/g/getgrnam_r.html on line 183
Warning: main() [function.include]: Failed opening '/www/www/htdocs/style/footer.php' for inclusion (include_path='.:/www/www/common:/www/www/php/lib/php') in /www/www/docs/6.4.1/neutrino/lib_ref/g/getgrnam_r.html on line 183