diff options
Diffstat (limited to 'man/sd_id128_get_machine.xml')
| -rw-r--r-- | man/sd_id128_get_machine.xml | 41 |
1 files changed, 26 insertions, 15 deletions
diff --git a/man/sd_id128_get_machine.xml b/man/sd_id128_get_machine.xml index 43ee26d..59f3266 100644 --- a/man/sd_id128_get_machine.xml +++ b/man/sd_id128_get_machine.xml @@ -1,6 +1,6 @@ <?xml version='1.0'?> <!--*-nxml-*--> <!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" - "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"> + "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"> <!-- SPDX-License-Identifier: LGPL-2.1-or-later --> <refentry id="sd_id128_get_machine" xmlns:xi="http://www.w3.org/2001/XInclude"> @@ -63,6 +63,12 @@ <paramdef>sd_id128_t *<parameter>ret</parameter></paramdef> </funcprototype> + <funcprototype> + <funcdef>int <function>sd_id128_get_invocation_app_specific</function></funcdef> + <paramdef>sd_id128_t <parameter>app_id</parameter></paramdef> + <paramdef>sd_id128_t *<parameter>ret</parameter></paramdef> + </funcprototype> + </funcsynopsis> </refsynopsisdiv> @@ -126,12 +132,16 @@ for details. The ID is cached internally. In future a different mechanism to determine the invocation ID may be added.</para> + <para><function>sd_id128_get_invocation_app_specific()</function> derives an application-specific ID from + the invocation ID.</para> + <para>Note that <function>sd_id128_get_machine_app_specific()</function>, - <function>sd_id128_get_boot()</function>, <function>sd_id128_get_boot_app_specific()</function>, and - <function>sd_id128_get_invocation()</function> always return UUID Variant 1 Version 4 compatible IDs. - <function>sd_id128_get_machine()</function> will also return a UUID Variant 1 Version 4 compatible ID on - new installations but might not on older. It is possible to convert the machine ID non-reversibly into a - UUID Variant 1 Version 4 compatible one. For more information, see + <function>sd_id128_get_boot()</function>, <function>sd_id128_get_boot_app_specific()</function>, + <function>sd_id128_get_invocation()</function> and + <function>sd_id128_get_invocation_app_specific</function> always return UUID Variant 1 Version 4 + compatible IDs. <function>sd_id128_get_machine()</function> will also return a UUID Variant 1 Version 4 + compatible ID on new installations but might not on older. It is possible to convert the machine ID + non-reversibly into a UUID Variant 1 Version 4 compatible one. For more information, see <citerefentry><refentrytitle>machine-id</refentrytitle><manvolnum>5</manvolnum></citerefentry>. It is hence guaranteed that these functions will never return the ID consisting of all zero or all one bits (<constant>SD_ID128_NULL</constant>, <constant>SD_ID128_ALLF</constant>) — with the possible exception of @@ -262,20 +272,21 @@ As man:sd-id128(3) macro: <para><function>sd_id128_get_machine_app_specific()</function> was added in version 233.</para> <para><function>sd_id128_get_boot_app_specific()</function> was added in version 240.</para> <para><function>sd_id128_get_app_specific()</function> was added in version 255.</para> + <para><function>sd_id128_get_invocation_app_specific()</function> was added in version 256.</para> </refsect1> <refsect1> <title>See Also</title> - <para> - <citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>, - <citerefentry><refentrytitle>systemd-id128</refentrytitle><manvolnum>1</manvolnum></citerefentry>, - <citerefentry><refentrytitle>sd-id128</refentrytitle><manvolnum>3</manvolnum></citerefentry>, - <citerefentry><refentrytitle>machine-id</refentrytitle><manvolnum>5</manvolnum></citerefentry>, - <citerefentry><refentrytitle>systemd.exec</refentrytitle><manvolnum>5</manvolnum></citerefentry>, - <citerefentry><refentrytitle>sd_id128_randomize</refentrytitle><manvolnum>3</manvolnum></citerefentry>, - <citerefentry project='man-pages'><refentrytitle>random</refentrytitle><manvolnum>4</manvolnum></citerefentry> - </para> + <para><simplelist type="inline"> + <member><citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry></member> + <member><citerefentry><refentrytitle>systemd-id128</refentrytitle><manvolnum>1</manvolnum></citerefentry></member> + <member><citerefentry><refentrytitle>sd-id128</refentrytitle><manvolnum>3</manvolnum></citerefentry></member> + <member><citerefentry><refentrytitle>machine-id</refentrytitle><manvolnum>5</manvolnum></citerefentry></member> + <member><citerefentry><refentrytitle>systemd.exec</refentrytitle><manvolnum>5</manvolnum></citerefentry></member> + <member><citerefentry><refentrytitle>sd_id128_randomize</refentrytitle><manvolnum>3</manvolnum></citerefentry></member> + <member><citerefentry project='man-pages'><refentrytitle>random</refentrytitle><manvolnum>4</manvolnum></citerefentry></member> + </simplelist></para> </refsect1> </refentry> |