include/net/busy_poll.h

   1 /*
   2  * Low Latency Sockets
   3  * Copyright(c) 2013 Intel Corporation.
   4  *
   5  * This program is free software; you can redistribute it and/or modify it
   6  * under the terms and conditions of the GNU General Public License,
   7  * version 2, as published by the Free Software Foundation.
   8  *
   9  * This program is distributed in the hope it will be useful, but WITHOUT
  10  * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
  11  * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for
  12  * more details.
  13  *
  14  * You should have received a copy of the GNU General Public License along with
  15  * this program; if not, write to the Free Software Foundation, Inc.,
  16  * 51 Franklin St - Fifth Floor, Boston, MA 02110-1301 USA.
  17  *
  18  * Author: Eliezer Tamir
  19  *
  20  * Contact Information:
  21  * e1000-devel Mailing List <e1000-devel@lists.sourceforge.net>
  22  */
  23
  24 #ifndef _LINUX_NET_LL_POLL_H
  25 #define _LINUX_NET_LL_POLL_H
  26
  27 #include <linux/netdevice.h>
  28 #include <net/ip.h>
  29
  30 #ifdef CONFIG_NET_LL_RX_POLL
  31
  32 struct napi_struct;
  33 extern unsigned int sysctl_net_ll_read __read_mostly;
  34 extern unsigned int sysctl_net_ll_poll __read_mostly;
  35
  36 /* return values from ndo_ll_poll */
  37 #define LL_FLUSH_FAILED         -1
  38 #define LL_FLUSH_BUSY           -2
  39
  40 static inline bool net_busy_loop_on(void)
  41 {
  42         return sysctl_net_ll_poll;
  43 }
  44
  45 /* a wrapper to make debug_smp_processor_id() happy
  46  * we can use sched_clock() because we don't care much about precision
  47  * we only care that the average is bounded
  48  */
  49 #ifdef CONFIG_DEBUG_PREEMPT
  50 static inline u64 busy_loop_us_clock(void)
  51 {
  52         u64 rc;
  53
  54         preempt_disable_notrace();
  55         rc = sched_clock();
  56         preempt_enable_no_resched_notrace();
  57
  58         return rc >> 10;
  59 }
  60 #else /* CONFIG_DEBUG_PREEMPT */
  61 static inline u64 busy_loop_us_clock(void)
  62 {
  63         return sched_clock() >> 10;
  64 }
  65 #endif /* CONFIG_DEBUG_PREEMPT */
  66
  67 static inline unsigned long sk_busy_loop_end_time(struct sock *sk)
  68 {
  69         return busy_loop_us_clock() + ACCESS_ONCE(sk->sk_ll_usec);
  70 }
  71
  72 /* in poll/select we use the global sysctl_net_ll_poll value */
  73 static inline unsigned long busy_loop_end_time(void)
  74 {
  75         return busy_loop_us_clock() + ACCESS_ONCE(sysctl_net_ll_poll);
  76 }
  77
  78 static inline bool sk_can_busy_loop(struct sock *sk)
  79 {
  80         return sk->sk_ll_usec && sk->sk_napi_id &&
  81                !need_resched() && !signal_pending(current);
  82 }
  83
  84
  85 static inline bool busy_loop_timeout(unsigned long end_time)
  86 {
  87         unsigned long now = busy_loop_us_clock();
  88
  89         return time_after(now, end_time);
  90 }
  91
  92 /* when used in sock_poll() nonblock is known at compile time to be true
  93  * so the loop and end_time will be optimized out
  94  */
  95 static inline bool sk_busy_loop(struct sock *sk, int nonblock)
  96 {
  97         unsigned long end_time = !nonblock ? sk_busy_loop_end_time(sk) : 0;
  98         const struct net_device_ops *ops;
  99         struct napi_struct *napi;
 100         int rc = false;
 101
 102         /*
 103          * rcu read lock for napi hash
 104          * bh so we don't race with net_rx_action
 105          */
 106         rcu_read_lock_bh();
 107
 108         napi = napi_by_id(sk->sk_napi_id);
 109         if (!napi)
 110                 goto out;
 111
 112         ops = napi->dev->netdev_ops;
 113         if (!ops->ndo_ll_poll)
 114                 goto out;
 115
 116         do {
 117                 rc = ops->ndo_ll_poll(napi);
 118
 119                 if (rc == LL_FLUSH_FAILED)
 120                         break; /* permanent failure */
 121
 122                 if (rc > 0)
 123                         /* local bh are disabled so it is ok to use _BH */
 124                         NET_ADD_STATS_BH(sock_net(sk),
 125                                          LINUX_MIB_LOWLATENCYRXPACKETS, rc);
 126
 127         } while (!nonblock && skb_queue_empty(&sk->sk_receive_queue) &&
 128                  !need_resched() && !busy_loop_timeout(end_time));
 129
 130         rc = !skb_queue_empty(&sk->sk_receive_queue);
 131 out:
 132         rcu_read_unlock_bh();
 133         return rc;
 134 }
 135
 136 /* used in the NIC receive handler to mark the skb */
 137 static inline void skb_mark_ll(struct sk_buff *skb, struct napi_struct *napi)
 138 {
 139         skb->napi_id = napi->napi_id;
 140 }
 141
 142 /* used in the protocol hanlder to propagate the napi_id to the socket */
 143 static inline void sk_mark_ll(struct sock *sk, struct sk_buff *skb)
 144 {
 145         sk->sk_napi_id = skb->napi_id;
 146 }
 147
 148 #else /* CONFIG_NET_LL_RX_POLL */
 149 static inline unsigned long net_busy_loop_on(void)
 150 {
 151         return 0;
 152 }
 153
 154 static inline unsigned long busy_loop_end_time(void)
 155 {
 156         return 0;
 157 }
 158
 159 static inline bool sk_can_busy_loop(struct sock *sk)
 160 {
 161         return false;
 162 }
 163
 164 static inline bool sk_busy_poll(struct sock *sk, int nonblock)
 165 {
 166         return false;
 167 }
 168
 169 static inline void skb_mark_ll(struct sk_buff *skb, struct napi_struct *napi)
 170 {
 171 }
 172
 173 static inline void sk_mark_ll(struct sock *sk, struct sk_buff *skb)
 174 {
 175 }
 176
 177 static inline bool busy_loop_timeout(unsigned long end_time)
 178 {
 179         return true;
 180 }
 181
 182 #endif /* CONFIG_NET_LL_RX_POLL */
 183 #endif /* _LINUX_NET_LL_POLL_H */