timeout¶
Startet einen Befehl und beendet ihn, wenn er länger als die angegebene Zeit braucht. Schützt Skripte und Cronjobs davor, ewig zu hängen.

Syntax¶
timeout [OPTION]... DAUER BEFEHL [ARGUMENT]...
DAUER ist eine Zahl mit optionaler Einheit: s Sekunden (Standard), m Minuten, h
Stunden, d Tage.
Optionen¶
| Option | Beschreibung |
|---|---|
-s SIGNAL |
Signal, das nach Ablauf der Zeit gesendet wird, Standard ist TERM |
-k DAUER |
KILL senden, wenn der Befehl DAUER nach dem ersten Signal noch läuft |
-v |
Melden, wenn das Signal gesendet wird |
--preserve-status |
Den Exit-Code des Befehls zurückgeben, auch nach einem Timeout |
Beispiele¶
Ein Skript auf 30 Minuten begrenzen:
timeout 30m ./backup.sh; echo $?
124
Exit-Code 124 bedeutet: Die Zeit war abgelaufen, und timeout hat den Befehl beendet.
Melden, wenn die Zeit abgelaufen ist:
timeout -v 10 rsync -a /srv/ /mnt/backup/
timeout: sending signal TERM to command ‘rsync’
KILL senden, wenn der Befehl TERM ignoriert:
timeout -k 10 60 ./backup.sh; echo $?
137
Nach 60 Sekunden sendet timeout ein TERM. Das Skript hat es ignoriert und deshalb
10 Sekunden später KILL bekommen. 137 ist 128 + 9, die Nummer von KILL.
Eine Prüfung im Skript nicht hängen lassen:
timeout 5 ssh nox@192.0.2.20 uptime || echo "keine Antwort"
keine Antwort
Wenn der Befehl rechtzeitig fertig ist:
timeout 60 ls /srv; echo $?
backup www
0
Ausgabe und Exit-Code sind die des Befehls selbst.
Wann brauche ich das?¶
- In Cronjobs, damit ein hängendes Backup nicht den nächsten Lauf blockiert
- In Skripten, die auf das Netzwerk warten, z. B.
ssh,curloder eine Datenbankprüfung - Beim Testen, um einen Befehl zuverlässig nach einer festen Zeit zu stoppen
Den Exit-Code auswerten
124 heißt Timeout, 137 heißt, er musste mit KILL beendet werden. Jeder andere
Wert kommt vom Befehl selbst. So kann dein Skript entscheiden, wie es weitergeht.
Shell-Funktionen und Builtins
timeout startet ein neues Programm. Shell-Funktionen, Aliase und Builtins wie cd
funktionieren damit nicht. Für mehrere Befehle nimm timeout 60 bash -c '…'.