diff options
| author | Thomas Haller <thaller@redhat.com> | 2016-09-23 16:09:06 +0200 |
|---|---|---|
| committer | Thomas Haller <thaller@redhat.com> | 2016-09-23 16:09:06 +0200 |
| commit | 93a753e31109997e4f00427db4f8a99a79a8f354 (patch) | |
| tree | 8d78241d596f5df505055623394b37e7eace20b6 | |
| parent | 0b48ad4e48c22ca4d392d5d64701df268ad5ed8e (diff) | |
| download | NetworkManager-93a753e31109997e4f00427db4f8a99a79a8f354.tar.gz | |
capabilities: add comment about capability range
| -rw-r--r-- | introspection/nm-manager.xml | 3 | ||||
| -rw-r--r-- | libnm-core/nm-dbus-interface.h | 6 |
2 files changed, 8 insertions, 1 deletions
diff --git a/introspection/nm-manager.xml b/introspection/nm-manager.xml index f3fb847831..0537e86533 100644 --- a/introspection/nm-manager.xml +++ b/introspection/nm-manager.xml @@ -385,7 +385,8 @@ The current set of capabilities. See <link linkend="NMCapability">NMCapability</link> for currently - defined capability numbers. + defined capability numbers. The array is guaranteed to + be sorted in ascending order without duplicates. --> <property name="Capabilities" type="au" access="read"/> diff --git a/libnm-core/nm-dbus-interface.h b/libnm-core/nm-dbus-interface.h index 5e63cc069d..e7fe39b55f 100644 --- a/libnm-core/nm-dbus-interface.h +++ b/libnm-core/nm-dbus-interface.h @@ -90,6 +90,12 @@ * #NMCapability names the numbers in the Capabilities property. **/ typedef enum { + /* Capabilities are positive numbers. They are part of stable API + * and a certain capability number is guaranteed not to change. + * + * The range 0x7000 - 0x7FFF of capabilities is guaranteed not to be + * used by upstream NetworkManager. It could thus be used for downstream + * extensions. */ NM_CAPABILITY_TEAM = 1, } NMCapability; |