1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156
|
From: Apollon Oikonomopoulos <apoikos@debian.org>
Date: Mon, 9 Jan 2023 21:34:07 +0200
Subject: Fix manpage errors
The manpage is using a couple of man macros while it's written with the mdoc
package. Replace .RS and .RE with .Rs and .Re respectively and format the SEE
ALSO section a bit better.
Forwarded: no
Last-Update: 2015-10-23
---
bgpq3.8 | 34 ++++++++++++++++++----------------
1 file changed, 18 insertions(+), 16 deletions(-)
diff --git a/bgpq3.8 b/bgpq3.8
index 724e769..6b7384e 100644
--- a/bgpq3.8
+++ b/bgpq3.8
@@ -138,7 +138,7 @@ those objects will be excluded from expansion.
.Sh EXAMPLES
Generating named juniper prefix-filter for AS20597:
.nf
-.RS
+.Rs
~>bgpq3 -Jl eltel AS20597
policy-options {
replace:
@@ -158,13 +158,13 @@ replace:
217.170.80.0/20;
}
}
-.RE
+.Re
.fi
.Pp
For Cisco we can use aggregation (-A) flag to make this prefix-filter
more compact:
.nf
-.RS
+.Rs
~>bgpq3 -Al eltel AS20597
no ip prefix-list eltel
ip prefix-list eltel permit 81.9.0.0/20
@@ -178,7 +178,7 @@ ip prefix-list eltel permit 89.112.0.0/18 ge 19 le 19
ip prefix-list eltel permit 89.112.4.0/22
ip prefix-list eltel permit 89.112.64.0/19
ip prefix-list eltel permit 217.170.64.0/19 ge 20 le 20
-.RE
+.Re
.fi
- you see, prefixes 89.112.0.0/19 and 89.112.32.0/19 now aggregated
into single entry 89.112.0.0/18 ge 19 le 19.
@@ -186,7 +186,7 @@ into single entry 89.112.0.0/18 ge 19 le 19.
Well, for Juniper we can generate even more interesting policy-options,
using -M <extra match conditions>, -R <len> and hierarchical names:
.nf
-.RS
+.Rs
~>bgpq3 -AJEl eltel/specifics -r 29 -R 32 -M "community blackhole" AS20597
policy-options {
policy-statement eltel {
@@ -207,7 +207,7 @@ replace:
}
}
}
-.RE
+.Re
.fi
generated policy-option term now allows all specifics with prefix-length
between /29 and /32 for eltel networks if they match with special community
@@ -215,17 +215,17 @@ blackhole (defined elsewhere in configuration).
.Pp
Of course, this version supports IPv6 (-6):
.nf
-.RS
+.Rs
~>bgpq3 -6l as-retn-6 AS-RETN6
no ipv6 prefix-list as-retn-6
ipv6 prefix-list as-retn-6 permit 2001:7fb:fe00::/48
ipv6 prefix-list as-retn-6 permit 2001:7fb:fe01::/48
[....]
-.RE
+.Re
.fi
and support for ASN 32 is also here
.nf
-.RS
+.Rs
~>bgpq3 -J3f 112 AS-SPACENET
policy-options {
replace:
@@ -236,14 +236,14 @@ replace:
as-path a3 "^112(.)*(35052|41720|43628|44450|196611)$";
}
}
-.RE
+.Re
.fi
see AS196611 in the end of the list ? That's AS3.3 in 'asplain' notation.
.Pp
For non-ASN32 capable routers you should not use switch -3,
and the result will be next:
.nf
-.RS
+.Rs
~>bgpq3 -f 112 AS-SPACENET
no ip as-path access-list NN
ip as-path access-list NN permit ^112(_112)*$
@@ -252,7 +252,7 @@ ip as-path access-list NN permit ^112(_[0-9]+)*_(8878|12136|12931|15909)$
ip as-path access-list NN permit ^112(_[0-9]+)*_(21358|23456|23600|24151)$
ip as-path access-list NN permit ^112(_[0-9]+)*_(25152|31529|34127|34906)$
ip as-path access-list NN permit ^112(_[0-9]+)*_(35052|41720|43628|44450)$
-.RE
+.Re
.fi
.Pp
AS196611 is no more in the list, however, AS23456 (transition AS)
@@ -262,13 +262,13 @@ If you want to generate configuration not for routers, but for some
other programs/systems, you may use user-defined formatting, like in
example below:
.nf
-.RS
+.Rs
user@host:~>bgpq3 -F "ipfw add pass all from %n/%l to any\\n" as3254
ipfw add pass all from 62.244.0.0/18 to any
ipfw add pass all from 91.219.29.0/24 to any
ipfw add pass all from 91.219.30.0/24 to any
ipfw add pass all from 193.193.192.0/19 to any
-.RE
+.Re
.fi
.Pp
Recognized format characters: %n - network, %l - mask length,
@@ -278,10 +278,10 @@ Please note that no new lines inserted automatically after each sentence,
you have to add them into format string manually, elsewhere output will
be in one line (sometimes it makes sense):
.nf
-.RS
+.Rs
user@host:~>bgpq3 -6F "%n/%l; " as-eltel
2001:1b00::/32; 2620:4f:8000::/48; 2a04:bac0::/29; 2a05:3a80::/48;
-.RE
+.Re
.fi
.Sh DIAGNOSTICS
When everything is OK,
@@ -292,8 +292,10 @@ non-zero status.
.Sh SEE ALSO
.Sy http://www.radb.net/
Routing Arbiter project
+.Pp
.Sy http://tools.ietf.org/html/draft-michaelson-4byte-as-representation-05
for information on 'asdot' and 'asplain' notations.
+.Pp
.Sy http://www.cisco.com/en/US/docs/ios/12_0s/release/ntes/120SNEWF.html#wp3521658
for information on Cisco implementation of ASN32.
.Sh AUTHOR
|