unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (SunOS-5.10)
Page:
Section:
Apropos / Subsearch:
optional field

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 iden-
                tifying 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 prop-
                               erties. 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+ princi-
                                   pal  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  group-
                                   name  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+ direc-
                               tory search path. It contains an  ordered  list
                               of directories separated by ':' (colon) charac-
                               ters.  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:


       tab()     allbox;     cw(2.750000i)|    cw(2.750000i)    lw(2.750000i)|
       lw(2.750000i).  ATTRIBUTE TYPEATTRIBUTE VALUE AvailabilitySUNWnisu


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 Operat-
       ing  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)