FS_SETVOL(1)

📦
version 1.8.16.1 · 10 versions
, in ubuntu stonking

💖 FS_SETVOL(1) 💖

okay bestie, welcome to fs_setvol from the AFS Command Reference — yes, this is the manual page you've been looking for, and yes, it's giving quota-and-message-settings realness. sit down, hydrate, and let's get into it 🫶

✨ NAME ✨

fs_setvol — set quota and messages for a volume containing a file or directory. that's the whole vibe. 💅

🌸 SYNOPSIS 🌸

fs setvol [-path <dir/file path>+]
    [-max <disk space quota in 1K units>]
    [-offlinemsg <offline message>] [-help]

fs setv [-p <dir/file path>+]
    [-ma <disk space quota in 1K units>]
    [-o <offline message>] [-h]

fs sv [-p <dir/file path>+]
    [-ma <disk space quota in 1K units>]
    [-o <offline message>] [-h]

like, three whole spellings of the same command, because AFS said "abbreviations are self-care" 😌

💫 DESCRIPTION 💫

so the fs setvol command sets the quota (aka the maximum possible size, the ceiling, the no-you-may-not-grow-beyond-this) of the read/write volume that contains each directory or file you name with the -path argument. 🎀

and then! if you want to attach a message to the volume — one that later shows up in the output of the fs examine command — you include the -offlinemsg argument. cute, right? a lil note for the girlies.

want to see all the settings you made with this command? that's fs examine's whole job. also, fs listquota reports a fileset's quota, and fs quota reports the percent of quota used. they're a little trio, they're iconic, they ate. 👑

and if you only need to set quota on one volume at a time, go hit up fs setquota instead.

⚠️ CAUTIONS ⚠️

stay with me, this part matters, bestie. 💀

currently, the maximum quota for a volume is 2 terabytes (2^41 bytes). and here's the twist: that ceiling only applies to the volume's quota. a volume can grow way bigger than that if the volume quota is disabled. BUT — and this is the part that gets messy — volumes over 2 terabytes in size may be impractical to move, and may have their size incorrectly reported by some tools, such as fs_listquota(1). 🙈 so like… be aware. no cap.

🦋 OPTIONS 🦋

  • -path <dir/file path>+ — names each file or directory you want to set the host volume's quota and offline message on. partial pathnames get interpreted relative to the current working directory, and — fun fact — that same current working directory is also the default value if you just… omit this argument entirely. lazy girl friendly. ✨

pro tip from your bestie: specify the read/write path to the file or directory, so you don't hit the failure that happens when you try to change a read-only volume. 🚫 by convention, the read/write path is marked by placing a period before the cell name at the pathname's second level (for example, /afs/.example.com). and for the whole read/write vs read-only path situation, the concept is discussed further in the fs mkmount reference page. iykyk.

  • -max <disk space quota in 1K units> — sets the maximum amount of file server disk space the volume can occupy. hand it a positive integer to say how many one-kilobyte blocks (so 1024 is one megabyte). and a value of 0 sets an unlimited quota — though even then, the size of the disk partition that houses the volume is the absolute limit on the volume's size. the disk said "i'm the final boss." 💀

also: if you omit the -path argument (which means the command sets the quota of the volume housing the current working directory), then the -max switch is mandatory. must be provided. no skipping. periodt.

  • -offlinemsg — associates a message with the volume, and that message then shows up in the output of the fs examine command. its intended use is to explain why the volume is currently offline. it's like a lil sticky note saying "brb, offline 🥲".
  • -help — prints the online help for this command. every other valid option gets ignored, so don't bother, she's not listening. 🎧

🌈 EXAMPLES 🌈

here's a command that imposes a 6500 kilobyte quota on the volumes mounted at the home directories /afs/example.com/usr/smith and /afs/example.com/usr/pat:

% cd /afs/example.com/usr
% fs setvol -path smith pat -max 6500B<>

slay. two volumes, one command. 💖

👑 PRIVILEGE REQUIRED 👑

the issuer must belong to the system:administrators group. so like, you gotta be in the group chat for real. no lurkers. 🫶

🔥 SEE ALSO 🔥

fs_examine(1), fs_listquota(1), fs_mkmount(1), fs_quota(1), fs_setquota(1)

IBM Corporation 2000. <http://www.ibm.com/> All Rights Reserved.

This documentation is covered by the IBM Public License Version 1.0. It was converted from HTML to POD by software written by Chas Williams and Russ Allbery, based on work by Alf Wachsmann and Elizabeth Cassell.

okay that's the whole page!! this is from OpenAFS, dated 2026-07-27 — so when you come back in your feels about quotas and offline messages, you'll know exactly where you were, bestie. mwah. 💅✨🌸💖

📦 where this page comes from