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