reveng-tools - collection of linux firmware reverse engineering tools
=====================================================================

While in the process of analyzing accused copyright infringement cases of my
GPL licensed code, I found the neccessity to develop a couple of helpful tools
to automatize some parts of that process.

Embedded Linux devices become more and more common, and other authors of free
software might be interested in using these tools to verify the potentially
infringing use of their software in those devices.

Please note that the tools are focused at extracting information out of a
binary firmware image, rather than on retrieving the firmware image from the
device.   In most cases the latter is not neccessarry, since firmware images
are distributed as updates via internet.

- Harald Welte <laforge@gnumonks.org>


Description of the individual tools 
=====================================================================

magic_ofs	tries to find 'magic' bytes at every offset within a given
		file.  works like 'file', just at every offset instead only
		at the beginning.

blft_decompress	extract a bFLT executable with gzip'ed sections

cramfs_extract	extract a cramfs (Compressed ROMFS) filesystem independent
		of the host endinanness

romfsc		check (and extract) a ROMFS filesystem.  Supposed to work
		similar to cramfsck, including the '-x' option for extract.
	

Questions, Discussion, ...
=====================================================================

Please do not contact me directly with questions about how to use this program.
Instead, use the reveng-tools@lists.gnumonks.org mailinglist.  The web frontend including archives is available at https://lists.gnumonks.org/cgi-bin/mailman/listinfo/reveng-tools