Go to main content

man pages section 3: Extended Library Functions, Volume 1

Exit Print View

Updated: Wednesday, July 27, 2022
 
 

pcap_can_set_rfmon (3pcap)

Name

pcap_can_set_rfmon - yet-activated capture handle

Synopsis

#include <pcap/pcap.h>

int pcap_can_set_rfmon(pcap_t *p);

Description

PCAP_CAN_SET_RFMON(3pcap)                            PCAP_CAN_SET_RFMON(3pcap)



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 cap-
       ture 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(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.


ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:


       +---------------+------------------------+
       |ATTRIBUTE TYPE |    ATTRIBUTE VALUE     |
       +---------------+------------------------+
       |Availability   | system/library/libpcap |
       +---------------+------------------------+
       |Stability      | Uncommitted            |
       +---------------+------------------------+

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



NOTES
       Source  code  for open source software components in Oracle Solaris can
       be found at https://www.oracle.com/downloads/opensource/solaris-source-
       code-downloads.html.

       This     software     was    built    from    source    available    at
       https://github.com/oracle/solaris-userland.   The  original   community
       source   was   downloaded  from   https://www.tcpdump.org/release/libp-
       cap-1.9.1.tar.gz.

       Further information about this software can be found on the open source
       community website at https://www.tcpdump.org/.



                                 31 July 2016        PCAP_CAN_SET_RFMON(3pcap)