xref: /netbsd-src/sbin/mount_filecore/mount_filecore.8 (revision d909946ca08dceb44d7d0f22ec9488679695d976)
1.\" $NetBSD: mount_filecore.8,v 1.13 2005/01/31 05:19:19 erh 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 June 25, 2004
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 afnR
41.Op Fl g Ar gid
42.Op Fl o Ar options
43.Op Fl u Ar uid
44.Pa special node
45.Sh ORIGIN
46The
47.Nx
48FILECORE filesystem is a read only implementation of the filecore file system
49found in Acorn Computers RISC OS operating system.
50This operating system is the ROM based operating system
51found on their ARM 6, ARM7 and StrongARM 110 based RiscPC machines
52that are supported by the arm32 port.
53Under RISC OS, filecore will have multiple instantiations for file
54systems on different block devices such as floppies, IDE discs, SCSI discs
55etc. and these frequently are considered to be different filesystems
56e.g. ADFS, IDEFS, SCSIFS etc.
57.Sh DESCRIPTION
58The
59.Nm
60command attaches the FILECORE filesystem residing on
61the device
62.Pa special
63to the global filesystem namespace at the location
64indicated by
65.Pa node .
66Both
67.Ar special
68and
69.Ar node
70are converted to absolute paths before use.
71This command is normally executed by
72.Xr mount 8
73at boot time, but can be used by any user to mount a
74FILECORE file system on any directory that they own (provided,
75of course, that they have appropriate access to the device that
76contains the file system).
77.Pp
78The options are as follows:
79.Bl -tag -width Ds
80.It Fl a
81Give all files world access.
82.It Fl f
83Append the filetype to each filename.
84This option currently has no effect.
85.It Fl g Ar gid
86Set the group of the files in the file system to
87.Ar gid .
88The default group is the group of the directory
89on which the file system is being mounted.
90.It Fl n
91Give all files owner access.
92.It Fl o Ar options
93Use the specified mount
94.Ar options ,
95as described in
96.Xr mount 8 .
97.It Fl R
98Give all files owner read access.
99.It Fl u Ar uid
100Set the owner of the files in the file system to
101.Ar uid .
102The default owner is the owner of the directory
103on which the file system is being mounted.
104.El
105.Sh SEE ALSO
106.Xr mount 2 ,
107.Xr unmount 2 ,
108.Xr fstab 5 ,
109.Xr mount 8
110.Sh HISTORY
111The
112.Nm
113utility first appeared in
114.Nx 1.4 .
115.Sh CAVEATS
116The
117.Sq filecore
118filesystem currently supports the Acorn filecore file system found on
119Acorn Computers RiscPC desktop machines with versions of RISC OS up to 3.70.
120