summaryrefslogtreecommitdiff
path: root/libnm
diff options
context:
space:
mode:
authorThomas Haller <thaller@redhat.com>2016-03-23 17:36:28 +0100
committerThomas Haller <thaller@redhat.com>2016-03-29 11:56:27 +0200
commit52bd08de051e811c8b0aea354ae448e4647dfd0d (patch)
tree8fb9cf56ddf9bcb82aaeca8a580758e7d1237bcb /libnm
parent7991298c51fba372b6f45d6ec58bef584942c99b (diff)
downloadNetworkManager-52bd08de051e811c8b0aea354ae448e4647dfd0d.tar.gz
libnm: add code comments to hint that NMConnection might not validate
Diffstat (limited to 'libnm')
-rw-r--r--libnm/nm-client.c12
-rw-r--r--libnm/nm-device.c6
2 files changed, 18 insertions, 0 deletions
diff --git a/libnm/nm-client.c b/libnm/nm-client.c
index 57a43ca8dc..a7ecdb5572 100644
--- a/libnm/nm-client.c
+++ b/libnm/nm-client.c
@@ -1189,6 +1189,9 @@ nm_client_deactivate_connection_finish (NMClient *client,
* Returns: (transfer none) (element-type NMRemoteConnection): an array
* containing all connections provided by the remote settings service. The
* returned array is owned by the #NMClient object and should not be modified.
+ *
+ * The connections are as received from D-Bus and might not validate according
+ * to nm_connection_verify().
**/
const GPtrArray *
nm_client_get_connections (NMClient *client)
@@ -1207,6 +1210,9 @@ nm_client_get_connections (NMClient *client)
*
* Returns: (transfer none): the remote connection object on success, or %NULL if no
* matching object was found.
+ *
+ * The connection is as received from D-Bus and might not validate according
+ * to nm_connection_verify().
**/
NMRemoteConnection *
nm_client_get_connection_by_id (NMClient *client, const char *id)
@@ -1226,6 +1232,9 @@ nm_client_get_connection_by_id (NMClient *client, const char *id)
*
* Returns: (transfer none): the remote connection object on success, or %NULL if the object was
* not known
+ *
+ * The connection is as received from D-Bus and might not validate according
+ * to nm_connection_verify().
**/
NMRemoteConnection *
nm_client_get_connection_by_path (NMClient *client, const char *path)
@@ -1245,6 +1254,9 @@ nm_client_get_connection_by_path (NMClient *client, const char *path)
*
* Returns: (transfer none): the remote connection object on success, or %NULL if the object was
* not known
+ *
+ * The connection is as received from D-Bus and might not validate according
+ * to nm_connection_verify().
**/
NMRemoteConnection *
nm_client_get_connection_by_uuid (NMClient *client, const char *uuid)
diff --git a/libnm/nm-device.c b/libnm/nm-device.c
index 5679fd5f3d..496dd87a06 100644
--- a/libnm/nm-device.c
+++ b/libnm/nm-device.c
@@ -2329,6 +2329,9 @@ nm_device_reapply_finish (NMDevice *device,
* Returns: (transfer full): a %NMConnection with the currently applied settings
* or %NULL on error.
*
+ * The connection is as received from D-Bus and might not validate according
+ * to nm_connection_verify().
+ *
* Since: 1.2
**/
NMConnection *
@@ -2457,6 +2460,9 @@ nm_device_get_applied_connection_async (NMDevice *device,
* Returns: (transfer full): a currently applied %NMConnection or %NULL in case
* of error.
*
+ * The connection is as received from D-Bus and might not validate according
+ * to nm_connection_verify().
+ *
* Since: 1.2
**/
NMConnection *