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 * Pseudo-driver for the loopback interface.
9 * Version: @(#)loopback.c 1.0.4b 08/16/93
12 * Fred N. van Kempen, <waltje@uWalt.NL.Mugnet.ORG>
13 * Donald Becker, <becker@scyld.com>
15 * Alan Cox : Fixed oddments for NET3.014
16 * Alan Cox : Rejig for NET3.029 snap #3
17 * Alan Cox : Fixed NET3.029 bugs and sped up
18 * Larry McVoy : Tiny tweak to double performance
19 * Alan Cox : Backed out LMV's tweak - the linux mm
21 * Michael Griffith: Don't bother computing the checksums
22 * on packets received on the loopback
24 * Alexey Kuznetsov: Potential hang under some extreme
27 #include <linux/kernel.h>
28 #include <linux/jiffies.h>
29 #include <linux/module.h>
30 #include <linux/interrupt.h>
32 #include <linux/types.h>
33 #include <linux/string.h>
34 #include <linux/socket.h>
35 #include <linux/errno.h>
36 #include <linux/fcntl.h>
39 #include <linux/uaccess.h>
42 #include <linux/inet.h>
43 #include <linux/netdevice.h>
44 #include <linux/etherdevice.h>
45 #include <linux/skbuff.h>
46 #include <linux/ethtool.h>
48 #include <net/checksum.h>
49 #include <linux/if_ether.h> /* For the statistics structure. */
50 #include <linux/if_arp.h> /* For ARPHRD_ETHER */
52 #include <linux/tcp.h>
53 #include <linux/percpu.h>
54 #include <linux/net_tstamp.h>
55 #include <net/net_namespace.h>
56 #include <linux/u64_stats_sync.h>
58 /* The higher levels take care of making this non-reentrant (it's
59 * called with bh's disabled).
61 static netdev_tx_t
loopback_xmit(struct sk_buff
*skb
,
62 struct net_device
*dev
)
64 struct pcpu_lstats
*lb_stats
;
67 skb_tx_timestamp(skb
);
69 /* do not fool net_timestamp_check() with various clock bases */
74 /* Before queueing this packet to netif_rx(),
75 * make sure dst is refcounted.
79 skb
->protocol
= eth_type_trans(skb
, dev
);
81 /* it's OK to use per_cpu_ptr() because BHs are off */
82 lb_stats
= this_cpu_ptr(dev
->lstats
);
85 if (likely(netif_rx(skb
) == NET_RX_SUCCESS
)) {
86 u64_stats_update_begin(&lb_stats
->syncp
);
87 lb_stats
->bytes
+= len
;
89 u64_stats_update_end(&lb_stats
->syncp
);
95 static void loopback_get_stats64(struct net_device
*dev
,
96 struct rtnl_link_stats64
*stats
)
102 for_each_possible_cpu(i
) {
103 const struct pcpu_lstats
*lb_stats
;
104 u64 tbytes
, tpackets
;
107 lb_stats
= per_cpu_ptr(dev
->lstats
, i
);
109 start
= u64_stats_fetch_begin_irq(&lb_stats
->syncp
);
110 tbytes
= lb_stats
->bytes
;
111 tpackets
= lb_stats
->packets
;
112 } while (u64_stats_fetch_retry_irq(&lb_stats
->syncp
, start
));
116 stats
->rx_packets
= packets
;
117 stats
->tx_packets
= packets
;
118 stats
->rx_bytes
= bytes
;
119 stats
->tx_bytes
= bytes
;
122 static u32
always_on(struct net_device
*dev
)
127 static const struct ethtool_ops loopback_ethtool_ops
= {
128 .get_link
= always_on
,
129 .get_ts_info
= ethtool_op_get_ts_info
,
132 static int loopback_dev_init(struct net_device
*dev
)
134 dev
->lstats
= netdev_alloc_pcpu_stats(struct pcpu_lstats
);
140 static void loopback_dev_free(struct net_device
*dev
)
142 dev_net(dev
)->loopback_dev
= NULL
;
143 free_percpu(dev
->lstats
);
146 static const struct net_device_ops loopback_ops
= {
147 .ndo_init
= loopback_dev_init
,
148 .ndo_start_xmit
= loopback_xmit
,
149 .ndo_get_stats64
= loopback_get_stats64
,
150 .ndo_set_mac_address
= eth_mac_addr
,
153 /* The loopback device is special. There is only one instance
154 * per network namespace.
156 static void loopback_setup(struct net_device
*dev
)
158 dev
->mtu
= 64 * 1024;
159 dev
->hard_header_len
= ETH_HLEN
; /* 14 */
160 dev
->min_header_len
= ETH_HLEN
; /* 14 */
161 dev
->addr_len
= ETH_ALEN
; /* 6 */
162 dev
->type
= ARPHRD_LOOPBACK
; /* 0x0001*/
163 dev
->flags
= IFF_LOOPBACK
;
164 dev
->priv_flags
|= IFF_LIVE_ADDR_CHANGE
| IFF_NO_QUEUE
;
166 dev
->hw_features
= NETIF_F_GSO_SOFTWARE
;
167 dev
->features
= NETIF_F_SG
| NETIF_F_FRAGLIST
168 | NETIF_F_GSO_SOFTWARE
174 | NETIF_F_NETNS_LOCAL
175 | NETIF_F_VLAN_CHALLENGED
177 dev
->ethtool_ops
= &loopback_ethtool_ops
;
178 dev
->header_ops
= ð_header_ops
;
179 dev
->netdev_ops
= &loopback_ops
;
180 dev
->needs_free_netdev
= true;
181 dev
->priv_destructor
= loopback_dev_free
;
184 /* Setup and register the loopback device. */
185 static __net_init
int loopback_net_init(struct net
*net
)
187 struct net_device
*dev
;
191 dev
= alloc_netdev(0, "lo", NET_NAME_UNKNOWN
, loopback_setup
);
195 dev_net_set(dev
, net
);
196 err
= register_netdev(dev
);
198 goto out_free_netdev
;
200 BUG_ON(dev
->ifindex
!= LOOPBACK_IFINDEX
);
201 net
->loopback_dev
= dev
;
207 if (net_eq(net
, &init_net
))
208 panic("loopback: Failed to register netdevice: %d\n", err
);
212 /* Registered in net/core/dev.c */
213 struct pernet_operations __net_initdata loopback_net_ops
= {
214 .init
= loopback_net_init
,