summaryrefslogtreecommitdiff
path: root/man/sd-id128.xml
diff options
context:
space:
mode:
authorZbigniew Jędrzejewski-Szmek <zbyszek@in.waw.pl>2021-06-11 18:17:00 +0200
committerZbigniew Jędrzejewski-Szmek <zbyszek@in.waw.pl>2021-06-15 22:01:39 +0200
commit7c7683f36ccaf6080fb7cb10b52de4ae2791ea32 (patch)
treef85357fc6e7996b3e657d965a50c189575d55d22 /man/sd-id128.xml
parent8156422c8f0d94d3444043282f01551084271b22 (diff)
downloadsystemd-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.xml11
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