X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=elogind.git;a=blobdiff_plain;f=man%2Fsd_pid_get_session.xml;h=fd1ce4b87e1a1946f18a73a144cc4a5369a3d138;hp=d2b64195a6eb666f42d7527ae406547dca4ad58c;hb=8e7076caae32a560a11c1643b53fc4f12db4a6b1;hpb=97e13058170c7759dbbc239d264b9a31b0c81079
diff --git a/man/sd_pid_get_session.xml b/man/sd_pid_get_session.xml
index d2b64195a..fd1ce4b87 100644
--- a/man/sd_pid_get_session.xml
+++ b/man/sd_pid_get_session.xml
@@ -47,7 +47,8 @@
sd_pid_get_unit
sd_pid_get_user_unit
sd_pid_get_owner_uid
- Determine session, service or owner of a session of a specific PID
+ sd_pid_get_machine_name
+ Determine session, service, owner of a session or container/VM of a specific PID
@@ -77,6 +78,12 @@
pid_t pid
uid_t* uid
+
+
+ int sd_pid_get_machine_name
+ pid_t pid
+ char** name
+
@@ -108,7 +115,7 @@
function will fail. (More specifically: this call will
not work for processes that are part of user units,
use sd_pid_get_user_unit() for
- that.) The returned string needs to be freed with the
+ that.) The returned string needs to be freed with the
libc
free3
call after use.
@@ -131,7 +138,15 @@
and not being a shared process of a user this function
will fail.
- If the pid parameter of any
+ sd_pid_machine_name() may
+ be used to determine the name of the VM or container
+ is a member of. The machine name is a short string,
+ suitable for usage in file system paths. The returned
+ string needs to be freed with the libc
+ free3
+ call after use.
+
+ If the pid parameter of any
of these functions is passed as 0 the operation is
executed for the calling process.
@@ -149,12 +164,12 @@
The sd_pid_get_session(),
sd_pid_get_unit(),
- sd_pid_get_user_unit(), and
- sd_pid_get_owner_uid() interfaces
- are available as shared library, which can be compiled
- and linked to with the
- libsystemd-login
- pkg-config1
+ sd_pid_get_user_unit(),
+ sd_pid_get_owner_uid() and
+ sd_pid_get_machine_name()
+ interfaces are available as shared library, which can
+ be compiled and linked to with the
+ libsystemd-login pkg-config1
file.
Note that the login session identifier as