ronin 2.0.5 → 2.1.0

data/lib/ronin/cli/commands/url.rb

@@ -108,6 +108,8 @@ module Ronin
           "--param id https://example.com/page?id=100"
         ]
 
+        description 'Parses URLs'
+
         man_page 'ronin-url.1'
 
         #

data/lib/ronin/cli/http_shell.rb

@@ -310,6 +310,31 @@ module Ronin
         end
       end
 
+      command :cookie, summary: 'Prints the Cookie value'
+
+      #
+      # The `cookie` shell command.
+      #
+      def cookie
+        if @http.cookie
+          puts @http.cookie
+        end
+      end
+
+      command :"set-cookie", method_name: :set_cookie,
+                             usage:       'NAME=VALUE; ...',
+                             summary:     'Sets the Cookie value'
+
+      #
+      # The `set-cookie` shell command.
+      #
+      # @param [Array<String>] params
+      #   The `NAME=VALUE` param pairs.
+      #
+      def set_cookie(*params)
+        @http.cookie = params.join(' ')
+      end
+
       #
       # Joins the given path with the {#base_url}.
       #

data/lib/ronin/cli.rb

@@ -17,6 +17,7 @@
 #
 
 require 'ronin/version'
+require 'ronin/core/cli/help/banner'
 
 require 'command_kit/commands'
 require 'command_kit/commands/auto_load'
@@ -38,6 +39,7 @@ module Ronin
       namespace: "#{self}::Commands"
     )
     include CommandKit::Options::Version
+    include Core::CLI::Help::Banner
 
     command_name 'ronin'
     version Ronin::VERSION
@@ -46,15 +48,23 @@ module Ronin
     command_aliases['dec'] = 'decode'
     command_aliases['nc']  = 'netcat'
 
+    command_aliases['tlds']            = 'tld-list'
+    command_aliases['public-suffixes'] = 'public-suffix-list'
+
     # Additional `ronin-` commands to checkout.
     ADDITIONAL_RONIN_COMMANDS = %w[
       ronin-repos
+      ronin-wordlists
       ronin-db
       ronin-web
       ronin-fuzzer
+      ronin-masscan
+      ronin-nmap
+      ronin-recon
       ronin-payloads
       ronin-exploits
       ronin-vulns
+      ronin-app
     ]
 
     #

data/lib/ronin/version.rb

@@ -18,5 +18,5 @@
 
 module Ronin
   # ronin version
-  VERSION = '2.0.5'
+  VERSION = '2.1.0'
 end

data/man/ronin-archive.1.md

@@ -0,0 +1,49 @@
+# ronin-archive 1 "2024-01-18" Ronin "User Manuals"
+
+## NAME
+
+ronin-archive - Archive the files.
+
+## SYNOPSIS
+
+`ronin archive` [*options*] {`-o`,`--output` *PATH* } *FILE* ...
+
+## DESCRIPTION
+
+Archive the files.
+
+## ARGUMENTS
+
+*FILE*
+: A file to add to the output archive.
+
+## OPTIONS
+
+`-f`, `--format` `tar`\|`zip`
+: The archive format to use. If not specified the archive format will be
+  inferred from the output file's extension.
+
+`-o`, `--output` *PATH*
+: Path to the output file.
+
+## EXAMPLES
+
+Archive files using tar format:
+
+    $ ronin archive -o archived.tar file1.txt file2.txt
+
+Archive files using zip format:
+
+    $ ronin archive -o archived.zip file1.txt file2.txt
+
+Explicitly specify the archive format:
+
+    $ ronin archive -f zip archive.jar file1.txt file2.txt
+
+## AUTHOR
+
+Postmodern <postmodern.mod3@gmail.com>
+
+## SEE ALSO
+
+[ronin-unarchive](ronin-unarchive.1.md)

data/man/ronin-asn.1

@@ -1,134 +1,117 @@
-.\" Generated by kramdown-man 0.1.8
+.\" Generated by kramdown-man 1.0.1
 .\" https://github.com/postmodern/kramdown-man#readme
 .TH ronin-asn 1 "2023-02-01" Ronin "User Manuals"
-.LP
+.SH NAME
+.PP
+ronin\-asn \- Queries or searches for ASN information
 .SH SYNOPSIS
-.LP
-.HP
-\fBronin asn\fR \[lB]\fIoptions\fP\[rB] \[lB]\fB-v\fR \[or] \fB--enum-ips\fR\[rB] \[lC]\fB-n\fR,\fB--number\fR \fINUMBER\fP \[or] \fB-c\fR,\fB--country\fR \fICOUNTRY\fP \[or] \fB-N\fR,\fB--name\fR \fINAME\fP \[or] \fB-I\fR,\fB--ip\fR \fIIP\fP\[rC]
-.LP
+.PP
+\fBronin asn\fR \[lB]\fIoptions\fP\[rB] \[lB]\fB\-v\fR \[or] \fB\-\-enum\-ips\fR\[rB] \[lC]\fB\-n\fR,\fB\-\-number\fR \fINUMBER\fP \[or] \fB\-c\fR,\fB\-\-country\fR \fICOUNTRY\fP \[or] \fB\-N\fR,\fB\-\-name\fR \fINAME\fP \[or] \fB\-I\fR,\fB\-\-ip\fR \fIIP\fP\[rC]
 .SH DESCRIPTION
-.LP
 .PP
 Queries ASN information for the given \fIIP\fP or searches for the ASN records for
 the given \fINUMBER\fP, \fINAME\fP, or \fICOUNTRY\fP code\.
-.LP
 .SH OPTIONS
-.LP
 .TP
-\fB-v\fR, \fB--verbose\fR
+\fB\-v\fR, \fB\-\-verbose\fR
 Prints multi\-line human readable output\.
-.LP
 .TP
-\fB-U\fR, \fB--url\fR \fIURI\fP
+\fB\-U\fR, \fB\-\-url\fR \fIURI\fP
 Overrides the default ASN list URL\. Defaults to
-\fBhttps://iptoasn.com/data/ip2asn-combined.tsv.gz\fR\.
-.LP
+\fBhttps:\[sl]\[sl]iptoasn\.com\[sl]data\[sl]ip2asn\-combined\.tsv\.gz\fR\.
 .TP
-\fB-f\fR, \fB--file\fR \fIFILE\fP
+\fB\-f\fR, \fB\-\-file\fR \fIFILE\fP
 Overrides the default ASN list file\. Defaults to
-\fB~/.cache/ronin/ronin-support/ip2asn-combined.tsv.gz\fR\.
-.LP
+\fB\[ti]\[sl]\.cache\[sl]ronin\[sl]ronin\-support\[sl]ip2asn\-combined\.tsv\.gz\fR\.
 .TP
-\fB-u\fR, \fB--update\fR
+\fB\-u\fR, \fB\-\-update\fR
 Updates the ASN list file\.
-.LP
 .TP
-\fB-n\fR, \fB--number\fR \fINUM\fP\[or]AS\fINUM\fP
+\fB\-n\fR, \fB\-\-number\fR \fINUM\fP\[or]AS\fINUM\fP
 Searches for all ASN records with the AS number\.
-.LP
 .TP
-\fB-C\fR, \fB--country-code\fR \fIXX\fP\[or]\fBNone\fR\[or]\fBUnknown\fR
+\fB\-C\fR, \fB\-\-country\-code\fR \fIXX\fP\[or]\fBNone\fR\[or]\fBUnknown\fR
 Searches for all ASN records with the country code\.
-.LP
 .TP
-\fB-N\fR, \fB--name\fR \fINAME\fP
+\fB\-N\fR, \fB\-\-name\fR \fINAME\fP
 Searches for all ASN records with the matching name\.
-.LP
 .TP
-\fB-I\fR, \fB--ip\fR \fIIP\fP
+\fB\-I\fR, \fB\-\-ip\fR \fIIP\fP
 Queries the ASN record for the IP\.
-.LP
 .TP
-\fB-4\fR, \fB--ipv4\fR
+\fB\-4\fR, \fB\-\-ipv4\fR
 Filters ASN records for only IPv4 ranges\.
-.LP
 .TP
-\fB-6\fR, \fB--ipv6\fR
+\fB\-6\fR, \fB\-\-ipv6\fR
 Filter ASN records for only IPv6 ranges\.
-.LP
 .TP
-\fB-E\fR, \fB--enum-ips\fR
+\fB\-E\fR, \fB\-\-enum\-ips\fR
 Enumerate over the IPs within the ASN ranges\.
-.LP
 .TP
-\fB-h\fR, \fB--help\fR
+\fB\-h\fR, \fB\-\-help\fR
 Print help information
-.LP
 .SH EXAMPLES
-.LP
 .PP
 Print verbose output for all ASN records for \fBAS15133\fR:
-.LP
-.nf
-    ronin asn \-v \-n 15133
-.fi
-.LP
-.PP
-Print verbose output for the ASN record for the IP address \fB93.184.216.34\fR:
-.LP
-.nf
-    ronin asn \-v \-I 93\.184\.216\.34
-.fi
-.LP
+.PP
+.RS 4
+.EX
+\[Do] ronin asn \-v \-n 15133
+.EE
+.RE
+.PP
+Print verbose output for the ASN record for the IP address \fB93\.184\.216\.34\fR:
+.PP
+.RS 4
+.EX
+\[Do] ronin asn \-v \-I 93\.184\.216\.34
+.EE
+.RE
 .PP
 Prints all ASN records for the given country code:
-.LP
-.nf
-    ronin asn \-C US
-.fi
-.LP
+.PP
+.RS 4
+.EX
+\[Do] ronin asn \-C US
+.EE
+.RE
 .PP
 Prints all ASN records for the given ISP:
-.LP
-.nf
-    ronin asn \-N EDGECAST
-.fi
-.LP
+.PP
+.RS 4
+.EX
+\[Do] ronin asn \-N EDGECAST
+.EE
+.RE
 .PP
 Enumerate over the IP addresses in the IP range for \fBAS15133\fR:
-.LP
-.nf
-    ronin asn \-\-enum\-ips \-n 15133
-.fi
-.LP
+.PP
+.RS 4
+.EX
+\[Do] ronin asn \-\-enum\-ips \-n 15133
+.EE
+.RE
 .PP
 Enumerate over all IP addresses for all ASN records belonging to the given ISP:
-.LP
-.nf
-    ronin asn \-\-enum\-ips \-N EDGECAST
-.fi
-.LP
+.PP
+.RS 4
+.EX
+\[Do] ronin asn \-\-enum\-ips \-N EDGECAST
+.EE
+.RE
 .SH ENVIRONMENT
-.LP
 .TP
 \fIHOME\fP
 Alternate location for the user\[cq]s home directory\.
-.LP
 .TP
 \fIXDG\[ru]CONFIG\[ru]HOME\fP
-Alternate location for the \fB~/.config\fR directory\.
-.LP
+Alternate location for the \fB\[ti]\[sl]\.config\fR directory\.
 .SH FILES
-.LP
 .TP
-\fB~/.cache/ronin/ronin-support/ip2asn-combined.tsv.gz\fR
+\fB\[ti]\[sl]\.cache\[sl]ronin\[sl]ronin\-support\[sl]ip2asn\-combined\.tsv\.gz\fR
 The location of the downloaded ASN list\.
-.LP
 .SH AUTHOR
-.LP
 .PP
 Postmodern 
 .MT postmodern\.mod3\[at]gmail\.com
 .ME
-.LP

data/man/ronin-asn.1.md

@@ -1,5 +1,9 @@
 # ronin-asn 1 "2023-02-01" Ronin "User Manuals"
 
+## NAME
+
+ronin-asn - Queries or searches for ASN information
+
 ## SYNOPSIS
 
 `ronin asn` [*options*] [`-v` \| `--enum-ips`] {`-n`,`--number` *NUMBER* \| `-c`,`--country` *COUNTRY* \| `-N`,`--name` *NAME* \| `-I`,`--ip` *IP*}
@@ -12,81 +16,81 @@ the given *NUMBER*, *NAME*, or *COUNTRY* code.
 ## OPTIONS
 
 `-v`, `--verbose`
-  Prints multi-line human readable output.
+: Prints multi-line human readable output.
 
 `-U`, `--url` *URI*
-  Overrides the default ASN list URL. Defaults to
+: Overrides the default ASN list URL. Defaults to
   `https://iptoasn.com/data/ip2asn-combined.tsv.gz`.
 
 `-f`, `--file` *FILE*
-  Overrides the default ASN list file. Defaults to
+: Overrides the default ASN list file. Defaults to
   `~/.cache/ronin/ronin-support/ip2asn-combined.tsv.gz`.
 
 `-u`, `--update`
-  Updates the ASN list file.
+: Updates the ASN list file.
 
 `-n`, `--number` *NUM*\|AS*NUM*
-  Searches for all ASN records with the AS number.
+: Searches for all ASN records with the AS number.
 
 `-C`, `--country-code` *XX*|`None`|`Unknown`
-  Searches for all ASN records with the country code.
+: Searches for all ASN records with the country code.
 
 `-N`, `--name` *NAME*
-  Searches for all ASN records with the matching name.
+: Searches for all ASN records with the matching name.
 
 `-I`, `--ip` *IP*
-  Queries the ASN record for the IP.
+: Queries the ASN record for the IP.
 
 `-4`, `--ipv4`
-  Filters ASN records for only IPv4 ranges.
+: Filters ASN records for only IPv4 ranges.
 
 `-6`, `--ipv6`
-  Filter ASN records for only IPv6 ranges.
+: Filter ASN records for only IPv6 ranges.
 
 `-E`, `--enum-ips`
-  Enumerate over the IPs within the ASN ranges.
+: Enumerate over the IPs within the ASN ranges.
 
 `-h`, `--help`
-  Print help information
+: Print help information
 
 ## EXAMPLES
 
 Print verbose output for all ASN records for `AS15133`:
 
-        ronin asn -v -n 15133
+    $ ronin asn -v -n 15133
 
 Print verbose output for the ASN record for the IP address `93.184.216.34`:
 
-        ronin asn -v -I 93.184.216.34
+    $ ronin asn -v -I 93.184.216.34
 
 Prints all ASN records for the given country code:
 
-        ronin asn -C US
+    $ ronin asn -C US
 
 Prints all ASN records for the given ISP:
 
-        ronin asn -N EDGECAST
+    $ ronin asn -N EDGECAST
 
 Enumerate over the IP addresses in the IP range for `AS15133`:
 
-        ronin asn --enum-ips -n 15133
+    $ ronin asn --enum-ips -n 15133
 
 Enumerate over all IP addresses for all ASN records belonging to the given ISP:
 
-        ronin asn --enum-ips -N EDGECAST
+    $ ronin asn --enum-ips -N EDGECAST
 
 ## ENVIRONMENT
 
 *HOME*
-  Alternate location for the user's home directory.
+: Alternate location for the user's home directory.
 
 *XDG_CONFIG_HOME*
-  Alternate location for the `~/.config` directory.
+: Alternate location for the `~/.config` directory.
 
 ## FILES
 
 `~/.cache/ronin/ronin-support/ip2asn-combined.tsv.gz`
-  The location of the downloaded ASN list.
+: The location of the downloaded ASN list.
 
 ## AUTHOR
 

data/man/ronin-banner-grab.1

@@ -1,45 +1,34 @@
-.\" Generated by kramdown-man 0.1.8
+.\" Generated by kramdown-man 1.0.1
 .\" https://github.com/postmodern/kramdown-man#readme
 .TH ronin-banner-grab 1 "2023-02-01" Ronin "User Manuals"
-.LP
+.SH NAME
+.PP
+ronin\-banner\-grab \- Fetches the banner from one or more TCP services
 .SH SYNOPSIS
-.LP
-.HP
-\fBronin banner-grab\fR \[lB]\fIoptions\fP\[rB] \[lC]\fIHOST\fP:\fIPORT\fP\[rC] \.\.\.
-.LP
+.PP
+\fBronin banner\-grab\fR \[lB]\fIoptions\fP\[rB] \[lC]\fIHOST\fP:\fIPORT\fP\[rC] \.\.\.
 .SH DESCRIPTION
-.LP
 .PP
 Fetches the banner from one or more TCP services\.
-.LP
 .SH ARGUMENTS
-.LP
 .TP
 \fIHOST\fP:\fIPORT\fP
 A TCP service to fetch the banner from\.
-.LP
 .SH OPTIONS
-.LP
 .TP
-\fB-f\fR, \fB--file\fR \fIFILE\fP
+\fB\-f\fR, \fB\-\-file\fR \fIFILE\fP
 Optional file to read target values from\.
-.LP
 .TP
-\fB--with-host-port\fR
+\fB\-\-with\-host\-port\fR
 Print the service with each banner\.
-.LP
 .TP
-\fB-h\fR, \fB--help\fR
+\fB\-h\fR, \fB\-\-help\fR
 Print help information\.
-.LP
 .SH AUTHOR
-.LP
 .PP
 Postmodern 
 .MT postmodern\.mod3\[at]gmail\.com
 .ME
-.LP
 .SH SEE ALSO
-.LP
 .PP
-ronin\-cert\-grab(1)
+.BR ronin\-cert\-grab (1)

data/man/ronin-banner-grab.1.md

@@ -1,5 +1,9 @@
 # ronin-banner-grab 1 "2023-02-01" Ronin "User Manuals"
 
+## NAME
+
+ronin-banner-grab - Fetches the banner from one or more TCP services
+
 ## SYNOPSIS
 
 `ronin banner-grab` [*options*] {*HOST*:*PORT*} ...
@@ -11,18 +15,18 @@ Fetches the banner from one or more TCP services.
 ## ARGUMENTS
 
 *HOST*:*PORT*
-  A TCP service to fetch the banner from.
+: A TCP service to fetch the banner from.
 
 ## OPTIONS
 
 `-f`, `--file` *FILE*
-  Optional file to read target values from.
+: Optional file to read target values from.
 
 `--with-host-port`
-  Print the service with each banner.
+: Print the service with each banner.
 
 `-h`, `--help`
-  Print help information.
+: Print help information.
 
 ## AUTHOR
 
@@ -30,4 +34,4 @@ Postmodern <postmodern.mod3@gmail.com>
 
 ## SEE ALSO
 
-ronin-cert-grab(1)
+[ronin-cert-grab](ronin-cert-grab.1.md)