Return to ld80.1 CVS log

Up to [Research Unix] / researchv10dc / man / manb

Annotation of researchv10dc/man/manb/ld80.1, revision 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.

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