diff options
| author | Lennart Poettering <lennart@poettering.net> | 2013-04-15 14:16:45 +0200 |
|---|---|---|
| committer | Lennart Poettering <lennart@poettering.net> | 2013-04-15 14:16:45 +0200 |
| commit | 97e13058170c7759dbbc239d264b9a31b0c81079 (patch) | |
| tree | da7a8337cb4193037572b5331844110251b21aa8 /man/sd_pid_get_session.xml | |
| parent | 6c03089c32c251d823173bda4d809a9e643219f0 (diff) | |
sd-login: add a sd_pid_get_user_unit() call
Diffstat (limited to 'man/sd_pid_get_session.xml')
| -rw-r--r-- | man/sd_pid_get_session.xml | 34 |
1 files changed, 26 insertions, 8 deletions
diff --git a/man/sd_pid_get_session.xml b/man/sd_pid_get_session.xml index 511fcf3ede..d2b64195a6 100644 --- a/man/sd_pid_get_session.xml +++ b/man/sd_pid_get_session.xml @@ -45,6 +45,7 @@ <refnamediv> <refname>sd_pid_get_session</refname> <refname>sd_pid_get_unit</refname> + <refname>sd_pid_get_user_unit</refname> <refname>sd_pid_get_owner_uid</refname> <refpurpose>Determine session, service or owner of a session of a specific PID</refpurpose> </refnamediv> @@ -66,6 +67,12 @@ </funcprototype> <funcprototype> + <funcdef>int <function>sd_pid_get_user_unit</function></funcdef> + <paramdef>pid_t <parameter>pid</parameter></paramdef> + <paramdef>char** <parameter>unit</parameter></paramdef> + </funcprototype> + + <funcprototype> <funcdef>int <function>sd_pid_get_owner_uid</function></funcdef> <paramdef>pid_t <parameter>pid</parameter></paramdef> <paramdef>uid_t* <parameter>uid</parameter></paramdef> @@ -91,18 +98,28 @@ call after use.</para> <para><function>sd_pid_get_unit()</function> 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 <function>sd_pid_get_user_unit()</function> for + that.) The returned string needs to be freed with the + libc <citerefentry><refentrytitle>free</refentrytitle><manvolnum>3</manvolnum></citerefentry> call after use.</para> + <para><function>sd_pid_get_user_unit()</function> 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 + <function>sd_pid_get_unit()</function> but applies to + user units instead of system units.</para> + <para><function>sd_pid_get_owner_uid()</function> may be used to determine the Unix user identifier of the owner of the session of a process identified the @@ -131,7 +148,8 @@ <title>Notes</title> <para>The <function>sd_pid_get_session()</function>, - <function>sd_pid_get_pid()</function>, and + <function>sd_pid_get_unit()</function>, + <function>sd_pid_get_user_unit()</function>, and <function>sd_pid_get_owner_uid()</function> interfaces are available as shared library, which can be compiled and linked to with the |