diff options
author | Zbigniew Jędrzejewski-Szmek <zbyszek@in.waw.pl> | 2021-06-11 18:17:00 +0200 |
---|---|---|
committer | Zbigniew Jędrzejewski-Szmek <zbyszek@in.waw.pl> | 2021-06-15 22:01:39 +0200 |
commit | 7c7683f36ccaf6080fb7cb10b52de4ae2791ea32 (patch) | |
tree | f85357fc6e7996b3e657d965a50c189575d55d22 /man/sd-id128.xml | |
parent | 8156422c8f0d94d3444043282f01551084271b22 (diff) | |
download | systemd-7c7683f36ccaf6080fb7cb10b52de4ae2791ea32.tar.gz |
sd-id128: add SD_ID128_MAKE_UUID_STR
It's like SD_ID128_MAKE_STR, but with hyphens.
Diffstat (limited to 'man/sd-id128.xml')
-rw-r--r-- | man/sd-id128.xml | 11 |
1 files changed, 7 insertions, 4 deletions
diff --git a/man/sd-id128.xml b/man/sd-id128.xml index 716c62522d..891a4585c6 100644 --- a/man/sd-id128.xml +++ b/man/sd-id128.xml @@ -24,6 +24,7 @@ <refname>SD_ID128_FORMAT_VAL</refname> <refname>SD_ID128_MAKE</refname> <refname>SD_ID128_MAKE_STR</refname> + <refname>SD_ID128_MAKE_UUID_STR</refname> <refname>SD_ID128_NULL</refname> <refname>SD_ID128_UUID_FORMAT_STR</refname> <refname>sd_id128_equal</refname> @@ -121,10 +122,12 @@ int main(int argc, char **argv) { return 0; }</programlisting> - <para><constant>SD_ID128_UUID_FORMAT_STR</constant> is similar to - <constant>SD_ID128_FORMAT_STR</constant> but includes separating hyphens to conform to the "<ulink - url="https://en.wikipedia.org/wiki/Universally_unique_identifier#Format">canonical - representation</ulink>". This formats the string based on <ulink + <para><constant>SD_ID128_UUID_FORMAT_STR</constant> and <function>SD_ID128_MAKE_UUID_STR()</function> + are similar to + <constant>SD_ID128_FORMAT_STR</constant> and <function>SD_ID128_MAKE_STR()</function>, + but include separating hyphens to conform to the + "<ulink url="https://en.wikipedia.org/wiki/Universally_unique_identifier#Format">canonical representation</ulink>". + They format the string based on <ulink url="https://tools.ietf.org/html/rfc4122">RFC4122</ulink> Variant 1 rules, i.e. converting from Big Endian byte order. This matches behaviour of most other Linux userspace infrastructure. It's probably best to avoid UUIDs of other variants, in order to avoid unnecessary ambiguities. All 128-bit IDs |