Commit | Line | Data |
---|---|---|
805e021f CE |
1 | =head1 NAME |
2 | ||
3 | fs_listcells - Displays the database server machines known to the Cache Manager | |
4 | ||
5 | =head1 SYNOPSIS | |
6 | ||
7 | =for html | |
8 | <div class="synopsis"> | |
9 | ||
10 | B<fs listcells> [B<-numeric>] [B<-help>] | |
11 | ||
12 | B<fs listc> [B<-n>] [B<-h>] | |
13 | ||
14 | =for html | |
15 | </div> | |
16 | ||
17 | =head1 DESCRIPTION | |
18 | ||
19 | The B<fs listcells> command formats and displays the list of the database | |
20 | server machines that the Cache Manager stores in kernel memory for its | |
21 | home cell and foreign cells. | |
22 | ||
23 | At each reboot of the client machine, the Cache Manager copies the | |
24 | contents of F</usr/vice/etc/CellServDB> into kernel memory. To modify the | |
25 | list between reboots, use the B<fs newcell> command. | |
26 | ||
27 | =head1 OPTIONS | |
28 | ||
29 | =over 4 | |
30 | ||
31 | =item B<-numeric> | |
32 | ||
33 | Displays each database server machine's IP address rather than hostname. | |
34 | ||
35 | =item B<-help> | |
36 | ||
37 | Prints the online help for this command. All other valid options are | |
38 | ignored. | |
39 | ||
40 | =back | |
41 | ||
42 | =head1 OUTPUT | |
43 | ||
44 | The output includes a line for each cell included in the Cache Manager's | |
45 | kernel memory list, in the following format: | |
46 | ||
47 | Cell <cell> on hosts <database server machines> | |
48 | ||
49 | The Cache Manager stores IP addresses, but by default has them translated | |
50 | to hostnames before reporting them, by passing them to the cell's name | |
51 | service (such as the Domain Name Service or a local host table). The name | |
52 | service sometimes returns hostnames in uppercase letters, or an IP address | |
53 | if it cannot resolve a name. | |
54 | ||
55 | Using the B<-numeric> flag bypasses the translation to hostnames, which | |
56 | can result in significantly faster production of output. The output | |
57 | includes IP addresses only. | |
58 | ||
59 | =head1 EXAMPLES | |
60 | ||
61 | The following example shows output for several cells as illustrations of | |
62 | the different formats for machine names: | |
63 | ||
64 | % fs listcells | |
65 | Cell example.com on hosts fs1.example.com fs2.example.com fs3.example.com | |
66 | Cell example.org on hosts DB1.FS.EXAMPLE.ORG | |
67 | DB2.FS.EXAMPLE.ORG DB3.FS.EXAMPLE.ORG | |
68 | Cell example.net on hosts 138.255.0.2 sv3.example.net | |
69 | ||
70 | =head1 PRIVILEGE REQUIRED | |
71 | ||
72 | None | |
73 | ||
74 | =head1 SEE ALSO | |
75 | ||
76 | L<CellServDB(5)>, | |
77 | L<fs_newcell(1)> | |
78 | ||
79 | =head1 COPYRIGHT | |
80 | ||
81 | IBM Corporation 2000. <http://www.ibm.com/> All Rights Reserved. | |
82 | ||
83 | This documentation is covered by the IBM Public License Version 1.0. It was | |
84 | converted from HTML to POD by software written by Chas Williams and Russ | |
85 | Allbery, based on work by Alf Wachsmann and Elizabeth Cassell. |