1findproxyfile(1)                GridSite Manual               findproxyfile(1)
2
3
4

NAME

6       findproxyfile - returns full path to GSI Proxy file
7

SYNOPSIS

9       findproxyfile  [--proxycache=PATH]  [--delegation-id=ID] [--user-dn=DN]
10       [--outsidecache]
11

DESCRIPTION

13       findproxyfile returns full path to a GSI  Proxy  file,  either  in  the
14       proxy  cache maintained by the GridSite G-HTTPS and delegation portType
15       functions, or in other standard places.
16
17       If a User DN is given findproxyfile uses the value of the  --proxycache
18       argument,  the  GRST_PROXY_PATH or the compile time default to detemine
19       the location of the proxy cache directory.  The directory  is  searched
20       for  a proxy having the given User DN and Delegation ID. (If no Delega‐
21       tion ID is specificed, then the default value is used.)
22
23       If findproxyfile does not find a proxy or if a User DN  is  not  given,
24       but   --outsidecache   was   given,   then   the  environment  variable
25       X509_USER_PROXY and the standard location /tmp/x509up_uUID are searched
26       as well.
27
28

OPTIONS

30       --proxycache=PATH
31              Give  the path of the proxy cache directory explicitly, overrid‐
32              ing the default and the GRST_PROXY_PATH environment variable  if
33              present.
34
35
36       --delegation-id=ID
37              The  optional  delegation ID is search for in the proxy cache in
38              addition to the User DN. If absent, the  default  Delegation  ID
39              value is searched for.
40
41
42       --user-dn=DN
43              The DN of the full user certificate associated with the proxy to
44              be searched for in the proxy cache. (This is not the DN  of  any
45              proxy  earlier  in  the  chain:  it is a the DN of a certificate
46              issued by a recognised CA.)
47
48
49       --outsidecache
50              If a User DN is not given, or a proxy not found  in  the  cache,
51              then  search for a proxy using X509_USER_PROXY environment vari‐
52              able and file name of form /tmp/x509up_uUID as well.
53
54

RETURN VALUE

56       If a proxy is found, its full path is output on standard out.
57
58

EXIT CODES

60       0 is returned on succcess. Non-zero otherwise.
61
62

BUGS

64       In this version, no attempt is made to verify or validate the proxies.
65
66

AUTHOR

68       Andrew McNab <Andrew.McNab@man.ac.uk>
69
70       findproxyfile is part of GridSite: http://www.gridsite.org/
71
72
73
74findproxyfile                    October 2004                 findproxyfile(1)
Impressum