Google
 

Trailing-Edge - PDP-10 Archives - FORTRAN-10_V7wLink_Feb83 - link.doc
There are 32 other files named link.doc in the archive. Click here to see a list.


         LINK.DOC: LINK Version 5.1(2030) 14 Feb 83




Copyright (C) 1983 Digital Equipment  Corporation,  Maynard,
MA.


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.

The information  in  this  software  is  subject  to  change
without  notice  and should not be construed as a commitment
by Digital Equipment Corporation.

Digital assumes no responsibility for the use or reliability
of  its  software  on  equipment  which  is  not supplied by
Digital.
                                                      Page 2


1.0  INTRODUCTION



LINK is the linking loader for the DECsystem-10.   LINK  5.1
is a development release of LINK for the DECsystem-10.  This
version includes a number of new features, internal changes,
and bug fixes.

LINK 5.1 supercedes all previous versions.   It  runs  under
all  supported  monitors,  and has been tested under TOPS-10
7.01A.

LINK is documented  in  the  LINK  Reference  Manual.   This
manual  is  available  as  part  of volume 11 of the TOPS-10
Software  Notebooks,   or   separately   as   order   number
AA-0988C-TB.




2.0  INSTALLATION


To install LINK the following files must be moved onto SYS:


     1.  LINK.EXE

     2.  LNKSCN.EXE

     3.  LNKLOD.EXE

     4.  LNKMAP.EXE

     5.  LNKXIT.EXE

     6.  LNKOV1.EXE

     7.  LNKOV2.EXE

     8.  LNKERR.EXE

     9.  LNK999.EXE

    10.  OVRLAY.REL


The LINK.HLP and LINK.DOC  files  should  be  moved  to  the
system directories HLP:  and DOC:  respectively.


                                                      Page 3


3.0  REBUILDING LINK


All the files required to rebuild LINK are included  on  the
tape:   sources,  command  files,  and  a control file.  The
control  file  LINK.CTL  reassembles  the  LINK  and  OVRLAY
modules  and  re-links LINK.  It requires a time limit of 20
minutes.  KS installations may require more time.

Note that in the future LINK patches will be distributed via
AUTOPATCH.  This procedure requires a set of unmodified LINK
sources.  It is recommended that an unmodified set  of  LINK
sources  be  preserved if maintenance edits or site-specific
enhancements are made.



4.0  RECENT CHANGES AND NEW FEATURES


     1.  Users converting existing FORTRAN  applications  to
         FORTRAN  77 as well as those writing new FORTRAN 77
         programs  will  be  able  to  use   the   load-time
         typechecking    facility    in   LINK.    Use   the
         /DEBUG:ARUGMENTS switch when compiling your FORTRAN
         program   to   get   link-time   messages  flagging
         inconsistencies in the number and kind of arguments
         being  passed  to  a  subroutine  or  function.  In
         addition the /ERRORLEVEL or /LOGLEVEL LINK switches
         may be used to get more detailed information.

     2.  If compilation errors occur during  the  processing
         of  a  LOAD, DEBUG or EXECUTE command LINK will now
         issue  the  ?LNKSUP  Loading  Suppressed   message.
         FORTRAN  version  7  and  future languages will not
         necessarily  produce  .REL  files  if   compilation
         errors  occur.   For  languages  that  produce .REL
         files despite errors, run LINK explicitly  or  give
         the  LOAD,  DEBUG or EXECUTE command a second time.
         This will clear the  compilation  error  count  and
         LINK will load the files.

     3.  LINK now supports writable overlays.  See Chapter 5
         of  the  new LINK-10 manual for more information on
         this feature.  This chapter has been  expanded  and
         extensively  revised and it should prove helpful to
         users  writing  command  files  to  build  overlaid
         programs.

     4.  LINK   supports   the   following   new   switches:
         /SUPPRESS  (  for  "undefining"  a global symbol ),
         /LIMIT ( for limiting the  size  of  a  segment  or
         PSECT ) and /MAXNODE ( for increasing the number of
         overlay links that can be included in a single load
         ).   These  new  switches  are described in the new
                                                      Page 4


         LINK-10 manual.

     5.  The  /PLTTYP  switch  permits  a  user  to  specify
         whether  a  disk  file  should be plotter format or
         printer format.




5.0  RESTRICTIONS


     1.  It is possible to cause infinite looping or illegal
         memory  references  if  segments or PSECTs overlap.
         This   happens   because   reference   chains   for
         unresolved symbols may be corrupted by the overlap.
         Use the /LIMIT switch to set the  maximum  size  of
         segments  and  PSECTs  to  get memory maps, logs or
         other  diagnostic  information  if  you  find  that
         changing  a  program's  size  or position in memory
         causes LINK to loop when loading the program.

     2.  If a program is being structured  to  use  overlays
         and  there  is  a  very  large  number  of  symbols
         associated with a particular overlay link, LINK may
         issue  an  ?LNKMEF  memory expansion error if a map
         file is requested.  If this occurs use  the  switch
         /NOLOCAL on some or all modules being loaded to cut
         back the number of symbols.

     3.  Sites which customize LINK to  search  user-defined
         libraries  by default require a patch to the module
         LNKINI to avoid an "Unknown Language" error.   This
         patch will be included in a future AUTOPATCH tape.

     4.  Users who request a  runtime  log  file  for  their
         overlaid  FORTRAN  programs  require a patch to the
         overlay handler.  This patch will be included in  a
         future AUTOPATCH tape.

     5.  An illegal memory reference may occur when LINK  is
         writing  a  line printer format overlay plot.  This
         patch will be included in a future AUTOPATCH tape.




6.0  NOTES ON .REL BLOCK RESTRICTIONS FOR COMPILER WRITERS


     1.  There are inconsistencies in  the  usage  of  PSECT
         indices in old and new .REL blocks.
                                                      Page 5


     2.  LINK currently expects type 1120-1127 blocks to use
         routine  names that can be translated to SIXBIT and
         which are unique in the first six characters.  Also
         this  routine  name  must be a global symbol.  Type
         mismatch warnings also display only the  first  six
         SIXBIT  characters  of  the global symbol name.  No
         currently supported language is  affected  by  this
         deficiency.

     3.  The .TPLOD  bit  defined  for  the  type  1120-1127
         blocks   is   not  currently  used.   No  currently
         supported language is affected by this deficiency.

     4.  There are conflicts between the  documentation  and
         the implementation of type 1070 blocks:
          Fullword  addition  is  used  for  additive  symbol
          fixups.

          Right halfword addition is used for other  additive
          fixups.

          Fullword fixups are done when thirty-bit fixups are
          requested.

     No currently supported language is  affected  by  these
     errors.



[ End of LINK.DOC ]