ddbg(1gx)

Name

ddbg — MAPI data debugger

Synopsis

/usr/libexec/gromox/ddbg [options...] command [args...]

Description

ddbg can be used to analyze binary blobs, convert between data formats, or query various text/ID mappings commonly used in MAPI. If no arguments are given, input is read from stdin. If arguments are given, they are treated as immediate values (i.e. content, never the name of a file to read).

Options

-p, --pack
Employ hex2bin before main action.

-X
When converting RTF to HTML, transform images not into <img> tags with in-line image data using a data: URI, but into external references utilizing a cid: URI. ddbg will not emit the image in this case.

Commands

--bin2hex
Convert all bytes to hexnibble representation.

--bin2txt
Convert all bytes to a textual representation. The environment variable BIN2TXT_MODE can be used to influence the output. Possible values are cstr (output as a C string literal without surrounding quotes), hex (hex nibbles like bin2hex), txt (custom compact encoding).

--cpidtocset
For a given character set identified by numeric IBM/Microsoft codepage identifier, show the corresponding IANA name.

--csettocpid
For a given character set identified by its IANA name, show the corresponding numeric IBM/Microsoft codepage identifer.

-d, --decode
Try all decoders.

-A, --decode-action
Decode rule action blob.

-e, --decode-entryid
Decode entryid.

--decode-guid
Lookup GUID.

--decode-nttime
Decode an NT timestamp and show the equivalent Unix time and calendar-based date.

--decode-restrict
Decode restriction blob (e.g. rule condition).

--decode-unixtime
Decode an Unix timestamp and show the equivalent NT time and calendar-based date.

--exttomime
For a given filename extension (e.g. "bmp"), show the most likely MIME type (IANA Media Type) that it represents.

--htmltortf
Convert a HTML document to RTF.

--htmltotext
Convert a HTML document to plaintext.

--langtocset
Show the preferred 8-bit character set associated with a given language tag (identifier in the style of XPG4 locales, but only a few well-known fixed strings are accepted, e.g. "zh_TW").

--langtolcid
For a given language tag (RFC 5646 form, e.g. "en-US"), show the corresponding numeric Windows locale identifier (LCID).

--lcidtolang
For a given numeric Windows locale identifier, show the corresponding langauge tag.

--mdigest
Produce an MJSON digest object for a RFC5322 message.

--mimetoext
For a given MIME type (IANA Media Type), show the typical filename extension used for it.

--lzxdec
Uncompress an lzxpress data stream.

--lzxenc
Compress data stream with lzxpress.

--qpdecode
Decode some Quoted-Printable text.

--qpencode
Encode some text as Quoted-Printable (with line wrapping).

--rtfcp
Convert RTF to the RTFCP format, particularly the uncompressed "MELA" subformat.

--rtftohtml
Convert RTF to HTML.

--texttohtml
Convert plaintext to HTML.

--unrtfcp
Decompress RTFCP (either "MELA" or "LZFU") to RTF.

Environment variables

GROMOX_HTMLTOPLAIN can be set to "chawan", "pandoc", "w3m", "internal" to pick one particular htmltoplain implementation. If unset or set to "auto", all of these converters are tried until a working one is found.

GROMOX_HTMLTORTF can be set to "pandoc" or "internal" to pick a particular htmltortf implementation. If unset or set to "auto", all of these converters are tried until a working one is found.

GROMOX_RTFTOHTML can be set to "pandoc", "internal" or "internal.asi" to pick a particular htmltortf implementation. If unset or set to "auto", all of these converters are tried until a working one is found.

Examples

• ddbg -p --decode-guid 38a1bb1005e5101aa1bb08002b2a56c2

• ddbg --unrtfcp <body.bin >body.rtf

• ddbg --proptag 0x3001001f

• ddbg --exttomime bmp

See also

gromox(7)