1PCAP_SET_IMMEDIATE_MODE(3PCAP)                  PCAP_SET_IMMEDIATE_MODE(3PCAP)
2
3
4

NAME

6       pcap_set_immediate_mode  -  set  immediate mode for a not-yet-activated
7       capture handle
8

SYNOPSIS

10       #include <pcap/pcap.h>
11
12       int pcap_set_immediate_mode(pcap_t *p, int immediate_mode);
13

DESCRIPTION

15       pcap_set_immediate_mode() sets whether immediate mode should be set  on
16       a  capture  handle  when  the  handle is activated.  In immediate mode,
17       packets are always delivered as soon as they arrive, with no buffering.
18       If immediate_mode is non-zero, immediate mode will be set, otherwise it
19       will not be set.
20

RETURN VALUE

22       pcap_set_immediate_mode() returns 0 on success or  PCAP_ERROR_ACTIVATED
23       if called on a capture handle that has been activated.
24

BACKWARD COMPATIBILITY

26       This  function  became available in libpcap release 1.5.0.  In previous
27       releases, if immediate delivery of packets is required:
28
29              on FreeBSD, NetBSD, OpenBSD, DragonFly BSD, macOS,  and  Solaris
30              11,  immediate  mode  must  be  turned  on  with a BIOCIMMEDIATE
31              ioctl(2), as documented in bpf(4), on the descriptor returned by
32              pcap_fileno(3PCAP), after pcap_activate(3PCAP) is called;
33
34              on  Solaris  10  and earlier versions of Solaris, immediate mode
35              must be turned on by using a read timeout of 0 when opening  the
36              device  (this  will not provide immediate delivery of packets on
37              other platforms, so don't assume it's sufficient);
38
39              on Digital UNIX/Tru64 UNIX, immediate mode must be turned on  by
40              doing  a  BIOCMBIC  ioctl,  as documented in packetfilter(7), to
41              clear  the  ENBATCH  flag  on   the   descriptor   returned   by
42              pcap_fileno(3PCAP), after pcap_activate(3PCAP) is called;
43
44              on  Windows,  immediate  mode  must  be  turned  on  by  calling
45              pcap_setmintocopy() with a size of 0.
46
47       On Linux, with previous releases of libpcap, capture devices are always
48       in  immediate  mode; however, in 1.5.0 and later, they are, by default,
49       not in immediate mode, so if pcap_set_immediate_mode() is available, it
50       should be used.
51
52       On other platforms, capture devices are always in immediate mode.
53

SEE ALSO

55       pcap(3PCAP), pcap_create(3PCAP), pcap_activate(3PCAP)
56
57
58
59                                22 August 2018  PCAP_SET_IMMEDIATE_MODE(3PCAP)
Impressum