X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?a=blobdiff_plain;f=man%2Fsd_id128_randomize.xml;h=be74937dd0284787960463eedda5dcf7837d6cb0;hb=a0b8045be2206aec3558fdb11dad052cb590bf74;hp=499c55fb60bcc8b15ecfe21e157f171d80067e3f;hpb=12355095821fc17529af5b6eaefa31c3c520be39;p=elogind.git
diff --git a/man/sd_id128_randomize.xml b/man/sd_id128_randomize.xml
index 499c55fb6..be74937dd 100644
--- a/man/sd_id128_randomize.xml
+++ b/man/sd_id128_randomize.xml
@@ -44,9 +44,7 @@
sd_id128_randomize
- sd_id128_get_machine
- sd_id128_get_boot
- Generate or retrieve 128 bit IDs
+ Generate 128 bit IDs
@@ -58,16 +56,6 @@
sd_id128_t* ret
-
- int sd_id128_get_machine
- sd_id128_t* ret
-
-
-
- int sd_id128_get_boot
- sd_id128_t* ret
-
-
@@ -81,40 +69,14 @@
/dev/urandom kernel random number
generator.
- sd_id128_get_machine()
- returns the machine ID of the executing host. This
- reads and parses the
- machine-id5
- file. This function caches the machine ID internally
- to make retrieving the machine ID a cheap
- operation.
-
- sd_id128_get_boot() returns
- the boot ID of the executing kernel. This reads and
- parses the
- /proc/sys/kernel/random/boot_id
- file exposed by the kernel. It is randomly generated
- early at boot and is unique for every running kernel
- instance. See
- random4
- for more information. This function also internally
- caches the returned ID to make this call a cheap
- operation.
-
Note that
- sd_id128_randomize() and
- sd_id128_get_boot() always return
+ sd_id128_randomize() 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 an UUID v4 compatible
- one. For more information see
- machine-id5.
+ ID.
For more information about the
sd_id128_t type see
- sd-id1287.
+ sd-id1283.
journalctl1's
--new-id command may be used as
@@ -125,7 +87,7 @@
Return Value
- The three calls returns 0 on success (in which
+ The call returns 0 on success (in which
case ret is filled in), or a
negative errno-style error code.
@@ -133,10 +95,8 @@
Notes
- The sd_id128_randomize(),
- sd_id128_get_machine() and
- sd_id128_get_boot() interfaces
- are available as shared library, which can be compiled
+ The sd_id128_randomize() interface
+ is available as shared library, which can be compiled
and linked to with the
libsystemd-id128
pkg-config1
@@ -148,9 +108,10 @@
systemd1,
- sd-id1287,
+ sd-id1283,
machine-id5,
- random4
+ random4,
+ sd_id128_get_machine3