nisrmdir(1)                                                        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 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

       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 direc-
                       tory. 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 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 directory. 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.

       -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 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 nisopaccess(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

       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).

EXIT STATUS

       The following exit values are returned:

       0        Successful operation.

       1        Operation failed.

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE         |      ATTRIBUTE VALUE        |
       +-----------------------------+-----------------------------+
       |Availability                 |SUNWnisu                     |
       +-----------------------------+-----------------------------+

SEE ALSO

       nis+(1), nisdefaults(1), nisopaccess(1),nisrm(1), nisfiles(4), attributes(5)

NOTES

       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 http://www.sun.com/directory/nisplus/transition.html.

SunOS 5.10                                                          10 Dec 2001                                                        nisrmdir(1)