FreeBSD documentation help - new graid3 page.

[Mark Gladman]

Hey all,

I've written up a (very) rough draft (attached) of a graid3 page for 
the FreeBSD manual and would love some input.

I'm not going to pretend to know how to write in DocBook, so I 
apologise for the low-tech plain text nature of it, but as mentioned at 
this point it's still very much a draft and I'm looking for some 
feedback.

The main issue I'm having is explaining how RAID3 actually works. While 
I get it in principle, I'm not sure how the sector size vs. byte-level 
striping stuff works, nor do I know the algorithm used for calculating 
the default sector size when creating a new array.

Sadly I don't have access to FreeBSD box at the moment so I can't look 
through the source code and see this information.

Any feedback would be greatly appreciated. I've also credited Tom 
Rhodes and Murray Stokely since my documentation is based on their RAID0 
handbook page.

Also, it's possible that people will see this page as unneccesary but I 
thought it might be nice to have it.

Thanks!
Mark

PS. Also note there's some asterisks in the page, this is for footnotes 
on the number of bytes by default and about switches which change this 
functionality respectively. I've also asked pjd@ for some implementation 
information too, but knowing he's insanely busy I'd prefer to not hassle 
him if possible.
-------------- next part --------------
An embedded and charset-unspecified text was scrubbed...
Name: graid3.txt
URL: <http://lists.freebsd.org/pipermail/freebsd-doc/attachments/20120113/206fecab/attachment.txt>