myproxy-admin-query man page

myproxy-admin-query — query MyProxy repository contents

Synopsis

myproxy-admin-query [ options ]

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, by combining query options with --remove. It accesses the repository directly and must be run on the machine where the myproxy-server(8) is installed from the account that owns the repository.

An example cron job for running myproxy-admin-query periodically to remove invalid (expired, revoked, etc.) credentials from the repository is provided at $GLOBUS_LOCATION/share/myproxy/myproxy.cron.

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 username, --username username

Return information on credentials for a single username.  By default, the command returns information on all credentials for all usernames.

-k name, --credname name

Return information on the credentials with the specified name.

-o DN, --owner DN

Return information on the credentials owned by the specified distinguished name.

-e hours, --expiring_in hours

Return 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

Return information on credentials with remaining lifetime greater than the specified number of hours.

-i, --invalid

Return information on invalid (expired, revoked, etc.) credentials.

-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/lib/myproxy or /var/myproxy or $GLOBUS_LOCATION/var/myproxy

-c file, --config file

Specifies the location of the myproxy-server configuration file, for OCSP options. Default: /etc/myproxy-server.config or $GLOBUS_LOCATION/etc/myproxy-server.config

-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.

Exit Status

0 on success, >0 on error

Authors

See http://grid.ncsa.illinois.edu/myproxy/about for the list of MyProxy authors.

See Also

myproxy-change-pass-phrase(1), myproxy-destroy(1), myproxy-init(1), myproxy-logon(1), myproxy-retrieve(1), myproxy-store(1), myproxy-server.config(5), myproxy-admin-adduser(8), myproxy-admin-change-pass(8), myproxy-admin-load-credential(8), myproxy-server(8)

Referenced By

myproxy-admin-adduser(8), myproxy-admin-change-pass(8), myproxy-admin-load-credential(8), myproxy-change-pass-phrase(1), myproxy-destroy(1), myproxy-info(1), myproxy-init(1), myproxy-logon(1), myproxy-retrieve(1), myproxy-server(8), myproxy-server.config(5), myproxy-store(1).

2011-09-19 MyProxy