Skip to content
/ miniss Public

Displays a list of open listening sockets. It is a minimal alternative to ss or netstat.

License

Notifications You must be signed in to change notification settings

noraj/miniss

Repository files navigation

miniss

GitHub Workflow Status (with branch) GitHub License GitHub top language GitHub commit activity

miniss logo

miniss (mini ss) displays a list of open listening sockets. It is a minimal alternative to ss or netstat.

The goal of miniss is not to reinvent the wheel but rather to offer a static binary that can be deployed by pentester or CTF players on containers or hardened environment where the classical ss or netstat binaries have been removed.

preview

Build

GitHub tag (latest SemVer) GitHub tag (latest SemVer pre-release)

A pre-compiled static binary is provided only for x86_64-linux-gnu, see releases. Else read the build instructions.

Install

Packaging status

See install instructions.

Usage

miniss v0.0.2

Usage:
  miniss [--tcp | --udp] [--ipv4 | --ipv6] [--debug --no-color]
  miniss -h | --help
  miniss --version

Options:
  -u --udp      Show UDP sockets.
  -t --tcp      Show TCP sockets.
  -4 --ipv4     Show IPv4 sockets.
  -6 --ipv6     Show IPv6 sockets.
  --debug       Display arguments.
  --no-color    Disable colorized output (NO_COLOR environment variable is respected too).
  -h --help     Show this screen.
  --version     Show version.

Examples:
  miniss --udp
  miniss -t6

Project:
  author (https://pwn.by/noraj / https://twitter.com/noraj_rawsec)
  source (https://github.com/noraj/miniss)
  documentation (https://noraj.github.io/miniss)

Features

  • Information displayed:
    • type of socket, local address, remote address, state, username, uid
  • Type of sockets:
    • TCP
    • UDP
  • IP version:
    • IPv4
    • IPv6

Documentation

Documentation homepage: https://noraj.github.io/miniss/

Library documentation User documentation - Build User documentation - Install User documentation - Changelog Developer documentation - Contributing Developer documentation - Development

Author

  • noraj - creator and maintainer