HASHVERIFY Command


HSI Version:

4.0.1.1 and higher

Purpose:

Verify checksum hash for existing HPSS file(s)

Verification is performed by reading the files from HPSS, recreating the checksum hash, and comparing it with the checksum hash stored in HPSS metadata.

Aliases:

None

Command Format:

hashver[ify] [-A] [-C] [-F on|off] [-H type, ] [-h] [-N] [-S] [-T on|off ] [-Y style ] path … [<<MARKER]...

Options:

-A : enable auto-scheduling of retrievals.

-C: cache purge option. If specified, purge files from HPSS disk cache after a successful hash create. Normally used only when it's expected that files will only be fetched once (or infrequently), to help optimize disk cache use

-F on|off explicitly use or disable Local File Mover I/O, overriding the settings based upon file size and the global enable/disable flag from the hsirc file

-H type set case-insensitive checksum hash type (none,sha1,sha224,sha256,sha384 sha512, md5, crc32, adler32 (overrides hsirc and compile time options)

-h: symlink option. If specified, ignores HPSS symlink. If not set, reads through HPSS symlinks when reading files.

-N: disable auto-scheduling of retrievals (inverse of option -A). The normal default is to enable auto-scheduling in order to optimize tape mounts and tape positioning.

-R : [standard option]recursively create hash entries for files in the specified HPSS path(s)

-S : disable staging of the source file (attempts to read directly from tape)

-T on|off [future] explicitly use or disable Transfer Agent I/O.

-Y style checksum hashing style(s). Valid styles are either "hsi" (default), "vfs", or "hpsssum". VFS and HPSSSUM checksum styles are deprecated, and will not be supported in a future release. The "hashlist" command or one of its aliases can be used to determine the type(s) of checksum hashes stored in HPSS metadata, for example:

        hashls -hvs someFile

-MARKER provides sh-style "here"document syntax for specifying filenames. Lines following the MARKER, which must be the last token on the line, contain pathname (which may include wildcards). The list is terminated by a line containing MARKER as the first token on the line.
See the examples below.

Keywords:

none

Usage Notes:

  • The -A option is usually the default, but may be disabled in the hsirc file
  • The HPSS Transfer Agent does not currently support checksum hashes

Examples

  1. Verify the checksum hashes for all " .ksh " files in the current directory
    hashverify *.ksh
  2. Verify checksums for the files F1 - F5 using HERE-document syntax. Free up disk cache entries after the files have been verified.
        hashver -C << EOF
        F1 F2 F3
        F4
        F5
        EOF
    

Related Commands

hashconvert hashcreate, hashdelete hashlist

-c option for put and get commands