summaryrefslogtreecommitdiffstats
path: root/include/uapi/linux/nl80211.h
diff options
context:
space:
mode:
authorJohannes Berg <johannes.berg@intel.com>2015-02-27 15:32:43 +0100
committerJohannes Berg <johannes.berg@intel.com>2015-03-03 15:56:06 +0100
commit5fc7432991a86678b38a2d700edbe8bcd29cc579 (patch)
tree80b9cad91b7da13add740d1796e5aa2f355f71fa /include/uapi/linux/nl80211.h
parentd5d011b446783fa7e79f3a80465fbd41c5189f83 (diff)
downloadop-kernel-dev-5fc7432991a86678b38a2d700edbe8bcd29cc579.zip
op-kernel-dev-5fc7432991a86678b38a2d700edbe8bcd29cc579.tar.gz
nl80211: add notes about userspace API/ABI modifications
Add notes about userspace ABI/API modifications, including the fact that we decided that API submissions should come with a driver implementation. Signed-off-by: Johannes Berg <johannes.berg@intel.com>
Diffstat (limited to 'include/uapi/linux/nl80211.h')
-rw-r--r--include/uapi/linux/nl80211.h13
1 files changed, 13 insertions, 0 deletions
diff --git a/include/uapi/linux/nl80211.h b/include/uapi/linux/nl80211.h
index 8ee31f1..90c5aeb 100644
--- a/include/uapi/linux/nl80211.h
+++ b/include/uapi/linux/nl80211.h
@@ -25,6 +25,19 @@
*
*/
+/*
+ * This header file defines the userspace API to the wireless stack. Please
+ * be careful not to break things - i.e. don't move anything around or so
+ * unless you can demonstrate that it breaks neither API nor ABI.
+ *
+ * Additions to the API should be accompanied by actual implementations in
+ * an upstream driver, so that example implementations exist in case there
+ * are ever concerns about the precise semantics of the API or changes are
+ * needed, and to ensure that code for dead (no longer implemented) API
+ * can actually be identified and removed.
+ * Nonetheless, semantics should also be documented carefully in this file.
+ */
+
#include <linux/types.h>
#define NL80211_GENL_NAME "nl80211"
OpenPOWER on IntegriCloud