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
53The
54.Nm
55utility attaches the ISO-9660 file system residing on the device
56.Pa special
57to the global file system namespace at the location indicated by
58.Pa node .
59This command is normally executed by
60.Xr mount 8
61at boot time.
62.Pp
63The options are as follows:
64.Bl -tag -width indent
65.It Fl b
66Relax checking for Supplementary Volume Descriptor Flags field
67which is set to a wrong value on some Joliet formatted disks.
68.It Fl C Ar charset
69Specify local
70.Ar charset
71to convert Unicode file names when using Joliet extensions.
72.It Fl e
73Enable the use of extended attributes.
74.It Fl g
75Do not strip version numbers on files.
76(By default, if there are files with different version numbers on the disk,
77only the last one will be listed.)
78In either case, files may be opened without explicitly stating a
79version number.
80.It Fl G Ar gid
81Set the group of the files in the file system to
82.Ar gid .
83The default gid on non-Rockridge volumes is zero.
84.It Fl m Ar mask
85Specify the maximum file permissions for files
86in the file system.
87(For example, a
88.Ar mask
89of
90.Li 755
91specifies that, by default, the owner should have
92read, write, and execute permissions for files, but
93others should only have read and execute permissions.)
94See
95.Xr chmod 1
96for more information about octal file modes.
97Only the nine low-order bits of
98.Ar mask
99are used.
100The value of
101.Fl M
102is used if it is supplied and
103.Fl m
104is omitted.
105The default
106.Ar mask
107on non-Rockridge volumes is
108.Li 755 .
109.It Fl M Ar mask
110Specify the maximum file permissions for directories
111in the file system.
112The value of
113.Fl m
114is used if it is supplied and
115.Fl M
116is omitted.
117See the previous option's description for details.
118.It Fl j
119Do not use any Joliet extensions included in the file system.
120.It Fl o
121Options are specified with a
122.Fl o
123flag followed by a comma separated string of options.
124See the
125.Xr mount 8
126man page for possible options and their meanings.
127The following cd9660 specific options are available:
128.Pp
129.Bl -tag -width "nostrictjoliet" -compact
130.It Cm extatt
131Same as
132.Fl e .
133.It Cm gens
134Same as
135.Fl g .
136.It Cm nojoliet
137Same as
138.Fl j .
139.It Cm norrip
140Same as
141.Fl r .
142.It Cm nostrictjoliet
143Same as
144.Fl b .
145.El
146.It Fl r
147Do not use any Rockridge extensions included in the file system.
148.It Fl s Ar startsector
149Start the file system at
150.Ar startsector .
151Normally, if the underlying device is a CD-ROM drive,
152.Nm
153will try to figure out the last track from the CD-ROM containing
154data, and start the file system there.
155If the device is not a CD-ROM,
156or the table of contents cannot be examined, the file system will be
157started at sector 0.
158This option can be used to override the behaviour.
159Note that
160.Ar startsector
161is measured in CD-ROM blocks, with 2048 bytes each.
162This is the same
163as for example the
164.Cm info
165command of
166.Xr cdcontrol 1
167is printing.
168It is possible to mount an arbitrary session of a multi-session CD by specifying
169the correct
170.Ar startsector
171here.
172.It Fl U Ar uid
173Set the owner of the files in the file system to
174.Ar uid .
175The default uid on non-Rockridge volumes is zero.
176.It Fl v
177Be verbose about the starting sector decisions made.
178.El
179.Sh EXAMPLES
180The 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
190The
191.Nm
192utility first appeared in
193.Bx 4.4 .
194.Sh BUGS
195POSIX device node mapping is currently not supported.
196.Pp
197Version numbers are not stripped if Rockridge extensions are in use.
198In this case, accessing files that do not have Rockridge names without
199version numbers gets the one with the lowest version number and not
200the one with the highest.
201.Pp
202There is no ECMA support.
203