Sun Microsystems, Inc.
spacerspacer
spacer   www.sun.com docs.sun.com | | |  
spacer
black dot
   
A   B   C   D   E   F   G   H   I   J   K   L   M   N   O   P   Q   R   S   T   U   V   W   X   Y   Z
    
 
User Commandsnischgrp(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 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 attributes:

ATTRIBUTE TYPEATTRIBUTE VALUE
AvailabilitySUNWnisu

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 Solaris 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.9Go To TopLast Changed 10 Dec 2001

 
      
      
Copyright 2002 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms.