table of contents
| ddbg(1) | Gromox admin reference | ddbg(1) |
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 |