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