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