NAME

       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)