KAPLA-VOLUME-CREATE(1)

💅 kapla-volume-create — aka kapla volume create ✨

okay bestie so this is the kapla-volume-create page from the Kapla manual, and it's literally just about creating a brand-new volume. that's it. that's the whole vibe. 🎀

---

🌸 NAME 🌸

kapla-volume-create — create new volume. yes queen, birth a volume. 👑

---

✨ SYNOPSIS ✨

kapla volume create [--control=CONTROL_SOCKET]
[--maximum-size=MAXIMUM_SIZE] [OPTION]…

like, kapla volume create, and then sprinkle your flags on top. icon behavior honestly. 💅

---

🔥 OPTIONS 🔥

• -c CONTROL_SOCKET, --control=CONTROL_SOCKET — the Kapla control socket. default lookup order when it's absent: $XDG_STATE_HOME/kapla/kapla.sock, then $HOME/.local/state/kapla/kapla.sock, then /var/lib/kapla/kapla.sock. it just checks them in that order, no cap. 🦋
• -m MAXIMUM_SIZE, --maximum-size=MAXIMUM_SIZE — maximum size of volume in bytes. absent means it defaults to 2147483648. yes that's a real number and yes it's a lot. 🍓

---

🌈 COMMON OPTIONS 🌈

• --color=WHEN (absent=auto) — colorize the output. WHEN has to be one of auto, always or never. pick your aesthetic, bestie. 🎨
• --help[=FMT] (default=auto) — show this help in format FMT. FMT must be one of auto, pager, groff or plain. and with auto, the format is pager or plain whenever the TERM env var is dumb or undefined. iykyk. 📖
• -q, --quiet — be quiet. it literally takes over -v and --verbosity, like main character energy but silent. 🤫
• -v, --verbose — increase verbosity. repeatable, but more than twice does not bring more. know your limits babe. 💀
• --verbosity=LEVEL (absent=warning or KAPLA_LOG_LEVEL env) — be more or less verbose. LEVEL must be one of quiet, error, warning, info or debug. takes over -v. 👑
• --version — show version information. slay. ⭐

---

💀 EXIT STATUS 💀

kapla volume create dips out with:

1. 0 — on success. we ate. 🍽️
2. 123 — on indiscriminate errors reported on standard error. 😭
3. 124 — on command line parsing errors. you typed it wrong bestie, respectfully. 🙈
4. 125 — on unexpected internal errors (bugs). not our fault, fr fr. 🫶

---

🧚 ENVIRONMENT 🧚

these environment variables affect the execution of kapla volume create:

• KAPLA_LOG_LEVEL — set the log level. that's the whole note. 💜

---

🦋 SEE ALSO 🦋

kapla(1) — go read the big one, it's giving lore. 📚

---

lowkey reminder: the defaults are defaults. 2147483648 bytes is not a suggestion, it's a limit. be normal about it. 💅

---

Kapla 0.4.0 🌸 — written on the KAPLA-VOLUME-CREATE(1) page date, mwah, ily, go create some volumes bestie 💖✨🎀