nischown(1)							   User Commands						       nischown(1)

NAME

       nischown - change the owner of a NIS+ object

SYNOPSIS

       nischown [-AfLP] owner name...

DESCRIPTION

       nischown  changes  the owner of the NIS+ objects or entries specified by name to owner. Entries are specified using indexed names (see nis-
       match(1)). If owner is not a fully qualified  NIS+ principal name (see nisaddcred(1M)), the default domain  (see  nisdefaults(1))  will	be
       appended to it.

       The  only  restriction  on changing an object's owner is that you must have modify permissions for the object. Note: If you are the current
       owner of an object and you change ownership,  you may not be able to regain ownership unless you have modify access to  the new object.

       The command will fail if the master NIS+ server is not running.

       The  NIS+ server will check the validity of the name before making the modification.

OPTIONS

       The following options are supported:

       -A	Modify all entries in all tables in the concatenation path that match the search criteria specified in name.  It  implies  the	-P
		option.

       -f	Force the operation and fail silently if it does not succeed.

       -L	Follow links and change the owner of the linked object or entries rather than the owner of the link itself.

       -P	Follow	the  concatenation path within a named table. This option is only meaningful when either name is an indexed name or the -L
		option is also specified and the named object is a link pointing to entries.

EXAMPLES

       Example 1: Using the nischown Command

       The following two examples show how to change the owner of an object to a principal in a different domain, and to change it to a  principal
       in the local domain, respectively.

       example% nischown bob.remote.domain. object
       example% nischown skippy object

       The next example shows how to change the owner of an entry in the passwd table.

       example% nischown bob.remote.domain. '[uid=99],passwd.org_dir'

       This example shows how to change the object or entries pointed to by a link.

       example% nischown -L skippy linkname

ENVIRONMENT VARIABLES

       NIS_PATH 		       If  this  variable  is  set,  and  the  NIS+  name is not fully qualified, each directory specified will be
				       searched until the object 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), nischgrp(1), nischmod(1), nischttl(1), nisdefaults(1), nisaddcred(1M), nismatch(1), nis_objects(3NSL), 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 						       nischown(1)