summaryrefslogtreecommitdiff
path: root/man/systemd.system-credentials.xml
diff options
context:
space:
mode:
authorLennart Poettering <lennart@poettering.net>2023-01-06 15:21:27 +0100
committerGitHub <noreply@github.com>2023-01-06 15:21:27 +0100
commit7122aee5ab12376926362cbe6eeeaa3b144b9eed (patch)
treefe9dbbbda4966015ec19958815a59263cecc35ae /man/systemd.system-credentials.xml
parent48d85160438827c1424104315547f960ec0d6e43 (diff)
parent03ede612beb6f401cf433e90988b21aa57788bb3 (diff)
downloadsystemd-7122aee5ab12376926362cbe6eeeaa3b144b9eed.tar.gz
Merge pull request #25918 from bluca/smbios_sd_notify
Support AF_VSOCK in sd_notify and pick up notify_socket from creds
Diffstat (limited to 'man/systemd.system-credentials.xml')
-rw-r--r--man/systemd.system-credentials.xml18
1 files changed, 18 insertions, 0 deletions
diff --git a/man/systemd.system-credentials.xml b/man/systemd.system-credentials.xml
index 9e49e3feae..95a437adc4 100644
--- a/man/systemd.system-credentials.xml
+++ b/man/systemd.system-credentials.xml
@@ -199,6 +199,24 @@
</listitem>
</varlistentry>
+ <varlistentry>
+ <term><varname>vmm.notify_socket</varname></term>
+ <listitem>
+ <para>This credential is parsed looking for an <constant>AF_VSOCK</constant> or
+ <constant>AF_UNIX</constant> address where to send a <constant>READY=1</constant>
+ notification datagram when the system has finished booting. See:
+ <citerefentry><refentrytitle>sd_notify</refentrytitle><manvolnum>3</manvolnum></citerefentry>
+ This is useful for hypervisors/VMMs or other processes on the host
+ to receive a notification via VSOCK when a virtual machine has finished booting.
+ Note that in case the hypervisor does not support <constant>SOCK_DGRAM</constant>
+ over <constant>AF_VSOCK</constant>, <constant>SOCK_SEQPACKET</constant> will be
+ tried instead. The credential payload for <constant>AF_VSOCK</constant> should be
+ in the form: <literal>vsock:CID:PORT</literal>, where <literal>CID</literal> is
+ optional and if omitted will default to talking to the hypervisor
+ (<constant>0</constant>).</para>
+ </listitem>
+ </varlistentry>
+
</variablelist>
</refsect1>