Go to main content

man pages section 3: Extended Library Functions, Volume 1

Exit Print View

Updated: Wednesday, July 27, 2022
 
 

pcap_set_tstamp_precision (3pcap)

Name

pcap_set_tstamp_precision - set the time stamp precision returned in captures

Synopsis

#include <pcap/pcap.h>

int pcap_set_tstamp_precision(pcap_t *p, int tstamp_precision);

Description


                                              PCAP_SET_TSTAMP_PRECISION(3pcap)



NAME
       pcap_set_tstamp_precision  -  set  the time stamp precision returned in
       captures

SYNOPSIS
       #include <pcap/pcap.h>

       int pcap_set_tstamp_precision(pcap_t *p, int tstamp_precision);

DESCRIPTION
       pcap_set_tstamp_precision()  sets  the  precision  of  the  time  stamp
       desired  for packets captured on the pcap descriptor to the type speci-
       fied by tstamp_precision.  It must be called on a pcap descriptor  cre-
       ated   by  pcap_create(3PCAP)  that  has  not  yet  been  activated  by
       pcap_activate(3PCAP).   Two  time  stamp  precisions   are   supported,
       microseconds  and  nanoseconds.  One can use options PCAP_TSTAMP_PRECI-
       SION_MICRO and PCAP_TSTAMP_PRECISION_NANO to request desired precision.
       By default, time stamps are in microseconds.

RETURN VALUE
       pcap_set_tstamp_precision()  returns 0 on success if the specified time
       stamp precision is expected to be  supported  by  the  capture  device,
       PCAP_ERROR_TSTAMP_PRECISION_NOTSUP  if the capture device does not sup-
       port the requested time stamp precision, PCAP_ERROR_ACTIVATED if called
       on a capture handle that has been activated.

BACKWARD COMPATIBILITY
       This  function  became available in libpcap release 1.5.1.  In previous
       releases, time stamps from a capture  device  or  savefile  are  always
       given in seconds and microseconds.


ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:


       +---------------+------------------------+
       |ATTRIBUTE TYPE |    ATTRIBUTE VALUE     |
       +---------------+------------------------+
       |Availability   | system/library/libpcap |
       +---------------+------------------------+
       |Stability      | Uncommitted            |
       +---------------+------------------------+

SEE ALSO
       pcap(3PCAP), pcap_get_tstamp_precision(3PCAP), pcap-tstamp(7)



NOTES
       Source  code  for open source software components in Oracle Solaris can
       be found at https://www.oracle.com/downloads/opensource/solaris-source-
       code-downloads.html.

       This     software     was    built    from    source    available    at
       https://github.com/oracle/solaris-userland.   The  original   community
       source   was   downloaded  from   https://www.tcpdump.org/release/libp-
       cap-1.9.1.tar.gz.

       Further information about this software can be found on the open source
       community website at https://www.tcpdump.org/.



                                5 February 2015