Skip to main content

Combines nmap output and DNS data to produce HTTP[S] URLs of interest.

Project description

nmine

nmine searches files for substrings that appear to be valid DNS names. It resolves them and outputs the result if the address it resolves to is of interest.

A possible name will only be considered a valid DNS name if it ends with a known TLD (see the -t and -T options). If the -s option is also specified, then a possible name must also end with one of the strings specified with that option.

Examples / Description

Let's say you have some arbitrary file (or directories of files) containing DNS names of some sort:

> ls
blah.txt
> cat blah.txt 
nothing 
The quick brown fox yahoo.com jumps over the lazy dog. hurricanelabs.com]
Lorem ipsum dolor sit amet, ex wisi elitr eruditi pro.   129831; asdf
google.com!zzzhomero has ei
;sad0uf23 www.github.com 090

You're interested in any names which resolve to any address in 192.0.0.0/8. You put this in a file called "SCOPE" (or any file specified with the -i option):

>> cat > SCOPE
192.0.0.0/8

You then run nmine while in the above directory, and any names resolving to your network(s) of interest are output:

> nmine
hurricanelabs.com.                       600 IN A 192.230.81.48
www.github.com.                          600 IN A 192.30.253.112

Options

  • -i (filename): Name of a file containing IPv4 networks of interest.

  • -n (address): Name or address of a DNS server to send all queries to.

  • -f hosts|zone: Output format. "zone" is like BIND zone files or dig output. "hosts" is like /etc/hosts.

  • -t (TLD): Specify additional TLDs to consider valid. May be specified multiple times.

  • -T: Do NOT automatically consider IANA TLDs valid. The only TLDs considered valid will be those specified with -t.

  • -s: Only consider names with this ending to be valid names at all. May be specified multiple times.

  • -z (string): Ignore file paths starting with this string. May be specified multiple times.

Copyright and License

Copyright (C) 2026 Steve Benson

nmine is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 3, or (at your option) any later version.

nmine is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; see the file LICENSE. If not, see http://www.gnu.org/licenses/.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

nmine-3.3.0.tar.gz (27.4 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

nmine-3.3.0-py3-none-any.whl (26.8 kB view details)

Uploaded Python 3

File details

Details for the file nmine-3.3.0.tar.gz.

File metadata

  • Download URL: nmine-3.3.0.tar.gz
  • Upload date:
  • Size: 27.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.10.12

File hashes

Hashes for nmine-3.3.0.tar.gz
Algorithm Hash digest
SHA256 dd15b97ecfcde7f156c7ae7727a41cfa1ec7d84b319a7541f6ef41933463bf63
MD5 7edadc78f1257f609fa381f7c54412d6
BLAKE2b-256 6d7547f4422b695302a32d58459061c3868e5adc72fcfdcd370cbd6537921644

See more details on using hashes here.

File details

Details for the file nmine-3.3.0-py3-none-any.whl.

File metadata

  • Download URL: nmine-3.3.0-py3-none-any.whl
  • Upload date:
  • Size: 26.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.10.12

File hashes

Hashes for nmine-3.3.0-py3-none-any.whl
Algorithm Hash digest
SHA256 dcc3e955148880f4ca25e9f3600337e2f41e7638669ff18a84351fe765967b34
MD5 e45c3812aadd4a2d3629249ac06fa605
BLAKE2b-256 5769936a008a7195d474cc19cd93dafc68e4255f3a794f1fd4733f2b3c1b5e39

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page