unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

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

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  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), nischgrp(1), nischmod(1), nischttl(1), nisdefaults(1), nisadd-
       cred(1M), nismatch(1), nis_objects(3NSL), 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                      nischown(1)