Google
 

Trailing-Edge - PDP-10 Archives - KS10_APT_INSTALL_TAPE - subsys/link.hlp
There are 61 other files named link.hlp in the archive. Click here to see a list.
A command to LINK 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.


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.


The  following  examples  all  load  ONE.REL  and   TWO.REL,   producing
TWELVE.EXE and TWELVE.MAP:

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

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

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


When using LINK's overlay facility, the command format is as follows:

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


The following list summarizes LINK's switches and what they do:


/ARSIZE:decimal          Used in  response  to  a  LNKTMA  message  when
                         loading an overlaid program.

/BACKSPACE:decimal       Backspaces files on an input magtape.

/COMMON:name:decimal     Allocates a new common block.

/CONTENTS:keyword        Specifies what types of symbols  should  appear
                         in the map file, if any.  Keywords:
                         ALL                     [NO]ABSOLUTE
                         [NO]COMMON              DEFAULT
                         [NO]ENTRY               [NO]GLOBAL
                         [NO]LOCALS              NONE
                         [NO]RELOCATABLE         [NO]UNDEFINED
                         [NO]ZERO

/COUNTER                 Types psect origins and breaks.

/DDEBUG:keyword          Selects  a   default   debugger   for   /DEBUG.
                         Keywords:
                         COBDDT                  COBOL
                         DDT                     FAIL
                         FORDDT                  FORTRAN
                         MACRO                   SAIL
                         SDDT                    SIMDDT
                         SIMULA

/DEBUG:keyword           Loads a debugger and starts it executing.  This
                         switch  also  turns  on /LOCALS and /SYMSEG:LOW
                         for the remainder of the load.  Keywords:
                         COBDDT                  COBOL
                         DDT                     FAIL
                         FORDDT                  FORTRAN
                         MACRO                   SAIL
                         SDDT                    SIMDDT
                         SIMULA

/DEFAULT:keyword         Changes LINK's defaults for  missing  parts  of
                         file  specs, or sets file specific switches for
                         the remainder of the load.  Keywords:
                         INPUT                   OUTPUT

/DEFINE:name:decimal     Defines a global symbol.

/ENTRY                   Types all entry points loaded so far.

/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.

/EXCLUDE:name            Prevents the named  module  from  being  loaded
                         from the input file.

/EXECUTE                 Tells LINK to start the program  after  loading
                         is completed.

/FRECOR:decimal          Maintains space between LINK's  internal  areas
                         to  cut  down  on the amount of shuffling done.
                         The default value is 1024.

/GO                      Finish up at the end  of  the  current  command
                         line instead of prompting for another line.

/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.

/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.

/LINK:name               Closes off the current overlay link  and  gives
                         it the specified name.

/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  runtiime
                         symbol table.

/LOG                     Requests an output file containing a log of the
                         loading process.

/LOGLEVEL:decimal        Like /ERRORLEVEL, but controls  which  messages
                         get put into the log.

/MAP:keyword             Requests a map of  the  program  being  loaded.
                         Keywords:
                         END                     NOW

/MISSING                 Types a list of modules requested by  a  global
                         /INCLUDE that have not yet been seen.

/MTAPE:keyword           Performs a tape operation on the current  input
                         or output magtape.  Keywords:
                         MTBLK                   MTBSF
                         MTBSR                   MTDEC
                         MTEOF                   MTEOT
                         MTIND                   MTREW
                         MTSKF                   MTSKR
                         MTUNL

/NEWPAGE:keyword         Rounds the specified segment  up  to  the  next
                         page boundary.  Keywords:
                         LOW                     HIGH

/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.

/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.

/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.

/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.

/NOLOCAL                 Prevent LINK from remembering any local symbols
                         from the current file.

/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.

/NOSEARCH                Turns off library search mode for  the  current
                         file.

/NOSTART                 Tells LINK to ignore any start addresses in the
                         current file.

/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.

/NOSYSLIBRARY:keyword    Prevents the normal search of the named  system
                         library at the end of loading.  Keywords:
                         ANY                     ALGOL
                         BASIC                   BCPL
                         BLISS                   BLS36
                         CBL74                   CBL79
                         COBOL                   F40
                         FAIL                    FORTRAN
                         MACRO                   MIDAS
                         NELIAC                  PL1
                         SAIL                    SIMULA
                         SITGO

/NOUSERLIBRARY:keyword   Takes the current file out of  LINK's  internal
                         list of user libraries, as set by /USERLIBRARY.
                         Keywords:
                         ANY                     ALGOL
                         BASIC                   BCPL
                         BLISS                   BLS36
                         CBL74                   CBL79
                         COBOL                   F40
                         FAIL                    FORTRAN
                         MACRO                   MIDAS
                         NELIAC                  PL1
                         SAIL                    SIMULA
                         SITGO

/ONLY:keyword            Loads only the named segment of modules in  the
                         current file.  Keywords:
                         HIGH                    LOW
                         BOTH

/OTSEGMENT:keyword       Controls whether the runtime system  should  be
                         loaded  by  LINK  or brought in at runtime from
                         SYS: by the program itself.  Keywords:
                         SHARABLE                NONSHARABLE

/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.
                         Keywords:
                         ABSOLUTE                [NO]LOGFILE
                         RELOCATABLE             [NO]WARNING

/PATCHSIZE:decimal       Controls the size of the  PAT..  area  that  is
                         allocated   if   a   runtime  symbol  table  is
                         requested.

/PLOT:keyword            Requests an output file containing a diagram of
                         your overlay structure in a format suitable for
                         output on a plotter.  Keywords:
                         INCHES:decimal          LEAVES:decimal
                         STEPS:decimal

/REQUEST                 Types a list of unsatisfied external subroutine
                         calls in the current overlay link.

/REQUIRE:name            Generates  a  global  request  for  the   named
                         symbol.

/REWIND                  Rewinds the current input or output magtape.

/RUNAME:name             Sets the name of the program being loaded.

/SAVE                    Requests an output  .EXE  file  containing  the
                         program being loaded.

/SEARCH                  Tells LINK to load selectively from the current
                         file,  in  library  search  mode.  Only modules
                         that  satisfy  undefined  global  symbols   are
                         loaded.

/SEGMENT:keyword         Loads  low  and  high  segment  code  from  the
                         current  file  into  the  named segment.  Psect
                         code is not affected.  Keywords:
                         DEFAULT                 LOW
                         HIGH                    NONE

/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.

/SET:name:octal          Sets the loading address of a  psect,  or  sets
                         the .HIGH. or .LOW. relocation counter.

/SKIP:decimal            Skips the specified  number  of  files  on  the
                         current input or output magtape.

/SPACE:decimal           Reserves the  specified  amount  of  space  for
                         runtime buffers after the current overlay link.

/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.

/SYFILE:keyword          Tells LINK to  output  a  symbol  file  to  the
                         current   file,   and   sets   /SYMSEG:DEFAULT.
                         Keywords:
                         ALGOL                   RADIX50

/SYMSEG:keyword          Places the symbol table  immediately  following
                         the named segment or psect.  Keywords:
                         DEFAULT                 HIGH
                         LOW                     NONE
                         PSECT:name

/SYSLIBRARY:keyword      Explictly   searches   one   or   more   system
                         libraries.   LINK automatically searches system
                         libraries at  the  end  of  the  load  or  each
                         overlay link.  Keywords:
                         ANY                     ALGOL
                         BASIC                   BCPL
                         BLISS                   BLS36
                         CBL74                   CBL79
                         COBOL                   F40
                         FAIL                    FORTRAN
                         MACRO                   MIDAS
                         NELIAC                  PL1
                         SAIL                    SIMULA
                         SITGO

/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.
                         Keywords:
                         COBDDT                  COBOL
                         DDT                     FAIL
                         FORDDT                  FORTRAN
                         MACRO                   SAIL
                         SDDT                    SIMDDT
                         SIMULA

/UNDEFINED               Types a list of global symbols that are not yet
                         defined.

/UNLOAD                  Unloads the current input or output magtape.

/UPTO:address            Prevents the symbol table from growing past the
                         specified address.  The address may be a global
                         symbol or an octal number.

/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.  Keywords:
                         ANY                     ALGOL
                         BASIC                   BCPL
                         BLISS                   BLS36
                         CBL74                   CBL79
                         COBOL                   F40
                         FAIL                    FORTRAN
                         MACRO                   MIDAS
                         NELIAC                  PL1
                         SAIL                    SIMULA
                         SITGO

/VALUE:symbol            Types the name, value, and  attributes  of  the
                         specified symbol.

/VERBOSITY:keyword       Tells LINK how much of each  message  to  type.
                         Keywords:
                         SHORT                   MEDIUM
                         LONG

/VERSION:version         Sets the version of a file if specified for  an
                         output  file, or for the program and all output
                         files otherwise.