diff options
| author | Lennart Poettering <lennart@poettering.net> | 2021-06-15 17:55:17 +0200 |
|---|---|---|
| committer | Zbigniew Jędrzejewski-Szmek <zbyszek@in.waw.pl> | 2021-06-15 20:58:56 +0200 |
| commit | 39d02a175f08c8cc9e4507e1abce26912d00fac3 (patch) | |
| tree | ccdc51852d56613ef11bdc2c3a999656e35189b4 /man/sd_id128_get_machine.xml | |
| parent | 9b682672e4b21e6325b48da3dcca4b4a479378a6 (diff) | |
| download | systemd-39d02a175f08c8cc9e4507e1abce26912d00fac3.tar.gz | |
sd-id128: document everywhere that we treat all UUIDs as Variant 1
So in theory UUID Variant 2 (i.e. microsoft GUIDs) are supposed to be
displayed in native endian. That is of course a bad idea, and Linux
userspace generally didn't implement that, i.e. uuidd and similar.
Hence, let's not bother either, but let's document that we treat
everything the same as Variant 1, even if it declares something else.
Diffstat (limited to 'man/sd_id128_get_machine.xml')
| -rw-r--r-- | man/sd_id128_get_machine.xml | 8 |
1 files changed, 4 insertions, 4 deletions
diff --git a/man/sd_id128_get_machine.xml b/man/sd_id128_get_machine.xml index caf4caa300..a778f8a2b0 100644 --- a/man/sd_id128_get_machine.xml +++ b/man/sd_id128_get_machine.xml @@ -101,10 +101,10 @@ <para>Note that <function>sd_id128_get_machine_app_specific()</function>, <function>sd_id128_get_boot()</function>, <function>sd_id128_get_boot_app_specific()</function>, and - <function>sd_id128_get_invocation()</function> always return UUID v4 compatible IDs. - <function>sd_id128_get_machine()</function> 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 + <function>sd_id128_get_invocation()</function> always return UUID Variant 1 Version 4 compatible IDs. + <function>sd_id128_get_machine()</function> 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 <citerefentry><refentrytitle>machine-id</refentrytitle><manvolnum>5</manvolnum></citerefentry>. It is hence guaranteed that these functions will never return the ID consisting of all zero or all one bits (<constant>SD_ID128_NULL</constant>, <constant>SD_ID128_ALLF</constant>) — with the possible exception of |