diff options
author | David Leonard <d@cvs.openbsd.org> | 2000-03-23 22:09:02 +0000 |
---|---|---|
committer | David Leonard <d@cvs.openbsd.org> | 2000-03-23 22:09:02 +0000 |
commit | a1e87d3b0bd42349559131d21b2808184d268bd2 (patch) | |
tree | a0589198e3ff20a7686ac8588127aa006025f159 /lib | |
parent | 867fdaa499e825fa583c80ac9e0269d3b4d023f2 (diff) |
getgrnam_r, getgrgid_r. ok aaron@
Diffstat (limited to 'lib')
-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 |