sys/kern/uipc_sockbuf.c

   1 /*-
   2  * Copyright (c) 1982, 1986, 1988, 1990, 1993
   3  *      The Regents of the University of California.  All rights reserved.
   4  *
   5  * Redistribution and use in source and binary forms, with or without
   6  * modification, are permitted provided that the following conditions
   7  * are met:
   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  * 4. 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.
  16  *
  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
  27  * SUCH DAMAGE.
  28  *
  29  *      @(#)uipc_socket2.c      8.1 (Berkeley) 6/10/93
  30  */
  31
  32 #include <sys/cdefs.h>
  33 __FBSDID("$FreeBSD$");
  34
  35 #include "opt_param.h"
  36
  37 #include <sys/param.h>
  38 #include <sys/aio.h> /* for aio_swake proto */
  39 #include <sys/kernel.h>
  40 #include <sys/lock.h>
  41 #include <sys/mbuf.h>
  42 #include <sys/mutex.h>
  43 #include <sys/proc.h>
  44 #include <sys/protosw.h>
  45 #include <sys/resourcevar.h>
  46 #include <sys/signalvar.h>
  47 #include <sys/socket.h>
  48 #include <sys/socketvar.h>
  49 #include <sys/sx.h>
  50 #include <sys/sysctl.h>
  51
  52 /*
  53  * Function pointer set by the AIO routines so that the socket buffer code
  54  * can call back into the AIO module if it is loaded.
  55  */
  56 void    (*aio_swake)(struct socket *, struct sockbuf *);
  57
  58 /*
  59  * Primitive routines for operating on socket buffers
  60  */
  61
  62 u_long  sb_max = SB_MAX;
  63 u_long sb_max_adj =
  64        SB_MAX * MCLBYTES / (MSIZE + MCLBYTES); /* adjusted sb_max */
  65
  66 static  u_long sb_efficiency = 8;       /* parameter for sbreserve() */
  67
  68 static void     sbdrop_internal(struct sockbuf *sb, int len);
  69 static void     sbflush_internal(struct sockbuf *sb);
  70
  71 /*
  72  * Socantsendmore indicates that no more data will be sent on the socket; it
  73  * would normally be applied to a socket when the user informs the system
  74  * that no more data is to be sent, by the protocol code (in case
  75  * PRU_SHUTDOWN).  Socantrcvmore indicates that no more data will be
  76  * received, and will normally be applied to the socket by a protocol when it
  77  * detects that the peer will send no more data.  Data queued for reading in
  78  * the socket may yet be read.
  79  */
  80 void
  81 socantsendmore_locked(struct socket *so)
  82 {
  83
  84         SOCKBUF_LOCK_ASSERT(&so->so_snd);
  85
  86         so->so_snd.sb_state |= SBS_CANTSENDMORE;
  87         sowwakeup_locked(so);
  88         mtx_assert(SOCKBUF_MTX(&so->so_snd), MA_NOTOWNED);
  89 }
  90
  91 void
  92 socantsendmore(struct socket *so)
  93 {
  94
  95         SOCKBUF_LOCK(&so->so_snd);
  96         socantsendmore_locked(so);
  97         mtx_assert(SOCKBUF_MTX(&so->so_snd), MA_NOTOWNED);
  98 }
  99
 100 void
 101 socantrcvmore_locked(struct socket *so)
 102 {
 103
 104         SOCKBUF_LOCK_ASSERT(&so->so_rcv);
 105
 106         so->so_rcv.sb_state |= SBS_CANTRCVMORE;
 107         sorwakeup_locked(so);
 108         mtx_assert(SOCKBUF_MTX(&so->so_rcv), MA_NOTOWNED);
 109 }
 110
 111 void
 112 socantrcvmore(struct socket *so)
 113 {
 114
 115         SOCKBUF_LOCK(&so->so_rcv);
 116         socantrcvmore_locked(so);
 117         mtx_assert(SOCKBUF_MTX(&so->so_rcv), MA_NOTOWNED);
 118 }
 119
 120 /*
 121  * Wait for data to arrive at/drain from a socket buffer.
 122  */
 123 int
 124 sbwait(struct sockbuf *sb)
 125 {
 126
 127         SOCKBUF_LOCK_ASSERT(sb);
 128
 129         sb->sb_flags |= SB_WAIT;
 130         return (msleep(&sb->sb_cc, &sb->sb_mtx,
 131             (sb->sb_flags & SB_NOINTR) ? PSOCK : PSOCK | PCATCH, "sbwait",
 132             sb->sb_timeo));
 133 }
 134
 135 int
 136 sblock(struct sockbuf *sb, int flags)
 137 {
 138
 139         KASSERT((flags & SBL_VALID) == flags,
 140             ("sblock: flags invalid (0x%x)", flags));
 141
 142         if (flags & SBL_WAIT) {
 143                 if ((sb->sb_flags & SB_NOINTR) ||
 144                     (flags & SBL_NOINTR)) {
 145                         sx_xlock(&sb->sb_sx);
 146                         return (0);
 147                 }
 148                 return (sx_xlock_sig(&sb->sb_sx));
 149         } else {
 150                 if (sx_try_xlock(&sb->sb_sx) == 0)
 151                         return (EWOULDBLOCK);
 152                 return (0);
 153         }
 154 }
 155
 156 void
 157 sbunlock(struct sockbuf *sb)
 158 {
 159
 160         sx_xunlock(&sb->sb_sx);
 161 }
 162
 163 /*
 164  * Wakeup processes waiting on a socket buffer.  Do asynchronous notification
 165  * via SIGIO if the socket has the SS_ASYNC flag set.
 166  *
 167  * Called with the socket buffer lock held; will release the lock by the end
 168  * of the function.  This allows the caller to acquire the socket buffer lock
 169  * while testing for the need for various sorts of wakeup and hold it through
 170  * to the point where it's no longer required.  We currently hold the lock
 171  * through calls out to other subsystems (with the exception of kqueue), and
 172  * then release it to avoid lock order issues.  It's not clear that's
 173  * correct.
 174  */
 175 void
 176 sowakeup(struct socket *so, struct sockbuf *sb)
 177 {
 178
 179         SOCKBUF_LOCK_ASSERT(sb);
 180
 181         selwakeuppri(&sb->sb_sel, PSOCK);
 182         if (!SEL_WAITING(&sb->sb_sel))
 183                 sb->sb_flags &= ~SB_SEL;
 184         if (sb->sb_flags & SB_WAIT) {
 185                 sb->sb_flags &= ~SB_WAIT;
 186                 wakeup(&sb->sb_cc);
 187         }
 188         KNOTE_LOCKED(&sb->sb_sel.si_note, 0);
 189         SOCKBUF_UNLOCK(sb);
 190         if ((so->so_state & SS_ASYNC) && so->so_sigio != NULL)
 191                 pgsigio(&so->so_sigio, SIGIO, 0);
 192         if (sb->sb_flags & SB_UPCALL)
 193                 (*so->so_upcall)(so, so->so_upcallarg, M_DONTWAIT);
 194         if (sb->sb_flags & SB_AIO)
 195                 aio_swake(so, sb);
 196         mtx_assert(SOCKBUF_MTX(sb), MA_NOTOWNED);
 197 }
 198
 199 /*
 200  * Socket buffer (struct sockbuf) utility routines.
 201  *
 202  * Each socket contains two socket buffers: one for sending data and one for
 203  * receiving data.  Each buffer contains a queue of mbufs, information about
 204  * the number of mbufs and amount of data in the queue, and other fields
 205  * allowing select() statements and notification on data availability to be
 206  * implemented.
 207  *
 208  * Data stored in a socket buffer is maintained as a list of records.  Each
 209  * record is a list of mbufs chained together with the m_next field.  Records
 210  * are chained together with the m_nextpkt field. The upper level routine
 211  * soreceive() expects the following conventions to be observed when placing
 212  * information in the receive buffer:
 213  *
 214  * 1. If the protocol requires each message be preceded by the sender's name,
 215  *    then a record containing that name must be present before any
 216  *    associated data (mbuf's must be of type MT_SONAME).
 217  * 2. If the protocol supports the exchange of ``access rights'' (really just
 218  *    additional data associated with the message), and there are ``rights''
 219  *    to be received, then a record containing this data should be present
 220  *    (mbuf's must be of type MT_RIGHTS).
 221  * 3. If a name or rights record exists, then it must be followed by a data
 222  *    record, perhaps of zero length.
 223  *
 224  * Before using a new socket structure it is first necessary to reserve
 225  * buffer space to the socket, by calling sbreserve().  This should commit
 226  * some of the available buffer space in the system buffer pool for the
 227  * socket (currently, it does nothing but enforce limits).  The space should
 228  * be released by calling sbrelease() when the socket is destroyed.
 229  */
 230 int
 231 soreserve(struct socket *so, u_long sndcc, u_long rcvcc)
 232 {
 233         struct thread *td = curthread;
 234
 235         SOCKBUF_LOCK(&so->so_snd);
 236         SOCKBUF_LOCK(&so->so_rcv);
 237         if (sbreserve_locked(&so->so_snd, sndcc, so, td) == 0)
 238                 goto bad;
 239         if (sbreserve_locked(&so->so_rcv, rcvcc, so, td) == 0)
 240                 goto bad2;
 241         if (so->so_rcv.sb_lowat == 0)
 242                 so->so_rcv.sb_lowat = 1;
 243         if (so->so_snd.sb_lowat == 0)
 244                 so->so_snd.sb_lowat = MCLBYTES;
 245         if (so->so_snd.sb_lowat > so->so_snd.sb_hiwat)
 246                 so->so_snd.sb_lowat = so->so_snd.sb_hiwat;
 247         SOCKBUF_UNLOCK(&so->so_rcv);
 248         SOCKBUF_UNLOCK(&so->so_snd);
 249         return (0);
 250 bad2:
 251         sbrelease_locked(&so->so_snd, so);
 252 bad:
 253         SOCKBUF_UNLOCK(&so->so_rcv);
 254         SOCKBUF_UNLOCK(&so->so_snd);
 255         return (ENOBUFS);
 256 }
 257
 258 static int
 259 sysctl_handle_sb_max(SYSCTL_HANDLER_ARGS)
 260 {
 261         int error = 0;
 262         u_long tmp_sb_max = sb_max;
 263
 264         error = sysctl_handle_long(oidp, &tmp_sb_max, arg2, req);
 265         if (error || !req->newptr)
 266                 return (error);
 267         if (tmp_sb_max < MSIZE + MCLBYTES)
 268                 return (EINVAL);
 269         sb_max = tmp_sb_max;
 270         sb_max_adj = (u_quad_t)sb_max * MCLBYTES / (MSIZE + MCLBYTES);
 271         return (0);
 272 }
 273
 274 /*
 275  * Allot mbufs to a sockbuf.  Attempt to scale mbmax so that mbcnt doesn't
 276  * become limiting if buffering efficiency is near the normal case.
 277  */
 278 int
 279 sbreserve_locked(struct sockbuf *sb, u_long cc, struct socket *so,
 280     struct thread *td)
 281 {
 282         rlim_t sbsize_limit;
 283
 284         SOCKBUF_LOCK_ASSERT(sb);
 285
 286         /*
 287          * When a thread is passed, we take into account the thread's socket
 288          * buffer size limit.  The caller will generally pass curthread, but
 289          * in the TCP input path, NULL will be passed to indicate that no
 290          * appropriate thread resource limits are available.  In that case,
 291          * we don't apply a process limit.
 292          */
 293         if (cc > sb_max_adj)
 294                 return (0);
 295         if (td != NULL) {
 296                 PROC_LOCK(td->td_proc);
 297                 sbsize_limit = lim_cur(td->td_proc, RLIMIT_SBSIZE);
 298                 PROC_UNLOCK(td->td_proc);
 299         } else
 300                 sbsize_limit = RLIM_INFINITY;
 301         if (!chgsbsize(so->so_cred->cr_uidinfo, &sb->sb_hiwat, cc,
 302             sbsize_limit))
 303                 return (0);
 304         sb->sb_mbmax = min(cc * sb_efficiency, sb_max);
 305         if (sb->sb_lowat > sb->sb_hiwat)
 306                 sb->sb_lowat = sb->sb_hiwat;
 307         return (1);
 308 }
 309
 310 int
 311 sbreserve(struct sockbuf *sb, u_long cc, struct socket *so,
 312     struct thread *td)
 313 {
 314         int error;
 315
 316         SOCKBUF_LOCK(sb);
 317         error = sbreserve_locked(sb, cc, so, td);
 318         SOCKBUF_UNLOCK(sb);
 319         return (error);
 320 }
 321
 322 /*
 323  * Free mbufs held by a socket, and reserved mbuf space.
 324  */
 325 void
 326 sbrelease_internal(struct sockbuf *sb, struct socket *so)
 327 {
 328
 329         sbflush_internal(sb);
 330         (void)chgsbsize(so->so_cred->cr_uidinfo, &sb->sb_hiwat, 0,
 331             RLIM_INFINITY);
 332         sb->sb_mbmax = 0;
 333 }
 334
 335 void
 336 sbrelease_locked(struct sockbuf *sb, struct socket *so)
 337 {
 338
 339         SOCKBUF_LOCK_ASSERT(sb);
 340
 341         sbrelease_internal(sb, so);
 342 }
 343
 344 void
 345 sbrelease(struct sockbuf *sb, struct socket *so)
 346 {
 347
 348         SOCKBUF_LOCK(sb);
 349         sbrelease_locked(sb, so);
 350         SOCKBUF_UNLOCK(sb);
 351 }
 352
 353 void
 354 sbdestroy(struct sockbuf *sb, struct socket *so)
 355 {
 356
 357         sbrelease_internal(sb, so);
 358 }
 359
 360 /*
 361  * Routines to add and remove data from an mbuf queue.
 362  *
 363  * The routines sbappend() or sbappendrecord() are normally called to append
 364  * new mbufs to a socket buffer, after checking that adequate space is
 365  * available, comparing the function sbspace() with the amount of data to be
 366  * added.  sbappendrecord() differs from sbappend() in that data supplied is
 367  * treated as the beginning of a new record.  To place a sender's address,
 368  * optional access rights, and data in a socket receive buffer,
 369  * sbappendaddr() should be used.  To place access rights and data in a
 370  * socket receive buffer, sbappendrights() should be used.  In either case,
 371  * the new data begins a new record.  Note that unlike sbappend() and
 372  * sbappendrecord(), these routines check for the caller that there will be
 373  * enough space to store the data.  Each fails if there is not enough space,
 374  * or if it cannot find mbufs to store additional information in.
 375  *
 376  * Reliable protocols may use the socket send buffer to hold data awaiting
 377  * acknowledgement.  Data is normally copied from a socket send buffer in a
 378  * protocol with m_copy for output to a peer, and then removing the data from
 379  * the socket buffer with sbdrop() or sbdroprecord() when the data is
 380  * acknowledged by the peer.
 381  */
 382 #ifdef SOCKBUF_DEBUG
 383 void
 384 sblastrecordchk(struct sockbuf *sb, const char *file, int line)
 385 {
 386         struct mbuf *m = sb->sb_mb;
 387
 388         SOCKBUF_LOCK_ASSERT(sb);
 389
 390         while (m && m->m_nextpkt)
 391                 m = m->m_nextpkt;
 392
 393         if (m != sb->sb_lastrecord) {
 394                 printf("%s: sb_mb %p sb_lastrecord %p last %p\n",
 395                         __func__, sb->sb_mb, sb->sb_lastrecord, m);
 396                 printf("packet chain:\n");
 397                 for (m = sb->sb_mb; m != NULL; m = m->m_nextpkt)
 398                         printf("\t%p\n", m);
 399                 panic("%s from %s:%u", __func__, file, line);
 400         }
 401 }
 402
 403 void
 404 sblastmbufchk(struct sockbuf *sb, const char *file, int line)
 405 {
 406         struct mbuf *m = sb->sb_mb;
 407         struct mbuf *n;
 408
 409         SOCKBUF_LOCK_ASSERT(sb);
 410
 411         while (m && m->m_nextpkt)
 412                 m = m->m_nextpkt;
 413
 414         while (m && m->m_next)
 415                 m = m->m_next;
 416
 417         if (m != sb->sb_mbtail) {
 418                 printf("%s: sb_mb %p sb_mbtail %p last %p\n",
 419                         __func__, sb->sb_mb, sb->sb_mbtail, m);
 420                 printf("packet tree:\n");
 421                 for (m = sb->sb_mb; m != NULL; m = m->m_nextpkt) {
 422                         printf("\t");
 423                         for (n = m; n != NULL; n = n->m_next)
 424                                 printf("%p ", n);
 425                         printf("\n");
 426                 }
 427                 panic("%s from %s:%u", __func__, file, line);
 428         }
 429 }
 430 #endif /* SOCKBUF_DEBUG */
 431
 432 #define SBLINKRECORD(sb, m0) do {                                       \
 433         SOCKBUF_LOCK_ASSERT(sb);                                        \
 434         if ((sb)->sb_lastrecord != NULL)                                \
 435                 (sb)->sb_lastrecord->m_nextpkt = (m0);                  \
 436         else                                                            \
 437                 (sb)->sb_mb = (m0);                                     \
 438         (sb)->sb_lastrecord = (m0);                                     \
 439 } while (/*CONSTCOND*/0)
 440
 441 /*
 442  * Append mbuf chain m to the last record in the socket buffer sb.  The
 443  * additional space associated the mbuf chain is recorded in sb.  Empty mbufs
 444  * are discarded and mbufs are compacted where possible.
 445  */
 446 void
 447 sbappend_locked(struct sockbuf *sb, struct mbuf *m)
 448 {
 449         struct mbuf *n;
 450
 451         SOCKBUF_LOCK_ASSERT(sb);
 452
 453         if (m == 0)
 454                 return;
 455
 456         SBLASTRECORDCHK(sb);
 457         n = sb->sb_mb;
 458         if (n) {
 459                 while (n->m_nextpkt)
 460                         n = n->m_nextpkt;
 461                 do {
 462                         if (n->m_flags & M_EOR) {
 463                                 sbappendrecord_locked(sb, m); /* XXXXXX!!!! */
 464                                 return;
 465                         }
 466                 } while (n->m_next && (n = n->m_next));
 467         } else {
 468                 /*
 469                  * XXX Would like to simply use sb_mbtail here, but
 470                  * XXX I need to verify that I won't miss an EOR that
 471                  * XXX way.
 472                  */
 473                 if ((n = sb->sb_lastrecord) != NULL) {
 474                         do {
 475                                 if (n->m_flags & M_EOR) {
 476                                         sbappendrecord_locked(sb, m); /* XXXXXX!!!! */
 477                                         return;
 478                                 }
 479                         } while (n->m_next && (n = n->m_next));
 480                 } else {
 481                         /*
 482                          * If this is the first record in the socket buffer,
 483                          * it's also the last record.
 484                          */
 485                         sb->sb_lastrecord = m;
 486                 }
 487         }
 488         sbcompress(sb, m, n);
 489         SBLASTRECORDCHK(sb);
 490 }
 491
 492 /*
 493  * Append mbuf chain m to the last record in the socket buffer sb.  The
 494  * additional space associated the mbuf chain is recorded in sb.  Empty mbufs
 495  * are discarded and mbufs are compacted where possible.
 496  */
 497 void
 498 sbappend(struct sockbuf *sb, struct mbuf *m)
 499 {
 500
 501         SOCKBUF_LOCK(sb);
 502         sbappend_locked(sb, m);
 503         SOCKBUF_UNLOCK(sb);
 504 }
 505
 506 /*
 507  * This version of sbappend() should only be used when the caller absolutely
 508  * knows that there will never be more than one record in the socket buffer,
 509  * that is, a stream protocol (such as TCP).
 510  */
 511 void
 512 sbappendstream_locked(struct sockbuf *sb, struct mbuf *m)
 513 {
 514         SOCKBUF_LOCK_ASSERT(sb);
 515
 516         KASSERT(m->m_nextpkt == NULL,("sbappendstream 0"));
 517         KASSERT(sb->sb_mb == sb->sb_lastrecord,("sbappendstream 1"));
 518
 519         SBLASTMBUFCHK(sb);
 520
 521         sbcompress(sb, m, sb->sb_mbtail);
 522
 523         sb->sb_lastrecord = sb->sb_mb;
 524         SBLASTRECORDCHK(sb);
 525 }
 526
 527 /*
 528  * This version of sbappend() should only be used when the caller absolutely
 529  * knows that there will never be more than one record in the socket buffer,
 530  * that is, a stream protocol (such as TCP).
 531  */
 532 void
 533 sbappendstream(struct sockbuf *sb, struct mbuf *m)
 534 {
 535
 536         SOCKBUF_LOCK(sb);
 537         sbappendstream_locked(sb, m);
 538         SOCKBUF_UNLOCK(sb);
 539 }
 540
 541 #ifdef SOCKBUF_DEBUG
 542 void
 543 sbcheck(struct sockbuf *sb)
 544 {
 545         struct mbuf *m;
 546         struct mbuf *n = 0;
 547         u_long len = 0, mbcnt = 0;
 548
 549         SOCKBUF_LOCK_ASSERT(sb);
 550
 551         for (m = sb->sb_mb; m; m = n) {
 552             n = m->m_nextpkt;
 553             for (; m; m = m->m_next) {
 554                 len += m->m_len;
 555                 mbcnt += MSIZE;
 556                 if (m->m_flags & M_EXT) /*XXX*/ /* pretty sure this is bogus */
 557                         mbcnt += m->m_ext.ext_size;
 558             }
 559         }
 560         if (len != sb->sb_cc || mbcnt != sb->sb_mbcnt) {
 561                 printf("cc %ld != %u || mbcnt %ld != %u\n", len, sb->sb_cc,
 562                     mbcnt, sb->sb_mbcnt);
 563                 panic("sbcheck");
 564         }
 565 }
 566 #endif
 567
 568 /*
 569  * As above, except the mbuf chain begins a new record.
 570  */
 571 void
 572 sbappendrecord_locked(struct sockbuf *sb, struct mbuf *m0)
 573 {
 574         struct mbuf *m;
 575
 576         SOCKBUF_LOCK_ASSERT(sb);
 577
 578         if (m0 == 0)
 579                 return;
 580         /*
 581          * Put the first mbuf on the queue.  Note this permits zero length
 582          * records.
 583          */
 584         sballoc(sb, m0);
 585         SBLASTRECORDCHK(sb);
 586         SBLINKRECORD(sb, m0);
 587         sb->sb_mbtail = m0;
 588         m = m0->m_next;
 589         m0->m_next = 0;
 590         if (m && (m0->m_flags & M_EOR)) {
 591                 m0->m_flags &= ~M_EOR;
 592                 m->m_flags |= M_EOR;
 593         }
 594         /* always call sbcompress() so it can do SBLASTMBUFCHK() */
 595         sbcompress(sb, m, m0);
 596 }
 597
 598 /*
 599  * As above, except the mbuf chain begins a new record.
 600  */
 601 void
 602 sbappendrecord(struct sockbuf *sb, struct mbuf *m0)
 603 {
 604
 605         SOCKBUF_LOCK(sb);
 606         sbappendrecord_locked(sb, m0);
 607         SOCKBUF_UNLOCK(sb);
 608 }
 609
 610 /*
 611  * Append address and data, and optionally, control (ancillary) data to the
 612  * receive queue of a socket.  If present, m0 must include a packet header
 613  * with total length.  Returns 0 if no space in sockbuf or insufficient
 614  * mbufs.
 615  */
 616 int
 617 sbappendaddr_locked(struct sockbuf *sb, const struct sockaddr *asa,
 618     struct mbuf *m0, struct mbuf *control)
 619 {
 620         struct mbuf *m, *n, *nlast;
 621         int space = asa->sa_len;
 622
 623         SOCKBUF_LOCK_ASSERT(sb);
 624
 625         if (m0 && (m0->m_flags & M_PKTHDR) == 0)
 626                 panic("sbappendaddr_locked");
 627         if (m0)
 628                 space += m0->m_pkthdr.len;
 629         space += m_length(control, &n);
 630
 631         if (space > sbspace(sb))
 632                 return (0);
 633 #if MSIZE <= 256
 634         if (asa->sa_len > MLEN)
 635                 return (0);
 636 #endif
 637         MGET(m, M_DONTWAIT, MT_SONAME);
 638         if (m == 0)
 639                 return (0);
 640         m->m_len = asa->sa_len;
 641         bcopy(asa, mtod(m, caddr_t), asa->sa_len);
 642         if (n)
 643                 n->m_next = m0;         /* concatenate data to control */
 644         else
 645                 control = m0;
 646         m->m_next = control;
 647         for (n = m; n->m_next != NULL; n = n->m_next)
 648                 sballoc(sb, n);
 649         sballoc(sb, n);
 650         nlast = n;
 651         SBLINKRECORD(sb, m);
 652
 653         sb->sb_mbtail = nlast;
 654         SBLASTMBUFCHK(sb);
 655
 656         SBLASTRECORDCHK(sb);
 657         return (1);
 658 }
 659
 660 /*
 661  * Append address and data, and optionally, control (ancillary) data to the
 662  * receive queue of a socket.  If present, m0 must include a packet header
 663  * with total length.  Returns 0 if no space in sockbuf or insufficient
 664  * mbufs.
 665  */
 666 int
 667 sbappendaddr(struct sockbuf *sb, const struct sockaddr *asa,
 668     struct mbuf *m0, struct mbuf *control)
 669 {
 670         int retval;
 671
 672         SOCKBUF_LOCK(sb);
 673         retval = sbappendaddr_locked(sb, asa, m0, control);
 674         SOCKBUF_UNLOCK(sb);
 675         return (retval);
 676 }
 677
 678 int
 679 sbappendcontrol_locked(struct sockbuf *sb, struct mbuf *m0,
 680     struct mbuf *control)
 681 {
 682         struct mbuf *m, *n, *mlast;
 683         int space;
 684
 685         SOCKBUF_LOCK_ASSERT(sb);
 686
 687         if (control == 0)
 688                 panic("sbappendcontrol_locked");
 689         space = m_length(control, &n) + m_length(m0, NULL);
 690
 691         if (space > sbspace(sb))
 692                 return (0);
 693         n->m_next = m0;                 /* concatenate data to control */
 694
 695         SBLASTRECORDCHK(sb);
 696
 697         for (m = control; m->m_next; m = m->m_next)
 698                 sballoc(sb, m);
 699         sballoc(sb, m);
 700         mlast = m;
 701         SBLINKRECORD(sb, control);
 702
 703         sb->sb_mbtail = mlast;
 704         SBLASTMBUFCHK(sb);
 705
 706         SBLASTRECORDCHK(sb);
 707         return (1);
 708 }
 709
 710 int
 711 sbappendcontrol(struct sockbuf *sb, struct mbuf *m0, struct mbuf *control)
 712 {
 713         int retval;
 714
 715         SOCKBUF_LOCK(sb);
 716         retval = sbappendcontrol_locked(sb, m0, control);
 717         SOCKBUF_UNLOCK(sb);
 718         return (retval);
 719 }
 720
 721 /*
 722  * Append the data in mbuf chain (m) into the socket buffer sb following mbuf
 723  * (n).  If (n) is NULL, the buffer is presumed empty.
 724  *
 725  * When the data is compressed, mbufs in the chain may be handled in one of
 726  * three ways:
 727  *
 728  * (1) The mbuf may simply be dropped, if it contributes nothing (no data, no
 729  *     record boundary, and no change in data type).
 730  *
 731  * (2) The mbuf may be coalesced -- i.e., data in the mbuf may be copied into
 732  *     an mbuf already in the socket buffer.  This can occur if an
 733  *     appropriate mbuf exists, there is room, and no merging of data types
 734  *     will occur.
 735  *
 736  * (3) The mbuf may be appended to the end of the existing mbuf chain.
 737  *
 738  * If any of the new mbufs is marked as M_EOR, mark the last mbuf appended as
 739  * end-of-record.
 740  */
 741 void
 742 sbcompress(struct sockbuf *sb, struct mbuf *m, struct mbuf *n)
 743 {
 744         int eor = 0;
 745         struct mbuf *o;
 746
 747         SOCKBUF_LOCK_ASSERT(sb);
 748
 749         while (m) {
 750                 eor |= m->m_flags & M_EOR;
 751                 if (m->m_len == 0 &&
 752                     (eor == 0 ||
 753                      (((o = m->m_next) || (o = n)) &&
 754                       o->m_type == m->m_type))) {
 755                         if (sb->sb_lastrecord == m)
 756                                 sb->sb_lastrecord = m->m_next;
 757                         m = m_free(m);
 758                         continue;
 759                 }
 760                 if (n && (n->m_flags & M_EOR) == 0 &&
 761                     M_WRITABLE(n) &&
 762                     ((sb->sb_flags & SB_NOCOALESCE) == 0) &&
 763                     m->m_len <= MCLBYTES / 4 && /* XXX: Don't copy too much */
 764                     m->m_len <= M_TRAILINGSPACE(n) &&
 765                     n->m_type == m->m_type) {
 766                         bcopy(mtod(m, caddr_t), mtod(n, caddr_t) + n->m_len,
 767                             (unsigned)m->m_len);
 768                         n->m_len += m->m_len;
 769                         sb->sb_cc += m->m_len;
 770                         if (m->m_type != MT_DATA && m->m_type != MT_OOBDATA)
 771                                 /* XXX: Probably don't need.*/
 772                                 sb->sb_ctl += m->m_len;
 773                         m = m_free(m);
 774                         continue;
 775                 }
 776                 if (n)
 777                         n->m_next = m;
 778                 else
 779                         sb->sb_mb = m;
 780                 sb->sb_mbtail = m;
 781                 sballoc(sb, m);
 782                 n = m;
 783                 m->m_flags &= ~M_EOR;
 784                 m = m->m_next;
 785                 n->m_next = 0;
 786         }
 787         if (eor) {
 788                 KASSERT(n != NULL, ("sbcompress: eor && n == NULL"));
 789                 n->m_flags |= eor;
 790         }
 791         SBLASTMBUFCHK(sb);
 792 }
 793
 794 /*
 795  * Free all mbufs in a sockbuf.  Check that all resources are reclaimed.
 796  */
 797 static void
 798 sbflush_internal(struct sockbuf *sb)
 799 {
 800
 801         while (sb->sb_mbcnt) {
 802                 /*
 803                  * Don't call sbdrop(sb, 0) if the leading mbuf is non-empty:
 804                  * we would loop forever. Panic instead.
 805                  */
 806                 if (!sb->sb_cc && (sb->sb_mb == NULL || sb->sb_mb->m_len))
 807                         break;
 808                 sbdrop_internal(sb, (int)sb->sb_cc);
 809         }
 810         if (sb->sb_cc || sb->sb_mb || sb->sb_mbcnt)
 811                 panic("sbflush_internal: cc %u || mb %p || mbcnt %u",
 812                     sb->sb_cc, (void *)sb->sb_mb, sb->sb_mbcnt);
 813 }
 814
 815 void
 816 sbflush_locked(struct sockbuf *sb)
 817 {
 818
 819         SOCKBUF_LOCK_ASSERT(sb);
 820         sbflush_internal(sb);
 821 }
 822
 823 void
 824 sbflush(struct sockbuf *sb)
 825 {
 826
 827         SOCKBUF_LOCK(sb);
 828         sbflush_locked(sb);
 829         SOCKBUF_UNLOCK(sb);
 830 }
 831
 832 /*
 833  * Drop data from (the front of) a sockbuf.
 834  */
 835 static void
 836 sbdrop_internal(struct sockbuf *sb, int len)
 837 {
 838         struct mbuf *m;
 839         struct mbuf *next;
 840
 841         next = (m = sb->sb_mb) ? m->m_nextpkt : 0;
 842         while (len > 0) {
 843                 if (m == 0) {
 844                         if (next == 0)
 845                                 panic("sbdrop");
 846                         m = next;
 847                         next = m->m_nextpkt;
 848                         continue;
 849                 }
 850                 if (m->m_len > len) {
 851                         m->m_len -= len;
 852                         m->m_data += len;
 853                         sb->sb_cc -= len;
 854                         if (sb->sb_sndptroff != 0)
 855                                 sb->sb_sndptroff -= len;
 856                         if (m->m_type != MT_DATA && m->m_type != MT_OOBDATA)
 857                                 sb->sb_ctl -= len;
 858                         break;
 859                 }
 860                 len -= m->m_len;
 861                 sbfree(sb, m);
 862                 m = m_free(m);
 863         }
 864         while (m && m->m_len == 0) {
 865                 sbfree(sb, m);
 866                 m = m_free(m);
 867         }
 868         if (m) {
 869                 sb->sb_mb = m;
 870                 m->m_nextpkt = next;
 871         } else
 872                 sb->sb_mb = next;
 873         /*
 874          * First part is an inline SB_EMPTY_FIXUP().  Second part makes sure
 875          * sb_lastrecord is up-to-date if we dropped part of the last record.
 876          */
 877         m = sb->sb_mb;
 878         if (m == NULL) {
 879                 sb->sb_mbtail = NULL;
 880                 sb->sb_lastrecord = NULL;
 881         } else if (m->m_nextpkt == NULL) {
 882                 sb->sb_lastrecord = m;
 883         }
 884 }
 885
 886 /*
 887  * Drop data from (the front of) a sockbuf.
 888  */
 889 void
 890 sbdrop_locked(struct sockbuf *sb, int len)
 891 {
 892
 893         SOCKBUF_LOCK_ASSERT(sb);
 894
 895         sbdrop_internal(sb, len);
 896 }
 897
 898 void
 899 sbdrop(struct sockbuf *sb, int len)
 900 {
 901
 902         SOCKBUF_LOCK(sb);
 903         sbdrop_locked(sb, len);
 904         SOCKBUF_UNLOCK(sb);
 905 }
 906
 907 /*
 908  * Maintain a pointer and offset pair into the socket buffer mbuf chain to
 909  * avoid traversal of the entire socket buffer for larger offsets.
 910  */
 911 struct mbuf *
 912 sbsndptr(struct sockbuf *sb, u_int off, u_int len, u_int *moff)
 913 {
 914         struct mbuf *m, *ret;
 915
 916         KASSERT(sb->sb_mb != NULL, ("%s: sb_mb is NULL", __func__));
 917         KASSERT(off + len <= sb->sb_cc, ("%s: beyond sb", __func__));
 918         KASSERT(sb->sb_sndptroff <= sb->sb_cc, ("%s: sndptroff broken", __func__));
 919
 920         /*
 921          * Is off below stored offset? Happens on retransmits.
 922          * Just return, we can't help here.
 923          */
 924         if (sb->sb_sndptroff > off) {
 925                 *moff = off;
 926                 return (sb->sb_mb);
 927         }
 928
 929         /* Return closest mbuf in chain for current offset. */
 930         *moff = off - sb->sb_sndptroff;
 931         m = ret = sb->sb_sndptr ? sb->sb_sndptr : sb->sb_mb;
 932
 933         /* Advance by len to be as close as possible for the next transmit. */
 934         for (off = off - sb->sb_sndptroff + len - 1;
 935              off > 0 && m != NULL && off >= m->m_len;
 936              m = m->m_next) {
 937                 sb->sb_sndptroff += m->m_len;
 938                 off -= m->m_len;
 939         }
 940         if (off > 0 && m == NULL)
 941                 panic("%s: sockbuf %p and mbuf %p clashing", __func__, sb, ret);
 942         sb->sb_sndptr = m;
 943
 944         return (ret);
 945 }
 946
 947 /*
 948  * Drop a record off the front of a sockbuf and move the next record to the
 949  * front.
 950  */
 951 void
 952 sbdroprecord_locked(struct sockbuf *sb)
 953 {
 954         struct mbuf *m;
 955
 956         SOCKBUF_LOCK_ASSERT(sb);
 957
 958         m = sb->sb_mb;
 959         if (m) {
 960                 sb->sb_mb = m->m_nextpkt;
 961                 do {
 962                         sbfree(sb, m);
 963                         m = m_free(m);
 964                 } while (m);
 965         }
 966         SB_EMPTY_FIXUP(sb);
 967 }
 968
 969 /*
 970  * Drop a record off the front of a sockbuf and move the next record to the
 971  * front.
 972  */
 973 void
 974 sbdroprecord(struct sockbuf *sb)
 975 {
 976
 977         SOCKBUF_LOCK(sb);
 978         sbdroprecord_locked(sb);
 979         SOCKBUF_UNLOCK(sb);
 980 }
 981
 982 /*
 983  * Create a "control" mbuf containing the specified data with the specified
 984  * type for presentation on a socket buffer.
 985  */
 986 struct mbuf *
 987 sbcreatecontrol(caddr_t p, int size, int type, int level)
 988 {
 989         struct cmsghdr *cp;
 990         struct mbuf *m;
 991
 992         if (CMSG_SPACE((u_int)size) > MCLBYTES)
 993                 return ((struct mbuf *) NULL);
 994         if (CMSG_SPACE((u_int)size) > MLEN)
 995                 m = m_getcl(M_DONTWAIT, MT_CONTROL, 0);
 996         else
 997                 m = m_get(M_DONTWAIT, MT_CONTROL);
 998         if (m == NULL)
 999                 return ((struct mbuf *) NULL);
1000         cp = mtod(m, struct cmsghdr *);
1001         m->m_len = 0;
1002         KASSERT(CMSG_SPACE((u_int)size) <= M_TRAILINGSPACE(m),
1003             ("sbcreatecontrol: short mbuf"));
1004         if (p != NULL)
1005                 (void)memcpy(CMSG_DATA(cp), p, size);
1006         m->m_len = CMSG_SPACE(size);
1007         cp->cmsg_len = CMSG_LEN(size);
1008         cp->cmsg_level = level;
1009         cp->cmsg_type = type;
1010         return (m);
1011 }
1012
1013 /*
1014  * This does the same for socket buffers that sotoxsocket does for sockets:
1015  * generate an user-format data structure describing the socket buffer.  Note
1016  * that the xsockbuf structure, since it is always embedded in a socket, does
1017  * not include a self pointer nor a length.  We make this entry point public
1018  * in case some other mechanism needs it.
1019  */
1020 void
1021 sbtoxsockbuf(struct sockbuf *sb, struct xsockbuf *xsb)
1022 {
1023
1024         xsb->sb_cc = sb->sb_cc;
1025         xsb->sb_hiwat = sb->sb_hiwat;
1026         xsb->sb_mbcnt = sb->sb_mbcnt;
1027         xsb->sb_mcnt = sb->sb_mcnt;
1028         xsb->sb_ccnt = sb->sb_ccnt;
1029         xsb->sb_mbmax = sb->sb_mbmax;
1030         xsb->sb_lowat = sb->sb_lowat;
1031         xsb->sb_flags = sb->sb_flags;
1032         xsb->sb_timeo = sb->sb_timeo;
1033 }
1034
1035 /* This takes the place of kern.maxsockbuf, which moved to kern.ipc. */
1036 static int dummy;
1037 SYSCTL_INT(_kern, KERN_DUMMY, dummy, CTLFLAG_RW, &dummy, 0, "");
1038 SYSCTL_OID(_kern_ipc, KIPC_MAXSOCKBUF, maxsockbuf, CTLTYPE_ULONG|CTLFLAG_RW,
1039     &sb_max, 0, sysctl_handle_sb_max, "LU", "Maximum socket buffer size");
1040 SYSCTL_ULONG(_kern_ipc, KIPC_SOCKBUF_WASTE, sockbuf_waste_factor, CTLFLAG_RW,
1041     &sb_efficiency, 0, "");