NAME | SYNOPSIS | DESCRIPTION | RETURN VALUE | SEE ALSO | COLOPHON

PCAP_CAN_SET_RFMON(3PCAP)                          PCAP_CAN_SET_RFMON(3PCAP)

NAME         top

       pcap_can_set_rfmon - check whether monitor mode can be set for a not-
       yet-activated capture handle

SYNOPSIS         top

       #include <pcap/pcap.h>

       int pcap_can_set_rfmon(pcap_t *p);

DESCRIPTION         top

       pcap_can_set_rfmon() checks whether monitor mode could be set on a
       capture handle when the handle is activated.

RETURN VALUE         top

       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         top

       pcap(3PCAP), pcap_create(3PCAP), pcap_activate(3PCAP),
       pcap_set_rfmon(3PCAP)

COLOPHON         top

       This page is part of the libpcap (packet capture library) project.
       Information about the project can be found at 
       ⟨http://www.tcpdump.org/⟩.  If you have a bug report for this manual
       page, see ⟨http://www.tcpdump.org/#patches⟩.  This page was obtained
       from the project's upstream Git repository 
       ⟨https://github.com/the-tcpdump-group/libpcap.git⟩ on 2017-04-25.  If
       you discover any rendering problems in this HTML version of the page,
       or you believe there is a better or more up-to-date source for the
       page, or you have corrections or improvements to the information in
       this COLOPHON (which is not part of the original manual page), send a
       mail to man-pages@man7.org

                               3 January 2014      PCAP_CAN_SET_RFMON(3PCAP)