User Commands nisrmdir(1)
NAME
nisrmdir - remove NIS] directories
SYNOPSIS
nisrmdir [-if] [-s hostname] dirname
DESCRIPTION
nisrmdir deletes existing NIS] subdirectories. It can remove
a directory outright, or simply remove replicas from serving
a directory.
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-
ning.
OPTIONS
The following options are supported:
-i Interactive mode. Like the system rm(1) com-
mand the nisrmdir command will ask for con-
firmation 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-
tories.
-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 notification.
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 responding to lookups on that direc-
tory. Cleanup of the files that held the now
removed directory can be accomplished manu-
ally by removing the appropriate files in the
/var/nis directory. See nisfiles(4) for more
information.
SunOS 5.11 Last change: 2 Dec 2005 1
User Commands nisrmdir(1)
-s hostname 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 direc-
tory 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-
cess(1).
OPERANDS
The following operand is supported:
dirname An existing NIS] directory.
EXAMPLES
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.
ENVIRONMENT VARIABLES
SunOS 5.11 Last change: 2 Dec 2005 2
User Commands nisrmdir(1)
NISPATH 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).
EXIT STATUS
The following exit values are returned:
0 Successful operation.
1 Operation failed.
ATRIBUTES
See attributes(5) for descriptions of the following attri-
butes:
ATRIBUTE TYPE ATRIBUTE VALUE
Availability SUNWnisu
SEE ALSO
NIS](1), nisdefaults(1), nisopaccess(1),nisrm(1), nis-
files(4), attributes(5)
NOTES
NIS] might not be supported in future releases of the
Solaris operating system. Tools to aid the migration from
NIS] to LDAP are available in the current Solaris release.
For more information, visit
http:/www.sun.com/directory/nisplus/transition.html.
SunOS 5.11 Last change: 2 Dec 2005 3
|
