Patchwork [3/3] curl: Add usage documentation

mail settings
Submitter Matthew Booth
Date April 30, 2014, 2:20 p.m.
Message ID <>
Download mbox | patch
Permalink /patch/344178/
State New
Headers show


Matthew Booth - April 30, 2014, 2:20 p.m.
Signed-off-by: Matthew Booth <>
 qemu-options.hx | 70 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 70 insertions(+)


diff --git a/qemu-options.hx b/qemu-options.hx
index 781af14..e076e1c 100644
--- a/qemu-options.hx
+++ b/qemu-options.hx
@@ -2191,6 +2191,76 @@  qemu-system-x86_64 --drive file=gluster://
 @end example
 See also @url{}.
+QEMU supports read-only access to files accessed over http(s), ftp(s) and tftp.
+Syntax using a single filename:
+@end example
+@table @option
+@item protocol
+'http', 'https', 'ftp', 'ftps', or 'tftp'.
+@item username
+Optional username for authentication to the remote server.
+@item password
+Optional password for authentication to the remote server.
+@item host
+Address of the remote server.
+@item path
+Path on the remote server, including any query string.
+@end table
+and options are:
+@table @option
+@item readahead
+The amount of data to read ahead with each range request to the remote server.
+This value may optionally have the suffix 'T', 'G', 'M', 'K', 'k' or 'b'. If it
+does not have a suffix, it will be assumed to be in bytes. The value must be a
+multiple of 512 bytes. It defaults to 256k.
+@item sslverify
+Whether to verify the remote server's certificate when connecting over SSL. It
+can have the value 'on' or 'off'. It defaults to 'on'.
+@end table
+Note that when specifying options there must also be a trailing ':'.
+When passing options to qemu explicitly, @option{driver} is the value of
+<protocol>, the entire URL, i.e.
+<protocol>://[<username>[:<password>]@@]<host>/<path>, is passed in
+@option{url}, and @option{readahead} and @option{sslverify} are passed
+separately with values as described above.
+Example: boot from a remote Fedora 20 live ISO image
+qemu-system-x86_64 --drive media=cdrom,file=,readonly
+qemu-system-x86_64 --drive media=cdrom,file.driver=http,file.url=,readonly
+@end example
+Example: boot from a remote Fedora 20 cloud image using a local overlay for
+writes, copy-on-read, and a reduced readahead of 64k
+qemu-img create -f qcow2 -o backing_file='' /tmp/Fedora-x86_64-20-20131211.1-sda.qcow2
+qemu-system-x86_64 -drive file=/tmp/Fedora-x86_64-20-20131211.1-sda.qcow2,copy-on-read=on
+@end example
+Example: boot from an image stored on a VMware vSphere server with a self-signed
+certificate using a local overlay for writes
+qemu-img create -f qcow2 -o backing_file='' /tmp/test.qcow2
+qemu-system-x86_64 -drive file=/tmp/test.qcow2
+@end example