Skip to main content

OMSTD HH-001 study case: High performance TCP port scanner nmap friendly.

Project description

What's this project?
====================

This project is a basic port scanner. It belongs to OMSTD Project (https://github.com/cr0hn/OMSTD).

Licence
=======

This project is **BSD**... Copy it! And, if you remember, please mention me in credits :)

How to install
==============

.. code-block:: bash

sudo python3.4 -m pip install OMSTD-hh-001

How use it?
===========

You can use this project as a command line tool or as a library, as part of your Python projects.

As a tool
---------

You can display all options to run as command line running command :samp:`omstd-hh-001 -h`:

.. code-block:: bash

usage: omstd-hh-001 [-h] [-v VERBOSITY] [--open] [-p PORTS_RANGE] [-r]
[--proxy PROXY]
TARGETS [TARGETS ...]

OMSTD Example

positional arguments:
TARGETS targets to scan

optional arguments:
-h, --help show this help message and exit
-v VERBOSITY verbosity level
--open only display open ports
-p PORTS_RANGE port range to scan in format 'X-Y'. Defaul: 1-1024.
-r don't randomize ports
--proxy PROXY proxy in format: http://USER:PASS@IP:PORT

As a library
------------

.. code-block:: python

from omstd_hh_001.api import run_scan, Parameters

if __name__ == "__main__":


input_parameters = Parameters(ports_range="1-2049",
targets=["127.0.0.1", "127.0.0.2"],
verbosity=2,
random_port_scan=True,
only_open=True,
proxy=None)

results = run_scan(config)

# Display open ports
for port, status in results.ports.items():

# Checks if 'only_open' is set -> Only display port with status 'open'
if input_parameters.only_open is True and status == "closed":
continue

print("%s/tcp %s" % (port, status))

# Display scan time
print(results.scan_time)

Project details


Download files

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

Files for OMSTD-hh-001, version 0.1.3
Filename, size File type Python version Upload date Hashes
Filename, size OMSTD-hh-001-0.1.3.tar.gz (5.5 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page