get_role_apps

Use the get_role_apps command to return a Tcl list of PAM application rights associated with the currently selected role.

The get_role_apps command does not query Active Directory for the role. If you change the PAM applications associated with the current role using ADEdit without saving the role to Active Directory, the PAM applications you retrieve using get_role_apps won’t match the same PAM applications for the role as stored in Active Directory.

You can only use the get_role_apps command if the currently selected zone is a classic4 or hierarchical zone. The command does not work in other types of zones.

Zone type

Classic and hierarchical

Syntax

get_role_apps

Abbreviation

grap

Options

This command takes no options.

Arguments

This command takes no arguments.

Return value

This command returns a Tcl list of PAM applications associated with the currently selected role. Each PAM application in the list shows the application name followed by a slash (/) and the zone in which the PAM application is defined.

Examples

get_role_apps

This example returns the list of PAM applications for the currently selected role: ftp/cz1

Related commands

Before you use this command, you must have a currently selected role stored in memory. The following commands to view and select the role to work with:

  • get_roles returns a Tcl list of roles in the currently selected zone.
  • list_roles lists to stdout the roles in the currently selected zone.
  • new_role creates a new role and stores it in memory.
  • select_role retrieves a role from Active Directory and stores it in memory.

After you have a role stored in memory, you can use the following commands to work with that role’s attributes, delete the role, or save information for the role:

  • add_command_to_role adds a UNIX command to the currently selected role.
  • add_pamapp_to_role adds a PAM application to the currently selected role.
  • delete_role deletes the selected role from Active Directory and from memory.
  • get_role_commands returns a Tcl list of the UNIX commands associated with the currently selected role.
  • get_role_field reads a field value from the currently selected role.
  • list_role_rights returns a list of all UNIX commands and PAM applications associated with the currently selected role.
  • remove_command_from_role removes a UNIX command from the currently selected role.
  • remove_pamapp_from_role removes a PAM application from the currently selected role.
  • save_role saves the selected role with its current settings to Active Directory.
  • set_role_field sets a field value in the currently selected role.