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 nismatch(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 owner-
ship, 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 run-
ning.
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 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), nischgrp(1), nischmod(1), nischttl(1), nisde-
faults(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.
Man(1) output converted with
man2html