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