ck-list-sessions(1)

💖 ck-list-sessions — the manual page, but make it cute 💖

okay bestie, welcome to ck-list-sessions(1), a lil user command that spills the tea on your ConsoleKit sessions. sit down, grab a strawberry 🍓, and let's get into it.

---

✨ NAME ✨

ck-list-sessions — show ConsoleKit session information. that's it, that's the vibe. 💅

---

🌸 SYNOPSIS 🌸

ck-list-sessions [--all] [--format=format] [--help] [--version]

---

🦋 DESCRIPTION 🦋

so ck-list-sessions is this utility that displays info straight out of the ConsoleKit database. like, it's reading the receipts. 📋

by default it only shows you the open sessions — the ones currently living their truth. but if you pass the --all option, it'll show you all the existing sessions on the system, even the ones that already left the group chat. 💀

ck-list-sessions returns information about each ConsoleKit session, and you can choose exactly which properties get displayed using the --format option. main character energy: you decide what's on the feed.

the following properties can be displayed for each session:

---

🎀 OPTIONS 🎀

the following options are supported:

• -a, --all — show all ConsoleKit sessions. if you don't pass this, only open sessions get shown. no crumbs for the closed ones, sorry.
• -f, --format=format — display information using the specified format. the format value is just a list of properties to display, separated by commas. comma-separated, bestie, don't forget. 🫶
• -h, --help — display a detailed usage message. the classic "explain it to me like i'm five" flag.
• -V, --version — display the version of the ck-list-sessions application. slay, what version are we on.

---

🌈 EXTENDED DESCRIPTION 🌈

💜 ConsoleKit session properties 💜

for each session, the following session properties are displayed:

• unix-user — the user id value associated with the session.
• realname — the name of the user associated with the session.
• seat — the ID for the ConsoleKit Seat associated with the session.
• session-type — the ConsoleKit session type. this value is set by the process that opens the session, and will usually be set to the display protocol used, i.e. x11, wayland, tty, mir, or unspecified. pick your fighter. 🔥
• session-class — the ConsoleKit session class. this value is set by the process that opens the session, and will usually be set to user for normal sessions, or greeter, lock-screen, or background for special purpose sessions.
• session-state — the current state of the ConsoleKit session. it is managed by ConsoleKit and will either return online, active, or closing. it's giving mood ring, honestly.
• display-type — the ConsoleKit display type. this value is specified by the "DisplayTemplate" key in the ConsoleKit session configuration file associated with this session.
• open — the value is "TRUE" if the session is open, and "FALSE" otherwise.
• active — the value is "TRUE" if the session is active on the seat to which it is attached, and "FALSE" otherwise.
• x11-display — the value of the X11 DISPLAY environment variable for this session, if one is present.
• x11-display-device — the value of the display device that the X11 display for the session is connected to. if there is no x11-display set, then this value is undefined. 🙈
• display-device — the display device associated with the session.
• remote-host — if the session is not local, the value is the host name associated with the session. if the session is local, the value is empty. (empty. not a typo. it's just quiet.) 🤫
• VTNr — the virtual terminal the ConsoleKit session is on, if any.
• is-local — the value is "TRUE" if the session is local, and "FALSE" if remote.
• on-since — an ISO 8601 date-time string that corresponds to the time the session started. birthday!! 🎂
• login-session-id — the value of the login session ID that the underlying system uses to enforce session boundaries. if there is no login session ID set, then this value is an empty string.
• idle-since-hint — an ISO 8601 date-time string that corresponds to the time of the last change of the idle-hint. this is a hint used to indicate that the session may be idle. for sessions with a x11-display set (ie. graphical sessions), it is up to each session to delegate the responsibility for updating this value. typically, the screensaver will set this.

however, for non-graphical sessions with a display-device set, the Session object itself will periodically update this value based on the activity detected on the display-device itself.

⚠️ this should not be considered authoritative. it's a hint, not a promise. lowkey unreliable on purpose. 😭

---

👑 EXAMPLES 👑

Example 1: show running sessions.

example% ck-list-sessions

this command would generate output like the following for each session:

SessionSeat1Local:
        unix-user = '50'
        realname = 'GDM Reserved UID'
        seat = 'Seat1'
        session-type = 'LoginWindow'
        display-type = 'Local'
        open = 'TRUE'
        active = 'TRUE'
        x11-display = ':0'
        x11-display-device = '/dev/console'
        display-device = '/dev/console'
        remote-host-name = ''
        is-local = 'TRUE'
        on-since = '2009-08-11T06:46:42.941134Z'
        login-session-id = ''
        idle-since-hint = ''

look at all those properties popping off. ✨

Example 2: show only the session-id, unix-user, and display-type properties.

example% ck-list-sessions --format="session-id,unix-user,display-type"

this command would generate output like the following for each session:

SessionSeat1Local       50      Local

minimalist. clean. iconic. we love a filter. 💅

---

🌟 SEE ALSO 🌟

ck-history(1), ck-launch-session(1), console-kit-daemon(1m)

go read those too, they're the extended universe. iykyk. 📚

---

💌 NOTES 💌

written by Brian Cameron, Sun Microsystems Inc., 2009. copyright (c) 2009 by Sun Microsystems, Inc.

---

and that's the whole page, bestie! 🫶 this one's from SunOS 5.11, dated 22 Oct 2009, and yeah the copyright credits are literally just up there in the notes section, i didn't hide them. go check your sessions, you got this. 🧚✨💖