diff options
Diffstat (limited to 'usr/src/man/man4/nsswitch.conf.4')
| -rw-r--r-- | usr/src/man/man4/nsswitch.conf.4 | 222 |
1 files changed, 55 insertions, 167 deletions
diff --git a/usr/src/man/man4/nsswitch.conf.4 b/usr/src/man/man4/nsswitch.conf.4 index 9ea1dda72b..6f6561b9d3 100644 --- a/usr/src/man/man4/nsswitch.conf.4 +++ b/usr/src/man/man4/nsswitch.conf.4 @@ -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 nsswitch.conf 4 "6 Nov 2008" "SunOS 5.11" "File Formats" +.TH NSSWITCH.CONF 4 "Nov 6, 2008" .SH NAME nsswitch.conf \- configuration file for the name service switch .SH SYNOPSIS @@ -29,40 +29,38 @@ The following databases use the \fBswitch\fR file: .sp .TS -tab(); -cw(2.18i) cw(3.32i) -lw(2.18i) lw(3.32i) -. -DatabaseUsed By -\fBaliases\fR\fBsendmail\fR(1M) -\fBauth_attr\fR\fBgetauthnam\fR(3SECDB) -\fBautomount\fR\fBautomount\fR(1M) -\fBbootparams\fR\fBrpc.bootparamd\fR(1M) -\fBethers\fR\fBethers\fR(3SOCKET) -\fBgroup\fR\fBgetgrnam\fR(3C) -\fBhosts\fRT{ +c c +l l . +Database Used By +\fBaliases\fR \fBsendmail\fR(1M) +\fBauth_attr\fR \fBgetauthnam\fR(3SECDB) +\fBautomount\fR \fBautomount\fR(1M) +\fBbootparams\fR \fBrpc.bootparamd\fR(1M) +\fBethers\fR \fBethers\fR(3SOCKET) +\fBgroup\fR \fBgetgrnam\fR(3C) +\fBhosts\fR T{ \fBgethostbyname\fR(3NSL), \fBgetaddrinfo\fR(3SOCKET). See \fBInteraction with netconfig\fR. T} -\fBipnodes\fRSame as \fBhosts\fR. -\fBnetgroup\fR\fBinnetgr\fR(3C) -\fBnetmasks\fR\fBifconfig\fR(1M) -\fBnetworks\fR\fBgetnetbyname\fR(3SOCKET) -\fBpasswd\fRT{ +\fBipnodes\fR Same as \fBhosts\fR. +\fBnetgroup\fR \fBinnetgr\fR(3C) +\fBnetmasks\fR \fBifconfig\fR(1M) +\fBnetworks\fR \fBgetnetbyname\fR(3SOCKET) +\fBpasswd\fR T{ \fBgetpwnam\fR(3C), \fBgetspnam\fR(3C), \fBgetauusernam\fR(3BSM), \fBgetusernam\fR(3SECDB) T} -\fBprinters\fRT{ +\fBprinters\fR T{ \fBlp\fR(1), \fBlpstat\fR(1), \fBcancel\fR(1), \fBlpr\fR(1B), \fBlpq\fR(1B), \fBlprm\fR(1B), \fBin.lpd\fR(1M), \fBlpadmin\fR(1M), \fBlpget\fR(1M), \fBlpset\fR(1M) T} -\fBprof_attr\fR\fBgetprofnam\fR(3SECDB), \fBgetexecprof\fR(3SECDB) -\fBproject\fRT{ +\fBprof_attr\fR \fBgetprofnam\fR(3SECDB), \fBgetexecprof\fR(3SECDB) +\fBproject\fR T{ \fBgetprojent\fR(3PROJECT), \fBgetdefaultproj\fR(3PROJECT), \fBinproj\fR(3PROJECT), \fBnewtask\fR(1), \fBsetproject\fR(3PROJECT) T} -\fBprotocols\fR\fBgetprotobyname\fR(3SOCKET) -\fBpublickey\fR\fBgetpublickey\fR(3NSL), \fBsecure_rpc\fR(3NSL) -\fBrpc\fR\fBgetrpcbyname\fR(3NSL) -\fBservices\fR\fBgetservbyname\fR(3SOCKET). -See \fBInteraction with netconfig\fR. -\fBuser_attr\fR\fBgetuserattr\fR(3SECDB) +\fBprotocols\fR \fBgetprotobyname\fR(3SOCKET) +\fBpublickey\fR \fBgetpublickey\fR(3NSL), \fBsecure_rpc\fR(3NSL) +\fBrpc\fR \fBgetrpcbyname\fR(3NSL) +\fBservices\fR \fBgetservbyname\fR(3SOCKET). + See \fBInteraction with netconfig\fR. +\fBuser_attr\fR \fBgetuserattr\fR(3SECDB) .TE .sp @@ -72,28 +70,26 @@ The following sources can be used: .sp .TS -tab(); -cw(2.18i) cw(3.32i) -lw(2.18i) lw(3.32i) -. -SourceUses -\fBfiles\fRT{ +c c +l l . +Source Uses +\fBfiles\fR T{ \fB/etc/hosts\fR, \fB/etc/passwd\fR, \fB/etc/inet/ipnodes\fR, \fB/etc/shadow\fR, \fB/etc/security/auth_attr\fR, \fB/etc/user_attr\fR T} -\fBnis\fR\fBNIS\fR(\fBYP\fR) -\fBnisplus\fR\fBNIS+\fR -\fBldap\fR\fBLDAP\fR -\fBad\fRActive Directory -\fBdns\fRT{ +\fBnis\fR \fBNIS\fR(\fBYP\fR) +\fBnisplus\fR \fBNIS+\fR +\fBldap\fR \fBLDAP\fR +\fBad\fR Active Directory +\fBdns\fR T{ Valid only for hosts and ipnodes. Uses the Internet Domain Name Service. T} -\fBmdns\fRT{ +\fBmdns\fR T{ Valid only for hosts and ipnodes. Uses the Multicast Domain Name Service. T} -\fBcompat\fRT{ +\fBcompat\fR T{ Valid only for \fBpasswd\fR and \fBgroup\fR. Implements \fB+\fR and \fB-.\fR See \fBInteraction with +/- syntax\fR. T} -\fBuser\fRT{ +\fBuser\fR T{ Valid only for printers. Implements support for \fB${HOME}/.printers\fR. T} .TE @@ -112,17 +108,15 @@ tried. A source can return one of the following codes: .sp .TS -tab(); -cw(2.18i) cw(3.32i) -lw(2.18i) lw(3.32i) -. -StatusMeaning -\fBSUCCESS\fRRequested database entry was found. -\fBUNAVAIL\fRT{ +c c +l l . +Status Meaning +\fBSUCCESS\fR Requested database entry was found. +\fBUNAVAIL\fR T{ Source is not configured on this system or internal failure. T} -\fBNOTFOUND\fRSource responded "\fBno such entry\fR" -\fBTRYAGAIN\fRT{ +\fBNOTFOUND\fR Source responded "\fBno such entry\fR" +\fBTRYAGAIN\fR T{ Source is busy or not responding, might respond to retries. T} .TE @@ -134,13 +128,11 @@ For each status code, two actions are possible: .sp .TS -tab(); -cw(2.18i) cw(3.32i) -lw(2.18i) lw(3.32i) -. -ActionMeaning -\fBcontinue\fRTry the next source in the list. -\fBreturn\fRReturn now. +c c +l l . +Action Meaning +\fBcontinue\fR Try the next source in the list. +\fBreturn\fR Return now. .TE .sp @@ -150,13 +142,11 @@ Additionally, for \fBTRYAGAIN\fR only, the following actions are possible: .sp .TS -tab(); -cw(2.18i) cw(3.32i) -lw(2.18i) lw(3.32i) -. -ActionMeaning -\fBforever\fRRetry the current source forever. -\fIn\fRT{ +c c +l l . +Action Meaning +\fBforever\fR Retry the current source forever. +\fIn\fR T{ Retry the current source \fIn\fR more times, where \fIn\fR is an integer between \fB0\fR and \fBMAX_INT\fR (that is, 2.14 billion). After \fIn\fR retries has been exhausted, the \fBTRYAGAIN\fR action transitions to \fBcontinue\fR, until a future request receives a response, at which time \fBTRYAGAIN\fR=\fIn\fR is restored. T} .TE @@ -191,7 +181,7 @@ For the \fBTRYAGAIN\fR status, the action syntax is: .in +2 .nf <action> ::= "return" | "continue" | "forever" | <n> -<n> ::= 0...MAX_INT +<n> ::= 0...MAX_INT .fi .in -2 @@ -264,78 +254,64 @@ are permitted for the \fBpasswd\fR: database in the \fB/etc/nsswitch.conf\fR file: .sp .ne 2 -.mk .na \fBpasswd:\fR .ad .RS 18n -.rt files .RE .sp .ne 2 -.mk .na \fBpasswd:\fR .ad .RS 18n -.rt files nis .RE .sp .ne 2 -.mk .na \fBpasswd:\fR .ad .RS 18n -.rt files nisplus .RE .sp .ne 2 -.mk .na \fBpasswd:\fR .ad .RS 18n -.rt files ldap .RE .sp .ne 2 -.mk .na \fBpasswd:\fR .ad .RS 18n -.rt compat .RE .sp .ne 2 -.mk .na \fBpasswd_compat:\fR .ad .RS 18n -.rt nisplus .RE .sp .ne 2 -.mk .na \fBpasswd_compat:\fR .ad .RS 18n -.rt ldap .RE @@ -392,210 +368,172 @@ enterprise level name service and are identical to those in the default configuration of this file: .sp .ne 2 -.mk .na \fBpasswd:\fR .ad .RS 15n -.rt files nis .RE .sp .ne 2 -.mk .na \fBgroup:\fR .ad .RS 15n -.rt files nis .RE .sp .ne 2 -.mk .na \fBhosts:\fR .ad .RS 15n -.rt nis [NOTFOUND=return] files .RE .sp .ne 2 -.mk .na \fBipnodes:\fR .ad .RS 15n -.rt nis [NOTFOUND=return] files .RE .sp .ne 2 -.mk .na \fBnetworks:\fR .ad .RS 15n -.rt nis [NOTFOUND=return] files .RE .sp .ne 2 -.mk .na \fBprotocols:\fR .ad .RS 15n -.rt nis [NOTFOUND=return] files .RE .sp .ne 2 -.mk .na \fBrpc:\fR .ad .RS 15n -.rt nis [NOTFOUND=return] files .RE .sp .ne 2 -.mk .na \fBethers:\fR .ad .RS 15n -.rt nis [NOTFOUND=return] files .RE .sp .ne 2 -.mk .na \fBnetmasks:\fR .ad .RS 15n -.rt nis [NOTFOUND=return] files .RE .sp .ne 2 -.mk .na \fBbootparams:\fR .ad .RS 15n -.rt nis [NOTFOUND=return] files .RE .sp .ne 2 -.mk .na \fBpublickey:\fR .ad .RS 15n -.rt nis [NOTFOUND=return] files .RE .sp .ne 2 -.mk .na \fBnetgroup:\fR .ad .RS 15n -.rt nis .RE .sp .ne 2 -.mk .na \fBautomount:\fR .ad .RS 15n -.rt files nis .RE .sp .ne 2 -.mk .na \fBaliases:\fR .ad .RS 15n -.rt files nis .RE .sp .ne 2 -.mk .na \fBservices:\fR .ad .RS 15n -.rt files nis .RE .sp .ne 2 -.mk .na \fBprinters:\fR .ad .RS 15n -.rt user files nis nisplus .RE .sp .ne 2 -.mk .na \fBauth_attr\fR .ad .RS 15n -.rt files nis .RE .sp .ne 2 -.mk .na \fBprof_attr\fR .ad .RS 15n -.rt files nis .RE .sp .ne 2 -.mk .na \fBproject\fR .ad .RS 15n -.rt files nis .RE @@ -620,23 +558,19 @@ If compatibility with the +/- syntax for \fBpasswd\fR and \fBgroup\fR is required, simply modify the entries for \fBpasswd\fR and \fBgroup\fR to: .sp .ne 2 -.mk .na \fBpasswd:\fR .ad .RS 11n -.rt compat .RE .sp .ne 2 -.mk .na \fBgroup:\fR .ad .RS 11n -.rt compat .RE @@ -663,45 +597,37 @@ If the use of +/- syntax is desired in conjunction with \fBnisplus\fR, use the following four entries: .sp .ne 2 -.mk .na \fBpasswd:\fR .ad .RS 18n -.rt compat .RE .sp .ne 2 -.mk .na \fBpasswd_compat:\fR .ad .RS 18n -.rt nisplus OR ldap .RE .sp .ne 2 -.mk .na \fBgroup:\fR .ad .RS 18n -.rt compat .RE .sp .ne 2 -.mk .na \fBgroup_compat:\fR .ad .RS 18n -.rt nisplus OR ldap .RE @@ -713,12 +639,10 @@ that are not listed in the enterprise level name service, \fBNIS+\fR or \fB/etc/resolv.conf\fR file (see \fBresolv.conf\fR(4) for more details): .sp .ne 2 -.mk .na \fBhosts:\fR .ad .RS 10n -.rt nisplus dns [NOTFOUND=return] files .RE @@ -727,12 +651,10 @@ nisplus dns [NOTFOUND=return] files or .sp .ne 2 -.mk .na \fBhosts:\fR .ad .RS 10n -.rt ldap dns [NOTFOUND=return] files .RE @@ -768,189 +690,155 @@ A source named SSS is implemented by a shared object named \fBnss_SSS.so.1\fR that resides in \fB/usr/lib\fR. .sp .ne 2 -.mk .na \fB\fB/etc/nsswitch.conf\fR\fR .ad .RS 29n -.rt Configuration file. .RE .sp .ne 2 -.mk .na \fB\fB/usr/lib/nss_compat.so.1\fR\fR .ad .RS 29n -.rt Implements \fBcompat\fR source. .RE .sp .ne 2 -.mk .na \fB\fB/usr/lib/nss_dns.so.1\fR\fR .ad .RS 29n -.rt Implements \fBdns\fR source. .RE .sp .ne 2 -.mk .na \fB\fB/usr/lib/nss_files.so.1\fR\fR .ad .RS 29n -.rt Implements \fBfiles\fR source. .RE .sp .ne 2 -.mk .na \fB\fB/usr/lib/nss_mdns.so.1\fR\fR .ad .RS 29n -.rt Implements \fBmdns\fR source. .RE .sp .ne 2 -.mk .na \fB\fB/usr/lib/nss_nis.so.1\fR\fR .ad .RS 29n -.rt Implements \fBnis\fR source. .RE .sp .ne 2 -.mk .na \fB\fB/usr/lib/nss_nisplus.so.1\fR\fR .ad .RS 29n -.rt Implements \fBnisplus\fR source. .RE .sp .ne 2 -.mk .na \fB\fB/usr/lib/nss_ldap.so.1\fR\fR .ad .RS 29n -.rt Implements \fBldap\fR source. .RE .sp .ne 2 -.mk .na \fB\fB/usr/lib/nss_ad.so.1\fR\fR .ad .RS 29n -.rt Implements ad source. .RE .sp .ne 2 -.mk .na \fB\fB/usr/lib/nss_user.so.1\fR\fR .ad .RS 29n -.rt Implements \fBuser\fR source. .RE .sp .ne 2 -.mk .na \fB\fB/etc/netconfig\fR\fR .ad .RS 29n -.rt Configuration file for \fBnetdir\fR(3NSL) functions that redirects hosts/devices policy to the switch. .RE .sp .ne 2 -.mk .na \fB\fB/etc/nsswitch.files\fR\fR .ad .RS 29n -.rt Sample configuration file that uses \fBfiles\fR only. .RE .sp .ne 2 -.mk .na \fB\fB/etc/nsswitch.nis\fR\fR .ad .RS 29n -.rt Sample configuration file that uses \fBfiles\fR and \fBnis\fR. .RE .sp .ne 2 -.mk .na \fB\fB/etc/nsswitch.nisplus\fR\fR .ad .RS 29n -.rt Sample configuration file that uses \fBfiles\fR and \fBnisplus\fR. .RE .sp .ne 2 -.mk .na \fB\fB/etc/nsswitch.ldap\fR\fR .ad .RS 29n -.rt Sample configuration file that uses \fBfiles\fR and \fBldap\fR. .RE .sp .ne 2 -.mk .na \fB\fB/etc/nsswitch.ad\fR\fR .ad .RS 29n -.rt Sample configuration file that uses \fBfiles\fR and \fBad\fR. .RE .sp .ne 2 -.mk .na \fB\fB/etc/nsswitch.dns\fR\fR .ad .RS 29n -.rt Sample configuration file that uses \fBfiles\fR, \fBdns\fR and \fBmdns\fR (\fBdns\fR and \fBmdns\fR only for hosts). .RE |