Skip to content

Commit 6b0597f

Browse files
jukkarkartben
authored andcommitted
doc: migration: 4.2: Add information about net_mgmt API changes
Add information how the net_mgmt request handler is changed. The event number type is changed from uint32_t to uint64_t to allow the event command to be a bit mask instead of enum value. Signed-off-by: Jukka Rissanen <jukka.rissanen@nordicsemi.no>
1 parent 2ed2232 commit 6b0597f

File tree

2 files changed

+22
-0
lines changed

2 files changed

+22
-0
lines changed

doc/releases/migration-guide-4.2.rst

Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -482,6 +482,21 @@ Networking
482482
need to update their response callback implementations. To retain current
483483
behavior, simply return 0 from the callback.
484484

485+
* The API signature of ``net_mgmt`` event handler :c:type:`net_mgmt_event_handler_t` and
486+
request handler :c:type:`net_mgmt_request_handler_t` has changed. The management event
487+
type is changed from ``uint32_t`` to ``uint64_t``. The change allows event number values
488+
to be bit masks instead of enum values. The layer code still stays as a enum value.
489+
The :c:macro:`NET_MGMT_LAYER_CODE` and :c:macro:`NET_MGMT_GET_COMMAND` can be used to get
490+
the layer code and management event command from the actual event value in the request or
491+
event handlers if needed.
492+
493+
* The socket options for ``net_mgmt`` type sockets cannot directly be network management
494+
event types as those are now ``uint64_t`` and the socket option expects a normal 32 bit
495+
integer value. Because of this, a new ``SO_NET_MGMT_ETHERNET_SET_QAV_PARAM``
496+
and ``SO_NET_MGMT_ETHERNET_GET_QAV_PARAM`` socket options are created that will replace
497+
the previously used ``NET_REQUEST_ETHERNET_GET_QAV_PARAM`` and
498+
``NET_REQUEST_ETHERNET_GET_QAV_PARAM`` options.
499+
485500
OpenThread
486501
==========
487502

doc/releases/release-notes-4.2.rst

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -111,6 +111,13 @@ Deprecated APIs and options
111111
was deprecated since Zephyr 4.0, and users were advised to migrate to alternative
112112
crypto backends.
113113

114+
Stable API changes in this release
115+
==================================
116+
117+
* The API signature of ``net_mgmt`` event handler :c:type:`net_mgmt_event_handler_t`
118+
and request handler :c:type:`net_mgmt_request_handler_t` has changed. The event value
119+
type is changed from ``uint32_t`` to ``uint64_t``.
120+
114121
New APIs and options
115122
====================
116123

0 commit comments

Comments
 (0)