Perf: Protocol to measure BIRD performance internally (d13fa8c0) · Commits · 戴 / Bird

configure.ac

+1 −1

Original line number	Diff line number	Diff line
		@@ -271,7 +271,7 @@ if test "$enable_mpls_kernel" != no ; then
		fi
		fi

		all_protocols="$proto_bfd babel bgp mrt ospf pipe radv rip $proto_rpki static"
		all_protocols="$proto_bfd babel bgp mrt ospf perf pipe radv rip $proto_rpki static"

		all_protocols=`echo $all_protocols \| sed 's/ /,/g'`

doc/bird.sgml

+39 −1

Original line number	Diff line number	Diff line
		@@ -25,7 +25,7 @@ configuration - something in config which is not keyword.
		Ondrej Filip <it/<feela@network.cz>/,
		Pavel Machek <it/<pavel@ucw.cz>/,
		Martin Mares <it/<mj@ucw.cz>/,
		Maria Jan Matejka <it/<mq@jmq.cz>/,
		Maria Matejka <it/<mq@jmq.cz>/,
		Ondrej Zajicek <it/<santiago@crfreenet.org>/
		</author>

		@@ -3749,6 +3749,44 @@ protocol ospf MyOSPF {
		}
		</code>

		<sect>Perf
		<label id="perf">

		<sect1>Introduction
		<label id="perf-intro">

		<p>The Perf protocol is a generator of fake routes together with a time measurement
		framework. Its purpose is to check BIRD performance and to benchmark filters.

		<p>This protocol runs in several steps. In each step, it generates 2^x routes,
		imports them into the appropriate table and withdraws them. The exponent x is configurable.
		It runs the benchmark several times for the same x, then it increases x by one
		until it gets too high, then it stops.

		<p>Output data is logged on info level. There is a Perl script <cf>proto/perf/parse.pl</cf>
		which may be handy to parse the data and draw some plots.

		<p>Implementation of this protocol is experimental. Use with caution and do not keep
		any instance of Perf in production configs.

		<sect1>Configuration
		<label id="perf-config">

		<p><descrip>
		<tag><label id="perf-repeat">repeat <m/number/</tag>
		Run this amount of iterations of the benchmark for every amount step. Default: 4

		<tag><label id="perf-from">exp from <m/number/</tag>
		Begin benchmarking on this exponent for number of generated routes in one step.
		Default: 10

		<tag><label id="perf-to">exp to <m/number/</tag>
		Stop benchmarking on this exponent. Default: 20

		<tag><label id="perf-threshold">threshold <m/time/</tag>
		If every run for the given exponent took at least this time for route import,
		stop benchmarking. Default: 500 ms
		</descrip>

		<sect>Pipe
		<label id="pipe">

nest/proto.c

+3 −0

Original line number	Diff line number	Diff line
		@@ -1375,6 +1375,9 @@ protos_build(void)
		#ifdef CONFIG_RPKI
		proto_build(&proto_rpki);
		#endif
		#ifdef CONFIG_PERF
		proto_build(&proto_perf);
		#endif

		proto_pool = rp_new(&root_pool, "Protocols");
		proto_shutdown_timer = tm_new(proto_pool);

nest/protocol.h

+3 −1

Original line number	Diff line number	Diff line
		@@ -47,6 +47,7 @@ enum protocol_class {
		PROTOCOL_KERNEL,
		PROTOCOL_OSPF,
		PROTOCOL_MRT,
		PROTOCOL_PERF,
		PROTOCOL_PIPE,
		PROTOCOL_RADV,
		PROTOCOL_RIP,
		@@ -100,7 +101,8 @@ void protos_dump_all(void);

		extern struct protocol
		proto_device, proto_radv, proto_rip, proto_static, proto_mrt,
		proto_ospf, proto_pipe, proto_bgp, proto_bfd, proto_babel, proto_rpki;
		proto_ospf, proto_perf,
		proto_pipe, proto_bgp, proto_bfd, proto_babel, proto_rpki;

		/*
		* Routing Protocol Instance

nest/route.h

+2 −2

Original line number	Diff line number	Diff line
		@@ -430,8 +430,8 @@ typedef struct rta {
		#define RTS_PIPE 12 /* Inter-table wormhole */
		#define RTS_BABEL 13 /* Babel route */
		#define RTS_RPKI 14 /* Route Origin Authorization */
		#define RTS_MAX 15

		#define RTS_PERF 15 /* Perf checker */
		#define RTS_MAX 16

		#define RTC_UNICAST 0
		#define RTC_BROADCAST 1

Admin message