DAVIX-LS(1)

NAME
davix-ls - Listing tool based on libdavix

SYNOPSIS

        davix-ls [options]... url

DESCRIPTION
davix-ls is a tool to list resources in directories or collection with HTTP, Webdav or REST compatible services.
The command supports the WebDav (dav(s)://) and S3 (s3(s)://).

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

OPTIONS

Listing Options:

    -l --long-list:
    long Listing mode

    --s3-listing:
    S3 bucket listing mode - flat, semi or hierarchical(default)

    --s3-maxkeys:
    Maximum number of entries returns by S3 list bucket request. default: 10000

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

WebDav directory file listing
        davix-ls dav://example.org/dir1/dir2/

AWS S3 bucket listing
        davix-ls s3://bucket.example.org/collection/

Long listing with WebDav with VOMS authentication in a Grid environment
        davix-ls -P grid davs://grid-storage.example.org/dir1/dir2/

Long listing with WebDav + TLS directory file listing
        davix-ls -l davs://example.org/dir1/dir2/

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

LINKS
http://dmc.web.cern.ch/projects/davix/home

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