[Python-apps-commits] r6786 - in packages/pyrit/trunk/debian (pyrit.1)
chrisk-guest at users.alioth.debian.org
chrisk-guest at users.alioth.debian.org
Sat Mar 19 22:37:38 UTC 2011
Date: Saturday, March 19, 2011 @ 22:37:37
Author: chrisk-guest
Revision: 6786
Escape minus-hyphon in options + fix typos in man page
Modified:
packages/pyrit/trunk/debian/pyrit.1
Modified: packages/pyrit/trunk/debian/pyrit.1
===================================================================
--- packages/pyrit/trunk/debian/pyrit.1 2011-03-19 22:36:19 UTC (rev 6785)
+++ packages/pyrit/trunk/debian/pyrit.1 2011-03-19 22:37:37 UTC (rev 6786)
@@ -1,4 +1,4 @@
-.TH PYRIT 1 "2011-02-26" "pyrit" PYRIT
+.TH PYRIT 1 "2011-03-18" "pyrit" PYRIT
.SH NAME
pyrit \- A GPGPU-driven WPA/WPA2-PSK key cracker
.SH SYNOPSIS
@@ -63,20 +63,20 @@
configuration file (see \fBFILES\fP below).
.RE
.TP
-.BR \-\-all-handshakes
+.BR \-\-all\-handshakes
The commands \fBattack_batch\fP, \fBattack_db\fP, \fBattack_cowpatty\fP and
\fBattack_passthrough\fP automatically use the single handshake of highest quality
only. In some cases even this handshake may have been wrongfully
reconstructed from the captured data, rendering the attack futile. In case more
than one EAPOL-handshake is reconstructed from the capture-file, the option
-\fB--all-handshakes\fP may be used to attack all handshakes reconstructable
+\fB\-\-all\-handshakes\fP may be used to attack all handshakes reconstructable
from the captured data. Exact behaviour of the commands affected by this option
is described below.
.SH COMMANDS
.TP
.B analyze
Parse one or more packet-capture files (in pcap-format, possibly
-gzip-compressed) given by the option \fB-r\fP and try to detect
+gzip-compressed) given by the option \fB\-r\fP and try to detect
Access-Points, Stations and EAPOL-handshakes. For example:
.sp
.RS 12
@@ -109,10 +109,10 @@
.TP
.B attack_batch
Attack an EAPOL-handshake found in the packet-capture file(s) given by the
-option \fB-r\fP using the Pairwise Master Keys and passwords stored in the
-database. The options \fB-b\fP and \fB-e\fP can be used to specify the
+option \fB\-r\fP using the Pairwise Master Keys and passwords stored in the
+database. The options \fB\-b\fP and \fB\-e\fP can be used to specify the
Access-Point to attack; it is picked automatically if both options are omitted.
-The password is written to the filename given by the option \fB-o\fP if
+The password is written to the filename given by the option \fB\-o\fP if
specified. For example:
.sp
.RS 12
@@ -129,17 +129,17 @@
ESSIDs are created automatically in the database if necessary.
Pyrit works down the list of reconstructed EAPOL-handshakes in case the option
-\fB--all-handshakes\fP is supplied.
+\fB\-\-all\-handshakes\fP is supplied.
.RE
.TP
.B attack_cowpatty
Attack an EAPOL-handshake found in the packet-capture file(s) given by the
-option \fB-r\fP using Pairwise Master Keys from a cowpatty-like file (e.g.
+option \fB\-r\fP using Pairwise Master Keys from a cowpatty-like file (e.g.
generated by \`\`genpmk'' from cowpatty, or \fBexport_cowpatty\fP
-below) given by the option \fB-f\fP. The options
-\fB-b\fP and \fB-e\fP can be used to specify the Access-Point to attack;
+below) given by the option \fB\-f\fP. The options
+\fB\-b\fP and \fB\-e\fP can be used to specify the Access-Point to attack;
it is picked automatically if both options are omitted. The password is
-written to the filename given by the option \fB-o\fP if specified.
+written to the filename given by the option \fB\-o\fP if specified.
The cowpatty-file may be gzip-compressed and must match the chosen ESSID.
For example:
.sp
@@ -154,16 +154,16 @@
Pyrit's own database is not touched by \fBattack_cowpatty\fP.
Pyrit attacks all EAPOL-handshakes at the same time if the option
-\fB--all-handshakes\fP is supplied. This will reduce througput (e.g.: 33% throughout
+\fB\-\-all\-handshakes\fP is supplied. This will reduce througput (e.g.: 33% throughout
in case of three handshakes).
.RE
.TP
.B attack_db
Attack an EAPOL-handshake found in the packet-capture file(s) given by the
-option \fB-r\fP using the Pairwise Master Keys stored in the database. The
-options \fB-b\fP and \fB-e\fP can be used to specify the Access-Point to
+option \fB\-r\fP using the Pairwise Master Keys stored in the database. The
+options \fB\-b\fP and \fB\-e\fP can be used to specify the Access-Point to
attack; it is picked automatically if both options are omitted.
-The password is written to the filename given by the option \fB-o\fP if
+The password is written to the filename given by the option \fB\-o\fP if
specified. For example:
.sp
.RS 12
@@ -177,15 +177,15 @@
the database are used by \fBattack_db\fP.
Pyrit works down the list of reconstructed EAPOL-handshakes in case the option
-\fB--all-handshakes\fP is supplied.
+\fB\-\-all\-handshakes\fP is supplied.
.RE
.TP
.B attack_passthrough
Attack an EAPOL-handshake found in the packet-capture file(s) given by the option
-\fB-r\fP using the passwords read from the file given by the option \fB-i\fP.
-The options \fB-b\fP and \fB-e\fP can be used to specify the Access-Point to
+\fB\-r\fP using the passwords read from the file given by the option \fB\-i\fP.
+The options \fB\-b\fP and \fB\-e\fP can be used to specify the Access-Point to
attack; it is picked automatically if both options are omitted. The password is
-written to the filename given by the option \fB-o\fP if specified. For example:
+written to the filename given by the option \fB\-o\fP if specified. For example:
.sp
.RS 12
.nf
@@ -200,14 +200,14 @@
\fBattack_batch\fP otherwise.
Pyrit attacks all EAPOL-handshakes at the same time if the option
-\fB--all-handshakes\fP is supplied.
+\fB\-\-all\-handshakes\fP is supplied.
.RE
.TP
.B batch
.br
Start to translate all passwords in the database into their respective Pairwise
Master Keys and
-store the results in the database. The option \fB-e\fP may be used to restrict
+store the results in the database. The option \fB\-e\fP may be used to restrict
this command to a single ESSID; if it is omitted, all ESSIDs are processed one
after the other in undefined order. For example:
.sp
@@ -218,9 +218,9 @@
.RE
.sp
.RS
-The option \fB-o\fP can be used to specify a filename the results should
+The option \fB\-o\fP can be used to specify a filename the results should
additionally be written to in cowpatty's binary format. The option
-\fB-e\fP becomes mandatory and the ESSID is automatically created in the
+\fB\-e\fP becomes mandatory and the ESSID is automatically created in the
database if necessary. Pairwise Master Keys that previously have been computed
and stored in the database are exported from there without further processing.
Pyrit stops and exits if an \fBIOError\fP is raised while writing to the
@@ -258,9 +258,9 @@
.RE
.TP
.B create_essid
-Add new ESSIDs to the database. A single ESSID may be given by the option \fB-e\fP.
+Add new ESSIDs to the database. A single ESSID may be given by the option \fB\-e\fP.
Multiple ESSIDs can be created by supplying a file (one per line) via the
-option \fB-i\fP. Re-creating an existing ESSID does not result in an error. For
+option \fB\-i\fP. Re-creating an existing ESSID does not result in an error. For
example:
.sp
.RS 12
@@ -270,7 +270,7 @@
.RE
.TP
.B delete_essid
-Delete the ESSID given by \fB-e\fP from the database. This includes all results
+Delete the ESSID given by \fB\-e\fP from the database. This includes all results
that may have been stored for that particular ESSID. For example:
.sp
.RS 12
@@ -292,7 +292,7 @@
.TP
.B export_passwords
Write all passwords that are currently stored in the database to a new file
-given by \fB-o\fP. Passwords are terminated by a single newline-character
+given by \fB\-o\fP. Passwords are terminated by a single newline-character
("\\n"). Existing files are overwritten without confirmation. For example:
.sp
.RS 12
@@ -302,7 +302,7 @@
.RE
.TP
.B export_cowpatty
-Write all results for the ESSID given by \fB-e\fP to the file given by \fB-o\fP
+Write all results for the ESSID given by \fB\-e\fP to the file given by \fB\-o\fP
in cowpatty's binary format. Existing files are overwritten without
confirmation. For example:
.sp
@@ -314,8 +314,8 @@
.TP
.B export_hashdb
Write all results currently stored in the database to the airolib-ng-database
-given by \fB-o\fP. The database is created with a default table layout if the
-file does not yet exist. The option \fB-e\fP can be used to limit the export
+given by \fB\-o\fP. The database is created with a default table layout if the
+file does not yet exist. The option \fB\-e\fP can be used to limit the export
to a single ESSID. For example:
.sp
.RS 12
@@ -325,7 +325,7 @@
.RE
.TP
.B import_passwords
-Read the file given by \fB-i\fP and import one password per line to the
+Read the file given by \fB\-i\fP and import one password per line to the
database. The passwords may contain all characters (including NULL-bytes) apart
from the terminating newline-character ("\\n").
Passwords that are not suitable for being used with WPA-/WPA2-PSK are ignored.
@@ -339,10 +339,10 @@
.RE
.TP
.B import_unique_passwords
-Read the file given by \fB-i\fP and import one password per line to the
+Read the file given by \fB\-i\fP and import one password per line to the
database. The passwords may contain all characters (including NULL-bytes) apart
from the terminating newline-character ("\\n"). Passwords that are not suitable
-for being used with WPA-/WPA2-PSK are ignored. This command does \finot\fP check
+for being used with WPA-/WPA2-PSK are ignored. This command does not check
if there are duplicate passwords within the file or between the file and the
database; it should be used with caution to prevent the database from getting
poisoned with duplicated passwords. This command however can be much faster than
@@ -377,10 +377,10 @@
.TP
.B passthrough
.br
-Read passwords from the file given by \fB-i\fP and compute their Pairwise
+Read passwords from the file given by \fB\-i\fP and compute their Pairwise
Master Keys for the
-ESSID given by \fB-e\fP. The results are written to the file specified by
-\fB-o\fP in cowpatty's binary format and are not stored in the
+ESSID given by \fB\-e\fP. The results are written to the file specified by
+\fB\-o\fP in cowpatty's binary format and are not stored in the
database for later use. This command therefor circumvents the entire database
and should only be used if storage-space is a problem (e.g. when using
Pyrit on a LiveCD). The \fBbatch\fP-command provides exactly the same
@@ -463,10 +463,10 @@
.TP
.B strip
.br
-Parse one or more packet-capture files given by the option \fB-r\fP, extract
+Parse one or more packet-capture files given by the option \fB\-r\fP, extract
only packets that are necessary for EAPOL-handshake detection and write a new
-dump to the filename given by the option \fB-o\fP. The options \fB-e\fP and
-\fB-b\fP can be used to filter certain Access-Points. For example:
+dump to the filename given by the option \fB\-o\fP. The options \fB\-e\fP and
+\fB\-b\fP can be used to filter certain Access-Points. For example:
.sp
.RS 12
.nf
@@ -476,12 +476,12 @@
.RE
.TP
.B stripLive
-Parse a packet-capture file given by the option \fB-r\fP, extract only packets
+Parse a packet-capture file given by the option \fB\-r\fP, extract only packets
that are necessary for EAPOL-handshake detection and write a new dump to the
-file given by the option \fB-o\fP. This command differs from \fBstrip\fP as the
+file given by the option \fB\-o\fP. This command differs from \fBstrip\fP as the
capture-file can be any character device including sockets and other
pseudo-files that \fIlook like\fP files in pcap-format. \fBstripLive\fP writes
-relevant packets to the new file given by \fB-o\fP as they arrive instead of
+relevant packets to the new file given by \fB\-o\fP as they arrive instead of
trying to read the entire capture-file first.
.sp
.RS 12
More information about the Python-apps-commits
mailing list