dcb-pfc(8)

1DCB-PFC(8)                           Linux                          DCB-PFC(8)
2
3
4

NAME

6       dcb-pfc  - show / manipulate PFC (Priority-based Flow Control) settings
7       of the DCB (Data Center Bridging) subsystem
8

SYNOPSIS

10       dcb [ OPTIONS ] pfc { COMMAND | help }
11
12
13       dcb pfc show dev DEV [ pfc-cap ] [ prio-pfc ] [ macsec-bypass ] [ delay
14               ] [ requests ] [ indications ]
15
16       dcb pfc set dev DEV [ prio-pfc PFC-MAP ] [ macsec-bypass { on | off } ]
17               [ delay INTEGER ]
18
19       PFC-MAP := [ PFC-MAP ] PFC-MAPPING
20
21       PFC-MAPPING := { PRIO | all }:{ on | off }
22
23       PRIO := { 0 .. 7 }
24
25

DESCRIPTION

27       dcb pfc is used to configure Priority-based Flow Control attributes
28       through Linux DCB (Data Center Bridging) interface. PFC permits marking
29       flows with a certain priority as lossless, and holds related configura‐
30       tion, as well as PFC counters.
31
32

PARAMETERS

34       For read-write parameters, the following describes only the write di‐
35       rection, i.e. as used with the set command. For the show command, the
36       parameter name is to be used as a simple keyword without further argu‐
37       ments. This instructs the tool to show the value of a given parameter.
38       When no parameters are given, the tool shows the complete PFC configu‐
39       ration.
40
41
42       pfc-cap
43              A read-only property that shows the number of traffic classes
44              that may simultaneously support PFC.
45
46
47       requests
48              A read-only count of the sent PFC frames per traffic class. Only
49              shown when -s is given, or when requested explicitly.
50
51
52       indications
53              A read-only count of the received PFC frames per traffic class.
54              Only shown when -s is given, or when requested explicitly.
55
56
57       macsec-bypass { on | off }
58              Whether the sending station is capable of bypassing MACsec pro‐
59              cessing when MACsec is disabled.
60
61
62       prio-pfc PFC-MAP
63              PFC-MAP uses the array parameter syntax, see dcb(8) for details.
64              Keys are priorities, values are on / off indicators of whether
65              PFC is enabled for a given priority.
66
67
68       delay INTEGER
69              The allowance made for round-trip propagation delay of the link
70              in bits.  The value shall be 0..65535.
71
72

EXAMPLE & USAGE

74       Enable PFC on priorities 6 and 7, leaving the rest intact:
75
76
77       # dcb pfc set dev eth0 prio-pfc 6:on 7:on
78
79       Disable PFC of all priorities except 6 and 7, and configure delay to
80       4096 bits:
81
82
83       # dcb pfc set dev eth0 prio-pfc all:off 6:on 7:on delay 0x1000
84
85       Show what was set:
86
87
88       # dcb pfc show dev eth0
89       pfc-cap 8 macsec-bypass off delay 4096
90       prio-pfc 0:off 1:off 2:off 3:off 4:off 5:off 6:on 7:on
91
92

EXIT STATUS

94       Exit status is 0 if command was successful or a positive integer upon
95       failure.
96
97

REPORTING BUGS

103       Report any bugs to the Network Developers mailing list <net‐
104       dev@vger.kernel.org> where the development and maintenance is primarily
105       done.  You do not have to be subscribed to the list to send a message
106       there.
107
108

AUTHOR

110       Petr Machata <me@pmachata.org>
111
112
113
114iproute2                        31 October 2020                     DCB-PFC(8)