2l 4.0 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193
  1. .TH 2L 1
  2. .SH NAME
  3. 0l, 1l, 2l, 4l, 5l, 6l, 7l, 8l, 9l, kl, ql, vl, xl \- loaders
  4. .SH SYNOPSIS
  5. .B 2l
  6. [
  7. .I option ...
  8. ]
  9. [
  10. .I file ...
  11. ]
  12. .br
  13. etc.
  14. .SH DESCRIPTION
  15. These commands
  16. load the named
  17. .I files
  18. into executable files for the corresponding architectures; see
  19. .IR 2c (1)
  20. for the correspondence between an architecture and the character
  21. .RB ( 0 ,
  22. .RB 1 ,
  23. etc.) that specifies it.
  24. The files should be object files or libraries (archives of object files)
  25. for the appropriate architecture.
  26. Also, a name like
  27. .BI -l ext
  28. represents the library
  29. .BI lib ext .a
  30. in
  31. .BR /$objtype/lib ,
  32. where
  33. .I objtype
  34. is one of
  35. .BR 68000 ,
  36. etc. as listed in
  37. .IR 2c (1).
  38. The libraries must have tables of contents
  39. (see
  40. .IR ar (1)).
  41. .PP
  42. In practice,
  43. .B -l
  44. options are rarely necessary as the header files for
  45. the libraries cause their archives to be included automatically in the load
  46. (see
  47. .IR 2c (1)).
  48. For example, any program that includes header file
  49. .B libc.h
  50. causes the loader
  51. to search the C library
  52. .BR /$objtype/lib/libc.a .
  53. Also, the loader creates an undefined symbol
  54. .B _main
  55. (or
  56. .B _mainp
  57. if profiling is enabled) to force loading of the
  58. startup linkage from the C library.
  59. .PP
  60. The order of search to resolve undefined symbols is to load all files and libraries
  61. mentioned explicitly on the command line, and then to resolve remaining symbols
  62. by searching in topological order
  63. libraries mentioned in header files included by files already loaded.
  64. When scanning such libraries, the algorithm is to scan each library repeatedly until
  65. no new undefined symbols are picked up, then to start on the next library. Thus if library
  66. .I A
  67. needs
  68. .I B
  69. which needs
  70. .I A
  71. again, it may be necessary to mention
  72. .I A
  73. explicitly so it will be read a second time.
  74. .PP
  75. The loader options are:
  76. .TP 1i
  77. .B -l
  78. (As a bare option.)
  79. Suppress the default loading of the startup linkage and libraries
  80. specified by header files.
  81. .TP
  82. .BI -o " out"
  83. Place output in file
  84. .IR out .
  85. Default is
  86. .IB O .out\f1,
  87. where
  88. .I O
  89. is the first letter of the loader name.
  90. .TP
  91. .B -p
  92. Insert profiling code into the executable output; no special action is needed
  93. during compilation or assembly.
  94. .TP
  95. .B -s
  96. Strip the symbol tables from the output file.
  97. .TP
  98. .B -a
  99. Print the object code in assembly language, with addresses.
  100. .TP
  101. .B -v
  102. Print debugging output that annotates the activities of the load.
  103. .TP
  104. .BI -c function
  105. .RI ( Xl
  106. only) Place the
  107. .I function
  108. in the internal RAM of the DSP3210.
  109. .TP
  110. .BI -M
  111. .RI ( Kl
  112. only) Generate instructions rather than calls to emulation routines
  113. for multiply and divide.
  114. .TP
  115. .BI -m size
  116. .RI ( Xl
  117. only) Use
  118. .I size
  119. (default 0, maximum 8192)
  120. bytes of internal RAM of the DSP3210 for functions and small data items.
  121. .TP
  122. .BI -E symbol
  123. The entry point for the binary is
  124. .I symbol
  125. (default
  126. .BR _main ;
  127. .B _mainp
  128. under
  129. .BR -p ).
  130. .TP
  131. .BI -H n
  132. Executable header is type
  133. .IR n .
  134. The meaning of the types is architecture-dependent; typically
  135. type 1 is Plan 9 boot format and type 2 is the
  136. regular Plan 9 format, the default. These are reversed on the MIPS.
  137. The Next boot format is 3. Type 4 in
  138. .I vl
  139. creates a MIPS executable for an SGI Unix system.
  140. .TP
  141. .BI -T t
  142. The text segment starts at address
  143. .IR t .
  144. .TP
  145. .BI -D d
  146. The data segment starts at address
  147. .IR d .
  148. .TP
  149. .BI -R r
  150. The text segment is rounded to a multiple of
  151. .I r
  152. (if
  153. .I r
  154. is nonzero).
  155. .PP
  156. The numbers in the above options can begin with
  157. .L 0x
  158. or
  159. .L 0
  160. to change the default base from decimal to hexadecimal or octal.
  161. The defaults for the values depend on the compiler and the
  162. header type.
  163. .PP
  164. The loaded image has several symbols inserted by the loader:
  165. .B etext
  166. is the address of the end of the text segment;
  167. .B bdata
  168. is the address of the beginning of the data segment;
  169. .B edata
  170. is the address of the end of the data segment;
  171. and
  172. .B end
  173. is the address of the end of the bss segment, and of the program.
  174. .SH FILES
  175. .TF /$objtype/lib
  176. .TP
  177. .B /$objtype/lib
  178. for
  179. .BI -l lib
  180. arguments.
  181. .SH SOURCE
  182. .B /sys/src/cmd/2l
  183. etc.
  184. .SH "SEE ALSO"
  185. .IR 2c (1),
  186. .IR 2a (1),
  187. .IR ar (1),
  188. .IR nm (1),
  189. .IR db (1),
  190. .IR prof (1)
  191. .PP
  192. Rob Pike,
  193. ``How to Use the Plan 9 C Compiler''