sd_get_seats

systemd
Developer Lennart Poettering lennart@poettering.net
sd_get_seats 3
sd_get_seats sd_get_sessions sd_get_uids Determine available seats, sessions and logged in users

    #include <systemd/sd-login.h>

int `sd_get_seats` char*** seats int `sd_get_sessions` char*** sessions int `sd_get_uids` char*** sessions

## Description

`sd_get_seats()` may be used to determine all currently available local seats. Returns a NULL terminated array of seat identifiers. The returned array and all strings it references need to be freed with the libc free 3 call after use. Note that instead of an empty array NULL may be returned and should be considered equivalent to an empty array.

Similar, `sd_get_sessions()` may be used to determine all current login sessions.

Similar, `sd_get_uids()` may be used to determine all Unix users who currently have login sessions.

Note that the returned lists are not sorted and in an undefined order.

## Return Value

On success `sd_get_seats()`, `sd_get_sessions()` and `sd_get_uids()` return the number of entries in the arrays. On failure, these calls return a negative errno-style error code.

## Notes

The `sd_get_seats()`, `sd_get_sessions()` and `sd_get_uids()` interfaces are available as shared library, which can be compiled and linked to with the `libsystemd-login` pkg-config 1 file.

## See Also

systemd 1, sd-login 3, sd_session_get_seat 3