summaryrefslogtreecommitdiffstats
path: root/upstream/debian-unstable/man3/sd_id128_get_machine.3
diff options
context:
space:
mode:
Diffstat (limited to 'upstream/debian-unstable/man3/sd_id128_get_machine.3')
-rw-r--r--upstream/debian-unstable/man3/sd_id128_get_machine.322
1 files changed, 13 insertions, 9 deletions
diff --git a/upstream/debian-unstable/man3/sd_id128_get_machine.3 b/upstream/debian-unstable/man3/sd_id128_get_machine.3
index dc12a935..dad65f5e 100644
--- a/upstream/debian-unstable/man3/sd_id128_get_machine.3
+++ b/upstream/debian-unstable/man3/sd_id128_get_machine.3
@@ -1,5 +1,5 @@
'\" t
-.TH "SD_ID128_GET_MACHINE" "3" "" "systemd 255" "sd_id128_get_machine"
+.TH "SD_ID128_GET_MACHINE" "3" "" "systemd 256~rc3" "sd_id128_get_machine"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
@@ -40,6 +40,8 @@ sd_id128_get_machine, sd_id128_get_app_specific, sd_id128_get_machine_app_specif
.BI "int sd_id128_get_boot_app_specific(sd_id128_t\ " "app_id" ", sd_id128_t\ *" "ret" ");"
.HP \w'int\ sd_id128_get_invocation('u
.BI "int sd_id128_get_invocation(sd_id128_t\ *" "ret" ");"
+.HP \w'int\ sd_id128_get_invocation_app_specific('u
+.BI "int sd_id128_get_invocation_app_specific(sd_id128_t\ " "app_id" ", sd_id128_t\ *" "ret" ");"
.SH "DESCRIPTION"
.PP
\fBsd_id128_get_machine()\fR
@@ -120,11 +122,16 @@ See
\fBsystemd.exec\fR(5)
for details\&. The ID is cached internally\&. In future a different mechanism to determine the invocation ID may be added\&.
.PP
+\fBsd_id128_get_invocation_app_specific()\fR
+derives an application\-specific ID from the invocation ID\&.
+.PP
Note that
\fBsd_id128_get_machine_app_specific()\fR,
\fBsd_id128_get_boot()\fR,
-\fBsd_id128_get_boot_app_specific()\fR, and
+\fBsd_id128_get_boot_app_specific()\fR,
\fBsd_id128_get_invocation()\fR
+and
+\fBsd_id128_get_invocation_app_specific\fR
always return UUID Variant 1 Version 4 compatible IDs\&.
\fBsd_id128_get_machine()\fR
will also return a UUID Variant 1 Version 4 compatible ID on new installations but might not on older\&. It is possible to convert the machine ID non\-reversibly into a UUID Variant 1 Version 4 compatible one\&. For more information, see
@@ -306,15 +313,12 @@ was added in version 240\&.
.PP
\fBsd_id128_get_app_specific()\fR
was added in version 255\&.
+.PP
+\fBsd_id128_get_invocation_app_specific()\fR
+was added in version 256\&.
.SH "SEE ALSO"
.PP
-\fBsystemd\fR(1),
-\fBsystemd-id128\fR(1),
-\fBsd-id128\fR(3),
-\fBmachine-id\fR(5),
-\fBsystemd.exec\fR(5),
-\fBsd_id128_randomize\fR(3),
-\fBrandom\fR(4)
+\fBsystemd\fR(1), \fBsystemd-id128\fR(1), \fBsd-id128\fR(3), \fBmachine-id\fR(5), \fBsystemd.exec\fR(5), \fBsd_id128_randomize\fR(3), \fBrandom\fR(4)
.SH "NOTES"
.IP " 1." 4
RFC 4122