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)

                                                  5 April 2008                              PCAP_ACTIVATE(3PCAP)