forked from Qortal/Brooklyn
You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
128 lines
3.8 KiB
128 lines
3.8 KiB
.. SPDX-License-Identifier: GPL-2.0 |
|
|
|
========================= |
|
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 RESPONSIBILITY 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 <[email protected]> |
|
He has been working on the code since Aug 13, 2001. See the changelog for |
|
details. |
|
|
|
Original Author: Makoto Kato <[email protected]> |
|
|
|
His original 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... |
|
|
|
This filesystem doesn't have a maintainer. |
|
|
|
What is this Driver? |
|
==================== |
|
This module implements the native filesystem of BeOS http://www.beincorporated.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 naming 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 <[email protected]>) for help. |
|
|
|
step 2. Configuration & 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.linuxdocs.org/HOWTOs/Kernel-HOWTO-4.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. |
|
|
|
|
|
|
|
|