get_pam_apps

Use the get_pam_apps command to check Active Directory and return a Tcl list of plug-in authentication module (PAM) applications defined within the currently selected zone. If executed in a script, this command does not output its list to stdout, and no output appears in the shell where the script is executed. Use list_pam_apps to output the list of PAM applications to stdout.

You can only use the get_pam_apps command to return information about PAM applications if the currently selected zone is a classic4 or hierarchical zones. The command does not work for other types of zones.

Zone Type

Classic and hierarchical

Syntax

get_pam_apps

Abbreviation

gpam

Options

This command takes no options.

Arguments

This command takes no arguments.

Return Value

This command returns a Tcl list of PAM applications defined in the currently selected zone. Each element in the string is the name of a PAM application.

Examples

get_pam_apps

This example returns all of the PAM application rights for the selected zone:

dzssh-all dzssh-direct-tcpip dzssh-exec dzssh-scp dzssh-sftp dzssh-shell dzssh-subsystem dzssh-tcpip-forward dzssh-tunnel dzssh-x11-forwarding loginall ssh sshd

Before you use this command, you must have a currently selected zone stored in memory. After you have a zone stored in memory, you can use the following commands to view and select the PAM application to work with:

  • list_pam_apps lists to stdout the PAM application rights in the current zone.
  • new_pam_app creates a new PAM application right and stores it in memory.
  • select_pam_app retrieves a PAM application from Active Directory and stores it in memory.

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

  • delete_pam_app deletes the selected PAM application from Active Directory and from memory.
  • get_pam_field reads a field value from the currently selected PAM application.
  • save_pam_app saves the selected PAM application with its current settings to Active Directory.
  • set_pam_field sets a field value in the currently selected PAM application.