NAME
nischgrp — change the group owner of an 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.
Options
- -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
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:
nischgrp newgroup.remote.domain. object
nischgrp my-buds object
Change the group owner for a password entry:
nischgrp admins '[uid=99],passwd.org_dir'
In the above example,
admins
is an NIS+ group in the same domain.
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:
nischgrp -L my-buds linkname
nischgrp my-buds '[],hobbies'
EXTERNAL INFLUENCES
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)).
RETURN VALUE
nischgrp
returns
0
on success and
1
on failure.
AUTHOR
nischgrp
was developed by Sun Microsystems, Inc.
NOTES
The
NIS+
server will check the validity of the group name prior to effecting the
modification.
