sbin/mount_cd9660/mount_cd9660.8

   1 .\" Copyright (c) 1993, 1994
   2 .\"     The Regents of the University of California.  All rights reserved.
   3 .\" All rights reserved.
   4 .\"
   5 .\" This code is derived from software donated to Berkeley by
   6 .\" Christopher G. Demetriou.
   7 .\"
   8 .\" Redistribution and use in source and binary forms, with or without
   9 .\" modification, are permitted provided that the following conditions
  10 .\" are met:
  11 .\" 1. Redistributions of source code must retain the above copyright
  12 .\"    notice, this list of conditions and the following disclaimer.
  13 .\" 2. Redistributions in binary form must reproduce the above copyright
  14 .\"    notice, this list of conditions and the following disclaimer in the
  15 .\"    documentation and/or other materials provided with the distribution.
  16 .\" 3. Neither the name of the University nor the names of its contributors
  17 .\"    may be used to endorse or promote products derived from this software
  18 .\"    without specific prior written permission.
  19 .\"
  20 .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
  21 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  22 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  23 .\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
  24 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  25 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  26 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  27 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  28 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  29 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  30 .\" SUCH DAMAGE.
  31 .\"
  32 .\"     @(#)mount_cd9660.8      8.3 (Berkeley) 3/27/94
  33 .\" $FreeBSD: src/sbin/mount_cd9660/mount_cd9660.8,v 1.12.2.6 2003/02/24 00:56:41 trhodes Exp $
  34 .\"
  35 .Dd March 7, 2024
  36 .Dt MOUNT_CD9660 8
  37 .Os
  38 .Sh NAME
  39 .Nm mount_cd9660
  40 .Nd mount an ISO-9660 file system
  41 .Sh SYNOPSIS
  42 .Nm
  43 .Op Fl begjrv
  44 .Op Fl C Ar charset
  45 .Op Fl G Ar gid
  46 .Op Fl m Ar mask
  47 .Op Fl M Ar mask
  48 .Op Fl o Ar options
  49 .Op Fl s Ar startsector
  50 .Op Fl U Ar uid
  51 .Ar special node
  52 .Sh DESCRIPTION
  53 The
  54 .Nm
  55 utility attaches the ISO-9660 file system residing on the device
  56 .Pa special
  57 to the global file system namespace at the location indicated by
  58 .Pa node .
  59 This command is normally executed by
  60 .Xr mount 8
  61 at boot time.
  62 .Pp
  63 The options are as follows:
  64 .Bl -tag -width indent
  65 .It Fl b
  66 Relax checking for Supplementary Volume Descriptor Flags field
  67 which is set to a wrong value on some Joliet formatted disks.
  68 .It Fl C Ar charset
  69 Specify local
  70 .Ar charset
  71 to convert Unicode file names when using Joliet extensions.
  72 .It Fl e
  73 Enable the use of extended attributes.
  74 .It Fl g
  75 Do not strip version numbers on files.
  76 (By default, if there are files with different version numbers on the disk,
  77 only the last one will be listed.)
  78 In either case, files may be opened without explicitly stating a
  79 version number.
  80 .It Fl G Ar gid
  81 Set the group of the files in the file system to
  82 .Ar gid .
  83 The default gid on non-Rockridge volumes is zero.
  84 .It Fl m Ar mask
  85 Specify the maximum file permissions for files
  86 in the file system.
  87 (For example, a
  88 .Ar mask
  89 of
  90 .Li 755
  91 specifies that, by default, the owner should have
  92 read, write, and execute permissions for files, but
  93 others should only have read and execute permissions.)
  94 See
  95 .Xr chmod 1
  96 for more information about octal file modes.
  97 Only the nine low-order bits of
  98 .Ar mask
  99 are used.
 100 The value of
 101 .Fl M
 102 is used if it is supplied and
 103 .Fl m
 104 is omitted.
 105 The default
 106 .Ar mask
 107 on non-Rockridge volumes is
 108 .Li 755 .
 109 .It Fl M Ar mask
 110 Specify the maximum file permissions for directories
 111 in the file system.
 112 The value of
 113 .Fl m
 114 is used if it is supplied and
 115 .Fl M
 116 is omitted.
 117 See the previous option's description for details.
 118 .It Fl j
 119 Do not use any Joliet extensions included in the file system.
 120 .It Fl o
 121 Options are specified with a
 122 .Fl o
 123 flag followed by a comma separated string of options.
 124 See the
 125 .Xr mount 8
 126 man page for possible options and their meanings.
 127 The following cd9660 specific options are available:
 128 .Pp
 129 .Bl -tag -width "nostrictjoliet" -compact
 130 .It Cm extatt
 131 Same as
 132 .Fl e .
 133 .It Cm gens
 134 Same as
 135 .Fl g .
 136 .It Cm nojoliet
 137 Same as
 138 .Fl j .
 139 .It Cm norrip
 140 Same as
 141 .Fl r .
 142 .It Cm nostrictjoliet
 143 Same as
 144 .Fl b .
 145 .El
 146 .It Fl r
 147 Do not use any Rockridge extensions included in the file system.
 148 .It Fl s Ar startsector
 149 Start the file system at
 150 .Ar startsector .
 151 Normally, if the underlying device is a CD-ROM drive,
 152 .Nm
 153 will try to figure out the last track from the CD-ROM containing
 154 data, and start the file system there.
 155 If the device is not a CD-ROM,
 156 or the table of contents cannot be examined, the file system will be
 157 started at sector 0.
 158 This option can be used to override the behaviour.
 159 Note that
 160 .Ar startsector
 161 is measured in CD-ROM blocks, with 2048 bytes each.
 162 This is the same
 163 as for example the
 164 .Cm info
 165 command of
 166 .Xr cdcontrol 1
 167 is printing.
 168 It is possible to mount an arbitrary session of a multi-session CD by specifying
 169 the correct
 170 .Ar startsector
 171 here.
 172 .It Fl U Ar uid
 173 Set the owner of the files in the file system to
 174 .Ar uid .
 175 The default uid on non-Rockridge volumes is zero.
 176 .It Fl v
 177 Be verbose about the starting sector decisions made.
 178 .El
 179 .Sh EXAMPLES
 180 The following command can be used to mount a Kodak Photo-CD:
 181 .Pp
 182 .Dl "mount_cd9660 -o rw -v -s 0 /dev/cd0c /cdrom"
 183 .Sh SEE ALSO
 184 .Xr cdcontrol 1 ,
 185 .Xr mount 2 ,
 186 .Xr unmount 2 ,
 187 .Xr fstab 5 ,
 188 .Xr mount 8
 189 .Sh HISTORY
 190 The
 191 .Nm
 192 utility first appeared in
 193 .Bx 4.4 .
 194 .Sh BUGS
 195 POSIX device node mapping is currently not supported.
 196 .Pp
 197 Version numbers are not stripped if Rockridge extensions are in use.
 198 In this case, accessing files that do not have Rockridge names without
 199 version numbers gets the one with the lowest version number and not
 200 the one with the highest.
 201 .Pp
 202 There is no ECMA support.