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