Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/nat-418/hogs
Find the processes hogging your ports
https://github.com/nat-418/hogs
Last synced: 13 days ago
JSON representation
Find the processes hogging your ports
- Host: GitHub
- URL: https://github.com/nat-418/hogs
- Owner: nat-418
- License: other
- Created: 2024-03-21T12:41:25.000Z (10 months ago)
- Default Branch: main
- Last Pushed: 2024-03-21T14:05:03.000Z (10 months ago)
- Last Synced: 2024-11-05T11:36:45.847Z (about 2 months ago)
- Language: Tcl
- Size: 2.93 KB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# Hogs 🐖🐖🐖
![Semantic Versioning 2.0.0]
![Conventional Commits 1.0.0]
Ever wonder which processes are hogging your ports? `hogs` will tell you.
`hogs` is a wrapper for `ss`, the standard Linux socket statistics tool.
`hogs` provides a simpler command-line interface and more easily digestible
output about what is happening on your system.
## Usage
```bash
$ hogs --tcp --ipv4
Address Port Process PID
0.0.0.0 8080 miniserve 1251227
```
### Options
| Option flag | Description |
| ------------------- | ------------------------------------------------- |
| `-all` | Show all results, see [Permissions](#permissions) |
| `-ipv4` | Show IPv4 addresses |
| `-ipv6` | Show IPv6 addresses |
| `-tcp` | Show TCP network |
| `-udp` | Show UDP network |
| `-ip value` | Lookup a given IP address |
| `-port value` | Lookup a given port number |
| `-version` | Print version number |
### Permissions
Usually, an empty process name or PID means that the user does not have
sufficient permissions to access that information. The most common cause
of this is when a process is spawned by root or init. By default, `hogs`
does not show results with an empty process name or PID.
## Installation
`hogs` is written in Tcl and uses the standard libarary `tcllib`;
the `ss` utility is also required. Simply copy the `hogs.tcl` script
somewhere on your `$PATH` and mark it executable. There is also a
Nix package available in my [Grimoire] repository.
### Dependencies
- Tcl version 8.6 or greater (`tclsh`, `tcllib`)
- `ss` (from `iproute2` version 6.5.0 or greater)
## Miscellaneous
Hogs is open-source software distributed under the 0BSD license.
To report bugs or view source code, see https://www.github.com/nat-418/hogs.
[Grimoire]: https://github.com/nat-418/grimoire
[Conventional Commits 1.0.0]: https://flat.badgen.net/badge/Conventional%20Commits/1.0.0/
[Semantic Versioning 2.0.0]: https://flat.badgen.net/badge/Semantic%20Versioning/2.0.0/