Export

View

More actions

nscfg(1m) Draft Man Page

nscfg.1m Draft Man Page

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
nscfg - import, create and manage name service profiles

SYNOPSIS
/usr/sbin/nscfg

/usr/sbin/nscfg subcommand [ ; subcommand [ ; subcommand ...]]

DESCRIPTION
     The nscfg utility is a universal configuration management tool for
     name service subsystem. It lets users create the new name service
     profiles, which include configuration for name service switch, see
     nsswitch.conf(4), and configuration for zero or more    name service
     back-ends, see ldap(1), nis(1), resolv.conf(4). The profiles can be
     created either by importing existing name service configuration files
     or manually or by discovering name service related configura- tion from
     DHCP.

     Name service configuration profiles are are stored in SMF configuration
     repository,    where each back-end configuration type is stored in the
     corresponding SMF instance - i.e. svc:/network/ldap/client:default,
     svc:/network/nis/client etc.    The    switch    configuration    is
     stored    in svc:/system/name-service-cache:default instance. There's
     a link between a switch configuration and back-end configura- tions
     forming a name service profile, which then    users can activate using
     nsadm(1M) utility.

SUBCOMMANDS
help|?
Help.

select config-type name
Select entity as current.

unselect
Unselect current entity.

list [config-type [name]]
List Profiles/Back-Ends.

listprop [config-type [name]]
List contents of Profiles/Back-Ends.

create config-type name
Create Profile/Back-end.

import [config-type] name
Import legacy configuration.

discover [ -n name ] [ -w timeout_sec ]
Discover name services configuration from DHCP.

delete [-f] config-type name
Delete Profile/Back-end.

clone config-type name newname
Clone Profile/Back-end.

setprop [config-type name] key=value
Set value of Profile/Back-End property.

delprop [config-type name] key
Remove a Profile/Back-End property.

associate [nsswitch name] config-type name
Associate Back-End with Profile.

detach [nsswitch name] config-type
Remove Back-End association with Profile.

commit | save
Save created/modified Profile/Back-End.

rollback | discard
Discard actual changes to Profile/Back-End.

getent
Get entries from database. NOT IMPLEMENTED

set -v|-V | verbose | noverbose
Turn verbose mode on/off.

exit | end | quit
Terminate nscfg session.

OPTIONS
The following options are supported:

-v Verbose mode.

-q Quiet mode.

EXAMPLES

Example 1
Importing existing system configuration. New profile
"initial_config" will be made.

     example# nscfg
     nscfg> verbose
     Verbose mode on.
     nscfg> import initial_config
     Info: Importing legacy configuration files for [nsswitch].
     Info: Importing legacy configuration files for [dns].
     Info: Assigning DNS configuration to the profile.
     Info: Importing legacy configuration files for [nis].
     Info: Assigning NIS configuration to the profile.
     Info: Going to save data to repository.
     Info: Profile [initial_config]   created.
     nscfg> exit

Example 2
Discovering name service configuration from DHCP. New
profile "from_dhcp" fill be made.

     example# nscfg
     nscfg> verbose
     Verbose mode on.
     nscfg> discover -n from_dhcp
     Discover timeout is defaulting to 5 sec.
     1 back-end(s) discovered

     nis from_dhcp
       domainname = "prague.czech.sun.com"
       serverlist = "129.157.72.200"
     nsswitch from_dhcp
       passwd = "files nis"
       group = "files nis"
       hosts = "files nis"
       ipnodes = "files nis"
       networks = "nis [NOTFOUND=return] files"
       ...
       PROF_profile_be_yp = "from_dhcp"
     nscfg> exit

Example 3
Creating a profile manually.

     example# nscfg
     nscfg> create nsswitch office
     (modified) nscfg/nsswitch/office> listprop
     Current configuration:
       nsswitch office (modified)
         passwd = "files"
         group = "files"
         hosts = "files"
         ipnodes = "files"
         networks = "files"
         protocols = "files"
         rpc = "files"
         ethers = "files"
         netmasks = "files"
         bootparams = "files"
         publickey = "files"
         ...
     (modified) nscfg/nsswitch/office> commit
     nscfg/nsswitch/office> unselect
     nscfg> create nis office
     (modified) nscfg/nis/office> listprop
     Current configuration:
       nis office (modified)
         domainname = ""
         serverlist = ""
     (modified) nscfg/nis/office> setprop domainname="office.example.org"
     (modified) nscfg/nis/office> setprop serverlist="nis_srv1 nis_srv2"
     (modified) nscfg/nis/office> listprop
     Current configuration:
       nis office (modified)
         domainname = "office.example.org"
         serverlist = "nis_srv1 nis_srv2"
     (modified) nscfg/nis/office> commit
     nscfg/nis/office> unselect
     nscfg> select nsswitch office
     nscfg/nsswitch/office> associate nis office
     (modified) nscfg/nsswitch/office> setprop hosts="files   nis"
     (modified) nscfg/nsswitch/office> setprop ipnodes="files nis"
     (modified) nscfg/nsswitch/office> setprop passwd="files nis"
     (modified) nscfg/nsswitch/office> commit
     nscfg/nsswitch/office> unselect
     nscfg> exit

EXIT STATUS
The following exit values are returned:

0 The command succesfully executed.

Please see the KNOWN BUGS section. Exit status is always 0
due to a known bug in nscfg(1M) utility.

FILES
/etc/resolv.conf /etc/nsswitch.conf

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

ATTRIBUTE_TYPE	ATTRIBUTE_VALUE
Interface_Stability	Uncommited

KNOWN BUGS
Exit status is always 0.

Many. And many unknown too.

nscfg(1m) Draft Man Page