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=d2b64195a6eb666f42d7527ae406547dca4ad58c;hp=7897a2cd3ea761540b9bc7d89b138cee2f2d23f3;hb=97e13058170c7759dbbc239d264b9a31b0c81079;hpb=cb07866b1b7c11e687a322d70dd9f9d73bbbe488
diff --git a/man/sd_pid_get_session.xml b/man/sd_pid_get_session.xml
index 7897a2cd3..d2b64195a 100644
--- a/man/sd_pid_get_session.xml
+++ b/man/sd_pid_get_session.xml
@@ -21,7 +21,7 @@
along with systemd; If not, see .
-->
-
+
sd_pid_get_session
@@ -45,6 +45,7 @@
sd_pid_get_session
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
@@ -65,6 +66,12 @@
char** unit
+
+ int sd_pid_get_user_unit
+ pid_t pid
+ char** unit
+
+
int sd_pid_get_owner_uid
pid_t pid
@@ -91,18 +98,28 @@
call after use.
sd_pid_get_unit() may be
- used to determine the systemd unit (i.e. system
+ used to determine the systemd system 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
+ 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 unit/system
- service this function will fail. The returned string
- needs to be freed with the libc
+ 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
@@ -114,7 +131,7 @@
and not being a shared process of a user this function
will fail.
- If the pid paramater of any
+ If the pid parameter of any
of these functions is passed as 0 the operation is
executed for the calling process.
@@ -131,7 +148,8 @@
Notes
The sd_pid_get_session(),
- sd_pid_get_pid(), and
+ 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