nisrmdir

 

---

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


OPERANDS
 
 
 
 
 SunOS 5.8           Last change: 18 May 1999                    1
 
 
 
 
 
 
 User Commands                                         nisrmdir(1)
 
 
 
      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)
 
 
 
 
 
 SunOS 5.8           Last change: 18 May 1999                    2
 
 
 
 
 
 
 User Commands                                         nisrmdir(1)
 
 
 


NOTES
      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).
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 SunOS 5.8           Last change: 18 May 1999                    3
 
 
 

---