rom/filesys/SFS/SetCache/SetCache.txt

   1 SetCache is a little tool to set the read-ahead cache of a
   2 Smart Filesystem drive.  This is not the same as the buffers
   3 you can add using the AddBuffers command.
   4
   5 The read-ahead cache is used to prefetch information which
   6 may be needed later on.  Because most harddisks don't suffer
   7 a speed penalty when reading a bit more data this can
   8 increase performance drastically.
   9
  10 It's command line syntax is:
  11
  12  DEVICE/A,LINES/N,READAHEAD/N,NOCOPYBACK/S
  13
  14
  15 DEVICE
  16
  17 The name of the device which you want to set the read-ahead
  18 cache for.  Donot include a colon (":") after the device
  19 name.  This only works for Smart Filesystem drives, and
  20 won't do anything with the FastFilesystem.
  21
  22
  23 LINES
  24
  25 Controls the number of read-ahead buffers.  Each buffer is a
  26 specific bytes in size, which you can control using the
  27 READAHEAD parameter.  It is a good idea to set this to
  28 atleast 8 buffers or more.
  29
  30
  31 READAHEAD
  32
  33 The number of bytes which the filesystem will read ahead.
  34 This controls the size of the buffers you specified with the
  35 LINES parameter.
  36
  37 The READAHEAD parameter will be rounded to a power of 2
  38 automatically (for example, 5000 becomes 4096 (2^12)).
  39
  40
  41 NOCOPYBACK
  42
  43 Turns off copyback mode.  There shouldn't be any reason why
  44 you want to do this, short of testing purposes.  The
  45 copyback mode is implemented in such a way that it can't
  46 leave your disk in an incorrect state (just like the rest of
  47 SFS).
  48
  49
  50 If the SetCache command was succesful it will print the new
  51 buffer size.
  52
  53
  54
  55 Example
  56 --------
  57
  58 SetCache SFS Lines=10 ReadAhead=8192
  59
  60 -> Set the read-ahead cache to 10 buffers of 8192 bytes each.