2001-04-17 Michael Snyder <msnyder@redhat.com>
[deliverable/binutils-gdb.git] / binutils / strings.1
CommitLineData
0285c67d
NC
1.rn '' }`
2''' $RCSfile$$Revision$$Date$
3'''
4''' $Log$
5''' Revision 1.7 2001/03/25 20:32:25 nickc
6''' Automate generate on man pages
7'''
8'''
9.de Sh
10.br
11.if t .Sp
12.ne 5
13.PP
14\fB\\$1\fR
15.PP
252b5132 16..
0285c67d
NC
17.de Sp
18.if t .sp .5v
19.if n .sp
20..
21.de Ip
22.br
23.ie \\n(.$>=3 .ne \\$3
24.el .ne 3
25.IP "\\$1" \\$2
26..
27.de Vb
28.ft CW
29.nf
30.ne \\$1
31..
32.de Ve
33.ft R
252b5132 34
0285c67d
NC
35.fi
36..
37'''
38'''
39''' Set up \*(-- to give an unbreakable dash;
40''' string Tr holds user defined translation string.
41''' Bell System Logo is used as a dummy character.
42'''
43.tr \(*W-|\(bv\*(Tr
44.ie n \{\
45.ds -- \(*W-
46.ds PI pi
47.if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
48.if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
49.ds L" ""
50.ds R" ""
51''' \*(M", \*(S", \*(N" and \*(T" are the equivalent of
52''' \*(L" and \*(R", except that they are used on ".xx" lines,
53''' such as .IP and .SH, which do another additional levels of
54''' double-quote interpretation
55.ds M" """
56.ds S" """
57.ds N" """""
58.ds T" """""
59.ds L' '
60.ds R' '
61.ds M' '
62.ds S' '
63.ds N' '
64.ds T' '
65'br\}
66.el\{\
67.ds -- \(em\|
68.tr \*(Tr
69.ds L" ``
70.ds R" ''
71.ds M" ``
72.ds S" ''
73.ds N" ``
74.ds T" ''
75.ds L' `
76.ds R' '
77.ds M' `
78.ds S' '
79.ds N' `
80.ds T' '
81.ds PI \(*p
82'br\}
83.\" If the F register is turned on, we'll generate
84.\" index entries out stderr for the following things:
85.\" TH Title
86.\" SH Header
87.\" Sh Subsection
88.\" Ip Item
89.\" X<> Xref (embedded
90.\" Of course, you have to process the output yourself
91.\" in some meaninful fashion.
92.if \nF \{
93.de IX
94.tm Index:\\$1\t\\n%\t"\\$2"
95..
96.nr % 0
97.rr F
98.\}
99.TH STRINGS.1 1 "binutils-2.11.90" "23/Mar/101" "GNU"
100.UC
101.if n .hy 0
102.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
103.de CQ \" put $1 in typewriter font
104.ft CW
105'if n "\c
106'if t \\&\\$1\c
107'if n \\&\\$1\c
108'if n \&"
109\\&\\$2 \\$3 \\$4 \\$5 \\$6 \\$7
110'.ft R
111..
112.\" @(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2
113. \" AM - accent mark definitions
114.bd B 3
115. \" fudge factors for nroff and troff
116.if n \{\
117. ds #H 0
118. ds #V .8m
119. ds #F .3m
120. ds #[ \f1
121. ds #] \fP
122.\}
123.if t \{\
124. ds #H ((1u-(\\\\n(.fu%2u))*.13m)
125. ds #V .6m
126. ds #F 0
127. ds #[ \&
128. ds #] \&
129.\}
130. \" simple accents for nroff and troff
131.if n \{\
132. ds ' \&
133. ds ` \&
134. ds ^ \&
135. ds , \&
136. ds ~ ~
137. ds ? ?
138. ds ! !
139. ds /
140. ds q
141.\}
142.if t \{\
143. ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
144. ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
145. ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
146. ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
147. ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
148. ds ? \s-2c\h'-\w'c'u*7/10'\u\h'\*(#H'\zi\d\s+2\h'\w'c'u*8/10'
149. ds ! \s-2\(or\s+2\h'-\w'\(or'u'\v'-.8m'.\v'.8m'
150. ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
151. ds q o\h'-\w'o'u*8/10'\s-4\v'.4m'\z\(*i\v'-.4m'\s+4\h'\w'o'u*8/10'
152.\}
153. \" troff and (daisy-wheel) nroff accents
154.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
155.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
156.ds v \\k:\h'-(\\n(.wu*9/10-\*(#H)'\v'-\*(#V'\*(#[\s-4v\s0\v'\*(#V'\h'|\\n:u'\*(#]
157.ds _ \\k:\h'-(\\n(.wu*9/10-\*(#H+(\*(#F*2/3))'\v'-.4m'\z\(hy\v'.4m'\h'|\\n:u'
158.ds . \\k:\h'-(\\n(.wu*8/10)'\v'\*(#V*4/10'\z.\v'-\*(#V*4/10'\h'|\\n:u'
159.ds 3 \*(#[\v'.2m'\s-2\&3\s0\v'-.2m'\*(#]
160.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
161.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
162.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
163.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
164.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
165.ds ae a\h'-(\w'a'u*4/10)'e
166.ds Ae A\h'-(\w'A'u*4/10)'E
167.ds oe o\h'-(\w'o'u*4/10)'e
168.ds Oe O\h'-(\w'O'u*4/10)'E
169. \" corrections for vroff
170.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
171.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
172. \" for low resolution devices (crt and lpr)
173.if \n(.H>23 .if \n(.V>19 \
174\{\
175. ds : e
176. ds 8 ss
177. ds v \h'-1'\o'\(aa\(ga'
178. ds _ \h'-1'^
179. ds . \h'-1'.
180. ds 3 3
181. ds o a
182. ds d- d\h'-1'\(ga
183. ds D- D\h'-1'\(hy
184. ds th \o'bp'
185. ds Th \o'LP'
186. ds ae ae
187. ds Ae AE
188. ds oe oe
189. ds Oe OE
190.\}
191.rm #[ #] #H #V #F C
192.SH "NAME"
193strings \- print the strings of printable characters in files.
194.SH "SYNOPSIS"
195strings [\-afov] [\-\fImin-len\fR] [\-n \fImin-len\fR] [\-t \fIradix\fR] [\-]
196 [--all] [--print-file-name] [--bytes=\fImin-len\fR]
197 [--radix=\fIradix\fR] [--target=\fIbfdname\fR]
198 [--help] [--version] \fIfile\fR...
199.SH "DESCRIPTION"
200For each \fIfile\fR given, GNU \f(CWstrings\fR prints the printable
201character sequences that are at least 4 characters long (or the number
202given with the options below) and are followed by an unprintable
203character. By default, it only prints the strings from the initialized
204and loaded sections of object files; for other types of files, it prints
205the strings from the whole file.
252b5132 206.PP
0285c67d
NC
207\f(CWstrings\fR is mainly useful for determining the contents of non-text
208files.
209.SH "OPTIONS"
210.Ip "\f(CW-a\fR" 4
211.Ip "\f(CW--all\fR" 4
212.Ip "\f(CW-\fR" 4
252b5132
RH
213Do not scan only the initialized and loaded sections of object files;
214scan the whole files.
0285c67d
NC
215.Ip "\f(CW-f\fR" 4
216.Ip "\f(CW--print-file-name\fR" 4
252b5132 217Print the name of the file before each string.
0285c67d
NC
218.Ip "\f(CW--help\fR" 4
219Print a summary of the program usage on the standard output and exit.
220.Ip "\f(CW-\fImin-len\fR\fR" 4
221.Ip "\f(CW-n \fImin-len\fR\fR" 4
222.Ip "\f(CW--bytes=\fImin-len\fR\fR" 4
223Print sequences of characters that are at least \fImin-len\fR characters
224long, instead of the default 4.
225.Ip "\f(CW-o\fR" 4
226Like \fB\-t o\fR. Some other versions of \f(CWstrings\fR have \fB\-o\fR
227act like \fB\-t d\fR instead. Since we can not be compatible with both
228ways, we simply chose one.
229.Ip "\f(CW-t \fIradix\fR\fR" 4
230.Ip "\f(CW--radix=\fIradix\fR\fR" 4
231Print the offset within the file before each string. The single
232character argument specifies the radix of the offset---\fBo\fR for
233octal, \fBx\fR for hexadecimal, or \fBd\fR for decimal.
234.Ip "\f(CW--target=\fIbfdname\fR\fR" 4
235Specify an object code format other than your system's default format.
236.Ip "\f(CW-v\fR" 4
237.Ip "\f(CW--version\fR" 4
238Print the program version number on the standard output and exit.
239.SH "SEE ALSO"
240\fIar\fR\|(1), \fInm\fR\|(1), \fIobjdump\fR\|(1), \fIranlib\fR\|(1), \fIreadelf\fR\|(1)
241and the Info entries for \fIbinutils\fR.
242.SH "COPYRIGHT"
243Copyright (c) 1991, 92, 93, 94, 95, 96, 97, 98, 99, 2000, 2001 Free Software Foundation, Inc.
244.PP
245Permission is granted to copy, distribute and/or modify this document
246under the terms of the GNU Free Documentation License, Version 1.1
247or any later version published by the Free Software Foundation;
248with no Invariant Sections, with no Front-Cover Texts, and with no
249Back-Cover Texts. A copy of the license is included in the
250section entitled \*(L"GNU Free Documentation License\*(R".
252b5132 251
0285c67d
NC
252.rn }` ''
253.IX Title "STRINGS.1 1"
254.IX Name "strings - print the strings of printable characters in files."
252b5132 255
0285c67d 256.IX Header "NAME"
252b5132 257
0285c67d 258.IX Header "SYNOPSIS"
252b5132 259
0285c67d 260.IX Header "DESCRIPTION"
252b5132 261
0285c67d 262.IX Header "OPTIONS"
252b5132 263
0285c67d 264.IX Item "\f(CW-a\fR"
252b5132 265
0285c67d 266.IX Item "\f(CW--all\fR"
252b5132 267
0285c67d 268.IX Item "\f(CW-\fR"
252b5132 269
0285c67d 270.IX Item "\f(CW-f\fR"
252b5132 271
0285c67d
NC
272.IX Item "\f(CW--print-file-name\fR"
273
274.IX Item "\f(CW--help\fR"
275
276.IX Item "\f(CW-\fImin-len\fR\fR"
277
278.IX Item "\f(CW-n \fImin-len\fR\fR"
279
280.IX Item "\f(CW--bytes=\fImin-len\fR\fR"
cf055d54 281
0285c67d 282.IX Item "\f(CW-o\fR"
cf055d54 283
0285c67d 284.IX Item "\f(CW-t \fIradix\fR\fR"
cf055d54 285
0285c67d 286.IX Item "\f(CW--radix=\fIradix\fR\fR"
cf055d54 287
0285c67d 288.IX Item "\f(CW--target=\fIbfdname\fR\fR"
cf055d54 289
0285c67d 290.IX Item "\f(CW-v\fR"
cf055d54 291
0285c67d 292.IX Item "\f(CW--version\fR"
cf055d54 293
0285c67d 294.IX Header "SEE ALSO"
cf055d54 295
0285c67d 296.IX Header "COPYRIGHT"
cf055d54 297
This page took 0.07593 seconds and 4 git commands to generate.