ZFS-PROJECT(8)

💅 ZFS-PROJECT(8) — manage projects in ZFS filesystem 💅

okay bestie, welcome to zfs-project, straight outta the System Manager's Manual 🫶 this is the lil subcommand that does project ID stuff, and honestly? it's giving bookkeeping queen. no cap.

---

✨ SYNOPSIS ✨

zfs project [-d|-r] file|directory…
zfs project -C [-kr] file|directory…
zfs project -c [-0] [-d|-r] [-p id] file|directory…
zfs project [-p id] [-rs] file|directory…

---

🌸 DESCRIPTION 🌸

🦋 zfs project [-d|-r] file|directory…

okay so first mode: this one just lists the project identifier (ID) and the inherit flag of files and directories. it's the vibe check. it tells you what's there, no changes, very chill.

• -d — show the directory's project ID and inherit flag, not its children. main character only, we don't care about the kids rn 🙈
• -r — list subdirectories recursively. yes bestie, we're going all the way down 💀

---

🎀 zfs project -C [-kr] file|directory…

this one clears the project inherit flag and/or ID on the files and directories. it's the "actually never mind" mode ✨

• -k — keep the project ID unchanged. and listen, if you don't specify this, the project ID gets reset to zero. zero!! so know which one you want 💅
• -r — clear subdirectories' flags recursively. the whole tree, all of it, no survivors 🧚

---

🍓 zfs project -c [-0] [-d|-r] [-p id] file|directory…

the checker mode!! this one checks the project ID and inherit flag on the files and directories, and reports entries that are missing the project inherit flag, or that have project IDs different from the target directory's project ID — or different from whatever you handed it with -p. it's the group chat receipts mode 😭

• -0 — delimit filenames with a NUL byte instead of newline, and don't output diagnoses. NUL, not newline, okay? and no little commentary from it either 🤐
• -d — check the directory's project ID and inherit flag, not its children. again, main character only ✨
• -p id — compare to id instead of the target files and directories' project IDs. you bring the number, it does the comparing 👑
• -r — check subdirectories recursively. all the way down, bestie 🌈

---

💜 zfs project -p id [-rs] file|directory…

and this one sets the project ID and/or inherit flag on the files and directories. the glow-up mode 💖

• -p id — set the project ID to the given value. give it the number, it does the thing ⭐
• -r — set on subdirectories recursively. yes, the entire bloodline 🦋
• -s — set the project inherit flag on the given files and directories. this is usually used for setting up tree quotas with -r. and in that case, the directory's project ID gets set for all its descendants — unless you specified one explicitly with -p. so like, -p overrides, iykyk 💅

---

👀 SEE ALSO 👀

• zfs-projectspace(8)

---

okay that's the whole page, you ate it, no crumbs 🍓💖 this was the OpenZFS version, dated July 11, 2022 — go forth and manage your projects, bestie 👑✨