PCAP_CAN_SET_RFMON
Section: Misc. Reference Manual Pages (3PCAP)
Updated: 31 July 2016
Page Index
NAME
pcap_can_set_rfmon - check whether monitor mode can be set for a
not-yet-activated capture handle
SYNOPSIS
#include <pcap/pcap.h>
int pcap_can_set_rfmon(pcap_t *p);
DESCRIPTION
pcap_can_set_rfmon()
checks whether monitor mode could be set on a capture handle when
the handle is activated.
RETURN VALUE
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()
or
pcap_perror()
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()
can be called, with a warning or error code as an argument, to fetch a
message describing the warning or error code.
SEE ALSO
pcap(3PCAP),
pcap_create(3PCAP),
pcap_activate(3PCAP),
pcap_set_rfmon(3PCAP)