👤
Home Man
Search
Today's Posts
Register

Linux & Unix Commands - Search Man Pages
Man Page or Keyword Search:
Select Section of Man Page:
Select Man Page Repository:

OpenSolaris 2009.06 - man page for nisrmdir (opensolaris section 1)

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 sim-
       ply 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 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 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 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 com-
       mand:

	 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 Solaris operating system. Tools to
       aid the migration from NIS+ to LDAP are available in the current Solaris release. For more
       information, visit http://www.sun.com/directory/nisplus/transition.html.

SunOS 5.11				    2 Dec 2005				      nisrmdir(1)


All times are GMT -4. The time now is 01:59 PM.

Unix & Linux Forums Content Copyrightę1993-2018. All Rights Reserved.
×
UNIX.COM Login
Username:
Password:  
Show Password