os/doc
3
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity

Restore the Handbook vinum chapter into a new separate article.

Browse source
This commit is contained in:
Warren Block 2015-02-25 19:01:26 +00:00
parent 8d9033283b
commit b424ea6457
Notes: svn2git 2020-12-08 03:00:23 +00:00 
svn path=/head/; revision=46293
9 changed files with 467 additions and 0 deletions

1
en_US.ISO8859-1/articles/Makefile
View file

@ -42,6 +42,7 @@ SUBDIR+= releng-packages
SUBDIR+= remote-install SUBDIR+= remote-install
SUBDIR+= serial-uart SUBDIR+= serial-uart
SUBDIR+= solid-state SUBDIR+= solid-state
SUBDIR+= vinum
SUBDIR+= vm-design SUBDIR+= vm-design
SUBDIR+= wp-toolbox SUBDIR+= wp-toolbox

4
en_US.ISO8859-1/htdocs/docs/books.xml
View file

@ -310,6 +310,10 @@
Solid State Devices</a> (solid-state)<br/> Solid State Devices</a> (solid-state)<br/>
The use of solid state disk devices in FreeBSD.</p> The use of solid state disk devices in FreeBSD.</p>
<p><a href="&url.articles;/vinum/index.html">The vinum Volume
Manager</a> (vinum)<br/>
Using gvinum to create RAID arrays.</p>
<p><a href="&url.articles;/vm-design/index.html">Design elements <p><a href="&url.articles;/vm-design/index.html">Design elements
of the FreeBSD VM system</a> (vm-design)<br/> of the FreeBSD VM system</a> (vm-design)<br/>
An easy to follow description of the design of the FreeBSD An easy to follow description of the design of the FreeBSD

78
share/images/articles/vinum/vinum-concat.pic Normal file
View file

@ -0,0 +1,78 @@
.\" $FreeBSD$
.PS
h = .3i
dh = .02i
dw = .8i
down
[
[
boxht = h; boxwid = dw
.\"
.\" ORIG: box invis "\f(CW0\fP"
.\" box invis "\f(CW1\fP"
.\" box invis "\f(CW2\fP"
.\" box invis "\f(CW3\fP"
.\" box invis "\f(CW4\fP"
.\" box invis "\f(CW5\fP"
.\" A: box dotted at ORIG.e+(.4,0) ht h "\f(CW0\fP"
move right 1i; down
A: box dotted ht h "\f(CW0\fP"
B: box dotted ht h "\f(CW1\fP"
C: box dotted ht h "\f(CW2\fP"
D: box dotted ht h "\f(CW3\fP"
E: box dotted ht h "\f(CW4\fP"
F: box dotted ht h "\f(CW5\fP"
box ht h * 6 at C.s
A1: box dotted at A+(dw*1.6,0) ht h "\f(CW6\fP"
B1: box dotted ht h "\f(CW7\fP"
C1: box dotted ht h "\f(CW8\fP"
D1: box dotted ht h "\f(CW9\fP"
box ht h * 4 at C1.n
A2: box dotted at A1+(dw*1.6,0) "\f(CW10\fP"
F2: box dotted ht h "\f(CW11\fP"
box ht h * 2 at A2.s
A3: box dotted at A2+(dw*1.6,0) ht h "\f(CW12\fP"
B3: box dotted ht h "\f(CW13\fP"
C3: box dotted ht h "\f(CW14\fP"
D3: box dotted ht h "\f(CW15\fP"
E3: box dotted ht h "\f(CW16\fP"
F3: box dotted ht h "\f(CW17\fP"
box ht h * 6 at C3.s
.\" "Offset" at ORIG.n+(0,.2i)
"Disk 1" at A.n+(0,.2i)
"Disk 2" at A1.n+(0,.2i)
"Disk 3" at A2.n+(0,.2i)
"Disk 4" at A3.n+(0,.2i)
.\" arrow from A.e+(-.07,-.04) to B.e+(-.07,.02)
.\" arrow from B.e+(-.07,-.04) to C.e+(-.07,.02)
.\" arrow from C.e+(-.07,-.04) to D.e+(-.07,.02)
.\" arrow from D.e+(-.07,-.04) to E.e+(-.07,.02)
.\" arrow from E.e+(-.07,-.04) to F.e+(-.07,.02)
.\" line from F.e right .1i; arc radius .1i; line to A1.w-(.3i,.1i); arc cw radius .1i; arrow to A1.w
.\" arrow from A1.e+(-.07,-.04) to B1.e+(-.07,.02)
.\" arrow from B1.e+(-.07,-.04) to C1.e+(-.07,.02)
.\" arrow from C1.e+(-.07,-.04) to D1.e+(-.07,.02)
.\" line from D1.e right .1i; arc radius .1i; line to A2.w-(.3i,.1i); arc cw radius .1i; arrow to A2.w
.\" arrow from A2.e+(-.07,-.04) to F2.e+(-.07,.02)
.\" line from F2.e right .1i; arc radius .1i; line to A3.w-(.3i,.1i); arc cw radius .1i; arrow to A3.w
.\" arrow from A3.e+(-.07,-.04) to B3.e+(-.07,.02)
.\" arrow from B3.e+(-.07,-.04) to C3.e+(-.07,.02)
.\" arrow from C3.e+(-.07,-.04) to D3.e+(-.07,.02)
.\" arrow from D3.e+(-.07,-.04) to E3.e+(-.07,.02)
.\" arrow from E3.e+(-.07,-.04) to F3.e+(-.07,.02)
]
]
.PE

25
share/images/articles/vinum/vinum-mirrored-vol.pic Normal file
View file

@ -0,0 +1,25 @@
.\" $FreeBSD$
.PS
move right 1i
T: ellipse ht .3i wid 4i
line from T.e down 4i
line from T.w down 4i
B: arc rad 10i to T.e+(0,-4)
P1: S1: box ht 3i wid 1i "Subdisk 1" above "\s-2\f(CWmirror.p0.s0\fP\s0" below with .c at T.c+(-1,-2)
"Plex 1" at S1.s+(0,-.3)
move down .17i; "\s-2\f(CWmirror.p0\fP\s0"
P2: S3: box ht 3i wid 1i "Subdisk 2" above "\s-2\f(CWmirror.p1.s0\fP\s0" below with .c at T.c+(1,-2)
"Plex 2" at S3.s+(0,-.3)
move down .17i; "\s-2\f(CWmirror.p1\fP\s0"
"\s-2\&0 MB\s0" at S1.ne+(.5,0)
"\s-2\&512 MB\s0" at S1.se+(.5,0)
A: arrow from S1.ne+(.1,0) to S1.se+(.1,0)
arrow from S1.se+(.1,0) to S1.ne+(.1,0)
"\s-2volume" ljust at A.n+(.1,-.63)
"address" ljust at A.n+(.1,-.8)
"space\s0" ljust at A.n+(.1,-.97)
.PE

108
share/images/articles/vinum/vinum-raid10-vol.pic Normal file
View file

@ -0,0 +1,108 @@
.\" $FreeBSD$
.PS
move right 1i
T: ellipse ht .3i wid 4i
line from T.e down 4i
line from T.w down 4i
B: arc rad 10i to T.e+(0,-4)
P1: S1: box ht .6i wid 1i with .c at T.w+(1.3,-0.825)
S2: box ht .6i wid 1i
S3: box ht .6i wid 1i
S4: box ht .6i wid 1i
S5: box ht .6i wid 1i
"Plex 1" at S5.s+(0,-.3)
move down .17i; "\s-2\f(CWstriped.p0\fP\s0"
P1: S11: box ht .6i wid 1i with .c at T.w+(3.3,-0.825)
S12: box ht .6i wid 1i
S13: box ht .6i wid 1i
S14: box ht .6i wid 1i
S15: box ht .6i wid 1i
"Plex 2" at S15.s+(0,-.3)
move down .17i; "\s-2\f(CWstriped.p1\fP\s0"
"\f(CW\s-2.p0.s0\fP\s0" at S1.w-(.2,0) rjust
"\f(CW\s-2.p0.s1\fP\s0" at S2.w-(.2,0) rjust
"\f(CW\s-2.p0.s2\fP\s0" at S3.w-(.2,0) rjust
"\f(CW\s-2.p0.s3\fP\s0" at S4.w-(.2,0) rjust
"\f(CW\s-2.p0.s4\fP\s0" at S5.w-(.2,0) rjust
"\f(CW\s-2.p1.s0\fP\s0" at S11.w-(.2,0) rjust
"\f(CW\s-2.p1.s1\fP\s0" at S12.w-(.2,0) rjust
"\f(CW\s-2.p1.s2\fP\s0" at S13.w-(.2,0) rjust
"\f(CW\s-2.p1.s3\fP\s0" at S14.w-(.2,0) rjust
"\f(CW\s-2.p1.s4\fP\s0" at S15.w-(.2,0) rjust
.\" Stripes
box filled .1 wid 1i ht .1i at S1.n+(0, -.05)
box filled .2 wid 1i ht .1i at S1.n+(0, -.15)
box filled .3 wid 1i ht .1i at S1.n+(0, -.25)
box filled .4 wid 1i ht .1i at S1.n+(0, -.35)
box filled .5 wid 1i ht .1i at S1.n+(0, -.45)
box filled .6 wid 1i ht .1i at S1.n+(0, -.55)
box filled .1 wid 1i ht .1i at S2.n+(0, -.05)
box filled .2 wid 1i ht .1i at S2.n+(0, -.15)
box filled .3 wid 1i ht .1i at S2.n+(0, -.25)
box filled .4 wid 1i ht .1i at S2.n+(0, -.35)
box filled .5 wid 1i ht .1i at S2.n+(0, -.45)
box filled .6 wid 1i ht .1i at S2.n+(0, -.55)
box filled .1 wid 1i ht .1i at S3.n+(0, -.05)
box filled .2 wid 1i ht .1i at S3.n+(0, -.15)
box filled .3 wid 1i ht .1i at S3.n+(0, -.25)
box filled .4 wid 1i ht .1i at S3.n+(0, -.35)
box filled .5 wid 1i ht .1i at S3.n+(0, -.45)
box filled .6 wid 1i ht .1i at S3.n+(0, -.55)
box filled .1 wid 1i ht .1i at S4.n+(0, -.05)
box filled .2 wid 1i ht .1i at S4.n+(0, -.15)
box filled .3 wid 1i ht .1i at S4.n+(0, -.25)
box filled .4 wid 1i ht .1i at S4.n+(0, -.35)
box filled .5 wid 1i ht .1i at S4.n+(0, -.45)
box filled .6 wid 1i ht .1i at S4.n+(0, -.55)
box filled .1 wid 1i ht .1i at S5.n+(0, -.05)
box filled .2 wid 1i ht .1i at S5.n+(0, -.15)
box filled .3 wid 1i ht .1i at S5.n+(0, -.25)
box filled .4 wid 1i ht .1i at S5.n+(0, -.35)
box filled .5 wid 1i ht .1i at S5.n+(0, -.45)
box filled .6 wid 1i ht .1i at S5.n+(0, -.55)
box filled .1 wid 1i ht .1i at S11.n+(0, -.05)
box filled .2 wid 1i ht .1i at S11.n+(0, -.15)
box filled .3 wid 1i ht .1i at S11.n+(0, -.25)
box filled .4 wid 1i ht .1i at S11.n+(0, -.35)
box filled .5 wid 1i ht .1i at S11.n+(0, -.45)
box filled .6 wid 1i ht .1i at S11.n+(0, -.55)
box filled .1 wid 1i ht .1i at S12.n+(0, -.05)
box filled .2 wid 1i ht .1i at S12.n+(0, -.15)
box filled .3 wid 1i ht .1i at S12.n+(0, -.25)
box filled .4 wid 1i ht .1i at S12.n+(0, -.35)
box filled .5 wid 1i ht .1i at S12.n+(0, -.45)
box filled .6 wid 1i ht .1i at S12.n+(0, -.55)
box filled .1 wid 1i ht .1i at S13.n+(0, -.05)
box filled .2 wid 1i ht .1i at S13.n+(0, -.15)
box filled .3 wid 1i ht .1i at S13.n+(0, -.25)
box filled .4 wid 1i ht .1i at S13.n+(0, -.35)
box filled .5 wid 1i ht .1i at S13.n+(0, -.45)
box filled .6 wid 1i ht .1i at S13.n+(0, -.55)
box filled .1 wid 1i ht .1i at S14.n+(0, -.05)
box filled .2 wid 1i ht .1i at S14.n+(0, -.15)
box filled .3 wid 1i ht .1i at S14.n+(0, -.25)
box filled .4 wid 1i ht .1i at S14.n+(0, -.35)
box filled .5 wid 1i ht .1i at S14.n+(0, -.45)
box filled .6 wid 1i ht .1i at S14.n+(0, -.55)
box filled .1 wid 1i ht .1i at S15.n+(0, -.05)
box filled .2 wid 1i ht .1i at S15.n+(0, -.15)
box filled .3 wid 1i ht .1i at S15.n+(0, -.25)
box filled .4 wid 1i ht .1i at S15.n+(0, -.35)
box filled .5 wid 1i ht .1i at S15.n+(0, -.45)
box filled .6 wid 1i ht .1i at S15.n+(0, -.55)
.PE

84
share/images/articles/vinum/vinum-raid5-org.pic Normal file
View file

@ -0,0 +1,84 @@
.\" $FreeBSD$
.PS
h = .3i
dh = .02i
dw = .8i
down
[
[
boxht = h; boxwid = dw
.\" ORIG: box invis "\f(CW0\fP"
.\" box invis "\f(CW1\fP"
.\" box invis "\f(CW2\fP"
.\" box invis "\f(CW3\fP"
.\" box invis "\f(CW4\fP"
.\" box invis "\f(CW5\fP"
.\"
.\"
move right 1i; down
A: box ht h "\f(CW0\fP"
B: box ht h "\f(CW3\fP"
C: box ht h "\f(CW6\fP"
D: box ht h "Parity" filled 0.2
E: box ht h "\f(CW12\fP"
F: box ht h "\f(CW15\fP"
A1: box at A+(dw*1.6,0) ht h "\f(CW1\fP"
B1: box ht h "\f(CW4\fP"
C1: box ht h "Parity" filled 0.2
D1: box ht h "\f(CW9\fP"
E1: box ht h "\f(CW13\fP"
F1: box ht h "\f(CW16\fP"
A2: box at A1+(dw*1.6,0) ht h "\f(CW2\fP"
B2: box ht h "Parity" filled 0.2
C2: box ht h "\f(CW7\fP"
D2: box ht h "\f(CW10\fP"
E2: box ht h "\f(CW14\fP"
F2: box ht h "Parity" filled 0.2
A3: box at A2+(dw*1.6,0) ht h "Parity" filled 0.2
B3: box ht h "\f(CW5\fP"
C3: box ht h "\f(CW8\fP"
D3: box ht h "\f(CW11\fP"
E3: box ht h "Parity" filled 0.2
F3: box ht h "\f(CW17\fP"
.\" "Offset" at ORIG.n+(0,.2i)
"Disk 1" at A.n+(0,.2i)
"Disk 2" at A1.n+(0,.2i)
"Disk 3" at A2.n+(0,.2i)
"Disk 4" at A3.n+(0,.2i)
.\" arrow from A.e to A1.w
.\" arrow from B.e to B1.w
.\" arrow from C.e to C1.w
.\" arrow from D.e to D1.w
.\" arrow from E.e to E1.w
.\" arrow from F.e to F1.w
.\"
.\" arrow from A1.e to A2.w
.\" arrow from B1.e to B2.w
.\" arrow from C1.e to C2.w
.\" arrow from D1.e to D2.w
.\" arrow from E1.e to E2.w
.\" arrow from F1.e to F2.w
.\"
.\" arrow from A2.e to A3.w
.\" arrow from B2.e to B3.w
.\" arrow from C2.e to C3.w
.\" arrow from D2.e to D3.w
.\" arrow from E2.e to E3.w
.\" arrow from F2.e to F3.w
.\"
.\" arrow right .2i from A3.e
.\" arrow right .2i from B3.e
.\" arrow right .2i from C3.e
.\" arrow right .2i from D3.e
.\" arrow right .2i from E3.e
.\" arrow right .2i from F3.e
]
]
.PE
.Figure-heading "RAID-5 organization"

21
share/images/articles/vinum/vinum-simple-vol.pic Normal file
View file

@ -0,0 +1,21 @@
.\" $FreeBSD$
.PS
move right 1i
T: ellipse ht .3i wid 4i
line from T.e down 4i
line from T.w down 4i
B: arc rad 10i to T.e+(0,-4)
P1: S1: box ht 3i wid 1i "Subdisk" above "\s-2\f(CWmyvol.p0.s0\fP\s0" below with .c at T.w+(2,-1.95)
"Plex 1" at S1.s+(0,-.3)
move down .17i; "\s-2\f(CWmyvol.p0\fP\s0"
"\s-2\&0 MB\s0" at S1.ne+(.5,0)
"\s-2\&512 MB\s0" at S1.se+(.5,0)
A: arrow from S1.ne+(.1,0) to S1.se+(.1,0)
"\s-2volume" ljust at A.n+(.1,-.63)
"address" ljust at A.n+(.1,-.8)
"space\s0" ljust at A.n+(.1,-.97)
.PE

62
share/images/articles/vinum/vinum-striped-vol.pic Normal file
View file

@ -0,0 +1,62 @@
.\" $FreeBSD$
.PS
move right 1i
T: ellipse ht .3i wid 4i
line from T.e down 4i
line from T.w down 4i
B: arc rad 10i to T.e+(0,-4)
P1: S1: box ht .7i wid 1i with .c at T.w+(2,-0.825)
S2: box ht .7i wid 1i
S3: box ht .7i wid 1i
S4: box ht .7i wid 1i
"Plex 1" at S4.s+(0,-.3)
move down .17i; "\s-2\f(CWstriped.p0\fP\s0"
"\s-2\&0 MB\s0" at S1.ne+(.5,0)
"\s-2\&512 MB\s0" at S4.se+(.5,0)
A: arrow from S1.ne+(.1,0) to S4.se+(.1,0)
"\s-2volume" ljust at A.n+(.1,-.63)
"address" ljust at A.n+(.1,-.8)
"space\s0" ljust at A.n+(.1,-.97)
"\f(CW\s-2striped.p0.s0\fP\s0" at S1.w-(.2,0) rjust
"\f(CW\s-2striped.p0.s1\fP\s0" at S2.w-(.2,0) rjust
"\f(CW\s-2striped.p0.s2\fP\s0" at S3.w-(.2,0) rjust
"\f(CW\s-2striped.p0.s3\fP\s0" at S4.w-(.2,0) rjust
.\" Stripes
box filled .1 wid 1i ht .1i at S1.n+(0, -.05)
box filled .2 wid 1i ht .1i at S1.n+(0, -.15)
box filled .3 wid 1i ht .1i at S1.n+(0, -.25)
box filled .4 wid 1i ht .1i at S1.n+(0, -.35)
box filled .5 wid 1i ht .1i at S1.n+(0, -.45)
box filled .6 wid 1i ht .1i at S1.n+(0, -.55)
box filled .7 wid 1i ht .1i at S1.n+(0, -.65)
box filled .1 wid 1i ht .1i at S2.n+(0, -.05)
box filled .2 wid 1i ht .1i at S2.n+(0, -.15)
box filled .3 wid 1i ht .1i at S2.n+(0, -.25)
box filled .4 wid 1i ht .1i at S2.n+(0, -.35)
box filled .5 wid 1i ht .1i at S2.n+(0, -.45)
box filled .6 wid 1i ht .1i at S2.n+(0, -.55)
box filled .7 wid 1i ht .1i at S2.n+(0, -.65)
box filled .1 wid 1i ht .1i at S3.n+(0, -.05)
box filled .2 wid 1i ht .1i at S3.n+(0, -.15)
box filled .3 wid 1i ht .1i at S3.n+(0, -.25)
box filled .4 wid 1i ht .1i at S3.n+(0, -.35)
box filled .5 wid 1i ht .1i at S3.n+(0, -.45)
box filled .6 wid 1i ht .1i at S3.n+(0, -.55)
box filled .7 wid 1i ht .1i at S3.n+(0, -.65)
box filled .1 wid 1i ht .1i at S4.n+(0, -.05)
box filled .2 wid 1i ht .1i at S4.n+(0, -.15)
box filled .3 wid 1i ht .1i at S4.n+(0, -.25)
box filled .4 wid 1i ht .1i at S4.n+(0, -.35)
box filled .5 wid 1i ht .1i at S4.n+(0, -.45)
box filled .6 wid 1i ht .1i at S4.n+(0, -.55)
box filled .7 wid 1i ht .1i at S4.n+(0, -.65)
.PE

84
share/images/articles/vinum/vinum-striped.pic Normal file
View file

@ -0,0 +1,84 @@
.\" $FreeBSD$
.PS
h = .3i
dh = .02i
dw = .8i
down
[
[
boxht = h; boxwid = dw
.\" ORIG: box invis "\f(CW0\fP"
.\" box invis "\f(CW1\fP"
.\" box invis "\f(CW2\fP"
.\" box invis "\f(CW3\fP"
.\" box invis "\f(CW4\fP"
.\" box invis "\f(CW5\fP"
.\"
.\" A: box at ORIG.e+(.4,0) ht h "\f(CW0\fP"
move right 1i; down
A: box ht h "\f(CW0\fP"
B: box ht h "\f(CW4\fP"
C: box ht h "\f(CW8\fP"
D: box ht h "\f(CW12\fP"
E: box ht h "\f(CW16\fP"
F: box ht h "\f(CW20\fP"
A1: box at A+(dw*1.6,0) ht h "\f(CW1\fP"
B1: box ht h "\f(CW5\fP"
C1: box ht h "\f(CW9\fP"
D1: box ht h "\f(CW13\fP"
E1: box ht h "\f(CW17\fP"
F1: box ht h "\f(CW21\fP"
A2: box at A1+(dw*1.6,0) ht h "\f(CW2\fP"
B2: box ht h "\f(CW6\fP"
C2: box ht h "\f(CW10\fP"
D2: box ht h "\f(CW14\fP"
E2: box ht h "\f(CW18\fP"
F2: box ht h "\f(CW22\fP"
A3: box at A2+(dw*1.6,0) ht h "\f(CW3\fP"
B3: box ht h "\f(CW7\fP"
C3: box ht h "\f(CW11\fP"
D3: box ht h "\f(CW15\fP"
E3: box ht h "\f(CW19\fP"
F3: box ht h "\f(CW23\fP"
.\" "Offset" at ORIG.n+(0,.2i)
"Disk 1" at A.n+(0,.2i)
"Disk 2" at A1.n+(0,.2i)
"Disk 3" at A2.n+(0,.2i)
"Disk 4" at A3.n+(0,.2i)
.\"
.\" arrow from A.e to A1.w
.\" arrow from B.e to B1.w
.\" arrow from C.e to C1.w
.\" arrow from D.e to D1.w
.\" arrow from E.e to E1.w
.\" arrow from F.e to F1.w
.\"
.\" arrow from A1.e to A2.w
.\" arrow from B1.e to B2.w
.\" arrow from C1.e to C2.w
.\" arrow from D1.e to D2.w
.\" arrow from E1.e to E2.w
.\" arrow from F1.e to F2.w
.\"
.\" arrow from A2.e to A3.w
.\" arrow from B2.e to B3.w
.\" arrow from C2.e to C3.w
.\" arrow from D2.e to D3.w
.\" arrow from E2.e to E3.w
.\" arrow from F2.e to F3.w
.\"
.\" arrow right .2i from A3.e
.\" arrow right .2i from B3.e
.\" arrow right .2i from C3.e
.\" arrow right .2i from D3.e
.\" arrow right .2i from E3.e
.\" arrow right .2i from F3.e
]
]
.PE