X-Git-Url: https://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?a=blobdiff_plain;f=man%2Fsd-id128.xml;h=5a4146a0f9c044fdc3566b8081c611e82da156fc;hb=e57e4e2be345f346bb49547ecad71dc000c406b2;hp=cbc130d7513578326a173a41abcc8eca3bbc3b06;hpb=12355095821fc17529af5b6eaefa31c3c520be39;p=elogind.git
diff --git a/man/sd-id128.xml b/man/sd-id128.xml
index cbc130d75..5a4146a0f 100644
--- a/man/sd-id128.xml
+++ b/man/sd-id128.xml
@@ -21,7 +21,8 @@
along with systemd; If not, see .
-->
-
+sd-id128
@@ -39,17 +40,18 @@
sd-id128
- 7
+ 3sd-id128sd_id128_tSD_ID128_MAKE
+ SD_ID128_CONST_STRSD_ID128_FORMAT_STRSD_ID128_FORMAT_VALsd_id128_equal
- APIs for processing 128 bit IDs
+ APIs for processing 128-bit IDs
@@ -58,7 +60,7 @@
- pkg-config --cflags --libs libsystemd-id128
+ pkg-config --cflags --libs libsystemd
@@ -67,23 +69,24 @@
Descriptionsd-id128.h provides APIs to
- process and generate 128 bit ID values. The 128 bit ID
+ process and generate 128-bit ID values. The 128-bit ID
values processed and generated by these APIs are a
generalization of OSF UUIDs as defined by RFC
- 4122, though use a simpler string
- formatting. These functions impose no structure on the
+ url="https://tools.ietf.org/html/rfc4122">RFC
+ 4122 but use a simpler string
+ format. These functions impose no structure on the
used IDs, much unlike OSF UUIDs or Microsoft GUIDs,
but are fully compatible with those types of IDs.
See
- sd_id128_to_string3 and
- sd_id128_randomize3
- for more information about the functions
- implemented.
+ sd_id128_to_string3,
+ sd_id128_randomize3 and
+ sd_id128_get_machine3
+ for more information about the implemented
+ functions.
- A 128 bit ID is implemented as the following
+ A 128-bit ID is implemented as the following
union type:typedef union sd_id128 {
@@ -91,26 +94,36 @@
uint64_t qwords[2];
} sd_id128_t;
- This union type allows accessing the 128 bit ID
- as 16 separate bytes or 2 64 bit words. It is generally
- safer to access the ID components by their 8 bit array
- to avoid endianess issues. This union is intended to
+ This union type allows accessing the 128-bit ID
+ as 16 separate bytes or two 64-bit words. It is generally
+ safer to access the ID components by their 8-bit array
+ to avoid endianness issues. This union is intended to
be passed call-by-value (as opposed to
call-by-reference) and may be directly manipulated by
clients.A couple of macros are defined to denote and
- decode 128 bit IDs:
+ decode 128-bit IDs:SD_ID128_MAKE() may be used
- to write a 128 bit ID in source code. A commonly used
- idiom is to give 128 bit IDs names using this macro:
+ to denote a constant 128-bit ID in source code. A
+ commonly used idiom is to assign a name to a 128-bit
+ ID using this macro:#define SD_MESSAGE_COREDUMP SD_ID128_MAKE(fc,2e,22,bc,6e,e6,47,b6,b9,07,29,ab,34,a2,50,b1)
+ SD_ID128_CONST_STR() may be
+ used to convert constant 128-bit IDs into constant
+ strings for output. The following example code will
+ output the string
+ "fc2e22bc6ee647b6b90729ab34a250b1":
+ int main(int argc, char *argv[]) {
+ puts(SD_ID128_CONST_STR(SD_MESSAGE_COREDUMP));
+}
+
SD_ID128_FORMAT_STR and
SD_ID128_FORMAT_VAL() may be used
- to format a 128 bit ID in a
+ to format a 128-bit ID in a
printf3
format string, as shown in the following
example:
@@ -122,7 +135,7 @@
return 0;
}
- Use sd_id128_equal() to compare two 128 bit IDs:
+ Use sd_id128_equal() to compare two 128-bit IDs:int main(int argc, char *argv[]) {
sd_id128_t a, b, c;
@@ -137,19 +150,10 @@
Note that new, randomized IDs may be generated
with
journalctl1's
- --new-id command.
+ option.
-
- Notes
-
- These APIs are implemented as shared library,
- which can be compiled and linked to with the
- libsystemd-id128
- pkg-config1
- file.
-
-
+ See Also
@@ -157,6 +161,7 @@
systemd1,
sd_id128_to_string3,
sd_id128_randomize3,
+ sd_id128_get_machine3,
printf3,
journalctl1,
sd-journal7,