ZFS-SHARE(8)

📦
version 2.4.4 · 7 versions
, in alpine 3.23, alpine 3.24, nixos 26.05, nixpkgs unstable, ubuntu resolute, ubuntu stonking

💖 zfs-share — the manual, but make it cute 💖

okay bestie, welcome to zfs-share(8), from the System Manager's Manual section. this is the page about sharing and unsharing ZFS filesystems. it's giving network admin but make it glam. ✨

🌸 NAME 🌸

zfs-share — share and unshare ZFS filesystems

like. literally what it says on the tin. sharing. unsharing. ZFS. iconic behavior. 👑

🎀 SYNOPSIS 🎀

zfs share [-l] -a|filesystem
zfs unshare -a|filesystem|mountpoint

that's the whole vibe check right there. two commands, a couple of flags, no drama. 🦋

✨ DESCRIPTION ✨

zfs share [-l] -a|filesystem

okay so this one shares available ZFS file systems. like, it takes your filesystems and makes them available to other people. social butterfly energy fr fr. 🦋

  • -l — loads keys for encrypted filesystems as they're being mounted. this is equivalent to executing zfs load-key on each encryption root before mounting it. 🫶
heads up though: if a filesystem has keylocation=prompt, this will cause the terminal to interactively block after asking for the key. so like. it's gonna sit there and wait for you. don't panic, just type your key. 💀
  • -a — share all available ZFS file systems. this gets invoked automatically as part of the boot process, so it's lowkey the main character of system startup. 🌅
  • filesystem — share the specified filesystem according to the sharenfs and sharesmb properties. file systems are shared when the sharenfs or sharesmb property is set. no property, no share. that's the rule bestie. 📋

zfs unshare -a|filesystem|mountpoint

and this one unshares currently shared ZFS file systems. the goodbye arc. the closure era. 😭

  • -a — unshare all available ZFS file systems. this gets invoked automatically as part of the shutdown process. so every time you turn your machine off, this is quietly doing its thing backstage. main character but off-screen. 🎬
  • filesystem|mountpoint — unshare the specified filesystem. the command can also be given a path to a ZFS file system shared on the system. so like, a filesystem name OR a mountpoint path, both slay. 💅

🌈 SEE ALSO 🌈

go read those if you wanna go deeper. iykyk. 📚

and that's the whole page bestie!! this one shipped as part of OpenZFS, dated July 11, 2022. go forth and share responsibly 💜✨🎀

📦 where this page comes from