NAME

       findproxyfile - returns full path to GSI Proxy file

SYNOPSIS

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

DESCRIPTION

       findproxyfile  returns full path to a GSI Proxy file, either in the proxy cache maintained
       by the GridSite G-HTTPS and delegation portType functions, or in other standard places.

       If a User DN is given findproxyfile uses the  value  of  the  --proxycache  argument,  the
       GRST_PROXY_PATH  or  the  compile time default to detemine the location of the proxy cache
       directory.  The directory is searched for a proxy having the given User DN and  Delegation
       ID. (If no Delegation ID is specificed, then the default value is used.)

       If  findproxyfile  does  not find a proxy or if a User DN is not given, but --outsidecache
       was given, then  the  environment  variable  X509_USER_PROXY  and  the  standard  location
       /tmp/x509up_uUID are searched as well.

OPTIONS

       --proxycache=PATH
              Give  the  path of the proxy cache directory explicitly, overriding the default and
              the GRST_PROXY_PATH environment variable if present.

       --delegation-id=ID
              The optional delegation ID is search for in the proxy cache in addition to the User
              DN. If absent, the default Delegation ID value is searched for.

       --user-dn=DN
              The DN of the full user certificate associated with the proxy to be searched for in
              the proxy cache. (This is not the DN of any proxy earlier in the chain: it is a the
              DN of a certificate issued by a recognised CA.)

       --outsidecache
              If  a  User  DN  is not given, or a proxy not found in the cache, then search for a
              proxy  using  X509_USER_PROXY  environment  variable  and   file   name   of   form
              /tmp/x509up_uUID as well.

RETURN VALUE

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

EXIT CODES

       0 is returned on succcess. Non-zero otherwise.

BUGS

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

AUTHOR

       Andrew McNab <Andrew.McNab@man.ac.uk>

       findproxyfile is part of GridSite: http://www.gridsite.org/