logo

oasis-root

Compiled tree of Oasis Linux based on own branch at <https://hacktivis.me/git/oasis/> git clone https://anongit.hacktivis.me/git/oasis-root.git

strip.1 (18289B)


  1. .\" Automatically generated by Pod::Man 4.14 (Pod::Simple 3.43)
  2. .\"
  3. .\" Standard preamble:
  4. .\" ========================================================================
  5. .de Sp \" Vertical space (when we can't use .PP)
  6. .if t .sp .5v
  7. .if n .sp
  8. ..
  9. .de Vb \" Begin verbatim text
  10. .ft CW
  11. .nf
  12. .ne \\$1
  13. ..
  14. .de Ve \" End verbatim text
  15. .ft R
  16. .fi
  17. ..
  18. .\" Set up some character translations and predefined strings. \*(-- will
  19. .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
  20. .\" double quote, and \*(R" will give a right double quote. \*(C+ will
  21. .\" give a nicer C++. Capital omega is used to do unbreakable dashes and
  22. .\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff,
  23. .\" nothing in troff, for use with C<>.
  24. .tr \(*W-
  25. .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
  26. .ie n \{\
  27. . ds -- \(*W-
  28. . ds PI pi
  29. . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
  30. . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
  31. . ds L" ""
  32. . ds R" ""
  33. . ds C` ""
  34. . ds C' ""
  35. 'br\}
  36. .el\{\
  37. . ds -- \|\(em\|
  38. . ds PI \(*p
  39. . ds L" ``
  40. . ds R" ''
  41. . ds C`
  42. . ds C'
  43. 'br\}
  44. .\"
  45. .\" Escape single quotes in literal strings from groff's Unicode transform.
  46. .ie \n(.g .ds Aq \(aq
  47. .el .ds Aq '
  48. .\"
  49. .\" If the F register is >0, we'll generate index entries on stderr for
  50. .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
  51. .\" entries marked with X<> in POD. Of course, you'll have to process the
  52. .\" output yourself in some meaningful fashion.
  53. .\"
  54. .\" Avoid warning from groff about undefined register 'F'.
  55. .de IX
  56. ..
  57. .nr rF 0
  58. .if \n(.g .if rF .nr rF 1
  59. .if (\n(rF:(\n(.g==0)) \{\
  60. . if \nF \{\
  61. . de IX
  62. . tm Index:\\$1\t\\n%\t"\\$2"
  63. ..
  64. . if !\nF==2 \{\
  65. . nr % 0
  66. . nr F 2
  67. . \}
  68. . \}
  69. .\}
  70. .rr rF
  71. .\"
  72. .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
  73. .\" Fear. Run. Save yourself. No user-serviceable parts.
  74. . \" fudge factors for nroff and troff
  75. .if n \{\
  76. . ds #H 0
  77. . ds #V .8m
  78. . ds #F .3m
  79. . ds #[ \f1
  80. . ds #] \fP
  81. .\}
  82. .if t \{\
  83. . ds #H ((1u-(\\\\n(.fu%2u))*.13m)
  84. . ds #V .6m
  85. . ds #F 0
  86. . ds #[ \&
  87. . ds #] \&
  88. .\}
  89. . \" simple accents for nroff and troff
  90. .if n \{\
  91. . ds ' \&
  92. . ds ` \&
  93. . ds ^ \&
  94. . ds , \&
  95. . ds ~ ~
  96. . ds /
  97. .\}
  98. .if t \{\
  99. . ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
  100. . ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
  101. . ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
  102. . ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
  103. . ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
  104. . ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
  105. .\}
  106. . \" troff and (daisy-wheel) nroff accents
  107. .ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
  108. .ds 8 \h'\*(#H'\(*b\h'-\*(#H'
  109. .ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
  110. .ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
  111. .ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
  112. .ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
  113. .ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
  114. .ds ae a\h'-(\w'a'u*4/10)'e
  115. .ds Ae A\h'-(\w'A'u*4/10)'E
  116. . \" corrections for vroff
  117. .if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
  118. .if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
  119. . \" for low resolution devices (crt and lpr)
  120. .if \n(.H>23 .if \n(.V>19 \
  121. \{\
  122. . ds : e
  123. . ds 8 ss
  124. . ds o a
  125. . ds d- d\h'-1'\(ga
  126. . ds D- D\h'-1'\(hy
  127. . ds th \o'bp'
  128. . ds Th \o'LP'
  129. . ds ae ae
  130. . ds Ae AE
  131. .\}
  132. .rm #[ #] #H #V #F C
  133. .\" ========================================================================
  134. .\"
  135. .IX Title "STRIP 1"
  136. .TH STRIP 1 "2022-08-05" "binutils-2.39" "GNU Development Tools"
  137. .\" For nroff, turn off justification. Always turn off hyphenation; it makes
  138. .\" way too many mistakes in technical documents.
  139. .if n .ad l
  140. .nh
  141. .SH "NAME"
  142. strip \- discard symbols and other data from object files
  143. .SH "SYNOPSIS"
  144. .IX Header "SYNOPSIS"
  145. strip [\fB\-F\fR \fIbfdname\fR |\fB\-\-target=\fR\fIbfdname\fR]
  146. [\fB\-I\fR \fIbfdname\fR |\fB\-\-input\-target=\fR\fIbfdname\fR]
  147. [\fB\-O\fR \fIbfdname\fR |\fB\-\-output\-target=\fR\fIbfdname\fR]
  148. [\fB\-s\fR|\fB\-\-strip\-all\fR]
  149. [\fB\-S\fR|\fB\-g\fR|\fB\-d\fR|\fB\-\-strip\-debug\fR]
  150. [\fB\-\-strip\-dwo\fR]
  151. [\fB\-K\fR \fIsymbolname\fR|\fB\-\-keep\-symbol=\fR\fIsymbolname\fR]
  152. [\fB\-M\fR|\fB\-\-merge\-notes\fR][\fB\-\-no\-merge\-notes\fR]
  153. [\fB\-N\fR \fIsymbolname\fR |\fB\-\-strip\-symbol=\fR\fIsymbolname\fR]
  154. [\fB\-w\fR|\fB\-\-wildcard\fR]
  155. [\fB\-x\fR|\fB\-\-discard\-all\fR] [\fB\-X\fR |\fB\-\-discard\-locals\fR]
  156. [\fB\-R\fR \fIsectionname\fR |\fB\-\-remove\-section=\fR\fIsectionname\fR]
  157. [\fB\-\-keep\-section=\fR\fIsectionpattern\fR]
  158. [\fB\-\-remove\-relocations=\fR\fIsectionpattern\fR]
  159. [\fB\-o\fR \fIfile\fR] [\fB\-p\fR|\fB\-\-preserve\-dates\fR]
  160. [\fB\-D\fR|\fB\-\-enable\-deterministic\-archives\fR]
  161. [\fB\-U\fR|\fB\-\-disable\-deterministic\-archives\fR]
  162. [\fB\-\-keep\-section\-symbols\fR]
  163. [\fB\-\-keep\-file\-symbols\fR]
  164. [\fB\-\-only\-keep\-debug\fR]
  165. [\fB\-v\fR |\fB\-\-verbose\fR] [\fB\-V\fR|\fB\-\-version\fR]
  166. [\fB\-\-help\fR] [\fB\-\-info\fR]
  167. \fIobjfile\fR...
  168. .SH "DESCRIPTION"
  169. .IX Header "DESCRIPTION"
  170. \&\s-1GNU\s0 \fBstrip\fR discards all symbols from object files
  171. \&\fIobjfile\fR. The list of object files may include archives.
  172. At least one object file must be given.
  173. .PP
  174. \&\fBstrip\fR modifies the files named in its argument,
  175. rather than writing modified copies under different names.
  176. .SH "OPTIONS"
  177. .IX Header "OPTIONS"
  178. .IP "\fB\-F\fR \fIbfdname\fR" 4
  179. .IX Item "-F bfdname"
  180. .PD 0
  181. .IP "\fB\-\-target=\fR\fIbfdname\fR" 4
  182. .IX Item "--target=bfdname"
  183. .PD
  184. Treat the original \fIobjfile\fR as a file with the object
  185. code format \fIbfdname\fR, and rewrite it in the same format.
  186. .IP "\fB\-\-help\fR" 4
  187. .IX Item "--help"
  188. Show a summary of the options to \fBstrip\fR and exit.
  189. .IP "\fB\-\-info\fR" 4
  190. .IX Item "--info"
  191. Display a list showing all architectures and object formats available.
  192. .IP "\fB\-I\fR \fIbfdname\fR" 4
  193. .IX Item "-I bfdname"
  194. .PD 0
  195. .IP "\fB\-\-input\-target=\fR\fIbfdname\fR" 4
  196. .IX Item "--input-target=bfdname"
  197. .PD
  198. Treat the original \fIobjfile\fR as a file with the object
  199. code format \fIbfdname\fR.
  200. .IP "\fB\-O\fR \fIbfdname\fR" 4
  201. .IX Item "-O bfdname"
  202. .PD 0
  203. .IP "\fB\-\-output\-target=\fR\fIbfdname\fR" 4
  204. .IX Item "--output-target=bfdname"
  205. .PD
  206. Replace \fIobjfile\fR with a file in the output format \fIbfdname\fR.
  207. .IP "\fB\-R\fR \fIsectionname\fR" 4
  208. .IX Item "-R sectionname"
  209. .PD 0
  210. .IP "\fB\-\-remove\-section=\fR\fIsectionname\fR" 4
  211. .IX Item "--remove-section=sectionname"
  212. .PD
  213. Remove any section named \fIsectionname\fR from the output file, in
  214. addition to whatever sections would otherwise be removed. This
  215. option may be given more than once. Note that using this option
  216. inappropriately may make the output file unusable. The wildcard
  217. character \fB*\fR may be given at the end of \fIsectionname\fR. If
  218. so, then any section starting with \fIsectionname\fR will be removed.
  219. .Sp
  220. If the first character of \fIsectionpattern\fR is the exclamation
  221. point (!) then matching sections will not be removed even if an
  222. earlier use of \fB\-\-remove\-section\fR on the same command line
  223. would otherwise remove it. For example:
  224. .Sp
  225. .Vb 1
  226. \& \-\-remove\-section=.text.* \-\-remove\-section=!.text.foo
  227. .Ve
  228. .Sp
  229. will remove all sections matching the pattern '.text.*', but will not
  230. remove the section '.text.foo'.
  231. .IP "\fB\-\-keep\-section=\fR\fIsectionpattern\fR" 4
  232. .IX Item "--keep-section=sectionpattern"
  233. When removing sections from the output file, keep sections that match
  234. \&\fIsectionpattern\fR.
  235. .IP "\fB\-\-remove\-relocations=\fR\fIsectionpattern\fR" 4
  236. .IX Item "--remove-relocations=sectionpattern"
  237. Remove relocations from the output file for any section matching
  238. \&\fIsectionpattern\fR. This option may be given more than once. Note
  239. that using this option inappropriately may make the output file
  240. unusable. Wildcard characters are accepted in \fIsectionpattern\fR.
  241. For example:
  242. .Sp
  243. .Vb 1
  244. \& \-\-remove\-relocations=.text.*
  245. .Ve
  246. .Sp
  247. will remove the relocations for all sections matching the patter
  248. \&'.text.*'.
  249. .Sp
  250. If the first character of \fIsectionpattern\fR is the exclamation
  251. point (!) then matching sections will not have their relocation
  252. removed even if an earlier use of \fB\-\-remove\-relocations\fR on the
  253. same command line would otherwise cause the relocations to be removed.
  254. For example:
  255. .Sp
  256. .Vb 1
  257. \& \-\-remove\-relocations=.text.* \-\-remove\-relocations=!.text.foo
  258. .Ve
  259. .Sp
  260. will remove all relocations for sections matching the pattern
  261. \&'.text.*', but will not remove relocations for the section
  262. \&'.text.foo'.
  263. .IP "\fB\-s\fR" 4
  264. .IX Item "-s"
  265. .PD 0
  266. .IP "\fB\-\-strip\-all\fR" 4
  267. .IX Item "--strip-all"
  268. .PD
  269. Remove all symbols.
  270. .IP "\fB\-g\fR" 4
  271. .IX Item "-g"
  272. .PD 0
  273. .IP "\fB\-S\fR" 4
  274. .IX Item "-S"
  275. .IP "\fB\-d\fR" 4
  276. .IX Item "-d"
  277. .IP "\fB\-\-strip\-debug\fR" 4
  278. .IX Item "--strip-debug"
  279. .PD
  280. Remove debugging symbols only.
  281. .IP "\fB\-\-strip\-dwo\fR" 4
  282. .IX Item "--strip-dwo"
  283. Remove the contents of all \s-1DWARF\s0 .dwo sections, leaving the
  284. remaining debugging sections and all symbols intact.
  285. See the description of this option in the \fBobjcopy\fR section
  286. for more information.
  287. .IP "\fB\-\-strip\-unneeded\fR" 4
  288. .IX Item "--strip-unneeded"
  289. Remove all symbols that are not needed for relocation processing in
  290. addition to debugging symbols and sections stripped by
  291. \&\fB\-\-strip\-debug\fR.
  292. .IP "\fB\-K\fR \fIsymbolname\fR" 4
  293. .IX Item "-K symbolname"
  294. .PD 0
  295. .IP "\fB\-\-keep\-symbol=\fR\fIsymbolname\fR" 4
  296. .IX Item "--keep-symbol=symbolname"
  297. .PD
  298. When stripping symbols, keep symbol \fIsymbolname\fR even if it would
  299. normally be stripped. This option may be given more than once.
  300. .IP "\fB\-M\fR" 4
  301. .IX Item "-M"
  302. .PD 0
  303. .IP "\fB\-\-merge\-notes\fR" 4
  304. .IX Item "--merge-notes"
  305. .IP "\fB\-\-no\-merge\-notes\fR" 4
  306. .IX Item "--no-merge-notes"
  307. .PD
  308. For \s-1ELF\s0 files, attempt (or do not attempt) to reduce the size of any
  309. \&\s-1SHT_NOTE\s0 type sections by removing duplicate notes. The default is to
  310. attempt this reduction unless stripping debug or \s-1DWO\s0 information.
  311. .IP "\fB\-N\fR \fIsymbolname\fR" 4
  312. .IX Item "-N symbolname"
  313. .PD 0
  314. .IP "\fB\-\-strip\-symbol=\fR\fIsymbolname\fR" 4
  315. .IX Item "--strip-symbol=symbolname"
  316. .PD
  317. Remove symbol \fIsymbolname\fR from the source file. This option may be
  318. given more than once, and may be combined with strip options other than
  319. \&\fB\-K\fR.
  320. .IP "\fB\-o\fR \fIfile\fR" 4
  321. .IX Item "-o file"
  322. Put the stripped output in \fIfile\fR, rather than replacing the
  323. existing file. When this argument is used, only one \fIobjfile\fR
  324. argument may be specified.
  325. .IP "\fB\-p\fR" 4
  326. .IX Item "-p"
  327. .PD 0
  328. .IP "\fB\-\-preserve\-dates\fR" 4
  329. .IX Item "--preserve-dates"
  330. .PD
  331. Preserve the access and modification dates of the file.
  332. .IP "\fB\-D\fR" 4
  333. .IX Item "-D"
  334. .PD 0
  335. .IP "\fB\-\-enable\-deterministic\-archives\fR" 4
  336. .IX Item "--enable-deterministic-archives"
  337. .PD
  338. Operate in \fIdeterministic\fR mode. When copying archive members
  339. and writing the archive index, use zero for UIDs, GIDs, timestamps,
  340. and use consistent file modes for all files.
  341. .Sp
  342. If \fIbinutils\fR was configured with
  343. \&\fB\-\-enable\-deterministic\-archives\fR, then this mode is on by default.
  344. It can be disabled with the \fB\-U\fR option, below.
  345. .IP "\fB\-U\fR" 4
  346. .IX Item "-U"
  347. .PD 0
  348. .IP "\fB\-\-disable\-deterministic\-archives\fR" 4
  349. .IX Item "--disable-deterministic-archives"
  350. .PD
  351. Do \fInot\fR operate in \fIdeterministic\fR mode. This is the
  352. inverse of the \fB\-D\fR option, above: when copying archive members
  353. and writing the archive index, use their actual \s-1UID, GID,\s0 timestamp,
  354. and file mode values.
  355. .Sp
  356. This is the default unless \fIbinutils\fR was configured with
  357. \&\fB\-\-enable\-deterministic\-archives\fR.
  358. .IP "\fB\-w\fR" 4
  359. .IX Item "-w"
  360. .PD 0
  361. .IP "\fB\-\-wildcard\fR" 4
  362. .IX Item "--wildcard"
  363. .PD
  364. Permit regular expressions in \fIsymbolname\fRs used in other command
  365. line options. The question mark (?), asterisk (*), backslash (\e) and
  366. square brackets ([]) operators can be used anywhere in the symbol
  367. name. If the first character of the symbol name is the exclamation
  368. point (!) then the sense of the switch is reversed for that symbol.
  369. For example:
  370. .Sp
  371. .Vb 1
  372. \& \-w \-K !foo \-K fo*
  373. .Ve
  374. .Sp
  375. would cause strip to only keep symbols that start with the letters
  376. \&\*(L"fo\*(R", but to discard the symbol \*(L"foo\*(R".
  377. .IP "\fB\-x\fR" 4
  378. .IX Item "-x"
  379. .PD 0
  380. .IP "\fB\-\-discard\-all\fR" 4
  381. .IX Item "--discard-all"
  382. .PD
  383. Remove non-global symbols.
  384. .IP "\fB\-X\fR" 4
  385. .IX Item "-X"
  386. .PD 0
  387. .IP "\fB\-\-discard\-locals\fR" 4
  388. .IX Item "--discard-locals"
  389. .PD
  390. Remove compiler-generated local symbols.
  391. (These usually start with \fBL\fR or \fB.\fR.)
  392. .IP "\fB\-\-keep\-section\-symbols\fR" 4
  393. .IX Item "--keep-section-symbols"
  394. When stripping a file, perhaps with \fB\-\-strip\-debug\fR or
  395. \&\fB\-\-strip\-unneeded\fR, retain any symbols specifying section names,
  396. which would otherwise get stripped.
  397. .IP "\fB\-\-keep\-file\-symbols\fR" 4
  398. .IX Item "--keep-file-symbols"
  399. When stripping a file, perhaps with \fB\-\-strip\-debug\fR or
  400. \&\fB\-\-strip\-unneeded\fR, retain any symbols specifying source file names,
  401. which would otherwise get stripped.
  402. .IP "\fB\-\-only\-keep\-debug\fR" 4
  403. .IX Item "--only-keep-debug"
  404. Strip a file, emptying the contents of any sections that would not be
  405. stripped by \fB\-\-strip\-debug\fR and leaving the debugging sections
  406. intact. In \s-1ELF\s0 files, this preserves all the note sections in the
  407. output as well.
  408. .Sp
  409. Note \- the section headers of the stripped sections are preserved,
  410. including their sizes, but the contents of the section are discarded.
  411. The section headers are preserved so that other tools can match up the
  412. debuginfo file with the real executable, even if that executable has
  413. been relocated to a different address space.
  414. .Sp
  415. The intention is that this option will be used in conjunction with
  416. \&\fB\-\-add\-gnu\-debuglink\fR to create a two part executable. One a
  417. stripped binary which will occupy less space in \s-1RAM\s0 and in a
  418. distribution and the second a debugging information file which is only
  419. needed if debugging abilities are required. The suggested procedure
  420. to create these files is as follows:
  421. .RS 4
  422. .IP "1.<Link the executable as normal. Assuming that it is called>" 4
  423. .IX Item "1.<Link the executable as normal. Assuming that it is called>"
  424. \&\f(CW\*(C`foo\*(C'\fR then...
  425. .ie n .IP "1.<Run ""objcopy \-\-only\-keep\-debug foo foo.dbg"" to>" 4
  426. .el .IP "1.<Run \f(CWobjcopy \-\-only\-keep\-debug foo foo.dbg\fR to>" 4
  427. .IX Item "1.<Run objcopy --only-keep-debug foo foo.dbg to>"
  428. create a file containing the debugging info.
  429. .ie n .IP "1.<Run ""objcopy \-\-strip\-debug foo"" to create a>" 4
  430. .el .IP "1.<Run \f(CWobjcopy \-\-strip\-debug foo\fR to create a>" 4
  431. .IX Item "1.<Run objcopy --strip-debug foo to create a>"
  432. stripped executable.
  433. .ie n .IP "1.<Run ""objcopy \-\-add\-gnu\-debuglink=foo.dbg foo"">" 4
  434. .el .IP "1.<Run \f(CWobjcopy \-\-add\-gnu\-debuglink=foo.dbg foo\fR>" 4
  435. .IX Item "1.<Run objcopy --add-gnu-debuglink=foo.dbg foo>"
  436. to add a link to the debugging info into the stripped executable.
  437. .RE
  438. .RS 4
  439. .Sp
  440. Note\-\-\-the choice of \f(CW\*(C`.dbg\*(C'\fR as an extension for the debug info
  441. file is arbitrary. Also the \f(CW\*(C`\-\-only\-keep\-debug\*(C'\fR step is
  442. optional. You could instead do this:
  443. .IP "1.<Link the executable as normal.>" 4
  444. .IX Item "1.<Link the executable as normal.>"
  445. .PD 0
  446. .ie n .IP "1.<Copy ""foo"" to ""foo.full"">" 4
  447. .el .IP "1.<Copy \f(CWfoo\fR to \f(CWfoo.full\fR>" 4
  448. .IX Item "1.<Copy foo to foo.full>"
  449. .ie n .IP "1.<Run ""strip \-\-strip\-debug foo"">" 4
  450. .el .IP "1.<Run \f(CWstrip \-\-strip\-debug foo\fR>" 4
  451. .IX Item "1.<Run strip --strip-debug foo>"
  452. .ie n .IP "1.<Run ""objcopy \-\-add\-gnu\-debuglink=foo.full foo"">" 4
  453. .el .IP "1.<Run \f(CWobjcopy \-\-add\-gnu\-debuglink=foo.full foo\fR>" 4
  454. .IX Item "1.<Run objcopy --add-gnu-debuglink=foo.full foo>"
  455. .RE
  456. .RS 4
  457. .PD
  458. .Sp
  459. i.e., the file pointed to by the \fB\-\-add\-gnu\-debuglink\fR can be the
  460. full executable. It does not have to be a file created by the
  461. \&\fB\-\-only\-keep\-debug\fR switch.
  462. .Sp
  463. Note\-\-\-this switch is only intended for use on fully linked files. It
  464. does not make sense to use it on object files where the debugging
  465. information may be incomplete. Besides the gnu_debuglink feature
  466. currently only supports the presence of one filename containing
  467. debugging information, not multiple filenames on a one-per-object-file
  468. basis.
  469. .RE
  470. .IP "\fB\-V\fR" 4
  471. .IX Item "-V"
  472. .PD 0
  473. .IP "\fB\-\-version\fR" 4
  474. .IX Item "--version"
  475. .PD
  476. Show the version number for \fBstrip\fR.
  477. .IP "\fB\-v\fR" 4
  478. .IX Item "-v"
  479. .PD 0
  480. .IP "\fB\-\-verbose\fR" 4
  481. .IX Item "--verbose"
  482. .PD
  483. Verbose output: list all object files modified. In the case of
  484. archives, \fBstrip \-v\fR lists all members of the archive.
  485. .IP "\fB@\fR\fIfile\fR" 4
  486. .IX Item "@file"
  487. Read command-line options from \fIfile\fR. The options read are
  488. inserted in place of the original @\fIfile\fR option. If \fIfile\fR
  489. does not exist, or cannot be read, then the option will be treated
  490. literally, and not removed.
  491. .Sp
  492. Options in \fIfile\fR are separated by whitespace. A whitespace
  493. character may be included in an option by surrounding the entire
  494. option in either single or double quotes. Any character (including a
  495. backslash) may be included by prefixing the character to be included
  496. with a backslash. The \fIfile\fR may itself contain additional
  497. @\fIfile\fR options; any such options will be processed recursively.
  498. .SH "SEE ALSO"
  499. .IX Header "SEE ALSO"
  500. the Info entries for \fIbinutils\fR.
  501. .SH "COPYRIGHT"
  502. .IX Header "COPYRIGHT"
  503. Copyright (c) 1991\-2022 Free Software Foundation, Inc.
  504. .PP
  505. Permission is granted to copy, distribute and/or modify this document
  506. under the terms of the \s-1GNU\s0 Free Documentation License, Version 1.3
  507. or any later version published by the Free Software Foundation;
  508. with no Invariant Sections, with no Front-Cover Texts, and with no
  509. Back-Cover Texts. A copy of the license is included in the
  510. section entitled \*(L"\s-1GNU\s0 Free Documentation License\*(R".