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