xref: /qemu/tests/qemu-iotests/082.out (revision dba5aee4)
1a33cc31dSKevin WolfQA output created by 082
2a33cc31dSKevin Wolf
3a33cc31dSKevin Wolf=== create: Options specified more than once ===
4a33cc31dSKevin Wolf
5a33cc31dSKevin WolfTesting: create -f foo -f qcow2 TEST_DIR/t.qcow2 128M
67be20252SAlberto GarciaFormatting 'TEST_DIR/t.qcow2', fmt=qcow2 cluster_size=65536 extended_l2=off compression_type=zlib size=134217728 lazy_refcounts=off refcount_bits=16
71b53eab2SMax Reitzimage: TEST_DIR/t.IMGFMT
81b53eab2SMax Reitzfile format: IMGFMT
9de38b500SEric Blakevirtual size: 128 MiB (134217728 bytes)
10a33cc31dSKevin Wolfcluster_size: 65536
11a33cc31dSKevin Wolf
12a33cc31dSKevin WolfTesting: create -f qcow2 -o cluster_size=4k -o lazy_refcounts=on TEST_DIR/t.qcow2 128M
137be20252SAlberto GarciaFormatting 'TEST_DIR/t.qcow2', fmt=qcow2 cluster_size=4096 extended_l2=off compression_type=zlib size=134217728 lazy_refcounts=on refcount_bits=16
14d1103231SMichael Muellerimage: TEST_DIR/t.IMGFMT
15d1103231SMichael Muellerfile format: IMGFMT
16de38b500SEric Blakevirtual size: 128 MiB (134217728 bytes)
17a33cc31dSKevin Wolfcluster_size: 4096
18a33cc31dSKevin WolfFormat specific information:
19a33cc31dSKevin Wolf    compat: 1.1
20*dba5aee4SVladimir Sementsov-Ogievskiy    compression type: COMPRESSION_TYPE
21a33cc31dSKevin Wolf    lazy refcounts: true
220709c5a1SMax Reitz    refcount bits: 16
239009b196SMax Reitz    corrupt: false
247be20252SAlberto Garcia    extended l2: false
25a33cc31dSKevin Wolf
26a33cc31dSKevin WolfTesting: create -f qcow2 -o cluster_size=4k -o lazy_refcounts=on -o cluster_size=8k TEST_DIR/t.qcow2 128M
277be20252SAlberto GarciaFormatting 'TEST_DIR/t.qcow2', fmt=qcow2 cluster_size=8192 extended_l2=off compression_type=zlib size=134217728 lazy_refcounts=on refcount_bits=16
28d1103231SMichael Muellerimage: TEST_DIR/t.IMGFMT
29d1103231SMichael Muellerfile format: IMGFMT
30de38b500SEric Blakevirtual size: 128 MiB (134217728 bytes)
31a33cc31dSKevin Wolfcluster_size: 8192
32a33cc31dSKevin WolfFormat specific information:
33a33cc31dSKevin Wolf    compat: 1.1
34*dba5aee4SVladimir Sementsov-Ogievskiy    compression type: COMPRESSION_TYPE
35a33cc31dSKevin Wolf    lazy refcounts: true
360709c5a1SMax Reitz    refcount bits: 16
379009b196SMax Reitz    corrupt: false
387be20252SAlberto Garcia    extended l2: false
39a33cc31dSKevin Wolf
40a33cc31dSKevin WolfTesting: create -f qcow2 -o cluster_size=4k,cluster_size=8k TEST_DIR/t.qcow2 128M
417be20252SAlberto GarciaFormatting 'TEST_DIR/t.qcow2', fmt=qcow2 cluster_size=8192 extended_l2=off compression_type=zlib size=134217728 lazy_refcounts=off refcount_bits=16
421b53eab2SMax Reitzimage: TEST_DIR/t.IMGFMT
431b53eab2SMax Reitzfile format: IMGFMT
44de38b500SEric Blakevirtual size: 128 MiB (134217728 bytes)
45a33cc31dSKevin Wolfcluster_size: 8192
46a33cc31dSKevin Wolf
47a33cc31dSKevin Wolf=== create: help for -o ===
48a33cc31dSKevin Wolf
49a33cc31dSKevin WolfTesting: create -f qcow2 -o help TEST_DIR/t.qcow2 128M
50a33cc31dSKevin WolfSupported options:
5163898712SMax Reitz  backing_file=<str>     - File name of a base image
5263898712SMax Reitz  backing_fmt=<str>      - Image format of the base image
5363898712SMax Reitz  cluster_size=<size>    - qcow2 cluster size
5420ff903dSEric Blake  compat=<str>           - Compatibility level (v2 [0.10] or v3 [1.1])
55572ad978SDenis Plotnikov  compression_type=<str> - Compression method used for image cluster compression
569b890bdcSKevin Wolf  data_file=<str>        - File name of an external data file
576c3944dcSKevin Wolf  data_file_raw=<bool (on/off)> - The external data file must stay valid as a raw image
5863898712SMax Reitz  encrypt.cipher-alg=<str> - Name of encryption cipher algorithm
5963898712SMax Reitz  encrypt.cipher-mode=<str> - Name of encryption cipher mode
6063898712SMax Reitz  encrypt.format=<str>   - Encrypt the image, format choices: 'aes', 'luks'
6163898712SMax Reitz  encrypt.hash-alg=<str> - Name of encryption hash algorithm
6263898712SMax Reitz  encrypt.iter-time=<num> - Time to spend in PBKDF in milliseconds
6363898712SMax Reitz  encrypt.ivgen-alg=<str> - Name of IV generator algorithm
6463898712SMax Reitz  encrypt.ivgen-hash-alg=<str> - Name of IV generator hash algorithm
6563898712SMax Reitz  encrypt.key-secret=<str> - ID of secret providing qcow AES key or LUKS passphrase
6663898712SMax Reitz  encryption=<bool (on/off)> - Encrypt the image with format 'aes'. (Deprecated in favor of encrypt.format=aes)
677be20252SAlberto Garcia  extended_l2=<bool (on/off)> - Extended L2 tables
68ffa244c8SKevin Wolf  extent_size_hint=<size> - Extent size hint for the image file, 0 to disable
6963898712SMax Reitz  lazy_refcounts=<bool (on/off)> - Postpone refcount updates
7063898712SMax Reitz  nocow=<bool (on/off)>  - Turn off copy-on-write (valid only on btrfs)
7163898712SMax Reitz  preallocation=<str>    - Preallocation mode (allowed values: off, metadata, falloc, full)
7263898712SMax Reitz  refcount_bits=<num>    - Width of a reference count entry in bits
7363898712SMax Reitz  size=<size>            - Virtual disk size
74a33cc31dSKevin Wolf
75a33cc31dSKevin WolfTesting: create -f qcow2 -o ? TEST_DIR/t.qcow2 128M
76a33cc31dSKevin WolfSupported options:
7763898712SMax Reitz  backing_file=<str>     - File name of a base image
7863898712SMax Reitz  backing_fmt=<str>      - Image format of the base image
7963898712SMax Reitz  cluster_size=<size>    - qcow2 cluster size
8020ff903dSEric Blake  compat=<str>           - Compatibility level (v2 [0.10] or v3 [1.1])
81572ad978SDenis Plotnikov  compression_type=<str> - Compression method used for image cluster compression
829b890bdcSKevin Wolf  data_file=<str>        - File name of an external data file
836c3944dcSKevin Wolf  data_file_raw=<bool (on/off)> - The external data file must stay valid as a raw image
8463898712SMax Reitz  encrypt.cipher-alg=<str> - Name of encryption cipher algorithm
8563898712SMax Reitz  encrypt.cipher-mode=<str> - Name of encryption cipher mode
8663898712SMax Reitz  encrypt.format=<str>   - Encrypt the image, format choices: 'aes', 'luks'
8763898712SMax Reitz  encrypt.hash-alg=<str> - Name of encryption hash algorithm
8863898712SMax Reitz  encrypt.iter-time=<num> - Time to spend in PBKDF in milliseconds
8963898712SMax Reitz  encrypt.ivgen-alg=<str> - Name of IV generator algorithm
9063898712SMax Reitz  encrypt.ivgen-hash-alg=<str> - Name of IV generator hash algorithm
9163898712SMax Reitz  encrypt.key-secret=<str> - ID of secret providing qcow AES key or LUKS passphrase
9263898712SMax Reitz  encryption=<bool (on/off)> - Encrypt the image with format 'aes'. (Deprecated in favor of encrypt.format=aes)
937be20252SAlberto Garcia  extended_l2=<bool (on/off)> - Extended L2 tables
94ffa244c8SKevin Wolf  extent_size_hint=<size> - Extent size hint for the image file, 0 to disable
9563898712SMax Reitz  lazy_refcounts=<bool (on/off)> - Postpone refcount updates
9663898712SMax Reitz  nocow=<bool (on/off)>  - Turn off copy-on-write (valid only on btrfs)
9763898712SMax Reitz  preallocation=<str>    - Preallocation mode (allowed values: off, metadata, falloc, full)
9863898712SMax Reitz  refcount_bits=<num>    - Width of a reference count entry in bits
9963898712SMax Reitz  size=<size>            - Virtual disk size
100a33cc31dSKevin Wolf
101a33cc31dSKevin WolfTesting: create -f qcow2 -o cluster_size=4k,help TEST_DIR/t.qcow2 128M
102a33cc31dSKevin WolfSupported options:
10363898712SMax Reitz  backing_file=<str>     - File name of a base image
10463898712SMax Reitz  backing_fmt=<str>      - Image format of the base image
10563898712SMax Reitz  cluster_size=<size>    - qcow2 cluster size
10620ff903dSEric Blake  compat=<str>           - Compatibility level (v2 [0.10] or v3 [1.1])
107572ad978SDenis Plotnikov  compression_type=<str> - Compression method used for image cluster compression
1089b890bdcSKevin Wolf  data_file=<str>        - File name of an external data file
1096c3944dcSKevin Wolf  data_file_raw=<bool (on/off)> - The external data file must stay valid as a raw image
11063898712SMax Reitz  encrypt.cipher-alg=<str> - Name of encryption cipher algorithm
11163898712SMax Reitz  encrypt.cipher-mode=<str> - Name of encryption cipher mode
11263898712SMax Reitz  encrypt.format=<str>   - Encrypt the image, format choices: 'aes', 'luks'
11363898712SMax Reitz  encrypt.hash-alg=<str> - Name of encryption hash algorithm
11463898712SMax Reitz  encrypt.iter-time=<num> - Time to spend in PBKDF in milliseconds
11563898712SMax Reitz  encrypt.ivgen-alg=<str> - Name of IV generator algorithm
11663898712SMax Reitz  encrypt.ivgen-hash-alg=<str> - Name of IV generator hash algorithm
11763898712SMax Reitz  encrypt.key-secret=<str> - ID of secret providing qcow AES key or LUKS passphrase
11863898712SMax Reitz  encryption=<bool (on/off)> - Encrypt the image with format 'aes'. (Deprecated in favor of encrypt.format=aes)
1197be20252SAlberto Garcia  extended_l2=<bool (on/off)> - Extended L2 tables
120ffa244c8SKevin Wolf  extent_size_hint=<size> - Extent size hint for the image file, 0 to disable
12163898712SMax Reitz  lazy_refcounts=<bool (on/off)> - Postpone refcount updates
12263898712SMax Reitz  nocow=<bool (on/off)>  - Turn off copy-on-write (valid only on btrfs)
12363898712SMax Reitz  preallocation=<str>    - Preallocation mode (allowed values: off, metadata, falloc, full)
12463898712SMax Reitz  refcount_bits=<num>    - Width of a reference count entry in bits
12563898712SMax Reitz  size=<size>            - Virtual disk size
126a33cc31dSKevin Wolf
127a33cc31dSKevin WolfTesting: create -f qcow2 -o cluster_size=4k,? TEST_DIR/t.qcow2 128M
128a33cc31dSKevin WolfSupported options:
12963898712SMax Reitz  backing_file=<str>     - File name of a base image
13063898712SMax Reitz  backing_fmt=<str>      - Image format of the base image
13163898712SMax Reitz  cluster_size=<size>    - qcow2 cluster size
13220ff903dSEric Blake  compat=<str>           - Compatibility level (v2 [0.10] or v3 [1.1])
133572ad978SDenis Plotnikov  compression_type=<str> - Compression method used for image cluster compression
1349b890bdcSKevin Wolf  data_file=<str>        - File name of an external data file
1356c3944dcSKevin Wolf  data_file_raw=<bool (on/off)> - The external data file must stay valid as a raw image
13663898712SMax Reitz  encrypt.cipher-alg=<str> - Name of encryption cipher algorithm
13763898712SMax Reitz  encrypt.cipher-mode=<str> - Name of encryption cipher mode
13863898712SMax Reitz  encrypt.format=<str>   - Encrypt the image, format choices: 'aes', 'luks'
13963898712SMax Reitz  encrypt.hash-alg=<str> - Name of encryption hash algorithm
14063898712SMax Reitz  encrypt.iter-time=<num> - Time to spend in PBKDF in milliseconds
14163898712SMax Reitz  encrypt.ivgen-alg=<str> - Name of IV generator algorithm
14263898712SMax Reitz  encrypt.ivgen-hash-alg=<str> - Name of IV generator hash algorithm
14363898712SMax Reitz  encrypt.key-secret=<str> - ID of secret providing qcow AES key or LUKS passphrase
14463898712SMax Reitz  encryption=<bool (on/off)> - Encrypt the image with format 'aes'. (Deprecated in favor of encrypt.format=aes)
1457be20252SAlberto Garcia  extended_l2=<bool (on/off)> - Extended L2 tables
146ffa244c8SKevin Wolf  extent_size_hint=<size> - Extent size hint for the image file, 0 to disable
14763898712SMax Reitz  lazy_refcounts=<bool (on/off)> - Postpone refcount updates
14863898712SMax Reitz  nocow=<bool (on/off)>  - Turn off copy-on-write (valid only on btrfs)
14963898712SMax Reitz  preallocation=<str>    - Preallocation mode (allowed values: off, metadata, falloc, full)
15063898712SMax Reitz  refcount_bits=<num>    - Width of a reference count entry in bits
15163898712SMax Reitz  size=<size>            - Virtual disk size
152a33cc31dSKevin Wolf
153a33cc31dSKevin WolfTesting: create -f qcow2 -o help,cluster_size=4k TEST_DIR/t.qcow2 128M
154a33cc31dSKevin WolfSupported options:
15563898712SMax Reitz  backing_file=<str>     - File name of a base image
15663898712SMax Reitz  backing_fmt=<str>      - Image format of the base image
15763898712SMax Reitz  cluster_size=<size>    - qcow2 cluster size
15820ff903dSEric Blake  compat=<str>           - Compatibility level (v2 [0.10] or v3 [1.1])
159572ad978SDenis Plotnikov  compression_type=<str> - Compression method used for image cluster compression
1609b890bdcSKevin Wolf  data_file=<str>        - File name of an external data file
1616c3944dcSKevin Wolf  data_file_raw=<bool (on/off)> - The external data file must stay valid as a raw image
16263898712SMax Reitz  encrypt.cipher-alg=<str> - Name of encryption cipher algorithm
16363898712SMax Reitz  encrypt.cipher-mode=<str> - Name of encryption cipher mode
16463898712SMax Reitz  encrypt.format=<str>   - Encrypt the image, format choices: 'aes', 'luks'
16563898712SMax Reitz  encrypt.hash-alg=<str> - Name of encryption hash algorithm
16663898712SMax Reitz  encrypt.iter-time=<num> - Time to spend in PBKDF in milliseconds
16763898712SMax Reitz  encrypt.ivgen-alg=<str> - Name of IV generator algorithm
16863898712SMax Reitz  encrypt.ivgen-hash-alg=<str> - Name of IV generator hash algorithm
16963898712SMax Reitz  encrypt.key-secret=<str> - ID of secret providing qcow AES key or LUKS passphrase
17063898712SMax Reitz  encryption=<bool (on/off)> - Encrypt the image with format 'aes'. (Deprecated in favor of encrypt.format=aes)
1717be20252SAlberto Garcia  extended_l2=<bool (on/off)> - Extended L2 tables
172ffa244c8SKevin Wolf  extent_size_hint=<size> - Extent size hint for the image file, 0 to disable
17363898712SMax Reitz  lazy_refcounts=<bool (on/off)> - Postpone refcount updates
17463898712SMax Reitz  nocow=<bool (on/off)>  - Turn off copy-on-write (valid only on btrfs)
17563898712SMax Reitz  preallocation=<str>    - Preallocation mode (allowed values: off, metadata, falloc, full)
17663898712SMax Reitz  refcount_bits=<num>    - Width of a reference count entry in bits
17763898712SMax Reitz  size=<size>            - Virtual disk size
178a33cc31dSKevin Wolf
179a33cc31dSKevin WolfTesting: create -f qcow2 -o ?,cluster_size=4k TEST_DIR/t.qcow2 128M
180a33cc31dSKevin WolfSupported options:
18163898712SMax Reitz  backing_file=<str>     - File name of a base image
18263898712SMax Reitz  backing_fmt=<str>      - Image format of the base image
18363898712SMax Reitz  cluster_size=<size>    - qcow2 cluster size
18420ff903dSEric Blake  compat=<str>           - Compatibility level (v2 [0.10] or v3 [1.1])
185572ad978SDenis Plotnikov  compression_type=<str> - Compression method used for image cluster compression
1869b890bdcSKevin Wolf  data_file=<str>        - File name of an external data file
1876c3944dcSKevin Wolf  data_file_raw=<bool (on/off)> - The external data file must stay valid as a raw image
18863898712SMax Reitz  encrypt.cipher-alg=<str> - Name of encryption cipher algorithm
18963898712SMax Reitz  encrypt.cipher-mode=<str> - Name of encryption cipher mode
19063898712SMax Reitz  encrypt.format=<str>   - Encrypt the image, format choices: 'aes', 'luks'
19163898712SMax Reitz  encrypt.hash-alg=<str> - Name of encryption hash algorithm
19263898712SMax Reitz  encrypt.iter-time=<num> - Time to spend in PBKDF in milliseconds
19363898712SMax Reitz  encrypt.ivgen-alg=<str> - Name of IV generator algorithm
19463898712SMax Reitz  encrypt.ivgen-hash-alg=<str> - Name of IV generator hash algorithm
19563898712SMax Reitz  encrypt.key-secret=<str> - ID of secret providing qcow AES key or LUKS passphrase
19663898712SMax Reitz  encryption=<bool (on/off)> - Encrypt the image with format 'aes'. (Deprecated in favor of encrypt.format=aes)
1977be20252SAlberto Garcia  extended_l2=<bool (on/off)> - Extended L2 tables
198ffa244c8SKevin Wolf  extent_size_hint=<size> - Extent size hint for the image file, 0 to disable
19963898712SMax Reitz  lazy_refcounts=<bool (on/off)> - Postpone refcount updates
20063898712SMax Reitz  nocow=<bool (on/off)>  - Turn off copy-on-write (valid only on btrfs)
20163898712SMax Reitz  preallocation=<str>    - Preallocation mode (allowed values: off, metadata, falloc, full)
20263898712SMax Reitz  refcount_bits=<num>    - Width of a reference count entry in bits
20363898712SMax Reitz  size=<size>            - Virtual disk size
204a33cc31dSKevin Wolf
205a33cc31dSKevin WolfTesting: create -f qcow2 -o cluster_size=4k -o help TEST_DIR/t.qcow2 128M
206a33cc31dSKevin WolfSupported options:
20763898712SMax Reitz  backing_file=<str>     - File name of a base image
20863898712SMax Reitz  backing_fmt=<str>      - Image format of the base image
20963898712SMax Reitz  cluster_size=<size>    - qcow2 cluster size
21020ff903dSEric Blake  compat=<str>           - Compatibility level (v2 [0.10] or v3 [1.1])
211572ad978SDenis Plotnikov  compression_type=<str> - Compression method used for image cluster compression
2129b890bdcSKevin Wolf  data_file=<str>        - File name of an external data file
2136c3944dcSKevin Wolf  data_file_raw=<bool (on/off)> - The external data file must stay valid as a raw image
21463898712SMax Reitz  encrypt.cipher-alg=<str> - Name of encryption cipher algorithm
21563898712SMax Reitz  encrypt.cipher-mode=<str> - Name of encryption cipher mode
21663898712SMax Reitz  encrypt.format=<str>   - Encrypt the image, format choices: 'aes', 'luks'
21763898712SMax Reitz  encrypt.hash-alg=<str> - Name of encryption hash algorithm
21863898712SMax Reitz  encrypt.iter-time=<num> - Time to spend in PBKDF in milliseconds
21963898712SMax Reitz  encrypt.ivgen-alg=<str> - Name of IV generator algorithm
22063898712SMax Reitz  encrypt.ivgen-hash-alg=<str> - Name of IV generator hash algorithm
22163898712SMax Reitz  encrypt.key-secret=<str> - ID of secret providing qcow AES key or LUKS passphrase
22263898712SMax Reitz  encryption=<bool (on/off)> - Encrypt the image with format 'aes'. (Deprecated in favor of encrypt.format=aes)
2237be20252SAlberto Garcia  extended_l2=<bool (on/off)> - Extended L2 tables
224ffa244c8SKevin Wolf  extent_size_hint=<size> - Extent size hint for the image file, 0 to disable
22563898712SMax Reitz  lazy_refcounts=<bool (on/off)> - Postpone refcount updates
22663898712SMax Reitz  nocow=<bool (on/off)>  - Turn off copy-on-write (valid only on btrfs)
22763898712SMax Reitz  preallocation=<str>    - Preallocation mode (allowed values: off, metadata, falloc, full)
22863898712SMax Reitz  refcount_bits=<num>    - Width of a reference count entry in bits
22963898712SMax Reitz  size=<size>            - Virtual disk size
230a33cc31dSKevin Wolf
231a33cc31dSKevin WolfTesting: create -f qcow2 -o cluster_size=4k -o ? TEST_DIR/t.qcow2 128M
232a33cc31dSKevin WolfSupported options:
23363898712SMax Reitz  backing_file=<str>     - File name of a base image
23463898712SMax Reitz  backing_fmt=<str>      - Image format of the base image
23563898712SMax Reitz  cluster_size=<size>    - qcow2 cluster size
23620ff903dSEric Blake  compat=<str>           - Compatibility level (v2 [0.10] or v3 [1.1])
237572ad978SDenis Plotnikov  compression_type=<str> - Compression method used for image cluster compression
2389b890bdcSKevin Wolf  data_file=<str>        - File name of an external data file
2396c3944dcSKevin Wolf  data_file_raw=<bool (on/off)> - The external data file must stay valid as a raw image
24063898712SMax Reitz  encrypt.cipher-alg=<str> - Name of encryption cipher algorithm
24163898712SMax Reitz  encrypt.cipher-mode=<str> - Name of encryption cipher mode
24263898712SMax Reitz  encrypt.format=<str>   - Encrypt the image, format choices: 'aes', 'luks'
24363898712SMax Reitz  encrypt.hash-alg=<str> - Name of encryption hash algorithm
24463898712SMax Reitz  encrypt.iter-time=<num> - Time to spend in PBKDF in milliseconds
24563898712SMax Reitz  encrypt.ivgen-alg=<str> - Name of IV generator algorithm
24663898712SMax Reitz  encrypt.ivgen-hash-alg=<str> - Name of IV generator hash algorithm
24763898712SMax Reitz  encrypt.key-secret=<str> - ID of secret providing qcow AES key or LUKS passphrase
24863898712SMax Reitz  encryption=<bool (on/off)> - Encrypt the image with format 'aes'. (Deprecated in favor of encrypt.format=aes)
2497be20252SAlberto Garcia  extended_l2=<bool (on/off)> - Extended L2 tables
250ffa244c8SKevin Wolf  extent_size_hint=<size> - Extent size hint for the image file, 0 to disable
25163898712SMax Reitz  lazy_refcounts=<bool (on/off)> - Postpone refcount updates
25263898712SMax Reitz  nocow=<bool (on/off)>  - Turn off copy-on-write (valid only on btrfs)
25363898712SMax Reitz  preallocation=<str>    - Preallocation mode (allowed values: off, metadata, falloc, full)
25463898712SMax Reitz  refcount_bits=<num>    - Width of a reference count entry in bits
25563898712SMax Reitz  size=<size>            - Virtual disk size
256a33cc31dSKevin Wolf
257b66ff2c2SEric BlakeTesting: create -f qcow2 -u -o backing_file=TEST_DIR/t.qcow2,,help -F qcow2 TEST_DIR/t.qcow2 128M
2587be20252SAlberto GarciaFormatting '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
259a33cc31dSKevin Wolf
260b66ff2c2SEric BlakeTesting: create -f qcow2 -u -o backing_file=TEST_DIR/t.qcow2,,? -F qcow2 TEST_DIR/t.qcow2 128M
2617be20252SAlberto GarciaFormatting '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
262a33cc31dSKevin Wolf
263a33cc31dSKevin WolfTesting: create -f qcow2 -o backing_file=TEST_DIR/t.qcow2, -o help TEST_DIR/t.qcow2 128M
264a33cc31dSKevin Wolfqemu-img: Invalid option list: backing_file=TEST_DIR/t.qcow2,
265a33cc31dSKevin Wolf
266a33cc31dSKevin WolfTesting: create -f qcow2 -o backing_file=TEST_DIR/t.qcow2 -o ,help TEST_DIR/t.qcow2 128M
267a33cc31dSKevin Wolfqemu-img: Invalid option list: ,help
268a33cc31dSKevin Wolf
269a33cc31dSKevin WolfTesting: create -f qcow2 -o backing_file=TEST_DIR/t.qcow2 -o ,, -o help TEST_DIR/t.qcow2 128M
270a33cc31dSKevin Wolfqemu-img: Invalid option list: ,,
271a33cc31dSKevin Wolf
272a33cc31dSKevin WolfTesting: create -f qcow2 -o help
273f4619af0SMax ReitzSupported qcow2 options:
27463898712SMax Reitz  backing_file=<str>     - File name of a base image
27563898712SMax Reitz  backing_fmt=<str>      - Image format of the base image
27663898712SMax Reitz  cluster_size=<size>    - qcow2 cluster size
27720ff903dSEric Blake  compat=<str>           - Compatibility level (v2 [0.10] or v3 [1.1])
278572ad978SDenis Plotnikov  compression_type=<str> - Compression method used for image cluster compression
2799b890bdcSKevin Wolf  data_file=<str>        - File name of an external data file
2806c3944dcSKevin Wolf  data_file_raw=<bool (on/off)> - The external data file must stay valid as a raw image
28163898712SMax Reitz  encrypt.cipher-alg=<str> - Name of encryption cipher algorithm
28263898712SMax Reitz  encrypt.cipher-mode=<str> - Name of encryption cipher mode
28363898712SMax Reitz  encrypt.format=<str>   - Encrypt the image, format choices: 'aes', 'luks'
28463898712SMax Reitz  encrypt.hash-alg=<str> - Name of encryption hash algorithm
28563898712SMax Reitz  encrypt.iter-time=<num> - Time to spend in PBKDF in milliseconds
28663898712SMax Reitz  encrypt.ivgen-alg=<str> - Name of IV generator algorithm
28763898712SMax Reitz  encrypt.ivgen-hash-alg=<str> - Name of IV generator hash algorithm
28863898712SMax Reitz  encrypt.key-secret=<str> - ID of secret providing qcow AES key or LUKS passphrase
28963898712SMax Reitz  encryption=<bool (on/off)> - Encrypt the image with format 'aes'. (Deprecated in favor of encrypt.format=aes)
2907be20252SAlberto Garcia  extended_l2=<bool (on/off)> - Extended L2 tables
29163898712SMax Reitz  lazy_refcounts=<bool (on/off)> - Postpone refcount updates
29263898712SMax Reitz  preallocation=<str>    - Preallocation mode (allowed values: off, metadata, falloc, full)
29363898712SMax Reitz  refcount_bits=<num>    - Width of a reference count entry in bits
29463898712SMax Reitz  size=<size>            - Virtual disk size
295a33cc31dSKevin Wolf
296f4619af0SMax ReitzThe protocol level may support further options.
297f4619af0SMax ReitzSpecify the target filename to include those options.
298f4619af0SMax Reitz
299a33cc31dSKevin WolfTesting: create -o help
300f4619af0SMax ReitzSupported raw options:
30163898712SMax Reitz  size=<size>            - Virtual disk size
302a33cc31dSKevin Wolf
303f4619af0SMax ReitzThe protocol level may support further options.
304f4619af0SMax ReitzSpecify the target filename to include those options.
305f4619af0SMax Reitz
306e53995ebSMax ReitzTesting: create -f bochs -o help
307e53995ebSMax Reitzqemu-img: Format driver 'bochs' does not support image creation
308e53995ebSMax Reitz
309a33cc31dSKevin Wolf=== convert: Options specified more than once ===
310a33cc31dSKevin Wolf
311a33cc31dSKevin WolfTesting: create -f qcow2 TEST_DIR/t.qcow2 128M
3127be20252SAlberto GarciaFormatting 'TEST_DIR/t.qcow2', fmt=qcow2 cluster_size=65536 extended_l2=off compression_type=zlib size=134217728 lazy_refcounts=off refcount_bits=16
313a33cc31dSKevin Wolf
314a33cc31dSKevin WolfTesting: convert -f foo -f qcow2 TEST_DIR/t.qcow2 TEST_DIR/t.qcow2.base
3151b53eab2SMax Reitzimage: TEST_DIR/t.IMGFMT.base
316a33cc31dSKevin Wolffile format: raw
317de38b500SEric Blakevirtual size: 128 MiB (134217728 bytes)
318a33cc31dSKevin Wolf
319a33cc31dSKevin WolfTesting: convert -O foo -O qcow2 TEST_DIR/t.qcow2 TEST_DIR/t.qcow2.base
3201b53eab2SMax Reitzimage: TEST_DIR/t.IMGFMT.base
3211b53eab2SMax Reitzfile format: IMGFMT
322de38b500SEric Blakevirtual size: 128 MiB (134217728 bytes)
323a33cc31dSKevin Wolfcluster_size: 65536
324a33cc31dSKevin Wolf
325a33cc31dSKevin WolfTesting: convert -O qcow2 -o cluster_size=4k -o lazy_refcounts=on TEST_DIR/t.qcow2 TEST_DIR/t.qcow2.base
326d1103231SMichael Muellerimage: TEST_DIR/t.IMGFMT.base
327d1103231SMichael Muellerfile format: IMGFMT
328de38b500SEric Blakevirtual size: 128 MiB (134217728 bytes)
329a33cc31dSKevin Wolfcluster_size: 4096
330a33cc31dSKevin WolfFormat specific information:
331a33cc31dSKevin Wolf    compat: 1.1
332*dba5aee4SVladimir Sementsov-Ogievskiy    compression type: COMPRESSION_TYPE
333a33cc31dSKevin Wolf    lazy refcounts: true
3340709c5a1SMax Reitz    refcount bits: 16
3359009b196SMax Reitz    corrupt: false
3367be20252SAlberto Garcia    extended l2: false
337a33cc31dSKevin Wolf
338a33cc31dSKevin WolfTesting: convert -O qcow2 -o cluster_size=4k -o lazy_refcounts=on -o cluster_size=8k TEST_DIR/t.qcow2 TEST_DIR/t.qcow2.base
339d1103231SMichael Muellerimage: TEST_DIR/t.IMGFMT.base
340d1103231SMichael Muellerfile format: IMGFMT
341de38b500SEric Blakevirtual size: 128 MiB (134217728 bytes)
342a33cc31dSKevin Wolfcluster_size: 8192
343a33cc31dSKevin WolfFormat specific information:
344a33cc31dSKevin Wolf    compat: 1.1
345*dba5aee4SVladimir Sementsov-Ogievskiy    compression type: COMPRESSION_TYPE
346a33cc31dSKevin Wolf    lazy refcounts: true
3470709c5a1SMax Reitz    refcount bits: 16
3489009b196SMax Reitz    corrupt: false
3497be20252SAlberto Garcia    extended l2: false
350a33cc31dSKevin Wolf
351a33cc31dSKevin WolfTesting: convert -O qcow2 -o cluster_size=4k,cluster_size=8k TEST_DIR/t.qcow2 TEST_DIR/t.qcow2.base
3521b53eab2SMax Reitzimage: TEST_DIR/t.IMGFMT.base
3531b53eab2SMax Reitzfile format: IMGFMT
354de38b500SEric Blakevirtual size: 128 MiB (134217728 bytes)
355a33cc31dSKevin Wolfcluster_size: 8192
356a33cc31dSKevin Wolf
357a33cc31dSKevin Wolf=== convert: help for -o ===
358a33cc31dSKevin Wolf
359a33cc31dSKevin WolfTesting: convert -O qcow2 -o help TEST_DIR/t.qcow2 TEST_DIR/t.qcow2.base
360a33cc31dSKevin WolfSupported options:
36163898712SMax Reitz  backing_file=<str>     - File name of a base image
36263898712SMax Reitz  backing_fmt=<str>      - Image format of the base image
36363898712SMax Reitz  cluster_size=<size>    - qcow2 cluster size
36420ff903dSEric Blake  compat=<str>           - Compatibility level (v2 [0.10] or v3 [1.1])
365572ad978SDenis Plotnikov  compression_type=<str> - Compression method used for image cluster compression
3669b890bdcSKevin Wolf  data_file=<str>        - File name of an external data file
3676c3944dcSKevin Wolf  data_file_raw=<bool (on/off)> - The external data file must stay valid as a raw image
36863898712SMax Reitz  encrypt.cipher-alg=<str> - Name of encryption cipher algorithm
36963898712SMax Reitz  encrypt.cipher-mode=<str> - Name of encryption cipher mode
37063898712SMax Reitz  encrypt.format=<str>   - Encrypt the image, format choices: 'aes', 'luks'
37163898712SMax Reitz  encrypt.hash-alg=<str> - Name of encryption hash algorithm
37263898712SMax Reitz  encrypt.iter-time=<num> - Time to spend in PBKDF in milliseconds
37363898712SMax Reitz  encrypt.ivgen-alg=<str> - Name of IV generator algorithm
37463898712SMax Reitz  encrypt.ivgen-hash-alg=<str> - Name of IV generator hash algorithm
37563898712SMax Reitz  encrypt.key-secret=<str> - ID of secret providing qcow AES key or LUKS passphrase
37663898712SMax Reitz  encryption=<bool (on/off)> - Encrypt the image with format 'aes'. (Deprecated in favor of encrypt.format=aes)
3777be20252SAlberto Garcia  extended_l2=<bool (on/off)> - Extended L2 tables
378ffa244c8SKevin Wolf  extent_size_hint=<size> - Extent size hint for the image file, 0 to disable
37963898712SMax Reitz  lazy_refcounts=<bool (on/off)> - Postpone refcount updates
38063898712SMax Reitz  nocow=<bool (on/off)>  - Turn off copy-on-write (valid only on btrfs)
38163898712SMax Reitz  preallocation=<str>    - Preallocation mode (allowed values: off, metadata, falloc, full)
38263898712SMax Reitz  refcount_bits=<num>    - Width of a reference count entry in bits
38363898712SMax Reitz  size=<size>            - Virtual disk size
384a33cc31dSKevin Wolf
385a33cc31dSKevin WolfTesting: convert -O qcow2 -o ? TEST_DIR/t.qcow2 TEST_DIR/t.qcow2.base
386a33cc31dSKevin WolfSupported options:
38763898712SMax Reitz  backing_file=<str>     - File name of a base image
38863898712SMax Reitz  backing_fmt=<str>      - Image format of the base image
38963898712SMax Reitz  cluster_size=<size>    - qcow2 cluster size
39020ff903dSEric Blake  compat=<str>           - Compatibility level (v2 [0.10] or v3 [1.1])
391572ad978SDenis Plotnikov  compression_type=<str> - Compression method used for image cluster compression
3929b890bdcSKevin Wolf  data_file=<str>        - File name of an external data file
3936c3944dcSKevin Wolf  data_file_raw=<bool (on/off)> - The external data file must stay valid as a raw image
39463898712SMax Reitz  encrypt.cipher-alg=<str> - Name of encryption cipher algorithm
39563898712SMax Reitz  encrypt.cipher-mode=<str> - Name of encryption cipher mode
39663898712SMax Reitz  encrypt.format=<str>   - Encrypt the image, format choices: 'aes', 'luks'
39763898712SMax Reitz  encrypt.hash-alg=<str> - Name of encryption hash algorithm
39863898712SMax Reitz  encrypt.iter-time=<num> - Time to spend in PBKDF in milliseconds
39963898712SMax Reitz  encrypt.ivgen-alg=<str> - Name of IV generator algorithm
40063898712SMax Reitz  encrypt.ivgen-hash-alg=<str> - Name of IV generator hash algorithm
40163898712SMax Reitz  encrypt.key-secret=<str> - ID of secret providing qcow AES key or LUKS passphrase
40263898712SMax Reitz  encryption=<bool (on/off)> - Encrypt the image with format 'aes'. (Deprecated in favor of encrypt.format=aes)
4037be20252SAlberto Garcia  extended_l2=<bool (on/off)> - Extended L2 tables
404ffa244c8SKevin Wolf  extent_size_hint=<size> - Extent size hint for the image file, 0 to disable
40563898712SMax Reitz  lazy_refcounts=<bool (on/off)> - Postpone refcount updates
40663898712SMax Reitz  nocow=<bool (on/off)>  - Turn off copy-on-write (valid only on btrfs)
40763898712SMax Reitz  preallocation=<str>    - Preallocation mode (allowed values: off, metadata, falloc, full)
40863898712SMax Reitz  refcount_bits=<num>    - Width of a reference count entry in bits
40963898712SMax Reitz  size=<size>            - Virtual disk size
410a33cc31dSKevin Wolf
411a33cc31dSKevin WolfTesting: convert -O qcow2 -o cluster_size=4k,help TEST_DIR/t.qcow2 TEST_DIR/t.qcow2.base
412a33cc31dSKevin WolfSupported options:
41363898712SMax Reitz  backing_file=<str>     - File name of a base image
41463898712SMax Reitz  backing_fmt=<str>      - Image format of the base image
41563898712SMax Reitz  cluster_size=<size>    - qcow2 cluster size
41620ff903dSEric Blake  compat=<str>           - Compatibility level (v2 [0.10] or v3 [1.1])
417572ad978SDenis Plotnikov  compression_type=<str> - Compression method used for image cluster compression
4189b890bdcSKevin Wolf  data_file=<str>        - File name of an external data file
4196c3944dcSKevin Wolf  data_file_raw=<bool (on/off)> - The external data file must stay valid as a raw image
42063898712SMax Reitz  encrypt.cipher-alg=<str> - Name of encryption cipher algorithm
42163898712SMax Reitz  encrypt.cipher-mode=<str> - Name of encryption cipher mode
42263898712SMax Reitz  encrypt.format=<str>   - Encrypt the image, format choices: 'aes', 'luks'
42363898712SMax Reitz  encrypt.hash-alg=<str> - Name of encryption hash algorithm
42463898712SMax Reitz  encrypt.iter-time=<num> - Time to spend in PBKDF in milliseconds
42563898712SMax Reitz  encrypt.ivgen-alg=<str> - Name of IV generator algorithm
42663898712SMax Reitz  encrypt.ivgen-hash-alg=<str> - Name of IV generator hash algorithm
42763898712SMax Reitz  encrypt.key-secret=<str> - ID of secret providing qcow AES key or LUKS passphrase
42863898712SMax Reitz  encryption=<bool (on/off)> - Encrypt the image with format 'aes'. (Deprecated in favor of encrypt.format=aes)
4297be20252SAlberto Garcia  extended_l2=<bool (on/off)> - Extended L2 tables
430ffa244c8SKevin Wolf  extent_size_hint=<size> - Extent size hint for the image file, 0 to disable
43163898712SMax Reitz  lazy_refcounts=<bool (on/off)> - Postpone refcount updates
43263898712SMax Reitz  nocow=<bool (on/off)>  - Turn off copy-on-write (valid only on btrfs)
43363898712SMax Reitz  preallocation=<str>    - Preallocation mode (allowed values: off, metadata, falloc, full)
43463898712SMax Reitz  refcount_bits=<num>    - Width of a reference count entry in bits
43563898712SMax Reitz  size=<size>            - Virtual disk size
436a33cc31dSKevin Wolf
437a33cc31dSKevin WolfTesting: convert -O qcow2 -o cluster_size=4k,? TEST_DIR/t.qcow2 TEST_DIR/t.qcow2.base
438a33cc31dSKevin WolfSupported options:
43963898712SMax Reitz  backing_file=<str>     - File name of a base image
44063898712SMax Reitz  backing_fmt=<str>      - Image format of the base image
44163898712SMax Reitz  cluster_size=<size>    - qcow2 cluster size
44220ff903dSEric Blake  compat=<str>           - Compatibility level (v2 [0.10] or v3 [1.1])
443572ad978SDenis Plotnikov  compression_type=<str> - Compression method used for image cluster compression
4449b890bdcSKevin Wolf  data_file=<str>        - File name of an external data file
4456c3944dcSKevin Wolf  data_file_raw=<bool (on/off)> - The external data file must stay valid as a raw image
44663898712SMax Reitz  encrypt.cipher-alg=<str> - Name of encryption cipher algorithm
44763898712SMax Reitz  encrypt.cipher-mode=<str> - Name of encryption cipher mode
44863898712SMax Reitz  encrypt.format=<str>   - Encrypt the image, format choices: 'aes', 'luks'
44963898712SMax Reitz  encrypt.hash-alg=<str> - Name of encryption hash algorithm
45063898712SMax Reitz  encrypt.iter-time=<num> - Time to spend in PBKDF in milliseconds
45163898712SMax Reitz  encrypt.ivgen-alg=<str> - Name of IV generator algorithm
45263898712SMax Reitz  encrypt.ivgen-hash-alg=<str> - Name of IV generator hash algorithm
45363898712SMax Reitz  encrypt.key-secret=<str> - ID of secret providing qcow AES key or LUKS passphrase
45463898712SMax Reitz  encryption=<bool (on/off)> - Encrypt the image with format 'aes'. (Deprecated in favor of encrypt.format=aes)
4557be20252SAlberto Garcia  extended_l2=<bool (on/off)> - Extended L2 tables
456ffa244c8SKevin Wolf  extent_size_hint=<size> - Extent size hint for the image file, 0 to disable
45763898712SMax Reitz  lazy_refcounts=<bool (on/off)> - Postpone refcount updates
45863898712SMax Reitz  nocow=<bool (on/off)>  - Turn off copy-on-write (valid only on btrfs)
45963898712SMax Reitz  preallocation=<str>    - Preallocation mode (allowed values: off, metadata, falloc, full)
46063898712SMax Reitz  refcount_bits=<num>    - Width of a reference count entry in bits
46163898712SMax Reitz  size=<size>            - Virtual disk size
462a33cc31dSKevin Wolf
463a33cc31dSKevin WolfTesting: convert -O qcow2 -o help,cluster_size=4k TEST_DIR/t.qcow2 TEST_DIR/t.qcow2.base
464a33cc31dSKevin WolfSupported options:
46563898712SMax Reitz  backing_file=<str>     - File name of a base image
46663898712SMax Reitz  backing_fmt=<str>      - Image format of the base image
46763898712SMax Reitz  cluster_size=<size>    - qcow2 cluster size
46820ff903dSEric Blake  compat=<str>           - Compatibility level (v2 [0.10] or v3 [1.1])
469572ad978SDenis Plotnikov  compression_type=<str> - Compression method used for image cluster compression
4709b890bdcSKevin Wolf  data_file=<str>        - File name of an external data file
4716c3944dcSKevin Wolf  data_file_raw=<bool (on/off)> - The external data file must stay valid as a raw image
47263898712SMax Reitz  encrypt.cipher-alg=<str> - Name of encryption cipher algorithm
47363898712SMax Reitz  encrypt.cipher-mode=<str> - Name of encryption cipher mode
47463898712SMax Reitz  encrypt.format=<str>   - Encrypt the image, format choices: 'aes', 'luks'
47563898712SMax Reitz  encrypt.hash-alg=<str> - Name of encryption hash algorithm
47663898712SMax Reitz  encrypt.iter-time=<num> - Time to spend in PBKDF in milliseconds
47763898712SMax Reitz  encrypt.ivgen-alg=<str> - Name of IV generator algorithm
47863898712SMax Reitz  encrypt.ivgen-hash-alg=<str> - Name of IV generator hash algorithm
47963898712SMax Reitz  encrypt.key-secret=<str> - ID of secret providing qcow AES key or LUKS passphrase
48063898712SMax Reitz  encryption=<bool (on/off)> - Encrypt the image with format 'aes'. (Deprecated in favor of encrypt.format=aes)
4817be20252SAlberto Garcia  extended_l2=<bool (on/off)> - Extended L2 tables
482ffa244c8SKevin Wolf  extent_size_hint=<size> - Extent size hint for the image file, 0 to disable
48363898712SMax Reitz  lazy_refcounts=<bool (on/off)> - Postpone refcount updates
48463898712SMax Reitz  nocow=<bool (on/off)>  - Turn off copy-on-write (valid only on btrfs)
48563898712SMax Reitz  preallocation=<str>    - Preallocation mode (allowed values: off, metadata, falloc, full)
48663898712SMax Reitz  refcount_bits=<num>    - Width of a reference count entry in bits
48763898712SMax Reitz  size=<size>            - Virtual disk size
488a33cc31dSKevin Wolf
489a33cc31dSKevin WolfTesting: convert -O qcow2 -o ?,cluster_size=4k TEST_DIR/t.qcow2 TEST_DIR/t.qcow2.base
490a33cc31dSKevin WolfSupported options:
49163898712SMax Reitz  backing_file=<str>     - File name of a base image
49263898712SMax Reitz  backing_fmt=<str>      - Image format of the base image
49363898712SMax Reitz  cluster_size=<size>    - qcow2 cluster size
49420ff903dSEric Blake  compat=<str>           - Compatibility level (v2 [0.10] or v3 [1.1])
495572ad978SDenis Plotnikov  compression_type=<str> - Compression method used for image cluster compression
4969b890bdcSKevin Wolf  data_file=<str>        - File name of an external data file
4976c3944dcSKevin Wolf  data_file_raw=<bool (on/off)> - The external data file must stay valid as a raw image
49863898712SMax Reitz  encrypt.cipher-alg=<str> - Name of encryption cipher algorithm
49963898712SMax Reitz  encrypt.cipher-mode=<str> - Name of encryption cipher mode
50063898712SMax Reitz  encrypt.format=<str>   - Encrypt the image, format choices: 'aes', 'luks'
50163898712SMax Reitz  encrypt.hash-alg=<str> - Name of encryption hash algorithm
50263898712SMax Reitz  encrypt.iter-time=<num> - Time to spend in PBKDF in milliseconds
50363898712SMax Reitz  encrypt.ivgen-alg=<str> - Name of IV generator algorithm
50463898712SMax Reitz  encrypt.ivgen-hash-alg=<str> - Name of IV generator hash algorithm
50563898712SMax Reitz  encrypt.key-secret=<str> - ID of secret providing qcow AES key or LUKS passphrase
50663898712SMax Reitz  encryption=<bool (on/off)> - Encrypt the image with format 'aes'. (Deprecated in favor of encrypt.format=aes)
5077be20252SAlberto Garcia  extended_l2=<bool (on/off)> - Extended L2 tables
508ffa244c8SKevin Wolf  extent_size_hint=<size> - Extent size hint for the image file, 0 to disable
50963898712SMax Reitz  lazy_refcounts=<bool (on/off)> - Postpone refcount updates
51063898712SMax Reitz  nocow=<bool (on/off)>  - Turn off copy-on-write (valid only on btrfs)
51163898712SMax Reitz  preallocation=<str>    - Preallocation mode (allowed values: off, metadata, falloc, full)
51263898712SMax Reitz  refcount_bits=<num>    - Width of a reference count entry in bits
51363898712SMax Reitz  size=<size>            - Virtual disk size
514a33cc31dSKevin Wolf
515a33cc31dSKevin WolfTesting: convert -O qcow2 -o cluster_size=4k -o help TEST_DIR/t.qcow2 TEST_DIR/t.qcow2.base
516a33cc31dSKevin WolfSupported options:
51763898712SMax Reitz  backing_file=<str>     - File name of a base image
51863898712SMax Reitz  backing_fmt=<str>      - Image format of the base image
51963898712SMax Reitz  cluster_size=<size>    - qcow2 cluster size
52020ff903dSEric Blake  compat=<str>           - Compatibility level (v2 [0.10] or v3 [1.1])
521572ad978SDenis Plotnikov  compression_type=<str> - Compression method used for image cluster compression
5229b890bdcSKevin Wolf  data_file=<str>        - File name of an external data file
5236c3944dcSKevin Wolf  data_file_raw=<bool (on/off)> - The external data file must stay valid as a raw image
52463898712SMax Reitz  encrypt.cipher-alg=<str> - Name of encryption cipher algorithm
52563898712SMax Reitz  encrypt.cipher-mode=<str> - Name of encryption cipher mode
52663898712SMax Reitz  encrypt.format=<str>   - Encrypt the image, format choices: 'aes', 'luks'
52763898712SMax Reitz  encrypt.hash-alg=<str> - Name of encryption hash algorithm
52863898712SMax Reitz  encrypt.iter-time=<num> - Time to spend in PBKDF in milliseconds
52963898712SMax Reitz  encrypt.ivgen-alg=<str> - Name of IV generator algorithm
53063898712SMax Reitz  encrypt.ivgen-hash-alg=<str> - Name of IV generator hash algorithm
53163898712SMax Reitz  encrypt.key-secret=<str> - ID of secret providing qcow AES key or LUKS passphrase
53263898712SMax Reitz  encryption=<bool (on/off)> - Encrypt the image with format 'aes'. (Deprecated in favor of encrypt.format=aes)
5337be20252SAlberto Garcia  extended_l2=<bool (on/off)> - Extended L2 tables
534ffa244c8SKevin Wolf  extent_size_hint=<size> - Extent size hint for the image file, 0 to disable
53563898712SMax Reitz  lazy_refcounts=<bool (on/off)> - Postpone refcount updates
53663898712SMax Reitz  nocow=<bool (on/off)>  - Turn off copy-on-write (valid only on btrfs)
53763898712SMax Reitz  preallocation=<str>    - Preallocation mode (allowed values: off, metadata, falloc, full)
53863898712SMax Reitz  refcount_bits=<num>    - Width of a reference count entry in bits
53963898712SMax Reitz  size=<size>            - Virtual disk size
540a33cc31dSKevin Wolf
541a33cc31dSKevin WolfTesting: convert -O qcow2 -o cluster_size=4k -o ? TEST_DIR/t.qcow2 TEST_DIR/t.qcow2.base
542a33cc31dSKevin WolfSupported options:
54363898712SMax Reitz  backing_file=<str>     - File name of a base image
54463898712SMax Reitz  backing_fmt=<str>      - Image format of the base image
54563898712SMax Reitz  cluster_size=<size>    - qcow2 cluster size
54620ff903dSEric Blake  compat=<str>           - Compatibility level (v2 [0.10] or v3 [1.1])
547572ad978SDenis Plotnikov  compression_type=<str> - Compression method used for image cluster compression
5489b890bdcSKevin Wolf  data_file=<str>        - File name of an external data file
5496c3944dcSKevin Wolf  data_file_raw=<bool (on/off)> - The external data file must stay valid as a raw image
55063898712SMax Reitz  encrypt.cipher-alg=<str> - Name of encryption cipher algorithm
55163898712SMax Reitz  encrypt.cipher-mode=<str> - Name of encryption cipher mode
55263898712SMax Reitz  encrypt.format=<str>   - Encrypt the image, format choices: 'aes', 'luks'
55363898712SMax Reitz  encrypt.hash-alg=<str> - Name of encryption hash algorithm
55463898712SMax Reitz  encrypt.iter-time=<num> - Time to spend in PBKDF in milliseconds
55563898712SMax Reitz  encrypt.ivgen-alg=<str> - Name of IV generator algorithm
55663898712SMax Reitz  encrypt.ivgen-hash-alg=<str> - Name of IV generator hash algorithm
55763898712SMax Reitz  encrypt.key-secret=<str> - ID of secret providing qcow AES key or LUKS passphrase
55863898712SMax Reitz  encryption=<bool (on/off)> - Encrypt the image with format 'aes'. (Deprecated in favor of encrypt.format=aes)
5597be20252SAlberto Garcia  extended_l2=<bool (on/off)> - Extended L2 tables
560ffa244c8SKevin Wolf  extent_size_hint=<size> - Extent size hint for the image file, 0 to disable
56163898712SMax Reitz  lazy_refcounts=<bool (on/off)> - Postpone refcount updates
56263898712SMax Reitz  nocow=<bool (on/off)>  - Turn off copy-on-write (valid only on btrfs)
56363898712SMax Reitz  preallocation=<str>    - Preallocation mode (allowed values: off, metadata, falloc, full)
56463898712SMax Reitz  refcount_bits=<num>    - Width of a reference count entry in bits
56563898712SMax Reitz  size=<size>            - Virtual disk size
566a33cc31dSKevin Wolf
567b66ff2c2SEric BlakeTesting: convert -O qcow2 -o backing_fmt=qcow2,backing_file=TEST_DIR/t.qcow2,,help TEST_DIR/t.qcow2 TEST_DIR/t.qcow2.base
568a33cc31dSKevin Wolfqemu-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
569a33cc31dSKevin Wolf
570b66ff2c2SEric BlakeTesting: convert -O qcow2 -o backing_fmt=qcow2,backing_file=TEST_DIR/t.qcow2,,? TEST_DIR/t.qcow2 TEST_DIR/t.qcow2.base
571a33cc31dSKevin Wolfqemu-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
572a33cc31dSKevin Wolf
573a33cc31dSKevin WolfTesting: convert -O qcow2 -o backing_file=TEST_DIR/t.qcow2, -o help TEST_DIR/t.qcow2 TEST_DIR/t.qcow2.base
574a33cc31dSKevin Wolfqemu-img: Invalid option list: backing_file=TEST_DIR/t.qcow2,
575a33cc31dSKevin Wolf
576a33cc31dSKevin WolfTesting: convert -O qcow2 -o backing_file=TEST_DIR/t.qcow2 -o ,help TEST_DIR/t.qcow2 TEST_DIR/t.qcow2.base
577a33cc31dSKevin Wolfqemu-img: Invalid option list: ,help
578a33cc31dSKevin Wolf
579a33cc31dSKevin WolfTesting: convert -O qcow2 -o backing_file=TEST_DIR/t.qcow2 -o ,, -o help TEST_DIR/t.qcow2 TEST_DIR/t.qcow2.base
580a33cc31dSKevin Wolfqemu-img: Invalid option list: ,,
581a33cc31dSKevin Wolf
582a33cc31dSKevin WolfTesting: convert -O qcow2 -o help
583f4619af0SMax ReitzSupported qcow2 options:
58463898712SMax Reitz  backing_file=<str>     - File name of a base image
58563898712SMax Reitz  backing_fmt=<str>      - Image format of the base image
58663898712SMax Reitz  cluster_size=<size>    - qcow2 cluster size
58720ff903dSEric Blake  compat=<str>           - Compatibility level (v2 [0.10] or v3 [1.1])
588572ad978SDenis Plotnikov  compression_type=<str> - Compression method used for image cluster compression
5899b890bdcSKevin Wolf  data_file=<str>        - File name of an external data file
5906c3944dcSKevin Wolf  data_file_raw=<bool (on/off)> - The external data file must stay valid as a raw image
59163898712SMax Reitz  encrypt.cipher-alg=<str> - Name of encryption cipher algorithm
59263898712SMax Reitz  encrypt.cipher-mode=<str> - Name of encryption cipher mode
59363898712SMax Reitz  encrypt.format=<str>   - Encrypt the image, format choices: 'aes', 'luks'
59463898712SMax Reitz  encrypt.hash-alg=<str> - Name of encryption hash algorithm
59563898712SMax Reitz  encrypt.iter-time=<num> - Time to spend in PBKDF in milliseconds
59663898712SMax Reitz  encrypt.ivgen-alg=<str> - Name of IV generator algorithm
59763898712SMax Reitz  encrypt.ivgen-hash-alg=<str> - Name of IV generator hash algorithm
59863898712SMax Reitz  encrypt.key-secret=<str> - ID of secret providing qcow AES key or LUKS passphrase
59963898712SMax Reitz  encryption=<bool (on/off)> - Encrypt the image with format 'aes'. (Deprecated in favor of encrypt.format=aes)
6007be20252SAlberto Garcia  extended_l2=<bool (on/off)> - Extended L2 tables
60163898712SMax Reitz  lazy_refcounts=<bool (on/off)> - Postpone refcount updates
60263898712SMax Reitz  preallocation=<str>    - Preallocation mode (allowed values: off, metadata, falloc, full)
60363898712SMax Reitz  refcount_bits=<num>    - Width of a reference count entry in bits
60463898712SMax Reitz  size=<size>            - Virtual disk size
605a33cc31dSKevin Wolf
606f4619af0SMax ReitzThe protocol level may support further options.
607f4619af0SMax ReitzSpecify the target filename to include those options.
608f4619af0SMax Reitz
609a33cc31dSKevin WolfTesting: convert -o help
610f4619af0SMax ReitzSupported raw options:
61163898712SMax Reitz  size=<size>            - Virtual disk size
612a33cc31dSKevin Wolf
613f4619af0SMax ReitzThe protocol level may support further options.
614f4619af0SMax ReitzSpecify the target filename to include those options.
615f4619af0SMax Reitz
616e53995ebSMax ReitzTesting: convert -O bochs -o help
617e53995ebSMax Reitzqemu-img: Format driver 'bochs' does not support image creation
618e53995ebSMax Reitz
6198ba4f10fSFam Zheng=== convert: -C and other options ===
6208ba4f10fSFam Zheng
6218ba4f10fSFam ZhengTesting: convert -C -S 4k -O qcow2 TEST_DIR/t.qcow2 TEST_DIR/t.qcow2.target
6228ba4f10fSFam Zhengqemu-img: Cannot enable copy offloading when -S is used
6238ba4f10fSFam Zheng
6248ba4f10fSFam ZhengTesting: convert -C -S 8k -O qcow2 TEST_DIR/t.qcow2 TEST_DIR/t.qcow2.target
6258ba4f10fSFam Zhengqemu-img: Cannot enable copy offloading when -S is used
6268ba4f10fSFam Zheng
6278ba4f10fSFam ZhengTesting: convert -C -c -O qcow2 TEST_DIR/t.qcow2 TEST_DIR/t.qcow2.target
6288ba4f10fSFam Zhengqemu-img: Cannot enable copy offloading when -c is used
6298ba4f10fSFam Zheng
63021c1ce59SMax ReitzTesting: convert -C --salvage -O qcow2 TEST_DIR/t.qcow2 TEST_DIR/t.qcow2.target
63121c1ce59SMax Reitzqemu-img: Cannot use copy offloading in salvaging mode
63221c1ce59SMax Reitz
633a33cc31dSKevin Wolf=== amend: Options specified more than once ===
634a33cc31dSKevin Wolf
635a33cc31dSKevin WolfTesting: amend -f foo -f qcow2 -o lazy_refcounts=on TEST_DIR/t.qcow2
636d1103231SMichael Muellerimage: TEST_DIR/t.IMGFMT
637d1103231SMichael Muellerfile format: IMGFMT
638de38b500SEric Blakevirtual size: 128 MiB (134217728 bytes)
639a33cc31dSKevin Wolfcluster_size: 65536
640a33cc31dSKevin WolfFormat specific information:
641a33cc31dSKevin Wolf    compat: 1.1
642*dba5aee4SVladimir Sementsov-Ogievskiy    compression type: COMPRESSION_TYPE
643a33cc31dSKevin Wolf    lazy refcounts: true
6440709c5a1SMax Reitz    refcount bits: 16
6459009b196SMax Reitz    corrupt: false
6467be20252SAlberto Garcia    extended l2: false
647a33cc31dSKevin Wolf
648a33cc31dSKevin WolfTesting: amend -f qcow2 -o size=130M -o lazy_refcounts=off TEST_DIR/t.qcow2
649d1103231SMichael Muellerimage: TEST_DIR/t.IMGFMT
650d1103231SMichael Muellerfile format: IMGFMT
651de38b500SEric Blakevirtual size: 130 MiB (136314880 bytes)
652a33cc31dSKevin Wolfcluster_size: 65536
653a33cc31dSKevin WolfFormat specific information:
654a33cc31dSKevin Wolf    compat: 1.1
655*dba5aee4SVladimir Sementsov-Ogievskiy    compression type: COMPRESSION_TYPE
656a33cc31dSKevin Wolf    lazy refcounts: false
6570709c5a1SMax Reitz    refcount bits: 16
6589009b196SMax Reitz    corrupt: false
6597be20252SAlberto Garcia    extended l2: false
660a33cc31dSKevin Wolf
661a33cc31dSKevin WolfTesting: amend -f qcow2 -o size=8M -o lazy_refcounts=on -o size=132M TEST_DIR/t.qcow2
662d1103231SMichael Muellerimage: TEST_DIR/t.IMGFMT
663d1103231SMichael Muellerfile format: IMGFMT
664de38b500SEric Blakevirtual size: 132 MiB (138412032 bytes)
665a33cc31dSKevin Wolfcluster_size: 65536
666a33cc31dSKevin WolfFormat specific information:
667a33cc31dSKevin Wolf    compat: 1.1
668*dba5aee4SVladimir Sementsov-Ogievskiy    compression type: COMPRESSION_TYPE
669a33cc31dSKevin Wolf    lazy refcounts: true
6700709c5a1SMax Reitz    refcount bits: 16
6719009b196SMax Reitz    corrupt: false
6727be20252SAlberto Garcia    extended l2: false
673a33cc31dSKevin Wolf
674a33cc31dSKevin WolfTesting: amend -f qcow2 -o size=4M,size=148M TEST_DIR/t.qcow2
6751b53eab2SMax Reitzimage: TEST_DIR/t.IMGFMT
6761b53eab2SMax Reitzfile format: IMGFMT
677de38b500SEric Blakevirtual size: 148 MiB (155189248 bytes)
678a33cc31dSKevin Wolfcluster_size: 65536
679a33cc31dSKevin Wolf
680a33cc31dSKevin Wolf=== amend: help for -o ===
681a33cc31dSKevin Wolf
682a33cc31dSKevin WolfTesting: amend -f qcow2 -o help TEST_DIR/t.qcow2
6830b6786a9SMaxim LevitskyAmend options for 'qcow2':
68463898712SMax Reitz  backing_file=<str>     - File name of a base image
68563898712SMax Reitz  backing_fmt=<str>      - Image format of the base image
68620ff903dSEric Blake  compat=<str>           - Compatibility level (v2 [0.10] or v3 [1.1])
6879b890bdcSKevin Wolf  data_file=<str>        - File name of an external data file
6886c3944dcSKevin Wolf  data_file_raw=<bool (on/off)> - The external data file must stay valid as a raw image
68990766d9dSMaxim Levitsky  encrypt.iter-time=<num> - Time to spend in PBKDF in milliseconds
69090766d9dSMaxim Levitsky  encrypt.keyslot=<num>  - Select a single keyslot to modify explicitly
69190766d9dSMaxim Levitsky  encrypt.new-secret=<str> - New secret to set in the matching keyslots. Empty string to erase
69290766d9dSMaxim Levitsky  encrypt.old-secret=<str> - Select all keyslots that match this password
69390766d9dSMaxim Levitsky  encrypt.state=<str>    - Select new state of affected keyslots (active/inactive)
69463898712SMax Reitz  lazy_refcounts=<bool (on/off)> - Postpone refcount updates
69563898712SMax Reitz  refcount_bits=<num>    - Width of a reference count entry in bits
69663898712SMax Reitz  size=<size>            - Virtual disk size
69751641351SMax Reitz
698a33cc31dSKevin WolfTesting: amend -f qcow2 -o ? TEST_DIR/t.qcow2
6990b6786a9SMaxim LevitskyAmend options for 'qcow2':
70063898712SMax Reitz  backing_file=<str>     - File name of a base image
70163898712SMax Reitz  backing_fmt=<str>      - Image format of the base image
70220ff903dSEric Blake  compat=<str>           - Compatibility level (v2 [0.10] or v3 [1.1])
7039b890bdcSKevin Wolf  data_file=<str>        - File name of an external data file
7046c3944dcSKevin Wolf  data_file_raw=<bool (on/off)> - The external data file must stay valid as a raw image
70590766d9dSMaxim Levitsky  encrypt.iter-time=<num> - Time to spend in PBKDF in milliseconds
70690766d9dSMaxim Levitsky  encrypt.keyslot=<num>  - Select a single keyslot to modify explicitly
70790766d9dSMaxim Levitsky  encrypt.new-secret=<str> - New secret to set in the matching keyslots. Empty string to erase
70890766d9dSMaxim Levitsky  encrypt.old-secret=<str> - Select all keyslots that match this password
70990766d9dSMaxim Levitsky  encrypt.state=<str>    - Select new state of affected keyslots (active/inactive)
71063898712SMax Reitz  lazy_refcounts=<bool (on/off)> - Postpone refcount updates
71163898712SMax Reitz  refcount_bits=<num>    - Width of a reference count entry in bits
71263898712SMax Reitz  size=<size>            - Virtual disk size
71351641351SMax Reitz
714a33cc31dSKevin WolfTesting: amend -f qcow2 -o cluster_size=4k,help TEST_DIR/t.qcow2
7150b6786a9SMaxim LevitskyAmend options for 'qcow2':
71663898712SMax Reitz  backing_file=<str>     - File name of a base image
71763898712SMax Reitz  backing_fmt=<str>      - Image format of the base image
71820ff903dSEric Blake  compat=<str>           - Compatibility level (v2 [0.10] or v3 [1.1])
7199b890bdcSKevin Wolf  data_file=<str>        - File name of an external data file
7206c3944dcSKevin Wolf  data_file_raw=<bool (on/off)> - The external data file must stay valid as a raw image
72190766d9dSMaxim Levitsky  encrypt.iter-time=<num> - Time to spend in PBKDF in milliseconds
72290766d9dSMaxim Levitsky  encrypt.keyslot=<num>  - Select a single keyslot to modify explicitly
72390766d9dSMaxim Levitsky  encrypt.new-secret=<str> - New secret to set in the matching keyslots. Empty string to erase
72490766d9dSMaxim Levitsky  encrypt.old-secret=<str> - Select all keyslots that match this password
72590766d9dSMaxim Levitsky  encrypt.state=<str>    - Select new state of affected keyslots (active/inactive)
72663898712SMax Reitz  lazy_refcounts=<bool (on/off)> - Postpone refcount updates
72763898712SMax Reitz  refcount_bits=<num>    - Width of a reference count entry in bits
72863898712SMax Reitz  size=<size>            - Virtual disk size
72951641351SMax Reitz
730a33cc31dSKevin WolfTesting: amend -f qcow2 -o cluster_size=4k,? TEST_DIR/t.qcow2
7310b6786a9SMaxim LevitskyAmend options for 'qcow2':
73263898712SMax Reitz  backing_file=<str>     - File name of a base image
73363898712SMax Reitz  backing_fmt=<str>      - Image format of the base image
73420ff903dSEric Blake  compat=<str>           - Compatibility level (v2 [0.10] or v3 [1.1])
7359b890bdcSKevin Wolf  data_file=<str>        - File name of an external data file
7366c3944dcSKevin Wolf  data_file_raw=<bool (on/off)> - The external data file must stay valid as a raw image
73790766d9dSMaxim Levitsky  encrypt.iter-time=<num> - Time to spend in PBKDF in milliseconds
73890766d9dSMaxim Levitsky  encrypt.keyslot=<num>  - Select a single keyslot to modify explicitly
73990766d9dSMaxim Levitsky  encrypt.new-secret=<str> - New secret to set in the matching keyslots. Empty string to erase
74090766d9dSMaxim Levitsky  encrypt.old-secret=<str> - Select all keyslots that match this password
74190766d9dSMaxim Levitsky  encrypt.state=<str>    - Select new state of affected keyslots (active/inactive)
74263898712SMax Reitz  lazy_refcounts=<bool (on/off)> - Postpone refcount updates
74363898712SMax Reitz  refcount_bits=<num>    - Width of a reference count entry in bits
74463898712SMax Reitz  size=<size>            - Virtual disk size
74551641351SMax Reitz
746a33cc31dSKevin WolfTesting: amend -f qcow2 -o help,cluster_size=4k TEST_DIR/t.qcow2
7470b6786a9SMaxim LevitskyAmend options for 'qcow2':
74863898712SMax Reitz  backing_file=<str>     - File name of a base image
74963898712SMax Reitz  backing_fmt=<str>      - Image format of the base image
75020ff903dSEric Blake  compat=<str>           - Compatibility level (v2 [0.10] or v3 [1.1])
7519b890bdcSKevin Wolf  data_file=<str>        - File name of an external data file
7526c3944dcSKevin Wolf  data_file_raw=<bool (on/off)> - The external data file must stay valid as a raw image
75390766d9dSMaxim Levitsky  encrypt.iter-time=<num> - Time to spend in PBKDF in milliseconds
75490766d9dSMaxim Levitsky  encrypt.keyslot=<num>  - Select a single keyslot to modify explicitly
75590766d9dSMaxim Levitsky  encrypt.new-secret=<str> - New secret to set in the matching keyslots. Empty string to erase
75690766d9dSMaxim Levitsky  encrypt.old-secret=<str> - Select all keyslots that match this password
75790766d9dSMaxim Levitsky  encrypt.state=<str>    - Select new state of affected keyslots (active/inactive)
75863898712SMax Reitz  lazy_refcounts=<bool (on/off)> - Postpone refcount updates
75963898712SMax Reitz  refcount_bits=<num>    - Width of a reference count entry in bits
76063898712SMax Reitz  size=<size>            - Virtual disk size
76151641351SMax Reitz
762a33cc31dSKevin WolfTesting: amend -f qcow2 -o ?,cluster_size=4k TEST_DIR/t.qcow2
7630b6786a9SMaxim LevitskyAmend options for 'qcow2':
76463898712SMax Reitz  backing_file=<str>     - File name of a base image
76563898712SMax Reitz  backing_fmt=<str>      - Image format of the base image
76620ff903dSEric Blake  compat=<str>           - Compatibility level (v2 [0.10] or v3 [1.1])
7679b890bdcSKevin Wolf  data_file=<str>        - File name of an external data file
7686c3944dcSKevin Wolf  data_file_raw=<bool (on/off)> - The external data file must stay valid as a raw image
76990766d9dSMaxim Levitsky  encrypt.iter-time=<num> - Time to spend in PBKDF in milliseconds
77090766d9dSMaxim Levitsky  encrypt.keyslot=<num>  - Select a single keyslot to modify explicitly
77190766d9dSMaxim Levitsky  encrypt.new-secret=<str> - New secret to set in the matching keyslots. Empty string to erase
77290766d9dSMaxim Levitsky  encrypt.old-secret=<str> - Select all keyslots that match this password
77390766d9dSMaxim Levitsky  encrypt.state=<str>    - Select new state of affected keyslots (active/inactive)
77463898712SMax Reitz  lazy_refcounts=<bool (on/off)> - Postpone refcount updates
77563898712SMax Reitz  refcount_bits=<num>    - Width of a reference count entry in bits
77663898712SMax Reitz  size=<size>            - Virtual disk size
77751641351SMax Reitz
778a33cc31dSKevin WolfTesting: amend -f qcow2 -o cluster_size=4k -o help TEST_DIR/t.qcow2
7790b6786a9SMaxim LevitskyAmend options for 'qcow2':
78063898712SMax Reitz  backing_file=<str>     - File name of a base image
78163898712SMax Reitz  backing_fmt=<str>      - Image format of the base image
78220ff903dSEric Blake  compat=<str>           - Compatibility level (v2 [0.10] or v3 [1.1])
7839b890bdcSKevin Wolf  data_file=<str>        - File name of an external data file
7846c3944dcSKevin Wolf  data_file_raw=<bool (on/off)> - The external data file must stay valid as a raw image
78590766d9dSMaxim Levitsky  encrypt.iter-time=<num> - Time to spend in PBKDF in milliseconds
78690766d9dSMaxim Levitsky  encrypt.keyslot=<num>  - Select a single keyslot to modify explicitly
78790766d9dSMaxim Levitsky  encrypt.new-secret=<str> - New secret to set in the matching keyslots. Empty string to erase
78890766d9dSMaxim Levitsky  encrypt.old-secret=<str> - Select all keyslots that match this password
78990766d9dSMaxim Levitsky  encrypt.state=<str>    - Select new state of affected keyslots (active/inactive)
79063898712SMax Reitz  lazy_refcounts=<bool (on/off)> - Postpone refcount updates
79163898712SMax Reitz  refcount_bits=<num>    - Width of a reference count entry in bits
79263898712SMax Reitz  size=<size>            - Virtual disk size
79351641351SMax Reitz
794a33cc31dSKevin WolfTesting: amend -f qcow2 -o cluster_size=4k -o ? TEST_DIR/t.qcow2
7950b6786a9SMaxim LevitskyAmend options for 'qcow2':
79663898712SMax Reitz  backing_file=<str>     - File name of a base image
79763898712SMax Reitz  backing_fmt=<str>      - Image format of the base image
79820ff903dSEric Blake  compat=<str>           - Compatibility level (v2 [0.10] or v3 [1.1])
7999b890bdcSKevin Wolf  data_file=<str>        - File name of an external data file
8006c3944dcSKevin Wolf  data_file_raw=<bool (on/off)> - The external data file must stay valid as a raw image
80190766d9dSMaxim Levitsky  encrypt.iter-time=<num> - Time to spend in PBKDF in milliseconds
80290766d9dSMaxim Levitsky  encrypt.keyslot=<num>  - Select a single keyslot to modify explicitly
80390766d9dSMaxim Levitsky  encrypt.new-secret=<str> - New secret to set in the matching keyslots. Empty string to erase
80490766d9dSMaxim Levitsky  encrypt.old-secret=<str> - Select all keyslots that match this password
80590766d9dSMaxim Levitsky  encrypt.state=<str>    - Select new state of affected keyslots (active/inactive)
80663898712SMax Reitz  lazy_refcounts=<bool (on/off)> - Postpone refcount updates
80763898712SMax Reitz  refcount_bits=<num>    - Width of a reference count entry in bits
80863898712SMax Reitz  size=<size>            - Virtual disk size
80951641351SMax Reitz
810a33cc31dSKevin WolfTesting: amend -f qcow2 -o backing_file=TEST_DIR/t.qcow2,,help TEST_DIR/t.qcow2
8115a385bf5SEric Blakeqemu-img: Cannot amend the backing file
8125a385bf5SEric BlakeYou can use 'qemu-img rebase' instead.
813a33cc31dSKevin Wolf
814a33cc31dSKevin WolfTesting: rebase -u -b  -f qcow2 TEST_DIR/t.qcow2
815a33cc31dSKevin Wolf
816a33cc31dSKevin WolfTesting: amend -f qcow2 -o backing_file=TEST_DIR/t.qcow2,,? TEST_DIR/t.qcow2
8175a385bf5SEric Blakeqemu-img: Cannot amend the backing file
8185a385bf5SEric BlakeYou can use 'qemu-img rebase' instead.
819a33cc31dSKevin Wolf
820a33cc31dSKevin WolfTesting: rebase -u -b  -f qcow2 TEST_DIR/t.qcow2
821a33cc31dSKevin Wolf
822a33cc31dSKevin WolfTesting: amend -f qcow2 -o backing_file=TEST_DIR/t.qcow2, -o help TEST_DIR/t.qcow2
823a33cc31dSKevin Wolfqemu-img: Invalid option list: backing_file=TEST_DIR/t.qcow2,
824a33cc31dSKevin Wolf
825a33cc31dSKevin WolfTesting: amend -f qcow2 -o backing_file=TEST_DIR/t.qcow2 -o ,help TEST_DIR/t.qcow2
826a33cc31dSKevin Wolfqemu-img: Invalid option list: ,help
827a33cc31dSKevin Wolf
828a33cc31dSKevin WolfTesting: amend -f qcow2 -o backing_file=TEST_DIR/t.qcow2 -o ,, -o help TEST_DIR/t.qcow2
829a33cc31dSKevin Wolfqemu-img: Invalid option list: ,,
830a33cc31dSKevin Wolf
831a33cc31dSKevin WolfTesting: amend -f qcow2 -o help
8320b6786a9SMaxim LevitskyAmend options for 'qcow2':
83363898712SMax Reitz  backing_file=<str>     - File name of a base image
83463898712SMax Reitz  backing_fmt=<str>      - Image format of the base image
83520ff903dSEric Blake  compat=<str>           - Compatibility level (v2 [0.10] or v3 [1.1])
8369b890bdcSKevin Wolf  data_file=<str>        - File name of an external data file
8376c3944dcSKevin Wolf  data_file_raw=<bool (on/off)> - The external data file must stay valid as a raw image
83890766d9dSMaxim Levitsky  encrypt.iter-time=<num> - Time to spend in PBKDF in milliseconds
83990766d9dSMaxim Levitsky  encrypt.keyslot=<num>  - Select a single keyslot to modify explicitly
84090766d9dSMaxim Levitsky  encrypt.new-secret=<str> - New secret to set in the matching keyslots. Empty string to erase
84190766d9dSMaxim Levitsky  encrypt.old-secret=<str> - Select all keyslots that match this password
84290766d9dSMaxim Levitsky  encrypt.state=<str>    - Select new state of affected keyslots (active/inactive)
84363898712SMax Reitz  lazy_refcounts=<bool (on/off)> - Postpone refcount updates
84463898712SMax Reitz  refcount_bits=<num>    - Width of a reference count entry in bits
84563898712SMax Reitz  size=<size>            - Virtual disk size
846a33cc31dSKevin Wolf
8470ef5a8e6SMax ReitzTesting: amend -o help
8480ef5a8e6SMax Reitzqemu-img: Expecting one image file name
849e53995ebSMax Reitz
850e53995ebSMax ReitzTesting: amend -f bochs -o help
851e53995ebSMax Reitzqemu-img: Format driver 'bochs' does not support option amendment
852a33cc31dSKevin Wolf*** done
853