123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172 |
- .\" $Id$
- .TH EM_ASS 6 "$Revision$"
- .ad
- .SH NAME
- em_ass \- EM assembler/loader
- .SH SYNOPSIS
- .B ~em/lib.bin/em_ass
- [options] argument ...
- .SH DESCRIPTION
- Em_ass assembles and links EM modules.
- Arguments may be flags, EM modules or libraries.
- Flags recognized are:
- .IP "-ss, -sm, -sl, -sx"
- Indicate that the program is small, medium, large, or extra large.
- Large is the default.
- .IP -p
- List all procedure names together with base-address (decimal and octal),
- procedure number and module of definition.
- .IP -d
- Used for debugging em_ass itself.
- .IP -U
- With this flag, em_ass has exit status 0 even when there are unresolved
- references.
- .PD
- .PP
- em_ass assembles and links together compact EM assembly language modules
- from files and libraries,
- producing an e.out file as described in [1].
- .PP
- Two different types of arguments are allowed:
- .IP "1 -"
- Compact EM assembly language modules (optimized or not), recognized by a
- magic number in the first word.
- .PD 0
- .IP "2 -"
- UNIX archives, as maintained by arch(1). These archives must contain
- EM modules only.
- .PD
- .PP
- EM modules may contain a library message specifying the names
- of procedures and external data defined inside the module.
- These will only be loaded
- if they contain definitions of procedures or data imported by
- previously assembled modules.
- When \fIack\fP(1) is provided with the -LIB flag it tells the
- EM-optimizer \fIem_opt\fP(6) to insert a library messages
- when optimizing modules.
- The EM-archiver \fIarch\fP(1) can be used to create libraries
- from EM modules.
- .PP
- Note that it is not possible to do a partial load;
- loading starts from compact EM code and produces binary
- EM code. No symbol table and no relocation bits are produced.
- .SH "SEE ALSO"
- ack(1), arch(1)
- .PD 0
- .IP [1]
- A.S. Tanenbaum, Hans van Staveren, Ed Keizer and Johan
- Stevenson "Description of a machine architecture for use with
- block structured languages" Informatica report IR-81.
- .SH DIAGNOSTICS
- Various diagnostics may be produced. In the case of compiler
- produced code the only messages to expect are "Out of memory"
- or of the
- form: Overflow in XXXX. The latter can usually be cured by giving
- a -sx flag,
- the former means the program is too big, dimishing
- the size of very large procedures can sometimes help.
- The most likely errors, however, are unresolved references,
- probably caused by the omission of a library argument.
- .SH AUTHOR
- Ed Keizer, Vrije Universiteit
|