Skip to content

Commit cbb56fd

Browse files
jukkarnashif
authored andcommitted
doc: migration-guide-4.4: Add network API changes
Add information about the network API changes in 4.4 release. Signed-off-by: Jukka Rissanen <jukka.rissanen@nordicsemi.no>
1 parent 6a67a55 commit cbb56fd

File tree

1 file changed

+16
-0
lines changed

1 file changed

+16
-0
lines changed

doc/releases/migration-guide-4.4.rst

Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -55,6 +55,22 @@ Bluetooth Host
5555
Networking
5656
**********
5757

58+
* Networking APIs found in
59+
60+
* :zephyr_file:`include/zephyr/net/net_ip.h`
61+
* :zephyr_file:`include/zephyr/net/socket.h`
62+
63+
and relevant code in ``subsys/net`` etc. is namespaced. This means that either
64+
``net_``, ``NET_`` or ``ZSOCK_`` prefix is added to the network API name. This is done in order
65+
to avoid circular dependency with POSIX or libc that might define the same symbol.
66+
A compatibility header file :zephyr_file:`include/zephyr/net/net_compat.h`
67+
is created that provides the old symbols allowing the user to continue use the old symbols.
68+
External network applications can continue to use POSIX defined network symbols and
69+
include relevant POSIX header files like ``sys/socket.h`` to get the POSIX symbols as Zephyr
70+
networking header files will no longer include those. If the application or Zephyr internal
71+
code cannot use POSIX APIs, then the relevant network API prefix needs to be added to the
72+
code calling a network API.
73+
5874
Other subsystems
5975
****************
6076

0 commit comments

Comments
 (0)