Sun Microsystems, Inc.
spacer | | |  
black dot
A   B   C   D   E   F   G   H   I   J   K   L   M   N   O   P   Q   R   S   T   U   V   W   X   Y   Z
User Commandsnisdefaults(1)


 nisdefaults - display NIS+ default values


 nisdefaults [-adghprstv]



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.



The following options are supported:

Print all defaults in a terse format.
Print the default domain name.
Print the default group name.
Print the default host name.
Print the default principal name.
Print the default access rights with which new objects will be created.
Print the default directory search path.
Print the default time to live value.
Print the defaults in a verbose format. This prepends an identifying string to the output.


 Example 1. Printing NIS+ defaults

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

example# nisdefaults
Principal Name	:
Domain Name	:
Host Name	:
Group Name	:
Access Rights   :       ----rmcdr---r---
Time to live	:	12:00:00
Search Path	:
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



Several environment variables affect the defaults associated with a process.

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.
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.
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.
This token specifies that the group groupname should be the group owner for created objects. The default is NULL.
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---.
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.
This variable overrides the default NIS+ directory search path. It contains an ordered list of directories separated 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.



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




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



NIS+ might not be supported in future releases of the Solaris Operating Environment. Tools to aid the migration from NIS+ to LDAP are available in the Solaris 9 operating environment. For more information, visit

SunOS 5.9Go To TopLast Changed 10 Dec 2001

Copyright 2002 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms.