Sun N1 Service Provisioning System 5.2 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 14–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 14–3 Arguments and Result for the udb.g.add Command


Argument/Result		Syntax	Description
n	Required	String	The new group name
d	Optional	String	The new group description
hostWrite	Optional	Boolean	Whether the new group has write permission on hosts; default is false
notRuleWrite	Optional	Boolean	Whether the new group has write permission on notification rules; default is false
adminWrite	Optional	Boolean	Whether the new group has write permission on ``admin: users and groups;'' default is false
diffWrite	Optional	Boolean	Whether the new group has write permission on comparisons; default is false
diffRun	Optional	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	Optional	UserArray	The new group users
pga	Optional	GroupArray	The new group parent groups
cga	Optional	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 14–4 Argument for the udb.g.del Command


Argument		Syntax	Description
ID	Required	GroupID	The group ID

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

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


Result	Syntax	Description
result	GroupArray	The groups

This command retrieves the specified group.

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


Argument/Result		Syntax	Description
ID	Required	GroupID	The group ID
result		Group	The group

This command lists the permissions granted to a group

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


Argument/Result		Syntax	Description
ID	Required	GroupID	The group ID
result		PermissionArray	The permissions

This command lists the members of the specified group

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


Argument/Result		Syntax	Description
ID	Required	GroupID	The group ID
result		UserArray	The users

This command modifies an existing group. Omitted arguments are overwritten.

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


Argument/Result		Syntax	Description
ID	Required	GroupID	The group ID
n	Optional	String	The new group name
d	Optional	String	The new group description
hostWrite	Optional	Boolean	Whether the new group has write permission on hosts
notRuleWrite	Optional	Boolean	Whether the new group has write permission on notification rules
adminWrite	Optional	Boolean	Whether the new group has write permission on ``admin: users and groups''
diffWrite	Optional	Boolean	Whether the new group has write permission on comparisons
diffRun	Optional	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	Optional	UserArray	The new group users
pga	Optional	GroupArray	The new group parent groups
cga	Optional	GroupArray	The new group child groups
result		Group	The modified group