8f7e3803eb
Acknowledge that transports MAY be used in isolation (i.e., outside of a Resolver) and add support for wrapping. Ensure that every factory that creates an unwrapped type is named accordingly to hopefully ensure there are no surprises. Implement DNSTransport wrapping and use a technique similar to the one used by Dialer to customize the DNSTransport while constructing more complex data types (e.g., a specific resolver). Ensure that the stdlib resolver's own "getaddrinfo" transport (1) is wrapped and (2) could be extended during construction. This work is part of my ongoing effort to bring to this repository websteps-illustrated changes relative to netxlite. Ref issue: https://github.com/ooni/probe/issues/2096 |
||
---|---|---|
.. | ||
chapter01 | ||
chapter02 | ||
chapter03 | ||
chapter04 | ||
chapter05 | ||
chapter06 | ||
chapter07 | ||
chapter08 | ||
README.md |
Tutorial: using the netxlite networking library
Netxlite is the underlying networking library we use in OONI. In most cases, network experiments do not use netxlite directly, rather they use abstractions built on top of netxlite (e.g., measurex). Though, you need to know about netxlite if you need to modify these abstractions.
For this reason, this chapter shows the basic netxlite primitives that we use when writing higher-level measurement primitives.
We will start from simple primitives and we will combine them together to reach to the point where we can perform GET requests to websites using already existing TLS or QUIC connections. (The code we will end up writing will look like a stripped down version of the measurex library, for which there is a separate tutorial.)
Index:
-
chapter01 shows how to establish TCP connections;
-
chapter02 covers TLS handshakes;
-
chapter03 discusses TLS parroting;
-
chapter04 shows how to establish QUIC sessions;
-
chapter05 is about the "system" DNS resolver;
-
chapter06 discusses custom DNS-over-UDP resolvers;
-
chapter07 shows how to perform an HTTP GET using an already existing TLS connection to a website;
-
chapter08 is like chapter07 but for QUIC.