nismkdir(1)                                                     nismkdir(1)




 NAME    [Toc]    [Back]
      nismkdir - create NIS+ directories

 SYNOPSIS    [Toc]    [Back]
      nismkdir [ -D defaults ] [ -m hostname | -s hostname ]
           dirname

 DESCRIPTION    [Toc]    [Back]
      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    [Toc]    [Back]
      -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



 Hewlett-Packard Company            - 1 -   HP-UX 11i Version 2: August 2003






 nismkdir(1)                                                     nismkdir(1)




                          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    [Toc]    [Back]
      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    [Toc]    [Back]
      This command returns 0 if successful and 1 otherwise.

 EXAMPLES    [Toc]    [Back]
      Create a new directory bar under the foo.com.  domain that shares the
      same master and replicas as the foo.com.  directory:

           nismkdir bar.foo.com.

      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    [Toc]    [Back]
    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.





 Hewlett-Packard Company            - 2 -   HP-UX 11i Version 2: August 2003






 nismkdir(1)                                                     nismkdir(1)




      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    [Toc]    [Back]
      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    [Toc]    [Back]
      nismkdir was developed by Sun Microsystems, Inc.

 SEE ALSO    [Toc]    [Back]
      nis+(1), nischmod(1), nisdefaults(1), nisls(1), nisrmdir(1),
      nisserver(1M).


 Hewlett-Packard Company            - 3 -   HP-UX 11i Version 2: August 2003