ronin-masscan 0.1.0.rc1

data/man/ronin-masscan-dump.1

@@ -0,0 +1,116 @@
+.\" Generated by kramdown-man 1.0.1
+.\" https://github.com/postmodern/kramdown-man#readme
+.TH ronin-masscan-dump 1 "2023-03-01" Ronin Masscan "User Manuals"
+.SH NAME
+.PP
+ronin\-masscan\-dump \- Dumps the scanned ports from masscan scan file(s)
+.SH SYNOPSIS
+.PP
+\fBronin\-masscan dump\fR \[lB]options\[rB] \fIMASSCAN\[ru]FILE\fP
+.SH DESCRIPTION
+.PP
+Dumps the scanned ports from masscan scan files into a variety of formats\. The
+output formats include:
+.RS
+.IP \(bu 2
+IP
+.IP \(bu 2
+Hostname
+.IP \(bu 2
+\fBIP:PORT\fR
+.IP \(bu 2
+\fBHOST:PORT\fR
+.IP \(bu 2
+URI
+.RE
+.PP
+The command also supports filtering the scanned ports by IP, IP range, domain,
+or port\.
+.SH ARGUMENTS
+.TP
+\fIMASSCAN\[ru]FILE\fP
+The masscan scan file to import\.
+.SH OPTIONS
+.TP
+\fB\-\-print\-ips\fR
+Only print the IP addresses of the targets (ex: \fB192\.168\.1\.1\fR)\.
+.TP
+\fB\-\-print\-hosts\fR
+Only print the hostnames of the targets (ex: \fBexample\.com\fR)\.
+.TP
+\fB\-\-print\-ip\-ports\fR
+Print IP address and port pairs for each target (ex: \fB192\.168\.1\.1:443\fR)\.
+This is the default behavior\.
+.TP
+\fB\-\-print\-host\-ports\fR
+Print hostname and port pairs for each target (ex: \fBexample\.com:443\fR)\.
+.TP
+\`\-\-print\-uris
+Print URIs for each target that has either \fBhttp\fR or \fBhttps\fR services
+(ex: \fBhttps:\[sl]\[sl]example\.com\fR or \fBhttp:\[sl]\[sl]example\.com:8080\fR)\.
+.TP
+\fB\-P\fR, \fB\-\-protocol\fR \fBtcp\fR\[or]\fBudp\fR
+Filters the targets by the protocol of the open port\.
+.TP
+\fB\-\-ip\fR \fIIP\fP
+Filters the targets by a specific IP address\.
+.TP
+\fB\-\-ip\-range\fR \fICIDR\fP
+Filter the targets by a CIDR IP range (ex: \fB192\.168\.1\.0\[sl]24\fR)\.
+.TP
+\fB\-p\fR, \fB\-\-ports\fR \[lC]\fIPORT\fP \[or] \fIPORT1\-PORT2\fP\[rC],\.\.\.
+Filter \fBIP:PORT\fR or \fBHOST:PORT\fR pairs who\[cq]s ports are in the gvien port list\.
+The port list is a comma separated list of port numbers (\fB443\fR) or port
+ranges (\fB8000\-9000\fR)\.
+.TP
+\fB\-h\fR, \fB\-\-help\fR
+Print help information
+.SH EXAMPLES
+.PP
+Print \fBIP:PORT\fR pairs from the masscan scan file:
+.PP
+.RS 4
+.EX
+\[Do] ronin\-masscan dump \-\-print\-ip\-ports masscan\.bin
+.EE
+.RE
+.PP
+Print \fBIP:PORT\fR pairs with ports 22, 80, or 443, from the masscan scan file:
+.PP
+.RS 4
+.EX
+\[Do] ronin\-masscan dump \-\-print\-ip\-ports \-\-ports 22,80,443 masscan\.bin
+.EE
+.RE
+.PP
+Print \fBHOST:PORT\fR pairs from the masscan scan file:
+.PP
+.RS 4
+.EX
+\[Do] ronin\-masscan dump \-\-print\-host\-ports masscan\.bin
+.EE
+.RE
+.PP
+Print target hostnames from the masscan scan file:
+.PP
+.RS 4
+.EX
+\[Do] ronin\-masscan dump \-\-print\-hosts \-\-with\-port 22 masscan\.bin
+.EE
+.RE
+.PP
+Print URIs from the masscan scan file:
+.PP
+.RS 4
+.EX
+\[Do] ronin\-masscan dump \-\-print\-uris masscan\.bin
+.EE
+.RE
+.SH AUTHOR
+.PP
+Postmodern 
+.MT postmodern\.mod3\[at]gmail\.com
+.ME
+.SH SEE ALSO
+.PP
+.BR ronin\-masscan\-print (1)

data/man/ronin-masscan-dump.1.md

@@ -0,0 +1,94 @@
+# ronin-masscan-dump 1 "2023-03-01" Ronin Masscan "User Manuals"
+
+## NAME
+
+ronin-masscan-dump - Dumps the scanned ports from masscan scan file(s)
+
+## SYNOPSIS
+
+`ronin-masscan dump` [options] *MASSCAN_FILE*
+
+## DESCRIPTION
+
+Dumps the scanned ports from masscan scan files into a variety of formats. The
+output formats include:
+
+* IP
+* Hostname
+* `IP:PORT`
+* `HOST:PORT`
+* URI
+
+The command also supports filtering the scanned ports by IP, IP range, domain,
+or port.
+
+## ARGUMENTS
+
+*MASSCAN_FILE*
+: The masscan scan file to import.
+
+## OPTIONS
+
+`--print-ips`
+: Only print the IP addresses of the targets (ex: `192.168.1.1`).
+
+`--print-hosts`
+: Only print the hostnames of the targets (ex: `example.com`).
+
+`--print-ip-ports`
+: Print IP address and port pairs for each target (ex: `192.168.1.1:443`).
+  This is the default behavior.
+
+`--print-host-ports`
+: Print hostname and port pairs for each target (ex: `example.com:443`).
+
+`--print-uris
+: Print URIs for each target that has either `http` or `https` services
+  (ex: `https://example.com` or `http://example.com:8080`).
+
+`-P`, `--protocol` `tcp`|`udp`
+: Filters the targets by the protocol of the open port.
+
+`--ip` *IP*
+: Filters the targets by a specific IP address.
+
+`--ip-range` *CIDR*
+: Filter the targets by a CIDR IP range (ex: `192.168.1.0/24`).
+
+`-p`, `--ports` {*PORT* | *PORT1-PORT2*},...
+: Filter `IP:PORT` or `HOST:PORT` pairs who's ports are in the gvien port list.
+  The port list is a comma separated list of port numbers (`443`) or port
+  ranges (`8000-9000`).
+
+`-h`, `--help`
+: Print help information
+
+## EXAMPLES
+
+Print `IP:PORT` pairs from the masscan scan file:
+
+    $ ronin-masscan dump --print-ip-ports masscan.bin
+
+Print `IP:PORT` pairs with ports 22, 80, or 443, from the masscan scan file:
+
+    $ ronin-masscan dump --print-ip-ports --ports 22,80,443 masscan.bin
+
+Print `HOST:PORT` pairs from the masscan scan file:
+
+    $ ronin-masscan dump --print-host-ports masscan.bin
+
+Print target hostnames from the masscan scan file:
+
+    $ ronin-masscan dump --print-hosts --with-port 22 masscan.bin
+
+Print URIs from the masscan scan file:
+
+    $ ronin-masscan dump --print-uris masscan.bin
+
+## AUTHOR
+
+Postmodern <postmodern.mod3@gmail.com>
+
+## SEE ALSO
+
+[ronin-masscan-print](ronin-masscan-print.1.md)

data/man/ronin-masscan-grep.1

@@ -0,0 +1,56 @@
+.\" Generated by kramdown-man 1.0.1
+.\" https://github.com/postmodern/kramdown-man#readme
+.TH ronin-masscan-grep 1 "2023-03-01" Ronin Masscan "User Manuals"
+.SH NAME
+.PP
+ronin\-masscan\-grep \- Greps the scanned services from masscan scan file(s)
+.SH SYNOPSIS
+.PP
+\fBronin\-masscan grep\fR \[lB]options\[rB] \fIPATTERN\fP \fIMASSCAN\[ru]FILE\fP
+.SH DESCRIPTION
+.PP
+Searches through the scanned services in one or more masscan scan files for the
+given pattern\. The scanned services that contain the text pattern are then
+printed with the text pattern highlighted in red\.
+.PP
+This command specifically searches the \[lq]banner\[rq] records in
+masscan output files generated using the \fBmasscan\fR \fB\-\-banners\fR option\.
+.SH ARGUMENTS
+.TP
+\fIPATTERN\fP
+The pattern to search for\.
+.TP
+\fIMASSCAN\[ru]FILE\fP
+The masscan scan file to import\.
+.SH OPTIONS
+.TP
+\fB\-P\fR, \fB\-\-protocol\fR \fBtcp\fR\[or]\fBudp\fR
+Filters the targets by the protocol of the open port\.
+.TP
+\fB\-\-ip\fR \fIIP\fP
+Filters the targets by a specific IP address\.
+.TP
+\fB\-\-ip\-range\fR \fICIDR\fP
+Filters the targets by a CIDR IP range (ex: \fB192\.168\.1\.0\[sl]24\fR)\.
+.TP
+\fB\-p\fR, \fB\-\-ports\fR \[lC]\fIPORT\fP \[or] \fIPORT1\-PORT2\fP\[rC],\.\.\.
+Filter \fBIP:PORT\fR or \fBHOST:PORT\fR pairs who\[cq]s ports are in the gvien port list\.
+The port list is a comma separated list of port numbers (\fB443\fR) or port
+ranges (\fB8000\-9000\fR)\.
+.TP
+\fB\-\-with\-app\-protocol\fR \fIAPP\[ru]PROTOCOL\fP,\.\.\.
+Filters targets by the app protocol names\.
+.TP
+\fB\-\-with\-payload\fR \fISTRING\fP
+Filters targets by the payload substring\.
+.TP
+\fB\-\-with\-payload\-regex\fR \fB\[sl]\fR\fIREGEX\fP\fB\[sl]\fR
+Filters targets how\[cq]s payload string matches the regular expression\.
+.SH AUTHOR
+.PP
+Postmodern 
+.MT postmodern\.mod3\[at]gmail\.com
+.ME
+.SH SEE ALSO
+.PP
+.BR ronin\-masscan\-print (1)

data/man/ronin-masscan-grep.1.md

@@ -0,0 +1,59 @@
+# ronin-masscan-grep 1 "2023-03-01" Ronin Masscan "User Manuals"
+
+## NAME
+
+ronin-masscan-grep - Greps the scanned services from masscan scan file(s)
+
+## SYNOPSIS
+
+`ronin-masscan grep` [options] *PATTERN* *MASSCAN_FILE*
+
+## DESCRIPTION
+
+Searches through the scanned services in one or more masscan scan files for the
+given pattern. The scanned services that contain the text pattern are then
+printed with the text pattern highlighted in red.
+
+This command specifically searches the "banner" records in
+masscan output files generated using the `masscan` `--banners` option.
+
+## ARGUMENTS
+
+*PATTERN*
+: The pattern to search for.
+
+*MASSCAN_FILE*
+: The masscan scan file to import.
+
+## OPTIONS
+
+`-P`, `--protocol` `tcp`|`udp`
+: Filters the targets by the protocol of the open port.
+
+`--ip` *IP*
+: Filters the targets by a specific IP address.
+
+`--ip-range` *CIDR*
+: Filters the targets by a CIDR IP range (ex: `192.168.1.0/24`).
+
+`-p`, `--ports` {*PORT* | *PORT1-PORT2*},...
+: Filter `IP:PORT` or `HOST:PORT` pairs who's ports are in the gvien port list.
+  The port list is a comma separated list of port numbers (`443`) or port
+  ranges (`8000-9000`).
+
+`--with-app-protocol` *APP_PROTOCOL*,...
+: Filters targets by the app protocol names.
+
+`--with-payload` *STRING*
+: Filters targets by the payload substring.
+
+`--with-payload-regex` `/`*REGEX*`/`
+: Filters targets how's payload string matches the regular expression.
+
+## AUTHOR
+
+Postmodern <postmodern.mod3@gmail.com>
+
+## SEE ALSO
+
+[ronin-masscan-print](ronin-masscan-print.1.md)

data/man/ronin-masscan-import.1

@@ -0,0 +1,52 @@
+.\" Generated by kramdown-man 1.0.1
+.\" https://github.com/postmodern/kramdown-man#readme
+.TH ronin-masscan-import 1 "2023-03-01" Ronin Masscan "User Manuals"
+.SH NAME
+.PP
+ronin\-masscan\-import \- Imports a masscan scan file into ronin\-db
+.SH SYNOPSIS
+.PP
+\fBronin\-masscan import\fR \[lB]\fIoptions\fP\[rB] \fIMASSCAN\[ru]FILE\fP
+.SH DESCRIPTION
+.PP
+Imports the masscan scan file data into the Ronin database\.
+.SH ARGUMENTS
+.TP
+\fIMASSCAN\[ru]FILE\fP
+The masscan scan file to import\.
+.SH OPTIONS
+.TP
+\fB\-\-db\fR \fINAME\fP
+The database name to connect to\. Defaults to \fBdefault\fR if not given\.
+.TP
+\fB\-\-db\-uri\fR \fIURI\fP
+The explicit database URI to connect to
+(ex: \fBpostgres:\[sl]\[sl]user:password\[at]host\[sl]db\fR)\.
+.TP
+\fB\-\-db\-file\fR \fIPATH\fP
+The sqlite3 database file to use\.
+.TP
+\fB\-h\fR, \fB\-\-help\fR
+Print help information
+.SH ENVIRONMENT
+.TP
+\fIHOME\fP
+The user\[cq]s home directory\.
+.TP
+\fIXDG\[ru]CONFIG\[ru]HOME\fP
+Alternate location for the \fB\[ti]\[sl]\.config\fR directory\.
+.TP
+\fIXDG\[ru]DATA\[ru]HOME\fP
+Alternate location for the \fB\[ti]\[sl]\.local\[sl]share\fR directory\.
+.SH FILES
+.TP
+\fB\[ti]\[sl]\.local\[sl]share\[sl]ronin\-db\[sl]database\.sqlite3\fR
+The default sqlite3 database file\.
+.TP
+\fB\[ti]\[sl]\.config\[sl]ronin\-db\[sl]database\.yml\fR
+Optional database configuration\.
+.SH AUTHOR
+.PP
+Postmodern 
+.MT postmodern\.mod3\[at]gmail\.com
+.ME

data/man/ronin-masscan-import.1.md

@@ -0,0 +1,57 @@
+# ronin-masscan-import 1 "2023-03-01" Ronin Masscan "User Manuals"
+
+## NAME
+
+ronin-masscan-import - Imports a masscan scan file into ronin-db
+
+## SYNOPSIS
+
+`ronin-masscan import` [*options*] *MASSCAN_FILE*
+
+## DESCRIPTION
+
+Imports the masscan scan file data into the Ronin database.
+
+## ARGUMENTS
+
+*MASSCAN_FILE*
+: The masscan scan file to import.
+
+## OPTIONS
+
+`--db` *NAME*
+: The database name to connect to. Defaults to `default` if not given.
+
+`--db-uri` *URI*
+: The explicit database URI to connect to
+  (ex: `postgres://user:password@host/db`).
+
+`--db-file` *PATH*
+: The sqlite3 database file to use.
+
+`-h`, `--help`
+: Print help information
+
+## ENVIRONMENT
+
+*HOME*
+: The user's home directory.
+
+*XDG_CONFIG_HOME*
+: Alternate location for the `~/.config` directory.
+
+*XDG_DATA_HOME*
+: Alternate location for the `~/.local/share` directory.
+
+## FILES
+
+`~/.local/share/ronin-db/database.sqlite3`
+: The default sqlite3 database file.
+
+`~/.config/ronin-db/database.yml`
+: Optional database configuration.
+
+## AUTHOR
+
+Postmodern <postmodern.mod3@gmail.com>
+

data/man/ronin-masscan-new.1

@@ -0,0 +1,78 @@
+.\" Generated by kramdown-man 1.0.1
+.\" https://github.com/postmodern/kramdown-man#readme
+.TH ronin-masscan-new 1 "2023-03-01" Ronin Nmap "User Manuals"
+.SH NAME
+.PP
+ronin\-masscan\-new \- Generates a new masscan ruby script
+.SH SYNOPSIS
+.PP
+\fBronin\-masscan new\fR \[lB]options\[rB] \fIFILE\fP
+.SH DESCRIPTION
+.PP
+Generates a new masscan scanner or parser Ruby script that uses the
+\fBronin\-masscan\fR  library\.
+.SH ARGUMENTS
+.TP
+\fIFILE\fP
+The path to the new Ruby script to generate\.
+.SH OPTIONS
+.TP
+\fB\-\-parser\fR
+Generates a new masscan output file parser Ruby script\.
+.TP
+\fB\-\-scanner\fR
+Generates a new masscan scanner Ruby script\.
+.TP
+\fB\-\-printing\fR
+Adds additional code to the Ruby script that prints the masscan scan data\.
+Is compatible with both \fB\-\-parser\fR and \fB\-\-scanner\fR\.
+.TP
+\fB\-\-import\fR
+Adds additional code to the Ruby script that imports the masscan scan data\.
+Is compatible with both \fB\-\-parser\fR and \fB\-\-scanner\fR\.
+.TP
+\fB\-\-output\-file\fR \fIOUTPUT\[ru]FILE\fP
+Parses or writes the scan results to the given output File\.
+Is compatible with both \fB\-\-parser\fR and \fB\-\-scanner\fR\.
+.TP
+\fB\-p\fR, \fB\-\-port\fR \[lC]\fIPORT\fP \[or] \fIPORT1\fP\-\fIPORT2\fP\[rC],\.\.\.
+Specifies the ports to scan\. Not compatible with the \fB\-\-parser\fR option\.
+.TP
+\fB\-\-ips \fR \[lC]\fIIP\fP \[or] \fIIP\-range\fP\[rC]\[lB],\.\.\.\[rB]
+Adds a target to scan\. May be an IP or a IP CIDR range
+(ex: \fB192\.168\.1\.1\[sl]24\fR)\. The option may be specified more than once\.
+Not compatible with the \fB\-\-parser\fR option\.
+.TP
+\fB\-h\fR, \fB\-\-help\fR
+Print help information
+.SH EXAMPLES
+.PP
+Generates a new masscan scanner Ruby script that scans \fB192\.168\.1\.*\fR, ports 22,
+80, 443, and 8000 through 9000:
+.PP
+.RS 4
+.EX
+\[Do] ronin\-masscan new scanner\.rb \-\-ips \(aq192\.168\.1\.*\(aq \-\-ports 22,80,443,8000\-9000
+.EE
+.RE
+.PP
+Generates a new masscan output file parser script that parses
+\fBpath\[sl]to\[sl]masscan\.bin\fR and prints the scan information:
+.PP
+.RS 4
+.EX
+\[Do] ronin\-masscan new parser\.rb \-\-parser \-\-output\-file path\[sl]to\[sl]masscan\.bin \-\-printing
+.EE
+.RE
+.SH AUTHOR
+.PP
+Postmodern 
+.MT postmodern\.mod3\[at]gmail\.com
+.ME
+.SH SEE ALSO
+.PP
+.BR ronin\-masscan\-scan (1)
+, 
+.BR ronin\-masscan\-print (1)
+, 
+.BR ronin\-masscan\-import (1)

data/man/ronin-masscan-new.1.md

@@ -0,0 +1,70 @@
+# ronin-masscan-new 1 "2023-03-01" Ronin Nmap "User Manuals"
+
+## NAME
+
+ronin-masscan-new - Generates a new masscan ruby script
+
+## SYNOPSIS
+
+`ronin-masscan new` [options] *FILE*
+
+## DESCRIPTION
+
+Generates a new masscan scanner or parser Ruby script that uses the
+`ronin-masscan`  library.
+
+## ARGUMENTS
+
+*FILE*
+: The path to the new Ruby script to generate.
+
+## OPTIONS
+
+`--parser`
+: Generates a new masscan output file parser Ruby script.
+
+`--scanner`
+: Generates a new masscan scanner Ruby script.
+
+`--printing`
+: Adds additional code to the Ruby script that prints the masscan scan data.
+  Is compatible with both `--parser` and `--scanner`.
+
+`--import`
+: Adds additional code to the Ruby script that imports the masscan scan data.
+  Is compatible with both `--parser` and `--scanner`.
+
+`--output-file` *OUTPUT_FILE*
+: Parses or writes the scan results to the given output File.
+  Is compatible with both `--parser` and `--scanner`.
+
+`-p`, `--port` {*PORT* \| *PORT1*-*PORT2*},...
+: Specifies the ports to scan. Not compatible with the `--parser` option.
+
+`--ips ` {*IP* \| *IP-range*}[,...]
+: Adds a target to scan. May be an IP or a IP CIDR range
+  (ex: `192.168.1.1/24`). The option may be specified more than once.
+  Not compatible with the `--parser` option.
+
+`-h`, `--help`
+: Print help information
+
+## EXAMPLES
+
+Generates a new masscan scanner Ruby script that scans `192.168.1.*`, ports 22,
+80, 443, and 8000 through 9000:
+
+    $ ronin-masscan new scanner.rb --ips '192.168.1.*' --ports 22,80,443,8000-9000
+
+Generates a new masscan output file parser script that parses
+`path/to/masscan.bin` and prints the scan information:
+
+    $ ronin-masscan new parser.rb --parser --output-file path/to/masscan.bin --printing
+
+## AUTHOR
+
+Postmodern <postmodern.mod3@gmail.com>
+
+## SEE ALSO
+
+[ronin-masscan-scan](ronin-masscan-scan.1.md), [ronin-masscan-print](ronin-masscan-print.1.md), [ronin-masscan-import](ronin-masscan-import.1.md)

data/man/ronin-masscan-print.1

@@ -0,0 +1,53 @@
+.\" Generated by kramdown-man 1.0.1
+.\" https://github.com/postmodern/kramdown-man#readme
+.TH ronin-masscan-print 1 "2023-03-01" Ronin Masscan "User Manuals"
+.SH NAME
+.PP
+ronin\-masscan\-print \- Prints the scanned IPs and ports from masscan scan file(s)
+.SH SYNOPSIS
+.PP
+\fBronin\-masscan print\fR \[lB]options\[rB] \fIMASSCAN\[ru]FILE\fP
+.SH DESCRIPTION
+.PP
+Parses one or more masscan scan files and pretty prints the scanned IPs and
+open ports\. The command also supports filtering the scanned ports by IP,
+IP range, domain, or port\.
+.SH ARGUMENTS
+.TP
+\fIMASSCAN\[ru]FILE\fP
+The masscan scan file to import\.
+.SH OPTIONS
+.TP
+\fB\-P\fR, \fB\-\-protocol\fR \fBtcp\fR\[or]\fBudp\fR
+Filters the targets by the protocol of the open port\.
+.TP
+\fB\-\-ip\fR \fIIP\fP
+Filters the targets by a specific IP address\.
+.TP
+\fB\-\-ip\-range\fR \fICIDR\fP
+Filters the targets by a CIDR IP range (ex: \fB192\.168\.1\.0\[sl]24\fR)\.
+.TP
+\fB\-p\fR, \fB\-\-ports\fR \[lC]\fIPORT\fP \[or] \fIPORT1\-PORT2\fP\[rC],\.\.\.
+Filter \fBIP:PORT\fR or \fBHOST:PORT\fR pairs who\[cq]s ports are in the gvien port list\.
+The port list is a comma separated list of port numbers (\fB443\fR) or port
+ranges (\fB8000\-9000\fR)\.
+.TP
+\fB\-\-with\-app\-protocol\fR \fIAPP\[ru]PROTOCOL\fP,\.\.\.
+Filters targets by the app protocol names\.
+.TP
+\fB\-\-with\-payload\fR \fISTRING\fP
+Filters targets by the payload substring\.
+.TP
+\fB\-\-with\-payload\-regex\fR \fB\[sl]\fR\fIREGEX\fP\fB\[sl]\fR
+Filters targets how\[cq]s payload string matches the regular expression\.
+.TP
+\fB\-h\fR, \fB\-\-help\fR
+Print help information
+.SH AUTHOR
+.PP
+Postmodern 
+.MT postmodern\.mod3\[at]gmail\.com
+.ME
+.SH SEE ALSO
+.PP
+.BR ronin\-masscan\-dump (1)

data/man/ronin-masscan-print.1.md

@@ -0,0 +1,56 @@
+# ronin-masscan-print 1 "2023-03-01" Ronin Masscan "User Manuals"
+
+## NAME
+
+ronin-masscan-print - Prints the scanned IPs and ports from masscan scan file(s)
+
+## SYNOPSIS
+
+`ronin-masscan print` [options] *MASSCAN_FILE*
+
+## DESCRIPTION
+
+Parses one or more masscan scan files and pretty prints the scanned IPs and
+open ports. The command also supports filtering the scanned ports by IP,
+IP range, domain, or port.
+
+## ARGUMENTS
+
+*MASSCAN_FILE*
+: The masscan scan file to import.
+
+## OPTIONS
+
+`-P`, `--protocol` `tcp`|`udp`
+: Filters the targets by the protocol of the open port.
+
+`--ip` *IP*
+: Filters the targets by a specific IP address.
+
+`--ip-range` *CIDR*
+: Filters the targets by a CIDR IP range (ex: `192.168.1.0/24`).
+
+`-p`, `--ports` {*PORT* | *PORT1-PORT2*},...
+: Filter `IP:PORT` or `HOST:PORT` pairs who's ports are in the gvien port list.
+  The port list is a comma separated list of port numbers (`443`) or port
+  ranges (`8000-9000`).
+
+`--with-app-protocol` *APP_PROTOCOL*,...
+: Filters targets by the app protocol names.
+
+`--with-payload` *STRING*
+: Filters targets by the payload substring.
+
+`--with-payload-regex` `/`*REGEX*`/`
+: Filters targets how's payload string matches the regular expression.
+
+`-h`, `--help`
+: Print help information
+
+## AUTHOR
+
+Postmodern <postmodern.mod3@gmail.com>
+
+## SEE ALSO
+
+[ronin-masscan-dump](ronin-masscan-dump.1.md)