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 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 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 gen-
           eric 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.


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

     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)).


EXIT STATUS

     The following exit values are returned:

          0     Successful operation.

          1     Operation failed.


ATTRIBUTES

     See attributes(5) for descriptions of the  following  attri-
     butes:

     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE 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
     SolarisTM  Operating Environment. Tools to aid the migration
     from NIS+ to LDAP are available in the Solaris  9  operating
     environment.      For      more      information,      visit
     http://www.sun.com/directory/nisplus/transition.html.


Man(1) output converted with man2html