]>
Commit | Line | Data |
---|---|---|
a33cc31d KW |
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 | |
0cb8d47b | 6 | Formatting 'TEST_DIR/t.qcow2', fmt=qcow2 size=134217728 cluster_size=65536 lazy_refcounts=off refcount_bits=16 |
1b53eab2 HR |
7 | image: TEST_DIR/t.IMGFMT |
8 | file format: IMGFMT | |
de38b500 | 9 | virtual size: 128 MiB (134217728 bytes) |
a33cc31d | 10 | cluster_size: 65536 |
a33cc31d KW |
11 | |
12 | Testing: create -f qcow2 -o cluster_size=4k -o lazy_refcounts=on TEST_DIR/t.qcow2 128M | |
0cb8d47b | 13 | Formatting 'TEST_DIR/t.qcow2', fmt=qcow2 size=134217728 cluster_size=4096 lazy_refcounts=on refcount_bits=16 |
d1103231 MM |
14 | image: TEST_DIR/t.IMGFMT |
15 | file format: IMGFMT | |
de38b500 | 16 | virtual size: 128 MiB (134217728 bytes) |
a33cc31d KW |
17 | cluster_size: 4096 |
18 | Format specific information: | |
19 | compat: 1.1 | |
20 | lazy refcounts: true | |
0709c5a1 | 21 | refcount bits: 16 |
9009b196 | 22 | corrupt: false |
a33cc31d KW |
23 | |
24 | Testing: create -f qcow2 -o cluster_size=4k -o lazy_refcounts=on -o cluster_size=8k TEST_DIR/t.qcow2 128M | |
0cb8d47b | 25 | Formatting 'TEST_DIR/t.qcow2', fmt=qcow2 size=134217728 cluster_size=8192 lazy_refcounts=on refcount_bits=16 |
d1103231 MM |
26 | image: TEST_DIR/t.IMGFMT |
27 | file format: IMGFMT | |
de38b500 | 28 | virtual size: 128 MiB (134217728 bytes) |
a33cc31d KW |
29 | cluster_size: 8192 |
30 | Format specific information: | |
31 | compat: 1.1 | |
32 | lazy refcounts: true | |
0709c5a1 | 33 | refcount bits: 16 |
9009b196 | 34 | corrupt: false |
a33cc31d KW |
35 | |
36 | Testing: create -f qcow2 -o cluster_size=4k,cluster_size=8k TEST_DIR/t.qcow2 128M | |
0cb8d47b | 37 | Formatting 'TEST_DIR/t.qcow2', fmt=qcow2 size=134217728 cluster_size=8192 lazy_refcounts=off refcount_bits=16 |
1b53eab2 HR |
38 | image: TEST_DIR/t.IMGFMT |
39 | file format: IMGFMT | |
de38b500 | 40 | virtual size: 128 MiB (134217728 bytes) |
a33cc31d | 41 | cluster_size: 8192 |
a33cc31d KW |
42 | |
43 | === create: help for -o === | |
44 | ||
45 | Testing: create -f qcow2 -o help TEST_DIR/t.qcow2 128M | |
46 | Supported 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 | |
68 | Testing: create -f qcow2 -o ? TEST_DIR/t.qcow2 128M | |
69 | Supported 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 | |
91 | Testing: create -f qcow2 -o cluster_size=4k,help TEST_DIR/t.qcow2 128M | |
92 | Supported 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 | |
114 | Testing: create -f qcow2 -o cluster_size=4k,? TEST_DIR/t.qcow2 128M | |
115 | Supported 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 | |
137 | Testing: create -f qcow2 -o help,cluster_size=4k TEST_DIR/t.qcow2 128M | |
138 | Supported 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 | |
160 | Testing: create -f qcow2 -o ?,cluster_size=4k TEST_DIR/t.qcow2 128M | |
161 | Supported 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 | |
183 | Testing: create -f qcow2 -o cluster_size=4k -o help TEST_DIR/t.qcow2 128M | |
184 | Supported 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 | |
206 | Testing: create -f qcow2 -o cluster_size=4k -o ? TEST_DIR/t.qcow2 128M | |
207 | Supported 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 | 229 | Testing: create -f qcow2 -u -o backing_file=TEST_DIR/t.qcow2,,help TEST_DIR/t.qcow2 128M |
0cb8d47b | 230 | Formatting '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 | 232 | Testing: create -f qcow2 -u -o backing_file=TEST_DIR/t.qcow2,,? TEST_DIR/t.qcow2 128M |
0cb8d47b | 233 | Formatting '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 | |
235 | Testing: create -f qcow2 -o backing_file=TEST_DIR/t.qcow2, -o help TEST_DIR/t.qcow2 128M | |
236 | qemu-img: Invalid option list: backing_file=TEST_DIR/t.qcow2, | |
237 | ||
238 | Testing: create -f qcow2 -o backing_file=TEST_DIR/t.qcow2 -o ,help TEST_DIR/t.qcow2 128M | |
239 | qemu-img: Invalid option list: ,help | |
240 | ||
241 | Testing: create -f qcow2 -o backing_file=TEST_DIR/t.qcow2 -o ,, -o help TEST_DIR/t.qcow2 128M | |
242 | qemu-img: Invalid option list: ,, | |
243 | ||
244 | Testing: create -f qcow2 -o help | |
f4619af0 | 245 | Supported 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 |
266 | The protocol level may support further options. |
267 | Specify the target filename to include those options. | |
268 | ||
a33cc31d | 269 | Testing: create -o help |
f4619af0 | 270 | Supported raw options: |
63898712 | 271 | size=<size> - Virtual disk size |
a33cc31d | 272 | |
f4619af0 HR |
273 | The protocol level may support further options. |
274 | Specify the target filename to include those options. | |
275 | ||
e53995eb HR |
276 | Testing: create -f bochs -o help |
277 | qemu-img: Format driver 'bochs' does not support image creation | |
278 | ||
a33cc31d KW |
279 | === convert: Options specified more than once === |
280 | ||
281 | Testing: create -f qcow2 TEST_DIR/t.qcow2 128M | |
0cb8d47b | 282 | Formatting 'TEST_DIR/t.qcow2', fmt=qcow2 size=134217728 cluster_size=65536 lazy_refcounts=off refcount_bits=16 |
a33cc31d KW |
283 | |
284 | Testing: convert -f foo -f qcow2 TEST_DIR/t.qcow2 TEST_DIR/t.qcow2.base | |
1b53eab2 | 285 | image: TEST_DIR/t.IMGFMT.base |
a33cc31d | 286 | file format: raw |
de38b500 | 287 | virtual size: 128 MiB (134217728 bytes) |
a33cc31d KW |
288 | |
289 | Testing: convert -O foo -O qcow2 TEST_DIR/t.qcow2 TEST_DIR/t.qcow2.base | |
1b53eab2 HR |
290 | image: TEST_DIR/t.IMGFMT.base |
291 | file format: IMGFMT | |
de38b500 | 292 | virtual size: 128 MiB (134217728 bytes) |
a33cc31d | 293 | cluster_size: 65536 |
a33cc31d KW |
294 | |
295 | Testing: convert -O qcow2 -o cluster_size=4k -o lazy_refcounts=on TEST_DIR/t.qcow2 TEST_DIR/t.qcow2.base | |
d1103231 MM |
296 | image: TEST_DIR/t.IMGFMT.base |
297 | file format: IMGFMT | |
de38b500 | 298 | virtual size: 128 MiB (134217728 bytes) |
a33cc31d KW |
299 | cluster_size: 4096 |
300 | Format specific information: | |
301 | compat: 1.1 | |
302 | lazy refcounts: true | |
0709c5a1 | 303 | refcount bits: 16 |
9009b196 | 304 | corrupt: false |
a33cc31d KW |
305 | |
306 | 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 | |
d1103231 MM |
307 | image: TEST_DIR/t.IMGFMT.base |
308 | file format: IMGFMT | |
de38b500 | 309 | virtual size: 128 MiB (134217728 bytes) |
a33cc31d KW |
310 | cluster_size: 8192 |
311 | Format specific information: | |
312 | compat: 1.1 | |
313 | lazy refcounts: true | |
0709c5a1 | 314 | refcount bits: 16 |
9009b196 | 315 | corrupt: false |
a33cc31d KW |
316 | |
317 | Testing: convert -O qcow2 -o cluster_size=4k,cluster_size=8k TEST_DIR/t.qcow2 TEST_DIR/t.qcow2.base | |
1b53eab2 HR |
318 | image: TEST_DIR/t.IMGFMT.base |
319 | file format: IMGFMT | |
de38b500 | 320 | virtual size: 128 MiB (134217728 bytes) |
a33cc31d | 321 | cluster_size: 8192 |
a33cc31d KW |
322 | |
323 | === convert: help for -o === | |
324 | ||
325 | Testing: convert -O qcow2 -o help TEST_DIR/t.qcow2 TEST_DIR/t.qcow2.base | |
326 | Supported 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 | |
348 | Testing: convert -O qcow2 -o ? TEST_DIR/t.qcow2 TEST_DIR/t.qcow2.base | |
349 | Supported 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 | |
371 | Testing: convert -O qcow2 -o cluster_size=4k,help TEST_DIR/t.qcow2 TEST_DIR/t.qcow2.base | |
372 | Supported 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 | |
394 | Testing: convert -O qcow2 -o cluster_size=4k,? TEST_DIR/t.qcow2 TEST_DIR/t.qcow2.base | |
395 | Supported 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 | |
417 | Testing: convert -O qcow2 -o help,cluster_size=4k TEST_DIR/t.qcow2 TEST_DIR/t.qcow2.base | |
418 | Supported 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 | |
440 | Testing: convert -O qcow2 -o ?,cluster_size=4k TEST_DIR/t.qcow2 TEST_DIR/t.qcow2.base | |
441 | Supported 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 | |
463 | Testing: convert -O qcow2 -o cluster_size=4k -o help TEST_DIR/t.qcow2 TEST_DIR/t.qcow2.base | |
464 | Supported 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 | |
486 | Testing: convert -O qcow2 -o cluster_size=4k -o ? TEST_DIR/t.qcow2 TEST_DIR/t.qcow2.base | |
487 | Supported 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 | |
509 | Testing: convert -O qcow2 -o backing_file=TEST_DIR/t.qcow2,,help TEST_DIR/t.qcow2 TEST_DIR/t.qcow2.base | |
510 | 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 | |
511 | ||
512 | Testing: convert -O qcow2 -o backing_file=TEST_DIR/t.qcow2,,? TEST_DIR/t.qcow2 TEST_DIR/t.qcow2.base | |
513 | 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 | |
514 | ||
515 | Testing: convert -O qcow2 -o backing_file=TEST_DIR/t.qcow2, -o help TEST_DIR/t.qcow2 TEST_DIR/t.qcow2.base | |
516 | qemu-img: Invalid option list: backing_file=TEST_DIR/t.qcow2, | |
517 | ||
518 | Testing: convert -O qcow2 -o backing_file=TEST_DIR/t.qcow2 -o ,help TEST_DIR/t.qcow2 TEST_DIR/t.qcow2.base | |
519 | qemu-img: Invalid option list: ,help | |
520 | ||
521 | Testing: convert -O qcow2 -o backing_file=TEST_DIR/t.qcow2 -o ,, -o help TEST_DIR/t.qcow2 TEST_DIR/t.qcow2.base | |
522 | qemu-img: Invalid option list: ,, | |
523 | ||
524 | Testing: convert -O qcow2 -o help | |
f4619af0 | 525 | Supported 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 |
546 | The protocol level may support further options. |
547 | Specify the target filename to include those options. | |
548 | ||
a33cc31d | 549 | Testing: convert -o help |
f4619af0 | 550 | Supported raw options: |
63898712 | 551 | size=<size> - Virtual disk size |
a33cc31d | 552 | |
f4619af0 HR |
553 | The protocol level may support further options. |
554 | Specify the target filename to include those options. | |
555 | ||
e53995eb HR |
556 | Testing: convert -O bochs -o help |
557 | qemu-img: Format driver 'bochs' does not support image creation | |
558 | ||
8ba4f10f FZ |
559 | === convert: -C and other options === |
560 | ||
561 | Testing: convert -C -S 4k -O qcow2 TEST_DIR/t.qcow2 TEST_DIR/t.qcow2.target | |
562 | qemu-img: Cannot enable copy offloading when -S is used | |
563 | ||
564 | Testing: convert -C -S 8k -O qcow2 TEST_DIR/t.qcow2 TEST_DIR/t.qcow2.target | |
565 | qemu-img: Cannot enable copy offloading when -S is used | |
566 | ||
567 | Testing: convert -C -c -O qcow2 TEST_DIR/t.qcow2 TEST_DIR/t.qcow2.target | |
568 | qemu-img: Cannot enable copy offloading when -c is used | |
569 | ||
a33cc31d KW |
570 | === amend: Options specified more than once === |
571 | ||
572 | Testing: amend -f foo -f qcow2 -o lazy_refcounts=on TEST_DIR/t.qcow2 | |
d1103231 MM |
573 | image: TEST_DIR/t.IMGFMT |
574 | file format: IMGFMT | |
de38b500 | 575 | virtual size: 128 MiB (134217728 bytes) |
a33cc31d KW |
576 | cluster_size: 65536 |
577 | Format specific information: | |
578 | compat: 1.1 | |
579 | lazy refcounts: true | |
0709c5a1 | 580 | refcount bits: 16 |
9009b196 | 581 | corrupt: false |
a33cc31d KW |
582 | |
583 | Testing: amend -f qcow2 -o size=130M -o lazy_refcounts=off TEST_DIR/t.qcow2 | |
d1103231 MM |
584 | image: TEST_DIR/t.IMGFMT |
585 | file format: IMGFMT | |
de38b500 | 586 | virtual size: 130 MiB (136314880 bytes) |
a33cc31d KW |
587 | cluster_size: 65536 |
588 | Format specific information: | |
589 | compat: 1.1 | |
590 | lazy refcounts: false | |
0709c5a1 | 591 | refcount bits: 16 |
9009b196 | 592 | corrupt: false |
a33cc31d KW |
593 | |
594 | Testing: amend -f qcow2 -o size=8M -o lazy_refcounts=on -o size=132M TEST_DIR/t.qcow2 | |
d1103231 MM |
595 | image: TEST_DIR/t.IMGFMT |
596 | file format: IMGFMT | |
de38b500 | 597 | virtual size: 132 MiB (138412032 bytes) |
a33cc31d KW |
598 | cluster_size: 65536 |
599 | Format specific information: | |
600 | compat: 1.1 | |
601 | lazy refcounts: true | |
0709c5a1 | 602 | refcount bits: 16 |
9009b196 | 603 | corrupt: false |
a33cc31d KW |
604 | |
605 | Testing: amend -f qcow2 -o size=4M,size=148M TEST_DIR/t.qcow2 | |
1b53eab2 HR |
606 | image: TEST_DIR/t.IMGFMT |
607 | file format: IMGFMT | |
de38b500 | 608 | virtual size: 148 MiB (155189248 bytes) |
a33cc31d | 609 | cluster_size: 65536 |
a33cc31d KW |
610 | |
611 | === amend: help for -o === | |
612 | ||
613 | Testing: amend -f qcow2 -o help TEST_DIR/t.qcow2 | |
51641351 | 614 | Creation 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 | |
635 | Note that not all of these options may be amendable. | |
a33cc31d KW |
636 | |
637 | Testing: amend -f qcow2 -o ? TEST_DIR/t.qcow2 | |
51641351 | 638 | Creation 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 | |
659 | Note that not all of these options may be amendable. | |
a33cc31d KW |
660 | |
661 | Testing: amend -f qcow2 -o cluster_size=4k,help TEST_DIR/t.qcow2 | |
51641351 | 662 | Creation 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 | |
683 | Note that not all of these options may be amendable. | |
a33cc31d KW |
684 | |
685 | Testing: amend -f qcow2 -o cluster_size=4k,? TEST_DIR/t.qcow2 | |
51641351 | 686 | Creation 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 | |
707 | Note that not all of these options may be amendable. | |
a33cc31d KW |
708 | |
709 | Testing: amend -f qcow2 -o help,cluster_size=4k TEST_DIR/t.qcow2 | |
51641351 | 710 | Creation 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 | |
731 | Note that not all of these options may be amendable. | |
a33cc31d KW |
732 | |
733 | Testing: amend -f qcow2 -o ?,cluster_size=4k TEST_DIR/t.qcow2 | |
51641351 | 734 | Creation 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 | |
755 | Note that not all of these options may be amendable. | |
a33cc31d KW |
756 | |
757 | Testing: amend -f qcow2 -o cluster_size=4k -o help TEST_DIR/t.qcow2 | |
51641351 | 758 | Creation 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 | |
779 | Note that not all of these options may be amendable. | |
a33cc31d KW |
780 | |
781 | Testing: amend -f qcow2 -o cluster_size=4k -o ? TEST_DIR/t.qcow2 | |
51641351 | 782 | Creation 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 | |
803 | Note that not all of these options may be amendable. | |
a33cc31d KW |
804 | |
805 | Testing: amend -f qcow2 -o backing_file=TEST_DIR/t.qcow2,,help TEST_DIR/t.qcow2 | |
806 | ||
807 | Testing: rebase -u -b -f qcow2 TEST_DIR/t.qcow2 | |
808 | ||
809 | Testing: amend -f qcow2 -o backing_file=TEST_DIR/t.qcow2,,? TEST_DIR/t.qcow2 | |
810 | ||
811 | Testing: rebase -u -b -f qcow2 TEST_DIR/t.qcow2 | |
812 | ||
813 | Testing: amend -f qcow2 -o backing_file=TEST_DIR/t.qcow2, -o help TEST_DIR/t.qcow2 | |
814 | qemu-img: Invalid option list: backing_file=TEST_DIR/t.qcow2, | |
815 | ||
816 | Testing: amend -f qcow2 -o backing_file=TEST_DIR/t.qcow2 -o ,help TEST_DIR/t.qcow2 | |
817 | qemu-img: Invalid option list: ,help | |
818 | ||
819 | Testing: amend -f qcow2 -o backing_file=TEST_DIR/t.qcow2 -o ,, -o help TEST_DIR/t.qcow2 | |
820 | qemu-img: Invalid option list: ,, | |
821 | ||
822 | Testing: amend -f qcow2 -o help | |
51641351 | 823 | Creation 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 |
844 | Note that not all of these options may be amendable. |
845 | ||
0ef5a8e6 HR |
846 | Testing: amend -o help |
847 | qemu-img: Expecting one image file name | |
e53995eb HR |
848 | |
849 | Testing: amend -f bochs -o help | |
850 | qemu-img: Format driver 'bochs' does not support option amendment | |
a33cc31d | 851 | *** done |