Go to main content

man pages section 3: Extended Library Functions, Volume 1

Exit Print View

Updated: Wednesday, July 27, 2022
 
 

pcap_setdirection (3pcap)

Name

pcap_setdirection - tured

Synopsis

#include <pcap/pcap.h>

int pcap_setdirection(pcap_t *p, pcap_direction_t d);

Description

PCAP_SETDIRECTION(3pcap)                              PCAP_SETDIRECTION(3pcap)



NAME
       pcap_setdirection  -  set  the direction for which packets will be cap-
       tured

SYNOPSIS
       #include <pcap/pcap.h>

       int pcap_setdirection(pcap_t *p, pcap_direction_t d);

DESCRIPTION
       pcap_setdirection() is used to specify a direction that packets will be
       captured.    d  is  one  of  the  constants  PCAP_D_IN,  PCAP_D_OUT  or
       PCAP_D_INOUT.  PCAP_D_IN will only  capture  packets  received  by  the
       device,  PCAP_D_OUT  will  only  capture packets sent by the device and
       PCAP_D_INOUT will capture packets received by or sent  by  the  device.
       PCAP_D_INOUT is the default setting if this function is not called.

       pcap_setdirection() isn't necessarily fully supported on all platforms;
       some platforms might return an error for all  values,  and  some  other
       platforms might not support PCAP_D_OUT.

       This operation is not supported if a ``savefile'' is being read.

RETURN VALUE
       pcap_setdirection()  returns 0 on success and PCAP_ERROR on failure. If
       PCAP_ERROR is returned, pcap_geterr(3PCAP) or pcap_perror(3PCAP) may be
       called with p as an argument to fetch or display the error text.


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


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

SEE ALSO
       pcap(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/.



                                 25 July 2018         PCAP_SETDIRECTION(3pcap)