sbin/mount_filecore/mount_filecore.8

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