Export

View

nsadm(1m) Draft Man Page

nsadm.1m Draft Man Page

    System Administration Commands                              nsadm(1M)

WARNINGS
`Please note, that this is a draft version of the manual page and that it can change in the future as well as any detail regarding nsadm described in this manual page.`

NAME
`nsadm - manipulate name service profiles`

SYNOPSIS
`/usr/sbin/nsadm list /usr/sbin/nsadm ~[-v~] ~[-f~] ~[-q~] enable profile /usr/sbin/nsadm ~[-v~] ~[-f~] ~[-q~] disable`

DESCRIPTION
`The nsadm utility's main purpose is to switch between name service profiles defined in the system. It also enables users to list all defined profiles as well as query for their status.`

COMMANDS
`The following commands are supported:`

    list This command lists all the available  profiles  defined
         in  the  system. The "~(online~)" indication is displayed
         to the left of the profile which nsadm believes  to  be
         activated.   Please  note,  that it doesn't necessarily
         mean the associated SMF service are  functioning  well,
         though  if  those services are not online, the warnings
         are displayed.

    enable profile
         This command tries to  activate  give  profile.  If  -f
         option  is  specified, commands are executed right away
         without asking user for  confirmation.  If  -q  is  not
         specified, brief information about steps being taken is
         displayed, while in verbose mode ~(-v option~) much  more
         detailed information is produced.

    disable
         This command disables  the  currently  active  profile,
         changes  name  service  switch  configuration to "files
         only" mode and putssvc:/milestone/name-services:default
         instance  to  maintenance.  The  options  -f, -v and -q
         behave similarly as in "enable" command.

OPTIONS
`The following options are supported: \-v Verbose mode. \-f Forced mode - noninteractive. \-q Quiet mode.`

EXAMPLES

Example 1
Listing all name service profiles defined in the sys-
tem.

        example# nsadm list
        (online) Profile 'office' (LDAP:'home', DNS:'home')
                 Profile 'home'   (DNS:'home')
                 Profile 'files' ()

Example 2
         Same as example one, but the ldap/client service is in
         maintenance for some reason and thus nsadm would issue
         warning.

        example# nsadm list
        (online) Profile 'office' (LDAP:'office', DNS:'office')
        Warning: svc:/network/ldap/client:default is 'maintenance'
                 Profile 'home'   (DNS:'home')
                 Profile 'files' ()

Example 3
Enable profile "home"

        example# nsadm enable home
        Going to enable NSSP [home].
        Going to enable dns/client.
        Going to disable nis/client.
        Going to disable ldap/client.
        Do you want to proceed? [y/N] y
        Going to enable NSSP [home].
        Going to enable dns/client.
        Going to disable nis/client.
        Going to disable ldap/client.
        NSSP switched successfuly.

Example 4
Disable currently active profile

        example# nsadm disable
        Going to disable dns/client.
        Going to disable nis/client.
        Going to disable ldap/client.

EXIT STATUS
`The following exit values are returned:`

    0    The command succesfully executed
    1    Fatal error
    2    Profile not found
    3    Profile is invalid
    4    Unable to switch to profile
    5    Unable to run cmd
    6    Unable to disable back-end
    7    Unable to create configuration file
    8    Timed out waiting for SMF
    9    Unimplemented feature
    10   Invalid argument
    11   Error in SMF
    12   Internal error
    13   Unable to set domainname
    14   Unable to backup files
    15   Not enough memory
    16   Error accessing files
    17   Error handling SMF service
    18   Error getting LDAP config
    19   sasl/GSSAPI doesn't work

FILES
`/etc/nsswitch.conf configuration file for the name service switch`

    /etc/resolv.conf
         resolver configuration file

ATTRIBUTES
`See attributes(5) for descriptions of the following attributes:`

ATTRIBUTE_TYPE	ATTRIBUTE_VALUE
Interface_Stability	Uncommitted

nsadm(1m) Draft Man Page