lcg-rf(1) - Linux man page

Name

lcg-rf - register in the LRC (and optionally in the RMC) a file

residing on an SE

Synopsis

lcg-rf [ --config config_file ] [ -g guid ] [ -h,--help ] [ -l lfn ] [ -D,--defaultsetype defaulttype ] [ -T,--setype setype ] [ -b,--nobdii ] [ -v,--verbose ] [ --connect-timeout "timeout" ] [ --sendreceive-timeout "timeout" ] [ --bdii-timeout "timeout" ] [ --srm-timeout "timeout" ] [ --vo virtual_organization ] [ --version ] surl

Description

lcg-rf registers in the LRC (and optionally in the RMC) or the LFC a file residing on an SE. The program prints the actual GUID on stdout. 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).

surl: specifies the site URL of the file to be registered. The scheme can be sfn: for a classical SE or srm:.
guid: specifies the Grid Unique IDentifier. If this option is not present, a GUID is generated internally.
lfn: specifies the Logical File Name associated with the file. If this option is present, an entry is added to the Replica Metadata Catalog or the LFC.
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 for the SURL. 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.
vo: specifies the Virtual Organization the user belongs to. If it is not specified, the environment variable LCG_GFAL_VO will be used.
--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).
conf_file: This argument is currently ignored.
-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 (it will be used for both source and destination).
-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. To use the RLS as catalog instead of the LFC, the environment variable LCG_CATALOG_TYPE must explicitely be set to "edg". By default, it is set to "lfc".

Example

    lcg-rf --vo dteam \
        srm://lxshare0282.cern.ch//pnfs/cern.ch/data/dteam/testjpb16
    guid:4fd28653-b076-4336-811e-7d5a553e0d7f

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)