Home / ship-beta
Name Modified Size InfoDownloads / Week
Parent folder
imgs 2017-08-28
ship.sh 2017-08-28 70.0 kB
TODO.md 2017-08-28 812 Bytes
LICENSE.md 2017-08-28 34.9 kB
README.md 2017-08-28 4.9 kB
CONTRIBUTING.md 2017-08-28 1.0 kB
CHANGELOG.md 2017-08-28 9.3 kB
CODE_OF_CONDUCT.md 2017-08-28 3.2 kB
Totals: 8 Items   124.2 kB 0

a simple, handy network addressing multitool with plenty of features

       


Features

  • Show all network interfaces
  • Show all active network interfaces
  • Show the driver used of each active network interface
  • Show the gateway of each online interface
  • Show the addresses of each active network interface with or without CIDR notation
  • IPv4
  • IPv6 (if possible)
  • MAC
  • Show the public/external IP/s
  • of current user
  • of website/s or domain/s
  • Show active hosts on current network with or without MAC address
  • Show all valid addresses (IPv4, IPv6, MAC) extracted
  • from file or multiple files at once
  • from website or multiple websites at once
  • Show the route to a network host using three most common tools. ship checks which are installed and decides to run the fastest one for each case scenario
  • IPv4
  • IPv6 (if possible)
  • Show the broadcast and network address, cisco wildcard mask, class and host range by giving the IP address and CIDR or netmask
  • IPv4
  • optionally suppress the bitwise output
  • display results as HTML
  • split into networks of size n1, n2, n3 :construction:
  • deaggregate address range :construction:
  • Show list of common ports with description, private and reserved IPv4 and IPv6 addresses with or without CIDR notation
  • Compatible with most of the common linux distributions
  • Drag and drop URLs or file paths on console window
  • Cleaning temp files and handling remaining tasks on exit
  • Exiting on long running tasks needs confirmation

Usage

Read the Guide :mortar_board:


Requirements

ship uses some of the tools included in coreutils and shell builtins

Mandatory

:wrench: Package
awk awk | gawk
grep grep
ip iproute2
ping iputils
sed sed
ss iproute2
wget wget

Mandatory Choice

One or more of the following tools must be installed

:wrench: Package
mtr mtr
tracepath iputils
traceroute traceroute

NOTE

ship utilizes the functionality of ping to check and validate LAN and WAN connections

  • CAP_NET_RAW capability should be permitted
  • Kernel must support non-raw ICMP sockets
  • User must be allowed to create ICMP echo sockets

Compatibility

:penguin: Version
Arch 4.7.5-1 - 4.12.8-1
CentOS 7
Debian 7 - 8
Kali 2016.2
Ubuntu 14.04.3 - 16.04.1

Getting Started

$ git clone --branch=master https://github.com/xtonousou/ship.git
$ cd /path/to/ship
$ bash ship.sh

Arch Linux

$ yaourt -S ship
$ ship

Contribution

Pull requests, issues, suggestions, testing and feedback are all welcome :octocat:

Please read this article first, about code of conduct

  • Fork the repo
  • Create a new branch
  • $ git checkout -b my-new-feature
  • Make the appropriate changes in the files
  • Add changes to reflect the changes made
  • Commit your changes
  • $ git commit -am 'Added some feature'
  • Push to the branch
  • $ git push origin my-new-feature
  • Create a Pull Request on dev

Changelog

Read the Changelog file to review changes :scroll:


Contact

Send me an email at [xtonousou@gmail.com] :e-mail:


License

Copyright (c) 2017 by Sotirios M. Roussis. Some rights reserved

ship is under the terms of the GPLv3+ License, following all clarifications stated in the license file

Source: README.md, updated 2017-08-28