diff options
| author |   d <d@openbsd.org> | 2000-03-23 22:09:01 +0000 |
|---|---|---|
| committer | d <d@openbsd.org> | 2000-03-23 22:09:01 +0000 |
| commit | 802e975edfadb9bcad31095950dd5a9afe5f8350 (patch) | |
| tree | 42fde1b9750043a0d78d0982f9ace8e825346255 | |
| parent | Please note that this file has not been updated for OpenSSH..... (diff) | |
| download | wireguard-openbsd-802e975edfadb9bcad31095950dd5a9afe5f8350.tar.xz wireguard-openbsd-802e975edfadb9bcad31095950dd5a9afe5f8350.zip | |
getgrnam_r, getgrgid_r. ok aaron@
| -rw-r--r-- | lib/libc/gen/getgrent.3 | 39 |
1 files changed, 38 insertions, 1 deletions
diff --git a/lib/libc/gen/getgrent.3 b/lib/libc/gen/getgrent.3 index ab1b7e8afd1..445f9751a58 100644 --- a/lib/libc/gen/getgrent.3 +++ b/lib/libc/gen/getgrent.3 @@ -1,4 +1,4 @@ -.\" $OpenBSD: getgrent.3,v 1.6 1999/07/09 13:35:16 aaron Exp $ +.\" $OpenBSD: getgrent.3,v 1.7 2000/03/23 22:09:01 d Exp $ .\" .\" Copyright (c) 1989, 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -37,7 +37,9 @@ .Sh NAME .Nm getgrent , .Nm getgrnam , +.Nm getgrnam_r , .Nm getgrgid , +.Nm getgrgid_r , .Nm setgroupent , .\" .Nm setgrfile , .Nm setgrent , @@ -51,7 +53,11 @@ .Ft struct group * .Fn getgrnam "const char *name" .Ft struct group * +.Fn getgrnam_r "const char *name" "struct group *grp" "char *buffer" "size_t bufsize" "struct group **result" +.Ft struct group * .Fn getgrgid "gid_t gid" +.Ft struct group * +.Fn getgrgid_r "gid_t gid" "struct group *grp" "char *buffer" "size_t bufsize" "struct group **result" .Ft int .Fn setgroupent "int stayopen" .\" .Ft void @@ -116,6 +122,30 @@ The .Fn endgrent function closes any open files. +.Pp +The +.Fn getgrgid_r +and +.Fn getgrnam_r +functions both update the group structure pointed to by +.Fa grp +and store a pointer to that structure at the location pointed to by +.Fa result . +The structure is filled with an entry from the group database with a +matching +.Fa gid +or +.Fa name . +Storage referenced by the group structure will be allocated from the memory +provided with the +.Fa buffer +parameter, which is +.Fa bufsiz +characters in size. +.\" The maximum size needed for this buffer can be determined with the +.\" .Dv _SC_GETGR_R_SIZE_MAX +.\" .Xr sysconf 2 +.\" parameter. .Sh RETURN VALUES The functions .Fn getgrent , @@ -132,6 +162,13 @@ The and .Fn setgrent functions have no return value. +The functions +.Fn getgrgid_r +and +.Fn getgrnam_r +store a null pointer at the location pointed to by +.Fa result +if an error occurs, or the requested entry is not found. .Sh FILES .Bl -tag -width /etc/group -compact .It Pa /etc/group |