pcap_setdirection(3pcap)

pcap_setdirection3pcap

Set the direction for which packets will be captured

Usage

#include <pcap/pcap.h>

int pcap_setdirection(pcap_t *p, pcap_direction_t d);

Overview

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.

Releases

90 releases since Mac OS X 10.6; the text changed 5 times.

  1. 10.6–10.6.8
  2. 10.7–10.11.6
  3. 10.12–10.14.6
  4. 10.15–10.15.1
  5. 10.15.2–12.5
  6. 13.0–26.5

From libpcap 146 in macOS 26.5. Parsed by carta from the page's man source.