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 for-
     mat

     This example prints out the default time to live in  a  ver-
     bose 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  for-
     mat:

     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  format  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 direc-
           tories separated by ':' (colon)  characters.  The  '$'
           (dollar  sign)  character is treated specially. Direc-
           tory 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  attri-
     butes:

     ____________________________________________________________
    |       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.


Man(1) output converted with man2html