BSD 4_3_Reno release
[unix-history] / usr / src / pgrm / strings / strings.1
CommitLineData
daacd5f0 1.\" Copyright (c) 1980, 1990 The Regents of the University of California.
e316c02c 2.\" All rights reserved.
3a1a282a 3.\"
1c15e888
C
4.\" Redistribution and use in source and binary forms are permitted provided
5.\" that: (1) source distributions retain this entire copyright notice and
6.\" comment, and (2) distributions including binaries display the following
7.\" acknowledgement: ``This product includes software developed by the
8.\" University of California, Berkeley and its contributors'' in the
9.\" documentation or other materials provided with the distribution and in
10.\" all advertising materials mentioning features or use of this software.
11.\" Neither the name of the University nor the names of its contributors may
12.\" be used to endorse or promote products derived from this software without
13.\" specific prior written permission.
14.\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR IMPLIED
15.\" WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
16.\" MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
e316c02c 17.\"
1c15e888 18.\" @(#)strings.1 6.7 (Berkeley) 6/24/90
3a1a282a 19.\"
daacd5f0 20.TH STRINGS 1 "%Q"
3a1a282a
KM
21.UC
22.SH NAME
e8d9c970 23strings \- find the printable strings in a file
3a1a282a 24.SH SYNOPSIS
61539330
KB
25.ft B
26strings [ \-ao ] [ \-n number ] [ file ... ]
27.ft R
3a1a282a 28.SH DESCRIPTION
61539330
KB
29.I String
30displays the sequences of printable characters in each of the specified
31files, or in the standard input, by default.
32By default, a sequence must be at least four characters in length
33before being displayed.
3a1a282a 34.PP
61539330
KB
35The options are as follows:
36.TP
37\-a
38By default,
39.I strings
40only searches the initialized data space of object files.
41The
42.I \-a
43option causes
44.I strings
45to search the entire object file.
46.TP
47\-n
48Specifies the minimum number of characters in a sequence to be
49.IR number ,
50instead of four.
51.TP
52\-o
53The
54.I \-o
55option causes each string to be preceded by its decimal offset in the
56file.
57.PP
58.I Strings
59is useful for identifying random binaries, among other things.
3a1a282a 60.SH "SEE ALSO"
61539330 61hexdump(1)
3a1a282a 62.SH BUGS
570d12e7 63The algorithm for identifying strings is extremely primitive.