binutils/strings.1

   1 .\" Automatically generated by Pod::Man version 1.02
   2 .\" Wed May 30 12:24:29 2001
   3 .\"
   4 .\" Standard preamble:
   5 .\" ======================================================================
   6 .de Sh \" Subsection heading
   7 .br
   8 .if t .Sp
   9 .ne 5
  10 .PP
  11 \fB\\$1\fR
  12 .PP
  13 ..
  14 .de Sp \" Vertical space (when we can't use .PP)
  15 .if t .sp .5v
  16 .if n .sp
  17 ..
  18 .de Ip \" List item
  19 .br
  20 .ie \\n(.$>=3 .ne \\$3
  21 .el .ne 3
  22 .IP "\\$1" \\$2
  23 ..
  24 .de Vb \" Begin verbatim text
  25 .ft CW
  26 .nf
  27 .ne \\$1
  28 ..
  29 .de Ve \" End verbatim text
  30 .ft R
  31
  32 .fi
  33 ..
  34 .\" Set up some character translations and predefined strings.  \*(-- will
  35 .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
  36 .\" double quote, and \*(R" will give a right double quote.  | will give a
  37 .\" real vertical bar.  \*(C+ will give a nicer C++.  Capital omega is used
  38 .\" to do unbreakable dashes and therefore won't be available.  \*(C` and
  39 .\" \*(C' expand to `' in nroff, nothing in troff, for use with C<>
  40 .tr \(*W-|\(bv\*(Tr
  41 .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
  42 .ie n \{\
  43 .    ds -- \(*W-
  44 .    ds PI pi
  45 .    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
  46 .    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
  47 .    ds L" ""
  48 .    ds R" ""
  49 .    ds C` `
  50 .    ds C' '
  51 'br\}
  52 .el\{\
  53 .    ds -- \|\(em\|
  54 .    ds PI \(*p
  55 .    ds L" ``
  56 .    ds R" ''
  57 'br\}
  58 .\"
  59 .\" If the F register is turned on, we'll generate index entries on stderr
  60 .\" for titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and
  61 .\" index entries marked with X<> in POD.  Of course, you'll have to process
  62 .\" the output yourself in some meaningful fashion.
  63 .if \nF \{\
  64 .    de IX
  65 .    tm Index:\\$1\t\\n%\t"\\$2"
  66 .    .
  67 .    nr % 0
  68 .    rr F
  69 .\}
  70 .\"
  71 .\" For nroff, turn off justification.  Always turn off hyphenation; it
  72 .\" makes way too many mistakes in technical documents.
  73 .hy 0
  74 .\"
  75 .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
  76 .\" Fear.  Run.  Save yourself.  No user-serviceable parts.
  77 .bd B 3
  78 .    \" fudge factors for nroff and troff
  79 .if n \{\
  80 .    ds #H 0
  81 .    ds #V .8m
  82 .    ds #F .3m
  83 .    ds #[ \f1
  84 .    ds #] \fP
  85 .\}
  86 .if t \{\
  87 .    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
  88 .    ds #V .6m
  89 .    ds #F 0
  90 .    ds #[ \&
  91 .    ds #] \&
  92 .\}
  93 .    \" simple accents for nroff and troff
  94 .if n \{\
  95 .    ds ' \&
  96 .    ds ` \&
  97 .    ds ^ \&
  98 .    ds , \&
  99 .    ds ~ ~
 100 .    ds /
 101 .\}
 102 .if t \{\
 103 .    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
 104 .    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
 105 .    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
 106 .    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
 107 .    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
 108 .    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
 109 .\}
 110 .    \" troff and (daisy-wheel) nroff accents
 111 .ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
 112 .ds 8 \h'\*(#H'\(*b\h'-\*(#H'
 113 .ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
 114 .ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
 115 .ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
 116 .ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
 117 .ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
 118 .ds ae a\h'-(\w'a'u*4/10)'e
 119 .ds Ae A\h'-(\w'A'u*4/10)'E
 120 .    \" corrections for vroff
 121 .if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
 122 .if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
 123 .    \" for low resolution devices (crt and lpr)
 124 .if \n(.H>23 .if \n(.V>19 \
 125 \{\
 126 .    ds : e
 127 .    ds 8 ss
 128 .    ds o a
 129 .    ds d- d\h'-1'\(ga
 130 .    ds D- D\h'-1'\(hy
 131 .    ds th \o'bp'
 132 .    ds Th \o'LP'
 133 .    ds ae ae
 134 .    ds Ae AE
 135 .\}
 136 .rm #[ #] #H #V #F C
 137 .\" ======================================================================
 138 .\"
 139 .IX Title "STRINGS.1 1"
 140 .TH STRINGS.1 1 "binutils-2.11.90" "2001-05-30" "GNU"
 141 .UC
 142 .SH "NAME"
 143 strings \- print the strings of printable characters in files.
 144 .SH "SYNOPSIS"
 145 .IX Header "SYNOPSIS"
 146 strings [\-afov] [-\fImin-len\fR] [\-n \fImin-len\fR] [\-t \fIradix\fR] [\-]
 147         [\-\-all] [\-\-print-file-name] [\-\-bytes=\fImin-len\fR]
 148         [\-\-radix=\fIradix\fR] [\-\-target=\fIbfdname\fR]
 149         [\-\-help] [\-\-version] \fIfile\fR...
 150 .SH "DESCRIPTION"
 151 .IX Header "DESCRIPTION"
 152 For each \fIfile\fR given, \s-1GNU\s0 \f(CW\*(C`strings\*(C'\fR prints the printable
 153 character sequences that are at least 4 characters long (or the number
 154 given with the options below) and are followed by an unprintable
 155 character.  By default, it only prints the strings from the initialized
 156 and loaded sections of object files; for other types of files, it prints
 157 the strings from the whole file.
 158 .PP
 159 \&\f(CW\*(C`strings\*(C'\fR is mainly useful for determining the contents of non-text
 160 files.
 161 .SH "OPTIONS"
 162 .IX Header "OPTIONS"
 163 .Ip "\f(CW\*(C`\-a\*(C'\fR" 4
 164 .IX Item "-a"
 165 .Ip "\f(CW\*(C`\-\-all\*(C'\fR" 4
 166 .IX Item "--all"
 167 .Ip "\f(CW\*(C`\-\*(C'\fR" 4
 168 .IX Item "-"
 169 Do not scan only the initialized and loaded sections of object files;
 170 scan the whole files.
 171 .Ip "\f(CW\*(C`\-f\*(C'\fR" 4
 172 .IX Item "-f"
 173 .Ip "\f(CW\*(C`\-\-print\-file\-name\*(C'\fR" 4
 174 .IX Item "--print-file-name"
 175 Print the name of the file before each string.
 176 .Ip "\f(CW\*(C`\-\-help\*(C'\fR" 4
 177 .IX Item "--help"
 178 Print a summary of the program usage on the standard output and exit.
 179 .Ip "\f(CW\*(C`\-\f(CImin\-len\f(CW\*(C'\fR" 4
 180 .IX Item "-min-len"
 181 .Ip "\f(CW\*(C`\-n \f(CImin\-len\f(CW\*(C'\fR" 4
 182 .IX Item "-n min-len"
 183 .Ip "\f(CW\*(C`\-\-bytes=\f(CImin\-len\f(CW\*(C'\fR" 4
 184 .IX Item "--bytes=min-len"
 185 Print sequences of characters that are at least \fImin-len\fR characters
 186 long, instead of the default 4.
 187 .Ip "\f(CW\*(C`\-o\*(C'\fR" 4
 188 .IX Item "-o"
 189 Like \fB\-t o\fR.  Some other versions of \f(CW\*(C`strings\*(C'\fR have \fB\-o\fR
 190 act like \fB\-t d\fR instead.  Since we can not be compatible with both
 191 ways, we simply chose one.
 192 .Ip "\f(CW\*(C`\-t \f(CIradix\f(CW\*(C'\fR" 4
 193 .IX Item "-t radix"
 194 .Ip "\f(CW\*(C`\-\-radix=\f(CIradix\f(CW\*(C'\fR" 4
 195 .IX Item "--radix=radix"
 196 Print the offset within the file before each string.  The single
 197 character argument specifies the radix of the offset\-\--\fBo\fR for
 198 octal, \fBx\fR for hexadecimal, or \fBd\fR for decimal.
 199 .Ip "\f(CW\*(C`\-\-target=\f(CIbfdname\f(CW\*(C'\fR" 4
 200 .IX Item "--target=bfdname"
 201 Specify an object code format other than your system's default format.
 202 .Ip "\f(CW\*(C`\-v\*(C'\fR" 4
 203 .IX Item "-v"
 204 .Ip "\f(CW\*(C`\-\-version\*(C'\fR" 4
 205 .IX Item "--version"
 206 Print the program version number on the standard output and exit.
 207 .SH "SEE ALSO"
 208 .IX Header "SEE ALSO"
 209 \&\fIar\fR\|(1), \fInm\fR\|(1), \fIobjdump\fR\|(1), \fIranlib\fR\|(1), \fIreadelf\fR\|(1)
 210 and the Info entries for \fIbinutils\fR.
 211 .SH "COPYRIGHT"
 212 .IX Header "COPYRIGHT"
 213 Copyright (c) 1991, 92, 93, 94, 95, 96, 97, 98, 99, 2000, 2001 Free Software Foundation, Inc.
 214 .PP
 215 Permission is granted to copy, distribute and/or modify this document
 216 under the terms of the \s-1GNU\s0 Free Documentation License, Version 1.1
 217 or any later version published by the Free Software Foundation;
 218 with no Invariant Sections, with no Front-Cover Texts, and with no
 219 Back-Cover Texts.  A copy of the license is included in the
 220 section entitled \*(L"\s-1GNU\s0 Free Documentation License\*(R".