| 1 | ***IMPORTANT*** | 
| 2 | This package is renamed kernel-patch-fat-epoc. The old package, called | 
| 3 | kernel-patch-fat-old, should not be used anymore. The mount option for | 
| 4 | 2.6 kernels, previously called `oldfat' is renamed `epoc'. | 
| 5 | ***IMPORTANT*** | 
| 6 |  | 
| 7 |  | 
| 8 | Introduction | 
| 9 | ------------ | 
| 10 |  | 
| 11 | In the FAT standard the end of the directory file index is marked by 00. | 
| 12 | All entries after it should be ignored. The current FAT implementation | 
| 13 | ignores such marked entries, but continues scanning the directory. This | 
| 14 | is good enough for most FAT implementations, because they also mark all | 
| 15 | remaining entries after the last with a 00 byte. | 
| 16 |  | 
| 17 | The filesystem implementation of EPOC 5(MX) (and probably of newer versions | 
| 18 | of EPOC) does not clear old entries after the end of the directory file | 
| 19 | index. This means that without this patch, Linux will show old previously | 
| 20 | deleted or even never assigned entries. | 
| 21 |  | 
| 22 | This patch will affect FAT-based filesystems. Examples are filesystems | 
| 23 | of the type `msdos' or `vfat'. | 
| 24 |  | 
| 25 | The patch for 2.6 kernels is not active, unless you specify the epoc mount | 
| 26 | option. For example: | 
| 27 | mount /dev/sda1 /mnt/psion-epoc -t vfat -o epoc | 
| 28 |  | 
| 29 | The patch for 2.4 kernels has some known issues. All FAT-based partitions | 
| 30 | will use the new policy; there is no mount option. In most cases it should | 
| 31 | work well enough; if you want to be completely safe, mount FAT-based | 
| 32 | partitions read-only. | 
| 33 |  | 
| 34 |  | 
| 35 | Applying the patches | 
| 36 | -------------------- | 
| 37 |  | 
| 38 | There are several patches included in this package: | 
| 39 | fat-epoc-2.4.20.diff            For any 2.4 kernel | 
| 40 | fat-epoc-2.6.0.diff             For 2.6.0 to 2.6.10 kernels | 
| 41 | fat-epoc-2.6.11.diff            For 2.6.11 kernels | 
| 42 | fat-epoc-2.6.12.diff            For 2.6.12, 2.6.13 and 2.6.14 kernels | 
| 43 | fat-epoc-2.6.15.diff            For 2.6.15 to 2.6.18 kernels | 
| 44 | fat-epoc-2.6.19.diff            For 2.6.19, 2.6.20 and 2.6.21 kernels | 
| 45 | fat-epoc-2.6.22.diff            For 2.6.22 and newer kernels | 
| 46 | Choose the patch that fits your kernel. | 
| 47 |  | 
| 48 | Now go to the kernel base directory (often called /usr/src/linux) and issue | 
| 49 | the following command: | 
| 50 | patch -p1 -E < PATCHFILE | 
| 51 | If you want to see what will happen without applying the patch, try: | 
| 52 | patch -p1 -E --dry-run < PATCHFILE | 
| 53 | You may get a few messages about offsets; this is normal. But no fuzzy matches | 
| 54 | should be reported, and certainly no rejects. | 
| 55 |  | 
| 56 | After this compile your kernel as usual. | 
| 57 |  | 
| 58 |  | 
| 59 | Debian users | 
| 60 | ------------ | 
| 61 |  | 
| 62 | There is also a Debian version of this package. If you install it, and compile | 
| 63 | your kernel "the Debian way", the right patch will be applied automatically. | 
| 64 | Get it at the same place as this package (see Contact). | 
| 65 |  | 
| 66 |  | 
| 67 | Contact and copyright | 
| 68 | --------------------- | 
| 69 |  | 
| 70 | This package (kernel-package-fat-epoc or fat-epoc) is | 
| 71 | copyright (c) 2003-2007  Frodo Looijaard <frodo@frodo.looijaard.name> | 
| 72 |  | 
| 73 | This program is free software; you can redistribute it and/or modify | 
| 74 | it under the terms of the GNU General Public License as published by | 
| 75 | the Free Software Foundation; either version 2 of the License, or | 
| 76 | (at your option) any later version. | 
| 77 |  | 
| 78 | This program is distributed in the hope that it will be useful, | 
| 79 | but WITHOUT ANY WARRANTY; without even the implied warranty of | 
| 80 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the | 
| 81 | GNU General Public License for more details. | 
| 82 |  | 
| 83 | You should have received a copy of the GNU General Public License | 
| 84 | along with this program; if not, write to the Free Software | 
| 85 | Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. | 
| 86 |  | 
| 87 | The GPL text can be found in the file COPYING. | 
| 88 |  | 
| 89 |  | 
| 90 | The latest version of this package can be found on: | 
| 91 | http://software.frodo.looijaard.name/fat-epoc/ | 
| 92 |  | 
| 93 | Contact the author (Frodo Looijaard) by mailing to: | 
| 94 | frodo@frodo.looijaard.name |