Merge pull request #20546 from chrysn-pull-requests/doc-shell-no-secu…

…rity sys/shell/doc: Shell access is root access
RIOT-OS · Apr 6, 2024 · 8bb8c5b · 8bb8c5b
2 parents ad0d0b7 + df62568
commit 8bb8c5b
Showing 1 changed file with 8 additions and 0 deletions.
diff --git a/sys/include/shell.h b/sys/include/shell.h
@@ -11,6 +11,14 @@
  * @ingroup     sys
  * @brief       Simple shell interpreter
  *
+ * ## Security expectations
+ *
+ * Access to the shell grants access to the system that may exercise any power
+ * the firmware can exercise. While some commands only provide limited access
+ * to the system, and it is best practice for commands to validate their input,
+ * there is no expectation of security of the system when an attacker gains
+ * access to the shell.
+ *
  * @{
  *
  * @file