X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=elogind.git;a=blobdiff_plain;f=man%2Fsd_uid_get_state.xml;h=b7bc944b1489788a99acada8edbb8abff7519439;hp=f302b34c60ecbec7210a75100cee01054fb5fe45;hb=8db6dcfd3c3d19d35767f04884a99368f6c64b36;hpb=7ea9cb91207f49965bc23bfdac9d5475940bea51 diff --git a/man/sd_uid_get_state.xml b/man/sd_uid_get_state.xml index f302b34c6..b7bc944b1 100644 --- a/man/sd_uid_get_state.xml +++ b/man/sd_uid_get_state.xml @@ -111,7 +111,7 @@ or active on a specific seat. Accepts a Unix user identifier and a seat identifier string as parameters. The require_active - parameter is a boolean. If non-zero (true) this + parameter is a boolean value. If non-zero (true) this function will test if the user is active (i.e. has a session that is in the foreground and accepting user input) on the specified seat, otherwise (false) only @@ -120,15 +120,16 @@ sd_uid_get_sessions() may be used to determine the current sessions of the - specified user. Acceptes a Unix user identifier as + specified user. Accepts a Unix user identifier as parameter. The require_active - 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 sessions which - needs to be freed by the caller with the libc + 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 + NULL terminated string array of session identifiers in + sessions which needs to be + freed by the caller with the libc free3 call after use, including all the strings referenced. If the string array parameter is passed as @@ -181,7 +182,7 @@ systemd1, - sd-login7, + sd-login3, sd_pid_get_owner_uid3