ronin 2.0.1 → 2.0.2

Sign up to get free protection for your applications and to get access to all the features.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 42aeafda3468e4c0f5427a4f2323d40b96bb4aaafc042bb8380d569f5c8c5414
4
- data.tar.gz: a150c7211fa93770dc9be47343f8f3d3391396996885263580c0185742476255
3
+ metadata.gz: 31356f467f009277f4c840fb645f3f64bfba3c6d9e1cf1b1bef2dee177dc4b96
4
+ data.tar.gz: 4cce57a146892ac6b05bf6a41aa35467d50e307c74ed6150cfdf05234aa177f2
5
5
  SHA512:
6
- metadata.gz: 562df97d739aedfad72706c939d40697f8ab39136a3aab69e2d67e7aa29b3ea03bf1534695f259af8060c5e09f26e6e6c51ff62c57fa8d1ad73242c0c48e9c78
7
- data.tar.gz: '018c73e255ed3b3468d84c054d8b79095cef777443536beac09e572d1bf183ce0d3a019a8e45560013c13a0b8df202a7402d1c4d4cd41ff884a0179f932e51bb'
6
+ metadata.gz: 244f986f64b8ee769769ca050321ff3ad6ebe4de5ea7c9f7f509514e32e02d580fbd391bf65c1a35238f2b42825050082fd0a1a06c491e447462a603b7a3c9de
7
+ data.tar.gz: 312f52036a301608b240fd91a26f2d3632eafd1f0c193ef6127851eb43e69840c443a8f3f9608ab7ad8d522e7fb58d96e45e8e32cdfac00a59e931ed636b7d48
data/ChangeLog.md CHANGED
@@ -1,3 +1,20 @@
1
+ ### 2.0.2 / 2023-06-09
2
+
3
+ * Documentation fixes and improvements.
4
+
5
+ #### CLI
6
+
7
+ * Fixed a bug in the `ronin ip` command where empty lines would be printed
8
+ if the IP had no hostname.
9
+ * Fixed a bug in the `ronin hexdump` command where the `--type` option was being
10
+ ignored.
11
+ * Fixed the `Usage:` of the `ronin host` and `ronin dns` commands.
12
+ * Fixed typos in the `ronin email-addr`, `ronin escape`, and `ronin sha256`
13
+ man-pages.
14
+ * Fixed formatting in the `ronin cert-gen` man-page.
15
+ * Added more examples to the `ronin rot`, `ronin encrypt`, and `ronin decrypt`
16
+ man-pages.
17
+
1
18
  ### 2.0.1 / 2023-03-01
2
19
 
3
20
  * Require [ronin-support] ~> 1.0, >= 1.0.1.
data/Gemfile CHANGED
@@ -23,37 +23,37 @@ group :database do
23
23
  end
24
24
 
25
25
  # Library dependencies
26
- # gem 'ronin-support', '~> 1.0', github: "ronin-rb/ronin-support",
26
+ # gem 'ronin-support', '~> 1.0', github: 'ronin-rb/ronin-support',
27
27
  # branch: 'main'
28
- # gem 'ronin-core', '~> 0.1', github: "ronin-rb/ronin-core",
28
+ # gem 'ronin-core', '~> 0.1', github: 'ronin-rb/ronin-core',
29
29
  # branch: 'main'
30
- # gem 'ronin-repos', '~> 0.1', github: "ronin-rb/ronin-repos",
30
+ # gem 'ronin-repos', '~> 0.1', github: 'ronin-rb/ronin-repos',
31
31
  # branch: 'main'
32
- # gem 'ronin-db', '~> 0.1', github: "ronin-rb/ronin-db",
32
+ # gem 'ronin-db', '~> 0.1', github: 'ronin-rb/ronin-db',
33
33
  # branch: 'main'
34
- # gem 'ronin-db-activerecord', '~> 0.1', github: "ronin-rb/ronin-db-activerecord",
34
+ # gem 'ronin-db-activerecord', '~> 0.1', github: 'ronin-rb/ronin-db-activerecord',
35
35
  # branch: 'main'
36
- # gem 'ronin-fuzzer', '~> 0.1', github: "ronin-rb/ronin-fuzzer",
36
+ # gem 'ronin-fuzzer', '~> 0.1', github: 'ronin-rb/ronin-fuzzer',
37
37
  # branch: 'main'
38
- # gem 'ronin-post_ex', '~> 0.1', github: "ronin-rb/ronin-post_ex",
38
+ # gem 'ronin-post_ex', '~> 0.1', github: 'ronin-rb/ronin-post_ex',
39
39
  # branch: 'main'
40
- # gem 'ronin-code-asm', '~> 1.0', github: "ronin-rb/ronin-code-asm",
40
+ # gem 'ronin-code-asm', '~> 1.0', github: 'ronin-rb/ronin-code-asm',
41
41
  # branch: 'main'
42
- # gem 'ronin-code-sql', '~> 2.0', github: "ronin-rb/ronin-code-sql",
42
+ # gem 'ronin-code-sql', '~> 2.0', github: 'ronin-rb/ronin-code-sql',
43
43
  # branch: 'main'
44
- # gem 'ronin-payloads', '~> 0.1', github: "ronin-rb/ronin-payloads",
44
+ # gem 'ronin-payloads', '~> 0.1', github: 'ronin-rb/ronin-payloads',
45
45
  # branch: 'main'
46
- # gem 'ronin-exploits', '~> 1.0', github: "ronin-rb/ronin-exploits",
46
+ # gem 'ronin-exploits', '~> 1.0', github: 'ronin-rb/ronin-exploits',
47
47
  # branch: 'main'
48
- # gem 'ronin-vulns', '~> 0.1', github: "ronin-rb/ronin-vulns",
48
+ # gem 'ronin-vulns', '~> 0.1', github: 'ronin-rb/ronin-vulns',
49
49
  # branch: 'main'
50
- # gem 'ronin-web-server', '~> 0.1', github: "ronin-rb/ronin-web-server",
50
+ # gem 'ronin-web-server', '~> 0.1', github: 'ronin-rb/ronin-web-server',
51
51
  # branch: 'main'
52
- # gem 'ronin-web-spider', '~> 0.1', github: "ronin-rb/ronin-web-spider",
52
+ # gem 'ronin-web-spider', '~> 0.1', github: 'ronin-rb/ronin-web-spider',
53
53
  # branch: 'main'
54
- # gem 'ronin-web-user_agents', '~> 0.1', github: "ronin-rb/ronin-web-user_agents",
54
+ # gem 'ronin-web-user_agents', '~> 0.1', github: 'ronin-rb/ronin-web-user_agents',
55
55
  # branch: 'main'
56
- # gem 'ronin-web', '~> 1.0', github: "ronin-rb/ronin-web",
56
+ # gem 'ronin-web', '~> 1.0', github: 'ronin-rb/ronin-web',
57
57
  # branch: 'main'
58
58
 
59
59
  group :development do
data/README.md CHANGED
@@ -40,7 +40,7 @@ HTTP, [scanning for web vulnerabilities][ronin-vulns-synopsis],
40
40
 
41
41
  * A toolkit of useful commands.
42
42
  * A fully-loaded Ruby REPL.
43
- * An ecosystem of high-quality security related Ruby libraries, API, and
43
+ * An ecosystem of high-quality security related Ruby libraries, APIs, and
44
44
  commands.
45
45
 
46
46
  ### What can you do with Ronin?
@@ -290,25 +290,6 @@ foo bar
290
290
 
291
291
  ### Text
292
292
 
293
- De-obfuscate an email address:
294
-
295
- ```shell
296
- $ ronin email-addr --deobfuscate "john [dot] smith [at] example [dot] com"
297
- john.smith@example.com
298
- ```
299
-
300
- Enumerate through all of the obfuscations of an email address:
301
-
302
- ```shell
303
- $ ronin email-addr --enum-obfuscations john.smith@example.com
304
- john.smith @ example.com
305
- john.smith AT example.com
306
- john.smith at example.com
307
- john.smith[AT]example.com
308
- john.smith[at]example.com
309
- ...
310
- ```
311
-
312
293
  Extract high-entropy data from a file:
313
294
 
314
295
  ```shell
@@ -386,13 +367,13 @@ Decrypt data:
386
367
  $ ronin decrypt --cipher aes-256-cbc --password "..." encrypted.bin
387
368
  ```
388
369
 
389
- Generates an HMAC for a file:
370
+ Generates a HMAC for a file:
390
371
 
391
372
  ```shell
392
373
  $ ronin hmac --hash sha1 --password "too many secrets" data.txt
393
374
  ```
394
375
 
395
- Generates an HMAC for a string:
376
+ Generates a HMAC for a string:
396
377
 
397
378
  ```shell
398
379
  $ ronin hmac --hash sha1 --password "too many secrets" --string "..."
@@ -657,6 +638,25 @@ example.com.bh
657
638
  ...
658
639
  ```
659
640
 
641
+ Find all subdomains that have addresses:
642
+
643
+ ```shell
644
+ $ ronin host --enum-subdomains subdomains.txt --has-addresses google.com
645
+ www.google.com
646
+ mail.google.com
647
+ smtp.google.com
648
+ ns1.google.com
649
+ ns2.google.com
650
+ m.google.com
651
+ ns.google.com
652
+ blog.google.com
653
+ admin.google.com
654
+ news.google.com
655
+ vpn.google.com
656
+ ns3.google.com
657
+ ...
658
+ ```
659
+
660
660
  Enumerate over every possible typosquat variation of a domain:
661
661
 
662
662
  ```shell
@@ -684,6 +684,25 @@ Find all of the unregistered typosquat domains for a valid domain:
684
684
  $ ronin typosquat --unregistered microsoft.com
685
685
  ```
686
686
 
687
+ De-obfuscate an email address:
688
+
689
+ ```shell
690
+ $ ronin email-addr --deobfuscate "john [dot] smith [at] example [dot] com"
691
+ john.smith@example.com
692
+ ```
693
+
694
+ Enumerate through all of the obfuscations of an email address:
695
+
696
+ ```shell
697
+ $ ronin email-addr --enum-obfuscations john.smith@example.com
698
+ john.smith @ example.com
699
+ john.smith AT example.com
700
+ john.smith at example.com
701
+ john.smith[AT]example.com
702
+ john.smith[at]example.com
703
+ ...
704
+ ```
705
+
687
706
  #### SSL/TLS Certs
688
707
 
689
708
  Dump information about a SSL/TLS certificate:
@@ -815,7 +834,7 @@ If you prefer using [Docker], there are also [Docker images] available:
815
834
 
816
835
  ```shell
817
836
  docker pull roninrb/ronin
818
- docker run -it ronin
837
+ docker run -it roninrb/ronin
819
838
  ```
820
839
 
821
840
  Additionally, if you want to mount your home directory into the docker image:
@@ -28,7 +28,7 @@ module Ronin
28
28
  #
29
29
  # ## Usage
30
30
  #
31
- # ronin dns [options] [HOST [...]]
31
+ # ronin dns [options] {HOST ... | --file FILE}
32
32
  #
33
33
  # ## Options
34
34
  #
@@ -46,7 +46,7 @@ module Ronin
46
46
 
47
47
  include DNS
48
48
 
49
- usage '[options] HOST'
49
+ usage '[options] {HOST ... | --file FILE}'
50
50
 
51
51
  option :type, short: '-t',
52
52
  value: {
@@ -417,6 +417,7 @@ module Ronin
417
417
  # List of command `options` that directly map to the keyword arguments
418
418
  # of `Hexdump.hexdump`.
419
419
  HEXDUMP_OPTIONS = [
420
+ :type,
420
421
  :format,
421
422
  :offset,
422
423
  :length,
@@ -30,7 +30,7 @@ module Ronin
30
30
  #
31
31
  # ## Usage
32
32
  #
33
- # ronin host [options] [HOST ...]
33
+ # ronin host [options] {HOST ... | --file FILE}
34
34
  #
35
35
  # ## Options
36
36
  #
@@ -63,7 +63,7 @@ module Ronin
63
63
 
64
64
  include DNS
65
65
 
66
- usage '[options] [HOST ...]'
66
+ usage '[options] {HOST ... | --file FILE}'
67
67
 
68
68
  option :subdomain, value: {
69
69
  type: String,
@@ -117,20 +117,20 @@ module Ronin
117
117
  option :has_records, short: '-H',
118
118
  value: {
119
119
  type: {
120
- A: :a,
121
- AAAA: :aaaa,
122
- ANY: :any,
120
+ A: :a,
121
+ AAAA: :aaaa,
122
+ ANY: :any,
123
123
  CNAME: :cname,
124
124
  HINFO: :hinfo,
125
- LOC: :loc,
125
+ LOC: :loc,
126
126
  MINFO: :minfo,
127
- MX: :mx,
128
- NS: :ns,
129
- PTR: :ptr,
130
- SOA: :soa,
131
- SRV: :srv,
132
- TXT: :txt,
133
- WKS: :wks
127
+ MX: :mx,
128
+ NS: :ns,
129
+ PTR: :ptr,
130
+ SOA: :soa,
131
+ SRV: :srv,
132
+ TXT: :txt,
133
+ WKS: :wks
134
134
  }
135
135
  },
136
136
  desc: 'Filters hostnames that have a certain DNS record type'
@@ -197,7 +197,9 @@ module Ronin
197
197
 
198
198
  puts "#{ip}/#{ip.prefix}"
199
199
  elsif options[:host]
200
- puts ip.host
200
+ if (host = ip.host)
201
+ puts host
202
+ end
201
203
  elsif options[:port]
202
204
  puts "#{format_ip(ip)}:#{options[:port]}"
203
205
  elsif options[:uri]
@@ -31,7 +31,7 @@ module Ronin
31
31
  class CLI
32
32
  module Commands
33
33
  #
34
- # Starts a TCP/UDP intercept proxy.
34
+ # Starts a TCP/UDP/SSL/TLS intercept proxy server.
35
35
  #
36
36
  # ## Usage
37
37
  #
@@ -39,35 +39,26 @@ module Ronin
39
39
  #
40
40
  # ## Options
41
41
  #
42
- # -v, --[no-]verbose Enable verbose output.
43
- # -q, --[no-]quiet Disable verbose output.
44
- # --[no-]silent Silence all output.
45
- # -t, --[no-]tcp TCP Proxy.
46
- # Default: true
47
- # -S, --[no-]ssl SSL Proxy.
48
- # -T, --[no-]tls TLS Proxy.
49
- # -u, --[no-]udp UDP Proxy.
50
- # -x, --[no-]hexdump Enable hexdump output.
51
- # -r, --rewrite [/REGEXP/:STRING] Rewrite rules.
52
- # --rewrite-client [/REGEXP/:STRING]
53
- # Client rewrite rules.
54
- # --rewrite-server [/REGEXP/:STRING]
55
- # Server rewrite rules.
56
- # -i, --ignore [/REGEXP/ [...]] Ignore rules.
57
- # --ignore-client [/REGEXP/ [...]]
58
- # Client ignore rules.
59
- # --ignore-server [/REGEXP/ [...]]
60
- # Server ignore rules.
61
- # -C, --close [/REGEXP/ [...]] Close rules.
62
- # --close-client [/REGEXP/ [...]]
63
- # Client close rules.
64
- # --close-server [/REGEXP/ [...]]
65
- # Server close rules.
66
- # -R, --reset [/REGEXP/ [...]] Reset rules.
67
- # --reset-client [/REGEXP/ [...]]
68
- # Client reset rules.
69
- # --reset-server [/REGEXP/ [...]]
70
- # Server reset rules.
42
+ # -t, --tcp TCP Proxy
43
+ # -S, --ssl SSL Proxy
44
+ # -T, --tls TLS Proxy
45
+ # -u, --udp UDP Proxy
46
+ # -x, --[no-]hexdump Enable hexdump output
47
+ # -r, --rewrite /REGEXP/:STRING Rewrite rules
48
+ # --rewrite-client /REGEXP/:STRING
49
+ # Client rewrite rules
50
+ # --rewrite-server /REGEXP/:STRING
51
+ # Server rewrite rules
52
+ # -i, --ignore /REGEXP/ Ignore rules
53
+ # --ignore-client /REGEXP/ Client ignore rules
54
+ # --ignore-server /REGEXP/ Server ignore rules
55
+ # -C, --close /REGEXP/ Close rules
56
+ # --close-client /REGEXP/ Client close rules
57
+ # --close-server /REGEXP/ Server close rules
58
+ # -R, --reset /REGEXP/ Reset rules
59
+ # --reset-client /REGEXP/ Client reset rules
60
+ # --reset-server /REGEXP/ Server reset rules
61
+ # -h, --help Print help information
71
62
  #
72
63
  # ## Arguments
73
64
  #
@@ -75,6 +66,11 @@ module Ronin
75
66
  # listen on.
76
67
  # REMOTE_HOST:REMOTE_PORT The remote server to proxy data to.
77
68
  #
69
+ # ## Examples
70
+ #
71
+ # ronin proxy 8080 google.com:80
72
+ # ronin proxy --udp --hexdump 0.0.0.0:53 8.8.8.8:53
73
+ #
78
74
  class Proxy < Command
79
75
 
80
76
  include HostAndPort
@@ -185,7 +181,7 @@ module Ronin
185
181
  argument :upstream, usage: 'UPSTREAM_HOST:UPSTREAM_PORT',
186
182
  desc: 'The upstream server to proxy data to'
187
183
 
188
- description 'Starts a TCP/UDP/SSL/TLS intercept proxy'
184
+ description 'Starts a TCP/UDP/SSL/TLS intercept proxy server'
189
185
 
190
186
  examples [
191
187
  "8080 google.com:80",
data/lib/ronin/version.rb CHANGED
@@ -18,5 +18,5 @@
18
18
 
19
19
  module Ronin
20
20
  # ronin version
21
- VERSION = '2.0.1'
21
+ VERSION = '2.0.2'
22
22
  end
data/man/ronin-cert-gen.1 CHANGED
@@ -51,7 +51,7 @@ The Organizational Unit (OU)\.
51
51
  The locality for the certificate\.
52
52
  .LP
53
53
  .TP
54
- \fB-S\fR, \`\-\-state \fIXX\fP
54
+ \fB-S\fR, \fB--state\fR \fIXX\fP
55
55
  The two\-letter State (ST) code for the certificate\.
56
56
  .LP
57
57
  .TP
@@ -59,11 +59,20 @@ The two\-letter State (ST) code for the certificate\.
59
59
  The two\-letter Country (C) code for the certificate\.
60
60
  .LP
61
61
  .HP
62
- \fB-t\fR, \fB--key-type\fR rsa\[or]ec\fB The signing key type
63
- --generate-key PATH Generates and saves a random key (Default: key.pem)
64
- -k, --key-file FILE Loads the signing key from the FILE
65
- \fR\-H\fB, \fR\-\-signing\-hash\fB \fRsha256\fB\|\fRsha1\fB\|\fRmd5\fB
66
- The hash algorithm to use for signing. Defaults to \fRsha256\` if not given\.
62
+ \fB-t\fR, \fB--key-type\fR rsa\[or]ec\`
63
+ The signing key type\.
64
+ .LP
65
+ .TP
66
+ \fB--generate-key\fR \fIPATH\fP
67
+ Generates and saves a random key\. Defaults to \fBkey.pem\fR if not given\.
68
+ .LP
69
+ .TP
70
+ \fB-k\fR, \fB--key-file\fR \fIFILE\fP
71
+ Loads the signing key from the \fIFILE\fP\.
72
+ .LP
73
+ .TP
74
+ \fB-H\fR, \fB--signing-hash\fR \fBsha256\fR\[or]\fBsha1\fR\[or]\fBmd5\fR
75
+ The hash algorithm to use for signing\. Defaults to \fBsha256\fR if not given\.
67
76
  .LP
68
77
  .TP
69
78
  \fB--ca-key\fR \fIFILE\fP
@@ -37,15 +37,21 @@ Generates a new X509 certificate.
37
37
  `-L`, `--locality` *NAME*
38
38
  The locality for the certificate.
39
39
 
40
- `-S`, `--state *XX*
40
+ `-S`, `--state` *XX*
41
41
  The two-letter State (ST) code for the certificate.
42
42
 
43
43
  `-C`, `--country` *XX*
44
44
  The two-letter Country (C) code for the certificate.
45
45
 
46
- `-t`, `--key-type` rsa|ec` The signing key type
47
- --generate-key PATH Generates and saves a random key (Default: key.pem)
48
- -k, --key-file FILE Loads the signing key from the FILE
46
+ `-t`, `--key-type` rsa|ec`
47
+ The signing key type.
48
+
49
+ `--generate-key` *PATH*
50
+ Generates and saves a random key. Defaults to `key.pem` if not given.
51
+
52
+ `-k`, `--key-file` *FILE*
53
+ Loads the signing key from the *FILE*.
54
+
49
55
  `-H`, `--signing-hash` `sha256`\|`sha1`\|`md5`
50
56
  The hash algorithm to use for signing. Defaults to `sha256` if not given.
51
57
 
data/man/ronin-decrypt.1 CHANGED
@@ -62,6 +62,36 @@ List the supported ciphers and exits\.
62
62
  \fB-h\fR, \fB--help\fR
63
63
  Print help information\.
64
64
  .LP
65
+ .SH EXAMPLES
66
+ .LP
67
+ .PP
68
+ Decrypt a file using AES\-256 (CBC mode) with a password:
69
+ .LP
70
+ .nf
71
+ \[Do] ronin decrypt \-\-cipher aes\-256\-cbc \-\-password \[dq]\.\.\.\[dq] encrypted\.bin
72
+ .fi
73
+ .LP
74
+ .PP
75
+ Decrypt a file using a raw key string:
76
+ .LP
77
+ .nf
78
+ \[Do] ronin decrypt \-\-cipher aes\-256\-cbc \-\-key \[dq]12345abcdef\.\.\.\[dq] encrypted\.bin
79
+ .fi
80
+ .LP
81
+ .PP
82
+ Decrypt a file using a raw key read from a file:
83
+ .LP
84
+ .nf
85
+ \[Do] ronin decrypt \-\-cipher aes\-256\-cbc \-\-key\-file key\.bin encrypted\.bin
86
+ .fi
87
+ .LP
88
+ .PP
89
+ Specifying a custom IV (initialization vector):
90
+ .LP
91
+ .nf
92
+ \[Do] ronin decrypt \-\-cipher aes\-256\-cbc \-\-key \[dq]\.\.\.\[dq] \-\-iv \[dq]\.\.\.\[dq] encrypted\.bin
93
+ .fi
94
+ .LP
65
95
  .SH AUTHOR
66
96
  .LP
67
97
  .PP
@@ -47,6 +47,24 @@ Encrypts data.
47
47
  `-h`, `--help`
48
48
  Print help information.
49
49
 
50
+ ## EXAMPLES
51
+
52
+ Decrypt a file using AES-256 (CBC mode) with a password:
53
+
54
+ $ ronin decrypt --cipher aes-256-cbc --password "..." encrypted.bin
55
+
56
+ Decrypt a file using a raw key string:
57
+
58
+ $ ronin decrypt --cipher aes-256-cbc --key "12345abcdef..." encrypted.bin
59
+
60
+ Decrypt a file using a raw key read from a file:
61
+
62
+ $ ronin decrypt --cipher aes-256-cbc --key-file key.bin encrypted.bin
63
+
64
+ Specifying a custom IV (initialization vector):
65
+
66
+ $ ronin decrypt --cipher aes-256-cbc --key "..." --iv "..." encrypted.bin
67
+
50
68
  ## AUTHOR
51
69
 
52
70
  Postmodern <postmodern.mod3@gmail.com>
data/man/ronin-dns.1 CHANGED
@@ -5,7 +5,7 @@
5
5
  .SH SYNOPSIS
6
6
  .LP
7
7
  .HP
8
- \fBronin dns\fR \[lB]\fIoptions\fP\[rB] \[lB]\fIHOST\fP\[rB]
8
+ \fBronin dns\fR \[lB]\fIoptions\fP\[rB] \[lC]\fIHOST\fP \.\.\. \[or] \fB--file\fR \fIFILE\fP\[rC]
9
9
  .LP
10
10
  .SH DESCRIPTION
11
11
  .LP
data/man/ronin-dns.1.md CHANGED
@@ -2,7 +2,7 @@
2
2
 
3
3
  ## SYNOPSIS
4
4
 
5
- `ronin dns` [*options*] [*HOST*]
5
+ `ronin dns` [*options*] {*HOST* ... \| `--file` *FILE*}
6
6
 
7
7
  ## DESCRIPTION
8
8
 
@@ -15,7 +15,7 @@ Processes one or more email addresses\.
15
15
  .SH OPTIONS
16
16
  .LP
17
17
  .TP
18
- \fB-i\fR, \fB--input\fR \fIFILE\fP
18
+ \fB-f\fR, \fB--file\fR \fIFILE\fP
19
19
  Optional input file to read the email addresses from\.
20
20
  .LP
21
21
  .TP
@@ -64,7 +64,7 @@ Deobfuscates an email address:
64
64
  Extracts the domain name from a list of email addresses:
65
65
  .LP
66
66
  .nf
67
- ronin email\-addr \-\-input emails\.txt \-\-domain
67
+ ronin email\-addr \-\-file emails\.txt \-\-domain
68
68
  .fi
69
69
  .LP
70
70
  .SH AUTHOR
@@ -10,7 +10,7 @@ Processes one or more email addresses.
10
10
 
11
11
  ## OPTIONS
12
12
 
13
- `-i`, `--input` *FILE*
13
+ `-f`, `--file` *FILE*
14
14
  Optional input file to read the email addresses from.
15
15
 
16
16
  `-O`, `--obfuscate`
@@ -46,7 +46,7 @@ Deobfuscates an email address:
46
46
 
47
47
  Extracts the domain name from a list of email addresses:
48
48
 
49
- ronin email-addr --input emails.txt --domain
49
+ ronin email-addr --file emails.txt --domain
50
50
 
51
51
  ## AUTHOR
52
52
 
data/man/ronin-encrypt.1 CHANGED
@@ -62,6 +62,36 @@ List the supported ciphers and exits\.
62
62
  \fB-h\fR, \fB--help\fR
63
63
  Print help information\.
64
64
  .LP
65
+ .SH EXAMPLES
66
+ .LP
67
+ .PP
68
+ Encrypt a file using AES\-256 (CBC mode) with a password:
69
+ .LP
70
+ .nf
71
+ \[Do] ronin encrypt \-\-cipher aes\-256\-cbc \-\-password \[dq]\.\.\.\[dq] file\.txt > encrypted\.bin
72
+ .fi
73
+ .LP
74
+ .PP
75
+ Encrypt a file using a raw key string:
76
+ .LP
77
+ .nf
78
+ \[Do] ronin encrypt \-\-cipher aes\-256\-cbc \-\-key \[dq]12345abcdef\.\.\.\[dq] file\.txt > encrypted\.bin
79
+ .fi
80
+ .LP
81
+ .PP
82
+ Encrypt a file using a raw key read from a file:
83
+ .LP
84
+ .nf
85
+ \[Do] ronin encrypt \-\-cipher aes\-256\-cbc \-\-key\-file key\.bin file\.txt > encrypted\.bin
86
+ .fi
87
+ .LP
88
+ .PP
89
+ Specifying a custom IV (initialization vector):
90
+ .LP
91
+ .nf
92
+ \[Do] ronin encrypt \-\-cipher aes\-256\-cbc \-\-key \[dq]\.\.\.\[dq] \-\-iv \[dq]\.\.\.\[dq] file\.txt > encrypted\.bin
93
+ .fi
94
+ .LP
65
95
  .SH AUTHOR
66
96
  .LP
67
97
  .PP
@@ -47,6 +47,24 @@ Encrypts data.
47
47
  `-h`, `--help`
48
48
  Print help information.
49
49
 
50
+ ## EXAMPLES
51
+
52
+ Encrypt a file using AES-256 (CBC mode) with a password:
53
+
54
+ $ ronin encrypt --cipher aes-256-cbc --password "..." file.txt > encrypted.bin
55
+
56
+ Encrypt a file using a raw key string:
57
+
58
+ $ ronin encrypt --cipher aes-256-cbc --key "12345abcdef..." file.txt > encrypted.bin
59
+
60
+ Encrypt a file using a raw key read from a file:
61
+
62
+ $ ronin encrypt --cipher aes-256-cbc --key-file key.bin file.txt > encrypted.bin
63
+
64
+ Specifying a custom IV (initialization vector):
65
+
66
+ $ ronin encrypt --cipher aes-256-cbc --key "..." --iv "..." file.txt > encrypted.bin
67
+
50
68
  ## AUTHOR
51
69
 
52
70
  Postmodern <postmodern.mod3@gmail.com>
data/man/ronin-escape.1 CHANGED
@@ -22,7 +22,7 @@ input will be read from \fBstdin\fR\.
22
22
  .SH OPTIONS
23
23
  .LP
24
24
  .TP
25
- \fB-i\fR, \fB--input\fR \fIFILE\fP
25
+ \fB-f\fR, \fB--file\fR \fIFILE\fP
26
26
  Optional input file to read from\.
27
27
  .LP
28
28
  .TP
@@ -16,7 +16,7 @@ Escapes each special character for a variety of encodings.
16
16
 
17
17
  ## OPTIONS
18
18
 
19
- `-i`, `--input` *FILE*
19
+ `-f`, `--file` *FILE*
20
20
  Optional input file to read from.
21
21
 
22
22
  `--string` *STRING*
data/man/ronin-host.1 CHANGED
@@ -5,7 +5,7 @@
5
5
  .SH SYNOPSIS
6
6
  .LP
7
7
  .HP
8
- \fBronin host\fR \[lB]\fIoptions\fP\[rB] \[lB]\fIHOST\fP \.\.\.\[rB]
8
+ \fBronin host\fR \[lB]\fIoptions\fP\[rB] \[lC]\fIHOST\fP \.\.\. \[or] \fB--file\fR \fIFILE\fP\[rC]
9
9
  .LP
10
10
  .SH DESCRIPTION
11
11
  .LP
data/man/ronin-host.1.md CHANGED
@@ -2,7 +2,7 @@
2
2
 
3
3
  ## SYNOPSIS
4
4
 
5
- `ronin host` [*options*] [*HOST* ...]
5
+ `ronin host` [*options*] {*HOST* ... \| `--file` *FILE*}
6
6
 
7
7
  ## DESCRIPTION
8
8
 
data/man/ronin-proxy.1 CHANGED
@@ -10,7 +10,7 @@
10
10
  .SH DESCRIPTION
11
11
  .LP
12
12
  .PP
13
- Starts the Ronin TCP\[sl]UDP\[sl]SSL\[sl]TLS Proxy\.
13
+ Starts a TCP\[sl]UDP\[sl]SSL\[sl]TLS proxy server\.
14
14
  .LP
15
15
  .SH ARGUMENTS
16
16
  .LP
data/man/ronin-proxy.1.md CHANGED
@@ -6,7 +6,7 @@
6
6
 
7
7
  ## DESCRIPTION
8
8
 
9
- Starts the Ronin TCP/UDP/SSL/TLS Proxy.
9
+ Starts a TCP/UDP/SSL/TLS proxy server.
10
10
 
11
11
  ## ARGUMENTS
12
12
 
data/man/ronin-quote.1 CHANGED
@@ -47,7 +47,7 @@ Quotes the data as a C string\.
47
47
  .LP
48
48
  .TP
49
49
  \fB-j\fR, \fB--js\fR
50
- JavaScript quotes the data\.
50
+ quotes the data as a JavaScript string\.
51
51
  .LP
52
52
  .TP
53
53
  \fB-S\fR, \fB--shell\fR
data/man/ronin-quote.1.md CHANGED
@@ -35,7 +35,7 @@ Produces quoted a string for a variety of programming languages.
35
35
  Quotes the data as a C string.
36
36
 
37
37
  `-j`, `--js`
38
- JavaScript quotes the data.
38
+ quotes the data as a JavaScript string.
39
39
 
40
40
  `-S`, `--shell`
41
41
  Quotes the data as a Shell String.
data/man/ronin-rot.1 CHANGED
@@ -50,6 +50,22 @@ given\.
50
50
  \fB-h\fR, \fB--help\fR
51
51
  Print help information\.
52
52
  .LP
53
+ .SH EXAMPLES
54
+ .LP
55
+ .PP
56
+ ROT\-13 encode a string:
57
+ .LP
58
+ .nf
59
+ \[Do] ronin rot \-\-string \[dq]The quick brown fox jumps over the lazy dog\[dq]
60
+ .fi
61
+ .LP
62
+ .PP
63
+ ROT encode a string with a custom rotation number:
64
+ .LP
65
+ .nf
66
+ \[Do] ronin rot \-n 3 \-\-string \[dq]The quick brown fox jumps over the lazy dog\[dq]
67
+ .fi
68
+ .LP
53
69
  .SH AUTHOR
54
70
  .LP
55
71
  .PP
data/man/ronin-rot.1.md CHANGED
@@ -38,6 +38,16 @@ Rotates each character of data with an alphabet.
38
38
  `-h`, `--help`
39
39
  Print help information.
40
40
 
41
+ ## EXAMPLES
42
+
43
+ ROT-13 encode a string:
44
+
45
+ $ ronin rot --string "The quick brown fox jumps over the lazy dog"
46
+
47
+ ROT encode a string with a custom rotation number:
48
+
49
+ $ ronin rot -n 3 --string "The quick brown fox jumps over the lazy dog"
50
+
41
51
  ## AUTHOR
42
52
 
43
53
  Postmodern <postmodern.mod3@gmail.com>
data/man/ronin-sha256.1 CHANGED
@@ -22,7 +22,7 @@ input will be read from \fBstdin\fR\.
22
22
  .SH OPTIONS
23
23
  .LP
24
24
  .TP
25
- \fB-i\fR, \fB--input\fR \fIFILE\fP
25
+ \fB-f\fR, \fB--file\fR \fIFILE\fP
26
26
  Optional input file to read from\.
27
27
  .LP
28
28
  .TP
@@ -16,7 +16,7 @@ Calculates SHA256 hashes of data.
16
16
 
17
17
  ## OPTIONS
18
18
 
19
- `-i`, `--input` *FILE*
19
+ `-f`, `--file` *FILE*
20
20
  Optional input file to read from.
21
21
 
22
22
  `--string` *STRING*
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: ronin
3
3
  version: !ruby/object:Gem::Version
4
- version: 2.0.1
4
+ version: 2.0.2
5
5
  platform: ruby
6
6
  authors:
7
7
  - Postmodern
8
8
  autorequire:
9
9
  bindir: bin
10
10
  cert_chain: []
11
- date: 2023-03-02 00:00:00.000000000 Z
11
+ date: 2023-06-09 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: open_namespace