X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=elogind.git;a=blobdiff_plain;f=man%2Fsd_id128_randomize.xml;h=a5daae2bd36e187ad1b01e580f3ec181d6fa7be5;hp=0b9580308ac1bbb5d4af849c9217a35ddea30f42;hb=167bf427227158dbcad675d951e67038f23a9486;hpb=e9dd9f9547350c7dc0473583b5c2228dc8f0ab76 diff --git a/man/sd_id128_randomize.xml b/man/sd_id128_randomize.xml index 0b9580308..a5daae2bd 100644 --- a/man/sd_id128_randomize.xml +++ b/man/sd_id128_randomize.xml @@ -1,116 +1,114 @@ + "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"> - - sd_id128_randomize - systemd - - - - Developer - Lennart - Poettering - lennart@poettering.net - - - - - - sd_id128_randomize - 3 - - - - sd_id128_randomize - Generate 128-bit IDs - - - - - #include <systemd/sd-id128.h> - - - int sd_id128_randomize - sd_id128_t* ret - - - - - - - Description - - sd_id128_randomize() - generates a new randomized 128-bit ID and returns it - in ret. Every invocation - returns a new randomly generated ID. This uses the - /dev/urandom kernel random number - generator. - - Note that - sd_id128_randomize() always returns - a UUID v4-compatible ID. - - For more information about the - sd_id128_t type, see - sd-id1283. - - journalctl1's - option may be used as a - command-line front-end for - sd_id128_randomize(). - - - - Return Value - - The call returns 0 on success (in which - case ret is filled in), or a - negative errno-style error code. - - - - Notes - - The sd_id128_randomize() interface - is available as shared library, which can be compiled - and linked to with the - libsystemd-id128 pkg-config1 - file. - - - - See Also - - - systemd1, - sd-id1283, - machine-id5, - random4, - sd_id128_get_machine3 - - + + sd_id128_randomize + elogind + + + + Developer + Lennart + Poettering + lennart@poettering.net + + + + + + sd_id128_randomize + 3 + + + + sd_id128_randomize + Generate 128-bit IDs + + + + + #include <elogind/sd-id128.h> + + + int sd_id128_randomize + sd_id128_t *ret + + + + + + + Description + + sd_id128_randomize() generates a new + randomized 128-bit ID and returns it in + ret. Every invocation returns a new + randomly generated ID. This uses the + /dev/urandom kernel random number + generator. + + Note that sd_id128_randomize() always + returns a UUID v4-compatible ID. + + For more information about the sd_id128_t + type, see + sd-id1283. + + journalctl1's + option may be used as a command line + front-end for sd_id128_randomize(). + + + + Return Value + + The call returns 0 on success (in which case + ret is filled in), or a negative + errno-style error code. + + + + Notes + + The sd_id128_randomize() interface is + available as a shared library, which can be compiled and linked to + with the + libelogind pkg-config1 + file. + + + + See Also + + + elogind1, + sd-id1283, + machine-id5, + random4, + sd_id128_get_machine3 + +