Google
 

Trailing-Edge - PDP-10 Archives - BB-BT99U-BB_1990 - 10,7/link/link.rnh
There are 12 other files named link.rnh in the archive. Click here to see a list.
.;COPYRIGHT (c) DIGITAL EQUIPMENT CORPORATION 1984,1988. ALL RIGHTS RESERVED.

.COMMENT PAH 11/6/84 Corrected [NO]USERLIB and [NO]SYSLIB keywords
.COMMENT             Also put /CPU back in the list.
.VARIABLE OK _  O
.VARIABLE TEN 1 _ 
.VARIABLE TWENTY 2 _ 
.nap
.IFNOT OK
.NT
This file contains conditionals to generate either the TOPS-10
or the TOPS-20 version of the LINK help file. To get the TOPS-10 version,
specify /VARIANT:(OK,TEN) to RUNOFF. To get the TOPS-20 version,
specify /VARIANT:(OK,TWENTY).
.B 2
.END NOTE
.ENDIF OK
A LINK command consists of a list of file names with associated
switches, terminated by the /GO switch.  A command may take up one or more
lines.  LINK uses SCAN, so all of the standard SCAN features (indirect
files, line continuation, /RUN, /PROTECT, etc.) are available.
.b 2
Output files are requested by applying the appropriate switch to a file
name, either before or after the file name.  An equals sign may optionally
be used to separate output file names from input file names, but
does not by itself designate an output file.
.b 2
The following examples all load ONE.REL and TWO.REL, producing TWELVE.EXE
and TWELVE.MAP:
.literal

	1.	*TWELVE/SAVE/MAP=ONE,TWO/GO

	2.	*ONE,TWO
		*TWELVE/SAVE
		*TWELVE/MAP
		*/GO

	3.	*/MAP TWELVE=ONE
		*TWO
		*TWELVE/SAVE/GO


.END LITERAL
When using LINK's overlay facility, the command format is as follows:
.literal

		*/OVERLAY
		*file,file,file,file/LINK:ROOT
		*/NODE:ROOT file,file,file/LINK:name
		*/NODE:name file,file,file/LINK:name
		 . . .
		*/GO


.end literal
The following list summarizes LINK's switches and what they do:
.b;.lm 25;.ts 25,49,71
.B;.I-25;/ARSIZE:decimal	Used in response to a LNKTMA message
when loading an overlaid program.
.B;.I-25;/BACKSPACE:decimal	Backspaces files on an input magtape.
.B;.I-25;/COMMON:name:decimal	Allocates a new common block.
.B;.I-25;/CONTENTS:keyword	Specifies what types of symbols should appear in
the map file, if any.  
.br
Keywords:
.ts 15,35,45
.lit
ALL		[NO]ABSOLUTE
[NO]COMMON	DEFAULT
[NO]ENTRY		[NO]GLOBAL
[NO]LOCALS	NONE
[NO]RELOCATABLE	[NO]UNDEFINED
[NO]ZERO
.end lit
.ts 25,49,71
.IF TEN
.B
.I-25
/CORE:decimal	Tells LINK to begin with the specified amount of
memory. This can speed loading by cutting down LINK's memory
management overhead.
.ENDIF TEN
.B
.I-25
/COUNTER	Types PSECT origins and breaks.
.COMMENT [PAH] .IF TEN
.bb
.B
.I-25
/CPU:keyword	Requires that the program run on the named CPU type. 
.br
Keywords:
.ts 15,35,45,55
.lit
KA10	KI10	KL10	KS10
.END LIT
.eb
.COMMENT [PAH].ENDIF TEN
.ts 25,49,71
.B
.I-25
/DDEBUG:keyword	Selects a default debugger for /DEBUG.
.br
Keywords: 
.ts 15,35,45
.LIT
ALGDDT	ALGOL	COBDDT
COBOL	DDT	FAIL
FORDDT	FORTRAN	MACRO
SAIL	SDDT	SIMDDT
SIMULA	PASCAL	PASDDT
.END LIT
.ts 25,49,71
.B
.I-25
/DEBUG:keyword	Loads a debugger and starts it executing.  This switch
also turns on /LOCALS and /SYMSEG:LOW for the remainder of the load.
.br
Keywords:
.ts 15,35,45
.LIT
ALGDDT	ALGOL	COBDDT
COBOL	DDT	FAIL
FORDDT	FORTRAN	MACRO
SAIL	SDDT	SIMDDT
SIMULA	PASCAL	PASDDT
.END LIT
.ts 25,49,71
.B
.I-25
/DEFAULT:keyword	Changes LINK's defaults for missing parts of
file specs, or sets file specific switches for the remainder of the
load.
.br
Keywords:
.ts 15,35,45
.LIT
INPUT	OUTPUT
.END LIT
.ts 25,49,71
.B
.I-25
/DEFINE:name:decimal	Defines a global symbol.
.B
.I-25
/ENTRY	Types all entry points loaded so far.
.B
.I-25
/ERRORLEVEL:decimal	Allows typeout of messages with message level
greater than or equal to the value specified.  Setting this parameter
to less than 10 will allow you to see some extra messages that are
normally suppressed.
.IF TEN
.B
.I-25
/ESTIMATE:decimal	Reserves the specified number of disk blocks
for the current output file.
.ENDIF TEN
.B
.I-25
/EXCLUDE:name	Prevents the named module from being loaded from the
input file.
.B
.I-25
/EXECUTE	Tells LINK to start the program after loading is completed.
.B
.I-25
/FRECOR:decimal	Maintains space between LINK's internal areas to
cut down on the amount of shuffling done.  The default value is 1024.
.IF TEN
.B
.I-25
/FOROTS	Causes LINK to use the Fortran libraries if F40 code is
loaded.
.B
.I-25
/FORSE	Causes LINK to use the F40 libraries if F40 code is loaded.
.ENDIF TEN
.B
.I-25
/GO	Finish up at the end of the current command line instead of
prompting for another line.
.B
.I-25
/HASHSIZE:decimal	Sets the mimimum size of LINK's global symbol hash
table, to cut down on the number of rehashes needed.  The default value is
251.
.B
.I-25
/HELP:arg	Types a help file for LINK.  The switch argument is 
optional.   The SWITCHES keyword gives a list of legal switches. 
The TEXT keyword gives a brief description of LINK-specific switches.
.B
.I-25
/INCLUDE:name	Loads the named module from the current file, and
tells LINK to process the file in include mode, so that no other
modules get loaded from the file unless they are needed to satisfy
undefined globals and the current file is being loaded in library
search mode.
.b
.i-25
/LIMIT:psect:address	If the PSECT grows beyond the specified
address, LINK will send a warning message, but will continue loading.
.B
.I-25
/LINK:name	Closes off the current overlay link and gives it the
specified name.
.B
.I-25
/LOCALS	Tells LINK to remember the local symbols from all of the
modules in the current file.  These are valuable if you want a map or
a runtime symbol table.
.B
.I-25
/LOG	Requests an output file containing a log of the loading process.
.B
.I-25
/LOGLEVEL:decimal	Like /ERRORLEVEL, but controls which messages
get put into the log.
.B
.I-25
/MAP:keyword	Requests a map of the program being loaded.  
.br
Keywords:
.ts 15,35,45
.LIT
END	NOW	ERROR
.END LIT
.ts 25,49,71
.IF TEN
.B
.I-25
/MAXCOR:decimal	Tells LINK not to expand its low segment larger than
the specified amount during the load.
.ENDIF TEN
.b
.i-25
/MAXNODE:n	Specifies the number of links to be defined when an
overlayed program requires more than 256 links.  This switch must be
place after the /OVERLAY switch and must precede the first /NODE
switch.
.B
.I-25
/MISSING	Types a list of modules requested by a global /INCLUDE
that have not yet been seen.
.B
.I-25
/MTAPE:keyword	Performs a tape operation on the current input or
output magtape.
.br
Keywords:
.ts 15,35,45
.LIT
MTBLK	MTBSF	MTBSR
MTDEC	MTEOF	MTEOT
MTIND	MTREW	MTSKF
MTSKR	MTUNL
.END LIT
.ts 25,49,71
.B
.I-25
/NEWPAGE:keyword	Rounds the specified segment up to the next
page boundary.
.br
Keywords:
.ts 15,35,45
.LIT
LOW	HIGH
.END LIT
.ts 25,49,71
.B
.I-25
/NODE:linkid	Tells LINK that the overlay link you are about to
start loading will be a new son of the named link.  linkid may be
either the name or the number of the node.
.B
.I-25
/NOENTRY:name	Tells LINK that the named entry into the current
overlay link will not be referenced from other links, thus saving some
table space at runtime.
.B
.I-25
/NOINCLUDE	Tells LINK not to process the current file in include
mode.  This means that the entire file will be loaded unless you have
requested library search mode.
.B
.I-25
/NOINITIAL	Prevents loading LINK's internal copy of the JOBDAT
symbols, and requests a library search of SYS:JOBDAT.REL at the end of
loading if any undefined globals remain.
.IFN TEN
.B
.I-25
/NOJOBDAT	Prevents LINK from building a JOBDAT or vestigial JOBDAT area.
.ENDIF TEN
.B
.I-25
/NOLOCAL	Prevent LINK from remembering any local symbols from
the current file.
.B
.I-25
/NOREQUESTS:name	Tells LINK that the named symbol that is
referenced in the current overlay link but defined in other(s) will
not actually be referenced at runtime.  This saves table space at
runtime.
.B
.I-25
/NOSEARCH	Turns off library search mode for the current file.
.B
.I-25
/NOSTART	Tells LINK to ignore any start addresses in the current file.
.B
.I-25
/NOSYMBOL	Tells LINK that you will not need the local symbols
for any module loaded.  If LINK has already saved some, it throws them
away.
.B
.I-25
/NOSYSLIBRARY:keyword	Prevents the normal search of the named system library
at the end of loading.  
.br
Keywords:
.ts 15,35,45
.bb
.LIT

ADA	ANY	ALGOL
BASIC	BCPL	BLISS
BLS36	CBL74	CBL79
COBOL	FAIL	FORTRAN
JOVIAL	MACRO	MIDAS
NELIAC	PL1	SAIL
SIMULA	SITGO

.END LIT
.eb
.ts 25,49,71
.B
.I-25
/NOUSERLIBRARY:keyword	Takes the current file out of LINK's internal
list of user libraries, as set by /USERLIBRARY.
.br
Keywords:
.ts 15,35,45
.bb
.LIT

ADA	ANY	ALGOL
BASIC	BCPL	BLISS
BLS36	CBL74	CBL79
COBOL	FAIL	FORTRAN
JOVIAL	MACRO	MIDAS
NELIAC	PL1	SAIL
SIMULA	SITGO

.END LIT
.eb
.ts 25,49,71
.B
.I-25
/ONLY:keyword	Loads only the named segment of modules in the current
file.  
.br
Keywords:
.ts 15,35,45
.LIT
HIGH	LOW	BOTH
.END LIT
.ts 25,49,71
.B
.I-25
/OTSEGMENT:keyword	Controls whether the runtime system should be
loaded by LINK or brought in at runtime from SYS_: by the program
itself.
.br
Keywords:
.ts 15,35,45
.LIT
SHARABLE	NONSHARABLE
.END LIT
.ts 25,49,71
.B
.I-25
/OVERLAY:keyword	Tells LINK that you wish to load an overlay
structure, and names the .OVL and .EXE files if associated with a file
name.  This switch must appear before any .REL files have been loaded.
.br
Keywords:
.ts 15,35,45
.LIT

ABSOLUTE		[NO]LOGFILE
RELOCATABLE	[NO]WARNING
WRITABLE

.END LIT
.ts 25,49,71
.B
.I-25
/PATCHSIZE:decimal	Controls the size of the PAT._. area that is
allocated if a runtime symbol table is requested.
.B
.I-25
/PLOT:keyword	Requests an output file containing a diagram of your
overlay structure in a format suitable for output on a plotter.
.br
Keywords:
.ts 15,35,45
.LIT
INCHES:decimal
LEAVES:decimal
STEPS:decimal
.END LIT
.ts 25,49,71
.B
.I-25
/PLTTYP:keyword	Allows specification of the plot file format.
.br
Keywords:
.ts 15,35,45
.LIT
DEFAULT
PLOTTER
PRINTER
.END LIT
.ts 25,49,71
.b
.i-25
/PSCOMMON:psect:common	Cause the FORTRAN common having the name "common"
to be loaded into the specified psect.  If "common" is omitted, the "blank 
common" is assumed.  This switch must precede any attempt to load the specified
common and must also precede use of the /COMMON switch in declaring the size of
the common.
.ts 25,49,71
.ifn ten
.b
.i-25

/PVBLOCK:keyword	Requests a program data vector and specifies
where the vector goes.
.br
Keywords:
.ts 15,35,45
.LIT
DEFAULT		HIGH
LOW		NONE
PSECT:name
.END LIT
.ts 25,49,71
.b
.i-25
/PVDATA:keyword:value	Changes the contents of a program data vector
specified with the /PVBLOCK switch.
.br
Keywords:
.b1
.ts 15,27,36
.lit
CBLOCK	EXPORT
NAME	MEMORY
PROGRAM	VERSION
.end lit
.endif ten
.ts 25,49,71
.B;.I-25;/REDIRECT:lpsect:hpsect	Causes LINK to load low segment code
into the psect "lpsect" and high segment code into the psect "hpsect".  
Either "lpsect" or "hpsect" may be omitted, and the second colon is 
optional if "highpsect" is omitted.
.ts 25,49,71
.B;.I-25;/REQUEST	Types a list of unsatisfied external subroutine calls in the
current overlay link.
.B;.I-25;/REQUIRE:name	Generates a global request for the named symbol.
.IF TEN
.B;.I-25;/RESET:linkid	Equivalent to /NODE:linkid. /NODE is preferred.
.ENDIF TEN
.B;.I-25;/REWIND	Rewinds the current input or output magtape.
.B;.I-25;/RUNAME:name	Sets the name of the program being loaded.
.B;.I-25;/SAVE	Requests an output .EXE file containing the program being
loaded.
.IF TEN
Any high segment saved will be non-sharable.
.ENDIF TEN
.B;.I-25;/SEARCH	Tells LINK to load selectively from the current file, in library search mode.
Only modules that satisfy undefined global symbols are loaded.
.B;.I-25;/SEGMENT:keyword	Loads low and high segment code from the current file into the named segment.
Psect code is not affected.
.br
Keywords:
.ts 15,35,45
.LIT
DEFAULT		LOW
HIGH		NONE
.END LIT
.ts 25,49,71
.B;.I-25;/SEVERITY:decimal	Causes messages with severity greater than or
equal to the specified value to be fatal, aborting the load. Setting this
parameter to 8 will cause most warnings to become fatal.
.B;.I-25;/SET:name:octal	Sets the loading address of a psect, or sets the
_.HIGH_. or .LOW_. relocation counter.
.B;.I-25;/SKIP:decimal	Skips the specified number of files on the current
input or output magtape.
.B;.I-25;/SPACE:decimal	Reserves the specified amount of space for runtime
buffers after the current overlay link.
.IF TEN
.B;.I-25;/SSAVE	Same as /SAVE, except that any high segment written will be
sharable.
.ENDIF TEN
.IF TWENTY
.B;.I-25;/SSAVE	Same as /SAVE.
.ENDIF TWENTY
.B;.I-25;/START:address	Specifies the start address for the loaded program,
and prevents replacement by any other start addresses found later. The address
may be a global symbol or an octal number.
.B;.I-25;/SUPPRESS:symbol	Used to suppress a previously defined global symbol.  If the symbol is unknown, this switch has no effect.  Use this switch if a global symbol is defined in two modules and you wish to suppress one of the definitions.
.B;.I-25;/SYFILE:keyword	Tells LINK to output a symbol file to the current file, and sets /SYMSEG:DEFAULT.
.br
Keywords:
.ts 15,35,45
.LIT
ALGOL	RADIX50	TRIPLET
.END LIT
.ts 25,49,71
.B;.I-25;/SYMSEG:keyword	Places the symbol table immediately following
the named segment or psect. 
.br
Keywords:
.ts 15,35,45
.LIT
DEFAULT		HIGH
LOW		NONE
PSECT:name
.END LIT
.ts 25,49,71
.B;.I-25;/SYSLIBRARY:keyword	Explicitly searches one or more system
libraries. LINK automatically searches system libraries at the end of the
load or each overlay link. 
.br
Keywords:
.ts 15,35,45
.bb
.LIT

ADA	ANY	ALGOL
BASIC	BCPL	BLISS
BLS36	CBL74	CBL79
COBOL	FAIL	FORTRAN
JOVIAL	MACRO	MIDAS
NELIAC	PL1	SAIL
SIMULA	SITGO

.END LIT
.eb
.ts 25,49,71
.B;.I-25;/TEST:keyword	Loads a debugger but does not start its execution.
This switch also turns on /LOCALS and /SYMSEG:LOW for the remainder of the load. 
.br
Keywords:
.ts 15,35,45
.LIT
ALGDDT	ALGOL	COBDDT
COBOL	DDT	FAIL
FORDDT	FORTRAN	MACRO
SAIL	SDDT	SIMDDT
SIMULA	PASCAL	PASDDT
.END LIT
.ts 25,49,71
.B;.I-25;/UNDEFINED	Types a list of global symbols that are not yet defined.
.B;.I-25;/UNLOAD	Unloads the current input or output magtape.
.B;.I-25;/UPTO:address	Prevents the symbol table from growing past the specified
address. The address may be a global symbol or an octal number.
.B;.I-25;/USERLIBRARY:keyword	Tells LINK to search the current file before
searching system libraries. The keyword indicates that the given library
is to be searched only if a module from the corresponding compiler was loaded.
.br
Keywords:
.ts 15,35,45
.bb
.LIT

ADA	ANY	ALGOL
BASIC	BCPL	BLISS
BLS36	CBL74	CBL79
COBOL	FAIL	FORTRAN
JOVIAL	MACRO	MIDAS
NELIAC	PL1	SAIL
SIMULA	SITGO

.END LIT
.eb
.ts 25,49,71
.B;.I-25;/VALUE:symbol	Types the name, value, and attributes of the specified
symbol.
.B;.I-25;/VERBOSITY:keyword	Tells LINK how much of each message to type.
.br
Keywords:
.ts 15,35,45
.br
	SHORT
.br
	MEDIUM
.br
	LONG
.ts 25,49,71
.B;.I-25;/VERSION:version	Sets the version of a file if specified for
an output file, or for the program and all output files otherwise.
.IF TEN
.B;.I-25;/ZERO	Zeros the directory of the current input or output DECtape.
.ENDIF TEN