Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
xt_tic(3)		   Library Functions Manual		     xt_tic(3)

NAME
       xt_tic()	- Record current high-resolution clock time

LIBRARY
       #include	<xtend/time.h>
       -lxtend

SYNOPSIS
       int     xt_tic(struct timeval *start_time, struct rusage	*start_usage)

ARGUMENTS
       start_time  A struct timeval structure populated	by xt_tic()

DESCRIPTION
       xt_tic()	records	the current time in a struct timeval structure.	 It is
       a  simple  wrapper around gettimeofday(2) meant for use with xt_toc(3),
       which reports elapsed time since	the xt_tic() call.

       The xt_tic() and	xt_toc() functions are used  to	 accurately  determine
       the elapsed time	of a segment of	code, such as a	loop that is suspected
       to  be  costly.	 xt_tic() is inserted into the program just before the
       code and	xt_toc() immediately after.

RETURN VALUES
       The exit	status of gettimeofday(2)

EXAMPLES
       struct timeval  start_time;
       struct rusage   start_usage;

       xt_tic(&start_time, &start_usage);
       // Code for which elapsed time is to be measured
       for (c =	0; c < bignum; ++c)
       {
	   ...
       }
       xt_toc(stderr, "Elapsed time for	loop:n", &start_time, &start_usage);

SEE ALSO
       xt_toc(3), xt_difftimeofday(3), gettimeofday(2)

								     xt_tic(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=xt_tic&sektion=3&manpath=FreeBSD+Ports+14.3.quarterly>

home | help