diff options
| author | Johannes Berg <johannes.berg@intel.com> | 2015-02-27 17:32:43 +0300 |
|---|---|---|
| committer | Johannes Berg <johannes.berg@intel.com> | 2015-03-03 17:56:06 +0300 |
| commit | 5fc7432991a86678b38a2d700edbe8bcd29cc579 (patch) | |
| tree | 80b9cad91b7da13add740d1796e5aa2f355f71fa | |
| parent | d5d011b446783fa7e79f3a80465fbd41c5189f83 (diff) | |
| download | linux-5fc7432991a86678b38a2d700edbe8bcd29cc579.tar.xz | |
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>
| -rw-r--r-- | include/uapi/linux/nl80211.h | 13 |
1 files changed, 13 insertions, 0 deletions
diff --git a/include/uapi/linux/nl80211.h b/include/uapi/linux/nl80211.h index 8ee31f108407..90c5aeb3cca7 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" |