Name

utc_getusertime - Returns the time and process-specific TDF, rather than the system-specific TDF

Synopsis

#include <dce/utc.h> int utc_getusertime(
utc_t ∗utc);

Parameters

Input

None. 

Output

utcSystem time as a binary timestamp. 

Description

The utc_getusertime() routine returns the system time and inaccuracy in a binary timestamp.  The routine takes the TDF from the user’s environment, which determines the time zone rule (details are system dependent).  For example,  on OSF/1 systems, the user selects a time zone by specifying the TZ environment variable.  (The reference information for the localtime() system call, which is described in the ctime(3) reference page, provides additional information.) 

If the user environment does not specify a TDF, the system’s TDF is used.  The system’s time zone rule is applied (details of the rule are system dependent).  For example, on OSF/1 systems, the rule in /etc/zoneinfo/localtime applies. 

Return Values

 0Indicates that the routine executed successfully. 

-1Generic error that indicates the time service cannot be accessed. 

Examples

See the sample program in the utc_boundtime(3dts) reference page. 

Related Information

Functions: utc_gettime(3dts).