ifconfig.if(5) documentation

["Thomas Edward Spanjaard" <t.e.spanjaard@xxxxxxxxxxxxxxxxxx>]

I noticed lack of documentation on ifconfig.if(5) (see /etc/rc.d/network), 
so here are patches. This isn't something I do often, so bear with me :). 
Comments wanted.

cheers,
        -- Thomas E. Spanjaard 


begin 666 ifconfig.if.5.patch
M/3T]('-H87)E+VUA;B]M86XU+VEF8V]N9FEG+FEF+C4-"CT]/3T]/3T]/3T]
M/3T]/3T]/3T]/3T]/3T]/3T]/3T]/3T]/3T]/3T]/3T]/3T]/3T]/3T]/3T]
M/3T]/3T]/3T]/0HM+2T@<VAA<F4O;6%N+VUA;C4O:69C;VYF:6<N:68N-0HK
M*RL@<VAA<F4O;6%N+VUA;C4O:69C;VYF:6<N:68N-0I 0" M,"PP("LQ+#$Q
M,"! 0 HK+EPB"21.971"4T0Z(&EF8V]N9FEG+FEF+C4L=B Q+C<@,C P,B\Q
M,"\Q,R P,#HT-CHU.2!W:7H@17AP("0**RY<(@HK+EPB($-O<'ER:6=H=" H
M8RD@,3DY-B!-871T:&5W(%(N($=R965N"BLN7"(@06QL(')I9VAT<R!R97-E
M<G9E9"X**RY<(@HK+EPB(%)E9&ES=')I8G5T:6]N(&%N9"!U<V4@:6X@<V]U
M<F-E(&%N9"!B:6YA<GD@9F]R;7,L('=I=&@@;W(@=VET:&]U= HK+EPB(&UO
M9&EF:6-A=&EO;BP@87)E('!E<FUI='1E9"!P<F]V:61E9"!T:&%T('1H92!F
M;VQL;W=I;F<@8V]N9&ET:6]N<PHK+EPB(&%R92!M970Z"BLN7"(@,2X@4F5D
M:7-T<FEB=71I;VYS(&]F('-O=7)C92!C;V1E(&UU<W0@<F5T86EN('1H92!A
M8F]V92!C;W!Y<FEG:'0**RY<(B @("!N;W1I8V4L('1H:7,@;&ES="!O9B!C
M;VYD:71I;VYS(&%N9"!T:&4@9F]L;&]W:6YG(&1I<V-L86EM97(N"BLN7"(@
M,BX@4F5D:7-T<FEB=71I;VYS(&EN(&)I;F%R>2!F;W)M(&UU<W0@<F5P<F]D
M=6-E('1H92!A8F]V92!C;W!Y<FEG:'0**RY<(B @("!N;W1I8V4L('1H:7,@
M;&ES="!O9B!C;VYD:71I;VYS(&%N9"!T:&4@9F]L;&]W:6YG(&1I<V-L86EM
M97(@:6X@=&AE"BLN7"(@(" @9&]C=6UE;G1A=&EO;B!A;F0O;W(@;W1H97(@
M;6%T97)I86QS('!R;W9I9&5D('=I=&@@=&AE(&1I<W1R:6)U=&EO;BX**RY<
M(B S+B!4:&4@;F%M92!O9B!T:&4@875T:&]R(&UA>2!N;W0@8F4@=7-E9"!T
M;R!E;F1O<G-E(&]R('!R;VUO=&4@<')O9'5C=',**RY<(B @("!D97)I=F5D
M(&9R;VT@=&AI<R!S;V9T=V%R92!W:71H;W5T('-P96-I9FEC('!R:6]R('=R
M:71T96X@<&5R;6ES<VEO;BX**RY<(@HK+EPB(%1(25,@4T]&5%=!4D4@25,@
M4%)/5DE$140@0ED@5$A%($%55$A/4B!@8$%3($E3)R<@04Y$($%.62!%6%!2
M15-3($]2"BLN7"(@24U03$E%1"!705)204Y42453+"!)3D-,541)3D<L($)5
M5"!.3U0@3$E-251%1"!43RP@5$A%($E-4$Q)140@5T%24D%.5$E%4PHK+EPB
M($]&($U%4D-(04Y404))3$E462!!3D0@1DE43D534R!&3U(@02!005)424-5
M3$%2(%!54E!/4T4@05)%($1)4T-,04E-140N"BLN7"(@24X@3D\@159%3E0@
M4TA!3$P@5$A%($%55$A/4B!"12!,24%"3$4@1D]2($%.62!$25)%0U0L($E.
M1$E214-4+ HK+EPB($E.0TE$14Y404PL(%-014-)04PL($5814U03$%262P@
M3U(@0T].4T51545.5$E!3"!$04U!1T53("A)3D-,541)3D<L"BLN7"(@0E54
M($Y/5"!,24U)5$5$(%1/+"!04D]#55)%345.5"!/1B!354)35$E4551%($=/
M3T13($]2(%-%4E9)0T53.PHK+EPB($Q/4U,@3T8@55-%+"!$051!+"!/4B!0
M4D]&2513.R!/4B!"55-)3D534R!)3E1%4E)54%1)3TXI($A/5T5615(@0T%5
M4T5$"BLN7"(@04Y$($].($%.62!42$5/4ED@3T8@3$E!0DE,2519+"!72$54
M2$52($E.($-/3E1204-4+"!35%))0U0@3$E!0DE,2519+ HK+EPB($]2(%1/
M4E0@*$E.0TQ51$E.1R!.14=,24=%3D-%($]2($]42$525TE312D@05))4TE.
M1R!)3B!!3ED@5T%9"BLN7"(@3U54($]&(%1(12!54T4@3T8@5$A)4R!33T94
M5T%212P@159%3B!)1B!!1%9)4T5$($]&(%1(12!03U-324))3$E462!/1@HK
M+EPB(%-50T@@1$%-04=%+@HK+EPB"BLN1&0@1F5B<G5A<GD@.2P@,C P-0HK
M+D1T($E&0T].1DE'+DE&(#4**RY/<PHK+E-H($Y!344**RY.;2!I9F-O;F9I
M9RYI9@HK+DYD(&EN=&5R9F%C92US<&5C:69I8R!C;VYF:6=U<F%T:6]N(&9I
M;&5S"BLN4V@@1$530U))4%1)3TX**U1H90HK+DYM"BMF:6QE<R!C;VYT86EN
M(&EN9F]R;6%T:6]N(')E9V%R9&EN9R!T:&4@8V]N9FEG=7)A=&EO;B!O9B!E
M86-H(&YE='=O<FL@:6YT97)F86-E+@HK+DYM"BMI<R!P<F]C97-S960@8GD*
M*RY082 O971C+W)C+F0O;F5T=V]R:PHK870@<WES=&5M(&)O;W0@=&EM92X*
M*RY0< HK3VYE(&9I;&4@<VAO=6QD(&5X:7-T(&9O<B!E86-H(&EN=&5R9F%C
M92!T:&%T(&ES('1O(&)E(&-O;F9I9W5R960L('-U8V@@87,**RY082 O971C
M+VEF8V]N9FEG+F9X<# @+@HK5&AE(&9I;&4@=VEL;"!G970@979A;'5A=&5D
M(&]N;'D@:68@=&AE(&EN=&5R9F%C92!E>&ES=',@;VX@=&AE('-Y<W1E;2X*
M*TUU;'1I<&QE(&QI;F5S(&-A;B!B92!P;&%C960@:6X@82!F:6QE+"!A;F0@
M=VEL;"!B92!E=F%L=6%T960@<V5Q=65N=&EA;&QY+@HK+E!P"BM.;W)M86QL
M>2P@82!L:6YE('=I;&P@8F4@979A;'5A=&5D(&%S(&-O;6UA;F0@;&EN92!A
M<F=U;65N=',@=&\**RY8<B!I9F-O;F9I9R X("X**RY$<2!,:2!I9F-O;F9I
M9R!I9@HK=VEL;"!B92!P<F5P96YD960@;VX@979A;'5A=&EO;BX**RY0< HK
M268@82!L:6YE(&ES(&5M<'1Y+"!O<B!S=&%R=',@=VET: HK+E-Q(",@+ HK
M=&AE(&QI;F4@=VEL;"!B92!I9VYO<F5D(&%S(&-O;6UE;G0N"BLN4' **TEF
M(&$@;&EN92!S=&%R=',@=VET: HK+E-Q(%PF(2 L"BMT:&4@<F5S="!O9B!L
M:6YE('=I;&P@9V5T(&5V86QU871E9"!A<R!S:&5L;"!S8W)I<'0@9G)A9VUE
M;G0N"BM3:&5L;"!V87)I86)L97,@9&5C;&%R960@:6X**RY082 O971C+W)C
M+F0O;F5T=V]R:PHK87)E(&%C8V5S<VEB;&4N"BM4:&4@;6]S="!U<V5F=6P@
M=F%R:6%B;&4@:7,**RY,:2 D:6YT("P**V%S(&ET('=I;&P@8F4@8F]U;F0@
M=&\@=&AE(&EN=&5R9F%C92!B96EN9R!C;VYF:6=U<F5D('=I=&@@=&AE(&9I
M;&4N"BLN4' **T9O<B!E>&%M<&QE+"!T:&4@9F]L;&]W:6YG(&EL;'5S=')A
M=&5S('-T871I8R!I;G1E<F9A8V4@8V]N9FEG=7)A=&EO;CH**RY"9" M;&ET
M97)A;" M;V9F<V5T(&EN9&5N= HK(R!)4'8T+"!W:71H(&%N(&%L:6%S"BMI
M;F5T(#$P+C N,2XQ,B!N971M87-K(#(U-2XR-34N,C4U+C @;65D:6$@,3 P
M8F%S9518"BMI;F5T(#$P+C N,2XQ,R!N971M87-K(#(U-2XR-34N,C4U+C(U
M-2!A;&EA<PHK(R!L970@=7,@:&%V92!)4'8V(&%D9')E<W,@;VX@=&AI<R!I
M;G1E<F9A8V4**VEN970V(&9E8S Z.C$@<')E9FEX;&5N(#8T(&%L:6%S"BLC
M(&AA=F4@<W5B;F5T(')O=71E<B!A;GEC87-T(&%D9')E<W,@=&]O"BMI;F5T
M-B!F96,P.CH@<')E9FEX;&5N(#8T(&%L:6%S(&%N>6-A<W0**RY%9 HK+E!P
M"BM4:&4@9F]L;&]W:6YG(&EL;'5S=')A=&5S(&1Y;F%M:6,@8V]N9FEG=7)A
M=&EO;B!S971U<"!W:71H"BLN6'(@9&AC;&EE;G0@. HK86YD"BLN6'(@<G1S
M;VP@." Z"BLN0F0@+6QI=&5R86P@+6]F9G-E="!I;F1E;G0**W5P"BLC(&%U
M=&]C;VYF:6=U<F4@25!V-"!A9&1R97-S"BLA9&AC;&EE;G0@)&EN= HK(R!A
M=71O8V]N9FEG=7)E($E0=C8@861D<F5S<RX@($)E('-U<F4@=&\@<V5T("1I
M<#9M;V1E('1O(&%U=&]H;W-T+@HK(7)T<V]L("1I;G0**RY%9 HK+E!P"BM4
M:&4@9F]L;&]W:6YG(&5X86UP;&4@:7,@9F]R(&1Y;F%M:6-A;&QY+6-R96%T
M960@<'-E=61O(&EN=&5R9F%C97,@;&EK90HK+EAR(&=I9B T(#H**RY"9" M
M;&ET97)A;" M;V9F<V5T(&EN9&5N= HK=7 **R,@8V]N9FEG=7)E($E0=C8@
M9&5F875L="!R;W5T92!T;W=A<F0@=&AE(&EN=&5R9F%C90HK(7)O=71E(&%D
M9" M:6YE=#8@9&5F875L=" Z.C$**R%R;W5T92!C:&%N9V4@+6EN970V(&1E
M9F%U;'0@+6EF<" D:6YT"BLN160**RY0< HK16%R;&EE<B!V97)S:6]N<R!O
M9@HK+E!A("]E=&,O<F,N9"]N971W;W)K"BMR97%U:7)E9"!A;B!E>'!L:6-I
M= HK+E-Q(&-R96%T90HK8V]M;6%N9"!F;W(@<W5C:"!I;G1E<F9A8V5S+@HK
M5&AI<R!I<R!N;W<@:&%N9&QE9"!A=71O;6%T:6-A;&QY+@HK+E-H($9)3$53
M"BLN4&$@+V5T8R]R8RYD+VYE='=O<FL**RY3:"!3144@04Q33PHK+EAR(')C
M+F-O;F8@-2 L"BLN6'(@:69C;VYF:6<@. H*/3T]('-H87)E+VUA;B]M86XU
M+W)C+F-O;F8N-0T*/3T]/3T]/3T]/3T]/3T]/3T]/3T]/3T]/3T]/3T]/3T]
M/3T]/3T]/3T]/3T]/3T]/3T]/3T]/3T]/3T]/3T]/3T]"BTM+2!S:&%R92]M
M86XO;6%N-2]R8RYC;VYF+C4**RLK('-H87)E+VUA;B]M86XU+W)C+F-O;F8N
M-0I 0" M,C,L." K,C,L."! 0 H@+EPB(%-50T@@1$%-04=%+@H@+EPB"B N
M7"(@)$9R965"4T0Z('-R8R]S:&%R92]M86XO;6%N-2]R8RYC;VYF+C4L=B Q
M+C$Y-R R,# S+S W+S(X(#$S.C4V.C P(&UB<B!%>' @) HM+EPB("1$<F%G
M;VY&;'DD"BTN1&0@36%R8V@@,RP@,C P,@HK+EPB("1$<F%G;VY&;'DZ('-R
M8R]S:&%R92]M86XO;6%N-2]R8RYC;VYF+C4L=B Q+C@@,C P-2\P,2\Q,2 R
M,#HP,3HP-R!S=VEL9&YE<B!%>' @) HK+D1D($9E8G)U87)Y(#DL(#(P,#4*
M("Y$="!20RY#3TY&(#4*("Y/<PH@+E-H($Y!344*0$ @+3<S.2PV("LW,SDL
M,3@@0$ *("Y682!I9F-O;F9I9U\@3G,@06\@07(@:6YT97)F86-E($%C($YS
M(%9A(%]A;&EA<R!.<R!!<2!!<B!N"B!V87)I86)L97,N"B N4' **TEF('1H
M90HK+E!A("]E=&,O:69C;VYF:6<N($YS($%Q($%R(&EN=&5R9F%C90HK9FEL
M92!I<R!P<F5S96YT+"!I="!I<R!R96%D(&%N9"!E>&5C=71E9"!B>0HK+E!A
M("]E=&,O<F,N9"]N971W;W)K"BMR97!L86-I;F<@86YY"BLN5F$@:69C;VYF
M:6=?($YS($%Q($%R(&EN=&5R9F%C90HK;W(**RY682!I9F-O;F9I9U\@3G,@
M06\@07(@:6YT97)F86-E($%C($YS(%9A(%]A;&EA<R!!<2!!<B!N"BMV87)I
M86)L97,N($]N;'D@:6YT97)F86-E<R!S970@:6X**RY682!N971?:6YT97)F
M86-E<PHK87)E('!R;V-E<W-E9"X**RY0< H@270@:7,@<&]S<VEB;&4@=&\@
M8G)I;F<@=7 @86X@:6YT97)F86-E('=I=&@@1$A#4"!B>2!S971T:6YG('1H
M90H@+E9A(&EF8V]N9FEG7R!.<R!!<2!!<B!I;G1E<F9A8V4*('9A<FEA8FQE
$('1O"@``
`
end