mirror of
https://github.com/buger/goreplay.git
synced 2024-04-21 12:32:02 +00:00
Urban IshimweandGitHub
fdc8b094f0
### performance - handling of the very big packet(any size that can be buffered) - speeding up TCP sessions by using message hints: Added **proto.HasFullPayload** that helps to validate the entire HTTP request, it supports `Chunked` encoding too! Added **proto.HasRequestTitle** and **proto.HasResponseTitle** for validating the beginning of HTTP request. Those methods are used `input_raw.go` with `TCP`. - supports Keep-Alive: the above functions helps to support keep-alive ### Packaging - **capture:** engines(capture/doc.go) - **tcp:** tcp message parser (tcp/doc.go) ### benchmarking - **capture.BenchmarkPcapDump:** the benchmarks regarding dumping packets in a pcap file - **capture.BenchmarkPcapFile:** the benchmarks of reading packets from a pcap file - **capture.BenchmarkPcap:** the benchmarks of parsing packets from the loopback interface with pcap handles - **proto.BenchmarkHasFullPayload:**: benchmarking this function which validates the HTTP payload - **tcp.BenchmarkPacketParseAndSort:** benchmarks of parsing and sorting packets - **tcp.BenchmarkMessageParserWithoutHint:** benchmarks of message reasembling by using `SYN` and `FIN` flag - **tcp.BenchmarkMessageParserWithHint:** benchmarks of message reasembling by using `proto.HasRequestTitle` and `proto.HasFullPayload` flag ### issues see linked issues ### tests - fixed input raw and engine tests **Most of the changed of the files, was about using functionalities of** `tcp` **and** `capture` **in existing functionalities**
28 lines
1.0 KiB
Go
28 lines
1.0 KiB
Go
/*
|
|
Package tcp implements TCP transport layer protocol, it is responsible for
|
|
parsing, reassembling tcp packets, handling communication with engine listeners(github.com/buger/goreplay/capture),
|
|
and reporting errors and statistics of packets.
|
|
the packets are parsed by following TCP way(https://en.wikipedia.org/wiki/Transmission_Control_Protocol#TCP_segment_structure).
|
|
|
|
|
|
example:
|
|
|
|
import "github.com/buger/goreplay/tcp"
|
|
|
|
messageExpire := time.Second*5
|
|
maxSize := 5 << 20
|
|
|
|
debugger := func(debugLevel int, data ...interface{}){} // debugger can also be nil
|
|
messageHandler := func(mssg *tcp.Message){}
|
|
|
|
mssgPool := tcp.NewMessagePool(maxMessageSize, messageExpire, debugger, messageHandler)
|
|
listener.Listen(ctx, mssgPool.Handler)
|
|
|
|
you can use pool.End or/and pool.Start to set custom session behaviors
|
|
|
|
debugLevel in debugger function indicates the priority of the logs, the bigger the number the lower
|
|
the priority. errors are signified by debug level 4 for errors, 5 for discarded packets, and 6 for received packets.
|
|
|
|
*/
|
|
package tcp // import github.com/buger/goreplay/tcp
|