sys/kern/uipc_mbuf.c

   1 /*
   2  * Copyright (c) 2004 Jeffrey M. Hsu.  All rights reserved.
   3  * Copyright (c) 2004 The DragonFly Project.  All rights reserved.
   4  *
   5  * This code is derived from software contributed to The DragonFly Project
   6  * by Jeffrey M. Hsu.
   7  *
   8  * Redistribution and use in source and binary forms, with or without
   9  * modification, are permitted provided that the following conditions
  10  * are met:
  11  * 1. Redistributions of source code must retain the above copyright
  12  *    notice, this list of conditions and the following disclaimer.
  13  * 2. Redistributions in binary form must reproduce the above copyright
  14  *    notice, this list of conditions and the following disclaimer in the
  15  *    documentation and/or other materials provided with the distribution.
  16  * 3. Neither the name of The DragonFly Project nor the names of its
  17  *    contributors may be used to endorse or promote products derived
  18  *    from this software without specific, prior written permission.
  19  *
  20  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
  21  * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
  22  * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
  23  * FOR A PARTICULAR PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE
  24  * COPYRIGHT HOLDERS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
  25  * INCIDENTAL, SPECIAL, EXEMPLARY OR CONSEQUENTIAL DAMAGES (INCLUDING,
  26  * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
  27  * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
  28  * AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
  29  * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
  30  * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  31  * SUCH DAMAGE.
  32  */
  33
  34 /*
  35  * Copyright (c) 2004 Jeffrey M. Hsu.  All rights reserved.
  36  *
  37  * License terms: all terms for the DragonFly license above plus the following:
  38  *
  39  * 4. All advertising materials mentioning features or use of this software
  40  *    must display the following acknowledgement:
  41  *
  42  *      This product includes software developed by Jeffrey M. Hsu
  43  *      for the DragonFly Project.
  44  *
  45  *    This requirement may be waived with permission from Jeffrey Hsu.
  46  *    This requirement will sunset and may be removed on July 8 2005,
  47  *    after which the standard DragonFly license (as shown above) will
  48  *    apply.
  49  */
  50
  51 /*
  52  * Copyright (c) 1982, 1986, 1988, 1991, 1993
  53  *      The Regents of the University of California.  All rights reserved.
  54  *
  55  * Redistribution and use in source and binary forms, with or without
  56  * modification, are permitted provided that the following conditions
  57  * are met:
  58  * 1. Redistributions of source code must retain the above copyright
  59  *    notice, this list of conditions and the following disclaimer.
  60  * 2. Redistributions in binary form must reproduce the above copyright
  61  *    notice, this list of conditions and the following disclaimer in the
  62  *    documentation and/or other materials provided with the distribution.
  63  * 3. All advertising materials mentioning features or use of this software
  64  *    must display the following acknowledgement:
  65  *      This product includes software developed by the University of
  66  *      California, Berkeley and its contributors.
  67  * 4. Neither the name of the University nor the names of its contributors
  68  *    may be used to endorse or promote products derived from this software
  69  *    without specific prior written permission.
  70  *
  71  * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
  72  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  73  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  74  * ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
  75  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  76  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  77  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  78  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  79  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  80  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  81  * SUCH DAMAGE.
  82  *
  83  * @(#)uipc_mbuf.c      8.2 (Berkeley) 1/4/94
  84  * $FreeBSD: src/sys/kern/uipc_mbuf.c,v 1.51.2.24 2003/04/15 06:59:29 silby Exp $
  85  * $DragonFly: src/sys/kern/uipc_mbuf.c,v 1.52 2005/06/17 18:58:02 dillon Exp $
  86  */
  87
  88 #include "opt_param.h"
  89 #include "opt_ddb.h"
  90 #include "opt_mbuf_stress_test.h"
  91 #include <sys/param.h>
  92 #include <sys/systm.h>
  93 #include <sys/malloc.h>
  94 #include <sys/mbuf.h>
  95 #include <sys/kernel.h>
  96 #include <sys/sysctl.h>
  97 #include <sys/domain.h>
  98 #include <sys/objcache.h>
  99 #include <sys/protosw.h>
 100 #include <sys/uio.h>
 101 #include <sys/thread.h>
 102 #include <sys/globaldata.h>
 103 #include <sys/thread2.h>
 104
 105 #include <vm/vm.h>
 106 #include <vm/vm_kern.h>
 107 #include <vm/vm_extern.h>
 108
 109 #ifdef INVARIANTS
 110 #include <machine/cpu.h>
 111 #endif
 112
 113 /*
 114  * mbuf cluster meta-data
 115  */
 116 struct mbcluster {
 117         int32_t mcl_refs;
 118         void    *mcl_data;
 119 };
 120
 121 static void mbinit(void *);
 122 SYSINIT(mbuf, SI_SUB_MBUF, SI_ORDER_FIRST, mbinit, NULL)
 123
 124 static u_long   mbtypes[MT_NTYPES];
 125
 126 struct mbstat mbstat;
 127 int     max_linkhdr;
 128 int     max_protohdr;
 129 int     max_hdr;
 130 int     max_datalen;
 131 int     m_defragpackets;
 132 int     m_defragbytes;
 133 int     m_defraguseless;
 134 int     m_defragfailure;
 135 #ifdef MBUF_STRESS_TEST
 136 int     m_defragrandomfailures;
 137 #endif
 138
 139 struct objcache *mbuf_cache, *mbufphdr_cache;
 140 struct objcache *mclmeta_cache;
 141 struct objcache *mbufcluster_cache, *mbufphdrcluster_cache;
 142
 143 int     nmbclusters;
 144 int     nmbufs;
 145
 146 SYSCTL_INT(_kern_ipc, KIPC_MAX_LINKHDR, max_linkhdr, CTLFLAG_RW,
 147            &max_linkhdr, 0, "");
 148 SYSCTL_INT(_kern_ipc, KIPC_MAX_PROTOHDR, max_protohdr, CTLFLAG_RW,
 149            &max_protohdr, 0, "");
 150 SYSCTL_INT(_kern_ipc, KIPC_MAX_HDR, max_hdr, CTLFLAG_RW, &max_hdr, 0, "");
 151 SYSCTL_INT(_kern_ipc, KIPC_MAX_DATALEN, max_datalen, CTLFLAG_RW,
 152            &max_datalen, 0, "");
 153 SYSCTL_INT(_kern_ipc, OID_AUTO, mbuf_wait, CTLFLAG_RW,
 154            &mbuf_wait, 0, "");
 155 SYSCTL_STRUCT(_kern_ipc, KIPC_MBSTAT, mbstat, CTLFLAG_RW, &mbstat, mbstat, "");
 156 SYSCTL_OPAQUE(_kern_ipc, OID_AUTO, mbtypes, CTLFLAG_RD, mbtypes,
 157            sizeof(mbtypes), "LU", "");
 158 SYSCTL_INT(_kern_ipc, KIPC_NMBCLUSTERS, nmbclusters, CTLFLAG_RW,
 159            &nmbclusters, 0, "Maximum number of mbuf clusters available");
 160 SYSCTL_INT(_kern_ipc, OID_AUTO, nmbufs, CTLFLAG_RW, &nmbufs, 0,
 161            "Maximum number of mbufs available");
 162
 163 SYSCTL_INT(_kern_ipc, OID_AUTO, m_defragpackets, CTLFLAG_RD,
 164            &m_defragpackets, 0, "");
 165 SYSCTL_INT(_kern_ipc, OID_AUTO, m_defragbytes, CTLFLAG_RD,
 166            &m_defragbytes, 0, "");
 167 SYSCTL_INT(_kern_ipc, OID_AUTO, m_defraguseless, CTLFLAG_RD,
 168            &m_defraguseless, 0, "");
 169 SYSCTL_INT(_kern_ipc, OID_AUTO, m_defragfailure, CTLFLAG_RD,
 170            &m_defragfailure, 0, "");
 171 #ifdef MBUF_STRESS_TEST
 172 SYSCTL_INT(_kern_ipc, OID_AUTO, m_defragrandomfailures, CTLFLAG_RW,
 173            &m_defragrandomfailures, 0, "");
 174 #endif
 175
 176 static MALLOC_DEFINE(M_MBUF, "mbuf", "mbuf");
 177 static MALLOC_DEFINE(M_MBUFCL, "mbufcl", "mbufcl");
 178 static MALLOC_DEFINE(M_MCLMETA, "mclmeta", "mclmeta");
 179
 180 static void m_reclaim (void);
 181 static void m_mclref(void *arg);
 182 static void m_mclfree(void *arg);
 183
 184 #ifndef NMBCLUSTERS
 185 #define NMBCLUSTERS     (512 + maxusers * 16)
 186 #endif
 187 #ifndef NMBUFS
 188 #define NMBUFS          (nmbclusters * 2)
 189 #endif
 190
 191 /*
 192  * Perform sanity checks of tunables declared above.
 193  */
 194 static void
 195 tunable_mbinit(void *dummy)
 196 {
 197
 198         /*
 199          * This has to be done before VM init.
 200          */
 201         nmbclusters = NMBCLUSTERS;
 202         TUNABLE_INT_FETCH("kern.ipc.nmbclusters", &nmbclusters);
 203         nmbufs = NMBUFS;
 204         TUNABLE_INT_FETCH("kern.ipc.nmbufs", &nmbufs);
 205         /* Sanity checks */
 206         if (nmbufs < nmbclusters * 2)
 207                 nmbufs = nmbclusters * 2;
 208
 209         return;
 210 }
 211 SYSINIT(tunable_mbinit, SI_SUB_TUNABLES, SI_ORDER_ANY, tunable_mbinit, NULL);
 212
 213 /* "number of clusters of pages" */
 214 #define NCL_INIT        1
 215
 216 #define NMB_INIT        16
 217
 218 /*
 219  * The mbuf object cache only guarantees that m_next and m_nextpkt are
 220  * NULL and that m_data points to the beginning of the data area.  In
 221  * particular, m_len and m_pkthdr.len are uninitialized.  It is the
 222  * responsibility of the caller to initialize those fields before use.
 223  */
 224
 225 static boolean_t __inline
 226 mbuf_ctor(void *obj, void *private, int ocflags)
 227 {
 228         struct mbuf *m = obj;
 229
 230         m->m_next = NULL;
 231         m->m_nextpkt = NULL;
 232         m->m_data = m->m_dat;
 233         m->m_flags = 0;
 234
 235         return (TRUE);
 236 }
 237
 238 /*
 239  * Initialize the mbuf and the packet header fields.
 240  */
 241 static boolean_t
 242 mbufphdr_ctor(void *obj, void *private, int ocflags)
 243 {
 244         struct mbuf *m = obj;
 245
 246         m->m_next = NULL;
 247         m->m_nextpkt = NULL;
 248         m->m_data = m->m_pktdat;
 249         m->m_flags = M_PKTHDR | M_PHCACHE;
 250
 251         m->m_pkthdr.rcvif = NULL;       /* eliminate XXX JH */
 252         SLIST_INIT(&m->m_pkthdr.tags);
 253         m->m_pkthdr.csum_flags = 0;     /* eliminate XXX JH */
 254         m->m_pkthdr.fw_flags = 0;       /* eliminate XXX JH */
 255
 256         return (TRUE);
 257 }
 258
 259 /*
 260  * A mbcluster object consists of 2K (MCLBYTES) cluster and a refcount.
 261  */
 262 static boolean_t
 263 mclmeta_ctor(void *obj, void *private, int ocflags)
 264 {
 265         struct mbcluster *cl = obj;
 266         void *buf;
 267
 268         if (ocflags & M_NOWAIT)
 269                 buf = malloc(MCLBYTES, M_MBUFCL, M_NOWAIT | M_ZERO);
 270         else
 271                 buf = malloc(MCLBYTES, M_MBUFCL, M_INTWAIT | M_ZERO);
 272         if (buf == NULL)
 273                 return (FALSE);
 274         cl->mcl_refs = 0;
 275         cl->mcl_data = buf;
 276         return (TRUE);
 277 }
 278
 279 static void
 280 mclmeta_dtor(void *obj, void *private)
 281 {
 282         struct mbcluster *mcl = obj;
 283
 284         KKASSERT(mcl->mcl_refs == 0);
 285         free(mcl->mcl_data, M_MBUFCL);
 286 }
 287
 288 static void
 289 linkcluster(struct mbuf *m, struct mbcluster *cl)
 290 {
 291         /*
 292          * Add the cluster to the mbuf.  The caller will detect that the
 293          * mbuf now has an attached cluster.
 294          */
 295         m->m_ext.ext_arg = cl;
 296         m->m_ext.ext_buf = cl->mcl_data;
 297         m->m_ext.ext_ref = m_mclref;
 298         m->m_ext.ext_free = m_mclfree;
 299         m->m_ext.ext_size = MCLBYTES;
 300         ++cl->mcl_refs;
 301
 302         m->m_data = m->m_ext.ext_buf;
 303         m->m_flags |= M_EXT | M_EXT_CLUSTER;
 304 }
 305
 306 static boolean_t
 307 mbufphdrcluster_ctor(void *obj, void *private, int ocflags)
 308 {
 309         struct mbuf *m = obj;
 310         struct mbcluster *cl;
 311
 312         mbufphdr_ctor(obj, private, ocflags);
 313         cl = objcache_get(mclmeta_cache, ocflags);
 314         if (cl == NULL)
 315                 return (FALSE);
 316         m->m_flags |= M_CLCACHE;
 317         linkcluster(m, cl);
 318         return (TRUE);
 319 }
 320
 321 static boolean_t
 322 mbufcluster_ctor(void *obj, void *private, int ocflags)
 323 {
 324         struct mbuf *m = obj;
 325         struct mbcluster *cl;
 326
 327         mbuf_ctor(obj, private, ocflags);
 328         cl = objcache_get(mclmeta_cache, ocflags);
 329         if (cl == NULL)
 330                 return (FALSE);
 331         m->m_flags |= M_CLCACHE;
 332         linkcluster(m, cl);
 333         return (TRUE);
 334 }
 335
 336 /*
 337  * Used for both the cluster and cluster PHDR caches.
 338  *
 339  * The mbuf may have lost its cluster due to sharing, deal
 340  * with the situation by checking M_EXT.
 341  */
 342 static void
 343 mbufcluster_dtor(void *obj, void *private)
 344 {
 345         struct mbuf *m = obj;
 346         struct mbcluster *mcl;
 347
 348         if (m->m_flags & M_EXT) {
 349                 KKASSERT((m->m_flags & M_EXT_CLUSTER) != 0);
 350                 mcl = m->m_ext.ext_arg;
 351                 KKASSERT(mcl->mcl_refs == 1);
 352                 mcl->mcl_refs = 0;
 353                 objcache_put(mclmeta_cache, mcl);
 354         }
 355 }
 356
 357 struct objcache_malloc_args mbuf_malloc_args = { MSIZE, M_MBUF };
 358 struct objcache_malloc_args mclmeta_malloc_args =
 359         { sizeof(struct mbcluster), M_MCLMETA };
 360
 361 /* ARGSUSED*/
 362 static void
 363 mbinit(void *dummy)
 364 {
 365         mbstat.m_msize = MSIZE;
 366         mbstat.m_mclbytes = MCLBYTES;
 367         mbstat.m_minclsize = MINCLSIZE;
 368         mbstat.m_mlen = MLEN;
 369         mbstat.m_mhlen = MHLEN;
 370
 371         mbuf_cache = objcache_create("mbuf", nmbufs, 0,
 372             mbuf_ctor, null_dtor, NULL,
 373             objcache_malloc_alloc, objcache_malloc_free, &mbuf_malloc_args);
 374         mbufphdr_cache = objcache_create("mbuf pkt hdr", nmbufs, 64,
 375             mbufphdr_ctor, null_dtor, NULL,
 376             objcache_malloc_alloc, objcache_malloc_free, &mbuf_malloc_args);
 377         mclmeta_cache = objcache_create("cluster mbuf", nmbclusters , 0,
 378             mclmeta_ctor, mclmeta_dtor, NULL,
 379             objcache_malloc_alloc, objcache_malloc_free, &mclmeta_malloc_args);
 380         mbufcluster_cache = objcache_create("mbuf + cluster", nmbclusters, 0,
 381             mbufcluster_ctor, mbufcluster_dtor, NULL,
 382             objcache_malloc_alloc, objcache_malloc_free, &mbuf_malloc_args);
 383         mbufphdrcluster_cache = objcache_create("mbuf pkt hdr + cluster",
 384             nmbclusters, 64, mbufphdrcluster_ctor, mbufcluster_dtor, NULL,
 385             objcache_malloc_alloc, objcache_malloc_free, &mbuf_malloc_args);
 386         return;
 387 }
 388
 389 /*
 390  * Return the number of references to this mbuf's data.  0 is returned
 391  * if the mbuf is not M_EXT, a reference count is returned if it is
 392  * M_EXT | M_EXT_CLUSTER, and 99 is returned if it is a special M_EXT.
 393  */
 394 int
 395 m_sharecount(struct mbuf *m)
 396 {
 397         switch (m->m_flags & (M_EXT | M_EXT_CLUSTER)) {
 398         case 0:
 399                 return (0);
 400         case M_EXT:
 401                 return (99);
 402         case M_EXT | M_EXT_CLUSTER:
 403                 return (((struct mbcluster *)m->m_ext.ext_arg)->mcl_refs);
 404         }
 405         /* NOTREACHED */
 406         return (0);             /* to shut up compiler */
 407 }
 408
 409 /*
 410  * change mbuf to new type
 411  */
 412 void
 413 m_chtype(struct mbuf *m, int type)
 414 {
 415         crit_enter();
 416         ++mbtypes[type];
 417         --mbtypes[m->m_type];
 418         m->m_type = type;
 419         crit_exit();
 420 }
 421
 422 static void
 423 m_reclaim(void)
 424 {
 425         struct domain *dp;
 426         struct protosw *pr;
 427
 428         crit_enter();
 429         SLIST_FOREACH(dp, &domains, dom_next) {
 430                 for (pr = dp->dom_protosw; pr < dp->dom_protoswNPROTOSW; pr++) {
 431                         if (pr->pr_drain)
 432                                 (*pr->pr_drain)();
 433                 }
 434         }
 435         crit_exit();
 436         mbstat.m_drain++;
 437 }
 438
 439 static void __inline
 440 updatestats(struct mbuf *m, int type)
 441 {
 442         m->m_type = type;
 443
 444         crit_enter();
 445         ++mbtypes[type];
 446         ++mbstat.m_mbufs;
 447         crit_exit();
 448 }
 449
 450 /*
 451  * Allocate an mbuf.
 452  */
 453 struct mbuf *
 454 m_get(int how, int type)
 455 {
 456         struct mbuf *m;
 457         int ntries = 0;
 458         int ocf = MBTOM(how);
 459
 460 retryonce:
 461
 462         m = objcache_get(mbuf_cache, ocf);
 463
 464         if (m == NULL) {
 465                 if ((how & MB_TRYWAIT) && ntries++ == 0) {
 466                         struct objcache *reclaimlist[] = {
 467                                 mbufphdr_cache,
 468                                 mbufcluster_cache, mbufphdrcluster_cache
 469                         };
 470                         const int nreclaims = __arysize(reclaimlist);
 471
 472                         if (!objcache_reclaimlist(reclaimlist, nreclaims, ocf))
 473                                 m_reclaim();
 474                         goto retryonce;
 475                 }
 476                 return (NULL);
 477         }
 478
 479         updatestats(m, type);
 480         return (m);
 481 }
 482
 483 struct mbuf *
 484 m_gethdr(int how, int type)
 485 {
 486         struct mbuf *m;
 487         int ocf = MBTOM(how);
 488         int ntries = 0;
 489
 490 retryonce:
 491
 492         m = objcache_get(mbufphdr_cache, ocf);
 493
 494         if (m == NULL) {
 495                 if ((how & MB_TRYWAIT) && ntries++ == 0) {
 496                         struct objcache *reclaimlist[] = {
 497                                 mbuf_cache,
 498                                 mbufcluster_cache, mbufphdrcluster_cache
 499                         };
 500                         const int nreclaims = __arysize(reclaimlist);
 501
 502                         if (!objcache_reclaimlist(reclaimlist, nreclaims, ocf))
 503                                 m_reclaim();
 504                         goto retryonce;
 505                 }
 506                 return (NULL);
 507         }
 508
 509         updatestats(m, type);
 510         return (m);
 511 }
 512
 513 /*
 514  * Get a mbuf (not a mbuf cluster!) and zero it.
 515  * Deprecated.
 516  */
 517 struct mbuf *
 518 m_getclr(int how, int type)
 519 {
 520         struct mbuf *m;
 521
 522         m = m_get(how, type);
 523         if (m != NULL)
 524                 bzero(m->m_data, MLEN);
 525         return (m);
 526 }
 527
 528 /*
 529  * Returns an mbuf with an attached cluster.
 530  * Because many network drivers use this kind of buffers a lot, it is
 531  * convenient to keep a small pool of free buffers of this kind.
 532  * Even a small size such as 10 gives about 10% improvement in the
 533  * forwarding rate in a bridge or router.
 534  */
 535 struct mbuf *
 536 m_getcl(int how, short type, int flags)
 537 {
 538         struct mbuf *m;
 539         int ocflags = MBTOM(how);
 540         int ntries = 0;
 541
 542 retryonce:
 543
 544         if (flags & M_PKTHDR)
 545                 m = objcache_get(mbufphdrcluster_cache, ocflags);
 546         else
 547                 m = objcache_get(mbufcluster_cache, ocflags);
 548
 549         if (m == NULL) {
 550                 if ((how & MB_TRYWAIT) && ntries++ == 0) {
 551                         struct objcache *reclaimlist[1];
 552
 553                         if (flags & M_PKTHDR)
 554                                 reclaimlist[0] = mbufcluster_cache;
 555                         else
 556                                 reclaimlist[0] = mbufphdrcluster_cache;
 557                         if (!objcache_reclaimlist(reclaimlist, 1, ocflags))
 558                                 m_reclaim();
 559                         goto retryonce;
 560                 }
 561                 return (NULL);
 562         }
 563
 564         m->m_type = type;
 565
 566         crit_enter();
 567         ++mbtypes[type];
 568         ++mbstat.m_clusters;
 569         crit_exit();
 570         return (m);
 571 }
 572
 573 /*
 574  * Allocate chain of requested length.
 575  */
 576 struct mbuf *
 577 m_getc(int len, int how, int type)
 578 {
 579         struct mbuf *n, *nfirst = NULL, **ntail = &nfirst;
 580         int nsize;
 581
 582         while (len > 0) {
 583                 n = m_getl(len, how, type, 0, &nsize);
 584                 if (n == NULL)
 585                         goto failed;
 586                 n->m_len = 0;
 587                 *ntail = n;
 588                 ntail = &n->m_next;
 589                 len -= nsize;
 590         }
 591         return (nfirst);
 592
 593 failed:
 594         m_freem(nfirst);
 595         return (NULL);
 596 }
 597
 598 /*
 599  * Allocate len-worth of mbufs and/or mbuf clusters (whatever fits best)
 600  * and return a pointer to the head of the allocated chain. If m0 is
 601  * non-null, then we assume that it is a single mbuf or an mbuf chain to
 602  * which we want len bytes worth of mbufs and/or clusters attached, and so
 603  * if we succeed in allocating it, we will just return a pointer to m0.
 604  *
 605  * If we happen to fail at any point during the allocation, we will free
 606  * up everything we have already allocated and return NULL.
 607  *
 608  * Deprecated.  Use m_getc() and m_cat() instead.
 609  */
 610 struct mbuf *
 611 m_getm(struct mbuf *m0, int len, int how, int type)
 612 {
 613         struct mbuf *nfirst;
 614
 615         nfirst = m_getc(len, how, type);
 616
 617         if (m0 != NULL) {
 618                 m_last(m0)->m_next = nfirst;
 619                 return (m0);
 620         }
 621
 622         return (nfirst);
 623 }
 624
 625 /*
 626  * Adds a cluster to a normal mbuf, M_EXT is set on success.
 627  * Deprecated.  Use m_getcl() instead.
 628  */
 629 void
 630 m_mclget(struct mbuf *m, int how)
 631 {
 632         struct mbcluster *mcl;
 633
 634         KKASSERT((m->m_flags & M_EXT) == 0);
 635         mcl = objcache_get(mclmeta_cache, MBTOM(how));
 636         if (mcl != NULL) {
 637                 linkcluster(m, mcl);
 638                 crit_enter();
 639                 ++mbstat.m_clusters;
 640                 /* leave the m_mbufs count intact for original mbuf */
 641                 crit_exit();
 642         }
 643 }
 644
 645 static void
 646 m_mclref(void *arg)
 647 {
 648         struct mbcluster *mcl = arg;
 649
 650         atomic_add_int(&mcl->mcl_refs, 1);
 651 }
 652
 653 static void
 654 m_mclfree(void *arg)
 655 {
 656         struct mbcluster *mcl = arg;
 657
 658         /* XXX interrupt race.  Currently called from a critical section */
 659         if (mcl->mcl_refs > 1) {
 660                 atomic_subtract_int(&mcl->mcl_refs, 1);
 661         } else {
 662                 KKASSERT(mcl->mcl_refs == 1);
 663                 mcl->mcl_refs = 0;
 664                 objcache_put(mclmeta_cache, mcl);
 665         }
 666 }
 667
 668 extern void db_print_backtrace(void);
 669
 670 /*
 671  * Free a single mbuf and any associated external storage.  The successor,
 672  * if any, is returned.
 673  *
 674  * We do need to check non-first mbuf for m_aux, since some of existing
 675  * code does not call M_PREPEND properly.
 676  * (example: call to bpf_mtap from drivers)
 677  */
 678 struct mbuf *
 679 m_free(struct mbuf *m)
 680 {
 681         struct mbuf *n;
 682
 683         KASSERT(m->m_type != MT_FREE, ("freeing free mbuf %p", m));
 684         --mbtypes[m->m_type];
 685
 686         n = m->m_next;
 687
 688         /*
 689          * Make sure the mbuf is in constructed state before returning it
 690          * to the objcache.
 691          */
 692         m->m_next = NULL;
 693 #ifdef notyet
 694         KKASSERT(m->m_nextpkt == NULL);
 695 #else
 696         if (m->m_nextpkt != NULL) {
 697 #ifdef DDB
 698                 static int afewtimes = 10;
 699
 700                 if (afewtimes-- > 0) {
 701                         printf("mfree: m->m_nextpkt != NULL\n");
 702                         db_print_backtrace();
 703                 }
 704 #endif
 705                 m->m_nextpkt = NULL;
 706         }
 707 #endif
 708         if (m->m_flags & M_PKTHDR) {
 709                 m_tag_delete_chain(m);          /* eliminate XXX JH */
 710         }
 711
 712         m->m_flags &= (M_EXT | M_EXT_CLUSTER | M_CLCACHE | M_PHCACHE);
 713
 714         /*
 715          * Clean the M_PKTHDR state so we can return the mbuf to its original
 716          * cache.  This is based on the PHCACHE flag which tells us whether
 717          * the mbuf was originally allocated out of a packet-header cache
 718          * or a non-packet-header cache.
 719          */
 720         if (m->m_flags & M_PHCACHE) {
 721                 m->m_flags |= M_PKTHDR;
 722                 m->m_pkthdr.rcvif = NULL;       /* eliminate XXX JH */
 723                 m->m_pkthdr.csum_flags = 0;     /* eliminate XXX JH */
 724                 m->m_pkthdr.fw_flags = 0;       /* eliminate XXX JH */
 725                 SLIST_INIT(&m->m_pkthdr.tags);
 726         }
 727
 728         /*
 729          * Handle remaining flags combinations.  M_CLCACHE tells us whether
 730          * the mbuf was originally allocated from a cluster cache or not,
 731          * and is totally separate from whether the mbuf is currently
 732          * associated with a cluster.
 733          */
 734         crit_enter();
 735         switch(m->m_flags & (M_CLCACHE | M_EXT | M_EXT_CLUSTER)) {
 736         case M_CLCACHE | M_EXT | M_EXT_CLUSTER:
 737                 /*
 738                  * mbuf+cluster cache case.  The mbuf was allocated from the
 739                  * combined mbuf_cluster cache and can be returned to the
 740                  * cache if the cluster hasn't been shared.
 741                  */
 742                 if (m_sharecount(m) == 1) {
 743                         /*
 744                          * The cluster has not been shared, we can just
 745                          * reset the data pointer and return the mbuf
 746                          * to the cluster cache.  Note that the reference
 747                          * count is left intact (it is still associated with
 748                          * an mbuf).
 749                          */
 750                         m->m_data = m->m_ext.ext_buf;
 751                         if (m->m_flags & M_PHCACHE)
 752                                 objcache_put(mbufphdrcluster_cache, m);
 753                         else
 754                                 objcache_put(mbufcluster_cache, m);
 755                 } else {
 756                         /*
 757                          * Hell.  Someone else has a ref on this cluster,
 758                          * we have to disconnect it which means we can't
 759                          * put it back into the mbufcluster_cache, we
 760                          * have to destroy the mbuf.
 761                          *
 762                          * XXX we could try to connect another cluster to
 763                          * it.
 764                          */
 765                         m->m_ext.ext_free(m->m_ext.ext_arg);
 766                         m->m_flags &= ~(M_EXT | M_EXT_CLUSTER);
 767                         if (m->m_flags & M_PHCACHE)
 768                                 objcache_dtor(mbufphdrcluster_cache, m);
 769                         else
 770                                 objcache_dtor(mbufcluster_cache, m);
 771                 }
 772                 --mbstat.m_clusters;
 773                 break;
 774         case M_EXT | M_EXT_CLUSTER:
 775                 /*
 776                  * Normal cluster associated with an mbuf that was allocated
 777                  * from the normal mbuf pool rather then the cluster pool.
 778                  * The cluster has to be independantly disassociated from the
 779                  * mbuf.
 780                  */
 781                 --mbstat.m_clusters;
 782                 /* fall through */
 783         case M_EXT:
 784                 /*
 785                  * Normal cluster association case, disconnect the cluster from
 786                  * the mbuf.  The cluster may or may not be custom.
 787                  */
 788                 m->m_ext.ext_free(m->m_ext.ext_arg);
 789                 m->m_flags &= ~(M_EXT | M_EXT_CLUSTER);
 790                 /* fall through */
 791         case 0:
 792                 /*
 793                  * return the mbuf to the mbuf cache.
 794                  */
 795                 if (m->m_flags & M_PHCACHE) {
 796                         m->m_data = m->m_pktdat;
 797                         objcache_put(mbufphdr_cache, m);
 798                 } else {
 799                         m->m_data = m->m_dat;
 800                         objcache_put(mbuf_cache, m);
 801                 }
 802                 --mbstat.m_mbufs;
 803                 break;
 804         default:
 805                 if (!panicstr)
 806                         panic("bad mbuf flags %p %08x\n", m, m->m_flags);
 807                 break;
 808         }
 809         crit_exit();
 810         return (n);
 811 }
 812
 813 void
 814 m_freem(struct mbuf *m)
 815 {
 816         crit_enter();
 817         while (m)
 818                 m = m_free(m);
 819         crit_exit();
 820 }
 821
 822 /*
 823  * mbuf utility routines
 824  */
 825
 826 /*
 827  * Lesser-used path for M_PREPEND: allocate new mbuf to prepend to chain and
 828  * copy junk along.
 829  */
 830 struct mbuf *
 831 m_prepend(struct mbuf *m, int len, int how)
 832 {
 833         struct mbuf *mn;
 834
 835         if (m->m_flags & M_PKTHDR)
 836             mn = m_gethdr(how, m->m_type);
 837         else
 838             mn = m_get(how, m->m_type);
 839         if (mn == NULL) {
 840                 m_freem(m);
 841                 return (NULL);
 842         }
 843         if (m->m_flags & M_PKTHDR)
 844                 M_MOVE_PKTHDR(mn, m);
 845         mn->m_next = m;
 846         m = mn;
 847         if (len < MHLEN)
 848                 MH_ALIGN(m, len);
 849         m->m_len = len;
 850         return (m);
 851 }
 852
 853 /*
 854  * Make a copy of an mbuf chain starting "off0" bytes from the beginning,
 855  * continuing for "len" bytes.  If len is M_COPYALL, copy to end of mbuf.
 856  * The wait parameter is a choice of MB_WAIT/MB_DONTWAIT from caller.
 857  * Note that the copy is read-only, because clusters are not copied,
 858  * only their reference counts are incremented.
 859  */
 860 struct mbuf *
 861 m_copym(const struct mbuf *m, int off0, int len, int wait)
 862 {
 863         struct mbuf *n, **np;
 864         int off = off0;
 865         struct mbuf *top;
 866         int copyhdr = 0;
 867
 868         KASSERT(off >= 0, ("m_copym, negative off %d", off));
 869         KASSERT(len >= 0, ("m_copym, negative len %d", len));
 870         if (off == 0 && m->m_flags & M_PKTHDR)
 871                 copyhdr = 1;
 872         while (off > 0) {
 873                 KASSERT(m != NULL, ("m_copym, offset > size of mbuf chain"));
 874                 if (off < m->m_len)
 875                         break;
 876                 off -= m->m_len;
 877                 m = m->m_next;
 878         }
 879         np = &top;
 880         top = 0;
 881         while (len > 0) {
 882                 if (m == NULL) {
 883                         KASSERT(len == M_COPYALL,
 884                             ("m_copym, length > size of mbuf chain"));
 885                         break;
 886                 }
 887                 /*
 888                  * Because we are sharing any cluster attachment below,
 889                  * be sure to get an mbuf that does not have a cluster
 890                  * associated with it.
 891                  */
 892                 if (copyhdr)
 893                         n = m_gethdr(wait, m->m_type);
 894                 else
 895                         n = m_get(wait, m->m_type);
 896                 *np = n;
 897                 if (n == NULL)
 898                         goto nospace;
 899                 if (copyhdr) {
 900                         if (!m_dup_pkthdr(n, m, wait))
 901                                 goto nospace;
 902                         if (len == M_COPYALL)
 903                                 n->m_pkthdr.len -= off0;
 904                         else
 905                                 n->m_pkthdr.len = len;
 906                         copyhdr = 0;
 907                 }
 908                 n->m_len = min(len, m->m_len - off);
 909                 if (m->m_flags & M_EXT) {
 910                         KKASSERT((n->m_flags & M_EXT) == 0);
 911                         n->m_data = m->m_data + off;
 912                         m->m_ext.ext_ref(m->m_ext.ext_arg);
 913                         n->m_ext = m->m_ext;
 914                         n->m_flags |= m->m_flags & (M_EXT | M_EXT_CLUSTER);
 915                 } else {
 916                         bcopy(mtod(m, caddr_t)+off, mtod(n, caddr_t),
 917                             (unsigned)n->m_len);
 918                 }
 919                 if (len != M_COPYALL)
 920                         len -= n->m_len;
 921                 off = 0;
 922                 m = m->m_next;
 923                 np = &n->m_next;
 924         }
 925         if (top == NULL)
 926                 mbstat.m_mcfail++;
 927         return (top);
 928 nospace:
 929         m_freem(top);
 930         mbstat.m_mcfail++;
 931         return (NULL);
 932 }
 933
 934 /*
 935  * Copy an entire packet, including header (which must be present).
 936  * An optimization of the common case `m_copym(m, 0, M_COPYALL, how)'.
 937  * Note that the copy is read-only, because clusters are not copied,
 938  * only their reference counts are incremented.
 939  * Preserve alignment of the first mbuf so if the creator has left
 940  * some room at the beginning (e.g. for inserting protocol headers)
 941  * the copies also have the room available.
 942  */
 943 struct mbuf *
 944 m_copypacket(struct mbuf *m, int how)
 945 {
 946         struct mbuf *top, *n, *o;
 947
 948         n = m_gethdr(how, m->m_type);
 949         top = n;
 950         if (!n)
 951                 goto nospace;
 952
 953         if (!m_dup_pkthdr(n, m, how))
 954                 goto nospace;
 955         n->m_len = m->m_len;
 956         if (m->m_flags & M_EXT) {
 957                 KKASSERT((n->m_flags & M_EXT) == 0);
 958                 n->m_data = m->m_data;
 959                 m->m_ext.ext_ref(m->m_ext.ext_arg);
 960                 n->m_ext = m->m_ext;
 961                 n->m_flags |= m->m_flags & (M_EXT | M_EXT_CLUSTER);
 962         } else {
 963                 n->m_data = n->m_pktdat + (m->m_data - m->m_pktdat );
 964                 bcopy(mtod(m, char *), mtod(n, char *), n->m_len);
 965         }
 966
 967         m = m->m_next;
 968         while (m) {
 969                 o = m_get(how, m->m_type);
 970                 if (!o)
 971                         goto nospace;
 972
 973                 n->m_next = o;
 974                 n = n->m_next;
 975
 976                 n->m_len = m->m_len;
 977                 if (m->m_flags & M_EXT) {
 978                         KKASSERT((n->m_flags & M_EXT) == 0);
 979                         n->m_data = m->m_data;
 980                         m->m_ext.ext_ref(m->m_ext.ext_arg);
 981                         n->m_ext = m->m_ext;
 982                         n->m_flags |= m->m_flags & (M_EXT | M_EXT_CLUSTER);
 983                 } else {
 984                         bcopy(mtod(m, char *), mtod(n, char *), n->m_len);
 985                 }
 986
 987                 m = m->m_next;
 988         }
 989         return top;
 990 nospace:
 991         m_freem(top);
 992         mbstat.m_mcfail++;
 993         return (NULL);
 994 }
 995
 996 /*
 997  * Copy data from an mbuf chain starting "off" bytes from the beginning,
 998  * continuing for "len" bytes, into the indicated buffer.
 999  */
1000 void
1001 m_copydata(const struct mbuf *m, int off, int len, caddr_t cp)
1002 {
1003         unsigned count;
1004
1005         KASSERT(off >= 0, ("m_copydata, negative off %d", off));
1006         KASSERT(len >= 0, ("m_copydata, negative len %d", len));
1007         while (off > 0) {
1008                 KASSERT(m != NULL, ("m_copydata, offset > size of mbuf chain"));
1009                 if (off < m->m_len)
1010                         break;
1011                 off -= m->m_len;
1012                 m = m->m_next;
1013         }
1014         while (len > 0) {
1015                 KASSERT(m != NULL, ("m_copydata, length > size of mbuf chain"));
1016                 count = min(m->m_len - off, len);
1017                 bcopy(mtod(m, caddr_t) + off, cp, count);
1018                 len -= count;
1019                 cp += count;
1020                 off = 0;
1021                 m = m->m_next;
1022         }
1023 }
1024
1025 /*
1026  * Copy a packet header mbuf chain into a completely new chain, including
1027  * copying any mbuf clusters.  Use this instead of m_copypacket() when
1028  * you need a writable copy of an mbuf chain.
1029  */
1030 struct mbuf *
1031 m_dup(struct mbuf *m, int how)
1032 {
1033         struct mbuf **p, *top = NULL;
1034         int remain, moff, nsize;
1035
1036         /* Sanity check */
1037         if (m == NULL)
1038                 return (NULL);
1039         KASSERT((m->m_flags & M_PKTHDR) != 0, ("%s: !PKTHDR", __func__));
1040
1041         /* While there's more data, get a new mbuf, tack it on, and fill it */
1042         remain = m->m_pkthdr.len;
1043         moff = 0;
1044         p = &top;
1045         while (remain > 0 || top == NULL) {     /* allow m->m_pkthdr.len == 0 */
1046                 struct mbuf *n;
1047
1048                 /* Get the next new mbuf */
1049                 n = m_getl(remain, how, m->m_type, top == NULL ? M_PKTHDR : 0,
1050                            &nsize);
1051                 if (n == NULL)
1052                         goto nospace;
1053                 if (top == NULL)
1054                         if (!m_dup_pkthdr(n, m, how))
1055                                 goto nospace0;
1056
1057                 /* Link it into the new chain */
1058                 *p = n;
1059                 p = &n->m_next;
1060
1061                 /* Copy data from original mbuf(s) into new mbuf */
1062                 n->m_len = 0;
1063                 while (n->m_len < nsize && m != NULL) {
1064                         int chunk = min(nsize - n->m_len, m->m_len - moff);
1065
1066                         bcopy(m->m_data + moff, n->m_data + n->m_len, chunk);
1067                         moff += chunk;
1068                         n->m_len += chunk;
1069                         remain -= chunk;
1070                         if (moff == m->m_len) {
1071                                 m = m->m_next;
1072                                 moff = 0;
1073                         }
1074                 }
1075
1076                 /* Check correct total mbuf length */
1077                 KASSERT((remain > 0 && m != NULL) || (remain == 0 && m == NULL),
1078                         ("%s: bogus m_pkthdr.len", __func__));
1079         }
1080         return (top);
1081
1082 nospace:
1083         m_freem(top);
1084 nospace0:
1085         mbstat.m_mcfail++;
1086         return (NULL);
1087 }
1088
1089 /*
1090  * Concatenate mbuf chain n to m.
1091  * Both chains must be of the same type (e.g. MT_DATA).
1092  * Any m_pkthdr is not updated.
1093  */
1094 void
1095 m_cat(struct mbuf *m, struct mbuf *n)
1096 {
1097         m = m_last(m);
1098         while (n) {
1099                 if (m->m_flags & M_EXT ||
1100                     m->m_data + m->m_len + n->m_len >= &m->m_dat[MLEN]) {
1101                         /* just join the two chains */
1102                         m->m_next = n;
1103                         return;
1104                 }
1105                 /* splat the data from one into the other */
1106                 bcopy(mtod(n, caddr_t), mtod(m, caddr_t) + m->m_len,
1107                     (u_int)n->m_len);
1108                 m->m_len += n->m_len;
1109                 n = m_free(n);
1110         }
1111 }
1112
1113 void
1114 m_adj(struct mbuf *mp, int req_len)
1115 {
1116         int len = req_len;
1117         struct mbuf *m;
1118         int count;
1119
1120         if ((m = mp) == NULL)
1121                 return;
1122         if (len >= 0) {
1123                 /*
1124                  * Trim from head.
1125                  */
1126                 while (m != NULL && len > 0) {
1127                         if (m->m_len <= len) {
1128                                 len -= m->m_len;
1129                                 m->m_len = 0;
1130                                 m = m->m_next;
1131                         } else {
1132                                 m->m_len -= len;
1133                                 m->m_data += len;
1134                                 len = 0;
1135                         }
1136                 }
1137                 m = mp;
1138                 if (mp->m_flags & M_PKTHDR)
1139                         m->m_pkthdr.len -= (req_len - len);
1140         } else {
1141                 /*
1142                  * Trim from tail.  Scan the mbuf chain,
1143                  * calculating its length and finding the last mbuf.
1144                  * If the adjustment only affects this mbuf, then just
1145                  * adjust and return.  Otherwise, rescan and truncate
1146                  * after the remaining size.
1147                  */
1148                 len = -len;
1149                 count = 0;
1150                 for (;;) {
1151                         count += m->m_len;
1152                         if (m->m_next == (struct mbuf *)0)
1153                                 break;
1154                         m = m->m_next;
1155                 }
1156                 if (m->m_len >= len) {
1157                         m->m_len -= len;
1158                         if (mp->m_flags & M_PKTHDR)
1159                                 mp->m_pkthdr.len -= len;
1160                         return;
1161                 }
1162                 count -= len;
1163                 if (count < 0)
1164                         count = 0;
1165                 /*
1166                  * Correct length for chain is "count".
1167                  * Find the mbuf with last data, adjust its length,
1168                  * and toss data from remaining mbufs on chain.
1169                  */
1170                 m = mp;
1171                 if (m->m_flags & M_PKTHDR)
1172                         m->m_pkthdr.len = count;
1173                 for (; m; m = m->m_next) {
1174                         if (m->m_len >= count) {
1175                                 m->m_len = count;
1176                                 break;
1177                         }
1178                         count -= m->m_len;
1179                 }
1180                 while (m->m_next)
1181                         (m = m->m_next) ->m_len = 0;
1182         }
1183 }
1184
1185 /*
1186  * Rearrange an mbuf chain so that len bytes are contiguous
1187  * and in the data area of an mbuf (so that mtod will work for a structure
1188  * of size len).  Returns the resulting mbuf chain on success, frees it and
1189  * returns null on failure.  If there is room, it will add up to
1190  * max_protohdr-len extra bytes to the contiguous region in an attempt to
1191  * avoid being called next time.
1192  */
1193 struct mbuf *
1194 m_pullup(struct mbuf *n, int len)
1195 {
1196         struct mbuf *m;
1197         int count;
1198         int space;
1199
1200         /*
1201          * If first mbuf has no cluster, and has room for len bytes
1202          * without shifting current data, pullup into it,
1203          * otherwise allocate a new mbuf to prepend to the chain.
1204          */
1205         if (!(n->m_flags & M_EXT) &&
1206             n->m_data + len < &n->m_dat[MLEN] &&
1207             n->m_next) {
1208                 if (n->m_len >= len)
1209                         return (n);
1210                 m = n;
1211                 n = n->m_next;
1212                 len -= m->m_len;
1213         } else {
1214                 if (len > MHLEN)
1215                         goto bad;
1216                 if (n->m_flags & M_PKTHDR)
1217                         m = m_gethdr(MB_DONTWAIT, n->m_type);
1218                 else
1219                         m = m_get(MB_DONTWAIT, n->m_type);
1220                 if (m == NULL)
1221                         goto bad;
1222                 m->m_len = 0;
1223                 if (n->m_flags & M_PKTHDR)
1224                         M_MOVE_PKTHDR(m, n);
1225         }
1226         space = &m->m_dat[MLEN] - (m->m_data + m->m_len);
1227         do {
1228                 count = min(min(max(len, max_protohdr), space), n->m_len);
1229                 bcopy(mtod(n, caddr_t), mtod(m, caddr_t) + m->m_len,
1230                   (unsigned)count);
1231                 len -= count;
1232                 m->m_len += count;
1233                 n->m_len -= count;
1234                 space -= count;
1235                 if (n->m_len)
1236                         n->m_data += count;
1237                 else
1238                         n = m_free(n);
1239         } while (len > 0 && n);
1240         if (len > 0) {
1241                 m_free(m);
1242                 goto bad;
1243         }
1244         m->m_next = n;
1245         return (m);
1246 bad:
1247         m_freem(n);
1248         mbstat.m_mpfail++;
1249         return (NULL);
1250 }
1251
1252 /*
1253  * Partition an mbuf chain in two pieces, returning the tail --
1254  * all but the first len0 bytes.  In case of failure, it returns NULL and
1255  * attempts to restore the chain to its original state.
1256  *
1257  * Note that the resulting mbufs might be read-only, because the new
1258  * mbuf can end up sharing an mbuf cluster with the original mbuf if
1259  * the "breaking point" happens to lie within a cluster mbuf. Use the
1260  * M_WRITABLE() macro to check for this case.
1261  */
1262 struct mbuf *
1263 m_split(struct mbuf *m0, int len0, int wait)
1264 {
1265         struct mbuf *m, *n;
1266         unsigned len = len0, remain;
1267
1268         for (m = m0; m && len > m->m_len; m = m->m_next)
1269                 len -= m->m_len;
1270         if (m == NULL)
1271                 return (NULL);
1272         remain = m->m_len - len;
1273         if (m0->m_flags & M_PKTHDR) {
1274                 n = m_gethdr(wait, m0->m_type);
1275                 if (n == NULL)
1276                         return (NULL);
1277                 n->m_pkthdr.rcvif = m0->m_pkthdr.rcvif;
1278                 n->m_pkthdr.len = m0->m_pkthdr.len - len0;
1279                 m0->m_pkthdr.len = len0;
1280                 if (m->m_flags & M_EXT)
1281                         goto extpacket;
1282                 if (remain > MHLEN) {
1283                         /* m can't be the lead packet */
1284                         MH_ALIGN(n, 0);
1285                         n->m_next = m_split(m, len, wait);
1286                         if (n->m_next == NULL) {
1287                                 m_free(n);
1288                                 return (NULL);
1289                         } else {
1290                                 n->m_len = 0;
1291                                 return (n);
1292                         }
1293                 } else
1294                         MH_ALIGN(n, remain);
1295         } else if (remain == 0) {
1296                 n = m->m_next;
1297                 m->m_next = 0;
1298                 return (n);
1299         } else {
1300                 n = m_get(wait, m->m_type);
1301                 if (n == NULL)
1302                         return (NULL);
1303                 M_ALIGN(n, remain);
1304         }
1305 extpacket:
1306         if (m->m_flags & M_EXT) {
1307                 KKASSERT((n->m_flags & M_EXT) == 0);
1308                 n->m_data = m->m_data + len;
1309                 m->m_ext.ext_ref(m->m_ext.ext_arg);
1310                 n->m_ext = m->m_ext;
1311                 n->m_flags |= m->m_flags & (M_EXT | M_EXT_CLUSTER);
1312         } else {
1313                 bcopy(mtod(m, caddr_t) + len, mtod(n, caddr_t), remain);
1314         }
1315         n->m_len = remain;
1316         m->m_len = len;
1317         n->m_next = m->m_next;
1318         m->m_next = 0;
1319         return (n);
1320 }
1321
1322 /*
1323  * Routine to copy from device local memory into mbufs.
1324  * Note: "offset" is ill-defined and always called as 0, so ignore it.
1325  */
1326 struct mbuf *
1327 m_devget(char *buf, int len, int offset, struct ifnet *ifp,
1328     void (*copy)(volatile const void *from, volatile void *to, size_t length))
1329 {
1330         struct mbuf *m, *mfirst = NULL, **mtail;
1331         int nsize, flags;
1332
1333         if (copy == NULL)
1334                 copy = bcopy;
1335         mtail = &mfirst;
1336         flags = M_PKTHDR;
1337
1338         while (len > 0) {
1339                 m = m_getl(len, MB_DONTWAIT, MT_DATA, flags, &nsize);
1340                 if (m == NULL) {
1341                         m_freem(mfirst);
1342                         return (NULL);
1343                 }
1344                 m->m_len = min(len, nsize);
1345
1346                 if (flags & M_PKTHDR) {
1347                         if (len + max_linkhdr <= nsize)
1348                                 m->m_data += max_linkhdr;
1349                         m->m_pkthdr.rcvif = ifp;
1350                         m->m_pkthdr.len = len;
1351                         flags = 0;
1352                 }
1353
1354                 copy(buf, m->m_data, (unsigned)m->m_len);
1355                 buf += m->m_len;
1356                 len -= m->m_len;
1357                 *mtail = m;
1358                 mtail = &m->m_next;
1359         }
1360
1361         return (mfirst);
1362 }
1363
1364 /*
1365  * Copy data from a buffer back into the indicated mbuf chain,
1366  * starting "off" bytes from the beginning, extending the mbuf
1367  * chain if necessary.
1368  */
1369 void
1370 m_copyback(struct mbuf *m0, int off, int len, caddr_t cp)
1371 {
1372         int mlen;
1373         struct mbuf *m = m0, *n;
1374         int totlen = 0;
1375
1376         if (m0 == NULL)
1377                 return;
1378         while (off > (mlen = m->m_len)) {
1379                 off -= mlen;
1380                 totlen += mlen;
1381                 if (m->m_next == NULL) {
1382                         n = m_getclr(MB_DONTWAIT, m->m_type);
1383                         if (n == NULL)
1384                                 goto out;
1385                         n->m_len = min(MLEN, len + off);
1386                         m->m_next = n;
1387                 }
1388                 m = m->m_next;
1389         }
1390         while (len > 0) {
1391                 mlen = min (m->m_len - off, len);
1392                 bcopy(cp, off + mtod(m, caddr_t), (unsigned)mlen);
1393                 cp += mlen;
1394                 len -= mlen;
1395                 mlen += off;
1396                 off = 0;
1397                 totlen += mlen;
1398                 if (len == 0)
1399                         break;
1400                 if (m->m_next == NULL) {
1401                         n = m_get(MB_DONTWAIT, m->m_type);
1402                         if (n == NULL)
1403                                 break;
1404                         n->m_len = min(MLEN, len);
1405                         m->m_next = n;
1406                 }
1407                 m = m->m_next;
1408         }
1409 out:    if (((m = m0)->m_flags & M_PKTHDR) && (m->m_pkthdr.len < totlen))
1410                 m->m_pkthdr.len = totlen;
1411 }
1412
1413 void
1414 m_print(const struct mbuf *m)
1415 {
1416         int len;
1417         const struct mbuf *m2;
1418
1419         len = m->m_pkthdr.len;
1420         m2 = m;
1421         while (len) {
1422                 printf("%p %*D\n", m2, m2->m_len, (u_char *)m2->m_data, "-");
1423                 len -= m2->m_len;
1424                 m2 = m2->m_next;
1425         }
1426         return;
1427 }
1428
1429 /*
1430  * "Move" mbuf pkthdr from "from" to "to".
1431  * "from" must have M_PKTHDR set, and "to" must be empty.
1432  */
1433 void
1434 m_move_pkthdr(struct mbuf *to, struct mbuf *from)
1435 {
1436         KASSERT((to->m_flags & M_PKTHDR), ("m_move_pkthdr: not packet header"));
1437
1438         to->m_flags |= from->m_flags & M_COPYFLAGS;
1439         to->m_pkthdr = from->m_pkthdr;          /* especially tags */
1440         SLIST_INIT(&from->m_pkthdr.tags);       /* purge tags from src */
1441 }
1442
1443 /*
1444  * Duplicate "from"'s mbuf pkthdr in "to".
1445  * "from" must have M_PKTHDR set, and "to" must be empty.
1446  * In particular, this does a deep copy of the packet tags.
1447  */
1448 int
1449 m_dup_pkthdr(struct mbuf *to, const struct mbuf *from, int how)
1450 {
1451         KASSERT((to->m_flags & M_PKTHDR), ("m_dup_pkthdr: not packet header"));
1452
1453         to->m_flags = (from->m_flags & M_COPYFLAGS) |
1454                       (to->m_flags & ~M_COPYFLAGS);
1455         to->m_pkthdr = from->m_pkthdr;
1456         SLIST_INIT(&to->m_pkthdr.tags);
1457         return (m_tag_copy_chain(to, from, how));
1458 }
1459
1460 /*
1461  * Defragment a mbuf chain, returning the shortest possible
1462  * chain of mbufs and clusters.  If allocation fails and
1463  * this cannot be completed, NULL will be returned, but
1464  * the passed in chain will be unchanged.  Upon success,
1465  * the original chain will be freed, and the new chain
1466  * will be returned.
1467  *
1468  * If a non-packet header is passed in, the original
1469  * mbuf (chain?) will be returned unharmed.
1470  *
1471  * m_defrag_nofree doesn't free the passed in mbuf.
1472  */
1473 struct mbuf *
1474 m_defrag(struct mbuf *m0, int how)
1475 {
1476         struct mbuf *m_new;
1477
1478         if ((m_new = m_defrag_nofree(m0, how)) == NULL)
1479                 return (NULL);
1480         if (m_new != m0)
1481                 m_freem(m0);
1482         return (m_new);
1483 }
1484
1485 struct mbuf *
1486 m_defrag_nofree(struct mbuf *m0, int how)
1487 {
1488         struct mbuf     *m_new = NULL, *m_final = NULL;
1489         int             progress = 0, length, nsize;
1490
1491         if (!(m0->m_flags & M_PKTHDR))
1492                 return (m0);
1493
1494 #ifdef MBUF_STRESS_TEST
1495         if (m_defragrandomfailures) {
1496                 int temp = arc4random() & 0xff;
1497                 if (temp == 0xba)
1498                         goto nospace;
1499         }
1500 #endif
1501
1502         m_final = m_getl(m0->m_pkthdr.len, how, MT_DATA, M_PKTHDR, &nsize);
1503         if (m_final == NULL)
1504                 goto nospace;
1505         m_final->m_len = 0;     /* in case m0->m_pkthdr.len is zero */
1506
1507         if (m_dup_pkthdr(m_final, m0, how) == NULL)
1508                 goto nospace;
1509
1510         m_new = m_final;
1511
1512         while (progress < m0->m_pkthdr.len) {
1513                 length = m0->m_pkthdr.len - progress;
1514                 if (length > MCLBYTES)
1515                         length = MCLBYTES;
1516
1517                 if (m_new == NULL) {
1518                         m_new = m_getl(length, how, MT_DATA, 0, &nsize);
1519                         if (m_new == NULL)
1520                                 goto nospace;
1521                 }
1522
1523                 m_copydata(m0, progress, length, mtod(m_new, caddr_t));
1524                 progress += length;
1525                 m_new->m_len = length;
1526                 if (m_new != m_final)
1527                         m_cat(m_final, m_new);
1528                 m_new = NULL;
1529         }
1530         if (m0->m_next == NULL)
1531                 m_defraguseless++;
1532         m_defragpackets++;
1533         m_defragbytes += m_final->m_pkthdr.len;
1534         return (m_final);
1535 nospace:
1536         m_defragfailure++;
1537         if (m_new)
1538                 m_free(m_new);
1539         m_freem(m_final);
1540         return (NULL);
1541 }
1542
1543 /*
1544  * Move data from uio into mbufs.
1545  */
1546 struct mbuf *
1547 m_uiomove(struct uio *uio)
1548 {
1549         struct mbuf *m;                 /* current working mbuf */
1550         struct mbuf *head = NULL;       /* result mbuf chain */
1551         struct mbuf **mp = &head;
1552         int resid = uio->uio_resid, nsize, flags = M_PKTHDR, error;
1553
1554         do {
1555                 m = m_getl(resid, MB_WAIT, MT_DATA, flags, &nsize);
1556                 if (flags) {
1557                         m->m_pkthdr.len = 0;
1558                         /* Leave room for protocol headers. */
1559                         if (resid < MHLEN)
1560                                 MH_ALIGN(m, resid);
1561                         flags = 0;
1562                 }
1563                 m->m_len = min(nsize, resid);
1564                 error = uiomove(mtod(m, caddr_t), m->m_len, uio);
1565                 if (error) {
1566                         m_free(m);
1567                         goto failed;
1568                 }
1569                 *mp = m;
1570                 mp = &m->m_next;
1571                 head->m_pkthdr.len += m->m_len;
1572                 resid -= m->m_len;
1573         } while (resid > 0);
1574
1575         return (head);
1576
1577 failed:
1578         m_freem(head);
1579         return (NULL);
1580 }
1581
1582 struct mbuf *
1583 m_last(struct mbuf *m)
1584 {
1585         while (m->m_next)
1586                 m = m->m_next;
1587         return (m);
1588 }
1589
1590 /*
1591  * Return the number of bytes in an mbuf chain.
1592  * If lastm is not NULL, also return the last mbuf.
1593  */
1594 u_int
1595 m_lengthm(struct mbuf *m, struct mbuf **lastm)
1596 {
1597         u_int len = 0;
1598         struct mbuf *prev = m;
1599
1600         while (m) {
1601                 len += m->m_len;
1602                 prev = m;
1603                 m = m->m_next;
1604         }
1605         if (lastm != NULL)
1606                 *lastm = prev;
1607         return (len);
1608 }
1609
1610 /*
1611  * Like m_lengthm(), except also keep track of mbuf usage.
1612  */
1613 u_int
1614 m_countm(struct mbuf *m, struct mbuf **lastm, u_int *pmbcnt)
1615 {
1616         u_int len = 0, mbcnt = 0;
1617         struct mbuf *prev = m;
1618
1619         while (m) {
1620                 len += m->m_len;
1621                 mbcnt += MSIZE;
1622                 if (m->m_flags & M_EXT)
1623                         mbcnt += m->m_ext.ext_size;
1624                 prev = m;
1625                 m = m->m_next;
1626         }
1627         if (lastm != NULL)
1628                 *lastm = prev;
1629         *pmbcnt = mbcnt;
1630         return (len);
1631 }