include/net/dst.h

   1 /*
   2  * net/dst.h    Protocol independent destination cache definitions.
   3  *
   4  * Authors:     Alexey Kuznetsov, <kuznet@ms2.inr.ac.ru>
   5  *
   6  */
   7
   8 #ifndef _NET_DST_H
   9 #define _NET_DST_H
  10
  11 #include <linux/config.h>
  12 #include <linux/rtnetlink.h>
  13 #include <linux/rcupdate.h>
  14 #include <linux/jiffies.h>
  15 #include <net/neighbour.h>
  16 #include <asm/processor.h>
  17
  18 /*
  19  * 0 - no debugging messages
  20  * 1 - rare events and bugs (default)
  21  * 2 - trace mode.
  22  */
  23 #define RT_CACHE_DEBUG          0
  24
  25 #define DST_GC_MIN      (HZ/10)
  26 #define DST_GC_INC      (HZ/2)
  27 #define DST_GC_MAX      (120*HZ)
  28
  29 /* Each dst_entry has reference count and sits in some parent list(s).
  30  * When it is removed from parent list, it is "freed" (dst_free).
  31  * After this it enters dead state (dst->obsolete > 0) and if its refcnt
  32  * is zero, it can be destroyed immediately, otherwise it is added
  33  * to gc list and garbage collector periodically checks the refcnt.
  34  */
  35
  36 struct sk_buff;
  37
  38 struct dst_entry
  39 {
  40         struct dst_entry        *next;
  41         atomic_t                __refcnt;       /* client references    */
  42         int                     __use;
  43         struct dst_entry        *child;
  44         struct net_device       *dev;
  45         int                     obsolete;
  46         int                     flags;
  47 #define DST_HOST                1
  48 #define DST_NOXFRM              2
  49 #define DST_NOPOLICY            4
  50 #define DST_NOHASH              8
  51         unsigned long           lastuse;
  52         unsigned long           expires;
  53
  54         unsigned short          header_len;     /* more space at head required */
  55         unsigned short          trailer_len;    /* space to reserve at tail */
  56
  57         u32                     metrics[RTAX_MAX];
  58         struct dst_entry        *path;
  59
  60         unsigned long           rate_last;      /* rate limiting for ICMP */
  61         unsigned long           rate_tokens;
  62
  63         int                     error;
  64
  65         struct neighbour        *neighbour;
  66         struct hh_cache         *hh;
  67         struct xfrm_state       *xfrm;
  68
  69         int                     (*input)(struct sk_buff*);
  70         int                     (*output)(struct sk_buff*);
  71
  72 #ifdef CONFIG_NET_CLS_ROUTE
  73         __u32                   tclassid;
  74 #endif
  75
  76         struct  dst_ops         *ops;
  77         struct rcu_head         rcu_head;
  78
  79         char                    info[0];
  80 };
  81
  82
  83 struct dst_ops
  84 {
  85         unsigned short          family;
  86         unsigned short          protocol;
  87         unsigned                gc_thresh;
  88
  89         int                     (*gc)(void);
  90         struct dst_entry *      (*check)(struct dst_entry *, __u32 cookie);
  91         void                    (*destroy)(struct dst_entry *);
  92         void                    (*ifdown)(struct dst_entry *, int how);
  93         struct dst_entry *      (*negative_advice)(struct dst_entry *);
  94         void                    (*link_failure)(struct sk_buff *);
  95         void                    (*update_pmtu)(struct dst_entry *dst, u32 mtu);
  96         int                     (*get_mss)(struct dst_entry *dst, u32 mtu);
  97         int                     entry_size;
  98
  99         atomic_t                entries;
 100         kmem_cache_t            *kmem_cachep;
 101 };
 102
 103 #ifdef __KERNEL__
 104
 105 static inline u32
 106 dst_metric(const struct dst_entry *dst, int metric)
 107 {
 108         return dst->metrics[metric-1];
 109 }
 110
 111 static inline u32
 112 dst_path_metric(const struct dst_entry *dst, int metric)
 113 {
 114         return dst->path->metrics[metric-1];
 115 }
 116
 117 static inline u32
 118 dst_pmtu(const struct dst_entry *dst)
 119 {
 120         u32 mtu = dst_path_metric(dst, RTAX_MTU);
 121         /* Yes, _exactly_. This is paranoia. */
 122         barrier();
 123         return mtu;
 124 }
 125
 126 static inline int
 127 dst_metric_locked(struct dst_entry *dst, int metric)
 128 {
 129         return dst_metric(dst, RTAX_LOCK) & (1<<metric);
 130 }
 131
 132 static inline void dst_hold(struct dst_entry * dst)
 133 {
 134         atomic_inc(&dst->__refcnt);
 135 }
 136
 137 static inline
 138 struct dst_entry * dst_clone(struct dst_entry * dst)
 139 {
 140         if (dst)
 141                 atomic_inc(&dst->__refcnt);
 142         return dst;
 143 }
 144
 145 static inline
 146 void dst_release(struct dst_entry * dst)
 147 {
 148         if (dst) {
 149                 WARN_ON(atomic_read(&dst->__refcnt) < 1);
 150                 atomic_dec(&dst->__refcnt);
 151         }
 152 }
 153
 154 /* Children define the path of the packet through the
 155  * Linux networking.  Thus, destinations are stackable.
 156  */
 157
 158 static inline struct dst_entry *dst_pop(struct dst_entry *dst)
 159 {
 160         struct dst_entry *child = dst_clone(dst->child);
 161
 162         dst_release(dst);
 163         return child;
 164 }
 165
 166 extern void * dst_alloc(struct dst_ops * ops);
 167 extern void __dst_free(struct dst_entry * dst);
 168 extern struct dst_entry *dst_destroy(struct dst_entry * dst);
 169
 170 static inline void dst_free(struct dst_entry * dst)
 171 {
 172         if (dst->obsolete > 1)
 173                 return;
 174         if (!atomic_read(&dst->__refcnt)) {
 175                 dst = dst_destroy(dst);
 176                 if (!dst)
 177                         return;
 178         }
 179         __dst_free(dst);
 180 }
 181
 182 static inline void dst_rcu_free(struct rcu_head *head)
 183 {
 184         struct dst_entry *dst = container_of(head, struct dst_entry, rcu_head);
 185         dst_free(dst);
 186 }
 187
 188 static inline void dst_confirm(struct dst_entry *dst)
 189 {
 190         if (dst)
 191                 neigh_confirm(dst->neighbour);
 192 }
 193
 194 static inline void dst_negative_advice(struct dst_entry **dst_p)
 195 {
 196         struct dst_entry * dst = *dst_p;
 197         if (dst && dst->ops->negative_advice)
 198                 *dst_p = dst->ops->negative_advice(dst);
 199 }
 200
 201 static inline void dst_link_failure(struct sk_buff *skb)
 202 {
 203         struct dst_entry * dst = skb->dst;
 204         if (dst && dst->ops && dst->ops->link_failure)
 205                 dst->ops->link_failure(skb);
 206 }
 207
 208 static inline void dst_set_expires(struct dst_entry *dst, int timeout)
 209 {
 210         unsigned long expires = jiffies + timeout;
 211
 212         if (expires == 0)
 213                 expires = 1;
 214
 215         if (dst->expires == 0 || time_before(expires, dst->expires))
 216                 dst->expires = expires;
 217 }
 218
 219 /* Output packet to network from transport.  */
 220 static inline int dst_output(struct sk_buff *skb)
 221 {
 222         int err;
 223
 224         for (;;) {
 225                 err = skb->dst->output(skb);
 226
 227                 if (likely(err == 0))
 228                         return err;
 229                 if (unlikely(err != NET_XMIT_BYPASS))
 230                         return err;
 231         }
 232 }
 233
 234 /* Input packet from network to transport.  */
 235 static inline int dst_input(struct sk_buff *skb)
 236 {
 237         int err;
 238
 239         for (;;) {
 240                 err = skb->dst->input(skb);
 241
 242                 if (likely(err == 0))
 243                         return err;
 244                 /* Oh, Jamal... Seems, I will not forgive you this mess. :-) */
 245                 if (unlikely(err != NET_XMIT_BYPASS))
 246                         return err;
 247         }
 248 }
 249
 250 extern void             dst_init(void);
 251
 252 struct flowi;
 253 #ifndef CONFIG_XFRM
 254 static inline int xfrm_lookup(struct dst_entry **dst_p, struct flowi *fl,
 255                        struct sock *sk, int flags)
 256 {
 257         return 0;
 258 }
 259 #else
 260 extern int xfrm_lookup(struct dst_entry **dst_p, struct flowi *fl,
 261                        struct sock *sk, int flags);
 262 #endif
 263 #endif
 264
 265 #endif /* _NET_DST_H */