BACKUP_DELVOLENTRY(8)

📦
version 1.8.16.1 · 10 versions
, in ubuntu stonking

💅 BACKUP_DELVOLENTRY — the AFS command reference girlies know her

okay bestie, so this page is literally about backup_delvolentry(8) from the AFS Command Reference, and it's giving "let me remove one single volume entry from a volume set, cleanly, no drama." 🎀

✨ NAME ✨

backup_delvolentry — deletes a volume entry from a volume set 🗑️✨

🌸 SYNOPSIS 🌸

backup delvolentry -name <volume set name>
    -entry <volume set index> [-localauth]
    [-cell <cell name>] [-help]

backup delvole -n <volume set name>
    -e <volume set index>
    [-l] [-c <cell name>] [-h]

not the two-spellings situation 💀 — delvolentry and delvole are the same girl, and all those short flags are just the long flags in a crop top. iykyk.

🦋 DESCRIPTION 🦋

so backup delvolentry deletes the volume entry you point at, from the volume set you named with the -name argument. 💖

you tell it which entry using -entry, and you identify that entry by its index number. need to know what the index numbers even are? run backup listvolsets and she'll show you. 👑

and here's the cute part: if there are any leftover volume entries sitting at index numbers higher than the one you just yeeted, their indexes get automatically decremented, so there's no sad little gap left in the indexing sequence. the lineup stays tight. periodt. ✨

😭 CAUTIONS 😭

deleting volume entries from a temporary volume set? possible only inside the interactive session where that volume set was created. no cap. don't try to do it from outside, she will not answer the phone. 🙈

💅 OPTIONS 💅

  • -name <volume set name> — names the volume set you're deleting a volume entry from. tell her where the crime scene is.
  • -entry <volume set index> — specifies the index number of the volume entry to delete. use backup listvolsets to display the index numbers for a volume set's volume entries, bestie, don't guess. 🫶
  • -localauth — constructs a server ticket using a key from the local /etc/openafs/server/KeyFile file. the backup command interpreter presents it to the Backup Server, Volume Server and VL Server during mutual authentication. do not combine this flag with the -cell argument — pick a lane. for more details, see backup(8).
  • -cell <cell name> — names the cell in which to run the command. do not combine this argument with the -localauth flag. for more details, see backup(8).
  • -help — prints the online help for this command. all other valid options are ignored. she's not multitasking, she's helping. ✨

🌈 EXAMPLES 🌈

this one deletes the fourth volume entry from the volume set called "sys":

% backup delvolentry -name sys -entry 4

fourth entry? gone. not me being emotional about index number 4. 💀

👑 PRIVILEGE REQUIRED 👑

the issuer must be listed in the /etc/openafs/server/UserList file on every machine where the Backup Server is running, OR must be logged onto a server machine as the local superuser "root" if the -localauth flag is included. main character energy only, sorry babe. 🔥

⭐ SEE ALSO ⭐

go read the whole friend group, they're all iconic. 💜

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.

and that's the whole page, bestie 🫶 this OpenAFS drop is dated 2026-07-27, and we're out. slay, stay indexed, no gaps in the sequence. 💖✨🌸

📦 where this page comes from