开通博客赚积分
发布资源赚积分
分类

源码开发语言/平台
当前位置：首页 > 源码/资料 > 嵌入式/单片机编程 > 嵌入式Linux > 查看源码
arm-linux-objcopy.1
资源名称：arm_cross-3.4.4.tar.gz　[点击查看]
上传用户：szlgq88
上传日期：2009-04-28
资源大小：48287k
文件大小：32k
源码类别：

嵌入式Linux

开发平台：

Unix_Linux

arm-linux-objcopy.1：源码内容
  1. ." Automatically generated by Pod::Man v1.37, Pod::Parser v1.14
  2. ."
  3. ." Standard preamble:
  4. ." ========================================================================
  5. .de Sh " Subsection heading
  6. .br
  7. .if t .Sp
  8. .ne 5
  9. .PP
  10. fB\$1fR
  11. .PP
  12. ..
  13. .de Sp " Vertical space (when we can't use .PP)
  14. .if t .sp .5v
  15. .if n .sp
  16. ..
  17. .de Vb " Begin verbatim text
  18. .ft CW
  19. .nf
  20. .ne \$1
  21. ..
  22. .de Ve " End verbatim text
  23. .ft R
  24. .fi
  25. ..
  26. ." Set up some character translations and predefined strings.  *(-- will
  27. ." give an unbreakable dash, *(PI will give pi, *(L" will give a left
  28. ." double quote, and *(R" will give a right double quote.  | will give a
  29. ." real vertical bar.  *(C+ will give a nicer C++.  Capital omega is used to
  30. ." do unbreakable dashes and therefore won't be available.  *(C` and *(C'
  31. ." expand to `' in nroff, nothing in troff, for use with C<>.
  32. .tr (*W-|(bv*(Tr
  33. .ds C+ Cv'-.1v'h'-1p's-2+h'-1p'+s0v'.1v'h'-1p'
  34. .ie n {
  35. .    ds -- (*W-
  36. .    ds PI pi
  37. .    if (n(.H=4u)&(1m=24u) .ds -- (*Wh'-12u'(*Wh'-12u'-" diablo 10 pitch
  38. .    if (n(.H=4u)&(1m=20u) .ds -- (*Wh'-12u'(*Wh'-8u'-"  diablo 12 pitch
  39. .    ds L" ""
  40. .    ds R" ""
  41. .    ds C` ""
  42. .    ds C' ""
  43. 'br}
  44. .el{
  45. .    ds -- |(em|
  46. .    ds PI (*p
  47. .    ds L" ``
  48. .    ds R" ''
  49. 'br}
  50. ."
  51. ." If the F register is turned on, we'll generate index entries on stderr for
  52. ." titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and index
  53. ." entries marked with X<> in POD.  Of course, you'll have to process the
  54. ." output yourself in some meaningful fashion.
  55. .if nF {
  56. .    de IX
  57. .    tm Index:\$1t\n%t"\$2"
  58. ..
  59. .    nr % 0
  60. .    rr F
  61. .}
  62. ."
  63. ." For nroff, turn off justification.  Always turn off hyphenation; it makes
  64. ." way too many mistakes in technical documents.
  65. .hy 0
  66. ."
  67. ." Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
  68. ." Fear.  Run.  Save yourself.  No user-serviceable parts.
  69. .    " fudge factors for nroff and troff
  70. .if n {
  71. .    ds #H 0
  72. .    ds #V .8m
  73. .    ds #F .3m
  74. .    ds #[ f1
  75. .    ds #] fP
  76. .}
  77. .if t {
  78. .    ds #H ((1u-(\\n(.fu%2u))*.13m)
  79. .    ds #V .6m
  80. .    ds #F 0
  81. .    ds #[ &
  82. .    ds #] &
  83. .}
  84. .    " simple accents for nroff and troff
  85. .if n {
  86. .    ds ' &
  87. .    ds ` &
  88. .    ds ^ &
  89. .    ds , &
  90. .    ds ~ ~
  91. .    ds /
  92. .}
  93. .if t {
  94. .    ds ' \k:h'-(\n(.wu*8/10-*(#H)''h"|\n:u"
  95. .    ds ` \k:h'-(\n(.wu*8/10-*(#H)'`h'|\n:u'
  96. .    ds ^ \k:h'-(\n(.wu*10/11-*(#H)'^h'|\n:u'
  97. .    ds , \k:h'-(\n(.wu*8/10)',h'|\n:u'
  98. .    ds ~ \k:h'-(\n(.wu-*(#H-.1m)'~h'|\n:u'
  99. .    ds / \k:h'-(\n(.wu*8/10-*(#H)'z(slh'|\n:u'
  100. .}
  101. .    " troff and (daisy-wheel) nroff accents
  102. .ds : \k:h'-(\n(.wu*8/10-*(#H+.1m+*(#F)'v'-*(#V'z.h'.2m+*(#F'.h'|\n:u'v'*(#V'
  103. .ds 8 h'*(#H'(*bh'-*(#H'
  104. .ds o \k:h'-(\n(.wu+w'(de'u-*(#H)/2u'v'-.3n'*(#[z(dev'.3n'h'|\n:u'*(#]
  105. .ds d- h'*(#H'(pdh'-w'~'u'v'-.25m'f2(hyfPv'.25m'h'-*(#H'
  106. .ds D- D\k:h'-w'D'u'v'-.11m'z(hyv'.11m'h'|\n:u'
  107. .ds th *(#[v'.3m's+1Is-1v'-.3m'h'-(w'I'u*2/3)'s-1os+1*(#]
  108. .ds Th *(#[s+2Is-2h'-w'I'u*3/5'v'-.3m'ov'.3m'*(#]
  109. .ds ae ah'-(w'a'u*4/10)'e
  110. .ds Ae Ah'-(w'A'u*4/10)'E
  111. .    " corrections for vroff
  112. .if v .ds ~ \k:h'-(\n(.wu*9/10-*(#H)'s-2u~ds+2h'|\n:u'
  113. .if v .ds ^ \k:h'-(\n(.wu*10/11-*(#H)'v'-.4m'^v'.4m'h'|\n:u'
  114. .    " for low resolution devices (crt and lpr)
  115. .if n(.H>23 .if n(.V>19 
  116. {
  117. .    ds : e
  118. .    ds 8 ss
  119. .    ds o a
  120. .    ds d- dh'-1'(ga
  121. .    ds D- Dh'-1'(hy
  122. .    ds th o'bp'
  123. .    ds Th o'LP'
  124. .    ds ae ae
  125. .    ds Ae AE
  126. .}
  127. .rm #[ #] #H #V #F C
  128. ." ========================================================================
  129. ."
  130. .IX Title "OBJCOPY 1"
  131. .TH OBJCOPY 1 "2005-04-20" "binutils-2.15.97" "GNU Development Tools"
  132. .SH "NAME"
  133. objcopy - copy and translate object files
  134. .SH "SYNOPSIS"
  135. .IX Header "SYNOPSIS"
  136. objcopy [fB-FfR fIbfdnamefR|fB--target=fRfIbfdnamefR]
  137.         [fB-IfR fIbfdnamefR|fB--input-target=fRfIbfdnamefR]
  138.         [fB-OfR fIbfdnamefR|fB--output-target=fRfIbfdnamefR]
  139.         [fB-BfR fIbfdarchfR|fB--binary-architecture=fRfIbfdarchfR]
  140.         [fB-SfR|fB--strip-allfR]
  141.         [fB-gfR|fB--strip-debugfR]
  142.         [fB-KfR fIsymbolnamefR|fB--keep-symbol=fRfIsymbolnamefR]
  143.         [fB-NfR fIsymbolnamefR|fB--strip-symbol=fRfIsymbolnamefR]
  144.         [fB--strip-unneeded-symbol=fRfIsymbolnamefR]
  145.         [fB-GfR fIsymbolnamefR|fB--keep-global-symbol=fRfIsymbolnamefR]
  146.         [fB-LfR fIsymbolnamefR|fB--localize-symbol=fRfIsymbolnamefR]
  147.         [fB-WfR fIsymbolnamefR|fB--weaken-symbol=fRfIsymbolnamefR]
  148.         [fB-wfR|fB--wildcardfR]
  149.         [fB-xfR|fB--discard-allfR]
  150.         [fB-XfR|fB--discard-localsfR]
  151.         [fB-bfR fIbytefR|fB--byte=fRfIbytefR]
  152.         [fB-ifR fIinterleavefR|fB--interleave=fRfIinterleavefR]
  153.         [fB-jfR fIsectionnamefR|fB--only-section=fRfIsectionnamefR]
  154.         [fB-RfR fIsectionnamefR|fB--remove-section=fRfIsectionnamefR]
  155.         [fB-pfR|fB--preserve-datesfR]
  156.         [fB--debuggingfR]
  157.         [fB--gap-fill=fRfIvalfR]
  158.         [fB--pad-to=fRfIaddressfR]
  159.         [fB--set-start=fRfIvalfR]
  160.         [fB--adjust-start=fRfIincrfR]
  161.         [fB--change-addresses=fRfIincrfR]
  162.         [fB--change-section-addressfR fIsectionfR{=,+,-}fIvalfR]
  163.         [fB--change-section-lmafR fIsectionfR{=,+,-}fIvalfR]
  164.         [fB--change-section-vmafR fIsectionfR{=,+,-}fIvalfR]
  165.         [fB--change-warningsfR] [fB--no-change-warningsfR]
  166.         [fB--set-section-flagsfR fIsectionfR=fIflagsfR]
  167.         [fB--add-sectionfR fIsectionnamefR=fIfilenamefR]
  168.         [fB--rename-sectionfR fIoldnamefR=fInewnamefR[,fIflagsfR]]
  169.         [fB--change-leading-charfR] [fB--remove-leading-charfR]
  170.         [fB--srec-len=fRfIivalfR] [fB--srec-forceS3fR]
  171.         [fB--redefine-symfR fIoldfR=fInewfR]
  172.         [fB--redefine-syms=fRfIfilenamefR]
  173.         [fB--weakenfR]
  174.         [fB--keep-symbols=fRfIfilenamefR]
  175.         [fB--strip-symbols=fRfIfilenamefR]
  176.         [fB--strip-unneeded-symbols=fRfIfilenamefR]
  177.         [fB--keep-global-symbols=fRfIfilenamefR]
  178.         [fB--localize-symbols=fRfIfilenamefR]
  179.         [fB--weaken-symbols=fRfIfilenamefR]
  180.         [fB--alt-machine-code=fRfIindexfR]
  181.         [fB--prefix-symbols=fRfIstringfR]
  182.         [fB--prefix-sections=fRfIstringfR]
  183.         [fB--prefix-alloc-sections=fRfIstringfR]
  184.         [fB--add-gnu-debuglink=fRfIpath-to-filefR]
  185.         [fB--only-keep-debugfR]
  186.         [fB--writable-textfR]
  187.         [fB--readonly-textfR]
  188.         [fB--purefR]
  189.         [fB--impurefR]
  190.         [fB-vfR|fB--verbosefR]
  191.         [fB-VfR|fB--versionfR]  
  192.         [fB--helpfR] [fB--infofR]
  193.         fIinfilefR [fIoutfilefR]
  194. .SH "DESCRIPTION"
  195. .IX Header "DESCRIPTION"
  196. The s-1GNUs0 fBobjcopyfR utility copies the contents of an object
  197. file to another.  fBobjcopyfR uses the s-1GNUs0 s-1BFDs0 Library to
  198. read and write the object files.  It can write the destination object
  199. file in a format different from that of the source object file.  The
  200. exact behavior of fBobjcopyfR is controlled by command-line options.
  201. Note that fBobjcopyfR should be able to copy a fully linked file
  202. between any two formats. However, copying a relocatable object file
  203. between any two formats may not work as expected.
  204. .PP
  205. &fBobjcopyfR creates temporary files to do its translations and
  206. deletes them afterward.  fBobjcopyfR uses s-1BFDs0 to do all its
  207. translation work; it has access to all the formats described in s-1BFDs0
  208. and thus is able to recognize most formats without being told
  209. explicitly.  
  210. .PP
  211. &fBobjcopyfR can be used to generate S-records by using an output
  212. target of fBsrecfR (e.g., use fB-O srecfR).
  213. .PP
  214. &fBobjcopyfR can be used to generate a raw binary file by using an
  215. output target of fBbinaryfR (e.g., use fB-O binaryfR).  When
  216. &fBobjcopyfR generates a raw binary file, it will essentially produce
  217. a memory dump of the contents of the input object file.  All symbols and
  218. relocation information will be discarded.  The memory dump will start at
  219. the load address of the lowest section copied into the output file.
  220. .PP
  221. When generating an S-record or a raw binary file, it may be helpful to
  222. use fB-SfR to remove sections containing debugging information.  In
  223. some cases fB-RfR will be useful to remove sections which contain
  224. information that is not needed by the binary file.
  225. .PP
  226. Note---fBobjcopyfR is not able to change the endianness of its input
  227. files.  If the input format has an endianness (some formats do not),
  228. &fBobjcopyfR can only copy the inputs into file formats that have the
  229. same endianness or which have no endianness (e.g., fBsrecfR).
  230. .SH "OPTIONS"
  231. .IX Header "OPTIONS"
  232. .IP "fIinfilefR" 4
  233. .IX Item "infile"
  234. .PD 0
  235. .IP "fIoutfilefR" 4
  236. .IX Item "outfile"
  237. .PD
  238. The input and output files, respectively.
  239. If you do not specify fIoutfilefR, fBobjcopyfR creates a
  240. temporary file and destructively renames the result with
  241. the name of fIinfilefR.
  242. .IP "fB-IfR fIbfdnamefR" 4
  243. .IX Item "-I bfdname"
  244. .PD 0
  245. .IP "fB--input-target=fRfIbfdnamefR" 4
  246. .IX Item "--input-target=bfdname"
  247. .PD
  248. Consider the source file's object format to be fIbfdnamefR, rather than
  249. attempting to deduce it.  
  250. .IP "fB-OfR fIbfdnamefR" 4
  251. .IX Item "-O bfdname"
  252. .PD 0
  253. .IP "fB--output-target=fRfIbfdnamefR" 4
  254. .IX Item "--output-target=bfdname"
  255. .PD
  256. Write the output file using the object format fIbfdnamefR.
  257. .IP "fB-FfR fIbfdnamefR" 4
  258. .IX Item "-F bfdname"
  259. .PD 0
  260. .IP "fB--target=fRfIbfdnamefR" 4
  261. .IX Item "--target=bfdname"
  262. .PD
  263. Use fIbfdnamefR as the object format for both the input and the output
  264. file; i.e., simply transfer data from source to destination with no
  265. translation.  
  266. .IP "fB-BfR fIbfdarchfR" 4
  267. .IX Item "-B bfdarch"
  268. .PD 0
  269. .IP "fB--binary-architecture=fRfIbfdarchfR" 4
  270. .IX Item "--binary-architecture=bfdarch"
  271. .PD
  272. Useful when transforming a raw binary input file into an object file.
  273. In this case the output architecture can be set to fIbfdarchfR. This
  274. option will be ignored if the input file has a known fIbfdarchfR. You
  275. can access this binary data inside a program by referencing the special
  276. symbols that are created by the conversion process.  These symbols are
  277. called _binary_fIobjfilefR_start, _binary_fIobjfilefR_end and
  278. _binary_fIobjfilefR_size.  e.g. you can transform a picture file into
  279. an object file and then access it in your code using these symbols. 
  280. .IP "fB-jfR fIsectionnamefR" 4
  281. .IX Item "-j sectionname"
  282. .PD 0
  283. .IP "fB--only-section=fRfIsectionnamefR" 4
  284. .IX Item "--only-section=sectionname"
  285. .PD
  286. Copy only the named section from the input file to the output file.
  287. This option may be given more than once.  Note that using this option
  288. inappropriately may make the output file unusable.
  289. .IP "fB-RfR fIsectionnamefR" 4
  290. .IX Item "-R sectionname"
  291. .PD 0
  292. .IP "fB--remove-section=fRfIsectionnamefR" 4
  293. .IX Item "--remove-section=sectionname"
  294. .PD
  295. Remove any section named fIsectionnamefR from the output file.  This
  296. option may be given more than once.  Note that using this option
  297. inappropriately may make the output file unusable.
  298. .IP "fB-SfR" 4
  299. .IX Item "-S"
  300. .PD 0
  301. .IP "fB--strip-allfR" 4
  302. .IX Item "--strip-all"
  303. .PD
  304. Do not copy relocation and symbol information from the source file.
  305. .IP "fB-gfR" 4
  306. .IX Item "-g"
  307. .PD 0
  308. .IP "fB--strip-debugfR" 4
  309. .IX Item "--strip-debug"
  310. .PD
  311. Do not copy debugging symbols or sections from the source file.
  312. .IP "fB--strip-unneededfR" 4
  313. .IX Item "--strip-unneeded"
  314. Strip all symbols that are not needed for relocation processing.
  315. .IP "fB-KfR fIsymbolnamefR" 4
  316. .IX Item "-K symbolname"
  317. .PD 0
  318. .IP "fB--keep-symbol=fRfIsymbolnamefR" 4
  319. .IX Item "--keep-symbol=symbolname"
  320. .PD
  321. Copy only symbol fIsymbolnamefR from the source file.  This option may
  322. be given more than once.
  323. .IP "fB-NfR fIsymbolnamefR" 4
  324. .IX Item "-N symbolname"
  325. .PD 0
  326. .IP "fB--strip-symbol=fRfIsymbolnamefR" 4
  327. .IX Item "--strip-symbol=symbolname"
  328. .PD
  329. Do not copy symbol fIsymbolnamefR from the source file.  This option
  330. may be given more than once.
  331. .IP "fB--strip-unneeded-symbol=fRfIsymbolnamefR" 4
  332. .IX Item "--strip-unneeded-symbol=symbolname"
  333. Do not copy symbol fIsymbolnamefR from the source file unless it is needed
  334. by a relocation.  This option may be given more than once.
  335. .IP "fB-GfR fIsymbolnamefR" 4
  336. .IX Item "-G symbolname"
  337. .PD 0
  338. .IP "fB--keep-global-symbol=fRfIsymbolnamefR" 4
  339. .IX Item "--keep-global-symbol=symbolname"
  340. .PD
  341. Keep only symbol fIsymbolnamefR global.  Make all other symbols local
  342. to the file, so that they are not visible externally.  This option may
  343. be given more than once.
  344. .IP "fB-LfR fIsymbolnamefR" 4
  345. .IX Item "-L symbolname"
  346. .PD 0
  347. .IP "fB--localize-symbol=fRfIsymbolnamefR" 4
  348. .IX Item "--localize-symbol=symbolname"
  349. .PD
  350. Make symbol fIsymbolnamefR local to the file, so that it is not
  351. visible externally.  This option may be given more than once.
  352. .IP "fB-WfR fIsymbolnamefR" 4
  353. .IX Item "-W symbolname"
  354. .PD 0
  355. .IP "fB--weaken-symbol=fRfIsymbolnamefR" 4
  356. .IX Item "--weaken-symbol=symbolname"
  357. .PD
  358. Make symbol fIsymbolnamefR weak. This option may be given more than once.
  359. .IP "fB-wfR" 4
  360. .IX Item "-w"
  361. .PD 0
  362. .IP "fB--wildcardfR" 4
  363. .IX Item "--wildcard"
  364. .PD
  365. Permit regular expressions in fIsymbolnamefRs used in other command
  366. line options.  The question mark (?), asterisk (*), backslash (e) and
  367. square brackets ([]) operators can be used anywhere in the symbol
  368. name.  If the first character of the symbol name is the exclamation
  369. point (!) then the sense of the switch is reversed for that symbol.
  370. For example:
  371. .Sp
  372. .Vb 1
  373. &          -w -W !foo -W fo*
  374. .Ve
  375. .Sp
  376. would cause objcopy to weaken all symbols that start with ``fo''
  377. except for the symbol ``foo''.
  378. .IP "fB-xfR" 4
  379. .IX Item "-x"
  380. .PD 0
  381. .IP "fB--discard-allfR" 4
  382. .IX Item "--discard-all"
  383. .PD
  384. Do not copy non-global symbols from the source file.
  385. .IP "fB-XfR" 4
  386. .IX Item "-X"
  387. .PD 0
  388. .IP "fB--discard-localsfR" 4
  389. .IX Item "--discard-locals"
  390. .PD
  391. Do not copy compiler-generated local symbols.
  392. (These usually start with fBLfR or fB.fR.)
  393. .IP "fB-bfR fIbytefR" 4
  394. .IX Item "-b byte"
  395. .PD 0
  396. .IP "fB--byte=fRfIbytefR" 4
  397. .IX Item "--byte=byte"
  398. .PD
  399. Keep only every fIbytefRth byte of the input file (header data is not
  400. affected).  fIbytefR can be in the range from 0 to fIinterleavefR-1,
  401. where fIinterleavefR is given by the fB-ifR or fB--interleavefR
  402. option, or the default of 4.  This option is useful for creating files
  403. to program s-1ROMs0.  It is typically used with an f(CW*(C`srec*(C'fR output
  404. target.
  405. .IP "fB-ifR fIinterleavefR" 4
  406. .IX Item "-i interleave"
  407. .PD 0
  408. .IP "fB--interleave=fRfIinterleavefR" 4
  409. .IX Item "--interleave=interleave"
  410. .PD
  411. Only copy one out of every fIinterleavefR bytes.  Select which byte to
  412. copy with the fB-bfR or fB--bytefR option.  The default is 4.
  413. &fBobjcopyfR ignores this option if you do not specify either fB-bfR or
  414. &fB--bytefR.
  415. .IP "fB-pfR" 4
  416. .IX Item "-p"
  417. .PD 0
  418. .IP "fB--preserve-datesfR" 4
  419. .IX Item "--preserve-dates"
  420. .PD
  421. Set the access and modification dates of the output file to be the same
  422. as those of the input file.
  423. .IP "fB--debuggingfR" 4
  424. .IX Item "--debugging"
  425. Convert debugging information, if possible.  This is not the default
  426. because only certain debugging formats are supported, and the
  427. conversion process can be time consuming.
  428. .IP "fB--gap-fillfR fIvalfR" 4
  429. .IX Item "--gap-fill val"
  430. Fill gaps between sections with fIvalfR.  This operation applies to
  431. the fIload addressfR (s-1LMAs0) of the sections.  It is done by increasing
  432. the size of the section with the lower address, and filling in the extra
  433. space created with fIvalfR.
  434. .IP "fB--pad-tofR fIaddressfR" 4
  435. .IX Item "--pad-to address"
  436. Pad the output file up to the load address fIaddressfR.  This is
  437. done by increasing the size of the last section.  The extra space is
  438. filled in with the value specified by fB--gap-fillfR (default zero).
  439. .IP "fB--set-startfR fIvalfR" 4
  440. .IX Item "--set-start val"
  441. Set the start address of the new file to fIvalfR.  Not all object file
  442. formats support setting the start address.
  443. .IP "fB--change-startfR fIincrfR" 4
  444. .IX Item "--change-start incr"
  445. .PD 0
  446. .IP "fB--adjust-startfR fIincrfR" 4
  447. .IX Item "--adjust-start incr"
  448. .PD
  449. Change the start address by adding fIincrfR.  Not all object file
  450. formats support setting the start address.
  451. .IP "fB--change-addressesfR fIincrfR" 4
  452. .IX Item "--change-addresses incr"
  453. .PD 0
  454. .IP "fB--adjust-vmafR fIincrfR" 4
  455. .IX Item "--adjust-vma incr"
  456. .PD
  457. Change the s-1VMAs0 and s-1LMAs0 addresses of all sections, as well as the start
  458. address, by adding fIincrfR.  Some object file formats do not permit
  459. section addresses to be changed arbitrarily.  Note that this does not
  460. relocate the sections; if the program expects sections to be loaded at a
  461. certain address, and this option is used to change the sections such
  462. that they are loaded at a different address, the program may fail. 
  463. .IP "fB--change-section-addressfR fIsectionfRfB{=,+,-}fRfIvalfR" 4
  464. .IX Item "--change-section-address section{=,+,-}val"
  465. .PD 0
  466. .IP "fB--adjust-section-vmafR fIsectionfRfB{=,+,-}fRfIvalfR" 4
  467. .IX Item "--adjust-section-vma section{=,+,-}val"
  468. .PD
  469. Set or change both the s-1VMAs0 address and the s-1LMAs0 address of the named
  470. &fIsectionfR.  If fB=fR is used, the section address is set to
  471. &fIvalfR.  Otherwise, fIvalfR is added to or subtracted from the
  472. section address.  See the comments under fB--change-addressesfR,
  473. above. If fIsectionfR does not exist in the input file, a warning will
  474. be issued, unless fB--no-change-warningsfR is used.
  475. .IP "fB--change-section-lmafR fIsectionfRfB{=,+,-}fRfIvalfR" 4
  476. .IX Item "--change-section-lma section{=,+,-}val"
  477. Set or change the s-1LMAs0 address of the named fIsectionfR.  The s-1LMAs0
  478. address is the address where the section will be loaded into memory at
  479. program load time.  Normally this is the same as the s-1VMAs0 address, which
  480. is the address of the section at program run time, but on some systems,
  481. especially those where a program is held in s-1ROMs0, the two can be
  482. different.  If fB=fR is used, the section address is set to
  483. &fIvalfR.  Otherwise, fIvalfR is added to or subtracted from the
  484. section address.  See the comments under fB--change-addressesfR,
  485. above.  If fIsectionfR does not exist in the input file, a warning
  486. will be issued, unless fB--no-change-warningsfR is used.  
  487. .IP "fB--change-section-vmafR fIsectionfRfB{=,+,-}fRfIvalfR" 4
  488. .IX Item "--change-section-vma section{=,+,-}val"
  489. Set or change the s-1VMAs0 address of the named fIsectionfR.  The s-1VMAs0
  490. address is the address where the section will be located once the
  491. program has started executing.  Normally this is the same as the s-1LMAs0
  492. address, which is the address where the section will be loaded into
  493. memory, but on some systems, especially those where a program is held in
  494. &s-1ROMs0, the two can be different.  If fB=fR is used, the section address
  495. is set to fIvalfR.  Otherwise, fIvalfR is added to or subtracted
  496. from the section address.  See the comments under
  497. &fB--change-addressesfR, above.  If fIsectionfR does not exist in
  498. the input file, a warning will be issued, unless
  499. &fB--no-change-warningsfR is used.   
  500. .IP "fB--change-warningsfR" 4
  501. .IX Item "--change-warnings"
  502. .PD 0
  503. .IP "fB--adjust-warningsfR" 4
  504. .IX Item "--adjust-warnings"
  505. .PD
  506. If fB--change-section-addressfR or fB--change-section-lmafR or
  507. &fB--change-section-vmafR is used, and the named section does not
  508. exist, issue a warning.  This is the default. 
  509. .IP "fB--no-change-warningsfR" 4
  510. .IX Item "--no-change-warnings"
  511. .PD 0
  512. .IP "fB--no-adjust-warningsfR" 4
  513. .IX Item "--no-adjust-warnings"
  514. .PD
  515. Do not issue a warning if fB--change-section-addressfR or
  516. &fB--adjust-section-lmafR or fB--adjust-section-vmafR is used, even
  517. if the named section does not exist. 
  518. .IP "fB--set-section-flagsfR fIsectionfRfB=fRfIflagsfR" 4
  519. .IX Item "--set-section-flags section=flags"
  520. Set the flags for the named section.  The fIflagsfR argument is a
  521. comma separated string of flag names.  The recognized names are
  522. &fBallocfR, fBcontentsfR, fBloadfR, fBnoloadfR,
  523. &fBreadonlyfR, fBcodefR, fBdatafR, fBromfR, fBsharefR, and
  524. &fBdebugfR.  You can set the fBcontentsfR flag for a section which
  525. does not have contents, but it is not meaningful to clear the
  526. &fBcontentsfR flag of a section which does have contents*(--just remove
  527. the section instead.  Not all flags are meaningful for all object file
  528. formats.
  529. .IP "fB--add-sectionfR fIsectionnamefRfB=fRfIfilenamefR" 4
  530. .IX Item "--add-section sectionname=filename"
  531. Add a new section named fIsectionnamefR while copying the file.  The
  532. contents of the new section are taken from the file fIfilenamefR.  The
  533. size of the section will be the size of the file.  This option only
  534. works on file formats which can support sections with arbitrary names.
  535. .IP "fB--rename-sectionfR fIoldnamefRfB=fRfInewnamefRfB[,fRfIflagsfRfB]fR" 4
  536. .IX Item "--rename-section oldname=newname[,flags]"
  537. Rename a section from fIoldnamefR to fInewnamefR, optionally
  538. changing the section's flags to fIflagsfR in the process.  This has
  539. the advantage over usng a linker script to perform the rename in that
  540. the output stays as an object file and does not become a linked
  541. executable.
  542. .Sp
  543. This option is particularly helpful when the input format is binary,
  544. since this will always create a section called .data.  If for example,
  545. you wanted instead to create a section called .rodata containing binary
  546. data you could use the following command line to achieve it:
  547. .Sp
  548. .Vb 3
  549. &          objcopy -I binary -O <output_format> -B <architecture> e
  550. &           --rename-section .data=.rodata,alloc,load,readonly,data,contents e
  551. &           <input_binary_file> <output_object_file>
  552. .Ve
  553. .IP "fB--change-leading-charfR" 4
  554. .IX Item "--change-leading-char"
  555. Some object file formats use special characters at the start of
  556. symbols.  The most common such character is underscore, which compilers
  557. often add before every symbol.  This option tells fBobjcopyfR to
  558. change the leading character of every symbol when it converts between
  559. object file formats.  If the object file formats use the same leading
  560. character, this option has no effect.  Otherwise, it will add a
  561. character, or remove a character, or change a character, as
  562. appropriate.
  563. .IP "fB--remove-leading-charfR" 4
  564. .IX Item "--remove-leading-char"
  565. If the first character of a global symbol is a special symbol leading
  566. character used by the object file format, remove the character.  The
  567. most common symbol leading character is underscore.  This option will
  568. remove a leading underscore from all global symbols.  This can be useful
  569. if you want to link together objects of different file formats with
  570. different conventions for symbol names.  This is different from
  571. &fB--change-leading-charfR because it always changes the symbol name
  572. when appropriate, regardless of the object file format of the output
  573. file.
  574. .IP "fB--srec-len=fRfIivalfR" 4
  575. .IX Item "--srec-len=ival"
  576. Meaningful only for srec output.  Set the maximum length of the Srecords
  577. being produced to fIivalfR.  This length covers both address, data and
  578. crc fields.
  579. .IP "fB--srec-forceS3fR" 4
  580. .IX Item "--srec-forceS3"
  581. Meaningful only for srec output.  Avoid generation of S1/S2 records, 
  582. creating S3-only record format.
  583. .IP "fB--redefine-symfR fIoldfRfB=fRfInewfR" 4
  584. .IX Item "--redefine-sym old=new"
  585. Change the name of a symbol fIoldfR, to fInewfR.  This can be useful
  586. when one is trying link two things together for which you have no
  587. source, and there are name collisions.
  588. .IP "fB--redefine-syms=fRfIfilenamefR" 4
  589. .IX Item "--redefine-syms=filename"
  590. Apply fB--redefine-symfR to each symbol pair "fIoldfR fInewfR"
  591. listed in the file fIfilenamefR.  fIfilenamefR is simply a flat file,
  592. with one symbol pair per line.  Line comments may be introduced by the hash
  593. character.  This option may be given more than once.
  594. .IP "fB--weakenfR" 4
  595. .IX Item "--weaken"
  596. Change all global symbols in the file to be weak.  This can be useful
  597. when building an object which will be linked against other objects using
  598. the fB-RfR option to the linker.  This option is only effective when
  599. using an object file format which supports weak symbols.
  600. .IP "fB--keep-symbols=fRfIfilenamefR" 4
  601. .IX Item "--keep-symbols=filename"
  602. Apply fB--keep-symbolfR option to each symbol listed in the file
  603. &fIfilenamefR.  fIfilenamefR is simply a flat file, with one symbol
  604. name per line.  Line comments may be introduced by the hash character.
  605. This option may be given more than once.
  606. .IP "fB--strip-symbols=fRfIfilenamefR" 4
  607. .IX Item "--strip-symbols=filename"
  608. Apply fB--strip-symbolfR option to each symbol listed in the file
  609. &fIfilenamefR.  fIfilenamefR is simply a flat file, with one symbol
  610. name per line.  Line comments may be introduced by the hash character.
  611. This option may be given more than once.
  612. .IP "fB--strip-unneeded-symbols=fRfIfilenamefR" 4
  613. .IX Item "--strip-unneeded-symbols=filename"
  614. Apply fB--strip-unneeded-symbolfR option to each symbol listed in
  615. the file fIfilenamefR.  fIfilenamefR is simply a flat file, with one
  616. symbol name per line.  Line comments may be introduced by the hash
  617. character.  This option may be given more than once.
  618. .IP "fB--keep-global-symbols=fRfIfilenamefR" 4
  619. .IX Item "--keep-global-symbols=filename"
  620. Apply fB--keep-global-symbolfR option to each symbol listed in the
  621. file fIfilenamefR.  fIfilenamefR is simply a flat file, with one
  622. symbol name per line.  Line comments may be introduced by the hash
  623. character.  This option may be given more than once.
  624. .IP "fB--localize-symbols=fRfIfilenamefR" 4
  625. .IX Item "--localize-symbols=filename"
  626. Apply fB--localize-symbolfR option to each symbol listed in the file
  627. &fIfilenamefR.  fIfilenamefR is simply a flat file, with one symbol
  628. name per line.  Line comments may be introduced by the hash character.
  629. This option may be given more than once.
  630. .IP "fB--weaken-symbols=fRfIfilenamefR" 4
  631. .IX Item "--weaken-symbols=filename"
  632. Apply fB--weaken-symbolfR option to each symbol listed in the file
  633. &fIfilenamefR.  fIfilenamefR is simply a flat file, with one symbol
  634. name per line.  Line comments may be introduced by the hash character.
  635. This option may be given more than once.
  636. .IP "fB--alt-machine-code=fRfIindexfR" 4
  637. .IX Item "--alt-machine-code=index"
  638. If the output architecture has alternate machine codes, use the
  639. &fIindexfRth code instead of the default one.  This is useful in case
  640. a machine is assigned an official code and the tool-chain adopts the 
  641. new code, but other applications still depend on the original code
  642. being used.
  643. .IP "fB--writable-textfR" 4
  644. .IX Item "--writable-text"
  645. Mark the output text as writable.  This option isn't meaningful for all
  646. object file formats.
  647. .IP "fB--readonly-textfR" 4
  648. .IX Item "--readonly-text"
  649. Make the output text write protected.  This option isn't meaningful for all
  650. object file formats.
  651. .IP "fB--purefR" 4
  652. .IX Item "--pure"
  653. Mark the output file as demand paged.  This option isn't meaningful for all
  654. object file formats.
  655. .IP "fB--impurefR" 4
  656. .IX Item "--impure"
  657. Mark the output file as impure.  This option isn't meaningful for all
  658. object file formats.
  659. .IP "fB--prefix-symbols=fRfIstringfR" 4
  660. .IX Item "--prefix-symbols=string"
  661. Prefix all symbols in the output file with fIstringfR.
  662. .IP "fB--prefix-sections=fRfIstringfR" 4
  663. .IX Item "--prefix-sections=string"
  664. Prefix all section names in the output file with fIstringfR.
  665. .IP "fB--prefix-alloc-sections=fRfIstringfR" 4
  666. .IX Item "--prefix-alloc-sections=string"
  667. Prefix all the names of all allocated sections in the output file with
  668. &fIstringfR.
  669. .IP "fB--add-gnu-debuglink=fRfIpath-to-filefR" 4
  670. .IX Item "--add-gnu-debuglink=path-to-file"
  671. Creates a .gnu_debuglink section which contains a reference to fIpath-to-filefR
  672. and adds it to the output file.
  673. .IP "fB--only-keep-debugfR" 4
  674. .IX Item "--only-keep-debug"
  675. Strip a file, removing any sections that would be stripped by
  676. &fB--strip-debugfR and leaving the debugging sections.
  677. .Sp
  678. The intention is that this option will be used in conjunction with
  679. &fB--add-gnu-debuglinkfR to create a two part executable.  One a
  680. stripped binary which will occupy less space in s-1RAMs0 and in a
  681. distribution and the second a debugging information file which is only
  682. needed if debugging abilities are required.  The suggested procedure
  683. to create these files is as follows:
  684. .RS 4
  685. .IP "1.<Link the executable as normal.  Assuming that is is called>" 4
  686. .IX Item "1.<Link the executable as normal.  Assuming that is is called>"
  687. &f(CW*(C`foo*(C'fR then...
  688. .ie n .IP "1.<Run ""objcopy --only-keep-debug foo foo.dbg"" to>" 4
  689. .el .IP "1.<Run f(CWobjcopy --only-keep-debug foo foo.dbgfR to>" 4
  690. .IX Item "1.<Run objcopy --only-keep-debug foo foo.dbg to>"
  691. create a file containing the debugging info.
  692. .ie n .IP "1.<Run ""objcopy --strip-debug foo"" to create a>" 4
  693. .el .IP "1.<Run f(CWobjcopy --strip-debug foofR to create a>" 4
  694. .IX Item "1.<Run objcopy --strip-debug foo to create a>"
  695. stripped executable.
  696. .ie n .IP "1.<Run ""objcopy --add-gnu-debuglink=foo.dbg foo"">" 4
  697. .el .IP "1.<Run f(CWobjcopy --add-gnu-debuglink=foo.dbg foofR>" 4
  698. .IX Item "1.<Run objcopy --add-gnu-debuglink=foo.dbg foo>"
  699. to add a link to the debugging info into the stripped executable.
  700. .RE
  701. .RS 4
  702. .Sp
  703. Note - the choice of f(CW*(C`.dbg*(C'fR as an extension for the debug info
  704. file is arbitrary.  Also the f(CW*(C`--only-keep-debug*(C'fR step is
  705. optional.  You could instead do this:
  706. .IP "1.<Link the executable as normal.>" 4
  707. .IX Item "1.<Link the executable as normal.>"
  708. .PD 0
  709. .ie n .IP "1.<Copy ""foo""fR to  f(CW""foo.full"">" 4
  710. .el .IP "1.<Copy f(CWfoofR to  f(CWfoo.fullfR>" 4
  711. .IX Item "1.<Copy foo to  foo.full>"
  712. .ie n .IP "1.<Run ""objcopy --strip-debug foo"">" 4
  713. .el .IP "1.<Run f(CWobjcopy --strip-debug foofR>" 4
  714. .IX Item "1.<Run objcopy --strip-debug foo>"
  715. .ie n .IP "1.<Run ""objcopy --add-gnu-debuglink=foo.full foo"">" 4
  716. .el .IP "1.<Run f(CWobjcopy --add-gnu-debuglink=foo.full foofR>" 4
  717. .IX Item "1.<Run objcopy --add-gnu-debuglink=foo.full foo>"
  718. .RE
  719. .RS 4
  720. .PD
  721. .Sp
  722. ie the file pointed to by the fB--add-gnu-debuglinkfR can be the
  723. full executable.  It does not have to be a file created by the
  724. &fB--only-keep-debugfR switch.
  725. .RE
  726. .IP "fB-VfR" 4
  727. .IX Item "-V"
  728. .PD 0
  729. .IP "fB--versionfR" 4
  730. .IX Item "--version"
  731. .PD
  732. Show the version number of fBobjcopyfR.
  733. .IP "fB-vfR" 4
  734. .IX Item "-v"
  735. .PD 0
  736. .IP "fB--verbosefR" 4
  737. .IX Item "--verbose"
  738. .PD
  739. Verbose output: list all object files modified.  In the case of
  740. archives, fBobjcopy -VfR lists all members of the archive.
  741. .IP "fB--helpfR" 4
  742. .IX Item "--help"
  743. Show a summary of the options to fBobjcopyfR.
  744. .IP "fB--infofR" 4
  745. .IX Item "--info"
  746. Display a list showing all architectures and object formats available.
  747. .SH "SEE ALSO"
  748. .IX Header "SEE ALSO"
  749. &fIldfR|(1), fIobjdumpfR|(1), and the Info entries for fIbinutilsfR.
  750. .SH "COPYRIGHT"
  751. .IX Header "COPYRIGHT"
  752. Copyright (c) 1991, 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999,
  753. 2000, 2001, 2002, 2003, 2004 Free Software Foundation, Inc.
  754. .PP
  755. Permission is granted to copy, distribute and/or modify this document
  756. under the terms of the s-1GNUs0 Free Documentation License, Version 1.1
  757. or any later version published by the Free Software Foundation;
  758. with no Invariant Sections, with no Front-Cover Texts, and with no
  759. Back-Cover Texts.  A copy of the license is included in the
  760. section entitled ``s-1GNUs0 Free Documentation License''.