1 // SPDX-License-Identifier: GPL-2.0-or-later
3 * INET An implementation of the TCP/IP protocol suite for the LINUX
4 * operating system. INET is implemented using the BSD Socket
5 * interface as the means of communication with the user level.
7 * The Internet Protocol (IP) module.
10 * Fred N. van Kempen, <waltje@uWalt.NL.Mugnet.ORG>
11 * Donald Becker, <becker@super.org>
12 * Alan Cox, <alan@lxorguk.ukuu.org.uk>
14 * Stefan Becker, <stefanb@yello.ping.de>
15 * Jorge Cwik, <jorge@laser.satlink.net>
16 * Arnt Gulbrandsen, <agulbra@nvg.unit.no>
19 * Alan Cox : Commented a couple of minor bits of surplus code
20 * Alan Cox : Undefining IP_FORWARD doesn't include the code
21 * (just stops a compiler warning).
22 * Alan Cox : Frames with >=MAX_ROUTE record routes, strict routes or loose routes
23 * are junked rather than corrupting things.
24 * Alan Cox : Frames to bad broadcast subnets are dumped
25 * We used to process them non broadcast and
26 * boy could that cause havoc.
27 * Alan Cox : ip_forward sets the free flag on the
28 * new frame it queues. Still crap because
29 * it copies the frame but at least it
30 * doesn't eat memory too.
31 * Alan Cox : Generic queue code and memory fixes.
32 * Fred Van Kempen : IP fragment support (borrowed from NET2E)
33 * Gerhard Koerting: Forward fragmented frames correctly.
34 * Gerhard Koerting: Fixes to my fix of the above 8-).
35 * Gerhard Koerting: IP interface addressing fix.
36 * Linus Torvalds : More robustness checks
37 * Alan Cox : Even more checks: Still not as robust as it ought to be
38 * Alan Cox : Save IP header pointer for later
39 * Alan Cox : ip option setting
40 * Alan Cox : Use ip_tos/ip_ttl settings
41 * Alan Cox : Fragmentation bogosity removed
42 * (Thanks to Mark.Bush@prg.ox.ac.uk)
43 * Dmitry Gorodchanin : Send of a raw packet crash fix.
44 * Alan Cox : Silly ip bug when an overlength
45 * fragment turns up. Now frees the
47 * Linus Torvalds/ : Memory leakage on fragmentation
48 * Alan Cox : handling.
49 * Gerhard Koerting: Forwarding uses IP priority hints
50 * Teemu Rantanen : Fragment problems.
51 * Alan Cox : General cleanup, comments and reformat
52 * Alan Cox : SNMP statistics
53 * Alan Cox : BSD address rule semantics. Also see
54 * UDP as there is a nasty checksum issue
55 * if you do things the wrong way.
56 * Alan Cox : Always defrag, moved IP_FORWARD to the config.in file
57 * Alan Cox : IP options adjust sk->priority.
58 * Pedro Roque : Fix mtu/length error in ip_forward.
59 * Alan Cox : Avoid ip_chk_addr when possible.
60 * Richard Underwood : IP multicasting.
61 * Alan Cox : Cleaned up multicast handlers.
62 * Alan Cox : RAW sockets demultiplex in the BSD style.
63 * Gunther Mayer : Fix the SNMP reporting typo
64 * Alan Cox : Always in group 224.0.0.1
65 * Pauline Middelink : Fast ip_checksum update when forwarding
66 * Masquerading support.
67 * Alan Cox : Multicast loopback error for 224.0.0.1
68 * Alan Cox : IP_MULTICAST_LOOP option.
69 * Alan Cox : Use notifiers.
70 * Bjorn Ekwall : Removed ip_csum (from slhc.c too)
71 * Bjorn Ekwall : Moved ip_fast_csum to ip.h (inline!)
72 * Stefan Becker : Send out ICMP HOST REDIRECT
73 * Arnt Gulbrandsen : ip_build_xmit
74 * Alan Cox : Per socket routing cache
75 * Alan Cox : Fixed routing cache, added header cache.
76 * Alan Cox : Loopback didn't work right in original ip_build_xmit - fixed it.
77 * Alan Cox : Only send ICMP_REDIRECT if src/dest are the same net.
78 * Alan Cox : Incoming IP option handling.
79 * Alan Cox : Set saddr on raw output frames as per BSD.
80 * Alan Cox : Stopped broadcast source route explosions.
81 * Alan Cox : Can disable source routing
82 * Takeshi Sone : Masquerading didn't work.
83 * Dave Bonn,Alan Cox : Faster IP forwarding whenever possible.
84 * Alan Cox : Memory leaks, tramples, misc debugging.
85 * Alan Cox : Fixed multicast (by popular demand 8))
86 * Alan Cox : Fixed forwarding (by even more popular demand 8))
87 * Alan Cox : Fixed SNMP statistics [I think]
88 * Gerhard Koerting : IP fragmentation forwarding fix
89 * Alan Cox : Device lock against page fault.
90 * Alan Cox : IP_HDRINCL facility.
91 * Werner Almesberger : Zero fragment bug
92 * Alan Cox : RAW IP frame length bug
93 * Alan Cox : Outgoing firewall on build_xmit
94 * A.N.Kuznetsov : IP_OPTIONS support throughout the kernel
95 * Alan Cox : Multicast routing hooks
96 * Jos Vos : Do accounting *before* call_in_firewall
97 * Willy Konynenberg : Transparent proxying support
100 * IP fragmentation wants rewriting cleanly. The RFC815 algorithm is much more efficient
101 * and could be made very efficient with the addition of some virtual memory hacks to permit
102 * the allocation of a buffer that can then be 'grown' by twiddling page tables.
103 * Output fragmentation wants updating along with the buffer management to use a single
104 * interleaved copy algorithm so that fragmenting has a one copy overhead. Actual packet
105 * output should probably do its own fragmentation at the UDP/RAW layer. TCP shouldn't cause
106 * fragmentation anyway.
109 #define pr_fmt(fmt) "IPv4: " fmt
111 #include <linux/module.h>
112 #include <linux/types.h>
113 #include <linux/kernel.h>
114 #include <linux/string.h>
115 #include <linux/errno.h>
116 #include <linux/slab.h>
118 #include <linux/net.h>
119 #include <linux/socket.h>
120 #include <linux/sockios.h>
121 #include <linux/in.h>
122 #include <linux/inet.h>
123 #include <linux/inetdevice.h>
124 #include <linux/netdevice.h>
125 #include <linux/etherdevice.h>
126 #include <linux/indirect_call_wrapper.h>
128 #include <net/snmp.h>
130 #include <net/protocol.h>
131 #include <net/route.h>
132 #include <linux/skbuff.h>
133 #include <net/sock.h>
135 #include <net/icmp.h>
137 #include <net/checksum.h>
138 #include <net/inet_ecn.h>
139 #include <linux/netfilter_ipv4.h>
140 #include <net/xfrm.h>
141 #include <linux/mroute.h>
142 #include <linux/netlink.h>
143 #include <net/dst_metadata.h>
146 * Process Router Attention IP option (RFC 2113)
148 bool ip_call_ra_chain(struct sk_buff
*skb
)
150 struct ip_ra_chain
*ra
;
151 u8 protocol
= ip_hdr(skb
)->protocol
;
152 struct sock
*last
= NULL
;
153 struct net_device
*dev
= skb
->dev
;
154 struct net
*net
= dev_net(dev
);
156 for (ra
= rcu_dereference(net
->ipv4
.ra_chain
); ra
; ra
= rcu_dereference(ra
->next
)) {
157 struct sock
*sk
= ra
->sk
;
159 /* If socket is bound to an interface, only report
160 * the packet if it came from that interface.
162 if (sk
&& inet_sk(sk
)->inet_num
== protocol
&&
163 (!sk
->sk_bound_dev_if
||
164 sk
->sk_bound_dev_if
== dev
->ifindex
)) {
165 if (ip_is_fragment(ip_hdr(skb
))) {
166 if (ip_defrag(net
, skb
, IP_DEFRAG_CALL_RA_CHAIN
))
170 struct sk_buff
*skb2
= skb_clone(skb
, GFP_ATOMIC
);
185 INDIRECT_CALLABLE_DECLARE(int udp_rcv(struct sk_buff
*));
186 INDIRECT_CALLABLE_DECLARE(int tcp_v4_rcv(struct sk_buff
*));
187 void ip_protocol_deliver_rcu(struct net
*net
, struct sk_buff
*skb
, int protocol
)
189 const struct net_protocol
*ipprot
;
193 raw
= raw_local_deliver(skb
, protocol
);
195 ipprot
= rcu_dereference(inet_protos
[protocol
]);
197 if (!ipprot
->no_policy
) {
198 if (!xfrm4_policy_check(NULL
, XFRM_POLICY_IN
, skb
)) {
204 ret
= INDIRECT_CALL_2(ipprot
->handler
, tcp_v4_rcv
, udp_rcv
,
210 __IP_INC_STATS(net
, IPSTATS_MIB_INDELIVERS
);
213 if (xfrm4_policy_check(NULL
, XFRM_POLICY_IN
, skb
)) {
214 __IP_INC_STATS(net
, IPSTATS_MIB_INUNKNOWNPROTOS
);
215 icmp_send(skb
, ICMP_DEST_UNREACH
,
216 ICMP_PROT_UNREACH
, 0);
220 __IP_INC_STATS(net
, IPSTATS_MIB_INDELIVERS
);
226 static int ip_local_deliver_finish(struct net
*net
, struct sock
*sk
, struct sk_buff
*skb
)
228 __skb_pull(skb
, skb_network_header_len(skb
));
231 ip_protocol_deliver_rcu(net
, skb
, ip_hdr(skb
)->protocol
);
238 * Deliver IP Packets to the higher protocol layers.
240 int ip_local_deliver(struct sk_buff
*skb
)
243 * Reassemble IP fragments.
245 struct net
*net
= dev_net(skb
->dev
);
247 if (ip_is_fragment(ip_hdr(skb
))) {
248 if (ip_defrag(net
, skb
, IP_DEFRAG_LOCAL_DELIVER
))
252 return NF_HOOK(NFPROTO_IPV4
, NF_INET_LOCAL_IN
,
253 net
, NULL
, skb
, skb
->dev
, NULL
,
254 ip_local_deliver_finish
);
257 static inline bool ip_rcv_options(struct sk_buff
*skb
, struct net_device
*dev
)
259 struct ip_options
*opt
;
260 const struct iphdr
*iph
;
262 /* It looks as overkill, because not all
263 IP options require packet mangling.
264 But it is the easiest for now, especially taking
265 into account that combination of IP options
266 and running sniffer is extremely rare condition.
269 if (skb_cow(skb
, skb_headroom(skb
))) {
270 __IP_INC_STATS(dev_net(dev
), IPSTATS_MIB_INDISCARDS
);
275 opt
= &(IPCB(skb
)->opt
);
276 opt
->optlen
= iph
->ihl
*4 - sizeof(struct iphdr
);
278 if (ip_options_compile(dev_net(dev
), opt
, skb
)) {
279 __IP_INC_STATS(dev_net(dev
), IPSTATS_MIB_INHDRERRORS
);
283 if (unlikely(opt
->srr
)) {
284 struct in_device
*in_dev
= __in_dev_get_rcu(dev
);
287 if (!IN_DEV_SOURCE_ROUTE(in_dev
)) {
288 if (IN_DEV_LOG_MARTIANS(in_dev
))
289 net_info_ratelimited("source route option %pI4 -> %pI4\n",
296 if (ip_options_rcv_srr(skb
, dev
))
305 static bool ip_can_use_hint(const struct sk_buff
*skb
, const struct iphdr
*iph
,
306 const struct sk_buff
*hint
)
308 return hint
&& !skb_dst(skb
) && ip_hdr(hint
)->daddr
== iph
->daddr
&&
309 ip_hdr(hint
)->tos
== iph
->tos
;
312 INDIRECT_CALLABLE_DECLARE(int udp_v4_early_demux(struct sk_buff
*));
313 INDIRECT_CALLABLE_DECLARE(int tcp_v4_early_demux(struct sk_buff
*));
314 static int ip_rcv_finish_core(struct net
*net
, struct sock
*sk
,
315 struct sk_buff
*skb
, struct net_device
*dev
,
316 const struct sk_buff
*hint
)
318 const struct iphdr
*iph
= ip_hdr(skb
);
319 int (*edemux
)(struct sk_buff
*skb
);
323 if (ip_can_use_hint(skb
, iph
, hint
)) {
324 err
= ip_route_use_hint(skb
, iph
->daddr
, iph
->saddr
, iph
->tos
,
330 if (net
->ipv4
.sysctl_ip_early_demux
&&
333 !ip_is_fragment(iph
)) {
334 const struct net_protocol
*ipprot
;
335 int protocol
= iph
->protocol
;
337 ipprot
= rcu_dereference(inet_protos
[protocol
]);
338 if (ipprot
&& (edemux
= READ_ONCE(ipprot
->early_demux
))) {
339 err
= INDIRECT_CALL_2(edemux
, tcp_v4_early_demux
,
340 udp_v4_early_demux
, skb
);
343 /* must reload iph, skb->head might have changed */
349 * Initialise the virtual path cache for the packet. It describes
350 * how the packet travels inside Linux networking.
352 if (!skb_valid_dst(skb
)) {
353 err
= ip_route_input_noref(skb
, iph
->daddr
, iph
->saddr
,
359 #ifdef CONFIG_IP_ROUTE_CLASSID
360 if (unlikely(skb_dst(skb
)->tclassid
)) {
361 struct ip_rt_acct
*st
= this_cpu_ptr(ip_rt_acct
);
362 u32 idx
= skb_dst(skb
)->tclassid
;
363 st
[idx
&0xFF].o_packets
++;
364 st
[idx
&0xFF].o_bytes
+= skb
->len
;
365 st
[(idx
>>16)&0xFF].i_packets
++;
366 st
[(idx
>>16)&0xFF].i_bytes
+= skb
->len
;
370 if (iph
->ihl
> 5 && ip_rcv_options(skb
, dev
))
373 rt
= skb_rtable(skb
);
374 if (rt
->rt_type
== RTN_MULTICAST
) {
375 __IP_UPD_PO_STATS(net
, IPSTATS_MIB_INMCAST
, skb
->len
);
376 } else if (rt
->rt_type
== RTN_BROADCAST
) {
377 __IP_UPD_PO_STATS(net
, IPSTATS_MIB_INBCAST
, skb
->len
);
378 } else if (skb
->pkt_type
== PACKET_BROADCAST
||
379 skb
->pkt_type
== PACKET_MULTICAST
) {
380 struct in_device
*in_dev
= __in_dev_get_rcu(dev
);
384 * When a host sends a datagram to a link-layer broadcast
385 * address, the IP destination address MUST be a legal IP
386 * broadcast or IP multicast address.
388 * A host SHOULD silently discard a datagram that is received
389 * via a link-layer broadcast (see Section 2.4) but does not
390 * specify an IP multicast or broadcast destination address.
392 * This doesn't explicitly say L2 *broadcast*, but broadcast is
393 * in a way a form of multicast and the most common use case for
394 * this is 802.11 protecting against cross-station spoofing (the
395 * so-called "hole-196" attack) so do it for both.
398 IN_DEV_ORCONF(in_dev
, DROP_UNICAST_IN_L2_MULTICAST
))
402 return NET_RX_SUCCESS
;
410 __NET_INC_STATS(net
, LINUX_MIB_IPRPFILTER
);
414 static int ip_rcv_finish(struct net
*net
, struct sock
*sk
, struct sk_buff
*skb
)
416 struct net_device
*dev
= skb
->dev
;
419 /* if ingress device is enslaved to an L3 master device pass the
420 * skb to its handler for processing
422 skb
= l3mdev_ip_rcv(skb
);
424 return NET_RX_SUCCESS
;
426 ret
= ip_rcv_finish_core(net
, sk
, skb
, dev
, NULL
);
427 if (ret
!= NET_RX_DROP
)
428 ret
= dst_input(skb
);
433 * Main IP Receive routine.
435 static struct sk_buff
*ip_rcv_core(struct sk_buff
*skb
, struct net
*net
)
437 const struct iphdr
*iph
;
440 /* When the interface is in promisc. mode, drop all the crap
441 * that it receives, do not try to analyse it.
443 if (skb
->pkt_type
== PACKET_OTHERHOST
)
446 __IP_UPD_PO_STATS(net
, IPSTATS_MIB_IN
, skb
->len
);
448 skb
= skb_share_check(skb
, GFP_ATOMIC
);
450 __IP_INC_STATS(net
, IPSTATS_MIB_INDISCARDS
);
454 if (!pskb_may_pull(skb
, sizeof(struct iphdr
)))
460 * RFC1122: 3.2.1.2 MUST silently discard any IP frame that fails the checksum.
462 * Is the datagram acceptable?
464 * 1. Length at least the size of an ip header
466 * 3. Checksums correctly. [Speed optimisation for later, skip loopback checksums]
467 * 4. Doesn't have a bogus length
470 if (iph
->ihl
< 5 || iph
->version
!= 4)
473 BUILD_BUG_ON(IPSTATS_MIB_ECT1PKTS
!= IPSTATS_MIB_NOECTPKTS
+ INET_ECN_ECT_1
);
474 BUILD_BUG_ON(IPSTATS_MIB_ECT0PKTS
!= IPSTATS_MIB_NOECTPKTS
+ INET_ECN_ECT_0
);
475 BUILD_BUG_ON(IPSTATS_MIB_CEPKTS
!= IPSTATS_MIB_NOECTPKTS
+ INET_ECN_CE
);
477 IPSTATS_MIB_NOECTPKTS
+ (iph
->tos
& INET_ECN_MASK
),
478 max_t(unsigned short, 1, skb_shinfo(skb
)->gso_segs
));
480 if (!pskb_may_pull(skb
, iph
->ihl
*4))
485 if (unlikely(ip_fast_csum((u8
*)iph
, iph
->ihl
)))
488 len
= ntohs(iph
->tot_len
);
489 if (skb
->len
< len
) {
490 __IP_INC_STATS(net
, IPSTATS_MIB_INTRUNCATEDPKTS
);
492 } else if (len
< (iph
->ihl
*4))
495 /* Our transport medium may have padded the buffer out. Now we know it
496 * is IP we can trim to the true length of the frame.
497 * Note this now means skb->len holds ntohs(iph->tot_len).
499 if (pskb_trim_rcsum(skb
, len
)) {
500 __IP_INC_STATS(net
, IPSTATS_MIB_INDISCARDS
);
505 skb
->transport_header
= skb
->network_header
+ iph
->ihl
*4;
507 /* Remove any debris in the socket control block */
508 memset(IPCB(skb
), 0, sizeof(struct inet_skb_parm
));
509 IPCB(skb
)->iif
= skb
->skb_iif
;
511 /* Must drop socket now because of tproxy. */
512 if (!skb_sk_is_prefetched(skb
))
518 __IP_INC_STATS(net
, IPSTATS_MIB_CSUMERRORS
);
520 __IP_INC_STATS(net
, IPSTATS_MIB_INHDRERRORS
);
528 * IP receive entry point
530 int ip_rcv(struct sk_buff
*skb
, struct net_device
*dev
, struct packet_type
*pt
,
531 struct net_device
*orig_dev
)
533 struct net
*net
= dev_net(dev
);
535 skb
= ip_rcv_core(skb
, net
);
539 return NF_HOOK(NFPROTO_IPV4
, NF_INET_PRE_ROUTING
,
540 net
, NULL
, skb
, dev
, NULL
,
544 static void ip_sublist_rcv_finish(struct list_head
*head
)
546 struct sk_buff
*skb
, *next
;
548 list_for_each_entry_safe(skb
, next
, head
, list
) {
549 skb_list_del_init(skb
);
554 static struct sk_buff
*ip_extract_route_hint(const struct net
*net
,
555 struct sk_buff
*skb
, int rt_type
)
557 if (fib4_has_custom_rules(net
) || rt_type
== RTN_BROADCAST
)
563 static void ip_list_rcv_finish(struct net
*net
, struct sock
*sk
,
564 struct list_head
*head
)
566 struct sk_buff
*skb
, *next
, *hint
= NULL
;
567 struct dst_entry
*curr_dst
= NULL
;
568 struct list_head sublist
;
570 INIT_LIST_HEAD(&sublist
);
571 list_for_each_entry_safe(skb
, next
, head
, list
) {
572 struct net_device
*dev
= skb
->dev
;
573 struct dst_entry
*dst
;
575 skb_list_del_init(skb
);
576 /* if ingress device is enslaved to an L3 master device pass the
577 * skb to its handler for processing
579 skb
= l3mdev_ip_rcv(skb
);
582 if (ip_rcv_finish_core(net
, sk
, skb
, dev
, hint
) == NET_RX_DROP
)
586 if (curr_dst
!= dst
) {
587 hint
= ip_extract_route_hint(net
, skb
,
588 ((struct rtable
*)dst
)->rt_type
);
590 /* dispatch old sublist */
591 if (!list_empty(&sublist
))
592 ip_sublist_rcv_finish(&sublist
);
593 /* start new sublist */
594 INIT_LIST_HEAD(&sublist
);
597 list_add_tail(&skb
->list
, &sublist
);
599 /* dispatch final sublist */
600 ip_sublist_rcv_finish(&sublist
);
603 static void ip_sublist_rcv(struct list_head
*head
, struct net_device
*dev
,
606 NF_HOOK_LIST(NFPROTO_IPV4
, NF_INET_PRE_ROUTING
, net
, NULL
,
607 head
, dev
, NULL
, ip_rcv_finish
);
608 ip_list_rcv_finish(net
, NULL
, head
);
611 /* Receive a list of IP packets */
612 void ip_list_rcv(struct list_head
*head
, struct packet_type
*pt
,
613 struct net_device
*orig_dev
)
615 struct net_device
*curr_dev
= NULL
;
616 struct net
*curr_net
= NULL
;
617 struct sk_buff
*skb
, *next
;
618 struct list_head sublist
;
620 INIT_LIST_HEAD(&sublist
);
621 list_for_each_entry_safe(skb
, next
, head
, list
) {
622 struct net_device
*dev
= skb
->dev
;
623 struct net
*net
= dev_net(dev
);
625 skb_list_del_init(skb
);
626 skb
= ip_rcv_core(skb
, net
);
630 if (curr_dev
!= dev
|| curr_net
!= net
) {
631 /* dispatch old sublist */
632 if (!list_empty(&sublist
))
633 ip_sublist_rcv(&sublist
, curr_dev
, curr_net
);
634 /* start new sublist */
635 INIT_LIST_HEAD(&sublist
);
639 list_add_tail(&skb
->list
, &sublist
);
641 /* dispatch final sublist */
642 if (!list_empty(&sublist
))
643 ip_sublist_rcv(&sublist
, curr_dev
, curr_net
);