PCAP_SET_TSTAMP_TYPE(3)

📦 version 15.1, in freebsd 14.5, freebsd 15.1

🌸 NAME 🌸

pcap_set_tstamp_type — set the time stamp type to be used by a capture device 💅

okay so real talk, this page is PCAP_SET_TSTAMP_TYPE(3) from the Library Functions Manual, and it's lowkey iconic for anyone messing with packet time stamps.

✨ SYNOPSIS ✨

#include <pcap/pcap.h>

int pcap_set_tstamp_type(pcap_t *p, int tstamp_type);

💖 DESCRIPTION 💖

pcap_set_tstamp_type() sets the type of time stamp desired for packets captured on the pcap descriptor to the type specified by tstamp_type. Basically: you're telling the capture device what flavor of time stamp you want, bestie. 🕰️✨

It must be called on a pcap descriptor created by pcap_create(3) that has not yet been activated by pcap_activate(3). The timing is giving main character energy — you gotta do it before activation, no cap. ⏰

pcap_list_tstamp_types(3) will give you a list of the time stamp types supported by a given capture device. And if you want the full menu of all the time stamp types, see pcap-tstamp(7). iykyk 💫

🔥 RETURN VALUE 🔥

  • 0 — success, if the specified time stamp type is expected to be supported by the capture device. slay ✨
  • PCAP_WARNING_TSTAMP_TYPE_NOTSUP — the specified time stamp type is not supported by the capture device. not every device is gonna eat every tstamp type 💀
  • PCAP_ERROR_ACTIVATED — you called it on a capture handle that has been activated. bestie, you missed the window 😭
  • PCAP_ERROR_CANTSET_TSTAMP_TYPE — the capture device doesn't support setting the time stamp type. note: only older versions of libpcap will return that; newer versions will always allow the time stamp type to be set to the default type. 🫶

🦋 BACKWARD COMPATIBILITY 🦋

This function became available in libpcap release 1.2.1. In previous releases, the time stamp type cannot be set; only the default time stamp type offered by a capture source is available. so yeah, ancient libpcap era vibes 🧚💜

🌈 SEE ALSO 🌈

that's the whole page, bestie 💖 — the footer is dated 8 September 2019 and tagged PCAP_SET_TSTAMP_TYPE(3). mwah, go set those time stamps ✨🎀

📦 where this page comes from