diff --git a/README.MD b/README.MD new file mode 100644 index 0000000..2c83079 --- /dev/null +++ b/README.MD @@ -0,0 +1,54 @@ +# Killguest + +`killguest` ist ein kleines Shell-Tool für Proxmox VE, um hängende VMs oder LXC-Container zuverlässig zu beenden, +wenn Standardbefehle wie `qm stop` oder `pct stop` versagen. + +## Features + +- Automatische Erkennung (VM oder LXC) +- Anzeige von ID, Name, Typ und Prozesse `bevor` beendet wird + +## Installation + +```bash +nano /usr/local/bin/killguest +chmod +x /usr/local/bin/killguest +``` + +## Nutzung + + killguest + +Beispiele: + + killguest 125 + killguest 201 + +## Funktionsweise + +### VM + +Findet den QEMU-Prozess: + + /usr/bin/kvm -id + +und beendet ihn mit: + + kill -9 + +### LXC + +Findet Prozesse über cgroups: + + /proc/*/cgroup → lxc/ + +und beendet alle zugehörigen Prozesse. + +## Warnung + +Dieses Tool führt einen Hard-Stop durch (wie Strom ziehen). Nur +verwenden, wenn normale Stop-Befehle nicht funktionieren. + +## Fazit + +killguest ist ein Notfall-Tool für hartnäckige Hänger in Proxmox.