- boolean parameter controls whether the returned list
- shall consist of only those sessions where the user is
- currently active (true) or where the user is currently
- logged in at all, possibly inactive (false). The call
- returns a NULL terminated string array of session
- identifiers in <parameter>sessions</parameter> which
- needs to be freed by the caller with the libc
- <citerefentry><refentrytitle>free</refentrytitle><manvolnum>3</manvolnum></citerefentry>
- call after use, including all the strings referenced. If
- the string array parameter is passed as NULL the array
- will not be filled in, but the return code still
- indicates the number of current sessions.</para>
-
- <para>Similar, <function>sd_uid_get_seats()</function>
+ parameter controls whether the returned list shall
+ consist of only those sessions where the user is
+ currently active (> 0), where the user is currently
+ online but possibly inactive (= 0), or
+ logged in at all but possibly closing the session (< 0). The call returns a
+ <constant>NULL</constant> terminated string array of session identifiers in
+ <parameter>sessions</parameter> which needs to be
+ freed by the caller with the libc
+ <citerefentry project='man-pages'><refentrytitle>free</refentrytitle><manvolnum>3</manvolnum></citerefentry>
+ call after use, including all the strings
+ referenced. If the string array parameter is passed as
+ <constant>NULL</constant>, the array will not be filled in, but the return
+ code still indicates the number of current
+ sessions. Note that instead of an empty array <constant>NULL</constant> may
+ be returned and should be considered equivalent to an
+ empty array.</para>
+
+ <para>Similarly, <function>sd_uid_get_seats()</function>