From: dongshengyuan <545258830@qq.com>
Date: Wed, 22 Jul 2026 09:23:16 +0000 (+0800)
Subject: hostnamectl: document JSON status object output
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=eb4abd2d14bde7d06bedf34bc6303191735435b1;p=thirdparty%2Fsystemd.git

hostnamectl: document JSON status object output

status with --static, --pretty, or --transient prints only the
selected hostname in regular output. JSON status output is built from
hostnamed's Describe data and remains a full status object.

Document this distinction so callers do not expect the name type
switches to turn JSON status into a single scalar value.

Follow-up for: ac8a4f6b78fe70680d3bc1704b1f85bbcbe7bb55
---

diff --git a/man/hostnamectl.xml b/man/hostnamectl.xml
index 4c1d3cf245e..7625d3908d6 100644
--- a/man/hostnamectl.xml
+++ b/man/hostnamectl.xml
@@ -219,6 +219,9 @@
         <listitem><para>If <command>status</command> is invoked (or no explicit command is given) and one of these
         switches is specified, <command>hostnamectl</command> will print out just this selected hostname.</para>
 
+        <para>This selection does not apply to JSON output: with <option>--json=</option>,
+        <command>status</command> always prints the full status object.</para>
+
         <para>If used with <command>hostname</command>, only the selected hostnames will be updated. When more
         than one of these switches are specified, all the specified hostnames will be updated. </para>