FreeCalypso > hg > freecalypso-tools
comparison ffstools/README @ 0:e7502631a0f9
initial import from freecalypso-sw rev 1033:5ab737ac3ad7
| author | Mychaela Falconia <falcon@freecalypso.org> |
|---|---|
| date | Sat, 11 Jun 2016 00:13:35 +0000 |
| parents | |
| children |
comparison
equal
deleted
inserted
replaced
| -1:000000000000 | 0:e7502631a0f9 |
|---|---|
| 1 You are looking at the source for the TIFFS In Vitro Analyzer utility. You may | |
| 2 have downloaded it either as a separate package or as part of the larger | |
| 3 freecalypso-sw suite. | |
| 4 | |
| 5 See TIFFS-Overview (in ../doc if you are working with the full freecalypso-sw | |
| 6 source tree) for a general description of what TIFFS is and why it matters. | |
| 7 | |
| 8 The utility contained in the present package runs on a general purpose GNU/Linux | |
| 9 (or other Unix) host and enables "in vitro" examination of Flash File System | |
| 10 images read out of TI-based GSM devices. Using this utility, you can list the | |
| 11 directory and file content of an FFS image, cat any individual file in the FFS, | |
| 12 or extract the complete FFS content into your regular Unix file system. Some | |
| 13 "forensic" operations are also supported: by listing the inode array, one can | |
| 14 deduce the order in which the present FFS content got created, and see what | |
| 15 files have been overwritten or deleted in the span of still-visible history. | |
| 16 One can then cat the old byte content of those overwritten or deleted files, | |
| 17 if those data chunks are still in the FFS image (i.e., if the flash sector in | |
| 18 question has not been reclaimed yet). | |
| 19 | |
| 20 Compilation and installation are straightforward: run 'make' to compile the | |
| 21 source; you should get 3 executable binaries named tiffs, mokoffs and pirffs; | |
| 22 then run 'make install' as root to install them in /usr/local/bin. The binary | |
| 23 named tiffs is the main program; mokoffs and pirffs are wrappers that simplify | |
| 24 the most common current use cases. | |
| 25 | |
| 26 To install somewhere other than /usr/local/bin, edit the INSTBIN= setting in | |
| 27 the subdirectory Makefiles. You will also need to edit | |
| 28 tiffs-wrappers/installpath.c accordingly, as the mokoffs and pirffs wrappers | |
| 29 are designed to exec tiffs by its absolute installed pathname. | |
| 30 | |
| 31 See Usage for the usage instructions. |