1.\" $NetBSD: mount_filecore.8,v 1.7 2001/11/16 11:58:28 wiz Exp $
2.\"
3.\" Copyright (c) 1998 Mark Brinicombe
4.\" Copyright (c) 1993,1994 Christopher G. Demetriou
5.\" All rights reserved.
6.\"
7.\" Redistribution and use in source and binary forms, with or without
8.\" modification, are permitted provided that the following conditions
9.\" are met:
10.\" 1. Redistributions of source code must retain the above copyright
11.\"    notice, this list of conditions and the following disclaimer.
12.\" 2. Redistributions in binary form must reproduce the above copyright
13.\"    notice, this list of conditions and the following disclaimer in the
14.\"    documentation and/or other materials provided with the distribution.
15.\" 3. All advertising materials mentioning features or use of this software
16.\"    must display the following acknowledgement:
17.\"      This product includes software developed by Christopher G. Demetriou.
18.\" 4. The name of the author may not be used to endorse or promote products
19.\"    derived from this software without specific prior written permission
20.\"
21.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
22.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
23.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
24.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
25.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
26.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
27.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
28.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
29.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
30.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
31.\"
32.Dd August 14, 1998
33.Dt MOUNT_FILECORE 8
34.Os
35.Sh NAME
36.Nm mount_filecore
37.Nd mount a FILECORE file system
38.Sh SYNOPSIS
39.Nm ""
40.Op Fl o Ar options
41.Op Fl a
42.Op Fl n
43.Op Fl R
44.Op Fl f
45.Op Fl u Ar uid
46.Op Fl g Ar gid
47.Pa special node
48.Sh ORIGIN
49The
50.Nx
51FILECORE filesystem is a read only implementation of the filecore file system
52found in Acorn Computers RISC OS operating system. This operating system
53is the ROM based operating system found on their ARM 6, ARM7 and
54StrongARM 110 based RiscPC machines that are supported by the arm32 port.
55Under RISC OS, filecore will have multiple instantiations for file
56systems on different block devices such as floppies, IDE discs, SCSI discs
57etc. and these frquently are considered to be different filesystems
58e.g. ADFS, IDEFS, SCSIFS etc.
59.Sh DESCRIPTION
60The
61.Nm
62command attaches the FILECORE filesystem residing on
63the device
64.Pa special
65to the global filesystem namespace at the location
66indicated by
67.Pa node .
68This command is normally executed by
69.Xr mount 8
70at boot time, but can be used by any user to mount a
71FILECORE file system on any directory that they own (provided,
72of course, that they have appropriate access to the device that
73contains the file system).
74.Pp
75The options are as follows:
76.Bl -tag -width Ds
77.It Fl o Ar options
78Use the specified mount
79.Ar options ,
80as described in
81.Xr mount 8 .
82.It Fl u Ar uid
83Set the owner of the files in the file system to
84.Ar uid .
85The default owner is the owner of the directory
86on which the file system is being mounted.
87.It Fl g Ar gid
88Set the group of the files in the file system to
89.Ar gid .
90The default group is the group of the directory
91on which the file system is being mounted.
92.It Fl a
93Give all files world access.
94.It Fl n
95Give all files owner access.
96.It Fl R
97Give all files owner read access.
98.It Fl f
99Append the filetype to each filename. This option currently has no effect.
100.El
101.Sh SEE ALSO
102.Xr mount 2 ,
103.Xr unmount 2 ,
104.Xr fstab 5 ,
105.Xr mount 8
106.Sh CAVEATS
107The
108.Sq filecore
109filesystem currently supports the Acorn filecore file system found on
110Acorn Computers RiscPC desktop machines with versions of RISC OS upto 3.70.
111.Sh HISTORY
112The
113.Nm
114utility first appeared in
115.Nx 1.4 .
116