X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?a=blobdiff_plain;f=man%2Fsd_id128_get_machine.xml;h=cd6c39032c497b8995bd705dda38cf4b0b07f243;hb=20d9767d610b86432b3e6893d208604f384c41ca;hp=4fa6f84cf2c6c34725892149cab1cbcb1ea86d32;hpb=5124757683a8a517261760e28d2c9c16b379e000;p=elogind.git
diff --git a/man/sd_id128_get_machine.xml b/man/sd_id128_get_machine.xml
index 4fa6f84cf..cd6c39032 100644
--- a/man/sd_id128_get_machine.xml
+++ b/man/sd_id128_get_machine.xml
@@ -45,6 +45,7 @@
sd_id128_get_machine
sd_id128_get_boot
+ sd_id128_get_invocation
Retrieve 128-bit IDs
@@ -62,6 +63,11 @@
sd_id128_t *ret
+
+ int sd_id128_get_invocation
+ sd_id128_t *ret
+
+
@@ -83,11 +89,15 @@
for more information. This function also internally caches the
returned ID to make this call a cheap operation.
- Note that sd_id128_get_boot() always
- returns a UUID v4 compatible ID.
- sd_id128_get_machine() will also return a
- UUID v4-compatible ID on new installations but might not on older.
- It is possible to convert the machine ID into a UUID v4-compatible
+ sd_id128_get_invocation() returns the invocation ID of the currently executed
+ service. In its current implementation, this reads and parses the $INVOCATION_ID environment
+ variable that the service manager sets when activating a service, see
+ systemd.exec5 for details. The
+ ID is cached internally. In future a different mechanism to determine the invocation ID may be added.
+
+ Note that sd_id128_get_boot() and sd_id128_get_invocation() always
+ return UUID v4 compatible IDs. sd_id128_get_machine() will also return a UUID v4-compatible
+ ID on new installations but might not on older. It is possible to convert the machine ID into a UUID v4-compatible
one. For more information, see
machine-id5.
@@ -107,22 +117,22 @@
Notes
- The sd_id128_get_machine() and
- sd_id128_get_boot() interfaces are available
- as a shared library, which can be compiled and linked to with the
- libelogind pkg-config1
- file.
+ The sd_id128_get_machine(), sd_id128_get_boot() and
+ sd_id128_get_invocation() interfaces are available as a shared library, which can be compiled
+ and linked to with the libsystemd pkg-config1 file.
See Also
- elogind8,
+ systemd1,
sd-id1283,
machine-id5,
- random4,
- sd_id128_randomize3
+ systemd.exec5,
+ sd_id128_randomize3,
+ random4