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