NAME [Toc] [Back]
nismkdir - create NIS+ directories
SYNOPSIS [Toc] [Back]
nismkdir [ -D defaults ] [ -m hostname | -s hostname ]
DESCRIPTION [Toc] [Back]
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
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
Options [Toc] [Back]
-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
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).
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.
This token specifies that the group groupname
should be the group owner for the object that is
created. The default value is NULL.
This token specifies the set of access rights that
Hewlett-Packard Company - 1 - HP-UX 11i Version 2: August 2003
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
-m hostname If the directory named by dirname does not exist, then
a new directory that is not replicated 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 [Toc] [Back]
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 [Toc] [Back]
This command returns 0 if successful and 1 otherwise.
EXAMPLES [Toc] [Back]
Create a new directory bar under the foo.com. domain that shares the
same master and replicas as the foo.com. directory:
Create a new directory bar.foo.com. that is not replicated under the
nismkdir -m myhost.foo.com. bar.foo.com.
Add a replica server of the bar.foo.com. directory:
nismkdir -s replica.foo.com. bar.foo.com.
EXTERNAL INFLUENCES [Toc] [Back]
NIS_DEFAULTS This variable contains a defaults string that will
override the NIS+ standard defaults. If the -D
switch is used, those values will then override both
the NIS_DEFAULTS variable and the standard defaults.
Hewlett-Packard Company - 2 - HP-UX 11i Version 2: August 2003
NIS_PATH If this variable is set and the NIS+ directory name
is not fully qualified, each directory specified
will be searched until the directory is found (see
WARNINGS [Toc] [Back]
HP-UX 11i Version 2 is the last HP-UX release on which NIS+ is
LDAP is the recommended replacement for NIS+. HP fully supports the
industry standard naming services based on LDAP.
AUTHOR [Toc] [Back]
nismkdir was developed by Sun Microsystems, Inc.
SEE ALSO [Toc] [Back]
nis+(1), nischmod(1), nisdefaults(1), nisls(1), nisrmdir(1),
Hewlett-Packard Company - 3 - HP-UX 11i Version 2: August 2003 [ Back ]