home *** CD-ROM | disk | FTP | other *** search
/ Oakland CPM Archive / oakcpm.iso / cpm / asmutl / spasm201.lbr / SLINK.DZC / SLINK.DOC
Encoding:
Text File  |  1988-09-02  |  3.1 KB  |  105 lines
  1. SLINK - LINKAGE EDITOR FOR SPASM   Version 2.00+
  2. (C) Copyright 1986,87,88    by: Harris Landsberg
  3.  
  4. Short Quick Reference:
  5.  
  6. A: OPERATION
  7.  
  8.    SLINK <object_file> [<object_file>...][/switch...]
  9.  
  10.    Can use drive and/or user to proceed to filename
  11. of the object file. ".OBJ" is implied and appended
  12. by the linker to the filename. The first file provides
  13. the output file name with a ".COM" appened to it.
  14.  
  15.    ex: SLINK a:sample b3:zsys 15:devio
  16.  
  17.    uses SAMPLE.OBJ on the A drive in the current user
  18. area and creates a file SAMPLE.COM on the A drive and
  19. current user area. Also uses ZSYS.OBJ found on the B
  20. drive in user area 3 and DEVIO.OBJ found on the current
  21. drive and in user area 15.
  22.  
  23. B: SWITCHES (optional)
  24.  
  25. 1)   /C:<value>
  26.  
  27.      start code counter at value [hex] (default 100H)
  28.  
  29. 2)   /D:<value>
  30.  
  31.      start data counter at value [hex] (default end.code+1)
  32.  
  33. 3)   /G:<symbol>
  34.  
  35.      create a jump to symbol at start of code. This is used
  36.      if beginning of code is not at the start of the first
  37.      module that is loaded. (default none)
  38.  
  39. 4)   /L:<librname>
  40.  
  41.      use library name for library requests to search for
  42.      imported modules. Will search /L libraries before the
  43.      libraries defined in object code. Library name can
  44.      contain a drive/user specification but .OBJ is assumed.
  45.  
  46. 5)   /M
  47.  
  48.      create a .MAP file if link was successful. This file
  49.      has start address and length of every module for both
  50.      the CODE and DATA areas. May be used for debugging.
  51.  
  52. 6)   /S
  53.  
  54.      create a .SYM file if link was successful. This file
  55.      has all the addresses of all symbols. May also be used
  56.      for debugging.
  57.  
  58. C: PRE-DEFINED SYMBOLS
  59.  
  60.      These symbols should not be defined in your code. They
  61. can be used to find out where your code is located and how
  62. much stack and heap can be allocated.
  63.  
  64.      ?CODE   beginning address of code
  65.  
  66.      ?DATA   beginning address of data
  67.  
  68.      ?HEAP   address after data segment
  69.  
  70.  
  71. D: OBJECT FORMAT
  72.  
  73.      See SLINK-F Documentation file for complete listing of
  74. object file format. The format consists of bit stream fields
  75. that are not byte aligned and define relocatable object code,
  76. absolute text code, and symbol table information.
  77.  
  78. E: COMMENTS
  79.  
  80.      This applies to SLINK.COM and SLINK80.EXE (except that
  81. path names can be used instead of drive/user). SLINK86.EXE
  82. is different and defines extra switches to process different
  83. frames, groups, classes, segments, and threads which is not
  84. of any use to 8080 or Z80 code. Besides, SLINK86.EXE uses a
  85. modified object format to support large load modules.
  86.  
  87.      See the documention of SPASM and SPL Language for more
  88. information about SLINK uses and object module concepts.
  89.  
  90. F: LIMITATIONS
  91.  
  92.      SLINK does not currently support the following:
  93.  
  94.      a) External Dictionary Definitions.
  95.      b) Overlay Segmentation or Structures.
  96.      c) .LOD Relocatable Load Members.
  97.      d) Extended Equate Symbol Structures.
  98.  
  99.      Send comments, bug reports to:
  100.  
  101.                   HARRIS LANDSBERG
  102.                 1350 East 5th STreet
  103.                      Suite 1-J
  104.               Brooklyn, New York 11230
  105.