xref: /netbsd-src/share/man/man8/man8.acorn32/nbfs.8 (revision 3af2acdca3027a6c734b99873d418d59b2d8f42a)
1*3af2acdcSchristos.\" $NetBSD: nbfs.8,v 1.3 2017/02/17 22:30:27 christos Exp $
2b6fc822fSskrll.\"
3b6fc822fSskrll.\" Copyright (c) 2006 Ben Harris
4b6fc822fSskrll.\" All rights reserved.
5b6fc822fSskrll.\"
6b6fc822fSskrll.\" Redistribution and use in source and binary forms, with or without
7b6fc822fSskrll.\" modification, are permitted provided that the following conditions
8b6fc822fSskrll.\" are met:
9b6fc822fSskrll.\" 1. Redistributions of source code must retain the above copyright
10b6fc822fSskrll.\"    notice, this list of conditions and the following disclaimer.
11b6fc822fSskrll.\" 2. Redistributions in binary form must reproduce the above copyright
12b6fc822fSskrll.\"    notice, this list of conditions and the following disclaimer in the
13b6fc822fSskrll.\"    documentation and/or other materials provided with the distribution.
14b6fc822fSskrll.\" 3. The name of the author may not be used to endorse or promote products
15b6fc822fSskrll.\"    derived from this software without specific prior written permission.
16b6fc822fSskrll.\"
17b6fc822fSskrll.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
18b6fc822fSskrll.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
19b6fc822fSskrll.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
20b6fc822fSskrll.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
21b6fc822fSskrll.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
22b6fc822fSskrll.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
23b6fc822fSskrll.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
24b6fc822fSskrll.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
25b6fc822fSskrll.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
26b6fc822fSskrll.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
27b6fc822fSskrll.\"
28*3af2acdcSchristos.Dd February 17, 2017
29b6fc822fSskrll.Dt NBFS 8 acorn32
30b6fc822fSskrll.Os
31b6fc822fSskrll.Sh NAME
32b6fc822fSskrll.Nm nbfs
33b6fc822fSskrll.Nd NetBSD boot filing system for RISC OS
34b6fc822fSskrll.Sh SYNOPSIS
35b6fc822fSskrll.Nm *NBFS
36b6fc822fSskrll.Sh DESCRIPTION
37b6fc822fSskrll.Nm
38b6fc822fSskrllis a filing system, implemented as a RISC OS relocatable module, to allow
39b6fc822fSskrllread-only access to
40b6fc822fSskrll.Nx
41b6fc822fSskrllfile systems from RISC OS.
42b6fc822fSskrllIt supports reading FFSv1, FFSv2, LFSv1, and LVSv2 partitions from disks
43b6fc822fSskrllsupported by FileCore-based filing systems such as ADFS.
44b6fc822fSskrll.Pp
45b6fc822fSskrllPathnames on
46b6fc822fSskrll.Nm
47b6fc822fSskrllfollow RISC OS conventions, as described in the various RISC OS
48b6fc822fSskrll.%T User Guides .
49b6fc822fSskrllThe underlying FileCore instance used by
50b6fc822fSskrll.Nm
51b6fc822fSskrllis selected by the filing system's special field, while the disk and
5263f1b0d2Swiz.Nx
5363f1b0d2Swizpartition are selected by the disk name.
5463f1b0d2SwizThus, to refer to the first
55b6fc822fSskrll.Nx
56b6fc822fSskrllpartition of the first ADFS hard disk, one
57b6fc822fSskrllwould use
58b6fc822fSskrll.Pa NBFS#ADFS::4a .
59b6fc822fSskrllRISC OS file names are generated from
60b6fc822fSskrll.Nx
61b6fc822fSskrllfile names by replacing
62b6fc822fSskrll.Ql .
63b6fc822fSskrllwith
64b6fc822fSskrll.Ql / .
65b6fc822fSskrllFiles whose names contain characters not allowed in RISC OS file names
66b6fc822fSskrllare not accessible through
67b6fc822fSskrll.Nm .
68b6fc822fSskrllThus, as a full example, the file
69b6fc822fSskrll.Pa /etc/resolv.conf
70b6fc822fSskrllon the partition mentioned above would be referred to as
71b6fc822fSskrll.Pa NBFS#ADFS::4a.$.etc.resolv/conf .
72b6fc822fSskrll.Sh LIMITATIONS
73b6fc822fSskrll.Nm
74b6fc822fSskrllis very limited.
75b6fc822fSskrll.Sh SEE ALSO
76*3af2acdcSchristos.Xr acorn32/boot32 8
77b6fc822fSskrll.Rs
78b6fc822fSskrll.%Q Acorn Computers Ltd
79b6fc822fSskrll.%T RISC OS 3.7 User Guide
80b6fc822fSskrll.%C Cambridge
81b6fc822fSskrll.%D January 1997
82b6fc822fSskrll.Re
83