Skip to content

vokomarov/netshark

Repository files navigation

netshark

Build Status Coverage Status GoDoc Go Report Card

Overview

netshark is a simple command line tool to scan your local network to available hosts and his opened ports.

Features:

  • Scan local network neighbor hosts
  • Display client MAC address

Coming soon:

  • Scan opened TCP ports
  • Specify scanning port ranges
  • Use predefined port ranges to scan
  • Multithreaded scan
  • Shadow scan
  • Use STDIN as source of hosts to support Unix pipes

Installation

Installing from Source

go get -u github.com/vokomarov/netshark

Download

Download binary for your system here.

Usage

As a command line tool

# Scan local network for neighbor hosts
$ netshark scan hosts [--timeout 15]

# Scan given host for opened ports of all port range
$ netshark scan ports --host 192.168.1.1 # scan specific

# Specify TCP port range from lower to higher number of ports
$ netshark scan ports --range 1,65535
$ netshark scan ports --range-min 1024 # check registered ports and private ports range
$ netshark scan ports --range-max 1023 # check only well-known port range

# Or use predefined port ranges
$ netshark scan ports --range known   # scan ports from 0 to 1023
$ netshark scan ports --range reg     # scan ports from 1024 to 49151
$ netshark scan ports --range private # scan ports from 49152 to 65535

Programmatically in your code

netshark can be used programmatically. You can visit godoc to check API documentation.

License

netshark is open-sourced software licensed under the MIT license.