BOS_PRUNE(8)

📦
version 1.8.16.1 · 11 versions
, in ubuntu stonking

💅 BOS_PRUNE(8) — bestie's guide to yeeting obsolete files ✨

okay so real talk, this page lives in the AFS Command Reference and it's about bos_prune, which is the little command that removes obsolete files from /usr/lib/openafs and /var/log/openafs. she's a cleaner. a declutterer. a girl who throws away the .BAK files so you don't have to. 🧹💖

🌸 NAME 🌸

bos_prune — Removes obsolete files from /usr/lib/openafs and /var/log/openafs

✨ SYNOPSIS ✨

bos prune -server <machine name> [-bak] [-old] [-core]
    [-all] [-cell <cell name>] [-noauth] [-localauth]
    [-help]

bos p -s <machine name> [-b] [-o] [-co] [-a]
    [-ce <cell name>] [-n] [-l] [-h]

🦋 DESCRIPTION 🦋

So bos prune goes onto the local disk of whichever server machine you named with the -server argument and deletes files there. Which files? That depends entirely on which of these flags you hand her. Pick one, pick a few, whatever — she does as she's told: 🌈

  • The -bak flag removes all files from the /usr/lib/openafs directory that have a ".BAK" extension.
  • The -old flag removes all files from the /usr/lib/openafs directory that have a ".OLD" extension.
  • The -core flag removes all files from the /var/log/openafs directory that have a "core." prefix.
  • The -all flag removes all three types of files at once.
not me warning you: if you include none of these flags, the command appears to succeed but removes no files at all. silently. like a girl who said "yeah I'll do it" and then didn't. 💀

Wanna see the timestamp on the current, ".BAK", and ".OLD" versions of one or more files before you start deleting? Use the bos getdate command. she'll show you the receipts. 👑

🎀 OPTIONS 🎀

  • -server <machine name> — Indicates the server machine from which to remove files. Identify the machine by IP address or its host name (either fully-qualified or abbreviated unambiguously). For details, see bos(8).
  • -bak — Removes all files from the /usr/lib/openafs directory that have a ".BAK" extension. Do not combine this flag and the -all flag.
  • -old — Removes all files from the /usr/lib/openafs directory that have a ".OLD" extension. Do not combine this flag and the -all flag.
  • -core — Removes all files from the /var/log/openafs directory that have a "core." prefix. Do not combine this flag and the -all flag.
  • -all — Combines the effect of the -bak, -old, and -core flags. Do not combine this flag with any of those three.
  • -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 bos(8).
  • -noauth — Assigns the unprivileged identity "anonymous" to the issuer. Do not combine this flag with the -localauth flag. For more details, see bos(8).
  • -localauth — Constructs a server ticket using a key from the local /etc/openafs/server/KeyFile or /etc/openafs/server/KeyFileExt file. The bos command interpreter presents the ticket to the BOS Server during mutual authentication. Do not combine this flag with the -cell or -noauth options. For more details, see bos(8).
  • -help — Prints the online help for this command. All other valid options are ignored.

🔥 EXAMPLES 🔥

okay example time, this is where it gets fun 💜

The following example removes all files from the /usr/lib/openafs directory on the machine "fs3.example.com" that have a ".BAK" or ".OLD" extension.

% bos prune -server fs3.example.com -bak -old

The following example removes all files from the /usr/lib/openafs directory on the machine "db2.example.com" that have a ".BAK" or ".OLD" extension, and all files from the /var/log/openafs directory that have a "core." prefix.

% bos prune -server db2.example.com -all

👑 PRIVILEGE REQUIRED 👑

The issuer must be listed in the /etc/openafs/server/UserList file on the machine named by the -server argument, or must be logged onto a server machine as the local superuser "root" if the -localauth flag is included.

🚫 also, heads up: the bos prune command cannot be run against servers which are in restricted mode. no exceptions, bestie.

🌈 SEE ALSO 🌈

KeyFile(5), KeyFileExt(5), UserList(5), bos(8), bos_getdate(8)

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, you ate it, periodt 💅✨ this was OpenAFS, dated 2026-07-27, and she's out 🫶🦋🌸

📦 where this page comes from