File: 0002-fix-manpage

package info (click to toggle)
bgpq3 0.1.36.1-1
  • links: PTS, VCS
  • area: main
  • in suites: bookworm, forky, sid, trixie
  • size: 544 kB
  • sloc: ansic: 5,411; sh: 153; makefile: 71
file content (156 lines) | stat: -rw-r--r-- 4,481 bytes parent folder | download
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