qmctl - Man Page

manage QM container resources

Synopsis

qmctl [Options] COMMAND [ARGS...]

Description

qmctl is a command-line interface for managing Quality Management (QM) containers. It provides inspection, execution, and file copy operations between host and container environments.

Commands

show [SUBCOMMAND]

Display container-related information. Subcommands include:

resources

Show live systemd-cgtop resource usage (CPU/memory/etc.) for qm.service.

unix-domain-sockets

Show UNIX sockets inside the QM container.

shared-memory

List shared memory segments (via ipcs) inside the container.

namespaces

Show namespace types used by the container.

available-devices

List devices defined in the container's configuration.

all

Display all of the above with a snapshot.

exec COMMAND...

Execute a command inside the QM container. Equivalent to podman exec on the main container.

execin CONTAINER COMMAND...

Execute a command inside a nested container (e.g., one defined inside the main QM container using systemd-nspawn or Quadlet).

cp SRC DST

Copy files between host and QM container. Either path may use the format QM:/path/to/file.

Options

-h,  --help

Show this help message and exit.

--verbose

Print accessed configuration file paths for debugging or auditing.

Examples

Display all container-related info:

qmctl show all

Run uname -a inside the QM container:

qmctl exec uname -a

Run ls /dev inside the nested alpine container:

qmctl execin alpine ls /dev

Copy a file from host to QM:

qmctl cp /home/user/data.txt QM:/root/

Copy a file from QM container to host:

qmctl cp QM:/etc/qm/config.toml /tmp/

See Also

podman(1), quadlet(5), systemd(1)

Homepage

https://github.com/containers/qm

Info

May 2025 qmctl 1.0