tjh.dev
Linux kernel mirror (for testing)
git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel
os
linux
docs: filesystems: convert bfs.txt to ReST
- Add a SPDX header;
- Adjust document title;
- Some whitespace fixes and new line breaks;
- Mark literal blocks as such;
- Add it to filesystems/index.rst.
Signed-off-by: Mauro Carvalho Chehab <mchehab+huawei@kernel.org>
Link: https://lore.kernel.org/r/93991bcc05e419368ee1e585c81057fb2c7c8d2b.1581955849.git.mchehab+huawei@kernel.org
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
authored by
Mauro Carvalho Chehab
and committed by
Jonathan Corbet
ee68f34d
c54ad9a4
+21
-17
+20
-17
Documentation/filesystems/bfs.txt
Documentation/filesystems/bfs.rst
+20
-17
Documentation/filesystems/bfs.txt
Documentation/filesystems/bfs.rst
···
1
-
BFS FILESYSTEM FOR LINUX
1
+
.. SPDX-License-Identifier: GPL-2.0
2
+
3
+
========================
4
+
BFS Filesystem for Linux
2
5
========================
3
6
4
7
The BFS filesystem is used by SCO UnixWare OS for the /stand slice, which
···
12
9
know the partition number and the kernel must support UnixWare disk slices
13
10
(CONFIG_UNIXWARE_DISKLABEL config option). However BFS support does not
14
11
depend on having UnixWare disklabel support because one can also mount
15
-
BFS filesystem via loopback:
12
+
BFS filesystem via loopback::
16
13
17
-
# losetup /dev/loop0 stand.img
18
-
# mount -t bfs /dev/loop0 /mnt/stand
14
+
# losetup /dev/loop0 stand.img
15
+
# mount -t bfs /dev/loop0 /mnt/stand
19
16
20
-
where stand.img is a file containing the image of BFS filesystem.
17
+
where stand.img is a file containing the image of BFS filesystem.
21
18
When you have finished using it and umounted you need to also deallocate
22
-
/dev/loop0 device by:
19
+
/dev/loop0 device by::
23
20
24
-
# losetup -d /dev/loop0
21
+
# losetup -d /dev/loop0
25
22
26
-
You can simplify mounting by just typing:
23
+
You can simplify mounting by just typing::
27
24
28
-
# mount -t bfs -o loop stand.img /mnt/stand
25
+
# mount -t bfs -o loop stand.img /mnt/stand
29
26
30
-
this will allocate the first available loopback device (and load loop.o
27
+
this will allocate the first available loopback device (and load loop.o
31
28
kernel module if necessary) automatically. If the loopback driver is not
32
29
loaded automatically, make sure that you have compiled the module and
33
30
that modprobe is functioning. Beware that umount will not deallocate
···
36
33
losetup(8). Read losetup(8) manpage for more info.
37
34
38
35
To create the BFS image under UnixWare you need to find out first which
39
-
slice contains it. The command prtvtoc(1M) is your friend:
36
+
slice contains it. The command prtvtoc(1M) is your friend::
40
37
41
-
# prtvtoc /dev/rdsk/c0b0t0d0s0
38
+
# prtvtoc /dev/rdsk/c0b0t0d0s0
42
39
43
40
(assuming your root disk is on target=0, lun=0, bus=0, controller=0). Then you
44
41
look for the slice with tag "STAND", which is usually slice 10. With this
45
-
information you can use dd(1) to create the BFS image:
42
+
information you can use dd(1) to create the BFS image::
46
43
47
-
# umount /stand
48
-
# dd if=/dev/rdsk/c0b0t0d0sa of=stand.img bs=512
44
+
# umount /stand
45
+
# dd if=/dev/rdsk/c0b0t0d0sa of=stand.img bs=512
49
46
50
47
Just in case, you can verify that you have done the right thing by checking
51
-
the magic number:
48
+
the magic number::
52
49
53
-
# od -Ad -tx4 stand.img | more
50
+
# od -Ad -tx4 stand.img | more
54
51
55
52
The first 4 bytes should be 0x1badface.
56
53