testclient

type HelloOptions struct {
	// PadTo is the length of the hello as ONE record, its 5-byte header
	// included: that is the form the proxy's reader rebuilds before it takes
	// the digest, and the length a real client's hello is quoted in (517). The
	// difference from the unpadded hello is made up by a TLS padding extension
	// (type 0x0015, zeros) after the SNI extension, inside the digest's input.
	// 0 means no padding.
	//
	// A hello that does not fit in one record -- PadTo above 16,389, the 5-byte
	// header and 2^14 bytes of payload -- is sent as the same handshake message
	// cut across as many records as it takes, none over 2^14, and the reader
	// puts it back together. The digest is still over the single record, so the
	// bytes on the wire are then PadTo plus 5 for each record after the first.
	//
	// A PadTo of the unpadded length adds no extension. Below it, or in the 1..3
	// bytes above it (an extension header alone is 4), or giving a handshake
	// body above 65,531 bytes (PadTo 65,540), which the reader refuses, is an
	// error.
	PadTo int

	// At is the time the random carries. The zero value is the present, which
	// is what a client sends; a test sets it to send a hello the reader's clock
	// check will refuse.
	At time.Time
}

type Record struct {
	Type    byte
	Version [2]byte
	Payload []byte
	Raw     []byte
}

type WebOptions struct {
	// Origin is the relay's own host name ([web] host), sent as the Origin
	// header of the carrier upgrade.
	Origin string

	// ForwardedFor, when set, is sent as X-Forwarded-For, for a relay that takes
	// the client address from it (client-ip = "x-forwarded-for").
	ForwardedFor string

	// DialTimeout bounds every HTTP step and the upgrade. Default 5s.
	DialTimeout time.Duration

	// ResetOnClose makes closing the carrier send a reset, so a run that opens
	// thousands of sessions leaves no TIME_WAIT behind.
	ResetOnClose bool

	// ReadBufferSize is the carrier's read buffer. Default 256 KiB, for bulk
	// transfers; a run that holds thousands of idle sessions sets it small, so
	// the memory it measures is the relay's and not the client's.
	ReadBufferSize int
}

type WebSession struct {
	// contains filtered or unexported fields
}

type WebStream struct {
	// contains filtered or unexported fields
}