BOS_GETRESTRICTED(8)

📦
version 1.8.16.1 · 10 versions
, in ubuntu stonking

✨ BOS_GETRESTRICTED(8) ✨

okay bestie, welcome to the AFS Command Reference 💖 this one's a lil baby command but it's lowkey important, so let's get into it.

🎀 NAME 🎀

bos_getrestricted — the girl whose whole job is telling you whether a bos server is restricted or not 👑

🦋 SYNOPSIS 🦋

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

🌸 DESCRIPTION 🌸

So here's the vibe: bos getrestricted shows you whether the server machine you named with the -server argument is running in restricted mode. That's it. That's the whole job. And she does it flawlessly, no cap. 💅

And what even is restricted mode, you ask? It's a mode that limits access to certain bos commands. Wanna know exactly which commands get shut down when you restrict a server? Go read bos_setrestricted(8), it's all laid out there. 📖

Also!! If you wanna restrict or un-restrict a server, that's a different girl — use the bos setrestricted command for that. bos getrestricted is strictly the reporter, not the decider. She just tells you what's up. 🙈

✨ OPTIONS ✨

  • -server <machine name> — tells her which server machine to display the restart times for. You can identify the machine by IP address or by its host name (fully-qualified, or abbreviated as long as it's unambiguous). Wanna know more? Check bos(8). 🖥️
  • -cell <cell name> — names the cell where the command should run. Do not combine this argument with the -localauth flag, bestie, seriously. More deets in bos(8). 🌐
  • -noauth — assigns the unprivileged identity "anonymous" to the issuer, which is giving "no badge, no problem" energy ngl. 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 file. Then the bos command interpreter presents that ticket to the BOS Server during mutual authentication, which is very "we know each other, we're mutuals" of them 🫶. 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. And here's the fun part: all other valid options get ignored when you use this one. She said "I'm helping, that's the whole personality right now." 💀

🌈 OUTPUT 🌈

The output consists of a single line:

Restricted mode is <val>

Where <val> is "on" or "off" ✨

Like, literally one line. Clean, minimal, iconic. She ate and left no crumbs. 🍓

👑 PRIVILEGE REQUIRED 👑

None. Zero. Nada. You need absolutely no privileges for this one, bestie — she's accessible to everyone, main character energy for all. 🎀

💜 SEE ALSO 💜

BosConfig(5), bos(8), bos_setrestricted(8)

Copyright 2009 Simon Wilkinson <simon@sxw.org.uk>

This documentation is covered by the BSD License as written in the doc/LICENSE file. This man page was written by Simon Wilkinson for OpenAFS.

and that's the whole page, bestie!! 💖 this beauty came to you from OpenAFS, dated 2026-07-27, and it slays just as hard as every other page in the BOS_GETRESTRICTED(8) era. go forth and check those restricted modes, periodt. 🦋✨

📦 where this page comes from