-
sshm 1.13.0
Stablereleased this
2026-11-07 00:13:19 +01:00 | 90 commits to main since this releaseBehoben
-
--run -s: Das sudo-Passwort landete im stdin des Kommandos, wenn der
NOPASSWD-Vorabcheck aus anderen Gründen scheiterte (z. B. Eintrag mit
Passwort-Login, an demBatchModescheitert). Das Kommando startet jetzt
remote immer mit stdin auf/dev/null; eine Passwortzeile, die sudo nicht
liest, bleibt ungelesen. Der Vorabcheck läuft über dieselbe
Multiplex-Verbindung wie das Kommando, ohneBatchMode-Sonderweg. -
--run -s: Ein falsches Passwort ging an jeden Host, also ein
Fehlversuch pro Host auf dasselbe (LDAP-)Konto. Es wird jetzt am ersten
Host, der eines verlangt, persudo -k -S truegeprüft; bei Fehlschlag
fragt sshm neu (leer bzw. nach drei Versuchen: Hosts mit Passwort-sudo
überspringen). -
--run -smit leerer Eingabe schickte trotzdem eine leere Zeile an
sudo -S(ein Fehlversuch im journal). Hosts, die ein Passwort brauchen,
werden jetzt ohne sudo-Versuch übersprungen und als übersprungen gemeldet. -
--run -slief untersh -c(dash),[[ … ]]ging dort nicht.
Das Kommando läuft jetzt in bash, falls vorhanden, sonst in sh (siehe
„Geändert" für--runohne-s). -
Ctrl-C in
--runhinterließ für den abgebrochenen Host keine
History-Zeile. Jetztend … exit=130(bzw.fail reason=interrupted
vor dem Kommando), danach endet der Lauf mit 130. Das Remote-Kommando
läuft ohne Terminal weiter, ein sauberer Abbruch ist mit ssh nicht möglich. -
sudo-Fehlschläge in
--run -s(falsches Passwort, kein sudo-Recht,
requiretty) standen alsend exit=1in der History, nicht
unterscheidbar von einem Fehler des Kommandos. Jetztfail reason=sudo sudo=wrongpw|denied|tty|nopw|error. -
--runohne ConnectTimeout: Ein unerreichbarer Host kostete über
zwei Minuten. Ohne eigenen Wert in OPTS bzw.~/.ssh/configgelten jetzt
10 Sekunden. -
Doppelte Namen:
--runnahm kommentarlos den ersten Eintrag und
bricht jetzt mit den Nummern der Kandidaten ab.--lastwählt über das
protokollierte Ziel und rät nicht, wenn auch das nicht eindeutig ist. -
Unbekannte Optionen (
-x,--histroy,--,-f --setup) gingen in
die Namenssuche,sshm -xverband so zudb-x1. Jetzt „Unbekannte
Option" mit Hinweis auf-hund Exit-Code 1 (wie die übrigen
Usage-Fehler). -
Ohne Hosts-Datei öffneten
-l,--check,--run,--lastund
sshm <name>den Editor, ohne Terminal endete--checkdanach mit rc 0,
ohne etwas geprüft zu haben. Der Editor öffnet sich nur noch für das
Menü an einem Terminal, alle anderen Aufrufe legen das Template an und
enden mit rc 1. -
sshm vm22meldete beivm22undvm2222„Mehrere Treffer". Ein
exakter Name gewinnt jetzt vor Teilstring-Treffern, wie schon in--run.
Mehrdeutiges ohne Terminal ist ein Fehler (rc 1) statt eines stillen rc 0. -
sshm -alegte bei einem Zeilenumbruch zwei Einträge an und prüfte
weder Feldzahl noch Port (u@h:notaport), doppelte Namen oder
überzählige Argumente. Alles davon wird jetzt abgelehnt. -
--importzerlegteHost "quoted name"in zwei Einträge und
ignorierteHost=foobzw.HostName=x. Der Parser liest jetzt wie ssh
(Quotes,=), Aliasse mit Leerzeichen überspringt er mit Hinweis, weil
ssh sie als Ziel ablehnt. Ohne Hosts-Datei legt--importdas
vollständige Template an statt nur einer Kopfzeile. -
--setupüberschriebsshm-agent.serviceohne Backup, obwohl die
Blöcke empfehlen, dort die TTL anzupassen. Die Unit trägt jetzt eine
Fassungszeile wie die Blöcke und wird nur bei älterer Fassung neu
geschrieben, mit Backup. Units bis 1.12.0 haben keine Zeile und werden
einmalig erneuert. -
--setup/--uninstallhinterließ pro Zyklus eine Leerzeile mehr,
eine von--setupangelegteconfig.fishblieb leer liegen, und ein
erneuerter Block wanderte ans Dateiende.--uninstallnimmt die
Trennleerzeile mit und löscht Dateien, die nur aus dem Block bestanden;
die Erneuerung (auch--rescan) ersetzt den Block an seiner Stelle. -
--updatesetzte die Rechte hart auf 755 und behielt keine
Vorversion. Jetzt bleiben die Rechte der bisherigen Datei erhalten, die
alte Version liegt als.sshm-bak.<Zeitstempel>ohne x-Bit daneben.
Ohne Schreibrecht endet--updatemit rc 1 statt 0. -
Exit-Codes:
sshm -f hostendete bei einem Fehlversuch mit 1, eine
Session mit 255; jetzt beide mit dem Code von ssh. Menü und Dateibrowser
ohne Terminal meldeten einen fzf-Fehler und endeten mit 0, jetzt eine
klare Meldung und rc 1 (ebenso die Host-Auswahl von--run). -
--report:wocheumfasste 8 Kalendertage,1zwei. Jetzt zählen
N Tage einschließlich heute. Eine Session über Mitternacht zählte ganz
auf den End-Tag und wird jetzt an der Tagesgrenze aufgeteilt; die
Tageszeilen bleiben dabei nach Datum sortiert (auch in--csv).woche monatwird abgelehnt statt still den letzten Wert zu nehmen, Zahlen
mit mehr als 5 Stellen ebenso (vorher Überlauf). -
--history -3bzw.abcfielen still auf 10 zurück, jetzt ein
Usage-Fehler wie bei--report. Leerzeilen in der History zeigt
--historynicht mehr als leere start-Zeile, und--lastmeldet ihretwegen
nicht mehr „Keine Verbindungshistorie". -
Env-Schalter werteten nur genau
1/0aus,SSHM_LEARN=yesoder
SSHM_LOOP=trueschalteten aus. Alle Schalter verstehen jetzt
1/yes/true/onund0/no/false/off. Ein anderer Wert wird bei jedem
Aufruf gleich beim Start gemeldet (auch--report,--history,-V),
nicht erst, wenn der Schalter gebraucht wird. -
$EDITORmit Leerzeichen im Pfad oder nicht vorhanden führte still
zu vi. Jetzt wird$EDITORals Pfad oder als Kommando mit Argumenten
versucht, ein nicht auffindbarer gemeldet, danach nano, dann vi. -
Ohne
HOMEstarb sshm schon bei-V(set -u). Ist HOME nicht
gesetzt, gilt das Home-Verzeichnis aus der passwd. -
Hänger nach Sessionende mit ControlPersist: Baute die Session selbst
einen Multiplex-Master auf (ControlMaster auto+ControlPersistin
OPTS oder~/.ssh/config), behielt der Hintergrund-Master das stderr des
-v-Mitschnitts. sshm hing bis zum Persist-Timeout (beiyes
unbegrenzt), die Dauer in der History stimmte nicht. ssh schreibt seine
Meldungen jetzt per-Ein eine FIFO, die ein Leser bis zu einer
Endmarke liest; Banner, Prompts und Fehlermeldungen bleiben sichtbar.
Gleiches im Dateibrowser mit-vim OPTS-Feld. Die Debug-Ausgabe kommt
dabei aus-o LogLevel=DEBUG1statt-v: ssh reicht-van den
Kind-ssh eines ProxyJump weiter (-J, auch mehrstufig oder aus der
~/.ssh/config),-Eaber nicht — dessen Debug-Zeilen landeten sonst
ungefiltert im Terminal. -
Session über einen bestehenden Master galt als Fehlversuch
(fail reason=unknown exit=0), jetzt als normale Session. -
Key-Suche scheiterte an sshd
PerSourcePenalties(OpenSSH ≥ 9.8,
Default in Debian 13): Eine Verbindung pro Key ließ sshd nach wenigen
Fehlschlägen jede weitere verwerfen, alle Keys erschienen als ✗. Die
Suche bietet jetzt alle Keys in einer Verbindung an und liest den
akzeptierten aus dem Debug-Log; nachMaxAuthTriesgeht es mit den
übrigen in einer weiteren Verbindung weiter. Eine verworfene oder mitten
in der Anmeldung abgebrochene Verbindung wird als solche gemeldet, ein
Versuch dauert höchstens 30 s (vorher hing er bei einer Sperre bis zum
TCP-Timeout). -
Key-Suche wurde unnötig angeboten, auch bei
PubkeyAuthentication=nooderPreferredAuthenticationsohne
publickey. Der Hinweis nennt in dem Fall die abgeschaltete Option. -
Abgelehnte Key-Suche endete mit rc 1, jetzt mit dem Exit-Code des
Fehlversuchs (255). -
Ctrl-C am Passwort-Prompt beendete sshm ohne Meldung und ohne
History-Zeile. Jetztfail reason=interrupted exit=130; im Menü geht es
danach mit dem Menü weiter. -
Dateibrowser ohne Master: Starb der Multiplex-Master, verband jeder
weitere Zugriff still direkt, ohne Port, Key und Jumphost des Eintrags,
und die Liste zeigte nur../. Jetzt meldet der Browser „Verbindung
verloren" und endet (Historyexit=255). Ohne eigenen Keepalive bekommt
der MasterServerAliveInterval=15/CountMax=3, ein Netzausfall ließ
den Ordnerwechsel sonst bis zum TCP-Timeout hängen. ESC beendet den
Browser auch bei hängender Verzeichnisliste. -
Abgebrochener Download (Ctrl-C) hinterließ eine Teildatei, die
Sitzung fehlte in der History. Neu angelegte Teildateien bzw. -ordner
werden entfernt, die Sitzung steht mitexit=130im Log. -
Lernmodus: Ein per
ssh-addmit relativem Pfad geladener Key
(Kommentar z. B. „k_e“) wurde still nicht nachgetragen. Er wird jetzt per
Fingerprint einer Datei in~/.sshzugeordnet, sonst gibt es einen
Hinweis. -
Direkt-Connect auf einen gedroppten Host dauerte über zwei Minuten.
Ohne eigenenConnectTimeout(OPTS bzw.ssh -G) gelten jetzt 10 s,
auch für den Dateibrowser. -
Port-Konflikt: Ziel
host:2299plus-p 2222in OPTS nahm still
2299. sshm warnt jetzt (der Port im Ziel gewinnt weiterhin). -
--runschriebreason=unknownauch bei Hostkey-Fehler,
Auth-Fehler oder unerreichbarem Host; jetzt klassifiziert wie beim
Connect, mit Hinweis. -
SSHM_PROBE=1ohne Terminal wartete auf eine Antwort, die nie kam.
Jetzt Abbruch mit Meldung und rc 1; ebenso fragt die Key-Suche nur an
einem Terminal. -
Farben auch in Pipes und Dateien:
--report,--history,-l,
--check,--runund die Meldungen rund um eine Session schrieben
ANSI-Codes auch dorthin. Farbe gibt es jetzt nur am Terminal (getrennt
geprüft für stdout und stderr) und nie bei gesetztemNO_COLOR. Das
fzf-Menü und seine Preview behalten ihre Farben. -
Spalten mit Umlauten verrutschten in
-l,--check,--history,
--report,--import, „Mehrere Treffer" und der Key-Suche:printf
(bash wie mawk) zählte Bytes. Ausgerichtet wird jetzt nach Zeichen,
auch unterLANG=C. -
SSHM_PROBEund--checkzeigten IPv6 als::1:22, jetzt
[::1]:22. Unter netcat-traditional (Debian-Default, kann kein IPv6)
galt außerdem jedes IPv6-Ziel als nicht erreichbar, auch ein Hostname,
der nur per AAAA auflöst. sshm prüft jetzt immer pertimeout+
/dev/tcp,ncnur noch, wenntimeoutfehlt. -
--checkzählte Einträge mit ungültigem Quoting als „übersprungen
(Jumphost)". Die Summe nennt beide getrennt. -
Key-Erkennung (
--setup,--rescan, Key-Suche): Jede Datei mit
gleichnamiger.pubgalt als Key, auch eine leere —IdentityFile ~/.ssh/random.txt. Maßgeblich ist jetzt allein der
-----BEGIN … PRIVATE KEY------Header. -
--uninstallnannte~/.config/sshm/hostsauch, wenn es die Datei
nicht gab, und ignorierteXDG_CONFIG_HOME. -
Notizen (
SSHM_NOTE) mit"machtennote="…"mehrdeutig."und
\werden jetzt mit\maskiert, Steuerzeichen (auch ESC-Sequenzen)
zu Leerzeichen. Ältere Zeilen bleiben lesbar. -
Completion bot doppelt vergebene Namen mehrfach an.
-
--run -skonnte das sudo-Passwort an ein falsches Ziel schicken:
Starb der Multiplex-Master, baute ssh für Prüfung und Kommando still eine
direkte Verbindung auf — ohne Port, Key und Jumphost des Eintrags. Dazu
teilten sich alle Hosts eines Laufs denselben Socket-Pfad. Jetzt gibt es
einen Socket pro Host, und die Zugriffe über den Master (gemeinsam mit
dem Dateibrowser) laufen mitProxyCommand=false: Ist er weg, scheitert
der Zugriff sofort (fail reason=lost). -
sudo-Passwörter mit Leerzeichen am Anfang oder Ende (
--run -s,
DateibrowserCTRL-R) wurden gekürzt — ein Fehlversuch pro Host. -
Ctrl-C am sudo-Prompt war wirkungslos: bash setzte die Eingabe nach
dem Signal einfach fort, eine danach blind zu Ende getippte Zeile ging
doch an sudo. Ctrl-C bricht den Prompt jetzt ab (--run -smit
fail reason=interrupted, im Dateibrowser bleibt der sudo-Modus aus). -
Dateibrowser, Upload im sudo-Modus: Erlaubt sudo
tarohne Passwort
(NOPASSWD,!authenticate), landete die Passwortzeile im tar-Strom und
der Upload scheiterte; bei ungültigem Passwort hätte sudo den tar-Strom
als weitere Versuche gelesen. Remote liest jetzt die Shell die Zeile,
gibt nur sie ansudo -v, tar läuft danach persudo -n. -
Lernmodus, Key-Suche: Key-Pfade mit
",$(…)oder Backtick landeten
ungequotet im OPTS-Feld, das beim nächsten Connect perevalgelesen
wird — Code-Ausführung bzw. eine kaputte Konfig. Der Pfad wird jetzt
sicher gequotet; Pfade mit|,%,${oder Steuerzeichen, die per
-inicht nutzbar sind, trägt sshm nicht ein und sagt es. -
--setup/--rescan: Ein Key mit'im Dateinamen machte die ganze
~/.ssh/configungültig („invalid quotes"). Solche Pfade stehen jetzt
in"…",%wird zu%%; Keys mit",\,${oder Steuerzeichen
werden mit Hinweis im Block übersprungen. -
fish als Login-Shell der Gegenseite: fish wertet in
'…'die Folgen
\\und\'aus, Kommandos und Dateinamen mit Backslash kamen in
--runund im Dateibrowser verfälscht an. Das Quoting verzichtet jetzt
auf Backslashes innerhalb der Quotes und parst in sh, bash und fish gleich. -
--run -smit sudo-rs (Ubuntu ab 25.10, in Debian 13 optional):
Wegen anderer Meldungstexte gab es statt der Passwort-Rückfrage
sudo=error. sshm kennt jetzt die Texte beider Implementierungen. -
--runohne-s: Ctrl-C am Passwort-Prompt stand alsstart/end exit=130in der History statt alsfail reason=interrupted.--run
ordnet Verbindungen jetzt genauso ein wie eine Session. -
Ziel
user@[fe80::1]ohne Port:-anahm es an, ssh fand den Host
mit Klammern aber nicht. Die Klammern entfallen jetzt beim Verbinden. -
Bash-Completion fehlte in Login-Shells (jeder ssh-Login auf Debian):
~/.profilesourct~/.bashrc, bevor es~/.local/binin denPATH
nimmt, sshm war beim Laden noch nicht auffindbar. Die Completion lädt
jetzt erst beim ersten TAB. -
-aund--importnahmen Namen an, die mit#oder-beginnen:
Die einen standen danach als Kommentar unsichtbar in der Konfig, die
anderen hielt sshm beim Aufruf für eine Option. Beides wird abgelehnt,
sshm -eund-lwarnen bei-vorn. -
Überzählige Argumente wurden still ignoriert —
sshm --update -y extraspielte sogar das Update ein. Jetzt Fehler mit Exit-Code 1, ebenso
bei--setup x,-l x,--completion fish x,sshm web extrausw. -
Zu viele Felder in der Konfig (
|in der Beschreibung) schnitt sshm
ohne Hinweis ab.sshm -eund-lnennen jetzt die Zeile. -
--report 1: Eine Session, die genau um 00:00:00 endete, erschien
heute als1× 0s. -
Dateibrowser: Preview und Startverzeichnis schluckten Tastatur-
Vorlauf (ssh ohne</dev/null). -
Ctrl-C während
--updatehinterließ die halb geladene Datei in
$TMPDIR. -
Auth-Hinweis bei Fehlversuch behauptete „Passwort nicht akzeptiert
oder abgebrochen", auch wenn ssh gar kein Passwort versucht hatte
(PreferredAuthentications=publickey,PasswordAuthentication=no,
BatchMode). Der Hinweis richtet sich jetzt nach dem Debug-Log: Passwort
versucht, nicht versucht, bzw. ohne Mitschnitt unbekannt; ebenso
„kein Key angeboten" statt „kein Key akzeptiert".
Geändert
-
Setup-Fassung 3: Die Blöcke von
--setuphaben sich geändert
(Key-Erkennung, Completion, Quoting derIdentityFile-Zeilen). Nach dem
Update einmalsshm --setupausführen — Blöcke aus 1.12.0 (Fassung 2)
werden mit Backup an ihrer Stelle erneuert. Die Unit des Agent-Service
zählt getrennt und bleibt unangetastet, eine angepasste TTL also auch. -
--runohne-släuft nicht mehr in der Login-Shell der
Gegenseite, sondern wie mit-spersh -cin bash bzw. sh — so
funktioniert[[ … ]]auch bei fish als Login-Shell. Achtung: Eine
Login-Umgebung gibt es dabei nicht.PATH-Ergänzungen aus~/.profile
(auf Debian~/.local/bin), Aliasse und Funktionen der Login-Shell und
fish-Syntax stehen dem Kommando nicht mehr zur Verfügung;sshm --run 'sshm --update -y'endet dort z. B. mit 127, hier den vollen Pfad
angeben. -
--runschneidet die Meldungen von ssh immer mit (auch mit
SSHM_STATS=0), damit Fehlversuche klassifiziert werden; die Ausgabe
des Kommandos läuft unverändert durch. Die end-Zeile trägt ohne-s
jetzt auchsent/received— nicht mit-s(das Kommando läuft dort
über einen eigenen Multiplex-Master) und nicht, wenn die Verbindung
selbst einen ControlPersist-Master aufbaut (ssh meldet die Mengen dann
erst beim Ende des Masters). -
Dauer überall im selben Format:
--reportzeigte2h00m, History
und Zusammenfassung2h05m00s. Jetzt überall42s/3m07s/
2h05m00s; ältere History-Zeilen liest--reportweiter. -
--checkprüft parallel (bis zu 16 gleichzeitig): sechs gedroppte
Hosts kosteten nacheinander 12 s, jetzt 2 s. Die Ausgabe bleibt in der
Reihenfolge der Konfig. -
Neuer Fehlergrund
reason=rejected: Der Server hat die Verbindung
vor der Anmeldung verworfen (PerSourcePenalties, fail2ban mit REJECT,
MaxStartups). Bei geändertem Hostkey nennt der Hinweis den passenden
ssh-keygen -f … -R …-Befehl. -
README/usage:
--checkprüft nur TCP, ein Hostkey-Wechsel zeigt dort ✓. -
Namen nur aus Ziffern:
sshm 3meint immer Eintrag Nr. 3, ein
Eintrag namens3ist per Name nicht erreichbar.-alehnt solche
Namen ab,--importüberspringt sie,sshm -ewarnt (auch bei doppelt
vergebenen Namen). -
Hilfe: Der Kopfkommentar des Scripts verweist auf
sshm -h,
usage()ist die einzige Quelle für Aufruf und Env-Schalter.
Downloads
-
Source code (ZIP)
0 downloads
-
Source code (TAR.GZ)
0 downloads
-