Contents of /fat-epoc/trunk/README

***IMPORTANT***
  This package is renamed kernel-patch-fat-epoc. The old package, called
  kernel-patch-fat-old, should not be used anymore. The mount option for
  2.6 kernels, previously called `oldfat' is renamed `epoc'.
***IMPORTANT***


Introduction
------------

In the FAT standard the end of the directory file index is marked by 00.
All entries after it should be ignored. The current FAT implementation
ignores such marked entries, but continues scanning the directory. This
is good enough for most FAT implementations, because they also mark all
remaining entries after the last with a 00 byte.

The filesystem implementation of EPOC 5(MX) (and probably of newer versions
of EPOC) does not clear old entries after the end of the directory file
index. This means that without this patch, Linux will show old previously
deleted or even never assigned entries.

This patch will affect FAT-based filesystems. Examples are filesystems
of the type `msdos' or `vfat'.

The patch for 2.6 kernels is not active, unless you specify the epoc mount
option. For example:
    mount /dev/sda1 /mnt/psion-epoc -t vfat -o epoc

The patch for 2.4 kernels has some known issues. All FAT-based partitions
will use the new policy; there is no mount option. In most cases it should
work well enough; if you want to be completely safe, mount FAT-based
partitions read-only.


Applying the patches
--------------------

There are several patches included in this package:
        fat-epoc-2.4.20.diff            For any 2.4 kernel
        fat-epoc-2.6.0.diff             For 2.6.0 to 2.6.10 kernels
        fat-epoc-2.6.11.diff            For 2.6.11 kernels
        fat-epoc-2.6.12.diff            For 2.6.12, 2.6.13 and 2.6.14 kernels
        fat-epoc-2.6.15.diff            For 2.6.15 and newer kernels
Choose the patch that fits your kernel.

Now go to the kernel base directory (often called /usr/src/linux) and issue
the following command:
        patch -p1 -E < PATCHFILE
If you want to see what will happen without applying the patch, try:
        patch -p1 -E --dry-run < PATCHFILE
You may get a few messages about offsets; this is normal. But no fuzzy matches
should be reported, and certainly no rejects.

After this compile your kernel as usual.


Debian users
------------

There is also a Debian version of this package. If you install it, and compile
your kernel "the Debian way", the right patch will be applied automatically.
Get it at the same place as this package (see Contact). 


Contact and copyright
---------------------

    This package (kernel-package-fat-epoc or fat-epoc) is
    copyright (c) 2003-2007  Frodo Looijaard <frodo@frodo.looijaard.name>

    This program is free software; you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by
    the Free Software Foundation; either version 2 of the License, or
    (at your option) any later version.

    This program is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    GNU General Public License for more details.

    You should have received a copy of the GNU General Public License
    along with this program; if not, write to the Free Software
    Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.

The GPL text can be found in the file COPYING.


The latest version of this package can be found on:
    http://software.frodo.looijaard.name/fat-epoc/

Contact the author (Frodo Looijaard) by mailing to:
    frodo@frodo.looijaard.name
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 and newer kernels
44	Choose the patch that fits your kernel.
45
46	Now go to the kernel base directory (often called /usr/src/linux) and issue
47	the following command:
48	patch -p1 -E < PATCHFILE
49	If you want to see what will happen without applying the patch, try:
50	patch -p1 -E --dry-run < PATCHFILE
51	You may get a few messages about offsets; this is normal. But no fuzzy matches
52	should be reported, and certainly no rejects.
53
54	After this compile your kernel as usual.
55
56
57	Debian users
58	------------
59
60	There is also a Debian version of this package. If you install it, and compile
61	your kernel "the Debian way", the right patch will be applied automatically.
62	Get it at the same place as this package (see Contact).
63
64
65	Contact and copyright
66	---------------------
67
68	This package (kernel-package-fat-epoc or fat-epoc) is
69	copyright (c) 2003-2007 Frodo Looijaard <frodo@frodo.looijaard.name>
70
71	This program is free software; you can redistribute it and/or modify
72	it under the terms of the GNU General Public License as published by
73	the Free Software Foundation; either version 2 of the License, or
74	(at your option) any later version.
75
76	This program is distributed in the hope that it will be useful,
77	but WITHOUT ANY WARRANTY; without even the implied warranty of
78	MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
79	GNU General Public License for more details.
80
81	You should have received a copy of the GNU General Public License
82	along with this program; if not, write to the Free Software
83	Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
84
85	The GPL text can be found in the file COPYING.
86
87
88	The latest version of this package can be found on:
89	http://software.frodo.looijaard.name/fat-epoc/
90
91	Contact the author (Frodo Looijaard) by mailing to:
92	frodo@frodo.looijaard.name
frodo@frodo.looijaard.name	ViewVC Help
Powered by ViewVC 1.1.26