nismkdir(1) User Commands nismkdir(1)
NAME
nismkdir - create NIS+ directories
SYNOPSIS
nismkdir [ -D defaults ] [ -m hostname | -s hostname ]
dirname
AVAILABILITY
SUNWnisu
DESCRIPTION
The nismkdir command creates new NIS+ subdirectories within
an existing domain. It can also be used to create repli-
cated 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 group_dir subdirectories.
The two primary aspects that are controlled when making a
directory are its access rights, and its degree of replica-
tion.
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+ prin-
cipal ownername should own the created
object. The default for this value is
the principal who is executing the com-
mand.
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 dir-
name.
RETURN VALUES
0 This command returns 0 if successful and 1 otherwise.
EXAMPLES
To create a new directory bar under the foo.com. domain that
shares the same master and replicas as the foo.com. direc-
tory one would use the command:
example% nismkdir bar.foo.com.
To create a new directory bar.foo.com. that is not repli-
cated under the foo.com. domain one would use the command:
example% nismkdir -m myhost.foo.com. bar.foo.com.
To add a replica server of the bar.foo.com. directory, one
would use the command:
example% nismkdir -s replica.foo.com. bar.foo.com.
ENVIRONMENT
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 nisde-
faults(1)).
SEE ALSO
nis+(1), nischmod(1), nisdefaults(1), nisls(1), nisrmdir(1),
nisserver(1M)
NOTES
A host that serves a NIS+ directory must be a 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 than 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.
SunOS 5.4 Last change: 25 Sep 1992