home *** CD-ROM | disk | FTP | other *** search
/ Columbia Kermit / kermit.zip / ccdos / ccsaaahlp.txt < prev    next >
Text File  |  2020-01-01  |  4KB  |  97 lines
  1. CCSAAA.HLP                                                 July 1991
  2.  
  3.     INSTRUCTIONS FOR BUILDING CC-DOS KERMIT 2.32 FROM SOURCE CODE
  4.        -- Quanfang Zhang, Zhejiang University, P.R. China
  5.  
  6. CC-DOS Kermit is written in assembly language for the Microsoft MASM
  7. assembler.  To assemble any of the Kermit modules, file CCSDEF.H must be on
  8. the default disk.  The source modules are:
  9.  
  10.  CCSDEF.H    Symbol definitions for all modules
  11.  CCSCMD.ASM  Command parser
  12.  CCSCOM.ASM  Communications (packets, system-independent)
  13.  CCSFIL.ASM  File i/o
  14.  CCSKER.ASM  Main program
  15.  CCSRCV.ASM  Receive module
  16.  CCSSCP.ASM  Script module
  17.  CCSSEN.ASM  Send module
  18.  CCSSER.ASM  Server module
  19.  CCSSET.ASM  Set command module
  20.  CCSTER.ASM  Terminal emulation (system-independent)
  21.  CCSFIN.ASM  Final module
  22.  CCXIBM.ASM  System-dependent i/o, interrupt handling,etc
  23.  CCYIBM.ASM  Terminal emulation
  24.  CCZIBM.ASM  The CCY module got too big
  25.  CCGIBM.ASM  Tektronix emulator for use with CC Kermit/IBM.
  26.  CCUIBM.ASM  Keyboard translator
  27.  CCHKOS.ASM  DOS status check 
  28.  
  29. The program needs an CCX module (system-dependent i/o, interrupt handling,
  30. etc) for the desired system, plus an CCU modle (keyboard translator), plus an
  31. CCY module (terminal emulation) for the same system (if there is one), and
  32. possibly an CCZ module (in case the CCY module got too big).  The CCX and CCY
  33. file may come with associated .HLP files, which you should read.  Also,
  34. if you can't find the CCU, CCX and CCY modules for your system, read file
  35. CCAAAA.HLP, which lists the naming conventions.
  36.  
  37. ASSEMBLING:
  38.  
  39. For version 2.32 of CC-DOS Kermit, Microsoft MASM 5.0 or later, or compatible
  40. assemblers, must be used.  Some of Kermit's modules have too many symbols for
  41. earlier MASM versions.  MASM can be used without any special switches.  Each
  42. .ASM file is assembled independently to produce a .OBJ file.  Note that the
  43. standard header file CCSDEF.H must be present with the .ASM file during
  44. assembly.  Compatible versions of MASM and LINK should be used together; check
  45. the file dates. A typical command is
  46.  
  47.         A>masm ccscom;
  48.  
  49. LINKING:
  50.  
  51. Once all the required object modules exist, they may be linked together to
  52. produce Kermit.  For example, for the IBM PC version:
  53.  
  54. C>link
  55.  
  56.    Microsoft Overlay Linker V3.61
  57.    Copyright (C) Microsoft Corp 1983-1987.  All rights reserved.
  58.  
  59. Object Modules [.OBJ]: cchkos ccscmd ccscom ccsfil ccsker ccsrcv ccsscp +
  60. ccssen ccsser ccsset ccster ccgibm ccuibm ccxibm ccyibm cczibm ccsfin
  61. Run File [CCHKOS.EXE]: Kermit;          (or other convenient name)
  62.  
  63. C>
  64.  
  65. If a convenient Link command file is used, such as CCVIBM.LNK below, then the
  66. appropriate command is just
  67.  
  68.         A>link @ccvibm.lnk
  69.  
  70.  
  71. USING MAKE:
  72.  
  73. Makefile (for those who have the Microsoft DOS version of the UNIX 'make'
  74. program) to build CC-DOS Kermit is in CCVIBM.MAK. To
  75. execute a makefile, type the command "make ccvibm.mak".  The makefile shows 
  76. the assembly, link, and BOO steps.  The advantage of using "make" is that only 
  77. those steps that are necessary will be performed -- e.g. .ASM files will not 
  78. be reassembled if there is already a corresponding .OBJ file with a later 
  79. creation date.
  80.  
  81. USING DOS BATCH:
  82.  
  83. There is also a CCVIBM.BAT file which can also be used to assemble and link
  84. CC-DOS Kermit. 
  85.  
  86. THE LINK STEP:
  87.  
  88. Both the makefile and the batch file rely on the presence of an CCVIBM.LNK
  89. Linker command file for each implementation.  For instance, here is CCVIBM.LNK
  90. for the IBM PC family:
  91.  
  92. cchkos+ccscmd+ccscom+ccsfil+ccsker+ccsrcv+ccsscp+ccssen+ccsser+
  93. ccsset+ccster+ccgibm+ccuibm+ccxibm+ccyibm+cczibm+ccsfin
  94. ccvibm;
  95.  
  96. [End of CCSAAA.HLP]
  97.