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=933138da16e90f796870ade5a81d429299ee482b;hp=ecd22f7bfefe742a5a9f1315e23f4caf1a36e57d;hb=03ee5c38cb0da193dd08733fb4c0c2809cee6a99;hpb=60211b35070a20ed0e78a83f39619139d56f7745
diff --git a/man/sd_pid_get_session.xml b/man/sd_pid_get_session.xml
index ecd22f7bf..933138da1 100644
--- a/man/sd_pid_get_session.xml
+++ b/man/sd_pid_get_session.xml
@@ -49,9 +49,15 @@
sd_pid_get_owner_uid
sd_pid_get_machine_name
sd_pid_get_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
Determine session, service, owner of a
session, container/VM or slice of a specific
- PID
+ PID or socket peer
@@ -61,37 +67,73 @@
int sd_pid_get_session
pid_t pid
- char** session
+ char **session
int sd_pid_get_unit
pid_t pid
- char** unit
+ char **unit
int sd_pid_get_user_unit
pid_t pid
- char** unit
+ char **unit
int sd_pid_get_owner_uid
pid_t pid
- uid_t* uid
+ uid_t *uid
int sd_pid_get_machine_name
pid_t pid
- char** name
+ char **name
int sd_pid_get_slice
pid_t pid
- char** slice
+ char **slice
+
+
+
+ int sd_peer_get_session
+ int fd
+ 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
+ uid_t *uid
+
+
+
+ int sd_peer_get_machine_name
+ int fd
+ char **name
+
+
+
+ int sd_peer_get_slice
+ int fd
+ char **slice
@@ -165,14 +207,24 @@
call after use.
If the pid parameter of any
- of these functions is passed as 0 the operation is
+ of these functions is passed as 0, the operation is
executed for the 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() and
+ sd_peer_get_slice() calls operate
+ similar to their PID counterparts, but operate on a
+ connected AF_UNIX socket and retrieve information
+ about the connected peer 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.
@@ -184,11 +236,17 @@
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
+ sd_pid_get_machine_name(),
+ sd_pid_get_slice(),
+ sd_peer_get_session(),
+ sd_peer_get_unit(),
+ sd_peer_get_user_unit(),
+ sd_peer_get_owner_uid(),
+ sd_peer_get_machine_name() and
+ sd_peer_get_slice() interfaces are
+ available as a shared library, which can be compiled
+ and linked to with the
+ libsystemd pkg-config1
file.
Note that the login session identifier as