iproute2/tc
Andreas Henriksson 5e3bb534ae iproute: DESTDIR vs LIBDIR.
Hello Rafael Almeida.

I noticed your patch adding DESTDIR support in the latest iproute2 release.
Much appreciated! Soon the debian packages might be able to move to actually
using "make install" rather then it's own installation procedure when
building packages. I've noticed something that will break though....

Debian packages usually sets DESTDIR=debian/tmp/ and packages the contents
of that directory as if it where the root file system. This will break
the /usr/lib/{tc,ip}/ module loading, because they DESTDIR (/usr) will be
/whatever-the-build-path-was/debian/tmp/lib/{tc,ip}/.
I beleive others usually call this the LIBDIR to make the separation between
DISTDIR being the (possibly temporary) place things are put when build is
done, and LIBDIR (and others) are used for actual runtime paths.

I'm attaching a patch that I think fixes this, but would be really happy if
you could have a look at to verify I'm not screwing something up.

--
Regards,
Andreas Henriksson

Signed-off-by: Stephen Hemminger <stephen.hemminger@vyatta.com>
2008-09-17 22:04:02 -07:00
..
.gitignore Add ignore files to make using git easier 2006-08-08 12:04:38 -07:00
Makefile iproute: DESTDIR vs LIBDIR. 2008-09-17 22:04:02 -07:00
README.last (Logical change 1.3) 2004-04-15 20:56:59 +00:00
em_cmp.c Fix ematch cmp and nbyte syntax help text. 2007-10-12 14:56:31 -07:00
em_meta.c long/ulong iproute-git fix 2008-07-31 15:25:15 -07:00
em_nbyte.c Fix ematch cmp and nbyte syntax help text. 2007-10-12 14:56:31 -07:00
em_u32.c Remove trailing whitespace 2006-12-05 10:10:22 -08:00
emp_ematch.l Remove trailing whitespace 2006-12-05 10:10:22 -08:00
emp_ematch.y Thomas's ematch fixes for lex. 2005-07-08 22:08:47 +00:00
f_basic.c Update various classifiers' help output for expected CLASSID syntax 2008-02-13 12:36:38 -08:00
f_flow.c cls_flow: add perturbation support 2008-09-17 21:53:37 -07:00
f_fw.c Update various classifiers' help output for expected CLASSID syntax 2008-02-13 12:36:38 -08:00
f_route.c Update various classifiers' help output for expected CLASSID syntax 2008-02-13 12:36:38 -08:00
f_rsvp.c Update various classifiers' help output for expected CLASSID syntax 2008-02-13 12:36:38 -08:00
f_tcindex.c Use parse_rtattr_nested 2005-01-18 22:11:58 +00:00
f_u32.c Infrastructure for pretty printing 2008-05-09 15:50:12 -07:00
m_action.c Remove trailing whitespace 2006-12-05 10:10:22 -08:00
m_ematch.c ematch related bugfix and cleanup 2008-05-29 11:54:19 -07:00
m_ematch.h ematch related bugfix and cleanup 2008-05-29 11:54:19 -07:00
m_estimator.c Replace "usec" by "time" in function names 2007-03-13 14:42:17 -07:00
m_gact.c Remove trailing whitespace 2006-12-05 10:10:22 -08:00
m_ipt.c Merge branch 'master' into net-2.6.25 2007-12-31 12:51:15 -08:00
m_mirred.c Remove trailing whitespace 2006-12-05 10:10:22 -08:00
m_nat.c Add NAT action 2007-12-11 09:33:55 -08:00
m_pedit.c Remove trailing whitespace 2006-12-05 10:10:22 -08:00
m_pedit.h Remove trailing whitespace 2006-12-05 10:10:22 -08:00
m_police.c ATM cell alignment. 2008-04-17 10:04:31 -07:00
p_icmp.c Remove trailing whitespace 2006-12-05 10:10:22 -08:00
p_ip.c Remove trailing whitespace 2006-12-05 10:10:22 -08:00
p_tcp.c Remove trailing whitespace 2006-12-05 10:10:22 -08:00
p_udp.c Remove trailing whitespace 2006-12-05 10:10:22 -08:00
q_atm.c Use parse_rtattr_nested 2005-01-18 22:11:58 +00:00
q_cbq.c ATM cell alignment. 2008-04-17 10:04:31 -07:00
q_dsmark.c Use NLMSG_TAIL 2005-01-18 01:24:18 +00:00
q_fifo.c : prevent tc crashes 2004-09-28 18:35:49 +00:00
q_gred.c Remove trailing whitespace 2006-12-05 10:10:22 -08:00
q_hfsc.c Replace "usec" by "time" in function names 2007-03-13 14:42:17 -07:00
q_htb.c ATM cell alignment. 2008-04-17 10:04:31 -07:00
q_ingress.c : prevent tc crashes 2004-09-28 18:35:49 +00:00
q_netem.c netem potential dist table overflow 2007-12-12 15:02:51 -08:00
q_prio.c iproute2: sch_rr support in tc 2007-08-22 10:04:25 -07:00
q_red.c Remove trailing whitespace 2006-12-05 10:10:22 -08:00
q_rr.c iproute2: sch_rr support in tc 2007-08-22 10:04:25 -07:00
q_sfq.c Add support for SFQ xstats 2008-01-31 22:28:10 -08:00
q_tbf.c ATM cell alignment. 2008-04-17 10:04:31 -07:00
tc.c Change formatting of u32 back to default 2008-05-09 15:42:34 -07:00
tc_cbq.c Replace "usec" by "time" in function names 2007-03-13 14:42:17 -07:00
tc_cbq.h (Logical change 1.3) 2004-04-15 20:56:59 +00:00
tc_class.c Fixes for tc help commands 2006-12-14 15:01:30 -08:00
tc_common.h add generic size table for qdiscs 2008-09-17 21:57:15 -07:00
tc_core.c add generic size table for qdiscs 2008-09-17 21:57:15 -07:00
tc_core.h add generic size table for qdiscs 2008-09-17 21:57:15 -07:00
tc_estimator.c Introduce TIME_UNITS_PER_SEC to represent internal clock resolution 2007-03-13 14:42:16 -07:00
tc_filter.c tc: don't set protococol field on filter delete 2008-06-23 09:09:45 -07:00
tc_monitor.c update rest to use nl_mgrp 2007-03-13 14:39:05 -07:00
tc_qdisc.c add generic size table for qdiscs 2008-09-17 21:57:15 -07:00
tc_red.c Use tc_calc_xmittime() where appropriate 2007-03-13 14:42:14 -07:00
tc_red.h (Logical change 1.3) 2004-04-15 20:56:59 +00:00
tc_stab.c add generic size table for qdiscs 2008-09-17 21:57:15 -07:00
tc_util.c iproute: DESTDIR vs LIBDIR. 2008-09-17 22:04:02 -07:00
tc_util.h add generic size table for qdiscs 2008-09-17 21:57:15 -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.