Trailing-Edge
-
PDP-10 Archives
-
BB-J713A-BM
-
language-sources/link.rnd
There are 6 other files named link.rnd in the archive. Click here to see a list.
.LM0.RM70.F.J.SP1.TS5.AP
.TITLE LINK.DOC -- Changes from LINK 4(765) to LINK 4A(1220)
LINK.DOC -- Changes from LINK 4(765) to LINK 4A(1220)
.BREAK
August 1979
.FG30
COPYRIGHT (C) 1979 BY
.BR
DIGITAL EQUIPMENT CORPORATION, MAYNARD, MASS.
.B 2
THIS SOFTWARE IS FURNISHED UNDER A LICENSE AND MAY BE USED AND COPIED
ONLY IN ACCORDANCE WITH THE TERMS OF SUCH LICENSE AND WITH THE INCLUSION
OF THE ABOVE COPYRIGHT NOTICE. THIS SOFTWARE OR ANY OTHER COPIES
THEREOF MAY NOT BE PROVIDED OR OTHERWISE MADE AVAILABLE TO ANY OTHER
PERSON. NO TITLE TO AND OWNERSHIP OF THE SOFTWARE IS HEREBY TRANSFERRED.
.B 1
THE INFORMATION IN THIS SOFTWARE IS SUBJECT TO CHANGE WITHOUT
NOTICE AND SHOULD NOT BE CONSTRUED AS A COMMITMENT BY DIGITAL
EQUIPMENT CORPORATION.
.B 1
DIGITAL ASSUMES NO RESPONSIBILITY FOR THE USE OR RELIABILITY OF ITS
SOFTWARE ON EQUIPMENT WHICH IS NOT SUPPLIED BY DIGITAL.
.PG
.VARIABLE NOSHIP + -
.!1.0
.HL 1 SUMMARY
.P0,1
LINK is the linking loader for the DECsystem-10 and DECSYSTEM-20. LINK
version 4A is a maintenance release designed to get bug fixes made since the
last release of LINK distributed to the field. Very few new features are
present, but LINK 4A should be significantly more reliable than LINK 4 when
loading user programs.
LINK 4A supercedes all previous versions. It runs under all supported monitors,
and has been tested under TOPS-10 6.03A an 7.00, and under TOPS-20 releases 3A
and 4. All patches published through 21-Aug-79 have been incorporated into
LINK 4A.
LINK is documented in the LINK Reference Manual. This manual is available to
DECsystem-10 sites as part of volume 11 of the TOPS-10 Software Notebooks,
or separately as order number AA-0988C-TB. DECSYSTEM-20 sites can find this
manual in volume 4 of the TOPS-20 Software Notebooks, or it can be ordered
separately as order number AA-4183B-TM.
.PAGE
.!2.0
.HL 1 EXTERNAL CHANGES
.!2.1
.HL 2 Changes to LINK
The following sections contain summaries of all externally visible changes
that have been made to LINK since version 4(765). Refer to the file LINK.PCO
for more information on specific edits.
.!2.1.1
.HL 3 EXE file generation by default
Previous versions of LINK loaded certain types of programs incorrectly
if the user did not ask for an EXE file with /SAVE. For example,
programs containing embedded nonexistent pages due to gaps between psect
were loaded with the pages existent, and programs with very low high segment
origins did not load at all. These problems were all due to LINK's inability
to exit with the user program set up in memory correctly, and they could
all be bypassed by typing /SAVE to LINK.
LINK version 4A will automatically generate an EXE file when programs of this
class are detected. As part of this change, the old LNKNCL and LNKNCX
messages have been deleted, and LINK will now issue the new LNKPCL or LNKPCX
messages whenever it decides to generate an EXE file on its own. For more
information, see the PCL and PCX messages in the file LNKMSG.MAN. This was
edit 1146 to LINK, PCO 10-LINK-264.
.!2.1.2
.HL 3 The .HIGH_. Psect
Declaring a psect with the name .HIGH_. is now equivalent to declaring a
high segment via REL block type 3 (the MACRO HISEG or TWOSEG pseudo-ops).
This provides a convenient mechanism for mixing psect and high segment
code in the same MACRO source file, since you can now put
the high segment code into
the .HIGH_. psect. This was edit 1155 to LINK, PCO 10-LINK-271.
.!2.1.3
.HL 3 Loading Large Programs
LINK now catches attempts to load programs that extend beyond location
777777, and issues the new LNKPTL message. Previous versions of LINK
got various internal errors if this occurred. This was edit 1204 to
LINK, PCO 10-LINK-293.
.!2.1.4
.HL 3 Searching FORLIB
LINK will now search SYS:FORLIB.REL in /SEGMENT:LOW mode when loading
FORTRAN program, unless the program is being loaded in /OTS:NONSHAR
mode. This allows subroutines in FORLIB to be written with two segments
without forcing FOROTS to be read in at load time. This was edit 1200
to LINK, PCO 10-LINK-289.
.!2.1.5
.HL 3 Symbol table differences
LINK 4A generates a slightly different runtime DDT symbol table than its
predecessors, which may lead to differences detected by FILCOM if old and
new EXE files loaded with symbols are compared. The differences are as
follows:
.LIST
.le;The module length of the module PAT._. is now set up just like all other
modules. This will show up as the left half of some word in the symbol table
changing from zero to 777774.
.le;Psect names are no longer put into the runtime symbol table as empty
modules. This will make the runtime symbol table generated by LINK 4A
somewhat smaller than that generated by previous versions of LINK for
programs that use psects, since the word pairs that represented the psect
names will be missing.
.ELS
This was edit 1127 to LINK, PCO 10-LINK-250.
.!2.1.6
.HL 3 High segment code in overlays
LINK 4A does not allow any high segment code when loading into an overlay.
If it sees any, it will issue the new LNKHCL message. Previous
versions of LINK allowed this without complaint, but then proceeded to
generate a non-working EXE file. This is a common error, since it is
what happens if a COBOL program compiled with /R is loaded into an
overlay. This was edit 1115 to LINK, PCO 20-LINK-9.
.!2.1.7
.HL 3 /OTS:NONSHAR by default
In addition to the reasons listed on page D-39 of the LINK manual, LINK
version 4 assumed /OTS:NONSHAR if the low segment exceeded 256P in size
at the time system library searching started, since the OTS cannot be
read in at 400000 at runtime if the low segment extends beyond that
address. With LINK 4A, this check has been extended so that /OTS:NONSHAR
is assumed if the low segment extends beyond 330000. This allows for
the low segment to grow somewhat as a result of system library searching
without causing high segment overlap.
The principle result of this edit is that some large user programs may
now be loaded with the appropriate OTS built in, even though they were
built to bring in the OTS at runtime with previous versions of LINK. If
this is objectionable and the program's low segment does not extend beyond
400000, the /OTS:SHARE switch can be used to override the default action.
This was edit 1131 to LINK, PCO 10-LINK-252.
.PAGE
.!2.1.8
.HL 3 /NOINCLUDE, changes to /INCLUDE
There is a new switch, /NOINCLUDE. This switch turns off include mode set
by a previous /INCLUDE switch seen in a global context. Unlike /INCLUDE,
the new /NOINCLUDE switch takes no arguments.
The /INCLUDE switch has also been changed to always set include mode for
the rest of the line when it is seen in a global context. This change
restores the behavior of /INCLUDE from LINK 3A and earlier. The switch
was changed in LINK 4 to only set include mode for the rest of the line
if it was seen in a global context, and had no arguments.
This was edit 1117 to LINK, PCO 10-LINK-242.
.!2.1.9
.HL 3 CPU type conflict checking
The routines in LINK that process modules built for a certain type of
CPU (with /KA or /KI to FORTRAN, or .DIRECTIVE KA10, KI10, or KL10 to
MACRO) have been generalized to understand the KL10 declaration, and to
allow for future CPU types. As part of this change, the LNKKIA message as
been changed to the LNKCCD message, and the CPU types that the
loaded program will run on are now printed in the map. This was edit
1120 to LINK, PCO 10-LINK-243.
.!2.1.10
.HL 3 Change to /UPTO
The /UPTO_: switch will now take a global symbol as an argument. The symbol
does not need to be defined when the switch is typed, but must be defined
by the end of the load. If it is not, LINK will issue the new LNKUUA message
and ignore the switch. This was edit 1175 to LINK, PCO 10-LINK-286.
.!2.1.11
.HL 3 Size of overlay files
Due to a bug, LINK version 4 wrote overlay files that were considerably
larger than those written by LINK 3A. This bug has now been fixed, so
overlay files written by LINK 4A are comparable in size to those written
by LINK 3A. This was edit 1205 to LINK, PCO 10-LINK-294.
.!2.1.12
.HL 3 Generated module name
If any symbols are defined before a module has been loaded, LINK 4A will
start a module of the same name as the symbol. Previous versions of LINK
just dumped the symbol to the map and runtime symbol table with no preceeding
module name. If some module has already been loaded, LINK 4A will continue
to append the symbol to the last module loaded, just as previous versions of
LINK did. This mainly affects symbols defined with switches (/SET, /DEFINE),
and can only happen if /NOINITIAL is used, since the module JOBDAT is normally
loaded by default. This was edit 1143 to LINK, PCO 10-LINK-263.
.PAGE
.!2.1.13
.HL 3 Change to REL block type 24
With LINK 4A, REL block type 24 just declares a new psect. Under previous
versions of LINK, this REL block also took the actions of REL block type 22,
so that any following low segment code went in to the psect just declared.
This was edit 1137 to LINK, PCO 10-LINK-259.
.!2.1.14
.HL 3 _.JBEDV
LINK 4A contains a new JOBDAT symbol, .JBEDV. This symbol will be used in
future releases of TOPS-10 and TOPS-20 in exec mode only for communication
with EDDT and other indepenently-built exec routines. This was edit 1151
to LINK, PCO 10-LINK-267.
.!2.1.15
.HL 3 /SAVE/EXECUTE on TOPS-20
LINK 4A no longer leaves PA1050 in memory on /SAVE/EXECUTE. PA1050 is still
left in on /EXECUTE (this is a known problem). As part of this edit, several
of the messages generated during the final phase of LINK have been cleaned up,
and long forms of the messages have been added. This was edit 1144 to LINK,
PCO 20-LINK-11.
.!2.1.16
.HL 3 Global definitions of psect names
For each psect loaded, LINK will automatically generate a global
symbol with the same name as the psect name, and with the psect
origin as its value. With LINK 4A, the psect name will now be
suppressed to DDT typeout. This was edit 1157 to LINK, PCO 10-LINK-273.
.!2.1.17
.HL 3 Symbol Names as Switch Arguments
LINK now requires symbols typed as arguments to those switches that accept
symbol names to begin with a letter or special character. Previous versions
of LINK allowed the first character to be a digit. This was edit 1167 to
LINK, PCO 10-LINK-280.
.!2.1.18
.HL 3 Error Message Changes
Several of LINK's messages have changed as the result of an error message
cleanup project. The most noticeable difference is that most of LINK's
errors will now print the module and file being processed when the error
occurred, but there are many other minor changes. Most of LINK's messages
were affected by this edit in some way.
.PAGE
The file LNKMSG.MAN contains an updated version of the error message
portion of the LINK manual (Appendix B). We recommend using this file
instead of the LINK version 4 manual for documentation on LINK's messages,
since so many of them have changed since LINK 4 was released.
The error message cleanup was edit 1174 to LINK, PCO 10-LINK-285.
.!2.2
.HL 2 Changes to the overlay handler
The following sections contain summaries of all externally visible
changes that have been made to OVRLAY (the runtime overlay handler) since
version 4(37). Refer to the file OVRLAY.PCO for more information on
specific edits.
.!2.2.1
.HL 3 Changes to RUNOVL and REMOVL
The manual call subroutine REMOVL has been changed to only accept one
argument: the name (or number) of the top link to be removed. OVRLAY
will remove this link and all of its inferiors from memory. REMOVL has
also been changed to not allow the caller to remove itself, a check which
was documented but not implemented.
The manual call subroutine RUNOVL has been changed to allow the caller to
be overlaid. The documentation stated that this was legal, but OVRLAY did
not permit it.
These changes were edit 43 to OVRLAY, PCO 20-OVRLAY-5.
.!2.2.2
.HL 3 JSYS names changed
The JSYS names used in the TOPS-20 version of OVRLAY have been changed to
be the new name% form that will be present in release 4 of TOPS-20. This
change was made because JSYS names are global symbols, and the TIME and SIN
JSYSes in the overlay handler were conflicting with FORLIB subroutines of
the same name. This was edit 41 to OVRLAY, PCO 20-OVRLAY-3.
.!2.2.3
.HL 3 Symbol table pointer update
The TOPS-20 version of OVRLAY has been changed to keep DDT's symbol table
pointer (@770001) up to date whenever it brings in or removes a link and the
corresponding symbol table. Before this change was made, bringing in a link
would cause DDT to lose some or all of the program's symbol table. This was
edit 40 to OVRLAY, PCO 20-OVRLAY-2.
.!2.2.4
.HL 3 Overlay files in SFDs
The TOPS-10 version of the overlay handler will now attempt to obtain the
path in which to find the overlay file by issuing GETTAB UUOs, which can
return the entire path, including SFDs. If the necessary GETTABs are not
implemented, LINK will continue to use the path information left in the
ACs by the monitor. This was edit 46 to OVRLAY, PCO 10-OVRLAY-20.
.PAGE
.!3.0
.HL 1 KNOWN BUGS AND DEFICIENCIES
The following list includes all known problems with LINK as of 31-Jul-79.
The list is divided into two parts. The first is a list of those
bugs for which a solution is not currently known. These will
be fixed roughly in order of their importance, and the patches published
in the appropriate Software Dispatch. The second part is a list of those
problems for which there are no current plans to fix. These are restrictions
in the product.
.HL 2 Problems to be fixed in the near future
.LS
.le;When LINK cannot find an input file, it does not always clear typeahead
before asking the user to provide the correct file spec.
.le;LINK will leave PA1050 in memory on TOPS-20 if program execution is
requested. This happens on the @DEBUG or @EXECUTE commands, or on /EXECUTE
to LINK.
.LE;Loading TOPS-10 DDT.REL version 40(220) specifying /ONLY:HIGH
results in an illegal memory reference. This is indicative of
several problems with /ONLY.
.IF NOSHIP
The check of R.TWSG in the routine CHKSEG is incorrect.
.ENDIF NOSHIP
.LE;Erroneous LNKUGS messages sometimes result when using /ONLY.
.IF NOSHIP
This happens because LINK sometimes checks a RADIX-50 symbol as if it
were an address to determine the segment.
An example of this is building the Fortran compiler.
.ENDIF NOSHIP
.LE;/BACKSPACE does not skip over the file mark after backspacing
a magtape. This leaves the tape incorrectly positioned.
.le;The LNKIMM message does not increment .JBERR, nor does it use
LINK's internal message facility. Thus, it cannot cause a load
to fail if some included modules were missing, nor be controlled by the
usual LINK message switches.
.IF NOSHIP
.LE;/SET:.HIGH_. sometimes results in erroneous LNKRUM messages.
This happens because the switch routine destroys P1.
.ENDIF NOSHIP
.Le;The LNKDNS message has various problems. The offending switch
is not ignored if the message is fatal, nor does the message get printed
when it should.
.le;The handling of /DDEBUG:(MACRO,FORTRAN) is inconsistent.
.LE;The /NOENTRY_: switch assumes that the symbol specified is not
an inter-link entry point. If another link does reference this symbol
then the program being loaded will fail at runtime.
.LE;/USERLIB:(x,y,z) does not work.
.le;TTY:/MAP:NOW when loading an overlaid program does not work.
.IF NOSHIP
LINK should call in LNKOV2 in this case.
.ENDIF NOSHIP
.LE;/CPU:x is ignored. Also, it only takes a single CPU type
as its argument when it should take a set of allowed CPU types.
.le;The T.1 routine (and many others) uses P2 incorrectly. It
should be the last location desired, but is sometimes set up
as the first free instead. Common side effects are that location 777777
cannot always be loaded, or that LINK reads in too many pages from its
overflow files.
.le;LINK has some problems putting the .EXE file in the proper place.
If an ersatz device was specified to /SAVE, and LINK must
overflow the HC area to disk, then the .EXE file may
end up on the wrong path. Also, if /EXECUTE was specified,
then LINK looks only on the user's default path or connected
directory, in spite of any contrary specification to /SAVE.
.le;The LNKLNS message does not print a carriage-return
line-feed at the end of the line.
.LE;LINK does not accept commands on the monitor command line, as
.lm+5.b;_.R LINK (commands) or @LINK commands
.LM-5
.LE;/LINK when specified in a global context has problems.
.IF NOSHIP
The S.DEBG code from edit 730 should be reworked.
.ENDIF NOSHIP
.LE;/SET specified without an argument results in the LNKISN message.
.LE;The /NOREQUESTS_: switch does not accept the complete radix-50
character set.
.le;The /SEVERITY_: switch takes an octal argument, but should take
a decimal one to be consistent with /ERRORLEVEL_: and the LINK manual.
.le;Defining a common block with the name of .COMM_. does not result in
a definition of blank common.
.le;On TOPS-20, overlay plots are generally 2.54 times too large.
.IF NOSHIP
This arises because most TOPS-20 plotters think metric, but LINK still
thinks English.
.ENDIF NOSHIP
.IF NOSHIP
.LE;The LNKARL message is much too long. It and perhaps some others
should be cut up into several lines.
.ENDIF NOSHIP
.ELS
.PAGE
.HL 2 Problems for which no solution is currently planned.
.LS
.le;If code or data that contains fixups (external, Polish, inter-psect
references, etc.) is overwritten at load time, LINK can get an illegal
memory reference or go into a loop. This can happen if psects overlap,
or if LOC or RELOC statements are used incorrectly in a MACRO program.
This is a restriction.
.LE;Generation of a symbol file via /SYFILE_: requires that symbols
be loaded with the program. This is a restriction.
.le;LINK does not read SWITCH.INI on a LOAD-class command.
This is a SCAN restriction.
.le;On TOPS-20, logical names pointing to files do not work.
This is a restriction.
.ELS
.PAGE
.!4.0
.HL 1 INSTALLATION INSTRUCTIONS
.!4.1
.HL 2 TOPS-10
To install LINK version 4A on your system, copy the files LINK.EXE,
LNK???.EXE, and OVRLAY.REL from the distribution tape to SYS:, and then
copy the file LINK.HLP from the distribution tape to HLP:. Note that
all of LINK's EXE files must be on the same disk structure.
The batch control file LINK.CTL contains all necessary instructions to
assemble and load LINK, and to produce listings and storage maps. It will
normally have to be modified slightly to correspond to the installation
configuration.
.!4.2
.HL 2 TOPS-20
To install LINK version 4 on your system, copy the files LINK.EXE and
OVRLAY.REL from the distribution tape to SYS:, and then copy the file
LINK.HLP from the distribution tape to HLP:. This can be done by
mounting the tape labelled Distribution Tape on MTA0_:, then typing
the following commands:
.B 1;.NF;.NJ;.LM +5
R DUMPER
TAPE MTA0:
REWIND
DENSITY 1600-BPI
SKIP 2
RESTORE DSK*:<*>LINK.EXE (TO) SYS:*.*.-1, -
DSK*:<*>OVRLAY.REL (TO) SYS:*.*.-1, -
DSK*:<*>LINK.HLP (TO) HLP:*.*.-1
REWIND
.LM -5;.F;.J
To rebuild LINK from sources, mount the tape labelled Distribution Tape
on MTA0_:, then type the following commands:
.B 1;.NF;.NJ;.LM +5
R DUMPER
TAPE MTA0:
REWIND
DENSITY 1600-BPI
SKIP 3
RESTORE DSK*:<*>*.*.* (TO) <self>*.*.*
REWIND
CTRL/C
!At this point, you should TYPE LINK.CTL to see what it does.
SUBMIT LINK.CTL/TIME/RESTART
.F;.J;.LM -5
The batch control file LINK.CTL contains the procedures necessary to rebuild
LINK and OVRLAY from sources. It may have to be modified slightly to
run at your installation, so you should type it to see what it does
before typing the SUBMIT command above.
.PAGE
.!5.0
.HL 1 INTERNAL CHANGES
.!5.1
.HL 2 Changes to LINK
All changes made to LINK 4(765) to produce LINK 4A(1220) are summarized
below.
Refer to the file LINK.PCO for more detailed information on specific edits.
.B 2
.TS 9,17,25,33,41,49,57,65
.LITERAL
766 MCHC 17-MAR-78
Store correct KL code(offset calculated by JFFO) for inconsistancy
check of modules to come.
LNKLOD
767 MCHC 17-MAR-78
Clear AC P2(required size) when coing forced dump of LC area,
which returns through LNKCOR and will cause looping if
garbage is in it.
LNKOLD
770 MCHC 17-MAR-78
Add code to allow paging for the first time in routine to
output undefined symbols(especially if undefined symbol table
does not begin at end of a chunk of code.)
LNKXIT
771 MCHC 23-MAR-78
Fix bug in doing large( > 400000) pop loop in 2 chunks.
LNKCOR
772 MCHC 23-MAR-78
Edit 770 did not adjust start of symbol table that came after
the undefined symbol table.
If /SET:FOO:nnnnnn/SYMSEG:PSECT:FOO is used so that a psect
was created just for the symbol table, the following should
happen:
PAT..=nnnnnn
.JBUSY (117)/ -U,,PAT..+100
where U is the length of undefined symbol table
.JBSYM (116)/ -L,,PAR..+100+U
where L is the length of the symbol table
LNKXIT
773 JNG 30-Apr-78
Fix GSDLT in LNKXIT to not leave some area's UB
pointing beyond .JBREL if the GS area is already gone.
Routines: LNKXIT
774 JNG 30-Apr-78 SPR 10-25711
Fix bad calculation of UW in EXE file writer.
Routines: LNKXIT
775 DZN 1-May-78 SPR 20-11396
Make sure /DEBUG:FORTRAN loads the starting address of
FORDDT and not the user's program (unless explicit /START).
Routines: LNKWLD
776 DZN 4-May-78 SPR 10-23733
Fix address check and lost .JBVER when loading small programs
with /SAVE and no data in core-image pages 0 or 1.
Routines: LNKXIT
777 DZN 18-May-78 SPR 10-24008
Fix allocation of COMMON blocks when a COMMON block is first
referenced but not defined, then later defined. Also document
SY.RF as destroying P1-P4.
Routines: LNKOLD, LNKLOD
1000 to 1077 Reserved for Development.
1100 DZN 23-May-78 SPR 10-24042
Fix LNKMAP to correctly free the index blocks it uses for sorting,
to keep the integrity of the DY area.
Routines: LNKMAP
1101 JNG 29-May-78 SPR 10-23623
Fix LINK to correctly load indexed libraries that contain modules
which have no entry points and thus do not appear in the index
when indexed with MAKLIB.
Routines: LNKOLD,LNKLOD,LNKWLD,LNKLOW
1102 DZN 18-Jun-78 SPR 20-11085
Fix paging routines to detect moving a window past 512P. In this
case, make the end of the window set right at 512P.
Routines: LNKLOD
1103 DZN 19-Jun-78
See that the list of .REQUEST/.REQUIRE blocks is not freed twice,
to preserve the integrety of the DY area.
Routines: LNKLOD
1104 JNG 20-Jun-78
Fix address checks when dumping LC or HC area to disk. Remove
edit 750 in LH.DMP, so we will never try to shrink the current
area by more pages than the area has.
Routines: LNKCOR
1105 JNG 20-Jun-78
Fix edit 740 to not destroy an AC that held the input file's PPN.
This caused LINK to not be able to find a file when the user gave
an explicit path including SFDs.
Routines: LNKFIO
1106 JNG 27-Jun-78 QAR RDH
Update HL.S1 from RC.CV of the highest PSECT loaded at the end of
loading. This causes the EXE file generator to allocate all of
the pages that it should if the last PSECT ends with a BLOCK statement.
Routines: LNKLOD
1107 MCHC 3-Aug-78
Fix bug in .SETEX--routine to expand RC.TB and RC.NTB tables
in DY area by obtaining bigger spaces, copying the data from
the old tables, and freeing the old table spaces.
The bug was in address calculation in freeing one of the tables.
The code is re-arranged to do a DY.GET followed by DY.RET
then another DY.GET and DY.RET
LNKWLD
1110 MCHC 7-Aug-78
Type out the PSECT name as part of the error message when a
non-existent one is used with /SYMSEG in GETSST routine.
Don't clear the name from memory cell, loop back without restoring the
stack and treat this case as a default case.
LNKXIT
1111 MCHC 7-Aug-78
Fix LNKXIT core management bug introduced by edit 772.
LNKXIT
1112 JNG 15-Aug-78 SPR 10-25902
Fix one off bugs in map printing segment lengths in K/P and
words free.
Routines: LNKPAR, LNKMAP
1113 DZN 25-Aug-78 SPR 20-12001
Fix memory management problems when plotting the overlay
tree. See that LINK never shrinks back on TOPS-20 until final
placement of the loaded program. Add LNKPOT message to tell user
when LINK is plotting the overlay tree.
Routines: LNKCOR, LNKXIT, LNKPLT, LNKERR
1114 DZN 1-Sep-78 SPR 20-11999
Zero count of COBOL symbol words and ALGOL OWNs loaded when
done loading a module, so they don't get counted in subsequent
modules in the same file.
Routines: LNKOLD, LNKLOD
1115 DZN 2-Sep-78 SPR 20-11997
Add LNKHCL message to complain when loading high segment code
into a link other than the root in an overlaid program.
Routines: LNKERR, LNKOLD
1116 JNG 7-Sep-78
Put back part of the code removed by edit 716. Performance
improvements are only kosher as long as the code removed is
unneeded.
Routines: LNKLOD
1117 DZN 14-Sep-78
Make /INCLUDE:args also set include mode, as it did long ago.
But also add /NOINCLUDE to turn off include mode but not
delete the original args.
Routines: LNKPAR, LNKWLD
1120 DZN 22-Sep-78 SPR 10-26135
Fix CPU mismatch checks so that they work. Remove edit 766,
revamp all CPU check code to use a bit mask of valid CPUs,
delete the LNKKIA message and add LNKCCD, and change the
map to include the correct information. Also, make the map
show which CPUs the entire program can be run on.
Routines: LNKPAR, LNKERR, LNKOLD, LNKLOD, LNKINI, LNKMAP, LNKLOW
1121 JNG 4-Oct-78 QAR JMF
Fix LNKXIT bug so .JBSYM ptr won't include the undefined symbol
table. This was broken by edit 772.
Routines: LNKXIT
1122 DZN 5-Oct-78 SPR 10-26222
Remove edit 740, which attempted to use SCAN's /VERSION switch,
rather than LINK's. SCAN's switch is a file-specific switch, which
is not the way LINK wants it to work. However, still fix the original
problem (having to type /VERSION to 6 characters to work) by making
LINK's /VERSION switch unique to any abbreviation.
Routines: LNKPAR, LNKSCN, LNKWLD, LNKFIO
1123 DZN 10-Oct-78 SPR 10-26580
Use HRLI instead of HRL to load ENTER error flag.
Routines: LNKFIO
1124 DZN 11-Oct-78 SPR 10-26712
Edit 636 broke LINK's ability to be run execute-only. Fix
this by making the TTY log routine once more return into the
potentially execute-only high segment properly.
Routine: LNKINI
1125 JNG 1-Nov-78 SPR 10-26379
Don't try to run the high segment file on /SAVE/RUN (or /SAVE/DEBUG)
when generating an EXE file. This fixes ?nnnLHC.EXE not found when
the user types the above switches and the HC area has overflowed.
Routines: LNKXIT
1126 JNG 1-Nov-78 SPR 10-26433
If all 7.01 GETTABs to determine where we came from are not available,
use the contents of the ACs to do GETSEG UUOs.
Routines: LNKINI
1127 JNG 14-Nov-78 QAR DIB
Set up the module length for PAT.. in the runtime symbol table.
Routine: LNKXIT
1130 DZN 26-Jan-79 SPR 10-27212
Make LINK honor /MAXCOR correctly when a request for memory in a
pagable area is made. In this case, edit 650 made LINK count the
memory request toward the /MAXCOR value, even though the window
can simply be moved.
Routine: LNKCOR
1131 DZN 26-Jan-79 SPR 10-27123
Make LINK decide to load a non-sharable OTS if the low segment
has grown within 40 pages of the origin of the OTS high segment
rather than letting the low segment grow past it first.
Otherwise, the low segment may cross the beginning of the OTS
during the system library search when it is too late to fix it.
Routine: LNKLOD
1132 JNG 30-Jan-79 SPR 10-26576
Re-work EXE file writer to fix several problems, including:
. PSECTs above the high segment not written properly.
. Absolute code not loaded correctly.
. Bad EXE directory if loading overlays and small /SPACE switch.
. PSECT attributes not written into the EXE file.
. Page 1 written into page 0 if page 1 is lowest page containing code.
. Address checks when writing the EXE file.
. Bad EXE file if EXE directory is longer than two pages.
. ?LNKCNW or bad DDT symbol table when loading PSECTs.
Routines: LNKPAR, LNKINI, LNKLOD, LNKOLD, LNKWLD, LNKXIT.
1133 JNG 30-Jan-79 SPR 10-26576
Add a long message for the LNKSTL message.
Routine: LNKERR
1134 JNG 30-Jan-79 SPR 10-27024
Avoid address check in LNKXIT while writing EXE file if lowest
code loaded is between 2000 and 377777, but the program being
loaded is not so large that LINK needs to overflow to disk.
This edit is an extract of part of edit 1132.
Routines: LNKXIT
1135 DZN 31-Jan-79 SPR 10-26792
Force PG.SU to expand anyway if a request crosses a page boundary
and the window is not at least two pages long.
Routine: LNKLOD
1136 JNG 31-Jan-79 SPR 10-26518
Avoid IO to unassigned channel in LNKXIT while writing an EXE file
if segment ends on last word of a page and LINK is not paging to disk.
This edit is an extract of part of edit 1132.
Routine: LNKXIT
1137 JNG 1-Feb-79 SPR 20-12411
Don't change RC.CUR in T.24. Also set default PSECT name to left-
justified .LOW. (not right-justified) if name not given in block.
Routine: LNKOLD
1140 JNG 6-Feb-79 SPR 10-26410
Clear LSTSYM when a non-loaded local is encountered.
Routine: LNKOLD
1141 JNG 15-Feb-79 SPR 10-26290
Make the EXE file writer stop writing when it passes the size
of the user program, instead of writing the entire LC area.
This edit supercedes edit 1136 and is an extract of edit 1132.
Routine: LNKXIT
1142 JNG 16-Feb-79
Fix problems with multiple /SET:.HIGH.s introduced by edit 1132.
Routine: LNKWLD
1143 JNG 16-Feb-79 QAR CKS
Make sure symbols never get into the LS area before a module name.
If they try (/NOINITIAL/SET), dummy up a module name from the symbol.
Routine: LNKLOD
1144 DZN 16-Feb-79 SPR 20-12473
Clean up code to run the .EXE file so that PA1050 is not left in
memory on TOPS-20, and so that more of the final messages use .ERR.
instead of OUTSTRs.
Routines: LNKERR, LNKLOG, LNKLOW, LNKPAR, LNKWLD, LNKXIT
1145 DZN 22-Feb-79
Load local symbols and store symbol table pointers on TOPS-20 if
/DEBUG:DDT and leaving program in memory. Broken by edit 1144.
Routines: LNKXIT, LNKWLD
1146 DZN 8-Mar-79 SPR 10-26290
Change the 'Not enough core to load' message to 'Program too complex'.
Then cause more cases to force .EXE file generation (e.g., PSECTs above
high segment, gaps between PSECTS).
Routines: LNKPAR, LNKXIT, LNKERR
1147 JNG 12-Mar-79
Avoid bad EXE file if lowest location loaded is above 400000, LINK
is overflowing to disk, and lowest location loaded was not the first
location loaded (i.e., load was not monotonic).
Routine: LNKXIT
1150 DZN 14-Mar-79 SPR 10-27632
Make LOGINI in LNKINI.MAC use standard LKNFIO routines to set up the log
file, so that the default path of a log file is preserved over the
ENTER.
Routine: LNKINI
1151 JNG 29-Mar-79
Add the new Job Data Area location .JBEDV to the initial symbols.
Routine: LNKINI
1152 JNG 3-Apr-79
Get EXE file right when loading overlays. Broken by 1132.
Routines: LNKOV1, LNKXIT
1153 JNG 12-Apr-79 QAR JBD
Give LNKIPX message if a Define PSECT block (type 24) contains
an invalid PSECT index.
Routine: LNKOLD
1154 JNG 12-Apr-79 QAR JBD
Re-write T.23 to fix the following problems:
. Don't re-define the PSECT indices in terms of the order of block 23s.
. Don't require a name of zero in the first block 23.
. Don't do a set PSECT (block type 22) action on block type 23.
. Expect PSECT index instead of name in first word (name still works).
Routine: LNKOLD
1155 JNG 13-Apr-79 QAR JBD
Allow PSECT .HIGH. to be synonymous with TWOSEG.
Routines: LNKOLD, LNKWLD
1156 JNG 13-Apr-79 QAR JBD
Relocate the breaks in block type 5 with respect to .LOW.
every time, even if the current PSECT is not .LOW..
Routine: LNKOLD
1157 JNG 13-Apr-79 QAR DZN
Suppress the PSECT name global symbols to DDT typeout.
Routine: LNKWLD
1160 JNG 14-Apr-79 QAR TW/JMF
Don't put junk in runtime undefined symbol table for symbols
that are used in Polish blocks.
Routine: LNKXIT
1161 JNG 4-May-79 SPR 10-27727
Clean up Psect printout in map.
Routines: LNKSUB, LNKMAP.
1162 JNG 4-May-79 SPR 20-12825
Set up DDT's symbol table pointers on /DEBUG/SAVE. This edit is
an extract of edit 1144.
Routines: LNKXIT
1163 JNG 8-May-79 QAR DC
Never mark .HIGH. as relocatable, since we default its origin.
This was broken by edit 1155.
Routine: LNKWLD
1164 JNG 8-May-79 SPR 10-27598
Don't overwrite the first page of the FX area when writing a map
if the LS area is paging and the last piece of the area exactly
fits into the window.
Routine: LNKMAP
1165 DZN 15-May-79 SPR 10-27925
Zero LSTSYM whenever a call to SY.RLS says a symbol requested for symbol
table fixup was not the last symbol loaded. This prevents symbol fixup
requests from finding a long-obsolete symbol in LSTSYM that just happens
to match.
Routine:LNKLOD
1166 JNG 15-May-79
Don't allow PSECT indices in Polish blocks unless the first halfword
was the default PSECT index for the block.
Routine: LNKOLD.
1167 JNG 17-May-79 QAR 10-3081
Don't allow symbols typed as switch arguments to begin with digits.
Routines: LNKSCN
1170 JNG 23-May-79 SPR 10-27945, QAR 10-3070, 10-3087
Fix some memory management problems in LNKXIT when not writing an
EXE file.
Routine: LNKXIT
1171 JNG 30-May-79 QAR 10-3049
Fix edit 1146 to say LNKPCL even on TOPS-10 if it doesn't like
the PSECT attributes.
1172 JNG 5-Jun-79
Fix many memory management problems when writing a runtime symbol
table, especially when psects are involved.
Routines: LNKPAR, LNKINI, LNKOV1, LNKOV2, LNKWLD, LNKXIT
1173 JNG 10-Jun-79
Update RC.HL on /COMMON.
Routine: LNKWLD
1174 DZN 10-Jun-79 SPRs 20-12548, 20-12244, QAR 10-03199
Revamp all error messages.
. Label all messages with E$$xxx:: or Ennxxx:: so messages can be found
when debugging. E$$xxx should be the label of the .ERR. (or its
preceeding PUSH P,[channel]) that defines the .ERxxx text block.
Ennxxx should be the label of all other .ERR.s with the same assigned
mnemonic, with nn starting at 01.
. Include the module and file name in which an error was detected in all
applicable messages.
. Make .OERR. synonamous with OUTSTR for use in place of .ERR. when a
message must be printed with an OUTSTR, so that all such messages can
be found easily.
. Make the list of messages and long text in LNKERR and the actual
messages in LINK agree.
. Fix log device being a terminal other than the controlling one.
. Clean up the wording of all messages to be more consistent.
Routines: All
1175 JNG 12-Jun-79
Fix /START and /UPTO with symbols as arguments.
Routines: LNKLOD, LNKWLD, LNKERR
1176 JNG 12-Jun-79
Disallow /SYMSEG:PSECT:name with /OVERLAY.
Routine: LNKWLD
1177 JNG 12-Jun-79
Make /VERSION in global context not lose local switches.
Routines: LNKPAR, LNKWLD
1200 JNG 13-Jun-79
If loading reentrant FOROTS, search SYS:FORLIB/SEGMENT:LOW.
This is required for FOROTS version 6 and later.
Routine: LNKLOD
1201 JNG 13-Jun-79
Disallow /SEGMENT:PSECT, which worked because it used the same
keyword table as /SYMSEG.
Routines: LNKPAR, LNKLOD, LNKOV1, LNKOV2, LNKWLD
1202 JNG 14-Jun-79
Fix /VERSION after 1172, and make LINK assemble on TOPS-20
after edit 1174.
Routines: LNKPAR, LNKFIO, LNKLOG, LNKXIT.
1203 JNG 14-Jun-79
Add support for Extended FORTRAN.
Routines: LNKPAR, LNKMAP, LNKLOD, LNKERR
1204 JNG 14-Jun-79
Check for programs that extend beyond location 777777, and
issue the LNKPTL message.
Routines: LNKLOW, LNKOLD, LNKLOD, LNKERR
1205 JNG/DZN 14-Jun-79 SPR 10-27954
Re-claim some wasted blocks in .OVL files.
Routine: LNKOV1
1206 JNG 14-Jun-79
Fix a NO.COR in LNK999 that edit 1174 missed.
Routine: LNK999
1207 JNG 29-Jun-79
Make the LNKCMX message continue loading, so the user can run
the program if he wants to.
Routine: LNKLOD
1210 JNG 29-Jun-79
Allow 1-word block type 5's, so SAIL output will load. Also
allow a program break of exactly 1,,0 (bypass the LNKPBI check).
Routine: LNKOLD
1211 JNG 29-Jun-79 QAR 10-3303
Fix typo in LNKDRC message, avoid Illegal UUO. Broken by 1174.
Routine: LNKWLD
1212 DZN 4-Jun-79
Fix various typos and other loose ends in the aftermath of 1174.
1213 JNG 5-Jul-79
Eliminate the ISD message; on multiple partial definitions, just
ignore them if their values agree, and give the MDS message if
they don't.
Routines: LNKPAR, LNKOLD, LNKLOD, LNKERR
1214 DZN 9-Jul-79 QAR 10-03315
Fix mismatched angle brackets so PIP's /V switch doesn't complain.
Comments should not contain angle brackets unless they actually
terminate conditionals, repeats, etc.
Routines: LNKHST, LNKCOR, LNKOV1, LNKXIT
1215 JNG 23-Jul-79 QAR R.ACE
Use RC.HL for .ABS. and .LOW. for LOWLOC update at CHKLLC, since
RC.CV may not be correct. In particular, RC.CV for .ABS. is always
zero.
Routine: LNKLOD
1216 JNG 23-Jul-79 QAR CKS
Preserve P1/P2 in SYMOUT, avoid illegal memory reference if
undefined symbols exist.
Routine: LNKXIT
1217 DZN 25-Jul-79
Clean up the listings for release. Update all copyright notices.
Remove all editing lines. Break pages in good places.
Routines: All
1220 DZN 24-Aug-79
Release on both TOPS-10 and TOPS-20 as version 4A(1220).
Routines: All
.END LITERAL
.PAGE
.!5.2
.HL 2 Changes to OVRLAY
All changes made to OVRLAY 4(37) to produce OVRLAY 4A(50) are summarized
below.
Refer to the file OVRLAY.PCO for more detailed information on specific edits.
.B 2
.TS 9,17,25,33,41,49,57,65
.LITERAL
40 DZN 15-Sep-78
On TOPS-20, if DDT exists, set its internal symbol table pointer
whenever we change .JBSYM.
41 DZN 5-Oct-78
Use new NAME% form of JSYS names to avoid conflicts with user-defined
globals.
42 DZN 5-Oct-78
Change FTENEX conditional to TOPS20 to be consistent with the rest
of LINK. Use proper mnemonics for JSYS arguments. Some code cleanup.
43 DZN 13-Oct-78
Fix link deletion problems. Make REMOV. take only a single argument,
and delete that link and all of its inferiors (otherwise lost links
result). Allow RUNOV. to delete the calling link as documented. Also
remove OVLAOC message (use OVLARC instead).
44 DZN 15-Oct-78
Fix argument checking for calls to manual subroutines. This involves
allowing all double and single precision argument types to work,
making the OVLIAT message fatal and not type junk, and getting
the correct user PC (see edit 10).
45 DZN 15-Oct-78
Fix PDL overflow if many calls to RUNOV. RUNOV. now unbinds back
through the return PC on the stack, allowing replacement of links
at the same level to succeed without the PDL overflow.
46 JNG 15-Jun-79
Try GETTABs to determine the full path that we were run from on
TOPS-10.
47 DZN 25-Jul-79
Clean up the listing for release.
50 DZN 27-Aug-79
Release on both TOPS-10 and TOPS-20 as version 4A(50).
.END LITERAL
.PAGE
.!6.0
.HL 1 SUGGESTIONS
The following suggestion list has been accumulated from various sources,
including SPRs and DECUS sessions. The appearance of a suggestion on
this list does not necessarily mean that DIGITAL ever intends to implement
it.
.LS
.le;Search REL_: for system libraries if they cannot be found on SYS:.
.le;Print an informational message when searching a system library, giving
the number of undefined symbols remaining when the search starts.
.le;Implement relocatable psects.
.le;Support long symbols.
.le;Support a better symbol character set than RADIX-50.
.le;Support extended addressing.
.le;Load programs into another fork on TOPS-20.
.le;Modify LINK to be callable as a subroutine from other programs.
.le;Make LINK use the same message convention as SCAN. In particular,
make LINK recognize SCAN's /MESSAGE switch.
.le;Sort the symbols listed in LINK's map files.
.le;Use a better free memory algorithm. Currently, LINK uses a best-fit
method. This is known to be inferior, potentially slowing LINK down.
.IF NOSHIP
Another result is that many one-word blocks are always on the
front of the free memory list, making debugging of memory management
problems very painful.
.ENDIF NOSHIP
.LE;Use virtual memory more intelligently. In particular,
don't zero memory just allocated via CORE or PAGE_. UUOs, since
it is already zero.
.le;Redesign the structure of the title REL block (block
type 6) to allow easier upward compatibility of CPU types.
.le;Print appropriate error messages if conflicting or inappropriate
psect properties are detected, such as concatenate and overlay.
.le;Implement block type 11 code bits in the symbol store operator.
.le;Make overlaid psects and common blocks coexist. Other DIGITAL loaders
actually handle common blocks as overlaid psects. One advantage would be
that the largest common block declaration would not necessarily have to
be loaded first.
.LE;MACRO and LINK should use some facility (perhaps the proposed
REL block types 1042 and 1043) to allow full file specifications in
library requests embedded in .REL files. Such an implementation
should preferrably use text rather than SIXBIT fields as are now
used.
.le;Make the overlay plotter code able to write an LPT format
file to the disk. This would allow printing with non-default parameters,
for instance.
.le;Make the LNKUGS message print something more informative than
a 0 as the value of a polish expression.
.LE;Add KS10 to the CPU specifications allowed both in MACRO
and LINK.
.IF NOSHIP
.LE;DEBLNK (the multi-segment debugging version of TOPS-10 LINK) does
not work. There are some remaining MOVE ['LNKERR']s that should be
HRRI 'ERR's.
.le;The code implementing the /ESTIMATE and /MAXCOR switches
should be placed under off conditionals on TOPS-20, since
these switches only exist on TOPS-10.
.le;All references to RUNCOR should be removed, since the switch has
been removed.
.le;Add an initialization macro to all of LINK's sources that searches
all of the necessary universal files and does other setup. Currently,
it is very painful to add a new universal file to the list.
.le;LNK999 (the TOPS-10 emergency memory manager) appears broken. There
are problems when running LINK with small virtual limits. This might
be a TOPS-10 7.00/7.01 problem.
.le;The handling of block type 776 (symbol files) is very strange and needs
to be cleaned up.
.ENDIF NOSHIP
.ELS
.B 2
[End of LINK.DOC]