#search #search-pattern #pattern #byte-sequences #grep #binary #ascii-text

bin+lib grep_bin

Searches recursively a directory or multiple files for a sequence of bytes or ASCII string

8 stable releases

2.0.0 Mar 2, 2022
1.2.1 Dec 22, 2021
1.1.1 Nov 26, 2021
1.0.0 Aug 3, 2021
0.1.0 Aug 3, 2021

#2758 in Command line utilities

Download history 30/week @ 2024-03-29 11/week @ 2024-04-05 8/week @ 2024-04-12 27/week @ 2024-04-19 11/week @ 2024-04-26 19/week @ 2024-05-03 11/week @ 2024-05-17 5/week @ 2024-05-24 56/week @ 2024-05-31 53/week @ 2024-06-07 5/week @ 2024-06-14 30/week @ 2024-06-21 136/week @ 2024-06-28 16/week @ 2024-07-05 304/week @ 2024-07-12

486 downloads per month

Custom license

20KB
388 lines

grep_bin

grep_bin can search recursively a directory or multiple files for a sequence of bytes or ascii string.

Usage

Searching for a byte sequence in a file

$ grep_bin fffe test.bin

Searching recursively a directory for a byte sequence

$ grep_bin FFFE ~/Downloads

Filtering the filetypes

$ grep_bin -f mp3 FFfe0000 ~/Downloads

Search for an ASCII string inside the binary

$ grep_bin '"Hello World"' test.bin

Search for an ASCII string with quotes included: $ grep_bin '"This is a \"quote\""' test.bin

Search a byte sequence in multiple files

$ grep_bin fFFe test1.bin test2.bin

Specify the number of bytes per line in the output

$ grep_bin -c 32 "information" README.md

Output:

README.md
00000320:  73 20 68 65 6C 70 20 69  6E 66 6F 72 6D 61 74 69  6F 6E 0A 0A 20 20 20 20  2D 56 2C 20 2D 2D 76 65   |s help information..    -V, --ve|
00000360:  73 69 6F 6E 20 69 6E 66  6F 72 6D 61 74 69 6F 6E  0A 0A 0A 4F 50 54 49 4F  4E 53 3A 0A 20 20 20 20   |sion information...OPTIONS:.    |
  • the characters in bold represent the colored match

Help

$ grep_bin -h

grep_bin 2.0.0
LaBatata101 <labatata101@linuxmail.org>
Searches recursively a directory or multiple files for a sequence of bytes or ASCII string.

USAGE:
    grep_bin [OPTIONS] <PATTERN> <FILE>...

ARGS:
    <PATTERN>    Ascii strings should be passed inside quotes like so '"This is a string"'
                 Escaping quotes '"This is a \"quoted string\""'
                 All of these byte sequence are valid: f9b4ca, F9B4CA and f9B4Ca
    <FILE>...    The filepath

OPTIONS:
    -c <context_bytes_size>        Defines the number of bytes that will be printed in each line.
                                   [default: 16]
    -f <filetype>                  Filter the search by the file extensions.
                                   Examples of input: jpg, mp3, exe
    -h, --help                     Print help information
    -o, --print-offset             Prints only the offsets of the match.
    -p, --print-only               Prints only the filename that contais the match.
    -s, --skip-bytes <n>           Skip n bytes before searching. [default: 0]
    -V, --version                  Print version information

Building Manually

Dependencies

  • rustc(latest version)
  • cargo

$ git clone https://github.com/LaBatata101/grep_bin

$ cd grep_bin/

$ cargo build --release

The final binary will be in target/release/

Installing with Cargo

cargo install grep_bin

Dependencies

~2MB
~25K SLoC