lcg-get-checksum(1) - Linux man page

Name

lcg-get-checksum - Get/compute checksum value of given files

Synopsis

lcg-get-checksum [ -h,--help ] [ --force ] [ --checksum-type cksmtype ] [ -D,--defaultsetype defaulttype ] [ -T,--setype setype ] [ -s,--se se ] [ --connect-timeout conntimeout ] [ --sendreceive-timeoutsndtimeout ] [ --bdii-timeout bdiitimeout ] [ --srm-timeout srmtimeout ] [ --vovirtual_organization ] [ -b,--nobdii ] [ -l,--nolfc ] [ -v,--verbose ] [ --version ] ( -f,--file localfile | gridfile [...] )

Description

lcg-get-checksum gets, or compute the checksum value of given files. 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).

gridfile: specifies a Logical File Name, a Grid Unique IDentifier or a Site URL. An SURL scheme can be sfn: for a classical SE or srm:.
localfile: specifies a local file in which there is the list of SURLs. cksmtype is the checksum type (algorithm) to use. Possible values (case insensitive) are:
CRC32: CRC32 algorithm will be used
ADLER32: Adler32 algorithm will be used (default value)
MD5: MD5 algorithm will be used
SHA1

SHA-1 algorithm will be used

se: Only the replica residing on se is deleted.
vo: specifies the Virtual Organization the user belongs to. If it is not specified, the environment variable LCG_GFAL_VO will be used.
force: This option forces the computation of checksum value (gridftp for SURL, local computation for local files), instead of getting it through srmLs when it is available. Note that some SEs support checksum through srmLs only, so this option may make the command fail in this case.
conntimeout: Sets the connect timeout, used when connecting to a remote host. The connection will be aborted if the remote host doesn't reply after conntimeout seconds. Default: 60 seconds.
sndtimeout: 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 sndtimeout seconds. Default: 0 (blocking).
bdiitimeout: Sets the BDII timeout, used when searching information into BDII. The connection will be aborted if the search is longer than bdiitimeout seconds. Default: 60 seconds.
srmtimeout: Sets the SRM timeout, used when doing an asynchronous SRM request. The request will be aborted if it is still queued after srmtimeout seconds. Default: 3600 seconds (1 hour).
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 file. 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.
-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.

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-get-checksum --checksum-type md5 -bD srmv2 srm://lxb8002.cern.ch:8446/srm/managerv2?SFN=/dpm/cern.ch/home/dteam/remi.test
    3be0a491142e566d7f624624222c1518    srm://lxb8002.cern.ch:8446/srm/managerv2?SFN=/dpm/cern.ch/home/dteam/remi.test
    $ lcg-get-checksum file:/etc/issue
    c3581070    file:/etc/issue

Exit Status

This program returns 0 if the operation was successful or the number of files which failed.