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