TSS.c File Reference

Implements routines that manipulate a timespec structure. More...

#include <stdlib.h>
#include <time.h>
#include <IPBS/TSS.h>
#include <IPBS/WCT.h>
#include <WCT_pvtdefs.ih>

Defines
#define	get_time()   WCT__utb_get()
	Gets the time in the local representation.
#define	NSECS_IN_A_SECOND   1000000000ll
	Convenience symbol for a billion.
Functions
struct timespec	TSS_nsecxTOtodAdd (long long int delta)
	Computes the time specification by adding a number of nanoseconds to the current time.
struct timespec	TSS_nsecsTOtodAdd (unsigned int delta)
	Computes the time specification by adding a number of nanoseconds to the current time.
struct timespec	TSS_usecsTOtodAdd (unsigned int delta)
	Computes the time specification by adding a number of microseconds to the current time.
struct timespec	TSS_secsTOtodAdd (unsigned int delta)
	Computes the time specification by adding a number of seconds to the current time.
struct timespec	TSS_from_wct (WCT_time wct)
	Converts a Wall Clock Time to a struct timespec.

---

Detailed Description

Implements routines that manipulate a timespec structure.

Author:

JJRussell - russell@slac.stanford.edu

   CVS $Id: TSS.c,v 1.2 2011/03/25 21:14:42 saxton Exp $

A timespec structure is a standard structure found in the "C"/Unix world. It represents time as two fields in a structure, a seconds field and a microseconds field. Performing simple operations, such as addition and subtraction, is not completely trivial, so this file provides a set of standard manipulation routines.

---

Function Documentation

struct timespec TSS_from_wct

(

WCT_time

wct

)

[read]

Converts a Wall Clock Time to a struct timespec.

Parameters:

wct

The Wall Clock Time to convert

Returns:

The TimeOut Value

References NSECS_IN_A_SECOND.

Referenced by TOV_from_wct().

struct timespec TSS_nsecsTOtodAdd

(

unsigned int

delta

)

[read]

Computes the time specification by adding a number of nanoseconds to the current time.

Parameters:

delta

The number of microeconds to add to the current time.

Return values:

The

new time returned as a timespec structure.

References get_time, and NSECS_IN_A_SECOND.

Referenced by TOV_from_nsecs().

struct timespec TSS_nsecxTOtodAdd

(

long long int

delta

)

[read]

Computes the time specification by adding a number of nanoseconds to the current time.

Parameters:

delta

The number of microeconds to add to the current time.

Return values:

The

new time returned as a timespec structure.

References get_time, and NSECS_IN_A_SECOND.

Referenced by TOV_from_nsecx().

struct timespec TSS_secsTOtodAdd

(

unsigned int

delta

)

[read]

Computes the time specification by adding a number of seconds to the current time.

Parameters:

delta

The number of seconds to add to the current time.

Return values:

The

new time returned as a timespec structure.

References get_time, and NSECS_IN_A_SECOND.

Referenced by TOV_from_secs().

struct timespec TSS_usecsTOtodAdd

(

unsigned int

delta

)

[read]

Computes the time specification by adding a number of microseconds to the current time.

Parameters:

delta

The number of microeconds to add to the current time.

Return values:

The

new time returned as a timespec structure.

References get_time, and NSECS_IN_A_SECOND.

Referenced by TOV_from_usecs().