pcap_setfilter(3)

pcap_setfilter3

Set the filter

Usage

#include <pcap/pcap.h>

int pcap_setfilter(pcap_t *p, struct bpf_program *fp);

Overview

pcap_setfilter() is used to specify a filter program. fp is a pointer to a bpf_program struct, usually the result of a call to pcap_compile(3).

Return value

pcap_setfilter() returns 0 on success, PCAP_ERROR_NOT_ACTIVATED if called on a capture handle that has been created but not activated, or PCAP_ERROR on other errors. If PCAP_ERROR is returned, pcap_geterr(3) or pcap_perror(3) may be called with p as an argument to fetch or display the error text.

Releases

39 releases since FreeBSD 8.0-RELEASE; the text changed 7 times.

  1. 8.0–8.4
  2. 9.0–10.4
  3. 11.0
  4. 11.1–11.3
  5. 11.4
  6. 12.0–12.1
  7. 12.2–13.4
  8. 13.5–16.0

From base 16.0-CURRENT-20261027-61c70dc16a79 in FreeBSD 16.0-CURRENT (2026-10-27). Parsed by carta from the page's man source.