unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (SunOS-5.10)
Page:
Section:
Apropos / Subsearch:
optional field

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 direc-
       tory 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  direc-
       tory  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 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  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  responding  to
                       lookups  on  that  directory. Cleanup of the files that
                       held the now removed directory can be accomplished man-
                       ually 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 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 attributes:


       tab()    allbox;    cw(2.750000i)|     cw(2.750000i)     lw(2.750000i)|
       lw(2.750000i).  ATTRIBUTE TYPEATTRIBUTE VALUE AvailabilitySUNWnisu


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