BeOS filesystem for Linux

문서 정보와 경고

이 문서는 2001년 12월 6일에 마지막으로 갱신되었습니다.

이 구현은 알파 소프트웨어입니다. 기능이 완전하지 않고 충분히 시험되지 않았다는 뜻이므로 이를 분명히 이해해야 합니다.

원문 저자는 이 코드에서 발생할 수 있는 모든 나쁜 영향에 대한 책임을 부인합니다.

.. 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!

라이선스와 저자

이 소프트웨어에는 GNU General Public License가 적용됩니다. 전체 라이선스 문구는 `COPYING` 파일 또는 GNU 웹사이트 `http://www.gnu.org/licenses/licenses.html`에서 볼 수 있습니다.

코드의 가장 큰 부분은 Will Dyson `<[email protected]>`이 작성했으며, 2001년 8월 13일부터 작업했습니다. 자세한 내용은 changelog를 참고하십시오.

원 저자는 Makoto Kato `<[email protected]>`이며 원래 코드는 `http://hp.vector.co.jp/authors/VA008030/bfs/`에 남아 있습니다. 문서에는 해당 이메일로 답을 받지 못해 더 최신 주소를 묻는 내용도 있습니다.

이 파일시스템에는 유지관리자가 없습니다.

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.

드라이버의 목적과 이름

이 모듈은 Linux 2.4.1 이후 커널에서 BeOS의 기본 파일시스템을 구현합니다. 문서 작성 시점의 구현은 읽기 전용입니다.

Be, Inc는 "BeOS Filesystem의 공식 이름은 BeFS가 아니라 BFS"라고 설명했습니다. 하지만 UnixWare Boot Filesystem도 이미 커널에서 `bfs`라는 이름을 사용합니다. 이 이름 충돌 때문에 Linux에서는 BeOS 파일시스템을 `befs`라고 부릅니다.

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.

설치와 커널 빌드

1단계는 Linux 소스 트리에 BeFS 패치를 설치하는 것입니다. 커널 소스가 `/foo/bar/linux`에 있고 패치 이름이 `patch-befs-xxx`라면 해당 디렉터리로 이동해 `patch -p1 < /path/to/patch-befs-xxx`를 실행합니다.

패치가 실패하여 거부된 hunk가 생기면 직접 충돌을 해결하거나 당시 유지관리자인 Will Dyson에게 도움을 요청할 수 있다고 문서는 안내합니다.

2단계는 커널을 구성하고 빌드하는 것입니다. Linux 커널에는 많은 컴파일 시점 옵션이 있으며 대부분은 이 문서 범위를 벗어납니다. 일반적인 참고 자료로 Kernel-HOWTO를 권합니다.

BeFS 모듈을 사용하려면 `/foo/bar/linux`에서 `make menuconfig` 또는 `make xconfig`를 실행해 구성 시 활성화해야 합니다.

당시 BeFS 모듈은 표준 Linux 커널 구성 요소가 아니었으므로 먼저 "Code maturity level" 메뉴에서 실험적 코드 지원을 켜야 했습니다. 그 뒤 "Filesystems" 메뉴의 "BeFS filesystem (experimental)"과 비슷한 옵션을 활성화합니다. 모듈로 빌드해도 됩니다.

커널 구성을 저장하고 커널을 빌드합니다. 3단계 설치는 문서가 가리키는 kernel howto의 지침을 따르며, 원문은 이를 중요한 단계라고 강조합니다.

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.

사용법과 마운트 옵션

BeOS 파일시스템을 사용하려면 파일시스템 형식으로 `befs`를 지정합니다. 예시는 `mount -t befs /dev/fd0 /beos`입니다.

`uid=nnn`은 파티션의 모든 파일 소유자를 사용자 ID `nnn`으로 정합니다. `gid=nnn`은 모든 파일의 그룹을 `nnn`으로 정합니다. `iocharset=xxx`는 NLS 변환 테이블 이름으로 `xxx`를 사용합니다. `debug`는 드라이버 디버깅 정보를 syslog에 출력합니다.

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.
=============  ===========================================================

버전, 버그, 감사

문서 작성 시점의 최신 버전은 `http://befs-driver.sourceforge.net/`에서 제공되었습니다.

2002년 1월 20일 기준으로 알려진 버그는 없다고 기록되어 있습니다. 이는 앞 절의 알파 소프트웨어 경고와 별개의 당시 목록 상태입니다.

원문은 "Practical file system design with Be filesystem"을 쓴 Dominic Giampalo와 LinuxPPC 시험을 수행한 Hiroyuki Yamada에게 특별히 감사를 표합니다.

How to Get Latest 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.