pcap_can_set_rfmon - check whether monitor mode can be set for a
not-yet-activated capture handle
#include <pcap/pcap.h>
int pcap_can_set_rfmon(pcap_t *p);
pcap_can_set_rfmon() checks whether monitor mode could be set on a
capture handle when the handle is activated.
pcap_can_set_rfmon() returns 0 if monitor mode could not be set,
1 if monitor mode could be set, and a negative value on error. A
negative return value indicates what error condition occurred. The possible
error values are:
- PCAP_ERROR_NO_SUCH_DEVICE
- The capture source specified when the handle was created doesn't
exist.
- PCAP_ERROR_PERM_DENIED
- The process doesn't have permission to check whether monitor mode could be
supported.
- PCAP_ERROR_ACTIVATED
- The capture handle has already been activated.
- PCAP_ERROR
- Another error occurred. pcap_geterr(3PCAP) or
pcap_perror(3PCAP) may be called with p as an argument to
fetch or display a message describing the error.
Additional error codes may be added in the future; a program
should check for 0, 1, and negative, return codes, and treat
all negative return codes as errors. pcap_statustostr(3PCAP) can be
called, with a warning or error code as an argument, to fetch a message
describing the warning or error code.
pcap(3PCAP), pcap_create(3PCAP), pcap_activate(3PCAP),
pcap_set_rfmon(3PCAP)