net/core/datagram.c

   1 /*
   2  *      SUCS NET3:
   3  *
   4  *      Generic datagram handling routines. These are generic for all
   5  *      protocols. Possibly a generic IP version on top of these would
   6  *      make sense. Not tonight however 8-).
   7  *      This is used because UDP, RAW, PACKET, DDP, IPX, AX.25 and
   8  *      NetROM layer all have identical poll code and mostly
   9  *      identical recvmsg() code. So we share it here. The poll was
  10  *      shared before but buried in udp.c so I moved it.
  11  *
  12  *      Authors:        Alan Cox <alan@lxorguk.ukuu.org.uk>. (datagram_poll() from old
  13  *                                                   udp.c code)
  14  *
  15  *      Fixes:
  16  *              Alan Cox        :       NULL return from skb_peek_copy()
  17  *                                      understood
  18  *              Alan Cox        :       Rewrote skb_read_datagram to avoid the
  19  *                                      skb_peek_copy stuff.
  20  *              Alan Cox        :       Added support for SOCK_SEQPACKET.
  21  *                                      IPX can no longer use the SO_TYPE hack
  22  *                                      but AX.25 now works right, and SPX is
  23  *                                      feasible.
  24  *              Alan Cox        :       Fixed write poll of non IP protocol
  25  *                                      crash.
  26  *              Florian  La Roche:      Changed for my new skbuff handling.
  27  *              Darryl Miles    :       Fixed non-blocking SOCK_SEQPACKET.
  28  *              Linus Torvalds  :       BSD semantic fixes.
  29  *              Alan Cox        :       Datagram iovec handling
  30  *              Darryl Miles    :       Fixed non-blocking SOCK_STREAM.
  31  *              Alan Cox        :       POSIXisms
  32  *              Pete Wyckoff    :       Unconnected accept() fix.
  33  *
  34  */
  35
  36 #include <linux/module.h>
  37 #include <linux/types.h>
  38 #include <linux/kernel.h>
  39 #include <asm/uaccess.h>
  40 #include <linux/mm.h>
  41 #include <linux/interrupt.h>
  42 #include <linux/errno.h>
  43 #include <linux/sched.h>
  44 #include <linux/inet.h>
  45 #include <linux/netdevice.h>
  46 #include <linux/rtnetlink.h>
  47 #include <linux/poll.h>
  48 #include <linux/highmem.h>
  49 #include <linux/spinlock.h>
  50 #include <linux/slab.h>
  51 #include <linux/pagemap.h>
  52 #include <linux/uio.h>
  53
  54 #include <net/protocol.h>
  55 #include <linux/skbuff.h>
  56
  57 #include <net/checksum.h>
  58 #include <net/sock.h>
  59 #include <net/tcp_states.h>
  60 #include <trace/events/skb.h>
  61 #include <net/busy_poll.h>
  62
  63 /*
  64  *      Is a socket 'connection oriented' ?
  65  */
  66 static inline int connection_based(struct sock *sk)
  67 {
  68         return sk->sk_type == SOCK_SEQPACKET || sk->sk_type == SOCK_STREAM;
  69 }
  70
  71 static int receiver_wake_function(wait_queue_t *wait, unsigned int mode, int sync,
  72                                   void *key)
  73 {
  74         unsigned long bits = (unsigned long)key;
  75
  76         /*
  77          * Avoid a wakeup if event not interesting for us
  78          */
  79         if (bits && !(bits & (POLLIN | POLLERR)))
  80                 return 0;
  81         return autoremove_wake_function(wait, mode, sync, key);
  82 }
  83 /*
  84  * Wait for the last received packet to be different from skb
  85  */
  86 static int wait_for_more_packets(struct sock *sk, int *err, long *timeo_p,
  87                                  const struct sk_buff *skb)
  88 {
  89         int error;
  90         DEFINE_WAIT_FUNC(wait, receiver_wake_function);
  91
  92         prepare_to_wait_exclusive(sk_sleep(sk), &wait, TASK_INTERRUPTIBLE);
  93
  94         /* Socket errors? */
  95         error = sock_error(sk);
  96         if (error)
  97                 goto out_err;
  98
  99         if (sk->sk_receive_queue.prev != skb)
 100                 goto out;
 101
 102         /* Socket shut down? */
 103         if (sk->sk_shutdown & RCV_SHUTDOWN)
 104                 goto out_noerr;
 105
 106         /* Sequenced packets can come disconnected.
 107          * If so we report the problem
 108          */
 109         error = -ENOTCONN;
 110         if (connection_based(sk) &&
 111             !(sk->sk_state == TCP_ESTABLISHED || sk->sk_state == TCP_LISTEN))
 112                 goto out_err;
 113
 114         /* handle signals */
 115         if (signal_pending(current))
 116                 goto interrupted;
 117
 118         error = 0;
 119         *timeo_p = schedule_timeout(*timeo_p);
 120 out:
 121         finish_wait(sk_sleep(sk), &wait);
 122         return error;
 123 interrupted:
 124         error = sock_intr_errno(*timeo_p);
 125 out_err:
 126         *err = error;
 127         goto out;
 128 out_noerr:
 129         *err = 0;
 130         error = 1;
 131         goto out;
 132 }
 133
 134 static int skb_set_peeked(struct sk_buff *skb)
 135 {
 136         struct sk_buff *nskb;
 137
 138         if (skb->peeked)
 139                 return 0;
 140
 141         /* We have to unshare an skb before modifying it. */
 142         if (!skb_shared(skb))
 143                 goto done;
 144
 145         nskb = skb_clone(skb, GFP_ATOMIC);
 146         if (!nskb)
 147                 return -ENOMEM;
 148
 149         skb->prev->next = nskb;
 150         skb->next->prev = nskb;
 151         nskb->prev = skb->prev;
 152         nskb->next = skb->next;
 153
 154         consume_skb(skb);
 155         skb = nskb;
 156
 157 done:
 158         skb->peeked = 1;
 159
 160         return 0;
 161 }
 162
 163 /**
 164  *      __skb_recv_datagram - Receive a datagram skbuff
 165  *      @sk: socket
 166  *      @flags: MSG_ flags
 167  *      @peeked: returns non-zero if this packet has been seen before
 168  *      @off: an offset in bytes to peek skb from. Returns an offset
 169  *            within an skb where data actually starts
 170  *      @err: error code returned
 171  *
 172  *      Get a datagram skbuff, understands the peeking, nonblocking wakeups
 173  *      and possible races. This replaces identical code in packet, raw and
 174  *      udp, as well as the IPX AX.25 and Appletalk. It also finally fixes
 175  *      the long standing peek and read race for datagram sockets. If you
 176  *      alter this routine remember it must be re-entrant.
 177  *
 178  *      This function will lock the socket if a skb is returned, so the caller
 179  *      needs to unlock the socket in that case (usually by calling
 180  *      skb_free_datagram)
 181  *
 182  *      * It does not lock socket since today. This function is
 183  *      * free of race conditions. This measure should/can improve
 184  *      * significantly datagram socket latencies at high loads,
 185  *      * when data copying to user space takes lots of time.
 186  *      * (BTW I've just killed the last cli() in IP/IPv6/core/netlink/packet
 187  *      *  8) Great win.)
 188  *      *                                           --ANK (980729)
 189  *
 190  *      The order of the tests when we find no data waiting are specified
 191  *      quite explicitly by POSIX 1003.1g, don't change them without having
 192  *      the standard around please.
 193  */
 194 struct sk_buff *__skb_recv_datagram(struct sock *sk, unsigned int flags,
 195                                     int *peeked, int *off, int *err)
 196 {
 197         struct sk_buff_head *queue = &sk->sk_receive_queue;
 198         struct sk_buff *skb, *last;
 199         unsigned long cpu_flags;
 200         long timeo;
 201         /*
 202          * Caller is allowed not to check sk->sk_err before skb_recv_datagram()
 203          */
 204         int error = sock_error(sk);
 205
 206         if (error)
 207                 goto no_packet;
 208
 209         timeo = sock_rcvtimeo(sk, flags & MSG_DONTWAIT);
 210
 211         do {
 212                 /* Again only user level code calls this function, so nothing
 213                  * interrupt level will suddenly eat the receive_queue.
 214                  *
 215                  * Look at current nfs client by the way...
 216                  * However, this function was correct in any case. 8)
 217                  */
 218                 int _off = *off;
 219
 220                 last = (struct sk_buff *)queue;
 221                 spin_lock_irqsave(&queue->lock, cpu_flags);
 222                 skb_queue_walk(queue, skb) {
 223                         last = skb;
 224                         *peeked = skb->peeked;
 225                         if (flags & MSG_PEEK) {
 226                                 if (_off >= skb->len && (skb->len || _off ||
 227                                                          skb->peeked)) {
 228                                         _off -= skb->len;
 229                                         continue;
 230                                 }
 231
 232                                 error = skb_set_peeked(skb);
 233                                 if (error)
 234                                         goto unlock_err;
 235
 236                                 atomic_inc(&skb->users);
 237                         } else
 238                                 __skb_unlink(skb, queue);
 239
 240                         spin_unlock_irqrestore(&queue->lock, cpu_flags);
 241                         *off = _off;
 242                         return skb;
 243                 }
 244                 spin_unlock_irqrestore(&queue->lock, cpu_flags);
 245
 246                 if (sk_can_busy_loop(sk) &&
 247                     sk_busy_loop(sk, flags & MSG_DONTWAIT))
 248                         continue;
 249
 250                 /* User doesn't want to wait */
 251                 error = -EAGAIN;
 252                 if (!timeo)
 253                         goto no_packet;
 254
 255         } while (!wait_for_more_packets(sk, err, &timeo, last));
 256
 257         return NULL;
 258
 259 unlock_err:
 260         spin_unlock_irqrestore(&queue->lock, cpu_flags);
 261 no_packet:
 262         *err = error;
 263         return NULL;
 264 }
 265 EXPORT_SYMBOL(__skb_recv_datagram);
 266
 267 struct sk_buff *skb_recv_datagram(struct sock *sk, unsigned int flags,
 268                                   int noblock, int *err)
 269 {
 270         int peeked, off = 0;
 271
 272         return __skb_recv_datagram(sk, flags | (noblock ? MSG_DONTWAIT : 0),
 273                                    &peeked, &off, err);
 274 }
 275 EXPORT_SYMBOL(skb_recv_datagram);
 276
 277 void skb_free_datagram(struct sock *sk, struct sk_buff *skb)
 278 {
 279         consume_skb(skb);
 280         sk_mem_reclaim_partial(sk);
 281 }
 282 EXPORT_SYMBOL(skb_free_datagram);
 283
 284 void skb_free_datagram_locked(struct sock *sk, struct sk_buff *skb)
 285 {
 286         bool slow;
 287
 288         if (likely(atomic_read(&skb->users) == 1))
 289                 smp_rmb();
 290         else if (likely(!atomic_dec_and_test(&skb->users)))
 291                 return;
 292
 293         slow = lock_sock_fast(sk);
 294         skb_orphan(skb);
 295         sk_mem_reclaim_partial(sk);
 296         unlock_sock_fast(sk, slow);
 297
 298         /* skb is now orphaned, can be freed outside of locked section */
 299         __kfree_skb(skb);
 300 }
 301 EXPORT_SYMBOL(skb_free_datagram_locked);
 302
 303 /**
 304  *      skb_kill_datagram - Free a datagram skbuff forcibly
 305  *      @sk: socket
 306  *      @skb: datagram skbuff
 307  *      @flags: MSG_ flags
 308  *
 309  *      This function frees a datagram skbuff that was received by
 310  *      skb_recv_datagram.  The flags argument must match the one
 311  *      used for skb_recv_datagram.
 312  *
 313  *      If the MSG_PEEK flag is set, and the packet is still on the
 314  *      receive queue of the socket, it will be taken off the queue
 315  *      before it is freed.
 316  *
 317  *      This function currently only disables BH when acquiring the
 318  *      sk_receive_queue lock.  Therefore it must not be used in a
 319  *      context where that lock is acquired in an IRQ context.
 320  *
 321  *      It returns 0 if the packet was removed by us.
 322  */
 323
 324 int skb_kill_datagram(struct sock *sk, struct sk_buff *skb, unsigned int flags)
 325 {
 326         int err = 0;
 327
 328         if (flags & MSG_PEEK) {
 329                 err = -ENOENT;
 330                 spin_lock_bh(&sk->sk_receive_queue.lock);
 331                 if (skb == skb_peek(&sk->sk_receive_queue)) {
 332                         __skb_unlink(skb, &sk->sk_receive_queue);
 333                         atomic_dec(&skb->users);
 334                         err = 0;
 335                 }
 336                 spin_unlock_bh(&sk->sk_receive_queue.lock);
 337         }
 338
 339         kfree_skb(skb);
 340         atomic_inc(&sk->sk_drops);
 341         sk_mem_reclaim_partial(sk);
 342
 343         return err;
 344 }
 345 EXPORT_SYMBOL(skb_kill_datagram);
 346
 347 /**
 348  *      skb_copy_datagram_iter - Copy a datagram to an iovec iterator.
 349  *      @skb: buffer to copy
 350  *      @offset: offset in the buffer to start copying from
 351  *      @to: iovec iterator to copy to
 352  *      @len: amount of data to copy from buffer to iovec
 353  */
 354 int skb_copy_datagram_iter(const struct sk_buff *skb, int offset,
 355                            struct iov_iter *to, int len)
 356 {
 357         int start = skb_headlen(skb);
 358         int i, copy = start - offset;
 359         struct sk_buff *frag_iter;
 360
 361         trace_skb_copy_datagram_iovec(skb, len);
 362
 363         /* Copy header. */
 364         if (copy > 0) {
 365                 if (copy > len)
 366                         copy = len;
 367                 if (copy_to_iter(skb->data + offset, copy, to) != copy)
 368                         goto short_copy;
 369                 if ((len -= copy) == 0)
 370                         return 0;
 371                 offset += copy;
 372         }
 373
 374         /* Copy paged appendix. Hmm... why does this look so complicated? */
 375         for (i = 0; i < skb_shinfo(skb)->nr_frags; i++) {
 376                 int end;
 377                 const skb_frag_t *frag = &skb_shinfo(skb)->frags[i];
 378
 379                 WARN_ON(start > offset + len);
 380
 381                 end = start + skb_frag_size(frag);
 382                 if ((copy = end - offset) > 0) {
 383                         if (copy > len)
 384                                 copy = len;
 385                         if (copy_page_to_iter(skb_frag_page(frag),
 386                                               frag->page_offset + offset -
 387                                               start, copy, to) != copy)
 388                                 goto short_copy;
 389                         if (!(len -= copy))
 390                                 return 0;
 391                         offset += copy;
 392                 }
 393                 start = end;
 394         }
 395
 396         skb_walk_frags(skb, frag_iter) {
 397                 int end;
 398
 399                 WARN_ON(start > offset + len);
 400
 401                 end = start + frag_iter->len;
 402                 if ((copy = end - offset) > 0) {
 403                         if (copy > len)
 404                                 copy = len;
 405                         if (skb_copy_datagram_iter(frag_iter, offset - start,
 406                                                    to, copy))
 407                                 goto fault;
 408                         if ((len -= copy) == 0)
 409                                 return 0;
 410                         offset += copy;
 411                 }
 412                 start = end;
 413         }
 414         if (!len)
 415                 return 0;
 416
 417         /* This is not really a user copy fault, but rather someone
 418          * gave us a bogus length on the skb.  We should probably
 419          * print a warning here as it may indicate a kernel bug.
 420          */
 421
 422 fault:
 423         return -EFAULT;
 424
 425 short_copy:
 426         if (iov_iter_count(to))
 427                 goto fault;
 428
 429         return 0;
 430 }
 431 EXPORT_SYMBOL(skb_copy_datagram_iter);
 432
 433 /**
 434  *      skb_copy_datagram_from_iter - Copy a datagram from an iov_iter.
 435  *      @skb: buffer to copy
 436  *      @offset: offset in the buffer to start copying to
 437  *      @from: the copy source
 438  *      @len: amount of data to copy to buffer from iovec
 439  *
 440  *      Returns 0 or -EFAULT.
 441  */
 442 int skb_copy_datagram_from_iter(struct sk_buff *skb, int offset,
 443                                  struct iov_iter *from,
 444                                  int len)
 445 {
 446         int start = skb_headlen(skb);
 447         int i, copy = start - offset;
 448         struct sk_buff *frag_iter;
 449
 450         /* Copy header. */
 451         if (copy > 0) {
 452                 if (copy > len)
 453                         copy = len;
 454                 if (copy_from_iter(skb->data + offset, copy, from) != copy)
 455                         goto fault;
 456                 if ((len -= copy) == 0)
 457                         return 0;
 458                 offset += copy;
 459         }
 460
 461         /* Copy paged appendix. Hmm... why does this look so complicated? */
 462         for (i = 0; i < skb_shinfo(skb)->nr_frags; i++) {
 463                 int end;
 464                 const skb_frag_t *frag = &skb_shinfo(skb)->frags[i];
 465
 466                 WARN_ON(start > offset + len);
 467
 468                 end = start + skb_frag_size(frag);
 469                 if ((copy = end - offset) > 0) {
 470                         size_t copied;
 471
 472                         if (copy > len)
 473                                 copy = len;
 474                         copied = copy_page_from_iter(skb_frag_page(frag),
 475                                           frag->page_offset + offset - start,
 476                                           copy, from);
 477                         if (copied != copy)
 478                                 goto fault;
 479
 480                         if (!(len -= copy))
 481                                 return 0;
 482                         offset += copy;
 483                 }
 484                 start = end;
 485         }
 486
 487         skb_walk_frags(skb, frag_iter) {
 488                 int end;
 489
 490                 WARN_ON(start > offset + len);
 491
 492                 end = start + frag_iter->len;
 493                 if ((copy = end - offset) > 0) {
 494                         if (copy > len)
 495                                 copy = len;
 496                         if (skb_copy_datagram_from_iter(frag_iter,
 497                                                         offset - start,
 498                                                         from, copy))
 499                                 goto fault;
 500                         if ((len -= copy) == 0)
 501                                 return 0;
 502                         offset += copy;
 503                 }
 504                 start = end;
 505         }
 506         if (!len)
 507                 return 0;
 508
 509 fault:
 510         return -EFAULT;
 511 }
 512 EXPORT_SYMBOL(skb_copy_datagram_from_iter);
 513
 514 /**
 515  *      zerocopy_sg_from_iter - Build a zerocopy datagram from an iov_iter
 516  *      @skb: buffer to copy
 517  *      @from: the source to copy from
 518  *
 519  *      The function will first copy up to headlen, and then pin the userspace
 520  *      pages and build frags through them.
 521  *
 522  *      Returns 0, -EFAULT or -EMSGSIZE.
 523  */
 524 int zerocopy_sg_from_iter(struct sk_buff *skb, struct iov_iter *from)
 525 {
 526         int len = iov_iter_count(from);
 527         int copy = min_t(int, skb_headlen(skb), len);
 528         int frag = 0;
 529
 530         /* copy up to skb headlen */
 531         if (skb_copy_datagram_from_iter(skb, 0, from, copy))
 532                 return -EFAULT;
 533
 534         while (iov_iter_count(from)) {
 535                 struct page *pages[MAX_SKB_FRAGS];
 536                 size_t start;
 537                 ssize_t copied;
 538                 unsigned long truesize;
 539                 int n = 0;
 540
 541                 if (frag == MAX_SKB_FRAGS)
 542                         return -EMSGSIZE;
 543
 544                 copied = iov_iter_get_pages(from, pages, ~0U,
 545                                             MAX_SKB_FRAGS - frag, &start);
 546                 if (copied < 0)
 547                         return -EFAULT;
 548
 549                 iov_iter_advance(from, copied);
 550
 551                 truesize = PAGE_ALIGN(copied + start);
 552                 skb->data_len += copied;
 553                 skb->len += copied;
 554                 skb->truesize += truesize;
 555                 atomic_add(truesize, &skb->sk->sk_wmem_alloc);
 556                 while (copied) {
 557                         int size = min_t(int, copied, PAGE_SIZE - start);
 558                         skb_fill_page_desc(skb, frag++, pages[n], start, size);
 559                         start = 0;
 560                         copied -= size;
 561                         n++;
 562                 }
 563         }
 564         return 0;
 565 }
 566 EXPORT_SYMBOL(zerocopy_sg_from_iter);
 567
 568 static int skb_copy_and_csum_datagram(const struct sk_buff *skb, int offset,
 569                                       struct iov_iter *to, int len,
 570                                       __wsum *csump)
 571 {
 572         int start = skb_headlen(skb);
 573         int i, copy = start - offset;
 574         struct sk_buff *frag_iter;
 575         int pos = 0;
 576         int n;
 577
 578         /* Copy header. */
 579         if (copy > 0) {
 580                 if (copy > len)
 581                         copy = len;
 582                 n = csum_and_copy_to_iter(skb->data + offset, copy, csump, to);
 583                 if (n != copy)
 584                         goto fault;
 585                 if ((len -= copy) == 0)
 586                         return 0;
 587                 offset += copy;
 588                 pos = copy;
 589         }
 590
 591         for (i = 0; i < skb_shinfo(skb)->nr_frags; i++) {
 592                 int end;
 593                 const skb_frag_t *frag = &skb_shinfo(skb)->frags[i];
 594
 595                 WARN_ON(start > offset + len);
 596
 597                 end = start + skb_frag_size(frag);
 598                 if ((copy = end - offset) > 0) {
 599                         __wsum csum2 = 0;
 600                         struct page *page = skb_frag_page(frag);
 601                         u8  *vaddr = kmap(page);
 602
 603                         if (copy > len)
 604                                 copy = len;
 605                         n = csum_and_copy_to_iter(vaddr + frag->page_offset +
 606                                                   offset - start, copy,
 607                                                   &csum2, to);
 608                         kunmap(page);
 609                         if (n != copy)
 610                                 goto fault;
 611                         *csump = csum_block_add(*csump, csum2, pos);
 612                         if (!(len -= copy))
 613                                 return 0;
 614                         offset += copy;
 615                         pos += copy;
 616                 }
 617                 start = end;
 618         }
 619
 620         skb_walk_frags(skb, frag_iter) {
 621                 int end;
 622
 623                 WARN_ON(start > offset + len);
 624
 625                 end = start + frag_iter->len;
 626                 if ((copy = end - offset) > 0) {
 627                         __wsum csum2 = 0;
 628                         if (copy > len)
 629                                 copy = len;
 630                         if (skb_copy_and_csum_datagram(frag_iter,
 631                                                        offset - start,
 632                                                        to, copy,
 633                                                        &csum2))
 634                                 goto fault;
 635                         *csump = csum_block_add(*csump, csum2, pos);
 636                         if ((len -= copy) == 0)
 637                                 return 0;
 638                         offset += copy;
 639                         pos += copy;
 640                 }
 641                 start = end;
 642         }
 643         if (!len)
 644                 return 0;
 645
 646 fault:
 647         return -EFAULT;
 648 }
 649
 650 __sum16 __skb_checksum_complete_head(struct sk_buff *skb, int len)
 651 {
 652         __sum16 sum;
 653
 654         sum = csum_fold(skb_checksum(skb, 0, len, skb->csum));
 655         if (likely(!sum)) {
 656                 if (unlikely(skb->ip_summed == CHECKSUM_COMPLETE) &&
 657                     !skb->csum_complete_sw)
 658                         netdev_rx_csum_fault(skb->dev);
 659         }
 660         if (!skb_shared(skb))
 661                 skb->csum_valid = !sum;
 662         return sum;
 663 }
 664 EXPORT_SYMBOL(__skb_checksum_complete_head);
 665
 666 __sum16 __skb_checksum_complete(struct sk_buff *skb)
 667 {
 668         __wsum csum;
 669         __sum16 sum;
 670
 671         csum = skb_checksum(skb, 0, skb->len, 0);
 672
 673         /* skb->csum holds pseudo checksum */
 674         sum = csum_fold(csum_add(skb->csum, csum));
 675         if (likely(!sum)) {
 676                 if (unlikely(skb->ip_summed == CHECKSUM_COMPLETE) &&
 677                     !skb->csum_complete_sw)
 678                         netdev_rx_csum_fault(skb->dev);
 679         }
 680
 681         if (!skb_shared(skb)) {
 682                 /* Save full packet checksum */
 683                 skb->csum = csum;
 684                 skb->ip_summed = CHECKSUM_COMPLETE;
 685                 skb->csum_complete_sw = 1;
 686                 skb->csum_valid = !sum;
 687         }
 688
 689         return sum;
 690 }
 691 EXPORT_SYMBOL(__skb_checksum_complete);
 692
 693 /**
 694  *      skb_copy_and_csum_datagram_msg - Copy and checksum skb to user iovec.
 695  *      @skb: skbuff
 696  *      @hlen: hardware length
 697  *      @msg: destination
 698  *
 699  *      Caller _must_ check that skb will fit to this iovec.
 700  *
 701  *      Returns: 0       - success.
 702  *               -EINVAL - checksum failure.
 703  *               -EFAULT - fault during copy.
 704  */
 705 int skb_copy_and_csum_datagram_msg(struct sk_buff *skb,
 706                                    int hlen, struct msghdr *msg)
 707 {
 708         __wsum csum;
 709         int chunk = skb->len - hlen;
 710
 711         if (!chunk)
 712                 return 0;
 713
 714         if (msg_data_left(msg) < chunk) {
 715                 if (__skb_checksum_complete(skb))
 716                         goto csum_error;
 717                 if (skb_copy_datagram_msg(skb, hlen, msg, chunk))
 718                         goto fault;
 719         } else {
 720                 csum = csum_partial(skb->data, hlen, skb->csum);
 721                 if (skb_copy_and_csum_datagram(skb, hlen, &msg->msg_iter,
 722                                                chunk, &csum))
 723                         goto fault;
 724                 if (csum_fold(csum))
 725                         goto csum_error;
 726                 if (unlikely(skb->ip_summed == CHECKSUM_COMPLETE))
 727                         netdev_rx_csum_fault(skb->dev);
 728         }
 729         return 0;
 730 csum_error:
 731         return -EINVAL;
 732 fault:
 733         return -EFAULT;
 734 }
 735 EXPORT_SYMBOL(skb_copy_and_csum_datagram_msg);
 736
 737 /**
 738  *      datagram_poll - generic datagram poll
 739  *      @file: file struct
 740  *      @sock: socket
 741  *      @wait: poll table
 742  *
 743  *      Datagram poll: Again totally generic. This also handles
 744  *      sequenced packet sockets providing the socket receive queue
 745  *      is only ever holding data ready to receive.
 746  *
 747  *      Note: when you _don't_ use this routine for this protocol,
 748  *      and you use a different write policy from sock_writeable()
 749  *      then please supply your own write_space callback.
 750  */
 751 unsigned int datagram_poll(struct file *file, struct socket *sock,
 752                            poll_table *wait)
 753 {
 754         struct sock *sk = sock->sk;
 755         unsigned int mask;
 756
 757         sock_poll_wait(file, sk_sleep(sk), wait);
 758         mask = 0;
 759
 760         /* exceptional events? */
 761         if (sk->sk_err || !skb_queue_empty(&sk->sk_error_queue))
 762                 mask |= POLLERR |
 763                         (sock_flag(sk, SOCK_SELECT_ERR_QUEUE) ? POLLPRI : 0);
 764
 765         if (sk->sk_shutdown & RCV_SHUTDOWN)
 766                 mask |= POLLRDHUP | POLLIN | POLLRDNORM;
 767         if (sk->sk_shutdown == SHUTDOWN_MASK)
 768                 mask |= POLLHUP;
 769
 770         /* readable? */
 771         if (!skb_queue_empty(&sk->sk_receive_queue))
 772                 mask |= POLLIN | POLLRDNORM;
 773
 774         /* Connection-based need to check for termination and startup */
 775         if (connection_based(sk)) {
 776                 if (sk->sk_state == TCP_CLOSE)
 777                         mask |= POLLHUP;
 778                 /* connection hasn't started yet? */
 779                 if (sk->sk_state == TCP_SYN_SENT)
 780                         return mask;
 781         }
 782
 783         /* writable? */
 784         if (sock_writeable(sk))
 785                 mask |= POLLOUT | POLLWRNORM | POLLWRBAND;
 786         else
 787                 set_bit(SOCK_ASYNC_NOSPACE, &sk->sk_socket->flags);
 788
 789         return mask;
 790 }
 791 EXPORT_SYMBOL(datagram_poll);