Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

doc: posix: update for POSIX_FILE_SYSTEM_R #81475

Open
wants to merge 2 commits into
base: main
Choose a base branch
from

Conversation

ycsin
Copy link
Member

@ycsin ycsin commented Nov 16, 2024

Update the notes for POSIX_FILE_SYSTEM_R, looks like I missed the v4 release

@zephyrbot zephyrbot added Release Notes To be mentioned in the release notes area: POSIX POSIX API Library labels Nov 16, 2024
Add section for POSIX_FILE_SYSTEM_R which contains only `readdir_r()`.

Signed-off-by: Yong Cong Sin <[email protected]>
Mention the `_POSIX_THREAD_SAFE_FUNCTIONS` functions implemented in
zephyrproject-rtos#74394.

Signed-off-by: Yong Cong Sin <[email protected]>
@kartben
Copy link
Collaborator

kartben commented Nov 16, 2024

Ya unfortunately it's too late. You may maybe submit a PR against the branch but I never remember if it's something we do or if submissions have to be handled as backports

@@ -1381,6 +1382,7 @@ Libraries / Subsystems
* :ref:`_POSIX_THREAD_SAFE_FUNCTIONS <posix_option_thread_safe_functions>` improvements:

* Support for :c:func:`asctime_r`, :c:func:`ctime_r`, and :c:func:`localtime_r`.
* Added stub for :c:func:`getpwnam_r`, :c:func:`getpwuid_r`, :c:func:`getgrgid_r` and :c:func:`getgrnam_r`.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think this is maybe Ok for a backport PR to v4.0.

However, looking into things a bit deeper, getpwnam_r(), getpwuid_r(), getgrgid_r(), and getgrnam_r() belong to a separate Option Group -
POSIX_SYSTEM_DATABASE_R. And the non-reentrant versions of these belong to the POSIX_SYSTEM_DATABASE Option Group, and _POSIX_THREAD_SAFE_FUNCTIONS is more of an Option / Feature Test Macro.

So really what we need here is a new Kconfig.system_database file with two new Kconfig options (same as the option group names).

_POSIX_THREAD_SAFE_FUNCTIONS should probably be a hidden Kconfig option that depends on other Kconfig values being enabled. Namely, CONFIG_POSIX_SYSTEM_DATABASE_R, CONFIG_POSIX_C_LANG_SUPPORT_R, CONFIG_POSIX_FILE_LOCKING, CONFIG_POSIX_FILE_SYSTEM_R.

And then of course modify the docs

https://pubs.opengroup.org/onlinepubs/9799919799/xrat/V4_subprofiles.html

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

All of the above should be in a separate PR.

@dkalowsk dkalowsk added the backport v4.0-branch Backport to the v4.0-branch label Nov 16, 2024
@dkalowsk dkalowsk added this to the v4.1.0 milestone Nov 16, 2024
@dkalowsk
Copy link
Contributor

Very much missed the release. Happy to add to the 4.0.1 backport list though!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
area: POSIX POSIX API Library backport v4.0-branch Backport to the v4.0-branch Release Notes To be mentioned in the release notes
Projects
None yet
Development

Successfully merging this pull request may close these issues.

6 participants