Kalgoorlie Retro Docs

Documentation for the Kalgoorlie Retro BBS, its games and servers

User Tools

Site Tools


saltbush:sessions

This is an old revision of the document!


Sessions, SSH and options

Saved sessions

Sessions live in folders in the Session Manager. Double-click to connect. Right-click for Connect, Properties…, Apply BBS Settings…, Duplicate and Delete…; right-click a folder to make a new session in it, select everything in it or apply the BBS settings to all of it. Ctrl+click selects several sessions; Properties… then changes only the settings you edit, in all of them.

File → New Session… opens a three-step wizard (protocol, connection details, name and folder). Turn the wizard off in Global Options to go straight to Session Options. File → Save Session As… saves the connection in the current tab.

Session Options

Every setting for a session is in Session Options, grouped in pages:

  • Connection: name, protocol, host, port, user name, folder and description.
  • SSH2: engine, key file and key generator, certificate, authentication order, jump host, proxy command, algorithms, agent forwarding, compression and extra OpenSSH options.
  • Forwarding: local (L), remote (R) and SOCKS (D) port forwards, forwarding-only sessions and X11.
  • Local Shell, Serial, Telnet and RLogin settings.
  • Logon: pre-connect command, remote command, expect/send pairs, an initial Enter and a logon script.
  • Terminal: terminal type, size, scrollback, resize behaviour, ANSI-BBS, iCE colours, line wrap.
  • Appearance: colours (each picker opens in its own window with a Close button), VGA font, font family and size, cursor, character set and tab title.
  • Input, Behaviour, Highlighting, Key Mappings, Logging, Buttons and File Transfer.

SSH

The built-in engine (libssh) is the default. It checks the server's host key against ~/.ssh/known_hosts and asks in the terminal before trusting a new one; a changed key is refused with a warning. It tries your SSH agent, the key file you chose (asking for its passphrase) and ~/.ssh keys, then keyboard-interactive and password logins, in the order set under Authentication order. It reads ~/.ssh/config unless you tick Ignore ~/.ssh/config.

Sessions that need X11 or agent forwarding, a jump host, an OpenSSH certificate, compression or extra -o options use the OpenSSH client automatically, and you can choose the OpenSSH client for any session under SSH2 → SSH engine. Passwords are never saved.

Logs

File → Log Session… starts and stops a log. Session Options → Logging can start one on connect, with a file-name template (%S session, %H host, %Y-%M-%D date and more), raw or plain-text logs, timestamps, a line prefix, a new file at midnight and connect/disconnect messages. Logs are readable only by you.

Button bars and key mappings

Tools → Button Bars… makes rows of buttons that send text or run an action; choose a bar per session (Buttons page) or for every session (Global Options). Key Mappings lines look like F5<TAB>sendline<TAB>ls -la.

saltbush/sessions.1794235238.txt.gz · Last modified: by slaterm