posix: timers: deprecate CONFIG_POSIX_CLOCK and TIMER

The POSIX_CLOCK option does not correspond to any standard
option. It was used to active features of several distinct
POSIX Options and Option Groups, which complicated API and
application configuration as a result.

POSIX_CLOCK is being deprecated in order to ensure that Zephyr's
POSIX Kconfig variables correspond to those defined in the
specification, as of IEEE 1003.1-2017.

Additionally, CONFIG_TIMER is being deprecated because it does
not match the corresponding POSIX Option (_POSIX_TIMERS).

With this deprecation, we introduce the following Kconfig
options that map directly to standard POSIX Option Groups by
simply removing "CONFIG_":

* CONFIG_POSIX_TIMERS

Similarly, we introduce the following Kconfig options that
map directly to standard POSIX Options by simply removing
"CONFIG":

* CONFIG_POSIX_CLOCK_SELECTION
* CONFIG_POSIX_CPUTIME
* CONFIG_POSIX_DELAYTIMER_MAX
* CONFIG_POSIX_MONOTONIC_CLOCK
* CONFIG_POSIX_TIMEOUTS
* CONFIG_POSIX_TIMER_MAX

In order to maintain parity with the current feature set, we
introduce the following Kconfig options that map directly to
standard POSIX Option Groups by simply removing "CONFIG_":

* CONFIG_POSIX_MULTI_PROCESS - sleep()

Similarly, in order to maintain parity with the current feature
set, we introduce the following additional Kconfig options that
map directly to standard POSIX Options by simply removing
"CONFIG":

* CONFIG_XSI_SINGLE_PROCESS - gettimeofday()

Signed-off-by: Chris Friedt <cfriedt@tenstorrent.com>
This commit is contained in:
Chris Friedt 2024-05-20 12:23:58 -04:00 committed by David Leach
commit 4a5c4e5f73
36 changed files with 343 additions and 178 deletions

View file

@ -6,6 +6,28 @@
menu "Deprecated POSIX options"
config MAX_TIMER_COUNT
int "Maximum number of timer_t [DEPRECATED]"
default POSIX_TIMER_MAX if POSIX_TIMERS
default 0
help
This option is deprecated.
Please use CONFIG_POSIX_TIMER_MAX instead.
config POSIX_CLOCK
bool "clock and sleep APIs [DEPRECATED]"
select DEPRECATED
select POSIX_CLOCK_SELECTION
select POSIX_CPUTIME
select POSIX_MONOTONIC_CLOCK
select POSIX_TIMERS
select POSIX_TIMEOUTS
help
This option is deprecated.
Please use CONFIG_POSIX_TIMERS instead.
config POSIX_LIMITS_RTSIG_MAX
int "_POSIX_RTSIG_MAX value in limits.h [DEPRECATED]"
default POSIX_RTSIG_MAX if POSIX_REALTIME_SIGNALS
@ -15,4 +37,22 @@ config POSIX_LIMITS_RTSIG_MAX
Please use CONFIG_POSIX_RTSIG_MAX instead.
config TIMER
bool "Timer support [DEPRECATED]"
select DEPRECATED
select POSIX_TIMERS
help
This option is deprecated.
Please use CONFIG_POSIX_TIMERS instead.
config TIMER_DELAYTIMER_MAX
int "Maximum count returned my timer_getoverrun() in POSIX application [DEPRECATED]"
default POSIX_DELAYTIMER_MAX if POSIX_TIMERS
default 0
help
This option is deprecated.
Please use CONFIG_POSIX_DELAYTIMER_MAX instead.
endmenu