Wed Jan 6 14:07:43 2021 UTC ()
Add some paragraph breaks.


(wiz)
diff -r1.9 -r1.10 src/share/man/man4/dk.4
cvs diff -r1.9 -r1.10 src/share/man/man4/dk.4 (expand / switch to unified diff)

--- src/share/man/man4/dk.4 2021/01/06 10:19:27 1.9
+++ src/share/man/man4/dk.4 2021/01/06 14:07:43 1.10
@@ -1,14 +1,14 @@ @@ -1,14 +1,14 @@
1.\" $NetBSD: dk.4,v 1.9 2021/01/06 10:19:27 wiz Exp $ 1.\" $NetBSD: dk.4,v 1.10 2021/01/06 14:07:43 wiz Exp $
2.\" 2.\"
3.\" Copyright (c) 2006 The NetBSD Foundation, Inc. 3.\" Copyright (c) 2006 The NetBSD Foundation, Inc.
4.\" All rights reserved. 4.\" All rights reserved.
5.\" 5.\"
6.\" This code is derived from software contributed to The NetBSD Foundation 6.\" This code is derived from software contributed to The NetBSD Foundation
7.\" by Jason R. Thorpe. 7.\" by Jason R. Thorpe.
8.\" 8.\"
9.\" Redistribution and use in source and binary forms, with or without 9.\" Redistribution and use in source and binary forms, with or without
10.\" modification, are permitted provided that the following conditions 10.\" modification, are permitted provided that the following conditions
11.\" are met: 11.\" are met:
12.\" 1. Redistributions of source code must retain the above copyright 12.\" 1. Redistributions of source code must retain the above copyright
13.\" notice, this list of conditions and the following disclaimer. 13.\" notice, this list of conditions and the following disclaimer.
14.\" 2. Redistributions in binary form must reproduce the above copyright 14.\" 2. Redistributions in binary form must reproduce the above copyright
@@ -43,63 +43,69 @@ driver @@ -43,63 +43,69 @@ driver
43.Cd "options DKWEDGE_METHOD_GPT" 43.Cd "options DKWEDGE_METHOD_GPT"
44.Cd "options DKWEDGE_METHOD_MBR" 44.Cd "options DKWEDGE_METHOD_MBR"
45.Cd "options DKWEDGE_METHOD_RDB" 45.Cd "options DKWEDGE_METHOD_RDB"
46.Cd "options DKWEDGE_METHOD_APPLE" 46.Cd "options DKWEDGE_METHOD_APPLE"
47.Sh DESCRIPTION 47.Sh DESCRIPTION
48The 48The
49.Nm 49.Nm
50driver provides a disk-like interface, or 50driver provides a disk-like interface, or
51.Em wedge , 51.Em wedge ,
52to an area of a physical disk. 52to an area of a physical disk.
53Wedges may be configured manually with 53Wedges may be configured manually with
54.Xr dkctl 8 54.Xr dkctl 8
55or automatically by the kernel upon the attachment of the physical disk. 55or automatically by the kernel upon the attachment of the physical disk.
 56.Pp
56Wedges needs to have a unique name. 57Wedges needs to have a unique name.
57If a duplicate name is detected during 58If a duplicate name is detected during
58auto-discovery, that partition is ignored. 59auto-discovery, that partition is ignored.
59.Sh KERNEL OPTIONS 60.Sh KERNEL OPTIONS
60.Bl -tag -width DKWEDGE_METHOD_BSDLABEL 61.Bl -tag -width DKWEDGE_METHOD_BSDLABEL
61.It Dv DKWEDGE_AUTODISCOVER 62.It Dv DKWEDGE_AUTODISCOVER
62Automatically detect and configure wedges using any available methods. 63Automatically detect and configure wedges using any available methods.
 64.Pp
63Currently only 65Currently only
64.Dv DKWEDGE_METHOD_GPT 66.Dv DKWEDGE_METHOD_GPT
65and 67and
66.Dv DKWEDGE_METHOD_APPLE 68.Dv DKWEDGE_METHOD_APPLE
67are enabled by default. 69are enabled by default.
 70.Pp
68For each partition found, a wedge with a corresponding name is created. 71For each partition found, a wedge with a corresponding name is created.
69.It Dv DKWEDGE_METHOD_BSDLABEL 72.It Dv DKWEDGE_METHOD_BSDLABEL
70BSD disklabel detection method. 73BSD disklabel detection method.
71For each configured partition in the 74For each configured partition in the
72.Xr disklabel 5 75.Xr disklabel 5
73that is not of type 76that is not of type
74.Dv FS_UNUSED , 77.Dv FS_UNUSED ,
75a wedge is created and named after the 78a wedge is created and named after the
76.Va d_packname 79.Va d_packname
77field followed by "/" and the partition letter a..p. 80field followed by "/" and the partition letter a..p.
 81.Pp
78When the 82When the
79.Va d_packname 83.Va d_packname
80is empty or has the value "fictitious", the regular partition names 84is empty or has the value "fictitious", the regular partition names
81are used as wedge names, i.e. the device name, unit number and 85are used as wedge names, i.e. the device name, unit number and
82partition letter, for example "wd0a". 86partition letter, for example "wd0a".
83.It Dv DKWEDGE_METHOD_GPT 87.It Dv DKWEDGE_METHOD_GPT
84Extensible Firmware Interface Globally Unique Identifier Partition Table 88Extensible Firmware Interface Globally Unique Identifier Partition Table
85(GPT) detection method. 89(GPT) detection method.
 90.Pp
86For every GPT partition a wedge is created and named after the 91For every GPT partition a wedge is created and named after the
87partition label. 92partition label.
88GPT partitions are UTF-16-encoded, this is converted into UTF-8. 93GPT partitions are UTF-16-encoded, this is converted into UTF-8.
89If a partition has no label, its UUID is used instead. 94If a partition has no label, its UUID is used instead.
90.It Dv DKWEDGE_METHOD_MBR 95.It Dv DKWEDGE_METHOD_MBR
91IBM PC-compatible Master Boot Record (MBR) partitioning detection method, 96IBM PC-compatible Master Boot Record (MBR) partitioning detection method,
92with support for Extended MBRs. 97with support for Extended MBRs.
 98.Pp
93For every partition in the MBR a wedge is created and named like a 99For every partition in the MBR a wedge is created and named like a
94regular partition name, i.e. the device name, unit number and a 100regular partition name, i.e. the device name, unit number and a
95partition letter, for example "wd0e". 101partition letter, for example "wd0e".
96Primary partitions start with "e", extended partitions start with "i". 102Primary partitions start with "e", extended partitions start with "i".
97.It Dv DKWEDGE_METHOD_RDB 103.It Dv DKWEDGE_METHOD_RDB
98Amiga Rigid Disk Block (RDB) partitioning detection method. 104Amiga Rigid Disk Block (RDB) partitioning detection method.
99.It Dv DKWEDGE_METHOD_APPLE 105.It Dv DKWEDGE_METHOD_APPLE
100Apple partition map detection method. 106Apple partition map detection method.
101.El 107.El
102.Sh FILES 108.Sh FILES
103.Bl -tag -width /dev/XXrXdkX -compact 109.Bl -tag -width /dev/XXrXdkX -compact
104.It Pa /dev/{,r}dk* 110.It Pa /dev/{,r}dk*
105.Nm 111.Nm