ronin 1.5.1 → 2.0.0.beta2

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)

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

@@ -0,0 +1,104 @@
+# ronin-cert-gen 1 "May 2022" Ronin "User Manuals"
+
+## SYNOPSIS
+
+`ronin cert-gen` [*options*]
+
+## DESCRIPTION
+
+Generates a new X509 certificate.
+
+## OPTIONS
+
+`--version` *NUM*
+  The certificate version number Defaults to `2` if not given.
+
+`--serial` *NUM*
+  The certificate serial number Defaults to `0` if not given.
+
+`--not-before` *TIME*
+  When the certificate becomes valid. Defaults to the current time.
+
+`--not-after` *TIME*
+  When the certificate becomes no longer valid. Defaults to one year from now.
+
+`-c`, `--common-name` *DOMAIN*
+  The Common Name (CN) for the certificate.
+
+`-A`, `--subject-alt-name` *HOST*\|*IP*
+  Adds HOST or IP to `subjectAltName`.
+
+`-O`, `--organization` *NAME*
+  The Organization (O) for the certificate.
+
+`-U`, `--organizational-unit` *NAME*
+  The Organizational Unit (OU).
+
+`-L`, `--locality` *NAME*
+  The locality for the certificate.
+
+`-S`, `--state *XX*
+  The two-letter State (ST) code for the certificate.
+
+`-C`, `--country` *XX*
+  The two-letter Country (C) code for the certificate.
+
+`-t`, `--key-type` rsa|ec`            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
+`-H`, `--signing-hash` `sha256`\|`sha1`\|`md5`
+  The hash algorithm to use for signing. Defaults to `sha256` if not given.
+
+`--ca-key` *FILE*
+  The Certificate Authority (CA) key.
+
+`--ca-cert` *FILE*
+  The Certificate Authority (CA) certificate.
+
+`--ca`
+  Generates a CA certificate.
+
+`-o`, `--output` *FILE*
+  The output file to save the generated certificate to. Defaults to `cert.crt`
+  if not given.
+
+`-h`, `--help`
+  Print help information.
+
+## EXAMPLES
+
+Generates self-signed certificate in `cert.crt` and a new private key in `key.pem`:
+
+        ronin cert_gen -c test.com -O "Test Co" -U "Test Dept" \
+                       -L "Test City" -S NY -C US
+
+Generates a new self-signed certificate for `test.com` in `cert.crt` using the private key in
+`private.key`:
+
+        ronin cert_gen -c test.com -O "Test Co" -U "Test Dept" \
+                       -L "Test City" -S NY -C US \
+                       --key-file private.key
+
+Generates a new self-signed certificate with a alternative name `www.test.com`:
+
+        ronin cert_gen -c test.com -A www.test.com -O "Test Co" -U "Test Dept" \
+                       -L "Test City" -S NY -C US
+
+Generates a new CA certificate which can sign other certificates:
+
+        ronin cert_gen --ca -c "Test CA" -O "Test Co" -U "Test Dept" \
+                       -L "Test City" -S NY -C US
+
+Generates a new sub-certificate using the CA certificate `ca.crt` and signing key `ca.key`:
+
+        ronin cert_gen -c test.com -O "Test Co" -U "Test Dept" \
+                       -L "Test City" -S NY -C US \
+                       --ca-key ca.key --ca-cert ca.crt
+
+## AUTHOR
+
+Postmodern <postmodern.mod3@gmail.com>
+
+## SEE ALSO
+
+ronin-cert-grab(1) ronin-cert-dump(1)

data/man/ronin-cert-grab.1

@@ -0,0 +1,68 @@
+.\" Generated by kramdown-man 0.1.8
+.\" https://github.com/postmodern/kramdown-man#readme
+.TH ronin-cert-grab 1 "May 2022" Ronin "User Manuals"
+.LP
+.SH SYNOPSIS
+.LP
+.HP
+\fBronin cert-grab\fR \[lB]\fIoptions\fP\[rB] \[lC]\fIHOST\fP:\fIPORT\fP \[or] \fIURL\fP\[rC] \.\.\.
+.LP
+.SH DESCRIPTION
+.LP
+.PP
+Downloads SSL\[sl]TLS certificates for a SSL\[sl]TLS TCP or \fBhttps://\fR URL\.
+.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
+.SH OPTIONS
+.LP
+.TP
+\fB-f\fR, \fB--file\fR \fIFILE\fP
+Optional file to read target values from\.
+.LP
+.TP
+\fB-h\fR, \fB--help\fR
+Print help information\.
+.LP
+.SH EXAMPLES
+.LP
+.PP
+Downloads the SSL\[sl]TLS certificate for a SSL\[sl]TLS service:
+.LP
+.nf
+ronin cert\-grab github\.com:443
+.fi
+.LP
+.PP
+Downloads the SSL\[sl]TLS certificate running on the IP and port:
+.LP
+.nf
+ronin cert\-grab 93\.184\.216\.34:443
+.fi
+.LP
+.PP
+Downloads the SSL\[sl]TLS certificate used by the URL:
+.LP
+.nf
+ronin cert\-grab https:\[sl]\[sl]github\.com\[sl]
+.fi
+.LP
+.SH AUTHOR
+.LP
+.PP
+Postmodern 
+.MT postmodern\.mod3\[at]gmail\.com
+.ME
+.LP
+.SH SEE ALSO
+.LP
+.PP
+ronin\-cert\-dump(1) ronin\-cert\-gen(1)

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

@@ -0,0 +1,47 @@
+# ronin-cert-grab 1 "May 2022" Ronin "User Manuals"
+
+## SYNOPSIS
+
+`ronin cert-grab` [*options*] {*HOST*:*PORT* \| *URL*} ...
+
+## DESCRIPTION
+
+Downloads SSL/TLS certificates for a SSL/TLS TCP or `https://` URL.
+
+## 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.
+
+## OPTIONS
+
+`-f`, `--file` *FILE*
+  Optional file to read target values from.
+
+`-h`, `--help`
+  Print help information.
+
+## EXAMPLES
+
+Downloads the SSL/TLS certificate for a SSL/TLS service:
+
+    ronin cert-grab github.com:443
+
+Downloads the SSL/TLS certificate running on the IP and port:
+
+    ronin cert-grab 93.184.216.34:443
+
+Downloads the SSL/TLS certificate used by the URL:
+
+    ronin cert-grab https://github.com/
+
+## AUTHOR
+
+Postmodern <postmodern.mod3@gmail.com>
+
+## SEE ALSO
+
+ronin-cert-dump(1) ronin-cert-gen(1)

data/man/ronin-decode.1

@@ -0,0 +1,103 @@
+.\" Generated by kramdown-man 0.1.8
+.\" https://github.com/postmodern/kramdown-man#readme
+.TH ronin-decode 1 "May 2022" Ronin "User Manuals"
+.LP
+.SH SYNOPSIS
+.LP
+.HP
+\fBronin decode \fR \[lB]\fIoptions\fP\[rB] \[lB]\fIFILE\fP \.\.\.\[rB]
+.LP
+.SH DESCRIPTION
+.LP
+.PP
+Decodes each character of the given data from a variety of formats\.
+.LP
+.SH ARGUMENTS
+.LP
+.TP
+\fIFILE\fP
+The optional file to read and process\. If no \fIFILE\fP arguments are given,
+input will be read from \fBstdin\fR\.
+.LP
+.SH OPTIONS
+.LP
+.TP
+\fB-f\fR, \fB--file\fR \fIFILE\fP
+Optional file to process\.
+.LP
+.TP
+\fB--string\fR \fISTRING\fP
+Optional string to process\.
+.LP
+.TP
+\fB-M\fR, \fB--multiline\fR
+Process each line of input separately\.
+.LP
+.TP
+\fB-n\fR, \fB--keep-newlines\fR
+Preserves newlines at the end of each line\.
+.LP
+.TP
+\fB--base32\fR
+Base32 decodes the data\.
+.LP
+.HP
+\fB-b\fR, \fB--base64\fR\[lB]\fB=\fR\fIstrict\fP\[or]\fIurl\fP\[rB]
+Base64 decodes the data\. If the \fBstrict\fR or \fBurl\fR option value is given,
+it will enable \fBstrict\fR or \fBurl\fR Base64 encoding mode, respectively\.
+.LP
+.HP
+\fB-c, \fR\-\-c\`
+Decodes the data as a C string\.
+.LP
+.TP
+\fB-X\fR, \fB--hex\fR
+Hex decode the data (ex: \fB414141...\fR)\.
+.LP
+.TP
+\fB-H\fR, \fB--html\fR
+HTML decodes the data\.
+.LP
+.TP
+\fB-u\fR, \fB--uri\fR
+URI decodes the data\.
+.LP
+.TP
+\fB--http\fR
+HTTP decodes the data\.
+.LP
+.TP
+\fB-j\fR, \fB--js\fR
+JavaScript decodes the data\.
+.LP
+.TP
+\fB-S\fR, \fB--shell\fR
+Decodes the data as a Shell String\.
+.LP
+.TP
+\fB-P\fR, \fB--powershell\fR
+Decodes the data as a PowerShell String\.
+.LP
+.TP
+\fB-R\fR, \fB--ruby\fR
+Ruby decodes the data\.
+.LP
+.TP
+\fB-x\fR, \fB--xml\fR
+XML decodes the data\.
+.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\-encode(1)

data/man/ronin-decode.1.md

@@ -0,0 +1,77 @@
+# ronin-decode 1 "May 2022" Ronin "User Manuals"
+
+## SYNOPSIS
+
+`ronin decode ` [*options*] [*FILE* ...]
+
+## DESCRIPTION
+
+Decodes each character of the given data from a variety of formats.
+
+## ARGUMENTS
+
+*FILE*
+  The optional file to read and process. If no *FILE* arguments are given,
+  input will be read from `stdin`.
+
+## OPTIONS
+
+`-f`, `--file` *FILE*
+  Optional file to process.
+
+`--string` *STRING*
+  Optional string to process.
+
+`-M`, `--multiline`
+  Process each line of input separately.
+
+`-n`, `--keep-newlines`
+  Preserves newlines at the end of each line.
+
+`--base32`
+  Base32 decodes the data.
+
+`-b`, `--base64`[`=`*strict*\|*url*]
+  Base64 decodes the data. If the `strict` or `url` option value is given,
+  it will enable `strict` or `url` Base64 encoding mode, respectively.
+
+`-c, `--c`
+  Decodes the data as a C string.
+
+`-X`, `--hex`
+  Hex decode the data (ex: `414141...`).
+
+`-H`, `--html`
+  HTML decodes the data.
+
+`-u`, `--uri`
+  URI decodes the data.
+
+`--http`
+  HTTP decodes the data.
+
+`-j`, `--js`
+  JavaScript decodes the data.
+
+`-S`, `--shell`
+  Decodes the data as a Shell String.
+
+`-P`, `--powershell`
+  Decodes the data as a PowerShell String.
+
+`-R`, `--ruby`
+  Ruby decodes the data.
+
+`-x`, `--xml`
+  XML decodes the data.
+
+`-h`, `--help`
+  Print help information.
+
+## AUTHOR
+
+Postmodern <postmodern.mod3@gmail.com>
+
+## SEE ALSO
+
+ronin-encode(1)

data/man/ronin-decrypt.1

@@ -0,0 +1,75 @@
+.\" Generated by kramdown-man 0.1.8
+.\" https://github.com/postmodern/kramdown-man#readme
+.TH ronin-decrypt 1 "May 2022" Ronin "User Manuals"
+.LP
+.SH SYNOPSIS
+.LP
+.HP
+\fBronin decrypt\fR \[lB]\fIoptions\fP\[rB] \[lB]\fIFILE\fP \.\.\.\[rB]
+.LP
+.SH DESCRIPTION
+.LP
+.PP
+Encrypts data\.
+.LP
+.SH ARGUMENTS
+.LP
+.TP
+\fIFILE\fP
+The optional file to read and decrypt\. If no \fIFILE\fP arguments are given,
+input will be read from \fBstdin\fR\.
+.LP
+.SH OPTIONS
+.LP
+.TP
+\fB-k\fR, \fB--key\fR \fISTRING\fP
+The raw key string for the cipher\.
+.LP
+.TP
+\fB-K\fR, \fB--key-file\fR \fIFILE\fP
+Reads the key string from the file\.
+.LP
+.TP
+\fB-c\fR, \fB--cipher\fR \fINAME\fP
+The cipher to decrypt with\. See \fB--list-ciphers\fR for a list of supported
+ciphers\. Default to \fBaes-256-cbc\fR if not given\.
+.LP
+.TP
+\fB-P\fR, \fB--password\fR \fIPASSWORD\fP
+The password to decrypt with\.
+.LP
+.TP
+\fB-H\fR, \fB--hash\fR \fBmd5\fR\[or]\fBsha1\fR\[or]\fBsha256\fR\[or]\fBsha512\fR
+The hash algorithm to use for the password\. Default to \fBsha256\fR if not given\.
+.LP
+.TP
+\fB--iv\fR \fISTRING\fP
+Sets the Initial Vector (IV) value of the cipher\.
+.LP
+.TP
+\fB--padding\fR \fINUM\fP
+Sets the padding size, in bytes, of the decryption cipher\.
+.LP
+.TP
+\fB-b\fR, \fB--block-size\fR \fINUM\fP
+The size, in bytes, to read data in\. Default to \fB16384\fR if not given\.
+.LP
+.TP
+\fB--list-ciphers\fR
+List the supported ciphers and exits\.
+.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\-encrypt(1)

data/man/ronin-decrypt.1.md

@@ -0,0 +1,56 @@
+# ronin-decrypt 1 "May 2022" Ronin "User Manuals"
+
+## SYNOPSIS
+
+`ronin decrypt` [*options*] [*FILE* ...]
+
+## DESCRIPTION
+
+Encrypts data.
+
+## ARGUMENTS
+
+*FILE*
+  The optional file to read and decrypt. If no *FILE* arguments are given,
+  input will be read from `stdin`.
+
+## OPTIONS
+
+`-k`, `--key` *STRING*
+  The raw key string for the cipher.
+
+`-K`, `--key-file` *FILE*
+  Reads the key string from the file.
+
+`-c`, `--cipher` *NAME*
+  The cipher to decrypt with. See `--list-ciphers` for a list of supported
+  ciphers. Default to `aes-256-cbc` if not given.
+
+`-P`, `--password` *PASSWORD*
+  The password to decrypt with.
+
+`-H`, `--hash` `md5`\|`sha1`\|`sha256`\|`sha512`
+  The hash algorithm to use for the password. Default to `sha256` if not given.
+
+`--iv` *STRING*
+  Sets the Initial Vector (IV) value of the cipher.
+
+`--padding` *NUM*
+  Sets the padding size, in bytes, of the decryption cipher.
+
+`-b`, `--block-size` *NUM*
+  The size, in bytes, to read data in. Default to `16384` if not given.
+
+`--list-ciphers`
+  List the supported ciphers and exits.
+
+`-h`, `--help`
+  Print help information.
+
+## AUTHOR
+
+Postmodern <postmodern.mod3@gmail.com>
+
+## SEE ALSO
+
+ronin-encrypt(1)

data/man/ronin-dns.1

@@ -0,0 +1,45 @@
+.\" Generated by kramdown-man 0.1.8
+.\" https://github.com/postmodern/kramdown-man#readme
+.TH ronin-dns 1 "May 2022" Ronin "User Manuals"
+.LP
+.SH SYNOPSIS
+.LP
+.HP
+\fBronin dns\fR \[lB]\fIoptions\fP\[rB] \[lB]\fIHOST\fP\[rB]
+.LP
+.SH DESCRIPTION
+.LP
+.PP
+Queries DNS records for the given host name\.
+.LP
+.SH ARGUMENTS
+.LP
+.TP
+\fIHOST\fP
+A host name argument to query\.
+.LP
+.SH OPTIONS
+.LP
+.TP
+\fB-f\fR, \fB--file\fR \fIFILE\fP
+The optional file to read values from\.
+.LP
+.TP
+\fB-N\fR, \fB--nameserver\fR \fIHOST\fP\[or]\fIIP\fP
+Send DNS queries to the nameserver\.
+.LP
+.TP
+\fB-t\fR, \fB--type\fR \fBA|AAAA|ANY|CNAME|HINFO|LOC|MINFO|MX|NS|PTR|SOA|SRV|TXT|WKS\fR
+The type of record to query\.
+.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