sbin/mount_ados/mount_ados.8

   1 .\" $NetBSD: mount_ados.8,v 1.18 2005/01/31 05:19:18 erh Exp $
   2 .\"
   3 .\" Copyright (c) 1993, 1994 Christopher G. Demetriou
   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. All advertising materials mentioning features or use of this software
  15 .\"    must display the following acknowledgement:
  16 .\"          This product includes software developed for the
  17 .\"          NetBSD Project.  See http://www.NetBSD.org/ for
  18 .\"          information about NetBSD.
  19 .\" 4. The name of the author may not be used to endorse or promote products
  20 .\"    derived from this software without specific prior written permission.
  21 .\"
  22 .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
  23 .\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
  24 .\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
  25 .\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
  26 .\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
  27 .\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
  28 .\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
  29 .\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  30 .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
  31 .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  32 .\"
  33 .\" <<Id: LICENSE,v 1.2 2000/06/14 15:57:33 cgd Exp>>
  34 .\"
  35 .Dd April 7, 1994
  36 .Dt MOUNT_ADOS 8
  37 .Os
  38 .Sh NAME
  39 .Nm mount_ados
  40 .Nd mount an AmigaDOS file system
  41 .Sh SYNOPSIS
  42 .Nm
  43 .Op Fl o Ar options
  44 .Op Fl u Ar uid
  45 .Op Fl g Ar gid
  46 .Op Fl m Ar mask
  47 .Pa special
  48 .Pa node
  49 .Sh DESCRIPTION
  50 The
  51 .Nm
  52 command attaches the AmigaDOS filesystem residing on
  53 the device
  54 .Pa special
  55 to the global filesystem namespace at the location
  56 indicated by
  57 .Pa node .
  58 Both
  59 .Ar special
  60 and
  61 .Ar node
  62 are converted to absolute paths before use.
  63 This command is normally executed by
  64 .Xr mount 8
  65 at boot time, but can be used by any user to mount an
  66 AmigaDOS file system on any directory that they own (provided,
  67 of course, that they have appropriate access to the device that
  68 contains the file system).
  69 .Pp
  70 The options are as follows:
  71 .Bl -tag -width Ds
  72 .It Fl o Ar options
  73 Use the specified mount
  74 .Ar options ,
  75 as described in
  76 .Xr mount 8 .
  77 .It Fl u Ar uid
  78 Set the owner of the files in the file system to
  79 .Ar uid .
  80 The default owner is the owner of the directory
  81 on which the file system is being mounted.
  82 .It Fl g Ar gid
  83 Set the group of the files in the file system to
  84 .Ar gid .
  85 The default group is the group of the directory
  86 on which the file system is being mounted.
  87 .It Fl m Ar mask
  88 Specify the maximum file permissions for files
  89 in the file system.
  90 (For example, a mask of
  91 .Li 755
  92 specifies that, by default, the owner should have
  93 read, write, and execute permissions for files, but
  94 others should only have read and execute permissions.
  95 See
  96 .Xr chmod 1
  97 for more information about octal file modes.)
  98 Only the nine low-order bits of
  99 .Ar mask
 100 are used.
 101 The default mask is taken from the
 102 directory on which the file system is being mounted.
 103 .El
 104 .Sh SEE ALSO
 105 .Xr mount 2 ,
 106 .Xr unmount 2 ,
 107 .Xr fstab 5 ,
 108 .Xr mount 8
 109 .Sh HISTORY
 110 The
 111 .Nm
 112 utility first appeared in
 113 .Nx 1.0 .
 114 .Sh BUGS
 115 The
 116 .Sq ados
 117 filesystem currently supports the Amiga fast file system.
 118 .Pp
 119 The
 120 .Sq ados
 121 filesystem implementation currently is read-only.
 122 The
 123 .Nm
 124 utility silently retries the mount read-only, as if the
 125 .Ar ro
 126 option were specified, when it encounters the
 127 .Bq Er EROFS
 128 error.