man5-editing-pass-20051213
[openafs.git] / src / man / fs_checkvolumes.1
1 fs checkvolumes            AFS Commands         fs checkvolumes
2
3
4 NAME
5
6    fs  checkvolumes -- force  Cache  Manager to update volume-
7
8                        related information.
9
10
11    fs checkvolumes  [-help]
12
13 ACCEPTABLE ABBREVIATIONS/ALIASES
14
15    fs checkv  [-h]
16
17 DESCRIPTION
18
19    Forces the Cache Manager to discard its  table  of  mappings
20    between  volume  names  and  volumeID  numbers.    The Cache
21    Manager needs the information in the table to  fetch  files,
22    so  this  command  will  force  it to fetch the most current
23    information available at the File Server  about  a  volume's
24    contents before it can fetch any more files.
25
26    This  command  is  most  useful  if  the issuer knows that a
27    volume's name has changed, or that there has been a  release
28    of  new  ReadOnly  replicas,  because  issuing it forces the
29    Cache Manager to reference the volume with the new name,  or
30    the new ReadOnly replica.
31
32    Normally  the Cache Manager flushes the table and constructs
33    a new one once per hour anyway.
34
35 ARGUMENTS
36
37    -help prints the online help entry for this command.  Do not
38          provide  any  other  arguments or flags with this one.
39          See section 3.1  in  the  Reference  Manual  for  more
40          details.
41
42 PRIVILEGE REQUIRED
43
44    None.