diff options
| author | Lennart Poettering <lennart@poettering.net> | 2012-10-16 17:02:51 +0200 |
|---|---|---|
| committer | Lennart Poettering <lennart@poettering.net> | 2012-10-16 17:02:51 +0200 |
| commit | 183de6d7d9def43ec90b94e775fdc49539a950ba (patch) | |
| tree | f285b3881d31c41d8417f8c02c8032b92c6f256d /man | |
| parent | 706911fba8d071449848f02516eef117277ff48b (diff) | |
id128: introduce new SD_ID128_CONST_STR() macro
Diffstat (limited to 'man')
| -rw-r--r-- | man/sd-id128.xml | 15 |
1 files changed, 13 insertions, 2 deletions
diff --git a/man/sd-id128.xml b/man/sd-id128.xml index d45339043d..abd2004d1c 100644 --- a/man/sd-id128.xml +++ b/man/sd-id128.xml @@ -46,6 +46,7 @@ <refname>sd-id128</refname> <refname>sd_id128_t</refname> <refname>SD_ID128_MAKE</refname> + <refname>SD_ID128_CONST_STR</refname> <refname>SD_ID128_FORMAT_STR</refname> <refname>SD_ID128_FORMAT_VAL</refname> <refname>sd_id128_equal</refname> @@ -104,11 +105,21 @@ decode 128 bit IDs:</para> <para><function>SD_ID128_MAKE()</function> 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:</para> + 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:</para> <programlisting>#define SD_MESSAGE_COREDUMP SD_ID128_MAKE(fc,2e,22,bc,6e,e6,47,b6,b9,07,29,ab,34,a2,50,b1)</programlisting> + <para><function>SD_ID128_CONST_STR()</function> may be + use to convert constant 128bit IDs into constant + strings for output. The following example code will + output the string + "fc2e22bc6ee647b6b90729ab34a250b1":</para> + <programlisting>int main(int argc, char *argv[]) { + puts(SD_ID128_CONST_STR(SD_MESSAGE_COREDUMP)); +}</programlisting> + <para><function>SD_ID128_FORMAT_STR</function> and <function>SD_ID128_FORMAT_VAL()</function> may be used to format a 128 bit ID in a |