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