SAFE public projects git trees. - safe/jmp/linux-2.6/blob - 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 <asm/system.h>
  41 #include <linux/mm.h>
  42 #include <linux/interrupt.h>
  43 #include <linux/errno.h>
  44 #include <linux/sched.h>
  45 #include <linux/inet.h>
  46 #include <linux/netdevice.h>
  47 #include <linux/rtnetlink.h>
  48 #include <linux/poll.h>
  49 #include <linux/highmem.h>
  50 #include <linux/spinlock.h>
  51
  52 #include <net/protocol.h>
  53 #include <linux/skbuff.h>
  54
  55 #include <net/checksum.h>
  56 #include <net/sock.h>
  57 #include <net/tcp_states.h>
  58
  59 /*
  60  *      Is a socket 'connection oriented' ?
  61  */
  62 static inline int connection_based(struct sock *sk)
  63 {
  64         return sk->sk_type == SOCK_SEQPACKET || sk->sk_type == SOCK_STREAM;
  65 }
  66
  67 static int receiver_wake_function(wait_queue_t *wait, unsigned mode, int sync,
  68                                   void *key)
  69 {
  70         unsigned long bits = (unsigned long)key;
  71
  72         /*
  73          * Avoid a wakeup if event not interesting for us
  74          */
  75         if (bits && !(bits & (POLLIN | POLLERR)))
  76                 return 0;
  77         return autoremove_wake_function(wait, mode, sync, key);
  78 }
  79 /*
  80  * Wait for a packet..
  81  */
  82 static int wait_for_packet(struct sock *sk, int *err, long *timeo_p)
  83 {
  84         int error;
  85         DEFINE_WAIT_FUNC(wait, receiver_wake_function);
  86
  87         prepare_to_wait_exclusive(sk->sk_sleep, &wait, TASK_INTERRUPTIBLE);
  88
  89         /* Socket errors? */
  90         error = sock_error(sk);
  91         if (error)
  92                 goto out_err;
  93
  94         if (!skb_queue_empty(&sk->sk_receive_queue))
  95                 goto out;
  96
  97         /* Socket shut down? */
  98         if (sk->sk_shutdown & RCV_SHUTDOWN)
  99                 goto out_noerr;
 100
 101         /* Sequenced packets can come disconnected.
 102          * If so we report the problem
 103          */
 104         error = -ENOTCONN;
 105         if (connection_based(sk) &&
 106             !(sk->sk_state == TCP_ESTABLISHED || sk->sk_state == TCP_LISTEN))
 107                 goto out_err;
 108
 109         /* handle signals */
 110         if (signal_pending(current))
 111                 goto interrupted;
 112
 113         error = 0;
 114         *timeo_p = schedule_timeout(*timeo_p);
 115 out:
 116         finish_wait(sk->sk_sleep, &wait);
 117         return error;
 118 interrupted:
 119         error = sock_intr_errno(*timeo_p);
 120 out_err:
 121         *err = error;
 122         goto out;
 123 out_noerr:
 124         *err = 0;
 125         error = 1;
 126         goto out;
 127 }
 128
 129 /**
 130  *      __skb_recv_datagram - Receive a datagram skbuff
 131  *      @sk: socket
 132  *      @flags: MSG_ flags
 133  *      @peeked: returns non-zero if this packet has been seen before
 134  *      @err: error code returned
 135  *
 136  *      Get a datagram skbuff, understands the peeking, nonblocking wakeups
 137  *      and possible races. This replaces identical code in packet, raw and
 138  *      udp, as well as the IPX AX.25 and Appletalk. It also finally fixes
 139  *      the long standing peek and read race for datagram sockets. If you
 140  *      alter this routine remember it must be re-entrant.
 141  *
 142  *      This function will lock the socket if a skb is returned, so the caller
 143  *      needs to unlock the socket in that case (usually by calling
 144  *      skb_free_datagram)
 145  *
 146  *      * It does not lock socket since today. This function is
 147  *      * free of race conditions. This measure should/can improve
 148  *      * significantly datagram socket latencies at high loads,
 149  *      * when data copying to user space takes lots of time.
 150  *      * (BTW I've just killed the last cli() in IP/IPv6/core/netlink/packet
 151  *      *  8) Great win.)
 152  *      *                                           --ANK (980729)
 153  *
 154  *      The order of the tests when we find no data waiting are specified
 155  *      quite explicitly by POSIX 1003.1g, don't change them without having
 156  *      the standard around please.
 157  */
 158 struct sk_buff *__skb_recv_datagram(struct sock *sk, unsigned flags,
 159                                     int *peeked, int *err)
 160 {
 161         struct sk_buff *skb;
 162         long timeo;
 163         /*
 164          * Caller is allowed not to check sk->sk_err before skb_recv_datagram()
 165          */
 166         int error = sock_error(sk);
 167
 168         if (error)
 169                 goto no_packet;
 170
 171         timeo = sock_rcvtimeo(sk, flags & MSG_DONTWAIT);
 172
 173         do {
 174                 /* Again only user level code calls this function, so nothing
 175                  * interrupt level will suddenly eat the receive_queue.
 176                  *
 177                  * Look at current nfs client by the way...
 178                  * However, this function was corrent in any case. 8)
 179                  */
 180                 unsigned long cpu_flags;
 181
 182                 spin_lock_irqsave(&sk->sk_receive_queue.lock, cpu_flags);
 183                 skb = skb_peek(&sk->sk_receive_queue);
 184                 if (skb) {
 185                         *peeked = skb->peeked;
 186                         if (flags & MSG_PEEK) {
 187                                 skb->peeked = 1;
 188                                 atomic_inc(&skb->users);
 189                         } else
 190                                 __skb_unlink(skb, &sk->sk_receive_queue);
 191                 }
 192                 spin_unlock_irqrestore(&sk->sk_receive_queue.lock, cpu_flags);
 193
 194                 if (skb)
 195                         return skb;
 196
 197                 /* User doesn't want to wait */
 198                 error = -EAGAIN;
 199                 if (!timeo)
 200                         goto no_packet;
 201
 202         } while (!wait_for_packet(sk, err, &timeo));
 203
 204         return NULL;
 205
 206 no_packet:
 207         *err = error;
 208         return NULL;
 209 }
 210 EXPORT_SYMBOL(__skb_recv_datagram);
 211
 212 struct sk_buff *skb_recv_datagram(struct sock *sk, unsigned flags,
 213                                   int noblock, int *err)
 214 {
 215         int peeked;
 216
 217         return __skb_recv_datagram(sk, flags | (noblock ? MSG_DONTWAIT : 0),
 218                                    &peeked, err);
 219 }
 220
 221 void skb_free_datagram(struct sock *sk, struct sk_buff *skb)
 222 {
 223         consume_skb(skb);
 224         sk_mem_reclaim_partial(sk);
 225 }
 226
 227 /**
 228  *      skb_kill_datagram - Free a datagram skbuff forcibly
 229  *      @sk: socket
 230  *      @skb: datagram skbuff
 231  *      @flags: MSG_ flags
 232  *
 233  *      This function frees a datagram skbuff that was received by
 234  *      skb_recv_datagram.  The flags argument must match the one
 235  *      used for skb_recv_datagram.
 236  *
 237  *      If the MSG_PEEK flag is set, and the packet is still on the
 238  *      receive queue of the socket, it will be taken off the queue
 239  *      before it is freed.
 240  *
 241  *      This function currently only disables BH when acquiring the
 242  *      sk_receive_queue lock.  Therefore it must not be used in a
 243  *      context where that lock is acquired in an IRQ context.
 244  *
 245  *      It returns 0 if the packet was removed by us.
 246  */
 247
 248 int skb_kill_datagram(struct sock *sk, struct sk_buff *skb, unsigned int flags)
 249 {
 250         int err = 0;
 251
 252         if (flags & MSG_PEEK) {
 253                 err = -ENOENT;
 254                 spin_lock_bh(&sk->sk_receive_queue.lock);
 255                 if (skb == skb_peek(&sk->sk_receive_queue)) {
 256                         __skb_unlink(skb, &sk->sk_receive_queue);
 257                         atomic_dec(&skb->users);
 258                         err = 0;
 259                 }
 260                 spin_unlock_bh(&sk->sk_receive_queue.lock);
 261         }
 262
 263         kfree_skb(skb);
 264         sk_mem_reclaim_partial(sk);
 265
 266         return err;
 267 }
 268
 269 EXPORT_SYMBOL(skb_kill_datagram);
 270
 271 /**
 272  *      skb_copy_datagram_iovec - Copy a datagram to an iovec.
 273  *      @skb: buffer to copy
 274  *      @offset: offset in the buffer to start copying from
 275  *      @to: io vector to copy to
 276  *      @len: amount of data to copy from buffer to iovec
 277  *
 278  *      Note: the iovec is modified during the copy.
 279  */
 280 int skb_copy_datagram_iovec(const struct sk_buff *skb, int offset,
 281                             struct iovec *to, int len)
 282 {
 283         int start = skb_headlen(skb);
 284         int i, copy = start - offset;
 285
 286         /* Copy header. */
 287         if (copy > 0) {
 288                 if (copy > len)
 289                         copy = len;
 290                 if (memcpy_toiovec(to, skb->data + offset, copy))
 291                         goto fault;
 292                 if ((len -= copy) == 0)
 293                         return 0;
 294                 offset += copy;
 295         }
 296
 297         /* Copy paged appendix. Hmm... why does this look so complicated? */
 298         for (i = 0; i < skb_shinfo(skb)->nr_frags; i++) {
 299                 int end;
 300
 301                 WARN_ON(start > offset + len);
 302
 303                 end = start + skb_shinfo(skb)->frags[i].size;
 304                 if ((copy = end - offset) > 0) {
 305                         int err;
 306                         u8  *vaddr;
 307                         skb_frag_t *frag = &skb_shinfo(skb)->frags[i];
 308                         struct page *page = frag->page;
 309
 310                         if (copy > len)
 311                                 copy = len;
 312                         vaddr = kmap(page);
 313                         err = memcpy_toiovec(to, vaddr + frag->page_offset +
 314                                              offset - start, copy);
 315                         kunmap(page);
 316                         if (err)
 317                                 goto fault;
 318                         if (!(len -= copy))
 319                                 return 0;
 320                         offset += copy;
 321                 }
 322                 start = end;
 323         }
 324
 325         if (skb_shinfo(skb)->frag_list) {
 326                 struct sk_buff *list = skb_shinfo(skb)->frag_list;
 327
 328                 for (; list; list = list->next) {
 329                         int end;
 330
 331                         WARN_ON(start > offset + len);
 332
 333                         end = start + list->len;
 334                         if ((copy = end - offset) > 0) {
 335                                 if (copy > len)
 336                                         copy = len;
 337                                 if (skb_copy_datagram_iovec(list,
 338                                                             offset - start,
 339                                                             to, copy))
 340                                         goto fault;
 341                                 if ((len -= copy) == 0)
 342                                         return 0;
 343                                 offset += copy;
 344                         }
 345                         start = end;
 346                 }
 347         }
 348         if (!len)
 349                 return 0;
 350
 351 fault:
 352         return -EFAULT;
 353 }
 354
 355 /**
 356  *      skb_copy_datagram_const_iovec - Copy a datagram to an iovec.
 357  *      @skb: buffer to copy
 358  *      @offset: offset in the buffer to start copying from
 359  *      @to: io vector to copy to
 360  *      @to_offset: offset in the io vector to start copying to
 361  *      @len: amount of data to copy from buffer to iovec
 362  *
 363  *      Returns 0 or -EFAULT.
 364  *      Note: the iovec is not modified during the copy.
 365  */
 366 int skb_copy_datagram_const_iovec(const struct sk_buff *skb, int offset,
 367                                   const struct iovec *to, int to_offset,
 368                                   int len)
 369 {
 370         int start = skb_headlen(skb);
 371         int i, copy = start - offset;
 372
 373         /* Copy header. */
 374         if (copy > 0) {
 375                 if (copy > len)
 376                         copy = len;
 377                 if (memcpy_toiovecend(to, skb->data + offset, to_offset, copy))
 378                         goto fault;
 379                 if ((len -= copy) == 0)
 380                         return 0;
 381                 offset += copy;
 382                 to_offset += copy;
 383         }
 384
 385         /* Copy paged appendix. Hmm... why does this look so complicated? */
 386         for (i = 0; i < skb_shinfo(skb)->nr_frags; i++) {
 387                 int end;
 388
 389                 WARN_ON(start > offset + len);
 390
 391                 end = start + skb_shinfo(skb)->frags[i].size;
 392                 if ((copy = end - offset) > 0) {
 393                         int err;
 394                         u8  *vaddr;
 395                         skb_frag_t *frag = &skb_shinfo(skb)->frags[i];
 396                         struct page *page = frag->page;
 397
 398                         if (copy > len)
 399                                 copy = len;
 400                         vaddr = kmap(page);
 401                         err = memcpy_toiovecend(to, vaddr + frag->page_offset +
 402                                                 offset - start, to_offset, copy);
 403                         kunmap(page);
 404                         if (err)
 405                                 goto fault;
 406                         if (!(len -= copy))
 407                                 return 0;
 408                         offset += copy;
 409                         to_offset += copy;
 410                 }
 411                 start = end;
 412         }
 413
 414         if (skb_shinfo(skb)->frag_list) {
 415                 struct sk_buff *list = skb_shinfo(skb)->frag_list;
 416
 417                 for (; list; list = list->next) {
 418                         int end;
 419
 420                         WARN_ON(start > offset + len);
 421
 422                         end = start + list->len;
 423                         if ((copy = end - offset) > 0) {
 424                                 if (copy > len)
 425                                         copy = len;
 426                                 if (skb_copy_datagram_const_iovec(list,
 427                                                             offset - start,
 428                                                             to, to_offset,
 429                                                             copy))
 430                                         goto fault;
 431                                 if ((len -= copy) == 0)
 432                                         return 0;
 433                                 offset += copy;
 434                                 to_offset += copy;
 435                         }
 436                         start = end;
 437                 }
 438         }
 439         if (!len)
 440                 return 0;
 441
 442 fault:
 443         return -EFAULT;
 444 }
 445 EXPORT_SYMBOL(skb_copy_datagram_const_iovec);
 446
 447 /**
 448  *      skb_copy_datagram_from_iovec - Copy a datagram from an iovec.
 449  *      @skb: buffer to copy
 450  *      @offset: offset in the buffer to start copying to
 451  *      @from: io vector to copy to
 452  *      @from_offset: offset in the io vector to start copying from
 453  *      @len: amount of data to copy to buffer from iovec
 454  *
 455  *      Returns 0 or -EFAULT.
 456  *      Note: the iovec is not modified during the copy.
 457  */
 458 int skb_copy_datagram_from_iovec(struct sk_buff *skb, int offset,
 459                                  const struct iovec *from, int from_offset,
 460                                  int len)
 461 {
 462         int start = skb_headlen(skb);
 463         int i, copy = start - offset;
 464
 465         /* Copy header. */
 466         if (copy > 0) {
 467                 if (copy > len)
 468                         copy = len;
 469                 if (memcpy_fromiovecend(skb->data + offset, from, from_offset,
 470                                         copy))
 471                         goto fault;
 472                 if ((len -= copy) == 0)
 473                         return 0;
 474                 offset += copy;
 475                 from_offset += copy;
 476         }
 477
 478         /* Copy paged appendix. Hmm... why does this look so complicated? */
 479         for (i = 0; i < skb_shinfo(skb)->nr_frags; i++) {
 480                 int end;
 481
 482                 WARN_ON(start > offset + len);
 483
 484                 end = start + skb_shinfo(skb)->frags[i].size;
 485                 if ((copy = end - offset) > 0) {
 486                         int err;
 487                         u8  *vaddr;
 488                         skb_frag_t *frag = &skb_shinfo(skb)->frags[i];
 489                         struct page *page = frag->page;
 490
 491                         if (copy > len)
 492                                 copy = len;
 493                         vaddr = kmap(page);
 494                         err = memcpy_fromiovecend(vaddr + frag->page_offset +
 495                                                   offset - start,
 496                                                   from, from_offset, copy);
 497                         kunmap(page);
 498                         if (err)
 499                                 goto fault;
 500
 501                         if (!(len -= copy))
 502                                 return 0;
 503                         offset += copy;
 504                         from_offset += copy;
 505                 }
 506                 start = end;
 507         }
 508
 509         if (skb_shinfo(skb)->frag_list) {
 510                 struct sk_buff *list = skb_shinfo(skb)->frag_list;
 511
 512                 for (; list; list = list->next) {
 513                         int end;
 514
 515                         WARN_ON(start > offset + len);
 516
 517                         end = start + list->len;
 518                         if ((copy = end - offset) > 0) {
 519                                 if (copy > len)
 520                                         copy = len;
 521                                 if (skb_copy_datagram_from_iovec(list,
 522                                                                  offset - start,
 523                                                                  from,
 524                                                                  from_offset,
 525                                                                  copy))
 526                                         goto fault;
 527                                 if ((len -= copy) == 0)
 528                                         return 0;
 529                                 offset += copy;
 530                                 from_offset += copy;
 531                         }
 532                         start = end;
 533                 }
 534         }
 535         if (!len)
 536                 return 0;
 537
 538 fault:
 539         return -EFAULT;
 540 }
 541 EXPORT_SYMBOL(skb_copy_datagram_from_iovec);
 542
 543 static int skb_copy_and_csum_datagram(const struct sk_buff *skb, int offset,
 544                                       u8 __user *to, int len,
 545                                       __wsum *csump)
 546 {
 547         int start = skb_headlen(skb);
 548         int pos = 0;
 549         int i, copy = start - offset;
 550
 551         /* Copy header. */
 552         if (copy > 0) {
 553                 int err = 0;
 554                 if (copy > len)
 555                         copy = len;
 556                 *csump = csum_and_copy_to_user(skb->data + offset, to, copy,
 557                                                *csump, &err);
 558                 if (err)
 559                         goto fault;
 560                 if ((len -= copy) == 0)
 561                         return 0;
 562                 offset += copy;
 563                 to += copy;
 564                 pos = copy;
 565         }
 566
 567         for (i = 0; i < skb_shinfo(skb)->nr_frags; i++) {
 568                 int end;
 569
 570                 WARN_ON(start > offset + len);
 571
 572                 end = start + skb_shinfo(skb)->frags[i].size;
 573                 if ((copy = end - offset) > 0) {
 574                         __wsum csum2;
 575                         int err = 0;
 576                         u8  *vaddr;
 577                         skb_frag_t *frag = &skb_shinfo(skb)->frags[i];
 578                         struct page *page = frag->page;
 579
 580                         if (copy > len)
 581                                 copy = len;
 582                         vaddr = kmap(page);
 583                         csum2 = csum_and_copy_to_user(vaddr +
 584                                                         frag->page_offset +
 585                                                         offset - start,
 586                                                       to, copy, 0, &err);
 587                         kunmap(page);
 588                         if (err)
 589                                 goto fault;
 590                         *csump = csum_block_add(*csump, csum2, pos);
 591                         if (!(len -= copy))
 592                                 return 0;
 593                         offset += copy;
 594                         to += copy;
 595                         pos += copy;
 596                 }
 597                 start = end;
 598         }
 599
 600         if (skb_shinfo(skb)->frag_list) {
 601                 struct sk_buff *list = skb_shinfo(skb)->frag_list;
 602
 603                 for (; list; list=list->next) {
 604                         int end;
 605
 606                         WARN_ON(start > offset + len);
 607
 608                         end = start + list->len;
 609                         if ((copy = end - offset) > 0) {
 610                                 __wsum csum2 = 0;
 611                                 if (copy > len)
 612                                         copy = len;
 613                                 if (skb_copy_and_csum_datagram(list,
 614                                                                offset - start,
 615                                                                to, copy,
 616                                                                &csum2))
 617                                         goto fault;
 618                                 *csump = csum_block_add(*csump, csum2, pos);
 619                                 if ((len -= copy) == 0)
 620                                         return 0;
 621                                 offset += copy;
 622                                 to += copy;
 623                                 pos += copy;
 624                         }
 625                         start = end;
 626                 }
 627         }
 628         if (!len)
 629                 return 0;
 630
 631 fault:
 632         return -EFAULT;
 633 }
 634
 635 __sum16 __skb_checksum_complete_head(struct sk_buff *skb, int len)
 636 {
 637         __sum16 sum;
 638
 639         sum = csum_fold(skb_checksum(skb, 0, len, skb->csum));
 640         if (likely(!sum)) {
 641                 if (unlikely(skb->ip_summed == CHECKSUM_COMPLETE))
 642                         netdev_rx_csum_fault(skb->dev);
 643                 skb->ip_summed = CHECKSUM_UNNECESSARY;
 644         }
 645         return sum;
 646 }
 647 EXPORT_SYMBOL(__skb_checksum_complete_head);
 648
 649 __sum16 __skb_checksum_complete(struct sk_buff *skb)
 650 {
 651         return __skb_checksum_complete_head(skb, skb->len);
 652 }
 653 EXPORT_SYMBOL(__skb_checksum_complete);
 654
 655 /**
 656  *      skb_copy_and_csum_datagram_iovec - Copy and checkum skb to user iovec.
 657  *      @skb: skbuff
 658  *      @hlen: hardware length
 659  *      @iov: io vector
 660  *
 661  *      Caller _must_ check that skb will fit to this iovec.
 662  *
 663  *      Returns: 0       - success.
 664  *               -EINVAL - checksum failure.
 665  *               -EFAULT - fault during copy. Beware, in this case iovec
 666  *                         can be modified!
 667  */
 668 int skb_copy_and_csum_datagram_iovec(struct sk_buff *skb,
 669                                      int hlen, struct iovec *iov)
 670 {
 671         __wsum csum;
 672         int chunk = skb->len - hlen;
 673
 674         if (!chunk)
 675                 return 0;
 676
 677         /* Skip filled elements.
 678          * Pretty silly, look at memcpy_toiovec, though 8)
 679          */
 680         while (!iov->iov_len)
 681                 iov++;
 682
 683         if (iov->iov_len < chunk) {
 684                 if (__skb_checksum_complete(skb))
 685                         goto csum_error;
 686                 if (skb_copy_datagram_iovec(skb, hlen, iov, chunk))
 687                         goto fault;
 688         } else {
 689                 csum = csum_partial(skb->data, hlen, skb->csum);
 690                 if (skb_copy_and_csum_datagram(skb, hlen, iov->iov_base,
 691                                                chunk, &csum))
 692                         goto fault;
 693                 if (csum_fold(csum))
 694                         goto csum_error;
 695                 if (unlikely(skb->ip_summed == CHECKSUM_COMPLETE))
 696                         netdev_rx_csum_fault(skb->dev);
 697                 iov->iov_len -= chunk;
 698                 iov->iov_base += chunk;
 699         }
 700         return 0;
 701 csum_error:
 702         return -EINVAL;
 703 fault:
 704         return -EFAULT;
 705 }
 706
 707 /**
 708  *      datagram_poll - generic datagram poll
 709  *      @file: file struct
 710  *      @sock: socket
 711  *      @wait: poll table
 712  *
 713  *      Datagram poll: Again totally generic. This also handles
 714  *      sequenced packet sockets providing the socket receive queue
 715  *      is only ever holding data ready to receive.
 716  *
 717  *      Note: when you _don't_ use this routine for this protocol,
 718  *      and you use a different write policy from sock_writeable()
 719  *      then please supply your own write_space callback.
 720  */
 721 unsigned int datagram_poll(struct file *file, struct socket *sock,
 722                            poll_table *wait)
 723 {
 724         struct sock *sk = sock->sk;
 725         unsigned int mask;
 726
 727         poll_wait(file, sk->sk_sleep, wait);
 728         mask = 0;
 729
 730         /* exceptional events? */
 731         if (sk->sk_err || !skb_queue_empty(&sk->sk_error_queue))
 732                 mask |= POLLERR;
 733         if (sk->sk_shutdown & RCV_SHUTDOWN)
 734                 mask |= POLLRDHUP;
 735         if (sk->sk_shutdown == SHUTDOWN_MASK)
 736                 mask |= POLLHUP;
 737
 738         /* readable? */
 739         if (!skb_queue_empty(&sk->sk_receive_queue) ||
 740             (sk->sk_shutdown & RCV_SHUTDOWN))
 741                 mask |= POLLIN | POLLRDNORM;
 742
 743         /* Connection-based need to check for termination and startup */
 744         if (connection_based(sk)) {
 745                 if (sk->sk_state == TCP_CLOSE)
 746                         mask |= POLLHUP;
 747                 /* connection hasn't started yet? */
 748                 if (sk->sk_state == TCP_SYN_SENT)
 749                         return mask;
 750         }
 751
 752         /* writable? */
 753         if (sock_writeable(sk))
 754                 mask |= POLLOUT | POLLWRNORM | POLLWRBAND;
 755         else
 756                 set_bit(SOCK_ASYNC_NOSPACE, &sk->sk_socket->flags);
 757
 758         return mask;
 759 }
 760
 761 EXPORT_SYMBOL(datagram_poll);
 762 EXPORT_SYMBOL(skb_copy_and_csum_datagram_iovec);
 763 EXPORT_SYMBOL(skb_copy_datagram_iovec);
 764 EXPORT_SYMBOL(skb_free_datagram);
 765 EXPORT_SYMBOL(skb_recv_datagram);