The qm wait command is a command-line tool provided by the QEMU/KVM Virtual Machine Manager that allows users to wait for a virtual machine to stop running. When executed, the qm wait command will pause the command-line interface and wait until the specified virtual machine has completely stopped.
To use qm wait, users need to specify the ID number of the virtual machine they want to wait for.
qm wait Command Examples
1. Wait until the virtual machine is stopped:
# qm wait {{vm_id}}
2. Wait until the virtual machine is stopped with a 10 second timeout:
# qm wait --timeout {{10}} {{vm_id}}
3. Send a shutdown request, then wait until the virtual machine is stopped with a 10 second timeout:
# qm shutdown {{vm_id}} && qm wait --timeout {{10}} {{vm_id}}
Summary
The qm wait command is useful when users want to automate virtual machine management tasks, such as starting or stopping a virtual machine, and need to wait for a virtual machine to complete its operation before continuing with the next step.
It’s important to note that qm wait will not stop a virtual machine if it is running. It simply waits for the virtual machine to complete its shutdown process and stop running. If a virtual machine is not responding or is stuck in a running state, users can use other commands, such as qm stop, to force the virtual machine to stop.
In addition to qm wait, the QEMU/KVM Virtual Machine Manager provides a variety of other commands and features for managing virtual machines, including creating, deleting, and migrating virtual machines, taking snapshots, and managing virtual machine storage and networking. More information about qm wait and other features of the QEMU/KVM Virtual Machine Manager can be found in the project’s documentation at https://pve.proxmox.com/pve-docs/qm.1.html.