net: add kerneldoc to skb_copy_bits()
authorEric Dumazet <eric.dumazet@gmail.com>
Fri, 29 Jul 2011 18:37:31 +0000 (18:37 +0000)
committerDavid S. Miller <davem@davemloft.net>
Tue, 2 Aug 2011 01:03:06 +0000 (18:03 -0700)
Since skb_copy_bits() is called from assembly, add a fat comment to make
clear we should think twice before changing its prototype.

Signed-off-by: Eric Dumazet <eric.dumazet@gmail.com>
Signed-off-by: David S. Miller <davem@davemloft.net>
net/core/skbuff.c

index 2beda824636e7d270c8a8f24f2e084cfdef75ab4..27002dffe7ed3ea4df4f9b8d77b4210615d668c2 100644 (file)
@@ -1369,8 +1369,21 @@ pull_pages:
 }
 EXPORT_SYMBOL(__pskb_pull_tail);
 
-/* Copy some data bits from skb to kernel buffer. */
-
+/**
+ *     skb_copy_bits - copy bits from skb to kernel buffer
+ *     @skb: source skb
+ *     @offset: offset in source
+ *     @to: destination buffer
+ *     @len: number of bytes to copy
+ *
+ *     Copy the specified number of bytes from the source skb to the
+ *     destination buffer.
+ *
+ *     CAUTION ! :
+ *             If its prototype is ever changed,
+ *             check arch/{*}/net/{*}.S files,
+ *             since it is called from BPF assembly code.
+ */
 int skb_copy_bits(const struct sk_buff *skb, int offset, void *to, int len)
 {
        int start = skb_headlen(skb);