Movatterモバイル変換

sd_id128_randomize(3) — Linux manual page

SD_ID128_RANDOMIZE(3)       sd_id128_randomizeSD_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 inret. Every invocation returns a new randomly       generated ID. This uses thegetrandom(2) kernel random number       generator.       Note thatsd_id128_randomize()always returns a UUID Variant 1       Version 4 compatible ID. It is hence guaranteed that this function       will never return the ID consisting of all zero or all one bits       (SD_ID128_NULL,SD_ID128_ALLF).       For more information about the "sd_id128_t" type, seesd-id128(3).systemd-id128(1)'snewcommand may be used as a command line       front-end forsd_id128_randomize().

RETURN VALUE        top

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

NOTES        top

       Functions described here are available as a shared library, which       can be compiled against and linked to with thelibsystemd pkg-config(1) file.       The code described here usesgetenv(3), which is declared to be       not multi-thread-safe. This means that the code calling the       functions described here must not callsetenv(3) from a parallel       thread. It is recommended to only do calls tosetenv()from an       early phase of the program when no other threads have been       started.

HISTORY        top

sd_id128_randomize()was added in version 187.

SEE ALSO        top

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

COLOPHON        top

       This page is part of thesystemd (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 2025-08-11.  (At that       time, the date of the most recent commit that was found in the       repository was 2025-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 isnot part of the original manual page), send a mail to       man-pages@man7.orgsystemd 258~rc2SD_ID128_RANDOMIZE(3)

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

HTML rendering created 2025-09-06 byMichael Kerrisk, author ofThe Linux Programming Interface. For details of in-depthLinux/UNIX system programming training courses that I teach, lookhere. Hosting byjambit GmbH.