ooni-probe-cli/internal/engine/netx
Simone Basso 6895946a34
refactor: introduce factory for stdlib http transport (#413)
With this factory, we want to construct ourselves the TLS dialer
so that we can use a dialer wrapper that always sets timeouts when
reading, addressing https://github.com/ooni/probe/issues/1609.

As a result, we cannot immediately replace the i/e/netx factory
for creating a new HTTP transport, since the functions signatures
are not directly compatible.

Refactoring is part of https://github.com/ooni/probe/issues/1505.
2021-07-01 15:26:08 +02:00
..
archival cleanup: remove ConnID, DialID, TransactionID (#395) 2021-06-23 13:36:45 +02:00
dialer refactor: move httptransport w/ logging to netxlite (#411) 2021-06-26 18:11:47 +02:00
errorx cleanup: remove ConnID, DialID, TransactionID (#395) 2021-06-23 13:36:45 +02:00
httptransport refactor: introduce factory for stdlib http transport (#413) 2021-07-01 15:26:08 +02:00
quicdialer refactor: move quic dns dialing to netxlite (#408) 2021-06-25 18:38:13 +02:00
resolver fix(netx): repair BogonResolver tests (#401) 2021-06-25 11:51:10 +02:00
tlsdialer fix(netxlite): improve TLS auto-configuration (#409) 2021-06-25 20:51:59 +02:00
trace chore: merge probe-engine into probe-cli (#201) 2021-02-02 12:05:47 +01:00
fake_test.go fix(all): introduce and use iox.ReadAllContext (#379) 2021-06-15 11:57:40 +02:00
integration_test.go fix(netx): repair BogonResolver tests (#401) 2021-06-25 11:51:10 +02:00
netx_internal_test.go chore: merge probe-engine into probe-cli (#201) 2021-02-02 12:05:47 +01:00
netx_test.go refactor: move httptransport w/ logging to netxlite (#411) 2021-06-26 18:11:47 +02:00
netx.go refactor: move base http3 transport into netxlite (#412) 2021-06-30 15:19:10 +02:00
README.md chore: merge probe-engine into probe-cli (#201) 2021-02-02 12:05:47 +01:00

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.