PCAP_LIST_TSTAMP_TYPES(3)

💖 NAME 💖

okay bestie, welcome to PCAP_LIST_TSTAMP_TYPES(3) from the Library Functions Manual — manual name folded right in, we're being cute but keeping every fact 💅

pcap_list_tstamp_types, pcap_free_tstamp_types — get a list of time stamp types supported by a capture device, and free that list.

---

🎀 SYNOPSIS 🎀

#include <pcap/pcap.h>

int pcap_list_tstamp_types(pcap_t *p, int **tstamp_typesp);
void pcap_free_tstamp_types(int *tstamp_types);

---

✨ DESCRIPTION ✨

okay so pcap_list_tstamp_types() is literally your little detective for the interface associated with the pcap descriptor 🕵️‍♀️ it gets you a list of the supported time stamp types.

It allocates an array to hold the list and sets *tstamp_typesp to point to that array. If you want the whole menu of time stamp types, peek at pcap-tstamp(7) 👀

• pcap_list_tstamp_types() — asks the interface attached to the pcap descriptor what time stamp types it supports, allocates the array for the list, and sets *tstamp_typesp to point at it 💖
• pcap_free_tstamp_types() — the cleanup queen 🧹 the caller is responsible for freeing the array with this function, and it frees the list pointed to by tstamp_types.

bestie, do not ghost the free step — the caller is responsible for freeing that array with pcap_free_tstamp_types() 🫶

---

🌸 RETURN VALUE 🌸

• success — pcap_list_tstamp_types() returns the number of time stamp types in the array 🔥
• failure — it returns PCAP_ERROR 😭
• return value of one — means the only time stamp type supported is the one in the list, which is the capture device's default time stamp type 👑
• return value of zero — means the only time stamp type supported is PCAP_TSTAMP_HOST, which is the capture device's default time stamp type. only older versions of libpcap will return that; newer versions will always return one or more types 💀
• 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 🫶

---

🌈 BACKWARD COMPATIBILITY 🌈

these functions 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. periodt.

---

🦋 SEE ALSO 🦋

• pcap(3)
• pcap_tstamp_type_val_to_name(3)
• pcap-tstamp(7)

---

mwah 💋 — this cutie is signed by the Library Functions Manual, dated 8 September 2019, page PCAP_LIST_TSTAMP_TYPES(3) 🎀