zephyr/lib/posix/options/Kconfig.deprecated

296 lines
6.5 KiB
Text
Raw Normal View History

# Copyright (c) 2024 Tenstorrent AI ULC
#
# SPDX-License-Identifier: Apache-2.0
# This file should be removed after Zephyr 4.0 is released
menu "Deprecated POSIX options"
config FNMATCH
bool "Support for fnmatch [DEPRECATED]"
select DEPRECATED
select POSIX_C_LIB_EXT
help
This option is deprecated.
Please use CONFIG_POSIX_C_LIB_EXT instead.
config GETENTROPY
bool "Support for getentropy [DEPRECATED]"
select DEPRECATED
select POSIX_C_LIB_EXT
help
This option is deprecated.
Please use CONFIG_POSIX_C_LIB_EXT instead.
config GETOPT
bool "Getopt library support [DEPRECATED]"
select DEPRECATED
select POSIX_C_LIB_EXT
help
This option is deprecated.
Please use CONFIG_POSIX_C_LIB_EXT instead.
posix: deprecate PTHREAD_IPC _MUTEX _COND and _KEY Zephyr's POSIX API is moving toward using the standard nomenclature from IEEE 1003.1-2017 for as much as possible. In particular, we want to have consistent naming between Zephyr's POSIX API Kconfig options and the naming for POSIX Options and Option Groups. The Kconfig option CONFIG_PTHREAD_IPC has been (ab)used for a very long time for a variety of different purposes. However, the standard Option / feature test macro for POSIX Threads is, intuitively _POSIX_THREADS. There is a corresponding sysconf() key named _SC_POSIX_THREADS. Annoyingly, the POSIX Option Group that corresponds to the Option is POSIX_THREADS_BASE, which is a minor inconsistency in the standard. The _POSIX_THREADS Option already includes mutexes, condition variables, and thread-specific storage (keys). So with this change, we also deprecate the redundant Kconfig variables that do not have a corresponding match in the standard. - CONFIG_PTHREAD_IPC - CONFIG_PTHREAD - CONFIG_PTHREAD_COND - CONFIG_PTHREAD_MUTEX - CONFIG_PTHREAD_KEY Additionally, create Kconfig variables for those configurables which we are lacking: - CONFIG_POSIX_THREADS_EXT - CONFIG_POSIX_THREAD_ATTR_STACKSIZE - CONFIG_POSIX_THREAD_ATTR_STACKADDR - CONFIG_POSIX_THREAD_PRIORITY_SCHEDULING - CONFIG_POSIX_THREAD_PRIO_INHERIT - CONFIG_POSIX_THREAD_PRIO_PROTECT - CONFIG_POSIX_THREAD_SAFE_FUNCTIONS Some Kconfig variables were renamed to more properly match the spec: - CONFIG_MAX_PTHREAD_COUNT -> CONFIG_POSIX_THREAD_THREADS_MAX - CONFIG_MAX_PTHREAD_KEY_COUNT -> CONFIG_POSIX_THREAD_KEYS_MAX Signed-off-by: Chris Friedt <cfriedt@tenstorrent.com>
2024-05-22 23:48:17 -04:00
config MAX_PTHREAD_COUNT
int "Maximum number of pthread_t [DEPRECATED]"
default POSIX_THREAD_THREADS_MAX if POSIX_THREADS
default 0
help
This option is deprecated.
Please use CONFIG_POSIX_THREAD_THREADS_MAX instead.
config MAX_PTHREAD_KEY_COUNT
int "Maximum number of pthread_key_t [DEPRECATED]"
default POSIX_THREAD_KEYS_MAX if POSIX_THREADS
default 0
help
This option is deprecated.
Please use CONFIG_POSIX_THREAD_KEYS_MAX instead.
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>
2024-05-20 12:23:58 -04:00
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 MSG_COUNT_MAX
int "Maximum number of messages in a POSIX message queue [DEPRECATED]"
default POSIX_MQ_OPEN_MAX if POSIX_MESSAGE_PASSING
default 0
help
This option is deprecated.
Please use CONFIG_POSIX_MQ_OPEN_MAX instead.
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>
2024-05-20 12:23:58 -04:00
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_CONFSTR
bool "Retrieve string system configuration [DEPRECATED]"
select DEPRECATED
select POSIX_SINGLE_PROCESS
help
This option is deprecated.
Please use CONFIG_POSIX_SINGLE_PROCESS instead.
config POSIX_ENV
bool "Support for environ, getenv(), getenv_r(), setenv(), and unsetenv() [DEPRECATED]"
select DEPRECATED
select POSIX_SINGLE_PROCESS
help
This option is deprecated.
Please use CONFIG_POSIX_SINGLE_PROCESS instead.
config POSIX_FS
bool "Support for environ, getenv(), getenv_r(), setenv(), and unsetenv() [DEPRECATED]"
select DEPRECATED
select POSIX_FILE_SYSTEM
help
This option is deprecated.
Please use CONFIG_POSIX_FILE_SYSTEM instead.
config POSIX_LIMITS_RTSIG_MAX
int "_POSIX_RTSIG_MAX value in limits.h [DEPRECATED]"
default POSIX_RTSIG_MAX if POSIX_REALTIME_SIGNALS
default 0
help
This option is deprecated.
Please use CONFIG_POSIX_RTSIG_MAX instead.
posix: deprecate POSIX_MAX_FDS and add POSIX_DEVICE_IO The POSIX_MAX_FDS option does not correspond to any standard POSIX option. It was used to define the size of the file descriptor table, which is by no means exclusively used by POSIX (also net, fs, ...). POSIX_MAX_FDS 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. Namely, POSIX_OPEN_MAX. CONFIG_POSIX_MAX_OPEN_FILES is being deprecated for the same reason. To mitigate any possible layering violations, that option is not user selectable. It tracks the newly added CONFIG_ZVFS_OPEN_MAX option, which is native to Zephyr. With this deprecation, we introduce the following Kconfig options that map directly to standard POSIX Option Groups by simply removing "CONFIG_": * CONFIG_POSIX_DEVICE_IO Similarly, with this deprecation, we introduce the following Kconfig options that map directly to standard POSIX Options by simply removing "CONFIG": * CONFIG_POSIX_OPEN_MAX In order to maintain parity with the current feature set, we introduce the following Kconfig options. * CONFIG_POSIX_DEVICE_IO_ALIAS_CLOSE * CONFIG_POSIX_DEVICE_IO_ALIAS_OPEN * CONFIG_POSIX_DEVICE_IO_ALIAS_READ * CONFIG_POSIX_DEVICE_IO_ALIAS_WRITE Gate open(), close(), read(), and write() via the CONFIG_POSIX_DEVICE_IO Kconfig option and move implementations into device_io.c, to be conformant with the spec. Lastly, stage function names for upcoming ZVFS work, to be completed as part of the LTSv3 Roadmap (e.g. zvfs_open(), ..). Signed-off-by: Chris Friedt <cfriedt@tenstorrent.com>
2024-05-21 22:45:15 -04:00
config POSIX_MAX_FDS
int "Maximum number of open file descriptors [DEPRECATED]"
default POSIX_OPEN_MAX
help
This option is deprecated.
Please use CONFIG_POSIX_OPEN_MAX instead.
See also CONFIG_ZVFS_OPEN_MAX.
config POSIX_MAX_OPEN_FILES
int "Maximum number of open file descriptors [DEPRECATED]"
default POSIX_OPEN_MAX
help
This option is deprecated.
Please use CONFIG_POSIX_OPEN_MAX instead.
See also CONFIG_ZVFS_OPEN_MAX.
config POSIX_MQUEUE
bool "Message queue support [DEPRECATED]"
select DEPRECATED
select POSIX_MESSAGE_PASSING
help
This option is deprecated.
Please use CONFIG_POSIX_MESSAGE_PASSING instead.
config POSIX_PUTMSG
bool "Support for putmsg function [DEPRECATED]"
select DEPRECATED
select XOPEN_STREAMS
help
This option is deprecated.
Please use CONFIG_XOPEN_STREAMS instead.
config POSIX_SYSCONF
bool "Support for sysconf() [DEPRECATED]"
select DEPRECATED
select POSIX_SINGLE_PROCESS
help
This option is deprecated.
Please use CONFIG_POSIX_SINGLE_PROCESS instead.
config POSIX_SYSLOG
bool "Support for syslog() [DEPRECATED]"
select DEPRECATED
select XSI_SYSTEM_LOGGING
help
This option is deprecated.
Please use CONFIG_XSI_SYSTEM_LOGGING instead.
config POSIX_UNAME
bool "Support for uname [DEPRECATED]"
select DEPRECATED
select POSIX_SINGLE_PROCESS
help
This option is deprecated.
Please use CONFIG_POSIX_SINGLE_PROCESS instead.
posix: deprecate PTHREAD_IPC _MUTEX _COND and _KEY Zephyr's POSIX API is moving toward using the standard nomenclature from IEEE 1003.1-2017 for as much as possible. In particular, we want to have consistent naming between Zephyr's POSIX API Kconfig options and the naming for POSIX Options and Option Groups. The Kconfig option CONFIG_PTHREAD_IPC has been (ab)used for a very long time for a variety of different purposes. However, the standard Option / feature test macro for POSIX Threads is, intuitively _POSIX_THREADS. There is a corresponding sysconf() key named _SC_POSIX_THREADS. Annoyingly, the POSIX Option Group that corresponds to the Option is POSIX_THREADS_BASE, which is a minor inconsistency in the standard. The _POSIX_THREADS Option already includes mutexes, condition variables, and thread-specific storage (keys). So with this change, we also deprecate the redundant Kconfig variables that do not have a corresponding match in the standard. - CONFIG_PTHREAD_IPC - CONFIG_PTHREAD - CONFIG_PTHREAD_COND - CONFIG_PTHREAD_MUTEX - CONFIG_PTHREAD_KEY Additionally, create Kconfig variables for those configurables which we are lacking: - CONFIG_POSIX_THREADS_EXT - CONFIG_POSIX_THREAD_ATTR_STACKSIZE - CONFIG_POSIX_THREAD_ATTR_STACKADDR - CONFIG_POSIX_THREAD_PRIORITY_SCHEDULING - CONFIG_POSIX_THREAD_PRIO_INHERIT - CONFIG_POSIX_THREAD_PRIO_PROTECT - CONFIG_POSIX_THREAD_SAFE_FUNCTIONS Some Kconfig variables were renamed to more properly match the spec: - CONFIG_MAX_PTHREAD_COUNT -> CONFIG_POSIX_THREAD_THREADS_MAX - CONFIG_MAX_PTHREAD_KEY_COUNT -> CONFIG_POSIX_THREAD_KEYS_MAX Signed-off-by: Chris Friedt <cfriedt@tenstorrent.com>
2024-05-22 23:48:17 -04:00
config PTHREAD
bool "pthread_t support [DEPRECATED]"
select DEPRECATED
select POSIX_THREADS
help
This option is deprecated.
Please use CONFIG_POSIX_THREADS instead.
config PTHREAD_BARRIER
bool "pthread_barrier_t support [DEPRECATED]"
select DEPRECATED
select POSIX_BARRIERS
help
This option is deprecated.
Please use CONFIG_POSIX_BARRIERS instead.
posix: deprecate PTHREAD_IPC _MUTEX _COND and _KEY Zephyr's POSIX API is moving toward using the standard nomenclature from IEEE 1003.1-2017 for as much as possible. In particular, we want to have consistent naming between Zephyr's POSIX API Kconfig options and the naming for POSIX Options and Option Groups. The Kconfig option CONFIG_PTHREAD_IPC has been (ab)used for a very long time for a variety of different purposes. However, the standard Option / feature test macro for POSIX Threads is, intuitively _POSIX_THREADS. There is a corresponding sysconf() key named _SC_POSIX_THREADS. Annoyingly, the POSIX Option Group that corresponds to the Option is POSIX_THREADS_BASE, which is a minor inconsistency in the standard. The _POSIX_THREADS Option already includes mutexes, condition variables, and thread-specific storage (keys). So with this change, we also deprecate the redundant Kconfig variables that do not have a corresponding match in the standard. - CONFIG_PTHREAD_IPC - CONFIG_PTHREAD - CONFIG_PTHREAD_COND - CONFIG_PTHREAD_MUTEX - CONFIG_PTHREAD_KEY Additionally, create Kconfig variables for those configurables which we are lacking: - CONFIG_POSIX_THREADS_EXT - CONFIG_POSIX_THREAD_ATTR_STACKSIZE - CONFIG_POSIX_THREAD_ATTR_STACKADDR - CONFIG_POSIX_THREAD_PRIORITY_SCHEDULING - CONFIG_POSIX_THREAD_PRIO_INHERIT - CONFIG_POSIX_THREAD_PRIO_PROTECT - CONFIG_POSIX_THREAD_SAFE_FUNCTIONS Some Kconfig variables were renamed to more properly match the spec: - CONFIG_MAX_PTHREAD_COUNT -> CONFIG_POSIX_THREAD_THREADS_MAX - CONFIG_MAX_PTHREAD_KEY_COUNT -> CONFIG_POSIX_THREAD_KEYS_MAX Signed-off-by: Chris Friedt <cfriedt@tenstorrent.com>
2024-05-22 23:48:17 -04:00
config PTHREAD_COND
bool "pthread_cond_t support [DEPRECATED]"
select DEPRECATED
select POSIX_THREADS
help
This option is deprecated.
Please use CONFIG_POSIX_THREADS instead.
config PTHREAD_IPC
bool "POSIX pthread IPC API [DEPRECATED]"
select DEPRECATED
select POSIX_THREADS
help
This option is deprecated.
Please use CONFIG_POSIX_THREADS instead.
config PTHREAD_KEY
bool "pthread_key_t support [DEPRECATED]"
select DEPRECATED
select POSIX_THREADS
help
This option is deprecated.
Please use CONFIG_POSIX_THREADS instead.
config PTHREAD_MUTEX
bool "pthread_mutex_t support [DEPRECATED]"
select DEPRECATED
select POSIX_THREADS
help
This option is deprecated.
Please use CONFIG_POSIX_THREADS instead.
config PTHREAD_RWLOCK
bool "pthread_spinlock_t support [DEPRECATED]"
select DEPRECATED
select POSIX_READER_WRITER_LOCKS
help
This option is deprecated.
Please use CONFIG_POSIX_READER_WRITER_LOCKS instead.
config PTHREAD_SPINLOCK
bool "pthread_spinlock_t support [DEPRECATED]"
select DEPRECATED
select POSIX_SPIN_LOCKS
help
This option is deprecated.
Please use CONFIG_POSIX_SPIN_LOCKS instead.
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>
2024-05-20 12:23:58 -04:00
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.
config SEM_NAMELEN_MAX
int "Maximum name length [DEPRECATED]"
default POSIX_SEM_NAMELEN_MAX if POSIX_SEMAPHORES
default 0
help
This option is deprecated.
Please use CONFIG_POSIX_SEM_NAMELEN_MAX instead.
config SEM_VALUE_MAX
int "Maximum semaphore limit [DEPRECATED]"
default POSIX_SEM_VALUE_MAX if POSIX_SEMAPHORES
default 0
help
This option is deprecated.
Please use CONFIG_POSIX_SEM_VALUE_MAX instead.
endmenu