diff options
| author | Michael Biebl <biebl@debian.org> | 2024-12-25 20:36:29 +0100 |
|---|---|---|
| committer | Michael Biebl <biebl@debian.org> | 2024-12-25 20:36:29 +0100 |
| commit | e465722b908aa870bdc293b9a417d3c15294aa6d (patch) | |
| tree | 7c959d3b73f427d6c40522a7464eaa4531ef2f05 /docs/libnm/html/NMClient.html | |
| parent | 56928734cbcf1d3a02fae4f152a541df1b04e04a (diff) | |
New upstream version 1.50.1 upstream/1.50.1
Diffstat (limited to 'docs/libnm/html/NMClient.html')
| -rw-r--r-- | docs/libnm/html/NMClient.html | 6829 |
1 files changed, 0 insertions, 6829 deletions
diff --git a/docs/libnm/html/NMClient.html b/docs/libnm/html/NMClient.html deleted file mode 100644 index 39e60dc2..00000000 --- a/docs/libnm/html/NMClient.html +++ /dev/null @@ -1,6829 +0,0 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> -<html> -<head> -<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> -<title>NMClient: libnm Reference Manual</title> -<meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"> -<link rel="home" href="index.html" title="libnm Reference Manual"> -<link rel="up" href="ch02.html" title="Client Object API Reference"> -<link rel="prev" href="ch02.html" title="Client Object API Reference"> -<link rel="next" href="NMSecretAgentOld.html" title="NMSecretAgentOld"> -<meta name="generator" content="GTK-Doc V1.34.0 (XML mode)"> -<link rel="stylesheet" href="style.css" type="text/css"> -</head> -<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"> -<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="5"><tr valign="middle"> -<td width="100%" align="left" class="shortcuts"> -<a href="#" class="shortcut">Top</a><span id="nav_description"> <span class="dim">|</span> - <a href="#NMClient.description" class="shortcut">Description</a></span><span id="nav_hierarchy"> <span class="dim">|</span> - <a href="#NMClient.object-hierarchy" class="shortcut">Object Hierarchy</a></span><span id="nav_interfaces"> <span class="dim">|</span> - <a href="#NMClient.implemented-interfaces" class="shortcut">Implemented Interfaces</a></span><span id="nav_properties"> <span class="dim">|</span> - <a href="#NMClient.properties" class="shortcut">Properties</a></span><span id="nav_signals"> <span class="dim">|</span> - <a href="#NMClient.signals" class="shortcut">Signals</a></span> -</td> -<td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td> -<td><a accesskey="u" href="ch02.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td> -<td><a accesskey="p" href="ch02.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td> -<td><a accesskey="n" href="NMSecretAgentOld.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td> -</tr></table> -<div class="refentry"> -<a name="NMClient"></a><div class="titlepage"></div> -<div class="refnamediv"><table width="100%"><tr> -<td valign="top"> -<h2><span class="refentrytitle"><a name="NMClient.top_of_page"></a>NMClient</span></h2> -<p>NMClient</p> -</td> -<td class="gallery_image" valign="top" align="right"></td> -</tr></table></div> -<div class="refsect1"> -<a name="NMClient.functions"></a><h2>Functions</h2> -<div class="informaltable"><table class="informaltable" width="100%" border="0"> -<colgroup> -<col width="150px" class="functions_proto_type"> -<col class="functions_proto_name"> -</colgroup> -<tbody> -<tr> -<td class="function_type"> -<span class="returnvalue">GQuark</span> -</td> -<td class="function_name"> -<a class="link" href="NMClient.html#nm-client-error-quark" title="nm_client_error_quark ()">nm_client_error_quark</a> <span class="c_punctuation">()</span> -</td> -</tr> -<tr> -<td class="function_type"> -<span class="returnvalue">void</span> -</td> -<td class="function_name"> -<a class="link" href="NMClient.html#nm-dns-entry-unref" title="nm_dns_entry_unref ()">nm_dns_entry_unref</a> <span class="c_punctuation">()</span> -</td> -</tr> -<tr> -<td class="function_type">const <span class="returnvalue">char</span> * -</td> -<td class="function_name"> -<a class="link" href="NMClient.html#nm-dns-entry-get-interface" title="nm_dns_entry_get_interface ()">nm_dns_entry_get_interface</a> <span class="c_punctuation">()</span> -</td> -</tr> -<tr> -<td class="function_type">const <span class="returnvalue">char</span> *const * -</td> -<td class="function_name"> -<a class="link" href="NMClient.html#nm-dns-entry-get-nameservers" title="nm_dns_entry_get_nameservers ()">nm_dns_entry_get_nameservers</a> <span class="c_punctuation">()</span> -</td> -</tr> -<tr> -<td class="function_type">const <span class="returnvalue">char</span> *const * -</td> -<td class="function_name"> -<a class="link" href="NMClient.html#nm-dns-entry-get-domains" title="nm_dns_entry_get_domains ()">nm_dns_entry_get_domains</a> <span class="c_punctuation">()</span> -</td> -</tr> -<tr> -<td class="function_type"> -<span class="returnvalue">int</span> -</td> -<td class="function_name"> -<a class="link" href="NMClient.html#nm-dns-entry-get-priority" title="nm_dns_entry_get_priority ()">nm_dns_entry_get_priority</a> <span class="c_punctuation">()</span> -</td> -</tr> -<tr> -<td class="function_type"> -<span class="returnvalue">gboolean</span> -</td> -<td class="function_name"> -<a class="link" href="NMClient.html#nm-dns-entry-get-vpn" title="nm_dns_entry_get_vpn ()">nm_dns_entry_get_vpn</a> <span class="c_punctuation">()</span> -</td> -</tr> -<tr> -<td class="function_type"> -<a class="link" href="NMClient.html" title="NMClient"><span class="returnvalue">NMClient</span></a> * -</td> -<td class="function_name"> -<a class="link" href="NMClient.html#nm-client-new" title="nm_client_new ()">nm_client_new</a> <span class="c_punctuation">()</span> -</td> -</tr> -<tr> -<td class="function_type"> -<span class="returnvalue">void</span> -</td> -<td class="function_name"> -<a class="link" href="NMClient.html#nm-client-new-async" title="nm_client_new_async ()">nm_client_new_async</a> <span class="c_punctuation">()</span> -</td> -</tr> -<tr> -<td class="function_type"> -<a class="link" href="NMClient.html" title="NMClient"><span class="returnvalue">NMClient</span></a> * -</td> -<td class="function_name"> -<a class="link" href="NMClient.html#nm-client-new-finish" title="nm_client_new_finish ()">nm_client_new_finish</a> <span class="c_punctuation">()</span> -</td> -</tr> -<tr> -<td class="function_type"> -<a class="link" href="NMClient.html#NMClientInstanceFlags" title="enum NMClientInstanceFlags"><span class="returnvalue">NMClientInstanceFlags</span></a> -</td> -<td class="function_name"> -<a class="link" href="NMClient.html#nm-client-get-instance-flags" title="nm_client_get_instance_flags ()">nm_client_get_instance_flags</a> <span class="c_punctuation">()</span> -</td> -</tr> -<tr> -<td class="function_type"> -<span class="returnvalue">GDBusConnection</span> * -</td> -<td class="function_name"> -<a class="link" href="NMClient.html#nm-client-get-dbus-connection" title="nm_client_get_dbus_connection ()">nm_client_get_dbus_connection</a> <span class="c_punctuation">()</span> -</td> -</tr> -<tr> -<td class="function_type"> -<span class="returnvalue">GMainContext</span> * -</td> -<td class="function_name"> -<a class="link" href="NMClient.html#nm-client-get-main-context" title="nm_client_get_main_context ()">nm_client_get_main_context</a> <span class="c_punctuation">()</span> -</td> -</tr> -<tr> -<td class="function_type"> -<span class="returnvalue">GObject</span> * -</td> -<td class="function_name"> -<a class="link" href="NMClient.html#nm-client-get-context-busy-watcher" title="nm_client_get_context_busy_watcher ()">nm_client_get_context_busy_watcher</a> <span class="c_punctuation">()</span> -</td> -</tr> -<tr> -<td class="function_type">const <span class="returnvalue">char</span> * -</td> -<td class="function_name"> -<a class="link" href="NMClient.html#nm-client-get-dbus-name-owner" title="nm_client_get_dbus_name_owner ()">nm_client_get_dbus_name_owner</a> <span class="c_punctuation">()</span> -</td> -</tr> -<tr> -<td class="function_type">const <span class="returnvalue">char</span> * -</td> -<td class="function_name"> -<a class="link" href="NMClient.html#nm-client-get-version" title="nm_client_get_version ()">nm_client_get_version</a> <span class="c_punctuation">()</span> -</td> -</tr> -<tr> -<td class="function_type">const <span class="returnvalue">guint32</span> * -</td> -<td class="function_name"> -<a class="link" href="NMClient.html#nm-client-get-version-info" title="nm_client_get_version_info ()">nm_client_get_version_info</a> <span class="c_punctuation">()</span> -</td> -</tr> -<tr> -<td class="function_type"> -<a class="link" href="libnm-nm-dbus-interface.html#NMState" title="enum NMState"><span class="returnvalue">NMState</span></a> -</td> -<td class="function_name"> -<a class="link" href="NMClient.html#nm-client-get-state" title="nm_client_get_state ()">nm_client_get_state</a> <span class="c_punctuation">()</span> -</td> -</tr> -<tr> -<td class="function_type"> -<span class="returnvalue">gboolean</span> -</td> -<td class="function_name"> -<a class="link" href="NMClient.html#nm-client-get-startup" title="nm_client_get_startup ()">nm_client_get_startup</a> <span class="c_punctuation">()</span> -</td> -</tr> -<tr> -<td class="function_type"> -<span class="returnvalue">gboolean</span> -</td> -<td class="function_name"> -<a class="link" href="NMClient.html#nm-client-get-nm-running" title="nm_client_get_nm_running ()">nm_client_get_nm_running</a> <span class="c_punctuation">()</span> -</td> -</tr> -<tr> -<td class="function_type"> -<a class="link" href="NMObject.html" title="NMObject"><span class="returnvalue">NMObject</span></a> * -</td> -<td class="function_name"> -<a class="link" href="NMClient.html#nm-client-get-object-by-path" title="nm_client_get_object_by_path ()">nm_client_get_object_by_path</a> <span class="c_punctuation">()</span> -</td> -</tr> -<tr> -<td class="function_type"> -<a class="link" href="libnm-nm-dbus-interface.html#NMMetered" title="enum NMMetered"><span class="returnvalue">NMMetered</span></a> -</td> -<td class="function_name"> -<a class="link" href="NMClient.html#nm-client-get-metered" title="nm_client_get_metered ()">nm_client_get_metered</a> <span class="c_punctuation">()</span> -</td> -</tr> -<tr> -<td class="function_type"> -<span class="returnvalue">gboolean</span> -</td> -<td class="function_name"> -<a class="link" href="NMClient.html#nm-client-networking-get-enabled" title="nm_client_networking_get_enabled ()">nm_client_networking_get_enabled</a> <span class="c_punctuation">()</span> -</td> -</tr> -<tr> -<td class="function_type">const <span class="returnvalue">guint32</span> * -</td> -<td class="function_name"> -<a class="link" href="NMClient.html#nm-client-get-capabilities" title="nm_client_get_capabilities ()">nm_client_get_capabilities</a> <span class="c_punctuation">()</span> -</td> -</tr> -<tr> -<td class="function_type"> -<span class="returnvalue">gboolean</span> -</td> -<td class="function_name"> -<a class="link" href="NMClient.html#nm-client-networking-set-enabled" title="nm_client_networking_set_enabled ()">nm_client_networking_set_enabled</a> <span class="c_punctuation">()</span> -</td> -</tr> -<tr> -<td class="function_type"> -<span class="returnvalue">gboolean</span> -</td> -<td class="function_name"> -<a class="link" href="NMClient.html#nm-client-wireless-get-enabled" title="nm_client_wireless_get_enabled ()">nm_client_wireless_get_enabled</a> <span class="c_punctuation">()</span> -</td> -</tr> -<tr> -<td class="function_type"> -<span class="returnvalue">void</span> -</td> -<td class="function_name"> -<a class="link" href="NMClient.html#nm-client-wireless-set-enabled" title="nm_client_wireless_set_enabled ()">nm_client_wireless_set_enabled</a> <span class="c_punctuation">()</span> -</td> -</tr> -<tr> -<td class="function_type"> -<span class="returnvalue">gboolean</span> -</td> -<td class="function_name"> -<a class="link" href="NMClient.html#nm-client-wireless-hardware-get-enabled" title="nm_client_wireless_hardware_get_enabled ()">nm_client_wireless_hardware_get_enabled</a> <span class="c_punctuation">()</span> -</td> -</tr> -<tr> -<td class="function_type"> -<span class="returnvalue">gboolean</span> -</td> -<td class="function_name"> -<a class="link" href="NMClient.html#nm-client-wwan-get-enabled" title="nm_client_wwan_get_enabled ()">nm_client_wwan_get_enabled</a> <span class="c_punctuation">()</span> -</td> -</tr> -<tr> -<td class="function_type"> -<span class="returnvalue">void</span> -</td> -<td class="function_name"> -<a class="link" href="NMClient.html#nm-client-wwan-set-enabled" title="nm_client_wwan_set_enabled ()">nm_client_wwan_set_enabled</a> <span class="c_punctuation">()</span> -</td> -</tr> -<tr> -<td class="function_type"> -<span class="returnvalue">gboolean</span> -</td> -<td class="function_name"> -<a class="link" href="NMClient.html#nm-client-wwan-hardware-get-enabled" title="nm_client_wwan_hardware_get_enabled ()">nm_client_wwan_hardware_get_enabled</a> <span class="c_punctuation">()</span> -</td> -</tr> -<tr> -<td class="function_type"> -<span class="returnvalue">gboolean</span> -</td> -<td class="function_name"> -<a class="link" href="NMClient.html#nm-client-wimax-get-enabled" title="nm_client_wimax_get_enabled ()">nm_client_wimax_get_enabled</a> <span class="c_punctuation">()</span> -</td> -</tr> -<tr> -<td class="function_type"> -<span class="returnvalue">void</span> -</td> -<td class="function_name"> -<a class="link" href="NMClient.html#nm-client-wimax-set-enabled" title="nm_client_wimax_set_enabled ()">nm_client_wimax_set_enabled</a> <span class="c_punctuation">()</span> -</td> -</tr> -<tr> -<td class="function_type"> -<span class="returnvalue">gboolean</span> -</td> -<td class="function_name"> -<a class="link" href="NMClient.html#nm-client-wimax-hardware-get-enabled" title="nm_client_wimax_hardware_get_enabled ()">nm_client_wimax_hardware_get_enabled</a> <span class="c_punctuation">()</span> -</td> -</tr> -<tr> -<td class="function_type"> -<a class="link" href="libnm-nm-dbus-interface.html#NMRadioFlags" title="enum NMRadioFlags"><span class="returnvalue">NMRadioFlags</span></a> -</td> -<td class="function_name"> -<a class="link" href="NMClient.html#nm-client-get-radio-flags" title="nm_client_get_radio_flags ()">nm_client_get_radio_flags</a> <span class="c_punctuation">()</span> -</td> -</tr> -<tr> -<td class="function_type"> -<span class="returnvalue">gboolean</span> -</td> -<td class="function_name"> -<a class="link" href="NMClient.html#nm-client-connectivity-check-get-available" title="nm_client_connectivity_check_get_available ()">nm_client_connectivity_check_get_available</a> <span class="c_punctuation">()</span> -</td> -</tr> -<tr> -<td class="function_type"> -<span class="returnvalue">gboolean</span> -</td> -<td class="function_name"> -<a class="link" href="NMClient.html#nm-client-connectivity-check-get-enabled" title="nm_client_connectivity_check_get_enabled ()">nm_client_connectivity_check_get_enabled</a> <span class="c_punctuation">()</span> -</td> -</tr> -<tr> -<td class="function_type"> -<span class="returnvalue">void</span> -</td> -<td class="function_name"> -<a class="link" href="NMClient.html#nm-client-connectivity-check-set-enabled" title="nm_client_connectivity_check_set_enabled ()">nm_client_connectivity_check_set_enabled</a> <span class="c_punctuation">()</span> -</td> -</tr> -<tr> -<td class="function_type">const <span class="returnvalue">char</span> * -</td> -<td class="function_name"> -<a class="link" href="NMClient.html#nm-client-connectivity-check-get-uri" title="nm_client_connectivity_check_get_uri ()">nm_client_connectivity_check_get_uri</a> <span class="c_punctuation">()</span> -</td> -</tr> -<tr> -<td class="function_type"> -<span class="returnvalue">gboolean</span> -</td> -<td class="function_name"> -<a class="link" href="NMClient.html#nm-client-get-logging" title="nm_client_get_logging ()">nm_client_get_logging</a> <span class="c_punctuation">()</span> -</td> -</tr> -<tr> -<td class="function_type"> -<span class="returnvalue">gboolean</span> -</td> -<td class="function_name"> -<a class="link" href="NMClient.html#nm-client-set-logging" title="nm_client_set_logging ()">nm_client_set_logging</a> <span class="c_punctuation">()</span> -</td> -</tr> -<tr> -<td class="function_type"> -<a class="link" href="libnm-nm-dbus-interface.html#NMClientPermissionResult" title="enum NMClientPermissionResult"><span class="returnvalue">NMClientPermissionResult</span></a> -</td> -<td class="function_name"> -<a class="link" href="NMClient.html#nm-client-get-permission-result" title="nm_client_get_permission_result ()">nm_client_get_permission_result</a> <span class="c_punctuation">()</span> -</td> -</tr> -<tr> -<td class="function_type"> -<a class="link" href="libnm-nm-dbus-interface.html#NMTernary" title="enum NMTernary"><span class="returnvalue">NMTernary</span></a> -</td> -<td class="function_name"> -<a class="link" href="NMClient.html#nm-client-get-permissions-state" title="nm_client_get_permissions_state ()">nm_client_get_permissions_state</a> <span class="c_punctuation">()</span> -</td> -</tr> -<tr> -<td class="function_type"> -<a class="link" href="libnm-nm-dbus-interface.html#NMConnectivityState" title="enum NMConnectivityState"><span class="returnvalue">NMConnectivityState</span></a> -</td> -<td class="function_name"> -<a class="link" href="NMClient.html#nm-client-get-connectivity" title="nm_client_get_connectivity ()">nm_client_get_connectivity</a> <span class="c_punctuation">()</span> -</td> -</tr> -<tr> -<td class="function_type"> -<a class="link" href="libnm-nm-dbus-interface.html#NMConnectivityState" title="enum NMConnectivityState"><span class="returnvalue">NMConnectivityState</span></a> -</td> -<td class="function_name"> -<a class="link" href="NMClient.html#nm-client-check-connectivity" title="nm_client_check_connectivity ()">nm_client_check_connectivity</a> <span class="c_punctuation">()</span> -</td> -</tr> -<tr> -<td class="function_type"> -<span class="returnvalue">void</span> -</td> -<td class="function_name"> -<a class="link" href="NMClient.html#nm-client-check-connectivity-async" title="nm_client_check_connectivity_async ()">nm_client_check_connectivity_async</a> <span class="c_punctuation">()</span> -</td> -</tr> -<tr> -<td class="function_type"> -<a class="link" href="libnm-nm-dbus-interface.html#NMConnectivityState" title="enum NMConnectivityState"><span class="returnvalue">NMConnectivityState</span></a> -</td> -<td class="function_name"> -<a class="link" href="NMClient.html#nm-client-check-connectivity-finish" title="nm_client_check_connectivity_finish ()">nm_client_check_connectivity_finish</a> <span class="c_punctuation">()</span> -</td> -</tr> -<tr> -<td class="function_type"> -<span class="returnvalue">gboolean</span> -</td> -<td class="function_name"> -<a class="link" href="NMClient.html#nm-client-save-hostname" title="nm_client_save_hostname ()">nm_client_save_hostname</a> <span class="c_punctuation">()</span> -</td> -</tr> -<tr> -<td class="function_type"> -<span class="returnvalue">void</span> -</td> -<td class="function_name"> -<a class="link" href="NMClient.html#nm-client-save-hostname-async" title="nm_client_save_hostname_async ()">nm_client_save_hostname_async</a> <span class="c_punctuation">()</span> -</td> -</tr> -<tr> -<td class="function_type"> -<span class="returnvalue">gboolean</span> -</td> -<td class="function_name"> -<a class="link" href="NMClient.html#nm-client-save-hostname-finish" title="nm_client_save_hostname_finish ()">nm_client_save_hostname_finish</a> <span class="c_punctuation">()</span> -</td> -</tr> -<tr> -<td class="function_type">const <span class="returnvalue">GPtrArray</span> * -</td> -<td class="function_name"> -<a class="link" href="NMClient.html#nm-client-get-devices" title="nm_client_get_devices ()">nm_client_get_devices</a> <span class="c_punctuation">()</span> -</td> -</tr> -<tr> -<td class="function_type">const <span class="returnvalue">GPtrArray</span> * -</td> -<td class="function_name"> -<a class="link" href="NMClient.html#nm-client-get-all-devices" title="nm_client_get_all_devices ()">nm_client_get_all_devices</a> <span class="c_punctuation">()</span> -</td> -</tr> -<tr> -<td class="function_type"> -<a class="link" href="NMDevice.html" title="NMDevice"><span class="returnvalue">NMDevice</span></a> * -</td> -<td class="function_name"> -<a class="link" href="NMClient.html#nm-client-get-device-by-path" title="nm_client_get_device_by_path ()">nm_client_get_device_by_path</a> <span class="c_punctuation">()</span> -</td> -</tr> -<tr> -<td class="function_type"> -<a class="link" href="NMDevice.html" title="NMDevice"><span class="returnvalue">NMDevice</span></a> * -</td> -<td class="function_name"> -<a class="link" href="NMClient.html#nm-client-get-device-by-iface" title="nm_client_get_device_by_iface ()">nm_client_get_device_by_iface</a> <span class="c_punctuation">()</span> -</td> -</tr> -<tr> -<td class="function_type">const <span class="returnvalue">GPtrArray</span> * -</td> -<td class="function_name"> -<a class="link" href="NMClient.html#nm-client-get-active-connections" title="nm_client_get_active_connections ()">nm_client_get_active_connections</a> <span class="c_punctuation">()</span> -</td> -</tr> -<tr> -<td class="function_type"> -<a class="link" href="NMActiveConnection.html" title="NMActiveConnection"><span class="returnvalue">NMActiveConnection</span></a> * -</td> -<td class="function_name"> -<a class="link" href="NMClient.html#nm-client-get-primary-connection" title="nm_client_get_primary_connection ()">nm_client_get_primary_connection</a> <span class="c_punctuation">()</span> -</td> -</tr> -<tr> -<td class="function_type"> -<a class="link" href="NMActiveConnection.html" title="NMActiveConnection"><span class="returnvalue">NMActiveConnection</span></a> * -</td> -<td class="function_name"> -<a class="link" href="NMClient.html#nm-client-get-activating-connection" title="nm_client_get_activating_connection ()">nm_client_get_activating_connection</a> <span class="c_punctuation">()</span> -</td> -</tr> -<tr> -<td class="function_type"> -<span class="returnvalue">void</span> -</td> -<td class="function_name"> -<a class="link" href="NMClient.html#nm-client-activate-connection-async" title="nm_client_activate_connection_async ()">nm_client_activate_connection_async</a> <span class="c_punctuation">()</span> -</td> -</tr> -<tr> -<td class="function_type"> -<a class="link" href="NMActiveConnection.html" title="NMActiveConnection"><span class="returnvalue">NMActiveConnection</span></a> * -</td> -<td class="function_name"> -<a class="link" href="NMClient.html#nm-client-activate-connection-finish" title="nm_client_activate_connection_finish ()">nm_client_activate_connection_finish</a> <span class="c_punctuation">()</span> -</td> -</tr> -<tr> -<td class="function_type"> -<span class="returnvalue">void</span> -</td> -<td class="function_name"> -<a class="link" href="NMClient.html#nm-client-add-and-activate-connection-async" title="nm_client_add_and_activate_connection_async ()">nm_client_add_and_activate_connection_async</a> <span class="c_punctuation">()</span> -</td> -</tr> -<tr> -<td class="function_type"> -<a class="link" href="NMActiveConnection.html" title="NMActiveConnection"><span class="returnvalue">NMActiveConnection</span></a> * -</td> -<td class="function_name"> -<a class="link" href="NMClient.html#nm-client-add-and-activate-connection-finish" title="nm_client_add_and_activate_connection_finish ()">nm_client_add_and_activate_connection_finish</a> <span class="c_punctuation">()</span> -</td> -</tr> -<tr> -<td class="function_type"> -<span class="returnvalue">void</span> -</td> -<td class="function_name"> -<a class="link" href="NMClient.html#nm-client-add-and-activate-connection2" title="nm_client_add_and_activate_connection2 ()">nm_client_add_and_activate_connection2</a> <span class="c_punctuation">()</span> -</td> -</tr> -<tr> -<td class="function_type"> -<a class="link" href="NMActiveConnection.html" title="NMActiveConnection"><span class="returnvalue">NMActiveConnection</span></a> * -</td> -<td class="function_name"> -<a class="link" href="NMClient.html#nm-client-add-and-activate-connection2-finish" title="nm_client_add_and_activate_connection2_finish ()">nm_client_add_and_activate_connection2_finish</a> <span class="c_punctuation">()</span> -</td> -</tr> -<tr> -<td class="function_type"> -<span class="returnvalue">gboolean</span> -</td> -<td class="function_name"> -<a class="link" href="NMClient.html#nm-client-deactivate-connection" title="nm_client_deactivate_connection ()">nm_client_deactivate_connection</a> <span class="c_punctuation">()</span> -</td> -</tr> -<tr> -<td class="function_type"> -<span class="returnvalue">void</span> -</td> -<td class="function_name"> -<a class="link" href="NMClient.html#nm-client-deactivate-connection-async" title="nm_client_deactivate_connection_async ()">nm_client_deactivate_connection_async</a> <span class="c_punctuation">()</span> -</td> -</tr> -<tr> -<td class="function_type"> -<span class="returnvalue">gboolean</span> -</td> -<td class="function_name"> -<a class="link" href="NMClient.html#nm-client-deactivate-connection-finish" title="nm_client_deactivate_connection_finish ()">nm_client_deactivate_connection_finish</a> <span class="c_punctuation">()</span> -</td> -</tr> -<tr> -<td class="function_type">const <span class="returnvalue">GPtrArray</span> * -</td> -<td class="function_name"> -<a class="link" href="NMClient.html#nm-client-get-connections" title="nm_client_get_connections ()">nm_client_get_connections</a> <span class="c_punctuation">()</span> -</td> -</tr> -<tr> -<td class="function_type"> -<a class="link" href="NMRemoteConnection.html" title="NMRemoteConnection"><span class="returnvalue">NMRemoteConnection</span></a> * -</td> -<td class="function_name"> -<a class="link" href="NMClient.html#nm-client-get-connection-by-id" title="nm_client_get_connection_by_id ()">nm_client_get_connection_by_id</a> <span class="c_punctuation">()</span> -</td> -</tr> -<tr> -<td class="function_type"> -<a class="link" href="NMRemoteConnection.html" title="NMRemoteConnection"><span class="returnvalue">NMRemoteConnection</span></a> * -</td> -<td class="function_name"> -<a class="link" href="NMClient.html#nm-client-get-connection-by-path" title="nm_client_get_connection_by_path ()">nm_client_get_connection_by_path</a> <span class="c_punctuation">()</span> -</td> -</tr> -<tr> -<td class="function_type"> -<a class="link" href="NMRemoteConnection.html" title="NMRemoteConnection"><span class="returnvalue">NMRemoteConnection</span></a> * -</td> -<td class="function_name"> -<a class="link" href="NMClient.html#nm-client-get-connection-by-uuid" title="nm_client_get_connection_by_uuid ()">nm_client_get_connection_by_uuid</a> <span class="c_punctuation">()</span> -</td> -</tr> -<tr> -<td class="function_type"> -<span class="returnvalue">void</span> -</td> -<td class="function_name"> -<a class="link" href="NMClient.html#nm-client-add-connection-async" title="nm_client_add_connection_async ()">nm_client_add_connection_async</a> <span class="c_punctuation">()</span> -</td> -</tr> -<tr> -<td class="function_type"> -<a class="link" href="NMRemoteConnection.html" title="NMRemoteConnection"><span class="returnvalue">NMRemoteConnection</span></a> * -</td> -<td class="function_name"> -<a class="link" href="NMClient.html#nm-client-add-connection-finish" title="nm_client_add_connection_finish ()">nm_client_add_connection_finish</a> <span class="c_punctuation">()</span> -</td> -</tr> -<tr> -<td class="function_type"> -<span class="returnvalue">void</span> -</td> -<td class="function_name"> -<a class="link" href="NMClient.html#nm-client-add-connection2" title="nm_client_add_connection2 ()">nm_client_add_connection2</a> <span class="c_punctuation">()</span> -</td> -</tr> -<tr> -<td class="function_type"> -<a class="link" href="NMRemoteConnection.html" title="NMRemoteConnection"><span class="returnvalue">NMRemoteConnection</span></a> * -</td> -<td class="function_name"> -<a class="link" href="NMClient.html#nm-client-add-connection2-finish" title="nm_client_add_connection2_finish ()">nm_client_add_connection2_finish</a> <span class="c_punctuation">()</span> -</td> -</tr> -<tr> -<td class="function_type"> -<span class="returnvalue">gboolean</span> -</td> -<td class="function_name"> -<a class="link" href="NMClient.html#nm-client-load-connections" title="nm_client_load_connections ()">nm_client_load_connections</a> <span class="c_punctuation">()</span> -</td> -</tr> -<tr> -<td class="function_type"> -<span class="returnvalue">void</span> -</td> -<td class="function_name"> -<a class="link" href="NMClient.html#nm-client-load-connections-async" title="nm_client_load_connections_async ()">nm_client_load_connections_async</a> <span class="c_punctuation">()</span> -</td> -</tr> -<tr> -<td class="function_type"> -<span class="returnvalue">gboolean</span> -</td> -<td class="function_name"> -<a class="link" href="NMClient.html#nm-client-load-connections-finish" title="nm_client_load_connections_finish ()">nm_client_load_connections_finish</a> <span class="c_punctuation">()</span> -</td> -</tr> -<tr> -<td class="function_type"> -<span class="returnvalue">gboolean</span> -</td> -<td class="function_name"> -<a class="link" href="NMClient.html#nm-client-reload-connections" title="nm_client_reload_connections ()">nm_client_reload_connections</a> <span class="c_punctuation">()</span> -</td> -</tr> -<tr> -<td class="function_type"> -<span class="returnvalue">void</span> -</td> -<td class="function_name"> -<a class="link" href="NMClient.html#nm-client-reload-connections-async" title="nm_client_reload_connections_async ()">nm_client_reload_connections_async</a> <span class="c_punctuation">()</span> -</td> -</tr> -<tr> -<td class="function_type"> -<span class="returnvalue">gboolean</span> -</td> -<td class="function_name"> -<a class="link" href="NMClient.html#nm-client-reload-connections-finish" title="nm_client_reload_connections_finish ()">nm_client_reload_connections_finish</a> <span class="c_punctuation">()</span> -</td> -</tr> -<tr> -<td class="function_type">const <span class="returnvalue">char</span> * -</td> -<td class="function_name"> -<a class="link" href="NMClient.html#nm-client-get-dns-mode" title="nm_client_get_dns_mode ()">nm_client_get_dns_mode</a> <span class="c_punctuation">()</span> -</td> -</tr> -<tr> -<td class="function_type">const <span class="returnvalue">char</span> * -</td> -<td class="function_name"> -<a class="link" href="NMClient.html#nm-client-get-dns-rc-manager" title="nm_client_get_dns_rc_manager ()">nm_client_get_dns_rc_manager</a> <span class="c_punctuation">()</span> -</td> -</tr> -<tr> -<td class="function_type">const <span class="returnvalue">GPtrArray</span> * -</td> -<td class="function_name"> -<a class="link" href="NMClient.html#nm-client-get-dns-configuration" title="nm_client_get_dns_configuration ()">nm_client_get_dns_configuration</a> <span class="c_punctuation">()</span> -</td> -</tr> -<tr> -<td class="function_type">const <span class="returnvalue">GPtrArray</span> * -</td> -<td class="function_name"> -<a class="link" href="NMClient.html#nm-client-get-checkpoints" title="nm_client_get_checkpoints ()">nm_client_get_checkpoints</a> <span class="c_punctuation">()</span> -</td> -</tr> -<tr> -<td class="function_type"> -<span class="returnvalue">void</span> -</td> -<td class="function_name"> -<a class="link" href="NMClient.html#nm-client-checkpoint-create" title="nm_client_checkpoint_create ()">nm_client_checkpoint_create</a> <span class="c_punctuation">()</span> -</td> -</tr> -<tr> -<td class="function_type"> -<a class="link" href="NMCheckpoint.html" title="NMCheckpoint"><span class="returnvalue">NMCheckpoint</span></a> * -</td> -<td class="function_name"> -<a class="link" href="NMClient.html#nm-client-checkpoint-create-finish" title="nm_client_checkpoint_create_finish ()">nm_client_checkpoint_create_finish</a> <span class="c_punctuation">()</span> -</td> -</tr> -<tr> -<td class="function_type"> -<span class="returnvalue">void</span> -</td> -<td class="function_name"> -<a class="link" href="NMClient.html#nm-client-checkpoint-destroy" title="nm_client_checkpoint_destroy ()">nm_client_checkpoint_destroy</a> <span class="c_punctuation">()</span> -</td> -</tr> -<tr> -<td class="function_type"> -<span class="returnvalue">gboolean</span> -</td> -<td class="function_name"> -<a class="link" href="NMClient.html#nm-client-checkpoint-destroy-finish" title="nm_client_checkpoint_destroy_finish ()">nm_client_checkpoint_destroy_finish</a> <span class="c_punctuation">()</span> -</td> -</tr> -<tr> -<td class="function_type"> -<span class="returnvalue">void</span> -</td> -<td class="function_name"> -<a class="link" href="NMClient.html#nm-client-checkpoint-rollback" title="nm_client_checkpoint_rollback ()">nm_client_checkpoint_rollback</a> <span class="c_punctuation">()</span> -</td> -</tr> -<tr> -<td class="function_type"> -<span class="returnvalue">GHashTable</span> * -</td> -<td class="function_name"> -<a class="link" href="NMClient.html#nm-client-checkpoint-rollback-finish" title="nm_client_checkpoint_rollback_finish ()">nm_client_checkpoint_rollback_finish</a> <span class="c_punctuation">()</span> -</td> -</tr> -<tr> -<td class="function_type"> -<span class="returnvalue">void</span> -</td> -<td class="function_name"> -<a class="link" href="NMClient.html#nm-client-checkpoint-adjust-rollback-timeout" title="nm_client_checkpoint_adjust_rollback_timeout ()">nm_client_checkpoint_adjust_rollback_timeout</a> <span class="c_punctuation">()</span> -</td> -</tr> -<tr> -<td class="function_type"> -<span class="returnvalue">gboolean</span> -</td> -<td class="function_name"> -<a class="link" href="NMClient.html#nm-client-checkpoint-adjust-rollback-timeout-finish" title="nm_client_checkpoint_adjust_rollback_timeout_finish ()">nm_client_checkpoint_adjust_rollback_timeout_finish</a> <span class="c_punctuation">()</span> -</td> -</tr> -<tr> -<td class="function_type"> -<span class="returnvalue">void</span> -</td> -<td class="function_name"> -<a class="link" href="NMClient.html#nm-client-reload" title="nm_client_reload ()">nm_client_reload</a> <span class="c_punctuation">()</span> -</td> -</tr> -<tr> -<td class="function_type"> -<span class="returnvalue">gboolean</span> -</td> -<td class="function_name"> -<a class="link" href="NMClient.html#nm-client-reload-finish" title="nm_client_reload_finish ()">nm_client_reload_finish</a> <span class="c_punctuation">()</span> -</td> -</tr> -<tr> -<td class="function_type"> -<span class="returnvalue">void</span> -</td> -<td class="function_name"> -<a class="link" href="NMClient.html#nm-client-dbus-call" title="nm_client_dbus_call ()">nm_client_dbus_call</a> <span class="c_punctuation">()</span> -</td> -</tr> -<tr> -<td class="function_type"> -<span class="returnvalue">GVariant</span> * -</td> -<td class="function_name"> -<a class="link" href="NMClient.html#nm-client-dbus-call-finish" title="nm_client_dbus_call_finish ()">nm_client_dbus_call_finish</a> <span class="c_punctuation">()</span> -</td> -</tr> -<tr> -<td class="function_type"> -<span class="returnvalue">void</span> -</td> -<td class="function_name"> -<a class="link" href="NMClient.html#nm-client-dbus-set-property" title="nm_client_dbus_set_property ()">nm_client_dbus_set_property</a> <span class="c_punctuation">()</span> -</td> -</tr> -<tr> -<td class="function_type"> -<span class="returnvalue">gboolean</span> -</td> -<td class="function_name"> -<a class="link" href="NMClient.html#nm-client-dbus-set-property-finish" title="nm_client_dbus_set_property_finish ()">nm_client_dbus_set_property_finish</a> <span class="c_punctuation">()</span> -</td> -</tr> -<tr> -<td class="function_type"> -<span class="returnvalue">void</span> -</td> -<td class="function_name"> -<a class="link" href="NMClient.html#nm-utils-print" title="nm_utils_print ()">nm_utils_print</a> <span class="c_punctuation">()</span> -</td> -</tr> -<tr> -<td class="function_type"> -<span class="returnvalue">gboolean</span> -</td> -<td class="function_name"> -<a class="link" href="NMClient.html#nm-utils-file-is-certificate" title="nm_utils_file_is_certificate ()">nm_utils_file_is_certificate</a> <span class="c_punctuation">()</span> -</td> -</tr> -<tr> -<td class="function_type"> -<span class="returnvalue">gboolean</span> -</td> -<td class="function_name"> -<a class="link" href="NMClient.html#nm-utils-file-is-private-key" title="nm_utils_file_is_private_key ()">nm_utils_file_is_private_key</a> <span class="c_punctuation">()</span> -</td> -</tr> -<tr> -<td class="function_type"> -<span class="returnvalue">gboolean</span> -</td> -<td class="function_name"> -<a class="link" href="NMClient.html#nm-utils-file-is-pkcs12" title="nm_utils_file_is_pkcs12 ()">nm_utils_file_is_pkcs12</a> <span class="c_punctuation">()</span> -</td> -</tr> -<tr> -<td class="function_type"> -<span class="returnvalue">void</span> -</td> -<td class="function_name"> -<a class="link" href="NMClient.html#nm-client-wait-shutdown" title="nm_client_wait_shutdown ()">nm_client_wait_shutdown</a> <span class="c_punctuation">()</span> -</td> -</tr> -<tr> -<td class="function_type"> -<span class="returnvalue">gboolean</span> -</td> -<td class="function_name"> -<a class="link" href="NMClient.html#nm-client-wait-shutdown-finish" title="nm_client_wait_shutdown_finish ()">nm_client_wait_shutdown_finish</a> <span class="c_punctuation">()</span> -</td> -</tr> -</tbody> -</table></div> -</div> -<div class="refsect1"> -<a name="NMClient.properties"></a><h2>Properties</h2> -<div class="informaltable"><table class="informaltable" border="0"> -<colgroup> -<col width="150px" class="properties_type"> -<col width="300px" class="properties_name"> -<col width="200px" class="properties_flags"> -</colgroup> -<tbody> -<tr> -<td class="property_type"> -<a class="link" href="NMActiveConnection.html" title="NMActiveConnection"><span class="type">NMActiveConnection</span></a> *</td> -<td class="property_name"><a class="link" href="NMClient.html#NMClient--activating-connection" title="The “activating-connection” property">activating-connection</a></td> -<td class="property_flags">Read</td> -</tr> -<tr> -<td class="property_type"> -<span class="type">GPtrArray</span> *</td> -<td class="property_name"><a class="link" href="NMClient.html#NMClient--active-connections" title="The “active-connections” property">active-connections</a></td> -<td class="property_flags">Read</td> -</tr> -<tr> -<td class="property_type"> -<span class="type">GPtrArray</span> *</td> -<td class="property_name"><a class="link" href="NMClient.html#NMClient--all-devices" title="The “all-devices” property">all-devices</a></td> -<td class="property_flags">Read</td> -</tr> -<tr> -<td class="property_type"><span class="type">gboolean</span></td> -<td class="property_name"><a class="link" href="NMClient.html#NMClient--can-modify" title="The “can-modify” property">can-modify</a></td> -<td class="property_flags">Read</td> -</tr> -<tr> -<td class="property_type"> -<span class="type">GArray</span> *</td> -<td class="property_name"><a class="link" href="NMClient.html#NMClient--capabilities" title="The “capabilities” property">capabilities</a></td> -<td class="property_flags">Read</td> -</tr> -<tr> -<td class="property_type"> -<span class="type">GPtrArray</span> *</td> -<td class="property_name"><a class="link" href="NMClient.html#NMClient--checkpoints" title="The “checkpoints” property">checkpoints</a></td> -<td class="property_flags">Read</td> -</tr> -<tr> -<td class="property_type"> -<span class="type">GPtrArray</span> *</td> -<td class="property_name"><a class="link" href="NMClient.html#NMClient--connections" title="The “connections” property">connections</a></td> -<td class="property_flags">Read</td> -</tr> -<tr> -<td class="property_type"><a class="link" href="libnm-nm-dbus-interface.html#NMConnectivityState" title="enum NMConnectivityState"><span class="type">NMConnectivityState</span></a></td> -<td class="property_name"><a class="link" href="NMClient.html#NMClient--connectivity" title="The “connectivity” property">connectivity</a></td> -<td class="property_flags">Read</td> -</tr> -<tr> -<td class="property_type"><span class="type">gboolean</span></td> -<td class="property_name"><a class="link" href="NMClient.html#NMClient--connectivity-check-available" title="The “connectivity-check-available” property">connectivity-check-available</a></td> -<td class="property_flags">Read</td> -</tr> -<tr> -<td class="property_type"><span class="type">gboolean</span></td> -<td class="property_name"><a class="link" href="NMClient.html#NMClient--connectivity-check-enabled" title="The “connectivity-check-enabled” property">connectivity-check-enabled</a></td> -<td class="property_flags">Read / Write</td> -</tr> -<tr> -<td class="property_type"> -<span class="type">char</span> *</td> -<td class="property_name"><a class="link" href="NMClient.html#NMClient--connectivity-check-uri" title="The “connectivity-check-uri” property">connectivity-check-uri</a></td> -<td class="property_flags">Read</td> -</tr> -<tr> -<td class="property_type"> -<span class="type">GDBusConnection</span> *</td> -<td class="property_name"><a class="link" href="NMClient.html#NMClient--dbus-connection" title="The “dbus-connection” property">dbus-connection</a></td> -<td class="property_flags">Read / Write / Construct Only</td> -</tr> -<tr> -<td class="property_type"> -<span class="type">char</span> *</td> -<td class="property_name"><a class="link" href="NMClient.html#NMClient--dbus-name-owner" title="The “dbus-name-owner” property">dbus-name-owner</a></td> -<td class="property_flags">Read</td> -</tr> -<tr> -<td class="property_type"> -<span class="type">GPtrArray</span> *</td> -<td class="property_name"><a class="link" href="NMClient.html#NMClient--devices" title="The “devices” property">devices</a></td> -<td class="property_flags">Read</td> -</tr> -<tr> -<td class="property_type"> -<span class="type">GPtrArray</span> *</td> -<td class="property_name"><a class="link" href="NMClient.html#NMClient--dns-configuration" title="The “dns-configuration” property">dns-configuration</a></td> -<td class="property_flags">Read</td> -</tr> -<tr> -<td class="property_type"> -<span class="type">char</span> *</td> -<td class="property_name"><a class="link" href="NMClient.html#NMClient--dns-mode" title="The “dns-mode” property">dns-mode</a></td> -<td class="property_flags">Read</td> -</tr> -<tr> -<td class="property_type"> -<span class="type">char</span> *</td> -<td class="property_name"><a class="link" href="NMClient.html#NMClient--dns-rc-manager" title="The “dns-rc-manager” property">dns-rc-manager</a></td> -<td class="property_flags">Read</td> -</tr> -<tr> -<td class="property_type"> -<span class="type">char</span> *</td> -<td class="property_name"><a class="link" href="NMClient.html#NMClient--hostname" title="The “hostname” property">hostname</a></td> -<td class="property_flags">Read</td> -</tr> -<tr> -<td class="property_type"><span class="type">guint</span></td> -<td class="property_name"><a class="link" href="NMClient.html#NMClient--instance-flags" title="The “instance-flags” property">instance-flags</a></td> -<td class="property_flags">Read / Write / Construct</td> -</tr> -<tr> -<td class="property_type"><span class="type">guint</span></td> -<td class="property_name"><a class="link" href="NMClient.html#NMClient--metered" title="The “metered” property">metered</a></td> -<td class="property_flags">Read</td> -</tr> -<tr> -<td class="property_type"><span class="type">gboolean</span></td> -<td class="property_name"><a class="link" href="NMClient.html#NMClient--networking-enabled" title="The “networking-enabled” property">networking-enabled</a></td> -<td class="property_flags">Read / Write</td> -</tr> -<tr> -<td class="property_type"><span class="type">gboolean</span></td> -<td class="property_name"><a class="link" href="NMClient.html#NMClient--nm-running" title="The “nm-running” property">nm-running</a></td> -<td class="property_flags">Read</td> -</tr> -<tr> -<td class="property_type"><a class="link" href="libnm-nm-dbus-interface.html#NMTernary" title="enum NMTernary"><span class="type">NMTernary</span></a></td> -<td class="property_name"><a class="link" href="NMClient.html#NMClient--permissions-state" title="The “permissions-state” property">permissions-state</a></td> -<td class="property_flags">Read</td> -</tr> -<tr> -<td class="property_type"> -<a class="link" href="NMActiveConnection.html" title="NMActiveConnection"><span class="type">NMActiveConnection</span></a> *</td> -<td class="property_name"><a class="link" href="NMClient.html#NMClient--primary-connection" title="The “primary-connection” property">primary-connection</a></td> -<td class="property_flags">Read</td> -</tr> -<tr> -<td class="property_type"><span class="type">guint</span></td> -<td class="property_name"><a class="link" href="NMClient.html#NMClient--radio-flags" title="The “radio-flags” property">radio-flags</a></td> -<td class="property_flags">Read</td> -</tr> -<tr> -<td class="property_type"><span class="type">gboolean</span></td> -<td class="property_name"><a class="link" href="NMClient.html#NMClient--startup" title="The “startup” property">startup</a></td> -<td class="property_flags">Read</td> -</tr> -<tr> -<td class="property_type"><a class="link" href="libnm-nm-dbus-interface.html#NMState" title="enum NMState"><span class="type">NMState</span></a></td> -<td class="property_name"><a class="link" href="NMClient.html#NMClient--state" title="The “state” property">state</a></td> -<td class="property_flags">Read</td> -</tr> -<tr> -<td class="property_type"> -<span class="type">char</span> *</td> -<td class="property_name"><a class="link" href="NMClient.html#NMClient--version" title="The “version” property">version</a></td> -<td class="property_flags">Read</td> -</tr> -<tr> -<td class="property_type"> -<span class="type">GArray</span> *</td> -<td class="property_name"><a class="link" href="NMClient.html#NMClient--version-info" title="The “version-info” property">version-info</a></td> -<td class="property_flags">Read</td> -</tr> -<tr> -<td class="property_type"><span class="type">gboolean</span></td> -<td class="property_name"><a class="link" href="NMClient.html#NMClient--wimax-enabled" title="The “wimax-enabled” property">wimax-enabled</a></td> -<td class="property_flags">Read / Write</td> -</tr> -<tr> -<td class="property_type"><span class="type">gboolean</span></td> -<td class="property_name"><a class="link" href="NMClient.html#NMClient--wimax-hardware-enabled" title="The “wimax-hardware-enabled” property">wimax-hardware-enabled</a></td> -<td class="property_flags">Read</td> -</tr> -<tr> -<td class="property_type"><span class="type">gboolean</span></td> -<td class="property_name"><a class="link" href="NMClient.html#NMClient--wireless-enabled" title="The “wireless-enabled” property">wireless-enabled</a></td> -<td class="property_flags">Read / Write</td> -</tr> -<tr> -<td class="property_type"><span class="type">gboolean</span></td> -<td class="property_name"><a class="link" href="NMClient.html#NMClient--wireless-hardware-enabled" title="The “wireless-hardware-enabled” property">wireless-hardware-enabled</a></td> -<td class="property_flags">Read</td> -</tr> -<tr> -<td class="property_type"><span class="type">gboolean</span></td> -<td class="property_name"><a class="link" href="NMClient.html#NMClient--wwan-enabled" title="The “wwan-enabled” property">wwan-enabled</a></td> -<td class="property_flags">Read / Write</td> -</tr> -<tr> -<td class="property_type"><span class="type">gboolean</span></td> -<td class="property_name"><a class="link" href="NMClient.html#NMClient--wwan-hardware-enabled" title="The “wwan-hardware-enabled” property">wwan-hardware-enabled</a></td> -<td class="property_flags">Read</td> -</tr> -</tbody> -</table></div> -</div> -<div class="refsect1"> -<a name="NMClient.signals"></a><h2>Signals</h2> -<div class="informaltable"><table class="informaltable" border="0"> -<colgroup> -<col width="150px" class="signal_proto_type"> -<col width="300px" class="signal_proto_name"> -<col width="200px" class="signal_proto_flags"> -</colgroup> -<tbody> -<tr> -<td class="signal_type"><span class="returnvalue">void</span></td> -<td class="signal_name"><a class="link" href="NMClient.html#NMClient-active-connection-added" title="The “active-connection-added” signal">active-connection-added</a></td> -<td class="signal_flags">Run First</td> -</tr> -<tr> -<td class="signal_type"><span class="returnvalue">void</span></td> -<td class="signal_name"><a class="link" href="NMClient.html#NMClient-active-connection-removed" title="The “active-connection-removed” signal">active-connection-removed</a></td> -<td class="signal_flags">Run First</td> -</tr> -<tr> -<td class="signal_type"><span class="returnvalue">void</span></td> -<td class="signal_name"><a class="link" href="NMClient.html#NMClient-any-device-added" title="The “any-device-added” signal">any-device-added</a></td> -<td class="signal_flags">Run First</td> -</tr> -<tr> -<td class="signal_type"><span class="returnvalue">void</span></td> -<td class="signal_name"><a class="link" href="NMClient.html#NMClient-any-device-removed" title="The “any-device-removed” signal">any-device-removed</a></td> -<td class="signal_flags">Run First</td> -</tr> -<tr> -<td class="signal_type"><span class="returnvalue">void</span></td> -<td class="signal_name"><a class="link" href="NMClient.html#NMClient-connection-added" title="The “connection-added” signal">connection-added</a></td> -<td class="signal_flags">Run First</td> -</tr> -<tr> -<td class="signal_type"><span class="returnvalue">void</span></td> -<td class="signal_name"><a class="link" href="NMClient.html#NMClient-connection-removed" title="The “connection-removed” signal">connection-removed</a></td> -<td class="signal_flags">Run First</td> -</tr> -<tr> -<td class="signal_type"><span class="returnvalue">void</span></td> -<td class="signal_name"><a class="link" href="NMClient.html#NMClient-device-added" title="The “device-added” signal">device-added</a></td> -<td class="signal_flags">Run First</td> -</tr> -<tr> -<td class="signal_type"><span class="returnvalue">void</span></td> -<td class="signal_name"><a class="link" href="NMClient.html#NMClient-device-removed" title="The “device-removed” signal">device-removed</a></td> -<td class="signal_flags">Run First</td> -</tr> -<tr> -<td class="signal_type"><span class="returnvalue">void</span></td> -<td class="signal_name"><a class="link" href="NMClient.html#NMClient-permission-changed" title="The “permission-changed” signal">permission-changed</a></td> -<td class="signal_flags">Run First</td> -</tr> -</tbody> -</table></div> -</div> -<a name="NMDnsEntry"></a><div class="refsect1"> -<a name="NMClient.other"></a><h2>Types and Values</h2> -<div class="informaltable"><table class="informaltable" width="100%" border="0"> -<colgroup> -<col width="150px" class="other_proto_type"> -<col class="other_proto_name"> -</colgroup> -<tbody> -<tr> -<td class="datatype_keyword">enum</td> -<td class="function_name"><a class="link" href="NMClient.html#NMClientInstanceFlags" title="enum NMClientInstanceFlags">NMClientInstanceFlags</a></td> -</tr> -<tr> -<td class="define_keyword">#define</td> -<td class="function_name"><a class="link" href="NMClient.html#NM-CLIENT-VERSION:CAPS" title="NM_CLIENT_VERSION">NM_CLIENT_VERSION</a></td> -</tr> -<tr> -<td class="define_keyword">#define</td> -<td class="function_name"><a class="link" href="NMClient.html#NM-CLIENT-VERSION-INFO:CAPS" title="NM_CLIENT_VERSION_INFO">NM_CLIENT_VERSION_INFO</a></td> -</tr> -<tr> -<td class="define_keyword">#define</td> -<td class="function_name"><a class="link" href="NMClient.html#NM-CLIENT-STATE:CAPS" title="NM_CLIENT_STATE">NM_CLIENT_STATE</a></td> -</tr> -<tr> -<td class="define_keyword">#define</td> -<td class="function_name"><a class="link" href="NMClient.html#NM-CLIENT-STARTUP:CAPS" title="NM_CLIENT_STARTUP">NM_CLIENT_STARTUP</a></td> -</tr> -<tr> -<td class="define_keyword">#define</td> -<td class="function_name"><a class="link" href="NMClient.html#NM-CLIENT-NM-RUNNING:CAPS" title="NM_CLIENT_NM_RUNNING">NM_CLIENT_NM_RUNNING</a></td> -</tr> -<tr> -<td class="define_keyword">#define</td> -<td class="function_name"><a class="link" href="NMClient.html#NM-CLIENT-DBUS-CONNECTION:CAPS" title="NM_CLIENT_DBUS_CONNECTION">NM_CLIENT_DBUS_CONNECTION</a></td> -</tr> -<tr> -<td class="define_keyword">#define</td> -<td class="function_name"><a class="link" href="NMClient.html#NM-CLIENT-DBUS-NAME-OWNER:CAPS" title="NM_CLIENT_DBUS_NAME_OWNER">NM_CLIENT_DBUS_NAME_OWNER</a></td> -</tr> -<tr> -<td class="define_keyword">#define</td> -<td class="function_name"><a class="link" href="NMClient.html#NM-CLIENT-INSTANCE-FLAGS:CAPS" title="NM_CLIENT_INSTANCE_FLAGS">NM_CLIENT_INSTANCE_FLAGS</a></td> -</tr> -<tr> -<td class="define_keyword">#define</td> -<td class="function_name"><a class="link" href="NMClient.html#NM-CLIENT-NETWORKING-ENABLED:CAPS" title="NM_CLIENT_NETWORKING_ENABLED">NM_CLIENT_NETWORKING_ENABLED</a></td> -</tr> -<tr> -<td class="define_keyword">#define</td> -<td class="function_name"><a class="link" href="NMClient.html#NM-CLIENT-WIRELESS-ENABLED:CAPS" title="NM_CLIENT_WIRELESS_ENABLED">NM_CLIENT_WIRELESS_ENABLED</a></td> -</tr> -<tr> -<td class="define_keyword">#define</td> -<td class="function_name"><a class="link" href="NMClient.html#NM-CLIENT-WWAN-ENABLED:CAPS" title="NM_CLIENT_WWAN_ENABLED">NM_CLIENT_WWAN_ENABLED</a></td> -</tr> -<tr> -<td class="define_keyword">#define</td> -<td class="function_name"><a class="link" href="NMClient.html#NM-CLIENT-WIMAX-ENABLED:CAPS" title="NM_CLIENT_WIMAX_ENABLED">NM_CLIENT_WIMAX_ENABLED</a></td> -</tr> -<tr> -<td class="define_keyword">#define</td> -<td class="function_name"><a class="link" href="NMClient.html#NM-CLIENT-WIRELESS-HARDWARE-ENABLED:CAPS" title="NM_CLIENT_WIRELESS_HARDWARE_ENABLED">NM_CLIENT_WIRELESS_HARDWARE_ENABLED</a></td> -</tr> -<tr> -<td class="define_keyword">#define</td> -<td class="function_name"><a class="link" href="NMClient.html#NM-CLIENT-WWAN-HARDWARE-ENABLED:CAPS" title="NM_CLIENT_WWAN_HARDWARE_ENABLED">NM_CLIENT_WWAN_HARDWARE_ENABLED</a></td> -</tr> -<tr> -<td class="define_keyword">#define</td> -<td class="function_name"><a class="link" href="NMClient.html#NM-CLIENT-WIMAX-HARDWARE-ENABLED:CAPS" title="NM_CLIENT_WIMAX_HARDWARE_ENABLED">NM_CLIENT_WIMAX_HARDWARE_ENABLED</a></td> -</tr> -<tr> -<td class="define_keyword">#define</td> -<td class="function_name"><a class="link" href="NMClient.html#NM-CLIENT-RADIO-FLAGS:CAPS" title="NM_CLIENT_RADIO_FLAGS">NM_CLIENT_RADIO_FLAGS</a></td> -</tr> -<tr> -<td class="define_keyword">#define</td> -<td class="function_name"><a class="link" href="NMClient.html#NM-CLIENT-ACTIVE-CONNECTIONS:CAPS" title="NM_CLIENT_ACTIVE_CONNECTIONS">NM_CLIENT_ACTIVE_CONNECTIONS</a></td> -</tr> -<tr> -<td class="define_keyword">#define</td> -<td class="function_name"><a class="link" href="NMClient.html#NM-CLIENT-CONNECTIVITY:CAPS" title="NM_CLIENT_CONNECTIVITY">NM_CLIENT_CONNECTIVITY</a></td> -</tr> -<tr> -<td class="define_keyword">#define</td> -<td class="function_name"><a class="link" href="NMClient.html#NM-CLIENT-CONNECTIVITY-CHECK-URI:CAPS" title="NM_CLIENT_CONNECTIVITY_CHECK_URI">NM_CLIENT_CONNECTIVITY_CHECK_URI</a></td> -</tr> -<tr> -<td class="define_keyword">#define</td> -<td class="function_name"><a class="link" href="NMClient.html#NM-CLIENT-CONNECTIVITY-CHECK-AVAILABLE:CAPS" title="NM_CLIENT_CONNECTIVITY_CHECK_AVAILABLE">NM_CLIENT_CONNECTIVITY_CHECK_AVAILABLE</a></td> -</tr> -<tr> -<td class="define_keyword">#define</td> -<td class="function_name"><a class="link" href="NMClient.html#NM-CLIENT-CONNECTIVITY-CHECK-ENABLED:CAPS" title="NM_CLIENT_CONNECTIVITY_CHECK_ENABLED">NM_CLIENT_CONNECTIVITY_CHECK_ENABLED</a></td> -</tr> -<tr> -<td class="define_keyword">#define</td> -<td class="function_name"><a class="link" href="NMClient.html#NM-CLIENT-PRIMARY-CONNECTION:CAPS" title="NM_CLIENT_PRIMARY_CONNECTION">NM_CLIENT_PRIMARY_CONNECTION</a></td> -</tr> -<tr> -<td class="define_keyword">#define</td> -<td class="function_name"><a class="link" href="NMClient.html#NM-CLIENT-ACTIVATING-CONNECTION:CAPS" title="NM_CLIENT_ACTIVATING_CONNECTION">NM_CLIENT_ACTIVATING_CONNECTION</a></td> -</tr> -<tr> -<td class="define_keyword">#define</td> -<td class="function_name"><a class="link" href="NMClient.html#NM-CLIENT-DEVICES:CAPS" title="NM_CLIENT_DEVICES">NM_CLIENT_DEVICES</a></td> -</tr> -<tr> -<td class="define_keyword">#define</td> -<td class="function_name"><a class="link" href="NMClient.html#NM-CLIENT-ALL-DEVICES:CAPS" title="NM_CLIENT_ALL_DEVICES">NM_CLIENT_ALL_DEVICES</a></td> -</tr> -<tr> -<td class="define_keyword">#define</td> -<td class="function_name"><a class="link" href="NMClient.html#NM-CLIENT-CONNECTIONS:CAPS" title="NM_CLIENT_CONNECTIONS">NM_CLIENT_CONNECTIONS</a></td> -</tr> -<tr> -<td class="define_keyword">#define</td> -<td class="function_name"><a class="link" href="NMClient.html#NM-CLIENT-HOSTNAME:CAPS" title="NM_CLIENT_HOSTNAME">NM_CLIENT_HOSTNAME</a></td> -</tr> -<tr> -<td class="define_keyword">#define</td> -<td class="function_name"><a class="link" href="NMClient.html#NM-CLIENT-CAN-MODIFY:CAPS" title="NM_CLIENT_CAN_MODIFY">NM_CLIENT_CAN_MODIFY</a></td> -</tr> -<tr> -<td class="define_keyword">#define</td> -<td class="function_name"><a class="link" href="NMClient.html#NM-CLIENT-METERED:CAPS" title="NM_CLIENT_METERED">NM_CLIENT_METERED</a></td> -</tr> -<tr> -<td class="define_keyword">#define</td> -<td class="function_name"><a class="link" href="NMClient.html#NM-CLIENT-DNS-MODE:CAPS" title="NM_CLIENT_DNS_MODE">NM_CLIENT_DNS_MODE</a></td> -</tr> -<tr> -<td class="define_keyword">#define</td> -<td class="function_name"><a class="link" href="NMClient.html#NM-CLIENT-DNS-RC-MANAGER:CAPS" title="NM_CLIENT_DNS_RC_MANAGER">NM_CLIENT_DNS_RC_MANAGER</a></td> -</tr> -<tr> -<td class="define_keyword">#define</td> -<td class="function_name"><a class="link" href="NMClient.html#NM-CLIENT-DNS-CONFIGURATION:CAPS" title="NM_CLIENT_DNS_CONFIGURATION">NM_CLIENT_DNS_CONFIGURATION</a></td> -</tr> -<tr> -<td class="define_keyword">#define</td> -<td class="function_name"><a class="link" href="NMClient.html#NM-CLIENT-CHECKPOINTS:CAPS" title="NM_CLIENT_CHECKPOINTS">NM_CLIENT_CHECKPOINTS</a></td> -</tr> -<tr> -<td class="define_keyword">#define</td> -<td class="function_name"><a class="link" href="NMClient.html#NM-CLIENT-CAPABILITIES:CAPS" title="NM_CLIENT_CAPABILITIES">NM_CLIENT_CAPABILITIES</a></td> -</tr> -<tr> -<td class="define_keyword">#define</td> -<td class="function_name"><a class="link" href="NMClient.html#NM-CLIENT-PERMISSIONS-STATE:CAPS" title="NM_CLIENT_PERMISSIONS_STATE">NM_CLIENT_PERMISSIONS_STATE</a></td> -</tr> -<tr> -<td class="define_keyword">#define</td> -<td class="function_name"><a class="link" href="NMClient.html#NM-CLIENT-DEVICE-ADDED:CAPS" title="NM_CLIENT_DEVICE_ADDED">NM_CLIENT_DEVICE_ADDED</a></td> -</tr> -<tr> -<td class="define_keyword">#define</td> -<td class="function_name"><a class="link" href="NMClient.html#NM-CLIENT-DEVICE-REMOVED:CAPS" title="NM_CLIENT_DEVICE_REMOVED">NM_CLIENT_DEVICE_REMOVED</a></td> -</tr> -<tr> -<td class="define_keyword">#define</td> -<td class="function_name"><a class="link" href="NMClient.html#NM-CLIENT-ANY-DEVICE-ADDED:CAPS" title="NM_CLIENT_ANY_DEVICE_ADDED">NM_CLIENT_ANY_DEVICE_ADDED</a></td> -</tr> -<tr> -<td class="define_keyword">#define</td> -<td class="function_name"><a class="link" href="NMClient.html#NM-CLIENT-ANY-DEVICE-REMOVED:CAPS" title="NM_CLIENT_ANY_DEVICE_REMOVED">NM_CLIENT_ANY_DEVICE_REMOVED</a></td> -</tr> -<tr> -<td class="define_keyword">#define</td> -<td class="function_name"><a class="link" href="NMClient.html#NM-CLIENT-PERMISSION-CHANGED:CAPS" title="NM_CLIENT_PERMISSION_CHANGED">NM_CLIENT_PERMISSION_CHANGED</a></td> -</tr> -<tr> -<td class="define_keyword">#define</td> -<td class="function_name"><a class="link" href="NMClient.html#NM-CLIENT-CONNECTION-ADDED:CAPS" title="NM_CLIENT_CONNECTION_ADDED">NM_CLIENT_CONNECTION_ADDED</a></td> -</tr> -<tr> -<td class="define_keyword">#define</td> -<td class="function_name"><a class="link" href="NMClient.html#NM-CLIENT-CONNECTION-REMOVED:CAPS" title="NM_CLIENT_CONNECTION_REMOVED">NM_CLIENT_CONNECTION_REMOVED</a></td> -</tr> -<tr> -<td class="define_keyword">#define</td> -<td class="function_name"><a class="link" href="NMClient.html#NM-CLIENT-ACTIVE-CONNECTION-ADDED:CAPS" title="NM_CLIENT_ACTIVE_CONNECTION_ADDED">NM_CLIENT_ACTIVE_CONNECTION_ADDED</a></td> -</tr> -<tr> -<td class="define_keyword">#define</td> -<td class="function_name"><a class="link" href="NMClient.html#NM-CLIENT-ACTIVE-CONNECTION-REMOVED:CAPS" title="NM_CLIENT_ACTIVE_CONNECTION_REMOVED">NM_CLIENT_ACTIVE_CONNECTION_REMOVED</a></td> -</tr> -<tr> -<td class="datatype_keyword">enum</td> -<td class="function_name"><a class="link" href="NMClient.html#NMClientError" title="enum NMClientError">NMClientError</a></td> -</tr> -<tr> -<td class="define_keyword">#define</td> -<td class="function_name"><a class="link" href="NMClient.html#NM-CLIENT-ERROR:CAPS" title="NM_CLIENT_ERROR">NM_CLIENT_ERROR</a></td> -</tr> -<tr> -<td class="datatype_keyword"> </td> -<td class="function_name"><a class="link" href="NMClient.html#NMClient-struct" title="NMClient">NMClient</a></td> -</tr> -<tr> -<td class="datatype_keyword"> </td> -<td class="function_name"><a class="link" href="NMClient.html#NMDnsEntry-struct" title="NMDnsEntry">NMDnsEntry</a></td> -</tr> -</tbody> -</table></div> -</div> -<div class="refsect1"> -<a name="NMClient.object-hierarchy"></a><h2>Object Hierarchy</h2> -<pre class="screen"> <a href="/usr/share/gtk-doc/html/gobject/gobject-Boxed-Types.html">GBoxed</a> - <span class="lineart">╰──</span> NMDnsEntry - <a href="/usr/share/gtk-doc/html/gobject/gobject-Enumeration-and-Flag-Types.html">GEnum</a> - <span class="lineart">╰──</span> NMClientError - <a href="/usr/share/gtk-doc/html/gobject/gobject-Enumeration-and-Flag-Types.html">GFlags</a> - <span class="lineart">╰──</span> NMClientInstanceFlags - GObject - <span class="lineart">╰──</span> NMClient -</pre> -</div> -<div class="refsect1"> -<a name="NMClient.implemented-interfaces"></a><h2>Implemented Interfaces</h2> -<p> -NMClient implements - GInitable and GAsyncInitable.</p> -</div> -<div class="refsect1"> -<a name="NMClient.description"></a><h2>Description</h2> -</div> -<div class="refsect1"> -<a name="NMClient.functions_details"></a><h2>Functions</h2> -<div class="refsect2"> -<a name="nm-client-error-quark"></a><h3>nm_client_error_quark ()</h3> -<pre class="programlisting"><span class="returnvalue">GQuark</span> -nm_client_error_quark (<em class="parameter"><code><span class="type">void</span></code></em>);</pre> -<p>Registers an error quark for <a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a> if necessary.</p> -<div class="refsect3"> -<a name="nm-client-error-quark.returns"></a><h4>Returns</h4> -<p> the error quark used for <a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a> errors.</p> -</div> -</div> -<hr> -<div class="refsect2"> -<a name="nm-dns-entry-unref"></a><h3>nm_dns_entry_unref ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> -nm_dns_entry_unref (<em class="parameter"><code><a class="link" href="NMClient.html#NMDnsEntry"><span class="type">NMDnsEntry</span></a> *entry</code></em>);</pre> -<p>Decreases the reference count of the object. If the reference count -reaches zero, the object will be destroyed.</p> -<div class="refsect3"> -<a name="nm-dns-entry-unref.parameters"></a><h4>Parameters</h4> -<div class="informaltable"><table class="informaltable" width="100%" border="0"> -<colgroup> -<col width="150px" class="parameters_name"> -<col class="parameters_description"> -<col width="200px" class="parameters_annotations"> -</colgroup> -<tbody><tr> -<td class="parameter_name"><p>entry</p></td> -<td class="parameter_description"><p>the <a class="link" href="NMClient.html#NMDnsEntry"><span class="type">NMDnsEntry</span></a></p></td> -<td class="parameter_annotations"> </td> -</tr></tbody> -</table></div> -</div> -<p class="since">Since: 1.6</p> -</div> -<hr> -<div class="refsect2"> -<a name="nm-dns-entry-get-interface"></a><h3>nm_dns_entry_get_interface ()</h3> -<pre class="programlisting">const <span class="returnvalue">char</span> * -nm_dns_entry_get_interface (<em class="parameter"><code><a class="link" href="NMClient.html#NMDnsEntry"><span class="type">NMDnsEntry</span></a> *entry</code></em>);</pre> -<p>Gets the interface on which name servers are contacted.</p> -<div class="refsect3"> -<a name="nm-dns-entry-get-interface.parameters"></a><h4>Parameters</h4> -<div class="informaltable"><table class="informaltable" width="100%" border="0"> -<colgroup> -<col width="150px" class="parameters_name"> -<col class="parameters_description"> -<col width="200px" class="parameters_annotations"> -</colgroup> -<tbody><tr> -<td class="parameter_name"><p>entry</p></td> -<td class="parameter_description"><p>the <a class="link" href="NMClient.html#NMDnsEntry"><span class="type">NMDnsEntry</span></a></p></td> -<td class="parameter_annotations"> </td> -</tr></tbody> -</table></div> -</div> -<div class="refsect3"> -<a name="nm-dns-entry-get-interface.returns"></a><h4>Returns</h4> -<p>the interface name. </p> -<p><span class="annotation">[<acronym title="The data is owned by the callee, which is responsible of freeing it."><span class="acronym">transfer none</span></acronym>]</span></p> -</div> -<p class="since">Since: 1.6</p> -</div> -<hr> -<div class="refsect2"> -<a name="nm-dns-entry-get-nameservers"></a><h3>nm_dns_entry_get_nameservers ()</h3> -<pre class="programlisting">const <span class="returnvalue">char</span> *const * -nm_dns_entry_get_nameservers (<em class="parameter"><code><a class="link" href="NMClient.html#NMDnsEntry"><span class="type">NMDnsEntry</span></a> *entry</code></em>);</pre> -<p>Gets the list of name servers for this entry.</p> -<div class="refsect3"> -<a name="nm-dns-entry-get-nameservers.parameters"></a><h4>Parameters</h4> -<div class="informaltable"><table class="informaltable" width="100%" border="0"> -<colgroup> -<col width="150px" class="parameters_name"> -<col class="parameters_description"> -<col width="200px" class="parameters_annotations"> -</colgroup> -<tbody><tr> -<td class="parameter_name"><p>entry</p></td> -<td class="parameter_description"><p>the <a class="link" href="NMClient.html#NMDnsEntry"><span class="type">NMDnsEntry</span></a></p></td> -<td class="parameter_annotations"> </td> -</tr></tbody> -</table></div> -</div> -<div class="refsect3"> -<a name="nm-dns-entry-get-nameservers.returns"></a><h4>Returns</h4> -<p>the list of name servers. </p> -<p><span class="annotation">[<acronym title="The data is owned by the callee, which is responsible of freeing it."><span class="acronym">transfer none</span></acronym>]</span></p> -</div> -<p class="since">Since: 1.6</p> -</div> -<hr> -<div class="refsect2"> -<a name="nm-dns-entry-get-domains"></a><h3>nm_dns_entry_get_domains ()</h3> -<pre class="programlisting">const <span class="returnvalue">char</span> *const * -nm_dns_entry_get_domains (<em class="parameter"><code><a class="link" href="NMClient.html#NMDnsEntry"><span class="type">NMDnsEntry</span></a> *entry</code></em>);</pre> -<p>Gets the list of DNS domains.</p> -<div class="refsect3"> -<a name="nm-dns-entry-get-domains.parameters"></a><h4>Parameters</h4> -<div class="informaltable"><table class="informaltable" width="100%" border="0"> -<colgroup> -<col width="150px" class="parameters_name"> -<col class="parameters_description"> -<col width="200px" class="parameters_annotations"> -</colgroup> -<tbody><tr> -<td class="parameter_name"><p>entry</p></td> -<td class="parameter_description"><p>the <a class="link" href="NMClient.html#NMDnsEntry"><span class="type">NMDnsEntry</span></a></p></td> -<td class="parameter_annotations"> </td> -</tr></tbody> -</table></div> -</div> -<div class="refsect3"> -<a name="nm-dns-entry-get-domains.returns"></a><h4>Returns</h4> -<p>the list of DNS domains. </p> -<p><span class="annotation">[<acronym title="The data is owned by the callee, which is responsible of freeing it."><span class="acronym">transfer none</span></acronym>]</span></p> -</div> -<p class="since">Since: 1.6</p> -</div> -<hr> -<div class="refsect2"> -<a name="nm-dns-entry-get-priority"></a><h3>nm_dns_entry_get_priority ()</h3> -<pre class="programlisting"><span class="returnvalue">int</span> -nm_dns_entry_get_priority (<em class="parameter"><code><a class="link" href="NMClient.html#NMDnsEntry"><span class="type">NMDnsEntry</span></a> *entry</code></em>);</pre> -<p>Gets the priority of the entry</p> -<div class="refsect3"> -<a name="nm-dns-entry-get-priority.parameters"></a><h4>Parameters</h4> -<div class="informaltable"><table class="informaltable" width="100%" border="0"> -<colgroup> -<col width="150px" class="parameters_name"> -<col class="parameters_description"> -<col width="200px" class="parameters_annotations"> -</colgroup> -<tbody><tr> -<td class="parameter_name"><p>entry</p></td> -<td class="parameter_description"><p>the <a class="link" href="NMClient.html#NMDnsEntry"><span class="type">NMDnsEntry</span></a></p></td> -<td class="parameter_annotations"> </td> -</tr></tbody> -</table></div> -</div> -<div class="refsect3"> -<a name="nm-dns-entry-get-priority.returns"></a><h4>Returns</h4> -<p> the priority of the entry</p> -</div> -<p class="since">Since: 1.6</p> -</div> -<hr> -<div class="refsect2"> -<a name="nm-dns-entry-get-vpn"></a><h3>nm_dns_entry_get_vpn ()</h3> -<pre class="programlisting"><span class="returnvalue">gboolean</span> -nm_dns_entry_get_vpn (<em class="parameter"><code><a class="link" href="NMClient.html#NMDnsEntry"><span class="type">NMDnsEntry</span></a> *entry</code></em>);</pre> -<p>Gets whether the entry refers to VPN name servers.</p> -<div class="refsect3"> -<a name="nm-dns-entry-get-vpn.parameters"></a><h4>Parameters</h4> -<div class="informaltable"><table class="informaltable" width="100%" border="0"> -<colgroup> -<col width="150px" class="parameters_name"> -<col class="parameters_description"> -<col width="200px" class="parameters_annotations"> -</colgroup> -<tbody><tr> -<td class="parameter_name"><p>entry</p></td> -<td class="parameter_description"><p>the <a class="link" href="NMClient.html#NMDnsEntry"><span class="type">NMDnsEntry</span></a></p></td> -<td class="parameter_annotations"> </td> -</tr></tbody> -</table></div> -</div> -<div class="refsect3"> -<a name="nm-dns-entry-get-vpn.returns"></a><h4>Returns</h4> -<p> <code class="literal">TRUE</code> if the entry refers to VPN name servers</p> -</div> -<p class="since">Since: 1.6</p> -</div> -<hr> -<div class="refsect2"> -<a name="nm-client-new"></a><h3>nm_client_new ()</h3> -<pre class="programlisting"><a class="link" href="NMClient.html" title="NMClient"><span class="returnvalue">NMClient</span></a> * -nm_client_new (<em class="parameter"><code><span class="type">GCancellable</span> *cancellable</code></em>, - <em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre> -<p>Creates a new <a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a> synchronously.</p> -<p>Note that this will block until a NMClient instance is fully initialized. -This does nothing beside calling <code class="function">g_initable_new()</code>. You are free to call -<code class="function">g_initable_new()</code> or <code class="function">g_object_new()</code>/<code class="function">g_initable_init()</code> directly for more -control, to set GObject properties or get access to the NMClient instance -while it is still initializing.</p> -<p>Using the synchronous initialization creates an <a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a> instance -that uses an internal <span class="type">GMainContext</span>. This context is invisible to the -user. This introduces an additional overhead that is payed not -only during object initialization, but for the entire lifetime of -this object. -Also, due to this internal <span class="type">GMainContext</span>, the events are no longer -in sync with other messages from <span class="type">GDBusConnection</span> (but all events -of the NMClient will themselves still be ordered). -For a serious program, you should therefore avoid these problems by -using <code class="function">g_async_initable_init_async()</code> or <a class="link" href="NMClient.html#nm-client-new-async" title="nm_client_new_async ()"><code class="function">nm_client_new_async()</code></a> instead. -The sync initialization is still useful for simple scripts or interactive -testing for example via pygobject.</p> -<p>Creating an <a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a> instance can only fail for two reasons. First, if you didn't -provide a <a class="link" href="NMClient.html#NM-CLIENT-DBUS-CONNECTION:CAPS" title="NM_CLIENT_DBUS_CONNECTION"><code class="literal">NM_CLIENT_DBUS_CONNECTION</code></a> and the call to <code class="function">g_bus_get()</code> -fails. You can avoid that by using <code class="function">g_initable_new()</code> directly and -set a D-Bus connection. -Second, if you cancelled the creation. If you do that, then note -that after the failure there might still be idle actions pending -which keep <a class="link" href="NMClient.html#nm-client-get-main-context" title="nm_client_get_main_context ()"><code class="function">nm_client_get_main_context()</code></a> alive. That means, -in that case you must continue iterating the context to avoid -leaks. See <a class="link" href="NMClient.html#nm-client-get-context-busy-watcher" title="nm_client_get_context_busy_watcher ()"><code class="function">nm_client_get_context_busy_watcher()</code></a>.</p> -<p>Creating an <a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a> instance when NetworkManager is not running -does not cause a failure.</p> -<div class="refsect3"> -<a name="nm-client-new.parameters"></a><h4>Parameters</h4> -<div class="informaltable"><table class="informaltable" width="100%" border="0"> -<colgroup> -<col width="150px" class="parameters_name"> -<col class="parameters_description"> -<col width="200px" class="parameters_annotations"> -</colgroup> -<tbody> -<tr> -<td class="parameter_name"><p>cancellable</p></td> -<td class="parameter_description"><p>a <span class="type">GCancellable</span>, or <code class="literal">NULL</code></p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>error</p></td> -<td class="parameter_description"><p>location for a <span class="type">GError</span>, or <code class="literal">NULL</code></p></td> -<td class="parameter_annotations"> </td> -</tr> -</tbody> -</table></div> -</div> -<div class="refsect3"> -<a name="nm-client-new.returns"></a><h4>Returns</h4> -<p> a new <a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a> or NULL on an error</p> -</div> -</div> -<hr> -<div class="refsect2"> -<a name="nm-client-new-async"></a><h3>nm_client_new_async ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> -nm_client_new_async (<em class="parameter"><code><span class="type">GCancellable</span> *cancellable</code></em>, - <em class="parameter"><code><span class="type">GAsyncReadyCallback</span> callback</code></em>, - <em class="parameter"><code><span class="type">gpointer</span> user_data</code></em>);</pre> -<p>Creates a new <a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a> asynchronously. -<em class="parameter"><code>callback</code></em> - will be called when it is done. Use -<a class="link" href="NMClient.html#nm-client-new-finish" title="nm_client_new_finish ()"><code class="function">nm_client_new_finish()</code></a> to get the result.</p> -<p>This does nothing beside calling <code class="function">g_async_initable_new_async()</code>. You are free to -call <code class="function">g_async_initable_new_async()</code> or <code class="function">g_object_new()</code>/<code class="function">g_async_initable_init_async()</code> -directly for more control, to set GObject properties or get access to the NMClient -instance while it is still initializing.</p> -<p>Creating an <a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a> instance can only fail for two reasons. First, if you didn't -provide a <a class="link" href="NMClient.html#NM-CLIENT-DBUS-CONNECTION:CAPS" title="NM_CLIENT_DBUS_CONNECTION"><code class="literal">NM_CLIENT_DBUS_CONNECTION</code></a> and the call to <code class="function">g_bus_get()</code> -fails. You can avoid that by using <code class="function">g_async_initable_new_async()</code> directly and -set a D-Bus connection. -Second, if you cancelled the creation. If you do that, then note -that after the failure there might still be idle actions pending -which keep <a class="link" href="NMClient.html#nm-client-get-main-context" title="nm_client_get_main_context ()"><code class="function">nm_client_get_main_context()</code></a> alive. That means, -in that case you must continue iterating the context to avoid -leaks. See <a class="link" href="NMClient.html#nm-client-get-context-busy-watcher" title="nm_client_get_context_busy_watcher ()"><code class="function">nm_client_get_context_busy_watcher()</code></a>.</p> -<p>Creating an <a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a> instance when NetworkManager is not running -does not cause a failure.</p> -<div class="refsect3"> -<a name="nm-client-new-async.parameters"></a><h4>Parameters</h4> -<div class="informaltable"><table class="informaltable" width="100%" border="0"> -<colgroup> -<col width="150px" class="parameters_name"> -<col class="parameters_description"> -<col width="200px" class="parameters_annotations"> -</colgroup> -<tbody> -<tr> -<td class="parameter_name"><p>cancellable</p></td> -<td class="parameter_description"><p>a <span class="type">GCancellable</span>, or <code class="literal">NULL</code></p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>callback</p></td> -<td class="parameter_description"><p>callback to call when the client is created</p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>user_data</p></td> -<td class="parameter_description"><p>data for <em class="parameter"><code>callback</code></em> -</p></td> -<td class="parameter_annotations"> </td> -</tr> -</tbody> -</table></div> -</div> -</div> -<hr> -<div class="refsect2"> -<a name="nm-client-new-finish"></a><h3>nm_client_new_finish ()</h3> -<pre class="programlisting"><a class="link" href="NMClient.html" title="NMClient"><span class="returnvalue">NMClient</span></a> * -nm_client_new_finish (<em class="parameter"><code><span class="type">GAsyncResult</span> *result</code></em>, - <em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre> -<p>Gets the result of an <a class="link" href="NMClient.html#nm-client-new-async" title="nm_client_new_async ()"><code class="function">nm_client_new_async()</code></a> call.</p> -<div class="refsect3"> -<a name="nm-client-new-finish.parameters"></a><h4>Parameters</h4> -<div class="informaltable"><table class="informaltable" width="100%" border="0"> -<colgroup> -<col width="150px" class="parameters_name"> -<col class="parameters_description"> -<col width="200px" class="parameters_annotations"> -</colgroup> -<tbody> -<tr> -<td class="parameter_name"><p>result</p></td> -<td class="parameter_description"><p>a <span class="type">GAsyncResult</span></p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>error</p></td> -<td class="parameter_description"><p>location for a <span class="type">GError</span>, or <code class="literal">NULL</code></p></td> -<td class="parameter_annotations"> </td> -</tr> -</tbody> -</table></div> -</div> -<div class="refsect3"> -<a name="nm-client-new-finish.returns"></a><h4>Returns</h4> -<p> a new <a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a>, or <code class="literal">NULL</code> on error</p> -</div> -</div> -<hr> -<div class="refsect2"> -<a name="nm-client-get-instance-flags"></a><h3>nm_client_get_instance_flags ()</h3> -<pre class="programlisting"><a class="link" href="NMClient.html#NMClientInstanceFlags" title="enum NMClientInstanceFlags"><span class="returnvalue">NMClientInstanceFlags</span></a> -nm_client_get_instance_flags (<em class="parameter"><code><a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a> *self</code></em>);</pre> -<div class="refsect3"> -<a name="nm-client-get-instance-flags.parameters"></a><h4>Parameters</h4> -<div class="informaltable"><table class="informaltable" width="100%" border="0"> -<colgroup> -<col width="150px" class="parameters_name"> -<col class="parameters_description"> -<col width="200px" class="parameters_annotations"> -</colgroup> -<tbody><tr> -<td class="parameter_name"><p>self</p></td> -<td class="parameter_description"><p>the <a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a> instance.</p></td> -<td class="parameter_annotations"> </td> -</tr></tbody> -</table></div> -</div> -<div class="refsect3"> -<a name="nm-client-get-instance-flags.returns"></a><h4>Returns</h4> -<p> the <a class="link" href="NMClient.html#NMClientInstanceFlags" title="enum NMClientInstanceFlags"><span class="type">NMClientInstanceFlags</span></a> flags.</p> -</div> -<p class="since">Since: 1.24</p> -</div> -<hr> -<div class="refsect2"> -<a name="nm-client-get-dbus-connection"></a><h3>nm_client_get_dbus_connection ()</h3> -<pre class="programlisting"><span class="returnvalue">GDBusConnection</span> * -nm_client_get_dbus_connection (<em class="parameter"><code><a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a> *client</code></em>);</pre> -<p>Gets the <code class="literal">GDBusConnection</code> of the instance. This can be either passed when -constructing the instance (as "dbus-connection" property), or it will be -automatically initialized during async/sync init.</p> -<div class="refsect3"> -<a name="nm-client-get-dbus-connection.parameters"></a><h4>Parameters</h4> -<div class="informaltable"><table class="informaltable" width="100%" border="0"> -<colgroup> -<col width="150px" class="parameters_name"> -<col class="parameters_description"> -<col width="200px" class="parameters_annotations"> -</colgroup> -<tbody><tr> -<td class="parameter_name"><p>client</p></td> -<td class="parameter_description"><p>a <a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a></p></td> -<td class="parameter_annotations"> </td> -</tr></tbody> -</table></div> -</div> -<div class="refsect3"> -<a name="nm-client-get-dbus-connection.returns"></a><h4>Returns</h4> -<p>the D-Bus connection of the client, or <code class="literal">NULL</code> if none is set. </p> -<p><span class="annotation">[<acronym title="The data is owned by the callee, which is responsible of freeing it."><span class="acronym">transfer none</span></acronym>]</span></p> -</div> -<p class="since">Since: 1.22</p> -</div> -<hr> -<div class="refsect2"> -<a name="nm-client-get-main-context"></a><h3>nm_client_get_main_context ()</h3> -<pre class="programlisting"><span class="returnvalue">GMainContext</span> * -nm_client_get_main_context (<em class="parameter"><code><a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a> *self</code></em>);</pre> -<p>The <a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a> instance is permanently associated with the current -thread default <span class="type">GMainContext</span>, referenced the time when the instance -was created. To receive events, the user must iterate this context -and can use it to synchronize access to the client.</p> -<p>Note that even after <a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a> instance got destroyed, there might -still be pending sources registered in the context. That means, to fully -clean up, the user must continue iterating the context as long as -the <a class="link" href="NMClient.html#nm-client-get-context-busy-watcher" title="nm_client_get_context_busy_watcher ()"><code class="function">nm_client_get_context_busy_watcher()</code></a> object is alive.</p> -<div class="refsect3"> -<a name="nm-client-get-main-context.parameters"></a><h4>Parameters</h4> -<div class="informaltable"><table class="informaltable" width="100%" border="0"> -<colgroup> -<col width="150px" class="parameters_name"> -<col class="parameters_description"> -<col width="200px" class="parameters_annotations"> -</colgroup> -<tbody><tr> -<td class="parameter_name"><p>self</p></td> -<td class="parameter_description"><p>the <a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a> instance</p></td> -<td class="parameter_annotations"> </td> -</tr></tbody> -</table></div> -</div> -<div class="refsect3"> -<a name="nm-client-get-main-context.returns"></a><h4>Returns</h4> -<p>the <span class="type">GMainContext</span> of the client. </p> -<p><span class="annotation">[<acronym title="The data is owned by the callee, which is responsible of freeing it."><span class="acronym">transfer none</span></acronym>]</span></p> -</div> -<p class="since">Since: 1.22</p> -</div> -<hr> -<div class="refsect2"> -<a name="nm-client-get-context-busy-watcher"></a><h3>nm_client_get_context_busy_watcher ()</h3> -<pre class="programlisting"><span class="returnvalue">GObject</span> * -nm_client_get_context_busy_watcher (<em class="parameter"><code><a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a> *self</code></em>);</pre> -<div class="refsect3"> -<a name="nm-client-get-context-busy-watcher.parameters"></a><h4>Parameters</h4> -<div class="informaltable"><table class="informaltable" width="100%" border="0"> -<colgroup> -<col width="150px" class="parameters_name"> -<col class="parameters_description"> -<col width="200px" class="parameters_annotations"> -</colgroup> -<tbody><tr> -<td class="parameter_name"><p>self</p></td> -<td class="parameter_description"><p>the NMClient instance.</p></td> -<td class="parameter_annotations"> </td> -</tr></tbody> -</table></div> -</div> -<div class="refsect3"> -<a name="nm-client-get-context-busy-watcher.returns"></a><h4>Returns</h4> -<p>a GObject that stays alive as long as there are pending -D-Bus operations.</p> -<p>NMClient will schedule asynchronous D-Bus requests which will complete on -the GMainContext associated with the instance. When destroying the NMClient -instance, those requests are cancelled right away, however their pending requests are -still outstanding and queued in the GMainContext. These outstanding callbacks -keep the GMainContext alive. In order to fully release all resources, -the user must keep iterating the main context until all these callbacks -are handled. Of course, at this point no more actual callbacks will be invoked -for the user, those are all cancelled internally.</p> -<p>This just leaves one problem: how long does the user need to keep the -GMainContext running to ensure everything is cleaned up? The answer is -this GObject. Subscribe a weak reference to the returned object and keep -iterating the main context until the object got unreferenced.</p> -<p>Note that after the NMClient instance gets destroyed, all outstanding operations -will be cancelled right away. That means, the user needs to iterate the <span class="type">GMainContext</span> -a bit longer, but it is guaranteed that the cleanup happens soon after.</p> -<p>The way of using the context-busy-watch, is by registering a weak pointer to -see when it gets destroyed. That means, user code should not take additional -references on this object to not keep it alive longer.</p> -<p>If you plan to exit the program after releasing the NMClient instance -you may not need to worry about these "leaks". Also, if you anyway plan to continue -iterating the <span class="type">GMainContext</span> afterwards, then you don't need to care when exactly -NMClient is gone completely. </p> -<p><span class="annotation">[<acronym title="The data is owned by the callee, which is responsible of freeing it."><span class="acronym">transfer none</span></acronym>]</span></p> -</div> -<p class="since">Since: 1.22</p> -</div> -<hr> -<div class="refsect2"> -<a name="nm-client-get-dbus-name-owner"></a><h3>nm_client_get_dbus_name_owner ()</h3> -<pre class="programlisting">const <span class="returnvalue">char</span> * -nm_client_get_dbus_name_owner (<em class="parameter"><code><a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a> *client</code></em>);</pre> -<div class="refsect3"> -<a name="nm-client-get-dbus-name-owner.parameters"></a><h4>Parameters</h4> -<div class="informaltable"><table class="informaltable" width="100%" border="0"> -<colgroup> -<col width="150px" class="parameters_name"> -<col class="parameters_description"> -<col width="200px" class="parameters_annotations"> -</colgroup> -<tbody><tr> -<td class="parameter_name"><p>client</p></td> -<td class="parameter_description"><p>a <a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a></p></td> -<td class="parameter_annotations"> </td> -</tr></tbody> -</table></div> -</div> -<div class="refsect3"> -<a name="nm-client-get-dbus-name-owner.returns"></a><h4>Returns</h4> -<p>the current name owner of the D-Bus service of NetworkManager. </p> -<p><span class="annotation">[<acronym title="The data is owned by the callee, which is responsible of freeing it."><span class="acronym">transfer none</span></acronym>]</span></p> -</div> -<p class="since">Since: 1.22</p> -</div> -<hr> -<div class="refsect2"> -<a name="nm-client-get-version"></a><h3>nm_client_get_version ()</h3> -<pre class="programlisting">const <span class="returnvalue">char</span> * -nm_client_get_version (<em class="parameter"><code><a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a> *client</code></em>);</pre> -<p>Gets NetworkManager version.</p> -<div class="refsect3"> -<a name="nm-client-get-version.parameters"></a><h4>Parameters</h4> -<div class="informaltable"><table class="informaltable" width="100%" border="0"> -<colgroup> -<col width="150px" class="parameters_name"> -<col class="parameters_description"> -<col width="200px" class="parameters_annotations"> -</colgroup> -<tbody><tr> -<td class="parameter_name"><p>client</p></td> -<td class="parameter_description"><p>a <a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a></p></td> -<td class="parameter_annotations"> </td> -</tr></tbody> -</table></div> -</div> -<div class="refsect3"> -<a name="nm-client-get-version.returns"></a><h4>Returns</h4> -<p> string with the version (or <code class="literal">NULL</code> if NetworkManager is not running)</p> -</div> -</div> -<hr> -<div class="refsect2"> -<a name="nm-client-get-version-info"></a><h3>nm_client_get_version_info ()</h3> -<pre class="programlisting">const <span class="returnvalue">guint32</span> * -nm_client_get_version_info (<em class="parameter"><code><a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a> *client</code></em>, - <em class="parameter"><code><span class="type">gsize</span> *length</code></em>);</pre> -<p>If available, the first element in the array is NM_VERSION which -encodes the daemon version as "(major << 16 | minor << 8 | micro)". -The following elements are a bitfield of <code class="literal">NMVersionInfoCapabilities</code> -that indicate that the daemon supports a certain capability.</p> -<div class="refsect3"> -<a name="nm-client-get-version-info.parameters"></a><h4>Parameters</h4> -<div class="informaltable"><table class="informaltable" width="100%" border="0"> -<colgroup> -<col width="150px" class="parameters_name"> -<col class="parameters_description"> -<col width="200px" class="parameters_annotations"> -</colgroup> -<tbody> -<tr> -<td class="parameter_name"><p>client</p></td> -<td class="parameter_description"><p>the <a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a> instance</p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>length</p></td> -<td class="parameter_description"><p>the number of returned capabilities. </p></td> -<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span></td> -</tr> -</tbody> -</table></div> -</div> -<div class="refsect3"> -<a name="nm-client-get-version-info.returns"></a><h4>Returns</h4> -<p>the -list of capabilities reported by the server or <code class="literal">NULL</code> -if the capabilities are unknown. </p> -<p><span class="annotation">[<acronym title="The data is owned by the callee, which is responsible of freeing it."><span class="acronym">transfer none</span></acronym>][<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=length]</span></p> -</div> -<p class="since">Since: 1.42</p> -</div> -<hr> -<div class="refsect2"> -<a name="nm-client-get-state"></a><h3>nm_client_get_state ()</h3> -<pre class="programlisting"><a class="link" href="libnm-nm-dbus-interface.html#NMState" title="enum NMState"><span class="returnvalue">NMState</span></a> -nm_client_get_state (<em class="parameter"><code><a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a> *client</code></em>);</pre> -<p>Gets the current daemon state.</p> -<div class="refsect3"> -<a name="nm-client-get-state.parameters"></a><h4>Parameters</h4> -<div class="informaltable"><table class="informaltable" width="100%" border="0"> -<colgroup> -<col width="150px" class="parameters_name"> -<col class="parameters_description"> -<col width="200px" class="parameters_annotations"> -</colgroup> -<tbody><tr> -<td class="parameter_name"><p>client</p></td> -<td class="parameter_description"><p>a <a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a></p></td> -<td class="parameter_annotations"> </td> -</tr></tbody> -</table></div> -</div> -<div class="refsect3"> -<a name="nm-client-get-state.returns"></a><h4>Returns</h4> -<p> the current <a class="link" href="libnm-nm-dbus-interface.html#NMState" title="enum NMState"><code class="literal">NMState</code></a></p> -</div> -</div> -<hr> -<div class="refsect2"> -<a name="nm-client-get-startup"></a><h3>nm_client_get_startup ()</h3> -<pre class="programlisting"><span class="returnvalue">gboolean</span> -nm_client_get_startup (<em class="parameter"><code><a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a> *client</code></em>);</pre> -<p>Tests whether the daemon is still in the process of activating -connections at startup.</p> -<div class="refsect3"> -<a name="nm-client-get-startup.parameters"></a><h4>Parameters</h4> -<div class="informaltable"><table class="informaltable" width="100%" border="0"> -<colgroup> -<col width="150px" class="parameters_name"> -<col class="parameters_description"> -<col width="200px" class="parameters_annotations"> -</colgroup> -<tbody><tr> -<td class="parameter_name"><p>client</p></td> -<td class="parameter_description"><p>a <a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a></p></td> -<td class="parameter_annotations"> </td> -</tr></tbody> -</table></div> -</div> -<div class="refsect3"> -<a name="nm-client-get-startup.returns"></a><h4>Returns</h4> -<p> whether the daemon is still starting up</p> -</div> -</div> -<hr> -<div class="refsect2"> -<a name="nm-client-get-nm-running"></a><h3>nm_client_get_nm_running ()</h3> -<pre class="programlisting"><span class="returnvalue">gboolean</span> -nm_client_get_nm_running (<em class="parameter"><code><a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a> *client</code></em>);</pre> -<p>Determines whether the daemon is running.</p> -<div class="refsect3"> -<a name="nm-client-get-nm-running.parameters"></a><h4>Parameters</h4> -<div class="informaltable"><table class="informaltable" width="100%" border="0"> -<colgroup> -<col width="150px" class="parameters_name"> -<col class="parameters_description"> -<col width="200px" class="parameters_annotations"> -</colgroup> -<tbody><tr> -<td class="parameter_name"><p>client</p></td> -<td class="parameter_description"><p>a <a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a></p></td> -<td class="parameter_annotations"> </td> -</tr></tbody> -</table></div> -</div> -<div class="refsect3"> -<a name="nm-client-get-nm-running.returns"></a><h4>Returns</h4> -<p> <code class="literal">TRUE</code> if the daemon is running</p> -</div> -</div> -<hr> -<div class="refsect2"> -<a name="nm-client-get-object-by-path"></a><h3>nm_client_get_object_by_path ()</h3> -<pre class="programlisting"><a class="link" href="NMObject.html" title="NMObject"><span class="returnvalue">NMObject</span></a> * -nm_client_get_object_by_path (<em class="parameter"><code><a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a> *client</code></em>, - <em class="parameter"><code>const <span class="type">char</span> *dbus_path</code></em>);</pre> -<div class="refsect3"> -<a name="nm-client-get-object-by-path.parameters"></a><h4>Parameters</h4> -<div class="informaltable"><table class="informaltable" width="100%" border="0"> -<colgroup> -<col width="150px" class="parameters_name"> -<col class="parameters_description"> -<col width="200px" class="parameters_annotations"> -</colgroup> -<tbody> -<tr> -<td class="parameter_name"><p>client</p></td> -<td class="parameter_description"><p>the <a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a> instance</p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>dbus_path</p></td> -<td class="parameter_description"><p>the D-Bus path of the object to look up</p></td> -<td class="parameter_annotations"> </td> -</tr> -</tbody> -</table></div> -</div> -<div class="refsect3"> -<a name="nm-client-get-object-by-path.returns"></a><h4>Returns</h4> -<p>the <a class="link" href="NMObject.html" title="NMObject"><span class="type">NMObject</span></a> instance that is -cached under <em class="parameter"><code>dbus_path</code></em> -, or <code class="literal">NULL</code> if no such object exists. </p> -<p><span class="annotation">[<acronym title="The data is owned by the callee, which is responsible of freeing it."><span class="acronym">transfer none</span></acronym>]</span></p> -</div> -<p class="since">Since: 1.24</p> -</div> -<hr> -<div class="refsect2"> -<a name="nm-client-get-metered"></a><h3>nm_client_get_metered ()</h3> -<pre class="programlisting"><a class="link" href="libnm-nm-dbus-interface.html#NMMetered" title="enum NMMetered"><span class="returnvalue">NMMetered</span></a> -nm_client_get_metered (<em class="parameter"><code><a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a> *client</code></em>);</pre> -<div class="refsect3"> -<a name="nm-client-get-metered.parameters"></a><h4>Parameters</h4> -<div class="informaltable"><table class="informaltable" width="100%" border="0"> -<colgroup> -<col width="150px" class="parameters_name"> -<col class="parameters_description"> -<col width="200px" class="parameters_annotations"> -</colgroup> -<tbody><tr> -<td class="parameter_name"><p>client</p></td> -<td class="parameter_description"><p>a <a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a></p></td> -<td class="parameter_annotations"> </td> -</tr></tbody> -</table></div> -</div> -<div class="refsect3"> -<a name="nm-client-get-metered.returns"></a><h4>Returns</h4> -<p> whether the default route is metered.</p> -</div> -<p class="since">Since: 1.22</p> -</div> -<hr> -<div class="refsect2"> -<a name="nm-client-networking-get-enabled"></a><h3>nm_client_networking_get_enabled ()</h3> -<pre class="programlisting"><span class="returnvalue">gboolean</span> -nm_client_networking_get_enabled (<em class="parameter"><code><a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a> *client</code></em>);</pre> -<p>Whether networking is enabled or disabled.</p> -<div class="refsect3"> -<a name="nm-client-networking-get-enabled.parameters"></a><h4>Parameters</h4> -<div class="informaltable"><table class="informaltable" width="100%" border="0"> -<colgroup> -<col width="150px" class="parameters_name"> -<col class="parameters_description"> -<col width="200px" class="parameters_annotations"> -</colgroup> -<tbody><tr> -<td class="parameter_name"><p>client</p></td> -<td class="parameter_description"><p>a <a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a></p></td> -<td class="parameter_annotations"> </td> -</tr></tbody> -</table></div> -</div> -<div class="refsect3"> -<a name="nm-client-networking-get-enabled.returns"></a><h4>Returns</h4> -<p> <code class="literal">TRUE</code> if networking is enabled, <code class="literal">FALSE</code> if networking is disabled</p> -</div> -</div> -<hr> -<div class="refsect2"> -<a name="nm-client-get-capabilities"></a><h3>nm_client_get_capabilities ()</h3> -<pre class="programlisting">const <span class="returnvalue">guint32</span> * -nm_client_get_capabilities (<em class="parameter"><code><a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a> *client</code></em>, - <em class="parameter"><code><span class="type">gsize</span> *length</code></em>);</pre> -<div class="refsect3"> -<a name="nm-client-get-capabilities.parameters"></a><h4>Parameters</h4> -<div class="informaltable"><table class="informaltable" width="100%" border="0"> -<colgroup> -<col width="150px" class="parameters_name"> -<col class="parameters_description"> -<col width="200px" class="parameters_annotations"> -</colgroup> -<tbody> -<tr> -<td class="parameter_name"><p>client</p></td> -<td class="parameter_description"><p>the <a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a> instance</p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>length</p></td> -<td class="parameter_description"><p>the number of returned capabilities. </p></td> -<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL may be passed instead of a pointer to a location."><span class="acronym">optional</span></acronym>]</span></td> -</tr> -</tbody> -</table></div> -</div> -<div class="refsect3"> -<a name="nm-client-get-capabilities.returns"></a><h4>Returns</h4> -<p>the -list of capabilities reported by the server or <code class="literal">NULL</code> -if the capabilities are unknown. -The numeric values correspond to <a class="link" href="libnm-nm-dbus-interface.html#NMCapability" title="enum NMCapability"><span class="type">NMCapability</span></a> enum. -The array is terminated by a numeric zero sentinel -at position <em class="parameter"><code>length</code></em> -. </p> -<p><span class="annotation">[<acronym title="The data is owned by the callee, which is responsible of freeing it."><span class="acronym">transfer none</span></acronym>][<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=length]</span></p> -</div> -<p class="since">Since: 1.24</p> -</div> -<hr> -<div class="refsect2"> -<a name="nm-client-networking-set-enabled"></a><h3>nm_client_networking_set_enabled ()</h3> -<pre class="programlisting"><span class="returnvalue">gboolean</span> -nm_client_networking_set_enabled (<em class="parameter"><code><a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a> *client</code></em>, - <em class="parameter"><code><span class="type">gboolean</span> enabled</code></em>, - <em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre> -<div class="warning"> -<p><code class="literal">nm_client_networking_set_enabled</code> has been deprecated since version 1.22 and should not be used in newly-written code.</p> -<p>Use the async command <a class="link" href="NMClient.html#nm-client-dbus-call" title="nm_client_dbus_call ()"><code class="function">nm_client_dbus_call()</code></a> on <a class="link" href="libnm-nm-dbus-interface.html#NM-DBUS-PATH:CAPS" title="NM_DBUS_PATH"><code class="literal">NM_DBUS_PATH</code></a>, -<a class="link" href="libnm-nm-dbus-interface.html#NM-DBUS-INTERFACE:CAPS" title="NM_DBUS_INTERFACE"><code class="literal">NM_DBUS_INTERFACE</code></a> to call "Enable" with "(b)" arguments and no return value.</p> -</div> -<p>Enables or disables networking. When networking is disabled, all controlled -interfaces are disconnected and deactivated. When networking is enabled, -all controlled interfaces are available for activation.</p> -<div class="refsect3"> -<a name="nm-client-networking-set-enabled.parameters"></a><h4>Parameters</h4> -<div class="informaltable"><table class="informaltable" width="100%" border="0"> -<colgroup> -<col width="150px" class="parameters_name"> -<col class="parameters_description"> -<col width="200px" class="parameters_annotations"> -</colgroup> -<tbody> -<tr> -<td class="parameter_name"><p>client</p></td> -<td class="parameter_description"><p>a <a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a></p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>enabled</p></td> -<td class="parameter_description"><p><code class="literal">TRUE</code> to set networking enabled, <code class="literal">FALSE</code> to set networking disabled</p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>error</p></td> -<td class="parameter_description"><p>return location for a <span class="type">GError</span>, or <code class="literal">NULL</code></p></td> -<td class="parameter_annotations"> </td> -</tr> -</tbody> -</table></div> -</div> -<div class="refsect3"> -<a name="nm-client-networking-set-enabled.returns"></a><h4>Returns</h4> -<p> <code class="literal">TRUE</code> on success, <code class="literal">FALSE</code> otherwise</p> -</div> -</div> -<hr> -<div class="refsect2"> -<a name="nm-client-wireless-get-enabled"></a><h3>nm_client_wireless_get_enabled ()</h3> -<pre class="programlisting"><span class="returnvalue">gboolean</span> -nm_client_wireless_get_enabled (<em class="parameter"><code><a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a> *client</code></em>);</pre> -<p>Determines whether the wireless is enabled.</p> -<div class="refsect3"> -<a name="nm-client-wireless-get-enabled.parameters"></a><h4>Parameters</h4> -<div class="informaltable"><table class="informaltable" width="100%" border="0"> -<colgroup> -<col width="150px" class="parameters_name"> -<col class="parameters_description"> -<col width="200px" class="parameters_annotations"> -</colgroup> -<tbody><tr> -<td class="parameter_name"><p>client</p></td> -<td class="parameter_description"><p>a <a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a></p></td> -<td class="parameter_annotations"> </td> -</tr></tbody> -</table></div> -</div> -<div class="refsect3"> -<a name="nm-client-wireless-get-enabled.returns"></a><h4>Returns</h4> -<p> <code class="literal">TRUE</code> if wireless is enabled</p> -</div> -</div> -<hr> -<div class="refsect2"> -<a name="nm-client-wireless-set-enabled"></a><h3>nm_client_wireless_set_enabled ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> -nm_client_wireless_set_enabled (<em class="parameter"><code><a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a> *client</code></em>, - <em class="parameter"><code><span class="type">gboolean</span> enabled</code></em>);</pre> -<div class="warning"> -<p><code class="literal">nm_client_wireless_set_enabled</code> has been deprecated since version 1.22 and should not be used in newly-written code.</p> -<p>Use the async command <a class="link" href="NMClient.html#nm-client-dbus-set-property" title="nm_client_dbus_set_property ()"><code class="function">nm_client_dbus_set_property()</code></a> on <a class="link" href="libnm-nm-dbus-interface.html#NM-DBUS-PATH:CAPS" title="NM_DBUS_PATH"><code class="literal">NM_DBUS_PATH</code></a>, -<a class="link" href="libnm-nm-dbus-interface.html#NM-DBUS-INTERFACE:CAPS" title="NM_DBUS_INTERFACE"><code class="literal">NM_DBUS_INTERFACE</code></a> to set "WirelessEnabled" property to a "(b)" value.</p> -</div> -<p>Enables or disables wireless devices.</p> -<div class="refsect3"> -<a name="nm-client-wireless-set-enabled.parameters"></a><h4>Parameters</h4> -<div class="informaltable"><table class="informaltable" width="100%" border="0"> -<colgroup> -<col width="150px" class="parameters_name"> -<col class="parameters_description"> -<col width="200px" class="parameters_annotations"> -</colgroup> -<tbody> -<tr> -<td class="parameter_name"><p>client</p></td> -<td class="parameter_description"><p>a <a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a></p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>enabled</p></td> -<td class="parameter_description"><p><code class="literal">TRUE</code> to enable wireless</p></td> -<td class="parameter_annotations"> </td> -</tr> -</tbody> -</table></div> -</div> -</div> -<hr> -<div class="refsect2"> -<a name="nm-client-wireless-hardware-get-enabled"></a><h3>nm_client_wireless_hardware_get_enabled ()</h3> -<pre class="programlisting"><span class="returnvalue">gboolean</span> -nm_client_wireless_hardware_get_enabled - (<em class="parameter"><code><a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a> *client</code></em>);</pre> -<p>Determines whether the wireless hardware is enabled.</p> -<div class="refsect3"> -<a name="nm-client-wireless-hardware-get-enabled.parameters"></a><h4>Parameters</h4> -<div class="informaltable"><table class="informaltable" width="100%" border="0"> -<colgroup> -<col width="150px" class="parameters_name"> -<col class="parameters_description"> -<col width="200px" class="parameters_annotations"> -</colgroup> -<tbody><tr> -<td class="parameter_name"><p>client</p></td> -<td class="parameter_description"><p>a <a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a></p></td> -<td class="parameter_annotations"> </td> -</tr></tbody> -</table></div> -</div> -<div class="refsect3"> -<a name="nm-client-wireless-hardware-get-enabled.returns"></a><h4>Returns</h4> -<p> <code class="literal">TRUE</code> if the wireless hardware is enabled</p> -</div> -</div> -<hr> -<div class="refsect2"> -<a name="nm-client-wwan-get-enabled"></a><h3>nm_client_wwan_get_enabled ()</h3> -<pre class="programlisting"><span class="returnvalue">gboolean</span> -nm_client_wwan_get_enabled (<em class="parameter"><code><a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a> *client</code></em>);</pre> -<p>Determines whether WWAN is enabled.</p> -<div class="refsect3"> -<a name="nm-client-wwan-get-enabled.parameters"></a><h4>Parameters</h4> -<div class="informaltable"><table class="informaltable" width="100%" border="0"> -<colgroup> -<col width="150px" class="parameters_name"> -<col class="parameters_description"> -<col width="200px" class="parameters_annotations"> -</colgroup> -<tbody><tr> -<td class="parameter_name"><p>client</p></td> -<td class="parameter_description"><p>a <a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a></p></td> -<td class="parameter_annotations"> </td> -</tr></tbody> -</table></div> -</div> -<div class="refsect3"> -<a name="nm-client-wwan-get-enabled.returns"></a><h4>Returns</h4> -<p> <code class="literal">TRUE</code> if WWAN is enabled</p> -</div> -</div> -<hr> -<div class="refsect2"> -<a name="nm-client-wwan-set-enabled"></a><h3>nm_client_wwan_set_enabled ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> -nm_client_wwan_set_enabled (<em class="parameter"><code><a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a> *client</code></em>, - <em class="parameter"><code><span class="type">gboolean</span> enabled</code></em>);</pre> -<div class="warning"> -<p><code class="literal">nm_client_wwan_set_enabled</code> has been deprecated since version 1.22 and should not be used in newly-written code.</p> -<p>Use the async command <a class="link" href="NMClient.html#nm-client-dbus-set-property" title="nm_client_dbus_set_property ()"><code class="function">nm_client_dbus_set_property()</code></a> on <a class="link" href="libnm-nm-dbus-interface.html#NM-DBUS-PATH:CAPS" title="NM_DBUS_PATH"><code class="literal">NM_DBUS_PATH</code></a>, -<a class="link" href="libnm-nm-dbus-interface.html#NM-DBUS-INTERFACE:CAPS" title="NM_DBUS_INTERFACE"><code class="literal">NM_DBUS_INTERFACE</code></a> to set "WwanEnabled" property to a "(b)" value.</p> -</div> -<p>Enables or disables WWAN devices.</p> -<div class="refsect3"> -<a name="nm-client-wwan-set-enabled.parameters"></a><h4>Parameters</h4> -<div class="informaltable"><table class="informaltable" width="100%" border="0"> -<colgroup> -<col width="150px" class="parameters_name"> -<col class="parameters_description"> -<col width="200px" class="parameters_annotations"> -</colgroup> -<tbody> -<tr> -<td class="parameter_name"><p>client</p></td> -<td class="parameter_description"><p>a <a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a></p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>enabled</p></td> -<td class="parameter_description"><p><code class="literal">TRUE</code> to enable WWAN</p></td> -<td class="parameter_annotations"> </td> -</tr> -</tbody> -</table></div> -</div> -</div> -<hr> -<div class="refsect2"> -<a name="nm-client-wwan-hardware-get-enabled"></a><h3>nm_client_wwan_hardware_get_enabled ()</h3> -<pre class="programlisting"><span class="returnvalue">gboolean</span> -nm_client_wwan_hardware_get_enabled (<em class="parameter"><code><a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a> *client</code></em>);</pre> -<p>Determines whether the WWAN hardware is enabled.</p> -<div class="refsect3"> -<a name="nm-client-wwan-hardware-get-enabled.parameters"></a><h4>Parameters</h4> -<div class="informaltable"><table class="informaltable" width="100%" border="0"> -<colgroup> -<col width="150px" class="parameters_name"> -<col class="parameters_description"> -<col width="200px" class="parameters_annotations"> -</colgroup> -<tbody><tr> -<td class="parameter_name"><p>client</p></td> -<td class="parameter_description"><p>a <a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a></p></td> -<td class="parameter_annotations"> </td> -</tr></tbody> -</table></div> -</div> -<div class="refsect3"> -<a name="nm-client-wwan-hardware-get-enabled.returns"></a><h4>Returns</h4> -<p> <code class="literal">TRUE</code> if the WWAN hardware is enabled</p> -</div> -</div> -<hr> -<div class="refsect2"> -<a name="nm-client-wimax-get-enabled"></a><h3>nm_client_wimax_get_enabled ()</h3> -<pre class="programlisting"><span class="returnvalue">gboolean</span> -nm_client_wimax_get_enabled (<em class="parameter"><code><a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a> *client</code></em>);</pre> -<div class="warning"> -<p><code class="literal">nm_client_wimax_get_enabled</code> has been deprecated since version 1.22 and should not be used in newly-written code.</p> -<p>This function always returns FALSE because WiMax is no longer supported.</p> -</div> -<p>Determines whether WiMAX is enabled.</p> -<div class="refsect3"> -<a name="nm-client-wimax-get-enabled.parameters"></a><h4>Parameters</h4> -<div class="informaltable"><table class="informaltable" width="100%" border="0"> -<colgroup> -<col width="150px" class="parameters_name"> -<col class="parameters_description"> -<col width="200px" class="parameters_annotations"> -</colgroup> -<tbody><tr> -<td class="parameter_name"><p>client</p></td> -<td class="parameter_description"><p>a <a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a></p></td> -<td class="parameter_annotations"> </td> -</tr></tbody> -</table></div> -</div> -<div class="refsect3"> -<a name="nm-client-wimax-get-enabled.returns"></a><h4>Returns</h4> -<p> <code class="literal">TRUE</code> if WiMAX is enabled</p> -</div> -</div> -<hr> -<div class="refsect2"> -<a name="nm-client-wimax-set-enabled"></a><h3>nm_client_wimax_set_enabled ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> -nm_client_wimax_set_enabled (<em class="parameter"><code><a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a> *client</code></em>, - <em class="parameter"><code><span class="type">gboolean</span> enabled</code></em>);</pre> -<div class="warning"> -<p><code class="literal">nm_client_wimax_set_enabled</code> has been deprecated since version 1.22 and should not be used in newly-written code.</p> -<p>This function does nothing because WiMax is no longer supported.</p> -</div> -<p>Enables or disables WiMAX devices.</p> -<div class="refsect3"> -<a name="nm-client-wimax-set-enabled.parameters"></a><h4>Parameters</h4> -<div class="informaltable"><table class="informaltable" width="100%" border="0"> -<colgroup> -<col width="150px" class="parameters_name"> -<col class="parameters_description"> -<col width="200px" class="parameters_annotations"> -</colgroup> -<tbody> -<tr> -<td class="parameter_name"><p>client</p></td> -<td class="parameter_description"><p>a <a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a></p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>enabled</p></td> -<td class="parameter_description"><p><code class="literal">TRUE</code> to enable WiMAX</p></td> -<td class="parameter_annotations"> </td> -</tr> -</tbody> -</table></div> -</div> -</div> -<hr> -<div class="refsect2"> -<a name="nm-client-wimax-hardware-get-enabled"></a><h3>nm_client_wimax_hardware_get_enabled ()</h3> -<pre class="programlisting"><span class="returnvalue">gboolean</span> -nm_client_wimax_hardware_get_enabled (<em class="parameter"><code><a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a> *client</code></em>);</pre> -<div class="warning"> -<p><code class="literal">nm_client_wimax_hardware_get_enabled</code> has been deprecated since version 1.22 and should not be used in newly-written code.</p> -<p>This function always returns FALSE because WiMax is no longer supported.</p> -</div> -<p>Determines whether the WiMAX hardware is enabled.</p> -<div class="refsect3"> -<a name="nm-client-wimax-hardware-get-enabled.parameters"></a><h4>Parameters</h4> -<div class="informaltable"><table class="informaltable" width="100%" border="0"> -<colgroup> -<col width="150px" class="parameters_name"> -<col class="parameters_description"> -<col width="200px" class="parameters_annotations"> -</colgroup> -<tbody><tr> -<td class="parameter_name"><p>client</p></td> -<td class="parameter_description"><p>a <a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a></p></td> -<td class="parameter_annotations"> </td> -</tr></tbody> -</table></div> -</div> -<div class="refsect3"> -<a name="nm-client-wimax-hardware-get-enabled.returns"></a><h4>Returns</h4> -<p> <code class="literal">TRUE</code> if the WiMAX hardware is enabled</p> -</div> -</div> -<hr> -<div class="refsect2"> -<a name="nm-client-get-radio-flags"></a><h3>nm_client_get_radio_flags ()</h3> -<pre class="programlisting"><a class="link" href="libnm-nm-dbus-interface.html#NMRadioFlags" title="enum NMRadioFlags"><span class="returnvalue">NMRadioFlags</span></a> -nm_client_get_radio_flags (<em class="parameter"><code><a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a> *client</code></em>);</pre> -<p>Get radio flags.</p> -<div class="refsect3"> -<a name="nm-client-get-radio-flags.parameters"></a><h4>Parameters</h4> -<div class="informaltable"><table class="informaltable" width="100%" border="0"> -<colgroup> -<col width="150px" class="parameters_name"> -<col class="parameters_description"> -<col width="200px" class="parameters_annotations"> -</colgroup> -<tbody><tr> -<td class="parameter_name"><p>client</p></td> -<td class="parameter_description"><p>a <a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a></p></td> -<td class="parameter_annotations"> </td> -</tr></tbody> -</table></div> -</div> -<div class="refsect3"> -<a name="nm-client-get-radio-flags.returns"></a><h4>Returns</h4> -<p> the <a class="link" href="libnm-nm-dbus-interface.html#NMRadioFlags" title="enum NMRadioFlags"><span class="type">NMRadioFlags</span></a>.</p> -</div> -<p class="since">Since: 1.38</p> -</div> -<hr> -<div class="refsect2"> -<a name="nm-client-connectivity-check-get-available"></a><h3>nm_client_connectivity_check_get_available ()</h3> -<pre class="programlisting"><span class="returnvalue">gboolean</span> -nm_client_connectivity_check_get_available - (<em class="parameter"><code><a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a> *client</code></em>);</pre> -<p>Determine whether connectivity checking is available. This -requires that the URI of a connectivity service has been set in the -configuration file.</p> -<div class="refsect3"> -<a name="nm-client-connectivity-check-get-available.parameters"></a><h4>Parameters</h4> -<div class="informaltable"><table class="informaltable" width="100%" border="0"> -<colgroup> -<col width="150px" class="parameters_name"> -<col class="parameters_description"> -<col width="200px" class="parameters_annotations"> -</colgroup> -<tbody><tr> -<td class="parameter_name"><p>client</p></td> -<td class="parameter_description"><p>a <a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a></p></td> -<td class="parameter_annotations"> </td> -</tr></tbody> -</table></div> -</div> -<div class="refsect3"> -<a name="nm-client-connectivity-check-get-available.returns"></a><h4>Returns</h4> -<p> <code class="literal">TRUE</code> if connectivity checking is available.</p> -</div> -<p class="since">Since: 1.10</p> -</div> -<hr> -<div class="refsect2"> -<a name="nm-client-connectivity-check-get-enabled"></a><h3>nm_client_connectivity_check_get_enabled ()</h3> -<pre class="programlisting"><span class="returnvalue">gboolean</span> -nm_client_connectivity_check_get_enabled - (<em class="parameter"><code><a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a> *client</code></em>);</pre> -<p>Determine whether connectivity checking is enabled.</p> -<div class="refsect3"> -<a name="nm-client-connectivity-check-get-enabled.parameters"></a><h4>Parameters</h4> -<div class="informaltable"><table class="informaltable" width="100%" border="0"> -<colgroup> -<col width="150px" class="parameters_name"> -<col class="parameters_description"> -<col width="200px" class="parameters_annotations"> -</colgroup> -<tbody><tr> -<td class="parameter_name"><p>client</p></td> -<td class="parameter_description"><p>a <a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a></p></td> -<td class="parameter_annotations"> </td> -</tr></tbody> -</table></div> -</div> -<div class="refsect3"> -<a name="nm-client-connectivity-check-get-enabled.returns"></a><h4>Returns</h4> -<p> <code class="literal">TRUE</code> if connectivity checking is enabled.</p> -</div> -<p class="since">Since: 1.10</p> -</div> -<hr> -<div class="refsect2"> -<a name="nm-client-connectivity-check-set-enabled"></a><h3>nm_client_connectivity_check_set_enabled ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> -nm_client_connectivity_check_set_enabled - (<em class="parameter"><code><a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a> *client</code></em>, - <em class="parameter"><code><span class="type">gboolean</span> enabled</code></em>);</pre> -<div class="warning"> -<p><code class="literal">nm_client_connectivity_check_set_enabled</code> has been deprecated since version 1.22 and should not be used in newly-written code.</p> -<p>Use the async command <a class="link" href="NMClient.html#nm-client-dbus-set-property" title="nm_client_dbus_set_property ()"><code class="function">nm_client_dbus_set_property()</code></a> on <a class="link" href="libnm-nm-dbus-interface.html#NM-DBUS-PATH:CAPS" title="NM_DBUS_PATH"><code class="literal">NM_DBUS_PATH</code></a>, -<a class="link" href="libnm-nm-dbus-interface.html#NM-DBUS-INTERFACE:CAPS" title="NM_DBUS_INTERFACE"><code class="literal">NM_DBUS_INTERFACE</code></a> to set "ConnectivityCheckEnabled" property to a "(b)" value.</p> -</div> -<p>Enable or disable connectivity checking. Note that if a -connectivity checking URI has not been configured, this will not -have any effect.</p> -<div class="refsect3"> -<a name="nm-client-connectivity-check-set-enabled.parameters"></a><h4>Parameters</h4> -<div class="informaltable"><table class="informaltable" width="100%" border="0"> -<colgroup> -<col width="150px" class="parameters_name"> -<col class="parameters_description"> -<col width="200px" class="parameters_annotations"> -</colgroup> -<tbody> -<tr> -<td class="parameter_name"><p>client</p></td> -<td class="parameter_description"><p>a <a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a></p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>enabled</p></td> -<td class="parameter_description"><p><code class="literal">TRUE</code> to enable connectivity checking</p></td> -<td class="parameter_annotations"> </td> -</tr> -</tbody> -</table></div> -</div> -<p class="since">Since: 1.10</p> -</div> -<hr> -<div class="refsect2"> -<a name="nm-client-connectivity-check-get-uri"></a><h3>nm_client_connectivity_check_get_uri ()</h3> -<pre class="programlisting">const <span class="returnvalue">char</span> * -nm_client_connectivity_check_get_uri (<em class="parameter"><code><a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a> *client</code></em>);</pre> -<p>Get the URI that will be queried to determine if there is internet -connectivity.</p> -<div class="refsect3"> -<a name="nm-client-connectivity-check-get-uri.parameters"></a><h4>Parameters</h4> -<div class="informaltable"><table class="informaltable" width="100%" border="0"> -<colgroup> -<col width="150px" class="parameters_name"> -<col class="parameters_description"> -<col width="200px" class="parameters_annotations"> -</colgroup> -<tbody><tr> -<td class="parameter_name"><p>client</p></td> -<td class="parameter_description"><p>a <a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a></p></td> -<td class="parameter_annotations"> </td> -</tr></tbody> -</table></div> -</div> -<div class="refsect3"> -<a name="nm-client-connectivity-check-get-uri.returns"></a><h4>Returns</h4> -<p>the connectivity URI in use. </p> -<p><span class="annotation">[<acronym title="The data is owned by the callee, which is responsible of freeing it."><span class="acronym">transfer none</span></acronym>]</span></p> -</div> -<p class="since">Since: 1.20</p> -</div> -<hr> -<div class="refsect2"> -<a name="nm-client-get-logging"></a><h3>nm_client_get_logging ()</h3> -<pre class="programlisting"><span class="returnvalue">gboolean</span> -nm_client_get_logging (<em class="parameter"><code><a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a> *client</code></em>, - <em class="parameter"><code><span class="type">char</span> **level</code></em>, - <em class="parameter"><code><span class="type">char</span> **domains</code></em>, - <em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre> -<div class="warning"> -<p><code class="literal">nm_client_get_logging</code> has been deprecated since version 1.22 and should not be used in newly-written code.</p> -<p>Use the async command <a class="link" href="NMClient.html#nm-client-dbus-call" title="nm_client_dbus_call ()"><code class="function">nm_client_dbus_call()</code></a> on <a class="link" href="libnm-nm-dbus-interface.html#NM-DBUS-PATH:CAPS" title="NM_DBUS_PATH"><code class="literal">NM_DBUS_PATH</code></a>, -<a class="link" href="libnm-nm-dbus-interface.html#NM-DBUS-INTERFACE:CAPS" title="NM_DBUS_INTERFACE"><code class="literal">NM_DBUS_INTERFACE</code></a> to call "GetLogging" with no arguments to get "(ss)" for level -and domains.</p> -</div> -<p>Gets NetworkManager current logging level and domains.</p> -<div class="refsect3"> -<a name="nm-client-get-logging.parameters"></a><h4>Parameters</h4> -<div class="informaltable"><table class="informaltable" width="100%" border="0"> -<colgroup> -<col width="150px" class="parameters_name"> -<col class="parameters_description"> -<col width="200px" class="parameters_annotations"> -</colgroup> -<tbody> -<tr> -<td class="parameter_name"><p>client</p></td> -<td class="parameter_description"><p>a <a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a></p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>level</p></td> -<td class="parameter_description"><p>return location for logging level string. </p></td> -<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL may be passed instead of a pointer to a location."><span class="acronym">optional</span></acronym>][<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td> -</tr> -<tr> -<td class="parameter_name"><p>domains</p></td> -<td class="parameter_description"><p>return location for log domains string. The string is -a list of domains separated by ",". </p></td> -<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL may be passed instead of a pointer to a location."><span class="acronym">optional</span></acronym>][<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td> -</tr> -<tr> -<td class="parameter_name"><p>error</p></td> -<td class="parameter_description"><p>return location for a <span class="type">GError</span>, or <code class="literal">NULL</code></p></td> -<td class="parameter_annotations"> </td> -</tr> -</tbody> -</table></div> -</div> -<div class="refsect3"> -<a name="nm-client-get-logging.returns"></a><h4>Returns</h4> -<p> <code class="literal">TRUE</code> on success, <code class="literal">FALSE</code> otherwise</p> -</div> -</div> -<hr> -<div class="refsect2"> -<a name="nm-client-set-logging"></a><h3>nm_client_set_logging ()</h3> -<pre class="programlisting"><span class="returnvalue">gboolean</span> -nm_client_set_logging (<em class="parameter"><code><a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a> *client</code></em>, - <em class="parameter"><code>const <span class="type">char</span> *level</code></em>, - <em class="parameter"><code>const <span class="type">char</span> *domains</code></em>, - <em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre> -<div class="warning"> -<p><code class="literal">nm_client_set_logging</code> has been deprecated since version 1.22 and should not be used in newly-written code.</p> -<p>Use the async command <a class="link" href="NMClient.html#nm-client-dbus-call" title="nm_client_dbus_call ()"><code class="function">nm_client_dbus_call()</code></a> on <a class="link" href="libnm-nm-dbus-interface.html#NM-DBUS-PATH:CAPS" title="NM_DBUS_PATH"><code class="literal">NM_DBUS_PATH</code></a>, -<a class="link" href="libnm-nm-dbus-interface.html#NM-DBUS-INTERFACE:CAPS" title="NM_DBUS_INTERFACE"><code class="literal">NM_DBUS_INTERFACE</code></a> to call "SetLogging" with "(ss)" arguments for level and domains.</p> -</div> -<p>Sets NetworkManager logging level and/or domains.</p> -<div class="refsect3"> -<a name="nm-client-set-logging.parameters"></a><h4>Parameters</h4> -<div class="informaltable"><table class="informaltable" width="100%" border="0"> -<colgroup> -<col width="150px" class="parameters_name"> -<col class="parameters_description"> -<col width="200px" class="parameters_annotations"> -</colgroup> -<tbody> -<tr> -<td class="parameter_name"><p>client</p></td> -<td class="parameter_description"><p>a <a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a></p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>level</p></td> -<td class="parameter_description"><p>logging level to set (<code class="literal">NULL</code> or an empty string for no change). </p></td> -<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td> -</tr> -<tr> -<td class="parameter_name"><p>domains</p></td> -<td class="parameter_description"><p>logging domains to set. The string should be a list of log -domains separated by ",". (<code class="literal">NULL</code> or an empty string for no change). </p></td> -<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td> -</tr> -<tr> -<td class="parameter_name"><p>error</p></td> -<td class="parameter_description"><p>return location for a <span class="type">GError</span>, or <code class="literal">NULL</code></p></td> -<td class="parameter_annotations"> </td> -</tr> -</tbody> -</table></div> -</div> -<div class="refsect3"> -<a name="nm-client-set-logging.returns"></a><h4>Returns</h4> -<p> <code class="literal">TRUE</code> on success, <code class="literal">FALSE</code> otherwise</p> -</div> -</div> -<hr> -<div class="refsect2"> -<a name="nm-client-get-permission-result"></a><h3>nm_client_get_permission_result ()</h3> -<pre class="programlisting"><a class="link" href="libnm-nm-dbus-interface.html#NMClientPermissionResult" title="enum NMClientPermissionResult"><span class="returnvalue">NMClientPermissionResult</span></a> -nm_client_get_permission_result (<em class="parameter"><code><a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a> *client</code></em>, - <em class="parameter"><code><a class="link" href="libnm-nm-dbus-interface.html#NMClientPermission" title="enum NMClientPermission"><span class="type">NMClientPermission</span></a> permission</code></em>);</pre> -<p>Requests the result of a specific permission, which indicates whether the -client can or cannot perform the action the permission represents</p> -<div class="refsect3"> -<a name="nm-client-get-permission-result.parameters"></a><h4>Parameters</h4> -<div class="informaltable"><table class="informaltable" width="100%" border="0"> -<colgroup> -<col width="150px" class="parameters_name"> -<col class="parameters_description"> -<col width="200px" class="parameters_annotations"> -</colgroup> -<tbody> -<tr> -<td class="parameter_name"><p>client</p></td> -<td class="parameter_description"><p>a <a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a></p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>permission</p></td> -<td class="parameter_description"><p>the permission for which to return the result, one of <a class="link" href="libnm-nm-dbus-interface.html#NMClientPermission" title="enum NMClientPermission"><span class="type">NMClientPermission</span></a></p></td> -<td class="parameter_annotations"> </td> -</tr> -</tbody> -</table></div> -</div> -<div class="refsect3"> -<a name="nm-client-get-permission-result.returns"></a><h4>Returns</h4> -<p> the permission's result, one of <a class="link" href="libnm-nm-dbus-interface.html#NMClientPermissionResult" title="enum NMClientPermissionResult"><span class="type">NMClientPermissionResult</span></a></p> -</div> -</div> -<hr> -<div class="refsect2"> -<a name="nm-client-get-permissions-state"></a><h3>nm_client_get_permissions_state ()</h3> -<pre class="programlisting"><a class="link" href="libnm-nm-dbus-interface.html#NMTernary" title="enum NMTernary"><span class="returnvalue">NMTernary</span></a> -nm_client_get_permissions_state (<em class="parameter"><code><a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a> *self</code></em>);</pre> -<div class="refsect3"> -<a name="nm-client-get-permissions-state.parameters"></a><h4>Parameters</h4> -<div class="informaltable"><table class="informaltable" width="100%" border="0"> -<colgroup> -<col width="150px" class="parameters_name"> -<col class="parameters_description"> -<col width="200px" class="parameters_annotations"> -</colgroup> -<tbody><tr> -<td class="parameter_name"><p>self</p></td> -<td class="parameter_description"><p>the <a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a> instance</p></td> -<td class="parameter_annotations"> </td> -</tr></tbody> -</table></div> -</div> -<div class="refsect3"> -<a name="nm-client-get-permissions-state.returns"></a><h4>Returns</h4> -<p> the state of the cached permissions. <a class="link" href="libnm-nm-dbus-interface.html#NM-TERNARY-DEFAULT:CAPS"><code class="literal">NM_TERNARY_DEFAULT</code></a> -means that no permissions result was yet received. All permissions -are unknown. <a class="link" href="libnm-nm-dbus-interface.html#NM-TERNARY-TRUE:CAPS"><code class="literal">NM_TERNARY_TRUE</code></a> means that the permissions got received -and are cached. %<a class="link" href="libnm-nm-dbus-interface.html#NM-TERNARY-FALSE:CAPS"><code class="literal">NM_TERNARY_FALSE</code></a> means that permissions are cached, -but they are invalided as "CheckPermissions" signal was received -in the meantime.</p> -</div> -<p class="since">Since: 1.24</p> -</div> -<hr> -<div class="refsect2"> -<a name="nm-client-get-connectivity"></a><h3>nm_client_get_connectivity ()</h3> -<pre class="programlisting"><a class="link" href="libnm-nm-dbus-interface.html#NMConnectivityState" title="enum NMConnectivityState"><span class="returnvalue">NMConnectivityState</span></a> -nm_client_get_connectivity (<em class="parameter"><code><a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a> *client</code></em>);</pre> -<p>Gets the current network connectivity state. Contrast -<a class="link" href="NMClient.html#nm-client-check-connectivity" title="nm_client_check_connectivity ()"><code class="function">nm_client_check_connectivity()</code></a> and -<a class="link" href="NMClient.html#nm-client-check-connectivity-async" title="nm_client_check_connectivity_async ()"><code class="function">nm_client_check_connectivity_async()</code></a>, which re-check the -connectivity state first before returning any information.</p> -<div class="refsect3"> -<a name="nm-client-get-connectivity.parameters"></a><h4>Parameters</h4> -<div class="informaltable"><table class="informaltable" width="100%" border="0"> -<colgroup> -<col width="150px" class="parameters_name"> -<col class="parameters_description"> -<col width="200px" class="parameters_annotations"> -</colgroup> -<tbody><tr> -<td class="parameter_name"><p>client</p></td> -<td class="parameter_description"><p>an <a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a></p></td> -<td class="parameter_annotations"> </td> -</tr></tbody> -</table></div> -</div> -<div class="refsect3"> -<a name="nm-client-get-connectivity.returns"></a><h4>Returns</h4> -<p> the current connectivity state</p> -</div> -</div> -<hr> -<div class="refsect2"> -<a name="nm-client-check-connectivity"></a><h3>nm_client_check_connectivity ()</h3> -<pre class="programlisting"><a class="link" href="libnm-nm-dbus-interface.html#NMConnectivityState" title="enum NMConnectivityState"><span class="returnvalue">NMConnectivityState</span></a> -nm_client_check_connectivity (<em class="parameter"><code><a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a> *client</code></em>, - <em class="parameter"><code><span class="type">GCancellable</span> *cancellable</code></em>, - <em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre> -<div class="warning"> -<p><code class="literal">nm_client_check_connectivity</code> has been deprecated since version 1.22 and should not be used in newly-written code.</p> -<p>Use <a class="link" href="NMClient.html#nm-client-check-connectivity-async" title="nm_client_check_connectivity_async ()"><code class="function">nm_client_check_connectivity_async()</code></a> or GDBusConnection.</p> -</div> -<p>Updates the network connectivity state and returns the (new) -current state. Contrast <a class="link" href="NMClient.html#nm-client-get-connectivity" title="nm_client_get_connectivity ()"><code class="function">nm_client_get_connectivity()</code></a>, which returns -the most recent known state without re-checking.</p> -<p>This is a blocking call; use <a class="link" href="NMClient.html#nm-client-check-connectivity-async" title="nm_client_check_connectivity_async ()"><code class="function">nm_client_check_connectivity_async()</code></a> -if you do not want to block.</p> -<div class="refsect3"> -<a name="nm-client-check-connectivity.parameters"></a><h4>Parameters</h4> -<div class="informaltable"><table class="informaltable" width="100%" border="0"> -<colgroup> -<col width="150px" class="parameters_name"> -<col class="parameters_description"> -<col width="200px" class="parameters_annotations"> -</colgroup> -<tbody> -<tr> -<td class="parameter_name"><p>client</p></td> -<td class="parameter_description"><p>an <a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a></p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>cancellable</p></td> -<td class="parameter_description"><p>a <span class="type">GCancellable</span></p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>error</p></td> -<td class="parameter_description"><p>return location for a <span class="type">GError</span></p></td> -<td class="parameter_annotations"> </td> -</tr> -</tbody> -</table></div> -</div> -<div class="refsect3"> -<a name="nm-client-check-connectivity.returns"></a><h4>Returns</h4> -<p> the (new) current connectivity state</p> -</div> -</div> -<hr> -<div class="refsect2"> -<a name="nm-client-check-connectivity-async"></a><h3>nm_client_check_connectivity_async ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> -nm_client_check_connectivity_async (<em class="parameter"><code><a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a> *client</code></em>, - <em class="parameter"><code><span class="type">GCancellable</span> *cancellable</code></em>, - <em class="parameter"><code><span class="type">GAsyncReadyCallback</span> callback</code></em>, - <em class="parameter"><code><span class="type">gpointer</span> user_data</code></em>);</pre> -<p>Asynchronously updates the network connectivity state and invokes -<em class="parameter"><code>callback</code></em> - when complete. Contrast <a class="link" href="NMClient.html#nm-client-get-connectivity" title="nm_client_get_connectivity ()"><code class="function">nm_client_get_connectivity()</code></a>, -which (immediately) returns the most recent known state without -re-checking, and <a class="link" href="NMClient.html#nm-client-check-connectivity" title="nm_client_check_connectivity ()"><code class="function">nm_client_check_connectivity()</code></a>, which blocks.</p> -<div class="refsect3"> -<a name="nm-client-check-connectivity-async.parameters"></a><h4>Parameters</h4> -<div class="informaltable"><table class="informaltable" width="100%" border="0"> -<colgroup> -<col width="150px" class="parameters_name"> -<col class="parameters_description"> -<col width="200px" class="parameters_annotations"> -</colgroup> -<tbody> -<tr> -<td class="parameter_name"><p>client</p></td> -<td class="parameter_description"><p>an <a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a></p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>cancellable</p></td> -<td class="parameter_description"><p>a <span class="type">GCancellable</span></p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>callback</p></td> -<td class="parameter_description"><p>callback to call with the result</p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>user_data</p></td> -<td class="parameter_description"><p>data for <em class="parameter"><code>callback</code></em> -.</p></td> -<td class="parameter_annotations"> </td> -</tr> -</tbody> -</table></div> -</div> -</div> -<hr> -<div class="refsect2"> -<a name="nm-client-check-connectivity-finish"></a><h3>nm_client_check_connectivity_finish ()</h3> -<pre class="programlisting"><a class="link" href="libnm-nm-dbus-interface.html#NMConnectivityState" title="enum NMConnectivityState"><span class="returnvalue">NMConnectivityState</span></a> -nm_client_check_connectivity_finish (<em class="parameter"><code><a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a> *client</code></em>, - <em class="parameter"><code><span class="type">GAsyncResult</span> *result</code></em>, - <em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre> -<p>Retrieves the result of an <a class="link" href="NMClient.html#nm-client-check-connectivity-async" title="nm_client_check_connectivity_async ()"><code class="function">nm_client_check_connectivity_async()</code></a> -call.</p> -<div class="refsect3"> -<a name="nm-client-check-connectivity-finish.parameters"></a><h4>Parameters</h4> -<div class="informaltable"><table class="informaltable" width="100%" border="0"> -<colgroup> -<col width="150px" class="parameters_name"> -<col class="parameters_description"> -<col width="200px" class="parameters_annotations"> -</colgroup> -<tbody> -<tr> -<td class="parameter_name"><p>client</p></td> -<td class="parameter_description"><p>an <a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a></p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>result</p></td> -<td class="parameter_description"><p>the <span class="type">GAsyncResult</span></p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>error</p></td> -<td class="parameter_description"><p>return location for a <span class="type">GError</span></p></td> -<td class="parameter_annotations"> </td> -</tr> -</tbody> -</table></div> -</div> -<div class="refsect3"> -<a name="nm-client-check-connectivity-finish.returns"></a><h4>Returns</h4> -<p> the (new) current connectivity state</p> -</div> -</div> -<hr> -<div class="refsect2"> -<a name="nm-client-save-hostname"></a><h3>nm_client_save_hostname ()</h3> -<pre class="programlisting"><span class="returnvalue">gboolean</span> -nm_client_save_hostname (<em class="parameter"><code><a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a> *client</code></em>, - <em class="parameter"><code>const <span class="type">char</span> *hostname</code></em>, - <em class="parameter"><code><span class="type">GCancellable</span> *cancellable</code></em>, - <em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre> -<div class="warning"> -<p><code class="literal">nm_client_save_hostname</code> has been deprecated since version 1.22 and should not be used in newly-written code.</p> -<p>Use <a class="link" href="NMClient.html#nm-client-save-hostname-async" title="nm_client_save_hostname_async ()"><code class="function">nm_client_save_hostname_async()</code></a> or GDBusConnection.</p> -</div> -<p>Requests that the machine's persistent hostname be set to the specified value -or cleared.</p> -<div class="refsect3"> -<a name="nm-client-save-hostname.parameters"></a><h4>Parameters</h4> -<div class="informaltable"><table class="informaltable" width="100%" border="0"> -<colgroup> -<col width="150px" class="parameters_name"> -<col class="parameters_description"> -<col width="200px" class="parameters_annotations"> -</colgroup> -<tbody> -<tr> -<td class="parameter_name"><p>client</p></td> -<td class="parameter_description"><p>the <a class="link" href="NMClient.html" title="NMClient"><code class="literal">NMClient</code></a></p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>hostname</p></td> -<td class="parameter_description"><p>the new persistent hostname to set, or <code class="literal">NULL</code> to -clear any existing persistent hostname. </p></td> -<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td> -</tr> -<tr> -<td class="parameter_name"><p>cancellable</p></td> -<td class="parameter_description"><p>a <span class="type">GCancellable</span>, or <code class="literal">NULL</code></p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>error</p></td> -<td class="parameter_description"><p>return location for <span class="type">GError</span></p></td> -<td class="parameter_annotations"> </td> -</tr> -</tbody> -</table></div> -</div> -<div class="refsect3"> -<a name="nm-client-save-hostname.returns"></a><h4>Returns</h4> -<p> <code class="literal">TRUE</code> if the request was successful, <code class="literal">FALSE</code> if it failed</p> -</div> -</div> -<hr> -<div class="refsect2"> -<a name="nm-client-save-hostname-async"></a><h3>nm_client_save_hostname_async ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> -nm_client_save_hostname_async (<em class="parameter"><code><a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a> *client</code></em>, - <em class="parameter"><code>const <span class="type">char</span> *hostname</code></em>, - <em class="parameter"><code><span class="type">GCancellable</span> *cancellable</code></em>, - <em class="parameter"><code><span class="type">GAsyncReadyCallback</span> callback</code></em>, - <em class="parameter"><code><span class="type">gpointer</span> user_data</code></em>);</pre> -<p>Requests that the machine's persistent hostname be set to the specified value -or cleared.</p> -<div class="refsect3"> -<a name="nm-client-save-hostname-async.parameters"></a><h4>Parameters</h4> -<div class="informaltable"><table class="informaltable" width="100%" border="0"> -<colgroup> -<col width="150px" class="parameters_name"> -<col class="parameters_description"> -<col width="200px" class="parameters_annotations"> -</colgroup> -<tbody> -<tr> -<td class="parameter_name"><p>client</p></td> -<td class="parameter_description"><p>the <a class="link" href="NMClient.html" title="NMClient"><code class="literal">NMClient</code></a></p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>hostname</p></td> -<td class="parameter_description"><p>the new persistent hostname to set, or <code class="literal">NULL</code> to -clear any existing persistent hostname. </p></td> -<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td> -</tr> -<tr> -<td class="parameter_name"><p>cancellable</p></td> -<td class="parameter_description"><p>a <span class="type">GCancellable</span>, or <code class="literal">NULL</code></p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>callback</p></td> -<td class="parameter_description"><p>callback to be called when the operation completes. </p></td> -<td class="parameter_annotations"><span class="annotation">[<acronym title="The callback is valid until first called."><span class="acronym">scope async</span></acronym>]</span></td> -</tr> -<tr> -<td class="parameter_name"><p>user_data</p></td> -<td class="parameter_description"><p>caller-specific data passed to <em class="parameter"><code>callback</code></em> -. </p></td> -<td class="parameter_annotations"><span class="annotation">[<acronym title="This parameter is a 'user_data', for callbacks; many bindings can pass NULL here."><span class="acronym">closure</span></acronym>]</span></td> -</tr> -</tbody> -</table></div> -</div> -</div> -<hr> -<div class="refsect2"> -<a name="nm-client-save-hostname-finish"></a><h3>nm_client_save_hostname_finish ()</h3> -<pre class="programlisting"><span class="returnvalue">gboolean</span> -nm_client_save_hostname_finish (<em class="parameter"><code><a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a> *client</code></em>, - <em class="parameter"><code><span class="type">GAsyncResult</span> *result</code></em>, - <em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre> -<p>Gets the result of an <a class="link" href="NMClient.html#nm-client-save-hostname-async" title="nm_client_save_hostname_async ()"><code class="function">nm_client_save_hostname_async()</code></a> call.</p> -<div class="refsect3"> -<a name="nm-client-save-hostname-finish.parameters"></a><h4>Parameters</h4> -<div class="informaltable"><table class="informaltable" width="100%" border="0"> -<colgroup> -<col width="150px" class="parameters_name"> -<col class="parameters_description"> -<col width="200px" class="parameters_annotations"> -</colgroup> -<tbody> -<tr> -<td class="parameter_name"><p>client</p></td> -<td class="parameter_description"><p>the <a class="link" href="NMClient.html" title="NMClient"><code class="literal">NMClient</code></a></p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>result</p></td> -<td class="parameter_description"><p>the result passed to the <span class="type">GAsyncReadyCallback</span></p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>error</p></td> -<td class="parameter_description"><p>return location for <span class="type">GError</span></p></td> -<td class="parameter_annotations"> </td> -</tr> -</tbody> -</table></div> -</div> -<div class="refsect3"> -<a name="nm-client-save-hostname-finish.returns"></a><h4>Returns</h4> -<p> <code class="literal">TRUE</code> if the request was successful, <code class="literal">FALSE</code> if it failed</p> -</div> -</div> -<hr> -<div class="refsect2"> -<a name="nm-client-get-devices"></a><h3>nm_client_get_devices ()</h3> -<pre class="programlisting">const <span class="returnvalue">GPtrArray</span> * -nm_client_get_devices (<em class="parameter"><code><a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a> *client</code></em>);</pre> -<p>Gets all the known network devices. Use <code class="function">nm_device_get_type()</code> or the -<code class="literal">NM_IS_DEVICE_XXXX</code> functions to determine what kind of -device member of the returned array is, and then you may use device-specific -methods such as <a class="link" href="NMDeviceEthernet.html#nm-device-ethernet-get-hw-address" title="nm_device_ethernet_get_hw_address ()"><code class="function">nm_device_ethernet_get_hw_address()</code></a>.</p> -<div class="refsect3"> -<a name="nm-client-get-devices.parameters"></a><h4>Parameters</h4> -<div class="informaltable"><table class="informaltable" width="100%" border="0"> -<colgroup> -<col width="150px" class="parameters_name"> -<col class="parameters_description"> -<col width="200px" class="parameters_annotations"> -</colgroup> -<tbody><tr> -<td class="parameter_name"><p>client</p></td> -<td class="parameter_description"><p>a <a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a></p></td> -<td class="parameter_annotations"> </td> -</tr></tbody> -</table></div> -</div> -<div class="refsect3"> -<a name="nm-client-get-devices.returns"></a><h4>Returns</h4> -<p>a <span class="type">GPtrArray</span> -containing all the <span class="type">NMDevices</span>. The returned array is owned by the -<a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a> object and should not be modified. </p> -<p><span class="annotation">[<acronym title="The data is owned by the callee, which is responsible of freeing it."><span class="acronym">transfer none</span></acronym>][<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> NMDevice]</span></p> -</div> -</div> -<hr> -<div class="refsect2"> -<a name="nm-client-get-all-devices"></a><h3>nm_client_get_all_devices ()</h3> -<pre class="programlisting">const <span class="returnvalue">GPtrArray</span> * -nm_client_get_all_devices (<em class="parameter"><code><a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a> *client</code></em>);</pre> -<p>Gets both real devices and device placeholders (eg, software devices which -do not currently exist, but could be created automatically by NetworkManager -if one of their NMDevice::ActivatableConnections was activated). Use -<a class="link" href="NMDevice.html#nm-device-is-real" title="nm_device_is_real ()"><code class="function">nm_device_is_real()</code></a> to determine whether each device is a real device or -a placeholder.</p> -<p>Use <code class="function">nm_device_get_type()</code> or the <code class="function">NM_IS_DEVICE_XXXX()</code> functions to determine -what kind of device each member of the returned array is, and then you may -use device-specific methods such as <a class="link" href="NMDeviceEthernet.html#nm-device-ethernet-get-hw-address" title="nm_device_ethernet_get_hw_address ()"><code class="function">nm_device_ethernet_get_hw_address()</code></a>.</p> -<div class="refsect3"> -<a name="nm-client-get-all-devices.parameters"></a><h4>Parameters</h4> -<div class="informaltable"><table class="informaltable" width="100%" border="0"> -<colgroup> -<col width="150px" class="parameters_name"> -<col class="parameters_description"> -<col width="200px" class="parameters_annotations"> -</colgroup> -<tbody><tr> -<td class="parameter_name"><p>client</p></td> -<td class="parameter_description"><p>a <a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a></p></td> -<td class="parameter_annotations"> </td> -</tr></tbody> -</table></div> -</div> -<div class="refsect3"> -<a name="nm-client-get-all-devices.returns"></a><h4>Returns</h4> -<p>a <span class="type">GPtrArray</span> -containing all the <span class="type">NMDevices</span>. The returned array is owned by the -<a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a> object and should not be modified. </p> -<p><span class="annotation">[<acronym title="The data is owned by the callee, which is responsible of freeing it."><span class="acronym">transfer none</span></acronym>][<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> NMDevice]</span></p> -</div> -<p class="since">Since: 1.2</p> -</div> -<hr> -<div class="refsect2"> -<a name="nm-client-get-device-by-path"></a><h3>nm_client_get_device_by_path ()</h3> -<pre class="programlisting"><a class="link" href="NMDevice.html" title="NMDevice"><span class="returnvalue">NMDevice</span></a> * -nm_client_get_device_by_path (<em class="parameter"><code><a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a> *client</code></em>, - <em class="parameter"><code>const <span class="type">char</span> *object_path</code></em>);</pre> -<p>Gets a <a class="link" href="NMDevice.html" title="NMDevice"><span class="type">NMDevice</span></a> from a <a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a>.</p> -<div class="refsect3"> -<a name="nm-client-get-device-by-path.parameters"></a><h4>Parameters</h4> -<div class="informaltable"><table class="informaltable" width="100%" border="0"> -<colgroup> -<col width="150px" class="parameters_name"> -<col class="parameters_description"> -<col width="200px" class="parameters_annotations"> -</colgroup> -<tbody> -<tr> -<td class="parameter_name"><p>client</p></td> -<td class="parameter_description"><p>a <a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a></p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>object_path</p></td> -<td class="parameter_description"><p>the object path to search for</p></td> -<td class="parameter_annotations"> </td> -</tr> -</tbody> -</table></div> -</div> -<div class="refsect3"> -<a name="nm-client-get-device-by-path.returns"></a><h4>Returns</h4> -<p>the <a class="link" href="NMDevice.html" title="NMDevice"><span class="type">NMDevice</span></a> for the given <em class="parameter"><code>object_path</code></em> -or <code class="literal">NULL</code> if none is found. </p> -<p><span class="annotation">[<acronym title="The data is owned by the callee, which is responsible of freeing it."><span class="acronym">transfer none</span></acronym>]</span></p> -</div> -</div> -<hr> -<div class="refsect2"> -<a name="nm-client-get-device-by-iface"></a><h3>nm_client_get_device_by_iface ()</h3> -<pre class="programlisting"><a class="link" href="NMDevice.html" title="NMDevice"><span class="returnvalue">NMDevice</span></a> * -nm_client_get_device_by_iface (<em class="parameter"><code><a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a> *client</code></em>, - <em class="parameter"><code>const <span class="type">char</span> *iface</code></em>);</pre> -<p>Gets a <a class="link" href="NMDevice.html" title="NMDevice"><span class="type">NMDevice</span></a> from a <a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a>.</p> -<div class="refsect3"> -<a name="nm-client-get-device-by-iface.parameters"></a><h4>Parameters</h4> -<div class="informaltable"><table class="informaltable" width="100%" border="0"> -<colgroup> -<col width="150px" class="parameters_name"> -<col class="parameters_description"> -<col width="200px" class="parameters_annotations"> -</colgroup> -<tbody> -<tr> -<td class="parameter_name"><p>client</p></td> -<td class="parameter_description"><p>a <a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a></p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>iface</p></td> -<td class="parameter_description"><p>the interface name to search for</p></td> -<td class="parameter_annotations"> </td> -</tr> -</tbody> -</table></div> -</div> -<div class="refsect3"> -<a name="nm-client-get-device-by-iface.returns"></a><h4>Returns</h4> -<p>the <a class="link" href="NMDevice.html" title="NMDevice"><span class="type">NMDevice</span></a> for the given <em class="parameter"><code>iface</code></em> -or <code class="literal">NULL</code> if none is found. </p> -<p><span class="annotation">[<acronym title="The data is owned by the callee, which is responsible of freeing it."><span class="acronym">transfer none</span></acronym>]</span></p> -</div> -</div> -<hr> -<div class="refsect2"> -<a name="nm-client-get-active-connections"></a><h3>nm_client_get_active_connections ()</h3> -<pre class="programlisting">const <span class="returnvalue">GPtrArray</span> * -nm_client_get_active_connections (<em class="parameter"><code><a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a> *client</code></em>);</pre> -<p>Gets the active connections.</p> -<div class="refsect3"> -<a name="nm-client-get-active-connections.parameters"></a><h4>Parameters</h4> -<div class="informaltable"><table class="informaltable" width="100%" border="0"> -<colgroup> -<col width="150px" class="parameters_name"> -<col class="parameters_description"> -<col width="200px" class="parameters_annotations"> -</colgroup> -<tbody><tr> -<td class="parameter_name"><p>client</p></td> -<td class="parameter_description"><p>a <a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a></p></td> -<td class="parameter_annotations"> </td> -</tr></tbody> -</table></div> -</div> -<div class="refsect3"> -<a name="nm-client-get-active-connections.returns"></a><h4>Returns</h4> -<p>a <span class="type">GPtrArray</span> -containing all the active <a href="NMActiveConnection.html#NMActiveConnection-struct"><span class="type">NMActiveConnections</span></a>. -The returned array is owned by the client and should not be modified. </p> -<p><span class="annotation">[<acronym title="The data is owned by the callee, which is responsible of freeing it."><span class="acronym">transfer none</span></acronym>][<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> NMActiveConnection]</span></p> -</div> -</div> -<hr> -<div class="refsect2"> -<a name="nm-client-get-primary-connection"></a><h3>nm_client_get_primary_connection ()</h3> -<pre class="programlisting"><a class="link" href="NMActiveConnection.html" title="NMActiveConnection"><span class="returnvalue">NMActiveConnection</span></a> * -nm_client_get_primary_connection (<em class="parameter"><code><a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a> *client</code></em>);</pre> -<p>Gets the <a class="link" href="NMActiveConnection.html" title="NMActiveConnection"><span class="type">NMActiveConnection</span></a> corresponding to the primary active -network device.</p> -<p>In particular, when there is no VPN active, or the VPN does not -have the default route, this returns the active connection that has -the default route. If there is a VPN active with the default route, -then this function returns the active connection that contains the -route to the VPN endpoint.</p> -<p>If there is no default route, or the default route is over a -non-NetworkManager-recognized device, this will return <code class="literal">NULL</code>.</p> -<div class="refsect3"> -<a name="nm-client-get-primary-connection.parameters"></a><h4>Parameters</h4> -<div class="informaltable"><table class="informaltable" width="100%" border="0"> -<colgroup> -<col width="150px" class="parameters_name"> -<col class="parameters_description"> -<col width="200px" class="parameters_annotations"> -</colgroup> -<tbody><tr> -<td class="parameter_name"><p>client</p></td> -<td class="parameter_description"><p>an <a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a></p></td> -<td class="parameter_annotations"> </td> -</tr></tbody> -</table></div> -</div> -<div class="refsect3"> -<a name="nm-client-get-primary-connection.returns"></a><h4>Returns</h4> -<p>the appropriate <a class="link" href="NMActiveConnection.html" title="NMActiveConnection"><span class="type">NMActiveConnection</span></a>, if -any. </p> -<p><span class="annotation">[<acronym title="The data is owned by the callee, which is responsible of freeing it."><span class="acronym">transfer none</span></acronym>]</span></p> -</div> -</div> -<hr> -<div class="refsect2"> -<a name="nm-client-get-activating-connection"></a><h3>nm_client_get_activating_connection ()</h3> -<pre class="programlisting"><a class="link" href="NMActiveConnection.html" title="NMActiveConnection"><span class="returnvalue">NMActiveConnection</span></a> * -nm_client_get_activating_connection (<em class="parameter"><code><a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a> *client</code></em>);</pre> -<p>Gets the <a class="link" href="NMActiveConnection.html" title="NMActiveConnection"><span class="type">NMActiveConnection</span></a> corresponding to a -currently-activating connection that is expected to become the new -<a class="link" href="NMClient.html#NMClient--primary-connection" title="The “primary-connection” property"><span class="type">“primary-connection”</span></a> upon successful activation.</p> -<div class="refsect3"> -<a name="nm-client-get-activating-connection.parameters"></a><h4>Parameters</h4> -<div class="informaltable"><table class="informaltable" width="100%" border="0"> -<colgroup> -<col width="150px" class="parameters_name"> -<col class="parameters_description"> -<col width="200px" class="parameters_annotations"> -</colgroup> -<tbody><tr> -<td class="parameter_name"><p>client</p></td> -<td class="parameter_description"><p>an <a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a></p></td> -<td class="parameter_annotations"> </td> -</tr></tbody> -</table></div> -</div> -<div class="refsect3"> -<a name="nm-client-get-activating-connection.returns"></a><h4>Returns</h4> -<p>the appropriate <a class="link" href="NMActiveConnection.html" title="NMActiveConnection"><span class="type">NMActiveConnection</span></a>, if -any. </p> -<p><span class="annotation">[<acronym title="The data is owned by the callee, which is responsible of freeing it."><span class="acronym">transfer none</span></acronym>]</span></p> -</div> -</div> -<hr> -<div class="refsect2"> -<a name="nm-client-activate-connection-async"></a><h3>nm_client_activate_connection_async ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> -nm_client_activate_connection_async (<em class="parameter"><code><a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a> *client</code></em>, - <em class="parameter"><code><a class="link" href="NMConnection.html" title="NMConnection"><span class="type">NMConnection</span></a> *connection</code></em>, - <em class="parameter"><code><a class="link" href="NMDevice.html" title="NMDevice"><span class="type">NMDevice</span></a> *device</code></em>, - <em class="parameter"><code>const <span class="type">char</span> *specific_object</code></em>, - <em class="parameter"><code><span class="type">GCancellable</span> *cancellable</code></em>, - <em class="parameter"><code><span class="type">GAsyncReadyCallback</span> callback</code></em>, - <em class="parameter"><code><span class="type">gpointer</span> user_data</code></em>);</pre> -<p>Asynchronously starts a connection to a particular network using the -configuration settings from <em class="parameter"><code>connection</code></em> - and the network device <em class="parameter"><code>device</code></em> -. -Certain connection types also take a "specific object" which is the object -path of a connection- specific object, like an <a class="link" href="NMAccessPoint.html" title="NMAccessPoint"><span class="type">NMAccessPoint</span></a> for Wi-Fi -connections, or an <a class="link" href="NMWimaxNsp.html" title="NMWimaxNsp"><span class="type">NMWimaxNsp</span></a> for WiMAX connections, to which you wish to -connect. If the specific object is not given, NetworkManager can, in some -cases, automatically determine which network to connect to given the settings -in <em class="parameter"><code>connection</code></em> -.</p> -<p>If <em class="parameter"><code>connection</code></em> - is not given for a device-based activation, NetworkManager -picks the best available connection for the device and activates it.</p> -<p>Note that the callback is invoked when NetworkManager has started activating -the new connection, not when it finishes. You can use the returned -<a class="link" href="NMActiveConnection.html" title="NMActiveConnection"><span class="type">NMActiveConnection</span></a> object (in particular, <a class="link" href="NMActiveConnection.html#NMActiveConnection--state" title="The “state” property"><span class="type">“state”</span></a>) to -track the activation to its completion.</p> -<div class="refsect3"> -<a name="nm-client-activate-connection-async.parameters"></a><h4>Parameters</h4> -<div class="informaltable"><table class="informaltable" width="100%" border="0"> -<colgroup> -<col width="150px" class="parameters_name"> -<col class="parameters_description"> -<col width="200px" class="parameters_annotations"> -</colgroup> -<tbody> -<tr> -<td class="parameter_name"><p>client</p></td> -<td class="parameter_description"><p>a <a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a></p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>connection</p></td> -<td class="parameter_description"><p>an <a class="link" href="NMConnection.html" title="NMConnection"><span class="type">NMConnection</span></a>. </p></td> -<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td> -</tr> -<tr> -<td class="parameter_name"><p>device</p></td> -<td class="parameter_description"><p>the <a class="link" href="NMDevice.html" title="NMDevice"><span class="type">NMDevice</span></a>. </p></td> -<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td> -</tr> -<tr> -<td class="parameter_name"><p>specific_object</p></td> -<td class="parameter_description"><p>the object path of a connection-type-specific -object this activation should use. This parameter is currently ignored for -wired and mobile broadband connections, and the value of <code class="literal">NULL</code> should be used -(ie, no specific object). For Wi-Fi or WiMAX connections, pass the object -path of a <a class="link" href="NMAccessPoint.html" title="NMAccessPoint"><span class="type">NMAccessPoint</span></a> or <a class="link" href="NMWimaxNsp.html" title="NMWimaxNsp"><span class="type">NMWimaxNsp</span></a> owned by <em class="parameter"><code>device</code></em> -, which you can -get using <a class="link" href="NMObject.html#nm-object-get-path" title="nm_object_get_path ()"><code class="function">nm_object_get_path()</code></a>, and which will be used to complete the -details of the newly added connection. </p></td> -<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td> -</tr> -<tr> -<td class="parameter_name"><p>cancellable</p></td> -<td class="parameter_description"><p>a <span class="type">GCancellable</span>, or <code class="literal">NULL</code></p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>callback</p></td> -<td class="parameter_description"><p>callback to be called when the activation has started</p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>user_data</p></td> -<td class="parameter_description"><p>caller-specific data passed to <em class="parameter"><code>callback</code></em> -</p></td> -<td class="parameter_annotations"> </td> -</tr> -</tbody> -</table></div> -</div> -</div> -<hr> -<div class="refsect2"> -<a name="nm-client-activate-connection-finish"></a><h3>nm_client_activate_connection_finish ()</h3> -<pre class="programlisting"><a class="link" href="NMActiveConnection.html" title="NMActiveConnection"><span class="returnvalue">NMActiveConnection</span></a> * -nm_client_activate_connection_finish (<em class="parameter"><code><a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a> *client</code></em>, - <em class="parameter"><code><span class="type">GAsyncResult</span> *result</code></em>, - <em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre> -<p>Gets the result of a call to <a class="link" href="NMClient.html#nm-client-activate-connection-async" title="nm_client_activate_connection_async ()"><code class="function">nm_client_activate_connection_async()</code></a>.</p> -<div class="refsect3"> -<a name="nm-client-activate-connection-finish.parameters"></a><h4>Parameters</h4> -<div class="informaltable"><table class="informaltable" width="100%" border="0"> -<colgroup> -<col width="150px" class="parameters_name"> -<col class="parameters_description"> -<col width="200px" class="parameters_annotations"> -</colgroup> -<tbody> -<tr> -<td class="parameter_name"><p>client</p></td> -<td class="parameter_description"><p>an <a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a></p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>result</p></td> -<td class="parameter_description"><p>the result passed to the <span class="type">GAsyncReadyCallback</span></p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>error</p></td> -<td class="parameter_description"><p>location for a <span class="type">GError</span>, or <code class="literal">NULL</code></p></td> -<td class="parameter_annotations"> </td> -</tr> -</tbody> -</table></div> -</div> -<div class="refsect3"> -<a name="nm-client-activate-connection-finish.returns"></a><h4>Returns</h4> -<p>the new <a class="link" href="NMActiveConnection.html" title="NMActiveConnection"><span class="type">NMActiveConnection</span></a> on success, <code class="literal">NULL</code> on -failure, in which case <em class="parameter"><code>error</code></em> -will be set. </p> -<p><span class="annotation">[<acronym title="The caller owns the data, and is responsible for free it."><span class="acronym">transfer full</span></acronym>]</span></p> -</div> -</div> -<hr> -<div class="refsect2"> -<a name="nm-client-add-and-activate-connection-async"></a><h3>nm_client_add_and_activate_connection_async ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> -nm_client_add_and_activate_connection_async - (<em class="parameter"><code><a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a> *client</code></em>, - <em class="parameter"><code><a class="link" href="NMConnection.html" title="NMConnection"><span class="type">NMConnection</span></a> *partial</code></em>, - <em class="parameter"><code><a class="link" href="NMDevice.html" title="NMDevice"><span class="type">NMDevice</span></a> *device</code></em>, - <em class="parameter"><code>const <span class="type">char</span> *specific_object</code></em>, - <em class="parameter"><code><span class="type">GCancellable</span> *cancellable</code></em>, - <em class="parameter"><code><span class="type">GAsyncReadyCallback</span> callback</code></em>, - <em class="parameter"><code><span class="type">gpointer</span> user_data</code></em>);</pre> -<p>Adds a new connection using the given details (if any) as a template, -automatically filling in missing settings with the capabilities of the given -device and specific object. The new connection is then asynchronously -activated as with <a class="link" href="NMClient.html#nm-client-activate-connection-async" title="nm_client_activate_connection_async ()"><code class="function">nm_client_activate_connection_async()</code></a>. Cannot be used for -VPN connections at this time.</p> -<p>Note that the callback is invoked when NetworkManager has started activating -the new connection, not when it finishes. You can used the returned -<a class="link" href="NMActiveConnection.html" title="NMActiveConnection"><span class="type">NMActiveConnection</span></a> object (in particular, <a class="link" href="NMActiveConnection.html#NMActiveConnection--state" title="The “state” property"><span class="type">“state”</span></a>) to -track the activation to its completion.</p> -<div class="refsect3"> -<a name="nm-client-add-and-activate-connection-async.parameters"></a><h4>Parameters</h4> -<div class="informaltable"><table class="informaltable" width="100%" border="0"> -<colgroup> -<col width="150px" class="parameters_name"> -<col class="parameters_description"> -<col width="200px" class="parameters_annotations"> -</colgroup> -<tbody> -<tr> -<td class="parameter_name"><p>client</p></td> -<td class="parameter_description"><p>a <a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a></p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>partial</p></td> -<td class="parameter_description"><p>an <a class="link" href="NMConnection.html" title="NMConnection"><span class="type">NMConnection</span></a> to add; the connection may be -partially filled (or even <code class="literal">NULL</code>) and will be completed by NetworkManager -using the given <em class="parameter"><code>device</code></em> -and <em class="parameter"><code>specific_object</code></em> -before being added. </p></td> -<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td> -</tr> -<tr> -<td class="parameter_name"><p>device</p></td> -<td class="parameter_description"><p>the <a class="link" href="NMDevice.html" title="NMDevice"><span class="type">NMDevice</span></a>. </p></td> -<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td> -</tr> -<tr> -<td class="parameter_name"><p>specific_object</p></td> -<td class="parameter_description"><p>the object path of a connection-type-specific -object this activation should use. This parameter is currently ignored for -wired and mobile broadband connections, and the value of <code class="literal">NULL</code> should be used -(ie, no specific object). For Wi-Fi or WiMAX connections, pass the object -path of a <a class="link" href="NMAccessPoint.html" title="NMAccessPoint"><span class="type">NMAccessPoint</span></a> or <a class="link" href="NMWimaxNsp.html" title="NMWimaxNsp"><span class="type">NMWimaxNsp</span></a> owned by <em class="parameter"><code>device</code></em> -, which you can -get using <a class="link" href="NMObject.html#nm-object-get-path" title="nm_object_get_path ()"><code class="function">nm_object_get_path()</code></a>, and which will be used to complete the -details of the newly added connection. -If the variant is floating, it will be consumed. </p></td> -<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td> -</tr> -<tr> -<td class="parameter_name"><p>cancellable</p></td> -<td class="parameter_description"><p>a <span class="type">GCancellable</span>, or <code class="literal">NULL</code></p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>callback</p></td> -<td class="parameter_description"><p>callback to be called when the activation has started</p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>user_data</p></td> -<td class="parameter_description"><p>caller-specific data passed to <em class="parameter"><code>callback</code></em> -</p></td> -<td class="parameter_annotations"> </td> -</tr> -</tbody> -</table></div> -</div> -</div> -<hr> -<div class="refsect2"> -<a name="nm-client-add-and-activate-connection-finish"></a><h3>nm_client_add_and_activate_connection_finish ()</h3> -<pre class="programlisting"><a class="link" href="NMActiveConnection.html" title="NMActiveConnection"><span class="returnvalue">NMActiveConnection</span></a> * -nm_client_add_and_activate_connection_finish - (<em class="parameter"><code><a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a> *client</code></em>, - <em class="parameter"><code><span class="type">GAsyncResult</span> *result</code></em>, - <em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre> -<p>Gets the result of a call to <a class="link" href="NMClient.html#nm-client-add-and-activate-connection-async" title="nm_client_add_and_activate_connection_async ()"><code class="function">nm_client_add_and_activate_connection_async()</code></a>.</p> -<p>You can call <a class="link" href="NMActiveConnection.html#nm-active-connection-get-connection" title="nm_active_connection_get_connection ()"><code class="function">nm_active_connection_get_connection()</code></a> on the returned -<a class="link" href="NMActiveConnection.html" title="NMActiveConnection"><span class="type">NMActiveConnection</span></a> to find the path of the created <a class="link" href="NMConnection.html" title="NMConnection"><span class="type">NMConnection</span></a>.</p> -<div class="refsect3"> -<a name="nm-client-add-and-activate-connection-finish.parameters"></a><h4>Parameters</h4> -<div class="informaltable"><table class="informaltable" width="100%" border="0"> -<colgroup> -<col width="150px" class="parameters_name"> -<col class="parameters_description"> -<col width="200px" class="parameters_annotations"> -</colgroup> -<tbody> -<tr> -<td class="parameter_name"><p>client</p></td> -<td class="parameter_description"><p>an <a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a></p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>result</p></td> -<td class="parameter_description"><p>the result passed to the <span class="type">GAsyncReadyCallback</span></p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>error</p></td> -<td class="parameter_description"><p>location for a <span class="type">GError</span>, or <code class="literal">NULL</code></p></td> -<td class="parameter_annotations"> </td> -</tr> -</tbody> -</table></div> -</div> -<div class="refsect3"> -<a name="nm-client-add-and-activate-connection-finish.returns"></a><h4>Returns</h4> -<p>the new <a class="link" href="NMActiveConnection.html" title="NMActiveConnection"><span class="type">NMActiveConnection</span></a> on success, <code class="literal">NULL</code> on -failure, in which case <em class="parameter"><code>error</code></em> -will be set. </p> -<p><span class="annotation">[<acronym title="The caller owns the data, and is responsible for free it."><span class="acronym">transfer full</span></acronym>]</span></p> -</div> -</div> -<hr> -<div class="refsect2"> -<a name="nm-client-add-and-activate-connection2"></a><h3>nm_client_add_and_activate_connection2 ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> -nm_client_add_and_activate_connection2 - (<em class="parameter"><code><a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a> *client</code></em>, - <em class="parameter"><code><a class="link" href="NMConnection.html" title="NMConnection"><span class="type">NMConnection</span></a> *partial</code></em>, - <em class="parameter"><code><a class="link" href="NMDevice.html" title="NMDevice"><span class="type">NMDevice</span></a> *device</code></em>, - <em class="parameter"><code>const <span class="type">char</span> *specific_object</code></em>, - <em class="parameter"><code><span class="type">GVariant</span> *options</code></em>, - <em class="parameter"><code><span class="type">GCancellable</span> *cancellable</code></em>, - <em class="parameter"><code><span class="type">GAsyncReadyCallback</span> callback</code></em>, - <em class="parameter"><code><span class="type">gpointer</span> user_data</code></em>);</pre> -<p>Adds a new connection using the given details (if any) as a template, -automatically filling in missing settings with the capabilities of the given -device and specific object. The new connection is then asynchronously -activated as with <a class="link" href="NMClient.html#nm-client-activate-connection-async" title="nm_client_activate_connection_async ()"><code class="function">nm_client_activate_connection_async()</code></a>. Cannot be used for -VPN connections at this time.</p> -<p>Note that the callback is invoked when NetworkManager has started activating -the new connection, not when it finishes. You can used the returned -<a class="link" href="NMActiveConnection.html" title="NMActiveConnection"><span class="type">NMActiveConnection</span></a> object (in particular, <a class="link" href="NMActiveConnection.html#NMActiveConnection--state" title="The “state” property"><span class="type">“state”</span></a>) to -track the activation to its completion.</p> -<p>This is identical to <a class="link" href="NMClient.html#nm-client-add-and-activate-connection-async" title="nm_client_add_and_activate_connection_async ()"><code class="function">nm_client_add_and_activate_connection_async()</code></a> but takes -a further <em class="parameter"><code>options</code></em> - parameter. Currently, the following options are supported -by the daemon:</p> -<div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "> -<li class="listitem"><p>"persist": A string describing how the connection should be stored. - The default is "disk", but it can be modified to "memory" (until - the daemon quits) or "volatile" (will be deleted on disconnect).</p></li> -<li class="listitem"><p>"bind-activation": Bind the connection lifetime to something. The default is "none", - meaning an explicit disconnect is needed. The value "dbus-client" - means the connection will automatically be deactivated when the calling - D-Bus client disappears from the system bus.</p></li> -</ul></div> -<div class="refsect3"> -<a name="nm-client-add-and-activate-connection2.parameters"></a><h4>Parameters</h4> -<div class="informaltable"><table class="informaltable" width="100%" border="0"> -<colgroup> -<col width="150px" class="parameters_name"> -<col class="parameters_description"> -<col width="200px" class="parameters_annotations"> -</colgroup> -<tbody> -<tr> -<td class="parameter_name"><p>client</p></td> -<td class="parameter_description"><p>a <a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a></p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>partial</p></td> -<td class="parameter_description"><p>an <a class="link" href="NMConnection.html" title="NMConnection"><span class="type">NMConnection</span></a> to add; the connection may be -partially filled (or even <code class="literal">NULL</code>) and will be completed by NetworkManager -using the given <em class="parameter"><code>device</code></em> -and <em class="parameter"><code>specific_object</code></em> -before being added. </p></td> -<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td> -</tr> -<tr> -<td class="parameter_name"><p>device</p></td> -<td class="parameter_description"><p>the <a class="link" href="NMDevice.html" title="NMDevice"><span class="type">NMDevice</span></a>. </p></td> -<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td> -</tr> -<tr> -<td class="parameter_name"><p>specific_object</p></td> -<td class="parameter_description"><p>the object path of a connection-type-specific -object this activation should use. This parameter is currently ignored for -wired and mobile broadband connections, and the value of <code class="literal">NULL</code> should be used -(i.e., no specific object). For Wi-Fi or WiMAX connections, pass the object -path of a <a class="link" href="NMAccessPoint.html" title="NMAccessPoint"><span class="type">NMAccessPoint</span></a> or <a class="link" href="NMWimaxNsp.html" title="NMWimaxNsp"><span class="type">NMWimaxNsp</span></a> owned by <em class="parameter"><code>device</code></em> -, which you can -get using <a class="link" href="NMObject.html#nm-object-get-path" title="nm_object_get_path ()"><code class="function">nm_object_get_path()</code></a>, and which will be used to complete the -details of the newly added connection. </p></td> -<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td> -</tr> -<tr> -<td class="parameter_name"><p>options</p></td> -<td class="parameter_description"><p>a <span class="type">GVariant</span> containing a dictionary with options, or <code class="literal">NULL</code></p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>cancellable</p></td> -<td class="parameter_description"><p>a <span class="type">GCancellable</span>, or <code class="literal">NULL</code></p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>callback</p></td> -<td class="parameter_description"><p>callback to be called when the activation has started</p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>user_data</p></td> -<td class="parameter_description"><p>caller-specific data passed to <em class="parameter"><code>callback</code></em> -</p></td> -<td class="parameter_annotations"> </td> -</tr> -</tbody> -</table></div> -</div> -<p class="since">Since: 1.16</p> -</div> -<hr> -<div class="refsect2"> -<a name="nm-client-add-and-activate-connection2-finish"></a><h3>nm_client_add_and_activate_connection2_finish ()</h3> -<pre class="programlisting"><a class="link" href="NMActiveConnection.html" title="NMActiveConnection"><span class="returnvalue">NMActiveConnection</span></a> * -nm_client_add_and_activate_connection2_finish - (<em class="parameter"><code><a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a> *client</code></em>, - <em class="parameter"><code><span class="type">GAsyncResult</span> *result</code></em>, - <em class="parameter"><code><span class="type">GVariant</span> **out_result</code></em>, - <em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre> -<p>Gets the result of a call to <a class="link" href="NMClient.html#nm-client-add-and-activate-connection2" title="nm_client_add_and_activate_connection2 ()"><code class="function">nm_client_add_and_activate_connection2()</code></a>.</p> -<p>You can call <a class="link" href="NMActiveConnection.html#nm-active-connection-get-connection" title="nm_active_connection_get_connection ()"><code class="function">nm_active_connection_get_connection()</code></a> on the returned -<a class="link" href="NMActiveConnection.html" title="NMActiveConnection"><span class="type">NMActiveConnection</span></a> to find the path of the created <a class="link" href="NMConnection.html" title="NMConnection"><span class="type">NMConnection</span></a>.</p> -<div class="refsect3"> -<a name="nm-client-add-and-activate-connection2-finish.parameters"></a><h4>Parameters</h4> -<div class="informaltable"><table class="informaltable" width="100%" border="0"> -<colgroup> -<col width="150px" class="parameters_name"> -<col class="parameters_description"> -<col width="200px" class="parameters_annotations"> -</colgroup> -<tbody> -<tr> -<td class="parameter_name"><p>client</p></td> -<td class="parameter_description"><p>an <a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a></p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>result</p></td> -<td class="parameter_description"><p>the result passed to the <span class="type">GAsyncReadyCallback</span></p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>error</p></td> -<td class="parameter_description"><p>location for a <span class="type">GError</span>, or <code class="literal">NULL</code></p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>out_result</p></td> -<td class="parameter_description"><p>the output result -of type "a{sv}" returned by D-Bus' AddAndActivate2 call. Currently, no -output is implemented yet. </p></td> -<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL may be passed instead of a pointer to a location."><span class="acronym">optional</span></acronym>][<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>][<acronym title="The caller owns the data, and is responsible for free it."><span class="acronym">transfer full</span></acronym>]</span></td> -</tr> -</tbody> -</table></div> -</div> -<div class="refsect3"> -<a name="nm-client-add-and-activate-connection2-finish.returns"></a><h4>Returns</h4> -<p>the new <a class="link" href="NMActiveConnection.html" title="NMActiveConnection"><span class="type">NMActiveConnection</span></a> on success, <code class="literal">NULL</code> on -failure, in which case <em class="parameter"><code>error</code></em> -will be set. </p> -<p><span class="annotation">[<acronym title="The caller owns the data, and is responsible for free it."><span class="acronym">transfer full</span></acronym>]</span></p> -</div> -<p class="since">Since: 1.16</p> -</div> -<hr> -<div class="refsect2"> -<a name="nm-client-deactivate-connection"></a><h3>nm_client_deactivate_connection ()</h3> -<pre class="programlisting"><span class="returnvalue">gboolean</span> -nm_client_deactivate_connection (<em class="parameter"><code><a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a> *client</code></em>, - <em class="parameter"><code><a class="link" href="NMActiveConnection.html" title="NMActiveConnection"><span class="type">NMActiveConnection</span></a> *active</code></em>, - <em class="parameter"><code><span class="type">GCancellable</span> *cancellable</code></em>, - <em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre> -<div class="warning"> -<p><code class="literal">nm_client_deactivate_connection</code> has been deprecated since version 1.22 and should not be used in newly-written code.</p> -<p>Use <a class="link" href="NMClient.html#nm-client-deactivate-connection-async" title="nm_client_deactivate_connection_async ()"><code class="function">nm_client_deactivate_connection_async()</code></a> or GDBusConnection.</p> -</div> -<p>Deactivates an active <a class="link" href="NMActiveConnection.html" title="NMActiveConnection"><span class="type">NMActiveConnection</span></a>.</p> -<div class="refsect3"> -<a name="nm-client-deactivate-connection.parameters"></a><h4>Parameters</h4> -<div class="informaltable"><table class="informaltable" width="100%" border="0"> -<colgroup> -<col width="150px" class="parameters_name"> -<col class="parameters_description"> -<col width="200px" class="parameters_annotations"> -</colgroup> -<tbody> -<tr> -<td class="parameter_name"><p>client</p></td> -<td class="parameter_description"><p>a <a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a></p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>active</p></td> -<td class="parameter_description"><p>the <a class="link" href="NMActiveConnection.html" title="NMActiveConnection"><span class="type">NMActiveConnection</span></a> to deactivate</p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>cancellable</p></td> -<td class="parameter_description"><p>a <span class="type">GCancellable</span>, or <code class="literal">NULL</code></p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>error</p></td> -<td class="parameter_description"><p>location for a <span class="type">GError</span>, or <code class="literal">NULL</code></p></td> -<td class="parameter_annotations"> </td> -</tr> -</tbody> -</table></div> -</div> -<div class="refsect3"> -<a name="nm-client-deactivate-connection.returns"></a><h4>Returns</h4> -<p> success or failure</p> -</div> -</div> -<hr> -<div class="refsect2"> -<a name="nm-client-deactivate-connection-async"></a><h3>nm_client_deactivate_connection_async ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> -nm_client_deactivate_connection_async (<em class="parameter"><code><a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a> *client</code></em>, - <em class="parameter"><code><a class="link" href="NMActiveConnection.html" title="NMActiveConnection"><span class="type">NMActiveConnection</span></a> *active</code></em>, - <em class="parameter"><code><span class="type">GCancellable</span> *cancellable</code></em>, - <em class="parameter"><code><span class="type">GAsyncReadyCallback</span> callback</code></em>, - <em class="parameter"><code><span class="type">gpointer</span> user_data</code></em>);</pre> -<p>Asynchronously deactivates an active <a class="link" href="NMActiveConnection.html" title="NMActiveConnection"><span class="type">NMActiveConnection</span></a>.</p> -<div class="refsect3"> -<a name="nm-client-deactivate-connection-async.parameters"></a><h4>Parameters</h4> -<div class="informaltable"><table class="informaltable" width="100%" border="0"> -<colgroup> -<col width="150px" class="parameters_name"> -<col class="parameters_description"> -<col width="200px" class="parameters_annotations"> -</colgroup> -<tbody> -<tr> -<td class="parameter_name"><p>client</p></td> -<td class="parameter_description"><p>a <a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a></p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>active</p></td> -<td class="parameter_description"><p>the <a class="link" href="NMActiveConnection.html" title="NMActiveConnection"><span class="type">NMActiveConnection</span></a> to deactivate</p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>cancellable</p></td> -<td class="parameter_description"><p>a <span class="type">GCancellable</span>, or <code class="literal">NULL</code></p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>callback</p></td> -<td class="parameter_description"><p>callback to be called when the deactivation has completed</p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>user_data</p></td> -<td class="parameter_description"><p>caller-specific data passed to <em class="parameter"><code>callback</code></em> -</p></td> -<td class="parameter_annotations"> </td> -</tr> -</tbody> -</table></div> -</div> -</div> -<hr> -<div class="refsect2"> -<a name="nm-client-deactivate-connection-finish"></a><h3>nm_client_deactivate_connection_finish ()</h3> -<pre class="programlisting"><span class="returnvalue">gboolean</span> -nm_client_deactivate_connection_finish - (<em class="parameter"><code><a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a> *client</code></em>, - <em class="parameter"><code><span class="type">GAsyncResult</span> *result</code></em>, - <em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre> -<p>Gets the result of a call to <a class="link" href="NMClient.html#nm-client-deactivate-connection-async" title="nm_client_deactivate_connection_async ()"><code class="function">nm_client_deactivate_connection_async()</code></a>.</p> -<div class="refsect3"> -<a name="nm-client-deactivate-connection-finish.parameters"></a><h4>Parameters</h4> -<div class="informaltable"><table class="informaltable" width="100%" border="0"> -<colgroup> -<col width="150px" class="parameters_name"> -<col class="parameters_description"> -<col width="200px" class="parameters_annotations"> -</colgroup> -<tbody> -<tr> -<td class="parameter_name"><p>client</p></td> -<td class="parameter_description"><p>a <a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a></p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>result</p></td> -<td class="parameter_description"><p>the result passed to the <span class="type">GAsyncReadyCallback</span></p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>error</p></td> -<td class="parameter_description"><p>location for a <span class="type">GError</span>, or <code class="literal">NULL</code></p></td> -<td class="parameter_annotations"> </td> -</tr> -</tbody> -</table></div> -</div> -<div class="refsect3"> -<a name="nm-client-deactivate-connection-finish.returns"></a><h4>Returns</h4> -<p> success or failure</p> -</div> -</div> -<hr> -<div class="refsect2"> -<a name="nm-client-get-connections"></a><h3>nm_client_get_connections ()</h3> -<pre class="programlisting">const <span class="returnvalue">GPtrArray</span> * -nm_client_get_connections (<em class="parameter"><code><a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a> *client</code></em>);</pre> -<div class="refsect3"> -<a name="nm-client-get-connections.parameters"></a><h4>Parameters</h4> -<div class="informaltable"><table class="informaltable" width="100%" border="0"> -<colgroup> -<col width="150px" class="parameters_name"> -<col class="parameters_description"> -<col width="200px" class="parameters_annotations"> -</colgroup> -<tbody><tr> -<td class="parameter_name"><p>client</p></td> -<td class="parameter_description"><p>the <a class="link" href="NMClient.html" title="NMClient"><code class="literal">NMClient</code></a></p></td> -<td class="parameter_annotations"> </td> -</tr></tbody> -</table></div> -</div> -<div class="refsect3"> -<a name="nm-client-get-connections.returns"></a><h4>Returns</h4> -<p>an array -containing all connections provided by the remote settings service. The -returned array is owned by the <a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a> object and should not be modified.</p> -<p>The connections are as received from D-Bus and might not validate according -to <a class="link" href="NMConnection.html#nm-connection-verify" title="nm_connection_verify ()"><code class="function">nm_connection_verify()</code></a>. </p> -<p><span class="annotation">[<acronym title="The data is owned by the callee, which is responsible of freeing it."><span class="acronym">transfer none</span></acronym>][<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> NMRemoteConnection]</span></p> -</div> -</div> -<hr> -<div class="refsect2"> -<a name="nm-client-get-connection-by-id"></a><h3>nm_client_get_connection_by_id ()</h3> -<pre class="programlisting"><a class="link" href="NMRemoteConnection.html" title="NMRemoteConnection"><span class="returnvalue">NMRemoteConnection</span></a> * -nm_client_get_connection_by_id (<em class="parameter"><code><a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a> *client</code></em>, - <em class="parameter"><code>const <span class="type">char</span> *id</code></em>);</pre> -<p>Returns the first matching <a class="link" href="NMRemoteConnection.html" title="NMRemoteConnection"><code class="literal">NMRemoteConnection</code></a> matching a given <em class="parameter"><code>id</code></em> -.</p> -<div class="refsect3"> -<a name="nm-client-get-connection-by-id.parameters"></a><h4>Parameters</h4> -<div class="informaltable"><table class="informaltable" width="100%" border="0"> -<colgroup> -<col width="150px" class="parameters_name"> -<col class="parameters_description"> -<col width="200px" class="parameters_annotations"> -</colgroup> -<tbody> -<tr> -<td class="parameter_name"><p>client</p></td> -<td class="parameter_description"><p>the <a class="link" href="NMClient.html" title="NMClient"><code class="literal">NMClient</code></a></p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>id</p></td> -<td class="parameter_description"><p>the id of the remote connection</p></td> -<td class="parameter_annotations"> </td> -</tr> -</tbody> -</table></div> -</div> -<div class="refsect3"> -<a name="nm-client-get-connection-by-id.returns"></a><h4>Returns</h4> -<p>the remote connection object on success, or <code class="literal">NULL</code> if no -matching object was found.</p> -<p>The connection is as received from D-Bus and might not validate according -to <a class="link" href="NMConnection.html#nm-connection-verify" title="nm_connection_verify ()"><code class="function">nm_connection_verify()</code></a>. </p> -<p><span class="annotation">[<acronym title="The data is owned by the callee, which is responsible of freeing it."><span class="acronym">transfer none</span></acronym>]</span></p> -</div> -</div> -<hr> -<div class="refsect2"> -<a name="nm-client-get-connection-by-path"></a><h3>nm_client_get_connection_by_path ()</h3> -<pre class="programlisting"><a class="link" href="NMRemoteConnection.html" title="NMRemoteConnection"><span class="returnvalue">NMRemoteConnection</span></a> * -nm_client_get_connection_by_path (<em class="parameter"><code><a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a> *client</code></em>, - <em class="parameter"><code>const <span class="type">char</span> *path</code></em>);</pre> -<p>Returns the <a class="link" href="NMRemoteConnection.html" title="NMRemoteConnection"><code class="literal">NMRemoteConnection</code></a> representing the connection at <em class="parameter"><code>path</code></em> -.</p> -<div class="refsect3"> -<a name="nm-client-get-connection-by-path.parameters"></a><h4>Parameters</h4> -<div class="informaltable"><table class="informaltable" width="100%" border="0"> -<colgroup> -<col width="150px" class="parameters_name"> -<col class="parameters_description"> -<col width="200px" class="parameters_annotations"> -</colgroup> -<tbody> -<tr> -<td class="parameter_name"><p>client</p></td> -<td class="parameter_description"><p>the <a class="link" href="NMClient.html" title="NMClient"><code class="literal">NMClient</code></a></p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>path</p></td> -<td class="parameter_description"><p>the D-Bus object path of the remote connection</p></td> -<td class="parameter_annotations"> </td> -</tr> -</tbody> -</table></div> -</div> -<div class="refsect3"> -<a name="nm-client-get-connection-by-path.returns"></a><h4>Returns</h4> -<p>the remote connection object on success, or <code class="literal">NULL</code> if the object was -not known</p> -<p>The connection is as received from D-Bus and might not validate according -to <a class="link" href="NMConnection.html#nm-connection-verify" title="nm_connection_verify ()"><code class="function">nm_connection_verify()</code></a>. </p> -<p><span class="annotation">[<acronym title="The data is owned by the callee, which is responsible of freeing it."><span class="acronym">transfer none</span></acronym>]</span></p> -</div> -</div> -<hr> -<div class="refsect2"> -<a name="nm-client-get-connection-by-uuid"></a><h3>nm_client_get_connection_by_uuid ()</h3> -<pre class="programlisting"><a class="link" href="NMRemoteConnection.html" title="NMRemoteConnection"><span class="returnvalue">NMRemoteConnection</span></a> * -nm_client_get_connection_by_uuid (<em class="parameter"><code><a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a> *client</code></em>, - <em class="parameter"><code>const <span class="type">char</span> *uuid</code></em>);</pre> -<p>Returns the <a class="link" href="NMRemoteConnection.html" title="NMRemoteConnection"><code class="literal">NMRemoteConnection</code></a> identified by <em class="parameter"><code>uuid</code></em> -.</p> -<div class="refsect3"> -<a name="nm-client-get-connection-by-uuid.parameters"></a><h4>Parameters</h4> -<div class="informaltable"><table class="informaltable" width="100%" border="0"> -<colgroup> -<col width="150px" class="parameters_name"> -<col class="parameters_description"> -<col width="200px" class="parameters_annotations"> -</colgroup> -<tbody> -<tr> -<td class="parameter_name"><p>client</p></td> -<td class="parameter_description"><p>the <a class="link" href="NMClient.html" title="NMClient"><code class="literal">NMClient</code></a></p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>uuid</p></td> -<td class="parameter_description"><p>the UUID of the remote connection</p></td> -<td class="parameter_annotations"> </td> -</tr> -</tbody> -</table></div> -</div> -<div class="refsect3"> -<a name="nm-client-get-connection-by-uuid.returns"></a><h4>Returns</h4> -<p>the remote connection object on success, or <code class="literal">NULL</code> if the object was -not known</p> -<p>The connection is as received from D-Bus and might not validate according -to <a class="link" href="NMConnection.html#nm-connection-verify" title="nm_connection_verify ()"><code class="function">nm_connection_verify()</code></a>. </p> -<p><span class="annotation">[<acronym title="The data is owned by the callee, which is responsible of freeing it."><span class="acronym">transfer none</span></acronym>]</span></p> -</div> -</div> -<hr> -<div class="refsect2"> -<a name="nm-client-add-connection-async"></a><h3>nm_client_add_connection_async ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> -nm_client_add_connection_async (<em class="parameter"><code><a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a> *client</code></em>, - <em class="parameter"><code><a class="link" href="NMConnection.html" title="NMConnection"><span class="type">NMConnection</span></a> *connection</code></em>, - <em class="parameter"><code><span class="type">gboolean</span> save_to_disk</code></em>, - <em class="parameter"><code><span class="type">GCancellable</span> *cancellable</code></em>, - <em class="parameter"><code><span class="type">GAsyncReadyCallback</span> callback</code></em>, - <em class="parameter"><code><span class="type">gpointer</span> user_data</code></em>);</pre> -<p>Requests that the remote settings service add the given settings to a new -connection. If <em class="parameter"><code>save_to_disk</code></em> - is <code class="literal">TRUE</code>, the connection is immediately written -to disk; otherwise it is initially only stored in memory, but may be saved -later by calling the connection's <a class="link" href="NMRemoteConnection.html#nm-remote-connection-commit-changes" title="nm_remote_connection_commit_changes ()"><code class="function">nm_remote_connection_commit_changes()</code></a> -method.</p> -<p><em class="parameter"><code>connection</code></em> - is untouched by this function and only serves as a template of -the settings to add. The <a class="link" href="NMRemoteConnection.html" title="NMRemoteConnection"><span class="type">NMRemoteConnection</span></a> object that represents what -NetworkManager actually added is returned to <em class="parameter"><code>callback</code></em> - when the addition -operation is complete.</p> -<p>Note that the <a class="link" href="NMRemoteConnection.html" title="NMRemoteConnection"><span class="type">NMRemoteConnection</span></a> returned in <em class="parameter"><code>callback</code></em> - may not contain -identical settings to <em class="parameter"><code>connection</code></em> - as NetworkManager may perform automatic -completion and/or normalization of connection properties.</p> -<div class="refsect3"> -<a name="nm-client-add-connection-async.parameters"></a><h4>Parameters</h4> -<div class="informaltable"><table class="informaltable" width="100%" border="0"> -<colgroup> -<col width="150px" class="parameters_name"> -<col class="parameters_description"> -<col width="200px" class="parameters_annotations"> -</colgroup> -<tbody> -<tr> -<td class="parameter_name"><p>client</p></td> -<td class="parameter_description"><p>the <a class="link" href="NMClient.html" title="NMClient"><code class="literal">NMClient</code></a></p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>connection</p></td> -<td class="parameter_description"><p>the connection to add. Note that this object's settings will be -added, not the object itself</p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>save_to_disk</p></td> -<td class="parameter_description"><p>whether to immediately save the connection to disk</p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>cancellable</p></td> -<td class="parameter_description"><p>a <span class="type">GCancellable</span>, or <code class="literal">NULL</code></p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>callback</p></td> -<td class="parameter_description"><p>callback to be called when the add operation completes. </p></td> -<td class="parameter_annotations"><span class="annotation">[<acronym title="The callback is valid until first called."><span class="acronym">scope async</span></acronym>]</span></td> -</tr> -<tr> -<td class="parameter_name"><p>user_data</p></td> -<td class="parameter_description"><p>caller-specific data passed to <em class="parameter"><code>callback</code></em> -. </p></td> -<td class="parameter_annotations"><span class="annotation">[<acronym title="This parameter is a 'user_data', for callbacks; many bindings can pass NULL here."><span class="acronym">closure</span></acronym>]</span></td> -</tr> -</tbody> -</table></div> -</div> -</div> -<hr> -<div class="refsect2"> -<a name="nm-client-add-connection-finish"></a><h3>nm_client_add_connection_finish ()</h3> -<pre class="programlisting"><a class="link" href="NMRemoteConnection.html" title="NMRemoteConnection"><span class="returnvalue">NMRemoteConnection</span></a> * -nm_client_add_connection_finish (<em class="parameter"><code><a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a> *client</code></em>, - <em class="parameter"><code><span class="type">GAsyncResult</span> *result</code></em>, - <em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre> -<p>Gets the result of a call to <a class="link" href="NMClient.html#nm-client-add-connection-async" title="nm_client_add_connection_async ()"><code class="function">nm_client_add_connection_async()</code></a>.</p> -<div class="refsect3"> -<a name="nm-client-add-connection-finish.parameters"></a><h4>Parameters</h4> -<div class="informaltable"><table class="informaltable" width="100%" border="0"> -<colgroup> -<col width="150px" class="parameters_name"> -<col class="parameters_description"> -<col width="200px" class="parameters_annotations"> -</colgroup> -<tbody> -<tr> -<td class="parameter_name"><p>client</p></td> -<td class="parameter_description"><p>an <a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a></p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>result</p></td> -<td class="parameter_description"><p>the result passed to the <span class="type">GAsyncReadyCallback</span></p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>error</p></td> -<td class="parameter_description"><p>location for a <span class="type">GError</span>, or <code class="literal">NULL</code></p></td> -<td class="parameter_annotations"> </td> -</tr> -</tbody> -</table></div> -</div> -<div class="refsect3"> -<a name="nm-client-add-connection-finish.returns"></a><h4>Returns</h4> -<p>the new <a class="link" href="NMRemoteConnection.html" title="NMRemoteConnection"><span class="type">NMRemoteConnection</span></a> on success, <code class="literal">NULL</code> on -failure, in which case <em class="parameter"><code>error</code></em> -will be set. </p> -<p><span class="annotation">[<acronym title="The caller owns the data, and is responsible for free it."><span class="acronym">transfer full</span></acronym>]</span></p> -</div> -</div> -<hr> -<div class="refsect2"> -<a name="nm-client-add-connection2"></a><h3>nm_client_add_connection2 ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> -nm_client_add_connection2 (<em class="parameter"><code><a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a> *client</code></em>, - <em class="parameter"><code><span class="type">GVariant</span> *settings</code></em>, - <em class="parameter"><code><a class="link" href="libnm-nm-dbus-interface.html#NMSettingsAddConnection2Flags" title="enum NMSettingsAddConnection2Flags"><span class="type">NMSettingsAddConnection2Flags</span></a> flags</code></em>, - <em class="parameter"><code><span class="type">GVariant</span> *args</code></em>, - <em class="parameter"><code><span class="type">gboolean</span> ignore_out_result</code></em>, - <em class="parameter"><code><span class="type">GCancellable</span> *cancellable</code></em>, - <em class="parameter"><code><span class="type">GAsyncReadyCallback</span> callback</code></em>, - <em class="parameter"><code><span class="type">gpointer</span> user_data</code></em>);</pre> -<p>Call <code class="function">AddConnection2()</code> D-Bus API asynchronously.</p> -<div class="refsect3"> -<a name="nm-client-add-connection2.parameters"></a><h4>Parameters</h4> -<div class="informaltable"><table class="informaltable" width="100%" border="0"> -<colgroup> -<col width="150px" class="parameters_name"> -<col class="parameters_description"> -<col width="200px" class="parameters_annotations"> -</colgroup> -<tbody> -<tr> -<td class="parameter_name"><p>client</p></td> -<td class="parameter_description"><p>the <a class="link" href="NMClient.html" title="NMClient"><code class="literal">NMClient</code></a></p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>settings</p></td> -<td class="parameter_description"><p>the "a{sa{sv}}" <span class="type">GVariant</span> with the content of the setting.</p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>flags</p></td> -<td class="parameter_description"><p>the <a class="link" href="libnm-nm-dbus-interface.html#NMSettingsAddConnection2Flags" title="enum NMSettingsAddConnection2Flags"><code class="literal">NMSettingsAddConnection2Flags</code></a> argument.</p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>args</p></td> -<td class="parameter_description"><p>the "a{sv}" <span class="type">GVariant</span> with extra argument or <code class="literal">NULL</code> -for no extra arguments. </p></td> -<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td> -</tr> -<tr> -<td class="parameter_name"><p>ignore_out_result</p></td> -<td class="parameter_description"><p>this function wraps <code class="function">AddConnection2()</code>, which has an -additional result "a{sv}" output parameter. By setting this to <code class="literal">TRUE</code>, -you signal that you are not interested in that output parameter. -This allows the function to fall back to <code class="function">AddConnection()</code> and <code class="function">AddConnectionUnsaved()</code>, -which is interesting if you run against an older server version that does -not yet provide <code class="function">AddConnection2()</code>. By setting this to <code class="literal">FALSE</code>, the function -under the hood always calls <code class="function">AddConnection2()</code>.</p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>cancellable</p></td> -<td class="parameter_description"><p>a <span class="type">GCancellable</span>, or <code class="literal">NULL</code></p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>callback</p></td> -<td class="parameter_description"><p>callback to be called when the add operation completes. </p></td> -<td class="parameter_annotations"><span class="annotation">[<acronym title="The callback is valid until first called."><span class="acronym">scope async</span></acronym>]</span></td> -</tr> -<tr> -<td class="parameter_name"><p>user_data</p></td> -<td class="parameter_description"><p>caller-specific data passed to <em class="parameter"><code>callback</code></em> -. </p></td> -<td class="parameter_annotations"><span class="annotation">[<acronym title="This parameter is a 'user_data', for callbacks; many bindings can pass NULL here."><span class="acronym">closure</span></acronym>]</span></td> -</tr> -</tbody> -</table></div> -</div> -<p class="since">Since: 1.20</p> -</div> -<hr> -<div class="refsect2"> -<a name="nm-client-add-connection2-finish"></a><h3>nm_client_add_connection2_finish ()</h3> -<pre class="programlisting"><a class="link" href="NMRemoteConnection.html" title="NMRemoteConnection"><span class="returnvalue">NMRemoteConnection</span></a> * -nm_client_add_connection2_finish (<em class="parameter"><code><a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a> *client</code></em>, - <em class="parameter"><code><span class="type">GAsyncResult</span> *result</code></em>, - <em class="parameter"><code><span class="type">GVariant</span> **out_result</code></em>, - <em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre> -<div class="refsect3"> -<a name="nm-client-add-connection2-finish.parameters"></a><h4>Parameters</h4> -<div class="informaltable"><table class="informaltable" width="100%" border="0"> -<colgroup> -<col width="150px" class="parameters_name"> -<col class="parameters_description"> -<col width="200px" class="parameters_annotations"> -</colgroup> -<tbody> -<tr> -<td class="parameter_name"><p>client</p></td> -<td class="parameter_description"><p>the <a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a></p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>result</p></td> -<td class="parameter_description"><p>the <span class="type">GAsyncResult</span></p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>out_result</p></td> -<td class="parameter_description"><p>the output -<span class="type">GVariant</span> from <code class="function">AddConnection2()</code>. -If you care about the output result, then the "ignore_out_result" -parameter of <a class="link" href="NMClient.html#nm-client-add-connection2" title="nm_client_add_connection2 ()"><code class="function">nm_client_add_connection2()</code></a> must not be set to <code class="literal">TRUE</code>. </p></td> -<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL may be passed instead of a pointer to a location."><span class="acronym">optional</span></acronym>][<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>][<acronym title="The caller owns the data, and is responsible for free it."><span class="acronym">transfer full</span></acronym>]</span></td> -</tr> -<tr> -<td class="parameter_name"><p>error</p></td> -<td class="parameter_description"><p>the error argument.</p></td> -<td class="parameter_annotations"> </td> -</tr> -</tbody> -</table></div> -</div> -<div class="refsect3"> -<a name="nm-client-add-connection2-finish.returns"></a><h4>Returns</h4> -<p>on success, a pointer to the added -<a class="link" href="NMRemoteConnection.html" title="NMRemoteConnection"><span class="type">NMRemoteConnection</span></a>. </p> -<p><span class="annotation">[<acronym title="The caller owns the data, and is responsible for free it."><span class="acronym">transfer full</span></acronym>]</span></p> -</div> -<p class="since">Since: 1.20</p> -</div> -<hr> -<div class="refsect2"> -<a name="nm-client-load-connections"></a><h3>nm_client_load_connections ()</h3> -<pre class="programlisting"><span class="returnvalue">gboolean</span> -nm_client_load_connections (<em class="parameter"><code><a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a> *client</code></em>, - <em class="parameter"><code><span class="type">char</span> **filenames</code></em>, - <em class="parameter"><code><span class="type">char</span> ***failures</code></em>, - <em class="parameter"><code><span class="type">GCancellable</span> *cancellable</code></em>, - <em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre> -<div class="warning"> -<p><code class="literal">nm_client_load_connections</code> has been deprecated since version 1.22 and should not be used in newly-written code.</p> -<p>Use <a class="link" href="NMClient.html#nm-client-load-connections-async" title="nm_client_load_connections_async ()"><code class="function">nm_client_load_connections_async()</code></a> or GDBusConnection.</p> -</div> -<p>Requests that the remote settings service load or reload the given files, -adding or updating the connections described within.</p> -<p>The changes to the indicated files will not yet be reflected in -<em class="parameter"><code>client</code></em> -'s connections array when the function returns.</p> -<p>If all of the indicated files were successfully loaded, the -function will return <code class="literal">TRUE</code>, and <em class="parameter"><code>failures</code></em> - will be set to <code class="literal">NULL</code>. If -NetworkManager tried to load the files, but some (or all) failed, -then <em class="parameter"><code>failures</code></em> - will be set to a <code class="literal">NULL</code>-terminated array of the -filenames that failed to load.</p> -<div class="refsect3"> -<a name="nm-client-load-connections.parameters"></a><h4>Parameters</h4> -<div class="informaltable"><table class="informaltable" width="100%" border="0"> -<colgroup> -<col width="150px" class="parameters_name"> -<col class="parameters_description"> -<col width="200px" class="parameters_annotations"> -</colgroup> -<tbody> -<tr> -<td class="parameter_name"><p>client</p></td> -<td class="parameter_description"><p>the <a class="link" href="NMClient.html" title="NMClient"><code class="literal">NMClient</code></a></p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>filenames</p></td> -<td class="parameter_description"><p><code class="literal">NULL</code>-terminated array of filenames to load. </p></td> -<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> zero-terminated=1]</span></td> -</tr> -<tr> -<td class="parameter_name"><p>failures</p></td> -<td class="parameter_description"><p>on return, a <code class="literal">NULL</code>-terminated array of -filenames that failed to load. </p></td> -<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="The caller owns the data, and is responsible for free it."><span class="acronym">transfer full</span></acronym>]</span></td> -</tr> -<tr> -<td class="parameter_name"><p>cancellable</p></td> -<td class="parameter_description"><p>a <span class="type">GCancellable</span>, or <code class="literal">NULL</code></p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>error</p></td> -<td class="parameter_description"><p>return location for <span class="type">GError</span></p></td> -<td class="parameter_annotations"> </td> -</tr> -</tbody> -</table></div> -</div> -<div class="refsect3"> -<a name="nm-client-load-connections.returns"></a><h4>Returns</h4> -<p> <code class="literal">TRUE</code> on success.</p> -<p>Warning: before libnm 1.22, the boolean return value was inconsistent. -That is made worse, because when running against certain server versions -before 1.20, the server would return wrong values for success/failure. -This means, if you use this function in libnm before 1.22, you are advised -to ignore the boolean return value and only look at <em class="parameter"><code>failures</code></em> -and <em class="parameter"><code>error</code></em> -. -With libnm >= 1.22, the boolean return value corresponds to whether <em class="parameter"><code>error</code></em> -was -set. Note that even in the success case, you might have individual <em class="parameter"><code>failures</code></em> -. -With 1.22, the return value is consistent with <a class="link" href="NMClient.html#nm-client-load-connections-finish" title="nm_client_load_connections_finish ()"><code class="function">nm_client_load_connections_finish()</code></a>.</p> -</div> -</div> -<hr> -<div class="refsect2"> -<a name="nm-client-load-connections-async"></a><h3>nm_client_load_connections_async ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> -nm_client_load_connections_async (<em class="parameter"><code><a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a> *client</code></em>, - <em class="parameter"><code><span class="type">char</span> **filenames</code></em>, - <em class="parameter"><code><span class="type">GCancellable</span> *cancellable</code></em>, - <em class="parameter"><code><span class="type">GAsyncReadyCallback</span> callback</code></em>, - <em class="parameter"><code><span class="type">gpointer</span> user_data</code></em>);</pre> -<p>Requests that the remote settings service asynchronously load or reload the -given files, adding or updating the connections described within.</p> -<p>See <a class="link" href="NMClient.html#nm-client-load-connections" title="nm_client_load_connections ()"><code class="function">nm_client_load_connections()</code></a> for more details.</p> -<div class="refsect3"> -<a name="nm-client-load-connections-async.parameters"></a><h4>Parameters</h4> -<div class="informaltable"><table class="informaltable" width="100%" border="0"> -<colgroup> -<col width="150px" class="parameters_name"> -<col class="parameters_description"> -<col width="200px" class="parameters_annotations"> -</colgroup> -<tbody> -<tr> -<td class="parameter_name"><p>client</p></td> -<td class="parameter_description"><p>the <a class="link" href="NMClient.html" title="NMClient"><code class="literal">NMClient</code></a></p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>filenames</p></td> -<td class="parameter_description"><p><code class="literal">NULL</code>-terminated array of filenames to load. </p></td> -<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> zero-terminated=1]</span></td> -</tr> -<tr> -<td class="parameter_name"><p>cancellable</p></td> -<td class="parameter_description"><p>a <span class="type">GCancellable</span>, or <code class="literal">NULL</code></p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>callback</p></td> -<td class="parameter_description"><p>callback to be called when the operation completes. </p></td> -<td class="parameter_annotations"><span class="annotation">[<acronym title="The callback is valid until first called."><span class="acronym">scope async</span></acronym>]</span></td> -</tr> -<tr> -<td class="parameter_name"><p>user_data</p></td> -<td class="parameter_description"><p>caller-specific data passed to <em class="parameter"><code>callback</code></em> -. </p></td> -<td class="parameter_annotations"><span class="annotation">[<acronym title="This parameter is a 'user_data', for callbacks; many bindings can pass NULL here."><span class="acronym">closure</span></acronym>]</span></td> -</tr> -</tbody> -</table></div> -</div> -</div> -<hr> -<div class="refsect2"> -<a name="nm-client-load-connections-finish"></a><h3>nm_client_load_connections_finish ()</h3> -<pre class="programlisting"><span class="returnvalue">gboolean</span> -nm_client_load_connections_finish (<em class="parameter"><code><a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a> *client</code></em>, - <em class="parameter"><code><span class="type">char</span> ***failures</code></em>, - <em class="parameter"><code><span class="type">GAsyncResult</span> *result</code></em>, - <em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre> -<p>Gets the result of an <a class="link" href="NMClient.html#nm-client-load-connections-async" title="nm_client_load_connections_async ()"><code class="function">nm_client_load_connections_async()</code></a> call.</p> -<p>See <a class="link" href="NMClient.html#nm-client-load-connections" title="nm_client_load_connections ()"><code class="function">nm_client_load_connections()</code></a> for more details.</p> -<div class="refsect3"> -<a name="nm-client-load-connections-finish.parameters"></a><h4>Parameters</h4> -<div class="informaltable"><table class="informaltable" width="100%" border="0"> -<colgroup> -<col width="150px" class="parameters_name"> -<col class="parameters_description"> -<col width="200px" class="parameters_annotations"> -</colgroup> -<tbody> -<tr> -<td class="parameter_name"><p>client</p></td> -<td class="parameter_description"><p>the <a class="link" href="NMClient.html" title="NMClient"><code class="literal">NMClient</code></a></p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>failures</p></td> -<td class="parameter_description"><p>on return, a -<code class="literal">NULL</code>-terminated array of filenames that failed to load. </p></td> -<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="The caller owns the data, and is responsible for free it."><span class="acronym">transfer full</span></acronym>][<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> zero-terminated=1]</span></td> -</tr> -<tr> -<td class="parameter_name"><p>result</p></td> -<td class="parameter_description"><p>the result passed to the <span class="type">GAsyncReadyCallback</span></p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>error</p></td> -<td class="parameter_description"><p>location for a <span class="type">GError</span>, or <code class="literal">NULL</code></p></td> -<td class="parameter_annotations"> </td> -</tr> -</tbody> -</table></div> -</div> -<div class="refsect3"> -<a name="nm-client-load-connections-finish.returns"></a><h4>Returns</h4> -<p> <code class="literal">TRUE</code> on success. -Note that even in the success case, you might have individual <em class="parameter"><code>failures</code></em> -.</p> -</div> -</div> -<hr> -<div class="refsect2"> -<a name="nm-client-reload-connections"></a><h3>nm_client_reload_connections ()</h3> -<pre class="programlisting"><span class="returnvalue">gboolean</span> -nm_client_reload_connections (<em class="parameter"><code><a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a> *client</code></em>, - <em class="parameter"><code><span class="type">GCancellable</span> *cancellable</code></em>, - <em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre> -<div class="warning"> -<p><code class="literal">nm_client_reload_connections</code> has been deprecated since version 1.22 and should not be used in newly-written code.</p> -<p>Use <a class="link" href="NMClient.html#nm-client-reload-connections-async" title="nm_client_reload_connections_async ()"><code class="function">nm_client_reload_connections_async()</code></a> or GDBusConnection.</p> -</div> -<p>Requests that the remote settings service reload all connection -files from disk, adding, updating, and removing connections until -the in-memory state matches the on-disk state.</p> -<div class="refsect3"> -<a name="nm-client-reload-connections.parameters"></a><h4>Parameters</h4> -<div class="informaltable"><table class="informaltable" width="100%" border="0"> -<colgroup> -<col width="150px" class="parameters_name"> -<col class="parameters_description"> -<col width="200px" class="parameters_annotations"> -</colgroup> -<tbody> -<tr> -<td class="parameter_name"><p>client</p></td> -<td class="parameter_description"><p>the <a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a></p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>cancellable</p></td> -<td class="parameter_description"><p>a <span class="type">GCancellable</span>, or <code class="literal">NULL</code></p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>error</p></td> -<td class="parameter_description"><p>return location for <span class="type">GError</span></p></td> -<td class="parameter_annotations"> </td> -</tr> -</tbody> -</table></div> -</div> -<div class="refsect3"> -<a name="nm-client-reload-connections.returns"></a><h4>Returns</h4> -<p> <code class="literal">TRUE</code> on success, <code class="literal">FALSE</code> on failure</p> -</div> -</div> -<hr> -<div class="refsect2"> -<a name="nm-client-reload-connections-async"></a><h3>nm_client_reload_connections_async ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> -nm_client_reload_connections_async (<em class="parameter"><code><a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a> *client</code></em>, - <em class="parameter"><code><span class="type">GCancellable</span> *cancellable</code></em>, - <em class="parameter"><code><span class="type">GAsyncReadyCallback</span> callback</code></em>, - <em class="parameter"><code><span class="type">gpointer</span> user_data</code></em>);</pre> -<p>Requests that the remote settings service begin reloading all connection -files from disk, adding, updating, and removing connections until the -in-memory state matches the on-disk state.</p> -<div class="refsect3"> -<a name="nm-client-reload-connections-async.parameters"></a><h4>Parameters</h4> -<div class="informaltable"><table class="informaltable" width="100%" border="0"> -<colgroup> -<col width="150px" class="parameters_name"> -<col class="parameters_description"> -<col width="200px" class="parameters_annotations"> -</colgroup> -<tbody> -<tr> -<td class="parameter_name"><p>client</p></td> -<td class="parameter_description"><p>the <a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a></p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>cancellable</p></td> -<td class="parameter_description"><p>a <span class="type">GCancellable</span>, or <code class="literal">NULL</code></p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>callback</p></td> -<td class="parameter_description"><p>callback to be called when the reload operation completes. </p></td> -<td class="parameter_annotations"><span class="annotation">[<acronym title="The callback is valid until first called."><span class="acronym">scope async</span></acronym>]</span></td> -</tr> -<tr> -<td class="parameter_name"><p>user_data</p></td> -<td class="parameter_description"><p>caller-specific data passed to <em class="parameter"><code>callback</code></em> -. </p></td> -<td class="parameter_annotations"><span class="annotation">[<acronym title="This parameter is a 'user_data', for callbacks; many bindings can pass NULL here."><span class="acronym">closure</span></acronym>]</span></td> -</tr> -</tbody> -</table></div> -</div> -</div> -<hr> -<div class="refsect2"> -<a name="nm-client-reload-connections-finish"></a><h3>nm_client_reload_connections_finish ()</h3> -<pre class="programlisting"><span class="returnvalue">gboolean</span> -nm_client_reload_connections_finish (<em class="parameter"><code><a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a> *client</code></em>, - <em class="parameter"><code><span class="type">GAsyncResult</span> *result</code></em>, - <em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre> -<p>Gets the result of an <a class="link" href="NMClient.html#nm-client-reload-connections-async" title="nm_client_reload_connections_async ()"><code class="function">nm_client_reload_connections_async()</code></a> call.</p> -<div class="refsect3"> -<a name="nm-client-reload-connections-finish.parameters"></a><h4>Parameters</h4> -<div class="informaltable"><table class="informaltable" width="100%" border="0"> -<colgroup> -<col width="150px" class="parameters_name"> -<col class="parameters_description"> -<col width="200px" class="parameters_annotations"> -</colgroup> -<tbody> -<tr> -<td class="parameter_name"><p>client</p></td> -<td class="parameter_description"><p>the <a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a></p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>result</p></td> -<td class="parameter_description"><p>the result passed to the <span class="type">GAsyncReadyCallback</span></p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>error</p></td> -<td class="parameter_description"><p>return location for <span class="type">GError</span></p></td> -<td class="parameter_annotations"> </td> -</tr> -</tbody> -</table></div> -</div> -<div class="refsect3"> -<a name="nm-client-reload-connections-finish.returns"></a><h4>Returns</h4> -<p> <code class="literal">TRUE</code> on success, <code class="literal">FALSE</code> on failure</p> -</div> -</div> -<hr> -<div class="refsect2"> -<a name="nm-client-get-dns-mode"></a><h3>nm_client_get_dns_mode ()</h3> -<pre class="programlisting">const <span class="returnvalue">char</span> * -nm_client_get_dns_mode (<em class="parameter"><code><a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a> *client</code></em>);</pre> -<p>Gets the current DNS processing mode.</p> -<div class="refsect3"> -<a name="nm-client-get-dns-mode.parameters"></a><h4>Parameters</h4> -<div class="informaltable"><table class="informaltable" width="100%" border="0"> -<colgroup> -<col width="150px" class="parameters_name"> -<col class="parameters_description"> -<col width="200px" class="parameters_annotations"> -</colgroup> -<tbody><tr> -<td class="parameter_name"><p>client</p></td> -<td class="parameter_description"><p>the <a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a></p></td> -<td class="parameter_annotations"> </td> -</tr></tbody> -</table></div> -</div> -<div class="refsect3"> -<a name="nm-client-get-dns-mode.returns"></a><h4>Returns</h4> -<p> the DNS processing mode, or <code class="literal">NULL</code> in case the -value is not available.</p> -</div> -<p class="since">Since: 1.6</p> -</div> -<hr> -<div class="refsect2"> -<a name="nm-client-get-dns-rc-manager"></a><h3>nm_client_get_dns_rc_manager ()</h3> -<pre class="programlisting">const <span class="returnvalue">char</span> * -nm_client_get_dns_rc_manager (<em class="parameter"><code><a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a> *client</code></em>);</pre> -<p>Gets the current DNS resolv.conf manager.</p> -<div class="refsect3"> -<a name="nm-client-get-dns-rc-manager.parameters"></a><h4>Parameters</h4> -<div class="informaltable"><table class="informaltable" width="100%" border="0"> -<colgroup> -<col width="150px" class="parameters_name"> -<col class="parameters_description"> -<col width="200px" class="parameters_annotations"> -</colgroup> -<tbody><tr> -<td class="parameter_name"><p>client</p></td> -<td class="parameter_description"><p>the <a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a></p></td> -<td class="parameter_annotations"> </td> -</tr></tbody> -</table></div> -</div> -<div class="refsect3"> -<a name="nm-client-get-dns-rc-manager.returns"></a><h4>Returns</h4> -<p> the resolv.conf manager or <code class="literal">NULL</code> in case the -value is not available.</p> -</div> -<p class="since">Since: 1.6</p> -</div> -<hr> -<div class="refsect2"> -<a name="nm-client-get-dns-configuration"></a><h3>nm_client_get_dns_configuration ()</h3> -<pre class="programlisting">const <span class="returnvalue">GPtrArray</span> * -nm_client_get_dns_configuration (<em class="parameter"><code><a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a> *client</code></em>);</pre> -<p>Gets the current DNS configuration</p> -<div class="refsect3"> -<a name="nm-client-get-dns-configuration.parameters"></a><h4>Parameters</h4> -<div class="informaltable"><table class="informaltable" width="100%" border="0"> -<colgroup> -<col width="150px" class="parameters_name"> -<col class="parameters_description"> -<col width="200px" class="parameters_annotations"> -</colgroup> -<tbody><tr> -<td class="parameter_name"><p>client</p></td> -<td class="parameter_description"><p>a <a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a></p></td> -<td class="parameter_annotations"> </td> -</tr></tbody> -</table></div> -</div> -<div class="refsect3"> -<a name="nm-client-get-dns-configuration.returns"></a><h4>Returns</h4> -<p>a <span class="type">GPtrArray</span> -containing <a class="link" href="NMClient.html#NMDnsEntry"><span class="type">NMDnsEntry</span></a> elements or <code class="literal">NULL</code> in case the value is not -available. The returned array is owned by the <a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a> object -and should not be modified. </p> -<p><span class="annotation">[<acronym title="The data is owned by the callee, which is responsible of freeing it."><span class="acronym">transfer none</span></acronym>][<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> NMDnsEntry]</span></p> -</div> -<p class="since">Since: 1.6</p> -</div> -<hr> -<div class="refsect2"> -<a name="nm-client-get-checkpoints"></a><h3>nm_client_get_checkpoints ()</h3> -<pre class="programlisting">const <span class="returnvalue">GPtrArray</span> * -nm_client_get_checkpoints (<em class="parameter"><code><a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a> *client</code></em>);</pre> -<p>Gets all the active checkpoints.</p> -<div class="refsect3"> -<a name="nm-client-get-checkpoints.parameters"></a><h4>Parameters</h4> -<div class="informaltable"><table class="informaltable" width="100%" border="0"> -<colgroup> -<col width="150px" class="parameters_name"> -<col class="parameters_description"> -<col width="200px" class="parameters_annotations"> -</colgroup> -<tbody><tr> -<td class="parameter_name"><p>client</p></td> -<td class="parameter_description"><p>a <a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a></p></td> -<td class="parameter_annotations"> </td> -</tr></tbody> -</table></div> -</div> -<div class="refsect3"> -<a name="nm-client-get-checkpoints.returns"></a><h4>Returns</h4> -<p>a <span class="type">GPtrArray</span> -containing all the <a class="link" href="NMCheckpoint.html" title="NMCheckpoint"><span class="type">NMCheckpoint</span></a>. The returned array is owned by the -<a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a> object and should not be modified. </p> -<p><span class="annotation">[<acronym title="The data is owned by the callee, which is responsible of freeing it."><span class="acronym">transfer none</span></acronym>][<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> NMCheckpoint]</span></p> -</div> -<p class="since">Since: 1.12</p> -</div> -<hr> -<div class="refsect2"> -<a name="nm-client-checkpoint-create"></a><h3>nm_client_checkpoint_create ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> -nm_client_checkpoint_create (<em class="parameter"><code><a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a> *client</code></em>, - <em class="parameter"><code>const <span class="type">GPtrArray</span> *devices</code></em>, - <em class="parameter"><code><span class="type">guint32</span> rollback_timeout</code></em>, - <em class="parameter"><code><a class="link" href="libnm-nm-dbus-interface.html#NMCheckpointCreateFlags" title="enum NMCheckpointCreateFlags"><span class="type">NMCheckpointCreateFlags</span></a> flags</code></em>, - <em class="parameter"><code><span class="type">GCancellable</span> *cancellable</code></em>, - <em class="parameter"><code><span class="type">GAsyncReadyCallback</span> callback</code></em>, - <em class="parameter"><code><span class="type">gpointer</span> user_data</code></em>);</pre> -<p>Creates a checkpoint of the current networking configuration -for given interfaces. An empty <em class="parameter"><code>devices</code></em> - argument means all -devices. If <em class="parameter"><code>rollback_timeout</code></em> - is not zero, a rollback is -automatically performed after the given timeout.</p> -<div class="refsect3"> -<a name="nm-client-checkpoint-create.parameters"></a><h4>Parameters</h4> -<div class="informaltable"><table class="informaltable" width="100%" border="0"> -<colgroup> -<col width="150px" class="parameters_name"> -<col class="parameters_description"> -<col width="200px" class="parameters_annotations"> -</colgroup> -<tbody> -<tr> -<td class="parameter_name"><p>client</p></td> -<td class="parameter_description"><p>the <a class="link" href="NMClient.html" title="NMClient"><code class="literal">NMClient</code></a></p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>devices</p></td> -<td class="parameter_description"><p>a list of devices for which a -checkpoint should be created. </p></td> -<td class="parameter_annotations"><span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> NMDevice]</span></td> -</tr> -<tr> -<td class="parameter_name"><p>rollback_timeout</p></td> -<td class="parameter_description"><p>the rollback timeout in seconds</p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>flags</p></td> -<td class="parameter_description"><p>creation flags</p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>cancellable</p></td> -<td class="parameter_description"><p>a <span class="type">GCancellable</span>, or <code class="literal">NULL</code></p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>callback</p></td> -<td class="parameter_description"><p>callback to be called when the add operation completes. </p></td> -<td class="parameter_annotations"><span class="annotation">[<acronym title="The callback is valid until first called."><span class="acronym">scope async</span></acronym>]</span></td> -</tr> -<tr> -<td class="parameter_name"><p>user_data</p></td> -<td class="parameter_description"><p>caller-specific data passed to <em class="parameter"><code>callback</code></em> -. </p></td> -<td class="parameter_annotations"><span class="annotation">[<acronym title="This parameter is a 'user_data', for callbacks; many bindings can pass NULL here."><span class="acronym">closure</span></acronym>]</span></td> -</tr> -</tbody> -</table></div> -</div> -<p class="since">Since: 1.12</p> -</div> -<hr> -<div class="refsect2"> -<a name="nm-client-checkpoint-create-finish"></a><h3>nm_client_checkpoint_create_finish ()</h3> -<pre class="programlisting"><a class="link" href="NMCheckpoint.html" title="NMCheckpoint"><span class="returnvalue">NMCheckpoint</span></a> * -nm_client_checkpoint_create_finish (<em class="parameter"><code><a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a> *client</code></em>, - <em class="parameter"><code><span class="type">GAsyncResult</span> *result</code></em>, - <em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre> -<p>Gets the result of a call to <a class="link" href="NMClient.html#nm-client-checkpoint-create" title="nm_client_checkpoint_create ()"><code class="function">nm_client_checkpoint_create()</code></a>.</p> -<div class="refsect3"> -<a name="nm-client-checkpoint-create-finish.parameters"></a><h4>Parameters</h4> -<div class="informaltable"><table class="informaltable" width="100%" border="0"> -<colgroup> -<col width="150px" class="parameters_name"> -<col class="parameters_description"> -<col width="200px" class="parameters_annotations"> -</colgroup> -<tbody> -<tr> -<td class="parameter_name"><p>client</p></td> -<td class="parameter_description"><p>the <a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a></p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>result</p></td> -<td class="parameter_description"><p>the result passed to the <span class="type">GAsyncReadyCallback</span></p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>error</p></td> -<td class="parameter_description"><p>location for a <span class="type">GError</span>, or <code class="literal">NULL</code></p></td> -<td class="parameter_annotations"> </td> -</tr> -</tbody> -</table></div> -</div> -<div class="refsect3"> -<a name="nm-client-checkpoint-create-finish.returns"></a><h4>Returns</h4> -<p>the new <a class="link" href="NMCheckpoint.html" title="NMCheckpoint"><span class="type">NMCheckpoint</span></a> on success, <code class="literal">NULL</code> on -failure, in which case <em class="parameter"><code>error</code></em> -will be set. </p> -<p><span class="annotation">[<acronym title="The caller owns the data, and is responsible for free it."><span class="acronym">transfer full</span></acronym>]</span></p> -</div> -<p class="since">Since: 1.12</p> -</div> -<hr> -<div class="refsect2"> -<a name="nm-client-checkpoint-destroy"></a><h3>nm_client_checkpoint_destroy ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> -nm_client_checkpoint_destroy (<em class="parameter"><code><a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a> *client</code></em>, - <em class="parameter"><code>const <span class="type">char</span> *checkpoint_path</code></em>, - <em class="parameter"><code><span class="type">GCancellable</span> *cancellable</code></em>, - <em class="parameter"><code><span class="type">GAsyncReadyCallback</span> callback</code></em>, - <em class="parameter"><code><span class="type">gpointer</span> user_data</code></em>);</pre> -<p>Destroys an existing checkpoint without performing a rollback.</p> -<div class="refsect3"> -<a name="nm-client-checkpoint-destroy.parameters"></a><h4>Parameters</h4> -<div class="informaltable"><table class="informaltable" width="100%" border="0"> -<colgroup> -<col width="150px" class="parameters_name"> -<col class="parameters_description"> -<col width="200px" class="parameters_annotations"> -</colgroup> -<tbody> -<tr> -<td class="parameter_name"><p>client</p></td> -<td class="parameter_description"><p>the <a class="link" href="NMClient.html" title="NMClient"><code class="literal">NMClient</code></a></p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>checkpoint_path</p></td> -<td class="parameter_description"><p>the D-Bus path for the checkpoint</p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>cancellable</p></td> -<td class="parameter_description"><p>a <span class="type">GCancellable</span>, or <code class="literal">NULL</code></p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>callback</p></td> -<td class="parameter_description"><p>callback to be called when the add operation completes. </p></td> -<td class="parameter_annotations"><span class="annotation">[<acronym title="The callback is valid until first called."><span class="acronym">scope async</span></acronym>]</span></td> -</tr> -<tr> -<td class="parameter_name"><p>user_data</p></td> -<td class="parameter_description"><p>caller-specific data passed to <em class="parameter"><code>callback</code></em> -. </p></td> -<td class="parameter_annotations"><span class="annotation">[<acronym title="This parameter is a 'user_data', for callbacks; many bindings can pass NULL here."><span class="acronym">closure</span></acronym>]</span></td> -</tr> -</tbody> -</table></div> -</div> -<p class="since">Since: 1.12</p> -</div> -<hr> -<div class="refsect2"> -<a name="nm-client-checkpoint-destroy-finish"></a><h3>nm_client_checkpoint_destroy_finish ()</h3> -<pre class="programlisting"><span class="returnvalue">gboolean</span> -nm_client_checkpoint_destroy_finish (<em class="parameter"><code><a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a> *client</code></em>, - <em class="parameter"><code><span class="type">GAsyncResult</span> *result</code></em>, - <em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre> -<p>Gets the result of a call to <a class="link" href="NMClient.html#nm-client-checkpoint-destroy" title="nm_client_checkpoint_destroy ()"><code class="function">nm_client_checkpoint_destroy()</code></a>.</p> -<div class="refsect3"> -<a name="nm-client-checkpoint-destroy-finish.parameters"></a><h4>Parameters</h4> -<div class="informaltable"><table class="informaltable" width="100%" border="0"> -<colgroup> -<col width="150px" class="parameters_name"> -<col class="parameters_description"> -<col width="200px" class="parameters_annotations"> -</colgroup> -<tbody> -<tr> -<td class="parameter_name"><p>client</p></td> -<td class="parameter_description"><p>an <a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a></p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>result</p></td> -<td class="parameter_description"><p>the result passed to the <span class="type">GAsyncReadyCallback</span></p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>error</p></td> -<td class="parameter_description"><p>location for a <span class="type">GError</span>, or <code class="literal">NULL</code></p></td> -<td class="parameter_annotations"> </td> -</tr> -</tbody> -</table></div> -</div> -<div class="refsect3"> -<a name="nm-client-checkpoint-destroy-finish.returns"></a><h4>Returns</h4> -<p> <code class="literal">TRUE</code> on success or <code class="literal">FALSE</code> on failure, in which case -<em class="parameter"><code>error</code></em> -will be set.</p> -</div> -<p class="since">Since: 1.12</p> -</div> -<hr> -<div class="refsect2"> -<a name="nm-client-checkpoint-rollback"></a><h3>nm_client_checkpoint_rollback ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> -nm_client_checkpoint_rollback (<em class="parameter"><code><a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a> *client</code></em>, - <em class="parameter"><code>const <span class="type">char</span> *checkpoint_path</code></em>, - <em class="parameter"><code><span class="type">GCancellable</span> *cancellable</code></em>, - <em class="parameter"><code><span class="type">GAsyncReadyCallback</span> callback</code></em>, - <em class="parameter"><code><span class="type">gpointer</span> user_data</code></em>);</pre> -<p>Performs the rollback of a checkpoint before the timeout is reached.</p> -<div class="refsect3"> -<a name="nm-client-checkpoint-rollback.parameters"></a><h4>Parameters</h4> -<div class="informaltable"><table class="informaltable" width="100%" border="0"> -<colgroup> -<col width="150px" class="parameters_name"> -<col class="parameters_description"> -<col width="200px" class="parameters_annotations"> -</colgroup> -<tbody> -<tr> -<td class="parameter_name"><p>client</p></td> -<td class="parameter_description"><p>the <a class="link" href="NMClient.html" title="NMClient"><code class="literal">NMClient</code></a></p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>checkpoint_path</p></td> -<td class="parameter_description"><p>the D-Bus path to the checkpoint</p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>cancellable</p></td> -<td class="parameter_description"><p>a <span class="type">GCancellable</span>, or <code class="literal">NULL</code></p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>callback</p></td> -<td class="parameter_description"><p>callback to be called when the add operation completes. </p></td> -<td class="parameter_annotations"><span class="annotation">[<acronym title="The callback is valid until first called."><span class="acronym">scope async</span></acronym>]</span></td> -</tr> -<tr> -<td class="parameter_name"><p>user_data</p></td> -<td class="parameter_description"><p>caller-specific data passed to <em class="parameter"><code>callback</code></em> -. </p></td> -<td class="parameter_annotations"><span class="annotation">[<acronym title="This parameter is a 'user_data', for callbacks; many bindings can pass NULL here."><span class="acronym">closure</span></acronym>]</span></td> -</tr> -</tbody> -</table></div> -</div> -<p class="since">Since: 1.12</p> -</div> -<hr> -<div class="refsect2"> -<a name="nm-client-checkpoint-rollback-finish"></a><h3>nm_client_checkpoint_rollback_finish ()</h3> -<pre class="programlisting"><span class="returnvalue">GHashTable</span> * -nm_client_checkpoint_rollback_finish (<em class="parameter"><code><a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a> *client</code></em>, - <em class="parameter"><code><span class="type">GAsyncResult</span> *result</code></em>, - <em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre> -<p>Gets the result of a call to <a class="link" href="NMClient.html#nm-client-checkpoint-rollback" title="nm_client_checkpoint_rollback ()"><code class="function">nm_client_checkpoint_rollback()</code></a>.</p> -<div class="refsect3"> -<a name="nm-client-checkpoint-rollback-finish.parameters"></a><h4>Parameters</h4> -<div class="informaltable"><table class="informaltable" width="100%" border="0"> -<colgroup> -<col width="150px" class="parameters_name"> -<col class="parameters_description"> -<col width="200px" class="parameters_annotations"> -</colgroup> -<tbody> -<tr> -<td class="parameter_name"><p>client</p></td> -<td class="parameter_description"><p>an <a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a></p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>result</p></td> -<td class="parameter_description"><p>the result passed to the <span class="type">GAsyncReadyCallback</span></p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>error</p></td> -<td class="parameter_description"><p>location for a <span class="type">GError</span>, or <code class="literal">NULL</code></p></td> -<td class="parameter_annotations"> </td> -</tr> -</tbody> -</table></div> -</div> -<div class="refsect3"> -<a name="nm-client-checkpoint-rollback-finish.returns"></a><h4>Returns</h4> -<p>an hash table of -devices and results. Devices are represented by their original -D-Bus path; each result is a <a class="link" href="libnm-nm-dbus-interface.html#NMRollbackResult" title="enum NMRollbackResult"><span class="type">NMRollbackResult</span></a>. </p> -<p><span class="annotation">[<acronym title="The caller owns the data, and is responsible for free it."><span class="acronym">transfer full</span></acronym>][<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> utf8 guint32]</span></p> -</div> -<p class="since">Since: 1.12</p> -</div> -<hr> -<div class="refsect2"> -<a name="nm-client-checkpoint-adjust-rollback-timeout"></a><h3>nm_client_checkpoint_adjust_rollback_timeout ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> -nm_client_checkpoint_adjust_rollback_timeout - (<em class="parameter"><code><a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a> *client</code></em>, - <em class="parameter"><code>const <span class="type">char</span> *checkpoint_path</code></em>, - <em class="parameter"><code><span class="type">guint32</span> add_timeout</code></em>, - <em class="parameter"><code><span class="type">GCancellable</span> *cancellable</code></em>, - <em class="parameter"><code><span class="type">GAsyncReadyCallback</span> callback</code></em>, - <em class="parameter"><code><span class="type">gpointer</span> user_data</code></em>);</pre> -<p>Resets the timeout for the checkpoint with path <em class="parameter"><code>checkpoint_path</code></em> - -to <em class="parameter"><code>timeout_add</code></em> -.</p> -<div class="refsect3"> -<a name="nm-client-checkpoint-adjust-rollback-timeout.parameters"></a><h4>Parameters</h4> -<div class="informaltable"><table class="informaltable" width="100%" border="0"> -<colgroup> -<col width="150px" class="parameters_name"> -<col class="parameters_description"> -<col width="200px" class="parameters_annotations"> -</colgroup> -<tbody> -<tr> -<td class="parameter_name"><p>client</p></td> -<td class="parameter_description"><p>the <a class="link" href="NMClient.html" title="NMClient"><code class="literal">NMClient</code></a></p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>checkpoint_path</p></td> -<td class="parameter_description"><p>a D-Bus path to a checkpoint</p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>add_timeout</p></td> -<td class="parameter_description"><p>the timeout in seconds counting from now. -Set to zero, to disable the timeout.</p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>cancellable</p></td> -<td class="parameter_description"><p>a <span class="type">GCancellable</span>, or <code class="literal">NULL</code></p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>callback</p></td> -<td class="parameter_description"><p>callback to be called when the add operation completes. </p></td> -<td class="parameter_annotations"><span class="annotation">[<acronym title="The callback is valid until first called."><span class="acronym">scope async</span></acronym>]</span></td> -</tr> -<tr> -<td class="parameter_name"><p>user_data</p></td> -<td class="parameter_description"><p>caller-specific data passed to <em class="parameter"><code>callback</code></em> -. </p></td> -<td class="parameter_annotations"><span class="annotation">[<acronym title="This parameter is a 'user_data', for callbacks; many bindings can pass NULL here."><span class="acronym">closure</span></acronym>]</span></td> -</tr> -</tbody> -</table></div> -</div> -<p class="since">Since: 1.12</p> -</div> -<hr> -<div class="refsect2"> -<a name="nm-client-checkpoint-adjust-rollback-timeout-finish"></a><h3>nm_client_checkpoint_adjust_rollback_timeout_finish ()</h3> -<pre class="programlisting"><span class="returnvalue">gboolean</span> -nm_client_checkpoint_adjust_rollback_timeout_finish - (<em class="parameter"><code><a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a> *client</code></em>, - <em class="parameter"><code><span class="type">GAsyncResult</span> *result</code></em>, - <em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre> -<p>Gets the result of a call to <a class="link" href="NMClient.html#nm-client-checkpoint-adjust-rollback-timeout" title="nm_client_checkpoint_adjust_rollback_timeout ()"><code class="function">nm_client_checkpoint_adjust_rollback_timeout()</code></a>.</p> -<div class="refsect3"> -<a name="nm-client-checkpoint-adjust-rollback-timeout-finish.parameters"></a><h4>Parameters</h4> -<div class="informaltable"><table class="informaltable" width="100%" border="0"> -<colgroup> -<col width="150px" class="parameters_name"> -<col class="parameters_description"> -<col width="200px" class="parameters_annotations"> -</colgroup> -<tbody> -<tr> -<td class="parameter_name"><p>client</p></td> -<td class="parameter_description"><p>an <a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a></p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>result</p></td> -<td class="parameter_description"><p>the result passed to the <span class="type">GAsyncReadyCallback</span></p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>error</p></td> -<td class="parameter_description"><p>location for a <span class="type">GError</span>, or <code class="literal">NULL</code></p></td> -<td class="parameter_annotations"> </td> -</tr> -</tbody> -</table></div> -</div> -<div class="refsect3"> -<a name="nm-client-checkpoint-adjust-rollback-timeout-finish.returns"></a><h4>Returns</h4> -<p> <code class="literal">TRUE</code> on success or <code class="literal">FALSE</code> on failure.</p> -</div> -<p class="since">Since: 1.12</p> -</div> -<hr> -<div class="refsect2"> -<a name="nm-client-reload"></a><h3>nm_client_reload ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> -nm_client_reload (<em class="parameter"><code><a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a> *client</code></em>, - <em class="parameter"><code><a class="link" href="libnm-nm-dbus-interface.html#NMManagerReloadFlags" title="enum NMManagerReloadFlags"><span class="type">NMManagerReloadFlags</span></a> flags</code></em>, - <em class="parameter"><code><span class="type">GCancellable</span> *cancellable</code></em>, - <em class="parameter"><code><span class="type">GAsyncReadyCallback</span> callback</code></em>, - <em class="parameter"><code><span class="type">gpointer</span> user_data</code></em>);</pre> -<p>Reload NetworkManager's configuration and perform certain updates, like -flushing caches or rewriting external state to disk. This is similar to -sending SIGHUP to NetworkManager but it allows for more fine-grained control -over what to reload (see <em class="parameter"><code>flags</code></em> -). It also allows non-root access via -PolicyKit and contrary to signals it is synchronous.</p> -<div class="refsect3"> -<a name="nm-client-reload.parameters"></a><h4>Parameters</h4> -<div class="informaltable"><table class="informaltable" width="100%" border="0"> -<colgroup> -<col width="150px" class="parameters_name"> -<col class="parameters_description"> -<col width="200px" class="parameters_annotations"> -</colgroup> -<tbody> -<tr> -<td class="parameter_name"><p>client</p></td> -<td class="parameter_description"><p>the <a class="link" href="NMClient.html" title="NMClient"><code class="literal">NMClient</code></a></p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>flags</p></td> -<td class="parameter_description"><p>flags indicating what to reload.</p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>cancellable</p></td> -<td class="parameter_description"><p>a <span class="type">GCancellable</span>, or <code class="literal">NULL</code></p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>callback</p></td> -<td class="parameter_description"><p>callback to be called when the add operation completes. </p></td> -<td class="parameter_annotations"><span class="annotation">[<acronym title="The callback is valid until first called."><span class="acronym">scope async</span></acronym>]</span></td> -</tr> -<tr> -<td class="parameter_name"><p>user_data</p></td> -<td class="parameter_description"><p>caller-specific data passed to <em class="parameter"><code>callback</code></em> -. </p></td> -<td class="parameter_annotations"><span class="annotation">[<acronym title="This parameter is a 'user_data', for callbacks; many bindings can pass NULL here."><span class="acronym">closure</span></acronym>]</span></td> -</tr> -</tbody> -</table></div> -</div> -<p class="since">Since: 1.22</p> -</div> -<hr> -<div class="refsect2"> -<a name="nm-client-reload-finish"></a><h3>nm_client_reload_finish ()</h3> -<pre class="programlisting"><span class="returnvalue">gboolean</span> -nm_client_reload_finish (<em class="parameter"><code><a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a> *client</code></em>, - <em class="parameter"><code><span class="type">GAsyncResult</span> *result</code></em>, - <em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre> -<p>Gets the result of a call to <a class="link" href="NMClient.html#nm-client-reload" title="nm_client_reload ()"><code class="function">nm_client_reload()</code></a>.</p> -<div class="refsect3"> -<a name="nm-client-reload-finish.parameters"></a><h4>Parameters</h4> -<div class="informaltable"><table class="informaltable" width="100%" border="0"> -<colgroup> -<col width="150px" class="parameters_name"> -<col class="parameters_description"> -<col width="200px" class="parameters_annotations"> -</colgroup> -<tbody> -<tr> -<td class="parameter_name"><p>client</p></td> -<td class="parameter_description"><p>an <a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a></p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>result</p></td> -<td class="parameter_description"><p>the result passed to the <span class="type">GAsyncReadyCallback</span></p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>error</p></td> -<td class="parameter_description"><p>location for a <span class="type">GError</span>, or <code class="literal">NULL</code></p></td> -<td class="parameter_annotations"> </td> -</tr> -</tbody> -</table></div> -</div> -<div class="refsect3"> -<a name="nm-client-reload-finish.returns"></a><h4>Returns</h4> -<p> <code class="literal">TRUE</code> on success or <code class="literal">FALSE</code> on failure.</p> -</div> -<p class="since">Since: 1.22</p> -</div> -<hr> -<div class="refsect2"> -<a name="nm-client-dbus-call"></a><h3>nm_client_dbus_call ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> -nm_client_dbus_call (<em class="parameter"><code><a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a> *client</code></em>, - <em class="parameter"><code>const <span class="type">char</span> *object_path</code></em>, - <em class="parameter"><code>const <span class="type">char</span> *interface_name</code></em>, - <em class="parameter"><code>const <span class="type">char</span> *method_name</code></em>, - <em class="parameter"><code><span class="type">GVariant</span> *parameters</code></em>, - <em class="parameter"><code>const <span class="type">GVariantType</span> *reply_type</code></em>, - <em class="parameter"><code><span class="type">int</span> timeout_msec</code></em>, - <em class="parameter"><code><span class="type">GCancellable</span> *cancellable</code></em>, - <em class="parameter"><code><span class="type">GAsyncReadyCallback</span> callback</code></em>, - <em class="parameter"><code><span class="type">gpointer</span> user_data</code></em>);</pre> -<p>Call <code class="function">g_dbus_connection_call()</code> on the current name owner with the specified -arguments. Most importantly, this invokes <code class="function">g_dbus_connection_call()</code> with the -client's <span class="type">GMainContext</span>, so that the response is always in order with other -events D-Bus events. Of course, the call uses <span class="type">GTask</span> and will invoke the -callback on the current <code class="function">g_main_context_get_thread_default()</code>.</p> -<p>This API is merely a convenient wrapper for <code class="function">g_dbus_connection_call()</code>. You can -also use <code class="function">g_dbus_connection_call()</code> directly, with the same effect.</p> -<div class="refsect3"> -<a name="nm-client-dbus-call.parameters"></a><h4>Parameters</h4> -<div class="informaltable"><table class="informaltable" width="100%" border="0"> -<colgroup> -<col width="150px" class="parameters_name"> -<col class="parameters_description"> -<col width="200px" class="parameters_annotations"> -</colgroup> -<tbody> -<tr> -<td class="parameter_name"><p>client</p></td> -<td class="parameter_description"><p>the <a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a></p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>object_path</p></td> -<td class="parameter_description"><p>path of remote object</p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>interface_name</p></td> -<td class="parameter_description"><p>D-Bus interface to invoke method on</p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>method_name</p></td> -<td class="parameter_description"><p>the name of the method to invoke</p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>parameters</p></td> -<td class="parameter_description"><p>a <span class="type">GVariant</span> tuple with parameters for the method -or <code class="literal">NULL</code> if not passing parameters. </p></td> -<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td> -</tr> -<tr> -<td class="parameter_name"><p>reply_type</p></td> -<td class="parameter_description"><p>the expected type of the reply (which will be a -tuple), or <code class="literal">NULL</code>. </p></td> -<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td> -</tr> -<tr> -<td class="parameter_name"><p>timeout_msec</p></td> -<td class="parameter_description"><p>the timeout in milliseconds, -1 to use the default -timeout or <code class="literal">G_MAXINT</code> for no timeout</p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>cancellable</p></td> -<td class="parameter_description"><p>a <span class="type">GCancellable</span> or <code class="literal">NULL</code>. </p></td> -<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td> -</tr> -<tr> -<td class="parameter_name"><p>callback</p></td> -<td class="parameter_description"><p>a <span class="type">GAsyncReadyCallback</span> to call when the request -is satisfied or <code class="literal">NULL</code> if you don't care about the result of the -method invocation. </p></td> -<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td> -</tr> -<tr> -<td class="parameter_name"><p>user_data</p></td> -<td class="parameter_description"><p>the data to pass to <em class="parameter"><code>callback</code></em> -</p></td> -<td class="parameter_annotations"> </td> -</tr> -</tbody> -</table></div> -</div> -<p class="since">Since: 1.24</p> -</div> -<hr> -<div class="refsect2"> -<a name="nm-client-dbus-call-finish"></a><h3>nm_client_dbus_call_finish ()</h3> -<pre class="programlisting"><span class="returnvalue">GVariant</span> * -nm_client_dbus_call_finish (<em class="parameter"><code><a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a> *client</code></em>, - <em class="parameter"><code><span class="type">GAsyncResult</span> *result</code></em>, - <em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre> -<p>Gets the result of a call to <a class="link" href="NMClient.html#nm-client-dbus-call" title="nm_client_dbus_call ()"><code class="function">nm_client_dbus_call()</code></a>.</p> -<div class="refsect3"> -<a name="nm-client-dbus-call-finish.parameters"></a><h4>Parameters</h4> -<div class="informaltable"><table class="informaltable" width="100%" border="0"> -<colgroup> -<col width="150px" class="parameters_name"> -<col class="parameters_description"> -<col width="200px" class="parameters_annotations"> -</colgroup> -<tbody> -<tr> -<td class="parameter_name"><p>client</p></td> -<td class="parameter_description"><p>the <a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a> instance</p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>result</p></td> -<td class="parameter_description"><p>the result passed to the <span class="type">GAsyncReadyCallback</span></p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>error</p></td> -<td class="parameter_description"><p>location for a <span class="type">GError</span>, or <code class="literal">NULL</code></p></td> -<td class="parameter_annotations"> </td> -</tr> -</tbody> -</table></div> -</div> -<div class="refsect3"> -<a name="nm-client-dbus-call-finish.returns"></a><h4>Returns</h4> -<p>the result <span class="type">GVariant</span> or <code class="literal">NULL</code> on error. </p> -<p><span class="annotation">[<acronym title="The caller owns the data, and is responsible for free it."><span class="acronym">transfer full</span></acronym>]</span></p> -</div> -<p class="since">Since: 1.24</p> -</div> -<hr> -<div class="refsect2"> -<a name="nm-client-dbus-set-property"></a><h3>nm_client_dbus_set_property ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> -nm_client_dbus_set_property (<em class="parameter"><code><a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a> *client</code></em>, - <em class="parameter"><code>const <span class="type">char</span> *object_path</code></em>, - <em class="parameter"><code>const <span class="type">char</span> *interface_name</code></em>, - <em class="parameter"><code>const <span class="type">char</span> *property_name</code></em>, - <em class="parameter"><code><span class="type">GVariant</span> *value</code></em>, - <em class="parameter"><code><span class="type">int</span> timeout_msec</code></em>, - <em class="parameter"><code><span class="type">GCancellable</span> *cancellable</code></em>, - <em class="parameter"><code><span class="type">GAsyncReadyCallback</span> callback</code></em>, - <em class="parameter"><code><span class="type">gpointer</span> user_data</code></em>);</pre> -<p>Like <a class="link" href="NMClient.html#nm-client-dbus-call" title="nm_client_dbus_call ()"><code class="function">nm_client_dbus_call()</code></a> but calls "Set" on the standard "org.freedesktop.DBus.Properties" -D-Bus interface.</p> -<div class="refsect3"> -<a name="nm-client-dbus-set-property.parameters"></a><h4>Parameters</h4> -<div class="informaltable"><table class="informaltable" width="100%" border="0"> -<colgroup> -<col width="150px" class="parameters_name"> -<col class="parameters_description"> -<col width="200px" class="parameters_annotations"> -</colgroup> -<tbody> -<tr> -<td class="parameter_name"><p>client</p></td> -<td class="parameter_description"><p>the <a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a></p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>object_path</p></td> -<td class="parameter_description"><p>path of remote object</p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>interface_name</p></td> -<td class="parameter_description"><p>D-Bus interface for the property to set.</p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>property_name</p></td> -<td class="parameter_description"><p>the name of the property to set</p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>value</p></td> -<td class="parameter_description"><p>a <span class="type">GVariant</span> with the value to set.</p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>timeout_msec</p></td> -<td class="parameter_description"><p>the timeout in milliseconds, -1 to use the default -timeout or <code class="literal">G_MAXINT</code> for no timeout</p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>cancellable</p></td> -<td class="parameter_description"><p>a <span class="type">GCancellable</span> or <code class="literal">NULL</code>. </p></td> -<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td> -</tr> -<tr> -<td class="parameter_name"><p>callback</p></td> -<td class="parameter_description"><p>a <span class="type">GAsyncReadyCallback</span> to call when the request -is satisfied or <code class="literal">NULL</code> if you don't care about the result of the -method invocation. </p></td> -<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td> -</tr> -<tr> -<td class="parameter_name"><p>user_data</p></td> -<td class="parameter_description"><p>the data to pass to <em class="parameter"><code>callback</code></em> -</p></td> -<td class="parameter_annotations"> </td> -</tr> -</tbody> -</table></div> -</div> -<p class="since">Since: 1.24</p> -</div> -<hr> -<div class="refsect2"> -<a name="nm-client-dbus-set-property-finish"></a><h3>nm_client_dbus_set_property_finish ()</h3> -<pre class="programlisting"><span class="returnvalue">gboolean</span> -nm_client_dbus_set_property_finish (<em class="parameter"><code><a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a> *client</code></em>, - <em class="parameter"><code><span class="type">GAsyncResult</span> *result</code></em>, - <em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre> -<p>Gets the result of a call to <a class="link" href="NMClient.html#nm-client-dbus-set-property" title="nm_client_dbus_set_property ()"><code class="function">nm_client_dbus_set_property()</code></a>.</p> -<div class="refsect3"> -<a name="nm-client-dbus-set-property-finish.parameters"></a><h4>Parameters</h4> -<div class="informaltable"><table class="informaltable" width="100%" border="0"> -<colgroup> -<col width="150px" class="parameters_name"> -<col class="parameters_description"> -<col width="200px" class="parameters_annotations"> -</colgroup> -<tbody> -<tr> -<td class="parameter_name"><p>client</p></td> -<td class="parameter_description"><p>the <a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a> instance</p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>result</p></td> -<td class="parameter_description"><p>the result passed to the <span class="type">GAsyncReadyCallback</span></p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>error</p></td> -<td class="parameter_description"><p>location for a <span class="type">GError</span>, or <code class="literal">NULL</code></p></td> -<td class="parameter_annotations"> </td> -</tr> -</tbody> -</table></div> -</div> -<div class="refsect3"> -<a name="nm-client-dbus-set-property-finish.returns"></a><h4>Returns</h4> -<p> <code class="literal">TRUE</code> on success or <code class="literal">FALSE</code> on failure.</p> -</div> -<p class="since">Since: 1.24</p> -</div> -<hr> -<div class="refsect2"> -<a name="nm-utils-print"></a><h3>nm_utils_print ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> -nm_utils_print (<em class="parameter"><code><span class="type">int</span> output_mode</code></em>, - <em class="parameter"><code>const <span class="type">char</span> *msg</code></em>);</pre> -<p>The only purpose of this function is to give access to <code class="function">g_print()</code> -or <code class="function">g_printerr()</code> from pygobject. libnm can do debug logging by -setting LIBNM_CLIENT_DEBUG and uses thereby <code class="function">g_printerr()</code> or -<code class="function">g_print()</code>. A plain "<code class="function">print()</code>" function in python is not in sync -with these functions (it implements additional buffering). By -using <a class="link" href="NMClient.html#nm-utils-print" title="nm_utils_print ()"><code class="function">nm_utils_print()</code></a>, the same logging mechanisms can be used.</p> -<p>LIBNM_CLIENT_DEBUG is a list of keywords separated by commas. The keyword -"trace" enables printing messages of the lowest up to the highest severity. -Likewise, the severities "debug", "warn" ("warning") and "error" are honored -in similar way. Setting the flags "ERROR" or "WARN" ("WARNING") implies that -respective levels are enabled, but also are ERROR messages printed with -<code class="function">g_critical()</code> and WARN messages with <code class="function">g_warning()</code>. Together with G_DEBUG="fatal-warnings" -or G_DEBUG="fatal-critical" this can be used to abort the program on errors. -Note that all <error> messages imply an unexpected data on the D-Bus API -(due to a bug). <warn> also implies unexepected data, but that can happen -when using different versions of libnm and daemon. For testing, it is -good to turn these into assertions.</p> -<p>By default, messages are printed to stderr, unless LIBNM_CLIENT_DEBUG -contains "stdout" flag. Also, libnm honors LIBNM_CLIENT_DEBUG_FILE -environment. If this is set to a filename pattern (accepting "%<code class="literal">p</code>" for the -process ID), then the debug log is written to that file instead of -stderr/stdout. With <em class="parameter"><code>output_mode</code></em> - zero, the same location will be written.</p> -<p>LIBNM_CLIENT_DEBUG_FILE is supported since 1.44. "ERROR", "WARN" and "WARNING" -are supported since 1.46.</p> -<div class="refsect3"> -<a name="nm-utils-print.parameters"></a><h4>Parameters</h4> -<div class="informaltable"><table class="informaltable" width="100%" border="0"> -<colgroup> -<col width="150px" class="parameters_name"> -<col class="parameters_description"> -<col width="200px" class="parameters_annotations"> -</colgroup> -<tbody> -<tr> -<td class="parameter_name"><p>output_mode</p></td> -<td class="parameter_description"><p>if 1 it uses <code class="function">g_print()</code>. If 2, it uses <code class="function">g_printerr()</code>. -If 0, it uses the same output as internal libnm debug logging -does. That is, depending on LIBNM_CLIENT_DEBUG's "stdout" flag -it uses <code class="function">g_print()</code> or <code class="function">g_printerr()</code> and if LIBNM_CLIENT_DEBUG_FILE is -set, it writes the output to file instead</p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>msg</p></td> -<td class="parameter_description"><p>the message to print. The function does not append -a trailing newline.</p></td> -<td class="parameter_annotations"> </td> -</tr> -</tbody> -</table></div> -</div> -<p class="since">Since: 1.30</p> -</div> -<hr> -<div class="refsect2"> -<a name="nm-utils-file-is-certificate"></a><h3>nm_utils_file_is_certificate ()</h3> -<pre class="programlisting"><span class="returnvalue">gboolean</span> -nm_utils_file_is_certificate (<em class="parameter"><code>const <span class="type">char</span> *filename</code></em>);</pre> -<p>Tests if <em class="parameter"><code>filename</code></em> - has a valid extension for an X.509 certificate file -(".cer", ".crt", ".der", or ".pem"), and contains a certificate in a format -recognized by NetworkManager.</p> -<div class="refsect3"> -<a name="nm-utils-file-is-certificate.parameters"></a><h4>Parameters</h4> -<div class="informaltable"><table class="informaltable" width="100%" border="0"> -<colgroup> -<col width="150px" class="parameters_name"> -<col class="parameters_description"> -<col width="200px" class="parameters_annotations"> -</colgroup> -<tbody><tr> -<td class="parameter_name"><p>filename</p></td> -<td class="parameter_description"><p>name of the file to test</p></td> -<td class="parameter_annotations"> </td> -</tr></tbody> -</table></div> -</div> -<div class="refsect3"> -<a name="nm-utils-file-is-certificate.returns"></a><h4>Returns</h4> -<p> <code class="literal">TRUE</code> if the file is a certificate, <code class="literal">FALSE</code> if it is not</p> -</div> -</div> -<hr> -<div class="refsect2"> -<a name="nm-utils-file-is-private-key"></a><h3>nm_utils_file_is_private_key ()</h3> -<pre class="programlisting"><span class="returnvalue">gboolean</span> -nm_utils_file_is_private_key (<em class="parameter"><code>const <span class="type">char</span> *filename</code></em>, - <em class="parameter"><code><span class="type">gboolean</span> *out_encrypted</code></em>);</pre> -<p>Tests if <em class="parameter"><code>filename</code></em> - has a valid extension for an X.509 private key file -(".der", ".key", ".pem", or ".p12"), and contains a private key in a format -recognized by NetworkManager.</p> -<div class="refsect3"> -<a name="nm-utils-file-is-private-key.parameters"></a><h4>Parameters</h4> -<div class="informaltable"><table class="informaltable" width="100%" border="0"> -<colgroup> -<col width="150px" class="parameters_name"> -<col class="parameters_description"> -<col width="200px" class="parameters_annotations"> -</colgroup> -<tbody> -<tr> -<td class="parameter_name"><p>filename</p></td> -<td class="parameter_description"><p>name of the file to test</p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>out_encrypted</p></td> -<td class="parameter_description"><p>on return, whether the file is encrypted. </p></td> -<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span></td> -</tr> -</tbody> -</table></div> -</div> -<div class="refsect3"> -<a name="nm-utils-file-is-private-key.returns"></a><h4>Returns</h4> -<p> <code class="literal">TRUE</code> if the file is a private key, <code class="literal">FALSE</code> if it is not</p> -</div> -</div> -<hr> -<div class="refsect2"> -<a name="nm-utils-file-is-pkcs12"></a><h3>nm_utils_file_is_pkcs12 ()</h3> -<pre class="programlisting"><span class="returnvalue">gboolean</span> -nm_utils_file_is_pkcs12 (<em class="parameter"><code>const <span class="type">char</span> *filename</code></em>);</pre> -<p>Tests if <em class="parameter"><code>filename</code></em> - is a PKCS#12 file.</p> -<div class="refsect3"> -<a name="nm-utils-file-is-pkcs12.parameters"></a><h4>Parameters</h4> -<div class="informaltable"><table class="informaltable" width="100%" border="0"> -<colgroup> -<col width="150px" class="parameters_name"> -<col class="parameters_description"> -<col width="200px" class="parameters_annotations"> -</colgroup> -<tbody><tr> -<td class="parameter_name"><p>filename</p></td> -<td class="parameter_description"><p>name of the file to test</p></td> -<td class="parameter_annotations"> </td> -</tr></tbody> -</table></div> -</div> -<div class="refsect3"> -<a name="nm-utils-file-is-pkcs12.returns"></a><h4>Returns</h4> -<p> <code class="literal">TRUE</code> if the file is PKCS#12, <code class="literal">FALSE</code> if it is not</p> -</div> -</div> -<hr> -<div class="refsect2"> -<a name="nm-client-wait-shutdown"></a><h3>nm_client_wait_shutdown ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> -nm_client_wait_shutdown (<em class="parameter"><code><a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a> *client</code></em>, - <em class="parameter"><code><span class="type">gboolean</span> integrate_maincontext</code></em>, - <em class="parameter"><code><span class="type">GCancellable</span> *cancellable</code></em>, - <em class="parameter"><code><span class="type">GAsyncReadyCallback</span> callback</code></em>, - <em class="parameter"><code><span class="type">gpointer</span> user_data</code></em>);</pre> -<p>The way to stop <a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a> is by unrefing it. That will cancel all -internally pending async operations. However, as async operations in -NMClient use GTask, hence they cannot complete right away. Instead, -their (internal) result callback still needs to be dispatched by iterating -the client's main context.</p> -<p>You thus cannot stop iterating the client's main context until -everything is wrapped up. <a class="link" href="NMClient.html#nm-client-get-context-busy-watcher" title="nm_client_get_context_busy_watcher ()"><code class="function">nm_client_get_context_busy_watcher()</code></a> -helps to watch how long that will be.</p> -<p>This function automates that waiting. Like all glib async operations -this honors the current <code class="function">g_main_context_get_thread_default()</code>.</p> -<p>In any case, to complete the shutdown, <a class="link" href="NMClient.html#nm-client-get-main-context" title="nm_client_get_main_context ()"><code class="function">nm_client_get_main_context()</code></a> -must be iterated. If the current <code class="function">g_main_context_get_thread_default()</code> is -the same as <a class="link" href="NMClient.html#nm-client-get-main-context" title="nm_client_get_main_context ()"><code class="function">nm_client_get_main_context()</code></a>, then <em class="parameter"><code>integrate_maincontext</code></em> - -is ignored. In that case, the caller is required to iterate the context -for shutdown to complete. Otherwise, if <code class="function">g_main_context_get_thread_default()</code> -differs from <a class="link" href="NMClient.html#nm-client-get-main-context" title="nm_client_get_main_context ()"><code class="function">nm_client_get_main_context()</code></a> and <em class="parameter"><code>integrate_maincontext</code></em> - -is <code class="literal">FALSE</code>, the caller must make sure that both contexts are iterated -until completion. Otherwise, if <em class="parameter"><code>integrate_maincontext</code></em> - is <code class="literal">TRUE</code>, then -<a class="link" href="NMClient.html#nm-client-get-main-context" title="nm_client_get_main_context ()"><code class="function">nm_client_get_main_context()</code></a> will be integrated in <code class="function">g_main_context_get_thread_default()</code>. -This means, the caller gives <a class="link" href="NMClient.html#nm-client-get-main-context" title="nm_client_get_main_context ()"><code class="function">nm_client_get_main_context()</code></a> up until the waiting -completes, the function will acquire the context and hook it into -<code class="function">g_main_context_get_thread_default()</code>. -It is a bug to request <em class="parameter"><code>integrate_maincontext</code></em> - while having <a class="link" href="NMClient.html#nm-client-get-main-context" title="nm_client_get_main_context ()"><code class="function">nm_client_get_main_context()</code></a> -acquired or iterated otherwise because a context can only be acquired once -at a time.</p> -<p>Shutdown can only complete after all references to <em class="parameter"><code>client</code></em> - were released.</p> -<p>It is possible to call this function multiple times for the same client. -But note that with <em class="parameter"><code>integrate_maincontext</code></em> - the client's context is acquired, -which can only be done once at a time.</p> -<p>It is permissible to start waiting before the objects is fully initialized.</p> -<p>The function really allows two separate things. To get a notification (callback) when -shutdown is complete, and to integrate the client's context in another context. -The latter case is useful if the client has a separate context and you hand it -over to another GMainContext to wrap up.</p> -<p>The main use is to have a NMClient and a separate GMainContext on a worker -thread. When being done, you can hand over the cleanup of the context -to <code class="function">g_main_context_default()</code>, assuming that the main thread iterates -the default context. In that case, you don't need to care about passing -a callback to know when shutdown completed.</p> -<div class="refsect3"> -<a name="nm-client-wait-shutdown.parameters"></a><h4>Parameters</h4> -<div class="informaltable"><table class="informaltable" width="100%" border="0"> -<colgroup> -<col width="150px" class="parameters_name"> -<col class="parameters_description"> -<col width="200px" class="parameters_annotations"> -</colgroup> -<tbody> -<tr> -<td class="parameter_name"><p>client</p></td> -<td class="parameter_description"><p>the <a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a> to shutdown.</p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>integrate_maincontext</p></td> -<td class="parameter_description"><p>whether to hook the client's maincontext -in the current thread default. Otherwise, you must ensure -that the client's maincontext gets iterated so that it can complete. -By integrating the maincontext in the current thread default, you -may instead only iterate the latter.</p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>cancellable</p></td> -<td class="parameter_description"><p>the <span class="type">GCancellable</span> to abort the shutdown.</p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>callback</p></td> -<td class="parameter_description"><p>a <span class="type">GAsyncReadyCallback</span> to call when the request -is satisfied or <code class="literal">NULL</code> if you don't care about the result of the -method invocation.</p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>user_data</p></td> -<td class="parameter_description"><p>the data to pass to <em class="parameter"><code>callback</code></em> -</p></td> -<td class="parameter_annotations"> </td> -</tr> -</tbody> -</table></div> -</div> -<p class="since">Since: 1.42</p> -</div> -<hr> -<div class="refsect2"> -<a name="nm-client-wait-shutdown-finish"></a><h3>nm_client_wait_shutdown_finish ()</h3> -<pre class="programlisting"><span class="returnvalue">gboolean</span> -nm_client_wait_shutdown_finish (<em class="parameter"><code><span class="type">GAsyncResult</span> *result</code></em>, - <em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre> -<div class="refsect3"> -<a name="nm-client-wait-shutdown-finish.parameters"></a><h4>Parameters</h4> -<div class="informaltable"><table class="informaltable" width="100%" border="0"> -<colgroup> -<col width="150px" class="parameters_name"> -<col class="parameters_description"> -<col width="200px" class="parameters_annotations"> -</colgroup> -<tbody> -<tr> -<td class="parameter_name"><p>result</p></td> -<td class="parameter_description"><p>a <span class="type">GAsyncResult</span> obtained from the <span class="type">GAsyncReadyCallback</span> passed to <a class="link" href="NMClient.html#nm-client-wait-shutdown" title="nm_client_wait_shutdown ()"><code class="function">nm_client_wait_shutdown()</code></a></p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>error</p></td> -<td class="parameter_description"><p>return location for error or <code class="literal">NULL</code></p></td> -<td class="parameter_annotations"> </td> -</tr> -</tbody> -</table></div> -</div> -<div class="refsect3"> -<a name="nm-client-wait-shutdown-finish.returns"></a><h4>Returns</h4> -<p> <code class="literal">TRUE</code> if waiting is complete successfully. In that case, all resources of the -nmclient are wrapped up and released. This can only fail by user cancellation.</p> -</div> -<p class="since">Since: 1.42</p> -</div> -</div> -<div class="refsect1"> -<a name="NMClient.other_details"></a><h2>Types and Values</h2> -<div class="refsect2"> -<a name="NMClientInstanceFlags"></a><h3>enum NMClientInstanceFlags</h3> -<div class="refsect3"> -<a name="NMClientInstanceFlags.members"></a><h4>Members</h4> -<div class="informaltable"><table class="informaltable" width="100%" border="0"> -<colgroup> -<col width="300px" class="enum_members_name"> -<col class="enum_members_description"> -<col width="200px" class="enum_members_annotations"> -</colgroup> -<tbody> -<tr> -<td class="enum_member_name"><p><a name="NM-CLIENT-INSTANCE-FLAGS-NONE:CAPS"></a>NM_CLIENT_INSTANCE_FLAGS_NONE</p></td> -<td class="enum_member_description"> -<p>special value to indicate no flags.</p> -</td> -<td class="enum_member_annotations"> </td> -</tr> -<tr> -<td class="enum_member_name"><p><a name="NM-CLIENT-INSTANCE-FLAGS-NO-AUTO-FETCH-PERMISSIONS:CAPS"></a>NM_CLIENT_INSTANCE_FLAGS_NO_AUTO_FETCH_PERMISSIONS</p></td> -<td class="enum_member_description"> -<p>by default, NMClient -will fetch the permissions via "GetPermissions" and refetch them when -"CheckPermissions" signal gets received. By setting this flag, this behavior -can be disabled. You can toggle this flag to enable and disable automatic -fetching of the permissions. Watch also <a class="link" href="NMClient.html#nm-client-get-permissions-state" title="nm_client_get_permissions_state ()"><code class="function">nm_client_get_permissions_state()</code></a> -to know whether the permissions are up to date.</p> -</td> -<td class="enum_member_annotations"> </td> -</tr> -<tr> -<td class="enum_member_name"><p><a name="NM-CLIENT-INSTANCE-FLAGS-INITIALIZED-GOOD:CAPS"></a>NM_CLIENT_INSTANCE_FLAGS_INITIALIZED_GOOD</p></td> -<td class="enum_member_description"> -<p>as <a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a> is an GInitable -and GAsyncInitable, <a class="link" href="NMClient.html#nm-client-get-instance-flags" title="nm_client_get_instance_flags ()"><code class="function">nm_client_get_instance_flags()</code></a> returns this flag -once initialization completed with success. This flag cannot be set -as NM_CLIENT_INSTANCE_FLAGS property. Since: 1.42.</p> -</td> -<td class="enum_member_annotations"> </td> -</tr> -<tr> -<td class="enum_member_name"><p><a name="NM-CLIENT-INSTANCE-FLAGS-INITIALIZED-BAD:CAPS"></a>NM_CLIENT_INSTANCE_FLAGS_INITIALIZED_BAD</p></td> -<td class="enum_member_description"> -<p>like <em class="parameter"><code>NM_CLIENT_INSTANCE_FLAGS_INITIALIZED_GOOD</code></em> - -indicates that the instance completed initialization with failure. In that -case the instance is unusable. Since: 1.42.</p> -</td> -<td class="enum_member_annotations"> </td> -</tr> -</tbody> -</table></div> -</div> -<p class="since">Since: 1.24</p> -</div> -<hr> -<div class="refsect2"> -<a name="NM-CLIENT-VERSION:CAPS"></a><h3>NM_CLIENT_VERSION</h3> -<pre class="programlisting">#define NM_CLIENT_VERSION "version" -</pre> -</div> -<hr> -<div class="refsect2"> -<a name="NM-CLIENT-VERSION-INFO:CAPS"></a><h3>NM_CLIENT_VERSION_INFO</h3> -<pre class="programlisting">#define NM_CLIENT_VERSION_INFO "version-info" -</pre> -</div> -<hr> -<div class="refsect2"> -<a name="NM-CLIENT-STATE:CAPS"></a><h3>NM_CLIENT_STATE</h3> -<pre class="programlisting">#define NM_CLIENT_STATE "state" -</pre> -</div> -<hr> -<div class="refsect2"> -<a name="NM-CLIENT-STARTUP:CAPS"></a><h3>NM_CLIENT_STARTUP</h3> -<pre class="programlisting">#define NM_CLIENT_STARTUP "startup" -</pre> -</div> -<hr> -<div class="refsect2"> -<a name="NM-CLIENT-NM-RUNNING:CAPS"></a><h3>NM_CLIENT_NM_RUNNING</h3> -<pre class="programlisting">#define NM_CLIENT_NM_RUNNING "nm-running" -</pre> -</div> -<hr> -<div class="refsect2"> -<a name="NM-CLIENT-DBUS-CONNECTION:CAPS"></a><h3>NM_CLIENT_DBUS_CONNECTION</h3> -<pre class="programlisting">#define NM_CLIENT_DBUS_CONNECTION "dbus-connection" -</pre> -</div> -<hr> -<div class="refsect2"> -<a name="NM-CLIENT-DBUS-NAME-OWNER:CAPS"></a><h3>NM_CLIENT_DBUS_NAME_OWNER</h3> -<pre class="programlisting">#define NM_CLIENT_DBUS_NAME_OWNER "dbus-name-owner" -</pre> -</div> -<hr> -<div class="refsect2"> -<a name="NM-CLIENT-INSTANCE-FLAGS:CAPS"></a><h3>NM_CLIENT_INSTANCE_FLAGS</h3> -<pre class="programlisting">#define NM_CLIENT_INSTANCE_FLAGS "instance-flags" -</pre> -</div> -<hr> -<div class="refsect2"> -<a name="NM-CLIENT-NETWORKING-ENABLED:CAPS"></a><h3>NM_CLIENT_NETWORKING_ENABLED</h3> -<pre class="programlisting">#define NM_CLIENT_NETWORKING_ENABLED "networking-enabled" -</pre> -<div class="warning"><p><code class="literal">NM_CLIENT_NETWORKING_ENABLED</code> is deprecated and should not be used in newly-written code.</p></div> -</div> -<hr> -<div class="refsect2"> -<a name="NM-CLIENT-WIRELESS-ENABLED:CAPS"></a><h3>NM_CLIENT_WIRELESS_ENABLED</h3> -<pre class="programlisting">#define NM_CLIENT_WIRELESS_ENABLED "wireless-enabled" -</pre> -<div class="warning"><p><code class="literal">NM_CLIENT_WIRELESS_ENABLED</code> is deprecated and should not be used in newly-written code.</p></div> -</div> -<hr> -<div class="refsect2"> -<a name="NM-CLIENT-WWAN-ENABLED:CAPS"></a><h3>NM_CLIENT_WWAN_ENABLED</h3> -<pre class="programlisting">#define NM_CLIENT_WWAN_ENABLED "wwan-enabled" -</pre> -<div class="warning"><p><code class="literal">NM_CLIENT_WWAN_ENABLED</code> is deprecated and should not be used in newly-written code.</p></div> -</div> -<hr> -<div class="refsect2"> -<a name="NM-CLIENT-WIMAX-ENABLED:CAPS"></a><h3>NM_CLIENT_WIMAX_ENABLED</h3> -<pre class="programlisting">#define NM_CLIENT_WIMAX_ENABLED "wimax-enabled" -</pre> -<div class="warning"><p><code class="literal">NM_CLIENT_WIMAX_ENABLED</code> is deprecated and should not be used in newly-written code.</p></div> -</div> -<hr> -<div class="refsect2"> -<a name="NM-CLIENT-WIRELESS-HARDWARE-ENABLED:CAPS"></a><h3>NM_CLIENT_WIRELESS_HARDWARE_ENABLED</h3> -<pre class="programlisting">#define NM_CLIENT_WIRELESS_HARDWARE_ENABLED "wireless-hardware-enabled" -</pre> -</div> -<hr> -<div class="refsect2"> -<a name="NM-CLIENT-WWAN-HARDWARE-ENABLED:CAPS"></a><h3>NM_CLIENT_WWAN_HARDWARE_ENABLED</h3> -<pre class="programlisting">#define NM_CLIENT_WWAN_HARDWARE_ENABLED "wwan-hardware-enabled" -</pre> -</div> -<hr> -<div class="refsect2"> -<a name="NM-CLIENT-WIMAX-HARDWARE-ENABLED:CAPS"></a><h3>NM_CLIENT_WIMAX_HARDWARE_ENABLED</h3> -<pre class="programlisting">#define NM_CLIENT_WIMAX_HARDWARE_ENABLED "wimax-hardware-enabled" -</pre> -</div> -<hr> -<div class="refsect2"> -<a name="NM-CLIENT-RADIO-FLAGS:CAPS"></a><h3>NM_CLIENT_RADIO_FLAGS</h3> -<pre class="programlisting">#define NM_CLIENT_RADIO_FLAGS "radio-flags" -</pre> -</div> -<hr> -<div class="refsect2"> -<a name="NM-CLIENT-ACTIVE-CONNECTIONS:CAPS"></a><h3>NM_CLIENT_ACTIVE_CONNECTIONS</h3> -<pre class="programlisting">#define NM_CLIENT_ACTIVE_CONNECTIONS "active-connections" -</pre> -</div> -<hr> -<div class="refsect2"> -<a name="NM-CLIENT-CONNECTIVITY:CAPS"></a><h3>NM_CLIENT_CONNECTIVITY</h3> -<pre class="programlisting">#define NM_CLIENT_CONNECTIVITY "connectivity" -</pre> -</div> -<hr> -<div class="refsect2"> -<a name="NM-CLIENT-CONNECTIVITY-CHECK-URI:CAPS"></a><h3>NM_CLIENT_CONNECTIVITY_CHECK_URI</h3> -<pre class="programlisting">#define NM_CLIENT_CONNECTIVITY_CHECK_URI "connectivity-check-uri" -</pre> -</div> -<hr> -<div class="refsect2"> -<a name="NM-CLIENT-CONNECTIVITY-CHECK-AVAILABLE:CAPS"></a><h3>NM_CLIENT_CONNECTIVITY_CHECK_AVAILABLE</h3> -<pre class="programlisting">#define NM_CLIENT_CONNECTIVITY_CHECK_AVAILABLE "connectivity-check-available" -</pre> -</div> -<hr> -<div class="refsect2"> -<a name="NM-CLIENT-CONNECTIVITY-CHECK-ENABLED:CAPS"></a><h3>NM_CLIENT_CONNECTIVITY_CHECK_ENABLED</h3> -<pre class="programlisting">#define NM_CLIENT_CONNECTIVITY_CHECK_ENABLED "connectivity-check-enabled" -</pre> -<div class="warning"><p><code class="literal">NM_CLIENT_CONNECTIVITY_CHECK_ENABLED</code> is deprecated and should not be used in newly-written code.</p></div> -</div> -<hr> -<div class="refsect2"> -<a name="NM-CLIENT-PRIMARY-CONNECTION:CAPS"></a><h3>NM_CLIENT_PRIMARY_CONNECTION</h3> -<pre class="programlisting">#define NM_CLIENT_PRIMARY_CONNECTION "primary-connection" -</pre> -</div> -<hr> -<div class="refsect2"> -<a name="NM-CLIENT-ACTIVATING-CONNECTION:CAPS"></a><h3>NM_CLIENT_ACTIVATING_CONNECTION</h3> -<pre class="programlisting">#define NM_CLIENT_ACTIVATING_CONNECTION "activating-connection" -</pre> -</div> -<hr> -<div class="refsect2"> -<a name="NM-CLIENT-DEVICES:CAPS"></a><h3>NM_CLIENT_DEVICES</h3> -<pre class="programlisting">#define NM_CLIENT_DEVICES "devices" -</pre> -</div> -<hr> -<div class="refsect2"> -<a name="NM-CLIENT-ALL-DEVICES:CAPS"></a><h3>NM_CLIENT_ALL_DEVICES</h3> -<pre class="programlisting">#define NM_CLIENT_ALL_DEVICES "all-devices" -</pre> -</div> -<hr> -<div class="refsect2"> -<a name="NM-CLIENT-CONNECTIONS:CAPS"></a><h3>NM_CLIENT_CONNECTIONS</h3> -<pre class="programlisting">#define NM_CLIENT_CONNECTIONS "connections" -</pre> -</div> -<hr> -<div class="refsect2"> -<a name="NM-CLIENT-HOSTNAME:CAPS"></a><h3>NM_CLIENT_HOSTNAME</h3> -<pre class="programlisting">#define NM_CLIENT_HOSTNAME "hostname" -</pre> -</div> -<hr> -<div class="refsect2"> -<a name="NM-CLIENT-CAN-MODIFY:CAPS"></a><h3>NM_CLIENT_CAN_MODIFY</h3> -<pre class="programlisting">#define NM_CLIENT_CAN_MODIFY "can-modify" -</pre> -</div> -<hr> -<div class="refsect2"> -<a name="NM-CLIENT-METERED:CAPS"></a><h3>NM_CLIENT_METERED</h3> -<pre class="programlisting">#define NM_CLIENT_METERED "metered" -</pre> -</div> -<hr> -<div class="refsect2"> -<a name="NM-CLIENT-DNS-MODE:CAPS"></a><h3>NM_CLIENT_DNS_MODE</h3> -<pre class="programlisting">#define NM_CLIENT_DNS_MODE "dns-mode" -</pre> -</div> -<hr> -<div class="refsect2"> -<a name="NM-CLIENT-DNS-RC-MANAGER:CAPS"></a><h3>NM_CLIENT_DNS_RC_MANAGER</h3> -<pre class="programlisting">#define NM_CLIENT_DNS_RC_MANAGER "dns-rc-manager" -</pre> -</div> -<hr> -<div class="refsect2"> -<a name="NM-CLIENT-DNS-CONFIGURATION:CAPS"></a><h3>NM_CLIENT_DNS_CONFIGURATION</h3> -<pre class="programlisting">#define NM_CLIENT_DNS_CONFIGURATION "dns-configuration" -</pre> -</div> -<hr> -<div class="refsect2"> -<a name="NM-CLIENT-CHECKPOINTS:CAPS"></a><h3>NM_CLIENT_CHECKPOINTS</h3> -<pre class="programlisting">#define NM_CLIENT_CHECKPOINTS "checkpoints" -</pre> -</div> -<hr> -<div class="refsect2"> -<a name="NM-CLIENT-CAPABILITIES:CAPS"></a><h3>NM_CLIENT_CAPABILITIES</h3> -<pre class="programlisting">#define NM_CLIENT_CAPABILITIES "capabilities" -</pre> -</div> -<hr> -<div class="refsect2"> -<a name="NM-CLIENT-PERMISSIONS-STATE:CAPS"></a><h3>NM_CLIENT_PERMISSIONS_STATE</h3> -<pre class="programlisting">#define NM_CLIENT_PERMISSIONS_STATE "permissions-state" -</pre> -</div> -<hr> -<div class="refsect2"> -<a name="NM-CLIENT-DEVICE-ADDED:CAPS"></a><h3>NM_CLIENT_DEVICE_ADDED</h3> -<pre class="programlisting">#define NM_CLIENT_DEVICE_ADDED "device-added" -</pre> -</div> -<hr> -<div class="refsect2"> -<a name="NM-CLIENT-DEVICE-REMOVED:CAPS"></a><h3>NM_CLIENT_DEVICE_REMOVED</h3> -<pre class="programlisting">#define NM_CLIENT_DEVICE_REMOVED "device-removed" -</pre> -</div> -<hr> -<div class="refsect2"> -<a name="NM-CLIENT-ANY-DEVICE-ADDED:CAPS"></a><h3>NM_CLIENT_ANY_DEVICE_ADDED</h3> -<pre class="programlisting">#define NM_CLIENT_ANY_DEVICE_ADDED "any-device-added" -</pre> -</div> -<hr> -<div class="refsect2"> -<a name="NM-CLIENT-ANY-DEVICE-REMOVED:CAPS"></a><h3>NM_CLIENT_ANY_DEVICE_REMOVED</h3> -<pre class="programlisting">#define NM_CLIENT_ANY_DEVICE_REMOVED "any-device-removed" -</pre> -</div> -<hr> -<div class="refsect2"> -<a name="NM-CLIENT-PERMISSION-CHANGED:CAPS"></a><h3>NM_CLIENT_PERMISSION_CHANGED</h3> -<pre class="programlisting">#define NM_CLIENT_PERMISSION_CHANGED "permission-changed" -</pre> -</div> -<hr> -<div class="refsect2"> -<a name="NM-CLIENT-CONNECTION-ADDED:CAPS"></a><h3>NM_CLIENT_CONNECTION_ADDED</h3> -<pre class="programlisting">#define NM_CLIENT_CONNECTION_ADDED "connection-added" -</pre> -</div> -<hr> -<div class="refsect2"> -<a name="NM-CLIENT-CONNECTION-REMOVED:CAPS"></a><h3>NM_CLIENT_CONNECTION_REMOVED</h3> -<pre class="programlisting">#define NM_CLIENT_CONNECTION_REMOVED "connection-removed" -</pre> -</div> -<hr> -<div class="refsect2"> -<a name="NM-CLIENT-ACTIVE-CONNECTION-ADDED:CAPS"></a><h3>NM_CLIENT_ACTIVE_CONNECTION_ADDED</h3> -<pre class="programlisting">#define NM_CLIENT_ACTIVE_CONNECTION_ADDED "active-connection-added" -</pre> -</div> -<hr> -<div class="refsect2"> -<a name="NM-CLIENT-ACTIVE-CONNECTION-REMOVED:CAPS"></a><h3>NM_CLIENT_ACTIVE_CONNECTION_REMOVED</h3> -<pre class="programlisting">#define NM_CLIENT_ACTIVE_CONNECTION_REMOVED "active-connection-removed" -</pre> -</div> -<hr> -<div class="refsect2"> -<a name="NMClientError"></a><h3>enum NMClientError</h3> -<p>Describes errors that may result from operations involving a <a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a>.</p> -<p>D-Bus operations may also return errors from other domains, including -<a class="link" href="libnm-nm-errors.html#NMManagerError" title="enum NMManagerError"><span class="type">NMManagerError</span></a>, <a class="link" href="libnm-nm-errors.html#NMSettingsError" title="enum NMSettingsError"><span class="type">NMSettingsError</span></a>, <a class="link" href="libnm-nm-errors.html#NMAgentManagerError" title="enum NMAgentManagerError"><span class="type">NMAgentManagerError</span></a>, and <a class="link" href="libnm-nm-errors.html#NMConnectionError" title="enum NMConnectionError"><span class="type">NMConnectionError</span></a>.</p> -<div class="refsect3"> -<a name="NMClientError.members"></a><h4>Members</h4> -<div class="informaltable"><table class="informaltable" width="100%" border="0"> -<colgroup> -<col width="300px" class="enum_members_name"> -<col class="enum_members_description"> -<col width="200px" class="enum_members_annotations"> -</colgroup> -<tbody> -<tr> -<td class="enum_member_name"><p><a name="NM-CLIENT-ERROR-FAILED:CAPS"></a>NM_CLIENT_ERROR_FAILED</p></td> -<td class="enum_member_description"> -<p>unknown or unclassified error</p> -</td> -<td class="enum_member_annotations"> </td> -</tr> -<tr> -<td class="enum_member_name"><p><a name="NM-CLIENT-ERROR-MANAGER-NOT-RUNNING:CAPS"></a>NM_CLIENT_ERROR_MANAGER_NOT_RUNNING</p></td> -<td class="enum_member_description"> -<p>an operation that requires NetworkManager -failed because NetworkManager is not running</p> -</td> -<td class="enum_member_annotations"> </td> -</tr> -<tr> -<td class="enum_member_name"><p><a name="NM-CLIENT-ERROR-OBJECT-CREATION-FAILED:CAPS"></a>NM_CLIENT_ERROR_OBJECT_CREATION_FAILED</p></td> -<td class="enum_member_description"> -<p>NetworkManager claimed that an -operation succeeded, but the object that was allegedly created (eg, -<a class="link" href="NMRemoteConnection.html" title="NMRemoteConnection"><span class="type">NMRemoteConnection</span></a>, <a class="link" href="NMActiveConnection.html" title="NMActiveConnection"><span class="type">NMActiveConnection</span></a>) was apparently destroyed before -<a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a> could create a representation of it.</p> -</td> -<td class="enum_member_annotations"> </td> -</tr> -</tbody> -</table></div> -</div> -</div> -<hr> -<div class="refsect2"> -<a name="NM-CLIENT-ERROR:CAPS"></a><h3>NM_CLIENT_ERROR</h3> -<pre class="programlisting">#define NM_CLIENT_ERROR nm_client_error_quark() -</pre> -</div> -<hr> -<div class="refsect2"> -<a name="NMClient-struct"></a><h3>NMClient</h3> -<pre class="programlisting">typedef struct _NMClient NMClient;</pre> -<p>NMClient contains a cache of the objects of NetworkManager's D-Bus API. -It uses <span class="type">GMainContext</span> and <span class="type">GDBusConnection</span> for that and registers to -D-Bus signals. That means, when iterating the associated <span class="type">GMainContext</span>, -D-Bus signals gets processed and the <a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a> instance updates and -emits <span class="type">GObject</span> signals.</p> -</div> -<hr> -<div class="refsect2"> -<a name="NMDnsEntry-struct"></a><h3>NMDnsEntry</h3> -<pre class="programlisting">typedef struct _NMDnsEntry NMDnsEntry;</pre> -<p class="since">Since: 1.6</p> -</div> -</div> -<div class="refsect1"> -<a name="NMClient.property-details"></a><h2>Property Details</h2> -<div class="refsect2"> -<a name="NMClient--activating-connection"></a><h3>The <code class="literal">“activating-connection”</code> property</h3> -<pre class="programlisting"> “activating-connection” <a class="link" href="NMActiveConnection.html" title="NMActiveConnection"><span class="type">NMActiveConnection</span></a> *</pre> -<p>The <a class="link" href="NMActiveConnection.html" title="NMActiveConnection"><span class="type">NMActiveConnection</span></a> of the activating connection that is -likely to become the new <a class="link" href="NMClient.html#NMClient--primary-connection" title="The “primary-connection” property"><span class="type">“primary-connection”</span></a>.</p> -<p>Owner: NMClient</p> -<p>Flags: Read</p> -</div> -<hr> -<div class="refsect2"> -<a name="NMClient--active-connections"></a><h3>The <code class="literal">“active-connections”</code> property</h3> -<pre class="programlisting"> “active-connections” <span class="type">GPtrArray</span> *</pre> -<p>The active connections.</p> -<p><span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> GPtrArray(NMActiveConnection)]</span></p> -<p>Owner: NMClient</p> -<p>Flags: Read</p> -</div> -<hr> -<div class="refsect2"> -<a name="NMClient--all-devices"></a><h3>The <code class="literal">“all-devices”</code> property</h3> -<pre class="programlisting"> “all-devices” <span class="type">GPtrArray</span> *</pre> -<p>List of both real devices and device placeholders.</p> -<p><span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> GPtrArray(NMDevice)]</span></p> -<p>Owner: NMClient</p> -<p>Flags: Read</p> -<p class="since">Since: 1.2</p> -</div> -<hr> -<div class="refsect2"> -<a name="NMClient--can-modify"></a><h3>The <code class="literal">“can-modify”</code> property</h3> -<pre class="programlisting"> “can-modify” <span class="type">gboolean</span></pre> -<p>If <code class="literal">TRUE</code>, adding and modifying connections is supported.</p> -<p>Owner: NMClient</p> -<p>Flags: Read</p> -<p>Default value: FALSE</p> -</div> -<hr> -<div class="refsect2"> -<a name="NMClient--capabilities"></a><h3>The <code class="literal">“capabilities”</code> property</h3> -<pre class="programlisting"> “capabilities” <span class="type">GArray</span> *</pre> -<p>The list of capabilities numbers as guint32 or <code class="literal">NULL</code> if -there are no capabilities. The numeric value correspond -to <a class="link" href="libnm-nm-dbus-interface.html#NMCapability" title="enum NMCapability"><code class="literal">NMCapability</code></a> enum.</p> -<p><span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> GArray(guint32)]</span></p> -<p>Owner: NMClient</p> -<p>Flags: Read</p> -<p class="since">Since: 1.24</p> -</div> -<hr> -<div class="refsect2"> -<a name="NMClient--checkpoints"></a><h3>The <code class="literal">“checkpoints”</code> property</h3> -<pre class="programlisting"> “checkpoints” <span class="type">GPtrArray</span> *</pre> -<p>The list of active checkpoints.</p> -<p><span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> GPtrArray(NMCheckpoint)]</span></p> -<p>Owner: NMClient</p> -<p>Flags: Read</p> -<p class="since">Since: 1.12</p> -</div> -<hr> -<div class="refsect2"> -<a name="NMClient--connections"></a><h3>The <code class="literal">“connections”</code> property</h3> -<pre class="programlisting"> “connections” <span class="type">GPtrArray</span> *</pre> -<p>The list of configured connections that are available to the user. (Note -that this differs from the underlying D-Bus property, which may also -contain the object paths of connections that the user does not have -permission to read the details of.)</p> -<p><span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> GPtrArray(NMRemoteConnection)]</span></p> -<p>Owner: NMClient</p> -<p>Flags: Read</p> -</div> -<hr> -<div class="refsect2"> -<a name="NMClient--connectivity"></a><h3>The <code class="literal">“connectivity”</code> property</h3> -<pre class="programlisting"> “connectivity” <a class="link" href="libnm-nm-dbus-interface.html#NMConnectivityState" title="enum NMConnectivityState"><span class="type">NMConnectivityState</span></a></pre> -<p>The network connectivity state.</p> -<p>Owner: NMClient</p> -<p>Flags: Read</p> -<p>Default value: NM_CONNECTIVITY_UNKNOWN</p> -</div> -<hr> -<div class="refsect2"> -<a name="NMClient--connectivity-check-available"></a><h3>The <code class="literal">“connectivity-check-available”</code> property</h3> -<pre class="programlisting"> “connectivity-check-available” <span class="type">gboolean</span></pre> -<p>Owner: NMClient</p> -<p>Flags: Read</p> -<p>Default value: FALSE</p> -</div> -<hr> -<div class="refsect2"> -<a name="NMClient--connectivity-check-enabled"></a><h3>The <code class="literal">“connectivity-check-enabled”</code> property</h3> -<pre class="programlisting"> “connectivity-check-enabled” <span class="type">gboolean</span></pre> -<p>Owner: NMClient</p> -<p>Flags: Read / Write</p> -<p>Default value: FALSE</p> -</div> -<hr> -<div class="refsect2"> -<a name="NMClient--connectivity-check-uri"></a><h3>The <code class="literal">“connectivity-check-uri”</code> property</h3> -<pre class="programlisting"> “connectivity-check-uri” <span class="type">char</span> *</pre> -<p>The used URI for connectivity checking.</p> -<p>Owner: NMClient</p> -<p>Flags: Read</p> -<p>Default value: NULL</p> -<p class="since">Since: 1.22</p> -</div> -<hr> -<div class="refsect2"> -<a name="NMClient--dbus-connection"></a><h3>The <code class="literal">“dbus-connection”</code> property</h3> -<pre class="programlisting"> “dbus-connection” <span class="type">GDBusConnection</span> *</pre> -<p>The <span class="type">GDBusConnection</span> to use.</p> -<p>If this is not set during object construction, the D-Bus connection will -automatically be chosen during async/sync initalization via <code class="function">g_bus_get()</code>.</p> -<p>Owner: NMClient</p> -<p>Flags: Read / Write / Construct Only</p> -<p class="since">Since: 1.22</p> -</div> -<hr> -<div class="refsect2"> -<a name="NMClient--dbus-name-owner"></a><h3>The <code class="literal">“dbus-name-owner”</code> property</h3> -<pre class="programlisting"> “dbus-name-owner” <span class="type">char</span> *</pre> -<p>The name owner of the NetworkManager D-Bus service.</p> -<p>Owner: NMClient</p> -<p>Flags: Read</p> -<p>Default value: NULL</p> -<p class="since">Since: 1.22</p> -</div> -<hr> -<div class="refsect2"> -<a name="NMClient--devices"></a><h3>The <code class="literal">“devices”</code> property</h3> -<pre class="programlisting"> “devices” <span class="type">GPtrArray</span> *</pre> -<p>List of real network devices. Does not include placeholder devices.</p> -<p><span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> GPtrArray(NMDevice)]</span></p> -<p>Owner: NMClient</p> -<p>Flags: Read</p> -</div> -<hr> -<div class="refsect2"> -<a name="NMClient--dns-configuration"></a><h3>The <code class="literal">“dns-configuration”</code> property</h3> -<pre class="programlisting"> “dns-configuration” <span class="type">GPtrArray</span> *</pre> -<p>The current DNS configuration, represented as an array -of <a class="link" href="NMClient.html#NMDnsEntry"><span class="type">NMDnsEntry</span></a> objects.</p> -<p><span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> GPtrArray(NMDnsEntry)]</span></p> -<p>Owner: NMClient</p> -<p>Flags: Read</p> -<p class="since">Since: 1.6</p> -</div> -<hr> -<div class="refsect2"> -<a name="NMClient--dns-mode"></a><h3>The <code class="literal">“dns-mode”</code> property</h3> -<pre class="programlisting"> “dns-mode” <span class="type">char</span> *</pre> -<p>The current DNS processing mode.</p> -<p>Owner: NMClient</p> -<p>Flags: Read</p> -<p>Default value: NULL</p> -<p class="since">Since: 1.6</p> -</div> -<hr> -<div class="refsect2"> -<a name="NMClient--dns-rc-manager"></a><h3>The <code class="literal">“dns-rc-manager”</code> property</h3> -<pre class="programlisting"> “dns-rc-manager” <span class="type">char</span> *</pre> -<p>The current resolv.conf management mode.</p> -<p>Owner: NMClient</p> -<p>Flags: Read</p> -<p>Default value: NULL</p> -<p class="since">Since: 1.6</p> -</div> -<hr> -<div class="refsect2"> -<a name="NMClient--hostname"></a><h3>The <code class="literal">“hostname”</code> property</h3> -<pre class="programlisting"> “hostname” <span class="type">char</span> *</pre> -<p>The machine hostname stored in persistent configuration. This can be -modified by calling <a class="link" href="NMClient.html#nm-client-save-hostname" title="nm_client_save_hostname ()"><code class="function">nm_client_save_hostname()</code></a>.</p> -<p>Owner: NMClient</p> -<p>Flags: Read</p> -<p>Default value: NULL</p> -</div> -<hr> -<div class="refsect2"> -<a name="NMClient--instance-flags"></a><h3>The <code class="literal">“instance-flags”</code> property</h3> -<pre class="programlisting"> “instance-flags” <span class="type">guint</span></pre> -<p><a class="link" href="NMClient.html#NMClientInstanceFlags" title="enum NMClientInstanceFlags"><span class="type">NMClientInstanceFlags</span></a> for the instance. These affect behavior of <a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a>. -This is a construct property and you may only set most flags only during -construction.</p> -<p>The flag <a class="link" href="NMClient.html#NM-CLIENT-INSTANCE-FLAGS-NO-AUTO-FETCH-PERMISSIONS:CAPS"><code class="literal">NM_CLIENT_INSTANCE_FLAGS_NO_AUTO_FETCH_PERMISSIONS</code></a> can be toggled any time, -even after constructing the instance. Note that you may want to watch NMClient:permissions-state -property to know whether permissions are ready. Note that permissions are only fetched -when NMClient has a D-Bus name owner.</p> -<p>The flags <a class="link" href="NMClient.html#NM-CLIENT-INSTANCE-FLAGS-INITIALIZED-GOOD:CAPS"><code class="literal">NM_CLIENT_INSTANCE_FLAGS_INITIALIZED_GOOD</code></a> and <a class="link" href="NMClient.html#NM-CLIENT-INSTANCE-FLAGS-INITIALIZED-BAD:CAPS"><code class="literal">NM_CLIENT_INSTANCE_FLAGS_INITIALIZED_BAD</code></a> -cannot be set, however they will be returned by the getter after initialization completes.</p> -<p>Owner: NMClient</p> -<p>Flags: Read / Write / Construct</p> -<p>Default value: 0</p> -<p class="since">Since: 1.24</p> -</div> -<hr> -<div class="refsect2"> -<a name="NMClient--metered"></a><h3>The <code class="literal">“metered”</code> property</h3> -<pre class="programlisting"> “metered” <span class="type">guint</span></pre> -<p>Whether the connectivity is metered.</p> -<p>Owner: NMClient</p> -<p>Flags: Read</p> -<p>Default value: 0</p> -<p class="since">Since: 1.2</p> -</div> -<hr> -<div class="refsect2"> -<a name="NMClient--networking-enabled"></a><h3>The <code class="literal">“networking-enabled”</code> property</h3> -<pre class="programlisting"> “networking-enabled” <span class="type">gboolean</span></pre> -<p>Whether networking is enabled.</p> -<p>The property setter is a synchronous D-Bus call. This is deprecated since 1.22.</p> -<p>Owner: NMClient</p> -<p>Flags: Read / Write</p> -<p>Default value: FALSE</p> -</div> -<hr> -<div class="refsect2"> -<a name="NMClient--nm-running"></a><h3>The <code class="literal">“nm-running”</code> property</h3> -<pre class="programlisting"> “nm-running” <span class="type">gboolean</span></pre> -<p>Whether the daemon is running.</p> -<p>Owner: NMClient</p> -<p>Flags: Read</p> -<p>Default value: FALSE</p> -</div> -<hr> -<div class="refsect2"> -<a name="NMClient--permissions-state"></a><h3>The <code class="literal">“permissions-state”</code> property</h3> -<pre class="programlisting"> “permissions-state” <a class="link" href="libnm-nm-dbus-interface.html#NMTernary" title="enum NMTernary"><span class="type">NMTernary</span></a></pre> -<p>The state of the cached permissions. The value <a class="link" href="libnm-nm-dbus-interface.html#NM-TERNARY-DEFAULT:CAPS"><code class="literal">NM_TERNARY_DEFAULT</code></a> -means that no permissions are yet received (or not yet requested). -<a class="link" href="libnm-nm-dbus-interface.html#NM-TERNARY-TRUE:CAPS"><code class="literal">NM_TERNARY_TRUE</code></a> means that permissions are received, cached and up -to date. <a class="link" href="libnm-nm-dbus-interface.html#NM-TERNARY-FALSE:CAPS"><code class="literal">NM_TERNARY_FALSE</code></a> means that permissions were received and are -cached, but in the meantime a "CheckPermissions" signal was received -that invalidated the cached permissions. -Note that NMClient will always emit a notify::permissions-state signal -when a "CheckPermissions" signal got received or after new permissions -got received (that is regardless whether the value of the permission state -actually changed). With this you can watch the permissions-state property -to know whether the permissions are ready. Note that while NMClient has -no D-Bus name owner, no permissions are fetched (and this property won't -change).</p> -<p>Owner: NMClient</p> -<p>Flags: Read</p> -<p>Default value: NM_TERNARY_DEFAULT</p> -<p class="since">Since: 1.24</p> -</div> -<hr> -<div class="refsect2"> -<a name="NMClient--primary-connection"></a><h3>The <code class="literal">“primary-connection”</code> property</h3> -<pre class="programlisting"> “primary-connection” <a class="link" href="NMActiveConnection.html" title="NMActiveConnection"><span class="type">NMActiveConnection</span></a> *</pre> -<p>The <a class="link" href="NMActiveConnection.html" title="NMActiveConnection"><span class="type">NMActiveConnection</span></a> of the device with the default route; -see <a class="link" href="NMClient.html#nm-client-get-primary-connection" title="nm_client_get_primary_connection ()"><code class="function">nm_client_get_primary_connection()</code></a> for more details.</p> -<p>Owner: NMClient</p> -<p>Flags: Read</p> -</div> -<hr> -<div class="refsect2"> -<a name="NMClient--radio-flags"></a><h3>The <code class="literal">“radio-flags”</code> property</h3> -<pre class="programlisting"> “radio-flags” <span class="type">guint</span></pre> -<p>Flags for radio interfaces. See <a class="link" href="libnm-nm-dbus-interface.html#NMRadioFlags" title="enum NMRadioFlags"><span class="type">NMRadioFlags</span></a>.</p> -<p>Owner: NMClient</p> -<p>Flags: Read</p> -<p>Default value: 0</p> -<p class="since">Since: 1.38</p> -</div> -<hr> -<div class="refsect2"> -<a name="NMClient--startup"></a><h3>The <code class="literal">“startup”</code> property</h3> -<pre class="programlisting"> “startup” <span class="type">gboolean</span></pre> -<p>Whether the daemon is still starting up.</p> -<p>Owner: NMClient</p> -<p>Flags: Read</p> -<p>Default value: FALSE</p> -</div> -<hr> -<div class="refsect2"> -<a name="NMClient--state"></a><h3>The <code class="literal">“state”</code> property</h3> -<pre class="programlisting"> “state” <a class="link" href="libnm-nm-dbus-interface.html#NMState" title="enum NMState"><span class="type">NMState</span></a></pre> -<p>The current daemon state.</p> -<p>Owner: NMClient</p> -<p>Flags: Read</p> -<p>Default value: NM_STATE_UNKNOWN</p> -</div> -<hr> -<div class="refsect2"> -<a name="NMClient--version"></a><h3>The <code class="literal">“version”</code> property</h3> -<pre class="programlisting"> “version” <span class="type">char</span> *</pre> -<p>The NetworkManager version.</p> -<p>Owner: NMClient</p> -<p>Flags: Read</p> -<p>Default value: NULL</p> -</div> -<hr> -<div class="refsect2"> -<a name="NMClient--version-info"></a><h3>The <code class="literal">“version-info”</code> property</h3> -<pre class="programlisting"> “version-info” <span class="type">GArray</span> *</pre> -<p>Expose version info and capabilities of NetworkManager. If non-empty, -the first element is NM_VERSION, which encodes the version of the -daemon as "(major << 16 | minor << 8 | micro)". The following elements -is a bitfields of <code class="literal">NMVersionInfoCapabilities</code>. If a bit is set, then -the running NetworkManager has the respective capability.</p> -<p><span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> GArray(guint32)]</span></p> -<p>Owner: NMClient</p> -<p>Flags: Read</p> -<p class="since">Since: 1.42</p> -</div> -<hr> -<div class="refsect2"> -<a name="NMClient--wimax-enabled"></a><h3>The <code class="literal">“wimax-enabled”</code> property</h3> -<pre class="programlisting"> “wimax-enabled” <span class="type">gboolean</span></pre> -<p>Whether WiMAX functionality is enabled.</p> -<div class="warning"> -<p><code class="literal">NMClient:wimax-enabled</code> has been deprecated since version 1.22 and should not be used in newly-written code.</p> -<p>WiMAX is no longer supported and this always returns FALSE. The setter has no effect.</p> -</div> -<p>Owner: NMClient</p> -<p>Flags: Read / Write</p> -<p>Default value: FALSE</p> -</div> -<hr> -<div class="refsect2"> -<a name="NMClient--wimax-hardware-enabled"></a><h3>The <code class="literal">“wimax-hardware-enabled”</code> property</h3> -<pre class="programlisting"> “wimax-hardware-enabled” <span class="type">gboolean</span></pre> -<p>Whether the WiMAX hardware is enabled.</p> -<div class="warning"> -<p><code class="literal">NMClient:wimax-hardware-enabled</code> has been deprecated since version 1.22 and should not be used in newly-written code.</p> -<p>WiMAX is no longer supported and this always returns FALSE.</p> -</div> -<p>Owner: NMClient</p> -<p>Flags: Read</p> -<p>Default value: FALSE</p> -</div> -<hr> -<div class="refsect2"> -<a name="NMClient--wireless-enabled"></a><h3>The <code class="literal">“wireless-enabled”</code> property</h3> -<pre class="programlisting"> “wireless-enabled” <span class="type">gboolean</span></pre> -<p>Whether wireless is enabled.</p> -<p>The property setter is a synchronous D-Bus call. This is deprecated since 1.22.</p> -<p>Owner: NMClient</p> -<p>Flags: Read / Write</p> -<p>Default value: FALSE</p> -</div> -<hr> -<div class="refsect2"> -<a name="NMClient--wireless-hardware-enabled"></a><h3>The <code class="literal">“wireless-hardware-enabled”</code> property</h3> -<pre class="programlisting"> “wireless-hardware-enabled” <span class="type">gboolean</span></pre> -<p>Whether the wireless hardware is enabled.</p> -<p>Owner: NMClient</p> -<p>Flags: Read</p> -<p>Default value: FALSE</p> -</div> -<hr> -<div class="refsect2"> -<a name="NMClient--wwan-enabled"></a><h3>The <code class="literal">“wwan-enabled”</code> property</h3> -<pre class="programlisting"> “wwan-enabled” <span class="type">gboolean</span></pre> -<p>Whether WWAN functionality is enabled.</p> -<p>The property setter is a synchronous D-Bus call. This is deprecated since 1.22.</p> -<p>Owner: NMClient</p> -<p>Flags: Read / Write</p> -<p>Default value: FALSE</p> -</div> -<hr> -<div class="refsect2"> -<a name="NMClient--wwan-hardware-enabled"></a><h3>The <code class="literal">“wwan-hardware-enabled”</code> property</h3> -<pre class="programlisting"> “wwan-hardware-enabled” <span class="type">gboolean</span></pre> -<p>Whether the WWAN hardware is enabled.</p> -<p>Owner: NMClient</p> -<p>Flags: Read</p> -<p>Default value: FALSE</p> -</div> -</div> -<div class="refsect1"> -<a name="NMClient.signal-details"></a><h2>Signal Details</h2> -<div class="refsect2"> -<a name="NMClient-active-connection-added"></a><h3>The <code class="literal">“active-connection-added”</code> signal</h3> -<pre class="programlisting"><span class="returnvalue">void</span> -user_function (<a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a> *client, - <a class="link" href="NMActiveConnection.html" title="NMActiveConnection"><span class="type">NMActiveConnection</span></a> *active_connection, - <span class="type">gpointer</span> user_data)</pre> -<p>Notifies that a <a class="link" href="NMActiveConnection.html" title="NMActiveConnection"><span class="type">NMActiveConnection</span></a> has been added.</p> -<div class="refsect3"> -<a name="NMClient-active-connection-added.parameters"></a><h4>Parameters</h4> -<div class="informaltable"><table class="informaltable" width="100%" border="0"> -<colgroup> -<col width="150px" class="parameters_name"> -<col class="parameters_description"> -<col width="200px" class="parameters_annotations"> -</colgroup> -<tbody> -<tr> -<td class="parameter_name"><p>client</p></td> -<td class="parameter_description"><p>the client that received the signal</p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>active_connection</p></td> -<td class="parameter_description"><p>the new active connection</p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>user_data</p></td> -<td class="parameter_description"><p>user data set when the signal handler was connected.</p></td> -<td class="parameter_annotations"> </td> -</tr> -</tbody> -</table></div> -</div> -<p>Flags: Run First</p> -</div> -<hr> -<div class="refsect2"> -<a name="NMClient-active-connection-removed"></a><h3>The <code class="literal">“active-connection-removed”</code> signal</h3> -<pre class="programlisting"><span class="returnvalue">void</span> -user_function (<a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a> *client, - <a class="link" href="NMActiveConnection.html" title="NMActiveConnection"><span class="type">NMActiveConnection</span></a> *active_connection, - <span class="type">gpointer</span> user_data)</pre> -<p>Notifies that a <a class="link" href="NMActiveConnection.html" title="NMActiveConnection"><span class="type">NMActiveConnection</span></a> has been removed.</p> -<div class="refsect3"> -<a name="NMClient-active-connection-removed.parameters"></a><h4>Parameters</h4> -<div class="informaltable"><table class="informaltable" width="100%" border="0"> -<colgroup> -<col width="150px" class="parameters_name"> -<col class="parameters_description"> -<col width="200px" class="parameters_annotations"> -</colgroup> -<tbody> -<tr> -<td class="parameter_name"><p>client</p></td> -<td class="parameter_description"><p>the client that received the signal</p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>active_connection</p></td> -<td class="parameter_description"><p>the removed active connection</p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>user_data</p></td> -<td class="parameter_description"><p>user data set when the signal handler was connected.</p></td> -<td class="parameter_annotations"> </td> -</tr> -</tbody> -</table></div> -</div> -<p>Flags: Run First</p> -</div> -<hr> -<div class="refsect2"> -<a name="NMClient-any-device-added"></a><h3>The <code class="literal">“any-device-added”</code> signal</h3> -<pre class="programlisting"><span class="returnvalue">void</span> -user_function (<a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a> *client, - <span class="type">GObject</span> *device, - <span class="type">gpointer</span> user_data)</pre> -<p>Notifies that a <a class="link" href="NMDevice.html" title="NMDevice"><span class="type">NMDevice</span></a> is added. This signal is emitted for both -regular devices and placeholder devices.</p> -<div class="refsect3"> -<a name="NMClient-any-device-added.parameters"></a><h4>Parameters</h4> -<div class="informaltable"><table class="informaltable" width="100%" border="0"> -<colgroup> -<col width="150px" class="parameters_name"> -<col class="parameters_description"> -<col width="200px" class="parameters_annotations"> -</colgroup> -<tbody> -<tr> -<td class="parameter_name"><p>client</p></td> -<td class="parameter_description"><p>the client that received the signal</p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>device</p></td> -<td class="parameter_description"><p>the new device. </p></td> -<td class="parameter_annotations"><span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> NMDevice]</span></td> -</tr> -<tr> -<td class="parameter_name"><p>user_data</p></td> -<td class="parameter_description"><p>user data set when the signal handler was connected.</p></td> -<td class="parameter_annotations"> </td> -</tr> -</tbody> -</table></div> -</div> -<p>Flags: Run First</p> -</div> -<hr> -<div class="refsect2"> -<a name="NMClient-any-device-removed"></a><h3>The <code class="literal">“any-device-removed”</code> signal</h3> -<pre class="programlisting"><span class="returnvalue">void</span> -user_function (<a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a> *client, - <span class="type">GObject</span> *device, - <span class="type">gpointer</span> user_data)</pre> -<p>Notifies that a <a class="link" href="NMDevice.html" title="NMDevice"><span class="type">NMDevice</span></a> is removed. This signal is emitted for both -regular devices and placeholder devices.</p> -<div class="refsect3"> -<a name="NMClient-any-device-removed.parameters"></a><h4>Parameters</h4> -<div class="informaltable"><table class="informaltable" width="100%" border="0"> -<colgroup> -<col width="150px" class="parameters_name"> -<col class="parameters_description"> -<col width="200px" class="parameters_annotations"> -</colgroup> -<tbody> -<tr> -<td class="parameter_name"><p>client</p></td> -<td class="parameter_description"><p>the client that received the signal</p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>device</p></td> -<td class="parameter_description"><p>the removed device. </p></td> -<td class="parameter_annotations"><span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> NMDevice]</span></td> -</tr> -<tr> -<td class="parameter_name"><p>user_data</p></td> -<td class="parameter_description"><p>user data set when the signal handler was connected.</p></td> -<td class="parameter_annotations"> </td> -</tr> -</tbody> -</table></div> -</div> -<p>Flags: Run First</p> -</div> -<hr> -<div class="refsect2"> -<a name="NMClient-connection-added"></a><h3>The <code class="literal">“connection-added”</code> signal</h3> -<pre class="programlisting"><span class="returnvalue">void</span> -user_function (<a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a> *client, - <a class="link" href="NMRemoteConnection.html" title="NMRemoteConnection"><span class="type">NMRemoteConnection</span></a> *connection, - <span class="type">gpointer</span> user_data)</pre> -<p>Notifies that a <a class="link" href="NMConnection.html" title="NMConnection"><span class="type">NMConnection</span></a> has been added.</p> -<div class="refsect3"> -<a name="NMClient-connection-added.parameters"></a><h4>Parameters</h4> -<div class="informaltable"><table class="informaltable" width="100%" border="0"> -<colgroup> -<col width="150px" class="parameters_name"> -<col class="parameters_description"> -<col width="200px" class="parameters_annotations"> -</colgroup> -<tbody> -<tr> -<td class="parameter_name"><p>client</p></td> -<td class="parameter_description"><p>the client that received the signal</p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>connection</p></td> -<td class="parameter_description"><p>the new connection</p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>user_data</p></td> -<td class="parameter_description"><p>user data set when the signal handler was connected.</p></td> -<td class="parameter_annotations"> </td> -</tr> -</tbody> -</table></div> -</div> -<p>Flags: Run First</p> -</div> -<hr> -<div class="refsect2"> -<a name="NMClient-connection-removed"></a><h3>The <code class="literal">“connection-removed”</code> signal</h3> -<pre class="programlisting"><span class="returnvalue">void</span> -user_function (<a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a> *client, - <a class="link" href="NMRemoteConnection.html" title="NMRemoteConnection"><span class="type">NMRemoteConnection</span></a> *connection, - <span class="type">gpointer</span> user_data)</pre> -<p>Notifies that a <a class="link" href="NMConnection.html" title="NMConnection"><span class="type">NMConnection</span></a> has been removed.</p> -<div class="refsect3"> -<a name="NMClient-connection-removed.parameters"></a><h4>Parameters</h4> -<div class="informaltable"><table class="informaltable" width="100%" border="0"> -<colgroup> -<col width="150px" class="parameters_name"> -<col class="parameters_description"> -<col width="200px" class="parameters_annotations"> -</colgroup> -<tbody> -<tr> -<td class="parameter_name"><p>client</p></td> -<td class="parameter_description"><p>the client that received the signal</p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>connection</p></td> -<td class="parameter_description"><p>the removed connection</p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>user_data</p></td> -<td class="parameter_description"><p>user data set when the signal handler was connected.</p></td> -<td class="parameter_annotations"> </td> -</tr> -</tbody> -</table></div> -</div> -<p>Flags: Run First</p> -</div> -<hr> -<div class="refsect2"> -<a name="NMClient-device-added"></a><h3>The <code class="literal">“device-added”</code> signal</h3> -<pre class="programlisting"><span class="returnvalue">void</span> -user_function (<a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a> *client, - <span class="type">GObject</span> *device, - <span class="type">gpointer</span> user_data)</pre> -<p>Notifies that a <a class="link" href="NMDevice.html" title="NMDevice"><span class="type">NMDevice</span></a> is added. This signal is not emitted for -placeholder devices.</p> -<div class="refsect3"> -<a name="NMClient-device-added.parameters"></a><h4>Parameters</h4> -<div class="informaltable"><table class="informaltable" width="100%" border="0"> -<colgroup> -<col width="150px" class="parameters_name"> -<col class="parameters_description"> -<col width="200px" class="parameters_annotations"> -</colgroup> -<tbody> -<tr> -<td class="parameter_name"><p>client</p></td> -<td class="parameter_description"><p>the client that received the signal</p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>device</p></td> -<td class="parameter_description"><p>the new device. </p></td> -<td class="parameter_annotations"><span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> NMDevice]</span></td> -</tr> -<tr> -<td class="parameter_name"><p>user_data</p></td> -<td class="parameter_description"><p>user data set when the signal handler was connected.</p></td> -<td class="parameter_annotations"> </td> -</tr> -</tbody> -</table></div> -</div> -<p>Flags: Run First</p> -</div> -<hr> -<div class="refsect2"> -<a name="NMClient-device-removed"></a><h3>The <code class="literal">“device-removed”</code> signal</h3> -<pre class="programlisting"><span class="returnvalue">void</span> -user_function (<a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a> *client, - <span class="type">GObject</span> *device, - <span class="type">gpointer</span> user_data)</pre> -<p>Notifies that a <a class="link" href="NMDevice.html" title="NMDevice"><span class="type">NMDevice</span></a> is removed. This signal is not emitted for -placeholder devices.</p> -<div class="refsect3"> -<a name="NMClient-device-removed.parameters"></a><h4>Parameters</h4> -<div class="informaltable"><table class="informaltable" width="100%" border="0"> -<colgroup> -<col width="150px" class="parameters_name"> -<col class="parameters_description"> -<col width="200px" class="parameters_annotations"> -</colgroup> -<tbody> -<tr> -<td class="parameter_name"><p>client</p></td> -<td class="parameter_description"><p>the client that received the signal</p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>device</p></td> -<td class="parameter_description"><p>the removed device. </p></td> -<td class="parameter_annotations"><span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> NMDevice]</span></td> -</tr> -<tr> -<td class="parameter_name"><p>user_data</p></td> -<td class="parameter_description"><p>user data set when the signal handler was connected.</p></td> -<td class="parameter_annotations"> </td> -</tr> -</tbody> -</table></div> -</div> -<p>Flags: Run First</p> -</div> -<hr> -<div class="refsect2"> -<a name="NMClient-permission-changed"></a><h3>The <code class="literal">“permission-changed”</code> signal</h3> -<pre class="programlisting"><span class="returnvalue">void</span> -user_function (<a class="link" href="NMClient.html" title="NMClient"><span class="type">NMClient</span></a> *client, - <span class="type">guint</span> permission, - <span class="type">guint</span> result, - <span class="type">gpointer</span> user_data)</pre> -<p>Notifies that a permission has changed</p> -<div class="refsect3"> -<a name="NMClient-permission-changed.parameters"></a><h4>Parameters</h4> -<div class="informaltable"><table class="informaltable" width="100%" border="0"> -<colgroup> -<col width="150px" class="parameters_name"> -<col class="parameters_description"> -<col width="200px" class="parameters_annotations"> -</colgroup> -<tbody> -<tr> -<td class="parameter_name"><p>client</p></td> -<td class="parameter_description"><p>the client that received the signal</p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>permission</p></td> -<td class="parameter_description"><p>a permission from <a class="link" href="libnm-nm-dbus-interface.html#NMClientPermission" title="enum NMClientPermission"><span class="type">NMClientPermission</span></a></p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>result</p></td> -<td class="parameter_description"><p>the permission's result, one of <a class="link" href="libnm-nm-dbus-interface.html#NMClientPermissionResult" title="enum NMClientPermissionResult"><span class="type">NMClientPermissionResult</span></a></p></td> -<td class="parameter_annotations"> </td> -</tr> -<tr> -<td class="parameter_name"><p>user_data</p></td> -<td class="parameter_description"><p>user data set when the signal handler was connected.</p></td> -<td class="parameter_annotations"> </td> -</tr> -</tbody> -</table></div> -</div> -<p>Flags: Run First</p> -</div> -</div> -</div> -<div class="footer"> -<hr>Generated by GTK-Doc V1.34.0</div> -</body> -</html> \ No newline at end of file |