home *** CD-ROM | disk | FTP | other *** search
/ Jason Aller Floppy Collection / 83.img / SRCER486.ZIP / SAMPLE1.DEF < prev    next >
Text File  |  1989-10-30  |  17KB  |  246 lines
  1.  
  2.                   ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  3.                       SOURCER DEFINITION FILE - SAMPLE1
  4.                   ▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄
  5.  
  6.  
  7.  
  8.  
  9.  ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ Section 1: CONTROL INFORMATION   ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  10.  
  11.  comments are indented one or more spaces
  12.  ┌─── Section 1 instructions──────────────────────────────────────────────────┐
  13.  │                                                                            │
  14.  │ Enter any of the following options, starting in the 1st column             │
  15.  │  (for no options enter "none" )  Only the first letter of the              │
  16.  │  command is necessary.                                                     │
  17.  │                                                                            │
  18.  │  Analysis option    = xxxxx Any option letters A-Z can be used.  Upper     │
  19.  │                              case indicates turning option on, lower case  │
  20.  │                              turns the option off.   See manual for a      │
  21.  │                              complete list of options.                     │
  22.  │                               I - Inhibit graphics characters              │
  23.  │                               L - use for MASM versions prior to 4.5       │
  24.  │                               M - use for MASM versions prior to 4.5       │
  25.  │  Code style         = xxx   Code style types include:                      │
  26.  │                              com, exe, fragment, zero start,               │
  27.  │                              device driver, or overlay                     │
  28.  │  Drive              = x     Disk drive for output (letter a-z)             │
  29.  │  Format             = xxx   Output format ASM or LST for source code or    │
  30.  │                              listing output (LST is the default)           │
  31.  │  Go                         When the .def file has loaded, go              │
  32.  │  Header             = xxx   Enter the ascii header string (32 char max)    │
  33.  │  Input filename     = xxx   Filename for input (may include disk & path)   │
  34.  │  Keep segments      = xxx   When loading a file, use the file defined      │
  35.  │                              segments (FILE), use the def file segments    │
  36.  │                              in section 2 (DEF) or use both (BOTH)         │
  37.  │                              NOTE: Specify this option prior to file input │
  38.  │                              BOTH is the default, used in most cases       │
  39.  │  Label              = xxx   Select label type, Decimal, Zero fill,         │
  40.  │                              Segment & offset, Letter segment & offset     │
  41.  │  Math on                    Use the math co-processor instruction set      │
  42.  │  None                       Use default commands only                      │
  43.  │  Output filename    = xxx   Filename for output (may include drive & path) │
  44.  │  Passes             = x     Select the number of passes from 2 to 9        │
  45.  │  Remark             = xxx   Select remarks to be included: All, None,      │
  46.  │                              Data remarks only, Interrupts & I/O only,     │
  47.  │                              Others only, Except Data, Except Interrupts,  │
  48.  │                              Except Others                                 │
  49.  │  Segment display off        Turn off the display of segments on listings   │
  50.  │  Tabs off                   Only use spaces, no tabs                       │
  51.  │  uP                 = xxx   Select the uP from:                            │
  52.  │                              8088, V20/V30, 80186, 80286, P286, 80386,     │
  53.  │                              P386, 80486, P486 or AUTO for automatic       │
  54.  │  Vertical lines     = xxx   For listings, select the number of lines per   │
  55.  │                              page from 10 to 255 (default is 59)           │
  56.  │  Words to upper case        Set upper case style (lower case is default)   │
  57.  │  Xref               = xx    ON or OFF (selecting ON sets passes to 5)      │
  58.  │                                                                            │
  59.  └────────────────────────────────────────────────────────────────────────────┘
  60.   
  61.  ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ Section 1: CONTROL INFORMATION   ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  62.   
  63.         <<<<<  Insert commands here (start in column 1) or "none"
  64.  
  65.  
  66.  
  67.  ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ Section 2: RANGE DEFINITION      ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  68.  
  69.  ┌─── Section 2 instructions──────────────────────────────────────────────────┐
  70.  │                                                                            │
  71.  │  segment:offset = start processing location (hex)                          │
  72.  │                     see note 3 at end on referencing loaded file segments  │
  73.  │                                                                            │
  74.  │  end offset     = ending location for segment                              │
  75.  │                                                                            │
  76.  │  default ds, es = default used when not overwritten by in-line code        │
  77.  │                                                                            │
  78.  │  segment type   = auto  - code/data, full data resolving                   │
  79.  │                   code  - code, limited data resolving                     │
  80.  │                   data  - data, no code processed                          │
  81.  │                   stack - stack, no code processed                         │
  82.  │                   rauto - ROM code/data (same as "auto") in ROM            │
  83.  │                   rcode - ROM code (same as "code") in ROM                 │
  84.  │                                                                            │
  85.  │  segment size   = use16 for 16 bit segments (this is the default)          │
  86.  │                   use32 for 32 bit segments. The text use32 may not be     │
  87.  │                   abbreviated.                                             │
  88.  │                                                                            │
  89.  └────────────────────────────────────────────────────────────────────────────┘
  90.  
  91.  
  92.  ▒▒▒▒ Segments ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  93.   
  94.   begin      end      default      seg   seg  
  95.  seg:off     off     ds     es     type  size  
  96.  -------     ----    ----   ----   ----- -----
  97.         <<<<<  Insert ranges here (start in column 1) or "none"
  98.  
  99.  
  100.  
  101.    ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ Section 3  REFERENCE DEFINITIONS ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  102.  
  103.  ┌─── Section 3 instructions──────────────────────────────────────────────────┐
  104.  │                                                                            │
  105.  │  segment:offset = absolute location of item (hex)                          │
  106.  │                    see note 3 at end on referencing loaded file segments   │
  107.  │                                                                            │
  108.  │  typ            = type field                                               │
  109.  │                    DB = data byte                                          │
  110.  │                    DW = data word                                          │
  111.  │                    DD = double word                                        │
  112.  │                    DA = ascii text byte(s)                                 │
  113.  │                    DS = data structure                                     │
  114.  │                    SUB = subroutine reference (S can also be used)         │
  115.  │                    LOC = location reference   (L can also be used)         │
  116.  │                    FORCE = forced function    (F can also be used)         │
  117.  │                                                                            │
  118.  │  options (indicate one or more options with a comma separator)             │
  119.  │                                                                            │
  120.  │     data options:  , C xxx    comment number xxx (from 1 to 3FF)           │
  121.  │                    , EQU      treat label as an equate                     │
  122.  │                    , DUP      duplicate same bytes/words R times           │
  123.  │                    , INDEX    replace a index of the same value            │
  124.  │                    , MULTI    multi-defined label                          │
  125.  │                    , OSN      offset sub_xxx               (Sub Near)      │
  126.  │                    , OSF      offset sub_xxx, seg sub_xxx  (Sub Far)       │
  127.  │                    , OLN      offset loc_xxx               (Loc Near)      │
  128.  │                    , OLF      offset loc_xxx, seg loc_xxx  (Loc Far)       │
  129.  │                    , ODN      offset data_xxx              (Data Near)     │
  130.  │                    , ODF      offset data_xx, seg data_xx  (Data Far)      │
  131.  │                    , R xxxx   repeat 0 to FFFF, (FFFF bytes max)           │
  132.  │                                 (i.e. dw, R 4    indicates 8 bytes)        │
  133.  │                    , SEG      item is a segment name (dw only)             │
  134.  │                    , UNUSED   if item is never referenced, then do not use │
  135.  │                                                                            │
  136.  │      Location      , C xx     comment number xx (from 1 to FF)             │
  137.  │         options:   , EXT      external entry point to program              │
  138.  │                    , FAR      far procedure                                │
  139.  │                    , NEAR     near procedure                               │
  140.  │                              Note: EXT, FAR & NEAR all reset the simulator │
  141.  │                    , UNUSED   if item is never referenced, then do not use │
  142.  │                                                                            │
  143.  │      Subroutine    , C xx     comment number xx (from 1 to FF)             │
  144.  │         options:   , FAR      subroutine is defined as FAR                 │
  145.  │                    , TERM     subroutine terminates (does not return to    │
  146.  │                                 caller)                                    │
  147.  │                    , UNUSED   if item is never referenced, then do not use │
  148.  │                                                                            │
  149.  │       Forced       , CODE     switch to code mode                          │
  150.  │          options:  , DATA     switch to data mode                          │
  151.  │                    , CODE16   switch to 16 bit code mode                   │
  152.  │                    , CODE32   switch to 32 bit code mode                   │
  153.  │                    , ENDP     force a endp to appear after instruction     │
  154.  │                    , AX=xxxx  change the value of any simulation           │
  155.  │                               register ax/bx/cx/dx/bp/si/di/sp             │
  156.  │                                        ds/es/ss/fs/gs                      │
  157.  │                    , EAX=xxxx  change the value of any 32 bit simulation   │
  158.  │                                register eax/ebx/ecx/edx/ebp/esi/edi        │
  159.  │                    , EAx      LEA instruction's reference item type        │
  160.  │                                 EAS for sub, EAL for location, EAD for data│
  161.  │                                 optional segment follows                   │
  162.  │                    , Ox       convert immediate value to offset            │
  163.  │                               OS for sub, OL for location, OD for data     │
  164.  │                               optional segment follows (cs segment default)│
  165.  │                    , REG      display the internal simulation registers    │
  166.  │                                                                            │
  167.  │                            Forced index table analysis for calls & jumps   │
  168.  │                    , SN       table type "offset sub_xx"                   │
  169.  │                    , SF       table type "offset sub_xxx, seg sub_xxx"     │
  170.  │                    , LN       table type "offset loc_xx"                   │
  171.  │                    , LF       table type "offset loc_xxx, seg loc_xxx"     │
  172.  │                           format: "seg_a:xxxx  f, sn 1234:22 34"           │
  173.  │                               where 1234:22 is the location of the table   │
  174.  │                               with 34h entries                             │
  175.  │                                                                            │
  176.  │  label field    = enter label up to 15 characters long                     │
  177.  │                     (label ignored for forced functions;                   │
  178.  │                         do not place a comma before or inside label)       │
  179.  │                                                                            │
  180.  │  comment field  = a short comment can be included here (64 characters max) │
  181.  │                   if a semi-colon appears, the rest of the line is ignored │
  182.  └────────────────────────────────────────────────────────────────────────────┘
  183.                                                                                
  184.    ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ Section 3  REFERENCE DEFINITIONS ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  185.  
  186.  
  187.  ════ Subroutines ═══════════════════════
  188.   seg:off   type & options     label           comments
  189.   -------   --------------     --------------  --------------
  190.         <<<<<  Insert new reference definitions here (start in column 1)
  191.  
  192.  
  193.  ════ Locations        ═════════════════════════
  194.   seg:off   type & options     label           comments
  195.   -------   --------------     --------------  --------------
  196.         <<<<<  Insert new reference definitions here (start in column 1)
  197.  
  198.  
  199.  ════ Data Items ════════════════════════
  200.   seg:off   type & options     label           comments
  201.   -------   --------------     --------------  --------------
  202.         <<<<<  Insert new reference definitions here (start in column 1)
  203.  
  204.  
  205.  
  206.  
  207.  ┌─── General Notes ─────────────────────────────────────────────────────────┐
  208.  │  Notes:                                                                   │
  209.  │     1) Must have at least one entry in each section to operate properly.  │
  210.  │          Use "none" if no entries are needed for a section.               │
  211.  │          Separate each section with at least one line with a space in     │
  212.  │          column 1.                                                        │
  213.  │                                                                           │
  214.  │     2) Order of entries within each section is unimportant.               │
  215.  │                                                                           │
  216.  │     3) When a filename is specified in section 1, it is loaded and the    │
  217.  │         first 250 segments can be referenced as "seg_a" to "seg_z" and    │
  218.  │          "seg_aa" to "seg_az" through to the 250th segment "seg_io".      │
  219.  │          These can be used anywhere a segment is required.  For example   │
  220.  │          a location label can be defined as:                              │
  221.  │                                                                           │
  222.  │                        6234:0124  loc, Ext, C 2  temp_value_a             │
  223.  │                  or:   seg_b:0124 loc, Ext, C 2  temp_value_a             │
  224.  │                                                                           │
  225.  │          The second entry will use the 2nd segment within the loaded file │
  226.  │          An error will be generated if a segment is used beyond those     │
  227.  │          specified by the file load (Consult manual for more information).│
  228.  │                                                                           │
  229.  │     4) Section 3 ignores blank lines or lines starting with a space in    │
  230.  │          column 1, or the balance of a line where a semicolon occurs.     │
  231.  │                                                                           │
  232.  │     5) The following examples show acceptable forms for the same function,│
  233.  │          a location entry as a external entry point with comment #2:      │
  234.  │                                                                           │
  235.  │          seg_a:0124 loc, Ext, C 2  temp_value_a  ; prefered format        │
  236.  │          seg_a:0124 l, Ext, C 2  temp_value_a                             │
  237.  │          seg_a:0124 l, E, C=2  temp_value_a      ; notes can follow       │
  238.  │          seg_a:0124 l, External, C 2       temp_value_a                   │
  239.  │          seg_a:0124 Location, Ext, C 02   temp_value_a                    │
  240.  │          seg_a:0124 L, e, c 2 temp_value_a                                │
  241.  │                                                                           │
  242.  │     6) Upper and lower case will have no effect (except for analysis      │
  243.  │          options), but is preserved for labels.                           │
  244.  └───────────────────────────────────────────────────────────────────────────┘
  245.  
  246.