Date: Fri, 13 Jan 2012 12:18:58 +1100 From: Mark Gladman <mark@legios.org> To: <freebsd-doc@freebsd.org> Subject: FreeBSD documentation help - new graid3 page. Message-ID: <4b483061e36652917b178aa44447026f@legios.org>
next in thread | raw e-mail | index | archive | help
--=_8dfcc4f30d49a5b722f2fc9c432f93f6 Content-Transfer-Encoding: 7bit Content-Type: text/plain; charset=UTF-8; format=flowed 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. --=_8dfcc4f30d49a5b722f2fc9c432f93f6 Content-Transfer-Encoding: base64 Content-Type: text/plain; name=graid3.txt Content-Disposition: attachment; filename=graid3.txt V3JpdHRlbiBieSBNYXJrIEdsYWRtYW4gYmFzZWQgb24gZG9jdW1lbnRhdGlvbiBmcm9tIFRvbSBS aG9kZXMgYW5kIE11cnJheSBTdG9rZWx5LgoKUkFJRDMgaXMgYSBtZXRob2QgdXNlZCB0byBjb21i aW5lIHNldmVyYWwgZGlzayBkcml2ZXMgaW50byBhIHNpbmdsZSB2b2x1bWUgd2l0aCBhIGRlZGlj YXRlZCBwYXJpdHkgZGlzayAuIFRoZSBHRU9NIGRpc2sgc3Vic3lzdGVtIHByb3ZpZGVzIHNvZnR3 YXJlIHN1cHBvcnQgZm9yIFJBSUQzLgoKSW4gYSBSQUlEMyBzeXN0ZW0sIGRhdGEgaXMgc3BsaXQg dXAgaW4gdG8gYSBudW1iZXIgb2YgYnl0ZXMqIHRoYXQgZ2V0IHdyaXR0ZW4gYWNyb3NzIGFsbCB0 aGUgZHJpdmVzIGluIHRoZSBhcnJheSBleGNlcHQgZm9yIG9uZSBkaXNrLCB0aGF0IGFjdHMgYXMg YSBkZWRpY2F0ZWQgcGFyaXR5IGRpc2suIFRoaXMgbWVhbnMgdGhhdCByZWFkaW5nIDEwMjRrYiBm cm9tIGEgUkFJRDMgaW1wbGVtZW50YXRpb24gd2lsbCBhY2Nlc3MgYWxsIGRpc2tzIGluIHRoZSBh cnJheSBiYXIgb25lICh0aGUgZGVkaWNhdGVkIHBhcml0eSBkaXNrKikgdG8gcmVhZCB0aGUgMTAy NGtiLiBUaGlzIHBlcmZvcm1hbmNlIGNhbiBiZSBlbmhhbmNlZCBieSB1c2luZyBtdWx0aXBsZSBk aXNrIGNvbnRyb2xsZXJzLgoKRWFjaCBkaXNrIGluIGEgUkFJRDMgYXJyYXkgbXVzdCBiZSBvZiB0 aGUgc2FtZSBzaXplLCBzaW5jZSBJL08gcmVxdWVzdHMgYXJlIGludGVybGVhdmVkIHRvIHJlYWQg b3Igd3JpdGUgdG8gbXVsdGlwbGUgZGlza3MgaW4gcGFyYWxsZWwuIEFsc28gZHVlIHRvIHRoZSBu YXR1cmUgb2YgUkFJRDMsIHRoZSBudW1iZXIgb2YgY29tcG9uZW50cyBtdXN0IGJlIGVxdWFsIHRv IDMsIDUsIDksIDE3LCBldGMuICgyXm4gKyAxKS4KCgpDcmVhdGluZyBhYXJyYXkgb2YgdW5mb3Jt YXR0ZWQgQVRBIGRpc2tzCgogICAxLgoKICAgICAgTG9hZCB0aGUgZ2VvbV9yYWlkMy5rbyBtb2R1 bGU6CgogICAgICAjIGtsZGxvYWQgZ2VvbV9yYWlkMwoKICAgMi4KCiAgICAgIEVuc3VyZSB0aGF0 IGEgc3VpdGFibGUgbW91bnQgcG9pbnQgZXhpc3RzLiBJZiB0aGlzIHZvbHVtZSB3aWxsIGJlY29t ZSBhIHJvb3QgcGFydGl0aW9uLCB0aGVuIHRlbXBvcmFyaWx5IHVzZSBhbm90aGVyIG1vdW50IHBv aW50IHN1Y2ggYXMgL21udDoKCiAgICAgICMgbWtkaXIgL21udAoKICAgMy4KCiAgICAgIERldGVy bWluZSB0aGUgZGV2aWNlIG5hbWVzIGZvciB0aGUgZGlza3Mgd2hpY2ggd2lsbCBiZSBhZGRlZCB0 byB0aGUgYXJyYXksIGFuZCBjcmVhdGUgdGhlIG5ldyBSQUlEMyBkZXZpY2UuIFRoZSBmaW5hbCBk ZXZpY2UgbGlzdGVkIHdpbGwgYmUgdGhlIGRlZGljYXRlZCBwYXJpdHkgZGlzay4gRm9yIGV4YW1w bGUsIHRvIGFkZCB0aHJlZSBkaXNrcyB1bnVzZWQgYW5kIHVucGFydGl0aW9uZWQgQVRBIGRpc2tz LCBmb3IgZXhhbXBsZSAvZGV2L2FkMSwgL2Rldi9hZDIgYW5kIC9kZXYvYWQzOgoKICAgICAgIyBn cmFpZDMgbGFiZWwgLXYgZ3IwIC9kZXYvYWQxIC9kZXYvYWQyIC9kZXYvYWQzCiAgICAgIE1ldGFk YXRhIHZhbHVlIHN0b3JlZCBvbiAvZGV2L2FkMS4KICAgICAgTWV0YWRhdGEgdmFsdWUgc3RvcmVk IG9uIC9kZXYvYWQyLgogICAgICBNZXRhZGF0YSB2YWx1ZSBzdG9yZWQgb24gL2Rldi9hZDMuCiAg ICAgIERvbmUuCgogICA0LgoKICAgICAgV3JpdGUgYSBzdGFuZGFyZCBsYWJlbCwgYWxzbyBrbm93 biBhcyBhIHBhcnRpdGlvbiB0YWJsZSwgb24gdGhlIG5ldyB2b2x1bWUgYW5kIGluc3RhbGwgdGhl IGRlZmF1bHQgYm9vdHN0cmFwIGNvZGU6CgogICAgICAjIGJzZGxhYmVsIC13QiAvZGV2L3JhaWQz L2dyMAoKICAgNS4KCiAgICAgIFRoaXMgcHJvY2VzcyBzaG91bGQgaGF2ZSBjcmVhdGVkIHR3byBv dGhlciBkZXZpY2VzIGluIHRoZSAvZGV2L3JhaWQzIGRpcmVjdG9yeSBpbiBhZGRpdGlvbiB0byB0 aGUgZ3IwIGRldmljZS4gVGhvc2UgaW5jbHVkZSBncjBhIGFuZCBncjBjLiBBdCB0aGlzIHBvaW50 IGEgZmlsZSBzeXN0ZW0gbWF5IGJlIGNyZWF0ZWQgb24gdGhlIGdyMGEgZGV2aWNlIHdpdGggdGhl IG5ld2ZzIHV0aWxpdHk6CgogICAgICAjIG5ld2ZzIC1VIC9kZXYvcmFpZDMvZ3IwYQoKICAgICAg TWFueSBudW1iZXJzIHdpbGwgZ2xpZGUgYWNyb3NzIHRoZSBzY3JlZW4sIGFuZCBhZnRlciBhIGZl dyBzZWNvbmRzLCB0aGUgcHJvY2VzcyB3aWxsIGJlIGNvbXBsZXRlLiBUaGUgdm9sdW1lIGhhcyBi ZWVuIGNyZWF0ZWQgYW5kIGlzIHJlYWR5IHRvIGJlIG1vdW50ZWQuCgpUbyBtYW51YWxseSBtb3Vu dCB0aGUgY3JlYXRlZCBkaXNrIHN0cmlwZToKCiMgbW91bnQgL2Rldi9yYWlkMy9ncjBhIC9tbnQK ClRvIG1vdW50IHRoaXMgbmV3bHkgY3JlYXRlZCBhcnJheSdzIGZpbGUgc3lzdGVtIGF1dG9tYXRp Y2FsbHkgZHVyaW5nIHRoZSBib290IHByb2Nlc3MsIHBsYWNlIHRoZSB2b2x1bWUgaW5mb3JtYXRp b24gaW4gL2V0Yy9mc3RhYiBmaWxlLiBGb3IgdGhpcyBwdXJwb3NlLCBhIHBlcm1hbmVudCBtb3Vu dCBwb2ludCwgbmFtZWQgcmFpZDMsIGlzIGNyZWF0ZWQ6CgojIG1rZGlyIC9yYWlkMwojIGVjaG8g Ii9kZXYvcmFpZDMvZ3IwYSAvcmFpZDMgdWZzIHJ3IDIgMiIgXAogICAgPj4gL2V0Yy9mc3RhYgoK VGhlIGdlb21fcmFpZDMua28gbW9kdWxlIG11c3QgYWxzbyBiZSBhdXRvbWF0aWNhbGx5IGxvYWRl ZCBkdXJpbmcgc3lzdGVtIGluaXRpYWxpemF0aW9uLCBieSBhZGRpbmcgYSBsaW5lIHRvIC9ib290 L2xvYWRlci5jb25mOgoKIyBlY2hvICdnZW9tX3JhaWQzX2xvYWQ9IllFUyInID4+IC9ib290L2xv YWRlci5jb25m --=_8dfcc4f30d49a5b722f2fc9c432f93f6--
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?4b483061e36652917b178aa44447026f>