NAME

       pcap_activate - activate a capture handle

SYNOPSIS

       #include <pcap/pcap.h>

       int pcap_activate(pcap_t *p);

DESCRIPTION

       pcap_activate()  is  used  to  activate  a packet capture handle to look at packets on the
       network, with the options that were set on the handle being in effect.

RETURN VALUE

       pcap_activate() returns 0 on  success  without  warnings,  PCAP_WARNING_PROMISC_NOTSUP  on
       success  on  a  device  that  doesn't  support  promiscuous  mode  if promiscuous mode was
       requested, PCAP_WARNING_TSTAMP_TYPE_NOTSUP on success if the time stamp type specified  in
       a  previous  pcap_set_tstamp_type()  call  isn't supported by the capture source (the time
       stamp type is left as the default),  PCAP_WARNING  on  success  with  any  other  warning,
       PCAP_ERROR_ACTIVATED  if  the handle has already been activated, PCAP_ERROR_NO_SUCH_DEVICE
       if  the  capture  source  specified  when  the   handle   was   created   doesn't   exist,
       PCAP_ERROR_PERM_DENIED  if the process doesn't have permission to open the capture source,
       PCAP_ERROR_PROMISC_PERM_DENIED if the process has permission to open  the  capture  source
       but  doesn't  have  permission to put it into promiscuous mode, PCAP_ERROR_RFMON_NOTSUP if
       monitor  mode  was  specified  but  the  capture  source  doesn't  support  monitor  mode,
       PCAP_ERROR_IFACE_NOT_UP  if  the capture source is not up, and PCAP_ERROR if another error
       occurred.  If PCAP_WARNING or PCAP_ERROR is returned, pcap_geterr() or  pcap_perror()  may
       be  called  with  p as an argument to fetch or display a message describing the warning or
       error.       If      PCAP_WARNING_PROMISC_NOTSUP,      PCAP_ERROR_NO_SUCH_DEVICE,       or
       PCAP_ERROR_PERM_DENIED is returned, pcap_geterr() or pcap_perror() may be called with p as
       an argument to fetch or display an message giving additional  details  about  the  problem
       that might be useful for debugging the problem if it's unexpected.

SEE ALSO

       pcap(3PCAP)

                                        21 September 2010                    PCAP_ACTIVATE(3PCAP)