brent/tcp-sprint
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

update readme

Browse source
This commit is contained in:
Brent Schroeter 2026-03-15 23:22:20 -07:00
parent 591e2d37b4
commit 0550cdf707
1 changed files with 8 additions and 6 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

14
README.md
View file

@ -1,16 +1,18 @@
# TCP Sprint
# [Will It Blend](https://youtu.be/l69Vi5IDc0g)
This script demonstrates the risk of interleaving writes when cloning
`TcpStream` handles across threads, re:
[this discussion in the Servo Zulip](https://servo.zulipchat.com/#narrow/channel/263398-general/topic/TcpStream.3A.3Atry_clone.28.29.20thread.20safety.20in.20devtools/with/578172763).
It works by spawning 3 threads: 2 TCP clients, each of which sends predictable
chunks of bytes over a shared connection with `TcpStream::write_all()`, and 1
TCP listener, which tests whether messages arrive contiguously or scrambled
together.
It spawns 3 threads:
- 2 TCP clients, each of which sends predictable chunks of bytes over a shared
connection with `TcpStream::write_all()`
- 1 TCP listener, which tests whether messages arrive contiguously or scrambled
together
Messages consist of the range `0x00..=0xff`, repeated to fill the desired
message size.
message size. The TCP listener prints a warning if it detects any byte received
out of order.
## Usage