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>
This commit is contained in:
Chris Friedt 2024-05-21 22:45:15 -04:00 committed by David Leach
commit bc4374b5fe
57 changed files with 237 additions and 128 deletions

View file

@ -37,6 +37,26 @@ config POSIX_LIMITS_RTSIG_MAX
Please use CONFIG_POSIX_RTSIG_MAX instead.
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 TIMER
bool "Timer support [DEPRECATED]"
select DEPRECATED