NAME    [Toc]    [Back]

       nssetup - manage the /etc/nsswitch.conf file

SYNOPSIS    [Toc]    [Back]

       /usr/sbin/nssetup [options]

       /usr/sbin/nssetup --help

STANDARDS    [Toc]    [Back]

       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    [Toc]    [Back]

       Adds  a  new source for the selected data types.  Keep the
       previous   contents   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
       multiple --db options may be given. Any options specifying
       operations  which  appear  to  the  left of the first --db
       option are global.  Specifying 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  emptying  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 summary of the  options  and  take  no
       other action.  Add new-source immediately 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
       condition=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.  Normally  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  initial  (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  sourceafter
  for the selected data types which already have both
       sources specified.

OPERANDS    [Toc]    [Back]

       none.

DESCRIPTION    [Toc]    [Back]

       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    [Toc]    [Back]

       Success.   The  user  specified  an  Invalid  option or an
       invalid combination of options.  An error occurred.  [with
       --check]  The  contents of the nsswitch.conf file were not
       completely valid.  [in interactive menu mode]  An  end-offile
 (EOF) condition was seen on standard input.

EXAMPLES    [Toc]    [Back]

       The  following interactive example shows ....  prompt user
       input  resulting  display  The  following  script  example
       shows....   first line of script second line of script ...

ENVIRONMENT VARIABLES    [Toc]    [Back]

       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  corresponding
  value from the default locale is used. If any of
       the internationalization 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 internationalization
       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    [Toc]    [Back]

       Path to the default nsswitch file.  Path  to  the  default
       svc.conf file.

SEE ALSO    [Toc]    [Back]

       Commands: nss2svc(8)

       Files: nsswitch.conf(4)



                                                       nssetup(8)