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