118 lines
3.6 KiB
Text
118 lines
3.6 KiB
Text
|
BeOS filesystem for Linux
|
||
|
|
|
||
|
|
Document last updated: Dec 6, 2001
|
||
|
|
|
||
|
|
WARNING
|
||
|
|
=======
|
||
|
|
Make sure you understand that this is alpha software. This means that the
|
||
|
|
implementation is neither complete nor well-tested.
|
||
|
|
|
||
|
|
I DISCLAIM ALL RESPONSIBILTY FOR ANY POSSIBLE BAD EFFECTS OF THIS CODE!
|
||
|
|
|
||
|
|
LICENSE
|
||
|
|
=====
|
||
|
|
This software is covered by the GNU General Public License.
|
||
|
|
See the file COPYING for the complete text of the license.
|
||
|
|
Or the GNU website: <http://www.gnu.org/licenses/licenses.html>
|
||
|
|
|
||
|
|
AUTHOR
|
||
|
|
=====
|
||
|
|
The largest part of the code written by Will Dyson <will_dyson@pobox.com>
|
||
|
|
He has been working on the code since Aug 13, 2001. See the changelog for
|
||
|
|
details.
|
||
|
|
|
||
|
|
Original Author: Makoto Kato <m_kato@ga2.so-net.ne.jp>
|
||
|
|
His orriginal code can still be found at:
|
||
|
|
<http://hp.vector.co.jp/authors/VA008030/bfs/>
|
||
|
|
Does anyone know of a more current email address for Makoto? He doesn't
|
||
|
|
respond to the address given above...
|
||
|
|
|
||
|
|
Current maintainer: Sergey S. Kostyliov <rathamahata@php4.ru>
|
||
|
|
|
||
|
|
WHAT IS THIS DRIVER?
|
||
|
|
==================
|
||
|
|
This module implements the native filesystem of BeOS <http://www.be.com/>
|
||
|
|
for the linux 2.4.1 and later kernels. Currently it is a read-only
|
||
|
|
implementation.
|
||
|
|
|
||
|
|
Which is it, BFS or BEFS?
|
||
|
|
================
|
||
|
|
Be, Inc said, "BeOS Filesystem is officially called BFS, not BeFS".
|
||
|
|
But Unixware Boot Filesystem is called bfs, too. And they are already in
|
||
|
|
the kernel. Because of this nameing conflict, on Linux the BeOS
|
||
|
|
filesystem is called befs.
|
||
|
|
|
||
|
|
HOW TO INSTALL
|
||
|
|
==============
|
||
|
|
step 1. Install the BeFS patch into the source code tree of linux.
|
||
|
|
|
||
|
|
Apply the patchfile to your kernel source tree.
|
||
|
|
Assuming that your kernel source is in /foo/bar/linux and the patchfile
|
||
|
|
is called patch-befs-xxx, you would do the following:
|
||
|
|
|
||
|
|
cd /foo/bar/linux
|
||
|
|
patch -p1 < /path/to/patch-befs-xxx
|
||
|
|
|
||
|
|
if the patching step fails (i.e. there are rejected hunks), you can try to
|
||
|
|
figure it out yourself (it shouldn't be hard), or mail the maintainer
|
||
|
|
(Will Dyson <will_dyson@pobox.com>) for help.
|
||
|
|
|
||
|
|
step 2. Configuretion & make kernel
|
||
|
|
|
||
|
|
The linux kernel has many compile-time options. Most of them are beyond the
|
||
|
|
scope of this document. I suggest the Kernel-HOWTO document as a good general
|
||
|
|
reference on this topic. <http://www.linux.com/howto/Kernel-HOWTO.html>
|
||
|
|
|
||
|
|
However, to use the BeFS module, you must enable it at configure time.
|
||
|
|
|
||
|
|
cd /foo/bar/linux
|
||
|
|
make menuconfig (or xconfig)
|
||
|
|
|
||
|
|
The BeFS module is not a standard part of the linux kernel, so you must first
|
||
|
|
enable support for experimental code under the "Code maturity level" menu.
|
||
|
|
|
||
|
|
Then, under the "Filesystems" menu will be an option called "BeFS
|
||
|
|
filesystem (experimental)", or something like that. Enable that option
|
||
|
|
(it is fine to make it a module).
|
||
|
|
|
||
|
|
Save your kernel configuration and then build your kernel.
|
||
|
|
|
||
|
|
step 3. Install
|
||
|
|
|
||
|
|
See the kernel howto <http://www.linux.com/howto/Kernel-HOWTO.html> for
|
||
|
|
instructions on this critical step.
|
||
|
|
|
||
|
|
USING BFS
|
||
|
|
=========
|
||
|
|
To use the BeOS filesystem, use filesystem type 'befs'.
|
||
|
|
|
||
|
|
ex)
|
||
|
|
mount -t befs /dev/fd0 /beos
|
||
|
|
|
||
|
|
MOUNT OPTIONS
|
||
|
|
=============
|
||
|
|
uid=nnn All files in the partition will be owned by user id nnn.
|
||
|
|
gid=nnn All files in the partition will be in group nnn.
|
||
|
|
iocharset=xxx Use xxx as the name of the NLS translation table.
|
||
|
|
debug The driver will output debugging information to the syslog.
|
||
|
|
|
||
|
|
HOW TO GET LASTEST VERSION
|
||
|
|
==========================
|
||
|
|
|
||
|
|
The latest version is currently available at:
|
||
|
|
<http://befs-driver.sourceforge.net/>
|
||
|
|
|
||
|
|
ANY KNOWN BUGS?
|
||
|
|
===========
|
||
|
|
As of Jan 20, 2002:
|
||
|
|
|
||
|
|
None
|
||
|
|
|
||
|
|
SPECIAL THANKS
|
||
|
|
==============
|
||
|
|
Dominic Giampalo ... Writing "Practical file system design with Be filesystem"
|
||
|
|
Hiroyuki Yamada ... Testing LinuxPPC.
|
||
|
|
|
||
|
|
|
||
|
|
|