1nisrmdir(1) User Commands nisrmdir(1)
2
3
4
6 nisrmdir - remove NIS+ directories
7
9 nisrmdir [-if] [-s hostname] dirname
10
11
13 nisrmdir deletes existing NIS+ subdirectories. It can remove a direc‐
14 tory outright, or simply remove replicas from serving a directory.
15
16
17 This command modifies the object that describes the directory dirname,
18 and then notifies each replica to remove the directory named dirname.
19 If the notification of any of the affected replicas fails, the direc‐
20 tory object is returned to its original state unless the -f option is
21 present.
22
23
24 This command will fail if the NIS+ master server is not running.
25
27 The following options are supported:
28
29 -i Interactive mode. Like the system rm(1) command the
30 nisrmdir command will ask for confirmation prior to
31 removing a directory. If the name specified by dirname
32 is a non-fully qualified name this option is forced on.
33 This prevents the removal of unexpected directories.
34
35
36 -f Force the command to succeed even though it may not be
37 able to contact the affected replicas. This option
38 should be used when a replica is known to be down and
39 will not be able to respond to the removal notification.
40 When the replica is finally rebooted it will read the
41 updated directory object, note that it is no longer a
42 replica for that directory, and stop responding to
43 lookups on that directory. Cleanup of the files that
44 held the now removed directory can be accomplished manu‐
45 ally by removing the appropriate files in the /var/nis
46 directory. See nisfiles(4) for more information.
47
48
49 -s hostname Specify that the host hostname should be removed as a
50 replica for the directory named dirname. If this option
51 is not present all replicas and the master server for a
52 directory are removed and the directory is removed from
53 the namespace.
54
55
56
57 Special per-server and per-directory access restrictions may apply when
58 this command updates the serving lists of the affected NIS+ servers.
59 For more information, see nisopaccess(1).
60
62 The following operand is supported:
63
64 dirname An existing NIS+ directory.
65
66
68 Example 1 Using the nisrmdir Command
69
70
71 To remove a directory bar under the foo.com. domain, one would use
72 the command:
73
74
75 example% nisrmdir bar.foo.com.
76
77
78
79
80 To remove a replica that is serving directory bar.foo.com. one would
81 use the command:
82
83
84 example% nisrmdir -s replica.foo.com. bar.foo.com.
85
86
87
88
89 To force the removal of directory bar.foo.com. from the namespace, one
90 would use the command:
91
92
93 example% nisrmdir -f bar.foo.com.
94
95
96
98 NIS_PATH If this variable is set, and the NIS+ directory name is
99 not fully qualified, each directory specified will be
100 searched until the directory is found. See nisdefaults(1).
101
102
104 The following exit values are returned:
105
106 0 Successful operation.
107
108
109 1 Operation failed.
110
111
113 See attributes(5) for descriptions of the following attributes:
114
115
116
117
118 ┌─────────────────────────────┬─────────────────────────────┐
119 │ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
120 ├─────────────────────────────┼─────────────────────────────┤
121 │Availability │SUNWnisu │
122 └─────────────────────────────┴─────────────────────────────┘
123
125 NIS+[22m(1), nisdefaults(1), nisopaccess(1),nisrm(1), nisfiles(4),
126 attributes(5)
127
129 NIS+ might not be supported in future releases of the Solaris operating
130 system. Tools to aid the migration from NIS+ to LDAP are available in
131 the current Solaris release. For more information, visit
132 http://www.sun.com/directory/nisplus/transition.html.
133
134
135
136SunOS 5.11 2 Dec 2005 nisrmdir(1)