BOS_GETRESTART(8)

📦
version 1.8.16.1 · 11 versions
, in ubuntu stonking

💖 BOS_GETRESTART(8) 💖

okay bestie, this is a page from the AFS Command Reference and it's literally the lil command that tells you when your server processes are gonna do their lil scheduled glow-up (a.k.a. restart) ✨

🌸 NAME 🌸

bos_getrestart — she displays the automatic restart times for server processes 💅

🎀 SYNOPSIS 🎀

bos getrestart -server <machine name> [-cell <cell name>]
    [-noauth] [-localauth] [-help]

bos getr -s <machine name> [-c <cell name>] [-n]
    [-l] [-h]

🦋 DESCRIPTION 🦋

so bos getrestart reads the tea straight off of the /etc/openafs/BosConfig file on whatever server machine you named with the -server argument, and it shows you two restart times, no cap:

  • The general restart time — this is when the BOS Server process auto-restarts itself plus every process marked with status "Run" in the BosConfig file. The default? Sunday at 4:00 a.m. 😴
  • The binary restart time — this is when the BOS Server automatically restarts any process whose binary file in the /usr/lib/openafs directory has a time stamp later than that process's last restart time. The default is 5:00 a.m. Want to see a binary file's timestamp? That's the bos getdate command. Want a process's most recent restart time? That's the -long flag on the bos status command. iykyk 🫶

When you're ready to set these restart times instead of just peeking at them, use bos setrestart. periodt 💜

✨ OPTIONS ✨

  • -server <machine name> — tells you which server machine to pull the restart times from. Identify it by IP address or host name (fully-qualified, or abbreviated as long as the abbreviation is unambiguous). For details, see bos(8).
  • -cell <cell name> — names the cell where the command runs. 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 that 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 (she's not listening, bestie 🙈).

🌈 OUTPUT 🌈

the output is two lines, and they're giving very much:

Server <machine_name> restarts at <time>
Server <machine_name> restarts for new binaries at <time>

Possible values for <time> include:

  • "never" — meaning the BOS Server literally never does that type of restart. 💀
  • "now" — meaning the BOS Server only performs that type of restart each time it restarts.
  • A specified day and time — meaning the BOS Server performs that type of restart once per week. Example: "sun 4:00 am".
  • A specified time — meaning the BOS Server performs that type of restart once per day. Examples: "11:00 pm", "3:00 am".

🍓 EXAMPLES 🍓

this first one shows the restart times for the machine "db2.example.com":

% bos getrestart db2.example.com
Server db2.example.com restarts at sun 4:00 am
Server db2.example.com restarts for new binaries at 2:15 am

and in this next one, the issuer abbreviates the machine name "fs1.example.com" down to "fs1", letting the cell's name server resolve the name. The output echoes the abbreviated form — not her fixing it for you, just matching your vibe fr fr:

% bos getrestart fs1
Server fs1 restarts at sat 5:00 am
Server fs1 restarts for new binaries at 11:30 pm

👑 PRIVILEGE REQUIRED 👑

None. zero. you don't need anything, you're already that girl 💅

💜 SEE ALSO 💜

BosConfig(5), KeyFile(5), KeyFileExt(5), bos(8), bos_getdate(8), bos_setrestart(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.

and that's the whole page bestie!! 🌈✨ this gem comes to you from OpenAFS, dated 2026-07-27 — mwah, slay, go read your BosConfig 💖🦋

📦 where this page comes from