sd_id128_randomize(3) - Linux manual page

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUE | NOTES | SEE ALSO | COLOPHON

SD_ID128_RANDOMIZE(3)        sd_id128_randomize        SD_ID128_RANDOMIZE(3)

NAME         top

       sd_id128_randomize - Generate 128-bit IDs

SYNOPSIS         top

       #include <systemd/sd-id128.h>

       int sd_id128_randomize(sd_id128_t *ret);

DESCRIPTION         top

       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-id128(3).

       journalctl(1)'s --new-id128 option may be used as a command line
       front-end for sd_id128_randomize().

RETURN VALUE         top

       The call returns 0 on success (in which case ret is filled in), or a
       negative errno-style error code.

NOTES         top

       The sd_id128_randomize() interface is available as a shared library,
       which can be compiled and linked to with the
       "libsystemd" pkg-config(1) file.

SEE ALSO         top

       systemd(1), sd-id128(3), machine-id(5), random(4),
       sd_id128_get_machine(3)

COLOPHON         top

       This page is part of the systemd (systemd system and service manager)
       project.  Information about the project can be found at 
       ⟨http://www.freedesktop.org/wiki/Software/systemd⟩.  If you have a bug
       report for this manual page, see
       ⟨http://www.freedesktop.org/wiki/Software/systemd/#bugreports⟩.  This
       page was obtained from the project's upstream Git repository
       ⟨https://github.com/systemd/systemd.git⟩ on 2018-02-02.  (At that
       time, the date of the most recent commit that was found in the repos‐
       itory was 2018-02-02.)  If you discover any rendering problems in
       this HTML version of the page, or you believe there is a better or
       more up-to-date source for the page, or you have corrections or
       improvements to the information in this COLOPHON (which is not part
       of the original manual page), send a mail to man-pages@man7.org

systemd 234                                            SD_ID128_RANDOMIZE(3)

Pages that refer to this page: sd-id128(3)sd_id128_get_machine(3)systemd.directives(7)systemd.index(7)