summaryrefslogtreecommitdiff
path: root/man/sd_id128_get_machine.xml
diff options
context:
space:
mode:
authorZbigniew Jędrzejewski-Szmek <zbyszek@in.waw.pl>2018-08-21 16:25:21 +0200
committerZbigniew Jędrzejewski-Szmek <zbyszek@in.waw.pl>2018-10-02 15:15:10 +0200
commitadda90b03e0af45445b0afa65b90f9c1c55bae05 (patch)
tree2ddac5c9e7d47fc85025e6215924a205af2f22a5 /man/sd_id128_get_machine.xml
parent0d1d512f7f42071595f0c950f911f3557fda09ea (diff)
downloadsystemd-adda90b03e0af45445b0afa65b90f9c1c55bae05.tar.gz
man: add man page for systemd-id128
Diffstat (limited to 'man/sd_id128_get_machine.xml')
-rw-r--r--man/sd_id128_get_machine.xml15
1 files changed, 14 insertions, 1 deletions
diff --git a/man/sd_id128_get_machine.xml b/man/sd_id128_get_machine.xml
index f797a8af4e..0884838324 100644
--- a/man/sd_id128_get_machine.xml
+++ b/man/sd_id128_get_machine.xml
@@ -134,7 +134,20 @@
<example>
<title>Application-specific machine ID</title>
- <para>Here's a simple example for an application specific machine ID:</para>
+ <para>First, generate the application ID:</para>
+ <programlisting>$ systemd-id128 -p new
+As string:
+c273277323db454ea63bb96e79b53e97
+
+As UUID:
+c2732773-23db-454e-a63b-b96e79b53e97
+
+As man:sd-id128(3) macro:
+#define MESSAGE_XYZ SD_ID128_MAKE(c2,73,27,73,23,db,45,4e,a6,3b,b9,6e,79,b5,3e,97)
+...
+</programlisting>
+
+ <para>Then use the new identifier in an example application:</para>
<programlisting><xi:include href="id128-app-specific.c" parse="text" /></programlisting>
</example>