ronin 1.5.1 → 2.0.0.beta1

data/man/ronin-asn.1.md

@@ -0,0 +1,86 @@
+# ronin-asn 1 "May 2022" Ronin "User Manuals"
+
+## SYNOPSIS
+
+`ronin asn` [*options*] [`-v` \| `--enum-ips`] {`-n`,`--number` *NUMBER* \| `-c`,`--country` *COUNTRY* \| `-N`,`--name` *NAME* \| `-I`,`--ip` *IP*}
+
+## DESCRIPTION
+
+Queries ASN information for the given *IP* or searches for the ASN records for
+the given *NUMBER*, *NAME*, or *COUNTRY* code.
+
+## OPTIONS
+
+`-v`, `--verbose`
+  Prints multi-line human readable output.
+
+`-U`, `--ur`l *URI*
+  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
+  `~/.cache/ronin/ronin-support/ip2asn-combined.tsv.gz`.
+
+`-u`, `--update`
+  Updates the ASN list file.
+
+`-n`, `--number` *NUM*\|AS*NUM*
+  Searches for all ASN records with the AS number.
+
+`-C`, `--country-code` *XX*|`None`|`Uknown`
+  Searches for all ASN records with the country code.
+
+`-N`, `--name` *NAME*
+  Searches for all ASN records with the matching name.
+
+`-I`, `--ip` *IP*
+  Queries the ASN record for the IP.
+
+`-4`, `--ipv4`
+  Filters ASN records for only IPv4 ranges.
+
+`-6`, `--ipv6`
+  Filter ASN records for only IPv6 ranges.
+
+`-E`, `--enum-ips`
+  Enumerate over the IPs within the ASN ranges.
+
+`-h`, `--help`
+  Print help information
+
+## EXAMPLES
+
+Print verbose output for all ASN records for `AS15133`:
+
+        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
+
+Prints all ASN records for the given country code:
+
+        ronin asn -C US
+
+Prints all ASN records for the given ISP:
+
+        ronin asn -N EDGECAST
+
+Enumerate over the IP addresses in the IP range for `AS15133`:
+
+        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
+
+## FILES
+
+`~/.cache/ronin/ronin-support/ip2asn-combined.tsv.gz`
+  The location of the downloaded ASN list.
+
+## AUTHOR
+
+Postmodern <postmodern.mod3@gmail.com>
+

data/man/ronin-banner-grab.1

@@ -0,0 +1,45 @@
+.\" Generated by kramdown-man 0.1.8
+.\" https://github.com/postmodern/kramdown-man#readme
+.TH ronin-banner-grab 1 "May 2022" Ronin "User Manuals"
+.LP
+.SH SYNOPSIS
+.LP
+.HP
+\fBronin banner-grab\fR \[lB]\fIoptions\fP\[rB] \[lC]\fIHOST\fP:\fIPORT\fP\[rC] \.\.\.
+.LP
+.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
+Optional file to read target values from\.
+.LP
+.TP
+\fB--with-host-port\fR
+Print the service with each banner\.
+.LP
+.TP
+\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)

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

@@ -0,0 +1,33 @@
+# ronin-banner-grab 1 "May 2022" Ronin "User Manuals"
+
+## SYNOPSIS
+
+`ronin banner-grab` [*options*] {*HOST*:*PORT*} ...
+
+## DESCRIPTION
+
+Fetches the banner from one or more TCP services.
+
+## ARGUMENTS
+
+*HOST*:*PORT*
+  A TCP service to fetch the banner from.
+
+## OPTIONS
+
+`-f`, `--file` *FILE*
+  Optional file to read target values from.
+
+`--with-host-port`
+  Print the service with each banner.
+
+`-h`, `--help`
+  Print help information.
+
+## AUTHOR
+
+Postmodern <postmodern.mod3@gmail.com>
+
+## SEE ALSO
+
+ronin-cert-grab(1)

data/man/ronin-bitflip.1

@@ -0,0 +1,123 @@
+.\" Generated by kramdown-man 0.1.8
+.\" https://github.com/postmodern/kramdown-man#readme
+.TH ronin-bitflip 1 "May 2022" Ronin "User Manuals"
+.LP
+.SH SYNOPSIS
+.LP
+.HP
+\fBronin bitflip\fR \[lB]\fIoptions\fP\[rB] \[lB]\fISTRING\fP \.\.\.\[rB]
+.LP
+.SH DESCRIPTION
+.LP
+.PP
+Prints every bit\-flip of the given string(s)\.
+.LP
+.SH ARGUMENTS
+.LP
+.TP
+\fISTRING\fP
+A string value to print all of the bit\-flips of\.
+.LP
+.SH OPTIONS
+.LP
+.TP
+\fB-N\fR, \fB--numeric\fR
+Searches for numeric characters (0\-9)\.
+.LP
+.TP
+\fB-O\fR, \fB--octal\fR
+Searches for octal characters (0\-7)\.
+\fB-X\fR, \fB--upper-hex\fR
+Searches for uppercase hexadecimal (0\-9, A\-F)\.
+.LP
+.TP
+\fB-x\fR, \fB--lower-hex\fR
+Searches for lowercase hexadecimal (0\-9, a\-f)\.
+.LP
+.TP
+\fB-H\fR, \fB--hex\fR
+Searches for hexadecimal chars (0\-9, a\-f, A\-F)\.
+.LP
+.TP
+\fB--upper-alpha\fR
+Searches for uppercase alpha chars (A\-Z)\.
+.LP
+.TP
+\fB--lower-alpha\fR
+Searches for lowercase alpha chars (a\-z)\.
+.LP
+.TP
+\fB-A\fR, \fB--alpha\fR
+Searches for alpha chars (a\-z, A\-Z)\.
+.LP
+.TP
+\fB--alpha-num\fR
+Searches for alpha\-numeric chars (a\-z, A\-Z, 0\-9)\.
+.LP
+.TP
+\fB-P\fR, \fB--punct\fR
+Searches for punctuation chars\.
+.LP
+.TP
+\fB-S\fR, \fB--symbols\fR
+Searches for symbolic chars\.
+.LP
+.TP
+\fB-s\fR, \fB--space\fR
+Searches for all whitespace chars\.
+.LP
+.TP
+\fB-v\fR, \fB--visible\fR
+Searches for all visible chars\.
+.LP
+.TP
+\fB-p\fR, \fB--printable\fR
+Searches for all printable chars\.
+.LP
+.TP
+\fB-C\fR, \fB--control\fR
+Searches for all control chars (\ex00\-\ex1f, \ex7f)\.
+.LP
+.TP
+\fB-a\fR, \fB--signed-ascii\fR
+Searches for all signed ASCII chars (\ex00\-\ex7f)\.
+.LP
+.TP
+\fB--ascii\fR
+Searches for all ASCII chars (\ex00\-\exff)\.
+.LP
+.TP
+\fB-c\fR, \fB--chars\fR \fICHARS\fP
+Searches for all chars in the custom char\-set\.
+.LP
+.TP
+\fB-i\fR, \fB--include-chars\fR \fICHARS\fP
+Include the additional chars to the char\-set\.
+.LP
+.TP
+\fB-e\fR, \fB--exclude-chars\fR \fICHARS\fP
+Exclude the additional chars from the char\-set\.
+.LP
+.TP
+\fB--prepend\fR \fISTRING\fP
+Prepends another \fISTRING\fP to each bit\-flipped value\.
+.LP
+.TP
+\fB--append\fR \fISTRING\fP
+Appends another \fISTRING\fP to each bit\-flipped value\.
+.LP
+.TP
+\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\-typo(1) ronin\-homoglyph(1)

data/man/ronin-bitflip.1.md

@@ -0,0 +1,92 @@
+# ronin-bitflip 1 "May 2022" Ronin "User Manuals"
+
+## SYNOPSIS
+
+`ronin bitflip` [*options*] [*STRING* ...]
+
+## DESCRIPTION
+
+Prints every bit-flip of the given string(s).
+
+## ARGUMENTS
+
+*STRING*
+  A string value to print all of the bit-flips of.
+
+## OPTIONS
+
+`-N`, `--numeric`
+  Searches for numeric characters (0-9).
+
+`-O`, `--octal`
+  Searches for octal characters (0-7).
+`-X`, `--upper-hex`
+  Searches for uppercase hexadecimal (0-9, A-F).
+
+`-x`, `--lower-hex`
+  Searches for lowercase hexadecimal (0-9, a-f).
+
+`-H`, `--hex`
+  Searches for hexadecimal chars (0-9, a-f, A-F).
+
+`--upper-alpha`
+  Searches for uppercase alpha chars (A-Z).
+
+`--lower-alpha`
+  Searches for lowercase alpha chars (a-z).
+
+`-A`, `--alpha`
+  Searches for alpha chars (a-z, A-Z).
+
+`--alpha-num`
+  Searches for alpha-numeric chars (a-z, A-Z, 0-9).
+
+`-P`, `--punct`
+  Searches for punctuation chars.
+
+`-S`, `--symbols`
+  Searches for symbolic chars.
+
+`-s`, `--space`
+  Searches for all whitespace chars.
+
+`-v`, `--visible`
+  Searches for all visible chars.
+
+`-p`, `--printable`
+  Searches for all printable chars.
+
+`-C`, `--control`
+  Searches for all control chars (\x00-\x1f, \x7f).
+
+`-a`, `--signed-ascii`
+  Searches for all signed ASCII chars (\x00-\x7f).
+
+`--ascii`
+  Searches for all ASCII chars (\x00-\xff).
+
+`-c`, `--chars` *CHARS*
+  Searches for all chars in the custom char-set.
+
+`-i`, `--include-chars` *CHARS*
+  Include the additional chars to the char-set.
+
+`-e`, `--exclude-chars` *CHARS*
+  Exclude the additional chars from the char-set.
+
+`--prepend` *STRING*
+  Prepends another *STRING* to each bit-flipped value.
+
+`--append` *STRING*
+  Appends another *STRING* to each bit-flipped value.
+
+`-h`, `--help`
+  Print help information.
+
+## AUTHOR
+
+Postmodern <postmodern.mod3@gmail.com>
+
+## SEE ALSO
+
+ronin-typo(1) ronin-homoglyph(1)

data/man/ronin-cert-dump.1

@@ -0,0 +1,99 @@
+.\" Generated by kramdown-man 0.1.8
+.\" https://github.com/postmodern/kramdown-man#readme
+.TH ronin-cert-dump 1 "May 2022" Ronin "User Manuals"
+.LP
+.SH SYNOPSIS
+.LP
+.HP
+\fBronin cert-dump\fR \[lB]\fIoptions\fP\[rB] \[lC]\fIHOST\fP:\fIPORT\fP \[or] \fIURL\fP \[or] \fIFILE\fP\[rC] \.\.\.
+.LP
+.SH DESCRIPTION
+.LP
+.PP
+Prints SSL\[sl]TLS certificate information for one or more SSL\[sl]TLS services,
+\fBhttps://\fR URLs, or certificate files\.
+.LP
+.SH ARGUMENTS
+.LP
+.TP
+\fIHOST\fP:\fIPORT\fP
+A remote TCP service to retrieve the SSL\[sl]TLS certificate from and print\.
+.LP
+.TP
+\fIURL\fP
+An URL to retrieve the SSL\[sl]TLS certificate from and print\.
+.LP
+.TP
+\fIFILE\fP
+A SSL\[sl]TLS certificate file to print\.
+.LP
+.SH OPTIONS
+.LP
+.TP
+\fB-f\fR, \fB--file\fR \fIFILE\fP
+Optional file to read target values from\.
+.LP
+.TP
+\fB-C\fR, \fB--common-name\fR
+Only prints the Common Name (CN) for each certificate\.
+.LP
+.TP
+\fB-A\fR, \fB--subject-alt-names\fR
+Only prints the \fBsubjectAltName\fRs for each certificate\.
+.LP
+.TP
+\fB-E\fR, \fB--extensions\fR
+Also prints the extensions for each certificate\.
+.LP
+.TP
+\fB-h\fR, \fB--help\fR
+Print help information\.
+.LP
+.SH EXAMPLES
+.LP
+.PP
+Print the certificate information for the cert file:
+.LP
+.nf
+ronin cert\-dump ssl\.crt
+.fi
+.LP
+.PP
+Print the certificate information for a SSL\[sl]TLS service:
+.LP
+.nf
+ronin cert\-dump github\.com:443
+.fi
+.LP
+.PP
+Print the certificate information for a URL:
+.LP
+.nf
+ronin cert\-dump https:\[sl]\[sl]github\.com
+.fi
+.LP
+.PP
+Only print the Common Nmae (CN) for a SSL\[sl]TLS service:
+.LP
+.nf
+ronin cert\-dump \-C 93\.184\.216\.34:443
+.fi
+.LP
+.PP
+Only print the \fBsubjectAltName\fRs for a SSL\[sl]TLS service:
+.LP
+.nf
+ronin cert\-dump \-A wired\.com:443
+.fi
+.LP
+.SH AUTHOR
+.LP
+.PP
+Postmodern 
+.MT postmodern\.mod3\[at]gmail\.com
+.ME
+.LP
+.SH SEE ALSO
+.LP
+.PP
+ronin\-cert\-grab(1) ronin\-cert\-gen(1)

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

@@ -0,0 +1,68 @@
+# ronin-cert-dump 1 "May 2022" Ronin "User Manuals"
+
+## SYNOPSIS
+
+`ronin cert-dump` [*options*] {*HOST*:*PORT* \| *URL* \| *FILE*} ...
+
+## DESCRIPTION
+
+Prints SSL/TLS certificate information for one or more SSL/TLS services,
+`https://` URLs, or certificate files.
+
+## ARGUMENTS
+
+*HOST*:*PORT*
+  A remote TCP service to retrieve the SSL/TLS certificate from and print.
+
+*URL*
+  An URL to retrieve the SSL/TLS certificate from and print.
+
+*FILE*
+  A SSL/TLS certificate file to print.
+
+## OPTIONS
+
+`-f`, `--file` *FILE*
+  Optional file to read target values from.
+
+`-C`, `--common-name`
+  Only prints the Common Name (CN) for each certificate.
+
+`-A`, `--subject-alt-names`
+  Only prints the `subjectAltName`s for each certificate.
+
+`-E`, `--extensions`
+  Also prints the extensions for each certificate.
+
+`-h`, `--help`
+  Print help information.
+
+## EXAMPLES
+
+Print the certificate information for the cert file:
+
+    ronin cert-dump ssl.crt
+
+Print the certificate information for a SSL/TLS service:
+
+    ronin cert-dump github.com:443
+
+Print the certificate information for a URL:
+
+    ronin cert-dump https://github.com
+
+Only print the Common Nmae (CN) for a SSL/TLS service:
+
+    ronin cert-dump -C 93.184.216.34:443
+
+Only print the `subjectAltName`s for a SSL/TLS service:
+
+    ronin cert-dump -A wired.com:443
+
+## AUTHOR
+
+Postmodern <postmodern.mod3@gmail.com>
+
+## SEE ALSO
+
+ronin-cert-grab(1) ronin-cert-gen(1)

data/man/ronin-cert-gen.1

@@ -0,0 +1,144 @@
+.\" Generated by kramdown-man 0.1.8
+.\" https://github.com/postmodern/kramdown-man#readme
+.TH ronin-cert-gen 1 "May 2022" Ronin "User Manuals"
+.LP
+.SH SYNOPSIS
+.LP
+.HP
+\fBronin cert-gen\fR \[lB]\fIoptions\fP\[rB]
+.LP
+.SH DESCRIPTION
+.LP
+.PP
+Generates a new X509 certificate\.
+.LP
+.SH OPTIONS
+.LP
+.TP
+\fB--version\fR \fINUM\fP
+The certificate version number Defaults to \fB2\fR if not given\.
+.LP
+.TP
+\fB--serial\fR \fINUM\fP
+The certificate serial number Defaults to \fB0\fR if not given\.
+.LP
+.TP
+\fB--not-before\fR \fITIME\fP
+When the certificate becomes valid\. Defaults to the current time\.
+.LP
+.TP
+\fB--not-after\fR \fITIME\fP
+When the certificate becomes no longer valid\. Defaults to one year from now\.
+.LP
+.TP
+\fB-c\fR, \fB--common-name\fR \fIDOMAIN\fP
+The Common Name (CN) for the certificate\.
+.LP
+.TP
+\fB-A\fR, \fB--subject-alt-name\fR \fIHOST\fP\[or]\fIIP\fP
+Adds HOST or IP to \fBsubjectAltName\fR\.
+.LP
+.TP
+\fB-O\fR, \fB--organization\fR \fINAME\fP
+The Organization (O) for the certificate\.
+.LP
+.TP
+\fB-U\fR, \fB--organizational-unit\fR \fINAME\fP
+The Organizational Unit (OU)\.
+.LP
+.TP
+\fB-L\fR, \fB--locality\fR \fINAME\fP
+The locality for the certificate\.
+.LP
+.TP
+\fB-S\fR, \`\-\-state \fIXX\fP
+The two\-letter State (ST) code for the certificate\.
+.LP
+.TP
+\fB-C\fR, \fB--country\fR \fIXX\fP
+The two\-letter Country (C) code for the certificate\.
+.LP
+.HP
+\fB-t\fR, \fB--key-type\fR rsa\[or]ec\fB            The signing key type
+    --generate-key PATH          Generates and saves a random key (Default: key.pem)
+-k, --key-file FILE              Loads the signing key from the FILE
+\fR\-H\fB, \fR\-\-signing\-hash\fB \fRsha256\fB\|\fRsha1\fB\|\fRmd5\fB
+  The hash algorithm to use for signing. Defaults to \fRsha256\` if not given\.
+.LP
+.TP
+\fB--ca-key\fR \fIFILE\fP
+The Certificate Authority (CA) key\.
+.LP
+.TP
+\fB--ca-cert\fR \fIFILE\fP
+The Certificate Authority (CA) certificate\.
+.LP
+.TP
+\fB--ca\fR
+Generates a CA certificate\.
+.LP
+.TP
+\fB-o\fR, \fB--output\fR \fIFILE\fP
+The output file to save the generated certificate to\. Defaults to \fBcert.crt\fR
+if not given\.
+.LP
+.TP
+\fB-h\fR, \fB--help\fR
+Print help information\.
+.LP
+.SH EXAMPLES
+.LP
+.PP
+Generates self\-signed certificate in \fBcert.crt\fR and a new private key in \fBkey.pem\fR:
+.LP
+.nf
+    ronin cert\[ru]gen \-c test\.com \-O \[dq]Test Co\[dq] \-U \[dq]Test Dept\[dq] \e
+                   \-L \[dq]Test City\[dq] \-S NY \-C US
+.fi
+.LP
+.PP
+Generates a new self\-signed certificate for \fBtest.com\fR in \fBcert.crt\fR using the private key in
+\fBprivate.key\fR:
+.LP
+.nf
+    ronin cert\[ru]gen \-c test\.com \-O \[dq]Test Co\[dq] \-U \[dq]Test Dept\[dq] \e
+                   \-L \[dq]Test City\[dq] \-S NY \-C US \e
+                   \-\-key\-file private\.key
+.fi
+.LP
+.PP
+Generates a new self\-signed certificate with a alternative name \fBwww.test.com\fR:
+.LP
+.nf
+    ronin cert\[ru]gen \-c test\.com \-A www\.test\.com \-O \[dq]Test Co\[dq] \-U \[dq]Test Dept\[dq] \e
+                   \-L \[dq]Test City\[dq] \-S NY \-C US
+.fi
+.LP
+.PP
+Generates a new CA certificate which can sign other certificates:
+.LP
+.nf
+    ronin cert\[ru]gen \-\-ca \-c \[dq]Test CA\[dq] \-O \[dq]Test Co\[dq] \-U \[dq]Test Dept\[dq] \e
+                   \-L \[dq]Test City\[dq] \-S NY \-C US
+.fi
+.LP
+.PP
+Generates a new sub\-certificate using the CA certificate \fBca.crt\fR and signing key \fBca.key\fR:
+.LP
+.nf
+    ronin cert\[ru]gen \-c test\.com \-O \[dq]Test Co\[dq] \-U \[dq]Test Dept\[dq] \e
+                   \-L \[dq]Test City\[dq] \-S NY \-C US \e
+                   \-\-ca\-key ca\.key \-\-ca\-cert ca\.crt
+.fi
+.LP
+.SH AUTHOR
+.LP
+.PP
+Postmodern 
+.MT postmodern\.mod3\[at]gmail\.com
+.ME
+.LP
+.SH SEE ALSO
+.LP
+.PP
+ronin\-cert\-grab(1) ronin\-cert\-dump(1)