nischgrp
User Commands nischgrp(1)NAME
nischgrp - change the group owner of a NIS+ objectSYNOPSIS
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 have modify permissions for the object. This command will fail if the master NIS+ server is not run- ning.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: Examples of 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. SunOS 5.8 Last change: 25 Sep 1992 1 User Commands nischgrp(1) 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 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), nischmod(1), nischown(1), nisdefaults(1), nis- grpadm(1), nismatch(1), nis_objects(3NSL), attributes(5)NOTES
The NIS+ server will check the validity of the group name prior to effecting the modification. SunOS 5.8 Last change: 25 Sep 1992 2