Commit | Line | Data |
---|---|---|
c54ad9a4 MCC |
1 | .. SPDX-License-Identifier: GPL-2.0 |
2 | ||
3 | ========================= | |
1da177e4 | 4 | BeOS filesystem for Linux |
c54ad9a4 | 5 | ========================= |
1da177e4 LT |
6 | |
7 | Document last updated: Dec 6, 2001 | |
8 | ||
c54ad9a4 | 9 | Warning |
1da177e4 LT |
10 | ======= |
11 | Make sure you understand that this is alpha software. This means that the | |
c54ad9a4 | 12 | implementation is neither complete nor well-tested. |
1da177e4 | 13 | |
d6bc8ac9 | 14 | I DISCLAIM ALL RESPONSIBILITY FOR ANY POSSIBLE BAD EFFECTS OF THIS CODE! |
1da177e4 | 15 | |
c54ad9a4 MCC |
16 | License |
17 | ======= | |
18 | This software is covered by the GNU General Public License. | |
1da177e4 LT |
19 | See the file COPYING for the complete text of the license. |
20 | Or the GNU website: <http://www.gnu.org/licenses/licenses.html> | |
21 | ||
c54ad9a4 MCC |
22 | Author |
23 | ====== | |
1da177e4 LT |
24 | The largest part of the code written by Will Dyson <will_dyson@pobox.com> |
25 | He has been working on the code since Aug 13, 2001. See the changelog for | |
26 | details. | |
27 | ||
28 | Original Author: Makoto Kato <m_kato@ga2.so-net.ne.jp> | |
c54ad9a4 | 29 | |
992caacf | 30 | His original code can still be found at: |
1da177e4 | 31 | <http://hp.vector.co.jp/authors/VA008030/bfs/> |
c54ad9a4 | 32 | |
1da177e4 LT |
33 | Does anyone know of a more current email address for Makoto? He doesn't |
34 | respond to the address given above... | |
35 | ||
4c74916f | 36 | This filesystem doesn't have a maintainer. |
1da177e4 | 37 | |
c54ad9a4 MCC |
38 | What is this Driver? |
39 | ==================== | |
40 | This module implements the native filesystem of BeOS http://www.beincorporated.com/ | |
1da177e4 LT |
41 | for the linux 2.4.1 and later kernels. Currently it is a read-only |
42 | implementation. | |
43 | ||
44 | Which is it, BFS or BEFS? | |
c54ad9a4 MCC |
45 | ========================= |
46 | Be, Inc said, "BeOS Filesystem is officially called BFS, not BeFS". | |
1da177e4 | 47 | But Unixware Boot Filesystem is called bfs, too. And they are already in |
992caacf | 48 | the kernel. Because of this naming conflict, on Linux the BeOS |
1da177e4 LT |
49 | filesystem is called befs. |
50 | ||
c54ad9a4 | 51 | How to Install |
1da177e4 LT |
52 | ============== |
53 | step 1. Install the BeFS patch into the source code tree of linux. | |
54 | ||
55 | Apply the patchfile to your kernel source tree. | |
56 | Assuming that your kernel source is in /foo/bar/linux and the patchfile | |
57 | is called patch-befs-xxx, you would do the following: | |
58 | ||
59 | cd /foo/bar/linux | |
60 | patch -p1 < /path/to/patch-befs-xxx | |
61 | ||
62 | if the patching step fails (i.e. there are rejected hunks), you can try to | |
c54ad9a4 | 63 | figure it out yourself (it shouldn't be hard), or mail the maintainer |
1da177e4 LT |
64 | (Will Dyson <will_dyson@pobox.com>) for help. |
65 | ||
6c28f2c0 | 66 | step 2. Configuration & make kernel |
1da177e4 LT |
67 | |
68 | The linux kernel has many compile-time options. Most of them are beyond the | |
69 | scope of this document. I suggest the Kernel-HOWTO document as a good general | |
c54ad9a4 | 70 | reference on this topic. http://www.linuxdocs.org/HOWTOs/Kernel-HOWTO-4.html |
1da177e4 | 71 | |
c54ad9a4 | 72 | However, to use the BeFS module, you must enable it at configure time:: |
1da177e4 LT |
73 | |
74 | cd /foo/bar/linux | |
75 | make menuconfig (or xconfig) | |
76 | ||
77 | The BeFS module is not a standard part of the linux kernel, so you must first | |
78 | enable support for experimental code under the "Code maturity level" menu. | |
79 | ||
80 | Then, under the "Filesystems" menu will be an option called "BeFS | |
81 | filesystem (experimental)", or something like that. Enable that option | |
82 | (it is fine to make it a module). | |
83 | ||
84 | Save your kernel configuration and then build your kernel. | |
85 | ||
86 | step 3. Install | |
87 | ||
88 | See the kernel howto <http://www.linux.com/howto/Kernel-HOWTO.html> for | |
89 | instructions on this critical step. | |
90 | ||
c54ad9a4 | 91 | Using BFS |
1da177e4 LT |
92 | ========= |
93 | To use the BeOS filesystem, use filesystem type 'befs'. | |
94 | ||
c54ad9a4 MCC |
95 | ex:: |
96 | ||
1da177e4 LT |
97 | mount -t befs /dev/fd0 /beos |
98 | ||
c54ad9a4 | 99 | Mount Options |
1da177e4 | 100 | ============= |
c54ad9a4 MCC |
101 | |
102 | ============= =========================================================== | |
1da177e4 LT |
103 | uid=nnn All files in the partition will be owned by user id nnn. |
104 | gid=nnn All files in the partition will be in group nnn. | |
105 | iocharset=xxx Use xxx as the name of the NLS translation table. | |
106 | debug The driver will output debugging information to the syslog. | |
c54ad9a4 | 107 | ============= =========================================================== |
1da177e4 | 108 | |
c54ad9a4 | 109 | How to Get Lastest Version |
1da177e4 LT |
110 | ========================== |
111 | ||
112 | The latest version is currently available at: | |
113 | <http://befs-driver.sourceforge.net/> | |
114 | ||
c54ad9a4 MCC |
115 | Any Known Bugs? |
116 | =============== | |
1da177e4 | 117 | As of Jan 20, 2002: |
c54ad9a4 | 118 | |
1da177e4 LT |
119 | None |
120 | ||
c54ad9a4 | 121 | Special Thanks |
1da177e4 LT |
122 | ============== |
123 | Dominic Giampalo ... Writing "Practical file system design with Be filesystem" | |
c54ad9a4 | 124 | |
1da177e4 LT |
125 | Hiroyuki Yamada ... Testing LinuxPPC. |
126 | ||
127 | ||
128 |