NAME

hashdig-resolve-sunsolve.pl - Resolve hashes against Sun's Solaris Fingerprint Database

SYNOPSIS

hashdig-resolve-sunsolve.pl [-a] [-c count] [-d dir] [-k count] [-w count] [-r block] [-s count] -f {file|-}

DESCRIPTION

This utility resolves a list of hashes against Sun's Solaris Fingerprint Database. Input is expected to be plain text with one hash per line. Each line must match the following regular expression:

    ^([0-9a-fA-F]{32})(?:\|[KU])?$

Input that does not match this expression will cause the program to generate a warning. When the warning limit (see -w option) has been exceeded, the program will abort.

Output for each block of hashes is written to a pair of files in dir. These files have the following naming convention:

    hashdig-{getblock,sunsolve}.dddddd

where 'dddddd' is a decimal number that represents the request ID. The first file, hashdig-getblock.dddddd, contains the list of hashes submitted. The second file, hashdig-sunsolve.dddddd, contains the raw HTML output returned by Sun's website.

OPTIONS

-a: Enables auto-recover mode. Individual requests can fail from time to time, or the job may have been aborted or killed prior to completion. This option allows you to continue the resolution process where the last job left off. Along the way, it'll redo any getblocks that produced no output. The original output dir must exist, and be specified if not the default value. More importantly, the original input must be used for this mode to work as intended.
-c count: Specifies the number of hashes to include in each request. The default value is 256, which is the maximum number allowed by Sun.
Note: If you intend to use the -a option, you must use the same count as was specified in the original job.
-d dir: Specifies the name of the output directory. By default the output directory is called sunsolve. If the output directory exists, the program will abort.
-f {file|-}: Specifies the name of the input file. A value of '-' will cause the program to read from stdin.
-k count: Specifies the number of simultaneous kid processes to create -- one kid per request. The default value is 5.
-r block: Specifies a particular request ID to redo. Individual requests can fail from time to time; this option allows you to selectively redo those requests as necessary. The original output dir must exist, and be specified if not the default value. The file argument should be the name of the original getblock file or '-' for stdin. However, no more than 256 valid records from the specified file will be processed. Output will be written to the original sunsolve file whether it exists or not. A corresponding getblock file will be created only if it doesn't exist.
-s count: Specifies the number of seconds to wait between subsequent requests. The default value is 0, which means do not wait.
-w count: Specifies the number of warnings that will be tolerated before the program aborts. The default value is 1. If this option is set to 0, no limit will be imposed.

BUGS

Under certain conditions (e.g., slow link, killed TCP sessions, too many kid processes, etc.), requests can fail without generating an error message. In these situations, output from the affected request is often invalid or incomplete. Currently, there is no mechanism to detect whether or not such is the case.

AUTHOR

Klayton Monroe

LICENSE

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