.\" $Id: psk-crack.1,v 1.1.1.1 2005/01/13 18:44:53 mcr Exp $
.TH PSK-CRACK 1 "December 5, 2004"
.\" Please adjust this date whenever revising the manpage.
.SH NAME
psk-crack \- Crack IKE Aggressive Mode Pre-Shared Keys
.SH SYNOPSIS
.B psk-crack
.RI [ options ] " " < psk-parameters-file > " " [ < dictionary-file > ]
.PP
The
.B <psk-parameters-file>
argument specifies the file containing the pre-shared key parameters in colon separated hex format as generated by
.B ike-scan
with the
.B --pskcrack
option.
.PP
The
.B <dictionary-file>
argument is only required when
.B psk-crack
is operating in dictionary cracking mode (which is the default mode).  When
.B psk-crack
is operating in brute-force cracking mode, you do not need to specify a
dictionary file.
.SH DESCRIPTION
.B psk-crack
attempts to crack IKE Aggressive Mode pre-shared keys that have been previously
gathered using
.B ike-scan
with the
.B --pskcrack
option.
.PP
.B psk-crack
can operate in two different modes:
.IP 1)
Dictionary cracking mode: this is the default mode in which
.B psk-crack
tries each candidate word from the dictionary file in turn until it finds a
match, or all the words in the dictionary have been tried.
.IP 2)
Brute-force cracking mode: in this mode,
.B psk-crack
tries all possible combinations of a specified character set up to a given
length.
.SH OPTIONS
.TP
.B --help or -h
Display this usage message and exit.
.TP
.B --version or -V
Display program version and exit.
.TP
.B --verbose or -v
Display verbose progress messages.
.TP
.B --md5 or -m
Force MD5 hash type.
Normally this is not required because the hash type
is automatically determined from the hash length.
.TP
.B --sha1 or -s
Force SHA1 hash type.
Normally this is not required because the hash type
is automatically determined from the hash length.
.TP
.B --bruteforce=<n> or -B <n>
Select bruteforce cracking up to <n> characters.
.TP
.B --charset=<s> or -c <s>
Set bruteforce character set to <s>
Default is "0123456789abcdefghijklmnopqrstuvwxyz"
.SH AUTHOR
Roy Hills <Roy.Hills@nta-monitor.com>
