HP-UX Reference (11i v2 03/08) - 1 User Commands N-Z (vol 2)

n
nismkdir(1) nismkdir(1)
NAME
nismkdir - create NIS+ directories
SYNOPSIS
nismkdir [ -D defaults ][-m
hostname | -s hostname ] dirname
DESCRIPTION
The
nismkdir command creates new NIS+ subdirectories within an existing domain. It can also be
used to create replicated directories. Without options, this command will create a subdirectory with the
same master and the replicas as its parent directory.
It is advisable to use nisserver (1M) to create an NIS+ domain which consists of the specified directory
along with the
org_dir and groups_dir subdirectories.
The two primary aspects that are controlled when making a directory are its access rights, and its degree
of replication.
dirname is the fully qualified NIS+ name of the directory that has to be created.
Options
-D defaults Specify a different set of defaults to be used when creating new directories. 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 by this command.
The value time is specified in the format as defined by the nischttl (1) command.
The default value is
12h (12 hours).
owner=ownername
This token specifies that the NIS+ principal ownername should own the created
object. 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 the
object that is created. The default value is NULL.
access=rights
This token specifies the set of access rights that are to be granted for the given
object. The value rights is specified in the format as defined by the nischmod(1)
command. The default value is
- - - -rmcdr- - -r- - -
.
-m hostname If the directory named by dirname does not exist, then a new directory that is not repli-
cated is created with host hostname as its master server.
If the directory name by dirname does exist, then the host named by hostname is made
its master server.
-s hostname Specify that the host hostname will be a replica for an existing directory named dirname.
Notes
A host that serves an NIS+ directory must be an NIS+ client in a directory above the one it is serving.
The exceptions to this rule are the root NIS+ servers which are both clients and servers of the same NIS+
directory.
When the host’s default domain is different from the default domain on the client where the command is
executed, the hostname supplied as an argument to the -s or -m options must be fully qualified.
RETURN VALUES
This command returns
0 if successful and 1 otherwise.
EXAMPLES
Create a new directory
bar under the foo.com. domain that shares the same master and replicas as
the foo.com. directory:
nismkdir bar.foo.com.
HP-UX 11i Version 2: August 2003 − 1 − Hewlett-Packard Company Section 1−−615