@@ -273,11 +280,25 @@ Describes errors that may result from operations involving a NMSetting object + +

NM_CONNECTION_NORMALIZE_PARAM_IP6_CONFIG_METHOD

#define NM_CONNECTION_NORMALIZE_PARAM_IP6_CONFIG_METHOD "ip6-config-method"
+

NM_CONNECTION_ERROR

#define NM_CONNECTION_ERROR nm_connection_error_quark ()

@@ -727,7 +748,7 @@ Validates the connection and all its settings. Each setting's properties have allowed values, and some values are dependent on other values. For example, if a Wi-Fi connection is security enabled, the NMSettingWireless setting object's 'security' property must contain the setting name of the -NMSettingWirelessSecurity object, which must also be present in the +NMSettingWirelessSecurity object, which must also be present in the connection for the connection to be valid. As another example, the NMSettingWired object's 'mac-address' property must be a validly formatted MAC address. The returned GError contains information about which @@ -758,6 +779,62 @@ setting and which property failed validation, and how it failed validation.

nm_connection_normalize ()

gboolean            nm_connection_normalize             (NMConnection *connection,
+                                                         GHashTable *parameters,
+                                                         gboolean *modified,
+                                                         GError **error);

+Does some basic normalization and fixup of well known inconsistencies +and deprecated fields. If the connection was modified in any way, +the output parameter modified is set TRUE. +

+Finally the connection will be verified and TRUE returns if the connection +is valid. As this function only performs some specific normalization steps +it cannot repair all connections. If the connection has errors that +cannot be normalized, the connection will not be modified. +

++++ + + + + + + + + + + + + + + + + + + + + + + +

`connection` :	the NMConnection to normalize
`parameters` :	a GHashTable with +normalization parameters to allow customization of the normalization by providing +specific arguments. Unknown arguments will be ignored and the default will be +used. The keys must be strings, hashed by `g_str_hash()` and `g_str_equal()` functions. +The values are opaque and depend on the parameter name. [allow-none][element-type utf8 gpointer] +
`modified` :	outputs whether any settings were modified. [out][allow-none] +
`error` :	location to store error, or `NULL`. Contains the reason, +why the connection is invalid, if the function returns an error.
Returns :	+`TRUE` if the connection is valid, `FALSE` if it is not

Since 1.0

nm_connection_need_secrets ()

const char *        nm_connection_need_secrets          (NMConnection *connection,
                                                          GPtrArray **hints);

@@ -988,6 +1065,39 @@ connection types, this function will return +

nm_connection_get_interface_name ()

const char *        nm_connection_get_interface_name    (NMConnection *connection);

+Returns the interface name as stored in NMSettingConnection:interface_name. +If the connection contains no NMSettingConnection, it will return NULL. +

+For hardware devices and software devices created outside of NetworkManager, +this name is used to match the device. for software devices created by +NetworkManager, this is the name of the created interface. +

++++ + + + + + + + + + + +

`connection` :	The NMConnection +
Returns :	Name of the kernel interface or `NULL` +

Since 1.0

nm_connection_is_type ()

gboolean            nm_connection_is_type               (NMConnection *connection,
                                                          const char *type);

@@ -1247,7 +1357,7 @@ A shortcut to return the type from the connection's char * nm_connection_get_virtual_device_description (NMConnection *connection);

-Returns the name that nm_device_disambiguate_names() would +Returns the name that nm_device_disambiguate_names() would return for the virtual device that would be created for connection. Eg, "VLAN (eth1.1)".

diff --git a/docs/libnm-util/html/NMSetting.html b/docs/libnm-util/html/NMSetting.html index d6e1af38..259433e6 100644 --- a/docs/libnm-util/html/NMSetting.html +++ b/docs/libnm-util/html/NMSetting.html @@ -352,7 +352,9 @@ secret is not required NM_SETTING_COMPARE_FLAG_IGNORE_ID = 0x00000002, NM_SETTING_COMPARE_FLAG_IGNORE_SECRETS = 0x00000004, NM_SETTING_COMPARE_FLAG_IGNORE_AGENT_OWNED_SECRETS = 0x00000008, - NM_SETTING_COMPARE_FLAG_IGNORE_NOT_SAVED_SECRETS = 0x00000010 + NM_SETTING_COMPARE_FLAG_IGNORE_NOT_SAVED_SECRETS = 0x00000010, + NM_SETTING_COMPARE_FLAG_DIFF_RESULT_WITH_DEFAULT = 0x00000020, + NM_SETTING_COMPARE_FLAG_DIFF_RESULT_NO_DEFAULT = 0x00000040, /* 0x80000000 is used for a private flag */ } NMSettingCompareFlags; @@ -403,6 +405,28 @@ the secret's flags indicate the secret should not be saved to persistent storage (ie, the secret's flag includes NM_SETTING_SECRET_FLAG_NOT_SAVED) + +

NM_SETTING_COMPARE_FLAG_DIFF_RESULT_WITH_DEFAULT

+if this flag is set, +nm_setting_diff() and nm_connection_diff() will also include properties that +are set to their default value. See also NM_SETTING_COMPARE_FLAG_DIFF_RESULT_NO_DEFAULT. + + + +

NM_SETTING_COMPARE_FLAG_DIFF_RESULT_NO_DEFAULT

+if this flag is set, +nm_setting_diff() and nm_connection_diff() will not include properties that +are set to their default value. This is the opposite of +NM_SETTING_COMPARE_FLAG_DIFF_RESULT_WITH_DEFAULT. If both flags are set together, +NM_SETTING_COMPARE_FLAG_DIFF_RESULT_WITH_DEFAULT wins. If both flags are unset, +this means to exclude default properties if there is a setting to compare, +but include all properties, if the setting 'b' is missing. This is the legacy +behaviour of libnm-util, where nm_setting_diff() behaved differently depending +on whether the setting 'b' was available. If NM_SETTING_COMPARE_FLAG_DIFF_RESULT_WITH_DEFAULT +is set, nm_setting_diff() will also set the flags NM_SETTING_DIFF_RESULT_IN_A_DEFAULT +and NM_SETTING_DIFF_RESULT_IN_B_DEFAULT, if the values are default values. + +

@@ -819,6 +845,18 @@ These values indicate the result of a setting difference operation. the property is present in setting B + +

Setting this property directly is discouraged; use the @@ -3187,7 +3187,7 @@ Setting this property directly is discouraged; use the

The password used to decrypt the "phase 2" private key specified in the "phase2-private-key" property when the private key either -uses the path scheme, or is a PKCS12 format key. Setting this property +uses the path scheme, or is a PKCS#12 format key. Setting this property directly is not generally necessary except when returning secrets to NetworkManager; it is generally set automatically when setting the private key by the nm_setting_802_1x_set_phase2_private_key() function. @@ -3250,15 +3250,15 @@ and path. When using the blob scheme and private keys, this property should be set to the key's encrypted PEM encoded data. When using private keys with the path scheme, this property should be set to the full UTF-8 encoded path of the key, prefixed with the string "file://" and ending -with a terminating NUL byte. When using PKCS12 format private keys and -the blob scheme, this property should be set to the PKCS12 data and the +with a terminating NUL byte. When using PKCS#12 format private keys and +the blob scheme, this property should be set to the PKCS#12 data and the "private-key-password" property must be set to password -used to decrypt the PKCS12 certificate and key. When using PKCS12 files +used to decrypt the PKCS#12 certificate and key. When using PKCS#12 files and the path scheme, this property should be set to the full UTF-8 encoded path of the key, prefixed with the string "file://" and and ending with a terminating NUL byte, and as with the blob scheme the "private-key-password" property must be set to the password used to -decode the PKCS12 private key and certificate. +decode the PKCS#12 private key and certificate.

Setting this property directly is discouraged; use the @@ -3279,7 +3279,7 @@ private key data.

The password used to decrypt the private key specified in the "private-key" property when the private key either uses the -path scheme, or if the private key is a PKCS12 format key. Setting this +path scheme, or if the private key is a PKCS#12 format key. Setting this property directly is not generally necessary except when returning secrets to NetworkManager; it is generally set automatically when setting the private key by the nm_setting_802_1x_set_private_key() function. diff --git a/docs/libnm-util/html/NMSettingBluetooth.html b/docs/libnm-util/html/NMSettingBluetooth.html index d627ed93..622a3c2c 100644 --- a/docs/libnm-util/html/NMSettingBluetooth.html +++ b/docs/libnm-util/html/NMSettingBluetooth.html @@ -291,7 +291,8 @@ either DUN to a DUN-capable device or PANU to a NAP-capable device).

NM_SETTING_BOND_OPTION_LACP_RATE

NMSettingBond

typedef struct _NMSettingBond NMSettingBond;

diff --git a/docs/libnm-util/html/NMSettingConnection.html b/docs/libnm-util/html/NMSettingConnection.html index 7bf190c2..508a3b8f 100644 --- a/docs/libnm-util/html/NMSettingConnection.html +++ b/docs/libnm-util/html/NMSettingConnection.html @@ -1131,6 +1131,9 @@ set, then the connection can be attached to any interface of the appropriate type (subject to restrictions imposed by other settings).

+For software devices this specifies the name of the created device. +

For connection types where interface names cannot easily be made persistent (e.g. mobile broadband or USB Ethernet), this property should not be used. Setting this property restricts the interfaces a connection diff --git a/docs/libnm-util/html/NMSettingIP4Config.html b/docs/libnm-util/html/NMSettingIP4Config.html index e44b6d49..20a04ac1 100644 --- a/docs/libnm-util/html/NMSettingIP4Config.html +++ b/docs/libnm-util/html/NMSettingIP4Config.html @@ -53,6 +53,7 @@ enum NM_SETTING_IP4_CONFIG_DNS_SEARCH #define NM_SETTING_IP4_CONFIG_ADDRESSES #define NM_SETTING_IP4_CONFIG_ROUTES +#define NM_SETTING_IP4_CONFIG_ROUTE_METRIC #define NM_SETTING_IP4_CONFIG_IGNORE_AUTO_ROUTES #define NM_SETTING_IP4_CONFIG_IGNORE_AUTO_DNS #define NM_SETTING_IP4_CONFIG_DHCP_CLIENT_ID @@ -157,6 +158,8 @@ const char * NMSettingIP4Config *setting, NMIP4Route *route); void nm_setting_ip4_config_clear_routes (NMSettingIP4Config *setting); +gint64 nm_setting_ip4_config_get_route_metric + (NMSettingIP4Config *setting); gboolean nm_setting_ip4_config_get_ignore_auto_routes (NMSettingIP4Config *setting); gboolean nm_setting_ip4_config_get_ignore_auto_dns @@ -195,7 +198,6 @@ const char *

Properties

-  "address-labels"           GSList_gchararray_*   : Read / Write
   "addresses"                GPtrArray_GArray_guint__*  : Read / Write
   "dhcp-client-id"           gchar*                : Read / Write
   "dhcp-hostname"            gchar*                : Read / Write
@@ -207,6 +209,7 @@ const char *        may-fail"                 gboolean              : Read / Write / Construct
   "method"                   gchar*                : Read / Write
   "never-default"            gboolean              : Read / Write / Construct
+  "route-metric"             gint64                : Read / Write / Construct
   "routes"                   GPtrArray_GArray_guint__*  : Read / Write

NM_SETTING_IP4_CONFIG_ROUTE_METRIC

#define NM_SETTING_IP4_CONFIG_ROUTE_METRIC       "route-metric"
+

NM_SETTING_IP4_CONFIG_IGNORE_AUTO_ROUTES

#define NM_SETTING_IP4_CONFIG_IGNORE_AUTO_ROUTES "ignore-auto-routes"

@@ -1765,6 +1776,35 @@ Removes all configured routes.

nm_setting_ip4_config_get_route_metric ()

gint64              nm_setting_ip4_config_get_route_metric
+                                                        (NMSettingIP4Config *setting);

+Returns the value contained in the "route-metric" +property. +

++++ + + + + + + + + + + +

`setting` :	the NMSettingIP4Config +
Returns :	the route metric that is used for IPv4 routes that don't explicitly +specify a metric. See "route-metric" for more details.

Since 1.0

nm_setting_ip4_config_get_ignore_auto_routes ()

gboolean            nm_setting_ip4_config_get_ignore_auto_routes
                                                         (NMSettingIP4Config *setting);

@@ -1967,14 +2007,6 @@ for the connection to succeed.

Property Details

The `"address-labels"` property

  "address-labels"           GSList_gchararray_*   : Read / Write

-Internal use only. -

The `"addresses"` property

  "addresses"                GPtrArray_GArray_guint__*  : Read / Write

@@ -2116,6 +2148,24 @@ meaning it will never be assigned the default route by NetworkManager.

The `"route-metric"` property

  "route-metric"             gint64                : Read / Write / Construct

+The default metric for routes that don't explicitly specify a metric. +The default value -1 means that the metric is choosen automatically +based on the device type. +The metric applies to dynamic routes, manual (static) routes that +don't have an explicit metric setting, address prefix routes, and +the default route. +As the linux kernel accepts zero (0) as a valid metric, zero is +a valid value. +

Allowed values: [-1,4294967295]

Default value: -1

Since 1.0

The `"routes"` property

  "routes"                   GPtrArray_GArray_guint__*  : Read / Write

diff --git a/docs/libnm-util/html/NMSettingIP6Config.html b/docs/libnm-util/html/NMSettingIP6Config.html index 71ac6e05..b785114d 100644 --- a/docs/libnm-util/html/NMSettingIP6Config.html +++ b/docs/libnm-util/html/NMSettingIP6Config.html @@ -53,6 +53,7 @@ enum NM_SETTING_IP6_CONFIG_DNS_SEARCH #define NM_SETTING_IP6_CONFIG_ADDRESSES #define NM_SETTING_IP6_CONFIG_ROUTES +#define NM_SETTING_IP6_CONFIG_ROUTE_METRIC #define NM_SETTING_IP6_CONFIG_IGNORE_AUTO_ROUTES #define NM_SETTING_IP6_CONFIG_IGNORE_AUTO_DNS #define NM_SETTING_IP6_CONFIG_NEVER_DEFAULT @@ -160,6 +161,8 @@ const char * void nm_setting_ip6_config_clear_routes (NMSettingIP6Config *setting); gboolean nm_setting_ip6_config_get_ignore_auto_routes (NMSettingIP6Config *setting); +gint64 nm_setting_ip6_config_get_route_metric + (NMSettingIP6Config *setting); gboolean nm_setting_ip6_config_get_ignore_auto_dns (NMSettingIP6Config *setting); const char * nm_setting_ip6_config_get_dhcp_hostname @@ -208,6 +211,7 @@ const char * may-fail" gboolean : Read / Write / Construct "method" gchar* : Read / Write "never-default" gboolean : Read / Write / Construct + "route-metric" gint64 : Read / Write / Construct "routes" GPtrArray_GValueArray_GArray_guchar_+guint+GArray_guchar_+guint__* : Read / Write

@@ -336,6 +340,14 @@ Registers an error quark for

NM_SETTING_IP6_CONFIG_ROUTE_METRIC

#define NM_SETTING_IP6_CONFIG_ROUTE_METRIC       "route-metric"
+

NM_SETTING_IP6_CONFIG_IGNORE_AUTO_ROUTES

#define NM_SETTING_IP6_CONFIG_IGNORE_AUTO_ROUTES "ignore-auto-routes"

@@ -1845,6 +1857,35 @@ ignored.

nm_setting_ip6_config_get_route_metric ()

gint64              nm_setting_ip6_config_get_route_metric
+                                                        (NMSettingIP6Config *setting);

+Returns the value contained in the "route-metric" +property. +

++++ + + + + + + + + + + +

`setting` :	the NMSettingIP6Config +
Returns :	the route metric that is used for IPv6 routes that don't explicitly +specify a metric. See "route-metric" for more details.

Since 1.0

nm_setting_ip6_config_get_ignore_auto_dns ()

gboolean            nm_setting_ip6_config_get_ignore_auto_dns
                                                         (NMSettingIP6Config *setting);

@@ -2125,6 +2166,24 @@ NetworkManager.

The `"route-metric"` property

  "route-metric"             gint64                : Read / Write / Construct

+The default metric for routes that don't explicitly specify a metric. +The default value -1 means that the metric is choosen automatically +based on the device type. +The metric applies to dynamic routes, manual (static) routes that +don't have an explicit metric setting, address prefix routes, and +the default route. +As the linux kernel replaces zero (0) by 1024 (user-default), setting +this property to 0 means effectively setting it to 1024. +

Allowed values: [-1,4294967295]

Default value: -1

Since 1.0

The `"routes"` property

  "routes"                   GPtrArray_GValueArray_GArray_guchar_+guint+GArray_guchar_+guint__*  : Read / Write

diff --git a/docs/libnm-util/html/NMSettingVPN.html b/docs/libnm-util/html/NMSettingVPN.html index 646871a0..97cc809f 100644 --- a/docs/libnm-util/html/NMSettingVPN.html +++ b/docs/libnm-util/html/NMSettingVPN.html @@ -50,6 +50,7 @@ enum GQuark nm_setting_vpn_error_quark (void); #define NM_SETTING_VPN_SERVICE_TYPE #define NM_SETTING_VPN_USER_NAME +#define NM_SETTING_VPN_PERSISTENT #define NM_SETTING_VPN_DATA #define NM_SETTING_VPN_SECRETS NMSettingVPN; @@ -60,6 +61,7 @@ enum NMSetting * nm_setting_vpn_new (void); const char * nm_setting_vpn_get_service_type (NMSettingVPN *setting); const char * nm_setting_vpn_get_user_name (NMSettingVPN *setting); +gboolean nm_setting_vpn_get_persistent (NMSettingVPN *setting); guint32 nm_setting_vpn_get_num_data_items (NMSettingVPN *setting); void nm_setting_vpn_add_data_item (NMSettingVPN *setting, const char *key, @@ -100,6 +102,7 @@ const char *

Properties

   "data"                     GHashTable_gchararray+gchararray_*  : Read / Write
+  "persistent"               gboolean              : Read / Write
   "secrets"                  GHashTable_gchararray+gchararray_*  : Read / Write
   "service-type"             gchar*                : Read / Write
   "user-name"                gchar*                : Read / Write
@@ -204,6 +207,14 @@ Registers an error quark for 
+NM_SETTING_VPN_PERSISTENT
+#define NM_SETTING_VPN_PERSISTENT   "persistent"
+
+
+
+

NM_SETTING_VPN_DATA

#define NM_SETTING_VPN_DATA         "data"

@@ -339,6 +350,28 @@ plugin that should be used to connect to this VPN.

nm_setting_vpn_get_persistent ()

gboolean            nm_setting_vpn_get_persistent       (NMSettingVPN *setting);

++++ + + + + + + + + + + +

`setting` :	the NMSettingVPN +
Returns :	the "persistent" property of the setting

nm_setting_vpn_get_num_data_items ()

guint32             nm_setting_vpn_get_num_data_items   (NMSettingVPN *setting);

@@ -667,6 +700,17 @@ values must be strings.

The `"persistent"` property

  "persistent"               gboolean              : Read / Write

+If the VPN service supports persistence, and this property is TRUE, +the VPN will attempt to stay connected across link changes and outages, +until explicitly disconnected. +

Default value: FALSE

The `"secrets"` property

  "secrets"                  GHashTable_gchararray+gchararray_*  : Read / Write

diff --git a/docs/libnm-util/html/NMSettingWireless.html b/docs/libnm-util/html/NMSettingWireless.html index 803beb00..4d97a075 100644 --- a/docs/libnm-util/html/NMSettingWireless.html +++ b/docs/libnm-util/html/NMSettingWireless.html @@ -107,10 +107,10 @@ const char * gboolean nm_setting_wireless_ap_security_compatible (NMSettingWireless *s_wireless, NMSettingWirelessSecurity *s_wireless_sec, - NM80211ApFlags ap_flags, - NM80211ApSecurityFlags ap_wpa, - NM80211ApSecurityFlags ap_rsn, - NM80211Mode ap_mode); + NM80211ApFlags ap_flags, + NM80211ApSecurityFlags ap_wpa, + NM80211ApSecurityFlags ap_rsn, + NM80211Mode ap_mode); const char * nm_setting_wireless_get_security (NMSettingWireless *setting);

@@ -950,10 +950,10 @@ not be preserved.

gboolean            nm_setting_wireless_ap_security_compatible
                                                         (NMSettingWireless *s_wireless,
                                                          NMSettingWirelessSecurity *s_wireless_sec,
-                                                         NM80211ApFlags ap_flags,
-                                                         NM80211ApSecurityFlags ap_wpa,
-                                                         NM80211ApSecurityFlags ap_rsn,
-                                                         NM80211Mode ap_mode);

+ NM80211ApFlags ap_flags, + NM80211ApSecurityFlags ap_wpa, + NM80211ApSecurityFlags ap_rsn, + NM80211Mode ap_mode);

Given a NMSettingWireless and an optional NMSettingWirelessSecurity, determine if the configuration given by the settings is compatible with @@ -980,16 +980,16 @@ compatible with which access points.

ap_flags :

-the NM80211ApFlags of the given access point +the NM80211ApFlags of the given access point

ap_wpa :

-the NM80211ApSecurityFlags of the given access point's WPA +the NM80211ApSecurityFlags of the given access point's WPA capabilities

ap_rsn :

-the NM80211ApSecurityFlags of the given access point's WPA2/RSN +the NM80211ApSecurityFlags of the given access point's WPA2/RSN capabilities diff --git a/docs/libnm-util/html/annotation-glossary.html b/docs/libnm-util/html/annotation-glossary.html index 3fd30723..1c488594 100644 --- a/docs/libnm-util/html/annotation-glossary.html +++ b/docs/libnm-util/html/annotation-glossary.html @@ -22,6 +22,8 @@ A | + C + | E | I @@ -41,6 +43,9 @@

NULL is ok, both for passing and for returning.

array

Parameter points to an array of items.

C

closure

This parameter is a 'user_data', for callbacks; many bindings can pass NULL here.

E

element-type

Generics and defining elements of containers and arrays.

diff --git a/docs/libnm-util/html/api-index-full.html b/docs/libnm-util/html/api-index-full.html index 87f9e302..c9819416 100644 --- a/docs/libnm-util/html/api-index-full.html +++ b/docs/libnm-util/html/api-index-full.html @@ -21,7 +21,15 @@

-C +8 + | + A + | + B + | + C + | + D | I | @@ -37,7 +45,30 @@

API Index

C

@@ -123,6 +154,10 @@

+nm_connection_get_interface_name, function in NMConnection +

nm_connection_get_path, function in NMConnection

@@ -275,6 +310,14 @@

+nm_connection_normalize, function in NMConnection +

+NM_CONNECTION_NORMALIZE_PARAM_IP6_CONFIG_METHOD, macro in NMConnection +

NM_CONNECTION_PATH, macro in NMConnection

@@ -314,6 +357,287 @@ nm_connection_verify, function in NMConnection

+NMConnectivityState, enum in NetworkManager +

D

+NM_DBUS_IFACE_SETTINGS, macro in NetworkManager +

+NM_DBUS_IFACE_SETTINGS_CONNECTION, macro in NetworkManager +

+NM_DBUS_IFACE_SETTINGS_CONNECTION_SECRETS, macro in NetworkManager +

+NM_DBUS_INTERFACE, macro in NetworkManager +

+NM_DBUS_INTERFACE_ACCESS_POINT, macro in NetworkManager +

+NM_DBUS_INTERFACE_ACTIVE_CONNECTION, macro in NetworkManager +

+NM_DBUS_INTERFACE_AGENT_MANAGER, macro in NetworkManager +

+NM_DBUS_INTERFACE_DEVICE, macro in NetworkManager +

+NM_DBUS_INTERFACE_DEVICE_ADSL, macro in NetworkManager +

+NM_DBUS_INTERFACE_DEVICE_BLUETOOTH, macro in NetworkManager +

+NM_DBUS_INTERFACE_DEVICE_BOND, macro in NetworkManager +

+NM_DBUS_INTERFACE_DEVICE_BRIDGE, macro in NetworkManager +

+NM_DBUS_INTERFACE_DEVICE_GENERIC, macro in NetworkManager +

+NM_DBUS_INTERFACE_DEVICE_GRE, macro in NetworkManager +

+NM_DBUS_INTERFACE_DEVICE_INFINIBAND, macro in NetworkManager +

+NM_DBUS_INTERFACE_DEVICE_MACVLAN, macro in NetworkManager +

+NM_DBUS_INTERFACE_DEVICE_MODEM, macro in NetworkManager +

+NM_DBUS_INTERFACE_DEVICE_OLPC_MESH, macro in NetworkManager +

+NM_DBUS_INTERFACE_DEVICE_TEAM, macro in NetworkManager +

+NM_DBUS_INTERFACE_DEVICE_TUN, macro in NetworkManager +

+NM_DBUS_INTERFACE_DEVICE_VETH, macro in NetworkManager +

+NM_DBUS_INTERFACE_DEVICE_VLAN, macro in NetworkManager +

+NM_DBUS_INTERFACE_DEVICE_VXLAN, macro in NetworkManager +

+NM_DBUS_INTERFACE_DEVICE_WIMAX, macro in NetworkManager +

+NM_DBUS_INTERFACE_DEVICE_WIRED, macro in NetworkManager +

+NM_DBUS_INTERFACE_DEVICE_WIRELESS, macro in NetworkManager +

+NM_DBUS_INTERFACE_DHCP4_CONFIG, macro in NetworkManager +

+NM_DBUS_INTERFACE_DHCP6_CONFIG, macro in NetworkManager +

+NM_DBUS_INTERFACE_IP4_CONFIG, macro in NetworkManager +

+NM_DBUS_INTERFACE_IP6_CONFIG, macro in NetworkManager +

+NM_DBUS_INTERFACE_SECRET_AGENT, macro in NetworkManager +

+NM_DBUS_INTERFACE_VPN, macro in NetworkManagerVPN +

+NM_DBUS_INTERFACE_VPN_CONNECTION, macro in NetworkManagerVPN +

+NM_DBUS_INTERFACE_WIMAX_NSP, macro in NetworkManager +

+NM_DBUS_INVALID_VPN_CONNECTION, macro in NetworkManagerVPN +

+NM_DBUS_NO_ACTIVE_VPN_CONNECTION, macro in NetworkManagerVPN +

+NM_DBUS_NO_VPN_CONNECTIONS, macro in NetworkManagerVPN +

+NM_DBUS_PATH, macro in NetworkManager +

+NM_DBUS_PATH_ACCESS_POINT, macro in NetworkManager +

+NM_DBUS_PATH_AGENT_MANAGER, macro in NetworkManager +

+NM_DBUS_PATH_SECRET_AGENT, macro in NetworkManager +

+NM_DBUS_PATH_SETTINGS, macro in NetworkManager +

+NM_DBUS_PATH_SETTINGS_CONNECTION, macro in NetworkManager +

+NM_DBUS_PATH_VPN, macro in NetworkManagerVPN +

+NM_DBUS_PATH_VPN_CONNECTION, macro in NetworkManagerVPN +

+NM_DBUS_PATH_WIMAX_NSP, macro in NetworkManager +

+NM_DBUS_SERVICE, macro in NetworkManager +

+NM_DBUS_VPN_ALREADY_STARTED, macro in NetworkManagerVPN +

+NM_DBUS_VPN_ALREADY_STOPPED, macro in NetworkManagerVPN +

+NM_DBUS_VPN_BAD_ARGUMENTS, macro in NetworkManagerVPN +

+NM_DBUS_VPN_ERROR_PREFIX, macro in NetworkManagerVPN +

+NM_DBUS_VPN_INTERACTIVE_NOT_SUPPORTED, macro in NetworkManagerVPN +

+NM_DBUS_VPN_SIGNAL_CONNECT_FAILED, macro in NetworkManagerVPN +

+NM_DBUS_VPN_SIGNAL_IP4_CONFIG, macro in NetworkManagerVPN +

+NM_DBUS_VPN_SIGNAL_IP_CONFIG_BAD, macro in NetworkManagerVPN +

+NM_DBUS_VPN_SIGNAL_LAUNCH_FAILED, macro in NetworkManagerVPN +

+NM_DBUS_VPN_SIGNAL_LOGIN_BANNER, macro in NetworkManagerVPN +

+NM_DBUS_VPN_SIGNAL_LOGIN_FAILED, macro in NetworkManagerVPN +

+NM_DBUS_VPN_SIGNAL_STATE_CHANGE, macro in NetworkManagerVPN +

+NM_DBUS_VPN_SIGNAL_VPN_CONFIG_BAD, macro in NetworkManagerVPN +

+NM_DBUS_VPN_STARTING_IN_PROGRESS, macro in NetworkManagerVPN +

+NM_DBUS_VPN_STOPPING_IN_PROGRESS, macro in NetworkManagerVPN +

+NM_DBUS_VPN_WRONG_STATE, macro in NetworkManagerVPN +

+NMDeviceCapabilities, enum in NetworkManager +

+NMDeviceModemCapabilities, enum in NetworkManager +

+NMDeviceState, enum in NetworkManager +

+NMDeviceStateReason, enum in NetworkManager +

+NMDeviceType, enum in NetworkManager +

+NMDeviceWifiCapabilities, enum in NetworkManager +

I

NMIP4Address, typedef in NMSettingIP4Config @@ -1133,10 +1457,6 @@

-NMSettingIP4Config:address-labels, object property in NMSettingIP4Config -

NMSettingIP4Config:addresses, object property in NMSettingIP4Config

@@ -1181,6 +1501,10 @@

+NMSettingIP4Config:route-metric, object property in NMSettingIP4Config +

NMSettingIP4Config:routes, object property in NMSettingIP4Config

@@ -1237,6 +1561,10 @@

+NMSettingIP6Config:route-metric, object property in NMSettingIP6Config +

NMSettingIP6Config:routes, object property in NMSettingIP6Config

@@ -1509,6 +1837,10 @@

+NMSettingVPN:persistent, object property in NMSettingVPN +

NMSettingVPN:secrets, object property in NMSettingVPN

@@ -2369,6 +2701,10 @@

+NM_SETTING_BOND_OPTION_LACP_RATE, macro in NMSettingBond +

NM_SETTING_BOND_OPTION_MIIMON, macro in NMSettingBond

@@ -3261,6 +3597,10 @@

+nm_setting_ip4_config_get_route_metric, function in NMSettingIP4Config +

NM_SETTING_IP4_CONFIG_IGNORE_AUTO_DNS, macro in NMSettingIP4Config

@@ -3341,6 +3681,10 @@

+NM_SETTING_IP4_CONFIG_ROUTE_METRIC, macro in NMSettingIP4Config +

NM_SETTING_IP4_CONFIG_SETTING_NAME, macro in NMSettingIP4Config

@@ -3461,6 +3805,10 @@

+nm_setting_ip6_config_get_route_metric, function in NMSettingIP6Config +

NM_SETTING_IP6_CONFIG_IGNORE_AUTO_DNS, macro in NMSettingIP6Config

@@ -3549,6 +3897,10 @@

+NM_SETTING_IP6_CONFIG_ROUTE_METRIC, macro in NMSettingIP6Config +

NM_SETTING_IP6_CONFIG_SETTING_NAME, macro in NMSettingIP6Config

@@ -4089,6 +4441,10 @@

+nm_setting_vpn_get_persistent, function in NMSettingVPN +

nm_setting_vpn_get_secret, function in NMSettingVPN

@@ -4105,6 +4461,10 @@

+NM_SETTING_VPN_PERSISTENT, macro in NMSettingVPN +

nm_setting_vpn_remove_data_item, function in NMSettingVPN

@@ -4688,8 +5048,20 @@ NM_SETTING_WIRELESS_TX_POWER, macro in NMSettingWireless

+NMState, enum in NetworkManager +

+NM_STATE_CONNECTED, macro in NetworkManager +

U

+NMUtilsFileSearchInPathsPredicate, user_function in nm-utils +

NMUtilsSecurityType, enum in nm-utils

@@ -4718,6 +5090,10 @@

+nm_utils_file_search_in_paths, function in nm-utils +

nm_utils_gvalue_hash_dup, function in nm-utils

@@ -4911,9 +5287,165 @@

+NMVPNConnectionState, enum in NetworkManagerVPN +

+NMVPNConnectionStateReason, enum in NetworkManagerVPN +

NMVPNIterFunc, user_function in NMSettingVPN

+NMVPNPluginFailure, enum in NetworkManagerVPN +

+NMVPNServiceState, enum in NetworkManagerVPN +

+NM_VPN_DBUS_PLUGIN_INTERFACE, macro in NetworkManagerVPN +

+NM_VPN_DBUS_PLUGIN_PATH, macro in NetworkManagerVPN +

+NM_VPN_PLUGIN_CAN_PERSIST, macro in NetworkManagerVPN +

+NM_VPN_PLUGIN_CONFIG_BANNER, macro in NetworkManagerVPN +

+NM_VPN_PLUGIN_CONFIG_EXT_GATEWAY, macro in NetworkManagerVPN +

+NM_VPN_PLUGIN_CONFIG_HAS_IP4, macro in NetworkManagerVPN +

+NM_VPN_PLUGIN_CONFIG_HAS_IP6, macro in NetworkManagerVPN +

+NM_VPN_PLUGIN_CONFIG_MTU, macro in NetworkManagerVPN +

+NM_VPN_PLUGIN_CONFIG_TUNDEV, macro in NetworkManagerVPN +

+NM_VPN_PLUGIN_IP4_CONFIG_ADDRESS, macro in NetworkManagerVPN +

+NM_VPN_PLUGIN_IP4_CONFIG_BANNER, macro in NetworkManagerVPN +

+NM_VPN_PLUGIN_IP4_CONFIG_DNS, macro in NetworkManagerVPN +

+NM_VPN_PLUGIN_IP4_CONFIG_DOMAIN, macro in NetworkManagerVPN +

+NM_VPN_PLUGIN_IP4_CONFIG_DOMAINS, macro in NetworkManagerVPN +

+NM_VPN_PLUGIN_IP4_CONFIG_EXT_GATEWAY, macro in NetworkManagerVPN +

+NM_VPN_PLUGIN_IP4_CONFIG_GATEWAY, macro in NetworkManagerVPN +

+NM_VPN_PLUGIN_IP4_CONFIG_INT_GATEWAY, macro in NetworkManagerVPN +

+NM_VPN_PLUGIN_IP4_CONFIG_MSS, macro in NetworkManagerVPN +

+NM_VPN_PLUGIN_IP4_CONFIG_MTU, macro in NetworkManagerVPN +

+NM_VPN_PLUGIN_IP4_CONFIG_NBNS, macro in NetworkManagerVPN +

+NM_VPN_PLUGIN_IP4_CONFIG_NEVER_DEFAULT, macro in NetworkManagerVPN +

+NM_VPN_PLUGIN_IP4_CONFIG_PREFIX, macro in NetworkManagerVPN +

+NM_VPN_PLUGIN_IP4_CONFIG_PTP, macro in NetworkManagerVPN +

+NM_VPN_PLUGIN_IP4_CONFIG_ROUTES, macro in NetworkManagerVPN +

+NM_VPN_PLUGIN_IP4_CONFIG_TUNDEV, macro in NetworkManagerVPN +

+NM_VPN_PLUGIN_IP6_CONFIG_ADDRESS, macro in NetworkManagerVPN +

+NM_VPN_PLUGIN_IP6_CONFIG_DNS, macro in NetworkManagerVPN +

+NM_VPN_PLUGIN_IP6_CONFIG_DOMAIN, macro in NetworkManagerVPN +

+NM_VPN_PLUGIN_IP6_CONFIG_DOMAINS, macro in NetworkManagerVPN +

+NM_VPN_PLUGIN_IP6_CONFIG_INT_GATEWAY, macro in NetworkManagerVPN +

+NM_VPN_PLUGIN_IP6_CONFIG_MSS, macro in NetworkManagerVPN +

+NM_VPN_PLUGIN_IP6_CONFIG_NEVER_DEFAULT, macro in NetworkManagerVPN +

+NM_VPN_PLUGIN_IP6_CONFIG_PREFIX, macro in NetworkManagerVPN +

+NM_VPN_PLUGIN_IP6_CONFIG_PTP, macro in NetworkManagerVPN +

+NM_VPN_PLUGIN_IP6_CONFIG_ROUTES, macro in NetworkManagerVPN +

W

NMWepKeyType, enum in NMSettingWirelessSecurity diff --git a/docs/libnm-util/html/ch01.html b/docs/libnm-util/html/ch01.html index 88a43401..10afeae9 100644 --- a/docs/libnm-util/html/ch01.html +++ b/docs/libnm-util/html/ch01.html @@ -113,6 +113,12 @@ that require PPP to deliver IP capability

nm-utils — Utility functions

+NetworkManager +

+NetworkManagerVPN +

diff --git a/docs/libnm-util/html/index.html b/docs/libnm-util/html/index.html index aa9390e1..05c28f08 100644 --- a/docs/libnm-util/html/index.html +++ b/docs/libnm-util/html/index.html @@ -15,7 +15,7 @@

- for libnm-util 0.9.10.0 + for libnm-util 1.0.0 The latest version of this documentation can be found on-line at https://developer.gnome.org/libnm-util/0.9/. @@ -139,6 +139,12 @@ that require PPP to deliver IP capability

nm-utils — Utility functions

+NetworkManager +

+NetworkManagerVPN +

Object Hierarchy

API Index

diff --git a/docs/libnm-util/html/index.sgml b/docs/libnm-util/html/index.sgml index ad7d61c9..e0959317 100644 --- a/docs/libnm-util/html/index.sgml +++ b/docs/libnm-util/html/index.sgml @@ -16,6 +16,8 @@ + + @@ -33,6 +35,7 @@ + @@ -40,6 +43,7 @@ + @@ -117,6 +121,8 @@ + + @@ -135,6 +141,8 @@ + + @@ -671,6 +679,7 @@ + @@ -1231,6 +1240,7 @@ + @@ -1297,6 +1307,7 @@ + @@ -1305,7 +1316,6 @@ - @@ -1317,6 +1327,7 @@ + @@ -1341,6 +1352,7 @@ + @@ -1413,6 +1425,7 @@ + @@ -1429,6 +1442,7 @@ + @@ -1550,6 +1564,7 @@ + @@ -1558,6 +1573,7 @@ + @@ -1570,6 +1586,7 @@ + @@ -1619,6 +1636,8 @@ + + @@ -1641,8 +1660,309 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

@@ -159,10 +169,8 @@ access points and devices, among other things.

nm_utils_init ()

gboolean            nm_utils_init                       (GError **error);

-Initializes libnm-util; should be called when starting and program that -uses libnm-util. Sets up an atexit() handler to ensure de-initialization -is performed, but calling nm_utils_deinit() to explicitly deinitialize -libnm-util can also be done. This function can be called more than once. +Initializes libnm-util; should be called when starting any program that +uses libnm-util. This function can be called more than once.

@@ -188,10 +196,8 @@ libnm-util can also be done. This function can be called more than once.

nm_utils_deinit ()

void                nm_utils_deinit                     (void);

-Frees all resources used internally by libnm-util. This function is called -from an atexit() handler, set up by nm_utils_init(), but is safe to be called -more than once. Subsequent calls have no effect until nm_utils_init() is -called again. +No-op. Although this function still exists for ABI compatibility reasons, it +does not have any effect, and does not ever need to be called.

@@ -490,12 +496,12 @@ generating the dynamic WEP keys automatically

nm_utils_security_valid ()

gboolean            nm_utils_security_valid             (NMUtilsSecurityType type,
-                                                         NMDeviceWifiCapabilities wifi_caps,
+                                                         NMDeviceWifiCapabilities wifi_caps,
                                                          gboolean have_ap,
                                                          gboolean adhoc,
-                                                         NM80211ApFlags ap_flags,
-                                                         NM80211ApSecurityFlags ap_wpa,
-                                                         NM80211ApSecurityFlags ap_rsn);

+ NM80211ApFlags ap_flags, + NM80211ApSecurityFlags ap_wpa, + NM80211ApSecurityFlags ap_rsn);

Given a set of device capabilities, and a desired security type to check against, determines whether the combination of device, desired security @@ -520,7 +526,7 @@ e.g.

@@ -533,18 +539,18 @@ e.g. - +e.g. (NM_802_11_AP_SEC_PAIR_TKIP | NM_802_11_AP_SEC_KEY_MGMT_PSK) +e.g. (NM_802_11_AP_SEC_PAIR_CCMP | NM_802_11_AP_SEC_PAIR_TKIP) @@ -559,7 +565,7 @@ compatible with the desired type,

nm_utils_ap_mode_security_valid ()

gboolean            nm_utils_ap_mode_security_valid     (NMUtilsSecurityType type,
-                                                         NMDeviceWifiCapabilities wifi_caps);

+ NMDeviceWifiCapabilities wifi_caps);

Given a set of device capabilities, and a desired security type to check against, determines whether the combination of device capabilities and @@ -580,7 +586,7 @@ e.g.

@@ -675,7 +681,7 @@ extended in the future. - @@ -738,7 +744,7 @@ extended in the future. - @@ -869,7 +875,7 @@ extended in the future. - @@ -933,7 +939,7 @@ is not guaranteed to be stable and may be extended in the future. - @@ -948,7 +954,7 @@ is not guaranteed to be stable and may be extended in the future. Utility function to convert a GSList of NMIP6Route objects into a GPtrArray of GValueArrays of (GArray of guchars), guint32, (GArray of guchars), and guint32 representing a list of NetworkManager IPv6 routes (which is a tuple of destination, -prefix, next hop, and metric). The specific format of this serialization is not +prefix, next hop, and metric). The specific format of this serialization is not guaranteed to be stable and may be extended in the future.

`wifi_caps` :	bitfield of the capabilities of the specific Wi-Fi device, e.g. -NM_WIFI_DEVICE_CAP_CIPHER_WEP40 +NM_WIFI_DEVICE_CAP_CIPHER_WEP40
`ap_flags` :	bitfield of AP capabilities, e.g. NM_802_11_AP_FLAGS_PRIVACY +	bitfield of AP capabilities, e.g. NM_802_11_AP_FLAGS_PRIVACY
`ap_wpa` :	bitfield of AP capabilties derived from the AP's WPA beacon, -e.g. (NM_802_11_AP_SEC_PAIR_TKIP \| NM_802_11_AP_SEC_KEY_MGMT_PSK)
`ap_rsn` :	bitfield of AP capabilties derived from the AP's RSN/WPA2 beacon, -e.g. (NM_802_11_AP_SEC_PAIR_CCMP \| NM_802_11_AP_SEC_PAIR_TKIP)
Returns :	`wifi_caps` :	bitfield of the capabilities of the specific Wi-Fi device, e.g. -NM_WIFI_DEVICE_CAP_CIPHER_WEP40 +NM_WIFI_DEVICE_CAP_CIPHER_WEP40
Returns :	a newly allocated GSList of NMIP4Address objects. [transfer full][element-type NetworkManager.IP4Address] +	a newly allocated GSList of NMIP4Address objects. [transfer full][element-type NMIP4Address]
Returns :	a newly allocated GSList of NMIP4Route objects. [transfer full][element-type NetworkManager.IP4Route] +	a newly allocated GSList of NMIP4Route objects. [transfer full][element-type NMIP4Route]
Returns :	a newly allocated GSList of NMIP6Address objects. [transfer full][element-type NetworkManager.IP6Address] +	a newly allocated GSList of NMIP6Address objects. [transfer full][element-type NMIP6Address]
Returns :	a newly allocated GSList of NMIP6Route objects. [transfer full][element-type NetworkManager.IP6Route] +	a newly allocated GSList of NMIP6Route objects. [transfer full][element-type NMIP6Route]

@@ -1167,7 +1173,7 @@ certificate/private key file. [

nm_utils_file_is_pkcs12 ()

gboolean            nm_utils_file_is_pkcs12             (const char *filename);

-Utility function to find out if the filename is in PKCS12 format. +Utility function to find out if the filename is in PKCS#12 format.

@@ -1182,7 +1188,84 @@ Utility function to find out if the filename< +TRUE if the file is PKCS#12, FALSE if it is not + + +

Returns :

-TRUE if the file is PKCS12, FALSE if it is not

+
+
+
NMUtilsFileSearchInPathsPredicate ()
+
gboolean (*NMUtilsFileSearchInPathsPredicate) + (const char *filename, + gpointer user_data);
+
+
+
+
+
+
nm_utils_file_search_in_paths ()
+
const char * nm_utils_file_search_in_paths (const char *progname, + const char *try_first, + const char *const *paths, + GFileTest file_test_flags, + NMUtilsFileSearchInPathsPredicate predicate, + gpointer user_data, + GError **error);
+
+Searches for a progname file in a list of search paths. +
+
++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

progname :
the helper program name, like "iptables" +Must be a non-empty string, without path separator (/).
try_first :
a custom path to try first before searching. +It is silently ignored if it is empty or not an absolute path. [allow-none] +
paths :
a NULL terminated list of search paths. +Can be empty or NULL, in which case only try_first is checked. [allow-none] +
file_test_flags :
the flags passed to g_file_test() when searching +for progname. Set it to 0 to skip the g_file_test().
predicate :
if given, pass the file name to this function +for additional checks. This check is performed after the check for +file_test_flags. You cannot omit both file_test_flags and predicate. [scope call] +
user_data :
(allow-none): user data for predicate function. [closure] +
error :
on failure, a "not found" error using error_domain and error_code +
Returns :
the full path to the helper, if found, or NULL if not found. +The returned string is not owned by the caller, but later +invocations of the function might overwrite it. [transfer none] +

@@ -1313,9 +1396,8 @@ Utility function to verify Wi-Fi channel validity.
#define NM_UTILS_HWADDR_LEN_MAX 20 /* INFINIBAND_ALEN */

-The maximum length of a hardware address of a type known by -nm_utils_hwaddr_len() or nm_utils_hwaddr_aton(). This can be used -as the size of the buffer passed to nm_utils_hwaddr_aton(). +The maximum length of hardware addresses handled by NetworkManager itself, +nm_utils_hwaddr_len(), and nm_utils_hwaddr_aton().

@@ -1333,7 +1415,8 @@ Returns the length in octets of a hardware address of type
type :
-the type of address; either ARPHRD_ETHER or ARPHRD_INFINIBAND +the type of address; either ARPHRD_ETHER or +ARPHRD_INFINIBAND @@ -1357,8 +1440,8 @@ a length; but you can just use nm_utils_hwaddr_aton_len() now instead.

-Returns the type (either ARPHRD_ETHER or ARPHRD_INFINIBAND) of -the raw address given its length. +Returns the type (either ARPHRD_ETHER or +ARPHRD_INFINIBAND) of the raw address given its length.

@@ -1372,8 +1455,9 @@ the raw address given its length. - +

Returns :
the type, either ARPHRD_ETHER or ARPHRD_INFINIBAND. -If the length is unexpected, return -1 (unsupported type/length). the type, either ARPHRD_ETHER or +ARPHRD_INFINIBAND. If the length is unexpected, return -1 +(unsupported type/length).

@@ -1402,7 +1486,8 @@ a type.
type :
-the type of address; either ARPHRD_ETHER or ARPHRD_INFINIBAND +the type of address; either ARPHRD_ETHER or +ARPHRD_INFINIBAND @@ -1434,7 +1519,8 @@ Parses asc and converts it to binary for
type :
-the type of address; either ARPHRD_ETHER or ARPHRD_INFINIBAND +the type of address; either ARPHRD_ETHER or +ARPHRD_INFINIBAND @@ -1473,7 +1559,8 @@ instead of a type.
type :
-the type of address; either ARPHRD_ETHER or ARPHRD_INFINIBAND +the type of address; either ARPHRD_ETHER or +ARPHRD_INFINIBAND @@ -1764,13 +1851,14 @@ Wrapper for inet_ntop.
dst :
-the destination buffer, it must contain at least INET_ADDRSTRLEN -or NM_UTILS_INET_ADDRSTRLEN characters. If set to NULL, it will return -a pointer to an internal, static buffer (shared with nm_utils_inet6_ntop()). -Beware, that the internal buffer will be overwritten with ever new call -of nm_utils_inet4_ntop() or nm_utils_inet6_ntop() that does not provied it's -own dst buffer. Also, using the internal buffer is not thread safe. When -in doubt, pass your own dst buffer to avoid these issues. +the destination buffer, it must contain at least +INET_ADDRSTRLEN or NM_UTILS_INET_ADDRSTRLEN +characters. If set to NULL, it will return a pointer to an internal, static +buffer (shared with nm_utils_inet6_ntop()). Beware, that the internal +buffer will be overwritten with ever new call of nm_utils_inet4_ntop() or +nm_utils_inet6_ntop() that does not provied it's own dst buffer. Also, +using the internal buffer is not thread safe. When in doubt, pass your own +dst buffer to avoid these issues.
Returns :
@@ -1801,13 +1889,14 @@ Wrapper for inet_ntop.
dst :
-the destination buffer, it must contain at least INET6_ADDRSTRLEN -or NM_UTILS_INET_ADDRSTRLEN characters. If set to NULL, it will return -a pointer to an internal, static buffer (shared with nm_utils_inet4_ntop()). -Beware, that the internal buffer will be overwritten with ever new call -of nm_utils_inet4_ntop() or nm_utils_inet6_ntop() that does not provied it's -own dst buffer. Also, using the internal buffer is not thread safe. When -in doubt, pass your own dst buffer to avoid these issues. +the destination buffer, it must contain at least +INET6_ADDRSTRLEN or NM_UTILS_INET_ADDRSTRLEN +characters. If set to NULL, it will return a pointer to an internal, static +buffer (shared with nm_utils_inet4_ntop()). Beware, that the internal +buffer will be overwritten with ever new call of nm_utils_inet4_ntop() or +nm_utils_inet6_ntop() that does not provied it's own dst buffer. Also, +using the internal buffer is not thread safe. When in doubt, pass your own +dst buffer to avoid these issues.
Returns :
diff --git a/docs/libnm-util/html/libnm-util.devhelp2 b/docs/libnm-util/html/libnm-util.devhelp2 index 571aa04f..573c7c53 100644 --- a/docs/libnm-util/html/libnm-util.devhelp2 +++ b/docs/libnm-util/html/libnm-util.devhelp2 @@ -32,6 +32,8 @@ _{_{_{+ _{+
_{_{@@ -43,6 +45,7 @@

+

@@ -60,6 +63,7 @@

+

@@ -67,6 +71,7 @@

+

@@ -512,6 +517,7 @@

+

@@ -917,6 +923,7 @@

+

@@ -983,6 +990,7 @@

+

@@ -990,7 +998,6 @@

-

@@ -1002,6 +1009,7 @@

+

@@ -1012,6 +1020,7 @@

+

@@ -1080,6 +1089,7 @@

+

@@ -1095,6 +1105,7 @@

+

@@ -1182,6 +1193,7 @@

+

@@ -1190,6 +1202,7 @@

+

@@ -1201,6 +1214,7 @@

+

@@ -1235,6 +1249,8 @@

+
+

@@ -1257,10 +1273,127 @@

+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+

+

@@ -1275,12 +1408,16 @@

+
+

+
+

@@ -1433,5 +1570,181 @@

+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+

diff --git a/docs/libnm-util/html/object-tree.html b/docs/libnm-util/html/object-tree.html
index 6cd0dcde..c073e707 100644
--- a/docs/libnm-util/html/object-tree.html
+++ b/docs/libnm-util/html/object-tree.html
@@ -6,14 +6,14 @@

-
+

-
+
--
cgit 1.3.0-6-gf8a5

libnm-util Reference Manual}}}}}}

`NM_STATE_UNKNOWN`	networking state is unknown +
`NM_STATE_ASLEEP`	networking is not enabled +
`NM_STATE_DISCONNECTED`	there is no active network connection +
`NM_STATE_DISCONNECTING`	network connections are being cleaned up +
`NM_STATE_CONNECTING`	a network connection is being started +
`NM_STATE_CONNECTED_LOCAL`	there is only local IPv4 and/or IPv6 connectivity +
`NM_STATE_CONNECTED_SITE`	there is only site-wide IPv4 and/or IPv6 connectivity +
`NM_STATE_CONNECTED_GLOBAL`	there is global IPv4 and/or IPv6 Internet connectivity +

`NM_CONNECTIVITY_UNKNOWN`	Network connectivity is unknown. +
`NM_CONNECTIVITY_NONE`	The host is not connected to any network. +
`NM_CONNECTIVITY_PORTAL`	The host is behind a captive portal and + cannot reach the full Internet. +
`NM_CONNECTIVITY_LIMITED`	The host is connected to a network, but + does not appear to be able to reach the full Internet. +
`NM_CONNECTIVITY_FULL`	The host is connected to a network, and + appears to be able to reach the full Internet. +

`NM_DEVICE_TYPE_UNKNOWN`	unknown device +
`NM_DEVICE_TYPE_ETHERNET`	a wired ethernet device +
`NM_DEVICE_TYPE_WIFI`	an 802.11 WiFi device +
`NM_DEVICE_TYPE_UNUSED1`	not used +
`NM_DEVICE_TYPE_UNUSED2`	not used +
`NM_DEVICE_TYPE_BT`	a Bluetooth device supporting PAN or DUN access protocols +
`NM_DEVICE_TYPE_OLPC_MESH`	an OLPC XO mesh networking device +
`NM_DEVICE_TYPE_WIMAX`	an 802.16e Mobile WiMAX broadband device +
`NM_DEVICE_TYPE_MODEM`	a modem supporting analog telephone, CDMA/EVDO, +GSM/UMTS, or LTE network access protocols +
`NM_DEVICE_TYPE_INFINIBAND`	an IP-over-InfiniBand device +
`NM_DEVICE_TYPE_BOND`	a bond master interface +
`NM_DEVICE_TYPE_VLAN`	an 802.1Q VLAN interface +
`NM_DEVICE_TYPE_ADSL`	ADSL modem +
`NM_DEVICE_TYPE_BRIDGE`	a bridge master interface +
`NM_DEVICE_TYPE_GENERIC`	generic support for unrecognized device types +
`NM_DEVICE_TYPE_TEAM`	a team master interface +

`NM_DEVICE_CAP_NONE`	device has no special capabilities +
`NM_DEVICE_CAP_NM_SUPPORTED`	NetworkManager supports this device +
`NM_DEVICE_CAP_CARRIER_DETECT`	this device can indicate carrier status +
`NM_DEVICE_CAP_IS_SOFTWARE`	this device is a software device +

`NM_WIFI_DEVICE_CAP_NONE`	device has no encryption/authentication capabilities +
`NM_WIFI_DEVICE_CAP_CIPHER_WEP40`	device supports 40/64-bit WEP encryption +
`NM_WIFI_DEVICE_CAP_CIPHER_WEP104`	device supports 104/128-bit WEP encryption +
`NM_WIFI_DEVICE_CAP_CIPHER_TKIP`	device supports TKIP encryption +
`NM_WIFI_DEVICE_CAP_CIPHER_CCMP`	device supports AES/CCMP encryption +
`NM_WIFI_DEVICE_CAP_WPA`	device supports WPA1 authentication +
`NM_WIFI_DEVICE_CAP_RSN`	device supports WPA2/RSN authentication +
`NM_WIFI_DEVICE_CAP_AP`	device supports Access Point mode +
`NM_WIFI_DEVICE_CAP_ADHOC`	device supports Ad-Hoc mode +

			libnm-util Reference Manual
+Top + \| + Description +

`NM_802_11_AP_SEC_NONE`	the access point has no special security requirements +
`NM_802_11_AP_SEC_PAIR_WEP40`	40/64-bit WEP is supported for +pairwise/unicast encryption +
`NM_802_11_AP_SEC_PAIR_WEP104`	104/128-bit WEP is supported for +pairwise/unicast encryption +
`NM_802_11_AP_SEC_PAIR_TKIP`	TKIP is supported for pairwise/unicast encryption +
`NM_802_11_AP_SEC_PAIR_CCMP`	AES/CCMP is supported for pairwise/unicast encryption +
`NM_802_11_AP_SEC_GROUP_WEP40`	40/64-bit WEP is supported for group/broadcast +encryption +
`NM_802_11_AP_SEC_GROUP_WEP104`	104/128-bit WEP is supported for +group/broadcast encryption +
`NM_802_11_AP_SEC_GROUP_TKIP`	TKIP is supported for group/broadcast encryption +
`NM_802_11_AP_SEC_GROUP_CCMP`	AES/CCMP is supported for group/broadcast +encryption +
`NM_802_11_AP_SEC_KEY_MGMT_PSK`	WPA/RSN Pre-Shared Key encryption is +supported +
`NM_802_11_AP_SEC_KEY_MGMT_802_1X`	802.1x authentication and key management +is supported +

`NM_DEVICE_MODEM_CAPABILITY_NONE`	modem has no usable capabilities +
`NM_DEVICE_MODEM_CAPABILITY_POTS`	modem uses the analog wired telephone +network and is not a wireless/cellular device +
`NM_DEVICE_MODEM_CAPABILITY_CDMA_EVDO`	modem supports at least one of CDMA +1xRTT, EVDO revision 0, EVDO revision A, or EVDO revision B +
`NM_DEVICE_MODEM_CAPABILITY_GSM_UMTS`	modem supports at least one of GSM, +GPRS, EDGE, UMTS, HSDPA, HSUPA, or HSPA+ packet switched data capability +
`NM_DEVICE_MODEM_CAPABILITY_LTE`	modem has LTE data capability +

`NM_DEVICE_STATE_REASON_NONE`	No reason given +
`NM_DEVICE_STATE_REASON_UNKNOWN`	Unknown error +
`NM_DEVICE_STATE_REASON_NOW_MANAGED`	Device is now managed +
`NM_DEVICE_STATE_REASON_NOW_UNMANAGED`	Device is now unmanaged +
`NM_DEVICE_STATE_REASON_CONFIG_FAILED`	The device could not be readied for configuration +
`NM_DEVICE_STATE_REASON_IP_CONFIG_UNAVAILABLE`	IP configuration could not be reserved (no available address, timeout, etc) +
`NM_DEVICE_STATE_REASON_IP_CONFIG_EXPIRED`	The IP config is no longer valid +
`NM_DEVICE_STATE_REASON_NO_SECRETS`	Secrets were required, but not provided +
`NM_DEVICE_STATE_REASON_SUPPLICANT_DISCONNECT`	802.1x supplicant disconnected +
`NM_DEVICE_STATE_REASON_SUPPLICANT_CONFIG_FAILED`	802.1x supplicant configuration failed +
`NM_DEVICE_STATE_REASON_SUPPLICANT_FAILED`	802.1x supplicant failed +
`NM_DEVICE_STATE_REASON_SUPPLICANT_TIMEOUT`	802.1x supplicant took too long to authenticate +
`NM_DEVICE_STATE_REASON_PPP_START_FAILED`	PPP service failed to start +
`NM_DEVICE_STATE_REASON_PPP_DISCONNECT`	PPP service disconnected +
`NM_DEVICE_STATE_REASON_PPP_FAILED`	PPP failed +
`NM_DEVICE_STATE_REASON_DHCP_START_FAILED`	DHCP client failed to start +
`NM_DEVICE_STATE_REASON_DHCP_ERROR`	DHCP client error +
`NM_DEVICE_STATE_REASON_DHCP_FAILED`	DHCP client failed +
`NM_DEVICE_STATE_REASON_SHARED_START_FAILED`	Shared connection service failed to start +
`NM_DEVICE_STATE_REASON_SHARED_FAILED`	Shared connection service failed +
`NM_DEVICE_STATE_REASON_AUTOIP_START_FAILED`	AutoIP service failed to start +
`NM_DEVICE_STATE_REASON_AUTOIP_ERROR`	AutoIP service error +
`NM_DEVICE_STATE_REASON_AUTOIP_FAILED`	AutoIP service failed +
`NM_DEVICE_STATE_REASON_MODEM_BUSY`	The line is busy +
`NM_DEVICE_STATE_REASON_MODEM_NO_DIAL_TONE`	No dial tone +
`NM_DEVICE_STATE_REASON_MODEM_NO_CARRIER`	No carrier could be established +
`NM_DEVICE_STATE_REASON_MODEM_DIAL_TIMEOUT`	The dialing request timed out +
`NM_DEVICE_STATE_REASON_MODEM_DIAL_FAILED`	The dialing attempt failed +
`NM_DEVICE_STATE_REASON_MODEM_INIT_FAILED`	Modem initialization failed +
`NM_DEVICE_STATE_REASON_GSM_APN_FAILED`	Failed to select the specified APN +
`NM_DEVICE_STATE_REASON_GSM_REGISTRATION_NOT_SEARCHING`	Not searching for networks +
`NM_DEVICE_STATE_REASON_GSM_REGISTRATION_DENIED`	Network registration denied +
`NM_DEVICE_STATE_REASON_GSM_REGISTRATION_TIMEOUT`	Network registration timed out +
`NM_DEVICE_STATE_REASON_GSM_REGISTRATION_FAILED`	Failed to register with the requested network +
`NM_DEVICE_STATE_REASON_GSM_PIN_CHECK_FAILED`	PIN check failed +
`NM_DEVICE_STATE_REASON_FIRMWARE_MISSING`	Necessary firmware for the device may be missing +
`NM_DEVICE_STATE_REASON_REMOVED`	The device was removed +
`NM_DEVICE_STATE_REASON_SLEEPING`	NetworkManager went to sleep +
`NM_DEVICE_STATE_REASON_CONNECTION_REMOVED`	The device's active connection disappeared +
`NM_DEVICE_STATE_REASON_USER_REQUESTED`	Device disconnected by user or client +

NM_CONNECTION_NORMALIZE_PARAM_IP6_CONFIG_METHOD

NM_CONNECTION_ERROR

nm_connection_normalize ()

nm_connection_need_secrets ()

nm_connection_get_interface_name ()

nm_connection_is_type ()

NM_SETTING_BOND_OPTION_LACP_RATE

NMSettingBond

Properties

NM_SETTING_IP4_CONFIG_ROUTE_METRIC

NM_SETTING_IP4_CONFIG_IGNORE_AUTO_ROUTES

nm_setting_ip4_config_get_route_metric ()

nm_setting_ip4_config_get_ignore_auto_routes ()

Property Details

The "address-labels" property

The "addresses" property

The "route-metric" property

The "routes" property

NM_SETTING_IP6_CONFIG_ROUTE_METRIC

NM_SETTING_IP6_CONFIG_IGNORE_AUTO_ROUTES

nm_setting_ip6_config_get_route_metric ()

nm_setting_ip6_config_get_ignore_auto_dns ()

The "route-metric" property

The "routes" property

Properties

NM_SETTING_VPN_PERSISTENT

NM_SETTING_VPN_DATA

nm_setting_vpn_get_persistent ()

nm_setting_vpn_get_num_data_items ()

The "persistent" property

The "secrets" property

C

E

API Index

C

8

A

B

C

D

I

U

W

NetworkManager

Synopsis

Description

Details

NM_DBUS_SERVICE

NM_DBUS_PATH

NM_DBUS_INTERFACE

NM_DBUS_INTERFACE_DEVICE

NM_DBUS_INTERFACE_DEVICE_WIRED

NM_DBUS_INTERFACE_DEVICE_ADSL

NM_DBUS_INTERFACE_DEVICE_WIRELESS

NM_DBUS_INTERFACE_DEVICE_BLUETOOTH

NM_DBUS_INTERFACE_DEVICE_OLPC_MESH

NM_DBUS_PATH_ACCESS_POINT

NM_DBUS_INTERFACE_ACCESS_POINT

NM_DBUS_INTERFACE_DEVICE_MODEM

NM_DBUS_INTERFACE_DEVICE_WIMAX

NM_DBUS_INTERFACE_WIMAX_NSP

NM_DBUS_PATH_WIMAX_NSP

NM_DBUS_INTERFACE_ACTIVE_CONNECTION

NM_DBUS_INTERFACE_IP4_CONFIG

NM_DBUS_INTERFACE_DHCP4_CONFIG

NM_DBUS_INTERFACE_IP6_CONFIG

NM_DBUS_INTERFACE_DHCP6_CONFIG

NM_DBUS_INTERFACE_DEVICE_INFINIBAND

NM_DBUS_INTERFACE_DEVICE_BOND

NM_DBUS_INTERFACE_DEVICE_TEAM

NM_DBUS_INTERFACE_DEVICE_VLAN

NM_DBUS_INTERFACE_DEVICE_BRIDGE

NM_DBUS_INTERFACE_DEVICE_GENERIC

NM_DBUS_INTERFACE_DEVICE_VETH

NM_DBUS_INTERFACE_DEVICE_TUN

NM_DBUS_INTERFACE_DEVICE_MACVLAN

NM_DBUS_INTERFACE_DEVICE_VXLAN

NM_DBUS_INTERFACE_DEVICE_GRE

NM_DBUS_IFACE_SETTINGS

NM_DBUS_PATH_SETTINGS

The `"address-labels"` property

The `"addresses"` property

The `"route-metric"` property

The `"routes"` property

The `"route-metric"` property

The `"routes"` property

The `"persistent"` property

The `"secrets"` property