xref: /linux-6.15/include/linux/if_link.h (revision c145211d)
1 #ifndef _LINUX_IF_LINK_H
2 #define _LINUX_IF_LINK_H
3 
4 #include <linux/types.h>
5 #include <linux/netlink.h>
6 
7 /* The struct should be in sync with struct net_device_stats */
8 struct rtnl_link_stats {
9 	__u32	rx_packets;		/* total packets received	*/
10 	__u32	tx_packets;		/* total packets transmitted	*/
11 	__u32	rx_bytes;		/* total bytes received 	*/
12 	__u32	tx_bytes;		/* total bytes transmitted	*/
13 	__u32	rx_errors;		/* bad packets received		*/
14 	__u32	tx_errors;		/* packet transmit problems	*/
15 	__u32	rx_dropped;		/* no space in linux buffers	*/
16 	__u32	tx_dropped;		/* no space available in linux	*/
17 	__u32	multicast;		/* multicast packets received	*/
18 	__u32	collisions;
19 
20 	/* detailed rx_errors: */
21 	__u32	rx_length_errors;
22 	__u32	rx_over_errors;		/* receiver ring buff overflow	*/
23 	__u32	rx_crc_errors;		/* recved pkt with crc error	*/
24 	__u32	rx_frame_errors;	/* recv'd frame alignment error */
25 	__u32	rx_fifo_errors;		/* recv'r fifo overrun		*/
26 	__u32	rx_missed_errors;	/* receiver missed packet	*/
27 
28 	/* detailed tx_errors */
29 	__u32	tx_aborted_errors;
30 	__u32	tx_carrier_errors;
31 	__u32	tx_fifo_errors;
32 	__u32	tx_heartbeat_errors;
33 	__u32	tx_window_errors;
34 
35 	/* for cslip etc */
36 	__u32	rx_compressed;
37 	__u32	tx_compressed;
38 };
39 
40 /* The struct should be in sync with struct ifmap */
41 struct rtnl_link_ifmap {
42 	__u64	mem_start;
43 	__u64	mem_end;
44 	__u64	base_addr;
45 	__u16	irq;
46 	__u8	dma;
47 	__u8	port;
48 };
49 
50 enum {
51 	IFLA_UNSPEC,
52 	IFLA_ADDRESS,
53 	IFLA_BROADCAST,
54 	IFLA_IFNAME,
55 	IFLA_MTU,
56 	IFLA_LINK,
57 	IFLA_QDISC,
58 	IFLA_STATS,
59 	IFLA_COST,
60 #define IFLA_COST IFLA_COST
61 	IFLA_PRIORITY,
62 #define IFLA_PRIORITY IFLA_PRIORITY
63 	IFLA_MASTER,
64 #define IFLA_MASTER IFLA_MASTER
65 	IFLA_WIRELESS,		/* Wireless Extension event - see wireless.h */
66 #define IFLA_WIRELESS IFLA_WIRELESS
67 	IFLA_PROTINFO,		/* Protocol specific information for a link */
68 #define IFLA_PROTINFO IFLA_PROTINFO
69 	IFLA_TXQLEN,
70 #define IFLA_TXQLEN IFLA_TXQLEN
71 	IFLA_MAP,
72 #define IFLA_MAP IFLA_MAP
73 	IFLA_WEIGHT,
74 #define IFLA_WEIGHT IFLA_WEIGHT
75 	IFLA_OPERSTATE,
76 	IFLA_LINKMODE,
77 	IFLA_LINKINFO,
78 #define IFLA_LINKINFO IFLA_LINKINFO
79 	IFLA_NET_NS_PID,
80 	IFLA_IFALIAS,
81 	IFLA_NUM_VF,		/* Number of VFs if device is SR-IOV PF */
82 	IFLA_VFINFO_LIST,
83 	__IFLA_MAX
84 };
85 
86 
87 #define IFLA_MAX (__IFLA_MAX - 1)
88 
89 /* backwards compatibility for userspace */
90 #ifndef __KERNEL__
91 #define IFLA_RTA(r)  ((struct rtattr*)(((char*)(r)) + NLMSG_ALIGN(sizeof(struct ifinfomsg))))
92 #define IFLA_PAYLOAD(n) NLMSG_PAYLOAD(n,sizeof(struct ifinfomsg))
93 #endif
94 
95 /* ifi_flags.
96 
97    IFF_* flags.
98 
99    The only change is:
100    IFF_LOOPBACK, IFF_BROADCAST and IFF_POINTOPOINT are
101    more not changeable by user. They describe link media
102    characteristics and set by device driver.
103 
104    Comments:
105    - Combination IFF_BROADCAST|IFF_POINTOPOINT is invalid
106    - If neither of these three flags are set;
107      the interface is NBMA.
108 
109    - IFF_MULTICAST does not mean anything special:
110    multicasts can be used on all not-NBMA links.
111    IFF_MULTICAST means that this media uses special encapsulation
112    for multicast frames. Apparently, all IFF_POINTOPOINT and
113    IFF_BROADCAST devices are able to use multicasts too.
114  */
115 
116 /* IFLA_LINK.
117    For usual devices it is equal ifi_index.
118    If it is a "virtual interface" (f.e. tunnel), ifi_link
119    can point to real physical interface (f.e. for bandwidth calculations),
120    or maybe 0, what means, that real media is unknown (usual
121    for IPIP tunnels, when route to endpoint is allowed to change)
122  */
123 
124 /* Subtype attributes for IFLA_PROTINFO */
125 enum {
126 	IFLA_INET6_UNSPEC,
127 	IFLA_INET6_FLAGS,	/* link flags			*/
128 	IFLA_INET6_CONF,	/* sysctl parameters		*/
129 	IFLA_INET6_STATS,	/* statistics			*/
130 	IFLA_INET6_MCAST,	/* MC things. What of them?	*/
131 	IFLA_INET6_CACHEINFO,	/* time values and max reasm size */
132 	IFLA_INET6_ICMP6STATS,	/* statistics (icmpv6)		*/
133 	__IFLA_INET6_MAX
134 };
135 
136 #define IFLA_INET6_MAX	(__IFLA_INET6_MAX - 1)
137 
138 struct ifla_cacheinfo {
139 	__u32	max_reasm_len;
140 	__u32	tstamp;		/* ipv6InterfaceTable updated timestamp */
141 	__u32	reachable_time;
142 	__u32	retrans_time;
143 };
144 
145 enum {
146 	IFLA_INFO_UNSPEC,
147 	IFLA_INFO_KIND,
148 	IFLA_INFO_DATA,
149 	IFLA_INFO_XSTATS,
150 	__IFLA_INFO_MAX,
151 };
152 
153 #define IFLA_INFO_MAX	(__IFLA_INFO_MAX - 1)
154 
155 /* VLAN section */
156 
157 enum {
158 	IFLA_VLAN_UNSPEC,
159 	IFLA_VLAN_ID,
160 	IFLA_VLAN_FLAGS,
161 	IFLA_VLAN_EGRESS_QOS,
162 	IFLA_VLAN_INGRESS_QOS,
163 	__IFLA_VLAN_MAX,
164 };
165 
166 #define IFLA_VLAN_MAX	(__IFLA_VLAN_MAX - 1)
167 
168 struct ifla_vlan_flags {
169 	__u32	flags;
170 	__u32	mask;
171 };
172 
173 enum {
174 	IFLA_VLAN_QOS_UNSPEC,
175 	IFLA_VLAN_QOS_MAPPING,
176 	__IFLA_VLAN_QOS_MAX
177 };
178 
179 #define IFLA_VLAN_QOS_MAX	(__IFLA_VLAN_QOS_MAX - 1)
180 
181 struct ifla_vlan_qos_mapping {
182 	__u32 from;
183 	__u32 to;
184 };
185 
186 /* MACVLAN section */
187 enum {
188 	IFLA_MACVLAN_UNSPEC,
189 	IFLA_MACVLAN_MODE,
190 	__IFLA_MACVLAN_MAX,
191 };
192 
193 #define IFLA_MACVLAN_MAX (__IFLA_MACVLAN_MAX - 1)
194 
195 enum macvlan_mode {
196 	MACVLAN_MODE_PRIVATE = 1, /* don't talk to other macvlans */
197 	MACVLAN_MODE_VEPA    = 2, /* talk to other ports through ext bridge */
198 	MACVLAN_MODE_BRIDGE  = 4, /* talk to bridge ports directly */
199 };
200 
201 /* SR-IOV virtual function managment section */
202 
203 enum {
204 	IFLA_VF_INFO_UNSPEC,
205 	IFLA_VF_INFO,
206 	__IFLA_VF_INFO_MAX,
207 };
208 
209 #define IFLA_VF_INFO_MAX (__IFLA_VF_INFO_MAX - 1)
210 
211 enum {
212 	IFLA_VF_UNSPEC,
213 	IFLA_VF_MAC,		/* Hardware queue specific attributes */
214 	IFLA_VF_VLAN,
215 	IFLA_VF_TX_RATE,	/* TX Bandwidth Allocation */
216 	__IFLA_VF_MAX,
217 };
218 
219 #define IFLA_VF_MAX (__IFLA_VF_MAX - 1)
220 
221 struct ifla_vf_mac {
222 	__u32 vf;
223 	__u8 mac[32]; /* MAX_ADDR_LEN */
224 };
225 
226 struct ifla_vf_vlan {
227 	__u32 vf;
228 	__u32 vlan; /* 0 - 4095, 0 disables VLAN filter */
229 	__u32 qos;
230 };
231 
232 struct ifla_vf_tx_rate {
233 	__u32 vf;
234 	__u32 rate; /* Max TX bandwidth in Mbps, 0 disables throttling */
235 };
236 
237 struct ifla_vf_info {
238 	__u32 vf;
239 	__u8 mac[32];
240 	__u32 vlan;
241 	__u32 qos;
242 	__u32 tx_rate;
243 };
244 #endif /* _LINUX_IF_LINK_H */
245