Add changes from the Linux-2.6 tree.
[linux-2.6.git] / net / core / gen_stats.c
index 2b2ba65..8f21490 100644 (file)
@@ -34,24 +34,57 @@ rtattr_failure:
        return -1;
 }
 
+/**
+ * gnet_stats_start_copy_compat - start dumping procedure in compatibility mode
+ * @skb: socket buffer to put statistics TLVs into
+ * @type: TLV type for top level statistic TLV
+ * @tc_stats_type: TLV type for backward compatibility struct tc_stats TLV
+ * @xstats_type: TLV type for backward compatibility xstats TLV
+ * @lock: statistics lock
+ * @d: dumping handle
+ *
+ * Initializes the dumping handle, grabs the statistic lock and appends
+ * an empty TLV header to the socket buffer for use a container for all
+ * other statistic TLVS.
+ *
+ * The dumping handle is marked to be in backward compatibility mode telling
+ * all gnet_stats_copy_XXX() functions to fill a local copy of struct tc_stats.
+ *
+ * Returns 0 on success or -1 if the room in the socket buffer was not sufficient.
+ */
 int
 gnet_stats_start_copy_compat(struct sk_buff *skb, int type, int tc_stats_type,
        int xstats_type, spinlock_t *lock, struct gnet_dump *d)
 {
+       memset(d, 0, sizeof(*d));
+       
        spin_lock_bh(lock);
        d->lock = lock;
-       d->tail = (struct rtattr *) skb->tail;
+       if (type)
+               d->tail = (struct rtattr *) skb->tail;
        d->skb = skb;
        d->compat_tc_stats = tc_stats_type;
        d->compat_xstats = xstats_type;
-       d->xstats = NULL;
 
-       if (d->compat_tc_stats)
-               memset(&d->tc_stats, 0, sizeof(d->tc_stats));
+       if (d->tail)
+               return gnet_stats_copy(d, type, NULL, 0);
 
-       return gnet_stats_copy(d, type, NULL, 0);
+       return 0;
 }
 
+/**
+ * gnet_stats_start_copy_compat - start dumping procedure in compatibility mode
+ * @skb: socket buffer to put statistics TLVs into
+ * @type: TLV type for top level statistic TLV
+ * @lock: statistics lock
+ * @d: dumping handle
+ *
+ * Initializes the dumping handle, grabs the statistic lock and appends
+ * an empty TLV header to the socket buffer for use a container for all
+ * other statistic TLVS.
+ *
+ * Returns 0 on success or -1 if the room in the socket buffer was not sufficient.
+ */
 int
 gnet_stats_start_copy(struct sk_buff *skb, int type, spinlock_t *lock,
        struct gnet_dump *d)
@@ -59,7 +92,17 @@ gnet_stats_start_copy(struct sk_buff *skb, int type, spinlock_t *lock,
        return gnet_stats_start_copy_compat(skb, type, 0, 0, lock, d);
 }
 
-
+/**
+ * gnet_stats_copy_basic - copy basic statistics into statistic TLV
+ * @d: dumping handle
+ * @b: basic statistics
+ *
+ * Appends the basic statistics to the top level TLV created by
+ * gnet_stats_start_copy().
+ *
+ * Returns 0 on success or -1 with the statistic lock released
+ * if the room in the socket buffer was not sufficient.
+ */
 int
 gnet_stats_copy_basic(struct gnet_dump *d, struct gnet_stats_basic *b)
 {
@@ -67,10 +110,24 @@ gnet_stats_copy_basic(struct gnet_dump *d, struct gnet_stats_basic *b)
                d->tc_stats.bytes = b->bytes;
                d->tc_stats.packets = b->packets;
        }
-       
-       return gnet_stats_copy(d, TCA_STATS_BASIC, b, sizeof(*b));
+
+       if (d->tail)
+               return gnet_stats_copy(d, TCA_STATS_BASIC, b, sizeof(*b));
+
+       return 0;
 }
 
+/**
+ * gnet_stats_copy_rate_est - copy rate estimator statistics into statistics TLV
+ * @d: dumping handle
+ * @r: rate estimator statistics
+ *
+ * Appends the rate estimator statistics to the top level TLV created by
+ * gnet_stats_start_copy().
+ *
+ * Returns 0 on success or -1 with the statistic lock released
+ * if the room in the socket buffer was not sufficient.
+ */
 int
 gnet_stats_copy_rate_est(struct gnet_dump *d, struct gnet_stats_rate_est *r)
 {
@@ -79,9 +136,23 @@ gnet_stats_copy_rate_est(struct gnet_dump *d, struct gnet_stats_rate_est *r)
                d->tc_stats.pps = r->pps;
        }
 
-       return gnet_stats_copy(d, TCA_STATS_RATE_EST, r, sizeof(*r));
+       if (d->tail)
+               return gnet_stats_copy(d, TCA_STATS_RATE_EST, r, sizeof(*r));
+
+       return 0;
 }
 
+/**
+ * gnet_stats_copy_queue - copy queue statistics into statistics TLV
+ * @d: dumping handle
+ * @q: queue statistics
+ *
+ * Appends the queue statistics to the top level TLV created by
+ * gnet_stats_start_copy().
+ *
+ * Returns 0 on success or -1 with the statistic lock released
+ * if the room in the socket buffer was not sufficient.
+ */
 int
 gnet_stats_copy_queue(struct gnet_dump *d, struct gnet_stats_queue *q)
 {
@@ -91,22 +162,57 @@ gnet_stats_copy_queue(struct gnet_dump *d, struct gnet_stats_queue *q)
                d->tc_stats.backlog = q->backlog;
                d->tc_stats.overlimits = q->overlimits;
        }
-               
-       return gnet_stats_copy(d, TCA_STATS_QUEUE, q, sizeof(*q));
+
+       if (d->tail)
+               return gnet_stats_copy(d, TCA_STATS_QUEUE, q, sizeof(*q));
+
+       return 0;
 }
 
+/**
+ * gnet_stats_copy_app - copy application specific statistics into statistics TLV
+ * @d: dumping handle
+ * @st: application specific statistics data
+ * @len: length of data
+ *
+ * Appends the application sepecific statistics to the top level TLV created by
+ * gnet_stats_start_copy() and remembers the data for XSTATS if the dumping
+ * handle is in backward compatibility mode.
+ *
+ * Returns 0 on success or -1 with the statistic lock released
+ * if the room in the socket buffer was not sufficient.
+ */
 int
 gnet_stats_copy_app(struct gnet_dump *d, void *st, int len)
 {
-       if (d->compat_xstats)
-               d->xstats = (struct rtattr *) d->skb->tail;
-       return gnet_stats_copy(d, TCA_STATS_APP, st, len);
+       if (d->compat_xstats) {
+               d->xstats = st;
+               d->xstats_len = len;
+       }
+
+       if (d->tail)
+               return gnet_stats_copy(d, TCA_STATS_APP, st, len);
+
+       return 0;
 }
 
+/**
+ * gnet_stats_finish_copy - finish dumping procedure
+ * @d: dumping handle
+ *
+ * Corrects the length of the top level TLV to include all TLVs added
+ * by gnet_stats_copy_XXX() calls. Adds the backward compatibility TLVs
+ * if gnet_stats_start_copy_compat() was used and releases the statistics
+ * lock.
+ *
+ * Returns 0 on success or -1 with the statistic lock released
+ * if the room in the socket buffer was not sufficient.
+ */
 int
 gnet_stats_finish_copy(struct gnet_dump *d)
 {
-       d->tail->rta_len = d->skb->tail - (u8 *) d->tail;
+       if (d->tail)
+               d->tail->rta_len = d->skb->tail - (u8 *) d->tail;
 
        if (d->compat_tc_stats)
                if (gnet_stats_copy(d, d->compat_tc_stats, &d->tc_stats,
@@ -114,8 +220,8 @@ gnet_stats_finish_copy(struct gnet_dump *d)
                        return -1;
 
        if (d->compat_xstats && d->xstats) {
-               if (gnet_stats_copy(d, d->compat_xstats, RTA_DATA(d->xstats),
-                       RTA_PAYLOAD(d->xstats)) < 0)
+               if (gnet_stats_copy(d, d->compat_xstats, d->xstats,
+                       d->xstats_len) < 0)
                        return -1;
        }
 
@@ -125,6 +231,7 @@ gnet_stats_finish_copy(struct gnet_dump *d)
 
 
 EXPORT_SYMBOL(gnet_stats_start_copy);
+EXPORT_SYMBOL(gnet_stats_start_copy_compat);
 EXPORT_SYMBOL(gnet_stats_copy_basic);
 EXPORT_SYMBOL(gnet_stats_copy_rate_est);
 EXPORT_SYMBOL(gnet_stats_copy_queue);