BOS_SHUTDOWN(8)

📦
version 1.8.16.1 · 10 versions
, in ubuntu stonking

💖 BOS_SHUTDOWN — the bos_shutdown page, but make it make sense 💖

okay bestie, welcome to bos_shutdown(8), part of the AFS Command Reference. sit down, grab a strawberry 🍓, we're gonna talk about stopping processes without messing with their lil status flag.

✨ NAME ✨

bos_shutdown — stops a process without changing its status flag. that's it. that's the whole vibe. 💅

🌸 SYNOPSIS 🌸

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

bos sh -s <machine name> [-i <instances>+] [-w]
    [-c <cell name>] [-n] [-l] [-h]

🦋 DESCRIPTION 🦋

so. the bos shutdown command stops stuff on the server machine you name with the -server argument. and it stops either:

  • all of the currently running AFS server processes, except the BOS Server. (the BOS Server gets a pass, it's the main character 👑)
  • only the processes you specify with the -instance argument. very picky, we love that for you.
important!! this command does not change a process's status flag in the /etc/openafs/BosConfig file. it only changes it in the BOS Server's memory. 🧠✨

if you wanna stop a process and change its BosConfig status flag, use the bos stop command instead. different tool, different job, no cap.

also once a process is stopped with this command, it does not run again until an administrator starts it back up using bos start, bos startup, or bos restart — or until the BOS Server restarts (and that only works if the process's BosConfig status flag is "Run"). so like, it's giving "lying dormant until summoned." 😭

💅 OPTIONS 💅

  • -server <machine name> — tells the command which server machine to stop processes on. identify the machine by IP address or by its host name (fully-qualified, or abbreviated as long as it's unambiguous). for details, see bos(8).
  • -instance <instances>+ — names each process to stop. use the process name you assigned with the -instance argument to the bos create command. the output from bos status lists the names, so peek there. omit this argument entirely and you stop all processes other than the BOS Server. go big or go specific, your call 🫶
  • -wait — delays the return of the command shell prompt until all processes actually stop. skip this argument and the prompt comes back almost immediately, even if all the processes aren't stopped yet. (so it's like, "bye" vs "bye and I'll text you when I'm actually gone" 💀)
  • -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). (yes it's a whole love triangle of flags, pick ONE 😤)
  • -help — prints the online help for this command. all other valid options are ignored when this one shows up. rude but iconic.

🌈 EXAMPLES 🌈

the following command stops all processes other than the BOS Server on the machine "fs3.example.com".

% bos shutdown fs3.example.com

the following command stops the "upserver" process (that's the server portion of the Update Server) on the machine "fs5.example.com".

% bos shutdown -server fs5.example.com -instance upserver

see? easy. ate. 🔥

👑 PRIVILEGE REQUIRED 👑

the issuer must be listed in the /etc/openafs/server/UserList file on the machine named by the -server argument. or they must be logged onto a server machine as the local superuser "root" if the -localauth flag is included. no shortcuts, bestie, the door has a lock for a reason 🔐

🎀 SEE ALSO 🎀

BosConfig(5), KeyFile(5), KeyFileExt(5), UserList(5), bos(8), bos_create(8), bos_restart(8), bos_start(8), bos_startup(8), bos_status(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, mwah 💋 this was brought to you by OpenAFS, dated 2026-07-27, and filed under the manual page BOS_SHUTDOWN(8). go forth and stop processes responsibly, babe 🦋💜

📦 where this page comes from