X-Git-Url: https://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?a=blobdiff_plain;f=man%2Fsd_pid_get_session.xml;h=bd958046281af9a1952fb600ef8d816f7aced44e;hb=f5e04665ebf7124f3ea17dcf258793ed73a95fe1;hp=9176433c3dee737edb1ed3924eeccda81fb719b6;hpb=0b3b020a178cf3b957fed627de13c895773995ec;p=elogind.git
diff --git a/man/sd_pid_get_session.xml b/man/sd_pid_get_session.xml
index 9176433c3..bd9580462 100644
--- a/man/sd_pid_get_session.xml
+++ b/man/sd_pid_get_session.xml
@@ -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
@@ -71,16 +78,28 @@
sd_pid_get_session() may be
used to determine the login session identifier of a
- process identified by the specified process identifier. The session
- identifier is a short string (up to 64 characters),
- consisting only of the characters a-zA-Z0-9 as well as
- '-' and '_'. It is 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
+ process identified by the specified process
+ 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, 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.
@@ -107,10 +126,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.