utc_getusertime(3dts)

Synopsis

#include <dce/utc.h>

int utc_getusertime(
utc_t *utc);

Parameters

Input

None.

Output

utc
System 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
~0 Indicates that the routine executed successfully.

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

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

Related Information
Function: utc_gettime(3dts)