usr/src/man/man4/nss.4

   1 '\" te
   2 .\" Copyright (c) 2003, Sun Microsystems, Inc.
   3 .\" All Rights Reserved.
   4 .\" 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.
   5 .\" 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.
   6 .\" 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]
   7 .TH NSS 4 "Feb 25, 2017"
   8 .SH NAME
   9 nss \- configuration file for initgroups
  10 .SH SYNOPSIS
  11 .LP
  12 .nf
  13 \fB/etc/default/nss\fR
  14 .fi
  15
  16 .SH DESCRIPTION
  17 .LP
  18 The \fB/etc/default/nss\fR configuration file provides methods for
  19 \fBinitgroups\fR(3C) lookup method. The file also provides a method to disable
  20 address sorting by name lookup functions. The file controls the behavior of the
  21 name service switch routines outside of the source database mappings provided
  22 by the \fB/etc/nsswitch.conf\fR file.
  23 .sp
  24 .LP
  25 \fB/etc/default/nss\fR supports the following options:
  26 .sp
  27 .ne 2
  28 .na
  29 \fB\fBNETID_AUTHORITATIVE\fR\fR
  30 .ad
  31 .RS 23n
  32 Changes the behavior of the name service lookups to use the \fBnetid\fR table
  33 in response to the \fBinitgroups()\fR call. By default,
  34 \fBinitgroups()\fR uses the \fBgroup\fR table. When \fBNETID_AUTHORITATIVE\fR
  35 is set to TRUE, \fBinitgroups()\fR uses \fBnetid\fR as the source for
  36 supplementary groups rather than the \fBgroup\fR table.
  37 .sp
  38 The name service administrator must ensure that the \fBnetid\fR table contains
  39 valid supplementary group information for users. Not all name services can
  40 automatically keep the members listed in the \fBgroup\fR table in sync with the
  41 \fBnetid\fR table.
  42 .RE
  43
  44 .sp
  45 .ne 2
  46 .na
  47 \fB\fBSORT_ADDRS\fR\fR
  48 .ad
  49 .RS 23n
  50 If this option is set to FALSE, the sorting of addresses is disabled on
  51 addresses that are returned by name lookup functions such as
  52 \fBinitgroups()\fR, \fBgethostbyname\fR(3NSL), \fBnetdir_getbyname\fR(3NSL),
  53 \fBgetaddrinfo\fR(3SOCKET), and \fBgetipnodebyname\fR(3SOCKET). Setting this
  54 option to FALSE is useful when the order of addresses returned by the
  55 nameserver needs to be maintained. To use the DNS round robin feature, for
  56 example, address sorting by name lookup functions should be disabled.
  57 .sp
  58 By default, address sorting is enabled.
  59 .RE
  60
  61 .SH ATTRIBUTES
  62 .LP
  63 See \fBattributes\fR(5) for descriptions of the following attributes:
  64 .sp
  65
  66 .sp
  67 .TS
  68 box;
  69 c | c
  70 l | l .
  71 ATTRIBUTE TYPE  ATTRIBUTE VALUE
  72 _
  73 Interface Stability     Evolving
  74 .TE
  75
  76 .SH SEE ALSO
  77 .LP
  78 \fBgetaddrinfo\fR(3SOCKET), \fBgethostbyname\fR(3NSL),
  79 \fBgetipnodebyname\fR(3SOCKET), \fBinitgroups\fR(3C),
  80 \fBnetdir_getbyname\fR(3NSL), \fBnsswitch.conf\fR(4), \fBattributes\fR(5)