List & Query
EnterpriseBacula Enterprise Only
This solution is only available for Bacula Enterprise. For subscription inquiries, please reach out to sales@baculasystems.com.
Libvirt resources can be listed using the bconsole .ls or .query command.
Any Fileset parameter supported by the plugin can also be used in the plugin="" value to filter results, in the same way as during a backup.
Examples are shown below.
List domains:
List example: Base path
.ls client=127.0.0.1-fd plugin="libvirt:" path=/
drwxr-xr-x 1 nobody nogroup 1024 2025-06-26 11:34:57 /domains/
drwxr-xr-x 1 nobody nogroup 1024 2025-06-26 11:34:57 /storage_pools/
drwxr-xr-x 1 nobody nogroup 1024 2025-06-26 11:34:57 /networks/
2000 OK estimate files=2 bytes=2,048
List example: All domains
.ls client=127.0.0.1-fd plugin="libvirt:" path=/domains/
drwxr-xr-x 1 nobody nogroup 1024 2025-06-26 11:39:27 /domains/ubu1G/
drwxr-xr-x 1 nobody nogroup 1024 2025-06-26 11:39:27 /domains/ubu22/
drwxr-xr-x 1 nobody nogroup 1024 2025-06-26 11:39:27 /domains/debian12/
2000 OK estimate files=3 bytes=3,072
List example: Base resources of one domain
.ls client=127.0.0.1-fd plugin="libvirt:" path=/domains/ubu22/
drwxr-xr-x 1 nobody nogroup 1024 2025-06-26 11:40:07 /domains/ubu22/disks/
drwxr-xr-x 1 nobody nogroup 1024 2025-06-26 11:40:07 /domains/ubu22/checkpoints/
2000 OK estimate files=2 bytes=2,048
List example: Disks of one domain
*.ls client=127.0.0.1-fd plugin="libvirt:" path=/domains/ubu22/disks/
-rw-r----- 1 nobody nogroup 21474836480 2025-06-26 11:41:47 /domains/ubu22/disks/vda
-rw-r----- 1 nobody nogroup 10737418240 2025-06-26 11:41:47 /domains/ubu22/disks/vdb
-rw-r----- 1 nobody nogroup 0 2025-06-26 11:41:47 /domains/ubu22/disks/sda
2000 OK estimate files=3 bytes=32,212,254,720
List example: Checkpoints of one domain
*.ls client=127.0.0.1-fd plugin="libvirt:" path=/domains/ubu22/checkpoints/
-rw-r----- 1 nobody nogroup 0 2025-06-26 11:42:45 /domains/ubu22/checkpoints/bacula-F-319-Test-Libvirt-Ubu22.2025-05-26_20.13.28_06
-rw-r----- 1 nobody nogroup 0 2025-06-26 11:42:45 /domains/ubu22/checkpoints/bacula-I-320-Test-Libvirt-Ubu22.2025-05-26_20.17.06_07
-rw-r----- 1 nobody nogroup 0 2025-06-26 11:42:45 /domains/ubu22/checkpoints/bacula-I-321-Test-Libvirt-Ubu22.2025-05-26_20.17.34_08
-rw-r----- 1 nobody nogroup 0 2025-06-26 11:42:45 /domains/ubu22/checkpoints/bacula-I-322-Test-Libvirt-Ubu22.2025-05-26_20.18.08_09
-rw-r----- 1 nobody nogroup 0 2025-06-26 11:42:45 /domains/ubu22/checkpoints/bacula-D-324-Test-Libvirt-Ubu22.2025-05-27_11.17.06_03
2000 OK estimate files=5 bytes=0
List example: All storage pools
.ls client=127.0.0.1-fd plugin="libvirt:" path=/
drwxr-xr-x 1 nobody nogroup 1024 2025-06-26 11:43:59 /storage_pools/default/
drwxr-xr-x 1 nobody nogroup 1024 2025-06-26 11:43:59 /storage_pools/Home-pool/
2000 OK estimate files=2 bytes=2,048
List example: Base resources of one storage pool
.ls client=127.0.0.1-fd plugin="libvirt:" path=/domains/ubu22/
drwxr-xr-x 1 nobody nogroup 1024 2025-06-26 11:45:18 /storage_pools/default/volumes/
2000 OK estimate files=1 bytes=1,024
List example: All volumes of one storage pool
.ls client=127.0.0.1-fd plugin="libvirt:" path=/storage_pools/default/volumes/
-rw-r----- 1 nobody nogroup 2147483648 2025-06-26 11:46:00 /storage_pools/default/volumes/debian12-1.qcow2
-rw-r----- 1 nobody nogroup 5368709120 2025-06-26 11:46:00 /storage_pools/default/volumes/ubuntu24.10.qcow2
-rw-r----- 1 nobody nogroup 661651456 2025-06-26 11:46:00 /storage_pools/default/volumes/debian-12.8.0-amd64-netinst.iso
-rw-r----- 1 nobody nogroup 21474836480 2025-06-26 11:46:00 /storage_pools/default/volumes/debian12.qcow2
-rw-r----- 1 nobody nogroup 10737418240 2025-06-26 11:46:00 /storage_pools/default/volumes/ubu22-1.qcow2
2000 OK estimate files=5 bytes=40,390,098,944
List example: All networks
*.ls client=127.0.0.1-fd plugin="libvirt:" path=/networks/
-rw-r----- 1 nobody nogroup 0 2025-07-15 13:31:49 /networks/default
-rw-r----- 1 nobody nogroup 0 2025-07-15 13:31:49 /networks/IsolatedNetwork
-rw-r----- 1 nobody nogroup 0 2025-07-15 13:31:49 /networks/Inactive
-rw-r----- 1 nobody nogroup 0 2025-07-15 13:31:49 /networks/bridge
-rw-r----- 1 nobody nogroup 0 2025-07-15 13:31:49 /networks/OpenNetwork
-rw-r----- 1 nobody nogroup 0 2025-07-15 13:31:49 /networks/IOVPoolNetwork
2000 OK estimate files=5 bytes=0
Query example: Domain details
.query client=127.0.0.1-fd plugin="libvirt: domain=ubu22" parameter=domain
domain=ubu22
uuid=88598ef2-81b1-42e0-a43c-2dd9086e472e
active=false
disks=3
Important
When the Libvirt plugin lists domain details, it does not take into account whether the disk can be backed up or not.
Query example: Disks details
.query client=127.0.0.1-fd plugin="libvirt: domain=ubu22" parameter=disk
disk=vda
domain=ubu22
backupable=true
capacity=21474836480
disk=vdb
domain=ubu22
backupable=true
capacity=10737418240
disk=sda
domain=ubu22
backupable=false
capacity=0
Go back to: Libvirt Plugin: Operations.