ronin 2.0.5 → 2.1.0.rc1

Sign up to get free protection for your applications and to get access to all the features.
Files changed (169) hide show
  1. checksums.yaml +4 -4
  2. data/.github/workflows/ruby.yml +3 -3
  3. data/.gitignore +1 -0
  4. data/.rubocop.yml +5 -1
  5. data/ChangeLog.md +56 -1
  6. data/Gemfile +66 -29
  7. data/README.md +162 -17
  8. data/Rakefile +9 -0
  9. data/data/completions/ronin +655 -0
  10. data/data/templates/dns_proxy.rb.erb +35 -0
  11. data/gemspec.yml +27 -13
  12. data/lib/ronin/cli/binary_template.rb +124 -0
  13. data/lib/ronin/cli/commands/archive.rb +104 -0
  14. data/lib/ronin/cli/commands/banner_grab.rb +2 -0
  15. data/lib/ronin/cli/commands/bitflip.rb +1 -1
  16. data/lib/ronin/cli/commands/bitsquat.rb +119 -0
  17. data/lib/ronin/cli/commands/cert_dump.rb +20 -4
  18. data/lib/ronin/cli/commands/cert_gen.rb +9 -19
  19. data/lib/ronin/cli/commands/cert_grab.rb +4 -3
  20. data/lib/ronin/cli/commands/completion.rb +115 -0
  21. data/lib/ronin/cli/commands/dns_proxy.rb +235 -0
  22. data/lib/ronin/cli/commands/http.rb +80 -8
  23. data/lib/ronin/cli/commands/ip.rb +101 -0
  24. data/lib/ronin/cli/commands/iprange.rb +25 -8
  25. data/lib/ronin/cli/commands/netcat.rb +2 -0
  26. data/lib/ronin/cli/commands/new/dns_listener.rb +37 -0
  27. data/lib/ronin/cli/commands/new/dns_proxy.rb +99 -0
  28. data/lib/ronin/cli/commands/new/exploit.rb +34 -0
  29. data/lib/ronin/cli/commands/new/http_listener.rb +37 -0
  30. data/lib/ronin/cli/commands/new/nokogiri.rb +33 -0
  31. data/lib/ronin/cli/commands/new/payload.rb +34 -0
  32. data/lib/ronin/cli/commands/new/project.rb +1 -1
  33. data/lib/ronin/cli/commands/new/script.rb +1 -1
  34. data/lib/ronin/cli/commands/new/web_app.rb +37 -0
  35. data/lib/ronin/cli/commands/new/web_server.rb +37 -0
  36. data/lib/ronin/cli/commands/new/web_spider.rb +37 -0
  37. data/lib/ronin/cli/commands/new.rb +3 -1
  38. data/lib/ronin/cli/commands/pack.rb +339 -0
  39. data/lib/ronin/cli/commands/public_suffix_list.rb +2 -0
  40. data/lib/ronin/cli/commands/tld_list.rb +2 -0
  41. data/lib/ronin/cli/commands/unarchive.rb +128 -0
  42. data/lib/ronin/cli/commands/unhexdump.rb +3 -1
  43. data/lib/ronin/cli/commands/unpack.rb +195 -0
  44. data/lib/ronin/cli/commands/url.rb +2 -0
  45. data/lib/ronin/cli/http_shell.rb +25 -0
  46. data/lib/ronin/cli.rb +10 -0
  47. data/lib/ronin/version.rb +1 -1
  48. data/man/ronin-archive.1.md +49 -0
  49. data/man/ronin-asn.1 +60 -77
  50. data/man/ronin-asn.1.md +25 -21
  51. data/man/ronin-banner-grab.1 +10 -21
  52. data/man/ronin-banner-grab.1.md +9 -5
  53. data/man/ronin-bitflip.1 +35 -61
  54. data/man/ronin-bitflip.1.md +30 -26
  55. data/man/ronin-bitsquat.1 +40 -0
  56. data/man/ronin-bitsquat.1.md +43 -0
  57. data/man/ronin-cert-dump.1 +44 -54
  58. data/man/ronin-cert-dump.1.md +18 -14
  59. data/man/ronin-cert-gen.1 +73 -94
  60. data/man/ronin-cert-gen.1.md +38 -34
  61. data/man/ronin-cert-grab.1 +29 -37
  62. data/man/ronin-cert-grab.1.md +12 -8
  63. data/man/ronin-completion.1 +78 -0
  64. data/man/ronin-completion.1.md +80 -0
  65. data/man/ronin-decode.1 +32 -63
  66. data/man/ronin-decode.1.md +29 -25
  67. data/man/ronin-decrypt.1 +42 -57
  68. data/man/ronin-decrypt.1.md +20 -16
  69. data/man/ronin-dns-proxy.1 +100 -0
  70. data/man/ronin-dns-proxy.1.md +70 -0
  71. data/man/ronin-dns.1 +10 -21
  72. data/man/ronin-dns.1.md +9 -5
  73. data/man/ronin-email-addr.1 +27 -40
  74. data/man/ronin-email-addr.1.md +15 -11
  75. data/man/ronin-encode.1 +93 -63
  76. data/man/ronin-encode.1.md +64 -26
  77. data/man/ronin-encrypt.1 +42 -57
  78. data/man/ronin-encrypt.1.md +20 -16
  79. data/man/ronin-entropy.1 +11 -21
  80. data/man/ronin-entropy.1.md +8 -4
  81. data/man/ronin-escape.1 +22 -46
  82. data/man/ronin-escape.1.md +22 -18
  83. data/man/ronin-extract.1 +74 -149
  84. data/man/ronin-extract.1.md +73 -69
  85. data/man/ronin-grep.1 +77 -155
  86. data/man/ronin-grep.1.md +76 -72
  87. data/man/ronin-help.1 +3 -14
  88. data/man/ronin-help.1.md +2 -2
  89. data/man/ronin-hexdump.1 +249 -265
  90. data/man/ronin-hexdump.1.md +93 -89
  91. data/man/ronin-highlight.1 +8 -18
  92. data/man/ronin-highlight.1.md +8 -4
  93. data/man/ronin-hmac.1 +17 -30
  94. data/man/ronin-hmac.1.md +14 -10
  95. data/man/ronin-homoglyph.1 +11 -22
  96. data/man/ronin-homoglyph.1.md +10 -6
  97. data/man/ronin-host.1 +23 -47
  98. data/man/ronin-host.1.md +22 -18
  99. data/man/ronin-http.1 +40 -69
  100. data/man/ronin-http.1.md +40 -30
  101. data/man/ronin-ip.1 +70 -80
  102. data/man/ronin-ip.1.md +44 -28
  103. data/man/ronin-iprange.1 +14 -22
  104. data/man/ronin-iprange.1.md +12 -5
  105. data/man/ronin-irb.1 +9 -17
  106. data/man/ronin-irb.1.md +7 -3
  107. data/man/ronin-md5.1 +13 -24
  108. data/man/ronin-md5.1.md +11 -7
  109. data/man/ronin-netcat.1 +25 -51
  110. data/man/ronin-netcat.1.md +25 -21
  111. data/man/ronin-new-dns-proxy.1 +45 -0
  112. data/man/ronin-new-dns-proxy.1.md +44 -0
  113. data/man/ronin-new-project.1 +32 -45
  114. data/man/ronin-new-project.1.md +11 -11
  115. data/man/ronin-new-script.1 +10 -22
  116. data/man/ronin-new-script.1.md +4 -4
  117. data/man/ronin-new.1 +56 -31
  118. data/man/ronin-new.1.md +48 -8
  119. data/man/ronin-pack.1 +977 -0
  120. data/man/ronin-pack.1.md +929 -0
  121. data/man/ronin-proxy.1 +37 -63
  122. data/man/ronin-proxy.1.md +29 -25
  123. data/man/ronin-public-suffix-list.1 +16 -32
  124. data/man/ronin-public-suffix-list.1.md +13 -9
  125. data/man/ronin-quote.1 +17 -36
  126. data/man/ronin-quote.1.md +17 -13
  127. data/man/ronin-rot.1 +26 -39
  128. data/man/ronin-rot.1.md +15 -11
  129. data/man/ronin-sha1.1 +13 -24
  130. data/man/ronin-sha1.1.md +11 -7
  131. data/man/ronin-sha256.1 +13 -24
  132. data/man/ronin-sha256.1.md +11 -7
  133. data/man/ronin-sha512.1 +13 -24
  134. data/man/ronin-sha512.1.md +11 -7
  135. data/man/ronin-strings.1 +30 -55
  136. data/man/ronin-strings.1.md +27 -23
  137. data/man/ronin-tips.1 +8 -16
  138. data/man/ronin-tips.1.md +7 -3
  139. data/man/ronin-tld-list.1 +16 -32
  140. data/man/ronin-tld-list.1.md +13 -9
  141. data/man/ronin-typo.1 +14 -28
  142. data/man/ronin-typo.1.md +13 -9
  143. data/man/ronin-typosquat.1 +15 -32
  144. data/man/ronin-typosquat.1.md +15 -11
  145. data/man/ronin-unarchive.1.md +41 -0
  146. data/man/ronin-unescape.1 +22 -46
  147. data/man/ronin-unescape.1.md +22 -18
  148. data/man/ronin-unhexdump.1 +81 -91
  149. data/man/ronin-unhexdump.1.md +16 -12
  150. data/man/ronin-unpack.1 +978 -0
  151. data/man/ronin-unpack.1.md +920 -0
  152. data/man/ronin-unquote.1 +17 -36
  153. data/man/ronin-unquote.1.md +17 -13
  154. data/man/ronin-url.1 +19 -40
  155. data/man/ronin-url.1.md +19 -15
  156. data/man/ronin-xor.1 +14 -28
  157. data/man/ronin-xor.1.md +13 -9
  158. data/man/ronin.1 +208 -29
  159. data/man/ronin.1.md +156 -11
  160. data/scripts/setup +58 -0
  161. metadata +162 -73
  162. data/lib/ronin/config.rb +0 -95
  163. /data/data/{new → templates}/project/.gitignore +0 -0
  164. /data/data/{new → templates}/project/.ruby-version.erb +0 -0
  165. /data/data/{new → templates}/project/Dockerfile.erb +0 -0
  166. /data/data/{new → templates}/project/Gemfile.erb +0 -0
  167. /data/data/{new → templates}/project/Rakefile +0 -0
  168. /data/data/{new → templates}/project/project.rb.erb +0 -0
  169. /data/data/{new → templates}/script.rb.erb +0 -0
data/man/ronin-hexdump.1 CHANGED
@@ -1,29 +1,24 @@
1
- .\" Generated by kramdown-man 0.1.8
1
+ .\" Generated by kramdown-man 1.0.1
2
2
  .\" https://github.com/postmodern/kramdown-man#readme
3
3
  .TH ronin-hexdump 1 "2023-02-01" Ronin "User Manuals"
4
- .LP
4
+ .SH NAME
5
+ .PP
6
+ ronin\-hexdump \- Hexdumps data in a variaty of encodings and formats
5
7
  .SH SYNOPSIS
6
- .LP
7
- .HP
8
+ .PP
8
9
  \fBronin hexdump\fR \[lB]\fIoptions\fP\[rB] \[lB]\fIFILE\fP \.\.\.\[rB]
9
- .LP
10
10
  .SH DESCRIPTION
11
- .LP
12
11
  .PP
13
12
  Hexdumps data in a variety of encodings and formats\.
14
- .LP
15
13
  .SH ARGUMENTS
16
- .LP
17
14
  .TP
18
15
  \fIFILE\fP
19
16
  The optional path to the file(s) to hexdump\.
20
- .LP
21
17
  .SH OPTIONS
22
- .LP
23
18
  .TP
24
- \fB-t\fR, \fB--type\fR \fITYPE\fP
19
+ \fB\-t\fR, \fB\-\-type\fR \fITYPE\fP
25
20
  The binary data type to decode the data as\. Must be one of the following:
26
- .LP
21
+ .RS
27
22
  .RS
28
23
  .IP \(bu 2
29
24
  \fBint8\fR
@@ -38,219 +33,197 @@ The binary data type to decode the data as\. Must be one of the following:
38
33
  .IP \(bu 2
39
34
  \fBint16\fR
40
35
  .IP \(bu 2
41
- \fBint16_le\fR
36
+ \fBint16\[ru]le\fR
42
37
  .IP \(bu 2
43
- \fBint16_be\fR
38
+ \fBint16\[ru]be\fR
44
39
  .IP \(bu 2
45
- \fBint16_ne\fR
40
+ \fBint16\[ru]ne\fR
46
41
  .IP \(bu 2
47
42
  \fBuint16\fR
48
43
  .IP \(bu 2
49
- \fBuint16_le\fR
44
+ \fBuint16\[ru]le\fR
50
45
  .IP \(bu 2
51
- \fBuint16_be\fR
46
+ \fBuint16\[ru]be\fR
52
47
  .IP \(bu 2
53
- \fBuint16_ne\fR
48
+ \fBuint16\[ru]ne\fR
54
49
  .IP \(bu 2
55
50
  \fBshort\fR
56
51
  .IP \(bu 2
57
- \fBshort_le\fR
52
+ \fBshort\[ru]le\fR
58
53
  .IP \(bu 2
59
- \fBshort_be\fR
54
+ \fBshort\[ru]be\fR
60
55
  .IP \(bu 2
61
- \fBshort_ne\fR
56
+ \fBshort\[ru]ne\fR
62
57
  .IP \(bu 2
63
58
  \fBushort\fR
64
59
  .IP \(bu 2
65
- \fBushort_le\fR
60
+ \fBushort\[ru]le\fR
66
61
  .IP \(bu 2
67
- \fBushort_be\fR
62
+ \fBushort\[ru]be\fR
68
63
  .IP \(bu 2
69
- \fBushort_ne\fR
64
+ \fBushort\[ru]ne\fR
70
65
  .IP \(bu 2
71
66
  \fBint32\fR
72
67
  .IP \(bu 2
73
- \fBint32_le\fR
68
+ \fBint32\[ru]le\fR
74
69
  .IP \(bu 2
75
- \fBint32_be\fR
70
+ \fBint32\[ru]be\fR
76
71
  .IP \(bu 2
77
- \fBint32_ne\fR
72
+ \fBint32\[ru]ne\fR
78
73
  .IP \(bu 2
79
74
  \fBuint32\fR
80
75
  .IP \(bu 2
81
- \fBuint32_le\fR
76
+ \fBuint32\[ru]le\fR
82
77
  .IP \(bu 2
83
- \fBuint32_be\fR
78
+ \fBuint32\[ru]be\fR
84
79
  .IP \(bu 2
85
- \fBuint32_ne\fR
80
+ \fBuint32\[ru]ne\fR
86
81
  .IP \(bu 2
87
82
  \fBint\fR
88
83
  .IP \(bu 2
89
84
  \fBlong\fR
90
85
  .IP \(bu 2
91
- \fBlong_le\fR
86
+ \fBlong\[ru]le\fR
92
87
  .IP \(bu 2
93
- \fBlong_be\fR
88
+ \fBlong\[ru]be\fR
94
89
  .IP \(bu 2
95
- \fBlong_ne\fR
90
+ \fBlong\[ru]ne\fR
96
91
  .IP \(bu 2
97
92
  \fBuint\fR
98
93
  .IP \(bu 2
99
94
  \fBulong\fR
100
95
  .IP \(bu 2
101
- \fBulong_le\fR
96
+ \fBulong\[ru]le\fR
102
97
  .IP \(bu 2
103
- \fBulong_be\fR
98
+ \fBulong\[ru]be\fR
104
99
  .IP \(bu 2
105
- \fBulong_ne\fR
100
+ \fBulong\[ru]ne\fR
106
101
  .IP \(bu 2
107
102
  \fBint64\fR
108
103
  .IP \(bu 2
109
- \fBint64_le\fR
104
+ \fBint64\[ru]le\fR
110
105
  .IP \(bu 2
111
- \fBint64_be\fR
106
+ \fBint64\[ru]be\fR
112
107
  .IP \(bu 2
113
- \fBint64_ne\fR
108
+ \fBint64\[ru]ne\fR
114
109
  .IP \(bu 2
115
110
  \fBuint64\fR
116
111
  .IP \(bu 2
117
- \fBuint64_le\fR
112
+ \fBuint64\[ru]le\fR
118
113
  .IP \(bu 2
119
- \fBuint64_be\fR
114
+ \fBuint64\[ru]be\fR
120
115
  .IP \(bu 2
121
- \fBuint64_ne\fR
116
+ \fBuint64\[ru]ne\fR
122
117
  .IP \(bu 2
123
- \fBlong_long\fR
118
+ \fBlong\[ru]long\fR
124
119
  .IP \(bu 2
125
- \fBlong_long_le\fR
120
+ \fBlong\[ru]long\[ru]le\fR
126
121
  .IP \(bu 2
127
- \fBlong_long_be\fR
122
+ \fBlong\[ru]long\[ru]be\fR
128
123
  .IP \(bu 2
129
- \fBlong_long_ne\fR
124
+ \fBlong\[ru]long\[ru]ne\fR
130
125
  .IP \(bu 2
131
- \fBulong_long\fR
126
+ \fBulong\[ru]long\fR
132
127
  .IP \(bu 2
133
- \fBulong_long_le\fR
128
+ \fBulong\[ru]long\[ru]le\fR
134
129
  .IP \(bu 2
135
- \fBulong_long_be\fR
130
+ \fBulong\[ru]long\[ru]be\fR
136
131
  .IP \(bu 2
137
- \fBulong_long_ne\fR
132
+ \fBulong\[ru]long\[ru]ne\fR
138
133
  .IP \(bu 2
139
134
  \fBfloat\fR
140
135
  .IP \(bu 2
141
- \fBfloat_le\fR
136
+ \fBfloat\[ru]le\fR
142
137
  .IP \(bu 2
143
- \fBfloat_be\fR
138
+ \fBfloat\[ru]be\fR
144
139
  .IP \(bu 2
145
- \fBfloat_ne\fR
140
+ \fBfloat\[ru]ne\fR
146
141
  .IP \(bu 2
147
142
  \fBdouble\fR
148
143
  .IP \(bu 2
149
- \fBdouble_le\fR
144
+ \fBdouble\[ru]le\fR
150
145
  .IP \(bu 2
151
- \fBdouble_be\fR
146
+ \fBdouble\[ru]be\fR
152
147
  .IP \(bu 2
153
- \fBdouble_ne\fR
148
+ \fBdouble\[ru]ne\fR
149
+ .RE
154
150
  .RE
155
- .LP
156
151
  .TP
157
- \fB-O\fR, \fB--offset\fR \fIINDEX\fP
152
+ \fB\-O\fR, \fB\-\-offset\fR \fIINDEX\fP
158
153
  Start reading data at the given offset within the file or data stream\.
159
- .LP
160
154
  .TP
161
- \fB-L\fR, \fB--length\fR \fILEN\fP
155
+ \fB\-L\fR, \fB\-\-length\fR \fILEN\fP
162
156
  Only read at most \fILEN\fP bytes of data\.
163
- .LP
164
157
  .TP
165
- \fB-Z\fR, \fB--zero-pad\fR
158
+ \fB\-Z\fR, \fB\-\-zero\-pad\fR
166
159
  Enables zero\-padding the input data so that it aligns with the data type
167
- specified by \fB-t\fR,\fB--type\fR\.
168
- .LP
160
+ specified by \fB\-t\fR,\fB\-\-type\fR\.
169
161
  .TP
170
- \fB-c\fR, \fB--columns\fR \fIWIDTH\fP
162
+ \fB\-c\fR, \fB\-\-columns\fR \fIWIDTH\fP
171
163
  The number of bytes to hexdump per line\.
172
- .LP
173
164
  .TP
174
- \fB-g\fR, \`\-\-group\-columns \fIWIDTH\fP
165
+ \fB\-g\fR, \`\-\-group\-columns \fIWIDTH\fP
175
166
  Groups the columns of hexdumped numbers together into groupings of \fIWIDTH\fP\.
176
- .LP
177
167
  .TP
178
- \fB-G\fR, \fB--group-chars\fR \fIWIDTH\fP\[or]\fBtype\fR
168
+ \fB\-G\fR, \fB\-\-group\-chars\fR \fIWIDTH\fP\[or]\fBtype\fR
179
169
  Group the characters into columns of groupings of \fIWIDTH\fP, separated by the
180
- \fB|\fR character\. If \fBtype\fR is given, the size of the \fB-t\fR,\fB--type\fR type in bytes
170
+ \fB\[or]\fR character\. If \fBtype\fR is given, the size of the \fB\-t\fR,\fB\-\-type\fR type in bytes
181
171
  will be used for the character grouping width\.
182
- .LP
183
172
  .TP
184
- \fB-r\fR, \fB--[no-]repeating\fR
173
+ \fB\-r\fR, \fB\-\-\[lB]no\-\[rB]repeating\fR
185
174
  Allows consecutive repeating lines in hexdump output\. By default consecutive
186
175
  repeating lines of data are omitted by a single \fB*\fR line\.
187
- .LP
188
176
  .TP
189
- \fB-b\fR, \fB--base\fR \fB2\fR\[or]\fB8\fR\[or]\fB10\fR\[or]\fB16\fR
177
+ \fB\-b\fR, \fB\-\-base\fR \fB2\fR\[or]\fB8\fR\[or]\fB10\fR\[or]\fB16\fR
190
178
  The numeric base to print hexdumped numbers in\.
191
- .LP
192
179
  .TP
193
- \fB-B\fR, \fB--index-base\fR \fB2\fR\[or]\fB8\fR\[or]\fB10\fR\[or]\fB16\fR
180
+ \fB\-B\fR, \fB\-\-index\-base\fR \fB2\fR\[or]\fB8\fR\[or]\fB10\fR\[or]\fB16\fR
194
181
  The numeric base to print the index addresses in\.
195
- .LP
196
182
  .TP
197
- \fB-I\fR, \fB--index-offset\fR \fIINT\fP
183
+ \fB\-I\fR, \fB\-\-index\-offset\fR \fIINT\fP
198
184
  The starting value for the index addresses\.
199
- .LP
200
185
  .TP
201
- \fB-C\fR, \fB--[no-]chars-column\fR
186
+ \fB\-C\fR, \fB\-\-\[lB]no\-\[rB]chars\-column\fR
202
187
  Enables or disables the display of the characters column\.
203
- .LP
204
188
  .TP
205
- \fB-E\fR, \fB--encoding\fR \fBascii\fR\[or]\fButf8\fR
189
+ \fB\-E\fR, \fB\-\-encoding\fR \fBascii\fR\[or]\fButf8\fR
206
190
  The character encoding to display the characters in\. Default to \fBascii\fR\.
207
- .LP
208
191
  .TP
209
- \fB--style-index\fR \fISTYLE\fP
192
+ \fB\-\-style\-index\fR \fISTYLE\fP
210
193
  Applies ANSI styling to the index column\.
211
194
  See the \fIANSI STYLES\fP section for all possible style names\.
212
- .LP
213
195
  .TP
214
- \fB--style-numeric\fR \fISTYLE\fP
196
+ \fB\-\-style\-numeric\fR \fISTYLE\fP
215
197
  Applies ANSI styling to the numeric column\.
216
198
  See the \fIANSI STYLES\fP section for all possible style names\.
217
- .LP
218
199
  .TP
219
- \fB--style-chars\fR \fISTYLE\fP
200
+ \fB\-\-style\-chars\fR \fISTYLE\fP
220
201
  Applies ANSI styling to the characters column\.
221
202
  See the \fIANSI STYLES\fP section for all possible style names\.
222
- .LP
223
203
  .TP
224
- \fB--highlight-index\fR \fIPATTERN\fP:\fISTYLE\fP
204
+ \fB\-\-highlight\-index\fR \fIPATTERN\fP:\fISTYLE\fP
225
205
  Applies ANSI highlighting to the index column\.
226
206
  \fIPATTERN\fP may be either a literal \fISTRING\fP value or a \[sl]\fIREGEXP\fP\[sl] value\.
227
207
  See the \fIANSI STYLES\fP section for all possible style names\.
228
- .LP
229
208
  .TP
230
- \fB--highlight-numeric\fR \fIPATTERN\fP:\fISTYLE\fP
209
+ \fB\-\-highlight\-numeric\fR \fIPATTERN\fP:\fISTYLE\fP
231
210
  Applies ANSI highlighting to the numeric column
232
211
  \fIPATTERN\fP may be either a literal \fISTRING\fP value or a \[sl]\fIREGEXP\fP\[sl] value\.
233
212
  See the \fIANSI STYLES\fP section for all possible style names\.
234
- .LP
235
213
  .TP
236
- \fB--highlight-chars\fR \fIPATTERN\fP:\fISTYLE\fP
214
+ \fB\-\-highlight\-chars\fR \fIPATTERN\fP:\fISTYLE\fP
237
215
  Applies ANSI highlighting to the characters column
238
216
  \fIPATTERN\fP may be either a literal \fISTRING\fP value or a \[sl]\fIREGEXP\fP\[sl] value\.
239
217
  See the \fIANSI STYLES\fP section for all possible style names\.
240
- .LP
241
218
  .TP
242
- \fB-h\fR, \fB--help\fR
219
+ \fB\-h\fR, \fB\-\-help\fR
243
220
  Prints help information\.
244
- .LP
245
221
  .SH ANSI STYLES
246
- .LP
247
222
  .PP
248
223
  An ANSI style string is comma\-separated list of one or more ANSI style names
249
224
  (ex: \fBgray,bold\fR)\.
250
- .LP
251
225
  .PP
252
226
  Font styles:
253
- .LP
254
227
  .RS
255
228
  .IP \(bu 2
256
229
  \fBbold\fR
@@ -265,10 +238,8 @@ Font styles:
265
238
  .IP \(bu 2
266
239
  \fBstrike\fR
267
240
  .RE
268
- .LP
269
241
  .PP
270
242
  Foreground colors:
271
- .LP
272
243
  .RS
273
244
  .IP \(bu 2
274
245
  \fBblack\fR
@@ -287,226 +258,239 @@ Foreground colors:
287
258
  .IP \(bu 2
288
259
  \fBwhite\fR
289
260
  .RE
290
- .LP
291
261
  .PP
292
262
  Background colors:
293
- .LP
294
263
  .RS
295
264
  .IP \(bu 2
296
- \fBon_black\fR
265
+ \fBon\[ru]black\fR
297
266
  .IP \(bu 2
298
- \fBon_red\fR
267
+ \fBon\[ru]red\fR
299
268
  .IP \(bu 2
300
- \fBon_green\fR
269
+ \fBon\[ru]green\fR
301
270
  .IP \(bu 2
302
- \fBon_yellow\fR
271
+ \fBon\[ru]yellow\fR
303
272
  .IP \(bu 2
304
- \fBon_blue\fR
273
+ \fBon\[ru]blue\fR
305
274
  .IP \(bu 2
306
- \fBon_magenta\fR
275
+ \fBon\[ru]magenta\fR
307
276
  .IP \(bu 2
308
- \fBon_cyan\fR
277
+ \fBon\[ru]cyan\fR
309
278
  .IP \(bu 2
310
- \fBon_white\fR
279
+ \fBon\[ru]white\fR
311
280
  .RE
312
- .LP
313
281
  .SH EXAMPLES
314
- .LP
315
282
  .PP
316
283
  Hexdump a file:
317
- .LP
318
- .nf
319
- \[Do] ronin hexdump \[sl]bin\[sl]ls
320
- 00000000 7f 45 4c 46 02 01 01 00 00 00 00 00 00 00 00 00 \[or]\.ELF\.\.\.\.\.\.\.\.\.\.\.\.\[or]
321
- 00000010 03 00 3e 00 01 00 00 00 d0 6b 00 00 00 00 00 00 \[or]\.\.>\.\.\.\.\.\.k\.\.\.\.\.\.\[or]
322
- 00000020 40 00 00 00 00 00 00 00 18 23 02 00 00 00 00 00 \[or]\[at]\.\.\.\.\.\.\.\.\[sh]\.\.\.\.\.\.\[or]
323
- 00000030 00 00 00 00 40 00 38 00 0d 00 40 00 20 00 1f 00 \[or]\.\.\.\.\[at]\.8\.\.\.\[at]\. \.\.\.\[or]
324
- 00000040 06 00 00 00 04 00 00 00 40 00 00 00 00 00 00 00 \[or]\.\.\.\.\.\.\.\.\[at]\.\.\.\.\.\.\.\[or]
325
- 00000050 40 00 00 00 00 00 00 00 40 00 00 00 00 00 00 00 \[or]\[at]\.\.\.\.\.\.\.\[at]\.\.\.\.\.\.\.\[or]
326
- \.\.\.
327
- .fi
328
- .LP
284
+ .PP
285
+ .RS 4
286
+ .EX
287
+ \[Do] ronin hexdump \[sl]bin\[sl]ls
288
+ 00000000 7f 45 4c 46 02 01 01 00 00 00 00 00 00 00 00 00 \[or]\.ELF\.\.\.\.\.\.\.\.\.\.\.\.\[or]
289
+ 00000010 03 00 3e 00 01 00 00 00 d0 6b 00 00 00 00 00 00 \[or]\.\.>\.\.\.\.\.\.k\.\.\.\.\.\.\[or]
290
+ 00000020 40 00 00 00 00 00 00 00 18 23 02 00 00 00 00 00 \[or]\[at]\.\.\.\.\.\.\.\.\[sh]\.\.\.\.\.\.\[or]
291
+ 00000030 00 00 00 00 40 00 38 00 0d 00 40 00 20 00 1f 00 \[or]\.\.\.\.\[at]\.8\.\.\.\[at]\. \.\.\.\[or]
292
+ 00000040 06 00 00 00 04 00 00 00 40 00 00 00 00 00 00 00 \[or]\.\.\.\.\.\.\.\.\[at]\.\.\.\.\.\.\.\[or]
293
+ 00000050 40 00 00 00 00 00 00 00 40 00 00 00 00 00 00 00 \[or]\[at]\.\.\.\.\.\.\.\[at]\.\.\.\.\.\.\.\[or]
294
+ \.\.\.
295
+ .EE
296
+ .RE
329
297
  .PP
330
298
  Hexdump a UTF\-8 data:
331
- .LP
332
- .nf
333
- \[Do] ronin hexdump \-\-encoding utf8 file\.txt
334
- 00000000 e8 80 80 e8 80 80 e8 80 80 e8 80 80 e8 80 80 e8 \[or]耀耀耀耀耀\.\[or]
335
- 00000010 80 80 e8 80 80 e8 80 80 \[or]\.\.耀耀\[or]
336
- 00000018
337
- .fi
338
- .LP
299
+ .PP
300
+ .RS 4
301
+ .EX
302
+ \[Do] ronin hexdump \-\-encoding utf8 file\.txt
303
+ 00000000 e8 80 80 e8 80 80 e8 80 80 e8 80 80 e8 80 80 e8 \[or]耀耀耀耀耀\.\[or]
304
+ 00000010 80 80 e8 80 80 e8 80 80 \[or]\.\.耀耀\[or]
305
+ 00000018
306
+ .EE
307
+ .RE
339
308
  .PP
340
309
  Control the number of columns:
341
- .LP
342
- .nf
343
- \[Do] ronin hexdump \-\-columns 10 a\.txt
344
- 00000000 41 41 41 41 41 41 41 41 41 41 \[or]AAAAAAAAAA\[or]
345
- \.\.\.
346
- .fi
347
- .LP
310
+ .PP
311
+ .RS 4
312
+ .EX
313
+ \[Do] ronin hexdump \-\-columns 10 a\.txt
314
+ 00000000 41 41 41 41 41 41 41 41 41 41 \[or]AAAAAAAAAA\[or]
315
+ \.\.\.
316
+ .EE
317
+ .RE
348
318
  .PP
349
319
  Show repeating data instead of omitting them with a \fB*\fR:
350
- .LP
351
- .nf
352
- \[Do] ronin hexdump \-\-repeating a\.txt
353
- 00000000 41 41 41 41 41 41 41 41 41 41 \[or]AAAAAAAAAA\[or]
354
- 0000000a 41 41 41 41 41 41 41 41 41 41 \[or]AAAAAAAAAA\[or]
355
- 00000014 41 41 41 41 41 41 41 41 41 41 \[or]AAAAAAAAAA\[or]
356
- .fi
357
- .LP
320
+ .PP
321
+ .RS 4
322
+ .EX
323
+ \[Do] ronin hexdump \-\-repeating a\.txt
324
+ 00000000 41 41 41 41 41 41 41 41 41 41 \[or]AAAAAAAAAA\[or]
325
+ 0000000a 41 41 41 41 41 41 41 41 41 41 \[or]AAAAAAAAAA\[or]
326
+ 00000014 41 41 41 41 41 41 41 41 41 41 \[or]AAAAAAAAAA\[or]
327
+ .EE
328
+ .RE
358
329
  .PP
359
330
  Grouping columns together:
360
- .LP
361
- .nf
362
- \[Do] ronin hexdump \-\-group\-columns 4 \-\-columns 16 abcd\.txt
363
- 00000000 41 42 43 44 41 42 43 44 41 42 43 44 41 42 43 44 \[or]ABCDABCDABCDABCD\[or]
364
- \.\.\.
365
- .fi
366
- .LP
331
+ .PP
332
+ .RS 4
333
+ .EX
334
+ \[Do] ronin hexdump \-\-group\-columns 4 \-\-columns 16 abcd\.txt
335
+ 00000000 41 42 43 44 41 42 43 44 41 42 43 44 41 42 43 44 \[or]ABCDABCDABCDABCD\[or]
336
+ \.\.\.
337
+ .EE
338
+ .RE
367
339
  .PP
368
340
  Grouping the characters together:
369
- .LP
370
- .nf
371
- \[Do] ronin hexdump \-\-group\-chars 4 abcd\.txt
372
- 00000000 41 42 43 44 41 42 43 44 41 42 43 44 41 42 43 44 \[or]ABCD\[or]ABCD\[or]ABCD\[or]ABCD\[or]
373
- \.\.\.
374
- .fi
375
- .LP
341
+ .PP
342
+ .RS 4
343
+ .EX
344
+ \[Do] ronin hexdump \-\-group\-chars 4 abcd\.txt
345
+ 00000000 41 42 43 44 41 42 43 44 41 42 43 44 41 42 43 44 \[or]ABCD\[or]ABCD\[or]ABCD\[or]ABCD\[or]
346
+ \.\.\.
347
+ .EE
348
+ .RE
376
349
  .PP
377
350
  Disabling the characters column:
378
- .LP
379
- .nf
380
- \[Do] ronin hexdump \-\-no\-chars\-column a\.txt
381
- 00000000 41 41 41 41 41 41 41 41 41 41 41 41 41 41 41 41
382
- \.\.\.
383
- .fi
384
- .LP
351
+ .PP
352
+ .RS 4
353
+ .EX
354
+ \[Do] ronin hexdump \-\-no\-chars\-column a\.txt
355
+ 00000000 41 41 41 41 41 41 41 41 41 41 41 41 41 41 41 41
356
+ \.\.\.
357
+ .EE
358
+ .RE
385
359
  .PP
386
360
  Print the numbers as decimals (base 10):
387
- .LP
388
- .nf
389
- \[Do] ronin hexdump \-\-base 10 hello\.txt
390
- 00000000 104 101 108 108 111 0 \[or]hello\.\[or]
391
- .fi
392
- .LP
361
+ .PP
362
+ .RS 4
363
+ .EX
364
+ \[Do] ronin hexdump \-\-base 10 hello\.txt
365
+ 00000000 104 101 108 108 111 0 \[or]hello\.\[or]
366
+ .EE
367
+ .RE
393
368
  .PP
394
369
  Print the numbers as octals (base 8):
395
- .LP
396
- .nf
397
- \[Do] ronin hexdump \-\-base 8 hello\.txt
398
- 00000000 0150 0145 0154 0154 0157 0000 \[or]hello\.\[or]
399
- .fi
400
- .LP
370
+ .PP
371
+ .RS 4
372
+ .EX
373
+ \[Do] ronin hexdump \-\-base 8 hello\.txt
374
+ 00000000 0150 0145 0154 0154 0157 0000 \[or]hello\.\[or]
375
+ .EE
376
+ .RE
401
377
  .PP
402
378
  Print the numbers as binary (base 2):
403
- .LP
404
- .nf
405
- \[Do] ronin hexdump \-\-base 2 hello\.txt
406
- 00000000 01101000 01100101 01101100 01101100 01101111 00000000 \[or]hello\.\[or]
407
- .fi
408
- .LP
379
+ .PP
380
+ .RS 4
381
+ .EX
382
+ \[Do] ronin hexdump \-\-base 2 hello\.txt
383
+ 00000000 01101000 01100101 01101100 01101100 01101111 00000000 \[or]hello\.\[or]
384
+ .EE
385
+ .RE
409
386
  .PP
410
387
  Decode \fBuint32\fR values:
411
- .LP
412
- .nf
413
- \[Do] ronin hexdump \-\-type uint32 abcd\.txt
414
- 00000000 44434241 44434241 44434241 44434241 \[or]ABCDABCDABCDABCD\[or]
415
- \.\.\.
416
- .fi
417
- .LP
388
+ .PP
389
+ .RS 4
390
+ .EX
391
+ \[Do] ronin hexdump \-\-type uint32 abcd\.txt
392
+ 00000000 44434241 44434241 44434241 44434241 \[or]ABCDABCDABCDABCD\[or]
393
+ \.\.\.
394
+ .EE
395
+ .RE
418
396
  .PP
419
397
  Decode \fBuint32\fR (little\-endian) values:
420
- .LP
421
- .nf
422
- \[Do] ronin hexdump \-\-type uint32\[ru]le abcd\.txt
423
- 00000000 44434241 44434241 44434241 44434241 \[or]ABCDABCDABCDABCD\[or]
424
- \.\.\.
425
- .fi
426
- .LP
398
+ .PP
399
+ .RS 4
400
+ .EX
401
+ \[Do] ronin hexdump \-\-type uint32\[ru]le abcd\.txt
402
+ 00000000 44434241 44434241 44434241 44434241 \[or]ABCDABCDABCDABCD\[or]
403
+ \.\.\.
404
+ .EE
405
+ .RE
427
406
  .PP
428
407
  Decode \fBuint32\fR (big\-endian) values:
429
- .LP
430
- .nf
431
- \[Do] ronin hexdump \-\-type uint32\[ru]be abcd\.txt
432
- 00000000 41424344 41424344 41424344 41424344 \[or]ABCDABCDABCDABCD\[or]
433
- \.\.\.
434
- .fi
435
- .LP
408
+ .PP
409
+ .RS 4
410
+ .EX
411
+ \[Do] ronin hexdump \-\-type uint32\[ru]be abcd\.txt
412
+ 00000000 41424344 41424344 41424344 41424344 \[or]ABCDABCDABCDABCD\[or]
413
+ \.\.\.
414
+ .EE
415
+ .RE
436
416
  .PP
437
417
  Decode \fBint32\fR values:
438
- .LP
439
- .nf
440
- \[Do] ronin hexdump \-\-type int32 \-\-base 10 data\.bin
441
- 00000000 65535 \-1 \[or]\.\.\.\.\.\.\.\.\[or]
442
- 00000008
443
- .fi
444
- .LP
418
+ .PP
419
+ .RS 4
420
+ .EX
421
+ \[Do] ronin hexdump \-\-type int32 \-\-base 10 data\.bin
422
+ 00000000 65535 \-1 \[or]\.\.\.\.\.\.\.\.\[or]
423
+ 00000008
424
+ .EE
425
+ .RE
445
426
  .PP
446
427
  Decode characters:
447
- .LP
448
- .nf
449
- \[Do] ronin hexdump \-\-type char hello\.txt
450
- 00000000 h e l l o \e0 \[or]hello\.\[or]
451
- 00000006
452
- .fi
453
- .LP
428
+ .PP
429
+ .RS 4
430
+ .EX
431
+ \[Do] ronin hexdump \-\-type char hello\.txt
432
+ 00000000 h e l l o \e0 \[or]hello\.\[or]
433
+ 00000006
434
+ .EE
435
+ .RE
454
436
  .PP
455
437
  Decode \fBfloat\fR values:
456
- .LP
457
- .nf
458
- \[Do] ronin hexdump \-\-type float64\[ru]le floats\.bin
459
- 00000000 0\.000000e\[pl]00 1\.000000e\[pl]00 \[or]\.\.\.\.\.\.\.\.\.\.\.\.\.\.\.?\[or]
460
- 00000010 \-1\.000000e\[pl]00 NaN \[or]\.\.\.\.\.\.\.\.\.\.\.\.\.\.\.\.\[or]
461
- \.\.\.
462
- .fi
463
- .LP
438
+ .PP
439
+ .RS 4
440
+ .EX
441
+ \[Do] ronin hexdump \-\-type float64\[ru]le floats\.bin
442
+ 00000000 0\.000000e\[pl]00 1\.000000e\[pl]00 \[or]\.\.\.\.\.\.\.\.\.\.\.\.\.\.\.?\[or]
443
+ 00000010 \-1\.000000e\[pl]00 NaN \[or]\.\.\.\.\.\.\.\.\.\.\.\.\.\.\.\.\[or]
444
+ \.\.\.
445
+ .EE
446
+ .RE
464
447
  .PP
465
448
  Skipping to an offset:
466
- .LP
467
- .nf
468
- \[Do] ronin hexdump \-\-offset 7 data\.bin
469
- .fi
470
- .LP
449
+ .PP
450
+ .RS 4
451
+ .EX
452
+ \[Do] ronin hexdump \-\-offset 7 data\.bin
453
+ .EE
454
+ .RE
471
455
  .PP
472
456
  Zero\-pad the data:
473
- .LP
474
- .nf
475
- \[Do] ronin hexdump \-\-type uint32\[ru]be \-\-zero\-pad abcd\.txt
476
- 00000000 41424344 41424344 41424344 41424344 \[or]ABCDABCDABCDABCD\[or]
477
- 00000010 41420000 \[or]AB\.\.\[or]
478
- 00000014
479
- .fi
480
- .LP
457
+ .PP
458
+ .RS 4
459
+ .EX
460
+ \[Do] ronin hexdump \-\-type uint32\[ru]be \-\-zero\-pad abcd\.txt
461
+ 00000000 41424344 41424344 41424344 41424344 \[or]ABCDABCDABCDABCD\[or]
462
+ 00000010 41420000 \[or]AB\.\.\[or]
463
+ 00000014
464
+ .EE
465
+ .RE
481
466
  .PP
482
467
  ANSI coloring:
483
- .LP
484
- .nf
485
- \[Do] ronin hexdump \-\-style\-index white \e
486
- \-\-style\-numeric green \e
487
- \-\-style\-chars cyan \e
488
- data\.bin
489
- .fi
490
- .LP
468
+ .PP
469
+ .RS 4
470
+ .EX
471
+ \[Do] ronin hexdump \-\-style\-index white \e
472
+ \-\-style\-numeric green \e
473
+ \-\-style\-chars cyan \e
474
+ data\.bin
475
+ .EE
476
+ .RE
491
477
  .PP
492
478
  ANSI highlighting:
493
- .LP
494
- .nf
495
- \[Do] ronin hexdump \-\-highlight\-index \[sl]00\[Do]\[sl]:white,bold \e
496
- \-\-highlight\-numeric \[sl]\(ha\[lB]8\-f\[rB]\[lB]0\-9a\-f\[rB]\[Do]\[sl]:faint \e
497
- \-\-highlight\-numeric \[sl]f\[sl]:cyan \e
498
- \-\-highlight\-numeric 00:black,on\[ru]red \e
499
- \-\-highlight\-chars \[sl]\[lB]\(ha\e\.\[rB]\[pl]\[sl]:green data\.bin
500
- .fi
501
- .LP
479
+ .PP
480
+ .RS 4
481
+ .EX
482
+ \[Do] ronin hexdump \-\-highlight\-index \[sl]00\[Do]\[sl]:white,bold \e
483
+ \-\-highlight\-numeric \[sl]\(ha\[lB]8\-f\[rB]\[lB]0\-9a\-f\[rB]\[Do]\[sl]:faint \e
484
+ \-\-highlight\-numeric \[sl]f\[sl]:cyan \e
485
+ \-\-highlight\-numeric 00:black,on\[ru]red \e
486
+ \-\-highlight\-chars \[sl]\[lB]\(ha\e\.\[rB]\[pl]\[sl]:green data\.bin
487
+ .EE
488
+ .RE
502
489
  .SH AUTHOR
503
- .LP
504
490
  .PP
505
491
  Postmodern
506
492
  .MT postmodern\.mod3\[at]gmail\.com
507
493
  .ME
508
- .LP
509
494
  .SH SEE ALSO
510
- .LP
511
495
  .PP
512
- ronin\-unhexdump(1)
496
+ .BR ronin\-unhexdump (1)