Annotation of researchv10dc/man/manb/ld80.1, revision 1.1.1.1

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.

unix.superglobalmegacorp.com

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.