From: Lennart Poettering Date: Thu, 5 Jun 2025 10:22:34 +0000 (+0200) Subject: man: reword --raw= explanation a bit X-Git-Tag: v256.17~30 X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=db17179de96e3c85f36c8d13c13d98cccd88b5af;p=thirdparty%2Fsystemd.git 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) --- 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.