https://github.com/dentosal/tcpstate

Abstract TCP socket implementation in Rust
https://github.com/dentosal/tcpstate

Last synced: about 1 year ago
JSON representation

Abstract TCP socket implementation in Rust

• Host: GitHub
• URL: https://github.com/dentosal/tcpstate
• Owner: Dentosal
• License: mit
• Created: 2022-01-03T16:57:51.000Z (over 4 years ago)
• Default Branch: master
• Last Pushed: 2022-01-05T01:04:26.000Z (over 4 years ago)
• Last Synced: 2025-03-21T09:48:01.326Z (over 1 year ago)
• Language: Rust
• Size: 108 KB
• Stars: 1
• Watchers: 1
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# `tcpstate` - abstract TCP socket libarary for Rust

This library provides a TCP state machine and data buffers. It is built to be integrated into a larger TCP/IP stack, and does not offer low-level functionality such as parsing TCP packets. It should be usable for BSD-style sockets.

This libary supports `#[no_std]` as long as a global alloctor is available (`alloc`). It uses flexible callback-based event handling, and avoids allocations whenever possible.

### Not yet implemented

* Proper documentation for...

    * The pluggable `user_data` handler

        * Sequence number clock

    * Anything else

* User timeouts

* Persist timer

* Buffer size limits

* Accept new connections in TimeWait state as per RFC 1122 page 88

* Proper window scaling

* Nagle's Algorithm

* Congestion control and fast retransmit

* Storing out-of-order packets

* `PSH` bit support

* Selective ACKs

### Support not planned

* `URG`ent pointer support

### State transition graph

![state transition graph](docs/images/state.svg)

(`RST` packet handling is omitted from this graph)

## Contributions

Welcome! Remember to run `cargo fmt` before committing and make sure that tests pass with `cargo test --features std`.

## License

MIT