Unix‎ > ‎Solaris‎ > ‎Solaris man pages‎ > ‎1‎ > ‎

nischgrp


NAME
     nischgrp - change the group owner of a NIS+ object

SYNOPSIS
     nischgrp [-AfLP] group name...


DESCRIPTION
     nischgrp changes the group owner  of  the  NIS+  objects  or
     entries  specified  by  name  to  the  specified NIS+ group.
     Entries are specified using indexed names (see nismatch(1)).
     If  group is not a fully qualified  NIS+ group name, it will
     be resolved using the  directory  search  path  (see  nisde-
     faults(1)).


     The only restriction on changing an object's group owner  is
     that you must have modify permissions for the object.


     This command will fail if the master NIS+ server is not run-
     ning.


     The  NIS+ server will check the validity of the  group  name
     prior to effecting the  modification.

OPTIONS
     The following options are supported:

     -A    Modify all entries in all tables in the  concatenation
           path  that  match  the  search  criterion specified in
           name. This option implies the -P switch.


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


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


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


EXAMPLES

     Example 1 Using the nischgrp Command


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


       example% nischgrp newgroup.remote.domain. object
       example% nischgrp my-buds object




     This example shows how to change the group owner for a pass-
     word entry.


       example% nischgrp admins '[uid=99],passwd.org_dir'




     In the previous example, admins is a NIS+ group in the  same
     domain.



     The next two examples change the group owner of  the  object
     or  entries pointed to by a link, and the group owner of all
     entries in the hobbies table.


       example% nischgrp -L my-buds linkname
       example% nischgrp my-buds '[],hobbies'



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  attri-
     butes:



     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | SUNWnisu                    |
    |_____________________________|_____________________________|


SEE ALSO
     NIS+(1),  nischmod(1),  nischown(1),  nisdefaults(1),   nis-
     grpadm(1), nismatch(1), nis_objects(3NSL), 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.










Man pages from Solaris 10 Update 8. See docs.sun.com and www.oracle.com for further documentation and Solaris information.
Comments