home *** CD-ROM | disk | FTP | other *** search
/ Columbia Kermit / kermit.zip / multics / muinstl.txt < prev    next >
Text File  |  2020-01-01  |  6KB  |  276 lines
  1.  
  2.  
  3.  
  4.      Oakland University                     Rochester, MI
  5.      Academic Computer Services             48063     USA
  6. =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  7.                                             August 16, 1984
  8.  
  9.  
  10.  
  11.  
  12.                   Installation Instructions for
  13.                            Kermit 2.0g
  14.  
  15.  
  16.  
  17.      Multics Kermit has been packaged  for  distribution  as  two
  18.  
  19. large  source  files,  kermit.pl1 (mukmt.pl1, the user interface)
  20.  
  21. and kermit_.pl1 (mukmtp.pl1, the protocol machine).  All  include
  22.  
  23. files  have been premerged for ease of distribution.  If you want
  24.  
  25. an archive of the entire source in  the  original  Multics  form,
  26.  
  27. send a tape directly to me.
  28.  
  29.  
  30.  
  31.      The source files do not contain any control characters other
  32.  
  33. than  form  feed characters for listing pagination.  There should
  34.  
  35. be no trouble with  sending  these  files  over  various  network
  36.  
  37. connections.
  38.  
  39.  
  40.  
  41.      Before  compiling the programs, one or two options should be
  42.  
  43. set in kermit.pl1.  The  variable  kermit_info_dir  contains  the
  44.  
  45. path  name  of  the  directory  containing all of the kermit help
  46.  
  47. files used in the internal help facility.  All help files  should
  48.  
  49. be  in  this  directory.  It is currently set to >am>KERMIT>info.
  50.  
  51. This may need to be changed in your installation.  A  listing  of
  52.  
  53. the  help  files, their names on the tape and their multics names
  54.  
  55. follows later in this document.  There are also  three  variables
  56.  
  57. used  to  control  the  builtin  metering facility.  The variable
  58.  
  59. meter_enable turns metering on if initialized to true and off  if
  60.  
  61. initialized  to  false.   If  metering  is on, kermit will send a
  62.  
  63. message to a specified mailbox with  information  on  the  kermit
  64.  
  65. session.   The  variable  kermit_mbx  contains  the  name  of the
  66.  
  67. mailbox.  If it is a pathname, kermit_mbx_ctl_arg should have the
  68.  
  69. value "-pn".  If  it  is  a  Personid.ProjID,  kermit_mbx_ctl_arg
  70.  
  71. should be a null string.  The message sent contains the following
  72.  
  73. information:
  74.  
  75.    # Pkts sent  # Pkts recd  # Retries  # Files sent
  76.  
  77.       # Files recd  # File Failures  Mode (R=Reg, S=Server)
  78.  
  79. This message is sent only if file transfer has been attempted.
  80.  
  81.  
  82.  
  83.      Note the default modes string.  Files are transfered through
  84.  
  85. block transfer with no initial character and a CR terminating the
  86.  
  87. block.   Raw  output  and no parity are used to allow binary file
  88.  
  89. transmission.  Echoplex is turned off.   The  force  mode  is  in
  90.  
  91. effect to allow non-appropriate modes to be ignored.  If for some
  92.  
  93. reason, the default needs to be changed, it should be done in the
  94.  
  95. beginning of kermit.pl1 where the info structure is allocated and
  96.  
  97. initialized.   These  modes have been found to work reliably over
  98.  
  99. time.  Be sure to test any changes.  Users also have  the  option
  100.  
  101. of setting the modes kermit will use via the
  102.  
  103.       set modes <modes_string>
  104.  
  105. command.   This may also be a command argument (kermit -set modes
  106.  
  107. <modes_string>).   The  program  assumes  no  responsibility  for
  108.  
  109. consequences  if  improper  modes  are  employed  so users should
  110.  
  111. exercise care in this option.  Note that the entire modes  string
  112.  
  113. is replaced; it is not modified.  The string is checked for valid
  114.  
  115. modes before it is replaced, however.
  116.  
  117.  
  118.  
  119.      The  info  structure  is  allocated  once  per  process in a
  120.  
  121. temporary  segment.   All  settings  (except  default  directory)
  122.  
  123. remain as set throughout the process.
  124.  
  125.  
  126.  
  127.      Compile  the  two  programs  and  bind  them together into a
  128.  
  129. single object.  The kermit program has  the  entrypoints  kermit,
  130.  
  131. new_kermit and old_kermit.
  132.  
  133.  
  134.  
  135.      The  following is a list of help files used by this version:
  136.  
  137.  
  138.  
  139.       Multics Name              ANSI TAPE NAME
  140.  
  141.   ---------------------     ----------------------
  142.  
  143.   server_online.k.info        musrvn.hlp
  144.  
  145.   kermit_online.info          mukmt.hlp
  146.  
  147.  
  148.  
  149.   kermit.info                 mugkmt.hlp
  150.  
  151.   kermit_bugs.info            mukmtb.hlp
  152.  
  153.  
  154.  
  155.      The kermit_online.info segment contains the text for all  of
  156.  
  157. the    online   help   information.    This   segment   and   the
  158.  
  159. server_online.k.info segment should reside in the info dir.   The
  160.  
  161. segment kermit_online.info should have the following addnames:
  162.  
  163.        set.k.info
  164.  
  165.        server.k.info
  166.  
  167.        help.k.info
  168.  
  169.        exec.k.info
  170.  
  171.        show.k.info
  172.  
  173.        status.k.info
  174.  
  175.        send.k.info
  176.  
  177.        receive.k.info
  178.  
  179.        kermit.k.info
  180.  
  181.  
  182.  
  183.  
  184.  
  185.      The kermit_bugs file lists those bugs or idiosyncracies that
  186.  
  187. I am aware of.  I would appreciate it if you would send along any
  188.  
  189. discrepencies identified by your users.
  190.  
  191.  
  192.  
  193.     Also  included  is  a  help  seg  for  the command level help
  194.  
  195. command called mugkmt.hlp (kermit.info).  This lists all commands
  196.  
  197. and options currently  available.   Only  this  segment  and  the
  198.  
  199. kermit_bugs.info  segment  need to be linked into the system help
  200.  
  201. directories.
  202.  
  203.  
  204.  
  205.      The last two files on the tape  (mukmt.tre  and  mukmtp.tre)
  206.  
  207. contain  call trees for kermit and kermit_.  These are short form
  208.  
  209. call trees that contain the call structure of the program.  These
  210.  
  211. may be useful for understanding the program structure.
  212.  
  213.  
  214.  
  215.     Comments and critism may be directed to me at the address  at
  216.  
  217. the  top  of this page.  I may also be reached at (313) 377-4329.
  218.  
  219. With any luck we will be on MailNet in the not too distant future
  220.  
  221. and communications will improve.
  222.  
  223.  
  224.  
  225.                               Paul Amaranth
  226.  
  227.                               8/16/84
  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.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.  
  272.  
  273.  
  274.  
  275.  
  276.