Anhang A: Spickzettel
Alles Wichtige aus Tag 0–15 auf wenigen Seiten. Die Zahl in Klammern
ist der Tag, an dem du es geübt hast. Im Zweifel gelten
man bash, help <builtin> und
www.shellcheck.net/wiki.
Gerüst eines Skripts
#!/usr/bin/env bash
# name – was es tut: name [-o wert] argument… (1, 5)
set -Eeuo pipefail # (1, 10)
source "$(dirname "$(readlink -f "${BASH_SOURCE[0]}")")/../lib/lib.sh" # (4)
trap 'die "Zeile $LINENO: $BASH_COMMAND"' ERR # (10)
need curl jq # (4)
tmp=$(mktemp) && trap 'rm -f "$tmp"' EXIT # (9, 10)
| Exit-Code |
Bedeutung |
Tag |
| 0 |
Erfolg |
1 |
| 1 |
Fehler |
1 |
| 2 |
falsche Bedienung (Konvention) |
3 |
| 124 |
timeout abgelaufen |
12 |
| 126 / 127 |
nicht ausführbar / nicht gefunden |
1, 15 |
| 128 + n |
durch Signal n beendet (130 INT, 137 KILL, 143 TERM) |
12 |
Variablen und Quoting
| Ausdruck |
Ergebnis |
Tag |
"$x" |
Wert, kein Splitting, kein Globbing |
2 |
'$x' |
genau $x |
2 |
"$@" / "$*" |
alle Argumente einzeln / als ein Text |
2 |
${x:-std} / ${x:?meldung} |
Standardwert / Abbruch, wenn leer |
2 |
${#x} |
Länge |
2 |
${x#muster} / ${x##muster} |
vorne kürzestes / längstes Stück weg |
2 |
${x%muster} / ${x%%muster} |
hinten kürzestes / längstes Stück weg |
2 |
${x//a/b}, ${x^^},
${x:2:3} |
ersetzen, groß, Teilstück |
2 |
$(befehl) |
Ausgabe eines Befehls |
1 |
$((a + b)), ((a > b)) |
rechnen, vergleichen (ganzzahlig) |
3 |
printf '%q' "$x" |
für eine zweite Shell quoten |
5, 14 |
Bedingungen, Schleifen, Arrays
[[ -f $f && $x == muster* && $y =~ ^[0-9]+$ ]] # Datei, Muster, Regex (3)
case "$x" in a | b) … ;; 2??) … ;; *) … ;; esac # (3)
for ((i = 0; i < n; i++)); do …; done # (3)
while IFS= read -r zeile; do …; done < datei # Zeilen sicher lesen (3)
while IFS= read -r -d '' f; do …; done < <(find … -print0) # beliebige Namen (9)
liste=(a "b c"); liste+=(d); "${liste[@]}"; ${#liste[@]} # Array (5)
declare -A n; n[$k]=$((${n[$k]:-0} + 1)); "${!n[@]}" # zählen (5)
mapfile -t zeilen < <(befehl) # (5)
while getopts ":u:t:vh" opt; do case "$opt" in …; esac; done; shift $((OPTIND - 1))
Textwerkzeuge
| Aufgabe |
Befehl |
Tag |
| Zeilen zählen, finden |
grep -c, grep -v, grep -E,
grep -o, grep -F |
6 |
| Feld ausschneiden |
cut -d' ' -f7 |
6 |
| Häufigkeiten |
sort \| uniq -c \| sort -rn \| head |
6 |
| Ersetzen |
sed -E 's#/notes/[0-9]+#/notes/:id#' |
7 |
| Zeilen wählen |
sed -n '5p', sed '/muster/d',
sed -i.bak … |
7 |
| Summieren, gruppieren |
awk '{n[$5]++; t[$5]+=$9} END {…}' |
7 |
| Kommazahlen |
awk 'END {printf "%.1f", s / NR}' |
7 |
| JSON lesen |
jq -r '.[] \| select(.text == "x") \| .id' |
8 |
| JSON bauen |
jq -n --arg t "$text" '{text: $t}' |
8 |
| CSV |
jq -r '.[] \| [.id, .text] \| @csv' |
8 |
| HTTP |
curl -fsS --max-time 3 -w '%{http_code}' |
1, 8 |
| Dateien finden |
find dir -maxdepth 1 -name 'x-*' -mtime +30 -print0 |
9 |
| Parallel |
xargs -0 -P 4 -n 1 …,
befehl & … wait "$pid" |
9, 12 |
Betrieb
exec 9> datei.lock; flock -n 9 || exit 0 # nur ein Lauf (10)
mv "$tmp" "$ziel" # atomar ersetzen (9)
sleep "$n" & wait $! || true # Signale sofort behandeln (12)
trap 'stop=1' TERM INT; trap 'info …' USR1 # geordnet beenden (12)
timeout -k 5 30 befehl # Laufzeit begrenzen (12)
logger -t name -p user.warning "…" # ins Journal (13)
systemctl --user daemon-reload; systemctl --user enable --now x.timer # (13)
journalctl --user -u x -n 20 --no-pager # (13)
rsync -az --delete -n -i quelle/ host:ziel/ # Probelauf (14)
ssh host bash -s -- "'arg'" < skript # Skript remote (14)
ssh -R 18080:127.0.0.1:8080 host … # Tunnel (14)
| cron |
systemd |
Tag |
*/5 * * * * |
OnCalendar=*:0/5 |
13 |
30 2 * * * |
OnCalendar=*-*-* 02:30 |
13 |
| – |
Persistent=true (verpasste Läufe nachholen) |
13 |
Umgebung minimal, /bin/sh |
Umgebung aus Environment=, %h = Home |
13 |
Ausgabe per Mail oder >> log 2>&1 |
Ausgabe im Journal |
13 |
Qualität
shellcheck -x bin/* # .shellcheckrc: source-path=SCRIPTDIR, enable=… (1, 11)
shfmt -d bin lib # .editorconfig: indent_size, switch_case_indent (11)
bats tests # run …; [ "$status" -eq 0 ]; [[ $output == *x* ]] (11)
bash -x skript # Ablaufverfolgung (4)
type -a name # Alias, Funktion, Builtin oder Datei? (0, 15)
Fehlerbilder
| Symptom |
Ursache |
Tag |
bash\r: No such file or directory |
Windows-Zeilenenden |
15 |
command not found nur in cron |
PATH von cron ohne eigene Ordner |
13 |
Variable nach … \| while leer |
Schleife lief in einer Unter-Shell |
3, 12 |
wait: pid … is not a child of this shell |
wait in einer Unter-Shell |
12 |
| Datei mit Leerzeichen wird nicht gefunden |
Variable ohne Anführungszeichen |
2, 15 |
| Skript meldet 0 trotz Fehler |
letzter Befehl oder fehlendes pipefail |
1, 15 |
((x++)) bricht mit set -e ab |
Ausdruck war 0 → Exit-Code 1 |
3 |
local x=$(…) verschluckt Fehler |
local meldet immer Erfolg |
4 |
| Trap reagiert erst nach Minuten |
Vordergrundbefehl blockiert, & wait fehlt |
12 |
systemd ExecMainStatus=203 |
Programm in ExecStart= nicht gefunden |
15 |