BOS_UNINSTALL(8)

📦
version 1.8.16.1 · 11 versions
, in ubuntu stonking

💖 BOS_UNINSTALL 💖

okay bestie, welcome to bos_uninstall — the AFS Command Reference page that lets you hit undo on a process's binary. yes, actual undo. not me being dramatic. 🩷

✨ NAME ✨

bos_uninstall — reverts to the former version of a process's binary file 🎀

🌸 SYNOPSIS 🌸

bos uninstall -server <machine name>
    -file <files to uninstall>+ [-dir <destination dir>]
    [-cell <cell name>] [-noauth] [-localauth] [-help]
bos u -s <machine name> -f <files to uninstall>+
    [-d <destination dir>] [-c <cell name>] [-n] [-l]
    [-h]

🦋 DESCRIPTION 🦋

so here's the vibe: bos uninstall takes every binary file you name with the -file argument and swaps it out for its .BAK version, on the server machine you named with -server — which is normally the binary distribution machine for its CPU/operating system type. it also renames the extension on the current .OLD version (if there even is one) to .BAK. slay.

each binary file has to live in the local /usr/lib/openafs directory, unless -dir names some other directory. lowkey important.

wanna start using the reverted binary immediately? go run bos restart. otherwise the BOS Server will just automatically restart the process at whatever time is set in the /etc/openafs/BosConfig file. want to see that time? bos getrestart. want to change it? bos setrestart. iykyk. ⏰

💅 OPTIONS 💅

  • -server <machine name> — tells you which binary distribution machine to go revert to the .BAK version of the binaries on. you identify the machine by IP address or by its host name (fully-qualified, or abbreviated as long as it's unambiguous). more deets in bos(8). 🖥️
heads up bestie: if that machine is not a binary distribution machine and it's running an upclientbin process, then your files get overwritten the very next time upclientbin fetches the corresponding file from the distribution machine — by default that's within five minutes. so like, don't be surprised. 😭
  • -file <files to uninstall>+ — names every binary file you want replaced with its .BAK version. 📁
  • -dir <destinatino dir> — gives the complete pathname of the local disk directory that holds each file named by -file. you only need this if the binaries aren't chilling in /usr/lib/openafs. 📂
  • -cell <cell name> — names the cell where you're running the command. do NOT combine this argument with the -localauth flag. more details in bos(8). 🌐
  • -noauth — assigns the unprivileged identity anonymous to whoever's issuing the command. do NOT combine this flag with -localauth. more details in 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 hands that ticket to the BOS Server during mutual authentication. do NOT combine this flag with the -cell or -noauth options. more details in bos(8). 🔑
  • -help — prints the online help for this command. every other valid option just gets ignored. cute and simple. ✨

🌈 EXAMPLES 🌈

this example command overwrites the /usr/lib/openafs/kaserver file on the machine fs4.example.com with its .BAK version, and the current .BAK version with the .OLD version. reciprocal behavior, we love to see it. 💖

% bos uninstall -server fs4.example.com -file kaserver

👑 PRIVILEGE REQUIRED 👑

whoever issues this must be listed in the /etc/openafs/server/UserList file on the machine named by the -server argument — or they have to be logged onto a server machine as the local superuser root if the -localauth flag is included. no shortcuts, bestie. 🫶

also: bos uninstall cannot be run against servers running in restricted mode. periodt. 🚫

⭐ SEE ALSO ⭐

BosConfig(5), KeyFile(5), KeyFileExt(5), UserList(5), bos(8), bos_getrestart(8), bos_restart(8), bos_setrestart(8), upclient(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.

and that's the whole page, babe 💜 this one's from the OpenAFS crew, dated 2026-07-27 — go revert some binaries responsibly, mwah 🧚✨

📦 where this page comes from