nisrmdir - remove NIS+ directories
nisrmdir [-if] [-s hostname] dirname
nisrmdir deletes existing NIS+ subdirectories. It can remove
a directory outright, or simply remove replicas from serving
This command modifies the object that describes the direc-
tory dirname, and then notifies each replica to remove the
directory named dirname. If the notification of any of the
affected replicas fails, the directory object is returned to
its original state unless the -f option is present.
This command will fail if the NIS+ master server is not run-
The following options are supported:
-i Interactive mode. Like the system rm(1) command the
nisrmdir command will ask for confirmation prior to
removing a directory. If the name specified by dirname
is a non-fully qualified name this option is forced
on. This prevents the removal of unexpected direc-
-f Force the command to succeed even though it may not be
able to contact the affected replicas. This option
should be used when a replica is known to be down and
will not be able to respond to the removal notifica-
tion. When the replica is finally rebooted it will
read the updated directory object, note that it is no
longer a replica for that directory, and stop respond-
ing to lookups on that directory. Cleanup of the files
that held the now removed directory can be accom-
plished manually by removing the appropriate files in
the /var/nis directory. See nisfiles(4) for more
Specify that the host hostname should be removed as a
replica for the directory named dirname. If this
option is not present all replicas and the master
server for a directory are removed and the directory
is removed from the namespace.
Special per-server and per-directory access restrictions may
apply when this command updates the serving lists of the
affected NIS+ servers. For more information, see nisopac-
The following operand is supported:
An existing NIS+ directory.
Example 1: Using the nisrmdir Command
To remove a directory bar under the foo.com. domain, one
would use the command:
example% nisrmdir bar.foo.com.
To remove a replica that is serving directory bar.foo.com.
one would use the command:
example% nisrmdir -s replica.foo.com. bar.foo.com.
To force the removal of directory bar.foo.com. from the
namespace, one would use the command:
example% nisrmdir -f bar.foo.com.
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-
The following exit values are returned:
0 Successful operation.
1 Operation failed.
See attributes(5) for descriptions of the following attri-
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
| Availability | SUNWnisu |
nis+(1), nisdefaults(1), nisopaccess(1),nisrm(1), nis-
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
Man(1) output converted with