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