Repository files navigation

xxd is a very good hexdump program that makes editing files on UNIX very easy.It also doesn't support text-tables. Which sucks.

eksd is a clone of a good hexdump program (even matching several argumentsexactly)… except it supports text-tables.

To see a hexdump of a file, just run:

$ eksd $FILE > $HEXDUMP_FILE

If you want to turn a hexdump (from eksd or xxd) back to a file:

$ eksd -r $HEXDUMP_FILE > $FILE

And to make a hexdump with a custom text-table:

$ eksd -t $TABLE_FILE $FILE > $HEXDUMP_FILE

Text-tables are in a simple format— one hexcode per line, followed by itscharacter. See./text_tables/* for examples.

By default, eksd uses a built-infancy text-table— it's basic ASCII,except it'll print nice pictographics for newline characters, etc. Theserequire UTF, of course. If they don't work for you, use the "-a" arg torevert to simple, non-fancy ASCII.Note that specifying a text-table will override "-a", though.

Here's a part of Castlevania (EU) for the NES using its text-table:

$ eksd -t castle-table.txt castlevania.nes  | grep -A4 "18e80"00018e80: 5454 5454 866e 6854 6460 8486 5454 5454  ....THE.CAST....00018e90: 5454 5454 5466 8260 6488 7660 5454 5454  .....DRACULA....00018ea0: 5464 6e82 7084 867c 7e6e 6882 5462 6868  .CHRISTOPHER.BEE00018eb0: 5454 5454 5454 6668 6086 6e54 5454 5454  ......DEATH.....00018ec0: 5454 5462 6876 7c54 7688 6c7c 8470 5454  ...BELO.LUGOSI..

And here's that same file inVim’s xxd (just because I feel like showing off):

$ xxd castlevania.nes | grep -A4 "18e80"00018e80: 5454 5454 866e 6854 6460 8486 5454 5454  TTTT.nhTd`..TTTT00018e90: 5454 5454 5466 8260 6488 7660 5454 5454  TTTTTf.`d.v`TTTT00018ea0: 5464 6e82 7084 867c 7e6e 6882 5462 6868  Tdn.p..|~nh.Tbhh00018eb0: 5454 5454 5454 6668 6086 6e54 5454 5454  TTTTTTfh`.nTTTTT00018ec0: 5454 5462 6876 7c54 7688 6c7c 8470 5454  TTTbhv|Tv.l|.pTT

Making a binary requiresan implementation of Common Lisp installed:Steel Bank Common Lisp is our implementation-of-choice. It’s available onmost operating systems under the package namesbcl.

You also need the library-managerQuicklisp, which canbe installedquite easily, including via ourMakefile.

To install Quicklisp, build a binary, and install it, simply:

$ make quicklisp$ make build$ sudo cp eksd /usr/local/bin/eksd

Bam, you've made and installed a binary! Cool!

eksd’s tests can be run from a REPL usingASDF:TEST-SYSTEM, or from theMakefile target “test”.

* (asdf:test-system :eksd)* (asdf:test-system :eksd/unix)

`$ make test

• License is the GNU GPLv3 (COPYING.txt)
• Author is Jaidyn Annjadedctrl@posteo.at
• Sauce is athttps://hak.xwx.moe/jadedctrl/eksd