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 .\" 4. 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$
  34 .\"
  35 .Dd March 5, 2013
  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 o Ar options
  46 .Op Fl s Ar startsector
  47 .Ar special node
  48 .Sh DESCRIPTION
  49 The
  50 .Nm
  51 utility attaches the ISO-9660 file system residing on the device
  52 .Pa special
  53 to the global file system namespace at the location indicated by
  54 .Pa node .
  55 This command is normally executed by
  56 .Xr mount 8
  57 at boot time.
  58 .Pp
  59 The options are as follows:
  60 .Bl -tag -width indent
  61 .It Fl b
  62 Relax checking for Supplementary Volume Descriptor Flags field
  63 which is set to a wrong value on some Joliet formatted disks.
  64 .It Fl e
  65 Enable the use of extended attributes.
  66 .It Fl g
  67 Do not strip version numbers on files.
  68 (By default, if there are files with different version numbers on the disk,
  69 only the last one will be listed.)
  70 In either case, files may be opened without explicitly stating a
  71 version number.
  72 .It Fl j
  73 Do not use any Joliet extensions included in the file system.
  74 .It Fl o
  75 Options are specified with a
  76 .Fl o
  77 flag followed by a comma separated string of options.
  78 See the
  79 .Xr mount 8
  80 man page for possible options and their meanings.
  81 The following cd9660 specific options are available:
  82 .Pp
  83 .Bl -tag -width "brokenjoliet" -compact
  84 .It Cm extatt
  85 Same as
  86 .Fl e .
  87 .It Cm gens
  88 Same as
  89 .Fl g .
  90 .It Cm nojoliet
  91 Same as
  92 .Fl j .
  93 .It Cm norrip
  94 Same as
  95 .Fl r .
  96 .It Cm brokenjoliet
  97 Same as
  98 .Fl b .
  99 .El
 100 .It Fl r
 101 Do not use any Rockridge extensions included in the file system.
 102 .It Fl s Ar startsector
 103 Start the file system at
 104 .Ar startsector .
 105 Normally, if the underlying device is a CD-ROM drive,
 106 .Nm
 107 will try to figure out the last track from the CD-ROM containing
 108 data, and start the file system there.
 109 If the device is not a CD-ROM,
 110 or the table of contents cannot be examined, the file system will be
 111 started at sector 0.
 112 This option can be used to override the behaviour.
 113 Note that
 114 .Ar startsector
 115 is measured in CD-ROM blocks, with 2048 bytes each.
 116 This is the same
 117 as for example the
 118 .Cm info
 119 command of
 120 .Xr cdcontrol 1
 121 is printing.
 122 It is possible to mount an arbitrary session of a multi-session CD by specifying
 123 the correct
 124 .Ar startsector
 125 here.
 126 .It Fl C Ar charset
 127 Specify local
 128 .Ar charset
 129 to convert Unicode file names when using Joliet extensions.
 130 .It Fl v
 131 Be verbose about the starting sector decisions made.
 132 .El
 133 .Sh EXAMPLES
 134 The following command can be used to mount a Kodak Photo-CD:
 135 .Pp
 136 .Dl "mount_cd9660 -o rw -v -s 0 /dev/cd0 /cdrom"
 137 .Sh SEE ALSO
 138 .Xr cdcontrol 1 ,
 139 .Xr mount 2 ,
 140 .Xr unmount 2 ,
 141 .Xr fstab 5 ,
 142 .Xr mount 8
 143 .Sh HISTORY
 144 The
 145 .Nm
 146 utility first appeared in
 147 .Bx 4.4 .
 148 .Pp
 149 The Unicode conversion routine was added by
 150 .An Ryuichiro Imura Aq imura@ryu16.org
 151 in 2003.
 152 .Sh BUGS
 153 POSIX device node mapping is currently not supported.
 154 .Pp
 155 Version numbers are not stripped if Rockridge extensions are in use.
 156 In this case, accessing files that do not have Rockridge names without
 157 version numbers gets the one with the lowest version number and not
 158 the one with the highest.
 159 .Pp
 160 There is no ECMA support.