Commit 8746c788 authored by Robert David Graham's avatar Robert David Graham
Browse files

Merge pull request #30 from dmaynor/master

removed scan2text from docs
parents 35cfdb0e f02386d7
Loading
Loading
Loading
Loading
+3 −2
Original line number Diff line number Diff line
@@ -170,8 +170,9 @@ parameter `-oX <filename>`. Or, use the parameters `--output-format xml` and

The second is the binary format. This produces much smaller files, so that
when I scan the Internet my disk doesn't fill up. They need to be parsed,
though. In the `util` subdirectory there is a program `scan2text.c` that will
scan in the binary format and produce text.
though. The command line option `--readscan` will read binary scan files.
Using `--readscan` with the `-oX` option will produce a XML version of the 
results file.


## Comparison with Nmap
+4 −1
Original line number Diff line number Diff line
@@ -138,7 +138,10 @@ masscan <ip addresses/ranges> \-p \fIports\fR \fIoptions\fR
\fB\-oX <filename>\fR: sets the output format to XML and saves the output in the given filename\. This is equivelent to using the \fB\-\-output\-format\fR and \fB\-\-output\-filename\fR parameters\.
.
.IP "\(bu" 4
\fB\-oB <filename>\fR: sets the output format to binary and saves the output in the given filename\. This is equivelent to using the \fB\-\-output\-format\fR and \fB\-\-output\-filename\fR parameters\. The tool \fBscan2text\fR can then be used to read the binary file\. Binary files are mush smaller than their XML equivelents, but require a separate step to convert back into XML or another readable format\.
\fB\-oB <filename>\fR: sets the output format to binary and saves the output in the given filename\. This is equivelent to using the \fB\-\-output\-format\fR and \fB\-\-output\-filename\fR parameters\. The option \fB\-\-readscan\fR can then be used to read the binary file\. Binary files are mush smaller than their XML equivelents, but require a separate step to convert back into XML or another readable format\.
.
.IP "\(bu" 4
\fB\-\-readscan <filename>\fR: reads the binary scan results and displays to console\. If used with \fB\-oX a XML version of the binary file will be created\.
.
.IP "" 0
.
+12 −2
Original line number Diff line number Diff line
@@ -200,7 +200,7 @@ one port.
    
  * `-oB <filename>`: sets the output format to binary and saves the output in
    the given filename. This is equivelent to using the `--output-format` and
    `--output-filename` parameters. The tool `scan2text` can then be used to
    `--output-filename` parameters. The option `--readscan` can then be used to
    read the binary file. Binary files are mush smaller than their XML
    equivelents, but require a separate step to convert back into XML or
    another readable format.
@@ -267,6 +267,16 @@ their versions, then saves the results in an XML file.

You should be able to import the XML into databases and such.

The following example reads a binary scan results file called bin-test.scan and prints
results to console.

	# masscan --readscan bin-test.scan
	
The following example reads a binary scan results file called bin-test.scan and creates
an XML output file called bin-test.xml.

	# masscan --readscan bin-test.scan -oX bin-test.xml

## ADVANCED EXAMPLES

Let's say that you want to scan the entire Internet and spread the scan