diff --git a/man/rules/meson.build b/man/rules/meson.build
index ddb1c6d5213..303b5846549 100644
--- a/man/rules/meson.build
+++ b/man/rules/meson.build
@@ -659,6 +659,7 @@ manpages = [
'ENABLE_HIBERNATE'],
['systemd-hostnamed.service', '8', ['systemd-hostnamed'], 'ENABLE_HOSTNAMED'],
['systemd-hwdb', '8', [], 'ENABLE_HWDB'],
+ ['systemd-id128', '1', [], ''],
['systemd-importd.service', '8', ['systemd-importd'], 'ENABLE_IMPORTD'],
['systemd-inhibit', '1', [], ''],
['systemd-initctl.service',
diff --git a/man/sd_id128_get_machine.xml b/man/sd_id128_get_machine.xml
index f797a8af4e2..08848383247 100644
--- a/man/sd_id128_get_machine.xml
+++ b/man/sd_id128_get_machine.xml
@@ -134,7 +134,20 @@
Application-specific machine ID
- Here's a simple example for an application specific machine ID:
+ First, generate the application ID:
+ $ 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)
+...
+
+
+ Then use the new identifier in an example application:
diff --git a/man/systemd-id128.xml b/man/systemd-id128.xml
new file mode 100644
index 00000000000..8a76cccd86b
--- /dev/null
+++ b/man/systemd-id128.xml
@@ -0,0 +1,122 @@
+
+
+
+
+
+
+
+ systemd-id128
+ systemd
+
+
+
+ systemd-id128
+ 1
+
+
+
+ systemd-id128
+ Generate and print sd-128 identifiers
+
+
+
+
+ systemd-id128
+ OPTIONS
+ new
+
+
+
+ systemd-id128
+ OPTIONS
+ machine-id
+
+
+
+ systemd-id128
+ OPTIONS
+ boot-id
+
+
+
+ systemd-id128
+ OPTIONS
+ invocation-id
+
+
+
+
+ Description
+
+ id128 may be used to conveniently print
+ sd-id1283
+ UUIDs. What identifier is printed depends on the specific verb.
+
+ With new, a new random identifier will be generated.
+
+ With machine-id, the identifier of the current machine will be
+ printed. See
+ machine-id5.
+
+
+ With boot-id, the identifier of the current boot will be
+ printed.
+
+ Both machine-id and boot-id may be combined
+ with the switch to
+ generate application-specific IDs. See
+ sd_id128_get_machine3
+ for the discussion when this is useful.
+
+ With invocation-id, the identifier of the current service invocation
+ will be printed. This is available in systemd services. See
+ systemd.exec5.
+
+
+
+
+ Options
+
+ The following options are understood:
+
+
+
+
+
+
+ Generate output as programming language snippets.
+
+
+
+
+
+
+ With this option, an identifier that is the result of hashing the
+ application identifier app-id and the machine identifier will be
+ printed. The app-id argument must be a valid sd-id128 string
+ identifying the application.
+
+
+
+
+
+
+
+
+
+ Exit status
+
+ On success, 0 is returned, a non-zero failure code otherwise.
+
+
+
+ See Also
+
+ systemd1,
+ sd-id1283,
+ sd_id128_get_machine3
+
+
+
+