Imported Upstream version 2.9.0
[debian/cc1111] / as / doc / abstra.txt
1
2
3         ASxxxx Cross Assemblers, Version 1.7, November 1995 
4
5         Submitted by Alan R.  Baldwin, 
6         Kent State University, Kent, Ohio 
7
8         Operating System:  TSX+, RT-11, MS/DOS, PDOS 
9         or other supporting K&R C.  
10
11         Source Langauge:  C 
12
13         Abstract:  
14
15            The  ASxxxx  assemblers are a series of microprocessor assem-
16         blers written in the C programming  language.   This  collection
17         contains cross assemblers for the 6800(6802/6808), 6801(hd6303),
18         6804,   6805,   68HC08,   6809,   6811,   68HC16,    8085(8080),
19         z80(hd64180), H8/3xx, and 6500 series microprocessors.  Each as-
20         sembler has a  device  specific  section  which  includes:   (1)
21         device  description, byte order, and file extension information,
22         (2) a table of assembler general directives, special directives,
23         assembler  mnemonics and associated operation codes, (3) machine
24         specific code for processing the  device  mnemonics,  addressing
25         modes, and special directives.  
26
27            The assemblers have a common device independent section which
28         handles the details of file input/output, symbol  table  genera-
29         tion,  program/data  areas,  expression  analysis, and assembler
30         directive processing.  
31
32            The  assemblers  provide  the following features:  (1) alpha-
33         betized, formatted symbol table listings, (2) relocatable object
34         modules, (3) global symbols for linking object modules, (4) con-
35         ditional assembly directives, (5) reusable  local  symbols,  and
36         (6) include-file processing.  
37
38            The  companion program ASLINK is a relocating linker perform-
39         ing the following functions:  (1) bind multiple  object  modules
40         into  a  single  memory  image,  (2) resolve inter-module symbol
41         references,  (3)  resolve  undefined  symbols   from   specified
42         librarys of object modules, (4) process absolute, relative, con-
43         catenated, and overlay attributes in data and program  sections,
44         (5)  perform  byte and word program-counter relative (pc or pcr)
45         addressing calculations, (6) define absolute  symbol  values  at
46         link  time, (7) define absolute area base address values at link
47         time, (8) produce Intel Hex or Motorola  S19  output  file,  (9)
48         produce  a  map  of the linked memory image, and (10) update the
49         ASxxxx assembler listing files  with  the  absolute  linked  ad-
50         dresses and data.  
51
52            The  assemblers  and  linker  have  been tested using DECUS C
53         under TSX+ and RT-11, PDOS C V5.4b, and Symantec C/C++ V6.1/V7.0
54         under  DOS/Windows  3.x.  Complete source code and documentation
55         for the assemblers and linker is included with the distribution.
56         Additionally, test code for each assembler and several micropro-
57         cessor monitors ( ASSIST05 for the 6805, MONDEB and ASSIST09 for
58         the  6809, and BUFFALO 2.5 for the 6811) are included as working
59         examples of use of these assemblers.  
60 \f