summaryrefslogtreecommitdiff
path: root/usr/src/man/man3c/getnetgrent.3c
diff options
context:
space:
mode:
authorGordon Ross <gwr@nexenta.com>2021-06-21 19:28:20 +0200
committerRobert Mustacchi <rm@fingolfin.org>2021-07-06 11:42:09 -0700
commit74e12c43fe52f2c30f36e65a4d0fb0e8dfd7068a (patch)
tree12a16bf4b9b74058e5176dfa4f5a66ce7050f769 /usr/src/man/man3c/getnetgrent.3c
parent1a065e93eee983124652c3eb0cfdcb4776cd89ab (diff)
downloadillumos-joyent-74e12c43fe52f2c30f36e65a4d0fb0e8dfd7068a.tar.gz
3163 nss: need local netgroup implementation
Portions contributed by: Marco van Wieringen <marco.van.wieringen@planets.elm.net> Reviewed by: Andy Fiddaman <andy@omnios.org> Reviewed by: Peter Tribble <peter.tribble@gmail.com> Reviewed by: Toomas Soome <tsoome@me.com> Approved by: Robert Mustacchi <rm@fingolfin.org>
Diffstat (limited to 'usr/src/man/man3c/getnetgrent.3c')
-rw-r--r--usr/src/man/man3c/getnetgrent.3c13
1 files changed, 4 insertions, 9 deletions
diff --git a/usr/src/man/man3c/getnetgrent.3c b/usr/src/man/man3c/getnetgrent.3c
index a404bbaad5..024064d633 100644
--- a/usr/src/man/man3c/getnetgrent.3c
+++ b/usr/src/man/man3c/getnetgrent.3c
@@ -8,7 +8,6 @@
getnetgrent, getnetgrent_r, setnetgrent, endnetgrent, innetgr \- get network
group entry
.SH SYNOPSIS
-.LP
.nf
#include <netdb.h>
@@ -38,7 +37,6 @@ group entry
.fi
.SH DESCRIPTION
-.LP
These functions are used to test membership in and enumerate members of
``netgroup'' network groups defined in a system database. Netgroups are sets
of (machine,user,domain) triples (see \fBnetgroup\fR(4)).
@@ -122,7 +120,6 @@ multiple threads interleave calls to \fBgetnetgrent_r()\fR each will enumerate
a disjoint subset of the netgroup. Thus the effective use of these functions in
multi-threaded applications may require coordination by the caller.
.SH ERRORS
-.LP
The function \fBgetnetgrent_r()\fR will return \fB0\fR and set \fBerrno\fR to
\fBERANGE\fR if the length of the buffer supplied by caller is not large enough
to store the result. See \fBIntro\fR(2) for the proper usage and
@@ -141,7 +138,6 @@ success.
.RE
.SH ATTRIBUTES
-.LP
See \fBattributes\fR(5) for descriptions of the following attributes:
.sp
@@ -156,18 +152,17 @@ MT-Level See \fBDESCRIPTION\fR section.
.TE
.SH SEE ALSO
-.LP
\fBIntro\fR(2), \fBIntro\fR(3), \fBnetgroup\fR(4), \fBnsswitch.conf\fR(4),
\fBattributes\fR(5)
.SH WARNINGS
-.LP
The function \fBgetnetgrent_r()\fR is included in this release on an
uncommitted basis only, and is subject to change or removal in future minor
releases.
.SH NOTES
-.LP
-Only the Network Information Services, \fBNIS\fR, is supported
-as a source for the \fBnetgroup\fR database.
+Network groups are usually stored in network information services,
+such as \fBLDAP\fR, or \fBNIS\fR, but may alternatively be stored in
+the local \fB/etc/netgroup\fR file. The \fBnetgroup\fR line of the
+\fBnsswitch.conf\fR(4) file determines which of those sources are used.
.sp
.LP
When compiling multi-threaded applications, see \fBIntro\fR(3), \fINotes On