1923ebb416
llvmorg-10.0.1-rc2-0-g77d76b71d7d. Also add a few more llvm utilities under WITH_CLANG_EXTRAS: * llvm-dwp, a utility for merging DWARF 5 Split DWARF .dwo files into .dwp (DWARF package files) * llvm-size, a size(1) replacement * llvm-strings, a strings(1) replacement MFC after: 3 weeks
180 lines
3.9 KiB
Groff
180 lines
3.9 KiB
Groff
.\" $FreeBSD$
|
|
.\" Man page generated from reStructuredText.
|
|
.
|
|
.TH "LLVM-STRINGS" "1" "2020-06-26" "10" "LLVM"
|
|
.SH NAME
|
|
llvm-strings \- print strings
|
|
.
|
|
.nr rst2man-indent-level 0
|
|
.
|
|
.de1 rstReportMargin
|
|
\\$1 \\n[an-margin]
|
|
level \\n[rst2man-indent-level]
|
|
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
|
-
|
|
\\n[rst2man-indent0]
|
|
\\n[rst2man-indent1]
|
|
\\n[rst2man-indent2]
|
|
..
|
|
.de1 INDENT
|
|
.\" .rstReportMargin pre:
|
|
. RS \\$1
|
|
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
|
|
. nr rst2man-indent-level +1
|
|
.\" .rstReportMargin post:
|
|
..
|
|
.de UNINDENT
|
|
. RE
|
|
.\" indent \\n[an-margin]
|
|
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
|
.nr rst2man-indent-level -1
|
|
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
|
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
|
|
..
|
|
.SH SYNOPSIS
|
|
.sp
|
|
\fBllvm\-strings\fP [\fIoptions\fP] [\fIinput...\fP]
|
|
.SH DESCRIPTION
|
|
.sp
|
|
\fBllvm\-strings\fP is a tool intended as a drop\-in replacement for GNU\(aqs
|
|
\fBstrings\fP, which looks for printable strings in files and writes them
|
|
to the standard output stream. A printable string is any sequence of four (by
|
|
default) or more printable ASCII characters. The end of the file, or any other
|
|
byte, terminates the current sequence.
|
|
.sp
|
|
\fBllvm\-strings\fP looks for strings in each \fBinput\fP file specified.
|
|
Unlike GNU \fBstrings\fP it looks in the entire input file, regardless of
|
|
file format, rather than restricting the search to certain sections of object
|
|
files. If "\fB\-\fP" is specified as an \fBinput\fP, or no \fBinput\fP is specified,
|
|
the program reads from the standard input stream.
|
|
.SH EXAMPLE
|
|
.INDENT 0.0
|
|
.INDENT 3.5
|
|
.sp
|
|
.nf
|
|
.ft C
|
|
$ cat input.txt
|
|
bars
|
|
foo
|
|
wibble blob
|
|
$ llvm\-strings input.txt
|
|
bars
|
|
wibble blob
|
|
.ft P
|
|
.fi
|
|
.UNINDENT
|
|
.UNINDENT
|
|
.SH OPTIONS
|
|
.INDENT 0.0
|
|
.TP
|
|
.B \-\-all, \-a
|
|
Silently ignored. Present for GNU \fBstrings\fP compatibility.
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B \-\-bytes=<length>, \-n
|
|
Set the minimum number of printable ASCII characters required for a sequence of
|
|
bytes to be considered a string. The default value is 4.
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B \-\-help, \-h
|
|
Display a summary of command line options.
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B \-\-help\-list
|
|
Display an uncategorized summary of command line options.
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B \-\-print\-file\-name, \-f
|
|
Display the name of the containing file before each string.
|
|
.sp
|
|
Example:
|
|
.INDENT 7.0
|
|
.INDENT 3.5
|
|
.sp
|
|
.nf
|
|
.ft C
|
|
$ llvm\-strings \-\-print\-file\-name test.o test.elf
|
|
test.o: _Z5hellov
|
|
test.o: some_bss
|
|
test.o: test.cpp
|
|
test.o: main
|
|
test.elf: test.cpp
|
|
test.elf: test2.cpp
|
|
test.elf: _Z5hellov
|
|
test.elf: main
|
|
test.elf: some_bss
|
|
.ft P
|
|
.fi
|
|
.UNINDENT
|
|
.UNINDENT
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B \-\-radix=<radix>, \-t
|
|
Display the offset within the file of each string, before the string and using
|
|
the specified radix. Valid \fB<radix>\fP values are \fBo\fP, \fBd\fP and \fBx\fP for
|
|
octal, decimal and hexadecimal respectively.
|
|
.sp
|
|
Example:
|
|
.INDENT 7.0
|
|
.INDENT 3.5
|
|
.sp
|
|
.nf
|
|
.ft C
|
|
$ llvm\-strings \-\-radix=o test.o
|
|
1054 _Z5hellov
|
|
1066 .rela.text
|
|
1101 .comment
|
|
1112 some_bss
|
|
1123 .bss
|
|
1130 test.cpp
|
|
1141 main
|
|
$ llvm\-strings \-\-radix=d test.o
|
|
556 _Z5hellov
|
|
566 .rela.text
|
|
577 .comment
|
|
586 some_bss
|
|
595 .bss
|
|
600 test.cpp
|
|
609 main
|
|
$ llvm\-strings \-t x test.o
|
|
22c _Z5hellov
|
|
236 .rela.text
|
|
241 .comment
|
|
24a some_bss
|
|
253 .bss
|
|
258 test.cpp
|
|
261 main
|
|
.ft P
|
|
.fi
|
|
.UNINDENT
|
|
.UNINDENT
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B \-\-version
|
|
Display the version of the \fBllvm\-strings\fP executable.
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B @<FILE>
|
|
Read command\-line options from response file \fB<FILE>\fP\&.
|
|
.UNINDENT
|
|
.SH EXIT STATUS
|
|
.sp
|
|
\fBllvm\-strings\fP exits with a non\-zero exit code if there is an error.
|
|
Otherwise, it exits with code 0.
|
|
.SH BUGS
|
|
.sp
|
|
To report bugs, please visit <\fI\%http://llvm.org/bugs/\fP>.
|
|
.SH AUTHOR
|
|
Maintained by the LLVM Team (https://llvm.org/).
|
|
.SH COPYRIGHT
|
|
2003-2020, LLVM Project
|
|
.\" Generated by docutils manpage writer.
|
|
.
|