Skip site navigation (1)Skip section navigation (2)

  
 
  

home | help
HASHDIG-HARVEST(1)	      HashDig Documentation	      HASHDIG-HARVEST(1)

NAME
     hashdig-harvest.pl - Harvest hashes from a one or more input files

SYNOPSIS
     hashdig-harvest.pl [-a hash-type] [-c {K|U}] [-d delimiter] [-h hash-field]
     [-q] [-S sort-buffer-size] [-s sort-utility] [-T sort-temp-dir] -t
     file-type -o {file|-} file [file ...]

DESCRIPTION
     This utility extracts hashes of the specified hash-type from one or more
     input files having the specified file-type, tags them as known or unknown
     (see -c), and writes them to an output file (see -o) as a sorted list of
     hash/category pairs.  The resulting output file (a.k.a. hashdig or hd file)
     will have the following format:

	 hash|category

OPTIONS
     -a hash-type
	 Specifies the type of hashes that are to be harvested.  Currently, the
	 following hash types (or algorithms) are supported: 'MD5', 'SHA1', and
	 'SHA256'.  The default hash type is that specified by the HASH_TYPE en-
	 vironment variable or 'MD5' if HASH_TYPE is not set.  The value for
	 this option is not case sensitive.

     -c category
	 Specifies the category that is to be assigned to each hash.  Currently,
	 the following categories are supported: known (indicated by a 'K') and
	 unknown (indicated by a 'U').	The value for this option is not case
	 sensitive, and the default category is unknown (i.e., 'U').

     -d delimiter
	 Specifies the input field delimiter.  This option is ignored unless
	 used in conjunction with the 'GENERIC' data type.  Valid delimiters in-
	 clude the following characters: tab '\t', space ' ', comma ',',
	 semi-colon ';', and pipe '|'.	The default delimiter is a pipe.  Note
	 that parse errors are likely to occur if the specified delimiter ap-
	 pears in any of the field values.

     -h hash-field
	 Specifies the name of the field that contains the hash value.	This op-
	 tion is ignored unless used in conjunction with the 'GENERIC' data
	 type.	The default value for this option is 'hash'.

     -o {file|-}
	 Specifies the name of the output file.  A value of '-' will cause the
	 program to write to stdout.

     -q  Don't report errors (i.e., be quiet) while processing files.

     -S sort-buffer-size
	 Specifies the buffer size the sort utility should use for its main mem-
	 ory buffer.  This option is not passed to the sort utility unless spec-
	 ified as a command line argument.  Refer to the sort(1) man page for
	 details regarding this argument and its syntax.

     -s sort-utility
	 Specifies the name of an alternate sort utility.  If this argument is
	 specified as a relative path, the current PATH will be used to locate
	 the executable.  Note that this script was designed to work with GNU
	 sort(1).  Therefore, any alternate sort utility specified must support
	 the "-o", "-S", "-T" and "-u" options.

     -T sort-temp-dir
	 Specifies the directory the sort utility should use as a temporary work
	 area.	The default directory is that specified by the TMPDIR environ-
	 ment variable or /tmp if that variable is not set.

     -t file-type
	 Specifies the type of input file that will be processed.  Note that all
	 files processed in a single invocation must be of the same type.  Cur-
	 rently, the following types are supported: 'FTIMES', 'FTK', 'GENERIC',
	 'HK' or 'HASHKEEPER', 'KG' or 'KNOWNGOODS', 'MD5', 'MD5DEEP', 'MD5SUM',
	 'NSRL1', 'NSRL2', 'OPENSSL', 'PLAIN', 'RPM', 'SHA1', 'SHA1DEEP',
	 'SHA1SUM', 'SHA256', 'SHA256DEEP', and 'SHA256SUM'.  The value for this
	 option is not case sensitive.

AUTHOR
     Klayton Monroe

SEE ALSO
     ftimes(1), hashdig-make(1), md5(1), md5sum(1), md5deep(1), openssl(1),
     rpm(8), sha1(1), sha1sum(1), sha1deep(1), sort(1)

LICENSE
     All documentation and code are distributed under same terms and conditions
     as FTimes.

perl v5.42.3			   2026-08-27		      HASHDIG-HARVEST(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=hashdig-harvest&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help