List

If no options are specified, then all the policy groups in the policy group repository are listed. If two storage back ends have been specified, then all the policy groups in the policy group repository of the user back end storage are listed. Depending on the options specified, list can also list all policy groups assigned to an entity, or the entities that use a particular policy group. When a policy group is listed, details such as name, scope, priority, and entity, if appropriate, are also listed. Entities are listed by their distinguished names.

Syntax

list [--username=<name>] [--scope=<user/host>] [--entity=<entity name>][--name =<policy group name>]

--username=<name> : the username of the administrator in the format used by the configuration repository, for example “jmonroe”.

--scope=<user/host> : if this option alone is specified then all the policy groups of the specified scope from the policy group repository is listed. If not specified then defaults to the user scope. If used with the -entity option, then all the policy groups of this scope assigned to the entity are listed. If used with the -name option, then all the entities that use the specified policy group of the specified scope are listed.

--entity=<entity name> : lists the policy groups that are assigned to an entity.

--name=<policy group name> : lists the entities that use the specified policy group.

Example 3–6 Listing policy groups in the repository

% pgtool list --username=jmonroe

Lists global policy groups for administrator “jmonroe”.

% pgtool list --username=jmonroe --name=UserPolicyGroup1

Lists entities using policy group “UserPolicyGroup1”.