1QA output created by 082 2 3=== create: Options specified more than once === 4 5Testing: create -f foo -f qcow2 TEST_DIR/t.qcow2 128M 6Formatting 'TEST_DIR/t.qcow2', fmt=qcow2 size=134217728 cluster_size=65536 lazy_refcounts=off refcount_bits=16 compression_type=zlib 7image: TEST_DIR/t.IMGFMT 8file format: IMGFMT 9virtual size: 128 MiB (134217728 bytes) 10cluster_size: 65536 11 12Testing: create -f qcow2 -o cluster_size=4k -o lazy_refcounts=on TEST_DIR/t.qcow2 128M 13Formatting 'TEST_DIR/t.qcow2', fmt=qcow2 size=134217728 cluster_size=4096 lazy_refcounts=on refcount_bits=16 compression_type=zlib 14image: TEST_DIR/t.IMGFMT 15file format: IMGFMT 16virtual size: 128 MiB (134217728 bytes) 17cluster_size: 4096 18Format specific information: 19 compat: 1.1 20 compression type: zlib 21 lazy refcounts: true 22 refcount bits: 16 23 corrupt: false 24 25Testing: create -f qcow2 -o cluster_size=4k -o lazy_refcounts=on -o cluster_size=8k TEST_DIR/t.qcow2 128M 26Formatting 'TEST_DIR/t.qcow2', fmt=qcow2 size=134217728 cluster_size=8192 lazy_refcounts=on refcount_bits=16 compression_type=zlib 27image: TEST_DIR/t.IMGFMT 28file format: IMGFMT 29virtual size: 128 MiB (134217728 bytes) 30cluster_size: 8192 31Format specific information: 32 compat: 1.1 33 compression type: zlib 34 lazy refcounts: true 35 refcount bits: 16 36 corrupt: false 37 38Testing: create -f qcow2 -o cluster_size=4k,cluster_size=8k TEST_DIR/t.qcow2 128M 39Formatting 'TEST_DIR/t.qcow2', fmt=qcow2 size=134217728 cluster_size=8192 lazy_refcounts=off refcount_bits=16 compression_type=zlib 40image: TEST_DIR/t.IMGFMT 41file format: IMGFMT 42virtual size: 128 MiB (134217728 bytes) 43cluster_size: 8192 44 45=== create: help for -o === 46 47Testing: create -f qcow2 -o help TEST_DIR/t.qcow2 128M 48Supported options: 49 backing_file=<str> - File name of a base image 50 backing_fmt=<str> - Image format of the base image 51 cluster_size=<size> - qcow2 cluster size 52 compat=<str> - Compatibility level (v2 [0.10] or v3 [1.1]) 53 compression_type=<str> - Compression method used for image cluster compression 54 data_file=<str> - File name of an external data file 55 data_file_raw=<bool (on/off)> - The external data file must stay valid as a raw image 56 encrypt.cipher-alg=<str> - Name of encryption cipher algorithm 57 encrypt.cipher-mode=<str> - Name of encryption cipher mode 58 encrypt.format=<str> - Encrypt the image, format choices: 'aes', 'luks' 59 encrypt.hash-alg=<str> - Name of encryption hash algorithm 60 encrypt.iter-time=<num> - Time to spend in PBKDF in milliseconds 61 encrypt.ivgen-alg=<str> - Name of IV generator algorithm 62 encrypt.ivgen-hash-alg=<str> - Name of IV generator hash algorithm 63 encrypt.key-secret=<str> - ID of secret providing qcow AES key or LUKS passphrase 64 encryption=<bool (on/off)> - Encrypt the image with format 'aes'. (Deprecated in favor of encrypt.format=aes) 65 lazy_refcounts=<bool (on/off)> - Postpone refcount updates 66 nocow=<bool (on/off)> - Turn off copy-on-write (valid only on btrfs) 67 preallocation=<str> - Preallocation mode (allowed values: off, metadata, falloc, full) 68 refcount_bits=<num> - Width of a reference count entry in bits 69 size=<size> - Virtual disk size 70 71Testing: create -f qcow2 -o ? TEST_DIR/t.qcow2 128M 72Supported options: 73 backing_file=<str> - File name of a base image 74 backing_fmt=<str> - Image format of the base image 75 cluster_size=<size> - qcow2 cluster size 76 compat=<str> - Compatibility level (v2 [0.10] or v3 [1.1]) 77 compression_type=<str> - Compression method used for image cluster compression 78 data_file=<str> - File name of an external data file 79 data_file_raw=<bool (on/off)> - The external data file must stay valid as a raw image 80 encrypt.cipher-alg=<str> - Name of encryption cipher algorithm 81 encrypt.cipher-mode=<str> - Name of encryption cipher mode 82 encrypt.format=<str> - Encrypt the image, format choices: 'aes', 'luks' 83 encrypt.hash-alg=<str> - Name of encryption hash algorithm 84 encrypt.iter-time=<num> - Time to spend in PBKDF in milliseconds 85 encrypt.ivgen-alg=<str> - Name of IV generator algorithm 86 encrypt.ivgen-hash-alg=<str> - Name of IV generator hash algorithm 87 encrypt.key-secret=<str> - ID of secret providing qcow AES key or LUKS passphrase 88 encryption=<bool (on/off)> - Encrypt the image with format 'aes'. (Deprecated in favor of encrypt.format=aes) 89 lazy_refcounts=<bool (on/off)> - Postpone refcount updates 90 nocow=<bool (on/off)> - Turn off copy-on-write (valid only on btrfs) 91 preallocation=<str> - Preallocation mode (allowed values: off, metadata, falloc, full) 92 refcount_bits=<num> - Width of a reference count entry in bits 93 size=<size> - Virtual disk size 94 95Testing: create -f qcow2 -o cluster_size=4k,help TEST_DIR/t.qcow2 128M 96Supported options: 97 backing_file=<str> - File name of a base image 98 backing_fmt=<str> - Image format of the base image 99 cluster_size=<size> - qcow2 cluster size 100 compat=<str> - Compatibility level (v2 [0.10] or v3 [1.1]) 101 compression_type=<str> - Compression method used for image cluster compression 102 data_file=<str> - File name of an external data file 103 data_file_raw=<bool (on/off)> - The external data file must stay valid as a raw image 104 encrypt.cipher-alg=<str> - Name of encryption cipher algorithm 105 encrypt.cipher-mode=<str> - Name of encryption cipher mode 106 encrypt.format=<str> - Encrypt the image, format choices: 'aes', 'luks' 107 encrypt.hash-alg=<str> - Name of encryption hash algorithm 108 encrypt.iter-time=<num> - Time to spend in PBKDF in milliseconds 109 encrypt.ivgen-alg=<str> - Name of IV generator algorithm 110 encrypt.ivgen-hash-alg=<str> - Name of IV generator hash algorithm 111 encrypt.key-secret=<str> - ID of secret providing qcow AES key or LUKS passphrase 112 encryption=<bool (on/off)> - Encrypt the image with format 'aes'. (Deprecated in favor of encrypt.format=aes) 113 lazy_refcounts=<bool (on/off)> - Postpone refcount updates 114 nocow=<bool (on/off)> - Turn off copy-on-write (valid only on btrfs) 115 preallocation=<str> - Preallocation mode (allowed values: off, metadata, falloc, full) 116 refcount_bits=<num> - Width of a reference count entry in bits 117 size=<size> - Virtual disk size 118 119Testing: create -f qcow2 -o cluster_size=4k,? TEST_DIR/t.qcow2 128M 120Supported options: 121 backing_file=<str> - File name of a base image 122 backing_fmt=<str> - Image format of the base image 123 cluster_size=<size> - qcow2 cluster size 124 compat=<str> - Compatibility level (v2 [0.10] or v3 [1.1]) 125 compression_type=<str> - Compression method used for image cluster compression 126 data_file=<str> - File name of an external data file 127 data_file_raw=<bool (on/off)> - The external data file must stay valid as a raw image 128 encrypt.cipher-alg=<str> - Name of encryption cipher algorithm 129 encrypt.cipher-mode=<str> - Name of encryption cipher mode 130 encrypt.format=<str> - Encrypt the image, format choices: 'aes', 'luks' 131 encrypt.hash-alg=<str> - Name of encryption hash algorithm 132 encrypt.iter-time=<num> - Time to spend in PBKDF in milliseconds 133 encrypt.ivgen-alg=<str> - Name of IV generator algorithm 134 encrypt.ivgen-hash-alg=<str> - Name of IV generator hash algorithm 135 encrypt.key-secret=<str> - ID of secret providing qcow AES key or LUKS passphrase 136 encryption=<bool (on/off)> - Encrypt the image with format 'aes'. (Deprecated in favor of encrypt.format=aes) 137 lazy_refcounts=<bool (on/off)> - Postpone refcount updates 138 nocow=<bool (on/off)> - Turn off copy-on-write (valid only on btrfs) 139 preallocation=<str> - Preallocation mode (allowed values: off, metadata, falloc, full) 140 refcount_bits=<num> - Width of a reference count entry in bits 141 size=<size> - Virtual disk size 142 143Testing: create -f qcow2 -o help,cluster_size=4k TEST_DIR/t.qcow2 128M 144Supported options: 145 backing_file=<str> - File name of a base image 146 backing_fmt=<str> - Image format of the base image 147 cluster_size=<size> - qcow2 cluster size 148 compat=<str> - Compatibility level (v2 [0.10] or v3 [1.1]) 149 compression_type=<str> - Compression method used for image cluster compression 150 data_file=<str> - File name of an external data file 151 data_file_raw=<bool (on/off)> - The external data file must stay valid as a raw image 152 encrypt.cipher-alg=<str> - Name of encryption cipher algorithm 153 encrypt.cipher-mode=<str> - Name of encryption cipher mode 154 encrypt.format=<str> - Encrypt the image, format choices: 'aes', 'luks' 155 encrypt.hash-alg=<str> - Name of encryption hash algorithm 156 encrypt.iter-time=<num> - Time to spend in PBKDF in milliseconds 157 encrypt.ivgen-alg=<str> - Name of IV generator algorithm 158 encrypt.ivgen-hash-alg=<str> - Name of IV generator hash algorithm 159 encrypt.key-secret=<str> - ID of secret providing qcow AES key or LUKS passphrase 160 encryption=<bool (on/off)> - Encrypt the image with format 'aes'. (Deprecated in favor of encrypt.format=aes) 161 lazy_refcounts=<bool (on/off)> - Postpone refcount updates 162 nocow=<bool (on/off)> - Turn off copy-on-write (valid only on btrfs) 163 preallocation=<str> - Preallocation mode (allowed values: off, metadata, falloc, full) 164 refcount_bits=<num> - Width of a reference count entry in bits 165 size=<size> - Virtual disk size 166 167Testing: create -f qcow2 -o ?,cluster_size=4k TEST_DIR/t.qcow2 128M 168Supported options: 169 backing_file=<str> - File name of a base image 170 backing_fmt=<str> - Image format of the base image 171 cluster_size=<size> - qcow2 cluster size 172 compat=<str> - Compatibility level (v2 [0.10] or v3 [1.1]) 173 compression_type=<str> - Compression method used for image cluster compression 174 data_file=<str> - File name of an external data file 175 data_file_raw=<bool (on/off)> - The external data file must stay valid as a raw image 176 encrypt.cipher-alg=<str> - Name of encryption cipher algorithm 177 encrypt.cipher-mode=<str> - Name of encryption cipher mode 178 encrypt.format=<str> - Encrypt the image, format choices: 'aes', 'luks' 179 encrypt.hash-alg=<str> - Name of encryption hash algorithm 180 encrypt.iter-time=<num> - Time to spend in PBKDF in milliseconds 181 encrypt.ivgen-alg=<str> - Name of IV generator algorithm 182 encrypt.ivgen-hash-alg=<str> - Name of IV generator hash algorithm 183 encrypt.key-secret=<str> - ID of secret providing qcow AES key or LUKS passphrase 184 encryption=<bool (on/off)> - Encrypt the image with format 'aes'. (Deprecated in favor of encrypt.format=aes) 185 lazy_refcounts=<bool (on/off)> - Postpone refcount updates 186 nocow=<bool (on/off)> - Turn off copy-on-write (valid only on btrfs) 187 preallocation=<str> - Preallocation mode (allowed values: off, metadata, falloc, full) 188 refcount_bits=<num> - Width of a reference count entry in bits 189 size=<size> - Virtual disk size 190 191Testing: create -f qcow2 -o cluster_size=4k -o help TEST_DIR/t.qcow2 128M 192Supported options: 193 backing_file=<str> - File name of a base image 194 backing_fmt=<str> - Image format of the base image 195 cluster_size=<size> - qcow2 cluster size 196 compat=<str> - Compatibility level (v2 [0.10] or v3 [1.1]) 197 compression_type=<str> - Compression method used for image cluster compression 198 data_file=<str> - File name of an external data file 199 data_file_raw=<bool (on/off)> - The external data file must stay valid as a raw image 200 encrypt.cipher-alg=<str> - Name of encryption cipher algorithm 201 encrypt.cipher-mode=<str> - Name of encryption cipher mode 202 encrypt.format=<str> - Encrypt the image, format choices: 'aes', 'luks' 203 encrypt.hash-alg=<str> - Name of encryption hash algorithm 204 encrypt.iter-time=<num> - Time to spend in PBKDF in milliseconds 205 encrypt.ivgen-alg=<str> - Name of IV generator algorithm 206 encrypt.ivgen-hash-alg=<str> - Name of IV generator hash algorithm 207 encrypt.key-secret=<str> - ID of secret providing qcow AES key or LUKS passphrase 208 encryption=<bool (on/off)> - Encrypt the image with format 'aes'. (Deprecated in favor of encrypt.format=aes) 209 lazy_refcounts=<bool (on/off)> - Postpone refcount updates 210 nocow=<bool (on/off)> - Turn off copy-on-write (valid only on btrfs) 211 preallocation=<str> - Preallocation mode (allowed values: off, metadata, falloc, full) 212 refcount_bits=<num> - Width of a reference count entry in bits 213 size=<size> - Virtual disk size 214 215Testing: create -f qcow2 -o cluster_size=4k -o ? TEST_DIR/t.qcow2 128M 216Supported options: 217 backing_file=<str> - File name of a base image 218 backing_fmt=<str> - Image format of the base image 219 cluster_size=<size> - qcow2 cluster size 220 compat=<str> - Compatibility level (v2 [0.10] or v3 [1.1]) 221 compression_type=<str> - Compression method used for image cluster compression 222 data_file=<str> - File name of an external data file 223 data_file_raw=<bool (on/off)> - The external data file must stay valid as a raw image 224 encrypt.cipher-alg=<str> - Name of encryption cipher algorithm 225 encrypt.cipher-mode=<str> - Name of encryption cipher mode 226 encrypt.format=<str> - Encrypt the image, format choices: 'aes', 'luks' 227 encrypt.hash-alg=<str> - Name of encryption hash algorithm 228 encrypt.iter-time=<num> - Time to spend in PBKDF in milliseconds 229 encrypt.ivgen-alg=<str> - Name of IV generator algorithm 230 encrypt.ivgen-hash-alg=<str> - Name of IV generator hash algorithm 231 encrypt.key-secret=<str> - ID of secret providing qcow AES key or LUKS passphrase 232 encryption=<bool (on/off)> - Encrypt the image with format 'aes'. (Deprecated in favor of encrypt.format=aes) 233 lazy_refcounts=<bool (on/off)> - Postpone refcount updates 234 nocow=<bool (on/off)> - Turn off copy-on-write (valid only on btrfs) 235 preallocation=<str> - Preallocation mode (allowed values: off, metadata, falloc, full) 236 refcount_bits=<num> - Width of a reference count entry in bits 237 size=<size> - Virtual disk size 238 239Testing: create -f qcow2 -u -o backing_file=TEST_DIR/t.qcow2,,help TEST_DIR/t.qcow2 128M 240Formatting 'TEST_DIR/t.qcow2', fmt=qcow2 size=134217728 backing_file=TEST_DIR/t.qcow2,,help cluster_size=65536 lazy_refcounts=off refcount_bits=16 compression_type=zlib 241 242Testing: create -f qcow2 -u -o backing_file=TEST_DIR/t.qcow2,,? TEST_DIR/t.qcow2 128M 243Formatting 'TEST_DIR/t.qcow2', fmt=qcow2 size=134217728 backing_file=TEST_DIR/t.qcow2,,? cluster_size=65536 lazy_refcounts=off refcount_bits=16 compression_type=zlib 244 245Testing: create -f qcow2 -o backing_file=TEST_DIR/t.qcow2, -o help TEST_DIR/t.qcow2 128M 246qemu-img: Invalid option list: backing_file=TEST_DIR/t.qcow2, 247 248Testing: create -f qcow2 -o backing_file=TEST_DIR/t.qcow2 -o ,help TEST_DIR/t.qcow2 128M 249qemu-img: Invalid option list: ,help 250 251Testing: create -f qcow2 -o backing_file=TEST_DIR/t.qcow2 -o ,, -o help TEST_DIR/t.qcow2 128M 252qemu-img: Invalid option list: ,, 253 254Testing: create -f qcow2 -o help 255Supported qcow2 options: 256 backing_file=<str> - File name of a base image 257 backing_fmt=<str> - Image format of the base image 258 cluster_size=<size> - qcow2 cluster size 259 compat=<str> - Compatibility level (v2 [0.10] or v3 [1.1]) 260 compression_type=<str> - Compression method used for image cluster compression 261 data_file=<str> - File name of an external data file 262 data_file_raw=<bool (on/off)> - The external data file must stay valid as a raw image 263 encrypt.cipher-alg=<str> - Name of encryption cipher algorithm 264 encrypt.cipher-mode=<str> - Name of encryption cipher mode 265 encrypt.format=<str> - Encrypt the image, format choices: 'aes', 'luks' 266 encrypt.hash-alg=<str> - Name of encryption hash algorithm 267 encrypt.iter-time=<num> - Time to spend in PBKDF in milliseconds 268 encrypt.ivgen-alg=<str> - Name of IV generator algorithm 269 encrypt.ivgen-hash-alg=<str> - Name of IV generator hash algorithm 270 encrypt.key-secret=<str> - ID of secret providing qcow AES key or LUKS passphrase 271 encryption=<bool (on/off)> - Encrypt the image with format 'aes'. (Deprecated in favor of encrypt.format=aes) 272 lazy_refcounts=<bool (on/off)> - Postpone refcount updates 273 preallocation=<str> - Preallocation mode (allowed values: off, metadata, falloc, full) 274 refcount_bits=<num> - Width of a reference count entry in bits 275 size=<size> - Virtual disk size 276 277The protocol level may support further options. 278Specify the target filename to include those options. 279 280Testing: create -o help 281Supported raw options: 282 size=<size> - Virtual disk size 283 284The protocol level may support further options. 285Specify the target filename to include those options. 286 287Testing: create -f bochs -o help 288qemu-img: Format driver 'bochs' does not support image creation 289 290=== convert: Options specified more than once === 291 292Testing: create -f qcow2 TEST_DIR/t.qcow2 128M 293Formatting 'TEST_DIR/t.qcow2', fmt=qcow2 size=134217728 cluster_size=65536 lazy_refcounts=off refcount_bits=16 compression_type=zlib 294 295Testing: convert -f foo -f qcow2 TEST_DIR/t.qcow2 TEST_DIR/t.qcow2.base 296image: TEST_DIR/t.IMGFMT.base 297file format: raw 298virtual size: 128 MiB (134217728 bytes) 299 300Testing: convert -O foo -O qcow2 TEST_DIR/t.qcow2 TEST_DIR/t.qcow2.base 301image: TEST_DIR/t.IMGFMT.base 302file format: IMGFMT 303virtual size: 128 MiB (134217728 bytes) 304cluster_size: 65536 305 306Testing: convert -O qcow2 -o cluster_size=4k -o lazy_refcounts=on TEST_DIR/t.qcow2 TEST_DIR/t.qcow2.base 307image: TEST_DIR/t.IMGFMT.base 308file format: IMGFMT 309virtual size: 128 MiB (134217728 bytes) 310cluster_size: 4096 311Format specific information: 312 compat: 1.1 313 compression type: zlib 314 lazy refcounts: true 315 refcount bits: 16 316 corrupt: false 317 318Testing: convert -O qcow2 -o cluster_size=4k -o lazy_refcounts=on -o cluster_size=8k TEST_DIR/t.qcow2 TEST_DIR/t.qcow2.base 319image: TEST_DIR/t.IMGFMT.base 320file format: IMGFMT 321virtual size: 128 MiB (134217728 bytes) 322cluster_size: 8192 323Format specific information: 324 compat: 1.1 325 compression type: zlib 326 lazy refcounts: true 327 refcount bits: 16 328 corrupt: false 329 330Testing: convert -O qcow2 -o cluster_size=4k,cluster_size=8k TEST_DIR/t.qcow2 TEST_DIR/t.qcow2.base 331image: TEST_DIR/t.IMGFMT.base 332file format: IMGFMT 333virtual size: 128 MiB (134217728 bytes) 334cluster_size: 8192 335 336=== convert: help for -o === 337 338Testing: convert -O qcow2 -o help TEST_DIR/t.qcow2 TEST_DIR/t.qcow2.base 339Supported options: 340 backing_file=<str> - File name of a base image 341 backing_fmt=<str> - Image format of the base image 342 cluster_size=<size> - qcow2 cluster size 343 compat=<str> - Compatibility level (v2 [0.10] or v3 [1.1]) 344 compression_type=<str> - Compression method used for image cluster compression 345 data_file=<str> - File name of an external data file 346 data_file_raw=<bool (on/off)> - The external data file must stay valid as a raw image 347 encrypt.cipher-alg=<str> - Name of encryption cipher algorithm 348 encrypt.cipher-mode=<str> - Name of encryption cipher mode 349 encrypt.format=<str> - Encrypt the image, format choices: 'aes', 'luks' 350 encrypt.hash-alg=<str> - Name of encryption hash algorithm 351 encrypt.iter-time=<num> - Time to spend in PBKDF in milliseconds 352 encrypt.ivgen-alg=<str> - Name of IV generator algorithm 353 encrypt.ivgen-hash-alg=<str> - Name of IV generator hash algorithm 354 encrypt.key-secret=<str> - ID of secret providing qcow AES key or LUKS passphrase 355 encryption=<bool (on/off)> - Encrypt the image with format 'aes'. (Deprecated in favor of encrypt.format=aes) 356 lazy_refcounts=<bool (on/off)> - Postpone refcount updates 357 nocow=<bool (on/off)> - Turn off copy-on-write (valid only on btrfs) 358 preallocation=<str> - Preallocation mode (allowed values: off, metadata, falloc, full) 359 refcount_bits=<num> - Width of a reference count entry in bits 360 size=<size> - Virtual disk size 361 362Testing: convert -O qcow2 -o ? TEST_DIR/t.qcow2 TEST_DIR/t.qcow2.base 363Supported options: 364 backing_file=<str> - File name of a base image 365 backing_fmt=<str> - Image format of the base image 366 cluster_size=<size> - qcow2 cluster size 367 compat=<str> - Compatibility level (v2 [0.10] or v3 [1.1]) 368 compression_type=<str> - Compression method used for image cluster compression 369 data_file=<str> - File name of an external data file 370 data_file_raw=<bool (on/off)> - The external data file must stay valid as a raw image 371 encrypt.cipher-alg=<str> - Name of encryption cipher algorithm 372 encrypt.cipher-mode=<str> - Name of encryption cipher mode 373 encrypt.format=<str> - Encrypt the image, format choices: 'aes', 'luks' 374 encrypt.hash-alg=<str> - Name of encryption hash algorithm 375 encrypt.iter-time=<num> - Time to spend in PBKDF in milliseconds 376 encrypt.ivgen-alg=<str> - Name of IV generator algorithm 377 encrypt.ivgen-hash-alg=<str> - Name of IV generator hash algorithm 378 encrypt.key-secret=<str> - ID of secret providing qcow AES key or LUKS passphrase 379 encryption=<bool (on/off)> - Encrypt the image with format 'aes'. (Deprecated in favor of encrypt.format=aes) 380 lazy_refcounts=<bool (on/off)> - Postpone refcount updates 381 nocow=<bool (on/off)> - Turn off copy-on-write (valid only on btrfs) 382 preallocation=<str> - Preallocation mode (allowed values: off, metadata, falloc, full) 383 refcount_bits=<num> - Width of a reference count entry in bits 384 size=<size> - Virtual disk size 385 386Testing: convert -O qcow2 -o cluster_size=4k,help TEST_DIR/t.qcow2 TEST_DIR/t.qcow2.base 387Supported options: 388 backing_file=<str> - File name of a base image 389 backing_fmt=<str> - Image format of the base image 390 cluster_size=<size> - qcow2 cluster size 391 compat=<str> - Compatibility level (v2 [0.10] or v3 [1.1]) 392 compression_type=<str> - Compression method used for image cluster compression 393 data_file=<str> - File name of an external data file 394 data_file_raw=<bool (on/off)> - The external data file must stay valid as a raw image 395 encrypt.cipher-alg=<str> - Name of encryption cipher algorithm 396 encrypt.cipher-mode=<str> - Name of encryption cipher mode 397 encrypt.format=<str> - Encrypt the image, format choices: 'aes', 'luks' 398 encrypt.hash-alg=<str> - Name of encryption hash algorithm 399 encrypt.iter-time=<num> - Time to spend in PBKDF in milliseconds 400 encrypt.ivgen-alg=<str> - Name of IV generator algorithm 401 encrypt.ivgen-hash-alg=<str> - Name of IV generator hash algorithm 402 encrypt.key-secret=<str> - ID of secret providing qcow AES key or LUKS passphrase 403 encryption=<bool (on/off)> - Encrypt the image with format 'aes'. (Deprecated in favor of encrypt.format=aes) 404 lazy_refcounts=<bool (on/off)> - Postpone refcount updates 405 nocow=<bool (on/off)> - Turn off copy-on-write (valid only on btrfs) 406 preallocation=<str> - Preallocation mode (allowed values: off, metadata, falloc, full) 407 refcount_bits=<num> - Width of a reference count entry in bits 408 size=<size> - Virtual disk size 409 410Testing: convert -O qcow2 -o cluster_size=4k,? TEST_DIR/t.qcow2 TEST_DIR/t.qcow2.base 411Supported options: 412 backing_file=<str> - File name of a base image 413 backing_fmt=<str> - Image format of the base image 414 cluster_size=<size> - qcow2 cluster size 415 compat=<str> - Compatibility level (v2 [0.10] or v3 [1.1]) 416 compression_type=<str> - Compression method used for image cluster compression 417 data_file=<str> - File name of an external data file 418 data_file_raw=<bool (on/off)> - The external data file must stay valid as a raw image 419 encrypt.cipher-alg=<str> - Name of encryption cipher algorithm 420 encrypt.cipher-mode=<str> - Name of encryption cipher mode 421 encrypt.format=<str> - Encrypt the image, format choices: 'aes', 'luks' 422 encrypt.hash-alg=<str> - Name of encryption hash algorithm 423 encrypt.iter-time=<num> - Time to spend in PBKDF in milliseconds 424 encrypt.ivgen-alg=<str> - Name of IV generator algorithm 425 encrypt.ivgen-hash-alg=<str> - Name of IV generator hash algorithm 426 encrypt.key-secret=<str> - ID of secret providing qcow AES key or LUKS passphrase 427 encryption=<bool (on/off)> - Encrypt the image with format 'aes'. (Deprecated in favor of encrypt.format=aes) 428 lazy_refcounts=<bool (on/off)> - Postpone refcount updates 429 nocow=<bool (on/off)> - Turn off copy-on-write (valid only on btrfs) 430 preallocation=<str> - Preallocation mode (allowed values: off, metadata, falloc, full) 431 refcount_bits=<num> - Width of a reference count entry in bits 432 size=<size> - Virtual disk size 433 434Testing: convert -O qcow2 -o help,cluster_size=4k TEST_DIR/t.qcow2 TEST_DIR/t.qcow2.base 435Supported options: 436 backing_file=<str> - File name of a base image 437 backing_fmt=<str> - Image format of the base image 438 cluster_size=<size> - qcow2 cluster size 439 compat=<str> - Compatibility level (v2 [0.10] or v3 [1.1]) 440 compression_type=<str> - Compression method used for image cluster compression 441 data_file=<str> - File name of an external data file 442 data_file_raw=<bool (on/off)> - The external data file must stay valid as a raw image 443 encrypt.cipher-alg=<str> - Name of encryption cipher algorithm 444 encrypt.cipher-mode=<str> - Name of encryption cipher mode 445 encrypt.format=<str> - Encrypt the image, format choices: 'aes', 'luks' 446 encrypt.hash-alg=<str> - Name of encryption hash algorithm 447 encrypt.iter-time=<num> - Time to spend in PBKDF in milliseconds 448 encrypt.ivgen-alg=<str> - Name of IV generator algorithm 449 encrypt.ivgen-hash-alg=<str> - Name of IV generator hash algorithm 450 encrypt.key-secret=<str> - ID of secret providing qcow AES key or LUKS passphrase 451 encryption=<bool (on/off)> - Encrypt the image with format 'aes'. (Deprecated in favor of encrypt.format=aes) 452 lazy_refcounts=<bool (on/off)> - Postpone refcount updates 453 nocow=<bool (on/off)> - Turn off copy-on-write (valid only on btrfs) 454 preallocation=<str> - Preallocation mode (allowed values: off, metadata, falloc, full) 455 refcount_bits=<num> - Width of a reference count entry in bits 456 size=<size> - Virtual disk size 457 458Testing: convert -O qcow2 -o ?,cluster_size=4k TEST_DIR/t.qcow2 TEST_DIR/t.qcow2.base 459Supported options: 460 backing_file=<str> - File name of a base image 461 backing_fmt=<str> - Image format of the base image 462 cluster_size=<size> - qcow2 cluster size 463 compat=<str> - Compatibility level (v2 [0.10] or v3 [1.1]) 464 compression_type=<str> - Compression method used for image cluster compression 465 data_file=<str> - File name of an external data file 466 data_file_raw=<bool (on/off)> - The external data file must stay valid as a raw image 467 encrypt.cipher-alg=<str> - Name of encryption cipher algorithm 468 encrypt.cipher-mode=<str> - Name of encryption cipher mode 469 encrypt.format=<str> - Encrypt the image, format choices: 'aes', 'luks' 470 encrypt.hash-alg=<str> - Name of encryption hash algorithm 471 encrypt.iter-time=<num> - Time to spend in PBKDF in milliseconds 472 encrypt.ivgen-alg=<str> - Name of IV generator algorithm 473 encrypt.ivgen-hash-alg=<str> - Name of IV generator hash algorithm 474 encrypt.key-secret=<str> - ID of secret providing qcow AES key or LUKS passphrase 475 encryption=<bool (on/off)> - Encrypt the image with format 'aes'. (Deprecated in favor of encrypt.format=aes) 476 lazy_refcounts=<bool (on/off)> - Postpone refcount updates 477 nocow=<bool (on/off)> - Turn off copy-on-write (valid only on btrfs) 478 preallocation=<str> - Preallocation mode (allowed values: off, metadata, falloc, full) 479 refcount_bits=<num> - Width of a reference count entry in bits 480 size=<size> - Virtual disk size 481 482Testing: convert -O qcow2 -o cluster_size=4k -o help TEST_DIR/t.qcow2 TEST_DIR/t.qcow2.base 483Supported options: 484 backing_file=<str> - File name of a base image 485 backing_fmt=<str> - Image format of the base image 486 cluster_size=<size> - qcow2 cluster size 487 compat=<str> - Compatibility level (v2 [0.10] or v3 [1.1]) 488 compression_type=<str> - Compression method used for image cluster compression 489 data_file=<str> - File name of an external data file 490 data_file_raw=<bool (on/off)> - The external data file must stay valid as a raw image 491 encrypt.cipher-alg=<str> - Name of encryption cipher algorithm 492 encrypt.cipher-mode=<str> - Name of encryption cipher mode 493 encrypt.format=<str> - Encrypt the image, format choices: 'aes', 'luks' 494 encrypt.hash-alg=<str> - Name of encryption hash algorithm 495 encrypt.iter-time=<num> - Time to spend in PBKDF in milliseconds 496 encrypt.ivgen-alg=<str> - Name of IV generator algorithm 497 encrypt.ivgen-hash-alg=<str> - Name of IV generator hash algorithm 498 encrypt.key-secret=<str> - ID of secret providing qcow AES key or LUKS passphrase 499 encryption=<bool (on/off)> - Encrypt the image with format 'aes'. (Deprecated in favor of encrypt.format=aes) 500 lazy_refcounts=<bool (on/off)> - Postpone refcount updates 501 nocow=<bool (on/off)> - Turn off copy-on-write (valid only on btrfs) 502 preallocation=<str> - Preallocation mode (allowed values: off, metadata, falloc, full) 503 refcount_bits=<num> - Width of a reference count entry in bits 504 size=<size> - Virtual disk size 505 506Testing: convert -O qcow2 -o cluster_size=4k -o ? TEST_DIR/t.qcow2 TEST_DIR/t.qcow2.base 507Supported options: 508 backing_file=<str> - File name of a base image 509 backing_fmt=<str> - Image format of the base image 510 cluster_size=<size> - qcow2 cluster size 511 compat=<str> - Compatibility level (v2 [0.10] or v3 [1.1]) 512 compression_type=<str> - Compression method used for image cluster compression 513 data_file=<str> - File name of an external data file 514 data_file_raw=<bool (on/off)> - The external data file must stay valid as a raw image 515 encrypt.cipher-alg=<str> - Name of encryption cipher algorithm 516 encrypt.cipher-mode=<str> - Name of encryption cipher mode 517 encrypt.format=<str> - Encrypt the image, format choices: 'aes', 'luks' 518 encrypt.hash-alg=<str> - Name of encryption hash algorithm 519 encrypt.iter-time=<num> - Time to spend in PBKDF in milliseconds 520 encrypt.ivgen-alg=<str> - Name of IV generator algorithm 521 encrypt.ivgen-hash-alg=<str> - Name of IV generator hash algorithm 522 encrypt.key-secret=<str> - ID of secret providing qcow AES key or LUKS passphrase 523 encryption=<bool (on/off)> - Encrypt the image with format 'aes'. (Deprecated in favor of encrypt.format=aes) 524 lazy_refcounts=<bool (on/off)> - Postpone refcount updates 525 nocow=<bool (on/off)> - Turn off copy-on-write (valid only on btrfs) 526 preallocation=<str> - Preallocation mode (allowed values: off, metadata, falloc, full) 527 refcount_bits=<num> - Width of a reference count entry in bits 528 size=<size> - Virtual disk size 529 530Testing: convert -O qcow2 -o backing_file=TEST_DIR/t.qcow2,,help TEST_DIR/t.qcow2 TEST_DIR/t.qcow2.base 531qemu-img: Could not open 'TEST_DIR/t.qcow2.base': Could not open backing file: Could not open 'TEST_DIR/t.qcow2,help': No such file or directory 532 533Testing: convert -O qcow2 -o backing_file=TEST_DIR/t.qcow2,,? TEST_DIR/t.qcow2 TEST_DIR/t.qcow2.base 534qemu-img: Could not open 'TEST_DIR/t.qcow2.base': Could not open backing file: Could not open 'TEST_DIR/t.qcow2,?': No such file or directory 535 536Testing: convert -O qcow2 -o backing_file=TEST_DIR/t.qcow2, -o help TEST_DIR/t.qcow2 TEST_DIR/t.qcow2.base 537qemu-img: Invalid option list: backing_file=TEST_DIR/t.qcow2, 538 539Testing: convert -O qcow2 -o backing_file=TEST_DIR/t.qcow2 -o ,help TEST_DIR/t.qcow2 TEST_DIR/t.qcow2.base 540qemu-img: Invalid option list: ,help 541 542Testing: convert -O qcow2 -o backing_file=TEST_DIR/t.qcow2 -o ,, -o help TEST_DIR/t.qcow2 TEST_DIR/t.qcow2.base 543qemu-img: Invalid option list: ,, 544 545Testing: convert -O qcow2 -o help 546Supported qcow2 options: 547 backing_file=<str> - File name of a base image 548 backing_fmt=<str> - Image format of the base image 549 cluster_size=<size> - qcow2 cluster size 550 compat=<str> - Compatibility level (v2 [0.10] or v3 [1.1]) 551 compression_type=<str> - Compression method used for image cluster compression 552 data_file=<str> - File name of an external data file 553 data_file_raw=<bool (on/off)> - The external data file must stay valid as a raw image 554 encrypt.cipher-alg=<str> - Name of encryption cipher algorithm 555 encrypt.cipher-mode=<str> - Name of encryption cipher mode 556 encrypt.format=<str> - Encrypt the image, format choices: 'aes', 'luks' 557 encrypt.hash-alg=<str> - Name of encryption hash algorithm 558 encrypt.iter-time=<num> - Time to spend in PBKDF in milliseconds 559 encrypt.ivgen-alg=<str> - Name of IV generator algorithm 560 encrypt.ivgen-hash-alg=<str> - Name of IV generator hash algorithm 561 encrypt.key-secret=<str> - ID of secret providing qcow AES key or LUKS passphrase 562 encryption=<bool (on/off)> - Encrypt the image with format 'aes'. (Deprecated in favor of encrypt.format=aes) 563 lazy_refcounts=<bool (on/off)> - Postpone refcount updates 564 preallocation=<str> - Preallocation mode (allowed values: off, metadata, falloc, full) 565 refcount_bits=<num> - Width of a reference count entry in bits 566 size=<size> - Virtual disk size 567 568The protocol level may support further options. 569Specify the target filename to include those options. 570 571Testing: convert -o help 572Supported raw options: 573 size=<size> - Virtual disk size 574 575The protocol level may support further options. 576Specify the target filename to include those options. 577 578Testing: convert -O bochs -o help 579qemu-img: Format driver 'bochs' does not support image creation 580 581=== convert: -C and other options === 582 583Testing: convert -C -S 4k -O qcow2 TEST_DIR/t.qcow2 TEST_DIR/t.qcow2.target 584qemu-img: Cannot enable copy offloading when -S is used 585 586Testing: convert -C -S 8k -O qcow2 TEST_DIR/t.qcow2 TEST_DIR/t.qcow2.target 587qemu-img: Cannot enable copy offloading when -S is used 588 589Testing: convert -C -c -O qcow2 TEST_DIR/t.qcow2 TEST_DIR/t.qcow2.target 590qemu-img: Cannot enable copy offloading when -c is used 591 592Testing: convert -C --salvage -O qcow2 TEST_DIR/t.qcow2 TEST_DIR/t.qcow2.target 593qemu-img: Cannot use copy offloading in salvaging mode 594 595=== amend: Options specified more than once === 596 597Testing: amend -f foo -f qcow2 -o lazy_refcounts=on TEST_DIR/t.qcow2 598image: TEST_DIR/t.IMGFMT 599file format: IMGFMT 600virtual size: 128 MiB (134217728 bytes) 601cluster_size: 65536 602Format specific information: 603 compat: 1.1 604 compression type: zlib 605 lazy refcounts: true 606 refcount bits: 16 607 corrupt: false 608 609Testing: amend -f qcow2 -o size=130M -o lazy_refcounts=off TEST_DIR/t.qcow2 610image: TEST_DIR/t.IMGFMT 611file format: IMGFMT 612virtual size: 130 MiB (136314880 bytes) 613cluster_size: 65536 614Format specific information: 615 compat: 1.1 616 compression type: zlib 617 lazy refcounts: false 618 refcount bits: 16 619 corrupt: false 620 621Testing: amend -f qcow2 -o size=8M -o lazy_refcounts=on -o size=132M TEST_DIR/t.qcow2 622image: TEST_DIR/t.IMGFMT 623file format: IMGFMT 624virtual size: 132 MiB (138412032 bytes) 625cluster_size: 65536 626Format specific information: 627 compat: 1.1 628 compression type: zlib 629 lazy refcounts: true 630 refcount bits: 16 631 corrupt: false 632 633Testing: amend -f qcow2 -o size=4M,size=148M TEST_DIR/t.qcow2 634image: TEST_DIR/t.IMGFMT 635file format: IMGFMT 636virtual size: 148 MiB (155189248 bytes) 637cluster_size: 65536 638 639=== amend: help for -o === 640 641Testing: amend -f qcow2 -o help TEST_DIR/t.qcow2 642Creation options for 'qcow2': 643 backing_file=<str> - File name of a base image 644 backing_fmt=<str> - Image format of the base image 645 cluster_size=<size> - qcow2 cluster size 646 compat=<str> - Compatibility level (v2 [0.10] or v3 [1.1]) 647 compression_type=<str> - Compression method used for image cluster compression 648 data_file=<str> - File name of an external data file 649 data_file_raw=<bool (on/off)> - The external data file must stay valid as a raw image 650 encrypt.cipher-alg=<str> - Name of encryption cipher algorithm 651 encrypt.cipher-mode=<str> - Name of encryption cipher mode 652 encrypt.format=<str> - Encrypt the image, format choices: 'aes', 'luks' 653 encrypt.hash-alg=<str> - Name of encryption hash algorithm 654 encrypt.iter-time=<num> - Time to spend in PBKDF in milliseconds 655 encrypt.ivgen-alg=<str> - Name of IV generator algorithm 656 encrypt.ivgen-hash-alg=<str> - Name of IV generator hash algorithm 657 encrypt.key-secret=<str> - ID of secret providing qcow AES key or LUKS passphrase 658 encryption=<bool (on/off)> - Encrypt the image with format 'aes'. (Deprecated in favor of encrypt.format=aes) 659 lazy_refcounts=<bool (on/off)> - Postpone refcount updates 660 preallocation=<str> - Preallocation mode (allowed values: off, metadata, falloc, full) 661 refcount_bits=<num> - Width of a reference count entry in bits 662 size=<size> - Virtual disk size 663 664Note that not all of these options may be amendable. 665 666Testing: amend -f qcow2 -o ? TEST_DIR/t.qcow2 667Creation options for 'qcow2': 668 backing_file=<str> - File name of a base image 669 backing_fmt=<str> - Image format of the base image 670 cluster_size=<size> - qcow2 cluster size 671 compat=<str> - Compatibility level (v2 [0.10] or v3 [1.1]) 672 compression_type=<str> - Compression method used for image cluster compression 673 data_file=<str> - File name of an external data file 674 data_file_raw=<bool (on/off)> - The external data file must stay valid as a raw image 675 encrypt.cipher-alg=<str> - Name of encryption cipher algorithm 676 encrypt.cipher-mode=<str> - Name of encryption cipher mode 677 encrypt.format=<str> - Encrypt the image, format choices: 'aes', 'luks' 678 encrypt.hash-alg=<str> - Name of encryption hash algorithm 679 encrypt.iter-time=<num> - Time to spend in PBKDF in milliseconds 680 encrypt.ivgen-alg=<str> - Name of IV generator algorithm 681 encrypt.ivgen-hash-alg=<str> - Name of IV generator hash algorithm 682 encrypt.key-secret=<str> - ID of secret providing qcow AES key or LUKS passphrase 683 encryption=<bool (on/off)> - Encrypt the image with format 'aes'. (Deprecated in favor of encrypt.format=aes) 684 lazy_refcounts=<bool (on/off)> - Postpone refcount updates 685 preallocation=<str> - Preallocation mode (allowed values: off, metadata, falloc, full) 686 refcount_bits=<num> - Width of a reference count entry in bits 687 size=<size> - Virtual disk size 688 689Note that not all of these options may be amendable. 690 691Testing: amend -f qcow2 -o cluster_size=4k,help TEST_DIR/t.qcow2 692Creation options for 'qcow2': 693 backing_file=<str> - File name of a base image 694 backing_fmt=<str> - Image format of the base image 695 cluster_size=<size> - qcow2 cluster size 696 compat=<str> - Compatibility level (v2 [0.10] or v3 [1.1]) 697 compression_type=<str> - Compression method used for image cluster compression 698 data_file=<str> - File name of an external data file 699 data_file_raw=<bool (on/off)> - The external data file must stay valid as a raw image 700 encrypt.cipher-alg=<str> - Name of encryption cipher algorithm 701 encrypt.cipher-mode=<str> - Name of encryption cipher mode 702 encrypt.format=<str> - Encrypt the image, format choices: 'aes', 'luks' 703 encrypt.hash-alg=<str> - Name of encryption hash algorithm 704 encrypt.iter-time=<num> - Time to spend in PBKDF in milliseconds 705 encrypt.ivgen-alg=<str> - Name of IV generator algorithm 706 encrypt.ivgen-hash-alg=<str> - Name of IV generator hash algorithm 707 encrypt.key-secret=<str> - ID of secret providing qcow AES key or LUKS passphrase 708 encryption=<bool (on/off)> - Encrypt the image with format 'aes'. (Deprecated in favor of encrypt.format=aes) 709 lazy_refcounts=<bool (on/off)> - Postpone refcount updates 710 preallocation=<str> - Preallocation mode (allowed values: off, metadata, falloc, full) 711 refcount_bits=<num> - Width of a reference count entry in bits 712 size=<size> - Virtual disk size 713 714Note that not all of these options may be amendable. 715 716Testing: amend -f qcow2 -o cluster_size=4k,? TEST_DIR/t.qcow2 717Creation options for 'qcow2': 718 backing_file=<str> - File name of a base image 719 backing_fmt=<str> - Image format of the base image 720 cluster_size=<size> - qcow2 cluster size 721 compat=<str> - Compatibility level (v2 [0.10] or v3 [1.1]) 722 compression_type=<str> - Compression method used for image cluster compression 723 data_file=<str> - File name of an external data file 724 data_file_raw=<bool (on/off)> - The external data file must stay valid as a raw image 725 encrypt.cipher-alg=<str> - Name of encryption cipher algorithm 726 encrypt.cipher-mode=<str> - Name of encryption cipher mode 727 encrypt.format=<str> - Encrypt the image, format choices: 'aes', 'luks' 728 encrypt.hash-alg=<str> - Name of encryption hash algorithm 729 encrypt.iter-time=<num> - Time to spend in PBKDF in milliseconds 730 encrypt.ivgen-alg=<str> - Name of IV generator algorithm 731 encrypt.ivgen-hash-alg=<str> - Name of IV generator hash algorithm 732 encrypt.key-secret=<str> - ID of secret providing qcow AES key or LUKS passphrase 733 encryption=<bool (on/off)> - Encrypt the image with format 'aes'. (Deprecated in favor of encrypt.format=aes) 734 lazy_refcounts=<bool (on/off)> - Postpone refcount updates 735 preallocation=<str> - Preallocation mode (allowed values: off, metadata, falloc, full) 736 refcount_bits=<num> - Width of a reference count entry in bits 737 size=<size> - Virtual disk size 738 739Note that not all of these options may be amendable. 740 741Testing: amend -f qcow2 -o help,cluster_size=4k TEST_DIR/t.qcow2 742Creation options for 'qcow2': 743 backing_file=<str> - File name of a base image 744 backing_fmt=<str> - Image format of the base image 745 cluster_size=<size> - qcow2 cluster size 746 compat=<str> - Compatibility level (v2 [0.10] or v3 [1.1]) 747 compression_type=<str> - Compression method used for image cluster compression 748 data_file=<str> - File name of an external data file 749 data_file_raw=<bool (on/off)> - The external data file must stay valid as a raw image 750 encrypt.cipher-alg=<str> - Name of encryption cipher algorithm 751 encrypt.cipher-mode=<str> - Name of encryption cipher mode 752 encrypt.format=<str> - Encrypt the image, format choices: 'aes', 'luks' 753 encrypt.hash-alg=<str> - Name of encryption hash algorithm 754 encrypt.iter-time=<num> - Time to spend in PBKDF in milliseconds 755 encrypt.ivgen-alg=<str> - Name of IV generator algorithm 756 encrypt.ivgen-hash-alg=<str> - Name of IV generator hash algorithm 757 encrypt.key-secret=<str> - ID of secret providing qcow AES key or LUKS passphrase 758 encryption=<bool (on/off)> - Encrypt the image with format 'aes'. (Deprecated in favor of encrypt.format=aes) 759 lazy_refcounts=<bool (on/off)> - Postpone refcount updates 760 preallocation=<str> - Preallocation mode (allowed values: off, metadata, falloc, full) 761 refcount_bits=<num> - Width of a reference count entry in bits 762 size=<size> - Virtual disk size 763 764Note that not all of these options may be amendable. 765 766Testing: amend -f qcow2 -o ?,cluster_size=4k TEST_DIR/t.qcow2 767Creation options for 'qcow2': 768 backing_file=<str> - File name of a base image 769 backing_fmt=<str> - Image format of the base image 770 cluster_size=<size> - qcow2 cluster size 771 compat=<str> - Compatibility level (v2 [0.10] or v3 [1.1]) 772 compression_type=<str> - Compression method used for image cluster compression 773 data_file=<str> - File name of an external data file 774 data_file_raw=<bool (on/off)> - The external data file must stay valid as a raw image 775 encrypt.cipher-alg=<str> - Name of encryption cipher algorithm 776 encrypt.cipher-mode=<str> - Name of encryption cipher mode 777 encrypt.format=<str> - Encrypt the image, format choices: 'aes', 'luks' 778 encrypt.hash-alg=<str> - Name of encryption hash algorithm 779 encrypt.iter-time=<num> - Time to spend in PBKDF in milliseconds 780 encrypt.ivgen-alg=<str> - Name of IV generator algorithm 781 encrypt.ivgen-hash-alg=<str> - Name of IV generator hash algorithm 782 encrypt.key-secret=<str> - ID of secret providing qcow AES key or LUKS passphrase 783 encryption=<bool (on/off)> - Encrypt the image with format 'aes'. (Deprecated in favor of encrypt.format=aes) 784 lazy_refcounts=<bool (on/off)> - Postpone refcount updates 785 preallocation=<str> - Preallocation mode (allowed values: off, metadata, falloc, full) 786 refcount_bits=<num> - Width of a reference count entry in bits 787 size=<size> - Virtual disk size 788 789Note that not all of these options may be amendable. 790 791Testing: amend -f qcow2 -o cluster_size=4k -o help TEST_DIR/t.qcow2 792Creation options for 'qcow2': 793 backing_file=<str> - File name of a base image 794 backing_fmt=<str> - Image format of the base image 795 cluster_size=<size> - qcow2 cluster size 796 compat=<str> - Compatibility level (v2 [0.10] or v3 [1.1]) 797 compression_type=<str> - Compression method used for image cluster compression 798 data_file=<str> - File name of an external data file 799 data_file_raw=<bool (on/off)> - The external data file must stay valid as a raw image 800 encrypt.cipher-alg=<str> - Name of encryption cipher algorithm 801 encrypt.cipher-mode=<str> - Name of encryption cipher mode 802 encrypt.format=<str> - Encrypt the image, format choices: 'aes', 'luks' 803 encrypt.hash-alg=<str> - Name of encryption hash algorithm 804 encrypt.iter-time=<num> - Time to spend in PBKDF in milliseconds 805 encrypt.ivgen-alg=<str> - Name of IV generator algorithm 806 encrypt.ivgen-hash-alg=<str> - Name of IV generator hash algorithm 807 encrypt.key-secret=<str> - ID of secret providing qcow AES key or LUKS passphrase 808 encryption=<bool (on/off)> - Encrypt the image with format 'aes'. (Deprecated in favor of encrypt.format=aes) 809 lazy_refcounts=<bool (on/off)> - Postpone refcount updates 810 preallocation=<str> - Preallocation mode (allowed values: off, metadata, falloc, full) 811 refcount_bits=<num> - Width of a reference count entry in bits 812 size=<size> - Virtual disk size 813 814Note that not all of these options may be amendable. 815 816Testing: amend -f qcow2 -o cluster_size=4k -o ? TEST_DIR/t.qcow2 817Creation options for 'qcow2': 818 backing_file=<str> - File name of a base image 819 backing_fmt=<str> - Image format of the base image 820 cluster_size=<size> - qcow2 cluster size 821 compat=<str> - Compatibility level (v2 [0.10] or v3 [1.1]) 822 compression_type=<str> - Compression method used for image cluster compression 823 data_file=<str> - File name of an external data file 824 data_file_raw=<bool (on/off)> - The external data file must stay valid as a raw image 825 encrypt.cipher-alg=<str> - Name of encryption cipher algorithm 826 encrypt.cipher-mode=<str> - Name of encryption cipher mode 827 encrypt.format=<str> - Encrypt the image, format choices: 'aes', 'luks' 828 encrypt.hash-alg=<str> - Name of encryption hash algorithm 829 encrypt.iter-time=<num> - Time to spend in PBKDF in milliseconds 830 encrypt.ivgen-alg=<str> - Name of IV generator algorithm 831 encrypt.ivgen-hash-alg=<str> - Name of IV generator hash algorithm 832 encrypt.key-secret=<str> - ID of secret providing qcow AES key or LUKS passphrase 833 encryption=<bool (on/off)> - Encrypt the image with format 'aes'. (Deprecated in favor of encrypt.format=aes) 834 lazy_refcounts=<bool (on/off)> - Postpone refcount updates 835 preallocation=<str> - Preallocation mode (allowed values: off, metadata, falloc, full) 836 refcount_bits=<num> - Width of a reference count entry in bits 837 size=<size> - Virtual disk size 838 839Note that not all of these options may be amendable. 840 841Testing: amend -f qcow2 -o backing_file=TEST_DIR/t.qcow2,,help TEST_DIR/t.qcow2 842 843Testing: rebase -u -b -f qcow2 TEST_DIR/t.qcow2 844 845Testing: amend -f qcow2 -o backing_file=TEST_DIR/t.qcow2,,? TEST_DIR/t.qcow2 846 847Testing: rebase -u -b -f qcow2 TEST_DIR/t.qcow2 848 849Testing: amend -f qcow2 -o backing_file=TEST_DIR/t.qcow2, -o help TEST_DIR/t.qcow2 850qemu-img: Invalid option list: backing_file=TEST_DIR/t.qcow2, 851 852Testing: amend -f qcow2 -o backing_file=TEST_DIR/t.qcow2 -o ,help TEST_DIR/t.qcow2 853qemu-img: Invalid option list: ,help 854 855Testing: amend -f qcow2 -o backing_file=TEST_DIR/t.qcow2 -o ,, -o help TEST_DIR/t.qcow2 856qemu-img: Invalid option list: ,, 857 858Testing: amend -f qcow2 -o help 859Creation options for 'qcow2': 860 backing_file=<str> - File name of a base image 861 backing_fmt=<str> - Image format of the base image 862 cluster_size=<size> - qcow2 cluster size 863 compat=<str> - Compatibility level (v2 [0.10] or v3 [1.1]) 864 compression_type=<str> - Compression method used for image cluster compression 865 data_file=<str> - File name of an external data file 866 data_file_raw=<bool (on/off)> - The external data file must stay valid as a raw image 867 encrypt.cipher-alg=<str> - Name of encryption cipher algorithm 868 encrypt.cipher-mode=<str> - Name of encryption cipher mode 869 encrypt.format=<str> - Encrypt the image, format choices: 'aes', 'luks' 870 encrypt.hash-alg=<str> - Name of encryption hash algorithm 871 encrypt.iter-time=<num> - Time to spend in PBKDF in milliseconds 872 encrypt.ivgen-alg=<str> - Name of IV generator algorithm 873 encrypt.ivgen-hash-alg=<str> - Name of IV generator hash algorithm 874 encrypt.key-secret=<str> - ID of secret providing qcow AES key or LUKS passphrase 875 encryption=<bool (on/off)> - Encrypt the image with format 'aes'. (Deprecated in favor of encrypt.format=aes) 876 lazy_refcounts=<bool (on/off)> - Postpone refcount updates 877 preallocation=<str> - Preallocation mode (allowed values: off, metadata, falloc, full) 878 refcount_bits=<num> - Width of a reference count entry in bits 879 size=<size> - Virtual disk size 880 881Note that not all of these options may be amendable. 882 883Testing: amend -o help 884qemu-img: Expecting one image file name 885 886Testing: amend -f bochs -o help 887qemu-img: Format driver 'bochs' does not support option amendment 888*** done 889