home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / beehive / program / cshell.arc / SH.NOT < prev   
Encoding:
Text File  |  1990-11-03  |  2.0 KB  |  64 lines
  1. Getting the shell running...
  2.  
  3.         (This thing runs only on CP/M 2.2)
  4.  
  5.     First hack your CBIOS to include storage for the
  6.     structure the shell calls iop. The address in the
  7.     bios listing of this structure is the SHBUF define
  8.     in the Shell source. This kluge allows us to save
  9.     data for the shell between warm boots. The structure
  10.     of the buffer in the bios is as follows:
  11.  
  12.         bufsiz:    equ    1030    ;default in bdscio.h
  13.  
  14.         iop:
  15.         shdsk:    db    0
  16.         shsav:    dw    0
  17.         nocli:    db    0
  18.         shbuf:    ds    BUFSIZ
  19.  
  20.     The Bios MUST also be modified to check the entry
  21.     iop->_nocli at warm boots and zero it at cold boots.
  22.     When this flag is low the CCP should be modified at
  23.     the following addresses.
  24.  
  25.         CCP+7 = 02h
  26.         CCP+8 = 'S'
  27.         CCP+9 = 'H'
  28.  
  29.     This modification should occur AFTER the CCP has been
  30.     loaded at warmboot. To make matters more complicated,
  31.     There are two entrypoints (undocumented) to the CCP.
  32.     One, CCP+0, checks the buffer we have just munged and
  33.     if it comtains a filename, runs the .com file of the
  34.     same name.  Entrypoint two, CCP+2, zeros the buffer.
  35.     Hence, If we save a CP/M image with the buffer modified
  36.     and our CBIOS uses the first entrypoint CP/M will
  37.     attempt to run SH.COM at every bootup (I have taken
  38.     advantage of this on my own system, you may wish to do
  39.     the same). Whichever method one uses to chain the shell,
  40.     The bios must check the iop->_nocli flag before
  41.     warmboots and act on the CCP accordingly if the shell-
  42.     builtin, ccp is to work.
  43.  
  44.     If you are not an experienced CP/M hacker you should
  45.     either get help in installing the shell or not attempt
  46.     it at all.  Likewise, if your bios is not accessible at
  47.     source level, forget it.  Be sure to send useful mods
  48.     and repair jobs (There are certainly some bugs) to
  49.     the CUG or to me directly.
  50.  
  51.     Addresses:
  52.             USPS    Steve Blasingame
  53.                 4121 Hidden Hill
  54.                 Norman, OK 73069
  55.  
  56.             Usenet    duke!uok!bsteve
  57.  
  58.  
  59.     As a last resort you can call me at (405) 3602336 
  60.     after hours and BEFORE MIDNIGHT.
  61.  
  62.  
  63.     
  64.