cadaver(1)

📦
version 0.28 · 6 versions
, in alpine 3.24, arch rolling, epel 10, fedora 43, fedora 44, nixos 26.05, nixpkgs unstable

💅 cadaver(1) — command-line WebDAV client, bestie edition ✨

🎀 NAME 🎀

cadaver — A command-line WebDAV client for Unix. literally the group chat’s favorite way to talk WebDAV from a terminal. 💻

✨ SYNOPSIS ✨

cadaver [-trp[-r file][-p host[:port]]][-V][-h] URL

🌸 DESCRIPTION 🌸

okay so cadaver supports file upload, download, on-screen display, namespace operations (move and copy), collection creation and deletion, and locking operations. yes bestie, all of that 💅

Its operation is similar to the standard BSD ftp(1) client and the Samba Project’s smbclient(1). If you’re familiar with those tools, you should be quite comfortable here — same energy, WebDAV edition. 🫶

cadaver supports automatically logging in to servers requiring authentication via a .netrc file (similar to ftp(1) — see section "THE .netrc FILE" below). auto-login slay ✨

👑 OPTIONS 👑

The URL passed must be an absolute URI using the http: or https URL scheme. No relative vibes allowed. 🚫

  • -t, --tolerant — Allow cd/open into non-WebDAV enabled collection; use if the server or proxy server has WebDAV compliance problems. be tolerant, bestie 🙈
  • -r, --rcfile=file — Use this rcfile rather than the default of ~/.cadaverrc. customize ur setup 🎀
  • -p, --proxy=host[:port] — Connect using the proxy host "host" and optional proxy port "port". proxy era 🌈
  • -V, --version — Display version information and exit. quick peep 👀
  • -h, --help — Display this help message and exit. help has entered the chat 🫶

🛠️ COMMAND REFERENCE 🛠️

  • ls [path] — List contents of current [or other] collection. window shopping ur files 🛍️
  • cd path — Change to specified collection. moving thru the folder-verse 🦋
  • pwd — Display name of current collection. where r we?? 📍
  • put local [remote] — Upload local file. send it up ⬆️
  • get remote [local] — Download remote resource. bring it down ⬇️
  • mget remote... — Download many remote resources. download haul 🛒
  • mput local... — Upload many local files. upload haul 📦
  • edit resource — Edit given resource. write ur little heart out ✍️
  • less remote... — Display remote resource through pager. pager moment 📖
  • mkcol remote... — Create remote collection(s). make the folder, bestie 📁
  • cat remote... — Display remote resource(s). cat but make it remote 🐈
  • delete remote... — Delete non-collection resource(s). bye non-folder things 💀
  • rmcol remote... — Delete remote collections and ALL contents. ALL contents, no cap — this is the spicy one 🌶️
  • copy source... dest — Copy resource(s) from source to dest. copy-paste energy 📋
  • move source... dest — Move resource(s) from source to dest. relocation station 🚚
  • lock resource — Lock given resource. claimed, do not touch 🔒
  • unlock resource — Unlock given resource. release the lock 🔓
  • discover resource — Display lock information for resource. lock lore 🔍
  • steal resource — Steal lock token for resource. steal the token, iconic behavior 😈
  • showlocks — Display list of owned locks. lock inventory 🧾
  • propnames res — Names of properties defined on resource. property names, collected 🏷️
  • chexec [+|-] remote — Change isexecutable property of resource. executable era ⚙️
  • propget res [propname] — Retrieve properties of resource. get those props 🎁
  • propset res propname value — Set property on resource. set the prop, set the vibe 💅
  • set [option] [value] — Set an option, or display options. tune ur settings 🎛️
  • open URL — Open connection to given URL. open the connection portal 🌐
  • close — Close current connection. hang up 📴
  • quit — Exit program. peace out 👋
  • unset [option] [value] — Unsets or clears value from option. clear the setting 🧽
  • lcd [directory] — Change local working directory. local folder hop 🐇
  • lls [options] — Display local directory listing. local listing, local vibes 📂
  • lpwd — Print local working directory. local location check 📍
  • logout — Logout of authentication session. log out, log off, bye auth 🚪
  • help [command] — Display help message. help has entered the chat, again 🫶

🍓 THE .netrc FILE 🍓

The file ~/.netrc may be used to automatically login to a server requiring authentication. The following tokens (separated by spaces, tabs or newlines) may be used:

  • machine host — Identify a remote machine host which is compared with the hostname given on the command line or as an argument to the open command. Any subsequent tokens up to the end of file or the next machine or default token are associated with this entry. machine match moment 🏠
  • default — This is equivalent to the machine token but matches any hostname. Only one default token may be used and it must be after all machine tokens. default is the catch-all, but only one, and it goes last ⚠️
  • login username — Specifies the username to use when logging in to the remote machine. ur login 👤
  • password string, passwd string — Specifies the password to use when logging in to the remote machine. password/passwd, both slay 🔑
  • Any other tokens (as described in ftp(1)) are ignored. not invited to the party 🙅

🌈 EXAMPLES 🌈

📁 FILES 📁

  • ~/.cadaverrc — Individual user settings that can override cadaver defaults and to script cadaver. Can be changed by the "--rcfile" option. ur personal config, ur rules 🎀
  • ~/.netrc — Login and initialization information used by the auto-login process. See section "THE .netrc FILE" for details. auto-login details live above 🔑

👑 AUTHOR 👑

Joe Orton <https://github.com/notroj/cadaver> — author icon ✨

💜 SEE ALSO 💜

ftp(1), smbclient(1) — the cousins 🫶

💖 From the Unix User Manuals, October 2022, cadaver(1) — that’s the tea, bestie. Go forth and WebDAV! 🫶✨

📦 where this page comes from