| blob | 2660fb4e7520e80c98367c84fe972806ddc8fb5f |
1 .\" $NetBSD: newfs_udf.8,v 1.18 2013/08/06 12:15:20 wiz Exp $
2 .\"
3 .\" Copyright (c) 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
13 .\" the documentation and/or other materials provided with the
14 .\" distribution.
15 .\"
16 .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR(S) ``AS IS'' AND ANY EXPRESS
17 .\" OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
18 .\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
19 .\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR(S) BE LIABLE FOR ANY
20 .\" DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
21 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
22 .\" GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
23 .\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
24 .\" IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
25 .\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
26 .\" IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
27 .\"
28 .\"
29 .Dd August 2, 2013
30 .Dt NEWFS_UDF 8
31 .Os
32 .Sh NAME
33 .Nm newfs_udf
34 .Nd construct a new UDF file system
35 .Sh SYNOPSIS
36 .Nm
37 .Op Fl cFM
38 .Op Fl B Ar blockingsize
39 .Op Fl L Ar loglabel
40 .Op Fl P Ar discid
41 .Op Fl p Ar percentage
42 .Op Fl S Ar sectorsize
43 .Op Fl s Ar size
44 .Op Fl t Ar gmtoff
45 .Op Fl V Ar max_udf
46 .Op Fl v Ar min_udf
47 .Ar special
48 .Sh DESCRIPTION
49 The
50 .Nm
51 utility creates an UDF file system on device
52 .Ar special
53 suitable for the media currently inserted.
54 .Pp
55 The options are as follow:
56 .Bl -tag -width indent
57 .It Fl B Ar blockingsize
58 When creating image files, specify the blocking size or packetsize of the media
59 to
60 .Ar blockingsize .
61 .It Fl c
62 Perform a crude surface check first to weed out disc faults on rewritable
63 media.
64 .It Fl F
65 Force file system construction on non-empty recordable media or create an
66 image file.
67 .It Fl L Ar loglabel
68 Set the disc logical label to the specified
69 .Ar loglabel .
70 .It Fl M
71 Disable metadata partition creation when selected UDF version or media dictates
72 this.
73 For strict conformance and interchange, don't disable this unless
74 its causing problems.
75 .It Fl P Ar discid
76 Set the physical disc label to the specified
77 .Ar discid .
78 .Pp
79 Prepend
80 .Ar discid
81 with volsetname separated with a ':' if wanted.
82 For strict conformance and interchange, don't set this manually unless it has
83 a unique hex number in the first 8 character positions.
84 .It Fl p Ar percentage
85 Percentage of partition to be initially reserved for metadata on the Metadata
86 partition.
87 It defaults to 20 %.
88 .It Fl S Ar sectorsize
89 Set the sectorsize for image files.
90 For strict conformance and interchange, don't set this manually.
91 .It Fl s Ar size
92 For image files, set the file size to the humanized size
93 .Ar size .
94 .It Fl t Ar gmtoff
95 Use the specified
96 .Ar gmtoff
97 as gmt time offset for recording times on the disc.
98 .It Fl V Ar max_udf
99 Select
100 .Ar max_udf
101 as the maximum UDF version to be supported.
102 For UDF version 2.50, use
103 .Dq 0x250
104 or
105 .Dq 2.50 .
106 .It Fl v Ar min_udf
107 Select
108 .Ar min_udf
109 as the minimum UDF version to be supported.
110 For UDF version 2.01, use
111 .Dq 0x201
112 or
113 .Dq 2.01 .
114 .El
115 .Sh NOTES
116 The UDF file system is defined for the entire optical medium.
117 It can only function on the entire CD/DVD/BD so the raw partition
118 has to be specified for read/write actions.
119 For
120 .Nm
121 this means specifying the raw device with the raw partition, i.e.
122 .Pa /dev/rcd0d
123 or
124 .Pa /dev/rcd0c .
125 .Pp
126 Some rewritable optical media needs to be formatted first before it can be
127 used by UDF.
128 This can be done using
129 .Xr mmcformat 8 .
130 .Pp
131 The default UDF version is version 2.01.
132 .Sh EXAMPLES
133 Create a file system, using the specified names on the device
134 .Pa /dev/rcd0d
135 with the default UDF version :
136 .Bd -literal -offset indent
137 newfs_udf -P "Encyclopedia:copy-nr-1" -L "volume 2" /dev/rcd0d
138 .Ed
139 .Pp
140 Create a 4.8 GiB sparse file and configure it using
141 .Xr vnconfig 8
142 to be a 2048 sector size disc and create a new UDF file system on
143 .Pa /dev/rvnd0d
144 :
145 .Bd -literal -offset indent
146 dd if=/dev/zero of=bigdisk.2048.udf seek=9999999 count=1
147 vnconfig -c vnd0 bigdisk.2048.udf 2048/1/1/1
148 newfs_udf -L bigdisk /dev/rvnd0d
149 .Ed
150 .Pp
151 Create a 2 GiB file and create a new UDF file system on it using the default
152 512 byte sector size :
153 .Bd -literal -offset indent
154 newfs_udf -L bigdisk2 -F -s 2G bigdisk2.iso
155 .Ed
156 .Pp
157 Create a 200 MiB file and create a new UDF file system on it using a sector size
158 of 2048 :
159 .Bd -literal -offset indent
160 newfs_udf -L bigdisk2 -F -s 200M -S 2048 bigdisk3.iso
161 .Ed
162 .Pp
163 Create a new UDF file system on the inserted USB stick using its
164 native sectorsize of 512 :
165 .Bd -literal -offset indent
166 newfs_udf -L "My USB stick" /dev/rsd0d
167 .Ed
168 .Sh SEE ALSO
169 .Xr disktab 5 ,
170 .Xr disklabel 8 ,
171 .Xr mmcformat 8 ,
172 .Xr newfs 8
173 .Sh HISTORY
174 The
175 .Nm
176 command first appeared in
177 .Nx 5.0 .
178 .Sh AUTHORS
179 .An Reinoud Zandijk Aq Mt reinoud@NetBSD.org
180 .Sh BUGS
181 The
182 .Ar P
183 and the
184 .Ar S
185 arguments have changed meaning.
186 The meaning of
187 .Ar S
188 has been merged into
189 .Ar P
190 since
191 .Nx 6.1 .