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

  
 
  

home | help
HASHDIG-RESOLVE-SUNSOLVE(1)   HashDig Documentation  HASHDIG-RESOLVE-SUNSOLVE(1)

NAME
     hashdig-resolve-sunsolve.pl - Resolve hashes against Sun's Solaris Finger-
     print 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 gener-
     ate 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 re-
     turned 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 pro-
	 duced 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 di-
	 rectory 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 re-
	 quests as necessary. The original output dir must exist, and be speci-
	 fied 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 cor-
	 responding 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 pro-
	 gram 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 mes-
     sage. In these situations, output from the affected request is often in-
     valid or incomplete. Currently, there is no mechanism to detect whether or
     not such is the case.

AUTHOR
     Klayton Monroe

SEE ALSO
     hashdig-dump(1), hashdig-harvest-sunsolve(1)

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

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

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

home | help