DAVIX-LS(1)

💖 DAVIX-LS(1) — the listing tool 💖

okay bestie, so this is davix-ls, a listing tool from the libdavix family (that's section 1 of the manual, iykyk). it lives in your terminal, it's powered by libdavix, and it's about to make directories make sense.

✨ SYNOPSIS ✨

davix-ls [options]... url

🌸 DESCRIPTION 🌸

so davix-ls is literally the tool you use to list resources inside directories or collections that live on HTTP, WebDav or REST compatible services. no cap. it's giving "ls but for the internet" 💅

and the way it supports both WebDav (dav://, davs://) and S3 (s3://, s3s://)?? obsessed. 🦋

davix-ls is powered by libdavix, bestie. if you wanna go deeper, check libdavix(3) for the details. 🫶

👑 OPTIONS 👑

🎀 Listing Options 🎀

• -l, --long-list — long listing mode. yes, the long one. the main character version of listing. ✨
• --s3-listing — S3 bucket listing mode — flat, semi or hierarchical (hierarchical is the default, in case you were wondering). 🍓
• --s3-maxkeys — the maximum number of entries that get returned by an S3 list bucket request. default is 10000. don't be greedy bestie. 😭

🌈 Common Options 🌈

• --debug — debug mode. turn it on when you want the tea. 🍵
• --header, -H — add a header field to the request (for example: -H "Depth: 1"). very "let me speak to the server directly" of you. 💅
• --help, -h — display this help message. we love a helpful icon. ✨
• --metalink OPT — Metalink support. OPT can be failover (that's the default) or no. 🧚
• --module, -P PLUGIN_NAME — load a plugin or profile by its name. 🌟
• --redirection OPT — transparent redirection support. OPT can be yes (the default) or no. 🔀
• --proxy, -x URL — SOCKS5 proxy server URL. example: socks5://login:pass@socks.example.org. 🫶
• --trace — traces specific scope(s). the 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. 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. keep it secret, keep it safe bestie. 🙈
• --insecure, -k — disable SSL credential checks. > ⚠️ yeah this one is literally called insecure, so like… know what you're doing. 🔥
• --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

and that's the whole page bestie!! this one came from the davix source, dated $Date: 2014/05/24 $, and yes it is iconic. go list something. slay. 💖✨