12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175117611771178117911801181118211831184118511861187118811891190119111921193119411951196119711981199120012011202120312041205120612071208120912101211121212131214121512161217121812191220122112221223122412251226122712281229123012311232123312341235123612371238123912401241124212431244124512461247124812491250125112521253125412551256125712581259126012611262126312641265126612671268126912701271127212731274127512761277127812791280128112821283128412851286128712881289129012911292129312941295129612971298129913001301130213031304130513061307130813091310131113121313131413151316131713181319132013211322132313241325132613271328132913301331133213331334133513361337133813391340134113421343134413451346134713481349135013511352135313541355135613571358135913601361136213631364136513661367136813691370137113721373137413751376137713781379138013811382138313841385138613871388138913901391139213931394139513961397139813991400140114021403140414051406140714081409141014111412141314141415141614171418141914201421142214231424142514261427142814291430143114321433143414351436143714381439144014411442144314441445144614471448144914501451145214531454145514561457145814591460146114621463146414651466146714681469147014711472147314741475147614771478147914801481148214831484148514861487148814891490149114921493149414951496149714981499 |
- --- a/include/linux/pkt_sched.h
- +++ b/include/linux/pkt_sched.h
- @@ -850,4 +850,118 @@ struct tc_pie_xstats {
- __u32 maxq; /* maximum queue size */
- __u32 ecn_mark; /* packets marked with ecn*/
- };
- +/* CAKE */
- +enum {
- + TCA_CAKE_UNSPEC,
- + TCA_CAKE_PAD,
- + TCA_CAKE_BASE_RATE64,
- + TCA_CAKE_DIFFSERV_MODE,
- + TCA_CAKE_ATM,
- + TCA_CAKE_FLOW_MODE,
- + TCA_CAKE_OVERHEAD,
- + TCA_CAKE_RTT,
- + TCA_CAKE_TARGET,
- + TCA_CAKE_AUTORATE,
- + TCA_CAKE_MEMORY,
- + TCA_CAKE_NAT,
- + TCA_CAKE_RAW, // was _ETHERNET
- + TCA_CAKE_WASH,
- + TCA_CAKE_MPU,
- + TCA_CAKE_INGRESS,
- + TCA_CAKE_ACK_FILTER,
- + TCA_CAKE_SPLIT_GSO,
- + __TCA_CAKE_MAX
- +};
- +#define TCA_CAKE_MAX (__TCA_CAKE_MAX - 1)
- +
- +enum {
- + __TCA_CAKE_STATS_INVALID,
- + TCA_CAKE_STATS_PAD,
- + TCA_CAKE_STATS_CAPACITY_ESTIMATE64,
- + TCA_CAKE_STATS_MEMORY_LIMIT,
- + TCA_CAKE_STATS_MEMORY_USED,
- + TCA_CAKE_STATS_AVG_NETOFF,
- + TCA_CAKE_STATS_MIN_NETLEN,
- + TCA_CAKE_STATS_MAX_NETLEN,
- + TCA_CAKE_STATS_MIN_ADJLEN,
- + TCA_CAKE_STATS_MAX_ADJLEN,
- + TCA_CAKE_STATS_TIN_STATS,
- + TCA_CAKE_STATS_DEFICIT,
- + TCA_CAKE_STATS_COBALT_COUNT,
- + TCA_CAKE_STATS_DROPPING,
- + TCA_CAKE_STATS_DROP_NEXT_US,
- + TCA_CAKE_STATS_P_DROP,
- + TCA_CAKE_STATS_BLUE_TIMER_US,
- + __TCA_CAKE_STATS_MAX
- +};
- +#define TCA_CAKE_STATS_MAX (__TCA_CAKE_STATS_MAX - 1)
- +
- +enum {
- + __TCA_CAKE_TIN_STATS_INVALID,
- + TCA_CAKE_TIN_STATS_PAD,
- + TCA_CAKE_TIN_STATS_SENT_PACKETS,
- + TCA_CAKE_TIN_STATS_SENT_BYTES64,
- + TCA_CAKE_TIN_STATS_DROPPED_PACKETS,
- + TCA_CAKE_TIN_STATS_DROPPED_BYTES64,
- + TCA_CAKE_TIN_STATS_ACKS_DROPPED_PACKETS,
- + TCA_CAKE_TIN_STATS_ACKS_DROPPED_BYTES64,
- + TCA_CAKE_TIN_STATS_ECN_MARKED_PACKETS,
- + TCA_CAKE_TIN_STATS_ECN_MARKED_BYTES64,
- + TCA_CAKE_TIN_STATS_BACKLOG_PACKETS,
- + TCA_CAKE_TIN_STATS_BACKLOG_BYTES,
- + TCA_CAKE_TIN_STATS_THRESHOLD_RATE64,
- + TCA_CAKE_TIN_STATS_TARGET_US,
- + TCA_CAKE_TIN_STATS_INTERVAL_US,
- + TCA_CAKE_TIN_STATS_WAY_INDIRECT_HITS,
- + TCA_CAKE_TIN_STATS_WAY_MISSES,
- + TCA_CAKE_TIN_STATS_WAY_COLLISIONS,
- + TCA_CAKE_TIN_STATS_PEAK_DELAY_US,
- + TCA_CAKE_TIN_STATS_AVG_DELAY_US,
- + TCA_CAKE_TIN_STATS_BASE_DELAY_US,
- + TCA_CAKE_TIN_STATS_SPARSE_FLOWS,
- + TCA_CAKE_TIN_STATS_BULK_FLOWS,
- + TCA_CAKE_TIN_STATS_UNRESPONSIVE_FLOWS,
- + TCA_CAKE_TIN_STATS_MAX_SKBLEN,
- + TCA_CAKE_TIN_STATS_FLOW_QUANTUM,
- + __TCA_CAKE_TIN_STATS_MAX
- +};
- +#define TCA_CAKE_TIN_STATS_MAX (__TCA_CAKE_TIN_STATS_MAX - 1)
- +#define TC_CAKE_MAX_TINS (8)
- +
- +enum {
- + CAKE_FLOW_NONE = 0,
- + CAKE_FLOW_SRC_IP,
- + CAKE_FLOW_DST_IP,
- + CAKE_FLOW_HOSTS, /* = CAKE_FLOW_SRC_IP | CAKE_FLOW_DST_IP */
- + CAKE_FLOW_FLOWS,
- + CAKE_FLOW_DUAL_SRC, /* = CAKE_FLOW_SRC_IP | CAKE_FLOW_FLOWS */
- + CAKE_FLOW_DUAL_DST, /* = CAKE_FLOW_DST_IP | CAKE_FLOW_FLOWS */
- + CAKE_FLOW_TRIPLE, /* = CAKE_FLOW_HOSTS | CAKE_FLOW_FLOWS */
- + CAKE_FLOW_MAX,
- +};
- +
- +enum {
- + CAKE_DIFFSERV_DIFFSERV3 = 0,
- + CAKE_DIFFSERV_DIFFSERV4,
- + CAKE_DIFFSERV_DIFFSERV8,
- + CAKE_DIFFSERV_BESTEFFORT,
- + CAKE_DIFFSERV_PRECEDENCE,
- + CAKE_DIFFSERV_MAX
- +};
- +
- +enum {
- + CAKE_ACK_NONE = 0,
- + CAKE_ACK_FILTER,
- + CAKE_ACK_AGGRESSIVE,
- + CAKE_ACK_MAX
- +};
- +
- +enum {
- + CAKE_ATM_NONE = 0,
- + CAKE_ATM_ATM,
- + CAKE_ATM_PTM,
- + CAKE_ATM_MAX
- +};
- +
- +
- #endif
- --- /dev/null
- +++ b/man/man8/tc-cake.8
- @@ -0,0 +1,632 @@
- +.TH CAKE 8 "23 November 2017" "iproute2" "Linux"
- +.SH NAME
- +CAKE \- Common Applications Kept Enhanced (CAKE)
- +.SH SYNOPSIS
- +.B tc qdisc ... cake
- +.br
- +[
- +.BR bandwidth
- +RATE |
- +.BR unlimited*
- +|
- +.BR autorate-ingress
- +]
- +.br
- +[
- +.BR rtt
- +TIME |
- +.BR datacentre
- +|
- +.BR lan
- +|
- +.BR metro
- +|
- +.BR regional
- +|
- +.BR internet*
- +|
- +.BR oceanic
- +|
- +.BR satellite
- +|
- +.BR interplanetary
- +]
- +.br
- +[
- +.BR besteffort
- +|
- +.BR diffserv8
- +|
- +.BR diffserv4
- +|
- +.BR diffserv3*
- +]
- +.br
- +[
- +.BR flowblind
- +|
- +.BR srchost
- +|
- +.BR dsthost
- +|
- +.BR hosts
- +|
- +.BR flows
- +|
- +.BR dual-srchost
- +|
- +.BR dual-dsthost
- +|
- +.BR triple-isolate*
- +]
- +.br
- +[
- +.BR nat
- +|
- +.BR nonat*
- +]
- +.br
- +[
- +.BR wash
- +|
- +.BR nowash*
- +]
- +.br
- +[
- +.BR ack-filter
- +|
- +.BR ack-filter-aggressive
- +|
- +.BR no-ack-filter*
- +]
- +.br
- +[
- +.BR memlimit
- +LIMIT ]
- +.br
- +[
- +.BR ptm
- +|
- +.BR atm
- +|
- +.BR noatm*
- +]
- +.br
- +[
- +.BR overhead
- +N |
- +.BR conservative
- +|
- +.BR raw*
- +]
- +.br
- +[
- +.BR mpu
- +N ]
- +.br
- +[
- +.BR ingress
- +|
- +.BR egress*
- +]
- +.br
- +(* marks defaults)
- +
- +
- +.SH DESCRIPTION
- +CAKE (Common Applications Kept Enhanced) is a shaping-capable queue discipline
- +which uses both AQM and FQ. It combines COBALT, which is an AQM algorithm
- +combining Codel and BLUE, a shaper which operates in deficit mode, and a variant
- +of DRR++ for flow isolation. 8-way set-associative hashing is used to virtually
- +eliminate hash collisions. Priority queuing is available through a simplified
- +diffserv implementation. Overhead compensation for various encapsulation
- +schemes is tightly integrated.
- +
- +All settings are optional; the default settings are chosen to be sensible in
- +most common deployments. Most people will only need to set the
- +.B bandwidth
- +parameter to get useful results, but reading the
- +.B Overhead Compensation
- +and
- +.B Round Trip Time
- +sections is strongly encouraged.
- +
- +.SH SHAPER PARAMETERS
- +CAKE uses a deficit-mode shaper, which does not exhibit the initial burst
- +typical of token-bucket shapers. It will automatically burst precisely as much
- +as required to maintain the configured throughput. As such, it is very
- +straightforward to configure.
- +.PP
- +.B unlimited
- +(default)
- +.br
- + No limit on the bandwidth.
- +.PP
- +.B bandwidth
- +RATE
- +.br
- + Set the shaper bandwidth. See
- +.BR tc(8)
- +or examples below for details of the RATE value.
- +.PP
- +.B autorate-ingress
- +.br
- + Automatic capacity estimation based on traffic arriving at this qdisc.
- +This is most likely to be useful with cellular links, which tend to change
- +quality randomly. A
- +.B bandwidth
- +parameter can be used in conjunction to specify an initial estimate. The shaper
- +will periodically be set to a bandwidth slightly below the estimated rate. This
- +estimator cannot estimate the bandwidth of links downstream of itself.
- +
- +.SH OVERHEAD COMPENSATION PARAMETERS
- +The size of each packet on the wire may differ from that seen by Linux. The
- +following parameters allow CAKE to compensate for this difference by internally
- +considering each packet to be bigger than Linux informs it. To assist users who
- +are not expert network engineers, keywords have been provided to represent a
- +number of common link technologies.
- +
- +.SS Manual Overhead Specification
- +.B overhead
- +BYTES
- +.br
- + Adds BYTES to the size of each packet. BYTES may be negative; values
- +between -64 and 256 (inclusive) are accepted.
- +.PP
- +.B mpu
- +BYTES
- +.br
- + Rounds each packet (including overhead) up to a minimum length
- +BYTES. BYTES may not be negative; values between 0 and 256 (inclusive)
- +are accepted.
- +.PP
- +.B atm
- +.br
- + Compensates for ATM cell framing, which is normally found on ADSL links.
- +This is performed after the
- +.B overhead
- +parameter above. ATM uses fixed 53-byte cells, each of which can carry 48 bytes
- +payload.
- +.PP
- +.B ptm
- +.br
- + Compensates for PTM encoding, which is normally found on VDSL2 links and
- +uses a 64b/65b encoding scheme. It is even more efficient to simply
- +derate the specified shaper bandwidth by a factor of 64/65 or 0.984. See
- +ITU G.992.3 Annex N and IEEE 802.3 Section 61.3 for details.
- +.PP
- +.B noatm
- +.br
- + Disables ATM and PTM compensation.
- +
- +.SS Failsafe Overhead Keywords
- +These two keywords are provided for quick-and-dirty setup. Use them if you
- +can't be bothered to read the rest of this section.
- +.PP
- +.B raw
- +(default)
- +.br
- + Turns off all overhead compensation in CAKE. The packet size reported
- +by Linux will be used directly.
- +.PP
- + Other overhead keywords may be added after "raw". The effect of this is
- +to make the overhead compensation operate relative to the reported packet size,
- +not the underlying IP packet size.
- +.PP
- +.B conservative
- +.br
- + Compensates for more overhead than is likely to occur on any
- +widely-deployed link technology.
- +.br
- + Equivalent to
- +.B overhead 48 atm.
- +
- +.SS ADSL Overhead Keywords
- +Most ADSL modems have a way to check which framing scheme is in use. Often this
- +is also specified in the settings document provided by the ISP. The keywords in
- +this section are intended to correspond with these sources of information. All
- +of them implicitly set the
- +.B atm
- +flag.
- +.PP
- +.B pppoa-vcmux
- +.br
- + Equivalent to
- +.B overhead 10 atm
- +.PP
- +.B pppoa-llc
- +.br
- + Equivalent to
- +.B overhead 14 atm
- +.PP
- +.B pppoe-vcmux
- +.br
- + Equivalent to
- +.B overhead 32 atm
- +.PP
- +.B pppoe-llcsnap
- +.br
- + Equivalent to
- +.B overhead 40 atm
- +.PP
- +.B bridged-vcmux
- +.br
- + Equivalent to
- +.B overhead 24 atm
- +.PP
- +.B bridged-llcsnap
- +.br
- + Equivalent to
- +.B overhead 32 atm
- +.PP
- +.B ipoa-vcmux
- +.br
- + Equivalent to
- +.B overhead 8 atm
- +.PP
- +.B ipoa-llcsnap
- +.br
- + Equivalent to
- +.B overhead 16 atm
- +.PP
- +See also the Ethernet Correction Factors section below.
- +
- +.SS VDSL2 Overhead Keywords
- +ATM was dropped from VDSL2 in favour of PTM, which is a much more
- +straightforward framing scheme. Some ISPs retained PPPoE for compatibility with
- +their existing back-end systems.
- +.PP
- +.B pppoe-ptm
- +.br
- + Equivalent to
- +.B overhead 30 ptm
- +
- +.br
- + PPPoE: 2B PPP + 6B PPPoE +
- +.br
- + ETHERNET: 6B dest MAC + 6B src MAC + 2B ethertype + 4B Frame Check Sequence +
- +.br
- + PTM: 1B Start of Frame (S) + 1B End of Frame (Ck) + 2B TC-CRC (PTM-FCS)
- +.br
- +.PP
- +.B bridged-ptm
- +.br
- + Equivalent to
- +.B overhead 22 ptm
- +.br
- + ETHERNET: 6B dest MAC + 6B src MAC + 2B ethertype + 4B Frame Check Sequence +
- +.br
- + PTM: 1B Start of Frame (S) + 1B End of Frame (Ck) + 2B TC-CRC (PTM-FCS)
- +.br
- +.PP
- +See also the Ethernet Correction Factors section below.
- +
- +.SS DOCSIS Cable Overhead Keyword
- +DOCSIS is the universal standard for providing Internet service over cable-TV
- +infrastructure.
- +
- +In this case, the actual on-wire overhead is less important than the packet size
- +the head-end equipment uses for shaping and metering. This is specified to be
- +an Ethernet frame including the CRC (aka FCS).
- +.PP
- +.B docsis
- +.br
- + Equivalent to
- +.B overhead 18 mpu 64 noatm
- +
- +.SS Ethernet Overhead Keywords
- +.PP
- +.B ethernet
- +.br
- + Accounts for Ethernet's preamble, inter-frame gap, and Frame Check
- +Sequence. Use this keyword when the bottleneck being shaped for is an
- +actual Ethernet cable.
- +.br
- + Equivalent to
- +.B overhead 38 mpu 84 noatm
- +.PP
- +.B ether-vlan
- +.br
- + Adds 4 bytes to the overhead compensation, accounting for an IEEE 802.1Q
- +VLAN header appended to the Ethernet frame header. NB: Some ISPs use one or
- +even two of these within PPPoE; this keyword may be repeated as necessary to
- +express this.
- +
- +.SH ROUND TRIP TIME PARAMETERS
- +Active Queue Management (AQM) consists of embedding congestion signals in the
- +packet flow, which receivers use to instruct senders to slow down when the queue
- +is persistently occupied. CAKE uses ECN signalling when available, and packet
- +drops otherwise, according to a combination of the Codel and BLUE AQM algorithms
- +called COBALT.
- +
- +Very short latencies require a very rapid AQM response to adequately control
- +latency. However, such a rapid response tends to impair throughput when the
- +actual RTT is relatively long. CAKE allows specifying the RTT it assumes for
- +tuning various parameters. Actual RTTs within an order of magnitude of this
- +will generally work well for both throughput and latency management.
- +
- +At the 'lan' setting and below, the time constants are similar in magnitude to
- +the jitter in the Linux kernel itself, so congestion might be signalled
- +prematurely. The flows will then become sparse and total throughput reduced,
- +leaving little or no back-pressure for the fairness logic to work against. Use
- +the "metro" setting for local lans unless you have a custom kernel.
- +.PP
- +.B rtt
- +TIME
- +.br
- + Manually specify an RTT.
- +.PP
- +.B datacentre
- +.br
- + For extremely high-performance 10GigE+ networks only. Equivalent to
- +.B rtt 100us.
- +.PP
- +.B lan
- +.br
- + For pure Ethernet (not Wi-Fi) networks, at home or in the office. Don't
- +use this when shaping for an Internet access link. Equivalent to
- +.B rtt 1ms.
- +.PP
- +.B metro
- +.br
- + For traffic mostly within a single city. Equivalent to
- +.B rtt 10ms.
- +.PP
- +.B regional
- +.br
- + For traffic mostly within a European-sized country. Equivalent to
- +.B rtt 30ms.
- +.PP
- +.B internet
- +(default)
- +.br
- + This is suitable for most Internet traffic. Equivalent to
- +.B rtt 100ms.
- +.PP
- +.B oceanic
- +.br
- + For Internet traffic with generally above-average latency, such as that
- +suffered by Australasian residents. Equivalent to
- +.B rtt 300ms.
- +.PP
- +.B satellite
- +.br
- + For traffic via geostationary satellites. Equivalent to
- +.B rtt 1000ms.
- +.PP
- +.B interplanetary
- +.br
- + So named because Jupiter is about 1 light-hour from Earth. Use this to
- +(almost) completely disable AQM actions. Equivalent to
- +.B rtt 1000s.
- +
- +.SH FLOW ISOLATION PARAMETERS
- +With flow isolation enabled, CAKE places packets from different flows into
- +different queues, each of which carries its own AQM state. Packets from each
- +queue are then delivered fairly, according to a DRR++ algorithm which minimises
- +latency for "sparse" flows. CAKE uses a set-associative hashing algorithm to
- +minimise flow collisions.
- +
- +These keywords specify whether fairness based on source address, destination
- +address, individual flows, or any combination of those is desired.
- +.PP
- +.B flowblind
- +.br
- + Disables flow isolation; all traffic passes through a single queue for
- +each tin.
- +.PP
- +.B srchost
- +.br
- + Flows are defined only by source address. Could be useful on the egress
- +path of an ISP backhaul.
- +.PP
- +.B dsthost
- +.br
- + Flows are defined only by destination address. Could be useful on the
- +ingress path of an ISP backhaul.
- +.PP
- +.B hosts
- +.br
- + Flows are defined by source-destination host pairs. This is host
- +isolation, rather than flow isolation.
- +.PP
- +.B flows
- +.br
- + Flows are defined by the entire 5-tuple of source address, destination
- +address, transport protocol, source port and destination port. This is the type
- +of flow isolation performed by SFQ and fq_codel.
- +.PP
- +.B dual-srchost
- +.br
- + Flows are defined by the 5-tuple, and fairness is applied first over
- +source addresses, then over individual flows. Good for use on egress traffic
- +from a LAN to the internet, where it'll prevent any one LAN host from
- +monopolising the uplink, regardless of the number of flows they use.
- +.PP
- +.B dual-dsthost
- +.br
- + Flows are defined by the 5-tuple, and fairness is applied first over
- +destination addresses, then over individual flows. Good for use on ingress
- +traffic to a LAN from the internet, where it'll prevent any one LAN host from
- +monopolising the downlink, regardless of the number of flows they use.
- +.PP
- +.B triple-isolate
- +(default)
- +.br
- + Flows are defined by the 5-tuple, and fairness is applied over source
- +*and* destination addresses intelligently (ie. not merely by host-pairs), and
- +also over individual flows. Use this if you're not certain whether to use
- +dual-srchost or dual-dsthost; it'll do both jobs at once, preventing any one
- +host on *either* side of the link from monopolising it with a large number of
- +flows.
- +.PP
- +.B nat
- +.br
- + Instructs Cake to perform a NAT lookup before applying flow-isolation
- +rules, to determine the true addresses and port numbers of the packet, to
- +improve fairness between hosts "inside" the NAT. This has no practical effect
- +in "flowblind" or "flows" modes, or if NAT is performed on a different host.
- +.PP
- +.B nonat
- +(default)
- +.br
- + Cake will not perform a NAT lookup. Flow isolation will be performed
- +using the addresses and port numbers directly visible to the interface Cake is
- +attached to.
- +
- +.SH PRIORITY QUEUE PARAMETERS
- +CAKE can divide traffic into "tins" based on the Diffserv field. Each tin has
- +its own independent set of flow-isolation queues, and is serviced based on a WRR
- +algorithm. To avoid perverse Diffserv marking incentives, tin weights have a
- +"priority sharing" value when bandwidth used by that tin is below a threshold,
- +and a lower "bandwidth sharing" value when above. Bandwidth is compared against
- +the threshold using the same algorithm as the deficit-mode shaper.
- +
- +Detailed customisation of tin parameters is not provided. The following presets
- +perform all necessary tuning, relative to the current shaper bandwidth and RTT
- +settings.
- +.PP
- +.B besteffort
- +.br
- + Disables priority queuing by placing all traffic in one tin.
- +.PP
- +.B precedence
- +.br
- + Enables legacy interpretation of TOS "Precedence" field. Use of this
- +preset on the modern Internet is firmly discouraged.
- +.PP
- +.B diffserv4
- +.br
- + Provides a general-purpose Diffserv implementation with four tins:
- +.br
- + Bulk (CS1), 6.25% threshold, generally low priority.
- +.br
- + Best Effort (general), 100% threshold.
- +.br
- + Video (AF4x, AF3x, CS3, AF2x, CS2, TOS4, TOS1), 50% threshold.
- +.br
- + Voice (CS7, CS6, EF, VA, CS5, CS4), 25% threshold.
- +.PP
- +.B diffserv3
- +(default)
- +.br
- + Provides a simple, general-purpose Diffserv implementation with three tins:
- +.br
- + Bulk (CS1), 6.25% threshold, generally low priority.
- +.br
- + Best Effort (general), 100% threshold.
- +.br
- + Voice (CS7, CS6, EF, VA, TOS4), 25% threshold, reduced Codel interval.
- +
- +.SH OTHER PARAMETERS
- +.B memlimit
- +LIMIT
- +.br
- + Limit the memory consumed by Cake to LIMIT bytes. Note that this does
- +not translate directly to queue size (so do not size this based on bandwidth
- +delay product considerations, but rather on worst case acceptable memory
- +consumption), as there is some overhead in the data structures containing the
- +packets, especially for small packets.
- +
- + By default, the limit is calculated based on the bandwidth and RTT
- +settings.
- +
- +.PP
- +.B wash
- +
- +.br
- + Traffic entering your diffserv domain is frequently mis-marked in
- +transit from the perspective of your network, and traffic exiting yours may be
- +mis-marked from the perspective of the transiting provider.
- +
- +Apply the wash option to clear all extra diffserv (but not ECN bits), after
- +priority queuing has taken place.
- +
- +If you are shaping inbound, and cannot trust the diffserv markings (as is the
- +case for Comcast Cable, among others), it is best to use a single queue
- +"besteffort" mode with wash.
- +
- +.SH EXAMPLES
- +# tc qdisc delete root dev eth0
- +.br
- +# tc qdisc add root dev eth0 cake bandwidth 100Mbit ethernet
- +.br
- +# tc -s qdisc show dev eth0
- +.br
- +qdisc cake 1: dev eth0 root refcnt 2 bandwidth 100Mbit diffserv3 triple-isolate rtt 100.0ms noatm overhead 38 mpu 84
- + Sent 0 bytes 0 pkt (dropped 0, overlimits 0 requeues 0)
- + backlog 0b 0p requeues 0
- + memory used: 0b of 5000000b
- + capacity estimate: 100Mbit
- + min/max network layer size: 65535 / 0
- + min/max overhead-adjusted size: 65535 / 0
- + average network hdr offset: 0
- +
- + Bulk Best Effort Voice
- + thresh 6250Kbit 100Mbit 25Mbit
- + target 5.0ms 5.0ms 5.0ms
- + interval 100.0ms 100.0ms 100.0ms
- + pk_delay 0us 0us 0us
- + av_delay 0us 0us 0us
- + sp_delay 0us 0us 0us
- + pkts 0 0 0
- + bytes 0 0 0
- + way_inds 0 0 0
- + way_miss 0 0 0
- + way_cols 0 0 0
- + drops 0 0 0
- + marks 0 0 0
- + ack_drop 0 0 0
- + sp_flows 0 0 0
- + bk_flows 0 0 0
- + un_flows 0 0 0
- + max_len 0 0 0
- + quantum 300 1514 762
- +
- +After some use:
- +.br
- +# tc -s qdisc show dev eth0
- +
- +qdisc cake 1: root refcnt 2 bandwidth 100Mbit diffserv3 triple-isolate rtt 100.0ms noatm overhead 38 mpu 84
- + Sent 44709231 bytes 31931 pkt (dropped 45, overlimits 93782 requeues 0)
- + backlog 33308b 22p requeues 0
- + memory used: 292352b of 5000000b
- + capacity estimate: 100Mbit
- + min/max network layer size: 28 / 1500
- + min/max overhead-adjusted size: 84 / 1538
- + average network hdr offset: 14
- +
- + Bulk Best Effort Voice
- + thresh 6250Kbit 100Mbit 25Mbit
- + target 5.0ms 5.0ms 5.0ms
- + interval 100.0ms 100.0ms 100.0ms
- + pk_delay 8.7ms 6.9ms 5.0ms
- + av_delay 4.9ms 5.3ms 3.8ms
- + sp_delay 727us 1.4ms 511us
- + pkts 2590 21271 8137
- + bytes 3081804 30302659 11426206
- + way_inds 0 46 0
- + way_miss 3 17 4
- + way_cols 0 0 0
- + drops 20 15 10
- + marks 0 0 0
- + ack_drop 0 0 0
- + sp_flows 2 4 1
- + bk_flows 1 2 1
- + un_flows 0 0 0
- + max_len 1514 1514 1514
- + quantum 300 1514 762
- +
- +.SH SEE ALSO
- +.BR tc (8),
- +.BR tc-codel (8),
- +.BR tc-fq_codel (8),
- +.BR tc-red (8)
- +
- +.SH AUTHORS
- +Cake's principal author is Jonathan Morton, with contributions from
- +Tony Ambardar, Kevin Darbyshire-Bryant, Toke Høiland-Jørgensen,
- +Sebastian Moeller, Ryan Mounce, Dean Scarff, Nils Andreas Svee, and Dave Täht.
- +
- +This manual page was written by Loganaden Velvindron. Please report corrections
- +to the Linux Networking mailing list <netdev@vger.kernel.org>.
- --- a/tc/Makefile
- +++ b/tc/Makefile
- @@ -61,6 +61,7 @@ TCMODULES += em_meta.o
- TCMODULES += q_mqprio.o
- TCMODULES += q_codel.o
- TCMODULES += q_fq_codel.o
- +TCMODULES += q_cake.o
- TCMODULES += q_fq.o
- TCMODULES += q_pie.o
- TCMODULES += q_hhf.o
- --- /dev/null
- +++ b/tc/q_cake.c
- @@ -0,0 +1,730 @@
- +/* SPDX-License-Identifier: (GPL-2.0 OR BSD-3-Clause) */
- +/*
- + * Common Applications Kept Enhanced -- CAKE
- + *
- + * Copyright (C) 2014-2018 Jonathan Morton <chromatix99@gmail.com>
- + * Copyright (C) 2017-2018 Toke Høiland-Jørgensen <toke@toke.dk>
- + */
- +
- +#include <stddef.h>
- +#include <stdio.h>
- +#include <stdlib.h>
- +#include <unistd.h>
- +#include <syslog.h>
- +#include <fcntl.h>
- +#include <sys/socket.h>
- +#include <netinet/in.h>
- +#include <arpa/inet.h>
- +#include <string.h>
- +
- +#include "utils.h"
- +#include "tc_util.h"
- +
- +struct cake_preset {
- + char *name;
- + unsigned int target;
- + unsigned int interval;
- +};
- +
- +static struct cake_preset presets[] = {
- + {"datacentre", 5, 100},
- + {"lan", 50, 1000},
- + {"metro", 500, 10000},
- + {"regional", 1500, 30000},
- + {"internet", 5000, 100000},
- + {"oceanic", 15000, 300000},
- + {"satellite", 50000, 1000000},
- + {"interplanetary", 50000000, 1000000000},
- +};
- +
- +
- +static struct cake_preset *find_preset(char *argv)
- +{
- + int i;
- +
- + for (i = 0; i < ARRAY_SIZE(presets); i++)
- + if (!strcmp(argv, presets[i].name))
- + return &presets[i];
- + return NULL;
- +}
- +
- +static void explain(void)
- +{
- + fprintf(stderr,
- +"Usage: ... cake [ bandwidth RATE | unlimited* | autorate-ingress ]\n"
- +" [ rtt TIME | datacentre | lan | metro | regional |\n"
- +" internet* | oceanic | satellite | interplanetary ]\n"
- +" [ besteffort | diffserv8 | diffserv4 | diffserv3* ]\n"
- +" [ flowblind | srchost | dsthost | hosts | flows |\n"
- +" dual-srchost | dual-dsthost | triple-isolate* ]\n"
- +" [ nat | nonat* ]\n"
- +" [ wash | nowash* ]\n"
- +" [ ack-filter | ack-filter-aggressive | no-ack-filter* ]\n"
- +" [ memlimit LIMIT ]\n"
- +" [ ptm | atm | noatm* ] [ overhead N | conservative | raw* ]\n"
- +" [ mpu N ] [ ingress | egress* ]\n"
- +" (* marks defaults)\n");
- +}
- +
- +static int cake_parse_opt(struct qdisc_util *qu, int argc, char **argv,
- + struct nlmsghdr *n, const char *dev)
- +{
- + int unlimited = 0;
- + __u64 bandwidth = 0;
- + unsigned interval = 0;
- + unsigned target = 0;
- + unsigned diffserv = 0;
- + unsigned memlimit = 0;
- + int overhead = 0;
- + bool overhead_set = false;
- + bool overhead_override = false;
- + int mpu = 0;
- + int flowmode = -1;
- + int nat = -1;
- + int atm = -1;
- + int autorate = -1;
- + int wash = -1;
- + int ingress = -1;
- + int ack_filter = -1;
- + struct rtattr *tail;
- + struct cake_preset *preset, *preset_set = NULL;
- +
- + while (argc > 0) {
- + if (strcmp(*argv, "bandwidth") == 0) {
- + NEXT_ARG();
- + if (get_rate64(&bandwidth, *argv)) {
- + fprintf(stderr, "Illegal \"bandwidth\"\n");
- + return -1;
- + }
- + unlimited = 0;
- + autorate = 0;
- + } else if (strcmp(*argv, "unlimited") == 0) {
- + bandwidth = 0;
- + unlimited = 1;
- + autorate = 0;
- + } else if (strcmp(*argv, "autorate-ingress") == 0) {
- + autorate = 1;
- +
- + } else if (strcmp(*argv, "rtt") == 0) {
- + NEXT_ARG();
- + if (get_time(&interval, *argv)) {
- + fprintf(stderr, "Illegal \"rtt\"\n");
- + return -1;
- + }
- + target = interval / 20;
- + if(!target)
- + target = 1;
- + } else if ((preset = find_preset(*argv))) {
- + if (preset_set)
- + duparg(*argv, preset_set->name);
- + preset_set = preset;
- + target = preset->target;
- + interval = preset->interval;
- +
- + } else if (strcmp(*argv, "besteffort") == 0) {
- + diffserv = CAKE_DIFFSERV_BESTEFFORT;
- + } else if (strcmp(*argv, "precedence") == 0) {
- + diffserv = CAKE_DIFFSERV_PRECEDENCE;
- + } else if (strcmp(*argv, "diffserv8") == 0) {
- + diffserv = CAKE_DIFFSERV_DIFFSERV8;
- + } else if (strcmp(*argv, "diffserv4") == 0) {
- + diffserv = CAKE_DIFFSERV_DIFFSERV4;
- + } else if (strcmp(*argv, "diffserv") == 0) {
- + diffserv = CAKE_DIFFSERV_DIFFSERV4;
- + } else if (strcmp(*argv, "diffserv3") == 0) {
- + diffserv = CAKE_DIFFSERV_DIFFSERV3;
- +
- + } else if (strcmp(*argv, "nowash") == 0) {
- + wash = 0;
- + } else if (strcmp(*argv, "wash") == 0) {
- + wash = 1;
- +
- + } else if (strcmp(*argv, "flowblind") == 0) {
- + flowmode = CAKE_FLOW_NONE;
- + } else if (strcmp(*argv, "srchost") == 0) {
- + flowmode = CAKE_FLOW_SRC_IP;
- + } else if (strcmp(*argv, "dsthost") == 0) {
- + flowmode = CAKE_FLOW_DST_IP;
- + } else if (strcmp(*argv, "hosts") == 0) {
- + flowmode = CAKE_FLOW_HOSTS;
- + } else if (strcmp(*argv, "flows") == 0) {
- + flowmode = CAKE_FLOW_FLOWS;
- + } else if (strcmp(*argv, "dual-srchost") == 0) {
- + flowmode = CAKE_FLOW_DUAL_SRC;
- + } else if (strcmp(*argv, "dual-dsthost") == 0) {
- + flowmode = CAKE_FLOW_DUAL_DST;
- + } else if (strcmp(*argv, "triple-isolate") == 0) {
- + flowmode = CAKE_FLOW_TRIPLE;
- +
- + } else if (strcmp(*argv, "nat") == 0) {
- + nat = 1;
- + } else if (strcmp(*argv, "nonat") == 0) {
- + nat = 0;
- +
- + } else if (strcmp(*argv, "ptm") == 0) {
- + atm = CAKE_ATM_PTM;
- + } else if (strcmp(*argv, "atm") == 0) {
- + atm = CAKE_ATM_ATM;
- + } else if (strcmp(*argv, "noatm") == 0) {
- + atm = CAKE_ATM_NONE;
- +
- + } else if (strcmp(*argv, "raw") == 0) {
- + atm = CAKE_ATM_NONE;
- + overhead = 0;
- + overhead_set = true;
- + overhead_override = true;
- + } else if (strcmp(*argv, "conservative") == 0) {
- + /*
- + * Deliberately over-estimate overhead:
- + * one whole ATM cell plus ATM framing.
- + * A safe choice if the actual overhead is unknown.
- + */
- + atm = CAKE_ATM_ATM;
- + overhead = 48;
- + overhead_set = true;
- +
- + /* Various ADSL framing schemes, all over ATM cells */
- + } else if (strcmp(*argv, "ipoa-vcmux") == 0) {
- + atm = CAKE_ATM_ATM;
- + overhead += 8;
- + overhead_set = true;
- + } else if (strcmp(*argv, "ipoa-llcsnap") == 0) {
- + atm = CAKE_ATM_ATM;
- + overhead += 16;
- + overhead_set = true;
- + } else if (strcmp(*argv, "bridged-vcmux") == 0) {
- + atm = CAKE_ATM_ATM;
- + overhead += 24;
- + overhead_set = true;
- + } else if (strcmp(*argv, "bridged-llcsnap") == 0) {
- + atm = CAKE_ATM_ATM;
- + overhead += 32;
- + overhead_set = true;
- + } else if (strcmp(*argv, "pppoa-vcmux") == 0) {
- + atm = CAKE_ATM_ATM;
- + overhead += 10;
- + overhead_set = true;
- + } else if (strcmp(*argv, "pppoa-llc") == 0) {
- + atm = CAKE_ATM_ATM;
- + overhead += 14;
- + overhead_set = true;
- + } else if (strcmp(*argv, "pppoe-vcmux") == 0) {
- + atm = CAKE_ATM_ATM;
- + overhead += 32;
- + overhead_set = true;
- + } else if (strcmp(*argv, "pppoe-llcsnap") == 0) {
- + atm = CAKE_ATM_ATM;
- + overhead += 40;
- + overhead_set = true;
- +
- + /* Typical VDSL2 framing schemes, both over PTM */
- + /* PTM has 64b/65b coding which absorbs some bandwidth */
- + } else if (strcmp(*argv, "pppoe-ptm") == 0) {
- + /* 2B PPP + 6B PPPoE + 6B dest MAC + 6B src MAC
- + * + 2B ethertype + 4B Frame Check Sequence
- + * + 1B Start of Frame (S) + 1B End of Frame (Ck)
- + * + 2B TC-CRC (PTM-FCS) = 30B
- + */
- + atm = CAKE_ATM_PTM;
- + overhead += 30;
- + overhead_set = true;
- + } else if (strcmp(*argv, "bridged-ptm") == 0) {
- + /* 6B dest MAC + 6B src MAC + 2B ethertype
- + * + 4B Frame Check Sequence
- + * + 1B Start of Frame (S) + 1B End of Frame (Ck)
- + * + 2B TC-CRC (PTM-FCS) = 22B
- + */
- + atm = CAKE_ATM_PTM;
- + overhead += 22;
- + overhead_set = true;
- +
- + } else if (strcmp(*argv, "via-ethernet") == 0) {
- + /*
- + * We used to use this flag to manually compensate for
- + * Linux including the Ethernet header on Ethernet-type
- + * interfaces, but not on IP-type interfaces.
- + *
- + * It is no longer needed, because Cake now adjusts for
- + * that automatically, and is thus ignored.
- + *
- + * It would be deleted entirely, but it appears in the
- + * stats output when the automatic compensation is
- + * active.
- + */
- +
- + } else if (strcmp(*argv, "ethernet") == 0) {
- + /* ethernet pre-amble & interframe gap & FCS
- + * you may need to add vlan tag */
- + overhead += 38;
- + overhead_set = true;
- + mpu = 84;
- +
- + /* Additional Ethernet-related overhead used by some ISPs */
- + } else if (strcmp(*argv, "ether-vlan") == 0) {
- + /* 802.1q VLAN tag - may be repeated */
- + overhead += 4;
- + overhead_set = true;
- +
- + /*
- + * DOCSIS cable shapers account for Ethernet frame with FCS,
- + * but not interframe gap or preamble.
- + */
- + } else if (strcmp(*argv, "docsis") == 0) {
- + atm = CAKE_ATM_NONE;
- + overhead += 18;
- + overhead_set = true;
- + mpu = 64;
- +
- + } else if (strcmp(*argv, "overhead") == 0) {
- + char* p = NULL;
- + NEXT_ARG();
- + overhead = strtol(*argv, &p, 10);
- + if(!p || *p || !*argv || overhead < -64 || overhead > 256) {
- + fprintf(stderr, "Illegal \"overhead\", valid range is -64 to 256\\n");
- + return -1;
- + }
- + overhead_set = true;
- +
- + } else if (strcmp(*argv, "mpu") == 0) {
- + char* p = NULL;
- + NEXT_ARG();
- + mpu = strtol(*argv, &p, 10);
- + if(!p || *p || !*argv || mpu < 0 || mpu > 256) {
- + fprintf(stderr, "Illegal \"mpu\", valid range is 0 to 256\\n");
- + return -1;
- + }
- +
- + } else if (strcmp(*argv, "ingress") == 0) {
- + ingress = 1;
- + } else if (strcmp(*argv, "egress") == 0) {
- + ingress = 0;
- +
- + } else if (strcmp(*argv, "no-ack-filter") == 0) {
- + ack_filter = CAKE_ACK_NONE;
- + } else if (strcmp(*argv, "ack-filter") == 0) {
- + ack_filter = CAKE_ACK_FILTER;
- + } else if (strcmp(*argv, "ack-filter-aggressive") == 0) {
- + ack_filter = CAKE_ACK_AGGRESSIVE;
- +
- + } else if (strcmp(*argv, "memlimit") == 0) {
- + NEXT_ARG();
- + if(get_size(&memlimit, *argv)) {
- + fprintf(stderr, "Illegal value for \"memlimit\": \"%s\"\n", *argv);
- + return -1;
- + }
- +
- + } else if (strcmp(*argv, "help") == 0) {
- + explain();
- + return -1;
- + } else {
- + fprintf(stderr, "What is \"%s\"?\n", *argv);
- + explain();
- + return -1;
- + }
- + argc--; argv++;
- + }
- +
- + tail = NLMSG_TAIL(n);
- + addattr_l(n, 1024, TCA_OPTIONS, NULL, 0);
- + if (bandwidth || unlimited)
- + addattr_l(n, 1024, TCA_CAKE_BASE_RATE64, &bandwidth, sizeof(bandwidth));
- + if (diffserv)
- + addattr_l(n, 1024, TCA_CAKE_DIFFSERV_MODE, &diffserv, sizeof(diffserv));
- + if (atm != -1)
- + addattr_l(n, 1024, TCA_CAKE_ATM, &atm, sizeof(atm));
- + if (flowmode != -1)
- + addattr_l(n, 1024, TCA_CAKE_FLOW_MODE, &flowmode, sizeof(flowmode));
- + if (overhead_set)
- + addattr_l(n, 1024, TCA_CAKE_OVERHEAD, &overhead, sizeof(overhead));
- + if (overhead_override) {
- + unsigned zero = 0;
- + addattr_l(n, 1024, TCA_CAKE_RAW, &zero, sizeof(zero));
- + }
- + if (mpu > 0)
- + addattr_l(n, 1024, TCA_CAKE_MPU, &mpu, sizeof(mpu));
- + if (interval)
- + addattr_l(n, 1024, TCA_CAKE_RTT, &interval, sizeof(interval));
- + if (target)
- + addattr_l(n, 1024, TCA_CAKE_TARGET, &target, sizeof(target));
- + if (autorate != -1)
- + addattr_l(n, 1024, TCA_CAKE_AUTORATE, &autorate, sizeof(autorate));
- + if (memlimit)
- + addattr_l(n, 1024, TCA_CAKE_MEMORY, &memlimit, sizeof(memlimit));
- + if (nat != -1)
- + addattr_l(n, 1024, TCA_CAKE_NAT, &nat, sizeof(nat));
- + if (wash != -1)
- + addattr_l(n, 1024, TCA_CAKE_WASH, &wash, sizeof(wash));
- + if (ingress != -1)
- + addattr_l(n, 1024, TCA_CAKE_INGRESS, &ingress, sizeof(ingress));
- + if (ack_filter != -1)
- + addattr_l(n, 1024, TCA_CAKE_ACK_FILTER, &ack_filter, sizeof(ack_filter));
- +
- + tail->rta_len = (void *) NLMSG_TAIL(n) - (void *) tail;
- + return 0;
- +}
- +
- +
- +static int cake_print_opt(struct qdisc_util *qu, FILE *f, struct rtattr *opt)
- +{
- + struct rtattr *tb[TCA_CAKE_MAX + 1];
- + __u64 bandwidth = 0;
- + unsigned diffserv = 0;
- + unsigned flowmode = 0;
- + unsigned interval = 0;
- + unsigned memlimit = 0;
- + int overhead = 0;
- + int raw = 0;
- + int mpu = 0;
- + int atm = 0;
- + int nat = 0;
- + int autorate = 0;
- + int wash = 0;
- + int ingress = 0;
- + int ack_filter = 0;
- + int split_gso = 0;
- + SPRINT_BUF(b1);
- + SPRINT_BUF(b2);
- +
- + if (opt == NULL)
- + return 0;
- +
- + parse_rtattr_nested(tb, TCA_CAKE_MAX, opt);
- +
- + if (tb[TCA_CAKE_BASE_RATE64] &&
- + RTA_PAYLOAD(tb[TCA_CAKE_BASE_RATE64]) >= sizeof(bandwidth)) {
- + bandwidth = rta_getattr_u64(tb[TCA_CAKE_BASE_RATE64]);
- + if(bandwidth) {
- + fprintf(f, "bandwidth %s ", sprint_rate(bandwidth, b1));
- + } else
- + fprintf(f, "unlimited ");
- + }
- + if (tb[TCA_CAKE_AUTORATE] &&
- + RTA_PAYLOAD(tb[TCA_CAKE_AUTORATE]) >= sizeof(__u32)) {
- + autorate = rta_getattr_u32(tb[TCA_CAKE_AUTORATE]);
- + if(autorate == 1)
- + fprintf(f, "ingress");
- + else if(autorate)
- + fprintf(f, "unknown");
- + }
- + if (tb[TCA_CAKE_DIFFSERV_MODE] &&
- + RTA_PAYLOAD(tb[TCA_CAKE_DIFFSERV_MODE]) >= sizeof(__u32)) {
- + diffserv = rta_getattr_u32(tb[TCA_CAKE_DIFFSERV_MODE]);
- + switch(diffserv) {
- + case CAKE_DIFFSERV_DIFFSERV3:
- + fprintf(f, "diffserv3 ");
- + break;
- + case CAKE_DIFFSERV_DIFFSERV4:
- + fprintf(f, "diffserv4 ");
- + break;
- + case CAKE_DIFFSERV_DIFFSERV8:
- + fprintf(f, "diffserv8 ");
- + break;
- + case CAKE_DIFFSERV_BESTEFFORT:
- + fprintf(f, "besteffort ");
- + break;
- + case CAKE_DIFFSERV_PRECEDENCE:
- + fprintf(f, "precedence ");
- + break;
- + default:
- + fprintf(f, "unknown ");
- + break;
- + };
- + }
- + if (tb[TCA_CAKE_FLOW_MODE] &&
- + RTA_PAYLOAD(tb[TCA_CAKE_FLOW_MODE]) >= sizeof(__u32)) {
- + flowmode = rta_getattr_u32(tb[TCA_CAKE_FLOW_MODE]);
- + switch(flowmode) {
- + case CAKE_FLOW_NONE:
- + fprintf(f, "flowblind ");
- + break;
- + case CAKE_FLOW_SRC_IP:
- + fprintf(f, "srchost ");
- + break;
- + case CAKE_FLOW_DST_IP:
- + fprintf(f, "dsthost ");
- + break;
- + case CAKE_FLOW_HOSTS:
- + fprintf(f, "hosts ");
- + break;
- + case CAKE_FLOW_FLOWS:
- + fprintf(f, "flows ");
- + break;
- + case CAKE_FLOW_DUAL_SRC:
- + fprintf(f, "dual-srchost ");
- + break;
- + case CAKE_FLOW_DUAL_DST:
- + fprintf(f, "dual-dsthost ");
- + break;
- + case CAKE_FLOW_TRIPLE:
- + fprintf(f, "triple-isolate ");
- + break;
- + default:
- + fprintf(f, "unknown ");
- + break;
- + };
- +
- + }
- +
- + if (tb[TCA_CAKE_NAT] &&
- + RTA_PAYLOAD(tb[TCA_CAKE_NAT]) >= sizeof(__u32)) {
- + nat = rta_getattr_u32(tb[TCA_CAKE_NAT]);
- + }
- +
- + if(nat)
- + fprintf(f, "nat ");
- +
- + if (tb[TCA_CAKE_WASH] &&
- + RTA_PAYLOAD(tb[TCA_CAKE_WASH]) >= sizeof(__u32)) {
- + wash = rta_getattr_u32(tb[TCA_CAKE_WASH]);
- + }
- + if (tb[TCA_CAKE_ATM] &&
- + RTA_PAYLOAD(tb[TCA_CAKE_ATM]) >= sizeof(__u32)) {
- + atm = rta_getattr_u32(tb[TCA_CAKE_ATM]);
- + }
- + if (tb[TCA_CAKE_OVERHEAD] &&
- + RTA_PAYLOAD(tb[TCA_CAKE_OVERHEAD]) >= sizeof(__s32)) {
- + overhead = *(__s32 *) RTA_DATA(tb[TCA_CAKE_OVERHEAD]);
- + }
- + if (tb[TCA_CAKE_MPU] &&
- + RTA_PAYLOAD(tb[TCA_CAKE_MPU]) >= sizeof(__u32)) {
- + mpu = rta_getattr_u32(tb[TCA_CAKE_MPU]);
- + }
- + if (tb[TCA_CAKE_INGRESS] &&
- + RTA_PAYLOAD(tb[TCA_CAKE_INGRESS]) >= sizeof(__u32)) {
- + ingress = rta_getattr_u32(tb[TCA_CAKE_INGRESS]);
- + }
- + if (tb[TCA_CAKE_ACK_FILTER] &&
- + RTA_PAYLOAD(tb[TCA_CAKE_ACK_FILTER]) >= sizeof(__u32)) {
- + ack_filter = rta_getattr_u32(tb[TCA_CAKE_ACK_FILTER]);
- + }
- + if (tb[TCA_CAKE_SPLIT_GSO] &&
- + RTA_PAYLOAD(tb[TCA_CAKE_SPLIT_GSO]) >= sizeof(__u32)) {
- + split_gso = rta_getattr_u32(tb[TCA_CAKE_SPLIT_GSO]);
- + }
- + if (tb[TCA_CAKE_RAW]) {
- + raw = 1;
- + }
- + if (tb[TCA_CAKE_RTT] &&
- + RTA_PAYLOAD(tb[TCA_CAKE_RTT]) >= sizeof(__u32)) {
- + interval = rta_getattr_u32(tb[TCA_CAKE_RTT]);
- + }
- +
- + if (wash)
- + fprintf(f, "wash ");
- +
- + if (ingress)
- + fprintf(f, "ingress ");
- +
- + if (ack_filter == CAKE_ACK_AGGRESSIVE)
- + fprintf(f, "ack-filter-aggresssive ");
- + else if (ack_filter == CAKE_ACK_FILTER)
- + fprintf(f, "ack-filter ");
- + else
- + fprintf(f, "no-ack-filter ");
- +
- + if (split_gso)
- + fprintf(f, "split-gso ");
- +
- + if (interval)
- + fprintf(f, "rtt %s ", sprint_time(interval, b2));
- +
- + if (raw)
- + fprintf(f, "raw ");
- +
- + if (atm == CAKE_ATM_ATM)
- + fprintf(f, "atm ");
- + else if (atm == CAKE_ATM_PTM)
- + fprintf(f, "ptm ");
- + else if (!raw)
- + fprintf(f, "noatm ");
- +
- + fprintf(f, "overhead %d ", overhead);
- +
- + if (mpu)
- + fprintf(f, "mpu %u ", mpu);
- +
- + if (memlimit) {
- + fprintf(f, "memlimit %s", sprint_size(memlimit, b1));
- + }
- +
- + return 0;
- +}
- +
- +static int cake_print_xstats(struct qdisc_util *qu, FILE *f,
- + struct rtattr *xstats)
- +{
- + SPRINT_BUF(b1);
- + struct rtattr *st[TCA_CAKE_STATS_MAX + 1];
- + int i;
- +
- + if (xstats == NULL)
- + return 0;
- +
- +#define GET_STAT_U32(attr) rta_getattr_u32(st[TCA_CAKE_STATS_ ## attr])
- +#define GET_STAT_S32(attr) (*(__s32*)RTA_DATA(st[TCA_CAKE_STATS_ ## attr]))
- +#define GET_STAT_U64(attr) rta_getattr_u64(st[TCA_CAKE_STATS_ ## attr])
- +
- + parse_rtattr_nested(st, TCA_CAKE_STATS_MAX, xstats);
- +
- + if (st[TCA_CAKE_STATS_MEMORY_USED] &&
- + st[TCA_CAKE_STATS_MEMORY_LIMIT]) {
- + fprintf(f, " memory used: %s",
- + sprint_size(GET_STAT_U32(MEMORY_USED), b1));
- +
- + fprintf(f, " of %s\n",
- + sprint_size(GET_STAT_U32(MEMORY_LIMIT), b1));
- + }
- +
- + if (st[TCA_CAKE_STATS_CAPACITY_ESTIMATE64]) {
- + fprintf(f, " capacity estimate: %s\n",
- + sprint_rate(GET_STAT_U64(CAPACITY_ESTIMATE64), b1));
- + }
- +
- + if (st[TCA_CAKE_STATS_MIN_NETLEN] &&
- + st[TCA_CAKE_STATS_MAX_NETLEN]) {
- + fprintf(f, " min/max network layer size: %8u",
- + GET_STAT_U32(MIN_NETLEN));
- + fprintf(f, " /%8u\n", GET_STAT_U32(MAX_NETLEN));
- + }
- +
- + if (st[TCA_CAKE_STATS_MIN_ADJLEN] &&
- + st[TCA_CAKE_STATS_MAX_ADJLEN]) {
- + fprintf(f, " min/max overhead-adjusted size: %8u",
- + GET_STAT_U32(MIN_ADJLEN));
- + fprintf(f, " /%8u\n", GET_STAT_U32(MAX_ADJLEN));
- + }
- +
- + if (st[TCA_CAKE_STATS_AVG_NETOFF])
- + fprintf(f, " average network hdr offset: %8u\n\n",
- + GET_STAT_U32(AVG_NETOFF));
- +
- + /* class stats */
- + if (st[TCA_CAKE_STATS_DEFICIT])
- + fprintf(f, "deficit %u",
- + GET_STAT_S32(DEFICIT));
- + if (st[TCA_CAKE_STATS_COBALT_COUNT])
- + fprintf(f, "count %u",
- + GET_STAT_U32(COBALT_COUNT));
- +
- + if (st[TCA_CAKE_STATS_DROPPING] && GET_STAT_U32(DROPPING)) {
- + fprintf(f, " dropping");
- + if (st[TCA_CAKE_STATS_DROP_NEXT_US]) {
- + int drop_next = GET_STAT_S32(DROP_NEXT_US);
- + if (drop_next < 0) {
- + fprintf(f, " drop_next -%s",
- + sprint_time(drop_next, b1));
- + } else {
- + fprintf(f, " drop_next %s",
- + sprint_time(drop_next, b1));
- + }
- + }
- + }
- +
- + if (st[TCA_CAKE_STATS_P_DROP]) {
- + fprintf(f, " blue_prob %u",
- + GET_STAT_U32(P_DROP));
- + if (st[TCA_CAKE_STATS_BLUE_TIMER_US]) {
- + int blue_timer = GET_STAT_S32(BLUE_TIMER_US);
- + if (blue_timer < 0) {
- + fprintf(f, " blue_timer -%s",
- + sprint_time(blue_timer, b1));
- + } else {
- + fprintf(f, " blue_timer %s",
- + sprint_time(blue_timer, b1));
- + }
- + }
- + }
- +
- +#undef GET_STAT_U32
- +#undef GET_STAT_S32
- +#undef GET_STAT_U64
- +
- + if (st[TCA_CAKE_STATS_TIN_STATS]) {
- + struct rtattr *tins[TC_CAKE_MAX_TINS + 1];
- + struct rtattr *tstat[TC_CAKE_MAX_TINS][TCA_CAKE_TIN_STATS_MAX + 1];
- + int num_tins = 0;
- +
- + parse_rtattr_nested(tins, TC_CAKE_MAX_TINS, st[TCA_CAKE_STATS_TIN_STATS]);
- +
- + for (i = 1; i <= TC_CAKE_MAX_TINS && tins[i]; i++) {
- + parse_rtattr_nested(tstat[i-1], TCA_CAKE_TIN_STATS_MAX, tins[i]);
- + num_tins++;
- + }
- +
- + if (!num_tins)
- + return 0;
- +
- + switch(num_tins) {
- + case 3:
- + fprintf(f, " Bulk Best Effort Voice\n");
- + break;
- +
- + case 4:
- + fprintf(f, " Bulk Best Effort Video Voice\n");
- + break;
- +
- + default:
- + fprintf(f, " ");
- + for(i=0; i < num_tins; i++)
- + fprintf(f, " Tin %u", i);
- + fprintf(f, "\n");
- + };
- +
- +#define GET_TSTAT(i, attr) (tstat[i][TCA_CAKE_TIN_STATS_ ## attr])
- +#define PRINT_TSTAT(name, attr, fmts, val) do { \
- + if (GET_TSTAT(0, attr)) { \
- + fprintf(f, name); \
- + for (i = 0; i < num_tins; i++) \
- + fprintf(f, " %12" fmts, val); \
- + fprintf(f, "\n"); \
- + } \
- + } while (0)
- +
- +#define SPRINT_TSTAT(pfunc, type, name, attr) PRINT_TSTAT( \
- + name, attr, "s", sprint_ ## pfunc( \
- + rta_getattr_ ## type(GET_TSTAT(i, attr)), b1))
- +
- +#define PRINT_TSTAT_U32(name, attr) PRINT_TSTAT( \
- + name, attr, "u", rta_getattr_u32(GET_TSTAT(i, attr)))
- +
- +#define PRINT_TSTAT_U64(name, attr) PRINT_TSTAT( \
- + name, attr, "llu", rta_getattr_u64(GET_TSTAT(i, attr)))
- +
- + SPRINT_TSTAT(rate, u64, " thresh ", THRESHOLD_RATE64);
- + SPRINT_TSTAT(time, u32, " target ", TARGET_US);
- + SPRINT_TSTAT(time, u32, " interval", INTERVAL_US);
- + SPRINT_TSTAT(time, u32, " pk_delay", PEAK_DELAY_US);
- + SPRINT_TSTAT(time, u32, " av_delay", AVG_DELAY_US);
- + SPRINT_TSTAT(time, u32, " sp_delay", BASE_DELAY_US);
- + SPRINT_TSTAT(size, u32, " backlog ", BACKLOG_BYTES);
- +
- + PRINT_TSTAT_U32(" pkts ", SENT_PACKETS);
- + PRINT_TSTAT_U64(" bytes ", SENT_BYTES64);
- +
- + PRINT_TSTAT_U32(" way_inds", WAY_INDIRECT_HITS);
- + PRINT_TSTAT_U32(" way_miss", WAY_MISSES);
- + PRINT_TSTAT_U32(" way_cols", WAY_COLLISIONS);
- + PRINT_TSTAT_U32(" drops ", DROPPED_PACKETS);
- + PRINT_TSTAT_U32(" marks ", ECN_MARKED_PACKETS);
- + PRINT_TSTAT_U32(" ack_drop", ACKS_DROPPED_PACKETS);
- + PRINT_TSTAT_U32(" sp_flows", SPARSE_FLOWS);
- + PRINT_TSTAT_U32(" bk_flows", BULK_FLOWS);
- + PRINT_TSTAT_U32(" un_flows", UNRESPONSIVE_FLOWS);
- + PRINT_TSTAT_U32(" max_len ", MAX_SKBLEN);
- + PRINT_TSTAT_U32(" quantum ", FLOW_QUANTUM);
- +
- +#undef GET_STAT
- +#undef PRINT_TSTAT
- +#undef SPRINT_TSTAT
- +#undef PRINT_TSTAT_U32
- +#undef PRINT_TSTAT_U64
- + }
- + return 0;
- +}
- +
- +struct qdisc_util cake_qdisc_util = {
- + .id = "cake",
- + .parse_qopt = cake_parse_opt,
- + .print_qopt = cake_print_opt,
- + .print_xstats = cake_print_xstats,
- +};
|