110d195c21c8adde5e2cb85031d6eaeecf6c8c73
[openafs.git] / src / man / fs_listcells.1
1 fs listcells               AFS Commands            fs listcells
2
3
4 NAME
5
6    fs  listcells -- show  database  server machines in cell(s)
7
8                        known to Cache Manager.
9
10
11    fs listcells  [-help]
12
13 ACCEPTABLE ABBREVIATIONS/ALIASES
14
15    fs listc  [-h]
16
17 DESCRIPTION
18
19    Formats and displays  the  Cache  Manager's  kernel-resident
20    list  of  the  database server machines in its home cell and
21    foreign cells.
22
23    At each reboot of the workstation, the Cache Manager  copies
24    the contents of /usr/vice/etc/CellServDB into the kernel. It
25    is possible  to  modify  the  kernel-resident  list  between
26    reboots using fs newcell.
27
28 ARGUMENTS
29
30    -help prints the online help entry for this command.  Do not
31          provide any other arguments or flags  with  this  one.
32          See  section  3.1  in  the  Reference  Manual for more
33          details.
34
35 OUTPUT
36
37    The output contains a line  for  each  cell  for  which  the
38    kernel  has  a  list  of database server machines.  The cell
39    name is followed by a list of its database  server  machines
40    (referred to as "hosts").
41
42    The  format of each machine name (name in uppercase, name in
43    lowercase, or Internet address in four-field  decimal  form)
44    depends  on the state of the local cell's name server at the
45    time the command is issued.
46
47 EXAMPLES
48
49    The  following   shows   output   for   several   cells   as
50    illustrations of the different formats for machine names:
51
52        % fs listc
53        Cell transarc.com on hosts fs1.transarc.com fs2.transarc
54        Cell andrew.cmu.edu on hosts VICE11.FS.ANDREW.CMU.EDU
55           VICE2.FS.ANDREW.CMU.EDU VICE7.FS.ANDREW.CMU.EDU.
56        Cell athena.mit.edu on hosts 18.80.0.2 orf.mit.edu
57
58 PRIVILEGE REQUIRED
59
60    None.
61
62 MORE INFORMATION
63
64    fs newcell