doc/man-pages/pod8/bos_listhosts.pod

   1 =head1 NAME
   2
   3 bos_listhosts - Displays the contents of the CellServDB file
   4
   5 =head1 SYNOPSIS
   6
   7 =for html
   8 <div class="synopsis">
   9
  10 B<bos listhosts> S<<< B<-server> <I<machine name>> >>> S<<< [B<-cell> <I<cell name>>] >>>
  11     [B<-noauth>] [B<-localauth>] [B<-help>]
  12
  13 B<bos listh> S<<< B<-s> <I<machine name>> >>> S<<< [B<-c> <I<cell name>>] >>> [B<-n>]
  14     [B<-l>]  [-h]
  15
  16 B<bos getcell> S<<< B<-server> <I<machine name>> >>> S<<< [B<-cell> <I<cell name>>] >>>
  17     [B<-noauth>] [B<-localauth>] [B<-help>]
  18
  19 B<bos getc> S<<< B<-s> <I<machine name>> >>> S<<< [B<-c> <I<cell name>>] >>> [B<-n>]
  20     [B<-l>] [-h]
  21
  22 =for html
  23 </div>
  24
  25 =head1 DESCRIPTION
  26
  27 The B<bos listhosts> command formats and displays the list of a cell's
  28 database server machines from the F</usr/afs/etc/CellServDB> file on the
  29 server machine named by the B<-server> argument.
  30
  31 To alter the list of machines, use the B<bos addhost> and B<bos
  32 removehost> commands.
  33
  34 =head1 OPTIONS
  35
  36 =over 4
  37
  38 =item B<-server> <I<machine name>>
  39
  40 Indicates the server machine from which to display the
  41 F</usr/afs/etc/CellServDB> file. Identify the machine by IP address or its
  42 host name (either fully-qualified or abbreviated unambiguously). For
  43 details, see L<bos(8)>.
  44
  45 For consistent performance in the cell, the output must be the same on
  46 every server machine. The B<bos addhost> reference page explains how to
  47 keep the machines synchronized.
  48
  49 =item B<-cell> <I<cell name>>
  50
  51 Names the cell in which to run the command. Do not combine this argument
  52 with the B<-localauth> flag. For more details, see L<bos(8)>.
  53
  54 =item B<-noauth>
  55
  56 Assigns the unprivileged identity C<anonymous> to the issuer. Do not
  57 combine this flag with the B<-localauth> flag. For more details, see
  58 L<bos(8)>.
  59
  60 =item B<-localauth>
  61
  62 Constructs a server ticket using a key from the local
  63 F</usr/afs/etc/KeyFile> or F</usr/afs/etc/KeyFileExt> file.
  64 The B<bos> command interpreter presents the
  65 ticket to the BOS Server during mutual authentication. Do not combine this
  66 flag with the B<-cell> or B<-noauth> options. For more details, see
  67 L<bos(8)>.
  68
  69 =item B<-help>
  70
  71 Prints the online help for this command. All other valid options are
  72 ignored.
  73
  74 =back
  75
  76 =head1 OUTPUT
  77
  78 The first line of the output names the cell to which the server machine
  79 belongs. Each of the following lines names a database server machine for
  80 that cell.
  81
  82 The C<Host> number assigned to each database server machine is for
  83 server-internal use only and is not the same as, nor necessarily related
  84 to, the machine's IP address. The BOS Server assigned it as part of
  85 performing the B<bos addhost> command.
  86
  87 =head1 EXAMPLES
  88
  89 The following command displays the database server machines listed in the
  90 F</usr/afs/etc/CellServDB> file on the machine C<fs7.example.com>.
  91
  92    % bos listhosts fs7.example.com
  93    Cell name is example.com
  94        Host 1 is db1.example.com
  95        Host 2 is db2.example.com
  96        Host 3 is db3.example.com
  97
  98 =head1 PRIVILEGE REQUIRED
  99
 100 None
 101
 102 =head1 SEE ALSO
 103
 104 L<CellServDB(5)>,
 105 L<KeyFile(5)>,
 106 L<KeyFileExt(5)>,
 107 L<bos(8)>,
 108 L<bos_addhost(8)>,
 109 L<bos_removehost(8)>
 110
 111 =head1 COPYRIGHT
 112
 113 IBM Corporation 2000. <http://www.ibm.com/> All Rights Reserved.
 114
 115 This documentation is covered by the IBM Public License Version 1.0.  It was
 116 converted from HTML to POD by software written by Chas Williams and Russ
 117 Allbery, based on work by Alf Wachsmann and Elizabeth Cassell.