HP-UX Reference (11i v2 04/09) - 1 User Commands N-Z (vol 2)
n
nisrmdir(1) 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 directory 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 running.
Options
-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 directories.
-f Force the command to succeed even though it may not be able to contact the affected repli-
cas. 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 directory. Cleanup of the files that held the now removed
directory can be accomplished manually by removing the appropriate files in the
/var/nis directory (see nisfiles(4) for more information).
-s hostname
Specify that the host hostname should be removed as a replica for the directory named dir-
name. 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.
RETURN VALUE
This command returns
0 if it is successful, and 1 otherwise.
EXAMPLES
Remove a directory
bar under the foo.com. domain:
nisrmdir bar.foo.com.
Remove a replica that is serving directory bar.foo.com.:
nisrmdir -s replica.foo.com. bar.foo.com.
Force the removal of directory bar.foo.com. from the namespace:
nisrmdir -f bar.foo.com.
EXTERNAL INFLUENCES
Environment Variables
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
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 ser-
vices based on LDAP.
AUTHOR
nisrmdir was developed by Sun Microsystems, Inc.
SEE ALSO
nis+(1), nisdefaults(1), nisrm(1), nisfiles(4).
HP-UX 11i Version 2: September 2004 − 1 − Hewlett-Packard Company Section 1−−665