ooni-probe-cli/internal/engine/netx
Simone Basso 58adb68b2c
refactor: move tracex outside of engine/netx (#782)
* refactor: move tracex outside of engine/netx

Consistently with https://github.com/ooni/probe/issues/2121 and
https://github.com/ooni/probe/issues/2115, we can now move tracex
outside of engine/netx. The main reason why this makes sense now
is that the package is now changed significantly from the one
that we imported from ooni/probe-engine.

We have improved its implementation, which had not been touched
significantly for quite some time, and converted it to unit
testing. I will document tomorrow some extra work I'd like to
do with this package but likely could not do $soon.

* go fmt

* regen tutorials
2022-06-02 00:50:55 +02:00
..
dialer refactor: move tracex outside of engine/netx (#782) 2022-06-02 00:50:55 +02:00
httptransport refactor(netx): merge archival, trace, and the savers (#772) 2022-05-31 21:53:01 +02:00
resolver feat(netxlite): implement DNSTransport wrapping (#776) 2022-06-01 11:10:08 +02:00
tlsdialer refactor(netx): merge archival, trace, and the savers (#772) 2022-05-31 21:53:01 +02:00
fake_test.go cleanup: remove unnecessary legacy interfaces (#656) 2022-01-07 18:33:37 +01:00
integration_test.go refactor: move tracex outside of engine/netx (#782) 2022-06-02 00:50:55 +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 tracex outside of engine/netx (#782) 2022-06-02 00:50:55 +02:00
netx.go refactor: move tracex outside of engine/netx (#782) 2022-06-02 00:50:55 +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.