| Name | tuxtoaster JSON |
| Version |
1.2.10
JSON |
| download |
| home_page | None |
| Summary | All-in-one Linux stress and benchmarking toolkit |
| upload_time | 2025-10-22 15:47:27 |
| maintainer | None |
| docs_url | None |
| author | None |
| requires_python | >=3.6 |
| license | None |
| keywords |
|
| VCS |
|
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# Tux Toaster
```
████████╗██╗ ██╗██╗ ██╗
╚══██╔══╝██║ ██║╚██╗██╔╝
██║ ██║ ██║ ╚███╔╝
██║ ██║ ██║ ██╔██╗
██║ ╚██████╔╝██╔╝ ██╗
╚═╝ ╚═════╝ ╚═╝ ╚═╝
████████╗ ██████╗ █████╗ ███████╗████████╗███████╗██████╗
╚══██╔══╝██╔═══██╗██╔══██╗██╔════╝╚══██╔══╝██╔════╝██╔══██╗
██║ ██║ ██║███████║███████╗ ██║ █████╗ ██████╔╝
██║ ██║ ██║██╔══██║╚════██║ ██║ ██╔══╝ ██╔══██╗
██║ ╚██████╔╝██║ ██║███████║ ██║ ███████╗██║ ██║
╚═╝ ╚═════╝ ╚═╝ ╚═╝╚══════╝ ╚═╝ ╚══════╝╚═╝ ╚═╝
================================================================
All-in-one Linux Stress Testing Toolkit
================================================================
```
## ⚠️ WARNING - RUN AT YOUR OWN RISK!⚠️
Tux Toaster is a workload generator that may harm your Linux system. Run it at your own risk. The developer is not responsible for any damage or data loss that may occur from using this software.
---
## 1. What is Tux Toaster?
Tux Toaster is an all-in-one performance toolkit designed for Linux systems. It triggers various load tests, referred to as "toasters," to help you evaluate the performance and stability of your system.
Project page: [GitHub repository](https://github.com/samatild/tuxtoaster)
---
## 2. Requirements
Tux Toaster targets Linux and relies on a few system tools in addition to Python:
- Python 3.6+ (backported legacy support for 3.6)
- System utilities: `dd` (coreutils), `lsblk` and `taskset` (util-linux), `pkill` (procps)
- Internet connectivity (network tests use public endpoints)
Optional/privileged:
- Root privileges for the "Unclean GC" runaway memory test to adjust `oom_score_adj`
---
## 3. How to Install and Run
Install from PyPI (recommended):
```bash
pip install tuxtoaster
tuxtoaster
```
### Alternative: Install from source (editable)
```bash
git clone https://github.com/samatild/tuxtoaster.git
cd tuxtoaster
pip install -U pip setuptools wheel # Optional but recommended
pip install -e .
tuxtoaster
```
### Add install location to PATH
If your shell can't find `tuxtoaster`, add the install directory to PATH:
- System installs (scripts in /usr/local/bin):
```bash
export PATH=/usr/local/bin:$PATH
```
- User installs (scripts in ~/.local/bin):
```bash
export PATH="$HOME/.local/bin:$PATH"
```
To make it persistent (bash):
```bash
echo 'export PATH=/usr/local/bin:$PATH' >> ~/.bashrc
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
```
Menu controls (console app):
- Use arrow keys to navigate, Enter to select.
- Many submenus support multi-select; hints are shown in the UI.
- Press `q`, `x`, or `Esc` in a menu to go back.
- During tests, press Enter to stop.
### Menu example
```text
Main Menu
> CPU
Memory
Disk
Network
Multiple
About
Exit
Main Menu > Disk IO
> IOPS Reads
IOPS Writes
Random IOPS R/W
IOPS 50-50 R/W
Throughput Reads
Throughput Writes
Random Throughput R/W
Throughput 50-50 R/W
Read while write cache is getting flushed
Write on Buffer Cache
Back to Main
```
---
## 4. Available Tests
Tux Toaster offers a variety of tests to stress different system components:
- **CPU**:
- Single Core
- All Cores
- Custom Number of Cores (uses `taskset`; experimental)
- **Memory**:
- Single Runaway Thread
- Multiple Runaway Threads
- Memory spikes
- Unclean GC (requires root to set `oom_score_adj`)
- **Disk**:
- IOPS Reads (4K, direct I/O)
- IOPS Writes (4K, direct I/O)
- Random IOPS R/W (4K, random, direct I/O)
- IOPS 50-50 R/W (4K, direct I/O)
- Throughput Reads (4MB, direct I/O)
- Throughput Writes (4MB, direct I/O)
- Random Throughput R/W (4MB, random, direct I/O)
- Throughput 50-50 R/W (4MB, direct I/O)
- Read while write cache is getting flushed (page cache warm-up then read)
- **Network**:
- Network IN (Single) — downloads `https://proof.ovh.net/files/100Mb.dat`
- Network OUT (Single) — UDP to `8.8.8.8:53`
- Network IN (Multiple) — N parallel downloads of the OVH file
- Network OUT (Multiple) — N parallel UDP senders to `8.8.8.8:53`
- Socket Exhaustion — exhaust process/kernel socket resources or reserve port ranges
- Simulate Latencies — local TCP proxy that adds base latency and jitter
- **Multiple tests at once**: Run CPU/Memory/Network/Disk concurrently via a multi-select menu
---
## 5. Detailed Notes per Category
- **CPU**
- Single/All Cores spin tight loops to saturate CPU; stop with Enter.
- Custom Number of Cores pins workloads using `taskset`. This path invokes an internal stress script; consider it experimental.
- **Memory**
- Single Runaway Thread: allocates 1 GiB chunks repeatedly via anonymous `mmap`; press Enter to stop.
- Multiple Runaway Threads: user-selectable threads and per-allocation size (MB), stops on low memory; requires `psutil`.
- Memory spikes: bursts up to ~80–99% of RAM for 1s, pauses 1–10s, repeats.
- Unclean GC (runaway): attempts to set `oom_score_adj = -1000` (root required) then allocates indefinitely. High risk of system instability.
- **Disk**
- You select one or more mounted filesystems. For each, the tool creates `io_test_temp/` and a temporary file, runs `dd` loops, and cleans up on stop.
- IOPS tests use 4K blocks; Throughput tests use 4MB blocks; many use `oflag=direct`/`iflag=direct` to bypass the page cache by design.
- "Read while write cache is getting flushed" pre-creates a file to demonstrate delayed allocation/cache flush effects before sustained reads.
- Some filesystems may not support direct I/O on regular files; in that case, `dd` may print errors.
- **Network**
- IN tests stream a public test object; OUT tests send UDP to a public DNS server. Use responsibly; organizational firewalls may block this traffic.
- Multi-socket modes prompt for the number of parallel sockets; bandwidth is reported per socket when stopped.
### Multiple tests at once
What it does:
- Lets you select one or more resource stressors (CPU, Memory, Network, Disk) and runs each in its own process concurrently.
How to use:
- From the main menu: Multiple → select items with SPACE → Enter to start.
- Press Enter at any time to stop all tests.
Behaviors:
- CPU: spawns one busy process per CPU core (like All Cores).
- Memory: spawns threads that allocate 500 MB chunks repeatedly until low memory (requires psutil).
- Network: continuously downloads `https://proof.ovh.net/files/100Mb.dat`.
- Disk: alternates `dd` read/write (4MB blocks, direct I/O) against a temporary file under `/tmp/tuxtoaster_multi_io`.
### Network: Socket Exhaustion
What it does:
- Opens and holds many sockets until you press Enter, to expose practical limits like per-process file descriptors and ephemeral port exhaustion. Two modes:
- Connections (default): Starts a local TCP server on 127.0.0.1 and opens as many TCP client connections to it as possible, then keeps them open.
- Bind listener ports: Binds listening sockets over a port range (on 0.0.0.0) to reserve those ports and block other listeners on the same host.
How to use:
- From the menu: Network → Socket Exhaustion.
- Optionally answer “y” to increase this process open-file limit to the hard limit.
- Choose Mode 1 (connections) or Mode 2 (bind listener ports).
- Press Enter at any time to release all sockets and return to the menu.
Mode details:
- Mode 1 (connections):
- The tool prints progress every 100 sockets with an approximate open rate.
- Stops opening when it hits an OS error (e.g., EMFILE or EADDRNOTAVAIL); sockets remain open until you press Enter.
- Useful to observe ephemeral port exhaustion (Cannot assign requested address) and per-process descriptor limits.
- Mode 2 (bind listener ports):
- Prompts for a port range (e.g., 1024–65535) and binds on 0.0.0.0 to prevent other processes (e.g., `ncat -l`) from listening on those ports.
- May require root to bind ports <1024.
Tuning tips (advanced):
- Increase ephemeral port range (temporary):
```bash
sudo sysctl -w net.ipv4.ip_local_port_range="1024 65535"
```
- Add extra loopback IPs to expand source address space (Mode 1):
```bash
sudo ip addr add 127.0.0.2/8 dev lo
sudo ip addr add 127.0.0.3/8 dev lo
```
- Consider IPv6 `::1` to use a separate ephemeral space.
- Raise per-process open file limit (interactive prompt will try to set soft=hard):
```bash
ulimit -n 1048576
```
- For system-wide exhaustion tests, run multiple instances or combine with other processes.
### Network: Simulate Latencies
What it does:
- Runs a local TCP proxy on 127.0.0.1 that relays to a target host:port and injects artificial delay on each chunk with configurable base latency and jitter. Use this to see how added RTT affects interactive protocols and bulk transfers.
How to use:
- From the menu: Network → Simulate Latencies.
- Enter values when prompted:
- Target host (e.g., `www.google.com`)
- Target port (e.g., `80`)
- Local listen port (`0` for auto; the app will print the actual port)
- Base latency in ms (e.g., `200`)
- Jitter (+/- ms) (e.g., `50`)
- Point clients to `127.0.0.1:<listen_port>` and preserve the original Host header when needed.
- Press Enter in the app to stop and clean up.
Example towards Google (HTTP):
Start Simulate Latencies with:
- Target host: `www.google.com`
- Target port: `80`
- Local listen port: `46843` (or `0` and note the printed port)
- Base latency: `200`
- Jitter: `50`
Single request via curl (preserving Host):
```bash
curl -H "Host: www.google.com" -s -o /dev/null -w 'connect=%{time_connect}s starttransfer=%{time_starttransfer}s total=%{time_total}s\n' http://127.0.0.1:46843/
```
Sample output:
```text
connect=0.000136s starttransfer=2.147816s total=6.028596s
```
Multiple runs (simple average by eye):
```bash
for i in {1..10}; do
curl -H "Host: www.google.com" -s -o /dev/null -w '%{time_total}\n' http://127.0.0.1:46843/
done
```
Other useful client tests:
- wget
```bash
wget -S -O /dev/null --header='Host: www.google.com' http://127.0.0.1:46843/
```
- HTTP load (hey)
```bash
hey -n 200 -c 20 -H 'Host: www.google.com' http://127.0.0.1:46843/
```
- iperf3 (through the proxy to a remote server)
1) On a remote box: `iperf3 -s`
2) Run latency sim to `remote:5201`, local listen port `5202`
3) Client:
```bash
iperf3 -c 127.0.0.1 -p 5202 -t 20
```
- SSH (replace with your host)
1) Run latency sim to `your.ssh.host:22`, local listen port `10022`
2) Client:
```bash
ssh -p 10022 user@127.0.0.1
```
- Postgres (replace with your DB)
1) Run latency sim to `db-host:5432`, local listen port `5433`
2) Client:
```bash
psql -h 127.0.0.1 -p 5433 -U myuser mydb
```
---
## 6. Safety, Cleanup, and Permissions
- This tool intentionally creates heavy load; run in controlled environments.
- Disk tests write temporary files under the selected mount points and delete them on exit.
- Press Enter to stop any running test. If a test becomes unresponsive, you may need to terminate the Python process.
- The Unclean GC test needs root; otherwise it will warn and abort.
---
## 7. Known Limitations
- Several menu items are marked "Under development" and are placeholders.
- The CPU "Custom Number of Cores" mode is experimental and relies on `taskset`; it may require additional internal scripts.
- Direct I/O flags may not be honored on some filesystems or containerized environments.
- Network endpoints (`proof.ovh.net`, `8.8.8.8:53`) may be blocked by your network policy.
---
## 8. Credits
This project menu makes use of the magnific [Simple Term Menu](https://github.com/IngoMeyer441/simple-term-menu) package.
## 9. License
See `LICENSE` for project licensing details.
Raw data
{
"_id": null,
"home_page": null,
"name": "tuxtoaster",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.6",
"maintainer_email": null,
"keywords": null,
"author": null,
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/31/f2/3c6348a6bbe39a76f4bae022190ac22f5724090ed29e3d3938de5d587e9d/tuxtoaster-1.2.10.tar.gz",
"platform": null,
"description": "# Tux Toaster\n```\n\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2557 \u2588\u2588\u2557\u2588\u2588\u2557 \u2588\u2588\u2557 \n\u255a\u2550\u2550\u2588\u2588\u2554\u2550\u2550\u255d\u2588\u2588\u2551 \u2588\u2588\u2551\u255a\u2588\u2588\u2557\u2588\u2588\u2554\u255d \n \u2588\u2588\u2551 \u2588\u2588\u2551 \u2588\u2588\u2551 \u255a\u2588\u2588\u2588\u2554\u255d \n \u2588\u2588\u2551 \u2588\u2588\u2551 \u2588\u2588\u2551 \u2588\u2588\u2554\u2588\u2588\u2557 \n \u2588\u2588\u2551 \u255a\u2588\u2588\u2588\u2588\u2588\u2588\u2554\u255d\u2588\u2588\u2554\u255d \u2588\u2588\u2557 \n \u255a\u2550\u255d \u255a\u2550\u2550\u2550\u2550\u2550\u255d \u255a\u2550\u255d \u255a\u2550\u255d \n \u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2588\u2588\u2588\u2588\u2557 \n \u255a\u2550\u2550\u2588\u2588\u2554\u2550\u2550\u255d\u2588\u2588\u2554\u2550\u2550\u2550\u2588\u2588\u2557\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557\u2588\u2588\u2554\u2550\u2550\u2550\u2550\u255d\u255a\u2550\u2550\u2588\u2588\u2554\u2550\u2550\u255d\u2588\u2588\u2554\u2550\u2550\u2550\u2550\u255d\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557\n \u2588\u2588\u2551 \u2588\u2588\u2551 \u2588\u2588\u2551\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2551\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2551 \u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2588\u2588\u2588\u2588\u2554\u255d\n \u2588\u2588\u2551 \u2588\u2588\u2551 \u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2551\u255a\u2550\u2550\u2550\u2550\u2588\u2588\u2551 \u2588\u2588\u2551 \u2588\u2588\u2554\u2550\u2550\u255d \u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557\n \u2588\u2588\u2551 \u255a\u2588\u2588\u2588\u2588\u2588\u2588\u2554\u255d\u2588\u2588\u2551 \u2588\u2588\u2551\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2551 \u2588\u2588\u2551 \u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2551 \u2588\u2588\u2551\n \u255a\u2550\u255d \u255a\u2550\u2550\u2550\u2550\u2550\u255d \u255a\u2550\u255d \u255a\u2550\u255d\u255a\u2550\u2550\u2550\u2550\u2550\u2550\u255d \u255a\u2550\u255d \u255a\u2550\u2550\u2550\u2550\u2550\u2550\u255d\u255a\u2550\u255d \u255a\u2550\u255d\n\n================================================================\n All-in-one Linux Stress Testing Toolkit\n================================================================\n```\n\n\n## \u26a0\ufe0f WARNING - RUN AT YOUR OWN RISK!\u26a0\ufe0f\nTux Toaster is a workload generator that may harm your Linux system. Run it at your own risk. The developer is not responsible for any damage or data loss that may occur from using this software.\n\n---\n\n## 1. What is Tux Toaster?\n\nTux Toaster is an all-in-one performance toolkit designed for Linux systems. It triggers various load tests, referred to as \"toasters,\" to help you evaluate the performance and stability of your system.\n\nProject page: [GitHub repository](https://github.com/samatild/tuxtoaster)\n\n---\n\n## 2. Requirements\n\nTux Toaster targets Linux and relies on a few system tools in addition to Python:\n\n- Python 3.6+ (backported legacy support for 3.6)\n- System utilities: `dd` (coreutils), `lsblk` and `taskset` (util-linux), `pkill` (procps)\n- Internet connectivity (network tests use public endpoints)\n\nOptional/privileged:\n- Root privileges for the \"Unclean GC\" runaway memory test to adjust `oom_score_adj`\n\n---\n\n## 3. How to Install and Run\n\nInstall from PyPI (recommended):\n\n```bash\npip install tuxtoaster\ntuxtoaster\n```\n\n### Alternative: Install from source (editable)\n\n```bash\ngit clone https://github.com/samatild/tuxtoaster.git\ncd tuxtoaster\npip install -U pip setuptools wheel # Optional but recommended\npip install -e .\ntuxtoaster\n```\n\n### Add install location to PATH\n\nIf your shell can't find `tuxtoaster`, add the install directory to PATH:\n\n- System installs (scripts in /usr/local/bin):\n```bash\nexport PATH=/usr/local/bin:$PATH\n```\n\n- User installs (scripts in ~/.local/bin):\n```bash\nexport PATH=\"$HOME/.local/bin:$PATH\"\n```\n\nTo make it persistent (bash):\n```bash\necho 'export PATH=/usr/local/bin:$PATH' >> ~/.bashrc\necho 'export PATH=\"$HOME/.local/bin:$PATH\"' >> ~/.bashrc\n```\n\nMenu controls (console app):\n- Use arrow keys to navigate, Enter to select.\n- Many submenus support multi-select; hints are shown in the UI.\n- Press `q`, `x`, or `Esc` in a menu to go back.\n- During tests, press Enter to stop.\n\n### Menu example\n\n```text\nMain Menu\n> CPU\n Memory\n Disk\n Network\n Multiple\n About\n Exit\n\nMain Menu > Disk IO\n> IOPS Reads\n IOPS Writes\n Random IOPS R/W\n IOPS 50-50 R/W\n Throughput Reads\n Throughput Writes\n Random Throughput R/W\n Throughput 50-50 R/W\n Read while write cache is getting flushed\n Write on Buffer Cache\n Back to Main\n```\n\n---\n\n## 4. Available Tests\n\nTux Toaster offers a variety of tests to stress different system components:\n\n- **CPU**:\n - Single Core\n - All Cores\n - Custom Number of Cores (uses `taskset`; experimental)\n- **Memory**: \n - Single Runaway Thread\n - Multiple Runaway Threads\n - Memory spikes\n - Unclean GC (requires root to set `oom_score_adj`)\n- **Disk**:\n - IOPS Reads (4K, direct I/O)\n - IOPS Writes (4K, direct I/O)\n - Random IOPS R/W (4K, random, direct I/O)\n - IOPS 50-50 R/W (4K, direct I/O)\n - Throughput Reads (4MB, direct I/O)\n - Throughput Writes (4MB, direct I/O)\n - Random Throughput R/W (4MB, random, direct I/O)\n - Throughput 50-50 R/W (4MB, direct I/O)\n - Read while write cache is getting flushed (page cache warm-up then read)\n- **Network**: \n - Network IN (Single) \u2014 downloads `https://proof.ovh.net/files/100Mb.dat`\n - Network OUT (Single) \u2014 UDP to `8.8.8.8:53`\n - Network IN (Multiple) \u2014 N parallel downloads of the OVH file\n - Network OUT (Multiple) \u2014 N parallel UDP senders to `8.8.8.8:53`\n - Socket Exhaustion \u2014 exhaust process/kernel socket resources or reserve port ranges\n - Simulate Latencies \u2014 local TCP proxy that adds base latency and jitter\n- **Multiple tests at once**: Run CPU/Memory/Network/Disk concurrently via a multi-select menu\n\n---\n\n## 5. Detailed Notes per Category\n\n- **CPU**\n - Single/All Cores spin tight loops to saturate CPU; stop with Enter.\n - Custom Number of Cores pins workloads using `taskset`. This path invokes an internal stress script; consider it experimental.\n\n- **Memory**\n - Single Runaway Thread: allocates 1 GiB chunks repeatedly via anonymous `mmap`; press Enter to stop.\n - Multiple Runaway Threads: user-selectable threads and per-allocation size (MB), stops on low memory; requires `psutil`.\n - Memory spikes: bursts up to ~80\u201399% of RAM for 1s, pauses 1\u201310s, repeats.\n - Unclean GC (runaway): attempts to set `oom_score_adj = -1000` (root required) then allocates indefinitely. High risk of system instability.\n\n- **Disk**\n - You select one or more mounted filesystems. For each, the tool creates `io_test_temp/` and a temporary file, runs `dd` loops, and cleans up on stop.\n - IOPS tests use 4K blocks; Throughput tests use 4MB blocks; many use `oflag=direct`/`iflag=direct` to bypass the page cache by design.\n - \"Read while write cache is getting flushed\" pre-creates a file to demonstrate delayed allocation/cache flush effects before sustained reads.\n - Some filesystems may not support direct I/O on regular files; in that case, `dd` may print errors.\n\n- **Network**\n - IN tests stream a public test object; OUT tests send UDP to a public DNS server. Use responsibly; organizational firewalls may block this traffic.\n - Multi-socket modes prompt for the number of parallel sockets; bandwidth is reported per socket when stopped.\n\n### Multiple tests at once\n\nWhat it does:\n- Lets you select one or more resource stressors (CPU, Memory, Network, Disk) and runs each in its own process concurrently.\n\nHow to use:\n- From the main menu: Multiple \u2192 select items with SPACE \u2192 Enter to start.\n- Press Enter at any time to stop all tests.\n\nBehaviors:\n- CPU: spawns one busy process per CPU core (like All Cores).\n- Memory: spawns threads that allocate 500 MB chunks repeatedly until low memory (requires psutil).\n- Network: continuously downloads `https://proof.ovh.net/files/100Mb.dat`.\n- Disk: alternates `dd` read/write (4MB blocks, direct I/O) against a temporary file under `/tmp/tuxtoaster_multi_io`.\n\n### Network: Socket Exhaustion\n\nWhat it does:\n- Opens and holds many sockets until you press Enter, to expose practical limits like per-process file descriptors and ephemeral port exhaustion. Two modes:\n - Connections (default): Starts a local TCP server on 127.0.0.1 and opens as many TCP client connections to it as possible, then keeps them open.\n - Bind listener ports: Binds listening sockets over a port range (on 0.0.0.0) to reserve those ports and block other listeners on the same host.\n\nHow to use:\n- From the menu: Network \u2192 Socket Exhaustion.\n- Optionally answer \u201cy\u201d to increase this process open-file limit to the hard limit.\n- Choose Mode 1 (connections) or Mode 2 (bind listener ports).\n- Press Enter at any time to release all sockets and return to the menu.\n\nMode details:\n- Mode 1 (connections):\n - The tool prints progress every 100 sockets with an approximate open rate.\n - Stops opening when it hits an OS error (e.g., EMFILE or EADDRNOTAVAIL); sockets remain open until you press Enter.\n - Useful to observe ephemeral port exhaustion (Cannot assign requested address) and per-process descriptor limits.\n- Mode 2 (bind listener ports):\n - Prompts for a port range (e.g., 1024\u201365535) and binds on 0.0.0.0 to prevent other processes (e.g., `ncat -l`) from listening on those ports.\n - May require root to bind ports <1024.\n\nTuning tips (advanced):\n- Increase ephemeral port range (temporary):\n```bash\nsudo sysctl -w net.ipv4.ip_local_port_range=\"1024 65535\"\n```\n- Add extra loopback IPs to expand source address space (Mode 1):\n```bash\nsudo ip addr add 127.0.0.2/8 dev lo\nsudo ip addr add 127.0.0.3/8 dev lo\n```\n- Consider IPv6 `::1` to use a separate ephemeral space.\n- Raise per-process open file limit (interactive prompt will try to set soft=hard):\n```bash\nulimit -n 1048576\n```\n- For system-wide exhaustion tests, run multiple instances or combine with other processes.\n\n### Network: Simulate Latencies\n\nWhat it does:\n- Runs a local TCP proxy on 127.0.0.1 that relays to a target host:port and injects artificial delay on each chunk with configurable base latency and jitter. Use this to see how added RTT affects interactive protocols and bulk transfers.\n\nHow to use:\n- From the menu: Network \u2192 Simulate Latencies.\n- Enter values when prompted:\n - Target host (e.g., `www.google.com`)\n - Target port (e.g., `80`)\n - Local listen port (`0` for auto; the app will print the actual port)\n - Base latency in ms (e.g., `200`)\n - Jitter (+/- ms) (e.g., `50`)\n- Point clients to `127.0.0.1:<listen_port>` and preserve the original Host header when needed.\n- Press Enter in the app to stop and clean up.\n\nExample towards Google (HTTP):\n\nStart Simulate Latencies with:\n- Target host: `www.google.com`\n- Target port: `80`\n- Local listen port: `46843` (or `0` and note the printed port)\n- Base latency: `200`\n- Jitter: `50`\n\nSingle request via curl (preserving Host):\n```bash\ncurl -H \"Host: www.google.com\" -s -o /dev/null -w 'connect=%{time_connect}s starttransfer=%{time_starttransfer}s total=%{time_total}s\\n' http://127.0.0.1:46843/\n```\n\nSample output:\n```text\nconnect=0.000136s starttransfer=2.147816s total=6.028596s\n```\n\nMultiple runs (simple average by eye):\n```bash\nfor i in {1..10}; do\n curl -H \"Host: www.google.com\" -s -o /dev/null -w '%{time_total}\\n' http://127.0.0.1:46843/\ndone\n```\n\nOther useful client tests:\n- wget\n```bash\nwget -S -O /dev/null --header='Host: www.google.com' http://127.0.0.1:46843/\n```\n\n- HTTP load (hey)\n```bash\nhey -n 200 -c 20 -H 'Host: www.google.com' http://127.0.0.1:46843/\n```\n\n- iperf3 (through the proxy to a remote server)\n1) On a remote box: `iperf3 -s`\n2) Run latency sim to `remote:5201`, local listen port `5202`\n3) Client:\n```bash\niperf3 -c 127.0.0.1 -p 5202 -t 20\n```\n\n- SSH (replace with your host)\n1) Run latency sim to `your.ssh.host:22`, local listen port `10022`\n2) Client:\n```bash\nssh -p 10022 user@127.0.0.1\n```\n\n- Postgres (replace with your DB)\n1) Run latency sim to `db-host:5432`, local listen port `5433`\n2) Client:\n```bash\npsql -h 127.0.0.1 -p 5433 -U myuser mydb\n```\n\n---\n\n## 6. Safety, Cleanup, and Permissions\n\n- This tool intentionally creates heavy load; run in controlled environments.\n- Disk tests write temporary files under the selected mount points and delete them on exit.\n- Press Enter to stop any running test. If a test becomes unresponsive, you may need to terminate the Python process.\n- The Unclean GC test needs root; otherwise it will warn and abort.\n\n---\n\n## 7. Known Limitations\n\n- Several menu items are marked \"Under development\" and are placeholders.\n- The CPU \"Custom Number of Cores\" mode is experimental and relies on `taskset`; it may require additional internal scripts.\n- Direct I/O flags may not be honored on some filesystems or containerized environments.\n- Network endpoints (`proof.ovh.net`, `8.8.8.8:53`) may be blocked by your network policy.\n\n---\n\n## 8. Credits\n\nThis project menu makes use of the magnific [Simple Term Menu](https://github.com/IngoMeyer441/simple-term-menu) package.\n\n\n## 9. License\nSee `LICENSE` for project licensing details.\n\n\n",
"bugtrack_url": null,
"license": null,
"summary": "All-in-one Linux stress and benchmarking toolkit",
"version": "1.2.10",
"project_urls": null,
"split_keywords": [],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "3f064dc0f1e23fae464d108409ca6468b0d9db08ae1f7ce65b469b320f4b8659",
"md5": "abc23e334fbcf7f45cc463a69eb9d1ec",
"sha256": "d4dc444a05b5640c4a82f72d4cfcb184c2832baed0ef7dc491b8b7e5b140f793"
},
"downloads": -1,
"filename": "tuxtoaster-1.2.10-py3-none-any.whl",
"has_sig": false,
"md5_digest": "abc23e334fbcf7f45cc463a69eb9d1ec",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.6",
"size": 43746,
"upload_time": "2025-10-22T15:47:26",
"upload_time_iso_8601": "2025-10-22T15:47:26.847548Z",
"url": "https://files.pythonhosted.org/packages/3f/06/4dc0f1e23fae464d108409ca6468b0d9db08ae1f7ce65b469b320f4b8659/tuxtoaster-1.2.10-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "31f23c6348a6bbe39a76f4bae022190ac22f5724090ed29e3d3938de5d587e9d",
"md5": "7a89c5561d9fcaa189dcb8f90b13671d",
"sha256": "6c969272d63104b8c4ca4f4770d3bf6b0d456003e4748000fac4ddf736b79fcf"
},
"downloads": -1,
"filename": "tuxtoaster-1.2.10.tar.gz",
"has_sig": false,
"md5_digest": "7a89c5561d9fcaa189dcb8f90b13671d",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.6",
"size": 27429,
"upload_time": "2025-10-22T15:47:27",
"upload_time_iso_8601": "2025-10-22T15:47:27.701658Z",
"url": "https://files.pythonhosted.org/packages/31/f2/3c6348a6bbe39a76f4bae022190ac22f5724090ed29e3d3938de5d587e9d/tuxtoaster-1.2.10.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-10-22 15:47:27",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "tuxtoaster"
}
