Skip to content

Commit 2d652e3

Browse files
committed
doc: migration guide: posix_time.h, posix_signal.h, posix_limits.h
Add notes in the migration guide that users should no longer include `<zephyr/posix/time.h>` or `<zephyr/posix/signal.h>`, and to include them in the standard paths, along with `<limits.h>`. Signed-off-by: Chris Friedt <cfriedt@tenstorrent.com>
1 parent a040028 commit 2d652e3

File tree

1 file changed

+10
-0
lines changed

1 file changed

+10
-0
lines changed

doc/releases/migration-guide-4.3.rst

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -41,6 +41,16 @@ Base Libraries
4141
* ``Z_MIN``, ``Z_MAX`` and ``Z_CLAMP`` macros have been renamed to
4242
:c:macro:`min` :c:macro:`max` and :c:macro:`clamp`.
4343

44+
* The header files ``<zephyr/posix/time.h>``, ``<zephyr/posix/signal.h>`` should no longer be used.
45+
Include them in the standard path as ``<time.h>``, and ``<signal.h>``, provided by the C library.
46+
Non-POSIX C library maintainers may include :zephyr_file:`include/zephyr/posix/posix_time.h`
47+
and :zephyr_file:`include/zephyr/posix/posix_signal.h` to portably provide POSIX definitions.
48+
49+
* POSIX limits are no longer defined in ``<zephyr/posix/posix_features.h>``. Similarly, include them
50+
in the standard path via ``<limits.h>``, provided by the C library. Non-POSIX C library maintainers
51+
may include :zephyr_file:`include/zephyr/posix/posix_limits.h` for Zephyr's definitions. Some
52+
runtime-invariant values may need to be queried via :c:func:`sysconf`.
53+
4454
Boards
4555
******
4656

0 commit comments

Comments
 (0)