BOS_EXEC(8)

📦
version 1.8.16.1 · 10 versions
, in ubuntu stonking

💅 BOS_EXEC(8) — bestie edition ✨

okay so this is a page from the AFS Command Reference, and it's the manual for bos_exec — literally the "go run a command on a remote server" girlie. 🫶

✨ NAME ✨

bos_exec — Executes a command on a remote server machine 🖥️💫

🎀 SYNOPSIS 🎀

bos exec -server <machine name> -cmd <command to execute>
    [-cell <cell name>] [-noauth] [-localauth] [-help]

bos e -s <machine name> -cm <command to execute>
    [-ce <cell name>] [-n] [-l] [-h]

🌸 DESCRIPTION 🌸

so the bos exec command runs the command u point at, on the file server machine named by the -server argument. that's it, that's the whole vibe. 🦋

its intended use is to reboot the machine — using the /sbin/reboot command or an equivalent. main character behaviour only 🔥

💖 OPTIONS 💖

  • -server <machine name> — tells u which server machine the command should be executed on 🤖. identify the machine by IP address or by its host name (fully-qualified, or abbreviated as long as it's unambiguous). for the deets, peep bos(8).
  • -cmd <command to execute> — the complete local disk pathname of the command u wanna run (for example, /sbin/reboot) 📁✨. if the command has one or more spaces in it, wrap this argument in double quotes ("").
  • -cell <cell name> — names the cell where the command runs 🏠. do NOT combine this argument with the -localauth flag, bestie, i'm serious. more info in bos(8).
  • -noauth — hands the issuer the unprivileged identity "anonymous" 🙈. do NOT combine this flag with the -localauth flag. more info in bos(8).
  • -localauth — constructs a server ticket using a key from the local /etc/openafs/server/KeyFile file 🔑. the bos command interpreter presents that ticket to the BOS Server during mutual authentication. do NOT combine this flag with the -cell or -noauth options. more info in bos(8).
  • -help — prints the online help for this command 🆘. all other valid options are ignored. periodt.

🌈 EXAMPLES 🌈

the following command reboots the machine "fs2.example.com" 🔄. the issuer has previously issued the bos shutdown command to shut down all processes cleanly (iconic pre-game ritual tbh):

% bos exec -server fs2.example.com -cmd /sbin/shutdown -r now

👑 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. no random girlies allowed, sorry 💅

⚠️ also!! the bos exec command is not available on servers running in restricted mode. don't say i didn't warn u 😭

🦋 SEE ALSO 🦋

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. (shoutout to the conversion girlies fr fr 🫶)

and that's the whole thing bestie!! this page came from the OpenAFS crew, dated 2026-07-27, and it lives in section 8 of the manual (the sysadmin one, very cunty of it). go reboot something responsibly 💖✨🎀

📦 where this page comes from