sbin/mount_udf/mount_udf.8

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