1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
|
<table class="head">
<tr>
<td class="head-ltitle">DK(4)</td>
<td class="head-vol">Device Drivers Manual</td>
<td class="head-rtitle">DK(4)</td>
</tr>
</table>
<div class="manual-text">
<section class="Sh">
<h1 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h1>
<p class="Pp"><code class="Nm">dk</code> — <span class="Nd">disk
partition (wedge) driver</span></p>
</section>
<section class="Sh">
<h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1>
<p class="Pp"><code class="Cd">options DKWEDGE_AUTODISCOVER</code>
<br/>
<code class="Cd">options DKWEDGE_METHOD_APPLE</code>
<br/>
<code class="Cd">options DKWEDGE_METHOD_BSDLABEL</code>
<br/>
<code class="Cd">options DKWEDGE_METHOD_GPT</code>
<br/>
<code class="Cd">options DKWEDGE_METHOD_MBR</code>
<br/>
<code class="Cd">options DKWEDGE_METHOD_RDB</code>
<br/>
<code class="Cd">options DKWEDGE_METHOD_TOS</code></p>
</section>
<section class="Sh">
<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1>
<p class="Pp">The <code class="Nm">dk</code> driver provides a disk-like
interface, or
<a class="permalink" href="#wedge"><i class="Em" id="wedge">wedge</i></a>,
to an area of a physical disk. Wedges may be configured manually with
<a class="Xr">dkctl(8)</a> or automatically by the kernel upon the
attachment of the physical disk.</p>
<p class="Pp">Wedges need to have unique names. If a duplicate name is detected
during auto-discovery, that partition is ignored.</p>
</section>
<section class="Sh">
<h1 class="Sh" id="KERNEL_OPTIONS"><a class="permalink" href="#KERNEL_OPTIONS">KERNEL
OPTIONS</a></h1>
<dl class="Bl-tag">
<dt id="DKWEDGE_AUTODISCOVER"><a class="permalink" href="#DKWEDGE_AUTODISCOVER"><code class="Dv">DKWEDGE_AUTODISCOVER</code></a></dt>
<dd>Automatically detect and configure wedges using any available methods. For
each partition found, a wedge with a corresponding name is created.
<p class="Pp">Currently only <code class="Dv">DKWEDGE_METHOD_GPT</code> and
<code class="Dv">DKWEDGE_METHOD_APPLE</code> are enabled by default.</p>
</dd>
<dt id="DKWEDGE_METHOD_APPLE"><a class="permalink" href="#DKWEDGE_METHOD_APPLE"><code class="Dv">DKWEDGE_METHOD_APPLE</code></a></dt>
<dd>Apple partition map detection method.</dd>
<dt id="DKWEDGE_METHOD_BSDLABEL"><a class="permalink" href="#DKWEDGE_METHOD_BSDLABEL"><code class="Dv">DKWEDGE_METHOD_BSDLABEL</code></a></dt>
<dd>BSD disklabel detection method. For each configured partition in the
<a class="Xr">disklabel(5)</a> that is not of type
<code class="Dv">FS_UNUSED</code>, a wedge is created and named after the
<var class="Fa">d_packname</var> field followed by
‘<code class="Li">/</code>’ and the partition letter
‘<code class="Li">a</code>’..‘<code class="Li">p</code>’.
<p class="Pp">When the <var class="Fa">d_packname</var> is empty or has the
value ‘<code class="Li">fictitious</code>’, the regular
partition names are used as wedge names, i.e. the device name, unit
number and partition letter, for example
‘<code class="Li">wd0a</code>’.</p>
</dd>
<dt id="DKWEDGE_METHOD_GPT"><a class="permalink" href="#DKWEDGE_METHOD_GPT"><code class="Dv">DKWEDGE_METHOD_GPT</code></a></dt>
<dd>Extensible Firmware Interface Globally Unique Identifier Partition Table
(GPT) detection method.
<p class="Pp">For every GPT partition a wedge is created and named after the
partition label. GPT partitions are UTF-16–encoded, this is
converted into UTF-8. If a partition has no label, its UUID is used
instead.</p>
</dd>
<dt id="DKWEDGE_METHOD_MBR"><a class="permalink" href="#DKWEDGE_METHOD_MBR"><code class="Dv">DKWEDGE_METHOD_MBR</code></a></dt>
<dd>IBM PC-compatible Master Boot Record (MBR) partitioning detection method,
with support for Extended MBRs.
<p class="Pp">For every partition in the MBR a wedge is created and named
like a regular partition name, i.e. the device name, unit number and a
partition letter, for example
‘<code class="Li">wd0e</code>’. Primary partitions start
with ‘<code class="Li">e</code>’, extended partitions
start with ‘<code class="Li">i</code>’.</p>
</dd>
<dt id="DKWEDGE_METHOD_RDB"><a class="permalink" href="#DKWEDGE_METHOD_RDB"><code class="Dv">DKWEDGE_METHOD_RDB</code></a></dt>
<dd>Amiga Rigid Disk Block (RDB) partitioning detection method.</dd>
<dt id="DKWEDGE_METHOD_TOS"><a class="permalink" href="#DKWEDGE_METHOD_TOS"><code class="Dv">DKWEDGE_METHOD_TOS</code></a></dt>
<dd>Atari's TOS partition map detection method, for disks that conform to
Atari's AHDI specification.
<p class="Pp">For each partition, a wedge is created with a name of the
format
<code class="Li">ATARI_</code>{<var class="Ar">type</var>}<code class="Li">_</code>{<var class="Ar">number</var>}
where <var class="Ar">type</var> may either be
‘<code class="Li">GEM</code>’ or
‘<code class="Li">BGM</code>’. The number 0 partition
typically corresponds to the ‘<code class="Li">C:</code>’
drive when read on an actual Atari, the next to
‘<code class="Li">D:</code>’ and so on. Extended
partitions (those of type ‘<code class="Li">XGM</code>’)
are not currently supported.</p>
</dd>
</dl>
</section>
<section class="Sh">
<h1 class="Sh" id="FILES"><a class="permalink" href="#FILES">FILES</a></h1>
<dl class="Bl-tag Bl-compact">
<dt><span class="Pa">/dev/dk*</span></dt>
<dd>Block mode <code class="Nm">dk</code> device special files.</dd>
<dt><span class="Pa">/dev/rdk*</span></dt>
<dd>Raw mode <code class="Nm">dk</code> device special files.</dd>
</dl>
</section>
<section class="Sh">
<h1 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE
ALSO</a></h1>
<p class="Pp"><a class="Xr">config(1)</a>, <a class="Xr">disklabel(8)</a>,
<a class="Xr">dkctl(8)</a>, <a class="Xr">fdisk(8)</a>,
<a class="Xr">gpt(8)</a>, <a class="Xr">MAKEDEV(8)</a></p>
</section>
<section class="Sh">
<h1 class="Sh" id="HISTORY"><a class="permalink" href="#HISTORY">HISTORY</a></h1>
<p class="Pp">The <code class="Nm">dk</code> driver first appeared in
<span class="Ux">NetBSD 3.0</span>.</p>
</section>
<section class="Sh">
<h1 class="Sh" id="AUTHORS"><a class="permalink" href="#AUTHORS">AUTHORS</a></h1>
<p class="Pp">The <code class="Nm">dk</code> driver was written by
<span class="An">Jason R. Thorpe</span>.</p>
</section>
</div>
<table class="foot">
<tr>
<td class="foot-date">April 2, 2024</td>
<td class="foot-os">NetBSD 10.1</td>
</tr>
</table>
|
