BOS_STOP(8)

📦
version 1.8.16.1 · 10 versions
, in ubuntu stonking

💖 BOS_STOP(8) — bestie edition 💖

okay so this is bos_stop, from the AFS Command Reference, and it's literally the "stop that process and also write it down" command. sit down, grab a strawberry, we're doing this 🍓

✨ NAME ✨

bos_stop — stops a process after changing its status flag. yeah. that's the whole vibe. 💅

🎀 SYNOPSIS 🎀

bos stop -server <machine name>
    -instance <server process name>+ [-wait]
    [-cell <cell name>] [-noauth] [-localauth] [-help]

bos sto -s <machine name> -i <server process name>+
    [-w] [-c <cell name>] [-n] [-l] [-h]

look at her. two whole forms. the long one and the "i'm in a hurry" one. slay 🫶

🌸 DESCRIPTION 🌸

okay so here's the tea bestie ☕

bos stop does two things, in this order, no cap:

  1. it sets the status flag for each process you named with the -instance argument to "NotRun" — inside the /etc/openafs/BosConfig file, on the server machine you named with -server
  2. then it stops it

that's it. that's the whole plot. the flag gets flipped and the process actually goes down.

🚨 important distinction incoming: if you wanna stop a process without touching its BosConfig status flag, that's a different command — you want bos shutdown instead. do not mix these up, i'm begging 🙈

👑 OPTIONS 👑

  • -server <machine name> — tells the command which machine to go stop processes on. you can identify it by IP address or by host name (fully-qualified works, or abbreviated as long as it's unambiguous, iykyk). more deets live in bos(8).
  • -instance <server process name>+ — names each process to stop. use the process name that got assigned with the -instance argument to the bos create command. and if you forgot the names? the output from bos status literally lists them for you. a queen keeps receipts 💅
  • -wait — makes the command shell prompt wait until all the processes have actually stopped before it comes back to you. skip it and the prompt returns almost immediately even if the processes aren't actually stopped yet. choose your fighter: instant vibes or accuracy ✨
  • -cell <cell name> — names the cell to run the command in. do not combine this argument with the -localauth flag. more details in bos(8).
  • -noauth — assigns the unprivileged identity "anonymous" to whoever issued 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 then presents 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 gets ignored when you do this. it's giving "i asked for help, not your whole personality" 😭

🌈 EXAMPLES 🌈

here's the moment you've all been waiting for. this example stops the upserver and vlserver processes on the machine fs7.example.com:

% bos stop -server fs7.example.com -instance upserver vlserver

ate. no crumbs. 🔥

💜 PRIVILEGE REQUIRED 💜

so who's allowed to do this? bestie, it's one of two cases:

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

that's the whole vibe check. 👑

🦋 SEE ALSO 🦋

BosConfig(5), KeyFile(5), KeyFileExt(5), UserList(5), bos(8), bos_create(8), bos_shutdown(8), bos_status(8)

(the whole friend group 🫶 go read all of them, 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.

okay that's the whole page bestie, tysm for reading, mwah 💖

stay iconic, stop your processes responsibly, and always check your BosConfig first ✨

— with love, OpenAFS, dated 2026-07-27, signing off 🎀💅🌈

📦 where this page comes from