c/ooni-probe-cli
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
153bfe1c57
ooni-probe-cli/internal/engine/netx
History
Simone Basso 66fd1569b8
tracex: prepare HTTP code for future refactoring (#778) 
The main issue I see inside tracex at the moment is that we
construct the HTTP measurement from separate events.

This is fragile because we cannot be sure that these events
belong to the same round trip. (Currently, they _are_ part
of the same round trip, but this is a fragile assumption and
it would be much more robust to dispose of it.)

To prepare for emitting a single event, it's imperative to
have two distinct fields for HTTP request and response headers,
which is the main contribution in this commit.

Then, we have a bunch of smaller changes including:

1. correctly naming 'response' the DNS response (instead of 'reply')

2. ensure we always use pointer receivers

Reference issue: https://github.com/ooni/probe/issues/2121
2022-06-01 15:20:28 +02:00
..
dialer refactor(netxlite): better integration with tracex (#774) 2022-06-01 08:31:20 +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
tracex tracex: prepare HTTP code for future refactoring (#778) 2022-06-01 15:20:28 +02:00
fake_test.go cleanup: remove unnecessary legacy interfaces (#656) 2022-01-07 18:33:37 +01:00
integration_test.go refactor(netx): merge archival, trace, and the savers (#772) 2022-05-31 21:53:01 +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 tracex: prepare HTTP code for future refactoring (#778) 2022-06-01 15:20:28 +02:00
netx.go tracex: prepare HTTP code for future refactoring (#778) 2022-06-01 15:20:28 +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.