1myproxy-admin-query(8)              MyProxy             myproxy-admin-query(8)
2
3
4

NAME

6       myproxy-admin-query - query MyProxy repository contents
7

SYNOPSIS

9       myproxy-admin-query [ options ]
10

DESCRIPTION

12       The  myproxy-admin-query command displays information about the creden‐
13       tials stored in the MyProxy repository.  It can also be used to  remove
14       credentials  from  the  repository,  by  combining  query  options with
15       --remove.  It accesses the repository directly and must be run  on  the
16       machine  where the myproxy-server(8) is installed from the account that
17       owns the repository.
18
19       An example cron job for  running  myproxy-admin-query  periodically  to
20       remove invalid (expired, revoked, etc.) credentials from the repository
21       is provided at $GLOBUS_LOCATION/share/myproxy/myproxy.cron.
22

OPTIONS

24       -h, --help
25              Displays command usage text and exits.
26
27       -u, --usage
28              Displays command usage text and exits.
29
30       -v, --verbose
31              Enables verbose debugging output to the terminal.
32
33       -V, --version
34              Displays version information and exits.
35
36       -l username, --username username
37              Return information on credentials for  a  single  username.   By
38              default,  the command returns information on all credentials for
39              all usernames.
40
41       -k name, --credname name
42              Return information on the credentials with the specified name.
43
44       -o DN, --owner DN
45              Return information on the credentials  owned  by  the  specified
46              distinguished name.
47
48       -e hours, --expiring_in hours
49              Return  information  on credentials with remaining lifetime less
50              than the specified number of hours.   For  example,  -e  0  will
51              return all expired credentials.
52
53       -t hours, --time_left hours
54              Return   information  on  credentials  with  remaining  lifetime
55              greater than the specified number of hours.
56
57       -i, --invalid
58              Return information on invalid (expired, revoked,  etc.)  creden‐
59              tials.
60
61       -s dir, --storage dir
62              Specifies the location of the credential storage directory.  The
63              directory must be  accessible  only  by  the  user  running  the
64              myproxy-server   process   for   security   reasons.    Default:
65              /var/lib/myproxy or /var/myproxy or $GLOBUS_LOCATION/var/myproxy
66
67       -c file, --config file
68              Specifies the location of the myproxy-server configuration file,
69              for   OCSP   options.   Default:  /etc/myproxy-server.config  or
70              $GLOBUS_LOCATION/etc/myproxy-server.config
71
72       -r, --remove
73              Remove the credentials matching the query from  the  repository.
74              For example, myproxy-admin-query -e 0 -r will remove all expired
75              credentials from the repository.
76
77       -L 'msg', --lock 'msg'
78              Places the credentials matching the query under  an  administra‐
79              tive  lock  and  specifies  a  message  to be returned on access
80              attempts.  Be sure to put the message in quotes so  it  is  cap‐
81              tured as one argument to the command.
82
83       -U, --unlock
84              Removes  any  administrative  locks for the credentials matching
85              the query.
86

EXIT STATUS

88       0 on success, >0 on error
89

AUTHORS

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

SEE ALSO

95       myproxy-change-pass-phrase(1),   myproxy-destroy(1),   myproxy-init(1),
96       myproxy-logon(1),   myproxy-retrieve(1),   myproxy-store(1),   myproxy-
97       server.config(5),    myproxy-admin-adduser(8),    myproxy-admin-change-
98       pass(8), myproxy-admin-load-credential(8), myproxy-server(8)
99
100
101
102MyProxy                           2011-09-19            myproxy-admin-query(8)
Impressum