eCosTM Reference Manual
Prev | Chapter 19. Package: C Library | Next

# Component: Date/Time

#### Macro name

CYGPKG_LIBC_TIME

#### Type

Dummy

#### Description

Options for date and time related functions from <time.h>

## Option: Working clock() function

#### Macro name

CYGSEM_LIBC_TIME_CLOCK_WORKING

#### Type

Boolean

#### Description

This option controls whether clock() will actually try and determine the process time usage. With this option disabled, clock() does not disappear, but will permanently return (clock_t)-1 as mandated by the ISO C standard.

## Option: Working time() function

#### Macro name

CYGSEM_LIBC_TIME_TIME_WORKING

#### Type

Boolean

#### Description

This option controls whether time() will actually try and determine the current calendar time. With this option disabled, time() does not disappear, but will permanently return (time_t)-1 as mandated by the ISO C standard.

## Option: Working cyg_libc_time_settime() function

#### Macro name

CYGSEM_LIBC_TIME_SETTIME_WORKING

#### Type

Boolean

#### Description

This option controls whether cyg_libc_time_settime() will actually try and set the current calendar time. With this option disabled, cyg_libc_time_settime() does not disappear, but will permanently return an error.

## Option: POSIX time functions

#### Macro name

CYGFUN_LIBC_TIME_POSIX

#### Type

Boolean

#### Description

Enabling this option allows the use of the following functions defined in POSIX 1003.1: asctime_r(), ctime_r(), gmtime_r(), and localtime_r().

## Component: Time zone offsets

#### Macro name

CYGPKG_LIBC_TIME_ZONES

#### Type

Dummy

#### Description

These options control the default STandarD (STD) and Daylight Savings Time (DST) time offsets so that dates can be set correctly for the local environment.

### Option: Default Daylight Savings Time state

#### Macro name

CYGNUM_LIBC_TIME_DST_DEFAULT_STATE

#### Type

Count

#### Description

This option controls whether the initial time environment is set up as STD, DST or unknown. Use the value 1 for DST, 0 for STD, and (-1) for unknown. This can also be set at runtime using the cyg_libc_time_setdst() function.

### Option: Default Standard Time offset

#### Macro name

CYGNUM_LIBC_TIME_STD_DEFAULT_OFFSET

#### Type

Count

#### Description

This option controls the offset from UTC in seconds when in local Standard Time. This value can be positive or negative. It can also be set at run time using the cyg_libc_time_setzoneoffsets() function.

### Option: Default Daylight Savings Time offset

#### Macro name

CYGNUM_LIBC_TIME_DST_DEFAULT_OFFSET

#### Type

Count

#### Description

This option controls the offset from UTC in seconds when in local Daylight Savings Time. This value can be positive or negative. It can also be set at run time using the cyg_libc_time_setzoneoffsets() function.

## Component: Inline functions

#### Macro name

CYGPKG_LIBC_TIME_INLINES

#### Type

Dummy

#### Description

These options control whether certain functions are available in inline form. This may lead to faster code at the expense of code space. But for some functions, or some functions with constant arguments, it may in fact lead to smaller code.

### Option: asctime()

#### Macro name

CYGIMP_LIBC_TIME_ASCTIME_INLINE

#### Type

Boolean

#### Description

Allow the asctime() function to be inlined

### Option: ctime()

#### Macro name

CYGIMP_LIBC_TIME_CTIME_INLINE

#### Type

Boolean

#### Description

Allow the ctime() function to be inlined

### Option: difftime()

#### Macro name

CYGIMP_LIBC_TIME_DIFFTIME_INLINE

#### Type

Boolean

#### Description

Allow the difftime() function to be inlined

### Option: gmtime()

#### Macro name

CYGIMP_LIBC_TIME_GMTIME_INLINE

#### Type

Boolean

#### Description

Allow the gmtime() function to be inlined

### Option: localtime()

#### Macro name

CYGIMP_LIBC_TIME_LOCALTIME_INLINE

#### Type

Boolean

#### Description

Allow the localtime() function to be inlined

### Option: mktime()

#### Macro name

CYGIMP_LIBC_TIME_MKTIME_INLINE

#### Type

Boolean

#### Description

Allow the mktime() function to be inlined

### Option: asctime_r()

#### Macro name

CYGIMP_LIBC_TIME_ASCTIME_R_INLINE

#### Type

Boolean

#### Description

Allow the asctime_r() function to be inlined

### Option: ctime_r()

#### Macro name

CYGIMP_LIBC_TIME_CTIME_R_INLINE

#### Type

Boolean

#### Description

Allow the ctime_r() function to be inlined

### Option: gmtime_r()

#### Macro name

CYGIMP_LIBC_TIME_GMTIME_R_INLINE

#### Type

Boolean

#### Description

Allow the gmtime_r() function to be inlined

### Option: localtime_r()

#### Macro name

CYGIMP_LIBC_TIME_LOCALTIME_R_INLINE

#### Type

Boolean

#### Description

Allow the localtime_r() function to be inlined

## Option: clock() tracing level

#### Macro name

CYGNUM_LIBC_TIME_CLOCK_TRACE_LEVEL

#### Type

Count

#### Description

Trace verbosity level for debugging the clock() function. Increase this value to get additional trace output when tracing is enabled.

Prev | Home | Next
Component: errno | Up | Package: Math Library