xref: /netbsd-src/sbin/mount_udf/mount_udf.8 (revision ce099b40997c43048fb78bd578195f81d2456523)
1.\" $NetBSD: mount_udf.8,v 1.6 2006/02/06 11:45:50 reinoud Exp $
2.\"
3.\" Copyright (c) 2005 Reinoud Zandijk
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 January 26, 2006
36.Dt MOUNT_UDF 8
37.Os
38.Sh NAME
39.Nm mount_udf
40.Nd mount an UDF file system
41.Sh SYNOPSIS
42.Nm
43.\".Op Fl c
44.Op Fl g Ar gid
45.Op Fl o Ar options
46.Op Fl t Ar gmtoff
47.Op Fl u Ar uid
48.Ar special
49.Ar node
50.Sh DESCRIPTION
51The
52.Nm
53command attaches the UDF file system residing on the specified
54.Ar special
55device node on the location indicated with
56.Ar node .
57.Pp
58Anonymous files stored on the UDF disc will be represented and saved in the
59specified uid:gid pair.
60If unspecified, it will default to nobody:nobody.
61Both uid and gid can be either specified with their names as with
62their numerical equivalents.
63.Bl -tag -width XXXoptions
64.\" .It Fl c
65.\" Close the CD/DVD session after unmount (writing).
66.It Fl g Ar gid
67Set the group of anonymous files on the file system.
68The default group is the nobody group.
69.It Fl o Ar options
70Use the specified mount
71.Ar options
72as specified in
73.Xr mount 8 .
74.It Fl s Ar session
75Select the session
76.Ar session
77to be mounted instead of the default last one.
78Positive
79.Ar session
80values indicate an absolute session number.
81Negative
82.Ar session
83values are relative to the last session found on the disc.
84Note that this option only makes sense when mounting sequential
85recordable media like CD-R and DVD*R.
86.It Fl t Ar gmtoff
87Set the time zone offset (in seconds) from UTC to
88.Ar gmtoff ,
89with positive values indicating east of the Prime Meridian.
90If not set, the user's current time zone will be used.
91.It Fl u Ar uid
92Set the owner of anonymous files on the file system.
93The default owner is the user nobody.
94.El
95.Sh SEE ALSO
96.Xr mount 2 ,
97.Xr vnd 4 ,
98.Xr fstab 5 ,
99.Xr mount 8 ,
100.Xr umount 8 ,
101.Xr vnconfig 8
102.Sh NOTES
103UDF is a file system defined by the OSTA standardization group and
104is tailored for data interchange on optical discs (like CDs and
105DVDs) between different operating systems.
106Its also more and more common on other media like Compact
107Flash (CF) cards.
108.Pp
109Currently only read access is supported for all media types that
110CD/DVD type drives can recognise including DVD-RAM and BluRay
111drives.
112Write access is planned and in preparation.
113.Pp
114Implemented and tested media types are CD-ROM, CD-R, CD-RW, CD-MRW,
115DVD-ROM, DVD*R, DVD*RW, DVD+MRW but the same code can also read
116DVD-RAM, HD-DVD and BluRay discs.
117Discs created and written by UDFclient, Nero's InCD, and Roxio's
118DirectCD/Drag2Disc can be read without problems.
119Both open and closed media are supported so
120there is no need to close discs or sessions.
121.Pp
122All current UDF versions up to version 2.60 are supported.
123.Pp
124Hard disk partitions and
125.Xr vnd 4
126devices may also be mounted.
127Note when mounting a
128.Xr vnd 4
129device it might be necessary to specify the file image sector size
130in the
131.Pa geomspec
132when creating the
133.Xr vnd 4
134device or the disc sector size will be used.
135.Sh BUGS
136Due to lack of test media, versions 2.50 and 2.60 are prepared but
137not implemented and tested yet.
138