home *** CD-ROM | disk | FTP | other *** search
/ RISCWORLD 7 / RISCWORLD_VOL7.iso / Software / Issue6 / SDL.ZIP / !gcc / docs / Drlink / Drlink_doc < prev   
Encoding:
Text File  |  2006-07-26  |  55.0 KB  |  1,273 lines

  1.                      The 'Drlink' AOF Linker
  2.                      ~~~~~~~~~~~~~~~~~~~~~~~
  3.  
  4. Disclaimer
  5. ~~~~~~~~~~
  6. The 'Drlink' linker is provided 'as is' and people using it do so
  7. entirely at their own risk. No liability whatsoever will be
  8. accepted for any loss or damage arising from the use of this
  9. software.
  10.  
  11.  
  12. Introduction
  13. ~~~~~~~~~~~~
  14. Drlink is a linker that is intended to be a partial substitute for
  15. the Acorn linker, 'link'. It is aimed at people with compilers
  16. that generate object files in Acorn's AOF format but who do not
  17. have a copy of 'link', for example, people who want to use the DDE
  18. Pascal compiler or TLA or perhaps their own homebrew compilers.
  19. Drlink accepts object files in Acorn's AOF format and libraries in
  20. Acorn's ALF format and links them to produce an executable image
  21. in either Acorn's AIF format or a plain binary image. It can also
  22. be used to link relocatable modules or to create partially-linked
  23. AOF files. Drlink is modelled very closely on the version of
  24. 'link' that comes with release 3 of Acorn's C compiler but it is
  25. not really a complete replacement for it as it does not have the
  26. same range of facilities. What is there, it is hoped, should be
  27. adequate in most cases. Drlink is designed to link 'ordinary'
  28. programs and cannot do some of the fancy things link can, such as
  29. create image files that use overlays. Of course, some of these
  30. features could be added at a later date but the current version of
  31. Drlink does not support them. On the other hand, it does
  32. contain some features found on later releases of 'link' such as
  33. the ability to increase the size of the wimpslot if necessary when
  34. running in a task window and support for extended command lines.
  35. Other features include the ability to scan libraries more than
  36. once when resolving symbols and, assuming the right compiler
  37. options have been used when compiling programs, being able to
  38. leave out unused functions from executable images. Hopefully
  39. features like these will make the linker attractive to people who
  40. use link as well.
  41.  
  42.  
  43. Thanks...
  44. ~~~~~~~~~
  45. I would like to thank the many people on Arcade who have tested
  46. Drlink for me over the months and who made many helpful and useful
  47. suggestions. Drlink would never have reached the state it has
  48. today without their generous assistance.
  49.  
  50.  
  51. Using Drlink
  52. ~~~~~~~~~~~~
  53. Drlink is a command line-based program and has the same command
  54. syntax as 'link'. It can be used in the same environments as
  55. 'link', for example, with amu. If it is renamed as 'link', then
  56. it can be dynamically invoked from either the Acorn C or DDE
  57. Pascal compilers as well. It accepts the same options as 'link',
  58. although a number of them are unsupported and will be flagged as
  59. errors. Drlink also supports extended command lines. (Further
  60. information on this can be found in the section 'Extended Command
  61. Line Support' below.)
  62.  
  63. The command syntax is:
  64.  
  65.     drlink <list of files> <options>
  66.  
  67. where:
  68.  
  69. <list of files> is the list of object files and libraries to be
  70.                 included in the linked program.
  71.  
  72. <options>       is the options to be used when linking the
  73.                 program.
  74.  
  75. Options and object file names can be freely intermixed. The linker
  76. processes all the options before moving on to the link itself.
  77.  
  78. Filenames
  79. Each filename in the list of object files should be fully
  80. qualified, that is, Drlink makes no assumptions as to where the
  81. object files are to be found. Wildcards are permitted, in which
  82. case Drlink loads all the files that match the wildcard. If the
  83. directory containing the object files is called 'o', then Drlink
  84. will also accept 'back-to-front' filenames, for example, 'sieve.o'
  85. instead of 'o.sieve'. If a path is used as part of a filename, for
  86. example, 'C:', the way Drlink treats the filename depends on
  87. whether it contains wildcards or not. If it does not, then every
  88. directory on the path will be searched to find the file until
  89. either the file is found or the end of the list is reached. On the
  90. other hand, if the filename contains wildcards, only the first
  91. directory listed on the path will be checked. (This is how link
  92. behaves.) Examples:
  93.  
  94.     o.sieve
  95.     o.dhry1 o.dhry2 c:o.stubs
  96.     o.dhry* c:o.ansilib
  97.     dhry*.o c:ansilib.o
  98.     o.* c:o.*
  99.     O.world scsi::Arc.$.programs.!Pascal.O.Plib C:O.stubs
  100.  
  101. Drlink ignores the case of object file and library names.
  102.  
  103. Options
  104. As noted above, Drlink recognises the same options as 'link',
  105. even if it does flag a number as unsupported, plus has a number of
  106. its own. Options take the form of a '-' followed by the option
  107. name. Some options are followed by an argument. One or more blanks
  108. should be left between the option name and the argument. The case
  109. of the option and any argument is ignored. Options that are
  110. supported are:
  111.  
  112.     -aif       Create an AIF image file.
  113.  
  114.                This is the standard format for programs running
  115.                under RISC OS where a small header is attached to
  116.                the start of the program containing various bits
  117.                and pieces of information. It is the default option
  118.                used for the image type when no type is explicitly
  119.                given unless the '-base' option is used when '-bin'
  120.                is the default value.
  121.  
  122.     -aof       Create a partially-linked AOF file.
  123.  
  124.                The image file created takes the form of an AOF
  125.                file where as many references as possible between
  126.                the object files included in the link are resolved
  127.                and then the object files are merged together to
  128.                form another object file in AOF format that can be
  129.                used in a future link.
  130.  
  131.                There are a couple of points to watch out for here:
  132.                a) To include debug information in the AOF file,
  133.                   either '-debug' or '-keepdebug' must be used.
  134.                b) All local symbol names are lost, so they will
  135.                   not appear in the low-level debug tables if
  136.                   these are generated in the final image.
  137.  
  138.     -base <address>
  139.                This option allows the initial load address of the
  140.                read-only part of the image file to be specified.
  141.                The read-only part normally contains code.
  142.                <address> is taken to be decimal by default but if
  143.                prefixed by '&' or '0x' it will be treated as a
  144.                hexadecimal value. It can be postfixed by 'k' or
  145.                'm' to indicate the address is in kilobytes or
  146.                megabytes. The case of the 'k', 'm', 'x' or any of
  147.                the hex digits 'a' to 'f' is ignored. The value of
  148.                <address> is rounded up to the next word boundary
  149.                if it is not already so aligned.
  150.                
  151.                The initial load address can only be specified for
  152.                a binary image file.
  153.                
  154.                Image files created when this option is used do not
  155.                have a filetype but have 'load' and 'execute'
  156.                addresses instead. The load address is set to
  157.                whatever was specified on '-base' and the 'execute'
  158.                address to the program's entry point address. The
  159.                files themselves contain plain binary images as
  160.                created by the option '-bin'. This behaviour is
  161.                different to that of 'link'. 
  162.                
  163.     -bin       Create a plain binary image file.
  164.  
  165.                A binary image file does not have the header that
  166.                AIF files have on them and consist of nothing but
  167.                the linked program. This has two consequences.
  168.                Firstly, and most importantly, zero-initialised
  169.                data areas will not be cleared to zeros when the
  170.                program starts running as the routine to do this is
  171.                part of the AIF header. Secondly, if debugging
  172.                tables are included in the executable image, there
  173.                is nothing to indicate where they are.
  174.  
  175.                Note that when the option '-base' is used and the
  176.                image file type is not given, '-bin' is assumed to
  177.                be the image type.
  178.  
  179.     -c++       Perform C++-specific operations (only relevant for
  180.                Norcroft compiler).
  181.                
  182.                C++ requires the symbols '__link' to be chained
  183.                together to form a list which can be accessed through
  184.                '__head'. This is used to call constructor and
  185.                destructor functions.
  186.  
  187.     -case      Ignore the case of symbols when trying to resolve
  188.                symbol references. If this option is omitted, then
  189.                the case of the letters in symbol names is treated
  190.                as significant.
  191.  
  192.     -debug     Include debugging information in the image file. If
  193.                this option is omitted, any debugging tables
  194.                generated by the compiler that produced the AOF
  195.                file will be left out of the final image file. If
  196.                it is specified then any debugging tables found
  197.                will be included, along with some low-level tables
  198.                the linker itself creates. In the case where the
  199.                AOF files to be linked do not contain debugging
  200.                tables, only the linker's low-level tables will be
  201.                included.
  202.  
  203.                There is a second debug option, '-keepdebug', that
  204.                can be used to selectively include debugging
  205.                tables. Only one of '-keepdebug' or '-debug' should
  206.                be used. If both options are used, '-debug' takes
  207.                precedence.
  208.  
  209.                Note that if this option and '-bin' is used then
  210.                the debugging tables will still be included
  211.                although they will not really be of much use as
  212.                debuggers such as 'asd' would not be able to find
  213.                them. On the other hand, a routine in the program
  214.                might be able to locate them and for this reason
  215.                they are still included in the image file.
  216.  
  217.     -edit <name>
  218.                Gives the name of a file from which 'link edit'
  219.                commands are to be taken. For more information,
  220.                refer to the section 'Link Edit Commands' below.
  221.  
  222.     -help      Print a summary of Drlink options.
  223.  
  224.     -map       Print a list of areas (read-only code, data,
  225.                debugging tables, etc) in the image file giving
  226.                their addresses, sizes and types and the name of
  227.                the original AOF files that contained the areas.
  228.  
  229.     -module    Create a relocatable module in RMF format.
  230.  
  231.     -output <name>
  232.                Write the executable image file to file <name>. If
  233.                this option is omitted, the program is written to
  234.                the file '!Runimage' in the current directory.
  235.  
  236.     -relocatable
  237.                Create a relocatable AIF image file.
  238.  
  239.     -rmf       Create a relocatable module in RMF format.
  240.  
  241.     -verbose   Print messages as the link progresses saying how
  242.                far it has got. Some extra warning messages are
  243.                also produced if the linker finds aspects of the
  244.                link that look a bit iffy, for example, it will
  245.                print warning messages about unresolved 'weak'
  246.                external references. Normally, the linker keeps
  247.                quiet about such things.
  248.  
  249.                Note that '-quiet' takes precedence over
  250.                '-verbose'. If both options are specified,
  251.                '-verbose' is ignored.
  252.  
  253.     -via <name>
  254.                According to the documentation on 'link', this
  255.                option allows the list of files to be included in
  256.                the link to be specified in file <name>. In fact,
  257.                the file can also contain link options and this is
  258.                how the option '-via' has been implemented in
  259.                Drlink. When this option is encountered, input is
  260.                switched to the file <name> and the list of files
  261.                and options taken from that file until end-of-file
  262.                is reached whereupon input reverts back to the
  263.                command line. The only option that is not valid in
  264.                a '-via' file is '-via'. This option can be used
  265.                as many times as is necessary on the command line.
  266.                The format of the filenames and options in the file
  267.                <name> is exactly the same as when specified on the
  268.                command line, except they can be spread over as
  269.                many lines in the file as necessary. Any 'newline'
  270.                characters in the file are treated as if they were
  271.                blanks.
  272.  
  273.     -workspace <size>
  274.                For a relocatable AIF image file, reserve <size>
  275.                bytes of memory after the image when relocating
  276.                it. <size> is rounded up to a whole number of
  277.                words. <size> is taken to be decimal by default
  278.                but can be prefixed by '&' or '0x' to give a
  279.                hexadecimal value. It can be postfixed by 'k' or
  280.                'm' to indicate the size is in kilobytes or
  281.                megabytes. The case of the 'k', 'm', 'x' or any of
  282.                the hex digits 'a' to 'f' is ignored.
  283.  
  284. All other 'link' options are recognised but are unsupported. They
  285. are: dbug, entry, overlay and xref.
  286.  
  287. The linker has the following extra options of its own:
  288.  
  289.     -acornmap  If option '-symbols' is used to print a symbol
  290.                listing, then it will be created in a format
  291.                similar to that produced by 'link'.
  292.  
  293.     -areamap <name>
  294.                This option causes the linker to write a map of the
  295.                areas in the executable image to file <name>. If
  296.                option '-nounused' is used as well, a list of areas
  297.                left out of the image file is produced as well. The
  298.                format of the list is exactly the same as that
  299.                produced by the '-map' option.
  300.  
  301.     -data <address>
  302.                '-data' allows the address of the start of the
  303.                read/write portion of the image file to be
  304.                specified. <address> is assumed to be a decimal
  305.                value by default but prefixing it with '&' or '0x'
  306.                means it will be taken to be in hexadecimal. It can
  307.                be postfixed by 'k' or 'm' to indicate the address
  308.                is in kilobytes or megabytes. The case of 'k', 'm',
  309.                'x' or any hex digits is ignored. The value of
  310.                <address> will be rounded up to the next word
  311.                boundary.
  312.  
  313.                This option can only be used when linking a binary
  314.                image file. Other image formats, for example, AIF,
  315.                make assumptions as to where the read/write part of
  316.                the image is to be found and therefore use of
  317.                '-data' is restricted to binary files only.
  318.  
  319.                The linker built-in symbol 'Image$$RW$$Base' is set
  320.                to the address of the start of the read/write
  321.                portion of the file, so the address of the data
  322.                can be found in a program by including a reference
  323.                to this symbol.
  324.  
  325.                Note that this option should only be used with the
  326.                greatest of care. It allows the address of the
  327.                start of the read/write portion of the image to be
  328.                given. The point of this is to allow data to be
  329.                placed at a specific address in memory. However, it
  330.                is also possible for executable code areas to go in
  331.                the read/write part of the image. If '-data' is
  332.                used, any such code will be treated as though it
  333.                will be at <address> at run time but due to the
  334.                format of the image file, when the program is run,
  335.                the code will not be placed at <address>. The same
  336.                is true for any pre-defined data. Therefore, if
  337.                this option is being used, the following points
  338.                should be observed:
  339.  
  340.                1.  Executable code should be placed in read-only
  341.                    code areas only.
  342.                2.  Constants should be placed in read-only data
  343.                    areas only.
  344.                3.  The initial values of any other items of data
  345.                    will be undefined.
  346.  
  347.     -debimage  If this option is specified and the image file to
  348.                be written contains debugging tables, the filetype
  349.                of the image file is set to 'DebImage' instead of
  350.                'Absolute'. If this option is not used, the
  351.                filetype of the image file is always set to
  352.                'Absolute'.
  353.  
  354.     -gcc       This option is used in conjunction with '-nounused'
  355.                to tell the linker to ignore special areas created
  356.                by GCC when weeding out areas that are not
  357.                referenced in the image file. It has no other
  358.                effect. The default is to omit all unreferenced
  359.                areas.
  360.  
  361.     -keepdebug <file list>
  362.                The purpose of this option is to allow debugging
  363.                information to be included selectively in the image
  364.                file. <file list> is a list of the object files and
  365.                library members where any compiler generated
  366.                debugging tables found are to be kept. Debugging
  367.                tables in any other files or members are ignored.
  368.                Any linker-generated low-level debugging tables
  369.                will only include entries for the files in <file
  370.                list>.
  371.  
  372.                The format of <file list> is a string of names of
  373.                files and library members separated by commas with
  374.                no other intervening characters or a string of
  375.                names enclosed in double quotes separated by one or
  376.                more blanks. The names should exactly match the
  377.                names of the files or library members to which they
  378.                refer, although the case of the names is ignored.
  379.                Wildcarded names are not permitted, although the
  380.                case where a name in <file list> matches a file
  381.                name in the list of files to link that resulted
  382.                from expanding a wildcarded name is allowed.
  383.  
  384.                Only one of the debugging options should be used at
  385.                a time. If both are found on the command line then
  386.                '-debug' takes precedence over '-keepdebug' and the
  387.                image file will contain all the debugging tables
  388.                the linker finds.
  389.  
  390.     -leaveweak This instructs the linker to leave weak externals
  391.                unresolved if satisfying them would cause library
  392.                members to be loaded. This is the way the AOF
  393.                version 3 documentation says the linker should
  394.                behave, and is the opposite to the AOF 2 docs. By
  395.                default, Drlink will attempt to resolve weak
  396.                externals. This options makes it behave as per AOF 3.
  397.  
  398.     -lib <library list>
  399.                <library list> is a list of libraries that Drlink
  400.                will search when attempting to resolve symbol
  401.                references. The list can take two forms. Either it
  402.                can supplied as a string of library names separated
  403.                by commas with no intervening blanks or any other
  404.                white space characters or the list can be enclosed
  405.                in double quotes with the names separated by one
  406.                or more blanks. Wildcarded library names are not
  407.                permitted.
  408.  
  409.                This option should not be needed in the normal
  410.                course of events. Drlink can tell the difference
  411.                between AOF files and libraries without having to
  412.                be told which is which but this is not the purpose
  413.                of the option. Its purpose is to reduce the
  414.                amount of memory used by the linker. The way the
  415.                Drlink works is to read *all* the files given on
  416.                the  command line into memory including any
  417.                libraries. Whilst this speeds up pulling members
  418.                out of the libraries, it can be quite expensive in
  419.                terms of memory. Libraries specified after '-lib'
  420.                will not be brought into memory and members will
  421.                be loaded from them as required.
  422.  
  423.                Note that any 'old style' libraries listed after
  424.                '-lib' will be loaded immediately, that is, they
  425.                will not be added to the list of libraries to be
  426.                searched later.
  427.  
  428.     -linkersets
  429.                This option is similar to the -c++ option, but supports
  430.                a generalised form of the chained symbols. All symbols
  431.                prefixed by '__link' will be chained together with the
  432.                same named symbols. The start of each chain will be
  433.                stored in the symbol with the prefix '__head' and the
  434.                same suffix as the '__link' symbol. For example, all
  435.                symbols with the name '__link_init' would be chained
  436.                together and could be accessed through the symbol
  437.                '__head_init'.
  438.                
  439.                The '__link' symbols must be local.
  440.                The '__head' symbols must be global.
  441.  
  442.     -nounused  This option is used to control whether unreferenced
  443.                areas in the image file will be left out. By
  444.                default, all areas are left in but if '-nounused'
  445.                is specified, the linker checks each area in the
  446.                executable image and leaves out any that it finds
  447.                are not referenced by any other areas.
  448.  
  449.                The purpose of this option is basically to strip
  450.                out any unused functions in a program. To achieve
  451.                this, it is necessary first to compile the program
  452.                with the '-zo' C (and DDE Pascal) compiler option.
  453.                This has the effect of splitting each function up
  454.                into its own self-contained 'area' in the object
  455.                code file. If '-nounused' is specified, the linker
  456.                examines all the areas and discards any that it
  457.                finds are not referenced from any other areas. In
  458.                fact, if the linker finds that, as a result of
  459.                throwing away an area, others that it referenced
  460.                now become unused, it will discard those other
  461.                areas as well. Unfortunately, it will not detect
  462.                cases where there are loops, that it, if area 'a'
  463.                calls only area 'b' and area 'b' calls only area
  464.                'a', it will not detect that it is safe to throw
  465.                away both areas. On the other hand, it can handle
  466.                the case where an otherwise unused area calls only
  467.                itself.
  468.  
  469.                Note that if the '-verbose' option is used, Drlink
  470.                will print a list of areas that have been left out
  471.                of the image file, along with the name of the first
  472.                symbol in the area if it can find one. This should
  473.                hopefully be the name of the function contained in
  474.                that area in an AOF file produced by the C
  475.                compiler.
  476.  
  477.                This option is not present in the C release 3
  478.                linker but it might be available in other AOF
  479.                linkers.
  480.  
  481.                WARNING: It should be remembered that the '-zo' C
  482.                compiler option is undocumented. In versions 3 and
  483.                4 of the compiler, it contains a serious bug that
  484.                affects the addresses of character strings in the
  485.                executable image. Under certain conditions, these
  486.                addresses are *wrong*. There is a workaround for
  487.                this, however. If '-zo' is used then '-fw' should
  488.                be used as well, that is, you should say, for
  489.                example: 'cc -zo -fw -c c.world'.
  490.  
  491.     -pagealign Pagealign instructs the linker to align the end of
  492.                the last read-only area in the image file on a page
  493.                boundary. The pagesize of the machine on which the
  494.                linker is being run is used in the calculations.
  495.  
  496.     -quiet     This instructs the linker not to print the
  497.                'Drlink AOF Linker ...' message when it starts
  498.                up. Nothing will be printed except for error
  499.                messages. This option overrides '-verbose' if
  500.                both are specified.  This option will be ignored
  501.                when '-strict' is specified.
  502.  
  503.     -rescan    This tells the linker to scan libraries more than
  504.                once if necessary when searching for symbols.
  505.                'link' scans them only once so it is important to
  506.                specify libraries in the correct order. Drlink also
  507.                works like this unless '-rescan' is used, in which
  508.                case it will continue searching the libraries in
  509.                the order in which they were specified on the
  510.                command line until all symbols have been found or
  511.                all libraries have been checked for a particular
  512.                symbol.
  513.  
  514.                This option is not present in the C release 3
  515.                linker but it might be available in other AOF
  516.                linkers.
  517.  
  518.     -revmap    This option is used in conjunction with '-symbols'
  519.                and instructs the linker to list the symbols with
  520.                one symbol per line in the order <address> <name>.
  521.  
  522.     -symbols <file>
  523.                Create a file listing all the relocatable symbols
  524.                in the image file. They are listed in address
  525.                order.
  526.  
  527.                If option '-acornmap' is used, the symbol listing
  528.                will be produced in a format similar to that of
  529.                'link' instead of using Drlink's format, that is,
  530.                one symbol per line in the order <name> <address>.
  531.  
  532.                If option '-revmap' is used then the symbol listing
  533.                is produced with one symbol per line in
  534.                <address> <name> order.
  535.  
  536.    -strict
  537.                Treat warnings as errors.  Specifying this option
  538.                will ignore option '-quiet'.
  539.  
  540.    -throwback  If this option is used and it is possible to use
  541.                'throwback' then all warning, error and fatal error
  542.                messages will be displayed in a 'throwback' window.
  543.                Note that only errors found after the option has
  544.                been encountered in the command line will be sent
  545.                to the 'throwback' window. Any found before that
  546.                point as well as any informational messages will
  547.                still be displayed at the command line in the
  548.                normal way. To display all errors in the
  549.                'throwback' window, this option should be the first
  550.                one supplied on the command line.
  551.  
  552.                Note that in order to use this facility, it is
  553.                necessary to have the 'DDEUtils' module loaded and
  554.                an editor that supports 'throwback', for example,
  555.                Dominic Symes' editor, !Zap.
  556.  
  557.                Note that the 'throwback' file name is set to that
  558.                of the image file to be created, and the effects of
  559.                clicking on one of the error messages shown in the
  560.                window is undefined. 'Throwback' is meant to be
  561.                used for source files, not object code!
  562.  
  563. Note that most options can be abbreviated to one or two letters.
  564. The minimum abbreviation for each option is:
  565.  
  566.     -acornmap    -aco
  567.     -aif         -ai
  568.     -aof         -ao
  569.     -areamap     -area
  570.     -base        -b
  571.     -bin         -bi
  572.     -case        -c
  573.     -data        -da
  574.     -debimage    -debi
  575.     -debug       -d
  576.     -edit        -e
  577.     -gcc         -gcc
  578.     -help        -h
  579.     -keepdebug   -keep
  580.     -leaveweak   -leave
  581.     -lib         -lib
  582.     -map         -map
  583.     -module      -m
  584.     -nounused    -no
  585.     -output      -o
  586.     -pagealign   -pag
  587.     -quiet       -qui
  588.     -relocatable -r
  589.     -rescan      -res
  590.     -revmap      -rev
  591.     -rmf         -rm
  592.     -symbols     -s
  593.     -throwback   -th
  594.     -verbose     -v
  595.     -via         -via
  596.     -workspace   -w
  597.  
  598. Examples:
  599.  
  600.     drlink o.sieve c:o.stubs
  601.     drlink sieve.o c:stubs.o
  602.     drlink o.dhry1 o.dhry2 c:o.ansilib
  603.     drlink o.dhry1 o.dhry2 c:o.stubs -o dhry
  604.     drlink o.* -no -o PDC
  605.     drlink o.life c:o.risc_oslib c:o.stubs -map -v
  606.     drlink o.life -lib c:o.risc_oslib,c:o.ansilib
  607.     drlink o.life -lib "c:o.risc_oslib  c:o.ansilib"
  608.     drlink -throw o.balls64 p:o.plib c:o.risc_oslib P:O.Stubs
  609.     drlink o.balls64 -via pasclibs -map -v
  610.  
  611. The default options are to generate an AIF image file, to treat
  612. the case of symbols names as significant, not to include debugging
  613. information, to include all areas in the image file, not to
  614. produce an area map or symbol listing and to keep quiet about what
  615. the linker is doing.
  616.  
  617. In normal use, it should not really be necessary to use any of the
  618. linker options and running Drlink should just be a case of
  619. typing the command and the list of files and libraries to include
  620. in the linked image file, perhaps using the '-d' option to include
  621. debugging tables or '-o' to change the name of the linked image
  622. file. 
  623.  
  624.  
  625. Return Codes
  626. ~~~~~~~~~~~~
  627. If a link works, Drlink gives a return code of zero. If it fails,
  628. it posts a return code of twelve. A fatal error produces a return
  629. code of sixteen.
  630.  
  631.  
  632. Extended Command Line Support
  633. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  634. Drlink can make use of the extended command line facility that
  635. is provided by the 'DDEUtils' module. This allows the command line
  636. passed to Drlink to be of any length and not restricted to the
  637. normal limit of 255 characters. If the linker finds there is an
  638. extended command line available, it uses that in preference to the
  639. standard command line, which it completely ignores.
  640.  
  641. In order to use this facility, it is necessary to have the module
  642. 'DDEUtils' loaded and to use software that can set up extended
  643. command lines, for example, the version of 'amu' that comes with
  644. release 4 of the C compiler. 
  645.  
  646.  
  647. Link Edit Commands
  648. ~~~~~~~~~~~~~~~~~~
  649. This is a feature that allows symbols in the AOF files to be
  650. edited in various ways. Four operations are possible:
  651.  
  652. 1.  Rename a symbol in an AOF file.
  653. 2.  Change a symbol reference in an AOF file.
  654. 3.  Hide a symbol in an AOF file by making it 'local'.
  655. 4.  Reveal a symbol in an AOF file by making it 'global'.
  656.  
  657. The purpose of these commands is to resolve problems where
  658. different AOF files define symbols with the same name or to enable
  659. what would be unresolved symbol references to be replaced with
  660. references to defined symbols. Note that all that the commands do
  661. is act as a filter on the AOF files before they are passed to the
  662. main link routines and that if, for example, a symbol reference is
  663. changed, then there are no checks to make sure that the new symbol
  664. refers to the same sort of 'thing' as the old.
  665.  
  666. The commands are read from the file specified on the option
  667. '-edit'. Note that, unlike 'link', multiple 'link edit' files
  668. can be supplied. The general format of the commands is:
  669.  
  670.     <command> <filename> ( <one or two symbol names> )
  671.  
  672. <command> is one of the four commands described below and <filename>
  673. is the name of the AOF file or library member that will be
  674. affected by the command. Depending on the command, either one or
  675. two symbol names follows in brackets. The commands are free-form
  676. and can be spread over as many lines as necessary in the file.
  677. Several commands can be stacked on one line and there is no limit
  678. on the number of commands in a file.  At least one space should be
  679. left between the command and the filename but they are optional
  680. after that. The case of the link edit commands themselves is
  681. ignored as is that of any file names, but the case of symbol names
  682. is taken as significant, unless the option '-case' is specified on
  683. the command line as well in which case it is ignored. It is
  684. possible for several commands to refer to the same symbol, so
  685. that, for example, the name of a symbol could be changed in one
  686. file and references to it in another file could also be changed to
  687. that name as well. The order of the commands in the file is, in
  688. general, unimportant, but also refer to the note below. If, on the
  689. other hand, a symbol is to be renamed and its scope changed at the
  690. same time, then both edit commands should refer to the symbol by
  691. the symbol's old name.
  692.  
  693.  
  694. Rename a Symbol
  695. The format of the command is:
  696.  
  697.     rename <filename> ( <old name> , <new name> )
  698.  
  699. The effect of the command is to rename the symbol <old name>
  700. defined in file <filename> as <new name>. All references to the
  701. symbol should use <newname>.
  702.  
  703.  
  704. Change a Symbol Reference
  705. The format of this command is:
  706.  
  707.     change <filename> ( <old name> , <new name> )
  708.  
  709. It changes external references to symbol <old name> in file
  710. <filename> to <new name>.
  711.  
  712. Hide a Symbol
  713. This command's format is:
  714.  
  715.     hide <filename> ( <symbol name> )
  716.  
  717. If the symbol <symbol name> in file <filename> is marked as being
  718. visible to any file that references it, its scope is change to
  719. 'local' so that it can only be referenced in the file in which it
  720. was declared.
  721.  
  722. Reveal a Symbol
  723. This command has the format:
  724.  
  725.     reveal <filename> ( <symbol name> )
  726.  
  727. If the symbol <symbol name> in file <filename> is marked as a
  728. 'local' symbol, that is, can only be referenced in the file file
  729. in which it was declared, its scope is changed to 'global' so that
  730. any file can reference it.
  731.  
  732. Examples:
  733.  
  734.     hide o.sieve(main)
  735.  
  736.     rename o.miscprocs(isalnum,isalfanum)
  737.     change o.lexicals(isalnum,isalfanum)
  738.     change o.preproc(isalnum,isalfanum)
  739.  
  740. There are a couple of points to be aware of using the link edit
  741. commands.
  742.  
  743. Firstly, the commands are not executed in the order in which they
  744. are specified. All the commands for one file are performed
  745. together. They are also carried out in the order in which the
  746. files are specified on the command line. As the order in which
  747. library members will be read is not defined, the order in which
  748. link edit commands for these are executed is undefined as well.
  749.  
  750. There are times when the commands will appear not to work. In a
  751. 'C' or DDE Pascal program, if a symbol reference, for example, a
  752. function call, is changed, references to that symbol within the
  753. AOF file will not be altered as the compiler will have resolved
  754. the references at compile time.
  755.  
  756.  
  757. A Brief Description of Drlink
  758. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  759. Drlink starts by reading the list of object files and libraries
  760. given on the command line into memory, except for any libraries
  761. given on the option '-lib'. Any 'link edit' commands are acted
  762. upon as the files are read. After this, Drlink attempts to resolve
  763. symbol references in each object file using, first, the symbols
  764. defined as being local to that file and then symbols defined as
  765. available to any file. If there are still any unresolved symbols,
  766. it then goes through each library trying to find them. The
  767. libraries are searched in the order they are specified on the
  768. command line, from left to right. This includes libraries
  769. specified on the '-lib' option. Each library is scanned only once,
  770. unless the option '-rescan' is used.  This means that any library
  771. members read can only refer to symbols that are already known or
  772. that can be found in that library or one that has yet to be
  773. searched. The order that libraries are specified on the command
  774. line is therefore very important. If, on the other hand, '-rescan'
  775. is specified, Drlink will keep searching the libraries until all
  776. the symbols have been found or until it determines that a symbol
  777. cannot be found in any library.
  778.  
  779. Assuming that all symbol references have been found, Drlink moves
  780. on to resolving addresses. Before it does that, however, if the
  781. '-nounused' option was specified, it attempts to determine the
  782. areas in the program that are not referenced from any other areas
  783. and removes any it finds from the program. Next, it determines the
  784. proper addresses of all the symbols and areas in the program and
  785. then goes through the program relocating and resolving addresses.
  786. If the '-debug' option is used, the low level debugging table is
  787. created at this point. The final step is to write the completed
  788. image file to disk.
  789.  
  790. Drlink has the ability to increase the amount of memory it is
  791. using if it is running in a task window or using the 'F12' CLI. It
  792. will acquire as much extra memory as it needs and return it once
  793. the link has completed. Drlink can be run in a wimpslot of only
  794. 96K bytes.
  795.  
  796.  
  797. Pre-defined Symbols
  798. ~~~~~~~~~~~~~~~~~~~
  799. There are a number of pre-defined symbols that can be referenced
  800. in object files. These are defined by the linker itself. The ones
  801. that Drlink supports are:
  802.  
  803. Image$$RO$$Base    The start address of the 'read-only' part of
  804.                    executable image when loaded into memory. This
  805.                    contains program code and constants.
  806.  
  807.  
  808. Image$$RO$$Limit   This is the address of the byte after the last
  809.                    byte of the 'read-only' part of a program when
  810.                    loaded into memory.
  811.  
  812. Image$$RW$$Base    This gives the address of the first byte of the
  813.                    'read/write' portion of a program when loaded
  814.                    into memory. This contains program code and
  815.                    data.
  816.  
  817. Image$$RW$$Limit   This defines the address of the byte after the
  818.                    last byte of the 'read/write' part of the
  819.                    program. The includes any zero-initialised data
  820.                    areas.
  821.  
  822. Image$$ZI$$Base    This symbol defines the start address of the
  823.                    'zero-initialised' part of the program when
  824.                    loaded into memory. This is simply an area of
  825.                    memory that is used by the program when it is
  826.                    run to hold data. It is not included in the
  827.                    image file on disk to prevent the image file
  828.                    becoming bloated with huge tracts of
  829.                    uninitialised data (except the Acorn C compiler
  830.                    does not make use of them and so the image
  831.                    file can become bloated with huge tracts of
  832.                    uninitialised data). If an AIF file is being
  833.                    produced (the standard Acorn executable image)
  834.                    then the zero-initialised data area is cleared
  835.                    to zeros when the program is run. This is not
  836.                    case if any other executable file formats are
  837.                    used, for example, '-bin'.
  838.  
  839. Image$$ZI$$Limit   This marks the address of the byte following
  840.                    the last byte of the 'zero-initialised' data
  841.                    part.
  842.  
  843.                    It should be noted that, with Drlink, the two
  844.                    symbols 'Image$$RW$$Limit' and 'Image$$ZILimit'
  845.                    are set to the same value.
  846.  
  847. The Acorn documentation says that the end of one part of the
  848. executable image should not be assumed to coincide with the start
  849. of the next, for example, it should not be assumed that the
  850. read/write part of the image starts the byte after the read-only
  851. part.
  852.  
  853. The six 'Image$$' symbols are defined in the 'link' documentation
  854. but there are a large number of other undocumented symbols, some
  855. of which are used by the libraries supplied with the C compiler
  856. (the C release 3 libraries, at least). Drlink implements a
  857. number of these but not the whole set, nor are the ones that are
  858. present guaranteed to remain there.
  859.  
  860. 'Area' Symbols
  861. Roughly speaking, the part of the AOF file that contains the
  862. actual code, data and debugging tables compiled from the original
  863. source file is broken down into a number of named 'areas', for
  864. example, the C compiler generates an area called 'C$$Code' for
  865. program code and one called 'C$$Data' for any data. These will be
  866. present in each AOF file included in the link and what Drlink
  867. (and 'link') does is to group all the areas with the same name
  868. together. What is not documented, though, is that each uniquely
  869. named area encountered by the linker results in creation of three
  870. symbols that can be can be (and are) referenced by any object
  871. file. These are the area name itself and a 'base' and 'limit' pair
  872. which point at the start address of the first area of that name
  873. when the program is loaded and the address of the byte after the
  874. last occurrence of that area, for example, the area 'C$$Code'
  875. would generate the symbols 'C$$Code', 'C$$Code$$Base' and
  876. 'C$$Code$$Limit'. The area 'C$$Debug' adds the symbols 'C$$Debug',
  877. 'C$$Debug$$Base' and 'C$$Debug$$Limit' to the linker's symbol
  878. table.
  879.  
  880. What was said in the preceding paragraph also applies to 'common'
  881. blocks. These are areas just like any other, but they are handled
  882. slightly differently in that all common block areas with the same
  883. name are overlaid on one another with the size of the common block
  884. being that of the largest instance of the common block. Just as
  885. with other areas, three symbols are created for each common block
  886. that can be used in programs: the common block name and a 'base'
  887. and 'limit' pair based on that name, for example, a common block
  888. called 'acorn' would add the symbols 'acorn', 'acorn$$Base' and
  889. 'acorn$$Limit' to the linker's tables.
  890.  
  891. If the '-zo' C compiler option is used, each function in the
  892. object code has its own uniquely-name area and this results in an
  893. explosion in the number of area symbols generated. Normally this
  894. would not be a problem except for the extra memory required to
  895. hold these symbols, but it results in the low-level debugging
  896. table created by the linker becoming flooded with what is, in the
  897. author's opinion, totally useless symbol information. Drlink's
  898. solution to this problem is not to include any symbols generated
  899. for areas apart from those for common blocks in the low-level
  900. debugging table.
  901.  
  902. There are other symbols that 'link' defines internally but these
  903. have not been seen in any AOF files yet and so they have not be
  904. included in Drlink.
  905.  
  906.  
  907. Linker sets (and constructor/destructor lists)
  908. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  909.  
  910. As of Drlink 0.42, Drlink is capable of creating implicitly
  911. linked lists of tables from its object files. This feature is an
  912. extension of the C++ constructor/destructor lists. These are only
  913. likely to be of use to experienced programmers.
  914.  
  915. Within certain programs it is useful to be able to provide
  916. support for extending features of a program without requiring any
  917. changes to the code. The best example of this is the initial use
  918. of the linker sets, the C++ constructor list. When a C program
  919. starts its static data is already initialised before 'main' is run.
  920. However, when a C++ program starts, the initialisation of its
  921. static data may involve the execution of more complex code - the
  922. object constructors. There can be any number of constructors and
  923. these must all be located and initialised. The C++ system uses
  924. a special pair of symbols to locate the routines that will be
  925. used to constructor objects. The '__link' symbol is defined
  926. within every object file as a local symbol. Being a local symbol,
  927. it can therefore be defined in multiple files. The first word
  928. pointed to by each of these symbols will be chained together to
  929. the next. The start of this list is assigned to the word pointed
  930. to by the '__head' symbol. The '__head' symbol is a global
  931. symbol which is only defined in the routine used to initialise
  932. the C++ system (this is actually used in the ______main routine
  933. in the C++ system, but this is an implementation issue rather
  934. than a linker-provided feature). This feature is enabled by the
  935. '-c++' switch.
  936.  
  937. Linker sets are a generalisation of this feature, enabled by
  938. the '-linkersets' switch. Rather than being restricted to the
  939. single '__link' and '__head' symbols, the linker can generate
  940. a chain of any number of symbols beginning with these names.
  941. Only lists which match the names suffix would be related. That
  942. is, the list starting at '__head_foo' and made up of the
  943. local symbols named '__link_foo', would be distinct from the
  944. list starting at '__head_bar' and made up of the local symbols
  945. named '__link_bar'.
  946.  
  947. For example, if you had a list of messages you wanted to be
  948. printed by an application when it started up, you could use
  949. a linker set to chain these together. Each file which wanted
  950. to provide a message would include code similar to the
  951. following :
  952.  
  953. static struct _linkerset_s {
  954.   struct _linkerset_s *next;
  955.   char *message;
  956. } __link_message = { NULL, "Message to be displayed" };
  957.  
  958. Within the main code, where the message was to be displayed,
  959. the list could be iterated through with code similar to the
  960. following :
  961.  
  962. struct _linkerset_s {
  963.   struct _linkerset_s *next;
  964.   char *message;
  965. } *__head_message;
  966.  
  967. int show_messages(void)
  968. {
  969.   struct _linkerset_s *ls;
  970.   for (ls = __head_message; ls; ls = ls->next)
  971.     printf("%s\n", ls->message);
  972. }
  973.  
  974. It is important to note that only the first word of the linker set
  975. is important to drlink. The above examples only use a single 
  976. additional word, but beyond the first element the structure is
  977. completely user defined.
  978.  
  979.  
  980. Differences Between Drlink and Link
  981. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  982. Drlink is based on the version of 'link' that comes with
  983. release 3 of the C compiler but there are a number of features of
  984. 'link' that are missing or that have been changed slightly. The
  985. idea is that Drlink will be used to link 'ordinary' programs and
  986. not any of the more exotic types that the Acorn linker can handle,
  987. for example, programs that use overlays.
  988.  
  989. First, the missing features:
  990.  
  991. 1)  Drlink does not support overlays (the '-overlay' option).
  992.  
  993. 2)  The entry address of the program cannot be specified (the
  994.     option '-entry').
  995.  
  996. 3)  The old debug option '-dbug' is not supported.
  997.  
  998. 4)  The option to print a list of cross references between areas
  999.     has not be included (option '-xref').
  1000.  
  1001. 5)  It does not support unnamed common blocks.
  1002.  
  1003. 6)  The 'link' documentation contains vague references to Un*x
  1004.     'Aout' format files. Drlink does not handle these.
  1005.  
  1006. The known differences are:
  1007.  
  1008. 1)  The low level debugging tables do not have as many entries in
  1009.     them as the ones generated by 'link'. 'link' includes entries
  1010.     for symbols for every single area in the executable program
  1011.     but Drlink leaves out all of these apart from the ones for
  1012.     'common' blocks.
  1013.  
  1014. 2)  There are a number of undocumented built-in linker symbols
  1015.     available in 'link' such as '_esdata' that Drlink does not
  1016.     include.
  1017.  
  1018. 3)  The default program name created by the linker is '!Runimage'
  1019.     and not 'aif'.
  1020.  
  1021. 4)  If the '-bin' option is used to create a binary file and the
  1022.     entry point is not the first instruction in the program,
  1023.     Drlink adds a branch to that address at the start of the
  1024.     program.
  1025.  
  1026. 5)  The link edit commands are different to link's.
  1027.  
  1028. 6)  The partially-linked AOF files produced by Drlink are not the
  1029.     same as those produced by link. They do not contain the zero-
  1030.     length area 'Aout$$Common'. The relocations in the AOF file
  1031.     are a mixture of type-1 and type-2 rather than being all
  1032.     type-2.
  1033.  
  1034. 7)  '-base' behaves differently. With link, the filetype of a file
  1035.     where '-base' is used is 'absolute'. Drlink makes such files
  1036.     untyped and gives them load and execution addresses.
  1037.  
  1038. 8)  Strong symbol definitions are more fully supported.
  1039.  
  1040. The extensions to the Acorn release 3 link are:
  1041.  
  1042. 1)  If running under a task window or in the 'F12' CLI, Drlink can
  1043.     extend its wimpslot.
  1044.  
  1045. 2)  It can removed unreferenced areas from the executable program.
  1046.  
  1047. 3)  Drlink supports extended command lines.
  1048.  
  1049. 4)  It can scan libraries more than once.
  1050.  
  1051. 5)  Debugging tables can be selectively included in the image
  1052.     file.
  1053.  
  1054. 6)  Warning, error and fatal error messages can be displayed in a
  1055.     'throwback' window.
  1056.  
  1057. 7)  The starting address of the read/write part of the image file
  1058.     can be defined by means of a linker option.
  1059.     
  1060. 8)  A map of areas contained in the executable image file can be
  1061.     written to a file.
  1062.  
  1063. 9)  It can produce a listing of symbols in the image file.
  1064.  
  1065. 10) It can align the end of the read-only portion of the image fle
  1066.     on a page boundary.
  1067.  
  1068. 11) It partially supports AOF version 3 (enough to link C and C++
  1069.     programs) and generates AIF version 3 headers on image files.
  1070.  
  1071. In all other respects, Drlink should behave in exactly the same
  1072. way as 'link', hopefully apart from some known bugs in 'link'.
  1073. There are probably other subtle differences in the way the linkers
  1074. behave but these are not known.
  1075.  
  1076.  
  1077. Change Record
  1078. ~~~~~~~~~~~~~
  1079. Drlink 0.20 - First release version.
  1080.  
  1081. Drlink 0.21
  1082. -  Added support for type-2 relocations.
  1083. -  Fixed problem with paths with multiple directories in
  1084.    filenames.
  1085. -  Speeded up linker a bit.
  1086.  
  1087. Drlink 0.22
  1088. -  Fixed bug where symbolic debug tables were left out of the
  1089.    image file if '-nounused' was used.
  1090. -  Changed way linker orders areas to more closely match that of
  1091.    'link'.
  1092. -  Added option '-keepdebug' to selectively include debugging
  1093.    information from object files in image file.
  1094. -  Allowed filenames supplied for options '-lib' and '-keepdebug'
  1095.    to be enclosed in double quotes. This will, in fact, work on
  1096.    any option.
  1097.  
  1098. Drlink 0.23
  1099. -  Added 'link edit' commands (the '-edit' option).
  1100. -  Added code to allow 'back-to-front' filenames.
  1101. -  Now sets a return code of 12 if a link fails.
  1102. -  Fixed bug in '-keepdebug' code where a buffer was overflowing
  1103.    and overwriting anything that followed it, e.g. amu.
  1104.  
  1105. Drlink 0.24
  1106. -  Made 'verbose' mode list the names of the external references
  1107.    being satisfied and the files containing those references when
  1108.    loading library members.
  1109. -  Linker now prints a warning message about and lists files
  1110.    specified on '-keepdebug' that were not loaded.
  1111. -  A problem with extended command lines containing rubbish at the
  1112.    end of the line has been fixed.
  1113.  
  1114. Drlink 0.25
  1115. -  Fixed bug where the offset of the program entry point within
  1116.    the entry point's area was being set to zero.
  1117. -  Fixed bug in '-nounused' code where references to areas in
  1118.    type-2 relocations were not being handled correctly.
  1119. -  Fixed bug to do with filenames that include a path variable
  1120.    that only showed up with RISC OS 2.
  1121. -  Added the option to create partially-linked AOF files (option
  1122.    '-aof').
  1123. -  Added 'throwback' support (option '-throwback'). Warning, error
  1124.    and fatal error messages can be displayed in a 'throwback'
  1125.    window.
  1126. -  Added warning to documentation concerning the use of the C
  1127.    compiler option '-zo'.
  1128.  
  1129. Drlink 0.26
  1130. -  Improved linker's performance in large links.
  1131. -  Improved memory management.
  1132. -  Added options '-base' and '-data' to allow the start addresses
  1133.    of code and data part of the image file to be specified.
  1134. -  Added option '-areamap' to allow map of areas in image file to
  1135.    be written to a file.
  1136. -  Added code to circumvent problem with the DDEUtils command
  1137.    '*prefix' where the linker cannot find files where a path is
  1138.    included as part of the filename, for example, 'C:O.Stubs',
  1139.    after '*prefix' has been used.
  1140.  
  1141. Drlink 0.26a - Bug fix version
  1142. -  Fixed bug introduced in 0.26 where -aof code stopped working.
  1143. -  Programmed around problem affecting files from Objasm that
  1144.    contain debug tables where the tables contain an invalid 'AL'
  1145.    attribute.
  1146. -  RISC OS 2 filenames with paths finally sorted out I hope!
  1147. -  Recompiled with the latest and greatest version of the
  1148.    compiler.
  1149.  
  1150. Drlink 0.27
  1151. -  Fixed bug where unresolved references to weak external symbols
  1152.    were being included in the list of relocations at the end of
  1153.    relocatable modules.
  1154. -  Fixed bug in '-nounused' which could cause addressing
  1155.    exceptions if an AOF file contained type-2 relocations.
  1156. -  Fixed bug where type-2 relocations in an object file that is
  1157.    used as part of a partially-linked AOF file were sometimes
  1158.    being relocated incorrectly.
  1159. -  Added option '-acornmap' to allow printing of symbol listing in
  1160.    more-or-less the same format as that used by 'link'.
  1161. -  Added option '-pagealign' to allow end of read-only part of
  1162.    image to be aligned on a page boundary (useful for DDT).
  1163. -  Changed symbol listing so that the addresses of symbols in
  1164.    relocatable modules are expressed as an offset from the start
  1165.    of the module instead of an address.
  1166. -  Corrected handling of common blocks.
  1167. -  Added code to allow code and data areas to have the 'common
  1168.    definition' area attribute.
  1169. -  Changed handling of zero length areas. Previously Drlink
  1170.    ignored these completely.
  1171. -  The linker will now produce a list of unresolved weak external
  1172.    references if option '-verbose' is used instead of just
  1173.    mentioning the fact.
  1174. -  Corrected low level debug table and symbol listing code so that
  1175.    they no longer include symbols from areas omitted from the image
  1176.    file.
  1177. -  Added support for 'strong' symbol definitions.
  1178. -  Added some AOF V3 support.
  1179.  
  1180. Drlink 0.28
  1181. -  Added option '-leaveweak' to stop linker resolving weak external
  1182.    references from libraries (so that it behaves as per AOF 3 docs).
  1183. -  Changed headers on image file to AIF v3 headers.
  1184. -  Added option -C++ to instruct linker to carry out C++-specific
  1185.    operations concerned with constructors and destructors. The
  1186.    linker does not yet expand C++ mangled names into their full
  1187.    versions.
  1188. -  Added support for 'old style' libraries so that FORTRAN 77
  1189.    programs can be linked.
  1190. -  Fixed bug where relocation info for type-2 relocations was
  1191.    missed out in relocatable AIF files and relocatable modules.
  1192. -  Improved memory management when linker is running out of memory.
  1193.  
  1194. Drlink 0.29
  1195. -  Added symbols 'Image$$CodeBase', 'Image$$CodeLimit',
  1196.    'Image$$DataBase' and 'Image$$DataLimit' required by FORTRAN 77
  1197.    programs. These will only be included if 'old style' libraries
  1198.    are read.
  1199.  
  1200. Drlink 0.30
  1201. -  Made code StrongARM compatible.
  1202. -  Added support for 'based' areas.
  1203. -  Added support for areas not aligned on a word boundary.
  1204. -  Added option '-quiet' which stops linker from printing the
  1205.    'Drlink AOF Linker' message.
  1206. -  Added support for the relocation of instruction sequences.
  1207. -  Fixed bug affecting symbols which had the 'common reference'
  1208.    attribute set.
  1209. -  Fixed two bugs in partially-linked AOF file support which
  1210.    stopped partially-linked files working with C release 5.
  1211. -  Fixed bug causing addressing exception when option '-symbol'
  1212.    was used when creating a partially-linked AOF file.
  1213. -  Fixed bug in C++ code where areas containing constructors
  1214.    and destructors could be deleted if option '-nounused' was
  1215.    used.
  1216. -  Added code to handle 'strong symbol' case that was missed out
  1217.    when strong symbol support was added.
  1218.  
  1219. Drlink 0.31
  1220. -  Fixed bug in library search code.
  1221. -  Added option '-revmap'.
  1222.  
  1223. Drlink 0.32
  1224. -  Fixed problem where very long symbol names (300 characters!)
  1225.    caused the linker to fail in various places.
  1226.  
  1227. Drlink 0.33
  1228. -  Fixed problem in code that produces area maps where area names
  1229.    longer than about 200 characters were causing the linker to
  1230.    die.
  1231. -  Added option '-gcc' to stop linker removing GCC-specific areas
  1232.    from the image file when '-nounused' is used.
  1233. -  Increased the maximum length filename that the linker will
  1234.    handle to 500 characters.
  1235.  
  1236. Drlink 0.34
  1237. -  Linker can now be compiled to run under RiscBSD and Linux (but
  1238.    it still links only AOF files).
  1239.  
  1240. [...]
  1241.  
  1242. Drlink 0.41
  1243. - Support big-endian platforms (like Mac OS X).  This does not
  1244.   mean support for big-endian AOF/ALF files.
  1245.   
  1246. Drlink 0.42 (based on work from Justin Fletcher)
  1247. - Fix for C++ constructor/destructor lists corrupting image
  1248.   (Norcroft case).
  1249. - Added support for -linkersets in line with the functionality of
  1250.   recent versions of Norcroft Link.
  1251. - Src code cleanups.
  1252.  
  1253. Drlink 0.43
  1254. - Support for host platforms where sizeof(void *) != 4.
  1255.  
  1256. Drlink 0.44
  1257. - Option -strict: treat warnings as errors.
  1258. - Support for natural filenames for object and library files.
  1259. - Fixed problem hiding symbol from an AOF file stored in ALF
  1260.   library.
  1261.  
  1262.  
  1263. Copyright
  1264. ~~~~~~~~~
  1265. The software and the documentation that goes with it is
  1266. Copyright © David Daniels 1993, 1994, 1995, 1996, 1997, 1998.
  1267. Copyright © GCCSDK Developers 2001, 2002, 2003, 2004, 2005, 2006.
  1268.  
  1269. Around 2001 David Daniels issued the source code of Drlink under
  1270. GPL.
  1271.  
  1272. -EOF-
  1273.