X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?a=blobdiff_plain;f=man%2Fsd_pid_get_session.xml;h=f85b413f0824d9d64b3611733ea203f093b4aa9d;hb=76cc80f42e53215b9039ca99dd35687c7518880a;hp=dc269b538b6cc06baadb72490a56921b17e15394;hpb=56c19a4f2a0091a3fe23712cbbc6c6e379572ffe;p=elogind.git diff --git a/man/sd_pid_get_session.xml b/man/sd_pid_get_session.xml index dc269b538..f85b413f0 100644 --- a/man/sd_pid_get_session.xml +++ b/man/sd_pid_get_session.xml @@ -3,29 +3,29 @@ "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"> sd_pid_get_session - systemd + elogind @@ -44,20 +44,12 @@ sd_pid_get_session - sd_pid_get_unit - sd_pid_get_user_unit sd_pid_get_owner_uid sd_pid_get_machine_name - sd_pid_get_slice - sd_pid_get_user_slice sd_pid_get_cgroup sd_peer_get_session - sd_peer_get_unit - sd_peer_get_user_unit sd_peer_get_owner_uid sd_peer_get_machine_name - sd_peer_get_slice - sd_peer_get_user_slice sd_peer_get_cgroup Determine session, unit, owner of a session, container/VM or slice of a specific PID or socket @@ -66,7 +58,7 @@ - #include <systemd/sd-login.h> + #include <elogind/sd-login.h> int sd_pid_get_session @@ -74,18 +66,6 @@ char **session - - int sd_pid_get_unit - pid_t pid - char **unit - - - - int sd_pid_get_user_unit - pid_t pid - char **unit - - int sd_pid_get_owner_uid pid_t pid @@ -98,18 +78,6 @@ char **name - - int sd_pid_get_slice - pid_t pid - char **slice - - - - int sd_pid_get_user_slice - pid_t pid - char **slice - - int sd_pid_get_cgroup pid_t pid @@ -122,18 +90,6 @@ char **session - - int sd_peer_get_unit - int fd - char **unit - - - - int sd_peer_get_user_unit - int fd - char **unit - - int sd_peer_get_owner_uid int fd @@ -146,18 +102,6 @@ char **name - - int sd_peer_get_slice - int fd - char **slice - - - - int sd_peer_get_user_slice - int fd - char **slice - - int sd_peer_get_cgroup int fd @@ -182,25 +126,6 @@ project='man-pages'>free3 call after use. - sd_pid_get_unit() may be used to - determine the systemd system unit (i.e. system service or scope - unit) identifier of a process identified by the specified PID. The - unit name is a short string, suitable for usage in file system - paths. Note that not all processes are part of a system - unit/service (e.g. user processes, or kernel threads). For - processes not being part of a systemd system unit, this function - will fail with -ENODATA. (More specifically, this call will not - work for kernel threads.) The returned string needs to be freed - with the libc free3 - call after use. - - sd_pid_get_user_unit() may be used to - determine the systemd user unit (i.e. user service or scope unit) - identifier of a process identified by the specified PID. This is - similar to sd_pid_get_unit(), but applies to - user units instead of system units. - sd_pid_get_owner_uid() may be used to determine the Unix UID (user identifier) of the owner of the session of a process identified the specified PID. Note that this @@ -219,18 +144,6 @@ call after use. For processes not part of a VM or containers, this function fails with -ENODATA. - 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. - - Similarly, sd_pid_get_user_slice() - returns the user slice (as managed by the user's systemd instance) - of a process. - sd_pid_get_cgroup() returns the control group path of the specified process, relative to the root of the hierarchy. Returns the path without trailing slash, except for @@ -247,12 +160,8 @@ calling process. The sd_peer_get_session(), - sd_peer_get_unit(), - sd_peer_get_user_unit(), sd_peer_get_owner_uid(), - sd_peer_get_machine_name(), - sd_peer_get_slice(), - sd_peer_get_user_slice() and + sd_peer_get_machine_name() and sd_peer_get_cgroup() calls operate similar to their PID counterparts, but operate on a connected AF_UNIX socket and retrieve information about the connected peer process. Note @@ -318,19 +227,11 @@ Notes The sd_pid_get_session(), - sd_pid_get_unit(), - sd_pid_get_user_unit(), sd_pid_get_owner_uid(), sd_pid_get_machine_name(), - sd_pid_get_slice(), - sd_pid_get_user_slice(), sd_peer_get_session(), - sd_peer_get_unit(), - sd_peer_get_user_unit(), sd_peer_get_owner_uid(), sd_peer_get_machine_name(), - sd_peer_get_slice() and - sd_peer_get_user_slice() interfaces are available as a shared library, which can be compiled and linked to with the libelogind pkg-config1 @@ -347,12 +248,12 @@ See Also - systemd1, + elogind8, sd-login3, sd_session_is_active3, getsid2, - systemd.slice5, - systemd-machined.service8 + elogind.slice5, + elogind-machined.service8