summaryrefslogtreecommitdiff
path: root/usr/src/man/man3c
diff options
context:
space:
mode:
authorPeter Tribble <peter.tribble@gmail.com>2017-03-01 15:08:10 +0000
committerRichard Lowe <richlowe@richlowe.net>2017-03-01 11:15:28 -0500
commitff31d5bfa079d4db9f78f481637d7ed9f9fa4a49 (patch)
tree0421ec1d2904e900e92b1f70b32ed097650680ac /usr/src/man/man3c
parentc772408baa457f54709f03eaf11de0b0b30ce317 (diff)
downloadillumos-joyent-ff31d5bfa079d4db9f78f481637d7ed9f9fa4a49.tar.gz
4339 NIS+ should be removed from man pages too
Reviewed by: Yuri Pankov <yuri.pankov@gmail.com> Approved by: Richard Lowe <richlowe@richlowe.net>
Diffstat (limited to 'usr/src/man/man3c')
-rw-r--r--usr/src/man/man3c/getgrnam.3c20
-rw-r--r--usr/src/man/man3c/getnetgrent.3c13
-rw-r--r--usr/src/man/man3c/getpwnam.3c30
-rw-r--r--usr/src/man/man3c/getspnam.3c24
4 files changed, 21 insertions, 66 deletions
diff --git a/usr/src/man/man3c/getgrnam.3c b/usr/src/man/man3c/getgrnam.3c
index a4851c9388..8afde21dec 100644
--- a/usr/src/man/man3c/getgrnam.3c
+++ b/usr/src/man/man3c/getgrnam.3c
@@ -9,7 +9,7 @@
.\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License.
.\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License.
.\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
-.TH GETGRNAM 3C "Apr 5, 2004"
+.TH GETGRNAM 3C "Feb 25, 2017"
.SH NAME
getgrnam, getgrnam_r, getgrent, getgrent_r, getgrgid, getgrgid_r, setgrent,
endgrent, fgetgrent, fgetgrent_r \- group database entry functions
@@ -69,7 +69,7 @@ endgrent, fgetgrent, fgetgrent_r \- group database entry functions
\fBint\fR \fIbufsize\fR);
.fi
-.SS "Standard comforming"
+.SS "Standard conforming"
.LP
.nf
cc [ \fIflag\fR... ] \fIfile\fR... \fB-D_POSIX_PTHREAD_SEMANTICS\fR [ \fIlibrary\fR... ]
@@ -85,7 +85,6 @@ cc [ \fIflag\fR... ] \fIfile\fR... \fB-D_POSIX_PTHREAD_SEMANTICS\fR [ \fIlibrary
.fi
.SH DESCRIPTION
-.sp
.LP
These functions are used to obtain entries describing user groups. Entries can
come from any of the sources for \fBgroup\fR specified in the
@@ -128,7 +127,6 @@ The \fBfgetgrent()\fR function, unlike the other functions above, does not use
which is assumed to have the format of the \fBgroup\fR file (see
\fBgroup\fR(4)).
.SS "Reentrant Interfaces"
-.sp
.LP
The \fBgetgrnam()\fR, \fBgetgrgid()\fR, \fBgetgrent()\fR, and
\fBfgetgrent()\fR functions use thread-specific storage that is reused in each
@@ -170,7 +168,6 @@ to \fBgetgrent_r()\fR, the threads will enumerate disjoint subsets of the group
database. Like their non-reentrant counterparts, \fBgetgrnam_r()\fR and
\fBgetgrgid_r()\fR leave the enumeration position in an indeterminate state.
.SS "group Structure"
-.sp
.LP
Group entries are represented by the \fBstruct group\fR structure defined in
<\fBgrp.h\fR>:
@@ -188,7 +185,6 @@ struct group {
.in -2
.SH RETURN VALUES
-.sp
.LP
The \fBgetgrnam()\fR, \fBgetgrnam_r()\fR, \fBgetgrgid()\fR, and
\fBgetgrgid_r()\fR functions each return a pointer to a \fBstruct group\fR if
@@ -221,7 +217,6 @@ before calling \fBgetgrnam()\fR, \fBgetgrnam_r()\fR, \fBgetgrent()\fR,
\fBfgetgrent_r()\fR. If these functions return a null pointer and \fBerrno\fR
is non-zero, an error occurred.
.SH ERRORS
-.sp
.LP
The \fBgetgrent_r()\fR, \fBfgetgrent()\fR, and \fBfgetgrent_r()\fR functions
will fail if:
@@ -321,7 +316,6 @@ the data to be referenced by the resulting \fBgroup\fR structure.
.RE
.SH ATTRIBUTES
-.sp
.LP
See \fBattributes\fR(5) for descriptions of the following attributes:
.sp
@@ -344,19 +338,17 @@ The \fBendgrent()\fR, \fBgetgrent()\fR, \fBgetgrgid()\fR, \fBgetgrgid_r()\fR,
\fBgetgrnam()\fR, \fBgetgrnam_r()\fR, and \fBsetgrent()\fR functions are
Standard.
.SH SEE ALSO
-.sp
.LP
\fBIntro\fR(3), \fBgetpwnam\fR(3C), \fBgroup\fR(4), \fBnsswitch.conf\fR(4),
\fBpasswd\fR(4), \fBattributes\fR(5), \fBstandards\fR(5)
.SH NOTES
-.sp
.LP
When compiling multithreaded programs, see \fBIntro\fR(3).
.sp
.LP
Use of the enumeration interfaces \fBgetgrent()\fR and \fBgetgrent_r()\fR is
-discouraged; enumeration is supported for the group file, \fBNIS,\fR and
-\fBNIS+,\fR but in general is not efficient and might not be supported for all
+discouraged; enumeration is supported for the group file and \fBNIS\fR
+but in general is not efficient and might not be supported for all
database sources. The semantics of enumeration are discussed further in
\fBnsswitch.conf\fR(4).
.sp
@@ -371,8 +363,8 @@ If required, the ``+/-'' functionality can still be obtained for \fBNIS\fR by
specifying \fBcompat\fR as the source for \fBgroup\fR.
.sp
.LP
-If the ``+/-'' functionality is required in conjunction with \fBNIS+,\fR
-specify both \fBcompat\fR as the source for \fBgroup\fR and \fBnisplus\fR as
+If the ``+/-'' functionality is required in conjunction with \fBLDAP,\fR
+specify both \fBcompat\fR as the source for \fBgroup\fR and \fBldap\fR as
the source for the pseudo-database \fBgroup_compat\fR. See \fBgroup\fR(4), and
\fBnsswitch.conf\fR(4) for details.
.sp
diff --git a/usr/src/man/man3c/getnetgrent.3c b/usr/src/man/man3c/getnetgrent.3c
index be67cf4648..a404bbaad5 100644
--- a/usr/src/man/man3c/getnetgrent.3c
+++ b/usr/src/man/man3c/getnetgrent.3c
@@ -3,7 +3,7 @@
.\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License.
.\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License.
.\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
-.TH GETNETGRENT 3C "Apr 5, 2004"
+.TH GETNETGRENT 3C "Feb 25, 2017"
.SH NAME
getnetgrent, getnetgrent_r, setnetgrent, endnetgrent, innetgr \- get network
group entry
@@ -38,7 +38,6 @@ group entry
.fi
.SH DESCRIPTION
-.sp
.LP
These functions are used to test membership in and enumerate members of
``netgroup'' network groups defined in a system database. Netgroups are sets
@@ -123,7 +122,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
-.sp
.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
@@ -134,7 +132,6 @@ interpretation of \fBerrno\fR in multi-threaded applications.
The functions \fBsetnetgrent()\fR and \fBendnetgrent()\fR return \fB0\fR upon
success.
.SH FILES
-.sp
.ne 2
.na
\fB\fB/etc/nsswitch.conf\fR\fR
@@ -144,7 +141,6 @@ success.
.RE
.SH ATTRIBUTES
-.sp
.LP
See \fBattributes\fR(5) for descriptions of the following attributes:
.sp
@@ -160,21 +156,18 @@ MT-Level See \fBDESCRIPTION\fR section.
.TE
.SH SEE ALSO
-.sp
.LP
\fBIntro\fR(2), \fBIntro\fR(3), \fBnetgroup\fR(4), \fBnsswitch.conf\fR(4),
\fBattributes\fR(5)
.SH WARNINGS
-.sp
.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
-.sp
.LP
-Only the Network Information Services, \fBNIS\fR and \fBNIS+,\fR are supported
-as sources for the \fBnetgroup\fR database.
+Only the Network Information Services, \fBNIS\fR, is supported
+as a source for the \fBnetgroup\fR database.
.sp
.LP
When compiling multi-threaded applications, see \fBIntro\fR(3), \fINotes On
diff --git a/usr/src/man/man3c/getpwnam.3c b/usr/src/man/man3c/getpwnam.3c
index 658e9ea32f..1af5c7aa44 100644
--- a/usr/src/man/man3c/getpwnam.3c
+++ b/usr/src/man/man3c/getpwnam.3c
@@ -10,7 +10,7 @@
.\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing.
.\" See the License for the specific language governing permissions and limitations under the License. When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with
.\" the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
-.TH GETPWNAM 3C "Apr 5, 2004"
+.TH GETPWNAM 3C "Feb 25, 2017"
.SH NAME
getpwnam, getpwnam_r, getpwent, getpwent_r, getpwuid, getpwuid_r, setpwent,
endpwent, fgetpwent, fgetpwent_r \- get password entry
@@ -87,7 +87,6 @@ cc [ \fIflag\fR...] \fIfile\fR... \fB-D_POSIX_PTHREAD_SEMANTICS\fR [ \fIlibrary\
.fi
.SH DESCRIPTION
-.sp
.LP
These functions are used to obtain password entries. Entries can come from any
of the sources for \fBpasswd\fR specified in the \fB/etc/nsswitch.conf\fR file
@@ -124,7 +123,6 @@ The \fBfgetpwent()\fR function, unlike the other functions above, does not use
which is assumed to have the format of the \fBpasswd\fR file. See
\fBpasswd\fR(4).
.SS "Reentrant Interfaces"
-.sp
.LP
The \fBgetpwnam()\fR, \fBgetpwuid()\fR, \fBgetpwent()\fR, and \fBfgetpwent()\fR
functions use thread-specific data storage that is reused in each call to one
@@ -174,7 +172,6 @@ password database.
Like their non-reentrant counterparts, \fBgetpwnam_r()\fR and
\fBgetpwuid_r()\fR leave the enumeration position in an indeterminate state.
.SS "passwd Structure"
-.sp
.LP
Password entries are represented by the \fBstruct passwd\fR structure defined
in <\fBpwd.h\fR>:
@@ -201,7 +198,6 @@ The \fBpw_passwd\fR member should not be used as the encrypted password for the
user; use \fBgetspnam()\fR or \fBgetspnam_r()\fR instead. See
\fBgetspnam\fR(3C).
.SH RETURN VALUES
-.sp
.LP
The \fBgetpwnam()\fR, \fBgetpwnam_r()\fR, \fBgetpwuid()\fR, and
\fBgetpwuid_r()\fR functions each return a pointer to a \fBstruct passwd\fR if
@@ -243,7 +239,6 @@ When the pointer returned by the reentrant functions \fBgetpwnam_r()\fR,
\fBgetpwuid_r()\fR, \fBgetpwent_r()\fR, and \fBfgetpwent_r()\fR is non-null, it
is always equal to the \fIpwd\fR pointer that was supplied by the caller.
.SH ERRORS
-.sp
.LP
The \fBgetpwent_r()\fR, \fBfgetpwent()\fR, and \fBfgetpwent_r()\fR functions
will fail if:
@@ -351,7 +346,6 @@ the data to be referenced by the resulting \fBpasswd\fR structure.
.RE
.SH USAGE
-.sp
.LP
Three names associated with the current process can be determined:
\fBgetpwuid\fR(\fBgeteuid()\fR) returns the name associated with the effective
@@ -359,7 +353,6 @@ user ID of the process; \fBgetlogin()\fR returns the name associated with the
current login activity; and \fBgetpwuid\fR(\fBgetuid()\fR) returns the name
associated with the real user ID of the process.
.SH ATTRIBUTES
-.sp
.LP
See \fBattributes\fR(5) for descriptions of the following attributes:
.sp
@@ -384,21 +377,19 @@ For \fBendpwent()\fR, \fBgetpwent()\fR, \fBgetpwnam()\fR,
\fBgetpwnam_r()\fR, \fBgetpwuid()\fR, \fBgetpwuid_r()\fR, and \fBsetpwent()\fR,
see \fBstandards\fR(5).
.SH SEE ALSO
-.sp
.LP
-\fBnispasswd\fR(1), \fBpasswd\fR(1), \fByppasswd\fR(1), \fBIntro\fR(2),
+\fBpasswd\fR(1), \fByppasswd\fR(1), \fBIntro\fR(2),
\fBIntro\fR(3), \fBcuserid\fR(3C), \fBgetgrnam\fR(3C), \fBgetlogin\fR(3C),
\fBgetspnam\fR(3C), \fBnsswitch.conf\fR(4), \fBpasswd\fR(4), \fBshadow\fR(4),
\fBattributes\fR(5), \fBstandards\fR(5)
.SH NOTES
-.sp
.LP
When compiling multithreaded programs, see \fBIntro\fR(3).
.sp
.LP
Use of the enumeration interfaces \fBgetpwent()\fR and \fBgetpwent_r()\fR is
-discouraged; enumeration is supported for the \fBpasswd\fR file, \fBNIS,\fR and
-\fBNIS+,\fR but in general is not efficient and might not be supported for all
+discouraged; enumeration is supported for the \fBpasswd\fR file and \fBNIS\fR
+but in general is not efficient and might not be supported for all
database sources. The semantics of enumeration are discussed further in
\fBnsswitch.conf\fR(4).
.sp
@@ -410,13 +401,8 @@ might not be supported in future releases.
.sp
.LP
If required, the `+/-' functionality can still be obtained for \fBNIS\fR by
-specifying \fBcompat\fR as the source for \fBpasswd\fR.
-.sp
-.LP
-If the `+/-' functionality is required in conjunction with \fBNIS+,\fR specify
-both \fBcompat\fR as the source for \fBpasswd\fR and \fBnisplus\fR as the
-source for the pseudo-database \fBpasswd_compat\fR. See \fBpasswd\fR(4),
-\fBshadow\fR(4), and \fBnsswitch.conf\fR(4) for details.
+specifying \fBcompat\fR as the source for \fBpasswd\fR. See
+\fBnsswitch.conf\fR(4).
.sp
.LP
If the `+/-' is used, both \fB/etc/shadow\fR and \fB/etc/passwd\fR should have
@@ -425,8 +411,8 @@ shadow databases.
.sp
.LP
If a password entry from any of the sources contains an empty \fIuid\fR or
-\fIgid\fR field, that entry will be ignored by the files, \fBNIS\fR, and
-\fBNIS+\fR name service switch backends, causing the user to appear unknown to
+\fIgid\fR field, that entry will be ignored by the files and \fBNIS\fR
+name service switch backends, causing the user to appear unknown to
the system.
.sp
.LP
diff --git a/usr/src/man/man3c/getspnam.3c b/usr/src/man/man3c/getspnam.3c
index ecd72a5648..50c169d9e1 100644
--- a/usr/src/man/man3c/getspnam.3c
+++ b/usr/src/man/man3c/getspnam.3c
@@ -4,7 +4,7 @@
.\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License.
.\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License.
.\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
-.TH GETSPNAM 3C "Jan 23, 2008"
+.TH GETSPNAM 3C "Feb 25, 2017"
.SH NAME
getspnam, getspnam_r, getspent, getspent_r, setspent, endspent, fgetspent,
fgetspent_r \- get password entry
@@ -55,7 +55,6 @@ fgetspent_r \- get password entry
.fi
.SH DESCRIPTION
-.sp
.LP
These functions are used to obtain shadow password entries. An entry may come
from any of the sources for \fBshadow\fR specified in the
@@ -92,7 +91,6 @@ The \fBfgetspent()\fR function, unlike the other functions above, does not use
\fIfp\fR, which is assumed to have the format of the \fBshadow\fR file (see
\fBshadow\fR(4)).
.SS "Reentrant Interfaces"
-.sp
.LP
The \fBgetspnam()\fR, \fBgetspent()\fR, and \fBfgetspent()\fR functions use
thread-specific data storage that is reused in each call to one of these
@@ -134,7 +132,6 @@ shadow password database.
Like its non-reentrant counterpart, \fBgetspnam_r()\fR leaves the enumeration
position in an indeterminate state.
.SH RETURN VALUES
-.sp
.LP
Password entries are represented by the \fBstruct spwd\fR structure defined in
\fB<shadow.h>\fR:
@@ -180,7 +177,6 @@ When the pointer returned by the reentrant functions \fBgetspnam_r()\fR,
\fBgetspent_r()\fR, and \fBfgetspent_r()\fR is non-null, it is always equal to
the \fIresult\fR pointer that was supplied by the caller.
.SH ERRORS
-.sp
.LP
The reentrant functions \fBgetspnam_r()\fR, \fBgetspent_r()\fR, and
\fBfgetspent_r()\fR will return \fBNULL\fR and set \fBerrno\fR to \fBERANGE\fR
@@ -188,7 +184,6 @@ 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 interpretation of
\fBerrno\fR in multithreaded applications.
.SH ATTRIBUTES
-.sp
.LP
See \fBattributes\fR(5) for descriptions of the following attributes:
.sp
@@ -206,19 +201,16 @@ T}
.TE
.SH SEE ALSO
-.sp
.LP
-\fBnispasswd\fR(1), \fBpasswd\fR(1), \fByppasswd\fR(1), \fBIntro\fR(3),
+\fBpasswd\fR(1), \fByppasswd\fR(1), \fBIntro\fR(3),
\fBgetlogin\fR(3C), \fBgetpwnam\fR(3C), \fBnsswitch.conf\fR(4),
\fBpasswd\fR(4), \fBshadow\fR(4), \fBattributes\fR(5)
.SH WARNINGS
-.sp
.LP
The reentrant interfaces \fBgetspnam_r()\fR, \fBgetspent_r()\fR, and
\fBfgetspent_r()\fR are included in this release on an uncommitted basis only,
and are subject to change or removal in future minor releases.
.SH NOTES
-.sp
.LP
When compiling multithreaded applications, see \fBIntro\fR(3), \fINotes On
Multithreaded Applications\fR, for information about the use of the
@@ -226,8 +218,8 @@ Multithreaded Applications\fR, for information about the use of the
.sp
.LP
Use of the enumeration interfaces \fBgetspent()\fR and \fBgetspent_r()\fR is
-not recommended; enumeration is supported for the shadow file, \fBNIS,\fR and
-\fBNIS+,\fR but in general is not efficient and may not be supported for all
+not recommended; enumeration is supported for the shadow file and \fBNIS\fR
+but in general is not efficient and may not be supported for all
database sources. The semantics of enumeration are discussed further in
\fBnsswitch.conf\fR(4).
.sp
@@ -248,11 +240,3 @@ password entries is obtained from the ``passwd.byname'' map. This map stores
only the information for the \fBsp_namp\fR and \fBsp_pwdp\fR fields of the
\fBstruct spwd\fR structure. Shadow password entries obtained from \fBNIS\fR
will contain the value \fB-1\fR in the remainder of the fields.
-.sp
-.LP
-When \fBNIS+\fR is used as the database source, and the caller lacks the
-permission needed to retrieve the encrypted password from the \fBNIS+\fR
-``passwd.org_dir'' table, the \fBNIS+\fR service returns the string ``*NP*''
-instead of the actual encrypted password string. The functions described on
-this page will then return the string ``*NP*'' to the caller as the value of
-the member \fBsp_pwdp\fR in the returned shadow password structure.