solterm(1)

✨ NAME ✨

solterm — bestie, it's an IPMI Serial over LAN program 💖 like literally, that's the whole vibe

🎀 SYNOPSIS 🎀

solterm

<connection parms> [-e escape_char] [-notencrypted] [-notauthenticated]
[-bitrate (9600|19200|38400|57600|115200)] [-alerts
(succeed|defer|fail)] [-holdoff] [-ack-retries n] [-ack-timeout
microseconds] [-v] [-q]

ok so heads up: the synopsis also waves at -ack-retries n and -ack-timeout microseconds, but the page itself never spills the tea on what they do, so I'm not gonna invent anything, no cap 🫶

🦋 DESCRIPTION 🦋

The solterm program lets you make a remote serial connection over IPMI. The catch? It requires that the remote system support IPMI 2.0 Serial Over LAN. So like, if your BMC isn't giving, this isn't gonna slay 😭

💅 OPTIONS 💅

• <connection parms> — the params for the connection depend on the connection type, and honestly they're all described over in openipmi_conparms(7). go read that one, iykyk 📖
• -e escape_char — the character you use to escape or exit the program. Type this character right after a newline and boom, you're in command mode. Then a single character after it performs a command. The default escape character is "~", as shown below. Supported commands are:
  • ~. — terminate the program 💀 bye bestie
  • ~B — send a serial BREAK over the connection
  • ~F — flush all buffers
  • ~R — assert the Ring Indicator (RI) line
  • ~r — deassert the Ring Indicator (RI) line
  • ~D — assert DCD and DSR lines
  • ~d — deassert DCD and DSR lines
  • ~C — pause the output using CTS
  • ~c — put CTS under BMC control
  • ~? — help on escape commands 🙋
  • ~~ — enter the escape character twice to send it. (yes, it's giving escape-the-escape, iconic)
• -notencrypted — do not encrypt the SOL data going over the connection. 🔓
• -notauthenticated — do not do integrity checks on the SOL data going over the connection. 🫣
• -bitrate — set the bitrate to the given value. The values are 9600, 19200, 38400, 57600, 115200. The default is whatever the BMC has set it to, so like, ask the BMC, it's the main character here 👑
• -alerts — this specifies what to do if an alert that requires a callout occurs on the line:
  • succeed — specifies that serial/modem alerts are to succeed while SoL is active.
  • deferred — specifies that serial/modem alerts are to be deferred for the duration of the SoL session.
  • fail — specifies that serial/modem alerts automatically fail during the SoL session. This is the default.
• -holdoff — specifies that CTS, DTR, and DSR are to be deasserted at the start of the SoL session so that the configuration may be modified before the handshake is released. lowkey a ✨ responsible ✨ move
• -v — be more verbose. May be specified multiple times for more output. 📢
• -q — be less verbose. May be specified multiple times for less output. 🤫

🌈 SEE ALSO 🌈

openipmi_conparms(7)

🙈 KNOWN PROBLEMS 🙈

None. not a single one, we're flawless, periodt ✨

👑 AUTHOR 👑

Darius Davis <dariusd@users.sourceforge.net>

and that's the whole page bestie — brought to you by OpenIPMI, dated 05/13/03. stay encrypted, stay hydrated, and always escape twice to send the tilde 💜🦋