.\" $NetBSD: mount_udf.8,v 1.14 2019/10/16 21:52:22 maya Exp $
.\"
.\" Copyright (c) 2006, 2008 Reinoud Zandijk
.\" All rights reserved.
.\"
.\" Redistribution and use in source and binary forms, with or without
.\" modification, are permitted provided that the following conditions
.\" are met:
.\" 1. Redistributions of source code must retain the above copyright
.\"    notice, this list of conditions and the following disclaimer.
.\" 2. Redistributions in binary form must reproduce the above copyright
.\"    notice, this list of conditions and the following disclaimer in the
.\"    documentation and/or other materials provided with the distribution.
.\"
.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
.\"
.\" <<Id: LICENSE,v 1.2 2000/06/14 15:57:33 cgd Exp>>
.\"
.Dd September 12, 2016
.Dt MOUNT_UDF 8
.Os
.Sh NAME
.Nm mount_udf
.Nd mount an UDF file system
.Sh SYNOPSIS
.Nm
.Op Fl c
.Op Fl g Ar gid
.Op Fl o Ar options
.Op Fl t Ar gmtoff
.Op Fl s Ar session
.Op Fl u Ar uid
.Ar special
.Ar node
.Sh DESCRIPTION
The
.Nm
command attaches the UDF file system residing on the specified
.Ar special
device node on the location indicated with
.Ar node .
.Pp
Anonymous files stored on the UDF disc will be represented and saved in the
specified uid:gid pair.
If unspecified, it will default to nobody:nobody.
Both uid and gid can be either specified with their names as with
their numerical equivalents.
.Bl -tag -width XXXoptions
.It Fl c
Close the session after unmount creating remountable snapshots.
Closing a session also allows -ROM devices to read the disc created.
Note that this option only makes sense when mounting sequential
recordable media like CD-R and DVD*R.
.It Fl g Ar gid
Set the group of anonymous files on the file system.
The default group is the nobody group.
.It Fl o Ar options
Use the specified mount
.Ar options
as specified in
.Xr mount 8 .
.It Fl s Ar session
Select the session
.Ar session
to be mounted instead of the default last one.
Implements readonly snapshots on sequential media.
Positive
.Ar session
values indicate an absolute session number.
Negative
.Ar session
values are relative to the last session found on the disc.
Note that this option only makes sense when mounting sequential
recordable media like CD-R and DVD*R.
.It Fl t Ar gmtoff
Set the time zone offset (in seconds) from UTC to
.Ar gmtoff ,
with positive values indicating east of the Prime Meridian.
If not set, the user's current time zone will be used.
.It Fl u Ar uid
Set the owner of anonymous files on the file system.
The default owner is the user nobody.
.El
.Sh SEE ALSO
.Xr mount 2 ,
.Xr vnd 4 ,
.Xr fstab 5 ,
.Xr mount 8 ,
.Xr umount 8 ,
.Xr vnconfig 8
.Sh HISTORY
A
.Nm
utility appeared in
.Nx 4.0 .
.Sh AUTHORS
.An Reinoud Zandijk Aq Mt reinoud@NetBSD.org .
.Sh NOTES
UDF is a file system defined by the OSTA standardization group and
is tailored for data interchange on optical discs (like CDs and
DVDs) between different operating systems.
Its also more and more common on other media like Compact
Flash (CF) cards.
.Pp
Read and write access is supported for all media types that CD/DVD type drives
can recognise including DVD-RAM.
BluRay support is preliminary; read-only
access should work fine but write support is experimental.
.Pp
Implemented and tested media types are CD-ROM, CD-R, CD-RW, CD-MRW,
DVD-ROM, DVD*R, DVD*RW, DVD+MRW, DVD-RAM but the same code can also read
HD-DVD and BluRay discs.
Discs created and written by UDFclient, Nero's InCD, and Roxio's
DirectCD/Drag2Disc can be read without problems.
Both open and closed media are supported so
there is no need to close discs or sessions.
.Pp
All current UDF versions up to version 2.60 are supported.
.Pp
Hard disk partitions and
.Xr vnd 4
devices may also be mounted.
Note when mounting a
.Xr vnd 4
device it might be necessary to specify the file image sector size
in the
.Pa geomspec
when creating the
.Xr vnd 4
device or the disc sector size will be used.
.Sh BUGS
Write support for UDF version 2.50 is not completely mature and UDF version
2.01 should be used if possible; this is also the default format.
.Pp
Due to lack of test media and recording devices, BluRay support and in
particular BluRay-R is still preliminary as of writing.