logo
Free, unlimited AI code reviews that run on commit
git-lrc git-lrc GitHub Install Now We'd appreciate a star git-lrc - Free, unlimited AI code reviews that run on commit | Product Hunt git-lrc - Free, unlimited AI code reviews that run on commit | Product Hunt

bos_listhosts - Displays the contents of the CellServDB file

Description

       The boslisthosts command formats and displays the list of a cell's database server machines from the
       /etc/openafs/server/CellServDB file on the server machine named by the -server argument.

       To alter the list of machines, use the bosaddhost and bosremovehost commands.

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

Name

       bos_listhosts - Displays the contents of the CellServDB file

Options

-server <machinename>
           Indicates  the server machine from which to display the /etc/openafs/server/CellServDB file. Identify
           the machine by IP address or its host name (either fully-qualified or abbreviated unambiguously). For
           details, see bos(8).

           For consistent performance in the cell, the output must be the same on every server machine. The  bosaddhost reference page explains how to keep the machines synchronized.

       -cell <cellname>
           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).

       -help
           Prints the online help for this command. All other valid options are ignored.

Output

       The first line of the output names the cell to which the server machine belongs. Each  of  the  following
       lines names a database server machine for that cell.

       The "Host" number assigned to each database server machine is for server-internal use only and is not the
       same  as,  nor  necessarily  related  to, the machine's IP address. The BOS Server assigned it as part of
       performing the bosaddhost command.

Privilege Required

       None

See Also

CellServDB(5), KeyFile(5), KeyFileExt(5), bos(8), bos_addhost(8), bos_removehost(8)

Synopsis

boslisthosts-server <machinename> [-cell <cellname>]
           [-noauth] [-localauth] [-help]

       boslisth-s <machinename> [-c <cellname>] [-n]
           [-l]  [-h]

       bosgetcell-server <machinename> [-cell <cellname>]
           [-noauth] [-localauth] [-help]

       bosgetc-s <machinename> [-c <cellname>] [-n]
           [-l] [-h]

See Also