X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?a=blobdiff_plain;f=man%2Fsd_id128_to_string.xml;h=eae291578a50026cece1028c5669e8126f468b6d;hb=708c143c7cd2bbd748ac0fa993496ff44e72701c;hp=ec8b263e0d5b5def1f922845fed9ad3c93056976;hpb=bb31a4ac1997c189a344caf554f34c6aabc71aa7;p=elogind.git
diff --git a/man/sd_id128_to_string.xml b/man/sd_id128_to_string.xml
index ec8b263e0..eae291578 100644
--- a/man/sd_id128_to_string.xml
+++ b/man/sd_id128_to_string.xml
@@ -45,7 +45,7 @@
sd_id128_to_string
sd_id128_from_string
- Format or parse 128 bit IDs as strings
+ Format or parse 128-bit IDs as strings
@@ -59,7 +59,7 @@
int sd_id128_from_string
- const char s[33], sd_id128_t* ret
+ const char* s, sd_id128_t* ret
@@ -69,24 +69,30 @@
Description
sd_id128_to_string()
- formats a 128 bit ID as character string. It expects
+ formats a 128-bit ID as a character string. It expects
the ID and a string array capable of storing 33
characters. The ID will be formatted as 32 lowercase
- hexadecimal digits and be terminated by a NUL
- byte.
+ hexadecimal digits and be terminated by a
+ NUL byte.
sd_id128_from_string()
implements the reverse operation: it takes a 33
- character array with 32 hexadecimal digits
- (terminated by NUL) and parses them back into an
- 128 bit ID returned in
- ret.
+ character string with 32 hexadecimal digits (either
+ lowercase or uppercase, terminated by
+ NUL) and parses them back into a
+ 128-bit ID returned in
+ ret. Alternatively, this call
+ can also parse a 37-character string with a 128-bit ID
+ formatted as RFC UUID.
For more information about the
sd_id128_t type see
- sd-id1283.
+ sd-id1283. Note
+ that these calls operate the same way on all
+ architectures, i.e. the results do not depend on
+ endianness.
- When formatting a 128 bit ID into a string it is
+ When formatting a 128-bit ID into a string, it is
often easier to use a format string for
printf3. This
is easily done using the
@@ -101,9 +107,9 @@
sd_id128_to_string() always
succeeds and returns a pointer to the string array
- passed in. sd_id128_from_string
- returns 0 on success (in which case
- ret is filled in), or a negative
+ passed in. sd_id128_from_string
+ returns 0 on success, in which case
+ ret is filled in, or a negative
errno-style error code.
@@ -112,9 +118,8 @@
The sd_id128_to_string()
and sd_id128_from_string() interfaces are
- available as shared library, which can be compiled and
- linked to with the libsystemd-id128
- pkg-config1
+ available as a shared library, which can be compiled and
+ linked to with the libsystemd-id128Â pkg-config1
file.