miniss

0.0.12 versions

0.0.2latestApr 9, 2023
0.0.1not indexedJan 10, 2026

github.com/noraj/miniss

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

39 stars

0 dependents

License: MIT

Nothing has been indexed for 0.0.1 yet. The tag is recorded, its shard.yml has not been read, so the manifest and dependency list below are empty because they are unknown rather than because they are absent.

Installation

# Add this to your shard.yml
dependencies:
  miniss:
    github: noraj/miniss
    version: ~> 0.0.1

Then run:

shards install

shard.yml

No shard.yml has been indexed for 0.0.1. You can read it on the repository.

Dependencies

Unknown: the shard.yml for this version has not been read yet.

README

This README is the one indexed from the repository at its latest ref, not from the tag for this version.

# miniss

![GitHub Workflow Status (with branch)](https://img.shields.io/github/actions/workflow/status/noraj/miniss/test.yml?branch=master&style=flat-square)
![GitHub License](https://img.shields.io/github/license/noraj/miniss?style=flat-square)
![GitHub top language](https://img.shields.io/github/languages/top/noraj/miniss?style=flat-square)
![GitHub commit activity](https://img.shields.io/github/commit-activity/y/noraj/miniss?style=flat-square)

![miniss logo](docs/logo-miniss.png)

**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 environnement where the classical `ss` or `netstat` binaries have been removed.

## Build

![GitHub tag (latest SemVer)](https://img.shields.io/github/v/tag/noraj/miniss?sort=semver&style=flat-square)
![GitHub tag (latest SemVer pre-release)](https://img.shields.io/github/v/tag/noraj/miniss?include_prereleases&sort=semver&style=flat-square)

See [build](docs/build.md) 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:
  - local address, remote address, state, username, uid
- Type of sockets:
  - [x] TCP
  - [x] UDP
- IP version:
  - [x] IPv4
  - [x] IPv6

## Documentation

[![Library documentation](https://img.shields.io/badge/doc-library-black?logo=readthedocs&logoColor=black&style=flat-square)](https://noraj.github.io/miniss/lib-doc/Miniss.html)
[![User documentation - Build](https://img.shields.io/badge/doc-build-black?logo=readthedocs&logoColor=black&style=flat-square)](https://noraj.github.io/miniss/build)
[![User documentation - Changelog](https://img.shields.io/badge/doc-changelog-black?logo=readthedocs&logoColor=black&style=flat-square)](https://noraj.github.io/miniss/CHANGELOG)
[![Developer documentation - Contributing](https://img.shields.io/badge/doc-contributing-black?logo=readthedocs&logoColor=black&style=flat-square)](https://noraj.github.io/miniss/creating)
[![Developer documentation - Development](https://img.shields.io/badge/doc-development-black?logo=readthedocs&logoColor=black&style=flat-square)](https://noraj.github.io/miniss/development)
[![User documentation - TODO](https://img.shields.io/badge/doc-todo-black?logo=readthedocs&logoColor=black&style=flat-square)](https://noraj.github.io/miniss/TODO)

## Author

- [noraj](https://pwn.by/noraj/) - creator and maintainer

miniss

Installation

shard.yml

Dependencies

README

Documentation

Links

This release

Dependents

Repository

Metadata