nssetup(8)nssetup(8)NAMEnssetup - manage the /etc/nsswitch.conf file
SYNOPSIS
/usr/sbin/nssetup [options]
/usr/sbin/nssetup --help
STANDARDS
Interfaces documented on this reference page conform to the following
standards:
none
Refer to the standards(5) reference page for more information about
industry standards and associated tags.
OPTIONS
Adds a new source for the selected data types. Keep the previous con‐
tents of the /etc/nsswitch.conf and /etc/svc.conf files in pathname.old
files. Test the validity of the contents of the nsswitch.conf file and
take no other action. Append condition=action clauses to a preceding
use of --append, --insert, --modify, or --prepend. Can appear multiple
times. Restricts operations which follow to affecting the listed data
types. The list of data types can be comma- or space-separated, or mul‐
tiple --db options may be given. Any options specifying operations
which appear to the left of the first --db option are global. Specify‐
ing the list as *, all, or ALL resumes global operations. Default to
using files in the current working directory ("."-relative) rather than
files in the /etc directory. Disables the selected data types by emp‐
tying their source lists. Specify the nsswitch.conf-format file on
which to operate, rather than the default file of /etc/nsswitch.conf or
Allow a preceding --append, --insert, or --prepend option to re-arrange
the source list if the corresponding source argument is already
present. Can be interspersed with --condition options. Display a sum‐
mary of the options and take no other action. Add new-source immedi‐
ately after old-source for the selected data types which already have
old-source in their source lists. Modifies any existing entries for
source for the selected data types. Removes any existing condi‐
tion=action clauses in preparation for being used with subsequent
--condition options. Do not run the /usr/sbin/nss2svc utility to
update the svc.conf file at the end of successful modifications. Nor‐
mally used only when manipulating source or data types which svc.conf
does not support. Add source at the beginning of the list for the
selected data types. Display the parsed contents of the nsswitch.conf
file and take no other action. Remove source from the list for the
selected data types. Resets the selected data types to use their ini‐
tial (defaulted) source lists. For non-standard data types, this is
done by removing them from the updated file completely. Overwrites the
source list specification for the selected data types. The source-list
value can include [condition=action] clauses. Specify the svc.conf
file to update with /usr/sbin/nss2svc rather than the default of
/etc/svc.conf or Transfers (moves) the source specification for source-
from to be just after source-after for the selected data types which
already have both sources specified.
OPERANDS
none.
DESCRIPTION
The /usr/sbin/nssetup utility displays, manipulates, and validates the
/etc/nsswitch.conf file. It can be used in two modes: command-line, or
interactive. The user enter interactive mode by running the utility
without any of the options which operate on data types or specify
actions. Specifically, only the following options (or their synonyms)
are compatible with interactive mode: --backup, --debug, --file, --no-
nss2svc, and --svc-file.
EXIT STATUS
Success. The user specified an Invalid option or an invalid combina‐
tion of options. An error occurred. [with --check] The contents of
the nsswitch.conf file were not completely valid. [in interactive menu
mode] An end-of-file (EOF) condition was seen on standard input.
EXAMPLES
The following interactive example shows .... prompt user input result‐
ing display The following script example shows.... first line of
script second line of script ...
ENVIRONMENT VARIABLES
Used to override the default of /usr/bin/more for presenting the output
from the --help and --print command-line options, and the interactive
menu P option. Provides a default value for the internationalization
variables that are unset or null. If LANG is unset or null, the corre‐
sponding value from the default locale is used. If any of the interna‐
tionalization variables contain an invalid setting, the utility behaves
as if none of the variables had been defined. If set to a non-empty
string value, overrides the values of all the other internationaliza‐
tion variables. Determines the locale for the interpretation of
sequences of bytes of text data as characters (for example, single-byte
as opposed to multibyte characters in arguments). Determines the
locale for the format and contents of diagnostic messages written to
standard error. Determines the location of message catalogues for the
processing of LC_MESSAGES.
FILES
Path to the default nsswitch file. Path to the default svc.conf file.
SEE ALSO
Commands: nss2svc(8)
Files: nsswitch.conf(4)nssetup(8)