1.\" $NetBSD: mount_udf.8,v 1.14 2019/10/16 21:52:22 maya 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.\" 15.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR 16.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES 17.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. 18.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, 19.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT 20.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, 21.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY 22.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 23.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF 24.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 25.\" 26.\" <<Id: LICENSE,v 1.2 2000/06/14 15:57:33 cgd Exp>> 27.\" 28.Dd September 12, 2016 29.Dt MOUNT_UDF 8 30.Os 31.Sh NAME 32.Nm mount_udf 33.Nd mount an UDF file system 34.Sh SYNOPSIS 35.Nm 36.Op Fl c 37.Op Fl g Ar gid 38.Op Fl o Ar options 39.Op Fl t Ar gmtoff 40.Op Fl s Ar session 41.Op Fl u Ar uid 42.Ar special 43.Ar node 44.Sh DESCRIPTION 45The 46.Nm 47command attaches the UDF file system residing on the specified 48.Ar special 49device node on the location indicated with 50.Ar node . 51.Pp 52Anonymous files stored on the UDF disc will be represented and saved in the 53specified uid:gid pair. 54If unspecified, it will default to nobody:nobody. 55Both uid and gid can be either specified with their names as with 56their numerical equivalents. 57.Bl -tag -width XXXoptions 58.It Fl c 59Close the session after unmount creating remountable snapshots. 60Closing a session also allows -ROM devices to read the disc created. 61Note that this option only makes sense when mounting sequential 62recordable media like CD-R and DVD*R. 63.It Fl g Ar gid 64Set the group of anonymous files on the file system. 65The default group is the nobody group. 66.It Fl o Ar options 67Use the specified mount 68.Ar options 69as specified in 70.Xr mount 8 . 71.It Fl s Ar session 72Select the session 73.Ar session 74to be mounted instead of the default last one. 75Implements readonly snapshots on sequential media. 76Positive 77.Ar session 78values indicate an absolute session number. 79Negative 80.Ar session 81values are relative to the last session found on the disc. 82Note that this option only makes sense when mounting sequential 83recordable media like CD-R and DVD*R. 84.It Fl t Ar gmtoff 85Set the time zone offset (in seconds) from UTC to 86.Ar gmtoff , 87with positive values indicating east of the Prime Meridian. 88If not set, the user's current time zone will be used. 89.It Fl u Ar uid 90Set the owner of anonymous files on the file system. 91The default owner is the user nobody. 92.El 93.Sh SEE ALSO 94.Xr mount 2 , 95.Xr vnd 4 , 96.Xr fstab 5 , 97.Xr mount 8 , 98.Xr umount 8 , 99.Xr vnconfig 8 100.Sh HISTORY 101A 102.Nm 103utility appeared in 104.Nx 4.0 . 105.Sh AUTHORS 106.An Reinoud Zandijk Aq Mt reinoud@NetBSD.org . 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