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