User Commands 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 orgdir and groupsdir subdirectories.
The two primary aspects that are controlled when making a
directory are its access rights, and its degree of replica-
tion.
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 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.
Special per-server and per-directory access restrictions may
apply when this command updates the serving lists of the
affected NIS] servers. See nisopaccess(1).
OPTIONS
The following options are supported:
-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.
SunOS 5.11 Last change: 2 Dec 2005 1
User Commands nismkdir(1)
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 owner-
name should own the
created object. The
default for this value is
the principal who is exe-
cuting 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 NUL.
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.
SunOS 5.11 Last change: 2 Dec 2005 2
User Commands nismkdir(1)
OPERANDS
The following operand is supported:
dirname The fully qualified NIS] name of the directory
that has to be created.
EXAMPLES
Example 1 Using the nismkdir Command
To create a new directory bar under the foo.com. domain
that shares the same master and replicas as the foo.com.
directory 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 VARIABLES
NISDEFAULTS 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
NISDEFAULTS variable and the standard
defaults.
NISPATH If this variable is set, and the NIS] direc-
tory name is not fully qualified, each
directory specified will be searched until
the directory is found (see nisdefaults(1)).
SunOS 5.11 Last change: 2 Dec 2005 3
User Commands nismkdir(1)
EXIT STATUS
The following exit values are returned:
0 Successful operation.
1 Operation failed.
ATRIBUTES
See attributes(5) for descriptions of the following attri-
butes:
ATRIBUTE TYPE ATRIBUTE VALUE
Availability SUNWnisu
SEE ALSO
NIS](1), nischmod(1), nischttl(1), nisdefaults(1), nisls(1),
nisopaccess(1), nisrmdir(1), nisserver(1M), attributes(5)
NOTES
NIS] might not be supported in future releases of the
Solaris operating system. Tools to aid the migration from
NIS] to LDAP are available in the current Solaris release.
For more information, visit
http:/www.sun.com/directory/nisplus/transition.html.
SunOS 5.11 Last change: 2 Dec 2005 4
|
