gnu/usr.bin/binutils/strings/strings.1

   1 .\" $FreeBSD$
   2 .\" Automatically generated by Pod::Man 2.23 (Pod::Simple 3.14)
   3 .\"
   4 .\" Standard preamble:
   5 .\" ========================================================================
   6 .de Sp \" Vertical space (when we can't use .PP)
   7 .if t .sp .5v
   8 .if n .sp
   9 ..
  10 .de Vb \" Begin verbatim text
  11 .ft CW
  12 .nf
  13 .ne \\$1
  14 ..
  15 .de Ve \" End verbatim text
  16 .ft R
  17 .fi
  18 ..
  19 .\" Set up some character translations and predefined strings.  \*(-- will
  20 .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
  21 .\" double quote, and \*(R" will give a right double quote.  \*(C+ will
  22 .\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
  23 .\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
  24 .\" nothing in troff, for use with C<>.
  25 .tr \(*W-
  26 .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
  27 .ie n \{\
  28 .    ds -- \(*W-
  29 .    ds PI pi
  30 .    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
  31 .    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
  32 .    ds L" ""
  33 .    ds R" ""
  34 .    ds C` ""
  35 .    ds C' ""
  36 'br\}
  37 .el\{\
  38 .    ds -- \|\(em\|
  39 .    ds PI \(*p
  40 .    ds L" ``
  41 .    ds R" ''
  42 'br\}
  43 .\"
  44 .\" Escape single quotes in literal strings from groff's Unicode transform.
  45 .ie \n(.g .ds Aq \(aq
  46 .el       .ds Aq '
  47 .\"
  48 .\" If the F register is turned on, we'll generate index entries on stderr for
  49 .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
  50 .\" entries marked with X<> in POD.  Of course, you'll have to process the
  51 .\" output yourself in some meaningful fashion.
  52 .ie \nF \{\
  53 .    de IX
  54 .    tm Index:\\$1\t\\n%\t"\\$2"
  55 ..
  56 .    nr % 0
  57 .    rr F
  58 .\}
  59 .el \{\
  60 .    de IX
  61 ..
  62 .\}
  63 .\"
  64 .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
  65 .\" Fear.  Run.  Save yourself.  No user-serviceable parts.
  66 .    \" fudge factors for nroff and troff
  67 .if n \{\
  68 .    ds #H 0
  69 .    ds #V .8m
  70 .    ds #F .3m
  71 .    ds #[ \f1
  72 .    ds #] \fP
  73 .\}
  74 .if t \{\
  75 .    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
  76 .    ds #V .6m
  77 .    ds #F 0
  78 .    ds #[ \&
  79 .    ds #] \&
  80 .\}
  81 .    \" simple accents for nroff and troff
  82 .if n \{\
  83 .    ds ' \&
  84 .    ds ` \&
  85 .    ds ^ \&
  86 .    ds , \&
  87 .    ds ~ ~
  88 .    ds /
  89 .\}
  90 .if t \{\
  91 .    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
  92 .    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
  93 .    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
  94 .    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
  95 .    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
  96 .    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
  97 .\}
  98 .    \" troff and (daisy-wheel) nroff accents
  99 .ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
 100 .ds 8 \h'\*(#H'\(*b\h'-\*(#H'
 101 .ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
 102 .ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
 103 .ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
 104 .ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
 105 .ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
 106 .ds ae a\h'-(\w'a'u*4/10)'e
 107 .ds Ae A\h'-(\w'A'u*4/10)'E
 108 .    \" corrections for vroff
 109 .if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
 110 .if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
 111 .    \" for low resolution devices (crt and lpr)
 112 .if \n(.H>23 .if \n(.V>19 \
 113 \{\
 114 .    ds : e
 115 .    ds 8 ss
 116 .    ds o a
 117 .    ds d- d\h'-1'\(ga
 118 .    ds D- D\h'-1'\(hy
 119 .    ds th \o'bp'
 120 .    ds Th \o'LP'
 121 .    ds ae ae
 122 .    ds Ae AE
 123 .\}
 124 .rm #[ #] #H #V #F C
 125 .\" ========================================================================
 126 .\"
 127 .IX Title "STRINGS 1"
 128 .TH STRINGS 1 "2010-10-30" "binutils-2.17.50" "GNU Development Tools"
 129 .\" For nroff, turn off justification.  Always turn off hyphenation; it makes
 130 .\" way too many mistakes in technical documents.
 131 .if n .ad l
 132 .nh
 133 .SH "NAME"
 134 strings \- print the strings of printable characters in files.
 135 .SH "SYNOPSIS"
 136 .IX Header "SYNOPSIS"
 137 strings [\fB\-afov\fR] [\fB\-\fR\fImin-len\fR]
 138         [\fB\-n\fR \fImin-len\fR] [\fB\-\-bytes=\fR\fImin-len\fR]
 139         [\fB\-t\fR \fIradix\fR] [\fB\-\-radix=\fR\fIradix\fR]
 140         [\fB\-e\fR \fIencoding\fR] [\fB\-\-encoding=\fR\fIencoding\fR]
 141         [\fB\-\fR] [\fB\-\-all\fR] [\fB\-\-print\-file\-name\fR]
 142         [\fB\-T\fR \fIbfdname\fR] [\fB\-\-target=\fR\fIbfdname\fR]
 143         [\fB\-\-help\fR] [\fB\-\-version\fR] \fIfile\fR...
 144 .SH "DESCRIPTION"
 145 .IX Header "DESCRIPTION"
 146 For each \fIfile\fR given, \s-1GNU\s0 \fBstrings\fR prints the printable
 147 character sequences that are at least 4 characters long (or the number
 148 given with the options below) and are followed by an unprintable
 149 character.  By default, it only prints the strings from the initialized
 150 and loaded sections of object files; for other types of files, it prints
 151 the strings from the whole file.
 152 .PP
 153 \&\fBstrings\fR is mainly useful for determining the contents of non-text
 154 files.
 155 .SH "OPTIONS"
 156 .IX Header "OPTIONS"
 157 .IP "\fB\-a\fR" 4
 158 .IX Item "-a"
 159 .PD 0
 160 .IP "\fB\-\-all\fR" 4
 161 .IX Item "--all"
 162 .IP "\fB\-\fR" 4
 163 .IX Item "-"
 164 .PD
 165 Do not scan only the initialized and loaded sections of object files;
 166 scan the whole files.
 167 .IP "\fB\-f\fR" 4
 168 .IX Item "-f"
 169 .PD 0
 170 .IP "\fB\-\-print\-file\-name\fR" 4
 171 .IX Item "--print-file-name"
 172 .PD
 173 Print the name of the file before each string.
 174 .IP "\fB\-\-help\fR" 4
 175 .IX Item "--help"
 176 Print a summary of the program usage on the standard output and exit.
 177 .IP "\fB\-\fR\fImin-len\fR" 4
 178 .IX Item "-min-len"
 179 .PD 0
 180 .IP "\fB\-n\fR \fImin-len\fR" 4
 181 .IX Item "-n min-len"
 182 .IP "\fB\-\-bytes=\fR\fImin-len\fR" 4
 183 .IX Item "--bytes=min-len"
 184 .PD
 185 Print sequences of characters that are at least \fImin-len\fR characters
 186 long, instead of the default 4.
 187 .IP "\fB\-o\fR" 4
 188 .IX Item "-o"
 189 Like \fB\-t o\fR.  Some other versions of \fBstrings\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 "\fB\-t\fR \fIradix\fR" 4
 193 .IX Item "-t radix"
 194 .PD 0
 195 .IP "\fB\-\-radix=\fR\fIradix\fR" 4
 196 .IX Item "--radix=radix"
 197 .PD
 198 Print the offset within the file before each string.  The single
 199 character argument specifies the radix of the offset\-\-\-\fBo\fR for
 200 octal, \fBx\fR for hexadecimal, or \fBd\fR for decimal.
 201 .IP "\fB\-e\fR \fIencoding\fR" 4
 202 .IX Item "-e encoding"
 203 .PD 0
 204 .IP "\fB\-\-encoding=\fR\fIencoding\fR" 4
 205 .IX Item "--encoding=encoding"
 206 .PD
 207 Select the character encoding of the strings that are to be found.
 208 Possible values for \fIencoding\fR are: \fBs\fR = single\-7\-bit\-byte
 209 characters (\s-1ASCII\s0, \s-1ISO\s0 8859, etc., default), \fBS\fR =
 210 single\-8\-bit\-byte characters, \fBb\fR = 16\-bit bigendian, \fBl\fR =
 211 16\-bit littleendian, \fBB\fR = 32\-bit bigendian, \fBL\fR = 32\-bit
 212 littleendian. Useful for finding wide character strings.
 213 .IP "\fB\-T\fR \fIbfdname\fR" 4
 214 .IX Item "-T bfdname"
 215 .PD 0
 216 .IP "\fB\-\-target=\fR\fIbfdname\fR" 4
 217 .IX Item "--target=bfdname"
 218 .PD
 219 Specify an object code format other than your system's default format.
 220 .IP "\fB\-v\fR" 4
 221 .IX Item "-v"
 222 .PD 0
 223 .IP "\fB\-\-version\fR" 4
 224 .IX Item "--version"
 225 .PD
 226 Print the program version number on the standard output and exit.
 227 .IP "\fB@\fR\fIfile\fR" 4
 228 .IX Item "@file"
 229 Read command-line options from \fIfile\fR.  The options read are
 230 inserted in place of the original @\fIfile\fR option.  If \fIfile\fR
 231 does not exist, or cannot be read, then the option will be treated
 232 literally, and not removed.
 233 .Sp
 234 Options in \fIfile\fR are separated by whitespace.  A whitespace
 235 character may be included in an option by surrounding the entire
 236 option in either single or double quotes.  Any character (including a
 237 backslash) may be included by prefixing the character to be included
 238 with a backslash.  The \fIfile\fR may itself contain additional
 239 @\fIfile\fR options; any such options will be processed recursively.
 240 .SH "SEE ALSO"
 241 .IX Header "SEE ALSO"
 242 \&\fIar\fR\|(1), \fInm\fR\|(1), \fIobjdump\fR\|(1), \fIranlib\fR\|(1), \fIreadelf\fR\|(1)
 243 and the Info entries for \fIbinutils\fR.
 244 .SH "COPYRIGHT"
 245 .IX Header "COPYRIGHT"
 246 Copyright (c) 1991, 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999,
 247 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007 Free Software Foundation, Inc.
 248 .PP
 249 Permission is granted to copy, distribute and/or modify this document
 250 under the terms of the \s-1GNU\s0 Free Documentation License, Version 1.1
 251 or any later version published by the Free Software Foundation;
 252 with no Invariant Sections, with no Front-Cover Texts, and with no
 253 Back-Cover Texts.  A copy of the license is included in the
 254 section entitled \*(L"\s-1GNU\s0 Free Documentation License\*(R".