X-Git-Url: https://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?a=blobdiff_plain;f=man%2Fsd_pid_get_session.xml;h=1e762f450b334fba6e40a782633a508fda581dfd;hb=d8148cc59d0faa44d26fe27f91eb177334b4e08b;hp=543a5c0c72d77264d30ad55cf68fb8c7edb1932c;hpb=7027ff61a34a12487712b382a061c654acc3a679;p=elogind.git
diff --git a/man/sd_pid_get_session.xml b/man/sd_pid_get_session.xml
index 543a5c0c7..1e762f450 100644
--- a/man/sd_pid_get_session.xml
+++ b/man/sd_pid_get_session.xml
@@ -48,7 +48,10 @@
sd_pid_get_user_unit
sd_pid_get_owner_uid
sd_pid_get_machine_name
- Determine session, service, owner of a session or container/VM of a specific PID
+ sd_pid_get_slice
+ Determine session, service, owner of a
+ session, container/VM or slice of a specific
+ PID
@@ -84,6 +87,12 @@
pid_t pid
char** name
+
+
+ int sd_pid_get_slice
+ pid_t pid
+ char** slice
+
@@ -138,23 +147,32 @@
and not being a shared process of a user this function
will fail.
- 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
+ sd_pid_get_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.
+
+ sd_pid_get_slice() may be
+ used to determine the slice unit the process is a
+ member of. See
+ systemd.slice5
+ for details about slices. 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
+ If the pid parameter of any
+ of these functions is passed as 0, the operation is
executed for the calling process.
Return Value
- On success these calls return 0 or a positive
+ On success, these calls return 0 or a positive
integer. On failure, these calls return a negative
errno-style error code.
@@ -165,12 +183,12 @@
The sd_pid_get_session(),
sd_pid_get_unit(),
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
+ sd_pid_get_owner_uid(),
+ sd_pid_get_machine_name() and
+ sd_pid_get_slice() interfaces are
+ available as a shared library, which can be compiled and
+ linked to with the
+ libsystemd pkg-config1
file.
Note that the login session identifier as
@@ -187,7 +205,8 @@
systemd1,
sd-login3,
sd_session_is_active3,
- getsid2
+ getsid2,
+ systemd.slice5