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

     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  nisde-
           faults(1).


EXIT STATUS

     The following exit values are returned:

          0     Successful operation.

          1     Operation failed.


ATTRIBUTES

     See attributes(5) for descriptions of the  following  attri-
     butes:

     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE 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
     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.


Man(1) output converted with man2html