davix-get man page

davix-get — Download tool based on libdavix

Synopsis

davix-get [options]... url davix-get [options]... url local_file

Description

davix-get is a tool to download resources from HTTP, Webdav or REST compatible services.
The command supports the protocol Http (http(s)://), WebDav (dav(s)://) and S3 (s3(s)://).

Target resources can either be a single file or a collection.
In the case of collection, all sub-collections will also be downloaded.

davix-get is powered by libdavix. See libdavix(3) for details.

Options

Common Options:

--debug

Debug mode

--header, -H

Add a header field to the request (eg: -H "Depth: 1" )

--help, -h

Display this help message

--metalink OPT

Metalink support. (OPT=failover[default]|no)

--module, -P PLUGIN_NAME

Load a plugin or profile by name

--redirection OPT

Transparent redirection support. (OPT=yes[default]|no)

--proxy, -x URL

SOCKS5 proxy server URL. (ex: socks5://login:pass@socks.example.org)

--trace

Traces specific scope(s), options include:

file - Davix file interface

posix - Davix POSIX interface

xml - XML parser output

ssl - SSL and certs details

header - HTTP queries headers

body - HTTP bodies

chain - IO chains info

core - Config and Davix command line tools info

grid - Misc info from 3rd parties

socket - Socket info

locks - WebDAV locking info

all - Traces everything

--version

Display version

Security Options:

--capath CA_PATH

Add an additional certificate authority directory

--cert, -E CRED_PATH

Client Certificate in PEM format

--key priv_path

Private key in PEM format

--insecure, -k

Disable SSL credential checks

--userlogin

User login for login/password authentication

--userpass

User password for login/password authentication

--s3secretkey

AWS S3 authentication: secret key

--s3accesskey

AWS S3 authentication: access key

--s3region

AWS S3 authentication: region

--s3token

AWS S3 security token - used along with STS temporary credentials

--s3alternate

Specify this flag if you need to use a path-based S3 URL

--azurekey

Azure authentication key

Examples

Download content and print it on stdout
davix-get http://example.org/dir1/dir2/file1

Download content to a local file
davix-get s3://bucket.example.org/collection/file2 /tmp/file2

Download content to a local file with VOMS authentication in a Grid environment
davix-get -P grid davs://grid-storage.example.org/dir1/file1 /tmp/file1

Download content and print it to stdout, using a OAuth token
davix-get https://example.org/dir1/tmpfile -H "Authorization: Bearer mytoken"

Download collection to a local directory
davix-get dav://example.org/dir ./mydir

See Also

libdavix(3),davix-get(1),davix-put(1),

Authors

Adrien Devresse <adrien.devresse@cern.ch>, IT-SDC-ID, CERN

Referenced By

davix-http(1), davix-ls(1), davix-mv(1), libdavix(3).

$Date: 2014/05/24 $ davix download tool