BOS_LISTHOSTS(8)

📦
version 1.8.16.1 · 10 versions
, in ubuntu stonking

💖 BOS_LISTHOSTS(8) 💖

okay bestie, welcome to the AFS Command Reference ✨ this one's from the OpenAFS girlies and it's literally just "who are my database servers" but make it iconic. no cap.

✨ NAME ✨

bos_listhosts — Displays the contents of the CellServDB file

like. it shows you the CellServDB file. that's the whole vibe. 🎀

🌸 SYNOPSIS 🌸

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

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

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

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

so there's four whole ways to summon this command and they all do the same thing, it's giving multiple aliases, one destiny 💅 and yes getcell / getc are in there too, they're the same command with a different name, iykyk.

🦋 DESCRIPTION 🦋

The bos listhosts command formats and displays the list of a cell's database server machines, straight out of the /etc/openafs/server/CellServDB file on the server machine that you name with the -server argument. bestie it literally reads the file and pretties it up for you. 💖

And if you wanna change which machines are on that list? that's not this command, girlie. that's bos addhost and bos removehost. periodt. 🔥

👑 OPTIONS 👑

  • -server <machine name> — the server machine you want to display the /etc/openafs/server/CellServDB file from. you can identify it by IP address or by its host name (fully-qualified, or abbreviated as long as it's unambiguous — the machine has to know who you mean). for the deets, see bos(8).
⚠️ and listen: for consistent performance in the cell, the output has to be the same on every server machine. the bos addhost reference page explains how to keep the machines synchronized. don't be the one server that's off-script. 😭
  • -cell <cell name> — names the cell where you wanna run the command. 🫶 do NOT combine this argument with the -localauth flag, okay? they don't get along. more details in bos(8).
  • -noauth — assigns the unprivileged identity "anonymous" to the issuer. so like, no name, no reputation, just vibes, anonymous. 🙈 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 — they are not a friend group. more details in bos(8).
  • -help — prints the online help for this command. and literally every other valid option gets ignored when you use it, so don't bother typing the whole thing. 💅

🌈 OUTPUT 🌈

The first line of the output names the cell that the server machine belongs to. each line after that names a database server machine for that cell. cute, tidy, slay. ✨

about that "Host" number assigned to each database server machine — okay so that number is for server-internal use only, and it is not the same as the machine's IP address, nor is it necessarily even related to it. 🙅‍♀️ the BOS Server assigned that number while it was doing the bos addhost command. so don't @ it, it's not an IP. 💀

⭐ EXAMPLES ⭐

The following command displays the database server machines listed in the /etc/openafs/server/CellServDB file on the machine "fs7.example.com".

% bos listhosts fs7.example.com
Cell name is example.com
    Host 1 is db1.example.com
    Host 2 is db2.example.com
    Host 3 is db3.example.com

look at her go. three db hosts, all lined up, all perfect. 🎀

🍓 PRIVILEGE REQUIRED 🍓

None

(yeah. none. you don't need anything. go wild. 🫶)

🧚 SEE ALSO 🧚

CellServDB(5), KeyFile(5), KeyFileExt(5), bos(8), bos_addhost(8), bos_removehost(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 — brought to you by OpenAFS, dated 2026-07-27, filed under BOS_LISTHOSTS(8). mwah. 💋 stay synced, stay iconic. 👑✨

📦 where this page comes from