In responding to a post on misc@, I noticed that bioctl(8) uses all sd(4) devices in the examples sections while softraid(4) uses wd(4) devices for the chunks. This patch updates softraid.4 to use sd(4) devices as well. I have not used a wd(4) device in years and I think it more confusing to use examples with wd(4) when almost everything these days is sd(4).
Bryan Index: share/man/man4/softraid.4 =================================================================== RCS file: /cvs/src/share/man/man4/softraid.4,v retrieving revision 1.41 diff -u -p -r1.41 softraid.4 --- share/man/man4/softraid.4 14 Apr 2015 19:10:13 -0000 1.41 +++ share/man/man4/softraid.4 5 Dec 2016 21:58:55 -0000 @@ -121,41 +121,41 @@ An example to create a 3 chunk RAID 1 fr .Pp Initialize the partition tables of all disks: .Bd -literal -offset indent -# fdisk -iy wd1 -# fdisk -iy wd2 -# fdisk -iy wd3 +# fdisk -iy sd1 +# fdisk -iy sd2 +# fdisk -iy sd3 .Ed .Pp Now create RAID partitions on all disks: .Bd -literal -offset indent -# printf "a\en\en\en\enRAID\enw\enq\en\en" | disklabel -E wd1 -# printf "a\en\en\en\enRAID\enw\enq\en\en" | disklabel -E wd2 -# printf "a\en\en\en\enRAID\enw\enq\en\en" | disklabel -E wd3 +# printf "a\en\en\en\enRAID\enw\enq\en\en" | disklabel -E sd1 +# printf "a\en\en\en\enRAID\enw\enq\en\en" | disklabel -E sd2 +# printf "a\en\en\en\enRAID\enw\enq\en\en" | disklabel -E sd3 .Ed .Pp Assemble the RAID volume: .Bd -literal -offset indent -# bioctl -c 1 -l /dev/wd1a,/dev/wd2a,/dev/wd3a softraid0 +# bioctl -c 1 -l /dev/sd1a,/dev/sd2a,/dev/sd3a softraid0 .Ed .Pp The console will show what device was added to the system: .Bd -literal -offset indent scsibus0 at softraid0: 1 targets -sd0 at scsibus0 targ 0 lun 0: <OPENBSD, SR RAID 1, 001> SCSI2 -sd0: 1MB, 0 cyl, 255 head, 63 sec, 512 bytes/sec, 3714 sec total +sd4 at scsibus0 targ 0 lun 0: <OPENBSD, SR RAID 1, 001> SCSI2 +sd4: 1MB, 0 cyl, 255 head, 63 sec, 512 bytes/sec, 3714 sec total .Ed .Pp It is good practice to wipe the front of the disk before using it: .Bd -literal -offset indent -# dd if=/dev/zero of=/dev/rsd0c bs=1m count=1 +# dd if=/dev/zero of=/dev/rsd4c bs=1m count=1 .Ed .Pp Initialize the partition table and create a filesystem on the new RAID volume: .Bd -literal -offset indent -# fdisk -iy sd0 -# printf "a\en\en\en\en4.2BSD\enw\enq\en\en" | disklabel -E sd0 -# newfs /dev/rsd0a +# fdisk -iy sd4 +# printf "a\en\en\en\en4.2BSD\enw\enq\en\en" | disklabel -E sd4 +# newfs /dev/rsd4a .Ed .Pp The RAID volume is now ready to be used as a normal disk device. @@ -167,7 +167,7 @@ Install .Xr boot 8 on the RAID volume: .Bd -literal -offset indent -# installboot sd0 +# installboot sd4 .Ed .Pp At the