Debian Codegraph @

upstream/debian-unstable/man8/tc-bfifo.8

raw
1 .TH PBFIFO 8 "10 January 2002" "iproute2" "Linux"
2 .SH NAME
3 pfifo \- Packet limited First In, First Out queue
4 .P
5 bfifo \- Byte limited First In, First Out queue
6
7 .SH SYNOPSIS
8 .B tc qdisc ... add pfifo
9 .B [ limit
10 packets
11 .B ]
12 .P
13 .B tc qdisc ... add bfifo
14 .B [ limit
15 bytes
16 .B ]
17
18 .SH DESCRIPTION
19 The pfifo and bfifo qdiscs are unadorned First In, First Out queues. They are the
20 simplest queues possible and therefore have no overhead.
21 .B pfifo
22 constrains the queue size as measured in packets.
23 .B bfifo
24 does so as measured in bytes.
25
26 Like all non-default qdiscs, they maintain statistics. This might be a reason to prefer
27 pfifo or bfifo over the default.
28
29 .SH ALGORITHM
30 A list of packets is maintained, when a packet is enqueued it gets inserted at the tail of
31 a list. When a packet needs to be sent out to the network, it is taken from the head of the list.
32
33 If the list is too long, no further packets are allowed on. This is called 'tail drop'.
34
35 .SH PARAMETERS
36 .TP
37 limit
38 Maximum queue size. Specified in bytes for bfifo, in packets for pfifo. For pfifo, defaults
39 to the interface txqueuelen, as specified with
40 .BR ip (8).
41 The range for this parameter is [0, UINT32_MAX].
42
43 For bfifo, it defaults to the txqueuelen multiplied by the interface MTU.
44 The range for this parameter is [0, UINT32_MAX] bytes.
45
46 Note: The link layer header was considered when counting packets length.
47
48 .SH OUTPUT
49 The output of
50 .B tc -s qdisc ls
51 contains the limit, either in packets or in bytes, and the number of bytes
52 and packets actually sent. An unsent and dropped packet only appears between braces
53 and is not counted as 'Sent'.
54
55 In this example, the queue length is 100 packets, 45894 bytes were sent over 681 packets.
56 No packets were dropped, and as the pfifo queue does not slow down packets, there were also no
57 overlimits:
58 .P
59 .nf
60 # tc -s qdisc ls dev eth0
61 qdisc pfifo 8001: dev eth0 limit 100p
62 Sent 45894 bytes 681 pkts (dropped 0, overlimits 0)
63 .fi
64
65 If a backlog occurs, this is displayed as well.
66 .SH SEE ALSO
67 .BR tc (8)
68
69 .SH AUTHORS
70 Alexey N. Kuznetsov, <[email protected]>
71
72 This manpage maintained by bert hubert <[email protected]>