ooni-probe-cli/internal/engine/netx
Simone Basso 83440cf110
refactor: split errorsx in good and legacy (#477)
The legacy part for now is internal/errorsx. It will stay there until
I figure out whether it also needs some extra bug fixing.

The good part is now in internal/netxlite/errorsx and contains all the
logic for mapping errors. We need to further improve upon this logic
by writing more thorough integration tests for QUIC.

We also need to copy the various dialer, conn, etc adapters that set
errors. We will put them inside netxlite and we will generate errors in
a way that is less crazy with respect to the major operation. (The
idea is to always wrap, given that now we measure in an incremental way
and we don't measure every operation together.)

Part of https://github.com/ooni/probe/issues/1591
2021-09-07 17:09:30 +02:00
..
archival refactor: split errorsx in good and legacy (#477) 2021-09-07 17:09:30 +02:00
dialer refactor: split errorsx in good and legacy (#477) 2021-09-07 17:09:30 +02:00
httptransport fix(netxlite): http3 propagates CloseIdleConnections to its dialer (#471) 2021-09-06 21:52:00 +02:00
quicdialer refactor: split errorsx in good and legacy (#477) 2021-09-07 17:09:30 +02:00
resolver refactor: split errorsx in good and legacy (#477) 2021-09-07 17:09:30 +02:00
tlsdialer refactor: split errorsx in good and legacy (#477) 2021-09-07 17:09:30 +02:00
trace chore: merge probe-engine into probe-cli (#201) 2021-02-02 12:05:47 +01:00
fake_test.go refactor(netxlite): hide details without breaking the rest of the tree (#454) 2021-09-05 14:49:38 +02:00
integration_test.go refactor: split errorsx in good and legacy (#477) 2021-09-07 17:09:30 +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 feat(netxlite): implement single use {,tls} dialer (#464) 2021-09-06 14:12:30 +02:00
netx.go feat(netxlite): add CloseIdleConnections to quic dialer (#469) 2021-09-06 20:56:14 +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.