LSHG(1)

💅 LSHG — the secsh (SSH2) client, but make it a group chat

okay so bestie, welcome to lshg(1) from the Lsh Manuals — she's a secsh (SSH2) client and she's here to connect you to a remote machine through a gateway you already set up. let's get into it 💖

---

✨ NAME ✨

lshg — secsh (SSH2) client. that's it, that's the girl. 👑

---

🌸 SYNOPSIS 🌸

lshg [OPTION...] HOST [COMMAND]

---

🦋 DESCRIPTION 🦋

⚠️ CAUTION! The information in this manpage may be invalid or outdated. For authorative information on lsh, please see it's Texinfo manual (see the SEE ALSO section).

so basically — lshg connects to the remote machine HOST through a previously established lsh gateway, and then performs one or more actions, like command execution or various forwarding services. the default action is to start a remote interactive shell, or execute a given command on the remote machine. iconic behavior honestly ✨

---

🎀 OPTIONS 🎀

• --debug — print huge amounts of debug information. like, huge. not me turning the whole terminal into a novel 😭
• --log-file=File name — append messages to this file. journaling era 🍓
• -q, --quiet — suppress all warnings and diagnostic messages. silence is golden, periodt 💅
• --trace — detailed trace. even more detail than you're ready for 🔍
• -v, --verbose — verbose diagnostic messages. she talks. a lot. 🗣️
• --askpass=Program — program to use for reading passwords. should be an absolute filename. (absolute. like, /full/path/energy. no shortcuts bestie) 💜
• -l, --user=User name — login as this user. main character rebrand 🎭
• -p, --port=Port — connect to this port. knock knock 🚪

---

🔥 Actions 🔥

• -B, --background — put process into the background. implies -N. she's gonna go do her own thing, don't wait up 🦋
• -D, --forward-socks[=port] — enable socks dynamic forwarding. socks! 🧦
• -E, --execute=command — execute a command on the remote machine. go girl, do the thing ✨
• -L, --forward-local-port=local-port:target-host:target-port — (no description given, it's giving mystery 🫶)
• -N, --nop — no operation (suppresses the default action, which is to spawn a remote shell). the "i'm just here for the vibes" flag 💅
• --subsystem=subsystem-name — connect to given subsystem. implies --no-pty. 🌈
• -S, --shell=command — spawn a remote shell. her natural habitat 🐚

---

💀 Universal not 💀

• -n, --no — inverts the effect of the next modifier. uno reverse card, no cap 🔄

---

🧚 Modifiers that apply to port forwarding 🧚

• -g, --remote-peers — allow remote access to forwarded ports. come on in, the door's open 🚪✨
• --no-remote-peers — disallow remote access to forwarded ports (default). door's locked, sorry bestie 🔒

---

⭐ Modifiers that apply to remote execution ⭐

• --detach — detach from terminal at session end. goodbye, i'm a ghost 👻
• --no-detach — do not detach session at end, wait for all open channels (default). she's clingy in the best way 🫶
• --no-pty — don't request a remote pty. no fake terminal for you 🙅‍♀️
• --no-stderr — redirect stderr to /dev/null. bye bye error messages 💀
• --no-stdin — redirect stdin from /dev/null. nothing's coming in 🚫
• --no-stdout — redirect stdout to /dev/null. nothing's coming out either 😭
• --stderr=Filename — redirect stderr. send the drama somewhere specific 🎀
• --stdin=Filename — redirect stdin. 🍓
• --stdout=Filename — redirect stdout. ✨
• -t, --pty — request a remote pty (default). fake terminal, activated 💅

---

💜 Miscellaneous options 💜

• -e, --escape-char=Character — escape char. `none' means disable. default is to use `~' if we have a tty, otherwise none. the little ~ that saves your whole life iykyk 🌸
• --write-pid — make -B write the pid of the backgrounded process to stdout. receipts, bestie 🧾
• -G — if no usable gateway is found, launch lsh instead. the backup plan, the safety net, the girl who's got you 💖
• --send-debug=Message — send a debug message to the remote machine. 📨
• --send-ignore=Message — send an ignore message to the remote machine. 🙈
• -?, --help — give this help list. help me help you 🫶
• --usage — give a short usage message. the tldr 🎀
• -V, --version — print program version. she's v-ing herself 💅

📌 Mandatory or optional arguments to long options are also mandatory or optional for any corresponding short options. (yes, the long and short versions stay in sync, they're matching, it's a coordinated outfit 💖)

---

🌈 DIAGNOSTICS 🌈

see the --verbose, --trace and --debug options. that's where all the tea is ☕

---

🦋 EXAMPLES 🦋

using the -G option, for example in LSHGFLAGS, it's easy to use an existing gateway if there is any and connect using lsh if not. so: gateway if she's available, lsh if she's not. flexible queen 💅

---

😭 REPORTING BUGS 😭

report bugs to <bug-lsh@gnu.org>. tell them everything, they want to know 🫶

---

🍓 ENVIRONMENT 🍓

LSHG_FLAGS may be used for passing additional parameters. the parsing order is undefined. (undefined!! so don't count on an order, bestie, it's chaos energy 💀)

---

👑 COPYING 👑

the lsh suite of programs is distributed under the GNU General Public License; see the COPYING and AUTHORS files in the source distribution for details. legal slay ⚖️✨

---

💖 AUTHOR 💖

the lsh program suite is written mainly by Niels Möller <nisse@lysator.liu.se>.

this man-page was written for lsh 2.0 by Pontus Freyhult <pont_lsh@soua.net>, it is based on a template written by J.H.M. Dassen (Ray) <jdassen@wi.LeidenUniv.nl>. legends, all of them 🫡

---

🌸 SEE ALSO 🌸

lsftp(1), lsh(1), lsh-authorize(1), lsh-export-key(1), lsh-keygen(1), lsh-make-seed(1), lsh-upgrade(1), lsh-upgrade-key(1), lsh-writekey(1), lshd(8), ssh-conv(1) — the whole friend group 💖

the full documentation for lsh is maintained as a Texinfo manual. if the info and lsh programs are properly installed at your site, the command

info lsh

should give you access to the complete manual. go read it, it's giving lore 📖✨

---

aaaand that's the whole page bestie!! 🎀 this one came from the Lsh manual set, dated November 2004 — vintage, iconic, still slaying 💅🦋💖