XCHK

Synopsis

HELP:   Extended data validation
TYPE:   OBJECT
SYNTAX: > flcl XCHK(INPUT(),DIR(),LOG())

Description

The XCHK command can be used, for example, to analyze local or remote files or members inside local or remote archives of various formats (without unpacking to a temporary file), generate their hash values, etc.

For example, you can generate or verify hash values before or after any conversion, i.e. after decoding, decryption, decompression or character conversion.

The XCHK command was designed to provide the full capacity of the powerful Frankenstein Limes Universal Converter (FLUC) without the write overhead. It supports all parameters of XCNV INPUT.

To get syntax information, please use:

   flcl SYNTAX XCHK

To get help for the parameters, please use:

   flcl HELP XCHK.parameter[.parameter[...]]

To read the manual page for a parameter, please use:

   flcl MANPAGE XCHK.parameter[.parameter[...]]
      or
   flcl HELP XCHK.parameter[.parameter[...]] MAN

To generate the user manual for the command, please use:

   flcl GENDOCU XCHK=filename

Parameters can be defined via command line (directly or per file) or through properties read from the corresponding property file.

Examples

Reads remote file "xzfile.xz" and calculates the checksum using the default hash algorithm.

   flcl xchk "input(sav.file(fio.blk(name=ssh://<cuser>@server1/xzfile.xz)
                               cnv.hsh() ))"

Reads local file "xzfile.xz", decompresses it and calculates the checksum using the default hash algorithm.

   flcl xchk "input(sav.file(fio.blk(name=xzfile.xz)
                               cnv.lxz()
                               cnv.hsh() ))"

Reads remote file "xzfile.xz", calculate the checksum using the SHA-1 hash algorithm, decompresses the file and calculates the checksum of the decompressed data using the MD5 hash algorithm.

   flcl xchk "input(sav.file(fio.blk(name=ssh://<cuser>@server1/xzfile.xz)
                               cnv.hsh(algo=SHA1)
                               cnv.lxz()
                               cnv.hsh(algo=MD5)))"

A simplified command for hash calculation and verification is available under the name 'HASH'.