d57c78bc71
This is how I did it: 1. `git clone https://github.com/ooni/probe-engine internal/engine` 2. ``` (cd internal/engine && git describe --tags) v0.23.0 ``` 3. `nvim go.mod` (merging `go.mod` with `internal/engine/go.mod` 4. `rm -rf internal/.git internal/engine/go.{mod,sum}` 5. `git add internal/engine` 6. `find . -type f -name \*.go -exec sed -i 's@/ooni/probe-engine@/ooni/probe-cli/v3/internal/engine@g' {} \;` 7. `go build ./...` (passes) 8. `go test -race ./...` (temporary failure on RiseupVPN) 9. `go mod tidy` 10. this commit message Once this piece of work is done, we can build a new version of `ooniprobe` that is using `internal/engine` directly. We need to do more work to ensure all the other functionality in `probe-engine` (e.g. making mobile packages) are still WAI. Part of https://github.com/ooni/probe/issues/1335
24 lines
1.1 KiB
Markdown
24 lines
1.1 KiB
Markdown
# 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](https://github.com/ooni/netx).
|