1nismkdir(1) User Commands nismkdir(1)
2
6 nismkdir - create NIS+ directories
7
9 nismkdir [-D defaults] [-m hostname] [-s hostname] dirname
10
13 The nismkdir command creates new NIS+ subdirectories within an existing
14 domain. It can also be used to create replicated directories. Without
15 options, this command will create a subdirectory with the same master
16 and the replicas as its parent directory.
17 It is advisable to use nisserver(1M) to create an NIS+ domain which
20 consists of the specified directory along with the org_dir and
21 groups_dir subdirectories.
22 The two primary aspects that are controlled when making a directory are
25 its access rights, and its degree of replication.
26 A host that serves a NIS+ directory must be a NIS+ client in a direc‐
29 tory above the one it is serving. The exceptions to this rule are the
30 root NIS+ servers, which are both clients and servers of the same NIS+
31 directory.
32 When the host's default domain is different from the default domain on
35 the client where the command is executed, the hostname supplied as an
36 argument to the -s or -m options must be fully qualified.
37 Special per-server and per-directory access restrictions may apply when
40 this command updates the serving lists of the affected NIS+ servers.
41 See nisopaccess(1).
42
44 The following options are supported:
45 -D defaults Specify a different set of defaults to be used when cre‐
47 ating new directories. The defaults string is a series
48 of tokens separated by colons. These tokens represent
49 the default values to be used for the generic object
50 properties. All of the legal tokens are described below.
51 ttl=time This token sets the default time to
53 live for objects that are created by
54 this command. The value time is spec‐
55 ified in the format as defined by the
56 nischttl(1) command. The default
57 value is 12h (12 hours).
58 owner=ownername This token specifies that the NIS+
61 principal ownername should own the
62 created object. The default for this
63 value is the principal who is execut‐
64 ing the command.
65 group=groupname This token specifies that the group
68 groupname should be the group owner
69 for the object that is created. The
70 default value is NULL.
71 access=rights This token specifies the set of
74 access rights that are to be granted
75 for the given object. The value
76 rights is specified in the format as
77 defined by the nischmod(1) command.
78 The default value is
79 −−−−rmcdr−−−r−−−.
80 -m hostname If the directory named by dirname does not exist, then a
84 new directory that is not replicated is created with
85 host hostname as its master server.
86 If the directory name by dirname does exist, then the
88 host named by hostname is made its master server.
89 -s hostname Specify that the host hostname will be a replica for an
92 existing directory named dirname.
93
96 The following operand is supported:
97 dirname The fully qualified NIS+ name of the directory that has to
99 be created.
100
103 Example 1 Using the nismkdir Command
104 To create a new directory bar under the foo.com. domain that shares
107 the same master and replicas as the foo.com. directory one would use
108 the command:
109 example% nismkdir bar.foo.com.
112 To create a new directory bar.foo.com. that is not replicated under
117 the foo.com. domain one would use the command:
118 example% nismkdir -m myhost.foo.com. bar.foo.com.
121 To add a replica server of the bar.foo.com. directory, one would use
126 the command:
127 example% nismkdir -s replica.foo.com. bar.foo.com.
130
134 NIS_DEFAULTS This variable contains a defaults string that will
135 override the NIS+ standard defaults. If the -D switch
136 is used those values will then override both the
137 NIS_DEFAULTS variable and the standard defaults.
138 NIS_PATH If this variable is set, and the NIS+ directory name is
141 not fully qualified, each directory specified will be
142 searched until the directory is found (see nisde‐
143 faults(1)).
144
147 The following exit values are returned:
148 0 Successful operation.
150 1 Operation failed.
153
156 See attributes(5) for descriptions of the following attributes:
157 ┌─────────────────────────────┬─────────────────────────────┐
162 │ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
163 ├─────────────────────────────┼─────────────────────────────┤
164 │Availability │SUNWnisu │
165 └─────────────────────────────┴─────────────────────────────┘
166
168 NIS+[22m(1), nischmod(1), nischttl(1), nisdefaults(1), nisls(1), nisopac‐
169 cess(1), nisrmdir(1), nisserver(1M), attributes(5)
170
172 NIS+ might not be supported in future releases of the Solaris operating
173 system. Tools to aid the migration from NIS+ to LDAP are available in
174 the current Solaris release. For more information, visit
175 http://www.sun.com/directory/nisplus/transition.html.
176SunOS 5.11 2 Dec 2005 nismkdir(1)