|
NAME | SYNOPSIS | DESCRIPTION | RETURN VALUE | NOTES | SEE ALSO | COLOPHON |
SD_ID128_RANDOMIZE(3) sd_id128_randomize SD_ID128_RANDOMIZE(3)
sd_id128_randomize - Generate 128-bit IDs
#include <systemd/sd-id128.h>
int sd_id128_randomize(sd_id128_t *ret);
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).
systemd-id128(1)'s new command may be used as a command line
front-end for sd_id128_randomize().
The call returns 0 on success (in which case ret is filled in), or a
negative errno-style error code.
These APIs are implemented as a shared library, which can be compiled
and linked to with the libsystemd pkg-config(1) file.
systemd(1), sd-id128(3), machine-id(5), random(4),
sd_id128_get_machine(3)
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 2020-08-13. (At that
time, the date of the most recent commit that was found in the repos‐
itory was 2020-08-11.) 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 246 SD_ID128_RANDOMIZE(3)
Pages that refer to this page: sd_bus_get_bus_id(3) , sd_bus_is_bus_client(3) , sd_bus_is_monitor(3) , sd_bus_is_server(3) , sd_bus_set_bus_client(3) , sd_bus_set_monitor(3) , sd_bus_set_server(3) , sd-id128(3) , sd_id128_const_str(3) , SD_ID128_CONST_STR(3) , sd_id128_equal(3) , sd_id128_format_str(3) , SD_ID128_FORMAT_STR(3) , sd_id128_format_val(3) , SD_ID128_FORMAT_VAL(3) , sd_id128_get_boot(3) , sd_id128_get_boot_app_specific(3) , sd_id128_get_invocation(3) , sd_id128_get_machine(3) , sd_id128_get_machine_app_specific(3) , sd_id128_is_null(3) , sd_id128_make(3) , SD_ID128_MAKE(3) , sd_id128_make_str(3) , SD_ID128_MAKE_STR(3) , sd_id128_null(3) , SD_ID128_NULL(3) , sd_id128_t(3) , sd_id128_uuid_format_str(3) , SD_ID128_UUID_FORMAT_STR(3) , 30-systemd-environment-d-generator(7) , systemd.directives(7) , systemd.index(7)