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=be74937dd0284787960463eedda5dcf7837d6cb0;hb=167bf427227158dbcad675d951e67038f23a9486;hpb=f274ece0f76b5709408821e317e87aef76123db6;ds=sidebyside diff --git a/man/sd_id128_randomize.xml b/man/sd_id128_randomize.xml index be74937dd..a5daae2bd 100644 --- a/man/sd_id128_randomize.xml +++ b/man/sd_id128_randomize.xml @@ -1,118 +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 - --new-id command may be used as - 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 + +