Linux kernel mirror (for testing) git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel os linux

docs: filesystems: convert befs.txt to ReST

- Add a SPDX header;
- Adjust document and section titles;
- Some whitespace fixes and new line breaks;
- Mark literal blocks as such;
- Add table markups;
- Add it to filesystems/index.rst.

Signed-off-by: Mauro Carvalho Chehab <mchehab+huawei@kernel.org>
Link: https://lore.kernel.org/r/3e29ea6df6cd569021cfa953ccb8ed7dfc146f3d.1581955849.git.mchehab+huawei@kernel.org
Signed-off-by: Jonathan Corbet <corbet@lwn.net>

authored by

Mauro Carvalho Chehab and committed by
Jonathan Corbet
c54ad9a4 c64d3dc6

+36 -24
+35 -24
Documentation/filesystems/befs.txt Documentation/filesystems/befs.rst
··· 1 + .. SPDX-License-Identifier: GPL-2.0 2 + 3 + ========================= 1 4 BeOS filesystem for Linux 5 + ========================= 2 6 3 7 Document last updated: Dec 6, 2001 4 8 5 - WARNING 9 + Warning 6 10 ======= 7 11 Make sure you understand that this is alpha software. This means that the 8 - implementation is neither complete nor well-tested. 12 + implementation is neither complete nor well-tested. 9 13 10 14 I DISCLAIM ALL RESPONSIBILITY FOR ANY POSSIBLE BAD EFFECTS OF THIS CODE! 11 15 12 - LICENSE 13 - ===== 14 - This software is covered by the GNU General Public License. 16 + License 17 + ======= 18 + This software is covered by the GNU General Public License. 15 19 See the file COPYING for the complete text of the license. 16 20 Or the GNU website: <http://www.gnu.org/licenses/licenses.html> 17 21 18 - AUTHOR 19 - ===== 22 + Author 23 + ====== 20 24 The largest part of the code written by Will Dyson <will_dyson@pobox.com> 21 25 He has been working on the code since Aug 13, 2001. See the changelog for 22 26 details. 23 27 24 28 Original Author: Makoto Kato <m_kato@ga2.so-net.ne.jp> 29 + 25 30 His original code can still be found at: 26 31 <http://hp.vector.co.jp/authors/VA008030/bfs/> 32 + 27 33 Does anyone know of a more current email address for Makoto? He doesn't 28 34 respond to the address given above... 29 35 30 36 This filesystem doesn't have a maintainer. 31 37 32 - WHAT IS THIS DRIVER? 33 - ================== 34 - This module implements the native filesystem of BeOS http://www.beincorporated.com/ 38 + What is this Driver? 39 + ==================== 40 + This module implements the native filesystem of BeOS http://www.beincorporated.com/ 35 41 for the linux 2.4.1 and later kernels. Currently it is a read-only 36 42 implementation. 37 43 38 44 Which is it, BFS or BEFS? 39 - ================ 40 - Be, Inc said, "BeOS Filesystem is officially called BFS, not BeFS". 45 + ========================= 46 + Be, Inc said, "BeOS Filesystem is officially called BFS, not BeFS". 41 47 But Unixware Boot Filesystem is called bfs, too. And they are already in 42 48 the kernel. Because of this naming conflict, on Linux the BeOS 43 49 filesystem is called befs. 44 50 45 - HOW TO INSTALL 51 + How to Install 46 52 ============== 47 53 step 1. Install the BeFS patch into the source code tree of linux. 48 54 ··· 60 54 patch -p1 < /path/to/patch-befs-xxx 61 55 62 56 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), or mail the maintainer 57 + figure it out yourself (it shouldn't be hard), or mail the maintainer 64 58 (Will Dyson <will_dyson@pobox.com>) for help. 65 59 66 60 step 2. Configuration & make kernel 67 61 68 62 The linux kernel has many compile-time options. Most of them are beyond the 69 63 scope of this document. I suggest the Kernel-HOWTO document as a good general 70 - reference on this topic. http://www.linuxdocs.org/HOWTOs/Kernel-HOWTO-4.html 64 + reference on this topic. http://www.linuxdocs.org/HOWTOs/Kernel-HOWTO-4.html 71 65 72 - However, to use the BeFS module, you must enable it at configure time. 66 + However, to use the BeFS module, you must enable it at configure time:: 73 67 74 68 cd /foo/bar/linux 75 69 make menuconfig (or xconfig) ··· 88 82 See the kernel howto <http://www.linux.com/howto/Kernel-HOWTO.html> for 89 83 instructions on this critical step. 90 84 91 - USING BFS 85 + Using BFS 92 86 ========= 93 87 To use the BeOS filesystem, use filesystem type 'befs'. 94 88 95 - ex) 89 + ex:: 90 + 96 91 mount -t befs /dev/fd0 /beos 97 92 98 - MOUNT OPTIONS 93 + Mount Options 99 94 ============= 95 + 96 + ============= =========================================================== 100 97 uid=nnn All files in the partition will be owned by user id nnn. 101 98 gid=nnn All files in the partition will be in group nnn. 102 99 iocharset=xxx Use xxx as the name of the NLS translation table. 103 100 debug The driver will output debugging information to the syslog. 101 + ============= =========================================================== 104 102 105 - HOW TO GET LASTEST VERSION 103 + How to Get Lastest Version 106 104 ========================== 107 105 108 106 The latest version is currently available at: 109 107 <http://befs-driver.sourceforge.net/> 110 108 111 - ANY KNOWN BUGS? 112 - =========== 109 + Any Known Bugs? 110 + =============== 113 111 As of Jan 20, 2002: 114 - 112 + 115 113 None 116 114 117 - SPECIAL THANKS 115 + Special Thanks 118 116 ============== 119 117 Dominic Giampalo ... Writing "Practical file system design with Be filesystem" 118 + 120 119 Hiroyuki Yamada ... Testing LinuxPPC. 121 120 122 121
+1
Documentation/filesystems/index.rst
··· 52 52 afs 53 53 autofs 54 54 autofs-mount-control 55 + befs 55 56 fuse 56 57 overlayfs 57 58 virtiofs