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