NAME

nisgrpadm − NIS+ group administration command

SYNOPSIS

nisgrpadm −a| −r| −t [ −s ] group principal...

nisgrpadm −c| −d| −l [ −s ] group

AVAILABILITY

SUNWnisu

DESCRIPTION

nisgrpadm is used to administer NIS+ groups.  This command administers both groups and the groups’ membership lists.  nisgrpadm can create, destroy, or list NIS+ groups..  nisgrpadm can be used to administer a group’s membership list.  It can add or delete principals to the group, or test principals for membership in the group. 

OPTIONS

−a Add the list of NIS+ principals specified to group. The principal name should be fully qualified.

−c Create group in the NIS+ namespace. 

−d Destroy (remove) group from the namespace. 

−l List the effective membership list of the specified group. If the group is recursive, those groups are read as well and their members listed.

−r Remove the list of principals specified from group. The principal name should be fully qualified.

−s Work silently.  Results are returned using the exit status of the command.  This status can be translated into a text string using the niserror(1) command. 

−t Test the list of principals specified for membership in group. 

EXAMPLES

Administering Groups

This example shows how to create a group in the foo.com.  domain. 

example% nisgrpadm −c my_buds.foo.com. 

This example shows how to remove the group from the current domain. 

example% nisgrpadm −d freds_group

Administering Members

This example shows how one would add two principals, bob and betty to the group my_buds.foo.com. 

example% nisgrpadm −a my_buds.foo.com. bob.bar.com. betty.foo.com. 

This example shows how to remove betty from freds_group. 

example% nisgrpadm −r freds_group betty.foo.com. 

ENVIRONMENT

NIS_PATH If this variable is set, and the NIS+ group name is not fully qualified, each directory specified will be searched until the group is found (see nisdefaults(1)). 

SEE ALSO

nis(1), nischgrp(1), nisdefaults(1), niserror(1), nis_groups(3N)

DIAGNOSTICS

NIS_SUCCESS On success, this command returns an exit status of 0. 

NIS_PERMISSION
When you do not have the needed access right to change the group, the command returns this error.

NIS_NOTFOUND
This is returned when the group does not exist.

NIS_TRYAGAIN This error is returned when the server for the group’s domain is currently checkpointing or otherwise in a read-only state.  The command should be retried at a later date. 

NIS_MODERROR
This error is returned when the group was modified by someone else during the execution of the command. Reissue the command and optionally recheck the group’s membership list.

NOTES

Principal names must be fully qualified, whereas groups can be abbreviated on all operations except create. 

SunOS 5.1  —  Last change: 25 Sep 1992