summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorJiri Pirko <jiri@nvidia.com>2023-12-01 19:01:54 +0100
committerJakub Kicinski <kuba@kernel.org>2023-12-04 23:42:12 +0100
commit8ad55b1e73c4e77656e2bea68fa2b484f33a6425 (patch)
treea08532f2838b502fd3a38b749ea2497d9434d613
parentMerge branch 'octeontx2-multicast-mirror-offload' (diff)
downloadlinux-8ad55b1e73c4e77656e2bea68fa2b484f33a6425.tar.xz
linux-8ad55b1e73c4e77656e2bea68fa2b484f33a6425.zip
docs: netlink: add NLMSG_DONE message format for doit actions
In case NLMSG_DONE message is sent as a reply to doit action, multiple kernel implementation do not send anything else than struct nlmsghdr. Add this note to the Netlink intro documentation. Signed-off-by: Jiri Pirko <jiri@nvidia.com> Reviewed-by: Bagas Sanjaya <bagasdotme@gmail.com> Link: https://lore.kernel.org/r/20231201180154.864007-1-jiri@resnulli.us Signed-off-by: Jakub Kicinski <kuba@kernel.org>
-rw-r--r--Documentation/userspace-api/netlink/intro.rst4
1 files changed, 4 insertions, 0 deletions
diff --git a/Documentation/userspace-api/netlink/intro.rst b/Documentation/userspace-api/netlink/intro.rst
index 7b1d401210ef..aacffade8f84 100644
--- a/Documentation/userspace-api/netlink/intro.rst
+++ b/Documentation/userspace-api/netlink/intro.rst
@@ -234,6 +234,10 @@ ACK attributes may be present::
| ** optionally extended ACK |
----------------------------------------------
+Note that some implementations may issue custom ``NLMSG_DONE`` messages
+in reply to ``do`` action requests. In that case the payload is
+implementation-specific and may also be absent.
+
.. _res_fam:
Resolving the Family ID