Utilities

Command line tools

mrcdump

Examine the contents of a file as hexadecimal.

usage: mrcdump [-h] [-r] [--no-hexdump] [--no-stats] [--no-offsets]
               [--no-glyphs] [--hist-w HIST_W] [--hist-h HIST_H] [--start INT]
               [--end INT] [--address-base INT] [--length INT]
               [--major-len INT] [--minor-len INT] [--plain] [--version]
               FILE [FILE ...]

Positional Arguments

FILE

File to inspect

Named Arguments

-r, --recursive

Read all files under each directory, recursively

--no-hexdump

Don’t render a hex dump

--no-stats

Don’t render statistics

--no-offsets

Don’t render line offsets

--no-glyphs

Don’t render the glyph map

--hist-w

Histogram width (default: 64)

--hist-h

Histogram height (default: 12)

--start

Start offset to read from (default: file start)

--end

End offset to stop reading at (default: end)

--address-base

Base address to use for labelling (default: start)

--length

Length to read in (optional replacement for –end)

--major-len

Number of hexadecimal groups per line (default: 8)

--minor-len

Number of bytes per hexadecimal group (default: 4)

--plain

Disable ANSI colour formatting

--version

show program’s version number and exit

mrcgrep

Display the contents of a file that match a pattern.

usage: mrcgrep [-h] [-r] [-F] [-H] [-i] [--encoding ENCODING] [--start INT]
               [--end INT] [--length INT] [--before INT] [--after INT]
               [--no-hexdump] [--version]
               PATTERN FILE [FILE ...]

Positional Arguments

PATTERN

Pattern to match

FILE

File to inspect

Named Arguments

-r, --recursive

Read all files under each directory, recursively

-F, --fixed-string

Interpret PATTERN as fixed string (disable regular expressions)

-H, --hex-format

Interpret strings in PATTERN as hexadecimal

-i, --ignore-case

Perform a case-insensitive search

--encoding

Convert strings in PATTERN to a specific Python encoding (default: utf8)

--start

Start offset to read from (default: file start)

--end

End offset to stop reading at (default: end)

--length

Length to read in (optional replacement for –end)

--before

Number of lines preceeding a match to show (default: 2)

--after

Number of lines following a match to show (default: 2)

--no-hexdump

Don’t render a hex dump

--version

show program’s version number and exit

For convenience, mrcgrep will interpret the pattern as UTF-8 and convert it to the bytes equivalent in the encoding you specify.

It is important to note when writing regular expressions, single character matches and counts are done at the encoded byte level, not at the UTF-8 level! This can lead to unexpected side-effects for rules, e.g. the pattern “[ů]” will translate to “[xc5xaf]”, which matches either the first or second byte. If you’re unsure, write your expressions using escaped hexadecimal bytes (e.g. “[xNN]”).

mrcdiff

Compare the contents of two files as hexadecimal.

usage: mrcdiff [-h] [--before INT] [--after INT] [--all] [--start INT]
               [--end INT] [--address-base INT] [--length INT]
               [--major-len INT] [--minor-len INT] [--plain] [--version]
               FILE1 FILE2

Positional Arguments

FILE1

File to inspect

FILE2

File to compare against

Named Arguments

--before

Number of lines preceeding a match to show (default: 2)

--after

Number of lines following a match to show (default: 2)

--all

Show all lines

--start

Start offset to read from (default: file start)

--end

End offset to stop reading at (default: end)

--address-base

Base address to use for labelling (default: start)

--length

Length to read in (optional replacement for –end)

--major-len

Number of hexadecimal groups per line (default: 8)

--minor-len

Number of bytes per hexadecimal group (default: 4)

--plain

Disable ANSI colour formatting

--version

show program’s version number and exit

mrchist

Display the contents of a file as a histogram map.

usage: mrchist [-h] [--start INT] [--end INT] [--address-base INT]
               [--length INT] [--samples INT] [--width INT] [-r] [--version]
               FILE [FILE ...]

Positional Arguments

FILE

File to inspect

Named Arguments

--start

Start offset to read from (default: file start)

--end

End offset to stop reading at (default: end)

--address-base

Base address to use for labelling (default: start)

--length

Length to read in (optional replacement for –end)

--samples

Number of samples per histogram slice (default: 65536)

--width

Histogram width (default: 64)

-r, --recursive

Read all files under each directory, recursively

--version

show program’s version number and exit

mrcpix

Display the contents of a file as a 256 colour image.

usage: mrcpix [-h] [--start INT] [--end INT] [--length INT] [--width INT] [-r]
              [--version]
              FILE [FILE ...]

Positional Arguments

FILE

File to inspect

Named Arguments

--start

Start offset to read from (default: file start)

--end

End offset to stop reading at (default: end)

--length

Length to read in (optional replacement for –end)

--width

Image width (default: 64)

-r, --recursive

Read all files under each directory, recursively

--version

show program’s version number and exit