readme.md
1# .STRINGS dot command
2
3To use, copy "STRINGS" to the sd card's DOT directory.
4
5## Compiling
6
7```
8zcc +zxn -v -startup=30 -clib=sdcc_iy -SO3 --max-allocs-per-node200000 --opt-code-size @zproject.lst -o strings -pragma-include:zpragma.inc -subtype=dot-n -Cz"--clean" -create-app
9```
10
11## Usage
12
13`.strings` entered on its own at the basic prompt will print help.
14
15This utility searches for ascii text strings stored in files. Results can be printed to screen or saved to an output file.
16
17The help text is reproduced here:
18
19~~~
20.strings file [-n num]
21 [-s string] [-t {o,d,x}]
22 [-w] [-f] [-o file] [-a file]
23
24 -n = set min string len (4)
25 -s = print separator ("\n")
26 -t = file offset dec/oct/hex
27 -w = make \r\n part of string
28
29 -f = overwrite permitted
30 -o = output filename
31 -a = append filename
32
33no -o,-a prints to screen
34
35strings v1.2 zx-next z88dk.org
36~~~
37
38## Examples
39
401. Look for strings at least 6 chars long. If found print the file offset in hex along with the string. Output to screen.
41
42```
43.strings knight.sna -n 6 -t X
44```
45
462. Look for strings and save findings to an output file. Print file offset in decimal and print a separator between findings.
47
48```
49.strings knight.sna -t d -s ------- -o string.txt
50```
51