nischgrp(1)							   User Commands						       nischgrp(1)

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 nisdefaults(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 running.

       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 password 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  hob-
       bies 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 attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Availability		     |SUNWnisu			   |
       +-----------------------------+-----------------------------+

SEE ALSO

       nis+(1), nischmod(1), nischown(1), nisdefaults(1), nisgrpadm(1), 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 						       nischgrp(1)