diff options
author | Yu Watanabe <watanabe.yu+github@gmail.com> | 2022-12-08 15:49:02 +0900 |
---|---|---|
committer | Yu Watanabe <watanabe.yu+github@gmail.com> | 2022-12-12 22:06:35 +0900 |
commit | c576920e673114529c5bfe5ea29891a24a443338 (patch) | |
tree | e2de56f857a9358707d823c64df869034594e251 | |
parent | e2720340e9fdf3aee2e8998dc72798de50be3630 (diff) | |
download | systemd-c576920e673114529c5bfe5ea29891a24a443338.tar.gz |
man: mention that sd_id128_get_boot() and friend may return -ENOSYS
And drop to mention sd_id128_get_boot_app_specific() may return -ENOENT
or -ENOMEDIUM. The function does not read /etc/machine-id. But reads a
file in the procfs, which is a kind of the kernel API. Hence the
failures are caused only when the system has wrong setup.
-rw-r--r-- | man/sd_id128_get_machine.xml | 22 |
1 files changed, 14 insertions, 8 deletions
diff --git a/man/sd_id128_get_machine.xml b/man/sd_id128_get_machine.xml index 8bc76b686b..dbc6d4885d 100644 --- a/man/sd_id128_get_machine.xml +++ b/man/sd_id128_get_machine.xml @@ -129,19 +129,17 @@ <varlistentry> <term><constant>-ENOENT</constant></term> - <listitem><para>Returned by <function>sd_id128_get_machine()</function>, - <function>sd_id128_get_machine_app_specific()</function>, and - <function>sd_id128_get_boot_app_specific()</function> when <filename>/etc/machine-id</filename> is - missing.</para></listitem> + <listitem><para>Returned by <function>sd_id128_get_machine()</function> and + <function>sd_id128_get_machine_app_specific()</function> when <filename>/etc/machine-id</filename> + is missing.</para></listitem> </varlistentry> <varlistentry> <term><constant>-ENOMEDIUM</constant></term> - <listitem><para>Returned by <function>sd_id128_get_machine()</function>, - <function>sd_id128_get_machine_app_specific()</function>, and - <function>sd_id128_get_boot_app_specific()</function> when <filename>/etc/machine-id</filename> is - empty or all zeros.</para></listitem> + <listitem><para>Returned by <function>sd_id128_get_machine()</function> and + <function>sd_id128_get_machine_app_specific()</function> when <filename>/etc/machine-id</filename> + is empty or all zeros.</para></listitem> </varlistentry> <varlistentry> @@ -153,6 +151,14 @@ </varlistentry> <varlistentry> + <term><constant>-ENOSYS</constant></term> + + <listitem><para>Returned by <function>sd_id128_get_boot()</function> and + <function>sd_id128_get_boot_app_specific()</function> when <filename>/proc/</filename> is not + mounted.</para></listitem> + </varlistentry> + + <varlistentry> <term><constant>-ENXIO</constant></term> <listitem><para>Returned by <function>sd_id128_get_invocation()</function> if no invocation ID is |