ronin 2.0.0 → 2.0.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5b96dfac7bb76a9141b93ec0fb0de42a39b33b395ba1a0d946ad6a1be89f080f
-  data.tar.gz: bddecb41842c7930939cce565afc39d93881c27bff7ef51cfb9f730d2e77e020
+  metadata.gz: 31356f467f009277f4c840fb645f3f64bfba3c6d9e1cf1b1bef2dee177dc4b96
+  data.tar.gz: 4cce57a146892ac6b05bf6a41aa35467d50e307c74ed6150cfdf05234aa177f2
 SHA512:
-  metadata.gz: 3c61141e197c44975416cc10c76a13962b9bc3764d1892fc60ded4785aabf960eeab2bbdfb8b1d5e0c6db523afeb3f46c9c9fcb35c15d581fbdab287e185889a
-  data.tar.gz: 1d8f93d1f6bcef6b08cafc1527bfa81d46ab7ddb31bdab97813c4cc3b40c30674d31593a513dcf3468a7ad80134b00165f0cbf1dbb3bcf059f17a828e6dbfd20
+  metadata.gz: 244f986f64b8ee769769ca050321ff3ad6ebe4de5ea7c9f7f509514e32e02d580fbd391bf65c1a35238f2b42825050082fd0a1a06c491e447462a603b7a3c9de
+  data.tar.gz: 312f52036a301608b240fd91a26f2d3632eafd1f0c193ef6127851eb43e69840c443a8f3f9608ab7ad8d522e7fb58d96e45e8e32cdfac00a59e931ed636b7d48

data/.github/workflows/ruby.yml

@@ -30,3 +30,17 @@ jobs:
         run: bundle install --jobs 4 --retry 3
       - name: Run tests
         run: bundle exec rake test
+
+  # rubocop linting
+  rubocop:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v2
+      - name: Set up Ruby
+        uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: 3.0
+      - name: Install dependencies
+        run: bundle install --jobs 4 --retry 3
+      - name: Run rubocop
+        run: bundle exec rubocop --parallel

data/.rubocop.yml

@@ -0,0 +1,21 @@
+AllCops:
+  NewCops: enable
+  SuggestExtensions: false
+  TargetRubyVersion: 3.1
+
+inherit_gem:
+  rubocop-ronin: rubocop.yml
+
+#
+# ronin specific exceptions
+#
+
+# this rule does not take into account the spacing of commented out lines
+Layout/ExtraSpacing:
+  Exclude:
+    - 'Gemfile'
+
+# no need to add `frozen_string_literal: true` to new scripts/projects
+Style/FrozenStringLiteralComment:
+  Exclude:
+    - 'data/new/**/*'

data/ChangeLog.md

@@ -1,4 +1,37 @@
-### 2.0.0 / 2023-XX-XX
+### 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.
+* Require [ronin-core] ~> 0.1, >= 0.1.1.
+* Require [ronin-web] ~> 1.0, >= 1.0.1.
+* Require [ronin-payloads] ~> 0.1, >= 0.1.1.
+* Require [ronin-vulns] ~> 0.1, >= 0.1.2.
+* Require [ronin-exploits] ~> 1.0, >= 1.0.1.
+* Added {Ronin::CLI::HostAndPort} for common `host:port` parsing logic.
+* Minor bug fixes.
+* Improved documentation.
+
+#### CLI
+
+* Ensure that the `ronin http` command works with IDN host-names.
+
+### 2.0.0 / 2023-02-01
 
 * Require `ruby` >= 3.0.0.
 * Require [rouge] ~> 3.0
@@ -756,7 +789,7 @@
 * Require Spidr >= 0.1.3.
 * Moved Ronin::Parameters into the parameters 0.1.0 RubyGem.
 * Added a Ronin::Hexdump module:
-  * Provides Ronin::Hexdump.dump and Kernel#hexdump, which can hexdump any 
+  * Provides Ronin::Hexdump.dump and Kernel#hexdump, which can hexdump any
     object that supports the #each_byte method.
 * Refactored Ronin::Chars::CharSet:
   * Now inherites the SortedSet class.

data/Gemfile

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 source 'https://rubygems.org'
 
 gemspec
@@ -21,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
@@ -70,4 +72,6 @@ group :development do
   gem 'dead_end',        require: false
   gem 'sord',            require: false, platform: :mri
   gem 'stackprof',       require: false, platform: :mri
+  gem 'rubocop',         require: false, platform: :mri
+  gem 'rubocop-ronin',   require: false, platform: :mri
 end

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/Rakefile

@@ -1,11 +1,11 @@
-require 'rubygems'
+# frozen_string_literal: true
 
 begin
   require 'bundler'
 rescue LoadError => e
   warn e.message
   warn "Run `gem install bundler` to install Bundler"
-  exit -1
+  exit(-1)
 end
 
 begin

data/bin/ronin

@@ -1,17 +1,16 @@
 #!/usr/bin/env ruby
+# frozen_string_literal: true
 
 require 'rubygems'
 
 root = File.expand_path(File.join(File.dirname(__FILE__),'..'))
 if File.file?(File.join(root,'Gemfile.lock'))
   Dir.chdir(root) do
-    begin
-      require 'bundler/setup'
-    rescue LoadError => e
-      warn e.message
-      warn "Run `gem install bundler` to install Bundler"
-      exit -1
-    end
+    require 'bundler/setup'
+  rescue LoadError => e
+    warn e.message
+    warn "Run `gem install bundler` to install Bundler"
+    exit(-1)
   end
 end
 

data/data/new/project/Gemfile.erb

@@ -4,13 +4,13 @@ source 'https://rubygems.org'
 gem 'rake'
 
 <%- end -%>
-gem 'ronin-support',         '~> 1.0' #, github: 'ronin-rb/ronin-support'
+gem 'ronin-support',         '~> 1.0' # , github: 'ronin-rb/ronin-support'
 
-# gem 'ronin-code-asm',        '~> 0.3' #, github: 'ronin-rb/ronin-code-asm'
-# gem 'ronin-code-sql',        '~> 1.2' #, github: 'ronin-rb/ronin-code-sql'
-# gem 'ronin-db',              '~> 0.1' #, github: 'ronin-rb/ronin-db'
-# gem 'ronin-web-server',      '~> 0.1' #, github: 'ronin-rb/ronin-web-server'
-# gem 'ronin-web-spider',      '~> 0.1' #, github: 'ronin-rb/ronin-web-spider'
-# gem 'ronin-web-user_agents', '~> 0.1' #, github: 'ronin-rb/ronin-web-user_agents'
-# gem 'ronin-payloads',        '~> 0.1' #, github: 'ronin-rb/ronin-payloads'
-# gem 'ronin-exploits',        '~> 1.0' #, github: 'ronin-rb/ronin-exploits'
+# gem 'ronin-code-asm',        '~> 0.3' # , github: 'ronin-rb/ronin-code-asm'
+# gem 'ronin-code-sql',        '~> 1.2' # , github: 'ronin-rb/ronin-code-sql'
+# gem 'ronin-db',              '~> 0.1' # , github: 'ronin-rb/ronin-db'
+# gem 'ronin-web-server',      '~> 0.1' # , github: 'ronin-rb/ronin-web-server'
+# gem 'ronin-web-spider',      '~> 0.1' # , github: 'ronin-rb/ronin-web-spider'
+# gem 'ronin-web-user_agents', '~> 0.1' # , github: 'ronin-rb/ronin-web-user_agents'
+# gem 'ronin-payloads',        '~> 0.1' # , github: 'ronin-rb/ronin-payloads'
+# gem 'ronin-exploits',        '~> 1.0' # , github: 'ronin-rb/ronin-exploits'

data/gemspec.yml

@@ -2,7 +2,7 @@ name: ronin
 summary: A Ruby toolkit for security research and development.
 description:
   Ronin is a free and Open Source Ruby toolkit for security research and
-  development.Ronin contains many different CLI commands and Ruby libraries for 
+  development.Ronin contains many different CLI commands and Ruby libraries for
   a variety of security tasks, such as encoding/decoding data, filter
   IPs/hosts/URLs, querying ASNs, querying DNS, HTTP, scanning for web
   vulnerabilities, spidering websites, install 3rd party repositories of
@@ -96,17 +96,17 @@ dependencies:
   async-io: ~> 1.0
   wordlist: ~> 1.0
   # Ronin dependencies:
-  ronin-support: ~> 1.0
-  ronin-core: ~> 0.1
+  ronin-support: ~> 1.0, >= 1.0.1
+  ronin-core: ~> 0.1, >= 0.1.1
   ronin-repos: ~> 0.1
   ronin-db: ~> 0.1
   ronin-fuzzer: ~> 0.1
-  ronin-web: ~> 1.0
+  ronin-web: ~> 1.0, >= 1.0.1
   ronin-code-asm: ~> 1.0
   ronin-code-sql: ~> 2.0
-  ronin-payloads: ~> 0.1
-  ronin-exploits: ~> 1.0
-  ronin-vulns: ~> 0.1
+  ronin-payloads: ~> 0.1, >= 0.1.1
+  ronin-exploits: ~> 1.0, >= 1.0.1
+  ronin-vulns: ~> 0.1, >= 0.1.2
 
 development_dependencies:
   bundler: ~> 2.0

data/lib/ronin/cli/char_set_options.rb

@@ -68,7 +68,7 @@ module Ronin
         command.option :include_chars, short: '-i',
                                        value: {
                                          type: String,
-                                         usage: 'CHARS',
+                                         usage: 'CHARS'
                                        },
                                        desc: 'Include the additional chars to the char-set' do |string|
                                          @char_set += Chars::CharSet.new(*string.chars)

data/lib/ronin/cli/cipher_command.rb

@@ -24,6 +24,9 @@ require 'ronin/support/crypto/cipher'
 module Ronin
   class CLI
     module Commands
+      #
+      # Base class for all commands which use ciphers.
+      #
       class CipherCommand < FileProcessorCommand
 
         include KeyOptions
@@ -142,7 +145,6 @@ module Ronin
           cipher.stream(input, block_size: @block_size, output: stdout)
         end
 
-
       end
     end
   end

data/lib/ronin/cli/command.rb

@@ -21,6 +21,9 @@ require 'ronin/root'
 
 module Ronin
   class CLI
+    #
+    # Base class for all `ronin` sub-commands.
+    #
     class Command < Core::CLI::Command
 
       man_dir File.join(ROOT,'man')

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

@@ -151,7 +151,7 @@ module Ronin
               print_asn_record(record)
             else
               print_error "could not find a record for the IP: #{options[:ip]}"
-              exit -1
+              exit(-1)
             end
           else
             print_asn_records(search_asn_records)

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

@@ -17,6 +17,7 @@
 #
 
 require 'ronin/cli/value_processor_command'
+require 'ronin/cli/host_and_port'
 
 require 'ronin/support/network/tcp'
 
@@ -42,6 +43,8 @@ module Ronin
       #
       class BannerGrab < ValueProcessorCommand
 
+        include HostAndPort
+
         usage '[options] {HOST:PORT} ...'
 
         option :with_host_port, desc: 'Print the service with the banner'
@@ -62,8 +65,7 @@ module Ronin
         #   The `HOST:PORT` service pair.
         #
         def process_value(service)
-          host, port = service.split(':',2)
-          port = port.to_i
+          host, port = host_and_port(service)
 
           begin
             banner = Support::Network::TCP.banner(host,port)
@@ -73,7 +75,7 @@ module Ronin
             else
               puts banner
             end
-          rescue => error
+          rescue StandardError => error
             print_error("#{service}: #{error.message}")
           end
         end

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

@@ -17,6 +17,7 @@
 #
 
 require 'ronin/cli/value_processor_command'
+require 'ronin/cli/host_and_port'
 require 'ronin/support/crypto/cert'
 require 'ronin/support/network/ssl/mixin'
 
@@ -62,6 +63,7 @@ module Ronin
         include CommandKit::Printing::Indent
         include CommandKit::Printing::Fields
         include CommandKit::Printing::Lists
+        include HostAndPort
 
         usage '[options] {HOST:PORT | URL | FILE} ...'
 
@@ -100,14 +102,11 @@ module Ronin
         def process_value(value)
           case value
           when /\A[^:]+:\d+\z/
-            host, port = value.split(':',2)
-            port = port.to_i
+            host, port = host_and_port(value)
 
             print_cert(ssl_cert(host,port))
           when /\Ahttps:/
-            uri = URI.parse(value)
-            host = uri.host
-            port = uri.port
+            host, port = host_and_port_from_url(value)
 
             print_cert(ssl_cert(host,port))
           else
@@ -180,8 +179,6 @@ module Ronin
 
           puts
 
-          fields = {}
-
           if options[:extensions]
             puts "Extensions:"
             indent do

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

@@ -103,8 +103,8 @@ module Ronin
 
         option :subject_alt_name, short: '-A',
                                   value: {
-                                     type:  /[a-z0-9:\._-]+/,
-                                     usage: 'HOST|IP'
+                                    type:  /[a-z0-9:\._-]+/,
+                                    usage: 'HOST|IP'
                                   },
                                   desc: 'Adds HOST or IP to subjectAltName' do |value|
                                     @subject_alt_names << value
@@ -277,7 +277,7 @@ module Ronin
           @not_after ||= if options[:not_after]
                            Time.parse(options[:not_after])
                          else
-                           not_before+Support::Crypto::Cert::ONE_YEAR
+                           not_before + Support::Crypto::Cert::ONE_YEAR
                          end
         end
 
@@ -378,7 +378,7 @@ module Ronin
         # @return [String, nil]
         #
         def subject_alt_name_ext
-          if !@subject_alt_names.empty?
+          unless @subject_alt_names.empty?
             @subject_alt_names.map { |name|
               if name =~ IP_REGEXP
                 "IP: #{name}"

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

@@ -17,6 +17,7 @@
 #
 
 require 'ronin/cli/value_processor_command'
+require 'ronin/cli/host_and_port'
 require 'ronin/support/network/ssl/mixin'
 
 require 'uri'
@@ -49,6 +50,7 @@ module Ronin
       #
       class CertGrab < ValueProcessorCommand
 
+        include HostAndPort
         include Support::Network::SSL::Mixin
 
         usage '[options] {HOST:PORT | URL} ...'
@@ -63,7 +65,7 @@ module Ronin
         examples [
           'github.com:443',
           '93.184.216.34:443',
-          'https://github.com/',
+          'https://github.com/'
         ]
 
         man_page 'ronin-cert-grab.1'
@@ -77,14 +79,11 @@ module Ronin
         def process_value(value)
           case value
           when /\A[^:]+:\d+\z/
-            host, port = value.split(':',2)
-            port = port.to_i
+            host, port = host_and_port(value)
 
             grab_cert(host,port)
           when /\Ahttps:/
-            uri = URI.parse(value)
-            host = uri.host
-            port = uri.port
+            host, port = host_and_port_from_url(value)
 
             grab_cert(host,port)
           else

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

@@ -61,14 +61,14 @@ module Ronin
       class Decode < StringMethodsCommand
 
         option :base16, desc: 'Base16 decodes the data' do
-                          require 'ronin/support/encoding/base16'
-                          @method_calls << :base16_decode
-                        end
+          require 'ronin/support/encoding/base16'
+          @method_calls << :base16_decode
+        end
 
         option :base32, desc: 'Base32 decodes the data' do
-                          require 'ronin/support/encoding/base32'
-                          @method_calls << :base32_decode
-                        end
+          require 'ronin/support/encoding/base32'
+          @method_calls << :base32_decode
+        end
 
         option :base64, short: '-b',
                         equals: true,
@@ -78,11 +78,11 @@ module Ronin
                         },
                         desc: 'Base64 decodes the data' do |mode=nil|
                           require 'ronin/support/encoding/base64'
-                          if mode
-                            @method_calls << [:base64_decode, [mode]]
-                          else
-                            @method_calls << :base64_decode
-                          end
+                          @method_calls << if mode
+                                             [:base64_decode, [mode]]
+                                           else
+                                             :base64_decode
+                                           end
                         end
 
         option :zlib, short: '-z',
@@ -122,9 +122,9 @@ module Ronin
                      end
 
         option :http, desc: 'HTTP decodes the data' do
-                        require 'ronin/support/encoding/http'
-                        @method_calls << :http_decode
-                      end
+          require 'ronin/support/encoding/http'
+          @method_calls << :http_decode
+        end
 
         option :js, short: '-j',
                     desc: 'JavaScript decodes the data' do

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: {