History

Simone Basso 5d54aa9c5f cleanup: move caching resolvers from netx to netxlite (#799 ) Now that we have properly refactored the caching resolvers we can move them into netxlite as optional resolvers created using the proper abstract factories we just added. This diff reduces the complexity and the code size of netx. See https://github.com/ooni/probe/issues/2121.		2022-06-05 21:58:34 +02:00
..
httptransport.go	fix(netx): ensure we create ~same HTTP3 and HTTP2 transports (#795 )	2022-06-05 17:41:06 +02:00
netx_test.go	refactor(netx): move construction logic outside package (#798 )	2022-06-05 21:22:27 +02:00
netx.go	cleanup: move caching resolvers from netx to netxlite (#799 )	2022-06-05 21:58:34 +02:00
README.md	chore: merge probe-engine into probe-cli (#201 )	2021-02-02 12:05:47 +01:00

README.md

Package github.com/ooni/probe-engine/netx

OONI extensions to the net and net/http packages. This code is used by ooni/probe-engine as a low level library to collect network, DNS, and HTTP events occurring during OONI measurements.

This library contains replacements for commonly used standard library interfaces that facilitate seamless network measurements. By using such replacements, as opposed to standard library interfaces, we can:

save the timing of HTTP events (e.g. received response headers)
save the timing and result of every Connect, Read, Write, Close operation
save the timing and result of the TLS handshake (including certificates)

By default, this library uses the system resolver. In addition, it is possible to configure alternative DNS transports and remote servers. We support DNS over UDP, DNS over TCP, DNS over TLS (DoT), and DNS over HTTPS (DoH). When using an alternative transport, we are also able to intercept and save DNS messages, as well as any other interaction with the remote server (e.g., the result of the TLS handshake for DoT and DoH).

This package is a fork of github.com/ooni/netx.