home *** CD-ROM | disk | FTP | other *** search
/ norge.freeshell.org (192.94.73.8) / 192.94.73.8.tar / 192.94.73.8 / pub / computers / pdp10 / tops-10 / link.hlp < prev    next >
Text File  |  1995-04-05  |  20KB  |  439 lines
  1. A LINK command  consists  of  a  list  of  file  names  with  associated
  2. switches,  terminated  by  the /GO switch.  A command may take up one or
  3. more lines.  LINK uses SCAN,  so  all  of  the  standard  SCAN  features
  4. (indirect files, line continuation, /RUN, /PROTECT, etc.) are available.
  5.  
  6.  
  7. Output files are requested by applying the appropriate switch to a  file
  8. name,  either  before  or  after  the  file  name.   An  equals sign may
  9. optionally be used to separate output file names from input file  names,
  10. but does not by itself designate an output file.
  11.  
  12.  
  13. The  following  examples  all  load  ONE.REL  and   TWO.REL,   producing
  14. TWELVE.EXE and TWELVE.MAP:
  15.  
  16.         1.      *TWELVE/SSAVE/MAP=ONE,TWO/GO
  17.  
  18.         2.      *ONE,TWO
  19.                 *TWELVE/SSAVE
  20.                 *TWELVE/MAP
  21.                 */GO
  22.  
  23.         3.      */MAP TWELVE=ONE
  24.                 *TWO
  25.                 *TWELVE/SSAVE/GO
  26.  
  27.  
  28. When using LINK's overlay facility, the command format is as follows:
  29.  
  30.                 */OVERLAY
  31.                 *file,file,file,file/LINK:ROOT
  32.                 */NODE:ROOT file,file,file/LINK:name
  33.                 */NODE:name file,file,file/LINK:name
  34.                  . . .
  35.                 */GO
  36.  
  37.  
  38. The following list summarizes LINK's switches and what they do:
  39.  
  40.  
  41. /ARSIZE:decimal          Used in  response  to  a  LNKTMA  message  when
  42.                          loading an overlaid program.
  43.  
  44. /BACKSPACE:decimal       Backspaces files on an input magtape.
  45.  
  46. /COMMON:name:decimal     Allocates a new common block.
  47.  
  48. /CONTENTS:keyword        Specifies what types of symbols  should  appear
  49.                          in the map file, if any.  
  50.                          Keywords:
  51.                          ALL                 [NO]ABSOLUTE
  52.                          [NO]COMMON          DEFAULT
  53.                          [NO]ENTRY           [NO]GLOBAL
  54.                          [NO]LOCALS          NONE
  55.                          [NO]RELOCATABLE     [NO]UNDEFINED
  56.                          [NO]ZERO
  57.  
  58. /CORE:decimal            Tells LINK to begin with the  specified  amount
  59.                          of  memory.   This can speed loading by cutting
  60.                          down LINK's memory management overhead.
  61.  
  62. /COUNTER                 Types PSECT origins and breaks.
  63.  
  64. /CPU:keyword             Requires that the program run on the named  CPU
  65.                          type.  
  66.                          Keywords:
  67.                          KA10      KI10      KL10                       KS10
  68.  
  69. /DDEBUG:keyword          Selects a default debugger for /DEBUG.
  70.                          Keywords:  
  71.                          ALGDDT    ALGOL     COBDDT
  72.                          COBOL     DDT       FAIL
  73.                          FORDDT    FORTRAN   MACRO
  74.                          SAIL      SDDT      SIMDDT
  75.                          SIMULA    PASCAL    PASDDT
  76.  
  77. /DEBUG:keyword           Loads a debugger and starts it executing.  This
  78.                          switch  also  turns  on /LOCALS and /SYMSEG:LOW
  79.                          for the remainder of the load.
  80.                          Keywords:
  81.                          ALGDDT    ALGOL     COBDDT
  82.                          COBOL     DDT       FAIL
  83.                          FORDDT    FORTRAN   MACRO
  84.                          SAIL      SDDT      SIMDDT
  85.                          SIMULA    PASCAL    PASDDT
  86.  
  87. /DEFAULT:keyword         Changes LINK's defaults for  missing  parts  of
  88.                          file  specs, or sets file specific switches for
  89.                          the remainder of the load.
  90.                          Keywords:
  91.                          INPUT     OUTPUT
  92.  
  93. /DEFINE:name:decimal     Defines a global symbol.
  94.  
  95. /ENTRY                   Types all entry points loaded so far.
  96.  
  97. /ERRORLEVEL:decimal      Allows typeout of messages with  message  level
  98.                          greater  than  or equal to the value specified.
  99.                          Setting this parameter to  less  than  10  will
  100.                          allow  you  to see some extra messages that are
  101.                          normally suppressed.
  102.  
  103. /ESTIMATE:decimal        Reserves the specified number  of  disk  blocks
  104.                          for the current output file.
  105.  
  106. /EXCLUDE:name            Prevents the named  module  from  being  loaded
  107.                          from the input file.
  108.  
  109. /EXECUTE                 Tells LINK to start the program  after  loading
  110.                          is completed.
  111.  
  112. /FRECOR:decimal          Maintains space between LINK's  internal  areas
  113.                          to  cut  down  on the amount of shuffling done.
  114.                          The default value is 1024.
  115.  
  116. /FOROTS                  Causes LINK to use the Fortran libraries if F40
  117.                          code is loaded.
  118.  
  119. /FORSE                   Causes LINK to use the  F40  libraries  if  F40
  120.                          code is loaded.
  121.  
  122. /GO                      Finish up at the end  of  the  current  command
  123.                          line instead of prompting for another line.
  124.  
  125. /HASHSIZE:decimal        Sets the mimimum size of LINK's  global  symbol
  126.                          hash  table,  to  cut  down  on  the  number of
  127.                          rehashes needed.  The default value is 251.
  128.  
  129. /HELP:arg                Types  a  help  file  for  LINK.   The   switch
  130.                          argument  is  optional.   The  SWITCHES keyword
  131.                          gives a  list  of  legal  switches.   The  TEXT
  132.                          keyword    gives   a   brief   description   of
  133.                          LINK-specific switches.
  134.  
  135. /INCLUDE:name            Loads the named module from the  current  file,
  136.                          and  tells  LINK to process the file in include
  137.                          mode, so that no other modules get loaded  from
  138.                          the  file  unless  they  are  needed to satisfy
  139.                          undefined globals and the current file is being
  140.                          loaded in library search mode.
  141.  
  142. /LIMIT:psect:address     If  the  PSECT  grows  beyond   the   specified
  143.                          address,  LINK will send a warning message, but
  144.                          will continue loading.
  145.  
  146. /LINK:name               Closes off the current overlay link  and  gives
  147.                          it the specified name.
  148.  
  149. /LOCALS                  Tells LINK to remember the local  symbols  from
  150.                          all  of the modules in the current file.  These
  151.                          are valuable if you want a  map  or  a  runtime
  152.                          symbol table.
  153.  
  154. /LOG                     Requests an output file containing a log of the
  155.                          loading process.
  156.  
  157. /LOGLEVEL:decimal        Like /ERRORLEVEL, but controls  which  messages
  158.                          get put into the log.
  159.  
  160. /MAP:keyword             Requests a map of the program being loaded.  
  161.                          Keywords:
  162.                          END       NOW       ERROR
  163.  
  164. /MAXCOR:decimal          Tells LINK not to expand its low segment larger
  165.                          than the specified amount during the load.
  166.  
  167. /MAXNODE:n               Specifies the number of  links  to  be  defined
  168.                          when  an  overlayed  program requires more than
  169.                          256 links.  This switch must be place after the
  170.                          /OVERLAY  switch  and  must  precede  the first
  171.                          /NODE switch.
  172.  
  173. /MISSING                 Types a list of modules requested by  a  global
  174.                          /INCLUDE that have not yet been seen.
  175.  
  176. /MTAPE:keyword           Performs a tape operation on the current  input
  177.                          or output magtape.
  178.                          Keywords:
  179.                          MTBLK     MTBSF     MTBSR
  180.                          MTDEC     MTEOF     MTEOT
  181.                          MTIND     MTREW     MTSKF
  182.                          MTSKR     MTUNL
  183.  
  184. /NEWPAGE:keyword         Rounds the specified segment  up  to  the  next
  185.                          page boundary.
  186.                          Keywords:
  187.                          LOW       HIGH
  188.  
  189. /NODE:linkid             Tells LINK that the overlay link you are  about
  190.                          to start loading will be a new son of the named
  191.                          link.  linkid may be either  the  name  or  the
  192.                          number of the node.
  193.  
  194. /NOENTRY:name            Tells  LINK  that  the  named  entry  into  the
  195.                          current  overlay  link  will  not be referenced
  196.                          from other links, thus saving some table  space
  197.                          at runtime.
  198.  
  199. /NOINCLUDE               Tells LINK not to process the current  file  in
  200.                          include  mode.  This means that the entire file
  201.                          will  be  loaded  unless  you  have   requested
  202.                          library search mode.
  203.  
  204. /NOINITIAL               Prevents loading LINK's internal  copy  of  the
  205.                          JOBDAT  symbols,  and requests a library search
  206.                          of SYS:JOBDAT.REL atthe end of loading if  any
  207.                          undefined globals remain.
  208.  
  209. /NOLOCAL                 Prevent LINK from remembering any local symbols
  210.                          from the current file.
  211.  
  212. /NOREQUESTS:name         Tells  LINK  that  the  named  symbol  that  is
  213.                          referenced  in  the  current  overlay  link but
  214.                          defined  in  other(s)  will  not  actually   be
  215.                          referenced  at runtime.  This saves table space
  216.                          at runtime.
  217.  
  218. /NOSEARCH                Turns off library search mode for  the  current
  219.                          file.
  220.  
  221. /NOSTART                 Tells LINK to ignore any start addresses in the
  222.                          current file.
  223.  
  224. /NOSYMBOL                Tells LINK that you will  not  need  the  local
  225.                          symbols  for  any  module  loaded.  If LINK has
  226.                          already saved some, it throws them away.
  227.  
  228. /NOSYSLIBRARY:keyword    Prevents the normal search of the named  system
  229.                          library at the end of loading.  
  230.                          Keywords:
  231.                          
  232.                          ADA       ANY       ALGOL
  233.                          BASIC     BCPL      BLISS
  234.                          BLS36     CBL74     CBL79
  235.                          COBOL     FAIL      FORTRAN
  236.                          JOVIAL    MACRO     MIDAS
  237.                          NELIAC    PL1       SAIL
  238.                          SIMULA    SITGO
  239.                          
  240.  
  241. /NOUSERLIBRARY:keyword   Takes the current file out of  LINK's  internal
  242.                          list of user libraries, as set by /USERLIBRARY.
  243.                          Keywords:
  244.                          
  245.                          ADA       ANY       ALGOL
  246.                          BASIC     BCPL      BLISS
  247.                          BLS36     CBL74     CBL79
  248.                          COBOL     FAIL      FORTRAN
  249.                          JOVIAL    MACRO     MIDAS
  250.                          NELIAC    PL1       SAIL
  251.                          SIMULA    SITGO
  252.                          
  253.  
  254. /ONLY:keyword            Loads only the named segment of modules in  the
  255.                          current file.  
  256.                          Keywords:
  257.                          HIGH      LOW       BOTH
  258.  
  259. /OTSEGMENT:keyword       Controls whether the runtime system  should  be
  260.                          loaded  by  LINK  or brought in at runtime from
  261.                          SYS: by the program itself.
  262.                          Keywords:
  263.                          SHARABLE  NONSHARABLE
  264.  
  265. /OVERLAY:keyword         Tells LINK that you wish  to  load  an  overlay
  266.                          structure, and names the .OVL and .EXE files if
  267.                          associated with a file name.  This switch  must
  268.                          appear before any .REL files have been loaded.
  269.                          Keywords:
  270.                          
  271.                          ABSOLUTE            [NO]LOGFILE
  272.                          RELOATABLE         [NO]WARNING
  273.                          WRITABLE
  274.                          
  275.  
  276. /PATCHSIZE:decimal       Controls the size of the  PAT..  area  that  is
  277.                          allocated   if   a   runtime  symbol  table  is
  278.                          requested.
  279.  
  280. /PLOT:keyword            Requests an output file containing a diagram of
  281.                          your overlay structure in a format suitable for
  282.                          output on a plotter.
  283.                          Keywords:
  284.                          INCHES:decimal
  285.                          LEAVES:decimal
  286.                          STEPS:decimal
  287.  
  288. /PLTTYP:keyword          Allows specification of the plot file format.
  289.                          Keywords:
  290.                          DEFAULT
  291.                          PLOTTER
  292.                          PRINTER
  293.  
  294. /PSCOMMON:psect:common   Cause  the  FORTRAN  common  having  the   name
  295.                          "common" to be loaded into the specified psect.
  296.                          If "common" is omitted, the "blank  common"  is
  297.                          assumed.   This switch must precede any attempt
  298.                          to load the  specified  common  and  must  also
  299.                          precede  use of the /COMMON switch in declaring
  300.                          the size of the common.
  301.  
  302. /REDIRECT:lpsect:hpsect  Causes LINK to load low segment code  into  the
  303.                          psect  "lpsect"  and high segment code into the
  304.                          psect "hpsect".  Either  "lpsect"  or  "hpsect"
  305.                          may   be  omitted,  and  the  second  colon  is
  306.                          optional if "highpsect" is omitted.
  307.  
  308. /REQUEST                 Types a list of unsatisfied external subroutine
  309.                          calls in the current overlay link.
  310.  
  311. /REQUIRE:name            Generates  a  global  request  for  the   named
  312.                          symbol.
  313.  
  314. /RESET:linkid            Equivalent   to   /NODE:linkid.     /NODE    is
  315.                          preferred.
  316.  
  317. /REWIND                  Rewinds the current input or output magtape.
  318.  
  319. /RUNAME:name             Sets the name of the program being loaded.
  320.  
  321. /SAVE                    Requests an output  .EXE  file  containing  the
  322.                          program  being  loaded.  Any high segment saved
  323.                          will be non-sharable.
  324.  
  325. /SEARCH                  Tells LINK to load selectively from the current
  326.                          file,  in  library  search  mode.  Only modules
  327.                          that  satisfy  undefined  global  symbols   are
  328.                          loaded.
  329.  
  330. /SEGMENT:keyword         Loads  low  and  high  segment  code  from  the
  331.                          current  file  into  the  named segment.  Psect
  332.                          code is not affected.
  333.                          Keywords:
  334.                          DEFAULT             LOW
  335.                          HIGH                NONE
  336.  
  337. /SEVERITY:decimal        Causes messages with severity greater  than  or
  338.                          equal  to  the  specified  value  to  be fatal,
  339.                          aborting the load.  Setting this parameter to 8
  340.                          will cause most warnings to become fatal.
  341.  
  342. /SET:name:octal          Sets the loading address of a  psect,  or  sets
  343.                          the .HIGH. or .LOW. relocation counter.
  344.  
  345. /SKIP:decimal            Skips the specified  number  of  files  on  the
  346.                          current input or output magtape.
  347.  
  348. /SPACE:decimal           Reserves the  specified  amount  of  space  for
  349.                          runtime buffers after the current overlay link.
  350.  
  351. /SSAVE                   Same as /SAVE, except  that  any  high  segment
  352.                          written will be sharable.
  353.  
  354. /START:address           Specifies the  start  address  for  the  loaded
  355.                          program,  and prevents replacement by any other
  356.                          start addresses found later.  The  address  may
  357.                          be a global symbol or an octal number.
  358.  
  359. /SYFILE:keyword          Tells LINK to  output  a  symbol  file  to  the
  360.                          current file, and sets /SYMSEG:DEFAULT.
  361.                          Keywords:
  362.                          ALGOL     RADIX50   TRIPLET
  363.  
  364. /SYMSEG:keyword          Places the symbol table  immediately  following
  365.                          the named segment or psect.  
  366.                          Keywords:
  367.                          DEFAULT             HIGH
  368.                          LOW                 NONE
  369.                          PSECT:name
  370.  
  371. /SYSLIBRARY:keyword      Explicitly  searches   one   or   more   system
  372.                          libraries.   LINK automatically searches system
  373.                          libraries at  the  end  of  the  load  or  each
  374.                          overlay link.  
  375.                          Keywords:
  376.                          
  377.                          ADA       ANY       ALGOL
  378.                          BASIC     BCPL      BLISS
  379.                          BLS36     CBL74     CBL79
  380.                          COBOL     FAIL      FORTRAN
  381.                          JOVIAL    MACRO     MIDAS
  382.                          NELIAC    PL1       SAIL
  383.                          SIMULA    SITGO
  384.                          
  385.  
  386. /TEST:keyword            Loads  a  debugger  but  does  not  start   its
  387.                          execution.   This  switch also turns on /LOCALS
  388.                          and /SYMSEG:LOW for the remainder of the  load.
  389.                          Keywords:
  390.                          ALGDDT    ALGOL     COBDDT
  391.                          COBOL     DDT       FAIL
  392.                          FORDDT    FORTRAN   MACRO
  393.                          SAIL      SDDT      SIMDDT
  394.                          SIMULA    PASCAL    PASDDT
  395.  
  396. /UNDEFINED               Types a list of global symbols that are not yet
  397.                          defined.
  398.  
  399. /UNLOAD                  Unloads the current input or output magtape.
  400.  
  401. /UPTO:address            Prevens te symbol table from growing past the
  402.                          specified address.  The address may be a global
  403.                          symbol or an octal number.
  404.  
  405. /USERLIBRARY:keyword     Tells LINK to search the  current  file  before
  406.                          searching   system   libraries.    The  keyword
  407.                          indicates that  the  given  library  is  to  be
  408.                          searched    only   if   a   module   from   the
  409.                          corresponding compiler was loaded.
  410.                          Keywords:
  411.                          
  412.                          ADA       ANY       ALGOL
  413.                          BASIC     BCPL      BLISS
  414.                          BLS36     CBL74     CBL79
  415.                          COBOL     FAIL      FORTRAN
  416.                          JOVIAL    MACRO     MIDAS
  417.                          NELIAC    PL1       SAIL
  418.                          SIMULA    SITGO
  419.                          
  420.  
  421. /VALUE:symbol            Types the name, value,an  attributes  of  the
  422.                          specified symbol.
  423.  
  424. /VERBOSITY:keyword       Tells LINK how much of each message to type.
  425.                          Keywords:
  426.                                    SHORT
  427.                                    MEDIUM
  428.                                    LONG
  429.  
  430. /VERSION:version         Sets the version of a file if specified for  an
  431.                          output  file, or for the program and all output
  432.                          files otherwise.
  433.  
  434. /ZERO                    Zeros the directory of  the  current  input  or
  435.                          output DECtape.
  436.  
  437. .KJOB
  438. .
  439.