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