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

FreeBSD Manual Pages

  
 
  

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 environment 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
	   include 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 appears in	any of the field values.

       -h hash-field
	   Specifies the name of the field that	contains the hash value.  This
	   option 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
	   memory buffer.  This	option is not passed to	the sort utility
	   unless specified 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
	   environment 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.  Currently, 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.0			  2025-11-01		    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.0>

home | help