davix-ls(1)

1DAVIX-LS(1)                      listing tool                      DAVIX-LS(1)
2
3
4

NAME

6       davix-ls - Listing tool based on libdavix
7

SYNOPSIS

9                davix-ls [options]... url
10

DESCRIPTION

12       davix-ls  is a tool to list resources in directories or collection with
13       HTTP, Webdav or REST compatible services.
14       The command supports the WebDav (dav(s)://) and S3 (s3(s)://).
15
16       davix-ls is powered by libdavix. See libdavix(3) for details.
17
18
19

OPTIONS

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

EXAMPLES

114       WebDav directory file listing
115               davix-ls dav://example.org/dir1/dir2/
116
117       AWS S3 bucket listing
118               davix-ls s3://bucket.example.org/collection/
119
120       Long listing with WebDav with VOMS authentication in a Grid environment
121
122               davix-ls -P grid davs://grid-storage.example.org/dir1/dir2/
123
124       Long listing with WebDav + TLS directory file listing
125               davix-ls -l davs://example.org/dir1/dir2/
126
127

LINKS

133       http://dmc.web.cern.ch/projects/davix/home
134
135
136

AUTHORS

138       Adrien Devresse <adrien.devresse@cern.ch>, IT-SDC-ID, CERN
139
140
141
142davix                         $Date: 2014/05/24 $                  DAVIX-LS(1)