summaryrefslogtreecommitdiffstats
path: root/man
diff options
context:
space:
mode:
authorZbigniew Jędrzejewski-Szmek <zbyszek@in.waw.pl>2023-09-06 09:59:11 +0200
committerZbigniew Jędrzejewski-Szmek <zbyszek@in.waw.pl>2023-09-06 16:56:40 +0200
commitb477c6949a4c3cd6b861b473134b3f2630292c68 (patch)
tree50679e4c2ba21343180279376a114918d54dfa61 /man
parenttest-network: Add test for PREF64 (diff)
downloadsystemd-b477c6949a4c3cd6b861b473134b3f2630292c68.tar.xz
systemd-b477c6949a4c3cd6b861b473134b3f2630292c68.zip
man/systemd-id128: fix example
The example was supposed to show how machine-id/new/machine-id --app-specific/show --app-specific tie together, but the verb was ommitted. I also extended the explanation a bit and used long option form in the first example for more clarity. In the second, more complicated example, the one-letter form is used for brevity. Noticed in post-review: https://github.com/systemd/systemd/pull/28988/commits/b37e8184a5a376749fbf68674ed6d7a4fc9901aa#r1315678438
Diffstat (limited to 'man')
-rw-r--r--man/systemd-id128.xml14
1 files changed, 8 insertions, 6 deletions
diff --git a/man/systemd-id128.xml b/man/systemd-id128.xml
index 32226363cb..32c5af9671 100644
--- a/man/systemd-id128.xml
+++ b/man/systemd-id128.xml
@@ -161,10 +161,10 @@
<example>
<title>Show a well-known UUID</title>
<programlisting>
-$ systemd-id128 show -P user-home
+$ systemd-id128 show --value user-home
773f91ef66d449b5bd83d683bf40ad16
-$ systemd-id128 show -Pu user-home
+$ systemd-id128 show --value --uuid user-home
773f91ef-66d4-49b5-bd83-d683bf40ad16
$ systemd-id128 show 773f91ef-66d4-49b5-bd83-d683bf40ad16
@@ -183,16 +183,18 @@ $ systemd-id128 machine-id -u
$ systemd-id128 new -u
1fb8f24b-02df-458d-9659-cc8ace68e28a
-$ systemd-id128 --app=1fb8f24b-02df-458d-9659-cc8ace68e28a
+$ systemd-id128 machine-id -u -a 1fb8f24b-02df-458d-9659-cc8ace68e28a
47b82cb1-5339-43da-b2a6-1c350aef1bd1
-$ systemd-id128 -Pu show 3a9d668b-4db7-4939-8a4a-5e78a03bffb7 --app=1fb8f24b-02df-458d-9659-cc8ace68e28a
+$ systemd-id128 -Pu show 3a9d668b-4db7-4939-8a4a-5e78a03bffb7 \
+ -a 1fb8f24b-02df-458d-9659-cc8ace68e28a
47b82cb1-5339-43da-b2a6-1c350aef1bd1
</programlisting>
<para>On a given machine with the ID 3a9d668b-4db7-4939-8a4a-5e78a03bffb7, for the application
- 1fb8f24b-02df-458d-9659-cc8ace68e28a, we generate an application-specific machine ID. If we want to
- later recreate the same calculation on a different machine, we need to specify both IDs explicitly.
+ 1fb8f24b-02df-458d-9659-cc8ace68e28a, we generate an application-specific machine ID
+ (47b82cb1-5339-43da-b2a6-1c350aef1bd1). If we want to later recreate the same calculation on a
+ different machine, we need to specify both IDs explicitly as parameters to <command>show</command>.
</para>
</example>
</refsect1>