← Back to branch summary

~brightbox/bird/bird-packaging

« back to all changes in this revision

Viewing changes to doc/bird-6.html

  • Committer: Ondřej Surý
  • Date: 2011-09-12 06:59:16 UTC
  • mfrom: (1.1.23)
  • Revision ID: git-v1:da868fd891ce15438ca516573979a5df54601e5a
Merge commit 'upstream/1.3.3' into debian-sid

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/bird-6.html
52
52
MD5 password authentication
53
53
(RFC 2385
54
54
<A HREF="ftp://ftp.rfc-editor.org/in-notes/rfc2385.txt">ftp://ftp.rfc-editor.org/in-notes/rfc2385.txt</A>),
 
55
extended communities
 
56
(RFC 4360
 
57
<A HREF="ftp://ftp.rfc-editor.org/in-notes/rfc4360.txt">ftp://ftp.rfc-editor.org/in-notes/rfc4360.txt</A>),
55
58
route reflectors 
56
59
(RFC 4456
57
60
<A HREF="ftp://ftp.rfc-editor.org/in-notes/rfc4456.txt">ftp://ftp.rfc-editor.org/in-notes/rfc4456.txt</A>),
58
61
multiprotocol extensions
59
62
(RFC 4760
60
63
<A HREF="ftp://ftp.rfc-editor.org/in-notes/rfc4760.txt">ftp://ftp.rfc-editor.org/in-notes/rfc4760.txt</A>),
61
 
and 4B AS numbers 
 
64
4B AS numbers 
62
65
(RFC 4893
63
 
<A HREF="ftp://ftp.rfc-editor.org/in-notes/rfc4893.txt">ftp://ftp.rfc-editor.org/in-notes/rfc4893.txt</A>).
 
66
<A HREF="ftp://ftp.rfc-editor.org/in-notes/rfc4893.txt">ftp://ftp.rfc-editor.org/in-notes/rfc4893.txt</A>),
 
67
and 4B AS numbers in extended communities
 
68
(RFC 5668
 
69
<A HREF="ftp://ftp.rfc-editor.org/in-notes/rfc5668.txt">ftp://ftp.rfc-editor.org/in-notes/rfc5668.txt</A>).
64
70
<P>
65
71
<P>For IPv6, it uses the standard multiprotocol extensions defined in
66
72
RFC 2283
131
137
subnets. Such IP address have to be reachable through system
132
138
routing table. For multihop BGP it is recommended to
133
139
explicitly configure <CODE>source address</CODE> to have it
134
 
stable. Optional <CODE>number</CODE> argument can be used to limit TTL
135
 
(the number of hops).
136
 
Default: switched off.
 
140
stable. Optional <CODE>number</CODE> argument can be used to specify
 
141
the number of hops (used for TTL). Note that the number of
 
142
networks (edges) in a path is counted, i.e. if two BGP
 
143
speakers are separated by one router, the number of hops is
 
144
2. Default: switched off.
137
145
<P>
138
146
<DT><CODE>source address <I>ip</I></CODE><DD><P>Define local address we
139
147
should use for next hop calculation and as a source address
180
188
as an IGP routing table. Default: the same as the table BGP is
181
189
connected to.
182
190
<P>
 
191
<DT><CODE>ttl security <I>switch</I></CODE><DD><P>Use GTSM (RFC 5082 - the
 
192
generalized TTL security mechanism). GTSM protects against
 
193
spoofed packets by ignoring received packets with a smaller
 
194
than expected TTL. To work properly, GTSM have to be enabled
 
195
on both sides of a BGP session. If both <CODE>ttl security</CODE> and
 
196
<CODE>multihop</CODE> options are enabled, <CODE>multihop</CODE> option should
 
197
specify proper hop value to compute expected TTL. Kernel
 
198
support required: Linux: 2.6.34+ (IPv4), 2.6.35+ (IPv6), BSD:
 
199
since long ago, IPv4 only. Note that full (ICMP protection,
 
200
for example) RFC 5082 support is provided by Linux
 
201
only. Default: disabled.
 
202
<P>
183
203
<DT><CODE>password <I>string</I></CODE><DD><P>Use this password for MD5 authentication
184
204
of BGP sessions. Default: no authentication. Password has to be set by
185
205
external utility (e.g. setkey(8)) on BSD systems.
373
393
its own routing policy, it also has a complete freedom about which community
374
394
attributes it defines and what will their semantics be.
375
395
<P>
 
396
<DT><CODE>eclist <CODE>bgp_ext_community</CODE> [O]</CODE><DD><P>List of extended community
 
397
values associated with the route. Extended communities have similar usage
 
398
as plain communities, but they have an extended range (to allow 4B ASNs)
 
399
and a nontrivial structure with a type field. Individual community values are
 
400
represented using an <CODE>ec</CODE> data type inside the filters.
 
401
<P>
376
402
<DT><CODE>quad <CODE>bgp_originator_id</CODE> [I, O]</CODE><DD><P>This attribute is created by the
377
403
route reflector when reflecting the route and contains the router ID of the
378
404
originator of the route in the local AS.
665
691
        tick &lt;num&gt;;
666
692
        ecmp &lt;switch&gt; [limit &lt;num&gt;];
667
693
        area &lt;id&gt; {
668
 
                stub cost &lt;num&gt;;
 
694
                stub;
 
695
                nssa;
 
696
                summary &lt;switch&gt;;
 
697
                default nssa &lt;switch&gt;;
 
698
                default cost &lt;num&gt;;
 
699
                default cost2 &lt;num&gt;;
 
700
                translator &lt;switch&gt;;
 
701
                translator stability &lt;num&gt;;
 
702
 
669
703
                networks {
670
704
                        &lt;prefix&gt;;
671
705
                        &lt;prefix&gt; hidden;
672
706
                }
 
707
                external {
 
708
                        &lt;prefix&gt;;
 
709
                        &lt;prefix&gt; hidden;
 
710
                        &lt;prefix&gt; tag &lt;num&gt;;
 
711
                }
673
712
                stubnet &lt;prefix&gt;;
674
713
                stubnet &lt;prefix&gt; {
675
714
                        hidden &lt;switch&gt;;
743
782
address, similarly to a router ID). The most important area is
744
783
the backbone (ID 0) to which every other area must be connected.
745
784
<P>
746
 
<DT><CODE>stub cost <I>num</I></CODE><DD><P>No external (except default) routes are flooded into stub areas.
747
 
Setting this value marks area stub with defined cost of default route.
748
 
Default value is no. (Area is not stub.)
 
785
<DT><CODE>stub</CODE><DD><P>This option configures the area to be a stub area. External
 
786
routes are not flooded into stub areas. Also summary LSAs can be
 
787
limited in stub areas (see option <CODE>summary</CODE>).
 
788
By default, the area is not a stub area.
 
789
<P>
 
790
<DT><CODE>nssa</CODE><DD><P>This option configures the area to be a NSSA (Not-So-Stubby
 
791
Area). NSSA is a variant of a stub area which allows a
 
792
limited way of external route propagation. Global external
 
793
routes are not propagated into a NSSA, but an external route
 
794
can be imported into NSSA as a (area-wide) NSSA-LSA (and
 
795
possibly translated and/or aggregated on area boundary).
 
796
By default, the area is not NSSA.
 
797
<P>
 
798
<DT><CODE>summary <I>switch</I></CODE><DD><P>This option controls propagation of summary LSAs into stub or
 
799
NSSA areas. If enabled, summary LSAs are propagated as usual,
 
800
otherwise just the default summary route (0.0.0.0/0) is
 
801
propagated (this is sometimes called totally stubby area). If
 
802
a stub area has more area boundary routers, propagating
 
803
summary LSAs could lead to more efficient routing at the cost
 
804
of larger link state database. Default value is no.
 
805
<P>
 
806
<DT><CODE>default nssa <I>switch</I></CODE><DD><P>When <CODE>summary</CODE> option is enabled, default summary route is
 
807
no longer propagated to the NSSA. In that case, this option
 
808
allows to originate default route as NSSA-LSA to the NSSA.
 
809
Default value is no.
 
810
<P>
 
811
<DT><CODE>default cost <I>num</I></CODE><DD><P>This option controls the cost of a default route propagated to
 
812
stub and NSSA areas. Default value is 1000.
 
813
<P>
 
814
<DT><CODE>default cost2 <I>num</I></CODE><DD><P>When a default route is originated as NSSA-LSA, its cost
 
815
can use either type 1 or type 2 metric. This option allows
 
816
to specify the cost of a default route in type 2 metric.
 
817
By default, type 1 metric (option <CODE>default cost</CODE>) is used.
 
818
<P>
 
819
<DT><CODE>translator <I>switch</I></CODE><DD><P>This option controls translation of NSSA-LSAs into external
 
820
LSAs. By default, one translator per NSSA is automatically
 
821
elected from area boundary routers. If enabled, this area
 
822
boundary router would unconditionally translate all NSSA-LSAs
 
823
regardless of translator election. Default value is no.
 
824
<P>
 
825
<DT><CODE>translator stability <I>num</I></CODE><DD><P>This option controls the translator stability interval (in
 
826
seconds). When the new translator is elected, the old one
 
827
keeps translating until the interval is over. Default value
 
828
is 40.
749
829
<P>
750
830
<DT><CODE>networks { <I>set</I> }</CODE><DD><P>Definition of area IP ranges. This is used in summary LSA origination.
751
831
Hidden networks are not propagated into other areas.
752
832
<P>
 
833
<DT><CODE>external { <I>set</I> }</CODE><DD><P>Definition of external area IP ranges for NSSAs. This is used
 
834
for NSSA-LSA translation. Hidden networks are not translated
 
835
into external LSAs. Networks can have configured route tag.
 
836
<P>
753
837
<DT><CODE>stubnet <I>prefix</I> { <I>options</I> }</CODE><DD><P>Stub networks are networks that are not transit networks
754
838
between OSPF routers. They are also propagated through an
755
839
OSPF area as a part of a link state database. By default,