From db17179de96e3c85f36c8d13c13d98cccd88b5af Mon Sep 17 00:00:00 2001 From: Lennart Poettering Date: Thu, 5 Jun 2025 12:22:34 +0200 Subject: [PATCH] man: reword --raw= explanation a bit Explain what we mean by "payload", and for which RR types this is intended. And don#t claim we'd output a full packet, because we don't. We output only the RR in binary. Fixes: #37737 (cherry picked from commit 317054365eb11d98ac9d2439ef537e2ee6a3228c) (cherry picked from commit 968cc61b2fed7686b1569d3b73e0c9ffc131caa0) --- man/resolvectl.xml | 14 +++++++++----- 1 file changed, 9 insertions(+), 5 deletions(-) diff --git a/man/resolvectl.xml b/man/resolvectl.xml index d958c18c2fe..c8e02a142ba 100644 --- a/man/resolvectl.xml +++ b/man/resolvectl.xml @@ -452,11 +452,15 @@ =payload|packet - Dump the answer as binary data. If there is no argument or if the argument is - payload, the payload of the packet is exported. If the argument is - packet, the whole packet is dumped in wire format, prefixed by - length specified as a little-endian 64-bit number. This format allows multiple packets - to be dumped and unambiguously parsed. + Dump the answer records as binary data. If there is no argument or if the argument is + payload, the payload of the resource record data is exported, i.e. not the whole + "RDATA", but just primary contents. If the argument is packet, + the whole resource record is dumped in wire format, prefixed by length specified as a little-endian + 64-bit integer. This format allows multiple record to be dumped and unambiguously parsed. + + Note that payload is only supported for a small subset of resource record + types: SSHFP, TLSA, OPENPGPKEY where this dumps the key material only; and A, AAAA where + this dumps the address data. -- 2.47.3