Google
 

Trailing-Edge - PDP-10 Archives - bb-kl11l-bm_tops20_v7_0_tsu03_2_of_3 - t20sub/link.hlp
There are 61 other files named link.hlp in the archive. Click here to see a list.
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.


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/SAVE/MAP=ONE,TWO/GO

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

        3.      */MAP TWELVE=ONE
                *TWO
                *TWELVE/SAVE/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.

/CPU:keyword             Requires that the program run on the named  CPU
                         type.
                         Keywords:
                         KA10      KI10      KL10      KS10

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

/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:
                         ALGDDT    ALGOL     COBDDT
                         COBOL     DDT       FAIL
                         FORDDT    FORTRAN   MACRO
                         SAIL      SDDT      SIMDDT
                         SIMULA    PASCAL    PASDDT

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

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

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

/LIMIT:psect:address     If  the  PSECT  grows  beyond   the   specified
                         address,  LINK will send a warning message, but
                         will continue loading.

/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  runtime
                         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       ERROR

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

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

/NOJOBDAT                Prevents  LINK  from  building  a   JOBDAT   or
                         vestigial JOBDAT area.

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

                         ADA       ANY       ALGOL
                         BASIC     BCPL      BLISS
                         BLS36     CBL74     CBL79
                         COBOL     FAIL      FORTRAN
                         JOVIAL    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:

                         ADA       ANY       ALGOL
                         BASIC     BCPL      BLISS
                         BLS36     CBL74     CBL79
                         COBOL     FAIL      FORTRAN
                         JOVIAL    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
                         WRITABLE


/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

/PLTTYP:keyword          Allows specification of the plot file format.
                         Keywords:
                         DEFAULT
                         PLOTTER
                         PRINTER

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

/PVBLOCK:keyword         Requests a program data  vector  and  specifies
                         where the vector goes.
                         Keywords:
                         DEFAULT             HIGH
                         LOW                 NONE
                         PSECT:name

/PVDATA:keyword:value    Changes the contents of a program  data  vector
                         specified with the /PVBLOCK switch.
                         Keywords:

                         CBLOCK     EXPORT
                         NAME       MEMORY
                         PROGRAM    VERSION

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

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

/SSAVE                   Same as /SAVE.

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

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

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

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

/SYSLIBRARY:keyword      Explicitly  searches   one   or   more   system
                         libraries.   LINK automatically searches system
                         libraries at  the  end  of  the  load  or  each
                         overlay link.
                         Keywords:

                         ADA       ANY       ALGOL
                         BASIC     BCPL      BLISS
                         BLS36     CBL74     CBL79
                         COBOL     FAIL      FORTRAN
                         JOVIAL    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:
                         ALGDDT    ALGOL     COBDDT
                         COBOL     DDT       FAIL
                         FORDDT    FORTRAN   MACRO
                         SAIL      SDDT      SIMDDT
                         SIMULA    PASCAL    PASDDT

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

                         ADA       ANY       ALGOL
                         BASIC     BCPL      BLISS
                         BLS36     CBL74     CBL79
                         COBOL     FAIL      FORTRAN
                         JOVIAL    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.