Clarify the lifetime of the packet header and data when reading packets.

(Yes, I know - I'm using "data" as a collective noun. :-))

1 files changed, 6 insertions, 1 deletions

diff --git a/pcap_loop.3pcap b/pcap_loop.3pcap
index 70cfaa02..da306931 100644
--- a/pcap_loop.3pcap
+++ b/pcap_loop.3pcap
@@ -109,7 +109,12 @@ pointer to the first
 (as given in the
 .I struct pcap_pkthdr
 a pointer to which is passed to the callback routine)
-bytes of data from the packet.
+bytes of data from the packet.  The
+.I struct pcap_pkthdr
+and the packet data are not to be freed by the callback routine, and are
+not guaranteed to be valid after the callback routine returns; if the
+code needs them to be valid after the callback, it must make a copy of
+them.
 .SH RETURN VALUE
 .B pcap_loop()
 returns 0 if