0001 .. SPDX-License-Identifier: GPL-2.0
0002
0003 =========================
0004 BeOS filesystem for Linux
0005 =========================
0006
0007 Document last updated: Dec 6, 2001
0008
0009 Warning
0010 =======
0011 Make sure you understand that this is alpha software. This means that the
0012 implementation is neither complete nor well-tested.
0013
0014 I DISCLAIM ALL RESPONSIBILITY FOR ANY POSSIBLE BAD EFFECTS OF THIS CODE!
0015
0016 License
0017 =======
0018 This software is covered by the GNU General Public License.
0019 See the file COPYING for the complete text of the license.
0020 Or the GNU website: <http://www.gnu.org/licenses/licenses.html>
0021
0022 Author
0023 ======
0024 The largest part of the code written by Will Dyson <will_dyson@pobox.com>
0025 He has been working on the code since Aug 13, 2001. See the changelog for
0026 details.
0027
0028 Original Author: Makoto Kato <m_kato@ga2.so-net.ne.jp>
0029
0030 His original code can still be found at:
0031 <http://hp.vector.co.jp/authors/VA008030/bfs/>
0032
0033 Does anyone know of a more current email address for Makoto? He doesn't
0034 respond to the address given above...
0035
0036 This filesystem doesn't have a maintainer.
0037
0038 What is this Driver?
0039 ====================
0040 This module implements the native filesystem of BeOS http://www.beincorporated.com/
0041 for the linux 2.4.1 and later kernels. Currently it is a read-only
0042 implementation.
0043
0044 Which is it, BFS or BEFS?
0045 =========================
0046 Be, Inc said, "BeOS Filesystem is officially called BFS, not BeFS".
0047 But Unixware Boot Filesystem is called bfs, too. And they are already in
0048 the kernel. Because of this naming conflict, on Linux the BeOS
0049 filesystem is called befs.
0050
0051 How to Install
0052 ==============
0053 step 1. Install the BeFS patch into the source code tree of linux.
0054
0055 Apply the patchfile to your kernel source tree.
0056 Assuming that your kernel source is in /foo/bar/linux and the patchfile
0057 is called patch-befs-xxx, you would do the following:
0058
0059 cd /foo/bar/linux
0060 patch -p1 < /path/to/patch-befs-xxx
0061
0062 if the patching step fails (i.e. there are rejected hunks), you can try to
0063 figure it out yourself (it shouldn't be hard), or mail the maintainer
0064 (Will Dyson <will_dyson@pobox.com>) for help.
0065
0066 step 2. Configuration & make kernel
0067
0068 The linux kernel has many compile-time options. Most of them are beyond the
0069 scope of this document. I suggest the Kernel-HOWTO document as a good general
0070 reference on this topic. http://www.linuxdocs.org/HOWTOs/Kernel-HOWTO-4.html
0071
0072 However, to use the BeFS module, you must enable it at configure time::
0073
0074 cd /foo/bar/linux
0075 make menuconfig (or xconfig)
0076
0077 The BeFS module is not a standard part of the linux kernel, so you must first
0078 enable support for experimental code under the "Code maturity level" menu.
0079
0080 Then, under the "Filesystems" menu will be an option called "BeFS
0081 filesystem (experimental)", or something like that. Enable that option
0082 (it is fine to make it a module).
0083
0084 Save your kernel configuration and then build your kernel.
0085
0086 step 3. Install
0087
0088 See the kernel howto <http://www.linux.com/howto/Kernel-HOWTO.html> for
0089 instructions on this critical step.
0090
0091 Using BFS
0092 =========
0093 To use the BeOS filesystem, use filesystem type 'befs'.
0094
0095 ex::
0096
0097 mount -t befs /dev/fd0 /beos
0098
0099 Mount Options
0100 =============
0101
0102 ============= ===========================================================
0103 uid=nnn All files in the partition will be owned by user id nnn.
0104 gid=nnn All files in the partition will be in group nnn.
0105 iocharset=xxx Use xxx as the name of the NLS translation table.
0106 debug The driver will output debugging information to the syslog.
0107 ============= ===========================================================
0108
0109 How to Get Lastest Version
0110 ==========================
0111
0112 The latest version is currently available at:
0113 <http://befs-driver.sourceforge.net/>
0114
0115 Any Known Bugs?
0116 ===============
0117 As of Jan 20, 2002:
0118
0119 None
0120
0121 Special Thanks
0122 ==============
0123 Dominic Giampalo ... Writing "Practical file system design with Be filesystem"
0124
0125 Hiroyuki Yamada ... Testing LinuxPPC.
0126
0127
0128
