davix-get(1)

1DAVIX-GET(1)                     download tool                    DAVIX-GET(1)
2
3
4

NAME

6       davix-get - Download tool based on libdavix
7

SYNOPSIS

9                davix-get [options]... url          davix-get [options]... url
10       local_file
11
12
13

DESCRIPTION

15       davix-get is a tool to download resources from  HTTP,  Webdav  or  REST
16       compatible services.
17       The command supports the protocol Http (http(s)://), WebDav (dav(s)://)
18       and S3 (s3(s)://).
19
20       Target resources can either be a single file or a collection.
21       In the case of collection, all sub-collections will also be downloaded.
22
23       davix-get is powered by libdavix. See libdavix(3) for details.
24
25
26

OPTIONS

28       Common Options:
29
30         --debug
31            Debug mode
32
33         --header, -H
34            Add a header field to the request (eg: -H "Depth: 1" )
35
36         --help, -h
37            Display this help message
38
39         --metalink OPT
40            Metalink support. (OPT=failover[default]|no)
41
42         --module, -P PLUGIN_NAME
43            Load a plugin or profile by name
44
45         --redirection OPT
46            Transparent redirection support. (OPT=yes[default]|no)
47
48         --proxy, -x URL
49            SOCKS5  proxy  server  URL.  (ex:  socks5://login:pass@socks.exam‐
50            ple.org)
51
52         --trace
53            Traces specific scope(s), options include:
54               file - Davix file interface
55               posix - Davix POSIX interface
56               xml - XML parser output
57               ssl - SSL and certs details
58               header - HTTP queries headers
59               body - HTTP bodies
60               chain - IO chains info
61               core - Config and Davix command line tools info
62               grid - Misc info from 3rd parties
63               socket - Socket info
64               locks - WebDAV locking info
65               all - Traces everything
66
67
68         --version
69            Display version
70
71       Security Options:
72
73         --capath CA_PATH
74            Add an additional certificate authority directory
75
76         --cert, -E CRED_PATH
77            Client Certificate in PEM format
78
79         --key priv_path
80            Private key in PEM format
81
82         --insecure, -k
83            Disable SSL credential checks
84
85         --userlogin
86            User login for login/password authentication
87
88         --userpass
89            User password for login/password authentication
90
91         --s3secretkey
92            AWS S3 authentication: secret key
93
94         --s3accesskey
95            AWS S3 authentication: access key
96
97         --s3region
98            AWS S3 authentication: region
99
100         --s3token
101            AWS S3 security token - used along with STS temporary credentials
102
103         --s3alternate
104            Specify this flag if you need to use a path-based S3 URL
105
106         --azurekey
107            Azure authentication key
108
109
110

EXAMPLES

112       Download content and print it on stdout
113               davix-get http://example.org/dir1/dir2/file1
114
115       Download content to a local file
116               davix-get s3://bucket.example.org/collection/file2 /tmp/file2
117
118       Download  content  to  a  local file with VOMS authentication in a Grid
119       environment
120               davix-get  -P  grid  davs://grid-storage.example.org/dir1/file1
121       /tmp/file1
122
123       Download content and print it to stdout, using a OAuth token
124               davix-get  https://example.org/dir1/tmpfile  -H "Authorization:
125       Bearer mytoken"
126
127       Download collection to a local directory
128               davix-get dav://example.org/dir ./mydir
129
130

LINKS

136       http://dmc.web.cern.ch/projects/davix/home
137
138
139

AUTHORS

141       Adrien Devresse <adrien.devresse@cern.ch>, IT-SDC-ID, CERN
142
143
144
145davix                         $Date: 2014/05/24 $                 DAVIX-GET(1)