home *** CD-ROM | disk | FTP | other *** search
/ Bila Vrana / BILA_VRANA.iso / 008A / CCACHE11.ZIP / CCDISK.TXT < prev    next >
Text File  |  1996-06-22  |  7KB  |  178 lines
  1. CCDISK.EXE      COPYRIGHT 1995-1996 horio shoichi      CCDISK.EXE
  2.  
  3.  
  4.  
  5. NAME
  6.      ccdisk.exe - DOS reentrant SCSI disk driver
  7.  
  8. SYNOPSIS
  9.      device=ccdisk.exe  [takeover]  [concurrency=max-concurrency]
  10.      [irq_array=array-of-irqs]
  11.  
  12.      ccdisk VECTOR [interrupt-number interrupt-id]
  13.  
  14. COMMAND LINE RULES
  15.      Command line has following rules
  16.  
  17.      -    Operands consist of options and terminating ';'  (semi-
  18.           colon).  Except for ';' , the order is unimportant.
  19.  
  20.      -    The  character ';' (semicolon) terminates command line.
  21.           Operands after the character are ignored.
  22.  
  23.      -    All operands are case sensitive, and generally must  be
  24.           in  lower  case.   In  this  version VECTOR is the only
  25.           upper case operand.  On config.sys line,  operands  are
  26.           converted to lower case and then interpreted.
  27.  
  28.      -    The character '/' can be placed anywhere ' ' (the white
  29.           space) can be placed.
  30.  
  31.      -    Alphabetic part of an option can be abbreviated down to
  32.           one character, if there is no ambiguities.  For example
  33.           the delete option has the syntax [d[e[l[e[t[e]]]]]].
  34.  
  35. DESCRIPTION
  36.      Ccdisk.exe is a device driver loaded  from  config.sys  line
  37.      that  handles  SCSI disks not using BIOS int13 interrupts to
  38.      communicate with.  Instead, ccdisk.exe uses  ASPI  (Advanced
  39.      SCSI Programming Interface) for its communications with SCSI
  40.      disks.
  41.  
  42.      It must be loaded after ASPI and before concache.exe.
  43.  
  44.      If concache.exe is not loaded, ccdisk.exe works exactly like
  45.      any  other  block device driver that handles SCSI disks.  It
  46.      accepts driver requests from DOS serially and performs  each
  47.      of the requests to the completion.
  48.  
  49.      If  concache.exe  is loaded, concache.exe intercepts all DOS
  50.      requests to ccdisk.exe and routes the requests to ccdisk.exe
  51.      described  as  above if necessary.  If the request is gener-
  52.      ated by concache.exe then it directly far  calls  ccdisk.exe
  53.      function entry that performs io asynchronously.
  54.  
  55.  
  56. Concache 1.10       Last Update:  20 June 1996                  1
  57.  
  58.  
  59.  
  60. CCDISK.EXE      COPYRIGHT 1995-1996 horio shoichi      CCDISK.EXE
  61.  
  62.  
  63.  
  64.      Option  concurrency= specifies the maximum number of devices
  65.      to work concurrent.  If this option is  not  specified,  the
  66.      maximum  concurrency is set to the number of detected units.
  67.  
  68.      This concurrency value is retrieved by concache.exe and con-
  69.      cache.exe  tries  to  set  aside stack area (about 400 - 500
  70.      bytes per concurrency)  and  io  buffer  area  (minimum  512
  71.      bytes.  See  concache.txt  for details.)  for each device to
  72.      let them work concurrently.  If conventional memory or upper
  73.      memory  block  is  precious, use rather conservative concur-
  74.      rency= value.
  75.  
  76.      ASPI manager may also limit the concurrency  level  for  its
  77.      own  buffer  management policy. In this case setting concur-
  78.      rency= option larger than the limit is useless.  Check  this
  79.      on accompanying manual for the value.
  80.  
  81.      Option  takeover  tells  ccdisk.exe  to  take over SCSI disk
  82.      operations from DOS io.sys device  driver  which  use  int13
  83.      method,  and  let  concache.exe  perform the disk operations
  84.      concurrently with other devices and user/DOS programs.   The
  85.      devices  remain  nominated  as  io.sys  drives but driven by
  86.      ccdisk.exe through SCSI manager, dictated  by  concache.exe.
  87.      Note SCSI manager must be loaded to use takeover option even
  88.      if the board is configured to use BIOS.  For SCSI disks  not
  89.      under BIOS, presence or absence of the option is irrelevant.
  90.      Also note the option takes  effect  only  with  concache.exe
  91.      loaded.   In  general,  it is hard to find the reason not to
  92.      use this option.
  93.  
  94.      If SCSI disks are configured to use  BIOS  interface,  since
  95.      BIOS  notifies  device  interrupt conditions via (also BIOS)
  96.      int159[01]00 interrupts to tell only  device  types,  it  is
  97.      impossible  to  handle  them  concurrently, nor discriminate
  98.      them from non-SCSI devices.  To configure SCSI disks not  to
  99.      use  BIOS, see respective SCSI board manufacturer's manuals.
  100.  
  101.      However, if only one SCSI disk unit exists and no other type
  102.      disks  are configured, using ccdisk.exe is not very strongly
  103.      advantageous, since in this case  BIOS  int159[01]00  inter-
  104.      rupts definitely designate the unit.
  105.  
  106.      Option  irq_array= specifies irqs used for each host adapter
  107.      in hexadecimal array.  Specifying irqs 0  (timer),  1  (key-
  108.      board),  6  (floppy),  8  (real  time  clock), 9 (redirected
  109.      interrupts), and 0xe  (IDE  type  hard  disk)  are  silently
  110.      ignored.   The array is composed of concatenated hexadecimal
  111.      value of irq numbers.  For example, irq_array=b0c means host
  112.      adapter  0  uses  irq 11, adapter 1 uses none, and adapter 2
  113.      uses irq 12.  If this option is unspecified, then irq  range
  114.  
  115. Concache 1.10       Last Update:  20 June 1996                  2
  116.  
  117.  
  118.  
  119. CCDISK.EXE      COPYRIGHT 1995-1996 horio shoichi      CCDISK.EXE
  120.  
  121.  
  122.  
  123.      8  -  15 is searched and those not pointing into ROM segment
  124.      0xf000 space are considered candidate SCSI irqs.
  125.  
  126.      Note.
  127.           In most cases default SCSI irq detection  should  work.
  128.           However,  not all BIOS use segment 0xf000, the guess is
  129.           easily defeated by the other programs, "stacks=" state-
  130.           ment  in  config.sys  hides  ROM segment addresses, and
  131.           high latency interrupts may not want to be involved  in
  132.           delays concache.exe switchings cause.
  133.  
  134.      For  VECTOR  argument,  see  the corresponding subsection in
  135.      concache.txt.
  136.  
  137. SEE ALSO
  138.      concache.txt, floppies.txt, eqanda.txt, overview.txt,
  139.      respective SCSI board manufacturer's manual.
  140.  
  141.  
  142. FEATURES
  143.      Current implementation has following restrictions
  144.  
  145.      -    Physical block size must  be  512  bytes,  and  logical
  146.           block  size  (given  by  BIOS  parameter block) must be
  147.           either 512, 1024, or 2048 bytes.
  148.  
  149.      -    Only DOS compatible partitions, type 1,  4,  5,  6  are
  150.           recognized.
  151.  
  152.      -    No  removable  media, such as magneto-optical, are han-
  153.           dled.
  154.  
  155.      -    Ioctl are not implemented.
  156.  
  157.      Irqs should have been retrievable via ASPI.
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174. Concache 1.10       Last Update:  20 June 1996                  3
  175.  
  176.  
  177.  
  178.