NAME

       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

       pcap_list_tstamp_types() is used to get a list of  the  supported  time  stamp  types  of  the  interface
       associated  with  the  pcap descriptor.  pcap_list_tstamp_types() allocates an array to hold the list and
       sets *tstamp_typesp to point to the array.  See pcap-tstamp(7) for a list of all the time stamp types.

       The caller is responsible for freeing the array  with  pcap_free_tstamp_types(),  which  frees  the  list
       pointed to by tstamp_types.

RETURN VALUE

       pcap_list_tstamp_types() returns the number of time stamp types in the array on success and PCAP_ERROR on
       failure.   A  return  value  of one means that the only time stamp type supported is the one in the list,
       which is the capture device's default time stamp type.  A return value of zero means that 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(3PCAP) or pcap_perror(3PCAP) 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.

SEE ALSO

       pcap(3PCAP), pcap_tstamp_type_val_to_name(3PCAP), pcap-tstamp(7)

                                                8 September 2019                   PCAP_LIST_TSTAMP_TYPES(3PCAP)