home *** CD-ROM | disk | FTP | other *** search
/ Computer Club Elmshorn Atari PD / CCE_PD.iso / mac / 1000 / CCE_1024.ZIP / CCE_1024 / SOZBIN07.LZH / SOZDISTR / DOC / LD.MAN < prev    next >
Text File  |  1994-07-26  |  7KB  |  265 lines
  1.  
  2.  
  3. LD(1)                 Sozobon Programmer's Manual                  LD(1)
  4.  
  5.  
  6.  
  7.  
  8. NAME
  9.         ld - The SozobonX Linker (loader)
  10.  
  11. SYNOPSIS
  12.         ld [options] [<file> ...]
  13.  
  14.         ld [-Vvhtpmb][-v2] [--nofload][--nofram] [--nofmem]
  15.              [-o <file>] [-u <symbol>] [-L<path>]
  16.                   [-f <link file>] | [<file> ...]
  17.  
  18. DESCRIPTION
  19.         The    ld  command links object modules and libraries to form an
  20.         executable program.  Both object modules and  libraries  may  be
  21.         passed to  ld  for linking.  It can handle DRI, SozobonX objects
  22.         and DRI archives only.
  23.  
  24.         By default the output is written  to  file    'a.out',  and  the
  25.         Fastload,  'load to FastRAM' and the  'malloc from FastRAM' pro-
  26.         gram header flags are set.
  27.  
  28.         Several options may be specified to alter the operation  of  the
  29.         linker:
  30.  
  31. OPTIONS
  32.  
  33.          --version 
  34.          -V 
  35.              Print detailed Version information to stdout and exit
  36.  
  37.          --help 
  38.          -h 
  39.              Print the synospsis information (usage) and exit
  40.  
  41.          -v   (verbose) 
  42.              Generally show more information about what  ld is doing and
  43.              print short version information (to stderr).
  44.  
  45.          -v2 
  46.              If  you put two  'v's or a  '-v2' into commandline  ld will
  47.              be more verbose, printing the symbols  looked  for  in  the
  48.              libraries,  and  the  extern  symbols  of  the  newly added
  49.              modules from the libraries.
  50.  
  51.          -t   (table) 
  52.              Put a symbol table in the output file.
  53.  
  54.          -p   (passes) 
  55.              Make multiple  passes  over  each  library  until  no  more
  56.              references can  be  satisfied.    If  libraries are ordered
  57.              appropriately, this option is not needed and  linking  will
  58.              be faster.
  59.  
  60.          -f  <file>
  61.  
  62.  
  63.  
  64. v 2.00x9                  Release: Jul 21 1994                    Page 1
  65.  
  66.  
  67.  
  68.  
  69. LD(1)                 Sozobon Programmer's Manual                  LD(1)
  70.  
  71.  
  72.  
  73.              This  option  is  useful  when many files are to be linked.
  74.              The loader reads the file <file> specified for  a  list  of
  75.              object modules  and  libraries  to be linked.  Names in the
  76.              file should be separated by white space or  newlines.    cc
  77.              will always use this option.
  78.  
  79.          -o  <file>
  80.              By  default,  the  name of the executable file is  'a.out'.
  81.              This option allows a different name to be specified.
  82.  
  83.          -u  <symbol>
  84.              Forces ld to link the symbol  <symbol> at  once  if  it  is
  85.              found in any library module.
  86.              The given  symbol is marked as undefined.  This can be use-
  87.              ful when linking  from  libraries.    And  a  symbol  (e.g.
  88.              __printf)  can  be  marked as undefined to force loading it
  89.              from a library, before another module  (e.g.  from  another
  90.              library) asks for it.
  91.  
  92.          -b 
  93.              This  option  can  be  used  when linking large programs to
  94.              reduce the amount of memory used by the loader.  The loader
  95.              makes more disk accesses when this option is used.
  96.  
  97.          -M 
  98.          -m 
  99.              Print a load map.  (I've read anywhere -M is  standard?)  A
  100.              table  of all linked objects with their sizes is printed to
  101.              stdout.
  102.  
  103.         -L<path>
  104.              Add  path  to  the  search  list  to  find  following   (in
  105.              commandline) libraries  and  object  modules.    The pathes
  106.              specified with -L option are searched first, after cwd  and
  107.              before  builtin  or  $LIB pathes, in the order specified in
  108.              the commandline.
  109.  
  110.          --nofload 
  111.              Do not set Fastload flag in  program  header  of  generated
  112.              executable.
  113.  
  114.          --nofram 
  115.              Do  not  set  'load  to  FastRAM' flag in program header of
  116.              generated executable.
  117.  
  118.          --nofmem 
  119.              Do not set 'malloc from FastRAM' flag in program header  of
  120.              generated  executable.
  121.  
  122. ENVIRONMENT
  123.         $LIBDIR  This  path  replaces  the  builtin  search  pathes  for
  124.         libraries and object modules not to find in cwd.
  125.  
  126.         $LIB A list of pathes where libraries and object modules are  to
  127.  
  128.  
  129.  
  130. v 2.00x9                  Release: Jul 21 1994                    Page 2
  131.  
  132.  
  133.  
  134.  
  135. LD(1)                 Sozobon Programmer's Manual                  LD(1)
  136.  
  137.  
  138.  
  139.         search.   If  this  variable is specified the builtin pathes and
  140.         the  $LIBDIR path are ignored for searches.
  141.  
  142.         If  $STDERR is present, stderr handle (2) is used for diagnostic
  143.         output.
  144.  
  145. DIAGNOSTICS
  146.         Warnings:
  147.         message:
  148.         Double def of <sym>: in <module (archive)> type <char>,
  149.                         in <module (archive)> type <char>
  150.         
  151.         Tells you that symbol <sym> is defined in the two named modules,
  152.         the second module name is the first definition. The type char
  153.         [Text|Data|Bss|Common|?] tells you the symbols' type in the module.
  154.         
  155.         If a symbol is already defined, the first definition is used.
  156.         
  157.         message:
  158.         Common sizes differ: <sym> in <module (archive)> <size>,
  159.                                 in <module (archive)> <size>
  160.         
  161.         Tells you, that Common symbol <sym> is defined with different sizes
  162.         in different modules.
  163.         The larger size will be used for that symbol.
  164.         ErrorMessages:
  165.         message:
  166.         Undef <sym> from <module (archive)>
  167.         
  168.         The symbol <sym>, used in <module> (maybe in others, too) isn't
  169.         defined in any specified module. (No output!)
  170.         
  171.         message:
  172.         Undef Common <sym> from <module (archive)>
  173.         
  174.         The Common symbol <sym> is never defined with a length value.
  175.         (No output is generated!);
  176.  
  177. LIMITS
  178.         The number of handled files, objects and symbols is still limited:
  179.         60 different files
  180.         1000 global symbols in resulting object (executable)
  181.         400 symbols in every object module
  182.         400 objects in every library
  183.         300 objects currently used
  184.  
  185. SEE ALSO
  186.         cc(1), nm(1), ar(1), liborder(1)
  187.  
  188. BUGS
  189.         Without doubt, there are some bugs in  this  program.    If  you
  190.         discover one, please report it to maintainer.
  191.  
  192.  
  193.  
  194.  
  195.  
  196. v 2.00x9                  Release: Jul 21 1994                    Page 3
  197.  
  198.  
  199.  
  200.  
  201. LD(1)                 Sozobon Programmer's Manual                  LD(1)
  202.  
  203.  
  204.  
  205. AUTHOR
  206.         Written by Johann Ruegg, Copyright (c) 1988,89,90,91 by Sozobon,
  207.         Ltd.
  208.  
  209.         eXtended Version by Holger Weets, Jerry G Geiger (1992-1994)
  210.  
  211. VERSION
  212.         ld V2.00x9 Jul 21 1994
  213.  
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262. v 2.00x9                  Release: Jul 21 1994                    Page 4
  263.  
  264.  
  265.