Name

myproxy-admin-query — Query repository contents

Synopsis

myproxy-admin-query

Tool description

The myproxy-admin-query command displays information about the credentials stored in the MyProxy repository. It can also be used to remove credentials from the repository. It accesses the repository directly and must be run on the machine where the myproxy-server is installed from the account that owns the repository.

Command syntax

myproxy-admin-query [ options ]

Command options

Table 13. myproxy-admin-query options

-h, --help Displays command usage text and exits.
-u, --usage Displays command usage text and exits.
-v, --verbose Enables verbose debugging output to the terminal.
-V, --version Displays version information and exits.
-l name, --username name Returns information on credentials for a single username. By default, the command returns information on all credentials for all usernames.
-k name, --credname name Returns information on the credentials with the specified name.
-e hours, --expiring_in hours Returns information on credentials with remaining lifetime less than the specified number of hours. For example, -e 0 will return all expired credentials.
-t hours, --time_left hours Returns information on credentials with remaining lifetime greater than the specified number of hours.
-s dir, --storage dir Specifies the location of the credential storage directory. The directory must be accessible only by the user running the myproxy-server process for security reasons. Default: /var/myproxy or $GLOBUS_LOCATION/var/myproxy.
-r, --remove Remove the credentials matching the query from the repository. For example, myproxy-admin-query -e 0 -r will remove all expired credentials from the repository.
-L 'msg', --lock 'msg' Places the credentials matching the query under an administrative lock and specifies a message to be returned on access attempts. Be sure to put the message in quotes so it is captured as one argument to the command.
-U, --unlock Removes any administrative locks for the credentials matching the query.