binutils/strings.1

   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
  16 ..
  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
  34
  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"
 193 strings \- print the strings of printable characters in files.
 194 .SH "SYNOPSIS"
 195 strings [\-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"
 200 For each \fIfile\fR given, GNU \f(CWstrings\fR prints the printable
 201 character sequences that are at least 4 characters long (or the number
 202 given with the options below) and are followed by an unprintable
 203 character.  By default, it only prints the strings from the initialized
 204 and loaded sections of object files; for other types of files, it prints
 205 the strings from the whole file.
 206 .PP
 207 \f(CWstrings\fR is mainly useful for determining the contents of non-text
 208 files.
 209 .SH "OPTIONS"
 210 .Ip "\f(CW-a\fR" 4
 211 .Ip "\f(CW--all\fR" 4
 212 .Ip "\f(CW-\fR" 4
 213 Do not scan only the initialized and loaded sections of object files;
 214 scan the whole files.
 215 .Ip "\f(CW-f\fR" 4
 216 .Ip "\f(CW--print-file-name\fR" 4
 217 Print the name of the file before each string.
 218 .Ip "\f(CW--help\fR" 4
 219 Print 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
 223 Print sequences of characters that are at least \fImin-len\fR characters
 224 long, instead of the default 4.
 225 .Ip "\f(CW-o\fR" 4
 226 Like \fB\-t o\fR.  Some other versions of \f(CWstrings\fR have \fB\-o\fR
 227 act like \fB\-t d\fR instead.  Since we can not be compatible with both
 228 ways, we simply chose one.
 229 .Ip "\f(CW-t \fIradix\fR\fR" 4
 230 .Ip "\f(CW--radix=\fIradix\fR\fR" 4
 231 Print the offset within the file before each string.  The single
 232 character argument specifies the radix of the offset---\fBo\fR for
 233 octal, \fBx\fR for hexadecimal, or \fBd\fR for decimal.
 234 .Ip "\f(CW--target=\fIbfdname\fR\fR" 4
 235 Specify 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
 238 Print 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)
 241 and the Info entries for \fIbinutils\fR.
 242 .SH "COPYRIGHT"
 243 Copyright (c) 1991, 92, 93, 94, 95, 96, 97, 98, 99, 2000, 2001 Free Software Foundation, Inc.
 244 .PP
 245 Permission is granted to copy, distribute and/or modify this document
 246 under the terms of the GNU Free Documentation License, Version 1.1
 247 or any later version published by the Free Software Foundation;
 248 with no Invariant Sections, with no Front-Cover Texts, and with no
 249 Back-Cover Texts.  A copy of the license is included in the
 250 section entitled \*(L"GNU Free Documentation License\*(R".
 251
 252 .rn }` ''
 253 .IX Title "STRINGS.1 1"
 254 .IX Name "strings - print the strings of printable characters in files."
 255
 256 .IX Header "NAME"
 257
 258 .IX Header "SYNOPSIS"
 259
 260 .IX Header "DESCRIPTION"
 261
 262 .IX Header "OPTIONS"
 263
 264 .IX Item "\f(CW-a\fR"
 265
 266 .IX Item "\f(CW--all\fR"
 267
 268 .IX Item "\f(CW-\fR"
 269
 270 .IX Item "\f(CW-f\fR"
 271
 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"
 281
 282 .IX Item "\f(CW-o\fR"
 283
 284 .IX Item "\f(CW-t \fIradix\fR\fR"
 285
 286 .IX Item "\f(CW--radix=\fIradix\fR\fR"
 287
 288 .IX Item "\f(CW--target=\fIbfdname\fR\fR"
 289
 290 .IX Item "\f(CW-v\fR"
 291
 292 .IX Item "\f(CW--version\fR"
 293
 294 .IX Header "SEE ALSO"
 295
 296 .IX Header "COPYRIGHT"
 297