From 5710d5ff340754a1f4df510dacbbe84fe1ac1446 Mon Sep 17 00:00:00 2001
From: chrysn <chrysn@fsfe.org>
Date: Sun, 12 Sep 2021 19:41:07 +0200
Subject: [PATCH] net/ieee802154_security doc: Shape security expectations

---
 sys/include/net/ieee802154_security.h | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/sys/include/net/ieee802154_security.h b/sys/include/net/ieee802154_security.h
index 04cef87df0..7ccae6a971 100644
--- a/sys/include/net/ieee802154_security.h
+++ b/sys/include/net/ieee802154_security.h
@@ -10,6 +10,12 @@
  * @defgroup    net_ieee802154_security  IEEE 802.15.4 security
  * @ingroup     net
  * @brief       IEEE 802.15.4 security header
+ *
+ * @warning
+ * This module is exposing raw 802.15.4 encryption without an underlying key
+ * management framework. This is intended for experimentation with the security
+ * modes of 802.15.4, and not for use cases where its security is depended on.
+ *
  * @{
  *
  * @file