NAME

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

SYNOPSIS

hashdig-resolve-sunsolve.pl [-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}$

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 256 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

-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

SEE ALSO

hashdig-dump.pl, hashdig-harvest-sunsolve.pl

LICENSE

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