2 * Copyright (c) 1982, 1986, 1993
3 * The Regents of the University of California. All rights reserved.
5 * Redistribution and use in source and binary forms, with or without
6 * modification, are permitted provided that the following conditions
8 * 1. Redistributions of source code must retain the above copyright
9 * notice, this list of conditions and the following disclaimer.
10 * 2. Redistributions in binary form must reproduce the above copyright
11 * notice, this list of conditions and the following disclaimer in the
12 * documentation and/or other materials provided with the distribution.
13 * 3. Neither the name of the University nor the names of its contributors
14 * may be used to endorse or promote products derived from this software
15 * without specific prior written permission.
17 * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
18 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
19 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
20 * ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
21 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
22 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
23 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
24 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
25 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
26 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
29 * @(#)if_loop.c 8.1 (Berkeley) 6/10/93
30 * $FreeBSD: src/sys/net/if_loop.c,v 1.47.2.9 2004/02/08 08:40:24 silby Exp $
34 * Loopback interface driver for protocol testing and timing.
39 #include "opt_inet6.h"
41 #include <sys/param.h>
42 #include <sys/systm.h>
43 #include <sys/kernel.h>
46 #include <sys/socket.h>
47 #include <sys/sockio.h>
49 #include <sys/mplock2.h>
52 #include <net/if_types.h>
53 #include <net/if_clone.h>
54 #include <net/ifq_var.h>
55 #include <net/netisr.h>
56 #include <net/route.h>
58 #include <net/bpfdesc.h>
61 #include <netinet/in.h>
62 #include <netinet/in_var.h>
67 #include <netinet/in.h>
69 #include <netinet6/in6_var.h>
70 #include <netinet/ip6.h>
73 static int lo_clone_create(struct if_clone *, int, caddr_t);
74 static int lo_clone_destroy(struct ifnet *);
76 static int lo_output(struct ifnet *, struct mbuf *, struct sockaddr *,
78 static int lo_ioctl(struct ifnet *, u_long, caddr_t, struct ucred *);
79 static void lo_rtrequest(int, struct rtentry *);
81 static void lo_altqstart(struct ifnet *, struct ifaltq_subque *);
85 #define LOMTU (1024+512)
86 #elif defined(LARGE_LOMTU)
92 #define LO_CSUM_FEATURES (CSUM_IP | CSUM_UDP | CSUM_TCP)
96 static struct if_clone lo_cloner = IF_CLONE_INITIALIZER("lo",
97 lo_clone_create, lo_clone_destroy, NLOOP, IF_MAXUNIT);
100 lo_sysinit(void *dummy __unused)
103 if_clone_attach(&lo_cloner);
105 SYSINIT(lo_sysinit, SI_SUB_PSEUDO, SI_ORDER_ANY, lo_sysinit, NULL);
108 lo_clone_create(struct if_clone *ifc __unused, int unit, caddr_t param __unused)
112 ifp = kmalloc(sizeof(*ifp), M_IFNET, M_WAITOK | M_ZERO);
114 if_initname(ifp, "lo", unit);
116 ifp->if_flags = IFF_LOOPBACK | IFF_MULTICAST;
117 ifp->if_capabilities = IFCAP_HWCSUM | IFCAP_RSS;
118 ifp->if_hwassist = LO_CSUM_FEATURES;
119 ifp->if_capenable = ifp->if_capabilities;
120 ifp->if_ioctl = lo_ioctl;
121 ifp->if_output = lo_output;
122 ifp->if_type = IFT_LOOP;
123 ifq_set_maxlen(&ifp->if_snd, ifqmaxlen);
124 ifq_set_ready(&ifp->if_snd);
126 ifp->if_start = lo_altqstart;
128 if_attach(ifp, NULL);
129 bpfattach(ifp, DLT_NULL, sizeof(u_int));
132 KASSERT(unit == 0, ("loif is %s", ifp->if_xname));
139 lo_clone_destroy(struct ifnet *ifp)
152 lo_output(struct ifnet *ifp, struct mbuf *m, struct sockaddr *dst,
157 if (rt && rt->rt_flags & (RTF_REJECT|RTF_BLACKHOLE)) {
159 return (rt->rt_flags & RTF_BLACKHOLE ? 0 :
160 rt->rt_flags & RTF_HOST ? EHOSTUNREACH : ENETUNREACH);
163 IFNET_STAT_INC(ifp, opackets, 1);
164 IFNET_STAT_INC(ifp, obytes, m->m_pkthdr.len);
166 switch (dst->sa_family) {
171 kprintf("lo_output: af=%d unexpected\n", dst->sa_family);
173 return (EAFNOSUPPORT);
177 if (ifp->if_capenable & IFCAP_RXCSUM) {
180 if (m->m_pkthdr.csum_flags & CSUM_IP)
181 csum_flags |= (CSUM_IP_CHECKED | CSUM_IP_VALID);
182 if (m->m_pkthdr.csum_flags & CSUM_DELAY_DATA)
183 csum_flags |= (CSUM_DATA_VALID | CSUM_PSEUDO_HDR);
185 m->m_pkthdr.csum_flags |= csum_flags;
186 if (csum_flags & CSUM_DATA_VALID)
187 m->m_pkthdr.csum_data = 0xffff;
189 if ((ifp->if_capenable & IFCAP_RSS) == 0)
190 m->m_flags &= ~M_HASH;
191 return (if_simloop(ifp, m, dst->sa_family, 0));
197 * This function is to support software emulation of hardware loopback,
198 * i.e., for interfaces with the IFF_SIMPLEX attribute. Since they can't
199 * hear their own broadcasts, we create a copy of the packet that we
200 * would normally receive via a hardware loopback.
202 * This function expects the packet to include the media header of length hlen.
205 if_simloop(struct ifnet *ifp, struct mbuf *m, int af, int hlen)
209 KASSERT((m->m_flags & M_PKTHDR) != 0, ("if_simloop: no HDR"));
210 m->m_pkthdr.rcvif = ifp;
212 /* BPF write needs to be handled specially */
213 if (af == AF_UNSPEC) {
214 KASSERT(m->m_len >= sizeof(int), ("if_simloop: m_len"));
215 af = *(mtod(m, int *));
216 m->m_len -= sizeof(int);
217 m->m_pkthdr.len -= sizeof(int);
218 m->m_data += sizeof(int);
225 if (ifp->if_bpf == NULL)
228 if (ifp->if_bpf->bif_dlt == DLT_NULL) {
229 uint32_t bpf_af = (uint32_t)af;
230 bpf_ptap(ifp->if_bpf, m, &bpf_af, 4);
232 bpf_mtap(ifp->if_bpf, m);
238 /* Strip away media header */
244 * altq for loop is just for debugging.
245 * only used when called for loop interface (not for
246 * a simplex interface).
248 if (ifq_is_enabled(&ifp->if_snd) && ifp->if_start == lo_altqstart) {
249 struct altq_pktattr pktattr;
253 * if the queueing discipline needs packet classification,
254 * do it before prepending link headers.
256 ifq_classify(&ifp->if_snd, m, af, &pktattr);
258 M_PREPEND(m, sizeof(int32_t), M_NOWAIT);
261 afp = mtod(m, int32_t *);
264 return ifq_dispatch(ifp, m, &pktattr);
268 /* Deliver to upper layer protocol */
277 m->m_flags |= M_LOOP;
282 kprintf("if_simloop: can't handle af=%d\n", af);
284 return (EAFNOSUPPORT);
287 IFNET_STAT_INC(ifp, ipackets, 1);
288 IFNET_STAT_INC(ifp, ibytes, m->m_pkthdr.len);
289 netisr_queue(isr, m);
295 lo_altqstart(struct ifnet *ifp, struct ifaltq_subque *ifsq)
303 m = ifsq_dequeue(ifsq);
308 afp = mtod(m, int32_t *);
310 m_adj(m, sizeof(int32_t));
320 m->m_flags |= M_LOOP;
325 kprintf("lo_altqstart: can't handle af%d\n", af);
330 IFNET_STAT_INC(ifp, ipackets, 1);
331 IFNET_STAT_INC(ifp, ibytes, m->m_pkthdr.len);
332 netisr_queue(isr, m);
339 lo_rtrequest(int cmd, struct rtentry *rt)
342 rt->rt_rmx.rmx_mtu = rt->rt_ifp->if_mtu; /* for ISO */
344 * For optimal performance, the send and receive buffers
345 * should be at least twice the MTU plus a little more for
348 rt->rt_rmx.rmx_recvpipe = rt->rt_rmx.rmx_sendpipe = 3 * LOMTU;
353 * Process an ioctl request.
357 lo_ioctl(struct ifnet *ifp, u_long cmd, caddr_t data, struct ucred *cr)
360 struct ifreq *ifr = (struct ifreq *)data;
365 ifp->if_flags |= IFF_UP | IFF_RUNNING;
366 ifa = (struct ifaddr *)data;
367 ifa->ifa_rtrequest = lo_rtrequest;
369 * Everything else is done at a higher level.
376 error = EAFNOSUPPORT; /* XXX */
379 switch (ifr->ifr_addr.sa_family) {
391 error = EAFNOSUPPORT;
397 ifp->if_mtu = ifr->ifr_mtu;
404 mask = ifr->ifr_reqcap ^ ifp->if_capenable;
405 if (mask & IFCAP_HWCSUM) {
406 ifp->if_capenable ^= (mask & IFCAP_HWCSUM);
407 if (IFCAP_TXCSUM & ifp->if_capenable)
408 ifp->if_hwassist = LO_CSUM_FEATURES;
410 ifp->if_hwassist = 0;
412 if (mask & IFCAP_RSS)
413 ifp->if_capenable ^= IFCAP_RSS;