nisdefaults(1)                                                     User Commands                                                    nisdefaults(1)

NAME

       nisdefaults - display NIS+ default values

SYNOPSIS

       nisdefaults [-adghprstv]

DESCRIPTION

       The nisdefaults utility prints the default values that are returned by calls to the  NIS+ local name functions (see nis_local_names(3NSL)).
       With no options specified, all defaults will be printed in a verbose format. With options, only that option is displayed in  a  terse  form
       suitable for shell scripts. See the example below.

OPTIONS

       The following options are supported:

       -a       Print all defaults in a terse format.

       -d       Print the default domain name.

       -g       Print the default group name.

       -h       Print the default host name.

       -p       Print the default principal name.

       -r       Print the default access rights with which new objects will be created.

       -s       Print the default directory search path.

       -t       Print the default time to live value.

       -v       Print the defaults in a verbose format. This prepends an identifying string to the output.

EXAMPLES

       Example 1: Printing NIS+ defaults

       The following prints the  NIS+ defaults for a root process on machine example in the  foo.bar. domain:

       example# nisdefaults
       Principal Name :    example.foo.bar.
       Domain Name    :    foo.bar.
       Host Name :    example.foo.bar.
       Group Name     :
       Access Rights   :       ----rmcdr---r---
       Time to live   :    12:00:00
       Search Path    :    foo.bar.

       Example 2: Setting a variable in the shell script

       This example sets a variable in a shell script to the default domain:

       DOMAIN=`nisdefaults -d`

       Example 3: Printing the default time to live in verbose format

       This example prints out the default time to live in a verbose format:

       example% nisdefaults -tv
       Time to live   :       12:00:00

       Example 4: Printing the time to live in terse format

       This example prints out the time to live in the terse format:

       example% nisdefaults -t
       43200

ENVIRONMENT VARIABLES

       Several environment variables affect the defaults associated with a process.

       NIS_DEFAULTS            This  variable  contains a defaults string that will override the  NIS+ standard defaults. The defaults string is a
                               series of tokens separated by colons. These tokens represent the default values to be used for the  generic  object
                               properties. All of the legal tokens are described below.

                               ttl=time

                                   This token sets the default time to live for objects that are created. The value  time is specified in the for-
                                   mat as defined by the nischttl(1) command. The default value is 12 hours.

                               owner=ownername

                                   This token specifies that the NIS+ principal  ownername should own created objects. The default for this  value
                                   is the principal who is executing the command.

                               group=groupname

                                   This  token  specifies  that the group  groupname should be the group owner for created objects. The default is
                                   NULL.

                               access=rights

                                   This token specifies the set of access rights that are to be granted for created objects. The value  rights  is
                                   specified in the format as defined by the  nischmod(1) command. The default value is: ----rmcdr---r---.

       NIS_GROUP               This  variable  contains  the  name of the local NIS+ group. If the name is not fully qualified, the default domain
                               will be appended to it.

       NIS_PATH                This variable overrides the default NIS+ directory search path. It contains an ordered list  of  directories  sepa-
                               rated  by ':' (colon) characters. The '$' (dollar sign) character is treated specially. Directory names that end in
                               '$' have the default domain appended to them, and a '$' by itself is replaced by the list  of  directories  between
                               the default domain and the global root that are at least two levels deep. The default NIS+ directory search path is
                               '$'.

                               Refer to the  Name Expansion subsection in nis+(1) for more details.

ATTRIBUTES

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

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE         |      ATTRIBUTE VALUE        |
       +-----------------------------+-----------------------------+
       |Availability                 |SUNWnisu                     |
       +-----------------------------+-----------------------------+

SEE ALSO

       nischmod(1), nischttl(1), nis+(1), nis_local_names(3NSL), attributes(5)

NOTES

       NIS+ might not be supported in future releases of the SolarisTM Operating Environment. Tools to aid the migration from  NIS+  to  LDAP  are
       available in the Solaris 9 operating environment. For more information, visit http://www.sun.com/directory/nisplus/transition.html.

SunOS 5.10                                                          10 Dec 2001                                                     nisdefaults(1)