lcg-gt(1) - Linux man page

Name

lcg-gt - get the TURL for a given SURL and transfer protocol

Synopsis

lcg-gt [ -h,--help ] [ --connect-timeout "timeout" ] [ --sendreceive-timeout "timeout" ] [ --bdii-timeout "timeout" ] [ --srm-timeout "timeout" ] [ -v,--verbose ] [ -D,--defaultsetypedefaulttype ] [ -T,--setype setype ] [ -b,--nobdii ] [ -s,--st " spacetokendesc" ] [ --version ] surl protocol [...]

Description

lcg-gt gets the TURL for a given SURL and transfer protocol. The program prints 1/2/3 lines on stdout depending on the SE type: turl, reqid and fileid. If you specify a given command line option multiple times, the command takes into account only the very last one so that in a script, you can override a particular option in a pre-set option set (like gcc does).

Classic SE
turl
SRMv1
turl, reqid, fileid
SRMv2
turl,
reqtoken

reqid/fileid or reqtoken are needed to set the file state to "Running" or "Done" in the Storage Resource Manager.

--connect-timeout: Sets the connect timeout, used when connecting to a remote host. The connection will be aborted if the remote host doesn't reply after value seconds. Default: 60 seconds.
--sendreceive-timeout: Sets the send/receive data timeout, used when transferring data to/from a remote host. The connection will be aborted if no data is transfered after value seconds. Default: 0 (blocking).
--bdii-timeout: Sets the BDII timeout, used when searching information into BDII. The connection will be aborted if the search is longer than value seconds. Default: 60 seconds.
--srm-timeout: Sets the SRM timeout, used when doing an asynchronous SRM request. The request will be aborted if it is still queued after value seconds. Default: 3600 seconds (1 hour).
surl: specifies the Site URL. An SURL scheme can be sfn: for a classical SE or srm:.
defaulttype: specifies the default SE type you want to use. Possible values are none, se, srmv1, srmv2, for respectively no default type, classic SE, SRMv1, and SRMv2. But if according to the BDII the default type is not available for this SE, it will use another type.
setype: specifies the SE type you want to use. Possible values are none, se, srmv1, srmv2, for respectively no type, classic SE, SRMv1, and SRMv2. But if according to the BDII the default type is not available for this SE, it will fail.
protocol: specifies an ordered list of protocols to access the file. The first protocol which is supported by the SE will be used.
spacetokendesc: specifies the space token to use with src_file
-b,--nobdii: If this flag is present, it means that you don't want to make BDII calls to get SE type. So, you must provide the type of the SE for srm: arguments, and full endpoint in SURLs. For SE type, defaulttype can be used.
-v,--verbose: Verbose mode. You can specify it twice for extra verbose mode.

Note

The environment variable LCG_GFAL_INFOSYS must point to the BDII, unless --nobdii option is used.

Example

    lcg-gt srm://lxshare0303.cern.ch:8443/castor/cern.ch/home/dteam/test rfio
    rfio://lxshare0303.cern.ch//data/dt/stage/test.2415
    939325759
    0

Exit Status

This program returns 0 if the operation was successful or >0 if the operation failed.

Referenced By

lcg-bringonline(1), lcg-get-checksum(1)