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