Thu May 27 06:53:37 2021 UTC ()
move the basic history i wrote from raidctl(8) to raid(4), and
fix the x86 (thanks simonb) and sparc bootable dates, a couple
of spelling errors.


(mrg)
diff -r1.75 -r1.76 src/sbin/raidctl/raidctl.8
diff -r1.37 -r1.38 src/share/man/man4/raid.4
cvs diff -r1.75 -r1.76 src/sbin/raidctl/raidctl.8 (expand / switch to unified diff)

--- src/sbin/raidctl/raidctl.8 2021/05/26 08:23:18 1.75
+++ src/sbin/raidctl/raidctl.8 2021/05/27 06:53:37 1.76
@@ -1,14 +1,14 @@ @@ -1,14 +1,14 @@
1.\" $NetBSD: raidctl.8,v 1.75 2021/05/26 08:23:18 mrg Exp $ 1.\" $NetBSD: raidctl.8,v 1.76 2021/05/27 06:53:37 mrg Exp $
2.\" 2.\"
3.\" Copyright (c) 1998, 2002 The NetBSD Foundation, Inc. 3.\" Copyright (c) 1998, 2002 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 Greg Oster 7.\" by Greg Oster
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
@@ -156,28 +156,28 @@ Note that all components of the set must @@ -156,28 +156,28 @@ Note that all components of the set must
156in the disklabel. 156in the disklabel.
157.It Fl A Ic no Ar dev 157.It Fl A Ic no Ar dev
158Turn off auto-configuration for the RAID set. 158Turn off auto-configuration for the RAID set.
159.It Fl A Ic forceroot Ar dev 159.It Fl A Ic forceroot Ar dev
160Make the RAID set auto-configurable, and also mark the set as being 160Make the RAID set auto-configurable, and also mark the set as being
161eligible to be the root partition. 161eligible to be the root partition.
162A RAID set configured this way will 162A RAID set configured this way will
163.Ar override 163.Ar override
164the use of the boot disk as the root device. 164the use of the boot disk as the root device.
165All components of the set must be of type 165All components of the set must be of type
166.Dv RAID 166.Dv RAID
167in the disklabel. 167in the disklabel.
168Note that only certain architectures 168Note that only certain architectures
169.Pq currently arc, alpha, amd64, bebox, cobalt, emips, i386, landisk, 169.Pq currently arc, alpha, amd64, bebox, cobalt, emips, evbarm, i386, landisk,
170ofppc, pmax, sandpoint, sgimips, sparc, sparc64, and vax 170ofppc, pmax, riscv, sandpoint, sgimips, sparc, sparc64, and vax
171support booting a kernel directly from a RAID set. 171support booting a kernel directly from a RAID set.
172Please note that 172Please note that
173.Ic forceroot 173.Ic forceroot
174mode was referred to as 174mode was referred to as
175.Ic root 175.Ic root
176mode on earlier versions of 176mode on earlier versions of
177.Nx . 177.Nx .
178For compatibility reasons, 178For compatibility reasons,
179.Ic root 179.Ic root
180can be used as an alias for 180can be used as an alias for
181.Ic forceroot . 181.Ic forceroot .
182.It Fl A Ic softroot Ar dev 182.It Fl A Ic softroot Ar dev
183Like 183Like
@@ -1559,47 +1559,26 @@ scripts. @@ -1559,47 +1559,26 @@ scripts.
1559.Sh SEE ALSO 1559.Sh SEE ALSO
1560.Xr ccd 4 , 1560.Xr ccd 4 ,
1561.Xr raid 4 , 1561.Xr raid 4 ,
1562.Xr rc 8 1562.Xr rc 8
1563.Sh HISTORY 1563.Sh HISTORY
1564RAIDframe is a framework for rapid prototyping of RAID structures 1564RAIDframe is a framework for rapid prototyping of RAID structures
1565developed by the folks at the Parallel Data Laboratory at Carnegie 1565developed by the folks at the Parallel Data Laboratory at Carnegie
1566Mellon University (CMU). 1566Mellon University (CMU).
1567A more complete description of the internals and functionality of 1567A more complete description of the internals and functionality of
1568RAIDframe is found in the paper "RAIDframe: A Rapid Prototyping Tool 1568RAIDframe is found in the paper "RAIDframe: A Rapid Prototyping Tool
1569for RAID Systems", by William V. Courtright II, Garth Gibson, Mark 1569for RAID Systems", by William V. Courtright II, Garth Gibson, Mark
1570Holland, LeAnn Neal Reilly, and Jim Zelenka, and published by the 1570Holland, LeAnn Neal Reilly, and Jim Zelenka, and published by the
1571Parallel Data Laboratory of Carnegie Mellon University. 1571Parallel Data Laboratory of Carnegie Mellon University.
1572.Pp 
1573RAIDframe was ported to 
1574.Nx 
1575by Greg Oster in 1998, who has maintained it since. 
1576In 1999, component labels, spares, automatic rebuilding of parity, and 
1577autoconfiguration of volumes were added. 
1578In 2000, root on RAID support was added (initially, with no support for 
1579loading kernels from RAID volumes, which has been added to many ports since.) 
1580In 2009, support for parity bimap was added, reducing parity resync time 
1581after a crash. 
1582In 2010, support for larger the 2TiB and non-512 sector devices was added. 
1583In 2018, support for 32-bit userland compatibility was added. 
1584In 2021, support for autoconfiguration from other-endian raid sets was added. 
1585.Pp 
1586Support for loading kernels from RAID 1 partitions was added for the 
1587alpha, pmax and vax ports in 2000, the the sgimips port in 2001, 
1588the x86 ports in 2003, the arc port in 2005, the landisk, sparc, and 
1589sparc64 ports in 2006, the cobalt port in 2007, the ofppc port in 2008, 
1590the bebox port in 2010, the emips port in 2011, and the sandpoint port 
1591in 2012. 
1592.Pp 
1593The 1572The
1594.Nm 1573.Nm
1595command first appeared as a program in CMU's RAIDframe v1.1 distribution. 1574command first appeared as a program in CMU's RAIDframe v1.1 distribution.
1596This version of 1575This version of
1597.Nm 1576.Nm
1598is a complete re-write, and first appeared in 1577is a complete re-write, and first appeared in
1599.Nx 1.4 . 1578.Nx 1.4 .
1600.Sh COPYRIGHT 1579.Sh COPYRIGHT
1601.Bd -literal 1580.Bd -literal
1602The RAIDframe Copyright is as follows: 1581The RAIDframe Copyright is as follows:
1603 1582
1604Copyright (c) 1994-1996 Carnegie-Mellon University. 1583Copyright (c) 1994-1996 Carnegie-Mellon University.
1605All rights reserved. 1584All rights reserved.
cvs diff -r1.37 -r1.38 src/share/man/man4/raid.4 (expand / switch to unified diff)

--- src/share/man/man4/raid.4 2013/12/01 00:17:14 1.37
+++ src/share/man/man4/raid.4 2021/05/27 06:53:37 1.38
@@ -1,14 +1,14 @@ @@ -1,14 +1,14 @@
1.\" $NetBSD: raid.4,v 1.37 2013/12/01 00:17:14 christos Exp $ 1.\" $NetBSD: raid.4,v 1.38 2021/05/27 06:53:37 mrg Exp $
2.\" 2.\"
3.\" Copyright (c) 1998 The NetBSD Foundation, Inc. 3.\" Copyright (c) 1998 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 Greg Oster 7.\" by Greg Oster
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,27 +43,27 @@ @@ -43,27 +43,27 @@
43.\" CONDITION. CARNEGIE MELLON DISCLAIMS ANY LIABILITY OF ANY KIND 43.\" CONDITION. CARNEGIE MELLON DISCLAIMS ANY LIABILITY OF ANY KIND
44.\" FOR ANY DAMAGES WHATSOEVER RESULTING FROM THE USE OF THIS SOFTWARE. 44.\" FOR ANY DAMAGES WHATSOEVER RESULTING FROM THE USE OF THIS SOFTWARE.
45.\" 45.\"
46.\" Carnegie Mellon requests users of this software to return to 46.\" Carnegie Mellon requests users of this software to return to
47.\" 47.\"
48.\" Software Distribution Coordinator or Software.Distribution@CS.CMU.EDU 48.\" Software Distribution Coordinator or Software.Distribution@CS.CMU.EDU
49.\" School of Computer Science 49.\" School of Computer Science
50.\" Carnegie Mellon University 50.\" Carnegie Mellon University
51.\" Pittsburgh PA 15213-3890 51.\" Pittsburgh PA 15213-3890
52.\" 52.\"
53.\" any improvements or extensions that they make and grant Carnegie the 53.\" any improvements or extensions that they make and grant Carnegie the
54.\" rights to redistribute these changes. 54.\" rights to redistribute these changes.
55.\" 55.\"
56.Dd August 6, 2007 56.Dd May 26, 2021
57.Dt RAID 4 57.Dt RAID 4
58.Os 58.Os
59.Sh NAME 59.Sh NAME
60.Nm raid 60.Nm raid
61.Nd RAIDframe disk driver 61.Nd RAIDframe disk driver
62.Sh SYNOPSIS 62.Sh SYNOPSIS
63.Cd options RAID_AUTOCONFIG 63.Cd options RAID_AUTOCONFIG
64.Cd options RAID_DIAGNOSTIC 64.Cd options RAID_DIAGNOSTIC
65.Cd options RF_ACC_TRACE=n 65.Cd options RF_ACC_TRACE=n
66.Cd options RF_DEBUG_MAP=n 66.Cd options RF_DEBUG_MAP=n
67.Cd options RF_DEBUG_PSS=n 67.Cd options RF_DEBUG_PSS=n
68.Cd options RF_DEBUG_QUEUE=n 68.Cd options RF_DEBUG_QUEUE=n
69.Cd options RF_DEBUG_QUIESCE=n 69.Cd options RF_DEBUG_QUIESCE=n
@@ -439,26 +439,47 @@ driver for Digital Unix. @@ -439,26 +439,47 @@ driver for Digital Unix.
439The 439The
440.Nm 440.Nm
441driver is a kernelized version of RAIDframe v1.1. 441driver is a kernelized version of RAIDframe v1.1.
442.Pp 442.Pp
443A more complete description of the internals and functionality of 443A more complete description of the internals and functionality of
444RAIDframe is found in the paper "RAIDframe: A Rapid Prototyping Tool 444RAIDframe is found in the paper "RAIDframe: A Rapid Prototyping Tool
445for RAID Systems", by William V. Courtright II, Garth Gibson, Mark 445for RAID Systems", by William V. Courtright II, Garth Gibson, Mark
446Holland, LeAnn Neal Reilly, and Jim Zelenka, and published by the 446Holland, LeAnn Neal Reilly, and Jim Zelenka, and published by the
447Parallel Data Laboratory of Carnegie Mellon University. 447Parallel Data Laboratory of Carnegie Mellon University.
448The 448The
449.Nm 449.Nm
450driver first appeared in 450driver first appeared in
451.Nx 1.4 . 451.Nx 1.4 .
 452.Pp
 453RAIDframe was ported to
 454.Nx
 455by Greg Oster in 1998, who has maintained it since.
 456In 1999, component labels, spares, automatic rebuilding of parity, and
 457autoconfiguration of volumes were added.
 458In 2000, root on RAID support was added (initially, with no support for
 459loading kernels from RAID volumes, which has been added to many ports since.)
 460In 2009, support for parity bimap was added, reducing parity resync time
 461after a crash.
 462In 2010, support for larger than 2TiB and non-512 sector devices was added.
 463In 2018, support for 32-bit userland compatibility was added.
 464In 2021, support for autoconfiguration from other-endian raid sets was added.
 465.Pp
 466Support for loading kernels from RAID 1 partitions was added for the
 467pmax, alpha, i386, and vax ports in 2000, the the sgimips port in 2001,
 468the sparc, sparc64 and amd64 ports in 2002, the arc port in 2005, the
 469landisk port in 2006, the cobalt port in 2007, the ofppc port in 2008,
 470the bebox port in 2010, the emips port in 2011, and the sandpoint port
 471in 2012.
 472.Pp
452.Sh COPYRIGHT 473.Sh COPYRIGHT
453.Bd -unfilled 474.Bd -unfilled
454The RAIDframe Copyright is as follows: 475The RAIDframe Copyright is as follows:
455.Pp 476.Pp
456Copyright (c) 1994-1996 Carnegie-Mellon University. 477Copyright (c) 1994-1996 Carnegie-Mellon University.
457All rights reserved. 478All rights reserved.
458.Pp 479.Pp
459Permission to use, copy, modify and distribute this software and 480Permission to use, copy, modify and distribute this software and
460its documentation is hereby granted, provided that both the copyright 481its documentation is hereby granted, provided that both the copyright
461notice and this permission notice appear in all copies of the 482notice and this permission notice appear in all copies of the
462software, derivative works or modified versions, and any portions 483software, derivative works or modified versions, and any portions
463thereof, and that both notices appear in supporting documentation. 484thereof, and that both notices appear in supporting documentation.
464.Pp 485.Pp