X-Git-Url: https://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?a=blobdiff_plain;f=man%2Fsd_pid_get_session.xml;h=e5c77090dd09854ed7ce3d977ed056385d156c4f;hb=d78a28e3d7c8736d9addc2e45762d0f511ebbcdb;hp=4086c5a826e270c0a028dc0c4037a3b4b7fd2d84;hpb=9847946e12479b27d3ebfd024f00a6ac33ce73d3;p=elogind.git
diff --git a/man/sd_pid_get_session.xml b/man/sd_pid_get_session.xml
index 4086c5a82..e5c77090d 100644
--- a/man/sd_pid_get_session.xml
+++ b/man/sd_pid_get_session.xml
@@ -8,20 +8,20 @@
Copyright 2010 Lennart Poettering
systemd is free software; you can redistribute it and/or modify it
- under the terms of the GNU General Public License as published by
- the Free Software Foundation; either version 2 of the License, or
+ under the terms of the GNU Lesser General Public License as published by
+ the Free Software Foundation; either version 2.1 of the License, or
(at your option) any later version.
systemd is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
- General Public License for more details.
+ Lesser General Public License for more details.
- You should have received a copy of the GNU General Public License
+ You should have received a copy of the GNU Lesser General Public License
along with systemd; If not, see .
-->
-
+
sd_pid_get_session
@@ -44,9 +44,14 @@
sd_pid_get_session
- sd_pid_get_service
+ 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
+ sd_pid_get_slice
+ Determine session, service, owner of a
+ session, container/VM or slice of a specific
+ PID
@@ -60,9 +65,15 @@
- int sd_pid_get_service
+ int sd_pid_get_unit
pid_t pid
- char** service
+ char** unit
+
+
+
+ int sd_pid_get_user_unit
+ pid_t pid
+ char** unit
@@ -70,6 +81,18 @@
pid_t pid
uid_t* uid
+
+
+ int sd_pid_get_machine_name
+ pid_t pid
+ char** name
+
+
+
+ int sd_pid_get_slice
+ pid_t pid
+ char** slice
+
@@ -90,18 +113,29 @@
free3
call after use.
- sd_pid_get_service() may be
- used to determine the system service identifier of a
- process identified by the specified process
- identifier. The service name is a short string,
+ sd_pid_get_unit() may be
+ used to determine the systemd system unit (i.e. system
+ service) 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 service (e.g. user
- processes, or kernel threads). For processes not being
- part of a system service this function will fail. The
- returned string needs to be freed with the libc
+ 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. (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
+ libc
free3
call after use.
+ sd_pid_get_user_unit() may
+ be used to determine the systemd user unit (i.e. user
+ service) 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 user identifier of the
owner of the session of a process identified the
@@ -112,12 +146,33 @@
fail. For processes not being part of a login session
and not being a shared process of a user this function
will fail.
+
+ 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
+ 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.
@@ -126,12 +181,14 @@
Notes
The sd_pid_get_session(),
- sd_pid_get_service(), 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_unit(),
+ sd_pid_get_user_unit(),
+ sd_pid_get_owner_uid(),
+ sd_pid_get_machine_name() and
+ sd_pid_get_slice() 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
@@ -146,9 +203,10 @@
systemd1,
- sd-login7,
+ sd-login3,
sd_session_is_active3,
- getsid2
+ getsid2,
+ systemd.slice5