N1 Grid Service Provisioning System 5.0 Command-Line Interface Reference Manual

udb.g: Managing User Groups

You can use the udb.g commands to define, modify, delete, and list user groups.

Table 13–2 Summary of udb.g Commands


Command Name	Description
udb.g.add	Adds a new user group
udb.g.del	Deletes a user group
udb.g.la	Lists all the user groups
udb.g.lo	Retrieves information about the specified user group.
udb.g.lp	Lists the permissions granted to the specified group
udb.g.lu	Lists the users who are members of the specified group
udb.g.mod	Modifies an existing user group

udb.g.add

This command adds a new group.

Table 13–3 Arguments and Result for the udb.g.add Command


Argument/Result		Syntax	Description
n	[R]	String	The new group name
d	[O]	String	The new group description
hostWrite	[O]	Boolean	Whether the new group has write permission on hosts; default is false
notRuleWrite	[O]	Boolean	Whether the new group has write permission on notification rules; default is false
adminWrite	[O]	Boolean	Whether the new group has write permission on ``admin: users and groups;'' default is false
diffWrite	[O]	Boolean	Whether the new group has write permission on comparisons; default is false
diffRun	[O]	String	The hostSet ID for which the new group has execute permission for comparisons. An empty value removes the execute permission on any hostsets. To set this permission for ``all'' hostsets, clients use the ``allhosts'' sentinel value.
ua	[O]	UserArray	The new group users
pga	[O]	GroupArray	The new group parent groups
cga	[O]	GroupArray	The new group child groups
result		Group	The new group

This command deletes the specified group.

Note –

Deleting a group does not delete the user accounts in the group. It simply deletes the group as a classification for the user accounts.

Table 13–4 Argument for the udb.g.del Command


Argument		Syntax	Description
ID	[R]	GroupID	The group ID

This command lists all the groups defined in the N1 Grid Service Provisioning System software.

Table 13–5 Result for the udb.g.la Command


Result	Syntax	Description
result	GroupArray	The groups

This command retrieves the specified group.

Table 13–6 Argument and Result for the udb.g.lo Command


Argument/Result		Syntax	Description
ID	[R]	GroupID	The group ID
result		Group	The group

This command lists the permissions granted to a group

Table 13–7 Argument and Result for the udb.g.lp


Argument/Result		Syntax	Description
ID	[R]	GroupID	The group ID
result		PermissionArray	The permissions

This command lists the members of the specified group

Table 13–8 Argument and Result for the udb.g.lu Command


Argument/Result		Syntax	Description
ID	[R]	GroupID	The group ID
result		UserArray	The users

This command modifies an existing group. Omitted arguments preserve current values

Table 13–9 Arguments and Result for the udb.g.mod Command


Argument/Result		Syntax	Description
ID	[R]	GroupID	The group ID
n	[O]	String	The new group name
d	[O]	String	The new group description
hostWrite	[O]	Boolean	Whether the new group has write permission on hosts
notRuleWrite	[O]	Boolean	Whether the new group has write permission on notification rules
adminWrite	[O]	Boolean	Whether the new group has write permission on ``admin: users and groups''
diffWrite	[O]	Boolean	Whether the new group has write permission on comparisons
diffRun	[O]	String	The hostSet ID for which the new group has execute permission for comparisons. An empty value removes the execute permission on any hostsets. To set this permission for ``all'' hostsets, clients use the ``allhosts'' sentinel value.
ua	[O]	UserArray	The new group users
pga	[O]	GroupArray	The new group parent groups
cga	[O]	GroupArray	The new group child groups
result		Group	The modified group