From 79c98ef64da6efecbb7b787f5041a2f029375bfa Mon Sep 17 00:00:00 2001 From: Simone Basso Date: Fri, 22 Nov 2024 10:42:05 +0100 Subject: [PATCH] df-000-dns.md: document {local,remote}Addr (#6) See https://github.com/rbmk-project/dnscore/pull/9 --- docs/spec/data-format/df-000-dns.md | 12 +++++++++++- 1 file changed, 11 insertions(+), 1 deletion(-) diff --git a/docs/spec/data-format/df-000-dns.md b/docs/spec/data-format/df-000-dns.md index 6045e71..82c72f4 100644 --- a/docs/spec/data-format/df-000-dns.md +++ b/docs/spec/data-format/df-000-dns.md @@ -3,7 +3,7 @@ | | | |--------------|------------------------------------------------| | Author | [@bassosimone](https://github.com/bassosimone) | -| Last-Updated | 2024-11-18 | +| Last-Updated | 2024-11-22 | This document describes the format of DNS measurements emitted by [rbmk](https://github.com/rbmk-project/rbmk) and implemented by @@ -111,8 +111,10 @@ The JSON serialization of the response message contains ```JSON { "msg":"dnsResponse", + "localAddr": "", "rawQuery":"", "rawResponse":"", + "remoteAddr": "", "serverAddr":"", "serverProtocol":"", "t0":"", @@ -125,12 +127,18 @@ Where: - `"msg"` (string) is the message type and is always equal to `"dnsQuery"`; +- `"localAddr"` (string) local address and port +of the socket we're using; + - `"rawQuery"` (string) contains the raw DNS query in base64 encoding; - `"rawResponse"` (string) contains the raw DNS response in base64 encoding; +- `"remoteAddr"` (string) remote address and port +of the socket we're using; + - `"serverAddr"` (string) is the address of the server, whose format depends on the protocol; @@ -168,8 +176,10 @@ Here is an example of a `"dnsResponse"` message: ```JSON { "msg":"dnsResponse", + "localAddr": "130.192.91.211:32769", "rawQuery":"yHUBAAABAAAAAAABA3d3dwdleGFtcGxlA2NvbQAAAQABAAApBNAAAAAAAAA=", "rawResponse":"yHWBgAABAAEAAAABA3d3dwdleGFtcGxlA2NvbQAAAQABwAwAAQABAAANVAAEXbjXDgAAKQIAAAAAAAAA", + "remoteAddr": "8.8.8.8:53", "serverAddr":"8.8.8.8:53", "serverProtocol":"udp", "t0":"2024-11-18T15:31:53.05491+01:00",