ronin 2.0.1 → 2.0.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 42aeafda3468e4c0f5427a4f2323d40b96bb4aaafc042bb8380d569f5c8c5414
-  data.tar.gz: a150c7211fa93770dc9be47343f8f3d3391396996885263580c0185742476255
+  metadata.gz: 31356f467f009277f4c840fb645f3f64bfba3c6d9e1cf1b1bef2dee177dc4b96
+  data.tar.gz: 4cce57a146892ac6b05bf6a41aa35467d50e307c74ed6150cfdf05234aa177f2
 SHA512:
-  metadata.gz: 562df97d739aedfad72706c939d40697f8ab39136a3aab69e2d67e7aa29b3ea03bf1534695f259af8060c5e09f26e6e6c51ff62c57fa8d1ad73242c0c48e9c78
-  data.tar.gz: '018c73e255ed3b3468d84c054d8b79095cef777443536beac09e572d1bf183ce0d3a019a8e45560013c13a0b8df202a7402d1c4d4cd41ff884a0179f932e51bb'
+  metadata.gz: 244f986f64b8ee769769ca050321ff3ad6ebe4de5ea7c9f7f509514e32e02d580fbd391bf65c1a35238f2b42825050082fd0a1a06c491e447462a603b7a3c9de
+  data.tar.gz: 312f52036a301608b240fd91a26f2d3632eafd1f0c193ef6127851eb43e69840c443a8f3f9608ab7ad8d522e7fb58d96e45e8e32cdfac00a59e931ed636b7d48

data/ChangeLog.md

@@ -1,3 +1,20 @@
+### 2.0.2 / 2023-06-09
+
+* Documentation fixes and improvements.
+
+#### CLI
+
+* Fixed a bug in the `ronin ip` command where empty lines would be printed
+  if the IP had no hostname.
+* Fixed a bug in the `ronin hexdump` command where the `--type` option was being
+  ignored.
+* Fixed the `Usage:` of the `ronin host` and `ronin dns` commands.
+* Fixed typos in the `ronin email-addr`, `ronin escape`, and `ronin sha256`
+  man-pages.
+* Fixed formatting in the `ronin cert-gen` man-page.
+* Added more examples to the `ronin rot`, `ronin encrypt`, and `ronin decrypt`
+  man-pages.
+
 ### 2.0.1 / 2023-03-01
 
 * Require [ronin-support] ~> 1.0, >= 1.0.1.

data/Gemfile

@@ -23,37 +23,37 @@ group :database do
 end
 
 # Library dependencies
-# gem 'ronin-support',	       '~> 1.0', github: "ronin-rb/ronin-support",
+# gem 'ronin-support',	       '~> 1.0', github: 'ronin-rb/ronin-support',
 #                                        branch: 'main'
-# gem 'ronin-core',            '~> 0.1', github: "ronin-rb/ronin-core",
+# gem 'ronin-core',            '~> 0.1', github: 'ronin-rb/ronin-core',
 #                                        branch: 'main'
-# gem 'ronin-repos',           '~> 0.1', github: "ronin-rb/ronin-repos",
+# gem 'ronin-repos',           '~> 0.1', github: 'ronin-rb/ronin-repos',
 #                                        branch: 'main'
-# gem 'ronin-db',              '~> 0.1', github: "ronin-rb/ronin-db",
+# gem 'ronin-db',              '~> 0.1', github: 'ronin-rb/ronin-db',
 #                                        branch: 'main'
-# gem 'ronin-db-activerecord', '~> 0.1', github: "ronin-rb/ronin-db-activerecord",
+# gem 'ronin-db-activerecord', '~> 0.1', github: 'ronin-rb/ronin-db-activerecord',
 #                                        branch: 'main'
-# gem 'ronin-fuzzer',          '~> 0.1', github: "ronin-rb/ronin-fuzzer",
+# gem 'ronin-fuzzer',          '~> 0.1', github: 'ronin-rb/ronin-fuzzer',
 #                                        branch: 'main'
-# gem 'ronin-post_ex',         '~> 0.1', github: "ronin-rb/ronin-post_ex",
+# gem 'ronin-post_ex',         '~> 0.1', github: 'ronin-rb/ronin-post_ex',
 #                                        branch: 'main'
-# gem 'ronin-code-asm',        '~> 1.0', github: "ronin-rb/ronin-code-asm",
+# gem 'ronin-code-asm',        '~> 1.0', github: 'ronin-rb/ronin-code-asm',
 #                                        branch: 'main'
-# gem 'ronin-code-sql',        '~> 2.0', github: "ronin-rb/ronin-code-sql",
+# gem 'ronin-code-sql',        '~> 2.0', github: 'ronin-rb/ronin-code-sql',
 #                                        branch: 'main'
-# gem 'ronin-payloads',        '~> 0.1', github: "ronin-rb/ronin-payloads",
+# gem 'ronin-payloads',        '~> 0.1', github: 'ronin-rb/ronin-payloads',
 #                                        branch: 'main'
-# gem 'ronin-exploits',        '~> 1.0', github: "ronin-rb/ronin-exploits",
+# gem 'ronin-exploits',        '~> 1.0', github: 'ronin-rb/ronin-exploits',
 #                                        branch: 'main'
-# gem 'ronin-vulns',           '~> 0.1', github: "ronin-rb/ronin-vulns",
+# gem 'ronin-vulns',           '~> 0.1', github: 'ronin-rb/ronin-vulns',
 #                                        branch: 'main'
-# gem 'ronin-web-server',      '~> 0.1', github: "ronin-rb/ronin-web-server",
+# gem 'ronin-web-server',      '~> 0.1', github: 'ronin-rb/ronin-web-server',
 #                                        branch: 'main'
-# gem 'ronin-web-spider',      '~> 0.1', github: "ronin-rb/ronin-web-spider",
+# gem 'ronin-web-spider',      '~> 0.1', github: 'ronin-rb/ronin-web-spider',
 #                                        branch: 'main'
-# gem 'ronin-web-user_agents', '~> 0.1', github: "ronin-rb/ronin-web-user_agents",
+# gem 'ronin-web-user_agents', '~> 0.1', github: 'ronin-rb/ronin-web-user_agents',
 #                                        branch: 'main'
-# gem 'ronin-web',             '~> 1.0', github: "ronin-rb/ronin-web",
+# gem 'ronin-web',             '~> 1.0', github: 'ronin-rb/ronin-web',
 #                                        branch: 'main'
 
 group :development do

data/README.md

@@ -40,7 +40,7 @@ HTTP, [scanning for web vulnerabilities][ronin-vulns-synopsis],
 
 * A toolkit of useful commands.
 * A fully-loaded Ruby REPL.
-* An ecosystem of high-quality security related Ruby libraries, API, and
+* An ecosystem of high-quality security related Ruby libraries, APIs, and
   commands.
 
 ### What can you do with Ronin?
@@ -290,25 +290,6 @@ foo bar
 
 ### Text
 
-De-obfuscate an email address:
-
-```shell
-$ ronin email-addr --deobfuscate "john [dot] smith [at] example [dot] com"
-john.smith@example.com
-```
-
-Enumerate through all of the obfuscations of an email address:
-
-```shell
-$ ronin email-addr --enum-obfuscations john.smith@example.com
-john.smith @ example.com
-john.smith AT example.com
-john.smith at example.com
-john.smith[AT]example.com
-john.smith[at]example.com
-...
-```
-
 Extract high-entropy data from a file:
 
 ```shell
@@ -386,13 +367,13 @@ Decrypt data:
 $ ronin decrypt --cipher aes-256-cbc --password "..." encrypted.bin
 ```
 
-Generates an HMAC for a file:
+Generates a HMAC for a file:
 
 ```shell
 $ ronin hmac --hash sha1 --password "too many secrets" data.txt
 ```
 
-Generates an HMAC for a string:
+Generates a HMAC for a string:
 
 ```shell
 $ ronin hmac --hash sha1 --password "too many secrets" --string "..."
@@ -657,6 +638,25 @@ example.com.bh
 ...
 ```
 
+Find all subdomains that have addresses:
+
+```shell
+$ ronin host --enum-subdomains subdomains.txt --has-addresses google.com
+www.google.com
+mail.google.com
+smtp.google.com
+ns1.google.com
+ns2.google.com
+m.google.com
+ns.google.com
+blog.google.com
+admin.google.com
+news.google.com
+vpn.google.com
+ns3.google.com
+...
+```
+
 Enumerate over every possible typosquat variation of a domain:
 
 ```shell
@@ -684,6 +684,25 @@ Find all of the unregistered typosquat domains for a valid domain:
 $ ronin typosquat --unregistered microsoft.com
 ```
 
+De-obfuscate an email address:
+
+```shell
+$ ronin email-addr --deobfuscate "john [dot] smith [at] example [dot] com"
+john.smith@example.com
+```
+
+Enumerate through all of the obfuscations of an email address:
+
+```shell
+$ ronin email-addr --enum-obfuscations john.smith@example.com
+john.smith @ example.com
+john.smith AT example.com
+john.smith at example.com
+john.smith[AT]example.com
+john.smith[at]example.com
+...
+```
+
 #### SSL/TLS Certs
 
 Dump information about a SSL/TLS certificate:
@@ -815,7 +834,7 @@ If you prefer using [Docker], there are also [Docker images] available:
 
 ```shell
 docker pull roninrb/ronin
-docker run -it ronin
+docker run -it roninrb/ronin
 ```
 
 Additionally, if you want to mount your home directory into the docker image:

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

@@ -28,7 +28,7 @@ module Ronin
       #
       # ## Usage
       #
-      #     ronin dns [options] [HOST [...]]
+      #     ronin dns [options] {HOST ... | --file FILE}
       #
       # ## Options
       #
@@ -46,7 +46,7 @@ module Ronin
 
         include DNS
 
-        usage '[options] HOST'
+        usage '[options] {HOST ... | --file FILE}'
 
         option :type, short: '-t',
                       value: {

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

@@ -417,6 +417,7 @@ module Ronin
         # List of command `options` that directly map to the keyword arguments
         # of `Hexdump.hexdump`.
         HEXDUMP_OPTIONS = [
+          :type,
           :format,
           :offset,
           :length,

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

@@ -30,7 +30,7 @@ module Ronin
       #
       # ## Usage
       #
-      #     ronin host [options] [HOST ...]
+      #     ronin host [options] {HOST ... | --file FILE}
       #
       # ## Options
       #
@@ -63,7 +63,7 @@ module Ronin
 
         include DNS
 
-        usage '[options] [HOST ...]'
+        usage '[options] {HOST ... | --file FILE}'
 
         option :subdomain, value: {
                              type:  String,
@@ -117,20 +117,20 @@ module Ronin
         option :has_records, short: '-H',
                              value: {
                                type: {
-                                 A: :a,
-                                 AAAA: :aaaa,
-                                 ANY: :any,
+                                 A:     :a,
+                                 AAAA:  :aaaa,
+                                 ANY:   :any,
                                  CNAME: :cname,
                                  HINFO: :hinfo,
-                                 LOC: :loc,
+                                 LOC:   :loc,
                                  MINFO: :minfo,
-                                 MX: :mx,
-                                 NS: :ns,
-                                 PTR: :ptr,
-                                 SOA: :soa,
-                                 SRV: :srv,
-                                 TXT: :txt,
-                                 WKS: :wks
+                                 MX:    :mx,
+                                 NS:    :ns,
+                                 PTR:   :ptr,
+                                 SOA:   :soa,
+                                 SRV:   :srv,
+                                 TXT:   :txt,
+                                 WKS:   :wks
                                }
                              },
                              desc: 'Filters hostnames that have a certain DNS record type'

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

@@ -197,7 +197,9 @@ module Ronin
 
             puts "#{ip}/#{ip.prefix}"
           elsif options[:host]
-            puts ip.host
+            if (host = ip.host)
+              puts host
+            end
           elsif options[:port]
             puts "#{format_ip(ip)}:#{options[:port]}"
           elsif options[:uri]

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

@@ -31,7 +31,7 @@ module Ronin
   class CLI
     module Commands
       #
-      # Starts a TCP/UDP intercept proxy.
+      # Starts a TCP/UDP/SSL/TLS intercept proxy server.
       #
       # ## Usage
       #
@@ -39,35 +39,26 @@ module Ronin
       #
       # ## Options
       #
-      #     -v, --[no-]verbose               Enable verbose output.
-      #     -q, --[no-]quiet                 Disable verbose output.
-      #         --[no-]silent                Silence all output.
-      #     -t, --[no-]tcp                   TCP Proxy.
-      #                                      Default: true
-      #     -S, --[no-]ssl                   SSL Proxy.
-      #     -T, --[no-]tls                   TLS Proxy.
-      #     -u, --[no-]udp                   UDP Proxy.
-      #     -x, --[no-]hexdump               Enable hexdump output.
-      #     -r, --rewrite [/REGEXP/:STRING] Rewrite rules.
-      #         --rewrite-client [/REGEXP/:STRING]
-      #                                      Client rewrite rules.
-      #         --rewrite-server [/REGEXP/:STRING]
-      #                                      Server rewrite rules.
-      #     -i, --ignore [/REGEXP/ [...]]    Ignore rules.
-      #         --ignore-client [/REGEXP/ [...]]
-      #                                      Client ignore rules.
-      #         --ignore-server [/REGEXP/ [...]]
-      #                                      Server ignore rules.
-      #     -C, --close [/REGEXP/ [...]]     Close rules.
-      #         --close-client [/REGEXP/ [...]]
-      #                                      Client close rules.
-      #         --close-server [/REGEXP/ [...]]
-      #                                      Server close rules.
-      #     -R, --reset [/REGEXP/ [...]]     Reset rules.
-      #         --reset-client [/REGEXP/ [...]]
-      #                                      Client reset rules.
-      #         --reset-server [/REGEXP/ [...]]
-      #                                      Server reset rules.
+      #     -t, --tcp                        TCP Proxy
+      #     -S, --ssl                        SSL Proxy
+      #     -T, --tls                        TLS Proxy
+      #     -u, --udp                        UDP Proxy
+      #     -x, --[no-]hexdump               Enable hexdump output
+      #     -r, --rewrite /REGEXP/:STRING    Rewrite rules
+      #         --rewrite-client /REGEXP/:STRING
+      #                                      Client rewrite rules
+      #         --rewrite-server /REGEXP/:STRING
+      #                                      Server rewrite rules
+      #     -i, --ignore /REGEXP/            Ignore rules
+      #         --ignore-client /REGEXP/     Client ignore rules
+      #         --ignore-server /REGEXP/     Server ignore rules
+      #     -C, --close /REGEXP/             Close rules
+      #         --close-client /REGEXP/      Client close rules
+      #         --close-server /REGEXP/      Server close rules
+      #     -R, --reset /REGEXP/             Reset rules
+      #         --reset-client /REGEXP/      Client reset rules
+      #         --reset-server /REGEXP/      Server reset rules
+      #     -h, --help                       Print help information
       #
       # ## Arguments
       #
@@ -75,6 +66,11 @@ module Ronin
       #                                      listen on.
       #     REMOTE_HOST:REMOTE_PORT          The remote server to proxy data to.
       #
+      # ## Examples
+      #
+      #     ronin proxy 8080 google.com:80
+      #     ronin proxy --udp --hexdump 0.0.0.0:53 8.8.8.8:53
+      #
       class Proxy < Command
 
         include HostAndPort
@@ -185,7 +181,7 @@ module Ronin
         argument :upstream, usage: 'UPSTREAM_HOST:UPSTREAM_PORT',
                             desc:  'The upstream server to proxy data to'
 
-        description 'Starts a TCP/UDP/SSL/TLS intercept proxy'
+        description 'Starts a TCP/UDP/SSL/TLS intercept proxy server'
 
         examples [
           "8080 google.com:80",

data/lib/ronin/version.rb

@@ -18,5 +18,5 @@
 
 module Ronin
   # ronin version
-  VERSION = '2.0.1'
+  VERSION = '2.0.2'
 end

data/man/ronin-cert-gen.1

@@ -51,7 +51,7 @@ The Organizational Unit (OU)\.
 The locality for the certificate\.
 .LP
 .TP
-\fB-S\fR, \`\-\-state \fIXX\fP
+\fB-S\fR, \fB--state\fR \fIXX\fP
 The two\-letter State (ST) code for the certificate\.
 .LP
 .TP
@@ -59,11 +59,20 @@ The two\-letter State (ST) code for the certificate\.
 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\.
+\fB-t\fR, \fB--key-type\fR rsa\[or]ec\`
+The signing key type\.
+.LP
+.TP
+\fB--generate-key\fR \fIPATH\fP
+Generates and saves a random key\. Defaults to \fBkey.pem\fR if not given\.
+.LP
+.TP
+\fB-k\fR, \fB--key-file\fR \fIFILE\fP
+Loads the signing key from the \fIFILE\fP\.
+.LP
+.TP
+\fB-H\fR, \fB--signing-hash\fR \fBsha256\fR\[or]\fBsha1\fR\[or]\fBmd5\fR
+The hash algorithm to use for signing\. Defaults to \fBsha256\fR if not given\.
 .LP
 .TP
 \fB--ca-key\fR \fIFILE\fP

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

@@ -37,15 +37,21 @@ Generates a new X509 certificate.
 `-L`, `--locality` *NAME*
   The locality for the certificate.
 
-`-S`, `--state *XX*
+`-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
+`-t`, `--key-type` rsa|ec`
+  The signing key type.
+
+`--generate-key` *PATH*
+  Generates and saves a random key. Defaults to `key.pem` if not given.
+
+`-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.
 

data/man/ronin-decrypt.1

@@ -62,6 +62,36 @@ List the supported ciphers and exits\.
 \fB-h\fR, \fB--help\fR
 Print help information\.
 .LP
+.SH EXAMPLES
+.LP
+.PP
+Decrypt a file using AES\-256 (CBC mode) with a password:
+.LP
+.nf
+    \[Do] ronin decrypt \-\-cipher aes\-256\-cbc \-\-password \[dq]\.\.\.\[dq] encrypted\.bin
+.fi
+.LP
+.PP
+Decrypt a file using a raw key string:
+.LP
+.nf
+    \[Do] ronin decrypt \-\-cipher aes\-256\-cbc \-\-key \[dq]12345abcdef\.\.\.\[dq] encrypted\.bin
+.fi
+.LP
+.PP
+Decrypt a file using a raw key read from a file:
+.LP
+.nf
+    \[Do] ronin decrypt \-\-cipher aes\-256\-cbc \-\-key\-file key\.bin encrypted\.bin
+.fi
+.LP
+.PP
+Specifying a custom IV (initialization vector):
+.LP
+.nf
+    \[Do] ronin decrypt \-\-cipher aes\-256\-cbc \-\-key \[dq]\.\.\.\[dq] \-\-iv \[dq]\.\.\.\[dq] encrypted\.bin
+.fi
+.LP
 .SH AUTHOR
 .LP
 .PP

data/man/ronin-decrypt.1.md

@@ -47,6 +47,24 @@ Encrypts data.
 `-h`, `--help`
   Print help information.
 
+## EXAMPLES
+
+Decrypt a file using AES-256 (CBC mode) with a password:
+
+        $ ronin decrypt --cipher aes-256-cbc --password "..." encrypted.bin
+
+Decrypt a file using a raw key string:
+
+        $ ronin decrypt --cipher aes-256-cbc --key "12345abcdef..." encrypted.bin
+
+Decrypt a file using a raw key read from a file:
+
+        $ ronin decrypt --cipher aes-256-cbc --key-file key.bin encrypted.bin
+
+Specifying a custom IV (initialization vector):
+
+        $ ronin decrypt --cipher aes-256-cbc --key "..." --iv "..." encrypted.bin
+
 ## AUTHOR
 
 Postmodern <postmodern.mod3@gmail.com>

data/man/ronin-dns.1

@@ -5,7 +5,7 @@
 .SH SYNOPSIS
 .LP
 .HP
-\fBronin dns\fR \[lB]\fIoptions\fP\[rB] \[lB]\fIHOST\fP\[rB]
+\fBronin dns\fR \[lB]\fIoptions\fP\[rB] \[lC]\fIHOST\fP \.\.\. \[or] \fB--file\fR \fIFILE\fP\[rC]
 .LP
 .SH DESCRIPTION
 .LP

data/man/ronin-dns.1.md

@@ -2,7 +2,7 @@
 
 ## SYNOPSIS
 
-`ronin dns` [*options*] [*HOST*]
+`ronin dns` [*options*] {*HOST* ... \| `--file` *FILE*}
 
 ## DESCRIPTION
 

data/man/ronin-email-addr.1

@@ -15,7 +15,7 @@ Processes one or more email addresses\.
 .SH OPTIONS
 .LP
 .TP
-\fB-i\fR, \fB--input\fR \fIFILE\fP
+\fB-f\fR, \fB--file\fR \fIFILE\fP
 Optional input file to read the email addresses from\.
 .LP
 .TP
@@ -64,7 +64,7 @@ Deobfuscates an email address:
 Extracts the domain name from a list of email addresses:
 .LP
 .nf
-    ronin email\-addr \-\-input emails\.txt \-\-domain
+    ronin email\-addr \-\-file emails\.txt \-\-domain
 .fi
 .LP
 .SH AUTHOR

data/man/ronin-email-addr.1.md

@@ -10,7 +10,7 @@ Processes one or more email addresses.
 
 ## OPTIONS
 
-`-i`, `--input` *FILE*
+`-f`, `--file` *FILE*
   Optional input file to read the email addresses from.
 
 `-O`, `--obfuscate`
@@ -46,7 +46,7 @@ Deobfuscates an email address:
 
 Extracts the domain name from a list of email addresses:
 
-        ronin email-addr --input emails.txt --domain
+        ronin email-addr --file emails.txt --domain
 
 ## AUTHOR
 

data/man/ronin-encrypt.1

@@ -62,6 +62,36 @@ List the supported ciphers and exits\.
 \fB-h\fR, \fB--help\fR
 Print help information\.
 .LP
+.SH EXAMPLES
+.LP
+.PP
+Encrypt a file using AES\-256 (CBC mode) with a password:
+.LP
+.nf
+    \[Do] ronin encrypt \-\-cipher aes\-256\-cbc \-\-password \[dq]\.\.\.\[dq] file\.txt > encrypted\.bin
+.fi
+.LP
+.PP
+Encrypt a file using a raw key string:
+.LP
+.nf
+    \[Do] ronin encrypt \-\-cipher aes\-256\-cbc \-\-key \[dq]12345abcdef\.\.\.\[dq] file\.txt > encrypted\.bin
+.fi
+.LP
+.PP
+Encrypt a file using a raw key read from a file:
+.LP
+.nf
+    \[Do] ronin encrypt \-\-cipher aes\-256\-cbc \-\-key\-file key\.bin file\.txt > encrypted\.bin
+.fi
+.LP
+.PP
+Specifying a custom IV (initialization vector):
+.LP
+.nf
+    \[Do] ronin encrypt \-\-cipher aes\-256\-cbc \-\-key \[dq]\.\.\.\[dq] \-\-iv \[dq]\.\.\.\[dq] file\.txt > encrypted\.bin
+.fi
+.LP
 .SH AUTHOR
 .LP
 .PP

data/man/ronin-encrypt.1.md

@@ -47,6 +47,24 @@ Encrypts data.
 `-h`, `--help`
   Print help information.
 
+## EXAMPLES
+
+Encrypt a file using AES-256 (CBC mode) with a password:
+
+        $ ronin encrypt --cipher aes-256-cbc --password "..." file.txt > encrypted.bin
+
+Encrypt a file using a raw key string:
+
+        $ ronin encrypt --cipher aes-256-cbc --key "12345abcdef..." file.txt > encrypted.bin
+
+Encrypt a file using a raw key read from a file:
+
+        $ ronin encrypt --cipher aes-256-cbc --key-file key.bin file.txt > encrypted.bin
+
+Specifying a custom IV (initialization vector):
+
+        $ ronin encrypt --cipher aes-256-cbc --key "..." --iv "..." file.txt > encrypted.bin
+
 ## AUTHOR
 
 Postmodern <postmodern.mod3@gmail.com>

data/man/ronin-escape.1

@@ -22,7 +22,7 @@ input will be read from \fBstdin\fR\.
 .SH OPTIONS
 .LP
 .TP
-\fB-i\fR, \fB--input\fR \fIFILE\fP
+\fB-f\fR, \fB--file\fR \fIFILE\fP
 Optional input file to read from\.
 .LP
 .TP

data/man/ronin-escape.1.md

@@ -16,7 +16,7 @@ Escapes each special character for a variety of encodings.
 
 ## OPTIONS
 
-`-i`, `--input` *FILE*
+`-f`, `--file` *FILE*
   Optional input file to read from.
 
 `--string` *STRING*

data/man/ronin-host.1

@@ -5,7 +5,7 @@
 .SH SYNOPSIS
 .LP
 .HP
-\fBronin host\fR \[lB]\fIoptions\fP\[rB] \[lB]\fIHOST\fP \.\.\.\[rB]
+\fBronin host\fR \[lB]\fIoptions\fP\[rB] \[lC]\fIHOST\fP \.\.\. \[or] \fB--file\fR \fIFILE\fP\[rC]
 .LP
 .SH DESCRIPTION
 .LP

data/man/ronin-host.1.md

@@ -2,7 +2,7 @@
 
 ## SYNOPSIS
 
-`ronin host` [*options*] [*HOST* ...]
+`ronin host` [*options*] {*HOST* ... \| `--file` *FILE*}
 
 ## DESCRIPTION
 

data/man/ronin-proxy.1

@@ -10,7 +10,7 @@
 .SH DESCRIPTION
 .LP
 .PP
-Starts the Ronin TCP\[sl]UDP\[sl]SSL\[sl]TLS Proxy\.
+Starts a TCP\[sl]UDP\[sl]SSL\[sl]TLS proxy server\.
 .LP
 .SH ARGUMENTS
 .LP

data/man/ronin-proxy.1.md

@@ -6,7 +6,7 @@
 
 ## DESCRIPTION
 
-Starts the Ronin TCP/UDP/SSL/TLS Proxy.
+Starts a TCP/UDP/SSL/TLS proxy server.
 
 ## ARGUMENTS
 

data/man/ronin-quote.1

@@ -47,7 +47,7 @@ Quotes the data as a C string\.
 .LP
 .TP
 \fB-j\fR, \fB--js\fR
-JavaScript quotes the data\.
+quotes the data as a JavaScript string\.
 .LP
 .TP
 \fB-S\fR, \fB--shell\fR

data/man/ronin-quote.1.md

@@ -35,7 +35,7 @@ Produces quoted a string for a variety of programming languages.
   Quotes the data as a C string.
 
 `-j`, `--js`
-  JavaScript quotes the data.
+  quotes the data as a JavaScript string.
 
 `-S`, `--shell`
   Quotes the data as a Shell String.

data/man/ronin-rot.1

@@ -50,6 +50,22 @@ given\.
 \fB-h\fR, \fB--help\fR
 Print help information\.
 .LP
+.SH EXAMPLES
+.LP
+.PP
+ROT\-13 encode a string:
+.LP
+.nf
+    \[Do] ronin rot \-\-string \[dq]The quick brown fox jumps over the lazy dog\[dq]
+.fi
+.LP
+.PP
+ROT encode a string with a custom rotation number:
+.LP
+.nf
+    \[Do] ronin rot \-n 3 \-\-string \[dq]The quick brown fox jumps over the lazy dog\[dq]
+.fi
+.LP
 .SH AUTHOR
 .LP
 .PP

data/man/ronin-rot.1.md

@@ -38,6 +38,16 @@ Rotates each character of data with an alphabet.
 `-h`, `--help`
   Print help information.
 
+## EXAMPLES
+
+ROT-13 encode a string:
+
+        $ ronin rot --string "The quick brown fox jumps over the lazy dog"
+
+ROT encode a string with a custom rotation number:
+
+        $ ronin rot -n 3 --string "The quick brown fox jumps over the lazy dog"
+
 ## AUTHOR
 
 Postmodern <postmodern.mod3@gmail.com>

data/man/ronin-sha256.1

@@ -22,7 +22,7 @@ input will be read from \fBstdin\fR\.
 .SH OPTIONS
 .LP
 .TP
-\fB-i\fR, \fB--input\fR \fIFILE\fP
+\fB-f\fR, \fB--file\fR \fIFILE\fP
 Optional input file to read from\.
 .LP
 .TP

data/man/ronin-sha256.1.md

@@ -16,7 +16,7 @@ Calculates SHA256 hashes of data.
 
 ## OPTIONS
 
-`-i`, `--input` *FILE*
+`-f`, `--file` *FILE*
   Optional input file to read from.
 
 `--string` *STRING*

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: ronin
 version: !ruby/object:Gem::Version
-  version: 2.0.1
+  version: 2.0.2
 platform: ruby
 authors:
 - Postmodern
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2023-03-02 00:00:00.000000000 Z
+date: 2023-06-09 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: open_namespace