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