nismkdir [-D defaults] [-m hostname] [-s hostname] dirname
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.
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).
The following options are supported:
If the directory name by dirname does exist, then the host named by hostname is made its master server.
The following operand is supported:
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 replicated 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.
The following exit values are returned:
See attributes(5) for descriptions of the following attributes:
NIS+(1), nischmod(1), nischttl(1), nisdefaults(1), nisls(1), nisopaccess(1), nisrmdir(1), nisserver(1M), attributes(5)
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.