X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?a=blobdiff_plain;f=man%2Fsd_pid_get_session.xml;h=9a1b1997d96ac3da5a82f6d1f0d9f35ffd1ac16e;hb=56a379a97e91380630653b85e5cb3612bf22ecf4;hp=24e468015f42769324aade5e427ae1c2634e3462;hpb=dc1ecd78e9f046880d10ddb45cf9b06df1084b10;p=elogind.git
diff --git a/man/sd_pid_get_session.xml b/man/sd_pid_get_session.xml
index 24e468015..9a1b1997d 100644
--- a/man/sd_pid_get_session.xml
+++ b/man/sd_pid_get_session.xml
@@ -8,16 +8,16 @@
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 .
-->
@@ -44,8 +44,9 @@
sd_pid_get_session
+ sd_pid_get_unit
sd_pid_get_owner_uid
- Determine session or owner of a session of a specific PID
+ Determine session, service or owner of a session of a specific PID
@@ -58,6 +59,12 @@
char** session
+
+ int sd_pid_get_unit
+ pid_t pid
+ char** unit
+
+
int sd_pid_get_owner_uid
pid_t pid
@@ -75,11 +82,24 @@
identifier. The session identifier is a short string,
suitable for usage in file system paths. Note that not
all processes are part of a login session (e.g. system
- service processes and user processes that are shared
- between multiple sessions of the same user). For
- processes not being part of a login session this
- function will fail. The returned string needs to be
- freed with the libc
+ service processes, user processes that are shared
+ between multiple sessions of the same user, or kernel
+ threads). For processes not being part of a login
+ session this function will fail. The returned string
+ needs to be freed with the libc
+ free3
+ call after use.
+
+ sd_pid_get_unit() may be
+ used to determine the systemd unit (i.e. system
+ service) identifier of a process identified by the
+ specified process identifier. The unit name is a short
+ string, suitable for usage in file system paths. Note
+ that not all processes are part of a unit/service
+ (e.g. user processes, or kernel threads). For
+ processes not being part of a systemd unit/system
+ service this function will fail. The returned string
+ needs to be freed with the libc
free3
call after use.
@@ -93,6 +113,10 @@
fail. For processes not being part of a login session
and not being a shared process of a user this function
will fail.
+
+ If the pid paramater of any
+ of these functions is passed as 0 the operation is
+ executed for the calling process.
@@ -106,10 +130,11 @@
Notes
- The sd_pid_get_session()
- and sd_pid_get_owner_uid()
- interfaces are available as shared library, which can
- be compiled and linked to with the
+ The sd_pid_get_session(),
+ sd_pid_get_pid(), 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
file.