OpenCores
URL https://opencores.org/ocsvn/openrisc/openrisc/trunk

Subversion Repositories openrisc

[/] [openrisc/] [trunk/] [gnu-stable/] [binutils-2.20.1/] [binutils/] [doc/] [strings.1] - Diff between revs 816 and 818

Go to most recent revision | Only display areas with differences | Details | Blame | View Log

Rev 816 Rev 818
.\" Automatically generated by Pod::Man 2.16 (Pod::Simple 3.05)
.\" Automatically generated by Pod::Man 2.16 (Pod::Simple 3.05)
.\"
.\"
.\" Standard preamble:
.\" Standard preamble:
.\" ========================================================================
.\" ========================================================================
.de Sh \" Subsection heading
.de Sh \" Subsection heading
.br
.br
.if t .Sp
.if t .Sp
.ne 5
.ne 5
.PP
.PP
\fB\\$1\fR
\fB\\$1\fR
.PP
.PP
..
..
.de Sp \" Vertical space (when we can't use .PP)
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if t .sp .5v
.if n .sp
.if n .sp
..
..
.de Vb \" Begin verbatim text
.de Vb \" Begin verbatim text
.ft CW
.ft CW
.nf
.nf
.ne \\$1
.ne \\$1
..
..
.de Ve \" End verbatim text
.de Ve \" End verbatim text
.ft R
.ft R
.fi
.fi
..
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.\" nothing in troff, for use with C<>.
.tr \(*W-
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.ie n \{\
.    ds -- \(*W-
.    ds -- \(*W-
.    ds PI pi
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds L" ""
.    ds R" ""
.    ds R" ""
.    ds C` ""
.    ds C` ""
.    ds C' ""
.    ds C' ""
'br\}
'br\}
.el\{\
.el\{\
.    ds -- \|\(em\|
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds PI \(*p
.    ds L" ``
.    ds L" ``
.    ds R" ''
.    ds R" ''
'br\}
'br\}
.\"
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.el       .ds Aq '
.\"
.\"
.\" If the F register is turned on, we'll generate index entries on stderr for
.\" If the F register is turned on, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and index
.\" titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\" output yourself in some meaningful fashion.
.ie \nF \{\
.ie \nF \{\
.    de IX
.    de IX
.    tm Index:\\$1\t\\n%\t"\\$2"
.    tm Index:\\$1\t\\n%\t"\\$2"
..
..
.    nr % 0
.    nr % 0
.    rr F
.    rr F
.\}
.\}
.el \{\
.el \{\
.    de IX
.    de IX
..
..
.\}
.\}
.\"
.\"
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
.\" Fear.  Run.  Save yourself.  No user-serviceable parts.
.\" Fear.  Run.  Save yourself.  No user-serviceable parts.
.    \" fudge factors for nroff and troff
.    \" fudge factors for nroff and troff
.if n \{\
.if n \{\
.    ds #H 0
.    ds #H 0
.    ds #V .8m
.    ds #V .8m
.    ds #F .3m
.    ds #F .3m
.    ds #[ \f1
.    ds #[ \f1
.    ds #] \fP
.    ds #] \fP
.\}
.\}
.if t \{\
.if t \{\
.    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
.    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
.    ds #V .6m
.    ds #V .6m
.    ds #F 0
.    ds #F 0
.    ds #[ \&
.    ds #[ \&
.    ds #] \&
.    ds #] \&
.\}
.\}
.    \" simple accents for nroff and troff
.    \" simple accents for nroff and troff
.if n \{\
.if n \{\
.    ds ' \&
.    ds ' \&
.    ds ` \&
.    ds ` \&
.    ds ^ \&
.    ds ^ \&
.    ds , \&
.    ds , \&
.    ds ~ ~
.    ds ~ ~
.    ds /
.    ds /
.\}
.\}
.if t \{\
.if t \{\
.    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
.    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
.    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
.    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
.    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
.    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
.    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
.    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
.    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
.    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
.    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
.    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
.\}
.\}
.    \" troff and (daisy-wheel) nroff accents
.    \" troff and (daisy-wheel) nroff accents
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
.ds ae a\h'-(\w'a'u*4/10)'e
.ds ae a\h'-(\w'a'u*4/10)'e
.ds Ae A\h'-(\w'A'u*4/10)'E
.ds Ae A\h'-(\w'A'u*4/10)'E
.    \" corrections for vroff
.    \" corrections for vroff
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
.    \" for low resolution devices (crt and lpr)
.    \" for low resolution devices (crt and lpr)
.if \n(.H>23 .if \n(.V>19 \
.if \n(.H>23 .if \n(.V>19 \
\{\
\{\
.    ds : e
.    ds : e
.    ds 8 ss
.    ds 8 ss
.    ds o a
.    ds o a
.    ds d- d\h'-1'\(ga
.    ds d- d\h'-1'\(ga
.    ds D- D\h'-1'\(hy
.    ds D- D\h'-1'\(hy
.    ds th \o'bp'
.    ds th \o'bp'
.    ds Th \o'LP'
.    ds Th \o'LP'
.    ds ae ae
.    ds ae ae
.    ds Ae AE
.    ds Ae AE
.\}
.\}
.rm #[ #] #H #V #F C
.rm #[ #] #H #V #F C
.\" ========================================================================
.\" ========================================================================
.\"
.\"
.IX Title "STRINGS 1"
.IX Title "STRINGS 1"
.TH STRINGS 1 "2009-10-16" "binutils-2.20" "GNU Development Tools"
.TH STRINGS 1 "2009-10-16" "binutils-2.20" "GNU Development Tools"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.\" way too many mistakes in technical documents.
.if n .ad l
.if n .ad l
.nh
.nh
.SH "NAME"
.SH "NAME"
strings \- print the strings of printable characters in files.
strings \- print the strings of printable characters in files.
.SH "SYNOPSIS"
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
.IX Header "SYNOPSIS"
strings [\fB\-afovV\fR] [\fB\-\fR\fImin-len\fR]
strings [\fB\-afovV\fR] [\fB\-\fR\fImin-len\fR]
        [\fB\-n\fR \fImin-len\fR] [\fB\-\-bytes=\fR\fImin-len\fR]
        [\fB\-n\fR \fImin-len\fR] [\fB\-\-bytes=\fR\fImin-len\fR]
        [\fB\-t\fR \fIradix\fR] [\fB\-\-radix=\fR\fIradix\fR]
        [\fB\-t\fR \fIradix\fR] [\fB\-\-radix=\fR\fIradix\fR]
        [\fB\-e\fR \fIencoding\fR] [\fB\-\-encoding=\fR\fIencoding\fR]
        [\fB\-e\fR \fIencoding\fR] [\fB\-\-encoding=\fR\fIencoding\fR]
        [\fB\-\fR] [\fB\-\-all\fR] [\fB\-\-print\-file\-name\fR]
        [\fB\-\fR] [\fB\-\-all\fR] [\fB\-\-print\-file\-name\fR]
        [\fB\-T\fR \fIbfdname\fR] [\fB\-\-target=\fR\fIbfdname\fR]
        [\fB\-T\fR \fIbfdname\fR] [\fB\-\-target=\fR\fIbfdname\fR]
        [\fB\-\-help\fR] [\fB\-\-version\fR] \fIfile\fR...
        [\fB\-\-help\fR] [\fB\-\-version\fR] \fIfile\fR...
.SH "DESCRIPTION"
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
.IX Header "DESCRIPTION"
For each \fIfile\fR given, \s-1GNU\s0 \fBstrings\fR prints the printable
For each \fIfile\fR given, \s-1GNU\s0 \fBstrings\fR prints the printable
character sequences that are at least 4 characters long (or the number
character sequences that are at least 4 characters long (or the number
given with the options below) and are followed by an unprintable
given with the options below) and are followed by an unprintable
character.  By default, it only prints the strings from the initialized
character.  By default, it only prints the strings from the initialized
and loaded sections of object files; for other types of files, it prints
and loaded sections of object files; for other types of files, it prints
the strings from the whole file.
the strings from the whole file.
.PP
.PP
\&\fBstrings\fR is mainly useful for determining the contents of non-text
\&\fBstrings\fR is mainly useful for determining the contents of non-text
files.
files.
.SH "OPTIONS"
.SH "OPTIONS"
.IX Header "OPTIONS"
.IX Header "OPTIONS"
.IP "\fB\-a\fR" 4
.IP "\fB\-a\fR" 4
.IX Item "-a"
.IX Item "-a"
.PD 0
.PD 0
.IP "\fB\-\-all\fR" 4
.IP "\fB\-\-all\fR" 4
.IX Item "--all"
.IX Item "--all"
.IP "\fB\-\fR" 4
.IP "\fB\-\fR" 4
.IX Item "-"
.IX Item "-"
.PD
.PD
Do not scan only the initialized and loaded sections of object files;
Do not scan only the initialized and loaded sections of object files;
scan the whole files.
scan the whole files.
.IP "\fB\-f\fR" 4
.IP "\fB\-f\fR" 4
.IX Item "-f"
.IX Item "-f"
.PD 0
.PD 0
.IP "\fB\-\-print\-file\-name\fR" 4
.IP "\fB\-\-print\-file\-name\fR" 4
.IX Item "--print-file-name"
.IX Item "--print-file-name"
.PD
.PD
Print the name of the file before each string.
Print the name of the file before each string.
.IP "\fB\-\-help\fR" 4
.IP "\fB\-\-help\fR" 4
.IX Item "--help"
.IX Item "--help"
Print a summary of the program usage on the standard output and exit.
Print a summary of the program usage on the standard output and exit.
.IP "\fB\-\fR\fImin-len\fR" 4
.IP "\fB\-\fR\fImin-len\fR" 4
.IX Item "-min-len"
.IX Item "-min-len"
.PD 0
.PD 0
.IP "\fB\-n\fR \fImin-len\fR" 4
.IP "\fB\-n\fR \fImin-len\fR" 4
.IX Item "-n min-len"
.IX Item "-n min-len"
.IP "\fB\-\-bytes=\fR\fImin-len\fR" 4
.IP "\fB\-\-bytes=\fR\fImin-len\fR" 4
.IX Item "--bytes=min-len"
.IX Item "--bytes=min-len"
.PD
.PD
Print sequences of characters that are at least \fImin-len\fR characters
Print sequences of characters that are at least \fImin-len\fR characters
long, instead of the default 4.
long, instead of the default 4.
.IP "\fB\-o\fR" 4
.IP "\fB\-o\fR" 4
.IX Item "-o"
.IX Item "-o"
Like \fB\-t o\fR.  Some other versions of \fBstrings\fR have \fB\-o\fR
Like \fB\-t o\fR.  Some other versions of \fBstrings\fR have \fB\-o\fR
act like \fB\-t d\fR instead.  Since we can not be compatible with both
act like \fB\-t d\fR instead.  Since we can not be compatible with both
ways, we simply chose one.
ways, we simply chose one.
.IP "\fB\-t\fR \fIradix\fR" 4
.IP "\fB\-t\fR \fIradix\fR" 4
.IX Item "-t radix"
.IX Item "-t radix"
.PD 0
.PD 0
.IP "\fB\-\-radix=\fR\fIradix\fR" 4
.IP "\fB\-\-radix=\fR\fIradix\fR" 4
.IX Item "--radix=radix"
.IX Item "--radix=radix"
.PD
.PD
Print the offset within the file before each string.  The single
Print the offset within the file before each string.  The single
character argument specifies the radix of the offset\-\-\-\fBo\fR for
character argument specifies the radix of the offset\-\-\-\fBo\fR for
octal, \fBx\fR for hexadecimal, or \fBd\fR for decimal.
octal, \fBx\fR for hexadecimal, or \fBd\fR for decimal.
.IP "\fB\-e\fR \fIencoding\fR" 4
.IP "\fB\-e\fR \fIencoding\fR" 4
.IX Item "-e encoding"
.IX Item "-e encoding"
.PD 0
.PD 0
.IP "\fB\-\-encoding=\fR\fIencoding\fR" 4
.IP "\fB\-\-encoding=\fR\fIencoding\fR" 4
.IX Item "--encoding=encoding"
.IX Item "--encoding=encoding"
.PD
.PD
Select the character encoding of the strings that are to be found.
Select the character encoding of the strings that are to be found.
Possible values for \fIencoding\fR are: \fBs\fR = single\-7\-bit\-byte
Possible values for \fIencoding\fR are: \fBs\fR = single\-7\-bit\-byte
characters (\s-1ASCII\s0, \s-1ISO\s0 8859, etc., default), \fBS\fR =
characters (\s-1ASCII\s0, \s-1ISO\s0 8859, etc., default), \fBS\fR =
single\-8\-bit\-byte characters, \fBb\fR = 16\-bit bigendian, \fBl\fR =
single\-8\-bit\-byte characters, \fBb\fR = 16\-bit bigendian, \fBl\fR =
16\-bit littleendian, \fBB\fR = 32\-bit bigendian, \fBL\fR = 32\-bit
16\-bit littleendian, \fBB\fR = 32\-bit bigendian, \fBL\fR = 32\-bit
littleendian.  Useful for finding wide character strings. (\fBl\fR
littleendian.  Useful for finding wide character strings. (\fBl\fR
and \fBb\fR apply to, for example, Unicode \s-1UTF\-16/UCS\-2\s0 encodings).
and \fBb\fR apply to, for example, Unicode \s-1UTF\-16/UCS\-2\s0 encodings).
.IP "\fB\-T\fR \fIbfdname\fR" 4
.IP "\fB\-T\fR \fIbfdname\fR" 4
.IX Item "-T bfdname"
.IX Item "-T bfdname"
.PD 0
.PD 0
.IP "\fB\-\-target=\fR\fIbfdname\fR" 4
.IP "\fB\-\-target=\fR\fIbfdname\fR" 4
.IX Item "--target=bfdname"
.IX Item "--target=bfdname"
.PD
.PD
Specify an object code format other than your system's default format.
Specify an object code format other than your system's default format.
.IP "\fB\-v\fR" 4
.IP "\fB\-v\fR" 4
.IX Item "-v"
.IX Item "-v"
.PD 0
.PD 0
.IP "\fB\-V\fR" 4
.IP "\fB\-V\fR" 4
.IX Item "-V"
.IX Item "-V"
.IP "\fB\-\-version\fR" 4
.IP "\fB\-\-version\fR" 4
.IX Item "--version"
.IX Item "--version"
.PD
.PD
Print the program version number on the standard output and exit.
Print the program version number on the standard output and exit.
.IP "\fB@\fR\fIfile\fR" 4
.IP "\fB@\fR\fIfile\fR" 4
.IX Item "@file"
.IX Item "@file"
Read command-line options from \fIfile\fR.  The options read are
Read command-line options from \fIfile\fR.  The options read are
inserted in place of the original @\fIfile\fR option.  If \fIfile\fR
inserted in place of the original @\fIfile\fR option.  If \fIfile\fR
does not exist, or cannot be read, then the option will be treated
does not exist, or cannot be read, then the option will be treated
literally, and not removed.
literally, and not removed.
.Sp
.Sp
Options in \fIfile\fR are separated by whitespace.  A whitespace
Options in \fIfile\fR are separated by whitespace.  A whitespace
character may be included in an option by surrounding the entire
character may be included in an option by surrounding the entire
option in either single or double quotes.  Any character (including a
option in either single or double quotes.  Any character (including a
backslash) may be included by prefixing the character to be included
backslash) may be included by prefixing the character to be included
with a backslash.  The \fIfile\fR may itself contain additional
with a backslash.  The \fIfile\fR may itself contain additional
@\fIfile\fR options; any such options will be processed recursively.
@\fIfile\fR options; any such options will be processed recursively.
.SH "SEE ALSO"
.SH "SEE ALSO"
.IX Header "SEE ALSO"
.IX Header "SEE ALSO"
\&\fIar\fR\|(1), \fInm\fR\|(1), \fIobjdump\fR\|(1), \fIranlib\fR\|(1), \fIreadelf\fR\|(1)
\&\fIar\fR\|(1), \fInm\fR\|(1), \fIobjdump\fR\|(1), \fIranlib\fR\|(1), \fIreadelf\fR\|(1)
and the Info entries for \fIbinutils\fR.
and the Info entries for \fIbinutils\fR.
.SH "COPYRIGHT"
.SH "COPYRIGHT"
.IX Header "COPYRIGHT"
.IX Header "COPYRIGHT"
Copyright (c) 1991, 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999,
Copyright (c) 1991, 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999,
2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009 Free Software Foundation, Inc.
2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009 Free Software Foundation, Inc.
.PP
.PP
Permission is granted to copy, distribute and/or modify this document
Permission is granted to copy, distribute and/or modify this document
under the terms of the \s-1GNU\s0 Free Documentation License, Version 1.3
under the terms of the \s-1GNU\s0 Free Documentation License, Version 1.3
or any later version published by the Free Software Foundation;
or any later version published by the Free Software Foundation;
with no Invariant Sections, with no Front-Cover Texts, and with no
with no Invariant Sections, with no Front-Cover Texts, and with no
Back-Cover Texts.  A copy of the license is included in the
Back-Cover Texts.  A copy of the license is included in the
section entitled \*(L"\s-1GNU\s0 Free Documentation License\*(R".
section entitled \*(L"\s-1GNU\s0 Free Documentation License\*(R".
 
 

powered by: WebSVN 2.1.0

© copyright 1999-2024 OpenCores.org, equivalent to Oliscience, all rights reserved. OpenCores®, registered trademark.