mirror of https://github.com/m1ngsama/TNT.git synced 2026-02-08 00:54:03 +00:00

TNT's Not Tunnel

Find a file

m1ngsama a5a62f057e fix(security): implement concurrency safety improvements - Enhance room_broadcast() reference counting: * Check client state (connected, show_help, command_output) before rendering * Perform state check while holding client ref_lock * Prevents rendering to disconnected/invalid clients * Ensures safe cleanup when ref count reaches zero - Fix tui_render_screen() message array TOCTOU: * Acquire all data (online count, message count, messages) in single lock * Create snapshot of messages to display * Calculate message range while holding lock * Render from snapshot without holding lock * Prevents inconsistencies from concurrent message additions * Eliminates race between two separate lock acquisitions - Fix handle_key() scroll position TOCTOU: * Get message count atomically when calculating scroll bounds * Calculate max_scroll properly accounting for message height * Apply consistent bounds checking for 'j' (down) and 'G' (bottom) * Prevents out-of-bounds access from concurrent message changes These changes address: - Race condition in broadcast rendering to disconnecting clients - TOCTOU between message count read and message access - Scroll position bounds check race conditions Prevents: - Use-after-free in client cleanup - Array out-of-bounds access - Inconsistent UI rendering - Crashes from concurrent message list modifications Improves thread safety without introducing deadlocks by: - Using snapshot approach to avoid long lock holds - Acquiring data in consistent lock order - Minimizing critical sections		2026-01-22 14:06:15 +08:00
.github/workflows	Add CI/CD and deployment automation	2025-12-02 12:47:15 +08:00
include	Fix critical memory and concurrency bugs	2025-11-30 09:00:00 +08:00
src	fix(security): implement concurrency safety improvements	2026-01-22 14:06:15 +08:00
.gitignore	Add development and testing infrastructure	2025-12-02 10:00:00 +08:00
CHANGELOG.md	Add developer documentation	2025-12-02 15:00:00 +08:00
CICD.md	Add CI/CD and deployment automation	2025-12-02 12:47:15 +08:00
DEPLOYMENT.md	Add CI/CD and deployment automation	2025-12-02 12:47:15 +08:00
HACKING	Add developer documentation	2025-12-02 15:00:00 +08:00
install.sh	Add CI/CD and deployment automation	2025-12-02 12:47:15 +08:00
LICENSE	Initial commit	2025-07-01 09:00:00 +08:00
Makefile	Add development and testing infrastructure	2025-12-02 10:00:00 +08:00
QUICKREF	Add developer documentation	2025-12-02 15:00:00 +08:00
README	Rewrite README in classic Unix style	2025-12-02 12:57:18 +08:00
README.md	Rewrite README in classic Unix style	2025-12-02 12:57:18 +08:00
test_basic.sh	Add development and testing infrastructure	2025-12-02 10:00:00 +08:00
test_stress.sh	Add development and testing infrastructure	2025-12-02 10:00:00 +08:00
tnt.service	Add CI/CD and deployment automation	2025-12-02 12:47:15 +08:00

README.md

TNT

Terminal chat server. Vim-style interface. SSH-based.

Install

curl -sSL https://raw.githubusercontent.com/m1ngsama/TNT/main/install.sh | sh

Or download from releases.

Run

tnt              # port 2222
tnt -p 3333      # custom port
PORT=3333 tnt    # env var

Connect: ssh -p 2222 localhost

Keys

INSERT (default)

ESC → NORMAL
Enter → send
Backspace → delete

NORMAL

i → INSERT
: → COMMAND
j/k → scroll
g/G → top/bottom
? → help

COMMAND

:list → users
:help → commands
ESC → back

Build

make              # normal
make debug        # with symbols
make asan         # sanitizer
make check        # static analysis

Requires: libssh

Deploy

See DEPLOYMENT.md for systemd setup.

Files

messages.log      chat history
host_key          SSH key (auto-gen)
tnt.service       systemd unit

Test

./test_basic.sh         # functional
./test_stress.sh 50     # 50 clients

Docs

README - man page style
HACKING - dev guide
DEPLOYMENT.md - production
CICD.md - automation
QUICKREF - cheat sheet

License

MIT