iproute2/tc
Jamal Hadi Salim 9e71352581 tc actions: Improved batching and time filtered dumping
dump more than TCA_ACT_MAX_PRIO actions per batch when the kernel
supports it.

Introduced keyword "since" for time based filtering of actions.
Some example (we have 400 actions bound to 400 filters); at
installation time. Using updated when tc setting the time of
interest to 120 seconds earlier (we see 400 actions):
prompt$ hackedtc actions ls action gact since 120000| grep index | wc -l
400

go get some coffee and wait for > 120 seconds and try again:

prompt$ hackedtc actions ls action gact since 120000 | grep index | wc -l
0

Lets see a filter bound to one of these actions:
....
filter pref 10 u32
filter pref 10 u32 fh 800: ht divisor 1
filter pref 10 u32 fh 800::800 order 2048 key ht 800 bkt 0 flowid 1:10  (rule hit 2 success 1)
  match 7f000002/ffffffff at 12 (success 1 )
    action order 1: gact action pass
     random type none pass val 0
     index 23 ref 2 bind 1 installed 1145 sec used 802 sec
    Action statistics:
    Sent 84 bytes 1 pkt (dropped 0, overlimits 0 requeues 0)
    backlog 0b 0p requeues 0
...

that coffee took long, no? It was good.

Now lets ping -c 1 127.0.0.2, then run the actions again:
prompt$ hackedtc actions ls action gact since 120 | grep index | wc -l
1

More details please:
prompt$ hackedtc -s actions ls action gact since 120000

    action order 0: gact action pass
     random type none pass val 0
     index 23 ref 2 bind 1 installed 1270 sec used 30 sec
    Action statistics:
    Sent 168 bytes 2 pkt (dropped 0, overlimits 0 requeues 0)
    backlog 0b 0p requeues 0

And the filter?
filter pref 10 u32
filter pref 10 u32 fh 800: ht divisor 1
filter pref 10 u32 fh 800::800 order 2048 key ht 800 bkt 0 flowid 1:10  (rule hit 4 success 2)
  match 7f000002/ffffffff at 12 (success 2 )
    action order 1: gact action pass
     random type none pass val 0
     index 23 ref 2 bind 1 installed 1324 sec used 84 sec
    Action statistics:
    Sent 168 bytes 2 pkt (dropped 0, overlimits 0 requeues 0)
    backlog 0b 0p requeues 0

Signed-off-by: Jamal Hadi Salim <jhs@mojatatu.com>
2017-08-04 13:16:51 -07:00
..
.gitignore Add ignore files to make using git easier 2006-08-08 12:04:38 -07:00
Makefile tc: fix Makefile to build skbmod 2017-05-22 13:33:51 -07:00
README.last tc: remove extra whitespace 2015-10-23 15:43:28 -07:00
e_bpf.c bpf: make tc's bpf loader generic and move into lib 2016-11-29 12:35:32 -08:00
em_canid.c Replace malloc && memset by calloc 2016-07-20 12:05:24 -07:00
em_cmp.c Use C99 style initializers everywhere 2016-07-20 12:05:24 -07:00
em_ipset.c Use C99 style initializers everywhere 2016-07-20 12:05:24 -07:00
em_meta.c tc: ematch: Ignore all-zero mask value when printing filters 2016-07-20 12:20:13 -07:00
em_nbyte.c Use C99 style initializers everywhere 2016-07-20 12:05:24 -07:00
em_u32.c Use C99 style initializers everywhere 2016-07-20 12:05:24 -07:00
emp_ematch.l fix build issues with flex ver 2.5 2010-04-22 15:27:42 -07:00
emp_ematch.y tc: remove extra whitespace 2015-10-23 15:43:28 -07:00
f_basic.c tc actions: Improved batching and time filtered dumping 2017-08-04 13:16:51 -07:00
f_bpf.c tc actions: Improved batching and time filtered dumping 2017-08-04 13:16:51 -07:00
f_cgroup.c tc actions: Improved batching and time filtered dumping 2017-08-04 13:16:51 -07:00
f_flow.c tc actions: Improved batching and time filtered dumping 2017-08-04 13:16:51 -07:00
f_flower.c tc actions: Improved batching and time filtered dumping 2017-08-04 13:16:51 -07:00
f_fw.c tc actions: Improved batching and time filtered dumping 2017-08-04 13:16:51 -07:00
f_matchall.c tc actions: Improved batching and time filtered dumping 2017-08-04 13:16:51 -07:00
f_route.c tc actions: Improved batching and time filtered dumping 2017-08-04 13:16:51 -07:00
f_rsvp.c tc actions: Improved batching and time filtered dumping 2017-08-04 13:16:51 -07:00
f_tcindex.c tc actions: Improved batching and time filtered dumping 2017-08-04 13:16:51 -07:00
f_u32.c tc actions: Improved batching and time filtered dumping 2017-08-04 13:16:51 -07:00
m_action.c tc actions: Improved batching and time filtered dumping 2017-08-04 13:16:51 -07:00
m_bpf.c bpf: dump id/jited info for cls/act programs 2017-07-18 17:20:45 -07:00
m_connmark.c tc/actions: introduce support for goto chain action 2017-05-22 13:31:51 -07:00
m_csum.c tc: actions: add helpers to parse and print control actions 2017-05-22 13:31:51 -07:00
m_ematch.c Use C99 style initializers everywhere 2016-07-20 12:05:24 -07:00
m_ematch.h include needed files 2012-12-23 11:49:06 -08:00
m_estimator.c tc: code cleanup 2016-03-21 11:48:36 -07:00
m_gact.c tc: gact: fix control action parsing 2017-06-08 11:03:12 -07:00
m_ife.c tc: actions: add helpers to parse and print control actions 2017-05-22 13:31:51 -07:00
m_ipt.c tc: pass correct conversion specifier to print 'unsigned int' action index. 2016-12-14 19:00:36 -08:00
m_mirred.c tc: actions: add helpers to parse and print control actions 2017-05-22 13:31:51 -07:00
m_nat.c tc: actions: add helpers to parse and print control actions 2017-05-22 13:31:51 -07:00
m_pedit.c tc/actions: introduce support for goto chain action 2017-05-22 13:31:51 -07:00
m_pedit.h pedit: fix whitespace 2017-05-01 09:25:22 -07:00
m_police.c tc/actions: introduce support for goto chain action 2017-05-22 13:31:51 -07:00
m_sample.c tc: actions: add helpers to parse and print control actions 2017-05-22 13:31:51 -07:00
m_simple.c tc: fix m_simple usage 2017-08-03 16:10:18 -07:00
m_skbedit.c tc: actions: add helpers to parse and print control actions 2017-05-22 13:31:51 -07:00
m_skbmod.c tc/actions: introduce support for goto chain action 2017-05-22 13:31:51 -07:00
m_tunnel_key.c tc: m_tunnel_key: add csum/nocsum option 2017-06-16 09:11:42 -07:00
m_vlan.c tc/actions: introduce support for goto chain action 2017-05-22 13:31:51 -07:00
m_xt.c tc: m_xt: Prevent a segfault in libipt 2017-05-30 17:38:19 -07:00
m_xt_old.c tc: pass correct conversion specifier to print 'unsigned int' action index. 2016-12-14 19:00:36 -08:00
p_eth.c pedit: Check for extended capability in protocol parser 2017-05-15 15:05:20 -07:00
p_icmp.c tc/pedit: Extend pedit to specify offset relative to mac/transport headers 2017-05-01 09:22:16 -07:00
p_ip.c pedit: Introduce ipv6 support 2017-05-15 15:05:20 -07:00
p_ip6.c pedit: Introduce ipv6 support 2017-05-15 15:05:20 -07:00
p_tcp.c tc/pedit: p_tcp: introduce pedit tcp support 2017-05-01 09:22:16 -07:00
p_udp.c pedit: Check for extended capability in protocol parser 2017-05-15 15:05:20 -07:00
q_atm.c tc: use rta_getattr_u32 2017-02-24 15:24:34 -08:00
q_cbq.c Use C99 style initializers everywhere 2016-07-20 12:05:24 -07:00
q_choke.c Use C99 style initializers everywhere 2016-07-20 12:05:24 -07:00
q_clsact.c ingress, clsact: don't add TCA_OPTIONS to nl msg 2016-05-16 11:20:50 -07:00
q_codel.c Use C99 style initializers everywhere 2016-07-20 12:05:24 -07:00
q_drr.c tc: code cleanup 2016-03-21 11:48:36 -07:00
q_dsmark.c Use C99 style initializers everywhere 2016-07-20 12:05:24 -07:00
q_fifo.c Use C99 style initializers everywhere 2016-07-20 12:05:24 -07:00
q_fq.c tc: fq: display unthrottle latency 2016-10-09 19:15:13 -07:00
q_fq_codel.c Use C99 style initializers everywhere 2016-07-20 12:05:24 -07:00
q_gred.c tc: code cleanup 2016-03-21 11:48:36 -07:00
q_hfsc.c Use C99 style initializers everywhere 2016-07-20 12:05:24 -07:00
q_hhf.c tc: code cleanup 2016-03-21 11:48:36 -07:00
q_htb.c Use C99 style initializers everywhere 2016-07-20 12:05:24 -07:00
q_ingress.c ingress, clsact: don't add TCA_OPTIONS to nl msg 2016-05-16 11:20:50 -07:00
q_mqprio.c ip: make local functions static 2013-02-12 11:38:35 -08:00
q_multiq.c tc: code cleanup 2016-03-21 11:48:36 -07:00
q_netem.c Use C99 style initializers everywhere 2016-07-20 12:05:24 -07:00
q_pie.c pie: remove always false condition 2017-03-10 08:58:01 -08:00
q_prio.c tc: code cleanup 2016-03-21 11:48:36 -07:00
q_qfq.c qfq: fix parse_opt dead code 2015-10-27 15:46:20 +09:00
q_red.c Use C99 style initializers everywhere 2016-07-20 12:05:24 -07:00
q_rr.c tc: code cleanup 2016-03-21 11:48:36 -07:00
q_sfb.c Use C99 style initializers everywhere 2016-07-20 12:05:24 -07:00
q_sfq.c Use C99 style initializers everywhere 2016-07-20 12:05:24 -07:00
q_tbf.c Use C99 style initializers everywhere 2016-07-20 12:05:24 -07:00
static-syms.c Fix build when shared libraries are disabled 2013-03-13 08:29:59 -07:00
tc.c Replace malloc && memset by calloc 2016-07-20 12:05:24 -07:00
tc_cbq.c tc: code cleanup 2016-03-21 11:48:36 -07:00
tc_cbq.h (Logical change 1.3) 2004-04-15 20:56:59 +00:00
tc_class.c remove useless return statement 2016-09-01 08:44:20 -07:00
tc_common.h tc: built-in eBPF exec proxy 2015-04-27 16:39:23 -07:00
tc_core.c tc: include stdint.h explicitly for UINT16_MAX 2017-05-22 11:41:53 -07:00
tc_core.h htb: support 64bit rates 2013-11-22 17:36:18 -08:00
tc_estimator.c tc: code cleanup 2016-03-21 11:48:36 -07:00
tc_exec.c Replace malloc && memset by calloc 2016-07-20 12:05:24 -07:00
tc_filter.c tc_filter: add support for chain index 2017-05-22 13:31:51 -07:00
tc_monitor.c tc: code cleanup 2016-03-21 11:48:36 -07:00
tc_qdisc.c iproute2: add support for invisible qdisc dumping 2017-03-14 16:37:08 -07:00
tc_red.c tc: code cleanup 2016-03-21 11:48:36 -07:00
tc_red.h (Logical change 1.3) 2004-04-15 20:56:59 +00:00
tc_stab.c remove useless return statement 2016-09-01 08:44:20 -07:00
tc_util.c tc: don't print error message on miss when parsing action with default 2017-06-16 09:07:31 -07:00
tc_util.h tc actions: Improved batching and time filtered dumping 2017-08-04 13:16:51 -07:00

README.last

Kernel code and interface.
--------------------------

* Compile time switches

There is only one, but very important, compile time switch.
It is not settable by "make config", but should be selected
manually and after a bit of thinking in <include/net/pkt_sched.h>

PSCHED_CLOCK_SOURCE can take three values:

	PSCHED_GETTIMEOFDAY
	PSCHED_JIFFIES
	PSCHED_CPU


 PSCHED_GETTIMEOFDAY

Default setting is the most conservative PSCHED_GETTIMEOFDAY.
It is very slow both because of weird slowness of do_gettimeofday()
and because it forces code to use unnatural "timeval" format,
where microseconds and seconds fields are separate.
Besides that, it will misbehave, when delays exceed 2 seconds
(f.e. very slow links or classes bounded to small slice of bandwidth)
To resume: as only you will get it working, select correct clock
source and forget about PSCHED_GETTIMEOFDAY forever.


 PSCHED_JIFFIES

Clock is derived from jiffies. On architectures with HZ=100
granularity of this clock is not enough to make reasonable
bindings to real time. However, taking into account Linux
architecture problems, which force us to use artificial
integrated clock in any case, this switch is not so bad
for schduling even on high speed networks, though policing
is not reliable.


 PSCHED_CPU

It is available only for alpha and pentiums with correct
CPU timestamp. It is the fastest way, use it when it is available,
but remember: not all pentiums have this facility, and
a lot of them have clock, broken by APM etc. etc.