DAVIX-MKDIR(1)

πŸ’– DAVIX-MKDIR β€” the directory-making bestie (section 1 of the manual, obvs)

okay so bestie, welcome to davix-mkdir, aka the girl from the DAVIX-MKDIR(1) manual who makes folders happen. she's a listing-tool-adjacent icon, she runs on vibes and libdavix, and she's about to make you a directory like it's nothing. ✨


🌸 NAME 🌸

davix-mkdir β€” Directory creation tool based on libdavix. that's it, that's the job, and she does it flawlessly. πŸ’…


πŸŽ€ SYNOPSIS πŸŽ€

davix-mkdir [options]... url

literally just hand her some options and a url and she'll go make that directory for you. no drama. πŸ¦‹


✨ DESCRIPTION ✨

so davix-mkdir is a tool to creat directories or collections with HTTP, Webdav or REST compatible services. yes bestie, "creat" β€” that's how the original spells it and we respect her quirks πŸ’€

she speaks three protocols and she's fluent in all of them:

  • Http β€” http(s)://
  • WebDav β€” dav(s)://
  • S3 β€” s3(s)://

and the whole thing is powered by libdavix. if you wanna know the deep lore, go read libdavix(3) for details. iykyk πŸ“š


πŸ‘‘ OPTIONS πŸ‘‘

πŸ’« Common Options:

  • --debug β€” Debug mode. she tells you everything she's thinking, no filter. πŸ™ˆ
  • --header, -H β€” Add a header field to the request (eg: -H "Depth: 1" ). yes you can stack extra headers on top, she loves accessories. πŸŽ€
  • --help, -h β€” Display this help message. when in doubt, ask the girl herself. 🫢
  • --metalink OPT β€” Metalink support. (OPT=failover[default]|no). so failover is the default unless you say no. ⭐
  • --module, -P PLUGIN_NAME β€” Load a plugin or profile by name. dress her up in a different outfit. πŸ’…
  • --redirection OPT β€” Transparent redirection support. (OPT=yes[default]|no). she follows the redirects unless you tell her not to. 🌈
  • --proxy, -x URL β€” SOCKS5 proxy server URL. (ex: socks5://login:pass@socks.example.org). route her through a friend, no cap. 🧚
  • --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 misc info
    • grid β€” Misc info from 3rd parties
    • socket β€” Socket info
    • locks β€” WebDAV locking info
    • all β€” Traces everything

basically she can narrate any part of her life you wanna hear about. main character energy fr fr. πŸ”₯

  • --version β€” Display version. her birth chart, essentially. 🌸

πŸ” Security Options:

  • --capath CA_path β€” Add an additional certificate authority directory. extra trust, bestie. πŸ’œ
  • --cert, -E cred_path β€” Client Certificate in PEM format. her ID card. πŸŽ€
  • --key priv_path β€” Private key in PEM format. keep this one secret, ngl. 🀫
  • --insecure, -k β€” Disable SSL credential checks. ⚠️ she just stops checking who she's talking to β€” iconic but risky, only do this when you truly don't care.
  • --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 🧚

Creat a directory over WebDav β€” look at her go:

davix-mkdir dav://webdav.example.org/dir/directory_to_create

Creat a directory on a Grid Storage with VOMS authentication β€” she put on the grid profile and ate:

davix-mkdir -P grid davs://grid-storage.example.org/dir1/directory_to_create
notice the verb is "Creat" in both of these, straight from the source. we don't edit her, we celebrate her. πŸ’–

πŸ”— SEE ALSO πŸ”—

libdavix(3), davix-rm(1), davix-put(1),

her whole friend group tbh. go say hi. πŸ¦‹


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

the mothership. the origin story. 🏠✨


πŸ’œ AUTHORS πŸ’œ

Adrien Devresse <adrien.devresse@cern.ch>, IT-SDC-ID, CERN β€” the legend who made all of this happen. πŸ‘‘


and that's the whole page, bestie!! πŸ’… this one's from the davix manual, dated $Date: 2014/05/24 $, and it lives in section DAVIX-MKDIR(1) β€” go forth and make directories, you absolute icon. πŸŽ€πŸ¦‹βœ¨πŸ’–

πŸ“¦ where this page comes from