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
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
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:
Create a new directory
bar.foo.com.
that is not replicated under the
foo.com.
domain:
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
Environment Variables
- 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.
- 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
nisdefaults(1)).
WARNINGS
HP-UX 11i Version 2 is the last HP-UX release on which NIS+ is
supported.
LDAP is the recommended replacement for NIS+. HP fully supports
the industry standard naming services based on LDAP.
AUTHOR
nismkdir
was developed by Sun Microsystems, Inc.