x2goresume-session(8)

💖 x2goresume-session — the manual, but make it make sense ✨

okay bestie, this is the page for x2goresume-session, part of the X2Go Server Tool lineup (that's the manual section 8, for the sysadmin girlies 🫶). It's the command that goes "wake up babe, we're resuming" to a suspended session. Let's get into it 💅

---

🌸 NAME 🌸

x2goresume-session — Resume X2Go Session 🦋

---

✨ SYNOPSIS ✨

x2goresume-session  <session_id>  \
                    <geometry>  \
                    <link_quality>  \
                    <nx_pack_meth>  \
                    <kblayout>  \
                    <kbtype>  \
                    <setkbd>  \
                    <clipboardmode>

eight little arguments, all lined up, all required, no skips 🎀

---

💜 DESCRIPTION 💜

so like, x2goresume-session resumes the suspended session with session ID <session_id>. that's it, that's the whole job, and it does it flawlessly ✨

this command is normally issued by an X2Go client application, and it runs with X2Go user privileges. so it's not really a "you type this for fun" situation — it's the client doing the heavy lifting behind the scenes, iykyk 👑

---

🎀 ARGUMENTS 🎀

• <session_id> — the session ID (or session name, either works, we're flexible) of the suspended session that's about to get resumed. the main character, fr fr 👑
• <geometry> — the session window size on screen. allowed values: <width>x<height> or fullscreen. go big or go exact 💅
• <link_quality> — any value out of: modem, isdn, adsl, wan or lan. pick your vibe of connection 🦋
• <nx_pack_method> — NX compression method (peep below for the possible values) 📦
• <cache_type+dpi> — cache type and color depth for the X2Go session window. the most common value is: unix-kde-depth_24 where 24 is the color depth in bit. yes, the quote marks around 24 in the original were weird little double commas, we move on, the number is 24 🌈
• <kblayout> — keyboard layout (e.g. us, de, etc.) ⌨️
• <kbtype> — keyboard type/model (e.g. pc105/us)
• <setkbd> — force setting keyboard layout and type within the X2Go session on startup. values: 0 or 1. lowkey a yes/no in disguise
• <clipboardmode> — the session's clipboard mode. possible values: both, server, client, none. this lets you configure clipboard security per session via the connecting X2Go client. and listen 👀 if the clipboard parameter is set server-side in /etc/x2go/x2goagent.options, then that value will override client-side settings. server said what server said, periodt 💅

---

🔥 RETURN VALUES 🔥

x2goresume-session reports to stderr if resuming of session <session_id> failed. and bestie, that very probably means the session's X agent has died 💀 which means session <session_id> will be marked as finished in the X2Go session database. rip to that session, no cap 😭

if everything works out well, a list of session attributes is returned after successful session resumption. the session attributes get presented on a line-by-line basis, one per line, like a little receipt 🧾:

field 01: <graphics_port>
field 02: <sound_port>
field 03: <sshfs_port>
field 04: <tekictrl_port> (if Telekinesis is available/enabled)
field 04: <tekidata_port> (if Telekinesis is available/enabled)

(yes, both Telekinesis fields are numbered 04 in the original. iconic numbering behavior, we don't question it 🙈)

as for the exitcode: x2goresume-session always returns 0. always. even when it's crying to stderr. it's giving unbothered queen 👑

---

🌈 SEE ALSO 🌈

• x2gostartagent(8)
• x2goruncommand(8)
• x2gosuspend-session(8)
• x2goterminate-session(8)

the whole friend group 🫶 go read them too

---

⭐ AUTHOR ⭐

this manual has been written by Mike Gabriel <mike.gabriel@das-netzwerkteam.de> for the X2Go project (https://www.x2go.org). absolute legend, wrote the docs AND the project, main character energy fr fr 👑

---

reminder bestie: copy the arguments exactly, character for character. these are not vibes-based parameters. the vibes are mine, the flags are theirs 💖

---

okay that's the whole page!! this was Version 4.1.0.6, dated Aug 2023 🌸 thanks for reading, go resume something, slay, bye!! 💅✨🦋