ruby-amass 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 1e89dca421caa03c019648a989c64b545471cf47a7796c9e70c626d96f628a72
+  data.tar.gz: 10ff26f9389cd237cde1ab09b8f4a1f780f202745bac4342219baae5307dc108
+SHA512:
+  metadata.gz: 8c9a8a0816938edce764ee7b2d037adbc481bc8eb50f88f49f1b6892d4197592e0a845a3b89e0c0b757fd8b2f97760a0a93023e13233e359b6912c0713a90114
+  data.tar.gz: 0cebc829f9bd63ddfc48dbbe4f0936cedfbc58ef91486c4c0a27676a037c4a32e91f0167391c966423c5c1f5496b75a5f9307c094cf9246d1e5324e170dbe338

data/.document

@@ -0,0 +1,3 @@
+-
+ChangeLog.md
+LICENSE.txt

data/.editorconfig

@@ -0,0 +1,11 @@
+root = true
+
+[*]
+end_of_line = lf
+insert_final_newline = true
+tab_width = 8
+trim_trailing_whitespace = true
+
+[{Gemfile,Rakefile,*.rb,*.gemspec,*.yml}]
+indent_style = space
+indent_size = 2

data/.github/workflows/ruby.yml

@@ -0,0 +1,27 @@
+name: CI
+
+on: [ push, pull_request ]
+
+jobs:
+  tests:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        ruby:
+          - 2.6
+          - 2.7
+          - 3.0
+          - jruby
+          - truffleruby
+    name: Ruby ${{ matrix.ruby }}
+    steps:
+      - uses: actions/checkout@v2
+      - name: Set up Ruby
+        uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: ${{ matrix.ruby }}
+      - name: Install dependencies
+        run: bundle install --jobs 4 --retry 3
+      - name: Run tests
+        run: bundle exec rake test

data/.gitignore

@@ -0,0 +1,11 @@
+/Gemfile.lock
+/coverage
+/doc
+/pkg
+/.yardoc
+.DS_Store
+*.db
+*.log
+*.swp
+*~
+*.gem

data/.rspec

@@ -0,0 +1 @@
+--colour --format documentation

data/.yardopts

@@ -0,0 +1 @@
+--markup markdown --title 'Ruby Amass Documentation' --protected

data/ChangeLog.md

@@ -0,0 +1,10 @@
+### 0.1.0 / 2021-11-30
+
+* Initial release:
+  * Added {Amass::Command}.
+  * Added {Amass::OutputFile}.
+  * Added {Amass::Parsers::TXT}.
+  * Added {Amass::Parsers::JSON}.
+  * Added {Amass::Address}.
+  * Added {Amass::Hostname}.
+

data/Gemfile

@@ -0,0 +1,16 @@
+source 'https://rubygems.org'
+
+gemspec
+
+# gem 'command_mapper', '~> 0.1', github: 'postmodern/command_mapper.rb'
+
+group :development do
+  gem 'rake'
+  gem 'rubygems-tasks', '~> 0.2'
+  gem 'rspec',          '~> 3.0'
+  gem 'simplecov',      '~> 0.7'
+
+  gem 'kramdown'
+  gem 'yard',           '~> 0.9'
+  gem 'yard-spellcheck', require: false
+end

data/LICENSE.txt

@@ -0,0 +1,20 @@
+Copyright (c) 2021 Hal Brodigan
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+'Software'), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
+CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
+TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
+SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,94 @@
+# ruby-amass
+
+[![CI](https://github.com/postmodern/ruby-amass/actions/workflows/ruby.yml/badge.svg)](https://github.com/postmodern/ruby-amass/actions/workflows/ruby.yml)
+[![Gem Version](https://badge.fury.io/rb/ruby-amass.svg)](https://badge.fury.io/rb/ruby-amass)
+
+* [Source](https://github.com/postmodern/ruby-amass/)
+* [Issues](https://github.com/postmodern/ruby-amass/issues)
+* [Documentation](http://rubydoc.info/gems/ruby-amass/frames)
+
+## Description
+
+A Ruby interface to [amass], an in-depth Attack Surface Mapping and Asset
+Discovery tool.
+
+## Features
+
+* Provides a [Ruby interface][Amass::Command] for running the `amass` command.
+* Supports [parsing][Amass::OutputFile] Amass `.txt` and `.json` output files.
+
+[Amass::Command]: https://rubydoc.info/gems/ruby-amass/Amass/Command
+[Amass::OutputFile]: https://rubydoc.info/gems/ruby-amass/Amass/OutputFile
+
+## Examples
+
+Run `amass enum -d example.com -dir ...` from Ruby:
+
+```ruby
+require 'amass/command'
+
+Amass::Command.run(enum: {domain: 'example.com', output_dir: '/path/to/output/dir'})
+```
+
+Parser an `amass` JSON file:
+
+```ruby
+require 'amass/output_file'
+
+output_file = Amass::OutputFile.new('/path/to/amass.json')
+output_file.each do |hostname|
+  p hostname
+end
+```
+
+```
+#<Amass::Hostname:0x0000565365b58308 @name="www.example.com", @domain="example.com", @addresses=[#<Amass::Address:0x0000565365b58538 @ip="93.184.216.34", @cidr="93.184.216.0/24", @asn=15133, @desc="EDGECAST - MCI Communications Services, Inc. d/b/a Verizon Business">, #<Amass::Address:0x0000565365b58448 @ip="2606:2800:220:1:248:1893:25c8:1946", @cidr="2606:2800:220::/48", @asn=15133, @desc="EDGECAST - MCI Communications Services, Inc. d/b/a Verizon Business">], @tag="cert", @sources=["CertSpotter"]>
+#<Amass::Hostname:0x0000565365b46568 @name="example.com", @domain="example.com", @addresses=[#<Amass::Address:0x0000565365b466f8 @ip="2606:2800:220:1:248:1893:25c8:1946", @cidr="2606:2800:220::/48", @asn=15133, @desc="EDGECAST - MCI Communications Services, Inc. d/b/a Verizon Business">, #<Amass::Address:0x0000565365b466a8 @ip="93.184.216.34", @cidr="93.184.216.0/24", @asn=15133, @desc="EDGECAST - MCI Communications Services, Inc. d/b/a Verizon Business">], @tag="cert", @sources=["CertSpotter"]>
+#<Amass::Hostname:0x0000565365b44f88 @name="waterregion643.example.com", @domain="example.com", @addresses=[#<Amass::Address:0x0000565365b45078 @ip="54.144.128.85", @cidr="54.144.0.0/14", @asn=14618, @desc="AMAZON-AES - Amazon.com, Inc.">], @tag="api", @sources=["Sublist3rAPI"]>
+#<Amass::Hostname:0x0000565365b3b7d0 @name="ringneo5.example.com", @domain="example.com", @addresses=[#<Amass::Address:0x0000565365b44100 @ip="54.144.128.85", @cidr="54.144.0.0/14", @asn=14618, @desc="AMAZON-AES - Amazon.com, Inc.">], @tag="api", @sources=["Sublist3rAPI"]>
+#<Amass::Hostname:0x0000565365b3a628 @name="ratara72.example.com", @domain="example.com", @addresses=[#<Amass::Address:0x0000565365b3a7e0 @ip="54.144.128.85", @cidr="54.144.0.0/14", @asn=14618, @desc="AMAZON-AES - Amazon.com, Inc.">], @tag="api", @sources=["Sublist3rAPI"]>
+#<Amass::Hostname:0x0000565365b39688 @name="serafim.example.com", @domain="example.com", @addresses=[#<Amass::Address:0x0000565365b39700 @ip="54.144.128.85", @cidr="54.144.0.0/14", @asn=14618, @desc="AMAZON-AES - Amazon.com, Inc.">], @tag="api", @sources=["Sublist3rAPI"]>
+#<Amass::Hostname:0x0000565365b38a30 @name="a8boyyy.example.com", @domain="example.com", @addresses=[#<Amass::Address:0x0000565365b38b48 @ip="54.144.128.85", @cidr="54.144.0.0/14", @asn=14618, @desc="AMAZON-AES - Amazon.com, Inc.">], @tag="api", @sources=["Sublist3rAPI"]>
+#<Amass::Hostname:0x0000565365b33738 @name="bikamzhaz.example.com", @domain="example.com", @addresses=[#<Amass::Address:0x0000565365b33800 @ip="54.144.128.85", @cidr="54.144.0.0/14", @asn=14618, @desc="AMAZON-AES - Amazon.com, Inc.">], @tag="api", @sources=["Sublist3rAPI"]>
+#<Amass::Hostname:0x0000565365b324a0 @name="wwwakamai.example.com", @domain="example.com", @addresses=[#<Amass::Address:0x0000565365b32518 @ip="54.144.128.85", @cidr="54.144.0.0/14", @asn=14618, @desc="AMAZON-AES - Amazon.com, Inc.">], @tag="alt", @sources=["Alterations"]>
+#<Amass::Hostname:0x0000565365b305b0 @name="wwwakamaiint.example.com", @domain="example.com", @addresses=[#<Amass::Address:0x0000565365b30650 @ip="54.144.128.85", @cidr="54.144.0.0/14", @asn=14618, @desc="AMAZON-AES - Amazon.com, Inc.">], @tag="alt", @sources=["Alterations"]>
+#<Amass::Hostname:0x0000565365b2ba60 @name="billing-serafim.example.com", @domain="example.com", @addresses=[#<Amass::Address:0x0000565365b2bb50 @ip="54.144.128.85", @cidr="54.144.0.0/14", @asn=14618, @desc="AMAZON-AES - Amazon.com, Inc.">], @tag="alt", @sources=["Alterations"]>
+#<Amass::Hostname:0x0000565365b29058 @name="bikamzhazstaff.example.com", @domain="example.com", @addresses=[#<Amass::Address:0x0000565365b29968 @ip="54.144.128.85", @cidr="54.144.0.0/14", @asn=14618, @desc="AMAZON-AES - Amazon.com, Inc.">], @tag="alt", @sources=["Alterations"]>
+#<Amass::Hostname:0x0000565365b23680 @name="bikamzhaz-6.example.com", @domain="example.com", @addresses=[#<Amass::Address:0x0000565365b23810 @ip="54.144.128.85", @cidr="54.144.0.0/14", @asn=14618, @desc="AMAZON-AES - Amazon.com, Inc.">], @tag="alt", @sources=["Alterations"]>
+#<Amass::Hostname:0x0000565365b22a50 @name="wwwakamaiintorigin.example.com", @domain="example.com", @addresses=[#<Amass::Address:0x0000565365b22ac8 @ip="54.144.128.85", @cidr="54.144.0.0/14", @asn=14618, @desc="AMAZON-AES - Amazon.com, Inc.">], @tag="alt", @sources=["Alterations"]>
+```
+
+## Requirements
+
+* [ruby] >= 2.0.0
+* [amass] >= 3.0.0
+* [command_mapper] ~> 0.1
+
+[ruby]: https://www.ruby-lang.org/
+[command_mapper]: https://github.com/postmodern/command_mapper.rb#readme
+
+## Install
+
+```shell
+$ gem install ruby-amass
+```
+
+### gemspec
+
+```ruby
+gemspec.add_dependency 'ruby-amass', '~> 0.1'
+```
+
+### Gemfile
+
+```ruby
+gem 'ruby-amass', '~> 0.1'
+```
+
+## License
+
+Copyright (c) 2021 Hal Brodigan
+
+See {file:LICENSE.txt} for license information.
+
+[amass]: https://github.com/OWASP/Amass#readme

data/Rakefile

@@ -0,0 +1,23 @@
+# encoding: utf-8
+
+require 'rubygems'
+
+begin
+  require 'bundler/setup'
+rescue LoadError => e
+  warn e.message
+  warn "Run `gem install bundler` to install Bundler"
+  exit -1
+end
+
+require 'rubygems/tasks'
+Gem::Tasks.new
+
+require 'rspec/core/rake_task'
+RSpec::Core::RakeTask.new
+task :test    => :spec
+task :default => :spec
+
+require 'yard'
+YARD::Rake::YardocTask.new
+task :doc => :yard

data/gemspec.yml

@@ -0,0 +1,28 @@
+name: ruby-amass
+summary: A Ruby interface to amass.
+description:
+  A Ruby interface to amass, an in-depth Attack Surface Mapping and Asset
+  Discovery tool.
+
+license: MIT
+authors: Postmodern
+email: postmodern.mod3@gmail.com
+homepage: https://github.com/postmodern/ruby-amass#readme
+has_yard: true
+
+metadata:
+  documentation_uri: https://rubydoc.info/gems/ruby-amass
+  source_code_uri:   https://github.com/postmodern/ruby-amass
+  bug_tracker_uri:   https://github.com/postmodern/ruby-amass/issues
+  changelog_uri:     https://github.com/postmodern/ruby-amass/blob/master/ChangeLog.md
+  rubygems_mfa_required: 'true'
+
+required_ruby_version: ">= 2.0.0"
+
+requirements: amass >= 3.0.0
+
+dependencies:
+  command_mapper: ~> 0.1
+
+development_dependencies:
+  bundler: ~> 2.0

data/lib/amass/address.rb

@@ -0,0 +1,64 @@
+module Amass
+  #
+  # An address of a hostname.
+  #
+  # @api public
+  #
+  class Address
+
+    # The IP v4 or v6 address.
+    #
+    # @return [String]
+    attr_reader :ip
+
+    # The CIDR mask.
+    #
+    # @return [String]
+    attr_reader :cidr
+
+    # The ASN number.
+    #
+    # @return [Integer]
+    attr_reader :asn
+
+    # The description of the address.
+    #
+    # @return [String]
+    attr_reader :desc
+
+    alias description desc
+
+    #
+    # Initializes the address.
+    #
+    # @param [String] ip
+    #   An IP v4 or v6 address.
+    #
+    # @param [String] cidr
+    #   The IP address in CIDR format.
+    #
+    # @param [Integer] asn
+    #   The ASN number for the IP address.
+    #
+    # @param [String] desc
+    #   A description of the IP address.
+    #
+    def initialize(ip: , cidr: , asn: , desc: )
+      @ip   = ip
+      @cidr = cidr
+      @asn  = asn
+      @desc = desc
+    end
+
+    #
+    # Converts the address to a String.
+    #
+    # @return [String]
+    #   The IP address.
+    #
+    def to_s
+      @ip
+    end
+
+  end
+end

data/lib/amass/command.rb

@@ -0,0 +1,341 @@
+require 'command_mapper/command'
+
+module Amass
+  #
+  # Represents the `amass` command and it's subcommands.
+  #
+  # ## Example
+  #
+  #     require 'amass/command'
+  #     
+  #     Amass::Command.run(enum: {domain: 'example.com', output_dir: '/path/to/output/dir'})
+  #
+  # ## `amass` subcommands
+  #
+  # ### `amass intel`
+  #
+  # * `-active` - `amass.active`
+  # * `-addr` - `amass.addr`
+  # * `-asn` - `amass.asn`
+  # * `-cidr` - `amass.cidr`
+  # * `-config` - `amass.config`
+  # * `-d` - `amass.domain`
+  # * `-demo` - `amass.demo`
+  # * `-df` - `amass.domains_file`
+  # * `-dir` - `amass.output_dir`
+  # * `-ef` - `amass.exclude_file`
+  # * `-exclude` - `amass.exclude`
+  # * `-help` - `amass.help`
+  # * `-if` - `amass.include_file`
+  # * `-include` - `amass.include`
+  # * `-ip` - `amass.ip`
+  # * `-ipv4` - `amass.ipv4`
+  # * `-ipv6` - `amass.ipv6`
+  # * `-list` - `amass.list`
+  # * `-log` - `amass.log`
+  # * `-max-dns-queries` - `amass.max_dns_queries`
+  # * `-o` - `amass.output`
+  # * `-org` - `amass.org`
+  # * `-p` - `amass.ports`
+  # * `-r` - `amass.resolver`
+  # * `-rf` - `amass.resolver_file`
+  # * `-src` - `amass.src`
+  # * `-timeout` - `amass.timeout`
+  # * `-v` - `amass.verbose`
+  # * `-whois` - `amass.whois`
+  #
+  # ### `amass enum`
+  #
+  # * `-active` - `amass.active`
+  # * `-addr` - `amass.addr`
+  # * `-asn` - `amass.asn`
+  # * `-aw` - `amass.alterations_wordlist_file`
+  # * `-awm` - `amass.alterations_wordlist_mask`
+  # * `-bl` - `amass.blacklist`
+  # * `-blf` - `amass.blacklist_file`
+  # * `-brute` - `amass.bruteforce`
+  # * `-cidr` - `amass.cidr`
+  # * `-config` - `amass.config`
+  # * `-d` - `amass.domain`
+  # * `-demo` - `amass.demo`
+  # * `-df` - `amass.domains_file`
+  # * `-dir` - `amass.output_dir`
+  # * `-ef` - `amass.exclude_file`
+  # * `-exclude` - `amass.exclude`
+  # * `-help` - `amass.help`
+  # * `-if` - `amass.include_file`
+  # * `-iface` - `amass.iface`
+  # * `-include` - `amass.include`
+  # * `-ip` - `amass.ip`
+  # * `-ipv4` - `amass.ipv4`
+  # * `-ipv6` - `amass.ipv6`
+  # * `-json` - `amass.json`
+  # * `-list` - `amass.list`
+  # * `-log` - `amass.log`
+  # * `-max-depth` - `amass.max_depth`
+  # * `-max-dns-queries` - `amass.max_dns_queries`
+  # * `-min-for-recursive` - `amass.min_for_recursive`
+  # * `-nf` - `amass.known_subdomains_file`
+  # * `-noalts` - `amass.no_alts`
+  # * `-nocolor` - `amass.no_color`
+  # * `-nolocaldb` - `amass.no_localdb`
+  # * `-norecursive` - `amass.no_recursive`
+  # * `-o` - `amass.output`
+  # * `-oA` - `amass.output_prefix`
+  # * `-p` - `amass.ports`
+  # * `-passive` - `amass.passive`
+  # * `-r` - `amass.resolver`
+  # * `-rf` - `amass.resolver_file`
+  # * `-scripts` - `amass.scripts`
+  # * `-share` - `amass.share`
+  # * `-silent` - `amass.silent`
+  # * `-src` - `amass.src`
+  # * `-timeout` - `amass.timeout`
+  # * `-v` - `amass.verbose`
+  # * `-w` - `amass.wordlist_file`
+  # * `-wm` - `amass.wordlist_mask`
+  #
+  # ### `amass viz`
+  #
+  # * `-config` - `amass.config`
+  # * `-d` - `amass.domain`
+  # * `-d3` - `amass.d3`
+  # * `-df` - `amass.domains_file`
+  # * `-dir` - `amass.database_dir`
+  # * `-dot` - `amass.dot`
+  # * `-enum` - `amass.enum`
+  # * `-gexf` - `amass.gexf`
+  # * `-graphistry` - `amass.graphistry`
+  # * `-help` - `amass.help`
+  # * `-i` - `amass.input`
+  # * `-maltego` - `amass.maltego`
+  # * `-nocolor` - `amass.nocolor`
+  # * `-o` - `amass.output`
+  # * `-silent` - `amass.silent`
+  #
+  # ### `amass track`
+  #
+  # * `-config` - `amass.config`
+  # * `-d` - `amass.domain`
+  # * `-df` - `amass.domains_file`
+  # * `-dir` - `amass.output_dir`
+  # * `-help` - `amass.help`
+  # * `-history` - `amass.history`
+  # * `-last` - `amass.last`
+  # * `-nocolor` - `amass.nocolor`
+  # * `-silent` - `amass.silent`
+  # * `-since` - `amass.since`
+  #
+  # ### `amass db`
+  #
+  # * `-config` - `amass.config`
+  # * `-d` - `amass.domain`
+  # * `-demo` - `amass.demo`
+  # * `-df` - `amass.domains_file`
+  # * `-dir` - `amass.output_dir`
+  # * `-enum` - `amass.enum`
+  # * `-help` - `amass.help`
+  # * `-ip` - `amass.ip`
+  # * `-ipv4` - `amass.ipv4`
+  # * `-ipv6` - `amass.ipv6`
+  # * `-list` - `amass.list`
+  # * `-names` - `amass.names`
+  # * `-nocolor` - `amass.nocolor`
+  # * `-o` - `amass.output`
+  # * `-show` - `amass.show`
+  # * `-silent` - `amass.silent`
+  # * `-src` - `amass.src`
+  # * `-summary` - `amass.summary`
+  #
+  # ### `amass dns`
+  #
+  # * `-bl` - `amass.blacklist`
+  # * `-blf` - `amass.blacklist_file`
+  # * `-config` - `amass.config`
+  # * `-d` - `amass.domain`
+  # * `-demo` - `amass.demo`
+  # * `-df` - `amass.domains_file`
+  # * `-dir` - `amass.output_dir`
+  # * `-help` - `amass.help`
+  # * `-ip` - `amass.ip`
+  # * `-ipv4` - `amass.ipv4`
+  # * `-ipv6` - `amass.ipv6`
+  # * `-json` - `amass.json`
+  # * `-log` - `amass.log`
+  # * `-max-dns-queries` - `amass.max_dns_queries`
+  # * `-nf` - `amass.known_subdomains_file`
+  # * `-o` - `amass.output`
+  # * `-oA` - `amass.output_prefix`
+  # * `-r` - `amass.resolver`
+  # * `-rf` - `amass.resolver_file`
+  # * `-t` - `amass.type`
+  # * `-timeout` - `amass.timeout`
+  # * `-v` - `amass.verbose`
+  #
+  # @api public
+  #
+  class Command < CommandMapper::Command
+
+    command 'amass' do
+      subcommand :intel do
+        option '-active'
+        option '-addr', value: true
+        option '-asn', value: true
+        option '-cidr', value: true
+        option '-config', value: {type: InputFile.new}
+        option '-d', name: :domain, value: true, repeats: true
+        option '-demo'
+        option '-df', name: :domains_file, value: true
+        option '-dir', name: :output_dir, value: true
+        option '-ef', name: :exclude_file, value: {type: InputFile.new}
+        option '-exclude', value: true
+        option '-help'
+        option '-if', name: :include_file, value: {type: InputFile.new}
+        option '-include', value: {type: List.new}
+        option '-ip'
+        option '-ipv4'
+        option '-ipv6'
+        option '-list'
+        option '-log', value: true
+        option '-max-dns-queries', value: {type: Num.new}
+        option '-o', name: :output, value: true
+        option '-org', value: true
+        option '-p', name: :ports, value: {type: List.new}
+        option '-r', name: :resolver, value: true, repeats: true
+        option '-rf', name: :resolver_file, value: true
+        option '-src'
+        option '-timeout', value: {type: Num.new}
+        option '-v', name: :verbose
+        option '-whois'
+      end
+
+      subcommand :enum do
+        option '-active'
+        option '-addr', value: true
+        option '-asn', value: true
+        option '-aw', name: :alterations_wordlist_file, value: {type: InputFile.new}
+        option '-awm', name: :alterations_wordlist_mask, value: true
+        option '-bl', name: :blacklist, value: true
+        option '-blf', name: :blacklist_file, value: {type: InputFile.new}
+        option '-brute', name: :bruteforce
+        option '-cidr', value: true, repeats: true
+        option '-config', value: {type: InputFile.new}
+        option '-d', name: :domain, value: true, repeats: true
+        option '-demo'
+        option '-df', name: :domains_file, value: {type: InputFile.new}
+        option '-dir', name: :output_dir, value: true
+        option '-ef', name: :exclude_file, value: {type: InputFile.new}
+        option '-exclude', value: true
+        option '-help'
+        option '-if', name: :include_file, value: {type: InputFile.new}
+        option '-iface', value: true
+        option '-include', value: {type: List.new}
+        option '-ip'
+        option '-ipv4'
+        option '-ipv6'
+        option '-json', value: true
+        option '-list'
+        option '-log', value: true
+        option '-max-depth', value: {type: Num.new}
+        option '-max-dns-queries', value: {type: Num.new}
+        option '-min-for-recursive', value: {type: Num.new}
+        option '-nf', name: :known_subdomains_file, value: {type: InputFile.new}
+        option '-noalts', name: :no_alts
+        option '-nocolor', name: :no_color
+        option '-nolocaldb', name: :no_localdb
+        option '-norecursive', name: :no_recursive
+        option '-o', name: :output, value: true
+        option '-oA', name: :output_prefix, value: true
+        option '-p', name: :ports, value: {type: List.new}
+        option '-passive'
+        option '-r', name: :resolver, value: true, repeats: true
+        option '-rf', name: :resolver_file, value: true
+        option '-scripts', value: {type: InputDir.new}
+        option '-share'
+        option '-silent'
+        option '-src'
+        option '-timeout', value: {type: Num.new}
+        option '-v', name: :verbose
+        option '-w', name: :wordlist_file, value: {type: InputFile.new}
+        option '-wm', name: :wordlist_mask, value: true
+      end
+
+      subcommand :viz do
+        option '-config', value: true
+        option '-d', name: :domain, value: true, repeats: true
+        option '-d3'
+        option '-df', name: :domains_file, value: true
+        option '-dir', name: :database_dir, value: true
+        option '-dot'
+        option '-enum', value: {type: Num.new}
+        option '-gexf'
+        option '-graphistry'
+        option '-help'
+        option '-i', name: :input, value: {type: InputFile.new}
+        option '-maltego'
+        option '-nocolor'
+        option '-o', name: :output, value: true
+        option '-silent'
+      end
+
+      subcommand :track do
+        option '-config', value: {type: InputFile.new}
+        option '-d', name: :domain, value: true, repeats: true
+        option '-df', name: :domains_file, value: true
+        option '-dir', name: :output_dir, value: true
+        option '-help'
+        option '-history'
+        option '-last', value: {type: Num.new}
+        option '-nocolor'
+        option '-silent'
+        option '-since', value: true
+      end
+
+      subcommand :db do
+        option '-config', value: {type: InputFile.new}
+        option '-d', name: :domain, value: true, repeats: true
+        option '-demo'
+        option '-df', name: :domains_file, value: true
+        option '-dir', name: :output_dir, value: true
+        option '-enum', value: {type: Num.new}
+        option '-help'
+        option '-ip'
+        option '-ipv4'
+        option '-ipv6'
+        option '-list'
+        option '-names'
+        option '-nocolor'
+        option '-o', name: :output, value: true
+        option '-show'
+        option '-silent'
+        option '-src'
+        option '-summary'
+      end
+
+      subcommand :dns do
+        option '-bl', name: :blacklist, value: true
+        option '-blf', name: :blacklist_file, value: {type: InputFile.new}
+        option '-config', value: {type: InputFile.new}
+        option '-d', name: :domain, value: true, repeats: true
+        option '-demo'
+        option '-df', name: :domains_file, value: true
+        option '-dir', name: :output_dir, value: true
+        option '-help'
+        option '-ip'
+        option '-ipv4'
+        option '-ipv6'
+        option '-json', value: true
+        option '-log', value: true
+        option '-max-dns-queries', value: {type: Num.new}
+        option '-nf', name: :known_subdomains_file, value: {type: InputFile.new}
+        option '-o', name: :output, value: true
+        option '-oA', name: :output_prefix, value: true
+        option '-r', name: :resolver, value: true, repeats: true
+        option '-rf', name: :resolver_file, value: true
+        option '-t', name: :type, value: true, repeats: true
+        option '-timeout', value: {type: Num.new}
+        option '-v', name: :verbose
+      end
+    end
+  end
+end