aboutsummaryrefslogtreecommitdiff
path: root/pcap_breakloop.3pcap
diff options
context:
space:
mode:
authorHaibo Huang <hhb@google.com>2018-07-23 17:26:52 -0700
committerHaibo Huang <hhb@google.com>2018-07-24 09:44:25 -0700
commit165065aed040e9658cb43fc1194d6799c9227043 (patch)
tree8b959bf9d2b44f2b12c86dfdc5810210d587e99e /pcap_breakloop.3pcap
parentba51ee392e9b2d5dd04faaf695b1da82488d0323 (diff)
downloadlibpcap-165065aed040e9658cb43fc1194d6799c9227043.tar.gz
Update libpcap to 1.9.0
Test: compile Change-Id: I5b036bc4544b3150629b943d3a7896d7dc03fec9
Diffstat (limited to 'pcap_breakloop.3pcap')
-rw-r--r--pcap_breakloop.3pcap18
1 files changed, 15 insertions, 3 deletions
diff --git a/pcap_breakloop.3pcap b/pcap_breakloop.3pcap
index 3f9327b1..03b8d8d1 100644
--- a/pcap_breakloop.3pcap
+++ b/pcap_breakloop.3pcap
@@ -17,7 +17,7 @@
.\" WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
.\" MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
.\"
-.TH PCAP_BREAKLOOP 3PCAP "8 March 2015"
+.TH PCAP_BREAKLOOP 3PCAP "8 November 2017"
.SH NAME
pcap_breakloop \- force a pcap_dispatch() or pcap_loop() call to return
.SH SYNOPSIS
@@ -62,9 +62,21 @@ packets arrive and the call completes.
Note also that, in a multi-threaded application, if one thread is
blocked in pcap_dispatch(), pcap_loop(), pcap_next(), or pcap_next_ex(),
a call to pcap_breakloop() in a different thread will not unblock that
-thread; you will need to use whatever mechanism the OS provides for
+thread.
+.ft R
+You will need to use whatever mechanism the OS provides for
breaking a thread out of blocking calls in order to unblock the thread,
-such as thread cancellation in systems that support POSIX threads.
+such as thread cancellation or thread signalling in systems that support
+POSIX threads, or
+.B SetEvent()
+on the result of
+.B pcap_getevent()
+on a
+.B pcap_t
+on which the thread is blocked on Windows. Asynchronous procedure calls
+will not work on Windows, as a thread blocked on a
+.B pcap_t
+will not be in an alertable state.
.ft R
.PP
Note that