diff options
| author | David Herrmann <dh.herrmann@gmail.com> | 2014-09-20 18:42:29 +0200 |
|---|---|---|
| committer | David Herrmann <dh.herrmann@gmail.com> | 2014-09-22 14:27:02 +0200 |
| commit | c72d5456e2d6a6c8cefbfc16a542ae03a769397f (patch) | |
| tree | 2fdd3fd00a04984c20df04bd9c573b659a84fa65 /man/sd_session_is_active.xml | |
| parent | 7f3d3ba1a61f28a951ca5fbe59ed15c7ce55219c (diff) | |
login: add public sd_session_get_desktop() API
The desktop brand is stored as DESKTOP variable for sessions. It can be
set arbitrarily by the session owner and identifies the desktop
environment that is running on that session.
Diffstat (limited to 'man/sd_session_is_active.xml')
| -rw-r--r-- | man/sd_session_is_active.xml | 23 |
1 files changed, 23 insertions, 0 deletions
diff --git a/man/sd_session_is_active.xml b/man/sd_session_is_active.xml index 5006be4df5..e9840669c2 100644 --- a/man/sd_session_is_active.xml +++ b/man/sd_session_is_active.xml @@ -51,6 +51,7 @@ <refname>sd_session_get_service</refname> <refname>sd_session_get_type</refname> <refname>sd_session_get_class</refname> + <refname>sd_session_get_desktop</refname> <refname>sd_session_get_display</refname> <refname>sd_session_get_tty</refname> <refname>sd_session_get_vt</refname> @@ -110,6 +111,12 @@ </funcprototype> <funcprototype> + <funcdef>int <function>sd_session_get_desktop</function></funcdef> + <paramdef>const char *<parameter>session</parameter></paramdef> + <paramdef>char **<parameter>desktop</parameter></paramdef> + </funcprototype> + + <funcprototype> <funcdef>int <function>sd_session_get_display</function></funcdef> <paramdef>const char *<parameter>session</parameter></paramdef> <paramdef>char **<parameter>display</parameter></paramdef> @@ -218,6 +225,22 @@ <citerefentry project='man-pages'><refentrytitle>free</refentrytitle><manvolnum>3</manvolnum></citerefentry> call after use.</para> + <para><function>sd_session_get_desktop()</function> may + be used to determine the brand of the desktop running on + the session identified by the specified session identifier. + This field can be set freely by desktop environments and + does not follow any special formatting. However, desktops + are strongly recommended to use the same identifiers and + capitalization as for + <varname>$XDG_CURRENT_DESKTOP</varname>, as defined by + the <ulink + url="http://standards.freedesktop.org/desktop-entry-spec/latest/">Desktop + Entry + Specification</ulink>. The returned string needs to be + freed with the libc + <citerefentry project='man-pages'><refentrytitle>free</refentrytitle><manvolnum>3</manvolnum></citerefentry> + call after use.</para> + <para><function>sd_session_get_display()</function> may be used to determine the X11 display of the session identified by the specified session |