PCAP\_SET\_TSTAMP\_TYPE(3PCAP) PCAP\_SET\_TSTAMP\_TYPE(3PCAP)

# [NAME](#NAME)

pcap\_set\_tstamp\_type - set the time stamp type to be used by a capture device

# [SYNOPSIS](#SYNOPSIS)

```
#include <pcap/pcap.h>
```

```
int pcap_set_tstamp_type(pcap_t *p, int tstamp_type);
```

# [DESCRIPTION](#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*. It must be called on a pcap descriptor created by [**pcap\_create**(3PCAP)](/man/os/libpcap/pcap_create.3PCAP) that has not yet been activated by [**pcap\_activate**(3PCAP)](/man/os/libpcap/pcap_activate.3PCAP). [**pcap\_list\_tstamp\_types**(3PCAP)](/man/os/libpcap/pcap_list_tstamp_types.3PCAP) will give a list of the time stamp types supported by a given capture device. See [**pcap-tstamp**(7)](/man/os/libpcap/pcap-tstamp.7) for a list of all the time stamp types.

# [RETURN VALUE](#RETURN_VALUE)

**pcap\_set\_tstamp\_type**() returns **0** on success if the specified time stamp type is expected to be supported by the capture device, **PCAP\_WARNING\_TSTAMP\_TYPE\_NOTSUP** if the specified time stamp type is not supported by the capture device, **PCAP\_ERROR\_ACTIVATED** if called on a capture handle that has been activated, and **PCAP\_ERROR\_CANTSET\_TSTAMP\_TYPE** if the capture device doesn't support setting the time stamp type (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](#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.

# [SEE ALSO](#SEE_ALSO)

[**pcap**(3PCAP)](/man/os/libpcap/pcap.3PCAP), [**pcap\_list\_tstamp\_types**(3PCAP)](/man/os/libpcap/pcap_list_tstamp_types.3PCAP), [**pcap\_set\_tstamp\_precision**(3PCAP)](/man/os/libpcap/pcap_set_tstamp_precision.3PCAP), [**pcap\_tstamp\_type\_name\_to\_val**(3PCAP)](/man/os/libpcap/pcap_tstamp_type_name_to_val.3PCAP)

8 September 2019

---

Document: pcap_set_tstamp_type(3pcap) from libpcap 1.11.0-r0 (Chainguard OS)
Source: https://github.com/the-tcpdump-group/libpcap.git
