|
|
1.1 root 1: .th "ld80" 1 1/2/78
2: .sh NAME
3: "ld80" \*- link editor for the 8080/Z80 load moduals.
4: .sh SYNOPSIS
5: .bd "ld80"
6: [
7: .bd \*-ultdb
8: ] name ...
9: .sh DESCRIPTION
10: .it "ld80"
11: combines several
12: object programs into one; resolves external
13: references; and searches libraries.
14: In the simplest case the names of several object
15: programs are given, and
16: .it "ld80"
17: combines them, producing
18: an object module which can be either executed or
19: become the input for a further
20: .it "ld80"
21: run.
22: The output of
23: .it "ld80"
24: is left on
25: .bd "80.out".
26: This file is made executable
27: only if no errors occurred during the load.
28: .s3
29: The argument routines are concatenated in the order
30: specified. The entry point of the output is the
31: beginning of the first routine.
32: .s3
33: If any argument is a library, it is searched exactly once
34: at the point it is encountered in the argument list.
35: Only those routines defining an unresolved external
36: reference are loaded.
37: If a routine from a library
38: references another routine in the library,
39: the referenced routine must appear after the
40: referencing routine in the library.
41: Thus the order of programs within libraries
42: is important.
43: .s3
44: .it "ld80"
45: understands several flag arguments which are written
46: preceded by a `\*-'.
47: Except for \fB\*-l\fR,
48: they should appear before the file names.
49: .s3
50: .lp +4 4
51: \fB\*-b\fR This
52: option is used to provide an absolute origin for the bss segment
53: of the resultant "80.out".
54: The supplied origin must be the next argument on the command
55: line and must be a positive or negative octal (leading 0) or
56: decimal number.
57: The defualt is for the bss segment to immediately follow the data
58: segment.
59: Use of this option will cause the relocation information to
60: be suppressed from the output.
61: .s3
62: .lp +4 4
63: \fB\*-d\fR This
64: option is used to provide an absolute origin for the data segment
65: of the resultant "80.out".
66: The supplied origin must be the next argument on the command
67: line and must be a positive or negative octal (leading 0) or
68: decimal number.
69: The default is to have the data placed directly
70: after the text.
71: Use of this option will cause the relocation information to
72: be suppressed from the output.
73: .s3
74: .lp +4 4
75: \fB\*-u\fR take the following argument as a symbol and enter
76: it as undefined in the symbol table. This is useful
77: for loading wholly from a library, since initially the symbol
78: table is empty and an unresolved reference is needed
79: to force the loading of the first routine.
80: .s3
81: .lp +4 4
82: \fB\*-t\fR This
83: option is used to provide an absolute origin for the text segment
84: of the resultant "80.out".
85: The supplied origin must be the next argument on the command
86: line and must be a positive or negative octal (leading 0) or
87: decimal number.
88: The default origin is 0.
89: Use of this option will cause the relocation information to
90: be suppressed from the output.
91: .s3
92: .lp +4 4
93: \fB\*-l\fR This
94: option is an abbreviation for a library name.
95: \fB\*-l\fR
96: alone stands for `/usr/z8080/lib/z80', which
97: is the standard library for assembly language
98: programs.
99: \fB\*-l\fIx\fR
100: stands for `/usr/z8080/lib/z80\fIx\fR.a' where \fIx\fR is any character.
101: A library is searched when its name is encountered,
102: so the placement of a \fB\*-l\fR
103: is significant.
104: .i0
105: .dt
106: .sh FILES
107: /usr/z8080/lib/z80 libraries
108: .br
109: "80.out" output file
110: .sh "SEE ALSO"
111: "as80" (I), ar (I)
112: .sh BUGS
113: Most diagnostics are self explanatory.
114: The strangest is 'origin - conflict' and
115: occurs whenever an origin supplied by the user via
116: the -t -d or -b options causes segments to overlap.
117: The numbers printed out correspond
118: origins and sizes(both in octal) of each resultant segment.
119: .bd "80.out"
120: is produced.
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.