home *** CD-ROM | disk | FTP | other *** search
/ Frozen Fish 1: Amiga / FrozenFish-Apr94.iso / bbs / alib / d3xx / d381 / sksh.lha / SKsh / Install.doc < prev    next >
Text File  |  1990-10-20  |  7KB  |  265 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.                                 Installation Guide to
  17.  
  18.                                         SKsh
  19.  
  20.                            A ksh-like Shell for the Amiga
  21.  
  22.                                      Version 1.6
  23.  
  24.  
  25.                                (Copyright) 1989, 1990
  26.  
  27.                                      Steve Koren
  28.  
  29.                                    October 4, 1990
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.           Installing SKsh
  74.  
  75.             This  section  descibes how to install SKsh.  It is vitally im-
  76.             portant that all the steps be  performed.   If  they  are  not,
  77.             SKsh  will  not  operate correctly.  In addition, SKsh requires
  78.             version 1.3 of AmigaDos to operate correctly.
  79.  
  80.             Please  examine this file for each release, as it may change at
  81.             any time.
  82.  
  83.  
  84.                1)   First, copy the .skshinit  and  .skshrc  files  to  the
  85.                     's:' directory.  SKsh needs these two  files  to  start
  86.                     correctly.   Their  location can be changed by changing
  87.                     the  SKSH:  device (see below).  Note that ONLY .skshrc
  88.                     IS FOR USER MODIFICATION.  The  .skshinit  file  should
  89.                     be  used  as  supplied and re-installed with  each  new
  90.                     release.
  91.  
  92.  
  93.                2)   Edit your startup-sequence and insert:
  94.  
  95.                          assign SKSH: s:
  96.  
  97.                     This  controls the location in which SKsh looks for the
  98.                     startup files.
  99.  
  100.  
  101.                3)   Copy  the  sksh  binary  itself to  a  location in your
  102.                     AmigaDos search path.  You can be fairly sure the  'c:'
  103.                     directory is in your search path.  If  you  have  modi-
  104.                     fied your path, there may be other  potential locations
  105.                     as well.
  106.  
  107.  
  108.                4)   Set the pure bit on the SKsh binary:
  109.  
  110.                          protect c:sksh rep
  111.  
  112.  
  113.                5)   Make sure that 't:' points to  a  fast  device suitable
  114.                     for  storing temporary files.  A sub-directory on a ram
  115.                     disk is best.  For example,
  116.  
  117.                          makedir ram:tmp
  118.                          assign t: ram:tmp
  119.  
  120.                     You  will  probably want  to  insert some commands like
  121.                     these into your startup-sequence, if they are  not  al-
  122.                     ready there.  SKsh  uses  temporary files only when ab-
  123.                     solutely  necessary, but some types  of  SKsh  commands
  124.                     will  not  function  properly without them (see command
  125.                     subtitution, for example).
  126.  
  127.  
  128.  
  129.           SKsh Amiga Shell             Page 2           Installation Guide
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.  
  140.                6)   SKsh needs a stack size of at least 6000 bytes  in  or-
  141.                     der to run properly.   You  can  manually set the stack
  142.                     size  to  6000  bytes  using the AmigaDos stack command
  143.                     before you run SKsh,  or  you  can  insert 'stack 6000'
  144.                     into  your  startup  sequence (recommended).  If you do
  145.                     not have sufficient stack space, SKsh *will* crash.
  146.  
  147.  
  148.                7)   The  following files need  to  be  copied to a location
  149.                     which is in your SKsh search path  (although not neces-
  150.                     sarily in your AmigaDos search path):
  151.  
  152.                          cat       cmp       cp        crc       cut
  153.                          du        encr      fgrep     find      grep
  154.                          head      indent    join      num       srun
  155.                          strings   tail      tee       view      wc
  156.                          window    xd
  157.  
  158.                     You can  create a directory called "sys:bin" which con-
  159.                     tains these commands.  The  supplied .skshrc file auto-
  160.                     matically adds this directory to the search path. 
  161.  
  162.  
  163.                8)   This  step  is  optional, but recommended.  The default
  164.                     name for the ram disk is "RAM DISK:".  The  space  will
  165.                     make some  things  difficult to do (but not impossible)
  166.                     in SKsh.  I  recommend that you change the default name
  167.                     of the ram disk in your startup-sequence  to  something
  168.                     like the following:
  169.  
  170.                          relabel ram: RAM_DISK
  171.  
  172.                     The  only  difference is that the space  has  been  re-
  173.                     placed  by  an  underscore, and it will make your  life
  174.                     much easier.
  175.  
  176.  
  177.                9)   Insure  that  your  AmigaDos  ENV:  device  is  set  up
  178.                     properly.  If you are not sure how to do this, see  the
  179.                     AmigaDos manual.
  180.  
  181.  
  182.                10)  You must have  arp.library  installed in your system in
  183.                     the LIBS: directory.  If you are not  sure  how  to  do
  184.                     this, see the arp documentation.  arp  is  available on
  185.                     most Amiga BBS systems.  It is best  to  use  the  most
  186.                     recent  available arp.library, since SKsh will not  run
  187.                     correctly with some early versions.
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.           SKsh Amiga Shell             Page 3           Installation Guide
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.                11)  The pure bit should be set on all of the SKsh  external
  206.                     commands.   This  can  be  accomplished with either the
  207.                     SKsh  chmod  command or the  AmigaDos  protect command.
  208.                     This  is  necessary if the  external commands are to be
  209.                     made resident.  If all  the  external commands are in a
  210.                     single  directory, and this directory contains no other
  211.                     files, then the SKsh command:
  212.  
  213.                          chmod +p *
  214.  
  215.                     will set the  pure  bit  provided that you are cd'ed to
  216.                     the proper directory.
  217.  
  218.                12)  If the script bit is  not  set  on  the  Check_?.?.sksh
  219.                     file (where ?.? is the version number  of  this  SKsh),
  220.                     set it with "chmod +s Check_?.?.sksh".   Then,  execute
  221.                     this script by cd'ing to the  directory  containing  it
  222.                     and typing the  name.   It  will  prompt  you  for  the
  223.                     locations of your SKsh  files,  and  verify  that  they
  224.                     have been installed correctly.  If not, it  will  print
  225.                     and error message for each offending file.
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.           SKsh Amiga Shell             Page 4           Installation Guide
  262.  
  263.  
  264.  
  265.