NAME
virt-cloud-boot - manual page for virt-cloud-boot 26.10
DESCRIPTION
usage: virt-cloud-boot [-h] [--dry-run] [-i FILE] [--fedora VER]
- [--fedora-uki VER] [--centos VER] [--rhel VER]
-
[--alma VER] [--ubuntu VER] [--imgdir DIR] [--list] [-u USER] [--password PASSWD] [--package PKG] [--copy-file FILE] [--runcmd CMD] [--no-uefi] [--smm] [--qemu-vars] [--secure-boot] [--cc-mode {none,sev,snp,tdx}] [--sev] [--snp] [--tdx] [--log FILE] [--memory MEM] [--smp CPUS] [--scsi | --no-scsi] [--sata | --no-sata] [--nvme | --no-nvme] [--vblk | --no-vblk] [--ufs | --no-ufs] [--ssh-port PORT] [--ssh-agent | --no-ssh-agent]
boot cloud image
options:
- -h, --help
-
show this help message and exit
- --dry-run, --dryrun
-
print generated qemu command line and quit
select cloud image:
- -i, --image FILE
-
boot cloud image FILE
- --fedora VER
-
boot fedora VER
- --fedora-uki VER
-
boot fedora VER (uki variant)
- --centos VER
-
boot centos stream VER
- --rhel VER
-
boot rhel VER
- --alma VER
-
boot almalinux VER
- --ubuntu VER
-
boot ubuntu VER
- --imgdir DIR
-
lookup fedora/centos/rhel images in DIR (default: /vmdisk/iso/distro)
- --list
-
list cloud images in /vmdisk/iso/distro
setup cloud image:
- -u, --username, --user USER
-
login username (default: cloud)
- --password, --passwd PASSWD
-
login password (default: cloud)
- --package, --rpm PKG
-
install package PKG
- --copy-file FILE
-
copy FILE into the guest
- --runcmd CMD
-
run CMD in guest
firmware setup:
- --no-uefi
-
skip uefi firmware setup (boot with qemu default firmware)
- --smm
-
use smm firmware builds (feature "require-smm")
- --qemu-vars, --qemuvars
-
use qemu uefi vars (feature "host-uefi-vars")
- --secure-boot, --sb
-
enable secure boot (feature "enrolled-keys")
- --cc-mode {none,sev,snp,tdx}
-
set confidential computing mode (default: none)
- --sev
-
enable sev cc mode (feature "amd-sev")
- --snp
-
enable snp cc mode (feature "amd-sev-snp")
- --tdx
-
enable tdx cc mode (feature "intel-tdx")
- --log FILE
-
write firmware log to FILE
hardware setup:
- --memory, --mem MEM
-
assign guest memory (default: 4G)
- --smp CPUS
-
assign guest vcpus (default: 1)
- --scsi, --no-scsi
-
use virtio scsi (default: yes)
- --sata, --no-sata
-
use sata (q35 only, default: no)
- --nvme, --no-nvme
-
use NVMe emulation (default: no)
- --vblk, --no-vblk
-
use virtio block (default: no)
- --ufs, --no-ufs
-
use universal flash storage (default: no)
network setup:
- --ssh-port PORT
-
forward ssh connections to localhost:PORT to the guest
- --ssh-agent, --no-ssh-agent
-
get public ssh keys from ssh agent (default: yes)
ENVIRONMENT
- VIRT_DISTRO_IMGDIR
-
default cloud image directory
AUTHOR
Gerd Hoffmann <[email protected]>