From f408e27bccfacf347605a8d98649975a68f38a17 Mon Sep 17 00:00:00 2001 From: Michael Biebl Date: Tue, 5 May 2015 17:48:57 +0200 Subject: Imported Upstream version 1.0.2 --- INSTALL | 4 +- Makefile.in | 81 +- NEWS | 47 +- aclocal.m4 | 192 +- build-aux/compile | 2 +- build-aux/config.guess | 15 +- build-aux/config.sub | 19 +- build-aux/depcomp | 2 +- build-aux/install-sh | 366 +- build-aux/missing | 6 +- callouts/Makefile.in | 30 +- callouts/nm-dispatcher-api.h | 1 + callouts/nm-dispatcher-utils.c | 6 + callouts/tests/Makefile.am | 9 +- callouts/tests/Makefile.in | 42 +- callouts/tests/dispatcher-down | 21 + callouts/tests/dispatcher-old-down | 20 - callouts/tests/dispatcher-old-up | 57 - callouts/tests/dispatcher-old-vpn-down | 56 - callouts/tests/dispatcher-old-vpn-up | 56 - callouts/tests/dispatcher-up | 58 + callouts/tests/dispatcher-vpn-down | 57 + callouts/tests/dispatcher-vpn-up | 57 + callouts/tests/test-dispatcher-envp.c | 65 +- clients/Makefile.in | 30 +- clients/cli/Makefile.in | 30 +- clients/cli/common.c | 3 + clients/cli/connections.c | 2 + clients/cli/devices.c | 115 +- clients/cli/nmcli-completion | 6 +- clients/cli/settings.c | 54 +- clients/tui/Makefile.in | 30 +- clients/tui/newt/Makefile.in | 30 +- clients/tui/nmt-connect-connection-list.c | 8 +- clients/tui/nmt-editor.c | 2 +- clients/tui/nmt-page-dsl.c | 2 + config.h.in | 3 - configure | 814 +- configure.ac | 20 +- data/Makefile.in | 24 +- docs/Makefile.in | 24 +- docs/api/Makefile.am | 1 + docs/api/Makefile.in | 85 +- docs/api/html/home.png | Bin 654 -> 256 bytes docs/api/html/index.html | 8 +- docs/api/html/ix01.html | 18 +- docs/api/html/left-insensitive.png | Bin 0 -> 395 bytes docs/api/html/left.png | Bin 459 -> 262 bytes docs/api/html/license.html | 18 +- docs/api/html/ref-dbus.html | 18 +- docs/api/html/ref-migrating.html | 18 +- docs/api/html/ref-settings.html | 46 +- docs/api/html/right-insensitive.png | Bin 0 -> 373 bytes docs/api/html/right.png | Bin 472 -> 261 bytes docs/api/html/secrets-flags.html | 18 +- docs/api/html/spec.html | 16 +- docs/api/html/style.css | 418 +- docs/api/html/up-insensitive.png | Bin 0 -> 374 bytes docs/api/html/up.png | Bin 406 -> 260 bytes docs/api/settings-spec.xml | 28 +- docs/api/spec.html | 16 +- docs/api/version.xml | 2 +- docs/libnm-glib/Makefile.in | 81 +- docs/libnm-glib/html/NMAccessPoint.html | 1152 +-- docs/libnm-glib/html/NMActiveConnection.html | 1474 ++-- docs/libnm-glib/html/NMClient.html | 3320 ++++---- docs/libnm-glib/html/NMDHCP4Config.html | 309 +- docs/libnm-glib/html/NMDHCP6Config.html | 309 +- docs/libnm-glib/html/NMDevice.html | 3094 ++++---- docs/libnm-glib/html/NMDeviceAdsl.html | 340 +- docs/libnm-glib/html/NMDeviceBond.html | 528 +- docs/libnm-glib/html/NMDeviceBridge.html | 534 +- docs/libnm-glib/html/NMDeviceBt.html | 539 +- docs/libnm-glib/html/NMDeviceEthernet.html | 618 +- docs/libnm-glib/html/NMDeviceGeneric.html | 387 +- docs/libnm-glib/html/NMDeviceInfiniband.html | 451 +- docs/libnm-glib/html/NMDeviceModem.html | 393 +- docs/libnm-glib/html/NMDeviceOlpcMesh.html | 510 +- docs/libnm-glib/html/NMDeviceTeam.html | 532 +- docs/libnm-glib/html/NMDeviceVlan.html | 614 +- docs/libnm-glib/html/NMDeviceWifi.html | 1117 +-- docs/libnm-glib/html/NMDeviceWimax.html | 1110 +-- docs/libnm-glib/html/NMIP4Config.html | 762 +- docs/libnm-glib/html/NMIP6Config.html | 784 +- docs/libnm-glib/html/NMObject.html | 444 +- docs/libnm-glib/html/NMRemoteConnection.html | 982 +-- docs/libnm-glib/html/NMRemoteSettings.html | 1456 ++-- docs/libnm-glib/html/NMSecretAgent.html | 1237 +-- docs/libnm-glib/html/NMVPNConnection.html | 396 +- docs/libnm-glib/html/NMWimaxNsp.html | 593 +- docs/libnm-glib/html/annotation-glossary.html | 49 +- docs/libnm-glib/html/api-index-full.html | 1165 ++- docs/libnm-glib/html/ch02.html | 20 +- docs/libnm-glib/html/home.png | Bin 654 -> 256 bytes docs/libnm-glib/html/index.html | 10 +- docs/libnm-glib/html/index.sgml | 857 +- docs/libnm-glib/html/left-insensitive.png | Bin 0 -> 395 bytes docs/libnm-glib/html/left.png | Bin 459 -> 262 bytes docs/libnm-glib/html/libnm-glib-NMVPNPlugin.html | 529 +- docs/libnm-glib/html/libnm-glib-NMVpnPluginUi.html | 397 - .../html/libnm-glib-NMVpnPluginUiWidget.html | 447 ++ docs/libnm-glib/html/libnm-glib-nm-types.html | 41 +- .../html/libnm-glib-nm-vpn-plugin-utils.html | 191 +- docs/libnm-glib/html/libnm-glib.devhelp2 | 1061 ++- docs/libnm-glib/html/object-tree.html | 76 +- docs/libnm-glib/html/ref-overview.html | 18 +- docs/libnm-glib/html/right-insensitive.png | Bin 0 -> 373 bytes docs/libnm-glib/html/right.png | Bin 472 -> 261 bytes docs/libnm-glib/html/style.css | 418 +- docs/libnm-glib/html/up-insensitive.png | Bin 0 -> 374 bytes docs/libnm-glib/html/up.png | Bin 406 -> 260 bytes docs/libnm-glib/libnm-glib-sections.txt | 117 +- docs/libnm-glib/tmpl/nm-access-point.sgml | 69 - docs/libnm-glib/tmpl/nm-active-connection.sgml | 94 - docs/libnm-glib/tmpl/nm-client.sgml | 127 - docs/libnm-glib/tmpl/nm-device-adsl.sgml | 24 - docs/libnm-glib/tmpl/nm-device-bond.sgml | 34 - docs/libnm-glib/tmpl/nm-device-bridge.sgml | 34 - docs/libnm-glib/tmpl/nm-device-bt.sgml | 34 - docs/libnm-glib/tmpl/nm-device-ethernet.sgml | 39 - docs/libnm-glib/tmpl/nm-device-generic.sgml | 29 - docs/libnm-glib/tmpl/nm-device-infiniband.sgml | 29 - docs/libnm-glib/tmpl/nm-device-modem.sgml | 29 - docs/libnm-glib/tmpl/nm-device-olpc-mesh.sgml | 34 - docs/libnm-glib/tmpl/nm-device-team.sgml | 34 - docs/libnm-glib/tmpl/nm-device-vlan.sgml | 39 - docs/libnm-glib/tmpl/nm-device-wifi.sgml | 72 - docs/libnm-glib/tmpl/nm-device-wimax.sgml | 71 - docs/libnm-glib/tmpl/nm-device.sgml | 146 - docs/libnm-glib/tmpl/nm-dhcp4-config.sgml | 24 - docs/libnm-glib/tmpl/nm-dhcp6-config.sgml | 24 - docs/libnm-glib/tmpl/nm-ip4-config.sgml | 54 - docs/libnm-glib/tmpl/nm-ip6-config.sgml | 49 - docs/libnm-glib/tmpl/nm-object.sgml | 39 - docs/libnm-glib/tmpl/nm-remote-connection.sgml | 63 - docs/libnm-glib/tmpl/nm-remote-settings.sgml | 56 - docs/libnm-glib/tmpl/nm-secret-agent.sgml | 52 - docs/libnm-glib/tmpl/nm-vpn-connection.sgml | 39 - .../tmpl/nm-vpn-plugin-ui-interface.sgml | 32 +- docs/libnm-glib/tmpl/nm-vpn-plugin.sgml | 28 - docs/libnm-glib/tmpl/nm-wimax-nsp.sgml | 34 - docs/libnm-glib/version.xml | 2 +- docs/libnm-util/Makefile.am | 4 +- docs/libnm-util/Makefile.in | 86 +- docs/libnm-util/html/NMConnection.html | 3672 +++++---- docs/libnm-util/html/NMSetting.html | 1918 ++--- docs/libnm-util/html/NMSetting8021x.html | 5471 +++++++------ docs/libnm-util/html/NMSettingAdsl.html | 825 +- docs/libnm-util/html/NMSettingBluetooth.html | 465 +- docs/libnm-util/html/NMSettingBond.html | 1116 +-- docs/libnm-util/html/NMSettingBridge.html | 903 ++- docs/libnm-util/html/NMSettingBridgePort.html | 509 +- docs/libnm-util/html/NMSettingCdma.html | 584 +- docs/libnm-util/html/NMSettingConnection.html | 2125 ++--- docs/libnm-util/html/NMSettingDcb.html | 1980 +++-- docs/libnm-util/html/NMSettingGeneric.html | 255 +- docs/libnm-util/html/NMSettingGsm.html | 1443 ++-- docs/libnm-util/html/NMSettingIP4Config.html | 3672 +++++---- docs/libnm-util/html/NMSettingIP6Config.html | 3636 +++++---- docs/libnm-util/html/NMSettingInfiniband.html | 679 +- docs/libnm-util/html/NMSettingOlpcMesh.html | 384 +- docs/libnm-util/html/NMSettingPPP.html | 1705 ++-- docs/libnm-util/html/NMSettingPPPOE.html | 584 +- docs/libnm-util/html/NMSettingSerial.html | 659 +- docs/libnm-util/html/NMSettingTeam.html | 426 +- docs/libnm-util/html/NMSettingTeamPort.html | 345 +- docs/libnm-util/html/NMSettingVPN.html | 1173 +-- docs/libnm-util/html/NMSettingVlan.html | 1344 ++-- docs/libnm-util/html/NMSettingWimax.html | 423 +- docs/libnm-util/html/NMSettingWired.html | 1801 +++-- docs/libnm-util/html/NMSettingWireless.html | 2014 +++-- .../libnm-util/html/NMSettingWirelessSecurity.html | 2559 +++--- docs/libnm-util/html/annotation-glossary.html | 51 +- docs/libnm-util/html/api-index-full.html | 1995 +++-- docs/libnm-util/html/ch01.html | 18 +- docs/libnm-util/html/home.png | Bin 654 -> 256 bytes docs/libnm-util/html/index.html | 8 +- docs/libnm-util/html/index.sgml | 1412 ++-- docs/libnm-util/html/left-insensitive.png | Bin 0 -> 395 bytes docs/libnm-util/html/left.png | Bin 459 -> 262 bytes .../libnm-util/html/libnm-util-NetworkManager.html | 1708 ++-- .../html/libnm-util-NetworkManagerVPN.html | 688 +- docs/libnm-util/html/libnm-util-nm-utils.html | 3269 ++++---- docs/libnm-util/html/libnm-util.devhelp2 | 2124 ++--- docs/libnm-util/html/object-tree.html | 172 +- docs/libnm-util/html/right-insensitive.png | Bin 0 -> 373 bytes docs/libnm-util/html/right.png | Bin 472 -> 261 bytes docs/libnm-util/html/style.css | 418 +- docs/libnm-util/html/up-insensitive.png | Bin 0 -> 374 bytes docs/libnm-util/html/up.png | Bin 406 -> 260 bytes docs/libnm-util/libnm-util-sections.txt | 114 +- docs/libnm-util/tmpl/NetworkManager.sgml | 4 + docs/libnm-util/tmpl/nm-connection.sgml | 8 - docs/libnm-util/tmpl/nm-setting-8021x.sgml | 177 - docs/libnm-util/tmpl/nm-setting-adsl.sgml | 52 - docs/libnm-util/tmpl/nm-setting-bluetooth.sgml | 27 - docs/libnm-util/tmpl/nm-setting-bond.sgml | 27 - docs/libnm-util/tmpl/nm-setting-bridge-port.sgml | 32 - docs/libnm-util/tmpl/nm-setting-bridge.sgml | 57 - docs/libnm-util/tmpl/nm-setting-cdma.sgml | 37 - docs/libnm-util/tmpl/nm-setting-connection.sgml | 11 - docs/libnm-util/tmpl/nm-setting-dcb.sgml | 92 - docs/libnm-util/tmpl/nm-setting-generic.sgml | 17 - docs/libnm-util/tmpl/nm-setting-gsm.sgml | 72 - docs/libnm-util/tmpl/nm-setting-infiniband.sgml | 42 - docs/libnm-util/tmpl/nm-setting-ip4-config.sgml | 94 - docs/libnm-util/tmpl/nm-setting-ip6-config.sgml | 89 - docs/libnm-util/tmpl/nm-setting-olpc-mesh.sgml | 32 - docs/libnm-util/tmpl/nm-setting-ppp.sgml | 107 - docs/libnm-util/tmpl/nm-setting-pppoe.sgml | 37 - docs/libnm-util/tmpl/nm-setting-serial.sgml | 42 - docs/libnm-util/tmpl/nm-setting-team-port.sgml | 22 - docs/libnm-util/tmpl/nm-setting-team.sgml | 27 - docs/libnm-util/tmpl/nm-setting-vlan.sgml | 47 - docs/libnm-util/tmpl/nm-setting-vpn.sgml | 42 - docs/libnm-util/tmpl/nm-setting-wimax.sgml | 23 - docs/libnm-util/tmpl/nm-setting-wired.sgml | 72 - .../tmpl/nm-setting-wireless-security.sgml | 102 - docs/libnm-util/tmpl/nm-setting-wireless.sgml | 87 - docs/libnm-util/tmpl/nm-setting.sgml | 16 - docs/libnm-util/version.xml | 2 +- docs/libnm/Makefile.in | 80 +- docs/libnm/html/NMAccessPoint.html | 1026 +-- docs/libnm/html/NMActiveConnection.html | 1412 ++-- docs/libnm/html/NMClient.html | 4945 ++++++------ docs/libnm/html/NMDevice.html | 3151 ++++---- docs/libnm/html/NMDeviceAdsl.html | 187 +- docs/libnm/html/NMDeviceBond.html | 367 +- docs/libnm/html/NMDeviceBridge.html | 367 +- docs/libnm/html/NMDeviceBt.html | 357 +- docs/libnm/html/NMDeviceEthernet.html | 443 +- docs/libnm/html/NMDeviceGeneric.html | 216 +- docs/libnm/html/NMDeviceInfiniband.html | 276 +- docs/libnm/html/NMDeviceModem.html | 293 +- docs/libnm/html/NMDeviceOlpcMesh.html | 361 +- docs/libnm/html/NMDeviceTeam.html | 367 +- docs/libnm/html/NMDeviceVlan.html | 434 +- docs/libnm/html/NMDeviceWifi.html | 1055 +-- docs/libnm/html/NMDeviceWimax.html | 948 +-- docs/libnm/html/NMDhcpConfig.html | 336 +- docs/libnm/html/NMIPConfig.html | 771 +- docs/libnm/html/NMObject.html | 246 +- docs/libnm/html/NMRemoteConnection.html | 1149 +-- docs/libnm/html/NMSecretAgentOld.html | 1227 +-- docs/libnm/html/NMSetting.html | 1426 ++-- docs/libnm/html/NMSetting8021x.html | 5358 +++++++------ docs/libnm/html/NMSettingAdsl.html | 722 +- docs/libnm/html/NMSettingBluetooth.html | 353 +- docs/libnm/html/NMSettingBond.html | 924 ++- docs/libnm/html/NMSettingBridge.html | 701 +- docs/libnm/html/NMSettingBridgePort.html | 396 +- docs/libnm/html/NMSettingCdma.html | 472 +- docs/libnm/html/NMSettingConnection.html | 2123 ++--- docs/libnm/html/NMSettingDcb.html | 1862 +++-- docs/libnm/html/NMSettingGeneric.html | 140 +- docs/libnm/html/NMSettingGsm.html | 872 ++- docs/libnm/html/NMSettingIP4Config.html | 312 +- docs/libnm/html/NMSettingIP6Config.html | 389 +- docs/libnm/html/NMSettingIPConfig.html | 4282 +++++----- docs/libnm/html/NMSettingInfiniband.html | 628 +- docs/libnm/html/NMSettingOlpcMesh.html | 299 +- docs/libnm/html/NMSettingPpp.html | 1607 ++-- docs/libnm/html/NMSettingPppoe.html | 472 +- docs/libnm/html/NMSettingSerial.html | 597 +- docs/libnm/html/NMSettingTeam.html | 234 +- docs/libnm/html/NMSettingTeamPort.html | 234 +- docs/libnm/html/NMSettingVlan.html | 1150 +-- docs/libnm/html/NMSettingVpn.html | 1082 +-- docs/libnm/html/NMSettingWimax.html | 320 +- docs/libnm/html/NMSettingWired.html | 1694 ++-- docs/libnm/html/NMSettingWireless.html | 1786 +++-- docs/libnm/html/NMSettingWirelessSecurity.html | 2401 +++--- docs/libnm/html/NMSimpleConnection.html | 231 +- docs/libnm/html/NMVpnConnection.html | 330 +- docs/libnm/html/NMVpnEditor.html | 591 ++ docs/libnm/html/NMWimaxNsp.html | 539 +- docs/libnm/html/annotation-glossary.html | 51 +- docs/libnm/html/api-index-full.html | 2785 +++---- docs/libnm/html/ch02.html | 18 +- docs/libnm/html/ch03.html | 18 +- docs/libnm/html/ch04.html | 18 +- docs/libnm/html/ch05.html | 18 +- docs/libnm/html/ch06.html | 20 +- docs/libnm/html/home.png | Bin 654 -> 256 bytes docs/libnm/html/index.html | 10 +- docs/libnm/html/index.sgml | 1957 ++--- docs/libnm/html/left-insensitive.png | Bin 0 -> 395 bytes docs/libnm/html/left.png | Bin 459 -> 262 bytes docs/libnm/html/libnm-NMConnection.html | 3157 ++++---- docs/libnm/html/libnm-NMVpnEditorPlugin.html | 382 - docs/libnm/html/libnm-nm-dbus-interface.html | 1947 +++-- docs/libnm/html/libnm-nm-errors.html | 1174 +-- docs/libnm/html/libnm-nm-utils.html | 3434 ++++---- docs/libnm/html/libnm-nm-version.html | 253 +- docs/libnm/html/libnm-nm-vpn-dbus-interface.html | 721 +- docs/libnm/html/libnm.devhelp2 | 2738 +++---- docs/libnm/html/object-tree.html | 231 +- docs/libnm/html/ref-overview.html | 18 +- docs/libnm/html/right-insensitive.png | Bin 0 -> 373 bytes docs/libnm/html/right.png | Bin 472 -> 261 bytes docs/libnm/html/style.css | 418 +- docs/libnm/html/up-insensitive.png | Bin 0 -> 374 bytes docs/libnm/html/up.png | Bin 406 -> 260 bytes docs/libnm/libnm-sections.txt | 215 +- docs/libnm/tmpl/nm-access-point.sgml | 63 - docs/libnm/tmpl/nm-active-connection.sgml | 88 - docs/libnm/tmpl/nm-client.sgml | 154 - docs/libnm/tmpl/nm-dbus-interface.sgml | 4 + docs/libnm/tmpl/nm-device-adsl.sgml | 18 - docs/libnm/tmpl/nm-device-bond.sgml | 28 - docs/libnm/tmpl/nm-device-bridge.sgml | 28 - docs/libnm/tmpl/nm-device-bt.sgml | 28 - docs/libnm/tmpl/nm-device-ethernet.sgml | 33 - docs/libnm/tmpl/nm-device-generic.sgml | 23 - docs/libnm/tmpl/nm-device-infiniband.sgml | 23 - docs/libnm/tmpl/nm-device-modem.sgml | 23 - docs/libnm/tmpl/nm-device-olpc-mesh.sgml | 28 - docs/libnm/tmpl/nm-device-team.sgml | 28 - docs/libnm/tmpl/nm-device-vlan.sgml | 33 - docs/libnm/tmpl/nm-device-wifi.sgml | 66 - docs/libnm/tmpl/nm-device-wimax.sgml | 71 - docs/libnm/tmpl/nm-device.sgml | 143 - docs/libnm/tmpl/nm-dhcp-config.sgml | 23 - docs/libnm/tmpl/nm-ip-config.sgml | 53 - docs/libnm/tmpl/nm-object.sgml | 30 - docs/libnm/tmpl/nm-remote-connection.sgml | 23 - docs/libnm/tmpl/nm-secret-agent-old.sgml | 37 - docs/libnm/tmpl/nm-setting-8021x.sgml | 173 - docs/libnm/tmpl/nm-setting-adsl.sgml | 48 - docs/libnm/tmpl/nm-setting-bluetooth.sgml | 23 - docs/libnm/tmpl/nm-setting-bond.sgml | 18 - docs/libnm/tmpl/nm-setting-bridge-port.sgml | 28 - docs/libnm/tmpl/nm-setting-bridge.sgml | 48 - docs/libnm/tmpl/nm-setting-cdma.sgml | 33 - docs/libnm/tmpl/nm-setting-connection.sgml | 7 - docs/libnm/tmpl/nm-setting-dcb.sgml | 88 - docs/libnm/tmpl/nm-setting-generic.sgml | 13 - docs/libnm/tmpl/nm-setting-gsm.sgml | 58 - docs/libnm/tmpl/nm-setting-infiniband.sgml | 38 - docs/libnm/tmpl/nm-setting-ip-config.sgml | 91 - docs/libnm/tmpl/nm-setting-ip4-config.sgml | 18 - docs/libnm/tmpl/nm-setting-ip6-config.sgml | 18 - docs/libnm/tmpl/nm-setting-olpc-mesh.sgml | 28 - docs/libnm/tmpl/nm-setting-ppp.sgml | 103 - docs/libnm/tmpl/nm-setting-pppoe.sgml | 33 - docs/libnm/tmpl/nm-setting-serial.sgml | 38 - docs/libnm/tmpl/nm-setting-team-port.sgml | 18 - docs/libnm/tmpl/nm-setting-team.sgml | 18 - docs/libnm/tmpl/nm-setting-vlan.sgml | 38 - docs/libnm/tmpl/nm-setting-vpn.sgml | 38 - docs/libnm/tmpl/nm-setting-wimax.sgml | 23 - docs/libnm/tmpl/nm-setting-wired.sgml | 68 - docs/libnm/tmpl/nm-setting-wireless-security.sgml | 98 - docs/libnm/tmpl/nm-setting-wireless.sgml | 78 - docs/libnm/tmpl/nm-setting.sgml | 14 - docs/libnm/tmpl/nm-simple-connection.sgml | 13 - docs/libnm/tmpl/nm-vpn-connection.sgml | 33 - docs/libnm/tmpl/nm-vpn-editor-plugin.sgml | 2 +- docs/libnm/tmpl/nm-wimax-nsp.sgml | 28 - docs/libnm/version.xml | 2 +- examples/C/Makefile.in | 24 +- examples/C/glib/Makefile.in | 30 +- examples/C/qt/Makefile.in | 26 +- examples/Makefile.in | 24 +- examples/dispatcher/10-ifcfg-rh-routes.sh | 34 + examples/dispatcher/Makefile.am | 1 + examples/dispatcher/Makefile.in | 25 +- examples/python/Makefile.in | 24 +- examples/python/dbus/Makefile.in | 24 +- examples/python/gi/Makefile.in | 24 +- examples/ruby/Makefile.in | 24 +- examples/shell/Makefile.in | 24 +- examples/shell/active-wifi.sh | 2 +- examples/shell/disconnect-device.sh | 4 +- gtk-doc.make | 39 +- include/Makefile.in | 24 +- include/gsystem-local-alloc.h | 57 +- include/nm-test-utils.h | 246 +- include/nm-utils-internal.h | 73 + introspection/Makefile.in | 30 +- introspection/nm-device-wifi.xml | 19 +- libnm-core/Makefile.in | 34 +- libnm-core/nm-connection.c | 68 +- libnm-core/nm-core-enum-types.c | 4 + libnm-core/nm-core-internal.h | 4 + libnm-core/nm-dbus-interface.h | 10 +- libnm-core/nm-errors.c | 2 +- libnm-core/nm-setting-8021x.c | 6 +- libnm-core/nm-setting-adsl.c | 11 +- libnm-core/nm-setting-bond.c | 35 +- libnm-core/nm-setting-bridge.c | 10 +- libnm-core/nm-setting-cdma.c | 11 +- libnm-core/nm-setting-connection.c | 3 +- libnm-core/nm-setting-dcb.c | 14 +- libnm-core/nm-setting-gsm.c | 11 +- libnm-core/nm-setting-ip4-config.c | 9 + libnm-core/nm-setting-ip6-config.c | 9 + libnm-core/nm-setting-team-port.c | 12 + libnm-core/nm-setting-wired.c | 33 +- libnm-core/nm-setting-wireless-security.c | 52 +- libnm-core/nm-setting.c | 112 +- libnm-core/nm-utils.c | 75 +- libnm-core/nm-version.h | 4 +- libnm-core/nm-version.h.in | 2 +- libnm-core/tests/Makefile.am | 1 + libnm-core/tests/Makefile.in | 32 +- libnm-core/tests/test-crypto.c | 3 +- libnm-core/tests/test-general.c | 202 +- libnm-core/tests/test-secrets.c | 7 +- libnm-core/tests/test-setting-8021x.c | 3 + libnm-core/tests/test-setting-dcb.c | 11 +- libnm-glib/Makefile.in | 33 +- libnm-glib/nm-client.c | 4 +- libnm-glib/nm-remote-settings.c | 4 +- libnm-glib/tests/Makefile.am | 7 +- libnm-glib/tests/Makefile.in | 34 +- libnm-glib/tests/test-remote-settings-client.c | 6 +- libnm-util/Makefile.am | 3 +- libnm-util/Makefile.in | 37 +- libnm-util/NetworkManager.h | 10 +- libnm-util/nm-connection.c | 2 +- libnm-util/nm-setting-adsl.c | 11 +- libnm-util/nm-setting-cdma.c | 11 +- libnm-util/nm-setting-connection.c | 18 +- libnm-util/nm-setting-dcb.c | 14 +- libnm-util/nm-setting-gsm.c | 11 +- libnm-util/nm-setting-ip4-config.c | 10 - libnm-util/nm-setting-ip6-config.c | 44 + libnm-util/nm-setting-team-port.c | 12 + libnm-util/nm-setting-wired.c | 33 +- libnm-util/nm-setting-wireless-security.c | 52 +- libnm-util/nm-utils.c | 2 +- libnm-util/nm-version.h.in | 2 +- libnm-util/tests/Makefile.am | 1 + libnm-util/tests/Makefile.in | 32 +- libnm-util/tests/test-crypto.c | 5 +- libnm-util/tests/test-general.c | 30 +- libnm-util/tests/test-secrets.c | 22 +- libnm-util/tests/test-setting-8021x.c | 3 + libnm-util/tests/test-setting-dcb.c | 11 +- libnm/Makefile.in | 36 +- libnm/libnm.pc.in | 2 +- libnm/nm-client.c | 2 +- libnm/nm-dbus-helpers.c | 1 + libnm/nm-dhcp6-config.c | 2 +- libnm/nm-ifcfg-rh-docs.xml | 6 +- libnm/nm-manager.c | 2 +- libnm/nm-object.c | 33 +- libnm/nm-property-docs.xml | 28 +- libnm/nm-secret-agent-old.c | 2 +- libnm/nm-setting-docs.xml | 28 +- libnm/tests/Makefile.am | 8 +- libnm/tests/Makefile.in | 34 +- libnm/tests/test-remote-settings-client.c | 6 +- libnm/tests/test-secret-agent.c | 10 +- m4/compiler_warnings.m4 | 86 +- m4/gtk-doc.m4 | 47 +- m4/intltool.m4 | 25 - man/Makefile.in | 31 +- man/NetworkManager.8 | 7 +- man/NetworkManager.conf.5 | 12 +- man/NetworkManager.conf.xml.in | 20 +- man/nm-settings-ifcfg-rh.5 | 51 +- man/nm-settings-ifcfg-rh.xml | 17 +- man/nm-settings-ifcfg-rh.xsl | 12 +- man/nm-settings-keyfile.5 | 6 +- man/nm-settings-keyfile.xml | 2 +- man/nm-settings.5 | 34 +- man/nm-settings.xml | 30 +- man/nmcli.1.in | 2 +- po/Makefile.in.in | 11 +- po/POTFILES.skip | 2 + po/de.po | 51 +- po/gu.po | 58 +- po/it.po | 7230 ++++++++++------- po/pl.po | 6537 +++++++++------- po/ru.po | 8234 +++++++++++++------- po/te.po | 1 - po/tr.po | 6 +- policy/Makefile.in | 26 +- src/Makefile.am | 1 + src/Makefile.in | 52 +- src/NetworkManagerUtils.c | 95 +- src/NetworkManagerUtils.h | 3 +- src/devices/adsl/Makefile.in | 30 +- src/devices/bluetooth/Makefile.in | 30 +- src/devices/bluetooth/nm-device-bt.c | 7 +- src/devices/nm-device-bond.c | 3 +- src/devices/nm-device-bridge.c | 3 +- src/devices/nm-device-private.h | 3 +- src/devices/nm-device.c | 429 +- src/devices/nm-device.h | 67 +- src/devices/team/Makefile.in | 30 +- src/devices/team/nm-device-team.c | 333 +- src/devices/wifi/Makefile.in | 30 +- src/devices/wifi/nm-device-olpc-mesh.c | 2 +- src/devices/wifi/nm-device-wifi.c | 82 +- src/devices/wifi/nm-wifi-ap.c | 2 +- src/devices/wifi/tests/Makefile.am | 1 + src/devices/wifi/tests/Makefile.in | 32 +- src/devices/wifi/tests/test-wifi-ap-utils.c | 3 + src/devices/wimax/Makefile.in | 30 +- src/devices/wimax/nm-device-wimax.c | 31 +- src/devices/wwan/Makefile.in | 30 +- src/devices/wwan/nm-device-modem.c | 71 +- src/devices/wwan/nm-modem-broadband.c | 385 +- src/devices/wwan/nm-modem.c | 310 +- src/devices/wwan/nm-modem.h | 24 +- src/devices/wwan/wwan-exports.ver | 2 + src/dhcp-manager/Makefile.in | 30 +- src/dhcp-manager/nm-dhcp-client.c | 10 +- src/dhcp-manager/nm-dhcp-dhclient-utils.c | 29 +- src/dhcp-manager/nm-dhcp-utils.c | 1 + src/dhcp-manager/systemd-dhcp/nm-sd-adapt.h | 2 +- src/dhcp-manager/tests/Makefile.am | 1 + src/dhcp-manager/tests/Makefile.in | 34 +- src/dhcp-manager/tests/test-dhcp-dhclient.c | 79 +- src/dhcp-manager/tests/test-dhcp-utils.c | 3 +- src/dns-manager/nm-dns-manager.c | 198 +- src/dns-manager/nm-dns-plugin.c | 5 +- src/dns-manager/nm-dns-unbound.c | 2 +- src/dnsmasq-manager/tests/Makefile.am | 1 + src/dnsmasq-manager/tests/Makefile.in | 32 +- src/main-utils.c | 93 +- src/main-utils.h | 8 +- src/main.c | 233 +- src/nm-auth-manager.c | 22 +- src/nm-auth-subject.c | 3 +- src/nm-auth-utils.c | 5 +- src/nm-config.c | 19 +- src/nm-connectivity.c | 69 +- src/nm-dbus-manager.c | 46 +- src/nm-dbus-manager.h | 1 + src/nm-default-route-manager.c | 218 +- src/nm-dispatcher.c | 8 + src/nm-enum-types.c | 18 +- src/nm-iface-helper.c | 278 +- src/nm-ip4-config.c | 2 + src/nm-ip6-config.c | 4 +- src/nm-logging.c | 19 +- src/nm-logging.h | 27 +- src/nm-manager.c | 112 +- src/nm-properties-changed-signal.c | 11 +- src/platform/Makefile.in | 24 +- src/platform/nm-fake-platform.c | 18 + src/platform/nm-linux-platform.c | 150 +- src/platform/nm-platform.c | 166 +- src/platform/nm-platform.h | 30 +- src/platform/tests/Makefile.am | 2 +- src/platform/tests/Makefile.in | 32 +- src/platform/tests/test-address.c | 6 + src/platform/tests/test-cleanup.c | 6 + src/platform/tests/test-common.c | 115 +- src/platform/tests/test-common.h | 8 + src/platform/tests/test-link.c | 8 + src/platform/tests/test-route.c | 97 +- src/platform/wifi/wifi-utils-nl80211.c | 11 + src/platform/wifi/wifi-utils-wext.c | 15 +- src/platform/wifi/wifi-utils.h | 3 +- src/ppp-manager/Makefile.in | 30 +- src/ppp-manager/nm-ppp-manager.c | 111 +- src/ppp-manager/nm-ppp-manager.h | 8 + src/rdisc/Makefile.in | 24 +- src/rdisc/nm-fake-rdisc.c | 394 +- src/rdisc/nm-fake-rdisc.h | 47 +- src/rdisc/nm-lndp-rdisc.c | 468 +- src/rdisc/nm-rdisc-private.h | 36 + src/rdisc/nm-rdisc.c | 454 +- src/rdisc/nm-rdisc.h | 2 + src/rdisc/tests/Makefile.am | 17 +- src/rdisc/tests/Makefile.in | 199 +- src/rdisc/tests/rdisc.c | 79 - src/rdisc/tests/test-rdisc-fake.c | 453 ++ src/rdisc/tests/test-rdisc-linux.c | 75 + src/settings/nm-agent-manager.c | 9 +- src/settings/nm-inotify-helper.c | 16 +- src/settings/nm-settings-connection.c | 141 +- src/settings/nm-settings-connection.h | 22 +- src/settings/nm-settings.c | 74 + src/settings/nm-settings.h | 11 +- src/settings/plugins/Makefile.in | 24 +- src/settings/plugins/example/Makefile.in | 30 +- .../plugins/example/nm-example-connection.c | 1 + src/settings/plugins/ibft/Makefile.in | 30 +- src/settings/plugins/ibft/nm-ibft-connection.c | 1 + src/settings/plugins/ibft/plugin.c | 6 +- src/settings/plugins/ibft/reader.c | 1 + src/settings/plugins/ibft/tests/Makefile.am | 1 + src/settings/plugins/ibft/tests/Makefile.in | 32 +- src/settings/plugins/ibft/tests/test-ibft.c | 7 +- src/settings/plugins/ifcfg-rh/Makefile.in | 30 +- src/settings/plugins/ifcfg-rh/common.h | 4 +- .../plugins/ifcfg-rh/nm-ifcfg-connection.c | 217 +- .../plugins/ifcfg-rh/nm-ifcfg-connection.h | 8 +- src/settings/plugins/ifcfg-rh/plugin.c | 561 +- src/settings/plugins/ifcfg-rh/reader.c | 203 +- src/settings/plugins/ifcfg-rh/reader.h | 17 +- src/settings/plugins/ifcfg-rh/shvar.c | 16 +- src/settings/plugins/ifcfg-rh/tests/Makefile.am | 1 + src/settings/plugins/ifcfg-rh/tests/Makefile.in | 32 +- .../ifcfg-rh/tests/network-scripts/Makefile.am | 3 + .../ifcfg-rh/tests/network-scripts/Makefile.in | 27 +- .../network-scripts/ifcfg-test-bond-mode-numeric | 5 + .../tests/network-scripts/ifcfg-test-bridge-main | 2 +- .../tests/network-scripts/ifcfg-test-wifi-open | 2 + .../network-scripts/ifcfg-test-wired-dhcp-plus-ip | 6 +- .../network-scripts/ifcfg-test-wired-ipv4-manual-1 | 2 +- .../network-scripts/ifcfg-test-wired-ipv4-manual-2 | 3 - .../ifcfg-test-wired-obsolete-gateway-n | 13 + .../ifcfg-test-wired-shared-plus-ip | 19 + .../plugins/ifcfg-rh/tests/test-ifcfg-rh-utils.c | 2 +- .../plugins/ifcfg-rh/tests/test-ifcfg-rh.c | 2561 ++---- src/settings/plugins/ifcfg-rh/utils.c | 24 + src/settings/plugins/ifcfg-rh/utils.h | 8 + src/settings/plugins/ifcfg-rh/writer.c | 40 +- src/settings/plugins/ifcfg-suse/Makefile.in | 30 +- src/settings/plugins/ifnet/Makefile.in | 30 +- src/settings/plugins/ifnet/net_parser.c | 6 +- src/settings/plugins/ifnet/nm-ifnet-connection.c | 1 + src/settings/plugins/ifnet/plugin.c | 9 +- src/settings/plugins/ifnet/tests/Makefile.in | 30 +- src/settings/plugins/ifnet/tests/test_all.c | 3 +- src/settings/plugins/ifupdown/Makefile.in | 30 +- src/settings/plugins/ifupdown/tests/Makefile.am | 2 + src/settings/plugins/ifupdown/tests/Makefile.in | 30 +- src/settings/plugins/keyfile/Makefile.in | 30 +- src/settings/plugins/keyfile/common.h | 2 +- .../plugins/keyfile/nm-keyfile-connection.c | 64 +- .../plugins/keyfile/nm-keyfile-connection.h | 3 - src/settings/plugins/keyfile/plugin.c | 377 +- src/settings/plugins/keyfile/reader.c | 1 + src/settings/plugins/keyfile/tests/Makefile.am | 1 + src/settings/plugins/keyfile/tests/Makefile.in | 32 +- .../plugins/keyfile/tests/keyfiles/Makefile.in | 24 +- .../keyfile/tests/keyfiles/Test_Bridge_Main | 2 +- src/settings/plugins/keyfile/tests/test-keyfile.c | 26 +- src/settings/plugins/keyfile/utils.h | 7 + src/settings/plugins/keyfile/writer.c | 32 +- src/supplicant-manager/nm-supplicant-config.c | 7 + src/supplicant-manager/tests/Makefile.am | 1 + src/supplicant-manager/tests/Makefile.in | 32 +- .../tests/test-supplicant-config.c | 9 +- src/tests/Makefile.am | 1 + src/tests/Makefile.in | 34 +- src/tests/config/Makefile.am | 1 + src/tests/config/Makefile.in | 32 +- src/tests/config/nm-test-device.c | 7 - src/tests/config/test-config.c | 25 +- src/tests/test-general-with-expect.c | 32 +- src/tests/test-wired-defname.c | 9 +- tools/Makefile.in | 24 +- tools/run-test-valgrind.sh | 20 +- tools/test-networkmanager-service.py | 26 +- valgrind.suppressions | 267 + vapi/Makefile.in | 27 +- vapi/NMClient-1.0.metadata | 12 + vapi/NetworkManager-1.0.metadata | 12 + 657 files changed, 112524 insertions(+), 91492 deletions(-) create mode 100644 callouts/tests/dispatcher-down delete mode 100644 callouts/tests/dispatcher-old-down delete mode 100644 callouts/tests/dispatcher-old-up delete mode 100644 callouts/tests/dispatcher-old-vpn-down delete mode 100644 callouts/tests/dispatcher-old-vpn-up create mode 100644 callouts/tests/dispatcher-up create mode 100644 callouts/tests/dispatcher-vpn-down create mode 100644 callouts/tests/dispatcher-vpn-up create mode 100644 docs/api/html/left-insensitive.png create mode 100644 docs/api/html/right-insensitive.png create mode 100644 docs/api/html/up-insensitive.png create mode 100644 docs/libnm-glib/html/left-insensitive.png delete mode 100644 docs/libnm-glib/html/libnm-glib-NMVpnPluginUi.html create mode 100644 docs/libnm-glib/html/libnm-glib-NMVpnPluginUiWidget.html create mode 100644 docs/libnm-glib/html/right-insensitive.png create mode 100644 docs/libnm-glib/html/up-insensitive.png create mode 100644 docs/libnm-util/html/left-insensitive.png create mode 100644 docs/libnm-util/html/right-insensitive.png create mode 100644 docs/libnm-util/html/up-insensitive.png create mode 100644 docs/libnm/html/NMVpnEditor.html create mode 100644 docs/libnm/html/left-insensitive.png delete mode 100644 docs/libnm/html/libnm-NMVpnEditorPlugin.html create mode 100644 docs/libnm/html/right-insensitive.png create mode 100644 docs/libnm/html/up-insensitive.png create mode 100755 examples/dispatcher/10-ifcfg-rh-routes.sh create mode 100644 src/rdisc/nm-rdisc-private.h delete mode 100644 src/rdisc/tests/rdisc.c create mode 100644 src/rdisc/tests/test-rdisc-fake.c create mode 100644 src/rdisc/tests/test-rdisc-linux.c create mode 100644 src/settings/plugins/ifcfg-rh/tests/network-scripts/ifcfg-test-bond-mode-numeric create mode 100644 src/settings/plugins/ifcfg-rh/tests/network-scripts/ifcfg-test-wired-obsolete-gateway-n create mode 100644 src/settings/plugins/ifcfg-rh/tests/network-scripts/ifcfg-test-wired-shared-plus-ip diff --git a/INSTALL b/INSTALL index 007e9396..20998407 100644 --- a/INSTALL +++ b/INSTALL @@ -12,8 +12,8 @@ without warranty of any kind. Basic Installation ================== - Briefly, the shell commands `./configure; make; make install' should -configure, build, and install this package. The following + Briefly, the shell command `./configure && make && make install' +should configure, build, and install this package. The following more-detailed instructions are generic; see the `README' file for instructions specific to this package. Some packages provide this `INSTALL' file but do not implement all of the features documented diff --git a/Makefile.in b/Makefile.in index fb24b2e8..9214d6f0 100644 --- a/Makefile.in +++ b/Makefile.in @@ -1,7 +1,7 @@ -# Makefile.in generated by automake 1.13.4 from Makefile.am. +# Makefile.in generated by automake 1.15 from Makefile.am. # @configure_input@ -# Copyright (C) 1994-2013 Free Software Foundation, Inc. +# Copyright (C) 1994-2014 Free Software Foundation, Inc. # This Makefile.in is free software; the Free Software Foundation # gives unlimited permission to copy and/or distribute it, @@ -15,7 +15,17 @@ @SET_MAKE@ VPATH = @srcdir@ -am__is_gnu_make = test -n '$(MAKEFILE_LIST)' && test -n '$(MAKELEVEL)' +am__is_gnu_make = { \ + if test -z '$(MAKELEVEL)'; then \ + false; \ + elif test -n '$(MAKE_HOST)'; then \ + true; \ + elif test -n '$(MAKE_VERSION)' && test -n '$(CURDIR)'; then \ + true; \ + else \ + false; \ + fi; \ +} am__make_running_with_option = \ case $${target_option-} in \ ?) ;; \ @@ -79,28 +89,6 @@ POST_UNINSTALL = : build_triplet = @build@ host_triplet = @host@ subdir = . -DIST_COMMON = INSTALL NEWS README AUTHORS ChangeLog \ - $(srcdir)/Makefile.in $(srcdir)/Makefile.am \ - $(top_srcdir)/configure $(am__configure_deps) \ - $(srcdir)/config.h.in \ - $(top_srcdir)/initscript/RedHat/NetworkManager.in \ - $(top_srcdir)/initscript/Debian/NetworkManager.in \ - $(top_srcdir)/initscript/Slackware/rc.networkmanager.in \ - $(top_srcdir)/initscript/SUSE/networkmanager.in \ - $(top_srcdir)/initscript/Arch/networkmanager.in \ - $(top_srcdir)/initscript/Mandriva/networkmanager.in \ - $(top_srcdir)/initscript/linexa/networkmanager.in \ - $(srcdir)/NetworkManager.pc.in ABOUT-NLS COPYING TODO \ - build-aux/compile build-aux/config.guess \ - build-aux/config.rpath build-aux/config.sub \ - build-aux/install-sh build-aux/missing build-aux/ltmain.sh \ - $(top_srcdir)/build-aux/compile \ - $(top_srcdir)/build-aux/config.guess \ - $(top_srcdir)/build-aux/config.rpath \ - $(top_srcdir)/build-aux/config.sub \ - $(top_srcdir)/build-aux/install-sh \ - $(top_srcdir)/build-aux/ltmain.sh \ - $(top_srcdir)/build-aux/missing ACLOCAL_M4 = $(top_srcdir)/aclocal.m4 am__aclocal_m4_deps = $(top_srcdir)/m4/ax_lib_readline.m4 \ $(top_srcdir)/m4/compiler_warnings.m4 \ @@ -117,6 +105,8 @@ am__aclocal_m4_deps = $(top_srcdir)/m4/ax_lib_readline.m4 \ $(top_srcdir)/m4/vapigen.m4 $(top_srcdir)/configure.ac am__configure_deps = $(am__aclocal_m4_deps) $(CONFIGURE_DEPENDENCIES) \ $(ACLOCAL_M4) +DIST_COMMON = $(srcdir)/Makefile.am $(top_srcdir)/configure \ + $(am__configure_deps) $(am__DIST_COMMON) am__CONFIG_DISTCLEAN_FILES = config.status config.cache config.log \ configure.lineno config.status.lineno mkinstalldirs = $(install_sh) -d @@ -214,6 +204,25 @@ ETAGS = etags CTAGS = ctags CSCOPE = cscope DIST_SUBDIRS = $(SUBDIRS) +am__DIST_COMMON = $(srcdir)/Makefile.in $(srcdir)/NetworkManager.pc.in \ + $(srcdir)/config.h.in $(top_srcdir)/build-aux/compile \ + $(top_srcdir)/build-aux/config.guess \ + $(top_srcdir)/build-aux/config.rpath \ + $(top_srcdir)/build-aux/config.sub \ + $(top_srcdir)/build-aux/install-sh \ + $(top_srcdir)/build-aux/ltmain.sh \ + $(top_srcdir)/build-aux/missing \ + $(top_srcdir)/initscript/Arch/networkmanager.in \ + $(top_srcdir)/initscript/Debian/NetworkManager.in \ + $(top_srcdir)/initscript/Mandriva/networkmanager.in \ + $(top_srcdir)/initscript/RedHat/NetworkManager.in \ + $(top_srcdir)/initscript/SUSE/networkmanager.in \ + $(top_srcdir)/initscript/Slackware/rc.networkmanager.in \ + $(top_srcdir)/initscript/linexa/networkmanager.in ABOUT-NLS \ + AUTHORS COPYING ChangeLog INSTALL NEWS README TODO \ + build-aux/compile build-aux/config.guess \ + build-aux/config.rpath build-aux/config.sub build-aux/depcomp \ + build-aux/install-sh build-aux/ltmain.sh build-aux/missing DISTFILES = $(DIST_COMMON) $(DIST_SOURCES) $(TEXINFOS) $(EXTRA_DIST) distdir = $(PACKAGE)-$(VERSION) top_distdir = $(distdir) @@ -281,7 +290,6 @@ CXXCPP = @CXXCPP@ CXXDEPMODE = @CXXDEPMODE@ CXXFLAGS = @CXXFLAGS@ CYGPATH_W = @CYGPATH_W@ -DATADIRNAME = @DATADIRNAME@ DBUS_CFLAGS = @DBUS_CFLAGS@ DBUS_GLIB_100_CFLAGS = @DBUS_GLIB_100_CFLAGS@ DBUS_GLIB_100_LIBS = @DBUS_GLIB_100_LIBS@ @@ -316,6 +324,7 @@ GNUTLS_CFLAGS = @GNUTLS_CFLAGS@ GNUTLS_LIBS = @GNUTLS_LIBS@ GREP = @GREP@ GTKDOC_CHECK = @GTKDOC_CHECK@ +GTKDOC_CHECK_PATH = @GTKDOC_CHECK_PATH@ GTKDOC_DEPS_CFLAGS = @GTKDOC_DEPS_CFLAGS@ GTKDOC_DEPS_LIBS = @GTKDOC_DEPS_LIBS@ GTKDOC_MKPDF = @GTKDOC_MKPDF@ @@ -582,7 +591,6 @@ $(srcdir)/Makefile.in: @MAINTAINER_MODE_TRUE@ $(srcdir)/Makefile.am $(am__confi echo ' cd $(top_srcdir) && $(AUTOMAKE) --gnu Makefile'; \ $(am__cd) $(top_srcdir) && \ $(AUTOMAKE) --gnu Makefile -.PRECIOUS: Makefile Makefile: $(srcdir)/Makefile.in $(top_builddir)/config.status @case '$?' in \ *config.status*) \ @@ -603,8 +611,8 @@ $(ACLOCAL_M4): @MAINTAINER_MODE_TRUE@ $(am__aclocal_m4_deps) $(am__aclocal_m4_deps): config.h: stamp-h1 - @if test ! -f $@; then rm -f stamp-h1; else :; fi - @if test ! -f $@; then $(MAKE) $(AM_MAKEFLAGS) stamp-h1; else :; fi + @test -f $@ || rm -f stamp-h1 + @test -f $@ || $(MAKE) $(AM_MAKEFLAGS) stamp-h1 stamp-h1: $(srcdir)/config.h.in $(top_builddir)/config.status @rm -f stamp-h1 @@ -846,10 +854,16 @@ dist-xz: distdir $(am__post_remove_distdir) dist-tarZ: distdir + @echo WARNING: "Support for distribution archives compressed with" \ + "legacy program 'compress' is deprecated." >&2 + @echo WARNING: "It will be removed altogether in Automake 2.0" >&2 tardir=$(distdir) && $(am__tar) | compress -c >$(distdir).tar.Z $(am__post_remove_distdir) dist-shar: distdir + @echo WARNING: "Support for shar distribution archives is" \ + "deprecated." >&2 + @echo WARNING: "It will be removed altogether in Automake 2.0" >&2 shar $(distdir) | GZIP=$(GZIP_ENV) gzip -c >$(distdir).shar.gz $(am__post_remove_distdir) @@ -884,16 +898,17 @@ distcheck: dist esac chmod -R a-w $(distdir) chmod u+w $(distdir) - mkdir $(distdir)/_build $(distdir)/_inst + mkdir $(distdir)/_build $(distdir)/_build/sub $(distdir)/_inst chmod a-w $(distdir) test -d $(distdir)/_build || exit 0; \ dc_install_base=`$(am__cd) $(distdir)/_inst && pwd | sed -e 's,^[^:\\/]:[\\/],/,'` \ && dc_destdir="$${TMPDIR-/tmp}/am-dc-$$$$/" \ && am__cwd=`pwd` \ - && $(am__cd) $(distdir)/_build \ - && ../configure --srcdir=.. --prefix="$$dc_install_base" \ + && $(am__cd) $(distdir)/_build/sub \ + && ../../configure \ $(AM_DISTCHECK_CONFIGURE_FLAGS) \ $(DISTCHECK_CONFIGURE_FLAGS) \ + --srcdir=../.. --prefix="$$dc_install_base" \ && $(MAKE) $(AM_MAKEFLAGS) \ && $(MAKE) $(AM_MAKEFLAGS) dvi \ && $(MAKE) $(AM_MAKEFLAGS) check \ @@ -1075,6 +1090,8 @@ uninstall-am: uninstall-pkgconfigDATA mostlyclean-libtool pdf pdf-am ps ps-am tags tags-am uninstall \ uninstall-am uninstall-pkgconfigDATA +.PRECIOUS: Makefile + include $(GLIB_MAKEFILE) @GNOME_CODE_COVERAGE_RULES@ diff --git a/NEWS b/NEWS index 2de014eb..72e53f8e 100644 --- a/NEWS +++ b/NEWS @@ -1,3 +1,47 @@ +=============================================== +NetworkManager-1.0.2 +Overview of changes since NetworkManager-1.0 +=============================================== + +This is a new stable release of NetworkManager. Notable changes include: + +* Wi-Fi devices now indicate support for 2GHz and 5GHz frequencies +* "nmcli device" output now indicates physical port ID +* New config items added to the 'ifcfg-rh' plugin: + - IPV4_ROUTE_METRIC and IPV6_ROUTE_METRIC + - DEVTIMEOUT + - IPADDR and PREFIX are now supported for specifying address ranges of + shared IPv4 connections +* Dispatcher scripts now get a CONNECTION_FILENAME variable with the path + to the configuration file for the connection +* An example dispatcher script that is able to apply complex routing rules + (such as setting up policy-based routing) for 'ifcfg-rh' connections was + added to examples/dispatcher/. +* 'mode' key of Bond device options property now accepts numeric values +* Connection attempts for devices without carrier on startup now wait for + carrier to appear within a short timeout instead of failing + immediately. This makes system startup more robust. +* Bridge connectivity is now properly restored on resume from suspend +* The D-Bus name is acquired earlier during the daemon startup. This makes + it possible for the systemd service manager to optimize the service + startup so that services that require networking are activated sooner + contributing to faster system start up time. +* A lot of memory leak problems were fixed, resulting in reduced memory usage. + Many of them were discovered as a result of improvements in use of + Valgrind in the testing infrastructure. +* Management of 'teamd' daemon instances for Team devices is now more robust. +* The 'dnsmasq' daemon respawns when it terminates and it is configured for + management of DNS resolver configuration +* Hostnames that are not fully qualified are no longer sent to a DHCPv6 + server for a dynamic DNS update +* Connection UUIDs are now checked for uniqueness when connection + configurations are read +* Receipt of a NDP Router Advertisement can no longer lower the IPv6 hop + limit (CVE-2015-2924) +* Many other bugs were fixed +* Updates to Telugu, Turkish, Polish, German, Gujarati, Italian and Russian + translations + =============================================== NetworkManager-1.0 Overview of changes since NetworkManager-0.9.10 @@ -44,6 +88,7 @@ This is a new stable release of NetworkManager. Notable changes include: * The manpages, documentation, and API annotations have received many cleanups * Externally created virtual interfaces are no longer managed by NetworkManager until they are set "up" or activated via nmcli +* Team device support is now an optional plugin ============================================== @@ -89,7 +134,7 @@ This is a new stable release of NetworkManager. Notable changes include: * The dispatcher timeout has increased to 10 minutes, and new "pre-up" and "pre-down" events have been added which block activation until complete * NetworkManager no longer prevents Wake-on-LAN functionality from working -* PPPoE now requires userland "rp-pppoe" to work around kernel bugs with +* PPPoE now requires userland "rp-pppoe" to work around kernel bugs that prevent detecting server-side termination of the PPP link * An ARP announcement is now sent after IPv4 addresses are configured * Added a DNS plugin for dnssec-trigger for better DNSSEC operation diff --git a/aclocal.m4 b/aclocal.m4 index ca9f86f3..73e1b3dd 100644 --- a/aclocal.m4 +++ b/aclocal.m4 @@ -1,6 +1,6 @@ -# generated automatically by aclocal 1.13.4 -*- Autoconf -*- +# generated automatically by aclocal 1.15 -*- Autoconf -*- -# Copyright (C) 1996-2013 Free Software Foundation, Inc. +# Copyright (C) 1996-2014 Free Software Foundation, Inc. # This file is free software; the Free Software Foundation # gives unlimited permission to copy and/or distribute it, @@ -235,7 +235,7 @@ AS_VAR_COPY([$1], [pkg_cv_][$1]) AS_VAR_IF([$1], [""], [$5], [$4])dnl ])# PKG_CHECK_VAR -# Copyright (C) 2002-2013 Free Software Foundation, Inc. +# Copyright (C) 2002-2014 Free Software Foundation, Inc. # # This file is free software; the Free Software Foundation # gives unlimited permission to copy and/or distribute it, @@ -247,10 +247,10 @@ AS_VAR_IF([$1], [""], [$5], [$4])dnl # generated from the m4 files accompanying Automake X.Y. # (This private macro should not be called outside this file.) AC_DEFUN([AM_AUTOMAKE_VERSION], -[am__api_version='1.13' +[am__api_version='1.15' dnl Some users find AM_AUTOMAKE_VERSION and mistake it for a way to dnl require some minimum version. Point them to the right macro. -m4_if([$1], [1.13.4], [], +m4_if([$1], [1.15], [], [AC_FATAL([Do not call $0, use AM_INIT_AUTOMAKE([$1]).])])dnl ]) @@ -266,14 +266,14 @@ m4_define([_AM_AUTOCONF_VERSION], []) # Call AM_AUTOMAKE_VERSION and AM_AUTOMAKE_VERSION so they can be traced. # This function is AC_REQUIREd by AM_INIT_AUTOMAKE. AC_DEFUN([AM_SET_CURRENT_AUTOMAKE_VERSION], -[AM_AUTOMAKE_VERSION([1.13.4])dnl +[AM_AUTOMAKE_VERSION([1.15])dnl m4_ifndef([AC_AUTOCONF_VERSION], [m4_copy([m4_PACKAGE_VERSION], [AC_AUTOCONF_VERSION])])dnl _AM_AUTOCONF_VERSION(m4_defn([AC_AUTOCONF_VERSION]))]) # AM_AUX_DIR_EXPAND -*- Autoconf -*- -# Copyright (C) 2001-2013 Free Software Foundation, Inc. +# Copyright (C) 2001-2014 Free Software Foundation, Inc. # # This file is free software; the Free Software Foundation # gives unlimited permission to copy and/or distribute it, @@ -318,15 +318,14 @@ _AM_AUTOCONF_VERSION(m4_defn([AC_AUTOCONF_VERSION]))]) # configured tree to be moved without reconfiguration. AC_DEFUN([AM_AUX_DIR_EXPAND], -[dnl Rely on autoconf to set up CDPATH properly. -AC_PREREQ([2.50])dnl -# expand $ac_aux_dir to an absolute path -am_aux_dir=`cd $ac_aux_dir && pwd` +[AC_REQUIRE([AC_CONFIG_AUX_DIR_DEFAULT])dnl +# Expand $ac_aux_dir to an absolute path. +am_aux_dir=`cd "$ac_aux_dir" && pwd` ]) # AM_CONDITIONAL -*- Autoconf -*- -# Copyright (C) 1997-2013 Free Software Foundation, Inc. +# Copyright (C) 1997-2014 Free Software Foundation, Inc. # # This file is free software; the Free Software Foundation # gives unlimited permission to copy and/or distribute it, @@ -357,7 +356,7 @@ AC_CONFIG_COMMANDS_PRE( Usually this means the macro was only invoked conditionally.]]) fi])]) -# Copyright (C) 1999-2013 Free Software Foundation, Inc. +# Copyright (C) 1999-2014 Free Software Foundation, Inc. # # This file is free software; the Free Software Foundation # gives unlimited permission to copy and/or distribute it, @@ -548,7 +547,7 @@ _AM_SUBST_NOTMAKE([am__nodep])dnl # Generate code to set up dependency tracking. -*- Autoconf -*- -# Copyright (C) 1999-2013 Free Software Foundation, Inc. +# Copyright (C) 1999-2014 Free Software Foundation, Inc. # # This file is free software; the Free Software Foundation # gives unlimited permission to copy and/or distribute it, @@ -624,7 +623,7 @@ AC_DEFUN([AM_OUTPUT_DEPENDENCY_COMMANDS], # Do all the work for Automake. -*- Autoconf -*- -# Copyright (C) 1996-2013 Free Software Foundation, Inc. +# Copyright (C) 1996-2014 Free Software Foundation, Inc. # # This file is free software; the Free Software Foundation # gives unlimited permission to copy and/or distribute it, @@ -633,6 +632,12 @@ AC_DEFUN([AM_OUTPUT_DEPENDENCY_COMMANDS], # This macro actually does too much. Some checks are only needed if # your package does certain things. But this isn't really a big deal. +dnl Redefine AC_PROG_CC to automatically invoke _AM_PROG_CC_C_O. +m4_define([AC_PROG_CC], +m4_defn([AC_PROG_CC]) +[_AM_PROG_CC_C_O +]) + # AM_INIT_AUTOMAKE(PACKAGE, VERSION, [NO-DEFINE]) # AM_INIT_AUTOMAKE([OPTIONS]) # ----------------------------------------------- @@ -708,8 +713,8 @@ AC_REQUIRE([AC_PROG_MKDIR_P])dnl # # AC_SUBST([mkdir_p], ['$(MKDIR_P)']) -# We need awk for the "check" target. The system "awk" is bad on -# some platforms. +# We need awk for the "check" target (and possibly the TAP driver). The +# system "awk" is bad on some platforms. AC_REQUIRE([AC_PROG_AWK])dnl AC_REQUIRE([AC_PROG_MAKE_SET])dnl AC_REQUIRE([AM_SET_LEADING_DOT])dnl @@ -741,6 +746,51 @@ dnl macro is hooked onto _AC_COMPILER_EXEEXT early, see below. AC_CONFIG_COMMANDS_PRE(dnl [m4_provide_if([_AM_COMPILER_EXEEXT], [AM_CONDITIONAL([am__EXEEXT], [test -n "$EXEEXT"])])])dnl + +# POSIX will say in a future version that running "rm -f" with no argument +# is OK; and we want to be able to make that assumption in our Makefile +# recipes. So use an aggressive probe to check that the usage we want is +# actually supported "in the wild" to an acceptable degree. +# See automake bug#10828. +# To make any issue more visible, cause the running configure to be aborted +# by default if the 'rm' program in use doesn't match our expectations; the +# user can still override this though. +if rm -f && rm -fr && rm -rf; then : OK; else + cat >&2 <<'END' +Oops! + +Your 'rm' program seems unable to run without file operands specified +on the command line, even when the '-f' option is present. This is contrary +to the behaviour of most rm programs out there, and not conforming with +the upcoming POSIX standard: + +Please tell bug-automake@gnu.org about your system, including the value +of your $PATH and any error possibly output before this message. This +can help us improve future automake versions. + +END + if test x"$ACCEPT_INFERIOR_RM_PROGRAM" = x"yes"; then + echo 'Configuration will proceed anyway, since you have set the' >&2 + echo 'ACCEPT_INFERIOR_RM_PROGRAM variable to "yes"' >&2 + echo >&2 + else + cat >&2 <<'END' +Aborting the configuration process, to ensure you take notice of the issue. + +You can download and install GNU coreutils to get an 'rm' implementation +that behaves properly: . + +If you want to complete the configuration process using your problematic +'rm' anyway, export the environment variable ACCEPT_INFERIOR_RM_PROGRAM +to "yes", and re-run configure. + +END + AC_MSG_ERROR([Your 'rm' program is bad, sorry.]) + fi +fi +dnl The trailing newline in this macro's definition is deliberate, for +dnl backward compatibility and to allow trailing 'dnl'-style comments +dnl after the AM_INIT_AUTOMAKE invocation. See automake bug#16841. ]) dnl Hook into '_AC_COMPILER_EXEEXT' early to learn its expansion. Do not @@ -749,7 +799,6 @@ dnl mangled by Autoconf and run in a shell conditional statement. m4_define([_AC_COMPILER_EXEEXT], m4_defn([_AC_COMPILER_EXEEXT])[m4_provide([_AM_COMPILER_EXEEXT])]) - # When config.status generates a header, we must update the stamp-h file. # This file resides in the same directory as the config header # that is generated. The stamp files are numbered to have different names. @@ -771,7 +820,7 @@ for _am_header in $config_headers :; do done echo "timestamp for $_am_arg" >`AS_DIRNAME(["$_am_arg"])`/stamp-h[]$_am_stamp_count]) -# Copyright (C) 2001-2013 Free Software Foundation, Inc. +# Copyright (C) 2001-2014 Free Software Foundation, Inc. # # This file is free software; the Free Software Foundation # gives unlimited permission to copy and/or distribute it, @@ -782,7 +831,7 @@ echo "timestamp for $_am_arg" >`AS_DIRNAME(["$_am_arg"])`/stamp-h[]$_am_stamp_co # Define $install_sh. AC_DEFUN([AM_PROG_INSTALL_SH], [AC_REQUIRE([AM_AUX_DIR_EXPAND])dnl -if test x"${install_sh}" != xset; then +if test x"${install_sh+set}" != xset; then case $am_aux_dir in *\ * | *\ *) install_sh="\${SHELL} '$am_aux_dir/install-sh'" ;; @@ -792,7 +841,7 @@ if test x"${install_sh}" != xset; then fi AC_SUBST([install_sh])]) -# Copyright (C) 2003-2013 Free Software Foundation, Inc. +# Copyright (C) 2003-2014 Free Software Foundation, Inc. # # This file is free software; the Free Software Foundation # gives unlimited permission to copy and/or distribute it, @@ -814,7 +863,7 @@ AC_SUBST([am__leading_dot])]) # Add --enable-maintainer-mode option to configure. -*- Autoconf -*- # From Jim Meyering -# Copyright (C) 1996-2013 Free Software Foundation, Inc. +# Copyright (C) 1996-2014 Free Software Foundation, Inc. # # This file is free software; the Free Software Foundation # gives unlimited permission to copy and/or distribute it, @@ -849,7 +898,7 @@ AC_MSG_CHECKING([whether to enable maintainer-specific portions of Makefiles]) # Check to see how 'make' treats includes. -*- Autoconf -*- -# Copyright (C) 2001-2013 Free Software Foundation, Inc. +# Copyright (C) 2001-2014 Free Software Foundation, Inc. # # This file is free software; the Free Software Foundation # gives unlimited permission to copy and/or distribute it, @@ -897,41 +946,9 @@ AC_MSG_RESULT([$_am_result]) rm -f confinc confmf ]) -# Copyright (C) 1999-2013 Free Software Foundation, Inc. -# -# This file is free software; the Free Software Foundation -# gives unlimited permission to copy and/or distribute it, -# with or without modifications, as long as this notice is preserved. - -# AM_PROG_CC_C_O -# -------------- -# Like AC_PROG_CC_C_O, but changed for automake. -AC_DEFUN([AM_PROG_CC_C_O], -[AC_REQUIRE([AC_PROG_CC_C_O])dnl -AC_REQUIRE([AM_AUX_DIR_EXPAND])dnl -AC_REQUIRE_AUX_FILE([compile])dnl -# FIXME: we rely on the cache variable name because -# there is no other way. -set dummy $CC -am_cc=`echo $[2] | sed ['s/[^a-zA-Z0-9_]/_/g;s/^[0-9]/_/']` -eval am_t=\$ac_cv_prog_cc_${am_cc}_c_o -if test "$am_t" != yes; then - # Losing compiler, so override with the script. - # FIXME: It is wrong to rewrite CC. - # But if we don't then we get into trouble of one sort or another. - # A longer-term fix would be to have automake use am__CC in this case, - # and then we could set am__CC="\$(top_srcdir)/compile \$(CC)" - CC="$am_aux_dir/compile $CC" -fi -dnl Make sure AC_PROG_CC is never called again, or it will override our -dnl setting of CC. -m4_define([AC_PROG_CC], - [m4_fatal([AC_PROG_CC cannot be called after AM_PROG_CC_C_O])]) -]) - # Fake the existence of programs that GNU maintainers use. -*- Autoconf -*- -# Copyright (C) 1997-2013 Free Software Foundation, Inc. +# Copyright (C) 1997-2014 Free Software Foundation, Inc. # # This file is free software; the Free Software Foundation # gives unlimited permission to copy and/or distribute it, @@ -968,7 +985,7 @@ else fi ]) -# Copyright (C) 2003-2013 Free Software Foundation, Inc. +# Copyright (C) 2003-2014 Free Software Foundation, Inc. # # This file is free software; the Free Software Foundation # gives unlimited permission to copy and/or distribute it, @@ -1002,7 +1019,7 @@ esac # Helper functions for option handling. -*- Autoconf -*- -# Copyright (C) 2001-2013 Free Software Foundation, Inc. +# Copyright (C) 2001-2014 Free Software Foundation, Inc. # # This file is free software; the Free Software Foundation # gives unlimited permission to copy and/or distribute it, @@ -1031,7 +1048,54 @@ AC_DEFUN([_AM_SET_OPTIONS], AC_DEFUN([_AM_IF_OPTION], [m4_ifset(_AM_MANGLE_OPTION([$1]), [$2], [$3])]) -# Copyright (C) 2001-2013 Free Software Foundation, Inc. +# Copyright (C) 1999-2014 Free Software Foundation, Inc. +# +# This file is free software; the Free Software Foundation +# gives unlimited permission to copy and/or distribute it, +# with or without modifications, as long as this notice is preserved. + +# _AM_PROG_CC_C_O +# --------------- +# Like AC_PROG_CC_C_O, but changed for automake. We rewrite AC_PROG_CC +# to automatically call this. +AC_DEFUN([_AM_PROG_CC_C_O], +[AC_REQUIRE([AM_AUX_DIR_EXPAND])dnl +AC_REQUIRE_AUX_FILE([compile])dnl +AC_LANG_PUSH([C])dnl +AC_CACHE_CHECK( + [whether $CC understands -c and -o together], + [am_cv_prog_cc_c_o], + [AC_LANG_CONFTEST([AC_LANG_PROGRAM([])]) + # Make sure it works both with $CC and with simple cc. + # Following AC_PROG_CC_C_O, we do the test twice because some + # compilers refuse to overwrite an existing .o file with -o, + # though they will create one. + am_cv_prog_cc_c_o=yes + for am_i in 1 2; do + if AM_RUN_LOG([$CC -c conftest.$ac_ext -o conftest2.$ac_objext]) \ + && test -f conftest2.$ac_objext; then + : OK + else + am_cv_prog_cc_c_o=no + break + fi + done + rm -f core conftest* + unset am_i]) +if test "$am_cv_prog_cc_c_o" != yes; then + # Losing compiler, so override with the script. + # FIXME: It is wrong to rewrite CC. + # But if we don't then we get into trouble of one sort or another. + # A longer-term fix would be to have automake use am__CC in this case, + # and then we could set am__CC="\$(top_srcdir)/compile \$(CC)" + CC="$am_aux_dir/compile $CC" +fi +AC_LANG_POP([C])]) + +# For backward compatibility. +AC_DEFUN_ONCE([AM_PROG_CC_C_O], [AC_REQUIRE([AC_PROG_CC])]) + +# Copyright (C) 2001-2014 Free Software Foundation, Inc. # # This file is free software; the Free Software Foundation # gives unlimited permission to copy and/or distribute it, @@ -1050,7 +1114,7 @@ AC_DEFUN([AM_RUN_LOG], # Check to make sure that the build environment is sane. -*- Autoconf -*- -# Copyright (C) 1996-2013 Free Software Foundation, Inc. +# Copyright (C) 1996-2014 Free Software Foundation, Inc. # # This file is free software; the Free Software Foundation # gives unlimited permission to copy and/or distribute it, @@ -1131,7 +1195,7 @@ AC_CONFIG_COMMANDS_PRE( rm -f conftest.file ]) -# Copyright (C) 2009-2013 Free Software Foundation, Inc. +# Copyright (C) 2009-2014 Free Software Foundation, Inc. # # This file is free software; the Free Software Foundation # gives unlimited permission to copy and/or distribute it, @@ -1191,7 +1255,7 @@ AC_SUBST([AM_BACKSLASH])dnl _AM_SUBST_NOTMAKE([AM_BACKSLASH])dnl ]) -# Copyright (C) 2001-2013 Free Software Foundation, Inc. +# Copyright (C) 2001-2014 Free Software Foundation, Inc. # # This file is free software; the Free Software Foundation # gives unlimited permission to copy and/or distribute it, @@ -1219,7 +1283,7 @@ fi INSTALL_STRIP_PROGRAM="\$(install_sh) -c -s" AC_SUBST([INSTALL_STRIP_PROGRAM])]) -# Copyright (C) 2006-2013 Free Software Foundation, Inc. +# Copyright (C) 2006-2014 Free Software Foundation, Inc. # # This file is free software; the Free Software Foundation # gives unlimited permission to copy and/or distribute it, @@ -1238,7 +1302,7 @@ AC_DEFUN([AM_SUBST_NOTMAKE], [_AM_SUBST_NOTMAKE($@)]) # Check how to create a tarball. -*- Autoconf -*- -# Copyright (C) 2004-2013 Free Software Foundation, Inc. +# Copyright (C) 2004-2014 Free Software Foundation, Inc. # # This file is free software; the Free Software Foundation # gives unlimited permission to copy and/or distribute it, diff --git a/build-aux/compile b/build-aux/compile index 531136b0..a85b723c 100755 --- a/build-aux/compile +++ b/build-aux/compile @@ -3,7 +3,7 @@ scriptversion=2012-10-14.11; # UTC -# Copyright (C) 1999-2013 Free Software Foundation, Inc. +# Copyright (C) 1999-2014 Free Software Foundation, Inc. # Written by Tom Tromey . # # This program is free software; you can redistribute it and/or modify diff --git a/build-aux/config.guess b/build-aux/config.guess index 1f5c50c0..dbfb9786 100755 --- a/build-aux/config.guess +++ b/build-aux/config.guess @@ -1,8 +1,8 @@ #! /bin/sh # Attempt to guess a canonical system name. -# Copyright 1992-2014 Free Software Foundation, Inc. +# Copyright 1992-2015 Free Software Foundation, Inc. -timestamp='2014-03-23' +timestamp='2015-01-01' # This file is free software; you can redistribute it and/or modify it # under the terms of the GNU General Public License as published by @@ -24,12 +24,12 @@ timestamp='2014-03-23' # program. This Exception is an additional permission under section 7 # of the GNU General Public License, version 3 ("GPLv3"). # -# Originally written by Per Bothner. +# Originally written by Per Bothner; maintained since 2000 by Ben Elliston. # # You can get the latest version of this script from: # http://git.savannah.gnu.org/gitweb/?p=config.git;a=blob_plain;f=config.guess;hb=HEAD # -# Please send patches with a ChangeLog entry to config-patches@gnu.org. +# Please send patches to . me=`echo "$0" | sed -e 's,.*/,,'` @@ -50,7 +50,7 @@ version="\ GNU config.guess ($timestamp) Originally written by Per Bothner. -Copyright 1992-2014 Free Software Foundation, Inc. +Copyright 1992-2015 Free Software Foundation, Inc. This is free software; see the source for copying conditions. There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE." @@ -579,8 +579,9 @@ EOF else IBM_ARCH=powerpc fi - if [ -x /usr/bin/oslevel ] ; then - IBM_REV=`/usr/bin/oslevel` + if [ -x /usr/bin/lslpp ] ; then + IBM_REV=`/usr/bin/lslpp -Lqc bos.rte.libc | + awk -F: '{ print $3 }' | sed s/[0-9]*$/0/` else IBM_REV=${UNAME_VERSION}.${UNAME_RELEASE} fi diff --git a/build-aux/config.sub b/build-aux/config.sub index 66c50743..6467c95a 100755 --- a/build-aux/config.sub +++ b/build-aux/config.sub @@ -1,8 +1,8 @@ #! /bin/sh # Configuration validation subroutine script. -# Copyright 1992-2014 Free Software Foundation, Inc. +# Copyright 1992-2015 Free Software Foundation, Inc. -timestamp='2014-07-28' +timestamp='2015-01-01' # This file is free software; you can redistribute it and/or modify it # under the terms of the GNU General Public License as published by @@ -25,7 +25,7 @@ timestamp='2014-07-28' # of the GNU General Public License, version 3 ("GPLv3"). -# Please send patches with a ChangeLog entry to config-patches@gnu.org. +# Please send patches to . # # Configuration subroutine to validate and canonicalize a configuration type. # Supply the specified configuration type as an argument. @@ -68,7 +68,7 @@ Report bugs and patches to ." version="\ GNU config.sub ($timestamp) -Copyright 1992-2014 Free Software Foundation, Inc. +Copyright 1992-2015 Free Software Foundation, Inc. This is free software; see the source for copying conditions. There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE." @@ -260,7 +260,7 @@ case $basic_machine in | c4x | c8051 | clipper \ | d10v | d30v | dlx | dsp16xx \ | epiphany \ - | fido | fr30 | frv \ + | fido | fr30 | frv | ft32 \ | h8300 | h8500 | hppa | hppa1.[01] | hppa2.0 | hppa2.0[nw] | hppa64 \ | hexagon \ | i370 | i860 | i960 | ia64 \ @@ -302,6 +302,7 @@ case $basic_machine in | pdp10 | pdp11 | pj | pjl \ | powerpc | powerpc64 | powerpc64le | powerpcle \ | pyramid \ + | riscv32 | riscv64 \ | rl78 | rx \ | score \ | sh | sh[1234] | sh[24]a | sh[24]aeb | sh[23]e | sh[34]eb | sheb | shbe | shle | sh[1234]le | sh3ele \ @@ -312,6 +313,7 @@ case $basic_machine in | tahoe | tic4x | tic54x | tic55x | tic6x | tic80 | tron \ | ubicom32 \ | v850 | v850e | v850e1 | v850e2 | v850es | v850e2v3 \ + | visium \ | we32k \ | x86 | xc16x | xstormy16 | xtensa \ | z8k | z80) @@ -326,6 +328,9 @@ case $basic_machine in c6x) basic_machine=tic6x-unknown ;; + leon|leon[3-9]) + basic_machine=sparc-$basic_machine + ;; m6811 | m68hc11 | m6812 | m68hc12 | m68hcs12x | nvptx | picochip) basic_machine=$basic_machine-unknown os=-none @@ -436,6 +441,7 @@ case $basic_machine in | ubicom32-* \ | v850-* | v850e-* | v850e1-* | v850es-* | v850e2-* | v850e2v3-* \ | vax-* \ + | visium-* \ | we32k-* \ | x86-* | x86_64-* | xc16x-* | xps100-* \ | xstormy16-* | xtensa*-* \ @@ -773,6 +779,9 @@ case $basic_machine in basic_machine=m68k-isi os=-sysv ;; + leon-*|leon[3-9]-*) + basic_machine=sparc-`echo $basic_machine | sed 's/-.*//'` + ;; m68knommu) basic_machine=m68k-unknown os=-linux diff --git a/build-aux/depcomp b/build-aux/depcomp index 4ebd5b3a..fc98710e 100755 --- a/build-aux/depcomp +++ b/build-aux/depcomp @@ -3,7 +3,7 @@ scriptversion=2013-05-30.07; # UTC -# Copyright (C) 1999-2013 Free Software Foundation, Inc. +# Copyright (C) 1999-2014 Free Software Foundation, Inc. # This program is free software; you can redistribute it and/or modify # it under the terms of the GNU General Public License as published by diff --git a/build-aux/install-sh b/build-aux/install-sh index 377bb868..0b0fdcbb 100755 --- a/build-aux/install-sh +++ b/build-aux/install-sh @@ -1,7 +1,7 @@ #!/bin/sh # install - install a program, script, or datafile -scriptversion=2011-11-20.07; # UTC +scriptversion=2013-12-25.23; # UTC # This originates from X11R5 (mit/util/scripts/install.sh), which was # later released in X11R6 (xc/config/util/install.sh) with the @@ -41,19 +41,15 @@ scriptversion=2011-11-20.07; # UTC # This script is compatible with the BSD install script, but was written # from scratch. +tab=' ' nl=' ' -IFS=" "" $nl" +IFS=" $tab$nl" -# set DOITPROG to echo to test this script +# Set DOITPROG to "echo" to test this script. -# Don't use :- since 4.3BSD and earlier shells don't like it. doit=${DOITPROG-} -if test -z "$doit"; then - doit_exec=exec -else - doit_exec=$doit -fi +doit_exec=${doit:-exec} # Put in absolute file names if you don't have them in your path; # or use environment vars. @@ -68,17 +64,6 @@ mvprog=${MVPROG-mv} rmprog=${RMPROG-rm} stripprog=${STRIPPROG-strip} -posix_glob='?' -initialize_posix_glob=' - test "$posix_glob" != "?" || { - if (set -f) 2>/dev/null; then - posix_glob= - else - posix_glob=: - fi - } -' - posix_mkdir= # Desired mode of installed file. @@ -97,7 +82,7 @@ dir_arg= dst_arg= copy_on_change=false -no_target_directory= +is_target_a_directory=possibly usage="\ Usage: $0 [OPTION]... [-T] SRCFILE DSTFILE @@ -137,46 +122,57 @@ while test $# -ne 0; do -d) dir_arg=true;; -g) chgrpcmd="$chgrpprog $2" - shift;; + shift;; --help) echo "$usage"; exit $?;; -m) mode=$2 - case $mode in - *' '* | *' '* | *' -'* | *'*'* | *'?'* | *'['*) - echo "$0: invalid mode: $mode" >&2 - exit 1;; - esac - shift;; + case $mode in + *' '* | *"$tab"* | *"$nl"* | *'*'* | *'?'* | *'['*) + echo "$0: invalid mode: $mode" >&2 + exit 1;; + esac + shift;; -o) chowncmd="$chownprog $2" - shift;; + shift;; -s) stripcmd=$stripprog;; - -t) dst_arg=$2 - # Protect names problematic for 'test' and other utilities. - case $dst_arg in - -* | [=\(\)!]) dst_arg=./$dst_arg;; - esac - shift;; + -t) + is_target_a_directory=always + dst_arg=$2 + # Protect names problematic for 'test' and other utilities. + case $dst_arg in + -* | [=\(\)!]) dst_arg=./$dst_arg;; + esac + shift;; - -T) no_target_directory=true;; + -T) is_target_a_directory=never;; --version) echo "$0 $scriptversion"; exit $?;; - --) shift - break;; + --) shift + break;; - -*) echo "$0: invalid option: $1" >&2 - exit 1;; + -*) echo "$0: invalid option: $1" >&2 + exit 1;; *) break;; esac shift done +# We allow the use of options -d and -T together, by making -d +# take the precedence; this is for compatibility with GNU install. + +if test -n "$dir_arg"; then + if test -n "$dst_arg"; then + echo "$0: target directory not allowed when installing a directory." >&2 + exit 1 + fi +fi + if test $# -ne 0 && test -z "$dir_arg$dst_arg"; then # When -d is used, all remaining arguments are directories to create. # When -t is used, the destination is already specified. @@ -207,6 +203,15 @@ if test $# -eq 0; then exit 0 fi +if test -z "$dir_arg"; then + if test $# -gt 1 || test "$is_target_a_directory" = always; then + if test ! -d "$dst_arg"; then + echo "$0: $dst_arg: Is not a directory." >&2 + exit 1 + fi + fi +fi + if test -z "$dir_arg"; then do_exit='(exit $ret); exit $ret' trap "ret=129; $do_exit" 1 @@ -223,16 +228,16 @@ if test -z "$dir_arg"; then *[0-7]) if test -z "$stripcmd"; then - u_plus_rw= + u_plus_rw= else - u_plus_rw='% 200' + u_plus_rw='% 200' fi cp_umask=`expr '(' 777 - $mode % 1000 ')' $u_plus_rw`;; *) if test -z "$stripcmd"; then - u_plus_rw= + u_plus_rw= else - u_plus_rw=,u+rw + u_plus_rw=,u+rw fi cp_umask=$mode$u_plus_rw;; esac @@ -269,41 +274,15 @@ do # If destination is a directory, append the input filename; won't work # if double slashes aren't ignored. if test -d "$dst"; then - if test -n "$no_target_directory"; then - echo "$0: $dst_arg: Is a directory" >&2 - exit 1 + if test "$is_target_a_directory" = never; then + echo "$0: $dst_arg: Is a directory" >&2 + exit 1 fi dstdir=$dst dst=$dstdir/`basename "$src"` dstdir_status=0 else - # Prefer dirname, but fall back on a substitute if dirname fails. - dstdir=` - (dirname "$dst") 2>/dev/null || - expr X"$dst" : 'X\(.*[^/]\)//*[^/][^/]*/*$' \| \ - X"$dst" : 'X\(//\)[^/]' \| \ - X"$dst" : 'X\(//\)$' \| \ - X"$dst" : 'X\(/\)' \| . 2>/dev/null || - echo X"$dst" | - sed '/^X\(.*[^/]\)\/\/*[^/][^/]*\/*$/{ - s//\1/ - q - } - /^X\(\/\/\)[^/].*/{ - s//\1/ - q - } - /^X\(\/\/\)$/{ - s//\1/ - q - } - /^X\(\/\).*/{ - s//\1/ - q - } - s/.*/./; q' - ` - + dstdir=`dirname "$dst"` test -d "$dstdir" dstdir_status=$? fi @@ -314,74 +293,74 @@ do if test $dstdir_status != 0; then case $posix_mkdir in '') - # Create intermediate dirs using mode 755 as modified by the umask. - # This is like FreeBSD 'install' as of 1997-10-28. - umask=`umask` - case $stripcmd.$umask in - # Optimize common cases. - *[2367][2367]) mkdir_umask=$umask;; - .*0[02][02] | .[02][02] | .[02]) mkdir_umask=22;; - - *[0-7]) - mkdir_umask=`expr $umask + 22 \ - - $umask % 100 % 40 + $umask % 20 \ - - $umask % 10 % 4 + $umask % 2 - `;; - *) mkdir_umask=$umask,go-w;; - esac - - # With -d, create the new directory with the user-specified mode. - # Otherwise, rely on $mkdir_umask. - if test -n "$dir_arg"; then - mkdir_mode=-m$mode - else - mkdir_mode= - fi - - posix_mkdir=false - case $umask in - *[123567][0-7][0-7]) - # POSIX mkdir -p sets u+wx bits regardless of umask, which - # is incompatible with FreeBSD 'install' when (umask & 300) != 0. - ;; - *) - tmpdir=${TMPDIR-/tmp}/ins$RANDOM-$$ - trap 'ret=$?; rmdir "$tmpdir/d" "$tmpdir" 2>/dev/null; exit $ret' 0 - - if (umask $mkdir_umask && - exec $mkdirprog $mkdir_mode -p -- "$tmpdir/d") >/dev/null 2>&1 - then - if test -z "$dir_arg" || { - # Check for POSIX incompatibilities with -m. - # HP-UX 11.23 and IRIX 6.5 mkdir -m -p sets group- or - # other-writable bit of parent directory when it shouldn't. - # FreeBSD 6.1 mkdir -m -p sets mode of existing directory. - ls_ld_tmpdir=`ls -ld "$tmpdir"` - case $ls_ld_tmpdir in - d????-?r-*) different_mode=700;; - d????-?--*) different_mode=755;; - *) false;; - esac && - $mkdirprog -m$different_mode -p -- "$tmpdir" && { - ls_ld_tmpdir_1=`ls -ld "$tmpdir"` - test "$ls_ld_tmpdir" = "$ls_ld_tmpdir_1" - } - } - then posix_mkdir=: - fi - rmdir "$tmpdir/d" "$tmpdir" - else - # Remove any dirs left behind by ancient mkdir implementations. - rmdir ./$mkdir_mode ./-p ./-- 2>/dev/null - fi - trap '' 0;; - esac;; + # Create intermediate dirs using mode 755 as modified by the umask. + # This is like FreeBSD 'install' as of 1997-10-28. + umask=`umask` + case $stripcmd.$umask in + # Optimize common cases. + *[2367][2367]) mkdir_umask=$umask;; + .*0[02][02] | .[02][02] | .[02]) mkdir_umask=22;; + + *[0-7]) + mkdir_umask=`expr $umask + 22 \ + - $umask % 100 % 40 + $umask % 20 \ + - $umask % 10 % 4 + $umask % 2 + `;; + *) mkdir_umask=$umask,go-w;; + esac + + # With -d, create the new directory with the user-specified mode. + # Otherwise, rely on $mkdir_umask. + if test -n "$dir_arg"; then + mkdir_mode=-m$mode + else + mkdir_mode= + fi + + posix_mkdir=false + case $umask in + *[123567][0-7][0-7]) + # POSIX mkdir -p sets u+wx bits regardless of umask, which + # is incompatible with FreeBSD 'install' when (umask & 300) != 0. + ;; + *) + tmpdir=${TMPDIR-/tmp}/ins$RANDOM-$$ + trap 'ret=$?; rmdir "$tmpdir/d" "$tmpdir" 2>/dev/null; exit $ret' 0 + + if (umask $mkdir_umask && + exec $mkdirprog $mkdir_mode -p -- "$tmpdir/d") >/dev/null 2>&1 + then + if test -z "$dir_arg" || { + # Check for POSIX incompatibilities with -m. + # HP-UX 11.23 and IRIX 6.5 mkdir -m -p sets group- or + # other-writable bit of parent directory when it shouldn't. + # FreeBSD 6.1 mkdir -m -p sets mode of existing directory. + ls_ld_tmpdir=`ls -ld "$tmpdir"` + case $ls_ld_tmpdir in + d????-?r-*) different_mode=700;; + d????-?--*) different_mode=755;; + *) false;; + esac && + $mkdirprog -m$different_mode -p -- "$tmpdir" && { + ls_ld_tmpdir_1=`ls -ld "$tmpdir"` + test "$ls_ld_tmpdir" = "$ls_ld_tmpdir_1" + } + } + then posix_mkdir=: + fi + rmdir "$tmpdir/d" "$tmpdir" + else + # Remove any dirs left behind by ancient mkdir implementations. + rmdir ./$mkdir_mode ./-p ./-- 2>/dev/null + fi + trap '' 0;; + esac;; esac if $posix_mkdir && ( - umask $mkdir_umask && - $doit_exec $mkdirprog $mkdir_mode -p -- "$dstdir" + umask $mkdir_umask && + $doit_exec $mkdirprog $mkdir_mode -p -- "$dstdir" ) then : else @@ -391,53 +370,51 @@ do # directory the slow way, step by step, checking for races as we go. case $dstdir in - /*) prefix='/';; - [-=\(\)!]*) prefix='./';; - *) prefix='';; + /*) prefix='/';; + [-=\(\)!]*) prefix='./';; + *) prefix='';; esac - eval "$initialize_posix_glob" - oIFS=$IFS IFS=/ - $posix_glob set -f + set -f set fnord $dstdir shift - $posix_glob set +f + set +f IFS=$oIFS prefixes= for d do - test X"$d" = X && continue - - prefix=$prefix$d - if test -d "$prefix"; then - prefixes= - else - if $posix_mkdir; then - (umask=$mkdir_umask && - $doit_exec $mkdirprog $mkdir_mode -p -- "$dstdir") && break - # Don't fail if two instances are running concurrently. - test -d "$prefix" || exit 1 - else - case $prefix in - *\'*) qprefix=`echo "$prefix" | sed "s/'/'\\\\\\\\''/g"`;; - *) qprefix=$prefix;; - esac - prefixes="$prefixes '$qprefix'" - fi - fi - prefix=$prefix/ + test X"$d" = X && continue + + prefix=$prefix$d + if test -d "$prefix"; then + prefixes= + else + if $posix_mkdir; then + (umask=$mkdir_umask && + $doit_exec $mkdirprog $mkdir_mode -p -- "$dstdir") && break + # Don't fail if two instances are running concurrently. + test -d "$prefix" || exit 1 + else + case $prefix in + *\'*) qprefix=`echo "$prefix" | sed "s/'/'\\\\\\\\''/g"`;; + *) qprefix=$prefix;; + esac + prefixes="$prefixes '$qprefix'" + fi + fi + prefix=$prefix/ done if test -n "$prefixes"; then - # Don't fail if two instances are running concurrently. - (umask $mkdir_umask && - eval "\$doit_exec \$mkdirprog $prefixes") || - test -d "$dstdir" || exit 1 - obsolete_mkdir_used=true + # Don't fail if two instances are running concurrently. + (umask $mkdir_umask && + eval "\$doit_exec \$mkdirprog $prefixes") || + test -d "$dstdir" || exit 1 + obsolete_mkdir_used=true fi fi fi @@ -472,15 +449,12 @@ do # If -C, don't bother to copy if it wouldn't change the file. if $copy_on_change && - old=`LC_ALL=C ls -dlL "$dst" 2>/dev/null` && - new=`LC_ALL=C ls -dlL "$dsttmp" 2>/dev/null` && - - eval "$initialize_posix_glob" && - $posix_glob set -f && + old=`LC_ALL=C ls -dlL "$dst" 2>/dev/null` && + new=`LC_ALL=C ls -dlL "$dsttmp" 2>/dev/null` && + set -f && set X $old && old=:$2:$4:$5:$6 && set X $new && new=:$2:$4:$5:$6 && - $posix_glob set +f && - + set +f && test "$old" = "$new" && $cmpprog "$dst" "$dsttmp" >/dev/null 2>&1 then @@ -493,24 +467,24 @@ do # to itself, or perhaps because mv is so ancient that it does not # support -f. { - # Now remove or move aside any old file at destination location. - # We try this two ways since rm can't unlink itself on some - # systems and the destination file might be busy for other - # reasons. In this case, the final cleanup might fail but the new - # file should still install successfully. - { - test ! -f "$dst" || - $doit $rmcmd -f "$dst" 2>/dev/null || - { $doit $mvcmd -f "$dst" "$rmtmp" 2>/dev/null && - { $doit $rmcmd -f "$rmtmp" 2>/dev/null; :; } - } || - { echo "$0: cannot unlink or rename $dst" >&2 - (exit 1); exit 1 - } - } && - - # Now rename the file to the real destination. - $doit $mvcmd "$dsttmp" "$dst" + # Now remove or move aside any old file at destination location. + # We try this two ways since rm can't unlink itself on some + # systems and the destination file might be busy for other + # reasons. In this case, the final cleanup might fail but the new + # file should still install successfully. + { + test ! -f "$dst" || + $doit $rmcmd -f "$dst" 2>/dev/null || + { $doit $mvcmd -f "$dst" "$rmtmp" 2>/dev/null && + { $doit $rmcmd -f "$rmtmp" 2>/dev/null; :; } + } || + { echo "$0: cannot unlink or rename $dst" >&2 + (exit 1); exit 1 + } + } && + + # Now rename the file to the real destination. + $doit $mvcmd "$dsttmp" "$dst" } fi || exit 1 diff --git a/build-aux/missing b/build-aux/missing index cdea5149..f62bbae3 100755 --- a/build-aux/missing +++ b/build-aux/missing @@ -1,9 +1,9 @@ #! /bin/sh # Common wrapper for a few potentially missing GNU programs. -scriptversion=2012-06-26.16; # UTC +scriptversion=2013-10-28.13; # UTC -# Copyright (C) 1996-2013 Free Software Foundation, Inc. +# Copyright (C) 1996-2014 Free Software Foundation, Inc. # Originally written by Fran,cois Pinard , 1996. # This program is free software; you can redistribute it and/or modify @@ -160,7 +160,7 @@ give_advice () ;; autom4te*) echo "You might have modified some maintainer files that require" - echo "the 'automa4te' program to be rebuilt." + echo "the 'autom4te' program to be rebuilt." program_details 'autom4te' ;; bison*|yacc*) diff --git a/callouts/Makefile.in b/callouts/Makefile.in index 83151fcc..7e5c1f87 100644 --- a/callouts/Makefile.in +++ b/callouts/Makefile.in @@ -1,7 +1,7 @@ -# Makefile.in generated by automake 1.13.4 from Makefile.am. +# Makefile.in generated by automake 1.15 from Makefile.am. # @configure_input@ -# Copyright (C) 1994-2013 Free Software Foundation, Inc. +# Copyright (C) 1994-2014 Free Software Foundation, Inc. # This Makefile.in is free software; the Free Software Foundation # gives unlimited permission to copy and/or distribute it, @@ -17,7 +17,17 @@ VPATH = @srcdir@ -am__is_gnu_make = test -n '$(MAKEFILE_LIST)' && test -n '$(MAKELEVEL)' +am__is_gnu_make = { \ + if test -z '$(MAKELEVEL)'; then \ + false; \ + elif test -n '$(MAKE_HOST)'; then \ + true; \ + elif test -n '$(MAKE_VERSION)' && test -n '$(CURDIR)'; then \ + true; \ + else \ + false; \ + fi; \ +} am__make_running_with_option = \ case $${target_option-} in \ ?) ;; \ @@ -83,8 +93,6 @@ host_triplet = @host@ libexec_PROGRAMS = nm-dispatcher$(EXEEXT) \ nm-avahi-autoipd.action$(EXEEXT) subdir = callouts -DIST_COMMON = $(srcdir)/Makefile.in $(srcdir)/Makefile.am \ - $(top_srcdir)/build-aux/depcomp ACLOCAL_M4 = $(top_srcdir)/aclocal.m4 am__aclocal_m4_deps = $(top_srcdir)/m4/ax_lib_readline.m4 \ $(top_srcdir)/m4/compiler_warnings.m4 \ @@ -101,6 +109,7 @@ am__aclocal_m4_deps = $(top_srcdir)/m4/ax_lib_readline.m4 \ $(top_srcdir)/m4/vapigen.m4 $(top_srcdir)/configure.ac am__configure_deps = $(am__aclocal_m4_deps) $(CONFIGURE_DEPENDENCIES) \ $(ACLOCAL_M4) +DIST_COMMON = $(srcdir)/Makefile.am $(am__DIST_COMMON) mkinstalldirs = $(install_sh) -d CONFIG_HEADER = $(top_builddir)/config.h CONFIG_CLEAN_FILES = @@ -245,6 +254,8 @@ am__define_uniq_tagged_files = \ ETAGS = etags CTAGS = ctags DIST_SUBDIRS = $(SUBDIRS) +am__DIST_COMMON = $(srcdir)/Makefile.in \ + $(top_srcdir)/build-aux/depcomp DISTFILES = $(DIST_COMMON) $(DIST_SOURCES) $(TEXINFOS) $(EXTRA_DIST) am__relativize = \ dir0=`pwd`; \ @@ -296,7 +307,6 @@ CXXCPP = @CXXCPP@ CXXDEPMODE = @CXXDEPMODE@ CXXFLAGS = @CXXFLAGS@ CYGPATH_W = @CYGPATH_W@ -DATADIRNAME = @DATADIRNAME@ DBUS_CFLAGS = @DBUS_CFLAGS@ DBUS_GLIB_100_CFLAGS = @DBUS_GLIB_100_CFLAGS@ DBUS_GLIB_100_LIBS = @DBUS_GLIB_100_LIBS@ @@ -331,6 +341,7 @@ GNUTLS_CFLAGS = @GNUTLS_CFLAGS@ GNUTLS_LIBS = @GNUTLS_LIBS@ GREP = @GREP@ GTKDOC_CHECK = @GTKDOC_CHECK@ +GTKDOC_CHECK_PATH = @GTKDOC_CHECK_PATH@ GTKDOC_DEPS_CFLAGS = @GTKDOC_DEPS_CFLAGS@ GTKDOC_DEPS_LIBS = @GTKDOC_DEPS_LIBS@ GTKDOC_MKPDF = @GTKDOC_MKPDF@ @@ -632,7 +643,6 @@ $(srcdir)/Makefile.in: @MAINTAINER_MODE_TRUE@ $(srcdir)/Makefile.am $(am__confi echo ' cd $(top_srcdir) && $(AUTOMAKE) --gnu callouts/Makefile'; \ $(am__cd) $(top_srcdir) && \ $(AUTOMAKE) --gnu callouts/Makefile -.PRECIOUS: Makefile Makefile: $(srcdir)/Makefile.in $(top_builddir)/config.status @case '$?' in \ *config.status*) \ @@ -742,14 +752,14 @@ distclean-compile: @am__fastdepCC_TRUE@ $(AM_V_at)$(am__mv) $(DEPDIR)/$*.Tpo $(DEPDIR)/$*.Po @AMDEP_TRUE@@am__fastdepCC_FALSE@ $(AM_V_CC)source='$<' object='$@' libtool=no @AMDEPBACKSLASH@ @AMDEP_TRUE@@am__fastdepCC_FALSE@ DEPDIR=$(DEPDIR) $(CCDEPMODE) $(depcomp) @AMDEPBACKSLASH@ -@am__fastdepCC_FALSE@ $(AM_V_CC@am__nodep@)$(COMPILE) -c $< +@am__fastdepCC_FALSE@ $(AM_V_CC@am__nodep@)$(COMPILE) -c -o $@ $< .c.obj: @am__fastdepCC_TRUE@ $(AM_V_CC)$(COMPILE) -MT $@ -MD -MP -MF $(DEPDIR)/$*.Tpo -c -o $@ `$(CYGPATH_W) '$<'` @am__fastdepCC_TRUE@ $(AM_V_at)$(am__mv) $(DEPDIR)/$*.Tpo $(DEPDIR)/$*.Po @AMDEP_TRUE@@am__fastdepCC_FALSE@ $(AM_V_CC)source='$<' object='$@' libtool=no @AMDEPBACKSLASH@ @AMDEP_TRUE@@am__fastdepCC_FALSE@ DEPDIR=$(DEPDIR) $(CCDEPMODE) $(depcomp) @AMDEPBACKSLASH@ -@am__fastdepCC_FALSE@ $(AM_V_CC@am__nodep@)$(COMPILE) -c `$(CYGPATH_W) '$<'` +@am__fastdepCC_FALSE@ $(AM_V_CC@am__nodep@)$(COMPILE) -c -o $@ `$(CYGPATH_W) '$<'` .c.lo: @am__fastdepCC_TRUE@ $(AM_V_CC)$(LTCOMPILE) -MT $@ -MD -MP -MF $(DEPDIR)/$*.Tpo -c -o $@ $< @@ -1133,6 +1143,8 @@ uninstall-am: uninstall-dbusactivationDATA uninstall-dbusserviceDATA \ uninstall-dbusactivationDATA uninstall-dbusserviceDATA \ uninstall-libexecPROGRAMS uninstall-udevrulesDATA +.PRECIOUS: Makefile + nmdbus-dispatcher.h: nm-dispatcher.xml $(AM_V_GEN) gdbus-codegen \ diff --git a/callouts/nm-dispatcher-api.h b/callouts/nm-dispatcher-api.h index df1bced4..9b2c3b32 100644 --- a/callouts/nm-dispatcher-api.h +++ b/callouts/nm-dispatcher-api.h @@ -31,6 +31,7 @@ #define NM_DISPATCHER_DBUS_PATH "/org/freedesktop/nm_dispatcher" #define NMD_CONNECTION_PROPS_PATH "path" +#define NMD_CONNECTION_PROPS_FILENAME "filename" #define NMD_DEVICE_PROPS_INTERFACE "interface" #define NMD_DEVICE_PROPS_IP_INTERFACE "ip-interface" diff --git a/callouts/nm-dispatcher-utils.c b/callouts/nm-dispatcher-utils.c index 99616c1a..d8a8e8d8 100644 --- a/callouts/nm-dispatcher-utils.c +++ b/callouts/nm-dispatcher-utils.c @@ -210,6 +210,7 @@ construct_device_dhcp4_items (GSList *items, GVariant *dhcp4_config) tmp = g_variant_get_string (val, NULL); items = g_slist_prepend (items, g_strdup_printf ("DHCP4_%s=%s", ucased, tmp)); g_free (ucased); + g_variant_unref (val); } return items; } @@ -334,6 +335,7 @@ nm_dispatcher_utils_construct_envp (const char *action, { const char *iface = NULL, *ip_iface = NULL; const char *uuid = NULL, *id = NULL, *path; + const char *filename = NULL; NMDeviceState dev_state = NM_DEVICE_STATE_UNKNOWN; GVariant *value; char **envp = NULL, *path_item; @@ -349,6 +351,10 @@ nm_dispatcher_utils_construct_envp (const char *action, if (!strcmp (action, "hostname")) goto done; + /* config filename */ + if (g_variant_lookup (connection_props, NMD_CONNECTION_PROPS_FILENAME, "&s", &filename)) + items = g_slist_prepend (items, g_strdup_printf ("CONNECTION_FILENAME=%s", filename)); + /* Canonicalize the VPN interface name; "" is used when passing it through * D-Bus so make sure that's fixed up here. */ diff --git a/callouts/tests/Makefile.am b/callouts/tests/Makefile.am index f8fd82b7..fface33d 100644 --- a/callouts/tests/Makefile.am +++ b/callouts/tests/Makefile.am @@ -28,12 +28,13 @@ test_dispatcher_envp_LDADD = \ ########################################### +@VALGRIND_RULES@ TESTS = test-dispatcher-envp endif EXTRA_DIST= \ - dispatcher-old-down \ - dispatcher-old-up \ - dispatcher-old-vpn-down \ - dispatcher-old-vpn-up + dispatcher-down \ + dispatcher-up \ + dispatcher-vpn-down \ + dispatcher-vpn-up diff --git a/callouts/tests/Makefile.in b/callouts/tests/Makefile.in index 5372e352..bd3241ce 100644 --- a/callouts/tests/Makefile.in +++ b/callouts/tests/Makefile.in @@ -1,7 +1,7 @@ -# Makefile.in generated by automake 1.13.4 from Makefile.am. +# Makefile.in generated by automake 1.15 from Makefile.am. # @configure_input@ -# Copyright (C) 1994-2013 Free Software Foundation, Inc. +# Copyright (C) 1994-2014 Free Software Foundation, Inc. # This Makefile.in is free software; the Free Software Foundation # gives unlimited permission to copy and/or distribute it, @@ -15,7 +15,17 @@ @SET_MAKE@ VPATH = @srcdir@ -am__is_gnu_make = test -n '$(MAKEFILE_LIST)' && test -n '$(MAKELEVEL)' +am__is_gnu_make = { \ + if test -z '$(MAKELEVEL)'; then \ + false; \ + elif test -n '$(MAKE_HOST)'; then \ + true; \ + elif test -n '$(MAKE_VERSION)' && test -n '$(CURDIR)'; then \ + true; \ + else \ + false; \ + fi; \ +} am__make_running_with_option = \ case $${target_option-} in \ ?) ;; \ @@ -81,8 +91,6 @@ host_triplet = @host@ @ENABLE_TESTS_TRUE@noinst_PROGRAMS = test-dispatcher-envp$(EXEEXT) @ENABLE_TESTS_TRUE@TESTS = test-dispatcher-envp$(EXEEXT) subdir = callouts/tests -DIST_COMMON = $(srcdir)/Makefile.in $(srcdir)/Makefile.am \ - $(top_srcdir)/build-aux/depcomp ACLOCAL_M4 = $(top_srcdir)/aclocal.m4 am__aclocal_m4_deps = $(top_srcdir)/m4/ax_lib_readline.m4 \ $(top_srcdir)/m4/compiler_warnings.m4 \ @@ -99,6 +107,7 @@ am__aclocal_m4_deps = $(top_srcdir)/m4/ax_lib_readline.m4 \ $(top_srcdir)/m4/vapigen.m4 $(top_srcdir)/configure.ac am__configure_deps = $(am__aclocal_m4_deps) $(CONFIGURE_DEPENDENCIES) \ $(ACLOCAL_M4) +DIST_COMMON = $(srcdir)/Makefile.am $(am__DIST_COMMON) mkinstalldirs = $(install_sh) -d CONFIG_HEADER = $(top_builddir)/config.h CONFIG_CLEAN_FILES = @@ -199,6 +208,8 @@ am__tty_colors = { \ std=''; \ fi; \ } +am__DIST_COMMON = $(srcdir)/Makefile.in \ + $(top_srcdir)/build-aux/depcomp DISTFILES = $(DIST_COMMON) $(DIST_SOURCES) $(TEXINFOS) $(EXTRA_DIST) ACLOCAL = @ACLOCAL@ ALL_LINGUAS = @ALL_LINGUAS@ @@ -225,7 +236,6 @@ CXXCPP = @CXXCPP@ CXXDEPMODE = @CXXDEPMODE@ CXXFLAGS = @CXXFLAGS@ CYGPATH_W = @CYGPATH_W@ -DATADIRNAME = @DATADIRNAME@ DBUS_CFLAGS = @DBUS_CFLAGS@ DBUS_GLIB_100_CFLAGS = @DBUS_GLIB_100_CFLAGS@ DBUS_GLIB_100_LIBS = @DBUS_GLIB_100_LIBS@ @@ -260,6 +270,7 @@ GNUTLS_CFLAGS = @GNUTLS_CFLAGS@ GNUTLS_LIBS = @GNUTLS_LIBS@ GREP = @GREP@ GTKDOC_CHECK = @GTKDOC_CHECK@ +GTKDOC_CHECK_PATH = @GTKDOC_CHECK_PATH@ GTKDOC_DEPS_CFLAGS = @GTKDOC_DEPS_CFLAGS@ GTKDOC_DEPS_LIBS = @GTKDOC_DEPS_LIBS@ GTKDOC_MKPDF = @GTKDOC_MKPDF@ @@ -484,10 +495,10 @@ with_valgrind = @with_valgrind@ @ENABLE_TESTS_TRUE@ $(DBUS_LIBS) EXTRA_DIST = \ - dispatcher-old-down \ - dispatcher-old-up \ - dispatcher-old-vpn-down \ - dispatcher-old-vpn-up + dispatcher-down \ + dispatcher-up \ + dispatcher-vpn-down \ + dispatcher-vpn-up all: all-am @@ -505,7 +516,6 @@ $(srcdir)/Makefile.in: @MAINTAINER_MODE_TRUE@ $(srcdir)/Makefile.am $(am__confi echo ' cd $(top_srcdir) && $(AUTOMAKE) --gnu callouts/tests/Makefile'; \ $(am__cd) $(top_srcdir) && \ $(AUTOMAKE) --gnu callouts/tests/Makefile -.PRECIOUS: Makefile Makefile: $(srcdir)/Makefile.in $(top_builddir)/config.status @case '$?' in \ *config.status*) \ @@ -550,14 +560,14 @@ distclean-compile: @am__fastdepCC_TRUE@ $(AM_V_at)$(am__mv) $(DEPDIR)/$*.Tpo $(DEPDIR)/$*.Po @AMDEP_TRUE@@am__fastdepCC_FALSE@ $(AM_V_CC)source='$<' object='$@' libtool=no @AMDEPBACKSLASH@ @AMDEP_TRUE@@am__fastdepCC_FALSE@ DEPDIR=$(DEPDIR) $(CCDEPMODE) $(depcomp) @AMDEPBACKSLASH@ -@am__fastdepCC_FALSE@ $(AM_V_CC@am__nodep@)$(COMPILE) -c $< +@am__fastdepCC_FALSE@ $(AM_V_CC@am__nodep@)$(COMPILE) -c -o $@ $< .c.obj: @am__fastdepCC_TRUE@ $(AM_V_CC)$(COMPILE) -MT $@ -MD -MP -MF $(DEPDIR)/$*.Tpo -c -o $@ `$(CYGPATH_W) '$<'` @am__fastdepCC_TRUE@ $(AM_V_at)$(am__mv) $(DEPDIR)/$*.Tpo $(DEPDIR)/$*.Po @AMDEP_TRUE@@am__fastdepCC_FALSE@ $(AM_V_CC)source='$<' object='$@' libtool=no @AMDEPBACKSLASH@ @AMDEP_TRUE@@am__fastdepCC_FALSE@ DEPDIR=$(DEPDIR) $(CCDEPMODE) $(depcomp) @AMDEPBACKSLASH@ -@am__fastdepCC_FALSE@ $(AM_V_CC@am__nodep@)$(COMPILE) -c `$(CYGPATH_W) '$<'` +@am__fastdepCC_FALSE@ $(AM_V_CC@am__nodep@)$(COMPILE) -c -o $@ `$(CYGPATH_W) '$<'` .c.lo: @am__fastdepCC_TRUE@ $(AM_V_CC)$(LTCOMPILE) -MT $@ -MD -MP -MF $(DEPDIR)/$*.Tpo -c -o $@ $< @@ -869,6 +879,12 @@ uninstall-am: mostlyclean-generic mostlyclean-libtool pdf pdf-am ps ps-am \ tags tags-am uninstall uninstall-am +.PRECIOUS: Makefile + + +########################################### + +@ENABLE_TESTS_TRUE@@VALGRIND_RULES@ # Tell versions [3.59,3.63) of GNU make to not export all variables. # Otherwise a system limit (for SysV at least) may be exceeded. diff --git a/callouts/tests/dispatcher-down b/callouts/tests/dispatcher-down new file mode 100644 index 00000000..da97d3f6 --- /dev/null +++ b/callouts/tests/dispatcher-down @@ -0,0 +1,21 @@ +[main] +action=down +expected-iface=wlan0 +uuid=3fd2a33a-d81b-423f-ae99-e6baba742311 +id=Random Connection + +[device] +state=30 +ip-interface=wlan0 +type=2 +interface=wlan0 +path=/org/freedesktop/NetworkManager/Devices/0 + +[env] +PATH= +CONNECTION_UUID=3fd2a33a-d81b-423f-ae99-e6baba742311 +CONNECTION_ID=Random Connection +CONNECTION_FILENAME=/callouts/tests/dispatcher-down +DEVICE_IFACE=wlan0 +DEVICE_IP_IFACE=wlan0 + diff --git a/callouts/tests/dispatcher-old-down b/callouts/tests/dispatcher-old-down deleted file mode 100644 index 836f3532..00000000 --- a/callouts/tests/dispatcher-old-down +++ /dev/null @@ -1,20 +0,0 @@ -[main] -action=down -expected-iface=wlan0 -uuid=3fd2a33a-d81b-423f-ae99-e6baba742311 -id=Random Connection - -[device] -state=30 -ip-interface=wlan0 -type=2 -interface=wlan0 -path=/org/freedesktop/NetworkManager/Devices/0 - -[env] -PATH= -CONNECTION_UUID=3fd2a33a-d81b-423f-ae99-e6baba742311 -CONNECTION_ID=Random Connection -DEVICE_IFACE=wlan0 -DEVICE_IP_IFACE=wlan0 - diff --git a/callouts/tests/dispatcher-old-up b/callouts/tests/dispatcher-old-up deleted file mode 100644 index 53f35ace..00000000 --- a/callouts/tests/dispatcher-old-up +++ /dev/null @@ -1,57 +0,0 @@ -[main] -action=up -expected-iface=wlan0 -uuid=3fd2a33a-d81b-423f-ae99-e6baba742311 -id=Random Connection - -[device] -state=100 -ip-interface=wlan0 -type=2 -interface=wlan0 -path=/org/freedesktop/NetworkManager/Devices/0 - -[dhcp4] -netbios_name_servers=0.0.0.0 -domain_name_servers=68.87.77.134 68.87.72.134 192.168.1.1 -dhcp_lease_time=86400 -network_number=192.168.1.0 -domain_name=hsd1.mn.comcast.net. -ip_address=192.168.1.119 -dhcp_message_type=5 -dhcp_server_identifier=192.168.1.1 -routers=192.168.1.1 -broadcast_address=192.168.1.255 -subnet_mask=255.255.255.0 -expiry=1304300446 - -[ip4] -addresses=192.168.1.119/24 192.168.1.1 -nameservers=68.87.77.134 68.87.72.134 192.168.1.1 -domains=hsd1.mn.comcast.net. - -[env] -PATH= -CONNECTION_UUID=3fd2a33a-d81b-423f-ae99-e6baba742311 -CONNECTION_ID=Random Connection -DEVICE_IFACE=wlan0 -DEVICE_IP_IFACE=wlan0 -IP4_ADDRESS_0=192.168.1.119/24 192.168.1.1 -IP4_NUM_ADDRESSES=1 -IP4_NAMESERVERS=68.87.77.134 68.87.72.134 192.168.1.1 -IP4_GATEWAY=192.168.1.1 -IP4_DOMAINS=hsd1.mn.comcast.net. -IP4_NUM_ROUTES=0 -DHCP4_NETBIOS_NAME_SERVERS=0.0.0.0 -DHCP4_DOMAIN_NAME_SERVERS=68.87.77.134 68.87.72.134 192.168.1.1 -DHCP4_DHCP_LEASE_TIME=86400 -DHCP4_NETWORK_NUMBER=192.168.1.0 -DHCP4_DOMAIN_NAME=hsd1.mn.comcast.net. -DHCP4_IP_ADDRESS=192.168.1.119 -DHCP4_DHCP_MESSAGE_TYPE=5 -DHCP4_DHCP_SERVER_IDENTIFIER=192.168.1.1 -DHCP4_ROUTERS=192.168.1.1 -DHCP4_BROADCAST_ADDRESS=192.168.1.255 -DHCP4_SUBNET_MASK=255.255.255.0 -DHCP4_EXPIRY=1304300446 - diff --git a/callouts/tests/dispatcher-old-vpn-down b/callouts/tests/dispatcher-old-vpn-down deleted file mode 100644 index 1f1cf2b6..00000000 --- a/callouts/tests/dispatcher-old-vpn-down +++ /dev/null @@ -1,56 +0,0 @@ -[main] -action=vpn-down -expected-iface=tun0 -uuid=355653c0-34d3-4777-ad25-f9a498b7ef8e -id=Random Connection - -[device] -state=100 -ip-interface=tun0 -type=2 -interface=wlan0 -path=/org/freedesktop/NetworkManager/Devices/0 - -[dhcp4] -netbios_name_servers=0.0.0.0 -domain_name_servers=68.87.77.134 68.87.72.134 192.168.1.1 -dhcp_lease_time=86400 -network_number=192.168.1.0 -domain_name=hsd1.mn.comcast.net. -ip_address=192.168.1.119 -dhcp_message_type=5 -dhcp_server_identifier=192.168.1.1 -routers=192.168.1.1 -broadcast_address=192.168.1.255 -subnet_mask=255.255.255.0 -expiry=1304349405 - -[ip4] -addresses=192.168.1.119/24 192.168.1.1 -nameservers=68.87.77.134 68.87.72.134 192.168.1.1 -domains=hsd1.mn.comcast.net. - -[env] -PATH= -CONNECTION_UUID=355653c0-34d3-4777-ad25-f9a498b7ef8e -CONNECTION_ID=Random Connection -DEVICE_IFACE=wlan0 -DEVICE_IP_IFACE=tun0 -IP4_ADDRESS_0=192.168.1.119/24 192.168.1.1 -IP4_NUM_ADDRESSES=1 -IP4_NAMESERVERS=68.87.77.134 68.87.72.134 192.168.1.1 -IP4_GATEWAY=192.168.1.1 -IP4_DOMAINS=hsd1.mn.comcast.net. -IP4_NUM_ROUTES=0 -DHCP4_NETBIOS_NAME_SERVERS=0.0.0.0 -DHCP4_DOMAIN_NAME_SERVERS=68.87.77.134 68.87.72.134 192.168.1.1 -DHCP4_DHCP_LEASE_TIME=86400 -DHCP4_NETWORK_NUMBER=192.168.1.0 -DHCP4_DOMAIN_NAME=hsd1.mn.comcast.net. -DHCP4_IP_ADDRESS=192.168.1.119 -DHCP4_DHCP_MESSAGE_TYPE=5 -DHCP4_DHCP_SERVER_IDENTIFIER=192.168.1.1 -DHCP4_ROUTERS=192.168.1.1 -DHCP4_BROADCAST_ADDRESS=192.168.1.255 -DHCP4_SUBNET_MASK=255.255.255.0 -DHCP4_EXPIRY=1304349405 diff --git a/callouts/tests/dispatcher-old-vpn-up b/callouts/tests/dispatcher-old-vpn-up deleted file mode 100644 index 7cda8a69..00000000 --- a/callouts/tests/dispatcher-old-vpn-up +++ /dev/null @@ -1,56 +0,0 @@ -[main] -action=vpn-up -expected-iface=tun0 -uuid=355653c0-34d3-4777-ad25-f9a498b7ef8e -id=Random Connection - -[device] -state=100 -ip-interface=tun0 -type=2 -interface=wlan0 -path=/org/freedesktop/NetworkManager/Devices/0 - -[dhcp4] -netbios_name_servers=0.0.0.0 -domain_name_servers=68.87.77.134 68.87.72.134 192.168.1.1 -dhcp_lease_time=86400 -network_number=192.168.1.0 -domain_name=hsd1.mn.comcast.net. -ip_address=192.168.1.119 -dhcp_message_type=5 -dhcp_server_identifier=192.168.1.1 -routers=192.168.1.1 -broadcast_address=192.168.1.255 -subnet_mask=255.255.255.0 -expiry=1304349405 - -[ip4] -addresses=192.168.1.119/24 192.168.1.1 -nameservers=68.87.77.134 68.87.72.134 192.168.1.1 -domains=hsd1.mn.comcast.net. - -[env] -PATH= -CONNECTION_UUID=355653c0-34d3-4777-ad25-f9a498b7ef8e -CONNECTION_ID=Random Connection -DEVICE_IFACE=wlan0 -DEVICE_IP_IFACE=tun0 -IP4_ADDRESS_0=192.168.1.119/24 192.168.1.1 -IP4_NUM_ADDRESSES=1 -IP4_NAMESERVERS=68.87.77.134 68.87.72.134 192.168.1.1 -IP4_GATEWAY=192.168.1.1 -IP4_DOMAINS=hsd1.mn.comcast.net. -IP4_NUM_ROUTES=0 -DHCP4_NETBIOS_NAME_SERVERS=0.0.0.0 -DHCP4_DOMAIN_NAME_SERVERS=68.87.77.134 68.87.72.134 192.168.1.1 -DHCP4_DHCP_LEASE_TIME=86400 -DHCP4_NETWORK_NUMBER=192.168.1.0 -DHCP4_DOMAIN_NAME=hsd1.mn.comcast.net. -DHCP4_IP_ADDRESS=192.168.1.119 -DHCP4_DHCP_MESSAGE_TYPE=5 -DHCP4_DHCP_SERVER_IDENTIFIER=192.168.1.1 -DHCP4_ROUTERS=192.168.1.1 -DHCP4_BROADCAST_ADDRESS=192.168.1.255 -DHCP4_SUBNET_MASK=255.255.255.0 -DHCP4_EXPIRY=1304349405 diff --git a/callouts/tests/dispatcher-up b/callouts/tests/dispatcher-up new file mode 100644 index 00000000..78cfadad --- /dev/null +++ b/callouts/tests/dispatcher-up @@ -0,0 +1,58 @@ +[main] +action=up +expected-iface=wlan0 +uuid=3fd2a33a-d81b-423f-ae99-e6baba742311 +id=Random Connection + +[device] +state=100 +ip-interface=wlan0 +type=2 +interface=wlan0 +path=/org/freedesktop/NetworkManager/Devices/0 + +[dhcp4] +netbios_name_servers=0.0.0.0 +domain_name_servers=68.87.77.134 68.87.72.134 192.168.1.1 +dhcp_lease_time=86400 +network_number=192.168.1.0 +domain_name=hsd1.mn.comcast.net. +ip_address=192.168.1.119 +dhcp_message_type=5 +dhcp_server_identifier=192.168.1.1 +routers=192.168.1.1 +broadcast_address=192.168.1.255 +subnet_mask=255.255.255.0 +expiry=1304300446 + +[ip4] +addresses=192.168.1.119/24 192.168.1.1 +nameservers=68.87.77.134 68.87.72.134 192.168.1.1 +domains=hsd1.mn.comcast.net. + +[env] +PATH= +CONNECTION_UUID=3fd2a33a-d81b-423f-ae99-e6baba742311 +CONNECTION_ID=Random Connection +CONNECTION_FILENAME=/callouts/tests/dispatcher-up +DEVICE_IFACE=wlan0 +DEVICE_IP_IFACE=wlan0 +IP4_ADDRESS_0=192.168.1.119/24 192.168.1.1 +IP4_NUM_ADDRESSES=1 +IP4_NAMESERVERS=68.87.77.134 68.87.72.134 192.168.1.1 +IP4_GATEWAY=192.168.1.1 +IP4_DOMAINS=hsd1.mn.comcast.net. +IP4_NUM_ROUTES=0 +DHCP4_NETBIOS_NAME_SERVERS=0.0.0.0 +DHCP4_DOMAIN_NAME_SERVERS=68.87.77.134 68.87.72.134 192.168.1.1 +DHCP4_DHCP_LEASE_TIME=86400 +DHCP4_NETWORK_NUMBER=192.168.1.0 +DHCP4_DOMAIN_NAME=hsd1.mn.comcast.net. +DHCP4_IP_ADDRESS=192.168.1.119 +DHCP4_DHCP_MESSAGE_TYPE=5 +DHCP4_DHCP_SERVER_IDENTIFIER=192.168.1.1 +DHCP4_ROUTERS=192.168.1.1 +DHCP4_BROADCAST_ADDRESS=192.168.1.255 +DHCP4_SUBNET_MASK=255.255.255.0 +DHCP4_EXPIRY=1304300446 + diff --git a/callouts/tests/dispatcher-vpn-down b/callouts/tests/dispatcher-vpn-down new file mode 100644 index 00000000..eb4dc2ca --- /dev/null +++ b/callouts/tests/dispatcher-vpn-down @@ -0,0 +1,57 @@ +[main] +action=vpn-down +expected-iface=tun0 +uuid=355653c0-34d3-4777-ad25-f9a498b7ef8e +id=Random Connection + +[device] +state=100 +ip-interface=tun0 +type=2 +interface=wlan0 +path=/org/freedesktop/NetworkManager/Devices/0 + +[dhcp4] +netbios_name_servers=0.0.0.0 +domain_name_servers=68.87.77.134 68.87.72.134 192.168.1.1 +dhcp_lease_time=86400 +network_number=192.168.1.0 +domain_name=hsd1.mn.comcast.net. +ip_address=192.168.1.119 +dhcp_message_type=5 +dhcp_server_identifier=192.168.1.1 +routers=192.168.1.1 +broadcast_address=192.168.1.255 +subnet_mask=255.255.255.0 +expiry=1304349405 + +[ip4] +addresses=192.168.1.119/24 192.168.1.1 +nameservers=68.87.77.134 68.87.72.134 192.168.1.1 +domains=hsd1.mn.comcast.net. + +[env] +PATH= +CONNECTION_UUID=355653c0-34d3-4777-ad25-f9a498b7ef8e +CONNECTION_ID=Random Connection +CONNECTION_FILENAME=/callouts/tests/dispatcher-vpn-down +DEVICE_IFACE=wlan0 +DEVICE_IP_IFACE=tun0 +IP4_ADDRESS_0=192.168.1.119/24 192.168.1.1 +IP4_NUM_ADDRESSES=1 +IP4_NAMESERVERS=68.87.77.134 68.87.72.134 192.168.1.1 +IP4_GATEWAY=192.168.1.1 +IP4_DOMAINS=hsd1.mn.comcast.net. +IP4_NUM_ROUTES=0 +DHCP4_NETBIOS_NAME_SERVERS=0.0.0.0 +DHCP4_DOMAIN_NAME_SERVERS=68.87.77.134 68.87.72.134 192.168.1.1 +DHCP4_DHCP_LEASE_TIME=86400 +DHCP4_NETWORK_NUMBER=192.168.1.0 +DHCP4_DOMAIN_NAME=hsd1.mn.comcast.net. +DHCP4_IP_ADDRESS=192.168.1.119 +DHCP4_DHCP_MESSAGE_TYPE=5 +DHCP4_DHCP_SERVER_IDENTIFIER=192.168.1.1 +DHCP4_ROUTERS=192.168.1.1 +DHCP4_BROADCAST_ADDRESS=192.168.1.255 +DHCP4_SUBNET_MASK=255.255.255.0 +DHCP4_EXPIRY=1304349405 diff --git a/callouts/tests/dispatcher-vpn-up b/callouts/tests/dispatcher-vpn-up new file mode 100644 index 00000000..8ae78a31 --- /dev/null +++ b/callouts/tests/dispatcher-vpn-up @@ -0,0 +1,57 @@ +[main] +action=vpn-up +expected-iface=tun0 +uuid=355653c0-34d3-4777-ad25-f9a498b7ef8e +id=Random Connection + +[device] +state=100 +ip-interface=tun0 +type=2 +interface=wlan0 +path=/org/freedesktop/NetworkManager/Devices/0 + +[dhcp4] +netbios_name_servers=0.0.0.0 +domain_name_servers=68.87.77.134 68.87.72.134 192.168.1.1 +dhcp_lease_time=86400 +network_number=192.168.1.0 +domain_name=hsd1.mn.comcast.net. +ip_address=192.168.1.119 +dhcp_message_type=5 +dhcp_server_identifier=192.168.1.1 +routers=192.168.1.1 +broadcast_address=192.168.1.255 +subnet_mask=255.255.255.0 +expiry=1304349405 + +[ip4] +addresses=192.168.1.119/24 192.168.1.1 +nameservers=68.87.77.134 68.87.72.134 192.168.1.1 +domains=hsd1.mn.comcast.net. + +[env] +PATH= +CONNECTION_UUID=355653c0-34d3-4777-ad25-f9a498b7ef8e +CONNECTION_ID=Random Connection +CONNECTION_FILENAME=/callouts/tests/dispatcher-vpn-up +DEVICE_IFACE=wlan0 +DEVICE_IP_IFACE=tun0 +IP4_ADDRESS_0=192.168.1.119/24 192.168.1.1 +IP4_NUM_ADDRESSES=1 +IP4_NAMESERVERS=68.87.77.134 68.87.72.134 192.168.1.1 +IP4_GATEWAY=192.168.1.1 +IP4_DOMAINS=hsd1.mn.comcast.net. +IP4_NUM_ROUTES=0 +DHCP4_NETBIOS_NAME_SERVERS=0.0.0.0 +DHCP4_DOMAIN_NAME_SERVERS=68.87.77.134 68.87.72.134 192.168.1.1 +DHCP4_DHCP_LEASE_TIME=86400 +DHCP4_NETWORK_NUMBER=192.168.1.0 +DHCP4_DOMAIN_NAME=hsd1.mn.comcast.net. +DHCP4_IP_ADDRESS=192.168.1.119 +DHCP4_DHCP_MESSAGE_TYPE=5 +DHCP4_DHCP_SERVER_IDENTIFIER=192.168.1.1 +DHCP4_ROUTERS=192.168.1.1 +DHCP4_BROADCAST_ADDRESS=192.168.1.255 +DHCP4_SUBNET_MASK=255.255.255.0 +DHCP4_EXPIRY=1304349405 diff --git a/callouts/tests/test-dispatcher-envp.c b/callouts/tests/test-dispatcher-envp.c index 460174b2..6ae3fab0 100644 --- a/callouts/tests/test-dispatcher-envp.c +++ b/callouts/tests/test-dispatcher-envp.c @@ -34,6 +34,7 @@ static gboolean parse_main (GKeyFile *kf, + const char *filename, GVariant **out_con_dict, GVariant **out_con_props, char **out_expected_iface, @@ -82,6 +83,11 @@ parse_main (GKeyFile *kf, g_variant_builder_add (&props, "{sv}", "connection-path", g_variant_new_object_path ("/org/freedesktop/NetworkManager/Connections/5")); + /* Strip out the non-fixed portion of the filename */ + filename = strstr (filename, "/callouts"); + g_variant_builder_add (&props, "{sv}", + "filename", + g_variant_new_string (filename)); *out_con_props = g_variant_builder_end (&props); return TRUE; @@ -198,12 +204,12 @@ parse_ip4 (GKeyFile *kf, GVariant **out_props, const char *section, GError **err split = g_strsplit_set (tmp, " ", -1); g_free (tmp); - if (g_strv_length (split) > 0) { + if (split && g_strv_length (split) > 0) { for (iter = split; iter && *iter; iter++) g_strstrip (*iter); g_variant_builder_add (&props, "{sv}", "domains", g_variant_new_strv ((gpointer) split, -1)); - g_strfreev (split); } + g_strfreev (split); /* nameservers */ if (!add_uint_array (kf, &props, "ip4", "nameservers", error)) @@ -219,7 +225,7 @@ parse_ip4 (GKeyFile *kf, GVariant **out_props, const char *section, GError **err split = g_strsplit_set (tmp, ",", -1); g_free (tmp); - if (g_strv_length (split) > 0) { + if (split && g_strv_length (split) > 0) { addresses = g_ptr_array_new_with_free_func ((GDestroyNotify) nm_ip_address_unref); for (iter = split; iter && *iter; iter++) { NMIPAddress *addr; @@ -261,7 +267,7 @@ parse_ip4 (GKeyFile *kf, GVariant **out_props, const char *section, GError **err split = g_strsplit_set (tmp, ",", -1); g_free (tmp); - if (g_strv_length (split) > 0) { + if (split && g_strv_length (split) > 0) { routes = g_ptr_array_new_with_free_func ((GDestroyNotify) nm_ip_route_unref); for (iter = split; iter && *iter; iter++) { NMIPRoute *route; @@ -322,11 +328,15 @@ parse_dhcp (GKeyFile *kf, g_variant_builder_init (&props, G_VARIANT_TYPE ("a{sv}")); for (iter = keys; iter && *iter; iter++) { val = g_key_file_get_string (kf, group_name, *iter, error); - if (!val) + if (!val) { + g_strfreev (keys); + g_variant_builder_clear (&props); return FALSE; + } g_variant_builder_add (&props, "{sv}", *iter, g_variant_new_string (val)); g_free (val); } + g_strfreev (keys); *out_props = g_variant_builder_end (&props); return TRUE; @@ -353,11 +363,27 @@ get_dispatcher_file (const char *file, gboolean success = FALSE; char **keys, **iter, *val; + g_assert (!error || !*error); + g_assert (out_con_dict && !*out_con_dict); + g_assert (out_con_props && !*out_con_props); + g_assert (out_device_props && !*out_device_props); + g_assert (out_device_ip4_props && !*out_device_ip4_props); + g_assert (out_device_ip6_props && !*out_device_ip6_props); + g_assert (out_device_dhcp4_props && !*out_device_dhcp4_props); + g_assert (out_device_dhcp6_props && !*out_device_dhcp6_props); + g_assert (out_vpn_ip_iface && !*out_vpn_ip_iface); + g_assert (out_vpn_ip4_props && !*out_vpn_ip4_props); + g_assert (out_vpn_ip6_props && !*out_vpn_ip6_props); + g_assert (out_expected_iface && !*out_expected_iface); + g_assert (out_action && !*out_action); + g_assert (out_env && !*out_env); + kf = g_key_file_new (); if (!g_key_file_load_from_file (kf, file, G_KEY_FILE_NONE, error)) return FALSE; if (!parse_main (kf, + file, out_con_dict, out_con_props, out_expected_iface, @@ -380,7 +406,7 @@ get_dispatcher_file (const char *file, } if (g_key_file_has_group (kf, "dhcp6")) { - if (!parse_dhcp (kf, "dhcp6", out_device_dhcp4_props, error)) + if (!parse_dhcp (kf, "dhcp6", out_device_dhcp6_props, error)) goto out; } @@ -505,6 +531,7 @@ test_generic (const char *file, const char *override_vpn_ip_iface) g_assert_cmpstr (expected_iface, ==, out_iface); + g_strfreev (denv); g_free (out_iface); g_free (vpn_ip_iface); g_free (expected_iface); @@ -530,27 +557,27 @@ test_generic (const char *file, const char *override_vpn_ip_iface) /*******************************************/ static void -test_old_up (void) +test_up (void) { - test_generic ("dispatcher-old-up", NULL); + test_generic ("dispatcher-up", NULL); } static void -test_old_down (void) +test_down (void) { - test_generic ("dispatcher-old-down", NULL); + test_generic ("dispatcher-down", NULL); } static void -test_old_vpn_up (void) +test_vpn_up (void) { - test_generic ("dispatcher-old-vpn-up", NULL); + test_generic ("dispatcher-vpn-up", NULL); } static void -test_old_vpn_down (void) +test_vpn_down (void) { - test_generic ("dispatcher-old-vpn-down", NULL); + test_generic ("dispatcher-vpn-down", NULL); } static void @@ -559,7 +586,7 @@ test_up_empty_vpn_iface (void) /* Test that an empty VPN iface variable, like is passed through D-Bus * from NM, is ignored by the dispatcher environment construction code. */ - test_generic ("dispatcher-old-up", ""); + test_generic ("dispatcher-up", ""); } /*******************************************/ @@ -573,10 +600,10 @@ main (int argc, char **argv) g_type_init (); #endif - g_test_add_func ("/dispatcher/old_up", test_old_up); - g_test_add_func ("/dispatcher/old_down", test_old_down); - g_test_add_func ("/dispatcher/old_vpn_up", test_old_vpn_up); - g_test_add_func ("/dispatcher/old_vpn_down", test_old_vpn_down); + g_test_add_func ("/dispatcher/up", test_up); + g_test_add_func ("/dispatcher/down", test_down); + g_test_add_func ("/dispatcher/vpn_up", test_vpn_up); + g_test_add_func ("/dispatcher/vpn_down", test_vpn_down); g_test_add_func ("/dispatcher/up_empty_vpn_iface", test_up_empty_vpn_iface); diff --git a/clients/Makefile.in b/clients/Makefile.in index 7abc2123..b3fa0d99 100644 --- a/clients/Makefile.in +++ b/clients/Makefile.in @@ -1,7 +1,7 @@ -# Makefile.in generated by automake 1.13.4 from Makefile.am. +# Makefile.in generated by automake 1.15 from Makefile.am. # @configure_input@ -# Copyright (C) 1994-2013 Free Software Foundation, Inc. +# Copyright (C) 1994-2014 Free Software Foundation, Inc. # This Makefile.in is free software; the Free Software Foundation # gives unlimited permission to copy and/or distribute it, @@ -15,7 +15,17 @@ @SET_MAKE@ VPATH = @srcdir@ -am__is_gnu_make = test -n '$(MAKEFILE_LIST)' && test -n '$(MAKELEVEL)' +am__is_gnu_make = { \ + if test -z '$(MAKELEVEL)'; then \ + false; \ + elif test -n '$(MAKE_HOST)'; then \ + true; \ + elif test -n '$(MAKE_VERSION)' && test -n '$(CURDIR)'; then \ + true; \ + else \ + false; \ + fi; \ +} am__make_running_with_option = \ case $${target_option-} in \ ?) ;; \ @@ -80,8 +90,6 @@ build_triplet = @build@ host_triplet = @host@ bin_PROGRAMS = nm-online$(EXEEXT) subdir = clients -DIST_COMMON = $(srcdir)/Makefile.in $(srcdir)/Makefile.am \ - $(top_srcdir)/build-aux/depcomp ACLOCAL_M4 = $(top_srcdir)/aclocal.m4 am__aclocal_m4_deps = $(top_srcdir)/m4/ax_lib_readline.m4 \ $(top_srcdir)/m4/compiler_warnings.m4 \ @@ -98,6 +106,7 @@ am__aclocal_m4_deps = $(top_srcdir)/m4/ax_lib_readline.m4 \ $(top_srcdir)/m4/vapigen.m4 $(top_srcdir)/configure.ac am__configure_deps = $(am__aclocal_m4_deps) $(CONFIGURE_DEPENDENCIES) \ $(ACLOCAL_M4) +DIST_COMMON = $(srcdir)/Makefile.am $(am__DIST_COMMON) mkinstalldirs = $(install_sh) -d CONFIG_HEADER = $(top_builddir)/config.h CONFIG_CLEAN_FILES = @@ -190,6 +199,8 @@ am__define_uniq_tagged_files = \ ETAGS = etags CTAGS = ctags DIST_SUBDIRS = $(SUBDIRS) +am__DIST_COMMON = $(srcdir)/Makefile.in \ + $(top_srcdir)/build-aux/depcomp DISTFILES = $(DIST_COMMON) $(DIST_SOURCES) $(TEXINFOS) $(EXTRA_DIST) am__relativize = \ dir0=`pwd`; \ @@ -241,7 +252,6 @@ CXXCPP = @CXXCPP@ CXXDEPMODE = @CXXDEPMODE@ CXXFLAGS = @CXXFLAGS@ CYGPATH_W = @CYGPATH_W@ -DATADIRNAME = @DATADIRNAME@ DBUS_CFLAGS = @DBUS_CFLAGS@ DBUS_GLIB_100_CFLAGS = @DBUS_GLIB_100_CFLAGS@ DBUS_GLIB_100_LIBS = @DBUS_GLIB_100_LIBS@ @@ -276,6 +286,7 @@ GNUTLS_CFLAGS = @GNUTLS_CFLAGS@ GNUTLS_LIBS = @GNUTLS_LIBS@ GREP = @GREP@ GTKDOC_CHECK = @GTKDOC_CHECK@ +GTKDOC_CHECK_PATH = @GTKDOC_CHECK_PATH@ GTKDOC_DEPS_CFLAGS = @GTKDOC_DEPS_CFLAGS@ GTKDOC_DEPS_LIBS = @GTKDOC_DEPS_LIBS@ GTKDOC_MKPDF = @GTKDOC_MKPDF@ @@ -511,7 +522,6 @@ $(srcdir)/Makefile.in: @MAINTAINER_MODE_TRUE@ $(srcdir)/Makefile.am $(am__confi echo ' cd $(top_srcdir) && $(AUTOMAKE) --gnu clients/Makefile'; \ $(am__cd) $(top_srcdir) && \ $(AUTOMAKE) --gnu clients/Makefile -.PRECIOUS: Makefile Makefile: $(srcdir)/Makefile.in $(top_builddir)/config.status @case '$?' in \ *config.status*) \ @@ -596,14 +606,14 @@ distclean-compile: @am__fastdepCC_TRUE@ $(AM_V_at)$(am__mv) $(DEPDIR)/$*.Tpo $(DEPDIR)/$*.Po @AMDEP_TRUE@@am__fastdepCC_FALSE@ $(AM_V_CC)source='$<' object='$@' libtool=no @AMDEPBACKSLASH@ @AMDEP_TRUE@@am__fastdepCC_FALSE@ DEPDIR=$(DEPDIR) $(CCDEPMODE) $(depcomp) @AMDEPBACKSLASH@ -@am__fastdepCC_FALSE@ $(AM_V_CC@am__nodep@)$(COMPILE) -c $< +@am__fastdepCC_FALSE@ $(AM_V_CC@am__nodep@)$(COMPILE) -c -o $@ $< .c.obj: @am__fastdepCC_TRUE@ $(AM_V_CC)$(COMPILE) -MT $@ -MD -MP -MF $(DEPDIR)/$*.Tpo -c -o $@ `$(CYGPATH_W) '$<'` @am__fastdepCC_TRUE@ $(AM_V_at)$(am__mv) $(DEPDIR)/$*.Tpo $(DEPDIR)/$*.Po @AMDEP_TRUE@@am__fastdepCC_FALSE@ $(AM_V_CC)source='$<' object='$@' libtool=no @AMDEPBACKSLASH@ @AMDEP_TRUE@@am__fastdepCC_FALSE@ DEPDIR=$(DEPDIR) $(CCDEPMODE) $(depcomp) @AMDEPBACKSLASH@ -@am__fastdepCC_FALSE@ $(AM_V_CC@am__nodep@)$(COMPILE) -c `$(CYGPATH_W) '$<'` +@am__fastdepCC_FALSE@ $(AM_V_CC@am__nodep@)$(COMPILE) -c -o $@ `$(CYGPATH_W) '$<'` .c.lo: @am__fastdepCC_TRUE@ $(AM_V_CC)$(LTCOMPILE) -MT $@ -MD -MP -MF $(DEPDIR)/$*.Tpo -c -o $@ $< @@ -911,6 +921,8 @@ uninstall-am: uninstall-binPROGRAMS mostlyclean-libtool pdf pdf-am ps ps-am tags tags-am uninstall \ uninstall-am uninstall-binPROGRAMS +.PRECIOUS: Makefile + # Tell versions [3.59,3.63) of GNU make to not export all variables. # Otherwise a system limit (for SysV at least) may be exceeded. diff --git a/clients/cli/Makefile.in b/clients/cli/Makefile.in index 871b9525..657f00ff 100644 --- a/clients/cli/Makefile.in +++ b/clients/cli/Makefile.in @@ -1,7 +1,7 @@ -# Makefile.in generated by automake 1.13.4 from Makefile.am. +# Makefile.in generated by automake 1.15 from Makefile.am. # @configure_input@ -# Copyright (C) 1994-2013 Free Software Foundation, Inc. +# Copyright (C) 1994-2014 Free Software Foundation, Inc. # This Makefile.in is free software; the Free Software Foundation # gives unlimited permission to copy and/or distribute it, @@ -15,7 +15,17 @@ @SET_MAKE@ VPATH = @srcdir@ -am__is_gnu_make = test -n '$(MAKEFILE_LIST)' && test -n '$(MAKELEVEL)' +am__is_gnu_make = { \ + if test -z '$(MAKELEVEL)'; then \ + false; \ + elif test -n '$(MAKE_HOST)'; then \ + true; \ + elif test -n '$(MAKE_VERSION)' && test -n '$(CURDIR)'; then \ + true; \ + else \ + false; \ + fi; \ +} am__make_running_with_option = \ case $${target_option-} in \ ?) ;; \ @@ -83,8 +93,6 @@ bin_PROGRAMS = nmcli$(EXEEXT) @WITH_POLKIT_AGENT_TRUE@am__append_2 = $(srcdir)/../common/nm-polkit-listener.c $(srcdir)/../common/nm-polkit-listener.h @WITH_POLKIT_AGENT_TRUE@am__append_3 = $(POLKIT_LIBS) subdir = clients/cli -DIST_COMMON = $(srcdir)/Makefile.in $(srcdir)/Makefile.am \ - $(top_srcdir)/build-aux/depcomp ACLOCAL_M4 = $(top_srcdir)/aclocal.m4 am__aclocal_m4_deps = $(top_srcdir)/m4/ax_lib_readline.m4 \ $(top_srcdir)/m4/compiler_warnings.m4 \ @@ -101,6 +109,7 @@ am__aclocal_m4_deps = $(top_srcdir)/m4/ax_lib_readline.m4 \ $(top_srcdir)/m4/vapigen.m4 $(top_srcdir)/configure.ac am__configure_deps = $(am__aclocal_m4_deps) $(CONFIGURE_DEPENDENCIES) \ $(ACLOCAL_M4) +DIST_COMMON = $(srcdir)/Makefile.am $(am__DIST_COMMON) mkinstalldirs = $(install_sh) -d CONFIG_HEADER = $(top_builddir)/config.h CONFIG_CLEAN_FILES = @@ -190,6 +199,8 @@ am__define_uniq_tagged_files = \ done | $(am__uniquify_input)` ETAGS = etags CTAGS = ctags +am__DIST_COMMON = $(srcdir)/Makefile.in \ + $(top_srcdir)/build-aux/depcomp DISTFILES = $(DIST_COMMON) $(DIST_SOURCES) $(TEXINFOS) $(EXTRA_DIST) ACLOCAL = @ACLOCAL@ ALL_LINGUAS = @ALL_LINGUAS@ @@ -216,7 +227,6 @@ CXXCPP = @CXXCPP@ CXXDEPMODE = @CXXDEPMODE@ CXXFLAGS = @CXXFLAGS@ CYGPATH_W = @CYGPATH_W@ -DATADIRNAME = @DATADIRNAME@ DBUS_CFLAGS = @DBUS_CFLAGS@ DBUS_GLIB_100_CFLAGS = @DBUS_GLIB_100_CFLAGS@ DBUS_GLIB_100_LIBS = @DBUS_GLIB_100_LIBS@ @@ -251,6 +261,7 @@ GNUTLS_CFLAGS = @GNUTLS_CFLAGS@ GNUTLS_LIBS = @GNUTLS_LIBS@ GREP = @GREP@ GTKDOC_CHECK = @GTKDOC_CHECK@ +GTKDOC_CHECK_PATH = @GTKDOC_CHECK_PATH@ GTKDOC_DEPS_CFLAGS = @GTKDOC_DEPS_CFLAGS@ GTKDOC_DEPS_LIBS = @GTKDOC_DEPS_LIBS@ GTKDOC_MKPDF = @GTKDOC_MKPDF@ @@ -488,7 +499,6 @@ $(srcdir)/Makefile.in: @MAINTAINER_MODE_TRUE@ $(srcdir)/Makefile.am $(am__confi echo ' cd $(top_srcdir) && $(AUTOMAKE) --gnu clients/cli/Makefile'; \ $(am__cd) $(top_srcdir) && \ $(AUTOMAKE) --gnu clients/cli/Makefile -.PRECIOUS: Makefile Makefile: $(srcdir)/Makefile.in $(top_builddir)/config.status @case '$?' in \ *config.status*) \ @@ -583,14 +593,14 @@ distclean-compile: @am__fastdepCC_TRUE@ $(AM_V_at)$(am__mv) $(DEPDIR)/$*.Tpo $(DEPDIR)/$*.Po @AMDEP_TRUE@@am__fastdepCC_FALSE@ $(AM_V_CC)source='$<' object='$@' libtool=no @AMDEPBACKSLASH@ @AMDEP_TRUE@@am__fastdepCC_FALSE@ DEPDIR=$(DEPDIR) $(CCDEPMODE) $(depcomp) @AMDEPBACKSLASH@ -@am__fastdepCC_FALSE@ $(AM_V_CC@am__nodep@)$(COMPILE) -c $< +@am__fastdepCC_FALSE@ $(AM_V_CC@am__nodep@)$(COMPILE) -c -o $@ $< .c.obj: @am__fastdepCC_TRUE@ $(AM_V_CC)$(COMPILE) -MT $@ -MD -MP -MF $(DEPDIR)/$*.Tpo -c -o $@ `$(CYGPATH_W) '$<'` @am__fastdepCC_TRUE@ $(AM_V_at)$(am__mv) $(DEPDIR)/$*.Tpo $(DEPDIR)/$*.Po @AMDEP_TRUE@@am__fastdepCC_FALSE@ $(AM_V_CC)source='$<' object='$@' libtool=no @AMDEPBACKSLASH@ @AMDEP_TRUE@@am__fastdepCC_FALSE@ DEPDIR=$(DEPDIR) $(CCDEPMODE) $(depcomp) @AMDEPBACKSLASH@ -@am__fastdepCC_FALSE@ $(AM_V_CC@am__nodep@)$(COMPILE) -c `$(CYGPATH_W) '$<'` +@am__fastdepCC_FALSE@ $(AM_V_CC@am__nodep@)$(COMPILE) -c -o $@ `$(CYGPATH_W) '$<'` .c.lo: @am__fastdepCC_TRUE@ $(AM_V_CC)$(LTCOMPILE) -MT $@ -MD -MP -MF $(DEPDIR)/$*.Tpo -c -o $@ $< @@ -846,6 +856,8 @@ uninstall-am: uninstall-binPROGRAMS pdf pdf-am ps ps-am tags tags-am uninstall uninstall-am \ uninstall-binPROGRAMS uninstall-hook +.PRECIOUS: Makefile + @BUILD_SETTING_DOCS_TRUE@settings-docs.c: settings-docs.xsl $(top_builddir)/libnm/nm-property-docs.xml @BUILD_SETTING_DOCS_TRUE@ $(AM_V_GEN) xsltproc --output $@ $^ diff --git a/clients/cli/common.c b/clients/cli/common.c index 6b13f7f8..a47c32e8 100644 --- a/clients/cli/common.c +++ b/clients/cli/common.c @@ -705,6 +705,9 @@ nmc_device_reason_to_string (NMDeviceStateReason reason) case NM_DEVICE_STATE_REASON_SIM_PIN_INCORRECT: return _("SIM PIN was incorrect"); + case NM_DEVICE_STATE_REASON_NEW_ACTIVATION: + return _("New connection activation was enqueued"); + default: /* TRANSLATORS: Unknown reason for a device state change (NMDeviceStateReason) */ return _("Unknown"); diff --git a/clients/cli/connections.c b/clients/cli/connections.c index 5de9cc9d..9206d9da 100644 --- a/clients/cli/connections.c +++ b/clients/cli/connections.c @@ -2319,6 +2319,7 @@ do_connection_down (NmCli *nmc, int argc, char **argv) if (nmc->ask) { line = nmc_readline (PROMPT_CONNECTION); nmc_string_to_arg_array (line, "", &arg_arr, &arg_num); + g_free (line); arg_ptr = arg_arr; } if (arg_num == 0) { @@ -8691,6 +8692,7 @@ do_connection_delete (NmCli *nmc, int argc, char **argv) if (nmc->ask) { line = nmc_readline (PROMPT_CONNECTION); nmc_string_to_arg_array (line, "", &arg_arr, &arg_num); + g_free (line); arg_ptr = arg_arr; } if (arg_num == 0) { diff --git a/clients/cli/devices.c b/clients/cli/devices.c index 5530adc7..1633f0ce 100644 --- a/clients/cli/devices.c +++ b/clients/cli/devices.c @@ -57,28 +57,31 @@ static NmcOutputField nmc_fields_dev_show_general[] = { {"NAME", N_("NAME"), 10}, /* 0 */ {"DEVICE", N_("DEVICE"), 10}, /* 1 */ {"TYPE", N_("TYPE"), 17}, /* 2 */ - {"VENDOR", N_("VENDOR"), 20}, /* 3 */ - {"PRODUCT", N_("PRODUCT"), 50}, /* 4 */ - {"DRIVER", N_("DRIVER"), 9}, /* 5 */ - {"DRIVER-VERSION", N_("DRIVER-VERSION"), 18}, /* 6 */ - {"FIRMWARE-VERSION", N_("FIRMWARE-VERSION"), 18}, /* 7 */ - {"HWADDR", N_("HWADDR"), 19}, /* 8 */ - {"MTU", N_("MTU"), 10}, /* 9 */ - {"STATE", N_("STATE"), 14}, /* 10 */ - {"REASON", N_("REASON"), 25}, /* 11 */ - {"UDI", N_("UDI"), 64}, /* 12 */ - {"IP-IFACE", N_("IP-IFACE"), 10}, /* 13 */ - {"IS-SOFTWARE", N_("IS-SOFTWARE"), 15}, /* 14 */ - {"NM-MANAGED", N_("NM-MANAGED"), 15}, /* 15 */ - {"AUTOCONNECT", N_("AUTOCONNECT"), 15}, /* 16 */ - {"FIRMWARE-MISSING", N_("FIRMWARE-MISSING"), 18}, /* 17 */ - {"CONNECTION", N_("CONNECTION"), 20}, /* 18 */ - {"CON-UUID", N_("CON-UUID"), 38}, /* 19 */ - {"CON-PATH", N_("CON-PATH"), 51}, /* 20 */ + {"NM-TYPE", N_("NM-TYPE"), 17}, /* 3 */ + {"VENDOR", N_("VENDOR"), 20}, /* 4 */ + {"PRODUCT", N_("PRODUCT"), 50}, /* 5 */ + {"DRIVER", N_("DRIVER"), 9}, /* 6 */ + {"DRIVER-VERSION", N_("DRIVER-VERSION"), 18}, /* 7 */ + {"FIRMWARE-VERSION", N_("FIRMWARE-VERSION"), 18}, /* 8 */ + {"HWADDR", N_("HWADDR"), 19}, /* 9 */ + {"MTU", N_("MTU"), 10}, /* 10 */ + {"STATE", N_("STATE"), 14}, /* 11 */ + {"REASON", N_("REASON"), 25}, /* 12 */ + {"UDI", N_("UDI"), 64}, /* 13 */ + {"IP-IFACE", N_("IP-IFACE"), 10}, /* 14 */ + {"IS-SOFTWARE", N_("IS-SOFTWARE"), 15}, /* 15 */ + {"NM-MANAGED", N_("NM-MANAGED"), 15}, /* 16 */ + {"AUTOCONNECT", N_("AUTOCONNECT"), 15}, /* 17 */ + {"FIRMWARE-MISSING", N_("FIRMWARE-MISSING"), 18}, /* 18 */ + {"PHYS-PORT-ID", N_("PHYS-PORT-ID"), 18}, /* 19 */ + {"CONNECTION", N_("CONNECTION"), 20}, /* 20 */ + {"CON-UUID", N_("CON-UUID"), 38}, /* 21 */ + {"CON-PATH", N_("CON-PATH"), 51}, /* 22 */ {NULL, NULL, 0} }; -#define NMC_FIELDS_DEV_SHOW_GENERAL_ALL "NAME,DEVICE,TYPE,VENDOR,PRODUCT,DRIVER,DRIVER-VERSION,FIRMWARE-VERSION,HWADDR,MTU,STATE,REASON,"\ - "UDI,IP-IFACE,IS-SOFTWARE,NM-MANAGED,AUTOCONNECT,FIRMWARE-MISSING,CONNECTION,CON-UUID,CON-PATH" +#define NMC_FIELDS_DEV_SHOW_GENERAL_ALL "NAME,DEVICE,TYPE,NM-TYPE,VENDOR,PRODUCT,DRIVER,DRIVER-VERSION,FIRMWARE-VERSION,HWADDR,MTU,"\ + "STATE,REASON,UDI,IP-IFACE,IS-SOFTWARE,NM-MANAGED,AUTOCONNECT,FIRMWARE-MISSING,PHYS-PORT-ID,"\ + "CONNECTION,CON-UUID,CON-PATH" #define NMC_FIELDS_DEV_SHOW_GENERAL_COMMON "NAME,DEVICE,TYPE,VENDOR,PRODUCT,DRIVER,HWADDR,STATE" /* Available fields for 'device show' - CONNECTIONS part */ @@ -121,9 +124,11 @@ static NmcOutputField nmc_fields_dev_show_wifi_prop[] = { {"CCMP", N_("CCMP"), 6}, /* 5 */ {"AP", N_("AP"), 6}, /* 6 */ {"ADHOC", N_("ADHOC"), 6}, /* 7 */ + {"2GHZ", N_("2GHZ"), 10}, /* 8 */ + {"5GHZ", N_("5GHZ"), 10}, /* 9 */ {NULL, NULL, 0} }; -#define NMC_FIELDS_DEV_SHOW_WIFI_PROP_ALL "NAME,WEP,WPA,WPA2,TKIP,CCMP,AP,ADHOC" +#define NMC_FIELDS_DEV_SHOW_WIFI_PROP_ALL "NAME,WEP,WPA,WPA2,TKIP,CCMP,AP,ADHOC,2GHZ,5GHZ" #define NMC_FIELDS_DEV_SHOW_WIFI_PROP_COMMON "NAME,WEP,WPA,WPA2,TKIP,CCMP,AP,ADHOC" /* Available fields for 'device show' - wimax properties part */ @@ -832,24 +837,26 @@ show_device_info (NMDevice *device, NmCli *nmc) set_val_strc (arr, 0, nmc_fields_dev_show_sections[0].name); /* "GENERAL"*/ set_val_strc (arr, 1, nm_device_get_iface (device)); set_val_strc (arr, 2, nm_device_get_type_description (device)); - set_val_strc (arr, 3, nm_device_get_vendor (device)); - set_val_strc (arr, 4, nm_device_get_product (device)); - set_val_strc (arr, 5, nm_device_get_driver (device) ? nm_device_get_driver (device) : _("(unknown)")); - set_val_strc (arr, 6, nm_device_get_driver_version (device)); - set_val_strc (arr, 7, nm_device_get_firmware_version (device)); - set_val_strc (arr, 8, hwaddr ? hwaddr : _("(unknown)")); - set_val_str (arr, 9, mtu_str); - set_val_str (arr, 10, state_str); - set_val_str (arr, 11, reason_str); - set_val_strc (arr, 12, nm_device_get_udi (device)); - set_val_strc (arr, 13, nm_device_get_ip_iface (device)); - set_val_strc (arr, 14, nm_device_is_software (device) ? _("yes") : _("no")); - set_val_strc (arr, 15, nm_device_get_managed (device) ? _("yes") : _("no")); - set_val_strc (arr, 16, nm_device_get_autoconnect (device) ? _("yes") : _("no")); - set_val_strc (arr, 17, nm_device_get_firmware_missing (device) ? _("yes") : _("no")); - set_val_strc (arr, 18, get_active_connection_id (device)); - set_val_strc (arr, 19, acon ? nm_active_connection_get_uuid (acon) : NULL); - set_val_strc (arr, 20, acon ? nm_object_get_path (NM_OBJECT (acon)) : NULL); + set_val_strc (arr, 3, G_OBJECT_TYPE_NAME (device)); + set_val_strc (arr, 4, nm_device_get_vendor (device)); + set_val_strc (arr, 5, nm_device_get_product (device)); + set_val_strc (arr, 6, nm_device_get_driver (device) ? nm_device_get_driver (device) : _("(unknown)")); + set_val_strc (arr, 7, nm_device_get_driver_version (device)); + set_val_strc (arr, 8, nm_device_get_firmware_version (device)); + set_val_strc (arr, 9, hwaddr ? hwaddr : _("(unknown)")); + set_val_str (arr, 10, mtu_str); + set_val_str (arr, 11, state_str); + set_val_str (arr, 12, reason_str); + set_val_strc (arr, 13, nm_device_get_udi (device)); + set_val_strc (arr, 14, nm_device_get_ip_iface (device)); + set_val_strc (arr, 15, nm_device_is_software (device) ? _("yes") : _("no")); + set_val_strc (arr, 16, nm_device_get_managed (device) ? _("yes") : _("no")); + set_val_strc (arr, 17, nm_device_get_autoconnect (device) ? _("yes") : _("no")); + set_val_strc (arr, 18, nm_device_get_firmware_missing (device) ? _("yes") : _("no")); + set_val_strc (arr, 19, nm_device_get_physical_port_id (device)); + set_val_strc (arr, 20, get_active_connection_id (device)); + set_val_strc (arr, 21, acon ? nm_active_connection_get_uuid (acon) : NULL); + set_val_strc (arr, 22, acon ? nm_object_get_path (NM_OBJECT (acon)) : NULL); g_ptr_array_add (nmc->output_data, arr); print_data (nmc); /* Print all data */ @@ -916,6 +923,10 @@ show_device_info (NMDevice *device, NmCli *nmc) set_val_strc (arr, 5, (wcaps & NM_WIFI_DEVICE_CAP_CIPHER_CCMP) ? _("yes") : _("no")); set_val_strc (arr, 6, (wcaps & NM_WIFI_DEVICE_CAP_AP) ? _("yes") : _("no")); set_val_strc (arr, 7, (wcaps & NM_WIFI_DEVICE_CAP_ADHOC) ? _("yes") : _("no")); + set_val_strc (arr, 8, !(wcaps & NM_WIFI_DEVICE_CAP_FREQ_VALID) ? _("unknown") : + ((wcaps & NM_WIFI_DEVICE_CAP_FREQ_2GHZ) ? _("yes") : _("no"))); + set_val_strc (arr, 9, !(wcaps & NM_WIFI_DEVICE_CAP_FREQ_VALID) ? _("unknown") : + ((wcaps & NM_WIFI_DEVICE_CAP_FREQ_5GHZ) ? _("yes") : _("no"))); g_ptr_array_add (nmc->output_data, arr); print_data (nmc); /* Print all data */ @@ -1634,7 +1645,7 @@ disconnect_state_cb (NMDevice *device, GParamSpec *pspec, gpointer user_data) state = nm_device_get_state (device); - if (state == NM_DEVICE_STATE_DISCONNECTED) { + if (state <= NM_DEVICE_STATE_DISCONNECTED) { g_signal_handlers_disconnect_by_data (device, user_data); g_print (_("Device '%s' successfully disconnected.\n"), nm_device_get_iface (device)); @@ -1671,9 +1682,9 @@ disconnect_device_cb (GObject *object, GAsyncResult *result, gpointer user_data) } else { state = nm_device_get_state (device); - if (nmc->nowait_flag || state == NM_DEVICE_STATE_DISCONNECTED) { + if (nmc->nowait_flag || state <= NM_DEVICE_STATE_DISCONNECTED) { /* Don't want to wait or device already disconnected */ - if (state == NM_DEVICE_STATE_DISCONNECTED) { + if (state <= NM_DEVICE_STATE_DISCONNECTED) { if (nmc->print_output == NMC_PRINT_PRETTY) nmc_terminal_erase_line (); g_print (_("Device '%s' has been disconnected.\n"), nm_device_get_iface (device)); @@ -2005,7 +2016,13 @@ do_device_wifi_list (NmCli *nmc, int argc, char **argv) show_access_point_info (device, nmc); } } else { - g_string_printf (nmc->return_text, _("Error: Device '%s' is not a Wi-Fi device."), ifname); + const char *err_msg; + if ( nm_device_get_device_type (device) == NM_DEVICE_TYPE_GENERIC + && g_strcmp0 (nm_device_get_type_description (device), "wifi") == 0) + err_msg = _("Error: Device '%s' was not recognized as a Wi-Fi device, check NetworkManager Wi-Fi plugin."); + else + err_msg = _("Error: Device '%s' is not a Wi-Fi device."); + g_string_printf (nmc->return_text, err_msg, ifname); nmc->return_value = NMC_RESULT_ERROR_UNKNOWN; goto error; } @@ -2485,9 +2502,15 @@ do_device_wifi_rescan (NmCli *nmc, int argc, char **argv) device = find_wifi_device_by_iface (devices, ifname, &devices_idx); if (!device) { - if (ifname) - g_string_printf (nmc->return_text, _("Error: Device '%s' is not a Wi-Fi device."), ifname); - else + if (ifname) { + const char *err_msg; + if ( nm_device_get_device_type (device) == NM_DEVICE_TYPE_GENERIC + && g_strcmp0 (nm_device_get_type_description (device), "wifi") == 0) + err_msg = _("Error: Device '%s' was not recognized as a Wi-Fi device, check NetworkManager Wi-Fi plugin."); + else + err_msg = _("Error: Device '%s' is not a Wi-Fi device."); + g_string_printf (nmc->return_text, err_msg, ifname); + } else g_string_printf (nmc->return_text, _("Error: No Wi-Fi device found.")); nmc->return_value = NMC_RESULT_ERROR_UNKNOWN; goto error; diff --git a/clients/cli/nmcli-completion b/clients/cli/nmcli-completion index 73028bdf..dce20d13 100644 --- a/clients/cli/nmcli-completion +++ b/clients/cli/nmcli-completion @@ -1150,7 +1150,7 @@ _nmcli() ;; esac - OPTIONS=(id uuid path apath) + OPTIONS=(id uuid path) _nmcli_compl_ARGS_CONNECTION && return 0 while [[ "${#words[@]}" -gt 0 ]]; do if [[ ${#words[@]} -le 1 ]]; then @@ -1159,14 +1159,14 @@ _nmcli() if [[ "${words[0]:0:1}" == [+-] ]]; then PREFIX="${words[0]:0:1}" fi - _nmcli_list_nl "$(nmcli --fields profile connection show "${COMMAND_CONNECTION_TYPE:-id}" "$COMMAND_CONNECTION_ID" 2>/dev/null | sed -n 's/^\([^:]\+\):.*/'$PREFIX'\1/p')" + _nmcli_list_nl "$(nmcli --fields profile connection show ${COMMAND_CONNECTION_TYPE} "$COMMAND_CONNECTION_ID" 2>/dev/null | sed -n 's/^\([^:]\+\):.*/'$PREFIX'\1/p')" return 0 elif [[ ${#words[@]} -le 2 ]]; then return 0 fi _nmcli_array_delete_at words 0 1 done - _nmcli_list_nl "$(nmcli --fields profile connection show "${COMMAND_CONNECTION_TYPE:-id}" "$COMMAND_CONNECTION_ID" 2>/dev/null | sed -n 's/^\([^:]\+\):.*/\1/p')" + _nmcli_list_nl "$(nmcli --fields profile connection show ${COMMAND_CONNECTION_TYPE} "$COMMAND_CONNECTION_ID" 2>/dev/null | sed -n 's/^\([^:]\+\):.*/\1/p')" return 0 fi ;; diff --git a/clients/cli/settings.c b/clients/cli/settings.c index 7d2a46c8..09916954 100644 --- a/clients/cli/settings.c +++ b/clients/cli/settings.c @@ -2545,7 +2545,7 @@ nmc_property_con_set_master (NMSetting *setting, const char *prop, const char *v static const char *con_valid_slave_types[] = { NM_SETTING_BOND_SETTING_NAME, NM_SETTING_BRIDGE_SETTING_NAME, - NM_SETTING_VLAN_SETTING_NAME, + NM_SETTING_TEAM_SETTING_NAME, NULL }; @@ -2759,6 +2759,15 @@ DEFINE_REMOVER_INDEX_OR_VALUE (nmc_property_802_1X_remove_eap, /* 'ca-cert' */ DEFINE_SETTER_CERT (nmc_property_802_1X_set_ca_cert, nm_setting_802_1x_set_ca_cert) +static const char * +nmc_property_802_1X_describe_ca_cert (NMSetting *setting, const char *prop) +{ + return _("Enter file path to CA certificate (optionally prefixed with file://).\n" + " [file://]\n" + "Note that nmcli does not support specifying certificates as raw blob data.\n" + "Example: /home/cimrman/cacert.crt\n"); +} + /* 'altsubject-matches' */ DEFINE_SETTER_STR_LIST (nmc_property_802_1X_set_altsubject_matches, nm_setting_802_1x_add_altsubject_match) @@ -2785,9 +2794,28 @@ DEFINE_REMOVER_INDEX_OR_VALUE (nmc_property_802_1X_remove_altsubject_matches, /* 'client-cert' */ DEFINE_SETTER_CERT (nmc_property_802_1X_set_client_cert, nm_setting_802_1x_set_client_cert) +static const char * +nmc_property_802_1X_describe_client_cert (NMSetting *setting, const char *prop) +{ + return _("Enter file path to client certificate (optionally prefixed with file://).\n" + " [file://]\n" + "Note that nmcli does not support specifying certificates as raw blob data.\n" + "Example: /home/cimrman/jara.crt\n"); +} + /* 'phase2-ca-cert' */ DEFINE_SETTER_CERT (nmc_property_802_1X_set_phase2_ca_cert, nm_setting_802_1x_set_phase2_ca_cert) +static const char * +nmc_property_802_1X_describe_phase2_ca_cert (NMSetting *setting, const char *prop) +{ + return _("Enter file path to CA certificate for inner authentication (optionally prefixed\n" + "with file://).\n" + " [file://]\n" + "Note that nmcli does not support specifying certificates as raw blob data.\n" + "Example: /home/cimrman/ca-zweite-phase.crt\n"); +} + /* 'phase2-altsubject-matches' */ DEFINE_SETTER_STR_LIST (nmc_property_802_1X_set_phase2_altsubject_matches, nm_setting_802_1x_add_phase2_altsubject_match) @@ -2814,6 +2842,16 @@ DEFINE_REMOVER_INDEX_OR_VALUE (nmc_property_802_1X_remove_phase2_altsubject_matc /* 'phase2-client-cert' */ DEFINE_SETTER_CERT (nmc_property_802_1X_set_phase2_client_cert, nm_setting_802_1x_set_phase2_client_cert) +static const char * +nmc_property_802_1X_describe_phase2_client_cert (NMSetting *setting, const char *prop) +{ + return _("Enter file path to client certificate for inner authentication (optionally prefixed\n" + "with file://).\n" + " [file://]\n" + "Note that nmcli does not support specifying certificates as raw blob data.\n" + "Example: /home/cimrman/jara-zweite-phase.crt\n"); +} + /* 'private-key' */ DEFINE_SETTER_PRIV_KEY (nmc_property_802_1X_set_private_key, nm_setting_802_1x_get_private_key_password, @@ -2828,7 +2866,8 @@ static const char * nmc_property_802_1X_describe_private_key (NMSetting *setting, const char *prop) { return _("Enter path to a private key and the key password (if not set yet):\n" - " []\n" + " [file://] []\n" + "Note that nmcli does not support specifying private key as raw blob data.\n" "Example: /home/cimrman/jara-priv-key Dardanely\n"); } @@ -3031,7 +3070,7 @@ nmc_property_bond_allowed_options (NMSetting *setting, const char *prop) } /* --- NM_SETTING_INFINIBAND_SETTING_NAME property setter functions --- */ -/* 'mac-addresss' */ +/* 'mac-address' */ static gboolean nmc_property_ib_set_mac (NMSetting *setting, const char *prop, const char *val, GError **error) { @@ -4750,7 +4789,7 @@ nmc_properties_init (void) nmc_property_802_1X_get_ca_cert, nmc_property_802_1X_set_ca_cert, NULL, - NULL, + nmc_property_802_1X_describe_ca_cert, NULL, NULL); nmc_add_prop_funcs (GLUE (802_1X, CA_PATH), @@ -4778,7 +4817,7 @@ nmc_properties_init (void) nmc_property_802_1X_get_client_cert, nmc_property_802_1X_set_client_cert, NULL, - NULL, + nmc_property_802_1X_describe_client_cert, NULL, NULL); nmc_add_prop_funcs (GLUE (802_1X, PHASE1_PEAPVER), @@ -4820,7 +4859,7 @@ nmc_properties_init (void) nmc_property_802_1X_get_phase2_ca_cert, nmc_property_802_1X_set_phase2_ca_cert, NULL, - NULL, + nmc_property_802_1X_describe_phase2_ca_cert, NULL, NULL); nmc_add_prop_funcs (GLUE (802_1X, PHASE2_CA_PATH), @@ -4848,7 +4887,7 @@ nmc_properties_init (void) nmc_property_802_1X_get_phase2_client_cert, nmc_property_802_1X_set_phase2_client_cert, NULL, - NULL, + nmc_property_802_1X_describe_phase2_client_cert, NULL, NULL); nmc_add_prop_funcs (GLUE (802_1X, PASSWORD), @@ -6449,6 +6488,7 @@ nmc_setting_get_valid_properties (NMSetting *setting) valid_props[i++] = g_strdup (key_name); } valid_props[i] = NULL; + g_free (props); return valid_props; } diff --git a/clients/tui/Makefile.in b/clients/tui/Makefile.in index 86b2a3b9..4283a754 100644 --- a/clients/tui/Makefile.in +++ b/clients/tui/Makefile.in @@ -1,7 +1,7 @@ -# Makefile.in generated by automake 1.13.4 from Makefile.am. +# Makefile.in generated by automake 1.15 from Makefile.am. # @configure_input@ -# Copyright (C) 1994-2013 Free Software Foundation, Inc. +# Copyright (C) 1994-2014 Free Software Foundation, Inc. # This Makefile.in is free software; the Free Software Foundation # gives unlimited permission to copy and/or distribute it, @@ -15,7 +15,17 @@ @SET_MAKE@ VPATH = @srcdir@ -am__is_gnu_make = test -n '$(MAKEFILE_LIST)' && test -n '$(MAKELEVEL)' +am__is_gnu_make = { \ + if test -z '$(MAKELEVEL)'; then \ + false; \ + elif test -n '$(MAKE_HOST)'; then \ + true; \ + elif test -n '$(MAKE_VERSION)' && test -n '$(CURDIR)'; then \ + true; \ + else \ + false; \ + fi; \ +} am__make_running_with_option = \ case $${target_option-} in \ ?) ;; \ @@ -80,8 +90,6 @@ build_triplet = @build@ host_triplet = @host@ @BUILD_NMTUI_TRUE@bin_PROGRAMS = nmtui$(EXEEXT) subdir = clients/tui -DIST_COMMON = $(srcdir)/Makefile.in $(srcdir)/Makefile.am \ - $(top_srcdir)/build-aux/depcomp ACLOCAL_M4 = $(top_srcdir)/aclocal.m4 am__aclocal_m4_deps = $(top_srcdir)/m4/ax_lib_readline.m4 \ $(top_srcdir)/m4/compiler_warnings.m4 \ @@ -98,6 +106,7 @@ am__aclocal_m4_deps = $(top_srcdir)/m4/ax_lib_readline.m4 \ $(top_srcdir)/m4/vapigen.m4 $(top_srcdir)/configure.ac am__configure_deps = $(am__aclocal_m4_deps) $(CONFIGURE_DEPENDENCIES) \ $(ACLOCAL_M4) +DIST_COMMON = $(srcdir)/Makefile.am $(am__DIST_COMMON) mkinstalldirs = $(install_sh) -d CONFIG_HEADER = $(top_builddir)/config.h CONFIG_CLEAN_FILES = @@ -256,6 +265,8 @@ am__define_uniq_tagged_files = \ ETAGS = etags CTAGS = ctags DIST_SUBDIRS = newt . +am__DIST_COMMON = $(srcdir)/Makefile.in \ + $(top_srcdir)/build-aux/depcomp DISTFILES = $(DIST_COMMON) $(DIST_SOURCES) $(TEXINFOS) $(EXTRA_DIST) am__relativize = \ dir0=`pwd`; \ @@ -307,7 +318,6 @@ CXXCPP = @CXXCPP@ CXXDEPMODE = @CXXDEPMODE@ CXXFLAGS = @CXXFLAGS@ CYGPATH_W = @CYGPATH_W@ -DATADIRNAME = @DATADIRNAME@ DBUS_CFLAGS = @DBUS_CFLAGS@ DBUS_GLIB_100_CFLAGS = @DBUS_GLIB_100_CFLAGS@ DBUS_GLIB_100_LIBS = @DBUS_GLIB_100_LIBS@ @@ -342,6 +352,7 @@ GNUTLS_CFLAGS = @GNUTLS_CFLAGS@ GNUTLS_LIBS = @GNUTLS_LIBS@ GREP = @GREP@ GTKDOC_CHECK = @GTKDOC_CHECK@ +GTKDOC_CHECK_PATH = @GTKDOC_CHECK_PATH@ GTKDOC_DEPS_CFLAGS = @GTKDOC_DEPS_CFLAGS@ GTKDOC_DEPS_LIBS = @GTKDOC_DEPS_LIBS@ GTKDOC_MKPDF = @GTKDOC_MKPDF@ @@ -670,7 +681,6 @@ $(srcdir)/Makefile.in: @MAINTAINER_MODE_TRUE@ $(srcdir)/Makefile.am $(am__confi echo ' cd $(top_srcdir) && $(AUTOMAKE) --gnu clients/tui/Makefile'; \ $(am__cd) $(top_srcdir) && \ $(AUTOMAKE) --gnu clients/tui/Makefile -.PRECIOUS: Makefile Makefile: $(srcdir)/Makefile.in $(top_builddir)/config.status @case '$?' in \ *config.status*) \ @@ -794,14 +804,14 @@ distclean-compile: @am__fastdepCC_TRUE@ $(AM_V_at)$(am__mv) $(DEPDIR)/$*.Tpo $(DEPDIR)/$*.Po @AMDEP_TRUE@@am__fastdepCC_FALSE@ $(AM_V_CC)source='$<' object='$@' libtool=no @AMDEPBACKSLASH@ @AMDEP_TRUE@@am__fastdepCC_FALSE@ DEPDIR=$(DEPDIR) $(CCDEPMODE) $(depcomp) @AMDEPBACKSLASH@ -@am__fastdepCC_FALSE@ $(AM_V_CC@am__nodep@)$(COMPILE) -c $< +@am__fastdepCC_FALSE@ $(AM_V_CC@am__nodep@)$(COMPILE) -c -o $@ $< .c.obj: @am__fastdepCC_TRUE@ $(AM_V_CC)$(COMPILE) -MT $@ -MD -MP -MF $(DEPDIR)/$*.Tpo -c -o $@ `$(CYGPATH_W) '$<'` @am__fastdepCC_TRUE@ $(AM_V_at)$(am__mv) $(DEPDIR)/$*.Tpo $(DEPDIR)/$*.Po @AMDEP_TRUE@@am__fastdepCC_FALSE@ $(AM_V_CC)source='$<' object='$@' libtool=no @AMDEPBACKSLASH@ @AMDEP_TRUE@@am__fastdepCC_FALSE@ DEPDIR=$(DEPDIR) $(CCDEPMODE) $(depcomp) @AMDEPBACKSLASH@ -@am__fastdepCC_FALSE@ $(AM_V_CC@am__nodep@)$(COMPILE) -c `$(CYGPATH_W) '$<'` +@am__fastdepCC_FALSE@ $(AM_V_CC@am__nodep@)$(COMPILE) -c -o $@ `$(CYGPATH_W) '$<'` .c.lo: @am__fastdepCC_TRUE@ $(AM_V_CC)$(LTCOMPILE) -MT $@ -MD -MP -MF $(DEPDIR)/$*.Tpo -c -o $@ $< @@ -1115,6 +1125,8 @@ uninstall-am: uninstall-binPROGRAMS tags tags-am uninstall uninstall-am uninstall-binPROGRAMS \ uninstall-hook +.PRECIOUS: Makefile + @BUILD_NMTUI_TRUE@install-exec-hook: @BUILD_NMTUI_TRUE@ for link in $(links); do \ diff --git a/clients/tui/newt/Makefile.in b/clients/tui/newt/Makefile.in index 64abce69..1a510bb7 100644 --- a/clients/tui/newt/Makefile.in +++ b/clients/tui/newt/Makefile.in @@ -1,7 +1,7 @@ -# Makefile.in generated by automake 1.13.4 from Makefile.am. +# Makefile.in generated by automake 1.15 from Makefile.am. # @configure_input@ -# Copyright (C) 1994-2013 Free Software Foundation, Inc. +# Copyright (C) 1994-2014 Free Software Foundation, Inc. # This Makefile.in is free software; the Free Software Foundation # gives unlimited permission to copy and/or distribute it, @@ -15,7 +15,17 @@ @SET_MAKE@ VPATH = @srcdir@ -am__is_gnu_make = test -n '$(MAKEFILE_LIST)' && test -n '$(MAKELEVEL)' +am__is_gnu_make = { \ + if test -z '$(MAKELEVEL)'; then \ + false; \ + elif test -n '$(MAKE_HOST)'; then \ + true; \ + elif test -n '$(MAKE_VERSION)' && test -n '$(CURDIR)'; then \ + true; \ + else \ + false; \ + fi; \ +} am__make_running_with_option = \ case $${target_option-} in \ ?) ;; \ @@ -79,8 +89,6 @@ POST_UNINSTALL = : build_triplet = @build@ host_triplet = @host@ subdir = clients/tui/newt -DIST_COMMON = $(srcdir)/Makefile.in $(srcdir)/Makefile.am \ - $(top_srcdir)/build-aux/depcomp ACLOCAL_M4 = $(top_srcdir)/aclocal.m4 am__aclocal_m4_deps = $(top_srcdir)/m4/ax_lib_readline.m4 \ $(top_srcdir)/m4/compiler_warnings.m4 \ @@ -97,6 +105,7 @@ am__aclocal_m4_deps = $(top_srcdir)/m4/ax_lib_readline.m4 \ $(top_srcdir)/m4/vapigen.m4 $(top_srcdir)/configure.ac am__configure_deps = $(am__aclocal_m4_deps) $(CONFIGURE_DEPENDENCIES) \ $(ACLOCAL_M4) +DIST_COMMON = $(srcdir)/Makefile.am $(am__DIST_COMMON) mkinstalldirs = $(install_sh) -d CONFIG_HEADER = $(top_builddir)/config.h CONFIG_CLEAN_FILES = @@ -185,6 +194,8 @@ am__define_uniq_tagged_files = \ done | $(am__uniquify_input)` ETAGS = etags CTAGS = ctags +am__DIST_COMMON = $(srcdir)/Makefile.in \ + $(top_srcdir)/build-aux/depcomp DISTFILES = $(DIST_COMMON) $(DIST_SOURCES) $(TEXINFOS) $(EXTRA_DIST) ACLOCAL = @ACLOCAL@ ALL_LINGUAS = @ALL_LINGUAS@ @@ -211,7 +222,6 @@ CXXCPP = @CXXCPP@ CXXDEPMODE = @CXXDEPMODE@ CXXFLAGS = @CXXFLAGS@ CYGPATH_W = @CYGPATH_W@ -DATADIRNAME = @DATADIRNAME@ DBUS_CFLAGS = @DBUS_CFLAGS@ DBUS_GLIB_100_CFLAGS = @DBUS_GLIB_100_CFLAGS@ DBUS_GLIB_100_LIBS = @DBUS_GLIB_100_LIBS@ @@ -246,6 +256,7 @@ GNUTLS_CFLAGS = @GNUTLS_CFLAGS@ GNUTLS_LIBS = @GNUTLS_LIBS@ GREP = @GREP@ GTKDOC_CHECK = @GTKDOC_CHECK@ +GTKDOC_CHECK_PATH = @GTKDOC_CHECK_PATH@ GTKDOC_DEPS_CFLAGS = @GTKDOC_DEPS_CFLAGS@ GTKDOC_DEPS_LIBS = @GTKDOC_DEPS_LIBS@ GTKDOC_MKPDF = @GTKDOC_MKPDF@ @@ -515,7 +526,6 @@ $(srcdir)/Makefile.in: @MAINTAINER_MODE_TRUE@ $(srcdir)/Makefile.am $(am__confi echo ' cd $(top_srcdir) && $(AUTOMAKE) --gnu clients/tui/newt/Makefile'; \ $(am__cd) $(top_srcdir) && \ $(AUTOMAKE) --gnu clients/tui/newt/Makefile -.PRECIOUS: Makefile Makefile: $(srcdir)/Makefile.in $(top_builddir)/config.status @case '$?' in \ *config.status*) \ @@ -574,14 +584,14 @@ distclean-compile: @am__fastdepCC_TRUE@ $(AM_V_at)$(am__mv) $(DEPDIR)/$*.Tpo $(DEPDIR)/$*.Po @AMDEP_TRUE@@am__fastdepCC_FALSE@ $(AM_V_CC)source='$<' object='$@' libtool=no @AMDEPBACKSLASH@ @AMDEP_TRUE@@am__fastdepCC_FALSE@ DEPDIR=$(DEPDIR) $(CCDEPMODE) $(depcomp) @AMDEPBACKSLASH@ -@am__fastdepCC_FALSE@ $(AM_V_CC@am__nodep@)$(COMPILE) -c $< +@am__fastdepCC_FALSE@ $(AM_V_CC@am__nodep@)$(COMPILE) -c -o $@ $< .c.obj: @am__fastdepCC_TRUE@ $(AM_V_CC)$(COMPILE) -MT $@ -MD -MP -MF $(DEPDIR)/$*.Tpo -c -o $@ `$(CYGPATH_W) '$<'` @am__fastdepCC_TRUE@ $(AM_V_at)$(am__mv) $(DEPDIR)/$*.Tpo $(DEPDIR)/$*.Po @AMDEP_TRUE@@am__fastdepCC_FALSE@ $(AM_V_CC)source='$<' object='$@' libtool=no @AMDEPBACKSLASH@ @AMDEP_TRUE@@am__fastdepCC_FALSE@ DEPDIR=$(DEPDIR) $(CCDEPMODE) $(depcomp) @AMDEPBACKSLASH@ -@am__fastdepCC_FALSE@ $(AM_V_CC@am__nodep@)$(COMPILE) -c `$(CYGPATH_W) '$<'` +@am__fastdepCC_FALSE@ $(AM_V_CC@am__nodep@)$(COMPILE) -c -o $@ `$(CYGPATH_W) '$<'` .c.lo: @am__fastdepCC_TRUE@ $(AM_V_CC)$(LTCOMPILE) -MT $@ -MD -MP -MF $(DEPDIR)/$*.Tpo -c -o $@ $< @@ -799,6 +809,8 @@ uninstall-am: mostlyclean-generic mostlyclean-libtool pdf pdf-am ps ps-am \ tags tags-am uninstall uninstall-am +.PRECIOUS: Makefile + # Tell versions [3.59,3.63) of GNU make to not export all variables. # Otherwise a system limit (for SysV at least) may be exceeded. diff --git a/clients/tui/nmt-connect-connection-list.c b/clients/tui/nmt-connect-connection-list.c index 08058066..88502ba7 100644 --- a/clients/tui/nmt-connect-connection-list.c +++ b/clients/tui/nmt-connect-connection-list.c @@ -503,9 +503,11 @@ nmt_connect_connection_list_rebuild (NmtConnectConnectionList *list) for (diter = nmt_devices; diter; diter = diter->next) { nmtdev = diter->data; - if (diter != nmt_devices) - nmt_newt_listbox_append (listbox, "", NULL); - nmt_newt_listbox_append (listbox, nmtdev->name, NULL); + if (nmtdev->conns) { + if (diter != nmt_devices) + nmt_newt_listbox_append (listbox, "", NULL); + nmt_newt_listbox_append (listbox, nmtdev->name, NULL); + } for (citer = nmtdev->conns; citer; citer = citer->next) { nmtconn = citer->data; diff --git a/clients/tui/nmt-editor.c b/clients/tui/nmt-editor.c index 11fe758d..abc92866 100644 --- a/clients/tui/nmt-editor.c +++ b/clients/tui/nmt-editor.c @@ -256,7 +256,7 @@ permissions_transform_from_allusers (GBinding *binding, gboolean allusers = g_value_get_boolean (source_value); char **perms = NULL; - if (allusers) { + if (!allusers) { perms = g_new (char *, 2); perms[0] = g_strdup_printf ("user:%s:", g_get_user_name ()); diff --git a/clients/tui/nmt-page-dsl.c b/clients/tui/nmt-page-dsl.c index e8894d1a..1d476aa0 100644 --- a/clients/tui/nmt-page-dsl.c +++ b/clients/tui/nmt-page-dsl.c @@ -136,6 +136,8 @@ nmt_page_dsl_class_init (NmtPageDslClass *dsl_class) { GObjectClass *object_class = G_OBJECT_CLASS (dsl_class); + g_type_class_add_private (object_class, sizeof (NmtPageDslPrivate)); + object_class->constructed = nmt_page_dsl_constructed; object_class->finalize = nmt_page_dsl_finalize; } diff --git a/config.h.in b/config.h.in index 9e17255d..3783b160 100644 --- a/config.h.in +++ b/config.h.in @@ -145,9 +145,6 @@ /* git commit id of the original source code version */ #undef NM_GIT_SHA -/* Define to 1 if your C compiler doesn't accept -c and -o together. */ -#undef NO_MINUS_C_MINUS_O - /* Name of package */ #undef PACKAGE diff --git a/configure b/configure index 573f3c02..53d73d47 100755 --- a/configure +++ b/configure @@ -1,6 +1,6 @@ #! /bin/sh # Guess values for system-dependent variables and create Makefiles. -# Generated by GNU Autoconf 2.69 for NetworkManager 1.0.0. +# Generated by GNU Autoconf 2.69 for NetworkManager 1.0.2. # # Report bugs to . # @@ -591,8 +591,8 @@ MAKEFLAGS= # Identity of this package. PACKAGE_NAME='NetworkManager' PACKAGE_TARNAME='NetworkManager' -PACKAGE_VERSION='1.0.0' -PACKAGE_STRING='NetworkManager 1.0.0' +PACKAGE_VERSION='1.0.2' +PACKAGE_STRING='NetworkManager 1.0.2' PACKAGE_BUGREPORT='http://bugzilla.gnome.org/enter_bug.cgi?product=NetworkManager' PACKAGE_URL='' @@ -656,12 +656,17 @@ GTK_DOC_BUILD_HTML_FALSE GTK_DOC_BUILD_HTML_TRUE ENABLE_GTK_DOC_FALSE ENABLE_GTK_DOC_TRUE +HAVE_GTK_DOC_FALSE +HAVE_GTK_DOC_TRUE GTKDOC_DEPS_LIBS GTKDOC_DEPS_CFLAGS HTML_DIR GTKDOC_MKPDF GTKDOC_REBASE +GTKDOC_CHECK_PATH GTKDOC_CHECK +WITH_VALGRIND_FALSE +WITH_VALGRIND_TRUE VALGRIND_RULES REQUIRE_ROOT_TESTS_FALSE REQUIRE_ROOT_TESTS_TRUE @@ -838,7 +843,6 @@ XGETTEXT_015 GMSGFMT_015 MSGFMT_015 GETTEXT_MACRO_VERSION -DATADIRNAME ALL_LINGUAS INTLTOOL_PERL GMSGFMT @@ -1668,7 +1672,7 @@ if test "$ac_init_help" = "long"; then # Omit some internal or obsolete options to make the list less imposing. # This message is too long to be a string in the A/UX 3.1 sh. cat <<_ACEOF -\`configure' configures NetworkManager 1.0.0 to adapt to many kinds of systems. +\`configure' configures NetworkManager 1.0.2 to adapt to many kinds of systems. Usage: $0 [OPTION]... [VAR=VALUE]... @@ -1738,7 +1742,7 @@ fi if test -n "$ac_init_help"; then case $ac_init_help in - short | recursive ) echo "Configuration of NetworkManager 1.0.0:";; + short | recursive ) echo "Configuration of NetworkManager 1.0.2:";; esac cat <<\_ACEOF @@ -1857,8 +1861,7 @@ Optional Packages: --with-libsoup=yes|no Link against libsoup --with-nmtui=yes|no Build nmtui --with-valgrind=yes|no|path - Use valgrind to memory-check the tests (default: - yes) + Use valgrind to memory-check the tests (default: no) --with-tests Build NetworkManager tests (deprecated) --with-html-dir=PATH path to installed docs @@ -2016,7 +2019,7 @@ fi test -n "$ac_init_help" && exit $ac_status if $ac_init_version; then cat <<\_ACEOF -NetworkManager configure 1.0.0 +NetworkManager configure 1.0.2 generated by GNU Autoconf 2.69 Copyright (C) 2012 Free Software Foundation, Inc. @@ -2560,7 +2563,7 @@ cat >config.log <<_ACEOF This file contains any messages produced by compilers while running configure, to aid debugging if configure makes a mistake. -It was created by NetworkManager $as_me 1.0.0, which was +It was created by NetworkManager $as_me 1.0.2, which was generated by GNU Autoconf 2.69. Invocation command line was $ $0 $@ @@ -2944,7 +2947,7 @@ ac_configure="$SHELL $ac_aux_dir/configure" # Please don't use this var. -am__api_version='1.13' +am__api_version='1.15' # Find a good install program. We prefer a C program (faster), # so one script is as good as another. But avoid the broken or @@ -3116,8 +3119,8 @@ test "$program_suffix" != NONE && ac_script='s/[\\$]/&&/g;s/;s,x,x,$//' program_transform_name=`$as_echo "$program_transform_name" | sed "$ac_script"` -# expand $ac_aux_dir to an absolute path -am_aux_dir=`cd $ac_aux_dir && pwd` +# Expand $ac_aux_dir to an absolute path. +am_aux_dir=`cd "$ac_aux_dir" && pwd` if test x"${MISSING+set}" != xset; then case $am_aux_dir in @@ -3136,7 +3139,7 @@ else $as_echo "$as_me: WARNING: 'missing' script is too old or missing" >&2;} fi -if test x"${install_sh}" != xset; then +if test x"${install_sh+set}" != xset; then case $am_aux_dir in *\ * | *\ *) install_sh="\${SHELL} '$am_aux_dir/install-sh'" ;; @@ -3430,7 +3433,7 @@ fi # Define the identity of the package. PACKAGE='NetworkManager' - VERSION='1.0.0' + VERSION='1.0.2' cat >>confdefs.h <<_ACEOF @@ -3464,8 +3467,8 @@ MAKEINFO=${MAKEINFO-"${am_missing_run}makeinfo"} # mkdir_p='$(MKDIR_P)' -# We need awk for the "check" target. The system "awk" is bad on -# some platforms. +# We need awk for the "check" target (and possibly the TAP driver). The +# system "awk" is bad on some platforms. # Always define AMTAR for backward compatibility. Yes, it's still used # in the wild :-( We should find a proper way to deprecate it ... AMTAR='$${TAR-tar}' @@ -3597,6 +3600,48 @@ $as_echo "$am_cv_prog_tar_ustar" >&6; } +# POSIX will say in a future version that running "rm -f" with no argument +# is OK; and we want to be able to make that assumption in our Makefile +# recipes. So use an aggressive probe to check that the usage we want is +# actually supported "in the wild" to an acceptable degree. +# See automake bug#10828. +# To make any issue more visible, cause the running configure to be aborted +# by default if the 'rm' program in use doesn't match our expectations; the +# user can still override this though. +if rm -f && rm -fr && rm -rf; then : OK; else + cat >&2 <<'END' +Oops! + +Your 'rm' program seems unable to run without file operands specified +on the command line, even when the '-f' option is present. This is contrary +to the behaviour of most rm programs out there, and not conforming with +the upcoming POSIX standard: + +Please tell bug-automake@gnu.org about your system, including the value +of your $PATH and any error possibly output before this message. This +can help us improve future automake versions. + +END + if test x"$ACCEPT_INFERIOR_RM_PROGRAM" = x"yes"; then + echo 'Configuration will proceed anyway, since you have set the' >&2 + echo 'ACCEPT_INFERIOR_RM_PROGRAM variable to "yes"' >&2 + echo >&2 + else + cat >&2 <<'END' +Aborting the configuration process, to ensure you take notice of the issue. + +You can download and install GNU coreutils to get an 'rm' implementation +that behaves properly: . + +If you want to complete the configuration process using your problematic +'rm' anyway, export the environment variable ACCEPT_INFERIOR_RM_PROGRAM +to "yes", and re-run configure. + +END + as_fn_error $? "Your 'rm' program is bad, sorry." "$LINENO" 5 + fi +fi + { $as_echo "$as_me:${as_lineno-$LINENO}: checking whether to enable maintainer-specific portions of Makefiles" >&5 $as_echo_n "checking whether to enable maintainer-specific portions of Makefiles... " >&6; } # Check whether --enable-maintainer-mode was given. @@ -4511,6 +4556,65 @@ ac_compile='$CC -c $CFLAGS $CPPFLAGS conftest.$ac_ext >&5' ac_link='$CC -o conftest$ac_exeext $CFLAGS $CPPFLAGS $LDFLAGS conftest.$ac_ext $LIBS >&5' ac_compiler_gnu=$ac_cv_c_compiler_gnu +ac_ext=c +ac_cpp='$CPP $CPPFLAGS' +ac_compile='$CC -c $CFLAGS $CPPFLAGS conftest.$ac_ext >&5' +ac_link='$CC -o conftest$ac_exeext $CFLAGS $CPPFLAGS $LDFLAGS conftest.$ac_ext $LIBS >&5' +ac_compiler_gnu=$ac_cv_c_compiler_gnu +{ $as_echo "$as_me:${as_lineno-$LINENO}: checking whether $CC understands -c and -o together" >&5 +$as_echo_n "checking whether $CC understands -c and -o together... " >&6; } +if ${am_cv_prog_cc_c_o+:} false; then : + $as_echo_n "(cached) " >&6 +else + cat confdefs.h - <<_ACEOF >conftest.$ac_ext +/* end confdefs.h. */ + +int +main () +{ + + ; + return 0; +} +_ACEOF + # Make sure it works both with $CC and with simple cc. + # Following AC_PROG_CC_C_O, we do the test twice because some + # compilers refuse to overwrite an existing .o file with -o, + # though they will create one. + am_cv_prog_cc_c_o=yes + for am_i in 1 2; do + if { echo "$as_me:$LINENO: $CC -c conftest.$ac_ext -o conftest2.$ac_objext" >&5 + ($CC -c conftest.$ac_ext -o conftest2.$ac_objext) >&5 2>&5 + ac_status=$? + echo "$as_me:$LINENO: \$? = $ac_status" >&5 + (exit $ac_status); } \ + && test -f conftest2.$ac_objext; then + : OK + else + am_cv_prog_cc_c_o=no + break + fi + done + rm -f core conftest* + unset am_i +fi +{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $am_cv_prog_cc_c_o" >&5 +$as_echo "$am_cv_prog_cc_c_o" >&6; } +if test "$am_cv_prog_cc_c_o" != yes; then + # Losing compiler, so override with the script. + # FIXME: It is wrong to rewrite CC. + # But if we don't then we get into trouble of one sort or another. + # A longer-term fix would be to have automake use am__CC in this case, + # and then we could set am__CC="\$(top_srcdir)/compile \$(CC)" + CC="$am_aux_dir/compile $CC" +fi +ac_ext=c +ac_cpp='$CPP $CPPFLAGS' +ac_compile='$CC -c $CFLAGS $CPPFLAGS conftest.$ac_ext >&5' +ac_link='$CC -o conftest$ac_exeext $CFLAGS $CPPFLAGS $LDFLAGS conftest.$ac_ext $LIBS >&5' +ac_compiler_gnu=$ac_cv_c_compiler_gnu + + depcc="$CC" am_compiler_list= { $as_echo "$as_me:${as_lineno-$LINENO}: checking dependency style of $depcc" >&5 @@ -5638,6 +5742,65 @@ ac_compile='$CC -c $CFLAGS $CPPFLAGS conftest.$ac_ext >&5' ac_link='$CC -o conftest$ac_exeext $CFLAGS $CPPFLAGS $LDFLAGS conftest.$ac_ext $LIBS >&5' ac_compiler_gnu=$ac_cv_c_compiler_gnu +ac_ext=c +ac_cpp='$CPP $CPPFLAGS' +ac_compile='$CC -c $CFLAGS $CPPFLAGS conftest.$ac_ext >&5' +ac_link='$CC -o conftest$ac_exeext $CFLAGS $CPPFLAGS $LDFLAGS conftest.$ac_ext $LIBS >&5' +ac_compiler_gnu=$ac_cv_c_compiler_gnu +{ $as_echo "$as_me:${as_lineno-$LINENO}: checking whether $CC understands -c and -o together" >&5 +$as_echo_n "checking whether $CC understands -c and -o together... " >&6; } +if ${am_cv_prog_cc_c_o+:} false; then : + $as_echo_n "(cached) " >&6 +else + cat confdefs.h - <<_ACEOF >conftest.$ac_ext +/* end confdefs.h. */ + +int +main () +{ + + ; + return 0; +} +_ACEOF + # Make sure it works both with $CC and with simple cc. + # Following AC_PROG_CC_C_O, we do the test twice because some + # compilers refuse to overwrite an existing .o file with -o, + # though they will create one. + am_cv_prog_cc_c_o=yes + for am_i in 1 2; do + if { echo "$as_me:$LINENO: $CC -c conftest.$ac_ext -o conftest2.$ac_objext" >&5 + ($CC -c conftest.$ac_ext -o conftest2.$ac_objext) >&5 2>&5 + ac_status=$? + echo "$as_me:$LINENO: \$? = $ac_status" >&5 + (exit $ac_status); } \ + && test -f conftest2.$ac_objext; then + : OK + else + am_cv_prog_cc_c_o=no + break + fi + done + rm -f core conftest* + unset am_i +fi +{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $am_cv_prog_cc_c_o" >&5 +$as_echo "$am_cv_prog_cc_c_o" >&6; } +if test "$am_cv_prog_cc_c_o" != yes; then + # Losing compiler, so override with the script. + # FIXME: It is wrong to rewrite CC. + # But if we don't then we get into trouble of one sort or another. + # A longer-term fix would be to have automake use am__CC in this case, + # and then we could set am__CC="\$(top_srcdir)/compile \$(CC)" + CC="$am_aux_dir/compile $CC" +fi +ac_ext=c +ac_cpp='$CPP $CPPFLAGS' +ac_compile='$CC -c $CFLAGS $CPPFLAGS conftest.$ac_ext >&5' +ac_link='$CC -o conftest$ac_exeext $CFLAGS $CPPFLAGS $LDFLAGS conftest.$ac_ext $LIBS >&5' +ac_compiler_gnu=$ac_cv_c_compiler_gnu + + depcc="$CC" am_compiler_list= { $as_echo "$as_me:${as_lineno-$LINENO}: checking dependency style of $depcc" >&5 @@ -5766,131 +5929,6 @@ else fi -if test "x$CC" != xcc; then - { $as_echo "$as_me:${as_lineno-$LINENO}: checking whether $CC and cc understand -c and -o together" >&5 -$as_echo_n "checking whether $CC and cc understand -c and -o together... " >&6; } -else - { $as_echo "$as_me:${as_lineno-$LINENO}: checking whether cc understands -c and -o together" >&5 -$as_echo_n "checking whether cc understands -c and -o together... " >&6; } -fi -set dummy $CC; ac_cc=`$as_echo "$2" | - sed 's/[^a-zA-Z0-9_]/_/g;s/^[0-9]/_/'` -if eval \${ac_cv_prog_cc_${ac_cc}_c_o+:} false; then : - $as_echo_n "(cached) " >&6 -else - cat confdefs.h - <<_ACEOF >conftest.$ac_ext -/* end confdefs.h. */ - -int -main () -{ - - ; - return 0; -} -_ACEOF -# Make sure it works both with $CC and with simple cc. -# We do the test twice because some compilers refuse to overwrite an -# existing .o file with -o, though they will create one. -ac_try='$CC -c conftest.$ac_ext -o conftest2.$ac_objext >&5' -rm -f conftest2.* -if { { case "(($ac_try" in - *\"* | *\`* | *\\*) ac_try_echo=\$ac_try;; - *) ac_try_echo=$ac_try;; -esac -eval ac_try_echo="\"\$as_me:${as_lineno-$LINENO}: $ac_try_echo\"" -$as_echo "$ac_try_echo"; } >&5 - (eval "$ac_try") 2>&5 - ac_status=$? - $as_echo "$as_me:${as_lineno-$LINENO}: \$? = $ac_status" >&5 - test $ac_status = 0; } && - test -f conftest2.$ac_objext && { { case "(($ac_try" in - *\"* | *\`* | *\\*) ac_try_echo=\$ac_try;; - *) ac_try_echo=$ac_try;; -esac -eval ac_try_echo="\"\$as_me:${as_lineno-$LINENO}: $ac_try_echo\"" -$as_echo "$ac_try_echo"; } >&5 - (eval "$ac_try") 2>&5 - ac_status=$? - $as_echo "$as_me:${as_lineno-$LINENO}: \$? = $ac_status" >&5 - test $ac_status = 0; }; -then - eval ac_cv_prog_cc_${ac_cc}_c_o=yes - if test "x$CC" != xcc; then - # Test first that cc exists at all. - if { ac_try='cc -c conftest.$ac_ext >&5' - { { case "(($ac_try" in - *\"* | *\`* | *\\*) ac_try_echo=\$ac_try;; - *) ac_try_echo=$ac_try;; -esac -eval ac_try_echo="\"\$as_me:${as_lineno-$LINENO}: $ac_try_echo\"" -$as_echo "$ac_try_echo"; } >&5 - (eval "$ac_try") 2>&5 - ac_status=$? - $as_echo "$as_me:${as_lineno-$LINENO}: \$? = $ac_status" >&5 - test $ac_status = 0; }; }; then - ac_try='cc -c conftest.$ac_ext -o conftest2.$ac_objext >&5' - rm -f conftest2.* - if { { case "(($ac_try" in - *\"* | *\`* | *\\*) ac_try_echo=\$ac_try;; - *) ac_try_echo=$ac_try;; -esac -eval ac_try_echo="\"\$as_me:${as_lineno-$LINENO}: $ac_try_echo\"" -$as_echo "$ac_try_echo"; } >&5 - (eval "$ac_try") 2>&5 - ac_status=$? - $as_echo "$as_me:${as_lineno-$LINENO}: \$? = $ac_status" >&5 - test $ac_status = 0; } && - test -f conftest2.$ac_objext && { { case "(($ac_try" in - *\"* | *\`* | *\\*) ac_try_echo=\$ac_try;; - *) ac_try_echo=$ac_try;; -esac -eval ac_try_echo="\"\$as_me:${as_lineno-$LINENO}: $ac_try_echo\"" -$as_echo "$ac_try_echo"; } >&5 - (eval "$ac_try") 2>&5 - ac_status=$? - $as_echo "$as_me:${as_lineno-$LINENO}: \$? = $ac_status" >&5 - test $ac_status = 0; }; - then - # cc works too. - : - else - # cc exists but doesn't like -o. - eval ac_cv_prog_cc_${ac_cc}_c_o=no - fi - fi - fi -else - eval ac_cv_prog_cc_${ac_cc}_c_o=no -fi -rm -f core conftest* - -fi -if eval test \$ac_cv_prog_cc_${ac_cc}_c_o = yes; then - { $as_echo "$as_me:${as_lineno-$LINENO}: result: yes" >&5 -$as_echo "yes" >&6; } -else - { $as_echo "$as_me:${as_lineno-$LINENO}: result: no" >&5 -$as_echo "no" >&6; } - -$as_echo "#define NO_MINUS_C_MINUS_O 1" >>confdefs.h - -fi - -# FIXME: we rely on the cache variable name because -# there is no other way. -set dummy $CC -am_cc=`echo $2 | sed 's/[^a-zA-Z0-9_]/_/g;s/^[0-9]/_/'` -eval am_t=\$ac_cv_prog_cc_${am_cc}_c_o -if test "$am_t" != yes; then - # Losing compiler, so override with the script. - # FIXME: It is wrong to rewrite CC. - # But if we don't then we get into trouble of one sort or another. - # A longer-term fix would be to have automake use am__CC in this case, - # and then we could set am__CC="\$(top_srcdir)/compile \$(CC)" - CC="$am_aux_dir/compile $CC" -fi - # C++ only required if --enable-qt=yes @@ -16680,9 +16718,9 @@ ac_compiler_gnu=$ac_cv_c_compiler_gnu NM_MAJOR_VERSION=1 NM_MINOR_VERSION=0 -NM_MICRO_VERSION=0 -NM_VERSION=1.0.0 -NM_GIT_SHA=acdaf78a068b6c65ba799a7098b867953db4801c +NM_MICRO_VERSION=2 +NM_VERSION=1.0.2 +NM_GIT_SHA=4e6481cb733611543d22e06831db63b0e23af3f9 @@ -17244,44 +17282,6 @@ fi # Substitute ALL_LINGUAS so we can use it in po/Makefile -# Set DATADIRNAME correctly if it is not set yet -# (copied from glib-gettext.m4) -if test -z "$DATADIRNAME"; then - cat confdefs.h - <<_ACEOF >conftest.$ac_ext -/* end confdefs.h. */ - -int -main () -{ -extern int _nl_msg_cat_cntr; - return _nl_msg_cat_cntr - ; - return 0; -} -_ACEOF -if ac_fn_c_try_link "$LINENO"; then : - DATADIRNAME=share -else - case $host in - *-*-solaris*) - ac_fn_c_check_func "$LINENO" "bind_textdomain_codeset" "ac_cv_func_bind_textdomain_codeset" -if test "x$ac_cv_func_bind_textdomain_codeset" = xyes; then : - DATADIRNAME=share -else - DATADIRNAME=lib -fi - - ;; - *) - DATADIRNAME=lib - ;; - esac -fi -rm -f core conftest.err conftest.$ac_objext \ - conftest$ac_exeext conftest.$ac_ext -fi - - @@ -21047,7 +21047,7 @@ else fi if (test "$with_udev_dir" != 'no'); then - if (test "$with_udev_dir" != 'yes' && echo -n "$with_udev_dir" | grep -v -q '^/'); then + if (test "$with_udev_dir" != 'yes' && printf '%s' "$with_udev_dir" | grep -v -q '^/'); then as_fn_error $? "--with-udev-dir must be an absolute path or 'yes' or 'no'. Instead it is '$with_udev_dir'" "$LINENO" 5 fi if (test "$with_udev_dir" = 'yes'); then @@ -23524,11 +23524,11 @@ done test -n "$with_dhcpcd" || with_dhcpcd="no" if test "$with_dhcpcd" != "no"; then - if ! $with_dhcpcd --version 2>&1 | grep -q "^dhcpcd [456789]\."; then + if ! $with_dhcpcd --version 2>&1 | grep -q "^dhcpcd 456789\."; then { $as_echo "$as_me:${as_lineno-$LINENO}: WARNING: Cannot use dhcpcd, version 4.x or higher is required" >&5 $as_echo "$as_me: WARNING: Cannot use dhcpcd, version 4.x or higher is required" >&2;} with_dhcpcd=no - elif $with_dhcpcd --version 2>&1 | grep -q "^dhcpcd [6789]\."; then + elif $with_dhcpcd --version 2>&1 | grep -q "^dhcpcd 6789\."; then $as_echo "#define DHCPCD_SUPPORTS_IPV6 1" >>confdefs.h @@ -24210,32 +24210,68 @@ $as_echo_n "checking for more warnings... " >&6; } if test "$GCC" = "yes" -a "$set_more_warnings" != "no"; then { $as_echo "$as_me:${as_lineno-$LINENO}: result: yes" >&5 $as_echo "yes" >&6; } + + CFLAGS_SAVED="$CFLAGS" + CFLAGS="$CFLAGS -Qunused-arguments" + cat confdefs.h - <<_ACEOF >conftest.$ac_ext +/* end confdefs.h. */ + +_ACEOF +if ac_fn_c_try_compile "$LINENO"; then : + +else + CFLAGS="$CFLAGS_SAVED" +fi +rm -f core conftest.err conftest.$ac_objext conftest.$ac_ext + unset CFLAGS_SAVED + + CFLAGS_SAVED="$CFLAGS" - CFLAGS_MORE_WARNINGS="-Wall -std=gnu89" + CFLAGS="$CFLAGS -Werror -Wunknown-warning-option" + { $as_echo "$as_me:${as_lineno-$LINENO}: checking whether -Wunknown-warning-option works" >&5 +$as_echo_n "checking whether -Wunknown-warning-option works... " >&6; } - CFLAGS_EXTRA="-Werror=unknown-warning-option" - CFLAGS="$CFLAGS_MORE_WARNINGS $CFLAGS_EXTRA $CFLAGS_SAVED" cat confdefs.h - <<_ACEOF >conftest.$ac_ext /* end confdefs.h. */ -int -main () -{ +_ACEOF +if ac_fn_c_try_compile "$LINENO"; then : + + cat confdefs.h - <<_ACEOF >conftest.$ac_ext +/* end confdefs.h. */ - ; - return 0; -} _ACEOF if ac_fn_c_try_compile "$LINENO"; then : - has_option=yes + + { $as_echo "$as_me:${as_lineno-$LINENO}: result: yes" >&5 +$as_echo "yes" >&6; } + CFLAGS="$CFLAGS_SAVED -Wunknown-warning-option" + else - has_option=no + + { $as_echo "$as_me:${as_lineno-$LINENO}: result: no" >&5 +$as_echo "no" >&6; } + CFLAGS="$CFLAGS_SAVED -Wno-unknown-warning-option" + fi rm -f core conftest.err conftest.$ac_objext conftest.$ac_ext - if test $has_option = no; then - CFLAGS_EXTRA= + +else + + { $as_echo "$as_me:${as_lineno-$LINENO}: result: not supported" >&5 +$as_echo "not supported" >&6; } + CFLAGS="$CFLAGS_SAVED" + +fi +rm -f core conftest.err conftest.$ac_objext conftest.$ac_ext + + + CFLAGS_SAVED="$CFLAGS" + CFLAGS_MORE_WARNINGS="-Wall -std=gnu89" + + if test "x$set_more_warnings" = xerror; then + CFLAGS_MORE_WARNINGS="$CFLAGS_MORE_WARNINGS -Werror" fi - unset has_option for option in -Wshadow -Wmissing-declarations -Wmissing-prototypes \ -Wdeclaration-after-statement -Wformat-security \ @@ -24244,10 +24280,10 @@ rm -f core conftest.err conftest.$ac_objext conftest.$ac_ext -fno-strict-aliasing -Wno-unused-but-set-variable \ -Wundef -Wimplicit-function-declaration \ -Wpointer-arith -Winit-self \ - -Wmissing-include-dirs; do - CFLAGS="$CFLAGS_MORE_WARNINGS $CFLAGS_EXTRA $option $CFLAGS_SAVED" - { $as_echo "$as_me:${as_lineno-$LINENO}: checking whether gcc understands $option" >&5 -$as_echo_n "checking whether gcc understands $option... " >&6; } + -Wmissing-include-dirs -Wno-pragmas; do + CFLAGS="$CFLAGS_MORE_WARNINGS $(printf '%s' "$option" | sed 's/^-Wno-/-W/') $CFLAGS_SAVED" + { $as_echo "$as_me:${as_lineno-$LINENO}: checking whether compiler understands $option" >&5 +$as_echo_n "checking whether compiler understands $option... " >&6; } cat confdefs.h - <<_ACEOF >conftest.$ac_ext /* end confdefs.h. */ @@ -24273,12 +24309,223 @@ $as_echo "$has_option" >&6; } unset has_option done unset option - unset CFLAGS_EXTRA - if test "x$set_more_warnings" = xerror; then - CFLAGS_MORE_WARNINGS="$CFLAGS_MORE_WARNINGS -Werror" - fi - CFLAGS="$CFLAGS_MORE_WARNINGS $CFLAGS_SAVED" + + CFLAGS="$CFLAGS_SAVED" unset CFLAGS_SAVED + + + + CFLAGS_SAVED="$CFLAGS" + CFLAGS="$CFLAGS -Werror -Wunknown-attributes" + { $as_echo "$as_me:${as_lineno-$LINENO}: checking whether -Wunknown-attributes works" >&5 +$as_echo_n "checking whether -Wunknown-attributes works... " >&6; } + + cat confdefs.h - <<_ACEOF >conftest.$ac_ext +/* end confdefs.h. */ + +_ACEOF +if ac_fn_c_try_compile "$LINENO"; then : + + cat confdefs.h - <<_ACEOF >conftest.$ac_ext +/* end confdefs.h. */ +#include +_ACEOF +if ac_fn_c_try_compile "$LINENO"; then : + + { $as_echo "$as_me:${as_lineno-$LINENO}: result: yes" >&5 +$as_echo "yes" >&6; } + CFLAGS="$CFLAGS_SAVED -Wunknown-attributes" + +else + + { $as_echo "$as_me:${as_lineno-$LINENO}: result: no" >&5 +$as_echo "no" >&6; } + CFLAGS="$CFLAGS_SAVED -Wno-unknown-attributes" + +fi +rm -f core conftest.err conftest.$ac_objext conftest.$ac_ext + +else + + { $as_echo "$as_me:${as_lineno-$LINENO}: result: not supported" >&5 +$as_echo "not supported" >&6; } + CFLAGS="$CFLAGS_SAVED" + +fi +rm -f core conftest.err conftest.$ac_objext conftest.$ac_ext + + + + CFLAGS_SAVED="$CFLAGS" + CFLAGS="$CFLAGS -Werror -Wtypedef-redefinition" + { $as_echo "$as_me:${as_lineno-$LINENO}: checking whether -Wtypedef-redefinition works" >&5 +$as_echo_n "checking whether -Wtypedef-redefinition works... " >&6; } + + cat confdefs.h - <<_ACEOF >conftest.$ac_ext +/* end confdefs.h. */ + +_ACEOF +if ac_fn_c_try_compile "$LINENO"; then : + + cat confdefs.h - <<_ACEOF >conftest.$ac_ext +/* end confdefs.h. */ +#include +_ACEOF +if ac_fn_c_try_compile "$LINENO"; then : + + { $as_echo "$as_me:${as_lineno-$LINENO}: result: yes" >&5 +$as_echo "yes" >&6; } + CFLAGS="$CFLAGS_SAVED -Wtypedef-redefinition" + +else + + { $as_echo "$as_me:${as_lineno-$LINENO}: result: no" >&5 +$as_echo "no" >&6; } + CFLAGS="$CFLAGS_SAVED -Wno-typedef-redefinition" + +fi +rm -f core conftest.err conftest.$ac_objext conftest.$ac_ext + +else + + { $as_echo "$as_me:${as_lineno-$LINENO}: result: not supported" >&5 +$as_echo "not supported" >&6; } + CFLAGS="$CFLAGS_SAVED" + +fi +rm -f core conftest.err conftest.$ac_objext conftest.$ac_ext + + + + CFLAGS_SAVED="$CFLAGS" + CFLAGS="$CFLAGS -Werror -Warray-bounds" + { $as_echo "$as_me:${as_lineno-$LINENO}: checking whether -Warray-bounds works" >&5 +$as_echo_n "checking whether -Warray-bounds works... " >&6; } + + cat confdefs.h - <<_ACEOF >conftest.$ac_ext +/* end confdefs.h. */ + +_ACEOF +if ac_fn_c_try_compile "$LINENO"; then : + + cat confdefs.h - <<_ACEOF >conftest.$ac_ext +/* end confdefs.h. */ +#include + void f () { strcmp ("something", "0"); } + +_ACEOF +if ac_fn_c_try_compile "$LINENO"; then : + + { $as_echo "$as_me:${as_lineno-$LINENO}: result: yes" >&5 +$as_echo "yes" >&6; } + CFLAGS="$CFLAGS_SAVED -Warray-bounds" + +else + + { $as_echo "$as_me:${as_lineno-$LINENO}: result: no" >&5 +$as_echo "no" >&6; } + CFLAGS="$CFLAGS_SAVED -Wno-array-bounds" + +fi +rm -f core conftest.err conftest.$ac_objext conftest.$ac_ext + +else + + { $as_echo "$as_me:${as_lineno-$LINENO}: result: not supported" >&5 +$as_echo "not supported" >&6; } + CFLAGS="$CFLAGS_SAVED" + +fi +rm -f core conftest.err conftest.$ac_objext conftest.$ac_ext + + + + CFLAGS_SAVED="$CFLAGS" + CFLAGS="$CFLAGS -Werror -Wparentheses-equality" + { $as_echo "$as_me:${as_lineno-$LINENO}: checking whether -Wparentheses-equality works" >&5 +$as_echo_n "checking whether -Wparentheses-equality works... " >&6; } + + cat confdefs.h - <<_ACEOF >conftest.$ac_ext +/* end confdefs.h. */ + +_ACEOF +if ac_fn_c_try_compile "$LINENO"; then : + + cat confdefs.h - <<_ACEOF >conftest.$ac_ext +/* end confdefs.h. */ +#include + void f () { if (WIFCONTINUED(0)) return; } + +_ACEOF +if ac_fn_c_try_compile "$LINENO"; then : + + { $as_echo "$as_me:${as_lineno-$LINENO}: result: yes" >&5 +$as_echo "yes" >&6; } + CFLAGS="$CFLAGS_SAVED -Wparentheses-equality" + +else + + { $as_echo "$as_me:${as_lineno-$LINENO}: result: no" >&5 +$as_echo "no" >&6; } + CFLAGS="$CFLAGS_SAVED -Wno-parentheses-equality" + +fi +rm -f core conftest.err conftest.$ac_objext conftest.$ac_ext + +else + + { $as_echo "$as_me:${as_lineno-$LINENO}: result: not supported" >&5 +$as_echo "not supported" >&6; } + CFLAGS="$CFLAGS_SAVED" + +fi +rm -f core conftest.err conftest.$ac_objext conftest.$ac_ext + + + + CFLAGS_SAVED="$CFLAGS" + CFLAGS="$CFLAGS -Werror -Wunused-value" + { $as_echo "$as_me:${as_lineno-$LINENO}: checking whether -Wunused-value works" >&5 +$as_echo_n "checking whether -Wunused-value works... " >&6; } + + cat confdefs.h - <<_ACEOF >conftest.$ac_ext +/* end confdefs.h. */ + +_ACEOF +if ac_fn_c_try_compile "$LINENO"; then : + + cat confdefs.h - <<_ACEOF >conftest.$ac_ext +/* end confdefs.h. */ +#define yolo ({ (666 + 666); }) + int f () { int i = yolo; yolo; return i; } + +_ACEOF +if ac_fn_c_try_compile "$LINENO"; then : + + { $as_echo "$as_me:${as_lineno-$LINENO}: result: yes" >&5 +$as_echo "yes" >&6; } + CFLAGS="$CFLAGS_SAVED -Wunused-value" + +else + + { $as_echo "$as_me:${as_lineno-$LINENO}: result: no" >&5 +$as_echo "no" >&6; } + CFLAGS="$CFLAGS_SAVED -Wno-unused-value" + +fi +rm -f core conftest.err conftest.$ac_objext conftest.$ac_ext + +else + + { $as_echo "$as_me:${as_lineno-$LINENO}: result: not supported" >&5 +$as_echo "not supported" >&6; } + CFLAGS="$CFLAGS_SAVED" + +fi +rm -f core conftest.err conftest.$ac_objext conftest.$ac_ext + + + CFLAGS="$CFLAGS_MORE_WARNINGS $CFLAGS" else { $as_echo "$as_me:${as_lineno-$LINENO}: result: no" >&5 $as_echo "no" >&6; } @@ -24287,13 +24534,13 @@ fi # Check whether --enable-lto was given. if test "${enable_lto+set}" = set; then : - enableval=$enable_lto; enable_lto=yes -else - enable_lto=no + enableval=$enable_lto; fi if (test "${enable_lto}" = "yes"); then CFLAGS="-flto $CFLAGS" +else + enable_lto='no' fi @@ -24560,12 +24807,12 @@ fi if test -n "$with_tests"; then : enable_tests="$with_tests" fi -# Default to --enable-tests --with-valgrind +# Default to --enable-tests --with-valgrind=no if test -z "$enable_tests"; then : enable_tests="yes" fi if test -z "$with_valgrind"; then : - with_valgrind="yes" + with_valgrind="no" fi # Normalize values if test "$enable_tests" != "yes" -a "$enable_tests" != "root"; then : @@ -24641,20 +24888,90 @@ if test "$with_valgrind" != "no"; then : VALGRIND_RULES='TESTS_ENVIRONMENT = "$(top_srcdir)/tools/run-test-valgrind.sh" "$(LIBTOOL)" "$(with_valgrind)" "$(top_srcdir)/valgrind.suppressions"' fi + if test "${with_valgrind}" != "no"; then + WITH_VALGRIND_TRUE= + WITH_VALGRIND_FALSE='#' +else + WITH_VALGRIND_TRUE='#' + WITH_VALGRIND_FALSE= +fi + + + + + + gtk_doc_requires="gtk-doc >= 1.0" + { $as_echo "$as_me:${as_lineno-$LINENO}: checking for gtk-doc" >&5 +$as_echo_n "checking for gtk-doc... " >&6; } + if test -n "$PKG_CONFIG" && \ + { { $as_echo "$as_me:${as_lineno-$LINENO}: \$PKG_CONFIG --exists --print-errors \"\$gtk_doc_requires\""; } >&5 + ($PKG_CONFIG --exists --print-errors "$gtk_doc_requires") 2>&5 + ac_status=$? + $as_echo "$as_me:${as_lineno-$LINENO}: \$? = $ac_status" >&5 + test $ac_status = 0; }; then + have_gtk_doc=yes +else + have_gtk_doc=no +fi + { $as_echo "$as_me:${as_lineno-$LINENO}: result: $have_gtk_doc" >&5 +$as_echo "$have_gtk_doc" >&6; } + if test "$have_gtk_doc" = "no"; then + { $as_echo "$as_me:${as_lineno-$LINENO}: WARNING: + You will not be able to create source packages with 'make dist' + because $gtk_doc_requires is not found." >&5 +$as_echo "$as_me: WARNING: + You will not be able to create source packages with 'make dist' + because $gtk_doc_requires is not found." >&2;} + fi + + # Extract the first word of "gtkdoc-check", so it can be a program name with args. +set dummy gtkdoc-check; ac_word=$2 +{ $as_echo "$as_me:${as_lineno-$LINENO}: checking for $ac_word" >&5 +$as_echo_n "checking for $ac_word... " >&6; } +if ${ac_cv_prog_GTKDOC_CHECK+:} false; then : + $as_echo_n "(cached) " >&6 +else + if test -n "$GTKDOC_CHECK"; then + ac_cv_prog_GTKDOC_CHECK="$GTKDOC_CHECK" # Let the user override the test. +else +as_save_IFS=$IFS; IFS=$PATH_SEPARATOR +for as_dir in $PATH +do + IFS=$as_save_IFS + test -z "$as_dir" && as_dir=. + for ac_exec_ext in '' $ac_executable_extensions; do + if as_fn_executable_p "$as_dir/$ac_word$ac_exec_ext"; then + ac_cv_prog_GTKDOC_CHECK="gtkdoc-check.test" + $as_echo "$as_me:${as_lineno-$LINENO}: found $as_dir/$ac_word$ac_exec_ext" >&5 + break 2 + fi +done + done +IFS=$as_save_IFS +fi +fi +GTKDOC_CHECK=$ac_cv_prog_GTKDOC_CHECK +if test -n "$GTKDOC_CHECK"; then + { $as_echo "$as_me:${as_lineno-$LINENO}: result: $GTKDOC_CHECK" >&5 +$as_echo "$GTKDOC_CHECK" >&6; } +else + { $as_echo "$as_me:${as_lineno-$LINENO}: result: no" >&5 +$as_echo "no" >&6; } +fi - # Extract the first word of "gtkdoc-check", so it can be a program name with args. + # Extract the first word of "gtkdoc-check", so it can be a program name with args. set dummy gtkdoc-check; ac_word=$2 { $as_echo "$as_me:${as_lineno-$LINENO}: checking for $ac_word" >&5 $as_echo_n "checking for $ac_word... " >&6; } -if ${ac_cv_path_GTKDOC_CHECK+:} false; then : +if ${ac_cv_path_GTKDOC_CHECK_PATH+:} false; then : $as_echo_n "(cached) " >&6 else - case $GTKDOC_CHECK in + case $GTKDOC_CHECK_PATH in [\\/]* | ?:[\\/]*) - ac_cv_path_GTKDOC_CHECK="$GTKDOC_CHECK" # Let the user override the test with a path. + ac_cv_path_GTKDOC_CHECK_PATH="$GTKDOC_CHECK_PATH" # Let the user override the test with a path. ;; *) as_save_IFS=$IFS; IFS=$PATH_SEPARATOR @@ -24664,7 +24981,7 @@ do test -z "$as_dir" && as_dir=. for ac_exec_ext in '' $ac_executable_extensions; do if as_fn_executable_p "$as_dir/$ac_word$ac_exec_ext"; then - ac_cv_path_GTKDOC_CHECK="$as_dir/$ac_word$ac_exec_ext" + ac_cv_path_GTKDOC_CHECK_PATH="$as_dir/$ac_word$ac_exec_ext" $as_echo "$as_me:${as_lineno-$LINENO}: found $as_dir/$ac_word$ac_exec_ext" >&5 break 2 fi @@ -24675,10 +24992,10 @@ IFS=$as_save_IFS ;; esac fi -GTKDOC_CHECK=$ac_cv_path_GTKDOC_CHECK -if test -n "$GTKDOC_CHECK"; then - { $as_echo "$as_me:${as_lineno-$LINENO}: result: $GTKDOC_CHECK" >&5 -$as_echo "$GTKDOC_CHECK" >&6; } +GTKDOC_CHECK_PATH=$ac_cv_path_GTKDOC_CHECK_PATH +if test -n "$GTKDOC_CHECK_PATH"; then + { $as_echo "$as_me:${as_lineno-$LINENO}: result: $GTKDOC_CHECK_PATH" >&5 +$as_echo "$GTKDOC_CHECK_PATH" >&6; } else { $as_echo "$as_me:${as_lineno-$LINENO}: result: no" >&5 $as_echo "no" >&6; } @@ -24791,18 +25108,19 @@ else fi - if test x$enable_gtk_doc = xyes; then - if test -n "$PKG_CONFIG" && \ - { { $as_echo "$as_me:${as_lineno-$LINENO}: \$PKG_CONFIG --exists --print-errors \"gtk-doc >= 1.0\""; } >&5 - ($PKG_CONFIG --exists --print-errors "gtk-doc >= 1.0") 2>&5 - ac_status=$? - $as_echo "$as_me:${as_lineno-$LINENO}: \$? = $ac_status" >&5 - test $ac_status = 0; }; then - : -else - as_fn_error $? "You need to have gtk-doc >= 1.0 installed to build $PACKAGE_NAME" "$LINENO" 5 -fi - if test "x$PACKAGE_NAME" != "xglib"; then + { $as_echo "$as_me:${as_lineno-$LINENO}: checking whether to build gtk-doc documentation" >&5 +$as_echo_n "checking whether to build gtk-doc documentation... " >&6; } + { $as_echo "$as_me:${as_lineno-$LINENO}: result: $enable_gtk_doc" >&5 +$as_echo "$enable_gtk_doc" >&6; } + + if test "x$enable_gtk_doc" = "xyes" && test "$have_gtk_doc" = "no"; then + as_fn_error $? " + You must have $gtk_doc_requires installed to build documentation for + $PACKAGE_NAME. Please install gtk-doc or disable building the + documentation by adding '--disable-gtk-doc' to '$0'." "$LINENO" 5 + fi + + if test "x$PACKAGE_NAME" != "xglib"; then pkg_failed=no { $as_echo "$as_me:${as_lineno-$LINENO}: checking for GTKDOC_DEPS" >&5 @@ -24874,14 +25192,8 @@ else $as_echo "yes" >&6; } fi - fi fi - { $as_echo "$as_me:${as_lineno-$LINENO}: checking whether to build gtk-doc documentation" >&5 -$as_echo_n "checking whether to build gtk-doc documentation... " >&6; } - { $as_echo "$as_me:${as_lineno-$LINENO}: result: $enable_gtk_doc" >&5 -$as_echo "$enable_gtk_doc" >&6; } - # Check whether --enable-gtk-doc-html was given. if test "${enable_gtk_doc_html+set}" = set; then : enableval=$enable_gtk_doc_html; @@ -24906,6 +25218,14 @@ fi fi + if test x$have_gtk_doc = xyes; then + HAVE_GTK_DOC_TRUE= + HAVE_GTK_DOC_FALSE='#' +else + HAVE_GTK_DOC_TRUE='#' + HAVE_GTK_DOC_FALSE= +fi + if test x$enable_gtk_doc = xyes; then ENABLE_GTK_DOC_TRUE= ENABLE_GTK_DOC_FALSE='#' @@ -25356,6 +25676,14 @@ if test -z "${REQUIRE_ROOT_TESTS_TRUE}" && test -z "${REQUIRE_ROOT_TESTS_FALSE}" as_fn_error $? "conditional \"REQUIRE_ROOT_TESTS\" was never defined. Usually this means the macro was only invoked conditionally." "$LINENO" 5 fi +if test -z "${WITH_VALGRIND_TRUE}" && test -z "${WITH_VALGRIND_FALSE}"; then + as_fn_error $? "conditional \"WITH_VALGRIND\" was never defined. +Usually this means the macro was only invoked conditionally." "$LINENO" 5 +fi +if test -z "${HAVE_GTK_DOC_TRUE}" && test -z "${HAVE_GTK_DOC_FALSE}"; then + as_fn_error $? "conditional \"HAVE_GTK_DOC\" was never defined. +Usually this means the macro was only invoked conditionally." "$LINENO" 5 +fi if test -z "${ENABLE_GTK_DOC_TRUE}" && test -z "${ENABLE_GTK_DOC_FALSE}"; then as_fn_error $? "conditional \"ENABLE_GTK_DOC\" was never defined. Usually this means the macro was only invoked conditionally." "$LINENO" 5 @@ -25785,7 +26113,7 @@ cat >>$CONFIG_STATUS <<\_ACEOF || ac_write_fail=1 # report actual input values of CONFIG_FILES etc. instead of their # values after options handling. ac_log=" -This file was extended by NetworkManager $as_me 1.0.0, which was +This file was extended by NetworkManager $as_me 1.0.2, which was generated by GNU Autoconf 2.69. Invocation command line was CONFIG_FILES = $CONFIG_FILES @@ -25851,7 +26179,7 @@ _ACEOF cat >>$CONFIG_STATUS <<_ACEOF || ac_write_fail=1 ac_cs_config="`$as_echo "$ac_configure_args" | sed 's/^ //; s/[\\""\`\$]/\\\\&/g'`" ac_cs_version="\\ -NetworkManager config.status 1.0.0 +NetworkManager config.status 1.0.2 configured by $0, generated by GNU Autoconf 2.69, with options \\"\$ac_cs_config\\" diff --git a/configure.ac b/configure.ac index b6bf38e8..68dff7a8 100644 --- a/configure.ac +++ b/configure.ac @@ -3,7 +3,7 @@ AC_PREREQ([2.63]) dnl The NM version number m4_define([nm_major_version], [1]) m4_define([nm_minor_version], [0]) -m4_define([nm_micro_version], [0]) +m4_define([nm_micro_version], [2]) m4_define([nm_version], [nm_major_version.nm_minor_version.nm_micro_version]) m4_define([nm_git_sha], [m4_esyscmd([ ( [ -d ./.git/ ] && [ "$(readlink -f ./.git/)" = "$(readlink -f "$(git rev-parse --git-dir 2>/dev/null)" 2>/dev/null)" ] && git rev-parse --verify -q HEAD 2>/dev/null ) || true ])]) @@ -302,7 +302,7 @@ AM_CONDITIONAL(WITH_QT, test "${enable_qt}" = "yes") AC_ARG_WITH(udev-dir, AS_HELP_STRING([--with-udev-dir=DIR], [Absolute path of the udev base directory. Set to 'no' not to install the udev rules]), [], [with_udev_dir="yes"]) if (test "$with_udev_dir" != 'no'); then - if (test "$with_udev_dir" != 'yes' && echo -n "$with_udev_dir" | grep -v -q '^/'); then + if (test "$with_udev_dir" != 'yes' && printf '%s' "$with_udev_dir" | grep -v -q '^/'); then AC_MSG_ERROR([--with-udev-dir must be an absolute path or 'yes' or 'no'. Instead it is '$with_udev_dir']) fi if (test "$with_udev_dir" = 'yes'); then @@ -685,10 +685,10 @@ fi if test "$with_dhcpcd" = "yes"; then AC_PATH_PROGS(with_dhcpcd, dhcpcd, no, /sbin:/usr/sbin:/usr/local/sbin) if test "$with_dhcpcd" != "no"; then - if ! $with_dhcpcd --version 2>&1 | grep -q "^dhcpcd [[456789]]\."; then + if ! $with_dhcpcd --version 2>&1 | grep -q "^dhcpcd [456789]\."; then AC_MSG_WARN([Cannot use dhcpcd, version 4.x or higher is required]) with_dhcpcd=no - elif $with_dhcpcd --version 2>&1 | grep -q "^dhcpcd [[6789]]\."; then + elif $with_dhcpcd --version 2>&1 | grep -q "^dhcpcd [6789]\."; then AC_DEFINE(DHCPCD_SUPPORTS_IPV6, 1, [Define if dhcpcd supports IPv6 (6.x+)]) fi fi @@ -821,10 +821,11 @@ AM_CONDITIONAL(BUILD_NMTUI, test "$build_nmtui" = yes) NM_COMPILER_WARNINGS -AC_ARG_ENABLE(lto, AS_HELP_STRING([--enable-lto], [Enable Link Time Optimization for smaller size (default: no)]), - [enable_lto=yes], [enable_lto=no]) +AC_ARG_ENABLE(lto, AS_HELP_STRING([--enable-lto], [Enable Link Time Optimization for smaller size (default: no)])) if (test "${enable_lto}" = "yes"); then CFLAGS="-flto $CFLAGS" +else + enable_lto='no' fi @@ -836,13 +837,13 @@ VAPIGEN_CHECK(0.17.1.24) # Tests, utilities and documentation AC_ARG_ENABLE(tests, AS_HELP_STRING([--enable-tests=root|yes|no], [Build NetworkManager tests (default: yes)])) -AC_ARG_WITH(valgrind, AS_HELP_STRING([--with-valgrind=yes|no|path], [Use valgrind to memory-check the tests (default: yes)])) +AC_ARG_WITH(valgrind, AS_HELP_STRING([--with-valgrind=yes|no|path], [Use valgrind to memory-check the tests (default: no)])) # Fallback to --with-tests AC_ARG_WITH(tests, AS_HELP_STRING([--with-tests], [Build NetworkManager tests (deprecated)])) AS_IF([test -n "$with_tests"], enable_tests="$with_tests") -# Default to --enable-tests --with-valgrind +# Default to --enable-tests --with-valgrind=no AS_IF([test -z "$enable_tests"], enable_tests="yes") -AS_IF([test -z "$with_valgrind"], with_valgrind="yes") +AS_IF([test -z "$with_valgrind"], with_valgrind="no") # Normalize values AS_IF([test "$enable_tests" != "yes" -a "$enable_tests" != "root"], enable_tests="no") # Search for tools @@ -854,6 +855,7 @@ AM_CONDITIONAL(REQUIRE_ROOT_TESTS, test "$enable_tests" == "root") AS_IF([test "$with_valgrind" != "no"], AC_SUBST(VALGRIND_RULES, 'TESTS_ENVIRONMENT = "$(top_srcdir)/tools/run-test-valgrind.sh" "$(LIBTOOL)" "$(with_valgrind)" "$(top_srcdir)/valgrind.suppressions"'), AC_SUBST(VALGRIND_RULES, [])) +AM_CONDITIONAL(WITH_VALGRIND, test "${with_valgrind}" != "no") GTK_DOC_CHECK(1.0) diff --git a/data/Makefile.in b/data/Makefile.in index 93df796e..51aaa3a3 100644 --- a/data/Makefile.in +++ b/data/Makefile.in @@ -1,7 +1,7 @@ -# Makefile.in generated by automake 1.13.4 from Makefile.am. +# Makefile.in generated by automake 1.15 from Makefile.am. # @configure_input@ -# Copyright (C) 1994-2013 Free Software Foundation, Inc. +# Copyright (C) 1994-2014 Free Software Foundation, Inc. # This Makefile.in is free software; the Free Software Foundation # gives unlimited permission to copy and/or distribute it, @@ -15,7 +15,17 @@ @SET_MAKE@ VPATH = @srcdir@ -am__is_gnu_make = test -n '$(MAKEFILE_LIST)' && test -n '$(MAKELEVEL)' +am__is_gnu_make = { \ + if test -z '$(MAKELEVEL)'; then \ + false; \ + elif test -n '$(MAKE_HOST)'; then \ + true; \ + elif test -n '$(MAKE_VERSION)' && test -n '$(CURDIR)'; then \ + true; \ + else \ + false; \ + fi; \ +} am__make_running_with_option = \ case $${target_option-} in \ ?) ;; \ @@ -79,7 +89,6 @@ POST_UNINSTALL = : build_triplet = @build@ host_triplet = @host@ subdir = data -DIST_COMMON = $(srcdir)/Makefile.in $(srcdir)/Makefile.am ACLOCAL_M4 = $(top_srcdir)/aclocal.m4 am__aclocal_m4_deps = $(top_srcdir)/m4/ax_lib_readline.m4 \ $(top_srcdir)/m4/compiler_warnings.m4 \ @@ -96,6 +105,7 @@ am__aclocal_m4_deps = $(top_srcdir)/m4/ax_lib_readline.m4 \ $(top_srcdir)/m4/vapigen.m4 $(top_srcdir)/configure.ac am__configure_deps = $(am__aclocal_m4_deps) $(CONFIGURE_DEPENDENCIES) \ $(ACLOCAL_M4) +DIST_COMMON = $(srcdir)/Makefile.am $(am__DIST_COMMON) mkinstalldirs = $(install_sh) -d CONFIG_HEADER = $(top_builddir)/config.h CONFIG_CLEAN_FILES = @@ -150,6 +160,7 @@ am__installdirs = "$(DESTDIR)$(examplesdir)" "$(DESTDIR)$(servicedir)" \ "$(DESTDIR)$(systemdsystemunitdir)" DATA = $(examples_DATA) $(service_DATA) $(systemdsystemunit_DATA) am__tagged_files = $(HEADERS) $(SOURCES) $(TAGS_FILES) $(LISP) +am__DIST_COMMON = $(srcdir)/Makefile.in DISTFILES = $(DIST_COMMON) $(DIST_SOURCES) $(TEXINFOS) $(EXTRA_DIST) ACLOCAL = @ACLOCAL@ ALL_LINGUAS = @ALL_LINGUAS@ @@ -176,7 +187,6 @@ CXXCPP = @CXXCPP@ CXXDEPMODE = @CXXDEPMODE@ CXXFLAGS = @CXXFLAGS@ CYGPATH_W = @CYGPATH_W@ -DATADIRNAME = @DATADIRNAME@ DBUS_CFLAGS = @DBUS_CFLAGS@ DBUS_GLIB_100_CFLAGS = @DBUS_GLIB_100_CFLAGS@ DBUS_GLIB_100_LIBS = @DBUS_GLIB_100_LIBS@ @@ -211,6 +221,7 @@ GNUTLS_CFLAGS = @GNUTLS_CFLAGS@ GNUTLS_LIBS = @GNUTLS_LIBS@ GREP = @GREP@ GTKDOC_CHECK = @GTKDOC_CHECK@ +GTKDOC_CHECK_PATH = @GTKDOC_CHECK_PATH@ GTKDOC_DEPS_CFLAGS = @GTKDOC_DEPS_CFLAGS@ GTKDOC_DEPS_LIBS = @GTKDOC_DEPS_LIBS@ GTKDOC_MKPDF = @GTKDOC_MKPDF@ @@ -459,7 +470,6 @@ $(srcdir)/Makefile.in: @MAINTAINER_MODE_TRUE@ $(srcdir)/Makefile.am $(am__confi echo ' cd $(top_srcdir) && $(AUTOMAKE) --gnu data/Makefile'; \ $(am__cd) $(top_srcdir) && \ $(AUTOMAKE) --gnu data/Makefile -.PRECIOUS: Makefile Makefile: $(srcdir)/Makefile.in $(top_builddir)/config.status @case '$?' in \ *config.status*) \ @@ -707,6 +717,8 @@ uninstall-am: uninstall-examplesDATA uninstall-serviceDATA \ ps ps-am tags-am uninstall uninstall-am uninstall-examplesDATA \ uninstall-serviceDATA uninstall-systemdsystemunitDATA +.PRECIOUS: Makefile + @HAVE_SYSTEMD_TRUE@NetworkManager.service: NetworkManager.service.in @HAVE_SYSTEMD_TRUE@ $(edit) $< >$@ diff --git a/docs/Makefile.in b/docs/Makefile.in index 81c7dc4e..367eedba 100644 --- a/docs/Makefile.in +++ b/docs/Makefile.in @@ -1,7 +1,7 @@ -# Makefile.in generated by automake 1.13.4 from Makefile.am. +# Makefile.in generated by automake 1.15 from Makefile.am. # @configure_input@ -# Copyright (C) 1994-2013 Free Software Foundation, Inc. +# Copyright (C) 1994-2014 Free Software Foundation, Inc. # This Makefile.in is free software; the Free Software Foundation # gives unlimited permission to copy and/or distribute it, @@ -14,7 +14,17 @@ @SET_MAKE@ VPATH = @srcdir@ -am__is_gnu_make = test -n '$(MAKEFILE_LIST)' && test -n '$(MAKELEVEL)' +am__is_gnu_make = { \ + if test -z '$(MAKELEVEL)'; then \ + false; \ + elif test -n '$(MAKE_HOST)'; then \ + true; \ + elif test -n '$(MAKE_VERSION)' && test -n '$(CURDIR)'; then \ + true; \ + else \ + false; \ + fi; \ +} am__make_running_with_option = \ case $${target_option-} in \ ?) ;; \ @@ -78,7 +88,6 @@ POST_UNINSTALL = : build_triplet = @build@ host_triplet = @host@ subdir = docs -DIST_COMMON = $(srcdir)/Makefile.in $(srcdir)/Makefile.am ACLOCAL_M4 = $(top_srcdir)/aclocal.m4 am__aclocal_m4_deps = $(top_srcdir)/m4/ax_lib_readline.m4 \ $(top_srcdir)/m4/compiler_warnings.m4 \ @@ -95,6 +104,7 @@ am__aclocal_m4_deps = $(top_srcdir)/m4/ax_lib_readline.m4 \ $(top_srcdir)/m4/vapigen.m4 $(top_srcdir)/configure.ac am__configure_deps = $(am__aclocal_m4_deps) $(CONFIGURE_DEPENDENCIES) \ $(ACLOCAL_M4) +DIST_COMMON = $(srcdir)/Makefile.am $(am__DIST_COMMON) mkinstalldirs = $(install_sh) -d CONFIG_HEADER = $(top_builddir)/config.h CONFIG_CLEAN_FILES = @@ -154,6 +164,7 @@ am__define_uniq_tagged_files = \ ETAGS = etags CTAGS = ctags DIST_SUBDIRS = $(SUBDIRS) +am__DIST_COMMON = $(srcdir)/Makefile.in DISTFILES = $(DIST_COMMON) $(DIST_SOURCES) $(TEXINFOS) $(EXTRA_DIST) am__relativize = \ dir0=`pwd`; \ @@ -205,7 +216,6 @@ CXXCPP = @CXXCPP@ CXXDEPMODE = @CXXDEPMODE@ CXXFLAGS = @CXXFLAGS@ CYGPATH_W = @CYGPATH_W@ -DATADIRNAME = @DATADIRNAME@ DBUS_CFLAGS = @DBUS_CFLAGS@ DBUS_GLIB_100_CFLAGS = @DBUS_GLIB_100_CFLAGS@ DBUS_GLIB_100_LIBS = @DBUS_GLIB_100_LIBS@ @@ -240,6 +250,7 @@ GNUTLS_CFLAGS = @GNUTLS_CFLAGS@ GNUTLS_LIBS = @GNUTLS_LIBS@ GREP = @GREP@ GTKDOC_CHECK = @GTKDOC_CHECK@ +GTKDOC_CHECK_PATH = @GTKDOC_CHECK_PATH@ GTKDOC_DEPS_CFLAGS = @GTKDOC_DEPS_CFLAGS@ GTKDOC_DEPS_LIBS = @GTKDOC_DEPS_LIBS@ GTKDOC_MKPDF = @GTKDOC_MKPDF@ @@ -456,7 +467,6 @@ $(srcdir)/Makefile.in: @MAINTAINER_MODE_TRUE@ $(srcdir)/Makefile.am $(am__confi echo ' cd $(top_srcdir) && $(AUTOMAKE) --gnu docs/Makefile'; \ $(am__cd) $(top_srcdir) && \ $(AUTOMAKE) --gnu docs/Makefile -.PRECIOUS: Makefile Makefile: $(srcdir)/Makefile.in $(top_builddir)/config.status @case '$?' in \ *config.status*) \ @@ -751,6 +761,8 @@ uninstall-am: mostlyclean mostlyclean-generic mostlyclean-libtool pdf pdf-am \ ps ps-am tags tags-am uninstall uninstall-am +.PRECIOUS: Makefile + # Tell versions [3.59,3.63) of GNU make to not export all variables. # Otherwise a system limit (for SysV at least) may be exceeded. diff --git a/docs/api/Makefile.am b/docs/api/Makefile.am index 5283f73f..1b50d02b 100644 --- a/docs/api/Makefile.am +++ b/docs/api/Makefile.am @@ -59,6 +59,7 @@ MKHTML_OPTIONS=--path="$(abs_srcdir)" content_files = \ version.xml \ migrating-to-09.xml \ + ../../COPYING \ $(NULL) include $(top_srcdir)/gtk-doc.make diff --git a/docs/api/Makefile.in b/docs/api/Makefile.in index fb97c833..162643b5 100644 --- a/docs/api/Makefile.in +++ b/docs/api/Makefile.in @@ -1,7 +1,7 @@ -# Makefile.in generated by automake 1.13.4 from Makefile.am. +# Makefile.in generated by automake 1.15 from Makefile.am. # @configure_input@ -# Copyright (C) 1994-2013 Free Software Foundation, Inc. +# Copyright (C) 1994-2014 Free Software Foundation, Inc. # This Makefile.in is free software; the Free Software Foundation # gives unlimited permission to copy and/or distribute it, @@ -20,7 +20,17 @@ # Everything below here is generic # #################################### VPATH = @srcdir@ -am__is_gnu_make = test -n '$(MAKEFILE_LIST)' && test -n '$(MAKELEVEL)' +am__is_gnu_make = { \ + if test -z '$(MAKELEVEL)'; then \ + false; \ + elif test -n '$(MAKE_HOST)'; then \ + true; \ + elif test -n '$(MAKE_VERSION)' && test -n '$(CURDIR)'; then \ + true; \ + else \ + false; \ + fi; \ +} am__make_running_with_option = \ case $${target_option-} in \ ?) ;; \ @@ -84,8 +94,6 @@ POST_UNINSTALL = : build_triplet = @build@ host_triplet = @host@ @SETTING_DOCS_AVAILABLE_TRUE@am__append_1 = settings-spec.xml -DIST_COMMON = $(top_srcdir)/gtk-doc.make $(srcdir)/Makefile.in \ - $(srcdir)/Makefile.am $(srcdir)/version.xml.in @BUILD_SETTING_DOCS_TRUE@am__append_2 = settings-spec.xml @ENABLE_GTK_DOC_TRUE@am__append_3 = spec.html subdir = docs/api @@ -105,6 +113,7 @@ am__aclocal_m4_deps = $(top_srcdir)/m4/ax_lib_readline.m4 \ $(top_srcdir)/m4/vapigen.m4 $(top_srcdir)/configure.ac am__configure_deps = $(am__aclocal_m4_deps) $(CONFIGURE_DEPENDENCIES) \ $(ACLOCAL_M4) +DIST_COMMON = $(srcdir)/Makefile.am $(am__DIST_COMMON) mkinstalldirs = $(install_sh) -d CONFIG_HEADER = $(top_builddir)/config.h CONFIG_CLEAN_FILES = version.xml @@ -129,6 +138,8 @@ am__can_run_installinfo = \ *) (install-info --version) >/dev/null 2>&1;; \ esac am__tagged_files = $(HEADERS) $(SOURCES) $(TAGS_FILES) $(LISP) +am__DIST_COMMON = $(srcdir)/Makefile.in $(srcdir)/version.xml.in \ + $(top_srcdir)/gtk-doc.make DISTFILES = $(DIST_COMMON) $(DIST_SOURCES) $(TEXINFOS) $(EXTRA_DIST) ACLOCAL = @ACLOCAL@ ALL_LINGUAS = @ALL_LINGUAS@ @@ -155,7 +166,6 @@ CXXCPP = @CXXCPP@ CXXDEPMODE = @CXXDEPMODE@ CXXFLAGS = @CXXFLAGS@ CYGPATH_W = @CYGPATH_W@ -DATADIRNAME = @DATADIRNAME@ DBUS_CFLAGS = @DBUS_CFLAGS@ DBUS_GLIB_100_CFLAGS = @DBUS_GLIB_100_CFLAGS@ DBUS_GLIB_100_LIBS = @DBUS_GLIB_100_LIBS@ @@ -190,6 +200,7 @@ GNUTLS_CFLAGS = @GNUTLS_CFLAGS@ GNUTLS_LIBS = @GNUTLS_LIBS@ GREP = @GREP@ GTKDOC_CHECK = @GTKDOC_CHECK@ +GTKDOC_CHECK_PATH = @GTKDOC_CHECK_PATH@ GTKDOC_DEPS_CFLAGS = @GTKDOC_DEPS_CFLAGS@ GTKDOC_DEPS_LIBS = @GTKDOC_DEPS_LIBS@ GTKDOC_MKPDF = @GTKDOC_MKPDF@ @@ -425,6 +436,7 @@ MKHTML_OPTIONS = --path="$(abs_srcdir)" content_files = \ version.xml \ migrating-to-09.xml \ + ../../COPYING \ $(NULL) @GTK_DOC_USE_LIBTOOL_FALSE@GTKDOC_CC = $(CC) $(INCLUDES) $(GTKDOC_DEPS_CFLAGS) $(AM_CPPFLAGS) $(CPPFLAGS) $(AM_CFLAGS) $(CFLAGS) @@ -467,13 +479,14 @@ REPORT_FILES = \ $(DOC_MODULE)-undeclared.txt \ $(DOC_MODULE)-unused.txt -CLEANFILES = $(SCANOBJ_FILES) $(REPORT_FILES) $(DOC_STAMPS) html/* \ - tmpl/* xml/* NetworkManager-sections.txt \ - NetworkManager-overrides.txt $(am__append_2) $(am__append_3) -@ENABLE_GTK_DOC_TRUE@@GTK_DOC_BUILD_HTML_FALSE@HTML_BUILD_STAMP = -@ENABLE_GTK_DOC_TRUE@@GTK_DOC_BUILD_HTML_TRUE@HTML_BUILD_STAMP = html-build.stamp -@ENABLE_GTK_DOC_TRUE@@GTK_DOC_BUILD_PDF_FALSE@PDF_BUILD_STAMP = -@ENABLE_GTK_DOC_TRUE@@GTK_DOC_BUILD_PDF_TRUE@PDF_BUILD_STAMP = pdf-build.stamp +CLEANFILES = $(SCANOBJ_FILES) $(REPORT_FILES) $(DOC_STAMPS) \ + gtkdoc-check.test html/* tmpl/* xml/* \ + NetworkManager-sections.txt NetworkManager-overrides.txt \ + $(am__append_2) $(am__append_3) +@GTK_DOC_BUILD_HTML_FALSE@HTML_BUILD_STAMP = +@GTK_DOC_BUILD_HTML_TRUE@HTML_BUILD_STAMP = html-build.stamp +@GTK_DOC_BUILD_PDF_FALSE@PDF_BUILD_STAMP = +@GTK_DOC_BUILD_PDF_TRUE@PDF_BUILD_STAMP = pdf-build.stamp #### setup #### GTK_DOC_V_SETUP = $(GTK_DOC_V_SETUP_$(V)) @@ -525,7 +538,6 @@ $(srcdir)/Makefile.in: @MAINTAINER_MODE_TRUE@ $(srcdir)/Makefile.am $(top_srcdir echo ' cd $(top_srcdir) && $(AUTOMAKE) --gnu docs/api/Makefile'; \ $(am__cd) $(top_srcdir) && \ $(AUTOMAKE) --gnu docs/api/Makefile -.PRECIOUS: Makefile Makefile: $(srcdir)/Makefile.in $(top_builddir)/config.status @case '$?' in \ *config.status*) \ @@ -534,7 +546,7 @@ Makefile: $(srcdir)/Makefile.in $(top_builddir)/config.status echo ' cd $(top_builddir) && $(SHELL) ./config.status $(subdir)/$@ $(am__depfiles_maybe)'; \ cd $(top_builddir) && $(SHELL) ./config.status $(subdir)/$@ $(am__depfiles_maybe);; \ esac; -$(top_srcdir)/gtk-doc.make: +$(top_srcdir)/gtk-doc.make $(am__empty): $(top_builddir)/config.status: $(top_srcdir)/configure $(CONFIG_STATUS_DEPENDENCIES) cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh @@ -594,6 +606,7 @@ distdir: $(DISTFILES) dist-hook check-am: all-am check: check-am +@ENABLE_GTK_DOC_FALSE@all-local: all-am: Makefile all-local installdirs: install: install-am @@ -710,6 +723,8 @@ uninstall-am: uninstall-local mostlyclean-libtool pdf pdf-am ps ps-am tags-am uninstall \ uninstall-am uninstall-local +.PRECIOUS: Makefile + @SETTING_DOCS_AVAILABLE_TRUE@settings-spec.xml: settings-spec.xsl $(top_builddir)/libnm/nm-setting-docs.xml @SETTING_DOCS_AVAILABLE_TRUE@ $(AM_V_GEN) xsltproc --output $@ $^ @@ -724,8 +739,15 @@ uninstall-am: uninstall-local @ENABLE_GTK_DOC_TRUE@all: $(GENERATED_FILES) -@ENABLE_GTK_DOC_TRUE@all-local: $(HTML_BUILD_STAMP) $(PDF_BUILD_STAMP) -@ENABLE_GTK_DOC_FALSE@all-local: +gtkdoc-check.test: Makefile + $(AM_V_GEN)echo "#!/bin/sh -e" > $@; \ + echo "$(GTKDOC_CHECK_PATH) || exit 1" >> $@; \ + chmod +x $@ + +all-gtk-doc: $(HTML_BUILD_STAMP) $(PDF_BUILD_STAMP) +.PHONY: all-gtk-doc + +@ENABLE_GTK_DOC_TRUE@all-local: all-gtk-doc docs: $(HTML_BUILD_STAMP) $(PDF_BUILD_STAMP) @@ -736,17 +758,19 @@ setup-build.stamp: files=`echo $(SETUP_FILES) $(expand_content_files) $(DOC_MODULE).types`; \ if test "x$$files" != "x" ; then \ for file in $$files ; do \ + destdir=`dirname $(abs_builddir)/$$file` ;\ + test -d "$$destdir" || mkdir -p "$$destdir"; \ test -f $(abs_srcdir)/$$file && \ - cp -pu $(abs_srcdir)/$$file $(abs_builddir)/$$file || true; \ + cp -pf $(abs_srcdir)/$$file $(abs_builddir)/$$file || true; \ done; \ fi; \ test -d $(abs_srcdir)/tmpl && \ - { cp -rp $(abs_srcdir)/tmpl $(abs_builddir)/; \ + { cp -pR $(abs_srcdir)/tmpl $(abs_builddir)/; \ chmod -R u+w $(abs_builddir)/tmpl; } \ fi $(AM_V_at)touch setup-build.stamp -scan-build.stamp: $(HFILE_GLOB) $(CFILE_GLOB) +scan-build.stamp: setup-build.stamp $(HFILE_GLOB) $(CFILE_GLOB) $(GTK_DOC_V_SCAN)_source_dir='' ; \ for i in $(DOC_SOURCE_DIR) ; do \ _source_dir="$${_source_dir} --source-dir=$$i" ; \ @@ -776,7 +800,7 @@ tmpl-build.stamp: setup-build.stamp $(DOC_MODULE)-decl.txt $(SCANOBJ_FILES) $(DO $(GTK_DOC_V_TMPL)gtkdoc-mktmpl --module=$(DOC_MODULE) $(MKTMPL_OPTIONS) $(AM_V_at)if test "$(abs_srcdir)" != "$(abs_builddir)" ; then \ if test -w $(abs_srcdir) ; then \ - cp -rp $(abs_builddir)/tmpl $(abs_srcdir)/; \ + cp -pR $(abs_builddir)/tmpl $(abs_srcdir)/; \ fi \ fi $(AM_V_at)touch tmpl-build.stamp @@ -788,7 +812,7 @@ $(srcdir)/tmpl/*.sgml: @true sgml-build.stamp: tmpl.stamp $(DOC_MODULE)-sections.txt $(srcdir)/tmpl/*.sgml $(expand_content_files) - $(GTK_DOC_V_XML)-chmod -R u+w $(srcdir) && _source_dir='' ; \ + -$(GTK_DOC_V_XML)chmod -R u+w $(srcdir) && _source_dir='' ; \ for i in $(DOC_SOURCE_DIR) ; do \ _source_dir="$${_source_dir} --source-dir=$$i" ; \ done ; \ @@ -850,6 +874,9 @@ pdf-build.stamp: sgml.stamp $(DOC_MAIN_SGML_FILE) $(content_files) clean-local: @rm -f *~ *.bak @rm -rf .libs + @if echo $(SCAN_OPTIONS) | grep -q "\-\-rebuild-types" ; then \ + rm -f $(DOC_MODULE).types; \ + fi distclean-local: @rm -rf xml html $(REPORT_FILES) $(DOC_MODULE).pdf \ @@ -895,12 +922,14 @@ uninstall-local: # # Require gtk-doc when making dist # -@ENABLE_GTK_DOC_TRUE@dist-check-gtkdoc: docs -@ENABLE_GTK_DOC_FALSE@dist-check-gtkdoc: -@ENABLE_GTK_DOC_FALSE@ @echo "*** gtk-doc must be installed and enabled in order to make dist" -@ENABLE_GTK_DOC_FALSE@ @false - -dist-hook: dist-check-gtkdoc dist-hook-local +@HAVE_GTK_DOC_TRUE@dist-check-gtkdoc: docs +@HAVE_GTK_DOC_FALSE@dist-check-gtkdoc: +@HAVE_GTK_DOC_FALSE@ @echo "*** gtk-doc is needed to run 'make dist'. ***" +@HAVE_GTK_DOC_FALSE@ @echo "*** gtk-doc was not found when 'configure' ran. ***" +@HAVE_GTK_DOC_FALSE@ @echo "*** please install gtk-doc and rerun 'configure'. ***" +@HAVE_GTK_DOC_FALSE@ @false + +dist-hook: dist-check-gtkdoc all-gtk-doc dist-hook-local @mkdir $(distdir)/tmpl @mkdir $(distdir)/html @-cp ./tmpl/*.sgml $(distdir)/tmpl diff --git a/docs/api/html/home.png b/docs/api/html/home.png index 17003611..9346b336 100644 Binary files a/docs/api/html/home.png and b/docs/api/html/home.png differ diff --git a/docs/api/html/index.html b/docs/api/html/index.html index be7c56f5..b227e2ee 100644 --- a/docs/api/html/index.html +++ b/docs/api/html/index.html @@ -2,11 +2,11 @@ -NetworkManager D-Bus Reference Manual +NetworkManager D-Bus Reference Manual: NetworkManager D-Bus Reference Manual - + @@ -14,7 +14,7 @@
-

Version 1.0.0 +

Version 1.0.2

@@ -73,6 +73,6 @@
+ Generated by GTK-Doc V1.21
\ No newline at end of file diff --git a/docs/api/html/ix01.html b/docs/api/html/ix01.html index ae39f850..d2c5a387 100644 --- a/docs/api/html/ix01.html +++ b/docs/api/html/ix01.html @@ -2,22 +2,22 @@ -Index +NetworkManager D-Bus Reference Manual: Index - + - - - - - - + + + + + +

@@ -26,6 +26,6 @@

+ Generated by GTK-Doc V1.21
\ No newline at end of file diff --git a/docs/api/html/left-insensitive.png b/docs/api/html/left-insensitive.png new file mode 100644 index 00000000..3269393a Binary files /dev/null and b/docs/api/html/left-insensitive.png differ diff --git a/docs/api/html/left.png b/docs/api/html/left.png index 2d05b3d5..2abde032 100644 Binary files a/docs/api/html/left.png and b/docs/api/html/left.png differ diff --git a/docs/api/html/license.html b/docs/api/html/license.html index 6cd55c46..bd063781 100644 --- a/docs/api/html/license.html +++ b/docs/api/html/license.html @@ -2,21 +2,21 @@ -Appendix A. License +NetworkManager D-Bus Reference Manual: Appendix A. License - + - - - - - - + + + + + +

@@ -380,6 +380,6 @@ Public License instead of this License.

+ Generated by GTK-Doc V1.21
\ No newline at end of file diff --git a/docs/api/html/ref-dbus.html b/docs/api/html/ref-dbus.html index 353bfa5b..8bc3817f 100644 --- a/docs/api/html/ref-dbus.html +++ b/docs/api/html/ref-dbus.html @@ -2,22 +2,22 @@ -D-Bus API Reference +NetworkManager D-Bus Reference Manual: D-Bus API Reference - + - - - - - - + + + + + +

@@ -30,6 +30,6 @@

+ Generated by GTK-Doc V1.21
\ No newline at end of file diff --git a/docs/api/html/ref-migrating.html b/docs/api/html/ref-migrating.html index e5730a67..02fcb588 100644 --- a/docs/api/html/ref-migrating.html +++ b/docs/api/html/ref-migrating.html @@ -2,22 +2,22 @@ -Migrating from NetworkManager 0.8 to NetworkManager 0.9 +NetworkManager D-Bus Reference Manual: Migrating from NetworkManager 0.8 to NetworkManager 0.9 - + - - - - - - + + + + + +

@@ -536,6 +536,6 @@

+ Generated by GTK-Doc V1.21
\ No newline at end of file diff --git a/docs/api/html/ref-settings.html b/docs/api/html/ref-settings.html index d8fa0906..6fca6945 100644 --- a/docs/api/html/ref-settings.html +++ b/docs/api/html/ref-settings.html @@ -2,22 +2,22 @@ -Network Configuration Setting Specification +NetworkManager D-Bus Reference Manual: Network Configuration Setting Specification - + - - - - - - + + + + + +

@@ -391,7 +391,7 @@
options
dict of string to string
-

+
{'mode': 'balance-rr'}
Dictionary of key/value pairs of bonding options. Both keys and values must be strings. Option names must contain only alphanumeric characters (ie, [a-zA-Z0-9]). @@ -743,13 +743,13 @@
priority-bandwidth
array of uint32
-

+
[0, 0, 0, 0, 0, 0, 0, 0]
An array of 8 uint values, where the array index corresponds to the User Priority (0 - 7) and the value indicates the percentage of bandwidth of the priority's assigned group that the priority may use. The sum of all percentages for priorities which belong to the same group must total 100 percent.
priority-flow-control
array of uint32
-

+
[0, 0, 0, 0, 0, 0, 0, 0]
An array of 8 boolean values, where the array index corresponds to the User Priority (0 - 7) and the value indicates whether or not the corresponding priority should transmit priority pause. @@ -761,7 +761,7 @@
priority-group-bandwidth
array of uint32
-

+
[0, 0, 0, 0, 0, 0, 0, 0]
An array of 8 uint values, where the array index corresponds to the Priority Group ID (0 - 7) and the value indicates the percentage of link bandwidth allocated to that group. Allowed values are 0 - 100, and the sum of all values must total 100 percent. @@ -773,19 +773,19 @@
priority-group-id
array of uint32
-

+
[0, 0, 0, 0, 0, 0, 0, 0]
An array of 8 uint values, where the array index corresponds to the User Priority (0 - 7) and the value indicates the Priority Group ID. Allowed Priority Group ID values are 0 - 7 or 15 for the unrestricted group.
priority-strict-bandwidth
array of uint32
-

+
[0, 0, 0, 0, 0, 0, 0, 0]
An array of 8 boolean values, where the array index corresponds to the User Priority (0 - 7) and the value indicates whether or not the priority may use all of the bandwidth allocated to its assigned group.
priority-traffic-class
array of uint32
-

+
[0, 0, 0, 0, 0, 0, 0, 0]
An array of 8 uint values, where the array index corresponds to the User Priority (0 - 7) and the value indicates the traffic class (0 - 7) to which the priority is mapped. @@ -977,7 +977,7 @@
addresses
array of array of uint32
-

+
[]
Deprecated in favor of the 'address-data' and 'gateway' properties, but this can be used for backward-compatibility with older daemons. Note that if you send this property the daemon will ignore 'address-data' and 'gateway'. Array of IPv4 address structures. Each IPv4 address structure is composed of 3 32-bit values; the first being the IPv4 address (network byte order), the second the prefix (1 - 32), and last the IPv4 gateway (network byte order). The gateway may be left as 0 if no gateway exists for that subnet. @@ -1067,7 +1067,7 @@
routes
array of array of uint32
-

+
[]
Deprecated in favor of the 'route-data' property, but this can be used for backward-compatibility with older daemons. Note that if you send this property the daemon will ignore 'route-data'. Array of IPv4 route structures. Each IPv4 route structure is composed of 4 32-bit values; the first being the destination IPv4 network or address (network byte order), the second the destination network or address prefix (1 - 32), the third being the next-hop (network byte order) if any, and the fourth being the route metric. If the metric is 0, NM will choose an appropriate default metric for the device. (There is no way to explicitly specify an actual metric of 0 with this property.) @@ -1099,7 +1099,7 @@
addresses
array of legacy IPv6 address struct (a(ayuay))
-

+
[]
Deprecated in favor of the 'address-data' and 'gateway' properties, but this can be used for backward-compatibility with older daemons. Note that if you send this property the daemon will ignore 'address-data' and 'gateway'. Array of IPv6 address structures. Each IPv6 address structure is composed of an IPv6 address, a prefix length (1 - 128), and an IPv6 gateway address. The gateway may be zeroed out if no gateway exists for that subnet. @@ -1189,7 +1189,7 @@
routes
array of legacy IPv6 route struct (a(ayuayu))
-

+
[]
Deprecated in favor of the 'route-data' property, but this can be used for backward-compatibility with older daemons. Note that if you send this property the daemon will ignore 'route-data'. Array of IPv6 route structures. Each IPv6 route structure is composed of an IPv6 address, a prefix length (1 - 128), an IPv6 next hop address (which may be zeroed out if there is no next hop), and a metric. If the metric is 0, NM will choose an appropriate default metric for the device. @@ -1631,7 +1631,7 @@
data
dict of string to string
-

+
{}
Dictionary of key/value pairs of VPN plugin specific data. Both keys and values must be strings. @@ -1649,7 +1649,7 @@
secrets
dict of string to string
-

+
{}
Dictionary of key/value pairs of VPN plugin specific secrets like passwords or private keys. Both keys and values must be strings. @@ -1779,7 +1779,7 @@
s390-options
dict of string to string
-

+
{}
Dictionary of key/value pairs of s390-specific device options. Both keys and values must be strings. Allowed keys include "portno", "layer2", "portname", "protocol", among others. Key names must contain only alphanumeric characters (ie, [a-zA-Z0-9]). @@ -2040,6 +2040,6 @@

+ Generated by GTK-Doc V1.21
\ No newline at end of file diff --git a/docs/api/html/right-insensitive.png b/docs/api/html/right-insensitive.png new file mode 100644 index 00000000..4c95785b Binary files /dev/null and b/docs/api/html/right-insensitive.png differ diff --git a/docs/api/html/right.png b/docs/api/html/right.png index 92832e3a..76260ec8 100644 Binary files a/docs/api/html/right.png and b/docs/api/html/right.png differ diff --git a/docs/api/html/secrets-flags.html b/docs/api/html/secrets-flags.html index 4948a0a4..2b27c7f8 100644 --- a/docs/api/html/secrets-flags.html +++ b/docs/api/html/secrets-flags.html @@ -2,22 +2,22 @@ -Secret flag types +NetworkManager D-Bus Reference Manual: Secret flag types - + - - - - - - + + + + + +

@@ -59,6 +59,6 @@

+ Generated by GTK-Doc V1.21
\ No newline at end of file diff --git a/docs/api/html/spec.html b/docs/api/html/spec.html index cf717b59..f7992202 100644 --- a/docs/api/html/spec.html +++ b/docs/api/html/spec.html @@ -1,4 +1,4 @@ -NetworkManager D-Bus Interface Specification version 1.0.0

NetworkManager D-Bus Interface Specification

Version 1.0.0

Copyright (C) 2008 - 2011 Red Hat, Inc.
Copyright (C) 2008 - 2009 Novell, Inc.
+

NetworkManager D-Bus Interface Specification

Version 1.0.2

Copyright (C) 2008 - 2011 Red Hat, Inc.
Copyright (C) 2008 - 2009 Novell, Inc.

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or @@ -879,7 +879,7 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.

Parameters

options - a{sv}
- Options of scan + Options of scan (currently unused argument).

Signals:

PropertiesChanged ( a{sv}: properties )

@@ -937,7 +937,15 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.

Sets of flags:

NM_802_11_DEVICE_CAP

Flags describing the capabilities of a wireless device. -
NM_802_11_DEVICE_CAP_NONE = 0x0
Null capability - syntactic sugar for no capabilities supported. Do not AND this with other capabilities!
NM_802_11_DEVICE_CAP_CIPHER_WEP40 = 0x1
The device supports the 40-bit WEP cipher.
NM_802_11_DEVICE_CAP_CIPHER_WEP104 = 0x2
The device supports the 104-bit WEP cipher.
NM_802_11_DEVICE_CAP_CIPHER_TKIP = 0x4
The device supports the TKIP cipher.
NM_802_11_DEVICE_CAP_CIPHER_CCMP = 0x8
The device supports the CCMP cipher.
NM_802_11_DEVICE_CAP_WPA = 0x10
The device supports the WPA encryption/authentication protocol.
NM_802_11_DEVICE_CAP_RSN = 0x20
The device supports the RSN encryption/authentication protocol.
NM_802_11_DEVICE_CAP_AP = 0x40
The device supports Access Point mode.
NM_802_11_DEVICE_CAP_ADHOC = 0x80
The device supports Ad-Hoc mode.
+
NM_802_11_DEVICE_CAP_NONE = 0x0
Null capability - syntactic sugar for no capabilities supported. Do not AND this with other capabilities!
NM_802_11_DEVICE_CAP_CIPHER_WEP40 = 0x1
The device supports the 40-bit WEP cipher.
NM_802_11_DEVICE_CAP_CIPHER_WEP104 = 0x2
The device supports the 104-bit WEP cipher.
NM_802_11_DEVICE_CAP_CIPHER_TKIP = 0x4
The device supports the TKIP cipher.
NM_802_11_DEVICE_CAP_CIPHER_CCMP = 0x8
The device supports the CCMP cipher.
NM_802_11_DEVICE_CAP_WPA = 0x10
The device supports the WPA encryption/authentication protocol.
NM_802_11_DEVICE_CAP_RSN = 0x20
The device supports the RSN encryption/authentication protocol.
NM_802_11_DEVICE_CAP_AP = 0x40
The device supports Access Point mode.
NM_802_11_DEVICE_CAP_ADHOC = 0x80
The device supports Ad-Hoc mode.
NM_802_11_DEVICE_CAP_FREQ_VALID = 0x100
+ The device properly reports information about supported + frequencies and thus both NM_802_11_DEVICE_CAP_FREQ_2GHZ and + NM_802_11_DEVICE_CAP_FREQ_5GHZ are valid. +
NM_802_11_DEVICE_CAP_FREQ_2GHZ = 0x200
+ The device supports 2.4GHz frequencies. +
NM_802_11_DEVICE_CAP_FREQ_5GHZ = 0x400
+ The device supports 5GHz frequencies. +

org.freedesktop.NetworkManager.Device.Modem

Interface has no methods.

Signals:

PropertiesChanged ( a{sv}: properties diff --git a/docs/api/html/style.css b/docs/api/html/style.css index d6f6c26e..c141ddd2 100644 --- a/docs/api/html/style.css +++ b/docs/api/html/style.css @@ -1,15 +1,23 @@ +body +{ + font-family: cantarell, sans-serif; +} .synopsis, .classsynopsis { /* tango:aluminium 1/2 */ background: #eeeeec; - border: solid 1px #d3d7cf; + background: rgba(238, 238, 236, 0.5); + border: solid 1px rgb(238, 238, 236); padding: 0.5em; } .programlisting { /* tango:sky blue 0/1 */ + /* fallback for no rgba support */ background: #e6f3ff; border: solid 1px #729fcf; + background: rgba(114, 159, 207, 0.1); + border: solid 1px rgba(114, 159, 207, 0.2); padding: 0.5em; } .variablelist @@ -22,89 +30,6 @@ vertical-align: top; } -@media screen { - sup a.footnote - { - position: relative; - top: 0em ! important; - - } - /* this is needed so that the local anchors are displayed below the naviagtion */ - div.footnote a[name], div.refnamediv a[name], div.refsect1 a[name], div.refsect2 a[name], div.index a[name], div.glossary a[name], div.sect1 a[name] - { - display: inline-block; - position: relative; - top:-5em; - } - /* this seems to be a bug in the xsl style sheets when generating indexes */ - div.index div.index - { - top: 0em; - } - /* make space for the fixed navigation bar and add space at the bottom so that - * link targets appear somewhat close to top - */ - body - { - padding-top: 3.2em; - padding-bottom: 20em; - } - /* style and size the navigation bar */ - table.navigation#top - { - position: fixed; - /* tango:scarlet red 0/1 */ - background: #ffe6e6; - border: solid 1px #ef2929; - margin-top: 0; - margin-bottom: 0; - top: 0; - left: 0; - height: 3em; - z-index: 10; - } - .navigation a, .navigation a:visited - { - /* tango:scarlet red 3 */ - color: #a40000; - } - .navigation a:hover - { - /* tango:scarlet red 1 */ - color: #ef2929; - } - td.shortcuts - { - /* tango:scarlet red 1 */ - color: #ef2929; - font-size: 80%; - white-space: nowrap; - } -} -@media print { - table.navigation { - visibility: collapse; - display: none; - } - div.titlepage table.navigation { - visibility: visible; - display: table; - /* tango:scarlet red 0/1 */ - background: #ffe6e6; - border: solid 1px #ef2929; - margin-top: 0; - margin-bottom: 0; - top: 0; - left: 0; - height: 3em; - } -} - -.navigation .title -{ - font-size: 200%; -} - div.gallery-float { float: left; @@ -132,6 +57,72 @@ a:hover color: #729fcf; } +div.informaltable table +{ + border-collapse: separate; + border-spacing: 1em 0.5em; + border: none; +} + +div.informaltable table td, div.informaltable table th +{ + vertical-align: top; +} + +.function_type, +.variable_type, +.property_type, +.signal_type, +.parameter_name, +.struct_member_name, +.union_member_name, +.define_keyword, +.datatype_keyword, +.typedef_keyword +{ + text-align: right; +} + +/* dim non-primary columns */ +.c_punctuation, +.function_type, +.variable_type, +.property_type, +.signal_type, +.define_keyword, +.datatype_keyword, +.typedef_keyword, +.property_flags, +.signal_flags, +.parameter_annotations, +.enum_member_annotations, +.struct_member_annotations, +.union_member_annotations +{ + color: #888a85; +} + +.function_type a, +.function_type a:visited, +.function_type a:hover, +.property_type a, +.property_type a:visited, +.property_type a:hover, +.signal_type a, +.signal_type a:visited, +.signal_type a:hover, +.signal_flags a, +.signal_flags a:visited, +.signal_flags a:hover +{ + color: #729fcf; +} + +td p +{ + margin: 0.25em; +} + div.table table { border-collapse: collapse; @@ -154,14 +145,43 @@ div.table table th background-color: #d3d7cf; } +h4 +{ + color: #555753; +} + hr { - /* tango:aluminium 3 */ - color: #babdb6; - background: #babdb6; + /* tango:aluminium 1 */ + color: #d3d7cf; + background: #d3d7cf; border: none 0px; height: 1px; clear: both; + margin: 2.0em 0em 2.0em 0em; +} + +dl.toc dt +{ + padding-bottom: 0.25em; +} + +dl.toc > dd > dl > dt +{ + padding-top: 0.25em; + padding-bottom: 0.25em; +} + +dl.toc > dt +{ + padding-top: 1em; + padding-bottom: 0.5em; + font-weight: bold; +} + +.parameter +{ + font-style: normal; } .footer @@ -173,31 +193,70 @@ hr font-size: 80%; } +.informalfigure, +.figure +{ + margin: 1em; +} + +.informalexample, +.example +{ + margin-top: 1em; + margin-bottom: 1em; +} + .warning { /* tango:orange 0/1 */ background: #ffeed9; + background: rgba(252, 175, 62, 0.1); border-color: #ffb04f; + border-color: rgba(252, 175, 62, 0.2); } .note { /* tango:chameleon 0/0.5 */ background: #d8ffb2; + background: rgba(138, 226, 52, 0.1); border-color: #abf562; + border-color: rgba(138, 226, 52, 0.2); } -.note, .warning +div.blockquote +{ + border-color: #eeeeec; +} +.note, .warning, div.blockquote { padding: 0.5em; border-width: 1px; border-style: solid; + margin: 2em; } -.note h3, .warning h3 +.note p, .warning p { - margin-top: 0.0em + margin: 0; } -.note p, .warning p + +div.warning h3.title, +div.note h3.title +{ + display: none; +} + +p + div.section { - margin-bottom: 0.0em + margin-top: 1em; +} + +div.refnamediv, +div.refsynopsisdiv, +div.refsect1, +div.refsect2, +div.toc, +div.section +{ + margin-bottom: 1em; } /* blob links */ @@ -210,33 +269,52 @@ h2 .extralinks, h3 .extralinks font-weight: normal; } +.lineart +{ + color: #d3d7cf; + font-weight: normal; +} + .annotation { /* tango:aluminium 5 */ color: #555753; - font-size: 80%; font-weight: normal; } +.structfield +{ + font-style: normal; + font-weight: normal; +} + +acronym,abbr +{ + border-bottom: 1px dotted gray; +} + /* code listings */ -.listing_code .programlisting .cbracket { color: #a40000; } /* tango: scarlet red 3 */ -.listing_code .programlisting .comment { color: #a1a39d; } /* tango: aluminium 4 */ -.listing_code .programlisting .function { color: #000000; font-weight: bold; } -.listing_code .programlisting .function a { color: #11326b; font-weight: bold; } /* tango: sky blue 4 */ -.listing_code .programlisting .keyword { color: #4e9a06; } /* tango: chameleon 3 */ +.listing_code .programlisting .normal, +.listing_code .programlisting .normal a, +.listing_code .programlisting .number, +.listing_code .programlisting .cbracket, +.listing_code .programlisting .symbol { color: #555753; } +.listing_code .programlisting .comment, .listing_code .programlisting .linenum { color: #babdb6; } /* tango: aluminium 3 */ -.listing_code .programlisting .normal { color: #000000; } -.listing_code .programlisting .number { color: #75507b; } /* tango: plum 2 */ +.listing_code .programlisting .function, +.listing_code .programlisting .function a, .listing_code .programlisting .preproc { color: #204a87; } /* tango: sky blue 3 */ -.listing_code .programlisting .string { color: #c17d11; } /* tango: chocolate 2 */ -.listing_code .programlisting .type { color: #000000; } -.listing_code .programlisting .type a { color: #11326b; } /* tango: sky blue 4 */ -.listing_code .programlisting .symbol { color: #ce5c00; } /* tango: orange 3 */ +.listing_code .programlisting .string { color: #ad7fa8; } /* tango: plum */ +.listing_code .programlisting .keyword, +.listing_code .programlisting .usertype, +.listing_code .programlisting .type, +.listing_code .programlisting .type a { color: #4e9a06; } /* tango: chameleon 3 */ .listing_frame { /* tango:sky blue 1 */ border: solid 1px #729fcf; + border: solid 1px rgba(114, 159, 207, 0.2); padding: 0px; } @@ -248,19 +326,151 @@ h2 .extralinks, h3 .extralinks .listing_lines { /* tango:sky blue 0.5 */ background: #a6c5e3; + background: rgba(114, 159, 207, 0.2); /* tango:aluminium 6 */ color: #2e3436; } .listing_code { /* tango:sky blue 0 */ background: #e6f3ff; + background: rgba(114, 159, 207, 0.1); } .listing_code .programlisting { /* override from previous */ border: none 0px; padding: 0px; + background: none; } .listing_lines pre, .listing_code pre { margin: 0px; } +@media screen { + sup a.footnote + { + position: relative; + top: 0em ! important; + } + /* this is needed so that the local anchors are displayed below the naviagtion */ + div.footnote a[name], div.refnamediv a[name], div.refsect1 a[name], div.refsect2 a[name], div.index a[name], div.glossary a[name], div.sect1 a[name] + { + display: inline-block; + position: relative; + top:-5em; + } + /* this seems to be a bug in the xsl style sheets when generating indexes */ + div.index div.index + { + top: 0em; + } + /* make space for the fixed navigation bar and add space at the bottom so that + * link targets appear somewhat close to top + */ + body + { + padding-top: 2.5em; + padding-bottom: 500px; + max-width: 60em; + } + p + { + max-width: 60em; + } + /* style and size the navigation bar */ + table.navigation#top + { + position: fixed; + background: #e2e2e2; + border-bottom: solid 1px #babdb6; + border-spacing: 5px; + margin-top: 0; + margin-bottom: 0; + top: 0; + left: 0; + z-index: 10; + } + table.navigation#top td + { + padding-left: 6px; + padding-right: 6px; + } + .navigation a, .navigation a:visited + { + /* tango:sky blue 3 */ + color: #204a87; + } + .navigation a:hover + { + /* tango:sky blue 2 */ + color: #3465a4; + } + td.shortcuts + { + /* tango:sky blue 2 */ + color: #3465a4; + font-size: 80%; + white-space: nowrap; + } + td.shortcuts .dim + { + color: #babdb6; + } + .navigation .title + { + font-size: 80%; + max-width: none; + margin: 0px; + font-weight: normal; + } +} +@media screen and (min-width: 60em) { + /* screen larger than 60em */ + body { margin: auto; } +} +@media screen and (max-width: 60em) { + /* screen less than 60em */ + #nav_hierarchy { display: none; } + #nav_interfaces { display: none; } + #nav_prerequisites { display: none; } + #nav_derived_interfaces { display: none; } + #nav_implementations { display: none; } + #nav_child_properties { display: none; } + #nav_style_properties { display: none; } + #nav_index { display: none; } + #nav_glossary { display: none; } + .gallery_image { display: none; } + .property_flags { display: none; } + .signal_flags { display: none; } + .parameter_annotations { display: none; } + .enum_member_annotations { display: none; } + .struct_member_annotations { display: none; } + .union_member_annotations { display: none; } + /* now that a column is hidden, optimize space */ + col.parameters_name { width: auto; } + col.parameters_description { width: auto; } + col.struct_members_name { width: auto; } + col.struct_members_description { width: auto; } + col.enum_members_name { width: auto; } + col.enum_members_description { width: auto; } + col.union_members_name { width: auto; } + col.union_members_description { width: auto; } + .listing_lines { display: none; } +} +@media print { + table.navigation { + visibility: collapse; + display: none; + } + div.titlepage table.navigation { + visibility: visible; + display: table; + background: #e2e2e2; + border: solid 1px #babdb6; + margin-top: 0; + margin-bottom: 0; + top: 0; + left: 0; + height: 3em; + } +} + diff --git a/docs/api/html/up-insensitive.png b/docs/api/html/up-insensitive.png new file mode 100644 index 00000000..f4049860 Binary files /dev/null and b/docs/api/html/up-insensitive.png differ diff --git a/docs/api/html/up.png b/docs/api/html/up.png index 85b3e2a2..80b4b37e 100644 Binary files a/docs/api/html/up.png and b/docs/api/html/up.png differ diff --git a/docs/api/settings-spec.xml b/docs/api/settings-spec.xml index 24a413ae..abf8fde1 100644 --- a/docs/api/settings-spec.xml +++ b/docs/api/settings-spec.xml @@ -54,7 +54,7 @@ bond settingKey NameValue TypeDefault ValueValue Descriptioninterface-namestringDeprecated in favor of connection.interface-name, but can be used for backward-compatibility with older daemons, to set the bond's interface name.namestringbondThe setting's name, which uniquely identifies the setting within the connection. Each setting type has a name unique to that type, for example "ppp" or "wireless" or "wired". - optionsdict of string to stringDictionary of key/value pairs of bonding options. Both keys and values must be strings. Option names must contain only alphanumeric characters (ie, [a-zA-Z0-9]). + optionsdict of string to string{'mode': 'balance-rr'}Dictionary of key/value pairs of bonding options. Both keys and values must be strings. Option names must contain only alphanumeric characters (ie, [a-zA-Z0-9]).
bridge settingKey NameValue TypeDefault ValueValue Descriptionageing-timeuint32300The Ethernet MAC address aging time, in seconds. @@ -106,14 +106,14 @@ app-iscsi-flagsNMSettingDcbFlags (uint32)Specifies the NMSettingDcbFlags for the DCB iSCSI application. Flags may be any combination of NM_SETTING_DCB_FLAG_ENABLE (0x1), NM_SETTING_DCB_FLAG_ADVERTISE (0x2), and NM_SETTING_DCB_FLAG_WILLING (0x4).app-iscsi-priorityint32-1The highest User Priority (0 - 7) which iSCSI frames should use, or -1 for default priority. Only used when the "app-iscsi-flags" property includes the NM_SETTING_DCB_FLAG_ENABLE (0x1) flag.namestringdcbThe setting's name, which uniquely identifies the setting within the connection. Each setting type has a name unique to that type, for example "ppp" or "wireless" or "wired". - priority-bandwidtharray of uint32An array of 8 uint values, where the array index corresponds to the User Priority (0 - 7) and the value indicates the percentage of bandwidth of the priority's assigned group that the priority may use. The sum of all percentages for priorities which belong to the same group must total 100 percent. - priority-flow-controlarray of uint32An array of 8 boolean values, where the array index corresponds to the User Priority (0 - 7) and the value indicates whether or not the corresponding priority should transmit priority pause. + priority-bandwidtharray of uint32[0, 0, 0, 0, 0, 0, 0, 0]An array of 8 uint values, where the array index corresponds to the User Priority (0 - 7) and the value indicates the percentage of bandwidth of the priority's assigned group that the priority may use. The sum of all percentages for priorities which belong to the same group must total 100 percent. + priority-flow-controlarray of uint32[0, 0, 0, 0, 0, 0, 0, 0]An array of 8 boolean values, where the array index corresponds to the User Priority (0 - 7) and the value indicates whether or not the corresponding priority should transmit priority pause.priority-flow-control-flagsNMSettingDcbFlags (uint32)Specifies the NMSettingDcbFlags for DCB Priority Flow Control (PFC). Flags may be any combination of NM_SETTING_DCB_FLAG_ENABLE (0x1), NM_SETTING_DCB_FLAG_ADVERTISE (0x2), and NM_SETTING_DCB_FLAG_WILLING (0x4). - priority-group-bandwidtharray of uint32An array of 8 uint values, where the array index corresponds to the Priority Group ID (0 - 7) and the value indicates the percentage of link bandwidth allocated to that group. Allowed values are 0 - 100, and the sum of all values must total 100 percent. + priority-group-bandwidtharray of uint32[0, 0, 0, 0, 0, 0, 0, 0]An array of 8 uint values, where the array index corresponds to the Priority Group ID (0 - 7) and the value indicates the percentage of link bandwidth allocated to that group. Allowed values are 0 - 100, and the sum of all values must total 100 percent.priority-group-flagsNMSettingDcbFlags (uint32)Specifies the NMSettingDcbFlags for DCB Priority Groups. Flags may be any combination of NM_SETTING_DCB_FLAG_ENABLE (0x1), NM_SETTING_DCB_FLAG_ADVERTISE (0x2), and NM_SETTING_DCB_FLAG_WILLING (0x4). - priority-group-idarray of uint32An array of 8 uint values, where the array index corresponds to the User Priority (0 - 7) and the value indicates the Priority Group ID. Allowed Priority Group ID values are 0 - 7 or 15 for the unrestricted group. - priority-strict-bandwidtharray of uint32An array of 8 boolean values, where the array index corresponds to the User Priority (0 - 7) and the value indicates whether or not the priority may use all of the bandwidth allocated to its assigned group. - priority-traffic-classarray of uint32An array of 8 uint values, where the array index corresponds to the User Priority (0 - 7) and the value indicates the traffic class (0 - 7) to which the priority is mapped. + priority-group-idarray of uint32[0, 0, 0, 0, 0, 0, 0, 0]An array of 8 uint values, where the array index corresponds to the User Priority (0 - 7) and the value indicates the Priority Group ID. Allowed Priority Group ID values are 0 - 7 or 15 for the unrestricted group. + priority-strict-bandwidtharray of uint32[0, 0, 0, 0, 0, 0, 0, 0]An array of 8 boolean values, where the array index corresponds to the User Priority (0 - 7) and the value indicates whether or not the priority may use all of the bandwidth allocated to its assigned group. + priority-traffic-classarray of uint32[0, 0, 0, 0, 0, 0, 0, 0]An array of 8 uint values, where the array index corresponds to the User Priority (0 - 7) and the value indicates the traffic class (0 - 7) to which the priority is mapped.
generic settingKey NameValue TypeDefault ValueValue DescriptionnamestringgenericThe setting's name, which uniquely identifies the setting within the connection. Each setting type has a name unique to that type, for example "ppp" or "wireless" or "wired". @@ -140,7 +140,7 @@
ipv4 settingKey NameValue TypeDefault ValueValue Descriptionaddress-dataarray of vardictArray of IPv4 addresses. Each address dictionary contains at least 'address' and 'prefix' entries, containing the IP address as a string, and the prefix length as a uint32. Additional attributes may also exist on some addresses. - addressesarray of array of uint32Deprecated in favor of the 'address-data' and 'gateway' properties, but this can be used for backward-compatibility with older daemons. Note that if you send this property the daemon will ignore 'address-data' and 'gateway'. Array of IPv4 address structures. Each IPv4 address structure is composed of 3 32-bit values; the first being the IPv4 address (network byte order), the second the prefix (1 - 32), and last the IPv4 gateway (network byte order). The gateway may be left as 0 if no gateway exists for that subnet. + addressesarray of array of uint32[]Deprecated in favor of the 'address-data' and 'gateway' properties, but this can be used for backward-compatibility with older daemons. Note that if you send this property the daemon will ignore 'address-data' and 'gateway'. Array of IPv4 address structures. Each IPv4 address structure is composed of 3 32-bit values; the first being the IPv4 address (network byte order), the second the prefix (1 - 32), and last the IPv4 gateway (network byte order). The gateway may be left as 0 if no gateway exists for that subnet.dhcp-client-idstringA string sent to the DHCP server to identify the local machine which the DHCP server may use to customize the DHCP lease and options.dhcp-hostnamestringIf the "dhcp-send-hostname" property is TRUE, then the specified name will be sent to the DHCP server when acquiring a lease.dhcp-send-hostnamebooleanTRUEIf TRUE, a hostname is sent to the DHCP server when acquiring a lease. Some DHCP servers use this hostname to update DNS databases, essentially providing a static hostname for the computer. If the "dhcp-hostname" property is NULL and this property is TRUE, the current persistent hostname of the computer is sent. @@ -155,11 +155,11 @@ never-defaultbooleanFALSEIf TRUE, this connection will never be the default connection for this IP type, meaning it will never be assigned the default route by NetworkManager.route-dataarray of vardictArray of IPv4 routes. Each route dictionary contains at least 'dest' and 'prefix' entries, containing the destination IP address as a string, and the prefix length as a uint32. Most routes will also have a 'gateway' entry, containing the gateway IP address as a string. If the route has a 'metric' entry (containing a uint32), that will be used as the metric for the route (otherwise NM will pick a default value appropriate to the device). Additional attributes may also exist on some routes.route-metricint64-1The default metric for routes that don't explicitly specify a metric. The default value -1 means that the metric is choosen automatically based on the device type. The metric applies to dynamic routes, manual (static) routes that don't have an explicit metric setting, address prefix routes, and the default route. Note that for IPv6, the kernel accepts zero (0) but coerces it to 1024 (user default). Hence, setting this property to zero effectively mean setting it to 1024. For IPv4, zero is a regular value for the metric. - routesarray of array of uint32Deprecated in favor of the 'route-data' property, but this can be used for backward-compatibility with older daemons. Note that if you send this property the daemon will ignore 'route-data'. Array of IPv4 route structures. Each IPv4 route structure is composed of 4 32-bit values; the first being the destination IPv4 network or address (network byte order), the second the destination network or address prefix (1 - 32), the third being the next-hop (network byte order) if any, and the fourth being the route metric. If the metric is 0, NM will choose an appropriate default metric for the device. (There is no way to explicitly specify an actual metric of 0 with this property.) + routesarray of array of uint32[]Deprecated in favor of the 'route-data' property, but this can be used for backward-compatibility with older daemons. Note that if you send this property the daemon will ignore 'route-data'. Array of IPv4 route structures. Each IPv4 route structure is composed of 4 32-bit values; the first being the destination IPv4 network or address (network byte order), the second the destination network or address prefix (1 - 32), the third being the next-hop (network byte order) if any, and the fourth being the route metric. If the metric is 0, NM will choose an appropriate default metric for the device. (There is no way to explicitly specify an actual metric of 0 with this property.)
ipv6 settingKey NameValue TypeDefault ValueValue Descriptionaddress-dataarray of vardictArray of IPv6 addresses. Each address dictionary contains at least 'address' and 'prefix' entries, containing the IP address as a string, and the prefix length as a uint32. Additional attributes may also exist on some addresses. - addressesarray of legacy IPv6 address struct (a(ayuay))Deprecated in favor of the 'address-data' and 'gateway' properties, but this can be used for backward-compatibility with older daemons. Note that if you send this property the daemon will ignore 'address-data' and 'gateway'. Array of IPv6 address structures. Each IPv6 address structure is composed of an IPv6 address, a prefix length (1 - 128), and an IPv6 gateway address. The gateway may be zeroed out if no gateway exists for that subnet. + addressesarray of legacy IPv6 address struct (a(ayuay))[]Deprecated in favor of the 'address-data' and 'gateway' properties, but this can be used for backward-compatibility with older daemons. Note that if you send this property the daemon will ignore 'address-data' and 'gateway'. Array of IPv6 address structures. Each IPv6 address structure is composed of an IPv6 address, a prefix length (1 - 128), and an IPv6 gateway address. The gateway may be zeroed out if no gateway exists for that subnet.dhcp-hostnamestringIf the "dhcp-send-hostname" property is TRUE, then the specified name will be sent to the DHCP server when acquiring a lease.dhcp-send-hostnamebooleanTRUEIf TRUE, a hostname is sent to the DHCP server when acquiring a lease. Some DHCP servers use this hostname to update DNS databases, essentially providing a static hostname for the computer. If the "dhcp-hostname" property is NULL and this property is TRUE, the current persistent hostname of the computer is sent.dnsarray of byte array[]Array of IP addresses of DNS servers (in network byte order) @@ -174,7 +174,7 @@ never-defaultbooleanFALSEIf TRUE, this connection will never be the default connection for this IP type, meaning it will never be assigned the default route by NetworkManager.route-dataarray of vardictArray of IPv6 routes. Each route dictionary contains at least 'dest' and 'prefix' entries, containing the destination IP address as a string, and the prefix length as a uint32. Most routes will also have a 'next-hop' entry, containing the next hop IP address as a string. If the route has a 'metric' entry (containing a uint32), that will be used as the metric for the route (otherwise NM will pick a default value appropriate to the device). Additional attributes may also exist on some routes.route-metricint64-1The default metric for routes that don't explicitly specify a metric. The default value -1 means that the metric is choosen automatically based on the device type. The metric applies to dynamic routes, manual (static) routes that don't have an explicit metric setting, address prefix routes, and the default route. Note that for IPv6, the kernel accepts zero (0) but coerces it to 1024 (user default). Hence, setting this property to zero effectively mean setting it to 1024. For IPv4, zero is a regular value for the metric. - routesarray of legacy IPv6 route struct (a(ayuayu))Deprecated in favor of the 'route-data' property, but this can be used for backward-compatibility with older daemons. Note that if you send this property the daemon will ignore 'route-data'. Array of IPv6 route structures. Each IPv6 route structure is composed of an IPv6 address, a prefix length (1 - 128), an IPv6 next hop address (which may be zeroed out if there is no next hop), and a metric. If the metric is 0, NM will choose an appropriate default metric for the device. + routesarray of legacy IPv6 route struct (a(ayuayu))[]Deprecated in favor of the 'route-data' property, but this can be used for backward-compatibility with older daemons. Note that if you send this property the daemon will ignore 'route-data'. Array of IPv6 route structures. Each IPv6 route structure is composed of an IPv6 address, a prefix length (1 - 128), an IPv6 next hop address (which may be zeroed out if there is no next hop), and a metric. If the metric is 0, NM will choose an appropriate default metric for the device.
802-11-olpc-mesh settingKey NameValue TypeDefault ValueValue Descriptionchanneluint320Channel on which the mesh network to join is located. @@ -237,10 +237,10 @@ parentstringIf given, specifies the parent interface name or parent connection UUID from which this VLAN interface should be created. If this property is not specified, the connection must contain an "802-3-ethernet" setting with a "mac-address" property.
vpn settingKey NameValue TypeDefault ValueValue Description - datadict of string to stringDictionary of key/value pairs of VPN plugin specific data. Both keys and values must be strings. + datadict of string to string{}Dictionary of key/value pairs of VPN plugin specific data. Both keys and values must be strings.namestringvpnThe setting's name, which uniquely identifies the setting within the connection. Each setting type has a name unique to that type, for example "ppp" or "wireless" or "wired".persistentbooleanFALSEIf the VPN service supports persistence, and this property is TRUE, the VPN will attempt to stay connected across link changes and outages, until explicitly disconnected. - secretsdict of string to stringDictionary of key/value pairs of VPN plugin specific secrets like passwords or private keys. Both keys and values must be strings. + secretsdict of string to string{}Dictionary of key/value pairs of VPN plugin specific secrets like passwords or private keys. Both keys and values must be strings.service-typestringD-Bus service name of the VPN plugin that this setting uses to connect to its network. i.e. org.freedesktop.NetworkManager.vpnc for the vpnc plugin.user-namestringIf the VPN connection requires a user name for authentication, that name should be provided here. If the connection is available to more than one user, and the VPN requires each user to supply a different name, then leave this property empty. If this property is empty, NetworkManager will automatically supply the username of the user which requested the VPN connection.
@@ -259,7 +259,7 @@ namestring802-3-ethernetThe setting's name, which uniquely identifies the setting within the connection. Each setting type has a name unique to that type, for example "ppp" or "wireless" or "wired". portstringSpecific port type to use if multiple the device supports multiple attachment methods. One of "tp" (Twisted Pair), "aui" (Attachment Unit Interface), "bnc" (Thin Ethernet) or "mii" (Media Independent Interface. If the device supports only one port type, this setting is ignored. s390-nettypestrings390 network device type; one of "qeth", "lcs", or "ctc", representing the different types of virtual network devices available on s390 systems. - s390-optionsdict of string to stringDictionary of key/value pairs of s390-specific device options. Both keys and values must be strings. Allowed keys include "portno", "layer2", "portname", "protocol", among others. Key names must contain only alphanumeric characters (ie, [a-zA-Z0-9]). + s390-optionsdict of string to string{}Dictionary of key/value pairs of s390-specific device options. Both keys and values must be strings. Allowed keys include "portno", "layer2", "portname", "protocol", among others. Key names must contain only alphanumeric characters (ie, [a-zA-Z0-9]). s390-subchannelsarray of string[]Identifies specific subchannels that this network device uses for communication with z/VM or s390 host. Like the "mac-address" property for non-z/VM devices, this property can be used to ensure this connection only applies to the network device that uses these subchannels. The list should contain exactly 3 strings, and each string may only be composed of hexadecimal characters and the period (.) character. speeduint320If non-zero, request that the device use only the specified speed. In Mbit/s, ie 100 == 100Mbit/s. diff --git a/docs/api/spec.html b/docs/api/spec.html index cf717b59..f7992202 100644 --- a/docs/api/spec.html +++ b/docs/api/spec.html @@ -1,4 +1,4 @@ -NetworkManager D-Bus Interface Specification version 1.0.0

NetworkManager D-Bus Interface Specification

Version 1.0.0

Copyright (C) 2008 - 2011 Red Hat, Inc.
Copyright (C) 2008 - 2009 Novell, Inc.
+

NetworkManager D-Bus Interface Specification

Version 1.0.2

Copyright (C) 2008 - 2011 Red Hat, Inc.
Copyright (C) 2008 - 2009 Novell, Inc.

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or @@ -879,7 +879,7 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.

Parameters

options - a{sv}
- Options of scan + Options of scan (currently unused argument).

Signals:

PropertiesChanged ( a{sv}: properties )

@@ -937,7 +937,15 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.

Sets of flags:

NM_802_11_DEVICE_CAP

Flags describing the capabilities of a wireless device. -
NM_802_11_DEVICE_CAP_NONE = 0x0
Null capability - syntactic sugar for no capabilities supported. Do not AND this with other capabilities!
NM_802_11_DEVICE_CAP_CIPHER_WEP40 = 0x1
The device supports the 40-bit WEP cipher.
NM_802_11_DEVICE_CAP_CIPHER_WEP104 = 0x2
The device supports the 104-bit WEP cipher.
NM_802_11_DEVICE_CAP_CIPHER_TKIP = 0x4
The device supports the TKIP cipher.
NM_802_11_DEVICE_CAP_CIPHER_CCMP = 0x8
The device supports the CCMP cipher.
NM_802_11_DEVICE_CAP_WPA = 0x10
The device supports the WPA encryption/authentication protocol.
NM_802_11_DEVICE_CAP_RSN = 0x20
The device supports the RSN encryption/authentication protocol.
NM_802_11_DEVICE_CAP_AP = 0x40
The device supports Access Point mode.
NM_802_11_DEVICE_CAP_ADHOC = 0x80
The device supports Ad-Hoc mode.
+
NM_802_11_DEVICE_CAP_NONE = 0x0
Null capability - syntactic sugar for no capabilities supported. Do not AND this with other capabilities!
NM_802_11_DEVICE_CAP_CIPHER_WEP40 = 0x1
The device supports the 40-bit WEP cipher.
NM_802_11_DEVICE_CAP_CIPHER_WEP104 = 0x2
The device supports the 104-bit WEP cipher.
NM_802_11_DEVICE_CAP_CIPHER_TKIP = 0x4
The device supports the TKIP cipher.
NM_802_11_DEVICE_CAP_CIPHER_CCMP = 0x8
The device supports the CCMP cipher.
NM_802_11_DEVICE_CAP_WPA = 0x10
The device supports the WPA encryption/authentication protocol.
NM_802_11_DEVICE_CAP_RSN = 0x20
The device supports the RSN encryption/authentication protocol.
NM_802_11_DEVICE_CAP_AP = 0x40
The device supports Access Point mode.
NM_802_11_DEVICE_CAP_ADHOC = 0x80
The device supports Ad-Hoc mode.
NM_802_11_DEVICE_CAP_FREQ_VALID = 0x100
+ The device properly reports information about supported + frequencies and thus both NM_802_11_DEVICE_CAP_FREQ_2GHZ and + NM_802_11_DEVICE_CAP_FREQ_5GHZ are valid. +
NM_802_11_DEVICE_CAP_FREQ_2GHZ = 0x200
+ The device supports 2.4GHz frequencies. +
NM_802_11_DEVICE_CAP_FREQ_5GHZ = 0x400
+ The device supports 5GHz frequencies. +

org.freedesktop.NetworkManager.Device.Modem

Interface has no methods.

Signals:

PropertiesChanged ( a{sv}: properties diff --git a/docs/api/version.xml b/docs/api/version.xml index 3eefcb9d..6d7de6e6 100644 --- a/docs/api/version.xml +++ b/docs/api/version.xml @@ -1 +1 @@ -1.0.0 +1.0.2 diff --git a/docs/libnm-glib/Makefile.in b/docs/libnm-glib/Makefile.in index e2f71216..796e69f2 100644 --- a/docs/libnm-glib/Makefile.in +++ b/docs/libnm-glib/Makefile.in @@ -1,7 +1,7 @@ -# Makefile.in generated by automake 1.13.4 from Makefile.am. +# Makefile.in generated by automake 1.15 from Makefile.am. # @configure_input@ -# Copyright (C) 1994-2013 Free Software Foundation, Inc. +# Copyright (C) 1994-2014 Free Software Foundation, Inc. # This Makefile.in is free software; the Free Software Foundation # gives unlimited permission to copy and/or distribute it, @@ -20,7 +20,17 @@ # Everything below here is generic # #################################### VPATH = @srcdir@ -am__is_gnu_make = test -n '$(MAKEFILE_LIST)' && test -n '$(MAKELEVEL)' +am__is_gnu_make = { \ + if test -z '$(MAKELEVEL)'; then \ + false; \ + elif test -n '$(MAKE_HOST)'; then \ + true; \ + elif test -n '$(MAKE_VERSION)' && test -n '$(CURDIR)'; then \ + true; \ + else \ + false; \ + fi; \ +} am__make_running_with_option = \ case $${target_option-} in \ ?) ;; \ @@ -83,8 +93,6 @@ PRE_UNINSTALL = : POST_UNINSTALL = : build_triplet = @build@ host_triplet = @host@ -DIST_COMMON = $(top_srcdir)/gtk-doc.make $(srcdir)/Makefile.in \ - $(srcdir)/Makefile.am $(srcdir)/version.xml.in subdir = docs/libnm-glib ACLOCAL_M4 = $(top_srcdir)/aclocal.m4 am__aclocal_m4_deps = $(top_srcdir)/m4/ax_lib_readline.m4 \ @@ -102,6 +110,7 @@ am__aclocal_m4_deps = $(top_srcdir)/m4/ax_lib_readline.m4 \ $(top_srcdir)/m4/vapigen.m4 $(top_srcdir)/configure.ac am__configure_deps = $(am__aclocal_m4_deps) $(CONFIGURE_DEPENDENCIES) \ $(ACLOCAL_M4) +DIST_COMMON = $(srcdir)/Makefile.am $(am__DIST_COMMON) mkinstalldirs = $(install_sh) -d CONFIG_HEADER = $(top_builddir)/config.h CONFIG_CLEAN_FILES = version.xml @@ -126,6 +135,8 @@ am__can_run_installinfo = \ *) (install-info --version) >/dev/null 2>&1;; \ esac am__tagged_files = $(HEADERS) $(SOURCES) $(TAGS_FILES) $(LISP) +am__DIST_COMMON = $(srcdir)/Makefile.in $(srcdir)/version.xml.in \ + $(top_srcdir)/gtk-doc.make DISTFILES = $(DIST_COMMON) $(DIST_SOURCES) $(TEXINFOS) $(EXTRA_DIST) ACLOCAL = @ACLOCAL@ ALL_LINGUAS = @ALL_LINGUAS@ @@ -152,7 +163,6 @@ CXXCPP = @CXXCPP@ CXXDEPMODE = @CXXDEPMODE@ CXXFLAGS = @CXXFLAGS@ CYGPATH_W = @CYGPATH_W@ -DATADIRNAME = @DATADIRNAME@ DBUS_CFLAGS = @DBUS_CFLAGS@ DBUS_GLIB_100_CFLAGS = @DBUS_GLIB_100_CFLAGS@ DBUS_GLIB_100_LIBS = @DBUS_GLIB_100_LIBS@ @@ -187,6 +197,7 @@ GNUTLS_CFLAGS = @GNUTLS_CFLAGS@ GNUTLS_LIBS = @GNUTLS_LIBS@ GREP = @GREP@ GTKDOC_CHECK = @GTKDOC_CHECK@ +GTKDOC_CHECK_PATH = @GTKDOC_CHECK_PATH@ GTKDOC_DEPS_CFLAGS = @GTKDOC_DEPS_CFLAGS@ GTKDOC_DEPS_LIBS = @GTKDOC_DEPS_LIBS@ GTKDOC_MKPDF = @GTKDOC_MKPDF@ @@ -493,12 +504,12 @@ REPORT_FILES = \ $(DOC_MODULE)-unused.txt CLEANFILES = $(SCANOBJ_FILES) $(REPORT_FILES) $(DOC_STAMPS) \ - libnm-glib-sections.txt libnm-glib-overrides.txt html/* tmpl/* \ - xml/* -@ENABLE_GTK_DOC_TRUE@@GTK_DOC_BUILD_HTML_FALSE@HTML_BUILD_STAMP = -@ENABLE_GTK_DOC_TRUE@@GTK_DOC_BUILD_HTML_TRUE@HTML_BUILD_STAMP = html-build.stamp -@ENABLE_GTK_DOC_TRUE@@GTK_DOC_BUILD_PDF_FALSE@PDF_BUILD_STAMP = -@ENABLE_GTK_DOC_TRUE@@GTK_DOC_BUILD_PDF_TRUE@PDF_BUILD_STAMP = pdf-build.stamp + gtkdoc-check.test libnm-glib-sections.txt \ + libnm-glib-overrides.txt html/* tmpl/* xml/* +@GTK_DOC_BUILD_HTML_FALSE@HTML_BUILD_STAMP = +@GTK_DOC_BUILD_HTML_TRUE@HTML_BUILD_STAMP = html-build.stamp +@GTK_DOC_BUILD_PDF_FALSE@PDF_BUILD_STAMP = +@GTK_DOC_BUILD_PDF_TRUE@PDF_BUILD_STAMP = pdf-build.stamp #### setup #### GTK_DOC_V_SETUP = $(GTK_DOC_V_SETUP_$(V)) @@ -550,7 +561,6 @@ $(srcdir)/Makefile.in: @MAINTAINER_MODE_TRUE@ $(srcdir)/Makefile.am $(top_srcdir echo ' cd $(top_srcdir) && $(AUTOMAKE) --gnu docs/libnm-glib/Makefile'; \ $(am__cd) $(top_srcdir) && \ $(AUTOMAKE) --gnu docs/libnm-glib/Makefile -.PRECIOUS: Makefile Makefile: $(srcdir)/Makefile.in $(top_builddir)/config.status @case '$?' in \ *config.status*) \ @@ -559,7 +569,7 @@ Makefile: $(srcdir)/Makefile.in $(top_builddir)/config.status echo ' cd $(top_builddir) && $(SHELL) ./config.status $(subdir)/$@ $(am__depfiles_maybe)'; \ cd $(top_builddir) && $(SHELL) ./config.status $(subdir)/$@ $(am__depfiles_maybe);; \ esac; -$(top_srcdir)/gtk-doc.make: +$(top_srcdir)/gtk-doc.make $(am__empty): $(top_builddir)/config.status: $(top_srcdir)/configure $(CONFIG_STATUS_DEPENDENCIES) cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh @@ -619,6 +629,7 @@ distdir: $(DISTFILES) dist-hook check-am: all-am check: check-am +@ENABLE_GTK_DOC_FALSE@all-local: all-am: Makefile all-local installdirs: install: install-am @@ -735,9 +746,18 @@ uninstall-am: uninstall-local mostlyclean-libtool pdf pdf-am ps ps-am tags-am uninstall \ uninstall-am uninstall-local +.PRECIOUS: Makefile -@ENABLE_GTK_DOC_TRUE@all-local: $(HTML_BUILD_STAMP) $(PDF_BUILD_STAMP) -@ENABLE_GTK_DOC_FALSE@all-local: + +gtkdoc-check.test: Makefile + $(AM_V_GEN)echo "#!/bin/sh -e" > $@; \ + echo "$(GTKDOC_CHECK_PATH) || exit 1" >> $@; \ + chmod +x $@ + +all-gtk-doc: $(HTML_BUILD_STAMP) $(PDF_BUILD_STAMP) +.PHONY: all-gtk-doc + +@ENABLE_GTK_DOC_TRUE@all-local: all-gtk-doc docs: $(HTML_BUILD_STAMP) $(PDF_BUILD_STAMP) @@ -748,17 +768,19 @@ setup-build.stamp: files=`echo $(SETUP_FILES) $(expand_content_files) $(DOC_MODULE).types`; \ if test "x$$files" != "x" ; then \ for file in $$files ; do \ + destdir=`dirname $(abs_builddir)/$$file` ;\ + test -d "$$destdir" || mkdir -p "$$destdir"; \ test -f $(abs_srcdir)/$$file && \ - cp -pu $(abs_srcdir)/$$file $(abs_builddir)/$$file || true; \ + cp -pf $(abs_srcdir)/$$file $(abs_builddir)/$$file || true; \ done; \ fi; \ test -d $(abs_srcdir)/tmpl && \ - { cp -rp $(abs_srcdir)/tmpl $(abs_builddir)/; \ + { cp -pR $(abs_srcdir)/tmpl $(abs_builddir)/; \ chmod -R u+w $(abs_builddir)/tmpl; } \ fi $(AM_V_at)touch setup-build.stamp -scan-build.stamp: $(HFILE_GLOB) $(CFILE_GLOB) +scan-build.stamp: setup-build.stamp $(HFILE_GLOB) $(CFILE_GLOB) $(GTK_DOC_V_SCAN)_source_dir='' ; \ for i in $(DOC_SOURCE_DIR) ; do \ _source_dir="$${_source_dir} --source-dir=$$i" ; \ @@ -788,7 +810,7 @@ tmpl-build.stamp: setup-build.stamp $(DOC_MODULE)-decl.txt $(SCANOBJ_FILES) $(DO $(GTK_DOC_V_TMPL)gtkdoc-mktmpl --module=$(DOC_MODULE) $(MKTMPL_OPTIONS) $(AM_V_at)if test "$(abs_srcdir)" != "$(abs_builddir)" ; then \ if test -w $(abs_srcdir) ; then \ - cp -rp $(abs_builddir)/tmpl $(abs_srcdir)/; \ + cp -pR $(abs_builddir)/tmpl $(abs_srcdir)/; \ fi \ fi $(AM_V_at)touch tmpl-build.stamp @@ -800,7 +822,7 @@ $(srcdir)/tmpl/*.sgml: @true sgml-build.stamp: tmpl.stamp $(DOC_MODULE)-sections.txt $(srcdir)/tmpl/*.sgml $(expand_content_files) - $(GTK_DOC_V_XML)-chmod -R u+w $(srcdir) && _source_dir='' ; \ + -$(GTK_DOC_V_XML)chmod -R u+w $(srcdir) && _source_dir='' ; \ for i in $(DOC_SOURCE_DIR) ; do \ _source_dir="$${_source_dir} --source-dir=$$i" ; \ done ; \ @@ -862,6 +884,9 @@ pdf-build.stamp: sgml.stamp $(DOC_MAIN_SGML_FILE) $(content_files) clean-local: @rm -f *~ *.bak @rm -rf .libs + @if echo $(SCAN_OPTIONS) | grep -q "\-\-rebuild-types" ; then \ + rm -f $(DOC_MODULE).types; \ + fi distclean-local: @rm -rf xml html $(REPORT_FILES) $(DOC_MODULE).pdf \ @@ -907,12 +932,14 @@ uninstall-local: # # Require gtk-doc when making dist # -@ENABLE_GTK_DOC_TRUE@dist-check-gtkdoc: docs -@ENABLE_GTK_DOC_FALSE@dist-check-gtkdoc: -@ENABLE_GTK_DOC_FALSE@ @echo "*** gtk-doc must be installed and enabled in order to make dist" -@ENABLE_GTK_DOC_FALSE@ @false - -dist-hook: dist-check-gtkdoc dist-hook-local +@HAVE_GTK_DOC_TRUE@dist-check-gtkdoc: docs +@HAVE_GTK_DOC_FALSE@dist-check-gtkdoc: +@HAVE_GTK_DOC_FALSE@ @echo "*** gtk-doc is needed to run 'make dist'. ***" +@HAVE_GTK_DOC_FALSE@ @echo "*** gtk-doc was not found when 'configure' ran. ***" +@HAVE_GTK_DOC_FALSE@ @echo "*** please install gtk-doc and rerun 'configure'. ***" +@HAVE_GTK_DOC_FALSE@ @false + +dist-hook: dist-check-gtkdoc all-gtk-doc dist-hook-local @mkdir $(distdir)/tmpl @mkdir $(distdir)/html @-cp ./tmpl/*.sgml $(distdir)/tmpl diff --git a/docs/libnm-glib/html/NMAccessPoint.html b/docs/libnm-glib/html/NMAccessPoint.html index 97ae9c96..e0e5660a 100644 --- a/docs/libnm-glib/html/NMAccessPoint.html +++ b/docs/libnm-glib/html/NMAccessPoint.html @@ -2,36 +2,28 @@ -NMAccessPoint +libnm-glib Reference Manual: NMAccessPoint - + - - - - - - - - - - + + + + + + +
@@ -39,649 +31,823 @@

NMAccessPoint

NMAccessPoint

- +
- -
-

Object Hierarchy

-
-  GObject
-   +----NMObject
-         +----NMAccessPoint
-
-
-
-

Implemented Interfaces

-

-NMAccessPoint implements - GInitable and GAsyncInitable.

-
-
-

Properties

-
-  "bssid"                    gchar*                : Read
-  "flags"                    guint                 : Read
-  "frequency"                guint                 : Read
-  "hw-address"               gchar*                : Read
-  "max-bitrate"              guint                 : Read
-  "mode"                     guint                 : Read
-  "rsn-flags"                guint                 : Read
-  "ssid"                     NMSsid*               : Read
-  "strength"                 guchar                : Read
-  "wpa-flags"                guint                 : Read
-
-
-

Description

-

-

-
-
-

Details

-
-

NM_ACCESS_POINT_FLAGS

-
#define NM_ACCESS_POINT_FLAGS       "flags"
-
-

-

-
-
-
-

NM_ACCESS_POINT_WPA_FLAGS

-
#define NM_ACCESS_POINT_WPA_FLAGS   "wpa-flags"
-
-

-

-
-
-
-

NM_ACCESS_POINT_RSN_FLAGS

-
#define NM_ACCESS_POINT_RSN_FLAGS   "rsn-flags"
-
-

-

-
-
-
-

NM_ACCESS_POINT_SSID

-
#define NM_ACCESS_POINT_SSID        "ssid"
-
-

-

-
-
-
-

NM_ACCESS_POINT_BSSID

-
#define NM_ACCESS_POINT_BSSID       "bssid"
-
-

-

-
-
-
-

NM_ACCESS_POINT_FREQUENCY

-
#define NM_ACCESS_POINT_FREQUENCY   "frequency"
-
-

-

-
-
-
-

NM_ACCESS_POINT_MODE

-
#define NM_ACCESS_POINT_MODE        "mode"
-
-

-

-
-
-
-

NM_ACCESS_POINT_MAX_BITRATE

-
#define NM_ACCESS_POINT_MAX_BITRATE "max-bitrate"
-
-

-

-
-
-
-

NM_ACCESS_POINT_STRENGTH

-
#define NM_ACCESS_POINT_STRENGTH    "strength"
-
-

-

-
-
-
-

NM_ACCESS_POINT_HW_ADDRESS

-
#define NM_ACCESS_POINT_HW_ADDRESS  "hw-address"
-
-

-

-
-
-
-

NMAccessPoint

-
typedef struct _NMAccessPoint NMAccessPoint;
-

-

-
-
-
-

NMAccessPointClass

-
typedef struct {
-	NMObjectClass parent;
-
-	/* Padding for future expansion */
-	void (*_reserved1) (void);
-	void (*_reserved2) (void);
-	void (*_reserved3) (void);
-	void (*_reserved4) (void);
-	void (*_reserved5) (void);
-	void (*_reserved6) (void);
-} NMAccessPointClass;
-
-

-

-
-
-
-

nm_access_point_new ()

-
GObject *           nm_access_point_new                 (DBusGConnection *connection,
-                                                         const char *path);
-

-Creates a new NMAccessPoint. -

-
+

Functions

+
--++ - - + - - + + + + + + - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

connection :

the DBusGConnection + +GObject * + +nm_access_point_new ()

path :

the DBusobject path of the access point +NM80211ApFlags + +nm_access_point_get_flags () +
+NM80211ApSecurityFlags + +nm_access_point_get_wpa_flags () +

Returns :

a new access point. [transfer full] + +NM80211ApSecurityFlags + +nm_access_point_get_rsn_flags () +
const GByteArray * + +nm_access_point_get_ssid () +
const char * + +nm_access_point_get_bssid () +
+guint32 + +nm_access_point_get_frequency () +
+NM80211Mode + +nm_access_point_get_mode () +
+guint32 + +nm_access_point_get_max_bitrate () +
+guint8 + +nm_access_point_get_strength () +
+GSList * + +nm_access_point_filter_connections () +
+gboolean + +nm_access_point_connection_valid () +
const char * + +nm_access_point_get_hw_address ()
-
-
-

nm_access_point_get_flags ()

-
NM80211ApFlags      nm_access_point_get_flags           (NMAccessPoint *ap);
-

-Gets the flags of the access point. -

-
+
+

Properties

+
--+++ - - + + + + + + + + + + + + + + + + + + + + + + + - - + + + + + + + + + + + + + + + + + + + + + + +

ap :

a NMAccessPoint - +gchar *bssidRead
guintflagsRead
guintfrequencyRead
+gchar *hw-addressRead
guintmax-bitrateRead

Returns :

the flagsguintmodeRead
guintrsn-flagsRead
+NMSsid *ssidRead
gucharstrengthRead
guintwpa-flagsRead
-
-
-

nm_access_point_get_wpa_flags ()

-
NM80211ApSecurityFlags nm_access_point_get_wpa_flags    (NMAccessPoint *ap);
-

-Gets the WPA (version 1) flags of the access point. -

-
+
+

Types and Values

+
--++ - - + + + + + + + + + + + + + + + + + + + + + + + + + + - - + + + + + + + + + +

ap :

a NMAccessPoint -#defineNM_ACCESS_POINT_FLAGS
#defineNM_ACCESS_POINT_WPA_FLAGS
#defineNM_ACCESS_POINT_RSN_FLAGS
#defineNM_ACCESS_POINT_SSID
#defineNM_ACCESS_POINT_BSSID
#defineNM_ACCESS_POINT_FREQUENCY
#defineNM_ACCESS_POINT_MODE

Returns :

the WPA flags#defineNM_ACCESS_POINT_MAX_BITRATE
#defineNM_ACCESS_POINT_STRENGTH
#defineNM_ACCESS_POINT_HW_ADDRESS
-
-
-

nm_access_point_get_rsn_flags ()

-
NM80211ApSecurityFlags nm_access_point_get_rsn_flags    (NMAccessPoint *ap);
+
+

Object Hierarchy

+
    GObject
+    ╰── NMObject
+        ╰── NMAccessPoint
+
+
+
+

Description

-Gets the RSN (Robust Secure Network, ie WPA version 2) flags of the access -point.

-
+ +
+

Functions

+
+

nm_access_point_new ()

+
GObject *
+nm_access_point_new (DBusGConnection *connection,
+                     const char *path);
+

Creates a new NMAccessPoint.

+
+

Parameters

+
--+++ - - + + + - - + + +

ap :

a NMAccessPoint -

connection

the DBusGConnection

 

Returns :

the RSN flags

path

the DBusobject path of the access point

 
+
+

Returns

+

a new access point.

+

[transfer full]

+
+

-

nm_access_point_get_ssid ()

-
const GByteArray *  nm_access_point_get_ssid            (NMAccessPoint *ap);
-

-Gets the SSID of the access point. -

-
+

nm_access_point_get_flags ()

+
NM80211ApFlags
+nm_access_point_get_flags (NMAccessPoint *ap);
+

Gets the flags of the access point.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

ap :

a NMAccessPoint -

Returns :

the GByteArray containing the SSID. This is the internal copy used by the -access point, and must not be modified.

ap

a NMAccessPoint

 
+
+

Returns

+

the flags

+

+
+

-

nm_access_point_get_bssid ()

-
const char *        nm_access_point_get_bssid           (NMAccessPoint *ap);
-

-Gets the Basic Service Set ID (BSSID) of the Wi-Fi access point. -

-
+

nm_access_point_get_wpa_flags ()

+
NM80211ApSecurityFlags
+nm_access_point_get_wpa_flags (NMAccessPoint *ap);
+

Gets the WPA (version 1) flags of the access point.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

ap :

a NMAccessPoint -

Returns :

the BSSID of the access point. This is an internal string and must -not be modified or freed.

ap

a NMAccessPoint

 
+
+

Returns

+

the WPA flags

+

+
+

-

nm_access_point_get_frequency ()

-
guint32             nm_access_point_get_frequency       (NMAccessPoint *ap);
-

-Gets the frequency of the access point. -

-
+

nm_access_point_get_rsn_flags ()

+
NM80211ApSecurityFlags
+nm_access_point_get_rsn_flags (NMAccessPoint *ap);
+

Gets the RSN (Robust Secure Network, ie WPA version 2) flags of the access +point.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

ap :

a NMAccessPoint -

Returns :

the frequency

ap

a NMAccessPoint

 
+
+

Returns

+

the RSN flags

+

+
+


-

nm_access_point_get_mode ()

-
NM80211Mode         nm_access_point_get_mode            (NMAccessPoint *ap);
-

-Gets the mode of the access point. -

-
+

nm_access_point_get_ssid ()

+
const GByteArray *
+nm_access_point_get_ssid (NMAccessPoint *ap);
+

Gets the SSID of the access point.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

ap :

a NMAccessPoint -

Returns :

the mode

ap

a NMAccessPoint

 
+
+

Returns

+

the GByteArray containing the SSID. This is the internal copy used by the +access point, and must not be modified.

+

+
+

-

nm_access_point_get_max_bitrate ()

-
guint32             nm_access_point_get_max_bitrate     (NMAccessPoint *ap);
-

-Gets the maximum bit rate of the access point in kbit/s. -

-
+

nm_access_point_get_bssid ()

+
const char *
+nm_access_point_get_bssid (NMAccessPoint *ap);
+

Gets the Basic Service Set ID (BSSID) of the Wi-Fi access point.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

ap :

a NMAccessPoint -

Returns :

the maximum bit rate (kbit/s)

ap

a NMAccessPoint

 
+
+

Returns

+

the BSSID of the access point. This is an internal string and must +not be modified or freed.

+

+
+

-

nm_access_point_get_strength ()

-
guint8              nm_access_point_get_strength        (NMAccessPoint *ap);
-

-Gets the current signal strength of the access point. -

-
+

nm_access_point_get_frequency ()

+
guint32
+nm_access_point_get_frequency (NMAccessPoint *ap);
+

Gets the frequency of the access point.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

ap :

a NMAccessPoint -

Returns :

the signal strength

ap

a NMAccessPoint

 
+
+

Returns

+

the frequency

+

+
+

-

nm_access_point_filter_connections ()

-
GSList *            nm_access_point_filter_connections  (NMAccessPoint *ap,
-                                                         const GSList *connections);
-

-Filters a given list of connections for a given NMAccessPoint object and +

nm_access_point_get_mode ()

+
NM80211Mode
+nm_access_point_get_mode (NMAccessPoint *ap);
+

Gets the mode of the access point.

+
+

Parameters

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

ap

a NMAccessPoint

 
+
+
+

Returns

+

the mode

+

+
+
+
+
+

nm_access_point_get_max_bitrate ()

+
guint32
+nm_access_point_get_max_bitrate (NMAccessPoint *ap);
+

Gets the maximum bit rate of the access point in kbit/s.

+
+

Parameters

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

ap

a NMAccessPoint

 
+
+
+

Returns

+

the maximum bit rate (kbit/s)

+

+
+
+
+
+

nm_access_point_get_strength ()

+
guint8
+nm_access_point_get_strength (NMAccessPoint *ap);
+

Gets the current signal strength of the access point.

+
+

Parameters

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

ap

a NMAccessPoint

 
+
+
+

Returns

+

the signal strength

+

+
+
+
+
+

nm_access_point_filter_connections ()

+
GSList *
+nm_access_point_filter_connections (NMAccessPoint *ap,
+                                    const GSList *connections);
+

Filters a given list of connections for a given NMAccessPoint object and return connections which may be activated with the access point. Any -returned connections will match the ap's SSID and (if given) BSSID and -other attributes like security settings, channel, etc. -

-

-To obtain the list of connections that are compatible with this access point, -use nm_remote_settings_list_connections() and then filter the returned list -for a given NMDevice using nm_device_filter_connections() and finally -filter that list with this function. -

-
+returned connections will match the ap +'s SSID and (if given) BSSID and +other attributes like security settings, channel, etc.

+

To obtain the list of connections that are compatible with this access point, +use nm_remote_settings_list_connections() and then filter the returned list +for a given NMDevice using nm_device_filter_connections() and finally +filter that list with this function.

+
+

Parameters

+
--+++ - - + + + - - - - - - + + +

ap :

an NMAccessPoint to filter connections for

ap

an NMAccessPoint to filter connections for

 

connections :

a list of -NMConnection objects to filter. [element-type NMConnection] -

Returns :

a -list of NMConnection objects that could be activated with the given ap. -The elements of the list are owned by their creator and should not be freed -by the caller, but the returned list itself is owned by the caller and should -be freed with g_slist_free() when it is no longer required. [transfer container][element-type NMConnection] -

connections

a list of +NMConnection objects to filter.

[element-type NMConnection]
+
+

Returns

+

a +list of NMConnection objects that could be activated with the given ap +. +The elements of the list are owned by their creator and should not be freed +by the caller, but the returned list itself is owned by the caller and should +be freed with g_slist_free() when it is no longer required.

+

[transfer container][element-type NMConnection]

+
+

-

nm_access_point_connection_valid ()

-
gboolean            nm_access_point_connection_valid    (NMAccessPoint *ap,
-                                                         NMConnection *connection);
-

-Validates a given connection against a given Wi-Fi access point to ensure that +

nm_access_point_connection_valid ()

+
gboolean
+nm_access_point_connection_valid (NMAccessPoint *ap,
+                                  NMConnection *connection);
+

Validates a given connection against a given Wi-Fi access point to ensure that the connection may be activated with that AP. The connection must match the -ap's SSID, (if given) BSSID, and other attributes like security settings, -channel, band, etc. -

-
+ap +'s SSID, (if given) BSSID, and other attributes like security settings, +channel, band, etc.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + +

ap :

an NMAccessPoint to validate connection against

connection :

an NMConnection to validate against ap -

ap

an NMAccessPoint to validate connection +against

 

Returns :

-TRUE if the connection may be activated with this Wi-Fi AP, -FALSE if it cannot be.

connection

an NMConnection to validate against ap +

 
+
+

Returns

+

TRUE if the connection may be activated with this Wi-Fi AP, +FALSE if it cannot be.

+

+
+

-

nm_access_point_get_hw_address ()

-
const char *        nm_access_point_get_hw_address      (NMAccessPoint *ap);
-
-

Warning

-

nm_access_point_get_hw_address has been deprecated since version 0.9 and should not be used in newly-written code. Use nm_access_point_get_bssid() instead.

+

nm_access_point_get_hw_address ()

+
const char *
+nm_access_point_get_hw_address (NMAccessPoint *ap);
+
+

nm_access_point_get_hw_address has been deprecated since version 0.9 and should not be used in newly-written code.

+

Use nm_access_point_get_bssid() instead.

-

-Gets the hardware (MAC) address of the access point. -

-
+

Gets the hardware (MAC) address of the access point.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

ap :

a NMAccessPoint -

Returns :

the hardware address of the access point. This is the internal string used by the -access point and must not be modified.

ap

a NMAccessPoint

 
+
+

Returns

+

the hardware address of the access point. This is the internal string used by the +access point and must not be modified.

+

+
+
-

Property Details

+

Types and Values

-

The "bssid" property

-
  "bssid"                    gchar*                : Read
+

NM_ACCESS_POINT_FLAGS

+
#define NM_ACCESS_POINT_FLAGS       "flags"
+

-The BSSID of the access point.

-

Default value: NULL


-

The "flags" property

-
  "flags"                    guint                 : Read
+

NM_ACCESS_POINT_WPA_FLAGS

+
#define NM_ACCESS_POINT_WPA_FLAGS   "wpa-flags"
+

-The flags of the access point.

-

Allowed values: <= 1

-

Default value: 0


-

The "frequency" property

-
  "frequency"                guint                 : Read
+

NM_ACCESS_POINT_RSN_FLAGS

+
#define NM_ACCESS_POINT_RSN_FLAGS   "rsn-flags"
+

-The frequency of the access point.

-

Allowed values: <= 10000

-

Default value: 0


-

The "hw-address" property

-
  "hw-address"               gchar*                : Read
+

NM_ACCESS_POINT_SSID

+
#define NM_ACCESS_POINT_SSID        "ssid"
+

-The hardware address of the access point.

-

Default value: NULL


-

The "max-bitrate" property

-
  "max-bitrate"              guint                 : Read
+

NM_ACCESS_POINT_BSSID

+
#define NM_ACCESS_POINT_BSSID       "bssid"
+

-The maximum bit rate of the access point in kbit/s.

-

Default value: 0


-

The "mode" property

-
  "mode"                     guint                 : Read
+

NM_ACCESS_POINT_FREQUENCY

+
#define NM_ACCESS_POINT_FREQUENCY   "frequency"
+

-The mode of the access point; either "infrastructure" (a central -coordinator of the wireless network allowing clients to connect) or -"ad-hoc" (a network with no central controller).

-

Allowed values: [1,2]

-

Default value: 2


-

The "rsn-flags" property

-
  "rsn-flags"                guint                 : Read
+

NM_ACCESS_POINT_MODE

+
#define NM_ACCESS_POINT_MODE        "mode"
+

-The RSN flags of the access point.

-

Default value: 0


-

The "ssid" property

-
  "ssid"                     NMSsid*               : Read
+

NM_ACCESS_POINT_MAX_BITRATE

+
#define NM_ACCESS_POINT_MAX_BITRATE "max-bitrate"
+

-The SSID of the access point.


-

The "strength" property

-
  "strength"                 guchar                : Read
+

NM_ACCESS_POINT_STRENGTH

+
#define NM_ACCESS_POINT_STRENGTH    "strength"
+

-The current signal strength of the access point.

-

Default value: 0


-

The "wpa-flags" property

-
  "wpa-flags"                guint                 : Read
+

NM_ACCESS_POINT_HW_ADDRESS

+
#define NM_ACCESS_POINT_HW_ADDRESS  "hw-address"
+

-The WPA flags of the access point.

+
+
+
+

Property Details

+
+

The “bssid” property

+
  “bssid”                    gchar *
+

+

Flags: Read

+

Default value: NULL

+
+
+
+

The “flags” property

+
  “flags”                    guint
+

+

Flags: Read

+

Allowed values: <= 1

+

Default value: 0

+
+
+
+

The “frequency” property

+
  “frequency”                guint
+

+

Flags: Read

+

Allowed values: <= 10000

+

Default value: 0

+
+
+
+

The “hw-address” property

+
  “hw-address”               gchar *
+

+

Flags: Read

+

Default value: NULL

+
+
+
+

The “max-bitrate” property

+
  “max-bitrate”              guint
+

+

Flags: Read

+

Default value: 0

+
+
+
+

The “mode” property

+
  “mode”                     guint
+

+

Flags: Read

+

Allowed values: [1,2]

+

Default value: 2

+
+
+
+

The “rsn-flags” property

+
  “rsn-flags”                guint
+

+

Flags: Read

+

Default value: 0

+
+
+
+

The “ssid” property

+
  “ssid”                     NMSsid *
+

+

Flags: Read

+
+
+
+

The “strength” property

+
  “strength”                 guchar
+

+

Flags: Read

+

Default value: 0

+
+
+
+

The “wpa-flags” property

+
  “wpa-flags”                guint
+

+

Flags: Read

Default value: 0

+ Generated by GTK-Doc V1.21
\ No newline at end of file diff --git a/docs/libnm-glib/html/NMActiveConnection.html b/docs/libnm-glib/html/NMActiveConnection.html index 961428e2..d5f1b381 100644 --- a/docs/libnm-glib/html/NMActiveConnection.html +++ b/docs/libnm-glib/html/NMActiveConnection.html @@ -2,36 +2,28 @@ -NMActiveConnection +libnm-glib Reference Manual: NMActiveConnection - + - - - - - - - - - - + + + + + + +
@@ -39,83 +31,315 @@

NMActiveConnection

NMActiveConnection

- +
-
-

Synopsis

-
#define             NM_ACTIVE_CONNECTION_CONNECTION
-#define             NM_ACTIVE_CONNECTION_ID
-#define             NM_ACTIVE_CONNECTION_UUID
-#define             NM_ACTIVE_CONNECTION_TYPE
-#define             NM_ACTIVE_CONNECTION_SPECIFIC_OBJECT
-#define             NM_ACTIVE_CONNECTION_DEVICES
-#define             NM_ACTIVE_CONNECTION_STATE
-#define             NM_ACTIVE_CONNECTION_DEFAULT
-#define             NM_ACTIVE_CONNECTION_IP4_CONFIG
-#define             NM_ACTIVE_CONNECTION_DHCP4_CONFIG
-#define             NM_ACTIVE_CONNECTION_DEFAULT6
-#define             NM_ACTIVE_CONNECTION_IP6_CONFIG
-#define             NM_ACTIVE_CONNECTION_DHCP6_CONFIG
-#define             NM_ACTIVE_CONNECTION_VPN
-#define             NM_ACTIVE_CONNECTION_MASTER
-                    NMActiveConnection;
-                    NMActiveConnectionClass;
-GObject *           nm_active_connection_new            (DBusGConnection *connection,
-                                                         const char *path);
-const char *        nm_active_connection_get_connection (NMActiveConnection *connection);
-const char *        nm_active_connection_get_id         (NMActiveConnection *connection);
-const char *        nm_active_connection_get_uuid       (NMActiveConnection *connection);
-const char *        nm_active_connection_get_connection_type
-                                                        (NMActiveConnection *connection);
-const char *        nm_active_connection_get_specific_object
-                                                        (NMActiveConnection *connection);
-const GPtrArray *   nm_active_connection_get_devices    (NMActiveConnection *connection);
-NMActiveConnectionState nm_active_connection_get_state  (NMActiveConnection *connection);
-const char *        nm_active_connection_get_master     (NMActiveConnection *connection);
-gboolean            nm_active_connection_get_default    (NMActiveConnection *connection);
-NMIP4Config *       nm_active_connection_get_ip4_config (NMActiveConnection *connection);
-NMDHCP4Config *     nm_active_connection_get_dhcp4_config
-                                                        (NMActiveConnection *connection);
-gboolean            nm_active_connection_get_default6   (NMActiveConnection *connection);
-NMIP6Config *       nm_active_connection_get_ip6_config (NMActiveConnection *connection);
-NMDHCP6Config *     nm_active_connection_get_dhcp6_config
-                                                        (NMActiveConnection *connection);
-gboolean            nm_active_connection_get_vpn        (NMActiveConnection *connection);
-
+
+

Functions

+
++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+GObject * + +nm_active_connection_new () +
const char * + +nm_active_connection_get_connection () +
const char * + +nm_active_connection_get_id () +
const char * + +nm_active_connection_get_uuid () +
const char * + +nm_active_connection_get_connection_type () +
const char * + +nm_active_connection_get_specific_object () +
const GPtrArray * + +nm_active_connection_get_devices () +
+NMActiveConnectionState + +nm_active_connection_get_state () +
const char * + +nm_active_connection_get_master () +
+gboolean + +nm_active_connection_get_default () +
+NMIP4Config * + +nm_active_connection_get_ip4_config () +
+NMDHCP4Config * + +nm_active_connection_get_dhcp4_config () +
+gboolean + +nm_active_connection_get_default6 () +
+NMIP6Config * + +nm_active_connection_get_ip6_config () +
+NMDHCP6Config * + +nm_active_connection_get_dhcp6_config () +
+gboolean + +nm_active_connection_get_vpn () +
-

Object Hierarchy

-
-  GObject
-   +----NMObject
-         +----NMActiveConnection
-               +----NMVPNConnection
-
+

Properties

+
+++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+gchar *connectionRead
gbooleandefaultRead
gbooleandefault6Read
+NMObjectArray *devicesRead
+NMDHCP4Config *dhcp4-configRead
+NMDHCP6Config *dhcp6-configRead
+gchar *idRead
+NMIP4Config *ip4-configRead
+NMIP6Config *ip6-configRead
+gchar *masterRead
+gchar *specific-objectRead
guintstateRead
+gchar *typeRead
+gchar *uuidRead
gbooleanvpnRead
-

Implemented Interfaces

-

-NMActiveConnection implements - GInitable and GAsyncInitable.

+

Types and Values

+
-

Properties

-
-  "connection"               gchar*                : Read
-  "default"                  gboolean              : Read
-  "default6"                 gboolean              : Read
-  "devices"                  NMObjectArray*        : Read
-  "dhcp4-config"             NMDHCP4Config*        : Read
-  "dhcp6-config"             NMDHCP6Config*        : Read
-  "id"                       gchar*                : Read
-  "ip4-config"               NMIP4Config*          : Read
-  "ip6-config"               NMIP6Config*          : Read
-  "master"                   gchar*                : Read
-  "specific-object"          gchar*                : Read
-  "state"                    guint                 : Read
-  "type"                     gchar*                : Read
-  "uuid"                     gchar*                : Read
-  "vpn"                      gboolean              : Read
+

Object Hierarchy

+
    GObject
+    ╰── NMObject
+        ╰── NMActiveConnection
+            ╰── NMVPNConnection
 
@@ -124,733 +348,721 @@ NMActiveConnection implements

-

Details

+

Functions

-

NM_ACTIVE_CONNECTION_CONNECTION

-
#define NM_ACTIVE_CONNECTION_CONNECTION          "connection"
-
-

-

+

nm_active_connection_new ()

+
GObject *
+nm_active_connection_new (DBusGConnection *connection,
+                          const char *path);
+

Creates a new NMActiveConnection.

+
+

Parameters

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

connection

the DBusGConnection

 

path

the DBus object path of the device

 
-
-
-

NM_ACTIVE_CONNECTION_ID

-
#define NM_ACTIVE_CONNECTION_ID                  "id"
-
-

-

+
+

Returns

+

a new active connection.

+

[transfer full]

-
-
-

NM_ACTIVE_CONNECTION_UUID

-
#define NM_ACTIVE_CONNECTION_UUID                "uuid"
-
-

-


-

NM_ACTIVE_CONNECTION_TYPE

-
#define NM_ACTIVE_CONNECTION_TYPE                "type"
-
-

-

+

nm_active_connection_get_connection ()

+
const char *
+nm_active_connection_get_connection (NMActiveConnection *connection);
+

Gets the NMConnection's DBus object path. This is often used with +nm_remote_settings_get_connection_by_path() to retrieve the +NMRemoteConnection object that describes the connection.

+
+

Parameters

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

connection

a NMActiveConnection

 
+
+
+

Returns

+

the object path of the NMConnection which this NMActiveConnection +is an active instance of. This is the internal string used by the +connection, and must not be modified.

+

+

-

NM_ACTIVE_CONNECTION_SPECIFIC_OBJECT

-
#define NM_ACTIVE_CONNECTION_SPECIFIC_OBJECT     "specific-object"
-
-

-

+

nm_active_connection_get_id ()

+
const char *
+nm_active_connection_get_id (NMActiveConnection *connection);
+

Gets the NMConnection's ID.

+
+

Parameters

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

connection

a NMActiveConnection

 
+
+
+

Returns

+

the ID of the NMConnection that backs the NMActiveConnection. +This is the internal string used by the connection, and must not be modified.

+

+
+

Since 0.9.10


-

NM_ACTIVE_CONNECTION_DEVICES

-
#define NM_ACTIVE_CONNECTION_DEVICES             "devices"
-
-

-

+

nm_active_connection_get_uuid ()

+
const char *
+nm_active_connection_get_uuid (NMActiveConnection *connection);
+

Gets the NMConnection's UUID.

+
+

Parameters

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

connection

a NMActiveConnection

 
+
+
+

Returns

+

the UUID of the NMConnection that backs the NMActiveConnection. +This is the internal string used by the connection, and must not be modified.

+

+

-

NM_ACTIVE_CONNECTION_STATE

-
#define NM_ACTIVE_CONNECTION_STATE               "state"
-
-

-

+

nm_active_connection_get_connection_type ()

+
const char *
+nm_active_connection_get_connection_type
+                               (NMActiveConnection *connection);
+

Gets the NMConnection's type.

+
+

Parameters

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

connection

a NMActiveConnection

 
+
+
+

Returns

+

the type of the NMConnection that backs the NMActiveConnection. +This is the internal string used by the connection, and must not be modified.

+

+
+

Since 0.9.10


-

NM_ACTIVE_CONNECTION_DEFAULT

-
#define NM_ACTIVE_CONNECTION_DEFAULT             "default"
-
-

-

+

nm_active_connection_get_specific_object ()

+
const char *
+nm_active_connection_get_specific_object
+                               (NMActiveConnection *connection);
+

Gets the "specific object" used at the activation.

+
+

Parameters

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

connection

a NMActiveConnection

 
+
+
+

Returns

+

the specific object's DBus path. This is the internal string used by the +connection, and must not be modified.

+

+

-

NM_ACTIVE_CONNECTION_IP4_CONFIG

-
#define NM_ACTIVE_CONNECTION_IP4_CONFIG          "ip4-config"
-
-

-

+

nm_active_connection_get_devices ()

+
const GPtrArray *
+nm_active_connection_get_devices (NMActiveConnection *connection);
+

Gets the NMDevices used for the active connections.

+
+

Parameters

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

connection

a NMActiveConnection

 
+
+
+

Returns

+

the GPtrArray containing NMDevices. +This is the internal copy used by the connection, and must not be modified.

+

[element-type NMDevice]

+

-

NM_ACTIVE_CONNECTION_DHCP4_CONFIG

-
#define NM_ACTIVE_CONNECTION_DHCP4_CONFIG        "dhcp4-config"
-
-

-

+

nm_active_connection_get_state ()

+
NMActiveConnectionState
+nm_active_connection_get_state (NMActiveConnection *connection);
+

Gets the active connection's state.

+
+

Parameters

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

connection

a NMActiveConnection

 
+
+
+

Returns

+

the state

+

+

-

NM_ACTIVE_CONNECTION_DEFAULT6

-
#define NM_ACTIVE_CONNECTION_DEFAULT6            "default6"
-
-

-

+

nm_active_connection_get_master ()

+
const char *
+nm_active_connection_get_master (NMActiveConnection *connection);
+

Gets the path to the master NMDevice of the connection.

+
+

Parameters

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

connection

a NMActiveConnection

 
+
+
+

Returns

+

the path of the master NMDevice of the NMActiveConnection. +This is the internal string used by the connection, and must not be modified.

+

+

-

NM_ACTIVE_CONNECTION_IP6_CONFIG

-
#define NM_ACTIVE_CONNECTION_IP6_CONFIG          "ip6-config"
-
-

-

+

nm_active_connection_get_default ()

+
gboolean
+nm_active_connection_get_default (NMActiveConnection *connection);
+

Whether the active connection is the default IPv4 one (that is, is used for +the default IPv4 route and DNS information).

+
+

Parameters

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

connection

a NMActiveConnection

 
+
+
+

Returns

+

TRUE if the active connection is the default IPv4 connection

+

+

-

NM_ACTIVE_CONNECTION_DHCP6_CONFIG

-
#define NM_ACTIVE_CONNECTION_DHCP6_CONFIG        "dhcp6-config"
-
-

-

+

nm_active_connection_get_ip4_config ()

+
NMIP4Config *
+nm_active_connection_get_ip4_config (NMActiveConnection *connection);
+

Gets the current NMIP4Config associated with the NMActiveConnection.

+
+

Parameters

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

connection

an NMActiveConnection

 
+
+
+

Returns

+

the NMIP4Config, or NULL if the +connection is not in the NM_ACTIVE_CONNECTION_STATE_ACTIVATED +state.

+

[transfer none]

+
+

Since 0.9.10


-

NM_ACTIVE_CONNECTION_VPN

-
#define NM_ACTIVE_CONNECTION_VPN                 "vpn"
-
-

-

+

nm_active_connection_get_dhcp4_config ()

+
NMDHCP4Config *
+nm_active_connection_get_dhcp4_config (NMActiveConnection *connection);
+

Gets the current NMDHCP4Config (if any) associated with the +NMActiveConnection.

+
+

Parameters

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

connection

an NMActiveConnection

 
+
+
+

Returns

+

the NMDHCP4Config, or NULL if the +connection does not use DHCP, or is not in the +NM_ACTIVE_CONNECTION_STATE_ACTIVATED state.

+

[transfer none]

+
+

Since 0.9.10


-

NM_ACTIVE_CONNECTION_MASTER

-
#define NM_ACTIVE_CONNECTION_MASTER              "master"
-
-

-

+

nm_active_connection_get_default6 ()

+
gboolean
+nm_active_connection_get_default6 (NMActiveConnection *connection);
+

Whether the active connection is the default IPv6 one (that is, is used for +the default IPv6 route and DNS information).

+
+

Parameters

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

connection

a NMActiveConnection

 
+
+
+

Returns

+

TRUE if the active connection is the default IPv6 connection

+

+

-

NMActiveConnection

-
typedef struct _NMActiveConnection NMActiveConnection;
-

-

+

nm_active_connection_get_ip6_config ()

+
NMIP6Config *
+nm_active_connection_get_ip6_config (NMActiveConnection *connection);
+

Gets the current NMIP6Config associated with the NMActiveConnection.

+
+

Parameters

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

connection

an NMActiveConnection

 
+
+
+

Returns

+

the NMIP6Config, or NULL if the +connection is not in the NM_ACTIVE_CONNECTION_STATE_ACTIVATED +state.

+

[transfer none]

+
+

Since 0.9.10


-

NMActiveConnectionClass

-
typedef struct {
-	NMObjectClass parent;
-
-	/* Padding for future expansion */
-	void (*_reserved1) (void);
-	void (*_reserved2) (void);
-	void (*_reserved3) (void);
-	void (*_reserved4) (void);
-	void (*_reserved5) (void);
-	void (*_reserved6) (void);
-} NMActiveConnectionClass;
-
-

-

+

nm_active_connection_get_dhcp6_config ()

+
NMDHCP6Config *
+nm_active_connection_get_dhcp6_config (NMActiveConnection *connection);
+

Gets the current NMDHCP6Config (if any) associated with the +NMActiveConnection.

+
+

Parameters

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

connection

an NMActiveConnection

 
+
+
+

Returns

+

the NMDHCP6Config, or NULL if the +connection does not use DHCPv6, or is not in the +NM_ACTIVE_CONNECTION_STATE_ACTIVATED state.

+

[transfer none]

+
+

Since 0.9.10


-

nm_active_connection_new ()

-
GObject *           nm_active_connection_new            (DBusGConnection *connection,
-                                                         const char *path);
-

-Creates a new NMActiveConnection. -

-
+

nm_active_connection_get_vpn ()

+
gboolean
+nm_active_connection_get_vpn (NMActiveConnection *connection);
+

Whether the active connection is a VPN connection.

+
+

Parameters

+
--+++ - - - - - - - - - - - - - - + + + + +

connection :

the DBusGConnection -

path :

the DBus object path of the device

Returns :

a new active connection. [transfer full] -

connection

a NMActiveConnection

 
-
+
+

Returns

+

TRUE if the active connection is a VPN connection

+

+
+

Since 0.9.10

+
+
+
+

Types and Values

-

nm_active_connection_get_connection ()

-
const char *        nm_active_connection_get_connection (NMActiveConnection *connection);
+

NM_ACTIVE_CONNECTION_CONNECTION

+
#define NM_ACTIVE_CONNECTION_CONNECTION          "connection"
+

-Gets the NMConnection's DBus object path. This is often used with -nm_remote_settings_get_connection_by_path() to retrieve the -NMRemoteConnection object that describes the connection.

-
---- - - - - - - - - - - -

connection :

a NMActiveConnection -

Returns :

the object path of the NMConnection which this NMActiveConnection -is an active instance of. This is the internal string used by the -connection, and must not be modified.

-

nm_active_connection_get_id ()

-
const char *        nm_active_connection_get_id         (NMActiveConnection *connection);
+

NM_ACTIVE_CONNECTION_ID

+
#define NM_ACTIVE_CONNECTION_ID                  "id"
+

-Gets the NMConnection's ID.

-
---- - - - - - - - - - - -

connection :

a NMActiveConnection -

Returns :

the ID of the NMConnection that backs the NMActiveConnection. -This is the internal string used by the connection, and must not be modified.
-

Since 0.9.10


-

nm_active_connection_get_uuid ()

-
const char *        nm_active_connection_get_uuid       (NMActiveConnection *connection);
+

NM_ACTIVE_CONNECTION_UUID

+
#define NM_ACTIVE_CONNECTION_UUID                "uuid"
+

-Gets the NMConnection's UUID.

-
---- - - - - - - - - - - -

connection :

a NMActiveConnection -

Returns :

the UUID of the NMConnection that backs the NMActiveConnection. -This is the internal string used by the connection, and must not be modified.

-

nm_active_connection_get_connection_type ()

-
const char *        nm_active_connection_get_connection_type
-                                                        (NMActiveConnection *connection);
+

NM_ACTIVE_CONNECTION_TYPE

+
#define NM_ACTIVE_CONNECTION_TYPE                "type"
+

-Gets the NMConnection's type.

-
---- - - - - - - - - - - -

connection :

a NMActiveConnection -

Returns :

the type of the NMConnection that backs the NMActiveConnection. -This is the internal string used by the connection, and must not be modified.
-

Since 0.9.10


-

nm_active_connection_get_specific_object ()

-
const char *        nm_active_connection_get_specific_object
-                                                        (NMActiveConnection *connection);
+

NM_ACTIVE_CONNECTION_SPECIFIC_OBJECT

+
#define NM_ACTIVE_CONNECTION_SPECIFIC_OBJECT     "specific-object"
+

-Gets the "specific object" used at the activation.

-
---- - - - - - - - - - - -

connection :

a NMActiveConnection -

Returns :

the specific object's DBus path. This is the internal string used by the -connection, and must not be modified.

-

nm_active_connection_get_devices ()

-
const GPtrArray *   nm_active_connection_get_devices    (NMActiveConnection *connection);
+

NM_ACTIVE_CONNECTION_DEVICES

+
#define NM_ACTIVE_CONNECTION_DEVICES             "devices"
+

-Gets the NMDevices used for the active connections.

-
---- - - - - - - - - - - -

connection :

a NMActiveConnection -

Returns :

the GPtrArray containing NMDevices. -This is the internal copy used by the connection, and must not be modified. [element-type NMDevice] -

-

nm_active_connection_get_state ()

-
NMActiveConnectionState nm_active_connection_get_state  (NMActiveConnection *connection);
+

NM_ACTIVE_CONNECTION_STATE

+
#define NM_ACTIVE_CONNECTION_STATE               "state"
+

-Gets the active connection's state.

-
---- - - - - - - - - - - -

connection :

a NMActiveConnection -

Returns :

the state

-

nm_active_connection_get_master ()

-
const char *        nm_active_connection_get_master     (NMActiveConnection *connection);
+

NM_ACTIVE_CONNECTION_DEFAULT

+
#define NM_ACTIVE_CONNECTION_DEFAULT             "default"
+

-Gets the path to the master NMDevice of the connection.

-
---- - - - - - - - - - - -

connection :

a NMActiveConnection -

Returns :

the path of the master NMDevice of the NMActiveConnection. -This is the internal string used by the connection, and must not be modified.

-

nm_active_connection_get_default ()

-
gboolean            nm_active_connection_get_default    (NMActiveConnection *connection);
+

NM_ACTIVE_CONNECTION_IP4_CONFIG

+
#define NM_ACTIVE_CONNECTION_IP4_CONFIG          "ip4-config"
+

-Whether the active connection is the default IPv4 one (that is, is used for -the default IPv4 route and DNS information).

-
---- - - - - - - - - - - -

connection :

a NMActiveConnection -

Returns :

-TRUE if the active connection is the default IPv4 connection

-

nm_active_connection_get_ip4_config ()

-
NMIP4Config *       nm_active_connection_get_ip4_config (NMActiveConnection *connection);
+

NM_ACTIVE_CONNECTION_DHCP4_CONFIG

+
#define NM_ACTIVE_CONNECTION_DHCP4_CONFIG        "dhcp4-config"
+

-Gets the current NMIP4Config associated with the NMActiveConnection.

-
---- - - - - - - - - - - -

connection :

an NMActiveConnection -

Returns :

the NMIP4Config, or NULL if the -connection is not in the NM_ACTIVE_CONNECTION_STATE_ACTIVATED -state. [transfer none] -
-

Since 0.9.10


-

nm_active_connection_get_dhcp4_config ()

-
NMDHCP4Config *     nm_active_connection_get_dhcp4_config
-                                                        (NMActiveConnection *connection);
+

NM_ACTIVE_CONNECTION_DEFAULT6

+
#define NM_ACTIVE_CONNECTION_DEFAULT6            "default6"
+

-Gets the current NMDHCP4Config (if any) associated with the -NMActiveConnection.

-
---- - - - - - - - - - - -

connection :

an NMActiveConnection -

Returns :

the NMDHCP4Config, or NULL if the -connection does not use DHCP, or is not in the -NM_ACTIVE_CONNECTION_STATE_ACTIVATED state. [transfer none] -
-

Since 0.9.10


-

nm_active_connection_get_default6 ()

-
gboolean            nm_active_connection_get_default6   (NMActiveConnection *connection);
+

NM_ACTIVE_CONNECTION_IP6_CONFIG

+
#define NM_ACTIVE_CONNECTION_IP6_CONFIG          "ip6-config"
+

-Whether the active connection is the default IPv6 one (that is, is used for -the default IPv6 route and DNS information).

-
---- - - - - - - - - - - -

connection :

a NMActiveConnection -

Returns :

-TRUE if the active connection is the default IPv6 connection

-

nm_active_connection_get_ip6_config ()

-
NMIP6Config *       nm_active_connection_get_ip6_config (NMActiveConnection *connection);
+

NM_ACTIVE_CONNECTION_DHCP6_CONFIG

+
#define NM_ACTIVE_CONNECTION_DHCP6_CONFIG        "dhcp6-config"
+

-Gets the current NMIP6Config associated with the NMActiveConnection.

-
---- - - - - - - - - - - -

connection :

an NMActiveConnection -

Returns :

the NMIP6Config, or NULL if the -connection is not in the NM_ACTIVE_CONNECTION_STATE_ACTIVATED -state. [transfer none] -
-

Since 0.9.10


-

nm_active_connection_get_dhcp6_config ()

-
NMDHCP6Config *     nm_active_connection_get_dhcp6_config
-                                                        (NMActiveConnection *connection);
+

NM_ACTIVE_CONNECTION_VPN

+
#define NM_ACTIVE_CONNECTION_VPN                 "vpn"
+

-Gets the current NMDHCP6Config (if any) associated with the -NMActiveConnection.

-
---- - - - - - - - - - - -

connection :

an NMActiveConnection -

Returns :

the NMDHCP6Config, or NULL if the -connection does not use DHCPv6, or is not in the -NM_ACTIVE_CONNECTION_STATE_ACTIVATED state. [transfer none] -
-

Since 0.9.10


-

nm_active_connection_get_vpn ()

-
gboolean            nm_active_connection_get_vpn        (NMActiveConnection *connection);
+

NM_ACTIVE_CONNECTION_MASTER

+
#define NM_ACTIVE_CONNECTION_MASTER              "master"
+

-Whether the active connection is a VPN connection.

-
---- - - - - - - - - - - -

connection :

a NMActiveConnection -

Returns :

-TRUE if the active connection is a VPN connection
-

Since 0.9.10

Property Details

-

The "connection" property

-
  "connection"               gchar*                : Read
-

-The connection's path of the active connection. -

+

The “connection” property

+
  “connection”               gchar *
+

+

Flags: Read

Default value: NULL


-

The "default" property

-
  "default"                  gboolean              : Read
-

-Whether the active connection is the default IPv4 one. -

+

The “default” property

+
  “default”                  gboolean
+

+

Flags: Read

Default value: FALSE


-

The "default6" property

-
  "default6"                 gboolean              : Read
-

-Whether the active connection is the default IPv6 one. -

+

The “default6” property

+
  “default6”                 gboolean
+

+

Flags: Read

Default value: FALSE


-

The "devices" property

-
  "devices"                  NMObjectArray*        : Read
+

The “devices” property

+
  “devices”                  NMObjectArray *

+

Flags: Read


-

The "dhcp4-config" property

-
  "dhcp4-config"             NMDHCP4Config*        : Read
-

-The NMDHCP4Config of the connection. -

+

The “dhcp4-config” property

+
  “dhcp4-config”             NMDHCP4Config *
+

+

Flags: Read

Since 0.9.10


-

The "dhcp6-config" property

-
  "dhcp6-config"             NMDHCP6Config*        : Read
-

-The NMDHCP6Config of the connection. -

+

The “dhcp6-config” property

+
  “dhcp6-config”             NMDHCP6Config *
+

+

Flags: Read

Since 0.9.10


-

The "id" property

-
  "id"                       gchar*                : Read
-

-The active connection's ID -

+

The “id” property

+
  “id”                       gchar *
+

+

Flags: Read

Default value: NULL

Since 0.9.10


-

The "ip4-config" property

-
  "ip4-config"               NMIP4Config*          : Read
-

-The NMIP4Config of the connection. -

+

The “ip4-config” property

+
  “ip4-config”               NMIP4Config *
+

+

Flags: Read

Since 0.9.10


-

The "ip6-config" property

-
  "ip6-config"               NMIP6Config*          : Read
-

-The NMIP6Config of the connection. -

+

The “ip6-config” property

+
  “ip6-config”               NMIP6Config *
+

+

Flags: Read

Since 0.9.10


-

The "master" property

-
  "master"                   gchar*                : Read
-

-The path of the master device if one exists. -

+

The “master” property

+
  “master”                   gchar *
+

+

Flags: Read

Default value: NULL


-

The "specific-object" property

-
  "specific-object"          gchar*                : Read
-

-The specific object's path of the active connection. -

+

The “specific-object” property

+
  “specific-object”          gchar *
+

+

Flags: Read

Default value: NULL


-

The "state" property

-
  "state"                    guint                 : Read
-

-The state of the active connection. -

+

The “state” property

+
  “state”                    guint
+

+

Flags: Read

Allowed values: <= 3

Default value: 0


-

The "type" property

-
  "type"                     gchar*                : Read
-

-The active connection's type -

+

The “type” property

+
  “type”                     gchar *
+

+

Flags: Read

Default value: NULL

Since 0.9.10


-

The "uuid" property

-
  "uuid"                     gchar*                : Read
-

-The active connection's UUID -

+

The “uuid” property

+
  “uuid”                     gchar *
+

+

Flags: Read

Default value: NULL


-

The "vpn" property

-
  "vpn"                      gboolean              : Read
-

-Whether the active connection is a VPN connection. -

+

The “vpn” property

+
  “vpn”                      gboolean
+

+

Flags: Read

Default value: FALSE

Since 0.9.10

@@ -858,6 +1070,6 @@ Whether the active connection is a VPN connection.
+ Generated by GTK-Doc V1.21
\ No newline at end of file diff --git a/docs/libnm-glib/html/NMClient.html b/docs/libnm-glib/html/NMClient.html index b28d9ed5..23eca511 100644 --- a/docs/libnm-glib/html/NMClient.html +++ b/docs/libnm-glib/html/NMClient.html @@ -2,38 +2,29 @@ -NMClient +libnm-glib Reference Manual: NMClient - + - - - - - - - - - - + + + + + + +
@@ -41,160 +32,540 @@

NMClient

NMClient

- +
-
-

Synopsis

-
#define             NM_CLIENT_VERSION
-#define             NM_CLIENT_STATE
-#define             NM_CLIENT_STARTUP
-#define             NM_CLIENT_MANAGER_RUNNING
-#define             NM_CLIENT_NETWORKING_ENABLED
-#define             NM_CLIENT_WIRELESS_ENABLED
-#define             NM_CLIENT_WIRELESS_HARDWARE_ENABLED
-#define             NM_CLIENT_WWAN_ENABLED
-#define             NM_CLIENT_WWAN_HARDWARE_ENABLED
-#define             NM_CLIENT_WIMAX_ENABLED
-#define             NM_CLIENT_WIMAX_HARDWARE_ENABLED
-#define             NM_CLIENT_ACTIVE_CONNECTIONS
-#define             NM_CLIENT_CONNECTIVITY
-#define             NM_CLIENT_PRIMARY_CONNECTION
-#define             NM_CLIENT_ACTIVATING_CONNECTION
-#define             NM_CLIENT_DEVICES
-enum                NMClientPermission;
-enum                NMClientPermissionResult;
-enum                NMClientError;
-#define             NM_CLIENT_ERROR
-GQuark              nm_client_error_quark               (void);
-                    NMClient;
-                    NMClientClass;
-NMClient *          nm_client_new                       (void);
-void                nm_client_new_async                 (GCancellable *cancellable,
-                                                         GAsyncReadyCallback callback,
-                                                         gpointer user_data);
-NMClient *          nm_client_new_finish                (GAsyncResult *result,
-                                                         GError **error);
-const GPtrArray *   nm_client_get_devices               (NMClient *client);
-NMDevice *          nm_client_get_device_by_path        (NMClient *client,
-                                                         const char *object_path);
-NMDevice *          nm_client_get_device_by_iface       (NMClient *client,
-                                                         const char *iface);
-void                (*NMClientActivateFn)               (NMClient *client,
-                                                         NMActiveConnection *active_connection,
-                                                         GError *error,
-                                                         gpointer user_data);
-void                nm_client_activate_connection       (NMClient *client,
-                                                         NMConnection *connection,
-                                                         NMDevice *device,
-                                                         const char *specific_object,
-                                                         NMClientActivateFn callback,
-                                                         gpointer user_data);
-void                (*NMClientAddActivateFn)            (NMClient *client,
-                                                         NMActiveConnection *connection,
-                                                         const char *new_connection_path,
-                                                         GError *error,
-                                                         gpointer user_data);
-void                nm_client_add_and_activate_connection
-                                                        (NMClient *client,
-                                                         NMConnection *partial,
-                                                         NMDevice *device,
-                                                         const char *specific_object,
-                                                         NMClientAddActivateFn callback,
-                                                         gpointer user_data);
-void                nm_client_deactivate_connection     (NMClient *client,
-                                                         NMActiveConnection *active);
-gboolean            nm_client_networking_get_enabled    (NMClient *client);
-void                nm_client_networking_set_enabled    (NMClient *client,
-                                                         gboolean enabled);
-gboolean            nm_client_wireless_get_enabled      (NMClient *client);
-void                nm_client_wireless_set_enabled      (NMClient *client,
-                                                         gboolean enabled);
-gboolean            nm_client_wireless_hardware_get_enabled
-                                                        (NMClient *client);
-gboolean            nm_client_wwan_get_enabled          (NMClient *client);
-void                nm_client_wwan_set_enabled          (NMClient *client,
-                                                         gboolean enabled);
-gboolean            nm_client_wwan_hardware_get_enabled (NMClient *client);
-gboolean            nm_client_wimax_get_enabled         (NMClient *client);
-void                nm_client_wimax_set_enabled         (NMClient *client,
-                                                         gboolean enabled);
-gboolean            nm_client_wimax_hardware_get_enabled
-                                                        (NMClient *client);
-const char *        nm_client_get_version               (NMClient *client);
-NMState             nm_client_get_state                 (NMClient *client);
-gboolean            nm_client_get_startup               (NMClient *client);
-gboolean            nm_client_get_manager_running       (NMClient *client);
-const GPtrArray *   nm_client_get_active_connections    (NMClient *client);
-void                nm_client_sleep                     (NMClient *client,
-                                                         gboolean sleep_);
-NMClientPermissionResult nm_client_get_permission_result
-                                                        (NMClient *client,
-                                                         NMClientPermission permission);
-gboolean            nm_client_get_logging               (NMClient *client,
-                                                         char **level,
-                                                         char **domains,
-                                                         GError **error);
-gboolean            nm_client_set_logging               (NMClient *client,
-                                                         const char *level,
-                                                         const char *domains,
-                                                         GError **error);
-NMConnectivityState nm_client_get_connectivity          (NMClient *client);
-NMConnectivityState nm_client_check_connectivity        (NMClient *client,
-                                                         GCancellable *cancellable,
-                                                         GError **error);
-void                nm_client_check_connectivity_async  (NMClient *client,
-                                                         GCancellable *cancellable,
-                                                         GAsyncReadyCallback callback,
-                                                         gpointer user_data);
-NMConnectivityState nm_client_check_connectivity_finish (NMClient *client,
-                                                         GAsyncResult *result,
-                                                         GError **error);
-NMActiveConnection * nm_client_get_primary_connection   (NMClient *client);
-NMActiveConnection * nm_client_get_activating_connection
-                                                        (NMClient *client);
-
+
+

Functions

+
++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+GQuark + +nm_client_error_quark () +
+NMClient * + +nm_client_new () +
+void + +nm_client_new_async () +
+NMClient * + +nm_client_new_finish () +
const GPtrArray * + +nm_client_get_devices () +
+NMDevice * + +nm_client_get_device_by_path () +
+NMDevice * + +nm_client_get_device_by_iface () +
+void + +(*NMClientActivateFn) () +
+void + +nm_client_activate_connection () +
+void + +(*NMClientAddActivateFn) () +
+void + +nm_client_add_and_activate_connection () +
+void + +nm_client_deactivate_connection () +
+gboolean + +nm_client_networking_get_enabled () +
+void + +nm_client_networking_set_enabled () +
+gboolean + +nm_client_wireless_get_enabled () +
+void + +nm_client_wireless_set_enabled () +
+gboolean + +nm_client_wireless_hardware_get_enabled () +
+gboolean + +nm_client_wwan_get_enabled () +
+void + +nm_client_wwan_set_enabled () +
+gboolean + +nm_client_wwan_hardware_get_enabled () +
+gboolean + +nm_client_wimax_get_enabled () +
+void + +nm_client_wimax_set_enabled () +
+gboolean + +nm_client_wimax_hardware_get_enabled () +
const char * + +nm_client_get_version () +
+NMState + +nm_client_get_state () +
+gboolean + +nm_client_get_startup () +
+gboolean + +nm_client_get_manager_running () +
const GPtrArray * + +nm_client_get_active_connections () +
+void + +nm_client_sleep () +
+NMClientPermissionResult + +nm_client_get_permission_result () +
+gboolean + +nm_client_get_logging () +
+gboolean + +nm_client_set_logging () +
+NMConnectivityState + +nm_client_get_connectivity () +
+NMConnectivityState + +nm_client_check_connectivity () +
+void + +nm_client_check_connectivity_async () +
+NMConnectivityState + +nm_client_check_connectivity_finish () +
+NMActiveConnection * + +nm_client_get_primary_connection () +
+NMActiveConnection * + +nm_client_get_activating_connection () +
-

Object Hierarchy

-
-  GObject
-   +----NMObject
-         +----NMClient
-
+

Properties

+
+++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+NMActiveConnection *activating-connectionRead
+NMObjectArray *active-connectionsRead
guintconnectivityRead
+NMObjectArray *devicesRead
gbooleanmanager-runningRead
gbooleannetworking-enabledRead / Write
+NMActiveConnection *primary-connectionRead
gbooleanstartupRead
guintstateRead
+gchar *versionRead
gbooleanwimax-enabledRead / Write
gbooleanwimax-hardware-enabledRead
gbooleanwireless-enabledRead / Write
gbooleanwireless-hardware-enabledRead
gbooleanwwan-enabledRead / Write
gbooleanwwan-hardware-enabledRead
-

Implemented Interfaces

-

-NMClient implements - GInitable and GAsyncInitable.

+

Signals

+
+++++ + + + + + + + + + + + + + + + + + +
voiddevice-addedRun First
voiddevice-removedRun First
voidpermission-changedRun First
-

Properties

-
-  "activating-connection"    NMActiveConnection*   : Read
-  "active-connections"       NMObjectArray*        : Read
-  "connectivity"             guint                 : Read
-  "devices"                  NMObjectArray*        : Read
-  "manager-running"          gboolean              : Read
-  "networking-enabled"       gboolean              : Read / Write
-  "primary-connection"       NMActiveConnection*   : Read
-  "startup"                  gboolean              : Read
-  "state"                    guint                 : Read
-  "version"                  gchar*                : Read
-  "wimax-enabled"            gboolean              : Read / Write
-  "wimax-hardware-enabled"   gboolean              : Read
-  "wireless-enabled"         gboolean              : Read / Write
-  "wireless-hardware-enabled" gboolean              : Read
-  "wwan-enabled"             gboolean              : Read / Write
-  "wwan-hardware-enabled"    gboolean              : Read
-
+

Types and Values

+
-

Signals

-
-  "device-added"                                   : Run First
-  "device-removed"                                 : Run First
-  "permission-changed"                             : Run First
+

Object Hierarchy

+
    GObject
+    ╰── NMObject
+        ╰── NMClient
 
@@ -203,1819 +574,1778 @@ NMClient implements

-

Details

+

Functions

-

NM_CLIENT_VERSION

-
#define NM_CLIENT_VERSION "version"
-
-

-

+

nm_client_error_quark ()

+
GQuark
+nm_client_error_quark (void);
+

Registers an error quark for NMClient if necessary.

+
+

Returns

+

the error quark used for NMClient errors.

+

-
-
-

NM_CLIENT_STATE

-
#define NM_CLIENT_STATE "state"
-
-

-

+

Since 0.9.10


-

NM_CLIENT_STARTUP

-
#define NM_CLIENT_STARTUP "startup"
-
-

-

+

nm_client_new ()

+
NMClient *
+nm_client_new (void);
+

Creates a new NMClient.

+

Note that this will do blocking D-Bus calls to initialize the +client. You can use nm_client_new_async() if you want to avoid +that.

+

NOTE: NMClient provides information about devices and a mechanism to +control them. To access and modify network configuration data, use the +NMRemoteSettings object.

+
+

Returns

+

a new NMClient or NULL on an error

+

+
+
+
+
+

nm_client_new_async ()

+
void
+nm_client_new_async (GCancellable *cancellable,
+                     GAsyncReadyCallback callback,
+                     gpointer user_data);
+

Creates a new NMClient and begins asynchronously initializing it. +callback + will be called when it is done; use +nm_client_new_finish() to get the result. Note that on an error, +the callback can be invoked with two first parameters as NULL.

+

NOTE: NMClient provides information about devices and a mechanism to +control them. To access and modify network configuration data, use the +NMRemoteSettings object.

+
+

Parameters

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

cancellable

a GCancellable, or NULL

 

callback

callback to call when the client is created

 

user_data

data for callback +

 
-
-
-

NM_CLIENT_MANAGER_RUNNING

-
#define NM_CLIENT_MANAGER_RUNNING "manager-running"
-
-

-


-

NM_CLIENT_NETWORKING_ENABLED

-
#define NM_CLIENT_NETWORKING_ENABLED "networking-enabled"
-
-

-

+

nm_client_new_finish ()

+
NMClient *
+nm_client_new_finish (GAsyncResult *result,
+                      GError **error);
+

Gets the result of an nm_client_new_async() call.

+
+

Parameters

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

result

a GAsyncResult

 

error

location for a GError, or NULL

 
-
-
-

NM_CLIENT_WIRELESS_ENABLED

-
#define NM_CLIENT_WIRELESS_ENABLED "wireless-enabled"
-
-

-

+
+

Returns

+

a new NMClient, or NULL on error

+

-
-
-

NM_CLIENT_WIRELESS_HARDWARE_ENABLED

-
#define NM_CLIENT_WIRELESS_HARDWARE_ENABLED "wireless-hardware-enabled"
-
-

-


-

NM_CLIENT_WWAN_ENABLED

-
#define NM_CLIENT_WWAN_ENABLED "wwan-enabled"
-
-

-

+

nm_client_get_devices ()

+
const GPtrArray *
+nm_client_get_devices (NMClient *client);
+

Gets all the known network devices. Use nm_device_get_type() or the +NM_IS_DEVICE_XXXX functions to determine what kind of +device member of the returned array is, and then you may use device-specific +methods such as nm_device_ethernet_get_hw_address().

+
+

Parameters

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

client

a NMClient

 
-
-
-

NM_CLIENT_WWAN_HARDWARE_ENABLED

-
#define NM_CLIENT_WWAN_HARDWARE_ENABLED "wwan-hardware-enabled"
-
-

-

+
+

Returns

+

a GPtrArray +containing all the NMDevices. The returned array is owned by the +NMClient object and should not be modified.

+

[transfer none][element-type NMDevice]

-
-
-

NM_CLIENT_WIMAX_ENABLED

-
#define NM_CLIENT_WIMAX_ENABLED "wimax-enabled"
-
-

-


-

NM_CLIENT_WIMAX_HARDWARE_ENABLED

-
#define NM_CLIENT_WIMAX_HARDWARE_ENABLED "wimax-hardware-enabled"
-
-

-

+

nm_client_get_device_by_path ()

+
NMDevice *
+nm_client_get_device_by_path (NMClient *client,
+                              const char *object_path);
+

Gets a NMDevice from a NMClient.

+
+

Parameters

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

client

a NMClient

 

object_path

the object path to search for

 
-
-
-

NM_CLIENT_ACTIVE_CONNECTIONS

-
#define NM_CLIENT_ACTIVE_CONNECTIONS "active-connections"
-
-

-

+
+

Returns

+

the NMDevice for the given object_path +or NULL if none is found.

+

[transfer none]

-
-
-

NM_CLIENT_CONNECTIVITY

-
#define NM_CLIENT_CONNECTIVITY "connectivity"
-
-

-


-

NM_CLIENT_PRIMARY_CONNECTION

-
#define NM_CLIENT_PRIMARY_CONNECTION "primary-connection"
-
-

-

+

nm_client_get_device_by_iface ()

+
NMDevice *
+nm_client_get_device_by_iface (NMClient *client,
+                               const char *iface);
+

Gets a NMDevice from a NMClient.

+
+

Parameters

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

client

a NMClient

 

iface

the interface name to search for

 
+
+
+

Returns

+

the NMDevice for the given iface +or NULL if none is found.

+

[transfer none]

-
-
-

NM_CLIENT_ACTIVATING_CONNECTION

-
#define NM_CLIENT_ACTIVATING_CONNECTION "activating-connection"
-
-

-


-

NM_CLIENT_DEVICES

-
#define NM_CLIENT_DEVICES "devices"
-
+

NMClientActivateFn ()

+
void
+(*NMClientActivateFn) (NMClient *client,
+                       NMActiveConnection *active_connection,
+                       GError *error,
+                       gpointer user_data);


-

enum NMClientPermission

-
typedef enum {
-	NM_CLIENT_PERMISSION_NONE = 0,
-	NM_CLIENT_PERMISSION_ENABLE_DISABLE_NETWORK = 1,
-	NM_CLIENT_PERMISSION_ENABLE_DISABLE_WIFI = 2,
-	NM_CLIENT_PERMISSION_ENABLE_DISABLE_WWAN = 3,
-	NM_CLIENT_PERMISSION_ENABLE_DISABLE_WIMAX = 4,
-	NM_CLIENT_PERMISSION_SLEEP_WAKE = 5,
-	NM_CLIENT_PERMISSION_NETWORK_CONTROL = 6,
-	NM_CLIENT_PERMISSION_WIFI_SHARE_PROTECTED = 7,
-	NM_CLIENT_PERMISSION_WIFI_SHARE_OPEN = 8,
-	NM_CLIENT_PERMISSION_SETTINGS_MODIFY_SYSTEM = 9,
-	NM_CLIENT_PERMISSION_SETTINGS_MODIFY_OWN = 10,
-	NM_CLIENT_PERMISSION_SETTINGS_MODIFY_HOSTNAME = 11,
-
-	NM_CLIENT_PERMISSION_LAST = NM_CLIENT_PERMISSION_SETTINGS_MODIFY_HOSTNAME
-} NMClientPermission;
-
-

-NMClientPermission values indicate various permissions that NetworkManager -clients can obtain to perform certain tasks on behalf of the current user. -

-
+

nm_client_activate_connection ()

+
void
+nm_client_activate_connection (NMClient *client,
+                               NMConnection *connection,
+                               NMDevice *device,
+                               const char *specific_object,
+                               NMClientActivateFn callback,
+                               gpointer user_data);
+

Starts a connection to a particular network using the configuration settings +from connection + and the network device device +. Certain connection types +also take a "specific object" which is the object path of a connection- +specific object, like an NMAccessPoint for Wi-Fi connections, or an +NMWimaxNsp 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 connection +.

+

If connection + is not given for a device-based activation, NetworkManager +picks the best available connection for the device and activates it.

+

Note that the callback is invoked when NetworkManager has started activating +the new connection, not when it finishes. You can used the returned +NMActiveConnection object (in particular, “state”) to +track the activation to its completion.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + + - - + + + - - + + + - - + + + - - + + + + +

NM_CLIENT_PERMISSION_NONE

unknown or no permission -

NM_CLIENT_PERMISSION_ENABLE_DISABLE_NETWORK

controls whether networking - can be globally enabled or disabled -

client

a NMClient

 

NM_CLIENT_PERMISSION_ENABLE_DISABLE_WIFI

controls whether Wi-Fi can be - globally enabled or disabled -

connection

an NMConnection.

[allow-none]

NM_CLIENT_PERMISSION_ENABLE_DISABLE_WWAN

controls whether WWAN (3G) can be - globally enabled or disabled -

device

the NMDevice.

[allow-none]

NM_CLIENT_PERMISSION_ENABLE_DISABLE_WIMAX

controls whether WiMAX can be - globally enabled or disabled -

specific_object

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 NULL should be used +(ie, no specific object). For Wi-Fi or WiMAX connections, pass the object +path of a NMAccessPoint or NMWimaxNsp owned by device +, which you can +get using nm_object_get_path(), and which will be used to complete the +details of the newly added connection.

[allow-none]

NM_CLIENT_PERMISSION_SLEEP_WAKE

controls whether the client can ask - NetworkManager to sleep and wake -

callback

the function to call when the call is done.

[scope async][allow-none]

NM_CLIENT_PERMISSION_NETWORK_CONTROL

controls whether networking connections - can be started, stopped, and changed -

user_data

user data to pass to the callback function.

[closure]
+
+
+
+
+

NMClientAddActivateFn ()

+
void
+(*NMClientAddActivateFn) (NMClient *client,
+                          NMActiveConnection *connection,
+                          const char *new_connection_path,
+                          GError *error,
+                          gpointer user_data);
+

+

+
+
+
+

nm_client_add_and_activate_connection ()

+
void
+nm_client_add_and_activate_connection (NMClient *client,
+                                       NMConnection *partial,
+                                       NMDevice *device,
+                                       const char *specific_object,
+                                       NMClientAddActivateFn callback,
+                                       gpointer user_data);
+

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 activated. +Cannot be used for VPN connections at this time.

+

Note that the callback is invoked when NetworkManager has started activating +the new connection, not when it finishes. You can used the returned +NMActiveConnection object (in particular, “state”) to +track the activation to its completion.

+
+

Parameters

+
+++++ + - - + + + - - + + + - - + + + - - + + + - - + + + - - + + +

NM_CLIENT_PERMISSION_WIFI_SHARE_PROTECTED

controls whether a password - protected Wi-Fi hotspot can be created -

client

a NMClient

 

NM_CLIENT_PERMISSION_WIFI_SHARE_OPEN

controls whether an open Wi-Fi hotspot - can be created -

partial

an NMConnection to add; the connection may be +partially filled (or even NULL) and will be completed by NetworkManager +using the given device +and specific_object +before being added.

[allow-none]

NM_CLIENT_PERMISSION_SETTINGS_MODIFY_SYSTEM

controls whether connections - that are available to all users can be modified -

device

the NMDevice

 

NM_CLIENT_PERMISSION_SETTINGS_MODIFY_OWN

controls whether connections - owned by the current user can be modified -

specific_object

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 NULL should be used +(ie, no specific object). For Wi-Fi or WiMAX connections, pass the object +path of a NMAccessPoint or NMWimaxNsp owned by device +, which you can +get using nm_object_get_path(), and which will be used to complete the +details of the newly added connection.

[allow-none]

NM_CLIENT_PERMISSION_SETTINGS_MODIFY_HOSTNAME

controls whether the - persistent hostname can be changed -

callback

the function to call when the call is done.

[scope async][allow-none]

NM_CLIENT_PERMISSION_LAST

a reserved boundary value -

user_data

user data to pass to the callback function.

[closure]
+

-

enum NMClientPermissionResult

-
typedef enum {
-	NM_CLIENT_PERMISSION_RESULT_UNKNOWN = 0,
-	NM_CLIENT_PERMISSION_RESULT_YES,
-	NM_CLIENT_PERMISSION_RESULT_AUTH,
-	NM_CLIENT_PERMISSION_RESULT_NO
-} NMClientPermissionResult;
-
-

-NMClientPermissionResult values indicate what authorizations and permissions -the user requires to obtain a given NMClientPermission -

-
+

nm_client_deactivate_connection ()

+
void
+nm_client_deactivate_connection (NMClient *client,
+                                 NMActiveConnection *active);
+

Deactivates an active NMActiveConnection.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + - - + + +

NM_CLIENT_PERMISSION_RESULT_UNKNOWN

unknown or no authorization -

NM_CLIENT_PERMISSION_RESULT_YES

the permission is available -

NM_CLIENT_PERMISSION_RESULT_AUTH

authorization is necessary before the - permission is available -

client

a NMClient

 

NM_CLIENT_PERMISSION_RESULT_NO

permission to perform the operation is - denied by system policy -

active

the NMActiveConnection to deactivate

 
+

-

enum NMClientError

-
typedef enum {
-	NM_CLIENT_ERROR_UNKNOWN = 0,            /*< nick=UnknownError >*/
-	NM_CLIENT_ERROR_MANAGER_NOT_RUNNING,    /*< nick=ManagerNotRunning >*/
-} NMClientError;
-
-

-Describes errors that may result from operations involving a NMClient. -

-
+

nm_client_networking_get_enabled ()

+
gboolean
+nm_client_networking_get_enabled (NMClient *client);
+

Whether networking is enabled or disabled.

+
+

Parameters

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

client

a NMClient

 
+
+
+

Returns

+

TRUE if networking is enabled, FALSE if networking is disabled

+

+
+
+
+
+

nm_client_networking_set_enabled ()

+
void
+nm_client_networking_set_enabled (NMClient *client,
+                                  gboolean enabled);
+

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.

+
+

Parameters

+
--+++ - - + + + - - + + +

NM_CLIENT_ERROR_UNKNOWN

unknown or unclassified error -

client

a NMClient

 

NM_CLIENT_ERROR_MANAGER_NOT_RUNNING

an operation that requires NetworkManager - failed because NetworkManager is not running -

enabled

TRUE to set networking enabled, FALSE to set networking disabled

 
-
-
-

NM_CLIENT_ERROR

-
#define NM_CLIENT_ERROR nm_client_error_quark ()
-
-

-


-

nm_client_error_quark ()

-
GQuark              nm_client_error_quark               (void);
-

-Registers an error quark for NMClient if necessary. -

-
+

nm_client_wireless_get_enabled ()

+
gboolean
+nm_client_wireless_get_enabled (NMClient *client);
+

Determines whether the wireless is enabled.

+
+

Parameters

+
--+++ - - + + +

Returns :

the error quark used for NMClient errors.

client

a NMClient

 
-

Since 0.9.10

+
+
+

Returns

+

TRUE if wireless is enabled

+

+

-

NMClient

-
typedef struct _NMClient NMClient;
-

-

+

nm_client_wireless_set_enabled ()

+
void
+nm_client_wireless_set_enabled (NMClient *client,
+                                gboolean enabled);
+

Enables or disables wireless devices.

+
+

Parameters

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

client

a NMClient

 

enabled

TRUE to enable wireless

 
+

-

NMClientClass

-
typedef struct {
-	NMObjectClass parent;
-
-	/* Signals */
-	void (*device_added) (NMClient *client, NMDevice *device);
-	void (*device_removed) (NMClient *client, NMDevice *device);
-	void (*permission_changed) (NMClient *client,
-	                            NMClientPermission permission,
-	                            NMClientPermissionResult result);
-
-	/* Padding for future expansion */
-	void (*_reserved1) (void);
-	void (*_reserved2) (void);
-	void (*_reserved3) (void);
-	void (*_reserved4) (void);
-	void (*_reserved5) (void);
-	void (*_reserved6) (void);
-} NMClientClass;
-
-

-

+

nm_client_wireless_hardware_get_enabled ()

+
gboolean
+nm_client_wireless_hardware_get_enabled
+                               (NMClient *client);
+

Determines whether the wireless hardware is enabled.

+
+

Parameters

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

client

a NMClient

 
+
+
+

Returns

+

TRUE if the wireless hardware is enabled

+

+

-

nm_client_new ()

-
NMClient *          nm_client_new                       (void);
-

-Creates a new NMClient. -

-

-Note that this will do blocking D-Bus calls to initialize the -client. You can use nm_client_new_async() if you want to avoid -that. -

-

-NOTE: NMClient provides information about devices and a mechanism to -control them. To access and modify network configuration data, use the -NMRemoteSettings object. -

-
+

nm_client_wwan_get_enabled ()

+
gboolean
+nm_client_wwan_get_enabled (NMClient *client);
+

Determines whether WWAN is enabled.

+
+

Parameters

+
--+++ - - + + +

Returns :

a new NMClient or NULL on an error

client

a NMClient

 
+
+

Returns

+

TRUE if WWAN is enabled

+

+
+

-

nm_client_new_async ()

-
void                nm_client_new_async                 (GCancellable *cancellable,
-                                                         GAsyncReadyCallback callback,
-                                                         gpointer user_data);
-

-Creates a new NMClient and begins asynchronously initializing it. -callback will be called when it is done; use -nm_client_new_finish() to get the result. Note that on an error, -the callback can be invoked with two first parameters as NULL. -

-

-NOTE: NMClient provides information about devices and a mechanism to -control them. To access and modify network configuration data, use the -NMRemoteSettings object. -

-
+

nm_client_wwan_set_enabled ()

+
void
+nm_client_wwan_set_enabled (NMClient *client,
+                            gboolean enabled);
+

Enables or disables WWAN devices.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + +

cancellable :

a GCancellable, or NULL -

callback :

callback to call when the client is created

client

a NMClient

 

user_data :

data for callback -

enabled

TRUE to enable WWAN

 
+

-

nm_client_new_finish ()

-
NMClient *          nm_client_new_finish                (GAsyncResult *result,
-                                                         GError **error);
-

-Gets the result of an nm_client_new_async() call. -

-
+

nm_client_wwan_hardware_get_enabled ()

+
gboolean
+nm_client_wwan_hardware_get_enabled (NMClient *client);
+

Determines whether the WWAN hardware is enabled.

+
+

Parameters

+
--+++ - - - - - - - - - - - - - - + + + + +

result :

a GAsyncResult -

error :

location for a GError, or NULL -

Returns :

a new NMClient, or NULL on error

client

a NMClient

 
+
+

Returns

+

TRUE if the WWAN hardware is enabled

+

+
+

-

nm_client_get_devices ()

-
const GPtrArray *   nm_client_get_devices               (NMClient *client);
-

-Gets all the known network devices. Use nm_device_get_type() or the -NM_IS_DEVICE_XXXX functions to determine what kind of -device member of the returned array is, and then you may use device-specific -methods such as nm_device_ethernet_get_hw_address(). -

-
+

nm_client_wimax_get_enabled ()

+
gboolean
+nm_client_wimax_get_enabled (NMClient *client);
+

Determines whether WiMAX is enabled.

+
+

Parameters

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

client

a NMClient

 
+
+
+

Returns

+

TRUE if WiMAX is enabled

+

+
+
+
+
+

nm_client_wimax_set_enabled ()

+
void
+nm_client_wimax_set_enabled (NMClient *client,
+                             gboolean enabled);
+

Enables or disables WiMAX devices.

+
+

Parameters

+
--+++ - - + + + - - + + +

client :

a NMClient -

client

a NMClient

 

Returns :

a GPtrArray -containing all the NMDevices. The returned array is owned by the -NMClient object and should not be modified. [transfer none][element-type NMDevice] -

enabled

TRUE to enable WiMAX

 
+

-

nm_client_get_device_by_path ()

-
NMDevice *          nm_client_get_device_by_path        (NMClient *client,
-                                                         const char *object_path);
-

-Gets a NMDevice from a NMClient. -

-
+

nm_client_wimax_hardware_get_enabled ()

+
gboolean
+nm_client_wimax_hardware_get_enabled (NMClient *client);
+

Determines whether the WiMAX hardware is enabled.

+
+

Parameters

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

client

a NMClient

 
+
+
+

Returns

+

TRUE if the WiMAX hardware is enabled

+

+
+
+
+
+

nm_client_get_version ()

+
const char *
+nm_client_get_version (NMClient *client);
+

Gets NetworkManager version.

+
+

Parameters

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

client

a NMClient

 
+
+
+

Returns

+

string with the version

+

+
+
+
+
+

nm_client_get_state ()

+
NMState
+nm_client_get_state (NMClient *client);
+

Gets the current daemon state.

+
+

Parameters

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

client

a NMClient

 
+
+
+

Returns

+

the current NMState

+

+
+
+
+
+

nm_client_get_startup ()

+
gboolean
+nm_client_get_startup (NMClient *client);
+

Tests whether the daemon is still in the process of activating +connections at startup.

+
+

Parameters

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

client

a NMClient

 
+
+
+

Returns

+

whether the daemon is still starting up

+

+
+

Since 0.9.10

+
+
+
+

nm_client_get_manager_running ()

+
gboolean
+nm_client_get_manager_running (NMClient *client);
+

Determines whether the daemon is running.

+
+

Parameters

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

client

a NMClient

 
+
+
+

Returns

+

TRUE if the daemon is running

+

+
+
+
+
+

nm_client_get_active_connections ()

+
const GPtrArray *
+nm_client_get_active_connections (NMClient *client);
+

Gets the active connections.

+
+

Parameters

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

client

a NMClient

 
+
+
+

Returns

+

a GPtrArray +containing all the active NMActiveConnections. +The returned array is owned by the client and should not be modified.

+

[transfer none][element-type NMActiveConnection]

+
+
+
+
+

nm_client_sleep ()

+
void
+nm_client_sleep (NMClient *client,
+                 gboolean sleep_);
+

Deprecated; use nm_client_networking_set_enabled() instead.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + +

client :

a NMClient -

object_path :

the object path to search for

client

a NMClient

 

Returns :

the NMDevice for the given object_path or NULL if none is found. [transfer none] -

sleep_

TRUE to put the daemon to sleep

 
+

-

nm_client_get_device_by_iface ()

-
NMDevice *          nm_client_get_device_by_iface       (NMClient *client,
-                                                         const char *iface);
-

-Gets a NMDevice from a NMClient. -

-
+

nm_client_get_permission_result ()

+
NMClientPermissionResult
+nm_client_get_permission_result (NMClient *client,
+                                 NMClientPermission permission);
+

Requests the result of a specific permission, which indicates whether the +client can or cannot perform the action the permission represents

+
+

Parameters

+
--+++ - - - - - - + + + - - + + +

client :

a NMClient -

iface :

the interface name to search for

client

a NMClient

 

Returns :

the NMDevice for the given iface or NULL if none is found. [transfer none] -

permission

the permission for which to return the result, one of NMClientPermission

 
-
-
-

NMClientActivateFn ()

-
void                (*NMClientActivateFn)               (NMClient *client,
-                                                         NMActiveConnection *active_connection,
-                                                         GError *error,
-                                                         gpointer user_data);
-

-

+
+

Returns

+

the permission's result, one of NMClientPermissionResult

+

+

-

nm_client_activate_connection ()

-
void                nm_client_activate_connection       (NMClient *client,
-                                                         NMConnection *connection,
-                                                         NMDevice *device,
-                                                         const char *specific_object,
-                                                         NMClientActivateFn callback,
-                                                         gpointer user_data);
-

-Starts a connection to a particular network using the configuration settings -from connection and the network device device. Certain connection types -also take a "specific object" which is the object path of a connection- -specific object, like an NMAccessPoint for Wi-Fi connections, or an -NMWimaxNsp 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 connection. -

-

-If connection is not given for a device-based activation, NetworkManager -picks the best available connection for the device and activates it. -

-

-Note that the callback is invoked when NetworkManager has started activating -the new connection, not when it finishes. You can used the returned -NMActiveConnection object (in particular, "state") to -track the activation to its completion. -

-
+

nm_client_get_logging ()

+
gboolean
+nm_client_get_logging (NMClient *client,
+                       char **level,
+                       char **domains,
+                       GError **error);
+

Gets NetworkManager current logging level and domains.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + - - + + + - - + + + - - + + +

client :

a NMClient -

connection :

an NMConnection. [allow-none] -

device :

the NMDevice. [allow-none] -

client

a NMClient

 

specific_object :

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 NULL should be used -(ie, no specific object). For Wi-Fi or WiMAX connections, pass the object -path of a NMAccessPoint or NMWimaxNsp owned by device, which you can -get using nm_object_get_path(), and which will be used to complete the -details of the newly added connection. [allow-none] -

level

return location for logging level string.

[allow-none]

callback :

the function to call when the call is done. [scope async][allow-none] -

domains

return location for log domains string. The string is +a list of domains separated by ",".

[allow-none]

user_data :

user data to pass to the callback function. [closure] -

error

return location for a GError, or NULL.

[allow-none]
-
-
-

NMClientAddActivateFn ()

-
void                (*NMClientAddActivateFn)            (NMClient *client,
-                                                         NMActiveConnection *connection,
-                                                         const char *new_connection_path,
-                                                         GError *error,
-                                                         gpointer user_data);
-

-

+
+

Returns

+

TRUE on success, FALSE otherwise

+

+
+

Since 0.9.8


-

nm_client_add_and_activate_connection ()

-
void                nm_client_add_and_activate_connection
-                                                        (NMClient *client,
-                                                         NMConnection *partial,
-                                                         NMDevice *device,
-                                                         const char *specific_object,
-                                                         NMClientAddActivateFn callback,
-                                                         gpointer user_data);
-

-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 activated. -Cannot be used for VPN connections at this time. -

-

-Note that the callback is invoked when NetworkManager has started activating -the new connection, not when it finishes. You can used the returned -NMActiveConnection object (in particular, "state") to -track the activation to its completion. -

-
+

nm_client_set_logging ()

+
gboolean
+nm_client_set_logging (NMClient *client,
+                       const char *level,
+                       const char *domains,
+                       GError **error);
+

Sets NetworkManager logging level and/or domains.

+
+

Parameters

+
--+++ - - - - - - + + + - - - - - - + + + - - + + + - - + + +

client :

a NMClient -

partial :

an NMConnection to add; the connection may be -partially filled (or even NULL) and will be completed by NetworkManager -using the given device and specific_object before being added. [allow-none] -

client

a NMClient

 

device :

the NMDevice -

specific_object :

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 NULL should be used -(ie, no specific object). For Wi-Fi or WiMAX connections, pass the object -path of a NMAccessPoint or NMWimaxNsp owned by device, which you can -get using nm_object_get_path(), and which will be used to complete the -details of the newly added connection. [allow-none] -

level

logging level to set (NULL or an empty string for no change).

[allow-none]

callback :

the function to call when the call is done. [scope async][allow-none] -

domains

logging domains to set. The string should be a list of log +domains separated by ",". (NULL or an empty string for no change).

[allow-none]

user_data :

user data to pass to the callback function. [closure] -

error

return location for a GError, or NULL.

[allow-none]
+
+

Returns

+

TRUE on success, FALSE otherwise

+

+
+

Since 0.9.8

+

-

nm_client_deactivate_connection ()

-
void                nm_client_deactivate_connection     (NMClient *client,
-                                                         NMActiveConnection *active);
-

-Deactivates an active NMActiveConnection. -

-
+

nm_client_get_connectivity ()

+
NMConnectivityState
+nm_client_get_connectivity (NMClient *client);
+

Gets the current network connectivity state. Contrast +nm_client_check_connectivity() and +nm_client_check_connectivity_async(), which re-check the +connectivity state first before returning any information.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

client :

a NMClient -

active :

the NMActiveConnection to deactivate

client

an NMClient

 
+
+

Returns

+

the current connectivity state

+

+
+

Since 0.9.8.6

+

-

nm_client_networking_get_enabled ()

-
gboolean            nm_client_networking_get_enabled    (NMClient *client);
-

-Whether networking is enabled or disabled. -

-
+

nm_client_check_connectivity ()

+
NMConnectivityState
+nm_client_check_connectivity (NMClient *client,
+                              GCancellable *cancellable,
+                              GError **error);
+

Updates the network connectivity state and returns the (new) +current state. Contrast nm_client_get_connectivity(), which returns +the most recent known state without re-checking.

+

This is a blocking call; use nm_client_check_connectivity_async() +if you do not want to block.

+
+

Parameters

+
--+++ - - + + + - - + + + + + + + +

client :

a NMClient -

client

an NMClient

 

Returns :

-TRUE if networking is enabled, FALSE if networking is disabled

cancellable

a GCancellable

 

error

return location for a GError

 
+
+

Returns

+

the (new) current connectivity state

+

+
+

Since 0.9.8.6

+

-

nm_client_networking_set_enabled ()

-
void                nm_client_networking_set_enabled    (NMClient *client,
-                                                         gboolean enabled);
-

-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. -

-
+

nm_client_check_connectivity_async ()

+
void
+nm_client_check_connectivity_async (NMClient *client,
+                                    GCancellable *cancellable,
+                                    GAsyncReadyCallback callback,
+                                    gpointer user_data);
+

Asynchronously updates the network connectivity state and invokes +callback + when complete. Contrast nm_client_get_connectivity(), +which (immediately) returns the most recent known state without +re-checking, and nm_client_check_connectivity(), which blocks.

+
+

Parameters

+
--+++ - - + + + + + + + + - - + + + + + + + +

client :

a NMClient -

client

an NMClient

 

cancellable

a GCancellable

 

enabled :

-TRUE to set networking enabled, FALSE to set networking disabled

callback

callback to call with the result

 

user_data

data for callback +.

 
+

Since 0.9.8.6

+

-

nm_client_wireless_get_enabled ()

-
gboolean            nm_client_wireless_get_enabled      (NMClient *client);
-

-Determines whether the wireless is enabled. -

-
+

nm_client_check_connectivity_finish ()

+
NMConnectivityState
+nm_client_check_connectivity_finish (NMClient *client,
+                                     GAsyncResult *result,
+                                     GError **error);
+

Retrieves the result of an nm_client_check_connectivity_async() +call.

+
+

Parameters

+
--+++ - - + + + + + + + + - - + + +

client :

a NMClient -

client

an NMClient

 

result

the GAsyncResult

 

Returns :

-TRUE if wireless is enabled

error

return location for a GError

 
+
+

Returns

+

the (new) current connectivity state

+

+
+

Since 0.9.8.6

+

-

nm_client_wireless_set_enabled ()

-
void                nm_client_wireless_set_enabled      (NMClient *client,
-                                                         gboolean enabled);
-

-Enables or disables wireless devices. -

-
+

nm_client_get_primary_connection ()

+
NMActiveConnection *
+nm_client_get_primary_connection (NMClient *client);
+

Gets the NMActiveConnection corresponding to the primary active +network device.

+

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.

+

If there is no default route, or the default route is over a +non-NetworkManager-recognized device, this will return NULL.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

client :

a NMClient -

enabled :

-TRUE to enable wireless

client

an NMClient

 
+
+

Returns

+

the appropriate NMActiveConnection, if +any.

+

[transfer none]

+
+

Since 0.9.8.6

+

-

nm_client_wireless_hardware_get_enabled ()

-
gboolean            nm_client_wireless_hardware_get_enabled
-                                                        (NMClient *client);
-

-Determines whether the wireless hardware is enabled. -

-
+

nm_client_get_activating_connection ()

+
NMActiveConnection *
+nm_client_get_activating_connection (NMClient *client);
+

Gets the NMActiveConnection corresponding to a +currently-activating connection that is expected to become the new +“primary-connection” upon successful activation.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

client :

a NMClient -

Returns :

-TRUE if the wireless hardware is enabled

client

an NMClient

 
+
+

Returns

+

the appropriate NMActiveConnection, if +any.

+

[transfer none]

+
+

Since 0.9.8.6

+
+
+
+

Types and Values

+
+

NM_CLIENT_VERSION

+
#define NM_CLIENT_VERSION "version"
+
+

+

+

-

nm_client_wwan_get_enabled ()

-
gboolean            nm_client_wwan_get_enabled          (NMClient *client);
+

NM_CLIENT_STATE

+
#define NM_CLIENT_STATE "state"
+

-Determines whether WWAN is enabled.

-
---- - - - - - - - - - - -

client :

a NMClient -

Returns :

-TRUE if WWAN is enabled

-

nm_client_wwan_set_enabled ()

-
void                nm_client_wwan_set_enabled          (NMClient *client,
-                                                         gboolean enabled);
+

NM_CLIENT_STARTUP

+
#define NM_CLIENT_STARTUP "startup"
+

-Enables or disables WWAN devices.

-
---- - - - - - - - - - - -

client :

a NMClient -

enabled :

-TRUE to enable WWAN

-

nm_client_wwan_hardware_get_enabled ()

-
gboolean            nm_client_wwan_hardware_get_enabled (NMClient *client);
+

NM_CLIENT_MANAGER_RUNNING

+
#define NM_CLIENT_MANAGER_RUNNING "manager-running"
+

-Determines whether the WWAN hardware is enabled.

-
---- - - - - - - - - - - -

client :

a NMClient -

Returns :

-TRUE if the WWAN hardware is enabled

-

nm_client_wimax_get_enabled ()

-
gboolean            nm_client_wimax_get_enabled         (NMClient *client);
+

NM_CLIENT_NETWORKING_ENABLED

+
#define NM_CLIENT_NETWORKING_ENABLED "networking-enabled"
+

-Determines whether WiMAX is enabled.

-
---- - - - - - - - - - - -

client :

a NMClient -

Returns :

-TRUE if WiMAX is enabled

-

nm_client_wimax_set_enabled ()

-
void                nm_client_wimax_set_enabled         (NMClient *client,
-                                                         gboolean enabled);
+

NM_CLIENT_WIRELESS_ENABLED

+
#define NM_CLIENT_WIRELESS_ENABLED "wireless-enabled"
+

-Enables or disables WiMAX devices.

-
---- - - - - - - - - - - -

client :

a NMClient -

enabled :

-TRUE to enable WiMAX

-

nm_client_wimax_hardware_get_enabled ()

-
gboolean            nm_client_wimax_hardware_get_enabled
-                                                        (NMClient *client);
+

NM_CLIENT_WIRELESS_HARDWARE_ENABLED

+
#define NM_CLIENT_WIRELESS_HARDWARE_ENABLED "wireless-hardware-enabled"
+

-Determines whether the WiMAX hardware is enabled.

-
---- - - - - - - - - - - -

client :

a NMClient -

Returns :

-TRUE if the WiMAX hardware is enabled

-

nm_client_get_version ()

-
const char *        nm_client_get_version               (NMClient *client);
+

NM_CLIENT_WWAN_ENABLED

+
#define NM_CLIENT_WWAN_ENABLED "wwan-enabled"
+

-Gets NetworkManager version.

-
---- - - - - - - - - - - -

client :

a NMClient -

Returns :

string with the version

-

nm_client_get_state ()

-
NMState             nm_client_get_state                 (NMClient *client);
+

NM_CLIENT_WWAN_HARDWARE_ENABLED

+
#define NM_CLIENT_WWAN_HARDWARE_ENABLED "wwan-hardware-enabled"
+
+

+

+
+
+
+

NM_CLIENT_WIMAX_ENABLED

+
#define NM_CLIENT_WIMAX_ENABLED "wimax-enabled"
+

-Gets the current daemon state.

-
---- - - - - - - - - - - -

client :

a NMClient -

Returns :

the current NMState -

-

nm_client_get_startup ()

-
gboolean            nm_client_get_startup               (NMClient *client);
+

NM_CLIENT_WIMAX_HARDWARE_ENABLED

+
#define NM_CLIENT_WIMAX_HARDWARE_ENABLED "wimax-hardware-enabled"
+

-Tests whether the daemon is still in the process of activating -connections at startup.

-
---- - - - - - - - - - - -

client :

a NMClient -

Returns :

whether the daemon is still starting up
-

Since 0.9.10


-

nm_client_get_manager_running ()

-
gboolean            nm_client_get_manager_running       (NMClient *client);
+

NM_CLIENT_ACTIVE_CONNECTIONS

+
#define NM_CLIENT_ACTIVE_CONNECTIONS "active-connections"
+

-Determines whether the daemon is running.

-
---- - - - - - - - - - - -

client :

a NMClient -

Returns :

-TRUE if the daemon is running

-

nm_client_get_active_connections ()

-
const GPtrArray *   nm_client_get_active_connections    (NMClient *client);
+

NM_CLIENT_CONNECTIVITY

+
#define NM_CLIENT_CONNECTIVITY "connectivity"
+

-Gets the active connections.

-
---- - - - - - - - - - - -

client :

a NMClient -

Returns :

a GPtrArray -containing all the active NMActiveConnections. -The returned array is owned by the client and should not be modified. [transfer none][element-type NMActiveConnection] -

-

nm_client_sleep ()

-
void                nm_client_sleep                     (NMClient *client,
-                                                         gboolean sleep_);
+

NM_CLIENT_PRIMARY_CONNECTION

+
#define NM_CLIENT_PRIMARY_CONNECTION "primary-connection"
+

-Deprecated; use nm_client_networking_set_enabled() instead.

-
---- - - - - - - - - - - -

client :

a NMClient -

sleep_ :

-TRUE to put the daemon to sleep

-

nm_client_get_permission_result ()

-
NMClientPermissionResult nm_client_get_permission_result
-                                                        (NMClient *client,
-                                                         NMClientPermission permission);
+

NM_CLIENT_ACTIVATING_CONNECTION

+
#define NM_CLIENT_ACTIVATING_CONNECTION "activating-connection"
+

-Requests the result of a specific permission, which indicates whether the -client can or cannot perform the action the permission represents

-
---- - - - - - - - - - - - - - - -

client :

a NMClient -

permission :

the permission for which to return the result, one of NMClientPermission -

Returns :

the permission's result, one of NMClientPermissionResult -

-

nm_client_get_logging ()

-
gboolean            nm_client_get_logging               (NMClient *client,
-                                                         char **level,
-                                                         char **domains,
-                                                         GError **error);
+

NM_CLIENT_DEVICES

+
#define NM_CLIENT_DEVICES "devices"
+

-Gets NetworkManager current logging level and domains.

-
---- - - - - - - - - - - - - - - - - - - - - - - -

client :

a NMClient -

level :

return location for logging level string. [allow-none] -

domains :

return location for log domains string. The string is -a list of domains separated by ",". [allow-none] -

error :

return location for a GError, or NULL. [allow-none] -

Returns :

-TRUE on success, FALSE otherwise
-

Since 0.9.8


-

nm_client_set_logging ()

-
gboolean            nm_client_set_logging               (NMClient *client,
-                                                         const char *level,
-                                                         const char *domains,
-                                                         GError **error);
-

-Sets NetworkManager logging level and/or domains. -

-
+

enum NMClientPermission

+

NMClientPermission values indicate various permissions that NetworkManager +clients can obtain to perform certain tasks on behalf of the current user.

+
+

Members

+
--+++ - - + + - - + + - - + + - - + + - - - - -

client :

a NMClient +

NM_CLIENT_PERMISSION_NONE

+

unknown or no permission

 

level :

logging level to set (NULL or an empty string for no change). [allow-none] +

NM_CLIENT_PERMISSION_ENABLE_DISABLE_NETWORK

+

controls whether networking + can be globally enabled or disabled

 

domains :

logging domains to set. The string should be a list of log -domains separated by ",". (NULL or an empty string for no change). [allow-none] +

NM_CLIENT_PERMISSION_ENABLE_DISABLE_WIFI

+

controls whether Wi-Fi can be + globally enabled or disabled

 

error :

return location for a GError, or NULL. [allow-none] +

NM_CLIENT_PERMISSION_ENABLE_DISABLE_WWAN

+

controls whether WWAN (3G) can be + globally enabled or disabled

 

Returns :

-TRUE on success, FALSE otherwise
-

Since 0.9.8

-
-
-
-

nm_client_get_connectivity ()

-
NMConnectivityState nm_client_get_connectivity          (NMClient *client);
-

-Gets the current network connectivity state. Contrast -nm_client_check_connectivity() and -nm_client_check_connectivity_async(), which re-check the -connectivity state first before returning any information. -

-
---- - - - - + + - - - - -

client :

an NMClient +

NM_CLIENT_PERMISSION_ENABLE_DISABLE_WIMAX

+

controls whether WiMAX can be + globally enabled or disabled

 

Returns :

the current connectivity state
-

Since 0.9.8.6

-
-
-
-

nm_client_check_connectivity ()

-
NMConnectivityState nm_client_check_connectivity        (NMClient *client,
-                                                         GCancellable *cancellable,
-                                                         GError **error);
-

-Updates the network connectivity state and returns the (new) -current state. Contrast nm_client_get_connectivity(), which returns -the most recent known state without re-checking. -

-

-This is a blocking call; use nm_client_check_connectivity_async() -if you do not want to block. -

-
---- - - - - + + - - + + - - + + - - + + + - -

client :

an NMClient +

NM_CLIENT_PERMISSION_SLEEP_WAKE

+

controls whether the client can ask + NetworkManager to sleep and wake

 

cancellable :

a GCancellable +

NM_CLIENT_PERMISSION_NETWORK_CONTROL

+

controls whether networking connections + can be started, stopped, and changed

 

error :

return location for a GError +

NM_CLIENT_PERMISSION_WIFI_SHARE_PROTECTED

+

controls whether a password + protected Wi-Fi hotspot can be created

 

Returns :

the (new) current connectivity state

NM_CLIENT_PERMISSION_WIFI_SHARE_OPEN

+

controls whether an open Wi-Fi hotspot + can be created

+
 
-

Since 0.9.8.6

-
-
-
-

nm_client_check_connectivity_async ()

-
void                nm_client_check_connectivity_async  (NMClient *client,
-                                                         GCancellable *cancellable,
-                                                         GAsyncReadyCallback callback,
-                                                         gpointer user_data);
-

-Asynchronously updates the network connectivity state and invokes -callback when complete. Contrast nm_client_get_connectivity(), -which (immediately) returns the most recent known state without -re-checking, and nm_client_check_connectivity(), which blocks. -

-
---- - - - + + - - + + - - + + + - - + + +

client :

an NMClient +

NM_CLIENT_PERMISSION_SETTINGS_MODIFY_SYSTEM

+

controls whether connections + that are available to all users can be modified

 

cancellable :

a GCancellable +

NM_CLIENT_PERMISSION_SETTINGS_MODIFY_OWN

+

controls whether connections + owned by the current user can be modified

 

callback :

callback to call with the result

NM_CLIENT_PERMISSION_SETTINGS_MODIFY_HOSTNAME

+

controls whether the + persistent hostname can be changed

+
 

user_data :

data for callback.

NM_CLIENT_PERMISSION_LAST

+

a reserved boundary value

+
 
-

Since 0.9.8.6

+

-

nm_client_check_connectivity_finish ()

-
NMConnectivityState nm_client_check_connectivity_finish (NMClient *client,
-                                                         GAsyncResult *result,
-                                                         GError **error);
-

-Retrieves the result of an nm_client_check_connectivity_async() -call. -

-
+

enum NMClientPermissionResult

+

NMClientPermissionResult values indicate what authorizations and permissions +the user requires to obtain a given NMClientPermission

+
+

Members

+
--+++ - - + + - - + + - - + + - - + + +

client :

an NMClient +

NM_CLIENT_PERMISSION_RESULT_UNKNOWN

+

unknown or no authorization

 

result :

the GAsyncResult +

NM_CLIENT_PERMISSION_RESULT_YES

+

the permission is available

 

error :

return location for a GError +

NM_CLIENT_PERMISSION_RESULT_AUTH

+

authorization is necessary before the + permission is available

 

Returns :

the (new) current connectivity state

NM_CLIENT_PERMISSION_RESULT_NO

+

permission to perform the operation is + denied by system policy

+
 
-

Since 0.9.8.6

+

-

nm_client_get_primary_connection ()

-
NMActiveConnection * nm_client_get_primary_connection   (NMClient *client);
-

-Gets the NMActiveConnection corresponding to the primary active -network device. -

-

-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. -

-

-If there is no default route, or the default route is over a -non-NetworkManager-recognized device, this will return NULL. -

-
+

enum NMClientError

+

Describes errors that may result from operations involving a NMClient.

+
+

Members

+
--+++ - - + + - - + +

client :

an NMClient +

NM_CLIENT_ERROR_UNKNOWN

+

unknown or unclassified error

 

Returns :

the appropriate NMActiveConnection, if -any. [transfer none] +

NM_CLIENT_ERROR_MANAGER_NOT_RUNNING

+

an operation that requires NetworkManager + failed because NetworkManager is not running

 
-

Since 0.9.8.6

+

-

nm_client_get_activating_connection ()

-
NMActiveConnection * nm_client_get_activating_connection
-                                                        (NMClient *client);
+

NM_CLIENT_ERROR

+
#define NM_CLIENT_ERROR nm_client_error_quark ()
+

-Gets the NMActiveConnection corresponding to a -currently-activating connection that is expected to become the new -"primary-connection" upon successful activation.

-
---- - - - - - - - - - - -

client :

an NMClient -

Returns :

the appropriate NMActiveConnection, if -any. [transfer none] -
-

Since 0.9.8.6

Property Details

-

The "activating-connection" property

-
  "activating-connection"    NMActiveConnection*   : Read
-

-The NMActiveConnection of the activating connection that is -likely to become the new "primary-connection". -

+

The “activating-connection” property

+
  “activating-connection”    NMActiveConnection *
+

+

Flags: Read

Since 0.9.8.6


-

The "active-connections" property

-
  "active-connections"       NMObjectArray*        : Read
-

-The active connections. -Type: GLib.PtrArray -

+

The “active-connections” property

+
  “active-connections”       NMObjectArray *
+

+

Flags: Read


-

The "connectivity" property

-
  "connectivity"             guint                 : Read
-

-The network connectivity state. -

+

The “connectivity” property

+
  “connectivity”             guint
+

+

Flags: Read

Allowed values: <= 4

Default value: 0

Since 0.9.8.6


-

The "devices" property

-
  "devices"                  NMObjectArray*        : Read
-

-List of known network devices. -

+

The “devices” property

+
  “devices”                  NMObjectArray *
+

+

Flags: Read

Since 0.9.10


-

The "manager-running" property

-
  "manager-running"          gboolean              : Read
-

-Whether the daemon is running. -

+

The “manager-running” property

+
  “manager-running”          gboolean
+

+

Flags: Read

Default value: FALSE


-

The "networking-enabled" property

-
  "networking-enabled"       gboolean              : Read / Write
-

-Whether networking is enabled. -

+

The “networking-enabled” property

+
  “networking-enabled”       gboolean
+

+

Flags: Read / Write

Default value: TRUE


-

The "primary-connection" property

-
  "primary-connection"       NMActiveConnection*   : Read
-

-The NMActiveConnection of the device with the default route; -see nm_client_get_primary_connection() for more details. -

+

The “primary-connection” property

+
  “primary-connection”       NMActiveConnection *
+

+

Flags: Read

Since 0.9.8.6


-

The "startup" property

-
  "startup"                  gboolean              : Read
-

-Whether the daemon is still starting up. -

+

The “startup” property

+
  “startup”                  gboolean
+

+

Flags: Read

Default value: FALSE

Since 0.9.10


-

The "state" property

-
  "state"                    guint                 : Read
-

-The current daemon state. -

+

The “state” property

+
  “state”                    guint
+

+

Flags: Read

Allowed values: <= 70

Default value: 0


-

The "version" property

-
  "version"                  gchar*                : Read
-

-The NetworkManager version. -

+

The “version” property

+
  “version”                  gchar *
+

+

Flags: Read

Default value: NULL


-

The "wimax-enabled" property

-
  "wimax-enabled"            gboolean              : Read / Write
-

-Whether WiMAX functionality is enabled. -

+

The “wimax-enabled” property

+
  “wimax-enabled”            gboolean
+

+

Flags: Read / Write

Default value: FALSE


-

The "wimax-hardware-enabled" property

-
  "wimax-hardware-enabled"   gboolean              : Read
-

-Whether the WiMAX hardware is enabled. -

+

The “wimax-hardware-enabled” property

+
  “wimax-hardware-enabled”   gboolean
+

+

Flags: Read

Default value: FALSE


-

The "wireless-enabled" property

-
  "wireless-enabled"         gboolean              : Read / Write
-

-Whether wireless is enabled. -

+

The “wireless-enabled” property

+
  “wireless-enabled”         gboolean
+

+

Flags: Read / Write

Default value: FALSE


-

The "wireless-hardware-enabled" property

-
  "wireless-hardware-enabled" gboolean              : Read
-

-Whether the wireless hardware is enabled. -

+

The “wireless-hardware-enabled” property

+
  “wireless-hardware-enabled” gboolean
+

+

Flags: Read

Default value: TRUE


-

The "wwan-enabled" property

-
  "wwan-enabled"             gboolean              : Read / Write
-

-Whether WWAN functionality is enabled. -

+

The “wwan-enabled” property

+
  “wwan-enabled”             gboolean
+

+

Flags: Read / Write

Default value: FALSE


-

The "wwan-hardware-enabled" property

-
  "wwan-hardware-enabled"    gboolean              : Read
-

-Whether the WWAN hardware is enabled. -

+

The “wwan-hardware-enabled” property

+
  “wwan-hardware-enabled”    gboolean
+

+

Flags: Read

Default value: FALSE

Signal Details

-

The "device-added" signal

-
void                user_function                      (NMClient *client,
-                                                        GObject  *device,
-                                                        gpointer  user_data)      : Run First
-

-Notifies that a NMDevice is added. -

-
---- - - - - - - - - - - - - - - -

client :

the client that received the signal

device :

the new device. [type NMDevice] -

user_data :

user data set when the signal handler was connected.
+

The “device-added” signal

+
void
+user_function (NMClient *client,
+               GObject  *device,
+               gpointer  user_data)
+

Flags: Run First


-

The "device-removed" signal

-
void                user_function                      (NMClient *client,
-                                                        GObject  *device,
-                                                        gpointer  user_data)      : Run First
-

-Notifies that a NMDevice is removed. -

-
---- - - - - - - - - - - - - - - -

client :

the client that received the signal

device :

the removed device. [type NMDevice] -

user_data :

user data set when the signal handler was connected.
+

The “device-removed” signal

+
void
+user_function (NMClient *client,
+               GObject  *device,
+               gpointer  user_data)
+

Flags: Run First


-

The "permission-changed" signal

-
void                user_function                      (NMClient *client,
-                                                        guint     permission,
-                                                        guint     result,
-                                                        gpointer  user_data)       : Run First
-

-Notifies that a permission has changed -

-
---- - - - - - - - - - - - - - - - - - - -

client :

the client that received the signal

permission :

a permission from NMClientPermission -

result :

the permission's result, one of NMClientPermissionResult -

user_data :

user data set when the signal handler was connected.
+

The “permission-changed” signal

+
void
+user_function (NMClient *client,
+               guint     permission,
+               guint     result,
+               gpointer  user_data)
+

Flags: Run First

+ Generated by GTK-Doc V1.21
\ No newline at end of file diff --git a/docs/libnm-glib/html/NMDHCP4Config.html b/docs/libnm-glib/html/NMDHCP4Config.html index aff13165..c400cc6a 100644 --- a/docs/libnm-glib/html/NMDHCP4Config.html +++ b/docs/libnm-glib/html/NMDHCP4Config.html @@ -2,36 +2,28 @@ -NMDHCP4Config +libnm-glib Reference Manual: NMDHCP4Config - + - - - - - - - - - - + + + + + + +
@@ -39,38 +31,76 @@

NMDHCP4Config

NMDHCP4Config

- +
-
-

Synopsis

-
                    NMDHCP4Config;
-                    NMDHCP4ConfigClass;
-#define             NM_DHCP4_CONFIG_OPTIONS
-GObject *           nm_dhcp4_config_new                 (DBusGConnection *connection,
-                                                         const char *object_path);
-GHashTable *        nm_dhcp4_config_get_options         (NMDHCP4Config *config);
-const char *        nm_dhcp4_config_get_one_option      (NMDHCP4Config *config,
-                                                         const char *option);
-
+
+

Functions

+
++++ + + + + + + + + + + + + + + +
+GObject * + +nm_dhcp4_config_new () +
+GHashTable * + +nm_dhcp4_config_get_options () +
const char * + +nm_dhcp4_config_get_one_option () +
-

Object Hierarchy

-
-  GObject
-   +----NMObject
-         +----NMDHCP4Config
-
+

Properties

+
+++++ + + + + + +
+GHashTable *optionsRead
-

Implemented Interfaces

-

-NMDHCP4Config implements - GInitable and GAsyncInitable.

+

Types and Values

+
++++ + + + + +
#defineNM_DHCP4_CONFIG_OPTIONS
-

Properties

-
-  "options"                  GHashTable*           : Read
+

Object Hierarchy

+
    GObject
+    ╰── NMObject
+        ╰── NMDHCP4Config
 
@@ -79,145 +109,128 @@ NMDHCP4Config implements

-

Details

-
-

NMDHCP4Config

-
typedef struct _NMDHCP4Config NMDHCP4Config;
-

-

-
-
-
-

NMDHCP4ConfigClass

-
typedef struct {
-	NMObjectClass parent;
-
-	/* Padding for future expansion */
-	void (*_reserved1) (void);
-	void (*_reserved2) (void);
-	void (*_reserved3) (void);
-	void (*_reserved4) (void);
-	void (*_reserved5) (void);
-	void (*_reserved6) (void);
-} NMDHCP4ConfigClass;
-
-

-

-
-
-
-

NM_DHCP4_CONFIG_OPTIONS

-
#define NM_DHCP4_CONFIG_OPTIONS "options"
-
-

-

-
-
+

Functions

-

nm_dhcp4_config_new ()

-
GObject *           nm_dhcp4_config_new                 (DBusGConnection *connection,
-                                                         const char *object_path);
-

-Creates a new NMDHCP4Config. -

-
+

nm_dhcp4_config_new ()

+
GObject *
+nm_dhcp4_config_new (DBusGConnection *connection,
+                     const char *object_path);
+

Creates a new NMDHCP4Config.

+
+

Parameters

+
--+++ - - + + + - - - - - - + + +

connection :

the DBusGConnection -

connection

the DBusGConnection

 

object_path :

the DBus object path of the device

Returns :

a new configuration. [transfer full] -

object_path

the DBus object path of the device

 
+
+

Returns

+

a new configuration.

+

[transfer full]

+
+

-

nm_dhcp4_config_get_options ()

-
GHashTable *        nm_dhcp4_config_get_options         (NMDHCP4Config *config);
-

-Gets all the options contained in the configuration. -

-
+

nm_dhcp4_config_get_options ()

+
GHashTable *
+nm_dhcp4_config_get_options (NMDHCP4Config *config);
+

Gets all the options contained in the configuration.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

config :

a NMDHCP4Config -

Returns :

the GHashTable containing strings for keys and values. -This is the internal copy used by the configuration, and must not be modified. [transfer none][element-type utf8 GObject.Value] -

config

a NMDHCP4Config

 
+
+

Returns

+

the GHashTable containing strings for keys and values. +This is the internal copy used by the configuration, and must not be modified.

+

[transfer none][element-type utf8 GObject.Value]

+
+

-

nm_dhcp4_config_get_one_option ()

-
const char *        nm_dhcp4_config_get_one_option      (NMDHCP4Config *config,
-                                                         const char *option);
-

-Gets one option by option name. -

-
+

nm_dhcp4_config_get_one_option ()

+
const char *
+nm_dhcp4_config_get_one_option (NMDHCP4Config *config,
+                                const char *option);
+

Gets one option by option name.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + +

config :

a NMDHCP4Config -

option :

the option to retrieve

config

a NMDHCP4Config

 

Returns :

the configuration option's value. This is the internal string used by the -configuration, and must not be modified.

option

the option to retrieve

 
+
+

Returns

+

the configuration option's value. This is the internal string used by the +configuration, and must not be modified.

+

+
+
-

Property Details

+

Types and Values

-

The "options" property

-
  "options"                  GHashTable*           : Read
-

-The GHashTable containing options of the configuration. -

+

NM_DHCP4_CONFIG_OPTIONS

+
#define NM_DHCP4_CONFIG_OPTIONS "options"
+

-Type: GLib.HashTable(utf8,GObject.Value)

+
+

Property Details

+
+

The “options” property

+
  “options”                  GHashTable *
+

+

Flags: Read

+
+
+ Generated by GTK-Doc V1.21
\ No newline at end of file diff --git a/docs/libnm-glib/html/NMDHCP6Config.html b/docs/libnm-glib/html/NMDHCP6Config.html index cc5b4931..c50a23df 100644 --- a/docs/libnm-glib/html/NMDHCP6Config.html +++ b/docs/libnm-glib/html/NMDHCP6Config.html @@ -2,36 +2,28 @@ -NMDHCP6Config +libnm-glib Reference Manual: NMDHCP6Config - + - - - - - - - - - - + + + + + + +
@@ -39,38 +31,76 @@

NMDHCP6Config

NMDHCP6Config

- +
-
-

Synopsis

-
                    NMDHCP6Config;
-                    NMDHCP6ConfigClass;
-#define             NM_DHCP6_CONFIG_OPTIONS
-GObject *           nm_dhcp6_config_new                 (DBusGConnection *connection,
-                                                         const char *object_path);
-GHashTable *        nm_dhcp6_config_get_options         (NMDHCP6Config *config);
-const char *        nm_dhcp6_config_get_one_option      (NMDHCP6Config *config,
-                                                         const char *option);
-
+
+

Functions

+
++++ + + + + + + + + + + + + + + +
+GObject * + +nm_dhcp6_config_new () +
+GHashTable * + +nm_dhcp6_config_get_options () +
const char * + +nm_dhcp6_config_get_one_option () +
-

Object Hierarchy

-
-  GObject
-   +----NMObject
-         +----NMDHCP6Config
-
+

Properties

+
+++++ + + + + + +
+GHashTable *optionsRead
-

Implemented Interfaces

-

-NMDHCP6Config implements - GInitable and GAsyncInitable.

+

Types and Values

+
++++ + + + + +
#defineNM_DHCP6_CONFIG_OPTIONS
-

Properties

-
-  "options"                  GHashTable*           : Read
+

Object Hierarchy

+
    GObject
+    ╰── NMObject
+        ╰── NMDHCP6Config
 
@@ -79,145 +109,128 @@ NMDHCP6Config implements

-

Details

-
-

NMDHCP6Config

-
typedef struct _NMDHCP6Config NMDHCP6Config;
-

-

-
-
-
-

NMDHCP6ConfigClass

-
typedef struct {
-	NMObjectClass parent;
-
-	/* Padding for future expansion */
-	void (*_reserved1) (void);
-	void (*_reserved2) (void);
-	void (*_reserved3) (void);
-	void (*_reserved4) (void);
-	void (*_reserved5) (void);
-	void (*_reserved6) (void);
-} NMDHCP6ConfigClass;
-
-

-

-
-
-
-

NM_DHCP6_CONFIG_OPTIONS

-
#define NM_DHCP6_CONFIG_OPTIONS "options"
-
-

-

-
-
+

Functions

-

nm_dhcp6_config_new ()

-
GObject *           nm_dhcp6_config_new                 (DBusGConnection *connection,
-                                                         const char *object_path);
-

-Creates a new NMDHCP6Config. -

-
+

nm_dhcp6_config_new ()

+
GObject *
+nm_dhcp6_config_new (DBusGConnection *connection,
+                     const char *object_path);
+

Creates a new NMDHCP6Config.

+
+

Parameters

+
--+++ - - + + + - - - - - - + + +

connection :

the DBusGConnection -

connection

the DBusGConnection

 

object_path :

the DBus object path of the device

Returns :

a new configuration. [transfer full] -

object_path

the DBus object path of the device

 
+
+

Returns

+

a new configuration.

+

[transfer full]

+
+

-

nm_dhcp6_config_get_options ()

-
GHashTable *        nm_dhcp6_config_get_options         (NMDHCP6Config *config);
-

-Gets all the options contained in the configuration. -

-
+

nm_dhcp6_config_get_options ()

+
GHashTable *
+nm_dhcp6_config_get_options (NMDHCP6Config *config);
+

Gets all the options contained in the configuration.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

config :

a NMDHCP6Config -

Returns :

the GHashTable containing strings for keys and values. -This is the internal copy used by the configuration, and must not be modified. [transfer none][element-type utf8 GObject.Value] -

config

a NMDHCP6Config

 
+
+

Returns

+

the GHashTable containing strings for keys and values. +This is the internal copy used by the configuration, and must not be modified.

+

[transfer none][element-type utf8 GObject.Value]

+
+

-

nm_dhcp6_config_get_one_option ()

-
const char *        nm_dhcp6_config_get_one_option      (NMDHCP6Config *config,
-                                                         const char *option);
-

-Gets one option by option name. -

-
+

nm_dhcp6_config_get_one_option ()

+
const char *
+nm_dhcp6_config_get_one_option (NMDHCP6Config *config,
+                                const char *option);
+

Gets one option by option name.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + +

config :

a NMDHCP6Config -

option :

the option to retrieve

config

a NMDHCP6Config

 

Returns :

the configuration option's value. This is the internal string used by the -configuration, and must not be modified.

option

the option to retrieve

 
+
+

Returns

+

the configuration option's value. This is the internal string used by the +configuration, and must not be modified.

+

+
+
-

Property Details

+

Types and Values

-

The "options" property

-
  "options"                  GHashTable*           : Read
-

-The GHashTable containing options of the configuration. -

+

NM_DHCP6_CONFIG_OPTIONS

+
#define NM_DHCP6_CONFIG_OPTIONS "options"
+

-Type: GLib.HashTable(utf8,GObject.Value)

+
+

Property Details

+
+

The “options” property

+
  “options”                  GHashTable *
+

+

Flags: Read

+
+
+ Generated by GTK-Doc V1.21
\ No newline at end of file diff --git a/docs/libnm-glib/html/NMDevice.html b/docs/libnm-glib/html/NMDevice.html index c34214d5..2d5281c8 100644 --- a/docs/libnm-glib/html/NMDevice.html +++ b/docs/libnm-glib/html/NMDevice.html @@ -2,38 +2,29 @@ -NMDevice +libnm-glib Reference Manual: NMDevice - + - - - - - - - - - - + + + + + + +
@@ -41,1780 +32,2223 @@

NMDevice

NMDevice

- +
-
-

Synopsis

-
enum                NMDeviceError;
-#define             NM_DEVICE_ERROR
-GQuark              nm_device_error_quark               (void);
-#define             NM_DEVICE_DEVICE_TYPE
-#define             NM_DEVICE_UDI
-#define             NM_DEVICE_INTERFACE
-#define             NM_DEVICE_IP_INTERFACE
-#define             NM_DEVICE_DRIVER
-#define             NM_DEVICE_DRIVER_VERSION
-#define             NM_DEVICE_FIRMWARE_VERSION
-#define             NM_DEVICE_CAPABILITIES
-#define             NM_DEVICE_MANAGED
-#define             NM_DEVICE_AUTOCONNECT
-#define             NM_DEVICE_FIRMWARE_MISSING
-#define             NM_DEVICE_IP4_CONFIG
-#define             NM_DEVICE_DHCP4_CONFIG
-#define             NM_DEVICE_IP6_CONFIG
-#define             NM_DEVICE_DHCP6_CONFIG
-#define             NM_DEVICE_STATE
-#define             NM_DEVICE_STATE_REASON
-#define             NM_DEVICE_ACTIVE_CONNECTION
-#define             NM_DEVICE_AVAILABLE_CONNECTIONS
-#define             NM_DEVICE_VENDOR
-#define             NM_DEVICE_PRODUCT
-#define             NM_DEVICE_PHYSICAL_PORT_ID
-#define             NM_DEVICE_MTU
-                    NMDevice;
-                    NMDeviceClass;
-GObject *           nm_device_new                       (DBusGConnection *connection,
-                                                         const char *path);
-const char *        nm_device_get_iface                 (NMDevice *device);
-const char *        nm_device_get_ip_iface              (NMDevice *device);
-NMDeviceType        nm_device_get_device_type           (NMDevice *device);
-const char *        nm_device_get_udi                   (NMDevice *device);
-const char *        nm_device_get_driver                (NMDevice *device);
-const char *        nm_device_get_driver_version        (NMDevice *device);
-const char *        nm_device_get_firmware_version      (NMDevice *device);
-const char *        nm_device_get_type_description      (NMDevice *device);
-const char *        nm_device_get_hw_address            (NMDevice *device);
-NMDeviceCapabilities nm_device_get_capabilities         (NMDevice *device);
-gboolean            nm_device_get_managed               (NMDevice *device);
-gboolean            nm_device_get_autoconnect           (NMDevice *device);
-void                nm_device_set_autoconnect           (NMDevice *device,
-                                                         gboolean autoconnect);
-gboolean            nm_device_get_firmware_missing      (NMDevice *device);
-NMIP4Config *       nm_device_get_ip4_config            (NMDevice *device);
-NMDHCP4Config *     nm_device_get_dhcp4_config          (NMDevice *device);
-NMIP6Config *       nm_device_get_ip6_config            (NMDevice *device);
-NMDHCP6Config *     nm_device_get_dhcp6_config          (NMDevice *device);
-NMDeviceState       nm_device_get_state                 (NMDevice *device);
-NMDeviceState       nm_device_get_state_reason          (NMDevice *device,
-                                                         NMDeviceStateReason *reason);
-NMActiveConnection * nm_device_get_active_connection    (NMDevice *device);
-const GPtrArray *   nm_device_get_available_connections (NMDevice *device);
-const char *        nm_device_get_physical_port_id      (NMDevice *device);
-guint32             nm_device_get_mtu                   (NMDevice *device);
-gboolean            nm_device_is_software               (NMDevice *device);
-const char *        nm_device_get_product               (NMDevice *device);
-const char *        nm_device_get_vendor                (NMDevice *device);
-const char *        nm_device_get_description           (NMDevice *device);
-char **             nm_device_disambiguate_names        (NMDevice **devices,
-                                                         int num_devices);
-void                (*NMDeviceCallbackFn)               (NMDevice *device,
-                                                         GError *error,
-                                                         gpointer user_data);
-void                nm_device_disconnect                (NMDevice *device,
-                                                         NMDeviceCallbackFn callback,
-                                                         gpointer user_data);
-void                nm_device_delete                    (NMDevice *device,
-                                                         NMDeviceCallbackFn callback,
-                                                         gpointer user_data);
-GSList *            nm_device_filter_connections        (NMDevice *device,
-                                                         const GSList *connections);
-gboolean            nm_device_connection_valid          (NMDevice *device,
-                                                         NMConnection *connection);
-gboolean            nm_device_connection_compatible     (NMDevice *device,
-                                                         NMConnection *connection,
-                                                         GError **error);
-GType               nm_device_get_setting_type          (NMDevice *device);
-void                (*NMDeviceDeactivateFn)             (NMDevice *device,
-                                                         GError *error,
-                                                         gpointer user_data);
-
-
-
-

Object Hierarchy

-
-  GObject
-   +----NMObject
-         +----NMDevice
-               +----NMDeviceEthernet
-               +----NMDeviceWifi
-               +----NMDeviceModem
-               +----NMDeviceBt
-               +----NMDeviceWimax
-               +----NMDeviceOlpcMesh
-               +----NMDeviceAdsl
-               +----NMDeviceInfiniband
-               +----NMDeviceBond
-               +----NMDeviceBridge
-               +----NMDeviceTeam
-               +----NMDeviceGeneric
-               +----NMDeviceVlan
-
-
-

Implemented Interfaces

-

-NMDevice implements - GInitable and GAsyncInitable.

-
-
-

Properties

-
-  "active-connection"        NMActiveConnection*   : Read
-  "autoconnect"              gboolean              : Read / Write
-  "available-connections"    NMObjectArray*        : Read
-  "capabilities"             guint                 : Read
-  "device-type"              guint                 : Read
-  "dhcp4-config"             NMDHCP4Config*        : Read
-  "dhcp6-config"             NMDHCP6Config*        : Read
-  "driver"                   gchar*                : Read
-  "driver-version"           gchar*                : Read
-  "firmware-missing"         gboolean              : Read
-  "firmware-version"         gchar*                : Read
-  "interface"                gchar*                : Read
-  "ip-interface"             gchar*                : Read
-  "ip4-config"               NMIP4Config*          : Read
-  "ip6-config"               NMIP6Config*          : Read
-  "managed"                  gboolean              : Read
-  "mtu"                      guint                 : Read
-  "physical-port-id"         gchar*                : Read
-  "product"                  gchar*                : Read
-  "state"                    guint                 : Read
-  "state-reason"             GValueArray_guint+guint_*  : Read
-  "udi"                      gchar*                : Read
-  "vendor"                   gchar*                : Read
-
-
-
-

Signals

-
-  "state-changed"                                  : Run First
-
-
-
-

Description

-

-

-
-
-

Details

-
-

enum NMDeviceError

-
typedef enum {
-	NM_DEVICE_ERROR_UNKNOWN = 0,        /*< nick=UnknownError >*/
-	NM_DEVICE_ERROR_INTERFACE_MISMATCH, /*< nick=InterfaceMismatch >*/
-} NMDeviceError;
-
-
+

Functions

+
--++ - - + - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - -

NM_DEVICE_ERROR_UNKNOWN

unknown or unclassified error + +GQuark + +nm_device_error_quark ()

NM_DEVICE_ERROR_INTERFACE_MISMATCH

the interface names of the connection and the - device mismatched + +GObject * + +nm_device_new () +
const char * + +nm_device_get_iface () +
const char * + +nm_device_get_ip_iface () +
+NMDeviceType + +nm_device_get_device_type () +
const char * + +nm_device_get_udi () +
const char * + +nm_device_get_driver () +
const char * + +nm_device_get_driver_version () +
const char * + +nm_device_get_firmware_version () +
const char * + +nm_device_get_type_description () +
const char * + +nm_device_get_hw_address () +
+NMDeviceCapabilities + +nm_device_get_capabilities () +
+gboolean + +nm_device_get_managed () +
+gboolean + +nm_device_get_autoconnect () +
+void + +nm_device_set_autoconnect () +
+gboolean + +nm_device_get_firmware_missing () +
+NMIP4Config * + +nm_device_get_ip4_config () +
+NMDHCP4Config * + +nm_device_get_dhcp4_config () +
+NMIP6Config * + +nm_device_get_ip6_config () +
+NMDHCP6Config * + +nm_device_get_dhcp6_config () +
+NMDeviceState + +nm_device_get_state () +
+NMDeviceState + +nm_device_get_state_reason () +
+NMActiveConnection * + +nm_device_get_active_connection () +
const GPtrArray * + +nm_device_get_available_connections () +
const char * + +nm_device_get_physical_port_id () +
+guint32 + +nm_device_get_mtu () +
+gboolean + +nm_device_is_software () +
const char * + +nm_device_get_product () +
const char * + +nm_device_get_vendor () +
const char * + +nm_device_get_description () +
+char ** + +nm_device_disambiguate_names () +
+void + +(*NMDeviceCallbackFn) () +
+void + +nm_device_disconnect () +
+void + +nm_device_delete () +
+GSList * + +nm_device_filter_connections () +
+gboolean + +nm_device_connection_valid ()
-
-
-
-

NM_DEVICE_ERROR

-
#define NM_DEVICE_ERROR nm_device_error_quark ()
-
-

-

-
-
-
-

nm_device_error_quark ()

-
GQuark              nm_device_error_quark               (void);
-

-Registers an error quark for NMDevice if necessary. -

-
---- - - - - -

Returns :

the error quark used for NMDevice errors.
-

Since 0.9.10

-
-
-
-

NM_DEVICE_DEVICE_TYPE

-
#define NM_DEVICE_DEVICE_TYPE "device-type"
-
-

-

-
-
-
-

NM_DEVICE_UDI

-
#define NM_DEVICE_UDI "udi"
-
-

-

-
-
-
-

NM_DEVICE_INTERFACE

-
#define NM_DEVICE_INTERFACE "interface"
-
-

-

-
-
-
-

NM_DEVICE_IP_INTERFACE

-
#define NM_DEVICE_IP_INTERFACE "ip-interface"
-
-

-

-
-
-
-

NM_DEVICE_DRIVER

-
#define NM_DEVICE_DRIVER "driver"
-
-

-

-
-
-
-

NM_DEVICE_DRIVER_VERSION

-
#define NM_DEVICE_DRIVER_VERSION "driver-version"
-
-

-

-
-
-
-

NM_DEVICE_FIRMWARE_VERSION

-
#define NM_DEVICE_FIRMWARE_VERSION "firmware-version"
-
-

-

-
-
-
-

NM_DEVICE_CAPABILITIES

-
#define NM_DEVICE_CAPABILITIES "capabilities"
-
-

-

-
-
-
-

NM_DEVICE_MANAGED

-
#define NM_DEVICE_MANAGED "managed"
-
-

-

-
-
-
-

NM_DEVICE_AUTOCONNECT

-
#define NM_DEVICE_AUTOCONNECT "autoconnect"
-
-

-

-
-
-
-

NM_DEVICE_FIRMWARE_MISSING

-
#define NM_DEVICE_FIRMWARE_MISSING "firmware-missing"
-
-

-

-
-
-
-

NM_DEVICE_IP4_CONFIG

-
#define NM_DEVICE_IP4_CONFIG "ip4-config"
-
-

-

-
-
-
-

NM_DEVICE_DHCP4_CONFIG

-
#define NM_DEVICE_DHCP4_CONFIG "dhcp4-config"
-
-

-

-
-
-
-

NM_DEVICE_IP6_CONFIG

-
#define NM_DEVICE_IP6_CONFIG "ip6-config"
-
-

-

-
-
-
-

NM_DEVICE_DHCP6_CONFIG

-
#define NM_DEVICE_DHCP6_CONFIG "dhcp6-config"
-
-

-

-
-
-
-

NM_DEVICE_STATE

-
#define NM_DEVICE_STATE "state"
-
-

-

-
-
-
-

NM_DEVICE_STATE_REASON

-
#define NM_DEVICE_STATE_REASON "state-reason"
-
-

-

-
-
-
-

NM_DEVICE_ACTIVE_CONNECTION

-
#define NM_DEVICE_ACTIVE_CONNECTION "active-connection"
-
-

-

-
-
-
-

NM_DEVICE_AVAILABLE_CONNECTIONS

-
#define NM_DEVICE_AVAILABLE_CONNECTIONS "available-connections"
-
-

-

-
-
-
-

NM_DEVICE_VENDOR

-
#define NM_DEVICE_VENDOR "vendor"
-
-

-

-
-
-
-

NM_DEVICE_PRODUCT

-
#define NM_DEVICE_PRODUCT "product"
-
-

-

-
-
-
-

NM_DEVICE_PHYSICAL_PORT_ID

-
#define NM_DEVICE_PHYSICAL_PORT_ID "physical-port-id"
-
-

-

-
-
-
-

NM_DEVICE_MTU

-
#define NM_DEVICE_MTU "mtu"
-
-

-

-
-
-
-

NMDevice

-
typedef struct _NMDevice NMDevice;
-

-

-
-
-
-

NMDeviceClass

-
typedef struct {
-	NMObjectClass parent;
-
-	/* Signals */
-	void (*state_changed) (NMDevice *device,
-	                       NMDeviceState new_state,
-	                       NMDeviceState old_state,
-	                       NMDeviceStateReason reason);
-
-	gboolean (*connection_compatible) (NMDevice *device,
-	                                   NMConnection *connection,
-	                                   GError **error);
-
-	const char * (*get_type_description) (NMDevice *device);
-	const char * (*get_hw_address) (NMDevice *device);
-
-	GType (*get_setting_type) (NMDevice *device);
-
-	/* Padding for future expansion */
-	void (*_reserved1) (void);
-	void (*_reserved2) (void);
-	void (*_reserved3) (void);
-} NMDeviceClass;
-
-

-

-
-
-
-

nm_device_new ()

-
GObject *           nm_device_new                       (DBusGConnection *connection,
-                                                         const char *path);
-

-Creates a new NMDevice. -

-
---- - - - + - - + + - - +

connection :

the DBusGConnection + +gboolean + +nm_device_connection_compatible ()

path :

the DBus object path of the device +GType + +nm_device_get_setting_type () +

Returns :

a new device. [transfer full] + +void + +(*NMDeviceDeactivateFn) ()
-
-
-

nm_device_get_iface ()

-
const char *        nm_device_get_iface                 (NMDevice *device);
-

-Gets the interface name of the NMDevice. -

-
+
+

Properties

+
--+++ - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

device :

a NMDevice - +NMActiveConnection *active-connectionRead
gbooleanautoconnectRead / Write
+NMObjectArray *available-connectionsRead
guintcapabilitiesRead
guintdevice-typeRead
+NMDHCP4Config *dhcp4-configRead
+NMDHCP6Config *dhcp6-configRead
+gchar *driverRead
+gchar *driver-versionRead

Returns :

the interface of the device. This is the internal string used by the -device, and must not be modified.gbooleanfirmware-missingRead
+gchar *firmware-versionRead
+gchar *interfaceRead
+gchar *ip-interfaceRead
+NMIP4Config *ip4-configRead
+NMIP6Config *ip6-configRead
gbooleanmanagedRead
guintmtuRead
+gchar *physical-port-idRead
+gchar *productRead
guintstateRead
GValueArray_guint+guint_*state-reasonRead
+gchar *udiRead
+gchar *vendorRead
-
-
-

nm_device_get_ip_iface ()

-
const char *        nm_device_get_ip_iface              (NMDevice *device);
-

-Gets the IP interface name of the NMDevice over which IP traffic flows -when the device is in the ACTIVATED state. -

-
+
+

Signals

+
--++++ + + + + + +
voidstate-changedRun First
+
+
+

Types and Values

+
+++ - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

device :

a NMDevice -enumNMDeviceError
#defineNM_DEVICE_ERROR
#defineNM_DEVICE_DEVICE_TYPE
#defineNM_DEVICE_UDI
#defineNM_DEVICE_INTERFACE
#defineNM_DEVICE_IP_INTERFACE
#defineNM_DEVICE_DRIVER
#defineNM_DEVICE_DRIVER_VERSION
#defineNM_DEVICE_FIRMWARE_VERSION
#defineNM_DEVICE_CAPABILITIES
#defineNM_DEVICE_MANAGED
#defineNM_DEVICE_AUTOCONNECT
#defineNM_DEVICE_FIRMWARE_MISSING

Returns :

the IP traffic interface of the device. This is the internal string -used by the device, and must not be modified.#defineNM_DEVICE_IP4_CONFIG
#defineNM_DEVICE_DHCP4_CONFIG
#defineNM_DEVICE_IP6_CONFIG
#defineNM_DEVICE_DHCP6_CONFIG
#defineNM_DEVICE_STATE
#defineNM_DEVICE_STATE_REASON
#defineNM_DEVICE_ACTIVE_CONNECTION
#defineNM_DEVICE_AVAILABLE_CONNECTIONS
#defineNM_DEVICE_VENDOR
#defineNM_DEVICE_PRODUCT
#defineNM_DEVICE_PHYSICAL_PORT_ID
#defineNM_DEVICE_MTU
-
-
-

nm_device_get_device_type ()

-
NMDeviceType        nm_device_get_device_type           (NMDevice *device);
+
+

Object Hierarchy

+
    GObject
+    ╰── NMObject
+        ╰── NMDevice
+            ├── NMDeviceEthernet
+            ├── NMDeviceWifi
+            ├── NMDeviceModem
+            ├── NMDeviceBt
+            ├── NMDeviceWimax
+            ├── NMDeviceOlpcMesh
+            ├── NMDeviceAdsl
+            ├── NMDeviceInfiniband
+            ├── NMDeviceBond
+            ├── NMDeviceBridge
+            ├── NMDeviceTeam
+            ├── NMDeviceGeneric
+            ╰── NMDeviceVlan
+
+
+
+

Description

-Returns the numeric type of the NMDevice, ie Ethernet, Wi-Fi, etc.

-
+ +
+

Functions

+
+

nm_device_error_quark ()

+
GQuark
+nm_device_error_quark (void);
+

Registers an error quark for NMDevice if necessary.

+
+

Returns

+

the error quark used for NMDevice errors.

+

+
+

Since 0.9.10

+
+
+
+

nm_device_new ()

+
GObject *
+nm_device_new (DBusGConnection *connection,
+               const char *path);
+

Creates a new NMDevice.

+
+

Parameters

+
--+++ - - + + + - - + + +

device :

a NMDevice -

connection

the DBusGConnection

 

Returns :

the device type

path

the DBus object path of the device

 
+
+

Returns

+

a new device.

+

[transfer full]

+
+

-

nm_device_get_udi ()

-
const char *        nm_device_get_udi                   (NMDevice *device);
-

-Gets the Unique Device Identifier of the NMDevice. -

-
+

nm_device_get_iface ()

+
const char *
+nm_device_get_iface (NMDevice *device);
+

Gets the interface name of the NMDevice.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

device :

a NMDevice -

Returns :

the Unique Device Identifier of the device. This identifier may be -used to gather more information about the device from various operating -system services like udev or sysfs.

device

a NMDevice

 
+
+

Returns

+

the interface of the device. This is the internal string used by the +device, and must not be modified.

+

+
+

-

nm_device_get_driver ()

-
const char *        nm_device_get_driver                (NMDevice *device);
-

-Gets the driver of the NMDevice. -

-
+

nm_device_get_ip_iface ()

+
const char *
+nm_device_get_ip_iface (NMDevice *device);
+

Gets the IP interface name of the NMDevice over which IP traffic flows +when the device is in the ACTIVATED state.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

device :

a NMDevice -

Returns :

the driver of the device. This is the internal string used by the -device, and must not be modified.

device

a NMDevice

 
+
+

Returns

+

the IP traffic interface of the device. This is the internal string +used by the device, and must not be modified.

+

+
+

-

nm_device_get_driver_version ()

-
const char *        nm_device_get_driver_version        (NMDevice *device);
-

-Gets the driver version of the NMDevice. -

-
+

nm_device_get_device_type ()

+
NMDeviceType
+nm_device_get_device_type (NMDevice *device);
+

Returns the numeric type of the NMDevice, ie Ethernet, Wi-Fi, etc.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

device :

a NMDevice -

Returns :

the version of the device driver. This is the internal string used by the -device, and must not be modified.

device

a NMDevice

 
+
+

Returns

+

the device type

+

+
+

-

nm_device_get_firmware_version ()

-
const char *        nm_device_get_firmware_version      (NMDevice *device);
-

-Gets the firmware version of the NMDevice. -

-
+

nm_device_get_udi ()

+
const char *
+nm_device_get_udi (NMDevice *device);
+

Gets the Unique Device Identifier of the NMDevice.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

device :

a NMDevice -

Returns :

the firmware version of the device. This is the internal string used by the -device, and must not be modified.

device

a NMDevice

 
+
+

Returns

+

the Unique Device Identifier of the device. This identifier may be +used to gather more information about the device from various operating +system services like udev or sysfs.

+

+
+
-

nm_device_get_type_description ()

-
const char *        nm_device_get_type_description      (NMDevice *device);
-

-Gets a (non-localized) description of the type of device that -device is. -

-
+

nm_device_get_driver ()

+
const char *
+nm_device_get_driver (NMDevice *device);
+

Gets the driver of the NMDevice.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + + +

device :

a NMDevice -

Returns :

the type description of the device. This is the internal -string used by the device, and must not be modified.

device

a NMDevice

 
+
+
+

Returns

+

the driver of the device. This is the internal string used by the +device, and must not be modified.

+

+
+ +
+
+

nm_device_get_driver_version ()

+
const char *
+nm_device_get_driver_version (NMDevice *device);
+

Gets the driver version of the NMDevice.

+
+

Parameters

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

device

a NMDevice

 
+
+
+

Returns

+

the version of the device driver. This is the internal string used by the +device, and must not be modified.

+

+
+
+
+
+

nm_device_get_firmware_version ()

+
const char *
+nm_device_get_firmware_version (NMDevice *device);
+

Gets the firmware version of the NMDevice.

+
+

Parameters

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

device

a NMDevice

 
+
+
+

Returns

+

the firmware version of the device. This is the internal string used by the +device, and must not be modified.

+

+
+
+
+
+

nm_device_get_type_description ()

+
const char *
+nm_device_get_type_description (NMDevice *device);
+

Gets a (non-localized) description of the type of device that +device + is.

+
+

Parameters

+
+++++ + + + + +

device

a NMDevice

 
+
+
+

Returns

+

the type description of the device. This is the internal +string used by the device, and must not be modified.

+

+

Since 0.9.10


-

nm_device_get_hw_address ()

-
const char *        nm_device_get_hw_address            (NMDevice *device);
-

-Gets the current a hardware address (MAC) for the device. -

-
+

nm_device_get_hw_address ()

+
const char *
+nm_device_get_hw_address (NMDevice *device);
+

Gets the current a hardware address (MAC) for the device +.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

device :

a NMDevice -

Returns :

the current MAC of the device, or NULL. -This is the internal string used by the device, and must not be modified.

device

a NMDevice

 
+
+
+

Returns

+

the current MAC of the device, or NULL. +This is the internal string used by the device, and must not be modified.

+

+

Since 0.9.10


-

nm_device_get_capabilities ()

-
NMDeviceCapabilities nm_device_get_capabilities         (NMDevice *device);
-

-Gets the device' capabilities. -

-
+

nm_device_get_capabilities ()

+
NMDeviceCapabilities
+nm_device_get_capabilities (NMDevice *device);
+

Gets the device' capabilities.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

device :

a NMDevice -

Returns :

the capabilities

device

a NMDevice

 
+
+

Returns

+

the capabilities

+

+
+
-

nm_device_get_managed ()

-
gboolean            nm_device_get_managed               (NMDevice *device);
-

-Whether the NMDevice is managed by NetworkManager. -

-
+

nm_device_get_managed ()

+
gboolean
+nm_device_get_managed (NMDevice *device);
+

Whether the NMDevice is managed by NetworkManager.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

device :

a NMDevice -

Returns :

-TRUE if the device is managed by NetworkManager

device

a NMDevice

 
+
+

Returns

+

TRUE if the device is managed by NetworkManager

+

+
+
-

nm_device_get_autoconnect ()

-
gboolean            nm_device_get_autoconnect           (NMDevice *device);
-

-Whether the NMDevice can be autoconnected. -

-
+

nm_device_get_autoconnect ()

+
gboolean
+nm_device_get_autoconnect (NMDevice *device);
+

Whether the NMDevice can be autoconnected.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

device :

a NMDevice -

Returns :

-TRUE if the device is allowed to be autoconnected

device

a NMDevice

 
+
+

Returns

+

TRUE if the device is allowed to be autoconnected

+

+
+
-

nm_device_set_autoconnect ()

-
void                nm_device_set_autoconnect           (NMDevice *device,
-                                                         gboolean autoconnect);
-

-Enables or disables automatic activation of the NMDevice. -

-
+

nm_device_set_autoconnect ()

+
void
+nm_device_set_autoconnect (NMDevice *device,
+                           gboolean autoconnect);
+

Enables or disables automatic activation of the NMDevice.

+
+

Parameters

+
--+++ - - + + + - - + + +

device :

a NMDevice -

device

a NMDevice

 

autoconnect :

-TRUE to enable autoconnecting

autoconnect

TRUE to enable autoconnecting

 
+
-

nm_device_get_firmware_missing ()

-
gboolean            nm_device_get_firmware_missing      (NMDevice *device);
-

-Indicates that firmware required for the device's operation is likely -to be missing. -

-
+

nm_device_get_firmware_missing ()

+
gboolean
+nm_device_get_firmware_missing (NMDevice *device);
+

Indicates that firmware required for the device's operation is likely +to be missing.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

device :

a NMDevice -

Returns :

-TRUE if firmware required for the device's operation is likely -to be missing.

device

a NMDevice

 
+
+

Returns

+

TRUE if firmware required for the device's operation is likely +to be missing.

+

+
+
-

nm_device_get_ip4_config ()

-
NMIP4Config *       nm_device_get_ip4_config            (NMDevice *device);
-

-Gets the current NMIP4Config associated with the NMDevice. -

-

-Note that as of NetworkManager 0.9.10, you can alternatively use -nm_active_connection_get_ip4_config(), which also works with VPN -connections. -

-
+

nm_device_get_ip4_config ()

+
NMIP4Config *
+nm_device_get_ip4_config (NMDevice *device);
+

Gets the current NMIP4Config associated with the NMDevice.

+

Note that as of NetworkManager 0.9.10, you can alternatively use +nm_active_connection_get_ip4_config(), which also works with VPN +connections.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

device :

a NMDevice -

Returns :

the NMIP4Config or NULL if the device is not activated. [transfer none] -

device

a NMDevice

 
+
+

Returns

+

the NMIP4Config or NULL if the device is not activated.

+

[transfer none]

+
+
-

nm_device_get_dhcp4_config ()

-
NMDHCP4Config *     nm_device_get_dhcp4_config          (NMDevice *device);
-

-Gets the current NMDHCP4Config associated with the NMDevice. -

-

-Note that as of NetworkManager 0.9.10, you can alternatively use -nm_active_connection_get_dhcp4_config(), which also works with VPN -connections. -

-
+

nm_device_get_dhcp4_config ()

+
NMDHCP4Config *
+nm_device_get_dhcp4_config (NMDevice *device);
+

Gets the current NMDHCP4Config associated with the NMDevice.

+

Note that as of NetworkManager 0.9.10, you can alternatively use +nm_active_connection_get_dhcp4_config(), which also works with VPN +connections.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

device :

a NMDevice -

Returns :

the NMDHCP4Config or NULL if the device is not activated or not -using DHCP. [transfer none] -

device

a NMDevice

 
+
+

Returns

+

the NMDHCP4Config or NULL if the device is not activated or not +using DHCP.

+

[transfer none]

+
+
-

nm_device_get_ip6_config ()

-
NMIP6Config *       nm_device_get_ip6_config            (NMDevice *device);
-

-Gets the current NMIP6Config associated with the NMDevice. -

-

-Note that as of NetworkManager 0.9.10, you can alternatively use -nm_active_connection_get_ip6_config(), which also works with VPN -connections. -

-
+

nm_device_get_ip6_config ()

+
NMIP6Config *
+nm_device_get_ip6_config (NMDevice *device);
+

Gets the current NMIP6Config associated with the NMDevice.

+

Note that as of NetworkManager 0.9.10, you can alternatively use +nm_active_connection_get_ip6_config(), which also works with VPN +connections.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

device :

a NMDevice -

Returns :

the NMIP6Config or NULL if the device is not activated. [transfer none] -

device

a NMDevice

 
+
+

Returns

+

the NMIP6Config or NULL if the device is not activated.

+

[transfer none]

+
+
-

nm_device_get_dhcp6_config ()

-
NMDHCP6Config *     nm_device_get_dhcp6_config          (NMDevice *device);
-

-Gets the current NMDHCP6Config associated with the NMDevice. -

-

-Note that as of NetworkManager 0.9.10, you can alternatively use -nm_active_connection_get_dhcp6_config(), which also works with VPN -connections. -

-
+

nm_device_get_dhcp6_config ()

+
NMDHCP6Config *
+nm_device_get_dhcp6_config (NMDevice *device);
+

Gets the current NMDHCP6Config associated with the NMDevice.

+

Note that as of NetworkManager 0.9.10, you can alternatively use +nm_active_connection_get_dhcp6_config(), which also works with VPN +connections.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

device :

a NMDevice -

Returns :

the NMDHCP6Config or NULL if the device is not activated or not -using DHCP. [transfer none] -

device

a NMDevice

 
+
+

Returns

+

the NMDHCP6Config or NULL if the device is not activated or not +using DHCP.

+

[transfer none]

+
+
-

nm_device_get_state ()

-
NMDeviceState       nm_device_get_state                 (NMDevice *device);
-

-Gets the current NMDevice state. -

-
+

nm_device_get_state ()

+
NMDeviceState
+nm_device_get_state (NMDevice *device);
+

Gets the current NMDevice state.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

device :

a NMDevice -

Returns :

the current device state

device

a NMDevice

 
+
+

Returns

+

the current device state

+

+
+
-

nm_device_get_state_reason ()

-
NMDeviceState       nm_device_get_state_reason          (NMDevice *device,
-                                                         NMDeviceStateReason *reason);
-

-Gets the current NMDevice state (return value) and the reason for entering -the state (reason argument). -

-
+

nm_device_get_state_reason ()

+
NMDeviceState
+nm_device_get_state_reason (NMDevice *device,
+                            NMDeviceStateReason *reason);
+

Gets the current NMDevice state (return value) and the reason for entering +the state (reason + argument).

+
+

Parameters

+
--+++ - - - - - - + + + - - + + +

device :

a NMDevice -

reason :

location to store reason (NMDeviceStateReason), or NULL. [out][allow-none] -

device

a NMDevice

 

Returns :

the current device state

reason

location to store reason (NMDeviceStateReason), or NULL.

[out][allow-none]
+
+

Returns

+

the current device state

+

+
+
-

nm_device_get_active_connection ()

-
NMActiveConnection * nm_device_get_active_connection    (NMDevice *device);
-

-Gets the NMActiveConnection object which owns this device during activation. -

-
+

nm_device_get_active_connection ()

+
NMActiveConnection *
+nm_device_get_active_connection (NMDevice *device);
+

Gets the NMActiveConnection object which owns this device during activation.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

device :

a NMDevice -

Returns :

the NMActiveConnection or NULL if the device is -not part of an active connection. [transfer none] -

device

a NMDevice

 
+
+

Returns

+

the NMActiveConnection or NULL if the device is +not part of an active connection.

+

[transfer none]

+
+
-

nm_device_get_available_connections ()

-
const GPtrArray *   nm_device_get_available_connections (NMDevice *device);
-

-Gets the NMRemoteConnections currently known to the daemon that could -be activated on device. -

-
+

nm_device_get_available_connections ()

+
const GPtrArray *
+nm_device_get_available_connections (NMDevice *device);
+

Gets the NMRemoteConnections currently known to the daemon that could +be activated on device +.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

device :

a NMDevice -

Returns :

the GPtrArray -containing NMRemoteConnections. This is the internal copy used by -the connection, and must not be modified. [element-type NMRemoteConnection] -

device

a NMDevice

 
+
+
+

Returns

+

the GPtrArray +containing NMRemoteConnections. This is the internal copy used by +the connection, and must not be modified.

+

[element-type NMRemoteConnection]

+

Since 0.9.8


-

nm_device_get_physical_port_id ()

-
const char *        nm_device_get_physical_port_id      (NMDevice *device);
-

-Gets the physical port ID of the NMDevice. If non-NULL, this is +

nm_device_get_physical_port_id ()

+
const char *
+nm_device_get_physical_port_id (NMDevice *device);
+

Gets the physical port ID of the NMDevice. If non-NULL, this is an opaque string that can be used to recognize when seemingly-unrelated NMDevices are actually just different virtual -ports on a single physical port. (Eg, NPAR / SR-IOV.) -

-
+ports on a single physical port. (Eg, NPAR / SR-IOV.)

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

device :

a NMDevice -

Returns :

the physical port ID of the device, or NULL if the port -ID is unknown. This is the internal string used by the device and -must not be modified.

device

a NMDevice

 
+
+
+

Returns

+

the physical port ID of the device, or NULL if the port +ID is unknown. This is the internal string used by the device and +must not be modified.

+

+

Since 0.9.10


-

nm_device_get_mtu ()

-
guint32             nm_device_get_mtu                   (NMDevice *device);
-

-Gets the MTU of the NMDevice. -

-
+

nm_device_get_mtu ()

+
guint32
+nm_device_get_mtu (NMDevice *device);
+

Gets the MTU of the NMDevice.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

device :

a NMDevice -

Returns :

the MTU of the device.

device

a NMDevice

 
+
+
+

Returns

+

the MTU of the device.

+

+

Since 0.9.10


-

nm_device_is_software ()

-
gboolean            nm_device_is_software               (NMDevice *device);
-

-Whether the device is a software device. -

-
+

nm_device_is_software ()

+
gboolean
+nm_device_is_software (NMDevice *device);
+

Whether the device is a software device.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

device :

a NMDevice -

Returns :

-TRUE if device is a software device, FALSE if it is a hardware device.

device

a NMDevice

 
+
+
+

Returns

+

TRUE if device +is a software device, FALSE if it is a hardware device.

+

+

Since 1.0


-

nm_device_get_product ()

-
const char *        nm_device_get_product               (NMDevice *device);
-

-Gets the product string of the NMDevice. -

-
+

nm_device_get_product ()

+
const char *
+nm_device_get_product (NMDevice *device);
+

Gets the product string of the NMDevice.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

device :

a NMDevice -

Returns :

the product name of the device. This is the internal string used by the -device, and must not be modified.

device

a NMDevice

 
+
+

Returns

+

the product name of the device. This is the internal string used by the +device, and must not be modified.

+

+
+
-

nm_device_get_vendor ()

-
const char *        nm_device_get_vendor                (NMDevice *device);
-

-Gets the vendor string of the NMDevice. -

-
+

nm_device_get_vendor ()

+
const char *
+nm_device_get_vendor (NMDevice *device);
+

Gets the vendor string of the NMDevice.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

device :

a NMDevice -

Returns :

the vendor name of the device. This is the internal string used by the -device, and must not be modified.

device

a NMDevice

 
+
+

Returns

+

the vendor name of the device. This is the internal string used by the +device, and must not be modified.

+

+
+
-

nm_device_get_description ()

-
const char *        nm_device_get_description           (NMDevice *device);
-

-Gets a description of device, based on its vendor and product names. -

-
+

nm_device_get_description ()

+
const char *
+nm_device_get_description (NMDevice *device);
+

Gets a description of device +, based on its vendor and product names.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

device :

an NMDevice -

Returns :

a description of device. If either the vendor or the -product name is unknown, this returns the interface name.

device

an NMDevice

 
+
+
+

Returns

+

a description of device +. If either the vendor or the +product name is unknown, this returns the interface name.

+

+

Since 0.9.10


-

nm_device_disambiguate_names ()

-
char **             nm_device_disambiguate_names        (NMDevice **devices,
-                                                         int num_devices);
-

-Generates a list of short-ish unique presentation names for the -devices in devices. -

-
+

nm_device_disambiguate_names ()

+
char **
+nm_device_disambiguate_names (NMDevice **devices,
+                              int num_devices);
+

Generates a list of short-ish unique presentation names for the +devices in devices +.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + +

devices :

an array of NMDevice. [array length=num_devices] -

num_devices :

length of devices -

devices

an array of NMDevice.

[array length=num_devices]

Returns :

the device names. [transfer full][array zero-terminated=1] -

num_devices

length of devices +

 
+
+
+

Returns

+

the device names.

+

[transfer full][array zero-terminated=1]

+

Since 0.9.10


-

NMDeviceCallbackFn ()

-
void                (*NMDeviceCallbackFn)               (NMDevice *device,
-                                                         GError *error,
-                                                         gpointer user_data);
+

NMDeviceCallbackFn ()

+
void
+(*NMDeviceCallbackFn) (NMDevice *device,
+                       GError *error,
+                       gpointer user_data);


-

nm_device_disconnect ()

-
void                nm_device_disconnect                (NMDevice *device,
-                                                         NMDeviceCallbackFn callback,
-                                                         gpointer user_data);
-

-Disconnects the device if currently connected, and prevents the device from +

nm_device_disconnect ()

+
void
+nm_device_disconnect (NMDevice *device,
+                      NMDeviceCallbackFn callback,
+                      gpointer user_data);
+

Disconnects the device if currently connected, and prevents the device from automatically connecting to networks until the next manual network connection -request. -

-
+request.

+
+

Parameters

+
--+++ - - + + + - - + + + - - + + +

device :

a NMDevice -

device

a NMDevice

 

callback :

callback to be called when disconnect -operation completes. [scope async][allow-none] -

callback

callback to be called when disconnect +operation completes.

[scope async][allow-none]

user_data :

caller-specific data passed to callback. [closure] -

user_data

caller-specific data passed to callback +.

[closure]
+
-

nm_device_delete ()

-
void                nm_device_delete                    (NMDevice *device,
-                                                         NMDeviceCallbackFn callback,
-                                                         gpointer user_data);
-

-Deletes the software device. Hardware devices can't be deleted. -

-
+

nm_device_delete ()

+
void
+nm_device_delete (NMDevice *device,
+                  NMDeviceCallbackFn callback,
+                  gpointer user_data);
+

Deletes the software device. Hardware devices can't be deleted.

+
+

Parameters

+
--+++ - - + + + - - + + + - - + + +

device :

a NMDevice -

device

a NMDevice

 

callback :

callback to be called when delete -operation completes. [scope async][allow-none] -

callback

callback to be called when delete +operation completes.

[scope async][allow-none]

user_data :

caller-specific data passed to callback. [closure] -

user_data

caller-specific data passed to callback +.

[closure]
+

Since 1.0


-

nm_device_filter_connections ()

-
GSList *            nm_device_filter_connections        (NMDevice *device,
-                                                         const GSList *connections);
-

-Filters a given list of connections for a given NMDevice object and return +

nm_device_filter_connections ()

+
GSList *
+nm_device_filter_connections (NMDevice *device,
+                              const GSList *connections);
+

Filters a given list of connections for a given NMDevice object and return connections which may be activated with the device. For example if device + is a Wi-Fi device that supports only WEP encryption, the returned list will -contain any Wi-Fi connections in connections that allow connection to +contain any Wi-Fi connections in connections + that allow connection to unencrypted or WEP-enabled SSIDs. The returned list will not contain Ethernet, Bluetooth, Wi-Fi WPA connections, or any other connection that is incompatible with the device. To get the full list of connections see -nm_remote_settings_list_connections(). -

-
+nm_remote_settings_list_connections().

+
+

Parameters

+
--+++ - - - - - - + + + - - + + +

device :

an NMDevice to filter connections for

connections :

a list of NMConnection objects to filter. [element-type NMConnection] -

device

an NMDevice to filter connections for

 

Returns :

a -list of NMConnection objects that could be activated with the given device. -The elements of the list are owned by their creator and should not be freed -by the caller, but the returned list itself is owned by the caller and should -be freed with g_slist_free() when it is no longer required. [transfer container][element-type NMConnection] -

connections

a list of NMConnection objects to filter.

[element-type NMConnection]
+
+

Returns

+

a +list of NMConnection objects that could be activated with the given device +. +The elements of the list are owned by their creator and should not be freed +by the caller, but the returned list itself is owned by the caller and should +be freed with g_slist_free() when it is no longer required.

+

[transfer container][element-type NMConnection]

+
+
-

nm_device_connection_valid ()

-
gboolean            nm_device_connection_valid          (NMDevice *device,
-                                                         NMConnection *connection);
-

-Validates a given connection for a given NMDevice object and returns +

nm_device_connection_valid ()

+
gboolean
+nm_device_connection_valid (NMDevice *device,
+                            NMConnection *connection);
+

Validates a given connection for a given NMDevice object and returns whether the connection may be activated with the device. For example if -device is a Wi-Fi device that supports only WEP encryption, the connection +device + is a Wi-Fi device that supports only WEP encryption, the connection will only be valid if it is a Wi-Fi connection which describes a WEP or open network, and will not be valid if it describes a WPA network, or if it is an Ethernet, Bluetooth, WWAN, etc connection that is incompatible with the -device. -

-
+device.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + +

device :

an NMDevice to validate connection against

connection :

an NMConnection to validate against device -

device

an NMDevice to validate connection +against

 

Returns :

-TRUE if the connection may be activated with this device, FALSE -if is incompatible with the device's capabilities and characteristics.

connection

an NMConnection to validate against device +

 
+
+

Returns

+

TRUE if the connection may be activated with this device, FALSE +if is incompatible with the device's capabilities and characteristics.

+

+
+
-

nm_device_connection_compatible ()

-
gboolean            nm_device_connection_compatible     (NMDevice *device,
-                                                         NMConnection *connection,
-                                                         GError **error);
-

-Validates a given connection for a given NMDevice object and returns +

nm_device_connection_compatible ()

+
gboolean
+nm_device_connection_compatible (NMDevice *device,
+                                 NMConnection *connection,
+                                 GError **error);
+

Validates a given connection for a given NMDevice object and returns whether the connection may be activated with the device. For example if -device is a Wi-Fi device that supports only WEP encryption, the connection +device + is a Wi-Fi device that supports only WEP encryption, the connection will only be valid if it is a Wi-Fi connection which describes a WEP or open network, and will not be valid if it describes a WPA network, or if it is an Ethernet, Bluetooth, WWAN, etc connection that is incompatible with the -device. -

-

-This function does the same as nm_device_connection_valid(), i.e. checking +device.

+

This function does the same as nm_device_connection_valid(), i.e. checking compatibility of the given device and connection. But, in addition, it sets -GError when FALSE is returned. -

-
+GError when FALSE is returned.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + + - - + + +

device :

an NMDevice to validate connection against

connection :

an NMConnection to validate against device -

device

an NMDevice to validate connection +against

 

error :

return location for a GError, or NULL -

connection

an NMConnection to validate against device +

 

Returns :

-TRUE if the connection may be activated with this device, FALSE -if is incompatible with the device's capabilities and characteristics.

error

return location for a GError, or NULL

 
+
+

Returns

+

TRUE if the connection may be activated with this device, FALSE +if is incompatible with the device's capabilities and characteristics.

+

+
+ +
+
+

nm_device_get_setting_type ()

+
GType
+nm_device_get_setting_type (NMDevice *device);
+

Gets the (primary) NMSetting subtype associated with connections +that can be used on device +.

+
+

Parameters

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

device

an NMDevice

 
+
+
+

Returns

+

device +'s associated NMSetting type

+

+
+

Since 0.9.10

+

-

nm_device_get_setting_type ()

-
GType               nm_device_get_setting_type          (NMDevice *device);
+

NMDeviceDeactivateFn ()

+
void
+(*NMDeviceDeactivateFn) (NMDevice *device,
+                         GError *error,
+                         gpointer user_data);
+

NMDeviceDeactivateFn is deprecated and should not be used in newly-written code.

-Gets the (primary) NMSetting subtype associated with connections -that can be used on device.

-
+ + +
+

Types and Values

+
+

enum NMDeviceError

+
+

Members

+
--+++ - - + + - - + + +

device :

an NMDevice +

NM_DEVICE_ERROR_UNKNOWN

+

unknown or unclassified error

 

Returns :

-device's associated NMSetting type

NM_DEVICE_ERROR_INTERFACE_MISMATCH

+

the interface names of the connection and the + device mismatched

+
 
-

Since 0.9.10

+

-

NMDeviceDeactivateFn ()

-
void                (*NMDeviceDeactivateFn)             (NMDevice *device,
-                                                         GError *error,
-                                                         gpointer user_data);
+

NM_DEVICE_ERROR

+
#define NM_DEVICE_ERROR nm_device_error_quark ()
+

- -
-

Property Details

+
-

The "active-connection" property

-
  "active-connection"        NMActiveConnection*   : Read
+

NM_DEVICE_DEVICE_TYPE

+
#define NM_DEVICE_DEVICE_TYPE "device-type"
+

-The NMActiveConnection object that "owns" this device during activation.


-

The "autoconnect" property

-
  "autoconnect"              gboolean              : Read / Write
+

NM_DEVICE_UDI

+
#define NM_DEVICE_UDI "udi"
+

-Whether the device can auto-activate a connection.

-

Default value: TRUE


-

The "available-connections" property

-
  "available-connections"    NMObjectArray*        : Read
+

NM_DEVICE_INTERFACE

+
#define NM_DEVICE_INTERFACE "interface"
+

-The available connections (NMRemoteConnection) of the device

-

Since 0.9.8


-

The "capabilities" property

-
  "capabilities"             guint                 : Read
+

NM_DEVICE_IP_INTERFACE

+
#define NM_DEVICE_IP_INTERFACE "ip-interface"
+

-The capabilities of the device.

-

Default value: 0


-

The "device-type" property

-
  "device-type"              guint                 : Read
+

NM_DEVICE_DRIVER

+
#define NM_DEVICE_DRIVER "driver"
+

-The numeric type of the device.

-

Default value: 0


-

The "dhcp4-config" property

-
  "dhcp4-config"             NMDHCP4Config*        : Read
+

NM_DEVICE_DRIVER_VERSION

+
#define NM_DEVICE_DRIVER_VERSION "driver-version"
+

-The NMDHCP4Config of the device.


-

The "dhcp6-config" property

-
  "dhcp6-config"             NMDHCP6Config*        : Read
+

NM_DEVICE_FIRMWARE_VERSION

+
#define NM_DEVICE_FIRMWARE_VERSION "firmware-version"
+

-The NMDHCP6Config of the device.


-

The "driver" property

-
  "driver"                   gchar*                : Read
+

NM_DEVICE_CAPABILITIES

+
#define NM_DEVICE_CAPABILITIES "capabilities"
+

-The driver of the device.

-

Default value: NULL


-

The "driver-version" property

-
  "driver-version"           gchar*                : Read
+

NM_DEVICE_MANAGED

+
#define NM_DEVICE_MANAGED "managed"
+

-The version of the device driver.

-

Default value: NULL


-

The "firmware-missing" property

-
  "firmware-missing"         gboolean              : Read
+

NM_DEVICE_AUTOCONNECT

+
#define NM_DEVICE_AUTOCONNECT "autoconnect"
+

-When TRUE indicates the device is likely missing firmware required -for its operation.

-

Default value: FALSE


-

The "firmware-version" property

-
  "firmware-version"         gchar*                : Read
+

NM_DEVICE_FIRMWARE_MISSING

+
#define NM_DEVICE_FIRMWARE_MISSING "firmware-missing"
+

-The firmware version of the device.

-

Default value: NULL


-

The "interface" property

-
  "interface"                gchar*                : Read
+

NM_DEVICE_IP4_CONFIG

+
#define NM_DEVICE_IP4_CONFIG "ip4-config"
+

-The interface of the device.

-

Default value: NULL


-

The "ip-interface" property

-
  "ip-interface"             gchar*                : Read
+

NM_DEVICE_DHCP4_CONFIG

+
#define NM_DEVICE_DHCP4_CONFIG "dhcp4-config"
+

-The IP interface of the device which should be used for all IP-related -operations like addressing and routing.

-

Default value: NULL


-

The "ip4-config" property

-
  "ip4-config"               NMIP4Config*          : Read
+

NM_DEVICE_IP6_CONFIG

+
#define NM_DEVICE_IP6_CONFIG "ip6-config"
+

-The NMIP4Config of the device.


-

The "ip6-config" property

-
  "ip6-config"               NMIP6Config*          : Read
+

NM_DEVICE_DHCP6_CONFIG

+
#define NM_DEVICE_DHCP6_CONFIG "dhcp6-config"
+

-The NMIP6Config of the device.


-

The "managed" property

-
  "managed"                  gboolean              : Read
+

NM_DEVICE_STATE

+
#define NM_DEVICE_STATE "state"
+

-Whether the device is managed by NetworkManager.

-

Default value: FALSE


-

The "mtu" property

-
  "mtu"                      guint                 : Read
+

NM_DEVICE_STATE_REASON

+
#define NM_DEVICE_STATE_REASON "state-reason"
+

-The MTU of the device.

-

Default value: 1500

-

Since 0.9.10


-

The "physical-port-id" property

-
  "physical-port-id"         gchar*                : Read
+

NM_DEVICE_ACTIVE_CONNECTION

+
#define NM_DEVICE_ACTIVE_CONNECTION "active-connection"
+

-The physical port ID of the device. (See -nm_device_get_physical_port_id().)

-

Default value: NULL

-

Since 0.9.10


-

The "product" property

-
  "product"                  gchar*                : Read
+

NM_DEVICE_AVAILABLE_CONNECTIONS

+
#define NM_DEVICE_AVAILABLE_CONNECTIONS "available-connections"
+

-The product string of the device.

-

Default value: NULL


-

The "state" property

-
  "state"                    guint                 : Read
+

NM_DEVICE_VENDOR

+
#define NM_DEVICE_VENDOR "vendor"
+

-The state of the device.

-

Default value: 0


-

The "state-reason" property

-
  "state-reason"             GValueArray_guint+guint_*  : Read
+

NM_DEVICE_PRODUCT

+
#define NM_DEVICE_PRODUCT "product"
+

-The state and reason of the device.


-

The "udi" property

-
  "udi"                      gchar*                : Read
+

NM_DEVICE_PHYSICAL_PORT_ID

+
#define NM_DEVICE_PHYSICAL_PORT_ID "physical-port-id"
+

-An operating-system specific device hardware identifier; this is not -unique to a specific hardware device across reboots or hotplugs. It -is an opaque string which for some device types (Bluetooth, Modem) -contains an identifier provided by the underlying hardware service daemon -such as Bluez or ModemManager, and clients can use this property to -request more information about the device from those services.

-

Default value: NULL


-

The "vendor" property

-
  "vendor"                   gchar*                : Read
+

NM_DEVICE_MTU

+
#define NM_DEVICE_MTU "mtu"
+

-The vendor string of the device.

+
+
+
+

Property Details

+
+

The “active-connection” property

+
  “active-connection”        NMActiveConnection *
+

+

Flags: Read

+
+
+
+

The “autoconnect” property

+
  “autoconnect”              gboolean
+

+

Flags: Read / Write

+

Default value: TRUE

+
+
+
+

The “available-connections” property

+
  “available-connections”    NMObjectArray *
+

+

Flags: Read

+

Since 0.9.8

+
+
+
+

The “capabilities” property

+
  “capabilities”             guint
+

+

Flags: Read

+

Default value: 0

+
+
+
+

The “device-type” property

+
  “device-type”              guint
+

+

Flags: Read

+

Default value: 0

+
+
+
+

The “dhcp4-config” property

+
  “dhcp4-config”             NMDHCP4Config *
+

+

Flags: Read

+
+
+
+

The “dhcp6-config” property

+
  “dhcp6-config”             NMDHCP6Config *
+

+

Flags: Read

+
+
+
+

The “driver” property

+
  “driver”                   gchar *
+

+

Flags: Read

+

Default value: NULL

+
+
+
+

The “driver-version” property

+
  “driver-version”           gchar *
+

+

Flags: Read

+

Default value: NULL

+
+
+
+

The “firmware-missing” property

+
  “firmware-missing”         gboolean
+

+

Flags: Read

+

Default value: FALSE

+
+
+
+

The “firmware-version” property

+
  “firmware-version”         gchar *
+

+

Flags: Read

+

Default value: NULL

+
+
+
+

The “interface” property

+
  “interface”                gchar *
+

+

Flags: Read

+

Default value: NULL

+
+
+
+

The “ip-interface” property

+
  “ip-interface”             gchar *
+

+

Flags: Read

+

Default value: NULL

+
+
+
+

The “ip4-config” property

+
  “ip4-config”               NMIP4Config *
+

+

Flags: Read

+
+
+
+

The “ip6-config” property

+
  “ip6-config”               NMIP6Config *
+

+

Flags: Read

+
+
+
+

The “managed” property

+
  “managed”                  gboolean
+

+

Flags: Read

+

Default value: FALSE

+
+
+
+

The “mtu” property

+
  “mtu”                      guint
+

+

Flags: Read

+

Default value: 1500

+

Since 0.9.10

+
+
+
+

The “physical-port-id” property

+
  “physical-port-id”         gchar *
+

+

Flags: Read

+

Default value: NULL

+

Since 0.9.10

+
+
+
+

The “product” property

+
  “product”                  gchar *
+

+

Flags: Read

+

Default value: NULL

+
+
+
+

The “state” property

+
  “state”                    guint
+

+

Flags: Read

+

Default value: 0

+
+
+
+

The “state-reason” property

+
  “state-reason”             GValueArray_guint+guint_*
+

+

Flags: Read

+
+
+
+

The “udi” property

+
  “udi”                      gchar *
+

+

Flags: Read

+

Default value: NULL

+
+
+
+

The “vendor” property

+
  “vendor”                   gchar *
+

+

Flags: Read

Default value: NULL

Signal Details

-

The "state-changed" signal

-
void                user_function                      (NMDevice *device,
-                                                        guint     new_state,
-                                                        guint     old_state,
-                                                        guint     reason,
-                                                        gpointer  user_data)      : Run First
-

-Notifies the state change of a NMDevice. -

-
---- - - - - - - - - - - - - - - - - - - - - - - -

device :

the device object that received the signal

new_state :

the new state of the device

old_state :

the previous state of the device

reason :

the reason describing the state change

user_data :

user data set when the signal handler was connected.
+

The “state-changed” signal

+
void
+user_function (NMDevice *device,
+               guint     new_state,
+               guint     old_state,
+               guint     reason,
+               gpointer  user_data)
+

Flags: Run First

+ Generated by GTK-Doc V1.21 \ No newline at end of file diff --git a/docs/libnm-glib/html/NMDeviceAdsl.html b/docs/libnm-glib/html/NMDeviceAdsl.html index 8f20351f..404fb121 100644 --- a/docs/libnm-glib/html/NMDeviceAdsl.html +++ b/docs/libnm-glib/html/NMDeviceAdsl.html @@ -2,36 +2,28 @@ -NMDeviceAdsl +libnm-glib Reference Manual: NMDeviceAdsl - + - - - - - - - - - - + + + + + + +
@@ -39,40 +31,87 @@

NMDeviceAdsl

NMDeviceAdsl

- +
-
-

Synopsis

-
enum                NMDeviceAdslError;
-#define             NM_DEVICE_ADSL_ERROR
-GQuark              nm_device_adsl_error_quark          (void);
-#define             NM_DEVICE_ADSL_CARRIER
-                    NMDeviceAdsl;
-                    NMDeviceAdslClass;
-GObject *           nm_device_adsl_new                  (DBusGConnection *connection,
-                                                         const char *path);
-gboolean            nm_device_adsl_get_carrier          (NMDeviceAdsl *device);
-
+
+

Functions

+
++++ + + + + + + + + + + + + + + +
+GQuark + +nm_device_adsl_error_quark () +
+GObject * + +nm_device_adsl_new () +
+gboolean + +nm_device_adsl_get_carrier () +
-

Object Hierarchy

-
-  GObject
-   +----NMObject
-         +----NMDevice
-               +----NMDeviceAdsl
-
+

Properties

+
+++++ + + + + + +
gbooleancarrierRead
-

Implemented Interfaces

-

-NMDeviceAdsl implements - GInitable and GAsyncInitable.

+

Types and Values

+
++++ + + + + + + + + + + + + + + +
enumNMDeviceAdslError
#defineNM_DEVICE_ADSL_ERROR
#defineNM_DEVICE_ADSL_CARRIER
-

Properties

-
-  "carrier"                  gboolean              : Read
+

Object Hierarchy

+
    GObject
+    ╰── NMObject
+        ╰── NMDevice
+            ╰── NMDeviceAdsl
 
@@ -81,170 +120,149 @@ NMDeviceAdsl implements

-

Details

+

Functions

-

enum NMDeviceAdslError

-
typedef enum {
-	NM_DEVICE_ADSL_ERROR_UNKNOWN = 0,             /*< nick=UnknownError >*/
-	NM_DEVICE_ADSL_ERROR_NOT_ADSL_CONNECTION,     /*< nick=NotAdslConnection >*/
-	NM_DEVICE_ADSL_ERROR_INVALID_ADSL_CONNECTION, /*< nick=InvalidAdslConnection >*/
-} NMDeviceAdslError;
-
-
+

nm_device_adsl_error_quark ()

+
GQuark
+nm_device_adsl_error_quark (void);
+

Registers an error quark for NMDeviceAdsl if necessary.

+
+

Returns

+

the error quark used for NMDeviceAdsl errors.

+

+
+ +
+
+

nm_device_adsl_new ()

+
GObject *
+nm_device_adsl_new (DBusGConnection *connection,
+                    const char *path);
+

Creates a new NMDeviceAdsl.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + +

NM_DEVICE_ADSL_ERROR_UNKNOWN

unknown or unclassified error -

NM_DEVICE_ADSL_ERROR_NOT_ADSL_CONNECTION

the connection was not of ADSL type -

connection

the DBusGConnection

 

NM_DEVICE_ADSL_ERROR_INVALID_ADSL_CONNECTION

the ADSL connection was invalid -

path

the DBus object path of the device

 
-
-
-

NM_DEVICE_ADSL_ERROR

-
#define NM_DEVICE_ADSL_ERROR nm_device_adsl_error_quark ()
-
-

-

+
+

Returns

+

a new device.

+

[transfer full]

+

-

nm_device_adsl_error_quark ()

-
GQuark              nm_device_adsl_error_quark          (void);
-

-Registers an error quark for NMDeviceAdsl if necessary. -

-
+

nm_device_adsl_get_carrier ()

+
gboolean
+nm_device_adsl_get_carrier (NMDeviceAdsl *device);
+

Whether the device has carrier.

+
+

Parameters

+
--+++ - - + + +

Returns :

the error quark used for NMDeviceAdsl errors.

device

a NMDeviceAdsl

 
-
-
-

NM_DEVICE_ADSL_CARRIER

-
#define NM_DEVICE_ADSL_CARRIER "carrier"
-
-

-

+
+

Returns

+

TRUE if the device has carrier

+

-
-
-

NMDeviceAdsl

-
typedef struct _NMDeviceAdsl NMDeviceAdsl;
-

-

-
-
-

NMDeviceAdslClass

-
typedef struct {
-	NMDeviceClass parent;
-
-	/* Padding for future expansion */
-	void (*_reserved1) (void);
-	void (*_reserved2) (void);
-	void (*_reserved3) (void);
-	void (*_reserved4) (void);
-	void (*_reserved5) (void);
-	void (*_reserved6) (void);
-} NMDeviceAdslClass;
-
-

-

-
+
+

Types and Values

-

nm_device_adsl_new ()

-
GObject *           nm_device_adsl_new                  (DBusGConnection *connection,
-                                                         const char *path);
-

-Creates a new NMDeviceAdsl. -

-
+

enum NMDeviceAdslError

+
+

Members

+
--+++ - - + + - - + + + - - + +

connection :

the DBusGConnection +

NM_DEVICE_ADSL_ERROR_UNKNOWN

+

unknown or unclassified error

 

path :

the DBus object path of the device

NM_DEVICE_ADSL_ERROR_NOT_ADSL_CONNECTION

+

the connection was not of ADSL type

+
 

Returns :

a new device. [transfer full] +

NM_DEVICE_ADSL_ERROR_INVALID_ADSL_CONNECTION

+

the ADSL connection was invalid

 
+

-

nm_device_adsl_get_carrier ()

-
gboolean            nm_device_adsl_get_carrier          (NMDeviceAdsl *device);
+

NM_DEVICE_ADSL_ERROR

+
#define NM_DEVICE_ADSL_ERROR nm_device_adsl_error_quark ()
+
+

+

+
+
+
+

NM_DEVICE_ADSL_CARRIER

+
#define NM_DEVICE_ADSL_CARRIER "carrier"
+

-Whether the device has carrier.

-
---- - - - - - - - - - - -

device :

a NMDeviceAdsl -

Returns :

-TRUE if the device has carrier

Property Details

-

The "carrier" property

-
  "carrier"                  gboolean              : Read
-

-Whether the device has carrier. -

+

The “carrier” property

+
  “carrier”                  gboolean
+

+

Flags: Read

Default value: FALSE

+ Generated by GTK-Doc V1.21
\ No newline at end of file diff --git a/docs/libnm-glib/html/NMDeviceBond.html b/docs/libnm-glib/html/NMDeviceBond.html index 6a708b0b..c79364a9 100644 --- a/docs/libnm-glib/html/NMDeviceBond.html +++ b/docs/libnm-glib/html/NMDeviceBond.html @@ -2,36 +2,28 @@ -NMDeviceBond +libnm-glib Reference Manual: NMDeviceBond - + - - - - - - - - - - + + + + + + +
@@ -39,46 +31,123 @@

NMDeviceBond

NMDeviceBond

- +
-
-

Synopsis

-
enum                NMDeviceBondError;
-#define             NM_DEVICE_BOND_ERROR
-GQuark              nm_device_bond_error_quark          (void);
-#define             NM_DEVICE_BOND_HW_ADDRESS
-#define             NM_DEVICE_BOND_CARRIER
-#define             NM_DEVICE_BOND_SLAVES
-                    NMDeviceBond;
-                    NMDeviceBondClass;
-GObject *           nm_device_bond_new                  (DBusGConnection *connection,
-                                                         const char *path);
-const char *        nm_device_bond_get_hw_address       (NMDeviceBond *device);
-gboolean            nm_device_bond_get_carrier          (NMDeviceBond *device);
-const GPtrArray *   nm_device_bond_get_slaves           (NMDeviceBond *device);
-
+
+

Functions

+
++++ + + + + + + + + + + + + + + + + + + + + + + +
+GQuark + +nm_device_bond_error_quark () +
+GObject * + +nm_device_bond_new () +
const char * + +nm_device_bond_get_hw_address () +
+gboolean + +nm_device_bond_get_carrier () +
const GPtrArray * + +nm_device_bond_get_slaves () +
-

Object Hierarchy

-
-  GObject
-   +----NMObject
-         +----NMDevice
-               +----NMDeviceBond
-
+

Properties

+
+++++ + + + + + + + + + + + + + + + + + +
gbooleancarrierRead
+gchar *hw-addressRead
+NMObjectArray *slavesRead
-

Implemented Interfaces

-

-NMDeviceBond implements - GInitable and GAsyncInitable.

+

Types and Values

+
++++ + + + + + + + + + + + + + + + + + + + + + + +
enumNMDeviceBondError
#defineNM_DEVICE_BOND_ERROR
#defineNM_DEVICE_BOND_HW_ADDRESS
#defineNM_DEVICE_BOND_CARRIER
#defineNM_DEVICE_BOND_SLAVES
-

Properties

-
-  "carrier"                  gboolean              : Read
-  "hw-address"               gchar*                : Read
-  "slaves"                   NMObjectArray*        : Read
+

Object Hierarchy

+
    GObject
+    ╰── NMObject
+        ╰── NMDevice
+            ╰── NMDeviceBond
 
@@ -87,265 +156,248 @@ NMDeviceBond implements

-

Details

+

Functions

-

enum NMDeviceBondError

-
typedef enum {
-	NM_DEVICE_BOND_ERROR_UNKNOWN = 0,             /*< nick=UnknownError >*/
-	NM_DEVICE_BOND_ERROR_NOT_BOND_CONNECTION,     /*< nick=NotBondConnection >*/
-	NM_DEVICE_BOND_ERROR_INVALID_BOND_CONNECTION, /*< nick=InvalidBondConnection >*/
-	NM_DEVICE_BOND_ERROR_INTERFACE_MISMATCH,      /*< nick=InterfaceMismatch >*/
-} NMDeviceBondError;
-
-
+

nm_device_bond_error_quark ()

+
GQuark
+nm_device_bond_error_quark (void);
+

Registers an error quark for NMDeviceBond if necessary.

+
+

Returns

+

the error quark used for NMDeviceBond errors.

+

+
+ +
+
+

nm_device_bond_new ()

+
GObject *
+nm_device_bond_new (DBusGConnection *connection,
+                    const char *path);
+

Creates a new NMDeviceBond.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + - - + + +

NM_DEVICE_BOND_ERROR_UNKNOWN

unknown or unclassified error -

NM_DEVICE_BOND_ERROR_NOT_BOND_CONNECTION

the connection was not of bond type -

NM_DEVICE_BOND_ERROR_INVALID_BOND_CONNECTION

the bond connection was invalid -

connection

the DBusGConnection

 

NM_DEVICE_BOND_ERROR_INTERFACE_MISMATCH

the interfaces of the connection and the device mismatched -

path

the DBus object path of the device

 
-
-
-

NM_DEVICE_BOND_ERROR

-
#define NM_DEVICE_BOND_ERROR nm_device_bond_error_quark ()
-
-

-

+
+

Returns

+

a new device.

+

[transfer full]

+

-

nm_device_bond_error_quark ()

-
GQuark              nm_device_bond_error_quark          (void);
-

-Registers an error quark for NMDeviceBond if necessary. -

-
+

nm_device_bond_get_hw_address ()

+
const char *
+nm_device_bond_get_hw_address (NMDeviceBond *device);
+

Gets the hardware (MAC) address of the NMDeviceBond

+
+

Parameters

+
--+++ - - + + +

Returns :

the error quark used for NMDeviceBond errors.

device

a NMDeviceBond

 
-
-
-

NM_DEVICE_BOND_HW_ADDRESS

-
#define NM_DEVICE_BOND_HW_ADDRESS  "hw-address"
-
-

-

+
+

Returns

+

the hardware address. This is the internal string used by the +device, and must not be modified.

+

-
-
-

NM_DEVICE_BOND_CARRIER

-
#define NM_DEVICE_BOND_CARRIER     "carrier"
-
-

-


-

NM_DEVICE_BOND_SLAVES

-
#define NM_DEVICE_BOND_SLAVES      "slaves"
-
-

-

+

nm_device_bond_get_carrier ()

+
gboolean
+nm_device_bond_get_carrier (NMDeviceBond *device);
+

Whether the device has carrier.

+
+

Parameters

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

device

a NMDeviceBond

 
+
+
+

Returns

+

TRUE if the device has carrier

+

-
-
-

NMDeviceBond

-
typedef struct _NMDeviceBond NMDeviceBond;
-

-


-

NMDeviceBondClass

-
typedef struct {
-	NMDeviceClass parent;
-
-	/* Padding for future expansion */
-	void (*_reserved1) (void);
-	void (*_reserved2) (void);
-	void (*_reserved3) (void);
-	void (*_reserved4) (void);
-	void (*_reserved5) (void);
-	void (*_reserved6) (void);
-} NMDeviceBondClass;
-
-

-

+

nm_device_bond_get_slaves ()

+
const GPtrArray *
+nm_device_bond_get_slaves (NMDeviceBond *device);
+

Gets the devices currently slaved to device +.

+
+

Parameters

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

device

a NMDeviceBond

 
-
+
+

Returns

+

the GPtrArray containing +NMDevices that are slaves of device +. This is the internal +copy used by the device, and must not be modified.

+

[element-type NMDevice]

+
+

Since 0.9.6.4

+
+
+
+

Types and Values

-

nm_device_bond_new ()

-
GObject *           nm_device_bond_new                  (DBusGConnection *connection,
-                                                         const char *path);
-

-Creates a new NMDeviceBond. -

-
+

enum NMDeviceBondError

+
+

Members

+
--+++ - - + + + + + + + - - + + + - - + +

connection :

the DBusGConnection +

NM_DEVICE_BOND_ERROR_UNKNOWN

+

unknown or unclassified error

+
 

NM_DEVICE_BOND_ERROR_NOT_BOND_CONNECTION

+

the connection was not of bond type

 

path :

the DBus object path of the device

NM_DEVICE_BOND_ERROR_INVALID_BOND_CONNECTION

+

the bond connection was invalid

+
 

Returns :

a new device. [transfer full] +

NM_DEVICE_BOND_ERROR_INTERFACE_MISMATCH

+

the interfaces of the connection and the device mismatched

 
+

-

nm_device_bond_get_hw_address ()

-
const char *        nm_device_bond_get_hw_address       (NMDeviceBond *device);
+

NM_DEVICE_BOND_ERROR

+
#define NM_DEVICE_BOND_ERROR nm_device_bond_error_quark ()
+

-Gets the hardware (MAC) address of the NMDeviceBond

-
---- - - - - - - - - - - -

device :

a NMDeviceBond -

Returns :

the hardware address. This is the internal string used by the -device, and must not be modified.

-

nm_device_bond_get_carrier ()

-
gboolean            nm_device_bond_get_carrier          (NMDeviceBond *device);
+

NM_DEVICE_BOND_HW_ADDRESS

+
#define NM_DEVICE_BOND_HW_ADDRESS  "hw-address"
+

-Whether the device has carrier.

-
---- - - - - - - - - - - -

device :

a NMDeviceBond -

Returns :

-TRUE if the device has carrier

-

nm_device_bond_get_slaves ()

-
const GPtrArray *   nm_device_bond_get_slaves           (NMDeviceBond *device);
+

NM_DEVICE_BOND_CARRIER

+
#define NM_DEVICE_BOND_CARRIER     "carrier"
+
+

+

+
+
+
+

NM_DEVICE_BOND_SLAVES

+
#define NM_DEVICE_BOND_SLAVES      "slaves"
+

-Gets the devices currently slaved to device.

-
---- - - - - - - - - - - -

device :

a NMDeviceBond -

Returns :

the GPtrArray containing -NMDevices that are slaves of device. This is the internal -copy used by the device, and must not be modified. [element-type NMDevice] -
-

Since 0.9.6.4

Property Details

-

The "carrier" property

-
  "carrier"                  gboolean              : Read
-

-Whether the device has carrier. -

+

The “carrier” property

+
  “carrier”                  gboolean
+

+

Flags: Read

Default value: FALSE


-

The "hw-address" property

-
  "hw-address"               gchar*                : Read
-

-The hardware (MAC) address of the device. -

+

The “hw-address” property

+
  “hw-address”               gchar *
+

+

Flags: Read

Default value: NULL


-

The "slaves" property

-
  "slaves"                   NMObjectArray*        : Read
-

-The devices (NMDevice) slaved to the bond device. -

+

The “slaves” property

+
  “slaves”                   NMObjectArray *
+

+

Flags: Read

Since 0.9.8

+ Generated by GTK-Doc V1.21
\ No newline at end of file diff --git a/docs/libnm-glib/html/NMDeviceBridge.html b/docs/libnm-glib/html/NMDeviceBridge.html index e2bb740c..192be733 100644 --- a/docs/libnm-glib/html/NMDeviceBridge.html +++ b/docs/libnm-glib/html/NMDeviceBridge.html @@ -2,36 +2,28 @@ -NMDeviceBridge +libnm-glib Reference Manual: NMDeviceBridge - + - - - - - - - - - - + + + + + + +
@@ -39,46 +31,123 @@

NMDeviceBridge

NMDeviceBridge

- +
-
-

Synopsis

-
enum                NMDeviceBridgeError;
-#define             NM_DEVICE_BRIDGE_ERROR
-GQuark              nm_device_bridge_error_quark        (void);
-#define             NM_DEVICE_BRIDGE_HW_ADDRESS
-#define             NM_DEVICE_BRIDGE_CARRIER
-#define             NM_DEVICE_BRIDGE_SLAVES
-                    NMDeviceBridge;
-                    NMDeviceBridgeClass;
-GObject *           nm_device_bridge_new                (DBusGConnection *connection,
-                                                         const char *path);
-const char *        nm_device_bridge_get_hw_address     (NMDeviceBridge *device);
-gboolean            nm_device_bridge_get_carrier        (NMDeviceBridge *device);
-const GPtrArray *   nm_device_bridge_get_slaves         (NMDeviceBridge *device);
-
+
+

Functions

+
++++ + + + + + + + + + + + + + + + + + + + + + + +
+GQuark + +nm_device_bridge_error_quark () +
+GObject * + +nm_device_bridge_new () +
const char * + +nm_device_bridge_get_hw_address () +
+gboolean + +nm_device_bridge_get_carrier () +
const GPtrArray * + +nm_device_bridge_get_slaves () +
-

Object Hierarchy

-
-  GObject
-   +----NMObject
-         +----NMDevice
-               +----NMDeviceBridge
-
+

Properties

+
+++++ + + + + + + + + + + + + + + + + + +
gbooleancarrierRead
+gchar *hw-addressRead
+NMObjectArray *slavesRead
-

Implemented Interfaces

-

-NMDeviceBridge implements - GInitable and GAsyncInitable.

+

Types and Values

+
++++ + + + + + + + + + + + + + + + + + + + + + + +
enumNMDeviceBridgeError
#defineNM_DEVICE_BRIDGE_ERROR
#defineNM_DEVICE_BRIDGE_HW_ADDRESS
#defineNM_DEVICE_BRIDGE_CARRIER
#defineNM_DEVICE_BRIDGE_SLAVES
-

Properties

-
-  "carrier"                  gboolean              : Read
-  "hw-address"               gchar*                : Read
-  "slaves"                   NMObjectArray*        : Read
+

Object Hierarchy

+
    GObject
+    ╰── NMObject
+        ╰── NMDevice
+            ╰── NMDeviceBridge
 
@@ -87,272 +156,255 @@ NMDeviceBridge implements

-

Details

+

Functions

-

enum NMDeviceBridgeError

-
typedef enum {
-	NM_DEVICE_BRIDGE_ERROR_UNKNOWN = 0,               /*< nick=UnknownError >*/
-	NM_DEVICE_BRIDGE_ERROR_NOT_BRIDGE_CONNECTION,     /*< nick=NotBridgeConnection >*/
-	NM_DEVICE_BRIDGE_ERROR_INVALID_BRIDGE_CONNECTION, /*< nick=InvalidBridgeConnection >*/
-	NM_DEVICE_BRIDGE_ERROR_INTERFACE_MISMATCH,        /*< nick=InterfaceMismatch >*/
-} NMDeviceBridgeError;
-
-
+

nm_device_bridge_error_quark ()

+
GQuark
+nm_device_bridge_error_quark (void);
+

Registers an error quark for NMDeviceBridge if necessary.

+
+

Returns

+

the error quark used for NMDeviceBridge errors.

+

+
+

Since 0.9.8

+ +
+
+

nm_device_bridge_new ()

+
GObject *
+nm_device_bridge_new (DBusGConnection *connection,
+                      const char *path);
+

Creates a new NMDeviceBridge.

+
+

Parameters

+
--+++ - - - - - - + + + - - - - - - + + +

NM_DEVICE_BRIDGE_ERROR_UNKNOWN

unknown or unclassified error -

NM_DEVICE_BRIDGE_ERROR_NOT_BRIDGE_CONNECTION

the connection was not of bridge type -

connection

the DBusGConnection

 

NM_DEVICE_BRIDGE_ERROR_INVALID_BRIDGE_CONNECTION

the bridge connection was invalid -

NM_DEVICE_BRIDGE_ERROR_INTERFACE_MISMATCH

the interfaces of the connection and the device mismatched -

path

the DBus object path of the device

 
-

Since 0.9.8

-
-
-

NM_DEVICE_BRIDGE_ERROR

-
#define NM_DEVICE_BRIDGE_ERROR nm_device_bridge_error_quark ()
-
-

-

+
+

Returns

+

a new device.

+

[transfer full]

+
+

Since 0.9.8


-

nm_device_bridge_error_quark ()

-
GQuark              nm_device_bridge_error_quark        (void);
-

-Registers an error quark for NMDeviceBridge if necessary. -

-
+

nm_device_bridge_get_hw_address ()

+
const char *
+nm_device_bridge_get_hw_address (NMDeviceBridge *device);
+

Gets the hardware (MAC) address of the NMDeviceBridge

+
+

Parameters

+
--+++ - - + + +

Returns :

the error quark used for NMDeviceBridge errors.

device

a NMDeviceBridge

 
+
+
+

Returns

+

the hardware address. This is the internal string used by the +device, and must not be modified.

+

+

Since 0.9.8


-

NM_DEVICE_BRIDGE_HW_ADDRESS

-
#define NM_DEVICE_BRIDGE_HW_ADDRESS  "hw-address"
-
-

-

+

nm_device_bridge_get_carrier ()

+
gboolean
+nm_device_bridge_get_carrier (NMDeviceBridge *device);
+

Whether the device has carrier.

+
+

Parameters

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

device

a NMDeviceBridge

 
-
-
-

NM_DEVICE_BRIDGE_CARRIER

-
#define NM_DEVICE_BRIDGE_CARRIER     "carrier"
-
-

-

+
+

Returns

+

TRUE if the device has carrier

+

-
-
-

NM_DEVICE_BRIDGE_SLAVES

-
#define NM_DEVICE_BRIDGE_SLAVES      "slaves"
-
-

-

+

Since 0.9.8


-

NMDeviceBridge

-
typedef struct _NMDeviceBridge NMDeviceBridge;
-

-

+

nm_device_bridge_get_slaves ()

+
const GPtrArray *
+nm_device_bridge_get_slaves (NMDeviceBridge *device);
+

Gets the devices currently slaved to device +.

+
+

Parameters

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

device

a NMDeviceBridge

 
-
-
-

NMDeviceBridgeClass

-
typedef struct {
-	NMDeviceClass parent;
-
-	/* Padding for future expansion */
-	void (*_reserved1) (void);
-	void (*_reserved2) (void);
-	void (*_reserved3) (void);
-	void (*_reserved4) (void);
-	void (*_reserved5) (void);
-	void (*_reserved6) (void);
-} NMDeviceBridgeClass;
-
-

-

+
+

Returns

+

the GPtrArray containing +NMDevices that are slaves of device +. This is the internal +copy used by the device, and must not be modified.

+

[element-type NMDevice]

-
+

Since 0.9.8

+
+
+
+

Types and Values

-

nm_device_bridge_new ()

-
GObject *           nm_device_bridge_new                (DBusGConnection *connection,
-                                                         const char *path);
-

-Creates a new NMDeviceBridge. -

-
+

enum NMDeviceBridgeError

+
+

Members

+
--+++ - - + + + + + + + - - + + + - - + +

connection :

the DBusGConnection +

NM_DEVICE_BRIDGE_ERROR_UNKNOWN

+

unknown or unclassified error

+
 

NM_DEVICE_BRIDGE_ERROR_NOT_BRIDGE_CONNECTION

+

the connection was not of bridge type

 

path :

the DBus object path of the device

NM_DEVICE_BRIDGE_ERROR_INVALID_BRIDGE_CONNECTION

+

the bridge connection was invalid

+
 

Returns :

a new device. [transfer full] +

NM_DEVICE_BRIDGE_ERROR_INTERFACE_MISMATCH

+

the interfaces of the connection and the device mismatched

 
+

Since 0.9.8


-

nm_device_bridge_get_hw_address ()

-
const char *        nm_device_bridge_get_hw_address     (NMDeviceBridge *device);
+

NM_DEVICE_BRIDGE_ERROR

+
#define NM_DEVICE_BRIDGE_ERROR nm_device_bridge_error_quark ()
+

-Gets the hardware (MAC) address of the NMDeviceBridge

-
---- - - - - - - - - - - -

device :

a NMDeviceBridge -

Returns :

the hardware address. This is the internal string used by the -device, and must not be modified.
-

Since 0.9.8


-

nm_device_bridge_get_carrier ()

-
gboolean            nm_device_bridge_get_carrier        (NMDeviceBridge *device);
+

NM_DEVICE_BRIDGE_HW_ADDRESS

+
#define NM_DEVICE_BRIDGE_HW_ADDRESS  "hw-address"
+

-Whether the device has carrier.

-
---- - - - - - - - - - - -

device :

a NMDeviceBridge -

Returns :

-TRUE if the device has carrier
-

Since 0.9.8


-

nm_device_bridge_get_slaves ()

-
const GPtrArray *   nm_device_bridge_get_slaves         (NMDeviceBridge *device);
+

NM_DEVICE_BRIDGE_CARRIER

+
#define NM_DEVICE_BRIDGE_CARRIER     "carrier"
+
+

+

+
+
+
+

NM_DEVICE_BRIDGE_SLAVES

+
#define NM_DEVICE_BRIDGE_SLAVES      "slaves"
+

-Gets the devices currently slaved to device.

-
---- - - - - - - - - - - -

device :

a NMDeviceBridge -

Returns :

the GPtrArray containing -NMDevices that are slaves of device. This is the internal -copy used by the device, and must not be modified. [element-type NMDevice] -
-

Since 0.9.8

Property Details

-

The "carrier" property

-
  "carrier"                  gboolean              : Read
-

-Whether the device has carrier. -

+

The “carrier” property

+
  “carrier”                  gboolean
+

+

Flags: Read

Default value: FALSE

Since 0.9.8


-

The "hw-address" property

-
  "hw-address"               gchar*                : Read
-

-The hardware (MAC) address of the device. -

+

The “hw-address” property

+
  “hw-address”               gchar *
+

+

Flags: Read

Default value: NULL

Since 0.9.8


-

The "slaves" property

-
  "slaves"                   NMObjectArray*        : Read
-

-The devices (NMDevice) slaved to the bridge device. -

+

The “slaves” property

+
  “slaves”                   NMObjectArray *
+

+

Flags: Read

Since 0.9.8

+ Generated by GTK-Doc V1.21
\ No newline at end of file diff --git a/docs/libnm-glib/html/NMDeviceBt.html b/docs/libnm-glib/html/NMDeviceBt.html index c3a5325a..816f671d 100644 --- a/docs/libnm-glib/html/NMDeviceBt.html +++ b/docs/libnm-glib/html/NMDeviceBt.html @@ -2,36 +2,28 @@ -NMDeviceBt +libnm-glib Reference Manual: NMDeviceBt - + - - - - - - - - - - + + + + + + +
@@ -39,321 +31,382 @@

NMDeviceBt

NMDeviceBt

- +
-
-

Object Hierarchy

-
-  GObject
-   +----NMObject
-         +----NMDevice
-               +----NMDeviceBt
-
-
-
-

Implemented Interfaces

-

-NMDeviceBt implements - GInitable and GAsyncInitable.

-
-
-

Properties

-
-  "bt-capabilities"          guint                 : Read
-  "hw-address"               gchar*                : Read
-  "name"                     gchar*                : Read
-
-
-
-

Description

-

-

-
-
-

Details

-
-

enum NMDeviceBtError

-
typedef enum {
-	NM_DEVICE_BT_ERROR_UNKNOWN = 0,           /*< nick=UnknownError >*/
-	NM_DEVICE_BT_ERROR_NOT_BT_CONNECTION,     /*< nick=NotBtConnection >*/
-	NM_DEVICE_BT_ERROR_INVALID_BT_CONNECTION, /*< nick=InvalidBtConnection >*/
-	NM_DEVICE_BT_ERROR_INVALID_DEVICE_MAC,    /*< nick=InvalidDeviceMac >*/
-	NM_DEVICE_BT_ERROR_MAC_MISMATCH,          /*< nick=MacMismatch >*/
-	NM_DEVICE_BT_ERROR_MISSING_DEVICE_CAPS,   /*< nick=MissingDeviceCaps >*/
-} NMDeviceBtError;
-
-
+

Functions

+
--++ - - - - - - - - + - - + - - + - - +

NM_DEVICE_BT_ERROR_UNKNOWN

unknown or unclassified error + +GQuark

NM_DEVICE_BT_ERROR_NOT_BT_CONNECTION

the connection was not of bluetooth type + +nm_device_bt_error_quark ()

NM_DEVICE_BT_ERROR_INVALID_BT_CONNECTION

the bluetooth connection was invalid + +GObject * + +nm_device_bt_new ()

NM_DEVICE_BT_ERROR_INVALID_DEVICE_MAC

the device's MAC was invalid +const char * + +nm_device_bt_get_hw_address ()

NM_DEVICE_BT_ERROR_MAC_MISMATCH

the MACs of the connection and the device mismatched +const char * + +nm_device_bt_get_name ()

NM_DEVICE_BT_ERROR_MISSING_DEVICE_CAPS

the device missed required capabilities + +NMBluetoothCapabilities + +nm_device_bt_get_capabilities ()
-
-
-

NM_DEVICE_BT_ERROR

-
#define NM_DEVICE_BT_ERROR nm_device_bt_error_quark ()
-
-

-

+
+

Properties

+
+++++ + + + + + + + + + + + + + + + + + +
guintbt-capabilitiesRead
+gchar *hw-addressRead
+gchar *nameRead
-
-
-

nm_device_bt_error_quark ()

-
GQuark              nm_device_bt_error_quark            (void);
-

-Registers an error quark for NMDeviceBt if necessary. -

-
+
+

Types and Values

+
--++ - - - - + + + + + + + + + + + + + + + + + + + + + +

Returns :

the error quark used for NMDeviceBt errors.
enumNMDeviceBtError
#defineNM_DEVICE_BT_ERROR
#defineNM_DEVICE_BT_HW_ADDRESS
#defineNM_DEVICE_BT_NAME
#defineNM_DEVICE_BT_CAPABILITIES
-
-
-

NM_DEVICE_BT_HW_ADDRESS

-
#define NM_DEVICE_BT_HW_ADDRESS   "hw-address"
+
+

Object Hierarchy

+
    GObject
+    ╰── NMObject
+        ╰── NMDevice
+            ╰── NMDeviceBt
 
-

-

-
-
-

NM_DEVICE_BT_NAME

-
#define NM_DEVICE_BT_NAME         "name"
-
+
+

Description

-
+
+

Functions

-

NM_DEVICE_BT_CAPABILITIES

-
#define NM_DEVICE_BT_CAPABILITIES "bt-capabilities"
-
-

-

+

nm_device_bt_error_quark ()

+
GQuark
+nm_device_bt_error_quark (void);
+

Registers an error quark for NMDeviceBt if necessary.

+
+

Returns

+

the error quark used for NMDeviceBt errors.

+

-
-
-

NMDeviceBt

-
typedef struct _NMDeviceBt NMDeviceBt;
-

-


-

NMDeviceBtClass

-
typedef struct {
-	NMDeviceClass parent;
-
-	/* Padding for future expansion */
-	void (*_reserved1) (void);
-	void (*_reserved2) (void);
-	void (*_reserved3) (void);
-	void (*_reserved4) (void);
-	void (*_reserved5) (void);
-	void (*_reserved6) (void);
-} NMDeviceBtClass;
-
-

-

-
-
-
-

nm_device_bt_new ()

-
GObject *           nm_device_bt_new                    (DBusGConnection *connection,
-                                                         const char *path);
-

-Creates a new NMDeviceBt. -

-
+

nm_device_bt_new ()

+
GObject *
+nm_device_bt_new (DBusGConnection *connection,
+                  const char *path);
+

Creates a new NMDeviceBt.

+
+

Parameters

+
--+++ - - + + + - - - - - - + + +

connection :

the DBusGConnection -

connection

the DBusGConnection

 

path :

the DBus object path of the device

Returns :

a new device. [transfer full] -

path

the DBus object path of the device

 
+
+

Returns

+

a new device.

+

[transfer full]

+
+

-

nm_device_bt_get_hw_address ()

-
const char *        nm_device_bt_get_hw_address         (NMDeviceBt *device);
-

-Gets the hardware (MAC) address of the NMDeviceBt -

-
+

nm_device_bt_get_hw_address ()

+
const char *
+nm_device_bt_get_hw_address (NMDeviceBt *device);
+

Gets the hardware (MAC) address of the NMDeviceBt

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

device :

a NMDeviceBt -

Returns :

the hardware address. This is the internal string used by the -device, and must not be modified.

device

a NMDeviceBt

 
+
+

Returns

+

the hardware address. This is the internal string used by the +device, and must not be modified.

+

+
+

-

nm_device_bt_get_name ()

-
const char *        nm_device_bt_get_name               (NMDeviceBt *device);
-

-Gets the name of the NMDeviceBt. -

-
+

nm_device_bt_get_name ()

+
const char *
+nm_device_bt_get_name (NMDeviceBt *device);
+

Gets the name of the NMDeviceBt.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

device :

a NMDeviceBt -

Returns :

the name of the device

device

a NMDeviceBt

 
+
+

Returns

+

the name of the device

+

+
+

-

nm_device_bt_get_capabilities ()

-
NMBluetoothCapabilities nm_device_bt_get_capabilities   (NMDeviceBt *device);
-

-Returns the Bluetooth device's usable capabilities. -

-
+

nm_device_bt_get_capabilities ()

+
NMBluetoothCapabilities
+nm_device_bt_get_capabilities (NMDeviceBt *device);
+

Returns the Bluetooth device's usable capabilities.

+
+

Parameters

+
--++++ + + + + + +

device

a NMDeviceBt

 
+
+
+

Returns

+

a combination of NMBluetoothCapabilities

+

+
+
+
+
+

Types and Values

+
+

enum NMDeviceBtError

+
+

Members

+
++++ - - + + + + + + + + + + + + + + + + + + + + + + - - + +

device :

a NMDeviceBt +

NM_DEVICE_BT_ERROR_UNKNOWN

+

unknown or unclassified error

+
 

NM_DEVICE_BT_ERROR_NOT_BT_CONNECTION

+

the connection was not of bluetooth type

+
 

NM_DEVICE_BT_ERROR_INVALID_BT_CONNECTION

+

the bluetooth connection was invalid

+
 

NM_DEVICE_BT_ERROR_INVALID_DEVICE_MAC

+

the device's MAC was invalid

+
 

NM_DEVICE_BT_ERROR_MAC_MISMATCH

+

the MACs of the connection and the device mismatched

 

Returns :

a combination of NMBluetoothCapabilities +

NM_DEVICE_BT_ERROR_MISSING_DEVICE_CAPS

+

the device missed required capabilities

 
-
-

Property Details

+
-

The "bt-capabilities" property

-
  "bt-capabilities"          guint                 : Read
+

NM_DEVICE_BT_ERROR

+
#define NM_DEVICE_BT_ERROR nm_device_bt_error_quark ()
+

-The device's bluetooth capabilities, a combination of NMBluetoothCapabilities.

-

Default value: 0


-

The "hw-address" property

-
  "hw-address"               gchar*                : Read
+

NM_DEVICE_BT_HW_ADDRESS

+
#define NM_DEVICE_BT_HW_ADDRESS   "hw-address"
+

-The hardware (MAC) address of the device.

-

Default value: NULL


-

The "name" property

-
  "name"                     gchar*                : Read
+

NM_DEVICE_BT_NAME

+
#define NM_DEVICE_BT_NAME         "name"
+
+

+

+
+
+
+

NM_DEVICE_BT_CAPABILITIES

+
#define NM_DEVICE_BT_CAPABILITIES "bt-capabilities"
+

-The name of the bluetooth device.

+
+
+
+

Property Details

+
+

The “bt-capabilities” property

+
  “bt-capabilities”          guint
+

+

Flags: Read

+

Default value: 0

+
+
+
+

The “hw-address” property

+
  “hw-address”               gchar *
+

+

Flags: Read

+

Default value: NULL

+
+
+
+

The “name” property

+
  “name”                     gchar *
+

+

Flags: Read

Default value: NULL

+ Generated by GTK-Doc V1.21
\ No newline at end of file diff --git a/docs/libnm-glib/html/NMDeviceEthernet.html b/docs/libnm-glib/html/NMDeviceEthernet.html index 96c3a074..86f4898c 100644 --- a/docs/libnm-glib/html/NMDeviceEthernet.html +++ b/docs/libnm-glib/html/NMDeviceEthernet.html @@ -2,36 +2,28 @@ -NMDeviceEthernet +libnm-glib Reference Manual: NMDeviceEthernet - + - - - - - - - - - - + + + + + + +
@@ -39,363 +31,437 @@

NMDeviceEthernet

NMDeviceEthernet

- +
- -
-

Object Hierarchy

-
-  GObject
-   +----NMObject
-         +----NMDevice
-               +----NMDeviceEthernet
-
-
-
-

Implemented Interfaces

-

-NMDeviceEthernet implements - GInitable and GAsyncInitable.

-
-
-

Properties

-
-  "carrier"                  gboolean              : Read
-  "hw-address"               gchar*                : Read
-  "perm-hw-address"          gchar*                : Read
-  "speed"                    guint                 : Read
-
-
-

Description

-

-

-
-
-

Details

-
-

enum NMDeviceEthernetError

-
typedef enum {
-	NM_DEVICE_ETHERNET_ERROR_UNKNOWN = 0,                 /*< nick=UnknownError >*/
-	NM_DEVICE_ETHERNET_ERROR_NOT_ETHERNET_CONNECTION,     /*< nick=NotEthernetConnection >*/
-	NM_DEVICE_ETHERNET_ERROR_INVALID_ETHERNET_CONNECTION, /*< nick=InvalidEthernetConnection >*/
-	NM_DEVICE_ETHERNET_ERROR_INVALID_DEVICE_MAC,          /*< nick=InvalidDeviceMac >*/
-	NM_DEVICE_ETHERNET_ERROR_MAC_MISMATCH,                /*< nick=MacMismatch >*/
-} NMDeviceEthernetError;
-
-
+

Functions

+
--++ - - + - - + + + + + - - + - - + - - +

NM_DEVICE_ETHERNET_ERROR_UNKNOWN

unknown or unclassified error + +GQuark + +nm_device_ethernet_error_quark ()

NM_DEVICE_ETHERNET_ERROR_NOT_ETHERNET_CONNECTION

the connection was not of Ethernet or PPPoE type + +GObject * + +nm_device_ethernet_new () +
const char * + +nm_device_ethernet_get_hw_address ()

NM_DEVICE_ETHERNET_ERROR_INVALID_ETHERNET_CONNECTION

the Ethernet connection was invalid +const char * + +nm_device_ethernet_get_permanent_hw_address ()

NM_DEVICE_ETHERNET_ERROR_INVALID_DEVICE_MAC

the device's MAC was invalid + +guint32 + +nm_device_ethernet_get_speed ()

NM_DEVICE_ETHERNET_ERROR_MAC_MISMATCH

the MACs of the connection and the device mismatched + +gboolean + +nm_device_ethernet_get_carrier ()
-
-
-

NM_DEVICE_ETHERNET_ERROR

-
#define NM_DEVICE_ETHERNET_ERROR nm_device_ethernet_error_quark ()
-
-

-

-
-
-
-

nm_device_ethernet_error_quark ()

-
GQuark              nm_device_ethernet_error_quark      (void);
-

-Registers an error quark for NMDeviceEthernet if necessary. -

-
+
+

Properties

+
--+++ - - - - + + + + + + + + + + + + + + + + + + + + + +

Returns :

the error quark used for NMDeviceEthernet errors.
gbooleancarrierRead
+gchar *hw-addressRead
+gchar *perm-hw-addressRead
guintspeedRead
-
-
-

NM_DEVICE_ETHERNET_HW_ADDRESS

-
#define NM_DEVICE_ETHERNET_HW_ADDRESS  "hw-address"
-
-

-

-
-
-
-

NM_DEVICE_ETHERNET_PERMANENT_HW_ADDRESS

-
#define NM_DEVICE_ETHERNET_PERMANENT_HW_ADDRESS "perm-hw-address"
-
-

-

+
+

Types and Values

+
-
-
-

NM_DEVICE_ETHERNET_SPEED

-
#define NM_DEVICE_ETHERNET_SPEED       "speed"
+
+

Object Hierarchy

+
    GObject
+    ╰── NMObject
+        ╰── NMDevice
+            ╰── NMDeviceEthernet
 
-

-

-
-
-

NM_DEVICE_ETHERNET_CARRIER

-
#define NM_DEVICE_ETHERNET_CARRIER     "carrier"
-
+
+

Description

-
+
+

Functions

-

NMDeviceEthernet

-
typedef struct _NMDeviceEthernet NMDeviceEthernet;
-

-

+

nm_device_ethernet_error_quark ()

+
GQuark
+nm_device_ethernet_error_quark (void);
+

Registers an error quark for NMDeviceEthernet if necessary.

+
+

Returns

+

the error quark used for NMDeviceEthernet errors.

+

-
-
-

NMDeviceEthernetClass

-
typedef struct {
-	NMDeviceClass parent;
-
-	/* Padding for future expansion */
-	void (*_reserved1) (void);
-	void (*_reserved2) (void);
-	void (*_reserved3) (void);
-	void (*_reserved4) (void);
-	void (*_reserved5) (void);
-	void (*_reserved6) (void);
-} NMDeviceEthernetClass;
-
-

-


-

nm_device_ethernet_new ()

-
GObject *           nm_device_ethernet_new              (DBusGConnection *connection,
-                                                         const char *path);
-

-Creates a new NMDeviceEthernet. -

-
+

nm_device_ethernet_new ()

+
GObject *
+nm_device_ethernet_new (DBusGConnection *connection,
+                        const char *path);
+

Creates a new NMDeviceEthernet.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + +

connection :

the DBusGConnection -

path :

the DBus object path of the device

connection

the DBusGConnection

 

Returns :

a new device. [transfer full] -

path

the DBus object path of the device

 
+
+

Returns

+

a new device.

+

[transfer full]

+
+

-

nm_device_ethernet_get_hw_address ()

-
const char *        nm_device_ethernet_get_hw_address   (NMDeviceEthernet *device);
-

-Gets the active hardware (MAC) address of the NMDeviceEthernet -

-
+

nm_device_ethernet_get_hw_address ()

+
const char *
+nm_device_ethernet_get_hw_address (NMDeviceEthernet *device);
+

Gets the active hardware (MAC) address of the NMDeviceEthernet

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

device :

a NMDeviceEthernet -

Returns :

the active hardware address. This is the internal string used by the -device, and must not be modified.

device

a NMDeviceEthernet

 
+
+

Returns

+

the active hardware address. This is the internal string used by the +device, and must not be modified.

+

+
+

-

nm_device_ethernet_get_permanent_hw_address ()

-
const char *        nm_device_ethernet_get_permanent_hw_address
-                                                        (NMDeviceEthernet *device);
-

-Gets the permanent hardware (MAC) address of the NMDeviceEthernet -

-
+

nm_device_ethernet_get_permanent_hw_address ()

+
const char *
+nm_device_ethernet_get_permanent_hw_address
+                               (NMDeviceEthernet *device);
+

Gets the permanent hardware (MAC) address of the NMDeviceEthernet

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

device :

a NMDeviceEthernet -

Returns :

the permanent hardware address. This is the internal string used by the -device, and must not be modified.

device

a NMDeviceEthernet

 
+
+

Returns

+

the permanent hardware address. This is the internal string used by the +device, and must not be modified.

+

+
+

-

nm_device_ethernet_get_speed ()

-
guint32             nm_device_ethernet_get_speed        (NMDeviceEthernet *device);
-

-Gets the speed of the NMDeviceEthernet. -

-
+

nm_device_ethernet_get_speed ()

+
guint32
+nm_device_ethernet_get_speed (NMDeviceEthernet *device);
+

Gets the speed of the NMDeviceEthernet.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

device :

a NMDeviceEthernet -

Returns :

the speed of the device

device

a NMDeviceEthernet

 
+
+

Returns

+

the speed of the device

+

+
+

-

nm_device_ethernet_get_carrier ()

-
gboolean            nm_device_ethernet_get_carrier      (NMDeviceEthernet *device);
-

-Whether the device has carrier. -

-
+

nm_device_ethernet_get_carrier ()

+
gboolean
+nm_device_ethernet_get_carrier (NMDeviceEthernet *device);
+

Whether the device has carrier.

+
+

Parameters

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

device

a NMDeviceEthernet

 
+
+
+

Returns

+

TRUE if the device has carrier

+

+
+
+
+
+

Types and Values

+
+

enum NMDeviceEthernetError

+
+

Members

+
--+++ - - + + - - + + + + + + + + + + + + + + + + + +

device :

a NMDeviceEthernet +

NM_DEVICE_ETHERNET_ERROR_UNKNOWN

+

unknown or unclassified error

 

Returns :

-TRUE if the device has carrier

NM_DEVICE_ETHERNET_ERROR_NOT_ETHERNET_CONNECTION

+

the connection was not of Ethernet or PPPoE type

+
 

NM_DEVICE_ETHERNET_ERROR_INVALID_ETHERNET_CONNECTION

+

the Ethernet connection was invalid

+
 

NM_DEVICE_ETHERNET_ERROR_INVALID_DEVICE_MAC

+

the device's MAC was invalid

+
 

NM_DEVICE_ETHERNET_ERROR_MAC_MISMATCH

+

the MACs of the connection and the device mismatched

+
 
-
-

Property Details

+
-

The "carrier" property

-
  "carrier"                  gboolean              : Read
+

NM_DEVICE_ETHERNET_ERROR

+
#define NM_DEVICE_ETHERNET_ERROR nm_device_ethernet_error_quark ()
+

-Whether the device has carrier.

-

Default value: FALSE


-

The "hw-address" property

-
  "hw-address"               gchar*                : Read
+

NM_DEVICE_ETHERNET_HW_ADDRESS

+
#define NM_DEVICE_ETHERNET_HW_ADDRESS  "hw-address"
+

-The active hardware (MAC) address of the device.

-

Default value: NULL


-

The "perm-hw-address" property

-
  "perm-hw-address"          gchar*                : Read
+

NM_DEVICE_ETHERNET_PERMANENT_HW_ADDRESS

+
#define NM_DEVICE_ETHERNET_PERMANENT_HW_ADDRESS "perm-hw-address"
+

-The permanent hardware (MAC) address of the device.

-

Default value: NULL


-

The "speed" property

-
  "speed"                    guint                 : Read
+

NM_DEVICE_ETHERNET_SPEED

+
#define NM_DEVICE_ETHERNET_SPEED       "speed"
+
+

+

+
+
+
+

NM_DEVICE_ETHERNET_CARRIER

+
#define NM_DEVICE_ETHERNET_CARRIER     "carrier"
+

-The speed of the device.

+
+
+
+

Property Details

+
+

The “carrier” property

+
  “carrier”                  gboolean
+

+

Flags: Read

+

Default value: FALSE

+
+
+
+

The “hw-address” property

+
  “hw-address”               gchar *
+

+

Flags: Read

+

Default value: NULL

+
+
+
+

The “perm-hw-address” property

+
  “perm-hw-address”          gchar *
+

+

Flags: Read

+

Default value: NULL

+
+
+
+

The “speed” property

+
  “speed”                    guint
+

+

Flags: Read

Default value: 0

+ Generated by GTK-Doc V1.21
\ No newline at end of file diff --git a/docs/libnm-glib/html/NMDeviceGeneric.html b/docs/libnm-glib/html/NMDeviceGeneric.html index adc23c0b..e663d8d7 100644 --- a/docs/libnm-glib/html/NMDeviceGeneric.html +++ b/docs/libnm-glib/html/NMDeviceGeneric.html @@ -2,36 +2,28 @@ -NMDeviceGeneric +libnm-glib Reference Manual: NMDeviceGeneric - + - - - - - - - - - - + + + + + + +
@@ -39,42 +31,99 @@

NMDeviceGeneric

NMDeviceGeneric

- +
-
-

Synopsis

-
enum                NMDeviceGenericError;
-#define             NM_DEVICE_GENERIC_ERROR
-GQuark              nm_device_generic_error_quark       (void);
-#define             NM_DEVICE_GENERIC_HW_ADDRESS
-#define             NM_DEVICE_GENERIC_TYPE_DESCRIPTION
-                    NMDeviceGeneric;
-                    NMDeviceGenericClass;
-GObject *           nm_device_generic_new               (DBusGConnection *connection,
-                                                         const char *path);
-const char *        nm_device_generic_get_hw_address    (NMDeviceGeneric *device);
-
+
+

Functions

+
++++ + + + + + + + + + + + + + + +
+GQuark + +nm_device_generic_error_quark () +
+GObject * + +nm_device_generic_new () +
const char * + +nm_device_generic_get_hw_address () +
-

Object Hierarchy

-
-  GObject
-   +----NMObject
-         +----NMDevice
-               +----NMDeviceGeneric
-
+

Properties

+
+++++ + + + + + + + + + + + + +
+gchar *hw-addressRead
+gchar *type-descriptionRead
-

Implemented Interfaces

-

-NMDeviceGeneric implements - GInitable and GAsyncInitable.

+

Types and Values

+
-

Properties

-
-  "hw-address"               gchar*                : Read
-  "type-description"         gchar*                : Read
+

Object Hierarchy

+
    GObject
+    ╰── NMObject
+        ╰── NMDevice
+            ╰── NMDeviceGeneric
 
@@ -83,191 +132,169 @@ NMDeviceGeneric implements

-

Details

+

Functions

-

enum NMDeviceGenericError

-
typedef enum {
-	NM_DEVICE_GENERIC_ERROR_UNKNOWN = 0,            /*< nick=UnknownError >*/
-	NM_DEVICE_GENERIC_ERROR_NOT_GENERIC_CONNECTION, /*< nick=NotGenericConnection >*/
-	NM_DEVICE_GENERIC_ERROR_MISSING_INTERFACE_NAME, /*< nick=MissingInterfaceName >*/
-} NMDeviceGenericError;
-
-
+

nm_device_generic_error_quark ()

+
GQuark
+nm_device_generic_error_quark (void);
+

Registers an error quark for NMDeviceGeneric if necessary.

+
+

Returns

+

the error quark used for NMDeviceGeneric errors.

+

+
+

Since 0.9.10

+ +
+
+

nm_device_generic_new ()

+
GObject *
+nm_device_generic_new (DBusGConnection *connection,
+                       const char *path);
+

Creates a new NMDeviceGeneric.

+
+

Parameters

+
--+++ - - + + + - - - - - - + + +

NM_DEVICE_GENERIC_ERROR_UNKNOWN

unknown or unclassified error -

connection

the DBusGConnection

 

NM_DEVICE_GENERIC_ERROR_NOT_GENERIC_CONNECTION

the connection was not of generic type -

NM_DEVICE_GENERIC_ERROR_MISSING_INTERFACE_NAME

the connection did not specify the interface name -

path

the DBus object path of the device

 
-
-
-

NM_DEVICE_GENERIC_ERROR

-
#define NM_DEVICE_GENERIC_ERROR nm_device_generic_error_quark ()
-
-

-

+
+

Returns

+

a new device.

+

[transfer full]

+
+

Since 0.9.10


-

nm_device_generic_error_quark ()

-
GQuark              nm_device_generic_error_quark       (void);
-

-Registers an error quark for NMDeviceGeneric if necessary. -

-
+

nm_device_generic_get_hw_address ()

+
const char *
+nm_device_generic_get_hw_address (NMDeviceGeneric *device);
+

Gets the hardware address of the NMDeviceGeneric

+
+

Parameters

+
--+++ - - + + +

Returns :

the error quark used for NMDeviceGeneric errors.

device

a NMDeviceGeneric

 
-

Since 0.9.10

-
-
-
-

NM_DEVICE_GENERIC_HW_ADDRESS

-
#define NM_DEVICE_GENERIC_HW_ADDRESS       "hw-address"
-
-

-

-
-
-

NM_DEVICE_GENERIC_TYPE_DESCRIPTION

-
#define NM_DEVICE_GENERIC_TYPE_DESCRIPTION "type-description"
-
-

-

+
+

Returns

+

the hardware address. This is the internal string used by the +device, and must not be modified.

+

-
-
-

NMDeviceGeneric

-
typedef struct _NMDeviceGeneric NMDeviceGeneric;
-

-

+

Since 0.9.10

-
-
-

NMDeviceGenericClass

-
typedef struct {
-	NMDeviceClass parent;
-
-	/* Padding for future expansion */
-	void (*_reserved1) (void);
-	void (*_reserved2) (void);
-	void (*_reserved3) (void);
-	void (*_reserved4) (void);
-	void (*_reserved5) (void);
-	void (*_reserved6) (void);
-} NMDeviceGenericClass;
-
-

-

-
+
+

Types and Values

-

nm_device_generic_new ()

-
GObject *           nm_device_generic_new               (DBusGConnection *connection,
-                                                         const char *path);
-

-Creates a new NMDeviceGeneric. -

-
+

enum NMDeviceGenericError

+
+

Members

+
--+++ - - + + - - + + + - - + +

connection :

the DBusGConnection +

NM_DEVICE_GENERIC_ERROR_UNKNOWN

+

unknown or unclassified error

 

path :

the DBus object path of the device

NM_DEVICE_GENERIC_ERROR_NOT_GENERIC_CONNECTION

+

the connection was not of generic type

+
 

Returns :

a new device. [transfer full] +

NM_DEVICE_GENERIC_ERROR_MISSING_INTERFACE_NAME

+

the connection did not specify the interface name

 
-

Since 0.9.10

+

-

nm_device_generic_get_hw_address ()

-
const char *        nm_device_generic_get_hw_address    (NMDeviceGeneric *device);
+

NM_DEVICE_GENERIC_ERROR

+
#define NM_DEVICE_GENERIC_ERROR nm_device_generic_error_quark ()
+

-Gets the hardware address of the NMDeviceGeneric

-
---- - - - - - - - - - - -

device :

a NMDeviceGeneric -

Returns :

the hardware address. This is the internal string used by the -device, and must not be modified.
-

Since 0.9.10

-
-
-

Property Details

+
-

The "hw-address" property

-
  "hw-address"               gchar*                : Read
+

NM_DEVICE_GENERIC_HW_ADDRESS

+
#define NM_DEVICE_GENERIC_HW_ADDRESS       "hw-address"
+

-The hardware address of the device.

-

Default value: NULL


-

The "type-description" property

-
  "type-description"         gchar*                : Read
+

NM_DEVICE_GENERIC_TYPE_DESCRIPTION

+
#define NM_DEVICE_GENERIC_TYPE_DESCRIPTION "type-description"
+

-A description of the specific type of device this is, or NULL -if not known.

+
+
+
+

Property Details

+
+

The “hw-address” property

+
  “hw-address”               gchar *
+

+

Flags: Read

+

Default value: NULL

+
+
+
+

The “type-description” property

+
  “type-description”         gchar *
+

+

Flags: Read

Default value: NULL

+ Generated by GTK-Doc V1.21
\ No newline at end of file diff --git a/docs/libnm-glib/html/NMDeviceInfiniband.html b/docs/libnm-glib/html/NMDeviceInfiniband.html index e4aed60a..48b6c887 100644 --- a/docs/libnm-glib/html/NMDeviceInfiniband.html +++ b/docs/libnm-glib/html/NMDeviceInfiniband.html @@ -2,36 +2,28 @@ -NMDeviceInfiniband +libnm-glib Reference Manual: NMDeviceInfiniband - + - - - - - - - - - - + + + + + + +
@@ -39,270 +31,315 @@

NMDeviceInfiniband

NMDeviceInfiniband

- +
- -
-

Object Hierarchy

-
-  GObject
-   +----NMObject
-         +----NMDevice
-               +----NMDeviceInfiniband
-
-
-
-

Implemented Interfaces

-

-NMDeviceInfiniband implements - GInitable and GAsyncInitable.

-
-
-

Properties

-
-  "carrier"                  gboolean              : Read
-  "hw-address"               gchar*                : Read
-
-
-
-

Description

-

-

-
-

Details

-
-

enum NMDeviceInfinibandError

-
typedef enum {
-	NM_DEVICE_INFINIBAND_ERROR_UNKNOWN = 0,                   /*< nick=UnknownError >*/
-	NM_DEVICE_INFINIBAND_ERROR_NOT_INFINIBAND_CONNECTION,     /*< nick=NotInfinibandConnection >*/
-	NM_DEVICE_INFINIBAND_ERROR_INVALID_INFINIBAND_CONNECTION, /*< nick=InvalidInfinibandConnection >*/
-	NM_DEVICE_INFINIBAND_ERROR_INVALID_DEVICE_MAC,            /*< nick=InvalidDeviceMac >*/
-	NM_DEVICE_INFINIBAND_ERROR_MAC_MISMATCH,                  /*< nick=MacMismatch >*/
-} NMDeviceInfinibandError;
-
-
+

Functions

+
--++ - - - - - - - - + - - + - - +

NM_DEVICE_INFINIBAND_ERROR_UNKNOWN

unknown or unclassified error + +GQuark

NM_DEVICE_INFINIBAND_ERROR_NOT_INFINIBAND_CONNECTION

the connection was not of InfiniBand type + +nm_device_infiniband_error_quark ()

NM_DEVICE_INFINIBAND_ERROR_INVALID_INFINIBAND_CONNECTION

the InfiniBand connection was invalid + +GObject * + +nm_device_infiniband_new ()

NM_DEVICE_INFINIBAND_ERROR_INVALID_DEVICE_MAC

the device's MAC was invalid +const char * + +nm_device_infiniband_get_hw_address ()

NM_DEVICE_INFINIBAND_ERROR_MAC_MISMATCH

the MACs of the connection and the device mismatched + +gboolean + +nm_device_infiniband_get_carrier ()
-
-
-

NM_DEVICE_INFINIBAND_ERROR

-
#define NM_DEVICE_INFINIBAND_ERROR nm_device_infiniband_error_quark ()
-
-

-

+
+

Properties

+
+++++ + + + + + + + + + + + + +
gbooleancarrierRead
+gchar *hw-addressRead
-
-
-

nm_device_infiniband_error_quark ()

-
GQuark              nm_device_infiniband_error_quark    (void);
-

-Registers an error quark for NMDeviceInfiniband if necessary. -

-
+
+

Types and Values

+
--++ - - - - + + + + + + + + + + + + + + + + + +

Returns :

the error quark used for NMDeviceInfiniband errors.
enumNMDeviceInfinibandError
#defineNM_DEVICE_INFINIBAND_ERROR
#defineNM_DEVICE_INFINIBAND_HW_ADDRESS
#defineNM_DEVICE_INFINIBAND_CARRIER
-
-
-

NM_DEVICE_INFINIBAND_HW_ADDRESS

-
#define NM_DEVICE_INFINIBAND_HW_ADDRESS  "hw-address"
+
+

Object Hierarchy

+
    GObject
+    ╰── NMObject
+        ╰── NMDevice
+            ╰── NMDeviceInfiniband
 
-

-

-
-
-

NM_DEVICE_INFINIBAND_CARRIER

-
#define NM_DEVICE_INFINIBAND_CARRIER     "carrier"
-
+
+

Description

-
+
+

Functions

-

NMDeviceInfiniband

-
typedef struct _NMDeviceInfiniband NMDeviceInfiniband;
-

-

+

nm_device_infiniband_error_quark ()

+
GQuark
+nm_device_infiniband_error_quark (void);
+

Registers an error quark for NMDeviceInfiniband if necessary.

+
+

Returns

+

the error quark used for NMDeviceInfiniband errors.

+

-
-
-

NMDeviceInfinibandClass

-
typedef struct {
-	NMDeviceClass parent;
-
-	/* Padding for future expansion */
-	void (*_reserved1) (void);
-	void (*_reserved2) (void);
-	void (*_reserved3) (void);
-	void (*_reserved4) (void);
-	void (*_reserved5) (void);
-	void (*_reserved6) (void);
-} NMDeviceInfinibandClass;
-
-

-


-

nm_device_infiniband_new ()

-
GObject *           nm_device_infiniband_new            (DBusGConnection *connection,
-                                                         const char *path);
-

-Creates a new NMDeviceInfiniband. -

-
+

nm_device_infiniband_new ()

+
GObject *
+nm_device_infiniband_new (DBusGConnection *connection,
+                          const char *path);
+

Creates a new NMDeviceInfiniband.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + +

connection :

the DBusGConnection -

path :

the DBus object path of the device

connection

the DBusGConnection

 

Returns :

a new device. [transfer full] -

path

the DBus object path of the device

 
+
+

Returns

+

a new device.

+

[transfer full]

+
+

-

nm_device_infiniband_get_hw_address ()

-
const char *        nm_device_infiniband_get_hw_address (NMDeviceInfiniband *device);
-

-Gets the hardware (MAC) address of the NMDeviceInfiniband -

-
+

nm_device_infiniband_get_hw_address ()

+
const char *
+nm_device_infiniband_get_hw_address (NMDeviceInfiniband *device);
+

Gets the hardware (MAC) address of the NMDeviceInfiniband

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

device :

a NMDeviceInfiniband -

Returns :

the hardware address. This is the internal string used by the -device, and must not be modified.

device

a NMDeviceInfiniband

 
+
+

Returns

+

the hardware address. This is the internal string used by the +device, and must not be modified.

+

+
+

-

nm_device_infiniband_get_carrier ()

-
gboolean            nm_device_infiniband_get_carrier    (NMDeviceInfiniband *device);
-

-Whether the device has carrier. -

-
+

nm_device_infiniband_get_carrier ()

+
gboolean
+nm_device_infiniband_get_carrier (NMDeviceInfiniband *device);
+

Whether the device has carrier.

+
+

Parameters

+
--++++ + + + + + +

device

a NMDeviceInfiniband

 
+
+
+

Returns

+

TRUE if the device has carrier

+

+
+
+
+
+

Types and Values

+
+

enum NMDeviceInfinibandError

+
+

Members

+
++++ - - + + + + + + + + + + + + + + + + + - - + + +

device :

a NMDeviceInfiniband +

NM_DEVICE_INFINIBAND_ERROR_UNKNOWN

+

unknown or unclassified error

+
 

NM_DEVICE_INFINIBAND_ERROR_NOT_INFINIBAND_CONNECTION

+

the connection was not of InfiniBand type

+
 

NM_DEVICE_INFINIBAND_ERROR_INVALID_INFINIBAND_CONNECTION

+

the InfiniBand connection was invalid

+
 

NM_DEVICE_INFINIBAND_ERROR_INVALID_DEVICE_MAC

+

the device's MAC was invalid

 

Returns :

-TRUE if the device has carrier

NM_DEVICE_INFINIBAND_ERROR_MAC_MISMATCH

+

the MACs of the connection and the device mismatched

+
 
-
-

Property Details

+
-

The "carrier" property

-
  "carrier"                  gboolean              : Read
+

NM_DEVICE_INFINIBAND_ERROR

+
#define NM_DEVICE_INFINIBAND_ERROR nm_device_infiniband_error_quark ()
+

-Whether the device has carrier.

-

Default value: FALSE


-

The "hw-address" property

-
  "hw-address"               gchar*                : Read
+

NM_DEVICE_INFINIBAND_HW_ADDRESS

+
#define NM_DEVICE_INFINIBAND_HW_ADDRESS  "hw-address"
+
+

+

+
+
+
+

NM_DEVICE_INFINIBAND_CARRIER

+
#define NM_DEVICE_INFINIBAND_CARRIER     "carrier"
+

-The hardware (MAC) address of the device.

+
+
+
+

Property Details

+
+

The “carrier” property

+
  “carrier”                  gboolean
+

+

Flags: Read

+

Default value: FALSE

+
+
+
+

The “hw-address” property

+
  “hw-address”               gchar *
+

+

Flags: Read

Default value: NULL

+ Generated by GTK-Doc V1.21
\ No newline at end of file diff --git a/docs/libnm-glib/html/NMDeviceModem.html b/docs/libnm-glib/html/NMDeviceModem.html index 1399158e..2503475b 100644 --- a/docs/libnm-glib/html/NMDeviceModem.html +++ b/docs/libnm-glib/html/NMDeviceModem.html @@ -2,36 +2,28 @@ -NMDeviceModem +libnm-glib Reference Manual: NMDeviceModem - + - - - - - - - - - - + + + + + + +
@@ -39,43 +31,98 @@

NMDeviceModem

NMDeviceModem

- +
-
-

Synopsis

-
enum                NMDeviceModemError;
-#define             NM_DEVICE_MODEM_ERROR
-GQuark              nm_device_modem_error_quark         (void);
-#define             NM_DEVICE_MODEM_MODEM_CAPABILITIES
-#define             NM_DEVICE_MODEM_CURRENT_CAPABILITIES
-                    NMDeviceModem;
-                    NMDeviceModemClass;
-NMDeviceModemCapabilities nm_device_modem_get_modem_capabilities
-                                                        (NMDeviceModem *self);
-NMDeviceModemCapabilities nm_device_modem_get_current_capabilities
-                                                        (NMDeviceModem *self);
-
+
-

Object Hierarchy

-
-  GObject
-   +----NMObject
-         +----NMDevice
-               +----NMDeviceModem
-
+

Properties

+
+++++ + + + + + + + + + + + + +
guintcurrent-capabilitiesRead
guintmodem-capabilitiesRead
-

Implemented Interfaces

-

-NMDeviceModem implements - GInitable and GAsyncInitable.

+

Types and Values

+
-

Properties

-
-  "current-capabilities"     guint                 : Read
-  "modem-capabilities"       guint                 : Read
+

Object Hierarchy

+
    GObject
+    ╰── NMObject
+        ╰── NMDevice
+            ╰── NMDeviceModem
 
@@ -84,45 +131,125 @@ NMDeviceModem implements

-

Details

+

Functions

+
+

nm_device_modem_error_quark ()

+
GQuark
+nm_device_modem_error_quark (void);
+

Registers an error quark for NMDeviceModem if necessary.

+
+

Returns

+

the error quark used for NMDeviceModem errors.

+

+
+
+
+
+

nm_device_modem_get_modem_capabilities ()

+
NMDeviceModemCapabilities
+nm_device_modem_get_modem_capabilities
+                               (NMDeviceModem *self);
+

Returns a bitfield of the generic access technology families the modem +supports. Not all capabilities are available concurrently however; some +may require a firmware reload or reinitialization.

+
+

Parameters

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

self

a NMDeviceModem

 
+
+
+

Returns

+

the generic access technology families the modem supports

+

+
+
+
+
+

nm_device_modem_get_current_capabilities ()

+
NMDeviceModemCapabilities
+nm_device_modem_get_current_capabilities
+                               (NMDeviceModem *self);
+

Returns a bitfield of the generic access technology families the modem +supports without a firmware reload or reinitialization. This value +represents the network types the modem can immediately connect to.

+
+

Parameters

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

self

a NMDeviceModem

 
+
+
+

Returns

+

the generic access technology families the modem supports without +a firmware reload or other reinitialization

+

+
+
+
+
+

Types and Values

enum NMDeviceModemError

-
typedef enum {
-	NM_DEVICE_MODEM_ERROR_UNKNOWN = 0,              /*< nick=UnknownError >*/
-	NM_DEVICE_MODEM_ERROR_NOT_MODEM_CONNECTION,     /*< nick=NotModemConnection >*/
-	NM_DEVICE_MODEM_ERROR_INVALID_MODEM_CONNECTION, /*< nick=InvalidModemConnection >*/
-	NM_DEVICE_MODEM_ERROR_MISSING_DEVICE_CAPS,      /*< nick=MissingDeviceCaps >*/
-} NMDeviceModemError;
-
-
+
+

Members

+
--+++ - - + + - - + + - - + + - - + +

NM_DEVICE_MODEM_ERROR_UNKNOWN

unknown or unclassified error +

NM_DEVICE_MODEM_ERROR_UNKNOWN

+

unknown or unclassified error

 

NM_DEVICE_MODEM_ERROR_NOT_MODEM_CONNECTION

the connection was not of modem type +

NM_DEVICE_MODEM_ERROR_NOT_MODEM_CONNECTION

+

the connection was not of modem type

 

NM_DEVICE_MODEM_ERROR_INVALID_MODEM_CONNECTION

the modem connection was invalid +

NM_DEVICE_MODEM_ERROR_INVALID_MODEM_CONNECTION

+

the modem connection was invalid

 

NM_DEVICE_MODEM_ERROR_MISSING_DEVICE_CAPS

the device missed required capabilities +

NM_DEVICE_MODEM_ERROR_MISSING_DEVICE_CAPS

+

the device missed required capabilities

 
+

NM_DEVICE_MODEM_ERROR

@@ -133,24 +260,6 @@ NMDeviceModem implements

-

nm_device_modem_error_quark ()

-
GQuark              nm_device_modem_error_quark         (void);
-

-Registers an error quark for NMDeviceModem if necessary. -

-
---- - - - - -

Returns :

the error quark used for NMDeviceModem errors.
-
-
-

NM_DEVICE_MODEM_MODEM_CAPABILITIES

#define NM_DEVICE_MODEM_MODEM_CAPABILITIES   "modem-capabilities"
 
@@ -165,116 +274,28 @@ Registers an error quark for -

NMDeviceModem

-
typedef struct _NMDeviceModem NMDeviceModem;
-

-

-
-
-
-

NMDeviceModemClass

-
typedef struct {
-	NMDeviceClass parent;
-
-	/* Padding for future expansion */
-	void (*_reserved1) (void);
-	void (*_reserved2) (void);
-	void (*_reserved3) (void);
-	void (*_reserved4) (void);
-	void (*_reserved5) (void);
-	void (*_reserved6) (void);
-} NMDeviceModemClass;
-
-

-

-
-
-
-

nm_device_modem_get_modem_capabilities ()

-
NMDeviceModemCapabilities nm_device_modem_get_modem_capabilities
-                                                        (NMDeviceModem *self);
-

-Returns a bitfield of the generic access technology families the modem -supports. Not all capabilities are available concurrently however; some -may require a firmware reload or reinitialization. -

-
---- - - - - - - - - - - -

self :

a NMDeviceModem -

Returns :

the generic access technology families the modem supports
-
-
-
-

nm_device_modem_get_current_capabilities ()

-
NMDeviceModemCapabilities nm_device_modem_get_current_capabilities
-                                                        (NMDeviceModem *self);
-

-Returns a bitfield of the generic access technology families the modem -supports without a firmware reload or reinitialization. This value -represents the network types the modem can immediately connect to. -

-
---- - - - - - - - - - - -

self :

a NMDeviceModem -

Returns :

the generic access technology families the modem supports without -a firmware reload or other reinitialization
-

Property Details

-

The "current-capabilities" property

-
  "current-capabilities"     guint                 : Read
-

-The generic family of access technologies the modem currently supports -without a firmware reload or reinitialization. -

+

The “current-capabilities” property

+
  “current-capabilities”     guint
+

+

Flags: Read

Default value: 0


-

The "modem-capabilities" property

-
  "modem-capabilities"       guint                 : Read
-

-The generic family of access technologies the modem supports. Not all -capabilities are available at the same time however; some modems require -a firmware reload or other reinitialization to switch between eg -CDMA/EVDO and GSM/UMTS. -

+

The “modem-capabilities” property

+
  “modem-capabilities”       guint
+

+

Flags: Read

Default value: 0

+ Generated by GTK-Doc V1.21
\ No newline at end of file diff --git a/docs/libnm-glib/html/NMDeviceOlpcMesh.html b/docs/libnm-glib/html/NMDeviceOlpcMesh.html index 482b949b..a505af82 100644 --- a/docs/libnm-glib/html/NMDeviceOlpcMesh.html +++ b/docs/libnm-glib/html/NMDeviceOlpcMesh.html @@ -2,36 +2,28 @@ -NMDeviceOlpcMesh +libnm-glib Reference Manual: NMDeviceOlpcMesh - + - - - - - - - - - - + + + + + + +
@@ -39,47 +31,124 @@

NMDeviceOlpcMesh

NMDeviceOlpcMesh

- +
-
-

Synopsis

-
enum                NMDeviceOlpcMeshError;
-#define             NM_DEVICE_OLPC_MESH_ERROR
-GQuark              nm_device_olpc_mesh_error_quark     (void);
-#define             NM_DEVICE_OLPC_MESH_HW_ADDRESS
-#define             NM_DEVICE_OLPC_MESH_COMPANION
-#define             NM_DEVICE_OLPC_MESH_ACTIVE_CHANNEL
-                    NMDeviceOlpcMesh;
-                    NMDeviceOlpcMeshClass;
-GObject *           nm_device_olpc_mesh_new             (DBusGConnection *connection,
-                                                         const char *path);
-const char *        nm_device_olpc_mesh_get_hw_address  (NMDeviceOlpcMesh *device);
-NMDeviceWifi *      nm_device_olpc_mesh_get_companion   (NMDeviceOlpcMesh *device);
-guint32             nm_device_olpc_mesh_get_active_channel
-                                                        (NMDeviceOlpcMesh *device);
-
+
+

Functions

+
++++ + + + + + + + + + + + + + + + + + + + + + + +
+GQuark + +nm_device_olpc_mesh_error_quark () +
+GObject * + +nm_device_olpc_mesh_new () +
const char * + +nm_device_olpc_mesh_get_hw_address () +
+NMDeviceWifi * + +nm_device_olpc_mesh_get_companion () +
+guint32 + +nm_device_olpc_mesh_get_active_channel () +
-

Object Hierarchy

-
-  GObject
-   +----NMObject
-         +----NMDevice
-               +----NMDeviceOlpcMesh
-
+

Properties

+
+++++ + + + + + + + + + + + + + + + + + +
guintactive-channelRead
+NMDeviceWifi *companionRead
+gchar *hw-addressRead
-

Implemented Interfaces

-

-NMDeviceOlpcMesh implements - GInitable and GAsyncInitable.

+

Types and Values

+
-

Properties

-
-  "active-channel"           guint                 : Read
-  "companion"                NMDeviceWifi*         : Read
-  "hw-address"               gchar*                : Read
+

Object Hierarchy

+
    GObject
+    ╰── NMObject
+        ╰── NMDevice
+            ╰── NMDeviceOlpcMesh
 
@@ -88,255 +157,236 @@ NMDeviceOlpcMesh implements

-

Details

+

Functions

-

enum NMDeviceOlpcMeshError

-
typedef enum {
-	NM_DEVICE_OLPC_MESH_ERROR_UNKNOWN = 0,                  /*< nick=UnknownError >*/
-	NM_DEVICE_OLPC_MESH_ERROR_NOT_OLPC_MESH_CONNECTION,     /*< nick=NotOlpcMeshConnection >*/
-	NM_DEVICE_OLPC_MESH_ERROR_INVALID_OLPC_MESH_CONNECTION, /*< nick=InvalidOlpcMeshConnection >*/
-} NMDeviceOlpcMeshError;
-
-
+

nm_device_olpc_mesh_error_quark ()

+
GQuark
+nm_device_olpc_mesh_error_quark (void);
+

Registers an error quark for NMDeviceOlpcMesh if necessary.

+
+

Returns

+

the error quark used for NMDeviceOlpcMesh errors.

+

+
+ +
+
+

nm_device_olpc_mesh_new ()

+
GObject *
+nm_device_olpc_mesh_new (DBusGConnection *connection,
+                         const char *path);
+

Creates a new NMDeviceOlpcMesh.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + +

NM_DEVICE_OLPC_MESH_ERROR_UNKNOWN

unknown or unclassified error -

NM_DEVICE_OLPC_MESH_ERROR_NOT_OLPC_MESH_CONNECTION

the connection was not of Olpc Mesh type -

connection

the DBusGConnection

 

NM_DEVICE_OLPC_MESH_ERROR_INVALID_OLPC_MESH_CONNECTION

the Olpc Mesh connection was invalid -

path

the DBus object path of the device

 
-
-
-

NM_DEVICE_OLPC_MESH_ERROR

-
#define NM_DEVICE_OLPC_MESH_ERROR nm_device_olpc_mesh_error_quark ()
-
-

-

+
+

Returns

+

a new OlpcMesh device.

+

[transfer full]

+

-

nm_device_olpc_mesh_error_quark ()

-
GQuark              nm_device_olpc_mesh_error_quark     (void);
-

-Registers an error quark for NMDeviceOlpcMesh if necessary. -

-
+

nm_device_olpc_mesh_get_hw_address ()

+
const char *
+nm_device_olpc_mesh_get_hw_address (NMDeviceOlpcMesh *device);
+

Gets the hardware (MAC) address of the NMDeviceOlpcMesh

+
+

Parameters

+
--+++ - - + + +

Returns :

the error quark used for NMDeviceOlpcMesh errors.

device

a NMDeviceOlpcMesh

 
-
-
-

NM_DEVICE_OLPC_MESH_HW_ADDRESS

-
#define NM_DEVICE_OLPC_MESH_HW_ADDRESS     "hw-address"
-
-

-

+
+

Returns

+

the hardware address. This is the internal string used by the +device, and must not be modified.

+

-
-
-

NM_DEVICE_OLPC_MESH_COMPANION

-
#define NM_DEVICE_OLPC_MESH_COMPANION      "companion"
-
-

-


-

NM_DEVICE_OLPC_MESH_ACTIVE_CHANNEL

-
#define NM_DEVICE_OLPC_MESH_ACTIVE_CHANNEL "active-channel"
-
-

-

+

nm_device_olpc_mesh_get_companion ()

+
NMDeviceWifi *
+nm_device_olpc_mesh_get_companion (NMDeviceOlpcMesh *device);
+

Gets the companion device of the NMDeviceOlpcMesh.

+
+

Parameters

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

device

a NMDeviceOlpcMesh

 
+
+
+

Returns

+

the companion of the device of NULL.

+

[transfer none]

-
-
-

NMDeviceOlpcMesh

-
typedef struct _NMDeviceOlpcMesh NMDeviceOlpcMesh;
-

-


-

NMDeviceOlpcMeshClass

-
typedef struct {
-	NMDeviceClass parent;
-
-	/* Padding for future expansion */
-	void (*_reserved1) (void);
-	void (*_reserved2) (void);
-	void (*_reserved3) (void);
-	void (*_reserved4) (void);
-	void (*_reserved5) (void);
-	void (*_reserved6) (void);
-} NMDeviceOlpcMeshClass;
-
-

-

+

nm_device_olpc_mesh_get_active_channel ()

+
guint32
+nm_device_olpc_mesh_get_active_channel
+                               (NMDeviceOlpcMesh *device);
+

Returns the active channel of the NMDeviceOlpcMesh device.

+
+

Parameters

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

device

a NMDeviceOlpcMesh

 
-
+
+

Returns

+

active channel of the device

+

+
+
+
+
+

Types and Values

-

nm_device_olpc_mesh_new ()

-
GObject *           nm_device_olpc_mesh_new             (DBusGConnection *connection,
-                                                         const char *path);
-

-Creates a new NMDeviceOlpcMesh. -

-
+

enum NMDeviceOlpcMeshError

+
+

Members

+
--+++ - - + + - - + + + - - + +

connection :

the DBusGConnection +

NM_DEVICE_OLPC_MESH_ERROR_UNKNOWN

+

unknown or unclassified error

 

path :

the DBus object path of the device

NM_DEVICE_OLPC_MESH_ERROR_NOT_OLPC_MESH_CONNECTION

+

the connection was not of Olpc Mesh type

+
 

Returns :

a new OlpcMesh device. [transfer full] +

NM_DEVICE_OLPC_MESH_ERROR_INVALID_OLPC_MESH_CONNECTION

+

the Olpc Mesh connection was invalid

 
+

-

nm_device_olpc_mesh_get_hw_address ()

-
const char *        nm_device_olpc_mesh_get_hw_address  (NMDeviceOlpcMesh *device);
+

NM_DEVICE_OLPC_MESH_ERROR

+
#define NM_DEVICE_OLPC_MESH_ERROR nm_device_olpc_mesh_error_quark ()
+

-Gets the hardware (MAC) address of the NMDeviceOlpcMesh

-
---- - - - - - - - - - - -

device :

a NMDeviceOlpcMesh -

Returns :

the hardware address. This is the internal string used by the -device, and must not be modified.

-

nm_device_olpc_mesh_get_companion ()

-
NMDeviceWifi *      nm_device_olpc_mesh_get_companion   (NMDeviceOlpcMesh *device);
+

NM_DEVICE_OLPC_MESH_HW_ADDRESS

+
#define NM_DEVICE_OLPC_MESH_HW_ADDRESS     "hw-address"
+

-Gets the companion device of the NMDeviceOlpcMesh.

-
---- - - - - - - - - - - -

device :

a NMDeviceOlpcMesh -

Returns :

the companion of the device of NULL. [transfer none] -

-

nm_device_olpc_mesh_get_active_channel ()

-
guint32             nm_device_olpc_mesh_get_active_channel
-                                                        (NMDeviceOlpcMesh *device);
+

NM_DEVICE_OLPC_MESH_COMPANION

+
#define NM_DEVICE_OLPC_MESH_COMPANION      "companion"
+
+

+

+
+
+
+

NM_DEVICE_OLPC_MESH_ACTIVE_CHANNEL

+
#define NM_DEVICE_OLPC_MESH_ACTIVE_CHANNEL "active-channel"
+

-Returns the active channel of the NMDeviceOlpcMesh device.

-
---- - - - - - - - - - - -

device :

a NMDeviceOlpcMesh -

Returns :

active channel of the device

Property Details

-

The "active-channel" property

-
  "active-channel"           guint                 : Read
-

-The device's active channel. -

+

The “active-channel” property

+
  “active-channel”           guint
+

+

Flags: Read

Default value: 0


-

The "companion" property

-
  "companion"                NMDeviceWifi*         : Read
-

-The companion device. -

+

The “companion” property

+
  “companion”                NMDeviceWifi *
+

+

Flags: Read


-

The "hw-address" property

-
  "hw-address"               gchar*                : Read
-

-The hardware (MAC) address of the device. -

+

The “hw-address” property

+
  “hw-address”               gchar *
+

+

Flags: Read

Default value: NULL

+ Generated by GTK-Doc V1.21
\ No newline at end of file diff --git a/docs/libnm-glib/html/NMDeviceTeam.html b/docs/libnm-glib/html/NMDeviceTeam.html index 9160805e..0b07f9eb 100644 --- a/docs/libnm-glib/html/NMDeviceTeam.html +++ b/docs/libnm-glib/html/NMDeviceTeam.html @@ -2,36 +2,28 @@ -NMDeviceTeam +libnm-glib Reference Manual: NMDeviceTeam - + - - - - - - - - - - + + + + + + +
@@ -39,316 +31,376 @@

NMDeviceTeam

NMDeviceTeam

- +
-
-

Object Hierarchy

-
-  GObject
-   +----NMObject
-         +----NMDevice
-               +----NMDeviceTeam
-
-
-
-

Implemented Interfaces

-

-NMDeviceTeam implements - GInitable and GAsyncInitable.

-
-
-

Properties

-
-  "carrier"                  gboolean              : Read
-  "hw-address"               gchar*                : Read
-  "slaves"                   NMObjectArray*        : Read
-
-
-
-

Description

-

-

-
-
-

Details

-
-

enum NMDeviceTeamError

-
typedef enum {
-	NM_DEVICE_TEAM_ERROR_UNKNOWN = 0,             /*< nick=UnknownError >*/
-	NM_DEVICE_TEAM_ERROR_NOT_TEAM_CONNECTION,     /*< nick=NotTeamConnection >*/
-	NM_DEVICE_TEAM_ERROR_INVALID_TEAM_CONNECTION, /*< nick=InvalidTeamConnection >*/
-	NM_DEVICE_TEAM_ERROR_INTERFACE_MISMATCH,      /*< nick=InterfaceMismatch >*/
-} NMDeviceTeamError;
-
-
+

Functions

+
--++ - - + - - + - - + + + + + - - +

NM_DEVICE_TEAM_ERROR_UNKNOWN

unknown or unclassified error + +GQuark + +nm_device_team_error_quark ()

NM_DEVICE_TEAM_ERROR_NOT_TEAM_CONNECTION

the connection was not of team type + +GObject * + +nm_device_team_new ()

NM_DEVICE_TEAM_ERROR_INVALID_TEAM_CONNECTION

the team connection was invalid +const char * + +nm_device_team_get_hw_address () +
+gboolean + +nm_device_team_get_carrier ()

NM_DEVICE_TEAM_ERROR_INTERFACE_MISMATCH

the interfaces of the connection and the device mismatched +const GPtrArray * + +nm_device_team_get_slaves ()
-
-
-

NM_DEVICE_TEAM_ERROR

-
#define NM_DEVICE_TEAM_ERROR nm_device_team_error_quark ()
-
-

-

-
-
-
-

nm_device_team_error_quark ()

-
GQuark              nm_device_team_error_quark          (void);
-

-Registers an error quark for NMDeviceTeam if necessary. -

-
+
+

Properties

+
--+++ - - - - + + + + + + + + + + + + + + + + +

Returns :

the error quark used for NMDeviceTeam errors.
gbooleancarrierRead
+gchar *hw-addressRead
+NMObjectArray *slavesRead
-

Since 0.9.10

-
-
-

NM_DEVICE_TEAM_HW_ADDRESS

-
#define NM_DEVICE_TEAM_HW_ADDRESS  "hw-address"
-
-

-

+
+

Types and Values

+
++++ + + + + + + + + + + + + + + + + + + + + + + +
enumNMDeviceTeamError
#defineNM_DEVICE_TEAM_ERROR
#defineNM_DEVICE_TEAM_HW_ADDRESS
#defineNM_DEVICE_TEAM_CARRIER
#defineNM_DEVICE_TEAM_SLAVES
-
-
-

NM_DEVICE_TEAM_CARRIER

-
#define NM_DEVICE_TEAM_CARRIER     "carrier"
+
+

Object Hierarchy

+
    GObject
+    ╰── NMObject
+        ╰── NMDevice
+            ╰── NMDeviceTeam
 
-

-

-
-
-

NM_DEVICE_TEAM_SLAVES

-
#define NM_DEVICE_TEAM_SLAVES      "slaves"
-
+
+

Description

-
+
+

Functions

-

NMDeviceTeam

-
typedef struct _NMDeviceTeam NMDeviceTeam;
-

-

+

nm_device_team_error_quark ()

+
GQuark
+nm_device_team_error_quark (void);
+

Registers an error quark for NMDeviceTeam if necessary.

+
+

Returns

+

the error quark used for NMDeviceTeam errors.

+

-
-
-

NMDeviceTeamClass

-
typedef struct {
-	NMDeviceClass parent;
-
-	/* Padding for future expansion */
-	void (*_reserved1) (void);
-	void (*_reserved2) (void);
-	void (*_reserved3) (void);
-	void (*_reserved4) (void);
-	void (*_reserved5) (void);
-	void (*_reserved6) (void);
-} NMDeviceTeamClass;
-
-

-

+

Since 0.9.10


-

nm_device_team_new ()

-
GObject *           nm_device_team_new                  (DBusGConnection *connection,
-                                                         const char *path);
-

-Creates a new NMDeviceTeam. -

-
+

nm_device_team_new ()

+
GObject *
+nm_device_team_new (DBusGConnection *connection,
+                    const char *path);
+

Creates a new NMDeviceTeam.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + +

connection :

the DBusGConnection -

path :

the DBus object path of the device

connection

the DBusGConnection

 

Returns :

a new device. [transfer full] -

path

the DBus object path of the device

 
+
+
+

Returns

+

a new device.

+

[transfer full]

+

Since 0.9.10


-

nm_device_team_get_hw_address ()

-
const char *        nm_device_team_get_hw_address       (NMDeviceTeam *device);
-

-Gets the hardware (MAC) address of the NMDeviceTeam -

-
+

nm_device_team_get_hw_address ()

+
const char *
+nm_device_team_get_hw_address (NMDeviceTeam *device);
+

Gets the hardware (MAC) address of the NMDeviceTeam

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

device :

a NMDeviceTeam -

Returns :

the hardware address. This is the internal string used by the -device, and must not be modified.

device

a NMDeviceTeam

 
+
+
+

Returns

+

the hardware address. This is the internal string used by the +device, and must not be modified.

+

+

Since 0.9.10


-

nm_device_team_get_carrier ()

-
gboolean            nm_device_team_get_carrier          (NMDeviceTeam *device);
-

-Whether the device has carrier. -

-
+

nm_device_team_get_carrier ()

+
gboolean
+nm_device_team_get_carrier (NMDeviceTeam *device);
+

Whether the device has carrier.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

device :

a NMDeviceTeam -

Returns :

-TRUE if the device has carrier

device

a NMDeviceTeam

 
+
+
+

Returns

+

TRUE if the device has carrier

+

+

Since 0.9.10


-

nm_device_team_get_slaves ()

-
const GPtrArray *   nm_device_team_get_slaves           (NMDeviceTeam *device);
-

-Gets the devices currently enslaved to device. -

-
+

nm_device_team_get_slaves ()

+
const GPtrArray *
+nm_device_team_get_slaves (NMDeviceTeam *device);
+

Gets the devices currently enslaved to device +.

+
+

Parameters

+
--++++ + + + + + +

device

a NMDeviceTeam

 
+
+
+

Returns

+

the GPtrArray containing +NMDevices that are slaves of device +. This is the internal +copy used by the device, and must not be modified.

+

[element-type NMDevice]

+
+

Since 0.9.10

+
+
+
+

Types and Values

+
+

enum NMDeviceTeamError

+
+

Members

+
++++ - - + + + + + + + + + + + + - - + +

device :

a NMDeviceTeam +

NM_DEVICE_TEAM_ERROR_UNKNOWN

+

unknown or unclassified error

+
 

NM_DEVICE_TEAM_ERROR_NOT_TEAM_CONNECTION

+

the connection was not of team type

+
 

NM_DEVICE_TEAM_ERROR_INVALID_TEAM_CONNECTION

+

the team connection was invalid

 

Returns :

the GPtrArray containing -NMDevices that are slaves of device. This is the internal -copy used by the device, and must not be modified. [element-type NMDevice] +

NM_DEVICE_TEAM_ERROR_INTERFACE_MISMATCH

+

the interfaces of the connection and the device mismatched

 
-

Since 0.9.10

-
-

Property Details

+
-

The "carrier" property

-
  "carrier"                  gboolean              : Read
+

NM_DEVICE_TEAM_ERROR

+
#define NM_DEVICE_TEAM_ERROR nm_device_team_error_quark ()
+

-Whether the device has carrier.

-

Default value: FALSE


-

The "hw-address" property

-
  "hw-address"               gchar*                : Read
+

NM_DEVICE_TEAM_HW_ADDRESS

+
#define NM_DEVICE_TEAM_HW_ADDRESS  "hw-address"
+

-The hardware (MAC) address of the device.

-

Default value: NULL


-

The "slaves" property

-
  "slaves"                   NMObjectArray*        : Read
+

NM_DEVICE_TEAM_CARRIER

+
#define NM_DEVICE_TEAM_CARRIER     "carrier"
+
+

+

+
+
+
+

NM_DEVICE_TEAM_SLAVES

+
#define NM_DEVICE_TEAM_SLAVES      "slaves"
+

-The devices (NMDevice) enslaved to the team device.

+
+

Property Details

+
+

The “carrier” property

+
  “carrier”                  gboolean
+

+

Flags: Read

+

Default value: FALSE

+
+
+
+

The “hw-address” property

+
  “hw-address”               gchar *
+

+

Flags: Read

+

Default value: NULL

+
+
+
+

The “slaves” property

+
  “slaves”                   NMObjectArray *
+

+

Flags: Read

+
+
+ Generated by GTK-Doc V1.21
\ No newline at end of file diff --git a/docs/libnm-glib/html/NMDeviceVlan.html b/docs/libnm-glib/html/NMDeviceVlan.html index 48198bf6..e28b1978 100644 --- a/docs/libnm-glib/html/NMDeviceVlan.html +++ b/docs/libnm-glib/html/NMDeviceVlan.html @@ -2,36 +2,28 @@ -NMDeviceVlan +libnm-glib Reference Manual: NMDeviceVlan - + - - - - - - - - - - + + + + + + +
@@ -39,356 +31,436 @@

NMDeviceVlan

NMDeviceVlan

- +
- -
-

Object Hierarchy

-
-  GObject
-   +----NMObject
-         +----NMDevice
-               +----NMDeviceVlan
-
-
-
-

Implemented Interfaces

-

-NMDeviceVlan implements - GInitable and GAsyncInitable.

-
-
-

Properties

-
-  "carrier"                  gboolean              : Read
-  "hw-address"               gchar*                : Read
-  "parent"                   NMDevice*             : Read
-  "vlan-id"                  guint                 : Read
-
-
-

Description

-

-

-
-
-

Details

-
-

enum NMDeviceVlanError

-
typedef enum {
-	NM_DEVICE_VLAN_ERROR_UNKNOWN = 0,             /*< nick=UnknownError >*/
-	NM_DEVICE_VLAN_ERROR_NOT_VLAN_CONNECTION,     /*< nick=NotVlanConnection >*/
-	NM_DEVICE_VLAN_ERROR_INVALID_VLAN_CONNECTION, /*< nick=InvalidVlanConnection >*/
-	NM_DEVICE_VLAN_ERROR_ID_MISMATCH,             /*< nick=IdMismatch >*/
-	NM_DEVICE_VLAN_ERROR_INTERFACE_MISMATCH,      /*< nick=InterfaceMismatch >*/
-	NM_DEVICE_VLAN_ERROR_MAC_MISMATCH,            /*< nick=MacMismatch >*/
-} NMDeviceVlanError;
-
-
+

Functions

+
--++ - - + - - + - - + - - + - - + - - +

NM_DEVICE_VLAN_ERROR_UNKNOWN

unknown or unclassified error + +GQuark + +nm_device_vlan_error_quark ()

NM_DEVICE_VLAN_ERROR_NOT_VLAN_CONNECTION

the connection was not of VLAN type + +GObject * + +nm_device_vlan_new ()

NM_DEVICE_VLAN_ERROR_INVALID_VLAN_CONNECTION

the VLAN connection was invalid +const char * + +nm_device_vlan_get_hw_address ()

NM_DEVICE_VLAN_ERROR_ID_MISMATCH

the VLAN identifiers of the connection and the device mismatched + +gboolean + +nm_device_vlan_get_carrier ()

NM_DEVICE_VLAN_ERROR_INTERFACE_MISMATCH

the interfaces of the connection and the device mismatched + +NMDevice * + +nm_device_vlan_get_parent ()

NM_DEVICE_VLAN_ERROR_MAC_MISMATCH

the MACs of the connection and the device mismatched + +guint + +nm_device_vlan_get_vlan_id ()
-
-
-

NM_DEVICE_VLAN_ERROR

-
#define NM_DEVICE_VLAN_ERROR nm_device_vlan_error_quark ()
-
-

-

-
-
-
-

nm_device_vlan_error_quark ()

-
GQuark              nm_device_vlan_error_quark          (void);
-

-Registers an error quark for NMDeviceVlan if necessary. -

-
+
+

Properties

+
--+++ - - - - + + + + + + + + + + + + + + + + + + + + + +

Returns :

the error quark used for NMDeviceVlan errors.
gbooleancarrierRead
+gchar *hw-addressRead
+NMDevice *parentRead
guintvlan-idRead
-
-
-

NM_DEVICE_VLAN_HW_ADDRESS

-
#define NM_DEVICE_VLAN_HW_ADDRESS  "hw-address"
-
-

-

-
-
-
-

NM_DEVICE_VLAN_CARRIER

-
#define NM_DEVICE_VLAN_CARRIER     "carrier"
-
-

-

+
+

Types and Values

+
++++ + + + + + + + + + + + + + + + + + + + + + + + + + + +
enumNMDeviceVlanError
#defineNM_DEVICE_VLAN_ERROR
#defineNM_DEVICE_VLAN_HW_ADDRESS
#defineNM_DEVICE_VLAN_CARRIER
#defineNM_DEVICE_VLAN_PARENT
#defineNM_DEVICE_VLAN_VLAN_ID
-
-
-

NM_DEVICE_VLAN_PARENT

-
#define NM_DEVICE_VLAN_PARENT      "parent"
+
+

Object Hierarchy

+
    GObject
+    ╰── NMObject
+        ╰── NMDevice
+            ╰── NMDeviceVlan
 
-

-

-
-
-

NM_DEVICE_VLAN_VLAN_ID

-
#define NM_DEVICE_VLAN_VLAN_ID     "vlan-id"
-
+
+

Description

-
+
+

Functions

-

NMDeviceVlan

-
typedef struct _NMDeviceVlan NMDeviceVlan;
-

-

+

nm_device_vlan_error_quark ()

+
GQuark
+nm_device_vlan_error_quark (void);
+

Registers an error quark for NMDeviceVlan if necessary.

+
+

Returns

+

the error quark used for NMDeviceVlan errors.

+

-
-
-

NMDeviceVlanClass

-
typedef struct {
-	NMDeviceClass parent;
-
-	/* Padding for future expansion */
-	void (*_reserved1) (void);
-	void (*_reserved2) (void);
-	void (*_reserved3) (void);
-	void (*_reserved4) (void);
-	void (*_reserved5) (void);
-	void (*_reserved6) (void);
-} NMDeviceVlanClass;
-
-

-


-

nm_device_vlan_new ()

-
GObject *           nm_device_vlan_new                  (DBusGConnection *connection,
-                                                         const char *path);
-

-Creates a new NMDeviceVlan. -

-
+

nm_device_vlan_new ()

+
GObject *
+nm_device_vlan_new (DBusGConnection *connection,
+                    const char *path);
+

Creates a new NMDeviceVlan.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + +

connection :

the DBusGConnection -

path :

the DBus object path of the device

connection

the DBusGConnection

 

Returns :

a new device. [transfer full] -

path

the DBus object path of the device

 
+
+

Returns

+

a new device.

+

[transfer full]

+
+

-

nm_device_vlan_get_hw_address ()

-
const char *        nm_device_vlan_get_hw_address       (NMDeviceVlan *device);
-

-Gets the hardware (MAC) address of the NMDeviceVlan -

-
+

nm_device_vlan_get_hw_address ()

+
const char *
+nm_device_vlan_get_hw_address (NMDeviceVlan *device);
+

Gets the hardware (MAC) address of the NMDeviceVlan

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

device :

a NMDeviceVlan -

Returns :

the hardware address. This is the internal string used by the -device, and must not be modified.

device

a NMDeviceVlan

 
+
+

Returns

+

the hardware address. This is the internal string used by the +device, and must not be modified.

+

+
+

-

nm_device_vlan_get_carrier ()

-
gboolean            nm_device_vlan_get_carrier          (NMDeviceVlan *device);
-

-Whether the device has carrier. -

-
+

nm_device_vlan_get_carrier ()

+
gboolean
+nm_device_vlan_get_carrier (NMDeviceVlan *device);
+

Whether the device has carrier.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

device :

a NMDeviceVlan -

Returns :

-TRUE if the device has carrier

device

a NMDeviceVlan

 
+
+

Returns

+

TRUE if the device has carrier

+

+
+

-

nm_device_vlan_get_parent ()

-
NMDevice *          nm_device_vlan_get_parent           (NMDeviceVlan *device);
-
+

nm_device_vlan_get_parent ()

+
NMDevice *
+nm_device_vlan_get_parent (NMDeviceVlan *device);
+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

device :

a NMDeviceVlan -

Returns :

the device's parent device. [transfer none] -

device

a NMDeviceVlan

 
+
+
+

Returns

+

the device's parent device.

+

[transfer none]

+

Since 1.0


-

nm_device_vlan_get_vlan_id ()

-
guint               nm_device_vlan_get_vlan_id          (NMDeviceVlan *device);
-
+

nm_device_vlan_get_vlan_id ()

+
guint
+nm_device_vlan_get_vlan_id (NMDeviceVlan *device);
+
+

Parameters

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

device

a NMDeviceVlan

 
+
+
+

Returns

+

the device's VLAN ID

+

+
+
+
+
+

Types and Values

+
+

enum NMDeviceVlanError

+
+

Members

+
--+++ - - + + - - + + + + + + + + + + + + + + + + + + + + + + +

device :

a NMDeviceVlan +

NM_DEVICE_VLAN_ERROR_UNKNOWN

+

unknown or unclassified error

 

Returns :

the device's VLAN ID

NM_DEVICE_VLAN_ERROR_NOT_VLAN_CONNECTION

+

the connection was not of VLAN type

+
 

NM_DEVICE_VLAN_ERROR_INVALID_VLAN_CONNECTION

+

the VLAN connection was invalid

+
 

NM_DEVICE_VLAN_ERROR_ID_MISMATCH

+

the VLAN identifiers of the connection and the device mismatched

+
 

NM_DEVICE_VLAN_ERROR_INTERFACE_MISMATCH

+

the interfaces of the connection and the device mismatched

+
 

NM_DEVICE_VLAN_ERROR_MAC_MISMATCH

+

the MACs of the connection and the device mismatched

+
 
-
-

Property Details

+
-

The "carrier" property

-
  "carrier"                  gboolean              : Read
+

NM_DEVICE_VLAN_ERROR

+
#define NM_DEVICE_VLAN_ERROR nm_device_vlan_error_quark ()
+

-Whether the device has carrier.

-

Default value: FALSE


-

The "hw-address" property

-
  "hw-address"               gchar*                : Read
+

NM_DEVICE_VLAN_HW_ADDRESS

+
#define NM_DEVICE_VLAN_HW_ADDRESS  "hw-address"
+

-The hardware (MAC) address of the device.

-

Default value: NULL


-

The "parent" property

-
  "parent"                   NMDevice*             : Read
+

NM_DEVICE_VLAN_CARRIER

+
#define NM_DEVICE_VLAN_CARRIER     "carrier"
+

-The devices's parent device.

-

Since 1.0


-

The "vlan-id" property

-
  "vlan-id"                  guint                 : Read
+

NM_DEVICE_VLAN_PARENT

+
#define NM_DEVICE_VLAN_PARENT      "parent"
+
+

+

+
+
+
+

NM_DEVICE_VLAN_VLAN_ID

+
#define NM_DEVICE_VLAN_VLAN_ID     "vlan-id"
+

-The device's VLAN ID.

+
+
+
+

Property Details

+
+

The “carrier” property

+
  “carrier”                  gboolean
+

+

Flags: Read

+

Default value: FALSE

+
+
+
+

The “hw-address” property

+
  “hw-address”               gchar *
+

+

Flags: Read

+

Default value: NULL

+
+
+
+

The “parent” property

+
  “parent”                   NMDevice *
+

+

Flags: Read

+

Since 1.0

+
+
+
+

The “vlan-id” property

+
  “vlan-id”                  guint
+

+

Flags: Read

Allowed values: <= 4095

Default value: 0

@@ -396,6 +468,6 @@ The device's VLAN ID.
+ Generated by GTK-Doc V1.21
\ No newline at end of file diff --git a/docs/libnm-glib/html/NMDeviceWifi.html b/docs/libnm-glib/html/NMDeviceWifi.html index 7a9a27df..fb153226 100644 --- a/docs/libnm-glib/html/NMDeviceWifi.html +++ b/docs/libnm-glib/html/NMDeviceWifi.html @@ -2,38 +2,29 @@ -NMDeviceWifi +libnm-glib Reference Manual: NMDeviceWifi - + - - - - - - - - - - + + + + + + +
@@ -41,678 +32,788 @@

NMDeviceWifi

NMDeviceWifi

- +
- -
-

Object Hierarchy

-
-  GObject
-   +----NMObject
-         +----NMDevice
-               +----NMDeviceWifi
-
-
-

Implemented Interfaces

-

-NMDeviceWifi implements - GInitable and GAsyncInitable.

-
-
-

Properties

-
-  "access-points"            NMObjectArray*        : Read
-  "active-access-point"      NMAccessPoint*        : Read
-  "bitrate"                  guint                 : Read
-  "hw-address"               gchar*                : Read
-  "mode"                     guint                 : Read
-  "perm-hw-address"          gchar*                : Read
-  "wireless-capabilities"    guint                 : Read
-
-
- -
-

Description

-

-

-
-
-

Details

-
-

enum NMDeviceWifiError

-
typedef enum {
-	NM_DEVICE_WIFI_ERROR_UNKNOWN = 0,             /*< nick=UnknownError >*/
-	NM_DEVICE_WIFI_ERROR_NOT_WIFI_CONNECTION,     /*< nick=NotWifiConnection >*/
-	NM_DEVICE_WIFI_ERROR_INVALID_WIFI_CONNECTION, /*< nick=InvalidWifiConnection >*/
-	NM_DEVICE_WIFI_ERROR_INVALID_DEVICE_MAC,      /*< nick=InvalidDeviceMac >*/
-	NM_DEVICE_WIFI_ERROR_MAC_MISMATCH,            /*< nick=MacMismatch >*/
-	NM_DEVICE_WIFI_ERROR_MISSING_DEVICE_WPA_CAPS, /*< nick=MissingDeviceWpaCaps >*/
-	NM_DEVICE_WIFI_ERROR_MISSING_DEVICE_RSN_CAPS, /*< nick=MissingDeviceRsnCaps >*/
-} NMDeviceWifiError;
-
-
+

Functions

+
--++ - - + - - + - - + - - + + + + + + + + + + + + + + + + + + + + + - - + - - + - - +

NM_DEVICE_WIFI_ERROR_UNKNOWN

unknown or unclassified error + +GQuark + +nm_device_wifi_error_quark ()

NM_DEVICE_WIFI_ERROR_NOT_WIFI_CONNECTION

the connection was not of Wi-Fi type + +GObject * + +nm_device_wifi_new ()

NM_DEVICE_WIFI_ERROR_INVALID_WIFI_CONNECTION

the Wi-Fi connection was invalid +const char * + +nm_device_wifi_get_hw_address ()

NM_DEVICE_WIFI_ERROR_INVALID_DEVICE_MAC

the device's MAC was invalid +const char * + +nm_device_wifi_get_permanent_hw_address () +
+NM80211Mode + +nm_device_wifi_get_mode () +
+guint32 + +nm_device_wifi_get_bitrate () +
+NMDeviceWifiCapabilities + +nm_device_wifi_get_capabilities () +
+NMAccessPoint * + +nm_device_wifi_get_active_access_point () +
+NMAccessPoint * + +nm_device_wifi_get_access_point_by_path ()

NM_DEVICE_WIFI_ERROR_MAC_MISMATCH

the MACs of the connection and the device mismatched +const GPtrArray * + +nm_device_wifi_get_access_points ()

NM_DEVICE_WIFI_ERROR_MISSING_DEVICE_WPA_CAPS

the device missed WPA capabilities -required by the connection + +void + +(*NMDeviceWifiRequestScanFn) ()

NM_DEVICE_WIFI_ERROR_MISSING_DEVICE_RSN_CAPS

the device missed RSN capabilities -required by the connection + +void + +nm_device_wifi_request_scan_simple ()
-
-
-

NM_DEVICE_WIFI_ERROR

-
#define NM_DEVICE_WIFI_ERROR nm_device_wifi_error_quark ()
-
-

-

+
+

Properties

+
+++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+NMObjectArray *access-pointsRead
+NMAccessPoint *active-access-pointRead
guintbitrateRead
+gchar *hw-addressRead
guintmodeRead
+gchar *perm-hw-addressRead
guintwireless-capabilitiesRead
-
-
-

nm_device_wifi_error_quark ()

-
GQuark              nm_device_wifi_error_quark          (void);
-

-Registers an error quark for NMDeviceWifi if necessary. -

-
+
+

Signals

+
--+++ - - - - + + + + + + + + + + + +

Returns :

the error quark used for NMDeviceWifi errors.
voidaccess-point-addedRun First
voidaccess-point-removedRun First
-
-
-

NM_DEVICE_WIFI_HW_ADDRESS

-
#define NM_DEVICE_WIFI_HW_ADDRESS          "hw-address"
-
-

-

+
+

Types and Values

+
-
-
-

NM_DEVICE_WIFI_PERMANENT_HW_ADDRESS

-
#define NM_DEVICE_WIFI_PERMANENT_HW_ADDRESS "perm-hw-address"
+
+

Object Hierarchy

+
    GObject
+    ╰── NMObject
+        ╰── NMDevice
+            ╰── NMDeviceWifi
 
-

-

-
-
-

NM_DEVICE_WIFI_MODE

-
#define NM_DEVICE_WIFI_MODE                "mode"
-
+
+

Description

-
+
+

Functions

-

NM_DEVICE_WIFI_BITRATE

-
#define NM_DEVICE_WIFI_BITRATE             "bitrate"
-
-

-

+

nm_device_wifi_error_quark ()

+
GQuark
+nm_device_wifi_error_quark (void);
+

Registers an error quark for NMDeviceWifi if necessary.

+
+

Returns

+

the error quark used for NMDeviceWifi errors.

+

-
-
-

NM_DEVICE_WIFI_ACTIVE_ACCESS_POINT

-
#define NM_DEVICE_WIFI_ACTIVE_ACCESS_POINT "active-access-point"
-
-

-


-

NM_DEVICE_WIFI_CAPABILITIES

-
#define NM_DEVICE_WIFI_CAPABILITIES        "wireless-capabilities"
-
-

-

+

nm_device_wifi_new ()

+
GObject *
+nm_device_wifi_new (DBusGConnection *connection,
+                    const char *path);
+

Creates a new NMDeviceWifi.

+
+

Parameters

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

connection

the DBusGConnection

 

path

the DBus object path of the device

 
+
+
+

Returns

+

a new Wi-Fi device.

+

[transfer full]

+

-

NM_DEVICE_WIFI_ACCESS_POINTS

-
#define NM_DEVICE_WIFI_ACCESS_POINTS       "access-points"
-
-

-

+

nm_device_wifi_get_hw_address ()

+
const char *
+nm_device_wifi_get_hw_address (NMDeviceWifi *device);
+

Gets the actual hardware (MAC) address of the NMDeviceWifi

+
+

Parameters

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

device

a NMDeviceWifi

 
+
+
+

Returns

+

the actual hardware address. This is the internal string used by the +device, and must not be modified.

+

+

-

NMDeviceWifi

-
typedef struct _NMDeviceWifi NMDeviceWifi;
-

-

+

nm_device_wifi_get_permanent_hw_address ()

+
const char *
+nm_device_wifi_get_permanent_hw_address
+                               (NMDeviceWifi *device);
+

Gets the permanent hardware (MAC) address of the NMDeviceWifi

+
+

Parameters

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

device

a NMDeviceWifi

 
+
+
+

Returns

+

the permanent hardware address. This is the internal string used by the +device, and must not be modified.

+

+

-

NMDeviceWifiClass

-
typedef struct {
-	NMDeviceClass parent;
-
-	/* Signals */
-	void (*access_point_added) (NMDeviceWifi *device, NMAccessPoint *ap);
-	void (*access_point_removed) (NMDeviceWifi *device, NMAccessPoint *ap);
-
-	/* Padding for future expansion */
-	void (*_reserved1) (void);
-	void (*_reserved2) (void);
-	void (*_reserved3) (void);
-	void (*_reserved4) (void);
-	void (*_reserved5) (void);
-	void (*_reserved6) (void);
-} NMDeviceWifiClass;
-
-

-

+

nm_device_wifi_get_mode ()

+
NM80211Mode
+nm_device_wifi_get_mode (NMDeviceWifi *device);
+

Gets the NMDeviceWifi mode.

+
+

Parameters

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

device

a NMDeviceWifi

 
+
+
+

Returns

+

the mode

+

+

-

nm_device_wifi_new ()

-
GObject *           nm_device_wifi_new                  (DBusGConnection *connection,
-                                                         const char *path);
-

-Creates a new NMDeviceWifi. -

-
+

nm_device_wifi_get_bitrate ()

+
guint32
+nm_device_wifi_get_bitrate (NMDeviceWifi *device);
+

Gets the bit rate of the NMDeviceWifi in kbit/s.

+
+

Parameters

+
--+++ - - - - - - - - - - - - - - + + + + +

connection :

the DBusGConnection -

path :

the DBus object path of the device

Returns :

a new Wi-Fi device. [transfer full] -

device

a NMDeviceWifi

 
+
+

Returns

+

the bit rate (kbit/s)

+

+
+

-

nm_device_wifi_get_hw_address ()

-
const char *        nm_device_wifi_get_hw_address       (NMDeviceWifi *device);
-

-Gets the actual hardware (MAC) address of the NMDeviceWifi -

-
+

nm_device_wifi_get_capabilities ()

+
NMDeviceWifiCapabilities
+nm_device_wifi_get_capabilities (NMDeviceWifi *device);
+

Gets the Wi-Fi capabilities of the NMDeviceWifi.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

device :

a NMDeviceWifi -

Returns :

the actual hardware address. This is the internal string used by the -device, and must not be modified.

device

a NMDeviceWifi

 
+
+

Returns

+

the capabilities

+

+
+

-

nm_device_wifi_get_permanent_hw_address ()

-
const char *        nm_device_wifi_get_permanent_hw_address
-                                                        (NMDeviceWifi *device);
-

-Gets the permanent hardware (MAC) address of the NMDeviceWifi -

-
+

nm_device_wifi_get_active_access_point ()

+
NMAccessPoint *
+nm_device_wifi_get_active_access_point
+                               (NMDeviceWifi *device);
+

Gets the active NMAccessPoint.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

device :

a NMDeviceWifi -

Returns :

the permanent hardware address. This is the internal string used by the -device, and must not be modified.

device

a NMDeviceWifi

 
+
+

Returns

+

the access point or NULL if none is active.

+

[transfer none]

+
+

-

nm_device_wifi_get_mode ()

-
NM80211Mode         nm_device_wifi_get_mode             (NMDeviceWifi *device);
-

-Gets the NMDeviceWifi mode. -

-
+

nm_device_wifi_get_access_point_by_path ()

+
NMAccessPoint *
+nm_device_wifi_get_access_point_by_path
+                               (NMDeviceWifi *device,
+                                const char *path);
+

Gets a NMAccessPoint by path.

+
+

Parameters

+
--+++ - - + + + - - + + +

device :

a NMDeviceWifi -

device

a NMDeviceWifi

 

Returns :

the mode

path

the object path of the access point

 
+
+

Returns

+

the access point or NULL if none is found.

+

[transfer none]

+
+

-

nm_device_wifi_get_bitrate ()

-
guint32             nm_device_wifi_get_bitrate          (NMDeviceWifi *device);
-

-Gets the bit rate of the NMDeviceWifi in kbit/s. -

-
+

nm_device_wifi_get_access_points ()

+
const GPtrArray *
+nm_device_wifi_get_access_points (NMDeviceWifi *device);
+

Gets all the scanned access points of the NMDeviceWifi.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

device :

a NMDeviceWifi -

Returns :

the bit rate (kbit/s)

device

a NMDeviceWifi

 
+
+

Returns

+

a GPtrArray containing all the +scanned NMAccessPoints. +The returned array is owned by the client and should not be modified.

+

[element-type NMAccessPoint]

+
+

-

nm_device_wifi_get_capabilities ()

-
NMDeviceWifiCapabilities nm_device_wifi_get_capabilities
-                                                        (NMDeviceWifi *device);
+

NMDeviceWifiRequestScanFn ()

+
void
+(*NMDeviceWifiRequestScanFn) (NMDeviceWifi *device,
+                              GError *error,
+                              gpointer user_data);

-Gets the Wi-Fi capabilities of the NMDeviceWifi.

-
+ +
+
+

nm_device_wifi_request_scan_simple ()

+
void
+nm_device_wifi_request_scan_simple (NMDeviceWifi *device,
+                                    NMDeviceWifiRequestScanFn callback,
+                                    gpointer user_data);
+

Request NM to scan for access points on the NMDeviceWifi. This function only +instructs NM to perform scanning. Use nm_device_wifi_get_access_points() +to get available access points.

+
+

Parameters

+
--+++ - - + + + + + + + + - - + + +

device :

a NMDeviceWifi -

device

a NMDeviceWifi

 

callback

the function to call when the call is done.

[scope async][allow-none]

Returns :

the capabilities

user_data

user data to pass to the callback function.

[closure]
-
+

Since 0.9.8

+
+
+
+

Types and Values

-

nm_device_wifi_get_active_access_point ()

-
NMAccessPoint *     nm_device_wifi_get_active_access_point
-                                                        (NMDeviceWifi *device);
-

-Gets the active NMAccessPoint. -

-
+

enum NMDeviceWifiError

+
+

Members

+
--+++ - - + + - - + + - -

device :

a NMDeviceWifi +

NM_DEVICE_WIFI_ERROR_UNKNOWN

+

unknown or unclassified error

 

Returns :

the access point or NULL if none is active. [transfer none] +

NM_DEVICE_WIFI_ERROR_NOT_WIFI_CONNECTION

+

the connection was not of Wi-Fi type

 
-
-
-
-

nm_device_wifi_get_access_point_by_path ()

-
NMAccessPoint *     nm_device_wifi_get_access_point_by_path
-                                                        (NMDeviceWifi *device,
-                                                         const char *path);
-

-Gets a NMAccessPoint by path. -

-
---- - - - + + - - + + + - - + + - -

device :

a NMDeviceWifi +

NM_DEVICE_WIFI_ERROR_INVALID_WIFI_CONNECTION

+

the Wi-Fi connection was invalid

 

path :

the object path of the access point

NM_DEVICE_WIFI_ERROR_INVALID_DEVICE_MAC

+

the device's MAC was invalid

+
 

Returns :

the access point or NULL if none is found. [transfer none] +

NM_DEVICE_WIFI_ERROR_MAC_MISMATCH

+

the MACs of the connection and the device mismatched

 
-
-
-
-

nm_device_wifi_get_access_points ()

-
const GPtrArray *   nm_device_wifi_get_access_points    (NMDeviceWifi *device);
-

-Gets all the scanned access points of the NMDeviceWifi. -

-
---- - - - + + - - + +

device :

a NMDeviceWifi +

NM_DEVICE_WIFI_ERROR_MISSING_DEVICE_WPA_CAPS

+

the device missed WPA capabilities +required by the connection

 

Returns :

a GPtrArray containing all the -scanned NMAccessPoints. -The returned array is owned by the client and should not be modified. [element-type NMAccessPoint] +

NM_DEVICE_WIFI_ERROR_MISSING_DEVICE_RSN_CAPS

+

the device missed RSN capabilities +required by the connection

 
+

-

NMDeviceWifiRequestScanFn ()

-
void                (*NMDeviceWifiRequestScanFn)        (NMDeviceWifi *device,
-                                                         GError *error,
-                                                         gpointer user_data);
+

NM_DEVICE_WIFI_ERROR

+
#define NM_DEVICE_WIFI_ERROR nm_device_wifi_error_quark ()
+


-

nm_device_wifi_request_scan_simple ()

-
void                nm_device_wifi_request_scan_simple  (NMDeviceWifi *device,
-                                                         NMDeviceWifiRequestScanFn callback,
-                                                         gpointer user_data);
+

NM_DEVICE_WIFI_HW_ADDRESS

+
#define NM_DEVICE_WIFI_HW_ADDRESS          "hw-address"
+

-Request NM to scan for access points on the NMDeviceWifi. This function only -instructs NM to perform scanning. Use nm_device_wifi_get_access_points() -to get available access points.

-
---- - - - - - - - - - - - - - - -

device :

a NMDeviceWifi -

callback :

the function to call when the call is done. [scope async][allow-none] -

user_data :

user data to pass to the callback function. [closure] -
-

Since 0.9.8

+
+
+

NM_DEVICE_WIFI_PERMANENT_HW_ADDRESS

+
#define NM_DEVICE_WIFI_PERMANENT_HW_ADDRESS "perm-hw-address"
+
+

+

-
-

Property Details

+
-

The "access-points" property

-
  "access-points"            NMObjectArray*        : Read
+

NM_DEVICE_WIFI_MODE

+
#define NM_DEVICE_WIFI_MODE                "mode"
+

-List of all Wi-Fi access points the device can see.

-

Since 0.9.10


-

The "active-access-point" property

-
  "active-access-point"      NMAccessPoint*        : Read
+

NM_DEVICE_WIFI_BITRATE

+
#define NM_DEVICE_WIFI_BITRATE             "bitrate"
+

-The active NMAccessPoint of the device.


-

The "bitrate" property

-
  "bitrate"                  guint                 : Read
+

NM_DEVICE_WIFI_ACTIVE_ACCESS_POINT

+
#define NM_DEVICE_WIFI_ACTIVE_ACCESS_POINT "active-access-point"
+

-The bit rate of the device in kbit/s.

-

Default value: 0


-

The "hw-address" property

-
  "hw-address"               gchar*                : Read
+

NM_DEVICE_WIFI_CAPABILITIES

+
#define NM_DEVICE_WIFI_CAPABILITIES        "wireless-capabilities"
+

-The hardware (MAC) address of the device.

-

Default value: NULL


-

The "mode" property

-
  "mode"                     guint                 : Read
+

NM_DEVICE_WIFI_ACCESS_POINTS

+
#define NM_DEVICE_WIFI_ACCESS_POINTS       "access-points"
+

-The mode of the device.

+
+
+
+

Property Details

+
+

The “access-points” property

+
  “access-points”            NMObjectArray *
+

+

Flags: Read

+

Since 0.9.10

+
+
+
+

The “active-access-point” property

+
  “active-access-point”      NMAccessPoint *
+

+

Flags: Read

+
+
+
+

The “bitrate” property

+
  “bitrate”                  guint
+

+

Flags: Read

+

Default value: 0

+
+
+
+

The “hw-address” property

+
  “hw-address”               gchar *
+

+

Flags: Read

+

Default value: NULL

+
+
+
+

The “mode” property

+
  “mode”                     guint
+

+

Flags: Read

Allowed values: <= 3

Default value: 2


-

The "perm-hw-address" property

-
  "perm-hw-address"          gchar*                : Read
-

-The hardware (MAC) address of the device. -

+

The “perm-hw-address” property

+
  “perm-hw-address”          gchar *
+

+

Flags: Read

Default value: NULL


-

The "wireless-capabilities" property

-
  "wireless-capabilities"    guint                 : Read
-

-The wireless capabilities of the device. -

+

The “wireless-capabilities” property

+
  “wireless-capabilities”    guint
+

+

Flags: Read

Default value: 0

Signal Details

-

The "access-point-added" signal

-
void                user_function                      (NMDeviceWifi *device,
-                                                        GObject      *ap,
-                                                        gpointer      user_data)      : Run First
-

-Notifies that a NMAccessPoint is added to the Wi-Fi device. -

-
---- - - - - - - - - - - - - - - -

device :

the Wi-Fi device that received the signal

ap :

the new access point

user_data :

user data set when the signal handler was connected.
+

The “access-point-added” signal

+
void
+user_function (NMDeviceWifi *device,
+               GObject      *ap,
+               gpointer      user_data)
+

Flags: Run First


-

The "access-point-removed" signal

-
void                user_function                      (NMDeviceWifi *device,
-                                                        GObject      *ap,
-                                                        gpointer      user_data)      : Run First
-

-Notifies that a NMAccessPoint is removed from the Wi-Fi device. -

-
---- - - - - - - - - - - - - - - -

device :

the Wi-Fi device that received the signal

ap :

the removed access point

user_data :

user data set when the signal handler was connected.
+

The “access-point-removed” signal

+
void
+user_function (NMDeviceWifi *device,
+               GObject      *ap,
+               gpointer      user_data)
+

Flags: Run First

+ Generated by GTK-Doc V1.21
\ No newline at end of file diff --git a/docs/libnm-glib/html/NMDeviceWimax.html b/docs/libnm-glib/html/NMDeviceWimax.html index e082543e..911ec29b 100644 --- a/docs/libnm-glib/html/NMDeviceWimax.html +++ b/docs/libnm-glib/html/NMDeviceWimax.html @@ -2,38 +2,29 @@ -NMDeviceWimax +libnm-glib Reference Manual: NMDeviceWimax - + - - - - - - - - - - + + + + + + +
@@ -41,662 +32,771 @@

NMDeviceWimax

NMDeviceWimax

- +
- -
-

Object Hierarchy

-
-  GObject
-   +----NMObject
-         +----NMDevice
-               +----NMDeviceWimax
-
-
-
-

Implemented Interfaces

-

-NMDeviceWimax implements - GInitable and GAsyncInitable.

-
-
-

Properties

-
-  "active-nsp"               NMWimaxNsp*           : Read
-  "bsid"                     gchar*                : Read
-  "center-frequency"         guint                 : Read
-  "cinr"                     gint                  : Read
-  "hw-address"               gchar*                : Read
-  "nsps"                     NMObjectArray*        : Read
-  "rssi"                     gint                  : Read
-  "tx-power"                 gint                  : Read
-
-
-

Signals

-
-  "nsp-added"                                      : Run First
-  "nsp-removed"                                    : Run First
-
-
-
-

Description

-

-

-
-
-

Details

-
-

enum NMDeviceWimaxError

-
typedef enum {
-	NM_DEVICE_WIMAX_ERROR_UNKNOWN = 0,              /*< nick=UnknownError >*/
-	NM_DEVICE_WIMAX_ERROR_NOT_WIMAX_CONNECTION,     /*< nick=NotWimaxConnection >*/
-	NM_DEVICE_WIMAX_ERROR_INVALID_WIMAX_CONNECTION, /*< nick=InvalidWimaxConnection >*/
-	NM_DEVICE_WIMAX_ERROR_INVALID_DEVICE_MAC,       /*< nick=InvalidDeviceMac >*/
-	NM_DEVICE_WIMAX_ERROR_MAC_MISMATCH,             /*< nick=MacMismatch >*/
-} NMDeviceWimaxError;
-
-
+

Functions

+
--++ - - + - - + - - + - - + - - + + + + + + + + + - -

NM_DEVICE_WIMAX_ERROR_UNKNOWN

unknown or unclassified error + +GQuark + +nm_device_wimax_error_quark ()

NM_DEVICE_WIMAX_ERROR_NOT_WIMAX_CONNECTION

the connection was not of WiMax type + +GObject * + +nm_device_wimax_new ()

NM_DEVICE_WIMAX_ERROR_INVALID_WIMAX_CONNECTION

the WiMax connection was invalid +const char * + +nm_device_wimax_get_hw_address ()

NM_DEVICE_WIMAX_ERROR_INVALID_DEVICE_MAC

the device's MAC was invalid + +NMWimaxNsp * + +nm_device_wimax_get_active_nsp ()

NM_DEVICE_WIMAX_ERROR_MAC_MISMATCH

the MACs of the connection and the device mismatched + +NMWimaxNsp * + +nm_device_wimax_get_nsp_by_path () +
const GPtrArray * + +nm_device_wimax_get_nsps () +
+guint + +nm_device_wimax_get_center_frequency ()
-
-
-
-

NM_DEVICE_WIMAX_ERROR

-
#define NM_DEVICE_WIMAX_ERROR nm_device_wimax_error_quark ()
-
-

-

-
-
-
-

nm_device_wimax_error_quark ()

-
GQuark              nm_device_wimax_error_quark         (void);
-

-Registers an error quark for NMDeviceWimax if necessary. -

-
---- - - - - -

Returns :

the error quark used for NMDeviceWimax errors.
-
-
-
-

NM_DEVICE_WIMAX_HW_ADDRESS

-
#define NM_DEVICE_WIMAX_HW_ADDRESS       "hw-address"
-
-

-

-
-
-
-

NM_DEVICE_WIMAX_ACTIVE_NSP

-
#define NM_DEVICE_WIMAX_ACTIVE_NSP       "active-nsp"
-
-

-

-
-
-
-

NM_DEVICE_WIMAX_CENTER_FREQUENCY

-
#define NM_DEVICE_WIMAX_CENTER_FREQUENCY "center-frequency"
-
-

-

-
-
-
-

NM_DEVICE_WIMAX_RSSI

-
#define NM_DEVICE_WIMAX_RSSI             "rssi"
-
-

-

-
-
-
-

NM_DEVICE_WIMAX_CINR

-
#define NM_DEVICE_WIMAX_CINR             "cinr"
-
-

-

-
-
-
-

NM_DEVICE_WIMAX_TX_POWER

-
#define NM_DEVICE_WIMAX_TX_POWER         "tx-power"
-
-

-

-
-
-
-

NM_DEVICE_WIMAX_BSID

-
#define NM_DEVICE_WIMAX_BSID             "bsid"
-
-

-

-
-
-
-

NM_DEVICE_WIMAX_NSPS

-
#define NM_DEVICE_WIMAX_NSPS             "nsps"
-
-

-

-
-
-
-

NMDeviceWimax

-
typedef struct _NMDeviceWimax NMDeviceWimax;
-

-

-
-
-
-

NMDeviceWimaxClass

-
typedef struct {
-	NMDeviceClass parent;
-
-	/* Signals */
-	void (*nsp_added)   (NMDeviceWimax *self, NMWimaxNsp *nsp);
-	void (*nsp_removed) (NMDeviceWimax *self, NMWimaxNsp *nsp);
-} NMDeviceWimaxClass;
-
-

-

-
-
-
-

nm_device_wimax_new ()

-
GObject *           nm_device_wimax_new                 (DBusGConnection *connection,
-                                                         const char *path);
-

-Creates a new NMDeviceWimax. -

-
---- - - - + - - + + - - + + + + +

connection :

the DBusGConnection + +gint + +nm_device_wimax_get_rssi ()

path :

the D-Bus object path of the WiMAX device +gint + +nm_device_wimax_get_cinr () +

Returns :

a new WiMAX device. [transfer full] + +gint + +nm_device_wimax_get_tx_power () +
const char * + +nm_device_wimax_get_bsid ()
-
-
-

nm_device_wimax_get_hw_address ()

-
const char *        nm_device_wimax_get_hw_address      (NMDeviceWimax *wimax);
-

-Gets the hardware (MAC) address of the NMDeviceWimax -

-
+
+

Properties

+
--+++ - - + + + + + + + + - - + + + + + + + + + + + + + + + + + + + + + + + + + + + +

wimax :

a NMDeviceWimax - +NMWimaxNsp *active-nspRead
+gchar *bsidRead

Returns :

the hardware address. This is the internal string used by the -device, and must not be modified.guintcenter-frequencyRead
gintcinrRead
+gchar *hw-addressRead
+NMObjectArray *nspsRead
gintrssiRead
ginttx-powerRead
-
-
-

nm_device_wimax_get_active_nsp ()

-
NMWimaxNsp *        nm_device_wimax_get_active_nsp      (NMDeviceWimax *wimax);
-

-Gets the active NMWimaxNsp. -

-
+
+

Signals

+
--+++ - - + + + - - + + +

wimax :

a NMDeviceWimax -voidnsp-addedRun First

Returns :

the access point or NULL if none is active. [transfer full] -voidnsp-removedRun First
-
-
-

nm_device_wimax_get_nsp_by_path ()

-
NMWimaxNsp *        nm_device_wimax_get_nsp_by_path     (NMDeviceWimax *wimax,
-                                                         const char *path);
-

-Gets a NMWimaxNsp by path. -

-
+
+

Types and Values

+
--++ - - + + - - + + - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

wimax :

a NMDeviceWimax -enumNMDeviceWimaxError

path :

the object path of the NSP#defineNM_DEVICE_WIMAX_ERROR

Returns :

the access point or NULL if none is found. [transfer none] -#defineNM_DEVICE_WIMAX_HW_ADDRESS
#defineNM_DEVICE_WIMAX_ACTIVE_NSP
#defineNM_DEVICE_WIMAX_CENTER_FREQUENCY
#defineNM_DEVICE_WIMAX_RSSI
#defineNM_DEVICE_WIMAX_CINR
#defineNM_DEVICE_WIMAX_TX_POWER
#defineNM_DEVICE_WIMAX_BSID
#defineNM_DEVICE_WIMAX_NSPS
-
-
-

nm_device_wimax_get_nsps ()

-
const GPtrArray *   nm_device_wimax_get_nsps            (NMDeviceWimax *wimax);
+
+

Object Hierarchy

+
    GObject
+    ╰── NMObject
+        ╰── NMDevice
+            ╰── NMDeviceWimax
+
+
+
+

Description

-Gets all the scanned NSPs of the NMDeviceWimax.

-
+ +
+

Functions

+
+

nm_device_wimax_error_quark ()

+
GQuark
+nm_device_wimax_error_quark (void);
+

Registers an error quark for NMDeviceWimax if necessary.

+
+

Returns

+

the error quark used for NMDeviceWimax errors.

+

+
+
+
+
+

nm_device_wimax_new ()

+
GObject *
+nm_device_wimax_new (DBusGConnection *connection,
+                     const char *path);
+

Creates a new NMDeviceWimax.

+
+

Parameters

+
--+++ - - + + + - - + + +

wimax :

a NMDeviceWimax -

connection

the DBusGConnection

 

Returns :

a GPtrArray containing -all the scanned NMWimaxNsps. -The returned array is owned by the client and should not be modified. [element-type NMWimaxNsp] -

path

the D-Bus object path of the WiMAX device

 
+
+

Returns

+

a new WiMAX device.

+

[transfer full]

+
+

-

nm_device_wimax_get_center_frequency ()

-
guint               nm_device_wimax_get_center_frequency
-                                                        (NMDeviceWimax *self);
-

-Gets the center frequency (in KHz) of the radio channel the device is using -to communicate with the network when connected. Has no meaning when the -device is not connected. -

-
+

nm_device_wimax_get_hw_address ()

+
const char *
+nm_device_wimax_get_hw_address (NMDeviceWimax *wimax);
+

Gets the hardware (MAC) address of the NMDeviceWimax

+
+

Parameters

+
--++++ + + + + + +

wimax

a NMDeviceWimax

 
+
+
+

Returns

+

the hardware address. This is the internal string used by the +device, and must not be modified.

+

+
+
+
+
+

nm_device_wimax_get_active_nsp ()

+
NMWimaxNsp *
+nm_device_wimax_get_active_nsp (NMDeviceWimax *wimax);
+

Gets the active NMWimaxNsp.

+
+

Parameters

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

wimax

a NMDeviceWimax

 
+
+
+

Returns

+

the access point or NULL if none is active.

+

[transfer full]

+
+
+
+
+

nm_device_wimax_get_nsp_by_path ()

+
NMWimaxNsp *
+nm_device_wimax_get_nsp_by_path (NMDeviceWimax *wimax,
+                                 const char *path);
+

Gets a NMWimaxNsp by path.

+
+

Parameters

+
++++ - - + + + - - + + +

self :

a NMDeviceWimax -

wimax

a NMDeviceWimax

 

Returns :

the center frequency in KHz, or 0

path

the object path of the NSP

 
+
+

Returns

+

the access point or NULL if none is found.

+

[transfer none]

+
+

-

nm_device_wimax_get_rssi ()

-
gint                nm_device_wimax_get_rssi            (NMDeviceWimax *self);
-

-Gets the RSSI of the current radio link in dBm. This value indicates how +

nm_device_wimax_get_nsps ()

+
const GPtrArray *
+nm_device_wimax_get_nsps (NMDeviceWimax *wimax);
+

Gets all the scanned NSPs of the NMDeviceWimax.

+
+

Parameters

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

wimax

a NMDeviceWimax

 
+
+
+

Returns

+

a GPtrArray containing +all the scanned NMWimaxNsps. +The returned array is owned by the client and should not be modified.

+

[element-type NMWimaxNsp]

+
+
+
+
+

nm_device_wimax_get_center_frequency ()

+
guint
+nm_device_wimax_get_center_frequency (NMDeviceWimax *self);
+

Gets the center frequency (in KHz) of the radio channel the device is using +to communicate with the network when connected. Has no meaning when the +device is not connected.

+
+

Parameters

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

self

a NMDeviceWimax

 
+
+
+

Returns

+

the center frequency in KHz, or 0

+

+
+
+
+
+

nm_device_wimax_get_rssi ()

+
gint
+nm_device_wimax_get_rssi (NMDeviceWimax *self);
+

Gets the RSSI of the current radio link in dBm. This value indicates how strong the raw received RF signal from the base station is, but does not indicate the overall quality of the radio link. Has no meaning when the -device is not connected. -

-
+device is not connected.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

self :

a NMDeviceWimax -

Returns :

the RSSI in dBm, or 0

self

a NMDeviceWimax

 
+
+

Returns

+

the RSSI in dBm, or 0

+

+
+

-

nm_device_wimax_get_cinr ()

-
gint                nm_device_wimax_get_cinr            (NMDeviceWimax *self);
-

-Gets the CINR (Carrier to Interference + Noise Ratio) of the current radio +

nm_device_wimax_get_cinr ()

+
gint
+nm_device_wimax_get_cinr (NMDeviceWimax *self);
+

Gets the CINR (Carrier to Interference + Noise Ratio) of the current radio link in dB. CINR is a more accurate measure of radio link quality. Has no -meaning when the device is not connected. -

-
+meaning when the device is not connected.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

self :

a NMDeviceWimax -

Returns :

the CINR in dB, or 0

self

a NMDeviceWimax

 
+
+

Returns

+

the CINR in dB, or 0

+

+
+

-

nm_device_wimax_get_tx_power ()

-
gint                nm_device_wimax_get_tx_power        (NMDeviceWimax *self);
-

-Average power of the last burst transmitted by the device, in units of +

nm_device_wimax_get_tx_power ()

+
gint
+nm_device_wimax_get_tx_power (NMDeviceWimax *self);
+

Average power of the last burst transmitted by the device, in units of 0.5 dBm. i.e. a TxPower of -11 represents an actual device TX power of --5.5 dBm. Has no meaning when the device is not connected. -

-
+-5.5 dBm. Has no meaning when the device is not connected.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

self :

a NMDeviceWimax -

Returns :

the TX power in dBm, or 0

self

a NMDeviceWimax

 
+
+

Returns

+

the TX power in dBm, or 0

+

+
+

-

nm_device_wimax_get_bsid ()

-
const char *        nm_device_wimax_get_bsid            (NMDeviceWimax *self);
-

-Gets the ID of the serving Base Station when the device is connected. -

-
+

nm_device_wimax_get_bsid ()

+
const char *
+nm_device_wimax_get_bsid (NMDeviceWimax *self);
+

Gets the ID of the serving Base Station when the device is connected.

+
+

Parameters

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

self

a NMDeviceWimax

 
+
+
+

Returns

+

the ID of the serving Base Station, or NULL

+

+
+
+
+
+

Types and Values

+
+

enum NMDeviceWimaxError

+
+

Members

+
--+++ - - + + + + + + + - - + + + + + + + + + + + +

self :

a NMDeviceWimax +

NM_DEVICE_WIMAX_ERROR_UNKNOWN

+

unknown or unclassified error

+
 

NM_DEVICE_WIMAX_ERROR_NOT_WIMAX_CONNECTION

+

the connection was not of WiMax type

 

Returns :

the ID of the serving Base Station, or NULL +

NM_DEVICE_WIMAX_ERROR_INVALID_WIMAX_CONNECTION

+

the WiMax connection was invalid

 

NM_DEVICE_WIMAX_ERROR_INVALID_DEVICE_MAC

+

the device's MAC was invalid

+
 

NM_DEVICE_WIMAX_ERROR_MAC_MISMATCH

+

the MACs of the connection and the device mismatched

+
 
-
-

Property Details

+
-

The "active-nsp" property

-
  "active-nsp"               NMWimaxNsp*           : Read
+

NM_DEVICE_WIMAX_ERROR

+
#define NM_DEVICE_WIMAX_ERROR nm_device_wimax_error_quark ()
+

-The active NMWimaxNsp of the device.


-

The "bsid" property

-
  "bsid"                     gchar*                : Read
+

NM_DEVICE_WIMAX_HW_ADDRESS

+
#define NM_DEVICE_WIMAX_HW_ADDRESS       "hw-address"
+

-The ID of the serving base station as received from the network. Has -no meaning when the device is not connected.

-

Default value: NULL


-

The "center-frequency" property

-
  "center-frequency"         guint                 : Read
+

NM_DEVICE_WIMAX_ACTIVE_NSP

+
#define NM_DEVICE_WIMAX_ACTIVE_NSP       "active-nsp"
+

-The center frequency (in KHz) of the radio channel the device is using to -communicate with the network when connected. Has no meaning when the -device is not connected.

-

Default value: 0


-

The "cinr" property

-
  "cinr"                     gint                  : Read
+

NM_DEVICE_WIMAX_CENTER_FREQUENCY

+
#define NM_DEVICE_WIMAX_CENTER_FREQUENCY "center-frequency"
+
+

+

+
+
+
+

NM_DEVICE_WIMAX_RSSI

+
#define NM_DEVICE_WIMAX_RSSI             "rssi"
+

-CINR (Carrier to Interference + Noise Ratio) of the current radio link -in dB. CINR is a more accurate measure of radio link quality. Has no -meaning when the device is not connected.

-

Default value: 0


-

The "hw-address" property

-
  "hw-address"               gchar*                : Read
+

NM_DEVICE_WIMAX_CINR

+
#define NM_DEVICE_WIMAX_CINR             "cinr"
+

-The hardware (MAC) address of the device.

-

Default value: NULL


-

The "nsps" property

-
  "nsps"                     NMObjectArray*        : Read
+

NM_DEVICE_WIMAX_TX_POWER

+
#define NM_DEVICE_WIMAX_TX_POWER         "tx-power"
+

-List of all WiMAX Network Service Providers the device can see.

-

Since 0.9.10


-

The "rssi" property

-
  "rssi"                     gint                  : Read
+

NM_DEVICE_WIMAX_BSID

+
#define NM_DEVICE_WIMAX_BSID             "bsid"
+

-RSSI of the current radio link in dBm. This value indicates how strong -the raw received RF signal from the base station is, but does not -indicate the overall quality of the radio link. Has no meaning when the -device is not connected.

-

Default value: 0


-

The "tx-power" property

-
  "tx-power"                 gint                  : Read
+

NM_DEVICE_WIMAX_NSPS

+
#define NM_DEVICE_WIMAX_NSPS             "nsps"
+

-Average power of the last burst transmitted by the device, in units of -0.5 dBm. i.e. a TxPower of -11 represents an actual device TX power of --5.5 dBm. Has no meaning when the device is not connected.

+
+
+
+

Property Details

+
+

The “active-nsp” property

+
  “active-nsp”               NMWimaxNsp *
+

+

Flags: Read

+
+
+
+

The “bsid” property

+
  “bsid”                     gchar *
+

+

Flags: Read

+

Default value: NULL

+
+
+
+

The “center-frequency” property

+
  “center-frequency”         guint
+

+

Flags: Read

+

Default value: 0

+
+
+
+

The “cinr” property

+
  “cinr”                     gint
+

+

Flags: Read

+

Default value: 0

+
+
+
+

The “hw-address” property

+
  “hw-address”               gchar *
+

+

Flags: Read

+

Default value: NULL

+
+
+
+

The “nsps” property

+
  “nsps”                     NMObjectArray *
+

+

Flags: Read

+

Since 0.9.10

+
+
+
+

The “rssi” property

+
  “rssi”                     gint
+

+

Flags: Read

+

Default value: 0

+
+
+
+

The “tx-power” property

+
  “tx-power”                 gint
+

+

Flags: Read

Default value: 0

Signal Details

-

The "nsp-added" signal

-
void                user_function                      (NMDeviceWimax *self,
-                                                        GObject       *nsp,
-                                                        gpointer       user_data)      : Run First
-

-Notifies that a NMWimaxNsp is added to the wimax device. -

-
---- - - - - - - - - - - - - - - -

self :

the wimax device that received the signal

nsp :

the new NSP

user_data :

user data set when the signal handler was connected.
+

The “nsp-added” signal

+
void
+user_function (NMDeviceWimax *self,
+               GObject       *nsp,
+               gpointer       user_data)
+

Flags: Run First


-

The "nsp-removed" signal

-
void                user_function                      (NMDeviceWimax *self,
-                                                        GObject       *nsp,
-                                                        gpointer       user_data)      : Run First
-

-Notifies that a NMWimaxNsp is removed from the wimax device. -

-
---- - - - - - - - - - - - - - - -

self :

the wimax device that received the signal

nsp :

the removed NSP

user_data :

user data set when the signal handler was connected.
+

The “nsp-removed” signal

+
void
+user_function (NMDeviceWimax *self,
+               GObject       *nsp,
+               gpointer       user_data)
+

Flags: Run First

+ Generated by GTK-Doc V1.21
\ No newline at end of file diff --git a/docs/libnm-glib/html/NMIP4Config.html b/docs/libnm-glib/html/NMIP4Config.html index 6396397d..fec85cac 100644 --- a/docs/libnm-glib/html/NMIP4Config.html +++ b/docs/libnm-glib/html/NMIP4Config.html @@ -2,36 +2,28 @@ -NMIP4Config +libnm-glib Reference Manual: NMIP4Config - + - - - - - - - - - - + + + + + + +
@@ -39,431 +31,531 @@

NMIP4Config

NMIP4Config

- +
- -
-

Object Hierarchy

-
-  GObject
-   +----NMObject
-         +----NMIP4Config
-
-
-

Implemented Interfaces

-

-NMIP4Config implements - GInitable and GAsyncInitable.

-
-
-

Properties

-
-  "addresses"                gpointer              : Read
-  "domains"                  NMStringArray*        : Read
-  "gateway"                  gchar*                : Read
-  "nameservers"              NMUintArray*          : Read
-  "routes"                   gpointer              : Read
-  "searches"                 NMStringArray*        : Read
-  "wins-servers"             NMUintArray*          : Read
-
-
-
-

Description

-

-

-
-
-

Details

-
-

NMIP4Config

-
typedef struct _NMIP4Config NMIP4Config;
-

-

-
-
-
-

NMIP4ConfigClass

-
typedef struct {
-	NMObjectClass parent;
-
-	/* Padding for future expansion */
-	void (*_reserved1) (void);
-	void (*_reserved2) (void);
-	void (*_reserved3) (void);
-	void (*_reserved4) (void);
-	void (*_reserved5) (void);
-	void (*_reserved6) (void);
-} NMIP4ConfigClass;
-
-

-

-
-
-
-

NM_IP4_CONFIG_GATEWAY

-
#define NM_IP4_CONFIG_GATEWAY "gateway"
-
-

-

-
-
-
-

NM_IP4_CONFIG_ADDRESSES

-
#define NM_IP4_CONFIG_ADDRESSES "addresses"
-
-

-

-
-
-
-

NM_IP4_CONFIG_ROUTES

-
#define NM_IP4_CONFIG_ROUTES "routes"
-
-

-

-
-
-
-

NM_IP4_CONFIG_NAMESERVERS

-
#define NM_IP4_CONFIG_NAMESERVERS "nameservers"
-
-

-

-
-
-
-

NM_IP4_CONFIG_DOMAINS

-
#define NM_IP4_CONFIG_DOMAINS "domains"
-
-

-

-
-
-
-

NM_IP4_CONFIG_SEARCHES

-
#define NM_IP4_CONFIG_SEARCHES "searches"
-
-

-

-
-
-
-

NM_IP4_CONFIG_WINS_SERVERS

-
#define NM_IP4_CONFIG_WINS_SERVERS "wins-servers"
-
-

-

-
-
-
-

nm_ip4_config_new ()

-
GObject *           nm_ip4_config_new                   (DBusGConnection *connection,
-                                                         const char *object_path);
-

-Creates a new NMIP4Config. -

-
+

Functions

+
--++ - - + - - + + - - + - -

connection :

the DBusGConnection + +GObject * + +nm_ip4_config_new ()

object_path :

the DBus object path of the deviceconst char * + +nm_ip4_config_get_gateway () +

Returns :

a new IP4 configuration. [transfer full] +const GSList * + +nm_ip4_config_get_addresses ()
-
-
-
-

nm_ip4_config_get_gateway ()

-
const char *        nm_ip4_config_get_gateway           (NMIP4Config *config);
-

-Gets the IP4 gateway address. -

-
---- - - - + - - + + + + + + - -

config :

a NMIP4Config +const GSList * + +nm_ip4_config_get_routes ()

Returns :

the IP4 address of the gateway.const GArray * + +nm_ip4_config_get_nameservers () +
const GPtrArray * + +nm_ip4_config_get_domains () +
-

Since 0.9.10

-
-
-
-

nm_ip4_config_get_addresses ()

-
const GSList *      nm_ip4_config_get_addresses         (NMIP4Config *config);
-

-Gets the IP4 addresses (containing the address, prefix, and gateway). -

-
---- - - - + - - +

config :

a NMIP4Config +const GPtrArray * + +nm_ip4_config_get_searches ()

Returns :

the GSList containing NMIP4Addresses. -This is the internal copy used by the configuration and must not be modified. [element-type NMIP4Address] +const GArray * + +nm_ip4_config_get_wins_servers ()
-
-
-

nm_ip4_config_get_routes ()

-
const GSList *      nm_ip4_config_get_routes            (NMIP4Config *config);
-

-Gets the routes. -

-
+
+

Properties

+
--+++ - - + + + - - + + + + + + + + + + + + + + + + + + + + + + + + + + + +

config :

a NMIP4Config -gpointeraddressesRead

Returns :

the GSList containing -NMIP4Routes. This is the internal copy used by the configuration, -and must not be modified. [element-type NMIP4Route] - +NMStringArray *domainsRead
+gchar *gatewayRead
+NMUintArray *nameserversRead
gpointerroutesRead
+NMStringArray *searchesRead
+NMUintArray *wins-serversRead
-
-
-

nm_ip4_config_get_nameservers ()

-
const GArray *      nm_ip4_config_get_nameservers       (NMIP4Config *config);
-

-Gets the domain name servers (DNS). -

-
+
+

Types and Values

+
--++ - - + + - - + + + + + + + + + + + + + + + + + + + + + +

config :

a NMIP4Config -#defineNM_IP4_CONFIG_GATEWAY

Returns :

the GArray containing guint32s. -This is the internal copy used by the configuration and must not be -modified. [element-type guint32] -#defineNM_IP4_CONFIG_ADDRESSES
#defineNM_IP4_CONFIG_ROUTES
#defineNM_IP4_CONFIG_NAMESERVERS
#defineNM_IP4_CONFIG_DOMAINS
#defineNM_IP4_CONFIG_SEARCHES
#defineNM_IP4_CONFIG_WINS_SERVERS
-
-
-

nm_ip4_config_get_domains ()

-
const GPtrArray *   nm_ip4_config_get_domains           (NMIP4Config *config);
+
+

Object Hierarchy

+
    GObject
+    ╰── NMObject
+        ╰── NMIP4Config
+
+
+
+

Description

-Gets the domain names.

-
+ +
+

Functions

+
+

nm_ip4_config_new ()

+
GObject *
+nm_ip4_config_new (DBusGConnection *connection,
+                   const char *object_path);
+

Creates a new NMIP4Config.

+
+

Parameters

+
--+++ - - + + + - - + + +

config :

a NMIP4Config -

connection

the DBusGConnection

 

Returns :

the GPtrArray containing domains as strings. This is the -internal copy used by the configuration, and must not be modified. [element-type utf8] -

object_path

the DBus object path of the device

 
+
+

Returns

+

a new IP4 configuration.

+

[transfer full]

+
+

-

nm_ip4_config_get_searches ()

-
const GPtrArray *   nm_ip4_config_get_searches          (NMIP4Config *config);
-

-Gets the dns searches. -

-
+

nm_ip4_config_get_gateway ()

+
const char *
+nm_ip4_config_get_gateway (NMIP4Config *config);
+

Gets the IP4 gateway address.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

config :

a NMIP4Config -

Returns :

the GPtrArray containing dns searches as strings. This is the -internal copy used by the configuration, and must not be modified. [element-type utf8] -

config

a NMIP4Config

 
+
+
+

Returns

+

the IP4 address of the gateway.

+

+

Since 0.9.10


-

nm_ip4_config_get_wins_servers ()

-
const GArray *      nm_ip4_config_get_wins_servers      (NMIP4Config *config);
-

-Gets the Windows Internet Name Service servers (WINS). -

-
+

nm_ip4_config_get_addresses ()

+
const GSList *
+nm_ip4_config_get_addresses (NMIP4Config *config);
+

Gets the IP4 addresses (containing the address, prefix, and gateway).

+
+

Parameters

+
--+++ - - - - - - - - + + + + +

config :

a NMIP4Config -

Returns :

the GArray containing guint32s. +

config

a NMIP4Config

 
+
+
+

Returns

+

the GSList containing NMIP4Addresses. +This is the internal copy used by the configuration and must not be modified.

+

[element-type NMIP4Address]

+
+
+
+
+

nm_ip4_config_get_routes ()

+
const GSList *
+nm_ip4_config_get_routes (NMIP4Config *config);
+

Gets the routes.

+
+

Parameters

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

config

a NMIP4Config

 
+
+
+

Returns

+

the GSList containing +NMIP4Routes. This is the internal copy used by the configuration, +and must not be modified.

+

[element-type NMIP4Route]

+
+
+
+
+

nm_ip4_config_get_nameservers ()

+
const GArray *
+nm_ip4_config_get_nameservers (NMIP4Config *config);
+

Gets the domain name servers (DNS).

+
+

Parameters

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

config

a NMIP4Config

 
+
+
+

Returns

+

the GArray containing guint32s. This is the internal copy used by the configuration and must not be -modified. [element-type guint32] - - - +modified.

+

[element-type guint32]

+
+
+
+
+

nm_ip4_config_get_domains ()

+
const GPtrArray *
+nm_ip4_config_get_domains (NMIP4Config *config);
+

Gets the domain names.

+
+

Parameters

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

config

a NMIP4Config

 
+
+
+

Returns

+

the GPtrArray containing domains as strings. This is the +internal copy used by the configuration, and must not be modified.

+

[element-type utf8]

+
+
+
+
+

nm_ip4_config_get_searches ()

+
const GPtrArray *
+nm_ip4_config_get_searches (NMIP4Config *config);
+

Gets the dns searches.

+
+

Parameters

+
+++++ + + + + +

config

a NMIP4Config

 
+
+

Returns

+

the GPtrArray containing dns searches as strings. This is the +internal copy used by the configuration, and must not be modified.

+

[element-type utf8]

+
+

Since 0.9.10

+
+
+
+

nm_ip4_config_get_wins_servers ()

+
const GArray *
+nm_ip4_config_get_wins_servers (NMIP4Config *config);
+

Gets the Windows Internet Name Service servers (WINS).

+
+

Parameters

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

config

a NMIP4Config

 
+
+
+

Returns

+

the GArray containing guint32s. +This is the internal copy used by the configuration and must not be +modified.

+

[element-type guint32]

+
+
-

Property Details

+

Types and Values

-

The "addresses" property

-
  "addresses"                gpointer              : Read
+

NM_IP4_CONFIG_GATEWAY

+
#define NM_IP4_CONFIG_GATEWAY "gateway"
+

-The GPtrArray containing NMIP4Addresses of the configuration.


-

The "domains" property

-
  "domains"                  NMStringArray*        : Read
+

NM_IP4_CONFIG_ADDRESSES

+
#define NM_IP4_CONFIG_ADDRESSES "addresses"
+

-The GPtrArray containing domain strings of the configuration.


-

The "gateway" property

-
  "gateway"                  gchar*                : Read
+

NM_IP4_CONFIG_ROUTES

+
#define NM_IP4_CONFIG_ROUTES "routes"
+

-The IP4 gateway address of the configuration as string.

-

Default value: NULL

-

Since 0.9.10


-

The "nameservers" property

-
  "nameservers"              NMUintArray*          : Read
+

NM_IP4_CONFIG_NAMESERVERS

+
#define NM_IP4_CONFIG_NAMESERVERS "nameservers"
+

-The GArray containing name servers (guint32s) of the configuration.


-

The "routes" property

-
  "routes"                   gpointer              : Read
+

NM_IP4_CONFIG_DOMAINS

+
#define NM_IP4_CONFIG_DOMAINS "domains"
+

-The GPtrArray containing NMSettingIP4Routes of the configuration.


-

The "searches" property

-
  "searches"                 NMStringArray*        : Read
+

NM_IP4_CONFIG_SEARCHES

+
#define NM_IP4_CONFIG_SEARCHES "searches"
+

-The GPtrArray containing dns search strings of the configuration.

-

Since 0.9.10


-

The "wins-servers" property

-
  "wins-servers"             NMUintArray*          : Read
+

NM_IP4_CONFIG_WINS_SERVERS

+
#define NM_IP4_CONFIG_WINS_SERVERS "wins-servers"
+

-The GArray containing WINS servers (guint32s) of the configuration.

+
+

Property Details

+
+

The “addresses” property

+
  “addresses”                gpointer
+

+

Flags: Read

+
+
+
+

The “domains” property

+
  “domains”                  NMStringArray *
+

+

Flags: Read

+
+
+
+

The “gateway” property

+
  “gateway”                  gchar *
+

+

Flags: Read

+

Default value: NULL

+

Since 0.9.10

+
+
+
+

The “nameservers” property

+
  “nameservers”              NMUintArray *
+

+

Flags: Read

+
+
+
+

The “routes” property

+
  “routes”                   gpointer
+

+

Flags: Read

+
+
+
+

The “searches” property

+
  “searches”                 NMStringArray *
+

+

Flags: Read

+

Since 0.9.10

+
+
+
+

The “wins-servers” property

+
  “wins-servers”             NMUintArray *
+

+

Flags: Read

+
+
+ Generated by GTK-Doc V1.21
\ No newline at end of file diff --git a/docs/libnm-glib/html/NMIP6Config.html b/docs/libnm-glib/html/NMIP6Config.html index d923c6f7..83f5f473 100644 --- a/docs/libnm-glib/html/NMIP6Config.html +++ b/docs/libnm-glib/html/NMIP6Config.html @@ -2,36 +2,28 @@ -NMIP6Config +libnm-glib Reference Manual: NMIP6Config - + - - - - - - - - - - + + + + + + +
@@ -39,450 +31,554 @@

NMIP6Config

NMIP6Config

- +
- -
-

Object Hierarchy

-
-  GObject
-   +----NMObject
-         +----NMIP6Config
-
-
-
-

Implemented Interfaces

-

-NMIP6Config implements - GInitable and GAsyncInitable.

-
-
-

Properties

-
-  "addresses"                NMIP6AddressObjectArray*  : Read
-  "domains"                  NMStringArray*        : Read
-  "gateway"                  gchar*                : Read
-  "nameservers"              NMIP6AddressArray*    : Read
-  "routes"                   NMIP6RouteObjectArray*  : Read
-  "searches"                 NMStringArray*        : Read
-
-
-
-

Description

-

-

-
-

Details

-
-

NMIP6Config

-
typedef struct _NMIP6Config NMIP6Config;
-

-

-
-
-
-

NMIP6ConfigClass

-
typedef struct {
-	NMObjectClass parent;
-
-	/* Padding for future expansion */
-	void (*_reserved1) (void);
-	void (*_reserved2) (void);
-	void (*_reserved3) (void);
-	void (*_reserved4) (void);
-	void (*_reserved5) (void);
-	void (*_reserved6) (void);
-} NMIP6ConfigClass;
-
-

-

-
-
-
-

NM_IP6_CONFIG_GATEWAY

-
#define NM_IP6_CONFIG_GATEWAY "gateway"
-
-

-

-
-
-
-

NM_IP6_CONFIG_ADDRESSES

-
#define NM_IP6_CONFIG_ADDRESSES "addresses"
-
-

-

-
-
-
-

NM_IP6_CONFIG_ROUTES

-
#define NM_IP6_CONFIG_ROUTES "routes"
-
-

-

-
-
-
-

NM_IP6_CONFIG_NAMESERVERS

-
#define NM_IP6_CONFIG_NAMESERVERS "nameservers"
-
-

-

-
-
-
-

NM_IP6_CONFIG_DOMAINS

-
#define NM_IP6_CONFIG_DOMAINS "domains"
-
-

-

-
-
-
-

NM_IP6_CONFIG_SEARCHES

-
#define NM_IP6_CONFIG_SEARCHES "searches"
-
-

-

-
-
-
-

nm_ip6_config_new ()

-
GObject *           nm_ip6_config_new                   (DBusGConnection *connection,
-                                                         const char *object_path);
-

-Creates a new NMIP6Config. -

-
+

Functions

+
--++ - - + + + + + + + + + + + + + + + + + - - + + - - + + + + + + + + +

connection :

the DBusGConnection + +GObject * + +nm_ip6_config_new () +
const char * + +nm_ip6_config_get_gateway () +
const GSList * + +nm_ip6_config_get_addresses () +
const GSList * + +nm_ip6_config_get_routes () +
+guint32 + +nm_ip6_config_get_num_nameservers ()

object_path :

the DBus object path of the deviceconst struct in6_addr * + +nm_ip6_config_get_nameserver () +

Returns :

a new IP6 configuration. [transfer full] +const GSList * + +nm_ip6_config_get_nameservers () +
const GPtrArray * + +nm_ip6_config_get_domains () +
const GPtrArray * + +nm_ip6_config_get_searches ()
-
-
-

nm_ip6_config_get_gateway ()

-
const char *        nm_ip6_config_get_gateway           (NMIP6Config *config);
-

-Gets the IP6 gateway. -

-
+
+

Properties

+
--+++ - - + + + + + + + + + + + + + + + + + + + + + + + - - + + +

config :

a NMIP6Config - +NMIP6AddressObjectArray *addressesRead
+NMStringArray *domainsRead
+gchar *gatewayRead
+NMIP6AddressArray *nameserversRead
+NMIP6RouteObjectArray *routesRead

Returns :

the IPv6 gateway of the configuration. +NMStringArray *searchesRead
-

Since 0.9.10

-
-
-

nm_ip6_config_get_addresses ()

-
const GSList *      nm_ip6_config_get_addresses         (NMIP6Config *config);
-

-Gets the IP6 addresses (containing the address, prefix, and gateway). -

-
+
+

Types and Values

+
--++ - - + + - - + + + + + + + + + + + + + + + + + +

config :

a NMIP6Config -#defineNM_IP6_CONFIG_GATEWAY

Returns :

the GSList containing -NMIP6Addresses. This is the internal copy used by the configuration -and must not be modified. [element-type NMIP6Address] -#defineNM_IP6_CONFIG_ADDRESSES
#defineNM_IP6_CONFIG_ROUTES
#defineNM_IP6_CONFIG_NAMESERVERS
#defineNM_IP6_CONFIG_DOMAINS
#defineNM_IP6_CONFIG_SEARCHES
-
-
-

nm_ip6_config_get_routes ()

-
const GSList *      nm_ip6_config_get_routes            (NMIP6Config *config);
+
+

Object Hierarchy

+
    GObject
+    ╰── NMObject
+        ╰── NMIP6Config
+
+
+
+

Description

-Gets the routes.

-
+ +
+

Functions

+
+

nm_ip6_config_new ()

+
GObject *
+nm_ip6_config_new (DBusGConnection *connection,
+                   const char *object_path);
+

Creates a new NMIP6Config.

+
+

Parameters

+
--+++ - - + + + - - + + +

config :

a NMIP6Config -

connection

the DBusGConnection

 

Returns :

the GSList containing -NMIP6Routes. This is the internal copy used by the configuration, -and must not be modified. [element-type NMIP6Route] -

object_path

the DBus object path of the device

 
+
+

Returns

+

a new IP6 configuration.

+

[transfer full]

+
+

-

nm_ip6_config_get_num_nameservers ()

-
guint32             nm_ip6_config_get_num_nameservers   (NMIP6Config *config);
-

-Gets the number of the domain name servers in the configuration. -

-
+

nm_ip6_config_get_gateway ()

+
const char *
+nm_ip6_config_get_gateway (NMIP6Config *config);
+

Gets the IP6 gateway.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

config :

a NMIP6Config -

Returns :

the number of domain name servers

config

a NMIP6Config

 
+
+
+

Returns

+

the IPv6 gateway of the configuration.

+

+

Since 0.9.10


-

nm_ip6_config_get_nameserver ()

-
const struct in6_addr * nm_ip6_config_get_nameserver    (NMIP6Config *config,
-                                                         guint32 idx);
-

-Gets the domain name server at index idx in the configuration. -

-
+

nm_ip6_config_get_addresses ()

+
const GSList *
+nm_ip6_config_get_addresses (NMIP6Config *config);
+

Gets the IP6 addresses (containing the address, prefix, and gateway).

+
+

Parameters

+
--+++ - - - - - - - - - - - - - - + + + + + +

config :

a NMIP6Config -

idx :

index of the nameserver to return

Returns :

the IPv6 address of domain name server at index iidx. [array fixed-size=16][element-type guint8][transfer none] -

config

a NMIP6Config

 
+
+
+

Returns

+

the GSList containing +NMIP6Addresses. This is the internal copy used by the configuration +and must not be modified.

+

[element-type NMIP6Address]

+
+
+
+
+

nm_ip6_config_get_routes ()

+
const GSList *
+nm_ip6_config_get_routes (NMIP6Config *config);
+

Gets the routes.

+
+

Parameters

+
+++++ + + + + +

config

a NMIP6Config

 
+
+
+

Returns

+

the GSList containing +NMIP6Routes. This is the internal copy used by the configuration, +and must not be modified.

+

[element-type NMIP6Route]

+
+
+
+
+

nm_ip6_config_get_num_nameservers ()

+
guint32
+nm_ip6_config_get_num_nameservers (NMIP6Config *config);
+

Gets the number of the domain name servers in the configuration.

+
+

Parameters

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

config

a NMIP6Config

 
+
+
+

Returns

+

the number of domain name servers

+

+

Since 0.9.10


-

nm_ip6_config_get_nameservers ()

-
const GSList *      nm_ip6_config_get_nameservers       (NMIP6Config *config);
-

-Gets the domain name servers (DNS). -

-
+

nm_ip6_config_get_nameserver ()

+
const struct in6_addr *
+nm_ip6_config_get_nameserver (NMIP6Config *config,
+                              guint32 idx);
+

Gets the domain name server at index idx + in the configuration.

+
+

Parameters

+
--+++ - - + + + - - + + +

config :

a NMIP6Config -

config

a NMIP6Config

 

Returns :

a GSList containing elements of type 'struct in6_addr' which -contain the addresses of nameservers of the configuration. This is the -internal copy used by the configuration and must not be modified.

idx

index of the nameserver to return

 
+
+

Returns

+

the IPv6 address of domain name server at index iidx +.

+

[array fixed-size=16][element-type guint8][transfer none]

+
+

Since 0.9.10

+
-

nm_ip6_config_get_domains ()

-
const GPtrArray *   nm_ip6_config_get_domains           (NMIP6Config *config);
-

-Gets the domain names. -

-
+

nm_ip6_config_get_nameservers ()

+
const GSList *
+nm_ip6_config_get_nameservers (NMIP6Config *config);
+

Gets the domain name servers (DNS).

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

config :

a NMIP6Config -

Returns :

the GPtrArray containing domains as strings. -This is the internal copy used by the configuration, and must not be modified. [element-type utf8] -

config

a NMIP6Config

 
+
+

Returns

+

a GSList containing elements of type 'struct in6_addr' which +contain the addresses of nameservers of the configuration. This is the +internal copy used by the configuration and must not be modified.

+

+
+
-

nm_ip6_config_get_searches ()

-
const GPtrArray *   nm_ip6_config_get_searches          (NMIP6Config *config);
-

-Gets the dns searches. -

-
+

nm_ip6_config_get_domains ()

+
const GPtrArray *
+nm_ip6_config_get_domains (NMIP6Config *config);
+

Gets the domain names.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

config :

a NMIP6Config -

Returns :

the GPtrArray containing dns searches as strings. -This is the internal copy used by the configuration, and must not be modified. [element-type utf8] -

config

a NMIP6Config

 
+
+
+

Returns

+

the GPtrArray containing domains as strings. +This is the internal copy used by the configuration, and must not be modified.

+

[element-type utf8]

+
+ +
+
+

nm_ip6_config_get_searches ()

+
const GPtrArray *
+nm_ip6_config_get_searches (NMIP6Config *config);
+

Gets the dns searches.

+
+

Parameters

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

config

a NMIP6Config

 
+
+
+

Returns

+

the GPtrArray containing dns searches as strings. +This is the internal copy used by the configuration, and must not be modified.

+

[element-type utf8]

+

Since 0.9.10

-

Property Details

+

Types and Values

-

The "addresses" property

-
  "addresses"                NMIP6AddressObjectArray*  : Read
+

NM_IP6_CONFIG_GATEWAY

+
#define NM_IP6_CONFIG_GATEWAY "gateway"
+

-The GPtrArray containing the IPv6 addresses; use -nm_utils_ip6_addresses_from_gvalue() to return a GSList of -NMSettingIP6Address objects that is more usable than the raw data.


-

The "domains" property

-
  "domains"                  NMStringArray*        : Read
+

NM_IP6_CONFIG_ADDRESSES

+
#define NM_IP6_CONFIG_ADDRESSES "addresses"
+

-The GPtrArray containing domain strings of the configuration.


-

The "gateway" property

-
  "gateway"                  gchar*                : Read
+

NM_IP6_CONFIG_ROUTES

+
#define NM_IP6_CONFIG_ROUTES "routes"
+

-The IPv6 gateway as string

-

Default value: NULL

-

Since 0.9.10


-

The "nameservers" property

-
  "nameservers"              NMIP6AddressArray*    : Read
+

NM_IP6_CONFIG_NAMESERVERS

+
#define NM_IP6_CONFIG_NAMESERVERS "nameservers"
+

-The GPtrArray containing elements of type 'struct ip6_addr' which -contain the addresses of nameservers of the configuration.


-

The "routes" property

-
  "routes"                   NMIP6RouteObjectArray*  : Read
+

NM_IP6_CONFIG_DOMAINS

+
#define NM_IP6_CONFIG_DOMAINS "domains"
+

-The GPtrArray containing the IPv6 routes; use -nm_utils_ip6_routes_from_gvalue() to return a GSList of -NMSettingIP6Address objects that is more usable than the raw data.


-

The "searches" property

-
  "searches"                 NMStringArray*        : Read
+

NM_IP6_CONFIG_SEARCHES

+
#define NM_IP6_CONFIG_SEARCHES "searches"
+

-The GPtrArray containing dns search strings of the configuration.

+
+
+
+

Property Details

+
+

The “addresses” property

+
  “addresses”                NMIP6AddressObjectArray *
+

+

Flags: Read

+
+
+
+

The “domains” property

+
  “domains”                  NMStringArray *
+

+

Flags: Read

+
+
+
+

The “gateway” property

+
  “gateway”                  gchar *
+

+

Flags: Read

+

Default value: NULL

+

Since 0.9.10

+
+
+
+

The “nameservers” property

+
  “nameservers”              NMIP6AddressArray *
+

+

Flags: Read

+
+
+
+

The “routes” property

+
  “routes”                   NMIP6RouteObjectArray *
+

+

Flags: Read

+
+
+
+

The “searches” property

+
  “searches”                 NMStringArray *
+

+

Flags: Read

Since 0.9.10

+ Generated by GTK-Doc V1.21 \ No newline at end of file diff --git a/docs/libnm-glib/html/NMObject.html b/docs/libnm-glib/html/NMObject.html index cedff8ee..9cc58a6f 100644 --- a/docs/libnm-glib/html/NMObject.html +++ b/docs/libnm-glib/html/NMObject.html @@ -2,38 +2,29 @@ -NMObject +libnm-glib Reference Manual: NMObject - + - - - - - - - - - - + + + + + + +
@@ -41,281 +32,286 @@

NMObject

NMObject

- +
- -
-

Object Hierarchy

-
-  GObject
-   +----NMObject
-         +----NMClient
-         +----NMDevice
-         +----NMWimaxNsp
-         +----NMAccessPoint
-         +----NMIP4Config
-         +----NMIP6Config
-         +----NMActiveConnection
-         +----NMDHCP4Config
-         +----NMDHCP6Config
-
-
-

Implemented Interfaces

-

-NMObject implements - GInitable and GAsyncInitable.

+

Functions

+
++++ + + + + + + + + + + + + + + +
+GQuark + +nm_object_error_quark () +
+DBusGConnection * + +nm_object_get_connection () +
const char * + +nm_object_get_path () +

Properties

-
-  "dbus-connection"          DBusGConnection*      : Read / Write / Construct Only
-  "dbus-path"                gchar*                : Read / Write / Construct Only
-
+
+++++ + + + + + + + + + + + + +
+DBusGConnection *dbus-connectionRead / Write / Construct Only
+gchar *dbus-pathRead / Write / Construct Only

Signals

-
-  "object-creation-failed"                         : Run First
-
-
-
-

Description

-

-

+
+++++ + + + + + +
voidobject-creation-failedRun First
-

Details

-
-

enum NMObjectError

-
typedef enum {
-	NM_OBJECT_ERROR_UNKNOWN = 0,
-	NM_OBJECT_ERROR_OBJECT_CREATION_FAILURE,
-} NMObjectError;
-
-

-Describes errors that may result from operations involving a NMObject. -

-
+

Types and Values

+
--++ - - + + - - + + + + + + + + + +

NM_OBJECT_ERROR_UNKNOWN

unknown or unclassified error -enumNMObjectError

NM_OBJECT_ERROR_OBJECT_CREATION_FAILURE

an error ocured while creating an NMObject -#defineNM_OBJECT_ERROR
#defineNM_OBJECT_DBUS_CONNECTION
#defineNM_OBJECT_DBUS_PATH
-
-
-

NM_OBJECT_ERROR

-
#define NM_OBJECT_ERROR nm_object_error_quark ()
+
+

Object Hierarchy

+
    GObject
+    ╰── NMObject
+        ├── NMClient
+        ├── NMDevice
+        ├── NMWimaxNsp
+        ├── NMAccessPoint
+        ├── NMIP4Config
+        ├── NMIP6Config
+        ├── NMActiveConnection
+        ├── NMDHCP4Config
+        ╰── NMDHCP6Config
 
+
+
+

Description

+
+

Functions

+
+

nm_object_error_quark ()

+
GQuark
+nm_object_error_quark (void);
+

Registers an error quark for NMObject if necessary.

+
+

Returns

+

the error quark used for NMObject errors.

+

+
+

-

nm_object_error_quark ()

-
GQuark              nm_object_error_quark               (void);
-

-Registers an error quark for NMObject if necessary. -

-
+

nm_object_get_connection ()

+
DBusGConnection *
+nm_object_get_connection (NMObject *object);
+

Gets the NMObject's DBusGConnection.

+
+

Parameters

+
--+++ - - + + +

Returns :

the error quark used for NMObject errors.

object

a NMObject

 
-
-
-

NM_OBJECT_DBUS_CONNECTION

-
#define NM_OBJECT_DBUS_CONNECTION "dbus-connection"
-
-

-

+
+

Returns

+

the connection.

+

[transfer none]

-
-
-

NM_OBJECT_DBUS_PATH

-
#define NM_OBJECT_DBUS_PATH "dbus-path"
-
-

-


-

NMObject

-
typedef struct _NMObject NMObject;
-

-

+

nm_object_get_path ()

+
const char *
+nm_object_get_path (NMObject *object);
+

Gets the DBus path of the NMObject.

+
+

Parameters

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

object

a NMObject

 
-
-
-

NMObjectClass

-
typedef struct {
-	GObjectClass parent;
-
-	/* Signals */
-	/* The "object-creation-failed" signal is PRIVATE for libnm-glib and
-	 * is not meant for any external usage.  It indicates that an error
-	 * occured during creation of an object.
-	 */
-	void (*object_creation_failed) (NMObject *master_object,
-	                                GError *error,
-	                                char *failed_path);
-
-	/* Padding for future expansion */
-	void (*_reserved1) (void);
-	void (*_reserved2) (void);
-	void (*_reserved3) (void);
-	void (*_reserved4) (void);
-	void (*_reserved5) (void);
-	void (*_reserved6) (void);
-} NMObjectClass;
-
-

-

+
+

Returns

+

the object's path. This is the internal string used by the +device, and must not be modified.

+

-
+
+
+
+

Types and Values

-

nm_object_get_connection ()

-
DBusGConnection *   nm_object_get_connection            (NMObject *object);
-

-Gets the NMObject's DBusGConnection. -

-
+

enum NMObjectError

+

Describes errors that may result from operations involving a NMObject.

+
+

Members

+
--+++ - - + + - - + +

object :

a NMObject +

NM_OBJECT_ERROR_UNKNOWN

+

unknown or unclassified error

 

Returns :

the connection. [transfer none] +

NM_OBJECT_ERROR_OBJECT_CREATION_FAILURE

+

an error ocured while creating an NMObject

 
+

-

nm_object_get_path ()

-
const char *        nm_object_get_path                  (NMObject *object);
+

NM_OBJECT_ERROR

+
#define NM_OBJECT_ERROR nm_object_error_quark ()
+
+

+

+
+
+
+

NM_OBJECT_DBUS_CONNECTION

+
#define NM_OBJECT_DBUS_CONNECTION "dbus-connection"
+
+

+

+
+
+
+

NM_OBJECT_DBUS_PATH

+
#define NM_OBJECT_DBUS_PATH "dbus-path"
+

-Gets the DBus path of the NMObject.

-
---- - - - - - - - - - - -

object :

a NMObject -

Returns :

the object's path. This is the internal string used by the -device, and must not be modified.

Property Details

-

The "dbus-connection" property

-
  "dbus-connection"          DBusGConnection*      : Read / Write / Construct Only
+

The “dbus-connection” property

+
  “dbus-connection”          DBusGConnection *

+

Flags: Read / Write / Construct Only


-

The "dbus-path" property

-
  "dbus-path"                gchar*                : Read / Write / Construct Only
+

The “dbus-path” property

+
  “dbus-path”                gchar *

+

Flags: Read / Write / Construct Only

Default value: NULL

Signal Details

-

The "object-creation-failed" signal

-
void                user_function                      (NMObject *master_object,
-                                                        gpointer  error,
-                                                        gpointer  failed_path,
-                                                        gpointer  user_data)          : Run First
-

-Indicates that an error occured while creating an NMObject object -during property handling of master_object. -

-

-Note: Be aware that the signal is private for libnm-glib's internal - use. -

-
---- - - - - - - - - - - - - - - - - - - -

master_object :

the object that received the signal

error :

the error that occured while creating object

failed_path :

object path of the failed object

user_data :

user data set when the signal handler was connected.
+

The “object-creation-failed” signal

+
void
+user_function (NMObject *master_object,
+               gpointer  error,
+               gpointer  failed_path,
+               gpointer  user_data)
+

Flags: Run First

+ Generated by GTK-Doc V1.21
\ No newline at end of file diff --git a/docs/libnm-glib/html/NMRemoteConnection.html b/docs/libnm-glib/html/NMRemoteConnection.html index 848c1910..64cd7154 100644 --- a/docs/libnm-glib/html/NMRemoteConnection.html +++ b/docs/libnm-glib/html/NMRemoteConnection.html @@ -2,38 +2,29 @@ -NMRemoteConnection +libnm-glib Reference Manual: NMRemoteConnection - + - - - - - - - - - - + + + + + + +
@@ -41,549 +32,684 @@

NMRemoteConnection

NMRemoteConnection

- +
-
-

Synopsis

-
enum                NMRemoteConnectionError;
-#define             NM_REMOTE_CONNECTION_ERROR
-GQuark              nm_remote_connection_error_quark    (void);
-#define             NM_REMOTE_CONNECTION_UNSAVED
-#define             NM_REMOTE_CONNECTION_UPDATED
-#define             NM_REMOTE_CONNECTION_REMOVED
-                    NMRemoteConnection;
-                    NMRemoteConnectionClass;
-void                (*NMRemoteConnectionResultFunc)     (NMRemoteConnection *connection,
-                                                         GError *error,
-                                                         gpointer user_data);
-typedef             NMRemoteConnectionCommitFunc;
-typedef             NMRemoteConnectionDeleteFunc;
-void                (*NMRemoteConnectionGetSecretsFunc) (NMRemoteConnection *connection,
-                                                         GHashTable *secrets,
-                                                         GError *error,
-                                                         gpointer user_data);
-NMRemoteConnection * nm_remote_connection_new           (DBusGConnection *bus,
-                                                         const char *path);
-void                nm_remote_connection_commit_changes (NMRemoteConnection *connection,
-                                                         NMRemoteConnectionResultFunc callback,
-                                                         gpointer user_data);
-void                nm_remote_connection_commit_changes_unsaved
-                                                        (NMRemoteConnection *connection,
-                                                         NMRemoteConnectionResultFunc callback,
-                                                         gpointer user_data);
-void                nm_remote_connection_save           (NMRemoteConnection *connection,
-                                                         NMRemoteConnectionResultFunc callback,
-                                                         gpointer user_data);
-void                nm_remote_connection_delete         (NMRemoteConnection *connection,
-                                                         NMRemoteConnectionResultFunc callback,
-                                                         gpointer user_data);
-void                nm_remote_connection_get_secrets    (NMRemoteConnection *connection,
-                                                         const char *setting_name,
-                                                         NMRemoteConnectionGetSecretsFunc callback,
-                                                         gpointer user_data);
-gboolean            nm_remote_connection_get_unsaved    (NMRemoteConnection *connection);
-
-
-
-

Object Hierarchy

-
-  GObject
-   +----NMConnection
-         +----NMRemoteConnection
-
-
-

Implemented Interfaces

-

-NMRemoteConnection implements - GInitable and GAsyncInitable.

+

Functions

+
++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
#defineNM_REMOTE_CONNECTION_ERROR
+GQuark + +nm_remote_connection_error_quark () +
+void + +(*NMRemoteConnectionResultFunc) () +
+void + +(*NMRemoteConnectionGetSecretsFunc) () +
+NMRemoteConnection * + +nm_remote_connection_new () +
+void + +nm_remote_connection_commit_changes () +
+void + +nm_remote_connection_commit_changes_unsaved () +
+void + +nm_remote_connection_save () +
+void + +nm_remote_connection_delete () +
+void + +nm_remote_connection_get_secrets () +
+gboolean + +nm_remote_connection_get_unsaved () +

Properties

-
-  "bus"                      DBusGConnection*      : Write / Construct Only
-  "dbus-connection"          DBusGConnection*      : Write / Construct Only
-  "dbus-path"                gchar*                : Write / Construct Only
-  "unsaved"                  gboolean              : Read
-
+
+++++ + + + + + + + + + + + + + + + + + + + + + + +
+DBusGConnection *busWrite / Construct Only
+DBusGConnection *dbus-connectionWrite / Construct Only
+gchar *dbus-pathWrite / Construct Only
gbooleanunsavedRead

Signals

-
-  "removed"                                        : Run First
-  "updated"                                        : Run First
-  "visible"                                        : Run First
-
-
-
-

Description

-

-

-
-
-

Details

-
-

enum NMRemoteConnectionError

-
typedef enum {
-	NM_REMOTE_CONNECTION_ERROR_UNKNOWN = 0,             /*< nick=UnknownError >*/
-	NM_REMOTE_CONNECTION_ERROR_DISCONNECTED,            /*< nick=Disconnected >*/
-} NMRemoteConnectionError;
-
-
+
--+++ - - + + + - - + + + + + + + +

NM_REMOTE_CONNECTION_ERROR_UNKNOWN

unknown or unclassified error -voidremovedRun First

NM_REMOTE_CONNECTION_ERROR_DISCONNECTED

dbus disconnected -voidupdatedRun First
voidvisibleRun First
-
-
-

NM_REMOTE_CONNECTION_ERROR

-
#define NM_REMOTE_CONNECTION_ERROR (nm_remote_connection_error_quark ())
-
-

-

-
-
-
-

nm_remote_connection_error_quark ()

-
GQuark              nm_remote_connection_error_quark    (void);
-

-Registers an error quark for NMRemoteConnection if necessary. -

-
+
+

Types and Values

+
--++ - - - - + + + + + + + + + + + + + + + + + + + + + + + + + +

Returns :

the error quark used for NMRemoteConnection errors.
enumNMRemoteConnectionError
#defineNM_REMOTE_CONNECTION_UNSAVED
#defineNM_REMOTE_CONNECTION_UPDATED
#defineNM_REMOTE_CONNECTION_REMOVED
typedefNMRemoteConnectionCommitFunc
typedefNMRemoteConnectionDeleteFunc
-
-
-

NM_REMOTE_CONNECTION_UNSAVED

-
#define NM_REMOTE_CONNECTION_UNSAVED         "unsaved"
+
+

Object Hierarchy

+
    GObject
+    ╰── NMConnection
+        ╰── NMRemoteConnection
 
-

-

-
-
-

NM_REMOTE_CONNECTION_UPDATED

-
#define NM_REMOTE_CONNECTION_UPDATED         "updated"
-
+
+

Description

-
+
+

Functions

-

NM_REMOTE_CONNECTION_REMOVED

-
#define NM_REMOTE_CONNECTION_REMOVED         "removed"
+

NM_REMOTE_CONNECTION_ERROR

+
#define NM_REMOTE_CONNECTION_ERROR (nm_remote_connection_error_quark ())
 


-

NMRemoteConnection

-
typedef struct _NMRemoteConnection NMRemoteConnection;
-

-

+

nm_remote_connection_error_quark ()

+
GQuark
+nm_remote_connection_error_quark (void);
+

Registers an error quark for NMRemoteConnection if necessary.

+
+

Returns

+

the error quark used for NMRemoteConnection errors.

+

-
-
-

NMRemoteConnectionClass

-
typedef struct {
-	NMConnectionClass parent_class;
-
-	/* Signals */
-	void (*updated) (NMRemoteConnection *connection,
-	                 GHashTable *new_settings);
-
-	void (*removed) (NMRemoteConnection *connection);
-
-	/* Padding for future expansion */
-	void (*_reserved1) (void);
-	void (*_reserved2) (void);
-	void (*_reserved3) (void);
-	void (*_reserved4) (void);
-	void (*_reserved5) (void);
-	void (*_reserved6) (void);
-} NMRemoteConnectionClass;
-
-

-


-

NMRemoteConnectionResultFunc ()

-
void                (*NMRemoteConnectionResultFunc)     (NMRemoteConnection *connection,
-                                                         GError *error,
-                                                         gpointer user_data);
-

-Called when NetworkManager has finished an asynchronous operation on a -connection, like commit changes, deleting, saving, etc. -

-
+

NMRemoteConnectionResultFunc ()

+
void
+(*NMRemoteConnectionResultFunc) (NMRemoteConnection *connection,
+                                 GError *error,
+                                 gpointer user_data);
+

Called when NetworkManager has finished an asynchronous operation on a +connection, like commit changes, deleting, saving, etc.

+
+

Parameters

+
--+++ - - + + + - - + + + - - + + +

connection :

the connection for which an operation was performed

connection

the connection for which an operation was performed

 

error :

on failure, a descriptive error

error

on failure, a descriptive error

 

user_data :

user data passed to function which began the operation

user_data

user data passed to function which began the operation

 
-
-
-

NMRemoteConnectionCommitFunc

-
typedef NMRemoteConnectionResultFunc NMRemoteConnectionCommitFunc;
-
-

-

-
-
-
-

NMRemoteConnectionDeleteFunc

-
typedef NMRemoteConnectionResultFunc NMRemoteConnectionDeleteFunc;
-
-

-


-

NMRemoteConnectionGetSecretsFunc ()

-
void                (*NMRemoteConnectionGetSecretsFunc) (NMRemoteConnection *connection,
-                                                         GHashTable *secrets,
-                                                         GError *error,
-                                                         gpointer user_data);
-

-Called when NetworkManager returns secrets in response to a request for -secrets via nm_remote_connection_get_secrets(). -

-
+

NMRemoteConnectionGetSecretsFunc ()

+
void
+(*NMRemoteConnectionGetSecretsFunc) (NMRemoteConnection *connection,
+                                     GHashTable *secrets,
+                                     GError *error,
+                                     gpointer user_data);
+

Called when NetworkManager returns secrets in response to a request for +secrets via nm_remote_connection_get_secrets().

+
+

Parameters

+
--+++ - - + + + - - + + + - - + + + - - + + +

connection :

the connection for which secrets were requested

connection

the connection for which secrets were requested

 

secrets :

on success, a hash table of -hash tables, with each inner hash mapping a setting property to a GValue -containing that property's value. [element-type utf8 GLib.HashTable] -

secrets

on success, a hash table of +hash tables, with each inner hash mapping a setting property to a GValue +containing that property's value.

[element-type utf8 GLib.HashTable]

error :

on failure, a descriptive error

error

on failure, a descriptive error

 

user_data :

user data passed to nm_remote_connection_get_secrets() -

user_data

user data passed to nm_remote_connection_get_secrets()

 
+

-

nm_remote_connection_new ()

-
NMRemoteConnection * nm_remote_connection_new           (DBusGConnection *bus,
-                                                         const char *path);
-

-Creates a new object representing the remote connection. -

-
+

nm_remote_connection_new ()

+
NMRemoteConnection *
+nm_remote_connection_new (DBusGConnection *bus,
+                          const char *path);
+

Creates a new object representing the remote connection.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + +

bus :

a valid and connected D-Bus connection

path :

the D-Bus path of the connection as exported by the settings service

bus

a valid and connected D-Bus connection

 

Returns :

the new remote connection object on success, or NULL on failure

path

the D-Bus path of the connection as exported by the settings service

 
+
+

Returns

+

the new remote connection object on success, or NULL on failure

+

+
+

-

nm_remote_connection_commit_changes ()

-
void                nm_remote_connection_commit_changes (NMRemoteConnection *connection,
-                                                         NMRemoteConnectionResultFunc callback,
-                                                         gpointer user_data);
-

-Send any local changes to the settings and properties of this connection to -NetworkManager, which will immediately save them to disk. -

-
+

nm_remote_connection_commit_changes ()

+
void
+nm_remote_connection_commit_changes (NMRemoteConnection *connection,
+                                     NMRemoteConnectionResultFunc callback,
+                                     gpointer user_data);
+

Send any local changes to the settings and properties of this connection to +NetworkManager, which will immediately save them to disk.

+
+

Parameters

+
--+++ - - + + + - - + + + - - + + +

connection :

the NMRemoteConnection -

connection

the NMRemoteConnection

 

callback :

a function to be called when the -commit completes. [scope async][allow-none] -

callback

a function to be called when the +commit completes.

[scope async][allow-none]

user_data :

caller-specific data to be passed to callback. [closure] -

user_data

caller-specific data to be passed to callback +.

[closure]
+

-

nm_remote_connection_commit_changes_unsaved ()

-
void                nm_remote_connection_commit_changes_unsaved
-                                                        (NMRemoteConnection *connection,
-                                                         NMRemoteConnectionResultFunc callback,
-                                                         gpointer user_data);
-

-Send any local changes to the settings and properties of this connection to +

nm_remote_connection_commit_changes_unsaved ()

+
void
+nm_remote_connection_commit_changes_unsaved
+                               (NMRemoteConnection *connection,
+                                NMRemoteConnectionResultFunc callback,
+                                gpointer user_data);
+

Send any local changes to the settings and properties of this connection to NetworkManager. The changes are not saved to disk until either -nm_remote_connection_save() or nm_remote_connection_commit_changes() is -called. -

-
+nm_remote_connection_save() or nm_remote_connection_commit_changes() is +called.

+
+

Parameters

+
--+++ - - + + + - - + + + - - + + +

connection :

the NMRemoteConnection -

connection

the NMRemoteConnection

 

callback :

a function to be called when the -commit completes. [scope async][allow-none] -

callback

a function to be called when the +commit completes.

[scope async][allow-none]

user_data :

caller-specific data to be passed to callback. [closure] -

user_data

caller-specific data to be passed to callback +.

[closure]
+

Since 0.9.10


-

nm_remote_connection_save ()

-
void                nm_remote_connection_save           (NMRemoteConnection *connection,
-                                                         NMRemoteConnectionResultFunc callback,
-                                                         gpointer user_data);
-

-Saves the connection to disk if the connection has changes that have not yet -been written to disk, or if the connection has never been saved. -

-
+

nm_remote_connection_save ()

+
void
+nm_remote_connection_save (NMRemoteConnection *connection,
+                           NMRemoteConnectionResultFunc callback,
+                           gpointer user_data);
+

Saves the connection to disk if the connection has changes that have not yet +been written to disk, or if the connection has never been saved.

+
+

Parameters

+
--+++ - - + + + - - + + + - - + + +

connection :

the NMRemoteConnection -

connection

the NMRemoteConnection

 

callback :

a function to be called when the -save completes. [scope async][allow-none] -

callback

a function to be called when the +save completes.

[scope async][allow-none]

user_data :

caller-specific data to be passed to callback. [closure] -

user_data

caller-specific data to be passed to callback +.

[closure]
+

Since 0.9.10


-

nm_remote_connection_delete ()

-
void                nm_remote_connection_delete         (NMRemoteConnection *connection,
-                                                         NMRemoteConnectionResultFunc callback,
-                                                         gpointer user_data);
-

-Delete the connection. -

-
+

nm_remote_connection_delete ()

+
void
+nm_remote_connection_delete (NMRemoteConnection *connection,
+                             NMRemoteConnectionResultFunc callback,
+                             gpointer user_data);
+

Delete the connection.

+
+

Parameters

+
--+++ - - + + + - - + + + - - + + +

connection :

the NMRemoteConnection -

connection

the NMRemoteConnection

 

callback :

a function to be called when the delete completes. [scope async][allow-none] -

callback

a function to be called when the delete completes.

[scope async][allow-none]

user_data :

caller-specific data to be passed to callback. [closure] -

user_data

caller-specific data to be passed to callback +.

[closure]
+

-

nm_remote_connection_get_secrets ()

-
void                nm_remote_connection_get_secrets    (NMRemoteConnection *connection,
-                                                         const char *setting_name,
-                                                         NMRemoteConnectionGetSecretsFunc callback,
-                                                         gpointer user_data);
-

-Request the connection's secrets. -

-
+

nm_remote_connection_get_secrets ()

+
void
+nm_remote_connection_get_secrets (NMRemoteConnection *connection,
+                                  const char *setting_name,
+                                  NMRemoteConnectionGetSecretsFunc callback,
+                                  gpointer user_data);
+

Request the connection's secrets.

+
+

Parameters

+
--+++ - - + + + - - + + + - - + + + - - + + +

connection :

the NMRemoteConnection -

connection

the NMRemoteConnection

 

setting_name :

the NMSetting object name to get secrets for

setting_name

the NMSetting object name to get secrets for

 

callback :

a function to be called when the update completes; -must not be NULL. [scope async] -

callback

a function to be called when the update completes; +must not be NULL.

[scope async]

user_data :

caller-specific data to be passed to callback. [closure] -

user_data

caller-specific data to be passed to callback +.

[closure]
+

-

nm_remote_connection_get_unsaved ()

-
gboolean            nm_remote_connection_get_unsaved    (NMRemoteConnection *connection);
-
+

nm_remote_connection_get_unsaved ()

+
gboolean
+nm_remote_connection_get_unsaved (NMRemoteConnection *connection);
+
+

Parameters

+
--++++ + + + + + +

connection

the NMRemoteConnection

 
+
+
+

Returns

+

TRUE if the remote connection contains changes that have not +been saved to disk, FALSE if the connection is the same as its on-disk +representation.

+

+
+

Since 0.9.10

+
+ +
+

Types and Values

+
+

enum NMRemoteConnectionError

+
+

Members

+
++++ - - + + - - + + +

connection :

the NMRemoteConnection +

NM_REMOTE_CONNECTION_ERROR_UNKNOWN

+

unknown or unclassified error

 

Returns :

-TRUE if the remote connection contains changes that have not -been saved to disk, FALSE if the connection is the same as its on-disk -representation.

NM_REMOTE_CONNECTION_ERROR_DISCONNECTED

+

dbus disconnected

+
 
-

Since 0.9.10

-
-

Property Details

+
-

The "bus" property

-
  "bus"                      DBusGConnection*      : Write / Construct Only
+

NM_REMOTE_CONNECTION_UNSAVED

+
#define NM_REMOTE_CONNECTION_UNSAVED         "unsaved"
+

-The DBusGConnection that the NMRemoteConnection is connected to.


-

The "dbus-connection" property

-
  "dbus-connection"          DBusGConnection*      : Write / Construct Only
+

NM_REMOTE_CONNECTION_UPDATED

+
#define NM_REMOTE_CONNECTION_UPDATED         "updated"
+
+

+

+
+
+
+

NM_REMOTE_CONNECTION_REMOVED

+
#define NM_REMOTE_CONNECTION_REMOVED         "removed"
+
+

+

+
+
+
+

NMRemoteConnectionCommitFunc

+
typedef NMRemoteConnectionResultFunc NMRemoteConnectionCommitFunc;
+
+

+

+
+
+
+

NMRemoteConnectionDeleteFunc

+
typedef NMRemoteConnectionResultFunc NMRemoteConnectionDeleteFunc;
+
+

+

+
+
+
+

Property Details

+
+

The “bus” property

+
  “bus”                      DBusGConnection *

+

Flags: Write / Construct Only


-

The "dbus-path" property

-
  "dbus-path"                gchar*                : Write / Construct Only
+

The “dbus-connection” property

+
  “dbus-connection”          DBusGConnection *

+

Flags: Write / Construct Only

+
+
+
+

The “dbus-path” property

+
  “dbus-path”                gchar *
+

+

Flags: Write / Construct Only

Default value: NULL


-

The "unsaved" property

-
  "unsaved"                  gboolean              : Read
-

-TRUE if the remote connection contains changes that have not been saved -to disk, FALSE if the connection is the same as its on-disk representation. -

+

The “unsaved” property

+
  “unsaved”                  gboolean
+

+

Flags: Read

Default value: FALSE

Since 0.9.10

@@ -591,87 +717,33 @@ to disk,

Signal Details

-

The "removed" signal

-
void                user_function                      (NMRemoteConnection *connection,
-                                                        gpointer            user_data)       : Run First
-

-This signal is emitted when a connection is either deleted or becomes -invisible to the current user. -

-
---- - - - - - - - - - - -

connection :

a NMConnection -

user_data :

user data set when the signal handler was connected.
+

The “removed” signal

+
void
+user_function (NMRemoteConnection *connection,
+               gpointer            user_data)
+

Flags: Run First


-

The "updated" signal

-
void                user_function                      (NMRemoteConnection *connection,
-                                                        gpointer            user_data)       : Run First
-

-This signal is emitted when a connection changes, and it is -still visible to the user. -

-
---- - - - - - - - - - - -

connection :

a NMConnection -

user_data :

user data set when the signal handler was connected.
+

The “updated” signal

+
void
+user_function (NMRemoteConnection *connection,
+               gpointer            user_data)
+

Flags: Run First


-

The "visible" signal

-
void                user_function                      (NMRemoteConnection *nmremoteconnection,
-                                                        gboolean            arg1,
-                                                        gpointer            user_data)               : Run First
-

-

-
---- - - - - - - - - - - -

nmremoteconnection :

the object which received the signal.

user_data :

user data set when the signal handler was connected.
+

The “visible” signal

+
void
+user_function (NMRemoteConnection *nmremoteconnection,
+               gboolean            arg1,
+               gpointer            user_data)
+

Flags: Run First

+ Generated by GTK-Doc V1.21 \ No newline at end of file diff --git a/docs/libnm-glib/html/NMRemoteSettings.html b/docs/libnm-glib/html/NMRemoteSettings.html index 41fdcb75..7f333eb5 100644 --- a/docs/libnm-glib/html/NMRemoteSettings.html +++ b/docs/libnm-glib/html/NMRemoteSettings.html @@ -2,38 +2,29 @@ -NMRemoteSettings +libnm-glib Reference Manual: NMRemoteSettings - + - - - - - - - - - - + + + + + + +
@@ -41,106 +32,255 @@

NMRemoteSettings

NMRemoteSettings — A helper for NetworkManager's settings API

- +
-
-

Synopsis

-
enum                NMRemoteSettingsError;
-#define             NM_REMOTE_SETTINGS_ERROR
-GQuark              nm_remote_settings_error_quark      (void);
-#define             NM_REMOTE_SETTINGS_BUS
-#define             NM_REMOTE_SETTINGS_SERVICE_RUNNING
-#define             NM_REMOTE_SETTINGS_HOSTNAME
-#define             NM_REMOTE_SETTINGS_CAN_MODIFY
-#define             NM_REMOTE_SETTINGS_NEW_CONNECTION
-#define             NM_REMOTE_SETTINGS_CONNECTIONS_READ
-void                (*NMRemoteSettingsAddConnectionFunc)
-                                                        (NMRemoteSettings *settings,
-                                                         NMRemoteConnection *connection,
-                                                         GError *error,
-                                                         gpointer user_data);
-void                (*NMRemoteSettingsLoadConnectionsFunc)
-                                                        (NMRemoteSettings *settings,
-                                                         char **failures,
-                                                         GError *error,
-                                                         gpointer user_data);
-void                (*NMRemoteSettingsSaveHostnameFunc) (NMRemoteSettings *settings,
-                                                         GError *error,
-                                                         gpointer user_data);
-struct              NMRemoteSettings;
-struct              NMRemoteSettingsClass;
-NMRemoteSettings *  nm_remote_settings_new              (DBusGConnection *bus);
-void                nm_remote_settings_new_async        (DBusGConnection *bus,
-                                                         GCancellable *cancellable,
-                                                         GAsyncReadyCallback callback,
-                                                         gpointer user_data);
-NMRemoteSettings *  nm_remote_settings_new_finish       (GAsyncResult *result,
-                                                         GError **error);
-GSList *            nm_remote_settings_list_connections (NMRemoteSettings *settings);
-NMRemoteConnection * nm_remote_settings_get_connection_by_id
-                                                        (NMRemoteSettings *settings,
-                                                         const char *id);
-NMRemoteConnection * nm_remote_settings_get_connection_by_path
-                                                        (NMRemoteSettings *settings,
-                                                         const char *path);
-NMRemoteConnection * nm_remote_settings_get_connection_by_uuid
-                                                        (NMRemoteSettings *settings,
-                                                         const char *uuid);
-gboolean            nm_remote_settings_add_connection   (NMRemoteSettings *settings,
-                                                         NMConnection *connection,
-                                                         NMRemoteSettingsAddConnectionFunc callback,
-                                                         gpointer user_data);
-gboolean            nm_remote_settings_add_connection_unsaved
-                                                        (NMRemoteSettings *settings,
-                                                         NMConnection *connection,
-                                                         NMRemoteSettingsAddConnectionFunc callback,
-                                                         gpointer user_data);
-gboolean            nm_remote_settings_load_connections (NMRemoteSettings *settings,
-                                                         char **filenames,
-                                                         char ***failures,
-                                                         GError **error);
-gboolean            nm_remote_settings_reload_connections
-                                                        (NMRemoteSettings *settings,
-                                                         GError **error);
-gboolean            nm_remote_settings_save_hostname    (NMRemoteSettings *settings,
-                                                         const char *hostname,
-                                                         NMRemoteSettingsSaveHostnameFunc callback,
-                                                         gpointer user_data);
-
+
+

Functions

+
++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+GQuark + +nm_remote_settings_error_quark () +
+void + +(*NMRemoteSettingsAddConnectionFunc) () +
+void + +(*NMRemoteSettingsLoadConnectionsFunc) () +
+void + +(*NMRemoteSettingsSaveHostnameFunc) () +
+NMRemoteSettings * + +nm_remote_settings_new () +
+void + +nm_remote_settings_new_async () +
+NMRemoteSettings * + +nm_remote_settings_new_finish () +
+GSList * + +nm_remote_settings_list_connections () +
+NMRemoteConnection * + +nm_remote_settings_get_connection_by_id () +
+NMRemoteConnection * + +nm_remote_settings_get_connection_by_path () +
+NMRemoteConnection * + +nm_remote_settings_get_connection_by_uuid () +
+gboolean + +nm_remote_settings_add_connection () +
+gboolean + +nm_remote_settings_add_connection_unsaved () +
+gboolean + +nm_remote_settings_load_connections () +
+gboolean + +nm_remote_settings_reload_connections () +
+gboolean + +nm_remote_settings_save_hostname () +
-

Object Hierarchy

-
-  GObject
-   +----NMRemoteSettings
-
+

Properties

+
+++++ + + + + + + + + + + + + + + + + + + + + + + +
+DBusGConnection *busRead / Write / Construct Only
gbooleancan-modifyRead
+gchar *hostnameRead
gbooleanservice-runningRead
-

Implemented Interfaces

-

-NMRemoteSettings implements - GInitable and GAsyncInitable.

+

Signals

+
+++++ + + + + + + + + + + + + +
voidconnections-readRun First
voidnew-connectionRun First
-

Properties

-
-  "bus"                      DBusGConnection*      : Read / Write / Construct Only
-  "can-modify"               gboolean              : Read
-  "hostname"                 gchar*                : Read
-  "service-running"          gboolean              : Read
-
+

Types and Values

+
-

Signals

-
-  "connections-read"                               : Run First
-  "new-connection"                                 : Run First
+

Object Hierarchy

+
    GObject
+    ╰── NMRemoteSettings
 

Description

-

-The NMRemoteSettings object represents NetworkManager's "settings" service, +

The NMRemoteSettings object represents NetworkManager's "settings" service, which stores network configuration and allows authenticated clients to add, delete, and modify that configuration. The data required to connect to a specific network is called a "connection" and encapsulated by the @@ -148,19 +288,14 @@ to a specific network is called a "connection" and encapsulated by the either been added by a user or read from on-disk storage, the NMRemoteSettings object creates a NMRemoteConnection object which represents this stored connection. Use the NMRemoteConnection object to -perform any operations like modification or deletion. -

-

-To add a new network connection to the NetworkManager settings service, first +perform any operations like modification or deletion.

+

To add a new network connection to the NetworkManager settings service, first build up a template NMConnection object. Since this connection is not yet added to NetworkManager, it is known only to your program and is not yet an NMRemoteConnection. Then ask NMRemoteSettings to add your connection. When the connection is added successfully, the supplied callback is called and returns to your program the new NMRemoteConnection which represents -the stored object known to NetworkManager. -

-

-

+the stored object known to NetworkManager.

@@ -231,15 +366,15 @@ the stored object known to NetworkManager. gpointer user_data){ if (error) - g_print ("Error adding connection: %s", error->message); + g_print ("Error adding connection: %s", error->message); else { - g_print ("Added: %s\n", nm_connection_get_path (NM_CONNECTION (remote))); + g_print ("Added: %s\n", nm_connection_get_path (NM_CONNECTION (remote))); /* Use 'remote' with nm_remote_connection_commit_changes() to save * changes and nm_remote_connection_delete() to delete the connection */ }} -static gboolean +static gbooleanadd_wired_connection (const char *human_name){ NMConnection *connection; @@ -251,32 +386,32 @@ the stored object known to NetworkManager. connection = nm_connection_new (); /* Build up the 'connection' setting */ - s_con = (NMSettingConnection *) nm_setting_connection_new (); - uuid = nm_utils_uuid_generate (); - g_object_set (G_OBJECT (s_con), - NM_SETTING_CONNECTION_UUID, uuid, - NM_SETTING_CONNECTION_ID, human_name, - NM_SETTING_CONNECTION_TYPE, NM_SETTING_WIRED_SETTING_NAME, - NULL); - g_free (uuid); - nm_connection_add_setting (connection, NM_SETTING (s_con)); + s_con = (NMSettingConnection *) nm_setting_connection_new (); + uuid = nm_utils_uuid_generate (); + g_object_set (G_OBJECT (s_con), + NM_SETTING_CONNECTION_UUID, uuid, + NM_SETTING_CONNECTION_ID, human_name, + NM_SETTING_CONNECTION_TYPE, NM_SETTING_WIRED_SETTING_NAME, + NULL); + g_free (uuid); + nm_connection_add_setting (connection, NM_SETTING (s_con)); /* Add the required 'wired' setting as this is a wired connection */ - nm_connection_add_setting (connection, nm_setting_wired_new ()); + nm_connection_add_setting (connection, nm_setting_wired_new ()); /* Add an 'ipv4' setting using AUTO configuration (eg DHCP) */ - s_ip4 = (NMSettingIP4Config *) nm_setting_ip4_config_new (); - g_object_set (G_OBJECT (s_ip4), - NM_SETTING_IP4_CONFIG_METHOD, NM_SETTING_IP4_CONFIG_METHOD_AUTO, - NULL); - nm_connection_add_setting (connection, NM_SETTING (s_ip4)); + s_ip4 = (NMSettingIP4Config *) nm_setting_ip4_config_new (); + g_object_set (G_OBJECT (s_ip4), + NM_SETTING_IP4_CONFIG_METHOD, NM_SETTING_IP4_CONFIG_METHOD_AUTO, + NULL); + nm_connection_add_setting (connection, NM_SETTING (s_ip4)); /* Ask NetworkManager to store the connection */ success = nm_remote_settings_add_connection (settings, connection, added_cb, loop); /* Release the template connection; the actual stored connection will * be returned in added_cb() */ - g_object_unref (connection); + g_object_unref (connection); /* Let glib event loop run and added_cb() will be called when NetworkManager * is done adding the new connection. */ @@ -288,762 +423,743 @@ the stored object known to NetworkManager.
-

-

+

-

Details

-
-

enum NMRemoteSettingsError

-
typedef enum {
-	NM_REMOTE_SETTINGS_ERROR_UNKNOWN = 0,            /*< nick=UnknownError >*/
-	NM_REMOTE_SETTINGS_ERROR_CONNECTION_REMOVED,     /*< nick=ConnectionRemoved >*/
-	NM_REMOTE_SETTINGS_ERROR_CONNECTION_UNAVAILABLE, /*< nick=ConnectionUnavailable >*/
-	NM_REMOTE_SETTINGS_ERROR_SERVICE_UNAVAILABLE,    /*< nick=ServiceUnavailable >*/
-} NMRemoteSettingsError;
-
-

-Describes errors that may result from operations involving a NMRemoteSettings. -

-
---- - - - - - - - - - - - - - - - - - - -

NM_REMOTE_SETTINGS_ERROR_UNKNOWN

unknown or unclassified error -

NM_REMOTE_SETTINGS_ERROR_CONNECTION_REMOVED

the NMRemoteConnection object - was removed before it was completely initialized -

NM_REMOTE_SETTINGS_ERROR_CONNECTION_UNAVAILABLE

the NMRemoteConnection object - is not visible or otherwise unreadable -

NM_REMOTE_SETTINGS_ERROR_SERVICE_UNAVAILABLE

NetworkManager is not running. - (Since 0.9.10) -
-
-
-
-

NM_REMOTE_SETTINGS_ERROR

-
#define NM_REMOTE_SETTINGS_ERROR nm_remote_settings_error_quark ()
-
-

-

-
-
-
-

nm_remote_settings_error_quark ()

-
GQuark              nm_remote_settings_error_quark      (void);
-

-Registers an error quark for NMRemoteSettings if necessary. -

-
---- - - - - -

Returns :

the error quark used for NMRemoteSettings errors.
-
-
-
-

NM_REMOTE_SETTINGS_BUS

-
#define NM_REMOTE_SETTINGS_BUS             "bus"
-
-

-

-
-
-
-

NM_REMOTE_SETTINGS_SERVICE_RUNNING

-
#define NM_REMOTE_SETTINGS_SERVICE_RUNNING "service-running"
-
-

-

-
-
-
-

NM_REMOTE_SETTINGS_HOSTNAME

-
#define NM_REMOTE_SETTINGS_HOSTNAME        "hostname"
-
-

-

-
-
-
-

NM_REMOTE_SETTINGS_CAN_MODIFY

-
#define NM_REMOTE_SETTINGS_CAN_MODIFY      "can-modify"
-
-

-

-
-
-
-

NM_REMOTE_SETTINGS_NEW_CONNECTION

-
#define NM_REMOTE_SETTINGS_NEW_CONNECTION    "new-connection"
-
-

-

-
-
-
-

NM_REMOTE_SETTINGS_CONNECTIONS_READ

-
#define NM_REMOTE_SETTINGS_CONNECTIONS_READ  "connections-read"
-
-

-

-
-
+

Functions

-

NMRemoteSettingsAddConnectionFunc ()

-
void                (*NMRemoteSettingsAddConnectionFunc)
-                                                        (NMRemoteSettings *settings,
-                                                         NMRemoteConnection *connection,
-                                                         GError *error,
-                                                         gpointer user_data);
-

-

+

nm_remote_settings_error_quark ()

+
GQuark
+nm_remote_settings_error_quark (void);
+

Registers an error quark for NMRemoteSettings if necessary.

+
+

Returns

+

the error quark used for NMRemoteSettings errors.

+

-
-
-

NMRemoteSettingsLoadConnectionsFunc ()

-
void                (*NMRemoteSettingsLoadConnectionsFunc)
-                                                        (NMRemoteSettings *settings,
-                                                         char **failures,
-                                                         GError *error,
-                                                         gpointer user_data);
-

-


-

NMRemoteSettingsSaveHostnameFunc ()

-
void                (*NMRemoteSettingsSaveHostnameFunc) (NMRemoteSettings *settings,
-                                                         GError *error,
-                                                         gpointer user_data);
+

NMRemoteSettingsAddConnectionFunc ()

+
void
+(*NMRemoteSettingsAddConnectionFunc) (NMRemoteSettings *settings,
+                                      NMRemoteConnection *connection,
+                                      GError *error,
+                                      gpointer user_data);


-

struct NMRemoteSettings

-
struct NMRemoteSettings;
+

NMRemoteSettingsLoadConnectionsFunc ()

+
void
+(*NMRemoteSettingsLoadConnectionsFunc)
+                               (NMRemoteSettings *settings,
+                                char **failures,
+                                GError *error,
+                                gpointer user_data);


-

struct NMRemoteSettingsClass

-
struct NMRemoteSettingsClass {
-	GObjectClass parent;
-
-	/* Signals */
-	void (*new_connection) (NMRemoteSettings *settings,
-	                        NMRemoteConnection *connection);
-
-	void (*connections_read) (NMRemoteSettings *settings);
-
-	/* Padding for future expansion */
-	void (*_reserved1) (void);
-	void (*_reserved2) (void);
-	void (*_reserved3) (void);
-	void (*_reserved4) (void);
-	void (*_reserved5) (void);
-	void (*_reserved6) (void);
-};
-
+

NMRemoteSettingsSaveHostnameFunc ()

+
void
+(*NMRemoteSettingsSaveHostnameFunc) (NMRemoteSettings *settings,
+                                     GError *error,
+                                     gpointer user_data);


-

nm_remote_settings_new ()

-
NMRemoteSettings *  nm_remote_settings_new              (DBusGConnection *bus);
-

-Creates a new object representing the remote settings service. -

-

-Note that this will do blocking D-Bus calls to initialize the -settings object. You can use nm_remote_settings_new_async() if you -want to avoid that. -

-
+

nm_remote_settings_new ()

+
NMRemoteSettings *
+nm_remote_settings_new (DBusGConnection *bus);
+

Creates a new object representing the remote settings service.

+

Note that this will do blocking D-Bus calls to initialize the +settings object. You can use nm_remote_settings_new_async() if you +want to avoid that.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

bus :

a valid and connected D-Bus connection. [allow-none] -

Returns :

the new remote settings object on success, or NULL on failure

bus

a valid and connected D-Bus connection.

[allow-none]
+
+

Returns

+

the new remote settings object on success, or NULL on failure

+

+
+

-

nm_remote_settings_new_async ()

-
void                nm_remote_settings_new_async        (DBusGConnection *bus,
-                                                         GCancellable *cancellable,
-                                                         GAsyncReadyCallback callback,
-                                                         gpointer user_data);
-

-Creates a new object representing the remote settings service and -begins asynchronously initializing it. callback will be called -when it is done; use nm_remote_settings_new_finish() to get the -result. -

-
+

nm_remote_settings_new_async ()

+
void
+nm_remote_settings_new_async (DBusGConnection *bus,
+                              GCancellable *cancellable,
+                              GAsyncReadyCallback callback,
+                              gpointer user_data);
+

Creates a new object representing the remote settings service and +begins asynchronously initializing it. callback + will be called +when it is done; use nm_remote_settings_new_finish() to get the +result.

+
+

Parameters

+
--+++ - - + + + - - + + + - - + + + - - + + +

bus :

a valid and connected D-Bus connection. [allow-none] -

bus

a valid and connected D-Bus connection.

[allow-none]

cancellable :

a GCancellable, or NULL -

cancellable

a GCancellable, or NULL

 

callback :

callback to call when the settings object is created

callback

callback to call when the settings object is created

 

user_data :

data for callback -

user_data

data for callback +

 
+

-

nm_remote_settings_new_finish ()

-
NMRemoteSettings *  nm_remote_settings_new_finish       (GAsyncResult *result,
-                                                         GError **error);
-

-Gets the result of an nm_remote_settings_new_async() call. -

-
+

nm_remote_settings_new_finish ()

+
NMRemoteSettings *
+nm_remote_settings_new_finish (GAsyncResult *result,
+                               GError **error);
+

Gets the result of an nm_remote_settings_new_async() call.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + +

result :

a GAsyncResult -

error :

location for a GError, or NULL -

result

a GAsyncResult

 

Returns :

a new NMRemoteSettings object, or NULL on error

error

location for a GError, or NULL

 
+
+

Returns

+

a new NMRemoteSettings object, or NULL on error

+

+
+

-

nm_remote_settings_list_connections ()

-
GSList *            nm_remote_settings_list_connections (NMRemoteSettings *settings);
-
+

nm_remote_settings_list_connections ()

+
GSList *
+nm_remote_settings_list_connections (NMRemoteSettings *settings);
+
+

Parameters

+
--+++ - - - - - - - - + + + + +

settings :

the NMRemoteSettings -

Returns :

a +

settings

the NMRemoteSettings

 
+
+
+

Returns

+

a list containing all connections provided by the remote settings service. Each element of the returned list is a NMRemoteConnection instance, which is owned by the NMRemoteSettings object and should not be freed by the caller. The returned list is, however, owned by the caller and should be freed -using g_slist_free() when no longer required. [transfer container][element-type NMRemoteConnection] - - - -

+using g_slist_free() when no longer required.

+

[transfer container][element-type NMRemoteConnection]

+

-

nm_remote_settings_get_connection_by_id ()

-
NMRemoteConnection * nm_remote_settings_get_connection_by_id
-                                                        (NMRemoteSettings *settings,
-                                                         const char *id);
-

-Returns the first matching NMRemoteConnection matching a given id. -

-
+

nm_remote_settings_get_connection_by_id ()

+
NMRemoteConnection *
+nm_remote_settings_get_connection_by_id
+                               (NMRemoteSettings *settings,
+                                const char *id);
+

Returns the first matching NMRemoteConnection matching a given id +.

+
+

Parameters

+
--+++ - - + + + - - - - - - + + +

settings :

the NMRemoteSettings -

settings

the NMRemoteSettings

 

id :

the id of the remote connection

Returns :

the remote connection object on success, or NULL if no -matching object was found. [transfer none] -

id

the id of the remote connection

 
+
+
+

Returns

+

the remote connection object on success, or NULL if no +matching object was found.

+

[transfer none]

+

Since 0.9.10


-

nm_remote_settings_get_connection_by_path ()

-
NMRemoteConnection * nm_remote_settings_get_connection_by_path
-                                                        (NMRemoteSettings *settings,
-                                                         const char *path);
-

-Returns the NMRemoteConnection representing the connection at path. -

-
+

nm_remote_settings_get_connection_by_path ()

+
NMRemoteConnection *
+nm_remote_settings_get_connection_by_path
+                               (NMRemoteSettings *settings,
+                                const char *path);
+

Returns the NMRemoteConnection representing the connection at path +.

+
+

Parameters

+
--+++ - - + + + - - - - - - + + +

settings :

the NMRemoteSettings -

settings

the NMRemoteSettings

 

path :

the D-Bus object path of the remote connection

Returns :

the remote connection object on success, or NULL if the object was -not known. [transfer none] -

path

the D-Bus object path of the remote connection

 
+
+

Returns

+

the remote connection object on success, or NULL if the object was +not known.

+

[transfer none]

+
+
-

nm_remote_settings_get_connection_by_uuid ()

-
NMRemoteConnection * nm_remote_settings_get_connection_by_uuid
-                                                        (NMRemoteSettings *settings,
-                                                         const char *uuid);
-

-Returns the NMRemoteConnection identified by uuid. -

-
+

nm_remote_settings_get_connection_by_uuid ()

+
NMRemoteConnection *
+nm_remote_settings_get_connection_by_uuid
+                               (NMRemoteSettings *settings,
+                                const char *uuid);
+

Returns the NMRemoteConnection identified by uuid +.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + +

settings :

the NMRemoteSettings -

uuid :

the UUID of the remote connection

settings

the NMRemoteSettings

 

Returns :

the remote connection object on success, or NULL if the object was -not known. [transfer none] -

uuid

the UUID of the remote connection

 
+
+

Returns

+

the remote connection object on success, or NULL if the object was +not known.

+

[transfer none]

+
+
-

nm_remote_settings_add_connection ()

-
gboolean            nm_remote_settings_add_connection   (NMRemoteSettings *settings,
-                                                         NMConnection *connection,
-                                                         NMRemoteSettingsAddConnectionFunc callback,
-                                                         gpointer user_data);
-

-Requests that the remote settings service add the given settings to a new -connection. The connection is immediately written to disk. connection is +

nm_remote_settings_add_connection ()

+
gboolean
+nm_remote_settings_add_connection (NMRemoteSettings *settings,
+                                   NMConnection *connection,
+                                   NMRemoteSettingsAddConnectionFunc callback,
+                                   gpointer user_data);
+

Requests that the remote settings service add the given settings to a new +connection. The connection is immediately written to disk. connection + is untouched by this function and only serves as a template of the settings to add. The NMRemoteConnection object that represents what NetworkManager -actually added is returned to callback when the addition operation is complete. -

-

-Note that the NMRemoteConnection returned in callback may not contain -identical settings to connection as NetworkManager may perform automatic -completion and/or normalization of connection properties. -

-
+actually added is returned to callback + when the addition operation is complete.

+

Note that the NMRemoteConnection returned in callback + may not contain +identical settings to connection + as NetworkManager may perform automatic +completion and/or normalization of connection properties.

+
+

Parameters

+
--+++ - - + + + - - + + + - - + + + - - - - - - + + +

settings :

the NMRemoteSettings -

settings

the NMRemoteSettings

 

connection :

the connection to add. Note that this object's settings will be -added, not the object itself

connection

the connection to add. Note that this object's settings will be +added, not the object itself

 

callback :

callback to be called when the add operation completes. [scope async] -

callback

callback to be called when the add operation completes.

[scope async]

user_data :

caller-specific data passed to callback. [closure] -

Returns :

-TRUE if the request was successful, FALSE if it failed

user_data

caller-specific data passed to callback +.

[closure]
+
+

Returns

+

TRUE if the request was successful, FALSE if it failed

+

+
+
-

nm_remote_settings_add_connection_unsaved ()

-
gboolean            nm_remote_settings_add_connection_unsaved
-                                                        (NMRemoteSettings *settings,
-                                                         NMConnection *connection,
-                                                         NMRemoteSettingsAddConnectionFunc callback,
-                                                         gpointer user_data);
-

-Requests that the remote settings service add the given settings to a new +

nm_remote_settings_add_connection_unsaved ()

+
gboolean
+nm_remote_settings_add_connection_unsaved
+                               (NMRemoteSettings *settings,
+                                NMConnection *connection,
+                                NMRemoteSettingsAddConnectionFunc callback,
+                                gpointer user_data);
+

Requests that the remote settings service add the given settings to a new connection. The connection is not written to disk, which may be done at -a later time by calling the connection's nm_remote_connection_commit_changes() -method. -

-
+a later time by calling the connection's nm_remote_connection_commit_changes() +method.

+
+

Parameters

+
--+++ - - + + + - - + + + - - - - - - + + + - - + + +

settings :

the NMRemoteSettings -

settings

the NMRemoteSettings

 

connection :

the connection to add. Note that this object's settings will be -added, not the object itself

connection

the connection to add. Note that this object's settings will be +added, not the object itself

 

callback :

callback to be called when the add operation completes. [scope async] -

user_data :

caller-specific data passed to callback. [closure] -

callback

callback to be called when the add operation completes.

[scope async]

Returns :

-TRUE if the request was successful, FALSE if it failed

user_data

caller-specific data passed to callback +.

[closure]
+
+
+

Returns

+

TRUE if the request was successful, FALSE if it failed

+

+

Since 0.9.10


-

nm_remote_settings_load_connections ()

-
gboolean            nm_remote_settings_load_connections (NMRemoteSettings *settings,
-                                                         char **filenames,
-                                                         char ***failures,
-                                                         GError **error);
-

-Requests that the remote settings service load or reload the given files, -adding or updating the connections described within. -

-

-The changes to the indicated files will not yet be reflected in -settings's connections array when the function returns. -

-

-If all of the indicated files were successfully loaded, the -function will return TRUE, and failures will be set to NULL. If +

nm_remote_settings_load_connections ()

+
gboolean
+nm_remote_settings_load_connections (NMRemoteSettings *settings,
+                                     char **filenames,
+                                     char ***failures,
+                                     GError **error);
+

Requests that the remote settings service load or reload the given files, +adding or updating the connections described within.

+

The changes to the indicated files will not yet be reflected in +settings +'s connections array when the function returns.

+

If all of the indicated files were successfully loaded, the +function will return TRUE, and failures + will be set to NULL. If NetworkManager tried to load the files, but some (or all) failed, -then failures will be set to a NULL-terminated array of the -filenames that failed to load. -

-
+then failures + will be set to a NULL-terminated array of the +filenames that failed to load.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + + - - + + + - - + + +

settings :

the NMRemoteSettings -

filenames :

-NULL-terminated array of filenames to load

settings

the NMRemoteSettings

 

failures :

on return, a NULL-terminated array of -filenames that failed to load. [out][transfer full] -

filenames

NULL-terminated array of filenames to load

 

error :

return location for GError -

failures

on return, a NULL-terminated array of +filenames that failed to load.

[out][transfer full]

Returns :

-TRUE if NetworkManager at least tried to load filenames, -FALSE if an error occurred (eg, permission denied).

error

return location for GError

 
+
+
+

Returns

+

TRUE if NetworkManager at least tried to load filenames +, +FALSE if an error occurred (eg, permission denied).

+

+

Since 0.9.10


-

nm_remote_settings_reload_connections ()

-
gboolean            nm_remote_settings_reload_connections
-                                                        (NMRemoteSettings *settings,
-                                                         GError **error);
-

-Requests that the remote settings service reload all connection +

nm_remote_settings_reload_connections ()

+
gboolean
+nm_remote_settings_reload_connections (NMRemoteSettings *settings,
+                                       GError **error);
+

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. -

-
+the in-memory state matches the on-disk state.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + +

settings :

the NMRemoteSettings -

error :

return location for GError -

settings

the NMRemoteSettings

 

Returns :

-TRUE on success, FALSE on failure

error

return location for GError

 
+
+
+

Returns

+

TRUE on success, FALSE on failure

+

+

Since 0.9.10


-

nm_remote_settings_save_hostname ()

-
gboolean            nm_remote_settings_save_hostname    (NMRemoteSettings *settings,
-                                                         const char *hostname,
-                                                         NMRemoteSettingsSaveHostnameFunc callback,
-                                                         gpointer user_data);
-

-Requests that the machine's persistent hostname be set to the specified value -or cleared. -

-
+

nm_remote_settings_save_hostname ()

+
gboolean
+nm_remote_settings_save_hostname (NMRemoteSettings *settings,
+                                  const char *hostname,
+                                  NMRemoteSettingsSaveHostnameFunc callback,
+                                  gpointer user_data);
+

Requests that the machine's persistent hostname be set to the specified value +or cleared.

+
+

Parameters

+
--+++ - - + + + + + + + + - - + + + - - + + + + +

settings :

the NMRemoteSettings -

settings

the NMRemoteSettings

 

hostname

the new persistent hostname to set, or NULL to clear any existing +persistent hostname

 

hostname :

the new persistent hostname to set, or NULL to clear any existing -persistent hostname

callback

callback to be called when the +hostname operation completes.

[scope async][allow-none]

callback :

callback to be called when the -hostname operation completes. [scope async][allow-none] +

user_data

caller-specific data passed to callback +.

[closure]
+
+
+

Returns

+

TRUE if the request was successful, FALSE if it failed

+

+
+ + +
+

Types and Values

+
+

enum NMRemoteSettingsError

+

Describes errors that may result from operations involving a NMRemoteSettings.

+
+

Members

+
+++++ + + + + + - - + + - - + + + + + + + +

NM_REMOTE_SETTINGS_ERROR_UNKNOWN

+

unknown or unclassified error

 

user_data :

caller-specific data passed to callback. [closure] +

NM_REMOTE_SETTINGS_ERROR_CONNECTION_REMOVED

+

the NMRemoteConnection object + was removed before it was completely initialized

 

Returns :

-TRUE if the request was successful, FALSE if it failed

NM_REMOTE_SETTINGS_ERROR_CONNECTION_UNAVAILABLE

+

the NMRemoteConnection object + is not visible or otherwise unreadable

+
 

NM_REMOTE_SETTINGS_ERROR_SERVICE_UNAVAILABLE

+

NetworkManager is not running. + (Since 0.9.10)

+
 
-
-

Property Details

+
-

The "bus" property

-
  "bus"                      DBusGConnection*      : Read / Write / Construct Only
+

NM_REMOTE_SETTINGS_ERROR

+
#define NM_REMOTE_SETTINGS_ERROR nm_remote_settings_error_quark ()
+

-The DBusGConnection that the NMRemoteSettings is connected to. Defaults -to the system bus if not specified.


-

The "can-modify" property

-
  "can-modify"               gboolean              : Read
+

NM_REMOTE_SETTINGS_BUS

+
#define NM_REMOTE_SETTINGS_BUS             "bus"
+

-If TRUE, adding and modifying connections is supported.

-

Default value: FALSE


-

The "hostname" property

-
  "hostname"                 gchar*                : Read
+

NM_REMOTE_SETTINGS_SERVICE_RUNNING

+
#define NM_REMOTE_SETTINGS_SERVICE_RUNNING "service-running"
+

-The machine hostname stored in persistent configuration. This can be -modified by calling nm_remote_settings_save_hostname().

-

Default value: NULL


-

The "service-running" property

-
  "service-running"          gboolean              : Read
+

NM_REMOTE_SETTINGS_HOSTNAME

+
#define NM_REMOTE_SETTINGS_HOSTNAME        "hostname"
+

-Whether the settings service is running.

-

Default value: FALSE

+
+
+

NM_REMOTE_SETTINGS_CAN_MODIFY

+
#define NM_REMOTE_SETTINGS_CAN_MODIFY      "can-modify"
+
+

+

-
-

Signal Details

+
-

The "connections-read" signal

-
void                user_function                      (NMRemoteSettings *nmremotesettings,
-                                                        gpointer          user_data)             : Run First
+

NM_REMOTE_SETTINGS_NEW_CONNECTION

+
#define NM_REMOTE_SETTINGS_NEW_CONNECTION    "new-connection"
+

-
---- - - - - - - - - - - -

nmremotesettings :

the object which received the signal.

user_data :

user data set when the signal handler was connected.

-

The "new-connection" signal

-
void                user_function                      (NMRemoteSettings *nmremotesettings,
-                                                        GObject          *arg1,
-                                                        gpointer          user_data)             : Run First
+

NM_REMOTE_SETTINGS_CONNECTIONS_READ

+
#define NM_REMOTE_SETTINGS_CONNECTIONS_READ  "connections-read"
+

-
---- - - - - - - - - - - -

nmremotesettings :

the object which received the signal.

user_data :

user data set when the signal handler was connected.
+
+
+
+

Property Details

+
+

The “bus” property

+
  “bus”                      DBusGConnection *
+

+

Flags: Read / Write / Construct Only

+
+
+
+

The “can-modify” property

+
  “can-modify”               gboolean
+

+

Flags: Read

+

Default value: FALSE

+
+
+
+

The “hostname” property

+
  “hostname”                 gchar *
+

+

Flags: Read

+

Default value: NULL

+
+
+
+

The “service-running” property

+
  “service-running”          gboolean
+

+

Flags: Read

+

Default value: FALSE

+
+
+
+

Signal Details

+
+

The “connections-read” signal

+
void
+user_function (NMRemoteSettings *nmremotesettings,
+               gpointer          user_data)
+

Flags: Run First

+
+
+
+

The “new-connection” signal

+
void
+user_function (NMRemoteSettings *nmremotesettings,
+               GObject          *arg1,
+               gpointer          user_data)
+

Flags: Run First

+ Generated by GTK-Doc V1.21
\ No newline at end of file diff --git a/docs/libnm-glib/html/NMSecretAgent.html b/docs/libnm-glib/html/NMSecretAgent.html index feeaf82e..367c6450 100644 --- a/docs/libnm-glib/html/NMSecretAgent.html +++ b/docs/libnm-glib/html/NMSecretAgent.html @@ -2,36 +2,29 @@ -NMSecretAgent +libnm-glib Reference Manual: NMSecretAgent - + - - - - - - - - - - + + + + + + +
@@ -39,318 +32,243 @@

NMSecretAgent

NMSecretAgent

- +
-
-

Synopsis

-
#define             NM_SECRET_AGENT_ERROR
-GQuark              nm_secret_agent_error_quark         (void);
-enum                NMSecretAgentError;
-enum                NMSecretAgentCapabilities;
-enum                NMSecretAgentGetSecretsFlags;
-#define             NM_SECRET_AGENT_IDENTIFIER
-#define             NM_SECRET_AGENT_AUTO_REGISTER
-#define             NM_SECRET_AGENT_REGISTERED
-#define             NM_SECRET_AGENT_CAPABILITIES
-#define             NM_SECRET_AGENT_REGISTRATION_RESULT
-                    NMSecretAgent;
-void                (*NMSecretAgentGetSecretsFunc)      (NMSecretAgent *agent,
-                                                         NMConnection *connection,
-                                                         GHashTable *secrets,
-                                                         GError *error,
-                                                         gpointer user_data);
-void                (*NMSecretAgentSaveSecretsFunc)     (NMSecretAgent *agent,
-                                                         NMConnection *connection,
-                                                         GError *error,
-                                                         gpointer user_data);
-void                (*NMSecretAgentDeleteSecretsFunc)   (NMSecretAgent *agent,
-                                                         NMConnection *connection,
-                                                         GError *error,
-                                                         gpointer user_data);
-                    NMSecretAgentClass;
-gboolean            nm_secret_agent_register            (NMSecretAgent *self);
-gboolean            nm_secret_agent_unregister          (NMSecretAgent *self);
-gboolean            nm_secret_agent_get_registered      (NMSecretAgent *self);
-void                nm_secret_agent_get_secrets         (NMSecretAgent *self,
-                                                         NMConnection *connection,
-                                                         const char *setting_name,
-                                                         const char **hints,
-                                                         NMSecretAgentGetSecretsFlags flags,
-                                                         NMSecretAgentGetSecretsFunc callback,
-                                                         gpointer user_data);
-void                nm_secret_agent_save_secrets        (NMSecretAgent *self,
-                                                         NMConnection *connection,
-                                                         NMSecretAgentSaveSecretsFunc callback,
-                                                         gpointer user_data);
-void                nm_secret_agent_delete_secrets      (NMSecretAgent *self,
-                                                         NMConnection *connection,
-                                                         NMSecretAgentDeleteSecretsFunc callback,
-                                                         gpointer user_data);
-
-
-
-

Object Hierarchy

-
-  GObject
-   +----NMSecretAgent
-
-
-
-

Properties

-
-  "auto-register"            gboolean              : Read / Write / Construct
-  "capabilities"             NMSecretAgentCapabilities  : Read / Write / Construct
-  "identifier"               gchar*                : Read / Write / Construct Only
-  "registered"               gboolean              : Read
-
-
-

Signals

-
-  "registration-result"                            : Run First
-
-
-
-

Description

-

-

-
-
-

Details

-
-

NM_SECRET_AGENT_ERROR

-
#define NM_SECRET_AGENT_ERROR         (nm_secret_agent_error_quark ())
-
-

-

-
-
-
-

nm_secret_agent_error_quark ()

-
GQuark              nm_secret_agent_error_quark         (void);
-

-

-
-
-
-

enum NMSecretAgentError

-
typedef enum {
-	NM_SECRET_AGENT_ERROR_NOT_AUTHORIZED = 0, /*< nick=NotAuthorized >*/
-	NM_SECRET_AGENT_ERROR_INVALID_CONNECTION, /*< nick=InvalidConnection >*/
-	NM_SECRET_AGENT_ERROR_USER_CANCELED,      /*< nick=UserCanceled >*/
-	NM_SECRET_AGENT_ERROR_AGENT_CANCELED,     /*< nick=AgentCanceled >*/
-	NM_SECRET_AGENT_ERROR_INTERNAL_ERROR,     /*< nick=InternalError >*/
-	NM_SECRET_AGENT_ERROR_NO_SECRETS,         /*< nick=NoSecrets >*/
-} NMSecretAgentError;
-
-

-NMSecretAgentError values are passed by secret agents back to NetworkManager -when they encounter problems retrieving secrets on behalf of NM. -

-
+

Functions

+
--++ - - + + + + + + + + + + + + + + + + + + + + + - - + - - + - - + - - + - - +

NM_SECRET_AGENT_ERROR_NOT_AUTHORIZED

the caller (ie, NetworkManager) is not - authorized to make this request +#defineNM_SECRET_AGENT_ERROR
+GQuark + +nm_secret_agent_error_quark () +
+void + +(*NMSecretAgentGetSecretsFunc) () +
+void + +(*NMSecretAgentSaveSecretsFunc) () +
+void + +(*NMSecretAgentDeleteSecretsFunc) () +
+gboolean + +nm_secret_agent_register ()

NM_SECRET_AGENT_ERROR_INVALID_CONNECTION

the connection for which secrets - were requested could not be found + +gboolean + +nm_secret_agent_unregister ()

NM_SECRET_AGENT_ERROR_USER_CANCELED

the request was canceled by the user + +gboolean + +nm_secret_agent_get_registered ()

NM_SECRET_AGENT_ERROR_AGENT_CANCELED

the agent canceled the request - because it was requested to do so by NetworkManager + +void + +nm_secret_agent_get_secrets ()

NM_SECRET_AGENT_ERROR_INTERNAL_ERROR

some internal error in the agent caused - the request to fail + +void + +nm_secret_agent_save_secrets ()

NM_SECRET_AGENT_ERROR_NO_SECRETS

the agent cannot find any secrets for this - connection + +void + +nm_secret_agent_delete_secrets ()
-
-
-

enum NMSecretAgentCapabilities

-
typedef enum {
-	NM_SECRET_AGENT_CAPABILITY_NONE = 0x0,
-	NM_SECRET_AGENT_CAPABILITY_VPN_HINTS = 0x1,
-
-	/* boundary value */
-	NM_SECRET_AGENT_CAPABILITY_LAST = NM_SECRET_AGENT_CAPABILITY_VPN_HINTS
-} NMSecretAgentCapabilities;
-
-

-NMSecretAgentCapabilities indicate various capabilities of the agent. -

-
+
+

Properties

+
--+++ - - + + + - - + + + - - + + + + + + + +

NM_SECRET_AGENT_CAPABILITY_NONE

the agent supports no special capabilities -gbooleanauto-registerRead / Write / Construct

NM_SECRET_AGENT_CAPABILITY_VPN_HINTS

the agent supports sending hints given -by the get_secrets class method to VPN plugin -authentication dialogs. -NMSecretAgentCapabilitiescapabilitiesRead / Write / Construct

NM_SECRET_AGENT_CAPABILITY_LAST

bounds checking value; should not be used. - +gchar *identifierRead / Write / Construct Only
gbooleanregisteredRead
-

Since 0.9.10

-
-
-

enum NMSecretAgentGetSecretsFlags

-
typedef enum {
-	NM_SECRET_AGENT_GET_SECRETS_FLAG_NONE = 0x0,
-	NM_SECRET_AGENT_GET_SECRETS_FLAG_ALLOW_INTERACTION = 0x1,
-	NM_SECRET_AGENT_GET_SECRETS_FLAG_REQUEST_NEW = 0x2,
-	NM_SECRET_AGENT_GET_SECRETS_FLAG_USER_REQUESTED = 0x4
-} NMSecretAgentGetSecretsFlags;
-
-

-NMSecretAgentGetSecretsFlags values modify the behavior of a GetSecrets request. -

-
+
+

Signals

+
+++++ + + + + + +
voidregistration-resultRun First
+
+
+

Types and Values

+
--++ - - + + - - + + - - + + - - + + + + + + + + + + + + + + + + + +

NM_SECRET_AGENT_GET_SECRETS_FLAG_NONE

no special behavior; by default no -user interaction is allowed and requests for secrets are fulfilled from -persistent storage, or if no secrets are available an error is returned. -enumNMSecretAgentError

NM_SECRET_AGENT_GET_SECRETS_FLAG_ALLOW_INTERACTION

allows the request to -interact with the user, possibly prompting via UI for secrets if any are -required, or if none are found in persistent storage. -enumNMSecretAgentCapabilities

NM_SECRET_AGENT_GET_SECRETS_FLAG_REQUEST_NEW

explicitly prompt for new -secrets from the user. This flag signals that NetworkManager thinks any -existing secrets are invalid or wrong. This flag implies that interaction -is allowed. -enumNMSecretAgentGetSecretsFlags

NM_SECRET_AGENT_GET_SECRETS_FLAG_USER_REQUESTED

set if the request was -initiated by user-requested action via the D-Bus interface, as opposed to -automatically initiated by NetworkManager in response to (for example) scan -results or carrier changes. -#defineNM_SECRET_AGENT_IDENTIFIER
#defineNM_SECRET_AGENT_AUTO_REGISTER
#defineNM_SECRET_AGENT_REGISTERED
#defineNM_SECRET_AGENT_CAPABILITIES
#defineNM_SECRET_AGENT_REGISTRATION_RESULT
-
-
-

NM_SECRET_AGENT_IDENTIFIER

-
#define NM_SECRET_AGENT_IDENTIFIER          "identifier"
-
-

-

-
-
-
-

NM_SECRET_AGENT_AUTO_REGISTER

-
#define NM_SECRET_AGENT_AUTO_REGISTER       "auto-register"
+
+

Object Hierarchy

+
    GObject
+    ╰── NMSecretAgent
 
-

-

-
-
-

NM_SECRET_AGENT_REGISTERED

-
#define NM_SECRET_AGENT_REGISTERED          "registered"
-
+
+

Description

-
+
+

Functions

-

NM_SECRET_AGENT_CAPABILITIES

-
#define NM_SECRET_AGENT_CAPABILITIES        "capabilities"
+

NM_SECRET_AGENT_ERROR

+
#define NM_SECRET_AGENT_ERROR         (nm_secret_agent_error_quark ())
 


-

NM_SECRET_AGENT_REGISTRATION_RESULT

-
#define NM_SECRET_AGENT_REGISTRATION_RESULT "registration-result"
-
+

nm_secret_agent_error_quark ()

+
GQuark
+nm_secret_agent_error_quark (void);

+
+

Returns

+

-
-
-

NMSecretAgent

-
typedef struct _NMSecretAgent NMSecretAgent;
-

-


-

NMSecretAgentGetSecretsFunc ()

-
void                (*NMSecretAgentGetSecretsFunc)      (NMSecretAgent *agent,
-                                                         NMConnection *connection,
-                                                         GHashTable *secrets,
-                                                         GError *error,
-                                                         gpointer user_data);
-

-Called as a result of a request by NM to retrieve secrets. When the +

NMSecretAgentGetSecretsFunc ()

+
void
+(*NMSecretAgentGetSecretsFunc) (NMSecretAgent *agent,
+                                NMConnection *connection,
+                                GHashTable *secrets,
+                                GError *error,
+                                gpointer user_data);
+

Called as a result of a request by NM to retrieve secrets. When the NMSecretAgent subclass has finished retrieving secrets and is ready to return them, or to return an error, this function should be called with -those secrets or the error. -

-

-To easily create the hash table to return the Wi-Fi PSK, you could do -something like this: -

+those secrets or the error.

+

To easily create the hash table to return the Wi-Fi PSK, you could do +something like this:

-

Example 1. Creating a secrets hash

+

Example 1. Creating a secrets hash

@@ -376,533 +294,664 @@ something like this: GHashTable *secrets_hash;secrets = nm_connection_new (); -s_wsec = (NMSettingWirelessSecurity *) nm_setting_wireless_security_new (); -g_object_set (G_OBJECT (s_wsec), - NM_SETTING_WIRELESS_SECURITY_PSK, "my really cool PSK", - NULL); -nm_connection_add_setting (secrets, NM_SETTING (s_wsec)); -secrets_hash = nm_connection_to_hash (secrets, NM_SETTING_HASH_FLAG_ALL); +s_wsec = (NMSettingWirelessSecurity *) nm_setting_wireless_security_new (); +g_object_set (G_OBJECT (s_wsec), + NM_SETTING_WIRELESS_SECURITY_PSK, "my really cool PSK", + NULL); +nm_connection_add_setting (secrets, NM_SETTING (s_wsec)); +secrets_hash = nm_connection_to_hash (secrets, NM_SETTING_HASH_FLAG_ALL);(call the NMSecretAgentGetSecretsFunc with secrets_hash) -g_object_unref (secrets); -g_hash_table_unref (secrets_hash); +g_object_unref (secrets); +g_hash_table_unref (secrets_hash);
-


-

-
+
+

Parameters

+
--+++ - - + + + - - + +g_object_ref()/g_object_unref() if you want to use this object after the callback +has returned.

+ - - + +is the secret.

+ - - + + + - - + + +

agent :

the secret agent object

agent

the secret agent object

 

connection :

the connection for which secrets were requested, +

connection

the connection for which secrets were requested, note that this object will be unrefed after the callback has returned, use -g_object_ref()/g_object_unref() if you want to use this object after the callback -has returned. [transfer none] -

[transfer none]

secrets :

the GHashTable containing +

secrets

the GHashTable containing the requested secrets in the same format as an NMConnection hash (as created by nm_connection_to_hash() for example). Each key in secrets -should be the name of a NMSetting object (like "802-11-wireless-security") -and each value should be a GHashTable. The sub-hashes map string:GValue +should be the name of a NMSetting object (like "802-11-wireless-security") +and each value should be a GHashTable. The sub-hashes map string:GValue where the string is the setting property name (like "psk") and the value -is the secret. [element-type utf8 GLib.HashTable] -

[element-type utf8 GLib.HashTable]

error :

if the secrets request failed, give a descriptive error here

error

if the secrets request failed, give a descriptive error here

 

user_data :

caller-specific data to be passed to the function

user_data

caller-specific data to be passed to the function

 
+

-

NMSecretAgentSaveSecretsFunc ()

-
void                (*NMSecretAgentSaveSecretsFunc)     (NMSecretAgent *agent,
-                                                         NMConnection *connection,
-                                                         GError *error,
-                                                         gpointer user_data);
-

-Called as a result of a request by NM to save secrets. When the +

NMSecretAgentSaveSecretsFunc ()

+
void
+(*NMSecretAgentSaveSecretsFunc) (NMSecretAgent *agent,
+                                 NMConnection *connection,
+                                 GError *error,
+                                 gpointer user_data);
+

Called as a result of a request by NM to save secrets. When the NMSecretAgent subclass has finished saving the secrets, this function -should be called. -

-
+should be called.

+
+

Parameters

+
--+++ - - + + + - - + +g_object_ref()/g_object_unref() if you want to use this object after the callback +has returned.

+ - - + + + - - + + +

agent :

the secret agent object

agent

the secret agent object

 

connection :

the connection for which secrets were to be saved, +

connection

the connection for which secrets were to be saved, note that this object will be unrefed after the callback has returned, use -g_object_ref()/g_object_unref() if you want to use this object after the callback -has returned. [transfer none] -

[transfer none]

error :

if the saving secrets failed, give a descriptive error here

error

if the saving secrets failed, give a descriptive error here

 

user_data :

caller-specific data to be passed to the function

user_data

caller-specific data to be passed to the function

 
+

-

NMSecretAgentDeleteSecretsFunc ()

-
void                (*NMSecretAgentDeleteSecretsFunc)   (NMSecretAgent *agent,
-                                                         NMConnection *connection,
-                                                         GError *error,
-                                                         gpointer user_data);
-

-Called as a result of a request by NM to delete secrets. When the +

NMSecretAgentDeleteSecretsFunc ()

+
void
+(*NMSecretAgentDeleteSecretsFunc) (NMSecretAgent *agent,
+                                   NMConnection *connection,
+                                   GError *error,
+                                   gpointer user_data);
+

Called as a result of a request by NM to delete secrets. When the NMSecretAgent subclass has finished deleting the secrets, this function -should be called. -

-
+should be called.

+
+

Parameters

+
--+++ - - + + + - - + +g_object_ref()/g_object_unref() if you want to use this object after the callback +has returned.

+ - - + + + - - + + +

agent :

the secret agent object

agent

the secret agent object

 

connection :

the connection for which secrets were to be deleted, +

connection

the connection for which secrets were to be deleted, note that this object will be unrefed after the callback has returned, use -g_object_ref()/g_object_unref() if you want to use this object after the callback -has returned. [transfer none] -

[transfer none]

error :

if the deleting secrets failed, give a descriptive error here

error

if the deleting secrets failed, give a descriptive error here

 

user_data :

caller-specific data to be passed to the function

user_data

caller-specific data to be passed to the function

 
-
-
-

NMSecretAgentClass

-
typedef struct {
-	GObjectClass parent;
-
-	/* Virtual methods for subclasses */
-
-	/* Called when the subclass should retrieve and return secrets.  Subclass
-	 * must copy or reference any arguments it may require after returning from
-	 * this method, as the arguments will freed (except for 'self', 'callback',
-	 * and 'user_data' of course).  If the request is canceled, the callback
-	 * should still be called, but with the NM_SECRET_AGENT_ERROR_AGENT_CANCELED
-	 * error.
-	 */
-	void (*get_secrets) (NMSecretAgent *self,
-	                     NMConnection *connection,
-	                     const char *connection_path,
-	                     const char *setting_name,
-	                     const char **hints,
-	                     NMSecretAgentGetSecretsFlags flags,
-	                     NMSecretAgentGetSecretsFunc callback,
-	                     gpointer user_data);
-
-	/* Called when the subclass should cancel an outstanding request to
-	 * get secrets for a given connection.  Canceling the request MUST
-	 * call the callback that was passed along with the initial get_secrets
-	 * call, sending the NM_SECRET_AGENT_ERROR/NM_SECRET_AGENT_ERROR_AGENT_CANCELED
-	 * error to that callback.
-	 */
-	void (*cancel_get_secrets) (NMSecretAgent *self,
-	                            const char *connection_path,
-	                            const char *setting_name);
-
-	/* Called when the subclass should save the secrets contained in the
-	 * connection to backing storage.  Subclass must copy or reference any
-	 * arguments it may require after returning from this method, as the
-	 * arguments will freed (except for 'self', 'callback', and 'user_data'
-	 * of course).
-	 */
-	void (*save_secrets) (NMSecretAgent *self,
-	                      NMConnection *connection,
-	                      const char *connection_path,
-	                      NMSecretAgentSaveSecretsFunc callback,
-	                      gpointer user_data);
-
-	/* Called when the subclass should delete the secrets contained in the
-	 * connection from backing storage.  Subclass must copy or reference any
-	 * arguments it may require after returning from this method, as the
-	 * arguments will freed (except for 'self', 'callback', and 'user_data'
-	 * of course).
-	 */
-	void (*delete_secrets) (NMSecretAgent *self,
-	                        NMConnection *connection,
-	                        const char *connection_path,
-	                        NMSecretAgentDeleteSecretsFunc callback,
-	                        gpointer user_data);
-
-	/* Signals */
-	void (*registration_result) (NMSecretAgent *agent, GError *error);
-
-	/* Padding for future expansion */
-	void (*_reserved1) (void);
-	void (*_reserved2) (void);
-	void (*_reserved3) (void);
-	void (*_reserved4) (void);
-	void (*_reserved5) (void);
-	void (*_reserved6) (void);
-} NMSecretAgentClass;
-
-

-


-

nm_secret_agent_register ()

-
gboolean            nm_secret_agent_register            (NMSecretAgent *self);
-

-Registers the NMSecretAgent with the NetworkManager secret manager, +

nm_secret_agent_register ()

+
gboolean
+nm_secret_agent_register (NMSecretAgent *self);
+

Registers the NMSecretAgent with the NetworkManager secret manager, indicating to NetworkManager that the agent is able to provide and save secrets for connections on behalf of its user. Registration is an asynchronous operation and its success or failure is indicated via the -'registration-result' signal. -

-
+'registration-result' signal.

+
+

Parameters

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

self

a NMSecretAgent

 
+
+
+

Returns

+

a new TRUE if registration was successfully requested (this does +not mean registration itself was successful), FALSE if registration was not +successfully requested.

+

+
+
+
+
+

nm_secret_agent_unregister ()

+
gboolean
+nm_secret_agent_unregister (NMSecretAgent *self);
+

Unregisters the NMSecretAgent with the NetworkManager secret manager, +indicating to NetworkManager that the agent is will no longer provide or +store secrets on behalf of this user.

+
+

Parameters

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

self

a NMSecretAgent

 
+
+
+

Returns

+

a new TRUE if unregistration was successful, FALSE if it was not.

+

+
+
+
+
+

nm_secret_agent_get_registered ()

+
gboolean
+nm_secret_agent_get_registered (NMSecretAgent *self);
+
+

Parameters

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

self

a NMSecretAgent

 
+
+
+

Returns

+

a TRUE if the agent is registered, FALSE if it is not.

+

+
+
+
+
+

nm_secret_agent_get_secrets ()

+
void
+nm_secret_agent_get_secrets (NMSecretAgent *self,
+                             NMConnection *connection,
+                             const char *setting_name,
+                             const char **hints,
+                             NMSecretAgentGetSecretsFlags flags,
+                             NMSecretAgentGetSecretsFunc callback,
+                             gpointer user_data);
+

Asyncronously retrieve secrets belonging to connection + for the +setting setting_name +. flags + indicate specific behavior that the secret +agent should use when performing the request, for example returning only +existing secrets without user interaction, or requesting entirely new +secrets from the user.

+

Virtual: get_secrets

+
+

Parameters

+
--+++ - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + - - + + +

self :

a NMSecretAgent -

self

a NMSecretAgent

 

connection

the NMConnection for which we're asked secrets

 

setting_name

the name of the secret setting

 

hints

hints to the agent.

[array zero-terminated=1]

flags

flags that modify the behavior of the request

 

callback

a callback, to be invoked when the operation is done.

[scope async]

Returns :

a new TRUE if registration was successfully requested (this does -not mean registration itself was successful), FALSE if registration was not -successfully requested.

user_data

caller-specific data to be passed to callback +.

[closure]
+

-

nm_secret_agent_unregister ()

-
gboolean            nm_secret_agent_unregister          (NMSecretAgent *self);
-

-Unregisters the NMSecretAgent with the NetworkManager secret manager, -indicating to NetworkManager that the agent is will no longer provide or -store secrets on behalf of this user. -

-
+

nm_secret_agent_save_secrets ()

+
void
+nm_secret_agent_save_secrets (NMSecretAgent *self,
+                              NMConnection *connection,
+                              NMSecretAgentSaveSecretsFunc callback,
+                              gpointer user_data);
+

Asyncronously ensure that all secrets inside connection + +are stored to disk.

+

Virtual: save_secrets

+
+

Parameters

+
--+++ - - + + + + + + + + + + + + + - - + + +

self :

a NMSecretAgent -

self

a NMSecretAgent

 

connection

a NMConnection

 

callback

a callback, to be invoked when the operation is done.

[scope async]

Returns :

a new TRUE if unregistration was successful, FALSE if it was not.

user_data

caller-specific data to be passed to callback +.

[closure]
+

-

nm_secret_agent_get_registered ()

-
gboolean            nm_secret_agent_get_registered      (NMSecretAgent *self);
-
+

nm_secret_agent_delete_secrets ()

+
void
+nm_secret_agent_delete_secrets (NMSecretAgent *self,
+                                NMConnection *connection,
+                                NMSecretAgentDeleteSecretsFunc callback,
+                                gpointer user_data);
+

Asynchronously ask the agent to delete all saved secrets belonging to +connection +.

+

Virtual: delete_secrets

+
+

Parameters

+
--+++ - - + + + + + + + + - - + + + + + + + +

self :

a NMSecretAgent -

self

a NMSecretAgent

 

connection

a NMConnection

 

Returns :

a TRUE if the agent is registered, FALSE if it is not.

callback

a callback, to be invoked when the operation is done.

[scope async]

user_data

caller-specific data to be passed to callback +.

[closure]
-
+
+
+
+

Types and Values

-

nm_secret_agent_get_secrets ()

-
void                nm_secret_agent_get_secrets         (NMSecretAgent *self,
-                                                         NMConnection *connection,
-                                                         const char *setting_name,
-                                                         const char **hints,
-                                                         NMSecretAgentGetSecretsFlags flags,
-                                                         NMSecretAgentGetSecretsFunc callback,
-                                                         gpointer user_data);
-

-Asyncronously retrieve secrets belonging to connection for the -setting setting_name. flags indicate specific behavior that the secret -agent should use when performing the request, for example returning only -existing secrets without user interaction, or requesting entirely new -secrets from the user. -

-

-Virtual: get_secrets -

-
+

enum NMSecretAgentError

+

NMSecretAgentError values are passed by secret agents back to NetworkManager +when they encounter problems retrieving secrets on behalf of NM.

+
+

Members

+
--+++ - - + + - - - - - - + + + - - + + - - + + + - - + + - - + +

self :

a NMSecretAgent +

NM_SECRET_AGENT_ERROR_NOT_AUTHORIZED

+

the caller (ie, NetworkManager) is not + authorized to make this request

 

connection :

the NMConnection for which we're asked secrets

setting_name :

the name of the secret setting

NM_SECRET_AGENT_ERROR_INVALID_CONNECTION

+

the connection for which secrets + were requested could not be found

+
 

hints :

hints to the agent. [array zero-terminated=1] +

NM_SECRET_AGENT_ERROR_USER_CANCELED

+

the request was canceled by the user

 

flags :

flags that modify the behavior of the request

NM_SECRET_AGENT_ERROR_AGENT_CANCELED

+

the agent canceled the request + because it was requested to do so by NetworkManager

+
 

callback :

a callback, to be invoked when the operation is done. [scope async] +

NM_SECRET_AGENT_ERROR_INTERNAL_ERROR

+

some internal error in the agent caused + the request to fail

 

user_data :

caller-specific data to be passed to callback. [closure] +

NM_SECRET_AGENT_ERROR_NO_SECRETS

+

the agent cannot find any secrets for this + connection

 
+

-

nm_secret_agent_save_secrets ()

-
void                nm_secret_agent_save_secrets        (NMSecretAgent *self,
-                                                         NMConnection *connection,
-                                                         NMSecretAgentSaveSecretsFunc callback,
-                                                         gpointer user_data);
-

-Asyncronously ensure that all secrets inside connection -are stored to disk. -

-

-Virtual: save_secrets -

-
+

enum NMSecretAgentCapabilities

+

NMSecretAgentCapabilities indicate various capabilities of the agent.

+
+

Members

+
--+++ - - - - - - + + - - + + - - + +

self :

a NMSecretAgent -

connection :

a NMConnection +

NM_SECRET_AGENT_CAPABILITY_NONE

+

the agent supports no special capabilities

 

callback :

a callback, to be invoked when the operation is done. [scope async] +

NM_SECRET_AGENT_CAPABILITY_VPN_HINTS

+

the agent supports sending hints given +by the get_secrets class method to VPN plugin +authentication dialogs.

 

user_data :

caller-specific data to be passed to callback. [closure] +

NM_SECRET_AGENT_CAPABILITY_LAST

+

bounds checking value; should not be used.

 
+

Since 0.9.10

+
-

nm_secret_agent_delete_secrets ()

-
void                nm_secret_agent_delete_secrets      (NMSecretAgent *self,
-                                                         NMConnection *connection,
-                                                         NMSecretAgentDeleteSecretsFunc callback,
-                                                         gpointer user_data);
-

-Asynchronously ask the agent to delete all saved secrets belonging to -connection. -

-

-Virtual: delete_secrets -

-
+

enum NMSecretAgentGetSecretsFlags

+

NMSecretAgentGetSecretsFlags values modify the behavior of a GetSecrets request.

+
+

Members

+
--+++ - - + + - - + + - - + + - - + +

self :

a NMSecretAgent +

NM_SECRET_AGENT_GET_SECRETS_FLAG_NONE

+

no special behavior; by default no +user interaction is allowed and requests for secrets are fulfilled from +persistent storage, or if no secrets are available an error is returned.

 

connection :

a NMConnection +

NM_SECRET_AGENT_GET_SECRETS_FLAG_ALLOW_INTERACTION

+

allows the request to +interact with the user, possibly prompting via UI for secrets if any are +required, or if none are found in persistent storage.

 

callback :

a callback, to be invoked when the operation is done. [scope async] +

NM_SECRET_AGENT_GET_SECRETS_FLAG_REQUEST_NEW

+

explicitly prompt for new +secrets from the user. This flag signals that NetworkManager thinks any +existing secrets are invalid or wrong. This flag implies that interaction +is allowed.

 

user_data :

caller-specific data to be passed to callback. [closure] +

NM_SECRET_AGENT_GET_SECRETS_FLAG_USER_REQUESTED

+

set if the request was +initiated by user-requested action via the D-Bus interface, as opposed to +automatically initiated by NetworkManager in response to (for example) scan +results or carrier changes.

 
-
-

Property Details

+
-

The "auto-register" property

-
  "auto-register"            gboolean              : Read / Write / Construct
+

NM_SECRET_AGENT_IDENTIFIER

+
#define NM_SECRET_AGENT_IDENTIFIER          "identifier"
+

-If TRUE, the agent will attempt to automatically register itself after -it is created (via an idle handler) and to re-register itself if -NetworkManager restarts. If FALSE, the agent does not automatically -register with NetworkManager, and nm_secret_agent_register() must be -called. If 'auto-register' is TRUE, calling nm_secret_agent_unregister() -will suppress auto-registration until nm_secret_agent_register() is -called, which re-enables auto-registration.

-

Default value: TRUE


-

The "capabilities" property

-
  "capabilities"             NMSecretAgentCapabilities  : Read / Write / Construct
+

NM_SECRET_AGENT_AUTO_REGISTER

+
#define NM_SECRET_AGENT_AUTO_REGISTER       "auto-register"
+

-A bitfield of NMSecretAgentCapabilities.


-

The "identifier" property

-
  "identifier"               gchar*                : Read / Write / Construct Only
+

NM_SECRET_AGENT_REGISTERED

+
#define NM_SECRET_AGENT_REGISTERED          "registered"
+

-Identifies this agent; only one agent in each user session may use the -same identifier. Identifier formatting follows the same rules as -D-Bus bus names with the exception that the ':' character is not -allowed. The valid set of characters is "[A-Z][a-z][0-9]_-." and the -identifier is limited in length to 255 characters with a minimum -of 3 characters. An example valid identifier is 'org.gnome.nm-applet' -(without quotes).

-

Default value: NULL


-

The "registered" property

-
  "registered"               gboolean              : Read
+

NM_SECRET_AGENT_CAPABILITIES

+
#define NM_SECRET_AGENT_CAPABILITIES        "capabilities"
+
+

+

+
+
+
+

NM_SECRET_AGENT_REGISTRATION_RESULT

+
#define NM_SECRET_AGENT_REGISTRATION_RESULT "registration-result"
+

-TRUE if the agent is registered with NetworkManager, FALSE if not.

+
+
+
+

Property Details

+
+

The “auto-register” property

+
  “auto-register”            gboolean
+

+

Flags: Read / Write / Construct

+

Default value: TRUE

+
+
+
+

The “capabilities” property

+
  “capabilities”             NMSecretAgentCapabilities
+

+

Flags: Read / Write / Construct

+
+
+
+

The “identifier” property

+
  “identifier”               gchar *
+

+

Flags: Read / Write / Construct Only

+

Default value: NULL

+
+
+
+

The “registered” property

+
  “registered”               gboolean
+

+

Flags: Read

Default value: FALSE

Signal Details

-

The "registration-result" signal

-
void                user_function                      (NMSecretAgent *agent,
-                                                        gpointer       error,
-                                                        gpointer       user_data)      : Run First
-

-Indicates the result of a registration request; if error is NULL the -request was successful. -

-
---- - - - - - - - - - - - - - - -

agent :

the agent that received the signal

error :

the error, if any, that occured while registering

user_data :

user data set when the signal handler was connected.
+

The “registration-result” signal

+
void
+user_function (NMSecretAgent *agent,
+               gpointer       error,
+               gpointer       user_data)
+

Flags: Run First

+ Generated by GTK-Doc V1.21 \ No newline at end of file diff --git a/docs/libnm-glib/html/NMVPNConnection.html b/docs/libnm-glib/html/NMVPNConnection.html index 4241b467..c74274ea 100644 --- a/docs/libnm-glib/html/NMVPNConnection.html +++ b/docs/libnm-glib/html/NMVPNConnection.html @@ -2,38 +2,29 @@ -NMVPNConnection +libnm-glib Reference Manual: NMVPNConnection - + - - - - - - - - - - + + + + + + +
@@ -41,200 +32,237 @@

NMVPNConnection

NMVPNConnection

- +
-
-

Object Hierarchy

-
-  GObject
-   +----NMObject
-         +----NMActiveConnection
-               +----NMVPNConnection
-
-
-
-

Implemented Interfaces

-

-NMVPNConnection implements - GInitable and GAsyncInitable.

+

Functions

+
++++ + + + + + + + + + + + + + + +
+GObject * + +nm_vpn_connection_new () +
+NMVPNConnectionState + +nm_vpn_connection_get_vpn_state () +
const char * + +nm_vpn_connection_get_banner () +

Properties

-
-  "banner"                   gchar*                : Read
-  "vpn-state"                guint                 : Read
-
+
+++++ + + + + + + + + + + + + +
+gchar *bannerRead
guintvpn-stateRead

Signals

-
-  "vpn-state-changed"                              : Run First
-
+
+++++ + + + + + +
voidvpn-state-changedRun First
-

Description

-

-

+

Types and Values

+
++++ + + + + + + + + + + +
#defineNM_VPN_CONNECTION_VPN_STATE
#defineNM_VPN_CONNECTION_BANNER
-

Details

-
-

NM_VPN_CONNECTION_VPN_STATE

-
#define NM_VPN_CONNECTION_VPN_STATE "vpn-state"
-
-

-

-
-
-
-

NM_VPN_CONNECTION_BANNER

-
#define NM_VPN_CONNECTION_BANNER "banner"
+

Object Hierarchy

+
    GObject
+    ╰── NMObject
+        ╰── NMActiveConnection
+            ╰── NMVPNConnection
 
-

-

-
-
-
-

NMVPNConnection

-
typedef struct _NMVPNConnection NMVPNConnection;
-

-

-
-
-

NMVPNConnectionClass

-
typedef struct {
-	NMActiveConnectionClass parent;
-
-	/* Signals */
-	void (*vpn_state_changed) (NMVPNConnection *connection,
-	                           NMVPNConnectionState state,
-	                           NMVPNConnectionStateReason reason);
-
-	/* Padding for future expansion */
-	void (*_reserved1) (void);
-	void (*_reserved2) (void);
-	void (*_reserved3) (void);
-	void (*_reserved4) (void);
-	void (*_reserved5) (void);
-	void (*_reserved6) (void);
-} NMVPNConnectionClass;
-
+
+

Description

-
+
+

Functions

-

nm_vpn_connection_new ()

-
GObject *           nm_vpn_connection_new               (DBusGConnection *connection,
-                                                         const char *path);
-

-Creates a new NMVPNConnection. -

-
+

nm_vpn_connection_new ()

+
GObject *
+nm_vpn_connection_new (DBusGConnection *connection,
+                       const char *path);
+

Creates a new NMVPNConnection.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + +

connection :

the DBusGConnection -

path :

the DBus object path of the new connection

connection

the DBusGConnection

 

Returns :

a new connection object. [transfer full] -

path

the DBus object path of the new connection

 
+
+

Returns

+

a new connection object.

+

[transfer full]

+
+

-

nm_vpn_connection_get_vpn_state ()

-
NMVPNConnectionState nm_vpn_connection_get_vpn_state    (NMVPNConnection *vpn);
-

-Gets the current NMVPNConnection state. -

-
+

nm_vpn_connection_get_vpn_state ()

+
NMVPNConnectionState
+nm_vpn_connection_get_vpn_state (NMVPNConnection *vpn);
+

Gets the current NMVPNConnection state.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

vpn :

a NMVPNConnection -

Returns :

the VPN state of the active VPN connection.

vpn

a NMVPNConnection

 
+
+

Returns

+

the VPN state of the active VPN connection.

+

+
+

-

nm_vpn_connection_get_banner ()

-
const char *        nm_vpn_connection_get_banner        (NMVPNConnection *vpn);
-

-Gets the VPN login banner of the active NMVPNConnection. -

-
+

nm_vpn_connection_get_banner ()

+
const char *
+nm_vpn_connection_get_banner (NMVPNConnection *vpn);
+

Gets the VPN login banner of the active NMVPNConnection.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

vpn :

a NMVPNConnection -

Returns :

the VPN login banner of the VPN connection. This is the internal -string used by the connection, and must not be modified.

vpn

a NMVPNConnection

 
+
+

Returns

+

the VPN login banner of the VPN connection. This is the internal +string used by the connection, and must not be modified.

+

+
+
-

Property Details

+

Types and Values

-

The "banner" property

-
  "banner"                   gchar*                : Read
+

NM_VPN_CONNECTION_VPN_STATE

+
#define NM_VPN_CONNECTION_VPN_STATE "vpn-state"
+

-The VPN login banner of the active VPN connection.

-

Default value: NULL


-

The "vpn-state" property

-
  "vpn-state"                guint                 : Read
+

NM_VPN_CONNECTION_BANNER

+
#define NM_VPN_CONNECTION_BANNER "banner"
+

-The VPN state of the active VPN connection.

+
+
+
+

Property Details

+
+

The “banner” property

+
  “banner”                   gchar *
+

+

Flags: Read

+

Default value: NULL

+
+
+
+

The “vpn-state” property

+
  “vpn-state”                guint
+

+

Flags: Read

Allowed values: <= 7

Default value: 0

@@ -242,34 +270,18 @@ The VPN state of the active VPN connection.

Signal Details

-

The "vpn-state-changed" signal

-
void                user_function                      (NMVPNConnection *nmvpnconnection,
-                                                        guint            arg1,
-                                                        guint            arg2,
-                                                        gpointer         user_data)            : Run First
-

-

-
---- - - - - - - - - - - -

nmvpnconnection :

the object which received the signal.

user_data :

user data set when the signal handler was connected.
+

The “vpn-state-changed” signal

+
void
+user_function (NMVPNConnection *nmvpnconnection,
+               guint            arg1,
+               guint            arg2,
+               gpointer         user_data)
+

Flags: Run First

+ Generated by GTK-Doc V1.21 \ No newline at end of file diff --git a/docs/libnm-glib/html/NMWimaxNsp.html b/docs/libnm-glib/html/NMWimaxNsp.html index ea7536cf..a83434a5 100644 --- a/docs/libnm-glib/html/NMWimaxNsp.html +++ b/docs/libnm-glib/html/NMWimaxNsp.html @@ -2,36 +2,28 @@ -NMWimaxNsp +libnm-glib Reference Manual: NMWimaxNsp - + - - - - - - - - - - + + + + + + +
@@ -39,351 +31,430 @@

NMWimaxNsp

NMWimaxNsp

- +
- -
-

Object Hierarchy

-
-  GObject
-   +----NMObject
-         +----NMWimaxNsp
-
-
-
-

Implemented Interfaces

-

-NMWimaxNsp implements - GInitable and GAsyncInitable.

-
-
-

Properties

-
-  "name"                     gchar*                : Read
-  "network-type"             guint                 : Read
-  "signal-quality"           guint                 : Read
-
-
-
-

Description

-

-

-
-

Details

-
-

NM_WIMAX_NSP_NAME

-
#define NM_WIMAX_NSP_NAME           "name"
-
-

-

-
-
-
-

NM_WIMAX_NSP_SIGNAL_QUALITY

-
#define NM_WIMAX_NSP_SIGNAL_QUALITY "signal-quality"
-
-

-

-
-
-
-

NM_WIMAX_NSP_NETWORK_TYPE

-
#define NM_WIMAX_NSP_NETWORK_TYPE   "network-type"
-
-

-

-
-
-
-

enum NMWimaxNspNetworkType

-
typedef enum {
-	NM_WIMAX_NSP_NETWORK_TYPE_UNKNOWN         = 0,
-	NM_WIMAX_NSP_NETWORK_TYPE_HOME            = 1,
-	NM_WIMAX_NSP_NETWORK_TYPE_PARTNER         = 2,
-	NM_WIMAX_NSP_NETWORK_TYPE_ROAMING_PARTNER = 3
-} NMWimaxNspNetworkType;
-
-

-WiMAX network type. -

-
+

Functions

+
--++ - - + + + + + - - + - - + - - + + + + +

NM_WIMAX_NSP_NETWORK_TYPE_UNKNOWN

unknown network type + +GObject * + +nm_wimax_nsp_new () +
const char * + +nm_wimax_nsp_get_name ()

NM_WIMAX_NSP_NETWORK_TYPE_HOME

home network + +guint32 + +nm_wimax_nsp_get_signal_quality ()

NM_WIMAX_NSP_NETWORK_TYPE_PARTNER

partner network + +NMWimaxNspNetworkType + +nm_wimax_nsp_get_network_type ()

NM_WIMAX_NSP_NETWORK_TYPE_ROAMING_PARTNER

roaming partner network + +GSList * + +nm_wimax_nsp_filter_connections () +
+gboolean + +nm_wimax_nsp_connection_valid ()
-
-
-

NMWimaxNsp

-
typedef struct _NMWimaxNsp NMWimaxNsp;
-

-

-
-
-
-

NMWimaxNspClass

-
typedef struct {
-	NMObjectClass parent;
-
-	/* Padding for future expansion */
-	void (*_reserved1) (void);
-	void (*_reserved2) (void);
-	void (*_reserved3) (void);
-	void (*_reserved4) (void);
-	void (*_reserved5) (void);
-	void (*_reserved6) (void);
-} NMWimaxNspClass;
-
-

-

-
-
-
-

nm_wimax_nsp_new ()

-
GObject *           nm_wimax_nsp_new                    (DBusGConnection *connection,
-                                                         const char *path);
-

-Creates a new NMWimaxNsp. -

-
+
+

Properties

+
--+++ - - + + + - - + + + - - + + +

connection :

the DBusGConnection - +gchar *nameRead

path :

the D-Bus object path of the WiMAX NSPguintnetwork-typeRead

Returns :

a new WiMAX NSP. [transfer full] -guintsignal-qualityRead
-
-
-

nm_wimax_nsp_get_name ()

-
const char *        nm_wimax_nsp_get_name               (NMWimaxNsp *nsp);
-

-Gets the name of the wimax NSP -

-
+
+

Types and Values

+
--++ - - + + + + + + - - + + + + + +

nsp :

a NMWimaxNsp -#defineNM_WIMAX_NSP_NAME
#defineNM_WIMAX_NSP_SIGNAL_QUALITY

Returns :

the name#defineNM_WIMAX_NSP_NETWORK_TYPE
enumNMWimaxNspNetworkType
-
-
-

nm_wimax_nsp_get_signal_quality ()

-
guint32             nm_wimax_nsp_get_signal_quality     (NMWimaxNsp *nsp);
+
+

Object Hierarchy

+
    GObject
+    ╰── NMObject
+        ╰── NMWimaxNsp
+
+
+
+

Description

-Gets the WPA signal quality of the wimax NSP.

-
+ +
+

Functions

+
+

nm_wimax_nsp_new ()

+
GObject *
+nm_wimax_nsp_new (DBusGConnection *connection,
+                  const char *path);
+

Creates a new NMWimaxNsp.

+
+

Parameters

+
--+++ - - + + + - - + + +

nsp :

a NMWimaxNsp -

connection

the DBusGConnection

 

Returns :

the signal quality

path

the D-Bus object path of the WiMAX NSP

 
+
+

Returns

+

a new WiMAX NSP.

+

[transfer full]

+
+

-

nm_wimax_nsp_get_network_type ()

-
NMWimaxNspNetworkType nm_wimax_nsp_get_network_type     (NMWimaxNsp *nsp);
-

-Gets the network type of the wimax NSP. -

-
+

nm_wimax_nsp_get_name ()

+
const char *
+nm_wimax_nsp_get_name (NMWimaxNsp *nsp);
+

Gets the name of the wimax NSP

+
+

Parameters

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

nsp

a NMWimaxNsp

 
+
+
+

Returns

+

the name

+

+
+
+
+
+

nm_wimax_nsp_get_signal_quality ()

+
guint32
+nm_wimax_nsp_get_signal_quality (NMWimaxNsp *nsp);
+

Gets the WPA signal quality of the wimax NSP.

+
+

Parameters

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

nsp

a NMWimaxNsp

 
+
+
+

Returns

+

the signal quality

+

+
+
+
+
+

nm_wimax_nsp_get_network_type ()

+
NMWimaxNspNetworkType
+nm_wimax_nsp_get_network_type (NMWimaxNsp *nsp);
+

Gets the network type of the wimax NSP.

+
+

Parameters

+
--++++ + + + + + +

nsp

a NMWimaxNsp

 
+
+
+

Returns

+

the network type

+

+
+
+
+
+

nm_wimax_nsp_filter_connections ()

+
GSList *
+nm_wimax_nsp_filter_connections (NMWimaxNsp *nsp,
+                                 const GSList *connections);
+

Filters a given list of connections for a given NMWimaxNsp object and +return connections which may be activated with the access point. Any +returned connections will match the nsp +'s network name and other attributes.

+
+

Parameters

+
++++ - - + + + - - + + +

nsp :

a NMWimaxNsp -

nsp

an NMWimaxNsp to filter connections for

 

Returns :

the network type

connections

a list of +NMConnection objects to filter.

[element-type NMConnection]
+
+

Returns

+

a +list of NMConnection objects that could be activated with the given nsp +. +The elements of the list are owned by their creator and should not be freed +by the caller, but the returned list itself is owned by the caller and should +be freed with g_slist_free() when it is no longer required.

+

[transfer container][element-type NMConnection]

+
+

-

nm_wimax_nsp_filter_connections ()

-
GSList *            nm_wimax_nsp_filter_connections     (NMWimaxNsp *nsp,
-                                                         const GSList *connections);
-

-Filters a given list of connections for a given NMWimaxNsp object and -return connections which may be activated with the access point. Any -returned connections will match the nsp's network name and other attributes. -

-
+

nm_wimax_nsp_connection_valid ()

+
gboolean
+nm_wimax_nsp_connection_valid (NMWimaxNsp *nsp,
+                               NMConnection *connection);
+

Validates a given connection against a given WiMAX NSP to ensure that the +connection may be activated with that NSP. The connection must match the +nsp +'s network name and other attributes.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + +

nsp :

an NMWimaxNsp to filter connections for

connections :

a list of -NMConnection objects to filter. [element-type NMConnection] -

nsp

an NMWimaxNsp to validate connection +against

 

Returns :

a -list of NMConnection objects that could be activated with the given nsp. -The elements of the list are owned by their creator and should not be freed -by the caller, but the returned list itself is owned by the caller and should -be freed with g_slist_free() when it is no longer required. [transfer container][element-type NMConnection] -

connection

an NMConnection to validate against nsp +

 
+
+

Returns

+

TRUE if the connection may be activated with this WiMAX NSP, +FALSE if it cannot be.

+

+
+
+ +
+

Types and Values

+
+

NM_WIMAX_NSP_NAME

+
#define NM_WIMAX_NSP_NAME           "name"
+
+

+

+

-

nm_wimax_nsp_connection_valid ()

-
gboolean            nm_wimax_nsp_connection_valid       (NMWimaxNsp *nsp,
-                                                         NMConnection *connection);
+

NM_WIMAX_NSP_SIGNAL_QUALITY

+
#define NM_WIMAX_NSP_SIGNAL_QUALITY "signal-quality"
+
+

+

+
+
+
+

NM_WIMAX_NSP_NETWORK_TYPE

+
#define NM_WIMAX_NSP_NETWORK_TYPE   "network-type"
+

-Validates a given connection against a given WiMAX NSP to ensure that the -connection may be activated with that NSP. The connection must match the -nsp's network name and other attributes.

-
+ +
+
+

enum NMWimaxNspNetworkType

+

WiMAX network type.

+
+

Members

+
--+++ - - + + + - - + + - - + + + + + + + +

nsp :

an NMWimaxNsp to validate connection against

NM_WIMAX_NSP_NETWORK_TYPE_UNKNOWN

+

unknown network type

+
 

connection :

an NMConnection to validate against nsp +

NM_WIMAX_NSP_NETWORK_TYPE_HOME

+

home network

 

Returns :

-TRUE if the connection may be activated with this WiMAX NSP, -FALSE if it cannot be.

NM_WIMAX_NSP_NETWORK_TYPE_PARTNER

+

partner network

+
 

NM_WIMAX_NSP_NETWORK_TYPE_ROAMING_PARTNER

+

roaming partner network

+
 
+

Property Details

-

The "name" property

-
  "name"                     gchar*                : Read
-

-The name of the WiMAX NSP. -

+

The “name” property

+
  “name”                     gchar *
+

+

Flags: Read

Default value: NULL


-

The "network-type" property

-
  "network-type"             guint                 : Read
-

-The network type of the WiMAX NSP. -

+

The “network-type” property

+
  “network-type”             guint
+

+

Flags: Read

Default value: 0


-

The "signal-quality" property

-
  "signal-quality"           guint                 : Read
-

-The signal quality of the WiMAX NSP. -

+

The “signal-quality” property

+
  “signal-quality”           guint
+

+

Flags: Read

Allowed values: <= 100

Default value: 0

@@ -391,6 +462,6 @@ The signal quality of the WiMAX NSP.
+ Generated by GTK-Doc V1.21 \ No newline at end of file diff --git a/docs/libnm-glib/html/annotation-glossary.html b/docs/libnm-glib/html/annotation-glossary.html index 7c26248c..03f6d263 100644 --- a/docs/libnm-glib/html/annotation-glossary.html +++ b/docs/libnm-glib/html/annotation-glossary.html @@ -2,43 +2,38 @@ -Annotation Glossary +libnm-glib Reference Manual: Annotation Glossary - + - - - - - - - - - - + + + + + + +

Annotation Glossary

A

allow-none
-

NULL is ok, both for passing and for returning.

+

NULL is OK, both for passing and for returning.

array

Parameter points to an array of items.

C

@@ -60,11 +55,9 @@

Free data after the code is done.

transfer none

Don't free data after the code is done.

-
type
-

Override the parsed C type with given type.

+ Generated by GTK-Doc V1.21 \ No newline at end of file diff --git a/docs/libnm-glib/html/api-index-full.html b/docs/libnm-glib/html/api-index-full.html index e52c73aa..59052d84 100644 --- a/docs/libnm-glib/html/api-index-full.html +++ b/docs/libnm-glib/html/api-index-full.html @@ -2,94 +2,81 @@ -API Index +libnm-glib Reference Manual: API Index - + - - - - - - - - - - + + + + + + +

API Index

A

-NMAccessPoint, struct in NMAccessPoint +NMAccessPoint:bssid, object property in NMAccessPoint
-NMAccessPoint:bssid, object property in NMAccessPoint +NMAccessPoint:flags, object property in NMAccessPoint
-NMAccessPoint:flags, object property in NMAccessPoint +NMAccessPoint:frequency, object property in NMAccessPoint
-NMAccessPoint:frequency, object property in NMAccessPoint +NMAccessPoint:hw-address, object property in NMAccessPoint
-NMAccessPoint:hw-address, object property in NMAccessPoint +NMAccessPoint:max-bitrate, object property in NMAccessPoint
-NMAccessPoint:max-bitrate, object property in NMAccessPoint +NMAccessPoint:mode, object property in NMAccessPoint
-NMAccessPoint:mode, object property in NMAccessPoint +NMAccessPoint:rsn-flags, object property in NMAccessPoint
-NMAccessPoint:rsn-flags, object property in NMAccessPoint +NMAccessPoint:ssid, object property in NMAccessPoint
-NMAccessPoint:ssid, object property in NMAccessPoint +NMAccessPoint:strength, object property in NMAccessPoint
-NMAccessPoint:strength, object property in NMAccessPoint -
-
-
-NMAccessPoint:wpa-flags, object property in NMAccessPoint -
-
-
-NMAccessPointClass, struct in NMAccessPoint +NMAccessPoint:wpa-flags, object property in NMAccessPoint
@@ -97,11 +84,11 @@
-nm_access_point_connection_valid, function in NMAccessPoint +nm_access_point_connection_valid, function in NMAccessPoint
-nm_access_point_filter_connections, function in NMAccessPoint +nm_access_point_filter_connections, function in NMAccessPoint
@@ -113,43 +100,43 @@
-nm_access_point_get_bssid, function in NMAccessPoint +nm_access_point_get_bssid, function in NMAccessPoint
-nm_access_point_get_flags, function in NMAccessPoint +nm_access_point_get_flags, function in NMAccessPoint
-nm_access_point_get_frequency, function in NMAccessPoint +nm_access_point_get_frequency, function in NMAccessPoint
-nm_access_point_get_hw_address, function in NMAccessPoint +nm_access_point_get_hw_address, function in NMAccessPoint
-nm_access_point_get_max_bitrate, function in NMAccessPoint +nm_access_point_get_max_bitrate, function in NMAccessPoint
-nm_access_point_get_mode, function in NMAccessPoint +nm_access_point_get_mode, function in NMAccessPoint
-nm_access_point_get_rsn_flags, function in NMAccessPoint +nm_access_point_get_rsn_flags, function in NMAccessPoint
-nm_access_point_get_ssid, function in NMAccessPoint +nm_access_point_get_ssid, function in NMAccessPoint
-nm_access_point_get_strength, function in NMAccessPoint +nm_access_point_get_strength, function in NMAccessPoint
-nm_access_point_get_wpa_flags, function in NMAccessPoint +nm_access_point_get_wpa_flags, function in NMAccessPoint
@@ -165,7 +152,7 @@
-nm_access_point_new, function in NMAccessPoint +nm_access_point_new, function in NMAccessPoint
@@ -185,71 +172,63 @@
-NMActiveConnection, struct in NMActiveConnection -
-
-
-NMActiveConnection:connection, object property in NMActiveConnection -
-
-
-NMActiveConnection:default, object property in NMActiveConnection +NMActiveConnection:connection, object property in NMActiveConnection
-NMActiveConnection:default6, object property in NMActiveConnection +NMActiveConnection:default, object property in NMActiveConnection
-NMActiveConnection:devices, object property in NMActiveConnection +NMActiveConnection:default6, object property in NMActiveConnection
-NMActiveConnection:dhcp4-config, object property in NMActiveConnection +NMActiveConnection:devices, object property in NMActiveConnection
-NMActiveConnection:dhcp6-config, object property in NMActiveConnection +NMActiveConnection:dhcp4-config, object property in NMActiveConnection
-NMActiveConnection:id, object property in NMActiveConnection +NMActiveConnection:dhcp6-config, object property in NMActiveConnection
-NMActiveConnection:ip4-config, object property in NMActiveConnection +NMActiveConnection:id, object property in NMActiveConnection
-NMActiveConnection:ip6-config, object property in NMActiveConnection +NMActiveConnection:ip4-config, object property in NMActiveConnection
-NMActiveConnection:master, object property in NMActiveConnection +NMActiveConnection:ip6-config, object property in NMActiveConnection
-NMActiveConnection:specific-object, object property in NMActiveConnection +NMActiveConnection:master, object property in NMActiveConnection
-NMActiveConnection:state, object property in NMActiveConnection +NMActiveConnection:specific-object, object property in NMActiveConnection
-NMActiveConnection:type, object property in NMActiveConnection +NMActiveConnection:state, object property in NMActiveConnection
-NMActiveConnection:uuid, object property in NMActiveConnection +NMActiveConnection:type, object property in NMActiveConnection
-NMActiveConnection:vpn, object property in NMActiveConnection +NMActiveConnection:uuid, object property in NMActiveConnection
-NMActiveConnectionClass, struct in NMActiveConnection +NMActiveConnection:vpn, object property in NMActiveConnection
@@ -277,63 +256,63 @@
-nm_active_connection_get_connection, function in NMActiveConnection +nm_active_connection_get_connection, function in NMActiveConnection
-nm_active_connection_get_connection_type, function in NMActiveConnection +nm_active_connection_get_connection_type, function in NMActiveConnection
-nm_active_connection_get_default, function in NMActiveConnection +nm_active_connection_get_default, function in NMActiveConnection
-nm_active_connection_get_default6, function in NMActiveConnection +nm_active_connection_get_default6, function in NMActiveConnection
-nm_active_connection_get_devices, function in NMActiveConnection +nm_active_connection_get_devices, function in NMActiveConnection
-nm_active_connection_get_dhcp4_config, function in NMActiveConnection +nm_active_connection_get_dhcp4_config, function in NMActiveConnection
-nm_active_connection_get_dhcp6_config, function in NMActiveConnection +nm_active_connection_get_dhcp6_config, function in NMActiveConnection
-nm_active_connection_get_id, function in NMActiveConnection +nm_active_connection_get_id, function in NMActiveConnection
-nm_active_connection_get_ip4_config, function in NMActiveConnection +nm_active_connection_get_ip4_config, function in NMActiveConnection
-nm_active_connection_get_ip6_config, function in NMActiveConnection +nm_active_connection_get_ip6_config, function in NMActiveConnection
-nm_active_connection_get_master, function in NMActiveConnection +nm_active_connection_get_master, function in NMActiveConnection
-nm_active_connection_get_specific_object, function in NMActiveConnection +nm_active_connection_get_specific_object, function in NMActiveConnection
-nm_active_connection_get_state, function in NMActiveConnection +nm_active_connection_get_state, function in NMActiveConnection
-nm_active_connection_get_uuid, function in NMActiveConnection +nm_active_connection_get_uuid, function in NMActiveConnection
-nm_active_connection_get_vpn, function in NMActiveConnection +nm_active_connection_get_vpn, function in NMActiveConnection
@@ -353,7 +332,7 @@
-nm_active_connection_new, function in NMActiveConnection +nm_active_connection_new, function in NMActiveConnection
@@ -378,95 +357,87 @@

C

-NMClient, struct in NMClient -
-
-
-NMClient::device-added, object signal in NMClient +NMClient::device-added, object signal in NMClient
-NMClient::device-removed, object signal in NMClient +NMClient::device-removed, object signal in NMClient
-NMClient::permission-changed, object signal in NMClient +NMClient::permission-changed, object signal in NMClient
-NMClient:activating-connection, object property in NMClient +NMClient:activating-connection, object property in NMClient
-NMClient:active-connections, object property in NMClient +NMClient:active-connections, object property in NMClient
-NMClient:connectivity, object property in NMClient +NMClient:connectivity, object property in NMClient
-NMClient:devices, object property in NMClient +NMClient:devices, object property in NMClient
-NMClient:manager-running, object property in NMClient +NMClient:manager-running, object property in NMClient
-NMClient:networking-enabled, object property in NMClient +NMClient:networking-enabled, object property in NMClient
-NMClient:primary-connection, object property in NMClient +NMClient:primary-connection, object property in NMClient
-NMClient:startup, object property in NMClient +NMClient:startup, object property in NMClient
-NMClient:state, object property in NMClient +NMClient:state, object property in NMClient
-NMClient:version, object property in NMClient +NMClient:version, object property in NMClient
-NMClient:wimax-enabled, object property in NMClient +NMClient:wimax-enabled, object property in NMClient
-NMClient:wimax-hardware-enabled, object property in NMClient +NMClient:wimax-hardware-enabled, object property in NMClient
-NMClient:wireless-enabled, object property in NMClient +NMClient:wireless-enabled, object property in NMClient
-NMClient:wireless-hardware-enabled, object property in NMClient +NMClient:wireless-hardware-enabled, object property in NMClient
-NMClient:wwan-enabled, object property in NMClient +NMClient:wwan-enabled, object property in NMClient
-NMClient:wwan-hardware-enabled, object property in NMClient +NMClient:wwan-hardware-enabled, object property in NMClient
-NMClientActivateFn, user_function in NMClient +NMClientActivateFn, user_function in NMClient
-NMClientAddActivateFn, user_function in NMClient -
-
-
-NMClientClass, struct in NMClient +NMClientAddActivateFn, user_function in NMClient
@@ -482,7 +453,7 @@
-nm_client_activate_connection, function in NMClient +nm_client_activate_connection, function in NMClient
@@ -494,19 +465,19 @@
-nm_client_add_and_activate_connection, function in NMClient +nm_client_add_and_activate_connection, function in NMClient
-nm_client_check_connectivity, function in NMClient +nm_client_check_connectivity, function in NMClient
-nm_client_check_connectivity_async, function in NMClient +nm_client_check_connectivity_async, function in NMClient
-nm_client_check_connectivity_finish, function in NMClient +nm_client_check_connectivity_finish, function in NMClient
@@ -514,7 +485,7 @@
-nm_client_deactivate_connection, function in NMClient +nm_client_deactivate_connection, function in NMClient
@@ -526,59 +497,59 @@
-nm_client_error_quark, function in NMClient +nm_client_error_quark, function in NMClient
-nm_client_get_activating_connection, function in NMClient +nm_client_get_activating_connection, function in NMClient
-nm_client_get_active_connections, function in NMClient +nm_client_get_active_connections, function in NMClient
-nm_client_get_connectivity, function in NMClient +nm_client_get_connectivity, function in NMClient
-nm_client_get_devices, function in NMClient +nm_client_get_devices, function in NMClient
-nm_client_get_device_by_iface, function in NMClient +nm_client_get_device_by_iface, function in NMClient
-nm_client_get_device_by_path, function in NMClient +nm_client_get_device_by_path, function in NMClient
-nm_client_get_logging, function in NMClient +nm_client_get_logging, function in NMClient
-nm_client_get_manager_running, function in NMClient +nm_client_get_manager_running, function in NMClient
-nm_client_get_permission_result, function in NMClient +nm_client_get_permission_result, function in NMClient
-nm_client_get_primary_connection, function in NMClient +nm_client_get_primary_connection, function in NMClient
-nm_client_get_startup, function in NMClient +nm_client_get_startup, function in NMClient
-nm_client_get_state, function in NMClient +nm_client_get_state, function in NMClient
-nm_client_get_version, function in NMClient +nm_client_get_version, function in NMClient
@@ -590,23 +561,23 @@
-nm_client_networking_get_enabled, function in NMClient +nm_client_networking_get_enabled, function in NMClient
-nm_client_networking_set_enabled, function in NMClient +nm_client_networking_set_enabled, function in NMClient
-nm_client_new, function in NMClient +nm_client_new, function in NMClient
-nm_client_new_async, function in NMClient +nm_client_new_async, function in NMClient
-nm_client_new_finish, function in NMClient +nm_client_new_finish, function in NMClient
@@ -614,11 +585,11 @@
-nm_client_set_logging, function in NMClient +nm_client_set_logging, function in NMClient
-nm_client_sleep, function in NMClient +nm_client_sleep, function in NMClient
@@ -638,7 +609,7 @@
-nm_client_wimax_get_enabled, function in NMClient +nm_client_wimax_get_enabled, function in NMClient
@@ -646,11 +617,11 @@
-nm_client_wimax_hardware_get_enabled, function in NMClient +nm_client_wimax_hardware_get_enabled, function in NMClient
-nm_client_wimax_set_enabled, function in NMClient +nm_client_wimax_set_enabled, function in NMClient
@@ -658,7 +629,7 @@
-nm_client_wireless_get_enabled, function in NMClient +nm_client_wireless_get_enabled, function in NMClient
@@ -666,11 +637,11 @@
-nm_client_wireless_hardware_get_enabled, function in NMClient +nm_client_wireless_hardware_get_enabled, function in NMClient
-nm_client_wireless_set_enabled, function in NMClient +nm_client_wireless_set_enabled, function in NMClient
@@ -678,7 +649,7 @@
-nm_client_wwan_get_enabled, function in NMClient +nm_client_wwan_get_enabled, function in NMClient
@@ -686,124 +657,112 @@
-nm_client_wwan_hardware_get_enabled, function in NMClient +nm_client_wwan_hardware_get_enabled, function in NMClient
-nm_client_wwan_set_enabled, function in NMClient +nm_client_wwan_set_enabled, function in NMClient

D

-NMDevice, struct in NMDevice -
-
-
-NMDevice::state-changed, object signal in NMDevice -
-
-
-NMDevice:active-connection, object property in NMDevice -
-
-
-NMDevice:autoconnect, object property in NMDevice +NMDevice::state-changed, object signal in NMDevice
-NMDevice:available-connections, object property in NMDevice +NMDevice:active-connection, object property in NMDevice
-NMDevice:capabilities, object property in NMDevice +NMDevice:autoconnect, object property in NMDevice
-NMDevice:device-type, object property in NMDevice +NMDevice:available-connections, object property in NMDevice
-NMDevice:dhcp4-config, object property in NMDevice +NMDevice:capabilities, object property in NMDevice
-NMDevice:dhcp6-config, object property in NMDevice +NMDevice:device-type, object property in NMDevice
-NMDevice:driver, object property in NMDevice +NMDevice:dhcp4-config, object property in NMDevice
-NMDevice:driver-version, object property in NMDevice +NMDevice:dhcp6-config, object property in NMDevice
-NMDevice:firmware-missing, object property in NMDevice +NMDevice:driver, object property in NMDevice
-NMDevice:firmware-version, object property in NMDevice +NMDevice:driver-version, object property in NMDevice
-NMDevice:interface, object property in NMDevice +NMDevice:firmware-missing, object property in NMDevice
-NMDevice:ip-interface, object property in NMDevice +NMDevice:firmware-version, object property in NMDevice
-NMDevice:ip4-config, object property in NMDevice +NMDevice:interface, object property in NMDevice
-NMDevice:ip6-config, object property in NMDevice +NMDevice:ip-interface, object property in NMDevice
-NMDevice:managed, object property in NMDevice +NMDevice:ip4-config, object property in NMDevice
-NMDevice:mtu, object property in NMDevice +NMDevice:ip6-config, object property in NMDevice
-NMDevice:physical-port-id, object property in NMDevice +NMDevice:managed, object property in NMDevice
-NMDevice:product, object property in NMDevice +NMDevice:mtu, object property in NMDevice
-NMDevice:state, object property in NMDevice +NMDevice:physical-port-id, object property in NMDevice
-NMDevice:state-reason, object property in NMDevice +NMDevice:product, object property in NMDevice
-NMDevice:udi, object property in NMDevice +NMDevice:state, object property in NMDevice
-NMDevice:vendor, object property in NMDevice +NMDevice:state-reason, object property in NMDevice
-NMDeviceAdsl, struct in NMDeviceAdsl +NMDevice:udi, object property in NMDevice
-NMDeviceAdsl:carrier, object property in NMDeviceAdsl +NMDevice:vendor, object property in NMDevice
-NMDeviceAdslClass, struct in NMDeviceAdsl +NMDeviceAdsl:carrier, object property in NMDeviceAdsl
@@ -811,23 +770,15 @@
-NMDeviceBond, struct in NMDeviceBond -
-
-
-NMDeviceBond:carrier, object property in NMDeviceBond -
-
-
-NMDeviceBond:hw-address, object property in NMDeviceBond +NMDeviceBond:carrier, object property in NMDeviceBond
-NMDeviceBond:slaves, object property in NMDeviceBond +NMDeviceBond:hw-address, object property in NMDeviceBond
-NMDeviceBondClass, struct in NMDeviceBond +NMDeviceBond:slaves, object property in NMDeviceBond
@@ -835,23 +786,15 @@
-NMDeviceBridge, struct in NMDeviceBridge +NMDeviceBridge:carrier, object property in NMDeviceBridge
-NMDeviceBridge:carrier, object property in NMDeviceBridge +NMDeviceBridge:hw-address, object property in NMDeviceBridge
-NMDeviceBridge:hw-address, object property in NMDeviceBridge -
-
-
-NMDeviceBridge:slaves, object property in NMDeviceBridge -
-
-
-NMDeviceBridgeClass, struct in NMDeviceBridge +NMDeviceBridge:slaves, object property in NMDeviceBridge
@@ -859,23 +802,15 @@
-NMDeviceBt, struct in NMDeviceBt +NMDeviceBt:bt-capabilities, object property in NMDeviceBt
-NMDeviceBt:bt-capabilities, object property in NMDeviceBt +NMDeviceBt:hw-address, object property in NMDeviceBt
-NMDeviceBt:hw-address, object property in NMDeviceBt -
-
-
-NMDeviceBt:name, object property in NMDeviceBt -
-
-
-NMDeviceBtClass, struct in NMDeviceBt +NMDeviceBt:name, object property in NMDeviceBt
@@ -883,15 +818,11 @@
-NMDeviceCallbackFn, user_function in NMDevice -
-
-
-NMDeviceClass, struct in NMDevice +NMDeviceCallbackFn, user_function in NMDevice
-NMDeviceDeactivateFn, user_function in NMDevice +NMDeviceDeactivateFn, user_function in NMDevice
@@ -899,27 +830,19 @@
-NMDeviceEthernet, struct in NMDeviceEthernet +NMDeviceEthernet:carrier, object property in NMDeviceEthernet
-NMDeviceEthernet:carrier, object property in NMDeviceEthernet +NMDeviceEthernet:hw-address, object property in NMDeviceEthernet
-NMDeviceEthernet:hw-address, object property in NMDeviceEthernet +NMDeviceEthernet:perm-hw-address, object property in NMDeviceEthernet
-NMDeviceEthernet:perm-hw-address, object property in NMDeviceEthernet -
-
-
-NMDeviceEthernet:speed, object property in NMDeviceEthernet -
-
-
-NMDeviceEthernetClass, struct in NMDeviceEthernet +NMDeviceEthernet:speed, object property in NMDeviceEthernet
@@ -927,19 +850,11 @@
-NMDeviceGeneric, struct in NMDeviceGeneric -
-
-
-NMDeviceGeneric:hw-address, object property in NMDeviceGeneric -
-
-
-NMDeviceGeneric:type-description, object property in NMDeviceGeneric +NMDeviceGeneric:hw-address, object property in NMDeviceGeneric
-NMDeviceGenericClass, struct in NMDeviceGeneric +NMDeviceGeneric:type-description, object property in NMDeviceGeneric
@@ -947,19 +862,11 @@
-NMDeviceInfiniband, struct in NMDeviceInfiniband -
-
-
-NMDeviceInfiniband:carrier, object property in NMDeviceInfiniband -
-
-
-NMDeviceInfiniband:hw-address, object property in NMDeviceInfiniband +NMDeviceInfiniband:carrier, object property in NMDeviceInfiniband
-NMDeviceInfinibandClass, struct in NMDeviceInfiniband +NMDeviceInfiniband:hw-address, object property in NMDeviceInfiniband
@@ -967,19 +874,11 @@
-NMDeviceModem, struct in NMDeviceModem +NMDeviceModem:current-capabilities, object property in NMDeviceModem
-NMDeviceModem:current-capabilities, object property in NMDeviceModem -
-
-
-NMDeviceModem:modem-capabilities, object property in NMDeviceModem -
-
-
-NMDeviceModemClass, struct in NMDeviceModem +NMDeviceModem:modem-capabilities, object property in NMDeviceModem
@@ -987,23 +886,15 @@
-NMDeviceOlpcMesh, struct in NMDeviceOlpcMesh +NMDeviceOlpcMesh:active-channel, object property in NMDeviceOlpcMesh
-NMDeviceOlpcMesh:active-channel, object property in NMDeviceOlpcMesh +NMDeviceOlpcMesh:companion, object property in NMDeviceOlpcMesh
-NMDeviceOlpcMesh:companion, object property in NMDeviceOlpcMesh -
-
-
-NMDeviceOlpcMesh:hw-address, object property in NMDeviceOlpcMesh -
-
-
-NMDeviceOlpcMeshClass, struct in NMDeviceOlpcMesh +NMDeviceOlpcMesh:hw-address, object property in NMDeviceOlpcMesh
@@ -1011,23 +902,15 @@
-NMDeviceTeam, struct in NMDeviceTeam -
-
-
-NMDeviceTeam:carrier, object property in NMDeviceTeam -
-
-
-NMDeviceTeam:hw-address, object property in NMDeviceTeam +NMDeviceTeam:carrier, object property in NMDeviceTeam
-NMDeviceTeam:slaves, object property in NMDeviceTeam +NMDeviceTeam:hw-address, object property in NMDeviceTeam
-NMDeviceTeamClass, struct in NMDeviceTeam +NMDeviceTeam:slaves, object property in NMDeviceTeam
@@ -1035,27 +918,19 @@
-NMDeviceVlan, struct in NMDeviceVlan -
-
-
-NMDeviceVlan:carrier, object property in NMDeviceVlan +NMDeviceVlan:carrier, object property in NMDeviceVlan
-NMDeviceVlan:hw-address, object property in NMDeviceVlan +NMDeviceVlan:hw-address, object property in NMDeviceVlan
-NMDeviceVlan:parent, object property in NMDeviceVlan +NMDeviceVlan:parent, object property in NMDeviceVlan
-NMDeviceVlan:vlan-id, object property in NMDeviceVlan -
-
-
-NMDeviceVlanClass, struct in NMDeviceVlan +NMDeviceVlan:vlan-id, object property in NMDeviceVlan
@@ -1063,47 +938,39 @@
-NMDeviceWifi, struct in NMDeviceWifi -
-
-
-NMDeviceWifi::access-point-added, object signal in NMDeviceWifi +NMDeviceWifi::access-point-added, object signal in NMDeviceWifi
-NMDeviceWifi::access-point-removed, object signal in NMDeviceWifi +NMDeviceWifi::access-point-removed, object signal in NMDeviceWifi
-NMDeviceWifi:access-points, object property in NMDeviceWifi +NMDeviceWifi:access-points, object property in NMDeviceWifi
-NMDeviceWifi:active-access-point, object property in NMDeviceWifi +NMDeviceWifi:active-access-point, object property in NMDeviceWifi
-NMDeviceWifi:bitrate, object property in NMDeviceWifi +NMDeviceWifi:bitrate, object property in NMDeviceWifi
-NMDeviceWifi:hw-address, object property in NMDeviceWifi +NMDeviceWifi:hw-address, object property in NMDeviceWifi
-NMDeviceWifi:mode, object property in NMDeviceWifi +NMDeviceWifi:mode, object property in NMDeviceWifi
-NMDeviceWifi:perm-hw-address, object property in NMDeviceWifi +NMDeviceWifi:perm-hw-address, object property in NMDeviceWifi
-NMDeviceWifi:wireless-capabilities, object property in NMDeviceWifi -
-
-
-NMDeviceWifiClass, struct in NMDeviceWifi +NMDeviceWifi:wireless-capabilities, object property in NMDeviceWifi
@@ -1111,55 +978,47 @@
-NMDeviceWifiRequestScanFn, user_function in NMDeviceWifi -
-
-
-NMDeviceWimax, struct in NMDeviceWimax -
-
-
-NMDeviceWimax::nsp-added, object signal in NMDeviceWimax +NMDeviceWifiRequestScanFn, user_function in NMDeviceWifi
-NMDeviceWimax::nsp-removed, object signal in NMDeviceWimax +NMDeviceWimax::nsp-added, object signal in NMDeviceWimax
-NMDeviceWimax:active-nsp, object property in NMDeviceWimax +NMDeviceWimax::nsp-removed, object signal in NMDeviceWimax
-NMDeviceWimax:bsid, object property in NMDeviceWimax +NMDeviceWimax:active-nsp, object property in NMDeviceWimax
-NMDeviceWimax:center-frequency, object property in NMDeviceWimax +NMDeviceWimax:bsid, object property in NMDeviceWimax
-NMDeviceWimax:cinr, object property in NMDeviceWimax +NMDeviceWimax:center-frequency, object property in NMDeviceWimax
-NMDeviceWimax:hw-address, object property in NMDeviceWimax +NMDeviceWimax:cinr, object property in NMDeviceWimax
-NMDeviceWimax:nsps, object property in NMDeviceWimax +NMDeviceWimax:hw-address, object property in NMDeviceWimax
-NMDeviceWimax:rssi, object property in NMDeviceWimax +NMDeviceWimax:nsps, object property in NMDeviceWimax
-NMDeviceWimax:tx-power, object property in NMDeviceWimax +NMDeviceWimax:rssi, object property in NMDeviceWimax
-NMDeviceWimaxClass, struct in NMDeviceWimax +NMDeviceWimax:tx-power, object property in NMDeviceWimax
@@ -1179,15 +1038,15 @@
-nm_device_adsl_error_quark, function in NMDeviceAdsl +nm_device_adsl_error_quark, function in NMDeviceAdsl
-nm_device_adsl_get_carrier, function in NMDeviceAdsl +nm_device_adsl_get_carrier, function in NMDeviceAdsl
-nm_device_adsl_new, function in NMDeviceAdsl +nm_device_adsl_new, function in NMDeviceAdsl
@@ -1207,19 +1066,19 @@
-nm_device_bond_error_quark, function in NMDeviceBond +nm_device_bond_error_quark, function in NMDeviceBond
-nm_device_bond_get_carrier, function in NMDeviceBond +nm_device_bond_get_carrier, function in NMDeviceBond
-nm_device_bond_get_hw_address, function in NMDeviceBond +nm_device_bond_get_hw_address, function in NMDeviceBond
-nm_device_bond_get_slaves, function in NMDeviceBond +nm_device_bond_get_slaves, function in NMDeviceBond
@@ -1227,7 +1086,7 @@
-nm_device_bond_new, function in NMDeviceBond +nm_device_bond_new, function in NMDeviceBond
@@ -1243,19 +1102,19 @@
-nm_device_bridge_error_quark, function in NMDeviceBridge +nm_device_bridge_error_quark, function in NMDeviceBridge
-nm_device_bridge_get_carrier, function in NMDeviceBridge +nm_device_bridge_get_carrier, function in NMDeviceBridge
-nm_device_bridge_get_hw_address, function in NMDeviceBridge +nm_device_bridge_get_hw_address, function in NMDeviceBridge
-nm_device_bridge_get_slaves, function in NMDeviceBridge +nm_device_bridge_get_slaves, function in NMDeviceBridge
@@ -1263,7 +1122,7 @@
-nm_device_bridge_new, function in NMDeviceBridge +nm_device_bridge_new, function in NMDeviceBridge
@@ -1279,19 +1138,19 @@
-nm_device_bt_error_quark, function in NMDeviceBt +nm_device_bt_error_quark, function in NMDeviceBt
-nm_device_bt_get_capabilities, function in NMDeviceBt +nm_device_bt_get_capabilities, function in NMDeviceBt
-nm_device_bt_get_hw_address, function in NMDeviceBt +nm_device_bt_get_hw_address, function in NMDeviceBt
-nm_device_bt_get_name, function in NMDeviceBt +nm_device_bt_get_name, function in NMDeviceBt
@@ -1303,7 +1162,7 @@
-nm_device_bt_new, function in NMDeviceBt +nm_device_bt_new, function in NMDeviceBt
@@ -1311,15 +1170,15 @@
-nm_device_connection_compatible, function in NMDevice +nm_device_connection_compatible, function in NMDevice
-nm_device_connection_valid, function in NMDevice +nm_device_connection_valid, function in NMDevice
-nm_device_delete, function in NMDevice +nm_device_delete, function in NMDevice
@@ -1335,11 +1194,11 @@
-nm_device_disambiguate_names, function in NMDevice +nm_device_disambiguate_names, function in NMDevice
-nm_device_disconnect, function in NMDevice +nm_device_disconnect, function in NMDevice
@@ -1355,7 +1214,7 @@
-nm_device_error_quark, function in NMDevice +nm_device_error_quark, function in NMDevice
@@ -1367,23 +1226,23 @@
-nm_device_ethernet_error_quark, function in NMDeviceEthernet +nm_device_ethernet_error_quark, function in NMDeviceEthernet
-nm_device_ethernet_get_carrier, function in NMDeviceEthernet +nm_device_ethernet_get_carrier, function in NMDeviceEthernet
-nm_device_ethernet_get_hw_address, function in NMDeviceEthernet +nm_device_ethernet_get_hw_address, function in NMDeviceEthernet
-nm_device_ethernet_get_permanent_hw_address, function in NMDeviceEthernet +nm_device_ethernet_get_permanent_hw_address, function in NMDeviceEthernet
-nm_device_ethernet_get_speed, function in NMDeviceEthernet +nm_device_ethernet_get_speed, function in NMDeviceEthernet
@@ -1391,7 +1250,7 @@
-nm_device_ethernet_new, function in NMDeviceEthernet +nm_device_ethernet_new, function in NMDeviceEthernet
@@ -1403,7 +1262,7 @@
-nm_device_filter_connections, function in NMDevice +nm_device_filter_connections, function in NMDevice
@@ -1419,11 +1278,11 @@
-nm_device_generic_error_quark, function in NMDeviceGeneric +nm_device_generic_error_quark, function in NMDeviceGeneric
-nm_device_generic_get_hw_address, function in NMDeviceGeneric +nm_device_generic_get_hw_address, function in NMDeviceGeneric
@@ -1431,7 +1290,7 @@
-nm_device_generic_new, function in NMDeviceGeneric +nm_device_generic_new, function in NMDeviceGeneric
@@ -1439,111 +1298,111 @@
-nm_device_get_active_connection, function in NMDevice +nm_device_get_active_connection, function in NMDevice
-nm_device_get_autoconnect, function in NMDevice +nm_device_get_autoconnect, function in NMDevice
-nm_device_get_available_connections, function in NMDevice +nm_device_get_available_connections, function in NMDevice
-nm_device_get_capabilities, function in NMDevice +nm_device_get_capabilities, function in NMDevice
-nm_device_get_description, function in NMDevice +nm_device_get_description, function in NMDevice
-nm_device_get_device_type, function in NMDevice +nm_device_get_device_type, function in NMDevice
-nm_device_get_dhcp4_config, function in NMDevice +nm_device_get_dhcp4_config, function in NMDevice
-nm_device_get_dhcp6_config, function in NMDevice +nm_device_get_dhcp6_config, function in NMDevice
-nm_device_get_driver, function in NMDevice +nm_device_get_driver, function in NMDevice
-nm_device_get_driver_version, function in NMDevice +nm_device_get_driver_version, function in NMDevice
-nm_device_get_firmware_missing, function in NMDevice +nm_device_get_firmware_missing, function in NMDevice
-nm_device_get_firmware_version, function in NMDevice +nm_device_get_firmware_version, function in NMDevice
-nm_device_get_hw_address, function in NMDevice +nm_device_get_hw_address, function in NMDevice
-nm_device_get_iface, function in NMDevice +nm_device_get_iface, function in NMDevice
-nm_device_get_ip4_config, function in NMDevice +nm_device_get_ip4_config, function in NMDevice
-nm_device_get_ip6_config, function in NMDevice +nm_device_get_ip6_config, function in NMDevice
-nm_device_get_ip_iface, function in NMDevice +nm_device_get_ip_iface, function in NMDevice
-nm_device_get_managed, function in NMDevice +nm_device_get_managed, function in NMDevice
-nm_device_get_mtu, function in NMDevice +nm_device_get_mtu, function in NMDevice
-nm_device_get_physical_port_id, function in NMDevice +nm_device_get_physical_port_id, function in NMDevice
-nm_device_get_product, function in NMDevice +nm_device_get_product, function in NMDevice
-nm_device_get_setting_type, function in NMDevice +nm_device_get_setting_type, function in NMDevice
-nm_device_get_state, function in NMDevice +nm_device_get_state, function in NMDevice
-nm_device_get_state_reason, function in NMDevice +nm_device_get_state_reason, function in NMDevice
-nm_device_get_type_description, function in NMDevice +nm_device_get_type_description, function in NMDevice
-nm_device_get_udi, function in NMDevice +nm_device_get_udi, function in NMDevice
-nm_device_get_vendor, function in NMDevice +nm_device_get_vendor, function in NMDevice
@@ -1555,15 +1414,15 @@
-nm_device_infiniband_error_quark, function in NMDeviceInfiniband +nm_device_infiniband_error_quark, function in NMDeviceInfiniband
-nm_device_infiniband_get_carrier, function in NMDeviceInfiniband +nm_device_infiniband_get_carrier, function in NMDeviceInfiniband
-nm_device_infiniband_get_hw_address, function in NMDeviceInfiniband +nm_device_infiniband_get_hw_address, function in NMDeviceInfiniband
@@ -1571,7 +1430,7 @@
-nm_device_infiniband_new, function in NMDeviceInfiniband +nm_device_infiniband_new, function in NMDeviceInfiniband
@@ -1591,7 +1450,7 @@
-nm_device_is_software, function in NMDevice +nm_device_is_software, function in NMDevice
@@ -1607,15 +1466,15 @@
-nm_device_modem_error_quark, function in NMDeviceModem +nm_device_modem_error_quark, function in NMDeviceModem
-nm_device_modem_get_current_capabilities, function in NMDeviceModem +nm_device_modem_get_current_capabilities, function in NMDeviceModem
-nm_device_modem_get_modem_capabilities, function in NMDeviceModem +nm_device_modem_get_modem_capabilities, function in NMDeviceModem
@@ -1627,7 +1486,7 @@
-nm_device_new, function in NMDevice +nm_device_new, function in NMDevice
@@ -1643,19 +1502,19 @@
-nm_device_olpc_mesh_error_quark, function in NMDeviceOlpcMesh +nm_device_olpc_mesh_error_quark, function in NMDeviceOlpcMesh
-nm_device_olpc_mesh_get_active_channel, function in NMDeviceOlpcMesh +nm_device_olpc_mesh_get_active_channel, function in NMDeviceOlpcMesh
-nm_device_olpc_mesh_get_companion, function in NMDeviceOlpcMesh +nm_device_olpc_mesh_get_companion, function in NMDeviceOlpcMesh
-nm_device_olpc_mesh_get_hw_address, function in NMDeviceOlpcMesh +nm_device_olpc_mesh_get_hw_address, function in NMDeviceOlpcMesh
@@ -1663,7 +1522,7 @@
-nm_device_olpc_mesh_new, function in NMDeviceOlpcMesh +nm_device_olpc_mesh_new, function in NMDeviceOlpcMesh
@@ -1675,7 +1534,7 @@
-nm_device_set_autoconnect, function in NMDevice +nm_device_set_autoconnect, function in NMDevice
@@ -1695,19 +1554,19 @@
-nm_device_team_error_quark, function in NMDeviceTeam +nm_device_team_error_quark, function in NMDeviceTeam
-nm_device_team_get_carrier, function in NMDeviceTeam +nm_device_team_get_carrier, function in NMDeviceTeam
-nm_device_team_get_hw_address, function in NMDeviceTeam +nm_device_team_get_hw_address, function in NMDeviceTeam
-nm_device_team_get_slaves, function in NMDeviceTeam +nm_device_team_get_slaves, function in NMDeviceTeam
@@ -1715,7 +1574,7 @@
-nm_device_team_new, function in NMDeviceTeam +nm_device_team_new, function in NMDeviceTeam
@@ -1739,23 +1598,23 @@
-nm_device_vlan_error_quark, function in NMDeviceVlan +nm_device_vlan_error_quark, function in NMDeviceVlan
-nm_device_vlan_get_carrier, function in NMDeviceVlan +nm_device_vlan_get_carrier, function in NMDeviceVlan
-nm_device_vlan_get_hw_address, function in NMDeviceVlan +nm_device_vlan_get_hw_address, function in NMDeviceVlan
-nm_device_vlan_get_parent, function in NMDeviceVlan +nm_device_vlan_get_parent, function in NMDeviceVlan
-nm_device_vlan_get_vlan_id, function in NMDeviceVlan +nm_device_vlan_get_vlan_id, function in NMDeviceVlan
@@ -1763,7 +1622,7 @@
-nm_device_vlan_new, function in NMDeviceVlan +nm_device_vlan_new, function in NMDeviceVlan
@@ -1795,39 +1654,39 @@
-nm_device_wifi_error_quark, function in NMDeviceWifi +nm_device_wifi_error_quark, function in NMDeviceWifi
-nm_device_wifi_get_access_points, function in NMDeviceWifi +nm_device_wifi_get_access_points, function in NMDeviceWifi
-nm_device_wifi_get_access_point_by_path, function in NMDeviceWifi +nm_device_wifi_get_access_point_by_path, function in NMDeviceWifi
-nm_device_wifi_get_active_access_point, function in NMDeviceWifi +nm_device_wifi_get_active_access_point, function in NMDeviceWifi
-nm_device_wifi_get_bitrate, function in NMDeviceWifi +nm_device_wifi_get_bitrate, function in NMDeviceWifi
-nm_device_wifi_get_capabilities, function in NMDeviceWifi +nm_device_wifi_get_capabilities, function in NMDeviceWifi
-nm_device_wifi_get_hw_address, function in NMDeviceWifi +nm_device_wifi_get_hw_address, function in NMDeviceWifi
-nm_device_wifi_get_mode, function in NMDeviceWifi +nm_device_wifi_get_mode, function in NMDeviceWifi
-nm_device_wifi_get_permanent_hw_address, function in NMDeviceWifi +nm_device_wifi_get_permanent_hw_address, function in NMDeviceWifi
@@ -1839,7 +1698,7 @@
-nm_device_wifi_new, function in NMDeviceWifi +nm_device_wifi_new, function in NMDeviceWifi
@@ -1847,7 +1706,7 @@
-nm_device_wifi_request_scan_simple, function in NMDeviceWifi +nm_device_wifi_request_scan_simple, function in NMDeviceWifi
@@ -1871,43 +1730,43 @@
-nm_device_wimax_error_quark, function in NMDeviceWimax +nm_device_wimax_error_quark, function in NMDeviceWimax
-nm_device_wimax_get_active_nsp, function in NMDeviceWimax +nm_device_wimax_get_active_nsp, function in NMDeviceWimax
-nm_device_wimax_get_bsid, function in NMDeviceWimax +nm_device_wimax_get_bsid, function in NMDeviceWimax
-nm_device_wimax_get_center_frequency, function in NMDeviceWimax +nm_device_wimax_get_center_frequency, function in NMDeviceWimax
-nm_device_wimax_get_cinr, function in NMDeviceWimax +nm_device_wimax_get_cinr, function in NMDeviceWimax
-nm_device_wimax_get_hw_address, function in NMDeviceWimax +nm_device_wimax_get_hw_address, function in NMDeviceWimax
-nm_device_wimax_get_nsps, function in NMDeviceWimax +nm_device_wimax_get_nsps, function in NMDeviceWimax
-nm_device_wimax_get_nsp_by_path, function in NMDeviceWimax +nm_device_wimax_get_nsp_by_path, function in NMDeviceWimax
-nm_device_wimax_get_rssi, function in NMDeviceWimax +nm_device_wimax_get_rssi, function in NMDeviceWimax
-nm_device_wimax_get_tx_power, function in NMDeviceWimax +nm_device_wimax_get_tx_power, function in NMDeviceWimax
@@ -1915,7 +1774,7 @@
-nm_device_wimax_new, function in NMDeviceWimax +nm_device_wimax_new, function in NMDeviceWimax
@@ -1931,27 +1790,19 @@
-NMDHCP4Config, struct in NMDHCP4Config +NMDHCP4Config:options, object property in NMDHCP4Config
-NMDHCP4Config:options, object property in NMDHCP4Config +nm_dhcp4_config_get_one_option, function in NMDHCP4Config
-NMDHCP4ConfigClass, struct in NMDHCP4Config +nm_dhcp4_config_get_options, function in NMDHCP4Config
-nm_dhcp4_config_get_one_option, function in NMDHCP4Config -
-
-
-nm_dhcp4_config_get_options, function in NMDHCP4Config -
-
-
-nm_dhcp4_config_new, function in NMDHCP4Config +nm_dhcp4_config_new, function in NMDHCP4Config
@@ -1959,27 +1810,19 @@
-NMDHCP6Config, struct in NMDHCP6Config -
-
-
-NMDHCP6Config:options, object property in NMDHCP6Config -
-
-
-NMDHCP6ConfigClass, struct in NMDHCP6Config +NMDHCP6Config:options, object property in NMDHCP6Config
-nm_dhcp6_config_get_one_option, function in NMDHCP6Config +nm_dhcp6_config_get_one_option, function in NMDHCP6Config
-nm_dhcp6_config_get_options, function in NMDHCP6Config +nm_dhcp6_config_get_options, function in NMDHCP6Config
-nm_dhcp6_config_new, function in NMDHCP6Config +nm_dhcp6_config_new, function in NMDHCP6Config
@@ -1988,39 +1831,31 @@

I

-NMIP4Config, struct in NMIP4Config -
-
-
-NMIP4Config:addresses, object property in NMIP4Config -
-
-
-NMIP4Config:domains, object property in NMIP4Config +NMIP4Config:addresses, object property in NMIP4Config
-NMIP4Config:gateway, object property in NMIP4Config +NMIP4Config:domains, object property in NMIP4Config
-NMIP4Config:nameservers, object property in NMIP4Config +NMIP4Config:gateway, object property in NMIP4Config
-NMIP4Config:routes, object property in NMIP4Config +NMIP4Config:nameservers, object property in NMIP4Config
-NMIP4Config:searches, object property in NMIP4Config +NMIP4Config:routes, object property in NMIP4Config
-NMIP4Config:wins-servers, object property in NMIP4Config +NMIP4Config:searches, object property in NMIP4Config
-NMIP4ConfigClass, struct in NMIP4Config +NMIP4Config:wins-servers, object property in NMIP4Config
@@ -2036,31 +1871,31 @@
-nm_ip4_config_get_addresses, function in NMIP4Config +nm_ip4_config_get_addresses, function in NMIP4Config
-nm_ip4_config_get_domains, function in NMIP4Config +nm_ip4_config_get_domains, function in NMIP4Config
-nm_ip4_config_get_gateway, function in NMIP4Config +nm_ip4_config_get_gateway, function in NMIP4Config
-nm_ip4_config_get_nameservers, function in NMIP4Config +nm_ip4_config_get_nameservers, function in NMIP4Config
-nm_ip4_config_get_routes, function in NMIP4Config +nm_ip4_config_get_routes, function in NMIP4Config
-nm_ip4_config_get_searches, function in NMIP4Config +nm_ip4_config_get_searches, function in NMIP4Config
-nm_ip4_config_get_wins_servers, function in NMIP4Config +nm_ip4_config_get_wins_servers, function in NMIP4Config
@@ -2068,7 +1903,7 @@
-nm_ip4_config_new, function in NMIP4Config +nm_ip4_config_new, function in NMIP4Config
@@ -2084,35 +1919,27 @@
-NMIP6Config, struct in NMIP6Config +NMIP6Config:addresses, object property in NMIP6Config
-NMIP6Config:addresses, object property in NMIP6Config +NMIP6Config:domains, object property in NMIP6Config
-NMIP6Config:domains, object property in NMIP6Config +NMIP6Config:gateway, object property in NMIP6Config
-NMIP6Config:gateway, object property in NMIP6Config +NMIP6Config:nameservers, object property in NMIP6Config
-NMIP6Config:nameservers, object property in NMIP6Config +NMIP6Config:routes, object property in NMIP6Config
-NMIP6Config:routes, object property in NMIP6Config -
-
-
-NMIP6Config:searches, object property in NMIP6Config -
-
-
-NMIP6ConfigClass, struct in NMIP6Config +NMIP6Config:searches, object property in NMIP6Config
@@ -2128,35 +1955,35 @@
-nm_ip6_config_get_addresses, function in NMIP6Config +nm_ip6_config_get_addresses, function in NMIP6Config
-nm_ip6_config_get_domains, function in NMIP6Config +nm_ip6_config_get_domains, function in NMIP6Config
-nm_ip6_config_get_gateway, function in NMIP6Config +nm_ip6_config_get_gateway, function in NMIP6Config
-nm_ip6_config_get_nameserver, function in NMIP6Config +nm_ip6_config_get_nameserver, function in NMIP6Config
-nm_ip6_config_get_nameservers, function in NMIP6Config +nm_ip6_config_get_nameservers, function in NMIP6Config
-nm_ip6_config_get_num_nameservers, function in NMIP6Config +nm_ip6_config_get_num_nameservers, function in NMIP6Config
-nm_ip6_config_get_routes, function in NMIP6Config +nm_ip6_config_get_routes, function in NMIP6Config
-nm_ip6_config_get_searches, function in NMIP6Config +nm_ip6_config_get_searches, function in NMIP6Config
@@ -2164,7 +1991,7 @@
-nm_ip6_config_new, function in NMIP6Config +nm_ip6_config_new, function in NMIP6Config
@@ -2177,23 +2004,15 @@

O

-NMObject, struct in NMObject +NMObject::object-creation-failed, object signal in NMObject
-NMObject::object-creation-failed, object signal in NMObject +NMObject:dbus-connection, object property in NMObject
-NMObject:dbus-connection, object property in NMObject -
-
-
-NMObject:dbus-path, object property in NMObject -
-
-
-NMObjectClass, struct in NMObject +NMObject:dbus-path, object property in NMObject
@@ -2213,52 +2032,44 @@
-nm_object_error_quark, function in NMObject +nm_object_error_quark, function in NMObject
-nm_object_get_connection, function in NMObject +nm_object_get_connection, function in NMObject
-nm_object_get_path, function in NMObject +nm_object_get_path, function in NMObject

R

-NMRemoteConnection, struct in NMRemoteConnection -
-
-
-NMRemoteConnection::removed, object signal in NMRemoteConnection +NMRemoteConnection::removed, object signal in NMRemoteConnection
-NMRemoteConnection::updated, object signal in NMRemoteConnection +NMRemoteConnection::updated, object signal in NMRemoteConnection
-NMRemoteConnection::visible, object signal in NMRemoteConnection +NMRemoteConnection::visible, object signal in NMRemoteConnection
-NMRemoteConnection:bus, object property in NMRemoteConnection +NMRemoteConnection:bus, object property in NMRemoteConnection
-NMRemoteConnection:dbus-connection, object property in NMRemoteConnection +NMRemoteConnection:dbus-connection, object property in NMRemoteConnection
-NMRemoteConnection:dbus-path, object property in NMRemoteConnection +NMRemoteConnection:dbus-path, object property in NMRemoteConnection
-NMRemoteConnection:unsaved, object property in NMRemoteConnection -
-
-
-NMRemoteConnectionClass, struct in NMRemoteConnection +NMRemoteConnection:unsaved, object property in NMRemoteConnection
@@ -2274,47 +2085,39 @@
-NMRemoteConnectionGetSecretsFunc, user_function in NMRemoteConnection -
-
-
-NMRemoteConnectionResultFunc, user_function in NMRemoteConnection -
-
-
-NMRemoteSettings, struct in NMRemoteSettings +NMRemoteConnectionGetSecretsFunc, user_function in NMRemoteConnection
-NMRemoteSettings::connections-read, object signal in NMRemoteSettings +NMRemoteConnectionResultFunc, user_function in NMRemoteConnection
-NMRemoteSettings::new-connection, object signal in NMRemoteSettings +NMRemoteSettings::connections-read, object signal in NMRemoteSettings
-NMRemoteSettings:bus, object property in NMRemoteSettings +NMRemoteSettings::new-connection, object signal in NMRemoteSettings
-NMRemoteSettings:can-modify, object property in NMRemoteSettings +NMRemoteSettings:bus, object property in NMRemoteSettings
-NMRemoteSettings:hostname, object property in NMRemoteSettings +NMRemoteSettings:can-modify, object property in NMRemoteSettings
-NMRemoteSettings:service-running, object property in NMRemoteSettings +NMRemoteSettings:hostname, object property in NMRemoteSettings
-NMRemoteSettingsAddConnectionFunc, user_function in NMRemoteSettings +NMRemoteSettings:service-running, object property in NMRemoteSettings
-NMRemoteSettingsClass, struct in NMRemoteSettings +NMRemoteSettingsAddConnectionFunc, user_function in NMRemoteSettings
@@ -2322,23 +2125,23 @@
-NMRemoteSettingsLoadConnectionsFunc, user_function in NMRemoteSettings +NMRemoteSettingsLoadConnectionsFunc, user_function in NMRemoteSettings
-NMRemoteSettingsSaveHostnameFunc, user_function in NMRemoteSettings +NMRemoteSettingsSaveHostnameFunc, user_function in NMRemoteSettings
-nm_remote_connection_commit_changes, function in NMRemoteConnection +nm_remote_connection_commit_changes, function in NMRemoteConnection
-nm_remote_connection_commit_changes_unsaved, function in NMRemoteConnection +nm_remote_connection_commit_changes_unsaved, function in NMRemoteConnection
-nm_remote_connection_delete, function in NMRemoteConnection +nm_remote_connection_delete, function in NMRemoteConnection
@@ -2346,19 +2149,19 @@
-nm_remote_connection_error_quark, function in NMRemoteConnection +nm_remote_connection_error_quark, function in NMRemoteConnection
-nm_remote_connection_get_secrets, function in NMRemoteConnection +nm_remote_connection_get_secrets, function in NMRemoteConnection
-nm_remote_connection_get_unsaved, function in NMRemoteConnection +nm_remote_connection_get_unsaved, function in NMRemoteConnection
-nm_remote_connection_new, function in NMRemoteConnection +nm_remote_connection_new, function in NMRemoteConnection
@@ -2366,7 +2169,7 @@
-nm_remote_connection_save, function in NMRemoteConnection +nm_remote_connection_save, function in NMRemoteConnection
@@ -2378,11 +2181,11 @@
-nm_remote_settings_add_connection, function in NMRemoteSettings +nm_remote_settings_add_connection, function in NMRemoteSettings
-nm_remote_settings_add_connection_unsaved, function in NMRemoteSettings +nm_remote_settings_add_connection_unsaved, function in NMRemoteSettings
@@ -2402,19 +2205,19 @@
-nm_remote_settings_error_quark, function in NMRemoteSettings +nm_remote_settings_error_quark, function in NMRemoteSettings
-nm_remote_settings_get_connection_by_id, function in NMRemoteSettings +nm_remote_settings_get_connection_by_id, function in NMRemoteSettings
-nm_remote_settings_get_connection_by_path, function in NMRemoteSettings +nm_remote_settings_get_connection_by_path, function in NMRemoteSettings
-nm_remote_settings_get_connection_by_uuid, function in NMRemoteSettings +nm_remote_settings_get_connection_by_uuid, function in NMRemoteSettings
@@ -2422,19 +2225,19 @@
-nm_remote_settings_list_connections, function in NMRemoteSettings +nm_remote_settings_list_connections, function in NMRemoteSettings
-nm_remote_settings_load_connections, function in NMRemoteSettings +nm_remote_settings_load_connections, function in NMRemoteSettings
-nm_remote_settings_new, function in NMRemoteSettings +nm_remote_settings_new, function in NMRemoteSettings
-nm_remote_settings_new_async, function in NMRemoteSettings +nm_remote_settings_new_async, function in NMRemoteSettings
@@ -2442,15 +2245,15 @@
-nm_remote_settings_new_finish, function in NMRemoteSettings +nm_remote_settings_new_finish, function in NMRemoteSettings
-nm_remote_settings_reload_connections, function in NMRemoteSettings +nm_remote_settings_reload_connections, function in NMRemoteSettings
-nm_remote_settings_save_hostname, function in NMRemoteSettings +nm_remote_settings_save_hostname, function in NMRemoteSettings
@@ -2459,27 +2262,23 @@

S

-NMSecretAgent, struct in NMSecretAgent -
-
-
-NMSecretAgent::registration-result, object signal in NMSecretAgent +NMSecretAgent::registration-result, object signal in NMSecretAgent
-NMSecretAgent:auto-register, object property in NMSecretAgent +NMSecretAgent:auto-register, object property in NMSecretAgent
-NMSecretAgent:capabilities, object property in NMSecretAgent +NMSecretAgent:capabilities, object property in NMSecretAgent
-NMSecretAgent:identifier, object property in NMSecretAgent +NMSecretAgent:identifier, object property in NMSecretAgent
-NMSecretAgent:registered, object property in NMSecretAgent +NMSecretAgent:registered, object property in NMSecretAgent
@@ -2487,11 +2286,7 @@
-NMSecretAgentClass, struct in NMSecretAgent -
-
-
-NMSecretAgentDeleteSecretsFunc, user_function in NMSecretAgent +NMSecretAgentDeleteSecretsFunc, user_function in NMSecretAgent
@@ -2503,11 +2298,11 @@
-NMSecretAgentGetSecretsFunc, user_function in NMSecretAgent +NMSecretAgentGetSecretsFunc, user_function in NMSecretAgent
-NMSecretAgentSaveSecretsFunc, user_function in NMSecretAgent +NMSecretAgentSaveSecretsFunc, user_function in NMSecretAgent
@@ -2519,7 +2314,7 @@
-nm_secret_agent_delete_secrets, function in NMSecretAgent +nm_secret_agent_delete_secrets, function in NMSecretAgent
@@ -2527,15 +2322,15 @@
-nm_secret_agent_error_quark, function in NMSecretAgent +nm_secret_agent_error_quark, function in NMSecretAgent
-nm_secret_agent_get_registered, function in NMSecretAgent +nm_secret_agent_get_registered, function in NMSecretAgent
-nm_secret_agent_get_secrets, function in NMSecretAgent +nm_secret_agent_get_secrets, function in NMSecretAgent
@@ -2543,7 +2338,7 @@
-nm_secret_agent_register, function in NMSecretAgent +nm_secret_agent_register, function in NMSecretAgent
@@ -2555,40 +2350,24 @@
-nm_secret_agent_save_secrets, function in NMSecretAgent +nm_secret_agent_save_secrets, function in NMSecretAgent
-nm_secret_agent_unregister, function in NMSecretAgent +nm_secret_agent_unregister, function in NMSecretAgent

V

-NMVPNConnection, struct in NMVPNConnection -
-
-
-NMVPNConnection::vpn-state-changed, object signal in NMVPNConnection +NMVPNConnection::vpn-state-changed, object signal in NMVPNConnection
-NMVPNConnection:banner, object property in NMVPNConnection +NMVPNConnection:banner, object property in NMVPNConnection
-NMVPNConnection:vpn-state, object property in NMVPNConnection -
-
-
-NMVPNConnectionClass, struct in NMVPNConnection -
-
-
-NMVPNPlugin, struct in NMVPNPlugin -
-
-
-NMVPNPluginClass, struct in NMVPNPlugin +NMVPNConnection:vpn-state, object property in NMVPNConnection
@@ -2596,23 +2375,15 @@
-NMVpnPluginUiCapability, enum in NMVpnPluginUi +NMVpnPluginUiCapability, enum in NMVpnPluginUiWidget
-NMVpnPluginUiFactory, user_function in NMVpnPluginUi +NMVpnPluginUiFactory, user_function in NMVpnPluginUiWidget
-NMVpnPluginUiInterface, struct in NMVpnPluginUi -
-
-
-NMVpnPluginUiInterfaceProp, enum in NMVpnPluginUi -
-
-
-NMVpnPluginUiWidgetInterface, struct in NMVpnPluginUi +NMVpnPluginUiInterfaceProp, enum in NMVpnPluginUiWidget
@@ -2620,15 +2391,15 @@
-nm_vpn_connection_get_banner, function in NMVPNConnection +nm_vpn_connection_get_banner, function in NMVPNConnection
-nm_vpn_connection_get_vpn_state, function in NMVPNConnection +nm_vpn_connection_get_vpn_state, function in NMVPNConnection
-nm_vpn_connection_new, function in NMVPNConnection +nm_vpn_connection_new, function in NMVPNConnection
@@ -2640,47 +2411,47 @@
-nm_vpn_plugin_disconnect, function in NMVPNPlugin +nm_vpn_plugin_disconnect, function in NMVPNPlugin
-nm_vpn_plugin_error_quark, function in NMVPNPlugin +nm_vpn_plugin_error_quark, function in NMVPNPlugin
-nm_vpn_plugin_failure, function in NMVPNPlugin +nm_vpn_plugin_failure, function in NMVPNPlugin
-nm_vpn_plugin_get_connection, function in NMVPNPlugin +nm_vpn_plugin_get_connection, function in NMVPNPlugin
-nm_vpn_plugin_get_state, function in NMVPNPlugin +nm_vpn_plugin_get_state, function in NMVPNPlugin
-nm_vpn_plugin_secrets_required, function in NMVPNPlugin +nm_vpn_plugin_secrets_required, function in NMVPNPlugin
-nm_vpn_plugin_set_config, function in NMVPNPlugin +nm_vpn_plugin_set_config, function in NMVPNPlugin
-nm_vpn_plugin_set_ip4_config, function in NMVPNPlugin +nm_vpn_plugin_set_ip4_config, function in NMVPNPlugin
-nm_vpn_plugin_set_ip6_config, function in NMVPNPlugin +nm_vpn_plugin_set_ip6_config, function in NMVPNPlugin
-nm_vpn_plugin_set_login_banner, function in NMVPNPlugin +nm_vpn_plugin_set_login_banner, function in NMVPNPlugin
-nm_vpn_plugin_set_state, function in NMVPNPlugin +nm_vpn_plugin_set_state, function in NMVPNPlugin
@@ -2688,84 +2459,76 @@
-nm_vpn_plugin_ui_factory, function in NMVpnPluginUi +nm_vpn_plugin_ui_factory, function in NMVpnPluginUiWidget
-nm_vpn_plugin_ui_interface_delete_connection, function in NMVpnPluginUi +nm_vpn_plugin_ui_interface_delete_connection, function in NMVpnPluginUiWidget
-NM_VPN_PLUGIN_UI_INTERFACE_DESC, macro in NMVpnPluginUi +NM_VPN_PLUGIN_UI_INTERFACE_DESC, macro in NMVpnPluginUiWidget
-nm_vpn_plugin_ui_interface_export, function in NMVpnPluginUi +nm_vpn_plugin_ui_interface_export, function in NMVpnPluginUiWidget
-nm_vpn_plugin_ui_interface_get_capabilities, function in NMVpnPluginUi +nm_vpn_plugin_ui_interface_get_capabilities, function in NMVpnPluginUiWidget
-nm_vpn_plugin_ui_interface_get_suggested_name, function in NMVpnPluginUi +nm_vpn_plugin_ui_interface_get_suggested_name, function in NMVpnPluginUiWidget
-nm_vpn_plugin_ui_interface_import, function in NMVpnPluginUi +nm_vpn_plugin_ui_interface_import, function in NMVpnPluginUiWidget
-NM_VPN_PLUGIN_UI_INTERFACE_NAME, macro in NMVpnPluginUi +NM_VPN_PLUGIN_UI_INTERFACE_NAME, macro in NMVpnPluginUiWidget
-NM_VPN_PLUGIN_UI_INTERFACE_SERVICE, macro in NMVpnPluginUi +NM_VPN_PLUGIN_UI_INTERFACE_SERVICE, macro in NMVpnPluginUiWidget
-nm_vpn_plugin_ui_interface_ui_factory, function in NMVpnPluginUi +nm_vpn_plugin_ui_interface_ui_factory, function in NMVpnPluginUiWidget
-nm_vpn_plugin_ui_widget_interface_get_widget, function in NMVpnPluginUi +nm_vpn_plugin_ui_widget_interface_get_widget, function in NMVpnPluginUiWidget
-nm_vpn_plugin_ui_widget_interface_save_secrets, function in NMVpnPluginUi +nm_vpn_plugin_ui_widget_interface_save_secrets, function in NMVpnPluginUiWidget
-nm_vpn_plugin_ui_widget_interface_update_connection, function in NMVpnPluginUi +nm_vpn_plugin_ui_widget_interface_update_connection, function in NMVpnPluginUiWidget
-nm_vpn_plugin_utils_get_secret_flags, function in nm-vpn-plugin-utils +nm_vpn_plugin_utils_get_secret_flags, function in nm-vpn-plugin-utils
-nm_vpn_plugin_utils_read_vpn_details, function in nm-vpn-plugin-utils +nm_vpn_plugin_utils_read_vpn_details, function in nm-vpn-plugin-utils

W

-NMWimaxNsp, struct in NMWimaxNsp -
-
-
-NMWimaxNsp:name, object property in NMWimaxNsp -
-
-
-NMWimaxNsp:network-type, object property in NMWimaxNsp +NMWimaxNsp:name, object property in NMWimaxNsp
-NMWimaxNsp:signal-quality, object property in NMWimaxNsp +NMWimaxNsp:network-type, object property in NMWimaxNsp
-NMWimaxNspClass, struct in NMWimaxNsp +NMWimaxNsp:signal-quality, object property in NMWimaxNsp
@@ -2773,23 +2536,23 @@
-nm_wimax_nsp_connection_valid, function in NMWimaxNsp +nm_wimax_nsp_connection_valid, function in NMWimaxNsp
-nm_wimax_nsp_filter_connections, function in NMWimaxNsp +nm_wimax_nsp_filter_connections, function in NMWimaxNsp
-nm_wimax_nsp_get_name, function in NMWimaxNsp +nm_wimax_nsp_get_name, function in NMWimaxNsp
-nm_wimax_nsp_get_network_type, function in NMWimaxNsp +nm_wimax_nsp_get_network_type, function in NMWimaxNsp
-nm_wimax_nsp_get_signal_quality, function in NMWimaxNsp +nm_wimax_nsp_get_signal_quality, function in NMWimaxNsp
@@ -2801,7 +2564,7 @@
-nm_wimax_nsp_new, function in NMWimaxNsp +nm_wimax_nsp_new, function in NMWimaxNsp
@@ -2811,6 +2574,6 @@
+ Generated by GTK-Doc V1.21 \ No newline at end of file diff --git a/docs/libnm-glib/html/ch02.html b/docs/libnm-glib/html/ch02.html index c730745b..80d259a7 100644 --- a/docs/libnm-glib/html/ch02.html +++ b/docs/libnm-glib/html/ch02.html @@ -2,22 +2,22 @@ -libnm-glib API Reference +libnm-glib Reference Manual: libnm-glib API Reference - + - - - - - - + + + + + +

@@ -111,7 +111,7 @@ NMVPNPlugin
-NMVpnPluginUi +NMVpnPluginUiWidget
nm-vpn-plugin-utils @@ -120,6 +120,6 @@

+ Generated by GTK-Doc V1.21
\ No newline at end of file diff --git a/docs/libnm-glib/html/home.png b/docs/libnm-glib/html/home.png index 17003611..9346b336 100644 Binary files a/docs/libnm-glib/html/home.png and b/docs/libnm-glib/html/home.png differ diff --git a/docs/libnm-glib/html/index.html b/docs/libnm-glib/html/index.html index 9434f44e..fb5c1c38 100644 --- a/docs/libnm-glib/html/index.html +++ b/docs/libnm-glib/html/index.html @@ -2,11 +2,11 @@ -libnm-glib Reference Manual +libnm-glib Reference Manual: libnm-glib Reference Manual - + @@ -15,7 +15,7 @@

- for libnm-glib 1.0.0 + for libnm-glib 1.0.2 The latest version of this documentation can be found on-line at https://developer.gnome.org/libnm-glib/0.9/. @@ -138,7 +138,7 @@ NMVPNPlugin

-NMVpnPluginUi +NMVpnPluginUiWidget
nm-vpn-plugin-utils @@ -151,6 +151,6 @@
+ Generated by GTK-Doc V1.21
\ No newline at end of file diff --git a/docs/libnm-glib/html/index.sgml b/docs/libnm-glib/html/index.sgml index 4dca87c8..7e412917 100644 --- a/docs/libnm-glib/html/index.sgml +++ b/docs/libnm-glib/html/index.sgml @@ -1,54 +1,13 @@ - - - + + + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + - - @@ -86,6 +45,27 @@ + + + + + + + + + + + + + + + + + + + + + @@ -108,29 +88,12 @@ - - - + + + - - - - - - - - - - - - - - - - - - + @@ -147,6 +110,22 @@ + + + + + + + + + + + + + + + + @@ -164,43 +143,14 @@ - - - + + + - - - - - + - - - - - - - - - - - - - - - - - - - - - - - - - @@ -239,6 +189,32 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + @@ -266,63 +242,39 @@ - - - + + + - - - - - - - - + - - - - - - + + + + + + + - - - + + + - - - - - - - - - - + - - - - - - - - - @@ -334,6 +286,16 @@ + + + + + + + + + + @@ -346,83 +308,54 @@ - - - + + + - + + + + + - - - - - - - - - - - - + + + - - - - - - - - - + - - - - - + + + + + + - - - + + + - - - - - - - - + - - - - - - - - - - @@ -433,6 +366,17 @@ + + + + + + + + + + + @@ -446,257 +390,200 @@ - - - + + + - - - - - - + - - - + + + + - - - + + + - - - - - - - + - - - - - + + + + + + - - - + + + - - - - - - - + - - - - - + + + + + + - - - + + + - - - - - - - + - - - - - + + + + + + - - - + + + - + + + + + - - - - - - - - - - - + + + - - - - - - - - + - - - - + + + + + - - - + + + - - - - - - - - - + - - - - - - + + + + + + + - - - + + + - - - - - - + - - - - - + + + + + + - - - + + + - - - - - - - - - - - + + + + + + - - - + + + - - - - - - - - - - - - - + @@ -710,6 +597,17 @@ + + + + + + + + + + + @@ -722,21 +620,12 @@ - - - + + + - - - - - - - - - - + @@ -745,6 +634,14 @@ + + + + + + + + @@ -754,20 +651,12 @@ - - - + + + - - - - - - - - - + @@ -777,6 +666,13 @@ + + + + + + + @@ -785,80 +681,65 @@ - - - + + + - - - - + + + - - - + + + - - - - + + + - - - + + + - + + + + + - - - - - - - - - - + + + - - - - + - - - - - - - @@ -867,6 +748,13 @@ + + + + + + + @@ -877,31 +765,17 @@ - - - + + + - - - - - - - + - - - - - - - - @@ -914,6 +788,15 @@ + + + + + + + + + @@ -924,50 +807,37 @@ - - + + - - + + + - + - - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + @@ -976,44 +846,29 @@ - - - + + + - - - - - + + + + - + + - - - - - - - - - - - - - - - - + @@ -1025,42 +880,39 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + + + + - + - + + @@ -1070,4 +922,3 @@ - diff --git a/docs/libnm-glib/html/left-insensitive.png b/docs/libnm-glib/html/left-insensitive.png new file mode 100644 index 00000000..3269393a Binary files /dev/null and b/docs/libnm-glib/html/left-insensitive.png differ diff --git a/docs/libnm-glib/html/left.png b/docs/libnm-glib/html/left.png index 2d05b3d5..2abde032 100644 Binary files a/docs/libnm-glib/html/left.png and b/docs/libnm-glib/html/left.png differ diff --git a/docs/libnm-glib/html/libnm-glib-NMVPNPlugin.html b/docs/libnm-glib/html/libnm-glib-NMVPNPlugin.html index 2b71816b..b64ade5b 100644 --- a/docs/libnm-glib/html/libnm-glib-NMVPNPlugin.html +++ b/docs/libnm-glib/html/libnm-glib-NMVPNPlugin.html @@ -2,30 +2,26 @@ -NMVPNPlugin +libnm-glib Reference Manual: NMVPNPlugin - - + + - - - - - - - - - - + + + + + + +
@@ -33,334 +29,401 @@

NMVPNPlugin

NMVPNPlugin

- +
-
-

Synopsis

-
#define             NM_VPN_PLUGIN_DBUS_SERVICE_NAME
-#define             NM_VPN_PLUGIN_STATE
-enum                NMVPNPluginError;
-                    NMVPNPlugin;
-                    NMVPNPluginClass;
-GQuark              nm_vpn_plugin_error_quark           (void);
-DBusGConnection *   nm_vpn_plugin_get_connection        (NMVPNPlugin *plugin);
-NMVPNServiceState   nm_vpn_plugin_get_state             (NMVPNPlugin *plugin);
-void                nm_vpn_plugin_set_state             (NMVPNPlugin *plugin,
-                                                         NMVPNServiceState state);
-void                nm_vpn_plugin_secrets_required      (NMVPNPlugin *plugin,
-                                                         const char *message,
-                                                         const char **hints);
-void                nm_vpn_plugin_set_login_banner      (NMVPNPlugin *plugin,
-                                                         const char *banner);
-void                nm_vpn_plugin_failure               (NMVPNPlugin *plugin,
-                                                         NMVPNPluginFailure reason);
-void                nm_vpn_plugin_set_config            (NMVPNPlugin *plugin,
-                                                         GHashTable *config);
-void                nm_vpn_plugin_set_ip4_config        (NMVPNPlugin *plugin,
-                                                         GHashTable *ip4_config);
-void                nm_vpn_plugin_set_ip6_config        (NMVPNPlugin *plugin,
-                                                         GHashTable *ip6_config);
-gboolean            nm_vpn_plugin_disconnect            (NMVPNPlugin *plugin,
-                                                         GError **err);
-
-
-
-

Description

-

-

-
-

Details

-
-

NM_VPN_PLUGIN_DBUS_SERVICE_NAME

-
#define NM_VPN_PLUGIN_DBUS_SERVICE_NAME "service-name"
-
-

-

-
-
-
-

NM_VPN_PLUGIN_STATE

-
#define NM_VPN_PLUGIN_STATE             "state"
-
-

-

-
-
-
-

enum NMVPNPluginError

-
typedef enum {
-	NM_VPN_PLUGIN_ERROR_GENERAL,                   /*< nick=General >*/
-	NM_VPN_PLUGIN_ERROR_STARTING_IN_PROGRESS,      /*< nick=StartingInProgress >*/
-	NM_VPN_PLUGIN_ERROR_ALREADY_STARTED,           /*< nick=AlreadyStarted >*/
-	NM_VPN_PLUGIN_ERROR_STOPPING_IN_PROGRESS,      /*< nick=StoppingInProgress >*/
-	NM_VPN_PLUGIN_ERROR_ALREADY_STOPPED,           /*< nick=AlreadyStopped >*/
-	NM_VPN_PLUGIN_ERROR_WRONG_STATE,               /*< nick=WrongState >*/
-	NM_VPN_PLUGIN_ERROR_BAD_ARGUMENTS,             /*< nick=BadArguments >*/
-	NM_VPN_PLUGIN_ERROR_LAUNCH_FAILED,             /*< nick=LaunchFailed >*/
-	NM_VPN_PLUGIN_ERROR_CONNECTION_INVALID,        /*< nick=ConnectionInvalid >*/
-	NM_VPN_PLUGIN_ERROR_INTERACTIVE_NOT_SUPPORTED  /*< nick=InteractiveNotSupported >*/
-} NMVPNPluginError;
-
-

-Returned by the VPN service plugin to indicate errors. -

-
+

Functions

+
--++ - - + - - + - - + - - + - - + - - + - - + - - + - - + - - + + + + +

NM_VPN_PLUGIN_ERROR_GENERAL

general failure + +GQuark + +nm_vpn_plugin_error_quark ()

NM_VPN_PLUGIN_ERROR_STARTING_IN_PROGRESS

the plugin is already starting, - and another connect request was received + +DBusGConnection * + +nm_vpn_plugin_get_connection ()

NM_VPN_PLUGIN_ERROR_ALREADY_STARTED

the plugin is already connected, and - another connect request was received + +NMVPNServiceState + +nm_vpn_plugin_get_state ()

NM_VPN_PLUGIN_ERROR_STOPPING_IN_PROGRESS

the plugin is already stopping, - and another stop request was received + +void + +nm_vpn_plugin_set_state ()

NM_VPN_PLUGIN_ERROR_ALREADY_STOPPED

the plugin is already stopped, and - another disconnect request was received + +void + +nm_vpn_plugin_secrets_required ()

NM_VPN_PLUGIN_ERROR_WRONG_STATE

the operation could not be performed in - this state + +void + +nm_vpn_plugin_set_login_banner ()

NM_VPN_PLUGIN_ERROR_BAD_ARGUMENTS

the operation could not be performed as - the request contained malformed arguments, or arguments of unexpected type. - Usually means that one of the VPN setting data items or secrets was not of - the expected type (ie int, string, bool, etc). + +void + +nm_vpn_plugin_failure ()

NM_VPN_PLUGIN_ERROR_LAUNCH_FAILED

a child process failed to launch + +void + +nm_vpn_plugin_set_config ()

NM_VPN_PLUGIN_ERROR_CONNECTION_INVALID

the operation could not be performed - because the connection was invalid. Usually means that the connection's - VPN setting was missing some required data item or secret. + +void + +nm_vpn_plugin_set_ip4_config ()

NM_VPN_PLUGIN_ERROR_INTERACTIVE_NOT_SUPPORTED

the operation could not be - performed as the plugin does not support interactive operations, such as - ConnectInteractive() or NewSecrets() + +void + +nm_vpn_plugin_set_ip6_config () +
+gboolean + +nm_vpn_plugin_disconnect ()
-
-
-

NMVPNPlugin

-
typedef struct {
-	GObject parent;
-} NMVPNPlugin;
-
-

-

+
+

Types and Values

+
++++ + + + + + + + + + + + + + + +
#defineNM_VPN_PLUGIN_DBUS_SERVICE_NAME
#defineNM_VPN_PLUGIN_STATE
enumNMVPNPluginError
-
-
-

NMVPNPluginClass

-
typedef struct {
-	GObjectClass parent;
-
-	/* virtual methods */
-	gboolean (*connect)      (NMVPNPlugin   *plugin,
-	                          NMConnection  *connection,
-	                          GError       **err);
-
-	gboolean (*need_secrets) (NMVPNPlugin *plugin,
-	                          NMConnection *connection,
-	                          char **setting_name,
-	                          GError **error);
-
-	gboolean (*disconnect)   (NMVPNPlugin   *plugin,
-	                          GError       **err);
-
-	/* Signals */
-	void (*state_changed)  (NMVPNPlugin *plugin,
-	                        NMVPNServiceState state);
-
-	void (*ip4_config)     (NMVPNPlugin *plugin,
-	                        GHashTable  *ip4_config);
-
-	void (*login_banner)   (NMVPNPlugin *plugin,
-	                        const char *banner);
-
-	void (*failure)        (NMVPNPlugin *plugin,
-	                        NMVPNPluginFailure reason);
-
-	void (*quit)           (NMVPNPlugin *plugin);
-
-	void (*config)         (NMVPNPlugin *plugin,
-	                        GHashTable  *config);
-
-	void (*ip6_config)     (NMVPNPlugin *plugin,
-	                        GHashTable  *config);
-
-	/* more methods */
-	gboolean (*new_secrets)  (NMVPNPlugin *plugin,
-	                          NMConnection *connection,
-	                          GError **error);
-
-	gboolean (*connect_interactive) (NMVPNPlugin *plugin,
-	                                 NMConnection *connection,
-	                                 GHashTable *details,
-	                                 GError **error);
-
-	/* Padding for future expansion */
-	void (*_reserved1) (void);
-	void (*_reserved2) (void);
-} NMVPNPluginClass;
-
+
+

Description

-
+
+

Functions

-

nm_vpn_plugin_error_quark ()

-
GQuark              nm_vpn_plugin_error_quark           (void);
+

nm_vpn_plugin_error_quark ()

+
GQuark
+nm_vpn_plugin_error_quark (void);

+
+

Returns

+

+

-

nm_vpn_plugin_get_connection ()

-
DBusGConnection *   nm_vpn_plugin_get_connection        (NMVPNPlugin *plugin);
+

nm_vpn_plugin_get_connection ()

+
DBusGConnection *
+nm_vpn_plugin_get_connection (NMVPNPlugin *plugin);

+
+

Returns

+

+

-

nm_vpn_plugin_get_state ()

-
NMVPNServiceState   nm_vpn_plugin_get_state             (NMVPNPlugin *plugin);
+

nm_vpn_plugin_get_state ()

+
NMVPNServiceState
+nm_vpn_plugin_get_state (NMVPNPlugin *plugin);

+
+

Returns

+

+

-

nm_vpn_plugin_set_state ()

-
void                nm_vpn_plugin_set_state             (NMVPNPlugin *plugin,
-                                                         NMVPNServiceState state);
+

nm_vpn_plugin_set_state ()

+
void
+nm_vpn_plugin_set_state (NMVPNPlugin *plugin,
+                         NMVPNServiceState state);


-

nm_vpn_plugin_secrets_required ()

-
void                nm_vpn_plugin_secrets_required      (NMVPNPlugin *plugin,
-                                                         const char *message,
-                                                         const char **hints);
-

-Called by VPN plugin implementations to signal to NetworkManager that secrets +

nm_vpn_plugin_secrets_required ()

+
void
+nm_vpn_plugin_secrets_required (NMVPNPlugin *plugin,
+                                const char *message,
+                                const char **hints);
+

Called by VPN plugin implementations to signal to NetworkManager that secrets are required during the connection process. This signal may be used to request new secrets when the secrets originally provided by NetworkManager are insufficient, or the VPN process indicates that it needs additional -information to complete the request. -

-
+information to complete the request.

+
+

Parameters

+
--+++ - - + + + - - + + + - - + + +

plugin :

the NMVPNPlugin -

plugin

the NMVPNPlugin

 

message :

an information message about why secrets are required, if any

message

an information message about why secrets are required, if any

 

hints :

VPN specific secret names for required new secrets

hints

VPN specific secret names for required new secrets

 
+

Since 0.9.10


-

nm_vpn_plugin_set_login_banner ()

-
void                nm_vpn_plugin_set_login_banner      (NMVPNPlugin *plugin,
-                                                         const char *banner);
+

nm_vpn_plugin_set_login_banner ()

+
void
+nm_vpn_plugin_set_login_banner (NMVPNPlugin *plugin,
+                                const char *banner);


-

nm_vpn_plugin_failure ()

-
void                nm_vpn_plugin_failure               (NMVPNPlugin *plugin,
-                                                         NMVPNPluginFailure reason);
+

nm_vpn_plugin_failure ()

+
void
+nm_vpn_plugin_failure (NMVPNPlugin *plugin,
+                       NMVPNPluginFailure reason);


-

nm_vpn_plugin_set_config ()

-
void                nm_vpn_plugin_set_config            (NMVPNPlugin *plugin,
-                                                         GHashTable *config);
+

nm_vpn_plugin_set_config ()

+
void
+nm_vpn_plugin_set_config (NMVPNPlugin *plugin,
+                          GHashTable *config);


-

nm_vpn_plugin_set_ip4_config ()

-
void                nm_vpn_plugin_set_ip4_config        (NMVPNPlugin *plugin,
-                                                         GHashTable *ip4_config);
+

nm_vpn_plugin_set_ip4_config ()

+
void
+nm_vpn_plugin_set_ip4_config (NMVPNPlugin *plugin,
+                              GHashTable *ip4_config);


-

nm_vpn_plugin_set_ip6_config ()

-
void                nm_vpn_plugin_set_ip6_config        (NMVPNPlugin *plugin,
-                                                         GHashTable *ip6_config);
+

nm_vpn_plugin_set_ip6_config ()

+
void
+nm_vpn_plugin_set_ip6_config (NMVPNPlugin *plugin,
+                              GHashTable *ip6_config);


-

nm_vpn_plugin_disconnect ()

-
gboolean            nm_vpn_plugin_disconnect            (NMVPNPlugin *plugin,
-                                                         GError **err);
+

nm_vpn_plugin_disconnect ()

+
gboolean
+nm_vpn_plugin_disconnect (NMVPNPlugin *plugin,
+                          GError **err);
+

+

+
+

Returns

+

+
+
+
+
+

Types and Values

+
+

NM_VPN_PLUGIN_DBUS_SERVICE_NAME

+
#define NM_VPN_PLUGIN_DBUS_SERVICE_NAME "service-name"
+

+
+
+

NM_VPN_PLUGIN_STATE

+
#define NM_VPN_PLUGIN_STATE             "state"
+
+

+

+
+
+
+

enum NMVPNPluginError

+

Returned by the VPN service plugin to indicate errors.

+
+

Members

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

NM_VPN_PLUGIN_ERROR_GENERAL

+

general failure

+
 

NM_VPN_PLUGIN_ERROR_STARTING_IN_PROGRESS

+

the plugin is already starting, + and another connect request was received

+
 

NM_VPN_PLUGIN_ERROR_ALREADY_STARTED

+

the plugin is already connected, and + another connect request was received

+
 

NM_VPN_PLUGIN_ERROR_STOPPING_IN_PROGRESS

+

the plugin is already stopping, + and another stop request was received

+
 

NM_VPN_PLUGIN_ERROR_ALREADY_STOPPED

+

the plugin is already stopped, and + another disconnect request was received

+
 

NM_VPN_PLUGIN_ERROR_WRONG_STATE

+

the operation could not be performed in + this state

+
 

NM_VPN_PLUGIN_ERROR_BAD_ARGUMENTS

+

the operation could not be performed as + the request contained malformed arguments, or arguments of unexpected type. + Usually means that one of the VPN setting data items or secrets was not of + the expected type (ie int, string, bool, etc).

+
 

NM_VPN_PLUGIN_ERROR_LAUNCH_FAILED

+

a child process failed to launch

+
 

NM_VPN_PLUGIN_ERROR_CONNECTION_INVALID

+

the operation could not be performed + because the connection was invalid. Usually means that the connection's + VPN setting was missing some required data item or secret.

+
 

NM_VPN_PLUGIN_ERROR_INTERACTIVE_NOT_SUPPORTED

+

the operation could not be + performed as the plugin does not support interactive operations, such as + ConnectInteractive() or NewSecrets()

+
 
+
+
+ Generated by GTK-Doc V1.21
\ No newline at end of file diff --git a/docs/libnm-glib/html/libnm-glib-NMVpnPluginUi.html b/docs/libnm-glib/html/libnm-glib-NMVpnPluginUi.html deleted file mode 100644 index 44ec7e14..00000000 --- a/docs/libnm-glib/html/libnm-glib-NMVpnPluginUi.html +++ /dev/null @@ -1,397 +0,0 @@ - - - - -NMVpnPluginUi - - - - - - - - - - - - - - - - - - - -
-
-
- - -
-

NMVpnPluginUi

-

NMVpnPluginUi

-
-
-

Synopsis

-
NMVpnPluginUiInterface * (*NMVpnPluginUiFactory)        (GError **error);
-NMVpnPluginUiInterface * nm_vpn_plugin_ui_factory       (GError **error);
-enum                NMVpnPluginUiCapability;
-#define             NM_VPN_PLUGIN_UI_INTERFACE_NAME
-#define             NM_VPN_PLUGIN_UI_INTERFACE_DESC
-#define             NM_VPN_PLUGIN_UI_INTERFACE_SERVICE
-enum                NMVpnPluginUiInterfaceProp;
-struct              NMVpnPluginUiInterface;
-NMVpnPluginUiWidgetInterface * nm_vpn_plugin_ui_interface_ui_factory
-                                                        (NMVpnPluginUiInterface *iface,
-                                                         NMConnection *connection,
-                                                         GError **error);
-guint32             nm_vpn_plugin_ui_interface_get_capabilities
-                                                        (NMVpnPluginUiInterface *iface);
-NMConnection *      nm_vpn_plugin_ui_interface_import   (NMVpnPluginUiInterface *iface,
-                                                         const char *path,
-                                                         GError **error);
-gboolean            nm_vpn_plugin_ui_interface_export   (NMVpnPluginUiInterface *iface,
-                                                         const char *path,
-                                                         NMConnection *connection,
-                                                         GError **error);
-char *              nm_vpn_plugin_ui_interface_get_suggested_name
-                                                        (NMVpnPluginUiInterface *iface,
-                                                         NMConnection *connection);
-gboolean            nm_vpn_plugin_ui_interface_delete_connection
-                                                        (NMVpnPluginUiInterface *iface,
-                                                         NMConnection *connection,
-                                                         GError **error);
-struct              NMVpnPluginUiWidgetInterface;
-GObject *           nm_vpn_plugin_ui_widget_interface_get_widget
-                                                        (NMVpnPluginUiWidgetInterface *iface);
-gboolean            nm_vpn_plugin_ui_widget_interface_update_connection
-                                                        (NMVpnPluginUiWidgetInterface *iface,
-                                                         NMConnection *connection,
-                                                         GError **error);
-gboolean            nm_vpn_plugin_ui_widget_interface_save_secrets
-                                                        (NMVpnPluginUiWidgetInterface *iface,
-                                                         NMConnection *connection,
-                                                         GError **error);
-
-
-
-

Description

-

-

-
-
-

Details

-
-

NMVpnPluginUiFactory ()

-
NMVpnPluginUiInterface * (*NMVpnPluginUiFactory)        (GError **error);
-

-

-
-
-
-

nm_vpn_plugin_ui_factory ()

-
NMVpnPluginUiInterface * nm_vpn_plugin_ui_factory       (GError **error);
-

-

-
-
-
-

enum NMVpnPluginUiCapability

-
typedef enum {
-	NM_VPN_PLUGIN_UI_CAPABILITY_NONE   = 0x00,
-	NM_VPN_PLUGIN_UI_CAPABILITY_IMPORT = 0x01,
-	NM_VPN_PLUGIN_UI_CAPABILITY_EXPORT = 0x02,
-	NM_VPN_PLUGIN_UI_CAPABILITY_IPV6   = 0x04
-} NMVpnPluginUiCapability;
-
-

-Flags that indicate to UI programs certain capabilities of the plugin. -

-
---- - - - - - - - - - - - - - - - - - - -

NM_VPN_PLUGIN_UI_CAPABILITY_NONE

unknown or no capability -

NM_VPN_PLUGIN_UI_CAPABILITY_IMPORT

the plugin can import new connections -

NM_VPN_PLUGIN_UI_CAPABILITY_EXPORT

the plugin can export connections -

NM_VPN_PLUGIN_UI_CAPABILITY_IPV6

the plugin supports IPv6 addressing -
-
-
-
-

NM_VPN_PLUGIN_UI_INTERFACE_NAME

-
#define NM_VPN_PLUGIN_UI_INTERFACE_NAME "name"
-
-

-

-
-
-
-

NM_VPN_PLUGIN_UI_INTERFACE_DESC

-
#define NM_VPN_PLUGIN_UI_INTERFACE_DESC "desc"
-
-

-

-
-
-
-

NM_VPN_PLUGIN_UI_INTERFACE_SERVICE

-
#define NM_VPN_PLUGIN_UI_INTERFACE_SERVICE "service"
-
-

-

-
-
-
-

enum NMVpnPluginUiInterfaceProp

-
typedef enum {
-	/* private */
-	NM_VPN_PLUGIN_UI_INTERFACE_PROP_FIRST = 0x1000,
-
-	/* public */
-	NM_VPN_PLUGIN_UI_INTERFACE_PROP_NAME = NM_VPN_PLUGIN_UI_INTERFACE_PROP_FIRST,
-	NM_VPN_PLUGIN_UI_INTERFACE_PROP_DESC,
-	NM_VPN_PLUGIN_UI_INTERFACE_PROP_SERVICE
-} NMVpnPluginUiInterfaceProp;
-
-

-GObject property numbers that plugins should override to provide certain -information to UI programs. -

-
---- - - - - - - - - - - - - - - - - - - -

NM_VPN_PLUGIN_UI_INTERFACE_PROP_FIRST

-

NM_VPN_PLUGIN_UI_INTERFACE_PROP_NAME

the VPN plugin's name -

NM_VPN_PLUGIN_UI_INTERFACE_PROP_DESC

description of the VPN plugin and what -VPN services it supports -

NM_VPN_PLUGIN_UI_INTERFACE_PROP_SERVICE

the D-Bus service name used by the -plugin's VPN service daemon -
-
-
-
-

struct NMVpnPluginUiInterface

-
struct NMVpnPluginUiInterface {
-	GTypeInterface g_iface;
-
-	/* Plugin's factory function that returns a GObject that implements
-	 * NMVpnPluginUiWidgetInterface, pre-filled with values from 'connection'
-	 * if non-NULL.
-	 */
-	NMVpnPluginUiWidgetInterface * (*ui_factory) (NMVpnPluginUiInterface *iface,
-	                                              NMConnection *connection,
-	                                              GError **error);
-
-	/* Plugin's capabiltity function that returns a bitmask of capabilities
-	 * described by NM_VPN_PLUGIN_UI_CAPABILITY_* defines.
-	 */
-	guint32 (*get_capabilities) (NMVpnPluginUiInterface *iface);
-
-	/* Try to import a connection from the specified path.  On success, return a
-	 * partial NMConnection object.  On error, return NULL and set 'error' with
-	 * additional information.  Note that 'error' can be NULL, in which case no
-	 * additional error information should be provided.
-	 */
-	NMConnection * (*import_from_file) (NMVpnPluginUiInterface *iface,
-	                                    const char *path,
-	                                    GError **error);
-
-	/* Export the given connection to the specified path.  Return TRUE on success.
-	 * On error, return FALSE and set 'error' with additional error information.
-	 * Note that 'error' can be NULL, in which case no additional error information
-	 * should be provided.
-	 */
-	gboolean (*export_to_file) (NMVpnPluginUiInterface *iface,
-	                            const char *path,
-	                            NMConnection *connection,
-	                            GError **error);
-
-	/* For a given connection, return a suggested file name.  Returned value should
-	 * be NULL or a suggested file name allocated via g_malloc/g_new/etc to be freed
-	 * by the caller.
-	 */
-	char * (*get_suggested_name) (NMVpnPluginUiInterface *iface, NMConnection *connection);
-
-	/* Deprecated and no longer used */
-	gboolean (*delete_connection) (NMVpnPluginUiInterface *iface, NMConnection *connection, GError **error);
-
-	/* Padding for future expansion */
-	void (*_reserved1) (void);
-	void (*_reserved2) (void);
-	void (*_reserved3) (void);
-	void (*_reserved4) (void);
-	void (*_reserved5) (void);
-	void (*_reserved6) (void);
-};
-
-

-

-
-
-
-

nm_vpn_plugin_ui_interface_ui_factory ()

-
NMVpnPluginUiWidgetInterface * nm_vpn_plugin_ui_interface_ui_factory
-                                                        (NMVpnPluginUiInterface *iface,
-                                                         NMConnection *connection,
-                                                         GError **error);
-

-

-
-
-
-

nm_vpn_plugin_ui_interface_get_capabilities ()

-
guint32             nm_vpn_plugin_ui_interface_get_capabilities
-                                                        (NMVpnPluginUiInterface *iface);
-

-

-
-
-
-

nm_vpn_plugin_ui_interface_import ()

-
NMConnection *      nm_vpn_plugin_ui_interface_import   (NMVpnPluginUiInterface *iface,
-                                                         const char *path,
-                                                         GError **error);
-

-

-
-
-
-

nm_vpn_plugin_ui_interface_export ()

-
gboolean            nm_vpn_plugin_ui_interface_export   (NMVpnPluginUiInterface *iface,
-                                                         const char *path,
-                                                         NMConnection *connection,
-                                                         GError **error);
-

-

-
-
-
-

nm_vpn_plugin_ui_interface_get_suggested_name ()

-
char *              nm_vpn_plugin_ui_interface_get_suggested_name
-                                                        (NMVpnPluginUiInterface *iface,
-                                                         NMConnection *connection);
-

-

-
-
-
-

nm_vpn_plugin_ui_interface_delete_connection ()

-
gboolean            nm_vpn_plugin_ui_interface_delete_connection
-                                                        (NMVpnPluginUiInterface *iface,
-                                                         NMConnection *connection,
-                                                         GError **error);
-

-

-
-
-
-

struct NMVpnPluginUiWidgetInterface

-
struct NMVpnPluginUiWidgetInterface {
-	GTypeInterface g_iface;
-
-	/* Return the GtkWidget for the VPN's UI */
-	GObject * (*get_widget) (NMVpnPluginUiWidgetInterface *iface);
-
-	/* Called to save the user-entered options to the connection object.  Should
-	 * return FALSE and set 'error' if the current options are invalid.  'error'
-	 * should contain enough information for the plugin to determine which UI
-	 * widget is invalid at a later point in time.  For example, creating unique
-	 * error codes for what error occurred and populating the message field
-	 * of 'error' with the name of the invalid property.
-	 */
-	gboolean (*update_connection) (NMVpnPluginUiWidgetInterface *iface,
-	                               NMConnection *connection,
-	                               GError **error);
-
-	/* Deprecated and no longer used */
-	gboolean (*save_secrets) (NMVpnPluginUiWidgetInterface *iface,
-	                          NMConnection *connection,
-	                          GError **error);
-
-	/* Emitted when the value of a UI widget changes.  May trigger a validity
-	 * check via update_connection() to write values to the connection */
-	void (*changed) (NMVpnPluginUiWidgetInterface *iface);
-};
-
-

-

-
-
-
-

nm_vpn_plugin_ui_widget_interface_get_widget ()

-
GObject *           nm_vpn_plugin_ui_widget_interface_get_widget
-                                                        (NMVpnPluginUiWidgetInterface *iface);
-

-

-
-
-
-

nm_vpn_plugin_ui_widget_interface_update_connection ()

-
gboolean            nm_vpn_plugin_ui_widget_interface_update_connection
-                                                        (NMVpnPluginUiWidgetInterface *iface,
-                                                         NMConnection *connection,
-                                                         GError **error);
-

-

-
-
-
-

nm_vpn_plugin_ui_widget_interface_save_secrets ()

-
gboolean            nm_vpn_plugin_ui_widget_interface_save_secrets
-                                                        (NMVpnPluginUiWidgetInterface *iface,
-                                                         NMConnection *connection,
-                                                         GError **error);
-

-

-
-
-
- - - \ No newline at end of file diff --git a/docs/libnm-glib/html/libnm-glib-NMVpnPluginUiWidget.html b/docs/libnm-glib/html/libnm-glib-NMVpnPluginUiWidget.html new file mode 100644 index 00000000..95d75061 --- /dev/null +++ b/docs/libnm-glib/html/libnm-glib-NMVpnPluginUiWidget.html @@ -0,0 +1,447 @@ + + + + +libnm-glib Reference Manual: NMVpnPluginUiWidget + + + + + + + + + + + + + + + + +
+
+
+ + +
+

NMVpnPluginUiWidget

+

NMVpnPluginUiWidget

+
+
+

Functions

+
++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+NMVpnPluginUiInterface * + +(*NMVpnPluginUiFactory) () +
+NMVpnPluginUiInterface * + +nm_vpn_plugin_ui_factory () +
+NMVpnPluginUiWidgetInterface * + +nm_vpn_plugin_ui_interface_ui_factory () +
+guint32 + +nm_vpn_plugin_ui_interface_get_capabilities () +
+NMConnection * + +nm_vpn_plugin_ui_interface_import () +
+gboolean + +nm_vpn_plugin_ui_interface_export () +
+char * + +nm_vpn_plugin_ui_interface_get_suggested_name () +
+gboolean + +nm_vpn_plugin_ui_interface_delete_connection () +
+GObject * + +nm_vpn_plugin_ui_widget_interface_get_widget () +
+gboolean + +nm_vpn_plugin_ui_widget_interface_update_connection () +
+gboolean + +nm_vpn_plugin_ui_widget_interface_save_secrets () +
+
+
+

Types and Values

+ +
+
+

Description

+

+

+
+
+

Functions

+
+

NMVpnPluginUiFactory ()

+
NMVpnPluginUiInterface *
+(*NMVpnPluginUiFactory) (GError **error);
+

+

+
+

Returns

+

+
+
+
+
+

nm_vpn_plugin_ui_factory ()

+
NMVpnPluginUiInterface *
+nm_vpn_plugin_ui_factory (GError **error);
+

+

+
+

Returns

+

+
+
+
+
+

nm_vpn_plugin_ui_interface_ui_factory ()

+
NMVpnPluginUiWidgetInterface *
+nm_vpn_plugin_ui_interface_ui_factory (NMVpnPluginUiInterface *iface,
+                                       NMConnection *connection,
+                                       GError **error);
+

+

+
+

Returns

+

+
+
+
+
+

nm_vpn_plugin_ui_interface_get_capabilities ()

+
guint32
+nm_vpn_plugin_ui_interface_get_capabilities
+                               (NMVpnPluginUiInterface *iface);
+

+

+
+

Returns

+

+
+
+
+
+

nm_vpn_plugin_ui_interface_import ()

+
NMConnection *
+nm_vpn_plugin_ui_interface_import (NMVpnPluginUiInterface *iface,
+                                   const char *path,
+                                   GError **error);
+

+

+
+

Returns

+

+
+
+
+
+

nm_vpn_plugin_ui_interface_export ()

+
gboolean
+nm_vpn_plugin_ui_interface_export (NMVpnPluginUiInterface *iface,
+                                   const char *path,
+                                   NMConnection *connection,
+                                   GError **error);
+

+

+
+

Returns

+

+
+
+
+
+

nm_vpn_plugin_ui_interface_get_suggested_name ()

+
char *
+nm_vpn_plugin_ui_interface_get_suggested_name
+                               (NMVpnPluginUiInterface *iface,
+                                NMConnection *connection);
+

+

+
+

Returns

+

+
+
+
+
+

nm_vpn_plugin_ui_interface_delete_connection ()

+
gboolean
+nm_vpn_plugin_ui_interface_delete_connection
+                               (NMVpnPluginUiInterface *iface,
+                                NMConnection *connection,
+                                GError **error);
+

nm_vpn_plugin_ui_interface_delete_connection is deprecated and should not be used in newly-written code.

+

+

+
+

Returns

+

+
+
+
+
+

nm_vpn_plugin_ui_widget_interface_get_widget ()

+
GObject *
+nm_vpn_plugin_ui_widget_interface_get_widget
+                               (NMVpnPluginUiWidgetInterface *iface);
+

+

+
+

Returns

+

+
+
+
+
+

nm_vpn_plugin_ui_widget_interface_update_connection ()

+
gboolean
+nm_vpn_plugin_ui_widget_interface_update_connection
+                               (NMVpnPluginUiWidgetInterface *iface,
+                                NMConnection *connection,
+                                GError **error);
+

+

+
+

Returns

+

+
+
+
+
+

nm_vpn_plugin_ui_widget_interface_save_secrets ()

+
gboolean
+nm_vpn_plugin_ui_widget_interface_save_secrets
+                               (NMVpnPluginUiWidgetInterface *iface,
+                                NMConnection *connection,
+                                GError **error);
+

nm_vpn_plugin_ui_widget_interface_save_secrets is deprecated and should not be used in newly-written code.

+

+

+
+

Returns

+

+
+
+
+
+

Types and Values

+
+

enum NMVpnPluginUiCapability

+

Flags that indicate to UI programs certain capabilities of the plugin.

+
+

Members

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

NM_VPN_PLUGIN_UI_CAPABILITY_NONE

+

unknown or no capability

+
 

NM_VPN_PLUGIN_UI_CAPABILITY_IMPORT

+

the plugin can import new connections

+
 

NM_VPN_PLUGIN_UI_CAPABILITY_EXPORT

+

the plugin can export connections

+
 

NM_VPN_PLUGIN_UI_CAPABILITY_IPV6

+

the plugin supports IPv6 addressing

+
 
+
+
+
+
+

NM_VPN_PLUGIN_UI_INTERFACE_NAME

+
#define NM_VPN_PLUGIN_UI_INTERFACE_NAME "name"
+
+

+

+
+
+
+

NM_VPN_PLUGIN_UI_INTERFACE_DESC

+
#define NM_VPN_PLUGIN_UI_INTERFACE_DESC "desc"
+
+

+

+
+
+
+

NM_VPN_PLUGIN_UI_INTERFACE_SERVICE

+
#define NM_VPN_PLUGIN_UI_INTERFACE_SERVICE "service"
+
+

+

+
+
+
+

enum NMVpnPluginUiInterfaceProp

+

GObject property numbers that plugins should override to provide certain +information to UI programs.

+
+

Members

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

NM_VPN_PLUGIN_UI_INTERFACE_PROP_FIRST

  

NM_VPN_PLUGIN_UI_INTERFACE_PROP_NAME

+

the VPN plugin's name

+
 

NM_VPN_PLUGIN_UI_INTERFACE_PROP_DESC

+

description of the VPN plugin and what +VPN services it supports

+
 

NM_VPN_PLUGIN_UI_INTERFACE_PROP_SERVICE

+

the D-Bus service name used by the +plugin's VPN service daemon

+
 
+
+
+
+
+ + + \ No newline at end of file diff --git a/docs/libnm-glib/html/libnm-glib-nm-types.html b/docs/libnm-glib/html/libnm-glib-nm-types.html index 3793ddcd..c8ee10a3 100644 --- a/docs/libnm-glib/html/libnm-glib-nm-types.html +++ b/docs/libnm-glib/html/libnm-glib-nm-types.html @@ -2,30 +2,26 @@ -nm-types +libnm-glib Reference Manual: nm-types - + - - - - - - - - - - + + + + + + +
@@ -33,23 +29,22 @@

nm-types

nm-types

- +
-
-

Synopsis

-

-

Description

-

Details

+

Functions

+
+
+

Types and Values

+ Generated by GTK-Doc V1.21
\ No newline at end of file diff --git a/docs/libnm-glib/html/libnm-glib-nm-vpn-plugin-utils.html b/docs/libnm-glib/html/libnm-glib-nm-vpn-plugin-utils.html index 7a2098f6..0a53334e 100644 --- a/docs/libnm-glib/html/libnm-glib-nm-vpn-plugin-utils.html +++ b/docs/libnm-glib/html/libnm-glib-nm-vpn-plugin-utils.html @@ -2,30 +2,26 @@ -nm-vpn-plugin-utils +libnm-glib Reference Manual: nm-vpn-plugin-utils - + - + - - - - - - - - - - + + + + + + +
@@ -33,19 +29,34 @@

nm-vpn-plugin-utils

nm-vpn-plugin-utils

- +
-
-

Synopsis

-
gboolean            nm_vpn_plugin_utils_read_vpn_details
-                                                        (int fd,
-                                                         GHashTable **out_data,
-                                                         GHashTable **out_secrets);
-gboolean            nm_vpn_plugin_utils_get_secret_flags
-                                                        (GHashTable *data,
-                                                         const char *secret_name,
-                                                         NMSettingSecretFlags *out_flags);
-
+
+

Functions

+
++++ + + + + + + + + + + +
+gboolean + +nm_vpn_plugin_utils_read_vpn_details () +
+gboolean + +nm_vpn_plugin_utils_get_secret_flags () +

Description

@@ -53,91 +64,103 @@

-

Details

+

Functions

-

nm_vpn_plugin_utils_read_vpn_details ()

-
gboolean            nm_vpn_plugin_utils_read_vpn_details
-                                                        (int fd,
-                                                         GHashTable **out_data,
-                                                         GHashTable **out_secrets);
-

-Parses key/value pairs from a file descriptor (normally stdin) passed by -an applet when the applet calls the authentication dialog of the VPN plugin. -

-
+

nm_vpn_plugin_utils_read_vpn_details ()

+
gboolean
+nm_vpn_plugin_utils_read_vpn_details (int fd,
+                                      GHashTable **out_data,
+                                      GHashTable **out_secrets);
+

Parses key/value pairs from a file descriptor (normally stdin) passed by +an applet when the applet calls the authentication dialog of the VPN plugin.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + + - - + + +

fd :

file descriptor to read from, usually stdin (0)

out_data :

on successful return, a hash table -(mapping char*:char*) containing the key/value pairs of VPN data items. [out][transfer full] -

fd

file descriptor to read from, usually stdin (0)

 

out_secrets :

on successful return, a hash table -(mapping char*:char*) containing the key/value pairsof VPN secrets. [out][transfer full] -

out_data

on successful return, a hash table +(mapping char*:char*) containing the key/value pairs of VPN data items.

[out][transfer full]

Returns :

-TRUE if reading values was successful, FALSE if not

out_secrets

on successful return, a hash table +(mapping char*:char*) containing the key/value pairsof VPN secrets.

[out][transfer full]
+
+

Returns

+

TRUE if reading values was successful, FALSE if not

+

+
+

-

nm_vpn_plugin_utils_get_secret_flags ()

-
gboolean            nm_vpn_plugin_utils_get_secret_flags
-                                                        (GHashTable *data,
-                                                         const char *secret_name,
-                                                         NMSettingSecretFlags *out_flags);
-

-Given a VPN secret key name, attempts to find the corresponding flags data -item in data. If found, converts the flags data item to -NMSettingSecretFlags and returns it. -

-
+

nm_vpn_plugin_utils_get_secret_flags ()

+
gboolean
+nm_vpn_plugin_utils_get_secret_flags (GHashTable *data,
+                                      const char *secret_name,
+                                      NMSettingSecretFlags *out_flags);
+

Given a VPN secret key name, attempts to find the corresponding flags data +item in data +. If found, converts the flags data item to +NMSettingSecretFlags and returns it.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + + - - + + +

data :

hash table containing VPN key/value pair data items

secret_name :

VPN secret key name for which to retrieve flags for

data

hash table containing VPN key/value pair data items

 

out_flags :

on success, the flags associated with secret_name. [out] -

secret_name

VPN secret key name for which to retrieve flags for

 

Returns :

-TRUE if the flag data item was found and successfully converted -to flags, FALSE if not

out_flags

on success, the flags associated with secret_name +.

[out]
+
+

Returns

+

TRUE if the flag data item was found and successfully converted +to flags, FALSE if not

+

+
+
+
+
+

Types and Values

+ Generated by GTK-Doc V1.21
\ No newline at end of file diff --git a/docs/libnm-glib/html/libnm-glib.devhelp2 b/docs/libnm-glib/html/libnm-glib.devhelp2 index c9ec066a..8c4d8202 100644 --- a/docs/libnm-glib/html/libnm-glib.devhelp2 +++ b/docs/libnm-glib/html/libnm-glib.devhelp2 @@ -33,7 +33,7 @@ - + @@ -41,6 +41,44 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + @@ -61,65 +99,41 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + @@ -135,42 +149,62 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - @@ -194,91 +228,60 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - - - - - - - - - - - - + + + + + + + + + + + + + + + + - @@ -286,57 +289,50 @@ - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + - - - - - - - + + + + + + + - - - - - - - - - - + + + + + + + + + + + + + + - @@ -345,153 +341,136 @@ - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + - - - - - - + + + + + + - - - - - - - - - - + + + + + + + + - - - - - - - - - - + + + + + + + + - - - - - - - - - - + + + + + + - - - - - - - + + + + + + - - - - - - - - + + + + + + + + - - - - - - - - - - - - + + + + + + + + + - - - - - - - - - - + + + + + + + + + - - - - - - - - - - - + + + + + + + + + + + + + + + + @@ -502,33 +481,24 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + @@ -536,130 +506,119 @@ - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + - - - - - - - - - - - - - - - - - + + + + + + + + + - - - - - - + + + + - - - - + + + + - - - - - - - - - + + + - + + + + + + + + + + + - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + - - - - - - - - - - - - - - - - - - - - - - - - + + + + + + - + + + + + + + + + + @@ -668,190 +627,50 @@ - - - - - - - - - - - - - - - - + + + + + + + + - - - - - - - - + + + + + + + + + + + + + + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + diff --git a/docs/libnm-glib/html/object-tree.html b/docs/libnm-glib/html/object-tree.html index 3145ab15..500f78d4 100644 --- a/docs/libnm-glib/html/object-tree.html +++ b/docs/libnm-glib/html/object-tree.html @@ -2,60 +2,60 @@ -Object Hierarchy +libnm-glib Reference Manual: Object Hierarchy - + - - - - - - + + + + + +

Object Hierarchy

-    GObject
-        NMObject
-            NMClient
-            NMDevice
-                NMDeviceEthernet
-                NMDeviceWifi
-                NMDeviceModem
-                NMDeviceBt
-                NMDeviceWimax
-                NMDeviceOlpcMesh
-                NMDeviceAdsl
-                NMDeviceInfiniband
-                NMDeviceBond
-                NMDeviceBridge
-                NMDeviceTeam
-                NMDeviceGeneric
-                NMDeviceVlan
-            NMWimaxNsp
-            NMAccessPoint
-            NMIP4Config
-            NMIP6Config
-            NMActiveConnection
-                NMVPNConnection
-            NMDHCP4Config
-            NMDHCP6Config
-        NMRemoteSettings
-        NMConnection
-            NMRemoteConnection
-        NMSecretAgent
+    GObject
+    ├── NMObject
+       ├── NMClient
+       ├── NMDevice
+          ├── NMDeviceEthernet
+          ├── NMDeviceWifi
+          ├── NMDeviceModem
+          ├── NMDeviceBt
+          ├── NMDeviceWimax
+          ├── NMDeviceOlpcMesh
+          ├── NMDeviceAdsl
+          ├── NMDeviceInfiniband
+          ├── NMDeviceBond
+          ├── NMDeviceBridge
+          ├── NMDeviceTeam
+          ├── NMDeviceGeneric
+          ╰── NMDeviceVlan
+       ├── NMWimaxNsp
+       ├── NMAccessPoint
+       ├── NMIP4Config
+       ├── NMIP6Config
+       ├── NMActiveConnection
+          ╰── NMVPNConnection
+       ├── NMDHCP4Config
+       ╰── NMDHCP6Config
+    ├── NMRemoteSettings
+    ├── NMConnection
+       ╰── NMRemoteConnection
+    ╰── NMSecretAgent
 
+ Generated by GTK-Doc V1.21 \ No newline at end of file diff --git a/docs/libnm-glib/html/ref-overview.html b/docs/libnm-glib/html/ref-overview.html index 6dd6954c..d3a8c516 100644 --- a/docs/libnm-glib/html/ref-overview.html +++ b/docs/libnm-glib/html/ref-overview.html @@ -2,22 +2,22 @@ -Object Overview +libnm-glib Reference Manual: Object Overview - + - - - - - - + + + + + +

@@ -42,6 +42,6 @@

+ Generated by GTK-Doc V1.21
\ No newline at end of file diff --git a/docs/libnm-glib/html/right-insensitive.png b/docs/libnm-glib/html/right-insensitive.png new file mode 100644 index 00000000..4c95785b Binary files /dev/null and b/docs/libnm-glib/html/right-insensitive.png differ diff --git a/docs/libnm-glib/html/right.png b/docs/libnm-glib/html/right.png index 92832e3a..76260ec8 100644 Binary files a/docs/libnm-glib/html/right.png and b/docs/libnm-glib/html/right.png differ diff --git a/docs/libnm-glib/html/style.css b/docs/libnm-glib/html/style.css index d6f6c26e..c141ddd2 100644 --- a/docs/libnm-glib/html/style.css +++ b/docs/libnm-glib/html/style.css @@ -1,15 +1,23 @@ +body +{ + font-family: cantarell, sans-serif; +} .synopsis, .classsynopsis { /* tango:aluminium 1/2 */ background: #eeeeec; - border: solid 1px #d3d7cf; + background: rgba(238, 238, 236, 0.5); + border: solid 1px rgb(238, 238, 236); padding: 0.5em; } .programlisting { /* tango:sky blue 0/1 */ + /* fallback for no rgba support */ background: #e6f3ff; border: solid 1px #729fcf; + background: rgba(114, 159, 207, 0.1); + border: solid 1px rgba(114, 159, 207, 0.2); padding: 0.5em; } .variablelist @@ -22,89 +30,6 @@ vertical-align: top; } -@media screen { - sup a.footnote - { - position: relative; - top: 0em ! important; - - } - /* this is needed so that the local anchors are displayed below the naviagtion */ - div.footnote a[name], div.refnamediv a[name], div.refsect1 a[name], div.refsect2 a[name], div.index a[name], div.glossary a[name], div.sect1 a[name] - { - display: inline-block; - position: relative; - top:-5em; - } - /* this seems to be a bug in the xsl style sheets when generating indexes */ - div.index div.index - { - top: 0em; - } - /* make space for the fixed navigation bar and add space at the bottom so that - * link targets appear somewhat close to top - */ - body - { - padding-top: 3.2em; - padding-bottom: 20em; - } - /* style and size the navigation bar */ - table.navigation#top - { - position: fixed; - /* tango:scarlet red 0/1 */ - background: #ffe6e6; - border: solid 1px #ef2929; - margin-top: 0; - margin-bottom: 0; - top: 0; - left: 0; - height: 3em; - z-index: 10; - } - .navigation a, .navigation a:visited - { - /* tango:scarlet red 3 */ - color: #a40000; - } - .navigation a:hover - { - /* tango:scarlet red 1 */ - color: #ef2929; - } - td.shortcuts - { - /* tango:scarlet red 1 */ - color: #ef2929; - font-size: 80%; - white-space: nowrap; - } -} -@media print { - table.navigation { - visibility: collapse; - display: none; - } - div.titlepage table.navigation { - visibility: visible; - display: table; - /* tango:scarlet red 0/1 */ - background: #ffe6e6; - border: solid 1px #ef2929; - margin-top: 0; - margin-bottom: 0; - top: 0; - left: 0; - height: 3em; - } -} - -.navigation .title -{ - font-size: 200%; -} - div.gallery-float { float: left; @@ -132,6 +57,72 @@ a:hover color: #729fcf; } +div.informaltable table +{ + border-collapse: separate; + border-spacing: 1em 0.5em; + border: none; +} + +div.informaltable table td, div.informaltable table th +{ + vertical-align: top; +} + +.function_type, +.variable_type, +.property_type, +.signal_type, +.parameter_name, +.struct_member_name, +.union_member_name, +.define_keyword, +.datatype_keyword, +.typedef_keyword +{ + text-align: right; +} + +/* dim non-primary columns */ +.c_punctuation, +.function_type, +.variable_type, +.property_type, +.signal_type, +.define_keyword, +.datatype_keyword, +.typedef_keyword, +.property_flags, +.signal_flags, +.parameter_annotations, +.enum_member_annotations, +.struct_member_annotations, +.union_member_annotations +{ + color: #888a85; +} + +.function_type a, +.function_type a:visited, +.function_type a:hover, +.property_type a, +.property_type a:visited, +.property_type a:hover, +.signal_type a, +.signal_type a:visited, +.signal_type a:hover, +.signal_flags a, +.signal_flags a:visited, +.signal_flags a:hover +{ + color: #729fcf; +} + +td p +{ + margin: 0.25em; +} + div.table table { border-collapse: collapse; @@ -154,14 +145,43 @@ div.table table th background-color: #d3d7cf; } +h4 +{ + color: #555753; +} + hr { - /* tango:aluminium 3 */ - color: #babdb6; - background: #babdb6; + /* tango:aluminium 1 */ + color: #d3d7cf; + background: #d3d7cf; border: none 0px; height: 1px; clear: both; + margin: 2.0em 0em 2.0em 0em; +} + +dl.toc dt +{ + padding-bottom: 0.25em; +} + +dl.toc > dd > dl > dt +{ + padding-top: 0.25em; + padding-bottom: 0.25em; +} + +dl.toc > dt +{ + padding-top: 1em; + padding-bottom: 0.5em; + font-weight: bold; +} + +.parameter +{ + font-style: normal; } .footer @@ -173,31 +193,70 @@ hr font-size: 80%; } +.informalfigure, +.figure +{ + margin: 1em; +} + +.informalexample, +.example +{ + margin-top: 1em; + margin-bottom: 1em; +} + .warning { /* tango:orange 0/1 */ background: #ffeed9; + background: rgba(252, 175, 62, 0.1); border-color: #ffb04f; + border-color: rgba(252, 175, 62, 0.2); } .note { /* tango:chameleon 0/0.5 */ background: #d8ffb2; + background: rgba(138, 226, 52, 0.1); border-color: #abf562; + border-color: rgba(138, 226, 52, 0.2); } -.note, .warning +div.blockquote +{ + border-color: #eeeeec; +} +.note, .warning, div.blockquote { padding: 0.5em; border-width: 1px; border-style: solid; + margin: 2em; } -.note h3, .warning h3 +.note p, .warning p { - margin-top: 0.0em + margin: 0; } -.note p, .warning p + +div.warning h3.title, +div.note h3.title +{ + display: none; +} + +p + div.section { - margin-bottom: 0.0em + margin-top: 1em; +} + +div.refnamediv, +div.refsynopsisdiv, +div.refsect1, +div.refsect2, +div.toc, +div.section +{ + margin-bottom: 1em; } /* blob links */ @@ -210,33 +269,52 @@ h2 .extralinks, h3 .extralinks font-weight: normal; } +.lineart +{ + color: #d3d7cf; + font-weight: normal; +} + .annotation { /* tango:aluminium 5 */ color: #555753; - font-size: 80%; font-weight: normal; } +.structfield +{ + font-style: normal; + font-weight: normal; +} + +acronym,abbr +{ + border-bottom: 1px dotted gray; +} + /* code listings */ -.listing_code .programlisting .cbracket { color: #a40000; } /* tango: scarlet red 3 */ -.listing_code .programlisting .comment { color: #a1a39d; } /* tango: aluminium 4 */ -.listing_code .programlisting .function { color: #000000; font-weight: bold; } -.listing_code .programlisting .function a { color: #11326b; font-weight: bold; } /* tango: sky blue 4 */ -.listing_code .programlisting .keyword { color: #4e9a06; } /* tango: chameleon 3 */ +.listing_code .programlisting .normal, +.listing_code .programlisting .normal a, +.listing_code .programlisting .number, +.listing_code .programlisting .cbracket, +.listing_code .programlisting .symbol { color: #555753; } +.listing_code .programlisting .comment, .listing_code .programlisting .linenum { color: #babdb6; } /* tango: aluminium 3 */ -.listing_code .programlisting .normal { color: #000000; } -.listing_code .programlisting .number { color: #75507b; } /* tango: plum 2 */ +.listing_code .programlisting .function, +.listing_code .programlisting .function a, .listing_code .programlisting .preproc { color: #204a87; } /* tango: sky blue 3 */ -.listing_code .programlisting .string { color: #c17d11; } /* tango: chocolate 2 */ -.listing_code .programlisting .type { color: #000000; } -.listing_code .programlisting .type a { color: #11326b; } /* tango: sky blue 4 */ -.listing_code .programlisting .symbol { color: #ce5c00; } /* tango: orange 3 */ +.listing_code .programlisting .string { color: #ad7fa8; } /* tango: plum */ +.listing_code .programlisting .keyword, +.listing_code .programlisting .usertype, +.listing_code .programlisting .type, +.listing_code .programlisting .type a { color: #4e9a06; } /* tango: chameleon 3 */ .listing_frame { /* tango:sky blue 1 */ border: solid 1px #729fcf; + border: solid 1px rgba(114, 159, 207, 0.2); padding: 0px; } @@ -248,19 +326,151 @@ h2 .extralinks, h3 .extralinks .listing_lines { /* tango:sky blue 0.5 */ background: #a6c5e3; + background: rgba(114, 159, 207, 0.2); /* tango:aluminium 6 */ color: #2e3436; } .listing_code { /* tango:sky blue 0 */ background: #e6f3ff; + background: rgba(114, 159, 207, 0.1); } .listing_code .programlisting { /* override from previous */ border: none 0px; padding: 0px; + background: none; } .listing_lines pre, .listing_code pre { margin: 0px; } +@media screen { + sup a.footnote + { + position: relative; + top: 0em ! important; + } + /* this is needed so that the local anchors are displayed below the naviagtion */ + div.footnote a[name], div.refnamediv a[name], div.refsect1 a[name], div.refsect2 a[name], div.index a[name], div.glossary a[name], div.sect1 a[name] + { + display: inline-block; + position: relative; + top:-5em; + } + /* this seems to be a bug in the xsl style sheets when generating indexes */ + div.index div.index + { + top: 0em; + } + /* make space for the fixed navigation bar and add space at the bottom so that + * link targets appear somewhat close to top + */ + body + { + padding-top: 2.5em; + padding-bottom: 500px; + max-width: 60em; + } + p + { + max-width: 60em; + } + /* style and size the navigation bar */ + table.navigation#top + { + position: fixed; + background: #e2e2e2; + border-bottom: solid 1px #babdb6; + border-spacing: 5px; + margin-top: 0; + margin-bottom: 0; + top: 0; + left: 0; + z-index: 10; + } + table.navigation#top td + { + padding-left: 6px; + padding-right: 6px; + } + .navigation a, .navigation a:visited + { + /* tango:sky blue 3 */ + color: #204a87; + } + .navigation a:hover + { + /* tango:sky blue 2 */ + color: #3465a4; + } + td.shortcuts + { + /* tango:sky blue 2 */ + color: #3465a4; + font-size: 80%; + white-space: nowrap; + } + td.shortcuts .dim + { + color: #babdb6; + } + .navigation .title + { + font-size: 80%; + max-width: none; + margin: 0px; + font-weight: normal; + } +} +@media screen and (min-width: 60em) { + /* screen larger than 60em */ + body { margin: auto; } +} +@media screen and (max-width: 60em) { + /* screen less than 60em */ + #nav_hierarchy { display: none; } + #nav_interfaces { display: none; } + #nav_prerequisites { display: none; } + #nav_derived_interfaces { display: none; } + #nav_implementations { display: none; } + #nav_child_properties { display: none; } + #nav_style_properties { display: none; } + #nav_index { display: none; } + #nav_glossary { display: none; } + .gallery_image { display: none; } + .property_flags { display: none; } + .signal_flags { display: none; } + .parameter_annotations { display: none; } + .enum_member_annotations { display: none; } + .struct_member_annotations { display: none; } + .union_member_annotations { display: none; } + /* now that a column is hidden, optimize space */ + col.parameters_name { width: auto; } + col.parameters_description { width: auto; } + col.struct_members_name { width: auto; } + col.struct_members_description { width: auto; } + col.enum_members_name { width: auto; } + col.enum_members_description { width: auto; } + col.union_members_name { width: auto; } + col.union_members_description { width: auto; } + .listing_lines { display: none; } +} +@media print { + table.navigation { + visibility: collapse; + display: none; + } + div.titlepage table.navigation { + visibility: visible; + display: table; + background: #e2e2e2; + border: solid 1px #babdb6; + margin-top: 0; + margin-bottom: 0; + top: 0; + left: 0; + height: 3em; + } +} + diff --git a/docs/libnm-glib/html/up-insensitive.png b/docs/libnm-glib/html/up-insensitive.png new file mode 100644 index 00000000..f4049860 Binary files /dev/null and b/docs/libnm-glib/html/up-insensitive.png differ diff --git a/docs/libnm-glib/html/up.png b/docs/libnm-glib/html/up.png index 85b3e2a2..80b4b37e 100644 Binary files a/docs/libnm-glib/html/up.png and b/docs/libnm-glib/html/up.png differ diff --git a/docs/libnm-glib/libnm-glib-sections.txt b/docs/libnm-glib/libnm-glib-sections.txt index 571855eb..d21040d2 100644 --- a/docs/libnm-glib/libnm-glib-sections.txt +++ b/docs/libnm-glib/libnm-glib-sections.txt @@ -11,8 +11,6 @@ NM_ACCESS_POINT_MODE NM_ACCESS_POINT_MAX_BITRATE NM_ACCESS_POINT_STRENGTH NM_ACCESS_POINT_HW_ADDRESS -NMAccessPoint -NMAccessPointClass nm_access_point_new nm_access_point_get_flags nm_access_point_get_wpa_flags @@ -27,6 +25,8 @@ nm_access_point_filter_connections nm_access_point_connection_valid nm_access_point_get_hw_address +NMAccessPoint +NMAccessPointClass NM_ACCESS_POINT NM_ACCESS_POINT_CLASS NM_ACCESS_POINT_GET_CLASS @@ -54,8 +54,6 @@ NM_ACTIVE_CONNECTION_IP6_CONFIG NM_ACTIVE_CONNECTION_DHCP6_CONFIG NM_ACTIVE_CONNECTION_VPN NM_ACTIVE_CONNECTION_MASTER -NMActiveConnection -NMActiveConnectionClass nm_active_connection_new nm_active_connection_get_connection nm_active_connection_get_id @@ -73,6 +71,8 @@ nm_active_connection_get_ip6_config nm_active_connection_get_dhcp6_config nm_active_connection_get_vpn +NMActiveConnection +NMActiveConnectionClass NM_ACTIVE_CONNECTION NM_ACTIVE_CONNECTION_CLASS NM_ACTIVE_CONNECTION_GET_CLASS @@ -106,8 +106,6 @@ NMClientPermissionResult NMClientError NM_CLIENT_ERROR nm_client_error_quark -NMClient -NMClientClass nm_client_new nm_client_new_async nm_client_new_finish @@ -146,6 +144,8 @@ nm_client_check_connectivity_finish nm_client_get_primary_connection nm_client_get_activating_connection +NMClient +NMClientClass NM_CLIENT NM_CLIENT_CLASS NM_CLIENT_GET_CLASS @@ -184,8 +184,6 @@ NM_DEVICE_VENDOR NM_DEVICE_PRODUCT NM_DEVICE_PHYSICAL_PORT_ID NM_DEVICE_MTU -NMDevice -NMDeviceClass nm_device_new nm_device_get_iface nm_device_get_ip_iface @@ -225,6 +223,8 @@ nm_device_connection_compatible nm_device_get_setting_type NMDeviceDeactivateFn +NMDevice +NMDeviceClass NM_DEVICE NM_DEVICE_CLASS NM_DEVICE_GET_CLASS @@ -241,11 +241,11 @@ NMDeviceAdslError NM_DEVICE_ADSL_ERROR nm_device_adsl_error_quark NM_DEVICE_ADSL_CARRIER -NMDeviceAdsl -NMDeviceAdslClass nm_device_adsl_new nm_device_adsl_get_carrier +NMDeviceAdsl +NMDeviceAdslClass NM_DEVICE_ADSL NM_DEVICE_ADSL_CLASS NM_DEVICE_ADSL_GET_CLASS @@ -264,13 +264,13 @@ nm_device_bond_error_quark NM_DEVICE_BOND_HW_ADDRESS NM_DEVICE_BOND_CARRIER NM_DEVICE_BOND_SLAVES -NMDeviceBond -NMDeviceBondClass nm_device_bond_new nm_device_bond_get_hw_address nm_device_bond_get_carrier nm_device_bond_get_slaves +NMDeviceBond +NMDeviceBondClass NM_DEVICE_BOND NM_DEVICE_BOND_CLASS NM_DEVICE_BOND_GET_CLASS @@ -289,13 +289,13 @@ nm_device_bridge_error_quark NM_DEVICE_BRIDGE_HW_ADDRESS NM_DEVICE_BRIDGE_CARRIER NM_DEVICE_BRIDGE_SLAVES -NMDeviceBridge -NMDeviceBridgeClass nm_device_bridge_new nm_device_bridge_get_hw_address nm_device_bridge_get_carrier nm_device_bridge_get_slaves +NMDeviceBridge +NMDeviceBridgeClass NM_DEVICE_BRIDGE NM_DEVICE_BRIDGE_CLASS NM_DEVICE_BRIDGE_GET_CLASS @@ -314,13 +314,13 @@ nm_device_bt_error_quark NM_DEVICE_BT_HW_ADDRESS NM_DEVICE_BT_NAME NM_DEVICE_BT_CAPABILITIES -NMDeviceBt -NMDeviceBtClass nm_device_bt_new nm_device_bt_get_hw_address nm_device_bt_get_name nm_device_bt_get_capabilities +NMDeviceBt +NMDeviceBtClass NM_DEVICE_BT NM_DEVICE_BT_CLASS NM_DEVICE_BT_GET_CLASS @@ -340,14 +340,14 @@ NM_DEVICE_ETHERNET_HW_ADDRESS NM_DEVICE_ETHERNET_PERMANENT_HW_ADDRESS NM_DEVICE_ETHERNET_SPEED NM_DEVICE_ETHERNET_CARRIER -NMDeviceEthernet -NMDeviceEthernetClass nm_device_ethernet_new nm_device_ethernet_get_hw_address nm_device_ethernet_get_permanent_hw_address nm_device_ethernet_get_speed nm_device_ethernet_get_carrier +NMDeviceEthernet +NMDeviceEthernetClass NM_DEVICE_ETHERNET NM_DEVICE_ETHERNET_CLASS NM_DEVICE_ETHERNET_GET_CLASS @@ -365,11 +365,11 @@ NM_DEVICE_GENERIC_ERROR nm_device_generic_error_quark NM_DEVICE_GENERIC_HW_ADDRESS NM_DEVICE_GENERIC_TYPE_DESCRIPTION -NMDeviceGeneric -NMDeviceGenericClass nm_device_generic_new nm_device_generic_get_hw_address +NMDeviceGeneric +NMDeviceGenericClass NM_DEVICE_GENERIC NM_DEVICE_GENERIC_CLASS NM_DEVICE_GENERIC_GET_CLASS @@ -387,12 +387,12 @@ NM_DEVICE_INFINIBAND_ERROR nm_device_infiniband_error_quark NM_DEVICE_INFINIBAND_HW_ADDRESS NM_DEVICE_INFINIBAND_CARRIER -NMDeviceInfiniband -NMDeviceInfinibandClass nm_device_infiniband_new nm_device_infiniband_get_hw_address nm_device_infiniband_get_carrier +NMDeviceInfiniband +NMDeviceInfinibandClass NM_DEVICE_INFINIBAND NM_DEVICE_INFINIBAND_CLASS NM_DEVICE_INFINIBAND_GET_CLASS @@ -410,11 +410,11 @@ NM_DEVICE_MODEM_ERROR nm_device_modem_error_quark NM_DEVICE_MODEM_MODEM_CAPABILITIES NM_DEVICE_MODEM_CURRENT_CAPABILITIES -NMDeviceModem -NMDeviceModemClass nm_device_modem_get_modem_capabilities nm_device_modem_get_current_capabilities +NMDeviceModem +NMDeviceModemClass NM_DEVICE_MODEM NM_DEVICE_MODEM_CLASS NM_DEVICE_MODEM_GET_CLASS @@ -433,13 +433,13 @@ nm_device_olpc_mesh_error_quark NM_DEVICE_OLPC_MESH_HW_ADDRESS NM_DEVICE_OLPC_MESH_COMPANION NM_DEVICE_OLPC_MESH_ACTIVE_CHANNEL -NMDeviceOlpcMesh -NMDeviceOlpcMeshClass nm_device_olpc_mesh_new nm_device_olpc_mesh_get_hw_address nm_device_olpc_mesh_get_companion nm_device_olpc_mesh_get_active_channel +NMDeviceOlpcMesh +NMDeviceOlpcMeshClass NM_DEVICE_OLPC_MESH NM_DEVICE_OLPC_MESH_CLASS NM_DEVICE_OLPC_MESH_GET_CLASS @@ -458,13 +458,13 @@ nm_device_team_error_quark NM_DEVICE_TEAM_HW_ADDRESS NM_DEVICE_TEAM_CARRIER NM_DEVICE_TEAM_SLAVES -NMDeviceTeam -NMDeviceTeamClass nm_device_team_new nm_device_team_get_hw_address nm_device_team_get_carrier nm_device_team_get_slaves +NMDeviceTeam +NMDeviceTeamClass NM_DEVICE_TEAM NM_DEVICE_TEAM_CLASS NM_DEVICE_TEAM_GET_CLASS @@ -484,14 +484,14 @@ NM_DEVICE_VLAN_HW_ADDRESS NM_DEVICE_VLAN_CARRIER NM_DEVICE_VLAN_PARENT NM_DEVICE_VLAN_VLAN_ID -NMDeviceVlan -NMDeviceVlanClass nm_device_vlan_new nm_device_vlan_get_hw_address nm_device_vlan_get_carrier nm_device_vlan_get_parent nm_device_vlan_get_vlan_id +NMDeviceVlan +NMDeviceVlanClass NM_DEVICE_VLAN NM_DEVICE_VLAN_CLASS NM_DEVICE_VLAN_GET_CLASS @@ -514,8 +514,6 @@ NM_DEVICE_WIFI_BITRATE NM_DEVICE_WIFI_ACTIVE_ACCESS_POINT NM_DEVICE_WIFI_CAPABILITIES NM_DEVICE_WIFI_ACCESS_POINTS -NMDeviceWifi -NMDeviceWifiClass nm_device_wifi_new nm_device_wifi_get_hw_address nm_device_wifi_get_permanent_hw_address @@ -528,6 +526,8 @@ nm_device_wifi_get_access_points NMDeviceWifiRequestScanFn nm_device_wifi_request_scan_simple +NMDeviceWifi +NMDeviceWifiClass NM_DEVICE_WIFI NM_DEVICE_WIFI_CLASS NM_DEVICE_WIFI_GET_CLASS @@ -551,8 +551,6 @@ NM_DEVICE_WIMAX_CINR NM_DEVICE_WIMAX_TX_POWER NM_DEVICE_WIMAX_BSID NM_DEVICE_WIMAX_NSPS -NMDeviceWimax -NMDeviceWimaxClass nm_device_wimax_new nm_device_wimax_get_hw_address nm_device_wimax_get_active_nsp @@ -564,6 +562,8 @@ nm_device_wimax_get_cinr nm_device_wimax_get_tx_power nm_device_wimax_get_bsid +NMDeviceWimax +NMDeviceWimaxClass NM_DEVICE_WIMAX NM_DEVICE_WIMAX_CLASS NM_DEVICE_WIMAX_GET_CLASS @@ -576,13 +576,13 @@ nm_device_wimax_get_type
nm-dhcp4-config NMDHCP4Config -NMDHCP4Config -NMDHCP4ConfigClass NM_DHCP4_CONFIG_OPTIONS nm_dhcp4_config_new nm_dhcp4_config_get_options nm_dhcp4_config_get_one_option +NMDHCP4Config +NMDHCP4ConfigClass NM_DHCP4_CONFIG NM_DHCP4_CONFIG_CLASS NM_IS_DHCP4_CONFIG @@ -594,13 +594,13 @@ nm_dhcp4_config_get_type
nm-dhcp6-config NMDHCP6Config -NMDHCP6Config -NMDHCP6ConfigClass NM_DHCP6_CONFIG_OPTIONS nm_dhcp6_config_new nm_dhcp6_config_get_options nm_dhcp6_config_get_one_option +NMDHCP6Config +NMDHCP6ConfigClass NM_DHCP6_CONFIG NM_DHCP6_CONFIG_CLASS NM_IS_DHCP6_CONFIG @@ -665,8 +665,6 @@ nm_wimax_nsp_network_type_get_type
nm-ip4-config NMIP4Config -NMIP4Config -NMIP4ConfigClass NM_IP4_CONFIG_GATEWAY NM_IP4_CONFIG_ADDRESSES NM_IP4_CONFIG_ROUTES @@ -683,6 +681,8 @@ nm_ip4_config_get_domains nm_ip4_config_get_searches nm_ip4_config_get_wins_servers +NMIP4Config +NMIP4ConfigClass NM_IP4_CONFIG NM_IP4_CONFIG_CLASS NM_IP4_CONFIG_GET_CLASS @@ -695,8 +695,6 @@ nm_ip4_config_get_type
nm-ip6-config NMIP6Config -NMIP6Config -NMIP6ConfigClass NM_IP6_CONFIG_GATEWAY NM_IP6_CONFIG_ADDRESSES NM_IP6_CONFIG_ROUTES @@ -713,6 +711,8 @@ nm_ip6_config_get_nameservers nm_ip6_config_get_domains nm_ip6_config_get_searches +NMIP6Config +NMIP6ConfigClass NM_IP6_CONFIG NM_IP6_CONFIG_CLASS NM_IP6_CONFIG_GET_CLASS @@ -730,11 +730,11 @@ NM_OBJECT_ERROR nm_object_error_quark NM_OBJECT_DBUS_CONNECTION NM_OBJECT_DBUS_PATH -NMObject -NMObjectClass nm_object_get_connection nm_object_get_path +NMObject +NMObjectClass NM_IS_OBJECT NM_IS_OBJECT_CLASS NM_OBJECT @@ -753,8 +753,6 @@ nm_remote_connection_error_quark NM_REMOTE_CONNECTION_UNSAVED NM_REMOTE_CONNECTION_UPDATED NM_REMOTE_CONNECTION_REMOVED -NMRemoteConnection -NMRemoteConnectionClass NMRemoteConnectionResultFunc NMRemoteConnectionCommitFunc NMRemoteConnectionDeleteFunc @@ -767,6 +765,8 @@ nm_remote_connection_delete nm_remote_connection_get_secrets nm_remote_connection_get_unsaved +NMRemoteConnection +NMRemoteConnectionClass NM_IS_REMOTE_CONNECTION NM_IS_REMOTE_CONNECTION_CLASS NM_REMOTE_CONNECTION @@ -791,8 +791,6 @@ NM_REMOTE_SETTINGS_CONNECTIONS_READ NMRemoteSettingsAddConnectionFunc NMRemoteSettingsLoadConnectionsFunc NMRemoteSettingsSaveHostnameFunc -NMRemoteSettings -NMRemoteSettingsClass nm_remote_settings_new nm_remote_settings_new_async nm_remote_settings_new_finish @@ -806,6 +804,8 @@ nm_remote_settings_load_connections nm_remote_settings_reload_connections nm_remote_settings_save_hostname +NMRemoteSettings +NMRemoteSettingsClass NM_IS_REMOTE_SETTINGS NM_IS_REMOTE_SETTINGS_CLASS NM_REMOTE_SETTINGS @@ -828,11 +828,9 @@ NM_SECRET_AGENT_AUTO_REGISTER NM_SECRET_AGENT_REGISTERED NM_SECRET_AGENT_CAPABILITIES NM_SECRET_AGENT_REGISTRATION_RESULT -NMSecretAgent NMSecretAgentGetSecretsFunc NMSecretAgentSaveSecretsFunc NMSecretAgentDeleteSecretsFunc -NMSecretAgentClass nm_secret_agent_register nm_secret_agent_unregister nm_secret_agent_get_registered @@ -840,6 +838,8 @@ nm_secret_agent_get_secrets nm_secret_agent_save_secrets nm_secret_agent_delete_secrets +NMSecretAgent +NMSecretAgentClass NM_IS_SECRET_AGENT NM_IS_SECRET_AGENT_CLASS NM_SECRET_AGENT @@ -873,12 +873,12 @@ nm_uint_array_get_type NMVPNConnection NM_VPN_CONNECTION_VPN_STATE NM_VPN_CONNECTION_BANNER -NMVPNConnection -NMVPNConnectionClass nm_vpn_connection_new nm_vpn_connection_get_vpn_state nm_vpn_connection_get_banner +NMVPNConnection +NMVPNConnectionClass NM_IS_VPN_CONNECTION NM_IS_VPN_CONNECTION_CLASS NM_TYPE_VPN_CONNECTION @@ -905,8 +905,6 @@ nm_vpn_plugin_ui_interface_prop_get_type NM_VPN_PLUGIN_DBUS_SERVICE_NAME NM_VPN_PLUGIN_STATE NMVPNPluginError -NMVPNPlugin -NMVPNPluginClass nm_vpn_plugin_error_quark nm_vpn_plugin_get_connection nm_vpn_plugin_get_state @@ -919,6 +917,8 @@ nm_vpn_plugin_set_ip4_config nm_vpn_plugin_set_ip6_config nm_vpn_plugin_disconnect +NMVPNPlugin +NMVPNPluginClass NM_IS_VPN_PLUGIN NM_IS_VPN_PLUGIN_CLASS NM_TYPE_VPN_PLUGIN @@ -933,7 +933,6 @@ nm_vpn_plugin_get_type
nm-vpn-plugin-ui-interface NMVpnPluginUiWidget -NMVpnPluginUi NMVpnPluginUiFactory nm_vpn_plugin_ui_factory NMVpnPluginUiCapability @@ -941,18 +940,18 @@ NM_VPN_PLUGIN_UI_INTERFACE_NAME NM_VPN_PLUGIN_UI_INTERFACE_DESC NM_VPN_PLUGIN_UI_INTERFACE_SERVICE NMVpnPluginUiInterfaceProp -NMVpnPluginUiInterface nm_vpn_plugin_ui_interface_ui_factory nm_vpn_plugin_ui_interface_get_capabilities nm_vpn_plugin_ui_interface_import nm_vpn_plugin_ui_interface_export nm_vpn_plugin_ui_interface_get_suggested_name nm_vpn_plugin_ui_interface_delete_connection -NMVpnPluginUiWidgetInterface nm_vpn_plugin_ui_widget_interface_get_widget nm_vpn_plugin_ui_widget_interface_update_connection nm_vpn_plugin_ui_widget_interface_save_secrets +NMVpnPluginUiInterface +NMVpnPluginUiWidgetInterface NM_IS_VPN_PLUGIN_UI_INTERFACE NM_IS_VPN_PLUGIN_UI_WIDGET_INTERFACE NM_TYPE_VPN_PLUGIN_UI_INTERFACE @@ -978,8 +977,6 @@ NM_WIMAX_NSP_NAME NM_WIMAX_NSP_SIGNAL_QUALITY NM_WIMAX_NSP_NETWORK_TYPE NMWimaxNspNetworkType -NMWimaxNsp -NMWimaxNspClass nm_wimax_nsp_new nm_wimax_nsp_get_name nm_wimax_nsp_get_signal_quality @@ -987,6 +984,8 @@ nm_wimax_nsp_get_network_type nm_wimax_nsp_filter_connections nm_wimax_nsp_connection_valid +NMWimaxNsp +NMWimaxNspClass NM_IS_WIMAX_NSP NM_IS_WIMAX_NSP_CLASS NM_TYPE_WIMAX_NSP diff --git a/docs/libnm-glib/tmpl/nm-access-point.sgml b/docs/libnm-glib/tmpl/nm-access-point.sgml index ad78146c..2a2ecb1c 100644 --- a/docs/libnm-glib/tmpl/nm-access-point.sgml +++ b/docs/libnm-glib/tmpl/nm-access-point.sgml @@ -92,75 +92,6 @@ NMAccessPoint - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -@parent: -@_reserved1: -@_reserved2: -@_reserved3: -@_reserved4: -@_reserved5: -@_reserved6: - diff --git a/docs/libnm-glib/tmpl/nm-active-connection.sgml b/docs/libnm-glib/tmpl/nm-active-connection.sgml index 457b8428..8b52c825 100644 --- a/docs/libnm-glib/tmpl/nm-active-connection.sgml +++ b/docs/libnm-glib/tmpl/nm-active-connection.sgml @@ -127,100 +127,6 @@ NMActiveConnection - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -@parent: -@_reserved1: -@_reserved2: -@_reserved3: -@_reserved4: -@_reserved5: -@_reserved6: - diff --git a/docs/libnm-glib/tmpl/nm-client.sgml b/docs/libnm-glib/tmpl/nm-client.sgml index 5d6814cc..cb1adf09 100644 --- a/docs/libnm-glib/tmpl/nm-client.sgml +++ b/docs/libnm-glib/tmpl/nm-client.sgml @@ -187,133 +187,6 @@ NMClient @Returns: - - - - - - - - - - - -@nmclient: the object which received the signal. -@arg1: - - - - - - -@nmclient: the object which received the signal. -@arg1: - - - - - - -@nmclient: the object which received the signal. -@arg1: -@arg2: - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -@parent: -@device_added: -@device_removed: -@permission_changed: -@_reserved1: -@_reserved2: -@_reserved3: -@_reserved4: -@_reserved5: -@_reserved6: - diff --git a/docs/libnm-glib/tmpl/nm-device-adsl.sgml b/docs/libnm-glib/tmpl/nm-device-adsl.sgml index 111cf8a6..1c7e14c2 100644 --- a/docs/libnm-glib/tmpl/nm-device-adsl.sgml +++ b/docs/libnm-glib/tmpl/nm-device-adsl.sgml @@ -54,30 +54,6 @@ NMDeviceAdsl - - - - - - - - - - - - - - - - -@parent: -@_reserved1: -@_reserved2: -@_reserved3: -@_reserved4: -@_reserved5: -@_reserved6: - diff --git a/docs/libnm-glib/tmpl/nm-device-bond.sgml b/docs/libnm-glib/tmpl/nm-device-bond.sgml index cc85389d..3270d995 100644 --- a/docs/libnm-glib/tmpl/nm-device-bond.sgml +++ b/docs/libnm-glib/tmpl/nm-device-bond.sgml @@ -69,40 +69,6 @@ NMDeviceBond - - - - - - - - - - - - - - - - - - - - - - - - - - -@parent: -@_reserved1: -@_reserved2: -@_reserved3: -@_reserved4: -@_reserved5: -@_reserved6: - diff --git a/docs/libnm-glib/tmpl/nm-device-bridge.sgml b/docs/libnm-glib/tmpl/nm-device-bridge.sgml index 3570bae3..65094577 100644 --- a/docs/libnm-glib/tmpl/nm-device-bridge.sgml +++ b/docs/libnm-glib/tmpl/nm-device-bridge.sgml @@ -69,40 +69,6 @@ NMDeviceBridge - - - - - - - - - - - - - - - - - - - - - - - - - - -@parent: -@_reserved1: -@_reserved2: -@_reserved3: -@_reserved4: -@_reserved5: -@_reserved6: - diff --git a/docs/libnm-glib/tmpl/nm-device-bt.sgml b/docs/libnm-glib/tmpl/nm-device-bt.sgml index 404ec888..44a6f692 100644 --- a/docs/libnm-glib/tmpl/nm-device-bt.sgml +++ b/docs/libnm-glib/tmpl/nm-device-bt.sgml @@ -71,40 +71,6 @@ NMDeviceBt - - - - - - - - - - - - - - - - - - - - - - - - - - -@parent: -@_reserved1: -@_reserved2: -@_reserved3: -@_reserved4: -@_reserved5: -@_reserved6: - diff --git a/docs/libnm-glib/tmpl/nm-device-ethernet.sgml b/docs/libnm-glib/tmpl/nm-device-ethernet.sgml index a3771275..4d97c189 100644 --- a/docs/libnm-glib/tmpl/nm-device-ethernet.sgml +++ b/docs/libnm-glib/tmpl/nm-device-ethernet.sgml @@ -77,45 +77,6 @@ NMDeviceEthernet - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -@parent: -@_reserved1: -@_reserved2: -@_reserved3: -@_reserved4: -@_reserved5: -@_reserved6: - diff --git a/docs/libnm-glib/tmpl/nm-device-generic.sgml b/docs/libnm-glib/tmpl/nm-device-generic.sgml index e47323d5..c20500bf 100644 --- a/docs/libnm-glib/tmpl/nm-device-generic.sgml +++ b/docs/libnm-glib/tmpl/nm-device-generic.sgml @@ -61,35 +61,6 @@ NMDeviceGeneric - - - - - - - - - - - - - - - - - - - - - -@parent: -@_reserved1: -@_reserved2: -@_reserved3: -@_reserved4: -@_reserved5: -@_reserved6: - diff --git a/docs/libnm-glib/tmpl/nm-device-infiniband.sgml b/docs/libnm-glib/tmpl/nm-device-infiniband.sgml index f50d415f..73a3f3c4 100644 --- a/docs/libnm-glib/tmpl/nm-device-infiniband.sgml +++ b/docs/libnm-glib/tmpl/nm-device-infiniband.sgml @@ -63,35 +63,6 @@ NMDeviceInfiniband - - - - - - - - - - - - - - - - - - - - - -@parent: -@_reserved1: -@_reserved2: -@_reserved3: -@_reserved4: -@_reserved5: -@_reserved6: - diff --git a/docs/libnm-glib/tmpl/nm-device-modem.sgml b/docs/libnm-glib/tmpl/nm-device-modem.sgml index 4e1cc83a..007c3b42 100644 --- a/docs/libnm-glib/tmpl/nm-device-modem.sgml +++ b/docs/libnm-glib/tmpl/nm-device-modem.sgml @@ -62,35 +62,6 @@ NMDeviceModem - - - - - - - - - - - - - - - - - - - - - -@parent: -@_reserved1: -@_reserved2: -@_reserved3: -@_reserved4: -@_reserved5: -@_reserved6: - diff --git a/docs/libnm-glib/tmpl/nm-device-olpc-mesh.sgml b/docs/libnm-glib/tmpl/nm-device-olpc-mesh.sgml index fb78ba35..c8cccb2f 100644 --- a/docs/libnm-glib/tmpl/nm-device-olpc-mesh.sgml +++ b/docs/libnm-glib/tmpl/nm-device-olpc-mesh.sgml @@ -68,40 +68,6 @@ NMDeviceOlpcMesh - - - - - - - - - - - - - - - - - - - - - - - - - - -@parent: -@_reserved1: -@_reserved2: -@_reserved3: -@_reserved4: -@_reserved5: -@_reserved6: - diff --git a/docs/libnm-glib/tmpl/nm-device-team.sgml b/docs/libnm-glib/tmpl/nm-device-team.sgml index cd73a412..abf5ab69 100644 --- a/docs/libnm-glib/tmpl/nm-device-team.sgml +++ b/docs/libnm-glib/tmpl/nm-device-team.sgml @@ -69,40 +69,6 @@ NMDeviceTeam - - - - - - - - - - - - - - - - - - - - - - - - - - -@parent: -@_reserved1: -@_reserved2: -@_reserved3: -@_reserved4: -@_reserved5: -@_reserved6: - diff --git a/docs/libnm-glib/tmpl/nm-device-vlan.sgml b/docs/libnm-glib/tmpl/nm-device-vlan.sgml index 2c638e90..5397d204 100644 --- a/docs/libnm-glib/tmpl/nm-device-vlan.sgml +++ b/docs/libnm-glib/tmpl/nm-device-vlan.sgml @@ -78,45 +78,6 @@ NMDeviceVlan - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -@parent: -@_reserved1: -@_reserved2: -@_reserved3: -@_reserved4: -@_reserved5: -@_reserved6: - diff --git a/docs/libnm-glib/tmpl/nm-device-wifi.sgml b/docs/libnm-glib/tmpl/nm-device-wifi.sgml index 932a7db3..b694b822 100644 --- a/docs/libnm-glib/tmpl/nm-device-wifi.sgml +++ b/docs/libnm-glib/tmpl/nm-device-wifi.sgml @@ -100,78 +100,6 @@ NMDeviceWifi - - - - - - - - - - - -@nmdevicewifi: the object which received the signal. -@arg1: - - - - - - -@nmdevicewifi: the object which received the signal. -@arg1: - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -@parent: -@access_point_added: -@access_point_removed: -@_reserved1: -@_reserved2: -@_reserved3: -@_reserved4: -@_reserved5: -@_reserved6: - diff --git a/docs/libnm-glib/tmpl/nm-device-wimax.sgml b/docs/libnm-glib/tmpl/nm-device-wimax.sgml index 570d0539..acf1ab91 100644 --- a/docs/libnm-glib/tmpl/nm-device-wimax.sgml +++ b/docs/libnm-glib/tmpl/nm-device-wimax.sgml @@ -105,77 +105,6 @@ NMDeviceWimax - - - - - - - - - - - -@nmdevicewimax: the object which received the signal. -@arg1: - - - - - - -@nmdevicewimax: the object which received the signal. -@arg1: - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -@parent: -@nsp_added: -@nsp_removed: - diff --git a/docs/libnm-glib/tmpl/nm-device.sgml b/docs/libnm-glib/tmpl/nm-device.sgml index 5b50ca84..ef5443e1 100644 --- a/docs/libnm-glib/tmpl/nm-device.sgml +++ b/docs/libnm-glib/tmpl/nm-device.sgml @@ -207,152 +207,6 @@ NMDevice - - - - - - - - - - - -@nmdevice: the object which received the signal. -@arg1: -@arg2: -@arg3: - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -@parent: -@state_changed: -@connection_compatible: -@get_type_description: -@get_hw_address: -@get_setting_type: -@_reserved1: -@_reserved2: -@_reserved3: - diff --git a/docs/libnm-glib/tmpl/nm-dhcp4-config.sgml b/docs/libnm-glib/tmpl/nm-dhcp4-config.sgml index 35a6e306..4f3d8602 100644 --- a/docs/libnm-glib/tmpl/nm-dhcp4-config.sgml +++ b/docs/libnm-glib/tmpl/nm-dhcp4-config.sgml @@ -22,30 +22,6 @@ NMDHCP4Config - - - - - - - - - - - - - - - - -@parent: -@_reserved1: -@_reserved2: -@_reserved3: -@_reserved4: -@_reserved5: -@_reserved6: - diff --git a/docs/libnm-glib/tmpl/nm-dhcp6-config.sgml b/docs/libnm-glib/tmpl/nm-dhcp6-config.sgml index 3e00467c..7679b7d9 100644 --- a/docs/libnm-glib/tmpl/nm-dhcp6-config.sgml +++ b/docs/libnm-glib/tmpl/nm-dhcp6-config.sgml @@ -22,30 +22,6 @@ NMDHCP6Config - - - - - - - - - - - - - - - - -@parent: -@_reserved1: -@_reserved2: -@_reserved3: -@_reserved4: -@_reserved5: -@_reserved6: - diff --git a/docs/libnm-glib/tmpl/nm-ip4-config.sgml b/docs/libnm-glib/tmpl/nm-ip4-config.sgml index 499cf35f..6b5f91f3 100644 --- a/docs/libnm-glib/tmpl/nm-ip4-config.sgml +++ b/docs/libnm-glib/tmpl/nm-ip4-config.sgml @@ -22,60 +22,6 @@ NMIP4Config - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -@parent: -@_reserved1: -@_reserved2: -@_reserved3: -@_reserved4: -@_reserved5: -@_reserved6: - diff --git a/docs/libnm-glib/tmpl/nm-ip6-config.sgml b/docs/libnm-glib/tmpl/nm-ip6-config.sgml index 12fe2b1d..f0a95e52 100644 --- a/docs/libnm-glib/tmpl/nm-ip6-config.sgml +++ b/docs/libnm-glib/tmpl/nm-ip6-config.sgml @@ -22,55 +22,6 @@ NMIP6Config - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -@parent: -@_reserved1: -@_reserved2: -@_reserved3: -@_reserved4: -@_reserved5: -@_reserved6: - diff --git a/docs/libnm-glib/tmpl/nm-object.sgml b/docs/libnm-glib/tmpl/nm-object.sgml index bb17ec37..7d99e2c0 100644 --- a/docs/libnm-glib/tmpl/nm-object.sgml +++ b/docs/libnm-glib/tmpl/nm-object.sgml @@ -60,45 +60,6 @@ NMObject - - - - - - - - - - - -@nmobject: the object which received the signal. -@arg1: -@arg2: - - - - - - - - - - - - - - - - -@parent: -@object_creation_failed: -@_reserved1: -@_reserved2: -@_reserved3: -@_reserved4: -@_reserved5: -@_reserved6: - diff --git a/docs/libnm-glib/tmpl/nm-remote-connection.sgml b/docs/libnm-glib/tmpl/nm-remote-connection.sgml index baaccae4..f20ef680 100644 --- a/docs/libnm-glib/tmpl/nm-remote-connection.sgml +++ b/docs/libnm-glib/tmpl/nm-remote-connection.sgml @@ -67,69 +67,6 @@ NMRemoteConnection - - - - - - - - - - - -@nmremoteconnection: the object which received the signal. - - - - - - -@nmremoteconnection: the object which received the signal. - - - - - - -@nmremoteconnection: the object which received the signal. -@arg1: - - - - - - - - - - - - - - - - - - - - - - - - - - -@parent_class: -@updated: -@removed: -@_reserved1: -@_reserved2: -@_reserved3: -@_reserved4: -@_reserved5: -@_reserved6: - diff --git a/docs/libnm-glib/tmpl/nm-remote-settings.sgml b/docs/libnm-glib/tmpl/nm-remote-settings.sgml index 5b129a83..4500e38f 100644 --- a/docs/libnm-glib/tmpl/nm-remote-settings.sgml +++ b/docs/libnm-glib/tmpl/nm-remote-settings.sgml @@ -122,62 +122,6 @@ NMRemoteSettings @user_data: - - - - - - - - - - - -@nmremotesettings: the object which received the signal. - - - - - - -@nmremotesettings: the object which received the signal. -@arg1: - - - - - - - - - - - - - - - - - - - - - - - - - - -@parent: -@new_connection: -@connections_read: -@_reserved1: -@_reserved2: -@_reserved3: -@_reserved4: -@_reserved5: -@_reserved6: - diff --git a/docs/libnm-glib/tmpl/nm-secret-agent.sgml b/docs/libnm-glib/tmpl/nm-secret-agent.sgml index a6f592c3..72f5a573 100644 --- a/docs/libnm-glib/tmpl/nm-secret-agent.sgml +++ b/docs/libnm-glib/tmpl/nm-secret-agent.sgml @@ -104,40 +104,6 @@ NMSecretAgent - - - - - - - - - - - -@nmsecretagent: the object which received the signal. -@arg1: - - - - - - - - - - - - - - - - - - - - - @@ -172,24 +138,6 @@ NMSecretAgent @user_data: - - - - - -@parent: -@get_secrets: -@cancel_get_secrets: -@save_secrets: -@delete_secrets: -@registration_result: -@_reserved1: -@_reserved2: -@_reserved3: -@_reserved4: -@_reserved5: -@_reserved6: - diff --git a/docs/libnm-glib/tmpl/nm-vpn-connection.sgml b/docs/libnm-glib/tmpl/nm-vpn-connection.sgml index c20f145d..39d5ecc1 100644 --- a/docs/libnm-glib/tmpl/nm-vpn-connection.sgml +++ b/docs/libnm-glib/tmpl/nm-vpn-connection.sgml @@ -36,45 +36,6 @@ NMVPNConnection - - - - - - - - - - - -@nmvpnconnection: the object which received the signal. -@arg1: -@arg2: - - - - - - - - - - - - - - - - -@parent: -@vpn_state_changed: -@_reserved1: -@_reserved2: -@_reserved3: -@_reserved4: -@_reserved5: -@_reserved6: - diff --git a/docs/libnm-glib/tmpl/nm-vpn-plugin-ui-interface.sgml b/docs/libnm-glib/tmpl/nm-vpn-plugin-ui-interface.sgml index 9f33e6e3..1f6635b8 100644 --- a/docs/libnm-glib/tmpl/nm-vpn-plugin-ui-interface.sgml +++ b/docs/libnm-glib/tmpl/nm-vpn-plugin-ui-interface.sgml @@ -1,5 +1,5 @@ -NMVpnPluginUi +NMVpnPluginUiWidget @@ -81,25 +81,6 @@ NMVpnPluginUi @NM_VPN_PLUGIN_UI_INTERFACE_PROP_DESC: @NM_VPN_PLUGIN_UI_INTERFACE_PROP_SERVICE: - - - - - -@g_iface: -@ui_factory: -@get_capabilities: -@import_from_file: -@export_to_file: -@get_suggested_name: -@delete_connection: -@_reserved1: -@_reserved2: -@_reserved3: -@_reserved4: -@_reserved5: -@_reserved6: - @@ -164,17 +145,6 @@ NMVpnPluginUi @Returns: - - - - - -@g_iface: -@get_widget: -@update_connection: -@save_secrets: -@changed: - diff --git a/docs/libnm-glib/tmpl/nm-vpn-plugin.sgml b/docs/libnm-glib/tmpl/nm-vpn-plugin.sgml index 46251482..4f002dfe 100644 --- a/docs/libnm-glib/tmpl/nm-vpn-plugin.sgml +++ b/docs/libnm-glib/tmpl/nm-vpn-plugin.sgml @@ -52,34 +52,6 @@ NMVPNPlugin @NM_VPN_PLUGIN_ERROR_CONNECTION_INVALID: @NM_VPN_PLUGIN_ERROR_INTERACTIVE_NOT_SUPPORTED: - - - - - -@parent: - - - - - - -@parent: -@connect: -@need_secrets: -@disconnect: -@state_changed: -@ip4_config: -@login_banner: -@failure: -@quit: -@config: -@ip6_config: -@new_secrets: -@connect_interactive: -@_reserved1: -@_reserved2: - diff --git a/docs/libnm-glib/tmpl/nm-wimax-nsp.sgml b/docs/libnm-glib/tmpl/nm-wimax-nsp.sgml index f270a1d2..8add56d4 100644 --- a/docs/libnm-glib/tmpl/nm-wimax-nsp.sgml +++ b/docs/libnm-glib/tmpl/nm-wimax-nsp.sgml @@ -53,40 +53,6 @@ NMWimaxNsp @NM_WIMAX_NSP_NETWORK_TYPE_PARTNER: @NM_WIMAX_NSP_NETWORK_TYPE_ROAMING_PARTNER: - - - - - - - - - - - - - - - - - - - - - - - - - - -@parent: -@_reserved1: -@_reserved2: -@_reserved3: -@_reserved4: -@_reserved5: -@_reserved6: - diff --git a/docs/libnm-glib/version.xml b/docs/libnm-glib/version.xml index 3eefcb9d..6d7de6e6 100644 --- a/docs/libnm-glib/version.xml +++ b/docs/libnm-glib/version.xml @@ -1 +1 @@ -1.0.0 +1.0.2 diff --git a/docs/libnm-util/Makefile.am b/docs/libnm-util/Makefile.am index f5c44ace..17022310 100644 --- a/docs/libnm-util/Makefile.am +++ b/docs/libnm-util/Makefile.am @@ -10,7 +10,9 @@ DOC_MAIN_SGML_FILE=$(DOC_MODULE)-docs.sgml # The directory containing the source code. Relative to $(srcdir). # gtk-doc will search all .c & .h files beneath here for inline comments # documenting functions and macros. -DOC_SOURCE_DIR=$(top_srcdir)/libnm-util +DOC_SOURCE_DIR= \ + $(top_builddir)/libnm-util \ + $(top_srcdir)/libnm-util # Extra options to supply to gtkdoc-scan. SCAN_OPTIONS=--rebuild-types --rebuild-sections diff --git a/docs/libnm-util/Makefile.in b/docs/libnm-util/Makefile.in index d8998452..db9c82eb 100644 --- a/docs/libnm-util/Makefile.in +++ b/docs/libnm-util/Makefile.in @@ -1,7 +1,7 @@ -# Makefile.in generated by automake 1.13.4 from Makefile.am. +# Makefile.in generated by automake 1.15 from Makefile.am. # @configure_input@ -# Copyright (C) 1994-2013 Free Software Foundation, Inc. +# Copyright (C) 1994-2014 Free Software Foundation, Inc. # This Makefile.in is free software; the Free Software Foundation # gives unlimited permission to copy and/or distribute it, @@ -20,7 +20,17 @@ # Everything below here is generic # #################################### VPATH = @srcdir@ -am__is_gnu_make = test -n '$(MAKEFILE_LIST)' && test -n '$(MAKELEVEL)' +am__is_gnu_make = { \ + if test -z '$(MAKELEVEL)'; then \ + false; \ + elif test -n '$(MAKE_HOST)'; then \ + true; \ + elif test -n '$(MAKE_VERSION)' && test -n '$(CURDIR)'; then \ + true; \ + else \ + false; \ + fi; \ +} am__make_running_with_option = \ case $${target_option-} in \ ?) ;; \ @@ -83,8 +93,6 @@ PRE_UNINSTALL = : POST_UNINSTALL = : build_triplet = @build@ host_triplet = @host@ -DIST_COMMON = $(top_srcdir)/gtk-doc.make $(srcdir)/Makefile.in \ - $(srcdir)/Makefile.am $(srcdir)/version.xml.in subdir = docs/libnm-util ACLOCAL_M4 = $(top_srcdir)/aclocal.m4 am__aclocal_m4_deps = $(top_srcdir)/m4/ax_lib_readline.m4 \ @@ -102,6 +110,7 @@ am__aclocal_m4_deps = $(top_srcdir)/m4/ax_lib_readline.m4 \ $(top_srcdir)/m4/vapigen.m4 $(top_srcdir)/configure.ac am__configure_deps = $(am__aclocal_m4_deps) $(CONFIGURE_DEPENDENCIES) \ $(ACLOCAL_M4) +DIST_COMMON = $(srcdir)/Makefile.am $(am__DIST_COMMON) mkinstalldirs = $(install_sh) -d CONFIG_HEADER = $(top_builddir)/config.h CONFIG_CLEAN_FILES = version.xml @@ -126,6 +135,8 @@ am__can_run_installinfo = \ *) (install-info --version) >/dev/null 2>&1;; \ esac am__tagged_files = $(HEADERS) $(SOURCES) $(TAGS_FILES) $(LISP) +am__DIST_COMMON = $(srcdir)/Makefile.in $(srcdir)/version.xml.in \ + $(top_srcdir)/gtk-doc.make DISTFILES = $(DIST_COMMON) $(DIST_SOURCES) $(TEXINFOS) $(EXTRA_DIST) ACLOCAL = @ACLOCAL@ ALL_LINGUAS = @ALL_LINGUAS@ @@ -152,7 +163,6 @@ CXXCPP = @CXXCPP@ CXXDEPMODE = @CXXDEPMODE@ CXXFLAGS = @CXXFLAGS@ CYGPATH_W = @CYGPATH_W@ -DATADIRNAME = @DATADIRNAME@ DBUS_CFLAGS = @DBUS_CFLAGS@ DBUS_GLIB_100_CFLAGS = @DBUS_GLIB_100_CFLAGS@ DBUS_GLIB_100_LIBS = @DBUS_GLIB_100_LIBS@ @@ -187,6 +197,7 @@ GNUTLS_CFLAGS = @GNUTLS_CFLAGS@ GNUTLS_LIBS = @GNUTLS_LIBS@ GREP = @GREP@ GTKDOC_CHECK = @GTKDOC_CHECK@ +GTKDOC_CHECK_PATH = @GTKDOC_CHECK_PATH@ GTKDOC_DEPS_CFLAGS = @GTKDOC_DEPS_CFLAGS@ GTKDOC_DEPS_LIBS = @GTKDOC_DEPS_LIBS@ GTKDOC_MKPDF = @GTKDOC_MKPDF@ @@ -398,7 +409,10 @@ DOC_MAIN_SGML_FILE = $(DOC_MODULE)-docs.sgml # The directory containing the source code. Relative to $(srcdir). # gtk-doc will search all .c & .h files beneath here for inline comments # documenting functions and macros. -DOC_SOURCE_DIR = $(top_srcdir)/libnm-util +DOC_SOURCE_DIR = \ + $(top_builddir)/libnm-util \ + $(top_srcdir)/libnm-util + # Extra options to supply to gtkdoc-scan. SCAN_OPTIONS = --rebuild-types --rebuild-sections @@ -488,12 +502,12 @@ REPORT_FILES = \ $(DOC_MODULE)-unused.txt CLEANFILES = $(SCANOBJ_FILES) $(REPORT_FILES) $(DOC_STAMPS) \ - libnm-util-sections.txt libnm-util-overrides.txt html/* tmpl/* \ - xml/* -@ENABLE_GTK_DOC_TRUE@@GTK_DOC_BUILD_HTML_FALSE@HTML_BUILD_STAMP = -@ENABLE_GTK_DOC_TRUE@@GTK_DOC_BUILD_HTML_TRUE@HTML_BUILD_STAMP = html-build.stamp -@ENABLE_GTK_DOC_TRUE@@GTK_DOC_BUILD_PDF_FALSE@PDF_BUILD_STAMP = -@ENABLE_GTK_DOC_TRUE@@GTK_DOC_BUILD_PDF_TRUE@PDF_BUILD_STAMP = pdf-build.stamp + gtkdoc-check.test libnm-util-sections.txt \ + libnm-util-overrides.txt html/* tmpl/* xml/* +@GTK_DOC_BUILD_HTML_FALSE@HTML_BUILD_STAMP = +@GTK_DOC_BUILD_HTML_TRUE@HTML_BUILD_STAMP = html-build.stamp +@GTK_DOC_BUILD_PDF_FALSE@PDF_BUILD_STAMP = +@GTK_DOC_BUILD_PDF_TRUE@PDF_BUILD_STAMP = pdf-build.stamp #### setup #### GTK_DOC_V_SETUP = $(GTK_DOC_V_SETUP_$(V)) @@ -545,7 +559,6 @@ $(srcdir)/Makefile.in: @MAINTAINER_MODE_TRUE@ $(srcdir)/Makefile.am $(top_srcdir echo ' cd $(top_srcdir) && $(AUTOMAKE) --gnu docs/libnm-util/Makefile'; \ $(am__cd) $(top_srcdir) && \ $(AUTOMAKE) --gnu docs/libnm-util/Makefile -.PRECIOUS: Makefile Makefile: $(srcdir)/Makefile.in $(top_builddir)/config.status @case '$?' in \ *config.status*) \ @@ -554,7 +567,7 @@ Makefile: $(srcdir)/Makefile.in $(top_builddir)/config.status echo ' cd $(top_builddir) && $(SHELL) ./config.status $(subdir)/$@ $(am__depfiles_maybe)'; \ cd $(top_builddir) && $(SHELL) ./config.status $(subdir)/$@ $(am__depfiles_maybe);; \ esac; -$(top_srcdir)/gtk-doc.make: +$(top_srcdir)/gtk-doc.make $(am__empty): $(top_builddir)/config.status: $(top_srcdir)/configure $(CONFIG_STATUS_DEPENDENCIES) cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh @@ -614,6 +627,7 @@ distdir: $(DISTFILES) dist-hook check-am: all-am check: check-am +@ENABLE_GTK_DOC_FALSE@all-local: all-am: Makefile all-local installdirs: install: install-am @@ -730,9 +744,18 @@ uninstall-am: uninstall-local mostlyclean-libtool pdf pdf-am ps ps-am tags-am uninstall \ uninstall-am uninstall-local +.PRECIOUS: Makefile + -@ENABLE_GTK_DOC_TRUE@all-local: $(HTML_BUILD_STAMP) $(PDF_BUILD_STAMP) -@ENABLE_GTK_DOC_FALSE@all-local: +gtkdoc-check.test: Makefile + $(AM_V_GEN)echo "#!/bin/sh -e" > $@; \ + echo "$(GTKDOC_CHECK_PATH) || exit 1" >> $@; \ + chmod +x $@ + +all-gtk-doc: $(HTML_BUILD_STAMP) $(PDF_BUILD_STAMP) +.PHONY: all-gtk-doc + +@ENABLE_GTK_DOC_TRUE@all-local: all-gtk-doc docs: $(HTML_BUILD_STAMP) $(PDF_BUILD_STAMP) @@ -743,17 +766,19 @@ setup-build.stamp: files=`echo $(SETUP_FILES) $(expand_content_files) $(DOC_MODULE).types`; \ if test "x$$files" != "x" ; then \ for file in $$files ; do \ + destdir=`dirname $(abs_builddir)/$$file` ;\ + test -d "$$destdir" || mkdir -p "$$destdir"; \ test -f $(abs_srcdir)/$$file && \ - cp -pu $(abs_srcdir)/$$file $(abs_builddir)/$$file || true; \ + cp -pf $(abs_srcdir)/$$file $(abs_builddir)/$$file || true; \ done; \ fi; \ test -d $(abs_srcdir)/tmpl && \ - { cp -rp $(abs_srcdir)/tmpl $(abs_builddir)/; \ + { cp -pR $(abs_srcdir)/tmpl $(abs_builddir)/; \ chmod -R u+w $(abs_builddir)/tmpl; } \ fi $(AM_V_at)touch setup-build.stamp -scan-build.stamp: $(HFILE_GLOB) $(CFILE_GLOB) +scan-build.stamp: setup-build.stamp $(HFILE_GLOB) $(CFILE_GLOB) $(GTK_DOC_V_SCAN)_source_dir='' ; \ for i in $(DOC_SOURCE_DIR) ; do \ _source_dir="$${_source_dir} --source-dir=$$i" ; \ @@ -783,7 +808,7 @@ tmpl-build.stamp: setup-build.stamp $(DOC_MODULE)-decl.txt $(SCANOBJ_FILES) $(DO $(GTK_DOC_V_TMPL)gtkdoc-mktmpl --module=$(DOC_MODULE) $(MKTMPL_OPTIONS) $(AM_V_at)if test "$(abs_srcdir)" != "$(abs_builddir)" ; then \ if test -w $(abs_srcdir) ; then \ - cp -rp $(abs_builddir)/tmpl $(abs_srcdir)/; \ + cp -pR $(abs_builddir)/tmpl $(abs_srcdir)/; \ fi \ fi $(AM_V_at)touch tmpl-build.stamp @@ -795,7 +820,7 @@ $(srcdir)/tmpl/*.sgml: @true sgml-build.stamp: tmpl.stamp $(DOC_MODULE)-sections.txt $(srcdir)/tmpl/*.sgml $(expand_content_files) - $(GTK_DOC_V_XML)-chmod -R u+w $(srcdir) && _source_dir='' ; \ + -$(GTK_DOC_V_XML)chmod -R u+w $(srcdir) && _source_dir='' ; \ for i in $(DOC_SOURCE_DIR) ; do \ _source_dir="$${_source_dir} --source-dir=$$i" ; \ done ; \ @@ -857,6 +882,9 @@ pdf-build.stamp: sgml.stamp $(DOC_MAIN_SGML_FILE) $(content_files) clean-local: @rm -f *~ *.bak @rm -rf .libs + @if echo $(SCAN_OPTIONS) | grep -q "\-\-rebuild-types" ; then \ + rm -f $(DOC_MODULE).types; \ + fi distclean-local: @rm -rf xml html $(REPORT_FILES) $(DOC_MODULE).pdf \ @@ -902,12 +930,14 @@ uninstall-local: # # Require gtk-doc when making dist # -@ENABLE_GTK_DOC_TRUE@dist-check-gtkdoc: docs -@ENABLE_GTK_DOC_FALSE@dist-check-gtkdoc: -@ENABLE_GTK_DOC_FALSE@ @echo "*** gtk-doc must be installed and enabled in order to make dist" -@ENABLE_GTK_DOC_FALSE@ @false - -dist-hook: dist-check-gtkdoc dist-hook-local +@HAVE_GTK_DOC_TRUE@dist-check-gtkdoc: docs +@HAVE_GTK_DOC_FALSE@dist-check-gtkdoc: +@HAVE_GTK_DOC_FALSE@ @echo "*** gtk-doc is needed to run 'make dist'. ***" +@HAVE_GTK_DOC_FALSE@ @echo "*** gtk-doc was not found when 'configure' ran. ***" +@HAVE_GTK_DOC_FALSE@ @echo "*** please install gtk-doc and rerun 'configure'. ***" +@HAVE_GTK_DOC_FALSE@ @false + +dist-hook: dist-check-gtkdoc all-gtk-doc dist-hook-local @mkdir $(distdir)/tmpl @mkdir $(distdir)/html @-cp ./tmpl/*.sgml $(distdir)/tmpl diff --git a/docs/libnm-util/html/NMConnection.html b/docs/libnm-util/html/NMConnection.html index 5b41012d..5c288a09 100644 --- a/docs/libnm-util/html/NMConnection.html +++ b/docs/libnm-util/html/NMConnection.html @@ -2,36 +2,29 @@ -NMConnection +libnm-util Reference Manual: NMConnection - + - - - - - - - - - - + + + + + + +
@@ -39,2139 +32,2696 @@

NMConnection

NMConnection — Describes a connection to specific network or provider

- +
-
-

Synopsis

-
-#include <nm-connection.h>
-
-#define             NM_CONNECTION_SECRETS_UPDATED
-#define             NM_CONNECTION_SECRETS_CLEARED
-#define             NM_CONNECTION_CHANGED
-#define             NM_CONNECTION_PATH
-enum                NMConnectionError;
-#define             NM_CONNECTION_NORMALIZE_PARAM_IP6_CONFIG_METHOD
-#define             NM_CONNECTION_ERROR
-GQuark              nm_connection_error_quark           (void);
-                    NMConnection;
-                    NMConnectionClass;
-NMConnection *      nm_connection_new                   (void);
-NMConnection *      nm_connection_new_from_hash         (GHashTable *hash,
-                                                         GError **error);
-NMConnection *      nm_connection_duplicate             (NMConnection *connection);
-NMSetting *         nm_connection_create_setting        (const char *name);
-void                nm_connection_add_setting           (NMConnection *connection,
-                                                         NMSetting *setting);
-void                nm_connection_remove_setting        (NMConnection *connection,
-                                                         GType setting_type);
-NMSetting *         nm_connection_get_setting           (NMConnection *connection,
-                                                         GType setting_type);
-NMSetting *         nm_connection_get_setting_by_name   (NMConnection *connection,
-                                                         const char *name);
-gboolean            nm_connection_replace_settings      (NMConnection *connection,
-                                                         GHashTable *new_settings,
-                                                         GError **error);
-gboolean            nm_connection_replace_settings_from_connection
-                                                        (NMConnection *connection,
-                                                         NMConnection *new_connection,
-                                                         GError **error);
-gboolean            nm_connection_compare               (NMConnection *a,
-                                                         NMConnection *b,
-                                                         NMSettingCompareFlags flags);
-gboolean            nm_connection_diff                  (NMConnection *a,
-                                                         NMConnection *b,
-                                                         NMSettingCompareFlags flags,
-                                                         GHashTable **out_settings);
-gboolean            nm_connection_verify                (NMConnection *connection,
-                                                         GError **error);
-gboolean            nm_connection_normalize             (NMConnection *connection,
-                                                         GHashTable *parameters,
-                                                         gboolean *modified,
-                                                         GError **error);
-const char *        nm_connection_need_secrets          (NMConnection *connection,
-                                                         GPtrArray **hints);
-void                nm_connection_clear_secrets         (NMConnection *connection);
-void                nm_connection_clear_secrets_with_flags
-                                                        (NMConnection *connection,
-                                                         NMSettingClearSecretsWithFlagsFn func,
-                                                         gpointer user_data);
-gboolean            nm_connection_update_secrets        (NMConnection *connection,
-                                                         const char *setting_name,
-                                                         GHashTable *secrets,
-                                                         GError **error);
-void                nm_connection_set_path              (NMConnection *connection,
-                                                         const char *path);
-const char *        nm_connection_get_path              (NMConnection *connection);
-const char *        nm_connection_get_virtual_iface_name
-                                                        (NMConnection *connection);
-const char *        nm_connection_get_interface_name    (NMConnection *connection);
-gboolean            nm_connection_is_type               (NMConnection *connection,
-                                                         const char *type);
-void                nm_connection_for_each_setting_value
-                                                        (NMConnection *connection,
-                                                         NMSettingValueIterFn func,
-                                                         gpointer user_data);
-GHashTable *        nm_connection_to_hash               (NMConnection *connection,
-                                                         NMSettingHashFlags flags);
-void                nm_connection_dump                  (NMConnection *connection);
-GType               nm_connection_lookup_setting_type   (const char *name);
-GType               nm_connection_lookup_setting_type_by_quark
-                                                        (GQuark error_quark);
-const char *        nm_connection_get_uuid              (NMConnection *connection);
-const char *        nm_connection_get_id                (NMConnection *connection);
-const char *        nm_connection_get_connection_type   (NMConnection *connection);
-char *              nm_connection_get_virtual_device_description
-                                                        (NMConnection *connection);
-NMSetting8021x *    nm_connection_get_setting_802_1x    (NMConnection *connection);
-NMSettingBluetooth * nm_connection_get_setting_bluetooth
-                                                        (NMConnection *connection);
-NMSettingBond *     nm_connection_get_setting_bond      (NMConnection *connection);
-NMSettingTeam *     nm_connection_get_setting_team      (NMConnection *connection);
-NMSettingTeamPort * nm_connection_get_setting_team_port (NMConnection *connection);
-NMSettingBridge *   nm_connection_get_setting_bridge    (NMConnection *connection);
-NMSettingBridgePort * nm_connection_get_setting_bridge_port
-                                                        (NMConnection *connection);
-NMSettingCdma *     nm_connection_get_setting_cdma      (NMConnection *connection);
-NMSettingConnection * nm_connection_get_setting_connection
-                                                        (NMConnection *connection);
-NMSettingDcb *      nm_connection_get_setting_dcb       (NMConnection *connection);
-NMSettingGeneric *  nm_connection_get_setting_generic   (NMConnection *connection);
-NMSettingGsm *      nm_connection_get_setting_gsm       (NMConnection *connection);
-NMSettingInfiniband * nm_connection_get_setting_infiniband
-                                                        (NMConnection *connection);
-NMSettingIP4Config * nm_connection_get_setting_ip4_config
-                                                        (NMConnection *connection);
-NMSettingIP6Config * nm_connection_get_setting_ip6_config
-                                                        (NMConnection *connection);
-NMSettingOlpcMesh * nm_connection_get_setting_olpc_mesh (NMConnection *connection);
-NMSettingPPP *      nm_connection_get_setting_ppp       (NMConnection *connection);
-NMSettingPPPOE *    nm_connection_get_setting_pppoe     (NMConnection *connection);
-NMSettingSerial *   nm_connection_get_setting_serial    (NMConnection *connection);
-NMSettingVPN *      nm_connection_get_setting_vpn       (NMConnection *connection);
-NMSettingWimax *    nm_connection_get_setting_wimax     (NMConnection *connection);
-NMSettingAdsl *     nm_connection_get_setting_adsl      (NMConnection *connection);
-NMSettingWired *    nm_connection_get_setting_wired     (NMConnection *connection);
-NMSettingWireless * nm_connection_get_setting_wireless  (NMConnection *connection);
-NMSettingWirelessSecurity * nm_connection_get_setting_wireless_security
-                                                        (NMConnection *connection);
-NMSettingVlan *     nm_connection_get_setting_vlan      (NMConnection *connection);
-
-
-

Object Hierarchy

-
-  GEnum
-   +----NMConnectionError
-
-
-  GObject
-   +----NMConnection
-
+

Functions

+
++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+GQuark + +nm_connection_error_quark () +
+NMConnection * + +nm_connection_new () +
+NMConnection * + +nm_connection_new_from_hash () +
+NMConnection * + +nm_connection_duplicate () +
+NMSetting * + +nm_connection_create_setting () +
+void + +nm_connection_add_setting () +
+void + +nm_connection_remove_setting () +
+NMSetting * + +nm_connection_get_setting () +
+NMSetting * + +nm_connection_get_setting_by_name () +
+gboolean + +nm_connection_replace_settings () +
+gboolean + +nm_connection_replace_settings_from_connection () +
+gboolean + +nm_connection_compare () +
+gboolean + +nm_connection_diff () +
+gboolean + +nm_connection_verify () +
+gboolean + +nm_connection_normalize () +
const char * + +nm_connection_need_secrets () +
+void + +nm_connection_clear_secrets () +
+void + +nm_connection_clear_secrets_with_flags () +
+gboolean + +nm_connection_update_secrets () +
+void + +nm_connection_set_path () +
const char * + +nm_connection_get_path () +
const char * + +nm_connection_get_virtual_iface_name () +
const char * + +nm_connection_get_interface_name () +
+gboolean + +nm_connection_is_type () +
+void + +nm_connection_for_each_setting_value () +
+GHashTable * + +nm_connection_to_hash () +
+void + +nm_connection_dump () +
+GType + +nm_connection_lookup_setting_type () +
+GType + +nm_connection_lookup_setting_type_by_quark () +
const char * + +nm_connection_get_uuid () +
const char * + +nm_connection_get_id () +
const char * + +nm_connection_get_connection_type () +
+char * + +nm_connection_get_virtual_device_description () +
+NMSetting8021x * + +nm_connection_get_setting_802_1x () +
+NMSettingBluetooth * + +nm_connection_get_setting_bluetooth () +
+NMSettingBond * + +nm_connection_get_setting_bond () +
+NMSettingTeam * + +nm_connection_get_setting_team () +
+NMSettingTeamPort * + +nm_connection_get_setting_team_port () +
+NMSettingBridge * + +nm_connection_get_setting_bridge () +
+NMSettingBridgePort * + +nm_connection_get_setting_bridge_port () +
+NMSettingCdma * + +nm_connection_get_setting_cdma () +
+NMSettingConnection * + +nm_connection_get_setting_connection () +
+NMSettingDcb * + +nm_connection_get_setting_dcb () +
+NMSettingGeneric * + +nm_connection_get_setting_generic () +
+NMSettingGsm * + +nm_connection_get_setting_gsm () +
+NMSettingInfiniband * + +nm_connection_get_setting_infiniband () +
+NMSettingIP4Config * + +nm_connection_get_setting_ip4_config () +
+NMSettingIP6Config * + +nm_connection_get_setting_ip6_config () +
+NMSettingOlpcMesh * + +nm_connection_get_setting_olpc_mesh () +
+NMSettingPPP * + +nm_connection_get_setting_ppp () +
+NMSettingPPPOE * + +nm_connection_get_setting_pppoe () +
+NMSettingSerial * + +nm_connection_get_setting_serial () +
+NMSettingVPN * + +nm_connection_get_setting_vpn () +
+NMSettingWimax * + +nm_connection_get_setting_wimax () +
+NMSettingAdsl * + +nm_connection_get_setting_adsl () +
+NMSettingWired * + +nm_connection_get_setting_wired () +
+NMSettingWireless * + +nm_connection_get_setting_wireless () +
+NMSettingWirelessSecurity * + +nm_connection_get_setting_wireless_security () +
+NMSettingVlan * + +nm_connection_get_setting_vlan () +

Properties

-
-  "path"                     gchar*                : Read / Write / Construct
-
+
+++++ + + + + + +
+gchar *pathRead / Write / Construct
-
-

Description

-

-An NMConnection describes all the settings and configuration values that -are necessary to configure network devices for operation on a specific -network. Connections are the fundamental operating object for -NetworkManager; no device is connected without a NMConnection, or -disconnected without having been connected with a NMConnection. -

-

-Each NMConnection contains a list of NMSetting objects usually referenced -by name (using nm_connection_get_setting_by_name()) or by type (with -nm_connection_get_setting()). The settings describe the actual parameters -with which the network devices are configured, including device-specific -parameters (MTU, SSID, APN, channel, rate, etc) and IP-level parameters -(addresses, routes, addressing methods, etc). -

+
+++++ + + + + + + + + + + + + + + + + + +
voidchangedRun First
voidsecrets-clearedRun First
voidsecrets-updatedRun First
-

Details

-
-

NM_CONNECTION_SECRETS_UPDATED

-
#define NM_CONNECTION_SECRETS_UPDATED "secrets-updated"
-
-

-

-
-
-
-

NM_CONNECTION_SECRETS_CLEARED

-
#define NM_CONNECTION_SECRETS_CLEARED "secrets-cleared"
-
-

-

-
-
-
-

NM_CONNECTION_CHANGED

-
#define NM_CONNECTION_CHANGED         "changed"
-
-

-

-
-
-
-

NM_CONNECTION_PATH

-
#define NM_CONNECTION_PATH "path"
-
-

-

-
-
-
-

enum NMConnectionError

-
typedef enum {
-	NM_CONNECTION_ERROR_UNKNOWN = 0,                  /*< nick=UnknownError >*/
-	NM_CONNECTION_ERROR_CONNECTION_SETTING_NOT_FOUND, /*< nick=ConnectionSettingNotFound >*/
-	NM_CONNECTION_ERROR_CONNECTION_TYPE_INVALID,      /*< nick=ConnectionTypeInvalid >*/
-	NM_CONNECTION_ERROR_SETTING_NOT_FOUND,            /*< nick=SettingNotFound >*/
-	NM_CONNECTION_ERROR_INVALID_SETTING,              /*< nick=InvalidSetting >*/
-} NMConnectionError;
-
-

-Describes errors that may result from operations involving a NMConnection. -

-
+

Types and Values

+
--++ - - + + - - + + - - + + - - + + - - + + + + + + + + + + + + + +

NM_CONNECTION_ERROR_UNKNOWN

unknown or unclassified error -#defineNM_CONNECTION_SECRETS_UPDATED

NM_CONNECTION_ERROR_CONNECTION_SETTING_NOT_FOUND

the NMConnection object - did not contain the required NMSettingConnection object, which must be - present for all connections -#defineNM_CONNECTION_SECRETS_CLEARED

NM_CONNECTION_ERROR_CONNECTION_TYPE_INVALID

the 'type' property of the - 'connection' setting did not point to a valid connection base type; ie - it was not a hardware-related setting like NMSettingWired or - NMSettingWireless. -#defineNM_CONNECTION_CHANGED

NM_CONNECTION_ERROR_SETTING_NOT_FOUND

the NMConnection object - did not contain the specified NMSetting object -#defineNM_CONNECTION_PATH

NM_CONNECTION_ERROR_INVALID_SETTING

the NMConnection object contains - a conflicting setting object -enumNMConnectionError
#defineNM_CONNECTION_NORMALIZE_PARAM_IP6_CONFIG_METHOD
#defineNM_CONNECTION_ERROR
 NMConnection
-
-
-

NM_CONNECTION_NORMALIZE_PARAM_IP6_CONFIG_METHOD

-
#define NM_CONNECTION_NORMALIZE_PARAM_IP6_CONFIG_METHOD "ip6-config-method"
+
+

Object Hierarchy

+
    GEnum
+    ╰── NMConnectionError
+    GObject
+    ╰── NMConnection
 
-

-

-
-
-

NM_CONNECTION_ERROR

-
#define NM_CONNECTION_ERROR nm_connection_error_quark ()
+
+

Includes

+
#include <nm-connection.h>
 
-

-

-
-
-

nm_connection_error_quark ()

-
GQuark              nm_connection_error_quark           (void);
-

-Registers an error quark for NMConnection if necessary. -

-
---- - - - - -

Returns :

the error quark used for NMConnection errors.
-
-
-
-

NMConnection

-
typedef struct _NMConnection NMConnection;
-

-The NMConnection struct contains only private data. -It should only be accessed through the functions described below. -

+
+

Description

+

An NMConnection describes all the settings and configuration values that +are necessary to configure network devices for operation on a specific +network. Connections are the fundamental operating object for +NetworkManager; no device is connected without a NMConnection, or +disconnected without having been connected with a NMConnection.

+

Each NMConnection contains a list of NMSetting objects usually referenced +by name (using nm_connection_get_setting_by_name()) or by type (with +nm_connection_get_setting()). The settings describe the actual parameters +with which the network devices are configured, including device-specific +parameters (MTU, SSID, APN, channel, rate, etc) and IP-level parameters +(addresses, routes, addressing methods, etc).

-
+
+

Functions

-

NMConnectionClass

-
typedef struct {
-	GObjectClass parent;
-
-	/* Signals */
-	void (*secrets_updated) (NMConnection *connection, const char * setting);
-} NMConnectionClass;
-
-

-

+

nm_connection_error_quark ()

+
GQuark
+nm_connection_error_quark (void);
+

Registers an error quark for NMConnection if necessary.

+
+

Returns

+

the error quark used for NMConnection errors.

+

+

-

nm_connection_new ()

-
NMConnection *      nm_connection_new                   (void);
-

-Creates a new NMConnection object with no NMSetting objects. -

-
---- - - - - -

Returns :

the new empty NMConnection object
+

nm_connection_new ()

+
NMConnection *
+nm_connection_new (void);
+

Creates a new NMConnection object with no NMSetting objects.

+
+

Returns

+

the new empty NMConnection object

+

+

-

nm_connection_new_from_hash ()

-
NMConnection *      nm_connection_new_from_hash         (GHashTable *hash,
-                                                         GError **error);
-

-Creates a new NMConnection from a hash table describing the connection. See -nm_connection_to_hash() for a description of the expected hash table. -

-
+

nm_connection_new_from_hash ()

+
NMConnection *
+nm_connection_new_from_hash (GHashTable *hash,
+                             GError **error);
+

Creates a new NMConnection from a hash table describing the connection. See +nm_connection_to_hash() for a description of the expected hash table.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + +

hash :

the GHashTable describing -the connection. [element-type utf8 GLib.HashTable] -

error :

on unsuccessful return, an error

hash

the GHashTable describing +the connection.

[element-type utf8 GLib.HashTable]

Returns :

the new NMConnection object, populated with settings created -from the values in the hash table, or NULL if the connection failed to -validate

error

on unsuccessful return, an error

 
+
+

Returns

+

the new NMConnection object, populated with settings created +from the values in the hash table, or NULL if the connection failed to +validate

+

+
+

-

nm_connection_duplicate ()

-
NMConnection *      nm_connection_duplicate             (NMConnection *connection);
-

-Duplicates a NMConnection. -

-
+

nm_connection_duplicate ()

+
NMConnection *
+nm_connection_duplicate (NMConnection *connection);
+

Duplicates a NMConnection.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

connection :

the NMConnection to duplicate

Returns :

a new NMConnection containing the same settings and properties -as the source NMConnection. [transfer full] -

connection

the NMConnection to duplicate

 
+
+

Returns

+

a new NMConnection containing the same settings and properties +as the source NMConnection.

+

[transfer full]

+
+

-

nm_connection_create_setting ()

-
NMSetting *         nm_connection_create_setting        (const char *name);
-

-Create a new NMSetting object of the desired type, given a setting name. -

-
+

nm_connection_create_setting ()

+
NMSetting *
+nm_connection_create_setting (const char *name);
+

Create a new NMSetting object of the desired type, given a setting name.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

name :

a setting name

Returns :

the new setting object, or NULL if the setting name was unknown. [transfer full] -

name

a setting name

 
+
+

Returns

+

the new setting object, or NULL if the setting name was unknown.

+

[transfer full]

+
+

-

nm_connection_add_setting ()

-
void                nm_connection_add_setting           (NMConnection *connection,
-                                                         NMSetting *setting);
-

-Adds a NMSetting to the connection, replacing any previous NMSetting of the +

nm_connection_add_setting ()

+
void
+nm_connection_add_setting (NMConnection *connection,
+                           NMSetting *setting);
+

Adds a NMSetting to the connection, replacing any previous NMSetting of the same name which has previously been added to the NMConnection. The connection takes ownership of the NMSetting object and does not increase -the setting object's reference count. -

-
+the setting object's reference count.

+
+

Parameters

+
--+++ - - + + + - - + + +

connection :

a NMConnection -

connection

a NMConnection

 

setting :

the NMSetting to add to the connection object. [transfer full] -

setting

the NMSetting to add to the connection object.

[transfer full]
+

-

nm_connection_remove_setting ()

-
void                nm_connection_remove_setting        (NMConnection *connection,
-                                                         GType setting_type);
-

-Removes the NMSetting with the given GType from the NMConnection. This -operation dereferences the NMSetting object. -

-
+

nm_connection_remove_setting ()

+
void
+nm_connection_remove_setting (NMConnection *connection,
+                              GType setting_type);
+

Removes the NMSetting with the given GType from the NMConnection. This +operation dereferences the NMSetting object.

+
+

Parameters

+
--+++ - - + + + - - + + +

connection :

a NMConnection -

connection

a NMConnection

 

setting_type :

the GType of the setting object to remove

setting_type

the GType of the setting object to remove

 
+

-

nm_connection_get_setting ()

-
NMSetting *         nm_connection_get_setting           (NMConnection *connection,
-                                                         GType setting_type);
-

-Gets the NMSetting with the given GType, if one has been previously added -to the NMConnection. -

-
+

nm_connection_get_setting ()

+
NMSetting *
+nm_connection_get_setting (NMConnection *connection,
+                           GType setting_type);
+

Gets the NMSetting with the given GType, if one has been previously added +to the NMConnection.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + +

connection :

a NMConnection -

setting_type :

the GType of the setting object to return

connection

a NMConnection

 

Returns :

the NMSetting, or NULL if no setting of that type was previously -added to the NMConnection. [transfer none] -

setting_type

the GType of the setting object to return

 
+
+

Returns

+

the NMSetting, or NULL if no setting of that type was previously +added to the NMConnection.

+

[transfer none]

+
+

-

nm_connection_get_setting_by_name ()

-
NMSetting *         nm_connection_get_setting_by_name   (NMConnection *connection,
-                                                         const char *name);
-

-Gets the NMSetting with the given name, if one has been previously added -the NMConnection. -

-
+

nm_connection_get_setting_by_name ()

+
NMSetting *
+nm_connection_get_setting_by_name (NMConnection *connection,
+                                   const char *name);
+

Gets the NMSetting with the given name, if one has been previously added +the NMConnection.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + +

connection :

a NMConnection -

name :

a setting name

connection

a NMConnection

 

Returns :

the NMSetting, or NULL if no setting with that name was previously -added to the NMConnection. [transfer none] -

name

a setting name

 
+
+

Returns

+

the NMSetting, or NULL if no setting with that name was previously +added to the NMConnection.

+

[transfer none]

+
+

-

nm_connection_replace_settings ()

-
gboolean            nm_connection_replace_settings      (NMConnection *connection,
-                                                         GHashTable *new_settings,
-                                                         GError **error);
-
+

nm_connection_replace_settings ()

+
gboolean
+nm_connection_replace_settings (NMConnection *connection,
+                                GHashTable *new_settings,
+                                GError **error);
+
+

Parameters

+
--+++ - - - - - - + + + - - + + + - - + + +

connection :

a NMConnection -

new_settings :

a GHashTable of settings. [element-type utf8 GLib.HashTable] -

connection

a NMConnection

 

error :

location to store error, or NULL -

new_settings

a GHashTable of settings.

[element-type utf8 GLib.HashTable]

Returns :

-TRUE if the settings were valid and added to the connection, FALSE -if they were not

error

location to store error, or NULL

 
+
+

Returns

+

TRUE if the settings were valid and added to the connection, FALSE +if they were not

+

+
+

-

nm_connection_replace_settings_from_connection ()

-
gboolean            nm_connection_replace_settings_from_connection
-                                                        (NMConnection *connection,
-                                                         NMConnection *new_connection,
-                                                         GError **error);
-

-Deep-copies the settings of new_conenction and replaces the settings of connection -with the copied settings. -

-
+

nm_connection_replace_settings_from_connection ()

+
gboolean
+nm_connection_replace_settings_from_connection
+                               (NMConnection *connection,
+                                NMConnection *new_connection,
+                                GError **error);
+

Deep-copies the settings of new_conenction + and replaces the settings of connection + +with the copied settings.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + + - - + + +

connection :

a NMConnection -

new_connection :

a NMConnection to replace the settings of connection with

connection

a NMConnection

 

error :

location to store error, or NULL -

new_connection

a NMConnection to replace the settings of connection +with

 

Returns :

-TRUE if the settings were valid and added to the connection, FALSE -if they were not

error

location to store error, or NULL

 
+
+
+

Returns

+

TRUE if the settings were valid and added to the connection, FALSE +if they were not

+

+

Since 0.9.10


-

nm_connection_compare ()

-
gboolean            nm_connection_compare               (NMConnection *a,
-                                                         NMConnection *b,
-                                                         NMSettingCompareFlags flags);
-

-Compares two NMConnection objects for similarity, with comparison behavior -modified by a set of flags. See nm_setting_compare() for a description of -each flag's behavior. -

-
+

nm_connection_compare ()

+
gboolean
+nm_connection_compare (NMConnection *a,
+                       NMConnection *b,
+                       NMSettingCompareFlags flags);
+

Compares two NMConnection objects for similarity, with comparison behavior +modified by a set of flags. See nm_setting_compare() for a description of +each flag's behavior.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + + - - + + +

a :

a NMConnection -

b :

a second NMConnection to compare with the first

a

a NMConnection

 

flags :

compare flags, e.g. NM_SETTING_COMPARE_FLAG_EXACT -

b

a second NMConnection to compare with the first

 

Returns :

-TRUE if the comparison succeeds, FALSE if it does not

flags

compare flags, e.g. NM_SETTING_COMPARE_FLAG_EXACT

 
+
+

Returns

+

TRUE if the comparison succeeds, FALSE if it does not

+

+
+
-

nm_connection_diff ()

-
gboolean            nm_connection_diff                  (NMConnection *a,
-                                                         NMConnection *b,
-                                                         NMSettingCompareFlags flags,
-                                                         GHashTable **out_settings);
-

-Compares two NMConnection objects for similarity, with comparison behavior -modified by a set of flags. See nm_setting_compare() for a description of +

nm_connection_diff ()

+
gboolean
+nm_connection_diff (NMConnection *a,
+                    NMConnection *b,
+                    NMSettingCompareFlags flags,
+                    GHashTable **out_settings);
+

Compares two NMConnection objects for similarity, with comparison behavior +modified by a set of flags. See nm_setting_compare() for a description of each flag's behavior. If the connections differ, settings and keys within -each setting that differ are added to the returned out_settings hash table. -No values are returned, only key names. -

-
+each setting that differ are added to the returned out_settings + hash table. +No values are returned, only key names.

+
+

Parameters

+
--+++ - - + + + - - + + + - - + + + - - + - - - - +differ mapped to one or more of NMSettingDiffResult as a bitfield.

+

a :

a NMConnection -

a

a NMConnection

 

b :

a second NMConnection to compare with the first

b

a second NMConnection to compare with the first

 

flags :

compare flags, e.g. NM_SETTING_COMPARE_FLAG_EXACT -

flags

compare flags, e.g. NM_SETTING_COMPARE_FLAG_EXACT

 

out_settings :

if the +

out_settings

if the connections differ, on return a hash table mapping setting names to second-level GHashTable (utf8 to guint32), which contains the key names that -differ mapped to one or more of NMSettingDiffResult as a bitfield. [element-type utf8 GLib.HashTable] -

Returns :

-TRUE if the connections contain the same values, FALSE if they do -not[element-type utf8 GLib.HashTable]
+
+

Returns

+

TRUE if the connections contain the same values, FALSE if they do +not

+

+
+
-

nm_connection_verify ()

-
gboolean            nm_connection_verify                (NMConnection *connection,
-                                                         GError **error);
-

-Validates the connection and all its settings. Each setting's properties +

nm_connection_verify ()

+
gboolean
+nm_connection_verify (NMConnection *connection,
+                      GError **error);
+

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

-
+MAC address. The returned GError contains information about which +setting and which property failed validation, and how it failed validation.

+
+

Parameters

+
--+++ - - + + + - - - - - - + + +

connection :

the NMConnection to verify

connection

the NMConnection to verify

 

error :

location to store error, or NULL -

Returns :

-TRUE if the connection is valid, FALSE if it is not

error

location to store error, or NULL

 
+
+

Returns

+

TRUE if the connection is valid, FALSE if it is not

+

+
+
-

nm_connection_normalize ()

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

-Does some basic normalization and fixup of well known inconsistencies +

nm_connection_normalize ()

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

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

-

-Finally the connection will be verified and TRUE returns if the connection +the output parameter modified + is set TRUE.

+

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

-
+cannot be normalized, the connection will not be modified.

+
+

Parameters

+
--+++ - - + + + - - + - - - - +used. The keys must be strings, hashed by g_str_hash() and g_str_equal() functions. +The values are opaque and depend on the parameter name.

+ - - + + + - - + + +

connection :

the NMConnection to normalize

connection

the NMConnection to normalize

 

parameters :

a GHashTable with +

parameters

a GHashTable with normalization parameters to allow customization of the normalization by providing specific arguments. Unknown arguments will be ignored and the default will be -used. The keys must be strings, hashed by g_str_hash() and g_str_equal() functions. -The values are opaque and depend on the parameter name. [allow-none][element-type utf8 gpointer] -

modified :

outputs whether any settings were modified. [out][allow-none] -[allow-none][element-type utf8 gpointer]

error :

location to store error, or NULL. Contains the reason, -why the connection is invalid, if the function returns an error.

modified

outputs whether any settings were modified.

[out][allow-none]

Returns :

-TRUE if the connection is valid, FALSE if it is not

error

location to store error, or NULL. Contains the reason, +why the connection is invalid, if the function returns an error.

 
+
+
+

Returns

+

TRUE if the connection is valid, FALSE if it is not

+

+

Since 1.0


-

nm_connection_need_secrets ()

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

-Returns the name of the first setting object in the connection which would +

nm_connection_need_secrets ()

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

Returns the name of the first setting object in the connection which would need secrets to make a successful connection. The returned hints are only intended as a guide to what secrets may be required, because in some circumstances, there is no way to conclusively determine exactly which -secrets are needed. -

-
+secrets are needed.

+
+

Parameters

+
--+++ - - + + + - - + - - - - +and must free the array itself with g_ptr_array_free(), but not free its +elements.

+

connection :

the NMConnection -

connection

the NMConnection

 

hints :

the address of a pointer to a GPtrArray, initialized to NULL, which on -return points to an allocated GPtrArray containing the property names of +

hints

the address of a pointer to a GPtrArray, initialized to NULL, which on +return points to an allocated GPtrArray containing the property names of secrets of the NMSetting which may be required; the caller owns the array -and must free the array itself with g_ptr_array_free(), but not free its -elements. [out][element-type utf8][allow-none][transfer container] -

Returns :

the setting name of the NMSetting object which has invalid or -missing secrets[out][element-type utf8][allow-none][transfer container]
+
+

Returns

+

the setting name of the NMSetting object which has invalid or +missing secrets

+

+
+
-

nm_connection_clear_secrets ()

-
void                nm_connection_clear_secrets         (NMConnection *connection);
-

-Clears and frees any secrets that may be stored in the connection, to avoid -keeping secret data in memory when not needed. -

-
+

nm_connection_clear_secrets ()

+
void
+nm_connection_clear_secrets (NMConnection *connection);
+

Clears and frees any secrets that may be stored in the connection, to avoid +keeping secret data in memory when not needed.

+
+

Parameters

+
--+++ - - + + +

connection :

the NMConnection -

connection

the NMConnection

 
+
-

nm_connection_clear_secrets_with_flags ()

-
void                nm_connection_clear_secrets_with_flags
-                                                        (NMConnection *connection,
-                                                         NMSettingClearSecretsWithFlagsFn func,
-                                                         gpointer user_data);
-

-Clears and frees secrets determined by func. -

-
+

nm_connection_clear_secrets_with_flags ()

+
void
+nm_connection_clear_secrets_with_flags
+                               (NMConnection *connection,
+                                NMSettingClearSecretsWithFlagsFn func,
+                                gpointer user_data);
+

Clears and frees secrets determined by func +.

+
+

Parameters

+
--+++ - - + + + - - + + + - - + + +

connection :

the NMConnection -

connection

the NMConnection

 

func :

function to be called to determine whether a -specific secret should be cleared or not. [scope call] -

func

function to be called to determine whether a +specific secret should be cleared or not.

[scope call]

user_data :

caller-supplied data passed to func -

user_data

caller-supplied data passed to func +

 
+
-

nm_connection_update_secrets ()

-
gboolean            nm_connection_update_secrets        (NMConnection *connection,
-                                                         const char *setting_name,
-                                                         GHashTable *secrets,
-                                                         GError **error);
-

-Update the specified setting's secrets, given a hash table of secrets +

nm_connection_update_secrets ()

+
gboolean
+nm_connection_update_secrets (NMConnection *connection,
+                              const char *setting_name,
+                              GHashTable *secrets,
+                              GError **error);
+

Update the specified setting's secrets, given a hash table of secrets intended for that setting (deserialized from D-Bus for example). Will also extract the given setting's secrets hash if given a hash of hashes, as would -be returned from nm_connection_to_hash(). If setting_name is NULL, expects -a fully serialized NMConnection as returned by nm_connection_to_hash() and -will update all secrets from all settings contained in secrets. -

-
+be returned from nm_connection_to_hash(). If setting_name + is NULL, expects +a fully serialized NMConnection as returned by nm_connection_to_hash() and +will update all secrets from all settings contained in secrets +.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + + - - + + + - - + + +

connection :

the NMConnection -

setting_name :

the setting object name to which the secrets apply

connection

the NMConnection

 

secrets :

a GHashTable mapping -string:GValue of setting property names and secrets of the given setting_name. [element-type utf8 GObject.Value] -

setting_name

the setting object name to which the secrets apply

 

error :

location to store error, or NULL -

secrets

a GHashTable mapping +string:GValue of setting property names and secrets of the given setting_name +.

[element-type utf8 GObject.Value]

Returns :

-TRUE if the secrets were successfully updated, FALSE if the update -failed (tried to update secrets for a setting that doesn't exist, etc)

error

location to store error, or NULL

 
+
+

Returns

+

TRUE if the secrets were successfully updated, FALSE if the update +failed (tried to update secrets for a setting that doesn't exist, etc)

+

+
+
-

nm_connection_set_path ()

-
void                nm_connection_set_path              (NMConnection *connection,
-                                                         const char *path);
-

-Sets the D-Bus path of the connection. This property is not serialized, and -is only for the reference of the caller. Sets the "path" -property. -

-
+

nm_connection_set_path ()

+
void
+nm_connection_set_path (NMConnection *connection,
+                        const char *path);
+

Sets the D-Bus path of the connection. This property is not serialized, and +is only for the reference of the caller. Sets the “path” +property.

+
+

Parameters

+
--+++ - - + + + - - + + +

connection :

the NMConnection -

connection

the NMConnection

 

path :

the D-Bus path of the connection as given by the settings service -which provides the connection

path

the D-Bus path of the connection as given by the settings service +which provides the connection

 
+
-

nm_connection_get_path ()

-
const char *        nm_connection_get_path              (NMConnection *connection);
-

-Returns the connection's D-Bus path. -

-
+

nm_connection_get_path ()

+
const char *
+nm_connection_get_path (NMConnection *connection);
+

Returns the connection's D-Bus path.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

connection :

the NMConnection -

Returns :

the D-Bus path of the connection, previously set by a call to -nm_connection_set_path().

connection

the NMConnection

 
+
+

Returns

+

the D-Bus path of the connection, previously set by a call to +nm_connection_set_path().

+

+
+
-

nm_connection_get_virtual_iface_name ()

-
const char *        nm_connection_get_virtual_iface_name
-                                                        (NMConnection *connection);
-

-Returns the name of the virtual kernel interface which the connection +

nm_connection_get_virtual_iface_name ()

+
const char *
+nm_connection_get_virtual_iface_name (NMConnection *connection);
+

Returns the name of the virtual kernel interface which the connection needs to use if specified in the settings. This function abstracts all connection types which require this functionality. For all other -connection types, this function will return NULL. -

-
+connection types, this function will return NULL.

+
+

Parameters

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

connection

The NMConnection

 
+
+
+

Returns

+

Name of the kernel interface or NULL

+

+
+ +
+
+

nm_connection_get_interface_name ()

+
const char *
+nm_connection_get_interface_name (NMConnection *connection);
+

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

+

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

+
+

Parameters

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

connection

The NMConnection

 
+
+
+

Returns

+

Name of the kernel interface or NULL

+

+
+

Since 1.0

+
+
+
+

nm_connection_is_type ()

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

A convenience function to check if the given connection + is a particular +type (ie wired, Wi-Fi, ppp, etc). Checks the “type” +property of the connection and matches that against type +.

+
+

Parameters

+
--+++ - - + + + - - + + +

connection :

The NMConnection -

connection

the NMConnection

 

Returns :

Name of the kernel interface or NULL -

type

a setting name to check the connection's type against (like +NM_SETTING_WIRELESS_SETTING_NAME or NM_SETTING_WIRED_SETTING_NAME)

 
+
+

Returns

+

TRUE if the connection is of the given type +, FALSE if not

+

+
+

-

nm_connection_get_interface_name ()

-
const char *        nm_connection_get_interface_name    (NMConnection *connection);
-

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

-

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

-
+

nm_connection_for_each_setting_value ()

+
void
+nm_connection_for_each_setting_value (NMConnection *connection,
+                                      NMSettingValueIterFn func,
+                                      gpointer user_data);
+

Iterates over the properties of each NMSetting object in the NMConnection, +calling the supplied user function for each property.

+
+

Parameters

+
--+++ - - + + + - - + + + + + + + +

connection :

The NMConnection -

connection

the NMConnection

 

Returns :

Name of the kernel interface or NULL -

func

user-supplied function called for each setting's property.

[scope call]

user_data

user data passed to func +at each invocation

 
-

Since 1.0

+

-

nm_connection_is_type ()

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

-A convenience function to check if the given connection is a particular -type (ie wired, Wi-Fi, ppp, etc). Checks the "type" -property of the connection and matches that against type. -

-
+

nm_connection_to_hash ()

+
GHashTable *
+nm_connection_to_hash (NMConnection *connection,
+                       NMSettingHashFlags flags);
+

Converts the NMConnection into a GHashTable describing the connection, +suitable for marshalling over D-Bus or serializing. The hash table mapping +is string:GHashTable with each element in the returned hash representing +a NMSetting object. The keys are setting object names, and the values +are GHashTables mapping string:GValue, each of which represents the +properties of the NMSetting object.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + +

connection :

the NMConnection -

type :

a setting name to check the connection's type against (like -NM_SETTING_WIRELESS_SETTING_NAME or NM_SETTING_WIRED_SETTING_NAME)

connection

the NMConnection

 

Returns :

-TRUE if the connection is of the given type, FALSE if not

flags

hash flags, e.g. NM_SETTING_HASH_FLAG_ALL

 
+
+

Returns

+

a new +GHashTable describing the connection, its settings, and each setting's +properties. The caller owns the hash table and must unref the hash table +with g_hash_table_unref() when it is no longer needed.

+

[transfer full][element-type utf8 GLib.HashTable]

+
+ +
+
+

nm_connection_dump ()

+
void
+nm_connection_dump (NMConnection *connection);
+

Print the connection to stdout. For debugging purposes ONLY, should NOT +be used for serialization of the connection or machine-parsed in any way. The +output format is not guaranteed to be stable and may change at any time.

+
+

Parameters

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

connection

the NMConnection

 
+
+
+
+
+

nm_connection_lookup_setting_type ()

+
GType
+nm_connection_lookup_setting_type (const char *name);
+

Returns the GType of the setting's class for a given setting name.

+
+

Parameters

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

name

a setting name

 
+
+
+

Returns

+

the GType of the setting's class

+

+
+
+
+
+

nm_connection_lookup_setting_type_by_quark ()

+
GType
+nm_connection_lookup_setting_type_by_quark
+                               (GQuark error_quark);
+

Returns the GType of the setting's class for a given setting error quark. +Useful for figuring out which setting a returned error is for.

+
+

Parameters

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

error_quark

a setting error quark

 
+
+
+

Returns

+

the GType of the setting's class

+

+
+
+
+
+

nm_connection_get_uuid ()

+
const char *
+nm_connection_get_uuid (NMConnection *connection);
+

A shortcut to return the UUID from the connection's NMSettingConnection.

+
+

Parameters

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

connection

the NMConnection

 
+
+
+

Returns

+

the UUID from the connection's 'connection' setting

+

+
+

-

nm_connection_for_each_setting_value ()

-
void                nm_connection_for_each_setting_value
-                                                        (NMConnection *connection,
-                                                         NMSettingValueIterFn func,
-                                                         gpointer user_data);
-

-Iterates over the properties of each NMSetting object in the NMConnection, -calling the supplied user function for each property. -

-
+

nm_connection_get_id ()

+
const char *
+nm_connection_get_id (NMConnection *connection);
+

A shortcut to return the ID from the connection's NMSettingConnection.

+
+

Parameters

+
--+++ - - - - - - - - - - - - - - + + + + +

connection :

the NMConnection -

func :

user-supplied function called for each setting's property. [scope call] -

user_data :

user data passed to func at each invocation

connection

the NMConnection

 
+
+

Returns

+

the ID from the connection's 'connection' setting

+

+
+
-

nm_connection_to_hash ()

-
GHashTable *        nm_connection_to_hash               (NMConnection *connection,
-                                                         NMSettingHashFlags flags);
-

-Converts the NMConnection into a GHashTable describing the connection, -suitable for marshalling over D-Bus or serializing. The hash table mapping -is string:GHashTable with each element in the returned hash representing -a NMSetting object. The keys are setting object names, and the values -are GHashTables mapping string:GValue, each of which represents the -properties of the NMSetting object. -

-
+

nm_connection_get_connection_type ()

+
const char *
+nm_connection_get_connection_type (NMConnection *connection);
+

A shortcut to return the type from the connection's NMSettingConnection.

+
+

Parameters

+
--+++ - - - - - - - - - - - - - - + + + + +

connection :

the NMConnection -

flags :

hash flags, e.g. NM_SETTING_HASH_FLAG_ALL -

Returns :

a new -GHashTable describing the connection, its settings, and each setting's -properties. The caller owns the hash table and must unref the hash table -with g_hash_table_unref() when it is no longer needed. [transfer full][element-type utf8 GLib.HashTable] -

connection

the NMConnection

 
+
+

Returns

+

the type from the connection's 'connection' setting

+

+
+

Since 0.9.10

+
-

nm_connection_dump ()

-
void                nm_connection_dump                  (NMConnection *connection);
-

-Print the connection to stdout. For debugging purposes ONLY, should NOT -be used for serialization of the connection or machine-parsed in any way. The -output format is not guaranteed to be stable and may change at any time. -

-
+

nm_connection_get_virtual_device_description ()

+
char *
+nm_connection_get_virtual_device_description
+                               (NMConnection *connection);
+

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

+
+

Parameters

+
--+++ - - + + +

connection :

the NMConnection -

connection

an NMConnection for a virtual device type

 
+
+

Returns

+

the name of connection +'s device, +or NULL if connection +is not a virtual connection type.

+

[transfer full]

+
+

Since 0.9.10

+
-

nm_connection_lookup_setting_type ()

-
GType               nm_connection_lookup_setting_type   (const char *name);
-

-Returns the GType of the setting's class for a given setting name. -

-
+

nm_connection_get_setting_802_1x ()

+
NMSetting8021x *
+nm_connection_get_setting_802_1x (NMConnection *connection);
+

A shortcut to return any NMSetting8021x the connection might contain.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

name :

a setting name

Returns :

the GType of the setting's class

connection

the NMConnection

 
+
+

Returns

+

an NMSetting8021x if the connection contains one, otherwise NULL.

+

[transfer none]

+
+
-

nm_connection_lookup_setting_type_by_quark ()

-
GType               nm_connection_lookup_setting_type_by_quark
-                                                        (GQuark error_quark);
-

-Returns the GType of the setting's class for a given setting error quark. -Useful for figuring out which setting a returned error is for. -

-
+

nm_connection_get_setting_bluetooth ()

+
NMSettingBluetooth *
+nm_connection_get_setting_bluetooth (NMConnection *connection);
+

A shortcut to return any NMSettingBluetooth the connection might contain.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

error_quark :

a setting error quark

Returns :

the GType of the setting's class

connection

the NMConnection

 
+
+

Returns

+

an NMSettingBluetooth if the connection contains one, otherwise NULL.

+

[transfer none]

+
+
-

nm_connection_get_uuid ()

-
const char *        nm_connection_get_uuid              (NMConnection *connection);
-

-A shortcut to return the UUID from the connection's NMSettingConnection. -

-
+

nm_connection_get_setting_bond ()

+
NMSettingBond *
+nm_connection_get_setting_bond (NMConnection *connection);
+

A shortcut to return any NMSettingBond the connection might contain.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

connection :

the NMConnection -

Returns :

the UUID from the connection's 'connection' setting

connection

the NMConnection

 
+
+

Returns

+

an NMSettingBond if the connection contains one, otherwise NULL.

+

[transfer none]

+
+
-

nm_connection_get_id ()

-
const char *        nm_connection_get_id                (NMConnection *connection);
-

-A shortcut to return the ID from the connection's NMSettingConnection. -

-
+

nm_connection_get_setting_team ()

+
NMSettingTeam *
+nm_connection_get_setting_team (NMConnection *connection);
+

A shortcut to return any NMSettingTeam the connection might contain.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

connection :

the NMConnection -

Returns :

the ID from the connection's 'connection' setting

connection

the NMConnection

 
+
+

Returns

+

an NMSettingTeam if the connection contains one, otherwise NULL.

+

[transfer none]

+
+

Since 0.9.10

+
-

nm_connection_get_connection_type ()

-
const char *        nm_connection_get_connection_type   (NMConnection *connection);
-

-A shortcut to return the type from the connection's NMSettingConnection. -

-
+

nm_connection_get_setting_team_port ()

+
NMSettingTeamPort *
+nm_connection_get_setting_team_port (NMConnection *connection);
+

A shortcut to return any NMSettingTeamPort the connection might contain.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

connection :

the NMConnection -

Returns :

the type from the connection's 'connection' setting

connection

the NMConnection

 
+
+
+

Returns

+

an NMSettingTeamPort if the connection contains one, otherwise NULL.

+

[transfer none]

+

Since 0.9.10


-

nm_connection_get_virtual_device_description ()

-
char *              nm_connection_get_virtual_device_description
-                                                        (NMConnection *connection);
-

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

-
+

nm_connection_get_setting_bridge ()

+
NMSettingBridge *
+nm_connection_get_setting_bridge (NMConnection *connection);
+

A shortcut to return any NMSettingBridge the connection might contain.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

connection :

an NMConnection for a virtual device type

Returns :

the name of connection's device, -or NULL if connection is not a virtual connection type. [transfer full] -

connection

the NMConnection

 
-

Since 0.9.10

+
+
+

Returns

+

an NMSettingBridge if the connection contains one, otherwise NULL.

+

[transfer none]

+

-

nm_connection_get_setting_802_1x ()

-
NMSetting8021x *    nm_connection_get_setting_802_1x    (NMConnection *connection);
-

-A shortcut to return any NMSetting8021x the connection might contain. -

-
+

nm_connection_get_setting_bridge_port ()

+
NMSettingBridgePort *
+nm_connection_get_setting_bridge_port (NMConnection *connection);
+

A shortcut to return any NMSettingBridgePort the connection might contain.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

connection :

the NMConnection -

Returns :

an NMSetting8021x if the connection contains one, otherwise NULL. [transfer none] -

connection

the NMConnection

 
+
+

Returns

+

an NMSettingBridgePort if the connection contains one, otherwise NULL.

+

[transfer none]

+
+
-

nm_connection_get_setting_bluetooth ()

-
NMSettingBluetooth * nm_connection_get_setting_bluetooth
-                                                        (NMConnection *connection);
-

-A shortcut to return any NMSettingBluetooth the connection might contain. -

-
+

nm_connection_get_setting_cdma ()

+
NMSettingCdma *
+nm_connection_get_setting_cdma (NMConnection *connection);
+

A shortcut to return any NMSettingCdma the connection might contain.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

connection :

the NMConnection -

Returns :

an NMSettingBluetooth if the connection contains one, otherwise NULL. [transfer none] -

connection

the NMConnection

 
+
+

Returns

+

an NMSettingCdma if the connection contains one, otherwise NULL.

+

[transfer none]

+
+
-

nm_connection_get_setting_bond ()

-
NMSettingBond *     nm_connection_get_setting_bond      (NMConnection *connection);
-

-A shortcut to return any NMSettingBond the connection might contain. -

-
+

nm_connection_get_setting_connection ()

+
NMSettingConnection *
+nm_connection_get_setting_connection (NMConnection *connection);
+

A shortcut to return any NMSettingConnection the connection might contain.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

connection :

the NMConnection -

Returns :

an NMSettingBond if the connection contains one, otherwise NULL. [transfer none] -

connection

the NMConnection

 
+
+

Returns

+

an NMSettingConnection if the connection contains one, otherwise NULL.

+

[transfer none]

+
+
-

nm_connection_get_setting_team ()

-
NMSettingTeam *     nm_connection_get_setting_team      (NMConnection *connection);
-

-A shortcut to return any NMSettingTeam the connection might contain. -

-
+

nm_connection_get_setting_dcb ()

+
NMSettingDcb *
+nm_connection_get_setting_dcb (NMConnection *connection);
+

A shortcut to return any NMSettingDcb the connection might contain.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

connection :

the NMConnection -

Returns :

an NMSettingTeam if the connection contains one, otherwise NULL. [transfer none] -

connection

the NMConnection

 
+
+
+

Returns

+

an NMSettingDcb if the connection contains one, otherwise NULL.

+

[transfer none]

+

Since 0.9.10


-

nm_connection_get_setting_team_port ()

-
NMSettingTeamPort * nm_connection_get_setting_team_port (NMConnection *connection);
-

-A shortcut to return any NMSettingTeamPort the connection might contain. -

-
+

nm_connection_get_setting_generic ()

+
NMSettingGeneric *
+nm_connection_get_setting_generic (NMConnection *connection);
+

A shortcut to return any NMSettingGeneric the connection might contain.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

connection :

the NMConnection -

Returns :

an NMSettingTeamPort if the connection contains one, otherwise NULL. [transfer none] -

connection

the NMConnection

 
+
+
+

Returns

+

an NMSettingGeneric if the connection contains one, otherwise NULL.

+

[transfer none]

+

Since 0.9.10


-

nm_connection_get_setting_bridge ()

-
NMSettingBridge *   nm_connection_get_setting_bridge    (NMConnection *connection);
-

-A shortcut to return any NMSettingBridge the connection might contain. -

-
+

nm_connection_get_setting_gsm ()

+
NMSettingGsm *
+nm_connection_get_setting_gsm (NMConnection *connection);
+

A shortcut to return any NMSettingGsm the connection might contain.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

connection :

the NMConnection -

Returns :

an NMSettingBridge if the connection contains one, otherwise NULL. [transfer none] -

connection

the NMConnection

 
+
+

Returns

+

an NMSettingGsm if the connection contains one, otherwise NULL.

+

[transfer none]

+
+
-

nm_connection_get_setting_bridge_port ()

-
NMSettingBridgePort * nm_connection_get_setting_bridge_port
-                                                        (NMConnection *connection);
-

-A shortcut to return any NMSettingBridgePort the connection might contain. -

-
+

nm_connection_get_setting_infiniband ()

+
NMSettingInfiniband *
+nm_connection_get_setting_infiniband (NMConnection *connection);
+

A shortcut to return any NMSettingInfiniband the connection might contain.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

connection :

the NMConnection -

Returns :

an NMSettingBridgePort if the connection contains one, otherwise NULL. [transfer none] -

connection

the NMConnection

 
+
+

Returns

+

an NMSettingInfiniband if the connection contains one, otherwise NULL.

+

[transfer none]

+
+
-

nm_connection_get_setting_cdma ()

-
NMSettingCdma *     nm_connection_get_setting_cdma      (NMConnection *connection);
-

-A shortcut to return any NMSettingCdma the connection might contain. -

-
+

nm_connection_get_setting_ip4_config ()

+
NMSettingIP4Config *
+nm_connection_get_setting_ip4_config (NMConnection *connection);
+

A shortcut to return any NMSettingIP4Config the connection might contain.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

connection :

the NMConnection -

Returns :

an NMSettingCdma if the connection contains one, otherwise NULL. [transfer none] -

connection

the NMConnection

 
+
+

Returns

+

an NMSettingIP4Config if the connection contains one, otherwise NULL.

+

[transfer none]

+
+
-

nm_connection_get_setting_connection ()

-
NMSettingConnection * nm_connection_get_setting_connection
-                                                        (NMConnection *connection);
-

-A shortcut to return any NMSettingConnection the connection might contain. -

-
+

nm_connection_get_setting_ip6_config ()

+
NMSettingIP6Config *
+nm_connection_get_setting_ip6_config (NMConnection *connection);
+

A shortcut to return any NMSettingIP6Config the connection might contain.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + + +

connection :

the NMConnection -

Returns :

an NMSettingConnection if the connection contains one, otherwise NULL. [transfer none] -

connection

the NMConnection

 
+
+
+

Returns

+

an NMSettingIP6Config if the connection contains one, otherwise NULL.

+

[transfer none]

+
+ +
+
+

nm_connection_get_setting_olpc_mesh ()

+
NMSettingOlpcMesh *
+nm_connection_get_setting_olpc_mesh (NMConnection *connection);
+

A shortcut to return any NMSettingOlpcMesh the connection might contain.

+
+

Parameters

+
+++++ + + + + +

connection

the NMConnection

 
+
+

Returns

+

an NMSettingOlpcMesh if the connection contains one, otherwise NULL.

+

[transfer none]

+
+

-

nm_connection_get_setting_dcb ()

-
NMSettingDcb *      nm_connection_get_setting_dcb       (NMConnection *connection);
-

-A shortcut to return any NMSettingDcb the connection might contain. -

-
+

nm_connection_get_setting_ppp ()

+
NMSettingPPP *
+nm_connection_get_setting_ppp (NMConnection *connection);
+

A shortcut to return any NMSettingPPP the connection might contain.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

connection :

the NMConnection -

Returns :

an NMSettingDcb if the connection contains one, otherwise NULL. [transfer none] -

connection

the NMConnection

 
-

Since 0.9.10

+
+
+

Returns

+

an NMSettingPPP if the connection contains one, otherwise NULL.

+

[transfer none]

+

-

nm_connection_get_setting_generic ()

-
NMSettingGeneric *  nm_connection_get_setting_generic   (NMConnection *connection);
-

-A shortcut to return any NMSettingGeneric the connection might contain. -

-
+

nm_connection_get_setting_pppoe ()

+
NMSettingPPPOE *
+nm_connection_get_setting_pppoe (NMConnection *connection);
+

A shortcut to return any NMSettingPPPOE the connection might contain.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

connection :

the NMConnection -

Returns :

an NMSettingGeneric if the connection contains one, otherwise NULL. [transfer none] -

connection

the NMConnection

 
-

Since 0.9.10

+
+
+

Returns

+

an NMSettingPPPOE if the connection contains one, otherwise NULL.

+

[transfer none]

+

-

nm_connection_get_setting_gsm ()

-
NMSettingGsm *      nm_connection_get_setting_gsm       (NMConnection *connection);
-

-A shortcut to return any NMSettingGsm the connection might contain. -

-
+

nm_connection_get_setting_serial ()

+
NMSettingSerial *
+nm_connection_get_setting_serial (NMConnection *connection);
+

A shortcut to return any NMSettingSerial the connection might contain.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

connection :

the NMConnection -

Returns :

an NMSettingGsm if the connection contains one, otherwise NULL. [transfer none] -

connection

the NMConnection

 
+
+

Returns

+

an NMSettingSerial if the connection contains one, otherwise NULL.

+

[transfer none]

+
+
-

nm_connection_get_setting_infiniband ()

-
NMSettingInfiniband * nm_connection_get_setting_infiniband
-                                                        (NMConnection *connection);
-

-A shortcut to return any NMSettingInfiniband the connection might contain. -

-
+

nm_connection_get_setting_vpn ()

+
NMSettingVPN *
+nm_connection_get_setting_vpn (NMConnection *connection);
+

A shortcut to return any NMSettingVPN the connection might contain.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

connection :

the NMConnection -

Returns :

an NMSettingInfiniband if the connection contains one, otherwise NULL. [transfer none] -

connection

the NMConnection

 
+
+

Returns

+

an NMSettingVPN if the connection contains one, otherwise NULL.

+

[transfer none]

+
+
-

nm_connection_get_setting_ip4_config ()

-
NMSettingIP4Config * nm_connection_get_setting_ip4_config
-                                                        (NMConnection *connection);
-

-A shortcut to return any NMSettingIP4Config the connection might contain. -

-
+

nm_connection_get_setting_wimax ()

+
NMSettingWimax *
+nm_connection_get_setting_wimax (NMConnection *connection);
+

A shortcut to return any NMSettingWimax the connection might contain.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

connection :

the NMConnection -

Returns :

an NMSettingIP4Config if the connection contains one, otherwise NULL. [transfer none] -

connection

the NMConnection

 
+
+

Returns

+

an NMSettingWimax if the connection contains one, otherwise NULL.

+

[transfer none]

+
+
-

nm_connection_get_setting_ip6_config ()

-
NMSettingIP6Config * nm_connection_get_setting_ip6_config
-                                                        (NMConnection *connection);
-

-A shortcut to return any NMSettingIP6Config the connection might contain. -

-
+

nm_connection_get_setting_adsl ()

+
NMSettingAdsl *
+nm_connection_get_setting_adsl (NMConnection *connection);
+

A shortcut to return any NMSettingAdsl the connection might contain.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

connection :

the NMConnection -

Returns :

an NMSettingIP6Config if the connection contains one, otherwise NULL. [transfer none] -

connection

the NMConnection

 
+
+

Returns

+

an NMSettingAdsl if the connection contains one, otherwise NULL.

+

[transfer none]

+
+
-

nm_connection_get_setting_olpc_mesh ()

-
NMSettingOlpcMesh * nm_connection_get_setting_olpc_mesh (NMConnection *connection);
-

-A shortcut to return any NMSettingOlpcMesh the connection might contain. -

-
+

nm_connection_get_setting_wired ()

+
NMSettingWired *
+nm_connection_get_setting_wired (NMConnection *connection);
+

A shortcut to return any NMSettingWired the connection might contain.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

connection :

the NMConnection -

Returns :

an NMSettingOlpcMesh if the connection contains one, otherwise NULL. [transfer none] -

connection

the NMConnection

 
+
+

Returns

+

an NMSettingWired if the connection contains one, otherwise NULL.

+

[transfer none]

+
+
-

nm_connection_get_setting_ppp ()

-
NMSettingPPP *      nm_connection_get_setting_ppp       (NMConnection *connection);
-

-A shortcut to return any NMSettingPPP the connection might contain. -

-
+

nm_connection_get_setting_wireless ()

+
NMSettingWireless *
+nm_connection_get_setting_wireless (NMConnection *connection);
+

A shortcut to return any NMSettingWireless the connection might contain.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

connection :

the NMConnection -

Returns :

an NMSettingPPP if the connection contains one, otherwise NULL. [transfer none] -

connection

the NMConnection

 
+
+

Returns

+

an NMSettingWireless if the connection contains one, otherwise NULL.

+

[transfer none]

+
+
-

nm_connection_get_setting_pppoe ()

-
NMSettingPPPOE *    nm_connection_get_setting_pppoe     (NMConnection *connection);
-

-A shortcut to return any NMSettingPPPOE the connection might contain. -

-
+

nm_connection_get_setting_wireless_security ()

+
NMSettingWirelessSecurity *
+nm_connection_get_setting_wireless_security
+                               (NMConnection *connection);
+

A shortcut to return any NMSettingWirelessSecurity the connection might contain.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

connection :

the NMConnection -

Returns :

an NMSettingPPPOE if the connection contains one, otherwise NULL. [transfer none] -

connection

the NMConnection

 
+
+

Returns

+

an NMSettingWirelessSecurity if the connection contains one, otherwise NULL.

+

[transfer none]

+
+
-

nm_connection_get_setting_serial ()

-
NMSettingSerial *   nm_connection_get_setting_serial    (NMConnection *connection);
-

-A shortcut to return any NMSettingSerial the connection might contain. -

-
+

nm_connection_get_setting_vlan ()

+
NMSettingVlan *
+nm_connection_get_setting_vlan (NMConnection *connection);
+

A shortcut to return any NMSettingVlan the connection might contain.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

connection :

the NMConnection -

Returns :

an NMSettingSerial if the connection contains one, otherwise NULL. [transfer none] -

connection

the NMConnection

 
-
+
+

Returns

+

an NMSettingVlan if the connection contains one, otherwise NULL.

+

[transfer none]

+
+ + +
+

Types and Values

-

nm_connection_get_setting_vpn ()

-
NMSettingVPN *      nm_connection_get_setting_vpn       (NMConnection *connection);
+

NM_CONNECTION_SECRETS_UPDATED

+
#define NM_CONNECTION_SECRETS_UPDATED "secrets-updated"
+

-A shortcut to return any NMSettingVPN the connection might contain.

-
---- - - - - - - - - - - -

connection :

the NMConnection -

Returns :

an NMSettingVPN if the connection contains one, otherwise NULL. [transfer none] -

-

nm_connection_get_setting_wimax ()

-
NMSettingWimax *    nm_connection_get_setting_wimax     (NMConnection *connection);
+

NM_CONNECTION_SECRETS_CLEARED

+
#define NM_CONNECTION_SECRETS_CLEARED "secrets-cleared"
+

-A shortcut to return any NMSettingWimax the connection might contain.

-
---- - - - - - - - - - - -

connection :

the NMConnection -

Returns :

an NMSettingWimax if the connection contains one, otherwise NULL. [transfer none] -

-

nm_connection_get_setting_adsl ()

-
NMSettingAdsl *     nm_connection_get_setting_adsl      (NMConnection *connection);
+

NM_CONNECTION_CHANGED

+
#define NM_CONNECTION_CHANGED         "changed"
+

-A shortcut to return any NMSettingAdsl the connection might contain.

-
---- - - - - - - - - - - -

connection :

the NMConnection -

Returns :

an NMSettingAdsl if the connection contains one, otherwise NULL. [transfer none] -

-

nm_connection_get_setting_wired ()

-
NMSettingWired *    nm_connection_get_setting_wired     (NMConnection *connection);
+

NM_CONNECTION_PATH

+
#define NM_CONNECTION_PATH "path"
+

-A shortcut to return any NMSettingWired the connection might contain.

-
+ +
+
+

enum NMConnectionError

+

Describes errors that may result from operations involving a NMConnection.

+
+

Members

+
--+++ - - + + - - + + + + + + + - -

connection :

the NMConnection +

NM_CONNECTION_ERROR_UNKNOWN

+

unknown or unclassified error

 

Returns :

an NMSettingWired if the connection contains one, otherwise NULL. [transfer none] +

NM_CONNECTION_ERROR_CONNECTION_SETTING_NOT_FOUND

+

the NMConnection object + did not contain the required NMSettingConnection object, which must be + present for all connections

 

NM_CONNECTION_ERROR_CONNECTION_TYPE_INVALID

+

the 'type' property of the + 'connection' setting did not point to a valid connection base type; ie + it was not a hardware-related setting like NMSettingWired or + NMSettingWireless.

+
 
-
-
-
-

nm_connection_get_setting_wireless ()

-
NMSettingWireless * nm_connection_get_setting_wireless  (NMConnection *connection);
-

-A shortcut to return any NMSettingWireless the connection might contain. -

-
---- - - - + + - - + +

connection :

the NMConnection +

NM_CONNECTION_ERROR_SETTING_NOT_FOUND

+

the NMConnection object + did not contain the specified NMSetting object

 

Returns :

an NMSettingWireless if the connection contains one, otherwise NULL. [transfer none] +

NM_CONNECTION_ERROR_INVALID_SETTING

+

the NMConnection object contains + a conflicting setting object

 
+

-

nm_connection_get_setting_wireless_security ()

-
NMSettingWirelessSecurity * nm_connection_get_setting_wireless_security
-                                                        (NMConnection *connection);
+

NM_CONNECTION_NORMALIZE_PARAM_IP6_CONFIG_METHOD

+
#define NM_CONNECTION_NORMALIZE_PARAM_IP6_CONFIG_METHOD "ip6-config-method"
+

-A shortcut to return any NMSettingWirelessSecurity the connection might contain.

-
---- - - - - - - - - - - -

connection :

the NMConnection -

Returns :

an NMSettingWirelessSecurity if the connection contains one, otherwise NULL. [transfer none] -

-

nm_connection_get_setting_vlan ()

-
NMSettingVlan *     nm_connection_get_setting_vlan      (NMConnection *connection);
+

NM_CONNECTION_ERROR

+
#define NM_CONNECTION_ERROR nm_connection_error_quark ()
+

-A shortcut to return any NMSettingVlan the connection might contain.

-
---- - - - - - - - - - - -

connection :

the NMConnection -

Returns :

an NMSettingVlan if the connection contains one, otherwise NULL. [transfer none] -
+
+
+
+

NMConnection

+
typedef struct _NMConnection NMConnection;
+

The NMConnection struct contains only private data. +It should only be accessed through the functions described below.

Property Details

-

The "path" property

-
  "path"                     gchar*                : Read / Write / Construct
-

-The connection's D-Bus path, used only by the calling process as a record -of the D-Bus path of the connection as provided by a settings service. -

+

The “path” property

+
  “path”                     gchar *
+

The connection's D-Bus path, used only by the calling process as a record +of the D-Bus path of the connection as provided by a settings service.

+

Flags: Read / Write / Construct

Default value: NULL

Signal Details

-

The "changed" signal

-
void                user_function                      (NMConnection *connection,
-                                                        gpointer      user_data)       : Run First
-

-The ::changed signal is emitted when any property of any property +

The “changed” signal

+
void
+user_function (NMConnection *connection,
+               gpointer      user_data)
+

The ::changed signal is emitted when any property of any property (including secrets) of any setting of the connection is modified, -or when settings are added or removed. -

-
+or when settings are added or removed.

+
+

Parameters

+
--+++ - - + + + - - + + +

connection :

the object on which the signal is emitted

connection

the object on which the signal is emitted

 

user_data :

user data set when the signal handler was connected.

user_data

user data set when the signal handler was connected.

 
+
+

Flags: Run First

Since 0.9.10


-

The "secrets-cleared" signal

-
void                user_function                      (NMConnection *connection,
-                                                        gpointer      user_data)       : Run First
-

-The ::secrets-cleared signal is emitted when the secrets of a connection -are cleared. -

-
+

The “secrets-cleared” signal

+
void
+user_function (NMConnection *connection,
+               gpointer      user_data)
+

The ::secrets-cleared signal is emitted when the secrets of a connection +are cleared.

+
+

Parameters

+
--+++ - - + + + - - + + +

connection :

the object on which the signal is emitted

connection

the object on which the signal is emitted

 

user_data :

user data set when the signal handler was connected.

user_data

user data set when the signal handler was connected.

 
+

Flags: Run First

+
-

The "secrets-updated" signal

-
void                user_function                      (NMConnection *connection,
-                                                        gchar        *setting_name,
-                                                        gpointer      user_data)         : Run First
-

-The ::secrets-updated signal is emitted when the secrets of a setting -have been changed. -

-
+

The “secrets-updated” signal

+
void
+user_function (NMConnection *connection,
+               gchar        *setting_name,
+               gpointer      user_data)
+

The ::secrets-updated signal is emitted when the secrets of a setting +have been changed.

+
+

Parameters

+
--+++ - - + + + - - + + + - - + + +

connection :

the object on which the signal is emitted

connection

the object on which the signal is emitted

 

setting_name :

the setting name of the NMSetting for which secrets were -updated

setting_name

the setting name of the NMSetting for which secrets were +updated

 

user_data :

user data set when the signal handler was connected.

user_data

user data set when the signal handler was connected.

 
+

Flags: Run First

+ + Generated by GTK-Doc V1.21 \ No newline at end of file diff --git a/docs/libnm-util/html/NMSetting.html b/docs/libnm-util/html/NMSetting.html index 259433e6..140fac6a 100644 --- a/docs/libnm-util/html/NMSetting.html +++ b/docs/libnm-util/html/NMSetting.html @@ -2,34 +2,28 @@ -NMSetting +libnm-util Reference Manual: NMSetting - + - - - - - - - - - - + + + + + + +
@@ -37,219 +31,309 @@

NMSetting

NMSetting — Describes related configuration information

- +
-
-

Synopsis

-
-#include <nm-setting.h>
-
-enum                NMSettingError;
-#define             NM_SETTING_ERROR
-GQuark              nm_setting_error_quark              (void);
-#define             NM_SETTING_PARAM_SERIALIZE
-#define             NM_SETTING_PARAM_REQUIRED
-#define             NM_SETTING_PARAM_SECRET
-#define             NM_SETTING_PARAM_FUZZY_IGNORE
-#define             NM_SETTING_NAME
-enum                NMSettingSecretFlags;
-enum                NMSettingCompareFlags;
-                    NMSetting;
-gboolean            (*NMSettingClearSecretsWithFlagsFn) (NMSetting *setting,
-                                                         const char *secret,
-                                                         NMSettingSecretFlags flags,
-                                                         gpointer user_data);
-                    NMSettingClass;
-void                (*NMSettingValueIterFn)             (NMSetting *setting,
-                                                         const char *key,
-                                                         const GValue *value,
-                                                         GParamFlags flags,
-                                                         gpointer user_data);
-enum                NMSettingHashFlags;
-GHashTable *        nm_setting_to_hash                  (NMSetting *setting,
-                                                         NMSettingHashFlags flags);
-NMSetting *         nm_setting_new_from_hash            (GType setting_type,
-                                                         GHashTable *hash);
-NMSetting *         nm_setting_duplicate                (NMSetting *setting);
-const char *        nm_setting_get_name                 (NMSetting *setting);
-gboolean            nm_setting_verify                   (NMSetting *setting,
-                                                         GSList *all_settings,
-                                                         GError **error);
-gboolean            nm_setting_compare                  (NMSetting *a,
-                                                         NMSetting *b,
-                                                         NMSettingCompareFlags flags);
-enum                NMSettingDiffResult;
-gboolean            nm_setting_diff                     (NMSetting *a,
-                                                         NMSetting *b,
-                                                         NMSettingCompareFlags flags,
-                                                         gboolean invert_results,
-                                                         GHashTable **results);
-void                nm_setting_enumerate_values         (NMSetting *setting,
-                                                         NMSettingValueIterFn func,
-                                                         gpointer user_data);
-char *              nm_setting_to_string                (NMSetting *setting);
-void                nm_setting_clear_secrets            (NMSetting *setting);
-void                nm_setting_clear_secrets_with_flags (NMSetting *setting,
-                                                         NMSettingClearSecretsWithFlagsFn func,
-                                                         gpointer user_data);
-GPtrArray *         nm_setting_need_secrets             (NMSetting *setting);
-gboolean            nm_setting_update_secrets           (NMSetting *setting,
-                                                         GHashTable *secrets,
-                                                         GError **error);
-gboolean            nm_setting_get_secret_flags         (NMSetting *setting,
-                                                         const char *secret_name,
-                                                         NMSettingSecretFlags *out_flags,
-                                                         GError **error);
-gboolean            nm_setting_set_secret_flags         (NMSetting *setting,
-                                                         const char *secret_name,
-                                                         NMSettingSecretFlags flags,
-                                                         GError **error);
-const char *        nm_setting_get_virtual_iface_name   (NMSetting *setting);
-
-
-
-

Object Hierarchy

-
-  GEnum
-   +----NMSettingError
-
-
-  GEnum
-   +----NMSettingSecretFlags
-
-
-  GEnum
-   +----NMSettingCompareFlags
-
-
-  GObject
-   +----NMSetting
-         +----NMSetting8021x
-         +----NMSettingAdsl
-         +----NMSettingBluetooth
-         +----NMSettingBond
-         +----NMSettingTeam
-         +----NMSettingTeamPort
-         +----NMSettingBridge
-         +----NMSettingBridgePort
-         +----NMSettingConnection
-         +----NMSettingDcb
-         +----NMSettingInfiniband
-         +----NMSettingIP4Config
-         +----NMSettingVlan
-         +----NMSettingIP6Config
-         +----NMSettingPPP
-         +----NMSettingPPPOE
-         +----NMSettingSerial
-         +----NMSettingGeneric
-         +----NMSettingGsm
-         +----NMSettingCdma
-         +----NMSettingOlpcMesh
-         +----NMSettingWimax
-         +----NMSettingWired
-         +----NMSettingWireless
-         +----NMSettingWirelessSecurity
-         +----NMSettingVPN
-
-
-  GEnum
-   +----NMSettingHashFlags
-
-
-  GEnum
-   +----NMSettingDiffResult
-
-
-
-

Properties

-
-  "name"                     gchar*                : Read / Write
-
-
-
-

Description

-

-Each NMSetting contains properties that describe configuration that applies -to a specific network layer (like IPv4 or IPv6 configuration) or device type -(like Ethernet, or Wi-Fi). A collection of individual settings together -make up an NMConnection. Each property is strongly typed and usually has -a number of allowed values. See each NMSetting subclass for a description -of properties and allowed values. -

-
-

Details

-
-

enum NMSettingError

-
typedef enum {
-	NM_SETTING_ERROR_UNKNOWN = 0,           /*< nick=UnknownError >*/
-	NM_SETTING_ERROR_PROPERTY_NOT_FOUND,    /*< nick=PropertyNotFound >*/
-	NM_SETTING_ERROR_PROPERTY_NOT_SECRET,   /*< nick=PropertyNotSecret >*/
-	NM_SETTING_ERROR_PROPERTY_TYPE_MISMATCH /*< nick=PropertyTypeMismatch >*/
-} NMSettingError;
-
-

-Describes errors that may result from operations involving a NMSetting. -

-
+

Functions

+
--++ - - + - - + + + + + + + + + + + + + + + + + - - + - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

NM_SETTING_ERROR_UNKNOWN

unknown or unclassified error + +GQuark + +nm_setting_error_quark ()

NM_SETTING_ERROR_PROPERTY_NOT_FOUND

a property required by the operation - was not found; for example, an attempt to update an invalid secret +#defineNM_SETTING_PARAM_SERIALIZE
#defineNM_SETTING_PARAM_REQUIRED
#defineNM_SETTING_PARAM_SECRET
#defineNM_SETTING_PARAM_FUZZY_IGNORE
+gboolean + +(*NMSettingClearSecretsWithFlagsFn) ()

NM_SETTING_ERROR_PROPERTY_NOT_SECRET

an operation which requires a secret - was attempted on a non-secret property + +void + +(*NMSettingValueIterFn) ()

NM_SETTING_ERROR_PROPERTY_TYPE_MISMATCH

the operation requires a property - of a specific type, or the value couldn't be transformed to the same type - as the property being acted upon + +GHashTable * + +nm_setting_to_hash () +
+NMSetting * + +nm_setting_new_from_hash () +
+NMSetting * + +nm_setting_duplicate () +
const char * + +nm_setting_get_name () +
+gboolean + +nm_setting_verify () +
+gboolean + +nm_setting_compare () +
+gboolean + +nm_setting_diff () +
+void + +nm_setting_enumerate_values () +
+char * + +nm_setting_to_string () +
+void + +nm_setting_clear_secrets () +
+void + +nm_setting_clear_secrets_with_flags () +
+GPtrArray * + +nm_setting_need_secrets () +
+gboolean + +nm_setting_update_secrets () +
+gboolean + +nm_setting_get_secret_flags () +
+gboolean + +nm_setting_set_secret_flags () +
const char * + +nm_setting_get_virtual_iface_name ()
-
-
-

NM_SETTING_ERROR

-
#define NM_SETTING_ERROR nm_setting_error_quark ()
-
-

-

-
-
-
-

nm_setting_error_quark ()

-
GQuark              nm_setting_error_quark              (void);
-

-Registers an error quark for NMSetting if necessary. -

-
+
+

Properties

+
--+++ - - + + +

Returns :

the error quark used for NMSetting errors. +gchar *nameRead / Write
+
+

Types and Values

+
++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
enumNMSettingError
#defineNM_SETTING_ERROR
#defineNM_SETTING_NAME
enumNMSettingSecretFlags
enumNMSettingCompareFlags
 NMSetting
enumNMSettingHashFlags
enumNMSettingDiffResult
+
+
+

Object Hierarchy

+
    GEnum
+    ├── NMSettingCompareFlags
+    ├── NMSettingDiffResult
+    ├── NMSettingError
+    ├── NMSettingHashFlags
+    ╰── NMSettingSecretFlags
+    GObject
+    ╰── NMSetting
+        ├── NMSetting8021x
+        ├── NMSettingAdsl
+        ├── NMSettingBluetooth
+        ├── NMSettingBond
+        ├── NMSettingTeam
+        ├── NMSettingTeamPort
+        ├── NMSettingBridge
+        ├── NMSettingBridgePort
+        ├── NMSettingConnection
+        ├── NMSettingDcb
+        ├── NMSettingInfiniband
+        ├── NMSettingIP4Config
+        ├── NMSettingVlan
+        ├── NMSettingIP6Config
+        ├── NMSettingPPP
+        ├── NMSettingPPPOE
+        ├── NMSettingSerial
+        ├── NMSettingGeneric
+        ├── NMSettingGsm
+        ├── NMSettingCdma
+        ├── NMSettingOlpcMesh
+        ├── NMSettingWimax
+        ├── NMSettingWired
+        ├── NMSettingWireless
+        ├── NMSettingWirelessSecurity
+        ╰── NMSettingVPN
+
+
+
+

Includes

+
#include <nm-setting.h>
+
+
+
+

Description

+

Each NMSetting contains properties that describe configuration that applies +to a specific network layer (like IPv4 or IPv6 configuration) or device type +(like Ethernet, or Wi-Fi). A collection of individual settings together +make up an NMConnection. Each property is strongly typed and usually has +a number of allowed values. See each NMSetting subclass for a description +of properties and allowed values.

+
+
+

Functions

+
+

nm_setting_error_quark ()

+
GQuark
+nm_setting_error_quark (void);
+

Registers an error quark for NMSetting if necessary.

+
+

Returns

+

the error quark used for NMSetting errors.

+

+
+

NM_SETTING_PARAM_SERIALIZE

@@ -284,962 +368,1062 @@ Registers an error quark for -

NM_SETTING_NAME

-
#define NM_SETTING_NAME "name"
-
-

-

-
-
-
-

enum NMSettingSecretFlags

-
typedef enum {
-	NM_SETTING_SECRET_FLAG_NONE         = 0x00000000,
-	NM_SETTING_SECRET_FLAG_AGENT_OWNED  = 0x00000001,
-	NM_SETTING_SECRET_FLAG_NOT_SAVED    = 0x00000002,
-	NM_SETTING_SECRET_FLAG_NOT_REQUIRED = 0x00000004
-
-	/* NOTE: if adding flags, update nm-setting-private.h as well */
-} NMSettingSecretFlags;
-
-

-These flags indicate specific behavior related to handling of a secret. Each -secret has a corresponding set of these flags which indicate how the secret -is to be stored and/or requested when it is needed. -

-
+

NMSettingClearSecretsWithFlagsFn ()

+
gboolean
+(*NMSettingClearSecretsWithFlagsFn) (NMSetting *setting,
+                                     const char *secret,
+                                     NMSettingSecretFlags flags,
+                                     gpointer user_data);
+
+

Parameters

+
--+++ - - + + + - - + + + - - + + + - - + + +

NM_SETTING_SECRET_FLAG_NONE

the system is responsible for providing and -storing this secret (default) -

setting

The setting for which secrets are being iterated

 

NM_SETTING_SECRET_FLAG_AGENT_OWNED

a user secret agent is responsible -for providing and storing this secret; when it is required agents will be -asked to retrieve it -

secret

The secret's name

 

NM_SETTING_SECRET_FLAG_NOT_SAVED

this secret should not be saved, but -should be requested from the user each time it is needed -

flags

The secret's flags, eg NM_SETTING_SECRET_FLAG_AGENT_OWNED

 

NM_SETTING_SECRET_FLAG_NOT_REQUIRED

in situations where it cannot be -automatically determined that the secret is required (some VPNs and PPP -providers dont require all secrets) this flag indicates that the specific -secret is not required -

user_data

User data passed to nm_connection_clear_secrets_with_flags()

 
+
+

Returns

+

TRUE to clear the secret, FALSE to not clear the secret

+

+
+

-

enum NMSettingCompareFlags

-
typedef enum {
-	NM_SETTING_COMPARE_FLAG_EXACT = 0x00000000,
-	NM_SETTING_COMPARE_FLAG_FUZZY = 0x00000001,
-	NM_SETTING_COMPARE_FLAG_IGNORE_ID = 0x00000002,
-	NM_SETTING_COMPARE_FLAG_IGNORE_SECRETS = 0x00000004,
-	NM_SETTING_COMPARE_FLAG_IGNORE_AGENT_OWNED_SECRETS = 0x00000008,
-	NM_SETTING_COMPARE_FLAG_IGNORE_NOT_SAVED_SECRETS = 0x00000010,
-	NM_SETTING_COMPARE_FLAG_DIFF_RESULT_WITH_DEFAULT = 0x00000020,
-	NM_SETTING_COMPARE_FLAG_DIFF_RESULT_NO_DEFAULT = 0x00000040,
-
-	/* 0x80000000 is used for a private flag */
-} NMSettingCompareFlags;
-
-

-These flags modify the comparison behavior when comparing two settings or -two connections. -

-
+

NMSettingValueIterFn ()

+
void
+(*NMSettingValueIterFn) (NMSetting *setting,
+                         const char *key,
+                         const GValue *value,
+                         GParamFlags flags,
+                         gpointer user_data);
+
+

Parameters

+
--+++ - - - - - - - - - - - - - - + + + - - + + + - - + + + - - + + + - - + + +

NM_SETTING_COMPARE_FLAG_EXACT

match all properties exactly -

NM_SETTING_COMPARE_FLAG_FUZZY

match only important attributes, like SSID, - type, security settings, etc. Does not match, for example, connection ID - or UUID. -

NM_SETTING_COMPARE_FLAG_IGNORE_ID

ignore the connection's ID -

NM_SETTING_COMPARE_FLAG_IGNORE_SECRETS

ignore all secrets -

setting

The setting for which properties are being iterated, given to +nm_setting_enumerate_values()

 

NM_SETTING_COMPARE_FLAG_IGNORE_AGENT_OWNED_SECRETS

ignore secrets for which -the secret's flags indicate the secret is owned by a user secret agent -(ie, the secret's flag includes NM_SETTING_SECRET_FLAG_AGENT_OWNED) -

key

The value/property name

 

NM_SETTING_COMPARE_FLAG_IGNORE_NOT_SAVED_SECRETS

ignore secrets for which -the secret's flags indicate the secret should not be saved to persistent -storage (ie, the secret's flag includes NM_SETTING_SECRET_FLAG_NOT_SAVED) -

value

The property's value

 

NM_SETTING_COMPARE_FLAG_DIFF_RESULT_WITH_DEFAULT

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

flags

The property's flags, like NM_SETTING_PARAM_SECRET

 

NM_SETTING_COMPARE_FLAG_DIFF_RESULT_NO_DEFAULT

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

user_data

User data passed to nm_setting_enumerate_values()

 
-
-
-

NMSetting

-
typedef struct _NMSetting NMSetting;
-

-The NMSetting struct contains only private data. -It should only be accessed through the functions described below. -


-

NMSettingClearSecretsWithFlagsFn ()

-
gboolean            (*NMSettingClearSecretsWithFlagsFn) (NMSetting *setting,
-                                                         const char *secret,
-                                                         NMSettingSecretFlags flags,
-                                                         gpointer user_data);
-
+

nm_setting_to_hash ()

+
GHashTable *
+nm_setting_to_hash (NMSetting *setting,
+                    NMSettingHashFlags flags);
+

Converts the NMSetting into a GHashTable mapping each setting property +name to a GValue describing that property, suitable for marshalling over +D-Bus or serializing. The mapping is string to GValue.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + + + +

setting :

The setting for which secrets are being iterated

secret :

The secret's name

setting

the NMSetting

 

flags :

The secret's flags, eg NM_SETTING_SECRET_FLAG_AGENT_OWNED -

flags

hash flags, e.g. NM_SETTING_HASH_FLAG_ALL

 
+
+
+

Returns

+

a new GHashTable +describing the setting's properties.

+

[transfer full][element-type utf8 GObject.Value]

+
+
+
+
+

nm_setting_new_from_hash ()

+
NMSetting *
+nm_setting_new_from_hash (GType setting_type,
+                          GHashTable *hash);
+

Creates a new NMSetting object and populates that object with the properties +contained in the hash table, using each hash key as the property to set, +and each hash value as the value to set that property to. Setting properties +are strongly typed, thus the GValue type of the hash value must be correct. +See the documentation on each NMSetting object subclass for the correct +property names and value types.

+
+

Parameters

+
+++++ + - - + + + - - + + +

user_data :

User data passed to nm_connection_clear_secrets_with_flags() -

setting_type

the NMSetting type which the hash contains properties for

 

Returns :

-TRUE to clear the secret, FALSE to not clear the secret

hash

the GHashTable containing a +string to GValue mapping of properties that apply to the setting.

[element-type utf8 GObject.Value]
+
+

Returns

+

a new NMSetting object populated with the properties from the +hash table, or NULL on failure

+

+
+

-

NMSettingClass

-
typedef struct {
-	GObjectClass parent;
-
-	/* Virtual functions */
-	gint        (*verify)            (NMSetting  *setting,
-	                                  GSList     *all_settings,
-	                                  GError     **error);
-
-	GPtrArray  *(*need_secrets)      (NMSetting  *setting);
-
-	int         (*update_one_secret) (NMSetting  *setting,
-	                                  const char *key,
-	                                  GValue     *value,
-	                                  GError    **error);
-
-	gboolean    (*get_secret_flags)  (NMSetting  *setting,
-	                                  const char *secret_name,
-	                                  gboolean verify_secret,
-	                                  NMSettingSecretFlags *out_flags,
-	                                  GError **error);
-
-	gboolean    (*set_secret_flags)  (NMSetting  *setting,
-	                                  const char *secret_name,
-	                                  gboolean verify_secret,
-	                                  NMSettingSecretFlags flags,
-	                                  GError **error);
-
-	/* Returns TRUE if the given property contains the same value in both settings */
-	gboolean    (*compare_property)  (NMSetting *setting,
-	                                  NMSetting *other,
-	                                  const GParamSpec *prop_spec,
-	                                  NMSettingCompareFlags flags);
-
-	gboolean    (*clear_secrets_with_flags) (NMSetting *setting,
-	                                         GParamSpec *pspec,
-	                                         NMSettingClearSecretsWithFlagsFn func,
-	                                         gpointer user_data);
-
-	const char *(*get_virtual_iface_name) (NMSetting *setting);
-
-	/* Padding for future expansion */
-	void (*_reserved1) (void);
-} NMSettingClass;
-
-

-

+

nm_setting_duplicate ()

+
NMSetting *
+nm_setting_duplicate (NMSetting *setting);
+

Duplicates a NMSetting.

+
+

Parameters

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

setting

the NMSetting to duplicate

 
+
+
+

Returns

+

a new NMSetting containing the same properties and values as the +source NMSetting.

+

[transfer full]

+
+
+
+
+

nm_setting_get_name ()

+
const char *
+nm_setting_get_name (NMSetting *setting);
+

Returns the type name of the NMSetting object

+
+

Parameters

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

setting

the NMSetting

 
+
+
+

Returns

+

a string containing the type name of the NMSetting object, +like 'ppp' or 'wireless' or 'wired'.

+

+

-

NMSettingValueIterFn ()

-
void                (*NMSettingValueIterFn)             (NMSetting *setting,
-                                                         const char *key,
-                                                         const GValue *value,
-                                                         GParamFlags flags,
-                                                         gpointer user_data);
-
+

nm_setting_verify ()

+
gboolean
+nm_setting_verify (NMSetting *setting,
+                   GSList *all_settings,
+                   GError **error);
+

Validates the setting. Each setting's properties have allowed values, and +some are dependent on other values (hence the need for all_settings +). The +returned GError contains information about which property of the setting +failed validation, and in what way that property failed validation.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + + - - - - - - + + +

setting :

The setting for which properties are being iterated, given to -nm_setting_enumerate_values() -

key :

The value/property name

setting

the NMSetting to verify

 

value :

The property's value

all_settings

a GSList of all settings +in the connection from which setting +came.

[element-type NMSetting]

flags :

The property's flags, like NM_SETTING_PARAM_SECRET -

user_data :

User data passed to nm_setting_enumerate_values() -

error

location to store error, or NULL

 
+
+

Returns

+

TRUE if the setting is valid, FALSE if it is not

+

+
+

-

enum NMSettingHashFlags

-
typedef enum {
-	NM_SETTING_HASH_FLAG_ALL = 0x00000000,
-	NM_SETTING_HASH_FLAG_NO_SECRETS = 0x00000001,
-	NM_SETTING_HASH_FLAG_ONLY_SECRETS = 0x00000002,
-} NMSettingHashFlags;
-
-

-These flags determine which properties are added to the resulting hash -when calling nm_setting_to_hash(). -

-
+

nm_setting_compare ()

+
gboolean
+nm_setting_compare (NMSetting *a,
+                    NMSetting *b,
+                    NMSettingCompareFlags flags);
+

Compares two NMSetting objects for similarity, with comparison behavior +modified by a set of flags. See the documentation for NMSettingCompareFlags +for a description of each flag's behavior.

+
+

Parameters

+
--+++ - - + + + - - + + + - - + + +

NM_SETTING_HASH_FLAG_ALL

hash all properties (including secrets) -

a

a NMSetting

 

NM_SETTING_HASH_FLAG_NO_SECRETS

do not include secrets -

b

a second NMSetting to compare with the first

 

NM_SETTING_HASH_FLAG_ONLY_SECRETS

only hash secrets -

flags

compare flags, e.g. NM_SETTING_COMPARE_FLAG_EXACT

 
+
+

Returns

+

TRUE if the comparison succeeds, FALSE if it does not

+

+
+
-

nm_setting_to_hash ()

-
GHashTable *        nm_setting_to_hash                  (NMSetting *setting,
-                                                         NMSettingHashFlags flags);
-

-Converts the NMSetting into a GHashTable mapping each setting property -name to a GValue describing that property, suitable for marshalling over -D-Bus or serializing. The mapping is string to GValue. -

-
+

nm_setting_diff ()

+
gboolean
+nm_setting_diff (NMSetting *a,
+                 NMSetting *b,
+                 NMSettingCompareFlags flags,
+                 gboolean invert_results,
+                 GHashTable **results);
+

Compares two NMSetting objects for similarity, with comparison behavior +modified by a set of flags. See the documentation for NMSettingCompareFlags +for a description of each flag's behavior. If the settings differ, the keys +of each setting that differ from the other are added to results +, mapped to +one or more NMSettingDiffResult values.

+
+

Parameters

+
--+++ - - + + + - - + + + - - + + + + + + + + + + + + +

setting :

the NMSetting -

a

a NMSetting

 

flags :

hash flags, e.g. NM_SETTING_HASH_FLAG_ALL -

b

a second NMSetting to compare with the first

 

Returns :

a new GHashTable -describing the setting's properties. [transfer full][element-type utf8 GObject.Value] -

flags

compare flags, e.g. NM_SETTING_COMPARE_FLAG_EXACT

 

invert_results

this parameter is used internally by libnm-util and should +be set to FALSE. If TRUE inverts the meaning of the NMSettingDiffResult.

 

results

if the +settings differ, on return a hash table mapping the differing keys to one or +more NMSettingDiffResult values OR-ed together. If the settings do not +differ, any hash table passed in is unmodified. If no hash table is passed +in and the settings differ, a new one is created and returned.

[inout][transfer full][element-type utf8 guint32]
+
+

Returns

+

TRUE if the settings contain the same values, FALSE if they do not

+

+
+
-

nm_setting_new_from_hash ()

-
NMSetting *         nm_setting_new_from_hash            (GType setting_type,
-                                                         GHashTable *hash);
-

-Creates a new NMSetting object and populates that object with the properties -contained in the hash table, using each hash key as the property to set, -and each hash value as the value to set that property to. Setting properties -are strongly typed, thus the GValue type of the hash value must be correct. -See the documentation on each NMSetting object subclass for the correct -property names and value types. -

-
+

nm_setting_enumerate_values ()

+
void
+nm_setting_enumerate_values (NMSetting *setting,
+                             NMSettingValueIterFn func,
+                             gpointer user_data);
+

Iterates over each property of the NMSetting object, calling the supplied +user function for each property.

+
+

Parameters

+
--+++ - - + + + - - + + + - - + + +

setting_type :

the NMSetting type which the hash contains properties for

setting

the NMSetting

 

hash :

the GHashTable containing a -string to GValue mapping of properties that apply to the setting. [element-type utf8 GObject.Value] -

func

user-supplied function called for each property of the setting.

[scope call]

Returns :

a new NMSetting object populated with the properties from the -hash table, or NULL on failure

user_data

user data passed to func +at each invocation

 
+
-

nm_setting_duplicate ()

-
NMSetting *         nm_setting_duplicate                (NMSetting *setting);
-

-Duplicates a NMSetting. -

-
+

nm_setting_to_string ()

+
char *
+nm_setting_to_string (NMSetting *setting);
+

Convert the setting into a string. For debugging purposes ONLY, should NOT +be used for serialization of the setting, or machine-parsed in any way. The +output format is not guaranteed to be stable and may change at any time.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSetting to duplicate

Returns :

a new NMSetting containing the same properties and values as the -source NMSetting. [transfer full] -

setting

the NMSetting

 
+
+

Returns

+

an allocated string containing a textual representation of the +setting's properties and values (including secrets!), which the caller should +free with g_free()

+

+
+
-

nm_setting_get_name ()

-
const char *        nm_setting_get_name                 (NMSetting *setting);
-

-Returns the type name of the NMSetting object -

-
+

nm_setting_clear_secrets ()

+
void
+nm_setting_clear_secrets (NMSetting *setting);
+

Resets and clears any secrets in the setting. Secrets should be added to the +setting only when needed, and cleared immediately after use to prevent +leakage of information.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSetting -

Returns :

a string containing the type name of the NMSetting object, -like 'ppp' or 'wireless' or 'wired'.

setting

the NMSetting

 
+
-

nm_setting_verify ()

-
gboolean            nm_setting_verify                   (NMSetting *setting,
-                                                         GSList *all_settings,
-                                                         GError **error);
-

-Validates the setting. Each setting's properties have allowed values, and -some are dependent on other values (hence the need for all_settings). The -returned GError contains information about which property of the setting -failed validation, and in what way that property failed validation. -

-
+

nm_setting_clear_secrets_with_flags ()

+
void
+nm_setting_clear_secrets_with_flags (NMSetting *setting,
+                                     NMSettingClearSecretsWithFlagsFn func,
+                                     gpointer user_data);
+

Clears and frees secrets determined by func +.

+
+

Parameters

+
--+++ - - + + + - - - - - - + + + - - + + +

setting :

the NMSetting to verify

setting

the NMSetting

 

all_settings :

a GSList of all settings -in the connection from which setting came. [element-type NMSetting] -

error :

location to store error, or NULL -

func

function to be called to determine whether a +specific secret should be cleared or not.

[scope call]

Returns :

-TRUE if the setting is valid, FALSE if it is not

user_data

caller-supplied data passed to func +

 
+
-

nm_setting_compare ()

-
gboolean            nm_setting_compare                  (NMSetting *a,
-                                                         NMSetting *b,
-                                                         NMSettingCompareFlags flags);
-

-Compares two NMSetting objects for similarity, with comparison behavior -modified by a set of flags. See the documentation for NMSettingCompareFlags -for a description of each flag's behavior. -

-
+

nm_setting_need_secrets ()

+
GPtrArray *
+nm_setting_need_secrets (NMSetting *setting);
+

Returns an array of property names for each secret which may be required +to make a successful connection. The returned hints are only intended as a +guide to what secrets may be required, because in some circumstances, there +is no way to conclusively determine exactly which secrets are needed.

+
+

Parameters

+
--++++ + + + + + +

setting

the NMSetting

 
+
+
+

Returns

+

a GPtrArray containing +the property names of secrets of the NMSetting which may be required; the +caller owns the array and must free it with g_ptr_array_free(), but must not +free the elements.

+

[transfer container][element-type utf8]

+
+ +
+
+

nm_setting_update_secrets ()

+
gboolean
+nm_setting_update_secrets (NMSetting *setting,
+                           GHashTable *secrets,
+                           GError **error);
+

Update the setting's secrets, given a hash table of secrets intended for that +setting (deserialized from D-Bus for example).

+
+

Parameters

+
++++ - - - - - - + + + - - + + + - - + + +

a :

a NMSetting -

b :

a second NMSetting to compare with the first

setting

the NMSetting

 

flags :

compare flags, e.g. NM_SETTING_COMPARE_FLAG_EXACT -

secrets

a GHashTable mapping +string to GValue of setting property names and secrets.

[element-type utf8 GObject.Value]

Returns :

-TRUE if the comparison succeeds, FALSE if it does not

error

location to store error, or NULL

 
+
+

Returns

+

TRUE if the secrets were successfully updated, FALSE on failure to +update one or more of the secrets.

+

+
+

-

enum NMSettingDiffResult

-
typedef enum {
-	NM_SETTING_DIFF_RESULT_UNKNOWN = 0x00000000,
-	NM_SETTING_DIFF_RESULT_IN_A =    0x00000001,
-	NM_SETTING_DIFF_RESULT_IN_B =    0x00000002,
-	NM_SETTING_DIFF_RESULT_IN_A_DEFAULT = 0x00000004,
-	NM_SETTING_DIFF_RESULT_IN_B_DEFAULT = 0x00000004,
-} NMSettingDiffResult;
-
-

-These values indicate the result of a setting difference operation. -

-
+

nm_setting_get_secret_flags ()

+
gboolean
+nm_setting_get_secret_flags (NMSetting *setting,
+                             const char *secret_name,
+                             NMSettingSecretFlags *out_flags,
+                             GError **error);
+

For a given secret, retrieves the NMSettingSecretFlags describing how to +handle that secret.

+
+

Parameters

+
--+++ - - + + + - - + + + - - + + + - - - - - - + + +

NM_SETTING_DIFF_RESULT_UNKNOWN

unknown result -

setting

the NMSetting

 

NM_SETTING_DIFF_RESULT_IN_A

the property is present in setting A -

secret_name

the secret key name to get flags for

 

NM_SETTING_DIFF_RESULT_IN_B

the property is present in setting B -

out_flags

on success, the NMSettingSecretFlags for the secret

 

NM_SETTING_DIFF_RESULT_IN_A_DEFAULT

the property is present in -setting A but is set to the default value. This flag is only set, -if you specify NM_SETTING_COMPARE_FLAG_DIFF_RESULT_WITH_DEFAULT. -

NM_SETTING_DIFF_RESULT_IN_B_DEFAULT

analog to NM_SETTING_DIFF_RESULT_IN_A_DEFAULT. -

error

location to store error, or NULL

 
+
+

Returns

+

TRUE on success (if the given secret name was a valid property of +this setting, and if that property is secret), FALSE if not

+

+
+
-

nm_setting_diff ()

-
gboolean            nm_setting_diff                     (NMSetting *a,
-                                                         NMSetting *b,
-                                                         NMSettingCompareFlags flags,
-                                                         gboolean invert_results,
-                                                         GHashTable **results);
-

-Compares two NMSetting objects for similarity, with comparison behavior -modified by a set of flags. See the documentation for NMSettingCompareFlags -for a description of each flag's behavior. If the settings differ, the keys -of each setting that differ from the other are added to results, mapped to -one or more NMSettingDiffResult values. -

-
+

nm_setting_set_secret_flags ()

+
gboolean
+nm_setting_set_secret_flags (NMSetting *setting,
+                             const char *secret_name,
+                             NMSettingSecretFlags flags,
+                             GError **error);
+

For a given secret, stores the NMSettingSecretFlags describing how to +handle that secret.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + - - + + + - - + + + - - + + +

a :

a NMSetting -

b :

a second NMSetting to compare with the first

flags :

compare flags, e.g. NM_SETTING_COMPARE_FLAG_EXACT -

setting

the NMSetting

 

invert_results :

this parameter is used internally by libnm-util and should -be set to FALSE. If TRUE inverts the meaning of the NMSettingDiffResult.

secret_name

the secret key name to set flags for

 

results :

if the -settings differ, on return a hash table mapping the differing keys to one or -more NMSettingDiffResult values OR-ed together. If the settings do not -differ, any hash table passed in is unmodified. If no hash table is passed -in and the settings differ, a new one is created and returned. [inout][transfer full][element-type utf8 guint32] -

flags

the NMSettingSecretFlags for the secret

 

Returns :

-TRUE if the settings contain the same values, FALSE if they do not

error

location to store error, or NULL

 
+
+

Returns

+

TRUE on success (if the given secret name was a valid property of +this setting, and if that property is secret), FALSE if not

+

+
+
-

nm_setting_enumerate_values ()

-
void                nm_setting_enumerate_values         (NMSetting *setting,
-                                                         NMSettingValueIterFn func,
-                                                         gpointer user_data);
-

-Iterates over each property of the NMSetting object, calling the supplied -user function for each property. -

-
+

nm_setting_get_virtual_iface_name ()

+
const char *
+nm_setting_get_virtual_iface_name (NMSetting *setting);
+

Returns the name of the virtual kernel interface which the connection +needs to use if specified in the settings.

+
+

Parameters

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

setting

the NMSetting

 
+
+
+

Returns

+

Name of the virtual interface or NULL if the setting does not +support this feature

+

+
+ + +
+

Types and Values

+
+

enum NMSettingError

+

Describes errors that may result from operations involving a NMSetting.

+
+

Members

+
--+++ - - + + - - + + - - - - -

setting :

the NMSetting +

NM_SETTING_ERROR_UNKNOWN

+

unknown or unclassified error

 

func :

user-supplied function called for each property of the setting. [scope call] +

NM_SETTING_ERROR_PROPERTY_NOT_FOUND

+

a property required by the operation + was not found; for example, an attempt to update an invalid secret

 

user_data :

user data passed to func at each invocation
-
-
-
-

nm_setting_to_string ()

-
char *              nm_setting_to_string                (NMSetting *setting);
-

-Convert the setting into a string. For debugging purposes ONLY, should NOT -be used for serialization of the setting, or machine-parsed in any way. The -output format is not guaranteed to be stable and may change at any time. -

-
---- - - - - + + - - + +

setting :

the NMSetting +

NM_SETTING_ERROR_PROPERTY_NOT_SECRET

+

an operation which requires a secret + was attempted on a non-secret property

 

Returns :

an allocated string containing a textual representation of the -setting's properties and values (including secrets!), which the caller should -free with g_free() +

NM_SETTING_ERROR_PROPERTY_TYPE_MISMATCH

+

the operation requires a property + of a specific type, or the value couldn't be transformed to the same type + as the property being acted upon

 
+

-

nm_setting_clear_secrets ()

-
void                nm_setting_clear_secrets            (NMSetting *setting);
+

NM_SETTING_ERROR

+
#define NM_SETTING_ERROR nm_setting_error_quark ()
+

-Resets and clears any secrets in the setting. Secrets should be added to the -setting only when needed, and cleared immediately after use to prevent -leakage of information.

-
---- - - - - -

setting :

the NMSetting -

-

nm_setting_clear_secrets_with_flags ()

-
void                nm_setting_clear_secrets_with_flags (NMSetting *setting,
-                                                         NMSettingClearSecretsWithFlagsFn func,
-                                                         gpointer user_data);
+

NM_SETTING_NAME

+
#define NM_SETTING_NAME "name"
+

-Clears and frees secrets determined by func.

-
+ +
+
+

enum NMSettingSecretFlags

+

These flags indicate specific behavior related to handling of a secret. Each +secret has a corresponding set of these flags which indicate how the secret +is to be stored and/or requested when it is needed.

+
+

Members

+
--+++ - - + + - - + + - - + + + + + + +

setting :

the NMSetting +

NM_SETTING_SECRET_FLAG_NONE

+

the system is responsible for providing and +storing this secret (default)

 

func :

function to be called to determine whether a -specific secret should be cleared or not. [scope call] +

NM_SETTING_SECRET_FLAG_AGENT_OWNED

+

a user secret agent is responsible +for providing and storing this secret; when it is required agents will be +asked to retrieve it

 

user_data :

caller-supplied data passed to func +

NM_SETTING_SECRET_FLAG_NOT_SAVED

+

this secret should not be saved, but +should be requested from the user each time it is needed

 

NM_SETTING_SECRET_FLAG_NOT_REQUIRED

+

in situations where it cannot be +automatically determined that the secret is required (some VPNs and PPP +providers dont require all secrets) this flag indicates that the specific +secret is not required

+
 
+

-

nm_setting_need_secrets ()

-
GPtrArray *         nm_setting_need_secrets             (NMSetting *setting);
-

-Returns an array of property names for each secret which may be required -to make a successful connection. The returned hints are only intended as a -guide to what secrets may be required, because in some circumstances, there -is no way to conclusively determine exactly which secrets are needed. -

-
+

enum NMSettingCompareFlags

+

These flags modify the comparison behavior when comparing two settings or +two connections.

+
+

Members

+
--+++ - - + + - - + + + + + + + + + + + + - -

setting :

the NMSetting +

NM_SETTING_COMPARE_FLAG_EXACT

+

match all properties exactly

 

Returns :

a GPtrArray containing -the property names of secrets of the NMSetting which may be required; the -caller owns the array and must free it with g_ptr_array_free(), but must not -free the elements. [transfer container][element-type utf8] +

NM_SETTING_COMPARE_FLAG_FUZZY

+

match only important attributes, like SSID, + type, security settings, etc. Does not match, for example, connection ID + or UUID.

 

NM_SETTING_COMPARE_FLAG_IGNORE_ID

+

ignore the connection's ID

+
 

NM_SETTING_COMPARE_FLAG_IGNORE_SECRETS

+

ignore all secrets

+
 
-
-
-
-

nm_setting_update_secrets ()

-
gboolean            nm_setting_update_secrets           (NMSetting *setting,
-                                                         GHashTable *secrets,
-                                                         GError **error);
-

-Update the setting's secrets, given a hash table of secrets intended for that -setting (deserialized from D-Bus for example). -

-
---- - - - + + - - + + - - + + - - + + +

setting :

the NMSetting +

NM_SETTING_COMPARE_FLAG_IGNORE_AGENT_OWNED_SECRETS

+

ignore secrets for which +the secret's flags indicate the secret is owned by a user secret agent +(ie, the secret's flag includes NM_SETTING_SECRET_FLAG_AGENT_OWNED +)

 

secrets :

a GHashTable mapping -string to GValue of setting property names and secrets. [element-type utf8 GObject.Value] +

NM_SETTING_COMPARE_FLAG_IGNORE_NOT_SAVED_SECRETS

+

ignore secrets for which +the secret's flags indicate the secret should not be saved to persistent +storage (ie, the secret's flag includes NM_SETTING_SECRET_FLAG_NOT_SAVED +)

 

error :

location to store error, or NULL +

NM_SETTING_COMPARE_FLAG_DIFF_RESULT_WITH_DEFAULT

+

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

 

Returns :

-TRUE if the secrets were successfully updated, FALSE on failure to -update one or more of the secrets.

NM_SETTING_COMPARE_FLAG_DIFF_RESULT_NO_DEFAULT

+

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

+
 
+
-

nm_setting_get_secret_flags ()

-
gboolean            nm_setting_get_secret_flags         (NMSetting *setting,
-                                                         const char *secret_name,
-                                                         NMSettingSecretFlags *out_flags,
-                                                         GError **error);
-

-For a given secret, retrieves the NMSettingSecretFlags describing how to -handle that secret. -

-
+

NMSetting

+
typedef struct _NMSetting NMSetting;
+

The NMSetting struct contains only private data. +It should only be accessed through the functions described below.

+ +
+
+

enum NMSettingHashFlags

+

These flags determine which properties are added to the resulting hash +when calling nm_setting_to_hash().

+
+

Members

+
--+++ - - + + - - - - - - - - - - + + - - + + +

setting :

the NMSetting +

NM_SETTING_HASH_FLAG_ALL

+

hash all properties (including secrets)

 

secret_name :

the secret key name to get flags for

out_flags :

on success, the NMSettingSecretFlags for the secret

error :

location to store error, or NULL +

NM_SETTING_HASH_FLAG_NO_SECRETS

+

do not include secrets

 

Returns :

-TRUE on success (if the given secret name was a valid property of -this setting, and if that property is secret), FALSE if not

NM_SETTING_HASH_FLAG_ONLY_SECRETS

+

only hash secrets

+
 
+
-

nm_setting_set_secret_flags ()

-
gboolean            nm_setting_set_secret_flags         (NMSetting *setting,
-                                                         const char *secret_name,
-                                                         NMSettingSecretFlags flags,
-                                                         GError **error);
-

-For a given secret, stores the NMSettingSecretFlags describing how to -handle that secret. -

-
+

enum NMSettingDiffResult

+

These values indicate the result of a setting difference operation.

+
+

Members

+
--+++ - - + + - - - - - - + + + - - + + - - - - -

setting :

the NMSetting +

NM_SETTING_DIFF_RESULT_UNKNOWN

+

unknown result

 

secret_name :

the secret key name to set flags for

flags :

the NMSettingSecretFlags for the secret

NM_SETTING_DIFF_RESULT_IN_A

+

the property is present in setting A

+
 

error :

location to store error, or NULL +

NM_SETTING_DIFF_RESULT_IN_B

+

the property is present in setting B

 

Returns :

-TRUE on success (if the given secret name was a valid property of -this setting, and if that property is secret), FALSE if not
-
-
-
-

nm_setting_get_virtual_iface_name ()

-
const char *        nm_setting_get_virtual_iface_name   (NMSetting *setting);
-

-Returns the name of the virtual kernel interface which the connection -needs to use if specified in the settings. -

-
---- - - - - + + - - + + +

setting :

the NMSetting +

NM_SETTING_DIFF_RESULT_IN_A_DEFAULT

+

the property is present in +setting A but is set to the default value. This flag is only set, +if you specify NM_SETTING_COMPARE_FLAG_DIFF_RESULT_WITH_DEFAULT +.

 

Returns :

Name of the virtual interface or NULL if the setting does not -support this feature

NM_SETTING_DIFF_RESULT_IN_B_DEFAULT

+

analog to NM_SETTING_DIFF_RESULT_IN_A_DEFAULT +.

+
 
+

Property Details

-

The "name" property

-
  "name"                     gchar*                : Read / Write
-

-The setting's name, which uniquely identifies the setting within the +

The “name” property

+
  “name”                     gchar *
+

The setting's name, which uniquely identifies the setting within the connection. Each setting type has a name unique to that type, for -example "ppp" or "wireless" or "wired". -

+example "ppp" or "wireless" or "wired".

+

Flags: Read / Write

Default value: NULL

+ Generated by GTK-Doc V1.21 \ No newline at end of file diff --git a/docs/libnm-util/html/NMSetting8021x.html b/docs/libnm-util/html/NMSetting8021x.html index 10ee02e0..ba9dbe10 100644 --- a/docs/libnm-util/html/NMSetting8021x.html +++ b/docs/libnm-util/html/NMSetting8021x.html @@ -2,34 +2,28 @@ -NMSetting8021x +libnm-util Reference Manual: NMSetting8021x - + - - - - - - - - - - + + + + + + +
@@ -37,3295 +31,3920 @@

NMSetting8021x

NMSetting8021x — Describes 802.1x-authenticated connection properties

- +
-
-

Synopsis

-
-#include <nm-setting-8021x.h>
-
-enum                NMSetting8021xCKFormat;
-enum                NMSetting8021xCKScheme;
-#define             NM_SETTING_802_1X_SETTING_NAME
-enum                NMSetting8021xError;
-#define             NM_SETTING_802_1X_ERROR
-GQuark              nm_setting_802_1x_error_quark       (void);
-#define             NM_SETTING_802_1X_EAP
-#define             NM_SETTING_802_1X_IDENTITY
-#define             NM_SETTING_802_1X_ANONYMOUS_IDENTITY
-#define             NM_SETTING_802_1X_PAC_FILE
-#define             NM_SETTING_802_1X_CA_CERT
-#define             NM_SETTING_802_1X_CA_PATH
-#define             NM_SETTING_802_1X_SUBJECT_MATCH
-#define             NM_SETTING_802_1X_ALTSUBJECT_MATCHES
-#define             NM_SETTING_802_1X_CLIENT_CERT
-#define             NM_SETTING_802_1X_PHASE1_PEAPVER
-#define             NM_SETTING_802_1X_PHASE1_PEAPLABEL
-#define             NM_SETTING_802_1X_PHASE1_FAST_PROVISIONING
-#define             NM_SETTING_802_1X_PHASE2_AUTH
-#define             NM_SETTING_802_1X_PHASE2_AUTHEAP
-#define             NM_SETTING_802_1X_PHASE2_CA_CERT
-#define             NM_SETTING_802_1X_PHASE2_CA_PATH
-#define             NM_SETTING_802_1X_PHASE2_SUBJECT_MATCH
-#define             NM_SETTING_802_1X_PHASE2_ALTSUBJECT_MATCHES
-#define             NM_SETTING_802_1X_PHASE2_CLIENT_CERT
-#define             NM_SETTING_802_1X_PASSWORD
-#define             NM_SETTING_802_1X_PASSWORD_FLAGS
-#define             NM_SETTING_802_1X_PASSWORD_RAW
-#define             NM_SETTING_802_1X_PASSWORD_RAW_FLAGS
-#define             NM_SETTING_802_1X_PRIVATE_KEY
-#define             NM_SETTING_802_1X_PRIVATE_KEY_PASSWORD
-#define             NM_SETTING_802_1X_PRIVATE_KEY_PASSWORD_FLAGS
-#define             NM_SETTING_802_1X_PHASE2_PRIVATE_KEY
-#define             NM_SETTING_802_1X_PHASE2_PRIVATE_KEY_PASSWORD
-#define             NM_SETTING_802_1X_PHASE2_PRIVATE_KEY_PASSWORD_FLAGS
-#define             NM_SETTING_802_1X_PIN
-#define             NM_SETTING_802_1X_PIN_FLAGS
-#define             NM_SETTING_802_1X_SYSTEM_CA_CERTS
-                    NMSetting8021x;
-                    NMSetting8021xClass;
-NMSetting *         nm_setting_802_1x_new               (void);
-guint32             nm_setting_802_1x_get_num_eap_methods
-                                                        (NMSetting8021x *setting);
-const char *        nm_setting_802_1x_get_eap_method    (NMSetting8021x *setting,
-                                                         guint32 i);
-gboolean            nm_setting_802_1x_add_eap_method    (NMSetting8021x *setting,
-                                                         const char *eap);
-void                nm_setting_802_1x_remove_eap_method (NMSetting8021x *setting,
-                                                         guint32 i);
-gboolean            nm_setting_802_1x_remove_eap_method_by_value
-                                                        (NMSetting8021x *setting,
-                                                         const char *eap);
-void                nm_setting_802_1x_clear_eap_methods (NMSetting8021x *setting);
-const char *        nm_setting_802_1x_get_identity      (NMSetting8021x *setting);
-const char *        nm_setting_802_1x_get_anonymous_identity
-                                                        (NMSetting8021x *setting);
-const char *        nm_setting_802_1x_get_pac_file      (NMSetting8021x *setting);
-gboolean            nm_setting_802_1x_get_system_ca_certs
-                                                        (NMSetting8021x *setting);
-const char *        nm_setting_802_1x_get_ca_path       (NMSetting8021x *setting);
-const char *        nm_setting_802_1x_get_phase2_ca_path
-                                                        (NMSetting8021x *setting);
-NMSetting8021xCKScheme nm_setting_802_1x_get_ca_cert_scheme
-                                                        (NMSetting8021x *setting);
-const GByteArray *  nm_setting_802_1x_get_ca_cert_blob  (NMSetting8021x *setting);
-const char *        nm_setting_802_1x_get_ca_cert_path  (NMSetting8021x *setting);
-gboolean            nm_setting_802_1x_set_ca_cert       (NMSetting8021x *setting,
-                                                         const char *cert_path,
-                                                         NMSetting8021xCKScheme scheme,
-                                                         NMSetting8021xCKFormat *out_format,
-                                                         GError **error);
-const char *        nm_setting_802_1x_get_subject_match (NMSetting8021x *setting);
-guint32             nm_setting_802_1x_get_num_altsubject_matches
-                                                        (NMSetting8021x *setting);
-const char *        nm_setting_802_1x_get_altsubject_match
-                                                        (NMSetting8021x *setting,
-                                                         guint32 i);
-gboolean            nm_setting_802_1x_add_altsubject_match
-                                                        (NMSetting8021x *setting,
-                                                         const char *altsubject_match);
-void                nm_setting_802_1x_remove_altsubject_match
-                                                        (NMSetting8021x *setting,
-                                                         guint32 i);
-gboolean            nm_setting_802_1x_remove_altsubject_match_by_value
-                                                        (NMSetting8021x *setting,
-                                                         const char *altsubject_match);
-void                nm_setting_802_1x_clear_altsubject_matches
-                                                        (NMSetting8021x *setting);
-NMSetting8021xCKScheme nm_setting_802_1x_get_client_cert_scheme
-                                                        (NMSetting8021x *setting);
-const GByteArray *  nm_setting_802_1x_get_client_cert_blob
-                                                        (NMSetting8021x *setting);
-const char *        nm_setting_802_1x_get_client_cert_path
-                                                        (NMSetting8021x *setting);
-gboolean            nm_setting_802_1x_set_client_cert   (NMSetting8021x *setting,
-                                                         const char *cert_path,
-                                                         NMSetting8021xCKScheme scheme,
-                                                         NMSetting8021xCKFormat *out_format,
-                                                         GError **error);
-const char *        nm_setting_802_1x_get_phase1_peapver
-                                                        (NMSetting8021x *setting);
-const char *        nm_setting_802_1x_get_phase1_peaplabel
-                                                        (NMSetting8021x *setting);
-const char *        nm_setting_802_1x_get_phase1_fast_provisioning
-                                                        (NMSetting8021x *setting);
-const char *        nm_setting_802_1x_get_phase2_auth   (NMSetting8021x *setting);
-const char *        nm_setting_802_1x_get_phase2_autheap
-                                                        (NMSetting8021x *setting);
-NMSetting8021xCKScheme nm_setting_802_1x_get_phase2_ca_cert_scheme
-                                                        (NMSetting8021x *setting);
-const GByteArray *  nm_setting_802_1x_get_phase2_ca_cert_blob
-                                                        (NMSetting8021x *setting);
-const char *        nm_setting_802_1x_get_phase2_ca_cert_path
-                                                        (NMSetting8021x *setting);
-gboolean            nm_setting_802_1x_set_phase2_ca_cert
-                                                        (NMSetting8021x *setting,
-                                                         const char *cert_path,
-                                                         NMSetting8021xCKScheme scheme,
-                                                         NMSetting8021xCKFormat *out_format,
-                                                         GError **error);
-const char *        nm_setting_802_1x_get_phase2_subject_match
-                                                        (NMSetting8021x *setting);
-guint32             nm_setting_802_1x_get_num_phase2_altsubject_matches
-                                                        (NMSetting8021x *setting);
-const char *        nm_setting_802_1x_get_phase2_altsubject_match
-                                                        (NMSetting8021x *setting,
-                                                         guint32 i);
-gboolean            nm_setting_802_1x_add_phase2_altsubject_match
-                                                        (NMSetting8021x *setting,
-                                                         const char *phase2_altsubject_match);
-void                nm_setting_802_1x_remove_phase2_altsubject_match
-                                                        (NMSetting8021x *setting,
-                                                         guint32 i);
-gboolean            nm_setting_802_1x_remove_phase2_altsubject_match_by_value
-                                                        (NMSetting8021x *setting,
-                                                         const char *phase2_altsubject_match);
-void                nm_setting_802_1x_clear_phase2_altsubject_matches
-                                                        (NMSetting8021x *setting);
-NMSetting8021xCKScheme nm_setting_802_1x_get_phase2_client_cert_scheme
-                                                        (NMSetting8021x *setting);
-const GByteArray *  nm_setting_802_1x_get_phase2_client_cert_blob
-                                                        (NMSetting8021x *setting);
-const char *        nm_setting_802_1x_get_phase2_client_cert_path
-                                                        (NMSetting8021x *setting);
-gboolean            nm_setting_802_1x_set_phase2_client_cert
-                                                        (NMSetting8021x *setting,
-                                                         const char *cert_path,
-                                                         NMSetting8021xCKScheme scheme,
-                                                         NMSetting8021xCKFormat *out_format,
-                                                         GError **error);
-const char *        nm_setting_802_1x_get_password      (NMSetting8021x *setting);
-NMSettingSecretFlags nm_setting_802_1x_get_password_flags
-                                                        (NMSetting8021x *setting);
-const GByteArray *  nm_setting_802_1x_get_password_raw  (NMSetting8021x *setting);
-NMSettingSecretFlags nm_setting_802_1x_get_password_raw_flags
-                                                        (NMSetting8021x *setting);
-const char *        nm_setting_802_1x_get_pin           (NMSetting8021x *setting);
-NMSettingSecretFlags nm_setting_802_1x_get_pin_flags    (NMSetting8021x *setting);
-NMSetting8021xCKScheme nm_setting_802_1x_get_private_key_scheme
-                                                        (NMSetting8021x *setting);
-const GByteArray *  nm_setting_802_1x_get_private_key_blob
-                                                        (NMSetting8021x *setting);
-const char *        nm_setting_802_1x_get_private_key_path
-                                                        (NMSetting8021x *setting);
-gboolean            nm_setting_802_1x_set_private_key   (NMSetting8021x *setting,
-                                                         const char *key_path,
-                                                         const char *password,
-                                                         NMSetting8021xCKScheme scheme,
-                                                         NMSetting8021xCKFormat *out_format,
-                                                         GError **error);
-const char *        nm_setting_802_1x_get_private_key_password
-                                                        (NMSetting8021x *setting);
-NMSettingSecretFlags nm_setting_802_1x_get_private_key_password_flags
-                                                        (NMSetting8021x *setting);
-NMSetting8021xCKFormat nm_setting_802_1x_get_private_key_format
-                                                        (NMSetting8021x *setting);
-NMSetting8021xCKScheme nm_setting_802_1x_get_phase2_private_key_scheme
-                                                        (NMSetting8021x *setting);
-const GByteArray *  nm_setting_802_1x_get_phase2_private_key_blob
-                                                        (NMSetting8021x *setting);
-const char *        nm_setting_802_1x_get_phase2_private_key_path
-                                                        (NMSetting8021x *setting);
-gboolean            nm_setting_802_1x_set_phase2_private_key
-                                                        (NMSetting8021x *setting,
-                                                         const char *key_path,
-                                                         const char *password,
-                                                         NMSetting8021xCKScheme scheme,
-                                                         NMSetting8021xCKFormat *out_format,
-                                                         GError **error);
-const char *        nm_setting_802_1x_get_phase2_private_key_password
-                                                        (NMSetting8021x *setting);
-NMSettingSecretFlags nm_setting_802_1x_get_phase2_private_key_password_flags
-                                                        (NMSetting8021x *setting);
-NMSetting8021xCKFormat nm_setting_802_1x_get_phase2_private_key_format
-                                                        (NMSetting8021x *setting);
-
-
-
-

Object Hierarchy

-
-  GEnum
-   +----NMSetting8021xCKFormat
-
-
-  GEnum
-   +----NMSetting8021xCKScheme
-
-
-  GEnum
-   +----NMSetting8021xError
-
-
-  GObject
-   +----NMSetting
-         +----NMSetting8021x
-
-
-
-

Properties

-
-  "altsubject-matches"       GSList_gchararray_*   : Read / Write
-  "anonymous-identity"       gchar*                : Read / Write
-  "ca-cert"                  GArray_guchar_*       : Read / Write
-  "ca-path"                  gchar*                : Read / Write
-  "client-cert"              GArray_guchar_*       : Read / Write
-  "eap"                      GSList_gchararray_*   : Read / Write
-  "identity"                 gchar*                : Read / Write
-  "pac-file"                 gchar*                : Read / Write
-  "password"                 gchar*                : Read / Write
-  "password-flags"           guint                 : Read / Write
-  "password-raw"             GArray_guchar_*       : Read / Write
-  "password-raw-flags"       guint                 : Read / Write
-  "phase1-fast-provisioning" gchar*                : Read / Write
-  "phase1-peaplabel"         gchar*                : Read / Write
-  "phase1-peapver"           gchar*                : Read / Write
-  "phase2-altsubject-matches" GSList_gchararray_*   : Read / Write
-  "phase2-auth"              gchar*                : Read / Write
-  "phase2-autheap"           gchar*                : Read / Write
-  "phase2-ca-cert"           GArray_guchar_*       : Read / Write
-  "phase2-ca-path"           gchar*                : Read / Write
-  "phase2-client-cert"       GArray_guchar_*       : Read / Write
-  "phase2-private-key"       GArray_guchar_*       : Read / Write
-  "phase2-private-key-password" gchar*                : Read / Write
-  "phase2-private-key-password-flags" guint                 : Read / Write
-  "phase2-subject-match"     gchar*                : Read / Write
-  "pin"                      gchar*                : Read / Write
-  "pin-flags"                guint                 : Read / Write
-  "private-key"              GArray_guchar_*       : Read / Write
-  "private-key-password"     gchar*                : Read / Write
-  "private-key-password-flags" guint                 : Read / Write
-  "subject-match"            gchar*                : Read / Write
-  "system-ca-certs"          gboolean              : Read / Write / Construct
-
-
-
-

Description

-

-The NMSetting8021x object is a NMSetting subclass that describes -properties necessary for connection to 802.1x-authenticated networks, such as -WPA and WPA2 Enterprise Wi-Fi networks and wired 802.1x networks. 802.1x -connections typically use certificates and/or EAP authentication methods to -securely verify, identify, and authenticate the client to the network itself, -instead of simply relying on a widely shared static key. -

-

-It's a good idea to read up on wpa_supplicant configuration before using this -setting extensively, since most of the options here correspond closely with -the relevant wpa_supplicant configuration options. -

-

-Furthermore, to get a good idea of 802.1x, EAP, TLS, TTLS, etc and their -applications to Wi-Fi and wired networks, you'll want to get copies of the -following books. -

-

- 802.11 Wireless Networks: The Definitive Guide, Second Edition - Author: Matthew Gast - ISBN: 978-0596100520 -

-

- Cisco Wireless LAN Security - Authors: Krishna Sankar, Sri Sundaralingam, Darrin Miller, and Andrew Balinsky - ISBN: 978-1587051548 -

-
-

Details

-
-

enum NMSetting8021xCKFormat

-
typedef enum {
- /*< underscore_name=nm_setting_802_1x_ck_format >*/
-	NM_SETTING_802_1X_CK_FORMAT_UNKNOWN = 0,
-	NM_SETTING_802_1X_CK_FORMAT_X509,
-	NM_SETTING_802_1X_CK_FORMAT_RAW_KEY,
-	NM_SETTING_802_1X_CK_FORMAT_PKCS12
-} NMSetting8021xCKFormat;
-
-

-NMSetting8021xCKFormat values indicate the general type of a certificate -or private key -

-
+

Functions

+
--++ - - + - - + - - + - - + - -

NM_SETTING_802_1X_CK_FORMAT_UNKNOWN

unknown file format + +GQuark + +nm_setting_802_1x_error_quark ()

NM_SETTING_802_1X_CK_FORMAT_X509

file contains an X.509 format certificate + +NMSetting * + +nm_setting_802_1x_new ()

NM_SETTING_802_1X_CK_FORMAT_RAW_KEY

file contains an old-style OpenSSL PEM -or DER private key + +guint32 + +nm_setting_802_1x_get_num_eap_methods ()

NM_SETTING_802_1X_CK_FORMAT_PKCS12

file contains a PKCS#12 certificate -and private key +const char * + +nm_setting_802_1x_get_eap_method ()
-
-
-
-

enum NMSetting8021xCKScheme

-
typedef enum {
- /*< underscore_name=nm_setting_802_1x_ck_scheme >*/
-	NM_SETTING_802_1X_CK_SCHEME_UNKNOWN = 0,
-	NM_SETTING_802_1X_CK_SCHEME_BLOB,
-	NM_SETTING_802_1X_CK_SCHEME_PATH
-} NMSetting8021xCKScheme;
-
-

-NMSetting8021xCKScheme values indicate how a certificate or private key is -stored in the setting properties, either as a blob of the item's data, or as -a path to a certificate or private key file on the filesystem -

-
---- - - - + - - + - - + - -

NM_SETTING_802_1X_CK_SCHEME_UNKNOWN

unknown certificate or private key -scheme + +gboolean + +nm_setting_802_1x_add_eap_method ()

NM_SETTING_802_1X_CK_SCHEME_BLOB

certificate or key is stored as the raw -item data + +void + +nm_setting_802_1x_remove_eap_method ()

NM_SETTING_802_1X_CK_SCHEME_PATH

certificate or key is stored as a path -to a file containing the certificate or key data + +gboolean + +nm_setting_802_1x_remove_eap_method_by_value ()
-
-
-
-

NM_SETTING_802_1X_SETTING_NAME

-
#define NM_SETTING_802_1X_SETTING_NAME "802-1x"
-
-

-

-
-
-
-

enum NMSetting8021xError

-
typedef enum {
- /*< underscore_name=nm_setting_802_1x_error >*/
-	NM_SETTING_802_1X_ERROR_UNKNOWN = 0,      /*< nick=UnknownError >*/
-	NM_SETTING_802_1X_ERROR_INVALID_PROPERTY, /*< nick=InvalidProperty >*/
-	NM_SETTING_802_1X_ERROR_MISSING_PROPERTY  /*< nick=MissingProperty >*/
-} NMSetting8021xError;
-
-
---- - - - + - - + - - + - -

NM_SETTING_802_1X_ERROR_UNKNOWN

unknown or unclassified error + +void + +nm_setting_802_1x_clear_eap_methods ()

NM_SETTING_802_1X_ERROR_INVALID_PROPERTY

the property was invalid +const char * + +nm_setting_802_1x_get_identity ()

NM_SETTING_802_1X_ERROR_MISSING_PROPERTY

the property was missing and is -required +const char * + +nm_setting_802_1x_get_anonymous_identity ()
-
-
-
-

NM_SETTING_802_1X_ERROR

-
#define NM_SETTING_802_1X_ERROR nm_setting_802_1x_error_quark ()
-
-

-

-
-
-
-

nm_setting_802_1x_error_quark ()

-
GQuark              nm_setting_802_1x_error_quark       (void);
-

-Registers an error quark for NMSetting8021x if necessary. -

-
---- - - - - -

Returns :

the error quark used for NMSetting8021x errors.
-
-
-
-

NM_SETTING_802_1X_EAP

-
#define NM_SETTING_802_1X_EAP "eap"
-
-

-

-
-
-
-

NM_SETTING_802_1X_IDENTITY

-
#define NM_SETTING_802_1X_IDENTITY "identity"
-
-

-

-
-
-
-

NM_SETTING_802_1X_ANONYMOUS_IDENTITY

-
#define NM_SETTING_802_1X_ANONYMOUS_IDENTITY "anonymous-identity"
-
-

-

-
-
-
-

NM_SETTING_802_1X_PAC_FILE

-
#define NM_SETTING_802_1X_PAC_FILE "pac-file"
-
-

-

-
-
-
-

NM_SETTING_802_1X_CA_CERT

-
#define NM_SETTING_802_1X_CA_CERT "ca-cert"
-
-

-

-
-
-
-

NM_SETTING_802_1X_CA_PATH

-
#define NM_SETTING_802_1X_CA_PATH "ca-path"
-
-

-

-
-
-
-

NM_SETTING_802_1X_SUBJECT_MATCH

-
#define NM_SETTING_802_1X_SUBJECT_MATCH "subject-match"
-
-

-

-
-
-
-

NM_SETTING_802_1X_ALTSUBJECT_MATCHES

-
#define NM_SETTING_802_1X_ALTSUBJECT_MATCHES "altsubject-matches"
-
-

-

-
-
-
-

NM_SETTING_802_1X_CLIENT_CERT

-
#define NM_SETTING_802_1X_CLIENT_CERT "client-cert"
-
-

-

-
-
-
-

NM_SETTING_802_1X_PHASE1_PEAPVER

-
#define NM_SETTING_802_1X_PHASE1_PEAPVER "phase1-peapver"
-
-

-

-
-
-
-

NM_SETTING_802_1X_PHASE1_PEAPLABEL

-
#define NM_SETTING_802_1X_PHASE1_PEAPLABEL "phase1-peaplabel"
-
-

-

-
-
-
-

NM_SETTING_802_1X_PHASE1_FAST_PROVISIONING

-
#define NM_SETTING_802_1X_PHASE1_FAST_PROVISIONING "phase1-fast-provisioning"
-
-

-

-
-
-
-

NM_SETTING_802_1X_PHASE2_AUTH

-
#define NM_SETTING_802_1X_PHASE2_AUTH "phase2-auth"
-
-

-

-
-
-
-

NM_SETTING_802_1X_PHASE2_AUTHEAP

-
#define NM_SETTING_802_1X_PHASE2_AUTHEAP "phase2-autheap"
-
-

-

-
-
-
-

NM_SETTING_802_1X_PHASE2_CA_CERT

-
#define NM_SETTING_802_1X_PHASE2_CA_CERT "phase2-ca-cert"
-
-

-

-
-
-
-

NM_SETTING_802_1X_PHASE2_CA_PATH

-
#define NM_SETTING_802_1X_PHASE2_CA_PATH "phase2-ca-path"
-
-

-

-
-
-
-

NM_SETTING_802_1X_PHASE2_SUBJECT_MATCH

-
#define NM_SETTING_802_1X_PHASE2_SUBJECT_MATCH "phase2-subject-match"
-
-

-

-
-
-
-

NM_SETTING_802_1X_PHASE2_ALTSUBJECT_MATCHES

-
#define NM_SETTING_802_1X_PHASE2_ALTSUBJECT_MATCHES "phase2-altsubject-matches"
-
-

-

-
-
-
-

NM_SETTING_802_1X_PHASE2_CLIENT_CERT

-
#define NM_SETTING_802_1X_PHASE2_CLIENT_CERT "phase2-client-cert"
-
-

-

-
-
-
-

NM_SETTING_802_1X_PASSWORD

-
#define NM_SETTING_802_1X_PASSWORD "password"
-
-

-

-
-
-
-

NM_SETTING_802_1X_PASSWORD_FLAGS

-
#define NM_SETTING_802_1X_PASSWORD_FLAGS "password-flags"
-
-

-

-
-
-
-

NM_SETTING_802_1X_PASSWORD_RAW

-
#define NM_SETTING_802_1X_PASSWORD_RAW "password-raw"
-
-

-

-
-
-
-

NM_SETTING_802_1X_PASSWORD_RAW_FLAGS

-
#define NM_SETTING_802_1X_PASSWORD_RAW_FLAGS "password-raw-flags"
-
-

-

-
-
-
-

NM_SETTING_802_1X_PRIVATE_KEY

-
#define NM_SETTING_802_1X_PRIVATE_KEY "private-key"
-
-

-

-
-
-
-

NM_SETTING_802_1X_PRIVATE_KEY_PASSWORD

-
#define NM_SETTING_802_1X_PRIVATE_KEY_PASSWORD "private-key-password"
-
-

-

-
-
-
-

NM_SETTING_802_1X_PRIVATE_KEY_PASSWORD_FLAGS

-
#define NM_SETTING_802_1X_PRIVATE_KEY_PASSWORD_FLAGS "private-key-password-flags"
-
-

-

+ +const char * + + +nm_setting_802_1x_get_pac_file () + + + + +gboolean + + +nm_setting_802_1x_get_system_ca_certs () + + + +const char * + + +nm_setting_802_1x_get_ca_path () + + + +const char * + + +nm_setting_802_1x_get_phase2_ca_path () + + + + +NMSetting8021xCKScheme + + +nm_setting_802_1x_get_ca_cert_scheme () + + + +const GByteArray * + + +nm_setting_802_1x_get_ca_cert_blob () + + + +const char * + + +nm_setting_802_1x_get_ca_cert_path () + + + + +gboolean + + +nm_setting_802_1x_set_ca_cert () + + + +const char * + + +nm_setting_802_1x_get_subject_match () + + + + +guint32 + + +nm_setting_802_1x_get_num_altsubject_matches () + + + +const char * + + +nm_setting_802_1x_get_altsubject_match () + + + + +gboolean + + +nm_setting_802_1x_add_altsubject_match () + + + + +void + + +nm_setting_802_1x_remove_altsubject_match () + + + + +gboolean + + +nm_setting_802_1x_remove_altsubject_match_by_value () + + + + +void + + +nm_setting_802_1x_clear_altsubject_matches () + + + + +NMSetting8021xCKScheme + + +nm_setting_802_1x_get_client_cert_scheme () + + + +const GByteArray * + + +nm_setting_802_1x_get_client_cert_blob () + + + +const char * + + +nm_setting_802_1x_get_client_cert_path () + + + + +gboolean + + +nm_setting_802_1x_set_client_cert () + + + +const char * + + +nm_setting_802_1x_get_phase1_peapver () + + + +const char * + + +nm_setting_802_1x_get_phase1_peaplabel () + + + +const char * + + +nm_setting_802_1x_get_phase1_fast_provisioning () + + + +const char * + + +nm_setting_802_1x_get_phase2_auth () + + + +const char * + + +nm_setting_802_1x_get_phase2_autheap () + + + + +NMSetting8021xCKScheme + + +nm_setting_802_1x_get_phase2_ca_cert_scheme () + + + +const GByteArray * + + +nm_setting_802_1x_get_phase2_ca_cert_blob () + + + +const char * + + +nm_setting_802_1x_get_phase2_ca_cert_path () + + + + +gboolean + + +nm_setting_802_1x_set_phase2_ca_cert () + + + +const char * + + +nm_setting_802_1x_get_phase2_subject_match () + + + + +guint32 + + +nm_setting_802_1x_get_num_phase2_altsubject_matches () + + + +const char * + + +nm_setting_802_1x_get_phase2_altsubject_match () + + + + +gboolean + + +nm_setting_802_1x_add_phase2_altsubject_match () + + + + +void + + +nm_setting_802_1x_remove_phase2_altsubject_match () + + + + +gboolean + + +nm_setting_802_1x_remove_phase2_altsubject_match_by_value () + + + + +void + + +nm_setting_802_1x_clear_phase2_altsubject_matches () + + + + +NMSetting8021xCKScheme + + +nm_setting_802_1x_get_phase2_client_cert_scheme () + + + +const GByteArray * + + +nm_setting_802_1x_get_phase2_client_cert_blob () + + + +const char * + + +nm_setting_802_1x_get_phase2_client_cert_path () + + + + +gboolean + + +nm_setting_802_1x_set_phase2_client_cert () + + + +const char * + + +nm_setting_802_1x_get_password () + + + + +NMSettingSecretFlags + + +nm_setting_802_1x_get_password_flags () + + + +const GByteArray * + + +nm_setting_802_1x_get_password_raw () + + + + +NMSettingSecretFlags + + +nm_setting_802_1x_get_password_raw_flags () + + + +const char * + + +nm_setting_802_1x_get_pin () + + + + +NMSettingSecretFlags + + +nm_setting_802_1x_get_pin_flags () + + + + +NMSetting8021xCKScheme + + +nm_setting_802_1x_get_private_key_scheme () + + + +const GByteArray * + + +nm_setting_802_1x_get_private_key_blob () + + + +const char * + + +nm_setting_802_1x_get_private_key_path () + + + + +gboolean + + +nm_setting_802_1x_set_private_key () + + + +const char * + + +nm_setting_802_1x_get_private_key_password () + + + + +NMSettingSecretFlags + + +nm_setting_802_1x_get_private_key_password_flags () + + + + +NMSetting8021xCKFormat + + +nm_setting_802_1x_get_private_key_format () + + + + +NMSetting8021xCKScheme + + +nm_setting_802_1x_get_phase2_private_key_scheme () + + + +const GByteArray * + + +nm_setting_802_1x_get_phase2_private_key_blob () + + + +const char * + + +nm_setting_802_1x_get_phase2_private_key_path () + + + + +gboolean + + +nm_setting_802_1x_set_phase2_private_key () + + + +const char * + + +nm_setting_802_1x_get_phase2_private_key_password () + + + + +NMSettingSecretFlags + + +nm_setting_802_1x_get_phase2_private_key_password_flags () + + + + +NMSetting8021xCKFormat + + +nm_setting_802_1x_get_phase2_private_key_format () + + + +
-
-
-

NM_SETTING_802_1X_PHASE2_PRIVATE_KEY

-
#define NM_SETTING_802_1X_PHASE2_PRIVATE_KEY "phase2-private-key"
-
-

-

+
+

Properties

+
+++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+GSList_gchararray_ *altsubject-matchesRead / Write
+gchar *anonymous-identityRead / Write
+GArray_guchar_ *ca-certRead / Write
+gchar *ca-pathRead / Write
+GArray_guchar_ *client-certRead / Write
+GSList_gchararray_ *eapRead / Write
+gchar *identityRead / Write
+gchar *pac-fileRead / Write
+gchar *passwordRead / Write
guintpassword-flagsRead / Write
+GArray_guchar_ *password-rawRead / Write
guintpassword-raw-flagsRead / Write
+gchar *phase1-fast-provisioningRead / Write
+gchar *phase1-peaplabelRead / Write
+gchar *phase1-peapverRead / Write
+GSList_gchararray_ *phase2-altsubject-matchesRead / Write
+gchar *phase2-authRead / Write
+gchar *phase2-autheapRead / Write
+GArray_guchar_ *phase2-ca-certRead / Write
+gchar *phase2-ca-pathRead / Write
+GArray_guchar_ *phase2-client-certRead / Write
+GArray_guchar_ *phase2-private-keyRead / Write
+gchar *phase2-private-key-passwordRead / Write
guintphase2-private-key-password-flagsRead / Write
+gchar *phase2-subject-matchRead / Write
+gchar *pinRead / Write
guintpin-flagsRead / Write
+GArray_guchar_ *private-keyRead / Write
+gchar *private-key-passwordRead / Write
guintprivate-key-password-flagsRead / Write
+gchar *subject-matchRead / Write
gbooleansystem-ca-certsRead / Write / Construct
-
-
-

NM_SETTING_802_1X_PHASE2_PRIVATE_KEY_PASSWORD

-
#define NM_SETTING_802_1X_PHASE2_PRIVATE_KEY_PASSWORD "phase2-private-key-password"
-
-

-

+
+

Types and Values

+
++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
enumNMSetting8021xCKFormat
enumNMSetting8021xCKScheme
#defineNM_SETTING_802_1X_SETTING_NAME
enumNMSetting8021xError
#defineNM_SETTING_802_1X_ERROR
#defineNM_SETTING_802_1X_EAP
#defineNM_SETTING_802_1X_IDENTITY
#defineNM_SETTING_802_1X_ANONYMOUS_IDENTITY
#defineNM_SETTING_802_1X_PAC_FILE
#defineNM_SETTING_802_1X_CA_CERT
#defineNM_SETTING_802_1X_CA_PATH
#defineNM_SETTING_802_1X_SUBJECT_MATCH
#defineNM_SETTING_802_1X_ALTSUBJECT_MATCHES
#defineNM_SETTING_802_1X_CLIENT_CERT
#defineNM_SETTING_802_1X_PHASE1_PEAPVER
#defineNM_SETTING_802_1X_PHASE1_PEAPLABEL
#defineNM_SETTING_802_1X_PHASE1_FAST_PROVISIONING
#defineNM_SETTING_802_1X_PHASE2_AUTH
#defineNM_SETTING_802_1X_PHASE2_AUTHEAP
#defineNM_SETTING_802_1X_PHASE2_CA_CERT
#defineNM_SETTING_802_1X_PHASE2_CA_PATH
#defineNM_SETTING_802_1X_PHASE2_SUBJECT_MATCH
#defineNM_SETTING_802_1X_PHASE2_ALTSUBJECT_MATCHES
#defineNM_SETTING_802_1X_PHASE2_CLIENT_CERT
#defineNM_SETTING_802_1X_PASSWORD
#defineNM_SETTING_802_1X_PASSWORD_FLAGS
#defineNM_SETTING_802_1X_PASSWORD_RAW
#defineNM_SETTING_802_1X_PASSWORD_RAW_FLAGS
#defineNM_SETTING_802_1X_PRIVATE_KEY
#defineNM_SETTING_802_1X_PRIVATE_KEY_PASSWORD
#defineNM_SETTING_802_1X_PRIVATE_KEY_PASSWORD_FLAGS
#defineNM_SETTING_802_1X_PHASE2_PRIVATE_KEY
#defineNM_SETTING_802_1X_PHASE2_PRIVATE_KEY_PASSWORD
#defineNM_SETTING_802_1X_PHASE2_PRIVATE_KEY_PASSWORD_FLAGS
#defineNM_SETTING_802_1X_PIN
#defineNM_SETTING_802_1X_PIN_FLAGS
#defineNM_SETTING_802_1X_SYSTEM_CA_CERTS
-
-
-

NM_SETTING_802_1X_PHASE2_PRIVATE_KEY_PASSWORD_FLAGS

-
#define NM_SETTING_802_1X_PHASE2_PRIVATE_KEY_PASSWORD_FLAGS "phase2-private-key-password-flags"
+
+

Object Hierarchy

+
    GEnum
+    ├── NMSetting8021xCKFormat
+    ├── NMSetting8021xCKScheme
+    ╰── NMSetting8021xError
+    GObject
+    ╰── NMSetting
+        ╰── NMSetting8021x
 
-

-

-
-
-

NM_SETTING_802_1X_PIN

-
#define NM_SETTING_802_1X_PIN "pin"
+
+

Includes

+
#include <nm-setting-8021x.h>
 
-

-

-
-
-

NM_SETTING_802_1X_PIN_FLAGS

-
#define NM_SETTING_802_1X_PIN_FLAGS "pin-flags"
-
-

-

+
+

Description

+

The NMSetting8021x object is a NMSetting subclass that describes +properties necessary for connection to 802.1x-authenticated networks, such as +WPA and WPA2 Enterprise Wi-Fi networks and wired 802.1x networks. 802.1x +connections typically use certificates and/or EAP authentication methods to +securely verify, identify, and authenticate the client to the network itself, +instead of simply relying on a widely shared static key.

+

It's a good idea to read up on wpa_supplicant configuration before using this +setting extensively, since most of the options here correspond closely with +the relevant wpa_supplicant configuration options.

+

Furthermore, to get a good idea of 802.1x, EAP, TLS, TTLS, etc and their +applications to Wi-Fi and wired networks, you'll want to get copies of the +following books.

+

802.11 Wireless Networks: The Definitive Guide, Second Edition + Author: Matthew Gast + ISBN: 978-0596100520

+

Cisco Wireless LAN Security + Authors: Krishna Sankar, Sri Sundaralingam, Darrin Miller, and Andrew Balinsky + ISBN: 978-1587051548

-
+
+

Functions

-

NM_SETTING_802_1X_SYSTEM_CA_CERTS

-
#define NM_SETTING_802_1X_SYSTEM_CA_CERTS "system-ca-certs"
-
-

-

+

nm_setting_802_1x_error_quark ()

+
GQuark
+nm_setting_802_1x_error_quark (void);
+

Registers an error quark for NMSetting8021x if necessary.

+
+

Returns

+

the error quark used for NMSetting8021x errors.

+

-
-
-

NMSetting8021x

-
typedef struct _NMSetting8021x NMSetting8021x;
-

-


-

NMSetting8021xClass

-
typedef struct {
-	NMSettingClass parent;
-
-	/* Padding for future expansion */
-	void (*_reserved1) (void);
-	void (*_reserved2) (void);
-	void (*_reserved3) (void);
-	void (*_reserved4) (void);
-} NMSetting8021xClass;
-
-

-

+

nm_setting_802_1x_new ()

+
NMSetting *
+nm_setting_802_1x_new (void);
+

Creates a new NMSetting8021x object with default values.

+
+

Returns

+

the new empty NMSetting8021x object

+

+

-

nm_setting_802_1x_new ()

-
NMSetting *         nm_setting_802_1x_new               (void);
-

-Creates a new NMSetting8021x object with default values. -

-
+

nm_setting_802_1x_get_num_eap_methods ()

+
guint32
+nm_setting_802_1x_get_num_eap_methods (NMSetting8021x *setting);
+

Returns the number of eap methods allowed for use when connecting to the +network. Generally only one EAP method is used. Use the functions +nm_setting_802_1x_get_eap_method(), nm_setting_802_1x_add_eap_method(), +and nm_setting_802_1x_remove_eap_method() for adding, removing, and retrieving +allowed EAP methods.

+
+

Parameters

+
--+++ - - + + +

Returns :

the new empty NMSetting8021x object

setting

the NMSetting8021x

 
+
+

Returns

+

the number of allowed EAP methods

+

+
+

-

nm_setting_802_1x_get_num_eap_methods ()

-
guint32             nm_setting_802_1x_get_num_eap_methods
-                                                        (NMSetting8021x *setting);
-

-Returns the number of eap methods allowed for use when connecting to the -network. Generally only one EAP method is used. Use the functions -nm_setting_802_1x_get_eap_method(), nm_setting_802_1x_add_eap_method(), -and nm_setting_802_1x_remove_eap_method() for adding, removing, and retrieving -allowed EAP methods. -

-
+

nm_setting_802_1x_get_eap_method ()

+
const char *
+nm_setting_802_1x_get_eap_method (NMSetting8021x *setting,
+                                  guint32 i);
+

Returns the name of the allowed EAP method at index i +.

+
+

Parameters

+
--+++ - - + + + - - + + +

setting :

the NMSetting8021x -

setting

the NMSetting8021x

 

Returns :

the number of allowed EAP methods

i

the index of the EAP method name to return

 
-
-
-

nm_setting_802_1x_get_eap_method ()

-
const char *        nm_setting_802_1x_get_eap_method    (NMSetting8021x *setting,
-                                                         guint32 i);
-

-Returns the name of the allowed EAP method at index i. +

+

Returns

+

the name of the allowed EAP method at index i

-
---- - - - - - - - - - - - - - - -

setting :

the NMSetting8021x -

i :

the index of the EAP method name to return

Returns :

the name of the allowed EAP method at index i -
+

+

-

nm_setting_802_1x_add_eap_method ()

-
gboolean            nm_setting_802_1x_add_eap_method    (NMSetting8021x *setting,
-                                                         const char *eap);
-

-Adds an allowed EAP method. The setting is not valid until at least one -EAP method has been added. See "eap" property for a list of -allowed EAP methods. -

-
+

nm_setting_802_1x_add_eap_method ()

+
gboolean
+nm_setting_802_1x_add_eap_method (NMSetting8021x *setting,
+                                  const char *eap);
+

Adds an allowed EAP method. The setting is not valid until at least one +EAP method has been added. See “eap” property for a list of +allowed EAP methods.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + +

setting :

the NMSetting8021x -

eap :

the name of the EAP method to allow for this connection

setting

the NMSetting8021x

 

Returns :

-TRUE if the EAP method was successfully added, FALSE if it was -not a valid method or if it was already allowed.

eap

the name of the EAP method to allow for this connection

 
+
+

Returns

+

TRUE if the EAP method was successfully added, FALSE if it was +not a valid method or if it was already allowed.

+

+
+

-

nm_setting_802_1x_remove_eap_method ()

-
void                nm_setting_802_1x_remove_eap_method (NMSetting8021x *setting,
-                                                         guint32 i);
-

-Removes the allowed EAP method at the specified index. -

-
+

nm_setting_802_1x_remove_eap_method ()

+
void
+nm_setting_802_1x_remove_eap_method (NMSetting8021x *setting,
+                                     guint32 i);
+

Removes the allowed EAP method at the specified index.

+
+

Parameters

+
--+++ - - + + + - - + + +

setting :

the NMSetting8021x -

setting

the NMSetting8021x

 

i :

the index of the EAP method to remove

i

the index of the EAP method to remove

 
+

-

nm_setting_802_1x_remove_eap_method_by_value ()

-
gboolean            nm_setting_802_1x_remove_eap_method_by_value
-                                                        (NMSetting8021x *setting,
-                                                         const char *eap);
-

-Removes the allowed EAP method method. -

-
+

nm_setting_802_1x_remove_eap_method_by_value ()

+
gboolean
+nm_setting_802_1x_remove_eap_method_by_value
+                               (NMSetting8021x *setting,
+                                const char *eap);
+

Removes the allowed EAP method method +.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + +

setting :

the NMSetting8021x -

eap :

the name of the EAP method to remove

setting

the NMSetting8021x

 

Returns :

-TRUE if the EAP method was founs and removed, FALSE if it was not.

eap

the name of the EAP method to remove

 
+
+
+

Returns

+

TRUE if the EAP method was founs and removed, FALSE if it was not.

+

+

Since 0.9.10


-

nm_setting_802_1x_clear_eap_methods ()

-
void                nm_setting_802_1x_clear_eap_methods (NMSetting8021x *setting);
-

-Clears all allowed EAP methods. -

-
+

nm_setting_802_1x_clear_eap_methods ()

+
void
+nm_setting_802_1x_clear_eap_methods (NMSetting8021x *setting);
+

Clears all allowed EAP methods.

+
+

Parameters

+
--+++ - - + + +

setting :

the NMSetting8021x -

setting

the NMSetting8021x

 
+

-

nm_setting_802_1x_get_identity ()

-
const char *        nm_setting_802_1x_get_identity      (NMSetting8021x *setting);
-

-Returns the identifier used by some EAP methods (like TLS) to -authenticate the user. Often this is a username or login name. -

-
+

nm_setting_802_1x_get_identity ()

+
const char *
+nm_setting_802_1x_get_identity (NMSetting8021x *setting);
+

Returns the identifier used by some EAP methods (like TLS) to +authenticate the user. Often this is a username or login name.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSetting8021x -

Returns :

the user identifier

setting

the NMSetting8021x

 
+
+

Returns

+

the user identifier

+

+
+

-

nm_setting_802_1x_get_anonymous_identity ()

-
const char *        nm_setting_802_1x_get_anonymous_identity
-                                                        (NMSetting8021x *setting);
-

-Returns the anonymous identifier used by some EAP methods (like TTLS) to +

nm_setting_802_1x_get_anonymous_identity ()

+
const char *
+nm_setting_802_1x_get_anonymous_identity
+                               (NMSetting8021x *setting);
+

Returns the anonymous identifier used by some EAP methods (like TTLS) to authenticate the user in the outer unencrypted "phase 1" authentication. The -inner "phase 2" authentication will use the "identity" in -a secure form, if applicable for that EAP method. -

-
+inner "phase 2" authentication will use the “identity” in +a secure form, if applicable for that EAP method.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSetting8021x -

Returns :

the anonymous identifier

setting

the NMSetting8021x

 
+
+

Returns

+

the anonymous identifier

+

+
+

-

nm_setting_802_1x_get_pac_file ()

-
const char *        nm_setting_802_1x_get_pac_file      (NMSetting8021x *setting);
-

-Returns the file containing PAC credentials used by EAP-FAST method. -

-
+

nm_setting_802_1x_get_pac_file ()

+
const char *
+nm_setting_802_1x_get_pac_file (NMSetting8021x *setting);
+

Returns the file containing PAC credentials used by EAP-FAST method.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSetting8021x -

Returns :

the PAC file

setting

the NMSetting8021x

 
+
+

Returns

+

the PAC file

+

+
+

-

nm_setting_802_1x_get_system_ca_certs ()

-
gboolean            nm_setting_802_1x_get_system_ca_certs
-                                                        (NMSetting8021x *setting);
-

-Sets the "system-ca-certs" property. The -"ca-path" and "phase2-ca-path" -properties are ignored if the "system-ca-certs" property is -TRUE, in which case a system-wide CA certificate directory specified at +

nm_setting_802_1x_get_system_ca_certs ()

+
gboolean
+nm_setting_802_1x_get_system_ca_certs (NMSetting8021x *setting);
+

Sets the “system-ca-certs” property. The +“ca-path” and “phase2-ca-path” +properties are ignored if the “system-ca-certs” property is +TRUE, in which case a system-wide CA certificate directory specified at compile time (using the --system-ca-path configure option) is used in place -of these properties. -

-
+of these properties.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSetting8021x -

Returns :

-TRUE if a system CA certificate path should be used, FALSE if not

setting

the NMSetting8021x

 
+
+

Returns

+

TRUE if a system CA certificate path should be used, FALSE if not

+

+
+
-

nm_setting_802_1x_get_ca_path ()

-
const char *        nm_setting_802_1x_get_ca_path       (NMSetting8021x *setting);
-

-Returns the path of the CA certificate directory if previously set. Systems +

nm_setting_802_1x_get_ca_path ()

+
const char *
+nm_setting_802_1x_get_ca_path (NMSetting8021x *setting);
+

Returns the path of the CA certificate directory if previously set. Systems will often have a directory that contains multiple individual CA certificates which the supplicant can then add to the verification chain. This may be -used in addition to the "ca-cert" property to add more CA -certificates for verifying the network to client. -

-
+used in addition to the “ca-cert” property to add more CA +certificates for verifying the network to client.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSetting8021x -

Returns :

the CA certificate directory path

setting

the NMSetting8021x

 
+
+

Returns

+

the CA certificate directory path

+

+
+
-

nm_setting_802_1x_get_phase2_ca_path ()

-
const char *        nm_setting_802_1x_get_phase2_ca_path
-                                                        (NMSetting8021x *setting);
-

-Returns the path of the "phase 2" CA certificate directory if previously set. +

nm_setting_802_1x_get_phase2_ca_path ()

+
const char *
+nm_setting_802_1x_get_phase2_ca_path (NMSetting8021x *setting);
+

Returns the path of the "phase 2" CA certificate directory if previously set. Systems will often have a directory that contains multiple individual CA certificates which the supplicant can then add to the verification chain. -This may be used in addition to the "phase2-ca-cert" property -to add more CA certificates for verifying the network to client. -

-
+This may be used in addition to the “phase2-ca-cert” property +to add more CA certificates for verifying the network to client.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSetting8021x -

Returns :

the "phase 2" CA certificate directory path

setting

the NMSetting8021x

 
+
+

Returns

+

the "phase 2" CA certificate directory path

+

+
+
-

nm_setting_802_1x_get_ca_cert_scheme ()

-
NMSetting8021xCKScheme nm_setting_802_1x_get_ca_cert_scheme
-                                                        (NMSetting8021x *setting);
-

-Returns the scheme used to store the CA certificate. If the returned scheme -is NM_SETTING_802_1X_CK_SCHEME_BLOB, use nm_setting_802_1x_get_ca_cert_blob(); -if NM_SETTING_802_1X_CK_SCHEME_PATH, use nm_setting_802_1x_get_ca_cert_path(). -

-
+

nm_setting_802_1x_get_ca_cert_scheme ()

+
NMSetting8021xCKScheme
+nm_setting_802_1x_get_ca_cert_scheme (NMSetting8021x *setting);
+

Returns the scheme used to store the CA certificate. If the returned scheme +is NM_SETTING_802_1X_CK_SCHEME_BLOB, use nm_setting_802_1x_get_ca_cert_blob(); +if NM_SETTING_802_1X_CK_SCHEME_PATH, use nm_setting_802_1x_get_ca_cert_path().

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSetting8021x -

Returns :

scheme used to store the CA certificate (blob or path)

setting

the NMSetting8021x

 
+
+

Returns

+

scheme used to store the CA certificate (blob or path)

+

+
+
-

nm_setting_802_1x_get_ca_cert_blob ()

-
const GByteArray *  nm_setting_802_1x_get_ca_cert_blob  (NMSetting8021x *setting);
-

-Returns the CA certificate blob if the CA certificate is stored using the +

nm_setting_802_1x_get_ca_cert_blob ()

+
const GByteArray *
+nm_setting_802_1x_get_ca_cert_blob (NMSetting8021x *setting);
+

Returns the CA certificate blob if the CA certificate is stored using the NM_SETTING_802_1X_CK_SCHEME_BLOB scheme. Not all EAP methods use a CA certificate (LEAP for example), and those that can take advantage of the CA certificate allow it to be unset. Note that lack of a CA certificate reduces security by allowing man-in-the-middle attacks, because the identity -of the network cannot be confirmed by the client. -

-
+of the network cannot be confirmed by the client.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSetting8021x -

Returns :

the CA certificate data

setting

the NMSetting8021x

 
+
+

Returns

+

the CA certificate data

+

+
+
-

nm_setting_802_1x_get_ca_cert_path ()

-
const char *        nm_setting_802_1x_get_ca_cert_path  (NMSetting8021x *setting);
-

-Returns the CA certificate path if the CA certificate is stored using the +

nm_setting_802_1x_get_ca_cert_path ()

+
const char *
+nm_setting_802_1x_get_ca_cert_path (NMSetting8021x *setting);
+

Returns the CA certificate path if the CA certificate is stored using the NM_SETTING_802_1X_CK_SCHEME_PATH scheme. Not all EAP methods use a CA certificate (LEAP for example), and those that can take advantage of the CA certificate allow it to be unset. Note that lack of a CA certificate reduces security by allowing man-in-the-middle attacks, because the identity -of the network cannot be confirmed by the client. -

-
+of the network cannot be confirmed by the client.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSetting8021x -

Returns :

path to the CA certificate file

setting

the NMSetting8021x

 
+
+

Returns

+

path to the CA certificate file

+

+
+
-

nm_setting_802_1x_set_ca_cert ()

-
gboolean            nm_setting_802_1x_set_ca_cert       (NMSetting8021x *setting,
-                                                         const char *cert_path,
-                                                         NMSetting8021xCKScheme scheme,
-                                                         NMSetting8021xCKFormat *out_format,
-                                                         GError **error);
-

-Reads a certificate from disk and sets the "ca-cert" property +

nm_setting_802_1x_set_ca_cert ()

+
gboolean
+nm_setting_802_1x_set_ca_cert (NMSetting8021x *setting,
+                               const char *cert_path,
+                               NMSetting8021xCKScheme scheme,
+                               NMSetting8021xCKFormat *out_format,
+                               GError **error);
+

Reads a certificate from disk and sets the “ca-cert” property with the raw certificate data if using the NM_SETTING_802_1X_CK_SCHEME_BLOB scheme, or with the path to the certificate file if using the -NM_SETTING_802_1X_CK_SCHEME_PATH scheme. -

-
+NM_SETTING_802_1X_CK_SCHEME_PATH scheme.

+
+

Parameters

+
--+++ - - + + + - - + +g_filename_to_utf8() to convert if needed. Passing NULL with any scheme +clears the CA certificate.

+ - - + + + - - + + + - - - - - - + + +

setting :

the NMSetting8021x -

setting

the NMSetting8021x

 

cert_path :

when scheme is set to either NM_SETTING_802_1X_CK_SCHEME_PATH +

cert_path

when scheme +is set to either NM_SETTING_802_1X_CK_SCHEME_PATH or NM_SETTING_802_1X_CK_SCHEME_BLOB, pass the path of the CA certificate file (PEM or DER format). The path must be UTF-8 encoded; use -g_filename_to_utf8() to convert if needed. Passing NULL with any scheme -clears the CA certificate.

 

scheme :

desired storage scheme for the certificate

scheme

desired storage scheme for the certificate

 

out_format :

on successful return, the type of the certificate added

out_format

on successful return, the type of the certificate added

 

error :

on unsuccessful return, an error

Returns :

-TRUE if the operation succeeded, FALSE if it was unsuccessful

error

on unsuccessful return, an error

 
+
+

Returns

+

TRUE if the operation succeeded, FALSE if it was unsuccessful

+

+
+
-

nm_setting_802_1x_get_subject_match ()

-
const char *        nm_setting_802_1x_get_subject_match (NMSetting8021x *setting);
-
+

nm_setting_802_1x_get_subject_match ()

+
const char *
+nm_setting_802_1x_get_subject_match (NMSetting8021x *setting);
+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSetting8021x -

Returns :

the "subject-match" property. This is the -substring to be matched against the subject of the authentication -server certificate, or NULL no subject verification is to be -performed.

setting

the NMSetting8021x

 
+
+

Returns

+

the “subject-match” property. This is the +substring to be matched against the subject of the authentication +server certificate, or NULL no subject verification is to be +performed.

+

+
+
-

nm_setting_802_1x_get_num_altsubject_matches ()

-
guint32             nm_setting_802_1x_get_num_altsubject_matches
-                                                        (NMSetting8021x *setting);
-

-Returns the number of entries in the -"altsubject-matches" property of this setting. -

-
+

nm_setting_802_1x_get_num_altsubject_matches ()

+
guint32
+nm_setting_802_1x_get_num_altsubject_matches
+                               (NMSetting8021x *setting);
+

Returns the number of entries in the +“altsubject-matches” property of this setting.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSetting8021x -

Returns :

the number of altsubject-matches entries.

setting

the NMSetting8021x

 
+
+

Returns

+

the number of altsubject-matches entries.

+

+
+
-

nm_setting_802_1x_get_altsubject_match ()

-
const char *        nm_setting_802_1x_get_altsubject_match
-                                                        (NMSetting8021x *setting,
-                                                         guint32 i);
-

-Returns the altSubjectName match at index i. -

-
+

nm_setting_802_1x_get_altsubject_match ()

+
const char *
+nm_setting_802_1x_get_altsubject_match
+                               (NMSetting8021x *setting,
+                                guint32 i);
+

Returns the altSubjectName match at index i +.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + +

setting :

the NMSettingConnection -

i :

the zero-based index of the array of altSubjectName matches

setting

the NMSettingConnection

 

Returns :

the altSubjectName match at index i -

i

the zero-based index of the array of altSubjectName matches

 
+
+

Returns

+

the altSubjectName match at index i +

+

+
+
-

nm_setting_802_1x_add_altsubject_match ()

-
gboolean            nm_setting_802_1x_add_altsubject_match
-                                                        (NMSetting8021x *setting,
-                                                         const char *altsubject_match);
-

-Adds an allowed alternate subject name match. Until at least one +

nm_setting_802_1x_add_altsubject_match ()

+
gboolean
+nm_setting_802_1x_add_altsubject_match
+                               (NMSetting8021x *setting,
+                                const char *altsubject_match);
+

Adds an allowed alternate subject name match. Until at least one match is added, the altSubjectName of the remote authentication -server is not verified. -

-
+server is not verified.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + +

setting :

the NMSetting8021x -

altsubject_match :

the altSubjectName to allow for this connection

setting

the NMSetting8021x

 

Returns :

-TRUE if the alternative subject name match was -successfully added, FALSE if it was already allowed.

altsubject_match

the altSubjectName to allow for this connection

 
+
+

Returns

+

TRUE if the alternative subject name match was +successfully added, FALSE if it was already allowed.

+

+
+
-

nm_setting_802_1x_remove_altsubject_match ()

-
void                nm_setting_802_1x_remove_altsubject_match
-                                                        (NMSetting8021x *setting,
-                                                         guint32 i);
-

-Removes the allowed altSubjectName at the specified index. -

-
+

nm_setting_802_1x_remove_altsubject_match ()

+
void
+nm_setting_802_1x_remove_altsubject_match
+                               (NMSetting8021x *setting,
+                                guint32 i);
+

Removes the allowed altSubjectName at the specified index.

+
+

Parameters

+
--+++ - - + + + - - + + +

setting :

the NMSetting8021x -

setting

the NMSetting8021x

 

i :

the index of the altSubjectName match to remove

i

the index of the altSubjectName match to remove

 
+
-

nm_setting_802_1x_remove_altsubject_match_by_value ()

-
gboolean            nm_setting_802_1x_remove_altsubject_match_by_value
-                                                        (NMSetting8021x *setting,
-                                                         const char *altsubject_match);
-

-Removes the allowed altSubjectName altsubject_match. -

-
+

nm_setting_802_1x_remove_altsubject_match_by_value ()

+
gboolean
+nm_setting_802_1x_remove_altsubject_match_by_value
+                               (NMSetting8021x *setting,
+                                const char *altsubject_match);
+

Removes the allowed altSubjectName altsubject_match +.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + +

setting :

the NMSetting8021x -

altsubject_match :

the altSubjectName to remove

setting

the NMSetting8021x

 

Returns :

-TRUE if the alternative subject name match was found and removed, -FALSE if it was not.

altsubject_match

the altSubjectName to remove

 
+
+
+

Returns

+

TRUE if the alternative subject name match was found and removed, +FALSE if it was not.

+

+

Since 0.9.10


-

nm_setting_802_1x_clear_altsubject_matches ()

-
void                nm_setting_802_1x_clear_altsubject_matches
-                                                        (NMSetting8021x *setting);
-

-Clears all altSubjectName matches. -

-
+

nm_setting_802_1x_clear_altsubject_matches ()

+
void
+nm_setting_802_1x_clear_altsubject_matches
+                               (NMSetting8021x *setting);
+

Clears all altSubjectName matches.

+
+

Parameters

+
--+++ - - + + +

setting :

the NMSetting8021x -

setting

the NMSetting8021x

 
+
-

nm_setting_802_1x_get_client_cert_scheme ()

-
NMSetting8021xCKScheme nm_setting_802_1x_get_client_cert_scheme
-                                                        (NMSetting8021x *setting);
-

-Returns the scheme used to store the client certificate. If the returned scheme -is NM_SETTING_802_1X_CK_SCHEME_BLOB, use nm_setting_802_1x_get_client_cert_blob(); -if NM_SETTING_802_1X_CK_SCHEME_PATH, use nm_setting_802_1x_get_client_cert_path(). -

-
+

nm_setting_802_1x_get_client_cert_scheme ()

+
NMSetting8021xCKScheme
+nm_setting_802_1x_get_client_cert_scheme
+                               (NMSetting8021x *setting);
+

Returns the scheme used to store the client certificate. If the returned scheme +is NM_SETTING_802_1X_CK_SCHEME_BLOB, use nm_setting_802_1x_get_client_cert_blob(); +if NM_SETTING_802_1X_CK_SCHEME_PATH, use nm_setting_802_1x_get_client_cert_path().

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSetting8021x -

Returns :

scheme used to store the client certificate (blob or path)

setting

the NMSetting8021x

 
+
+

Returns

+

scheme used to store the client certificate (blob or path)

+

+
+
-

nm_setting_802_1x_get_client_cert_blob ()

-
const GByteArray *  nm_setting_802_1x_get_client_cert_blob
-                                                        (NMSetting8021x *setting);
-

-Client certificates are used to identify the connecting client to the network +

nm_setting_802_1x_get_client_cert_blob ()

+
const GByteArray *
+nm_setting_802_1x_get_client_cert_blob
+                               (NMSetting8021x *setting);
+

Client certificates are used to identify the connecting client to the network when EAP-TLS is used as either the "phase 1" or "phase 2" 802.1x -authentication method. -

-
+authentication method.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSetting8021x -

Returns :

the client certificate data

setting

the NMSetting8021x

 
+
+

Returns

+

the client certificate data

+

+
+
-

nm_setting_802_1x_get_client_cert_path ()

-
const char *        nm_setting_802_1x_get_client_cert_path
-                                                        (NMSetting8021x *setting);
-

-Client certificates are used to identify the connecting client to the network +

nm_setting_802_1x_get_client_cert_path ()

+
const char *
+nm_setting_802_1x_get_client_cert_path
+                               (NMSetting8021x *setting);
+

Client certificates are used to identify the connecting client to the network when EAP-TLS is used as either the "phase 1" or "phase 2" 802.1x -authentication method. -

-
+authentication method.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSetting8021x -

Returns :

path to the client certificate file

setting

the NMSetting8021x

 
+
+

Returns

+

path to the client certificate file

+

+
+
-

nm_setting_802_1x_set_client_cert ()

-
gboolean            nm_setting_802_1x_set_client_cert   (NMSetting8021x *setting,
-                                                         const char *cert_path,
-                                                         NMSetting8021xCKScheme scheme,
-                                                         NMSetting8021xCKFormat *out_format,
-                                                         GError **error);
-

-Reads a certificate from disk and sets the "client-cert" +

nm_setting_802_1x_set_client_cert ()

+
gboolean
+nm_setting_802_1x_set_client_cert (NMSetting8021x *setting,
+                                   const char *cert_path,
+                                   NMSetting8021xCKScheme scheme,
+                                   NMSetting8021xCKFormat *out_format,
+                                   GError **error);
+

Reads a certificate from disk and sets the “client-cert” property with the raw certificate data if using the NM_SETTING_802_1X_CK_SCHEME_BLOB scheme, or with the path to the certificate -file if using the NM_SETTING_802_1X_CK_SCHEME_PATH scheme. -

-

-Client certificates are used to identify the connecting client to the network +file if using the NM_SETTING_802_1X_CK_SCHEME_PATH scheme.

+

Client certificates are used to identify the connecting client to the network when EAP-TLS is used as either the "phase 1" or "phase 2" 802.1x -authentication method. -

-
+authentication method.

+
+

Parameters

+
--+++ - - + + + - - + - - - - +encoded; use g_filename_to_utf8() to convert if needed. Passing NULL with +any scheme +clears the client certificate.

+ - - + + + - - + + + - - + + +

setting :

the NMSetting8021x -

setting

the NMSetting8021x

 

cert_path :

when scheme is set to either NM_SETTING_802_1X_CK_SCHEME_PATH +

cert_path

when scheme +is set to either NM_SETTING_802_1X_CK_SCHEME_PATH or NM_SETTING_802_1X_CK_SCHEME_BLOB, pass the path of the client certificate file (PEM, DER, or PKCS#12 format). The path must be UTF-8 -encoded; use g_filename_to_utf8() to convert if needed. Passing NULL with -any scheme clears the client certificate.

scheme :

desired storage scheme for the certificate 

out_format :

on successful return, the type of the certificate added

scheme

desired storage scheme for the certificate

 

error :

on unsuccessful return, an error

out_format

on successful return, the type of the certificate added

 

Returns :

-TRUE if the operation succeeded, FALSE if it was unsuccessful

error

on unsuccessful return, an error

 
+
+

Returns

+

TRUE if the operation succeeded, FALSE if it was unsuccessful

+

+
+
-

nm_setting_802_1x_get_phase1_peapver ()

-
const char *        nm_setting_802_1x_get_phase1_peapver
-                                                        (NMSetting8021x *setting);
-
+

nm_setting_802_1x_get_phase1_peapver ()

+
const char *
+nm_setting_802_1x_get_phase1_peapver (NMSetting8021x *setting);
+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSetting8021x -

Returns :

the "phase 1" PEAP version to be used when authenticating with -EAP-PEAP as contained in the "phase1-peapver" property. Valid -values are NULL (unset), "0" (PEAP version 0), and "1" (PEAP version 1).

setting

the NMSetting8021x

 
+
+

Returns

+

the "phase 1" PEAP version to be used when authenticating with +EAP-PEAP as contained in the “phase1-peapver” property. Valid +values are NULL (unset), "0" (PEAP version 0), and "1" (PEAP version 1).

+

+
+
-

nm_setting_802_1x_get_phase1_peaplabel ()

-
const char *        nm_setting_802_1x_get_phase1_peaplabel
-                                                        (NMSetting8021x *setting);
-
+

nm_setting_802_1x_get_phase1_peaplabel ()

+
const char *
+nm_setting_802_1x_get_phase1_peaplabel
+                               (NMSetting8021x *setting);
+
+

Parameters

+
--+++ - - - - - - - - + + + + +

setting :

the NMSetting8021x -

Returns :

whether the "phase 1" PEAP label is new-style or old-style, to be +

setting

the NMSetting8021x

 
+
+
+

Returns

+

whether the "phase 1" PEAP label is new-style or old-style, to be used when authenticating with EAP-PEAP, as contained in the -"phase1-peaplabel" property. Valid values are NULL (unset), +“phase1-peaplabel” property. Valid values are NULL (unset), "0" (use old-style label), and "1" (use new-style label). See the -wpa_supplicant documentation for more details. - - -

+wpa_supplicant documentation for more details.

+

+
-

nm_setting_802_1x_get_phase1_fast_provisioning ()

-
const char *        nm_setting_802_1x_get_phase1_fast_provisioning
-                                                        (NMSetting8021x *setting);
-
+

nm_setting_802_1x_get_phase1_fast_provisioning ()

+
const char *
+nm_setting_802_1x_get_phase1_fast_provisioning
+                               (NMSetting8021x *setting);
+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSetting8021x -

Returns :

whether "phase 1" PEAP fast provisioning should be used, as specified -by the "phase1-fast-provisioning" property. See the -wpa_supplicant documentation for more details.

setting

the NMSetting8021x

 
+
+

Returns

+

whether "phase 1" PEAP fast provisioning should be used, as specified +by the “phase1-fast-provisioning” property. See the +wpa_supplicant documentation for more details.

+

+
+
-

nm_setting_802_1x_get_phase2_auth ()

-
const char *        nm_setting_802_1x_get_phase2_auth   (NMSetting8021x *setting);
-
+

nm_setting_802_1x_get_phase2_auth ()

+
const char *
+nm_setting_802_1x_get_phase2_auth (NMSetting8021x *setting);
+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSetting8021x -

Returns :

the "phase 2" non-EAP (ex MD5) allowed authentication method as -specified by the "phase2-auth" property.

setting

the NMSetting8021x

 
+
+

Returns

+

the "phase 2" non-EAP (ex MD5) allowed authentication method as +specified by the “phase2-auth” property.

+

+
+
-

nm_setting_802_1x_get_phase2_autheap ()

-
const char *        nm_setting_802_1x_get_phase2_autheap
-                                                        (NMSetting8021x *setting);
-
+

nm_setting_802_1x_get_phase2_autheap ()

+
const char *
+nm_setting_802_1x_get_phase2_autheap (NMSetting8021x *setting);
+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSetting8021x -

Returns :

the "phase 2" EAP-based (ex TLS) allowed authentication method as -specified by the "phase2-autheap" property.

setting

the NMSetting8021x

 
+
+

Returns

+

the "phase 2" EAP-based (ex TLS) allowed authentication method as +specified by the “phase2-autheap” property.

+

+
+
-

nm_setting_802_1x_get_phase2_ca_cert_scheme ()

-
NMSetting8021xCKScheme nm_setting_802_1x_get_phase2_ca_cert_scheme
-                                                        (NMSetting8021x *setting);
-

-Returns the scheme used to store the "phase 2" CA certificate. If the +

nm_setting_802_1x_get_phase2_ca_cert_scheme ()

+
NMSetting8021xCKScheme
+nm_setting_802_1x_get_phase2_ca_cert_scheme
+                               (NMSetting8021x *setting);
+

Returns the scheme used to store the "phase 2" CA certificate. If the returned scheme is NM_SETTING_802_1X_CK_SCHEME_BLOB, use -nm_setting_802_1x_get_ca_cert_blob(); if NM_SETTING_802_1X_CK_SCHEME_PATH, -use nm_setting_802_1x_get_ca_cert_path(). -

-
+nm_setting_802_1x_get_ca_cert_blob(); if NM_SETTING_802_1X_CK_SCHEME_PATH, +use nm_setting_802_1x_get_ca_cert_path().

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSetting8021x -

Returns :

scheme used to store the "phase 2" CA certificate (blob or path)

setting

the NMSetting8021x

 
+
+

Returns

+

scheme used to store the "phase 2" CA certificate (blob or path)

+

+
+
-

nm_setting_802_1x_get_phase2_ca_cert_blob ()

-
const GByteArray *  nm_setting_802_1x_get_phase2_ca_cert_blob
-                                                        (NMSetting8021x *setting);
-

-Returns the "phase 2" CA certificate blob if the CA certificate is stored +

nm_setting_802_1x_get_phase2_ca_cert_blob ()

+
const GByteArray *
+nm_setting_802_1x_get_phase2_ca_cert_blob
+                               (NMSetting8021x *setting);
+

Returns the "phase 2" CA certificate blob if the CA certificate is stored using the NM_SETTING_802_1X_CK_SCHEME_BLOB scheme. Not all EAP methods use a CA certificate (LEAP for example), and those that can take advantage of the CA certificate allow it to be unset. Note that lack of a CA certificate reduces security by allowing man-in-the-middle attacks, because the identity -of the network cannot be confirmed by the client. -

-
+of the network cannot be confirmed by the client.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSetting8021x -

Returns :

the "phase 2" CA certificate data

setting

the NMSetting8021x

 
+
+

Returns

+

the "phase 2" CA certificate data

+

+
+
-

nm_setting_802_1x_get_phase2_ca_cert_path ()

-
const char *        nm_setting_802_1x_get_phase2_ca_cert_path
-                                                        (NMSetting8021x *setting);
-

-Returns the "phase 2" CA certificate path if the CA certificate is stored +

nm_setting_802_1x_get_phase2_ca_cert_path ()

+
const char *
+nm_setting_802_1x_get_phase2_ca_cert_path
+                               (NMSetting8021x *setting);
+

Returns the "phase 2" CA certificate path if the CA certificate is stored using the NM_SETTING_802_1X_CK_SCHEME_PATH scheme. Not all EAP methods use a CA certificate (LEAP for example), and those that can take advantage of the CA certificate allow it to be unset. Note that lack of a CA certificate reduces security by allowing man-in-the-middle attacks, because the identity -of the network cannot be confirmed by the client. -

-
+of the network cannot be confirmed by the client.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSetting8021x -

Returns :

path to the "phase 2" CA certificate file

setting

the NMSetting8021x

 
+
+

Returns

+

path to the "phase 2" CA certificate file

+

+
+
-

nm_setting_802_1x_set_phase2_ca_cert ()

-
gboolean            nm_setting_802_1x_set_phase2_ca_cert
-                                                        (NMSetting8021x *setting,
-                                                         const char *cert_path,
-                                                         NMSetting8021xCKScheme scheme,
-                                                         NMSetting8021xCKFormat *out_format,
-                                                         GError **error);
-

-Reads a certificate from disk and sets the "phase2-ca-cert" +

nm_setting_802_1x_set_phase2_ca_cert ()

+
gboolean
+nm_setting_802_1x_set_phase2_ca_cert (NMSetting8021x *setting,
+                                      const char *cert_path,
+                                      NMSetting8021xCKScheme scheme,
+                                      NMSetting8021xCKFormat *out_format,
+                                      GError **error);
+

Reads a certificate from disk and sets the “phase2-ca-cert” property with the raw certificate data if using the NM_SETTING_802_1X_CK_SCHEME_BLOB scheme, or with the path to the certificate -file if using the NM_SETTING_802_1X_CK_SCHEME_PATH scheme. -

-
+file if using the NM_SETTING_802_1X_CK_SCHEME_PATH scheme.

+
+

Parameters

+
--+++ - - + + + - - + +g_filename_to_utf8() to convert if needed. Passing NULL with any scheme +clears the "phase2" CA certificate.

+ - - + + + - - + + + - - - - - - + + +

setting :

the NMSetting8021x -

setting

the NMSetting8021x

 

cert_path :

when scheme is set to either NM_SETTING_802_1X_CK_SCHEME_PATH +

cert_path

when scheme +is set to either NM_SETTING_802_1X_CK_SCHEME_PATH or NM_SETTING_802_1X_CK_SCHEME_BLOB, pass the path of the "phase2" CA certificate file (PEM or DER format). The path must be UTF-8 encoded; use -g_filename_to_utf8() to convert if needed. Passing NULL with any scheme -clears the "phase2" CA certificate.

 

scheme :

desired storage scheme for the certificate

scheme

desired storage scheme for the certificate

 

out_format :

on successful return, the type of the certificate added

out_format

on successful return, the type of the certificate added

 

error :

on unsuccessful return, an error

Returns :

-TRUE if the operation succeeded, FALSE if it was unsuccessful

error

on unsuccessful return, an error

 
+
+

Returns

+

TRUE if the operation succeeded, FALSE if it was unsuccessful

+

+
+
-

nm_setting_802_1x_get_phase2_subject_match ()

-
const char *        nm_setting_802_1x_get_phase2_subject_match
-                                                        (NMSetting8021x *setting);
-
+

nm_setting_802_1x_get_phase2_subject_match ()

+
const char *
+nm_setting_802_1x_get_phase2_subject_match
+                               (NMSetting8021x *setting);
+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSetting8021x -

Returns :

the "phase2-subject-match" property. This is -the substring to be matched against the subject of the "phase 2" -authentication server certificate, or NULL no subject verification -is to be performed.

setting

the NMSetting8021x

 
+
+

Returns

+

the “phase2-subject-match” property. This is +the substring to be matched against the subject of the "phase 2" +authentication server certificate, or NULL no subject verification +is to be performed.

+

+
+
-

nm_setting_802_1x_get_num_phase2_altsubject_matches ()

-
guint32             nm_setting_802_1x_get_num_phase2_altsubject_matches
-                                                        (NMSetting8021x *setting);
-

-Returns the number of entries in the -"phase2-altsubject-matches" property of this setting. -

-
+

nm_setting_802_1x_get_num_phase2_altsubject_matches ()

+
guint32
+nm_setting_802_1x_get_num_phase2_altsubject_matches
+                               (NMSetting8021x *setting);
+

Returns the number of entries in the +“phase2-altsubject-matches” property of this setting.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSetting8021x -

Returns :

the number of phase2-altsubject-matches entries.

setting

the NMSetting8021x

 
+
+

Returns

+

the number of phase2-altsubject-matches entries.

+

+
+
-

nm_setting_802_1x_get_phase2_altsubject_match ()

-
const char *        nm_setting_802_1x_get_phase2_altsubject_match
-                                                        (NMSetting8021x *setting,
-                                                         guint32 i);
-

-Returns the "phase 2" altSubjectName match at index i. -

-
+

nm_setting_802_1x_get_phase2_altsubject_match ()

+
const char *
+nm_setting_802_1x_get_phase2_altsubject_match
+                               (NMSetting8021x *setting,
+                                guint32 i);
+

Returns the "phase 2" altSubjectName match at index i +.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + +

setting :

the NMSettingConnection -

i :

the zero-based index of the array of "phase 2" altSubjectName matches

setting

the NMSettingConnection

 

Returns :

the "phase 2" altSubjectName match at index i -

i

the zero-based index of the array of "phase 2" altSubjectName matches

 
+
+

Returns

+

the "phase 2" altSubjectName match at index i +

+

+
+
-

nm_setting_802_1x_add_phase2_altsubject_match ()

-
gboolean            nm_setting_802_1x_add_phase2_altsubject_match
-                                                        (NMSetting8021x *setting,
-                                                         const char *phase2_altsubject_match);
-

-Adds an allowed alternate subject name match for "phase 2". Until +

nm_setting_802_1x_add_phase2_altsubject_match ()

+
gboolean
+nm_setting_802_1x_add_phase2_altsubject_match
+                               (NMSetting8021x *setting,
+                                const char *phase2_altsubject_match);
+

Adds an allowed alternate subject name match for "phase 2". Until at least one match is added, the altSubjectName of the "phase 2" -remote authentication server is not verified. -

-
+remote authentication server is not verified.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + +

setting :

the NMSetting8021x -

phase2_altsubject_match :

the "phase 2" altSubjectName to allow for this -connection

setting

the NMSetting8021x

 

Returns :

-TRUE if the "phase 2" alternative subject name match was -successfully added, FALSE if it was already allowed.

phase2_altsubject_match

the "phase 2" altSubjectName to allow for this +connection

 
+
+

Returns

+

TRUE if the "phase 2" alternative subject name match was +successfully added, FALSE if it was already allowed.

+

+
+
-

nm_setting_802_1x_remove_phase2_altsubject_match ()

-
void                nm_setting_802_1x_remove_phase2_altsubject_match
-                                                        (NMSetting8021x *setting,
-                                                         guint32 i);
-

-Removes the allowed "phase 2" altSubjectName at the specified index. -

-
+

nm_setting_802_1x_remove_phase2_altsubject_match ()

+
void
+nm_setting_802_1x_remove_phase2_altsubject_match
+                               (NMSetting8021x *setting,
+                                guint32 i);
+

Removes the allowed "phase 2" altSubjectName at the specified index.

+
+

Parameters

+
--+++ - - + + + - - + + +

setting :

the NMSetting8021x -

setting

the NMSetting8021x

 

i :

the index of the "phase 2" altSubjectName match to remove

i

the index of the "phase 2" altSubjectName match to remove

 
+
-

nm_setting_802_1x_remove_phase2_altsubject_match_by_value ()

-
gboolean            nm_setting_802_1x_remove_phase2_altsubject_match_by_value
-                                                        (NMSetting8021x *setting,
-                                                         const char *phase2_altsubject_match);
-

-Removes the allowed "phase 2" altSubjectName phase2_altsubject_match. -

-
+

nm_setting_802_1x_remove_phase2_altsubject_match_by_value ()

+
gboolean
+nm_setting_802_1x_remove_phase2_altsubject_match_by_value
+                               (NMSetting8021x *setting,
+                                const char *phase2_altsubject_match);
+

Removes the allowed "phase 2" altSubjectName phase2_altsubject_match +.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + +

setting :

the NMSetting8021x -

phase2_altsubject_match :

the "phase 2" altSubjectName to remove

setting

the NMSetting8021x

 

Returns :

-TRUE if the alternative subject name match for "phase 2" was found and removed, -FALSE if it was not.

phase2_altsubject_match

the "phase 2" altSubjectName to remove

 
+
+
+

Returns

+

TRUE if the alternative subject name match for "phase 2" was found and removed, +FALSE if it was not.

+

+

Since 0.9.10


-

nm_setting_802_1x_clear_phase2_altsubject_matches ()

-
void                nm_setting_802_1x_clear_phase2_altsubject_matches
-                                                        (NMSetting8021x *setting);
-

-Clears all "phase 2" altSubjectName matches. -

-
+

nm_setting_802_1x_clear_phase2_altsubject_matches ()

+
void
+nm_setting_802_1x_clear_phase2_altsubject_matches
+                               (NMSetting8021x *setting);
+

Clears all "phase 2" altSubjectName matches.

+
+

Parameters

+
--+++ - - + + +

setting :

the NMSetting8021x -

setting

the NMSetting8021x

 
+
-

nm_setting_802_1x_get_phase2_client_cert_scheme ()

-
NMSetting8021xCKScheme nm_setting_802_1x_get_phase2_client_cert_scheme
-                                                        (NMSetting8021x *setting);
-

-Returns the scheme used to store the "phase 2" client certificate. If the +

nm_setting_802_1x_get_phase2_client_cert_scheme ()

+
NMSetting8021xCKScheme
+nm_setting_802_1x_get_phase2_client_cert_scheme
+                               (NMSetting8021x *setting);
+

Returns the scheme used to store the "phase 2" client certificate. If the returned scheme is NM_SETTING_802_1X_CK_SCHEME_BLOB, use -nm_setting_802_1x_get_client_cert_blob(); if +nm_setting_802_1x_get_client_cert_blob(); if NM_SETTING_802_1X_CK_SCHEME_PATH, use -nm_setting_802_1x_get_client_cert_path(). -

-
+nm_setting_802_1x_get_client_cert_path().

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSetting8021x -

Returns :

scheme used to store the "phase 2" client certificate (blob or path)

setting

the NMSetting8021x

 
+
+

Returns

+

scheme used to store the "phase 2" client certificate (blob or path)

+

+
+
-

nm_setting_802_1x_get_phase2_client_cert_blob ()

-
const GByteArray *  nm_setting_802_1x_get_phase2_client_cert_blob
-                                                        (NMSetting8021x *setting);
-

-Client certificates are used to identify the connecting client to the network +

nm_setting_802_1x_get_phase2_client_cert_blob ()

+
const GByteArray *
+nm_setting_802_1x_get_phase2_client_cert_blob
+                               (NMSetting8021x *setting);
+

Client certificates are used to identify the connecting client to the network when EAP-TLS is used as either the "phase 1" or "phase 2" 802.1x -authentication method. -

-
+authentication method.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSetting8021x -

Returns :

the "phase 2" client certificate data

setting

the NMSetting8021x

 
+
+

Returns

+

the "phase 2" client certificate data

+

+
+
-

nm_setting_802_1x_get_phase2_client_cert_path ()

-
const char *        nm_setting_802_1x_get_phase2_client_cert_path
-                                                        (NMSetting8021x *setting);
-

-Client certificates are used to identify the connecting client to the network +

nm_setting_802_1x_get_phase2_client_cert_path ()

+
const char *
+nm_setting_802_1x_get_phase2_client_cert_path
+                               (NMSetting8021x *setting);
+

Client certificates are used to identify the connecting client to the network when EAP-TLS is used as either the "phase 1" or "phase 2" 802.1x -authentication method. -

-
+authentication method.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSetting8021x -

Returns :

path to the "phase 2" client certificate file

setting

the NMSetting8021x

 
+
+

Returns

+

path to the "phase 2" client certificate file

+

+
+
-

nm_setting_802_1x_set_phase2_client_cert ()

-
gboolean            nm_setting_802_1x_set_phase2_client_cert
-                                                        (NMSetting8021x *setting,
-                                                         const char *cert_path,
-                                                         NMSetting8021xCKScheme scheme,
-                                                         NMSetting8021xCKFormat *out_format,
-                                                         GError **error);
-

-Reads a certificate from disk and sets the "phase2-client-cert" +

nm_setting_802_1x_set_phase2_client_cert ()

+
gboolean
+nm_setting_802_1x_set_phase2_client_cert
+                               (NMSetting8021x *setting,
+                                const char *cert_path,
+                                NMSetting8021xCKScheme scheme,
+                                NMSetting8021xCKFormat *out_format,
+                                GError **error);
+

Reads a certificate from disk and sets the “phase2-client-cert” property with the raw certificate data if using the NM_SETTING_802_1X_CK_SCHEME_BLOB scheme, or with the path to the certificate -file if using the NM_SETTING_802_1X_CK_SCHEME_PATH scheme. -

-

-Client certificates are used to identify the connecting client to the network +file if using the NM_SETTING_802_1X_CK_SCHEME_PATH scheme.

+

Client certificates are used to identify the connecting client to the network when EAP-TLS is used as either the "phase 1" or "phase 2" 802.1x -authentication method. -

-
+authentication method.

+
+

Parameters

+
--+++ - - + + + - - + - - - - +encoded; use g_filename_to_utf8() to convert if needed. Passing NULL with +any scheme +clears the "phase2" client certificate.

+ - - + + + - - + + + - - + + +

setting :

the NMSetting8021x -

setting

the NMSetting8021x

 

cert_path :

when scheme is set to either NM_SETTING_802_1X_CK_SCHEME_PATH +

cert_path

when scheme +is set to either NM_SETTING_802_1X_CK_SCHEME_PATH or NM_SETTING_802_1X_CK_SCHEME_BLOB, pass the path of the "phase2" client certificate file (PEM, DER, or PKCS#12 format). The path must be UTF-8 -encoded; use g_filename_to_utf8() to convert if needed. Passing NULL with -any scheme clears the "phase2" client certificate.

scheme :

desired storage scheme for the certificate 

out_format :

on successful return, the type of the certificate added

scheme

desired storage scheme for the certificate

 

error :

on unsuccessful return, an error

out_format

on successful return, the type of the certificate added

 

Returns :

-TRUE if the operation succeeded, FALSE if it was unsuccessful

error

on unsuccessful return, an error

 
+
+

Returns

+

TRUE if the operation succeeded, FALSE if it was unsuccessful

+

+
+
-

nm_setting_802_1x_get_password ()

-
const char *        nm_setting_802_1x_get_password      (NMSetting8021x *setting);
-
+

nm_setting_802_1x_get_password ()

+
const char *
+nm_setting_802_1x_get_password (NMSetting8021x *setting);
+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSetting8021x -

Returns :

the password used by the authentication method, if any, as specified -by the "password" property

setting

the NMSetting8021x

 
-
-
-

nm_setting_802_1x_get_password_flags ()

-
NMSettingSecretFlags nm_setting_802_1x_get_password_flags
-                                                        (NMSetting8021x *setting);
-
---- - - - - - - - - - - +
+

Returns

+

the password used by the authentication method, if any, as specified +by the “password” property

+

+
+ +
+
+

nm_setting_802_1x_get_password_flags ()

+
NMSettingSecretFlags
+nm_setting_802_1x_get_password_flags (NMSetting8021x *setting);
+
+

Parameters

+

setting :

the NMSetting8021x -

Returns :

the NMSettingSecretFlags pertaining to the "password" -
+++++ + + + + +

setting

the NMSetting8021x

 
+
+

Returns

+

the NMSettingSecretFlags pertaining to the “password”

+

+
+
-

nm_setting_802_1x_get_password_raw ()

-
const GByteArray *  nm_setting_802_1x_get_password_raw  (NMSetting8021x *setting);
-
+

nm_setting_802_1x_get_password_raw ()

+
const GByteArray *
+nm_setting_802_1x_get_password_raw (NMSetting8021x *setting);
+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSetting8021x -

Returns :

the password used by the authentication method as a -UTF-8-encoded array of bytes, as specified by the -"password-raw" property

setting

the NMSetting8021x

 
+
+

Returns

+

the password used by the authentication method as a +UTF-8-encoded array of bytes, as specified by the +“password-raw” property

+

+
+
-

nm_setting_802_1x_get_password_raw_flags ()

-
NMSettingSecretFlags nm_setting_802_1x_get_password_raw_flags
-                                                        (NMSetting8021x *setting);
-
+

nm_setting_802_1x_get_password_raw_flags ()

+
NMSettingSecretFlags
+nm_setting_802_1x_get_password_raw_flags
+                               (NMSetting8021x *setting);
+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSetting8021x -

Returns :

the NMSettingSecretFlags pertaining to the -"password-raw" -

setting

the NMSetting8021x

 
+
+

Returns

+

the NMSettingSecretFlags pertaining to the +“password-raw”

+

+
+
-

nm_setting_802_1x_get_pin ()

-
const char *        nm_setting_802_1x_get_pin           (NMSetting8021x *setting);
-
+

nm_setting_802_1x_get_pin ()

+
const char *
+nm_setting_802_1x_get_pin (NMSetting8021x *setting);
+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSetting8021x -

Returns :

the PIN used by the authentication method, if any, as specified -by the "pin" property

setting

the NMSetting8021x

 
+
+

Returns

+

the PIN used by the authentication method, if any, as specified +by the “pin” property

+

+
+
-

nm_setting_802_1x_get_pin_flags ()

-
NMSettingSecretFlags nm_setting_802_1x_get_pin_flags    (NMSetting8021x *setting);
-
+

nm_setting_802_1x_get_pin_flags ()

+
NMSettingSecretFlags
+nm_setting_802_1x_get_pin_flags (NMSetting8021x *setting);
+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSetting8021x -

Returns :

the NMSettingSecretFlags pertaining to the -"pin" -

setting

the NMSetting8021x

 
+
+

Returns

+

the NMSettingSecretFlags pertaining to the +“pin”

+

+
+
-

nm_setting_802_1x_get_private_key_scheme ()

-
NMSetting8021xCKScheme nm_setting_802_1x_get_private_key_scheme
-                                                        (NMSetting8021x *setting);
-

-Returns the scheme used to store the private key. If the returned scheme is +

nm_setting_802_1x_get_private_key_scheme ()

+
NMSetting8021xCKScheme
+nm_setting_802_1x_get_private_key_scheme
+                               (NMSetting8021x *setting);
+

Returns the scheme used to store the private key. If the returned scheme is NM_SETTING_802_1X_CK_SCHEME_BLOB, use -nm_setting_802_1x_get_client_cert_blob(); if +nm_setting_802_1x_get_client_cert_blob(); if NM_SETTING_802_1X_CK_SCHEME_PATH, use -nm_setting_802_1x_get_client_cert_path(). -

-
+nm_setting_802_1x_get_client_cert_path().

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSetting8021x -

Returns :

scheme used to store the private key (blob or path)

setting

the NMSetting8021x

 
+
+

Returns

+

scheme used to store the private key (blob or path)

+

+
+
-

nm_setting_802_1x_get_private_key_blob ()

-
const GByteArray *  nm_setting_802_1x_get_private_key_blob
-                                                        (NMSetting8021x *setting);
-

-Private keys are used to authenticate the connecting client to the network +

nm_setting_802_1x_get_private_key_blob ()

+
const GByteArray *
+nm_setting_802_1x_get_private_key_blob
+                               (NMSetting8021x *setting);
+

Private keys are used to authenticate the connecting client to the network when EAP-TLS is used as either the "phase 1" or "phase 2" 802.1x -authentication method. -

-

-WARNING: the private key property is not a "secret" property, and thus +authentication method.

+

WARNING: the private key property is not a "secret" property, and thus unencrypted private key data may be readable by unprivileged users. Private -keys should always be encrypted with a private key password. -

-
+keys should always be encrypted with a private key password.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSetting8021x -

Returns :

the private key data

setting

the NMSetting8021x

 
+
+

Returns

+

the private key data

+

+
+
-

nm_setting_802_1x_get_private_key_path ()

-
const char *        nm_setting_802_1x_get_private_key_path
-                                                        (NMSetting8021x *setting);
-

-Private keys are used to authenticate the connecting client to the network +

nm_setting_802_1x_get_private_key_path ()

+
const char *
+nm_setting_802_1x_get_private_key_path
+                               (NMSetting8021x *setting);
+

Private keys are used to authenticate the connecting client to the network when EAP-TLS is used as either the "phase 1" or "phase 2" 802.1x -authentication method. -

-
+authentication method.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSetting8021x -

Returns :

path to the private key file

setting

the NMSetting8021x

 
+
+

Returns

+

path to the private key file

+

+
+
-

nm_setting_802_1x_set_private_key ()

-
gboolean            nm_setting_802_1x_set_private_key   (NMSetting8021x *setting,
-                                                         const char *key_path,
-                                                         const char *password,
-                                                         NMSetting8021xCKScheme scheme,
-                                                         NMSetting8021xCKFormat *out_format,
-                                                         GError **error);
-

-Private keys are used to authenticate the connecting client to the network +

nm_setting_802_1x_set_private_key ()

+
gboolean
+nm_setting_802_1x_set_private_key (NMSetting8021x *setting,
+                                   const char *key_path,
+                                   const char *password,
+                                   NMSetting8021xCKScheme scheme,
+                                   NMSetting8021xCKFormat *out_format,
+                                   GError **error);
+

Private keys are used to authenticate the connecting client to the network when EAP-TLS is used as either the "phase 1" or "phase 2" 802.1x -authentication method. -

-

-This function reads a private key from disk and sets the -"private-key" property with the private key file data if using +authentication method.

+

This function reads a private key from disk and sets the +“private-key” property with the private key file data if using the NM_SETTING_802_1X_CK_SCHEME_BLOB scheme, or with the path to the private -key file if using the NM_SETTING_802_1X_CK_SCHEME_PATH scheme. -

-

-If password is given, this function attempts to decrypt the private key to -verify that password is correct, and if it is, updates the -"private-key-password" property with the given password. If -the decryption is unsuccessful, FALSE is returned, error is set, and no -internal data is changed. If no password is given, the private key is +key file if using the NM_SETTING_802_1X_CK_SCHEME_PATH scheme.

+

If password + is given, this function attempts to decrypt the private key to +verify that password + is correct, and if it is, updates the +“private-key-password” property with the given password +. If +the decryption is unsuccessful, FALSE is returned, error + is set, and no +internal data is changed. If no password + is given, the private key is assumed to be valid, no decryption is performed, and the password may be set -at a later time. -

-

-WARNING: the private key property is not a "secret" property, and thus +at a later time.

+

WARNING: the private key property is not a "secret" property, and thus unencrypted private key data using the BLOB scheme may be readable by unprivileged users. Private keys should always be encrypted with a private -key password to prevent unauthorized access to unencrypted private key data. -

-
+key password to prevent unauthorized access to unencrypted private key data.

+
+

Parameters

+
--+++ - - + + + - - + +g_filename_to_utf8() to convert if needed. Passing NULL with any scheme +clears the private key.

+ - - + - - - - +an error is returned.

+ - - + + + - - + + + - - + + +

setting :

the NMSetting8021x -

setting

the NMSetting8021x

 

key_path :

when scheme is set to either NM_SETTING_802_1X_CK_SCHEME_PATH or +

key_path

when scheme +is set to either NM_SETTING_802_1X_CK_SCHEME_PATH or NM_SETTING_802_1X_CK_SCHEME_BLOB, pass the path of the private key file (PEM, DER, or PKCS#12 format). The path must be UTF-8 encoded; use -g_filename_to_utf8() to convert if needed. Passing NULL with any scheme -clears the private key.

 

password :

password used to decrypt the private key, or NULL if the password +

password

password used to decrypt the private key, or NULL if the password is unknown. If the password is given but fails to decrypt the private key, -an error is returned.

scheme :

desired storage scheme for the private key 

out_format :

on successful return, the type of the private key added

scheme

desired storage scheme for the private key

 

error :

on unsuccessful return, an error

out_format

on successful return, the type of the private key added

 

Returns :

-TRUE if the operation succeeded, FALSE if it was unsuccessful

error

on unsuccessful return, an error

 
+
+

Returns

+

TRUE if the operation succeeded, FALSE if it was unsuccessful

+

+
+
-

nm_setting_802_1x_get_private_key_password ()

-
const char *        nm_setting_802_1x_get_private_key_password
-                                                        (NMSetting8021x *setting);
-
+

nm_setting_802_1x_get_private_key_password ()

+
const char *
+nm_setting_802_1x_get_private_key_password
+                               (NMSetting8021x *setting);
+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSetting8021x -

Returns :

the private key password used to decrypt the private key if -previously set with nm_setting_802_1x_set_private_key(), or the -"private-key-password" property.

setting

the NMSetting8021x

 
+
+

Returns

+

the private key password used to decrypt the private key if +previously set with nm_setting_802_1x_set_private_key(), or the +“private-key-password” property.

+

+
+
-

nm_setting_802_1x_get_private_key_password_flags ()

-
NMSettingSecretFlags nm_setting_802_1x_get_private_key_password_flags
-                                                        (NMSetting8021x *setting);
-
+

nm_setting_802_1x_get_private_key_password_flags ()

+
NMSettingSecretFlags
+nm_setting_802_1x_get_private_key_password_flags
+                               (NMSetting8021x *setting);
+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSetting8021x -

Returns :

the NMSettingSecretFlags pertaining to the -"private-key-password" -

setting

the NMSetting8021x

 
+
+

Returns

+

the NMSettingSecretFlags pertaining to the +“private-key-password”

+

+
+
-

nm_setting_802_1x_get_private_key_format ()

-
NMSetting8021xCKFormat nm_setting_802_1x_get_private_key_format
-                                                        (NMSetting8021x *setting);
-
+

nm_setting_802_1x_get_private_key_format ()

+
NMSetting8021xCKFormat
+nm_setting_802_1x_get_private_key_format
+                               (NMSetting8021x *setting);
+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSetting8021x -

Returns :

the data format of the private key data stored in the -"private-key" property

setting

the NMSetting8021x

 
+
+

Returns

+

the data format of the private key data stored in the +“private-key” property

+

+
+
-

nm_setting_802_1x_get_phase2_private_key_scheme ()

-
NMSetting8021xCKScheme nm_setting_802_1x_get_phase2_private_key_scheme
-                                                        (NMSetting8021x *setting);
-

-Returns the scheme used to store the "phase 2" private key. If the returned +

nm_setting_802_1x_get_phase2_private_key_scheme ()

+
NMSetting8021xCKScheme
+nm_setting_802_1x_get_phase2_private_key_scheme
+                               (NMSetting8021x *setting);
+

Returns the scheme used to store the "phase 2" private key. If the returned scheme is NM_SETTING_802_1X_CK_SCHEME_BLOB, use -nm_setting_802_1x_get_client_cert_blob(); if +nm_setting_802_1x_get_client_cert_blob(); if NM_SETTING_802_1X_CK_SCHEME_PATH, use -nm_setting_802_1x_get_client_cert_path(). -

-
+nm_setting_802_1x_get_client_cert_path().

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSetting8021x -

Returns :

scheme used to store the "phase 2" private key (blob or path)

setting

the NMSetting8021x

 
+
+

Returns

+

scheme used to store the "phase 2" private key (blob or path)

+

+
+
-

nm_setting_802_1x_get_phase2_private_key_blob ()

-
const GByteArray *  nm_setting_802_1x_get_phase2_private_key_blob
-                                                        (NMSetting8021x *setting);
-

-Private keys are used to authenticate the connecting client to the network +

nm_setting_802_1x_get_phase2_private_key_blob ()

+
const GByteArray *
+nm_setting_802_1x_get_phase2_private_key_blob
+                               (NMSetting8021x *setting);
+

Private keys are used to authenticate the connecting client to the network when EAP-TLS is used as either the "phase 1" or "phase 2" 802.1x -authentication method. -

-

-WARNING: the phase2 private key property is not a "secret" property, and thus +authentication method.

+

WARNING: the phase2 private key property is not a "secret" property, and thus unencrypted private key data may be readable by unprivileged users. Private -keys should always be encrypted with a private key password. -

-
+keys should always be encrypted with a private key password.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSetting8021x -

Returns :

the "phase 2" private key data

setting

the NMSetting8021x

 
+
+

Returns

+

the "phase 2" private key data

+

+
+
-

nm_setting_802_1x_get_phase2_private_key_path ()

-
const char *        nm_setting_802_1x_get_phase2_private_key_path
-                                                        (NMSetting8021x *setting);
-

-Private keys are used to authenticate the connecting client to the network +

nm_setting_802_1x_get_phase2_private_key_path ()

+
const char *
+nm_setting_802_1x_get_phase2_private_key_path
+                               (NMSetting8021x *setting);
+

Private keys are used to authenticate the connecting client to the network when EAP-TLS is used as either the "phase 1" or "phase 2" 802.1x -authentication method. -

-
+authentication method.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSetting8021x -

Returns :

path to the "phase 2" private key file

setting

the NMSetting8021x

 
+
+

Returns

+

path to the "phase 2" private key file

+

+
+
-

nm_setting_802_1x_set_phase2_private_key ()

-
gboolean            nm_setting_802_1x_set_phase2_private_key
-                                                        (NMSetting8021x *setting,
-                                                         const char *key_path,
-                                                         const char *password,
-                                                         NMSetting8021xCKScheme scheme,
-                                                         NMSetting8021xCKFormat *out_format,
-                                                         GError **error);
-

-Private keys are used to authenticate the connecting client to the network +

nm_setting_802_1x_set_phase2_private_key ()

+
gboolean
+nm_setting_802_1x_set_phase2_private_key
+                               (NMSetting8021x *setting,
+                                const char *key_path,
+                                const char *password,
+                                NMSetting8021xCKScheme scheme,
+                                NMSetting8021xCKFormat *out_format,
+                                GError **error);
+

Private keys are used to authenticate the connecting client to the network when EAP-TLS is used as either the "phase 1" or "phase 2" 802.1x -authentication method. -

-

-This function reads a private key from disk and sets the -"phase2-private-key" property with the private key file data if +authentication method.

+

This function reads a private key from disk and sets the +“phase2-private-key” property with the private key file data if using the NM_SETTING_802_1X_CK_SCHEME_BLOB scheme, or with the path to the -private key file if using the NM_SETTING_802_1X_CK_SCHEME_PATH scheme. -

-

-If password is given, this function attempts to decrypt the private key to -verify that password is correct, and if it is, updates the -"phase2-private-key-password" property with the given -password. If the decryption is unsuccessful, FALSE is returned, error is -set, and no internal data is changed. If no password is given, the private +private key file if using the NM_SETTING_802_1X_CK_SCHEME_PATH scheme.

+

If password + is given, this function attempts to decrypt the private key to +verify that password + is correct, and if it is, updates the +“phase2-private-key-password” property with the given +password +. If the decryption is unsuccessful, FALSE is returned, error + is +set, and no internal data is changed. If no password + is given, the private key is assumed to be valid, no decryption is performed, and the password may -be set at a later time. -

-

-WARNING: the "phase2" private key property is not a "secret" property, and +be set at a later time.

+

WARNING: the "phase2" private key property is not a "secret" property, and thus unencrypted private key data using the BLOB scheme may be readable by unprivileged users. Private keys should always be encrypted with a private -key password to prevent unauthorized access to unencrypted private key data. -

-
+key password to prevent unauthorized access to unencrypted private key data.

+
+

Parameters

+
--+++ - - + + + - - + +use g_filename_to_utf8() to convert if needed. Passing NULL with any +scheme +clears the private key.

+ - - + - - - - +an error is returned.

+ - - + + + - - + + + - - + + +

setting :

the NMSetting8021x -

setting

the NMSetting8021x

 

key_path :

when scheme is set to either NM_SETTING_802_1X_CK_SCHEME_PATH or +

key_path

when scheme +is set to either NM_SETTING_802_1X_CK_SCHEME_PATH or NM_SETTING_802_1X_CK_SCHEME_BLOB, pass the path of the "phase2" private key file (PEM, DER, or PKCS#12 format). The path must be UTF-8 encoded; -use g_filename_to_utf8() to convert if needed. Passing NULL with any -scheme clears the private key.

 

password :

password used to decrypt the private key, or NULL if the password +

password

password used to decrypt the private key, or NULL if the password is unknown. If the password is given but fails to decrypt the private key, -an error is returned.

scheme :

desired storage scheme for the private key 

out_format :

on successful return, the type of the private key added

scheme

desired storage scheme for the private key

 

error :

on unsuccessful return, an error

out_format

on successful return, the type of the private key added

 

Returns :

-TRUE if the operation succeeded, FALSE if it was unsuccessful

error

on unsuccessful return, an error

 
+
+

Returns

+

TRUE if the operation succeeded, FALSE if it was unsuccessful

+

+
+ +
+
+

nm_setting_802_1x_get_phase2_private_key_password ()

+
const char *
+nm_setting_802_1x_get_phase2_private_key_password
+                               (NMSetting8021x *setting);
+
+

Parameters

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

setting

the NMSetting8021x

 
+
+
+

Returns

+

the private key password used to decrypt the private key if +previously set with nm_setting_802_1x_set_phase2_private_key() or the +“phase2-private-key-password” property.

+

+
+
+
+
+

nm_setting_802_1x_get_phase2_private_key_password_flags ()

+
NMSettingSecretFlags
+nm_setting_802_1x_get_phase2_private_key_password_flags
+                               (NMSetting8021x *setting);
+
+

Parameters

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

setting

the NMSetting8021x

 
+
+
+

Returns

+

the NMSettingSecretFlags pertaining to the +“phase2-private-key-password”

+

+
+

-

nm_setting_802_1x_get_phase2_private_key_password ()

-
const char *        nm_setting_802_1x_get_phase2_private_key_password
-                                                        (NMSetting8021x *setting);
-
+

nm_setting_802_1x_get_phase2_private_key_format ()

+
NMSetting8021xCKFormat
+nm_setting_802_1x_get_phase2_private_key_format
+                               (NMSetting8021x *setting);
+
+

Parameters

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

setting

the NMSetting8021x

 
+
+
+

Returns

+

the data format of the "phase 2" private key data stored in the +“phase2-private-key” property

+

+
+ + +
+

Types and Values

+
+

enum NMSetting8021xCKFormat

+

NMSetting8021xCKFormat values indicate the general type of a certificate +or private key

+
+

Members

+
--+++ - - + + + + + + + - - + + + + + + + +

setting :

the NMSetting8021x +

NM_SETTING_802_1X_CK_FORMAT_UNKNOWN

+

unknown file format

+
 

NM_SETTING_802_1X_CK_FORMAT_X509

+

file contains an X.509 format certificate

 

Returns :

the private key password used to decrypt the private key if -previously set with nm_setting_802_1x_set_phase2_private_key() or the -"phase2-private-key-password" property.

NM_SETTING_802_1X_CK_FORMAT_RAW_KEY

+

file contains an old-style OpenSSL PEM +or DER private key

+
 

NM_SETTING_802_1X_CK_FORMAT_PKCS12

+

file contains a PKCS#12 certificate +and private key

+
 
+

-

nm_setting_802_1x_get_phase2_private_key_password_flags ()

-
NMSettingSecretFlags nm_setting_802_1x_get_phase2_private_key_password_flags
-                                                        (NMSetting8021x *setting);
-
+

enum NMSetting8021xCKScheme

+

NMSetting8021xCKScheme values indicate how a certificate or private key is +stored in the setting properties, either as a blob of the item's data, or as +a path to a certificate or private key file on the filesystem

+
+

Members

+
--+++ - - + + + + + + + - - + +

setting :

the NMSetting8021x +

NM_SETTING_802_1X_CK_SCHEME_UNKNOWN

+

unknown certificate or private key +scheme

+
 

NM_SETTING_802_1X_CK_SCHEME_BLOB

+

certificate or key is stored as the raw +item data

 

Returns :

the NMSettingSecretFlags pertaining to the -"phase2-private-key-password" +

NM_SETTING_802_1X_CK_SCHEME_PATH

+

certificate or key is stored as a path +to a file containing the certificate or key data

 
+
+
+
+

NM_SETTING_802_1X_SETTING_NAME

+
#define NM_SETTING_802_1X_SETTING_NAME "802-1x"
+
+

+

+

-

nm_setting_802_1x_get_phase2_private_key_format ()

-
NMSetting8021xCKFormat nm_setting_802_1x_get_phase2_private_key_format
-                                                        (NMSetting8021x *setting);
-
+

enum NMSetting8021xError

+
+

Members

+
--+++ - - + + + + + + + - - + + +

setting :

the NMSetting8021x +

NM_SETTING_802_1X_ERROR_UNKNOWN

+

unknown or unclassified error

+
 

NM_SETTING_802_1X_ERROR_INVALID_PROPERTY

+

the property was invalid

 

Returns :

the data format of the "phase 2" private key data stored in the -"phase2-private-key" property

NM_SETTING_802_1X_ERROR_MISSING_PROPERTY

+

the property was missing and is +required

+
 
-
-

Property Details

+
-

The "altsubject-matches" property

-
  "altsubject-matches"       GSList_gchararray_*   : Read / Write
+

NM_SETTING_802_1X_ERROR

+
#define NM_SETTING_802_1X_ERROR nm_setting_802_1x_error_quark ()
+

-List of strings to be matched against the altSubjectName of the -certificate presented by the authentication server. If the list is empty, -no verification of the server certificate's altSubjectName is performed.


-

The "anonymous-identity" property

-
  "anonymous-identity"       gchar*                : Read / Write
+

NM_SETTING_802_1X_EAP

+
#define NM_SETTING_802_1X_EAP "eap"
+

-Anonymous identity string for EAP authentication methods. Used as the -unencrypted identity with EAP types that support different tunneled -identity like EAP-TTLS.

-

Default value: NULL


-

The "ca-cert" property

-
  "ca-cert"                  GArray_guchar_*       : Read / Write
+

NM_SETTING_802_1X_IDENTITY

+
#define NM_SETTING_802_1X_IDENTITY "identity"
+

-Contains the CA certificate if used by the EAP method specified in the -"eap" property.

+
+
+
+

NM_SETTING_802_1X_ANONYMOUS_IDENTITY

+
#define NM_SETTING_802_1X_ANONYMOUS_IDENTITY "anonymous-identity"
+

-Certificate data is specified using a "scheme"; two are currently -supported: blob and path. When using the blob scheme (which is backwards -compatible with NM 0.7.x) this property should be set to the -certificate's DER encoded data. When using the path scheme, this property -should be set to the full UTF-8 encoded path of the certificate, prefixed -with the string "file://" and ending with a terminating NUL byte. This -property can be unset even if the EAP method supports CA certificates, -but this allows man-in-the-middle attacks and is NOT recommended.

+
+
+
+

NM_SETTING_802_1X_PAC_FILE

+
#define NM_SETTING_802_1X_PAC_FILE "pac-file"
+

-Setting this property directly is discouraged; use the -nm_setting_802_1x_set_ca_cert() function instead.


-

The "ca-path" property

-
  "ca-path"                  gchar*                : Read / Write
+

NM_SETTING_802_1X_CA_CERT

+
#define NM_SETTING_802_1X_CA_CERT "ca-cert"
+

-UTF-8 encoded path to a directory containing PEM or DER formatted -certificates to be added to the verification chain in addition to the -certificate specified in the "ca-cert" property.

-

Default value: NULL


-

The "client-cert" property

-
  "client-cert"              GArray_guchar_*       : Read / Write
+

NM_SETTING_802_1X_CA_PATH

+
#define NM_SETTING_802_1X_CA_PATH "ca-path"
+

-Contains the client certificate if used by the EAP method specified in -the "eap" property.

+
+
+
+

NM_SETTING_802_1X_SUBJECT_MATCH

+
#define NM_SETTING_802_1X_SUBJECT_MATCH "subject-match"
+

-Certificate data is specified using a "scheme"; two are currently -supported: blob and path. When using the blob scheme (which is backwards -compatible with NM 0.7.x) this property should be set to the -certificate's DER encoded data. When using the path scheme, this property -should be set to the full UTF-8 encoded path of the certificate, prefixed -with the string "file://" and ending with a terminating NUL byte.

+
+
+
+

NM_SETTING_802_1X_ALTSUBJECT_MATCHES

+
#define NM_SETTING_802_1X_ALTSUBJECT_MATCHES "altsubject-matches"
+

-Setting this property directly is discouraged; use the -nm_setting_802_1x_set_client_cert() function instead.


-

The "eap" property

-
  "eap"                      GSList_gchararray_*   : Read / Write
+

NM_SETTING_802_1X_CLIENT_CERT

+
#define NM_SETTING_802_1X_CLIENT_CERT "client-cert"
+

-The allowed EAP method to be used when authenticating to the network with -802.1x. Valid methods are: "leap", "md5", "tls", "peap", "ttls", "pwd", -and "fast". Each method requires different configuration using the -properties of this setting; refer to wpa_supplicant documentation for the -allowed combinations.


-

The "identity" property

-
  "identity"                 gchar*                : Read / Write
+

NM_SETTING_802_1X_PHASE1_PEAPVER

+
#define NM_SETTING_802_1X_PHASE1_PEAPVER "phase1-peapver"
+

-Identity string for EAP authentication methods. Often the user's user or -login name.

-

Default value: NULL


-

The "pac-file" property

-
  "pac-file"                 gchar*                : Read / Write
+

NM_SETTING_802_1X_PHASE1_PEAPLABEL

+
#define NM_SETTING_802_1X_PHASE1_PEAPLABEL "phase1-peaplabel"
+

-UTF-8 encoded file path containing PAC for EAP-FAST.

-

Default value: NULL


-

The "password" property

-
  "password"                 gchar*                : Read / Write
+

NM_SETTING_802_1X_PHASE1_FAST_PROVISIONING

+
#define NM_SETTING_802_1X_PHASE1_FAST_PROVISIONING "phase1-fast-provisioning"
+

-UTF-8 encoded password used for EAP authentication methods. If both the -"password" property and the "password-raw" -property are specified, "password" is preferred.

-

Default value: NULL


-

The "password-flags" property

-
  "password-flags"           guint                 : Read / Write
+

NM_SETTING_802_1X_PHASE2_AUTH

+
#define NM_SETTING_802_1X_PHASE2_AUTH "phase2-auth"
+

-Flags indicating how to handle the "password" property.

-

Allowed values: <= 7

-

Default value: 0


-

The "password-raw" property

-
  "password-raw"             GArray_guchar_*       : Read / Write
+

NM_SETTING_802_1X_PHASE2_AUTHEAP

+
#define NM_SETTING_802_1X_PHASE2_AUTHEAP "phase2-autheap"
+

-Password used for EAP authentication methods, given as a byte array to -allow passwords in other encodings than UTF-8 to be used. If both the -"password" property and the "password-raw" -property are specified, "password" is preferred.


-

The "password-raw-flags" property

-
  "password-raw-flags"       guint                 : Read / Write
+

NM_SETTING_802_1X_PHASE2_CA_CERT

+
#define NM_SETTING_802_1X_PHASE2_CA_CERT "phase2-ca-cert"
+

-Flags indicating how to handle the "password-raw" property.

-

Allowed values: <= 7

-

Default value: 0


-

The "phase1-fast-provisioning" property

-
  "phase1-fast-provisioning" gchar*                : Read / Write
+

NM_SETTING_802_1X_PHASE2_CA_PATH

+
#define NM_SETTING_802_1X_PHASE2_CA_PATH "phase2-ca-path"
+

-Enables or disables in-line provisioning of EAP-FAST credentials when -FAST is specified as the EAP method in the "eap" property. -Recognized values are "0" (disabled), "1" (allow unauthenticated -provisioning), "2" (allow authenticated provisioning), and "3" (allow -both authenticated and unauthenticated provisioning). See the -wpa_supplicant documentation for more details.

-

Default value: NULL


-

The "phase1-peaplabel" property

-
  "phase1-peaplabel"         gchar*                : Read / Write
+

NM_SETTING_802_1X_PHASE2_SUBJECT_MATCH

+
#define NM_SETTING_802_1X_PHASE2_SUBJECT_MATCH "phase2-subject-match"
+

-Forces use of the new PEAP label during key derivation. Some RADIUS -servers may require forcing the new PEAP label to interoperate with -PEAPv1. Set to "1" to force use of the new PEAP label. See the -wpa_supplicant documentation for more details.

-

Default value: NULL


-

The "phase1-peapver" property

-
  "phase1-peapver"           gchar*                : Read / Write
+

NM_SETTING_802_1X_PHASE2_ALTSUBJECT_MATCHES

+
#define NM_SETTING_802_1X_PHASE2_ALTSUBJECT_MATCHES "phase2-altsubject-matches"
+

-Forces which PEAP version is used when PEAP is set as the EAP method in -the "eap" property. When unset, the version reported by -the server will be used. Sometimes when using older RADIUS servers, it -is necessary to force the client to use a particular PEAP version. To do -so, this property may be set to "0" or "1" to force that specific PEAP -version.

-

Default value: NULL


-

The "phase2-altsubject-matches" property

-
  "phase2-altsubject-matches" GSList_gchararray_*   : Read / Write
+

NM_SETTING_802_1X_PHASE2_CLIENT_CERT

+
#define NM_SETTING_802_1X_PHASE2_CLIENT_CERT "phase2-client-cert"
+

-List of strings to be matched against the altSubjectName of the -certificate presented by the authentication server during the inner -"phase 2" authentication. If the list is empty, no verification of the -server certificate's altSubjectName is performed.


-

The "phase2-auth" property

-
  "phase2-auth"              gchar*                : Read / Write
+

NM_SETTING_802_1X_PASSWORD

+
#define NM_SETTING_802_1X_PASSWORD "password"
+

-Specifies the allowed "phase 2" inner non-EAP authentication methods when -an EAP method that uses an inner TLS tunnel is specified in the -"eap" property. Recognized non-EAP "phase 2" methods are -"pap", "chap", "mschap", "mschapv2", "gtc", "otp", "md5", and "tls". -Each "phase 2" inner method requires specific parameters for successful -authentication; see the wpa_supplicant documentation for more details.

-

Default value: NULL


-

The "phase2-autheap" property

-
  "phase2-autheap"           gchar*                : Read / Write
+

NM_SETTING_802_1X_PASSWORD_FLAGS

+
#define NM_SETTING_802_1X_PASSWORD_FLAGS "password-flags"
+

-Specifies the allowed "phase 2" inner EAP-based authentication methods -when an EAP method that uses an inner TLS tunnel is specified in the -"eap" property. Recognized EAP-based "phase 2" methods are -"md5", "mschapv2", "otp", "gtc", and "tls". Each "phase 2" inner method -requires specific parameters for successful authentication; see the -wpa_supplicant documentation for more details.

-

Default value: NULL


-

The "phase2-ca-cert" property

-
  "phase2-ca-cert"           GArray_guchar_*       : Read / Write
+

NM_SETTING_802_1X_PASSWORD_RAW

+
#define NM_SETTING_802_1X_PASSWORD_RAW "password-raw"
+

-Contains the "phase 2" CA certificate if used by the EAP method specified -in the "phase2-auth" or "phase2-autheap" -properties.

+
+
+
+

NM_SETTING_802_1X_PASSWORD_RAW_FLAGS

+
#define NM_SETTING_802_1X_PASSWORD_RAW_FLAGS "password-raw-flags"
+

-Certificate data is specified using a "scheme"; two are currently -supported: blob and path. When using the blob scheme (which is backwards -compatible with NM 0.7.x) this property should be set to the -certificate's DER encoded data. When using the path scheme, this property -should be set to the full UTF-8 encoded path of the certificate, prefixed -with the string "file://" and ending with a terminating NUL byte. This -property can be unset even if the EAP method supports CA certificates, -but this allows man-in-the-middle attacks and is NOT recommended.

+
+
+
+

NM_SETTING_802_1X_PRIVATE_KEY

+
#define NM_SETTING_802_1X_PRIVATE_KEY "private-key"
+

-Setting this property directly is discouraged; use the -nm_setting_802_1x_set_phase2_ca_cert() function instead.


-

The "phase2-ca-path" property

-
  "phase2-ca-path"           gchar*                : Read / Write
+

NM_SETTING_802_1X_PRIVATE_KEY_PASSWORD

+
#define NM_SETTING_802_1X_PRIVATE_KEY_PASSWORD "private-key-password"
+

-UTF-8 encoded path to a directory containing PEM or DER formatted -certificates to be added to the verification chain in addition to the -certificate specified in the "phase2-ca-cert" property.

-

Default value: NULL


-

The "phase2-client-cert" property

-
  "phase2-client-cert"       GArray_guchar_*       : Read / Write
+

NM_SETTING_802_1X_PRIVATE_KEY_PASSWORD_FLAGS

+
#define NM_SETTING_802_1X_PRIVATE_KEY_PASSWORD_FLAGS "private-key-password-flags"
+

-Contains the "phase 2" client certificate if used by the EAP method -specified in the "phase2-auth" or -"phase2-autheap" properties.

+
+
+
+

NM_SETTING_802_1X_PHASE2_PRIVATE_KEY

+
#define NM_SETTING_802_1X_PHASE2_PRIVATE_KEY "phase2-private-key"
+

-Certificate data is specified using a "scheme"; two are currently -supported: blob and path. When using the blob scheme (which is backwards -compatible with NM 0.7.x) this property should be set to the -certificate's DER encoded data. When using the path scheme, this property -should be set to the full UTF-8 encoded path of the certificate, prefixed -with the string "file://" and ending with a terminating NUL byte. This -property can be unset even if the EAP method supports CA certificates, -but this allows man-in-the-middle attacks and is NOT recommended.

+
+
+
+

NM_SETTING_802_1X_PHASE2_PRIVATE_KEY_PASSWORD

+
#define NM_SETTING_802_1X_PHASE2_PRIVATE_KEY_PASSWORD "phase2-private-key-password"
+

-Setting this property directly is discouraged; use the -nm_setting_802_1x_set_phase2_client_cert() function instead.


-

The "phase2-private-key" property

-
  "phase2-private-key"       GArray_guchar_*       : Read / Write
+

NM_SETTING_802_1X_PHASE2_PRIVATE_KEY_PASSWORD_FLAGS

+
#define NM_SETTING_802_1X_PHASE2_PRIVATE_KEY_PASSWORD_FLAGS "phase2-private-key-password-flags"
+

-Contains the "phase 2" inner private key when the -"phase2-auth" or "phase2-autheap" property is -set to "tls".

+
+
+
+

NM_SETTING_802_1X_PIN

+
#define NM_SETTING_802_1X_PIN "pin"
+

-Key data is specified using a "scheme"; two are currently supported: blob -and path. When using the blob scheme and private keys, this property -should be set to the key's encrypted PEM encoded data. When using private -keys with the path scheme, this property should be set to the full UTF-8 -encoded path of the key, prefixed with the string "file://" and ending -with a terminating NUL byte. When using PKCS#12 format private keys and -the blob scheme, this property should be set to the PKCS#12 data and the -"phase2-private-key-password" property must be set to -password used to decrypt the PKCS#12 certificate and key. When using -PKCS#12 files and the path scheme, this property should be set to the -full UTF-8 encoded path of the key, prefixed with the string "file://" -and and ending with a terminating NUL byte, and as with the blob scheme -the "phase2-private-key-password" property must be set to -the password used to decode the PKCS#12 private key and certificate.

+
+
+
+

NM_SETTING_802_1X_PIN_FLAGS

+
#define NM_SETTING_802_1X_PIN_FLAGS "pin-flags"
+

-Setting this property directly is discouraged; use the -nm_setting_802_1x_set_phase2_private_key() function instead.


-

The "phase2-private-key-password" property

-
  "phase2-private-key-password" gchar*                : Read / Write
+

NM_SETTING_802_1X_SYSTEM_CA_CERTS

+
#define NM_SETTING_802_1X_SYSTEM_CA_CERTS "system-ca-certs"
+

-The password used to decrypt the "phase 2" private key specified in the -"phase2-private-key" property when the private key either -uses the path scheme, or is a PKCS#12 format key. Setting this property -directly is not generally necessary except when returning secrets to -NetworkManager; it is generally set automatically when setting the -private key by the nm_setting_802_1x_set_phase2_private_key() function.

+
+
+
+

Property Details

+
+

The “altsubject-matches” property

+
  “altsubject-matches”       GSList_gchararray_ *
+

+

Flags: Read / Write

+
+
+
+

The “anonymous-identity” property

+
  “anonymous-identity”       gchar *
+

+

Flags: Read / Write

Default value: NULL


-

The "phase2-private-key-password-flags" property

-
  "phase2-private-key-password-flags" guint                 : Read / Write
-

-Flags indicating how to handle the -"phase2-private-key-password" property. -

+

The “ca-cert” property

+
  “ca-cert”                  GArray_guchar_ *
+

+

Flags: Read / Write

+
+
+
+

The “ca-path” property

+
  “ca-path”                  gchar *
+

+

Flags: Read / Write

+

Default value: NULL

+
+
+
+

The “client-cert” property

+
  “client-cert”              GArray_guchar_ *
+

+

Flags: Read / Write

+
+
+
+

The “eap” property

+
  “eap”                      GSList_gchararray_ *
+

+

Flags: Read / Write

+
+
+
+

The “identity” property

+
  “identity”                 gchar *
+

+

Flags: Read / Write

+

Default value: NULL

+
+
+
+

The “pac-file” property

+
  “pac-file”                 gchar *
+

+

Flags: Read / Write

+

Default value: NULL

+
+
+
+

The “password” property

+
  “password”                 gchar *
+

+

Flags: Read / Write

+

Default value: NULL

+
+
+
+

The “password-flags” property

+
  “password-flags”           guint
+

+

Flags: Read / Write

Allowed values: <= 7

Default value: 0


-

The "phase2-subject-match" property

-
  "phase2-subject-match"     gchar*                : Read / Write
-

-Substring to be matched against the subject of the certificate presented -by the authentication server during the inner "phase 2" -authentication. When unset, no verification of the authentication server -certificate's subject is performed. -

+

The “password-raw” property

+
  “password-raw”             GArray_guchar_ *
+

+

Flags: Read / Write

+
+
+
+

The “password-raw-flags” property

+
  “password-raw-flags”       guint
+

+

Flags: Read / Write

+

Allowed values: <= 7

+

Default value: 0

+
+
+
+

The “phase1-fast-provisioning” property

+
  “phase1-fast-provisioning” gchar *
+

+

Flags: Read / Write

Default value: NULL


-

The "pin" property

-
  "pin"                      gchar*                : Read / Write
-

-PIN used for EAP authentication methods. -

+

The “phase1-peaplabel” property

+
  “phase1-peaplabel”         gchar *
+

+

Flags: Read / Write

Default value: NULL


-

The "pin-flags" property

-
  "pin-flags"                guint                 : Read / Write
-

-Flags indicating how to handle the "pin" property. -

+

The “phase1-peapver” property

+
  “phase1-peapver”           gchar *
+

+

Flags: Read / Write

+

Default value: NULL

+
+
+
+

The “phase2-altsubject-matches” property

+
  “phase2-altsubject-matches” GSList_gchararray_ *
+

+

Flags: Read / Write

+
+
+
+

The “phase2-auth” property

+
  “phase2-auth”              gchar *
+

+

Flags: Read / Write

+

Default value: NULL

+
+
+
+

The “phase2-autheap” property

+
  “phase2-autheap”           gchar *
+

+

Flags: Read / Write

+

Default value: NULL

+
+
+
+

The “phase2-ca-cert” property

+
  “phase2-ca-cert”           GArray_guchar_ *
+

+

Flags: Read / Write

+
+
+
+

The “phase2-ca-path” property

+
  “phase2-ca-path”           gchar *
+

+

Flags: Read / Write

+

Default value: NULL

+
+
+
+

The “phase2-client-cert” property

+
  “phase2-client-cert”       GArray_guchar_ *
+

+

Flags: Read / Write

+
+
+
+

The “phase2-private-key” property

+
  “phase2-private-key”       GArray_guchar_ *
+

+

Flags: Read / Write

+
+
+
+

The “phase2-private-key-password” property

+
  “phase2-private-key-password” gchar *
+

+

Flags: Read / Write

+

Default value: NULL

+
+
+
+

The “phase2-private-key-password-flags” property

+
  “phase2-private-key-password-flags” guint
+

+

Flags: Read / Write

Allowed values: <= 7

Default value: 0


-

The "private-key" property

-
  "private-key"              GArray_guchar_*       : Read / Write
-

-Contains the private key when the "eap" property is set to -"tls". -

-

-Key data is specified using a "scheme"; two are currently supported: blob -and path. When using the blob scheme and private keys, this property -should be set to the key's encrypted PEM encoded data. When using private -keys with the path scheme, this property should be set to the full UTF-8 -encoded path of the key, prefixed with the string "file://" and ending -with a terminating NUL byte. When using PKCS#12 format private keys and -the blob scheme, this property should be set to the PKCS#12 data and the -"private-key-password" property must be set to password -used to decrypt the PKCS#12 certificate and key. When using PKCS#12 files -and the path scheme, this property should be set to the full UTF-8 -encoded path of the key, prefixed with the string "file://" and and -ending with a terminating NUL byte, and as with the blob scheme the -"private-key-password" property must be set to the password used to -decode the PKCS#12 private key and certificate. -

-

-Setting this property directly is discouraged; use the -nm_setting_802_1x_set_private_key() function instead. -

-

-WARNING: "private-key" is not a "secret" property, and thus -unencrypted private key data using the BLOB scheme may be readable by -unprivileged users. Private keys should always be encrypted with a -private key password to prevent unauthorized access to unencrypted -private key data. -

+

The “phase2-subject-match” property

+
  “phase2-subject-match”     gchar *
+

+

Flags: Read / Write

+

Default value: NULL


-

The "private-key-password" property

-
  "private-key-password"     gchar*                : Read / Write
-

-The password used to decrypt the private key specified in the -"private-key" property when the private key either uses the -path scheme, or if the private key is a PKCS#12 format key. Setting this -property directly is not generally necessary except when returning -secrets to NetworkManager; it is generally set automatically when setting -the private key by the nm_setting_802_1x_set_private_key() function. -

+

The “pin” property

+
  “pin”                      gchar *
+

+

Flags: Read / Write

Default value: NULL


-

The "private-key-password-flags" property

-
  "private-key-password-flags" guint                 : Read / Write
-

-Flags indicating how to handle the "private-key-password" -property. -

+

The “pin-flags” property

+
  “pin-flags”                guint
+

+

Flags: Read / Write

Allowed values: <= 7

Default value: 0


-

The "subject-match" property

-
  "subject-match"            gchar*                : Read / Write
-

-Substring to be matched against the subject of the certificate presented -by the authentication server. When unset, no verification of the -authentication server certificate's subject is performed. -

+

The “private-key” property

+
  “private-key”              GArray_guchar_ *
+

+

Flags: Read / Write

+
+
+
+

The “private-key-password” property

+
  “private-key-password”     gchar *
+

+

Flags: Read / Write

Default value: NULL


-

The "system-ca-certs" property

-
  "system-ca-certs"          gboolean              : Read / Write / Construct
-

-When TRUE, overrides the "ca-path" and -"phase2-ca-path" properties using the system CA directory -specified at configure time with the --system-ca-path switch. The -certificates in this directory are added to the verification chain in -addition to any certificates specified by the "ca-cert" and -"phase2-ca-cert" properties. -

+

The “private-key-password-flags” property

+
  “private-key-password-flags” guint
+

+

Flags: Read / Write

+

Allowed values: <= 7

+

Default value: 0

+
+
+
+

The “subject-match” property

+
  “subject-match”            gchar *
+

+

Flags: Read / Write

+

Default value: NULL

+
+
+
+

The “system-ca-certs” property

+
  “system-ca-certs”          gboolean
+

+

Flags: Read / Write / Construct

Default value: FALSE

+ Generated by GTK-Doc V1.21 \ No newline at end of file diff --git a/docs/libnm-util/html/NMSettingAdsl.html b/docs/libnm-util/html/NMSettingAdsl.html index ab37325d..3b2aef23 100644 --- a/docs/libnm-util/html/NMSettingAdsl.html +++ b/docs/libnm-util/html/NMSettingAdsl.html @@ -2,34 +2,28 @@ -NMSettingAdsl +libnm-util Reference Manual: NMSettingAdsl - + - - - - - - - - - - + + + + + + +
@@ -37,74 +31,438 @@

NMSettingAdsl

NMSettingAdsl — Describes ADSL-based properties

- +
-
-

Synopsis

-
-#include <nm-setting-adsl.h>
-
-#define             NM_SETTING_ADSL_SETTING_NAME
-enum                NMSettingAdslError;
-#define             NM_SETTING_ADSL_ERROR
-GQuark              nm_setting_adsl_error_quark         (void);
-#define             NM_SETTING_ADSL_USERNAME
-#define             NM_SETTING_ADSL_PASSWORD
-#define             NM_SETTING_ADSL_PASSWORD_FLAGS
-#define             NM_SETTING_ADSL_PROTOCOL
-#define             NM_SETTING_ADSL_ENCAPSULATION
-#define             NM_SETTING_ADSL_VPI
-#define             NM_SETTING_ADSL_VCI
-#define             NM_SETTING_ADSL_PROTOCOL_PPPOA
-#define             NM_SETTING_ADSL_PROTOCOL_PPPOE
-#define             NM_SETTING_ADSL_PROTOCOL_IPOATM
-#define             NM_SETTING_ADSL_ENCAPSULATION_VCMUX
-#define             NM_SETTING_ADSL_ENCAPSULATION_LLC
-                    NMSettingAdsl;
-                    NMSettingAdslClass;
-NMSetting *         nm_setting_adsl_new                 (void);
-const char *        nm_setting_adsl_get_username        (NMSettingAdsl *setting);
-const char *        nm_setting_adsl_get_password        (NMSettingAdsl *setting);
-const char *        nm_setting_adsl_get_protocol        (NMSettingAdsl *setting);
-const char *        nm_setting_adsl_get_encapsulation   (NMSettingAdsl *setting);
-guint32             nm_setting_adsl_get_vpi             (NMSettingAdsl *setting);
-guint32             nm_setting_adsl_get_vci             (NMSettingAdsl *setting);
-NMSettingSecretFlags nm_setting_adsl_get_password_flags (NMSettingAdsl *setting);
-
+
+

Functions

+
++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+GQuark + +nm_setting_adsl_error_quark () +
+NMSetting * + +nm_setting_adsl_new () +
const char * + +nm_setting_adsl_get_username () +
const char * + +nm_setting_adsl_get_password () +
const char * + +nm_setting_adsl_get_protocol () +
const char * + +nm_setting_adsl_get_encapsulation () +
+guint32 + +nm_setting_adsl_get_vpi () +
+guint32 + +nm_setting_adsl_get_vci () +
+NMSettingSecretFlags + +nm_setting_adsl_get_password_flags () +
+
+
+

Properties

+
+++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+gchar *encapsulationRead / Write
+gchar *passwordRead / Write
guintpassword-flagsRead / Write
+gchar *protocolRead / Write
+gchar *usernameRead / Write
guintvciRead / Write
guintvpiRead / Write
+
+

Object Hierarchy

-
-  GEnum
-   +----NMSettingAdslError
-
-
-  GObject
-   +----NMSetting
-         +----NMSettingAdsl
+
    GEnum
+    ╰── NMSettingAdslError
+    GObject
+    ╰── NMSetting
+        ╰── NMSettingAdsl
 
-

Properties

-
-  "encapsulation"            gchar*                : Read / Write
-  "password"                 gchar*                : Read / Write
-  "password-flags"           guint                 : Read / Write
-  "protocol"                 gchar*                : Read / Write
-  "username"                 gchar*                : Read / Write
-  "vci"                      guint                 : Read / Write
-  "vpi"                      guint                 : Read / Write
+

Includes

+
#include <nm-setting-adsl.h>
 

Description

-

-The NMSettingAdsl object is a NMSetting subclass that describes -properties of ADSL connections. -

+

The NMSettingAdsl object is a NMSetting subclass that describes +properties of ADSL connections.

-

Details

+

Functions

+
+

nm_setting_adsl_error_quark ()

+
GQuark
+nm_setting_adsl_error_quark (void);
+

Registers an error quark for NMSettingAdsl if necessary.

+
+

Returns

+

the error quark used for NMSettingAdsl errors.

+

+
+
+
+
+

nm_setting_adsl_new ()

+
NMSetting *
+nm_setting_adsl_new (void);
+

Creates a new NMSettingAdsl object with default values.

+
+

Returns

+

the new empty NMSettingAdsl object

+

+
+
+
+
+

nm_setting_adsl_get_username ()

+
const char *
+nm_setting_adsl_get_username (NMSettingAdsl *setting);
+
+

Parameters

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

setting

the NMSettingAdsl

 
+
+
+

Returns

+

the “username” property of the setting

+

+
+
+
+
+

nm_setting_adsl_get_password ()

+
const char *
+nm_setting_adsl_get_password (NMSettingAdsl *setting);
+
+

Parameters

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

setting

the NMSettingAdsl

 
+
+
+

Returns

+

the “password” property of the setting

+

+
+
+
+
+

nm_setting_adsl_get_protocol ()

+
const char *
+nm_setting_adsl_get_protocol (NMSettingAdsl *setting);
+
+

Parameters

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

setting

the NMSettingAdsl

 
+
+
+

Returns

+

the “protocol” property of the setting

+

+
+
+
+
+

nm_setting_adsl_get_encapsulation ()

+
const char *
+nm_setting_adsl_get_encapsulation (NMSettingAdsl *setting);
+
+

Parameters

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

setting

the NMSettingAdsl

 
+
+
+

Returns

+

the “encapsulation” property of the setting

+

+
+
+
+
+

nm_setting_adsl_get_vpi ()

+
guint32
+nm_setting_adsl_get_vpi (NMSettingAdsl *setting);
+
+

Parameters

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

setting

the NMSettingAdsl

 
+
+
+

Returns

+

the “vpi” property of the setting

+

+
+
+
+
+

nm_setting_adsl_get_vci ()

+
guint32
+nm_setting_adsl_get_vci (NMSettingAdsl *setting);
+
+

Parameters

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

setting

the NMSettingAdsl

 
+
+
+

Returns

+

the “vci” property of the setting

+

+
+
+
+
+

nm_setting_adsl_get_password_flags ()

+
NMSettingSecretFlags
+nm_setting_adsl_get_password_flags (NMSettingAdsl *setting);
+
+

Parameters

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

setting

the NMSettingAdsl

 
+
+
+

Returns

+

the NMSettingSecretFlags pertaining to the “password”

+

+
+
+
+
+

Types and Values

NM_SETTING_ADSL_SETTING_NAME

#define NM_SETTING_ADSL_SETTING_NAME "adsl"
@@ -114,38 +472,42 @@ properties of ADSL connections.
 

-

enum NMSettingAdslError

-
typedef enum {
-	NM_SETTING_ADSL_ERROR_UNKNOWN = 0,              /*< nick=UnknownError >*/
-	NM_SETTING_ADSL_ERROR_INVALID_PROPERTY,         /*< nick=InvalidProperty >*/
-	NM_SETTING_ADSL_ERROR_MISSING_PROPERTY          /*< nick=MissingProperty >*/
-} NMSettingAdslError;
-
-
+

enum NMSettingAdslError

+
+

Members

+
--+++ - - + + - - + + - - + +

NM_SETTING_ADSL_ERROR_UNKNOWN

unknown or unclassified error +

NM_SETTING_ADSL_ERROR_UNKNOWN

+

unknown or unclassified error

 

NM_SETTING_ADSL_ERROR_INVALID_PROPERTY

the property was invalid +

NM_SETTING_ADSL_ERROR_INVALID_PROPERTY

+

the property was invalid

 

NM_SETTING_ADSL_ERROR_MISSING_PROPERTY

the property was missing and is -required +

NM_SETTING_ADSL_ERROR_MISSING_PROPERTY

+

the property was missing and is +required

 
+

NM_SETTING_ADSL_ERROR

@@ -156,24 +518,6 @@ required

-

nm_setting_adsl_error_quark ()

-
GQuark              nm_setting_adsl_error_quark         (void);
-

-Registers an error quark for NMSettingAdsl if necessary. -

-
---- - - - - -

Returns :

the error quark used for NMSettingAdsl errors.
-
-
-

NM_SETTING_ADSL_USERNAME

#define NM_SETTING_ADSL_USERNAME            "username"
 
@@ -268,267 +612,64 @@ Registers an error quark for -

NMSettingAdsl

-
typedef struct _NMSettingAdsl NMSettingAdsl;
-

-

-
-
-
-

NMSettingAdslClass

-
typedef struct {
-	NMSettingClass parent;
-
-	/* Padding for future expansion */
-	void (*_reserved1) (void);
-	void (*_reserved2) (void);
-	void (*_reserved3) (void);
-	void (*_reserved4) (void);
-} NMSettingAdslClass;
-
-

-

-
-
-
-

nm_setting_adsl_new ()

-
NMSetting *         nm_setting_adsl_new                 (void);
-

-Creates a new NMSettingAdsl object with default values. -

-
---- - - - - -

Returns :

the new empty NMSettingAdsl object
-
-
-
-

nm_setting_adsl_get_username ()

-
const char *        nm_setting_adsl_get_username        (NMSettingAdsl *setting);
-
---- - - - - - - - - - - -

setting :

the NMSettingAdsl -

Returns :

the "username" property of the setting
-
-
-
-

nm_setting_adsl_get_password ()

-
const char *        nm_setting_adsl_get_password        (NMSettingAdsl *setting);
-
---- - - - - - - - - - - -

setting :

the NMSettingAdsl -

Returns :

the "password" property of the setting
-
-
-
-

nm_setting_adsl_get_protocol ()

-
const char *        nm_setting_adsl_get_protocol        (NMSettingAdsl *setting);
-
---- - - - - - - - - - - -

setting :

the NMSettingAdsl -

Returns :

the "protocol" property of the setting
-
-
-
-

nm_setting_adsl_get_encapsulation ()

-
const char *        nm_setting_adsl_get_encapsulation   (NMSettingAdsl *setting);
-
---- - - - - - - - - - - -

setting :

the NMSettingAdsl -

Returns :

the "encapsulation" property of the setting
-
-
-
-

nm_setting_adsl_get_vpi ()

-
guint32             nm_setting_adsl_get_vpi             (NMSettingAdsl *setting);
-
---- - - - - - - - - - - -

setting :

the NMSettingAdsl -

Returns :

the "vpi" property of the setting
-
-
-
-

nm_setting_adsl_get_vci ()

-
guint32             nm_setting_adsl_get_vci             (NMSettingAdsl *setting);
-
---- - - - - - - - - - - -

setting :

the NMSettingAdsl -

Returns :

the "vci" property of the setting
-
-
-
-

nm_setting_adsl_get_password_flags ()

-
NMSettingSecretFlags nm_setting_adsl_get_password_flags (NMSettingAdsl *setting);
-
---- - - - - - - - - - - -

setting :

the NMSettingAdsl -

Returns :

the NMSettingSecretFlags pertaining to the "password" -
-

Property Details

-

The "encapsulation" property

-
  "encapsulation"            gchar*                : Read / Write
-

-Encapsulation of ADSL connection. Can be "vcmux" or "llc". -

+

The “encapsulation” property

+
  “encapsulation”            gchar *
+

+

Flags: Read / Write

Default value: NULL


-

The "password" property

-
  "password"                 gchar*                : Read / Write
-

-Password used to authenticate with the ADSL service. -

+

The “password” property

+
  “password”                 gchar *
+

+

Flags: Read / Write

Default value: NULL


-

The "password-flags" property

-
  "password-flags"           guint                 : Read / Write
-

-Flags indicating how to handle the "password" property. -

+

The “password-flags” property

+
  “password-flags”           guint
+

+

Flags: Read / Write

Allowed values: <= 7

Default value: 0


-

The "protocol" property

-
  "protocol"                 gchar*                : Read / Write
-

-ADSL connection protocol. Can be "pppoa", "pppoe" or "ipoatm". -

+

The “protocol” property

+
  “protocol”                 gchar *
+

+

Flags: Read / Write

Default value: NULL


-

The "username" property

-
  "username"                 gchar*                : Read / Write
-

-Username used to authenticate with the ADSL service. -

+

The “username” property

+
  “username”                 gchar *
+

+

Flags: Read / Write

Default value: NULL


-

The "vci" property

-
  "vci"                      guint                 : Read / Write
-

-VCI of ADSL connection -

+

The “vci” property

+
  “vci”                      guint
+

+

Flags: Read / Write

Allowed values: <= 65536

Default value: 0


-

The "vpi" property

-
  "vpi"                      guint                 : Read / Write
-

-VPI of ADSL connection -

+

The “vpi” property

+
  “vpi”                      guint
+

+

Flags: Read / Write

Allowed values: <= 65536

Default value: 0

@@ -536,6 +677,6 @@ VPI of ADSL connection
+ Generated by GTK-Doc V1.21
\ No newline at end of file diff --git a/docs/libnm-util/html/NMSettingBluetooth.html b/docs/libnm-util/html/NMSettingBluetooth.html index 622a3c2c..cf501a32 100644 --- a/docs/libnm-util/html/NMSettingBluetooth.html +++ b/docs/libnm-util/html/NMSettingBluetooth.html @@ -2,34 +2,28 @@ -NMSettingBluetooth +libnm-util Reference Manual: NMSettingBluetooth - + - - - - - - - - - - + + + + + + +
@@ -37,59 +31,219 @@

NMSettingBluetooth

NMSettingBluetooth — Describes Bluetooth connection properties

- +
-
-

Synopsis

-
-#include <nm-setting-bluetooth.h>
-
-#define             NM_SETTING_BLUETOOTH_SETTING_NAME
-enum                NMSettingBluetoothError;
-#define             NM_SETTING_BLUETOOTH_ERROR
-GQuark              nm_setting_bluetooth_error_quark    (void);
-#define             NM_SETTING_BLUETOOTH_BDADDR
-#define             NM_SETTING_BLUETOOTH_TYPE
-#define             NM_SETTING_BLUETOOTH_TYPE_DUN
-#define             NM_SETTING_BLUETOOTH_TYPE_PANU
-                    NMSettingBluetooth;
-                    NMSettingBluetoothClass;
-NMSetting *         nm_setting_bluetooth_new            (void);
-const GByteArray *  nm_setting_bluetooth_get_bdaddr     (NMSettingBluetooth *setting);
-const char *        nm_setting_bluetooth_get_connection_type
-                                                        (NMSettingBluetooth *setting);
-
+
+

Functions

+
++++ + + + + + + + + + + + + + + + + + + +
+GQuark + +nm_setting_bluetooth_error_quark () +
+NMSetting * + +nm_setting_bluetooth_new () +
const GByteArray * + +nm_setting_bluetooth_get_bdaddr () +
const char * + +nm_setting_bluetooth_get_connection_type () +
+
+
+

Properties

+
+++++ + + + + + + + + + + + + +
+GArray_guchar_ *bdaddrRead / Write
+gchar *typeRead / Write
+
+
+

Types and Values

+

Object Hierarchy

-
-  GEnum
-   +----NMSettingBluetoothError
-
-
-  GObject
-   +----NMSetting
-         +----NMSettingBluetooth
+
    GEnum
+    ╰── NMSettingBluetoothError
+    GObject
+    ╰── NMSetting
+        ╰── NMSettingBluetooth
 
-

Properties

-
-  "bdaddr"                   GArray_guchar_*       : Read / Write
-  "type"                     gchar*                : Read / Write
+

Includes

+
#include <nm-setting-bluetooth.h>
 

Description

-

-The NMSettingBluetooth object is a NMSetting subclass that describes +

The NMSettingBluetooth object is a NMSetting subclass that describes properties necessary for connection to devices that provide network connections via the Bluetooth Dial-Up Networking (DUN) and Network Access -Point (NAP) profiles. -

+Point (NAP) profiles.

+
+
+

Functions

+
+

nm_setting_bluetooth_error_quark ()

+
GQuark
+nm_setting_bluetooth_error_quark (void);
+

Registers an error quark for NMSettingBluetooth if necessary.

+
+

Returns

+

the error quark used for NMSettingBluetooth errors.

+

+
+
+
+
+

nm_setting_bluetooth_new ()

+
NMSetting *
+nm_setting_bluetooth_new (void);
+

Creates a new NMSettingBluetooth object with default values.

+
+

Returns

+

the new empty NMSettingBluetooth object.

+

[transfer full]

+
+
+
+
+

nm_setting_bluetooth_get_bdaddr ()

+
const GByteArray *
+nm_setting_bluetooth_get_bdaddr (NMSettingBluetooth *setting);
+

Gets the Bluetooth address of the remote device which this setting +describes a connection to.

+
+

Parameters

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

setting

the NMSettingBluetooth

 
+
+
+

Returns

+

the Bluetooth address

+

+
+
+
+
+

nm_setting_bluetooth_get_connection_type ()

+
const char *
+nm_setting_bluetooth_get_connection_type
+                               (NMSettingBluetooth *setting);
+

Returns the connection method for communicating with the remote device (i.e. +either DUN to a DUN-capable device or PANU to a NAP-capable device).

+
+

Parameters

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

setting

the NMSettingBluetooth

 
+
+ +
-

Details

+

Types and Values

NM_SETTING_BLUETOOTH_SETTING_NAME

#define NM_SETTING_BLUETOOTH_SETTING_NAME "bluetooth"
@@ -99,46 +253,51 @@ Point (NAP) profiles.
 

-

enum NMSettingBluetoothError

-
typedef enum {
-	NM_SETTING_BLUETOOTH_ERROR_UNKNOWN = 0,            /*< nick=UnknownError >*/
-	NM_SETTING_BLUETOOTH_ERROR_INVALID_PROPERTY,       /*< nick=InvalidProperty >*/
-	NM_SETTING_BLUETOOTH_ERROR_MISSING_PROPERTY,       /*< nick=MissingProperty >*/
-	NM_SETTING_BLUETOOTH_ERROR_TYPE_SETTING_NOT_FOUND, /*< nick=TypeSettingNotFound >*/
-} NMSettingBluetoothError;
-
-
+

enum NMSettingBluetoothError

+
+

Members

+
--+++ - - + + - - + + - - + + - - + +

NM_SETTING_BLUETOOTH_ERROR_UNKNOWN

unknown or unclassified error +

NM_SETTING_BLUETOOTH_ERROR_UNKNOWN

+

unknown or unclassified error

 

NM_SETTING_BLUETOOTH_ERROR_INVALID_PROPERTY

the property was invalid +

NM_SETTING_BLUETOOTH_ERROR_INVALID_PROPERTY

+

the property was invalid

 

NM_SETTING_BLUETOOTH_ERROR_MISSING_PROPERTY

the property was missing and is -required +

NM_SETTING_BLUETOOTH_ERROR_MISSING_PROPERTY

+

the property was missing and is +required

 

NM_SETTING_BLUETOOTH_ERROR_TYPE_SETTING_NOT_FOUND

the connection +

NM_SETTING_BLUETOOTH_ERROR_TYPE_SETTING_NOT_FOUND

+

the connection did not contain a required type setting, ie for DUN connections the connection -must also contain an NMSettingGsm or NMSettingCdma as appropriate +must also contain an NMSettingGsm or NMSettingCdma as appropriate

 
+

NM_SETTING_BLUETOOTH_ERROR

@@ -149,24 +308,6 @@ must also contain an -

nm_setting_bluetooth_error_quark ()

-
GQuark              nm_setting_bluetooth_error_quark    (void);
-

-Registers an error quark for NMSettingBluetooth if necessary. -

-
---- - - - - -

Returns :

the error quark used for NMSettingBluetooth errors.
-
-
-

NM_SETTING_BLUETOOTH_BDADDR

#define NM_SETTING_BLUETOOTH_BDADDR    "bdaddr"
 
@@ -186,142 +327,38 @@ Registers an error quark for

NM_SETTING_BLUETOOTH_TYPE_DUN

#define NM_SETTING_BLUETOOTH_TYPE_DUN  "dun"
 
-

-Connection type describing a connection to devices that support the Bluetooth -DUN profile. -

+

Connection type describing a connection to devices that support the Bluetooth +DUN profile.


NM_SETTING_BLUETOOTH_TYPE_PANU

#define NM_SETTING_BLUETOOTH_TYPE_PANU "panu"
 
-

-Connection type describing a connection to devices that support the Bluetooth -NAP (Network Access Point) protocol, which accepts connections via PANU. -

-
-
-
-

NMSettingBluetooth

-
typedef struct _NMSettingBluetooth NMSettingBluetooth;
-

-

-
-
-
-

NMSettingBluetoothClass

-
typedef struct {
-	NMSettingClass parent;
-
-	/* Padding for future expansion */
-	void (*_reserved1) (void);
-	void (*_reserved2) (void);
-	void (*_reserved3) (void);
-	void (*_reserved4) (void);
-} NMSettingBluetoothClass;
-
-

-

-
-
-
-

nm_setting_bluetooth_new ()

-
NMSetting *         nm_setting_bluetooth_new            (void);
-

-Creates a new NMSettingBluetooth object with default values. -

-
---- - - - - -

Returns :

the new empty NMSettingBluetooth object. [transfer full] -
-
-
-
-

nm_setting_bluetooth_get_bdaddr ()

-
const GByteArray *  nm_setting_bluetooth_get_bdaddr     (NMSettingBluetooth *setting);
-

-Gets the Bluetooth address of the remote device which this setting -describes a connection to. -

-
---- - - - - - - - - - - -

setting :

the NMSettingBluetooth -

Returns :

the Bluetooth address
-
-
-
-

nm_setting_bluetooth_get_connection_type ()

-
const char *        nm_setting_bluetooth_get_connection_type
-                                                        (NMSettingBluetooth *setting);
-

-Returns the connection method for communicating with the remote device (i.e. -either DUN to a DUN-capable device or PANU to a NAP-capable device). -

-
---- - - - - - - - - - - -

setting :

the NMSettingBluetooth -

Returns :

the type, either NM_SETTING_BLUETOOTH_TYPE_PANU or -NM_SETTING_BLUETOOTH_TYPE_DUN -
+

Connection type describing a connection to devices that support the Bluetooth +NAP (Network Access Point) protocol, which accepts connections via PANU.

Property Details

-

The "bdaddr" property

-
  "bdaddr"                   GArray_guchar_*       : Read / Write
-

-The Bluetooth address of the device. -

+

The “bdaddr” property

+
  “bdaddr”                   GArray_guchar_ *
+

+

Flags: Read / Write


-

The "type" property

-
  "type"                     gchar*                : Read / Write
-

-Either "dun" for Dial-Up Networking connections or "panu" for Personal -Area Networking connections to devices supporting the NAP profile. -

+

The “type” property

+
  “type”                     gchar *
+

+

Flags: Read / Write

Default value: NULL

+ Generated by GTK-Doc V1.21 \ No newline at end of file diff --git a/docs/libnm-util/html/NMSettingBond.html b/docs/libnm-util/html/NMSettingBond.html index efe99e63..f0dae1ec 100644 --- a/docs/libnm-util/html/NMSettingBond.html +++ b/docs/libnm-util/html/NMSettingBond.html @@ -2,34 +2,28 @@ -NMSettingBond +libnm-util Reference Manual: NMSettingBond - + - - - - - - - - - - + + + + + + +
@@ -37,85 +31,604 @@

NMSettingBond

NMSettingBond — Describes connection properties for bonds

- +
-
-

Synopsis

-
-#include <nm-setting-bond.h>
-
-#define             NM_SETTING_BOND_SETTING_NAME
-enum                NMSettingBondError;
-#define             NM_SETTING_BOND_ERROR
-GQuark              nm_setting_bond_error_quark         (void);
-#define             NM_SETTING_BOND_INTERFACE_NAME
-#define             NM_SETTING_BOND_OPTIONS
-#define             NM_SETTING_BOND_OPTION_MODE
-#define             NM_SETTING_BOND_OPTION_MIIMON
-#define             NM_SETTING_BOND_OPTION_DOWNDELAY
-#define             NM_SETTING_BOND_OPTION_UPDELAY
-#define             NM_SETTING_BOND_OPTION_ARP_INTERVAL
-#define             NM_SETTING_BOND_OPTION_ARP_IP_TARGET
-#define             NM_SETTING_BOND_OPTION_ARP_VALIDATE
-#define             NM_SETTING_BOND_OPTION_PRIMARY
-#define             NM_SETTING_BOND_OPTION_PRIMARY_RESELECT
-#define             NM_SETTING_BOND_OPTION_FAIL_OVER_MAC
-#define             NM_SETTING_BOND_OPTION_USE_CARRIER
-#define             NM_SETTING_BOND_OPTION_AD_SELECT
-#define             NM_SETTING_BOND_OPTION_XMIT_HASH_POLICY
-#define             NM_SETTING_BOND_OPTION_RESEND_IGMP
-#define             NM_SETTING_BOND_OPTION_LACP_RATE
-                    NMSettingBond;
-                    NMSettingBondClass;
-NMSetting *         nm_setting_bond_new                 (void);
-const char *        nm_setting_bond_get_interface_name  (NMSettingBond *setting);
-guint32             nm_setting_bond_get_num_options     (NMSettingBond *setting);
-gboolean            nm_setting_bond_get_option          (NMSettingBond *setting,
-                                                         guint32 idx,
-                                                         const char **out_name,
-                                                         const char **out_value);
-const char *        nm_setting_bond_get_option_by_name  (NMSettingBond *setting,
-                                                         const char *name);
-gboolean            nm_setting_bond_add_option          (NMSettingBond *setting,
-                                                         const char *name,
-                                                         const char *value);
-gboolean            nm_setting_bond_remove_option       (NMSettingBond *setting,
-                                                         const char *name);
-gboolean            nm_setting_bond_validate_option     (const char *name,
-                                                         const char *value);
-const char **       nm_setting_bond_get_valid_options   (NMSettingBond *setting);
-const char *        nm_setting_bond_get_option_default  (NMSettingBond *setting,
-                                                         const char *name);
-
+
+

Functions

+
++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+GQuark + +nm_setting_bond_error_quark () +
+NMSetting * + +nm_setting_bond_new () +
const char * + +nm_setting_bond_get_interface_name () +
+guint32 + +nm_setting_bond_get_num_options () +
+gboolean + +nm_setting_bond_get_option () +
const char * + +nm_setting_bond_get_option_by_name () +
+gboolean + +nm_setting_bond_add_option () +
+gboolean + +nm_setting_bond_remove_option () +
+gboolean + +nm_setting_bond_validate_option () +
const char ** + +nm_setting_bond_get_valid_options () +
const char * + +nm_setting_bond_get_option_default () +
+
+
+

Properties

+
+++++ + + + + + + + + + + + + +
+gchar *interface-nameRead / Write
GHashTable_gchararray+gchararray_*optionsRead / Write
+
+

Object Hierarchy

-
-  GEnum
-   +----NMSettingBondError
-
-
-  GObject
-   +----NMSetting
-         +----NMSettingBond
+
    GEnum
+    ╰── NMSettingBondError
+    GObject
+    ╰── NMSetting
+        ╰── NMSettingBond
 
-

Properties

-
-  "interface-name"           gchar*                : Read / Write
-  "options"                  GHashTable_gchararray+gchararray_*  : Read / Write
+

Includes

+
#include <nm-setting-bond.h>
 

Description

-

-The NMSettingBond object is a NMSetting subclass that describes properties -necessary for bond connections. -

+

The NMSettingBond object is a NMSetting subclass that describes properties +necessary for bond connections.

-

Details

+

Functions

+
+

nm_setting_bond_error_quark ()

+
GQuark
+nm_setting_bond_error_quark (void);
+

Registers an error quark for NMSettingBond if necessary.

+
+

Returns

+

the error quark used for NMSettingBond errors.

+

+
+
+
+
+

nm_setting_bond_new ()

+
NMSetting *
+nm_setting_bond_new (void);
+

Creates a new NMSettingBond object with default values.

+
+

Returns

+

the new empty NMSettingBond object.

+

[transfer full]

+
+
+
+
+

nm_setting_bond_get_interface_name ()

+
const char *
+nm_setting_bond_get_interface_name (NMSettingBond *setting);
+
+

Parameters

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

setting

the NMSettingBond

 
+
+
+

Returns

+

the “interface-name” property of the setting

+

+
+
+
+
+

nm_setting_bond_get_num_options ()

+
guint32
+nm_setting_bond_get_num_options (NMSettingBond *setting);
+

Returns the number of options that should be set for this bond when it +is activated. This can be used to retrieve each option individually +using nm_setting_bond_get_option().

+
+

Parameters

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

setting

the NMSettingBond

 
+
+
+

Returns

+

the number of bonding options

+

+
+
+
+
+

nm_setting_bond_get_option ()

+
gboolean
+nm_setting_bond_get_option (NMSettingBond *setting,
+                            guint32 idx,
+                            const char **out_name,
+                            const char **out_value);
+

Given an index, return the value of the bonding option at that index. Indexes +are *not* guaranteed to be static across modifications to options done by +nm_setting_bond_add_option() and nm_setting_bond_remove_option(), +and should not be used to refer to options except for short periods of time +such as during option iteration.

+
+

Parameters

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

setting

the NMSettingBond

 

idx

index of the desired option, from 0 to +nm_setting_bond_get_num_options() - 1

 

out_name

on return, the name of the bonding option; this +value is owned by the setting and should not be modified.

[out]

out_value

on return, the value of the name of the bonding +option; this value is owned by the setting and should not be modified.

[out]
+
+
+

Returns

+

TRUE on success if the index was valid and an option was found, +FALSE if the index was invalid (ie, greater than the number of options +currently held by the setting)

+

+
+
+
+
+

nm_setting_bond_get_option_by_name ()

+
const char *
+nm_setting_bond_get_option_by_name (NMSettingBond *setting,
+                                    const char *name);
+

Returns the value associated with the bonding option specified by +name +, if it exists.

+
+

Parameters

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

setting

the NMSettingBond

 

name

the option name for which to retrieve the value

 
+
+
+

Returns

+

the value, or NULL if the key/value pair was never added to the +setting; the value is owned by the setting and must not be modified

+

+
+
+
+
+

nm_setting_bond_add_option ()

+
gboolean
+nm_setting_bond_add_option (NMSettingBond *setting,
+                            const char *name,
+                            const char *value);
+

Add an option to the table. The option is compared to an internal list +of allowed options. Option names may contain only alphanumeric characters +(ie [a-zA-Z0-9]). Adding a new name replaces any existing name/value pair +that may already exist.

+

The order of how to set several options is relevant because there are options +that conflict with each other.

+
+

Parameters

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

setting

the NMSettingBond

 

name

name for the option

 

value

value for the option

 
+
+
+

Returns

+

TRUE if the option was valid and was added to the internal option +list, FALSE if it was not.

+

+
+
+
+
+

nm_setting_bond_remove_option ()

+
gboolean
+nm_setting_bond_remove_option (NMSettingBond *setting,
+                               const char *name);
+

Remove the bonding option referenced by name + from the internal option +list.

+
+

Parameters

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

setting

the NMSettingBond

 

name

name of the option to remove

 
+
+
+

Returns

+

TRUE if the option was found and removed from the internal option +list, FALSE if it was not.

+

+
+
+
+
+

nm_setting_bond_validate_option ()

+
gboolean
+nm_setting_bond_validate_option (const char *name,
+                                 const char *value);
+

Checks whether name + is a valid bond option and value + is a valid value for +the name +. If value + is NULL, the function only validates the option name.

+
+

Parameters

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

name

the name of the option to validate

 

value

the value of the option to validate

 
+
+
+

Returns

+

TRUE, if the value +is valid for the given name. +If the name +is not a valid option, FALSE will be returned.

+

+
+

Since 0.9.10

+
+
+
+

nm_setting_bond_get_valid_options ()

+
const char **
+nm_setting_bond_get_valid_options (NMSettingBond *setting);
+

Returns a list of valid bond options.

+
+

Parameters

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

setting

the NMSettingBond

 
+
+
+

Returns

+

a NULL-terminated array of strings of valid bond options.

+

[transfer none]

+
+
+
+
+

nm_setting_bond_get_option_default ()

+
const char *
+nm_setting_bond_get_option_default (NMSettingBond *setting,
+                                    const char *name);
+
+

Parameters

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

setting

the NMSettingBond

 

name

the name of the option

 
+
+
+

Returns

+

the value of the bond option if not overridden by an entry in +the “options” property.

+

+
+
+
+
+

Types and Values

NM_SETTING_BOND_SETTING_NAME

#define NM_SETTING_BOND_SETTING_NAME "bond"
@@ -125,50 +638,52 @@ necessary for bond connections.
 

-

enum NMSettingBondError

-
typedef enum {
-	NM_SETTING_BOND_ERROR_UNKNOWN = 0,      /*< nick=UnknownError >*/
-	NM_SETTING_BOND_ERROR_INVALID_PROPERTY, /*< nick=InvalidProperty >*/
-	NM_SETTING_BOND_ERROR_MISSING_PROPERTY, /*< nick=MissingProperty >*/
-	NM_SETTING_BOND_ERROR_INVALID_OPTION,   /*< nick=InvalidOption >*/
-	NM_SETTING_BOND_ERROR_MISSING_OPTION,   /*< nick=MissingOption >*/
-} NMSettingBondError;
-
-
+

enum NMSettingBondError

+
+

Members

+
--+++ - - + + - - + + - - + + - - + + + - - + + +

NM_SETTING_BOND_ERROR_UNKNOWN

unknown or unclassified error +

NM_SETTING_BOND_ERROR_UNKNOWN

+

unknown or unclassified error

 

NM_SETTING_BOND_ERROR_INVALID_PROPERTY

the property was invalid +

NM_SETTING_BOND_ERROR_INVALID_PROPERTY

+

the property was invalid

 

NM_SETTING_BOND_ERROR_MISSING_PROPERTY

the property was missing and is -required +

NM_SETTING_BOND_ERROR_MISSING_PROPERTY

+

the property was missing and is +required

 

NM_SETTING_BOND_ERROR_INVALID_OPTION

-

NM_SETTING_BOND_ERROR_INVALID_OPTION

  

NM_SETTING_BOND_ERROR_MISSING_OPTION

-

NM_SETTING_BOND_ERROR_MISSING_OPTION

  
+

NM_SETTING_BOND_ERROR

@@ -179,24 +694,6 @@ required

-

nm_setting_bond_error_quark ()

-
GQuark              nm_setting_bond_error_quark         (void);
-

-Registers an error quark for NMSettingBond if necessary. -

-
---- - - - - -

Returns :

the error quark used for NMSettingBond errors.
-
-
-

NM_SETTING_BOND_INTERFACE_NAME

#define NM_SETTING_BOND_INTERFACE_NAME "interface-name"
 
@@ -331,370 +828,27 @@ Registers an error quark for -

NMSettingBond

-
typedef struct _NMSettingBond NMSettingBond;
-

-

-
-
-
-

NMSettingBondClass

-
typedef struct {
-	NMSettingClass parent;
-
-	/* Padding for future expansion */
-	void (*_reserved1) (void);
-	void (*_reserved2) (void);
-	void (*_reserved3) (void);
-	void (*_reserved4) (void);
-} NMSettingBondClass;
-
-

-

-
-
-
-

nm_setting_bond_new ()

-
NMSetting *         nm_setting_bond_new                 (void);
-

-Creates a new NMSettingBond object with default values. -

-
---- - - - - -

Returns :

the new empty NMSettingBond object. [transfer full] -
-
-
-
-

nm_setting_bond_get_interface_name ()

-
const char *        nm_setting_bond_get_interface_name  (NMSettingBond *setting);
-
---- - - - - - - - - - - -

setting :

the NMSettingBond -

Returns :

the "interface-name" property of the setting
-
-
-
-

nm_setting_bond_get_num_options ()

-
guint32             nm_setting_bond_get_num_options     (NMSettingBond *setting);
-

-Returns the number of options that should be set for this bond when it -is activated. This can be used to retrieve each option individually -using nm_setting_bond_get_option(). -

-
---- - - - - - - - - - - -

setting :

the NMSettingBond -

Returns :

the number of bonding options
-
-
-
-

nm_setting_bond_get_option ()

-
gboolean            nm_setting_bond_get_option          (NMSettingBond *setting,
-                                                         guint32 idx,
-                                                         const char **out_name,
-                                                         const char **out_value);
-

-Given an index, return the value of the bonding option at that index. Indexes -are *not* guaranteed to be static across modifications to options done by -nm_setting_bond_add_option() and nm_setting_bond_remove_option(), -and should not be used to refer to options except for short periods of time -such as during option iteration. -

-
---- - - - - - - - - - - - - - - - - - - - - - - -

setting :

the NMSettingBond -

idx :

index of the desired option, from 0 to -nm_setting_bond_get_num_options() - 1

out_name :

on return, the name of the bonding option; this -value is owned by the setting and should not be modified. [out] -

out_value :

on return, the value of the name of the bonding -option; this value is owned by the setting and should not be modified. [out] -

Returns :

-TRUE on success if the index was valid and an option was found, -FALSE if the index was invalid (ie, greater than the number of options -currently held by the setting)
-
-
-
-

nm_setting_bond_get_option_by_name ()

-
const char *        nm_setting_bond_get_option_by_name  (NMSettingBond *setting,
-                                                         const char *name);
-

-Returns the value associated with the bonding option specified by -name, if it exists. -

-
---- - - - - - - - - - - - - - - -

setting :

the NMSettingBond -

name :

the option name for which to retrieve the value

Returns :

the value, or NULL if the key/value pair was never added to the -setting; the value is owned by the setting and must not be modified
-
-
-
-

nm_setting_bond_add_option ()

-
gboolean            nm_setting_bond_add_option          (NMSettingBond *setting,
-                                                         const char *name,
-                                                         const char *value);
-

-Add an option to the table. The option is compared to an internal list -of allowed options. Option names may contain only alphanumeric characters -(ie [a-zA-Z0-9]). Adding a new name replaces any existing name/value pair -that may already exist. -

-

-The order of how to set several options is relevant because there are options -that conflict with each other. -

-
---- - - - - - - - - - - - - - - - - - - -

setting :

the NMSettingBond -

name :

name for the option

value :

value for the option

Returns :

-TRUE if the option was valid and was added to the internal option -list, FALSE if it was not.
-
-
-
-

nm_setting_bond_remove_option ()

-
gboolean            nm_setting_bond_remove_option       (NMSettingBond *setting,
-                                                         const char *name);
-

-Remove the bonding option referenced by name from the internal option -list. -

-
---- - - - - - - - - - - - - - - -

setting :

the NMSettingBond -

name :

name of the option to remove

Returns :

-TRUE if the option was found and removed from the internal option -list, FALSE if it was not.
-
-
-
-

nm_setting_bond_validate_option ()

-
gboolean            nm_setting_bond_validate_option     (const char *name,
-                                                         const char *value);
-

-Checks whether name is a valid bond option and value is a valid value for -the name. If value is NULL, the function only validates the option name. -

-
---- - - - - - - - - - - - - - - -

name :

the name of the option to validate

value :

the value of the option to validate

Returns :

-TRUE, if the value is valid for the given name. -If the name is not a valid option, FALSE will be returned.
-

Since 0.9.10

-
-
-
-

nm_setting_bond_get_valid_options ()

-
const char **       nm_setting_bond_get_valid_options   (NMSettingBond *setting);
-

-Returns a list of valid bond options. -

-
---- - - - - - - - - - - -

setting :

the NMSettingBond -

Returns :

a NULL-terminated array of strings of valid bond options. [transfer none] -
-
-
-
-

nm_setting_bond_get_option_default ()

-
const char *        nm_setting_bond_get_option_default  (NMSettingBond *setting,
-                                                         const char *name);
-
---- - - - - - - - - - - - - - - -

setting :

the NMSettingBond -

name :

the name of the option

Returns :

the value of the bond option if not overridden by an entry in -the "options" property.
-

Property Details

-

The "interface-name" property

-
  "interface-name"           gchar*                : Read / Write
-

-The name of the virtual in-kernel bonding network interface -

+

The “interface-name” property

+
  “interface-name”           gchar *
+

+

Flags: Read / Write

Default value: NULL


-

The "options" property

-
  "options"                  GHashTable_gchararray+gchararray_*  : Read / Write
-

-Dictionary of key/value pairs of bonding options. Both keys and values -must be strings. Option names must contain only alphanumeric characters -(ie, [a-zA-Z0-9]). -

+

The “options” property

+
  “options”                  GHashTable_gchararray+gchararray_*
+

+

Flags: Read / Write

+ Generated by GTK-Doc V1.21 \ No newline at end of file diff --git a/docs/libnm-util/html/NMSettingBridge.html b/docs/libnm-util/html/NMSettingBridge.html index c4bb9242..a3292475 100644 --- a/docs/libnm-util/html/NMSettingBridge.html +++ b/docs/libnm-util/html/NMSettingBridge.html @@ -2,34 +2,28 @@ -NMSettingBridge +libnm-util Reference Manual: NMSettingBridge - + - - - - - - - - - - + + + + + + +
@@ -37,73 +31,471 @@

NMSettingBridge

NMSettingBridge — Describes connection properties for bridges

- +
-
-

Synopsis

-
-#include <nm-setting-bridge.h>
-
-#define             NM_SETTING_BRIDGE_SETTING_NAME
-enum                NMSettingBridgeError;
-#define             NM_SETTING_BRIDGE_ERROR
-GQuark              nm_setting_bridge_error_quark       (void);
-#define             NM_SETTING_BRIDGE_INTERFACE_NAME
-#define             NM_SETTING_BRIDGE_MAC_ADDRESS
-#define             NM_SETTING_BRIDGE_STP
-#define             NM_SETTING_BRIDGE_PRIORITY
-#define             NM_SETTING_BRIDGE_FORWARD_DELAY
-#define             NM_SETTING_BRIDGE_HELLO_TIME
-#define             NM_SETTING_BRIDGE_MAX_AGE
-#define             NM_SETTING_BRIDGE_AGEING_TIME
-                    NMSettingBridge;
-                    NMSettingBridgeClass;
-NMSetting *         nm_setting_bridge_new               (void);
-const char *        nm_setting_bridge_get_interface_name
-                                                        (NMSettingBridge *setting);
-const GByteArray *  nm_setting_bridge_get_mac_address   (NMSettingBridge *setting);
-gboolean            nm_setting_bridge_get_stp           (NMSettingBridge *setting);
-guint16             nm_setting_bridge_get_priority      (NMSettingBridge *setting);
-guint16             nm_setting_bridge_get_forward_delay (NMSettingBridge *setting);
-guint16             nm_setting_bridge_get_hello_time    (NMSettingBridge *setting);
-guint16             nm_setting_bridge_get_max_age       (NMSettingBridge *setting);
-guint32             nm_setting_bridge_get_ageing_time   (NMSettingBridge *setting);
-
+
+

Functions

+
++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+GQuark + +nm_setting_bridge_error_quark () +
+NMSetting * + +nm_setting_bridge_new () +
const char * + +nm_setting_bridge_get_interface_name () +
const GByteArray * + +nm_setting_bridge_get_mac_address () +
+gboolean + +nm_setting_bridge_get_stp () +
+guint16 + +nm_setting_bridge_get_priority () +
+guint16 + +nm_setting_bridge_get_forward_delay () +
+guint16 + +nm_setting_bridge_get_hello_time () +
+guint16 + +nm_setting_bridge_get_max_age () +
+guint32 + +nm_setting_bridge_get_ageing_time () +
+
+
+

Properties

+
+++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
guintageing-timeRead / Write / Construct
guintforward-delayRead / Write / Construct
guinthello-timeRead / Write / Construct
+gchar *interface-nameRead / Write
+GArray_guchar_ *mac-addressRead / Write
guintmax-ageRead / Write / Construct
guintpriorityRead / Write / Construct
gbooleanstpRead / Write / Construct
+
+

Object Hierarchy

-
-  GEnum
-   +----NMSettingBridgeError
-
-
-  GObject
-   +----NMSetting
-         +----NMSettingBridge
+
    GEnum
+    ╰── NMSettingBridgeError
+    GObject
+    ╰── NMSetting
+        ╰── NMSettingBridge
 
-

Properties

-
-  "ageing-time"              guint                 : Read / Write / Construct
-  "forward-delay"            guint                 : Read / Write / Construct
-  "hello-time"               guint                 : Read / Write / Construct
-  "interface-name"           gchar*                : Read / Write
-  "mac-address"              GArray_guchar_*       : Read / Write
-  "max-age"                  guint                 : Read / Write / Construct
-  "priority"                 guint                 : Read / Write / Construct
-  "stp"                      gboolean              : Read / Write / Construct
+

Includes

+
#include <nm-setting-bridge.h>
 

Description

-

-The NMSettingBridge object is a NMSetting subclass that describes properties -necessary for bridging connections. -

+

The NMSettingBridge object is a NMSetting subclass that describes properties +necessary for bridging connections.

+
+
+

Functions

+
+

nm_setting_bridge_error_quark ()

+
GQuark
+nm_setting_bridge_error_quark (void);
+

Registers an error quark for NMSettingBridge if necessary.

+
+

Returns

+

the error quark used for NMSettingBridge errors.

+

+
+

Since 0.9.8

+
+
+
+

nm_setting_bridge_new ()

+
NMSetting *
+nm_setting_bridge_new (void);
+

Creates a new NMSettingBridge object with default values.

+
+

Returns

+

the new empty NMSettingBridge object.

+

[transfer full]

+
+

Since 0.9.8

+
+
+
+

nm_setting_bridge_get_interface_name ()

+
const char *
+nm_setting_bridge_get_interface_name (NMSettingBridge *setting);
+
+

Parameters

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

setting

the NMSettingBridge

 
+
+
+

Returns

+

the “interface-name” property of the setting

+

+
+

Since 0.9.8

+
+
+
+

nm_setting_bridge_get_mac_address ()

+
const GByteArray *
+nm_setting_bridge_get_mac_address (NMSettingBridge *setting);
+
+

Parameters

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

setting

the NMSettingBridge

 
+
+
+

Returns

+

the “mac-address” property of the setting

+

+
+

Since 0.9.10

+
+
+
+

nm_setting_bridge_get_stp ()

+
gboolean
+nm_setting_bridge_get_stp (NMSettingBridge *setting);
+
+

Parameters

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

setting

the NMSettingBridge

 
+
+
+

Returns

+

the “stp” property of the setting

+

+
+

Since 0.9.8

+
+
+
+

nm_setting_bridge_get_priority ()

+
guint16
+nm_setting_bridge_get_priority (NMSettingBridge *setting);
+
+

Parameters

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

setting

the NMSettingBridge

 
+
+
+

Returns

+

the “priority” property of the setting

+

+
+

Since 0.9.8

+
+
+
+

nm_setting_bridge_get_forward_delay ()

+
guint16
+nm_setting_bridge_get_forward_delay (NMSettingBridge *setting);
+
+

Parameters

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

setting

the NMSettingBridge

 
+
+
+

Returns

+

the “forward-delay” property of the setting

+

+
+

Since 0.9.8

+
+
+
+

nm_setting_bridge_get_hello_time ()

+
guint16
+nm_setting_bridge_get_hello_time (NMSettingBridge *setting);
+
+

Parameters

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

setting

the NMSettingBridge

 
+
+
+

Returns

+

the “hello-time” property of the setting

+

+
+

Since 0.9.8

+
+
+
+

nm_setting_bridge_get_max_age ()

+
guint16
+nm_setting_bridge_get_max_age (NMSettingBridge *setting);
+
+

Parameters

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

setting

the NMSettingBridge

 
+
+
+

Returns

+

the “max-age” property of the setting

+

+
+

Since 0.9.8

+
+
+
+

nm_setting_bridge_get_ageing_time ()

+
guint32
+nm_setting_bridge_get_ageing_time (NMSettingBridge *setting);
+
+

Parameters

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

setting

the NMSettingBridge

 
+
+
+

Returns

+

the “ageing-time” property of the setting

+

+
+

Since 0.9.8

+
-

Details

+

Types and Values

NM_SETTING_BRIDGE_SETTING_NAME

#define NM_SETTING_BRIDGE_SETTING_NAME "bridge"
@@ -113,37 +505,41 @@ necessary for bridging connections.
 

-

enum NMSettingBridgeError

-
typedef enum {
-	NM_SETTING_BRIDGE_ERROR_UNKNOWN = 0,      /*< nick=UnknownError >*/
-	NM_SETTING_BRIDGE_ERROR_INVALID_PROPERTY, /*< nick=InvalidProperty >*/
-	NM_SETTING_BRIDGE_ERROR_MISSING_PROPERTY, /*< nick=MissingProperty >*/
-} NMSettingBridgeError;
-
-
+

enum NMSettingBridgeError

+
+

Members

+
--+++ - - + + - - + + - - + +

NM_SETTING_BRIDGE_ERROR_UNKNOWN

unknown or unclassified error +

NM_SETTING_BRIDGE_ERROR_UNKNOWN

+

unknown or unclassified error

 

NM_SETTING_BRIDGE_ERROR_INVALID_PROPERTY

the property was invalid +

NM_SETTING_BRIDGE_ERROR_INVALID_PROPERTY

+

the property was invalid

 

NM_SETTING_BRIDGE_ERROR_MISSING_PROPERTY

the property was missing and is -required +

NM_SETTING_BRIDGE_ERROR_MISSING_PROPERTY

+

the property was missing and is +required

 
+

Since 0.9.8


@@ -156,25 +552,6 @@ required

-

nm_setting_bridge_error_quark ()

-
GQuark              nm_setting_bridge_error_quark       (void);
-

-Registers an error quark for NMSettingBridge if necessary. -

-
---- - - - - -

Returns :

the error quark used for NMSettingBridge errors.
-

Since 0.9.8

-
-
-

NM_SETTING_BRIDGE_INTERFACE_NAME

#define NM_SETTING_BRIDGE_INTERFACE_NAME "interface-name"
 
@@ -237,321 +614,81 @@ Registers an error quark for -

NMSettingBridge

-
typedef struct _NMSettingBridge NMSettingBridge;
-

-

-
-
-
-

NMSettingBridgeClass

-
typedef struct {
-	NMSettingClass parent;
-
-	/* Padding for future expansion */
-	void (*_reserved1) (void);
-	void (*_reserved2) (void);
-	void (*_reserved3) (void);
-	void (*_reserved4) (void);
-} NMSettingBridgeClass;
-
-

-

-
-
-
-

nm_setting_bridge_new ()

-
NMSetting *         nm_setting_bridge_new               (void);
-

-Creates a new NMSettingBridge object with default values. -

-
---- - - - - -

Returns :

the new empty NMSettingBridge object. [transfer full] -
-

Since 0.9.8

-
-
-
-

nm_setting_bridge_get_interface_name ()

-
const char *        nm_setting_bridge_get_interface_name
-                                                        (NMSettingBridge *setting);
-
---- - - - - - - - - - - -

setting :

the NMSettingBridge -

Returns :

the "interface-name" property of the setting
-

Since 0.9.8

-
-
-
-

nm_setting_bridge_get_mac_address ()

-
const GByteArray *  nm_setting_bridge_get_mac_address   (NMSettingBridge *setting);
-
---- - - - - - - - - - - -

setting :

the NMSettingBridge -

Returns :

the "mac-address" property of the setting
-

Since 0.9.10

-
-
-
-

nm_setting_bridge_get_stp ()

-
gboolean            nm_setting_bridge_get_stp           (NMSettingBridge *setting);
-
---- - - - - - - - - - - -

setting :

the NMSettingBridge -

Returns :

the "stp" property of the setting
-

Since 0.9.8

-
-
-
-

nm_setting_bridge_get_priority ()

-
guint16             nm_setting_bridge_get_priority      (NMSettingBridge *setting);
-
---- - - - - - - - - - - -

setting :

the NMSettingBridge -

Returns :

the "priority" property of the setting
-

Since 0.9.8

-
-
-
-

nm_setting_bridge_get_forward_delay ()

-
guint16             nm_setting_bridge_get_forward_delay (NMSettingBridge *setting);
-
---- - - - - - - - - - - -

setting :

the NMSettingBridge -

Returns :

the "forward-delay" property of the setting
-

Since 0.9.8

-
-
-
-

nm_setting_bridge_get_hello_time ()

-
guint16             nm_setting_bridge_get_hello_time    (NMSettingBridge *setting);
-
---- - - - - - - - - - - -

setting :

the NMSettingBridge -

Returns :

the "hello-time" property of the setting
-

Since 0.9.8

-
-
-
-

nm_setting_bridge_get_max_age ()

-
guint16             nm_setting_bridge_get_max_age       (NMSettingBridge *setting);
-
---- - - - - - - - - - - -

setting :

the NMSettingBridge -

Returns :

the "max-age" property of the setting
-

Since 0.9.8

-
-
-
-

nm_setting_bridge_get_ageing_time ()

-
guint32             nm_setting_bridge_get_ageing_time   (NMSettingBridge *setting);
-
---- - - - - - - - - - - -

setting :

the NMSettingBridge -

Returns :

the "ageing-time" property of the setting
-

Since 0.9.8

-

Property Details

-

The "ageing-time" property

-
  "ageing-time"              guint                 : Read / Write / Construct
-

-The Ethernet MAC address aging time, in seconds. -

+

The “ageing-time” property

+
  “ageing-time”              guint
+

+

Flags: Read / Write / Construct

Allowed values: <= 1000000

Default value: 300

Since 0.9.8


-

The "forward-delay" property

-
  "forward-delay"            guint                 : Read / Write / Construct
-

-The Spanning Tree Protocol (STP) forwarding delay, in seconds. -

+

The “forward-delay” property

+
  “forward-delay”            guint
+

+

Flags: Read / Write / Construct

Allowed values: <= 30

Default value: 15

Since 0.9.8


-

The "hello-time" property

-
  "hello-time"               guint                 : Read / Write / Construct
-

-The Spanning Tree Protocol (STP) hello time, in seconds. -

+

The “hello-time” property

+
  “hello-time”               guint
+

+

Flags: Read / Write / Construct

Allowed values: <= 10

Default value: 2

Since 0.9.8


-

The "interface-name" property

-
  "interface-name"           gchar*                : Read / Write
-

-The name of the virtual in-kernel bridging network interface -

+

The “interface-name” property

+
  “interface-name”           gchar *
+

+

Flags: Read / Write

Default value: NULL

Since 0.9.8


-

The "mac-address" property

-
  "mac-address"              GArray_guchar_*       : Read / Write
-

-If specified, the MAC address of bridge. When creating a new bridge, this -MAC address will be set. When matching an existing (outside -NetworkManager created) bridge, this MAC address must match. -

+

The “mac-address” property

+
  “mac-address”              GArray_guchar_ *
+

+

Flags: Read / Write

Since 0.9.10


-

The "max-age" property

-
  "max-age"                  guint                 : Read / Write / Construct
-

-The Spanning Tree Protocol (STP) maximum message age, in seconds. -

+

The “max-age” property

+
  “max-age”                  guint
+

+

Flags: Read / Write / Construct

Allowed values: <= 40

Default value: 20

Since 0.9.8


-

The "priority" property

-
  "priority"                 guint                 : Read / Write / Construct
-

-Sets the Spanning Tree Protocol (STP) priority for this bridge. Lower -values are "better"; the lowest priority bridge will be elected the root -bridge. -

+

The “priority” property

+
  “priority”                 guint
+

+

Flags: Read / Write / Construct

Allowed values: <= 65535

Default value: 32768

Since 0.9.8


-

The "stp" property

-
  "stp"                      gboolean              : Read / Write / Construct
-

-Controls whether Spanning Tree Protocol (STP) is enabled for this bridge. -

+

The “stp” property

+
  “stp”                      gboolean
+

+

Flags: Read / Write / Construct

Default value: TRUE

Since 0.9.8

@@ -559,6 +696,6 @@ Controls whether Spanning Tree Protocol (STP) is enabled for this bridge.
+ Generated by GTK-Doc V1.21 \ No newline at end of file diff --git a/docs/libnm-util/html/NMSettingBridgePort.html b/docs/libnm-util/html/NMSettingBridgePort.html index 9f3cdb36..00f8ce21 100644 --- a/docs/libnm-util/html/NMSettingBridgePort.html +++ b/docs/libnm-util/html/NMSettingBridgePort.html @@ -2,34 +2,28 @@ -NMSettingBridgePort +libnm-util Reference Manual: NMSettingBridgePort - + - - - - - - - - - - + + + + + + +
@@ -37,59 +31,252 @@

NMSettingBridgePort

NMSettingBridgePort — Describes connection properties for bridge ports

- +
-
-

Synopsis

-
-#include <nm-setting-bridge-port.h>
-
-#define             NM_SETTING_BRIDGE_PORT_SETTING_NAME
-enum                NMSettingBridgePortError;
-#define             NM_SETTING_BRIDGE_PORT_ERROR
-GQuark              nm_setting_bridge_port_error_quark  (void);
-#define             NM_SETTING_BRIDGE_PORT_PRIORITY
-#define             NM_SETTING_BRIDGE_PORT_PATH_COST
-#define             NM_SETTING_BRIDGE_PORT_HAIRPIN_MODE
-                    NMSettingBridgePort;
-                    NMSettingBridgePortClass;
-NMSetting *         nm_setting_bridge_port_new          (void);
-guint16             nm_setting_bridge_port_get_priority (NMSettingBridgePort *setting);
-guint16             nm_setting_bridge_port_get_path_cost
-                                                        (NMSettingBridgePort *setting);
-gboolean            nm_setting_bridge_port_get_hairpin_mode
-                                                        (NMSettingBridgePort *setting);
-
+
+

Functions

+
++++ + + + + + + + + + + + + + + + + + + + + + + +
+GQuark + +nm_setting_bridge_port_error_quark () +
+NMSetting * + +nm_setting_bridge_port_new () +
+guint16 + +nm_setting_bridge_port_get_priority () +
+guint16 + +nm_setting_bridge_port_get_path_cost () +
+gboolean + +nm_setting_bridge_port_get_hairpin_mode () +
+
+
+

Properties

+
+++++ + + + + + + + + + + + + + + + + + +
gbooleanhairpin-modeRead / Write
guintpath-costRead / Write / Construct
guintpriorityRead / Write / Construct
+
+

Object Hierarchy

-
-  GEnum
-   +----NMSettingBridgePortError
-
-
-  GObject
-   +----NMSetting
-         +----NMSettingBridgePort
+
    GEnum
+    ╰── NMSettingBridgePortError
+    GObject
+    ╰── NMSetting
+        ╰── NMSettingBridgePort
 
-

Properties

-
-  "hairpin-mode"             gboolean              : Read / Write
-  "path-cost"                guint                 : Read / Write / Construct
-  "priority"                 guint                 : Read / Write / Construct
+

Includes

+
#include <nm-setting-bridge-port.h>
 

Description

-

-The NMSettingBridgePort object is a NMSetting subclass that describes -optional properties that apply to bridge ports. -

+

The NMSettingBridgePort object is a NMSetting subclass that describes +optional properties that apply to bridge ports.

+
+
+

Functions

+
+

nm_setting_bridge_port_error_quark ()

+
GQuark
+nm_setting_bridge_port_error_quark (void);
+

Registers an error quark for NMSettingBridgePort if necessary.

+
+

Returns

+

the error quark used for NMSettingBridgePort errors.

+

+
+

Since 0.9.8

+
+
+
+

nm_setting_bridge_port_new ()

+
NMSetting *
+nm_setting_bridge_port_new (void);
+

Creates a new NMSettingBridgePort object with default values.

+
+

Returns

+

the new empty NMSettingBridgePort object.

+

[transfer full]

+
+

Since 0.9.8

+
+
+
+

nm_setting_bridge_port_get_priority ()

+
guint16
+nm_setting_bridge_port_get_priority (NMSettingBridgePort *setting);
+
+

Parameters

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

setting

the NMSettingBridgePort

 
+
+
+

Returns

+

the “priority” property of the setting

+

+
+

Since 0.9.8

+
+
+
+

nm_setting_bridge_port_get_path_cost ()

+
guint16
+nm_setting_bridge_port_get_path_cost (NMSettingBridgePort *setting);
+
+

Parameters

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

setting

the NMSettingBridgePort

 
+
+
+

Returns

+

the “path-cost” property of the setting

+

+
+

Since 0.9.8

+
+
+
+

nm_setting_bridge_port_get_hairpin_mode ()

+
gboolean
+nm_setting_bridge_port_get_hairpin_mode
+                               (NMSettingBridgePort *setting);
+
+

Parameters

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

setting

the NMSettingBridgePort

 
+
+
+

Returns

+

the “hairpin-mode” property of the setting

+

+
+

Since 0.9.8

+
-

Details

+

Types and Values

NM_SETTING_BRIDGE_PORT_SETTING_NAME

#define NM_SETTING_BRIDGE_PORT_SETTING_NAME "bridge-port"
@@ -99,37 +286,41 @@ optional properties that apply to bridge ports.
 

-

enum NMSettingBridgePortError

-
typedef enum {
-	NM_SETTING_BRIDGE_PORT_ERROR_UNKNOWN = 0,      /*< nick=UnknownError >*/
-	NM_SETTING_BRIDGE_PORT_ERROR_INVALID_PROPERTY, /*< nick=InvalidProperty >*/
-	NM_SETTING_BRIDGE_PORT_ERROR_MISSING_PROPERTY, /*< nick=MissingProperty >*/
-} NMSettingBridgePortError;
-
-
+

enum NMSettingBridgePortError

+
+

Members

+
--+++ - - + + - - + + - - + +

NM_SETTING_BRIDGE_PORT_ERROR_UNKNOWN

unknown or unclassified error +

NM_SETTING_BRIDGE_PORT_ERROR_UNKNOWN

+

unknown or unclassified error

 

NM_SETTING_BRIDGE_PORT_ERROR_INVALID_PROPERTY

the property was invalid +

NM_SETTING_BRIDGE_PORT_ERROR_INVALID_PROPERTY

+

the property was invalid

 

NM_SETTING_BRIDGE_PORT_ERROR_MISSING_PROPERTY

the property was missing and -is required +

NM_SETTING_BRIDGE_PORT_ERROR_MISSING_PROPERTY

+

the property was missing and +is required

 
+

Since 0.9.8


@@ -142,25 +333,6 @@ is required

-

nm_setting_bridge_port_error_quark ()

-
GQuark              nm_setting_bridge_port_error_quark  (void);
-

-Registers an error quark for NMSettingBridgePort if necessary. -

-
---- - - - - -

Returns :

the error quark used for NMSettingBridgePort errors.
-

Since 0.9.8

-
-
-

NM_SETTING_BRIDGE_PORT_PRIORITY

#define NM_SETTING_BRIDGE_PORT_PRIORITY     "priority"
 
@@ -183,152 +355,33 @@ Registers an error quark for

-
-
-

NMSettingBridgePort

-
typedef struct _NMSettingBridgePort NMSettingBridgePort;
-

-

-
-
-
-

NMSettingBridgePortClass

-
typedef struct {
-	NMSettingClass parent;
-
-	/* Padding for future expansion */
-	void (*_reserved1) (void);
-	void (*_reserved2) (void);
-	void (*_reserved3) (void);
-	void (*_reserved4) (void);
-} NMSettingBridgePortClass;
-
-

-

-
-
-
-

nm_setting_bridge_port_new ()

-
NMSetting *         nm_setting_bridge_port_new          (void);
-

-Creates a new NMSettingBridgePort object with default values. -

-
---- - - - - -

Returns :

the new empty NMSettingBridgePort object. [transfer full] -
-

Since 0.9.8

-
-
-
-

nm_setting_bridge_port_get_priority ()

-
guint16             nm_setting_bridge_port_get_priority (NMSettingBridgePort *setting);
-
---- - - - - - - - - - - -

setting :

the NMSettingBridgePort -

Returns :

the "priority" property of the setting
-

Since 0.9.8

-
-
-
-

nm_setting_bridge_port_get_path_cost ()

-
guint16             nm_setting_bridge_port_get_path_cost
-                                                        (NMSettingBridgePort *setting);
-
---- - - - - - - - - - - -

setting :

the NMSettingBridgePort -

Returns :

the "path-cost" property of the setting
-

Since 0.9.8

-
-
-
-

nm_setting_bridge_port_get_hairpin_mode ()

-
gboolean            nm_setting_bridge_port_get_hairpin_mode
-                                                        (NMSettingBridgePort *setting);
-
---- - - - - - - - - - - -

setting :

the NMSettingBridgePort -

Returns :

the "hairpin-mode" property of the setting
-

Since 0.9.8

-

Property Details

-

The "hairpin-mode" property

-
  "hairpin-mode"             gboolean              : Read / Write
-

-Enables or disabled "hairpin mode" for the port, which allows frames to -be sent back out through the port the frame was received on. -

+

The “hairpin-mode” property

+
  “hairpin-mode”             gboolean
+

+

Flags: Read / Write

Default value: FALSE

Since 0.9.8


-

The "path-cost" property

-
  "path-cost"                guint                 : Read / Write / Construct
-

-The Spanning Tree Protocol (STP) port cost for destinations via this -port. -

+

The “path-cost” property

+
  “path-cost”                guint
+

+

Flags: Read / Write / Construct

Allowed values: <= 65535

Default value: 100

Since 0.9.8


-

The "priority" property

-
  "priority"                 guint                 : Read / Write / Construct
-

-The Spanning Tree Protocol (STP) priority of this bridge port. -

+

The “priority” property

+
  “priority”                 guint
+

+

Flags: Read / Write / Construct

Allowed values: <= 63

Default value: 32

Since 0.9.8

@@ -337,6 +390,6 @@ The Spanning Tree Protocol (STP) priority of this bridge port.
+ Generated by GTK-Doc V1.21
\ No newline at end of file diff --git a/docs/libnm-util/html/NMSettingCdma.html b/docs/libnm-util/html/NMSettingCdma.html index 3a201d2d..e0d32198 100644 --- a/docs/libnm-util/html/NMSettingCdma.html +++ b/docs/libnm-util/html/NMSettingCdma.html @@ -2,34 +2,28 @@ -NMSettingCdma +libnm-util Reference Manual: NMSettingCdma - + - - - - - - - - - - + + + + + + +
@@ -37,61 +31,290 @@

NMSettingCdma

NMSettingCdma — Describes CDMA-based mobile broadband properties

- +
-
-

Synopsis

-
-#include <nm-setting-cdma.h>
-
-#define             NM_SETTING_CDMA_SETTING_NAME
-enum                NMSettingCdmaError;
-#define             NM_SETTING_CDMA_ERROR
-GQuark              nm_setting_cdma_error_quark         (void);
-#define             NM_SETTING_CDMA_NUMBER
-#define             NM_SETTING_CDMA_USERNAME
-#define             NM_SETTING_CDMA_PASSWORD
-#define             NM_SETTING_CDMA_PASSWORD_FLAGS
-                    NMSettingCdma;
-                    NMSettingCdmaClass;
-NMSetting *         nm_setting_cdma_new                 (void);
-const char *        nm_setting_cdma_get_number          (NMSettingCdma *setting);
-const char *        nm_setting_cdma_get_username        (NMSettingCdma *setting);
-const char *        nm_setting_cdma_get_password        (NMSettingCdma *setting);
-NMSettingSecretFlags nm_setting_cdma_get_password_flags (NMSettingCdma *setting);
-
+
+

Functions

+
++++ + + + + + + + + + + + + + + + + + + + + + + + + + + +
+GQuark + +nm_setting_cdma_error_quark () +
+NMSetting * + +nm_setting_cdma_new () +
const char * + +nm_setting_cdma_get_number () +
const char * + +nm_setting_cdma_get_username () +
const char * + +nm_setting_cdma_get_password () +
+NMSettingSecretFlags + +nm_setting_cdma_get_password_flags () +
+
+
+

Properties

+
+++++ + + + + + + + + + + + + + + + + + + + + + + +
+gchar *numberRead / Write
+gchar *passwordRead / Write
guintpassword-flagsRead / Write
+gchar *usernameRead / Write
+
+
+

Types and Values

+
++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
#defineNM_SETTING_CDMA_SETTING_NAME
enumNMSettingCdmaError
#defineNM_SETTING_CDMA_ERROR
#defineNM_SETTING_CDMA_NUMBER
#defineNM_SETTING_CDMA_USERNAME
#defineNM_SETTING_CDMA_PASSWORD
#defineNM_SETTING_CDMA_PASSWORD_FLAGS

Object Hierarchy

-
-  GEnum
-   +----NMSettingCdmaError
-
-
-  GObject
-   +----NMSetting
-         +----NMSettingCdma
+
    GEnum
+    ╰── NMSettingCdmaError
+    GObject
+    ╰── NMSetting
+        ╰── NMSettingCdma
 
-

Properties

-
-  "number"                   gchar*                : Read / Write
-  "password"                 gchar*                : Read / Write
-  "password-flags"           guint                 : Read / Write
-  "username"                 gchar*                : Read / Write
+

Includes

+
#include <nm-setting-cdma.h>
 

Description

-

-The NMSettingCdma object is a NMSetting subclass that describes +

The NMSettingCdma object is a NMSetting subclass that describes properties that allow connections to IS-95-based mobile broadband -networks, including those using CDMA2000/EVDO technology. -

+networks, including those using CDMA2000/EVDO technology.

-

Details

+

Functions

+
+

nm_setting_cdma_error_quark ()

+
GQuark
+nm_setting_cdma_error_quark (void);
+

Registers an error quark for NMSettingCdma if necessary.

+
+

Returns

+

the error quark used for NMSettingCdma errors.

+

+
+
+
+
+

nm_setting_cdma_new ()

+
NMSetting *
+nm_setting_cdma_new (void);
+

Creates a new NMSettingCdma object with default values.

+
+

Returns

+

the new empty NMSettingCdma object

+

+
+
+
+
+

nm_setting_cdma_get_number ()

+
const char *
+nm_setting_cdma_get_number (NMSettingCdma *setting);
+
+

Parameters

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

setting

the NMSettingCdma

 
+
+
+

Returns

+

the “number” property of the setting

+

+
+
+
+
+

nm_setting_cdma_get_username ()

+
const char *
+nm_setting_cdma_get_username (NMSettingCdma *setting);
+
+

Parameters

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

setting

the NMSettingCdma

 
+
+
+

Returns

+

the “username” property of the setting

+

+
+
+
+
+

nm_setting_cdma_get_password ()

+
const char *
+nm_setting_cdma_get_password (NMSettingCdma *setting);
+
+

Parameters

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

setting

the NMSettingCdma

 
+
+
+

Returns

+

the “password” property of the setting

+

+
+
+
+
+

nm_setting_cdma_get_password_flags ()

+
NMSettingSecretFlags
+nm_setting_cdma_get_password_flags (NMSettingCdma *setting);
+
+

Parameters

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

setting

the NMSettingCdma

 
+
+
+

Returns

+

the NMSettingSecretFlags pertaining to the “password”

+

+
+
+
+
+

Types and Values

NM_SETTING_CDMA_SETTING_NAME

#define NM_SETTING_CDMA_SETTING_NAME "cdma"
@@ -101,45 +324,50 @@ networks, including those using CDMA2000/EVDO technology.
 

-

enum NMSettingCdmaError

-
typedef enum {
-	NM_SETTING_CDMA_ERROR_UNKNOWN = 0,           /*< nick=UnknownError >*/
-	NM_SETTING_CDMA_ERROR_INVALID_PROPERTY,      /*< nick=InvalidProperty >*/
-	NM_SETTING_CDMA_ERROR_MISSING_PROPERTY,      /*< nick=MissingProperty >*/
-	NM_SETTING_CDMA_ERROR_MISSING_SERIAL_SETTING /*< nick=MissingSerialSetting >*/
-} NMSettingCdmaError;
-
-
+

enum NMSettingCdmaError

+
+

Members

+
--+++ - - + + - - + + - - + + - - + +

NM_SETTING_CDMA_ERROR_UNKNOWN

unknown or unclassified error +

NM_SETTING_CDMA_ERROR_UNKNOWN

+

unknown or unclassified error

 

NM_SETTING_CDMA_ERROR_INVALID_PROPERTY

the property was invalid +

NM_SETTING_CDMA_ERROR_INVALID_PROPERTY

+

the property was invalid

 

NM_SETTING_CDMA_ERROR_MISSING_PROPERTY

the property was missing and is -required +

NM_SETTING_CDMA_ERROR_MISSING_PROPERTY

+

the property was missing and is +required

 

NM_SETTING_CDMA_ERROR_MISSING_SERIAL_SETTING

the required NMSettingSerial -is missing in the connection +

NM_SETTING_CDMA_ERROR_MISSING_SERIAL_SETTING

+

the required NMSettingSerial +is missing in the connection

 
+

NM_SETTING_CDMA_ERROR

@@ -150,24 +378,6 @@ is missing in the connection

-

nm_setting_cdma_error_quark ()

-
GQuark              nm_setting_cdma_error_quark         (void);
-

-Registers an error quark for NMSettingCdma if necessary. -

-
---- - - - - -

Returns :

the error quark used for NMSettingCdma errors.
-
-
-

NM_SETTING_CDMA_NUMBER

#define NM_SETTING_CDMA_NUMBER         "number"
 
@@ -198,185 +408,45 @@ Registers an error quark for -

NMSettingCdma

-
typedef struct _NMSettingCdma NMSettingCdma;
-

-

-
-
-
-

NMSettingCdmaClass

-
typedef struct {
-	NMSettingClass parent;
-
-	/* Padding for future expansion */
-	void (*_reserved1) (void);
-	void (*_reserved2) (void);
-	void (*_reserved3) (void);
-	void (*_reserved4) (void);
-} NMSettingCdmaClass;
-
-

-

-
-
-
-

nm_setting_cdma_new ()

-
NMSetting *         nm_setting_cdma_new                 (void);
-

-Creates a new NMSettingCdma object with default values. -

-
---- - - - - -

Returns :

the new empty NMSettingCdma object
-
-
-
-

nm_setting_cdma_get_number ()

-
const char *        nm_setting_cdma_get_number          (NMSettingCdma *setting);
-
---- - - - - - - - - - - -

setting :

the NMSettingCdma -

Returns :

the "number" property of the setting
-
-
-
-

nm_setting_cdma_get_username ()

-
const char *        nm_setting_cdma_get_username        (NMSettingCdma *setting);
-
---- - - - - - - - - - - -

setting :

the NMSettingCdma -

Returns :

the "username" property of the setting
-
-
-
-

nm_setting_cdma_get_password ()

-
const char *        nm_setting_cdma_get_password        (NMSettingCdma *setting);
-
---- - - - - - - - - - - -

setting :

the NMSettingCdma -

Returns :

the "password" property of the setting
-
-
-
-

nm_setting_cdma_get_password_flags ()

-
NMSettingSecretFlags nm_setting_cdma_get_password_flags (NMSettingCdma *setting);
-
---- - - - - - - - - - - -

setting :

the NMSettingCdma -

Returns :

the NMSettingSecretFlags pertaining to the "password" -
-

Property Details

-

The "number" property

-
  "number"                   gchar*                : Read / Write
-

-The number to dial to establish the connection to the CDMA-based mobile -broadband network, if any. If not specified, the default number (777) -is used when required. -

+

The “number” property

+
  “number”                   gchar *
+

+

Flags: Read / Write

Default value: NULL


-

The "password" property

-
  "password"                 gchar*                : Read / Write
-

-The password used to authenticate with the network, if required. Many -providers do not require a password, or accept any password. But if a -password is required, it is specified here. -

+

The “password” property

+
  “password”                 gchar *
+

+

Flags: Read / Write

Default value: NULL


-

The "password-flags" property

-
  "password-flags"           guint                 : Read / Write
-

-Flags indicating how to handle the "password" property. -

+

The “password-flags” property

+
  “password-flags”           guint
+

+

Flags: Read / Write

Allowed values: <= 7

Default value: 0


-

The "username" property

-
  "username"                 gchar*                : Read / Write
-

-The username used to authenticate with the network, if required. Many -providers do not require a username, or accept any username. But if a -username is required, it is specified here. -

+

The “username” property

+
  “username”                 gchar *
+

+

Flags: Read / Write

Default value: NULL

+ Generated by GTK-Doc V1.21 \ No newline at end of file diff --git a/docs/libnm-util/html/NMSettingConnection.html b/docs/libnm-util/html/NMSettingConnection.html index 508a3b8f..f029e3c0 100644 --- a/docs/libnm-util/html/NMSettingConnection.html +++ b/docs/libnm-util/html/NMSettingConnection.html @@ -2,34 +2,28 @@ -NMSettingConnection +libnm-util Reference Manual: NMSettingConnection - + - - - - - - - - - - + + + + + + +
@@ -37,1239 +31,1546 @@

NMSettingConnection

NMSettingConnection — Describes general connection properties

- +
-
-

Synopsis

-
-#include <nm-setting-connection.h>
-
-#define             NM_SETTING_CONNECTION_SETTING_NAME
-enum                NMSettingConnectionError;
-#define             NM_SETTING_CONNECTION_ERROR
-GQuark              nm_setting_connection_error_quark   (void);
-#define             NM_SETTING_CONNECTION_ID
-#define             NM_SETTING_CONNECTION_UUID
-#define             NM_SETTING_CONNECTION_INTERFACE_NAME
-#define             NM_SETTING_CONNECTION_TYPE
-#define             NM_SETTING_CONNECTION_AUTOCONNECT
-#define             NM_SETTING_CONNECTION_TIMESTAMP
-#define             NM_SETTING_CONNECTION_READ_ONLY
-#define             NM_SETTING_CONNECTION_PERMISSIONS
-#define             NM_SETTING_CONNECTION_ZONE
-#define             NM_SETTING_CONNECTION_MASTER
-#define             NM_SETTING_CONNECTION_SLAVE_TYPE
-#define             NM_SETTING_CONNECTION_SECONDARIES
-#define             NM_SETTING_CONNECTION_GATEWAY_PING_TIMEOUT
-                    NMSettingConnection;
-                    NMSettingConnectionClass;
-NMSetting *         nm_setting_connection_new           (void);
-const char *        nm_setting_connection_get_id        (NMSettingConnection *setting);
-const char *        nm_setting_connection_get_uuid      (NMSettingConnection *setting);
-const char *        nm_setting_connection_get_interface_name
-                                                        (NMSettingConnection *setting);
-const char *        nm_setting_connection_get_connection_type
-                                                        (NMSettingConnection *setting);
-gboolean            nm_setting_connection_get_autoconnect
-                                                        (NMSettingConnection *setting);
-guint64             nm_setting_connection_get_timestamp (NMSettingConnection *setting);
-gboolean            nm_setting_connection_get_read_only (NMSettingConnection *setting);
-guint32             nm_setting_connection_get_num_permissions
-                                                        (NMSettingConnection *setting);
-gboolean            nm_setting_connection_get_permission
-                                                        (NMSettingConnection *setting,
-                                                         guint32 idx,
-                                                         const char **out_ptype,
-                                                         const char **out_pitem,
-                                                         const char **out_detail);
-const char *        nm_setting_connection_get_zone      (NMSettingConnection *setting);
-gboolean            nm_setting_connection_permissions_user_allowed
-                                                        (NMSettingConnection *setting,
-                                                         const char *uname);
-gboolean            nm_setting_connection_add_permission
-                                                        (NMSettingConnection *setting,
-                                                         const char *ptype,
-                                                         const char *pitem,
-                                                         const char *detail);
-void                nm_setting_connection_remove_permission
-                                                        (NMSettingConnection *setting,
-                                                         guint32 idx);
-gboolean            nm_setting_connection_remove_permission_by_value
-                                                        (NMSettingConnection *setting,
-                                                         const char *ptype,
-                                                         const char *pitem,
-                                                         const char *detail);
-const char *        nm_setting_connection_get_master    (NMSettingConnection *setting);
-gboolean            nm_setting_connection_is_slave_type (NMSettingConnection *setting,
-                                                         const char *type);
-const char *        nm_setting_connection_get_slave_type
-                                                        (NMSettingConnection *setting);
-guint32             nm_setting_connection_get_num_secondaries
-                                                        (NMSettingConnection *setting);
-const char *        nm_setting_connection_get_secondary (NMSettingConnection *setting,
-                                                         guint32 idx);
-gboolean            nm_setting_connection_add_secondary (NMSettingConnection *setting,
-                                                         const char *sec_uuid);
-void                nm_setting_connection_remove_secondary
-                                                        (NMSettingConnection *setting,
-                                                         guint32 idx);
-gboolean            nm_setting_connection_remove_secondary_by_value
-                                                        (NMSettingConnection *setting,
-                                                         const char *sec_uuid);
-guint32             nm_setting_connection_get_gateway_ping_timeout
-                                                        (NMSettingConnection *setting);
-
-
-
-

Object Hierarchy

-
-  GEnum
-   +----NMSettingConnectionError
-
-
-  GObject
-   +----NMSetting
-         +----NMSettingConnection
-
-
-

Properties

-
-  "autoconnect"              gboolean              : Read / Write / Construct
-  "gateway-ping-timeout"     guint                 : Read / Write / Construct
-  "id"                       gchar*                : Read / Write
-  "interface-name"           gchar*                : Read / Write
-  "master"                   gchar*                : Read / Write
-  "permissions"              GSList_gchararray_*   : Read / Write
-  "read-only"                gboolean              : Read / Write / Construct
-  "secondaries"              GSList_gchararray_*   : Read / Write
-  "slave-type"               gchar*                : Read / Write
-  "timestamp"                guint64               : Read / Write / Construct
-  "type"                     gchar*                : Read / Write
-  "uuid"                     gchar*                : Read / Write
-  "zone"                     gchar*                : Read / Write / Construct
-
-
-
-

Description

-

-The NMSettingConnection object is a NMSetting subclass that describes -properties that apply to all NMConnection objects, regardless of what type -of network connection they describe. Each NMConnection object must contain -a NMSettingConnection setting. -

-
-
-

Details

-
-

NM_SETTING_CONNECTION_SETTING_NAME

-
#define NM_SETTING_CONNECTION_SETTING_NAME "connection"
-
-

-

-
-
-
-

enum NMSettingConnectionError

-
typedef enum {
-	NM_SETTING_CONNECTION_ERROR_UNKNOWN = 0,            /*< nick=UnknownError >*/
-	NM_SETTING_CONNECTION_ERROR_INVALID_PROPERTY,       /*< nick=InvalidProperty >*/
-	NM_SETTING_CONNECTION_ERROR_MISSING_PROPERTY,       /*< nick=MissingProperty >*/
-	NM_SETTING_CONNECTION_ERROR_TYPE_SETTING_NOT_FOUND, /*< nick=TypeSettingNotFound >*/
-	NM_SETTING_CONNECTION_ERROR_IP_CONFIG_NOT_ALLOWED,  /*< nick=IpConfigNotAllowed >*/
-} NMSettingConnectionError;
-
-

-Describes errors that may result from operations involving a -NMSettingConnection. -

-
+

Functions

+
--++ - - + - - + - - + - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

NM_SETTING_CONNECTION_ERROR_UNKNOWN

unknown or unclassified error + +GQuark + +nm_setting_connection_error_quark ()

NM_SETTING_CONNECTION_ERROR_INVALID_PROPERTY

the property's value is - invalid + +NMSetting * + +nm_setting_connection_new ()

NM_SETTING_CONNECTION_ERROR_MISSING_PROPERTY

a required property is not - present +const char * + +nm_setting_connection_get_id ()

NM_SETTING_CONNECTION_ERROR_TYPE_SETTING_NOT_FOUND

the NMSetting object - referenced by the setting name contained in the - "type" property was not present in the NMConnection +const char * + +nm_setting_connection_get_uuid () +
const char * + +nm_setting_connection_get_interface_name () +
const char * + +nm_setting_connection_get_connection_type () +
+gboolean + +nm_setting_connection_get_autoconnect () +
+guint64 + +nm_setting_connection_get_timestamp () +
+gboolean + +nm_setting_connection_get_read_only () +
+guint32 + +nm_setting_connection_get_num_permissions () +
+gboolean + +nm_setting_connection_get_permission () +
const char * + +nm_setting_connection_get_zone () +
+gboolean + +nm_setting_connection_permissions_user_allowed () +
+gboolean + +nm_setting_connection_add_permission ()

NM_SETTING_CONNECTION_ERROR_IP_CONFIG_NOT_ALLOWED

ip configuration is not - allowed to be present. + +void + +nm_setting_connection_remove_permission () +
+gboolean + +nm_setting_connection_remove_permission_by_value () +
const char * + +nm_setting_connection_get_master () +
+gboolean + +nm_setting_connection_is_slave_type () +
const char * + +nm_setting_connection_get_slave_type () +
+guint32 + +nm_setting_connection_get_num_secondaries () +
const char * + +nm_setting_connection_get_secondary () +
+gboolean + +nm_setting_connection_add_secondary () +
+void + +nm_setting_connection_remove_secondary () +
+gboolean + +nm_setting_connection_remove_secondary_by_value () +
+guint32 + +nm_setting_connection_get_gateway_ping_timeout ()
-
-
-

NM_SETTING_CONNECTION_ERROR

-
#define NM_SETTING_CONNECTION_ERROR nm_setting_connection_error_quark ()
-
-

-

-
-
-
-

nm_setting_connection_error_quark ()

-
GQuark              nm_setting_connection_error_quark   (void);
-

-Registers an error quark for NMSettingConnection if necessary. -

-
+
+

Properties

+
--+++ - - - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Returns :

the error quark used for NMSettingConnection errors.
gbooleanautoconnectRead / Write / Construct
guintgateway-ping-timeoutRead / Write / Construct
+gchar *idRead / Write
+gchar *interface-nameRead / Write
+gchar *masterRead / Write
+GSList_gchararray_ *permissionsRead / Write
gbooleanread-onlyRead / Write / Construct
+GSList_gchararray_ *secondariesRead / Write
+gchar *slave-typeRead / Write
guint64timestampRead / Write / Construct
+gchar *typeRead / Write
+gchar *uuidRead / Write
+gchar *zoneRead / Write / Construct
-
-
-

NM_SETTING_CONNECTION_ID

-
#define NM_SETTING_CONNECTION_ID             "id"
-
-

-

-
-
-
-

NM_SETTING_CONNECTION_UUID

-
#define NM_SETTING_CONNECTION_UUID           "uuid"
-
-

-

-
-
-
-

NM_SETTING_CONNECTION_INTERFACE_NAME

-
#define NM_SETTING_CONNECTION_INTERFACE_NAME "interface-name"
-
-

-

-
-
-
-

NM_SETTING_CONNECTION_TYPE

-
#define NM_SETTING_CONNECTION_TYPE           "type"
-
-

-

-
-
-
-

NM_SETTING_CONNECTION_AUTOCONNECT

-
#define NM_SETTING_CONNECTION_AUTOCONNECT    "autoconnect"
-
-

-

-
-
-
-

NM_SETTING_CONNECTION_TIMESTAMP

-
#define NM_SETTING_CONNECTION_TIMESTAMP      "timestamp"
-
-

-

-
-
-
-

NM_SETTING_CONNECTION_READ_ONLY

-
#define NM_SETTING_CONNECTION_READ_ONLY      "read-only"
-
-

-

-
-
-
-

NM_SETTING_CONNECTION_PERMISSIONS

-
#define NM_SETTING_CONNECTION_PERMISSIONS    "permissions"
-
-

-

+ -
-
-

NM_SETTING_CONNECTION_ZONE

-
#define NM_SETTING_CONNECTION_ZONE           "zone"
+
+

Object Hierarchy

+
    GEnum
+    ╰── NMSettingConnectionError
+    GObject
+    ╰── NMSetting
+        ╰── NMSettingConnection
 
-

-

-
-
-

NM_SETTING_CONNECTION_MASTER

-
#define NM_SETTING_CONNECTION_MASTER         "master"
+
+

Includes

+
#include <nm-setting-connection.h>
 
-

-

-
-
-

NM_SETTING_CONNECTION_SLAVE_TYPE

-
#define NM_SETTING_CONNECTION_SLAVE_TYPE     "slave-type"
-
-

-

+
+

Description

+

The NMSettingConnection object is a NMSetting subclass that describes +properties that apply to all NMConnection objects, regardless of what type +of network connection they describe. Each NMConnection object must contain +a NMSettingConnection setting.

-
+
+

Functions

-

NM_SETTING_CONNECTION_SECONDARIES

-
#define NM_SETTING_CONNECTION_SECONDARIES    "secondaries"
-
-

-

+

nm_setting_connection_error_quark ()

+
GQuark
+nm_setting_connection_error_quark (void);
+

Registers an error quark for NMSettingConnection if necessary.

+
+

Returns

+

the error quark used for NMSettingConnection errors.

+

-
-
-

NM_SETTING_CONNECTION_GATEWAY_PING_TIMEOUT

-
#define NM_SETTING_CONNECTION_GATEWAY_PING_TIMEOUT "gateway-ping-timeout"
-
-

-


-

NMSettingConnection

-
typedef struct _NMSettingConnection NMSettingConnection;
-

-The NMSettingConnection struct contains only private data. -It should only be accessed through the functions described below. -

+

nm_setting_connection_new ()

+
NMSetting *
+nm_setting_connection_new (void);
+

Creates a new NMSettingConnection object with default values.

+
+

Returns

+

the new empty NMSettingConnection object

+

-
-
-

NMSettingConnectionClass

-
typedef struct {
-	NMSettingClass parent;
-
-	/* Padding for future expansion */
-	void (*_reserved1) (void);
-	void (*_reserved2) (void);
-	void (*_reserved3) (void);
-	void (*_reserved4) (void);
-} NMSettingConnectionClass;
-
-

-


-

nm_setting_connection_new ()

-
NMSetting *         nm_setting_connection_new           (void);
-

-Creates a new NMSettingConnection object with default values. -

-
+

nm_setting_connection_get_id ()

+
const char *
+nm_setting_connection_get_id (NMSettingConnection *setting);
+

Returns the “id” property of the connection.

+
+

Parameters

+
--+++ - - + + +

Returns :

the new empty NMSettingConnection object

setting

the NMSettingConnection

 
-
-
-

nm_setting_connection_get_id ()

-
const char *        nm_setting_connection_get_id        (NMSettingConnection *setting);
-

-Returns the "id" property of the connection. -

-
---- - - - - - - - - - - -

setting :

the NMSettingConnection -

Returns :

the connection ID
+
+

Returns

+

the connection ID

+

+

-

nm_setting_connection_get_uuid ()

-
const char *        nm_setting_connection_get_uuid      (NMSettingConnection *setting);
-

-Returns the "uuid" property of the connection. -

-
+

nm_setting_connection_get_uuid ()

+
const char *
+nm_setting_connection_get_uuid (NMSettingConnection *setting);
+

Returns the “uuid” property of the connection.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSettingConnection -

Returns :

the connection UUID

setting

the NMSettingConnection

 
+
+

Returns

+

the connection UUID

+

+
+

-

nm_setting_connection_get_interface_name ()

-
const char *        nm_setting_connection_get_interface_name
-                                                        (NMSettingConnection *setting);
-

-Returns the "interface-name" property of the connection. -

-
+

nm_setting_connection_get_interface_name ()

+
const char *
+nm_setting_connection_get_interface_name
+                               (NMSettingConnection *setting);
+

Returns the “interface-name” property of the connection.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSettingConnection -

Returns :

the connection's interface name

setting

the NMSettingConnection

 
+
+
+

Returns

+

the connection's interface name

+

+

Since 0.9.10


-

nm_setting_connection_get_connection_type ()

-
const char *        nm_setting_connection_get_connection_type
-                                                        (NMSettingConnection *setting);
-

-Returns the "type" property of the connection. -

-
+

nm_setting_connection_get_connection_type ()

+
const char *
+nm_setting_connection_get_connection_type
+                               (NMSettingConnection *setting);
+

Returns the “type” property of the connection.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSettingConnection -

Returns :

the connection type

setting

the NMSettingConnection

 
+
+

Returns

+

the connection type

+

+
+

-

nm_setting_connection_get_autoconnect ()

-
gboolean            nm_setting_connection_get_autoconnect
-                                                        (NMSettingConnection *setting);
-

-Returns the "autoconnect" property of the connection. -

-
+

nm_setting_connection_get_autoconnect ()

+
gboolean
+nm_setting_connection_get_autoconnect (NMSettingConnection *setting);
+

Returns the “autoconnect” property of the connection.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSettingConnection -

Returns :

the connection's autoconnect behavior

setting

the NMSettingConnection

 
+
+

Returns

+

the connection's autoconnect behavior

+

+
+

-

nm_setting_connection_get_timestamp ()

-
guint64             nm_setting_connection_get_timestamp (NMSettingConnection *setting);
-

-Returns the "timestamp" property of the connection. -

-
+

nm_setting_connection_get_timestamp ()

+
guint64
+nm_setting_connection_get_timestamp (NMSettingConnection *setting);
+

Returns the “timestamp” property of the connection.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSettingConnection -

Returns :

the connection's timestamp

setting

the NMSettingConnection

 
+
+

Returns

+

the connection's timestamp

+

+
+

-

nm_setting_connection_get_read_only ()

-
gboolean            nm_setting_connection_get_read_only (NMSettingConnection *setting);
-

-Returns the "read-only" property of the connection. -

-
+

nm_setting_connection_get_read_only ()

+
gboolean
+nm_setting_connection_get_read_only (NMSettingConnection *setting);
+

Returns the “read-only” property of the connection.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSettingConnection -

Returns :

-TRUE if the connection is read-only, FALSE if it is not

setting

the NMSettingConnection

 
+
+

Returns

+

TRUE if the connection is read-only, FALSE if it is not

+

+
+

-

nm_setting_connection_get_num_permissions ()

-
guint32             nm_setting_connection_get_num_permissions
-                                                        (NMSettingConnection *setting);
-

-Returns the number of entires in the "permissions" -property of this setting. -

-
+

nm_setting_connection_get_num_permissions ()

+
guint32
+nm_setting_connection_get_num_permissions
+                               (NMSettingConnection *setting);
+

Returns the number of entires in the “permissions” +property of this setting.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSettingConnection -

Returns :

the number of permissions entires

setting

the NMSettingConnection

 
+
+

Returns

+

the number of permissions entires

+

+
+

-

nm_setting_connection_get_permission ()

-
gboolean            nm_setting_connection_get_permission
-                                                        (NMSettingConnection *setting,
-                                                         guint32 idx,
-                                                         const char **out_ptype,
-                                                         const char **out_pitem,
-                                                         const char **out_detail);
-

-Retrieve one of the entries of the "permissions" property -of this setting. -

-
+

nm_setting_connection_get_permission ()

+
gboolean
+nm_setting_connection_get_permission (NMSettingConnection *setting,
+                                      guint32 idx,
+                                      const char **out_ptype,
+                                      const char **out_pitem,
+                                      const char **out_detail);
+

Retrieve one of the entries of the “permissions” property +of this setting.

+
+

Parameters

+
--+++ - - + + + - - + + + - - + + + - - + + + - - - - - - + + +

setting :

the NMSettingConnection -

setting

the NMSettingConnection

 

idx :

the zero-based index of the permissions entry

idx

the zero-based index of the permissions entry

 

out_ptype :

on return, the permission type (at this time, always "user")

out_ptype

on return, the permission type (at this time, always "user")

 

out_pitem :

on return, the permission item (formatted accoring to ptype, see -"permissions" for more detail

out_pitem

on return, the permission item (formatted accoring to ptype +, see +“permissions” for more detail

 

out_detail :

on return, the permission detail (at this time, always NULL)

Returns :

-TRUE if a permission was returned, FALSE if idx was invalid

out_detail

on return, the permission detail (at this time, always NULL)

 
-
-
-

nm_setting_connection_get_zone ()

-
const char *        nm_setting_connection_get_zone      (NMSettingConnection *setting);
-

-Returns the "zone" property of the connection. -

-
---- - - - - - - - - - - -

setting :

the NMSettingConnection -

Returns :

the trust level of a connection
+
+

Returns

+

TRUE if a permission was returned, FALSE if idx +was invalid

+

-
-
-

nm_setting_connection_permissions_user_allowed ()

-
gboolean            nm_setting_connection_permissions_user_allowed
-                                                        (NMSettingConnection *setting,
-                                                         const char *uname);
-

-Checks whether the given username is allowed to view/access this connection. -

-
---- - - - - - - - - - - - - - - -

setting :

the NMSettingConnection -

uname :

the user name to check permissions for

Returns :

-TRUE if the requested user is allowed to view this connection, -FALSE if the given user is not allowed to view this connection

-

nm_setting_connection_add_permission ()

-
gboolean            nm_setting_connection_add_permission
-                                                        (NMSettingConnection *setting,
-                                                         const char *ptype,
-                                                         const char *pitem,
-                                                         const char *detail);
-

-Adds a permission to the connection's permission list. At this time, only -the "user" permission type is supported, and pitem must be a username. See -"permissions": for more details. -

-
+

nm_setting_connection_get_zone ()

+
const char *
+nm_setting_connection_get_zone (NMSettingConnection *setting);
+

Returns the “zone” property of the connection.

+
+

Parameters

+
--+++ - - - - - - - - - - - - - - - - - - - - - - + + + + +

setting :

the NMSettingConnection -

ptype :

the permission type; at this time only "user" is supported

pitem :

the permission item formatted as required for ptype -

detail :

unused at this time; must be NULL. [allow-none] -

Returns :

-TRUE if the permission was unique and was successfully added to the -list, FALSE if ptype or pitem was invalid or it the permission was already -present in the list

setting

the NMSettingConnection

 
+
+

Returns

+

the trust level of a connection

+

+
+

-

nm_setting_connection_remove_permission ()

-
void                nm_setting_connection_remove_permission
-                                                        (NMSettingConnection *setting,
-                                                         guint32 idx);
-

-Removes the permission at index idx from the connection. -

-
+

nm_setting_connection_permissions_user_allowed ()

+
gboolean
+nm_setting_connection_permissions_user_allowed
+                               (NMSettingConnection *setting,
+                                const char *uname);
+

Checks whether the given username is allowed to view/access this connection.

+
+

Parameters

+
--+++ - - + + + - - + + +

setting :

the NMSettingConnection -

setting

the NMSettingConnection

 

idx :

the zero-based index of the permission to remove

uname

the user name to check permissions for

 
+
+

Returns

+

TRUE if the requested user is allowed to view this connection, +FALSE if the given user is not allowed to view this connection

+

+
+

-

nm_setting_connection_remove_permission_by_value ()

-
gboolean            nm_setting_connection_remove_permission_by_value
-                                                        (NMSettingConnection *setting,
-                                                         const char *ptype,
-                                                         const char *pitem,
-                                                         const char *detail);
-

-Removes the permission from the connection. -At this time, only the "user" permission type is supported, and pitem must -be a username. See "permissions": for more details. -

-
+

nm_setting_connection_add_permission ()

+
gboolean
+nm_setting_connection_add_permission (NMSettingConnection *setting,
+                                      const char *ptype,
+                                      const char *pitem,
+                                      const char *detail);
+

Adds a permission to the connection's permission list. At this time, only +the "user" permission type is supported, and pitem + must be a username. See +“permissions”: for more details.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + + - - + + + - - + + +

setting :

the NMSettingConnection -

ptype :

the permission type; at this time only "user" is supported

setting

the NMSettingConnection

 

pitem :

the permission item formatted as required for ptype -

ptype

the permission type; at this time only "user" is supported

 

detail :

unused at this time; must be NULL. [allow-none] -

pitem

the permission item formatted as required for ptype +

 

Returns :

-TRUE if the permission was found and removed; FALSE if it was not.

detail

unused at this time; must be NULL.

[allow-none]
-

Since 0.9.10

+
+
+

Returns

+

TRUE if the permission was unique and was successfully added to the +list, FALSE if ptype +or pitem +was invalid or it the permission was already +present in the list

+

+

-

nm_setting_connection_get_master ()

-
const char *        nm_setting_connection_get_master    (NMSettingConnection *setting);
-

-Returns the "master" property of the connection. -

-
+

nm_setting_connection_remove_permission ()

+
void
+nm_setting_connection_remove_permission
+                               (NMSettingConnection *setting,
+                                guint32 idx);
+

Removes the permission at index idx + from the connection.

+
+

Parameters

+
--+++ - - + + + - - + + +

setting :

the NMSettingConnection -

setting

the NMSettingConnection

 

Returns :

interface name of the master device or UUID of the master -connection.

idx

the zero-based index of the permission to remove

 
+
-

nm_setting_connection_is_slave_type ()

-
gboolean            nm_setting_connection_is_slave_type (NMSettingConnection *setting,
-                                                         const char *type);
-
+

nm_setting_connection_remove_permission_by_value ()

+
gboolean
+nm_setting_connection_remove_permission_by_value
+                               (NMSettingConnection *setting,
+                                const char *ptype,
+                                const char *pitem,
+                                const char *detail);
+

Removes the permission from the connection. +At this time, only the "user" permission type is supported, and pitem + must +be a username. See “permissions”: for more details.

+
+

Parameters

+
--+++ - - + + + - - + + + - - + + + + + + + +

setting :

the NMSettingConnection -

setting

the NMSettingConnection

 

type :

the setting name (ie NM_SETTING_BOND_SETTING_NAME) to be matched -against setting's slave type

ptype

the permission type; at this time only "user" is supported

 

Returns :

-TRUE if connection is of the given slave type -

pitem

the permission item formatted as required for ptype +

 

detail

unused at this time; must be NULL.

[allow-none]
+
+

Returns

+

TRUE if the permission was found and removed; FALSE if it was not.

+

+
+

Since 0.9.10

+ +
+
+

nm_setting_connection_get_master ()

+
const char *
+nm_setting_connection_get_master (NMSettingConnection *setting);
+

Returns the “master” property of the connection.

+
+

Parameters

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

setting

the NMSettingConnection

 
+
+
+

Returns

+

interface name of the master device or UUID of the master +connection.

+

+
+

-

nm_setting_connection_get_slave_type ()

-
const char *        nm_setting_connection_get_slave_type
-                                                        (NMSettingConnection *setting);
-

-Returns the "slave-type" property of the connection. -

-
+

nm_setting_connection_is_slave_type ()

+
gboolean
+nm_setting_connection_is_slave_type (NMSettingConnection *setting,
+                                     const char *type);
+
+

Parameters

+
--+++ - - + + + - - + + +

setting :

the NMSettingConnection -

setting

the NMSettingConnection

 

Returns :

the type of slave this connection is, if any

type

the setting name (ie NM_SETTING_BOND_SETTING_NAME) to be matched +against setting +'s slave type

 
+
+

Returns

+

TRUE if connection is of the given slave type +

+

+
+ +
+
+

nm_setting_connection_get_slave_type ()

+
const char *
+nm_setting_connection_get_slave_type (NMSettingConnection *setting);
+

Returns the “slave-type” property of the connection.

+
+

Parameters

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

setting

the NMSettingConnection

 
+
+
+

Returns

+

the type of slave this connection is, if any

+

+
+
+
+
+

nm_setting_connection_get_num_secondaries ()

+
guint32
+nm_setting_connection_get_num_secondaries
+                               (NMSettingConnection *setting);
+
+

Parameters

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

setting

the NMSettingConnection

 
+
+
+

Returns

+

the number of configured secondary connection UUIDs

+

+
+

Since 0.9.8

+

-

nm_setting_connection_get_num_secondaries ()

-
guint32             nm_setting_connection_get_num_secondaries
-                                                        (NMSettingConnection *setting);
-
+

nm_setting_connection_get_secondary ()

+
const char *
+nm_setting_connection_get_secondary (NMSettingConnection *setting,
+                                     guint32 idx);
+
+

Parameters

+
--+++ - - + + + - - + + +

setting :

the NMSettingConnection -

setting

the NMSettingConnection

 

Returns :

the number of configured secondary connection UUIDs

idx

the zero-based index of the secondary connection UUID entry

 
+
+
+

Returns

+

the secondary connection UUID at index idx +

+

+

Since 0.9.8


-

nm_setting_connection_get_secondary ()

-
const char *        nm_setting_connection_get_secondary (NMSettingConnection *setting,
-                                                         guint32 idx);
-
+

nm_setting_connection_add_secondary ()

+
gboolean
+nm_setting_connection_add_secondary (NMSettingConnection *setting,
+                                     const char *sec_uuid);
+

Adds a new secondary connetion UUID to the setting.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + +

setting :

the NMSettingConnection -

idx :

the zero-based index of the secondary connection UUID entry

setting

the NMSettingConnection

 

Returns :

the secondary connection UUID at index idx -

sec_uuid

the secondary connection UUID to add

 
+
+
+

Returns

+

TRUE if the secondary connection UUID was added; FALSE if the UUID +was already present

+

+

Since 0.9.8


-

nm_setting_connection_add_secondary ()

-
gboolean            nm_setting_connection_add_secondary (NMSettingConnection *setting,
-                                                         const char *sec_uuid);
-

-Adds a new secondary connetion UUID to the setting. -

-
+

nm_setting_connection_remove_secondary ()

+
void
+nm_setting_connection_remove_secondary
+                               (NMSettingConnection *setting,
+                                guint32 idx);
+

Removes the secondary coonnection UUID at index idx +.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + +

setting :

the NMSettingConnection -

sec_uuid :

the secondary connection UUID to add

setting

the NMSettingConnection

 

Returns :

-TRUE if the secondary connection UUID was added; FALSE if the UUID -was already present

idx

index number of the secondary connection UUID

 
+

Since 0.9.8


-

nm_setting_connection_remove_secondary ()

-
void                nm_setting_connection_remove_secondary
-                                                        (NMSettingConnection *setting,
-                                                         guint32 idx);
-

-Removes the secondary coonnection UUID at index idx. -

-
+

nm_setting_connection_remove_secondary_by_value ()

+
gboolean
+nm_setting_connection_remove_secondary_by_value
+                               (NMSettingConnection *setting,
+                                const char *sec_uuid);
+

Removes the secondary coonnection UUID sec_uuid +.

+
+

Parameters

+
--+++ - - + + + - - + + +

setting :

the NMSettingConnection -

setting

the NMSettingConnection

 

idx :

index number of the secondary connection UUID

sec_uuid

the secondary connection UUID to remove

 
-

Since 0.9.8

+
+
+

Returns

+

TRUE if the secondary connection UUID was found and removed; FALSE if it was not.

+

+
+

Since 0.9.10


-

nm_setting_connection_remove_secondary_by_value ()

-
gboolean            nm_setting_connection_remove_secondary_by_value
-                                                        (NMSettingConnection *setting,
-                                                         const char *sec_uuid);
+

nm_setting_connection_get_gateway_ping_timeout ()

+
guint32
+nm_setting_connection_get_gateway_ping_timeout
+                               (NMSettingConnection *setting);
+
+

Parameters

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

setting

the NMSettingConnection

 
+
+
+

Returns

+

the value contained in the “gateway-ping-timeout” +property.

+

+
+

Since 0.9.10

+
+ +
+

Types and Values

+
+

NM_SETTING_CONNECTION_SETTING_NAME

+
#define NM_SETTING_CONNECTION_SETTING_NAME "connection"
+

-Removes the secondary coonnection UUID sec_uuid.

-
+ +
+
+

enum NMSettingConnectionError

+

Describes errors that may result from operations involving a +NMSettingConnection.

+
+

Members

+
--+++ - - + + - - + + + - - + + + - -

setting :

the NMSettingConnection +

NM_SETTING_CONNECTION_ERROR_UNKNOWN

+

unknown or unclassified error

 

sec_uuid :

the secondary connection UUID to remove

NM_SETTING_CONNECTION_ERROR_INVALID_PROPERTY

+

the property's value is + invalid

+
 

Returns :

-TRUE if the secondary connection UUID was found and removed; FALSE if it was not.

NM_SETTING_CONNECTION_ERROR_MISSING_PROPERTY

+

a required property is not + present

+
 
-

Since 0.9.10

-
-
-
-

nm_setting_connection_get_gateway_ping_timeout ()

-
guint32             nm_setting_connection_get_gateway_ping_timeout
-                                                        (NMSettingConnection *setting);
-
---- - - - + + - - + + +

setting :

the NMSettingConnection +

NM_SETTING_CONNECTION_ERROR_TYPE_SETTING_NOT_FOUND

+

the NMSetting object + referenced by the setting name contained in the + “type” property was not present in the NMConnection

 

Returns :

the value contained in the "gateway-ping-timeout" -property.

NM_SETTING_CONNECTION_ERROR_IP_CONFIG_NOT_ALLOWED

+

ip configuration is not + allowed to be present.

+
 
-

Since 0.9.10

-
-

Property Details

+
-

The "autoconnect" property

-
  "autoconnect"              gboolean              : Read / Write / Construct
+

NM_SETTING_CONNECTION_ERROR

+
#define NM_SETTING_CONNECTION_ERROR nm_setting_connection_error_quark ()
+

-Whether or not the connection should be automatically connected by -NetworkManager when the resources for the connection are available. -TRUE to automatically activate the connection, FALSE to require manual -intervention to activate the connection.

-

Default value: TRUE


-

The "gateway-ping-timeout" property

-
  "gateway-ping-timeout"     guint                 : Read / Write / Construct
+

NM_SETTING_CONNECTION_ID

+
#define NM_SETTING_CONNECTION_ID             "id"
+

-If greater than zero, delay success of IP addressing until either the -timeout is reached, or an IP gateway replies to a ping.

-

Allowed values: <= 30

-

Default value: 0

-

Since 0.9.10


-

The "id" property

-
  "id"                       gchar*                : Read / Write
+

NM_SETTING_CONNECTION_UUID

+
#define NM_SETTING_CONNECTION_UUID           "uuid"
+

-A human readable unique identifier for the connection, like "Work Wi-Fi" -or "T-Mobile 3G".

-

Default value: NULL


-

The "interface-name" property

-
  "interface-name"           gchar*                : Read / Write
+

NM_SETTING_CONNECTION_INTERFACE_NAME

+
#define NM_SETTING_CONNECTION_INTERFACE_NAME "interface-name"
+

-The name of the network interface this connection is bound to. If not -set, then the connection can be attached to any interface of the -appropriate type (subject to restrictions imposed by other settings).

+
+
+
+

NM_SETTING_CONNECTION_TYPE

+
#define NM_SETTING_CONNECTION_TYPE           "type"
+

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

+
+
+
+

NM_SETTING_CONNECTION_AUTOCONNECT

+
#define NM_SETTING_CONNECTION_AUTOCONNECT    "autoconnect"
+

-For connection types where interface names cannot easily be made -persistent (e.g. mobile broadband or USB Ethernet), this property should -not be used. Setting this property restricts the interfaces a connection -can be used with, and if interface names change or are reordered the -connection may be applied to the wrong interface.

-

Default value: NULL

-

Since 0.9.10


-

The "master" property

-
  "master"                   gchar*                : Read / Write
+

NM_SETTING_CONNECTION_TIMESTAMP

+
#define NM_SETTING_CONNECTION_TIMESTAMP      "timestamp"
+

-Interface name of the master device or UUID of the master connection.

-

Default value: NULL


-

The "permissions" property

-
  "permissions"              GSList_gchararray_*   : Read / Write
+

NM_SETTING_CONNECTION_READ_ONLY

+
#define NM_SETTING_CONNECTION_READ_ONLY      "read-only"
+

-An array of strings defining what access a given user has to this -connection. If this is NULL or empty, all users are allowed to access -this connection. Otherwise a user is allowed to access this connection -if and only if they are in this list. Each entry is of the form -"[type]:[id]:[reserved]"; for example, "user:dcbw:blah".

+
+
+
+

NM_SETTING_CONNECTION_PERMISSIONS

+
#define NM_SETTING_CONNECTION_PERMISSIONS    "permissions"
+

-At this time only the "user" [type] is allowed. Any other values are -ignored and reserved for future use. [id] is the username that this -permission refers to, which may not contain the ":" character. Any -[reserved] information present must be ignored and is reserved for future -use. All of [type], [id], and [reserved] must be valid UTF-8.


-

The "read-only" property

-
  "read-only"                gboolean              : Read / Write / Construct
+

NM_SETTING_CONNECTION_ZONE

+
#define NM_SETTING_CONNECTION_ZONE           "zone"
+

-FALSE if the connection can be modified using the provided settings -service's D-Bus interface with the right privileges, or TRUE if the -connection is read-only and cannot be modified.

-

Default value: FALSE


-

The "secondaries" property

-
  "secondaries"              GSList_gchararray_*   : Read / Write
+

NM_SETTING_CONNECTION_MASTER

+
#define NM_SETTING_CONNECTION_MASTER         "master"
+

-List of connection UUIDs that should be activated when the base -connection itself is activated. Currently only VPN connections are -supported.

-

Since 0.9.8


-

The "slave-type" property

-
  "slave-type"               gchar*                : Read / Write
+

NM_SETTING_CONNECTION_SLAVE_TYPE

+
#define NM_SETTING_CONNECTION_SLAVE_TYPE     "slave-type"
+

-Setting name of the device type of this slave's master connection (eg, -NM_SETTING_BOND_SETTING_NAME), or NULL if this connection is not a -slave.

-

Default value: NULL


-

The "timestamp" property

-
  "timestamp"                guint64               : Read / Write / Construct
+

NM_SETTING_CONNECTION_SECONDARIES

+
#define NM_SETTING_CONNECTION_SECONDARIES    "secondaries"
+

-The time, in seconds since the Unix Epoch, that the connection was last -_successfully_ fully activated.

+
+
+
+

NM_SETTING_CONNECTION_GATEWAY_PING_TIMEOUT

+
#define NM_SETTING_CONNECTION_GATEWAY_PING_TIMEOUT "gateway-ping-timeout"
+

-NetworkManager updates the connection timestamp periodically when the +

+
+
+
+

NMSettingConnection

+
typedef struct _NMSettingConnection NMSettingConnection;
+

The NMSettingConnection struct contains only private data. +It should only be accessed through the functions described below.

+
+
+
+

Property Details

+
+

The “autoconnect” property

+
  “autoconnect”              gboolean
+

Whether or not the connection should be automatically connected by +NetworkManager when the resources for the connection are available. +TRUE to automatically activate the connection, FALSE to require manual +intervention to activate the connection.

+

Flags: Read / Write / Construct

+

Default value: TRUE

+
+
+
+

The “gateway-ping-timeout” property

+
  “gateway-ping-timeout”     guint
+

If greater than zero, delay success of IP addressing until either the +timeout is reached, or an IP gateway replies to a ping.

+

Flags: Read / Write / Construct

+

Allowed values: <= 30

+

Default value: 0

+

Since 0.9.10

+
+
+
+

The “id” property

+
  “id”                       gchar *
+

A human readable unique identifier for the connection, like "Work Wi-Fi" +or "T-Mobile 3G".

+

Flags: Read / Write

+

Default value: NULL

+
+
+
+

The “interface-name” property

+
  “interface-name”           gchar *
+

The name of the network interface this connection is bound to. If not +set, then the connection can be attached to any interface of the +appropriate type (subject to restrictions imposed by other settings).

+

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

+

For connection types where interface names cannot easily be made +persistent (e.g. mobile broadband or USB Ethernet), this property should +not be used. Setting this property restricts the interfaces a connection +can be used with, and if interface names change or are reordered the +connection may be applied to the wrong interface.

+

Flags: Read / Write

+

Default value: NULL

+

Since 0.9.10

+
+
+
+

The “master” property

+
  “master”                   gchar *
+

Interface name of the master device or UUID of the master connection.

+

Flags: Read / Write

+

Default value: NULL

+
+
+
+

The “permissions” property

+
  “permissions”              GSList_gchararray_ *
+

An array of strings defining what access a given user has to this +connection. If this is NULL or empty, all users are allowed to access +this connection. Otherwise a user is allowed to access this connection +if and only if they are in this list. Each entry is of the form +"[type]:[id]:[reserved]"; for example, "user:dcbw:blah".

+

At this time only the "user" [type] is allowed. Any other values are +ignored and reserved for future use. [id] is the username that this +permission refers to, which may not contain the ":" character. Any +[reserved] information present must be ignored and is reserved for future +use. All of [type], [id], and [reserved] must be valid UTF-8.

+

Flags: Read / Write

+
+
+
+

The “read-only” property

+
  “read-only”                gboolean
+

FALSE if the connection can be modified using the provided settings +service's D-Bus interface with the right privileges, or TRUE if the +connection is read-only and cannot be modified.

+

Flags: Read / Write / Construct

+

Default value: FALSE

+
+
+
+

The “secondaries” property

+
  “secondaries”              GSList_gchararray_ *
+

List of connection UUIDs that should be activated when the base +connection itself is activated. Currently only VPN connections are +supported.

+

Flags: Read / Write

+

Since 0.9.8

+
+
+
+

The “slave-type” property

+
  “slave-type”               gchar *
+

Setting name of the device type of this slave's master connection (eg, +NM_SETTING_BOND_SETTING_NAME), or NULL if this connection is not a +slave.

+

Flags: Read / Write

+

Default value: NULL

+
+
+
+

The “timestamp” property

+
  “timestamp”                guint64
+

The time, in seconds since the Unix Epoch, that the connection was last +_successfully_ fully activated.

+

NetworkManager updates the connection timestamp periodically when the connection is active to ensure that an active connection has the latest timestamp. The property is only meant for reading (changes to this -property will not be preserved). -

+property will not be preserved).

+

Flags: Read / Write / Construct

Default value: 0


-

The "type" property

-
  "type"                     gchar*                : Read / Write
-

-Base type of the connection. For hardware-dependent connections, should +

The “type” property

+
  “type”                     gchar *
+

Base type of the connection. For hardware-dependent connections, should contain the setting name of the hardware-type specific setting (ie, "802-3-ethernet" or "802-11-wireless" or "bluetooth", etc), and for non-hardware dependent connections like VPN or otherwise, should contain -the setting name of that setting type (ie, "vpn" or "bridge", etc). -

+the setting name of that setting type (ie, "vpn" or "bridge", etc).

+

Flags: Read / Write

Default value: NULL


-

The "uuid" property

-
  "uuid"                     gchar*                : Read / Write
-

-A universally unique identifier for the connection, for example generated +

The “uuid” property

+
  “uuid”                     gchar *
+

A universally unique identifier for the connection, for example generated with libuuid. It should be assigned when the connection is created, and never changed as long as the connection still applies to the same network. For example, it should not be changed when the -"id" property or NMSettingIP4Config changes, but +“id” property or NMSettingIP4Config changes, but might need to be re-created when the Wi-Fi SSID, mobile broadband network -provider, or "type" property changes. -

-

-The UUID must be in the format "2815492f-7e56-435e-b2e9-246bd7cdc664" +provider, or “type” property changes.

+

The UUID must be in the format "2815492f-7e56-435e-b2e9-246bd7cdc664" (ie, contains only hexadecimal characters and "-"). A suitable UUID may -be generated by nm_utils_uuid_generate() or -nm_utils_uuid_generate_from_string(). -

+be generated by nm_utils_uuid_generate() or +nm_utils_uuid_generate_from_string().

+

Flags: Read / Write

Default value: NULL


-

The "zone" property

-
  "zone"                     gchar*                : Read / Write / Construct
-

-The trust level of a the connection. Free form case-insensitive string -(for example "Home", "Work", "Public"). NULL or unspecified zone means +

The “zone” property

+
  “zone”                     gchar *
+

The trust level of a the connection. Free form case-insensitive string +(for example "Home", "Work", "Public"). NULL or unspecified zone means the connection will be placed in the default zone as defined by the -firewall. -

+firewall.

+

Flags: Read / Write / Construct

Default value: NULL

+ Generated by GTK-Doc V1.21 \ No newline at end of file diff --git a/docs/libnm-util/html/NMSettingDcb.html b/docs/libnm-util/html/NMSettingDcb.html index 99bfdc76..8f2d90ea 100644 --- a/docs/libnm-util/html/NMSettingDcb.html +++ b/docs/libnm-util/html/NMSettingDcb.html @@ -2,34 +2,28 @@ -NMSettingDcb +libnm-util Reference Manual: NMSettingDcb - + - - - - - - - - - - + + + + + + +
@@ -37,1214 +31,1510 @@

NMSettingDcb

NMSettingDcb — Connection properties for Data Center Bridging

- +
-
-

Synopsis

-
-#include <nm-setting-dcb.h>
-
-#define             NM_SETTING_DCB_SETTING_NAME
-enum                NMSettingDcbError;
-#define             NM_SETTING_DCB_ERROR
-GQuark              nm_setting_dcb_error_quark          (void);
-enum                NMSettingDcbFlags;
-#define             NM_SETTING_DCB_FCOE_MODE_FABRIC
-#define             NM_SETTING_DCB_FCOE_MODE_VN2VN
-#define             NM_SETTING_DCB_APP_FCOE_FLAGS
-#define             NM_SETTING_DCB_APP_FCOE_PRIORITY
-#define             NM_SETTING_DCB_APP_FCOE_MODE
-#define             NM_SETTING_DCB_APP_ISCSI_FLAGS
-#define             NM_SETTING_DCB_APP_ISCSI_PRIORITY
-#define             NM_SETTING_DCB_APP_FIP_FLAGS
-#define             NM_SETTING_DCB_APP_FIP_PRIORITY
-#define             NM_SETTING_DCB_PRIORITY_FLOW_CONTROL_FLAGS
-#define             NM_SETTING_DCB_PRIORITY_FLOW_CONTROL
-#define             NM_SETTING_DCB_PRIORITY_GROUP_FLAGS
-#define             NM_SETTING_DCB_PRIORITY_GROUP_ID
-#define             NM_SETTING_DCB_PRIORITY_GROUP_BANDWIDTH
-#define             NM_SETTING_DCB_PRIORITY_BANDWIDTH
-#define             NM_SETTING_DCB_PRIORITY_STRICT_BANDWIDTH
-#define             NM_SETTING_DCB_PRIORITY_TRAFFIC_CLASS
-                    NMSettingDcb;
-                    NMSettingDcbClass;
-NMSetting *         nm_setting_dcb_new                  (void);
-NMSettingDcbFlags   nm_setting_dcb_get_app_fcoe_flags   (NMSettingDcb *setting);
-gint                nm_setting_dcb_get_app_fcoe_priority
-                                                        (NMSettingDcb *setting);
-const char *        nm_setting_dcb_get_app_fcoe_mode    (NMSettingDcb *setting);
-NMSettingDcbFlags   nm_setting_dcb_get_app_iscsi_flags  (NMSettingDcb *setting);
-gint                nm_setting_dcb_get_app_iscsi_priority
-                                                        (NMSettingDcb *setting);
-NMSettingDcbFlags   nm_setting_dcb_get_app_fip_flags    (NMSettingDcb *setting);
-gint                nm_setting_dcb_get_app_fip_priority (NMSettingDcb *setting);
-NMSettingDcbFlags   nm_setting_dcb_get_priority_flow_control_flags
-                                                        (NMSettingDcb *setting);
-gboolean            nm_setting_dcb_get_priority_flow_control
-                                                        (NMSettingDcb *setting,
-                                                         guint user_priority);
-void                nm_setting_dcb_set_priority_flow_control
-                                                        (NMSettingDcb *setting,
-                                                         guint user_priority,
-                                                         gboolean enabled);
-NMSettingDcbFlags   nm_setting_dcb_get_priority_group_flags
-                                                        (NMSettingDcb *setting);
-guint               nm_setting_dcb_get_priority_group_id
-                                                        (NMSettingDcb *setting,
-                                                         guint user_priority);
-void                nm_setting_dcb_set_priority_group_id
-                                                        (NMSettingDcb *setting,
-                                                         guint user_priority,
-                                                         guint group_id);
-guint               nm_setting_dcb_get_priority_group_bandwidth
-                                                        (NMSettingDcb *setting,
-                                                         guint group_id);
-void                nm_setting_dcb_set_priority_group_bandwidth
-                                                        (NMSettingDcb *setting,
-                                                         guint group_id,
-                                                         guint bandwidth_percent);
-guint               nm_setting_dcb_get_priority_bandwidth
-                                                        (NMSettingDcb *setting,
-                                                         guint user_priority);
-void                nm_setting_dcb_set_priority_bandwidth
-                                                        (NMSettingDcb *setting,
-                                                         guint user_priority,
-                                                         guint bandwidth_percent);
-gboolean            nm_setting_dcb_get_priority_strict_bandwidth
-                                                        (NMSettingDcb *setting,
-                                                         guint user_priority);
-void                nm_setting_dcb_set_priority_strict_bandwidth
-                                                        (NMSettingDcb *setting,
-                                                         guint user_priority,
-                                                         gboolean strict);
-guint               nm_setting_dcb_get_priority_traffic_class
-                                                        (NMSettingDcb *setting,
-                                                         guint user_priority);
-void                nm_setting_dcb_set_priority_traffic_class
-                                                        (NMSettingDcb *setting,
-                                                         guint user_priority,
-                                                         guint traffic_class);
-
-
-
-

Object Hierarchy

-
-  GEnum
-   +----NMSettingDcbError
-
-
-  GEnum
-   +----NMSettingDcbFlags
-
-
-  GObject
-   +----NMSetting
-         +----NMSettingDcb
-
-
-
-

Properties

-
-  "app-fcoe-flags"           guint                 : Read / Write
-  "app-fcoe-mode"            gchar*                : Read / Write / Construct
-  "app-fcoe-priority"        gint                  : Read / Write / Construct
-  "app-fip-flags"            guint                 : Read / Write
-  "app-fip-priority"         gint                  : Read / Write / Construct
-  "app-iscsi-flags"          guint                 : Read / Write
-  "app-iscsi-priority"       gint                  : Read / Write / Construct
-  "priority-bandwidth"       GArray_guint_*        : Read / Write
-  "priority-flow-control"    GArray_guint_*        : Read / Write
-  "priority-flow-control-flags" guint                 : Read / Write
-  "priority-group-bandwidth" GArray_guint_*        : Read / Write
-  "priority-group-flags"     guint                 : Read / Write
-  "priority-group-id"        GArray_guint_*        : Read / Write
-  "priority-strict-bandwidth" GArray_guint_*        : Read / Write
-  "priority-traffic-class"   GArray_guint_*        : Read / Write
-
-
-

Description

-

-The NMSettingDcb object is a NMSetting subclass that describes properties -for enabling and using Data Center Bridging (DCB) on Ethernet networks. -DCB is a set of protocols (including 802.1Qbb, 802.1Qaz, 802.1Qau, and -802.1AB) to eliminate packet loss in Ethernet networks and support the use -of storage technologies like Fibre Channel over Ethernet (FCoE) and iSCSI. -

-
-
-

Details

-
-

NM_SETTING_DCB_SETTING_NAME

-
#define NM_SETTING_DCB_SETTING_NAME "dcb"
-
-

-

-
-
-
-

enum NMSettingDcbError

-
typedef enum {
-	NM_SETTING_DCB_ERROR_UNKNOWN = 0,      /*< nick=UnknownError >*/
-	NM_SETTING_DCB_ERROR_INVALID_PROPERTY, /*< nick=InvalidProperty >*/
-	NM_SETTING_DCB_ERROR_MISSING_PROPERTY  /*< nick=MissingProperty >*/
-} NMSettingDcbError;
-
-
+

Functions

+
--++ - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - - + - - + + + + +

NM_SETTING_DCB_ERROR_UNKNOWN

unknown or unclassified error + +GQuark + +nm_setting_dcb_error_quark () +
+NMSetting * + +nm_setting_dcb_new () +
+NMSettingDcbFlags + +nm_setting_dcb_get_app_fcoe_flags () +
+gint + +nm_setting_dcb_get_app_fcoe_priority () +
const char * + +nm_setting_dcb_get_app_fcoe_mode () +
+NMSettingDcbFlags + +nm_setting_dcb_get_app_iscsi_flags () +
+gint + +nm_setting_dcb_get_app_iscsi_priority () +
+NMSettingDcbFlags + +nm_setting_dcb_get_app_fip_flags () +
+gint + +nm_setting_dcb_get_app_fip_priority () +
+NMSettingDcbFlags + +nm_setting_dcb_get_priority_flow_control_flags () +
+gboolean + +nm_setting_dcb_get_priority_flow_control () +
+void + +nm_setting_dcb_set_priority_flow_control () +
+NMSettingDcbFlags + +nm_setting_dcb_get_priority_group_flags () +
+guint + +nm_setting_dcb_get_priority_group_id () +
+void + +nm_setting_dcb_set_priority_group_id () +
+guint + +nm_setting_dcb_get_priority_group_bandwidth () +
+void + +nm_setting_dcb_set_priority_group_bandwidth () +
+guint + +nm_setting_dcb_get_priority_bandwidth () +
+void + +nm_setting_dcb_set_priority_bandwidth () +
+gboolean + +nm_setting_dcb_get_priority_strict_bandwidth ()

NM_SETTING_DCB_ERROR_INVALID_PROPERTY

the property was invalid + +void + +nm_setting_dcb_set_priority_strict_bandwidth ()

NM_SETTING_DCB_ERROR_MISSING_PROPERTY

the property was missing and is -required + +guint + +nm_setting_dcb_get_priority_traffic_class () +
+void + +nm_setting_dcb_set_priority_traffic_class ()
-
-
-

NM_SETTING_DCB_ERROR

-
#define NM_SETTING_DCB_ERROR nm_setting_dcb_error_quark ()
-
-

-

-
-
-
-

nm_setting_dcb_error_quark ()

-
GQuark              nm_setting_dcb_error_quark          (void);
-

-Registers an error quark for NMSettingDcb if necessary. -

-
+
+

Properties

+
--+++ - - - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Returns :

the error quark used for NMSettingDcb errors.
guintapp-fcoe-flagsRead / Write
+gchar *app-fcoe-modeRead / Write / Construct
gintapp-fcoe-priorityRead / Write / Construct
guintapp-fip-flagsRead / Write
gintapp-fip-priorityRead / Write / Construct
guintapp-iscsi-flagsRead / Write
gintapp-iscsi-priorityRead / Write / Construct
+GArray_guint_ *priority-bandwidthRead / Write
+GArray_guint_ *priority-flow-controlRead / Write
guintpriority-flow-control-flagsRead / Write
+GArray_guint_ *priority-group-bandwidthRead / Write
guintpriority-group-flagsRead / Write
+GArray_guint_ *priority-group-idRead / Write
+GArray_guint_ *priority-strict-bandwidthRead / Write
+GArray_guint_ *priority-traffic-classRead / Write
-

Since 0.9.10

-
-
-

enum NMSettingDcbFlags

-
typedef enum {
-	NM_SETTING_DCB_FLAG_NONE      = 0x00000000,
-	NM_SETTING_DCB_FLAG_ENABLE    = 0x00000001,
-	NM_SETTING_DCB_FLAG_ADVERTISE = 0x00000002,
-	NM_SETTING_DCB_FLAG_WILLING   = 0x00000004
-} NMSettingDcbFlags;
-
-

-DCB feature flags. -

-
+
+

Types and Values

+
--++ - - + + - - + + - - + + - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

NM_SETTING_DCB_FLAG_NONE

no flag -#defineNM_SETTING_DCB_SETTING_NAME

NM_SETTING_DCB_FLAG_ENABLE

the feature is enabled -enumNMSettingDcbError

NM_SETTING_DCB_FLAG_ADVERTISE

the feature is advertised -#defineNM_SETTING_DCB_ERROR

NM_SETTING_DCB_FLAG_WILLING

the feature is willing to change based on -peer configuration advertisements -enumNMSettingDcbFlags
#defineNM_SETTING_DCB_FCOE_MODE_FABRIC
#defineNM_SETTING_DCB_FCOE_MODE_VN2VN
#defineNM_SETTING_DCB_APP_FCOE_FLAGS
#defineNM_SETTING_DCB_APP_FCOE_PRIORITY
#defineNM_SETTING_DCB_APP_FCOE_MODE
#defineNM_SETTING_DCB_APP_ISCSI_FLAGS
#defineNM_SETTING_DCB_APP_ISCSI_PRIORITY
#defineNM_SETTING_DCB_APP_FIP_FLAGS
#defineNM_SETTING_DCB_APP_FIP_PRIORITY
#defineNM_SETTING_DCB_PRIORITY_FLOW_CONTROL_FLAGS
#defineNM_SETTING_DCB_PRIORITY_FLOW_CONTROL
#defineNM_SETTING_DCB_PRIORITY_GROUP_FLAGS
#defineNM_SETTING_DCB_PRIORITY_GROUP_ID
#defineNM_SETTING_DCB_PRIORITY_GROUP_BANDWIDTH
#defineNM_SETTING_DCB_PRIORITY_BANDWIDTH
#defineNM_SETTING_DCB_PRIORITY_STRICT_BANDWIDTH
#defineNM_SETTING_DCB_PRIORITY_TRAFFIC_CLASS
-

Since 0.9.10

-
-
-

NM_SETTING_DCB_FCOE_MODE_FABRIC

-
#define NM_SETTING_DCB_FCOE_MODE_FABRIC  "fabric"
-
-

-Indicates that the FCoE controller should use "fabric" mode (default) -

-

Since 0.9.10

-
-
-
-

NM_SETTING_DCB_FCOE_MODE_VN2VN

-
#define NM_SETTING_DCB_FCOE_MODE_VN2VN   "vn2vn"
-
-

-Indicates that the FCoE controller should use "VN2VN" mode. -

-

Since 0.9.10

-
-
-
-

NM_SETTING_DCB_APP_FCOE_FLAGS

-
#define NM_SETTING_DCB_APP_FCOE_FLAGS         "app-fcoe-flags"
-
-

-

-
-
-
-

NM_SETTING_DCB_APP_FCOE_PRIORITY

-
#define NM_SETTING_DCB_APP_FCOE_PRIORITY      "app-fcoe-priority"
-
-

-

-
-
-
-

NM_SETTING_DCB_APP_FCOE_MODE

-
#define NM_SETTING_DCB_APP_FCOE_MODE          "app-fcoe-mode"
-
-

-

-
-
-
-

NM_SETTING_DCB_APP_ISCSI_FLAGS

-
#define NM_SETTING_DCB_APP_ISCSI_FLAGS        "app-iscsi-flags"
-
-

-

-
-
-
-

NM_SETTING_DCB_APP_ISCSI_PRIORITY

-
#define NM_SETTING_DCB_APP_ISCSI_PRIORITY     "app-iscsi-priority"
+
+

Object Hierarchy

+
    GEnum
+    ├── NMSettingDcbError
+    ╰── NMSettingDcbFlags
+    GObject
+    ╰── NMSetting
+        ╰── NMSettingDcb
 
-

-

-
-
-

NM_SETTING_DCB_APP_FIP_FLAGS

-
#define NM_SETTING_DCB_APP_FIP_FLAGS          "app-fip-flags"
+
+

Includes

+
#include <nm-setting-dcb.h>
 
-

-

-
-
-

NM_SETTING_DCB_APP_FIP_PRIORITY

-
#define NM_SETTING_DCB_APP_FIP_PRIORITY       "app-fip-priority"
-
-

-

+
+

Description

+

The NMSettingDcb object is a NMSetting subclass that describes properties +for enabling and using Data Center Bridging (DCB) on Ethernet networks. +DCB is a set of protocols (including 802.1Qbb, 802.1Qaz, 802.1Qau, and +802.1AB) to eliminate packet loss in Ethernet networks and support the use +of storage technologies like Fibre Channel over Ethernet (FCoE) and iSCSI.

-
+
+

Functions

-

NM_SETTING_DCB_PRIORITY_FLOW_CONTROL_FLAGS

-
#define NM_SETTING_DCB_PRIORITY_FLOW_CONTROL_FLAGS  "priority-flow-control-flags"
-
-

-

+

nm_setting_dcb_error_quark ()

+
GQuark
+nm_setting_dcb_error_quark (void);
+

Registers an error quark for NMSettingDcb if necessary.

+
+

Returns

+

the error quark used for NMSettingDcb errors.

+

-
-
-

NM_SETTING_DCB_PRIORITY_FLOW_CONTROL

-
#define NM_SETTING_DCB_PRIORITY_FLOW_CONTROL        "priority-flow-control"
-
-

-

+

Since 0.9.10


-

NM_SETTING_DCB_PRIORITY_GROUP_FLAGS

-
#define NM_SETTING_DCB_PRIORITY_GROUP_FLAGS      "priority-group-flags"
-
-

-

+

nm_setting_dcb_new ()

+
NMSetting *
+nm_setting_dcb_new (void);
+

Creates a new NMSettingDcb object with default values.

+
+

Returns

+

the new empty NMSettingDcb object.

+

[transfer full]

-
-
-

NM_SETTING_DCB_PRIORITY_GROUP_ID

-
#define NM_SETTING_DCB_PRIORITY_GROUP_ID         "priority-group-id"
-
-

-

+

Since 0.9.10


-

NM_SETTING_DCB_PRIORITY_GROUP_BANDWIDTH

-
#define NM_SETTING_DCB_PRIORITY_GROUP_BANDWIDTH  "priority-group-bandwidth"
-
-

-

+

nm_setting_dcb_get_app_fcoe_flags ()

+
NMSettingDcbFlags
+nm_setting_dcb_get_app_fcoe_flags (NMSettingDcb *setting);
+
+

Parameters

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

setting

the NMSettingDcb

 
-
-
-

NM_SETTING_DCB_PRIORITY_BANDWIDTH

-
#define NM_SETTING_DCB_PRIORITY_BANDWIDTH        "priority-bandwidth"
-
-

-

+
+

Returns

+

the “app-fcoe-flags” property of the setting

+

-
-
-

NM_SETTING_DCB_PRIORITY_STRICT_BANDWIDTH

-
#define NM_SETTING_DCB_PRIORITY_STRICT_BANDWIDTH "priority-strict-bandwidth"
-
-

-

+

Since 0.9.10


-

NM_SETTING_DCB_PRIORITY_TRAFFIC_CLASS

-
#define NM_SETTING_DCB_PRIORITY_TRAFFIC_CLASS    "priority-traffic-class"
-
-

-

+

nm_setting_dcb_get_app_fcoe_priority ()

+
gint
+nm_setting_dcb_get_app_fcoe_priority (NMSettingDcb *setting);
+
+

Parameters

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

setting

the NMSettingDcb

 
-
-
-

NMSettingDcb

-
typedef struct _NMSettingDcb NMSettingDcb;
-

-

+
+

Returns

+

the “app-fcoe-priority” property of the setting

+

-
-
-

NMSettingDcbClass

-
typedef struct {
-	NMSettingClass parent;
-
-	/* Padding for future expansion */
-	void (*_reserved1) (void);
-	void (*_reserved2) (void);
-	void (*_reserved3) (void);
-	void (*_reserved4) (void);
-} NMSettingDcbClass;
-
-

-

+

Since 0.9.10


-

nm_setting_dcb_new ()

-
NMSetting *         nm_setting_dcb_new                  (void);
-

-Creates a new NMSettingDcb object with default values. -

-
+

nm_setting_dcb_get_app_fcoe_mode ()

+
const char *
+nm_setting_dcb_get_app_fcoe_mode (NMSettingDcb *setting);
+
+

Parameters

+
--+++ - - + + +

Returns :

the new empty NMSettingDcb object. [transfer full] -

setting

the NMSettingDcb

 
+
+
+

Returns

+

the “app-fcoe-mode” property of the setting

+

+

Since 0.9.10


-

nm_setting_dcb_get_app_fcoe_flags ()

-
NMSettingDcbFlags   nm_setting_dcb_get_app_fcoe_flags   (NMSettingDcb *setting);
-
+

nm_setting_dcb_get_app_iscsi_flags ()

+
NMSettingDcbFlags
+nm_setting_dcb_get_app_iscsi_flags (NMSettingDcb *setting);
+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSettingDcb -

Returns :

the "app-fcoe-flags" property of the setting

setting

the NMSettingDcb

 
+
+
+

Returns

+

the “app-iscsi-flags” property of the setting

+

+

Since 0.9.10


-

nm_setting_dcb_get_app_fcoe_priority ()

-
gint                nm_setting_dcb_get_app_fcoe_priority
-                                                        (NMSettingDcb *setting);
-
+

nm_setting_dcb_get_app_iscsi_priority ()

+
gint
+nm_setting_dcb_get_app_iscsi_priority (NMSettingDcb *setting);
+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSettingDcb -

Returns :

the "app-fcoe-priority" property of the setting

setting

the NMSettingDcb

 
+
+
+

Returns

+

the “app-iscsi-priority” property of the setting

+

+

Since 0.9.10


-

nm_setting_dcb_get_app_fcoe_mode ()

-
const char *        nm_setting_dcb_get_app_fcoe_mode    (NMSettingDcb *setting);
-
+

nm_setting_dcb_get_app_fip_flags ()

+
NMSettingDcbFlags
+nm_setting_dcb_get_app_fip_flags (NMSettingDcb *setting);
+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSettingDcb -

Returns :

the "app-fcoe-mode" property of the setting

setting

the NMSettingDcb

 
+
+
+

Returns

+

the “app-fip-flags” property of the setting

+

+

Since 0.9.10


-

nm_setting_dcb_get_app_iscsi_flags ()

-
NMSettingDcbFlags   nm_setting_dcb_get_app_iscsi_flags  (NMSettingDcb *setting);
-
+

nm_setting_dcb_get_app_fip_priority ()

+
gint
+nm_setting_dcb_get_app_fip_priority (NMSettingDcb *setting);
+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSettingDcb -

Returns :

the "app-iscsi-flags" property of the setting

setting

the NMSettingDcb

 
+
+
+

Returns

+

the “app-fip-priority” property of the setting

+

+

Since 0.9.10


-

nm_setting_dcb_get_app_iscsi_priority ()

-
gint                nm_setting_dcb_get_app_iscsi_priority
-                                                        (NMSettingDcb *setting);
-
+

nm_setting_dcb_get_priority_flow_control_flags ()

+
NMSettingDcbFlags
+nm_setting_dcb_get_priority_flow_control_flags
+                               (NMSettingDcb *setting);
+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSettingDcb -

Returns :

the "app-iscsi-priority" property of the setting

setting

the NMSettingDcb

 
+
+
+

Returns

+

the “priority-flow-control-flags” property of the setting

+

+

Since 0.9.10


-

nm_setting_dcb_get_app_fip_flags ()

-
NMSettingDcbFlags   nm_setting_dcb_get_app_fip_flags    (NMSettingDcb *setting);
-
+

nm_setting_dcb_get_priority_flow_control ()

+
gboolean
+nm_setting_dcb_get_priority_flow_control
+                               (NMSettingDcb *setting,
+                                guint user_priority);
+
+

Parameters

+
--+++ - - + + + - - + + +

setting :

the NMSettingDcb -

setting

the NMSettingDcb

 

Returns :

the "app-fip-flags" property of the setting

user_priority

the User Priority (0 - 7) to retrieve flow control for

 
+
+
+

Returns

+

TRUE if flow control is enabled for the given user_priority +, +FALSE if not enabled

+

+

Since 0.9.10


-

nm_setting_dcb_get_app_fip_priority ()

-
gint                nm_setting_dcb_get_app_fip_priority (NMSettingDcb *setting);
-
+

nm_setting_dcb_set_priority_flow_control ()

+
void
+nm_setting_dcb_set_priority_flow_control
+                               (NMSettingDcb *setting,
+                                guint user_priority,
+                                gboolean enabled);
+

These values are only valid when “priority-flow-control” includes +the NM_SETTING_DCB_FLAG_ENABLE flag.

+
+

Parameters

+
--+++ - - + + + + + + + + - - + + +

setting :

the NMSettingDcb -

setting

the NMSettingDcb

 

user_priority

the User Priority (0 - 7) to set flow control for

 

Returns :

the "app-fip-priority" property of the setting

enabled

TRUE to enable flow control for this priority, FALSE to disable it

 
+

Since 0.9.10


-

nm_setting_dcb_get_priority_flow_control_flags ()

-
NMSettingDcbFlags   nm_setting_dcb_get_priority_flow_control_flags
-                                                        (NMSettingDcb *setting);
-
+

nm_setting_dcb_get_priority_group_flags ()

+
NMSettingDcbFlags
+nm_setting_dcb_get_priority_group_flags
+                               (NMSettingDcb *setting);
+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSettingDcb -

Returns :

the "priority-flow-control-flags" property of the setting

setting

the NMSettingDcb

 
+
+
+

Returns

+

the “priority-group-flags” property of the setting

+

+

Since 0.9.10


-

nm_setting_dcb_get_priority_flow_control ()

-
gboolean            nm_setting_dcb_get_priority_flow_control
-                                                        (NMSettingDcb *setting,
-                                                         guint user_priority);
-
+

nm_setting_dcb_get_priority_group_id ()

+
guint
+nm_setting_dcb_get_priority_group_id (NMSettingDcb *setting,
+                                      guint user_priority);
+
+

Parameters

+
--+++ - - - - - - + + + - - + + +

setting :

the NMSettingDcb -

user_priority :

the User Priority (0 - 7) to retrieve flow control for

setting

the NMSettingDcb

 

Returns :

-TRUE if flow control is enabled for the given user_priority, -FALSE if not enabled

user_priority

the User Priority (0 - 7) to retrieve the group ID for

 
+
+
+

Returns

+

the group number user_priority +is assigned to. These values are +only valid when “priority-group-flags” includes the +NM_SETTING_DCB_FLAG_ENABLE flag.

+

+

Since 0.9.10


-

nm_setting_dcb_set_priority_flow_control ()

-
void                nm_setting_dcb_set_priority_flow_control
-                                                        (NMSettingDcb *setting,
-                                                         guint user_priority,
-                                                         gboolean enabled);
-

-These values are only valid when "priority-flow-control" includes -the NM_SETTING_DCB_FLAG_ENABLE flag. -

-
+

nm_setting_dcb_set_priority_group_id ()

+
void
+nm_setting_dcb_set_priority_group_id (NMSettingDcb *setting,
+                                      guint user_priority,
+                                      guint group_id);
+

These values are only valid when “priority-group-flags” includes +the NM_SETTING_DCB_FLAG_ENABLE flag.

+
+

Parameters

+
--+++ - - + + + - - + + + - - + + +

setting :

the NMSettingDcb -

setting

the NMSettingDcb

 

user_priority :

the User Priority (0 - 7) to set flow control for

user_priority

the User Priority (0 - 7) to set flow control for

 

enabled :

-TRUE to enable flow control for this priority, FALSE to disable it

group_id

the group (0 - 7) to assign user_priority +to, or 15 for the +unrestricted group.

 
+

Since 0.9.10


-

nm_setting_dcb_get_priority_group_flags ()

-
NMSettingDcbFlags   nm_setting_dcb_get_priority_group_flags
-                                                        (NMSettingDcb *setting);
-
+

nm_setting_dcb_get_priority_group_bandwidth ()

+
guint
+nm_setting_dcb_get_priority_group_bandwidth
+                               (NMSettingDcb *setting,
+                                guint group_id);
+
+

Parameters

+
--+++ - - + + + - - + + +

setting :

the NMSettingDcb -

setting

the NMSettingDcb

 

Returns :

the "priority-group-flags" property of the setting

group_id

the priority group (0 - 7) to retrieve the bandwidth percentage for

 
+
+
+

Returns

+

the bandwidth percentage assigned to group_id +. These values are +only valid when “priority-group-flags” includes the +NM_SETTING_DCB_FLAG_ENABLE flag.

+

+

Since 0.9.10


-

nm_setting_dcb_get_priority_group_id ()

-
guint               nm_setting_dcb_get_priority_group_id
-                                                        (NMSettingDcb *setting,
-                                                         guint user_priority);
-
+

nm_setting_dcb_set_priority_group_bandwidth ()

+
void
+nm_setting_dcb_set_priority_group_bandwidth
+                               (NMSettingDcb *setting,
+                                guint group_id,
+                                guint bandwidth_percent);
+

These values are only valid when “priority-group-flags” includes +the NM_SETTING_DCB_FLAG_ENABLE flag.

+
+

Parameters

+
--+++ - - + + + - - + + + - - + + +

setting :

the NMSettingDcb -

setting

the NMSettingDcb

 

user_priority :

the User Priority (0 - 7) to retrieve the group ID for

group_id

the priority group (0 - 7) to set the bandwidth percentage for

 

Returns :

the group number user_priority is assigned to. These values are -only valid when "priority-group-flags" includes the -NM_SETTING_DCB_FLAG_ENABLE flag.

bandwidth_percent

the bandwidth percentage (0 - 100) to assign to group_id +to

 
+

Since 0.9.10


-

nm_setting_dcb_set_priority_group_id ()

-
void                nm_setting_dcb_set_priority_group_id
-                                                        (NMSettingDcb *setting,
-                                                         guint user_priority,
-                                                         guint group_id);
-

-These values are only valid when "priority-group-flags" includes -the NM_SETTING_DCB_FLAG_ENABLE flag. -

-
+

nm_setting_dcb_get_priority_bandwidth ()

+
guint
+nm_setting_dcb_get_priority_bandwidth (NMSettingDcb *setting,
+                                       guint user_priority);
+
+

Parameters

+
--+++ - - - - - - + + + - - + + +

setting :

the NMSettingDcb -

user_priority :

the User Priority (0 - 7) to set flow control for

setting

the NMSettingDcb

 

group_id :

the group (0 - 7) to assign user_priority to, or 15 for the -unrestricted group.

user_priority

the User Priority (0 - 7) to retrieve the group bandwidth percentage for

 
+
+
+

Returns

+

the allowed bandwidth percentage of user_priority +in its priority group. +These values are only valid when “priority-group-flags” includes the +NM_SETTING_DCB_FLAG_ENABLE flag.

+

+

Since 0.9.10


-

nm_setting_dcb_get_priority_group_bandwidth ()

-
guint               nm_setting_dcb_get_priority_group_bandwidth
-                                                        (NMSettingDcb *setting,
-                                                         guint group_id);
-
+

nm_setting_dcb_set_priority_bandwidth ()

+
void
+nm_setting_dcb_set_priority_bandwidth (NMSettingDcb *setting,
+                                       guint user_priority,
+                                       guint bandwidth_percent);
+

These values are only valid when “priority-group-flags” includes +the NM_SETTING_DCB_FLAG_ENABLE flag.

+
+

Parameters

+
--+++ - - + + + - - + + + - - + + +

setting :

the NMSettingDcb -

setting

the NMSettingDcb

 

group_id :

the priority group (0 - 7) to retrieve the bandwidth percentage for

user_priority

the User Priority (0 - 7) to set the bandwidth percentage for

 

Returns :

the bandwidth percentage assigned to group_id. These values are -only valid when "priority-group-flags" includes the -NM_SETTING_DCB_FLAG_ENABLE flag.

bandwidth_percent

the bandwidth percentage (0 - 100) that user_priority +is +allowed to use within its priority group

 
+

Since 0.9.10


-

nm_setting_dcb_set_priority_group_bandwidth ()

-
void                nm_setting_dcb_set_priority_group_bandwidth
-                                                        (NMSettingDcb *setting,
-                                                         guint group_id,
-                                                         guint bandwidth_percent);
-

-These values are only valid when "priority-group-flags" includes -the NM_SETTING_DCB_FLAG_ENABLE flag. -

-
+

nm_setting_dcb_get_priority_strict_bandwidth ()

+
gboolean
+nm_setting_dcb_get_priority_strict_bandwidth
+                               (NMSettingDcb *setting,
+                                guint user_priority);
+
+

Parameters

+
--+++ - - - - - - + + + - - + + +

setting :

the NMSettingDcb -

group_id :

the priority group (0 - 7) to set the bandwidth percentage for

setting

the NMSettingDcb

 

bandwidth_percent :

the bandwidth percentage (0 - 100) to assign to group_id to

user_priority

the User Priority (0 - 7) to retrieve strict bandwidth for

 
+
+
+

Returns

+

TRUE if user_priority +may use all of the bandwidth allocated to its +assigned group, or FALSE if not. These values are only valid when +“priority-group-flags” includes the NM_SETTING_DCB_FLAG_ENABLE flag.

+

+

Since 0.9.10


-

nm_setting_dcb_get_priority_bandwidth ()

-
guint               nm_setting_dcb_get_priority_bandwidth
-                                                        (NMSettingDcb *setting,
-                                                         guint user_priority);
-
+

nm_setting_dcb_set_priority_strict_bandwidth ()

+
void
+nm_setting_dcb_set_priority_strict_bandwidth
+                               (NMSettingDcb *setting,
+                                guint user_priority,
+                                gboolean strict);
+

These values are only valid when “priority-group-flags” includes +the NM_SETTING_DCB_FLAG_ENABLE flag.

+
+

Parameters

+
--+++ - - + + + - - + + + - - + + +

setting :

the NMSettingDcb -

setting

the NMSettingDcb

 

user_priority :

the User Priority (0 - 7) to retrieve the group bandwidth percentage for

user_priority

the User Priority (0 - 7) to set strict bandwidth for

 

Returns :

the allowed bandwidth percentage of user_priority in its priority group. -These values are only valid when "priority-group-flags" includes the -NM_SETTING_DCB_FLAG_ENABLE flag.

strict

TRUE to allow user_priority +to use all the bandwidth allocated to +its priority group, or FALSE if not

 
+

Since 0.9.10


-

nm_setting_dcb_set_priority_bandwidth ()

-
void                nm_setting_dcb_set_priority_bandwidth
-                                                        (NMSettingDcb *setting,
-                                                         guint user_priority,
-                                                         guint bandwidth_percent);
-

-These values are only valid when "priority-group-flags" includes -the NM_SETTING_DCB_FLAG_ENABLE flag. -

-
+

nm_setting_dcb_get_priority_traffic_class ()

+
guint
+nm_setting_dcb_get_priority_traffic_class
+                               (NMSettingDcb *setting,
+                                guint user_priority);
+
+

Parameters

+
--+++ - - - - - - + + + - - + + +

setting :

the NMSettingDcb -

user_priority :

the User Priority (0 - 7) to set the bandwidth percentage for

setting

the NMSettingDcb

 

bandwidth_percent :

the bandwidth percentage (0 - 100) that user_priority is -allowed to use within its priority group

user_priority

the User Priority (0 - 7) to retrieve the traffic class for

 
+
+
+

Returns

+

the traffic class assigned to user_priority +. These values are only +valid when “priority-group-flags” includes the +NM_SETTING_DCB_FLAG_ENABLE flag.

+

+

Since 0.9.10


-

nm_setting_dcb_get_priority_strict_bandwidth ()

-
gboolean            nm_setting_dcb_get_priority_strict_bandwidth
-                                                        (NMSettingDcb *setting,
-                                                         guint user_priority);
-
+

nm_setting_dcb_set_priority_traffic_class ()

+
void
+nm_setting_dcb_set_priority_traffic_class
+                               (NMSettingDcb *setting,
+                                guint user_priority,
+                                guint traffic_class);
+

+

+ + +
+

Types and Values

+
+

NM_SETTING_DCB_SETTING_NAME

+
#define NM_SETTING_DCB_SETTING_NAME "dcb"
+
+

+

+
+
+
+

enum NMSettingDcbError

+
+

Members

+
--+++ - - + + - - + + + - - + + +

setting :

the NMSettingDcb +

NM_SETTING_DCB_ERROR_UNKNOWN

+

unknown or unclassified error

 

user_priority :

the User Priority (0 - 7) to retrieve strict bandwidth for

NM_SETTING_DCB_ERROR_INVALID_PROPERTY

+

the property was invalid

+
 

Returns :

-TRUE if user_priority may use all of the bandwidth allocated to its -assigned group, or FALSE if not. These values are only valid when -"priority-group-flags" includes the NM_SETTING_DCB_FLAG_ENABLE flag.

NM_SETTING_DCB_ERROR_MISSING_PROPERTY

+

the property was missing and is +required

+
 
-

Since 0.9.10

+

-

nm_setting_dcb_set_priority_strict_bandwidth ()

-
void                nm_setting_dcb_set_priority_strict_bandwidth
-                                                        (NMSettingDcb *setting,
-                                                         guint user_priority,
-                                                         gboolean strict);
+

NM_SETTING_DCB_ERROR

+
#define NM_SETTING_DCB_ERROR nm_setting_dcb_error_quark ()
+

-These values are only valid when "priority-group-flags" includes -the NM_SETTING_DCB_FLAG_ENABLE flag.

-
+ +
+
+

enum NMSettingDcbFlags

+

DCB feature flags.

+
+

Members

+
--+++ - - + + + + + + + - - + + + - - + + +

setting :

the NMSettingDcb +

NM_SETTING_DCB_FLAG_NONE

+

no flag

+
 

NM_SETTING_DCB_FLAG_ENABLE

+

the feature is enabled

 

user_priority :

the User Priority (0 - 7) to set strict bandwidth for

NM_SETTING_DCB_FLAG_ADVERTISE

+

the feature is advertised

+
 

strict :

-TRUE to allow user_priority to use all the bandwidth allocated to -its priority group, or FALSE if not

NM_SETTING_DCB_FLAG_WILLING

+

the feature is willing to change based on +peer configuration advertisements

+
 
+

Since 0.9.10


-

nm_setting_dcb_get_priority_traffic_class ()

-
guint               nm_setting_dcb_get_priority_traffic_class
-                                                        (NMSettingDcb *setting,
-                                                         guint user_priority);
-
---- - - - - - - - - - - - - - - -

setting :

the NMSettingDcb -

user_priority :

the User Priority (0 - 7) to retrieve the traffic class for

Returns :

the traffic class assigned to user_priority. These values are only -valid when "priority-group-flags" includes the -NM_SETTING_DCB_FLAG_ENABLE flag.
+

NM_SETTING_DCB_FCOE_MODE_FABRIC

+
#define NM_SETTING_DCB_FCOE_MODE_FABRIC  "fabric"
+
+

Indicates that the FCoE controller should use "fabric" mode (default)

Since 0.9.10


-

nm_setting_dcb_set_priority_traffic_class ()

-
void                nm_setting_dcb_set_priority_traffic_class
-                                                        (NMSettingDcb *setting,
-                                                         guint user_priority,
-                                                         guint traffic_class);
+

NM_SETTING_DCB_FCOE_MODE_VN2VN

+
#define NM_SETTING_DCB_FCOE_MODE_VN2VN   "vn2vn"
+
+

Indicates that the FCoE controller should use "VN2VN" mode.

+

Since 0.9.10

+
+
+
+

NM_SETTING_DCB_APP_FCOE_FLAGS

+
#define NM_SETTING_DCB_APP_FCOE_FLAGS         "app-fcoe-flags"
+

+
+
+

NM_SETTING_DCB_APP_FCOE_PRIORITY

+
#define NM_SETTING_DCB_APP_FCOE_PRIORITY      "app-fcoe-priority"
+
+

+

-
-

Property Details

+
+
+

NM_SETTING_DCB_APP_FCOE_MODE

+
#define NM_SETTING_DCB_APP_FCOE_MODE          "app-fcoe-mode"
+
+

+

+
+
+
+

NM_SETTING_DCB_APP_ISCSI_FLAGS

+
#define NM_SETTING_DCB_APP_ISCSI_FLAGS        "app-iscsi-flags"
+
+

+

+
+
+
+

NM_SETTING_DCB_APP_ISCSI_PRIORITY

+
#define NM_SETTING_DCB_APP_ISCSI_PRIORITY     "app-iscsi-priority"
+
+

+

+
+
+
+

NM_SETTING_DCB_APP_FIP_FLAGS

+
#define NM_SETTING_DCB_APP_FIP_FLAGS          "app-fip-flags"
+
+

+

+
+
+
+

NM_SETTING_DCB_APP_FIP_PRIORITY

+
#define NM_SETTING_DCB_APP_FIP_PRIORITY       "app-fip-priority"
+
+

+

+
+
+
+

NM_SETTING_DCB_PRIORITY_FLOW_CONTROL_FLAGS

+
#define NM_SETTING_DCB_PRIORITY_FLOW_CONTROL_FLAGS  "priority-flow-control-flags"
+
+

+

+
+
+
+

NM_SETTING_DCB_PRIORITY_FLOW_CONTROL

+
#define NM_SETTING_DCB_PRIORITY_FLOW_CONTROL        "priority-flow-control"
+
+

+

+
+
+
+

NM_SETTING_DCB_PRIORITY_GROUP_FLAGS

+
#define NM_SETTING_DCB_PRIORITY_GROUP_FLAGS      "priority-group-flags"
+
+

+

+
+
+
+

NM_SETTING_DCB_PRIORITY_GROUP_ID

+
#define NM_SETTING_DCB_PRIORITY_GROUP_ID         "priority-group-id"
+
+

+

+
+
+
+

NM_SETTING_DCB_PRIORITY_GROUP_BANDWIDTH

+
#define NM_SETTING_DCB_PRIORITY_GROUP_BANDWIDTH  "priority-group-bandwidth"
+
+

+

+
+
+
+

NM_SETTING_DCB_PRIORITY_BANDWIDTH

+
#define NM_SETTING_DCB_PRIORITY_BANDWIDTH        "priority-bandwidth"
+
+

+

+
+
+
+

NM_SETTING_DCB_PRIORITY_STRICT_BANDWIDTH

+
#define NM_SETTING_DCB_PRIORITY_STRICT_BANDWIDTH "priority-strict-bandwidth"
+
+

+

+
+
-

The "app-fcoe-flags" property

-
  "app-fcoe-flags"           guint                 : Read / Write
+

NM_SETTING_DCB_PRIORITY_TRAFFIC_CLASS

+
#define NM_SETTING_DCB_PRIORITY_TRAFFIC_CLASS    "priority-traffic-class"
+

-Specifies the NMSettingDcbFlags for the DCB FCoE application. Flags may -be any combination of NM_SETTING_DCB_FLAG_ENABLE, -NM_SETTING_DCB_FLAG_ADVERTISE, and NM_SETTING_DCB_FLAG_WILLING.

+
+
+
+

Property Details

+
+

The “app-fcoe-flags” property

+
  “app-fcoe-flags”           guint
+

+

Flags: Read / Write

Allowed values: <= 7

Default value: 0

Since 0.9.10


-

The "app-fcoe-mode" property

-
  "app-fcoe-mode"            gchar*                : Read / Write / Construct
-

-The FCoE controller mode; either NM_SETTING_DCB_FCOE_MODE_FABRIC -(default) or NM_SETTING_DCB_FCOE_MODE_VN2VN. -

+

The “app-fcoe-mode” property

+
  “app-fcoe-mode”            gchar *
+

+

Flags: Read / Write / Construct

Default value: "fabric"

Since 0.9.10


-

The "app-fcoe-priority" property

-
  "app-fcoe-priority"        gint                  : Read / Write / Construct
-

-The highest User Priority (0 - 7) which FCoE frames should use, or -1 for -default priority. Only used when the "app-fcoe-flags" -property includes the NM_SETTING_DCB_FLAG_ENABLE flag. -

+

The “app-fcoe-priority” property

+
  “app-fcoe-priority”        gint
+

+

Flags: Read / Write / Construct

Allowed values: [-1,7]

Default value: -1

Since 0.9.10


-

The "app-fip-flags" property

-
  "app-fip-flags"            guint                 : Read / Write
-

-Specifies the NMSettingDcbFlags for the DCB FIP application. Flags may -be any combination of NM_SETTING_DCB_FLAG_ENABLE, -NM_SETTING_DCB_FLAG_ADVERTISE, and NM_SETTING_DCB_FLAG_WILLING. -

+

The “app-fip-flags” property

+
  “app-fip-flags”            guint
+

+

Flags: Read / Write

Allowed values: <= 7

Default value: 0

Since 0.9.10


-

The "app-fip-priority" property

-
  "app-fip-priority"         gint                  : Read / Write / Construct
-

-The highest User Priority (0 - 7) which FIP frames should use, or -1 for -default priority. Only used when the "app-fip-flags" -property includes the NM_SETTING_DCB_FLAG_ENABLE flag. -

+

The “app-fip-priority” property

+
  “app-fip-priority”         gint
+

+

Flags: Read / Write / Construct

Allowed values: [-1,7]

Default value: -1

Since 0.9.10


-

The "app-iscsi-flags" property

-
  "app-iscsi-flags"          guint                 : Read / Write
-

-Specifies the NMSettingDcbFlags for the DCB iSCSI application. Flags -may be any combination of NM_SETTING_DCB_FLAG_ENABLE, -NM_SETTING_DCB_FLAG_ADVERTISE, and NM_SETTING_DCB_FLAG_WILLING. -

+

The “app-iscsi-flags” property

+
  “app-iscsi-flags”          guint
+

+

Flags: Read / Write

Allowed values: <= 7

Default value: 0

Since 0.9.10


-

The "app-iscsi-priority" property

-
  "app-iscsi-priority"       gint                  : Read / Write / Construct
-

-The highest User Priority (0 - 7) which iSCSI frames should use, or -1 -for default priority. Only used when the "app-iscsi-flags" -property includes the NM_SETTING_DCB_FLAG_ENABLE flag. -

+

The “app-iscsi-priority” property

+
  “app-iscsi-priority”       gint
+

+

Flags: Read / Write / Construct

Allowed values: [-1,7]

Default value: -1

Since 0.9.10


-

The "priority-bandwidth" property

-
  "priority-bandwidth"       GArray_guint_*        : Read / Write
-

-An array of 8 uint values, where the array index corresponds to the User -Priority (0 - 7) and the value indicates the percentage of bandwidth of -the priority's assigned group that the priority may use. The sum of all -percentages for priorities which belong to the same group must total 100 -percent. -

+

The “priority-bandwidth” property

+
  “priority-bandwidth”       GArray_guint_ *
+

+

Flags: Read / Write

Since 0.9.10


-

The "priority-flow-control" property

-
  "priority-flow-control"    GArray_guint_*        : Read / Write
-

-An array of 8 uint values, where the array index corresponds to the User -Priority (0 - 7) and the value indicates whether or not the corresponding -priority should transmit priority pause. Allowed values are 0 (do not -transmit pause) and 1 (transmit pause). -

+

The “priority-flow-control” property

+
  “priority-flow-control”    GArray_guint_ *
+

+

Flags: Read / Write

Since 0.9.10


-

The "priority-flow-control-flags" property

-
  "priority-flow-control-flags" guint                 : Read / Write
-

-Specifies the NMSettingDcbFlags for DCB Priority Flow Control (PFC). -Flags may be any combination of NM_SETTING_DCB_FLAG_ENABLE, -NM_SETTING_DCB_FLAG_ADVERTISE, and NM_SETTING_DCB_FLAG_WILLING. -

+

The “priority-flow-control-flags” property

+
  “priority-flow-control-flags” guint
+

+

Flags: Read / Write

Allowed values: <= 7

Default value: 0

Since 0.9.10


-

The "priority-group-bandwidth" property

-
  "priority-group-bandwidth" GArray_guint_*        : Read / Write
-

-An array of 8 uint values, where the array index corresponds to the -Priority Group ID (0 - 7) and the value indicates the percentage of link -bandwidth allocated to that group. Allowed values are 0 - 100, and the -sum of all values must total 100 percent. -

+

The “priority-group-bandwidth” property

+
  “priority-group-bandwidth” GArray_guint_ *
+

+

Flags: Read / Write

Since 0.9.10


-

The "priority-group-flags" property

-
  "priority-group-flags"     guint                 : Read / Write
-

-Specifies the NMSettingDcbFlags for DCB Priority Groups. Flags may be -any combination of NM_SETTING_DCB_FLAG_ENABLE, -NM_SETTING_DCB_FLAG_ADVERTISE, and NM_SETTING_DCB_FLAG_WILLING. -

+

The “priority-group-flags” property

+
  “priority-group-flags”     guint
+

+

Flags: Read / Write

Allowed values: <= 7

Default value: 0

Since 0.9.10


-

The "priority-group-id" property

-
  "priority-group-id"        GArray_guint_*        : Read / Write
-

-An array of 8 uint values, where the array index corresponds to the User -Priority (0 - 7) and the value indicates the Priority Group ID. Allowed -Priority Group ID values are 0 - 7 or 15 for the unrestricted group. -

+

The “priority-group-id” property

+
  “priority-group-id”        GArray_guint_ *
+

+

Flags: Read / Write

Since 0.9.10


-

The "priority-strict-bandwidth" property

-
  "priority-strict-bandwidth" GArray_guint_*        : Read / Write
-

-An array of 8 uint values, where the array index corresponds to the User -Priority (0 - 7) and the value indicates whether or not the priority may -use all of the bandwidth allocated to its assigned group. Allowed values -are 0 (the priority may not utilize all bandwidth) or 1 (the priority may -utilize all bandwidth). -

+

The “priority-strict-bandwidth” property

+
  “priority-strict-bandwidth” GArray_guint_ *
+

+

Flags: Read / Write

Since 0.9.10


-

The "priority-traffic-class" property

-
  "priority-traffic-class"   GArray_guint_*        : Read / Write
-

-An array of 8 uint values, where the array index corresponds to the User -Priority (0 - 7) and the value indicates the traffic class (0 - 7) to -which the priority is mapped. -

+

The “priority-traffic-class” property

+
  “priority-traffic-class”   GArray_guint_ *
+

+

Flags: Read / Write

Since 0.9.10

+ Generated by GTK-Doc V1.21 \ No newline at end of file diff --git a/docs/libnm-util/html/NMSettingGeneric.html b/docs/libnm-util/html/NMSettingGeneric.html index 9a758659..d7f571b1 100644 --- a/docs/libnm-util/html/NMSettingGeneric.html +++ b/docs/libnm-util/html/NMSettingGeneric.html @@ -2,32 +2,27 @@ -NMSettingGeneric +libnm-util Reference Manual: NMSettingGeneric - + - - - - - - - - - - + + + + + + +
@@ -35,48 +30,110 @@

NMSettingGeneric

NMSettingGeneric — Describes connection properties for generic devices

- +
-
-

Synopsis

-
-#include <nm-setting-generic.h>
-
-#define             NM_SETTING_GENERIC_SETTING_NAME
-enum                NMSettingGenericError;
-#define             NM_SETTING_GENERIC_ERROR
-GQuark              nm_setting_generic_error_quark      (void);
-                    NMSettingGeneric;
-                    NMSettingGenericClass;
-NMSetting *         nm_setting_generic_new              (void);
-
+
+

Functions

+
++++ + + + + + + + + + + +
+GQuark + +nm_setting_generic_error_quark () +
+NMSetting * + +nm_setting_generic_new () +
+
+
+

Types and Values

+
++++ + + + + + + + + + + + + + + +
#defineNM_SETTING_GENERIC_SETTING_NAME
enumNMSettingGenericError
#defineNM_SETTING_GENERIC_ERROR

Object Hierarchy

-
-  GEnum
-   +----NMSettingGenericError
+
    GEnum
+    ╰── NMSettingGenericError
+    GObject
+    ╰── NMSetting
+        ╰── NMSettingGeneric
 
-
-  GObject
-   +----NMSetting
-         +----NMSettingGeneric
+
+
+

Includes

+
#include <nm-setting-generic.h>
 

Description

-

-The NMSettingGeneric object is a NMSetting subclass that describes +

The NMSettingGeneric object is a NMSetting subclass that describes optional properties that apply to "generic" devices (ie, devices that -NetworkManager does not specifically recognize). -

-

-There are currently no properties on this object; it exists only to be -the "connection type" setting on NMConnections for generic devices. -

+NetworkManager does not specifically recognize).

+

There are currently no properties on this object; it exists only to be +the "connection type" setting on NMConnections for generic devices.

-

Details

+

Functions

+
+

nm_setting_generic_error_quark ()

+
GQuark
+nm_setting_generic_error_quark (void);
+

Registers an error quark for NMSettingGeneric if necessary.

+
+

Returns

+

the error quark used for NMSettingGeneric errors.

+

+
+

Since 0.9.10

+
+
+
+

nm_setting_generic_new ()

+
NMSetting *
+nm_setting_generic_new (void);
+

Creates a new NMSettingGeneric object with default values.

+
+

Returns

+

the new empty NMSettingGeneric object.

+

[transfer full]

+
+

Since 0.9.10

+
+
+
+

Types and Values

NM_SETTING_GENERIC_SETTING_NAME

#define NM_SETTING_GENERIC_SETTING_NAME "generic"
@@ -86,37 +143,41 @@ the "connection type" setting on 
 

-

enum NMSettingGenericError

-
typedef enum {
-	NM_SETTING_GENERIC_ERROR_UNKNOWN = 0,      /*< nick=UnknownError >*/
-	NM_SETTING_GENERIC_ERROR_INVALID_PROPERTY, /*< nick=InvalidProperty >*/
-	NM_SETTING_GENERIC_ERROR_MISSING_PROPERTY, /*< nick=MissingProperty >*/
-} NMSettingGenericError;
-
-
+

enum NMSettingGenericError

+
+

Members

+
--+++ - - + + - - + + - - + +

NM_SETTING_GENERIC_ERROR_UNKNOWN

unknown or unclassified error +

NM_SETTING_GENERIC_ERROR_UNKNOWN

+

unknown or unclassified error

 

NM_SETTING_GENERIC_ERROR_INVALID_PROPERTY

the property was invalid +

NM_SETTING_GENERIC_ERROR_INVALID_PROPERTY

+

the property was invalid

 

NM_SETTING_GENERIC_ERROR_MISSING_PROPERTY

the property was missing and -is required +

NM_SETTING_GENERIC_ERROR_MISSING_PROPERTY

+

the property was missing and +is required

 
+

Since 0.9.10


@@ -127,72 +188,10 @@ is required

-
-
-

nm_setting_generic_error_quark ()

-
GQuark              nm_setting_generic_error_quark      (void);
-

-Registers an error quark for NMSettingGeneric if necessary. -

-
---- - - - - -

Returns :

the error quark used for NMSettingGeneric errors.
-

Since 0.9.10

-
-
-
-

NMSettingGeneric

-
typedef struct _NMSettingGeneric NMSettingGeneric;
-

-

-
-
-
-

NMSettingGenericClass

-
typedef struct {
-	NMSettingClass parent;
-
-	/* Padding for future expansion */
-	void (*_reserved1) (void);
-	void (*_reserved2) (void);
-	void (*_reserved3) (void);
-	void (*_reserved4) (void);
-} NMSettingGenericClass;
-
-

-

-
-
-
-

nm_setting_generic_new ()

-
NMSetting *         nm_setting_generic_new              (void);
-

-Creates a new NMSettingGeneric object with default values. -

-
---- - - - - -

Returns :

the new empty NMSettingGeneric object. [transfer full] -
-

Since 0.9.10

-
+ Generated by GTK-Doc V1.21 \ No newline at end of file diff --git a/docs/libnm-util/html/NMSettingGsm.html b/docs/libnm-util/html/NMSettingGsm.html index a6b8ede7..39aa12d1 100644 --- a/docs/libnm-util/html/NMSettingGsm.html +++ b/docs/libnm-util/html/NMSettingGsm.html @@ -2,34 +2,28 @@ -NMSettingGsm +libnm-util Reference Manual: NMSettingGsm - + - - - - - - - - - - + + + + + + +
@@ -37,93 +31,624 @@

NMSettingGsm

NMSettingGsm — Describes GSM/3GPP-based mobile broadband properties

- +
-
-

Synopsis

-
-#include <nm-setting-gsm.h>
-
-#define             NM_SETTING_GSM_SETTING_NAME
-enum                NMSettingGsmError;
-#define             NM_SETTING_GSM_ERROR
-GQuark              nm_setting_gsm_error_quark          (void);
-#define             NM_SETTING_GSM_NUMBER
-#define             NM_SETTING_GSM_USERNAME
-#define             NM_SETTING_GSM_PASSWORD
-#define             NM_SETTING_GSM_PASSWORD_FLAGS
-#define             NM_SETTING_GSM_APN
-#define             NM_SETTING_GSM_NETWORK_ID
-#define             NM_SETTING_GSM_PIN
-#define             NM_SETTING_GSM_PIN_FLAGS
-#define             NM_SETTING_GSM_HOME_ONLY
-#define             NM_SETTING_GSM_ALLOWED_BANDS
-#define             NM_SETTING_GSM_NETWORK_TYPE
-enum                NMSettingGsmNetworkType;
-enum                NMSettingGsmNetworkBand;
-#define             NM_SETTING_GSM_BANDS_MAX
-                    NMSettingGsm;
-                    NMSettingGsmClass;
-NMSetting *         nm_setting_gsm_new                  (void);
-const char *        nm_setting_gsm_get_number           (NMSettingGsm *setting);
-const char *        nm_setting_gsm_get_username         (NMSettingGsm *setting);
-const char *        nm_setting_gsm_get_password         (NMSettingGsm *setting);
-const char *        nm_setting_gsm_get_apn              (NMSettingGsm *setting);
-const char *        nm_setting_gsm_get_network_id       (NMSettingGsm *setting);
-const char *        nm_setting_gsm_get_pin              (NMSettingGsm *setting);
-gboolean            nm_setting_gsm_get_home_only        (NMSettingGsm *setting);
-NMSettingSecretFlags nm_setting_gsm_get_pin_flags       (NMSettingGsm *setting);
-NMSettingSecretFlags nm_setting_gsm_get_password_flags  (NMSettingGsm *setting);
-int                 nm_setting_gsm_get_network_type     (NMSettingGsm *setting);
-guint32             nm_setting_gsm_get_allowed_bands    (NMSettingGsm *setting);
-
+
+

Functions

+
++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+GQuark + +nm_setting_gsm_error_quark () +
#defineNM_SETTING_GSM_BANDS_MAX
+NMSetting * + +nm_setting_gsm_new () +
const char * + +nm_setting_gsm_get_number () +
const char * + +nm_setting_gsm_get_username () +
const char * + +nm_setting_gsm_get_password () +
const char * + +nm_setting_gsm_get_apn () +
const char * + +nm_setting_gsm_get_network_id () +
const char * + +nm_setting_gsm_get_pin () +
+gboolean + +nm_setting_gsm_get_home_only () +
+NMSettingSecretFlags + +nm_setting_gsm_get_pin_flags () +
+NMSettingSecretFlags + +nm_setting_gsm_get_password_flags () +
+int + +nm_setting_gsm_get_network_type () +
+guint32 + +nm_setting_gsm_get_allowed_bands () +
+
+
+

Properties

+
+++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
guintallowed-bandsRead / Write / Construct
+gchar *apnRead / Write
gbooleanhome-onlyRead / Write
+gchar *network-idRead / Write
gintnetwork-typeRead / Write / Construct
+gchar *numberRead / Write
+gchar *passwordRead / Write
guintpassword-flagsRead / Write
+gchar *pinRead / Write
guintpin-flagsRead / Write
+gchar *usernameRead / Write
+
+
+

Types and Values

+

Object Hierarchy

-
-  GEnum
-   +----NMSettingGsmError
-
-
-  GEnum
-   +----NMSettingGsmNetworkType
-
-
-  GEnum
-   +----NMSettingGsmNetworkBand
-
-
-  GObject
-   +----NMSetting
-         +----NMSettingGsm
+
    GEnum
+    ├── NMSettingGsmError
+    ├── NMSettingGsmNetworkBand
+    ╰── NMSettingGsmNetworkType
+    GObject
+    ╰── NMSetting
+        ╰── NMSettingGsm
 
-

Properties

-
-  "allowed-bands"            guint                 : Read / Write / Construct
-  "apn"                      gchar*                : Read / Write
-  "home-only"                gboolean              : Read / Write
-  "network-id"               gchar*                : Read / Write
-  "network-type"             gint                  : Read / Write / Construct
-  "number"                   gchar*                : Read / Write
-  "password"                 gchar*                : Read / Write
-  "password-flags"           guint                 : Read / Write
-  "pin"                      gchar*                : Read / Write
-  "pin-flags"                guint                 : Read / Write
-  "username"                 gchar*                : Read / Write
+

Includes

+
#include <nm-setting-gsm.h>
 

Description

-

-The NMSettingGsm object is a NMSetting subclass that describes +

The NMSettingGsm object is a NMSetting subclass that describes properties that allow connections to 3GPP-based mobile broadband -networks, including those using GPRS/EDGE and UMTS/HSPA technology. -

+networks, including those using GPRS/EDGE and UMTS/HSPA technology.

+
+
+

Functions

+
+

nm_setting_gsm_error_quark ()

+
GQuark
+nm_setting_gsm_error_quark (void);
+

Registers an error quark for NMSettingGsm if necessary.

+
+

Returns

+

the error quark used for NMSettingGsm errors.

+

+
+
+
+
+

NM_SETTING_GSM_BANDS_MAX

+
#define             NM_SETTING_GSM_BANDS_MAX
+
+

NM_SETTING_GSM_BANDS_MAX has been deprecated since version 0.9.10 and should not be used in newly-written code.

+

No longer used.

+
+

NM_SETTING_GSM_BANDS_MAX macro indicate the maximal value that can be used +as the allowed frequency bands (“allowed-bands” property).

+
+
+
+

nm_setting_gsm_new ()

+
NMSetting *
+nm_setting_gsm_new (void);
+

Creates a new NMSettingGsm object with default values.

+
+

Returns

+

the new empty NMSettingGsm object

+

+
+
+
+
+

nm_setting_gsm_get_number ()

+
const char *
+nm_setting_gsm_get_number (NMSettingGsm *setting);
+
+

Parameters

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

setting

the NMSettingGsm

 
+
+
+

Returns

+

the “number” property of the setting

+

+
+
+
+
+

nm_setting_gsm_get_username ()

+
const char *
+nm_setting_gsm_get_username (NMSettingGsm *setting);
+
+

Parameters

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

setting

the NMSettingGsm

 
+
+
+

Returns

+

the “username” property of the setting

+

+
+
+
+
+

nm_setting_gsm_get_password ()

+
const char *
+nm_setting_gsm_get_password (NMSettingGsm *setting);
+
+

Parameters

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

setting

the NMSettingGsm

 
+
+
+

Returns

+

the “password” property of the setting

+

+
+
+
+
+

nm_setting_gsm_get_apn ()

+
const char *
+nm_setting_gsm_get_apn (NMSettingGsm *setting);
+
+

Parameters

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

setting

the NMSettingGsm

 
+
+
+

Returns

+

the “apn” property of the setting

+

+
+
+
+
+

nm_setting_gsm_get_network_id ()

+
const char *
+nm_setting_gsm_get_network_id (NMSettingGsm *setting);
+
+

Parameters

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

setting

the NMSettingGsm

 
+
+
+

Returns

+

the “network-id” property of the setting

+

+
+
+
+
+

nm_setting_gsm_get_pin ()

+
const char *
+nm_setting_gsm_get_pin (NMSettingGsm *setting);
+
+

Parameters

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

setting

the NMSettingGsm

 
+
+
+

Returns

+

the “pin” property of the setting

+

+
+
+
+
+

nm_setting_gsm_get_home_only ()

+
gboolean
+nm_setting_gsm_get_home_only (NMSettingGsm *setting);
+
+

Parameters

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

setting

the NMSettingGsm

 
+
+
+

Returns

+

the “home-only” property of the setting

+

+
+
+
+
+

nm_setting_gsm_get_pin_flags ()

+
NMSettingSecretFlags
+nm_setting_gsm_get_pin_flags (NMSettingGsm *setting);
+
+

Parameters

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

setting

the NMSettingGsm

 
+
+
+

Returns

+

the NMSettingSecretFlags pertaining to the “pin”

+

+
+
+
+
+

nm_setting_gsm_get_password_flags ()

+
NMSettingSecretFlags
+nm_setting_gsm_get_password_flags (NMSettingGsm *setting);
+
+

Parameters

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

setting

the NMSettingGsm

 
+
+
+

Returns

+

the NMSettingSecretFlags pertaining to the “password”

+

+
+
+
+
+

nm_setting_gsm_get_network_type ()

+
int
+nm_setting_gsm_get_network_type (NMSettingGsm *setting);
+
+

nm_setting_gsm_get_network_type has been deprecated since version 0.9.10 and should not be used in newly-written code.

+

No longer used. Network type setting should be done talking to ModemManager directly.

+
+
+

Parameters

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

setting

the NMSettingGsm

 
+
+
+

Returns

+

the “network-type” property of the setting

+

+
+
+
+
+

nm_setting_gsm_get_allowed_bands ()

+
guint32
+nm_setting_gsm_get_allowed_bands (NMSettingGsm *setting);
+
+

nm_setting_gsm_get_allowed_bands has been deprecated since version 0.9.10 and should not be used in newly-written code.

+

No longer used. Bands setting should be done talking to ModemManager directly.

+
+
+

Parameters

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

setting

the NMSettingGsm

 
+
+
+

Returns

+

the “allowed-bands” property of the setting

+

+
+
-

Details

+

Types and Values

NM_SETTING_GSM_SETTING_NAME

#define NM_SETTING_GSM_SETTING_NAME "gsm"
@@ -133,45 +658,50 @@ networks, including those using GPRS/EDGE and UMTS/HSPA technology.
 

-

enum NMSettingGsmError

-
typedef enum {
-	NM_SETTING_GSM_ERROR_UNKNOWN = 0,           /*< nick=UnknownError >*/
-	NM_SETTING_GSM_ERROR_INVALID_PROPERTY,      /*< nick=InvalidProperty >*/
-	NM_SETTING_GSM_ERROR_MISSING_PROPERTY,      /*< nick=MissingProperty >*/
-	NM_SETTING_GSM_ERROR_MISSING_SERIAL_SETTING /*< nick=MissingSerialSetting >*/
-} NMSettingGsmError;
-
-
+

enum NMSettingGsmError

+
+

Members

+
--+++ - - + + - - + + - - + + - - + +

NM_SETTING_GSM_ERROR_UNKNOWN

unknown or unclassified error +

NM_SETTING_GSM_ERROR_UNKNOWN

+

unknown or unclassified error

 

NM_SETTING_GSM_ERROR_INVALID_PROPERTY

the property was invalid +

NM_SETTING_GSM_ERROR_INVALID_PROPERTY

+

the property was invalid

 

NM_SETTING_GSM_ERROR_MISSING_PROPERTY

the property was missing and is -required +

NM_SETTING_GSM_ERROR_MISSING_PROPERTY

+

the property was missing and is +required

 

NM_SETTING_GSM_ERROR_MISSING_SERIAL_SETTING

the required NMSettingSerial -is missing in the connection +

NM_SETTING_GSM_ERROR_MISSING_SERIAL_SETTING

+

the required NMSettingSerial +is missing in the connection

 
+

NM_SETTING_GSM_ERROR

@@ -182,24 +712,6 @@ is missing in the connection

-

nm_setting_gsm_error_quark ()

-
GQuark              nm_setting_gsm_error_quark          (void);
-

-Registers an error quark for NMSettingGsm if necessary. -

-
---- - - - - -

Returns :

the error quark used for NMSettingGsm errors.
-
-
-

NM_SETTING_GSM_NUMBER

#define NM_SETTING_GSM_NUMBER         "number"
 
@@ -288,643 +800,316 @@ Registers an error quark for -

enum NMSettingGsmNetworkType

-
typedef enum {
-	NM_SETTING_GSM_NETWORK_TYPE_ANY = -1,
-	NM_SETTING_GSM_NETWORK_TYPE_UMTS_HSPA = 0,
-	NM_SETTING_GSM_NETWORK_TYPE_GPRS_EDGE = 1,
-	NM_SETTING_GSM_NETWORK_TYPE_PREFER_UMTS_HSPA = 2,
-	NM_SETTING_GSM_NETWORK_TYPE_PREFER_GPRS_EDGE = 3,
-	NM_SETTING_GSM_NETWORK_TYPE_PREFER_4G = 4,
-	NM_SETTING_GSM_NETWORK_TYPE_4G = 5
-} NMSettingGsmNetworkType;
-
-
-

Warning

-

NMSettingGsmNetworkType has been deprecated since version 0.9.10 and should not be used in newly-written code. No longer used.

+

enum NMSettingGsmNetworkType

+
+

NMSettingGsmNetworkType has been deprecated since version 0.9.10 and should not be used in newly-written code.

+

No longer used.

-

-NMSettingGsmNetworkType values indicate the allowed access technologies -the device may use when connecting to this network. -

-
+

NMSettingGsmNetworkType values indicate the allowed access technologies +the device may use when connecting to this network.

+
+

Members

+
--+++ - - + + - - + + - - + + - - + + - - + + - - + + - - + +

NM_SETTING_GSM_NETWORK_TYPE_ANY

any access technology may be used +

NM_SETTING_GSM_NETWORK_TYPE_ANY

+

any access technology may be used

 

NM_SETTING_GSM_NETWORK_TYPE_UMTS_HSPA

only 3G-type (UMTS and HSPA) -technologies may be used +

NM_SETTING_GSM_NETWORK_TYPE_UMTS_HSPA

+

only 3G-type (UMTS and HSPA) +technologies may be used

 

NM_SETTING_GSM_NETWORK_TYPE_GPRS_EDGE

only 2G-type (GPRS and EDGE) -technologies may be used +

NM_SETTING_GSM_NETWORK_TYPE_GPRS_EDGE

+

only 2G-type (GPRS and EDGE) +technologies may be used

 

NM_SETTING_GSM_NETWORK_TYPE_PREFER_UMTS_HSPA

3G-type technologies are -preferred but 2G-type technologies may be used as a fallback +

NM_SETTING_GSM_NETWORK_TYPE_PREFER_UMTS_HSPA

+

3G-type technologies are +preferred but 2G-type technologies may be used as a fallback

 

NM_SETTING_GSM_NETWORK_TYPE_PREFER_GPRS_EDGE

2G-type technologies are -preferred but 3G-type technologies may be used as a fallback +

NM_SETTING_GSM_NETWORK_TYPE_PREFER_GPRS_EDGE

+

2G-type technologies are +preferred but 3G-type technologies may be used as a fallback

 

NM_SETTING_GSM_NETWORK_TYPE_PREFER_4G

4G/LTE-type technologies are -preferred but 3G/2/-type technologies may be used as a fallback +

NM_SETTING_GSM_NETWORK_TYPE_PREFER_4G

+

4G/LTE-type technologies are +preferred but 3G/2/-type technologies may be used as a fallback

 

NM_SETTING_GSM_NETWORK_TYPE_4G

only 4G/LTE type -technologies may be used +

NM_SETTING_GSM_NETWORK_TYPE_4G

+

only 4G/LTE type +technologies may be used

 
+

-

enum NMSettingGsmNetworkBand

-
typedef enum {
-	NM_SETTING_GSM_BAND_UNKNOWN      = 0x00000000,
-	NM_SETTING_GSM_BAND_ANY          = 0x00000001,
-	NM_SETTING_GSM_BAND_EGSM         = 0x00000002, /*  900 MHz */
-	NM_SETTING_GSM_BAND_DCS          = 0x00000004, /* 1800 MHz */
-	NM_SETTING_GSM_BAND_PCS          = 0x00000008, /* 1900 MHz */
-	NM_SETTING_GSM_BAND_G850         = 0x00000010, /*  850 MHz */
-	NM_SETTING_GSM_BAND_U2100        = 0x00000020, /* WCDMA 3GPP UMTS 2100 MHz     (Class I) */
-	NM_SETTING_GSM_BAND_U1800        = 0x00000040, /* WCDMA 3GPP UMTS 1800 MHz     (Class III) */
-	NM_SETTING_GSM_BAND_U17IV        = 0x00000080, /* WCDMA 3GPP AWS 1700/2100 MHz (Class IV) */
-	NM_SETTING_GSM_BAND_U800         = 0x00000100, /* WCDMA 3GPP UMTS 800 MHz      (Class VI) */
-	NM_SETTING_GSM_BAND_U850         = 0x00000200, /* WCDMA 3GPP UMTS 850 MHz      (Class V) */
-	NM_SETTING_GSM_BAND_U900         = 0x00000400, /* WCDMA 3GPP UMTS 900 MHz      (Class VIII) */
-	NM_SETTING_GSM_BAND_U17IX        = 0x00000800, /* WCDMA 3GPP UMTS 1700 MHz     (Class IX) */
-	NM_SETTING_GSM_BAND_U1900        = 0x00001000, /* WCDMA 3GPP UMTS 1900 MHz     (Class II) */
-	NM_SETTING_GSM_BAND_U2600        = 0x00002000, /* WCDMA 3GPP UMTS 2600 MHz     (Class VII, internal) */
-} NMSettingGsmNetworkBand;
-
-
-

Warning

-

NMSettingGsmNetworkBand has been deprecated since version 0.9.10 and should not be used in newly-written code. No longer used.

+

enum NMSettingGsmNetworkBand

+
+

NMSettingGsmNetworkBand has been deprecated since version 0.9.10 and should not be used in newly-written code.

+

No longer used.

-

-NMSettingGsmNetworkBand values indicate the allowed frequency bands -the device may use when connecting to this network. -

-
+

NMSettingGsmNetworkBand values indicate the allowed frequency bands +the device may use when connecting to this network.

+
+

Members

+
--+++ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + - - + + - - + + - -

NM_SETTING_GSM_BAND_UNKNOWN

unknown or no band specified -

NM_SETTING_GSM_BAND_ANY

any band is allowed -

NM_SETTING_GSM_BAND_EGSM

900 MHz original GSM band -

NM_SETTING_GSM_BAND_DCS

1800 MHz DCS band -

NM_SETTING_GSM_BAND_PCS

US 1900 MHz PCS band -

NM_SETTING_GSM_BAND_G850

US 850 MHz Cellular band -

NM_SETTING_GSM_BAND_U2100

WCDMA 3GPP UMTS 2100 MHz (Class I) -

NM_SETTING_GSM_BAND_U1800

WCDMA 3GPP UMTS 1800 MHz (Class III) -

NM_SETTING_GSM_BAND_U17IV

WCDMA 3GPP AWS 1700/2100 MHz (Class IV) -

NM_SETTING_GSM_BAND_U800

WCDMA 3GPP UMTS 800 MHz (Class VI) -

NM_SETTING_GSM_BAND_U850

WCDMA 3GPP UMTS 850 MHz (Class V) -

NM_SETTING_GSM_BAND_U900

WCDMA 3GPP UMTS 900 MHz (Class VIII) -

NM_SETTING_GSM_BAND_U17IX

WCDMA 3GPP UMTS 1700 MHz (Class IX) +

NM_SETTING_GSM_BAND_UNKNOWN

+

unknown or no band specified

 

NM_SETTING_GSM_BAND_U1900

WCDMA 3GPP UMTS 1900 MHz (Class II) +

NM_SETTING_GSM_BAND_ANY

+

any band is allowed

 

NM_SETTING_GSM_BAND_U2600

WCDMA 3GPP UMTS 2600 MHz (Class VII, internal) +

NM_SETTING_GSM_BAND_EGSM

+

900 MHz original GSM band

 
-
-
-
-

NM_SETTING_GSM_BANDS_MAX

-
#define             NM_SETTING_GSM_BANDS_MAX
-
-

Warning

-

NM_SETTING_GSM_BANDS_MAX has been deprecated since version 0.9.10 and should not be used in newly-written code. No longer used.

-
-

-NM_SETTING_GSM_BANDS_MAX macro indicate the maximal value that can be used -as the allowed frequency bands ("allowed-bands" property). -

-
-
-
-

NMSettingGsm

-
typedef struct _NMSettingGsm NMSettingGsm;
-

-

-
-
-
-

NMSettingGsmClass

-
typedef struct {
-	NMSettingClass parent;
-
-	/* Padding for future expansion */
-	void (*_reserved1) (void);
-	void (*_reserved2) (void);
-	void (*_reserved3) (void);
-	void (*_reserved4) (void);
-} NMSettingGsmClass;
-
-

-

-
-
-
-

nm_setting_gsm_new ()

-
NMSetting *         nm_setting_gsm_new                  (void);
-

-Creates a new NMSettingGsm object with default values. -

-
---- - - - - -

Returns :

the new empty NMSettingGsm object
-
-
-
-

nm_setting_gsm_get_number ()

-
const char *        nm_setting_gsm_get_number           (NMSettingGsm *setting);
-
---- - - - + + - - - - -

setting :

the NMSettingGsm +

NM_SETTING_GSM_BAND_DCS

+

1800 MHz DCS band

 

Returns :

the "number" property of the setting
-
-
-
-

nm_setting_gsm_get_username ()

-
const char *        nm_setting_gsm_get_username         (NMSettingGsm *setting);
-
---- - - - - + + - - - - -

setting :

the NMSettingGsm +

NM_SETTING_GSM_BAND_PCS

+

US 1900 MHz PCS band

 

Returns :

the "username" property of the setting
-
-
-
-

nm_setting_gsm_get_password ()

-
const char *        nm_setting_gsm_get_password         (NMSettingGsm *setting);
-
---- - - - - + + - - - - -

setting :

the NMSettingGsm +

NM_SETTING_GSM_BAND_G850

+

US 850 MHz Cellular band

 

Returns :

the "password" property of the setting
-
-
-
-

nm_setting_gsm_get_apn ()

-
const char *        nm_setting_gsm_get_apn              (NMSettingGsm *setting);
-
---- - - - - + + - - - - -

setting :

the NMSettingGsm +

NM_SETTING_GSM_BAND_U2100

+

WCDMA 3GPP UMTS 2100 MHz (Class I)

 

Returns :

the "apn" property of the setting
-
-
-
-

nm_setting_gsm_get_network_id ()

-
const char *        nm_setting_gsm_get_network_id       (NMSettingGsm *setting);
-
---- - - - - + + - - - - -

setting :

the NMSettingGsm +

NM_SETTING_GSM_BAND_U1800

+

WCDMA 3GPP UMTS 1800 MHz (Class III)

 

Returns :

the "network-id" property of the setting
-
-
-
-

nm_setting_gsm_get_pin ()

-
const char *        nm_setting_gsm_get_pin              (NMSettingGsm *setting);
-
---- - - - - + + - - - - -

setting :

the NMSettingGsm +

NM_SETTING_GSM_BAND_U17IV

+

WCDMA 3GPP AWS 1700/2100 MHz (Class IV)

 

Returns :

the "pin" property of the setting
-
-
-
-

nm_setting_gsm_get_home_only ()

-
gboolean            nm_setting_gsm_get_home_only        (NMSettingGsm *setting);
-
---- - - - - + + - - - - -

setting :

the NMSettingGsm +

NM_SETTING_GSM_BAND_U800

+

WCDMA 3GPP UMTS 800 MHz (Class VI)

 

Returns :

the "home-only" property of the setting
-
-
-
-

nm_setting_gsm_get_pin_flags ()

-
NMSettingSecretFlags nm_setting_gsm_get_pin_flags       (NMSettingGsm *setting);
-
---- - - - - + + - - + + - -

setting :

the NMSettingGsm +

NM_SETTING_GSM_BAND_U850

+

WCDMA 3GPP UMTS 850 MHz (Class V)

 

Returns :

the NMSettingSecretFlags pertaining to the "pin" +

NM_SETTING_GSM_BAND_U900

+

WCDMA 3GPP UMTS 900 MHz (Class VIII)

 
-
-
-
-

nm_setting_gsm_get_password_flags ()

-
NMSettingSecretFlags nm_setting_gsm_get_password_flags  (NMSettingGsm *setting);
-
---- - - - + + - - + + - -

setting :

the NMSettingGsm +

NM_SETTING_GSM_BAND_U17IX

+

WCDMA 3GPP UMTS 1700 MHz (Class IX)

 

Returns :

the NMSettingSecretFlags pertaining to the "password" +

NM_SETTING_GSM_BAND_U1900

+

WCDMA 3GPP UMTS 1900 MHz (Class II)

 
-
-
-
-

nm_setting_gsm_get_network_type ()

-
int                 nm_setting_gsm_get_network_type     (NMSettingGsm *setting);
-
-

Warning

-

nm_setting_gsm_get_network_type has been deprecated since version 0.9.10 and should not be used in newly-written code. No longer used. Network type setting should be done talking to ModemManager directly.

-
-
---- - - - + - - - - +

setting :

the NMSettingGsm +

NM_SETTING_GSM_BAND_U2600

+

WCDMA 3GPP UMTS 2600 MHz (Class VII, internal)

Returns :

the "network-type" property of the setting 
-
-
-

nm_setting_gsm_get_allowed_bands ()

-
guint32             nm_setting_gsm_get_allowed_bands    (NMSettingGsm *setting);
-
-

Warning

-

nm_setting_gsm_get_allowed_bands has been deprecated since version 0.9.10 and should not be used in newly-written code. No longer used. Bands setting should be done talking to ModemManager directly.

-
-
---- - - - - - - - - - - -

setting :

the NMSettingGsm -

Returns :

the "allowed-bands" property of the setting

Property Details

-

The "allowed-bands" property

-
  "allowed-bands"            guint                 : Read / Write / Construct
-
-

Warning

-

NMSettingGsm:allowed-bands has been deprecated since version 0.9.10 and should not be used in newly-written code. No longer used. Band setting should be done by +

The “allowed-bands” property

+
  “allowed-bands”            guint
+

+
+

NMSettingGsm:allowed-bands has been deprecated since version 0.9.10 and should not be used in newly-written code.

+

No longer used. Band setting should be done by talking to ModemManager directly.

-

-Bitfield of allowed frequency bands. Note that not all devices allow -frequency band control. Permitted values are those specified by -NMSettingGsmNetworkBand. -

+

Flags: Read / Write / Construct

Allowed values: <= 16383

Default value: 1


-

The "apn" property

-
  "apn"                      gchar*                : Read / Write
-

-The GPRS Access Point Name specifying the APN used when establishing a -data session with the GSM-based network. The APN often determines how -the user will be billed for their network usage and whether the user has -access to the Internet or just a provider-specific walled-garden, so it -is important to use the correct APN for the user's mobile broadband plan. -The APN may only be composed of the characters a-z, 0-9, ., and - per GSM -03.60 Section 14.9. -

+

The “apn” property

+
  “apn”                      gchar *
+

+

Flags: Read / Write

Default value: NULL


-

The "home-only" property

-
  "home-only"                gboolean              : Read / Write
-

-When TRUE, only connections to the home network will be allowed. -Connections to roaming networks will not be made. -

+

The “home-only” property

+
  “home-only”                gboolean
+

+

Flags: Read / Write

Default value: FALSE


-

The "network-id" property

-
  "network-id"               gchar*                : Read / Write
-

-The Network ID (GSM LAI format, ie MCC-MNC) to force specific network -registration. If the Network ID is specified, NetworkManager will -attempt to force the device to register only on the specified network. -This can be used to ensure that the device does not roam when direct -roaming control of the device is not otherwise possible. -

+

The “network-id” property

+
  “network-id”               gchar *
+

+

Flags: Read / Write

Default value: NULL


-

The "network-type" property

-
  "network-type"             gint                  : Read / Write / Construct
-
-

Warning

-

NMSettingGsm:network-type has been deprecated since version 0.9.10 and should not be used in newly-written code. No longer used. Network type setting should be done +

The “network-type” property

+
  “network-type”             gint
+

+
+

NMSettingGsm:network-type has been deprecated since version 0.9.10 and should not be used in newly-written code.

+

No longer used. Network type setting should be done by talking to ModemManager directly.

-

-Network preference to force the device to only use specific network -technologies. The permitted values are NM_SETTING_GSM_NETWORK_TYPE_ANY, -NM_SETTING_GSM_NETWORK_TYPE_UMTS_HSPA, -NM_SETTING_GSM_NETWORK_TYPE_GPRS_EDGE, -NM_SETTING_GSM_NETWORK_TYPE_PREFER_UMTS_HSPA, -NM_SETTING_GSM_NETWORK_TYPE_PREFER_GPRS_EDGE, -NM_SETTING_GSM_NETWORK_TYPE_PREFER_4G, and -NM_SETTING_GSM_NETWORK_TYPE_4G. Note that not all devices allow network -preference control. -

+

Flags: Read / Write / Construct

Allowed values: [-1,5]

Default value: -1


-

The "number" property

-
  "number"                   gchar*                : Read / Write
-

-Number to dial when establishing a PPP data session with the GSM-based -mobile broadband network. Many modems do not require PPP for connections -to the mobile network and thus this property should be left blank, which -allows NetworkManager to select the appropriate settings automatically. -

+

The “number” property

+
  “number”                   gchar *
+

+

Flags: Read / Write

Default value: NULL


-

The "password" property

-
  "password"                 gchar*                : Read / Write
-

-The password used to authenticate with the network, if required. Many -providers do not require a password, or accept any password. But if a -password is required, it is specified here. -

+

The “password” property

+
  “password”                 gchar *
+

+

Flags: Read / Write

Default value: NULL


-

The "password-flags" property

-
  "password-flags"           guint                 : Read / Write
-

-Flags indicating how to handle the "password" property. -

+

The “password-flags” property

+
  “password-flags”           guint
+

+

Flags: Read / Write

Allowed values: <= 7

Default value: 0


-

The "pin" property

-
  "pin"                      gchar*                : Read / Write
-

-If the SIM is locked with a PIN it must be unlocked before any other -operations are requested. Specify the PIN here to allow operation of the -device. -

+

The “pin” property

+
  “pin”                      gchar *
+

+

Flags: Read / Write

Default value: NULL


-

The "pin-flags" property

-
  "pin-flags"                guint                 : Read / Write
-

-Flags indicating how to handle the "pin" property. -

+

The “pin-flags” property

+
  “pin-flags”                guint
+

+

Flags: Read / Write

Allowed values: <= 7

Default value: 0


-

The "username" property

-
  "username"                 gchar*                : Read / Write
-

-The username used to authenticate with the network, if required. Many -providers do not require a username, or accept any username. But if a -username is required, it is specified here. -

+

The “username” property

+
  “username”                 gchar *
+

+

Flags: Read / Write

Default value: NULL

+ Generated by GTK-Doc V1.21
\ No newline at end of file diff --git a/docs/libnm-util/html/NMSettingIP4Config.html b/docs/libnm-util/html/NMSettingIP4Config.html index 20a04ac1..c96dc86d 100644 --- a/docs/libnm-util/html/NMSettingIP4Config.html +++ b/docs/libnm-util/html/NMSettingIP4Config.html @@ -2,34 +2,28 @@ -NMSettingIP4Config +libnm-util Reference Manual: NMSettingIP4Config - + - - - - - - - - - - + + + + + + +
@@ -37,2152 +31,2700 @@

NMSettingIP4Config

NMSettingIP4Config — Describes IPv4 addressing, routing, and name service properties

- +
-
-

Synopsis

-
-#include <nm-setting-ip4-config.h>
-
-#define             NM_SETTING_IP4_CONFIG_SETTING_NAME
-enum                NMSettingIP4ConfigError;
-#define             NM_SETTING_IP4_CONFIG_ERROR
-GQuark              nm_setting_ip4_config_error_quark   (void);
-#define             NM_SETTING_IP4_CONFIG_METHOD
-#define             NM_SETTING_IP4_CONFIG_DNS
-#define             NM_SETTING_IP4_CONFIG_DNS_SEARCH
-#define             NM_SETTING_IP4_CONFIG_ADDRESSES
-#define             NM_SETTING_IP4_CONFIG_ROUTES
-#define             NM_SETTING_IP4_CONFIG_ROUTE_METRIC
-#define             NM_SETTING_IP4_CONFIG_IGNORE_AUTO_ROUTES
-#define             NM_SETTING_IP4_CONFIG_IGNORE_AUTO_DNS
-#define             NM_SETTING_IP4_CONFIG_DHCP_CLIENT_ID
-#define             NM_SETTING_IP4_CONFIG_DHCP_SEND_HOSTNAME
-#define             NM_SETTING_IP4_CONFIG_DHCP_HOSTNAME
-#define             NM_SETTING_IP4_CONFIG_NEVER_DEFAULT
-#define             NM_SETTING_IP4_CONFIG_MAY_FAIL
-#define             NM_SETTING_IP4_CONFIG_METHOD_AUTO
-#define             NM_SETTING_IP4_CONFIG_METHOD_LINK_LOCAL
-#define             NM_SETTING_IP4_CONFIG_METHOD_MANUAL
-#define             NM_SETTING_IP4_CONFIG_METHOD_SHARED
-#define             NM_SETTING_IP4_CONFIG_METHOD_DISABLED
-typedef             NMIP4Address;
-NMIP4Address *      nm_ip4_address_new                  (void);
-NMIP4Address *      nm_ip4_address_dup                  (NMIP4Address *source);
-void                nm_ip4_address_ref                  (NMIP4Address *address);
-void                nm_ip4_address_unref                (NMIP4Address *address);
-gboolean            nm_ip4_address_compare              (NMIP4Address *address,
-                                                         NMIP4Address *other);
-guint32             nm_ip4_address_get_address          (NMIP4Address *address);
-void                nm_ip4_address_set_address          (NMIP4Address *address,
-                                                         guint32 addr);
-guint32             nm_ip4_address_get_prefix           (NMIP4Address *address);
-void                nm_ip4_address_set_prefix           (NMIP4Address *address,
-                                                         guint32 prefix);
-guint32             nm_ip4_address_get_gateway          (NMIP4Address *address);
-void                nm_ip4_address_set_gateway          (NMIP4Address *address,
-                                                         guint32 gateway);
-typedef             NMIP4Route;
-NMIP4Route *        nm_ip4_route_new                    (void);
-NMIP4Route *        nm_ip4_route_dup                    (NMIP4Route *source);
-void                nm_ip4_route_ref                    (NMIP4Route *route);
-void                nm_ip4_route_unref                  (NMIP4Route *route);
-gboolean            nm_ip4_route_compare                (NMIP4Route *route,
-                                                         NMIP4Route *other);
-guint32             nm_ip4_route_get_dest               (NMIP4Route *route);
-void                nm_ip4_route_set_dest               (NMIP4Route *route,
-                                                         guint32 dest);
-guint32             nm_ip4_route_get_prefix             (NMIP4Route *route);
-void                nm_ip4_route_set_prefix             (NMIP4Route *route,
-                                                         guint32 prefix);
-guint32             nm_ip4_route_get_next_hop           (NMIP4Route *route);
-void                nm_ip4_route_set_next_hop           (NMIP4Route *route,
-                                                         guint32 next_hop);
-guint32             nm_ip4_route_get_metric             (NMIP4Route *route);
-void                nm_ip4_route_set_metric             (NMIP4Route *route,
-                                                         guint32 metric);
-                    NMSettingIP4Config;
-                    NMSettingIP4ConfigClass;
-NMSetting *         nm_setting_ip4_config_new           (void);
-const char *        nm_setting_ip4_config_get_method    (NMSettingIP4Config *setting);
-guint32             nm_setting_ip4_config_get_num_dns   (NMSettingIP4Config *setting);
-guint32             nm_setting_ip4_config_get_dns       (NMSettingIP4Config *setting,
-                                                         guint32 i);
-gboolean            nm_setting_ip4_config_add_dns       (NMSettingIP4Config *setting,
-                                                         guint32 dns);
-void                nm_setting_ip4_config_remove_dns    (NMSettingIP4Config *setting,
-                                                         guint32 i);
-gboolean            nm_setting_ip4_config_remove_dns_by_value
-                                                        (NMSettingIP4Config *setting,
-                                                         guint32 dns);
-void                nm_setting_ip4_config_clear_dns     (NMSettingIP4Config *setting);
-guint32             nm_setting_ip4_config_get_num_dns_searches
-                                                        (NMSettingIP4Config *setting);
-const char *        nm_setting_ip4_config_get_dns_search
-                                                        (NMSettingIP4Config *setting,
-                                                         guint32 i);
-gboolean            nm_setting_ip4_config_add_dns_search
-                                                        (NMSettingIP4Config *setting,
-                                                         const char *dns_search);
-void                nm_setting_ip4_config_remove_dns_search
-                                                        (NMSettingIP4Config *setting,
-                                                         guint32 i);
-gboolean            nm_setting_ip4_config_remove_dns_search_by_value
-                                                        (NMSettingIP4Config *setting,
-                                                         const char *dns_search);
-void                nm_setting_ip4_config_clear_dns_searches
-                                                        (NMSettingIP4Config *setting);
-guint32             nm_setting_ip4_config_get_num_addresses
-                                                        (NMSettingIP4Config *setting);
-NMIP4Address *      nm_setting_ip4_config_get_address   (NMSettingIP4Config *setting,
-                                                         guint32 i);
-gboolean            nm_setting_ip4_config_add_address   (NMSettingIP4Config *setting,
-                                                         NMIP4Address *address);
-void                nm_setting_ip4_config_remove_address
-                                                        (NMSettingIP4Config *setting,
-                                                         guint32 i);
-gboolean            nm_setting_ip4_config_remove_address_by_value
-                                                        (NMSettingIP4Config *setting,
-                                                         NMIP4Address *address);
-void                nm_setting_ip4_config_clear_addresses
-                                                        (NMSettingIP4Config *setting);
-guint32             nm_setting_ip4_config_get_num_routes
-                                                        (NMSettingIP4Config *setting);
-NMIP4Route *        nm_setting_ip4_config_get_route     (NMSettingIP4Config *setting,
-                                                         guint32 i);
-gboolean            nm_setting_ip4_config_add_route     (NMSettingIP4Config *setting,
-                                                         NMIP4Route *route);
-void                nm_setting_ip4_config_remove_route  (NMSettingIP4Config *setting,
-                                                         guint32 i);
-gboolean            nm_setting_ip4_config_remove_route_by_value
-                                                        (NMSettingIP4Config *setting,
-                                                         NMIP4Route *route);
-void                nm_setting_ip4_config_clear_routes  (NMSettingIP4Config *setting);
-gint64              nm_setting_ip4_config_get_route_metric
-                                                        (NMSettingIP4Config *setting);
-gboolean            nm_setting_ip4_config_get_ignore_auto_routes
-                                                        (NMSettingIP4Config *setting);
-gboolean            nm_setting_ip4_config_get_ignore_auto_dns
-                                                        (NMSettingIP4Config *setting);
-const char *        nm_setting_ip4_config_get_dhcp_client_id
-                                                        (NMSettingIP4Config *setting);
-gboolean            nm_setting_ip4_config_get_dhcp_send_hostname
-                                                        (NMSettingIP4Config *setting);
-const char *        nm_setting_ip4_config_get_dhcp_hostname
-                                                        (NMSettingIP4Config *setting);
-gboolean            nm_setting_ip4_config_get_never_default
-                                                        (NMSettingIP4Config *setting);
-gboolean            nm_setting_ip4_config_get_may_fail  (NMSettingIP4Config *setting);
-
-
-
-

Object Hierarchy

-
-  GEnum
-   +----NMSettingIP4ConfigError
-
-
-  GBoxed
-   +----NMIP4Address
-
-
-  GBoxed
-   +----NMIP4Route
-
-
-  GObject
-   +----NMSetting
-         +----NMSettingIP4Config
-
-
-

Properties

-
-  "addresses"                GPtrArray_GArray_guint__*  : Read / Write
-  "dhcp-client-id"           gchar*                : Read / Write
-  "dhcp-hostname"            gchar*                : Read / Write
-  "dhcp-send-hostname"       gboolean              : Read / Write / Construct
-  "dns"                      GArray_guint_*        : Read / Write
-  "dns-search"               GSList_gchararray_*   : Read / Write
-  "ignore-auto-dns"          gboolean              : Read / Write / Construct
-  "ignore-auto-routes"       gboolean              : Read / Write / Construct
-  "may-fail"                 gboolean              : Read / Write / Construct
-  "method"                   gchar*                : Read / Write
-  "never-default"            gboolean              : Read / Write / Construct
-  "route-metric"             gint64                : Read / Write / Construct
-  "routes"                   GPtrArray_GArray_guint__*  : Read / Write
-
-
-
-

Description

-

-The NMSettingIP4Config object is a NMSetting subclass that describes -properties related to IPv4 addressing, routing, and Domain Name Service -

-
-
-

Details

-
-

NM_SETTING_IP4_CONFIG_SETTING_NAME

-
#define NM_SETTING_IP4_CONFIG_SETTING_NAME "ipv4"
-
-

-

-
-
-
-

enum NMSettingIP4ConfigError

-
typedef enum {
-	NM_SETTING_IP4_CONFIG_ERROR_UNKNOWN = 0,           /*< nick=UnknownError >*/
-	NM_SETTING_IP4_CONFIG_ERROR_INVALID_PROPERTY,      /*< nick=InvalidProperty >*/
-	NM_SETTING_IP4_CONFIG_ERROR_MISSING_PROPERTY,      /*< nick=MissingProperty >*/
-	NM_SETTING_IP4_CONFIG_ERROR_NOT_ALLOWED_FOR_METHOD /*< nick=NotAllowedForMethod >*/
-} NMSettingIP4ConfigError;
-
-
+

Functions

+
--++ - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - - + - - + - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

NM_SETTING_IP4_CONFIG_ERROR_UNKNOWN

unknown or unclassified error + +GQuark + +nm_setting_ip4_config_error_quark () +
+NMIP4Address * + +nm_ip4_address_new () +
+NMIP4Address * + +nm_ip4_address_dup () +
+void + +nm_ip4_address_ref () +
+void + +nm_ip4_address_unref () +
+gboolean + +nm_ip4_address_compare () +
+guint32 + +nm_ip4_address_get_address () +
+void + +nm_ip4_address_set_address () +
+guint32 + +nm_ip4_address_get_prefix () +
+void + +nm_ip4_address_set_prefix () +
+guint32 + +nm_ip4_address_get_gateway () +
+void + +nm_ip4_address_set_gateway () +
+NMIP4Route * + +nm_ip4_route_new () +
+NMIP4Route * + +nm_ip4_route_dup () +
+void + +nm_ip4_route_ref () +
+void + +nm_ip4_route_unref () +
+gboolean + +nm_ip4_route_compare () +
+guint32 + +nm_ip4_route_get_dest () +
+void + +nm_ip4_route_set_dest () +
+guint32 + +nm_ip4_route_get_prefix () +
+void + +nm_ip4_route_set_prefix () +
+guint32 + +nm_ip4_route_get_next_hop () +
+void + +nm_ip4_route_set_next_hop () +
+guint32 + +nm_ip4_route_get_metric () +
+void + +nm_ip4_route_set_metric () +
+NMSetting * + +nm_setting_ip4_config_new () +
const char * + +nm_setting_ip4_config_get_method () +
+guint32 + +nm_setting_ip4_config_get_num_dns () +
+guint32 + +nm_setting_ip4_config_get_dns () +
+gboolean + +nm_setting_ip4_config_add_dns () +
+void + +nm_setting_ip4_config_remove_dns () +
+gboolean + +nm_setting_ip4_config_remove_dns_by_value () +
+void + +nm_setting_ip4_config_clear_dns () +
+guint32 + +nm_setting_ip4_config_get_num_dns_searches () +
const char * + +nm_setting_ip4_config_get_dns_search () +
+gboolean + +nm_setting_ip4_config_add_dns_search () +
+void + +nm_setting_ip4_config_remove_dns_search () +
+gboolean + +nm_setting_ip4_config_remove_dns_search_by_value () +
+void + +nm_setting_ip4_config_clear_dns_searches () +
+guint32 + +nm_setting_ip4_config_get_num_addresses () +
+NMIP4Address * + +nm_setting_ip4_config_get_address () +
+gboolean + +nm_setting_ip4_config_add_address () +
+void + +nm_setting_ip4_config_remove_address () +
+gboolean + +nm_setting_ip4_config_remove_address_by_value () +
+void + +nm_setting_ip4_config_clear_addresses () +
+guint32 + +nm_setting_ip4_config_get_num_routes () +
+NMIP4Route * + +nm_setting_ip4_config_get_route () +
+gboolean + +nm_setting_ip4_config_add_route () +
+void + +nm_setting_ip4_config_remove_route ()

NM_SETTING_IP4_CONFIG_ERROR_INVALID_PROPERTY

the property was invalid + +gboolean + +nm_setting_ip4_config_remove_route_by_value ()

NM_SETTING_IP4_CONFIG_ERROR_MISSING_PROPERTY

the property was missing and is -required + +void + +nm_setting_ip4_config_clear_routes ()

NM_SETTING_IP4_CONFIG_ERROR_NOT_ALLOWED_FOR_METHOD

the property's value is -not valid with the given IP4 method + +gint64 + +nm_setting_ip4_config_get_route_metric () +
+gboolean + +nm_setting_ip4_config_get_ignore_auto_routes () +
+gboolean + +nm_setting_ip4_config_get_ignore_auto_dns () +
const char * + +nm_setting_ip4_config_get_dhcp_client_id () +
+gboolean + +nm_setting_ip4_config_get_dhcp_send_hostname () +
const char * + +nm_setting_ip4_config_get_dhcp_hostname () +
+gboolean + +nm_setting_ip4_config_get_never_default () +
+gboolean + +nm_setting_ip4_config_get_may_fail ()
-
-
-

NM_SETTING_IP4_CONFIG_ERROR

-
#define NM_SETTING_IP4_CONFIG_ERROR nm_setting_ip4_config_error_quark ()
-
-

-

-
-
-
-

nm_setting_ip4_config_error_quark ()

-
GQuark              nm_setting_ip4_config_error_quark   (void);
-

-Registers an error quark for NMSettingIP4Config if necessary. -

-
+
+

Properties

+
--+++ - - - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Returns :

the error quark used for NMSettingIP4Config errors.
+GPtrArray_GArray_guint__ *addressesRead / Write
+gchar *dhcp-client-idRead / Write
+gchar *dhcp-hostnameRead / Write
gbooleandhcp-send-hostnameRead / Write / Construct
+GArray_guint_ *dnsRead / Write
+GSList_gchararray_ *dns-searchRead / Write
gbooleanignore-auto-dnsRead / Write / Construct
gbooleanignore-auto-routesRead / Write / Construct
gbooleanmay-failRead / Write / Construct
+gchar *methodRead / Write
gbooleannever-defaultRead / Write / Construct
gint64route-metricRead / Write / Construct
+GPtrArray_GArray_guint__ *routesRead / Write
-
-
-

NM_SETTING_IP4_CONFIG_METHOD

-
#define NM_SETTING_IP4_CONFIG_METHOD             "method"
-
-

-

-
-
-
-

NM_SETTING_IP4_CONFIG_DNS

-
#define NM_SETTING_IP4_CONFIG_DNS                "dns"
-
-

-

-
-
-
-

NM_SETTING_IP4_CONFIG_DNS_SEARCH

-
#define NM_SETTING_IP4_CONFIG_DNS_SEARCH         "dns-search"
-
-

-

-
-
-
-

NM_SETTING_IP4_CONFIG_ADDRESSES

-
#define NM_SETTING_IP4_CONFIG_ADDRESSES          "addresses"
-
-

-

-
-
-
-

NM_SETTING_IP4_CONFIG_ROUTES

-
#define NM_SETTING_IP4_CONFIG_ROUTES             "routes"
-
-

-

-
-
-
-

NM_SETTING_IP4_CONFIG_ROUTE_METRIC

-
#define NM_SETTING_IP4_CONFIG_ROUTE_METRIC       "route-metric"
-
-

-

-
-
-
-

NM_SETTING_IP4_CONFIG_IGNORE_AUTO_ROUTES

-
#define NM_SETTING_IP4_CONFIG_IGNORE_AUTO_ROUTES "ignore-auto-routes"
-
-

-

-
-
-
-

NM_SETTING_IP4_CONFIG_IGNORE_AUTO_DNS

-
#define NM_SETTING_IP4_CONFIG_IGNORE_AUTO_DNS    "ignore-auto-dns"
-
-

-

-
-
-
-

NM_SETTING_IP4_CONFIG_DHCP_CLIENT_ID

-
#define NM_SETTING_IP4_CONFIG_DHCP_CLIENT_ID     "dhcp-client-id"
-
-

-

-
-
-
-

NM_SETTING_IP4_CONFIG_DHCP_SEND_HOSTNAME

-
#define NM_SETTING_IP4_CONFIG_DHCP_SEND_HOSTNAME "dhcp-send-hostname"
-
-

-

+ -
-
-

NM_SETTING_IP4_CONFIG_DHCP_HOSTNAME

-
#define NM_SETTING_IP4_CONFIG_DHCP_HOSTNAME      "dhcp-hostname"
+
+

Object Hierarchy

+
    GBoxed
+    ├── NMIP4Address
+    ╰── NMIP4Route
+    GEnum
+    ╰── NMSettingIP4ConfigError
+    GObject
+    ╰── NMSetting
+        ╰── NMSettingIP4Config
 
-

-

-
-
-

NM_SETTING_IP4_CONFIG_NEVER_DEFAULT

-
#define NM_SETTING_IP4_CONFIG_NEVER_DEFAULT      "never-default"
+
+

Includes

+
#include <nm-setting-ip4-config.h>
 
-

-

-
-
-

NM_SETTING_IP4_CONFIG_MAY_FAIL

-
#define NM_SETTING_IP4_CONFIG_MAY_FAIL           "may-fail"
-
-

-

+
+

Description

+

The NMSettingIP4Config object is a NMSetting subclass that describes +properties related to IPv4 addressing, routing, and Domain Name Service

-
+
+

Functions

-

NM_SETTING_IP4_CONFIG_METHOD_AUTO

-
#define NM_SETTING_IP4_CONFIG_METHOD_AUTO       "auto"
-
-

-IPv4 configuration should be automatically determined via a method appropriate -for the hardware interface, ie DHCP or PPP or some other device-specific -manner. -

+

nm_setting_ip4_config_error_quark ()

+
GQuark
+nm_setting_ip4_config_error_quark (void);
+

Registers an error quark for NMSettingIP4Config if necessary.

+
+

Returns

+

the error quark used for NMSettingIP4Config errors.

+

-
-
-

NM_SETTING_IP4_CONFIG_METHOD_LINK_LOCAL

-
#define NM_SETTING_IP4_CONFIG_METHOD_LINK_LOCAL "link-local"
-
-

-IPv4 configuration should be automatically configured for link-local-only -operation. -


-

NM_SETTING_IP4_CONFIG_METHOD_MANUAL

-
#define NM_SETTING_IP4_CONFIG_METHOD_MANUAL     "manual"
-
-

-All necessary IPv4 configuration (addresses, prefix, DNS, etc) is specified -in the setting's properties. -

+

nm_ip4_address_new ()

+
NMIP4Address *
+nm_ip4_address_new (void);
+

Creates and returns a new NMIP4Address object.

+
+

Returns

+

the new empty NMIP4Address object.

+

[transfer full]

-
-
-

NM_SETTING_IP4_CONFIG_METHOD_SHARED

-
#define NM_SETTING_IP4_CONFIG_METHOD_SHARED     "shared"
-
-

-This connection specifies configuration that allows other computers to -connect through it to the default network (usually the Internet). The -connection's interface will be assigned a private address, and a DHCP server, -caching DNS server, and Network Address Translation (NAT) functionality will -be started on this connection's interface to allow other devices to connect -through that interface to the default network. -


-

NM_SETTING_IP4_CONFIG_METHOD_DISABLED

-
#define NM_SETTING_IP4_CONFIG_METHOD_DISABLED   "disabled"
-
-

-This connection does not use or require IPv4 address and it should be disabled. -

+

nm_ip4_address_dup ()

+
NMIP4Address *
+nm_ip4_address_dup (NMIP4Address *source);
+

Copies a given NMIP4Address object and returns the copy.

+
+

Parameters

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

source

the NMIP4Address object to copy

 
+
+
+

Returns

+

the copy of the given NMIP4Address copy.

+

[transfer full]

+

-

NMIP4Address

-
typedef struct NMIP4Address NMIP4Address;
-
-

-

+

nm_ip4_address_ref ()

+
void
+nm_ip4_address_ref (NMIP4Address *address);
+

Increases the reference count of the object.

+
+

Parameters

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

address

the NMIP4Address

 
+

-

nm_ip4_address_new ()

-
NMIP4Address *      nm_ip4_address_new                  (void);
-

-Creates and returns a new NMIP4Address object. -

-
+

nm_ip4_address_unref ()

+
void
+nm_ip4_address_unref (NMIP4Address *address);
+

Decreases the reference count of the object. If the reference count +reaches zero, the object will be destroyed.

+
+

Parameters

+
--+++ - - + + +

Returns :

the new empty NMIP4Address object. [transfer full] -

address

the NMIP4Address

 
+

-

nm_ip4_address_dup ()

-
NMIP4Address *      nm_ip4_address_dup                  (NMIP4Address *source);
-

-Copies a given NMIP4Address object and returns the copy. -

-
+

nm_ip4_address_compare ()

+
gboolean
+nm_ip4_address_compare (NMIP4Address *address,
+                        NMIP4Address *other);
+

Determines if two NMIP4Address objects contain the same values.

+
+

Parameters

+
--+++ - - + + + - - + + +

source :

the NMIP4Address object to copy

address

the NMIP4Address

 

Returns :

the copy of the given NMIP4Address copy. [transfer full] -

other

the NMIP4Address to compare address +to.

 
+
+

Returns

+

TRUE if the objects contain the same values, FALSE if they do not.

+

+
+

-

nm_ip4_address_ref ()

-
void                nm_ip4_address_ref                  (NMIP4Address *address);
-

-Increases the reference count of the object. -

-
+

nm_ip4_address_get_address ()

+
guint32
+nm_ip4_address_get_address (NMIP4Address *address);
+

Gets the IPv4 address property of this address object.

+
+

Parameters

+
--+++ - - + + +

address :

the NMIP4Address -

address

the NMIP4Address

 
+
+

Returns

+

the IPv4 address in network byte order

+

+
+

-

nm_ip4_address_unref ()

-
void                nm_ip4_address_unref                (NMIP4Address *address);
-

-Decreases the reference count of the object. If the reference count -reaches zero, the object will be destroyed. -

-
+

nm_ip4_address_set_address ()

+
void
+nm_ip4_address_set_address (NMIP4Address *address,
+                            guint32 addr);
+

Sets the IPv4 address property of this object.

+
+

Parameters

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

address

the NMIP4Address

 

addr

the IPv4 address in network byte order

 
+
+
+
+
+

nm_ip4_address_get_prefix ()

+
guint32
+nm_ip4_address_get_prefix (NMIP4Address *address);
+

Gets the IPv4 address prefix (ie "24" or "30" etc) property of this address +object.

+
+

Parameters

+
--+++ - - + + +

address :

the NMIP4Address -

address

the NMIP4Address

 
+
+

Returns

+

the IPv4 address prefix

+

+
+

-

nm_ip4_address_compare ()

-
gboolean            nm_ip4_address_compare              (NMIP4Address *address,
-                                                         NMIP4Address *other);
-

-Determines if two NMIP4Address objects contain the same values. -

-
+

nm_ip4_address_set_prefix ()

+
void
+nm_ip4_address_set_prefix (NMIP4Address *address,
+                           guint32 prefix);
+

Sets the IPv4 address prefix.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + +

address :

the NMIP4Address -

other :

the NMIP4Address to compare address to.

address

the NMIP4Address

 

Returns :

-TRUE if the objects contain the same values, FALSE if they do not.

prefix

the address prefix, a number between 1 and 32 inclusive

 
+

-

nm_ip4_address_get_address ()

-
guint32             nm_ip4_address_get_address          (NMIP4Address *address);
-

-Gets the IPv4 address property of this address object. -

-
+

nm_ip4_address_get_gateway ()

+
guint32
+nm_ip4_address_get_gateway (NMIP4Address *address);
+

Gets the IPv4 default gateway property of this address object.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

address :

the NMIP4Address -

Returns :

the IPv4 address in network byte order

address

the NMIP4Address

 
+
+

Returns

+

the IPv4 gateway address in network byte order

+

+
+

-

nm_ip4_address_set_address ()

-
void                nm_ip4_address_set_address          (NMIP4Address *address,
-                                                         guint32 addr);
-

-Sets the IPv4 address property of this object. -

-
+

nm_ip4_address_set_gateway ()

+
void
+nm_ip4_address_set_gateway (NMIP4Address *address,
+                            guint32 gateway);
+

Sets the IPv4 default gateway property of this address object.

+
+

Parameters

+
--+++ - - + + + - - + + +

address :

the NMIP4Address -

address

the NMIP4Address

 

addr :

the IPv4 address in network byte order

gateway

the IPv4 default gateway in network byte order

 
+

-

nm_ip4_address_get_prefix ()

-
guint32             nm_ip4_address_get_prefix           (NMIP4Address *address);
-

-Gets the IPv4 address prefix (ie "24" or "30" etc) property of this address -object. -

-
+

nm_ip4_route_new ()

+
NMIP4Route *
+nm_ip4_route_new (void);
+

Creates and returns a new NMIP4Route object.

+
+

Returns

+

the new empty NMIP4Route object.

+

[transfer full]

+
+ +
+
+

nm_ip4_route_dup ()

+
NMIP4Route *
+nm_ip4_route_dup (NMIP4Route *source);
+

Copies a given NMIP4Route object and returns the copy.

+
+

Parameters

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

source

the NMIP4Route object to copy

 
+
+
+

Returns

+

the copy of the given NMIP4Route copy.

+

[transfer full]

+
+
+
+
+

nm_ip4_route_ref ()

+
void
+nm_ip4_route_ref (NMIP4Route *route);
+

Increases the reference count of the object.

+
+

Parameters

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

route

the NMIP4Route

 
+
+
+
+
+

nm_ip4_route_unref ()

+
void
+nm_ip4_route_unref (NMIP4Route *route);
+

Decreases the reference count of the object. If the reference count +reaches zero, the object will be destroyed.

+
+

Parameters

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

route

the NMIP4Route

 
+
+
+
+
+

nm_ip4_route_compare ()

+
gboolean
+nm_ip4_route_compare (NMIP4Route *route,
+                      NMIP4Route *other);
+

Determines if two NMIP4Route objects contain the same values.

+
+

Parameters

+
--+++ - - + + + - - + + +

address :

the NMIP4Address -

route

the NMIP4Route

 

Returns :

the IPv4 address prefix

other

the NMIP4Route to compare route +to.

 
+
+

Returns

+

TRUE if the objects contain the same values, FALSE if they do not.

+

+
+

-

nm_ip4_address_set_prefix ()

-
void                nm_ip4_address_set_prefix           (NMIP4Address *address,
-                                                         guint32 prefix);
-

-Sets the IPv4 address prefix. -

-
+

nm_ip4_route_get_dest ()

+
guint32
+nm_ip4_route_get_dest (NMIP4Route *route);
+

Gets the IPv4 destination address property of this route object.

+
+

Parameters

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

route

the NMIP4Route

 
+
+
+

Returns

+

the IPv4 address in network byte order

+

+
+
+
+
+

nm_ip4_route_set_dest ()

+
void
+nm_ip4_route_set_dest (NMIP4Route *route,
+                       guint32 dest);
+

Sets the IPv4 destination address property of this route object.

+
+

Parameters

+
--+++ - - + + + - - + + +

address :

the NMIP4Address -

route

the NMIP4Route

 

prefix :

the address prefix, a number between 1 and 32 inclusive

dest

the destination address in network byte order

 
+

-

nm_ip4_address_get_gateway ()

-
guint32             nm_ip4_address_get_gateway          (NMIP4Address *address);
-

-Gets the IPv4 default gateway property of this address object. -

-
+

nm_ip4_route_get_prefix ()

+
guint32
+nm_ip4_route_get_prefix (NMIP4Route *route);
+

Gets the IPv4 prefix (ie "24" or "30" etc) of this route.

+
+

Parameters

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

route

the NMIP4Route

 
+
+
+

Returns

+

the IPv4 prefix

+

+
+
+
+
+

nm_ip4_route_set_prefix ()

+
void
+nm_ip4_route_set_prefix (NMIP4Route *route,
+                         guint32 prefix);
+

Sets the IPv4 prefix of this route.

+
+

Parameters

+
--+++ - - + + + - - + + +

address :

the NMIP4Address -

route

the NMIP4Route

 

Returns :

the IPv4 gateway address in network byte order

prefix

the prefix, a number between 1 and 32 inclusive

 
+

-

nm_ip4_address_set_gateway ()

-
void                nm_ip4_address_set_gateway          (NMIP4Address *address,
-                                                         guint32 gateway);
-

-Sets the IPv4 default gateway property of this address object. -

-
+

nm_ip4_route_get_next_hop ()

+
guint32
+nm_ip4_route_get_next_hop (NMIP4Route *route);
+

Gets the IPv4 address of the next hop of this route.

+
+

Parameters

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

route

the NMIP4Route

 
+
+
+

Returns

+

the IPv4 address in network byte order

+

+
+
+
+
+

nm_ip4_route_set_next_hop ()

+
void
+nm_ip4_route_set_next_hop (NMIP4Route *route,
+                           guint32 next_hop);
+

Sets the IPv4 address of the next hop of this route.

+
+

Parameters

+
--+++ - - + + + - - + + +

address :

the NMIP4Address -

route

the NMIP4Route

 

gateway :

the IPv4 default gateway in network byte order

next_hop

the IPv4 address of the next hop in network byte order

 
-
-
-

NMIP4Route

-
typedef struct NMIP4Route NMIP4Route;
-
-

-


-

nm_ip4_route_new ()

-
NMIP4Route *        nm_ip4_route_new                    (void);
-

-Creates and returns a new NMIP4Route object. -

-
+

nm_ip4_route_get_metric ()

+
guint32
+nm_ip4_route_get_metric (NMIP4Route *route);
+

Gets the route metric property of this route object; lower values indicate +"better" or more preferred routes.

+
+

Parameters

+
--+++ - - + + +

Returns :

the new empty NMIP4Route object. [transfer full] -

route

the NMIP4Route

 
+
+

Returns

+

the route metric

+

+
+

-

nm_ip4_route_dup ()

-
NMIP4Route *        nm_ip4_route_dup                    (NMIP4Route *source);
-

-Copies a given NMIP4Route object and returns the copy. -

-
+

nm_ip4_route_set_metric ()

+
void
+nm_ip4_route_set_metric (NMIP4Route *route,
+                         guint32 metric);
+

Sets the route metric property of this route object; lower values indicate +"better" or more preferred routes.

+
+

Parameters

+
--+++ - - + + + - - + + +

source :

the NMIP4Route object to copy

route

the NMIP4Route

 

Returns :

the copy of the given NMIP4Route copy. [transfer full] -

metric

the route metric

 
+
-

nm_ip4_route_ref ()

-
void                nm_ip4_route_ref                    (NMIP4Route *route);
-

-Increases the reference count of the object. -

-
---- - - - - -

route :

the NMIP4Route -
+

nm_setting_ip4_config_new ()

+
NMSetting *
+nm_setting_ip4_config_new (void);
+

Creates a new NMSettingIP4Config object with default values.

+
+

Returns

+

the new empty NMSettingIP4Config object.

+

[transfer full]

+

-

nm_ip4_route_unref ()

-
void                nm_ip4_route_unref                  (NMIP4Route *route);
-

-Decreases the reference count of the object. If the reference count -reaches zero, the object will be destroyed. -

-
+

nm_setting_ip4_config_get_method ()

+
const char *
+nm_setting_ip4_config_get_method (NMSettingIP4Config *setting);
+
+

Parameters

+
--+++ - - + + +

route :

the NMIP4Route -

setting

the NMSettingIP4Config

 
+
+

Returns

+

the “method” property of the setting

+

+
+
-

nm_ip4_route_compare ()

-
gboolean            nm_ip4_route_compare                (NMIP4Route *route,
-                                                         NMIP4Route *other);
-

-Determines if two NMIP4Route objects contain the same values. -

-
+

nm_setting_ip4_config_get_num_dns ()

+
guint32
+nm_setting_ip4_config_get_num_dns (NMSettingIP4Config *setting);
+
+

Parameters

+
--+++ - - - - - - - - - - - - - - + + + + +

route :

the NMIP4Route -

other :

the NMIP4Route to compare route to.

Returns :

-TRUE if the objects contain the same values, FALSE if they do not.

setting

the NMSettingIP4Config

 
+
+

Returns

+

the number of configured DNS servers

+

+
+
-

nm_ip4_route_get_dest ()

-
guint32             nm_ip4_route_get_dest               (NMIP4Route *route);
-

-Gets the IPv4 destination address property of this route object. -

-
+

nm_setting_ip4_config_get_dns ()

+
guint32
+nm_setting_ip4_config_get_dns (NMSettingIP4Config *setting,
+                               guint32 i);
+
+

Parameters

+
--+++ - - + + + - - + + +

route :

the NMIP4Route -

setting

the NMSettingIP4Config

 

Returns :

the IPv4 address in network byte order

i

index number of the DNS server to return

 
+
+

Returns

+

the IPv4 address (network byte order) of the DNS server at index +i +

+

+
+
-

nm_ip4_route_set_dest ()

-
void                nm_ip4_route_set_dest               (NMIP4Route *route,
-                                                         guint32 dest);
-

-Sets the IPv4 destination address property of this route object. -

-
+

nm_setting_ip4_config_add_dns ()

+
gboolean
+nm_setting_ip4_config_add_dns (NMSettingIP4Config *setting,
+                               guint32 dns);
+

Adds a new DNS server to the setting.

+
+

Parameters

+
--+++ - - + + + - - + + +

route :

the NMIP4Route -

setting

the NMSettingIP4Config

 

dest :

the destination address in network byte order

dns

the IPv4 address (network byte order) of the DNS server to add

 
+
+

Returns

+

TRUE if the DNS server was added; FALSE if the server was already +known

+

+
+
-

nm_ip4_route_get_prefix ()

-
guint32             nm_ip4_route_get_prefix             (NMIP4Route *route);
-

-Gets the IPv4 prefix (ie "24" or "30" etc) of this route. -

-
+

nm_setting_ip4_config_remove_dns ()

+
void
+nm_setting_ip4_config_remove_dns (NMSettingIP4Config *setting,
+                                  guint32 i);
+

Removes the DNS server at index i +.

+
+

Parameters

+
--+++ - - + + + - - + + +

route :

the NMIP4Route -

setting

the NMSettingIP4Config

 

Returns :

the IPv4 prefix

i

index number of the DNS server to remove

 
+
-

nm_ip4_route_set_prefix ()

-
void                nm_ip4_route_set_prefix             (NMIP4Route *route,
-                                                         guint32 prefix);
-

-Sets the IPv4 prefix of this route. -

-
+

nm_setting_ip4_config_remove_dns_by_value ()

+
gboolean
+nm_setting_ip4_config_remove_dns_by_value
+                               (NMSettingIP4Config *setting,
+                                guint32 dns);
+

Removes the DNS server dns +.

+
+

Parameters

+
--+++ - - + + + - - + + +

route :

the NMIP4Route -

setting

the NMSettingIP4Config

 

prefix :

the prefix, a number between 1 and 32 inclusive

dns

the DNS server to remove

 
+
+

Returns

+

TRUE if the DNS server was found and removed; FALSE if it was not. +domain was already known

+

+
+

Since 0.9.10

+
-

nm_ip4_route_get_next_hop ()

-
guint32             nm_ip4_route_get_next_hop           (NMIP4Route *route);
-

-Gets the IPv4 address of the next hop of this route. -

-
+

nm_setting_ip4_config_clear_dns ()

+
void
+nm_setting_ip4_config_clear_dns (NMSettingIP4Config *setting);
+

Removes all configured DNS servers.

+
+

Parameters

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

setting

the NMSettingIP4Config

 
+
+ +
+
+

nm_setting_ip4_config_get_num_dns_searches ()

+
guint32
+nm_setting_ip4_config_get_num_dns_searches
+                               (NMSettingIP4Config *setting);
+
+

Parameters

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

setting

the NMSettingIP4Config

 
+
+
+

Returns

+

the number of configured DNS search domains

+

+
+
+
+
+

nm_setting_ip4_config_get_dns_search ()

+
const char *
+nm_setting_ip4_config_get_dns_search (NMSettingIP4Config *setting,
+                                      guint32 i);
+
+

Parameters

+
--+++ - - + + + - - + + +

route :

the NMIP4Route -

setting

the NMSettingIP4Config

 

Returns :

the IPv4 address in network byte order

i

index number of the DNS search domain to return

 
+
+

Returns

+

the DNS search domain at index i +

+

+
+

-

nm_ip4_route_set_next_hop ()

-
void                nm_ip4_route_set_next_hop           (NMIP4Route *route,
-                                                         guint32 next_hop);
-

-Sets the IPv4 address of the next hop of this route. -

-
+

nm_setting_ip4_config_add_dns_search ()

+
gboolean
+nm_setting_ip4_config_add_dns_search (NMSettingIP4Config *setting,
+                                      const char *dns_search);
+

Adds a new DNS search domain to the setting.

+
+

Parameters

+
--+++ - - + + + - - + + +

route :

the NMIP4Route -

setting

the NMSettingIP4Config

 

next_hop :

the IPv4 address of the next hop in network byte order

dns_search

the search domain to add

 
+
+

Returns

+

TRUE if the DNS search domain was added; FALSE if the search +domain was already known

+

+
+
-

nm_ip4_route_get_metric ()

-
guint32             nm_ip4_route_get_metric             (NMIP4Route *route);
-

-Gets the route metric property of this route object; lower values indicate -"better" or more preferred routes. -

-
+

nm_setting_ip4_config_remove_dns_search ()

+
void
+nm_setting_ip4_config_remove_dns_search
+                               (NMSettingIP4Config *setting,
+                                guint32 i);
+

Removes the DNS search domain at index i +.

+
+

Parameters

+
--+++ - - + + + - - + + +

route :

the NMIP4Route -

setting

the NMSettingIP4Config

 

Returns :

the route metric

i

index number of the DNS search domain

 
+
-

nm_ip4_route_set_metric ()

-
void                nm_ip4_route_set_metric             (NMIP4Route *route,
-                                                         guint32 metric);
-

-Sets the route metric property of this route object; lower values indicate -"better" or more preferred routes. -

-
+

nm_setting_ip4_config_remove_dns_search_by_value ()

+
gboolean
+nm_setting_ip4_config_remove_dns_search_by_value
+                               (NMSettingIP4Config *setting,
+                                const char *dns_search);
+

Removes the DNS search domain dns_search +.

+
+

Parameters

+
--+++ - - + + + - - + + +

route :

the NMIP4Route -

setting

the NMSettingIP4Config

 

metric :

the route metric

dns_search

the search domain to remove

 
-
-
-

NMSettingIP4Config

-
typedef struct _NMSettingIP4Config NMSettingIP4Config;
-

-

+
+

Returns

+

TRUE if the DNS search domain was found and removed; FALSE if it was not.

+

Since 0.9.10

+

-
-
-

NMSettingIP4ConfigClass

-
typedef struct {
-	NMSettingClass parent;
-
-	/* Padding for future expansion */
-	void (*_reserved1) (void);
-	void (*_reserved2) (void);
-	void (*_reserved3) (void);
-	void (*_reserved4) (void);
-} NMSettingIP4ConfigClass;
-
-

-


-

nm_setting_ip4_config_new ()

-
NMSetting *         nm_setting_ip4_config_new           (void);
-

-Creates a new NMSettingIP4Config object with default values. -

-
+

nm_setting_ip4_config_clear_dns_searches ()

+
void
+nm_setting_ip4_config_clear_dns_searches
+                               (NMSettingIP4Config *setting);
+

Removes all configured DNS search domains.

+
+

Parameters

+
--+++ - - + + +

Returns :

the new empty NMSettingIP4Config object. [transfer full] -

setting

the NMSettingIP4Config

 
+

-

nm_setting_ip4_config_get_method ()

-
const char *        nm_setting_ip4_config_get_method    (NMSettingIP4Config *setting);
-
+

nm_setting_ip4_config_get_num_addresses ()

+
guint32
+nm_setting_ip4_config_get_num_addresses
+                               (NMSettingIP4Config *setting);
+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSettingIP4Config -

Returns :

the "method" property of the setting

setting

the NMSettingIP4Config

 
+
+

Returns

+

the number of configured addresses

+

+
+
-

nm_setting_ip4_config_get_num_dns ()

-
guint32             nm_setting_ip4_config_get_num_dns   (NMSettingIP4Config *setting);
-
+

nm_setting_ip4_config_get_address ()

+
NMIP4Address *
+nm_setting_ip4_config_get_address (NMSettingIP4Config *setting,
+                                   guint32 i);
+
+

Parameters

+
--+++ - - + + + - - + + +

setting :

the NMSettingIP4Config -

setting

the NMSettingIP4Config

 

Returns :

the number of configured DNS servers

i

index number of the address to return

 
+
+

Returns

+

the address at index i +

+

+
+
-

nm_setting_ip4_config_get_dns ()

-
guint32             nm_setting_ip4_config_get_dns       (NMSettingIP4Config *setting,
-                                                         guint32 i);
-
+

nm_setting_ip4_config_add_address ()

+
gboolean
+nm_setting_ip4_config_add_address (NMSettingIP4Config *setting,
+                                   NMIP4Address *address);
+

Adds a new IPv4 address and associated information to the setting. The +given address is duplicated internally and is not changed by this function.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + +

setting :

the NMSettingIP4Config -

i :

index number of the DNS server to return

setting

the NMSettingIP4Config

 

Returns :

the IPv4 address (network byte order) of the DNS server at index -i -

address

the new address to add

 
+
+

Returns

+

TRUE if the address was added; FALSE if the address was already +known.

+

+
+
-

nm_setting_ip4_config_add_dns ()

-
gboolean            nm_setting_ip4_config_add_dns       (NMSettingIP4Config *setting,
-                                                         guint32 dns);
-

-Adds a new DNS server to the setting. -

-
+

nm_setting_ip4_config_remove_address ()

+
void
+nm_setting_ip4_config_remove_address (NMSettingIP4Config *setting,
+                                      guint32 i);
+

Removes the address at index i +.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + +

setting :

the NMSettingIP4Config -

dns :

the IPv4 address (network byte order) of the DNS server to add

setting

the NMSettingIP4Config

 

Returns :

-TRUE if the DNS server was added; FALSE if the server was already -known

i

index number of the address to remove

 
+
-

nm_setting_ip4_config_remove_dns ()

-
void                nm_setting_ip4_config_remove_dns    (NMSettingIP4Config *setting,
-                                                         guint32 i);
-

-Removes the DNS server at index i. -

-
+

nm_setting_ip4_config_remove_address_by_value ()

+
gboolean
+nm_setting_ip4_config_remove_address_by_value
+                               (NMSettingIP4Config *setting,
+                                NMIP4Address *address);
+

Removes the address address +.

+
+

Parameters

+
--+++ - - + + + - - + + +

setting :

the NMSettingIP4Config -

setting

the NMSettingIP4Config

 

i :

index number of the DNS server to remove

address

the IP address to remove

 
+
+

Returns

+

TRUE if the address was found and removed; FALSE if it was not.

+

+
+

Since 0.9.10

+
-

nm_setting_ip4_config_remove_dns_by_value ()

-
gboolean            nm_setting_ip4_config_remove_dns_by_value
-                                                        (NMSettingIP4Config *setting,
-                                                         guint32 dns);
-

-Removes the DNS server dns. -

-
+

nm_setting_ip4_config_clear_addresses ()

+
void
+nm_setting_ip4_config_clear_addresses (NMSettingIP4Config *setting);
+

Removes all configured addresses.

+
+

Parameters

+
--+++ - - - - - - - - - - - - - - + + + + +

setting :

the NMSettingIP4Config -

dns :

the DNS server to remove

Returns :

-TRUE if the DNS server was found and removed; FALSE if it was not. -domain was already known

setting

the NMSettingIP4Config

 
-

Since 0.9.10

+

-

nm_setting_ip4_config_clear_dns ()

-
void                nm_setting_ip4_config_clear_dns     (NMSettingIP4Config *setting);
-

-Removes all configured DNS servers. -

-
+

nm_setting_ip4_config_get_num_routes ()

+
guint32
+nm_setting_ip4_config_get_num_routes (NMSettingIP4Config *setting);
+
+

Parameters

+
--+++ - - + + +

setting :

the NMSettingIP4Config -

setting

the NMSettingIP4Config

 
+
+

Returns

+

the number of configured routes

+

+
+
-

nm_setting_ip4_config_get_num_dns_searches ()

-
guint32             nm_setting_ip4_config_get_num_dns_searches
-                                                        (NMSettingIP4Config *setting);
-
+

nm_setting_ip4_config_get_route ()

+
NMIP4Route *
+nm_setting_ip4_config_get_route (NMSettingIP4Config *setting,
+                                 guint32 i);
+
+

Parameters

+
--+++ - - + + + - - + + +

setting :

the NMSettingIP4Config -

setting

the NMSettingIP4Config

 

Returns :

the number of configured DNS search domains

i

index number of the route to return

 
+
+

Returns

+

the route at index i +

+

+
+
-

nm_setting_ip4_config_get_dns_search ()

-
const char *        nm_setting_ip4_config_get_dns_search
-                                                        (NMSettingIP4Config *setting,
-                                                         guint32 i);
-
+

nm_setting_ip4_config_add_route ()

+
gboolean
+nm_setting_ip4_config_add_route (NMSettingIP4Config *setting,
+                                 NMIP4Route *route);
+

Adds a new IPv4 route and associated information to the setting. The +given route is duplicated internally and is not changed by this function.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + +

setting :

the NMSettingIP4Config -

i :

index number of the DNS search domain to return

setting

the NMSettingIP4Config

 

Returns :

the DNS search domain at index i -

route

the route to add

 
+
+

Returns

+

TRUE if the route was added; FALSE if the route was already known.

+

+
+
-

nm_setting_ip4_config_add_dns_search ()

-
gboolean            nm_setting_ip4_config_add_dns_search
-                                                        (NMSettingIP4Config *setting,
-                                                         const char *dns_search);
-

-Adds a new DNS search domain to the setting. -

-
+

nm_setting_ip4_config_remove_route ()

+
void
+nm_setting_ip4_config_remove_route (NMSettingIP4Config *setting,
+                                    guint32 i);
+

Removes the route at index i +.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + +

setting :

the NMSettingIP4Config -

dns_search :

the search domain to add

setting

the NMSettingIP4Config

 

Returns :

-TRUE if the DNS search domain was added; FALSE if the search -domain was already known

i

index number of the route

 
+
-

nm_setting_ip4_config_remove_dns_search ()

-
void                nm_setting_ip4_config_remove_dns_search
-                                                        (NMSettingIP4Config *setting,
-                                                         guint32 i);
-

-Removes the DNS search domain at index i. -

-
+

nm_setting_ip4_config_remove_route_by_value ()

+
gboolean
+nm_setting_ip4_config_remove_route_by_value
+                               (NMSettingIP4Config *setting,
+                                NMIP4Route *route);
+

Removes the route route +.

+
+

Parameters

+
--+++ - - + + + - - + + +

setting :

the NMSettingIP4Config -

setting

the NMSettingIP4Config

 

i :

index number of the DNS search domain

route

the route to remove

 
+
+

Returns

+

TRUE if the route was found and removed; FALSE if it was not.

+

+
+

Since 0.9.10

+
-

nm_setting_ip4_config_remove_dns_search_by_value ()

-
gboolean            nm_setting_ip4_config_remove_dns_search_by_value
-                                                        (NMSettingIP4Config *setting,
-                                                         const char *dns_search);
-

-Removes the DNS search domain dns_search. -

-
+

nm_setting_ip4_config_clear_routes ()

+
void
+nm_setting_ip4_config_clear_routes (NMSettingIP4Config *setting);
+

Removes all configured routes.

+
+

Parameters

+
--+++ - - - - - - - - - - - - - - + + + + +

setting :

the NMSettingIP4Config -

dns_search :

the search domain to remove

Returns :

-TRUE if the DNS search domain was found and removed; FALSE if it was not. -Since 0.9.10

setting

the NMSettingIP4Config

 
+
-

nm_setting_ip4_config_clear_dns_searches ()

-
void                nm_setting_ip4_config_clear_dns_searches
-                                                        (NMSettingIP4Config *setting);
-

-Removes all configured DNS search domains. -

-
+

nm_setting_ip4_config_get_route_metric ()

+
gint64
+nm_setting_ip4_config_get_route_metric
+                               (NMSettingIP4Config *setting);
+

Returns the value contained in the “route-metric” +property.

+
+

Parameters

+
--+++ - - + + +

setting :

the NMSettingIP4Config -

setting

the NMSettingIP4Config

 
+
+

Returns

+

the route metric that is used for IPv4 routes that don't explicitly +specify a metric. See “route-metric” for more details.

+

+
+

Since 1.0

+
-

nm_setting_ip4_config_get_num_addresses ()

-
guint32             nm_setting_ip4_config_get_num_addresses
-                                                        (NMSettingIP4Config *setting);
-
+

nm_setting_ip4_config_get_ignore_auto_routes ()

+
gboolean
+nm_setting_ip4_config_get_ignore_auto_routes
+                               (NMSettingIP4Config *setting);
+

Returns the value contained in the “ignore-auto-routes” +property.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSettingIP4Config -

Returns :

the number of configured addresses

setting

the NMSettingIP4Config

 
+
+

Returns

+

TRUE if automatically configured (ie via DHCP) routes should be +ignored.

+

+
+
-

nm_setting_ip4_config_get_address ()

-
NMIP4Address *      nm_setting_ip4_config_get_address   (NMSettingIP4Config *setting,
-                                                         guint32 i);
-
+

nm_setting_ip4_config_get_ignore_auto_dns ()

+
gboolean
+nm_setting_ip4_config_get_ignore_auto_dns
+                               (NMSettingIP4Config *setting);
+

Returns the value contained in the “ignore-auto-dns” +property.

+
+

Parameters

+
--+++ - - - - - - - - - - - - - - + + + + +

setting :

the NMSettingIP4Config -

i :

index number of the address to return

Returns :

the address at index i -

setting

the NMSettingIP4Config

 
+
+

Returns

+

TRUE if automatically configured (ie via DHCP) DNS information +should be ignored.

+

+
+
-

nm_setting_ip4_config_add_address ()

-
gboolean            nm_setting_ip4_config_add_address   (NMSettingIP4Config *setting,
-                                                         NMIP4Address *address);
-

-Adds a new IPv4 address and associated information to the setting. The -given address is duplicated internally and is not changed by this function. -

-
+

nm_setting_ip4_config_get_dhcp_client_id ()

+
const char *
+nm_setting_ip4_config_get_dhcp_client_id
+                               (NMSettingIP4Config *setting);
+

Returns the value contained in the “dhcp-client-id” +property.

+
+

Parameters

+
--+++ - - - - - - - - - - - - - - + + + + +

setting :

the NMSettingIP4Config -

address :

the new address to add

Returns :

-TRUE if the address was added; FALSE if the address was already -known.

setting

the NMSettingIP4Config

 
+
+

Returns

+

the configured Client ID to send to the DHCP server when requesting +addresses via DHCP.

+

+
+
-

nm_setting_ip4_config_remove_address ()

-
void                nm_setting_ip4_config_remove_address
-                                                        (NMSettingIP4Config *setting,
-                                                         guint32 i);
-

-Removes the address at index i. -

-
+

nm_setting_ip4_config_get_dhcp_send_hostname ()

+
gboolean
+nm_setting_ip4_config_get_dhcp_send_hostname
+                               (NMSettingIP4Config *setting);
+

Returns the value contained in the “dhcp-send-hostname” +property.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSettingIP4Config -

i :

index number of the address to remove

setting

the NMSettingIP4Config

 
+
+

Returns

+

TRUE if NetworkManager should send the machine hostname to the +DHCP server when requesting addresses to allow the server to automatically +update DNS information for this machine.

+

+
+
-

nm_setting_ip4_config_remove_address_by_value ()

-
gboolean            nm_setting_ip4_config_remove_address_by_value
-                                                        (NMSettingIP4Config *setting,
-                                                         NMIP4Address *address);
-

-Removes the address address. -

-
+

nm_setting_ip4_config_get_dhcp_hostname ()

+
const char *
+nm_setting_ip4_config_get_dhcp_hostname
+                               (NMSettingIP4Config *setting);
+

Returns the value contained in the “dhcp-hostname” +property.

+
+

Parameters

+
--+++ - - - - - - - - - - - - - - + + + + + +

setting :

the NMSettingIP4Config -

address :

the IP address to remove

Returns :

-TRUE if the address was found and removed; FALSE if it was not.

setting

the NMSettingIP4Config

 
+
+
+

Returns

+

the configured hostname to send to the DHCP server

+

+
+ +
+
+

nm_setting_ip4_config_get_never_default ()

+
gboolean
+nm_setting_ip4_config_get_never_default
+                               (NMSettingIP4Config *setting);
+

Returns the value contained in the “never-default” +property.

+
+

Parameters

+
+++++ + + + + +

setting

the NMSettingIP4Config

 
-

Since 0.9.10

+
+
+

Returns

+

TRUE if this connection should never be the default connection +for IPv4 addressing

+

+

-

nm_setting_ip4_config_clear_addresses ()

-
void                nm_setting_ip4_config_clear_addresses
-                                                        (NMSettingIP4Config *setting);
+

nm_setting_ip4_config_get_may_fail ()

+
gboolean
+nm_setting_ip4_config_get_may_fail (NMSettingIP4Config *setting);
+

Returns the value contained in the “may-fail” +property.

+
+

Parameters

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

setting

the NMSettingIP4Config

 
+
+
+

Returns

+

TRUE if this connection doesn't require IPv4 addressing to complete +for the connection to succeed.

+

+
+
+ +
+

Types and Values

+
+

NM_SETTING_IP4_CONFIG_SETTING_NAME

+
#define NM_SETTING_IP4_CONFIG_SETTING_NAME "ipv4"
+

-Removes all configured addresses.

-
---- - - - - -

setting :

the NMSettingIP4Config -

-

nm_setting_ip4_config_get_num_routes ()

-
guint32             nm_setting_ip4_config_get_num_routes
-                                                        (NMSettingIP4Config *setting);
-
+

enum NMSettingIP4ConfigError

+
+

Members

+
--+++ - - + + - - - - -

setting :

the NMSettingIP4Config +

NM_SETTING_IP4_CONFIG_ERROR_UNKNOWN

+

unknown or unclassified error

 

Returns :

the number of configured routes
-
-
-
-

nm_setting_ip4_config_get_route ()

-
NMIP4Route *        nm_setting_ip4_config_get_route     (NMSettingIP4Config *setting,
-                                                         guint32 i);
-
---- - - - - + + - - + + + - - + +

setting :

the NMSettingIP4Config +

NM_SETTING_IP4_CONFIG_ERROR_INVALID_PROPERTY

+

the property was invalid

 

i :

index number of the route to return

NM_SETTING_IP4_CONFIG_ERROR_MISSING_PROPERTY

+

the property was missing and is +required

+
 

Returns :

the route at index i +

NM_SETTING_IP4_CONFIG_ERROR_NOT_ALLOWED_FOR_METHOD

+

the property's value is +not valid with the given IP4 method

 
+

-

nm_setting_ip4_config_add_route ()

-
gboolean            nm_setting_ip4_config_add_route     (NMSettingIP4Config *setting,
-                                                         NMIP4Route *route);
+

NM_SETTING_IP4_CONFIG_ERROR

+
#define NM_SETTING_IP4_CONFIG_ERROR nm_setting_ip4_config_error_quark ()
+

-Adds a new IPv4 route and associated information to the setting. The -given route is duplicated internally and is not changed by this function.

-
---- - - - - - - - - - - - - - - -

setting :

the NMSettingIP4Config -

route :

the route to add

Returns :

-TRUE if the route was added; FALSE if the route was already known.

-

nm_setting_ip4_config_remove_route ()

-
void                nm_setting_ip4_config_remove_route  (NMSettingIP4Config *setting,
-                                                         guint32 i);
+

NM_SETTING_IP4_CONFIG_METHOD

+
#define NM_SETTING_IP4_CONFIG_METHOD             "method"
+

-Removes the route at index i.

-
---- - - - - - - - - - - -

setting :

the NMSettingIP4Config -

i :

index number of the route

-

nm_setting_ip4_config_remove_route_by_value ()

-
gboolean            nm_setting_ip4_config_remove_route_by_value
-                                                        (NMSettingIP4Config *setting,
-                                                         NMIP4Route *route);
+

NM_SETTING_IP4_CONFIG_DNS

+
#define NM_SETTING_IP4_CONFIG_DNS                "dns"
+

-Removes the route route.

-
---- - - - - - - - - - - - - - - -

setting :

the NMSettingIP4Config -

route :

the route to remove

Returns :

-TRUE if the route was found and removed; FALSE if it was not.
-

Since 0.9.10


-

nm_setting_ip4_config_clear_routes ()

-
void                nm_setting_ip4_config_clear_routes  (NMSettingIP4Config *setting);
+

NM_SETTING_IP4_CONFIG_DNS_SEARCH

+
#define NM_SETTING_IP4_CONFIG_DNS_SEARCH         "dns-search"
+

-Removes all configured routes.

-
---- - - - - -

setting :

the NMSettingIP4Config -

-

nm_setting_ip4_config_get_route_metric ()

-
gint64              nm_setting_ip4_config_get_route_metric
-                                                        (NMSettingIP4Config *setting);
+

NM_SETTING_IP4_CONFIG_ADDRESSES

+
#define NM_SETTING_IP4_CONFIG_ADDRESSES          "addresses"
+

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

-
---- - - - - - - - - - - -

setting :

the NMSettingIP4Config -

Returns :

the route metric that is used for IPv4 routes that don't explicitly -specify a metric. See "route-metric" for more details.
-

Since 1.0


-

nm_setting_ip4_config_get_ignore_auto_routes ()

-
gboolean            nm_setting_ip4_config_get_ignore_auto_routes
-                                                        (NMSettingIP4Config *setting);
+

NM_SETTING_IP4_CONFIG_ROUTES

+
#define NM_SETTING_IP4_CONFIG_ROUTES             "routes"
+

-Returns the value contained in the "ignore-auto-routes" -property.

-
---- - - - - - - - - - - -

setting :

the NMSettingIP4Config -

Returns :

-TRUE if automatically configured (ie via DHCP) routes should be -ignored.

-

nm_setting_ip4_config_get_ignore_auto_dns ()

-
gboolean            nm_setting_ip4_config_get_ignore_auto_dns
-                                                        (NMSettingIP4Config *setting);
+

NM_SETTING_IP4_CONFIG_ROUTE_METRIC

+
#define NM_SETTING_IP4_CONFIG_ROUTE_METRIC       "route-metric"
+

-Returns the value contained in the "ignore-auto-dns" -property.

-
---- - - - - - - - - - - -

setting :

the NMSettingIP4Config -

Returns :

-TRUE if automatically configured (ie via DHCP) DNS information -should be ignored.

-

nm_setting_ip4_config_get_dhcp_client_id ()

-
const char *        nm_setting_ip4_config_get_dhcp_client_id
-                                                        (NMSettingIP4Config *setting);
+

NM_SETTING_IP4_CONFIG_IGNORE_AUTO_ROUTES

+
#define NM_SETTING_IP4_CONFIG_IGNORE_AUTO_ROUTES "ignore-auto-routes"
+

-Returns the value contained in the "dhcp-client-id" -property.

-
---- - - - - - - - - - - -

setting :

the NMSettingIP4Config -

Returns :

the configured Client ID to send to the DHCP server when requesting -addresses via DHCP.

-

nm_setting_ip4_config_get_dhcp_send_hostname ()

-
gboolean            nm_setting_ip4_config_get_dhcp_send_hostname
-                                                        (NMSettingIP4Config *setting);
+

NM_SETTING_IP4_CONFIG_IGNORE_AUTO_DNS

+
#define NM_SETTING_IP4_CONFIG_IGNORE_AUTO_DNS    "ignore-auto-dns"
+

-Returns the value contained in the "dhcp-send-hostname" -property.

-
---- - - - - - - - - - - -

setting :

the NMSettingIP4Config -

Returns :

-TRUE if NetworkManager should send the machine hostname to the -DHCP server when requesting addresses to allow the server to automatically -update DNS information for this machine.

-

nm_setting_ip4_config_get_dhcp_hostname ()

-
const char *        nm_setting_ip4_config_get_dhcp_hostname
-                                                        (NMSettingIP4Config *setting);
+

NM_SETTING_IP4_CONFIG_DHCP_CLIENT_ID

+
#define NM_SETTING_IP4_CONFIG_DHCP_CLIENT_ID     "dhcp-client-id"
+

-Returns the value contained in the "dhcp-hostname" -property.

-
---- - - - - - - - - - - -

setting :

the NMSettingIP4Config -

Returns :

the configured hostname to send to the DHCP server

-

nm_setting_ip4_config_get_never_default ()

-
gboolean            nm_setting_ip4_config_get_never_default
-                                                        (NMSettingIP4Config *setting);
+

NM_SETTING_IP4_CONFIG_DHCP_SEND_HOSTNAME

+
#define NM_SETTING_IP4_CONFIG_DHCP_SEND_HOSTNAME "dhcp-send-hostname"
+

-Returns the value contained in the "never-default" -property.

-
---- - - - - - - - - - - -

setting :

the NMSettingIP4Config -

Returns :

-TRUE if this connection should never be the default connection -for IPv4 addressing

-

nm_setting_ip4_config_get_may_fail ()

-
gboolean            nm_setting_ip4_config_get_may_fail  (NMSettingIP4Config *setting);
+

NM_SETTING_IP4_CONFIG_DHCP_HOSTNAME

+
#define NM_SETTING_IP4_CONFIG_DHCP_HOSTNAME      "dhcp-hostname"
+

-Returns the value contained in the "may-fail" -property.

-
---- - - - - - - - - - - -

setting :

the NMSettingIP4Config -

Returns :

-TRUE if this connection doesn't require IPv4 addressing to complete -for the connection to succeed.
-
-
-

Property Details

+
-

The "addresses" property

-
  "addresses"                GPtrArray_GArray_guint__*  : Read / Write
+

NM_SETTING_IP4_CONFIG_NEVER_DEFAULT

+
#define NM_SETTING_IP4_CONFIG_NEVER_DEFAULT      "never-default"
+

-Array of IPv4 address structures. Each IPv4 address structure is -composed of 3 32-bit values; the first being the IPv4 address (network -byte order), the second the prefix (1 - 32), and last the IPv4 gateway -(network byte order). The gateway may be left as 0 if no gateway exists -for that subnet. For the "auto" method, given IP addresses are appended -to those returned by automatic configuration. Addresses cannot be used -with the "shared", "link-local", or "disabled" methods as addressing is -either automatic or disabled with these methods.


-

The "dhcp-client-id" property

-
  "dhcp-client-id"           gchar*                : Read / Write
+

NM_SETTING_IP4_CONFIG_MAY_FAIL

+
#define NM_SETTING_IP4_CONFIG_MAY_FAIL           "may-fail"
+

-A string sent to the DHCP server to identify the local machine which the -DHCP server may use to customize the DHCP lease and options.

+
+
+
+

NM_SETTING_IP4_CONFIG_METHOD_AUTO

+
#define NM_SETTING_IP4_CONFIG_METHOD_AUTO       "auto"
+
+

IPv4 configuration should be automatically determined via a method appropriate +for the hardware interface, ie DHCP or PPP or some other device-specific +manner.

+
+
+
+

NM_SETTING_IP4_CONFIG_METHOD_LINK_LOCAL

+
#define NM_SETTING_IP4_CONFIG_METHOD_LINK_LOCAL "link-local"
+
+

IPv4 configuration should be automatically configured for link-local-only +operation.

+
+
+
+

NM_SETTING_IP4_CONFIG_METHOD_MANUAL

+
#define NM_SETTING_IP4_CONFIG_METHOD_MANUAL     "manual"
+
+

All necessary IPv4 configuration (addresses, prefix, DNS, etc) is specified +in the setting's properties.

+
+
+
+

NM_SETTING_IP4_CONFIG_METHOD_SHARED

+
#define NM_SETTING_IP4_CONFIG_METHOD_SHARED     "shared"
+
+

This connection specifies configuration that allows other computers to +connect through it to the default network (usually the Internet). The +connection's interface will be assigned a private address, and a DHCP server, +caching DNS server, and Network Address Translation (NAT) functionality will +be started on this connection's interface to allow other devices to connect +through that interface to the default network.

+
+
+
+

NM_SETTING_IP4_CONFIG_METHOD_DISABLED

+
#define NM_SETTING_IP4_CONFIG_METHOD_DISABLED   "disabled"
+
+

This connection does not use or require IPv4 address and it should be disabled.

+
+
+
+

Property Details

+
+

The “addresses” property

+
  “addresses”                GPtrArray_GArray_guint__ *
+

+

Flags: Read / Write

+
+
+
+

The “dhcp-client-id” property

+
  “dhcp-client-id”           gchar *
+

+

Flags: Read / Write

Default value: NULL


-

The "dhcp-hostname" property

-
  "dhcp-hostname"            gchar*                : Read / Write
-

-If the "dhcp-send-hostname" property is TRUE, then the -specified name will be sent to the DHCP server when acquiring a lease. -

+

The “dhcp-hostname” property

+
  “dhcp-hostname”            gchar *
+

+

Flags: Read / Write

Default value: NULL


-

The "dhcp-send-hostname" property

-
  "dhcp-send-hostname"       gboolean              : Read / Write / Construct
-

-If TRUE, a hostname is sent to the DHCP server when acquiring a lease. -Some DHCP servers use this hostname to update DNS databases, essentially -providing a static hostname for the computer. If the -"dhcp-hostname" property is empty and this property is -TRUE, the current persistent hostname of the computer is sent. -

+

The “dhcp-send-hostname” property

+
  “dhcp-send-hostname”       gboolean
+

+

Flags: Read / Write / Construct

Default value: TRUE


-

The "dns" property

-
  "dns"                      GArray_guint_*        : Read / Write
-

-List of DNS servers (network byte order). For the "auto" method, these -DNS servers are appended to those (if any) returned by automatic -configuration. DNS servers cannot be used with the "shared", -"link-local", or "disabled" methods as there is no upstream network. In -all other methods, these DNS servers are used as the only DNS servers for -this connection. -

+

The “dns” property

+
  “dns”                      GArray_guint_ *
+

+

Flags: Read / Write


-

The "dns-search" property

-
  "dns-search"               GSList_gchararray_*   : Read / Write
-

-List of DNS search domains. For the "auto" method, these search domains -are appended to those returned by automatic configuration. Search domains -cannot be used with the "shared", "link-local", or "disabled" methods as -there is no upstream network. In all other methods, these search domains -are used as the only search domains for this connection. -

+

The “dns-search” property

+
  “dns-search”               GSList_gchararray_ *
+

+

Flags: Read / Write


-

The "ignore-auto-dns" property

-
  "ignore-auto-dns"          gboolean              : Read / Write / Construct
-

-When the method is set to "auto" and this property to TRUE, -automatically configured nameservers and search domains are ignored and -only nameservers and search domains specified in the -"dns" and "dns-search" properties, if -any, are used. -

+

The “ignore-auto-dns” property

+
  “ignore-auto-dns”          gboolean
+

+

Flags: Read / Write / Construct

Default value: FALSE


-

The "ignore-auto-routes" property

-
  "ignore-auto-routes"       gboolean              : Read / Write / Construct
-

-When the method is set to "auto" and this property to TRUE, -automatically configured routes are ignored and only routes specified in -the "routes" property, if any, are used. -

+

The “ignore-auto-routes” property

+
  “ignore-auto-routes”       gboolean
+

+

Flags: Read / Write / Construct

Default value: FALSE


-

The "may-fail" property

-
  "may-fail"                 gboolean              : Read / Write / Construct
-

-If TRUE, allow overall network configuration to proceed even if IPv4 -configuration times out. Note that at least one IP configuration must -succeed or overall network configuration will still fail. For example, -in IPv6-only networks, setting this property to TRUE allows the overall -network configuration to succeed if IPv4 configuration fails but IPv6 -configuration completes successfully. -

+

The “may-fail” property

+
  “may-fail”                 gboolean
+

+

Flags: Read / Write / Construct

Default value: TRUE


-

The "method" property

-
  "method"                   gchar*                : Read / Write
-

-IPv4 configuration method. If "auto" is specified then the appropriate -automatic method (DHCP, PPP, etc) is used for the interface and most -other properties can be left unset. If "link-local" is specified, then a -link-local address in the 169.254/16 range will be assigned to the -interface. If "manual" is specified, static IP addressing is used and at -least one IP address must be given in the "addresses" property. If -"shared" is specified (indicating that this connection will provide -network access to other computers) then the interface is assigned an -address in the 10.42.x.1/24 range and a DHCP and forwarding DNS server -are started, and the interface is NAT-ed to the current default network -connection. "disabled" means IPv4 will not be used on this connection. -This property must be set. -

+

The “method” property

+
  “method”                   gchar *
+

+

Flags: Read / Write

Default value: NULL


-

The "never-default" property

-
  "never-default"            gboolean              : Read / Write / Construct
-

-If TRUE, this connection will never be the default IPv4 connection, -meaning it will never be assigned the default route by NetworkManager. -

+

The “never-default” property

+
  “never-default”            gboolean
+

+

Flags: Read / Write / Construct

Default value: FALSE


-

The "route-metric" property

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

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

+

The “route-metric” property

+
  “route-metric”             gint64
+

+

Flags: Read / Write / Construct

Allowed values: [-1,4294967295]

Default value: -1

Since 1.0


-

The "routes" property

-
  "routes"                   GPtrArray_GArray_guint__*  : Read / Write
-

-Array of IPv4 route structures. Each IPv4 route structure is composed of -4 32-bit values; the first being the destination IPv4 network or address -(network byte order), the second the destination network or address -prefix (1 - 32), the third being the next-hop (network byte order) if -any, and the fourth being the route metric. For the "auto" method, given -IP routes are appended to those returned by automatic configuration. -Routes cannot be used with the "shared", "link-local", or "disabled" -methods because there is no upstream network. -

+

The “routes” property

+
  “routes”                   GPtrArray_GArray_guint__ *
+

+

Flags: Read / Write

+ Generated by GTK-Doc V1.21 \ No newline at end of file diff --git a/docs/libnm-util/html/NMSettingIP6Config.html b/docs/libnm-util/html/NMSettingIP6Config.html index b785114d..67b63a87 100644 --- a/docs/libnm-util/html/NMSettingIP6Config.html +++ b/docs/libnm-util/html/NMSettingIP6Config.html @@ -2,34 +2,28 @@ -NMSettingIP6Config +libnm-util Reference Manual: NMSettingIP6Config - + - - - - - - - - - - + + + + + + +
@@ -37,2170 +31,2694 @@

NMSettingIP6Config

NMSettingIP6Config — Describes IPv6 addressing, routing, and name service properties

- +
-
-

Synopsis

-
-#include <nm-setting-ip6-config.h>
-
-#define             NM_SETTING_IP6_CONFIG_SETTING_NAME
-enum                NMSettingIP6ConfigError;
-#define             NM_SETTING_IP6_CONFIG_ERROR
-GQuark              nm_setting_ip6_config_error_quark   (void);
-#define             NM_SETTING_IP6_CONFIG_METHOD
-#define             NM_SETTING_IP6_CONFIG_DNS
-#define             NM_SETTING_IP6_CONFIG_DNS_SEARCH
-#define             NM_SETTING_IP6_CONFIG_ADDRESSES
-#define             NM_SETTING_IP6_CONFIG_ROUTES
-#define             NM_SETTING_IP6_CONFIG_ROUTE_METRIC
-#define             NM_SETTING_IP6_CONFIG_IGNORE_AUTO_ROUTES
-#define             NM_SETTING_IP6_CONFIG_IGNORE_AUTO_DNS
-#define             NM_SETTING_IP6_CONFIG_NEVER_DEFAULT
-#define             NM_SETTING_IP6_CONFIG_MAY_FAIL
-#define             NM_SETTING_IP6_CONFIG_IP6_PRIVACY
-#define             NM_SETTING_IP6_CONFIG_DHCP_HOSTNAME
-#define             NM_SETTING_IP6_CONFIG_METHOD_IGNORE
-#define             NM_SETTING_IP6_CONFIG_METHOD_AUTO
-#define             NM_SETTING_IP6_CONFIG_METHOD_DHCP
-#define             NM_SETTING_IP6_CONFIG_METHOD_LINK_LOCAL
-#define             NM_SETTING_IP6_CONFIG_METHOD_MANUAL
-#define             NM_SETTING_IP6_CONFIG_METHOD_SHARED
-enum                NMSettingIP6ConfigPrivacy;
-typedef             NMIP6Address;
-NMIP6Address *      nm_ip6_address_new                  (void);
-NMIP6Address *      nm_ip6_address_dup                  (NMIP6Address *source);
-void                nm_ip6_address_ref                  (NMIP6Address *address);
-void                nm_ip6_address_unref                (NMIP6Address *address);
-gboolean            nm_ip6_address_compare              (NMIP6Address *address,
-                                                         NMIP6Address *other);
-const struct in6_addr * nm_ip6_address_get_address      (NMIP6Address *address);
-void                nm_ip6_address_set_address          (NMIP6Address *address,
-                                                         const struct in6_addr *addr);
-guint32             nm_ip6_address_get_prefix           (NMIP6Address *address);
-void                nm_ip6_address_set_prefix           (NMIP6Address *address,
-                                                         guint32 prefix);
-const struct in6_addr * nm_ip6_address_get_gateway      (NMIP6Address *address);
-void                nm_ip6_address_set_gateway          (NMIP6Address *address,
-                                                         const struct in6_addr *gateway);
-typedef             NMIP6Route;
-NMIP6Route *        nm_ip6_route_new                    (void);
-NMIP6Route *        nm_ip6_route_dup                    (NMIP6Route *source);
-void                nm_ip6_route_ref                    (NMIP6Route *route);
-void                nm_ip6_route_unref                  (NMIP6Route *route);
-gboolean            nm_ip6_route_compare                (NMIP6Route *route,
-                                                         NMIP6Route *other);
-const struct in6_addr * nm_ip6_route_get_dest           (NMIP6Route *route);
-void                nm_ip6_route_set_dest               (NMIP6Route *route,
-                                                         const struct in6_addr *dest);
-guint32             nm_ip6_route_get_prefix             (NMIP6Route *route);
-void                nm_ip6_route_set_prefix             (NMIP6Route *route,
-                                                         guint32 prefix);
-const struct in6_addr * nm_ip6_route_get_next_hop       (NMIP6Route *route);
-void                nm_ip6_route_set_next_hop           (NMIP6Route *route,
-                                                         const struct in6_addr *next_hop);
-guint32             nm_ip6_route_get_metric             (NMIP6Route *route);
-void                nm_ip6_route_set_metric             (NMIP6Route *route,
-                                                         guint32 metric);
-                    NMSettingIP6Config;
-                    NMSettingIP6ConfigClass;
-NMSetting *         nm_setting_ip6_config_new           (void);
-const char *        nm_setting_ip6_config_get_method    (NMSettingIP6Config *setting);
-guint32             nm_setting_ip6_config_get_num_dns   (NMSettingIP6Config *setting);
-const struct in6_addr * nm_setting_ip6_config_get_dns   (NMSettingIP6Config *setting,
-                                                         guint32 i);
-gboolean            nm_setting_ip6_config_add_dns       (NMSettingIP6Config *setting,
-                                                         const struct in6_addr *dns);
-void                nm_setting_ip6_config_remove_dns    (NMSettingIP6Config *setting,
-                                                         guint32 i);
-gboolean            nm_setting_ip6_config_remove_dns_by_value
-                                                        (NMSettingIP6Config *setting,
-                                                         const struct in6_addr *dns);
-void                nm_setting_ip6_config_clear_dns     (NMSettingIP6Config *setting);
-guint32             nm_setting_ip6_config_get_num_dns_searches
-                                                        (NMSettingIP6Config *setting);
-const char *        nm_setting_ip6_config_get_dns_search
-                                                        (NMSettingIP6Config *setting,
-                                                         guint32 i);
-gboolean            nm_setting_ip6_config_add_dns_search
-                                                        (NMSettingIP6Config *setting,
-                                                         const char *dns_search);
-void                nm_setting_ip6_config_remove_dns_search
-                                                        (NMSettingIP6Config *setting,
-                                                         guint32 i);
-gboolean            nm_setting_ip6_config_remove_dns_search_by_value
-                                                        (NMSettingIP6Config *setting,
-                                                         const char *dns_search);
-void                nm_setting_ip6_config_clear_dns_searches
-                                                        (NMSettingIP6Config *setting);
-guint32             nm_setting_ip6_config_get_num_addresses
-                                                        (NMSettingIP6Config *setting);
-NMIP6Address *      nm_setting_ip6_config_get_address   (NMSettingIP6Config *setting,
-                                                         guint32 i);
-gboolean            nm_setting_ip6_config_add_address   (NMSettingIP6Config *setting,
-                                                         NMIP6Address *address);
-void                nm_setting_ip6_config_remove_address
-                                                        (NMSettingIP6Config *setting,
-                                                         guint32 i);
-gboolean            nm_setting_ip6_config_remove_address_by_value
-                                                        (NMSettingIP6Config *setting,
-                                                         NMIP6Address *address);
-void                nm_setting_ip6_config_clear_addresses
-                                                        (NMSettingIP6Config *setting);
-guint32             nm_setting_ip6_config_get_num_routes
-                                                        (NMSettingIP6Config *setting);
-NMIP6Route *        nm_setting_ip6_config_get_route     (NMSettingIP6Config *setting,
-                                                         guint32 i);
-gboolean            nm_setting_ip6_config_add_route     (NMSettingIP6Config *setting,
-                                                         NMIP6Route *route);
-void                nm_setting_ip6_config_remove_route  (NMSettingIP6Config *setting,
-                                                         guint32 i);
-gboolean            nm_setting_ip6_config_remove_route_by_value
-                                                        (NMSettingIP6Config *setting,
-                                                         NMIP6Route *route);
-void                nm_setting_ip6_config_clear_routes  (NMSettingIP6Config *setting);
-gboolean            nm_setting_ip6_config_get_ignore_auto_routes
-                                                        (NMSettingIP6Config *setting);
-gint64              nm_setting_ip6_config_get_route_metric
-                                                        (NMSettingIP6Config *setting);
-gboolean            nm_setting_ip6_config_get_ignore_auto_dns
-                                                        (NMSettingIP6Config *setting);
-const char *        nm_setting_ip6_config_get_dhcp_hostname
-                                                        (NMSettingIP6Config *setting);
-gboolean            nm_setting_ip6_config_get_never_default
-                                                        (NMSettingIP6Config *setting);
-gboolean            nm_setting_ip6_config_get_may_fail  (NMSettingIP6Config *setting);
-NMSettingIP6ConfigPrivacy nm_setting_ip6_config_get_ip6_privacy
-                                                        (NMSettingIP6Config *setting);
-
-
-
-

Object Hierarchy

-
-  GEnum
-   +----NMSettingIP6ConfigError
-
-
-  GEnum
-   +----NMSettingIP6ConfigPrivacy
-
-
-  GBoxed
-   +----NMIP6Address
-
-
-  GBoxed
-   +----NMIP6Route
-
-
-  GObject
-   +----NMSetting
-         +----NMSettingIP6Config
-
-
-
-

Properties

-
-  "addresses"                GPtrArray_GValueArray_GArray_guchar_+guint+GArray_guchar___*  : Read / Write
-  "dhcp-hostname"            gchar*                : Read / Write
-  "dns"                      GPtrArray_GArray_guchar__*  : Read / Write
-  "dns-search"               GSList_gchararray_*   : Read / Write
-  "ignore-auto-dns"          gboolean              : Read / Write / Construct
-  "ignore-auto-routes"       gboolean              : Read / Write / Construct
-  "ip6-privacy"              gint                  : Read / Write / Construct
-  "may-fail"                 gboolean              : Read / Write / Construct
-  "method"                   gchar*                : Read / Write
-  "never-default"            gboolean              : Read / Write / Construct
-  "route-metric"             gint64                : Read / Write / Construct
-  "routes"                   GPtrArray_GValueArray_GArray_guchar_+guint+GArray_guchar_+guint__*  : Read / Write
-
-
-
-

Description

-

-The NMSettingIP6Config object is a NMSetting subclass that describes -properties related to IPv6 addressing, routing, and Domain Name Service -

-
-

Details

-
-

NM_SETTING_IP6_CONFIG_SETTING_NAME

-
#define NM_SETTING_IP6_CONFIG_SETTING_NAME "ipv6"
-
-

-

-
-
-
-

enum NMSettingIP6ConfigError

-
typedef enum {
-	NM_SETTING_IP6_CONFIG_ERROR_UNKNOWN = 0,           /*< nick=UnknownError >*/
-	NM_SETTING_IP6_CONFIG_ERROR_INVALID_PROPERTY,      /*< nick=InvalidProperty >*/
-	NM_SETTING_IP6_CONFIG_ERROR_MISSING_PROPERTY,      /*< nick=MissingProperty >*/
-	NM_SETTING_IP6_CONFIG_ERROR_NOT_ALLOWED_FOR_METHOD /*< nick=NotAllowedForMethod >*/
-} NMSettingIP6ConfigError;
-
-
+

Functions

+
--++ - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - - + - - + - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

NM_SETTING_IP6_CONFIG_ERROR_UNKNOWN

unknown or unclassified error + +GQuark + +nm_setting_ip6_config_error_quark () +
+NMIP6Address * + +nm_ip6_address_new () +
+NMIP6Address * + +nm_ip6_address_dup () +
+void + +nm_ip6_address_ref () +
+void + +nm_ip6_address_unref () +
+gboolean + +nm_ip6_address_compare () +
const struct in6_addr * + +nm_ip6_address_get_address () +
+void + +nm_ip6_address_set_address () +
+guint32 + +nm_ip6_address_get_prefix () +
+void + +nm_ip6_address_set_prefix () +
const struct in6_addr * + +nm_ip6_address_get_gateway () +
+void + +nm_ip6_address_set_gateway () +
+NMIP6Route * + +nm_ip6_route_new () +
+NMIP6Route * + +nm_ip6_route_dup () +
+void + +nm_ip6_route_ref () +
+void + +nm_ip6_route_unref () +
+gboolean + +nm_ip6_route_compare () +
const struct in6_addr * + +nm_ip6_route_get_dest () +
+void + +nm_ip6_route_set_dest () +
+guint32 + +nm_ip6_route_get_prefix () +
+void + +nm_ip6_route_set_prefix () +
const struct in6_addr * + +nm_ip6_route_get_next_hop () +
+void + +nm_ip6_route_set_next_hop () +
+guint32 + +nm_ip6_route_get_metric () +
+void + +nm_ip6_route_set_metric () +
+NMSetting * + +nm_setting_ip6_config_new () +
const char * + +nm_setting_ip6_config_get_method () +
+guint32 + +nm_setting_ip6_config_get_num_dns () +
const struct in6_addr * + +nm_setting_ip6_config_get_dns () +
+gboolean + +nm_setting_ip6_config_add_dns () +
+void + +nm_setting_ip6_config_remove_dns () +
+gboolean + +nm_setting_ip6_config_remove_dns_by_value () +
+void + +nm_setting_ip6_config_clear_dns () +
+guint32 + +nm_setting_ip6_config_get_num_dns_searches () +
const char * + +nm_setting_ip6_config_get_dns_search () +
+gboolean + +nm_setting_ip6_config_add_dns_search () +
+void + +nm_setting_ip6_config_remove_dns_search () +
+gboolean + +nm_setting_ip6_config_remove_dns_search_by_value () +
+void + +nm_setting_ip6_config_clear_dns_searches () +
+guint32 + +nm_setting_ip6_config_get_num_addresses ()

NM_SETTING_IP6_CONFIG_ERROR_INVALID_PROPERTY

the property was invalid + +NMIP6Address * + +nm_setting_ip6_config_get_address ()

NM_SETTING_IP6_CONFIG_ERROR_MISSING_PROPERTY

the property was missing and is -required + +gboolean + +nm_setting_ip6_config_add_address ()

NM_SETTING_IP6_CONFIG_ERROR_NOT_ALLOWED_FOR_METHOD

the property's value is -not valid with the given IPv6 method + +void + +nm_setting_ip6_config_remove_address () +
+gboolean + +nm_setting_ip6_config_remove_address_by_value () +
+void + +nm_setting_ip6_config_clear_addresses () +
+guint32 + +nm_setting_ip6_config_get_num_routes () +
+NMIP6Route * + +nm_setting_ip6_config_get_route () +
+gboolean + +nm_setting_ip6_config_add_route () +
+void + +nm_setting_ip6_config_remove_route () +
+gboolean + +nm_setting_ip6_config_remove_route_by_value () +
+void + +nm_setting_ip6_config_clear_routes () +
+gboolean + +nm_setting_ip6_config_get_ignore_auto_routes () +
+gint64 + +nm_setting_ip6_config_get_route_metric () +
+gboolean + +nm_setting_ip6_config_get_ignore_auto_dns () +
const char * + +nm_setting_ip6_config_get_dhcp_hostname () +
+gboolean + +nm_setting_ip6_config_get_never_default () +
+gboolean + +nm_setting_ip6_config_get_may_fail () +
+NMSettingIP6ConfigPrivacy + +nm_setting_ip6_config_get_ip6_privacy ()
-
-
-

NM_SETTING_IP6_CONFIG_ERROR

-
#define NM_SETTING_IP6_CONFIG_ERROR nm_setting_ip6_config_error_quark ()
-
-

-

-
-
-
-

nm_setting_ip6_config_error_quark ()

-
GQuark              nm_setting_ip6_config_error_quark   (void);
-

-Registers an error quark for NMSettingIP6Config if necessary. -

-
+
+

Properties

+
--+++ - - - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Returns :

the error quark used for NMSettingIP6Config errors.
GPtrArray_GValueArray_GArray_guchar_+guint+GArray_guchar___*addressesRead / Write
+gchar *dhcp-hostnameRead / Write
+GPtrArray_GArray_guchar__ *dnsRead / Write
+GSList_gchararray_ *dns-searchRead / Write
gbooleanignore-auto-dnsRead / Write / Construct
gbooleanignore-auto-routesRead / Write / Construct
gintip6-privacyRead / Write / Construct
gbooleanmay-failRead / Write / Construct
+gchar *methodRead / Write
gbooleannever-defaultRead / Write / Construct
gint64route-metricRead / Write / Construct
GPtrArray_GValueArray_GArray_guchar_+guint+GArray_guchar_+guint__*routesRead / Write
-
-
-

NM_SETTING_IP6_CONFIG_METHOD

-
#define NM_SETTING_IP6_CONFIG_METHOD             "method"
-
-

-

-
-
-
-

NM_SETTING_IP6_CONFIG_DNS

-
#define NM_SETTING_IP6_CONFIG_DNS                "dns"
-
-

-

-
-
-
-

NM_SETTING_IP6_CONFIG_DNS_SEARCH

-
#define NM_SETTING_IP6_CONFIG_DNS_SEARCH         "dns-search"
-
-

-

-
-
-
-

NM_SETTING_IP6_CONFIG_ADDRESSES

-
#define NM_SETTING_IP6_CONFIG_ADDRESSES          "addresses"
-
-

-

-
-
-
-

NM_SETTING_IP6_CONFIG_ROUTES

-
#define NM_SETTING_IP6_CONFIG_ROUTES             "routes"
-
-

-

-
-
-
-

NM_SETTING_IP6_CONFIG_ROUTE_METRIC

-
#define NM_SETTING_IP6_CONFIG_ROUTE_METRIC       "route-metric"
-
-

-

+ -
-
-

NM_SETTING_IP6_CONFIG_IGNORE_AUTO_ROUTES

-
#define NM_SETTING_IP6_CONFIG_IGNORE_AUTO_ROUTES "ignore-auto-routes"
+
+

Object Hierarchy

+
    GBoxed
+    ├── NMIP6Address
+    ╰── NMIP6Route
+    GEnum
+    ├── NMSettingIP6ConfigError
+    ╰── NMSettingIP6ConfigPrivacy
+    GObject
+    ╰── NMSetting
+        ╰── NMSettingIP6Config
 
-

-

-
-
-

NM_SETTING_IP6_CONFIG_IGNORE_AUTO_DNS

-
#define NM_SETTING_IP6_CONFIG_IGNORE_AUTO_DNS    "ignore-auto-dns"
+
+

Includes

+
#include <nm-setting-ip6-config.h>
 
-

-

-
-
-

NM_SETTING_IP6_CONFIG_NEVER_DEFAULT

-
#define NM_SETTING_IP6_CONFIG_NEVER_DEFAULT      "never-default"
-
-

-

+
+

Description

+

The NMSettingIP6Config object is a NMSetting subclass that describes +properties related to IPv6 addressing, routing, and Domain Name Service

-
+
+

Functions

-

NM_SETTING_IP6_CONFIG_MAY_FAIL

-
#define NM_SETTING_IP6_CONFIG_MAY_FAIL           "may-fail"
-
-

-

+

nm_setting_ip6_config_error_quark ()

+
GQuark
+nm_setting_ip6_config_error_quark (void);
+

Registers an error quark for NMSettingIP6Config if necessary.

+
+

Returns

+

the error quark used for NMSettingIP6Config errors.

+

-
-
-

NM_SETTING_IP6_CONFIG_IP6_PRIVACY

-
#define NM_SETTING_IP6_CONFIG_IP6_PRIVACY        "ip6-privacy"
-
-

-


-

NM_SETTING_IP6_CONFIG_DHCP_HOSTNAME

-
#define NM_SETTING_IP6_CONFIG_DHCP_HOSTNAME      "dhcp-hostname"
-
-

-

+

nm_ip6_address_new ()

+
NMIP6Address *
+nm_ip6_address_new (void);
+

Creates and returns a new NMIP6Address object.

+
+

Returns

+

the new empty NMIP6Address object.

+

[transfer full]

-
-
-

NM_SETTING_IP6_CONFIG_METHOD_IGNORE

-
#define NM_SETTING_IP6_CONFIG_METHOD_IGNORE     "ignore"
-
-

-IPv6 is not required or is handled by some other mechanism, and NetworkManager -should not configure IPv6 for this connection. -


-

NM_SETTING_IP6_CONFIG_METHOD_AUTO

-
#define NM_SETTING_IP6_CONFIG_METHOD_AUTO       "auto"
-
-

-IPv6 configuration should be automatically determined via a method appropriate -for the hardware interface, ie router advertisements, DHCP, or PPP or some -other device-specific manner. -

+

nm_ip6_address_dup ()

+
NMIP6Address *
+nm_ip6_address_dup (NMIP6Address *source);
+

Copies a given NMIP6Address object and returns the copy.

+
+

Parameters

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

source

the NMIP6Address object to copy

 
+
+
+

Returns

+

the copy of the given NMIP6Address copy.

+

[transfer full]

+

-

NM_SETTING_IP6_CONFIG_METHOD_DHCP

-
#define NM_SETTING_IP6_CONFIG_METHOD_DHCP       "dhcp"
-
-

-IPv6 configuration should be automatically determined via DHCPv6 only and -router advertisements should be ignored. -

+

nm_ip6_address_ref ()

+
void
+nm_ip6_address_ref (NMIP6Address *address);
+

Increases the reference count of the object.

+
+

Parameters

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

address

the NMIP6Address

 
+

-

NM_SETTING_IP6_CONFIG_METHOD_LINK_LOCAL

-
#define NM_SETTING_IP6_CONFIG_METHOD_LINK_LOCAL "link-local"
-
-

-IPv6 configuration should be automatically configured for link-local-only -operation. -

+

nm_ip6_address_unref ()

+
void
+nm_ip6_address_unref (NMIP6Address *address);
+

Decreases the reference count of the object. If the reference count +reaches zero, the object will be destroyed.

+
+

Parameters

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

address

the NMIP6Address

 
+

-

NM_SETTING_IP6_CONFIG_METHOD_MANUAL

-
#define NM_SETTING_IP6_CONFIG_METHOD_MANUAL     "manual"
-
-

-All necessary IPv6 configuration (addresses, prefix, DNS, etc) is specified -in the setting's properties. -

+

nm_ip6_address_compare ()

+
gboolean
+nm_ip6_address_compare (NMIP6Address *address,
+                        NMIP6Address *other);
+

Determines if two NMIP6Address objects contain the same values.

+
+

Parameters

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

address

the NMIP6Address

 

other

the NMIP6Address to compare address +to.

 
+
+
+

Returns

+

TRUE if the objects contain the same values, FALSE if they do not.

+

+

-

NM_SETTING_IP6_CONFIG_METHOD_SHARED

-
#define NM_SETTING_IP6_CONFIG_METHOD_SHARED     "shared"
-
-

-This connection specifies configuration that allows other computers to -connect through it to the default network (usually the Internet). The -connection's interface will be assigned a private address, and router -advertisements, a caching DNS server, and Network Address Translation (NAT) -functionality will be started on this connection's interface to allow other -devices to connect through that interface to the default network. (not yet -supported for IPv6) -

+

nm_ip6_address_get_address ()

+
const struct in6_addr *
+nm_ip6_address_get_address (NMIP6Address *address);
+

Gets the IPv6 address property of this address object.

+
+

Parameters

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

address

the NMIP6Address

 
+
+
+

Returns

+

the IPv6 address.

+

[array fixed-size=16][element-type guint8][transfer none]

+

-

enum NMSettingIP6ConfigPrivacy

-
typedef enum {
-	NM_SETTING_IP6_CONFIG_PRIVACY_UNKNOWN = -1,
-	NM_SETTING_IP6_CONFIG_PRIVACY_DISABLED = 0,
-	NM_SETTING_IP6_CONFIG_PRIVACY_PREFER_PUBLIC_ADDR = 1,
-	NM_SETTING_IP6_CONFIG_PRIVACY_PREFER_TEMP_ADDR = 2
-} NMSettingIP6ConfigPrivacy;
-
-

-NMSettingIP6ConfigPrivacy values indicate if and how IPv6 Privacy -Extensions are used (RFC4941). -

-
+

nm_ip6_address_set_address ()

+
void
+nm_ip6_address_set_address (NMIP6Address *address,
+                            const struct in6_addr *addr);
+

Sets the IPv6 address property of this object.

+
+

Parameters

+
--+++ - - + + + - - + + + + +

NM_SETTING_IP6_CONFIG_PRIVACY_UNKNOWN

unknown or no value specified -

address

the NMIP6Address

 

NM_SETTING_IP6_CONFIG_PRIVACY_DISABLED

IPv6 Privacy Extensions are disabled -

addr

the IPv6 address

 
+
+
+
+
+

nm_ip6_address_get_prefix ()

+
guint32
+nm_ip6_address_get_prefix (NMIP6Address *address);
+

Gets the IPv6 address prefix property of this address object.

+
+

Parameters

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

address

the NMIP6Address

 
+
+
+

Returns

+

the IPv6 address prefix

+

+
+
+
+
+

nm_ip6_address_set_prefix ()

+
void
+nm_ip6_address_set_prefix (NMIP6Address *address,
+                           guint32 prefix);
+

Sets the IPv6 address prefix.

+
+

Parameters

+
+++++ + - - + + + - - + + +

NM_SETTING_IP6_CONFIG_PRIVACY_PREFER_PUBLIC_ADDR

IPv6 Privacy Extensions -are enabled, but public addresses are preferred over temporary addresses -

address

the NMIP6Address

 

NM_SETTING_IP6_CONFIG_PRIVACY_PREFER_TEMP_ADDR

IPv6 Privacy Extensions -are enabled and temporary addresses are preferred over public addresses -

prefix

the address prefix, a number between 0 and 128 inclusive

 
-
-
-

NMIP6Address

-
typedef struct NMIP6Address NMIP6Address;
-
-

-


-

nm_ip6_address_new ()

-
NMIP6Address *      nm_ip6_address_new                  (void);
-

-Creates and returns a new NMIP6Address object. -

-
+

nm_ip6_address_get_gateway ()

+
const struct in6_addr *
+nm_ip6_address_get_gateway (NMIP6Address *address);
+

Gets the IPv6 default gateway property of this address object.

+
+

Parameters

+
--+++ - - + + +

Returns :

the new empty NMIP6Address object. [transfer full] -

address

the NMIP6Address

 
+
+

Returns

+

the IPv6 gateway address.

+

[array fixed-size=16][element-type guint8][transfer none]

+
+

-

nm_ip6_address_dup ()

-
NMIP6Address *      nm_ip6_address_dup                  (NMIP6Address *source);
-

-Copies a given NMIP6Address object and returns the copy. -

-
+

nm_ip6_address_set_gateway ()

+
void
+nm_ip6_address_set_gateway (NMIP6Address *address,
+                            const struct in6_addr *gateway);
+

Sets the IPv6 default gateway property of this address object.

+
+

Parameters

+
--+++ - - + + + - - + + +

source :

the NMIP6Address object to copy

address

the NMIP6Address

 

Returns :

the copy of the given NMIP6Address copy. [transfer full] -

gateway

the IPv6 default gateway

 
+

-

nm_ip6_address_ref ()

-
void                nm_ip6_address_ref                  (NMIP6Address *address);
-

-Increases the reference count of the object. -

-
+

nm_ip6_route_new ()

+
NMIP6Route *
+nm_ip6_route_new (void);
+

Creates and returns a new NMIP6Route object.

+
+

Returns

+

the new empty NMIP6Route object.

+

[transfer full]

+
+ +
+
+

nm_ip6_route_dup ()

+
NMIP6Route *
+nm_ip6_route_dup (NMIP6Route *source);
+

Copies a given NMIP6Route object and returns the copy.

+
+

Parameters

+
--+++ - - + + +

address :

the NMIP6Address -

source

the NMIP6Route object to copy

 
+
+

Returns

+

the copy of the given NMIP6Route copy.

+

[transfer full]

+
+

-

nm_ip6_address_unref ()

-
void                nm_ip6_address_unref                (NMIP6Address *address);
-

-Decreases the reference count of the object. If the reference count -reaches zero, the object will be destroyed. -

-
+

nm_ip6_route_ref ()

+
void
+nm_ip6_route_ref (NMIP6Route *route);
+

Increases the reference count of the object.

+
+

Parameters

+
--+++ - - + + +

address :

the NMIP6Address -

route

the NMIP6Route

 
+

-

nm_ip6_address_compare ()

-
gboolean            nm_ip6_address_compare              (NMIP6Address *address,
-                                                         NMIP6Address *other);
-

-Determines if two NMIP6Address objects contain the same values. -

-
+

nm_ip6_route_unref ()

+
void
+nm_ip6_route_unref (NMIP6Route *route);
+

Decreases the reference count of the object. If the reference count +reaches zero, the object will be destroyed.

+
+

Parameters

+
--+++ - - - - - - - - - - - - - - + + + + +

address :

the NMIP6Address -

other :

the NMIP6Address to compare address to.

Returns :

-TRUE if the objects contain the same values, FALSE if they do not.

route

the NMIP6Route

 
+

-

nm_ip6_address_get_address ()

-
const struct in6_addr * nm_ip6_address_get_address      (NMIP6Address *address);
-

-Gets the IPv6 address property of this address object. -

-
+

nm_ip6_route_compare ()

+
gboolean
+nm_ip6_route_compare (NMIP6Route *route,
+                      NMIP6Route *other);
+

Determines if two NMIP6Route objects contain the same values.

+
+

Parameters

+
--+++ - - + + + - - + + +

address :

the NMIP6Address -

route

the NMIP6Route

 

Returns :

the IPv6 address. [array fixed-size=16][element-type guint8][transfer none] -

other

the NMIP6Route to compare route +to.

 
+
+

Returns

+

TRUE if the objects contain the same values, FALSE if they do not.

+

+
+

-

nm_ip6_address_set_address ()

-
void                nm_ip6_address_set_address          (NMIP6Address *address,
-                                                         const struct in6_addr *addr);
-

-Sets the IPv6 address property of this object. -

-
+

nm_ip6_route_get_dest ()

+
const struct in6_addr *
+nm_ip6_route_get_dest (NMIP6Route *route);
+

Gets the IPv6 destination address property of this route object.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

address :

the NMIP6Address -

addr :

the IPv6 address

route

the NMIP6Route

 
+
+

Returns

+

the IPv6 address of destination.

+

[array fixed-size=16][element-type guint8][transfer none]

+
+

-

nm_ip6_address_get_prefix ()

-
guint32             nm_ip6_address_get_prefix           (NMIP6Address *address);
-

-Gets the IPv6 address prefix property of this address object. -

-
+

nm_ip6_route_set_dest ()

+
void
+nm_ip6_route_set_dest (NMIP6Route *route,
+                       const struct in6_addr *dest);
+

Sets the IPv6 destination address property of this route object.

+
+

Parameters

+
--+++ - - + + + - - + + +

address :

the NMIP6Address -

route

the NMIP6Route

 

Returns :

the IPv6 address prefix

dest

the destination address

 
+

-

nm_ip6_address_set_prefix ()

-
void                nm_ip6_address_set_prefix           (NMIP6Address *address,
-                                                         guint32 prefix);
-

-Sets the IPv6 address prefix. -

-
+

nm_ip6_route_get_prefix ()

+
guint32
+nm_ip6_route_get_prefix (NMIP6Route *route);
+

Gets the IPv6 prefix (ie "32" or "64" etc) of this route.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

address :

the NMIP6Address -

prefix :

the address prefix, a number between 0 and 128 inclusive

route

the NMIP6Route

 
+
+

Returns

+

the IPv6 prefix

+

+
+

-

nm_ip6_address_get_gateway ()

-
const struct in6_addr * nm_ip6_address_get_gateway      (NMIP6Address *address);
-

-Gets the IPv6 default gateway property of this address object. -

-
+

nm_ip6_route_set_prefix ()

+
void
+nm_ip6_route_set_prefix (NMIP6Route *route,
+                         guint32 prefix);
+

Sets the IPv6 prefix of this route.

+
+

Parameters

+
--+++ - - + + + - - + + +

address :

the NMIP6Address -

route

the NMIP6Route

 

Returns :

the IPv6 gateway address. [array fixed-size=16][element-type guint8][transfer none] -

prefix

the prefix, a number between 1 and 128 inclusive

 
+
-

nm_ip6_address_set_gateway ()

-
void                nm_ip6_address_set_gateway          (NMIP6Address *address,
-                                                         const struct in6_addr *gateway);
-

-Sets the IPv6 default gateway property of this address object. -

-
+

nm_ip6_route_get_next_hop ()

+
const struct in6_addr *
+nm_ip6_route_get_next_hop (NMIP6Route *route);
+

Gets the IPv6 address of the next hop of this route.

+
+

Parameters

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

route

the NMIP6Route

 
+
+
+

Returns

+

the IPv6 address of next hop.

+

[array fixed-size=16][element-type guint8][transfer none]

+
+ +
+
+

nm_ip6_route_set_next_hop ()

+
void
+nm_ip6_route_set_next_hop (NMIP6Route *route,
+                           const struct in6_addr *next_hop);
+

Sets the IPv6 address of the next hop of this route.

+
+

Parameters

+
--+++ - - + + + - - + + +

address :

the NMIP6Address -

route

the NMIP6Route

 

gateway :

the IPv6 default gateway

next_hop

the IPv6 address of the next hop

 
-
-
-

NMIP6Route

-
typedef struct NMIP6Route NMIP6Route;
-
-

-


-

nm_ip6_route_new ()

-
NMIP6Route *        nm_ip6_route_new                    (void);
-

-Creates and returns a new NMIP6Route object. -

-
+

nm_ip6_route_get_metric ()

+
guint32
+nm_ip6_route_get_metric (NMIP6Route *route);
+

Gets the route metric property of this route object; lower values indicate +"better" or more preferred routes.

+
+

Parameters

+
--+++ - - + + +

Returns :

the new empty NMIP6Route object. [transfer full] -

route

the NMIP6Route

 
+
+

Returns

+

the route metric

+

+
+

-

nm_ip6_route_dup ()

-
NMIP6Route *        nm_ip6_route_dup                    (NMIP6Route *source);
-

-Copies a given NMIP6Route object and returns the copy. -

-
+

nm_ip6_route_set_metric ()

+
void
+nm_ip6_route_set_metric (NMIP6Route *route,
+                         guint32 metric);
+

Sets the route metric property of this route object; lower values indicate +"better" or more preferred routes.

+
+

Parameters

+
--+++ - - + + + - - + + +

source :

the NMIP6Route object to copy

route

the NMIP6Route

 

Returns :

the copy of the given NMIP6Route copy. [transfer full] -

metric

the route metric

 
+
-

nm_ip6_route_ref ()

-
void                nm_ip6_route_ref                    (NMIP6Route *route);
-

-Increases the reference count of the object. -

-
+

nm_setting_ip6_config_new ()

+
NMSetting *
+nm_setting_ip6_config_new (void);
+

Creates a new NMSettingIP6Config object with default values.

+
+

Returns

+

the new empty NMSettingIP6Config object.

+

[transfer full]

+
+ +
+
+

nm_setting_ip6_config_get_method ()

+
const char *
+nm_setting_ip6_config_get_method (NMSettingIP6Config *setting);
+
+

Parameters

+
--+++ - - + + +

route :

the NMIP6Route -

setting

the NMSettingIP6Config

 
+
+

Returns

+

the “method” property of the setting

+

+
+
-

nm_ip6_route_unref ()

-
void                nm_ip6_route_unref                  (NMIP6Route *route);
-

-Decreases the reference count of the object. If the reference count -reaches zero, the object will be destroyed. -

-
+

nm_setting_ip6_config_get_num_dns ()

+
guint32
+nm_setting_ip6_config_get_num_dns (NMSettingIP6Config *setting);
+
+

Parameters

+
--+++ - - + + +

route :

the NMIP6Route -

setting

the NMSettingIP6Config

 
+
+

Returns

+

the number of configured DNS servers

+

+
+
-

nm_ip6_route_compare ()

-
gboolean            nm_ip6_route_compare                (NMIP6Route *route,
-                                                         NMIP6Route *other);
-

-Determines if two NMIP6Route objects contain the same values. -

-
+

nm_setting_ip6_config_get_dns ()

+
const struct in6_addr *
+nm_setting_ip6_config_get_dns (NMSettingIP6Config *setting,
+                               guint32 i);
+
+

Parameters

+
--+++ - - - - - - + + + - - + + +

route :

the NMIP6Route -

other :

the NMIP6Route to compare route to.

setting

the NMSettingIP6Config

 

Returns :

-TRUE if the objects contain the same values, FALSE if they do not.

i

index number of the DNS server to return

 
+
+

Returns

+

the IPv6 address of the DNS server at index i +.

+

[transfer none]

+
+
-

nm_ip6_route_get_dest ()

-
const struct in6_addr * nm_ip6_route_get_dest           (NMIP6Route *route);
-

-Gets the IPv6 destination address property of this route object. -

-
+

nm_setting_ip6_config_add_dns ()

+
gboolean
+nm_setting_ip6_config_add_dns (NMSettingIP6Config *setting,
+                               const struct in6_addr *dns);
+

Adds a new DNS server to the setting.

+
+

Parameters

+
--+++ - - + + + - - + + +

route :

the NMIP6Route -

setting

the NMSettingIP6Config

 

Returns :

the IPv6 address of destination. [array fixed-size=16][element-type guint8][transfer none] -

dns

the IPv6 address of the DNS server to add

 
+
+

Returns

+

TRUE if the DNS server was added; FALSE if the server was already +known

+

+
+
-

nm_ip6_route_set_dest ()

-
void                nm_ip6_route_set_dest               (NMIP6Route *route,
-                                                         const struct in6_addr *dest);
-

-Sets the IPv6 destination address property of this route object. -

-
+

nm_setting_ip6_config_remove_dns ()

+
void
+nm_setting_ip6_config_remove_dns (NMSettingIP6Config *setting,
+                                  guint32 i);
+

Removes the DNS server at index i +.

+
+

Parameters

+
--+++ - - + + + - - + + +

route :

the NMIP6Route -

setting

the NMSettingIP6Config

 

dest :

the destination address

i

index number of the DNS server to remove

 
+
-

nm_ip6_route_get_prefix ()

-
guint32             nm_ip6_route_get_prefix             (NMIP6Route *route);
-

-Gets the IPv6 prefix (ie "32" or "64" etc) of this route. -

-
+

nm_setting_ip6_config_remove_dns_by_value ()

+
gboolean
+nm_setting_ip6_config_remove_dns_by_value
+                               (NMSettingIP6Config *setting,
+                                const struct in6_addr *dns);
+

Removes the DNS server at index i +.

+
+

Parameters

+
--+++ - - + + + - - + + +

route :

the NMIP6Route -

setting

the NMSettingIP6Config

 

Returns :

the IPv6 prefix

dns

the IPv6 address of the DNS server to remove

 
+
+

Returns

+

TRUE if the DNS server was found and removed; FALSE if it was not.

+

+
+

Since 0.9.10

+
-

nm_ip6_route_set_prefix ()

-
void                nm_ip6_route_set_prefix             (NMIP6Route *route,
-                                                         guint32 prefix);
-

-Sets the IPv6 prefix of this route. -

-
+

nm_setting_ip6_config_clear_dns ()

+
void
+nm_setting_ip6_config_clear_dns (NMSettingIP6Config *setting);
+

Removes all configured DNS servers.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

route :

the NMIP6Route -

prefix :

the prefix, a number between 1 and 128 inclusive

setting

the NMSettingIP6Config

 
+
-

nm_ip6_route_get_next_hop ()

-
const struct in6_addr * nm_ip6_route_get_next_hop       (NMIP6Route *route);
-

-Gets the IPv6 address of the next hop of this route. -

-
+

nm_setting_ip6_config_get_num_dns_searches ()

+
guint32
+nm_setting_ip6_config_get_num_dns_searches
+                               (NMSettingIP6Config *setting);
+
+

Parameters

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

setting

the NMSettingIP6Config

 
+
+
+

Returns

+

the number of configured DNS search domains

+

+
+ +
+
+

nm_setting_ip6_config_get_dns_search ()

+
const char *
+nm_setting_ip6_config_get_dns_search (NMSettingIP6Config *setting,
+                                      guint32 i);
+
+

Parameters

+
--+++ - - + + + - - + + +

route :

the NMIP6Route -

setting

the NMSettingIP6Config

 

Returns :

the IPv6 address of next hop. [array fixed-size=16][element-type guint8][transfer none] -

i

index number of the DNS search domain to return

 
+
+

Returns

+

the DNS search domain at index i +

+

+
+

-

nm_ip6_route_set_next_hop ()

-
void                nm_ip6_route_set_next_hop           (NMIP6Route *route,
-                                                         const struct in6_addr *next_hop);
-

-Sets the IPv6 address of the next hop of this route. -

-
+

nm_setting_ip6_config_add_dns_search ()

+
gboolean
+nm_setting_ip6_config_add_dns_search (NMSettingIP6Config *setting,
+                                      const char *dns_search);
+

Adds a new DNS search domain to the setting.

+
+

Parameters

+
--+++ - - + + + - - + + +

route :

the NMIP6Route -

setting

the NMSettingIP6Config

 

next_hop :

the IPv6 address of the next hop

dns_search

the search domain to add

 
+
+

Returns

+

TRUE if the DNS search domain was added; FALSE if the search +domain was already known

+

+
+
-

nm_ip6_route_get_metric ()

-
guint32             nm_ip6_route_get_metric             (NMIP6Route *route);
-

-Gets the route metric property of this route object; lower values indicate -"better" or more preferred routes. -

-
+

nm_setting_ip6_config_remove_dns_search ()

+
void
+nm_setting_ip6_config_remove_dns_search
+                               (NMSettingIP6Config *setting,
+                                guint32 i);
+

Removes the DNS search domain at index i +.

+
+

Parameters

+
--+++ - - + + + - - + + +

route :

the NMIP6Route -

setting

the NMSettingIP6Config

 

Returns :

the route metric

i

index number of the DNS search domain

 
+
-

nm_ip6_route_set_metric ()

-
void                nm_ip6_route_set_metric             (NMIP6Route *route,
-                                                         guint32 metric);
-

-Sets the route metric property of this route object; lower values indicate -"better" or more preferred routes. -

-
+

nm_setting_ip6_config_remove_dns_search_by_value ()

+
gboolean
+nm_setting_ip6_config_remove_dns_search_by_value
+                               (NMSettingIP6Config *setting,
+                                const char *dns_search);
+

Removes the DNS search domain dns_search +.

+
+

Parameters

+
--+++ - - + + + - - + + +

route :

the NMIP6Route -

setting

the NMSettingIP6Config

 

metric :

the route metric

dns_search

the search domain to remove

 
-
-
-

NMSettingIP6Config

-
typedef struct _NMSettingIP6Config NMSettingIP6Config;
-

-

+
+

Returns

+

TRUE if the DNS search domain was found and removed; FALSE if it was not.

+

Since 0.9.10

+

-
-
-

NMSettingIP6ConfigClass

-
typedef struct {
-	NMSettingClass parent;
-
-	/* Padding for future expansion */
-	void (*_reserved1) (void);
-	void (*_reserved2) (void);
-	void (*_reserved3) (void);
-	void (*_reserved4) (void);
-} NMSettingIP6ConfigClass;
-
-

-


-

nm_setting_ip6_config_new ()

-
NMSetting *         nm_setting_ip6_config_new           (void);
-

-Creates a new NMSettingIP6Config object with default values. -

-
+

nm_setting_ip6_config_clear_dns_searches ()

+
void
+nm_setting_ip6_config_clear_dns_searches
+                               (NMSettingIP6Config *setting);
+

Removes all configured DNS search domains.

+
+

Parameters

+
--+++ - - + + +

Returns :

the new empty NMSettingIP6Config object. [transfer full] -

setting

the NMSettingIP6Config

 
+

-

nm_setting_ip6_config_get_method ()

-
const char *        nm_setting_ip6_config_get_method    (NMSettingIP6Config *setting);
-
+

nm_setting_ip6_config_get_num_addresses ()

+
guint32
+nm_setting_ip6_config_get_num_addresses
+                               (NMSettingIP6Config *setting);
+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSettingIP6Config -

Returns :

the "method" property of the setting

setting

the NMSettingIP6Config

 
+
+

Returns

+

the number of configured addresses

+

+
+
-

nm_setting_ip6_config_get_num_dns ()

-
guint32             nm_setting_ip6_config_get_num_dns   (NMSettingIP6Config *setting);
-
+

nm_setting_ip6_config_get_address ()

+
NMIP6Address *
+nm_setting_ip6_config_get_address (NMSettingIP6Config *setting,
+                                   guint32 i);
+
+

Parameters

+
--+++ - - + + + - - + + +

setting :

the NMSettingIP6Config -

setting

the NMSettingIP6Config

 

Returns :

the number of configured DNS servers

i

index number of the address to return

 
+
+

Returns

+

the address at index i +

+

+
+
-

nm_setting_ip6_config_get_dns ()

-
const struct in6_addr * nm_setting_ip6_config_get_dns   (NMSettingIP6Config *setting,
-                                                         guint32 i);
-
+

nm_setting_ip6_config_add_address ()

+
gboolean
+nm_setting_ip6_config_add_address (NMSettingIP6Config *setting,
+                                   NMIP6Address *address);
+

Adds a new IPv6 address and associated information to the setting. The +given address is duplicated internally and is not changed by this function.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + +

setting :

the NMSettingIP6Config -

i :

index number of the DNS server to return

setting

the NMSettingIP6Config

 

Returns :

the IPv6 address of the DNS server at index i. [transfer none] -

address

the new address to add

 
+
+

Returns

+

TRUE if the address was added; FALSE if the address was already +known.

+

+
+
-

nm_setting_ip6_config_add_dns ()

-
gboolean            nm_setting_ip6_config_add_dns       (NMSettingIP6Config *setting,
-                                                         const struct in6_addr *dns);
-

-Adds a new DNS server to the setting. -

-
+

nm_setting_ip6_config_remove_address ()

+
void
+nm_setting_ip6_config_remove_address (NMSettingIP6Config *setting,
+                                      guint32 i);
+

Removes the address at index i +.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + +

setting :

the NMSettingIP6Config -

dns :

the IPv6 address of the DNS server to add

setting

the NMSettingIP6Config

 

Returns :

-TRUE if the DNS server was added; FALSE if the server was already -known

i

index number of the address to remove

 
+
-

nm_setting_ip6_config_remove_dns ()

-
void                nm_setting_ip6_config_remove_dns    (NMSettingIP6Config *setting,
-                                                         guint32 i);
-

-Removes the DNS server at index i. -

-
+

nm_setting_ip6_config_remove_address_by_value ()

+
gboolean
+nm_setting_ip6_config_remove_address_by_value
+                               (NMSettingIP6Config *setting,
+                                NMIP6Address *address);
+

Removes the address address +.

+
+

Parameters

+
--+++ - - + + + - - + + +

setting :

the NMSettingIP6Config -

setting

the NMSettingIP6Config

 

i :

index number of the DNS server to remove

address

the address to remove

 
+
+

Returns

+

TRUE if the address was found and removed; FALSE if it was not.

+

+
+

Since 0.9.10

+
-

nm_setting_ip6_config_remove_dns_by_value ()

-
gboolean            nm_setting_ip6_config_remove_dns_by_value
-                                                        (NMSettingIP6Config *setting,
-                                                         const struct in6_addr *dns);
-

-Removes the DNS server at index i. -

-
+

nm_setting_ip6_config_clear_addresses ()

+
void
+nm_setting_ip6_config_clear_addresses (NMSettingIP6Config *setting);
+

Removes all configured addresses.

+
+

Parameters

+
--+++ - - - - - - - - - - - - - - + + + + +

setting :

the NMSettingIP6Config -

dns :

the IPv6 address of the DNS server to remove

Returns :

-TRUE if the DNS server was found and removed; FALSE if it was not.

setting

the NMSettingIP6Config

 
-

Since 0.9.10

+

-

nm_setting_ip6_config_clear_dns ()

-
void                nm_setting_ip6_config_clear_dns     (NMSettingIP6Config *setting);
-

-Removes all configured DNS servers. -

-
+

nm_setting_ip6_config_get_num_routes ()

+
guint32
+nm_setting_ip6_config_get_num_routes (NMSettingIP6Config *setting);
+
+

Parameters

+
--+++ - - + + +

setting :

the NMSettingIP6Config -

setting

the NMSettingIP6Config

 
+
+

Returns

+

the number of configured routes

+

+
+
-

nm_setting_ip6_config_get_num_dns_searches ()

-
guint32             nm_setting_ip6_config_get_num_dns_searches
-                                                        (NMSettingIP6Config *setting);
-
+

nm_setting_ip6_config_get_route ()

+
NMIP6Route *
+nm_setting_ip6_config_get_route (NMSettingIP6Config *setting,
+                                 guint32 i);
+
+

Parameters

+
--+++ - - + + + - - + + +

setting :

the NMSettingIP6Config -

setting

the NMSettingIP6Config

 

Returns :

the number of configured DNS search domains

i

index number of the route to return

 
+
+

Returns

+

the route at index i +

+

+
+
-

nm_setting_ip6_config_get_dns_search ()

-
const char *        nm_setting_ip6_config_get_dns_search
-                                                        (NMSettingIP6Config *setting,
-                                                         guint32 i);
-
+

nm_setting_ip6_config_add_route ()

+
gboolean
+nm_setting_ip6_config_add_route (NMSettingIP6Config *setting,
+                                 NMIP6Route *route);
+

Adds a new IPv6 route and associated information to the setting. The +given route is duplicated internally and is not changed by this function.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + +

setting :

the NMSettingIP6Config -

i :

index number of the DNS search domain to return

setting

the NMSettingIP6Config

 

Returns :

the DNS search domain at index i -

route

the route to add

 
+
+

Returns

+

TRUE if the route was added; FALSE if the route was already known.

+

+
+
-

nm_setting_ip6_config_add_dns_search ()

-
gboolean            nm_setting_ip6_config_add_dns_search
-                                                        (NMSettingIP6Config *setting,
-                                                         const char *dns_search);
-

-Adds a new DNS search domain to the setting. -

-
+

nm_setting_ip6_config_remove_route ()

+
void
+nm_setting_ip6_config_remove_route (NMSettingIP6Config *setting,
+                                    guint32 i);
+

Removes the route at index i +.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + +

setting :

the NMSettingIP6Config -

dns_search :

the search domain to add

setting

the NMSettingIP6Config

 

Returns :

-TRUE if the DNS search domain was added; FALSE if the search -domain was already known

i

index number of the route

 
+
-

nm_setting_ip6_config_remove_dns_search ()

-
void                nm_setting_ip6_config_remove_dns_search
-                                                        (NMSettingIP6Config *setting,
-                                                         guint32 i);
-

-Removes the DNS search domain at index i. -

-
+

nm_setting_ip6_config_remove_route_by_value ()

+
gboolean
+nm_setting_ip6_config_remove_route_by_value
+                               (NMSettingIP6Config *setting,
+                                NMIP6Route *route);
+

Removes the route route +.

+
+

Parameters

+
--+++ - - + + + - - + + +

setting :

the NMSettingIP6Config -

setting

the NMSettingIP6Config

 

i :

index number of the DNS search domain

route

the route to remove

 
+
+

Returns

+

TRUE if the route was found and removed; FALSE if it was not.

+

+
+

Since 0.9.10

+
-

nm_setting_ip6_config_remove_dns_search_by_value ()

-
gboolean            nm_setting_ip6_config_remove_dns_search_by_value
-                                                        (NMSettingIP6Config *setting,
-                                                         const char *dns_search);
-

-Removes the DNS search domain dns_search. -

-
+

nm_setting_ip6_config_clear_routes ()

+
void
+nm_setting_ip6_config_clear_routes (NMSettingIP6Config *setting);
+

Removes all configured routes.

+
+

Parameters

+
--+++ - - - - - - - - - - - - - - + + + + +

setting :

the NMSettingIP6Config -

dns_search :

the search domain to remove

Returns :

-TRUE if the DNS search domain was found and removed; FALSE if it was not. -Since 0.9.10

setting

the NMSettingIP6Config

 
+
-

nm_setting_ip6_config_clear_dns_searches ()

-
void                nm_setting_ip6_config_clear_dns_searches
-                                                        (NMSettingIP6Config *setting);
-

-Removes all configured DNS search domains. -

-
+

nm_setting_ip6_config_get_ignore_auto_routes ()

+
gboolean
+nm_setting_ip6_config_get_ignore_auto_routes
+                               (NMSettingIP6Config *setting);
+

Returns the value contained in the “ignore-auto-routes” +property.

+
+

Parameters

+
--+++ - - + + +

setting :

the NMSettingIP6Config -

setting

the NMSettingIP6Config

 
+
+

Returns

+

TRUE if automatically configured (ie via DHCP) routes should be +ignored.

+

+
+
-

nm_setting_ip6_config_get_num_addresses ()

-
guint32             nm_setting_ip6_config_get_num_addresses
-                                                        (NMSettingIP6Config *setting);
-
+

nm_setting_ip6_config_get_route_metric ()

+
gint64
+nm_setting_ip6_config_get_route_metric
+                               (NMSettingIP6Config *setting);
+

Returns the value contained in the “route-metric” +property.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSettingIP6Config -

Returns :

the number of configured addresses

setting

the NMSettingIP6Config

 
+
+

Returns

+

the route metric that is used for IPv6 routes that don't explicitly +specify a metric. See “route-metric” for more details.

+

+
+

Since 1.0

+
-

nm_setting_ip6_config_get_address ()

-
NMIP6Address *      nm_setting_ip6_config_get_address   (NMSettingIP6Config *setting,
-                                                         guint32 i);
-
+

nm_setting_ip6_config_get_ignore_auto_dns ()

+
gboolean
+nm_setting_ip6_config_get_ignore_auto_dns
+                               (NMSettingIP6Config *setting);
+

Returns the value contained in the “ignore-auto-dns” +property.

+
+

Parameters

+
--+++ - - - - - - - - - - - - - - + + + + +

setting :

the NMSettingIP6Config -

i :

index number of the address to return

Returns :

the address at index i -

setting

the NMSettingIP6Config

 
+
+

Returns

+

TRUE if automatically configured (ie via DHCP or router +advertisements) DNS information should be ignored.

+

+
+
-

nm_setting_ip6_config_add_address ()

-
gboolean            nm_setting_ip6_config_add_address   (NMSettingIP6Config *setting,
-                                                         NMIP6Address *address);
-

-Adds a new IPv6 address and associated information to the setting. The -given address is duplicated internally and is not changed by this function. -

-
+

nm_setting_ip6_config_get_dhcp_hostname ()

+
const char *
+nm_setting_ip6_config_get_dhcp_hostname
+                               (NMSettingIP6Config *setting);
+

Returns the value contained in the “dhcp-hostname” +property.

+
+

Parameters

+
--+++ - - - - - - - - - - - - - - + + + + +

setting :

the NMSettingIP6Config -

address :

the new address to add

Returns :

-TRUE if the address was added; FALSE if the address was already -known.

setting

the NMSettingIP6Config

 
+
+

Returns

+

the configured hostname to send to the DHCP server

+

+
+

Since 0.9.8

+
-

nm_setting_ip6_config_remove_address ()

-
void                nm_setting_ip6_config_remove_address
-                                                        (NMSettingIP6Config *setting,
-                                                         guint32 i);
-

-Removes the address at index i. -

-
+

nm_setting_ip6_config_get_never_default ()

+
gboolean
+nm_setting_ip6_config_get_never_default
+                               (NMSettingIP6Config *setting);
+

Returns the value contained in the “never-default” +property.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSettingIP6Config -

i :

index number of the address to remove

setting

the NMSettingIP6Config

 
+
+

Returns

+

TRUE if this connection should never be the default connection +for IPv6 addressing

+

+
+
-

nm_setting_ip6_config_remove_address_by_value ()

-
gboolean            nm_setting_ip6_config_remove_address_by_value
-                                                        (NMSettingIP6Config *setting,
-                                                         NMIP6Address *address);
-

-Removes the address address. -

-
+

nm_setting_ip6_config_get_may_fail ()

+
gboolean
+nm_setting_ip6_config_get_may_fail (NMSettingIP6Config *setting);
+

Returns the value contained in the “may-fail” +property.

+
+

Parameters

+
--+++ - - - - - - - - - - - - - - + + + + +

setting :

the NMSettingIP6Config -

address :

the address to remove

Returns :

-TRUE if the address was found and removed; FALSE if it was not.

setting

the NMSettingIP6Config

 
-

Since 0.9.10

+
+
+

Returns

+

TRUE if this connection doesn't require IPv6 addressing to complete +for the connection to succeed.

+

+

-

nm_setting_ip6_config_clear_addresses ()

-
void                nm_setting_ip6_config_clear_addresses
-                                                        (NMSettingIP6Config *setting);
-

-Removes all configured addresses. -

-
+

nm_setting_ip6_config_get_ip6_privacy ()

+
NMSettingIP6ConfigPrivacy
+nm_setting_ip6_config_get_ip6_privacy (NMSettingIP6Config *setting);
+

Returns the value contained in the “ip6-privacy” +property.

+
+

Parameters

+
--+++ - - + + +

setting :

the NMSettingIP6Config -

setting

the NMSettingIP6Config

 
+
+

Returns

+

IPv6 Privacy Extensions configuration value (NMSettingIP6ConfigPrivacy).

+

+
+ + +
+

Types and Values

+
+

NM_SETTING_IP6_CONFIG_SETTING_NAME

+
#define NM_SETTING_IP6_CONFIG_SETTING_NAME "ipv6"
+
+

+

+

-

nm_setting_ip6_config_get_num_routes ()

-
guint32             nm_setting_ip6_config_get_num_routes
-                                                        (NMSettingIP6Config *setting);
-
+

enum NMSettingIP6ConfigError

+
+

Members

+
--+++ - - + + - - - - -

setting :

the NMSettingIP6Config +

NM_SETTING_IP6_CONFIG_ERROR_UNKNOWN

+

unknown or unclassified error

 

Returns :

the number of configured routes
-
-
-
-

nm_setting_ip6_config_get_route ()

-
NMIP6Route *        nm_setting_ip6_config_get_route     (NMSettingIP6Config *setting,
-                                                         guint32 i);
-
---- - - - - + + - - + + + - - + +

setting :

the NMSettingIP6Config +

NM_SETTING_IP6_CONFIG_ERROR_INVALID_PROPERTY

+

the property was invalid

 

i :

index number of the route to return

NM_SETTING_IP6_CONFIG_ERROR_MISSING_PROPERTY

+

the property was missing and is +required

+
 

Returns :

the route at index i +

NM_SETTING_IP6_CONFIG_ERROR_NOT_ALLOWED_FOR_METHOD

+

the property's value is +not valid with the given IPv6 method

 
+

-

nm_setting_ip6_config_add_route ()

-
gboolean            nm_setting_ip6_config_add_route     (NMSettingIP6Config *setting,
-                                                         NMIP6Route *route);
+

NM_SETTING_IP6_CONFIG_ERROR

+
#define NM_SETTING_IP6_CONFIG_ERROR nm_setting_ip6_config_error_quark ()
+

-Adds a new IPv6 route and associated information to the setting. The -given route is duplicated internally and is not changed by this function.

-
---- - - - - - - - - - - - - - - -

setting :

the NMSettingIP6Config -

route :

the route to add

Returns :

-TRUE if the route was added; FALSE if the route was already known.

-

nm_setting_ip6_config_remove_route ()

-
void                nm_setting_ip6_config_remove_route  (NMSettingIP6Config *setting,
-                                                         guint32 i);
+

NM_SETTING_IP6_CONFIG_METHOD

+
#define NM_SETTING_IP6_CONFIG_METHOD             "method"
+

-Removes the route at index i.

-
---- - - - - - - - - - - -

setting :

the NMSettingIP6Config -

i :

index number of the route

-

nm_setting_ip6_config_remove_route_by_value ()

-
gboolean            nm_setting_ip6_config_remove_route_by_value
-                                                        (NMSettingIP6Config *setting,
-                                                         NMIP6Route *route);
+

NM_SETTING_IP6_CONFIG_DNS

+
#define NM_SETTING_IP6_CONFIG_DNS                "dns"
+

-Removes the route route.

-
---- - - - - - - - - - - - - - - -

setting :

the NMSettingIP6Config -

route :

the route to remove

Returns :

-TRUE if the route was found and removed; FALSE if it was not.
-

Since 0.9.10


-

nm_setting_ip6_config_clear_routes ()

-
void                nm_setting_ip6_config_clear_routes  (NMSettingIP6Config *setting);
+

NM_SETTING_IP6_CONFIG_DNS_SEARCH

+
#define NM_SETTING_IP6_CONFIG_DNS_SEARCH         "dns-search"
+

-Removes all configured routes.

-
---- - - - - -

setting :

the NMSettingIP6Config -

-

nm_setting_ip6_config_get_ignore_auto_routes ()

-
gboolean            nm_setting_ip6_config_get_ignore_auto_routes
-                                                        (NMSettingIP6Config *setting);
+

NM_SETTING_IP6_CONFIG_ADDRESSES

+
#define NM_SETTING_IP6_CONFIG_ADDRESSES          "addresses"
+

-Returns the value contained in the "ignore-auto-routes" -property.

-
---- - - - - - - - - - - -

setting :

the NMSettingIP6Config -

Returns :

-TRUE if automatically configured (ie via DHCP) routes should be -ignored.

-

nm_setting_ip6_config_get_route_metric ()

-
gint64              nm_setting_ip6_config_get_route_metric
-                                                        (NMSettingIP6Config *setting);
+

NM_SETTING_IP6_CONFIG_ROUTES

+
#define NM_SETTING_IP6_CONFIG_ROUTES             "routes"
+

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

-
---- - - - - - - - - - - -

setting :

the NMSettingIP6Config -

Returns :

the route metric that is used for IPv6 routes that don't explicitly -specify a metric. See "route-metric" for more details.
-

Since 1.0


-

nm_setting_ip6_config_get_ignore_auto_dns ()

-
gboolean            nm_setting_ip6_config_get_ignore_auto_dns
-                                                        (NMSettingIP6Config *setting);
+

NM_SETTING_IP6_CONFIG_ROUTE_METRIC

+
#define NM_SETTING_IP6_CONFIG_ROUTE_METRIC       "route-metric"
+

-Returns the value contained in the "ignore-auto-dns" -property.

-
---- - - - - - - - - - - -

setting :

the NMSettingIP6Config -

Returns :

-TRUE if automatically configured (ie via DHCP or router -advertisements) DNS information should be ignored.

-

nm_setting_ip6_config_get_dhcp_hostname ()

-
const char *        nm_setting_ip6_config_get_dhcp_hostname
-                                                        (NMSettingIP6Config *setting);
+

NM_SETTING_IP6_CONFIG_IGNORE_AUTO_ROUTES

+
#define NM_SETTING_IP6_CONFIG_IGNORE_AUTO_ROUTES "ignore-auto-routes"
+

-Returns the value contained in the "dhcp-hostname" -property.

-
---- - - - - - - - - - - -

setting :

the NMSettingIP6Config -

Returns :

the configured hostname to send to the DHCP server
-

Since 0.9.8


-

nm_setting_ip6_config_get_never_default ()

-
gboolean            nm_setting_ip6_config_get_never_default
-                                                        (NMSettingIP6Config *setting);
+

NM_SETTING_IP6_CONFIG_IGNORE_AUTO_DNS

+
#define NM_SETTING_IP6_CONFIG_IGNORE_AUTO_DNS    "ignore-auto-dns"
+

-Returns the value contained in the "never-default" -property.

-
---- - - - - - - - - - - -

setting :

the NMSettingIP6Config -

Returns :

-TRUE if this connection should never be the default connection -for IPv6 addressing

-

nm_setting_ip6_config_get_may_fail ()

-
gboolean            nm_setting_ip6_config_get_may_fail  (NMSettingIP6Config *setting);
+

NM_SETTING_IP6_CONFIG_NEVER_DEFAULT

+
#define NM_SETTING_IP6_CONFIG_NEVER_DEFAULT      "never-default"
+

-Returns the value contained in the "may-fail" -property.

-
---- - - - - - - - - - - -

setting :

the NMSettingIP6Config -

Returns :

-TRUE if this connection doesn't require IPv6 addressing to complete -for the connection to succeed.

-

nm_setting_ip6_config_get_ip6_privacy ()

-
NMSettingIP6ConfigPrivacy nm_setting_ip6_config_get_ip6_privacy
-                                                        (NMSettingIP6Config *setting);
+

NM_SETTING_IP6_CONFIG_MAY_FAIL

+
#define NM_SETTING_IP6_CONFIG_MAY_FAIL           "may-fail"
+
+

+

+
+
+
+

NM_SETTING_IP6_CONFIG_IP6_PRIVACY

+
#define NM_SETTING_IP6_CONFIG_IP6_PRIVACY        "ip6-privacy"
+
+

+

+
+
+
+

NM_SETTING_IP6_CONFIG_DHCP_HOSTNAME

+
#define NM_SETTING_IP6_CONFIG_DHCP_HOSTNAME      "dhcp-hostname"
+

-Returns the value contained in the "ip6-privacy" -property.

-
+ +
+
+

NM_SETTING_IP6_CONFIG_METHOD_IGNORE

+
#define NM_SETTING_IP6_CONFIG_METHOD_IGNORE     "ignore"
+
+

IPv6 is not required or is handled by some other mechanism, and NetworkManager +should not configure IPv6 for this connection.

+
+
+
+

NM_SETTING_IP6_CONFIG_METHOD_AUTO

+
#define NM_SETTING_IP6_CONFIG_METHOD_AUTO       "auto"
+
+

IPv6 configuration should be automatically determined via a method appropriate +for the hardware interface, ie router advertisements, DHCP, or PPP or some +other device-specific manner.

+
+
+
+

NM_SETTING_IP6_CONFIG_METHOD_DHCP

+
#define NM_SETTING_IP6_CONFIG_METHOD_DHCP       "dhcp"
+
+

IPv6 configuration should be automatically determined via DHCPv6 only and +router advertisements should be ignored.

+
+
+
+

NM_SETTING_IP6_CONFIG_METHOD_LINK_LOCAL

+
#define NM_SETTING_IP6_CONFIG_METHOD_LINK_LOCAL "link-local"
+
+

IPv6 configuration should be automatically configured for link-local-only +operation.

+
+
+
+

NM_SETTING_IP6_CONFIG_METHOD_MANUAL

+
#define NM_SETTING_IP6_CONFIG_METHOD_MANUAL     "manual"
+
+

All necessary IPv6 configuration (addresses, prefix, DNS, etc) is specified +in the setting's properties.

+
+
+
+

NM_SETTING_IP6_CONFIG_METHOD_SHARED

+
#define NM_SETTING_IP6_CONFIG_METHOD_SHARED     "shared"
+
+

This connection specifies configuration that allows other computers to +connect through it to the default network (usually the Internet). The +connection's interface will be assigned a private address, and router +advertisements, a caching DNS server, and Network Address Translation (NAT) +functionality will be started on this connection's interface to allow other +devices to connect through that interface to the default network. (not yet +supported for IPv6)

+
+
+
+

enum NMSettingIP6ConfigPrivacy

+

NMSettingIP6ConfigPrivacy values indicate if and how IPv6 Privacy +Extensions are used (RFC4941).

+
+

Members

+
--+++ - - + + - - + + + + + + + + + + + + +

setting :

the NMSettingIP6Config +

NM_SETTING_IP6_CONFIG_PRIVACY_UNKNOWN

+

unknown or no value specified

 

Returns :

IPv6 Privacy Extensions configuration value (NMSettingIP6ConfigPrivacy).

NM_SETTING_IP6_CONFIG_PRIVACY_DISABLED

+

IPv6 Privacy Extensions are disabled

+
 

NM_SETTING_IP6_CONFIG_PRIVACY_PREFER_PUBLIC_ADDR

+

IPv6 Privacy Extensions +are enabled, but public addresses are preferred over temporary addresses

+
 

NM_SETTING_IP6_CONFIG_PRIVACY_PREFER_TEMP_ADDR

+

IPv6 Privacy Extensions +are enabled and temporary addresses are preferred over public addresses

+
 
+

Property Details

-

The "addresses" property

-
  "addresses"                GPtrArray_GValueArray_GArray_guchar_+guint+GArray_guchar___*  : Read / Write
-

-Array of IPv6 address structures. Each IPv6 address structure is -composed of 3 members, the first being a byte array containing the IPv6 -address (network byte order), the second a 32-bit integer containing the -IPv6 address prefix, and the third a byte array containing the IPv6 -address (network byte order) of the gateway associated with this address, -if any. If no gateway is given, the third element should be given as all -zeros. For the "auto" method, given IP addresses are appended to those -returned by automatic configuration. Addresses cannot be used with the -"shared" or "link-local" methods as the interface is automatically -assigned an address with these methods. -

+

The “addresses” property

+
  “addresses”                GPtrArray_GValueArray_GArray_guchar_+guint+GArray_guchar___*
+

+

Flags: Read / Write


-

The "dhcp-hostname" property

-
  "dhcp-hostname"            gchar*                : Read / Write
-

-The specified name will be sent to the DHCP server when acquiring a -lease. -

+

The “dhcp-hostname” property

+
  “dhcp-hostname”            gchar *
+

+

Flags: Read / Write

Default value: NULL

Since 0.9.8


-

The "dns" property

-
  "dns"                      GPtrArray_GArray_guchar__*  : Read / Write
-

-Array of DNS servers, where each member of the array is a byte array -containing the IPv6 address of the DNS server (in network byte order). -For the "auto" method, these DNS servers are appended to those (if any) -returned by automatic configuration. DNS servers cannot be used with the -"shared" or "link-local" methods as there is no usptream network. In all -other methods, these DNS servers are used as the only DNS servers for -this connection. -

+

The “dns” property

+
  “dns”                      GPtrArray_GArray_guchar__ *
+

+

Flags: Read / Write


-

The "dns-search" property

-
  "dns-search"               GSList_gchararray_*   : Read / Write
-

-List of DNS search domains. For the "auto" method, these search domains -are appended to those returned by automatic configuration. Search domains -cannot be used with the "shared" or "link-local" methods as there is no -upstream network. In all other methods, these search domains are used as -the only search domains for this connection. -

+

The “dns-search” property

+
  “dns-search”               GSList_gchararray_ *
+

+

Flags: Read / Write


-

The "ignore-auto-dns" property

-
  "ignore-auto-dns"          gboolean              : Read / Write / Construct
-

-When the method is set to "auto" or "dhcp" and this property is set to -TRUE, automatically configured nameservers and search domains are -ignored and only nameservers and search domains specified in the -"dns" and "dns-search" properties, if -any, are used. -

+

The “ignore-auto-dns” property

+
  “ignore-auto-dns”          gboolean
+

+

Flags: Read / Write / Construct

Default value: FALSE


-

The "ignore-auto-routes" property

-
  "ignore-auto-routes"       gboolean              : Read / Write / Construct
-

-When the method is set to "auto" or "dhcp" and this property is set to -TRUE, automatically configured routes are ignored and only routes -specified in the "routes" property, if any, are used. -

+

The “ignore-auto-routes” property

+
  “ignore-auto-routes”       gboolean
+

+

Flags: Read / Write / Construct

Default value: FALSE


-

The "ip6-privacy" property

-
  "ip6-privacy"              gint                  : Read / Write / Construct
-

-Configure IPv6 Privacy Extensions for SLAAC, described in RFC4941. If -enabled, it makes the kernel generate a temporary IPv6 address in -addition to the public one generated from MAC address via modified -EUI-64. This enhances privacy, but could cause problems in some -applications, on the other hand. The permitted values are: 0: disabled, -1: enabled (prefer public address), 2: enabled (prefer temporary -addresses). -

+

The “ip6-privacy” property

+
  “ip6-privacy”              gint
+

+

Flags: Read / Write / Construct

Allowed values: [-1,2]

Default value: -1


-

The "may-fail" property

-
  "may-fail"                 gboolean              : Read / Write / Construct
-

-If TRUE, allow overall network configuration to proceed even if IPv6 -configuration times out. Note that at least one IP configuration must -succeed or overall network configuration will still fail. For example, -in IPv4-only networks, setting this property to TRUE allows the overall -network configuration to succeed if IPv6 configuration fails but IPv4 -configuration completes successfully. -

+

The “may-fail” property

+
  “may-fail”                 gboolean
+

+

Flags: Read / Write / Construct

Default value: TRUE


-

The "method" property

-
  "method"                   gchar*                : Read / Write
-

-IPv6 configuration method. If "auto" is specified then the appropriate -automatic method (PPP, router advertisement, etc) is used for the device -and most other properties can be left unset. To force the use of DHCP -only, specify "dhcp"; this method is only valid for Ethernet- based -hardware. If "link-local" is specified, then an IPv6 link-local address -will be assigned to the interface. If "manual" is specified, static IP -addressing is used and at least one IP address must be given in the -"addresses" property. If "ignore" is specified, IPv6 configuration is -not done. This property must be set. Note: the "shared" method is not -yet supported. -

+

The “method” property

+
  “method”                   gchar *
+

+

Flags: Read / Write

Default value: NULL


-

The "never-default" property

-
  "never-default"            gboolean              : Read / Write / Construct
-

-If TRUE, this connection will never be the default IPv6 connection, -meaning it will never be assigned the default IPv6 route by -NetworkManager. -

+

The “never-default” property

+
  “never-default”            gboolean
+

+

Flags: Read / Write / Construct

Default value: FALSE


-

The "route-metric" property

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

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

+

The “route-metric” property

+
  “route-metric”             gint64
+

+

Flags: Read / Write / Construct

Allowed values: [-1,4294967295]

Default value: -1

Since 1.0


-

The "routes" property

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

-Array of IPv6 route structures. Each IPv6 route structure is composed of -4 members; the first being the destination IPv6 network or address -(network byte order) as a byte array, the second the destination network -or address IPv6 prefix, the third being the next-hop IPv6 address -(network byte order) if any, and the fourth being the route metric. For -the "auto" method, given IP routes are appended to those returned by -automatic configuration. Routes cannot be used with the "shared" or -"link-local" methods because there is no upstream network. -

+

The “routes” property

+
  “routes”                   GPtrArray_GValueArray_GArray_guchar_+guint+GArray_guchar_+guint__*
+

+

Flags: Read / Write

+ Generated by GTK-Doc V1.21 \ No newline at end of file diff --git a/docs/libnm-util/html/NMSettingInfiniband.html b/docs/libnm-util/html/NMSettingInfiniband.html index dc3eb350..f61fe6f7 100644 --- a/docs/libnm-util/html/NMSettingInfiniband.html +++ b/docs/libnm-util/html/NMSettingInfiniband.html @@ -2,34 +2,28 @@ -NMSettingInfiniband +libnm-util Reference Manual: NMSettingInfiniband - + - - - - - - - - - - + + + + + + +
@@ -37,399 +31,478 @@

NMSettingInfiniband

NMSettingInfiniband — Describes connection properties for IP-over-InfiniBand networks

- +
- -
-

Object Hierarchy

-
-  GEnum
-   +----NMSettingInfinibandError
-
-
-  GObject
-   +----NMSetting
-         +----NMSettingInfiniband
-
-
-

Properties

-
-  "mac-address"              GArray_guchar_*       : Read / Write
-  "mtu"                      guint                 : Read / Write / Construct
-  "p-key"                    gint                  : Read / Write / Construct
-  "parent"                   gchar*                : Read / Write / Construct
-  "transport-mode"           gchar*                : Read / Write / Construct
-
-
-
-

Description

-

-The NMSettingInfiniband object is a NMSetting subclass that describes properties -necessary for connection to IP-over-InfiniBand networks. -

-
-
-

Details

-
-

NM_SETTING_INFINIBAND_SETTING_NAME

-
#define NM_SETTING_INFINIBAND_SETTING_NAME "infiniband"
-
-

-

-
-
-
-

enum NMSettingInfinibandError

-
typedef enum {
-	NM_SETTING_INFINIBAND_ERROR_UNKNOWN = 0,      /*< nick=UnknownError >*/
-	NM_SETTING_INFINIBAND_ERROR_INVALID_PROPERTY, /*< nick=InvalidProperty >*/
-	NM_SETTING_INFINIBAND_ERROR_MISSING_PROPERTY  /*< nick=MissingProperty >*/
-} NMSettingInfinibandError;
-
-
+

Functions

+
--++ - - + - - + - - + + + + + + + + + + + + + + + + +

NM_SETTING_INFINIBAND_ERROR_UNKNOWN

unknown or unclassified error + +GQuark + +nm_setting_infiniband_error_quark ()

NM_SETTING_INFINIBAND_ERROR_INVALID_PROPERTY

the property was invalid + +NMSetting * + +nm_setting_infiniband_new ()

NM_SETTING_INFINIBAND_ERROR_MISSING_PROPERTY

the property was missing and is -required +const GByteArray * + +nm_setting_infiniband_get_mac_address () +
+guint32 + +nm_setting_infiniband_get_mtu () +
const char * + +nm_setting_infiniband_get_transport_mode () +
+int + +nm_setting_infiniband_get_p_key () +
const char * + +nm_setting_infiniband_get_parent ()
-
-
-

NM_SETTING_INFINIBAND_ERROR

-
#define NM_SETTING_INFINIBAND_ERROR nm_setting_infiniband_error_quark ()
-
-

-

+
+

Properties

+
+++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+GArray_guchar_ *mac-addressRead / Write
guintmtuRead / Write / Construct
gintp-keyRead / Write / Construct
+gchar *parentRead / Write / Construct
+gchar *transport-modeRead / Write / Construct
-
-
-

nm_setting_infiniband_error_quark ()

-
GQuark              nm_setting_infiniband_error_quark   (void);
-

-Registers an error quark for NMSettingInfiniband if necessary. -

-
+
+

Types and Values

+
--++ - - - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Returns :

the error quark used for NMSettingInfiniband errors.
#defineNM_SETTING_INFINIBAND_SETTING_NAME
enumNMSettingInfinibandError
#defineNM_SETTING_INFINIBAND_ERROR
#defineNM_SETTING_INFINIBAND_MAC_ADDRESS
#defineNM_SETTING_INFINIBAND_MTU
#defineNM_SETTING_INFINIBAND_TRANSPORT_MODE
#defineNM_SETTING_INFINIBAND_P_KEY
#defineNM_SETTING_INFINIBAND_PARENT
-
-
-

NM_SETTING_INFINIBAND_MAC_ADDRESS

-
#define NM_SETTING_INFINIBAND_MAC_ADDRESS    "mac-address"
+
+

Object Hierarchy

+
    GEnum
+    ╰── NMSettingInfinibandError
+    GObject
+    ╰── NMSetting
+        ╰── NMSettingInfiniband
 
-

-

-
-
-

NM_SETTING_INFINIBAND_MTU

-
#define NM_SETTING_INFINIBAND_MTU            "mtu"
+
+

Includes

+
#include <nm-setting-infiniband.h>
 
-

-

-
-
-

NM_SETTING_INFINIBAND_TRANSPORT_MODE

-
#define NM_SETTING_INFINIBAND_TRANSPORT_MODE "transport-mode"
-
-

-

+
+

Description

+

The NMSettingInfiniband object is a NMSetting subclass that describes properties +necessary for connection to IP-over-InfiniBand networks.

-
+
+

Functions

-

NM_SETTING_INFINIBAND_P_KEY

-
#define NM_SETTING_INFINIBAND_P_KEY          "p-key"
-
-

-

+

nm_setting_infiniband_error_quark ()

+
GQuark
+nm_setting_infiniband_error_quark (void);
+

Registers an error quark for NMSettingInfiniband if necessary.

+
+

Returns

+

the error quark used for NMSettingInfiniband errors.

+

+

-

NM_SETTING_INFINIBAND_PARENT

-
#define NM_SETTING_INFINIBAND_PARENT         "parent"
-
-

-

+

nm_setting_infiniband_new ()

+
NMSetting *
+nm_setting_infiniband_new (void);
+

Creates a new NMSettingInfiniband object with default values.

+
+

Returns

+

the new empty NMSettingInfiniband object.

+

[transfer full]

+

-

NMSettingInfiniband

-
typedef struct _NMSettingInfiniband NMSettingInfiniband;
-

-

+

nm_setting_infiniband_get_mac_address ()

+
const GByteArray *
+nm_setting_infiniband_get_mac_address (NMSettingInfiniband *setting);
+
+

Parameters

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

setting

the NMSettingInfiniband

 
+
+
+

Returns

+

the “mac-address” property of the setting

+

+

-

NMSettingInfinibandClass

-
typedef struct {
-	NMSettingClass parent;
-
-	/* Padding for future expansion */
-	void (*_reserved1) (void);
-	void (*_reserved2) (void);
-	void (*_reserved3) (void);
-	void (*_reserved4) (void);
-} NMSettingInfinibandClass;
-
-

-

+

nm_setting_infiniband_get_mtu ()

+
guint32
+nm_setting_infiniband_get_mtu (NMSettingInfiniband *setting);
+
+

Parameters

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

setting

the NMSettingInfiniband

 
+
+
+

Returns

+

the “mtu” property of the setting

+

+

-

nm_setting_infiniband_new ()

-
NMSetting *         nm_setting_infiniband_new           (void);
-

-Creates a new NMSettingInfiniband object with default values. -

-
+

nm_setting_infiniband_get_transport_mode ()

+
const char *
+nm_setting_infiniband_get_transport_mode
+                               (NMSettingInfiniband *setting);
+

Returns the transport mode for this device. Either 'datagram' or +'connected'.

+
+

Parameters

+
--+++ - - + + +

Returns :

the new empty NMSettingInfiniband object. [transfer full] -

setting

the NMSettingInfiniband

 
+
+

Returns

+

the IPoIB transport mode

+

+
+

-

nm_setting_infiniband_get_mac_address ()

-
const GByteArray *  nm_setting_infiniband_get_mac_address
-                                                        (NMSettingInfiniband *setting);
-
+

nm_setting_infiniband_get_p_key ()

+
int
+nm_setting_infiniband_get_p_key (NMSettingInfiniband *setting);
+

Returns the P_Key to use for this device. A value of -1 means to +use the default P_Key (aka "the P_Key at index 0"). Otherwise it is +a 16-bit unsigned integer.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSettingInfiniband -

Returns :

the "mac-address" property of the setting

setting

the NMSettingInfiniband

 
+
+

Returns

+

the IPoIB P_Key

+

+
+

-

nm_setting_infiniband_get_mtu ()

-
guint32             nm_setting_infiniband_get_mtu       (NMSettingInfiniband *setting);
-
+

nm_setting_infiniband_get_parent ()

+
const char *
+nm_setting_infiniband_get_parent (NMSettingInfiniband *setting);
+

Returns the parent interface name for this device, if set.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSettingInfiniband -

Returns :

the "mtu" property of the setting

setting

the NMSettingInfiniband

 
-
+
+

Returns

+

the parent interface name

+

+
+
+
+
+

Types and Values

-

nm_setting_infiniband_get_transport_mode ()

-
const char *        nm_setting_infiniband_get_transport_mode
-                                                        (NMSettingInfiniband *setting);
+

NM_SETTING_INFINIBAND_SETTING_NAME

+
#define NM_SETTING_INFINIBAND_SETTING_NAME "infiniband"
+

-Returns the transport mode for this device. Either 'datagram' or -'connected'.

-
+ +
+
+

enum NMSettingInfinibandError

+
+

Members

+
--+++ - - + + - - + + + + + + + +

setting :

the NMSettingInfiniband +

NM_SETTING_INFINIBAND_ERROR_UNKNOWN

+

unknown or unclassified error

 

Returns :

the IPoIB transport mode

NM_SETTING_INFINIBAND_ERROR_INVALID_PROPERTY

+

the property was invalid

+
 

NM_SETTING_INFINIBAND_ERROR_MISSING_PROPERTY

+

the property was missing and is +required

+
 
+

-

nm_setting_infiniband_get_p_key ()

-
int                 nm_setting_infiniband_get_p_key     (NMSettingInfiniband *setting);
+

NM_SETTING_INFINIBAND_ERROR

+
#define NM_SETTING_INFINIBAND_ERROR nm_setting_infiniband_error_quark ()
+

-Returns the P_Key to use for this device. A value of -1 means to -use the default P_Key (aka "the P_Key at index 0"). Otherwise it is -a 16-bit unsigned integer.

-
---- - - - - - - - - - - -

setting :

the NMSettingInfiniband -

Returns :

the IPoIB P_Key

-

nm_setting_infiniband_get_parent ()

-
const char *        nm_setting_infiniband_get_parent    (NMSettingInfiniband *setting);
+

NM_SETTING_INFINIBAND_MAC_ADDRESS

+
#define NM_SETTING_INFINIBAND_MAC_ADDRESS    "mac-address"
+

-Returns the parent interface name for this device, if set.

-
---- - - - - - - - - - - -

setting :

the NMSettingInfiniband -

Returns :

the parent interface name
+
+
+

NM_SETTING_INFINIBAND_MTU

+
#define NM_SETTING_INFINIBAND_MTU            "mtu"
+
+

+

-
-

Property Details

+
-

The "mac-address" property

-
  "mac-address"              GArray_guchar_*       : Read / Write
+

NM_SETTING_INFINIBAND_TRANSPORT_MODE

+
#define NM_SETTING_INFINIBAND_TRANSPORT_MODE "transport-mode"
+

-If specified, this connection will only apply to the IPoIB device whose -permanent MAC address matches. This property does not change the MAC -address of the device (i.e. MAC spoofing).


-

The "mtu" property

-
  "mtu"                      guint                 : Read / Write / Construct
+

NM_SETTING_INFINIBAND_P_KEY

+
#define NM_SETTING_INFINIBAND_P_KEY          "p-key"
+

-If non-zero, only transmit packets of the specified size or smaller, -breaking larger packets up into multiple frames.

-

Default value: 0


-

The "p-key" property

-
  "p-key"                    gint                  : Read / Write / Construct
+

NM_SETTING_INFINIBAND_PARENT

+
#define NM_SETTING_INFINIBAND_PARENT         "parent"
+

-The InfiniBand P_Key to use for this device. A value of -1 means to use -the default P_Key (aka "the P_Key at index 0"). Otherwise it is a 16-bit -unsigned integer, whose high bit is set if it is a "full membership" -P_Key.

+
+
+
+

Property Details

+
+

The “mac-address” property

+
  “mac-address”              GArray_guchar_ *
+

+

Flags: Read / Write

+
+
+
+

The “mtu” property

+
  “mtu”                      guint
+

+

Flags: Read / Write / Construct

+

Default value: 0

+
+
+
+

The “p-key” property

+
  “p-key”                    gint
+

+

Flags: Read / Write / Construct

Allowed values: [-1,65535]

Default value: -1


-

The "parent" property

-
  "parent"                   gchar*                : Read / Write / Construct
-

-The interface name of the parent device of this device. Normally NULL, -but if the "p_key" property is set, then you must -specify the base device by setting either this property or -"mac-address". -

+

The “parent” property

+
  “parent”                   gchar *
+

+

Flags: Read / Write / Construct

Default value: NULL


-

The "transport-mode" property

-
  "transport-mode"           gchar*                : Read / Write / Construct
-

-The IP-over-InfiniBand transport mode. Either "datagram" or -"connected". -

+

The “transport-mode” property

+
  “transport-mode”           gchar *
+

+

Flags: Read / Write / Construct

Default value: NULL

+ Generated by GTK-Doc V1.21
\ No newline at end of file diff --git a/docs/libnm-util/html/NMSettingOlpcMesh.html b/docs/libnm-util/html/NMSettingOlpcMesh.html index 468bcf90..c43b6dd8 100644 --- a/docs/libnm-util/html/NMSettingOlpcMesh.html +++ b/docs/libnm-util/html/NMSettingOlpcMesh.html @@ -2,34 +2,28 @@ -NMSettingOlpcMesh +libnm-util Reference Manual: NMSettingOlpcMesh - + - - - - - - - - - - + + + + + + +
@@ -37,193 +31,274 @@

NMSettingOlpcMesh

NMSettingOlpcMesh

- +
-
-

Object Hierarchy

-
-  GEnum
-   +----NMSettingOlpcMeshError
-
-
-  GObject
-   +----NMSetting
-         +----NMSettingOlpcMesh
-
+

Functions

+
++++ + + + + + + + + + + + + + + + + + + + + + + +
+GQuark + +nm_setting_olpc_mesh_error_quark () +
+NMSetting * + +nm_setting_olpc_mesh_new () +
const GByteArray * + +nm_setting_olpc_mesh_get_ssid () +
+guint32 + +nm_setting_olpc_mesh_get_channel () +
const GByteArray * + +nm_setting_olpc_mesh_get_dhcp_anycast_address () +

Properties

-
-  "channel"                  guint                 : Read / Write / Construct
-  "dhcp-anycast-address"     GArray_guchar_*       : Read / Write
-  "ssid"                     GArray_guchar_*       : Read / Write
-
-
-
-

Description

-

-

+
+++++ + + + + + + + + + + + + + + + + + +
guintchannelRead / Write / Construct
+GArray_guchar_ *dhcp-anycast-addressRead / Write
+GArray_guchar_ *ssidRead / Write
-

Details

-
-

NM_SETTING_OLPC_MESH_SETTING_NAME

-
#define NM_SETTING_OLPC_MESH_SETTING_NAME "802-11-olpc-mesh"
-
-

-

-
-
-
-

enum NMSettingOlpcMeshError

-
typedef enum {
-	NM_SETTING_OLPC_MESH_ERROR_UNKNOWN = 0,      /*< nick=UnknownError >*/
-	NM_SETTING_OLPC_MESH_ERROR_INVALID_PROPERTY, /*< nick=InvalidProperty >*/
-	NM_SETTING_OLPC_MESH_ERROR_MISSING_PROPERTY  /*< nick=MissingProperty >*/
-} NMSettingOlpcMeshError;
-
-
+

Types and Values

+
--++ - - + + - - + + - - + + + + + + + + + + + + + +

NM_SETTING_OLPC_MESH_ERROR_UNKNOWN

unknown or unclassified error -#defineNM_SETTING_OLPC_MESH_SETTING_NAME

NM_SETTING_OLPC_MESH_ERROR_INVALID_PROPERTY

the property was invalid -enumNMSettingOlpcMeshError

NM_SETTING_OLPC_MESH_ERROR_MISSING_PROPERTY

the property was missing and is -required -#defineNM_SETTING_OLPC_MESH_ERROR
#defineNM_SETTING_OLPC_MESH_SSID
#defineNM_SETTING_OLPC_MESH_CHANNEL
#defineNM_SETTING_OLPC_MESH_DHCP_ANYCAST_ADDRESS
-
-
-

NM_SETTING_OLPC_MESH_ERROR

-
#define NM_SETTING_OLPC_MESH_ERROR nm_setting_olpc_mesh_error_quark ()
+
+

Object Hierarchy

+
    GEnum
+    ╰── NMSettingOlpcMeshError
+    GObject
+    ╰── NMSetting
+        ╰── NMSettingOlpcMesh
 
+
+
+

Description

-
+
+

Functions

-

nm_setting_olpc_mesh_error_quark ()

-
GQuark              nm_setting_olpc_mesh_error_quark    (void);
+

nm_setting_olpc_mesh_error_quark ()

+
GQuark
+nm_setting_olpc_mesh_error_quark (void);

+
+

Returns

+

+

-

NM_SETTING_OLPC_MESH_SSID

-
#define NM_SETTING_OLPC_MESH_SSID                 "ssid"
-
-

-

+

nm_setting_olpc_mesh_new ()

+
NMSetting *
+nm_setting_olpc_mesh_new (void);
+

Creates a new NMSettingOlpcMesh object with default values.

+
+

Returns

+

the new empty NMSettingOlpcMesh object

+

+

-

NM_SETTING_OLPC_MESH_CHANNEL

-
#define NM_SETTING_OLPC_MESH_CHANNEL              "channel"
-
+

nm_setting_olpc_mesh_get_ssid ()

+
const GByteArray *
+nm_setting_olpc_mesh_get_ssid (NMSettingOlpcMesh *setting);

+
+

Returns

+

+

-

NM_SETTING_OLPC_MESH_DHCP_ANYCAST_ADDRESS

-
#define NM_SETTING_OLPC_MESH_DHCP_ANYCAST_ADDRESS "dhcp-anycast-address"
-
+

nm_setting_olpc_mesh_get_channel ()

+
guint32
+nm_setting_olpc_mesh_get_channel (NMSettingOlpcMesh *setting);

+
+

Returns

+

+

-

NMSettingOlpcMesh

-
typedef struct _NMSettingOlpcMesh NMSettingOlpcMesh;
+

nm_setting_olpc_mesh_get_dhcp_anycast_address ()

+
const GByteArray *
+nm_setting_olpc_mesh_get_dhcp_anycast_address
+                               (NMSettingOlpcMesh *setting);

+
+

Returns

+

-
+
+
+
+

Types and Values

-

NMSettingOlpcMeshClass

-
typedef struct {
-	NMSettingClass parent;
-
-	/* Padding for future expansion */
-	void (*_reserved1) (void);
-	void (*_reserved2) (void);
-	void (*_reserved3) (void);
-	void (*_reserved4) (void);
-} NMSettingOlpcMeshClass;
+

NM_SETTING_OLPC_MESH_SETTING_NAME

+
#define NM_SETTING_OLPC_MESH_SETTING_NAME "802-11-olpc-mesh"
 


-

nm_setting_olpc_mesh_new ()

-
NMSetting *         nm_setting_olpc_mesh_new            (void);
-

-Creates a new NMSettingOlpcMesh object with default values. -

-
+

enum NMSettingOlpcMeshError

+
+

Members

+
--+++ - - - - + + + + + + + + + + + + + + + + +

Returns :

the new empty NMSettingOlpcMesh object

NM_SETTING_OLPC_MESH_ERROR_UNKNOWN

+

unknown or unclassified error

+
 

NM_SETTING_OLPC_MESH_ERROR_INVALID_PROPERTY

+

the property was invalid

+
 

NM_SETTING_OLPC_MESH_ERROR_MISSING_PROPERTY

+

the property was missing and is +required

+
 
+
+
+
+

NM_SETTING_OLPC_MESH_ERROR

+
#define NM_SETTING_OLPC_MESH_ERROR nm_setting_olpc_mesh_error_quark ()
+
+

+

+

-

nm_setting_olpc_mesh_get_ssid ()

-
const GByteArray *  nm_setting_olpc_mesh_get_ssid       (NMSettingOlpcMesh *setting);
+

NM_SETTING_OLPC_MESH_SSID

+
#define NM_SETTING_OLPC_MESH_SSID                 "ssid"
+


-

nm_setting_olpc_mesh_get_channel ()

-
guint32             nm_setting_olpc_mesh_get_channel    (NMSettingOlpcMesh *setting);
+

NM_SETTING_OLPC_MESH_CHANNEL

+
#define NM_SETTING_OLPC_MESH_CHANNEL              "channel"
+


-

nm_setting_olpc_mesh_get_dhcp_anycast_address ()

-
const GByteArray *  nm_setting_olpc_mesh_get_dhcp_anycast_address
-                                                        (NMSettingOlpcMesh *setting);
+

NM_SETTING_OLPC_MESH_DHCP_ANYCAST_ADDRESS

+
#define NM_SETTING_OLPC_MESH_DHCP_ANYCAST_ADDRESS "dhcp-anycast-address"
+

@@ -231,35 +306,30 @@ Creates a new

Property Details

-

The "channel" property

-
  "channel"                  guint                 : Read / Write / Construct
-

-Channel on which the mesh network to join is located. -

+

The “channel” property

+
  “channel”                  guint
+

+

Flags: Read / Write / Construct

Default value: 0


-

The "dhcp-anycast-address" property

-
  "dhcp-anycast-address"     GArray_guchar_*       : Read / Write
-

-Anycast DHCP MAC address used when requesting an IP address via DHCP. -The specific anycast address used determines which DHCP server class -answers the request. -

+

The “dhcp-anycast-address” property

+
  “dhcp-anycast-address”     GArray_guchar_ *
+

+

Flags: Read / Write


-

The "ssid" property

-
  "ssid"                     GArray_guchar_*       : Read / Write
-

-SSID of the mesh network to join. -

+

The “ssid” property

+
  “ssid”                     GArray_guchar_ *
+

+

Flags: Read / Write

+ Generated by GTK-Doc V1.21
\ No newline at end of file diff --git a/docs/libnm-util/html/NMSettingPPP.html b/docs/libnm-util/html/NMSettingPPP.html index 10d400d8..d71e91f5 100644 --- a/docs/libnm-util/html/NMSettingPPP.html +++ b/docs/libnm-util/html/NMSettingPPP.html @@ -2,34 +2,28 @@ -NMSettingPPP +libnm-util Reference Manual: NMSettingPPP - + - - - - - - - - - - + + + + + + +
@@ -38,951 +32,1248 @@

NMSettingPPP — Describes connection properties for devices/networks that require PPP to deliver IP capability

- +
-
-

Synopsis

-
-#include <nm-setting-ppp.h>
-
-#define             NM_SETTING_PPP_SETTING_NAME
-enum                NMSettingPPPError;
-#define             NM_SETTING_PPP_ERROR
-GQuark              nm_setting_ppp_error_quark          (void);
-#define             NM_SETTING_PPP_NOAUTH
-#define             NM_SETTING_PPP_REFUSE_EAP
-#define             NM_SETTING_PPP_REFUSE_PAP
-#define             NM_SETTING_PPP_REFUSE_CHAP
-#define             NM_SETTING_PPP_REFUSE_MSCHAP
-#define             NM_SETTING_PPP_REFUSE_MSCHAPV2
-#define             NM_SETTING_PPP_NOBSDCOMP
-#define             NM_SETTING_PPP_NODEFLATE
-#define             NM_SETTING_PPP_NO_VJ_COMP
-#define             NM_SETTING_PPP_REQUIRE_MPPE
-#define             NM_SETTING_PPP_REQUIRE_MPPE_128
-#define             NM_SETTING_PPP_MPPE_STATEFUL
-#define             NM_SETTING_PPP_CRTSCTS
-#define             NM_SETTING_PPP_BAUD
-#define             NM_SETTING_PPP_MRU
-#define             NM_SETTING_PPP_MTU
-#define             NM_SETTING_PPP_LCP_ECHO_FAILURE
-#define             NM_SETTING_PPP_LCP_ECHO_INTERVAL
-                    NMSettingPPP;
-                    NMSettingPPPClass;
-NMSetting *         nm_setting_ppp_new                  (void);
-gboolean            nm_setting_ppp_get_noauth           (NMSettingPPP *setting);
-gboolean            nm_setting_ppp_get_refuse_eap       (NMSettingPPP *setting);
-gboolean            nm_setting_ppp_get_refuse_pap       (NMSettingPPP *setting);
-gboolean            nm_setting_ppp_get_refuse_chap      (NMSettingPPP *setting);
-gboolean            nm_setting_ppp_get_refuse_mschap    (NMSettingPPP *setting);
-gboolean            nm_setting_ppp_get_refuse_mschapv2  (NMSettingPPP *setting);
-gboolean            nm_setting_ppp_get_nobsdcomp        (NMSettingPPP *setting);
-gboolean            nm_setting_ppp_get_nodeflate        (NMSettingPPP *setting);
-gboolean            nm_setting_ppp_get_no_vj_comp       (NMSettingPPP *setting);
-gboolean            nm_setting_ppp_get_require_mppe     (NMSettingPPP *setting);
-gboolean            nm_setting_ppp_get_require_mppe_128 (NMSettingPPP *setting);
-gboolean            nm_setting_ppp_get_mppe_stateful    (NMSettingPPP *setting);
-gboolean            nm_setting_ppp_get_crtscts          (NMSettingPPP *setting);
-guint32             nm_setting_ppp_get_baud             (NMSettingPPP *setting);
-guint32             nm_setting_ppp_get_mru              (NMSettingPPP *setting);
-guint32             nm_setting_ppp_get_mtu              (NMSettingPPP *setting);
-guint32             nm_setting_ppp_get_lcp_echo_failure (NMSettingPPP *setting);
-guint32             nm_setting_ppp_get_lcp_echo_interval
-                                                        (NMSettingPPP *setting);
-
-
-
-

Object Hierarchy

-
-  GEnum
-   +----NMSettingPPPError
-
-
-  GObject
-   +----NMSetting
-         +----NMSettingPPP
-
-
-
-

Properties

-
-  "baud"                     guint                 : Read / Write / Construct
-  "crtscts"                  gboolean              : Read / Write / Construct
-  "lcp-echo-failure"         guint                 : Read / Write / Construct
-  "lcp-echo-interval"        guint                 : Read / Write / Construct
-  "mppe-stateful"            gboolean              : Read / Write / Construct
-  "mru"                      guint                 : Read / Write / Construct
-  "mtu"                      guint                 : Read / Write / Construct
-  "no-vj-comp"               gboolean              : Read / Write / Construct
-  "noauth"                   gboolean              : Read / Write / Construct
-  "nobsdcomp"                gboolean              : Read / Write / Construct
-  "nodeflate"                gboolean              : Read / Write / Construct
-  "refuse-chap"              gboolean              : Read / Write / Construct
-  "refuse-eap"               gboolean              : Read / Write / Construct
-  "refuse-mschap"            gboolean              : Read / Write / Construct
-  "refuse-mschapv2"          gboolean              : Read / Write / Construct
-  "refuse-pap"               gboolean              : Read / Write / Construct
-  "require-mppe"             gboolean              : Read / Write / Construct
-  "require-mppe-128"         gboolean              : Read / Write / Construct
-
-
-
-

Description

-

-The NMSettingPPP object is a NMSetting subclass that describes properties -necessary for connection to networks that require PPP transport, like PPPoE -cable and DSL modems and some mobile broadband devices. -

-
-

Details

-
-

NM_SETTING_PPP_SETTING_NAME

-
#define NM_SETTING_PPP_SETTING_NAME "ppp"
-
-

-

-
-
-
-

enum NMSettingPPPError

-
typedef enum {
-	NM_SETTING_PPP_ERROR_UNKNOWN = 0,             /*< nick=UnknownError >*/
-	NM_SETTING_PPP_ERROR_INVALID_PROPERTY,        /*< nick=InvalidProperty >*/
-	NM_SETTING_PPP_ERROR_MISSING_PROPERTY,        /*< nick=MissingProperty >*/
-	NM_SETTING_PPP_ERROR_REQUIRE_MPPE_NOT_ALLOWED /*< nick=RequireMPPENotAllowed >*/
-} NMSettingPPPError;
-
-
+

Functions

+
--++ - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - - + - - + - - +

NM_SETTING_PPP_ERROR_UNKNOWN

unknown or unclassified error + +GQuark + +nm_setting_ppp_error_quark () +
+NMSetting * + +nm_setting_ppp_new () +
+gboolean + +nm_setting_ppp_get_noauth () +
+gboolean + +nm_setting_ppp_get_refuse_eap () +
+gboolean + +nm_setting_ppp_get_refuse_pap () +
+gboolean + +nm_setting_ppp_get_refuse_chap () +
+gboolean + +nm_setting_ppp_get_refuse_mschap () +
+gboolean + +nm_setting_ppp_get_refuse_mschapv2 () +
+gboolean + +nm_setting_ppp_get_nobsdcomp () +
+gboolean + +nm_setting_ppp_get_nodeflate () +
+gboolean + +nm_setting_ppp_get_no_vj_comp () +
+gboolean + +nm_setting_ppp_get_require_mppe () +
+gboolean + +nm_setting_ppp_get_require_mppe_128 () +
+gboolean + +nm_setting_ppp_get_mppe_stateful () +
+gboolean + +nm_setting_ppp_get_crtscts () +
+guint32 + +nm_setting_ppp_get_baud () +
+guint32 + +nm_setting_ppp_get_mru ()

NM_SETTING_PPP_ERROR_INVALID_PROPERTY

the property was invalid + +guint32 + +nm_setting_ppp_get_mtu ()

NM_SETTING_PPP_ERROR_MISSING_PROPERTY

the property was missing and is -required + +guint32 + +nm_setting_ppp_get_lcp_echo_failure ()

NM_SETTING_PPP_ERROR_REQUIRE_MPPE_NOT_ALLOWED

requiring MPPE is not compatible -with other setting configuration parameters + +guint32 + +nm_setting_ppp_get_lcp_echo_interval ()
-
-
-

NM_SETTING_PPP_ERROR

-
#define NM_SETTING_PPP_ERROR nm_setting_ppp_error_quark ()
-
-

-

-
-
-
-

nm_setting_ppp_error_quark ()

-
GQuark              nm_setting_ppp_error_quark          (void);
-

-Registers an error quark for NMSettingPPP if necessary. -

-
+
+

Properties

+
--+++ - - - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Returns :

the error quark used for NMSettingPPP errors.
guintbaudRead / Write / Construct
gbooleancrtsctsRead / Write / Construct
guintlcp-echo-failureRead / Write / Construct
guintlcp-echo-intervalRead / Write / Construct
gbooleanmppe-statefulRead / Write / Construct
guintmruRead / Write / Construct
guintmtuRead / Write / Construct
gbooleanno-vj-compRead / Write / Construct
gbooleannoauthRead / Write / Construct
gbooleannobsdcompRead / Write / Construct
gbooleannodeflateRead / Write / Construct
gbooleanrefuse-chapRead / Write / Construct
gbooleanrefuse-eapRead / Write / Construct
gbooleanrefuse-mschapRead / Write / Construct
gbooleanrefuse-mschapv2Read / Write / Construct
gbooleanrefuse-papRead / Write / Construct
gbooleanrequire-mppeRead / Write / Construct
gbooleanrequire-mppe-128Read / Write / Construct
-
-
-

NM_SETTING_PPP_NOAUTH

-
#define NM_SETTING_PPP_NOAUTH            "noauth"
-
-

-

-
-
-
-

NM_SETTING_PPP_REFUSE_EAP

-
#define NM_SETTING_PPP_REFUSE_EAP        "refuse-eap"
-
-

-

-
-
-
-

NM_SETTING_PPP_REFUSE_PAP

-
#define NM_SETTING_PPP_REFUSE_PAP        "refuse-pap"
-
-

-

-
-
-
-

NM_SETTING_PPP_REFUSE_CHAP

-
#define NM_SETTING_PPP_REFUSE_CHAP       "refuse-chap"
-
-

-

-
-
-
-

NM_SETTING_PPP_REFUSE_MSCHAP

-
#define NM_SETTING_PPP_REFUSE_MSCHAP     "refuse-mschap"
-
-

-

-
-
-
-

NM_SETTING_PPP_REFUSE_MSCHAPV2

-
#define NM_SETTING_PPP_REFUSE_MSCHAPV2   "refuse-mschapv2"
-
-

-

-
-
-
-

NM_SETTING_PPP_NOBSDCOMP

-
#define NM_SETTING_PPP_NOBSDCOMP         "nobsdcomp"
-
-

-

-
-
-
-

NM_SETTING_PPP_NODEFLATE

-
#define NM_SETTING_PPP_NODEFLATE         "nodeflate"
-
-

-

-
-
-
-

NM_SETTING_PPP_NO_VJ_COMP

-
#define NM_SETTING_PPP_NO_VJ_COMP        "no-vj-comp"
-
-

-

-
-
-
-

NM_SETTING_PPP_REQUIRE_MPPE

-
#define NM_SETTING_PPP_REQUIRE_MPPE      "require-mppe"
-
-

-

+ -
-
-

NM_SETTING_PPP_REQUIRE_MPPE_128

-
#define NM_SETTING_PPP_REQUIRE_MPPE_128  "require-mppe-128"
+
+

Object Hierarchy

+
    GEnum
+    ╰── NMSettingPPPError
+    GObject
+    ╰── NMSetting
+        ╰── NMSettingPPP
 
-

-

-
-
-

NM_SETTING_PPP_MPPE_STATEFUL

-
#define NM_SETTING_PPP_MPPE_STATEFUL     "mppe-stateful"
+
+

Includes

+
#include <nm-setting-ppp.h>
 
-

-

-
-
-

NM_SETTING_PPP_CRTSCTS

-
#define NM_SETTING_PPP_CRTSCTS           "crtscts"
-
-

-

+
+

Description

+

The NMSettingPPP object is a NMSetting subclass that describes properties +necessary for connection to networks that require PPP transport, like PPPoE +cable and DSL modems and some mobile broadband devices.

-
+
+

Functions

-

NM_SETTING_PPP_BAUD

-
#define NM_SETTING_PPP_BAUD              "baud"
-
-

-

+

nm_setting_ppp_error_quark ()

+
GQuark
+nm_setting_ppp_error_quark (void);
+

Registers an error quark for NMSettingPPP if necessary.

+
+

Returns

+

the error quark used for NMSettingPPP errors.

+

-
-
-

NM_SETTING_PPP_MRU

-
#define NM_SETTING_PPP_MRU               "mru"
-
-

-


-

NM_SETTING_PPP_MTU

-
#define NM_SETTING_PPP_MTU               "mtu"
-
-

-

+

nm_setting_ppp_new ()

+
NMSetting *
+nm_setting_ppp_new (void);
+

Creates a new NMSettingPPP object with default values.

+
+

Returns

+

the new empty NMSettingPPP object.

+

[transfer full]

-
-
-

NM_SETTING_PPP_LCP_ECHO_FAILURE

-
#define NM_SETTING_PPP_LCP_ECHO_FAILURE  "lcp-echo-failure"
-
-

-


-

NM_SETTING_PPP_LCP_ECHO_INTERVAL

-
#define NM_SETTING_PPP_LCP_ECHO_INTERVAL "lcp-echo-interval"
-
-

-

+

nm_setting_ppp_get_noauth ()

+
gboolean
+nm_setting_ppp_get_noauth (NMSettingPPP *setting);
+
+

Parameters

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

setting

the NMSettingPPP

 
-
-
-

NMSettingPPP

-
typedef struct _NMSettingPPP NMSettingPPP;
-

-

+
+

Returns

+

the “noauth” property of the setting

+

-
-
-

NMSettingPPPClass

-
typedef struct {
-	NMSettingClass parent;
-
-	/* Padding for future expansion */
-	void (*_reserved1) (void);
-	void (*_reserved2) (void);
-	void (*_reserved3) (void);
-	void (*_reserved4) (void);
-} NMSettingPPPClass;
-
-

-


-

nm_setting_ppp_new ()

-
NMSetting *         nm_setting_ppp_new                  (void);
-

-Creates a new NMSettingPPP object with default values. -

-
+

nm_setting_ppp_get_refuse_eap ()

+
gboolean
+nm_setting_ppp_get_refuse_eap (NMSettingPPP *setting);
+
+

Parameters

+
--+++ - - + + +

Returns :

the new empty NMSettingPPP object. [transfer full] -

setting

the NMSettingPPP

 
+
+

Returns

+

the “refuse-eap” property of the setting

+

+
+

-

nm_setting_ppp_get_noauth ()

-
gboolean            nm_setting_ppp_get_noauth           (NMSettingPPP *setting);
-
+

nm_setting_ppp_get_refuse_pap ()

+
gboolean
+nm_setting_ppp_get_refuse_pap (NMSettingPPP *setting);
+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSettingPPP -

Returns :

the "noauth" property of the setting

setting

the NMSettingPPP

 
+
+

Returns

+

the “refuse-pap” property of the setting

+

+
+

-

nm_setting_ppp_get_refuse_eap ()

-
gboolean            nm_setting_ppp_get_refuse_eap       (NMSettingPPP *setting);
-
+

nm_setting_ppp_get_refuse_chap ()

+
gboolean
+nm_setting_ppp_get_refuse_chap (NMSettingPPP *setting);
+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSettingPPP -

Returns :

the "refuse-eap" property of the setting

setting

the NMSettingPPP

 
+
+

Returns

+

the “refuse-chap” property of the setting

+

+
+

-

nm_setting_ppp_get_refuse_pap ()

-
gboolean            nm_setting_ppp_get_refuse_pap       (NMSettingPPP *setting);
-
+

nm_setting_ppp_get_refuse_mschap ()

+
gboolean
+nm_setting_ppp_get_refuse_mschap (NMSettingPPP *setting);
+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSettingPPP -

Returns :

the "refuse-pap" property of the setting

setting

the NMSettingPPP

 
+
+

Returns

+

the “refuse-mschap” property of the setting

+

+
+

-

nm_setting_ppp_get_refuse_chap ()

-
gboolean            nm_setting_ppp_get_refuse_chap      (NMSettingPPP *setting);
-
+

nm_setting_ppp_get_refuse_mschapv2 ()

+
gboolean
+nm_setting_ppp_get_refuse_mschapv2 (NMSettingPPP *setting);
+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSettingPPP -

Returns :

the "refuse-chap" property of the setting

setting

the NMSettingPPP

 
+
+

Returns

+

the “refuse-mschapv2” property of the setting

+

+
+

-

nm_setting_ppp_get_refuse_mschap ()

-
gboolean            nm_setting_ppp_get_refuse_mschap    (NMSettingPPP *setting);
-
+

nm_setting_ppp_get_nobsdcomp ()

+
gboolean
+nm_setting_ppp_get_nobsdcomp (NMSettingPPP *setting);
+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSettingPPP -

Returns :

the "refuse-mschap" property of the setting

setting

the NMSettingPPP

 
+
+

Returns

+

the “nobsdcomp” property of the setting

+

+
+

-

nm_setting_ppp_get_refuse_mschapv2 ()

-
gboolean            nm_setting_ppp_get_refuse_mschapv2  (NMSettingPPP *setting);
-
+

nm_setting_ppp_get_nodeflate ()

+
gboolean
+nm_setting_ppp_get_nodeflate (NMSettingPPP *setting);
+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSettingPPP -

Returns :

the "refuse-mschapv2" property of the setting

setting

the NMSettingPPP

 
+
+

Returns

+

the “nodeflate” property of the setting

+

+
+

-

nm_setting_ppp_get_nobsdcomp ()

-
gboolean            nm_setting_ppp_get_nobsdcomp        (NMSettingPPP *setting);
-
+

nm_setting_ppp_get_no_vj_comp ()

+
gboolean
+nm_setting_ppp_get_no_vj_comp (NMSettingPPP *setting);
+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSettingPPP -

Returns :

the "nobsdcomp" property of the setting

setting

the NMSettingPPP

 
+
+

Returns

+

the “no-vj-comp” property of the setting

+

+
+

-

nm_setting_ppp_get_nodeflate ()

-
gboolean            nm_setting_ppp_get_nodeflate        (NMSettingPPP *setting);
-
+

nm_setting_ppp_get_require_mppe ()

+
gboolean
+nm_setting_ppp_get_require_mppe (NMSettingPPP *setting);
+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSettingPPP -

Returns :

the "nodeflate" property of the setting

setting

the NMSettingPPP

 
+
+

Returns

+

the “require-mppe” property of the setting

+

+
+

-

nm_setting_ppp_get_no_vj_comp ()

-
gboolean            nm_setting_ppp_get_no_vj_comp       (NMSettingPPP *setting);
-
+

nm_setting_ppp_get_require_mppe_128 ()

+
gboolean
+nm_setting_ppp_get_require_mppe_128 (NMSettingPPP *setting);
+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSettingPPP -

Returns :

the "no-vj-comp" property of the setting

setting

the NMSettingPPP

 
+
+

Returns

+

the “require-mppe-128” property of the setting

+

+
+

-

nm_setting_ppp_get_require_mppe ()

-
gboolean            nm_setting_ppp_get_require_mppe     (NMSettingPPP *setting);
-
+

nm_setting_ppp_get_mppe_stateful ()

+
gboolean
+nm_setting_ppp_get_mppe_stateful (NMSettingPPP *setting);
+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSettingPPP -

Returns :

the "require-mppe" property of the setting

setting

the NMSettingPPP

 
+
+

Returns

+

the “mppe-stateful” property of the setting

+

+
+

-

nm_setting_ppp_get_require_mppe_128 ()

-
gboolean            nm_setting_ppp_get_require_mppe_128 (NMSettingPPP *setting);
-
+

nm_setting_ppp_get_crtscts ()

+
gboolean
+nm_setting_ppp_get_crtscts (NMSettingPPP *setting);
+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSettingPPP -

Returns :

the "require-mppe-128" property of the setting

setting

the NMSettingPPP

 
+
+

Returns

+

the “crtscts” property of the setting

+

+
+

-

nm_setting_ppp_get_mppe_stateful ()

-
gboolean            nm_setting_ppp_get_mppe_stateful    (NMSettingPPP *setting);
-
+

nm_setting_ppp_get_baud ()

+
guint32
+nm_setting_ppp_get_baud (NMSettingPPP *setting);
+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSettingPPP -

Returns :

the "mppe-stateful" property of the setting

setting

the NMSettingPPP

 
+
+

Returns

+

the “baud” property of the setting

+

+
+
-

nm_setting_ppp_get_crtscts ()

-
gboolean            nm_setting_ppp_get_crtscts          (NMSettingPPP *setting);
-
+

nm_setting_ppp_get_mru ()

+
guint32
+nm_setting_ppp_get_mru (NMSettingPPP *setting);
+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSettingPPP -

Returns :

the "crtscts" property of the setting

setting

the NMSettingPPP

 
+
+

Returns

+

the “mru” property of the setting

+

+
+
-

nm_setting_ppp_get_baud ()

-
guint32             nm_setting_ppp_get_baud             (NMSettingPPP *setting);
-
+

nm_setting_ppp_get_mtu ()

+
guint32
+nm_setting_ppp_get_mtu (NMSettingPPP *setting);
+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSettingPPP -

Returns :

the "baud" property of the setting

setting

the NMSettingPPP

 
+
+

Returns

+

the “mtu” property of the setting

+

+
+
-

nm_setting_ppp_get_mru ()

-
guint32             nm_setting_ppp_get_mru              (NMSettingPPP *setting);
-
+

nm_setting_ppp_get_lcp_echo_failure ()

+
guint32
+nm_setting_ppp_get_lcp_echo_failure (NMSettingPPP *setting);
+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSettingPPP -

Returns :

the "mru" property of the setting

setting

the NMSettingPPP

 
+
+

Returns

+

the “lcp-echo-failure” property of the setting

+

+
+
-

nm_setting_ppp_get_mtu ()

-
guint32             nm_setting_ppp_get_mtu              (NMSettingPPP *setting);
-
+

nm_setting_ppp_get_lcp_echo_interval ()

+
guint32
+nm_setting_ppp_get_lcp_echo_interval (NMSettingPPP *setting);
+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSettingPPP -

Returns :

the "mtu" property of the setting

setting

the NMSettingPPP

 
+
+

Returns

+

the “lcp-echo-interval” property of the setting

+

+
+ + +
+

Types and Values

+
+

NM_SETTING_PPP_SETTING_NAME

+
#define NM_SETTING_PPP_SETTING_NAME "ppp"
+
+

+

+

-

nm_setting_ppp_get_lcp_echo_failure ()

-
guint32             nm_setting_ppp_get_lcp_echo_failure (NMSettingPPP *setting);
-
+

enum NMSettingPPPError

+
+

Members

+
--+++ - - + + - - + + + - -

setting :

the NMSettingPPP +

NM_SETTING_PPP_ERROR_UNKNOWN

+

unknown or unclassified error

 

Returns :

the "lcp-echo-failure" property of the setting

NM_SETTING_PPP_ERROR_INVALID_PROPERTY

+

the property was invalid

+
 
-
-
-
-

nm_setting_ppp_get_lcp_echo_interval ()

-
guint32             nm_setting_ppp_get_lcp_echo_interval
-                                                        (NMSettingPPP *setting);
-
---- - - - + + - - + + +

setting :

the NMSettingPPP +

NM_SETTING_PPP_ERROR_MISSING_PROPERTY

+

the property was missing and is +required

 

Returns :

the "lcp-echo-interval" property of the setting

NM_SETTING_PPP_ERROR_REQUIRE_MPPE_NOT_ALLOWED

+

requiring MPPE is not compatible +with other setting configuration parameters

+
 
-
-

Property Details

+
-

The "baud" property

-
  "baud"                     guint                 : Read / Write / Construct
+

NM_SETTING_PPP_ERROR

+
#define NM_SETTING_PPP_ERROR nm_setting_ppp_error_quark ()
+

-If non-zero, instruct pppd to set the serial port to the specified -baudrate. This value should normally be left as 0 to automatically -choose the speed.

-

Default value: 0


-

The "crtscts" property

-
  "crtscts"                  gboolean              : Read / Write / Construct
+

NM_SETTING_PPP_NOAUTH

+
#define NM_SETTING_PPP_NOAUTH            "noauth"
+

-If TRUE, specify that pppd should set the serial port to use hardware -flow control with RTS and CTS signals. This value should normally be set -to FALSE.

-

Default value: FALSE


-

The "lcp-echo-failure" property

-
  "lcp-echo-failure"         guint                 : Read / Write / Construct
+

NM_SETTING_PPP_REFUSE_EAP

+
#define NM_SETTING_PPP_REFUSE_EAP        "refuse-eap"
+

-If non-zero, instruct pppd to presume the connection to the peer has -failed if the specified number of LCP echo-requests go unanswered by the -peer. The "lcp-echo-interval" property must also be set to a non-zero -value if this property is used.

-

Default value: 0


-

The "lcp-echo-interval" property

-
  "lcp-echo-interval"        guint                 : Read / Write / Construct
+

NM_SETTING_PPP_REFUSE_PAP

+
#define NM_SETTING_PPP_REFUSE_PAP        "refuse-pap"
+

-If non-zero, instruct pppd to send an LCP echo-request frame to the peer -every n seconds (where n is the specified value). Note that some PPP -peers will respond to echo requests and some will not, and it is not -possible to autodetect this.

-

Default value: 0


-

The "mppe-stateful" property

-
  "mppe-stateful"            gboolean              : Read / Write / Construct
+

NM_SETTING_PPP_REFUSE_CHAP

+
#define NM_SETTING_PPP_REFUSE_CHAP       "refuse-chap"
+

-If TRUE, stateful MPPE is used. See pppd documentation for more -information on stateful MPPE.

-

Default value: FALSE


-

The "mru" property

-
  "mru"                      guint                 : Read / Write / Construct
+

NM_SETTING_PPP_REFUSE_MSCHAP

+
#define NM_SETTING_PPP_REFUSE_MSCHAP     "refuse-mschap"
+
+

+

+
+
+
+

NM_SETTING_PPP_REFUSE_MSCHAPV2

+
#define NM_SETTING_PPP_REFUSE_MSCHAPV2   "refuse-mschapv2"
+

-If non-zero, instruct pppd to request that the peer send packets no -larger than the specified size. If non-zero, the MRU should be between -128 and 16384.

-

Allowed values: <= 16384

-

Default value: 0


-

The "mtu" property

-
  "mtu"                      guint                 : Read / Write / Construct
+

NM_SETTING_PPP_NOBSDCOMP

+
#define NM_SETTING_PPP_NOBSDCOMP         "nobsdcomp"
+

-If non-zero, instruct pppd to send packets no larger than the specified -size.

-

Default value: 0


-

The "no-vj-comp" property

-
  "no-vj-comp"               gboolean              : Read / Write / Construct
+

NM_SETTING_PPP_NODEFLATE

+
#define NM_SETTING_PPP_NODEFLATE         "nodeflate"
+

-If TRUE, Van Jacobsen TCP header compression will not be requested.

-

Default value: FALSE


-

The "noauth" property

-
  "noauth"                   gboolean              : Read / Write / Construct
+

NM_SETTING_PPP_NO_VJ_COMP

+
#define NM_SETTING_PPP_NO_VJ_COMP        "no-vj-comp"
+

-If TRUE, do not require the other side (usually the PPP server) to -authenticate itself to the client. If FALSE, require authentication -from the remote side. In almost all cases, this should be TRUE.

-

Default value: TRUE


-

The "nobsdcomp" property

-
  "nobsdcomp"                gboolean              : Read / Write / Construct
+

NM_SETTING_PPP_REQUIRE_MPPE

+
#define NM_SETTING_PPP_REQUIRE_MPPE      "require-mppe"
+

-If TRUE, BSD compression will not be requested.

-

Default value: FALSE


-

The "nodeflate" property

-
  "nodeflate"                gboolean              : Read / Write / Construct
+

NM_SETTING_PPP_REQUIRE_MPPE_128

+
#define NM_SETTING_PPP_REQUIRE_MPPE_128  "require-mppe-128"
+

-If TRUE, "deflate" compression will not be requested.

-

Default value: FALSE


-

The "refuse-chap" property

-
  "refuse-chap"              gboolean              : Read / Write / Construct
+

NM_SETTING_PPP_MPPE_STATEFUL

+
#define NM_SETTING_PPP_MPPE_STATEFUL     "mppe-stateful"
+

-If TRUE, the CHAP authentication method will not be used.

-

Default value: FALSE


-

The "refuse-eap" property

-
  "refuse-eap"               gboolean              : Read / Write / Construct
+

NM_SETTING_PPP_CRTSCTS

+
#define NM_SETTING_PPP_CRTSCTS           "crtscts"
+

-If TRUE, the EAP authentication method will not be used.

-

Default value: FALSE


-

The "refuse-mschap" property

-
  "refuse-mschap"            gboolean              : Read / Write / Construct
+

NM_SETTING_PPP_BAUD

+
#define NM_SETTING_PPP_BAUD              "baud"
+

-If TRUE, the MSCHAP authentication method will not be used.

-

Default value: FALSE


-

The "refuse-mschapv2" property

-
  "refuse-mschapv2"          gboolean              : Read / Write / Construct
+

NM_SETTING_PPP_MRU

+
#define NM_SETTING_PPP_MRU               "mru"
+

-If TRUE, the MSCHAPv2 authentication method will not be used.

-

Default value: FALSE


-

The "refuse-pap" property

-
  "refuse-pap"               gboolean              : Read / Write / Construct
+

NM_SETTING_PPP_MTU

+
#define NM_SETTING_PPP_MTU               "mtu"
+

-If TRUE, the PAP authentication method will not be used.

-

Default value: FALSE


-

The "require-mppe" property

-
  "require-mppe"             gboolean              : Read / Write / Construct
+

NM_SETTING_PPP_LCP_ECHO_FAILURE

+
#define NM_SETTING_PPP_LCP_ECHO_FAILURE  "lcp-echo-failure"
+

-If TRUE, MPPE (Microsoft Point-to-Point Encrpytion) will be required for -the PPP session. If either 64-bit or 128-bit MPPE is not available the -session will fail. Note that MPPE is not used on mobile broadband -connections.

-

Default value: FALSE


-

The "require-mppe-128" property

-
  "require-mppe-128"         gboolean              : Read / Write / Construct
+

NM_SETTING_PPP_LCP_ECHO_INTERVAL

+
#define NM_SETTING_PPP_LCP_ECHO_INTERVAL "lcp-echo-interval"
+

-If TRUE, 128-bit MPPE (Microsoft Point-to-Point Encrpytion) will be -required for the PPP session, and the "require-mppe" property must also -be set to TRUE. If 128-bit MPPE is not available the session will fail.

+
+
+
+

Property Details

+
+

The “baud” property

+
  “baud”                     guint
+

+

Flags: Read / Write / Construct

+

Default value: 0

+
+
+
+

The “crtscts” property

+
  “crtscts”                  gboolean
+

+

Flags: Read / Write / Construct

+

Default value: FALSE

+
+
+
+

The “lcp-echo-failure” property

+
  “lcp-echo-failure”         guint
+

+

Flags: Read / Write / Construct

+

Default value: 0

+
+
+
+

The “lcp-echo-interval” property

+
  “lcp-echo-interval”        guint
+

+

Flags: Read / Write / Construct

+

Default value: 0

+
+
+
+

The “mppe-stateful” property

+
  “mppe-stateful”            gboolean
+

+

Flags: Read / Write / Construct

+

Default value: FALSE

+
+
+
+

The “mru” property

+
  “mru”                      guint
+

+

Flags: Read / Write / Construct

+

Allowed values: <= 16384

+

Default value: 0

+
+
+
+

The “mtu” property

+
  “mtu”                      guint
+

+

Flags: Read / Write / Construct

+

Default value: 0

+
+
+
+

The “no-vj-comp” property

+
  “no-vj-comp”               gboolean
+

+

Flags: Read / Write / Construct

+

Default value: FALSE

+
+
+
+

The “noauth” property

+
  “noauth”                   gboolean
+

+

Flags: Read / Write / Construct

+

Default value: TRUE

+
+
+
+

The “nobsdcomp” property

+
  “nobsdcomp”                gboolean
+

+

Flags: Read / Write / Construct

+

Default value: FALSE

+
+
+
+

The “nodeflate” property

+
  “nodeflate”                gboolean
+

+

Flags: Read / Write / Construct

+

Default value: FALSE

+
+
+
+

The “refuse-chap” property

+
  “refuse-chap”              gboolean
+

+

Flags: Read / Write / Construct

+

Default value: FALSE

+
+
+
+

The “refuse-eap” property

+
  “refuse-eap”               gboolean
+

+

Flags: Read / Write / Construct

+

Default value: FALSE

+
+
+
+

The “refuse-mschap” property

+
  “refuse-mschap”            gboolean
+

+

Flags: Read / Write / Construct

+

Default value: FALSE

+
+
+
+

The “refuse-mschapv2” property

+
  “refuse-mschapv2”          gboolean
+

+

Flags: Read / Write / Construct

+

Default value: FALSE

+
+
+
+

The “refuse-pap” property

+
  “refuse-pap”               gboolean
+

+

Flags: Read / Write / Construct

+

Default value: FALSE

+
+
+
+

The “require-mppe” property

+
  “require-mppe”             gboolean
+

+

Flags: Read / Write / Construct

+

Default value: FALSE

+
+
+
+

The “require-mppe-128” property

+
  “require-mppe-128”         gboolean
+

+

Flags: Read / Write / Construct

Default value: FALSE

+ Generated by GTK-Doc V1.21 \ No newline at end of file diff --git a/docs/libnm-util/html/NMSettingPPPOE.html b/docs/libnm-util/html/NMSettingPPPOE.html index 0bfb2372..97d3edde 100644 --- a/docs/libnm-util/html/NMSettingPPPOE.html +++ b/docs/libnm-util/html/NMSettingPPPOE.html @@ -2,34 +2,28 @@ -NMSettingPPPOE +libnm-util Reference Manual: NMSettingPPPOE - + - - - - - - - - - - + + + + + + +
@@ -37,62 +31,290 @@

NMSettingPPPOE

NMSettingPPPOE — Describes PPPoE connection properties

- +
-
-

Synopsis

-
-#include <nm-setting-pppoe.h>
-
-#define             NM_SETTING_PPPOE_SETTING_NAME
-enum                NMSettingPPPOEError;
-#define             NM_SETTING_PPPOE_ERROR
-GQuark              nm_setting_pppoe_error_quark        (void);
-#define             NM_SETTING_PPPOE_SERVICE
-#define             NM_SETTING_PPPOE_USERNAME
-#define             NM_SETTING_PPPOE_PASSWORD
-#define             NM_SETTING_PPPOE_PASSWORD_FLAGS
-                    NMSettingPPPOE;
-                    NMSettingPPPOEClass;
-NMSetting *         nm_setting_pppoe_new                (void);
-const char *        nm_setting_pppoe_get_service        (NMSettingPPPOE *setting);
-const char *        nm_setting_pppoe_get_username       (NMSettingPPPOE *setting);
-const char *        nm_setting_pppoe_get_password       (NMSettingPPPOE *setting);
-NMSettingSecretFlags nm_setting_pppoe_get_password_flags
-                                                        (NMSettingPPPOE *setting);
-
+
+

Functions

+
++++ + + + + + + + + + + + + + + + + + + + + + + + + + + +
+GQuark + +nm_setting_pppoe_error_quark () +
+NMSetting * + +nm_setting_pppoe_new () +
const char * + +nm_setting_pppoe_get_service () +
const char * + +nm_setting_pppoe_get_username () +
const char * + +nm_setting_pppoe_get_password () +
+NMSettingSecretFlags + +nm_setting_pppoe_get_password_flags () +
+
+
+

Properties

+
+++++ + + + + + + + + + + + + + + + + + + + + + + +
+gchar *passwordRead / Write
guintpassword-flagsRead / Write
+gchar *serviceRead / Write
+gchar *usernameRead / Write
+
+
+

Types and Values

+

Object Hierarchy

-
-  GEnum
-   +----NMSettingPPPOEError
-
-
-  GObject
-   +----NMSetting
-         +----NMSettingPPPOE
+
    GEnum
+    ╰── NMSettingPPPOEError
+    GObject
+    ╰── NMSetting
+        ╰── NMSettingPPPOE
 
-

Properties

-
-  "password"                 gchar*                : Read / Write
-  "password-flags"           guint                 : Read / Write
-  "service"                  gchar*                : Read / Write
-  "username"                 gchar*                : Read / Write
+

Includes

+
#include <nm-setting-pppoe.h>
 

Description

-

-The NMSettingPPPOE object is a NMSetting subclass that describes +

The NMSettingPPPOE object is a NMSetting subclass that describes properties necessary for connection to networks that require PPPoE connections -to provide IP transport, for example cable or DSL modems. -

+to provide IP transport, for example cable or DSL modems.

+
+
+

Functions

+
+

nm_setting_pppoe_error_quark ()

+
GQuark
+nm_setting_pppoe_error_quark (void);
+

Registers an error quark for NMSettingPPPOE if necessary.

+
+

Returns

+

the error quark used for NMSettingPPPOE errors.

+

+
+
+
+
+

nm_setting_pppoe_new ()

+
NMSetting *
+nm_setting_pppoe_new (void);
+

Creates a new NMSettingPPPOE object with default values.

+
+

Returns

+

the new empty NMSettingPPPOE object.

+

[transfer full]

+
+
+
+
+

nm_setting_pppoe_get_service ()

+
const char *
+nm_setting_pppoe_get_service (NMSettingPPPOE *setting);
+
+

Parameters

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

setting

the NMSettingPPPOE

 
+
+
+

Returns

+

the “service” property of the setting

+

+
+
+
+
+

nm_setting_pppoe_get_username ()

+
const char *
+nm_setting_pppoe_get_username (NMSettingPPPOE *setting);
+
+

Parameters

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

setting

the NMSettingPPPOE

 
+
+
+

Returns

+

the “username” property of the setting

+

+
+
+
+
+

nm_setting_pppoe_get_password ()

+
const char *
+nm_setting_pppoe_get_password (NMSettingPPPOE *setting);
+
+

Parameters

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

setting

the NMSettingPPPOE

 
+
+
+

Returns

+

the “password” property of the setting

+

+
+
+
+
+

nm_setting_pppoe_get_password_flags ()

+
NMSettingSecretFlags
+nm_setting_pppoe_get_password_flags (NMSettingPPPOE *setting);
+
+

Parameters

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

setting

the NMSettingPPPOE

 
+
+
+

Returns

+

the NMSettingSecretFlags pertaining to the “password”

+

+
+
-

Details

+

Types and Values

NM_SETTING_PPPOE_SETTING_NAME

#define NM_SETTING_PPPOE_SETTING_NAME "pppoe"
@@ -102,45 +324,50 @@ to provide IP transport, for example cable or DSL modems.
 

-

enum NMSettingPPPOEError

-
typedef enum {
-	NM_SETTING_PPPOE_ERROR_UNKNOWN = 0,        /*< nick=UnknownError >*/
-	NM_SETTING_PPPOE_ERROR_INVALID_PROPERTY,   /*< nick=InvalidProperty >*/
-	NM_SETTING_PPPOE_ERROR_MISSING_PROPERTY,   /*< nick=MissingProperty >*/
-	NM_SETTING_PPPOE_ERROR_MISSING_PPP_SETTING /*< nick=MissingPPPSetting >*/
-} NMSettingPPPOEError;
-
-
+

enum NMSettingPPPOEError

+
+

Members

+
--+++ - - + + - - + + - - + + - - + +

NM_SETTING_PPPOE_ERROR_UNKNOWN

unknown or unclassified error +

NM_SETTING_PPPOE_ERROR_UNKNOWN

+

unknown or unclassified error

 

NM_SETTING_PPPOE_ERROR_INVALID_PROPERTY

the property was invalid +

NM_SETTING_PPPOE_ERROR_INVALID_PROPERTY

+

the property was invalid

 

NM_SETTING_PPPOE_ERROR_MISSING_PROPERTY

the property was missing and is -required +

NM_SETTING_PPPOE_ERROR_MISSING_PROPERTY

+

the property was missing and is +required

 

NM_SETTING_PPPOE_ERROR_MISSING_PPP_SETTING

the connection -did not contain a required PPP setting for PPP related options +

NM_SETTING_PPPOE_ERROR_MISSING_PPP_SETTING

+

the connection +did not contain a required PPP setting for PPP related options

 
+

NM_SETTING_PPPOE_ERROR

@@ -151,24 +378,6 @@ did not contain a required PPP setting for PPP related options

-

nm_setting_pppoe_error_quark ()

-
GQuark              nm_setting_pppoe_error_quark        (void);
-

-Registers an error quark for NMSettingPPPOE if necessary. -

-
---- - - - - -

Returns :

the error quark used for NMSettingPPPOE errors.
-
-
-

NM_SETTING_PPPOE_SERVICE

#define NM_SETTING_PPPOE_SERVICE        "service"
 
@@ -199,184 +408,45 @@ Registers an error quark for -

NMSettingPPPOE

-
typedef struct _NMSettingPPPOE NMSettingPPPOE;
-

-

-
-
-
-

NMSettingPPPOEClass

-
typedef struct {
-	NMSettingClass parent;
-
-	/* Padding for future expansion */
-	void (*_reserved1) (void);
-	void (*_reserved2) (void);
-	void (*_reserved3) (void);
-	void (*_reserved4) (void);
-} NMSettingPPPOEClass;
-
-

-

-
-
-
-

nm_setting_pppoe_new ()

-
NMSetting *         nm_setting_pppoe_new                (void);
-

-Creates a new NMSettingPPPOE object with default values. -

-
---- - - - - -

Returns :

the new empty NMSettingPPPOE object. [transfer full] -
-
-
-
-

nm_setting_pppoe_get_service ()

-
const char *        nm_setting_pppoe_get_service        (NMSettingPPPOE *setting);
-
---- - - - - - - - - - - -

setting :

the NMSettingPPPOE -

Returns :

the "service" property of the setting
-
-
-
-

nm_setting_pppoe_get_username ()

-
const char *        nm_setting_pppoe_get_username       (NMSettingPPPOE *setting);
-
---- - - - - - - - - - - -

setting :

the NMSettingPPPOE -

Returns :

the "username" property of the setting
-
-
-
-

nm_setting_pppoe_get_password ()

-
const char *        nm_setting_pppoe_get_password       (NMSettingPPPOE *setting);
-
---- - - - - - - - - - - -

setting :

the NMSettingPPPOE -

Returns :

the "password" property of the setting
-
-
-
-

nm_setting_pppoe_get_password_flags ()

-
NMSettingSecretFlags nm_setting_pppoe_get_password_flags
-                                                        (NMSettingPPPOE *setting);
-
---- - - - - - - - - - - -

setting :

the NMSettingPPPOE -

Returns :

the NMSettingSecretFlags pertaining to the "password" -
-

Property Details

-

The "password" property

-
  "password"                 gchar*                : Read / Write
-

-Password used to authenticate with the PPPoE service. -

+

The “password” property

+
  “password”                 gchar *
+

+

Flags: Read / Write

Default value: NULL


-

The "password-flags" property

-
  "password-flags"           guint                 : Read / Write
-

-Flags indicating how to handle the "password" property. -

+

The “password-flags” property

+
  “password-flags”           guint
+

+

Flags: Read / Write

Allowed values: <= 7

Default value: 0


-

The "service" property

-
  "service"                  gchar*                : Read / Write
-

-If specified, instruct PPPoE to only initiate sessions with access -concentrators that provide the specified service. For most providers, -this should be left blank. It is only required if there are multiple -access concentrators or a specific service is known to be required. -

+

The “service” property

+
  “service”                  gchar *
+

+

Flags: Read / Write

Default value: NULL


-

The "username" property

-
  "username"                 gchar*                : Read / Write
-

-Username used to authenticate with the PPPoE service. -

+

The “username” property

+
  “username”                 gchar *
+

+

Flags: Read / Write

Default value: NULL

+ Generated by GTK-Doc V1.21 \ No newline at end of file diff --git a/docs/libnm-util/html/NMSettingSerial.html b/docs/libnm-util/html/NMSettingSerial.html index ee5886fe..6e9ede6a 100644 --- a/docs/libnm-util/html/NMSettingSerial.html +++ b/docs/libnm-util/html/NMSettingSerial.html @@ -2,34 +2,28 @@ -NMSettingSerial +libnm-util Reference Manual: NMSettingSerial - + - - - - - - - - - - + + + + + + +
@@ -38,64 +32,333 @@

NMSettingSerial — Describes connection properties for devices that use serial communications

- +
-
-

Synopsis

-
-#include <nm-setting-serial.h>
-
-#define             NM_SETTING_SERIAL_SETTING_NAME
-enum                NMSettingSerialError;
-#define             NM_SETTING_SERIAL_ERROR
-GQuark              nm_setting_serial_error_quark       (void);
-#define             NM_SETTING_SERIAL_BAUD
-#define             NM_SETTING_SERIAL_BITS
-#define             NM_SETTING_SERIAL_PARITY
-#define             NM_SETTING_SERIAL_STOPBITS
-#define             NM_SETTING_SERIAL_SEND_DELAY
-                    NMSettingSerial;
-                    NMSettingSerialClass;
-NMSetting *         nm_setting_serial_new               (void);
-guint               nm_setting_serial_get_baud          (NMSettingSerial *setting);
-guint               nm_setting_serial_get_bits          (NMSettingSerial *setting);
-char                nm_setting_serial_get_parity        (NMSettingSerial *setting);
-guint               nm_setting_serial_get_stopbits      (NMSettingSerial *setting);
-guint64             nm_setting_serial_get_send_delay    (NMSettingSerial *setting);
-
+
+

Functions

+
++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+GQuark + +nm_setting_serial_error_quark () +
+NMSetting * + +nm_setting_serial_new () +
+guint + +nm_setting_serial_get_baud () +
+guint + +nm_setting_serial_get_bits () +
+char + +nm_setting_serial_get_parity () +
+guint + +nm_setting_serial_get_stopbits () +
+guint64 + +nm_setting_serial_get_send_delay () +
+
+
+

Properties

+
+++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + +
guintbaudRead / Write / Construct
guintbitsRead / Write / Construct
gcharparityRead / Write / Construct
guint64send-delayRead / Write / Construct
guintstopbitsRead / Write / Construct
+
+
+

Types and Values

+

Object Hierarchy

-
-  GEnum
-   +----NMSettingSerialError
-
-
-  GObject
-   +----NMSetting
-         +----NMSettingSerial
+
    GEnum
+    ╰── NMSettingSerialError
+    GObject
+    ╰── NMSetting
+        ╰── NMSettingSerial
 
-

Properties

-
-  "baud"                     guint                 : Read / Write / Construct
-  "bits"                     guint                 : Read / Write / Construct
-  "parity"                   gchar                 : Read / Write / Construct
-  "send-delay"               guint64               : Read / Write / Construct
-  "stopbits"                 guint                 : Read / Write / Construct
+

Includes

+
#include <nm-setting-serial.h>
 

Description

-

-The NMSettingSerial object is a NMSetting subclass that describes +

The NMSettingSerial object is a NMSetting subclass that describes properties necessary for connections that may use serial communications, -such as mobile broadband or analog telephone connections. -

+such as mobile broadband or analog telephone connections.

+
+
+

Functions

+
+

nm_setting_serial_error_quark ()

+
GQuark
+nm_setting_serial_error_quark (void);
+

Registers an error quark for NMSettingSerial if necessary.

+
+

Returns

+

the error quark used for NMSettingSerial errors.

+

+
+
+
+
+

nm_setting_serial_new ()

+
NMSetting *
+nm_setting_serial_new (void);
+

Creates a new NMSettingSerial object with default values.

+
+

Returns

+

the new empty NMSettingSerial object.

+

[transfer full]

+
+
+
+
+

nm_setting_serial_get_baud ()

+
guint
+nm_setting_serial_get_baud (NMSettingSerial *setting);
+
+

Parameters

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

setting

the NMSettingSerial

 
+
+
+

Returns

+

the “baud” property of the setting

+

+
+
+
+
+

nm_setting_serial_get_bits ()

+
guint
+nm_setting_serial_get_bits (NMSettingSerial *setting);
+
+

Parameters

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

setting

the NMSettingSerial

 
+
+
+

Returns

+

the “bits” property of the setting

+

+
+
+
+
+

nm_setting_serial_get_parity ()

+
char
+nm_setting_serial_get_parity (NMSettingSerial *setting);
+
+

Parameters

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

setting

the NMSettingSerial

 
+
+
+

Returns

+

the “parity” property of the setting

+

+
+
+
+
+

nm_setting_serial_get_stopbits ()

+
guint
+nm_setting_serial_get_stopbits (NMSettingSerial *setting);
+
+

Parameters

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

setting

the NMSettingSerial

 
+
+
+

Returns

+

the “stopbits” property of the setting

+

+
+
+
+
+

nm_setting_serial_get_send_delay ()

+
guint64
+nm_setting_serial_get_send_delay (NMSettingSerial *setting);
+
+

Parameters

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

setting

the NMSettingSerial

 
+
+
+

Returns

+

the “send-delay” property of the setting

+

+
+
-

Details

+

Types and Values

NM_SETTING_SERIAL_SETTING_NAME

#define NM_SETTING_SERIAL_SETTING_NAME "serial"
@@ -105,45 +368,50 @@ such as mobile broadband or analog telephone connections.
 

-

enum NMSettingSerialError

-
typedef enum {
-	NM_SETTING_SERIAL_ERROR_UNKNOWN = 0,        /*< nick=UnknownError >*/
-	NM_SETTING_SERIAL_ERROR_INVALID_PROPERTY,   /*< nick=InvalidProperty >*/
-	NM_SETTING_SERIAL_ERROR_MISSING_PROPERTY,   /*< nick=MissingProperty >*/
-	NM_SETTING_SERIAL_ERROR_MISSING_PPP_SETTING /*< nick=MissingPPPSetting >*/
-} NMSettingSerialError;
-
-
+

enum NMSettingSerialError

+
+

Members

+
--+++ - - + + - - + + - - + + - - + +

NM_SETTING_SERIAL_ERROR_UNKNOWN

unknown or unclassified error +

NM_SETTING_SERIAL_ERROR_UNKNOWN

+

unknown or unclassified error

 

NM_SETTING_SERIAL_ERROR_INVALID_PROPERTY

the property was invalid +

NM_SETTING_SERIAL_ERROR_INVALID_PROPERTY

+

the property was invalid

 

NM_SETTING_SERIAL_ERROR_MISSING_PROPERTY

the property was missing and is -required +

NM_SETTING_SERIAL_ERROR_MISSING_PROPERTY

+

the property was missing and is +required

 

NM_SETTING_SERIAL_ERROR_MISSING_PPP_SETTING

one of the properties of the -setting requires the connection to contain an NMSettingPPP setting +

NM_SETTING_SERIAL_ERROR_MISSING_PPP_SETTING

+

one of the properties of the +setting requires the connection to contain an NMSettingPPP setting

 
+

NM_SETTING_SERIAL_ERROR

@@ -154,24 +422,6 @@ setting requires the connection to contain an -

nm_setting_serial_error_quark ()

-
GQuark              nm_setting_serial_error_quark       (void);
-

-Registers an error quark for NMSettingSerial if necessary. -

-
---- - - - - -

Returns :

the error quark used for NMSettingSerial errors.
-
-
-

NM_SETTING_SERIAL_BAUD

#define NM_SETTING_SERIAL_BAUD "baud"
 
@@ -210,209 +460,48 @@ Registers an error quark for -

NMSettingSerial

-
typedef struct _NMSettingSerial NMSettingSerial;
-

-

-
-
-
-

NMSettingSerialClass

-
typedef struct {
-	NMSettingClass parent;
-
-	/* Padding for future expansion */
-	void (*_reserved1) (void);
-	void (*_reserved2) (void);
-	void (*_reserved3) (void);
-	void (*_reserved4) (void);
-} NMSettingSerialClass;
-
-

-

-
-
-
-

nm_setting_serial_new ()

-
NMSetting *         nm_setting_serial_new               (void);
-

-Creates a new NMSettingSerial object with default values. -

-
---- - - - - -

Returns :

the new empty NMSettingSerial object. [transfer full] -
-
-
-
-

nm_setting_serial_get_baud ()

-
guint               nm_setting_serial_get_baud          (NMSettingSerial *setting);
-
---- - - - - - - - - - - -

setting :

the NMSettingSerial -

Returns :

the "baud" property of the setting
-
-
-
-

nm_setting_serial_get_bits ()

-
guint               nm_setting_serial_get_bits          (NMSettingSerial *setting);
-
---- - - - - - - - - - - -

setting :

the NMSettingSerial -

Returns :

the "bits" property of the setting
-
-
-
-

nm_setting_serial_get_parity ()

-
char                nm_setting_serial_get_parity        (NMSettingSerial *setting);
-
---- - - - - - - - - - - -

setting :

the NMSettingSerial -

Returns :

the "parity" property of the setting
-
-
-
-

nm_setting_serial_get_stopbits ()

-
guint               nm_setting_serial_get_stopbits      (NMSettingSerial *setting);
-
---- - - - - - - - - - - -

setting :

the NMSettingSerial -

Returns :

the "stopbits" property of the setting
-
-
-
-

nm_setting_serial_get_send_delay ()

-
guint64             nm_setting_serial_get_send_delay    (NMSettingSerial *setting);
-
---- - - - - - - - - - - -

setting :

the NMSettingSerial -

Returns :

the "send-delay" property of the setting
-

Property Details

-

The "baud" property

-
  "baud"                     guint                 : Read / Write / Construct
-

-Speed to use for communication over the serial port. Note that this -value usually has no effect for mobile broadband modems as they generally -ignore speed settings and use the highest available speed. -

+

The “baud” property

+
  “baud”                     guint
+

+

Flags: Read / Write / Construct

Default value: 57600


-

The "bits" property

-
  "bits"                     guint                 : Read / Write / Construct
-

-Byte-width of the serial communication. The 8 in "8n1" for example. -

+

The “bits” property

+
  “bits”                     guint
+

+

Flags: Read / Write / Construct

Allowed values: [5,8]

Default value: 8


-

The "parity" property

-
  "parity"                   gchar                 : Read / Write / Construct
-

-Parity setting of the serial port. Either 'E' for even parity, 'o' for -odd parity, or 'n' for no parity. -

+

The “parity” property

+
  “parity”                   gchar
+

+

Flags: Read / Write / Construct

Allowed values: [69,111]

Default value: 110


-

The "send-delay" property

-
  "send-delay"               guint64               : Read / Write / Construct
-

-Time to delay between each byte sent to the modem, in microseconds. -

+

The “send-delay” property

+
  “send-delay”               guint64
+

+

Flags: Read / Write / Construct

Default value: 0


-

The "stopbits" property

-
  "stopbits"                 guint                 : Read / Write / Construct
-

-Number of stop bits for communication on the serial port. Either 1 or 2. -The 1 in "8n1" for example. -

+

The “stopbits” property

+
  “stopbits”                 guint
+

+

Flags: Read / Write / Construct

Allowed values: [1,2]

Default value: 1

@@ -420,6 +509,6 @@ The 1 in "8n1" for example.
+ Generated by GTK-Doc V1.21
\ No newline at end of file diff --git a/docs/libnm-util/html/NMSettingTeam.html b/docs/libnm-util/html/NMSettingTeam.html index 024575eb..fb7ee6a7 100644 --- a/docs/libnm-util/html/NMSettingTeam.html +++ b/docs/libnm-util/html/NMSettingTeam.html @@ -2,34 +2,28 @@ -NMSettingTeam +libnm-util Reference Manual: NMSettingTeam - + - - - - - - - - - - + + + + + + +
@@ -37,254 +31,298 @@

NMSettingTeam

NMSettingTeam — Describes connection properties for teams

- +
- -
-

Object Hierarchy

-
-  GEnum
-   +----NMSettingTeamError
-
-
-  GObject
-   +----NMSetting
-         +----NMSettingTeam
-
-
-
-

Properties

-
-  "config"                   gchar*                : Read / Write
-  "interface-name"           gchar*                : Read / Write
-
-
-
-

Description

-

-The NMSettingTeam object is a NMSetting subclass that describes properties -necessary for team connections. -

-
-

Details

-
-

NM_SETTING_TEAM_SETTING_NAME

-
#define NM_SETTING_TEAM_SETTING_NAME "team"
-
-

-

-
-
-
-

enum NMSettingTeamError

-
typedef enum {
-	NM_SETTING_TEAM_ERROR_UNKNOWN = 0,      /*< nick=UnknownError >*/
-	NM_SETTING_TEAM_ERROR_INVALID_PROPERTY, /*< nick=InvalidProperty >*/
-	NM_SETTING_TEAM_ERROR_MISSING_PROPERTY, /*< nick=MissingProperty >*/
-} NMSettingTeamError;
-
-
+

Functions

+
--++ - - + + + + + - - + - - +

NM_SETTING_TEAM_ERROR_UNKNOWN

unknown or unclassified error + +GQuark + +nm_setting_team_error_quark () +
+NMSetting * + +nm_setting_team_new ()

NM_SETTING_TEAM_ERROR_INVALID_PROPERTY

the property was invalid +const char * + +nm_setting_team_get_interface_name ()

NM_SETTING_TEAM_ERROR_MISSING_PROPERTY

the property was missing and is -required +const char * + +nm_setting_team_get_config ()
-
-
-

NM_SETTING_TEAM_ERROR

-
#define NM_SETTING_TEAM_ERROR nm_setting_team_error_quark ()
-
-

-

+
+

Properties

+
+++++ + + + + + + + + + + + + +
+gchar *configRead / Write
+gchar *interface-nameRead / Write
-
-
-

nm_setting_team_error_quark ()

-
GQuark              nm_setting_team_error_quark         (void);
-

-Registers an error quark for NMSettingTeam if necessary. -

-
+
+

Types and Values

+
--++ - - - - + + + + + + + + + + + + + + + + + + + + + +

Returns :

the error quark used for NMSettingTeam errors.
#defineNM_SETTING_TEAM_SETTING_NAME
enumNMSettingTeamError
#defineNM_SETTING_TEAM_ERROR
#defineNM_SETTING_TEAM_INTERFACE_NAME
#defineNM_SETTING_TEAM_CONFIG
-

Since 0.9.10

-
-
-

NM_SETTING_TEAM_INTERFACE_NAME

-
#define NM_SETTING_TEAM_INTERFACE_NAME "interface-name"
+
+

Object Hierarchy

+
    GEnum
+    ╰── NMSettingTeamError
+    GObject
+    ╰── NMSetting
+        ╰── NMSettingTeam
 
-

-

-
-
-

NM_SETTING_TEAM_CONFIG

-
#define NM_SETTING_TEAM_CONFIG "config"
+
+

Includes

+
#include <nm-setting-team.h>
 
-

-

-
+
+

Description

+

The NMSettingTeam object is a NMSetting subclass that describes properties +necessary for team connections.

+
+
+

Functions

-

NMSettingTeam

-
typedef struct _NMSettingTeam NMSettingTeam;
-

-

+

nm_setting_team_error_quark ()

+
GQuark
+nm_setting_team_error_quark (void);
+

Registers an error quark for NMSettingTeam if necessary.

+
+

Returns

+

the error quark used for NMSettingTeam errors.

+

+
+

Since 0.9.10


-

NMSettingTeamClass

-
typedef struct {
-	NMSettingClass parent;
-
-	/* Padding for future expansion */
-	void (*_reserved1) (void);
-	void (*_reserved2) (void);
-	void (*_reserved3) (void);
-	void (*_reserved4) (void);
-} NMSettingTeamClass;
-
-

-

+

nm_setting_team_new ()

+
NMSetting *
+nm_setting_team_new (void);
+

Creates a new NMSettingTeam object with default values.

+
+

Returns

+

the new empty NMSettingTeam object.

+

[transfer full]

+
+

Since 0.9.10


-

nm_setting_team_new ()

-
NMSetting *         nm_setting_team_new                 (void);
-

-Creates a new NMSettingTeam object with default values. -

-
+

nm_setting_team_get_interface_name ()

+
const char *
+nm_setting_team_get_interface_name (NMSettingTeam *setting);
+
+

Parameters

+
--+++ - - + + +

Returns :

the new empty NMSettingTeam object. [transfer full] -

setting

the NMSettingTeam

 
+
+
+

Returns

+

the “interface-name” property of the setting

+

+

Since 0.9.10


-

nm_setting_team_get_interface_name ()

-
const char *        nm_setting_team_get_interface_name  (NMSettingTeam *setting);
-
+

nm_setting_team_get_config ()

+
const char *
+nm_setting_team_get_config (NMSettingTeam *setting);
+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSettingTeam -

Returns :

the "interface-name" property of the setting

setting

the NMSettingTeam

 
+
+
+

Returns

+

the “config” property of the setting

+

+

Since 0.9.10

+
+
+

Types and Values

+
+

NM_SETTING_TEAM_SETTING_NAME

+
#define NM_SETTING_TEAM_SETTING_NAME "team"
+
+

+

+

-

nm_setting_team_get_config ()

-
const char *        nm_setting_team_get_config          (NMSettingTeam *setting);
-
+

enum NMSettingTeamError

+
+

Members

+
--+++ - - + + + + + + + - - + + +

setting :

the NMSettingTeam +

NM_SETTING_TEAM_ERROR_UNKNOWN

+

unknown or unclassified error

+
 

NM_SETTING_TEAM_ERROR_INVALID_PROPERTY

+

the property was invalid

 

Returns :

the "config" property of the setting

NM_SETTING_TEAM_ERROR_MISSING_PROPERTY

+

the property was missing and is +required

+
 
-

Since 0.9.10

-
-

Property Details

+
-

The "config" property

-
  "config"                   gchar*                : Read / Write
+

NM_SETTING_TEAM_ERROR

+
#define NM_SETTING_TEAM_ERROR nm_setting_team_error_quark ()
+

-The JSON configuration for the team network interface. The property -should contain raw JSON configuration data suitable for teamd, because -the value is passed directly to teamd. If not specified, the default -configuration is used. See man teamd.conf for the format details.

-

Default value: NULL


-

The "interface-name" property

-
  "interface-name"           gchar*                : Read / Write
+

NM_SETTING_TEAM_INTERFACE_NAME

+
#define NM_SETTING_TEAM_INTERFACE_NAME "interface-name"
+
+

+

+
+
+
+

NM_SETTING_TEAM_CONFIG

+
#define NM_SETTING_TEAM_CONFIG "config"
+

-The name of the virtual in-kernel team network interface

+
+
+
+

Property Details

+
+

The “config” property

+
  “config”                   gchar *
+

+

Flags: Read / Write

+

Default value: NULL

+
+
+
+

The “interface-name” property

+
  “interface-name”           gchar *
+

+

Flags: Read / Write

Default value: NULL

+ Generated by GTK-Doc V1.21
\ No newline at end of file diff --git a/docs/libnm-util/html/NMSettingTeamPort.html b/docs/libnm-util/html/NMSettingTeamPort.html index e91aa68b..f29e7b88 100644 --- a/docs/libnm-util/html/NMSettingTeamPort.html +++ b/docs/libnm-util/html/NMSettingTeamPort.html @@ -2,34 +2,28 @@ -NMSettingTeamPort +libnm-util Reference Manual: NMSettingTeamPort - + - - - - - - - - - - + + + + + + +
@@ -37,51 +31,161 @@

NMSettingTeamPort

NMSettingTeamPort — Describes connection properties for team ports

- +
-
-

Synopsis

-
-#include <nm-setting-team-port.h>
-
-#define             NM_SETTING_TEAM_PORT_SETTING_NAME
-enum                NMSettingTeamPortError;
-#define             NM_SETTING_TEAM_PORT_ERROR
-GQuark              nm_setting_team_port_error_quark    (void);
-#define             NM_SETTING_TEAM_PORT_CONFIG
-                    NMSettingTeamPort;
-                    NMSettingTeamPortClass;
-NMSetting *         nm_setting_team_port_new            (void);
-const char *        nm_setting_team_port_get_config     (NMSettingTeamPort *setting);
-
+
+

Functions

+
++++ + + + + + + + + + + + + + + +
+GQuark + +nm_setting_team_port_error_quark () +
+NMSetting * + +nm_setting_team_port_new () +
const char * + +nm_setting_team_port_get_config () +
+
+
+

Properties

+
+++++ + + + + + +
+gchar *configRead / Write
+
+
+

Types and Values

+

Object Hierarchy

-
-  GEnum
-   +----NMSettingTeamPortError
-
-
-  GObject
-   +----NMSetting
-         +----NMSettingTeamPort
+
    GEnum
+    ╰── NMSettingTeamPortError
+    GObject
+    ╰── NMSetting
+        ╰── NMSettingTeamPort
 
-

Properties

-
-  "config"                   gchar*                : Read / Write
+

Includes

+
#include <nm-setting-team-port.h>
 

Description

-

-The NMSettingTeamPort object is a NMSetting subclass that describes -optional properties that apply to team ports. -

+

The NMSettingTeamPort object is a NMSetting subclass that describes +optional properties that apply to team ports.

+
+
+

Functions

+
+

nm_setting_team_port_error_quark ()

+
GQuark
+nm_setting_team_port_error_quark (void);
+

Registers an error quark for NMSettingTeamPort if necessary.

+
+

Returns

+

the error quark used for NMSettingTeamPort errors.

+

+
+

Since 0.9.10

+
+
+
+

nm_setting_team_port_new ()

+
NMSetting *
+nm_setting_team_port_new (void);
+

Creates a new NMSettingTeamPort object with default values.

+
+

Returns

+

the new empty NMSettingTeamPort object.

+

[transfer full]

+
+

Since 0.9.10

+
+
+
+

nm_setting_team_port_get_config ()

+
const char *
+nm_setting_team_port_get_config (NMSettingTeamPort *setting);
+
+

Parameters

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

setting

the NMSettingTeamPort

 
+
+
+

Returns

+

the “config” property of the setting

+

+
+

Since 0.9.10

+
-

Details

+

Types and Values

NM_SETTING_TEAM_PORT_SETTING_NAME

#define NM_SETTING_TEAM_PORT_SETTING_NAME "team-port"
@@ -91,38 +195,42 @@ optional properties that apply to team ports.
 

-

enum NMSettingTeamPortError

-
typedef enum {
-	NM_SETTING_TEAM_PORT_ERROR_UNKNOWN = 0,      /*< nick=UnknownError >*/
-	NM_SETTING_TEAM_PORT_ERROR_INVALID_PROPERTY, /*< nick=InvalidProperty >*/
-	NM_SETTING_TEAM_PORT_ERROR_MISSING_PROPERTY, /*< nick=MissingProperty >*/
-} NMSettingTeamPortError;
-
-
+

enum NMSettingTeamPortError

+
+

Members

+
--+++ - - + + - - + + - - + +

NM_SETTING_TEAM_PORT_ERROR_UNKNOWN

unknown or unclassified error +

NM_SETTING_TEAM_PORT_ERROR_UNKNOWN

+

unknown or unclassified error

 

NM_SETTING_TEAM_PORT_ERROR_INVALID_PROPERTY

the property was invalid +

NM_SETTING_TEAM_PORT_ERROR_INVALID_PROPERTY

+

the property was invalid

 

NM_SETTING_TEAM_PORT_ERROR_MISSING_PROPERTY

the property was missing and -is required +

NM_SETTING_TEAM_PORT_ERROR_MISSING_PROPERTY

+

the property was missing and +is required

 
+

NM_SETTING_TEAM_PORT_ERROR

@@ -133,115 +241,26 @@ is required

-

nm_setting_team_port_error_quark ()

-
GQuark              nm_setting_team_port_error_quark    (void);
-

-Registers an error quark for NMSettingTeamPort if necessary. -

-
---- - - - - -

Returns :

the error quark used for NMSettingTeamPort errors.
-

Since 0.9.10

-
-
-

NM_SETTING_TEAM_PORT_CONFIG

#define NM_SETTING_TEAM_PORT_CONFIG     "config"
 

-
-
-

NMSettingTeamPort

-
typedef struct _NMSettingTeamPort NMSettingTeamPort;
-

-

-
-
-
-

NMSettingTeamPortClass

-
typedef struct {
-	NMSettingClass parent;
-
-	/* Padding for future expansion */
-	void (*_reserved1) (void);
-	void (*_reserved2) (void);
-	void (*_reserved3) (void);
-	void (*_reserved4) (void);
-} NMSettingTeamPortClass;
-
-

-

-
-
-
-

nm_setting_team_port_new ()

-
NMSetting *         nm_setting_team_port_new            (void);
-

-Creates a new NMSettingTeamPort object with default values. -

-
---- - - - - -

Returns :

the new empty NMSettingTeamPort object. [transfer full] -
-

Since 0.9.10

-
-
-
-

nm_setting_team_port_get_config ()

-
const char *        nm_setting_team_port_get_config     (NMSettingTeamPort *setting);
-
---- - - - - - - - - - - -

setting :

the NMSettingTeamPort -

Returns :

the "config" property of the setting
-

Since 0.9.10

-

Property Details

-

The "config" property

-
  "config"                   gchar*                : Read / Write
-

-The JSON configuration for the team port. The property should contain raw -JSON configuration data suitable for teamd, because the value is passed -directly to teamd. If not specified, the default configuration is -used. See man teamd.conf for the format details. -

+

The “config” property

+
  “config”                   gchar *
+

+

Flags: Read / Write

Default value: NULL

+ Generated by GTK-Doc V1.21
\ No newline at end of file diff --git a/docs/libnm-util/html/NMSettingVPN.html b/docs/libnm-util/html/NMSettingVPN.html index 97cc809f..52bf704f 100644 --- a/docs/libnm-util/html/NMSettingVPN.html +++ b/docs/libnm-util/html/NMSettingVPN.html @@ -2,34 +2,28 @@ -NMSettingVPN +libnm-util Reference Manual: NMSettingVPN - + - - - - - - - - - - + + + + + + +
@@ -37,716 +31,893 @@

NMSettingVPN

NMSettingVPN — Describes connection properties for Virtual Private Networks

- +
-
-

Synopsis

-
-#include <nm-setting-vpn.h>
-
-#define             NM_SETTING_VPN_SETTING_NAME
-enum                NMSettingVpnError;
-#define             NM_SETTING_VPN_ERROR
-GQuark              nm_setting_vpn_error_quark          (void);
-#define             NM_SETTING_VPN_SERVICE_TYPE
-#define             NM_SETTING_VPN_USER_NAME
-#define             NM_SETTING_VPN_PERSISTENT
-#define             NM_SETTING_VPN_DATA
-#define             NM_SETTING_VPN_SECRETS
-                    NMSettingVPN;
-                    NMSettingVPNClass;
-void                (*NMVPNIterFunc)                    (const char *key,
-                                                         const char *value,
-                                                         gpointer user_data);
-NMSetting *         nm_setting_vpn_new                  (void);
-const char *        nm_setting_vpn_get_service_type     (NMSettingVPN *setting);
-const char *        nm_setting_vpn_get_user_name        (NMSettingVPN *setting);
-gboolean            nm_setting_vpn_get_persistent       (NMSettingVPN *setting);
-guint32             nm_setting_vpn_get_num_data_items   (NMSettingVPN *setting);
-void                nm_setting_vpn_add_data_item        (NMSettingVPN *setting,
-                                                         const char *key,
-                                                         const char *item);
-const char *        nm_setting_vpn_get_data_item        (NMSettingVPN *setting,
-                                                         const char *key);
-gboolean            nm_setting_vpn_remove_data_item     (NMSettingVPN *setting,
-                                                         const char *key);
-void                nm_setting_vpn_foreach_data_item    (NMSettingVPN *setting,
-                                                         NMVPNIterFunc func,
-                                                         gpointer user_data);
-guint32             nm_setting_vpn_get_num_secrets      (NMSettingVPN *setting);
-void                nm_setting_vpn_add_secret           (NMSettingVPN *setting,
-                                                         const char *key,
-                                                         const char *secret);
-const char *        nm_setting_vpn_get_secret           (NMSettingVPN *setting,
-                                                         const char *key);
-gboolean            nm_setting_vpn_remove_secret        (NMSettingVPN *setting,
-                                                         const char *key);
-void                nm_setting_vpn_foreach_secret       (NMSettingVPN *setting,
-                                                         NMVPNIterFunc func,
-                                                         gpointer user_data);
-
+
+

Functions

+
++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+GQuark + +nm_setting_vpn_error_quark () +
+void + +(*NMVPNIterFunc) () +
+NMSetting * + +nm_setting_vpn_new () +
const char * + +nm_setting_vpn_get_service_type () +
const char * + +nm_setting_vpn_get_user_name () +
+gboolean + +nm_setting_vpn_get_persistent () +
+guint32 + +nm_setting_vpn_get_num_data_items () +
+void + +nm_setting_vpn_add_data_item () +
const char * + +nm_setting_vpn_get_data_item () +
+gboolean + +nm_setting_vpn_remove_data_item () +
+void + +nm_setting_vpn_foreach_data_item () +
+guint32 + +nm_setting_vpn_get_num_secrets () +
+void + +nm_setting_vpn_add_secret () +
const char * + +nm_setting_vpn_get_secret () +
+gboolean + +nm_setting_vpn_remove_secret () +
+void + +nm_setting_vpn_foreach_secret () +
+
+
+

Properties

+
+++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + +
GHashTable_gchararray+gchararray_*dataRead / Write
gbooleanpersistentRead / Write
GHashTable_gchararray+gchararray_*secretsRead / Write
+gchar *service-typeRead / Write
+gchar *user-nameRead / Write
+
+
+

Types and Values

+
++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
#defineNM_SETTING_VPN_SETTING_NAME
enumNMSettingVpnError
#defineNM_SETTING_VPN_ERROR
#defineNM_SETTING_VPN_SERVICE_TYPE
#defineNM_SETTING_VPN_USER_NAME
#defineNM_SETTING_VPN_PERSISTENT
#defineNM_SETTING_VPN_DATA
#defineNM_SETTING_VPN_SECRETS

Object Hierarchy

-
-  GEnum
-   +----NMSettingVpnError
-
-
-  GObject
-   +----NMSetting
-         +----NMSettingVPN
+
    GEnum
+    ╰── NMSettingVpnError
+    GObject
+    ╰── NMSetting
+        ╰── NMSettingVPN
 
-

Properties

-
-  "data"                     GHashTable_gchararray+gchararray_*  : Read / Write
-  "persistent"               gboolean              : Read / Write
-  "secrets"                  GHashTable_gchararray+gchararray_*  : Read / Write
-  "service-type"             gchar*                : Read / Write
-  "user-name"                gchar*                : Read / Write
+

Includes

+
#include <nm-setting-vpn.h>
 

Description

-

-The NMSettingVPN object is a NMSetting subclass that describes properties +

The NMSettingVPN object is a NMSetting subclass that describes properties necessary for connection to Virtual Private Networks. NetworkManager uses a plugin architecture to allow easier use of new VPN types, and this setting abstracts the configuration for those plugins. Since the configuration options are only known to the VPN plugins themselves, the VPN configuration options are stored as key/value pairs of strings rather than GObject -properties. -

+properties.

-

Details

+

Functions

-

NM_SETTING_VPN_SETTING_NAME

-
#define NM_SETTING_VPN_SETTING_NAME "vpn"
-
-

-

+

nm_setting_vpn_error_quark ()

+
GQuark
+nm_setting_vpn_error_quark (void);
+

Registers an error quark for NMSettingVPN if necessary.

+
+

Returns

+

the error quark used for NMSettingVPN errors.

+

+

-

enum NMSettingVpnError

-
typedef enum {
-	NM_SETTING_VPN_ERROR_UNKNOWN = 0,      /*< nick=UnknownError >*/
-	NM_SETTING_VPN_ERROR_INVALID_PROPERTY, /*< nick=InvalidProperty >*/
-	NM_SETTING_VPN_ERROR_MISSING_PROPERTY, /*< nick=MissingProperty >*/
-} NMSettingVpnError;
-
-
+

NMVPNIterFunc ()

+
void
+(*NMVPNIterFunc) (const char *key,
+                  const char *value,
+                  gpointer user_data);
+
+

Parameters

+
--+++ - - + + + - - + + + - - + + +

NM_SETTING_VPN_ERROR_UNKNOWN

unknown or unclassified error -

key

the name of the data or secret item

 

NM_SETTING_VPN_ERROR_INVALID_PROPERTY

the property was invalid -

value

the value of the data or secret item

 

NM_SETTING_VPN_ERROR_MISSING_PROPERTY

the property was missing and is -required -

user_data

User data passed to nm_setting_vpn_foreach_data_item() or +nm_setting_vpn_foreach_secret()

 
+

-

NM_SETTING_VPN_ERROR

-
#define NM_SETTING_VPN_ERROR nm_setting_vpn_error_quark ()
-
-

-

+

nm_setting_vpn_new ()

+
NMSetting *
+nm_setting_vpn_new (void);
+

Creates a new NMSettingVPN object with default values.

+
+

Returns

+

the new empty NMSettingVPN object.

+

[transfer full]

+

-

nm_setting_vpn_error_quark ()

-
GQuark              nm_setting_vpn_error_quark          (void);
-

-Registers an error quark for NMSettingVPN if necessary. -

-
+

nm_setting_vpn_get_service_type ()

+
const char *
+nm_setting_vpn_get_service_type (NMSettingVPN *setting);
+

Returns the service name of the VPN, which identifies the specific VPN +plugin that should be used to connect to this VPN.

+
+

Parameters

+
--+++ - - + + +

Returns :

the error quark used for NMSettingVPN errors.

setting

the NMSettingVPN

 
-
-
-

NM_SETTING_VPN_SERVICE_TYPE

-
#define NM_SETTING_VPN_SERVICE_TYPE "service-type"
-
-

-

+
+

Returns

+

the VPN plugin's service name

+

-
-
-

NM_SETTING_VPN_USER_NAME

-
#define NM_SETTING_VPN_USER_NAME    "user-name"
-
-

-


-

NM_SETTING_VPN_PERSISTENT

-
#define NM_SETTING_VPN_PERSISTENT   "persistent"
-
-

-

+

nm_setting_vpn_get_user_name ()

+
const char *
+nm_setting_vpn_get_user_name (NMSettingVPN *setting);
+
+

Parameters

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

setting

the NMSettingVPN

 
-
-
-

NM_SETTING_VPN_DATA

-
#define NM_SETTING_VPN_DATA         "data"
-
-

-

+
+

Returns

+

the “user-name” property of the setting

+

-
-
-

NM_SETTING_VPN_SECRETS

-
#define NM_SETTING_VPN_SECRETS      "secrets"
-
-

-


-

NMSettingVPN

-
typedef struct _NMSettingVPN NMSettingVPN;
-

-

-
-
-
-

NMSettingVPNClass

-
typedef struct {
-	NMSettingClass parent;
-
-	/* Padding for future expansion */
-	void (*_reserved1) (void);
-	void (*_reserved2) (void);
-	void (*_reserved3) (void);
-	void (*_reserved4) (void);
-} NMSettingVPNClass;
-
-

-

-
-
-
-

NMVPNIterFunc ()

-
void                (*NMVPNIterFunc)                    (const char *key,
-                                                         const char *value,
-                                                         gpointer user_data);
-
+

nm_setting_vpn_get_persistent ()

+
gboolean
+nm_setting_vpn_get_persistent (NMSettingVPN *setting);
+
+

Parameters

+
--+++ - - - - - - - - - - - - - - + + + + +

key :

the name of the data or secret item

value :

the value of the data or secret item

user_data :

User data passed to nm_setting_vpn_foreach_data_item() or -nm_setting_vpn_foreach_secret() -

setting

the NMSettingVPN

 
+
+

Returns

+

the “persistent” property of the setting

+

+
+

-

nm_setting_vpn_new ()

-
NMSetting *         nm_setting_vpn_new                  (void);
-

-Creates a new NMSettingVPN object with default values. -

-
+

nm_setting_vpn_get_num_data_items ()

+
guint32
+nm_setting_vpn_get_num_data_items (NMSettingVPN *setting);
+

Gets number of key/value pairs of VPN configuration data.

+
+

Parameters

+
--+++ - - + + +

Returns :

the new empty NMSettingVPN object. [transfer full] -

setting

the NMSettingVPN

 
+
+

Returns

+

the number of VPN plugin specific configuration data items

+

+
+

-

nm_setting_vpn_get_service_type ()

-
const char *        nm_setting_vpn_get_service_type     (NMSettingVPN *setting);
-

-Returns the service name of the VPN, which identifies the specific VPN -plugin that should be used to connect to this VPN. -

-
+

nm_setting_vpn_add_data_item ()

+
void
+nm_setting_vpn_add_data_item (NMSettingVPN *setting,
+                              const char *key,
+                              const char *item);
+

Establishes a relationship between key + and item + internally in the +setting which may be retrieved later. Should not be used to store passwords +or other secrets, which is what nm_setting_vpn_add_secret() is for.

+
+

Parameters

+
--+++ - - - - - - + + + - -

setting :

the NMSettingVPN -

Returns :

the VPN plugin's service name

setting

the NMSettingVPN

 
-
-
-
-

nm_setting_vpn_get_user_name ()

-
const char *        nm_setting_vpn_get_user_name        (NMSettingVPN *setting);
-
---- - - - + + + - - + + +

setting :

the NMSettingVPN -

key

a name that uniquely identifies the given value item +

 

Returns :

the "user-name" property of the setting

item

the value to be referenced by key +

 
+

-

nm_setting_vpn_get_persistent ()

-
gboolean            nm_setting_vpn_get_persistent       (NMSettingVPN *setting);
-
+

nm_setting_vpn_get_data_item ()

+
const char *
+nm_setting_vpn_get_data_item (NMSettingVPN *setting,
+                              const char *key);
+

Retrieves the data item of a key/value relationship previously established +by nm_setting_vpn_add_data_item().

+
+

Parameters

+
--+++ - - + + + - - + + +

setting :

the NMSettingVPN -

setting

the NMSettingVPN

 

Returns :

the "persistent" property of the setting

key

the name of the data item to retrieve

 
+
+

Returns

+

the data item, if any

+

+
+

-

nm_setting_vpn_get_num_data_items ()

-
guint32             nm_setting_vpn_get_num_data_items   (NMSettingVPN *setting);
-

-Gets number of key/value pairs of VPN configuration data. -

-
+

nm_setting_vpn_remove_data_item ()

+
gboolean
+nm_setting_vpn_remove_data_item (NMSettingVPN *setting,
+                                 const char *key);
+

Deletes a key/value relationship previously established by +nm_setting_vpn_add_data_item().

+
+

Parameters

+
--+++ - - + + + - - + + +

setting :

the NMSettingVPN -

setting

the NMSettingVPN

 

Returns :

the number of VPN plugin specific configuration data items

key

the name of the data item to remove

 
+
+

Returns

+

TRUE if the data item was found and removed from the internal list, +FALSE if it was not.

+

+
+

-

nm_setting_vpn_add_data_item ()

-
void                nm_setting_vpn_add_data_item        (NMSettingVPN *setting,
-                                                         const char *key,
-                                                         const char *item);
-

-Establishes a relationship between key and item internally in the -setting which may be retrieved later. Should not be used to store passwords -or other secrets, which is what nm_setting_vpn_add_secret() is for. -

-
+

nm_setting_vpn_foreach_data_item ()

+
void
+nm_setting_vpn_foreach_data_item (NMSettingVPN *setting,
+                                  NMVPNIterFunc func,
+                                  gpointer user_data);
+

Iterates all data items stored in this setting. It is safe to add, remove, +and modify data items inside func +, though any additions or removals made +during iteration will not be part of the iteration.

+
+

Parameters

+
--+++ - - + + + - - + + + - - + + +

setting :

the NMSettingVPN -

setting

a NMSettingVPN

 

key :

a name that uniquely identifies the given value item -

func

an user provided function.

[scope call]

item :

the value to be referenced by key -

user_data

data to be passed to func +

 
+
-

nm_setting_vpn_get_data_item ()

-
const char *        nm_setting_vpn_get_data_item        (NMSettingVPN *setting,
-                                                         const char *key);
-

-Retrieves the data item of a key/value relationship previously established -by nm_setting_vpn_add_data_item(). -

-
+

nm_setting_vpn_get_num_secrets ()

+
guint32
+nm_setting_vpn_get_num_secrets (NMSettingVPN *setting);
+

Gets number of VPN plugin specific secrets in the setting.

+
+

Parameters

+
--+++ - - - - - - - - - - - - - - + + + + +

setting :

the NMSettingVPN -

key :

the name of the data item to retrieve

Returns :

the data item, if any

setting

the NMSettingVPN

 
+
+

Returns

+

the number of VPN plugin specific secrets

+

+
+
-

nm_setting_vpn_remove_data_item ()

-
gboolean            nm_setting_vpn_remove_data_item     (NMSettingVPN *setting,
-                                                         const char *key);
-

-Deletes a key/value relationship previously established by -nm_setting_vpn_add_data_item(). -

-
+

nm_setting_vpn_add_secret ()

+
void
+nm_setting_vpn_add_secret (NMSettingVPN *setting,
+                           const char *key,
+                           const char *secret);
+

Establishes a relationship between key + and secret + internally in the +setting which may be retrieved later.

+
+

Parameters

+
--+++ - - + + + - - + + + - - + + +

setting :

the NMSettingVPN -

setting

the NMSettingVPN

 

key :

the name of the data item to remove

key

a name that uniquely identifies the given secret secret +

 

Returns :

-TRUE if the data item was found and removed from the internal list, -FALSE if it was not.

secret

the secret to be referenced by key +

 
+
-

nm_setting_vpn_foreach_data_item ()

-
void                nm_setting_vpn_foreach_data_item    (NMSettingVPN *setting,
-                                                         NMVPNIterFunc func,
-                                                         gpointer user_data);
-

-Iterates all data items stored in this setting. It is safe to add, remove, -and modify data items inside func, though any additions or removals made -during iteration will not be part of the iteration. -

-
+

nm_setting_vpn_get_secret ()

+
const char *
+nm_setting_vpn_get_secret (NMSettingVPN *setting,
+                           const char *key);
+

Retrieves the secret of a key/value relationship previously established +by nm_setting_vpn_add_secret().

+
+

Parameters

+
--+++ - - + + + - - - - - - + + +

setting :

a NMSettingVPN -

setting

the NMSettingVPN

 

func :

an user provided function. [scope call] -

user_data :

data to be passed to func -

key

the name of the secret to retrieve

 
+
+

Returns

+

the secret, if any

+

+
+
-

nm_setting_vpn_get_num_secrets ()

-
guint32             nm_setting_vpn_get_num_secrets      (NMSettingVPN *setting);
-

-Gets number of VPN plugin specific secrets in the setting. -

-
+

nm_setting_vpn_remove_secret ()

+
gboolean
+nm_setting_vpn_remove_secret (NMSettingVPN *setting,
+                              const char *key);
+

Deletes a key/value relationship previously established by +nm_setting_vpn_add_secret().

+
+

Parameters

+
--+++ - - + + + - - + + +

setting :

the NMSettingVPN -

setting

the NMSettingVPN

 

Returns :

the number of VPN plugin specific secrets

key

the name of the secret to remove

 
+
+

Returns

+

TRUE if the secret was found and removed from the internal list, +FALSE if it was not.

+

+
+
-

nm_setting_vpn_add_secret ()

-
void                nm_setting_vpn_add_secret           (NMSettingVPN *setting,
-                                                         const char *key,
-                                                         const char *secret);
-

-Establishes a relationship between key and secret internally in the -setting which may be retrieved later. -

-
+

nm_setting_vpn_foreach_secret ()

+
void
+nm_setting_vpn_foreach_secret (NMSettingVPN *setting,
+                               NMVPNIterFunc func,
+                               gpointer user_data);
+

Iterates all secrets stored in this setting. It is safe to add, remove, +and modify secrets inside func +, though any additions or removals made during +iteration will not be part of the iteration.

+
+

Parameters

+
--+++ - - + + + - - + + + - - + + +

setting :

the NMSettingVPN -

setting

a NMSettingVPN

 

key :

a name that uniquely identifies the given secret secret -

func

an user provided function.

[scope call]

secret :

the secret to be referenced by key -

user_data

data to be passed to func +

 
-
+ + +
+

Types and Values

-

nm_setting_vpn_get_secret ()

-
const char *        nm_setting_vpn_get_secret           (NMSettingVPN *setting,
-                                                         const char *key);
+

NM_SETTING_VPN_SETTING_NAME

+
#define NM_SETTING_VPN_SETTING_NAME "vpn"
+

-Retrieves the secret of a key/value relationship previously established -by nm_setting_vpn_add_secret().

-
+ +
+
+

enum NMSettingVpnError

+
+

Members

+
--+++ - - + + - - + + + - - + + +

setting :

the NMSettingVPN +

NM_SETTING_VPN_ERROR_UNKNOWN

+

unknown or unclassified error

 

key :

the name of the secret to retrieve

NM_SETTING_VPN_ERROR_INVALID_PROPERTY

+

the property was invalid

+
 

Returns :

the secret, if any

NM_SETTING_VPN_ERROR_MISSING_PROPERTY

+

the property was missing and is +required

+
 
+

-

nm_setting_vpn_remove_secret ()

-
gboolean            nm_setting_vpn_remove_secret        (NMSettingVPN *setting,
-                                                         const char *key);
+

NM_SETTING_VPN_ERROR

+
#define NM_SETTING_VPN_ERROR nm_setting_vpn_error_quark ()
+

-Deletes a key/value relationship previously established by -nm_setting_vpn_add_secret().

-
---- - - - - - - - - - - - - - - -

setting :

the NMSettingVPN -

key :

the name of the secret to remove

Returns :

-TRUE if the secret was found and removed from the internal list, -FALSE if it was not.

-

nm_setting_vpn_foreach_secret ()

-
void                nm_setting_vpn_foreach_secret       (NMSettingVPN *setting,
-                                                         NMVPNIterFunc func,
-                                                         gpointer user_data);
+

NM_SETTING_VPN_SERVICE_TYPE

+
#define NM_SETTING_VPN_SERVICE_TYPE "service-type"
+

-Iterates all secrets stored in this setting. It is safe to add, remove, -and modify secrets inside func, though any additions or removals made during -iteration will not be part of the iteration.

-
---- - - - - - - - - - - - - - - -

setting :

a NMSettingVPN -

func :

an user provided function. [scope call] -

user_data :

data to be passed to func -
- -
-

Property Details

+
-

The "data" property

-
  "data"                     GHashTable_gchararray+gchararray_*  : Read / Write
+

NM_SETTING_VPN_USER_NAME

+
#define NM_SETTING_VPN_USER_NAME    "user-name"
+

-Dictionary of key/value pairs of VPN plugin specific data. Both keys and -values must be strings.


-

The "persistent" property

-
  "persistent"               gboolean              : Read / Write
+

NM_SETTING_VPN_PERSISTENT

+
#define NM_SETTING_VPN_PERSISTENT   "persistent"
+

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

-

Default value: FALSE


-

The "secrets" property

-
  "secrets"                  GHashTable_gchararray+gchararray_*  : Read / Write
+

NM_SETTING_VPN_DATA

+
#define NM_SETTING_VPN_DATA         "data"
+

-Dictionary of key/value pairs of VPN plugin specific secrets like -passwords or private keys. Both keys and values must be strings.


-

The "service-type" property

-
  "service-type"             gchar*                : Read / Write
+

NM_SETTING_VPN_SECRETS

+
#define NM_SETTING_VPN_SECRETS      "secrets"
+

-D-Bus service name of the VPN plugin that this setting uses to connect to -its network. i.e. org.freedesktop.NetworkManager.vpnc for the vpnc -plugin.

+
+
+
+

Property Details

+
+

The “data” property

+
  “data”                     GHashTable_gchararray+gchararray_*
+

+

Flags: Read / Write

+
+
+
+

The “persistent” property

+
  “persistent”               gboolean
+

+

Flags: Read / Write

+

Default value: FALSE

+
+
+
+

The “secrets” property

+
  “secrets”                  GHashTable_gchararray+gchararray_*
+

+

Flags: Read / Write

+
+
+
+

The “service-type” property

+
  “service-type”             gchar *
+

+

Flags: Read / Write

Default value: NULL


-

The "user-name" property

-
  "user-name"                gchar*                : Read / Write
-

-If the VPN connection requires a user name for authentication, that name -should be provided here. If the connection is available to more than one -user, and the VPN requires each user to supply a different name, then -leave this property empty. If this property is empty, NetworkManager -will automatically supply the username of the user which requested the -VPN connection. -

+

The “user-name” property

+
  “user-name”                gchar *
+

+

Flags: Read / Write

Default value: NULL

+ Generated by GTK-Doc V1.21 \ No newline at end of file diff --git a/docs/libnm-util/html/NMSettingVlan.html b/docs/libnm-util/html/NMSettingVlan.html index 161ee17a..be791417 100644 --- a/docs/libnm-util/html/NMSettingVlan.html +++ b/docs/libnm-util/html/NMSettingVlan.html @@ -2,34 +2,28 @@ -NMSettingVlan +libnm-util Reference Manual: NMSettingVlan - + - - - - - - - - - - + + + + + + +
@@ -37,822 +31,992 @@

NMSettingVlan

NMSettingVlan — Describes connection properties for VLAN interfaces

- +
-
-

Synopsis

-
-#include <nm-setting-vlan.h>
-
-#define             NM_SETTING_VLAN_SETTING_NAME
-enum                NMSettingVlanError;
-#define             NM_SETTING_VLAN_ERROR
-GQuark              nm_setting_vlan_error_quark         (void);
-#define             NM_SETTING_VLAN_INTERFACE_NAME
-#define             NM_SETTING_VLAN_PARENT
-#define             NM_SETTING_VLAN_ID
-#define             NM_SETTING_VLAN_FLAGS
-#define             NM_SETTING_VLAN_INGRESS_PRIORITY_MAP
-#define             NM_SETTING_VLAN_EGRESS_PRIORITY_MAP
-                    NMSettingVlan;
-                    NMSettingVlanClass;
-enum                NMVlanPriorityMap;
-enum                NMVlanFlags;
-NMSetting *         nm_setting_vlan_new                 (void);
-const char *        nm_setting_vlan_get_interface_name  (NMSettingVlan *setting);
-const char *        nm_setting_vlan_get_parent          (NMSettingVlan *setting);
-guint32             nm_setting_vlan_get_id              (NMSettingVlan *setting);
-guint32             nm_setting_vlan_get_flags           (NMSettingVlan *setting);
-gint32              nm_setting_vlan_get_num_priorities  (NMSettingVlan *setting,
-                                                         NMVlanPriorityMap map);
-gboolean            nm_setting_vlan_get_priority        (NMSettingVlan *setting,
-                                                         NMVlanPriorityMap map,
-                                                         guint32 idx,
-                                                         guint32 *out_from,
-                                                         guint32 *out_to);
-gboolean            nm_setting_vlan_add_priority        (NMSettingVlan *setting,
-                                                         NMVlanPriorityMap map,
-                                                         guint32 from,
-                                                         guint32 to);
-void                nm_setting_vlan_remove_priority     (NMSettingVlan *setting,
-                                                         NMVlanPriorityMap map,
-                                                         guint32 idx);
-gboolean            nm_setting_vlan_remove_priority_by_value
-                                                        (NMSettingVlan *setting,
-                                                         NMVlanPriorityMap map,
-                                                         guint32 from,
-                                                         guint32 to);
-gboolean            nm_setting_vlan_remove_priority_str_by_value
-                                                        (NMSettingVlan *setting,
-                                                         NMVlanPriorityMap map,
-                                                         const char *str);
-void                nm_setting_vlan_clear_priorities    (NMSettingVlan *setting,
-                                                         NMVlanPriorityMap map);
-gboolean            nm_setting_vlan_add_priority_str    (NMSettingVlan *setting,
-                                                         NMVlanPriorityMap map,
-                                                         const char *str);
-
-
-

Object Hierarchy

-
-  GEnum
-   +----NMSettingVlanError
-
-
-  GObject
-   +----NMSetting
-         +----NMSettingVlan
-
-
-  GEnum
-   +----NMVlanPriorityMap
-
-
-  GEnum
-   +----NMVlanFlags
-
-
-
-

Properties

-
-  "egress-priority-map"      GSList_gchararray_*   : Read / Write
-  "flags"                    guint                 : Read / Write / Construct
-  "id"                       guint                 : Read / Write / Construct
-  "ingress-priority-map"     GSList_gchararray_*   : Read / Write
-  "interface-name"           gchar*                : Read / Write / Construct
-  "parent"                   gchar*                : Read / Write / Construct
-
-
-
-

Description

-

-The NMSettingVlan object is a NMSetting subclass that describes properties -necessary for connection to VLAN interfaces. -

-
-
-

Details

-
-

NM_SETTING_VLAN_SETTING_NAME

-
#define NM_SETTING_VLAN_SETTING_NAME "vlan"
-
-

-

-
-
-
-

enum NMSettingVlanError

-
typedef enum {
-	NM_SETTING_VLAN_ERROR_UNKNOWN = 0,      /*< nick=Unknown >*/
-	NM_SETTING_VLAN_ERROR_INVALID_PROPERTY, /*< nick=InvalidProperty >*/
-	NM_SETTING_VLAN_ERROR_MISSING_PROPERTY, /*< nick=MissingProperty >*/
-	NM_SETTING_VLAN_ERROR_INVALID_PARENT    /*< nick=InvalidParent >*/
-} NMSettingVlanError;
-
-
+

Functions

+
--++ - - + + + + + + + + + + + + + + + + + + + + + - - + - - + - - + + + + + + + + + + + + + + + + + + + + +

NM_SETTING_VLAN_ERROR_UNKNOWN

unknown or unclassified error + +GQuark + +nm_setting_vlan_error_quark () +
+NMSetting * + +nm_setting_vlan_new () +
const char * + +nm_setting_vlan_get_interface_name () +
const char * + +nm_setting_vlan_get_parent () +
+guint32 + +nm_setting_vlan_get_id () +
+guint32 + +nm_setting_vlan_get_flags ()

NM_SETTING_VLAN_ERROR_INVALID_PROPERTY

the property was invalid + +gint32 + +nm_setting_vlan_get_num_priorities ()

NM_SETTING_VLAN_ERROR_MISSING_PROPERTY

the property was missing and is - required + +gboolean + +nm_setting_vlan_get_priority ()

NM_SETTING_VLAN_ERROR_INVALID_PARENT

the VLAN parent was specified - inconsistently + +gboolean + +nm_setting_vlan_add_priority () +
+void + +nm_setting_vlan_remove_priority () +
+gboolean + +nm_setting_vlan_remove_priority_by_value () +
+gboolean + +nm_setting_vlan_remove_priority_str_by_value () +
+void + +nm_setting_vlan_clear_priorities () +
+gboolean + +nm_setting_vlan_add_priority_str ()
-
-
-

NM_SETTING_VLAN_ERROR

-
#define NM_SETTING_VLAN_ERROR nm_setting_vlan_error_quark ()
-
-

-

+
+

Properties

+
+++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+GSList_gchararray_ *egress-priority-mapRead / Write
guintflagsRead / Write / Construct
guintidRead / Write / Construct
+GSList_gchararray_ *ingress-priority-mapRead / Write
+gchar *interface-nameRead / Write / Construct
+gchar *parentRead / Write / Construct
-
-
-

nm_setting_vlan_error_quark ()

-
GQuark              nm_setting_vlan_error_quark         (void);
-

-Registers an error quark for NMSettingVlan if necessary. -

-
+
+

Types and Values

+
--++ - - - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Returns :

the error quark used for NMSettingVlan errors.
#defineNM_SETTING_VLAN_SETTING_NAME
enumNMSettingVlanError
#defineNM_SETTING_VLAN_ERROR
#defineNM_SETTING_VLAN_INTERFACE_NAME
#defineNM_SETTING_VLAN_PARENT
#defineNM_SETTING_VLAN_ID
#defineNM_SETTING_VLAN_FLAGS
#defineNM_SETTING_VLAN_INGRESS_PRIORITY_MAP
#defineNM_SETTING_VLAN_EGRESS_PRIORITY_MAP
enumNMVlanPriorityMap
enumNMVlanFlags
-
-
-

NM_SETTING_VLAN_INTERFACE_NAME

-
#define NM_SETTING_VLAN_INTERFACE_NAME       "interface-name"
+
+

Object Hierarchy

+
    GEnum
+    ├── NMSettingVlanError
+    ├── NMVlanFlags
+    ╰── NMVlanPriorityMap
+    GObject
+    ╰── NMSetting
+        ╰── NMSettingVlan
 
-

-

-
-
-

NM_SETTING_VLAN_PARENT

-
#define NM_SETTING_VLAN_PARENT               "parent"
+
+

Includes

+
#include <nm-setting-vlan.h>
 
-

-

-
-
-

NM_SETTING_VLAN_ID

-
#define NM_SETTING_VLAN_ID                   "id"
-
-

-

+
+

Description

+

The NMSettingVlan object is a NMSetting subclass that describes properties +necessary for connection to VLAN interfaces.

-
+
+

Functions

-

NM_SETTING_VLAN_FLAGS

-
#define NM_SETTING_VLAN_FLAGS                "flags"
-
-

-

+

nm_setting_vlan_error_quark ()

+
GQuark
+nm_setting_vlan_error_quark (void);
+

Registers an error quark for NMSettingVlan if necessary.

+
+

Returns

+

the error quark used for NMSettingVlan errors.

+

-
-
-

NM_SETTING_VLAN_INGRESS_PRIORITY_MAP

-
#define NM_SETTING_VLAN_INGRESS_PRIORITY_MAP "ingress-priority-map"
-
-

-


-

NM_SETTING_VLAN_EGRESS_PRIORITY_MAP

-
#define NM_SETTING_VLAN_EGRESS_PRIORITY_MAP  "egress-priority-map"
-
-

-

+

nm_setting_vlan_new ()

+
NMSetting *
+nm_setting_vlan_new (void);
+

Creates a new NMSettingVlan object with default values.

+
+

Returns

+

the new empty NMSettingVlan object.

+

[transfer full]

-
-
-

NMSettingVlan

-
typedef struct _NMSettingVlan NMSettingVlan;
-

-


-

NMSettingVlanClass

-
typedef struct {
-	NMSettingClass parent;
-
-	/* Padding for future expansion */
-	void (*_reserved1) (void);
-	void (*_reserved2) (void);
-	void (*_reserved3) (void);
-	void (*_reserved4) (void);
-} NMSettingVlanClass;
-
-

-

+

nm_setting_vlan_get_interface_name ()

+
const char *
+nm_setting_vlan_get_interface_name (NMSettingVlan *setting);
+
+

Parameters

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

setting

the NMSettingVlan

 
+
+
+

Returns

+

the “interface_name” property of the setting

+

+

-

enum NMVlanPriorityMap

-
typedef enum {
-	NM_VLAN_INGRESS_MAP,
-	NM_VLAN_EGRESS_MAP
-} NMVlanPriorityMap;
-
-

-A selector for traffic priority maps; these map Linux SKB priorities -to 802.1p priorities used in VLANs. -

-
+

nm_setting_vlan_get_parent ()

+
const char *
+nm_setting_vlan_get_parent (NMSettingVlan *setting);
+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

NM_VLAN_INGRESS_MAP

map for incoming data -

NM_VLAN_EGRESS_MAP

map for outgoing data -

setting

the NMSettingVlan

 
+
+

Returns

+

the “parent” property of the setting

+

+
+

-

enum NMVlanFlags

-
typedef enum {
-	NM_VLAN_FLAG_REORDER_HEADERS = 0x1,
-	NM_VLAN_FLAG_GVRP            = 0x2,
-	NM_VLAN_FLAG_LOOSE_BINDING   = 0x4,
-
-	/* NOTE: if adding flags update nm-setting-vlan.c::verify() */
-} NMVlanFlags;
-
-

-NMVlanFlags values control the behavior of the VLAN interface. -

-
+

nm_setting_vlan_get_id ()

+
guint32
+nm_setting_vlan_get_id (NMSettingVlan *setting);
+
+

Parameters

+
--+++ - - - - - - - - - - - - - - + + + + +

NM_VLAN_FLAG_REORDER_HEADERS

indicates that this interface should reorder - outgoing packet headers to look more like a non-VLAN Ethernet interface -

NM_VLAN_FLAG_GVRP

indicates that this interface should use GVRP to register - itself with it's switch -

NM_VLAN_FLAG_LOOSE_BINDING

indicates that this interface's operating - state is tied to the underlying network interface but other details - (like routing) are not. -

setting

the NMSettingVlan

 
+
+

Returns

+

the “id” property of the setting

+

+
+

-

nm_setting_vlan_new ()

-
NMSetting *         nm_setting_vlan_new                 (void);
-

-Creates a new NMSettingVlan object with default values. -

-
+

nm_setting_vlan_get_flags ()

+
guint32
+nm_setting_vlan_get_flags (NMSettingVlan *setting);
+
+

Parameters

+
--+++ - - + + +

Returns :

the new empty NMSettingVlan object. [transfer full] -

setting

the NMSettingVlan

 
+
+

Returns

+

the “flags” property of the setting

+

+
+

-

nm_setting_vlan_get_interface_name ()

-
const char *        nm_setting_vlan_get_interface_name  (NMSettingVlan *setting);
-
+

nm_setting_vlan_get_num_priorities ()

+
gint32
+nm_setting_vlan_get_num_priorities (NMSettingVlan *setting,
+                                    NMVlanPriorityMap map);
+

Returns the number of entires in the +“ingress_priority_map” or “egress_priority_map” +properties of this setting.

+
+

Parameters

+
--+++ - - + + + - - + + +

setting :

the NMSettingVlan -

setting

the NMSettingVlan

 

Returns :

the "interface_name" property of the setting

map

the type of priority map

 
+
+

Returns

+

return the number of ingress/egress priority entries, -1 if error

+

+
+

-

nm_setting_vlan_get_parent ()

-
const char *        nm_setting_vlan_get_parent          (NMSettingVlan *setting);
-
+

nm_setting_vlan_get_priority ()

+
gboolean
+nm_setting_vlan_get_priority (NMSettingVlan *setting,
+                              NMVlanPriorityMap map,
+                              guint32 idx,
+                              guint32 *out_from,
+                              guint32 *out_to);
+

Retrieve one of the entries of the “ingress_priority_map” +or “egress_priority_map” properties of this setting.

+
+

Parameters

+
--+++ - - + + + - - + + + - -

setting :

the NMSettingVlan -

setting

the NMSettingVlan

 

Returns :

the "parent" property of the setting

map

the type of priority map

 
-
-
-
-

nm_setting_vlan_get_id ()

-
guint32             nm_setting_vlan_get_id              (NMSettingVlan *setting);
-
---- - - - + + + + + + + + - - + + +

setting :

the NMSettingVlan -

idx

the zero-based index of the ingress/egress priority map entry

 

out_from

on return the value of the priority map's 'from' item.

[out]

Returns :

the "id" property of the setting

out_to

on return the value of priority map's 'to' item.

[out]
+
+

Returns

+

TRUE if a priority map was returned, FALSE if error

+

+
+

-

nm_setting_vlan_get_flags ()

-
guint32             nm_setting_vlan_get_flags           (NMSettingVlan *setting);
-
+

nm_setting_vlan_add_priority ()

+
gboolean
+nm_setting_vlan_add_priority (NMSettingVlan *setting,
+                              NMVlanPriorityMap map,
+                              guint32 from,
+                              guint32 to);
+

Adds a priority mapping to the “ingress_priority_map” or +“egress_priority_map” properties of the setting. If from + is +already in the given priority map, this function will overwrite the +existing entry with the new to +.

+

If map + is NM_VLAN_INGRESS_MAP then from + is the incoming 802.1q VLAN +Priority Code Point (PCP) value, and to + is the Linux SKB priority value.

+

If map + is NM_VLAN_EGRESS_MAP then from + is the Linux SKB priority value and +to + is the outgoing 802.1q VLAN Priority Code Point (PCP) value.

+
+

Parameters

+
--+++ - - + + + + + + + + - - + + + + + + + +

setting :

the NMSettingVlan -

setting

the NMSettingVlan

 

map

the type of priority map

 

Returns :

the "flags" property of the setting

from

the priority to map to to +

 

to

the priority to map from +to

 
+
+

Returns

+

TRUE if the new priority mapping was successfully added to the +list, FALSE if error

+

+
+

-

nm_setting_vlan_get_num_priorities ()

-
gint32              nm_setting_vlan_get_num_priorities  (NMSettingVlan *setting,
-                                                         NMVlanPriorityMap map);
-

-Returns the number of entires in the -"ingress_priority_map" or "egress_priority_map" -properties of this setting. -

-
+

nm_setting_vlan_remove_priority ()

+
void
+nm_setting_vlan_remove_priority (NMSettingVlan *setting,
+                                 NMVlanPriorityMap map,
+                                 guint32 idx);
+

Removes the priority map at index idx + from the +“ingress_priority_map” or “egress_priority_map” +properties.

+
+

Parameters

+
--+++ - - + + + - - + + + - - + + +

setting :

the NMSettingVlan -

setting

the NMSettingVlan

 

map :

the type of priority map

map

the type of priority map

 

Returns :

return the number of ingress/egress priority entries, -1 if error

idx

the zero-based index of the priority map to remove

 
+

-

nm_setting_vlan_get_priority ()

-
gboolean            nm_setting_vlan_get_priority        (NMSettingVlan *setting,
-                                                         NMVlanPriorityMap map,
-                                                         guint32 idx,
-                                                         guint32 *out_from,
-                                                         guint32 *out_to);
-

-Retrieve one of the entries of the "ingress_priority_map" -or "egress_priority_map" properties of this setting. -

-
+

nm_setting_vlan_remove_priority_by_value ()

+
gboolean
+nm_setting_vlan_remove_priority_by_value
+                               (NMSettingVlan *setting,
+                                NMVlanPriorityMap map,
+                                guint32 from,
+                                guint32 to);
+

Removes the priority map form +:to + from the “ingress_priority_map” +or “egress_priority_map” (according to map + argument) +properties.

+
+

Parameters

+
--+++ - - - - - - + + + - - - - - - + + + - - + + + - - + + +

setting :

the NMSettingVlan -

map :

the type of priority map

setting

the NMSettingVlan

 

idx :

the zero-based index of the ingress/egress priority map entry

out_from :

on return the value of the priority map's 'from' item. [out] -

map

the type of priority map

 

out_to :

on return the value of priority map's 'to' item. [out] -

from

the priority to map to to +

 

Returns :

-TRUE if a priority map was returned, FALSE if error

to

the priority to map from +to

 
+
+

Returns

+

TRUE if the priority mapping was found and removed; FALSE if it was not.

+

+
+

Since 0.9.10

+

-

nm_setting_vlan_add_priority ()

-
gboolean            nm_setting_vlan_add_priority        (NMSettingVlan *setting,
-                                                         NMVlanPriorityMap map,
-                                                         guint32 from,
-                                                         guint32 to);
-

-Adds a priority mapping to the "ingress_priority_map" or -"egress_priority_map" properties of the setting. If from is -already in the given priority map, this function will overwrite the -existing entry with the new to. -

-

-If map is NM_VLAN_INGRESS_MAP then from is the incoming 802.1q VLAN -Priority Code Point (PCP) value, and to is the Linux SKB priority value. -

-

-If map is NM_VLAN_EGRESS_MAP then from is the Linux SKB priority value and -to is the outgoing 802.1q VLAN Priority Code Point (PCP) value. -

-
+

nm_setting_vlan_remove_priority_str_by_value ()

+
gboolean
+nm_setting_vlan_remove_priority_str_by_value
+                               (NMSettingVlan *setting,
+                                NMVlanPriorityMap map,
+                                const char *str);
+

Removes the priority map str + from the “ingress_priority_map” +or “egress_priority_map” (according to map + argument) +properties.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + - - + + + - - + + +

setting :

the NMSettingVlan -

map :

the type of priority map

from :

the priority to map to to -

setting

the NMSettingVlan

 

to :

the priority to map from to

map

the type of priority map

 

Returns :

-TRUE if the new priority mapping was successfully added to the -list, FALSE if error

str

the string which contains a priority map, like "3:7"

 
+
+

Returns

+

TRUE if the priority mapping was found and removed; FALSE if it was not.

+

+
+

Since 0.9.10

+

-

nm_setting_vlan_remove_priority ()

-
void                nm_setting_vlan_remove_priority     (NMSettingVlan *setting,
-                                                         NMVlanPriorityMap map,
-                                                         guint32 idx);
-

-Removes the priority map at index idx from the -"ingress_priority_map" or "egress_priority_map" -properties. -

-
+

nm_setting_vlan_clear_priorities ()

+
void
+nm_setting_vlan_clear_priorities (NMSettingVlan *setting,
+                                  NMVlanPriorityMap map);
+

Clear all the entires from “ingress_priority_map” or +“egress_priority_map” properties.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + +

setting :

the NMSettingVlan -

map :

the type of priority map

setting

the NMSettingVlan

 

idx :

the zero-based index of the priority map to remove

map

the type of priority map

 
+
-

nm_setting_vlan_remove_priority_by_value ()

-
gboolean            nm_setting_vlan_remove_priority_by_value
-                                                        (NMSettingVlan *setting,
-                                                         NMVlanPriorityMap map,
-                                                         guint32 from,
-                                                         guint32 to);
-

-Removes the priority map form:to from the "ingress_priority_map" -or "egress_priority_map" (according to map argument) -properties. -

-
+

nm_setting_vlan_add_priority_str ()

+
gboolean
+nm_setting_vlan_add_priority_str (NMSettingVlan *setting,
+                                  NMVlanPriorityMap map,
+                                  const char *str);
+

Adds a priority map entry into either the “ingress_priority_map” +or the “egress_priority_map” properties. The priority map maps +the Linux SKB priorities to 802.1p priorities.

+
+

Parameters

+
--+++ - - + + + - - + + + - - - - - - - - - - + + +

setting :

the NMSettingVlan -

setting

the NMSettingVlan

 

map :

the type of priority map

map

the type of priority map

 

from :

the priority to map to to -

to :

the priority to map from to

Returns :

-TRUE if the priority mapping was found and removed; FALSE if it was not.

str

the string which contains a priority map, like "3:7"

 
-

Since 0.9.10

-
+
+

Returns

+

TRUE if the entry was successfully added to the list, or it +overwrote the old value, FALSE if error

+

+
+ + +
+

Types and Values

-

nm_setting_vlan_remove_priority_str_by_value ()

-
gboolean            nm_setting_vlan_remove_priority_str_by_value
-                                                        (NMSettingVlan *setting,
-                                                         NMVlanPriorityMap map,
-                                                         const char *str);
+

NM_SETTING_VLAN_SETTING_NAME

+
#define NM_SETTING_VLAN_SETTING_NAME "vlan"
+

-Removes the priority map str from the "ingress_priority_map" -or "egress_priority_map" (according to map argument) -properties.

-
+ +
+
+

enum NMSettingVlanError

+
+

Members

+
--+++ - - + + - - + + + - - + + + - - + + +

setting :

the NMSettingVlan +

NM_SETTING_VLAN_ERROR_UNKNOWN

+

unknown or unclassified error

 

map :

the type of priority map

NM_SETTING_VLAN_ERROR_INVALID_PROPERTY

+

the property was invalid

+
 

str :

the string which contains a priority map, like "3:7"

NM_SETTING_VLAN_ERROR_MISSING_PROPERTY

+

the property was missing and is + required

+
 

Returns :

-TRUE if the priority mapping was found and removed; FALSE if it was not.

NM_SETTING_VLAN_ERROR_INVALID_PARENT

+

the VLAN parent was specified + inconsistently

+
 
-

Since 0.9.10

+

-

nm_setting_vlan_clear_priorities ()

-
void                nm_setting_vlan_clear_priorities    (NMSettingVlan *setting,
-                                                         NMVlanPriorityMap map);
+

NM_SETTING_VLAN_ERROR

+
#define NM_SETTING_VLAN_ERROR nm_setting_vlan_error_quark ()
+

-Clear all the entires from "ingress_priority_map" or -"egress_priority_map" properties.

-
+ +
+
+

NM_SETTING_VLAN_INTERFACE_NAME

+
#define NM_SETTING_VLAN_INTERFACE_NAME       "interface-name"
+
+

+

+
+
+
+

NM_SETTING_VLAN_PARENT

+
#define NM_SETTING_VLAN_PARENT               "parent"
+
+

+

+
+
+
+

NM_SETTING_VLAN_ID

+
#define NM_SETTING_VLAN_ID                   "id"
+
+

+

+
+
+
+

NM_SETTING_VLAN_FLAGS

+
#define NM_SETTING_VLAN_FLAGS                "flags"
+
+

+

+
+
+
+

NM_SETTING_VLAN_INGRESS_PRIORITY_MAP

+
#define NM_SETTING_VLAN_INGRESS_PRIORITY_MAP "ingress-priority-map"
+
+

+

+
+
+
+

NM_SETTING_VLAN_EGRESS_PRIORITY_MAP

+
#define NM_SETTING_VLAN_EGRESS_PRIORITY_MAP  "egress-priority-map"
+
+

+

+
+
+
+

enum NMVlanPriorityMap

+

A selector for traffic priority maps; these map Linux SKB priorities +to 802.1p priorities used in VLANs.

+
+

Members

+
--+++ - - + + - - + + +

setting :

the NMSettingVlan +

NM_VLAN_INGRESS_MAP

+

map for incoming data

 

map :

the type of priority map

NM_VLAN_EGRESS_MAP

+

map for outgoing data

+
 
+
-

nm_setting_vlan_add_priority_str ()

-
gboolean            nm_setting_vlan_add_priority_str    (NMSettingVlan *setting,
-                                                         NMVlanPriorityMap map,
-                                                         const char *str);
-

-Adds a priority map entry into either the "ingress_priority_map" -or the "egress_priority_map" properties. The priority map maps -the Linux SKB priorities to 802.1p priorities. -

-
+

enum NMVlanFlags

+

NMVlanFlags values control the behavior of the VLAN interface.

+
+

Members

+
--+++ - - + + - - - - - - + + + - - + + +

setting :

the NMSettingVlan +

NM_VLAN_FLAG_REORDER_HEADERS

+

indicates that this interface should reorder + outgoing packet headers to look more like a non-VLAN Ethernet interface

 

map :

the type of priority map

str :

the string which contains a priority map, like "3:7"

NM_VLAN_FLAG_GVRP

+

indicates that this interface should use GVRP to register + itself with it's switch

+
 

Returns :

-TRUE if the entry was successfully added to the list, or it -overwrote the old value, FALSE if error

NM_VLAN_FLAG_LOOSE_BINDING

+

indicates that this interface's operating + state is tied to the underlying network interface but other details + (like routing) are not.

+
 
+

Property Details

-

The "egress-priority-map" property

-
  "egress-priority-map"      GSList_gchararray_*   : Read / Write
-

-For outgoing packets, a list of mappings from Linux SKB priorities to -802.1p priorities. The mapping is given in the format "from:to" where -both "from" and "to" are unsigned integers, ie "7:3". -

+

The “egress-priority-map” property

+
  “egress-priority-map”      GSList_gchararray_ *
+

+

Flags: Read / Write


-

The "flags" property

-
  "flags"                    guint                 : Read / Write / Construct
-

-One or more flags which control the behavior and features of the VLAN -interface. Flags include NM_VLAN_FLAG_REORDER_HEADERS (reordering of -output packet headers), NM_VLAN_FLAG_GVRP (use of the GVRP protocol), -and NM_VLAN_FLAG_LOOSE_BINDING (loose binding of the interface to its -master device's operating state). -

+

The “flags” property

+
  “flags”                    guint
+

+

Flags: Read / Write / Construct

Default value: 0


-

The "id" property

-
  "id"                       guint                 : Read / Write / Construct
-

-The VLAN identifier that the interface created by this connection should -be assigned. -

+

The “id” property

+
  “id”                       guint
+

+

Flags: Read / Write / Construct

Allowed values: <= 4095

Default value: 0


-

The "ingress-priority-map" property

-
  "ingress-priority-map"     GSList_gchararray_*   : Read / Write
-

-For incoming packets, a list of mappings from 802.1p priorities to Linux -SKB priorities. The mapping is given in the format "from:to" where both -"from" and "to" are unsigned integers, ie "7:3". -

+

The “ingress-priority-map” property

+
  “ingress-priority-map”     GSList_gchararray_ *
+

+

Flags: Read / Write


-

The "interface-name" property

-
  "interface-name"           gchar*                : Read / Write / Construct
-

-If given, specifies the kernel name of the VLAN interface. If not given, -a default name will be constructed from the interface described by the -parent interface and the "id" property, eg "eth2.1". The -parent interface may be given by the "parent" property or by -the "mac-address" property of an NMSettingWired setting. -

+

The “interface-name” property

+
  “interface-name”           gchar *
+

+

Flags: Read / Write / Construct

Default value: NULL


-

The "parent" property

-
  "parent"                   gchar*                : Read / Write / Construct
-

-If given, specifies the parent interface name or parent connection UUID -from which this VLAN interface should be created. If this property is -not specified, the connection must contain an NMSettingWired setting -with a "mac-address" property. -

+

The “parent” property

+
  “parent”                   gchar *
+

+

Flags: Read / Write / Construct

Default value: NULL

+ Generated by GTK-Doc V1.21 \ No newline at end of file diff --git a/docs/libnm-util/html/NMSettingWimax.html b/docs/libnm-util/html/NMSettingWimax.html index ce31e8ec..6d0035fb 100644 --- a/docs/libnm-util/html/NMSettingWimax.html +++ b/docs/libnm-util/html/NMSettingWimax.html @@ -2,34 +2,28 @@ -NMSettingWimax +libnm-util Reference Manual: NMSettingWimax - + - - - - - - - - - - + + + + + + +
@@ -37,250 +31,297 @@

NMSettingWimax

NMSettingWimax — Describes 802.16e Mobile WiMAX connection properties

- +
- -
-

Object Hierarchy

-
-  GEnum
-   +----NMSettingWimaxError
-
-
-  GObject
-   +----NMSetting
-         +----NMSettingWimax
-
-
-
-

Properties

-
-  "mac-address"              GArray_guchar_*       : Read / Write
-  "network-name"             gchar*                : Read / Write
-
-
-
-

Description

-

-The NMSettingWimax object is a NMSetting subclass that describes properties -necessary for connection to 802.16e Mobile WiMAX networks. -

-
-

Details

-
-

NM_SETTING_WIMAX_SETTING_NAME

-
#define NM_SETTING_WIMAX_SETTING_NAME "wimax"
-
-

-

-
-
-
-

enum NMSettingWimaxError

-
typedef enum {
-	NM_SETTING_WIMAX_ERROR_UNKNOWN = 0,      /*< nick=UnknownError >*/
-	NM_SETTING_WIMAX_ERROR_INVALID_PROPERTY, /*< nick=InvalidProperty >*/
-	NM_SETTING_WIMAX_ERROR_MISSING_PROPERTY  /*< nick=MissingProperty >*/
-} NMSettingWimaxError;
-
-
+

Functions

+
--++ - - + - - + - - + + + + +

NM_SETTING_WIMAX_ERROR_UNKNOWN

unknown or unclassified error + +GQuark + +nm_setting_wimax_error_quark ()

NM_SETTING_WIMAX_ERROR_INVALID_PROPERTY

the property was invalid + +NMSetting * + +nm_setting_wimax_new ()

NM_SETTING_WIMAX_ERROR_MISSING_PROPERTY

the property was missing and is -required +const char * + +nm_setting_wimax_get_network_name () +
const GByteArray * + +nm_setting_wimax_get_mac_address ()
-
-
-

NM_SETTING_WIMAX_ERROR

-
#define NM_SETTING_WIMAX_ERROR nm_setting_wimax_error_quark ()
-
-

-

+
+

Properties

+
+++++ + + + + + + + + + + + + +
+GArray_guchar_ *mac-addressRead / Write
+gchar *network-nameRead / Write
-
-
-

nm_setting_wimax_error_quark ()

-
GQuark              nm_setting_wimax_error_quark        (void);
-

-Registers an error quark for NMSettingWimax if necessary. -

-
+
+

Types and Values

+
--++ - - - - + + + + + + + + + + + + + + + + + + + + + +

Returns :

the error quark used for NMSettingWimax errors.
#defineNM_SETTING_WIMAX_SETTING_NAME
enumNMSettingWimaxError
#defineNM_SETTING_WIMAX_ERROR
#defineNM_SETTING_WIMAX_NETWORK_NAME
#defineNM_SETTING_WIMAX_MAC_ADDRESS
-
-
-

NM_SETTING_WIMAX_NETWORK_NAME

-
#define NM_SETTING_WIMAX_NETWORK_NAME "network-name"
+
+

Object Hierarchy

+
    GEnum
+    ╰── NMSettingWimaxError
+    GObject
+    ╰── NMSetting
+        ╰── NMSettingWimax
 
-

-

-
-
-

NM_SETTING_WIMAX_MAC_ADDRESS

-
#define NM_SETTING_WIMAX_MAC_ADDRESS  "mac-address"
+
+

Includes

+
#include <nm-setting-wimax.h>
 
-

-

-
+
+

Description

+

The NMSettingWimax object is a NMSetting subclass that describes properties +necessary for connection to 802.16e Mobile WiMAX networks.

+
+
+

Functions

-

NMSettingWimax

-
typedef struct _NMSettingWimax NMSettingWimax;
-

-

+

nm_setting_wimax_error_quark ()

+
GQuark
+nm_setting_wimax_error_quark (void);
+

Registers an error quark for NMSettingWimax if necessary.

+
+

Returns

+

the error quark used for NMSettingWimax errors.

+

+

-

NMSettingWimaxClass

-
typedef struct {
-	NMSettingClass parent;
-} NMSettingWimaxClass;
-
-

-

+

nm_setting_wimax_new ()

+
NMSetting *
+nm_setting_wimax_new (void);
+

Creates a new NMSettingWimax object with default values.

+
+

Returns

+

the new empty NMSettingWimax object

+

+

-

nm_setting_wimax_new ()

-
NMSetting *         nm_setting_wimax_new                (void);
-

-Creates a new NMSettingWimax object with default values. -

-
+

nm_setting_wimax_get_network_name ()

+
const char *
+nm_setting_wimax_get_network_name (NMSettingWimax *setting);
+

Returns the WiMAX NSP name (ex "Sprint" or "CLEAR") which identifies the +specific WiMAX network this setting describes a connection to.

+
+

Parameters

+
--+++ - - + + +

Returns :

the new empty NMSettingWimax object

setting

the NMSettingWimax

 
+
+

Returns

+

the WiMAX NSP name

+

+
+

-

nm_setting_wimax_get_network_name ()

-
const char *        nm_setting_wimax_get_network_name   (NMSettingWimax *setting);
-

-Returns the WiMAX NSP name (ex "Sprint" or "CLEAR") which identifies the -specific WiMAX network this setting describes a connection to. -

-
+

nm_setting_wimax_get_mac_address ()

+
const GByteArray *
+nm_setting_wimax_get_mac_address (NMSettingWimax *setting);
+

Returns the MAC address of a WiMAX device which this connection is locked +to.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSettingWimax -

Returns :

the WiMAX NSP name

setting

the NMSettingWimax

 
-
+
+

Returns

+

the MAC address

+

+
+
+
+
+

Types and Values

-

nm_setting_wimax_get_mac_address ()

-
const GByteArray *  nm_setting_wimax_get_mac_address    (NMSettingWimax *setting);
+

NM_SETTING_WIMAX_SETTING_NAME

+
#define NM_SETTING_WIMAX_SETTING_NAME "wimax"
+

-Returns the MAC address of a WiMAX device which this connection is locked -to.

-
+ +
+
+

enum NMSettingWimaxError

+
+

Members

+
--+++ - - + + - - + + + + + + + +

setting :

the NMSettingWimax +

NM_SETTING_WIMAX_ERROR_UNKNOWN

+

unknown or unclassified error

 

Returns :

the MAC address

NM_SETTING_WIMAX_ERROR_INVALID_PROPERTY

+

the property was invalid

+
 

NM_SETTING_WIMAX_ERROR_MISSING_PROPERTY

+

the property was missing and is +required

+
 
-
-

Property Details

+
+
+

NM_SETTING_WIMAX_ERROR

+
#define NM_SETTING_WIMAX_ERROR nm_setting_wimax_error_quark ()
+
+

+

+
+
-

The "mac-address" property

-
  "mac-address"              GArray_guchar_*       : Read / Write
+

NM_SETTING_WIMAX_NETWORK_NAME

+
#define NM_SETTING_WIMAX_NETWORK_NAME "network-name"
+

-If specified, this connection will only apply to the WiMAX device whose -MAC address matches. This property does not change the MAC address of the -device (known as MAC spoofing).


-

The "network-name" property

-
  "network-name"             gchar*                : Read / Write
+

NM_SETTING_WIMAX_MAC_ADDRESS

+
#define NM_SETTING_WIMAX_MAC_ADDRESS  "mac-address"
+

-Network Service Provider (NSP) name of the WiMAX network this connection -should use.

+
+
+
+

Property Details

+
+

The “mac-address” property

+
  “mac-address”              GArray_guchar_ *
+

+

Flags: Read / Write

+
+
+
+

The “network-name” property

+
  “network-name”             gchar *
+

+

Flags: Read / Write

Default value: NULL

+ Generated by GTK-Doc V1.21
\ No newline at end of file diff --git a/docs/libnm-util/html/NMSettingWired.html b/docs/libnm-util/html/NMSettingWired.html index cff6f5b5..3b0bfc3f 100644 --- a/docs/libnm-util/html/NMSettingWired.html +++ b/docs/libnm-util/html/NMSettingWired.html @@ -2,34 +2,28 @@ -NMSettingWired +libnm-util Reference Manual: NMSettingWired - + - - - - - - - - - - + + + + + + +
@@ -37,1059 +31,1324 @@

NMSettingWired

NMSettingWired — Describes connection properties for Ethernet-based networks

- +
-
-

Synopsis

-
-#include <nm-setting-wired.h>
-
-#define             NM_SETTING_WIRED_SETTING_NAME
-enum                NMSettingWiredError;
-#define             NM_SETTING_WIRED_ERROR
-GQuark              nm_setting_wired_error_quark        (void);
-#define             NM_SETTING_WIRED_PORT
-#define             NM_SETTING_WIRED_SPEED
-#define             NM_SETTING_WIRED_DUPLEX
-#define             NM_SETTING_WIRED_AUTO_NEGOTIATE
-#define             NM_SETTING_WIRED_MAC_ADDRESS
-#define             NM_SETTING_WIRED_CLONED_MAC_ADDRESS
-#define             NM_SETTING_WIRED_MAC_ADDRESS_BLACKLIST
-#define             NM_SETTING_WIRED_MTU
-#define             NM_SETTING_WIRED_S390_SUBCHANNELS
-#define             NM_SETTING_WIRED_S390_NETTYPE
-#define             NM_SETTING_WIRED_S390_OPTIONS
-                    NMSettingWired;
-                    NMSettingWiredClass;
-NMSetting *         nm_setting_wired_new                (void);
-const char *        nm_setting_wired_get_port           (NMSettingWired *setting);
-guint32             nm_setting_wired_get_speed          (NMSettingWired *setting);
-const char *        nm_setting_wired_get_duplex         (NMSettingWired *setting);
-gboolean            nm_setting_wired_get_auto_negotiate (NMSettingWired *setting);
-const GByteArray *  nm_setting_wired_get_mac_address    (NMSettingWired *setting);
-const GByteArray *  nm_setting_wired_get_cloned_mac_address
-                                                        (NMSettingWired *setting);
-const GSList *      nm_setting_wired_get_mac_address_blacklist
-                                                        (NMSettingWired *setting);
-guint32             nm_setting_wired_get_num_mac_blacklist_items
-                                                        (NMSettingWired *setting);
-const char *        nm_setting_wired_get_mac_blacklist_item
-                                                        (NMSettingWired *setting,
-                                                         guint32 idx);
-gboolean            nm_setting_wired_add_mac_blacklist_item
-                                                        (NMSettingWired *setting,
-                                                         const char *mac);
-void                nm_setting_wired_remove_mac_blacklist_item
-                                                        (NMSettingWired *setting,
-                                                         guint32 idx);
-gboolean            nm_setting_wired_remove_mac_blacklist_item_by_value
-                                                        (NMSettingWired *setting,
-                                                         const char *mac);
-void                nm_setting_wired_clear_mac_blacklist_items
-                                                        (NMSettingWired *setting);
-guint32             nm_setting_wired_get_mtu            (NMSettingWired *setting);
-const GPtrArray *   nm_setting_wired_get_s390_subchannels
-                                                        (NMSettingWired *setting);
-const char *        nm_setting_wired_get_s390_nettype   (NMSettingWired *setting);
-guint32             nm_setting_wired_get_num_s390_options
-                                                        (NMSettingWired *setting);
-gboolean            nm_setting_wired_get_s390_option    (NMSettingWired *setting,
-                                                         guint32 idx,
-                                                         const char **out_key,
-                                                         const char **out_value);
-const char *        nm_setting_wired_get_s390_option_by_key
-                                                        (NMSettingWired *setting,
-                                                         const char *key);
-gboolean            nm_setting_wired_add_s390_option    (NMSettingWired *setting,
-                                                         const char *key,
-                                                         const char *value);
-gboolean            nm_setting_wired_remove_s390_option (NMSettingWired *setting,
-                                                         const char *key);
-const char **       nm_setting_wired_get_valid_s390_options
-                                                        (NMSettingWired *setting);
-
-
-
-

Object Hierarchy

-
-  GEnum
-   +----NMSettingWiredError
-
-
-  GObject
-   +----NMSetting
-         +----NMSettingWired
-
-
-
-

Properties

-
-  "auto-negotiate"           gboolean              : Read / Write / Construct
-  "cloned-mac-address"       GArray_guchar_*       : Read / Write
-  "duplex"                   gchar*                : Read / Write
-  "mac-address"              GArray_guchar_*       : Read / Write
-  "mac-address-blacklist"    GSList_gchararray_*   : Read / Write
-  "mtu"                      guint                 : Read / Write / Construct
-  "port"                     gchar*                : Read / Write
-  "s390-nettype"             gchar*                : Read / Write
-  "s390-options"             GHashTable_gchararray+gchararray_*  : Read / Write
-  "s390-subchannels"         GPtrArray_gchararray_*  : Read / Write
-  "speed"                    guint                 : Read / Write / Construct
-
-
-
-

Description

-

-The NMSettingWired object is a NMSetting subclass that describes properties -necessary for connection to Ethernet networks. -

-
-

Details

-
-

NM_SETTING_WIRED_SETTING_NAME

-
#define NM_SETTING_WIRED_SETTING_NAME "802-3-ethernet"
-
-

-

-
-
-
-

enum NMSettingWiredError

-
typedef enum {
-	NM_SETTING_WIRED_ERROR_UNKNOWN = 0,      /*< nick=UnknownError >*/
-	NM_SETTING_WIRED_ERROR_INVALID_PROPERTY, /*< nick=InvalidProperty >*/
-	NM_SETTING_WIRED_ERROR_MISSING_PROPERTY  /*< nick=MissingProperty >*/
-} NMSettingWiredError;
-
-
+

Functions

+
--++ - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - - + - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

NM_SETTING_WIRED_ERROR_UNKNOWN

unknown or unclassified error + +GQuark + +nm_setting_wired_error_quark () +
+NMSetting * + +nm_setting_wired_new () +
const char * + +nm_setting_wired_get_port () +
+guint32 + +nm_setting_wired_get_speed () +
const char * + +nm_setting_wired_get_duplex () +
+gboolean + +nm_setting_wired_get_auto_negotiate () +
const GByteArray * + +nm_setting_wired_get_mac_address () +
const GByteArray * + +nm_setting_wired_get_cloned_mac_address () +
const GSList * + +nm_setting_wired_get_mac_address_blacklist () +
+guint32 + +nm_setting_wired_get_num_mac_blacklist_items () +
const char * + +nm_setting_wired_get_mac_blacklist_item () +
+gboolean + +nm_setting_wired_add_mac_blacklist_item () +
+void + +nm_setting_wired_remove_mac_blacklist_item () +
+gboolean + +nm_setting_wired_remove_mac_blacklist_item_by_value ()

NM_SETTING_WIRED_ERROR_INVALID_PROPERTY

the property was invalid + +void + +nm_setting_wired_clear_mac_blacklist_items ()

NM_SETTING_WIRED_ERROR_MISSING_PROPERTY

the property was missing and is -required + +guint32 + +nm_setting_wired_get_mtu () +
const GPtrArray * + +nm_setting_wired_get_s390_subchannels () +
const char * + +nm_setting_wired_get_s390_nettype () +
+guint32 + +nm_setting_wired_get_num_s390_options () +
+gboolean + +nm_setting_wired_get_s390_option () +
const char * + +nm_setting_wired_get_s390_option_by_key () +
+gboolean + +nm_setting_wired_add_s390_option () +
+gboolean + +nm_setting_wired_remove_s390_option () +
const char ** + +nm_setting_wired_get_valid_s390_options ()
-
-
-

NM_SETTING_WIRED_ERROR

-
#define NM_SETTING_WIRED_ERROR nm_setting_wired_error_quark ()
-
-

-

-
-
-
-

nm_setting_wired_error_quark ()

-
GQuark              nm_setting_wired_error_quark        (void);
-

-Registers an error quark for NMSettingWired if necessary. -

-
+
+

Properties

+
--+++ - - - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Returns :

the error quark used for NMSettingWired errors.
gbooleanauto-negotiateRead / Write / Construct
+GArray_guchar_ *cloned-mac-addressRead / Write
+gchar *duplexRead / Write
+GArray_guchar_ *mac-addressRead / Write
+GSList_gchararray_ *mac-address-blacklistRead / Write
guintmtuRead / Write / Construct
+gchar *portRead / Write
+gchar *s390-nettypeRead / Write
GHashTable_gchararray+gchararray_*s390-optionsRead / Write
+GPtrArray_gchararray_ *s390-subchannelsRead / Write
guintspeedRead / Write / Construct
-
-
-

NM_SETTING_WIRED_PORT

-
#define NM_SETTING_WIRED_PORT "port"
-
-

-

-
-
-
-

NM_SETTING_WIRED_SPEED

-
#define NM_SETTING_WIRED_SPEED "speed"
-
-

-

-
-
-
-

NM_SETTING_WIRED_DUPLEX

-
#define NM_SETTING_WIRED_DUPLEX "duplex"
-
-

-

-
-
-
-

NM_SETTING_WIRED_AUTO_NEGOTIATE

-
#define NM_SETTING_WIRED_AUTO_NEGOTIATE "auto-negotiate"
-
-

-

-
-
-
-

NM_SETTING_WIRED_MAC_ADDRESS

-
#define NM_SETTING_WIRED_MAC_ADDRESS "mac-address"
-
-

-

-
-
-
-

NM_SETTING_WIRED_CLONED_MAC_ADDRESS

-
#define NM_SETTING_WIRED_CLONED_MAC_ADDRESS "cloned-mac-address"
-
-

-

+ -
-
-

NM_SETTING_WIRED_MAC_ADDRESS_BLACKLIST

-
#define NM_SETTING_WIRED_MAC_ADDRESS_BLACKLIST "mac-address-blacklist"
+
+

Object Hierarchy

+
    GEnum
+    ╰── NMSettingWiredError
+    GObject
+    ╰── NMSetting
+        ╰── NMSettingWired
 
-

-

-
-
-

NM_SETTING_WIRED_MTU

-
#define NM_SETTING_WIRED_MTU "mtu"
+
+

Includes

+
#include <nm-setting-wired.h>
 
-

-

-
-
-

NM_SETTING_WIRED_S390_SUBCHANNELS

-
#define NM_SETTING_WIRED_S390_SUBCHANNELS "s390-subchannels"
-
-

-

+
+

Description

+

The NMSettingWired object is a NMSetting subclass that describes properties +necessary for connection to Ethernet networks.

-
+
+

Functions

-

NM_SETTING_WIRED_S390_NETTYPE

-
#define NM_SETTING_WIRED_S390_NETTYPE "s390-nettype"
-
-

-

+

nm_setting_wired_error_quark ()

+
GQuark
+nm_setting_wired_error_quark (void);
+

Registers an error quark for NMSettingWired if necessary.

+
+

Returns

+

the error quark used for NMSettingWired errors.

+

-
-
-

NM_SETTING_WIRED_S390_OPTIONS

-
#define NM_SETTING_WIRED_S390_OPTIONS "s390-options"
-
-

-


-

NMSettingWired

-
typedef struct _NMSettingWired NMSettingWired;
-

-

+

nm_setting_wired_new ()

+
NMSetting *
+nm_setting_wired_new (void);
+

Creates a new NMSettingWired object with default values.

+
+

Returns

+

the new empty NMSettingWired object.

+

[transfer full]

-
-
-

NMSettingWiredClass

-
typedef struct {
-	NMSettingClass parent;
-
-	/* Padding for future expansion */
-	void (*_reserved1) (void);
-	void (*_reserved2) (void);
-	void (*_reserved3) (void);
-	void (*_reserved4) (void);
-} NMSettingWiredClass;
-
-

-


-

nm_setting_wired_new ()

-
NMSetting *         nm_setting_wired_new                (void);
-

-Creates a new NMSettingWired object with default values. -

-
+

nm_setting_wired_get_port ()

+
const char *
+nm_setting_wired_get_port (NMSettingWired *setting);
+
+

Parameters

+
--+++ - - + + +

Returns :

the new empty NMSettingWired object. [transfer full] -

setting

the NMSettingWired

 
-
-
-

nm_setting_wired_get_port ()

-
const char *        nm_setting_wired_get_port           (NMSettingWired *setting);
-
---- - - - - - - - - - - -

setting :

the NMSettingWired -

Returns :

the "port" property of the setting
+
+

Returns

+

the “port” property of the setting

+

+

-

nm_setting_wired_get_speed ()

-
guint32             nm_setting_wired_get_speed          (NMSettingWired *setting);
-
+

nm_setting_wired_get_speed ()

+
guint32
+nm_setting_wired_get_speed (NMSettingWired *setting);
+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSettingWired -

Returns :

the "speed" property of the setting

setting

the NMSettingWired

 
+
+

Returns

+

the “speed” property of the setting

+

+
+

-

nm_setting_wired_get_duplex ()

-
const char *        nm_setting_wired_get_duplex         (NMSettingWired *setting);
-
+

nm_setting_wired_get_duplex ()

+
const char *
+nm_setting_wired_get_duplex (NMSettingWired *setting);
+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSettingWired -

Returns :

the "duplex" property of the setting

setting

the NMSettingWired

 
+
+

Returns

+

the “duplex” property of the setting

+

+
+

-

nm_setting_wired_get_auto_negotiate ()

-
gboolean            nm_setting_wired_get_auto_negotiate (NMSettingWired *setting);
-
+

nm_setting_wired_get_auto_negotiate ()

+
gboolean
+nm_setting_wired_get_auto_negotiate (NMSettingWired *setting);
+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSettingWired -

Returns :

the "auto-negotiate" property of the setting

setting

the NMSettingWired

 
+
+

Returns

+

the “auto-negotiate” property of the setting

+

+
+

-

nm_setting_wired_get_mac_address ()

-
const GByteArray *  nm_setting_wired_get_mac_address    (NMSettingWired *setting);
-
+

nm_setting_wired_get_mac_address ()

+
const GByteArray *
+nm_setting_wired_get_mac_address (NMSettingWired *setting);
+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSettingWired -

Returns :

the "mac-address" property of the setting

setting

the NMSettingWired

 
-
-
-

nm_setting_wired_get_cloned_mac_address ()

-
const GByteArray *  nm_setting_wired_get_cloned_mac_address
-                                                        (NMSettingWired *setting);
-
---- - - - - - - - - - - +
+

Returns

+

the “mac-address” property of the setting

+

+
+ +
+
+

nm_setting_wired_get_cloned_mac_address ()

+
const GByteArray *
+nm_setting_wired_get_cloned_mac_address
+                               (NMSettingWired *setting);
+
+

Parameters

+

setting :

the NMSettingWired -

Returns :

the "cloned-mac-address" property of the setting
+++++ + + + + +

setting

the NMSettingWired

 
+
+

Returns

+

the “cloned-mac-address” property of the setting

+

+
+

-

nm_setting_wired_get_mac_address_blacklist ()

-
const GSList *      nm_setting_wired_get_mac_address_blacklist
-                                                        (NMSettingWired *setting);
-
+

nm_setting_wired_get_mac_address_blacklist ()

+
const GSList *
+nm_setting_wired_get_mac_address_blacklist
+                               (NMSettingWired *setting);
+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSettingWired -

Returns :

the "mac-address-blacklist" -property of the setting. [element-type GLib.ByteArray] -

setting

the NMSettingWired

 
+
+

Returns

+

the “mac-address-blacklist” +property of the setting.

+

[element-type GLib.ByteArray]

+
+

-

nm_setting_wired_get_num_mac_blacklist_items ()

-
guint32             nm_setting_wired_get_num_mac_blacklist_items
-                                                        (NMSettingWired *setting);
-
+

nm_setting_wired_get_num_mac_blacklist_items ()

+
guint32
+nm_setting_wired_get_num_mac_blacklist_items
+                               (NMSettingWired *setting);
+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSettingWired -

Returns :

the number of blacklisted MAC addresses

setting

the NMSettingWired

 
+
+
+

Returns

+

the number of blacklisted MAC addresses

+

+

Since 0.9.10


-

nm_setting_wired_get_mac_blacklist_item ()

-
const char *        nm_setting_wired_get_mac_blacklist_item
-                                                        (NMSettingWired *setting,
-                                                         guint32 idx);
-
+

nm_setting_wired_get_mac_blacklist_item ()

+
const char *
+nm_setting_wired_get_mac_blacklist_item
+                               (NMSettingWired *setting,
+                                guint32 idx);
+
+

Parameters

+
--+++ - - - - - - + + + - - + + +

setting :

the NMSettingWired -

idx :

the zero-based index of the MAC address entry

setting

the NMSettingWired

 

Returns :

the blacklisted MAC address string (hex-digits-and-colons notation) -at index idx -

idx

the zero-based index of the MAC address entry

 
+
+
+

Returns

+

the blacklisted MAC address string (hex-digits-and-colons notation) +at index idx +

+

+

Since 0.9.10


-

nm_setting_wired_add_mac_blacklist_item ()

-
gboolean            nm_setting_wired_add_mac_blacklist_item
-                                                        (NMSettingWired *setting,
-                                                         const char *mac);
-

-Adds a new MAC address to the "mac-address-blacklist" property. -

-
+

nm_setting_wired_add_mac_blacklist_item ()

+
gboolean
+nm_setting_wired_add_mac_blacklist_item
+                               (NMSettingWired *setting,
+                                const char *mac);
+

Adds a new MAC address to the “mac-address-blacklist” property.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + +

setting :

the NMSettingWired -

mac :

the MAC address string (hex-digits-and-colons notation) to blacklist

setting

the NMSettingWired

 

Returns :

-TRUE if the MAC address was added; FALSE if the MAC address -is invalid or was already present

mac

the MAC address string (hex-digits-and-colons notation) to blacklist

 
+
+
+

Returns

+

TRUE if the MAC address was added; FALSE if the MAC address +is invalid or was already present

+

+

Since 0.9.10


-

nm_setting_wired_remove_mac_blacklist_item ()

-
void                nm_setting_wired_remove_mac_blacklist_item
-                                                        (NMSettingWired *setting,
-                                                         guint32 idx);
-

-Removes the MAC address at index idx from the blacklist. -

-
+

nm_setting_wired_remove_mac_blacklist_item ()

+
void
+nm_setting_wired_remove_mac_blacklist_item
+                               (NMSettingWired *setting,
+                                guint32 idx);
+

Removes the MAC address at index idx + from the blacklist.

+
+

Parameters

+
--+++ - - + + + - - + + +

setting :

the NMSettingWired -

setting

the NMSettingWired

 

idx :

index number of the MAC address

idx

index number of the MAC address

 
+

Since 0.9.10


-

nm_setting_wired_remove_mac_blacklist_item_by_value ()

-
gboolean            nm_setting_wired_remove_mac_blacklist_item_by_value
-                                                        (NMSettingWired *setting,
-                                                         const char *mac);
-

-Removes the MAC address mac from the blacklist. -

-
+

nm_setting_wired_remove_mac_blacklist_item_by_value ()

+
gboolean
+nm_setting_wired_remove_mac_blacklist_item_by_value
+                               (NMSettingWired *setting,
+                                const char *mac);
+

Removes the MAC address mac + from the blacklist.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + +

setting :

the NMSettingWired -

mac :

the MAC address string (hex-digits-and-colons notation) to remove from -the blacklist

setting

the NMSettingWired

 

Returns :

-TRUE if the MAC address was found and removed; FALSE if it was not.

mac

the MAC address string (hex-digits-and-colons notation) to remove from +the blacklist

 
+
+
+

Returns

+

TRUE if the MAC address was found and removed; FALSE if it was not.

+

+

Since 0.9.10


-

nm_setting_wired_clear_mac_blacklist_items ()

-
void                nm_setting_wired_clear_mac_blacklist_items
-                                                        (NMSettingWired *setting);
-

-Removes all blacklisted MAC addresses. -

-
+

nm_setting_wired_clear_mac_blacklist_items ()

+
void
+nm_setting_wired_clear_mac_blacklist_items
+                               (NMSettingWired *setting);
+

Removes all blacklisted MAC addresses.

+
+

Parameters

+
--+++ - - + + +

setting :

the NMSettingWired -

setting

the NMSettingWired

 
+

Since 0.9.10


-

nm_setting_wired_get_mtu ()

-
guint32             nm_setting_wired_get_mtu            (NMSettingWired *setting);
-
+

nm_setting_wired_get_mtu ()

+
guint32
+nm_setting_wired_get_mtu (NMSettingWired *setting);
+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSettingWired -

Returns :

the "mtu" property of the setting

setting

the NMSettingWired

 
+
+

Returns

+

the “mtu” property of the setting

+

+
+
-

nm_setting_wired_get_s390_subchannels ()

-
const GPtrArray *   nm_setting_wired_get_s390_subchannels
-                                                        (NMSettingWired *setting);
-

-Return the list of s390 subchannels that identify the device that this +

nm_setting_wired_get_s390_subchannels ()

+
const GPtrArray *
+nm_setting_wired_get_s390_subchannels (NMSettingWired *setting);
+

Return the list of s390 subchannels that identify the device that this connection is applicable to. The connection should only be used in -conjunction with that device. -

-
+conjunction with that device.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSettingWired -

Returns :

-GPtrArray of strings, each specifying one -subchannel the s390 device uses to communicate to the host. [element-type utf8] -

setting

the NMSettingWired

 
+
+

Returns

+

GPtrArray of strings, each specifying one +subchannel the s390 device uses to communicate to the host.

+

[element-type utf8]

+
+
-

nm_setting_wired_get_s390_nettype ()

-
const char *        nm_setting_wired_get_s390_nettype   (NMSettingWired *setting);
-

-Returns the s390 device type this connection should apply to. Will be one -of 'qeth', 'lcs', or 'ctc'. -

-
+

nm_setting_wired_get_s390_nettype ()

+
const char *
+nm_setting_wired_get_s390_nettype (NMSettingWired *setting);
+

Returns the s390 device type this connection should apply to. Will be one +of 'qeth', 'lcs', or 'ctc'.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSettingWired -

Returns :

the s390 device type

setting

the NMSettingWired

 
+
+

Returns

+

the s390 device type

+

+
+
-

nm_setting_wired_get_num_s390_options ()

-
guint32             nm_setting_wired_get_num_s390_options
-                                                        (NMSettingWired *setting);
-

-Returns the number of s390-specific options that should be set for this +

nm_setting_wired_get_num_s390_options ()

+
guint32
+nm_setting_wired_get_num_s390_options (NMSettingWired *setting);
+

Returns the number of s390-specific options that should be set for this device when it is activated. This can be used to retrieve each s390 -option individually using nm_setting_wired_get_s390_option(). -

-
+option individually using nm_setting_wired_get_s390_option().

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSettingWired -

Returns :

the number of s390-specific device options

setting

the NMSettingWired

 
+
+

Returns

+

the number of s390-specific device options

+

+
+
-

nm_setting_wired_get_s390_option ()

-
gboolean            nm_setting_wired_get_s390_option    (NMSettingWired *setting,
-                                                         guint32 idx,
-                                                         const char **out_key,
-                                                         const char **out_value);
-

-Given an index, return the value of the s390 option at that index. indexes +

nm_setting_wired_get_s390_option ()

+
gboolean
+nm_setting_wired_get_s390_option (NMSettingWired *setting,
+                                  guint32 idx,
+                                  const char **out_key,
+                                  const char **out_value);
+

Given an index, return the value of the s390 option at that index. indexes are *not* guaranteed to be static across modifications to options done by -nm_setting_wired_add_s390_option() and nm_setting_wired_remove_s390_option(), +nm_setting_wired_add_s390_option() and nm_setting_wired_remove_s390_option(), and should not be used to refer to options except for short periods of time -such as during option iteration. -

-
+such as during option iteration.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + + - - + + + - - + + +

setting :

the NMSettingWired -

idx :

index of the desired option, from 0 to -nm_setting_wired_get_num_s390_options() - 1

setting

the NMSettingWired

 

out_key :

on return, the key name of the s390 specific option; this -value is owned by the setting and should not be modified. [out] -

idx

index of the desired option, from 0 to +nm_setting_wired_get_num_s390_options() - 1

 

out_value :

on return, the value of the key of the s390 specific -option; this value is owned by the setting and should not be modified. [out] -

out_key

on return, the key name of the s390 specific option; this +value is owned by the setting and should not be modified.

[out]

Returns :

-TRUE on success if the index was valid and an option was found, -FALSE if the index was invalid (ie, greater than the number of options -currently held by the setting)

out_value

on return, the value of the key of the s390 specific +option; this value is owned by the setting and should not be modified.

[out]
+
+

Returns

+

TRUE on success if the index was valid and an option was found, +FALSE if the index was invalid (ie, greater than the number of options +currently held by the setting)

+

+
+
-

nm_setting_wired_get_s390_option_by_key ()

-
const char *        nm_setting_wired_get_s390_option_by_key
-                                                        (NMSettingWired *setting,
-                                                         const char *key);
-

-Returns the value associated with the s390-specific option specified by -key, if it exists. -

-
+

nm_setting_wired_get_s390_option_by_key ()

+
const char *
+nm_setting_wired_get_s390_option_by_key
+                               (NMSettingWired *setting,
+                                const char *key);
+

Returns the value associated with the s390-specific option specified by +key +, if it exists.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + +

setting :

the NMSettingWired -

key :

the key for which to retrieve the value

setting

the NMSettingWired

 

Returns :

the value, or NULL if the key/value pair was never added to the -setting; the value is owned by the setting and must not be modified

key

the key for which to retrieve the value

 
+
+

Returns

+

the value, or NULL if the key/value pair was never added to the +setting; the value is owned by the setting and must not be modified

+

+
+
-

nm_setting_wired_add_s390_option ()

-
gboolean            nm_setting_wired_add_s390_option    (NMSettingWired *setting,
-                                                         const char *key,
-                                                         const char *value);
-

-Add an option to the table. The option is compared to an internal list +

nm_setting_wired_add_s390_option ()

+
gboolean
+nm_setting_wired_add_s390_option (NMSettingWired *setting,
+                                  const char *key,
+                                  const char *value);
+

Add an option to the table. The option is compared to an internal list of allowed options. Key names may contain only alphanumeric characters (ie [a-zA-Z0-9]). Adding a new key replaces any existing key/value pair that -may already exist. -

-
+may already exist.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + + - - + + +

setting :

the NMSettingWired -

key :

key name for the option

setting

the NMSettingWired

 

value :

value for the option

key

key name for the option

 

Returns :

-TRUE if the option was valid and was added to the internal option -list, FALSE if it was not.

value

value for the option

 
+
+

Returns

+

TRUE if the option was valid and was added to the internal option +list, FALSE if it was not.

+

+
+
-

nm_setting_wired_remove_s390_option ()

-
gboolean            nm_setting_wired_remove_s390_option (NMSettingWired *setting,
-                                                         const char *key);
-

-Remove the s390-specific option referenced by key from the internal option -list. -

-
+

nm_setting_wired_remove_s390_option ()

+
gboolean
+nm_setting_wired_remove_s390_option (NMSettingWired *setting,
+                                     const char *key);
+

Remove the s390-specific option referenced by key + from the internal option +list.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + +

setting :

the NMSettingWired -

key :

key name for the option to remove

setting

the NMSettingWired

 

Returns :

-TRUE if the option was found and removed from the internal option -list, FALSE if it was not.

key

key name for the option to remove

 
+
+

Returns

+

TRUE if the option was found and removed from the internal option +list, FALSE if it was not.

+

+
+
-

nm_setting_wired_get_valid_s390_options ()

-
const char **       nm_setting_wired_get_valid_s390_options
-                                                        (NMSettingWired *setting);
+

nm_setting_wired_get_valid_s390_options ()

+
const char **
+nm_setting_wired_get_valid_s390_options
+                               (NMSettingWired *setting);
+

Returns a list of valid s390 options.

+
+

Parameters

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

setting

the NMSettingWired

 
+
+
+

Returns

+

a NULL-terminated array of strings of valid s390 options.

+

[transfer none]

+
+

Since 0.9.10

+
+ +
+

Types and Values

+
+

NM_SETTING_WIRED_SETTING_NAME

+
#define NM_SETTING_WIRED_SETTING_NAME "802-3-ethernet"
+

-Returns a list of valid s390 options.

-
+ +
+
+

enum NMSettingWiredError

+
+

Members

+
--+++ - - + + + + + + + - - + +

setting :

the NMSettingWired +

NM_SETTING_WIRED_ERROR_UNKNOWN

+

unknown or unclassified error

+
 

NM_SETTING_WIRED_ERROR_INVALID_PROPERTY

+

the property was invalid

 

Returns :

a NULL-terminated array of strings of valid s390 options. [transfer none] +

NM_SETTING_WIRED_ERROR_MISSING_PROPERTY

+

the property was missing and is +required

 
-

Since 0.9.10

-
-

Property Details

+
-

The "auto-negotiate" property

-
  "auto-negotiate"           gboolean              : Read / Write / Construct
+

NM_SETTING_WIRED_ERROR

+
#define NM_SETTING_WIRED_ERROR nm_setting_wired_error_quark ()
+

-If TRUE, allow auto-negotiation of port speed and duplex mode. If -FALSE, do not allow auto-negotiation, in which case the "speed" and -"duplex" properties should be set.

-

Default value: TRUE


-

The "cloned-mac-address" property

-
  "cloned-mac-address"       GArray_guchar_*       : Read / Write
+

NM_SETTING_WIRED_PORT

+
#define NM_SETTING_WIRED_PORT "port"
+

-If specified, request that the device use this MAC address instead of its -permanent MAC address. This is known as MAC cloning or spoofing.


-

The "duplex" property

-
  "duplex"                   gchar*                : Read / Write
+

NM_SETTING_WIRED_SPEED

+
#define NM_SETTING_WIRED_SPEED "speed"
+

-If specified, request that the device only use the specified duplex mode. -Either "half" or "full".

-

Default value: NULL


-

The "mac-address" property

-
  "mac-address"              GArray_guchar_*       : Read / Write
+

NM_SETTING_WIRED_DUPLEX

+
#define NM_SETTING_WIRED_DUPLEX "duplex"
+

-If specified, this connection will only apply to the Ethernet device -whose permanent MAC address matches. This property does not change the -MAC address of the device (i.e. MAC spoofing).


-

The "mac-address-blacklist" property

-
  "mac-address-blacklist"    GSList_gchararray_*   : Read / Write
+

NM_SETTING_WIRED_AUTO_NEGOTIATE

+
#define NM_SETTING_WIRED_AUTO_NEGOTIATE "auto-negotiate"
+

-If specified, this connection will never apply to the Ethernet device -whose permanent MAC address matches an address in the list. Each MAC -address is in the standard hex-digits-and-colons notation -(00:11:22:33:44:55).


-

The "mtu" property

-
  "mtu"                      guint                 : Read / Write / Construct
+

NM_SETTING_WIRED_MAC_ADDRESS

+
#define NM_SETTING_WIRED_MAC_ADDRESS "mac-address"
+
+

+

+
+
+
+

NM_SETTING_WIRED_CLONED_MAC_ADDRESS

+
#define NM_SETTING_WIRED_CLONED_MAC_ADDRESS "cloned-mac-address"
+

-If non-zero, only transmit packets of the specified size or smaller, -breaking larger packets up into multiple Ethernet frames.

-

Default value: 0


-

The "port" property

-
  "port"                     gchar*                : Read / Write
+

NM_SETTING_WIRED_MAC_ADDRESS_BLACKLIST

+
#define NM_SETTING_WIRED_MAC_ADDRESS_BLACKLIST "mac-address-blacklist"
+

-Specific port type to use if multiple the device supports multiple -attachment methods. One of "tp" (Twisted Pair), "aui" (Attachment Unit -Interface), "bnc" (Thin Ethernet) or "mii" (Media Independent Interface. -If the device supports only one port type, this setting is ignored.

-

Default value: NULL


-

The "s390-nettype" property

-
  "s390-nettype"             gchar*                : Read / Write
+

NM_SETTING_WIRED_MTU

+
#define NM_SETTING_WIRED_MTU "mtu"
+

-s390 network device type; one of "qeth", "lcs", or "ctc", representing -the different types of virtual network devices available on s390 systems.

-

Default value: NULL


-

The "s390-options" property

-
  "s390-options"             GHashTable_gchararray+gchararray_*  : Read / Write
+

NM_SETTING_WIRED_S390_SUBCHANNELS

+
#define NM_SETTING_WIRED_S390_SUBCHANNELS "s390-subchannels"
+

-Dictionary of key/value pairs of s390-specific device options. Both keys -and values must be strings. Allowed keys include "portno", "layer2", -"portname", "protocol", among others. Key names must contain only -alphanumeric characters (ie, [a-zA-Z0-9]).


-

The "s390-subchannels" property

-
  "s390-subchannels"         GPtrArray_gchararray_*  : Read / Write
+

NM_SETTING_WIRED_S390_NETTYPE

+
#define NM_SETTING_WIRED_S390_NETTYPE "s390-nettype"
+

-Identifies specific subchannels that this network device uses for -communication with z/VM or s390 host. Like the -"mac-address" property for non-z/VM devices, this property -can be used to ensure this connection only applies to the network device -that uses these subchannels. The list should contain exactly 3 strings, -and each string may only be composed of hexadecimal characters and the -period (.) character.


-

The "speed" property

-
  "speed"                    guint                 : Read / Write / Construct
+

NM_SETTING_WIRED_S390_OPTIONS

+
#define NM_SETTING_WIRED_S390_OPTIONS "s390-options"
+

-If non-zero, request that the device use only the specified speed. In -Mbit/s, ie 100 == 100Mbit/s.

+
+
+
+

Property Details

+
+

The “auto-negotiate” property

+
  “auto-negotiate”           gboolean
+

+

Flags: Read / Write / Construct

+

Default value: TRUE

+
+
+
+

The “cloned-mac-address” property

+
  “cloned-mac-address”       GArray_guchar_ *
+

+

Flags: Read / Write

+
+
+
+

The “duplex” property

+
  “duplex”                   gchar *
+

+

Flags: Read / Write

+

Default value: NULL

+
+
+
+

The “mac-address” property

+
  “mac-address”              GArray_guchar_ *
+

+

Flags: Read / Write

+
+
+
+

The “mac-address-blacklist” property

+
  “mac-address-blacklist”    GSList_gchararray_ *
+

+

Flags: Read / Write

+
+
+
+

The “mtu” property

+
  “mtu”                      guint
+

+

Flags: Read / Write / Construct

+

Default value: 0

+
+
+
+

The “port” property

+
  “port”                     gchar *
+

+

Flags: Read / Write

+

Default value: NULL

+
+
+
+

The “s390-nettype” property

+
  “s390-nettype”             gchar *
+

+

Flags: Read / Write

+

Default value: NULL

+
+
+
+

The “s390-options” property

+
  “s390-options”             GHashTable_gchararray+gchararray_*
+

+

Flags: Read / Write

+
+
+
+

The “s390-subchannels” property

+
  “s390-subchannels”         GPtrArray_gchararray_ *
+

+

Flags: Read / Write

+
+
+
+

The “speed” property

+
  “speed”                    guint
+

+

Flags: Read / Write / Construct

Default value: 0

+ Generated by GTK-Doc V1.21 \ No newline at end of file diff --git a/docs/libnm-util/html/NMSettingWireless.html b/docs/libnm-util/html/NMSettingWireless.html index 4d97a075..f668698a 100644 --- a/docs/libnm-util/html/NMSettingWireless.html +++ b/docs/libnm-util/html/NMSettingWireless.html @@ -2,34 +2,28 @@ -NMSettingWireless +libnm-util Reference Manual: NMSettingWireless - + - - - - - - - - - - + + + + + + +
@@ -37,1168 +31,1476 @@

NMSettingWireless

NMSettingWireless — Describes connection properties for 802.11 Wi-Fi networks

- +
-
-

Synopsis

-
-#include <nm-setting-wireless.h>
-
-#define             NM_SETTING_WIRELESS_SETTING_NAME
-enum                NMSettingWirelessError;
-#define             NM_SETTING_WIRELESS_ERROR
-GQuark              nm_setting_wireless_error_quark     (void);
-#define             NM_SETTING_WIRELESS_SSID
-#define             NM_SETTING_WIRELESS_MODE
-#define             NM_SETTING_WIRELESS_BAND
-#define             NM_SETTING_WIRELESS_CHANNEL
-#define             NM_SETTING_WIRELESS_BSSID
-#define             NM_SETTING_WIRELESS_RATE
-#define             NM_SETTING_WIRELESS_TX_POWER
-#define             NM_SETTING_WIRELESS_MAC_ADDRESS
-#define             NM_SETTING_WIRELESS_CLONED_MAC_ADDRESS
-#define             NM_SETTING_WIRELESS_MAC_ADDRESS_BLACKLIST
-#define             NM_SETTING_WIRELESS_MTU
-#define             NM_SETTING_WIRELESS_SEEN_BSSIDS
-#define             NM_SETTING_WIRELESS_HIDDEN
-#define             NM_SETTING_WIRELESS_SEC
-#define             NM_SETTING_WIRELESS_MODE_ADHOC
-#define             NM_SETTING_WIRELESS_MODE_AP
-#define             NM_SETTING_WIRELESS_MODE_INFRA
-                    NMSettingWireless;
-                    NMSettingWirelessClass;
-NMSetting *         nm_setting_wireless_new             (void);
-const GByteArray *  nm_setting_wireless_get_ssid        (NMSettingWireless *setting);
-const char *        nm_setting_wireless_get_mode        (NMSettingWireless *setting);
-const char *        nm_setting_wireless_get_band        (NMSettingWireless *setting);
-guint32             nm_setting_wireless_get_channel     (NMSettingWireless *setting);
-const GByteArray *  nm_setting_wireless_get_bssid       (NMSettingWireless *setting);
-guint32             nm_setting_wireless_get_rate        (NMSettingWireless *setting);
-guint32             nm_setting_wireless_get_tx_power    (NMSettingWireless *setting);
-const GByteArray *  nm_setting_wireless_get_mac_address (NMSettingWireless *setting);
-const GByteArray *  nm_setting_wireless_get_cloned_mac_address
-                                                        (NMSettingWireless *setting);
-const GSList *      nm_setting_wireless_get_mac_address_blacklist
-                                                        (NMSettingWireless *setting);
-guint32             nm_setting_wireless_get_num_mac_blacklist_items
-                                                        (NMSettingWireless *setting);
-const char *        nm_setting_wireless_get_mac_blacklist_item
-                                                        (NMSettingWireless *setting,
-                                                         guint32 idx);
-gboolean            nm_setting_wireless_add_mac_blacklist_item
-                                                        (NMSettingWireless *setting,
-                                                         const char *mac);
-void                nm_setting_wireless_remove_mac_blacklist_item
-                                                        (NMSettingWireless *setting,
-                                                         guint32 idx);
-gboolean            nm_setting_wireless_remove_mac_blacklist_item_by_value
-                                                        (NMSettingWireless *setting,
-                                                         const char *mac);
-void                nm_setting_wireless_clear_mac_blacklist_items
-                                                        (NMSettingWireless *setting);
-guint32             nm_setting_wireless_get_mtu         (NMSettingWireless *setting);
-gboolean            nm_setting_wireless_get_hidden      (NMSettingWireless *setting);
-gboolean            nm_setting_wireless_add_seen_bssid  (NMSettingWireless *setting,
-                                                         const char *bssid);
-guint32             nm_setting_wireless_get_num_seen_bssids
-                                                        (NMSettingWireless *setting);
-const char *        nm_setting_wireless_get_seen_bssid  (NMSettingWireless *setting,
-                                                         guint32 i);
-gboolean            nm_setting_wireless_ap_security_compatible
-                                                        (NMSettingWireless *s_wireless,
-                                                         NMSettingWirelessSecurity *s_wireless_sec,
-                                                         NM80211ApFlags ap_flags,
-                                                         NM80211ApSecurityFlags ap_wpa,
-                                                         NM80211ApSecurityFlags ap_rsn,
-                                                         NM80211Mode ap_mode);
-const char *        nm_setting_wireless_get_security    (NMSettingWireless *setting);
-
-
-
-

Object Hierarchy

-
-  GEnum
-   +----NMSettingWirelessError
-
-
-  GObject
-   +----NMSetting
-         +----NMSettingWireless
-
-
-
-

Properties

-
-  "band"                     gchar*                : Read / Write
-  "bssid"                    GArray_guchar_*       : Read / Write
-  "channel"                  guint                 : Read / Write / Construct
-  "cloned-mac-address"       GArray_guchar_*       : Read / Write
-  "hidden"                   gboolean              : Read / Write
-  "mac-address"              GArray_guchar_*       : Read / Write
-  "mac-address-blacklist"    GSList_gchararray_*   : Read / Write
-  "mode"                     gchar*                : Read / Write
-  "mtu"                      guint                 : Read / Write / Construct
-  "rate"                     guint                 : Read / Write / Construct
-  "security"                 gchar*                : Read / Write
-  "seen-bssids"              GSList_gchararray_*   : Read / Write
-  "ssid"                     GArray_guchar_*       : Read / Write
-  "tx-power"                 guint                 : Read / Write / Construct
-
-
-
-

Description

-

-The NMSettingWireless object is a NMSetting subclass that describes properties -necessary for connection to 802.11 Wi-Fi networks. -

-
-

Details

-
-

NM_SETTING_WIRELESS_SETTING_NAME

-
#define NM_SETTING_WIRELESS_SETTING_NAME "802-11-wireless"
-
-

-

-
-
-
-

enum NMSettingWirelessError

-
typedef enum {
-	NM_SETTING_WIRELESS_ERROR_UNKNOWN = 0,              /*< nick=UnknownError >*/
-	NM_SETTING_WIRELESS_ERROR_INVALID_PROPERTY,         /*< nick=InvalidProperty >*/
-	NM_SETTING_WIRELESS_ERROR_MISSING_PROPERTY,         /*< nick=MissingProperty >*/
-	NM_SETTING_WIRELESS_ERROR_MISSING_SECURITY_SETTING, /*< nick=MissingSecuritySetting >*/
-	NM_SETTING_WIRELESS_ERROR_CHANNEL_REQUIRES_BAND     /*< nick=ChannelRequiresBand >*/
-} NMSettingWirelessError;
-
-
+

Functions

+
--++ - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - - + - - + - - + - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

NM_SETTING_WIRELESS_ERROR_UNKNOWN

unknown or unclassified error + +GQuark + +nm_setting_wireless_error_quark () +
+NMSetting * + +nm_setting_wireless_new () +
const GByteArray * + +nm_setting_wireless_get_ssid () +
const char * + +nm_setting_wireless_get_mode () +
const char * + +nm_setting_wireless_get_band () +
+guint32 + +nm_setting_wireless_get_channel () +
const GByteArray * + +nm_setting_wireless_get_bssid () +
+guint32 + +nm_setting_wireless_get_rate () +
+guint32 + +nm_setting_wireless_get_tx_power () +
const GByteArray * + +nm_setting_wireless_get_mac_address () +
const GByteArray * + +nm_setting_wireless_get_cloned_mac_address () +
const GSList * + +nm_setting_wireless_get_mac_address_blacklist () +
+guint32 + +nm_setting_wireless_get_num_mac_blacklist_items ()

NM_SETTING_WIRELESS_ERROR_INVALID_PROPERTY

the property was invalid +const char * + +nm_setting_wireless_get_mac_blacklist_item ()

NM_SETTING_WIRELESS_ERROR_MISSING_PROPERTY

the property was missing and is -required + +gboolean + +nm_setting_wireless_add_mac_blacklist_item ()

NM_SETTING_WIRELESS_ERROR_MISSING_SECURITY_SETTING

property values require -the presence of an NMSettingWirelessSecurity object in the connection + +void + +nm_setting_wireless_remove_mac_blacklist_item ()

NM_SETTING_WIRELESS_ERROR_CHANNEL_REQUIRES_BAND

the property channel was -set to a value that requires the "band" property to be set + +gboolean + +nm_setting_wireless_remove_mac_blacklist_item_by_value () +
+void + +nm_setting_wireless_clear_mac_blacklist_items () +
+guint32 + +nm_setting_wireless_get_mtu () +
+gboolean + +nm_setting_wireless_get_hidden () +
+gboolean + +nm_setting_wireless_add_seen_bssid () +
+guint32 + +nm_setting_wireless_get_num_seen_bssids () +
const char * + +nm_setting_wireless_get_seen_bssid () +
+gboolean + +nm_setting_wireless_ap_security_compatible () +
const char * + +nm_setting_wireless_get_security ()
-
-
-

NM_SETTING_WIRELESS_ERROR

-
#define NM_SETTING_WIRELESS_ERROR nm_setting_wireless_error_quark ()
-
-

-

-
-
-
-

nm_setting_wireless_error_quark ()

-
GQuark              nm_setting_wireless_error_quark     (void);
-

-Registers an error quark for NMSettingWireless if necessary. -

-
+
+

Properties

+
--+++ - - - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Returns :

the error quark used for NMSettingWireless errors.
+gchar *bandRead / Write
+GArray_guchar_ *bssidRead / Write
guintchannelRead / Write / Construct
+GArray_guchar_ *cloned-mac-addressRead / Write
gbooleanhiddenRead / Write
+GArray_guchar_ *mac-addressRead / Write
+GSList_gchararray_ *mac-address-blacklistRead / Write
+gchar *modeRead / Write
guintmtuRead / Write / Construct
guintrateRead / Write / Construct
+gchar *securityRead / Write
+GSList_gchararray_ *seen-bssidsRead / Write
+GArray_guchar_ *ssidRead / Write
guinttx-powerRead / Write / Construct
-
-
-

NM_SETTING_WIRELESS_SSID

-
#define NM_SETTING_WIRELESS_SSID        "ssid"
-
-

-

-
-
-
-

NM_SETTING_WIRELESS_MODE

-
#define NM_SETTING_WIRELESS_MODE        "mode"
-
-

-

-
-
-
-

NM_SETTING_WIRELESS_BAND

-
#define NM_SETTING_WIRELESS_BAND        "band"
-
-

-

-
-
-
-

NM_SETTING_WIRELESS_CHANNEL

-
#define NM_SETTING_WIRELESS_CHANNEL     "channel"
-
-

-

-
-
-
-

NM_SETTING_WIRELESS_BSSID

-
#define NM_SETTING_WIRELESS_BSSID       "bssid"
-
-

-

-
-
-
-

NM_SETTING_WIRELESS_RATE

-
#define NM_SETTING_WIRELESS_RATE        "rate"
-
-

-

-
-
-
-

NM_SETTING_WIRELESS_TX_POWER

-
#define NM_SETTING_WIRELESS_TX_POWER    "tx-power"
-
-

-

-
-
-
-

NM_SETTING_WIRELESS_MAC_ADDRESS

-
#define NM_SETTING_WIRELESS_MAC_ADDRESS "mac-address"
-
-

-

-
-
-
-

NM_SETTING_WIRELESS_CLONED_MAC_ADDRESS

-
#define NM_SETTING_WIRELESS_CLONED_MAC_ADDRESS "cloned-mac-address"
-
-

-

-
-
-
-

NM_SETTING_WIRELESS_MAC_ADDRESS_BLACKLIST

-
#define NM_SETTING_WIRELESS_MAC_ADDRESS_BLACKLIST "mac-address-blacklist"
-
-

-

-
-
-
-

NM_SETTING_WIRELESS_MTU

-
#define NM_SETTING_WIRELESS_MTU         "mtu"
-
-

-

-
-
-
-

NM_SETTING_WIRELESS_SEEN_BSSIDS

-
#define NM_SETTING_WIRELESS_SEEN_BSSIDS "seen-bssids"
-
-

-

+ -
-
-

NM_SETTING_WIRELESS_HIDDEN

-
#define NM_SETTING_WIRELESS_HIDDEN      "hidden"
+
+

Object Hierarchy

+
    GEnum
+    ╰── NMSettingWirelessError
+    GObject
+    ╰── NMSetting
+        ╰── NMSettingWireless
 
-

-

-
-
-

NM_SETTING_WIRELESS_SEC

-
#define NM_SETTING_WIRELESS_SEC         "security"
+
+

Includes

+
#include <nm-setting-wireless.h>
 
-

-

-
-
-

NM_SETTING_WIRELESS_MODE_ADHOC

-
#define NM_SETTING_WIRELESS_MODE_ADHOC  "adhoc"
-
-

-Indicates Ad-Hoc mode where no access point is expected to be present. -

+
+

Description

+

The NMSettingWireless object is a NMSetting subclass that describes properties +necessary for connection to 802.11 Wi-Fi networks.

-
+
+

Functions

-

NM_SETTING_WIRELESS_MODE_AP

-
#define NM_SETTING_WIRELESS_MODE_AP     "ap"
-
-

-Indicates AP/master mode where the wireless device is started as an access -point/hotspot. -

-

Since 0.9.8

+

nm_setting_wireless_error_quark ()

+
GQuark
+nm_setting_wireless_error_quark (void);
+

Registers an error quark for NMSettingWireless if necessary.

+
+

Returns

+

the error quark used for NMSettingWireless errors.

+

-
-
-

NM_SETTING_WIRELESS_MODE_INFRA

-
#define NM_SETTING_WIRELESS_MODE_INFRA  "infrastructure"
-
-

-Indicates infrastructure mode where an access point is expected to be present -for this connection. -


-

NMSettingWireless

-
typedef struct _NMSettingWireless NMSettingWireless;
-

-

+

nm_setting_wireless_new ()

+
NMSetting *
+nm_setting_wireless_new (void);
+

Creates a new NMSettingWireless object with default values.

+
+

Returns

+

the new empty NMSettingWireless object.

+

[transfer full]

-
-
-

NMSettingWirelessClass

-
typedef struct {
-	NMSettingClass parent;
-
-	/* Padding for future expansion */
-	void (*_reserved1) (void);
-	void (*_reserved2) (void);
-	void (*_reserved3) (void);
-	void (*_reserved4) (void);
-} NMSettingWirelessClass;
-
-

-


-

nm_setting_wireless_new ()

-
NMSetting *         nm_setting_wireless_new             (void);
-

-Creates a new NMSettingWireless object with default values. -

-
+

nm_setting_wireless_get_ssid ()

+
const GByteArray *
+nm_setting_wireless_get_ssid (NMSettingWireless *setting);
+
+

Parameters

+
--+++ - - + + +

Returns :

the new empty NMSettingWireless object. [transfer full] -

setting

the NMSettingWireless

 
-
-
-

nm_setting_wireless_get_ssid ()

-
const GByteArray *  nm_setting_wireless_get_ssid        (NMSettingWireless *setting);
-
---- - - - - - - - - - - -

setting :

the NMSettingWireless -

Returns :

the "ssid" property of the setting
+
+

Returns

+

the “ssid” property of the setting

+

+

-

nm_setting_wireless_get_mode ()

-
const char *        nm_setting_wireless_get_mode        (NMSettingWireless *setting);
-
+

nm_setting_wireless_get_mode ()

+
const char *
+nm_setting_wireless_get_mode (NMSettingWireless *setting);
+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSettingWireless -

Returns :

the "mode" property of the setting

setting

the NMSettingWireless

 
+
+

Returns

+

the “mode” property of the setting

+

+
+

-

nm_setting_wireless_get_band ()

-
const char *        nm_setting_wireless_get_band        (NMSettingWireless *setting);
-
+

nm_setting_wireless_get_band ()

+
const char *
+nm_setting_wireless_get_band (NMSettingWireless *setting);
+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSettingWireless -

Returns :

the "band" property of the setting

setting

the NMSettingWireless

 
+
+

Returns

+

the “band” property of the setting

+

+
+

-

nm_setting_wireless_get_channel ()

-
guint32             nm_setting_wireless_get_channel     (NMSettingWireless *setting);
-
+

nm_setting_wireless_get_channel ()

+
guint32
+nm_setting_wireless_get_channel (NMSettingWireless *setting);
+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSettingWireless -

Returns :

the "channel" property of the setting

setting

the NMSettingWireless

 
+
+

Returns

+

the “channel” property of the setting

+

+
+

-

nm_setting_wireless_get_bssid ()

-
const GByteArray *  nm_setting_wireless_get_bssid       (NMSettingWireless *setting);
-
+

nm_setting_wireless_get_bssid ()

+
const GByteArray *
+nm_setting_wireless_get_bssid (NMSettingWireless *setting);
+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSettingWireless -

Returns :

the "bssid" property of the setting

setting

the NMSettingWireless

 
+
+

Returns

+

the “bssid” property of the setting

+

+
+

-

nm_setting_wireless_get_rate ()

-
guint32             nm_setting_wireless_get_rate        (NMSettingWireless *setting);
-
+

nm_setting_wireless_get_rate ()

+
guint32
+nm_setting_wireless_get_rate (NMSettingWireless *setting);
+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSettingWireless -

Returns :

the "rate" property of the setting

setting

the NMSettingWireless

 
+
+

Returns

+

the “rate” property of the setting

+

+
+

-

nm_setting_wireless_get_tx_power ()

-
guint32             nm_setting_wireless_get_tx_power    (NMSettingWireless *setting);
-
+

nm_setting_wireless_get_tx_power ()

+
guint32
+nm_setting_wireless_get_tx_power (NMSettingWireless *setting);
+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSettingWireless -

Returns :

the "tx-power" property of the setting

setting

the NMSettingWireless

 
+
+

Returns

+

the “tx-power” property of the setting

+

+
+

-

nm_setting_wireless_get_mac_address ()

-
const GByteArray *  nm_setting_wireless_get_mac_address (NMSettingWireless *setting);
-
+

nm_setting_wireless_get_mac_address ()

+
const GByteArray *
+nm_setting_wireless_get_mac_address (NMSettingWireless *setting);
+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSettingWireless -

Returns :

the "mac-address" property of the setting

setting

the NMSettingWireless

 
+
+

Returns

+

the “mac-address” property of the setting

+

+
+

-

nm_setting_wireless_get_cloned_mac_address ()

-
const GByteArray *  nm_setting_wireless_get_cloned_mac_address
-                                                        (NMSettingWireless *setting);
-
+

nm_setting_wireless_get_cloned_mac_address ()

+
const GByteArray *
+nm_setting_wireless_get_cloned_mac_address
+                               (NMSettingWireless *setting);
+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSettingWireless -

Returns :

the "cloned-mac-address" property of the setting

setting

the NMSettingWireless

 
+
+

Returns

+

the “cloned-mac-address” property of the setting

+

+
+

-

nm_setting_wireless_get_mac_address_blacklist ()

-
const GSList *      nm_setting_wireless_get_mac_address_blacklist
-                                                        (NMSettingWireless *setting);
-
+

nm_setting_wireless_get_mac_address_blacklist ()

+
const GSList *
+nm_setting_wireless_get_mac_address_blacklist
+                               (NMSettingWireless *setting);
+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSettingWireless -

Returns :

the -"mac-address-blacklist" property of the setting. [element-type GLib.ByteArray] -

setting

the NMSettingWireless

 
+
+

Returns

+

the +“mac-address-blacklist” property of the setting.

+

[element-type GLib.ByteArray]

+
+

-
-

nm_setting_wireless_get_num_mac_blacklist_items ()

-
guint32             nm_setting_wireless_get_num_mac_blacklist_items
-                                                        (NMSettingWireless *setting);
-
---- - - - - - - - - - - +
+

nm_setting_wireless_get_num_mac_blacklist_items ()

+
guint32
+nm_setting_wireless_get_num_mac_blacklist_items
+                               (NMSettingWireless *setting);
+
+

Parameters

+

setting :

the NMSettingWireless -

Returns :

the number of blacklisted MAC addresses
+++++ + + + + +

setting

the NMSettingWireless

 
+
+
+

Returns

+

the number of blacklisted MAC addresses

+

+

Since 0.9.10


-

nm_setting_wireless_get_mac_blacklist_item ()

-
const char *        nm_setting_wireless_get_mac_blacklist_item
-                                                        (NMSettingWireless *setting,
-                                                         guint32 idx);
-
+

nm_setting_wireless_get_mac_blacklist_item ()

+
const char *
+nm_setting_wireless_get_mac_blacklist_item
+                               (NMSettingWireless *setting,
+                                guint32 idx);
+
+

Parameters

+
--+++ - - - - - - + + + - - + + +

setting :

the NMSettingWireless -

idx :

the zero-based index of the MAC address entry

setting

the NMSettingWireless

 

Returns :

the blacklisted MAC address string (hex-digits-and-colons notation) -at index idx -

idx

the zero-based index of the MAC address entry

 
+
+
+

Returns

+

the blacklisted MAC address string (hex-digits-and-colons notation) +at index idx +

+

+

Since 0.9.10


-

nm_setting_wireless_add_mac_blacklist_item ()

-
gboolean            nm_setting_wireless_add_mac_blacklist_item
-                                                        (NMSettingWireless *setting,
-                                                         const char *mac);
-

-Adds a new MAC address to the "mac-address-blacklist" property. -

-
+

nm_setting_wireless_add_mac_blacklist_item ()

+
gboolean
+nm_setting_wireless_add_mac_blacklist_item
+                               (NMSettingWireless *setting,
+                                const char *mac);
+

Adds a new MAC address to the “mac-address-blacklist” property.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + +

setting :

the NMSettingWireless -

mac :

the MAC address string (hex-digits-and-colons notation) to blacklist

setting

the NMSettingWireless

 

Returns :

-TRUE if the MAC address was added; FALSE if the MAC address -is invalid or was already present

mac

the MAC address string (hex-digits-and-colons notation) to blacklist

 
+
+
+

Returns

+

TRUE if the MAC address was added; FALSE if the MAC address +is invalid or was already present

+

+

Since 0.9.10


-

nm_setting_wireless_remove_mac_blacklist_item ()

-
void                nm_setting_wireless_remove_mac_blacklist_item
-                                                        (NMSettingWireless *setting,
-                                                         guint32 idx);
-

-Removes the MAC address at index idx from the blacklist. -

-
+

nm_setting_wireless_remove_mac_blacklist_item ()

+
void
+nm_setting_wireless_remove_mac_blacklist_item
+                               (NMSettingWireless *setting,
+                                guint32 idx);
+

Removes the MAC address at index idx + from the blacklist.

+
+

Parameters

+
--+++ - - + + + - - + + +

setting :

the NMSettingWireless -

setting

the NMSettingWireless

 

idx :

index number of the MAC address

idx

index number of the MAC address

 
+

Since 0.9.10


-

nm_setting_wireless_remove_mac_blacklist_item_by_value ()

-
gboolean            nm_setting_wireless_remove_mac_blacklist_item_by_value
-                                                        (NMSettingWireless *setting,
-                                                         const char *mac);
-

-Removes the MAC address mac from the blacklist. -

-
+

nm_setting_wireless_remove_mac_blacklist_item_by_value ()

+
gboolean
+nm_setting_wireless_remove_mac_blacklist_item_by_value
+                               (NMSettingWireless *setting,
+                                const char *mac);
+

Removes the MAC address mac + from the blacklist.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + +

setting :

the NMSettingWireless -

mac :

the MAC address string (hex-digits-and-colons notation) to remove from -the blacklist

setting

the NMSettingWireless

 

Returns :

-TRUE if the MAC address was found and removed; FALSE if it was not.

mac

the MAC address string (hex-digits-and-colons notation) to remove from +the blacklist

 
+
+
+

Returns

+

TRUE if the MAC address was found and removed; FALSE if it was not.

+

+

Since 0.9.10


-

nm_setting_wireless_clear_mac_blacklist_items ()

-
void                nm_setting_wireless_clear_mac_blacklist_items
-                                                        (NMSettingWireless *setting);
-

-Removes all blacklisted MAC addresses. -

-
+

nm_setting_wireless_clear_mac_blacklist_items ()

+
void
+nm_setting_wireless_clear_mac_blacklist_items
+                               (NMSettingWireless *setting);
+

Removes all blacklisted MAC addresses.

+
+

Parameters

+
--+++ - - + + +

setting :

the NMSettingWireless -

setting

the NMSettingWireless

 
+

Since 0.9.10


-

nm_setting_wireless_get_mtu ()

-
guint32             nm_setting_wireless_get_mtu         (NMSettingWireless *setting);
-
+

nm_setting_wireless_get_mtu ()

+
guint32
+nm_setting_wireless_get_mtu (NMSettingWireless *setting);
+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSettingWireless -

Returns :

the "mtu" property of the setting

setting

the NMSettingWireless

 
+
+

Returns

+

the “mtu” property of the setting

+

+
+
-

nm_setting_wireless_get_hidden ()

-
gboolean            nm_setting_wireless_get_hidden      (NMSettingWireless *setting);
-
+

nm_setting_wireless_get_hidden ()

+
gboolean
+nm_setting_wireless_get_hidden (NMSettingWireless *setting);
+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSettingWireless -

Returns :

the "hidden" property of the setting

setting

the NMSettingWireless

 
+
+

Returns

+

the “hidden” property of the setting

+

+
+
-

nm_setting_wireless_add_seen_bssid ()

-
gboolean            nm_setting_wireless_add_seen_bssid  (NMSettingWireless *setting,
-                                                         const char *bssid);
-

-Adds a new Wi-Fi AP's BSSID to the previously seen BSSID list of the setting. +

nm_setting_wireless_add_seen_bssid ()

+
gboolean
+nm_setting_wireless_add_seen_bssid (NMSettingWireless *setting,
+                                    const char *bssid);
+

Adds a new Wi-Fi AP's BSSID to the previously seen BSSID list of the setting. NetworkManager now tracks previously seen BSSIDs internally so this function no longer has much use. Actually, changes you make using this function will -not be preserved. -

-
+not be preserved.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + +

setting :

the NMSettingWireless -

bssid :

the new BSSID to add to the list

setting

the NMSettingWireless

 

Returns :

-TRUE if bssid was already known, FALSE if not

bssid

the new BSSID to add to the list

 
+
+

Returns

+

TRUE if bssid +was already known, FALSE if not

+

+
+
-

nm_setting_wireless_get_num_seen_bssids ()

-
guint32             nm_setting_wireless_get_num_seen_bssids
-                                                        (NMSettingWireless *setting);
-
+

nm_setting_wireless_get_num_seen_bssids ()

+
guint32
+nm_setting_wireless_get_num_seen_bssids
+                               (NMSettingWireless *setting);
+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSettingWireless -

Returns :

the number of BSSIDs in the previously seen BSSID list

setting

the NMSettingWireless

 
+
+

Returns

+

the number of BSSIDs in the previously seen BSSID list

+

+
+
-

nm_setting_wireless_get_seen_bssid ()

-
const char *        nm_setting_wireless_get_seen_bssid  (NMSettingWireless *setting,
-                                                         guint32 i);
-
+

nm_setting_wireless_get_seen_bssid ()

+
const char *
+nm_setting_wireless_get_seen_bssid (NMSettingWireless *setting,
+                                    guint32 i);
+
+

Parameters

+
--+++ - - - - - - + + + - - + + +

setting :

the NMSettingWireless -

i :

index of a BSSID in the previously seen BSSID list

setting

the NMSettingWireless

 

Returns :

the BSSID at index i -

i

index of a BSSID in the previously seen BSSID list

 
+
+

Returns

+

the BSSID at index i +

+

+
+
-

nm_setting_wireless_ap_security_compatible ()

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

-Given a NMSettingWireless and an optional NMSettingWirelessSecurity, +

nm_setting_wireless_ap_security_compatible ()

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

Given a NMSettingWireless and an optional NMSettingWirelessSecurity, determine if the configuration given by the settings is compatible with the security of an access point using that access point's capability flags and mode. Useful for clients that wish to filter a set of connections against a set of access points and determine which connections are -compatible with which access points. -

-
+compatible with which access points.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + + - - + + + - - + + + - - + + + - - + + +

s_wireless :

a NMSettingWireless -

s_wireless_sec :

a NMSettingWirelessSecurity or NULL -

s_wireless

a NMSettingWireless

 

ap_flags :

the NM80211ApFlags of the given access point

s_wireless_sec

a NMSettingWirelessSecurity or NULL

 

ap_wpa :

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

ap_flags

the NM80211ApFlags of the given access point

 

ap_rsn :

the NM80211ApSecurityFlags of the given access point's WPA2/RSN -capabilities

ap_wpa

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

 

ap_mode :

the 802.11 mode of the AP, either Ad-Hoc or Infrastructure

ap_rsn

the NM80211ApSecurityFlags of the given access point's WPA2/RSN +capabilities

 

Returns :

-TRUE if the given settings are compatible with the access point's -security flags and mode, FALSE if they are not.

ap_mode

the 802.11 mode of the AP, either Ad-Hoc or Infrastructure

 
+
+

Returns

+

TRUE if the given settings are compatible with the access point's +security flags and mode, FALSE if they are not.

+

+
+
-

nm_setting_wireless_get_security ()

-
const char *        nm_setting_wireless_get_security    (NMSettingWireless *setting);
-
-

Warning

-

nm_setting_wireless_get_security has been deprecated since version 0.9.10 and should not be used in newly-written code. No longer used. Security rescrictions are recognized by +

nm_setting_wireless_get_security ()

+
const char *
+nm_setting_wireless_get_security (NMSettingWireless *setting);
+
+

nm_setting_wireless_get_security has been deprecated since version 0.9.10 and should not be used in newly-written code.

+

No longer used. Security rescrictions are recognized by the presence of NM_SETTING_WIRELESS_SECURITY_SETTING_NAME in the connection.

-
+
+

Parameters

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

setting

the NMSettingWireless

 
+
+
+

Returns

+

the “security” property of the setting

+

+
+
+ +
+

Types and Values

+
+

NM_SETTING_WIRELESS_SETTING_NAME

+
#define NM_SETTING_WIRELESS_SETTING_NAME "802-11-wireless"
+
+

+

+
+
+
+

enum NMSettingWirelessError

+
+

Members

+
--+++ - - + + - - + + + + + + + + + + + + + + + + + +

setting :

the NMSettingWireless +

NM_SETTING_WIRELESS_ERROR_UNKNOWN

+

unknown or unclassified error

 

Returns :

the "security" property of the setting

NM_SETTING_WIRELESS_ERROR_INVALID_PROPERTY

+

the property was invalid

+
 

NM_SETTING_WIRELESS_ERROR_MISSING_PROPERTY

+

the property was missing and is +required

+
 

NM_SETTING_WIRELESS_ERROR_MISSING_SECURITY_SETTING

+

property values require +the presence of an NMSettingWirelessSecurity object in the connection

+
 

NM_SETTING_WIRELESS_ERROR_CHANNEL_REQUIRES_BAND

+

the property channel was +set to a value that requires the “band” property to be set

+
 
-
-

Property Details

+
-

The "band" property

-
  "band"                     gchar*                : Read / Write
+

NM_SETTING_WIRELESS_ERROR

+
#define NM_SETTING_WIRELESS_ERROR nm_setting_wireless_error_quark ()
+

-802.11 frequency band of the network. One of "a" for 5GHz 802.11a or -"bg" for 2.4GHz 802.11. This will lock associations to the Wi-Fi network -to the specific band, i.e. if "a" is specified, the device will not -associate with the same network in the 2.4GHz band even if the network's -settings are compatible. This setting depends on specific driver -capability and may not work with all drivers.

-

Default value: NULL


-

The "bssid" property

-
  "bssid"                    GArray_guchar_*       : Read / Write
+

NM_SETTING_WIRELESS_SSID

+
#define NM_SETTING_WIRELESS_SSID        "ssid"
+

-If specified, directs the device to only associate with the given access -point. This capability is highly driver dependent and not supported by -all devices. Note: this property does not control the BSSID used when -creating an Ad-Hoc network and is unlikely to in the future.


-

The "channel" property

-
  "channel"                  guint                 : Read / Write / Construct
+

NM_SETTING_WIRELESS_MODE

+
#define NM_SETTING_WIRELESS_MODE        "mode"
+

-Wireless channel to use for the Wi-Fi connection. The device will only -join (or create for Ad-Hoc networks) a Wi-Fi network on the specified -channel. Because channel numbers overlap between bands, this property -also requires the "band" property to be set.

-

Default value: 0


-

The "cloned-mac-address" property

-
  "cloned-mac-address"       GArray_guchar_*       : Read / Write
+

NM_SETTING_WIRELESS_BAND

+
#define NM_SETTING_WIRELESS_BAND        "band"
+

-If specified, request that the Wi-Fi device use this MAC address instead -of its permanent MAC address. This is known as MAC cloning or spoofing.


-

The "hidden" property

-
  "hidden"                   gboolean              : Read / Write
+

NM_SETTING_WIRELESS_CHANNEL

+
#define NM_SETTING_WIRELESS_CHANNEL     "channel"
+

-If TRUE, indicates this network is a non-broadcasting network that hides -its SSID. In this case various workarounds may take place, such as -probe-scanning the SSID for more reliable network discovery. However, -these workarounds expose inherent insecurities with hidden SSID networks, -and thus hidden SSID networks should be used with caution.

-

Default value: FALSE


-

The "mac-address" property

-
  "mac-address"              GArray_guchar_*       : Read / Write
+

NM_SETTING_WIRELESS_BSSID

+
#define NM_SETTING_WIRELESS_BSSID       "bssid"
+

-If specified, this connection will only apply to the Wi-Fi device whose -permanent MAC address matches. This property does not change the MAC -address of the device (i.e. MAC spoofing).


-

The "mac-address-blacklist" property

-
  "mac-address-blacklist"    GSList_gchararray_*   : Read / Write
+

NM_SETTING_WIRELESS_RATE

+
#define NM_SETTING_WIRELESS_RATE        "rate"
+

-A list of permanent MAC addresses of Wi-Fi devices to which this -connection should never apply. Each MAC address should be given in the -standard hex-digits-and-colons notation (eg "00:11:22:33:44:55").


-

The "mode" property

-
  "mode"                     gchar*                : Read / Write
+

NM_SETTING_WIRELESS_TX_POWER

+
#define NM_SETTING_WIRELESS_TX_POWER    "tx-power"
+

-Wi-Fi network mode; one of "infrastructure", "adhoc" or "ap". If blank, -infrastructure is assumed.

-

Default value: NULL


-

The "mtu" property

-
  "mtu"                      guint                 : Read / Write / Construct
+

NM_SETTING_WIRELESS_MAC_ADDRESS

+
#define NM_SETTING_WIRELESS_MAC_ADDRESS "mac-address"
+

-If non-zero, only transmit packets of the specified size or smaller, -breaking larger packets up into multiple Ethernet frames.

-

Default value: 0


-

The "rate" property

-
  "rate"                     guint                 : Read / Write / Construct
+

NM_SETTING_WIRELESS_CLONED_MAC_ADDRESS

+
#define NM_SETTING_WIRELESS_CLONED_MAC_ADDRESS "cloned-mac-address"
+

-If non-zero, directs the device to only use the specified bitrate for -communication with the access point. Units are in Kb/s, ie 5500 = 5.5 -Mbit/s. This property is highly driver dependent and not all devices -support setting a static bitrate.

-

Default value: 0


-

The "security" property

-
  "security"                 gchar*                : Read / Write
-
-

Warning

-

NMSettingWireless:security has been deprecated since version 0.9.10 and should not be used in newly-written code. No longer used. Security restrictions are recognized -by the presence of a NMSettingWirelessSecurity setting in the -connection.

+

NM_SETTING_WIRELESS_MAC_ADDRESS_BLACKLIST

+
#define NM_SETTING_WIRELESS_MAC_ADDRESS_BLACKLIST "mac-address-blacklist"
+
+

+

+
+
+

NM_SETTING_WIRELESS_MTU

+
#define NM_SETTING_WIRELESS_MTU         "mtu"
+

-If the wireless connection has any security restrictions, like 802.1x, -WEP, or WPA, set this property to -NM_SETTING_WIRELESS_SECURITY_SETTING_NAME and ensure the connection -contains a valid NMSettingWirelessSecurity setting.

-

Default value: NULL


-

The "seen-bssids" property

-
  "seen-bssids"              GSList_gchararray_*   : Read / Write
+

NM_SETTING_WIRELESS_SEEN_BSSIDS

+
#define NM_SETTING_WIRELESS_SEEN_BSSIDS "seen-bssids"
+

-A list of BSSIDs (each BSSID formatted as a MAC address like -"00:11:22:33:44:55") that have been detected as part of the Wi-Fi -network. NetworkManager internally tracks previously seen BSSIDs. The -property is only meant for reading and reflects the BSSID list of -NetworkManager. The changes you make to this property will not be -preserved.


-

The "ssid" property

-
  "ssid"                     GArray_guchar_*       : Read / Write
+

NM_SETTING_WIRELESS_HIDDEN

+
#define NM_SETTING_WIRELESS_HIDDEN      "hidden"
+

-SSID of the Wi-Fi network. Must be specified.


-

The "tx-power" property

-
  "tx-power"                 guint                 : Read / Write / Construct
+

NM_SETTING_WIRELESS_SEC

+
#define NM_SETTING_WIRELESS_SEC         "security"
+

-If non-zero, directs the device to use the specified transmit power. -Units are dBm. This property is highly driver dependent and not all -devices support setting a static transmit power.

+
+
+
+

NM_SETTING_WIRELESS_MODE_ADHOC

+
#define NM_SETTING_WIRELESS_MODE_ADHOC  "adhoc"
+
+

Indicates Ad-Hoc mode where no access point is expected to be present.

+
+
+
+

NM_SETTING_WIRELESS_MODE_AP

+
#define NM_SETTING_WIRELESS_MODE_AP     "ap"
+
+

Indicates AP/master mode where the wireless device is started as an access +point/hotspot.

+

Since 0.9.8

+
+
+
+

NM_SETTING_WIRELESS_MODE_INFRA

+
#define NM_SETTING_WIRELESS_MODE_INFRA  "infrastructure"
+
+

Indicates infrastructure mode where an access point is expected to be present +for this connection.

+
+
+
+

Property Details

+
+

The “band” property

+
  “band”                     gchar *
+

+

Flags: Read / Write

+

Default value: NULL

+
+
+
+

The “bssid” property

+
  “bssid”                    GArray_guchar_ *
+

+

Flags: Read / Write

+
+
+
+

The “channel” property

+
  “channel”                  guint
+

+

Flags: Read / Write / Construct

+

Default value: 0

+
+
+
+

The “cloned-mac-address” property

+
  “cloned-mac-address”       GArray_guchar_ *
+

+

Flags: Read / Write

+
+
+
+

The “hidden” property

+
  “hidden”                   gboolean
+

+

Flags: Read / Write

+

Default value: FALSE

+
+
+
+

The “mac-address” property

+
  “mac-address”              GArray_guchar_ *
+

+

Flags: Read / Write

+
+
+
+

The “mac-address-blacklist” property

+
  “mac-address-blacklist”    GSList_gchararray_ *
+

+

Flags: Read / Write

+
+
+
+

The “mode” property

+
  “mode”                     gchar *
+

+

Flags: Read / Write

+

Default value: NULL

+
+
+
+

The “mtu” property

+
  “mtu”                      guint
+

+

Flags: Read / Write / Construct

+

Default value: 0

+
+
+
+

The “rate” property

+
  “rate”                     guint
+

+

Flags: Read / Write / Construct

+

Default value: 0

+
+
+
+

The “security” property

+
  “security”                 gchar *
+

+
+

NMSettingWireless:security has been deprecated since version 0.9.10 and should not be used in newly-written code.

+

No longer used. Security restrictions are recognized +by the presence of a NMSettingWirelessSecurity setting in the +connection.

+
+

Flags: Read / Write

+

Default value: NULL

+
+
+
+

The “seen-bssids” property

+
  “seen-bssids”              GSList_gchararray_ *
+

+

Flags: Read / Write

+
+
+
+

The “ssid” property

+
  “ssid”                     GArray_guchar_ *
+

+

Flags: Read / Write

+
+
+
+

The “tx-power” property

+
  “tx-power”                 guint
+

+

Flags: Read / Write / Construct

Default value: 0

+ Generated by GTK-Doc V1.21
\ No newline at end of file diff --git a/docs/libnm-util/html/NMSettingWirelessSecurity.html b/docs/libnm-util/html/NMSettingWirelessSecurity.html index 36b12262..6f4b21a9 100644 --- a/docs/libnm-util/html/NMSettingWirelessSecurity.html +++ b/docs/libnm-util/html/NMSettingWirelessSecurity.html @@ -2,34 +2,28 @@ -NMSettingWirelessSecurity +libnm-util Reference Manual: NMSettingWirelessSecurity - + - - - - - - - - - - + + + + + + +
@@ -38,1523 +32,1890 @@

NMSettingWirelessSecurity — Describes connection properties for Wi-Fi networks that use WEP, LEAP, WPA or WPA2/RSN security

- +
-
-

Synopsis

-
-#include <nm-setting-wireless-security.h>
-
-#define             NM_SETTING_WIRELESS_SECURITY_SETTING_NAME
-enum                NMSettingWirelessSecurityError;
-#define             NM_SETTING_WIRELESS_SECURITY_ERROR
-GQuark              nm_setting_wireless_security_error_quark
-                                                        (void);
-enum                NMWepKeyType;
-#define             NM_SETTING_WIRELESS_SECURITY_KEY_MGMT
-#define             NM_SETTING_WIRELESS_SECURITY_WEP_TX_KEYIDX
-#define             NM_SETTING_WIRELESS_SECURITY_AUTH_ALG
-#define             NM_SETTING_WIRELESS_SECURITY_PROTO
-#define             NM_SETTING_WIRELESS_SECURITY_PAIRWISE
-#define             NM_SETTING_WIRELESS_SECURITY_GROUP
-#define             NM_SETTING_WIRELESS_SECURITY_LEAP_USERNAME
-#define             NM_SETTING_WIRELESS_SECURITY_WEP_KEY0
-#define             NM_SETTING_WIRELESS_SECURITY_WEP_KEY1
-#define             NM_SETTING_WIRELESS_SECURITY_WEP_KEY2
-#define             NM_SETTING_WIRELESS_SECURITY_WEP_KEY3
-#define             NM_SETTING_WIRELESS_SECURITY_WEP_KEY_FLAGS
-#define             NM_SETTING_WIRELESS_SECURITY_WEP_KEY_TYPE
-#define             NM_SETTING_WIRELESS_SECURITY_PSK
-#define             NM_SETTING_WIRELESS_SECURITY_PSK_FLAGS
-#define             NM_SETTING_WIRELESS_SECURITY_LEAP_PASSWORD
-#define             NM_SETTING_WIRELESS_SECURITY_LEAP_PASSWORD_FLAGS
-                    NMSettingWirelessSecurity;
-                    NMSettingWirelessSecurityClass;
-NMSetting *         nm_setting_wireless_security_new    (void);
-const char *        nm_setting_wireless_security_get_key_mgmt
-                                                        (NMSettingWirelessSecurity *setting);
-guint32             nm_setting_wireless_security_get_num_protos
-                                                        (NMSettingWirelessSecurity *setting);
-const char *        nm_setting_wireless_security_get_proto
-                                                        (NMSettingWirelessSecurity *setting,
-                                                         guint32 i);
-gboolean            nm_setting_wireless_security_add_proto
-                                                        (NMSettingWirelessSecurity *setting,
-                                                         const char *proto);
-void                nm_setting_wireless_security_remove_proto
-                                                        (NMSettingWirelessSecurity *setting,
-                                                         guint32 i);
-gboolean            nm_setting_wireless_security_remove_proto_by_value
-                                                        (NMSettingWirelessSecurity *setting,
-                                                         const char *proto);
-void                nm_setting_wireless_security_clear_protos
-                                                        (NMSettingWirelessSecurity *setting);
-guint32             nm_setting_wireless_security_get_num_pairwise
-                                                        (NMSettingWirelessSecurity *setting);
-const char *        nm_setting_wireless_security_get_pairwise
-                                                        (NMSettingWirelessSecurity *setting,
-                                                         guint32 i);
-gboolean            nm_setting_wireless_security_add_pairwise
-                                                        (NMSettingWirelessSecurity *setting,
-                                                         const char *pairwise);
-void                nm_setting_wireless_security_remove_pairwise
-                                                        (NMSettingWirelessSecurity *setting,
-                                                         guint32 i);
-gboolean            nm_setting_wireless_security_remove_pairwise_by_value
-                                                        (NMSettingWirelessSecurity *setting,
-                                                         const char *pairwise);
-void                nm_setting_wireless_security_clear_pairwise
-                                                        (NMSettingWirelessSecurity *setting);
-guint32             nm_setting_wireless_security_get_num_groups
-                                                        (NMSettingWirelessSecurity *setting);
-const char *        nm_setting_wireless_security_get_group
-                                                        (NMSettingWirelessSecurity *setting,
-                                                         guint32 i);
-gboolean            nm_setting_wireless_security_add_group
-                                                        (NMSettingWirelessSecurity *setting,
-                                                         const char *group);
-void                nm_setting_wireless_security_remove_group
-                                                        (NMSettingWirelessSecurity *setting,
-                                                         guint32 i);
-gboolean            nm_setting_wireless_security_remove_group_by_value
-                                                        (NMSettingWirelessSecurity *setting,
-                                                         const char *group);
-void                nm_setting_wireless_security_clear_groups
-                                                        (NMSettingWirelessSecurity *setting);
-const char *        nm_setting_wireless_security_get_psk
-                                                        (NMSettingWirelessSecurity *setting);
-NMSettingSecretFlags nm_setting_wireless_security_get_psk_flags
-                                                        (NMSettingWirelessSecurity *setting);
-const char *        nm_setting_wireless_security_get_leap_username
-                                                        (NMSettingWirelessSecurity *setting);
-const char *        nm_setting_wireless_security_get_leap_password
-                                                        (NMSettingWirelessSecurity *setting);
-NMSettingSecretFlags nm_setting_wireless_security_get_leap_password_flags
-                                                        (NMSettingWirelessSecurity *setting);
-const char *        nm_setting_wireless_security_get_wep_key
-                                                        (NMSettingWirelessSecurity *setting,
-                                                         guint32 idx);
-void                nm_setting_wireless_security_set_wep_key
-                                                        (NMSettingWirelessSecurity *setting,
-                                                         guint32 idx,
-                                                         const char *key);
-guint32             nm_setting_wireless_security_get_wep_tx_keyidx
-                                                        (NMSettingWirelessSecurity *setting);
-const char *        nm_setting_wireless_security_get_auth_alg
-                                                        (NMSettingWirelessSecurity *setting);
-NMSettingSecretFlags nm_setting_wireless_security_get_wep_key_flags
-                                                        (NMSettingWirelessSecurity *setting);
-NMWepKeyType        nm_setting_wireless_security_get_wep_key_type
-                                                        (NMSettingWirelessSecurity *setting);
-
-
-
-

Object Hierarchy

-
-  GEnum
-   +----NMSettingWirelessSecurityError
-
-
-  GEnum
-   +----NMWepKeyType
-
-
-  GObject
-   +----NMSetting
-         +----NMSettingWirelessSecurity
-
-
-
-

Properties

-
-  "auth-alg"                 gchar*                : Read / Write
-  "group"                    GSList_gchararray_*   : Read / Write
-  "key-mgmt"                 gchar*                : Read / Write
-  "leap-password"            gchar*                : Read / Write
-  "leap-password-flags"      guint                 : Read / Write
-  "leap-username"            gchar*                : Read / Write
-  "pairwise"                 GSList_gchararray_*   : Read / Write
-  "proto"                    GSList_gchararray_*   : Read / Write
-  "psk"                      gchar*                : Read / Write
-  "psk-flags"                guint                 : Read / Write
-  "wep-key-flags"            guint                 : Read / Write
-  "wep-key-type"             guint                 : Read / Write / Construct
-  "wep-key0"                 gchar*                : Read / Write
-  "wep-key1"                 gchar*                : Read / Write
-  "wep-key2"                 gchar*                : Read / Write
-  "wep-key3"                 gchar*                : Read / Write
-  "wep-tx-keyidx"            guint                 : Read / Write / Construct
-
-
-
-

Description

-

-The NMSettingWirelessSecurity object is a NMSetting subclass that describes -properties necessary for connection to encrypted Wi-Fi networks. -

-

-It's a good idea to read up on wpa_supplicant configuration before using this -setting extensively, since most of the options here correspond closely with -the relevant wpa_supplicant configuration options. To get a better overview -of how Wi-Fi security works, you may want to get copies of the following books. -

-

- 802.11 Wireless Networks: The Definitive Guide, Second Edition - Author: Matthew Gast - ISBN: 978-0596100520 -

-

- Cisco Wireless LAN Security - Authors: Krishna Sankar, Sri Sundaralingam, Darrin Miller, and Andrew Balinsky - ISBN: 978-1587051548 -

-
-

Details

-
-

NM_SETTING_WIRELESS_SECURITY_SETTING_NAME

-
#define NM_SETTING_WIRELESS_SECURITY_SETTING_NAME "802-11-wireless-security"
-
-

-

-
-
-
-

enum NMSettingWirelessSecurityError

-
typedef enum {
-	NM_SETTING_WIRELESS_SECURITY_ERROR_UNKNOWN = 0,            /*< nick=UnknownError >*/
-	NM_SETTING_WIRELESS_SECURITY_ERROR_INVALID_PROPERTY,       /*< nick=InvalidProperty >*/
-	NM_SETTING_WIRELESS_SECURITY_ERROR_MISSING_PROPERTY,       /*< nick=MissingProperty >*/
-	NM_SETTING_WIRELESS_SECURITY_ERROR_MISSING_802_1X_SETTING, /*< nick=Missing8021xSetting >*/
-	NM_SETTING_WIRELESS_SECURITY_ERROR_LEAP_REQUIRES_802_1X,   /*< nick=LEAPRequires8021x >*/
-	NM_SETTING_WIRELESS_SECURITY_ERROR_LEAP_REQUIRES_USERNAME, /*< nick=LEAPRequiresUsername >*/
-	NM_SETTING_WIRELESS_SECURITY_ERROR_SHARED_KEY_REQUIRES_WEP /*< nick=SharedKeyRequiresWEP >*/
-} NMSettingWirelessSecurityError;
-
-
+

Functions

+
--++ - - + + + + + - - + - - + - - + - - + - - + - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

NM_SETTING_WIRELESS_SECURITY_ERROR_UNKNOWN

unknown or unclassified error + +GQuark + +nm_setting_wireless_security_error_quark () +
+NMSetting * + +nm_setting_wireless_security_new ()

NM_SETTING_WIRELESS_SECURITY_ERROR_INVALID_PROPERTY

the property was invalid +const char * + +nm_setting_wireless_security_get_key_mgmt ()

NM_SETTING_WIRELESS_SECURITY_ERROR_MISSING_PROPERTY

the property was -missing and is required + +guint32 + +nm_setting_wireless_security_get_num_protos ()

NM_SETTING_WIRELESS_SECURITY_ERROR_MISSING_802_1X_SETTING

a property contained -a value that requires the connection to contain a NMSetting8021x setting +const char * + +nm_setting_wireless_security_get_proto ()

NM_SETTING_WIRELESS_SECURITY_ERROR_LEAP_REQUIRES_802_1X

LEAP authentication -was specified but key management was not set to "8021x" + +gboolean + +nm_setting_wireless_security_add_proto ()

NM_SETTING_WIRELESS_SECURITY_ERROR_LEAP_REQUIRES_USERNAME

LEAP authentication -was specified but no LEAP username was given + +void + +nm_setting_wireless_security_remove_proto ()

NM_SETTING_WIRELESS_SECURITY_ERROR_SHARED_KEY_REQUIRES_WEP

Shared Key -authentication was specified but the setting did not specify WEP as the -encryption protocol + +gboolean + +nm_setting_wireless_security_remove_proto_by_value () +
+void + +nm_setting_wireless_security_clear_protos () +
+guint32 + +nm_setting_wireless_security_get_num_pairwise () +
const char * + +nm_setting_wireless_security_get_pairwise () +
+gboolean + +nm_setting_wireless_security_add_pairwise () +
+void + +nm_setting_wireless_security_remove_pairwise () +
+gboolean + +nm_setting_wireless_security_remove_pairwise_by_value () +
+void + +nm_setting_wireless_security_clear_pairwise () +
+guint32 + +nm_setting_wireless_security_get_num_groups () +
const char * + +nm_setting_wireless_security_get_group () +
+gboolean + +nm_setting_wireless_security_add_group () +
+void + +nm_setting_wireless_security_remove_group () +
+gboolean + +nm_setting_wireless_security_remove_group_by_value () +
+void + +nm_setting_wireless_security_clear_groups () +
const char * + +nm_setting_wireless_security_get_psk () +
+NMSettingSecretFlags + +nm_setting_wireless_security_get_psk_flags () +
const char * + +nm_setting_wireless_security_get_leap_username () +
const char * + +nm_setting_wireless_security_get_leap_password () +
+NMSettingSecretFlags + +nm_setting_wireless_security_get_leap_password_flags () +
const char * + +nm_setting_wireless_security_get_wep_key () +
+void + +nm_setting_wireless_security_set_wep_key () +
+guint32 + +nm_setting_wireless_security_get_wep_tx_keyidx () +
const char * + +nm_setting_wireless_security_get_auth_alg () +
+NMSettingSecretFlags + +nm_setting_wireless_security_get_wep_key_flags () +
+NMWepKeyType + +nm_setting_wireless_security_get_wep_key_type ()
-
-
-

NM_SETTING_WIRELESS_SECURITY_ERROR

-
#define NM_SETTING_WIRELESS_SECURITY_ERROR nm_setting_wireless_security_error_quark ()
-
-

-

-
-
-
-

nm_setting_wireless_security_error_quark ()

-
GQuark              nm_setting_wireless_security_error_quark
-                                                        (void);
-

-Registers an error quark for NMSettingWired if necessary. -

-
+
+

Properties

+
--+++ - - - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Returns :

the error quark used for NMSettingWired errors.
+gchar *auth-algRead / Write
+GSList_gchararray_ *groupRead / Write
+gchar *key-mgmtRead / Write
+gchar *leap-passwordRead / Write
guintleap-password-flagsRead / Write
+gchar *leap-usernameRead / Write
+GSList_gchararray_ *pairwiseRead / Write
+GSList_gchararray_ *protoRead / Write
+gchar *pskRead / Write
guintpsk-flagsRead / Write
guintwep-key-flagsRead / Write
guintwep-key-typeRead / Write / Construct
+gchar *wep-key0Read / Write
+gchar *wep-key1Read / Write
+gchar *wep-key2Read / Write
+gchar *wep-key3Read / Write
guintwep-tx-keyidxRead / Write / Construct
-
-
-

enum NMWepKeyType

-
typedef enum {
-	NM_WEP_KEY_TYPE_UNKNOWN = 0,
-	NM_WEP_KEY_TYPE_KEY = 1,          /* Hex or ASCII */
-	NM_WEP_KEY_TYPE_PASSPHRASE = 2,   /* 104/128-bit Passphrase */
-
-	NM_WEP_KEY_TYPE_LAST = NM_WEP_KEY_TYPE_PASSPHRASE
-} NMWepKeyType;
-
-

-The NMWepKeyType values specify how any WEP keys present in the setting -are intepreted. There are no standards governing how to hash the various WEP -key/passphrase formats into the actual WEP key. Unfortunately some WEP keys -can be interpreted in multiple ways, requring the setting to specify how to -interpret the any WEP keys. For example, the key "732f2d712e4a394a375d366931" -is both a valid Hexadecimal WEP key and a WEP passphrase. Further, many -ASCII keys are also valid WEP passphrases, but since passphrases and ASCII -keys are hashed differently to determine the actual WEP key the type must be -specified. -

-
+
+

Types and Values

+
--++ - - + + - - + + - - + + - - + + - -

NM_WEP_KEY_TYPE_UNKNOWN

unknown WEP key type -#defineNM_SETTING_WIRELESS_SECURITY_SETTING_NAME

NM_WEP_KEY_TYPE_KEY

indicates a hexadecimal or ASCII formatted WEP key. -Hex keys are either 10 or 26 hexadecimal characters (ie "5f782f2f5f" or -"732f2d712e4a394a375d366931"), while ASCII keys are either 5 or 13 ASCII -characters (ie "abcde" or "blahblah99$*1"). -enumNMSettingWirelessSecurityError

NM_WEP_KEY_TYPE_PASSPHRASE

indicates a WEP passphrase (ex "I bought a duck -on my way back from the market 235Q&^%^*%") instead of a hexadecimal or ASCII -key. Passphrases are between 8 and 64 characters inclusive and are hashed -the actual WEP key using the MD5 hash algorithm. -#defineNM_SETTING_WIRELESS_SECURITY_ERROR

NM_WEP_KEY_TYPE_LAST

placeholder value for bounds-checking -enumNMWepKeyType
-
-
-
-

NM_SETTING_WIRELESS_SECURITY_KEY_MGMT

-
#define NM_SETTING_WIRELESS_SECURITY_KEY_MGMT "key-mgmt"
-
-

-

-
-
-
-

NM_SETTING_WIRELESS_SECURITY_WEP_TX_KEYIDX

-
#define NM_SETTING_WIRELESS_SECURITY_WEP_TX_KEYIDX "wep-tx-keyidx"
-
-

-

-
-
-
-

NM_SETTING_WIRELESS_SECURITY_AUTH_ALG

-
#define NM_SETTING_WIRELESS_SECURITY_AUTH_ALG "auth-alg"
-
-

-

-
-
-
-

NM_SETTING_WIRELESS_SECURITY_PROTO

-
#define NM_SETTING_WIRELESS_SECURITY_PROTO "proto"
-
-

-

-
-
-
-

NM_SETTING_WIRELESS_SECURITY_PAIRWISE

-
#define NM_SETTING_WIRELESS_SECURITY_PAIRWISE "pairwise"
-
-

-

-
-
-
-

NM_SETTING_WIRELESS_SECURITY_GROUP

-
#define NM_SETTING_WIRELESS_SECURITY_GROUP "group"
-
-

-

-
-
-
-

NM_SETTING_WIRELESS_SECURITY_LEAP_USERNAME

-
#define NM_SETTING_WIRELESS_SECURITY_LEAP_USERNAME "leap-username"
-
-

-

-
-
-
-

NM_SETTING_WIRELESS_SECURITY_WEP_KEY0

-
#define NM_SETTING_WIRELESS_SECURITY_WEP_KEY0 "wep-key0"
-
-

-

-
-
-
-

NM_SETTING_WIRELESS_SECURITY_WEP_KEY1

-
#define NM_SETTING_WIRELESS_SECURITY_WEP_KEY1 "wep-key1"
-
-

-

-
-
-
-

NM_SETTING_WIRELESS_SECURITY_WEP_KEY2

-
#define NM_SETTING_WIRELESS_SECURITY_WEP_KEY2 "wep-key2"
-
-

-

-
-
-
-

NM_SETTING_WIRELESS_SECURITY_WEP_KEY3

-
#define NM_SETTING_WIRELESS_SECURITY_WEP_KEY3 "wep-key3"
-
-

-

-
-
-
-
-
-

NM_SETTING_WIRELESS_SECURITY_WEP_KEY_TYPE

-
#define NM_SETTING_WIRELESS_SECURITY_WEP_KEY_TYPE "wep-key-type"
+
+

Object Hierarchy

+
    GEnum
+    ├── NMSettingWirelessSecurityError
+    ╰── NMWepKeyType
+    GObject
+    ╰── NMSetting
+        ╰── NMSettingWirelessSecurity
 
-

-

-
-
-

NM_SETTING_WIRELESS_SECURITY_PSK

-
#define NM_SETTING_WIRELESS_SECURITY_PSK "psk"
+
+

Includes

+
#include <nm-setting-wireless-security.h>
 
-

-

-
-
-

NM_SETTING_WIRELESS_SECURITY_PSK_FLAGS

-
#define NM_SETTING_WIRELESS_SECURITY_PSK_FLAGS "psk-flags"
-
-

-

+
+

Description

+

The NMSettingWirelessSecurity object is a NMSetting subclass that describes +properties necessary for connection to encrypted Wi-Fi networks.

+

It's a good idea to read up on wpa_supplicant configuration before using this +setting extensively, since most of the options here correspond closely with +the relevant wpa_supplicant configuration options. To get a better overview +of how Wi-Fi security works, you may want to get copies of the following books.

+

802.11 Wireless Networks: The Definitive Guide, Second Edition + Author: Matthew Gast + ISBN: 978-0596100520

+

Cisco Wireless LAN Security + Authors: Krishna Sankar, Sri Sundaralingam, Darrin Miller, and Andrew Balinsky + ISBN: 978-1587051548

-
+
+

Functions

-

NM_SETTING_WIRELESS_SECURITY_LEAP_PASSWORD

-
#define NM_SETTING_WIRELESS_SECURITY_LEAP_PASSWORD "leap-password"
-
-

-

+

nm_setting_wireless_security_error_quark ()

+
GQuark
+nm_setting_wireless_security_error_quark
+                               (void);
+

Registers an error quark for NMSettingWired if necessary.

+
+

Returns

+

the error quark used for NMSettingWired errors.

+

-
-
-

NM_SETTING_WIRELESS_SECURITY_LEAP_PASSWORD_FLAGS

-
#define NM_SETTING_WIRELESS_SECURITY_LEAP_PASSWORD_FLAGS "leap-password-flags"
-
-

-


-

NMSettingWirelessSecurity

-
typedef struct _NMSettingWirelessSecurity NMSettingWirelessSecurity;
-

-

+

nm_setting_wireless_security_new ()

+
NMSetting *
+nm_setting_wireless_security_new (void);
+

Creates a new NMSettingWirelessSecurity object with default values.

+
+

Returns

+

the new empty NMSettingWirelessSecurity object.

+

[transfer full]

-
-
-

NMSettingWirelessSecurityClass

-
typedef struct {
-	NMSettingClass parent;
-
-	/* Padding for future expansion */
-	void (*_reserved1) (void);
-	void (*_reserved2) (void);
-	void (*_reserved3) (void);
-	void (*_reserved4) (void);
-} NMSettingWirelessSecurityClass;
-
-

-


-

nm_setting_wireless_security_new ()

-
NMSetting *         nm_setting_wireless_security_new    (void);
-

-Creates a new NMSettingWirelessSecurity object with default values. -

-
+

nm_setting_wireless_security_get_key_mgmt ()

+
const char *
+nm_setting_wireless_security_get_key_mgmt
+                               (NMSettingWirelessSecurity *setting);
+
+

Parameters

+
--+++ - - + + +

Returns :

the new empty NMSettingWirelessSecurity object. [transfer full] -

setting

the NMSettingWirelessSecurity

 
-
-
-

nm_setting_wireless_security_get_key_mgmt ()

-
const char *        nm_setting_wireless_security_get_key_mgmt
-                                                        (NMSettingWirelessSecurity *setting);
-
---- - - - - - - - - - - -

setting :

the NMSettingWirelessSecurity -

Returns :

the "key-mgmt" property of the setting
+
+

Returns

+

the “key-mgmt” property of the setting

+

+

-

nm_setting_wireless_security_get_num_protos ()

-
guint32             nm_setting_wireless_security_get_num_protos
-                                                        (NMSettingWirelessSecurity *setting);
-
+

nm_setting_wireless_security_get_num_protos ()

+
guint32
+nm_setting_wireless_security_get_num_protos
+                               (NMSettingWirelessSecurity *setting);
+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSettingWirelessSecurity -

Returns :

the number of security protocols this connection allows when -connecting to secure Wi-Fi networks

setting

the NMSettingWirelessSecurity

 
+
+

Returns

+

the number of security protocols this connection allows when +connecting to secure Wi-Fi networks

+

+
+

-

nm_setting_wireless_security_get_proto ()

-
const char *        nm_setting_wireless_security_get_proto
-                                                        (NMSettingWirelessSecurity *setting,
-                                                         guint32 i);
-
+

nm_setting_wireless_security_get_proto ()

+
const char *
+nm_setting_wireless_security_get_proto
+                               (NMSettingWirelessSecurity *setting,
+                                guint32 i);
+
+

Parameters

+
--+++ - - - - - - + + + - - + + +

setting :

the NMSettingWirelessSecurity -

i :

an index into the protocol list

setting

the NMSettingWirelessSecurity

 

Returns :

the protocol at index i -

i

an index into the protocol list

 
+
+

Returns

+

the protocol at index i +

+

+
+

-

nm_setting_wireless_security_add_proto ()

-
gboolean            nm_setting_wireless_security_add_proto
-                                                        (NMSettingWirelessSecurity *setting,
-                                                         const char *proto);
-

-Adds a Wi-Fi security protocol (one of "wpa" or "rsn") to the allowed list; +

nm_setting_wireless_security_add_proto ()

+
gboolean
+nm_setting_wireless_security_add_proto
+                               (NMSettingWirelessSecurity *setting,
+                                const char *proto);
+

Adds a Wi-Fi security protocol (one of "wpa" or "rsn") to the allowed list; only protocols in this list will be used when finding and connecting to the Wi-Fi network specified by this connection. For example, if the protocol list contains only "wpa" but the access point for the SSID specified by this connection only supports WPA2/RSN, the connection cannot be used -with the access point. -

-
+with the access point.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + +

setting :

the NMSettingWirelessSecurity -

proto :

the protocol to add, one of "wpa" or "rsn"

setting

the NMSettingWirelessSecurity

 

Returns :

-TRUE if the protocol was new and and was added to the allowed -protocol list, or FALSE if it was already in the list

proto

the protocol to add, one of "wpa" or "rsn"

 
+
+

Returns

+

TRUE if the protocol was new and and was added to the allowed +protocol list, or FALSE if it was already in the list

+

+
+

-

nm_setting_wireless_security_remove_proto ()

-
void                nm_setting_wireless_security_remove_proto
-                                                        (NMSettingWirelessSecurity *setting,
-                                                         guint32 i);
-

-Removes a protocol from the allowed protocol list. -

-
+

nm_setting_wireless_security_remove_proto ()

+
void
+nm_setting_wireless_security_remove_proto
+                               (NMSettingWirelessSecurity *setting,
+                                guint32 i);
+

Removes a protocol from the allowed protocol list.

+
+

Parameters

+
--+++ - - + + + - - + + +

setting :

the NMSettingWirelessSecurity -

setting

the NMSettingWirelessSecurity

 

i :

index of the protocol to remove

i

index of the protocol to remove

 
+

-

nm_setting_wireless_security_remove_proto_by_value ()

-
gboolean            nm_setting_wireless_security_remove_proto_by_value
-                                                        (NMSettingWirelessSecurity *setting,
-                                                         const char *proto);
-

-Removes a protocol from the allowed protocol list. -

-
+

nm_setting_wireless_security_remove_proto_by_value ()

+
gboolean
+nm_setting_wireless_security_remove_proto_by_value
+                               (NMSettingWirelessSecurity *setting,
+                                const char *proto);
+

Removes a protocol from the allowed protocol list.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + +

setting :

the NMSettingWirelessSecurity -

proto :

the protocol to remove, one of "wpa" or "rsn"

setting

the NMSettingWirelessSecurity

 

Returns :

-TRUE if the protocol was found and removed; FALSE it it was not.

proto

the protocol to remove, one of "wpa" or "rsn"

 
+
+
+

Returns

+

TRUE if the protocol was found and removed; FALSE it it was not.

+

+

Since 0.9.10


-

nm_setting_wireless_security_clear_protos ()

-
void                nm_setting_wireless_security_clear_protos
-                                                        (NMSettingWirelessSecurity *setting);
-

-Removes all protocols from the allowed list. If there are no protocols -specified then all protocols are allowed. -

-
+

nm_setting_wireless_security_clear_protos ()

+
void
+nm_setting_wireless_security_clear_protos
+                               (NMSettingWirelessSecurity *setting);
+

Removes all protocols from the allowed list. If there are no protocols +specified then all protocols are allowed.

+
+

Parameters

+
--+++ - - + + +

setting :

the NMSettingWirelessSecurity -

setting

the NMSettingWirelessSecurity

 
+

-

nm_setting_wireless_security_get_num_pairwise ()

-
guint32             nm_setting_wireless_security_get_num_pairwise
-                                                        (NMSettingWirelessSecurity *setting);
-
+

nm_setting_wireless_security_get_num_pairwise ()

+
guint32
+nm_setting_wireless_security_get_num_pairwise
+                               (NMSettingWirelessSecurity *setting);
+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSettingWirelessSecurity -

Returns :

the number of pairwise encryption algorithms in the allowed list

setting

the NMSettingWirelessSecurity

 
+
+

Returns

+

the number of pairwise encryption algorithms in the allowed list

+

+
+

-

nm_setting_wireless_security_get_pairwise ()

-
const char *        nm_setting_wireless_security_get_pairwise
-                                                        (NMSettingWirelessSecurity *setting,
-                                                         guint32 i);
-

-Returns the allowed pairwise encryption algorithm from allowed algorithm -list. -

-
+

nm_setting_wireless_security_get_pairwise ()

+
const char *
+nm_setting_wireless_security_get_pairwise
+                               (NMSettingWirelessSecurity *setting,
+                                guint32 i);
+

Returns the allowed pairwise encryption algorithm from allowed algorithm +list.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + +

setting :

the NMSettingWirelessSecurity -

i :

index of an item in the allowed pairwise encryption algorithm list

setting

the NMSettingWirelessSecurity

 

Returns :

the pairwise encryption algorithm at index i -

i

index of an item in the allowed pairwise encryption algorithm list

 
+
+

Returns

+

the pairwise encryption algorithm at index i +

+

+
+
-

nm_setting_wireless_security_add_pairwise ()

-
gboolean            nm_setting_wireless_security_add_pairwise
-                                                        (NMSettingWirelessSecurity *setting,
-                                                         const char *pairwise);
-

-Adds an encryption algorithm to the list of allowed pairwise encryption +

nm_setting_wireless_security_add_pairwise ()

+
gboolean
+nm_setting_wireless_security_add_pairwise
+                               (NMSettingWirelessSecurity *setting,
+                                const char *pairwise);
+

Adds an encryption algorithm to the list of allowed pairwise encryption algorithms. If the list is not empty, then only access points that support one or more of the encryption algorithms in the list will be considered -compatible with this connection. -

-
+compatible with this connection.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + +

setting :

the NMSettingWirelessSecurity -

pairwise :

the encryption algorithm to add, one of "tkip" or "ccmp"

setting

the NMSettingWirelessSecurity

 

Returns :

-TRUE if the algorithm was added to the list, FALSE if it was -already in the list

pairwise

the encryption algorithm to add, one of "tkip" or "ccmp"

 
+
+

Returns

+

TRUE if the algorithm was added to the list, FALSE if it was +already in the list

+

+
+
-

nm_setting_wireless_security_remove_pairwise ()

-
void                nm_setting_wireless_security_remove_pairwise
-                                                        (NMSettingWirelessSecurity *setting,
-                                                         guint32 i);
-

-Removes an encryption algorithm from the allowed pairwise encryption -algorithm list. -

-
+

nm_setting_wireless_security_remove_pairwise ()

+
void
+nm_setting_wireless_security_remove_pairwise
+                               (NMSettingWirelessSecurity *setting,
+                                guint32 i);
+

Removes an encryption algorithm from the allowed pairwise encryption +algorithm list.

+
+

Parameters

+
--+++ - - + + + - - + + +

setting :

the NMSettingWirelessSecurity -

setting

the NMSettingWirelessSecurity

 

i :

the index of an item in the allowed pairwise encryption algorithm list

i

the index of an item in the allowed pairwise encryption algorithm list

 
+
-

nm_setting_wireless_security_remove_pairwise_by_value ()

-
gboolean            nm_setting_wireless_security_remove_pairwise_by_value
-                                                        (NMSettingWirelessSecurity *setting,
-                                                         const char *pairwise);
-

-Removes an encryption algorithm from the allowed pairwise encryption -algorithm list. -

-
+

nm_setting_wireless_security_remove_pairwise_by_value ()

+
gboolean
+nm_setting_wireless_security_remove_pairwise_by_value
+                               (NMSettingWirelessSecurity *setting,
+                                const char *pairwise);
+

Removes an encryption algorithm from the allowed pairwise encryption +algorithm list.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + +

setting :

the NMSettingWirelessSecurity -

pairwise :

the encryption algorithm to remove, one of "tkip" or "ccmp"

setting

the NMSettingWirelessSecurity

 

Returns :

-TRUE if the encryption algorith was found and removed; FALSE it it was not.

pairwise

the encryption algorithm to remove, one of "tkip" or "ccmp"

 
+
+
+

Returns

+

TRUE if the encryption algorith was found and removed; FALSE it it was not.

+

+

Since 0.9.10


-

nm_setting_wireless_security_clear_pairwise ()

-
void                nm_setting_wireless_security_clear_pairwise
-                                                        (NMSettingWirelessSecurity *setting);
-

-Removes all algorithms from the allowed list. If there are no algorithms -specified then all pairwise encryption algorithms are allowed. -

-
+

nm_setting_wireless_security_clear_pairwise ()

+
void
+nm_setting_wireless_security_clear_pairwise
+                               (NMSettingWirelessSecurity *setting);
+

Removes all algorithms from the allowed list. If there are no algorithms +specified then all pairwise encryption algorithms are allowed.

+
+

Parameters

+
--+++ - - + + +

setting :

the NMSettingWirelessSecurity -

setting

the NMSettingWirelessSecurity

 
+
-

nm_setting_wireless_security_get_num_groups ()

-
guint32             nm_setting_wireless_security_get_num_groups
-                                                        (NMSettingWirelessSecurity *setting);
-
+

nm_setting_wireless_security_get_num_groups ()

+
guint32
+nm_setting_wireless_security_get_num_groups
+                               (NMSettingWirelessSecurity *setting);
+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSettingWirelessSecurity -

Returns :

the number of groupwise encryption algorithms in the allowed list

setting

the NMSettingWirelessSecurity

 
+
+

Returns

+

the number of groupwise encryption algorithms in the allowed list

+

+
+
-

nm_setting_wireless_security_get_group ()

-
const char *        nm_setting_wireless_security_get_group
-                                                        (NMSettingWirelessSecurity *setting,
-                                                         guint32 i);
-

-Returns the allowed groupwise encryption algorithm from allowed algorithm -list. -

-
+

nm_setting_wireless_security_get_group ()

+
const char *
+nm_setting_wireless_security_get_group
+                               (NMSettingWirelessSecurity *setting,
+                                guint32 i);
+

Returns the allowed groupwise encryption algorithm from allowed algorithm +list.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + +

setting :

the NMSettingWirelessSecurity -

i :

index of an item in the allowed groupwise encryption algorithm list

setting

the NMSettingWirelessSecurity

 

Returns :

the groupwise encryption algorithm at index i -

i

index of an item in the allowed groupwise encryption algorithm list

 
+
+

Returns

+

the groupwise encryption algorithm at index i +

+

+
+
-

nm_setting_wireless_security_add_group ()

-
gboolean            nm_setting_wireless_security_add_group
-                                                        (NMSettingWirelessSecurity *setting,
-                                                         const char *group);
-

-Adds an encryption algorithm to the list of allowed groupwise encryption +

nm_setting_wireless_security_add_group ()

+
gboolean
+nm_setting_wireless_security_add_group
+                               (NMSettingWirelessSecurity *setting,
+                                const char *group);
+

Adds an encryption algorithm to the list of allowed groupwise encryption algorithms. If the list is not empty, then only access points that support one or more of the encryption algorithms in the list will be considered -compatible with this connection. -

-
+compatible with this connection.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + +

setting :

the NMSettingWirelessSecurity -

group :

the encryption algorithm to add, one of "wep40", "wep104", -"tkip", or "ccmp"

setting

the NMSettingWirelessSecurity

 

Returns :

-TRUE if the algorithm was added to the list, FALSE if it was -already in the list

group

the encryption algorithm to add, one of "wep40", "wep104", +"tkip", or "ccmp"

 
+
+

Returns

+

TRUE if the algorithm was added to the list, FALSE if it was +already in the list

+

+
+
-

nm_setting_wireless_security_remove_group ()

-
void                nm_setting_wireless_security_remove_group
-                                                        (NMSettingWirelessSecurity *setting,
-                                                         guint32 i);
-

-Removes an encryption algorithm from the allowed groupwise encryption -algorithm list. -

-
+

nm_setting_wireless_security_remove_group ()

+
void
+nm_setting_wireless_security_remove_group
+                               (NMSettingWirelessSecurity *setting,
+                                guint32 i);
+

Removes an encryption algorithm from the allowed groupwise encryption +algorithm list.

+
+

Parameters

+
--+++ - - + + + - - + + +

setting :

the NMSettingWirelessSecurity -

setting

the NMSettingWirelessSecurity

 

i :

the index of an item in the allowed groupwise encryption algorithm list

i

the index of an item in the allowed groupwise encryption algorithm list

 
+
-

nm_setting_wireless_security_remove_group_by_value ()

-
gboolean            nm_setting_wireless_security_remove_group_by_value
-                                                        (NMSettingWirelessSecurity *setting,
-                                                         const char *group);
-

-Removes an encryption algorithm from the allowed groupwise encryption -algorithm list. -

-
+

nm_setting_wireless_security_remove_group_by_value ()

+
gboolean
+nm_setting_wireless_security_remove_group_by_value
+                               (NMSettingWirelessSecurity *setting,
+                                const char *group);
+

Removes an encryption algorithm from the allowed groupwise encryption +algorithm list.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + +

setting :

the NMSettingWirelessSecurity -

group :

the encryption algorithm to remove, one of "wep40", "wep104", -"tkip", or "ccmp"

setting

the NMSettingWirelessSecurity

 

Returns :

-TRUE if the algorithm was found and removed; FALSE it it was not.

group

the encryption algorithm to remove, one of "wep40", "wep104", +"tkip", or "ccmp"

 
+
+
+

Returns

+

TRUE if the algorithm was found and removed; FALSE it it was not.

+

+

Since 0.9.10


-

nm_setting_wireless_security_clear_groups ()

-
void                nm_setting_wireless_security_clear_groups
-                                                        (NMSettingWirelessSecurity *setting);
-

-Removes all algorithms from the allowed list. If there are no algorithms -specified then all groupwise encryption algorithms are allowed. -

-
+

nm_setting_wireless_security_clear_groups ()

+
void
+nm_setting_wireless_security_clear_groups
+                               (NMSettingWirelessSecurity *setting);
+

Removes all algorithms from the allowed list. If there are no algorithms +specified then all groupwise encryption algorithms are allowed.

+
+

Parameters

+
--+++ - - + + + + +

setting :

the NMSettingWirelessSecurity -

setting

the NMSettingWirelessSecurity

 
+
+ +
+
+

nm_setting_wireless_security_get_psk ()

+
const char *
+nm_setting_wireless_security_get_psk (NMSettingWirelessSecurity *setting);
+
+

Parameters

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

setting

the NMSettingWirelessSecurity

 
+
+
+

Returns

+

the “psk” property of the setting

+

+
+
+
+
+

nm_setting_wireless_security_get_psk_flags ()

+
NMSettingSecretFlags
+nm_setting_wireless_security_get_psk_flags
+                               (NMSettingWirelessSecurity *setting);
+
+

Parameters

+
+++++ + + + +

setting

the NMSettingWirelessSecurity

 
+
+

Returns

+

the NMSettingSecretFlags pertaining to the +“psk”

+

+
+
+
+
+

nm_setting_wireless_security_get_leap_username ()

+
const char *
+nm_setting_wireless_security_get_leap_username
+                               (NMSettingWirelessSecurity *setting);
+
+

Parameters

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

setting

the NMSettingWirelessSecurity

 
+
+
+

Returns

+

the “leap-username” property of the setting

+

+
+
+
+
+

nm_setting_wireless_security_get_leap_password ()

+
const char *
+nm_setting_wireless_security_get_leap_password
+                               (NMSettingWirelessSecurity *setting);
+
+

Parameters

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

setting

the NMSettingWirelessSecurity

 
+
+
+

Returns

+

the “leap-password” property of the setting

+

+
+
+
+
+

nm_setting_wireless_security_get_leap_password_flags ()

+
NMSettingSecretFlags
+nm_setting_wireless_security_get_leap_password_flags
+                               (NMSettingWirelessSecurity *setting);
+
+

Parameters

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

setting

the NMSettingWirelessSecurity

 
+
+
+

Returns

+

the NMSettingSecretFlags pertaining to the +“leap-password”

+

+
+

-

nm_setting_wireless_security_get_psk ()

-
const char *        nm_setting_wireless_security_get_psk
-                                                        (NMSettingWirelessSecurity *setting);
-
+

nm_setting_wireless_security_get_wep_key ()

+
const char *
+nm_setting_wireless_security_get_wep_key
+                               (NMSettingWirelessSecurity *setting,
+                                guint32 idx);
+
+

Parameters

+
--+++ - - + + + - - + + +

setting :

the NMSettingWirelessSecurity -

setting

the NMSettingWirelessSecurity

 

Returns :

the "psk" property of the setting

idx

the WEP key index (0..3 inclusive)

 
+
+

Returns

+

the WEP key at the given index

+

+
+
-

nm_setting_wireless_security_get_psk_flags ()

-
NMSettingSecretFlags nm_setting_wireless_security_get_psk_flags
-                                                        (NMSettingWirelessSecurity *setting);
-
+

nm_setting_wireless_security_set_wep_key ()

+
void
+nm_setting_wireless_security_set_wep_key
+                               (NMSettingWirelessSecurity *setting,
+                                guint32 idx,
+                                const char *key);
+

Sets a WEP key in the given index.

+
+

Parameters

+
--+++ - - + + + - - + + + + + + + +

setting :

the NMSettingWirelessSecurity -

setting

the NMSettingWirelessSecurity

 

Returns :

the NMSettingSecretFlags pertaining to the -"psk" -

idx

the index of the key (0..3 inclusive)

 

key

the WEP key as a string, in either hexadecimal, ASCII, or passphrase +form as determiend by the value of the “wep-key-type” +property.

 
+
-

nm_setting_wireless_security_get_leap_username ()

-
const char *        nm_setting_wireless_security_get_leap_username
-                                                        (NMSettingWirelessSecurity *setting);
-
+

nm_setting_wireless_security_get_wep_tx_keyidx ()

+
guint32
+nm_setting_wireless_security_get_wep_tx_keyidx
+                               (NMSettingWirelessSecurity *setting);
+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSettingWirelessSecurity -

Returns :

the "leap-username" property of the setting

setting

the NMSettingWirelessSecurity

 
+
+

Returns

+

the “wep-tx-keyidx” property of the setting

+

+
+
-

nm_setting_wireless_security_get_leap_password ()

-
const char *        nm_setting_wireless_security_get_leap_password
-                                                        (NMSettingWirelessSecurity *setting);
-
+

nm_setting_wireless_security_get_auth_alg ()

+
const char *
+nm_setting_wireless_security_get_auth_alg
+                               (NMSettingWirelessSecurity *setting);
+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSettingWirelessSecurity -

Returns :

the "leap-password" property of the setting

setting

the NMSettingWirelessSecurity

 
+
+

Returns

+

the “auth-alg” property of the setting

+

+
+
-

nm_setting_wireless_security_get_leap_password_flags ()

-
NMSettingSecretFlags nm_setting_wireless_security_get_leap_password_flags
-                                                        (NMSettingWirelessSecurity *setting);
-
+

nm_setting_wireless_security_get_wep_key_flags ()

+
NMSettingSecretFlags
+nm_setting_wireless_security_get_wep_key_flags
+                               (NMSettingWirelessSecurity *setting);
+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSettingWirelessSecurity -

Returns :

the NMSettingSecretFlags pertaining to the -"leap-password" -

setting

the NMSettingWirelessSecurity

 
+
+

Returns

+

the NMSettingSecretFlags pertaining to the all WEP keys

+

+
+
-

nm_setting_wireless_security_get_wep_key ()

-
const char *        nm_setting_wireless_security_get_wep_key
-                                                        (NMSettingWirelessSecurity *setting,
-                                                         guint32 idx);
-
+

nm_setting_wireless_security_get_wep_key_type ()

+
NMWepKeyType
+nm_setting_wireless_security_get_wep_key_type
+                               (NMSettingWirelessSecurity *setting);
+
+

Parameters

+
--+++ - - - - - - - - - - - - - - + + + + +

setting :

the NMSettingWirelessSecurity -

idx :

the WEP key index (0..3 inclusive)

Returns :

the WEP key at the given index

setting

the NMSettingWirelessSecurity

 
-
+
+

Returns

+

the “wep-key-type” property of the setting

+

+
+ + +
+

Types and Values

-

nm_setting_wireless_security_set_wep_key ()

-
void                nm_setting_wireless_security_set_wep_key
-                                                        (NMSettingWirelessSecurity *setting,
-                                                         guint32 idx,
-                                                         const char *key);
+

NM_SETTING_WIRELESS_SECURITY_SETTING_NAME

+
#define NM_SETTING_WIRELESS_SECURITY_SETTING_NAME "802-11-wireless-security"
+

-Sets a WEP key in the given index.

-
+ +
+
+

enum NMSettingWirelessSecurityError

+
+

Members

+
--+++ - - + + - - + + + - - + + + - -

setting :

the NMSettingWirelessSecurity +

NM_SETTING_WIRELESS_SECURITY_ERROR_UNKNOWN

+

unknown or unclassified error

 

idx :

the index of the key (0..3 inclusive)

NM_SETTING_WIRELESS_SECURITY_ERROR_INVALID_PROPERTY

+

the property was invalid

+
 

key :

the WEP key as a string, in either hexadecimal, ASCII, or passphrase -form as determiend by the value of the "wep-key-type" -property.

NM_SETTING_WIRELESS_SECURITY_ERROR_MISSING_PROPERTY

+

the property was +missing and is required

+
 
-
-
-
-

nm_setting_wireless_security_get_wep_tx_keyidx ()

-
guint32             nm_setting_wireless_security_get_wep_tx_keyidx
-                                                        (NMSettingWirelessSecurity *setting);
-
---- - - - + + - - + + + - -

setting :

the NMSettingWirelessSecurity +

NM_SETTING_WIRELESS_SECURITY_ERROR_MISSING_802_1X_SETTING

+

a property contained +a value that requires the connection to contain a NMSetting8021x setting

 

Returns :

the "wep-tx-keyidx" property of the setting

NM_SETTING_WIRELESS_SECURITY_ERROR_LEAP_REQUIRES_802_1X

+

LEAP authentication +was specified but key management was not set to "8021x"

+
 
-
-
-
-

nm_setting_wireless_security_get_auth_alg ()

-
const char *        nm_setting_wireless_security_get_auth_alg
-                                                        (NMSettingWirelessSecurity *setting);
-
---- - - - + + - - + + +

setting :

the NMSettingWirelessSecurity +

NM_SETTING_WIRELESS_SECURITY_ERROR_LEAP_REQUIRES_USERNAME

+

LEAP authentication +was specified but no LEAP username was given

 

Returns :

the "auth-alg" property of the setting

NM_SETTING_WIRELESS_SECURITY_ERROR_SHARED_KEY_REQUIRES_WEP

+

Shared Key +authentication was specified but the setting did not specify WEP as the +encryption protocol

+
 
+
+
+
+

NM_SETTING_WIRELESS_SECURITY_ERROR

+
#define NM_SETTING_WIRELESS_SECURITY_ERROR nm_setting_wireless_security_error_quark ()
+
+

+

+

-

nm_setting_wireless_security_get_wep_key_flags ()

-
NMSettingSecretFlags nm_setting_wireless_security_get_wep_key_flags
-                                                        (NMSettingWirelessSecurity *setting);
-
+

enum NMWepKeyType

+

The NMWepKeyType values specify how any WEP keys present in the setting +are intepreted. There are no standards governing how to hash the various WEP +key/passphrase formats into the actual WEP key. Unfortunately some WEP keys +can be interpreted in multiple ways, requring the setting to specify how to +interpret the any WEP keys. For example, the key "732f2d712e4a394a375d366931" +is both a valid Hexadecimal WEP key and a WEP passphrase. Further, many +ASCII keys are also valid WEP passphrases, but since passphrases and ASCII +keys are hashed differently to determine the actual WEP key the type must be +specified.

+
+

Members

+
--+++ - - + + - - + + + - -

setting :

the NMSettingWirelessSecurity +

NM_WEP_KEY_TYPE_UNKNOWN

+

unknown WEP key type

 

Returns :

the NMSettingSecretFlags pertaining to the all WEP keys

NM_WEP_KEY_TYPE_KEY

+

indicates a hexadecimal or ASCII formatted WEP key. +Hex keys are either 10 or 26 hexadecimal characters (ie "5f782f2f5f" or +"732f2d712e4a394a375d366931"), while ASCII keys are either 5 or 13 ASCII +characters (ie "abcde" or "blahblah99$*1").

+
 
-
-
-
-

nm_setting_wireless_security_get_wep_key_type ()

-
NMWepKeyType        nm_setting_wireless_security_get_wep_key_type
-                                                        (NMSettingWirelessSecurity *setting);
-
---- - - - + + - - + + +

setting :

the NMSettingWirelessSecurity +

NM_WEP_KEY_TYPE_PASSPHRASE

+

indicates a WEP passphrase (ex "I bought a duck +on my way back from the market 235Q&^%^*%") instead of a hexadecimal or ASCII +key. Passphrases are between 8 and 64 characters inclusive and are hashed +the actual WEP key using the MD5 hash algorithm.

 

Returns :

the "wep-key-type" property of the setting

NM_WEP_KEY_TYPE_LAST

+

placeholder value for bounds-checking

+
 
-
-

Property Details

+
-

The "auth-alg" property

-
  "auth-alg"                 gchar*                : Read / Write
+

NM_SETTING_WIRELESS_SECURITY_KEY_MGMT

+
#define NM_SETTING_WIRELESS_SECURITY_KEY_MGMT "key-mgmt"
+

-When WEP is used (ie, key-mgmt = "none" or "ieee8021x") indicate the -802.11 authentication algorithm required by the AP here. One of "open" -for Open System, "shared" for Shared Key, or "leap" for Cisco LEAP. When -using Cisco LEAP (ie, key-mgmt = "ieee8021x" and auth-alg = "leap") the -"leap-username" and "leap-password" properties must be specified.

-

Default value: NULL


-

The "group" property

-
  "group"                    GSList_gchararray_*   : Read / Write
+

NM_SETTING_WIRELESS_SECURITY_WEP_TX_KEYIDX

+
#define NM_SETTING_WIRELESS_SECURITY_WEP_TX_KEYIDX "wep-tx-keyidx"
+

-A list of group/broadcast encryption algorithms which prevents -connections to Wi-Fi networks that do not utilize one of the algorithms -in the list. For maximum compatibility leave this property empty. Each -list element may be one of "wep40", "wep104", "tkip", or "ccmp".


-

The "key-mgmt" property

-
  "key-mgmt"                 gchar*                : Read / Write
+

NM_SETTING_WIRELESS_SECURITY_AUTH_ALG

+
#define NM_SETTING_WIRELESS_SECURITY_AUTH_ALG "auth-alg"
+

-Key management used for the connection. One of "none" (WEP), "ieee8021x" -(Dynamic WEP), "wpa-none" (Ad-Hoc WPA-PSK), "wpa-psk" (infrastructure -WPA-PSK), or "wpa-eap" (WPA-Enterprise). This property must be set for -any Wi-Fi connection that uses security.

-

Default value: NULL


-

The "leap-password" property

-
  "leap-password"            gchar*                : Read / Write
+

NM_SETTING_WIRELESS_SECURITY_PROTO

+
#define NM_SETTING_WIRELESS_SECURITY_PROTO "proto"
+

-The login password for legacy LEAP connections (ie, key-mgmt = -"ieee8021x" and auth-alg = "leap").

-

Default value: NULL


-

The "leap-password-flags" property

-
  "leap-password-flags"      guint                 : Read / Write
+

NM_SETTING_WIRELESS_SECURITY_PAIRWISE

+
#define NM_SETTING_WIRELESS_SECURITY_PAIRWISE "pairwise"
+

-Flags indicating how to handle the -"leap-password" property.

-

Allowed values: <= 7

-

Default value: 0


-

The "leap-username" property

-
  "leap-username"            gchar*                : Read / Write
+

NM_SETTING_WIRELESS_SECURITY_GROUP

+
#define NM_SETTING_WIRELESS_SECURITY_GROUP "group"
+

-The login username for legacy LEAP connections (ie, key-mgmt = -"ieee8021x" and auth-alg = "leap").

-

Default value: NULL


-

The "pairwise" property

-
  "pairwise"                 GSList_gchararray_*   : Read / Write
+

NM_SETTING_WIRELESS_SECURITY_LEAP_USERNAME

+
#define NM_SETTING_WIRELESS_SECURITY_LEAP_USERNAME "leap-username"
+

-A list of pairwise encryption algorithms which prevents connections to -Wi-Fi networks that do not utilize one of the algorithms in the list. -For maximum compatibility leave this property empty. Each list element -may be one of "tkip" or "ccmp".


-

The "proto" property

-
  "proto"                    GSList_gchararray_*   : Read / Write
+

NM_SETTING_WIRELESS_SECURITY_WEP_KEY0

+
#define NM_SETTING_WIRELESS_SECURITY_WEP_KEY0 "wep-key0"
+

-List of strings specifying the allowed WPA protocol versions to use. -Each element may be one "wpa" (allow WPA) or "rsn" (allow WPA2/RSN). If -not specified, both WPA and RSN connections are allowed.


-

The "psk" property

-
  "psk"                      gchar*                : Read / Write
+

NM_SETTING_WIRELESS_SECURITY_WEP_KEY1

+
#define NM_SETTING_WIRELESS_SECURITY_WEP_KEY1 "wep-key1"
+

-Pre-Shared-Key for WPA networks. If the key is 64-characters long, it -must contain only hexadecimal characters and is interpreted as a -hexadecimal WPA key. Otherwise, the key must be between 8 and 63 ASCII -characters (as specified in the 802.11i standard) and is interpreted as a -WPA passphrase, and is hashed to derive the actual WPA-PSK used when -connecting to the Wi-Fi network.

-

Default value: NULL


-

The "psk-flags" property

-
  "psk-flags"                guint                 : Read / Write
+

NM_SETTING_WIRELESS_SECURITY_WEP_KEY2

+
#define NM_SETTING_WIRELESS_SECURITY_WEP_KEY2 "wep-key2"
+

-Flags indicating how to handle the "psk" -property.

-

Allowed values: <= 7

-

Default value: 0


-

The "wep-key-flags" property

-
  "wep-key-flags"            guint                 : Read / Write
+

NM_SETTING_WIRELESS_SECURITY_WEP_KEY3

+
#define NM_SETTING_WIRELESS_SECURITY_WEP_KEY3 "wep-key3"
+

-Flags indicating how to handle the "wep-key0", -"wep-key1", "wep-key2", -and "wep-key3" properties.

-

Allowed values: <= 7

-

Default value: 0


-

The "wep-key-type" property

-
  "wep-key-type"             guint                 : Read / Write / Construct
+

NM_SETTING_WIRELESS_SECURITY_WEP_KEY_FLAGS

+
#define NM_SETTING_WIRELESS_SECURITY_WEP_KEY_FLAGS "wep-key-flags"
+

-Controls the interpretation of WEP keys. Allowed values are -NM_WEP_KEY_TYPE_KEY, in which case the key is either a 10- or -26-character hexadecimal string, or a 5- or 13-character ASCII password; -or NM_WEP_KEY_TYPE_PASSPHRASE, in which case the passphrase is provided -as a string and will be hashed using the de-facto MD5 method to derive -the actual WEP key.

-

Allowed values: <= 2

-

Default value: 0


-

The "wep-key0" property

-
  "wep-key0"                 gchar*                : Read / Write
+

NM_SETTING_WIRELESS_SECURITY_WEP_KEY_TYPE

+
#define NM_SETTING_WIRELESS_SECURITY_WEP_KEY_TYPE "wep-key-type"
+

-Index 0 WEP key. This is the WEP key used in most networks. See the -"wep-key-type" property for a description of how this key is interpreted.

-

Default value: NULL


-

The "wep-key1" property

-
  "wep-key1"                 gchar*                : Read / Write
+

NM_SETTING_WIRELESS_SECURITY_PSK

+
#define NM_SETTING_WIRELESS_SECURITY_PSK "psk"
+

-Index 1 WEP key. This WEP index is not used by most networks. See the -"wep-key-type" property for a description of how this key is interpreted.

-

Default value: NULL


-

The "wep-key2" property

-
  "wep-key2"                 gchar*                : Read / Write
+

NM_SETTING_WIRELESS_SECURITY_PSK_FLAGS

+
#define NM_SETTING_WIRELESS_SECURITY_PSK_FLAGS "psk-flags"
+

-Index 2 WEP key. This WEP index is not used by most networks. See the -"wep-key-type" property for a description of how this key is interpreted.

-

Default value: NULL


-

The "wep-key3" property

-
  "wep-key3"                 gchar*                : Read / Write
+

NM_SETTING_WIRELESS_SECURITY_LEAP_PASSWORD

+
#define NM_SETTING_WIRELESS_SECURITY_LEAP_PASSWORD "leap-password"
+

-Index 3 WEP key. This WEP index is not used by most networks. See the -"wep-key-type" property for a description of how this key is interpreted.

-

Default value: NULL


-

The "wep-tx-keyidx" property

-
  "wep-tx-keyidx"            guint                 : Read / Write / Construct
+

NM_SETTING_WIRELESS_SECURITY_LEAP_PASSWORD_FLAGS

+
#define NM_SETTING_WIRELESS_SECURITY_LEAP_PASSWORD_FLAGS "leap-password-flags"
+

-When static WEP is used (ie, key-mgmt = "none") and a non-default WEP key -index is used by the AP, put that WEP key index here. Valid values are 0 -(default key) through 3. Note that some consumer access points (like the -Linksys WRT54G) number the keys 1 - 4.

+
+
+
+

Property Details

+
+

The “auth-alg” property

+
  “auth-alg”                 gchar *
+

+

Flags: Read / Write

+

Default value: NULL

+
+
+
+

The “group” property

+
  “group”                    GSList_gchararray_ *
+

+

Flags: Read / Write

+
+
+
+

The “key-mgmt” property

+
  “key-mgmt”                 gchar *
+

+

Flags: Read / Write

+

Default value: NULL

+
+
+
+

The “leap-password” property

+
  “leap-password”            gchar *
+

+

Flags: Read / Write

+

Default value: NULL

+
+
+
+

The “leap-password-flags” property

+
  “leap-password-flags”      guint
+

+

Flags: Read / Write

+

Allowed values: <= 7

+

Default value: 0

+
+
+
+

The “leap-username” property

+
  “leap-username”            gchar *
+

+

Flags: Read / Write

+

Default value: NULL

+
+
+
+

The “pairwise” property

+
  “pairwise”                 GSList_gchararray_ *
+

+

Flags: Read / Write

+
+
+
+

The “proto” property

+
  “proto”                    GSList_gchararray_ *
+

+

Flags: Read / Write

+
+
+
+

The “psk” property

+
  “psk”                      gchar *
+

+

Flags: Read / Write

+

Default value: NULL

+
+
+
+

The “psk-flags” property

+
  “psk-flags”                guint
+

+

Flags: Read / Write

+

Allowed values: <= 7

+

Default value: 0

+
+
+
+

The “wep-key-flags” property

+
  “wep-key-flags”            guint
+

+

Flags: Read / Write

+

Allowed values: <= 7

+

Default value: 0

+
+
+
+

The “wep-key-type” property

+
  “wep-key-type”             guint
+

+

Flags: Read / Write / Construct

+

Allowed values: <= 2

+

Default value: 0

+
+
+
+

The “wep-key0” property

+
  “wep-key0”                 gchar *
+

+

Flags: Read / Write

+

Default value: NULL

+
+
+
+

The “wep-key1” property

+
  “wep-key1”                 gchar *
+

+

Flags: Read / Write

+

Default value: NULL

+
+
+
+

The “wep-key2” property

+
  “wep-key2”                 gchar *
+

+

Flags: Read / Write

+

Default value: NULL

+
+
+
+

The “wep-key3” property

+
  “wep-key3”                 gchar *
+

+

Flags: Read / Write

+

Default value: NULL

+
+
+
+

The “wep-tx-keyidx” property

+
  “wep-tx-keyidx”            guint
+

+

Flags: Read / Write / Construct

Allowed values: <= 3

Default value: 0

@@ -1562,6 +1923,6 @@ Linksys WRT54G) number the keys 1 - 4.
+ Generated by GTK-Doc V1.21 \ No newline at end of file diff --git a/docs/libnm-util/html/annotation-glossary.html b/docs/libnm-util/html/annotation-glossary.html index 1c488594..fbcda20a 100644 --- a/docs/libnm-util/html/annotation-glossary.html +++ b/docs/libnm-util/html/annotation-glossary.html @@ -2,45 +2,40 @@ -Annotation Glossary +libnm-util Reference Manual: Annotation Glossary - + - - - - - - - - - - + + + + + + +

Annotation Glossary

A

allow-none
-

NULL is ok, both for passing and for returning.

+

NULL is OK, both for passing and for returning.

array

Parameter points to an array of items.

C

@@ -68,6 +63,6 @@
+ Generated by GTK-Doc V1.21 \ No newline at end of file diff --git a/docs/libnm-util/html/api-index-full.html b/docs/libnm-util/html/api-index-full.html index c9819416..228ba8e6 100644 --- a/docs/libnm-util/html/api-index-full.html +++ b/docs/libnm-util/html/api-index-full.html @@ -2,46 +2,41 @@ -API Index +libnm-util Reference Manual: API Index - + - - - - - - - - - - + + + + + + +

API Index

@@ -74,31 +69,27 @@
-NMConnection::changed, object signal in NMConnection +NMConnection::changed, object signal in NMConnection
-NMConnection::secrets-cleared, object signal in NMConnection +NMConnection::secrets-cleared, object signal in NMConnection
-NMConnection::secrets-updated, object signal in NMConnection +NMConnection::secrets-updated, object signal in NMConnection
-NMConnection:path, object property in NMConnection +NMConnection:path, object property in NMConnection
-NMConnectionClass, struct in NMConnection +NMConnectionError, enum in NMConnection
-NMConnectionError, enum in NMConnection -
-
-
-nm_connection_add_setting, function in NMConnection +nm_connection_add_setting, function in NMConnection
@@ -106,31 +97,31 @@
-nm_connection_clear_secrets, function in NMConnection +nm_connection_clear_secrets, function in NMConnection
-nm_connection_clear_secrets_with_flags, function in NMConnection +nm_connection_clear_secrets_with_flags, function in NMConnection
-nm_connection_compare, function in NMConnection +nm_connection_compare, function in NMConnection
-nm_connection_create_setting, function in NMConnection +nm_connection_create_setting, function in NMConnection
-nm_connection_diff, function in NMConnection +nm_connection_diff, function in NMConnection
-nm_connection_dump, function in NMConnection +nm_connection_dump, function in NMConnection
-nm_connection_duplicate, function in NMConnection +nm_connection_duplicate, function in NMConnection
@@ -138,179 +129,179 @@
-nm_connection_error_quark, function in NMConnection +nm_connection_error_quark, function in NMConnection
-nm_connection_for_each_setting_value, function in NMConnection +nm_connection_for_each_setting_value, function in NMConnection
-nm_connection_get_connection_type, function in NMConnection +nm_connection_get_connection_type, function in NMConnection
-nm_connection_get_id, function in NMConnection +nm_connection_get_id, function in NMConnection
-nm_connection_get_interface_name, function in NMConnection +nm_connection_get_interface_name, function in NMConnection
-nm_connection_get_path, function in NMConnection +nm_connection_get_path, function in NMConnection
-nm_connection_get_setting, function in NMConnection +nm_connection_get_setting, function in NMConnection
-nm_connection_get_setting_802_1x, function in NMConnection +nm_connection_get_setting_802_1x, function in NMConnection
-nm_connection_get_setting_adsl, function in NMConnection +nm_connection_get_setting_adsl, function in NMConnection
-nm_connection_get_setting_bluetooth, function in NMConnection +nm_connection_get_setting_bluetooth, function in NMConnection
-nm_connection_get_setting_bond, function in NMConnection +nm_connection_get_setting_bond, function in NMConnection
-nm_connection_get_setting_bridge, function in NMConnection +nm_connection_get_setting_bridge, function in NMConnection
-nm_connection_get_setting_bridge_port, function in NMConnection +nm_connection_get_setting_bridge_port, function in NMConnection
-nm_connection_get_setting_by_name, function in NMConnection +nm_connection_get_setting_by_name, function in NMConnection
-nm_connection_get_setting_cdma, function in NMConnection +nm_connection_get_setting_cdma, function in NMConnection
-nm_connection_get_setting_connection, function in NMConnection +nm_connection_get_setting_connection, function in NMConnection
-nm_connection_get_setting_dcb, function in NMConnection +nm_connection_get_setting_dcb, function in NMConnection
-nm_connection_get_setting_generic, function in NMConnection +nm_connection_get_setting_generic, function in NMConnection
-nm_connection_get_setting_gsm, function in NMConnection +nm_connection_get_setting_gsm, function in NMConnection
-nm_connection_get_setting_infiniband, function in NMConnection +nm_connection_get_setting_infiniband, function in NMConnection
-nm_connection_get_setting_ip4_config, function in NMConnection +nm_connection_get_setting_ip4_config, function in NMConnection
-nm_connection_get_setting_ip6_config, function in NMConnection +nm_connection_get_setting_ip6_config, function in NMConnection
-nm_connection_get_setting_olpc_mesh, function in NMConnection +nm_connection_get_setting_olpc_mesh, function in NMConnection
-nm_connection_get_setting_ppp, function in NMConnection +nm_connection_get_setting_ppp, function in NMConnection
-nm_connection_get_setting_pppoe, function in NMConnection +nm_connection_get_setting_pppoe, function in NMConnection
-nm_connection_get_setting_serial, function in NMConnection +nm_connection_get_setting_serial, function in NMConnection
-nm_connection_get_setting_team, function in NMConnection +nm_connection_get_setting_team, function in NMConnection
-nm_connection_get_setting_team_port, function in NMConnection +nm_connection_get_setting_team_port, function in NMConnection
-nm_connection_get_setting_vlan, function in NMConnection +nm_connection_get_setting_vlan, function in NMConnection
-nm_connection_get_setting_vpn, function in NMConnection +nm_connection_get_setting_vpn, function in NMConnection
-nm_connection_get_setting_wimax, function in NMConnection +nm_connection_get_setting_wimax, function in NMConnection
-nm_connection_get_setting_wired, function in NMConnection +nm_connection_get_setting_wired, function in NMConnection
-nm_connection_get_setting_wireless, function in NMConnection +nm_connection_get_setting_wireless, function in NMConnection
-nm_connection_get_setting_wireless_security, function in NMConnection +nm_connection_get_setting_wireless_security, function in NMConnection
-nm_connection_get_uuid, function in NMConnection +nm_connection_get_uuid, function in NMConnection
-nm_connection_get_virtual_device_description, function in NMConnection +nm_connection_get_virtual_device_description, function in NMConnection
-nm_connection_get_virtual_iface_name, function in NMConnection +nm_connection_get_virtual_iface_name, function in NMConnection
-nm_connection_is_type, function in NMConnection +nm_connection_is_type, function in NMConnection
-nm_connection_lookup_setting_type, function in NMConnection +nm_connection_lookup_setting_type, function in NMConnection
-nm_connection_lookup_setting_type_by_quark, function in NMConnection +nm_connection_lookup_setting_type_by_quark, function in NMConnection
-nm_connection_need_secrets, function in NMConnection +nm_connection_need_secrets, function in NMConnection
-nm_connection_new, function in NMConnection +nm_connection_new, function in NMConnection
-nm_connection_new_from_hash, function in NMConnection +nm_connection_new_from_hash, function in NMConnection
-nm_connection_normalize, function in NMConnection +nm_connection_normalize, function in NMConnection
@@ -322,15 +313,15 @@
-nm_connection_remove_setting, function in NMConnection +nm_connection_remove_setting, function in NMConnection
-nm_connection_replace_settings, function in NMConnection +nm_connection_replace_settings, function in NMConnection
-nm_connection_replace_settings_from_connection, function in NMConnection +nm_connection_replace_settings_from_connection, function in NMConnection
@@ -342,19 +333,19 @@
-nm_connection_set_path, function in NMConnection +nm_connection_set_path, function in NMConnection
-nm_connection_to_hash, function in NMConnection +nm_connection_to_hash, function in NMConnection
-nm_connection_update_secrets, function in NMConnection +nm_connection_update_secrets, function in NMConnection
-nm_connection_verify, function in NMConnection +nm_connection_verify, function in NMConnection
@@ -640,211 +631,195 @@

I

-NMIP4Address, typedef in NMSettingIP4Config -
-
-
-NMIP4Route, typedef in NMSettingIP4Config -
-
-
-nm_ip4_address_compare, function in NMSettingIP4Config -
-
-
-nm_ip4_address_dup, function in NMSettingIP4Config -
-
-
-nm_ip4_address_get_address, function in NMSettingIP4Config +nm_ip4_address_compare, function in NMSettingIP4Config
-nm_ip4_address_get_gateway, function in NMSettingIP4Config +nm_ip4_address_dup, function in NMSettingIP4Config
-nm_ip4_address_get_prefix, function in NMSettingIP4Config +nm_ip4_address_get_address, function in NMSettingIP4Config
-nm_ip4_address_new, function in NMSettingIP4Config +nm_ip4_address_get_gateway, function in NMSettingIP4Config
-nm_ip4_address_ref, function in NMSettingIP4Config +nm_ip4_address_get_prefix, function in NMSettingIP4Config
-nm_ip4_address_set_address, function in NMSettingIP4Config +nm_ip4_address_new, function in NMSettingIP4Config
-nm_ip4_address_set_gateway, function in NMSettingIP4Config +nm_ip4_address_ref, function in NMSettingIP4Config
-nm_ip4_address_set_prefix, function in NMSettingIP4Config +nm_ip4_address_set_address, function in NMSettingIP4Config
-nm_ip4_address_unref, function in NMSettingIP4Config +nm_ip4_address_set_gateway, function in NMSettingIP4Config
-nm_ip4_route_compare, function in NMSettingIP4Config +nm_ip4_address_set_prefix, function in NMSettingIP4Config
-nm_ip4_route_dup, function in NMSettingIP4Config +nm_ip4_address_unref, function in NMSettingIP4Config
-nm_ip4_route_get_dest, function in NMSettingIP4Config +nm_ip4_route_compare, function in NMSettingIP4Config
-nm_ip4_route_get_metric, function in NMSettingIP4Config +nm_ip4_route_dup, function in NMSettingIP4Config
-nm_ip4_route_get_next_hop, function in NMSettingIP4Config +nm_ip4_route_get_dest, function in NMSettingIP4Config
-nm_ip4_route_get_prefix, function in NMSettingIP4Config +nm_ip4_route_get_metric, function in NMSettingIP4Config
-nm_ip4_route_new, function in NMSettingIP4Config +nm_ip4_route_get_next_hop, function in NMSettingIP4Config
-nm_ip4_route_ref, function in NMSettingIP4Config +nm_ip4_route_get_prefix, function in NMSettingIP4Config
-nm_ip4_route_set_dest, function in NMSettingIP4Config +nm_ip4_route_new, function in NMSettingIP4Config
-nm_ip4_route_set_metric, function in NMSettingIP4Config +nm_ip4_route_ref, function in NMSettingIP4Config
-nm_ip4_route_set_next_hop, function in NMSettingIP4Config +nm_ip4_route_set_dest, function in NMSettingIP4Config
-nm_ip4_route_set_prefix, function in NMSettingIP4Config +nm_ip4_route_set_metric, function in NMSettingIP4Config
-nm_ip4_route_unref, function in NMSettingIP4Config +nm_ip4_route_set_next_hop, function in NMSettingIP4Config
-NMIP6Address, typedef in NMSettingIP6Config +nm_ip4_route_set_prefix, function in NMSettingIP4Config
-NMIP6Route, typedef in NMSettingIP6Config +nm_ip4_route_unref, function in NMSettingIP4Config
-nm_ip6_address_compare, function in NMSettingIP6Config +nm_ip6_address_compare, function in NMSettingIP6Config
-nm_ip6_address_dup, function in NMSettingIP6Config +nm_ip6_address_dup, function in NMSettingIP6Config
-nm_ip6_address_get_address, function in NMSettingIP6Config +nm_ip6_address_get_address, function in NMSettingIP6Config
-nm_ip6_address_get_gateway, function in NMSettingIP6Config +nm_ip6_address_get_gateway, function in NMSettingIP6Config
-nm_ip6_address_get_prefix, function in NMSettingIP6Config +nm_ip6_address_get_prefix, function in NMSettingIP6Config
-nm_ip6_address_new, function in NMSettingIP6Config +nm_ip6_address_new, function in NMSettingIP6Config
-nm_ip6_address_ref, function in NMSettingIP6Config +nm_ip6_address_ref, function in NMSettingIP6Config
-nm_ip6_address_set_address, function in NMSettingIP6Config +nm_ip6_address_set_address, function in NMSettingIP6Config
-nm_ip6_address_set_gateway, function in NMSettingIP6Config +nm_ip6_address_set_gateway, function in NMSettingIP6Config
-nm_ip6_address_set_prefix, function in NMSettingIP6Config +nm_ip6_address_set_prefix, function in NMSettingIP6Config
-nm_ip6_address_unref, function in NMSettingIP6Config +nm_ip6_address_unref, function in NMSettingIP6Config
-nm_ip6_route_compare, function in NMSettingIP6Config +nm_ip6_route_compare, function in NMSettingIP6Config
-nm_ip6_route_dup, function in NMSettingIP6Config +nm_ip6_route_dup, function in NMSettingIP6Config
-nm_ip6_route_get_dest, function in NMSettingIP6Config +nm_ip6_route_get_dest, function in NMSettingIP6Config
-nm_ip6_route_get_metric, function in NMSettingIP6Config +nm_ip6_route_get_metric, function in NMSettingIP6Config
-nm_ip6_route_get_next_hop, function in NMSettingIP6Config +nm_ip6_route_get_next_hop, function in NMSettingIP6Config
-nm_ip6_route_get_prefix, function in NMSettingIP6Config +nm_ip6_route_get_prefix, function in NMSettingIP6Config
-nm_ip6_route_new, function in NMSettingIP6Config +nm_ip6_route_new, function in NMSettingIP6Config
-nm_ip6_route_ref, function in NMSettingIP6Config +nm_ip6_route_ref, function in NMSettingIP6Config
-nm_ip6_route_set_dest, function in NMSettingIP6Config +nm_ip6_route_set_dest, function in NMSettingIP6Config
-nm_ip6_route_set_metric, function in NMSettingIP6Config +nm_ip6_route_set_metric, function in NMSettingIP6Config
-nm_ip6_route_set_next_hop, function in NMSettingIP6Config +nm_ip6_route_set_next_hop, function in NMSettingIP6Config
-nm_ip6_route_set_prefix, function in NMSettingIP6Config +nm_ip6_route_set_prefix, function in NMSettingIP6Config
-nm_ip6_route_unref, function in NMSettingIP6Config +nm_ip6_route_unref, function in NMSettingIP6Config

S

@@ -853,343 +828,283 @@
-NMSetting8021x, struct in NMSetting8021x -
-
-
-NMSetting8021x:altsubject-matches, object property in NMSetting8021x -
-
-
-NMSetting8021x:anonymous-identity, object property in NMSetting8021x -
-
-
-NMSetting8021x:ca-cert, object property in NMSetting8021x -
-
-
-NMSetting8021x:ca-path, object property in NMSetting8021x -
-
-
-NMSetting8021x:client-cert, object property in NMSetting8021x -
-
-
-NMSetting8021x:eap, object property in NMSetting8021x -
-
-
-NMSetting8021x:identity, object property in NMSetting8021x -
-
-
-NMSetting8021x:pac-file, object property in NMSetting8021x -
-
-
-NMSetting8021x:password, object property in NMSetting8021x -
-
-
-NMSetting8021x:password-flags, object property in NMSetting8021x -
-
-
-NMSetting8021x:password-raw, object property in NMSetting8021x -
-
-
-NMSetting8021x:password-raw-flags, object property in NMSetting8021x -
-
-
-NMSetting8021x:phase1-fast-provisioning, object property in NMSetting8021x +NMSetting8021x:altsubject-matches, object property in NMSetting8021x
-NMSetting8021x:phase1-peaplabel, object property in NMSetting8021x +NMSetting8021x:anonymous-identity, object property in NMSetting8021x
-NMSetting8021x:phase1-peapver, object property in NMSetting8021x +NMSetting8021x:ca-cert, object property in NMSetting8021x
-NMSetting8021x:phase2-altsubject-matches, object property in NMSetting8021x +NMSetting8021x:ca-path, object property in NMSetting8021x
-NMSetting8021x:phase2-auth, object property in NMSetting8021x +NMSetting8021x:client-cert, object property in NMSetting8021x
-NMSetting8021x:phase2-autheap, object property in NMSetting8021x +NMSetting8021x:eap, object property in NMSetting8021x
-NMSetting8021x:phase2-ca-cert, object property in NMSetting8021x +NMSetting8021x:identity, object property in NMSetting8021x
-NMSetting8021x:phase2-ca-path, object property in NMSetting8021x +NMSetting8021x:pac-file, object property in NMSetting8021x
-NMSetting8021x:phase2-client-cert, object property in NMSetting8021x +NMSetting8021x:password, object property in NMSetting8021x
-NMSetting8021x:phase2-private-key, object property in NMSetting8021x +NMSetting8021x:password-flags, object property in NMSetting8021x
-NMSetting8021x:phase2-private-key-password, object property in NMSetting8021x +NMSetting8021x:password-raw, object property in NMSetting8021x
-NMSetting8021x:phase2-private-key-password-flags, object property in NMSetting8021x +NMSetting8021x:password-raw-flags, object property in NMSetting8021x
-NMSetting8021x:phase2-subject-match, object property in NMSetting8021x +NMSetting8021x:phase1-fast-provisioning, object property in NMSetting8021x
-NMSetting8021x:pin, object property in NMSetting8021x +NMSetting8021x:phase1-peaplabel, object property in NMSetting8021x
-NMSetting8021x:pin-flags, object property in NMSetting8021x +NMSetting8021x:phase1-peapver, object property in NMSetting8021x
-NMSetting8021x:private-key, object property in NMSetting8021x +NMSetting8021x:phase2-altsubject-matches, object property in NMSetting8021x
-NMSetting8021x:private-key-password, object property in NMSetting8021x +NMSetting8021x:phase2-auth, object property in NMSetting8021x
-NMSetting8021x:private-key-password-flags, object property in NMSetting8021x +NMSetting8021x:phase2-autheap, object property in NMSetting8021x
-NMSetting8021x:subject-match, object property in NMSetting8021x +NMSetting8021x:phase2-ca-cert, object property in NMSetting8021x
-NMSetting8021x:system-ca-certs, object property in NMSetting8021x +NMSetting8021x:phase2-ca-path, object property in NMSetting8021x
-NMSetting8021xCKFormat, enum in NMSetting8021x +NMSetting8021x:phase2-client-cert, object property in NMSetting8021x
-NMSetting8021xCKScheme, enum in NMSetting8021x +NMSetting8021x:phase2-private-key, object property in NMSetting8021x
-NMSetting8021xClass, struct in NMSetting8021x +NMSetting8021x:phase2-private-key-password, object property in NMSetting8021x
-NMSetting8021xError, enum in NMSetting8021x +NMSetting8021x:phase2-private-key-password-flags, object property in NMSetting8021x
-NMSetting:name, object property in NMSetting +NMSetting8021x:phase2-subject-match, object property in NMSetting8021x
-NMSettingAdsl, struct in NMSettingAdsl +NMSetting8021x:pin, object property in NMSetting8021x
-NMSettingAdsl:encapsulation, object property in NMSettingAdsl +NMSetting8021x:pin-flags, object property in NMSetting8021x
-NMSettingAdsl:password, object property in NMSettingAdsl +NMSetting8021x:private-key, object property in NMSetting8021x
-NMSettingAdsl:password-flags, object property in NMSettingAdsl +NMSetting8021x:private-key-password, object property in NMSetting8021x
-NMSettingAdsl:protocol, object property in NMSettingAdsl +NMSetting8021x:private-key-password-flags, object property in NMSetting8021x
-NMSettingAdsl:username, object property in NMSettingAdsl +NMSetting8021x:subject-match, object property in NMSetting8021x
-NMSettingAdsl:vci, object property in NMSettingAdsl +NMSetting8021x:system-ca-certs, object property in NMSetting8021x
-NMSettingAdsl:vpi, object property in NMSettingAdsl +NMSetting8021xCKFormat, enum in NMSetting8021x
-NMSettingAdslClass, struct in NMSettingAdsl +NMSetting8021xCKScheme, enum in NMSetting8021x
-NMSettingAdslError, enum in NMSettingAdsl +NMSetting8021xError, enum in NMSetting8021x
-NMSettingBluetooth, struct in NMSettingBluetooth +NMSetting:name, object property in NMSetting
-NMSettingBluetooth:bdaddr, object property in NMSettingBluetooth +NMSettingAdsl:encapsulation, object property in NMSettingAdsl
-NMSettingBluetooth:type, object property in NMSettingBluetooth +NMSettingAdsl:password, object property in NMSettingAdsl
-NMSettingBluetoothClass, struct in NMSettingBluetooth +NMSettingAdsl:password-flags, object property in NMSettingAdsl
-NMSettingBluetoothError, enum in NMSettingBluetooth +NMSettingAdsl:protocol, object property in NMSettingAdsl
-NMSettingBond, struct in NMSettingBond +NMSettingAdsl:username, object property in NMSettingAdsl
-NMSettingBond:interface-name, object property in NMSettingBond +NMSettingAdsl:vci, object property in NMSettingAdsl
-NMSettingBond:options, object property in NMSettingBond +NMSettingAdsl:vpi, object property in NMSettingAdsl
-NMSettingBondClass, struct in NMSettingBond +NMSettingAdslError, enum in NMSettingAdsl
-NMSettingBondError, enum in NMSettingBond +NMSettingBluetooth:bdaddr, object property in NMSettingBluetooth
-NMSettingBridge, struct in NMSettingBridge +NMSettingBluetooth:type, object property in NMSettingBluetooth
-NMSettingBridge:ageing-time, object property in NMSettingBridge +NMSettingBluetoothError, enum in NMSettingBluetooth
-NMSettingBridge:forward-delay, object property in NMSettingBridge +NMSettingBond:interface-name, object property in NMSettingBond
-NMSettingBridge:hello-time, object property in NMSettingBridge +NMSettingBond:options, object property in NMSettingBond
-NMSettingBridge:interface-name, object property in NMSettingBridge +NMSettingBondError, enum in NMSettingBond
-NMSettingBridge:mac-address, object property in NMSettingBridge +NMSettingBridge:ageing-time, object property in NMSettingBridge
-NMSettingBridge:max-age, object property in NMSettingBridge +NMSettingBridge:forward-delay, object property in NMSettingBridge
-NMSettingBridge:priority, object property in NMSettingBridge +NMSettingBridge:hello-time, object property in NMSettingBridge
-NMSettingBridge:stp, object property in NMSettingBridge +NMSettingBridge:interface-name, object property in NMSettingBridge
-NMSettingBridgeClass, struct in NMSettingBridge +NMSettingBridge:mac-address, object property in NMSettingBridge
-NMSettingBridgeError, enum in NMSettingBridge +NMSettingBridge:max-age, object property in NMSettingBridge
-NMSettingBridgePort, struct in NMSettingBridgePort +NMSettingBridge:priority, object property in NMSettingBridge
-NMSettingBridgePort:hairpin-mode, object property in NMSettingBridgePort +NMSettingBridge:stp, object property in NMSettingBridge
-NMSettingBridgePort:path-cost, object property in NMSettingBridgePort +NMSettingBridgeError, enum in NMSettingBridge
-NMSettingBridgePort:priority, object property in NMSettingBridgePort +NMSettingBridgePort:hairpin-mode, object property in NMSettingBridgePort
-NMSettingBridgePortClass, struct in NMSettingBridgePort +NMSettingBridgePort:path-cost, object property in NMSettingBridgePort
-NMSettingBridgePortError, enum in NMSettingBridgePort +NMSettingBridgePort:priority, object property in NMSettingBridgePort
-NMSettingCdma, struct in NMSettingCdma +NMSettingBridgePortError, enum in NMSettingBridgePort
-NMSettingCdma:number, object property in NMSettingCdma +NMSettingCdma:number, object property in NMSettingCdma
-NMSettingCdma:password, object property in NMSettingCdma +NMSettingCdma:password, object property in NMSettingCdma
-NMSettingCdma:password-flags, object property in NMSettingCdma +NMSettingCdma:password-flags, object property in NMSettingCdma
-NMSettingCdma:username, object property in NMSettingCdma +NMSettingCdma:username, object property in NMSettingCdma
-NMSettingCdmaClass, struct in NMSettingCdma +NMSettingCdmaError, enum in NMSettingCdma
-NMSettingCdmaError, enum in NMSettingCdma +NMSettingClearSecretsWithFlagsFn, user_function in NMSetting
-NMSettingClass, struct in NMSetting -
-
-
-NMSettingClearSecretsWithFlagsFn, user_function in NMSetting -
-
-
-NMSettingCompareFlags, enum in NMSetting +NMSettingCompareFlags, enum in NMSetting
@@ -1197,903 +1112,755 @@
-NMSettingConnection:autoconnect, object property in NMSettingConnection -
-
-
-NMSettingConnection:gateway-ping-timeout, object property in NMSettingConnection -
-
-
-NMSettingConnection:id, object property in NMSettingConnection -
-
-
-NMSettingConnection:interface-name, object property in NMSettingConnection -
-
-
-NMSettingConnection:master, object property in NMSettingConnection -
-
-
-NMSettingConnection:permissions, object property in NMSettingConnection -
-
-
-NMSettingConnection:read-only, object property in NMSettingConnection -
-
-
-NMSettingConnection:secondaries, object property in NMSettingConnection -
-
-
-NMSettingConnection:slave-type, object property in NMSettingConnection -
-
-
-NMSettingConnection:timestamp, object property in NMSettingConnection -
-
-
-NMSettingConnection:type, object property in NMSettingConnection -
-
-
-NMSettingConnection:uuid, object property in NMSettingConnection -
-
-
-NMSettingConnection:zone, object property in NMSettingConnection -
-
-
-NMSettingConnectionClass, struct in NMSettingConnection -
-
-
-NMSettingConnectionError, enum in NMSettingConnection -
-
-
-NMSettingDcb, struct in NMSettingDcb -
-
-
-NMSettingDcb:app-fcoe-flags, object property in NMSettingDcb -
-
-
-NMSettingDcb:app-fcoe-mode, object property in NMSettingDcb -
-
-
-NMSettingDcb:app-fcoe-priority, object property in NMSettingDcb -
-
-
-NMSettingDcb:app-fip-flags, object property in NMSettingDcb -
-
-
-NMSettingDcb:app-fip-priority, object property in NMSettingDcb -
-
-
-NMSettingDcb:app-iscsi-flags, object property in NMSettingDcb -
-
-
-NMSettingDcb:app-iscsi-priority, object property in NMSettingDcb -
-
-
-NMSettingDcb:priority-bandwidth, object property in NMSettingDcb -
-
-
-NMSettingDcb:priority-flow-control, object property in NMSettingDcb -
-
-
-NMSettingDcb:priority-flow-control-flags, object property in NMSettingDcb -
-
-
-NMSettingDcb:priority-group-bandwidth, object property in NMSettingDcb -
-
-
-NMSettingDcb:priority-group-flags, object property in NMSettingDcb -
-
-
-NMSettingDcb:priority-group-id, object property in NMSettingDcb -
-
-
-NMSettingDcb:priority-strict-bandwidth, object property in NMSettingDcb -
-
-
-NMSettingDcb:priority-traffic-class, object property in NMSettingDcb -
-
-
-NMSettingDcbClass, struct in NMSettingDcb -
-
-
-NMSettingDcbError, enum in NMSettingDcb -
-
-
-NMSettingDcbFlags, enum in NMSettingDcb -
-
-
-NMSettingDiffResult, enum in NMSetting -
-
-
-NMSettingError, enum in NMSetting -
-
-
-NMSettingGeneric, struct in NMSettingGeneric -
-
-
-NMSettingGenericClass, struct in NMSettingGeneric +NMSettingConnection:autoconnect, object property in NMSettingConnection
-NMSettingGenericError, enum in NMSettingGeneric +NMSettingConnection:gateway-ping-timeout, object property in NMSettingConnection
-NMSettingGsm, struct in NMSettingGsm +NMSettingConnection:id, object property in NMSettingConnection
-NMSettingGsm:allowed-bands, object property in NMSettingGsm +NMSettingConnection:interface-name, object property in NMSettingConnection
-NMSettingGsm:apn, object property in NMSettingGsm +NMSettingConnection:master, object property in NMSettingConnection
-NMSettingGsm:home-only, object property in NMSettingGsm +NMSettingConnection:permissions, object property in NMSettingConnection
-NMSettingGsm:network-id, object property in NMSettingGsm +NMSettingConnection:read-only, object property in NMSettingConnection
-NMSettingGsm:network-type, object property in NMSettingGsm +NMSettingConnection:secondaries, object property in NMSettingConnection
-NMSettingGsm:number, object property in NMSettingGsm +NMSettingConnection:slave-type, object property in NMSettingConnection
-NMSettingGsm:password, object property in NMSettingGsm +NMSettingConnection:timestamp, object property in NMSettingConnection
-NMSettingGsm:password-flags, object property in NMSettingGsm +NMSettingConnection:type, object property in NMSettingConnection
-NMSettingGsm:pin, object property in NMSettingGsm +NMSettingConnection:uuid, object property in NMSettingConnection
-NMSettingGsm:pin-flags, object property in NMSettingGsm +NMSettingConnection:zone, object property in NMSettingConnection
-NMSettingGsm:username, object property in NMSettingGsm +NMSettingConnectionError, enum in NMSettingConnection
-NMSettingGsmClass, struct in NMSettingGsm +NMSettingDcb:app-fcoe-flags, object property in NMSettingDcb
-NMSettingGsmError, enum in NMSettingGsm +NMSettingDcb:app-fcoe-mode, object property in NMSettingDcb
-NMSettingGsmNetworkBand, enum in NMSettingGsm +NMSettingDcb:app-fcoe-priority, object property in NMSettingDcb
-NMSettingGsmNetworkType, enum in NMSettingGsm +NMSettingDcb:app-fip-flags, object property in NMSettingDcb
-NMSettingHashFlags, enum in NMSetting +NMSettingDcb:app-fip-priority, object property in NMSettingDcb
-NMSettingInfiniband, struct in NMSettingInfiniband +NMSettingDcb:app-iscsi-flags, object property in NMSettingDcb
-NMSettingInfiniband:mac-address, object property in NMSettingInfiniband +NMSettingDcb:app-iscsi-priority, object property in NMSettingDcb
-NMSettingInfiniband:mtu, object property in NMSettingInfiniband +NMSettingDcb:priority-bandwidth, object property in NMSettingDcb
-NMSettingInfiniband:p-key, object property in NMSettingInfiniband +NMSettingDcb:priority-flow-control, object property in NMSettingDcb
-NMSettingInfiniband:parent, object property in NMSettingInfiniband +NMSettingDcb:priority-flow-control-flags, object property in NMSettingDcb
-NMSettingInfiniband:transport-mode, object property in NMSettingInfiniband +NMSettingDcb:priority-group-bandwidth, object property in NMSettingDcb
-NMSettingInfinibandClass, struct in NMSettingInfiniband +NMSettingDcb:priority-group-flags, object property in NMSettingDcb
-NMSettingInfinibandError, enum in NMSettingInfiniband +NMSettingDcb:priority-group-id, object property in NMSettingDcb
-NMSettingIP4Config, struct in NMSettingIP4Config +NMSettingDcb:priority-strict-bandwidth, object property in NMSettingDcb
-NMSettingIP4Config:addresses, object property in NMSettingIP4Config +NMSettingDcb:priority-traffic-class, object property in NMSettingDcb
-NMSettingIP4Config:dhcp-client-id, object property in NMSettingIP4Config +NMSettingDcbError, enum in NMSettingDcb
-NMSettingIP4Config:dhcp-hostname, object property in NMSettingIP4Config +NMSettingDcbFlags, enum in NMSettingDcb
-NMSettingIP4Config:dhcp-send-hostname, object property in NMSettingIP4Config +NMSettingDiffResult, enum in NMSetting
-NMSettingIP4Config:dns, object property in NMSettingIP4Config +NMSettingError, enum in NMSetting
-NMSettingIP4Config:dns-search, object property in NMSettingIP4Config +NMSettingGenericError, enum in NMSettingGeneric
-NMSettingIP4Config:ignore-auto-dns, object property in NMSettingIP4Config +NMSettingGsm:allowed-bands, object property in NMSettingGsm
-NMSettingIP4Config:ignore-auto-routes, object property in NMSettingIP4Config +NMSettingGsm:apn, object property in NMSettingGsm
-NMSettingIP4Config:may-fail, object property in NMSettingIP4Config +NMSettingGsm:home-only, object property in NMSettingGsm
-NMSettingIP4Config:method, object property in NMSettingIP4Config +NMSettingGsm:network-id, object property in NMSettingGsm
-NMSettingIP4Config:never-default, object property in NMSettingIP4Config +NMSettingGsm:network-type, object property in NMSettingGsm
-NMSettingIP4Config:route-metric, object property in NMSettingIP4Config +NMSettingGsm:number, object property in NMSettingGsm
-NMSettingIP4Config:routes, object property in NMSettingIP4Config +NMSettingGsm:password, object property in NMSettingGsm
-NMSettingIP4ConfigClass, struct in NMSettingIP4Config +NMSettingGsm:password-flags, object property in NMSettingGsm
-NMSettingIP4ConfigError, enum in NMSettingIP4Config +NMSettingGsm:pin, object property in NMSettingGsm
-NMSettingIP6Config, struct in NMSettingIP6Config +NMSettingGsm:pin-flags, object property in NMSettingGsm
-NMSettingIP6Config:addresses, object property in NMSettingIP6Config +NMSettingGsm:username, object property in NMSettingGsm
-NMSettingIP6Config:dhcp-hostname, object property in NMSettingIP6Config +NMSettingGsmError, enum in NMSettingGsm
-NMSettingIP6Config:dns, object property in NMSettingIP6Config +NMSettingGsmNetworkBand, enum in NMSettingGsm
-NMSettingIP6Config:dns-search, object property in NMSettingIP6Config +NMSettingGsmNetworkType, enum in NMSettingGsm
-NMSettingIP6Config:ignore-auto-dns, object property in NMSettingIP6Config +NMSettingHashFlags, enum in NMSetting
-NMSettingIP6Config:ignore-auto-routes, object property in NMSettingIP6Config +NMSettingInfiniband:mac-address, object property in NMSettingInfiniband
-NMSettingIP6Config:ip6-privacy, object property in NMSettingIP6Config +NMSettingInfiniband:mtu, object property in NMSettingInfiniband
-NMSettingIP6Config:may-fail, object property in NMSettingIP6Config +NMSettingInfiniband:p-key, object property in NMSettingInfiniband
-NMSettingIP6Config:method, object property in NMSettingIP6Config +NMSettingInfiniband:parent, object property in NMSettingInfiniband
-NMSettingIP6Config:never-default, object property in NMSettingIP6Config +NMSettingInfiniband:transport-mode, object property in NMSettingInfiniband
-NMSettingIP6Config:route-metric, object property in NMSettingIP6Config +NMSettingInfinibandError, enum in NMSettingInfiniband
-NMSettingIP6Config:routes, object property in NMSettingIP6Config +NMSettingIP4Config:addresses, object property in NMSettingIP4Config
-NMSettingIP6ConfigClass, struct in NMSettingIP6Config +NMSettingIP4Config:dhcp-client-id, object property in NMSettingIP4Config
-NMSettingIP6ConfigError, enum in NMSettingIP6Config +NMSettingIP4Config:dhcp-hostname, object property in NMSettingIP4Config
-NMSettingIP6ConfigPrivacy, enum in NMSettingIP6Config +NMSettingIP4Config:dhcp-send-hostname, object property in NMSettingIP4Config
-NMSettingOlpcMesh, struct in NMSettingOlpcMesh +NMSettingIP4Config:dns, object property in NMSettingIP4Config
-NMSettingOlpcMesh:channel, object property in NMSettingOlpcMesh +NMSettingIP4Config:dns-search, object property in NMSettingIP4Config
-NMSettingOlpcMesh:dhcp-anycast-address, object property in NMSettingOlpcMesh +NMSettingIP4Config:ignore-auto-dns, object property in NMSettingIP4Config
-NMSettingOlpcMesh:ssid, object property in NMSettingOlpcMesh +NMSettingIP4Config:ignore-auto-routes, object property in NMSettingIP4Config
-NMSettingOlpcMeshClass, struct in NMSettingOlpcMesh +NMSettingIP4Config:may-fail, object property in NMSettingIP4Config
-NMSettingOlpcMeshError, enum in NMSettingOlpcMesh +NMSettingIP4Config:method, object property in NMSettingIP4Config
-NMSettingPPP, struct in NMSettingPPP +NMSettingIP4Config:never-default, object property in NMSettingIP4Config
-NMSettingPPP:baud, object property in NMSettingPPP +NMSettingIP4Config:route-metric, object property in NMSettingIP4Config
-NMSettingPPP:crtscts, object property in NMSettingPPP +NMSettingIP4Config:routes, object property in NMSettingIP4Config
-NMSettingPPP:lcp-echo-failure, object property in NMSettingPPP +NMSettingIP4ConfigError, enum in NMSettingIP4Config
-NMSettingPPP:lcp-echo-interval, object property in NMSettingPPP +NMSettingIP6Config:addresses, object property in NMSettingIP6Config
-NMSettingPPP:mppe-stateful, object property in NMSettingPPP +NMSettingIP6Config:dhcp-hostname, object property in NMSettingIP6Config
-NMSettingPPP:mru, object property in NMSettingPPP +NMSettingIP6Config:dns, object property in NMSettingIP6Config
-NMSettingPPP:mtu, object property in NMSettingPPP +NMSettingIP6Config:dns-search, object property in NMSettingIP6Config
-NMSettingPPP:no-vj-comp, object property in NMSettingPPP +NMSettingIP6Config:ignore-auto-dns, object property in NMSettingIP6Config
-NMSettingPPP:noauth, object property in NMSettingPPP +NMSettingIP6Config:ignore-auto-routes, object property in NMSettingIP6Config
-NMSettingPPP:nobsdcomp, object property in NMSettingPPP +NMSettingIP6Config:ip6-privacy, object property in NMSettingIP6Config
-NMSettingPPP:nodeflate, object property in NMSettingPPP +NMSettingIP6Config:may-fail, object property in NMSettingIP6Config
-NMSettingPPP:refuse-chap, object property in NMSettingPPP +NMSettingIP6Config:method, object property in NMSettingIP6Config
-NMSettingPPP:refuse-eap, object property in NMSettingPPP +NMSettingIP6Config:never-default, object property in NMSettingIP6Config
-NMSettingPPP:refuse-mschap, object property in NMSettingPPP +NMSettingIP6Config:route-metric, object property in NMSettingIP6Config
-NMSettingPPP:refuse-mschapv2, object property in NMSettingPPP +NMSettingIP6Config:routes, object property in NMSettingIP6Config
-NMSettingPPP:refuse-pap, object property in NMSettingPPP +NMSettingIP6ConfigError, enum in NMSettingIP6Config
-NMSettingPPP:require-mppe, object property in NMSettingPPP +NMSettingIP6ConfigPrivacy, enum in NMSettingIP6Config
-NMSettingPPP:require-mppe-128, object property in NMSettingPPP +NMSettingOlpcMesh:channel, object property in NMSettingOlpcMesh
-NMSettingPPPClass, struct in NMSettingPPP +NMSettingOlpcMesh:dhcp-anycast-address, object property in NMSettingOlpcMesh
-NMSettingPPPError, enum in NMSettingPPP +NMSettingOlpcMesh:ssid, object property in NMSettingOlpcMesh
-NMSettingPPPOE, struct in NMSettingPPPOE +NMSettingOlpcMeshError, enum in NMSettingOlpcMesh
-NMSettingPPPOE:password, object property in NMSettingPPPOE +NMSettingPPP:baud, object property in NMSettingPPP
-NMSettingPPPOE:password-flags, object property in NMSettingPPPOE +NMSettingPPP:crtscts, object property in NMSettingPPP
-NMSettingPPPOE:service, object property in NMSettingPPPOE +NMSettingPPP:lcp-echo-failure, object property in NMSettingPPP
-NMSettingPPPOE:username, object property in NMSettingPPPOE +NMSettingPPP:lcp-echo-interval, object property in NMSettingPPP
-NMSettingPPPOEClass, struct in NMSettingPPPOE +NMSettingPPP:mppe-stateful, object property in NMSettingPPP
-NMSettingPPPOEError, enum in NMSettingPPPOE +NMSettingPPP:mru, object property in NMSettingPPP
-NMSettingSecretFlags, enum in NMSetting +NMSettingPPP:mtu, object property in NMSettingPPP
-NMSettingSerial, struct in NMSettingSerial +NMSettingPPP:no-vj-comp, object property in NMSettingPPP
-NMSettingSerial:baud, object property in NMSettingSerial +NMSettingPPP:noauth, object property in NMSettingPPP
-NMSettingSerial:bits, object property in NMSettingSerial +NMSettingPPP:nobsdcomp, object property in NMSettingPPP
-NMSettingSerial:parity, object property in NMSettingSerial +NMSettingPPP:nodeflate, object property in NMSettingPPP
-NMSettingSerial:send-delay, object property in NMSettingSerial +NMSettingPPP:refuse-chap, object property in NMSettingPPP
-NMSettingSerial:stopbits, object property in NMSettingSerial +NMSettingPPP:refuse-eap, object property in NMSettingPPP
-NMSettingSerialClass, struct in NMSettingSerial +NMSettingPPP:refuse-mschap, object property in NMSettingPPP
-NMSettingSerialError, enum in NMSettingSerial +NMSettingPPP:refuse-mschapv2, object property in NMSettingPPP
-NMSettingTeam, struct in NMSettingTeam +NMSettingPPP:refuse-pap, object property in NMSettingPPP
-NMSettingTeam:config, object property in NMSettingTeam +NMSettingPPP:require-mppe, object property in NMSettingPPP
-NMSettingTeam:interface-name, object property in NMSettingTeam +NMSettingPPP:require-mppe-128, object property in NMSettingPPP
-NMSettingTeamClass, struct in NMSettingTeam +NMSettingPPPError, enum in NMSettingPPP
-NMSettingTeamError, enum in NMSettingTeam +NMSettingPPPOE:password, object property in NMSettingPPPOE
-NMSettingTeamPort, struct in NMSettingTeamPort +NMSettingPPPOE:password-flags, object property in NMSettingPPPOE
-NMSettingTeamPort:config, object property in NMSettingTeamPort +NMSettingPPPOE:service, object property in NMSettingPPPOE
-NMSettingTeamPortClass, struct in NMSettingTeamPort +NMSettingPPPOE:username, object property in NMSettingPPPOE
-NMSettingTeamPortError, enum in NMSettingTeamPort +NMSettingPPPOEError, enum in NMSettingPPPOE
-NMSettingValueIterFn, user_function in NMSetting +NMSettingSecretFlags, enum in NMSetting
-NMSettingVlan, struct in NMSettingVlan +NMSettingSerial:baud, object property in NMSettingSerial
-NMSettingVlan:egress-priority-map, object property in NMSettingVlan +NMSettingSerial:bits, object property in NMSettingSerial
-NMSettingVlan:flags, object property in NMSettingVlan +NMSettingSerial:parity, object property in NMSettingSerial
-NMSettingVlan:id, object property in NMSettingVlan +NMSettingSerial:send-delay, object property in NMSettingSerial
-NMSettingVlan:ingress-priority-map, object property in NMSettingVlan +NMSettingSerial:stopbits, object property in NMSettingSerial
-NMSettingVlan:interface-name, object property in NMSettingVlan +NMSettingSerialError, enum in NMSettingSerial
-NMSettingVlan:parent, object property in NMSettingVlan +NMSettingTeam:config, object property in NMSettingTeam
-NMSettingVlanClass, struct in NMSettingVlan +NMSettingTeam:interface-name, object property in NMSettingTeam
-NMSettingVlanError, enum in NMSettingVlan +NMSettingTeamError, enum in NMSettingTeam
-NMSettingVPN, struct in NMSettingVPN +NMSettingTeamPort:config, object property in NMSettingTeamPort
-NMSettingVPN:data, object property in NMSettingVPN +NMSettingTeamPortError, enum in NMSettingTeamPort
-NMSettingVPN:persistent, object property in NMSettingVPN +NMSettingValueIterFn, user_function in NMSetting
-NMSettingVPN:secrets, object property in NMSettingVPN +NMSettingVlan:egress-priority-map, object property in NMSettingVlan
-NMSettingVPN:service-type, object property in NMSettingVPN +NMSettingVlan:flags, object property in NMSettingVlan
-NMSettingVPN:user-name, object property in NMSettingVPN +NMSettingVlan:id, object property in NMSettingVlan
-NMSettingVPNClass, struct in NMSettingVPN +NMSettingVlan:ingress-priority-map, object property in NMSettingVlan
-NMSettingVpnError, enum in NMSettingVPN +NMSettingVlan:interface-name, object property in NMSettingVlan
-NMSettingWimax, struct in NMSettingWimax +NMSettingVlan:parent, object property in NMSettingVlan
-NMSettingWimax:mac-address, object property in NMSettingWimax +NMSettingVlanError, enum in NMSettingVlan
-NMSettingWimax:network-name, object property in NMSettingWimax +NMSettingVPN:data, object property in NMSettingVPN
-NMSettingWimaxClass, struct in NMSettingWimax +NMSettingVPN:persistent, object property in NMSettingVPN
-NMSettingWimaxError, enum in NMSettingWimax +NMSettingVPN:secrets, object property in NMSettingVPN
-NMSettingWired, struct in NMSettingWired +NMSettingVPN:service-type, object property in NMSettingVPN
-NMSettingWired:auto-negotiate, object property in NMSettingWired +NMSettingVPN:user-name, object property in NMSettingVPN
-NMSettingWired:cloned-mac-address, object property in NMSettingWired +NMSettingVpnError, enum in NMSettingVPN
-NMSettingWired:duplex, object property in NMSettingWired +NMSettingWimax:mac-address, object property in NMSettingWimax
-NMSettingWired:mac-address, object property in NMSettingWired +NMSettingWimax:network-name, object property in NMSettingWimax
-NMSettingWired:mac-address-blacklist, object property in NMSettingWired +NMSettingWimaxError, enum in NMSettingWimax
-NMSettingWired:mtu, object property in NMSettingWired +NMSettingWired:auto-negotiate, object property in NMSettingWired
-NMSettingWired:port, object property in NMSettingWired +NMSettingWired:cloned-mac-address, object property in NMSettingWired
-NMSettingWired:s390-nettype, object property in NMSettingWired +NMSettingWired:duplex, object property in NMSettingWired
-NMSettingWired:s390-options, object property in NMSettingWired +NMSettingWired:mac-address, object property in NMSettingWired
-NMSettingWired:s390-subchannels, object property in NMSettingWired +NMSettingWired:mac-address-blacklist, object property in NMSettingWired
-NMSettingWired:speed, object property in NMSettingWired +NMSettingWired:mtu, object property in NMSettingWired
-NMSettingWiredClass, struct in NMSettingWired +NMSettingWired:port, object property in NMSettingWired
-NMSettingWiredError, enum in NMSettingWired +NMSettingWired:s390-nettype, object property in NMSettingWired
-NMSettingWireless, struct in NMSettingWireless +NMSettingWired:s390-options, object property in NMSettingWired
-NMSettingWireless:band, object property in NMSettingWireless +NMSettingWired:s390-subchannels, object property in NMSettingWired
-NMSettingWireless:bssid, object property in NMSettingWireless +NMSettingWired:speed, object property in NMSettingWired
-NMSettingWireless:channel, object property in NMSettingWireless +NMSettingWiredError, enum in NMSettingWired
-NMSettingWireless:cloned-mac-address, object property in NMSettingWireless +NMSettingWireless:band, object property in NMSettingWireless
-NMSettingWireless:hidden, object property in NMSettingWireless +NMSettingWireless:bssid, object property in NMSettingWireless
-NMSettingWireless:mac-address, object property in NMSettingWireless +NMSettingWireless:channel, object property in NMSettingWireless
-NMSettingWireless:mac-address-blacklist, object property in NMSettingWireless +NMSettingWireless:cloned-mac-address, object property in NMSettingWireless
-NMSettingWireless:mode, object property in NMSettingWireless +NMSettingWireless:hidden, object property in NMSettingWireless
-NMSettingWireless:mtu, object property in NMSettingWireless +NMSettingWireless:mac-address, object property in NMSettingWireless
-NMSettingWireless:rate, object property in NMSettingWireless +NMSettingWireless:mac-address-blacklist, object property in NMSettingWireless
-NMSettingWireless:security, object property in NMSettingWireless +NMSettingWireless:mode, object property in NMSettingWireless
-NMSettingWireless:seen-bssids, object property in NMSettingWireless +NMSettingWireless:mtu, object property in NMSettingWireless
-NMSettingWireless:ssid, object property in NMSettingWireless +NMSettingWireless:rate, object property in NMSettingWireless
-NMSettingWireless:tx-power, object property in NMSettingWireless +NMSettingWireless:security, object property in NMSettingWireless
-NMSettingWirelessClass, struct in NMSettingWireless +NMSettingWireless:seen-bssids, object property in NMSettingWireless
-NMSettingWirelessError, enum in NMSettingWireless +NMSettingWireless:ssid, object property in NMSettingWireless
-NMSettingWirelessSecurity, struct in NMSettingWirelessSecurity +NMSettingWireless:tx-power, object property in NMSettingWireless
-NMSettingWirelessSecurity:auth-alg, object property in NMSettingWirelessSecurity +NMSettingWirelessError, enum in NMSettingWireless
-NMSettingWirelessSecurity:group, object property in NMSettingWirelessSecurity +NMSettingWirelessSecurity:auth-alg, object property in NMSettingWirelessSecurity
-NMSettingWirelessSecurity:key-mgmt, object property in NMSettingWirelessSecurity +NMSettingWirelessSecurity:group, object property in NMSettingWirelessSecurity
-NMSettingWirelessSecurity:leap-password, object property in NMSettingWirelessSecurity +NMSettingWirelessSecurity:key-mgmt, object property in NMSettingWirelessSecurity
-NMSettingWirelessSecurity:leap-password-flags, object property in NMSettingWirelessSecurity +NMSettingWirelessSecurity:leap-password, object property in NMSettingWirelessSecurity
-NMSettingWirelessSecurity:leap-username, object property in NMSettingWirelessSecurity +NMSettingWirelessSecurity:leap-password-flags, object property in NMSettingWirelessSecurity
-NMSettingWirelessSecurity:pairwise, object property in NMSettingWirelessSecurity +NMSettingWirelessSecurity:leap-username, object property in NMSettingWirelessSecurity
-NMSettingWirelessSecurity:proto, object property in NMSettingWirelessSecurity +NMSettingWirelessSecurity:pairwise, object property in NMSettingWirelessSecurity
-NMSettingWirelessSecurity:psk, object property in NMSettingWirelessSecurity +NMSettingWirelessSecurity:proto, object property in NMSettingWirelessSecurity
-NMSettingWirelessSecurity:psk-flags, object property in NMSettingWirelessSecurity +NMSettingWirelessSecurity:psk, object property in NMSettingWirelessSecurity
-NMSettingWirelessSecurity:wep-key-flags, object property in NMSettingWirelessSecurity +NMSettingWirelessSecurity:psk-flags, object property in NMSettingWirelessSecurity
-NMSettingWirelessSecurity:wep-key-type, object property in NMSettingWirelessSecurity +NMSettingWirelessSecurity:wep-key-flags, object property in NMSettingWirelessSecurity
-NMSettingWirelessSecurity:wep-key0, object property in NMSettingWirelessSecurity +NMSettingWirelessSecurity:wep-key-type, object property in NMSettingWirelessSecurity
-NMSettingWirelessSecurity:wep-key1, object property in NMSettingWirelessSecurity +NMSettingWirelessSecurity:wep-key0, object property in NMSettingWirelessSecurity
-NMSettingWirelessSecurity:wep-key2, object property in NMSettingWirelessSecurity +NMSettingWirelessSecurity:wep-key1, object property in NMSettingWirelessSecurity
-NMSettingWirelessSecurity:wep-key3, object property in NMSettingWirelessSecurity +NMSettingWirelessSecurity:wep-key2, object property in NMSettingWirelessSecurity
-NMSettingWirelessSecurity:wep-tx-keyidx, object property in NMSettingWirelessSecurity +NMSettingWirelessSecurity:wep-key3, object property in NMSettingWirelessSecurity
-NMSettingWirelessSecurityClass, struct in NMSettingWirelessSecurity +NMSettingWirelessSecurity:wep-tx-keyidx, object property in NMSettingWirelessSecurity
-NMSettingWirelessSecurityError, enum in NMSettingWirelessSecurity +NMSettingWirelessSecurityError, enum in NMSettingWirelessSecurity
-nm_setting_802_1x_add_altsubject_match, function in NMSetting8021x +nm_setting_802_1x_add_altsubject_match, function in NMSetting8021x
-nm_setting_802_1x_add_eap_method, function in NMSetting8021x +nm_setting_802_1x_add_eap_method, function in NMSetting8021x
-nm_setting_802_1x_add_phase2_altsubject_match, function in NMSetting8021x +nm_setting_802_1x_add_phase2_altsubject_match, function in NMSetting8021x
@@ -2113,15 +1880,15 @@
-nm_setting_802_1x_clear_altsubject_matches, function in NMSetting8021x +nm_setting_802_1x_clear_altsubject_matches, function in NMSetting8021x
-nm_setting_802_1x_clear_eap_methods, function in NMSetting8021x +nm_setting_802_1x_clear_eap_methods, function in NMSetting8021x
-nm_setting_802_1x_clear_phase2_altsubject_matches, function in NMSetting8021x +nm_setting_802_1x_clear_phase2_altsubject_matches, function in NMSetting8021x
@@ -2137,203 +1904,203 @@
-nm_setting_802_1x_error_quark, function in NMSetting8021x +nm_setting_802_1x_error_quark, function in NMSetting8021x
-nm_setting_802_1x_get_altsubject_match, function in NMSetting8021x +nm_setting_802_1x_get_altsubject_match, function in NMSetting8021x
-nm_setting_802_1x_get_anonymous_identity, function in NMSetting8021x +nm_setting_802_1x_get_anonymous_identity, function in NMSetting8021x
-nm_setting_802_1x_get_ca_cert_blob, function in NMSetting8021x +nm_setting_802_1x_get_ca_cert_blob, function in NMSetting8021x
-nm_setting_802_1x_get_ca_cert_path, function in NMSetting8021x +nm_setting_802_1x_get_ca_cert_path, function in NMSetting8021x
-nm_setting_802_1x_get_ca_cert_scheme, function in NMSetting8021x +nm_setting_802_1x_get_ca_cert_scheme, function in NMSetting8021x
-nm_setting_802_1x_get_ca_path, function in NMSetting8021x +nm_setting_802_1x_get_ca_path, function in NMSetting8021x
-nm_setting_802_1x_get_client_cert_blob, function in NMSetting8021x +nm_setting_802_1x_get_client_cert_blob, function in NMSetting8021x
-nm_setting_802_1x_get_client_cert_path, function in NMSetting8021x +nm_setting_802_1x_get_client_cert_path, function in NMSetting8021x
-nm_setting_802_1x_get_client_cert_scheme, function in NMSetting8021x +nm_setting_802_1x_get_client_cert_scheme, function in NMSetting8021x
-nm_setting_802_1x_get_eap_method, function in NMSetting8021x +nm_setting_802_1x_get_eap_method, function in NMSetting8021x
-nm_setting_802_1x_get_identity, function in NMSetting8021x +nm_setting_802_1x_get_identity, function in NMSetting8021x
-nm_setting_802_1x_get_num_altsubject_matches, function in NMSetting8021x +nm_setting_802_1x_get_num_altsubject_matches, function in NMSetting8021x
-nm_setting_802_1x_get_num_eap_methods, function in NMSetting8021x +nm_setting_802_1x_get_num_eap_methods, function in NMSetting8021x
-nm_setting_802_1x_get_num_phase2_altsubject_matches, function in NMSetting8021x +nm_setting_802_1x_get_num_phase2_altsubject_matches, function in NMSetting8021x
-nm_setting_802_1x_get_pac_file, function in NMSetting8021x +nm_setting_802_1x_get_pac_file, function in NMSetting8021x
-nm_setting_802_1x_get_password, function in NMSetting8021x +nm_setting_802_1x_get_password, function in NMSetting8021x
-nm_setting_802_1x_get_password_flags, function in NMSetting8021x +nm_setting_802_1x_get_password_flags, function in NMSetting8021x
-nm_setting_802_1x_get_password_raw, function in NMSetting8021x +nm_setting_802_1x_get_password_raw, function in NMSetting8021x
-nm_setting_802_1x_get_password_raw_flags, function in NMSetting8021x +nm_setting_802_1x_get_password_raw_flags, function in NMSetting8021x
-nm_setting_802_1x_get_phase1_fast_provisioning, function in NMSetting8021x +nm_setting_802_1x_get_phase1_fast_provisioning, function in NMSetting8021x
-nm_setting_802_1x_get_phase1_peaplabel, function in NMSetting8021x +nm_setting_802_1x_get_phase1_peaplabel, function in NMSetting8021x
-nm_setting_802_1x_get_phase1_peapver, function in NMSetting8021x +nm_setting_802_1x_get_phase1_peapver, function in NMSetting8021x
-nm_setting_802_1x_get_phase2_altsubject_match, function in NMSetting8021x +nm_setting_802_1x_get_phase2_altsubject_match, function in NMSetting8021x
-nm_setting_802_1x_get_phase2_auth, function in NMSetting8021x +nm_setting_802_1x_get_phase2_auth, function in NMSetting8021x
-nm_setting_802_1x_get_phase2_autheap, function in NMSetting8021x +nm_setting_802_1x_get_phase2_autheap, function in NMSetting8021x
-nm_setting_802_1x_get_phase2_ca_cert_blob, function in NMSetting8021x +nm_setting_802_1x_get_phase2_ca_cert_blob, function in NMSetting8021x
-nm_setting_802_1x_get_phase2_ca_cert_path, function in NMSetting8021x +nm_setting_802_1x_get_phase2_ca_cert_path, function in NMSetting8021x
-nm_setting_802_1x_get_phase2_ca_cert_scheme, function in NMSetting8021x +nm_setting_802_1x_get_phase2_ca_cert_scheme, function in NMSetting8021x
-nm_setting_802_1x_get_phase2_ca_path, function in NMSetting8021x +nm_setting_802_1x_get_phase2_ca_path, function in NMSetting8021x
-nm_setting_802_1x_get_phase2_client_cert_blob, function in NMSetting8021x +nm_setting_802_1x_get_phase2_client_cert_blob, function in NMSetting8021x
-nm_setting_802_1x_get_phase2_client_cert_path, function in NMSetting8021x +nm_setting_802_1x_get_phase2_client_cert_path, function in NMSetting8021x
-nm_setting_802_1x_get_phase2_client_cert_scheme, function in NMSetting8021x +nm_setting_802_1x_get_phase2_client_cert_scheme, function in NMSetting8021x
-nm_setting_802_1x_get_phase2_private_key_blob, function in NMSetting8021x +nm_setting_802_1x_get_phase2_private_key_blob, function in NMSetting8021x
-nm_setting_802_1x_get_phase2_private_key_format, function in NMSetting8021x +nm_setting_802_1x_get_phase2_private_key_format, function in NMSetting8021x
-nm_setting_802_1x_get_phase2_private_key_password, function in NMSetting8021x +nm_setting_802_1x_get_phase2_private_key_password, function in NMSetting8021x
-nm_setting_802_1x_get_phase2_private_key_password_flags, function in NMSetting8021x +nm_setting_802_1x_get_phase2_private_key_password_flags, function in NMSetting8021x
-nm_setting_802_1x_get_phase2_private_key_path, function in NMSetting8021x +nm_setting_802_1x_get_phase2_private_key_path, function in NMSetting8021x
-nm_setting_802_1x_get_phase2_private_key_scheme, function in NMSetting8021x +nm_setting_802_1x_get_phase2_private_key_scheme, function in NMSetting8021x
-nm_setting_802_1x_get_phase2_subject_match, function in NMSetting8021x +nm_setting_802_1x_get_phase2_subject_match, function in NMSetting8021x
-nm_setting_802_1x_get_pin, function in NMSetting8021x +nm_setting_802_1x_get_pin, function in NMSetting8021x
-nm_setting_802_1x_get_pin_flags, function in NMSetting8021x +nm_setting_802_1x_get_pin_flags, function in NMSetting8021x
-nm_setting_802_1x_get_private_key_blob, function in NMSetting8021x +nm_setting_802_1x_get_private_key_blob, function in NMSetting8021x
-nm_setting_802_1x_get_private_key_format, function in NMSetting8021x +nm_setting_802_1x_get_private_key_format, function in NMSetting8021x
-nm_setting_802_1x_get_private_key_password, function in NMSetting8021x +nm_setting_802_1x_get_private_key_password, function in NMSetting8021x
-nm_setting_802_1x_get_private_key_password_flags, function in NMSetting8021x +nm_setting_802_1x_get_private_key_password_flags, function in NMSetting8021x
-nm_setting_802_1x_get_private_key_path, function in NMSetting8021x +nm_setting_802_1x_get_private_key_path, function in NMSetting8021x
-nm_setting_802_1x_get_private_key_scheme, function in NMSetting8021x +nm_setting_802_1x_get_private_key_scheme, function in NMSetting8021x
-nm_setting_802_1x_get_subject_match, function in NMSetting8021x +nm_setting_802_1x_get_subject_match, function in NMSetting8021x
-nm_setting_802_1x_get_system_ca_certs, function in NMSetting8021x +nm_setting_802_1x_get_system_ca_certs, function in NMSetting8021x
@@ -2341,7 +2108,7 @@
-nm_setting_802_1x_new, function in NMSetting8021x +nm_setting_802_1x_new, function in NMSetting8021x
@@ -2437,27 +2204,27 @@
-nm_setting_802_1x_remove_altsubject_match, function in NMSetting8021x +nm_setting_802_1x_remove_altsubject_match, function in NMSetting8021x
-nm_setting_802_1x_remove_altsubject_match_by_value, function in NMSetting8021x +nm_setting_802_1x_remove_altsubject_match_by_value, function in NMSetting8021x
-nm_setting_802_1x_remove_eap_method, function in NMSetting8021x +nm_setting_802_1x_remove_eap_method, function in NMSetting8021x
-nm_setting_802_1x_remove_eap_method_by_value, function in NMSetting8021x +nm_setting_802_1x_remove_eap_method_by_value, function in NMSetting8021x
-nm_setting_802_1x_remove_phase2_altsubject_match, function in NMSetting8021x +nm_setting_802_1x_remove_phase2_altsubject_match, function in NMSetting8021x
-nm_setting_802_1x_remove_phase2_altsubject_match_by_value, function in NMSetting8021x +nm_setting_802_1x_remove_phase2_altsubject_match_by_value, function in NMSetting8021x
@@ -2465,27 +2232,27 @@
-nm_setting_802_1x_set_ca_cert, function in NMSetting8021x +nm_setting_802_1x_set_ca_cert, function in NMSetting8021x
-nm_setting_802_1x_set_client_cert, function in NMSetting8021x +nm_setting_802_1x_set_client_cert, function in NMSetting8021x
-nm_setting_802_1x_set_phase2_ca_cert, function in NMSetting8021x +nm_setting_802_1x_set_phase2_ca_cert, function in NMSetting8021x
-nm_setting_802_1x_set_phase2_client_cert, function in NMSetting8021x +nm_setting_802_1x_set_phase2_client_cert, function in NMSetting8021x
-nm_setting_802_1x_set_phase2_private_key, function in NMSetting8021x +nm_setting_802_1x_set_phase2_private_key, function in NMSetting8021x
-nm_setting_802_1x_set_private_key, function in NMSetting8021x +nm_setting_802_1x_set_private_key, function in NMSetting8021x
@@ -2513,39 +2280,39 @@
-nm_setting_adsl_error_quark, function in NMSettingAdsl +nm_setting_adsl_error_quark, function in NMSettingAdsl
-nm_setting_adsl_get_encapsulation, function in NMSettingAdsl +nm_setting_adsl_get_encapsulation, function in NMSettingAdsl
-nm_setting_adsl_get_password, function in NMSettingAdsl +nm_setting_adsl_get_password, function in NMSettingAdsl
-nm_setting_adsl_get_password_flags, function in NMSettingAdsl +nm_setting_adsl_get_password_flags, function in NMSettingAdsl
-nm_setting_adsl_get_protocol, function in NMSettingAdsl +nm_setting_adsl_get_protocol, function in NMSettingAdsl
-nm_setting_adsl_get_username, function in NMSettingAdsl +nm_setting_adsl_get_username, function in NMSettingAdsl
-nm_setting_adsl_get_vci, function in NMSettingAdsl +nm_setting_adsl_get_vci, function in NMSettingAdsl
-nm_setting_adsl_get_vpi, function in NMSettingAdsl +nm_setting_adsl_get_vpi, function in NMSettingAdsl
-nm_setting_adsl_new, function in NMSettingAdsl +nm_setting_adsl_new, function in NMSettingAdsl
@@ -2597,19 +2364,19 @@
-nm_setting_bluetooth_error_quark, function in NMSettingBluetooth +nm_setting_bluetooth_error_quark, function in NMSettingBluetooth
-nm_setting_bluetooth_get_bdaddr, function in NMSettingBluetooth +nm_setting_bluetooth_get_bdaddr, function in NMSettingBluetooth
-nm_setting_bluetooth_get_connection_type, function in NMSettingBluetooth +nm_setting_bluetooth_get_connection_type, function in NMSettingBluetooth
-nm_setting_bluetooth_new, function in NMSettingBluetooth +nm_setting_bluetooth_new, function in NMSettingBluetooth
@@ -2629,7 +2396,7 @@
-nm_setting_bond_add_option, function in NMSettingBond +nm_setting_bond_add_option, function in NMSettingBond
@@ -2637,31 +2404,31 @@
-nm_setting_bond_error_quark, function in NMSettingBond +nm_setting_bond_error_quark, function in NMSettingBond
-nm_setting_bond_get_interface_name, function in NMSettingBond +nm_setting_bond_get_interface_name, function in NMSettingBond
-nm_setting_bond_get_num_options, function in NMSettingBond +nm_setting_bond_get_num_options, function in NMSettingBond
-nm_setting_bond_get_option, function in NMSettingBond +nm_setting_bond_get_option, function in NMSettingBond
-nm_setting_bond_get_option_by_name, function in NMSettingBond +nm_setting_bond_get_option_by_name, function in NMSettingBond
-nm_setting_bond_get_option_default, function in NMSettingBond +nm_setting_bond_get_option_default, function in NMSettingBond
-nm_setting_bond_get_valid_options, function in NMSettingBond +nm_setting_bond_get_valid_options, function in NMSettingBond
@@ -2669,7 +2436,7 @@
-nm_setting_bond_new, function in NMSettingBond +nm_setting_bond_new, function in NMSettingBond
@@ -2737,7 +2504,7 @@
-nm_setting_bond_remove_option, function in NMSettingBond +nm_setting_bond_remove_option, function in NMSettingBond
@@ -2745,7 +2512,7 @@
-nm_setting_bond_validate_option, function in NMSettingBond +nm_setting_bond_validate_option, function in NMSettingBond
@@ -2757,7 +2524,7 @@
-nm_setting_bridge_error_quark, function in NMSettingBridge +nm_setting_bridge_error_quark, function in NMSettingBridge
@@ -2765,35 +2532,35 @@
-nm_setting_bridge_get_ageing_time, function in NMSettingBridge +nm_setting_bridge_get_ageing_time, function in NMSettingBridge
-nm_setting_bridge_get_forward_delay, function in NMSettingBridge +nm_setting_bridge_get_forward_delay, function in NMSettingBridge
-nm_setting_bridge_get_hello_time, function in NMSettingBridge +nm_setting_bridge_get_hello_time, function in NMSettingBridge
-nm_setting_bridge_get_interface_name, function in NMSettingBridge +nm_setting_bridge_get_interface_name, function in NMSettingBridge
-nm_setting_bridge_get_mac_address, function in NMSettingBridge +nm_setting_bridge_get_mac_address, function in NMSettingBridge
-nm_setting_bridge_get_max_age, function in NMSettingBridge +nm_setting_bridge_get_max_age, function in NMSettingBridge
-nm_setting_bridge_get_priority, function in NMSettingBridge +nm_setting_bridge_get_priority, function in NMSettingBridge
-nm_setting_bridge_get_stp, function in NMSettingBridge +nm_setting_bridge_get_stp, function in NMSettingBridge
@@ -2813,7 +2580,7 @@
-nm_setting_bridge_new, function in NMSettingBridge +nm_setting_bridge_new, function in NMSettingBridge
@@ -2821,19 +2588,19 @@
-nm_setting_bridge_port_error_quark, function in NMSettingBridgePort +nm_setting_bridge_port_error_quark, function in NMSettingBridgePort
-nm_setting_bridge_port_get_hairpin_mode, function in NMSettingBridgePort +nm_setting_bridge_port_get_hairpin_mode, function in NMSettingBridgePort
-nm_setting_bridge_port_get_path_cost, function in NMSettingBridgePort +nm_setting_bridge_port_get_path_cost, function in NMSettingBridgePort
-nm_setting_bridge_port_get_priority, function in NMSettingBridgePort +nm_setting_bridge_port_get_priority, function in NMSettingBridgePort
@@ -2841,7 +2608,7 @@
-nm_setting_bridge_port_new, function in NMSettingBridgePort +nm_setting_bridge_port_new, function in NMSettingBridgePort
@@ -2873,27 +2640,27 @@
-nm_setting_cdma_error_quark, function in NMSettingCdma +nm_setting_cdma_error_quark, function in NMSettingCdma
-nm_setting_cdma_get_number, function in NMSettingCdma +nm_setting_cdma_get_number, function in NMSettingCdma
-nm_setting_cdma_get_password, function in NMSettingCdma +nm_setting_cdma_get_password, function in NMSettingCdma
-nm_setting_cdma_get_password_flags, function in NMSettingCdma +nm_setting_cdma_get_password_flags, function in NMSettingCdma
-nm_setting_cdma_get_username, function in NMSettingCdma +nm_setting_cdma_get_username, function in NMSettingCdma
-nm_setting_cdma_new, function in NMSettingCdma +nm_setting_cdma_new, function in NMSettingCdma
@@ -2917,23 +2684,23 @@
-nm_setting_clear_secrets, function in NMSetting +nm_setting_clear_secrets, function in NMSetting
-nm_setting_clear_secrets_with_flags, function in NMSetting +nm_setting_clear_secrets_with_flags, function in NMSetting
-nm_setting_compare, function in NMSetting +nm_setting_compare, function in NMSetting
-nm_setting_connection_add_permission, function in NMSettingConnection +nm_setting_connection_add_permission, function in NMSettingConnection
-nm_setting_connection_add_secondary, function in NMSettingConnection +nm_setting_connection_add_secondary, function in NMSettingConnection
@@ -2945,7 +2712,7 @@
-nm_setting_connection_error_quark, function in NMSettingConnection +nm_setting_connection_error_quark, function in NMSettingConnection
@@ -2953,63 +2720,63 @@
-nm_setting_connection_get_autoconnect, function in NMSettingConnection +nm_setting_connection_get_autoconnect, function in NMSettingConnection
-nm_setting_connection_get_connection_type, function in NMSettingConnection +nm_setting_connection_get_connection_type, function in NMSettingConnection
-nm_setting_connection_get_gateway_ping_timeout, function in NMSettingConnection +nm_setting_connection_get_gateway_ping_timeout, function in NMSettingConnection
-nm_setting_connection_get_id, function in NMSettingConnection +nm_setting_connection_get_id, function in NMSettingConnection
-nm_setting_connection_get_interface_name, function in NMSettingConnection +nm_setting_connection_get_interface_name, function in NMSettingConnection
-nm_setting_connection_get_master, function in NMSettingConnection +nm_setting_connection_get_master, function in NMSettingConnection
-nm_setting_connection_get_num_permissions, function in NMSettingConnection +nm_setting_connection_get_num_permissions, function in NMSettingConnection
-nm_setting_connection_get_num_secondaries, function in NMSettingConnection +nm_setting_connection_get_num_secondaries, function in NMSettingConnection
-nm_setting_connection_get_permission, function in NMSettingConnection +nm_setting_connection_get_permission, function in NMSettingConnection
-nm_setting_connection_get_read_only, function in NMSettingConnection +nm_setting_connection_get_read_only, function in NMSettingConnection
-nm_setting_connection_get_secondary, function in NMSettingConnection +nm_setting_connection_get_secondary, function in NMSettingConnection
-nm_setting_connection_get_slave_type, function in NMSettingConnection +nm_setting_connection_get_slave_type, function in NMSettingConnection
-nm_setting_connection_get_timestamp, function in NMSettingConnection +nm_setting_connection_get_timestamp, function in NMSettingConnection
-nm_setting_connection_get_uuid, function in NMSettingConnection +nm_setting_connection_get_uuid, function in NMSettingConnection
-nm_setting_connection_get_zone, function in NMSettingConnection +nm_setting_connection_get_zone, function in NMSettingConnection
@@ -3021,7 +2788,7 @@
-nm_setting_connection_is_slave_type, function in NMSettingConnection +nm_setting_connection_is_slave_type, function in NMSettingConnection
@@ -3029,7 +2796,7 @@
-nm_setting_connection_new, function in NMSettingConnection +nm_setting_connection_new, function in NMSettingConnection
@@ -3037,7 +2804,7 @@
-nm_setting_connection_permissions_user_allowed, function in NMSettingConnection +nm_setting_connection_permissions_user_allowed, function in NMSettingConnection
@@ -3045,19 +2812,19 @@
-nm_setting_connection_remove_permission, function in NMSettingConnection +nm_setting_connection_remove_permission, function in NMSettingConnection
-nm_setting_connection_remove_permission_by_value, function in NMSettingConnection +nm_setting_connection_remove_permission_by_value, function in NMSettingConnection
-nm_setting_connection_remove_secondary, function in NMSettingConnection +nm_setting_connection_remove_secondary, function in NMSettingConnection
-nm_setting_connection_remove_secondary_by_value, function in NMSettingConnection +nm_setting_connection_remove_secondary_by_value, function in NMSettingConnection
@@ -3121,7 +2888,7 @@
-nm_setting_dcb_error_quark, function in NMSettingDcb +nm_setting_dcb_error_quark, function in NMSettingDcb
@@ -3133,67 +2900,67 @@
-nm_setting_dcb_get_app_fcoe_flags, function in NMSettingDcb +nm_setting_dcb_get_app_fcoe_flags, function in NMSettingDcb
-nm_setting_dcb_get_app_fcoe_mode, function in NMSettingDcb +nm_setting_dcb_get_app_fcoe_mode, function in NMSettingDcb
-nm_setting_dcb_get_app_fcoe_priority, function in NMSettingDcb +nm_setting_dcb_get_app_fcoe_priority, function in NMSettingDcb
-nm_setting_dcb_get_app_fip_flags, function in NMSettingDcb +nm_setting_dcb_get_app_fip_flags, function in NMSettingDcb
-nm_setting_dcb_get_app_fip_priority, function in NMSettingDcb +nm_setting_dcb_get_app_fip_priority, function in NMSettingDcb
-nm_setting_dcb_get_app_iscsi_flags, function in NMSettingDcb +nm_setting_dcb_get_app_iscsi_flags, function in NMSettingDcb
-nm_setting_dcb_get_app_iscsi_priority, function in NMSettingDcb +nm_setting_dcb_get_app_iscsi_priority, function in NMSettingDcb
-nm_setting_dcb_get_priority_bandwidth, function in NMSettingDcb +nm_setting_dcb_get_priority_bandwidth, function in NMSettingDcb
-nm_setting_dcb_get_priority_flow_control, function in NMSettingDcb +nm_setting_dcb_get_priority_flow_control, function in NMSettingDcb
-nm_setting_dcb_get_priority_flow_control_flags, function in NMSettingDcb +nm_setting_dcb_get_priority_flow_control_flags, function in NMSettingDcb
-nm_setting_dcb_get_priority_group_bandwidth, function in NMSettingDcb +nm_setting_dcb_get_priority_group_bandwidth, function in NMSettingDcb
-nm_setting_dcb_get_priority_group_flags, function in NMSettingDcb +nm_setting_dcb_get_priority_group_flags, function in NMSettingDcb
-nm_setting_dcb_get_priority_group_id, function in NMSettingDcb +nm_setting_dcb_get_priority_group_id, function in NMSettingDcb
-nm_setting_dcb_get_priority_strict_bandwidth, function in NMSettingDcb +nm_setting_dcb_get_priority_strict_bandwidth, function in NMSettingDcb
-nm_setting_dcb_get_priority_traffic_class, function in NMSettingDcb +nm_setting_dcb_get_priority_traffic_class, function in NMSettingDcb
-nm_setting_dcb_new, function in NMSettingDcb +nm_setting_dcb_new, function in NMSettingDcb
@@ -3233,39 +3000,39 @@
-nm_setting_dcb_set_priority_bandwidth, function in NMSettingDcb +nm_setting_dcb_set_priority_bandwidth, function in NMSettingDcb
-nm_setting_dcb_set_priority_flow_control, function in NMSettingDcb +nm_setting_dcb_set_priority_flow_control, function in NMSettingDcb
-nm_setting_dcb_set_priority_group_bandwidth, function in NMSettingDcb +nm_setting_dcb_set_priority_group_bandwidth, function in NMSettingDcb
-nm_setting_dcb_set_priority_group_id, function in NMSettingDcb +nm_setting_dcb_set_priority_group_id, function in NMSettingDcb
-nm_setting_dcb_set_priority_strict_bandwidth, function in NMSettingDcb +nm_setting_dcb_set_priority_strict_bandwidth, function in NMSettingDcb
-nm_setting_dcb_set_priority_traffic_class, function in NMSettingDcb +nm_setting_dcb_set_priority_traffic_class, function in NMSettingDcb
-nm_setting_diff, function in NMSetting +nm_setting_diff, function in NMSetting
-nm_setting_duplicate, function in NMSetting +nm_setting_duplicate, function in NMSetting
-nm_setting_enumerate_values, function in NMSetting +nm_setting_enumerate_values, function in NMSetting
@@ -3273,7 +3040,7 @@
-nm_setting_error_quark, function in NMSetting +nm_setting_error_quark, function in NMSetting
@@ -3281,11 +3048,11 @@
-nm_setting_generic_error_quark, function in NMSettingGeneric +nm_setting_generic_error_quark, function in NMSettingGeneric
-nm_setting_generic_new, function in NMSettingGeneric +nm_setting_generic_new, function in NMSettingGeneric
@@ -3293,15 +3060,15 @@
-nm_setting_get_name, function in NMSetting +nm_setting_get_name, function in NMSetting
-nm_setting_get_secret_flags, function in NMSetting +nm_setting_get_secret_flags, function in NMSetting
-nm_setting_get_virtual_iface_name, function in NMSetting +nm_setting_get_virtual_iface_name, function in NMSetting
@@ -3321,51 +3088,51 @@
-nm_setting_gsm_error_quark, function in NMSettingGsm +nm_setting_gsm_error_quark, function in NMSettingGsm
-nm_setting_gsm_get_allowed_bands, function in NMSettingGsm +nm_setting_gsm_get_allowed_bands, function in NMSettingGsm
-nm_setting_gsm_get_apn, function in NMSettingGsm +nm_setting_gsm_get_apn, function in NMSettingGsm
-nm_setting_gsm_get_home_only, function in NMSettingGsm +nm_setting_gsm_get_home_only, function in NMSettingGsm
-nm_setting_gsm_get_network_id, function in NMSettingGsm +nm_setting_gsm_get_network_id, function in NMSettingGsm
-nm_setting_gsm_get_network_type, function in NMSettingGsm +nm_setting_gsm_get_network_type, function in NMSettingGsm
-nm_setting_gsm_get_number, function in NMSettingGsm +nm_setting_gsm_get_number, function in NMSettingGsm
-nm_setting_gsm_get_password, function in NMSettingGsm +nm_setting_gsm_get_password, function in NMSettingGsm
-nm_setting_gsm_get_password_flags, function in NMSettingGsm +nm_setting_gsm_get_password_flags, function in NMSettingGsm
-nm_setting_gsm_get_pin, function in NMSettingGsm +nm_setting_gsm_get_pin, function in NMSettingGsm
-nm_setting_gsm_get_pin_flags, function in NMSettingGsm +nm_setting_gsm_get_pin_flags, function in NMSettingGsm
-nm_setting_gsm_get_username, function in NMSettingGsm +nm_setting_gsm_get_username, function in NMSettingGsm
@@ -3381,7 +3148,7 @@
-nm_setting_gsm_new, function in NMSettingGsm +nm_setting_gsm_new, function in NMSettingGsm
@@ -3417,27 +3184,27 @@
-nm_setting_infiniband_error_quark, function in NMSettingInfiniband +nm_setting_infiniband_error_quark, function in NMSettingInfiniband
-nm_setting_infiniband_get_mac_address, function in NMSettingInfiniband +nm_setting_infiniband_get_mac_address, function in NMSettingInfiniband
-nm_setting_infiniband_get_mtu, function in NMSettingInfiniband +nm_setting_infiniband_get_mtu, function in NMSettingInfiniband
-nm_setting_infiniband_get_parent, function in NMSettingInfiniband +nm_setting_infiniband_get_parent, function in NMSettingInfiniband
-nm_setting_infiniband_get_p_key, function in NMSettingInfiniband +nm_setting_infiniband_get_p_key, function in NMSettingInfiniband
-nm_setting_infiniband_get_transport_mode, function in NMSettingInfiniband +nm_setting_infiniband_get_transport_mode, function in NMSettingInfiniband
@@ -3449,7 +3216,7 @@
-nm_setting_infiniband_new, function in NMSettingInfiniband +nm_setting_infiniband_new, function in NMSettingInfiniband
@@ -3473,35 +3240,35 @@
-nm_setting_ip4_config_add_address, function in NMSettingIP4Config +nm_setting_ip4_config_add_address, function in NMSettingIP4Config
-nm_setting_ip4_config_add_dns, function in NMSettingIP4Config +nm_setting_ip4_config_add_dns, function in NMSettingIP4Config
-nm_setting_ip4_config_add_dns_search, function in NMSettingIP4Config +nm_setting_ip4_config_add_dns_search, function in NMSettingIP4Config
-nm_setting_ip4_config_add_route, function in NMSettingIP4Config +nm_setting_ip4_config_add_route, function in NMSettingIP4Config
-nm_setting_ip4_config_clear_addresses, function in NMSettingIP4Config +nm_setting_ip4_config_clear_addresses, function in NMSettingIP4Config
-nm_setting_ip4_config_clear_dns, function in NMSettingIP4Config +nm_setting_ip4_config_clear_dns, function in NMSettingIP4Config
-nm_setting_ip4_config_clear_dns_searches, function in NMSettingIP4Config +nm_setting_ip4_config_clear_dns_searches, function in NMSettingIP4Config
-nm_setting_ip4_config_clear_routes, function in NMSettingIP4Config +nm_setting_ip4_config_clear_routes, function in NMSettingIP4Config
@@ -3529,75 +3296,75 @@
-nm_setting_ip4_config_error_quark, function in NMSettingIP4Config +nm_setting_ip4_config_error_quark, function in NMSettingIP4Config
-nm_setting_ip4_config_get_address, function in NMSettingIP4Config +nm_setting_ip4_config_get_address, function in NMSettingIP4Config
-nm_setting_ip4_config_get_dhcp_client_id, function in NMSettingIP4Config +nm_setting_ip4_config_get_dhcp_client_id, function in NMSettingIP4Config
-nm_setting_ip4_config_get_dhcp_hostname, function in NMSettingIP4Config +nm_setting_ip4_config_get_dhcp_hostname, function in NMSettingIP4Config
-nm_setting_ip4_config_get_dhcp_send_hostname, function in NMSettingIP4Config +nm_setting_ip4_config_get_dhcp_send_hostname, function in NMSettingIP4Config
-nm_setting_ip4_config_get_dns, function in NMSettingIP4Config +nm_setting_ip4_config_get_dns, function in NMSettingIP4Config
-nm_setting_ip4_config_get_dns_search, function in NMSettingIP4Config +nm_setting_ip4_config_get_dns_search, function in NMSettingIP4Config
-nm_setting_ip4_config_get_ignore_auto_dns, function in NMSettingIP4Config +nm_setting_ip4_config_get_ignore_auto_dns, function in NMSettingIP4Config
-nm_setting_ip4_config_get_ignore_auto_routes, function in NMSettingIP4Config +nm_setting_ip4_config_get_ignore_auto_routes, function in NMSettingIP4Config
-nm_setting_ip4_config_get_may_fail, function in NMSettingIP4Config +nm_setting_ip4_config_get_may_fail, function in NMSettingIP4Config
-nm_setting_ip4_config_get_method, function in NMSettingIP4Config +nm_setting_ip4_config_get_method, function in NMSettingIP4Config
-nm_setting_ip4_config_get_never_default, function in NMSettingIP4Config +nm_setting_ip4_config_get_never_default, function in NMSettingIP4Config
-nm_setting_ip4_config_get_num_addresses, function in NMSettingIP4Config +nm_setting_ip4_config_get_num_addresses, function in NMSettingIP4Config
-nm_setting_ip4_config_get_num_dns, function in NMSettingIP4Config +nm_setting_ip4_config_get_num_dns, function in NMSettingIP4Config
-nm_setting_ip4_config_get_num_dns_searches, function in NMSettingIP4Config +nm_setting_ip4_config_get_num_dns_searches, function in NMSettingIP4Config
-nm_setting_ip4_config_get_num_routes, function in NMSettingIP4Config +nm_setting_ip4_config_get_num_routes, function in NMSettingIP4Config
-nm_setting_ip4_config_get_route, function in NMSettingIP4Config +nm_setting_ip4_config_get_route, function in NMSettingIP4Config
-nm_setting_ip4_config_get_route_metric, function in NMSettingIP4Config +nm_setting_ip4_config_get_route_metric, function in NMSettingIP4Config
@@ -3641,39 +3408,39 @@
-nm_setting_ip4_config_new, function in NMSettingIP4Config +nm_setting_ip4_config_new, function in NMSettingIP4Config
-nm_setting_ip4_config_remove_address, function in NMSettingIP4Config +nm_setting_ip4_config_remove_address, function in NMSettingIP4Config
-nm_setting_ip4_config_remove_address_by_value, function in NMSettingIP4Config +nm_setting_ip4_config_remove_address_by_value, function in NMSettingIP4Config
-nm_setting_ip4_config_remove_dns, function in NMSettingIP4Config +nm_setting_ip4_config_remove_dns, function in NMSettingIP4Config
-nm_setting_ip4_config_remove_dns_by_value, function in NMSettingIP4Config +nm_setting_ip4_config_remove_dns_by_value, function in NMSettingIP4Config
-nm_setting_ip4_config_remove_dns_search, function in NMSettingIP4Config +nm_setting_ip4_config_remove_dns_search, function in NMSettingIP4Config
-nm_setting_ip4_config_remove_dns_search_by_value, function in NMSettingIP4Config +nm_setting_ip4_config_remove_dns_search_by_value, function in NMSettingIP4Config
-nm_setting_ip4_config_remove_route, function in NMSettingIP4Config +nm_setting_ip4_config_remove_route, function in NMSettingIP4Config
-nm_setting_ip4_config_remove_route_by_value, function in NMSettingIP4Config +nm_setting_ip4_config_remove_route_by_value, function in NMSettingIP4Config
@@ -3693,35 +3460,35 @@
-nm_setting_ip6_config_add_address, function in NMSettingIP6Config +nm_setting_ip6_config_add_address, function in NMSettingIP6Config
-nm_setting_ip6_config_add_dns, function in NMSettingIP6Config +nm_setting_ip6_config_add_dns, function in NMSettingIP6Config
-nm_setting_ip6_config_add_dns_search, function in NMSettingIP6Config +nm_setting_ip6_config_add_dns_search, function in NMSettingIP6Config
-nm_setting_ip6_config_add_route, function in NMSettingIP6Config +nm_setting_ip6_config_add_route, function in NMSettingIP6Config
-nm_setting_ip6_config_clear_addresses, function in NMSettingIP6Config +nm_setting_ip6_config_clear_addresses, function in NMSettingIP6Config
-nm_setting_ip6_config_clear_dns, function in NMSettingIP6Config +nm_setting_ip6_config_clear_dns, function in NMSettingIP6Config
-nm_setting_ip6_config_clear_dns_searches, function in NMSettingIP6Config +nm_setting_ip6_config_clear_dns_searches, function in NMSettingIP6Config
-nm_setting_ip6_config_clear_routes, function in NMSettingIP6Config +nm_setting_ip6_config_clear_routes, function in NMSettingIP6Config
@@ -3741,71 +3508,71 @@
-nm_setting_ip6_config_error_quark, function in NMSettingIP6Config +nm_setting_ip6_config_error_quark, function in NMSettingIP6Config
-nm_setting_ip6_config_get_address, function in NMSettingIP6Config +nm_setting_ip6_config_get_address, function in NMSettingIP6Config
-nm_setting_ip6_config_get_dhcp_hostname, function in NMSettingIP6Config +nm_setting_ip6_config_get_dhcp_hostname, function in NMSettingIP6Config
-nm_setting_ip6_config_get_dns, function in NMSettingIP6Config +nm_setting_ip6_config_get_dns, function in NMSettingIP6Config
-nm_setting_ip6_config_get_dns_search, function in NMSettingIP6Config +nm_setting_ip6_config_get_dns_search, function in NMSettingIP6Config
-nm_setting_ip6_config_get_ignore_auto_dns, function in NMSettingIP6Config +nm_setting_ip6_config_get_ignore_auto_dns, function in NMSettingIP6Config
-nm_setting_ip6_config_get_ignore_auto_routes, function in NMSettingIP6Config +nm_setting_ip6_config_get_ignore_auto_routes, function in NMSettingIP6Config
-nm_setting_ip6_config_get_ip6_privacy, function in NMSettingIP6Config +nm_setting_ip6_config_get_ip6_privacy, function in NMSettingIP6Config
-nm_setting_ip6_config_get_may_fail, function in NMSettingIP6Config +nm_setting_ip6_config_get_may_fail, function in NMSettingIP6Config
-nm_setting_ip6_config_get_method, function in NMSettingIP6Config +nm_setting_ip6_config_get_method, function in NMSettingIP6Config
-nm_setting_ip6_config_get_never_default, function in NMSettingIP6Config +nm_setting_ip6_config_get_never_default, function in NMSettingIP6Config
-nm_setting_ip6_config_get_num_addresses, function in NMSettingIP6Config +nm_setting_ip6_config_get_num_addresses, function in NMSettingIP6Config
-nm_setting_ip6_config_get_num_dns, function in NMSettingIP6Config +nm_setting_ip6_config_get_num_dns, function in NMSettingIP6Config
-nm_setting_ip6_config_get_num_dns_searches, function in NMSettingIP6Config +nm_setting_ip6_config_get_num_dns_searches, function in NMSettingIP6Config
-nm_setting_ip6_config_get_num_routes, function in NMSettingIP6Config +nm_setting_ip6_config_get_num_routes, function in NMSettingIP6Config
-nm_setting_ip6_config_get_route, function in NMSettingIP6Config +nm_setting_ip6_config_get_route, function in NMSettingIP6Config
-nm_setting_ip6_config_get_route_metric, function in NMSettingIP6Config +nm_setting_ip6_config_get_route_metric, function in NMSettingIP6Config
@@ -3857,39 +3624,39 @@
-nm_setting_ip6_config_new, function in NMSettingIP6Config +nm_setting_ip6_config_new, function in NMSettingIP6Config
-nm_setting_ip6_config_remove_address, function in NMSettingIP6Config +nm_setting_ip6_config_remove_address, function in NMSettingIP6Config
-nm_setting_ip6_config_remove_address_by_value, function in NMSettingIP6Config +nm_setting_ip6_config_remove_address_by_value, function in NMSettingIP6Config
-nm_setting_ip6_config_remove_dns, function in NMSettingIP6Config +nm_setting_ip6_config_remove_dns, function in NMSettingIP6Config
-nm_setting_ip6_config_remove_dns_by_value, function in NMSettingIP6Config +nm_setting_ip6_config_remove_dns_by_value, function in NMSettingIP6Config
-nm_setting_ip6_config_remove_dns_search, function in NMSettingIP6Config +nm_setting_ip6_config_remove_dns_search, function in NMSettingIP6Config
-nm_setting_ip6_config_remove_dns_search_by_value, function in NMSettingIP6Config +nm_setting_ip6_config_remove_dns_search_by_value, function in NMSettingIP6Config
-nm_setting_ip6_config_remove_route, function in NMSettingIP6Config +nm_setting_ip6_config_remove_route, function in NMSettingIP6Config
-nm_setting_ip6_config_remove_route_by_value, function in NMSettingIP6Config +nm_setting_ip6_config_remove_route_by_value, function in NMSettingIP6Config
@@ -3909,11 +3676,11 @@
-nm_setting_need_secrets, function in NMSetting +nm_setting_need_secrets, function in NMSetting
-nm_setting_new_from_hash, function in NMSetting +nm_setting_new_from_hash, function in NMSetting
@@ -3929,23 +3696,23 @@
-nm_setting_olpc_mesh_error_quark, function in NMSettingOlpcMesh +nm_setting_olpc_mesh_error_quark, function in NMSettingOlpcMesh
-nm_setting_olpc_mesh_get_channel, function in NMSettingOlpcMesh +nm_setting_olpc_mesh_get_channel, function in NMSettingOlpcMesh
-nm_setting_olpc_mesh_get_dhcp_anycast_address, function in NMSettingOlpcMesh +nm_setting_olpc_mesh_get_dhcp_anycast_address, function in NMSettingOlpcMesh
-nm_setting_olpc_mesh_get_ssid, function in NMSettingOlpcMesh +nm_setting_olpc_mesh_get_ssid, function in NMSettingOlpcMesh
-nm_setting_olpc_mesh_new, function in NMSettingOlpcMesh +nm_setting_olpc_mesh_new, function in NMSettingOlpcMesh
@@ -3977,27 +3744,27 @@
-nm_setting_pppoe_error_quark, function in NMSettingPPPOE +nm_setting_pppoe_error_quark, function in NMSettingPPPOE
-nm_setting_pppoe_get_password, function in NMSettingPPPOE +nm_setting_pppoe_get_password, function in NMSettingPPPOE
-nm_setting_pppoe_get_password_flags, function in NMSettingPPPOE +nm_setting_pppoe_get_password_flags, function in NMSettingPPPOE
-nm_setting_pppoe_get_service, function in NMSettingPPPOE +nm_setting_pppoe_get_service, function in NMSettingPPPOE
-nm_setting_pppoe_get_username, function in NMSettingPPPOE +nm_setting_pppoe_get_username, function in NMSettingPPPOE
-nm_setting_pppoe_new, function in NMSettingPPPOE +nm_setting_pppoe_new, function in NMSettingPPPOE
@@ -4033,79 +3800,79 @@
-nm_setting_ppp_error_quark, function in NMSettingPPP +nm_setting_ppp_error_quark, function in NMSettingPPP
-nm_setting_ppp_get_baud, function in NMSettingPPP +nm_setting_ppp_get_baud, function in NMSettingPPP
-nm_setting_ppp_get_crtscts, function in NMSettingPPP +nm_setting_ppp_get_crtscts, function in NMSettingPPP
-nm_setting_ppp_get_lcp_echo_failure, function in NMSettingPPP +nm_setting_ppp_get_lcp_echo_failure, function in NMSettingPPP
-nm_setting_ppp_get_lcp_echo_interval, function in NMSettingPPP +nm_setting_ppp_get_lcp_echo_interval, function in NMSettingPPP
-nm_setting_ppp_get_mppe_stateful, function in NMSettingPPP +nm_setting_ppp_get_mppe_stateful, function in NMSettingPPP
-nm_setting_ppp_get_mru, function in NMSettingPPP +nm_setting_ppp_get_mru, function in NMSettingPPP
-nm_setting_ppp_get_mtu, function in NMSettingPPP +nm_setting_ppp_get_mtu, function in NMSettingPPP
-nm_setting_ppp_get_noauth, function in NMSettingPPP +nm_setting_ppp_get_noauth, function in NMSettingPPP
-nm_setting_ppp_get_nobsdcomp, function in NMSettingPPP +nm_setting_ppp_get_nobsdcomp, function in NMSettingPPP
-nm_setting_ppp_get_nodeflate, function in NMSettingPPP +nm_setting_ppp_get_nodeflate, function in NMSettingPPP
-nm_setting_ppp_get_no_vj_comp, function in NMSettingPPP +nm_setting_ppp_get_no_vj_comp, function in NMSettingPPP
-nm_setting_ppp_get_refuse_chap, function in NMSettingPPP +nm_setting_ppp_get_refuse_chap, function in NMSettingPPP
-nm_setting_ppp_get_refuse_eap, function in NMSettingPPP +nm_setting_ppp_get_refuse_eap, function in NMSettingPPP
-nm_setting_ppp_get_refuse_mschap, function in NMSettingPPP +nm_setting_ppp_get_refuse_mschap, function in NMSettingPPP
-nm_setting_ppp_get_refuse_mschapv2, function in NMSettingPPP +nm_setting_ppp_get_refuse_mschapv2, function in NMSettingPPP
-nm_setting_ppp_get_refuse_pap, function in NMSettingPPP +nm_setting_ppp_get_refuse_pap, function in NMSettingPPP
-nm_setting_ppp_get_require_mppe, function in NMSettingPPP +nm_setting_ppp_get_require_mppe, function in NMSettingPPP
-nm_setting_ppp_get_require_mppe_128, function in NMSettingPPP +nm_setting_ppp_get_require_mppe_128, function in NMSettingPPP
@@ -4129,7 +3896,7 @@
-nm_setting_ppp_new, function in NMSettingPPP +nm_setting_ppp_new, function in NMSettingPPP
@@ -4193,31 +3960,31 @@
-nm_setting_serial_error_quark, function in NMSettingSerial +nm_setting_serial_error_quark, function in NMSettingSerial
-nm_setting_serial_get_baud, function in NMSettingSerial +nm_setting_serial_get_baud, function in NMSettingSerial
-nm_setting_serial_get_bits, function in NMSettingSerial +nm_setting_serial_get_bits, function in NMSettingSerial
-nm_setting_serial_get_parity, function in NMSettingSerial +nm_setting_serial_get_parity, function in NMSettingSerial
-nm_setting_serial_get_send_delay, function in NMSettingSerial +nm_setting_serial_get_send_delay, function in NMSettingSerial
-nm_setting_serial_get_stopbits, function in NMSettingSerial +nm_setting_serial_get_stopbits, function in NMSettingSerial
-nm_setting_serial_new, function in NMSettingSerial +nm_setting_serial_new, function in NMSettingSerial
@@ -4237,7 +4004,7 @@
-nm_setting_set_secret_flags, function in NMSetting +nm_setting_set_secret_flags, function in NMSetting
@@ -4249,15 +4016,15 @@
-nm_setting_team_error_quark, function in NMSettingTeam +nm_setting_team_error_quark, function in NMSettingTeam
-nm_setting_team_get_config, function in NMSettingTeam +nm_setting_team_get_config, function in NMSettingTeam
-nm_setting_team_get_interface_name, function in NMSettingTeam +nm_setting_team_get_interface_name, function in NMSettingTeam
@@ -4265,7 +4032,7 @@
-nm_setting_team_new, function in NMSettingTeam +nm_setting_team_new, function in NMSettingTeam
@@ -4277,15 +4044,15 @@
-nm_setting_team_port_error_quark, function in NMSettingTeamPort +nm_setting_team_port_error_quark, function in NMSettingTeamPort
-nm_setting_team_port_get_config, function in NMSettingTeamPort +nm_setting_team_port_get_config, function in NMSettingTeamPort
-nm_setting_team_port_new, function in NMSettingTeamPort +nm_setting_team_port_new, function in NMSettingTeamPort
@@ -4297,31 +4064,31 @@
-nm_setting_to_hash, function in NMSetting +nm_setting_to_hash, function in NMSetting
-nm_setting_to_string, function in NMSetting +nm_setting_to_string, function in NMSetting
-nm_setting_update_secrets, function in NMSetting +nm_setting_update_secrets, function in NMSetting
-nm_setting_verify, function in NMSetting +nm_setting_verify, function in NMSetting
-nm_setting_vlan_add_priority, function in NMSettingVlan +nm_setting_vlan_add_priority, function in NMSettingVlan
-nm_setting_vlan_add_priority_str, function in NMSettingVlan +nm_setting_vlan_add_priority_str, function in NMSettingVlan
-nm_setting_vlan_clear_priorities, function in NMSettingVlan +nm_setting_vlan_clear_priorities, function in NMSettingVlan
@@ -4333,7 +4100,7 @@
-nm_setting_vlan_error_quark, function in NMSettingVlan +nm_setting_vlan_error_quark, function in NMSettingVlan
@@ -4341,27 +4108,27 @@
-nm_setting_vlan_get_flags, function in NMSettingVlan +nm_setting_vlan_get_flags, function in NMSettingVlan
-nm_setting_vlan_get_id, function in NMSettingVlan +nm_setting_vlan_get_id, function in NMSettingVlan
-nm_setting_vlan_get_interface_name, function in NMSettingVlan +nm_setting_vlan_get_interface_name, function in NMSettingVlan
-nm_setting_vlan_get_num_priorities, function in NMSettingVlan +nm_setting_vlan_get_num_priorities, function in NMSettingVlan
-nm_setting_vlan_get_parent, function in NMSettingVlan +nm_setting_vlan_get_parent, function in NMSettingVlan
-nm_setting_vlan_get_priority, function in NMSettingVlan +nm_setting_vlan_get_priority, function in NMSettingVlan
@@ -4377,7 +4144,7 @@
-nm_setting_vlan_new, function in NMSettingVlan +nm_setting_vlan_new, function in NMSettingVlan
@@ -4385,15 +4152,15 @@
-nm_setting_vlan_remove_priority, function in NMSettingVlan +nm_setting_vlan_remove_priority, function in NMSettingVlan
-nm_setting_vlan_remove_priority_by_value, function in NMSettingVlan +nm_setting_vlan_remove_priority_by_value, function in NMSettingVlan
-nm_setting_vlan_remove_priority_str_by_value, function in NMSettingVlan +nm_setting_vlan_remove_priority_str_by_value, function in NMSettingVlan
@@ -4401,11 +4168,11 @@
-nm_setting_vpn_add_data_item, function in NMSettingVPN +nm_setting_vpn_add_data_item, function in NMSettingVPN
-nm_setting_vpn_add_secret, function in NMSettingVPN +nm_setting_vpn_add_secret, function in NMSettingVPN
@@ -4417,47 +4184,47 @@
-nm_setting_vpn_error_quark, function in NMSettingVPN +nm_setting_vpn_error_quark, function in NMSettingVPN
-nm_setting_vpn_foreach_data_item, function in NMSettingVPN +nm_setting_vpn_foreach_data_item, function in NMSettingVPN
-nm_setting_vpn_foreach_secret, function in NMSettingVPN +nm_setting_vpn_foreach_secret, function in NMSettingVPN
-nm_setting_vpn_get_data_item, function in NMSettingVPN +nm_setting_vpn_get_data_item, function in NMSettingVPN
-nm_setting_vpn_get_num_data_items, function in NMSettingVPN +nm_setting_vpn_get_num_data_items, function in NMSettingVPN
-nm_setting_vpn_get_num_secrets, function in NMSettingVPN +nm_setting_vpn_get_num_secrets, function in NMSettingVPN
-nm_setting_vpn_get_persistent, function in NMSettingVPN +nm_setting_vpn_get_persistent, function in NMSettingVPN
-nm_setting_vpn_get_secret, function in NMSettingVPN +nm_setting_vpn_get_secret, function in NMSettingVPN
-nm_setting_vpn_get_service_type, function in NMSettingVPN +nm_setting_vpn_get_service_type, function in NMSettingVPN
-nm_setting_vpn_get_user_name, function in NMSettingVPN +nm_setting_vpn_get_user_name, function in NMSettingVPN
-nm_setting_vpn_new, function in NMSettingVPN +nm_setting_vpn_new, function in NMSettingVPN
@@ -4465,11 +4232,11 @@
-nm_setting_vpn_remove_data_item, function in NMSettingVPN +nm_setting_vpn_remove_data_item, function in NMSettingVPN
-nm_setting_vpn_remove_secret, function in NMSettingVPN +nm_setting_vpn_remove_secret, function in NMSettingVPN
@@ -4493,15 +4260,15 @@
-nm_setting_wimax_error_quark, function in NMSettingWimax +nm_setting_wimax_error_quark, function in NMSettingWimax
-nm_setting_wimax_get_mac_address, function in NMSettingWimax +nm_setting_wimax_get_mac_address, function in NMSettingWimax
-nm_setting_wimax_get_network_name, function in NMSettingWimax +nm_setting_wimax_get_network_name, function in NMSettingWimax
@@ -4513,7 +4280,7 @@
-nm_setting_wimax_new, function in NMSettingWimax +nm_setting_wimax_new, function in NMSettingWimax
@@ -4521,11 +4288,11 @@
-nm_setting_wired_add_mac_blacklist_item, function in NMSettingWired +nm_setting_wired_add_mac_blacklist_item, function in NMSettingWired
-nm_setting_wired_add_s390_option, function in NMSettingWired +nm_setting_wired_add_s390_option, function in NMSettingWired
@@ -4533,7 +4300,7 @@
-nm_setting_wired_clear_mac_blacklist_items, function in NMSettingWired +nm_setting_wired_clear_mac_blacklist_items, function in NMSettingWired
@@ -4549,71 +4316,71 @@
-nm_setting_wired_error_quark, function in NMSettingWired +nm_setting_wired_error_quark, function in NMSettingWired
-nm_setting_wired_get_auto_negotiate, function in NMSettingWired +nm_setting_wired_get_auto_negotiate, function in NMSettingWired
-nm_setting_wired_get_cloned_mac_address, function in NMSettingWired +nm_setting_wired_get_cloned_mac_address, function in NMSettingWired
-nm_setting_wired_get_duplex, function in NMSettingWired +nm_setting_wired_get_duplex, function in NMSettingWired
-nm_setting_wired_get_mac_address, function in NMSettingWired +nm_setting_wired_get_mac_address, function in NMSettingWired
-nm_setting_wired_get_mac_address_blacklist, function in NMSettingWired +nm_setting_wired_get_mac_address_blacklist, function in NMSettingWired
-nm_setting_wired_get_mac_blacklist_item, function in NMSettingWired +nm_setting_wired_get_mac_blacklist_item, function in NMSettingWired
-nm_setting_wired_get_mtu, function in NMSettingWired +nm_setting_wired_get_mtu, function in NMSettingWired
-nm_setting_wired_get_num_mac_blacklist_items, function in NMSettingWired +nm_setting_wired_get_num_mac_blacklist_items, function in NMSettingWired
-nm_setting_wired_get_num_s390_options, function in NMSettingWired +nm_setting_wired_get_num_s390_options, function in NMSettingWired
-nm_setting_wired_get_port, function in NMSettingWired +nm_setting_wired_get_port, function in NMSettingWired
-nm_setting_wired_get_s390_nettype, function in NMSettingWired +nm_setting_wired_get_s390_nettype, function in NMSettingWired
-nm_setting_wired_get_s390_option, function in NMSettingWired +nm_setting_wired_get_s390_option, function in NMSettingWired
-nm_setting_wired_get_s390_option_by_key, function in NMSettingWired +nm_setting_wired_get_s390_option_by_key, function in NMSettingWired
-nm_setting_wired_get_s390_subchannels, function in NMSettingWired +nm_setting_wired_get_s390_subchannels, function in NMSettingWired
-nm_setting_wired_get_speed, function in NMSettingWired +nm_setting_wired_get_speed, function in NMSettingWired
-nm_setting_wired_get_valid_s390_options, function in NMSettingWired +nm_setting_wired_get_valid_s390_options, function in NMSettingWired
@@ -4629,7 +4396,7 @@
-nm_setting_wired_new, function in NMSettingWired +nm_setting_wired_new, function in NMSettingWired
@@ -4637,15 +4404,15 @@
-nm_setting_wired_remove_mac_blacklist_item, function in NMSettingWired +nm_setting_wired_remove_mac_blacklist_item, function in NMSettingWired
-nm_setting_wired_remove_mac_blacklist_item_by_value, function in NMSettingWired +nm_setting_wired_remove_mac_blacklist_item_by_value, function in NMSettingWired
-nm_setting_wired_remove_s390_option, function in NMSettingWired +nm_setting_wired_remove_s390_option, function in NMSettingWired
@@ -4669,15 +4436,15 @@
-nm_setting_wireless_add_mac_blacklist_item, function in NMSettingWireless +nm_setting_wireless_add_mac_blacklist_item, function in NMSettingWireless
-nm_setting_wireless_add_seen_bssid, function in NMSettingWireless +nm_setting_wireless_add_seen_bssid, function in NMSettingWireless
-nm_setting_wireless_ap_security_compatible, function in NMSettingWireless +nm_setting_wireless_ap_security_compatible, function in NMSettingWireless
@@ -4693,7 +4460,7 @@
-nm_setting_wireless_clear_mac_blacklist_items, function in NMSettingWireless +nm_setting_wireless_clear_mac_blacklist_items, function in NMSettingWireless
@@ -4705,75 +4472,75 @@
-nm_setting_wireless_error_quark, function in NMSettingWireless +nm_setting_wireless_error_quark, function in NMSettingWireless
-nm_setting_wireless_get_band, function in NMSettingWireless +nm_setting_wireless_get_band, function in NMSettingWireless
-nm_setting_wireless_get_bssid, function in NMSettingWireless +nm_setting_wireless_get_bssid, function in NMSettingWireless
-nm_setting_wireless_get_channel, function in NMSettingWireless +nm_setting_wireless_get_channel, function in NMSettingWireless
-nm_setting_wireless_get_cloned_mac_address, function in NMSettingWireless +nm_setting_wireless_get_cloned_mac_address, function in NMSettingWireless
-nm_setting_wireless_get_hidden, function in NMSettingWireless +nm_setting_wireless_get_hidden, function in NMSettingWireless
-nm_setting_wireless_get_mac_address, function in NMSettingWireless +nm_setting_wireless_get_mac_address, function in NMSettingWireless
-nm_setting_wireless_get_mac_address_blacklist, function in NMSettingWireless +nm_setting_wireless_get_mac_address_blacklist, function in NMSettingWireless
-nm_setting_wireless_get_mac_blacklist_item, function in NMSettingWireless +nm_setting_wireless_get_mac_blacklist_item, function in NMSettingWireless
-nm_setting_wireless_get_mode, function in NMSettingWireless +nm_setting_wireless_get_mode, function in NMSettingWireless
-nm_setting_wireless_get_mtu, function in NMSettingWireless +nm_setting_wireless_get_mtu, function in NMSettingWireless
-nm_setting_wireless_get_num_mac_blacklist_items, function in NMSettingWireless +nm_setting_wireless_get_num_mac_blacklist_items, function in NMSettingWireless
-nm_setting_wireless_get_num_seen_bssids, function in NMSettingWireless +nm_setting_wireless_get_num_seen_bssids, function in NMSettingWireless
-nm_setting_wireless_get_rate, function in NMSettingWireless +nm_setting_wireless_get_rate, function in NMSettingWireless
-nm_setting_wireless_get_security, function in NMSettingWireless +nm_setting_wireless_get_security, function in NMSettingWireless
-nm_setting_wireless_get_seen_bssid, function in NMSettingWireless +nm_setting_wireless_get_seen_bssid, function in NMSettingWireless
-nm_setting_wireless_get_ssid, function in NMSettingWireless +nm_setting_wireless_get_ssid, function in NMSettingWireless
-nm_setting_wireless_get_tx_power, function in NMSettingWireless +nm_setting_wireless_get_tx_power, function in NMSettingWireless
@@ -4809,7 +4576,7 @@
-nm_setting_wireless_new, function in NMSettingWireless +nm_setting_wireless_new, function in NMSettingWireless
@@ -4817,11 +4584,11 @@
-nm_setting_wireless_remove_mac_blacklist_item, function in NMSettingWireless +nm_setting_wireless_remove_mac_blacklist_item, function in NMSettingWireless
-nm_setting_wireless_remove_mac_blacklist_item_by_value, function in NMSettingWireless +nm_setting_wireless_remove_mac_blacklist_item_by_value, function in NMSettingWireless
@@ -4829,15 +4596,15 @@
-nm_setting_wireless_security_add_group, function in NMSettingWirelessSecurity +nm_setting_wireless_security_add_group, function in NMSettingWirelessSecurity
-nm_setting_wireless_security_add_pairwise, function in NMSettingWirelessSecurity +nm_setting_wireless_security_add_pairwise, function in NMSettingWirelessSecurity
-nm_setting_wireless_security_add_proto, function in NMSettingWirelessSecurity +nm_setting_wireless_security_add_proto, function in NMSettingWirelessSecurity
@@ -4845,15 +4612,15 @@
-nm_setting_wireless_security_clear_groups, function in NMSettingWirelessSecurity +nm_setting_wireless_security_clear_groups, function in NMSettingWirelessSecurity
-nm_setting_wireless_security_clear_pairwise, function in NMSettingWirelessSecurity +nm_setting_wireless_security_clear_pairwise, function in NMSettingWirelessSecurity
-nm_setting_wireless_security_clear_protos, function in NMSettingWirelessSecurity +nm_setting_wireless_security_clear_protos, function in NMSettingWirelessSecurity
@@ -4861,75 +4628,75 @@
-nm_setting_wireless_security_error_quark, function in NMSettingWirelessSecurity +nm_setting_wireless_security_error_quark, function in NMSettingWirelessSecurity
-nm_setting_wireless_security_get_auth_alg, function in NMSettingWirelessSecurity +nm_setting_wireless_security_get_auth_alg, function in NMSettingWirelessSecurity
-nm_setting_wireless_security_get_group, function in NMSettingWirelessSecurity +nm_setting_wireless_security_get_group, function in NMSettingWirelessSecurity
-nm_setting_wireless_security_get_key_mgmt, function in NMSettingWirelessSecurity +nm_setting_wireless_security_get_key_mgmt, function in NMSettingWirelessSecurity
-nm_setting_wireless_security_get_leap_password, function in NMSettingWirelessSecurity +nm_setting_wireless_security_get_leap_password, function in NMSettingWirelessSecurity
-nm_setting_wireless_security_get_leap_password_flags, function in NMSettingWirelessSecurity +nm_setting_wireless_security_get_leap_password_flags, function in NMSettingWirelessSecurity
-nm_setting_wireless_security_get_leap_username, function in NMSettingWirelessSecurity +nm_setting_wireless_security_get_leap_username, function in NMSettingWirelessSecurity
-nm_setting_wireless_security_get_num_groups, function in NMSettingWirelessSecurity +nm_setting_wireless_security_get_num_groups, function in NMSettingWirelessSecurity
-nm_setting_wireless_security_get_num_pairwise, function in NMSettingWirelessSecurity +nm_setting_wireless_security_get_num_pairwise, function in NMSettingWirelessSecurity
-nm_setting_wireless_security_get_num_protos, function in NMSettingWirelessSecurity +nm_setting_wireless_security_get_num_protos, function in NMSettingWirelessSecurity
-nm_setting_wireless_security_get_pairwise, function in NMSettingWirelessSecurity +nm_setting_wireless_security_get_pairwise, function in NMSettingWirelessSecurity
-nm_setting_wireless_security_get_proto, function in NMSettingWirelessSecurity +nm_setting_wireless_security_get_proto, function in NMSettingWirelessSecurity
-nm_setting_wireless_security_get_psk, function in NMSettingWirelessSecurity +nm_setting_wireless_security_get_psk, function in NMSettingWirelessSecurity
-nm_setting_wireless_security_get_psk_flags, function in NMSettingWirelessSecurity +nm_setting_wireless_security_get_psk_flags, function in NMSettingWirelessSecurity
-nm_setting_wireless_security_get_wep_key, function in NMSettingWirelessSecurity +nm_setting_wireless_security_get_wep_key, function in NMSettingWirelessSecurity
-nm_setting_wireless_security_get_wep_key_flags, function in NMSettingWirelessSecurity +nm_setting_wireless_security_get_wep_key_flags, function in NMSettingWirelessSecurity
-nm_setting_wireless_security_get_wep_key_type, function in NMSettingWirelessSecurity +nm_setting_wireless_security_get_wep_key_type, function in NMSettingWirelessSecurity
-nm_setting_wireless_security_get_wep_tx_keyidx, function in NMSettingWirelessSecurity +nm_setting_wireless_security_get_wep_tx_keyidx, function in NMSettingWirelessSecurity
@@ -4953,7 +4720,7 @@
-nm_setting_wireless_security_new, function in NMSettingWirelessSecurity +nm_setting_wireless_security_new, function in NMSettingWirelessSecurity
@@ -4973,27 +4740,27 @@
-nm_setting_wireless_security_remove_group, function in NMSettingWirelessSecurity +nm_setting_wireless_security_remove_group, function in NMSettingWirelessSecurity
-nm_setting_wireless_security_remove_group_by_value, function in NMSettingWirelessSecurity +nm_setting_wireless_security_remove_group_by_value, function in NMSettingWirelessSecurity
-nm_setting_wireless_security_remove_pairwise, function in NMSettingWirelessSecurity +nm_setting_wireless_security_remove_pairwise, function in NMSettingWirelessSecurity
-nm_setting_wireless_security_remove_pairwise_by_value, function in NMSettingWirelessSecurity +nm_setting_wireless_security_remove_pairwise_by_value, function in NMSettingWirelessSecurity
-nm_setting_wireless_security_remove_proto, function in NMSettingWirelessSecurity +nm_setting_wireless_security_remove_proto, function in NMSettingWirelessSecurity
-nm_setting_wireless_security_remove_proto_by_value, function in NMSettingWirelessSecurity +nm_setting_wireless_security_remove_proto_by_value, function in NMSettingWirelessSecurity
@@ -5001,7 +4768,7 @@
-nm_setting_wireless_security_set_wep_key, function in NMSettingWirelessSecurity +nm_setting_wireless_security_set_wep_key, function in NMSettingWirelessSecurity
@@ -5058,67 +4825,67 @@

U

-NMUtilsFileSearchInPathsPredicate, user_function in nm-utils +NMUtilsFileSearchInPathsPredicate, user_function in nm-utils
-NMUtilsSecurityType, enum in nm-utils +NMUtilsSecurityType, enum in nm-utils
-nm_utils_ap_mode_security_valid, function in nm-utils +nm_utils_ap_mode_security_valid, function in nm-utils
-nm_utils_bin2hexstr, function in nm-utils +nm_utils_bin2hexstr, function in nm-utils
-nm_utils_check_virtual_device_compatibility, function in nm-utils +nm_utils_check_virtual_device_compatibility, function in nm-utils
-nm_utils_deinit, function in nm-utils +nm_utils_deinit, function in nm-utils
-nm_utils_escape_ssid, function in nm-utils +nm_utils_escape_ssid, function in nm-utils
-nm_utils_file_is_pkcs12, function in nm-utils +nm_utils_file_is_pkcs12, function in nm-utils
-nm_utils_file_search_in_paths, function in nm-utils +nm_utils_file_search_in_paths, function in nm-utils
-nm_utils_gvalue_hash_dup, function in nm-utils +nm_utils_gvalue_hash_dup, function in nm-utils
-nm_utils_hex2byte, function in nm-utils +nm_utils_hex2byte, function in nm-utils
-nm_utils_hexstr2bin, function in nm-utils +nm_utils_hexstr2bin, function in nm-utils
-nm_utils_hwaddr_atoba, function in nm-utils +nm_utils_hwaddr_atoba, function in nm-utils
-nm_utils_hwaddr_aton, function in nm-utils +nm_utils_hwaddr_aton, function in nm-utils
-nm_utils_hwaddr_aton_len, function in nm-utils +nm_utils_hwaddr_aton_len, function in nm-utils
-nm_utils_hwaddr_len, function in nm-utils +nm_utils_hwaddr_len, function in nm-utils
@@ -5126,31 +4893,31 @@
-nm_utils_hwaddr_ntoa, function in nm-utils +nm_utils_hwaddr_ntoa, function in nm-utils
-nm_utils_hwaddr_ntoa_len, function in nm-utils +nm_utils_hwaddr_ntoa_len, function in nm-utils
-nm_utils_hwaddr_type, function in nm-utils +nm_utils_hwaddr_type, function in nm-utils
-nm_utils_hwaddr_valid, function in nm-utils +nm_utils_hwaddr_valid, function in nm-utils
-nm_utils_iface_valid_name, function in nm-utils +nm_utils_iface_valid_name, function in nm-utils
-nm_utils_inet4_ntop, function in nm-utils +nm_utils_inet4_ntop, function in nm-utils
-nm_utils_inet6_ntop, function in nm-utils +nm_utils_inet6_ntop, function in nm-utils
@@ -5158,132 +4925,132 @@
-nm_utils_init, function in nm-utils +nm_utils_init, function in nm-utils
-nm_utils_ip4_addresses_from_gvalue, function in nm-utils +nm_utils_ip4_addresses_from_gvalue, function in nm-utils
-nm_utils_ip4_addresses_to_gvalue, function in nm-utils +nm_utils_ip4_addresses_to_gvalue, function in nm-utils
-nm_utils_ip4_get_default_prefix, function in nm-utils +nm_utils_ip4_get_default_prefix, function in nm-utils
-nm_utils_ip4_netmask_to_prefix, function in nm-utils +nm_utils_ip4_netmask_to_prefix, function in nm-utils
-nm_utils_ip4_prefix_to_netmask, function in nm-utils +nm_utils_ip4_prefix_to_netmask, function in nm-utils
-nm_utils_ip4_routes_from_gvalue, function in nm-utils +nm_utils_ip4_routes_from_gvalue, function in nm-utils
-nm_utils_ip4_routes_to_gvalue, function in nm-utils +nm_utils_ip4_routes_to_gvalue, function in nm-utils
-nm_utils_ip6_addresses_from_gvalue, function in nm-utils +nm_utils_ip6_addresses_from_gvalue, function in nm-utils
-nm_utils_ip6_addresses_to_gvalue, function in nm-utils +nm_utils_ip6_addresses_to_gvalue, function in nm-utils
-nm_utils_ip6_dns_from_gvalue, function in nm-utils +nm_utils_ip6_dns_from_gvalue, function in nm-utils
-nm_utils_ip6_dns_to_gvalue, function in nm-utils +nm_utils_ip6_dns_to_gvalue, function in nm-utils
-nm_utils_ip6_routes_from_gvalue, function in nm-utils +nm_utils_ip6_routes_from_gvalue, function in nm-utils
-nm_utils_ip6_routes_to_gvalue, function in nm-utils +nm_utils_ip6_routes_to_gvalue, function in nm-utils
-nm_utils_is_empty_ssid, function in nm-utils +nm_utils_is_empty_ssid, function in nm-utils
-nm_utils_is_uuid, function in nm-utils +nm_utils_is_uuid, function in nm-utils
-nm_utils_rsa_key_encrypt, function in nm-utils +nm_utils_rsa_key_encrypt, function in nm-utils
-nm_utils_rsa_key_encrypt_aes, function in nm-utils +nm_utils_rsa_key_encrypt_aes, function in nm-utils
-nm_utils_same_ssid, function in nm-utils +nm_utils_same_ssid, function in nm-utils
-nm_utils_security_valid, function in nm-utils +nm_utils_security_valid, function in nm-utils
-nm_utils_slist_free, function in nm-utils +nm_utils_slist_free, function in nm-utils
-nm_utils_ssid_to_utf8, function in nm-utils +nm_utils_ssid_to_utf8, function in nm-utils
-nm_utils_uuid_generate, function in nm-utils +nm_utils_uuid_generate, function in nm-utils
-nm_utils_uuid_generate_from_string, function in nm-utils +nm_utils_uuid_generate_from_string, function in nm-utils
-nm_utils_wep_key_valid, function in nm-utils +nm_utils_wep_key_valid, function in nm-utils
-nm_utils_wifi_channel_to_freq, function in nm-utils +nm_utils_wifi_channel_to_freq, function in nm-utils
-nm_utils_wifi_find_next_channel, function in nm-utils +nm_utils_wifi_find_next_channel, function in nm-utils
-nm_utils_wifi_freq_to_channel, function in nm-utils +nm_utils_wifi_freq_to_channel, function in nm-utils
-nm_utils_wifi_is_channel_valid, function in nm-utils +nm_utils_wifi_is_channel_valid, function in nm-utils
-nm_utils_wpa_psk_valid, function in nm-utils +nm_utils_wpa_psk_valid, function in nm-utils

V

-NMVlanFlags, enum in NMSettingVlan +NMVlanFlags, enum in NMSettingVlan
-NMVlanPriorityMap, enum in NMSettingVlan +NMVlanPriorityMap, enum in NMSettingVlan
@@ -5295,7 +5062,7 @@
-NMVPNIterFunc, user_function in NMSettingVPN +NMVPNIterFunc, user_function in NMSettingVPN
@@ -5448,12 +5215,12 @@

W

-NMWepKeyType, enum in NMSettingWirelessSecurity +NMWepKeyType, enum in NMSettingWirelessSecurity
+ Generated by GTK-Doc V1.21 \ No newline at end of file diff --git a/docs/libnm-util/html/ch01.html b/docs/libnm-util/html/ch01.html index 10afeae9..ef2dca61 100644 --- a/docs/libnm-util/html/ch01.html +++ b/docs/libnm-util/html/ch01.html @@ -2,22 +2,22 @@ -libnm-util API Reference +libnm-util Reference Manual: libnm-util API Reference - + - - - - - - + + + + + +

@@ -123,6 +123,6 @@ that require PPP to deliver IP capability

+ Generated by GTK-Doc V1.21
\ No newline at end of file diff --git a/docs/libnm-util/html/home.png b/docs/libnm-util/html/home.png index 17003611..9346b336 100644 Binary files a/docs/libnm-util/html/home.png and b/docs/libnm-util/html/home.png differ diff --git a/docs/libnm-util/html/index.html b/docs/libnm-util/html/index.html index 05c28f08..36815443 100644 --- a/docs/libnm-util/html/index.html +++ b/docs/libnm-util/html/index.html @@ -2,11 +2,11 @@ -libnm-util Reference Manual +libnm-util Reference Manual: libnm-util Reference Manual - + @@ -15,7 +15,7 @@

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

+ Generated by GTK-Doc V1.21
\ No newline at end of file diff --git a/docs/libnm-util/html/index.sgml b/docs/libnm-util/html/index.sgml index e0959317..417ba768 100644 --- a/docs/libnm-util/html/index.sgml +++ b/docs/libnm-util/html/index.sgml @@ -1,27 +1,14 @@ - - - + + + + - - - - - - - - - - - - - + - - @@ -80,6 +67,15 @@ + + + + + + + + + @@ -87,62 +83,26 @@ - - - - - - - + + + + - - - - - - - + - - - - - - - - - - - - - - - - - - - - - - - - - - - @@ -153,39 +113,26 @@ + + + + + + + + + - - - + + + + - - - - - - - - - + - - - - - - - - - - - - - - - @@ -210,6 +157,24 @@ + + + + + + + + + + + + + + + + + + @@ -225,32 +190,14 @@ - - - + + + + - - - - - - - + - - - - - - - - - - - - - @@ -274,6 +221,21 @@ + + + + + + + + + + + + + + + @@ -287,40 +249,14 @@ - - - + + + + - - - - - - - - - + - - - - - - - - - - - - - - - - - - - @@ -345,6 +281,27 @@ + + + + + + + + + + + + + + + + + + + + + @@ -361,48 +318,14 @@ - - - - + + + + - - - - - - - - - - - + - - - - - - - - - - - - - - - - - - - - - - - - @@ -434,6 +357,28 @@ + + + + + + + + + + + + + + + + + + + + + + @@ -453,60 +398,52 @@ - - - + + + + - + + + + + + - - - - - + - - - - - - - - - + + + + - - - - - - - - + - - - - - - - + + + + + + + + + @@ -514,91 +451,42 @@ - - - + + + + - - - - - - - - + - - - - - - + + + + + + + + - - - - - + + + + - - - - - - - - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - @@ -611,6 +499,23 @@ + + + + + + + + + + + + + + + + + @@ -624,45 +529,49 @@ - - - + + + + - - - - - - - + - - - - + + + + + + - - - + + + + - + + + + + + + + + + + + + - - - - - - + - @@ -680,45 +589,18 @@ - - - - - - - - - - - - - - - + + + + - - - - - - - + - - - - - - - - - - @@ -728,6 +610,18 @@ + + + + + + + + + + + + @@ -738,120 +632,105 @@ - - - + + + + - - - - - - - + - - - - - + + + + + + + - - - + + + + - - - - - - - + - - - - + + + + + + - - - + + + + - - - - - - - + - - - + + + + + - - + + + - - - - - - - + - - + + + + - - - + + + + - - - - - - - + - - - - - - - + + + + + + + + + @@ -859,37 +738,14 @@ - - - - - + + + + - - - - - - - - + - - - - - - - - - - - - - - - @@ -903,6 +759,18 @@ + + + + + + + + + + + + @@ -911,46 +779,49 @@ - - - + + + - - - - - - - + - - - - - + + + + + + + - - - + + + + - + + + + + + + + + + + - - - - + - @@ -963,16 +834,6 @@ - - - - - - - - - - @@ -982,44 +843,14 @@ - - - - + + + + - - - - - - - + - - - - - - - - - - - - - - - - - - - - - - - - @@ -1042,6 +873,28 @@ + + + + + + + + + + + + + + + + + + + + + + @@ -1059,64 +912,14 @@ - - - - - + + + + - - - - - - - - - - - - - - - - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - @@ -1185,6 +988,44 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + @@ -1219,41 +1060,16 @@ - - + + + - + - - - - - - - - + - - - - - - - - - - - - - - - - - - - @@ -1265,7 +1081,6 @@ - @@ -1279,8 +1094,6 @@ - - @@ -1315,6 +1128,28 @@ + + + + + + + + + + + + + + + + + + + + + + @@ -1330,47 +1165,16 @@ - - - + + + - + - - - - - - - - + - - - - - - - - - - - - - - - - - - - - - - - - @@ -1382,7 +1186,6 @@ - @@ -1396,8 +1199,6 @@ - - @@ -1431,6 +1232,29 @@ + + + + + + + + + + + + + + + + + + + + + + + @@ -1445,40 +1269,14 @@ - - - + + + + - - - - - - - - + - - - - - - - - - - - - - - - - - - - - @@ -1498,6 +1296,28 @@ + + + + + + + + + + + + + + + + + + + + + + @@ -1518,57 +1338,41 @@ - - - + + + + - - - - - - - - + - - - - - - + + + + + + + + - - - + + + + - - - - - - - + - - - - - - - @@ -1584,6 +1388,15 @@ + + + + + + + + + @@ -1591,11 +1404,12 @@ - - + + + - + @@ -1604,16 +1418,6 @@ - - - - - - - - - - @@ -1642,7 +1446,6 @@ - @@ -1656,14 +1459,18 @@ - + + + + - + - + + @@ -1705,169 +1512,24 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + - + + @@ -1894,39 +1556,9 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - diff --git a/docs/libnm-util/html/left-insensitive.png b/docs/libnm-util/html/left-insensitive.png new file mode 100644 index 00000000..3269393a Binary files /dev/null and b/docs/libnm-util/html/left-insensitive.png differ diff --git a/docs/libnm-util/html/left.png b/docs/libnm-util/html/left.png index 2d05b3d5..2abde032 100644 Binary files a/docs/libnm-util/html/left.png and b/docs/libnm-util/html/left.png differ diff --git a/docs/libnm-util/html/libnm-util-NetworkManager.html b/docs/libnm-util/html/libnm-util-NetworkManager.html index 4d8444fa..bbad114b 100644 --- a/docs/libnm-util/html/libnm-util-NetworkManager.html +++ b/docs/libnm-util/html/libnm-util-NetworkManager.html @@ -2,30 +2,26 @@ -NetworkManager +libnm-util Reference Manual: NetworkManager - + - - - - - - - - - - + + + + + + +
@@ -33,65 +29,234 @@

NetworkManager

NetworkManager

- +
-
-

Synopsis

-
#define             NM_DBUS_SERVICE
-#define             NM_DBUS_PATH
-#define             NM_DBUS_INTERFACE
-#define             NM_DBUS_INTERFACE_DEVICE
-#define             NM_DBUS_INTERFACE_DEVICE_WIRED
-#define             NM_DBUS_INTERFACE_DEVICE_ADSL
-#define             NM_DBUS_INTERFACE_DEVICE_WIRELESS
-#define             NM_DBUS_INTERFACE_DEVICE_BLUETOOTH
-#define             NM_DBUS_INTERFACE_DEVICE_OLPC_MESH
-#define             NM_DBUS_PATH_ACCESS_POINT
-#define             NM_DBUS_INTERFACE_ACCESS_POINT
-#define             NM_DBUS_INTERFACE_DEVICE_MODEM
-#define             NM_DBUS_INTERFACE_DEVICE_WIMAX
-#define             NM_DBUS_INTERFACE_WIMAX_NSP
-#define             NM_DBUS_PATH_WIMAX_NSP
-#define             NM_DBUS_INTERFACE_ACTIVE_CONNECTION
-#define             NM_DBUS_INTERFACE_IP4_CONFIG
-#define             NM_DBUS_INTERFACE_DHCP4_CONFIG
-#define             NM_DBUS_INTERFACE_IP6_CONFIG
-#define             NM_DBUS_INTERFACE_DHCP6_CONFIG
-#define             NM_DBUS_INTERFACE_DEVICE_INFINIBAND
-#define             NM_DBUS_INTERFACE_DEVICE_BOND
-#define             NM_DBUS_INTERFACE_DEVICE_TEAM
-#define             NM_DBUS_INTERFACE_DEVICE_VLAN
-#define             NM_DBUS_INTERFACE_DEVICE_BRIDGE
-#define             NM_DBUS_INTERFACE_DEVICE_GENERIC
-#define             NM_DBUS_INTERFACE_DEVICE_VETH
-#define             NM_DBUS_INTERFACE_DEVICE_TUN
-#define             NM_DBUS_INTERFACE_DEVICE_MACVLAN
-#define             NM_DBUS_INTERFACE_DEVICE_VXLAN
-#define             NM_DBUS_INTERFACE_DEVICE_GRE
-#define             NM_DBUS_IFACE_SETTINGS
-#define             NM_DBUS_PATH_SETTINGS
-#define             NM_DBUS_IFACE_SETTINGS_CONNECTION
-#define             NM_DBUS_PATH_SETTINGS_CONNECTION
-#define             NM_DBUS_IFACE_SETTINGS_CONNECTION_SECRETS
-#define             NM_DBUS_INTERFACE_AGENT_MANAGER
-#define             NM_DBUS_PATH_AGENT_MANAGER
-#define             NM_DBUS_INTERFACE_SECRET_AGENT
-#define             NM_DBUS_PATH_SECRET_AGENT
-enum                NMState;
-#define             NM_STATE_CONNECTED
-enum                NMConnectivityState;
-enum                NMDeviceType;
-enum                NMDeviceCapabilities;
-enum                NMDeviceWifiCapabilities;
-enum                NM80211ApFlags;
-enum                NM80211ApSecurityFlags;
-enum                NM80211Mode;
-enum                NMBluetoothCapabilities;
-enum                NMDeviceModemCapabilities;
-enum                NMDeviceState;
-enum                NMDeviceStateReason;
-enum                NMActiveConnectionState;
-
+
+

Types and Values

+
++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
#defineNM_DBUS_SERVICE
#defineNM_DBUS_PATH
#defineNM_DBUS_INTERFACE
#defineNM_DBUS_INTERFACE_DEVICE
#defineNM_DBUS_INTERFACE_DEVICE_WIRED
#defineNM_DBUS_INTERFACE_DEVICE_ADSL
#defineNM_DBUS_INTERFACE_DEVICE_WIRELESS
#defineNM_DBUS_INTERFACE_DEVICE_BLUETOOTH
#defineNM_DBUS_INTERFACE_DEVICE_OLPC_MESH
#defineNM_DBUS_PATH_ACCESS_POINT
#defineNM_DBUS_INTERFACE_ACCESS_POINT
#defineNM_DBUS_INTERFACE_DEVICE_MODEM
#defineNM_DBUS_INTERFACE_DEVICE_WIMAX
#defineNM_DBUS_INTERFACE_WIMAX_NSP
#defineNM_DBUS_PATH_WIMAX_NSP
#defineNM_DBUS_INTERFACE_ACTIVE_CONNECTION
#defineNM_DBUS_INTERFACE_IP4_CONFIG
#defineNM_DBUS_INTERFACE_DHCP4_CONFIG
#defineNM_DBUS_INTERFACE_IP6_CONFIG
#defineNM_DBUS_INTERFACE_DHCP6_CONFIG
#defineNM_DBUS_INTERFACE_DEVICE_INFINIBAND
#defineNM_DBUS_INTERFACE_DEVICE_BOND
#defineNM_DBUS_INTERFACE_DEVICE_TEAM
#defineNM_DBUS_INTERFACE_DEVICE_VLAN
#defineNM_DBUS_INTERFACE_DEVICE_BRIDGE
#defineNM_DBUS_INTERFACE_DEVICE_GENERIC
#defineNM_DBUS_INTERFACE_DEVICE_VETH
#defineNM_DBUS_INTERFACE_DEVICE_TUN
#defineNM_DBUS_INTERFACE_DEVICE_MACVLAN
#defineNM_DBUS_INTERFACE_DEVICE_VXLAN
#defineNM_DBUS_INTERFACE_DEVICE_GRE
#defineNM_DBUS_IFACE_SETTINGS
#defineNM_DBUS_PATH_SETTINGS
#defineNM_DBUS_IFACE_SETTINGS_CONNECTION
#defineNM_DBUS_PATH_SETTINGS_CONNECTION
#defineNM_DBUS_IFACE_SETTINGS_CONNECTION_SECRETS
#defineNM_DBUS_INTERFACE_AGENT_MANAGER
#defineNM_DBUS_PATH_AGENT_MANAGER
#defineNM_DBUS_INTERFACE_SECRET_AGENT
#defineNM_DBUS_PATH_SECRET_AGENT
enumNMState
#defineNM_STATE_CONNECTED
enumNMConnectivityState
enumNMDeviceType
enumNMDeviceCapabilities
enumNMDeviceWifiCapabilities
enumNM80211ApFlags
enumNM80211ApSecurityFlags
enumNM80211Mode
enumNMBluetoothCapabilities
enumNMDeviceModemCapabilities
enumNMDeviceState
enumNMDeviceStateReason
enumNMActiveConnectionState

Description

@@ -99,7 +264,10 @@ enum -

Details

+

Functions

+
+
+

Types and Values

NM_DBUS_SERVICE

#define NM_DBUS_SERVICE                     "org.freedesktop.NetworkManager"
@@ -422,72 +590,77 @@ enum                
 

enum NMState

-
typedef enum {
-	NM_STATE_UNKNOWN          = 0,
-	NM_STATE_ASLEEP           = 10,
-	NM_STATE_DISCONNECTED     = 20,
-	NM_STATE_DISCONNECTING    = 30,
-	NM_STATE_CONNECTING       = 40,
-	NM_STATE_CONNECTED_LOCAL  = 50,
-	NM_STATE_CONNECTED_SITE   = 60,
-	NM_STATE_CONNECTED_GLOBAL = 70
-} NMState;
-
-

-NMState values indicate the current overall networking state. -

-

-(Corresponds to the NM_STATE type in nm-manager.xml.) -

-
+

NMState values indicate the current overall networking state.

+

(Corresponds to the NM_STATE type in nm-manager.xml.)

+
+

Members

+
--+++ - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + +

NM_STATE_UNKNOWN

networking state is unknown +

NM_STATE_UNKNOWN

+

networking state is unknown

 

NM_STATE_ASLEEP

networking is not enabled +

NM_STATE_ASLEEP

+

networking is not enabled

 

NM_STATE_DISCONNECTED

there is no active network connection +

NM_STATE_DISCONNECTED

+

there is no active network connection

 

NM_STATE_DISCONNECTING

network connections are being cleaned up +

NM_STATE_DISCONNECTING

+

network connections are being cleaned up

 

NM_STATE_CONNECTING

a network connection is being started +

NM_STATE_CONNECTING

+

a network connection is being started

 

NM_STATE_CONNECTED_LOCAL

there is only local IPv4 and/or IPv6 connectivity +

NM_STATE_CONNECTED_LOCAL

+

there is only local IPv4 and/or IPv6 connectivity

 

NM_STATE_CONNECTED_SITE

there is only site-wide IPv4 and/or IPv6 connectivity +

NM_STATE_CONNECTED_SITE

+

there is only site-wide IPv4 and/or IPv6 connectivity

 

NM_STATE_CONNECTED_GLOBAL

there is global IPv4 and/or IPv6 Internet connectivity +

NM_STATE_CONNECTED_GLOBAL

+

there is global IPv4 and/or IPv6 Internet connectivity

 
+

NM_STATE_CONNECTED

@@ -499,1137 +672,1268 @@ enum

enum NMConnectivityState

-
typedef enum {
-	NM_CONNECTIVITY_UNKNOWN,
-	NM_CONNECTIVITY_NONE,
-	NM_CONNECTIVITY_PORTAL,
-	NM_CONNECTIVITY_LIMITED,
-	NM_CONNECTIVITY_FULL
-} NMConnectivityState;
-
-

-(Corresponds to the NM_CONNECTIVITY type in nm-manager.xml.) -

-
+

(Corresponds to the NM_CONNECTIVITY type in nm-manager.xml.)

+
+

Members

+
--+++ - - + + - - + + - - + + - - + + - - + +

NM_CONNECTIVITY_UNKNOWN

Network connectivity is unknown. +

NM_CONNECTIVITY_UNKNOWN

+

Network connectivity is unknown.

 

NM_CONNECTIVITY_NONE

The host is not connected to any network. +

NM_CONNECTIVITY_NONE

+

The host is not connected to any network.

 

NM_CONNECTIVITY_PORTAL

The host is behind a captive portal and - cannot reach the full Internet. +

NM_CONNECTIVITY_PORTAL

+

The host is behind a captive portal and + cannot reach the full Internet.

 

NM_CONNECTIVITY_LIMITED

The host is connected to a network, but - does not appear to be able to reach the full Internet. +

NM_CONNECTIVITY_LIMITED

+

The host is connected to a network, but + does not appear to be able to reach the full Internet.

 

NM_CONNECTIVITY_FULL

The host is connected to a network, and - appears to be able to reach the full Internet. +

NM_CONNECTIVITY_FULL

+

The host is connected to a network, and + appears to be able to reach the full Internet.

 
+

Since 0.9.8.6


enum NMDeviceType

-
typedef enum {
-	NM_DEVICE_TYPE_UNKNOWN    = 0,
-	NM_DEVICE_TYPE_ETHERNET   = 1,
-	NM_DEVICE_TYPE_WIFI       = 2,
-	NM_DEVICE_TYPE_UNUSED1    = 3,
-	NM_DEVICE_TYPE_UNUSED2    = 4,
-	NM_DEVICE_TYPE_BT         = 5,  /* Bluetooth */
-	NM_DEVICE_TYPE_OLPC_MESH  = 6,
-	NM_DEVICE_TYPE_WIMAX      = 7,
-	NM_DEVICE_TYPE_MODEM      = 8,
-	NM_DEVICE_TYPE_INFINIBAND = 9,
-	NM_DEVICE_TYPE_BOND       = 10,
-	NM_DEVICE_TYPE_VLAN       = 11,
-	NM_DEVICE_TYPE_ADSL       = 12,
-	NM_DEVICE_TYPE_BRIDGE     = 13,
-	NM_DEVICE_TYPE_GENERIC    = 14,
-	NM_DEVICE_TYPE_TEAM       = 15,
-} NMDeviceType;
-
-

-NMDeviceType values indicate the type of hardware represented by -an NMDevice. -

-

-(Corresponds to the NM_DEVICE_TYPE type in nm-device.xml.) -

-
+

NMDeviceType values indicate the type of hardware represented by +an NMDevice.

+

(Corresponds to the NM_DEVICE_TYPE type in nm-device.xml.)

+
+

Members

+
--+++ - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + +

NM_DEVICE_TYPE_UNKNOWN

unknown device +

NM_DEVICE_TYPE_UNKNOWN

+

unknown device

 

NM_DEVICE_TYPE_ETHERNET

a wired ethernet device +

NM_DEVICE_TYPE_ETHERNET

+

a wired ethernet device

 

NM_DEVICE_TYPE_WIFI

an 802.11 WiFi device +

NM_DEVICE_TYPE_WIFI

+

an 802.11 WiFi device

 

NM_DEVICE_TYPE_UNUSED1

not used +

NM_DEVICE_TYPE_UNUSED1

+

not used

 

NM_DEVICE_TYPE_UNUSED2

not used +

NM_DEVICE_TYPE_UNUSED2

+

not used

 

NM_DEVICE_TYPE_BT

a Bluetooth device supporting PAN or DUN access protocols +

NM_DEVICE_TYPE_BT

+

a Bluetooth device supporting PAN or DUN access protocols

 

NM_DEVICE_TYPE_OLPC_MESH

an OLPC XO mesh networking device +

NM_DEVICE_TYPE_OLPC_MESH

+

an OLPC XO mesh networking device

 

NM_DEVICE_TYPE_WIMAX

an 802.16e Mobile WiMAX broadband device +

NM_DEVICE_TYPE_WIMAX

+

an 802.16e Mobile WiMAX broadband device

 

NM_DEVICE_TYPE_MODEM

a modem supporting analog telephone, CDMA/EVDO, -GSM/UMTS, or LTE network access protocols +

NM_DEVICE_TYPE_MODEM

+

a modem supporting analog telephone, CDMA/EVDO, +GSM/UMTS, or LTE network access protocols

 

NM_DEVICE_TYPE_INFINIBAND

an IP-over-InfiniBand device +

NM_DEVICE_TYPE_INFINIBAND

+

an IP-over-InfiniBand device

 

NM_DEVICE_TYPE_BOND

a bond master interface +

NM_DEVICE_TYPE_BOND

+

a bond master interface

 

NM_DEVICE_TYPE_VLAN

an 802.1Q VLAN interface +

NM_DEVICE_TYPE_VLAN

+

an 802.1Q VLAN interface

 

NM_DEVICE_TYPE_ADSL

ADSL modem +

NM_DEVICE_TYPE_ADSL

+

ADSL modem

 

NM_DEVICE_TYPE_BRIDGE

a bridge master interface +

NM_DEVICE_TYPE_BRIDGE

+

a bridge master interface

 

NM_DEVICE_TYPE_GENERIC

generic support for unrecognized device types +

NM_DEVICE_TYPE_GENERIC

+

generic support for unrecognized device types

 

NM_DEVICE_TYPE_TEAM

a team master interface +

NM_DEVICE_TYPE_TEAM

+

a team master interface

 
+

enum NMDeviceCapabilities

-
typedef enum {
-	NM_DEVICE_CAP_NONE           = 0x00000000,
-	NM_DEVICE_CAP_NM_SUPPORTED   = 0x00000001,
-	NM_DEVICE_CAP_CARRIER_DETECT = 0x00000002,
-	NM_DEVICE_CAP_IS_SOFTWARE    = 0x00000004,
-} NMDeviceCapabilities;
-
-

-General device capability flags. -

-

-(Corresponds to the NM_DEVICE_CAP type in nm-device-wifi.xml.) -

-
+

General device capability flags.

+

(Corresponds to the NM_DEVICE_CAP type in nm-device-wifi.xml.)

+
+

Members

+
--+++ - - + + - - + + - - + + - - + +

NM_DEVICE_CAP_NONE

device has no special capabilities +

NM_DEVICE_CAP_NONE

+

device has no special capabilities

 

NM_DEVICE_CAP_NM_SUPPORTED

NetworkManager supports this device +

NM_DEVICE_CAP_NM_SUPPORTED

+

NetworkManager supports this device

 

NM_DEVICE_CAP_CARRIER_DETECT

this device can indicate carrier status +

NM_DEVICE_CAP_CARRIER_DETECT

+

this device can indicate carrier status

 

NM_DEVICE_CAP_IS_SOFTWARE

this device is a software device +

NM_DEVICE_CAP_IS_SOFTWARE

+

this device is a software device

 
+

enum NMDeviceWifiCapabilities

-
typedef enum {
-	NM_WIFI_DEVICE_CAP_NONE          = 0x00000000,
-	NM_WIFI_DEVICE_CAP_CIPHER_WEP40  = 0x00000001,
-	NM_WIFI_DEVICE_CAP_CIPHER_WEP104 = 0x00000002,
-	NM_WIFI_DEVICE_CAP_CIPHER_TKIP   = 0x00000004,
-	NM_WIFI_DEVICE_CAP_CIPHER_CCMP   = 0x00000008,
-	NM_WIFI_DEVICE_CAP_WPA           = 0x00000010,
-	NM_WIFI_DEVICE_CAP_RSN           = 0x00000020,
-	NM_WIFI_DEVICE_CAP_AP            = 0x00000040,
-	NM_WIFI_DEVICE_CAP_ADHOC         = 0x00000080
-} NMDeviceWifiCapabilities;
-
-

-802.11 specific device encryption and authentication capabilities. -

-

-(Corresponds to the NM_802_11_DEVICE_CAP type in nm-device-wifi.xml.) -

-
+

802.11 specific device encryption and authentication capabilities.

+

(Corresponds to the NM_802_11_DEVICE_CAP type in nm-device-wifi.xml.)

+
+

Members

+
--+++ - - + + + + + + + + + + + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + + + + + +

NM_WIFI_DEVICE_CAP_NONE

device has no encryption/authentication capabilities +

NM_WIFI_DEVICE_CAP_NONE

+

device has no encryption/authentication capabilities

+
 

NM_WIFI_DEVICE_CAP_CIPHER_WEP40

+

device supports 40/64-bit WEP encryption

+
 

NM_WIFI_DEVICE_CAP_CIPHER_WEP104

+

device supports 104/128-bit WEP encryption

 

NM_WIFI_DEVICE_CAP_CIPHER_WEP40

device supports 40/64-bit WEP encryption +

NM_WIFI_DEVICE_CAP_CIPHER_TKIP

+

device supports TKIP encryption

 

NM_WIFI_DEVICE_CAP_CIPHER_WEP104

device supports 104/128-bit WEP encryption +

NM_WIFI_DEVICE_CAP_CIPHER_CCMP

+

device supports AES/CCMP encryption

 

NM_WIFI_DEVICE_CAP_CIPHER_TKIP

device supports TKIP encryption +

NM_WIFI_DEVICE_CAP_WPA

+

device supports WPA1 authentication

 

NM_WIFI_DEVICE_CAP_CIPHER_CCMP

device supports AES/CCMP encryption +

NM_WIFI_DEVICE_CAP_RSN

+

device supports WPA2/RSN authentication

 

NM_WIFI_DEVICE_CAP_WPA

device supports WPA1 authentication +

NM_WIFI_DEVICE_CAP_AP

+

device supports Access Point mode

 

NM_WIFI_DEVICE_CAP_RSN

device supports WPA2/RSN authentication +

NM_WIFI_DEVICE_CAP_ADHOC

+

device supports Ad-Hoc mode

 

NM_WIFI_DEVICE_CAP_AP

device supports Access Point mode +

NM_WIFI_DEVICE_CAP_FREQ_VALID

+

device reports frequency capabilities

 

NM_WIFI_DEVICE_CAP_ADHOC

device supports Ad-Hoc mode +

NM_WIFI_DEVICE_CAP_FREQ_2GHZ

+

device supports 2.4GHz frequencies

 

NM_WIFI_DEVICE_CAP_FREQ_5GHZ

+

device supports 5GHz frequencies

+
 
+

enum NM80211ApFlags

-
typedef enum {
-	NM_802_11_AP_FLAGS_NONE    = 0x00000000,
-	NM_802_11_AP_FLAGS_PRIVACY = 0x00000001
-} NM80211ApFlags;
-
-

-802.11 access point flags. -

-

-(Corresponds to the NM_802_11_AP_FLAGS type in nm-access-point.xml.) -

-
+

802.11 access point flags.

+

(Corresponds to the NM_802_11_AP_FLAGS type in nm-access-point.xml.)

+
+

Members

+
--+++ - - + + - - + +

NM_802_11_AP_FLAGS_NONE

access point has no special capabilities +

NM_802_11_AP_FLAGS_NONE

+

access point has no special capabilities

 

NM_802_11_AP_FLAGS_PRIVACY

access point requires authentication and -encryption (usually means WEP) +

NM_802_11_AP_FLAGS_PRIVACY

+

access point requires authentication and +encryption (usually means WEP)

 
+

enum NM80211ApSecurityFlags

-
typedef enum {
-	NM_802_11_AP_SEC_NONE            = 0x00000000,
-	NM_802_11_AP_SEC_PAIR_WEP40      = 0x00000001,
-	NM_802_11_AP_SEC_PAIR_WEP104     = 0x00000002,
-	NM_802_11_AP_SEC_PAIR_TKIP       = 0x00000004,
-	NM_802_11_AP_SEC_PAIR_CCMP       = 0x00000008,
-	NM_802_11_AP_SEC_GROUP_WEP40     = 0x00000010,
-	NM_802_11_AP_SEC_GROUP_WEP104    = 0x00000020,
-	NM_802_11_AP_SEC_GROUP_TKIP      = 0x00000040,
-	NM_802_11_AP_SEC_GROUP_CCMP      = 0x00000080,
-	NM_802_11_AP_SEC_KEY_MGMT_PSK    = 0x00000100,
-	NM_802_11_AP_SEC_KEY_MGMT_802_1X = 0x00000200
-} NM80211ApSecurityFlags;
-
-

-802.11 access point security and authentication flags. These flags describe +

802.11 access point security and authentication flags. These flags describe the current security requirements of an access point as determined from the -access point's beacon. -

-

-(Corresponds to the NM_802_11_AP_SEC type in nm-access-point.xml.) -

-
+access point's beacon.

+

(Corresponds to the NM_802_11_AP_SEC type in nm-access-point.xml.)

+
+

Members

+
--+++ - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + +

NM_802_11_AP_SEC_NONE

the access point has no special security requirements +

NM_802_11_AP_SEC_NONE

+

the access point has no special security requirements

 

NM_802_11_AP_SEC_PAIR_WEP40

40/64-bit WEP is supported for -pairwise/unicast encryption +

NM_802_11_AP_SEC_PAIR_WEP40

+

40/64-bit WEP is supported for +pairwise/unicast encryption

 

NM_802_11_AP_SEC_PAIR_WEP104

104/128-bit WEP is supported for -pairwise/unicast encryption +

NM_802_11_AP_SEC_PAIR_WEP104

+

104/128-bit WEP is supported for +pairwise/unicast encryption

 

NM_802_11_AP_SEC_PAIR_TKIP

TKIP is supported for pairwise/unicast encryption +

NM_802_11_AP_SEC_PAIR_TKIP

+

TKIP is supported for pairwise/unicast encryption

 

NM_802_11_AP_SEC_PAIR_CCMP

AES/CCMP is supported for pairwise/unicast encryption +

NM_802_11_AP_SEC_PAIR_CCMP

+

AES/CCMP is supported for pairwise/unicast encryption

 

NM_802_11_AP_SEC_GROUP_WEP40

40/64-bit WEP is supported for group/broadcast -encryption +

NM_802_11_AP_SEC_GROUP_WEP40

+

40/64-bit WEP is supported for group/broadcast +encryption

 

NM_802_11_AP_SEC_GROUP_WEP104

104/128-bit WEP is supported for -group/broadcast encryption +

NM_802_11_AP_SEC_GROUP_WEP104

+

104/128-bit WEP is supported for +group/broadcast encryption

 

NM_802_11_AP_SEC_GROUP_TKIP

TKIP is supported for group/broadcast encryption +

NM_802_11_AP_SEC_GROUP_TKIP

+

TKIP is supported for group/broadcast encryption

 

NM_802_11_AP_SEC_GROUP_CCMP

AES/CCMP is supported for group/broadcast -encryption +

NM_802_11_AP_SEC_GROUP_CCMP

+

AES/CCMP is supported for group/broadcast +encryption

 

NM_802_11_AP_SEC_KEY_MGMT_PSK

WPA/RSN Pre-Shared Key encryption is -supported +

NM_802_11_AP_SEC_KEY_MGMT_PSK

+

WPA/RSN Pre-Shared Key encryption is +supported

 

NM_802_11_AP_SEC_KEY_MGMT_802_1X

802.1x authentication and key management -is supported +

NM_802_11_AP_SEC_KEY_MGMT_802_1X

+

802.1x authentication and key management +is supported

 
+

enum NM80211Mode

-
typedef enum {
-	NM_802_11_MODE_UNKNOWN = 0,
-	NM_802_11_MODE_ADHOC,
-	NM_802_11_MODE_INFRA,
-	NM_802_11_MODE_AP
-} NM80211Mode;
-
-

-Indicates the 802.11 mode an access point or device is currently in. -

-

-(Corresponds to the NM_802_11_MODE type in generic-types.xml.) -

-
+

Indicates the 802.11 mode an access point or device is currently in.

+

(Corresponds to the NM_802_11_MODE type in generic-types.xml.)

+
+

Members

+
--+++ - - + + - - + + - - + + - - + +

NM_802_11_MODE_UNKNOWN

the device or access point mode is unknown +

NM_802_11_MODE_UNKNOWN

+

the device or access point mode is unknown

 

NM_802_11_MODE_ADHOC

for both devices and access point objects, indicates +

NM_802_11_MODE_ADHOC

+

for both devices and access point objects, indicates the object is part of an Ad-Hoc 802.11 network without a central - coordinating access point. + coordinating access point.

 

NM_802_11_MODE_INFRA

the device or access point is in infrastructure mode. +

NM_802_11_MODE_INFRA

+

the device or access point is in infrastructure mode. For devices, this indicates the device is an 802.11 client/station. For access point objects, this indicates the object is an access point that - provides connectivity to clients. + provides connectivity to clients.

 

NM_802_11_MODE_AP

the device is an access point/hotspot. Not valid for - access point objects; used only for hotspot mode on the local machine. +

NM_802_11_MODE_AP

+

the device is an access point/hotspot. Not valid for + access point objects; used only for hotspot mode on the local machine.

 
+

enum NMBluetoothCapabilities

-
typedef enum {
-	NM_BT_CAPABILITY_NONE = 0x00000000,
-	NM_BT_CAPABILITY_DUN  = 0x00000001,
-	NM_BT_CAPABILITY_NAP  = 0x00000002,
-} NMBluetoothCapabilities;
-
-

-NMBluetoothCapabilities values indicate the usable capabilities of a -Bluetooth device. -

-

-(Corresponds to the NM_BT_CAPABILITY type in nm-device-bt.xml.) -

-
+

NMBluetoothCapabilities values indicate the usable capabilities of a +Bluetooth device.

+

(Corresponds to the NM_BT_CAPABILITY type in nm-device-bt.xml.)

+
+

Members

+
--+++ - - + + - - + + - - + +

NM_BT_CAPABILITY_NONE

device has no usable capabilities +

NM_BT_CAPABILITY_NONE

+

device has no usable capabilities

 

NM_BT_CAPABILITY_DUN

device provides Dial-Up Networking capability +

NM_BT_CAPABILITY_DUN

+

device provides Dial-Up Networking capability

 

NM_BT_CAPABILITY_NAP

device provides Network Access Point capability +

NM_BT_CAPABILITY_NAP

+

device provides Network Access Point capability

 
+

enum NMDeviceModemCapabilities

-
typedef enum {
-	NM_DEVICE_MODEM_CAPABILITY_NONE      = 0x00000000,
-	NM_DEVICE_MODEM_CAPABILITY_POTS      = 0x00000001,
-	NM_DEVICE_MODEM_CAPABILITY_CDMA_EVDO = 0x00000002,
-	NM_DEVICE_MODEM_CAPABILITY_GSM_UMTS  = 0x00000004,
-	NM_DEVICE_MODEM_CAPABILITY_LTE       = 0x00000008,
-} NMDeviceModemCapabilities;
-
-

-NMDeviceModemCapabilities values indicate the generic radio access +

NMDeviceModemCapabilities values indicate the generic radio access technology families a modem device supports. For more information on the specific access technologies the device supports use the ModemManager D-Bus -API. -

-

-(Corresponds to the NM_DEVICE_MODEM_CAPABILITY type in nm-device-modem.xml.) -

-
+API.

+

(Corresponds to the NM_DEVICE_MODEM_CAPABILITY type in nm-device-modem.xml.)

+
+

Members

+
--+++ - - + + - - + + - - + + - - + + - - + +

NM_DEVICE_MODEM_CAPABILITY_NONE

modem has no usable capabilities +

NM_DEVICE_MODEM_CAPABILITY_NONE

+

modem has no usable capabilities

 

NM_DEVICE_MODEM_CAPABILITY_POTS

modem uses the analog wired telephone -network and is not a wireless/cellular device +

NM_DEVICE_MODEM_CAPABILITY_POTS

+

modem uses the analog wired telephone +network and is not a wireless/cellular device

 

NM_DEVICE_MODEM_CAPABILITY_CDMA_EVDO

modem supports at least one of CDMA -1xRTT, EVDO revision 0, EVDO revision A, or EVDO revision B +

NM_DEVICE_MODEM_CAPABILITY_CDMA_EVDO

+

modem supports at least one of CDMA +1xRTT, EVDO revision 0, EVDO revision A, or EVDO revision B

 

NM_DEVICE_MODEM_CAPABILITY_GSM_UMTS

modem supports at least one of GSM, -GPRS, EDGE, UMTS, HSDPA, HSUPA, or HSPA+ packet switched data capability +

NM_DEVICE_MODEM_CAPABILITY_GSM_UMTS

+

modem supports at least one of GSM, +GPRS, EDGE, UMTS, HSDPA, HSUPA, or HSPA+ packet switched data capability

 

NM_DEVICE_MODEM_CAPABILITY_LTE

modem has LTE data capability +

NM_DEVICE_MODEM_CAPABILITY_LTE

+

modem has LTE data capability

 
+

enum NMDeviceState

-
typedef enum {
-	NM_DEVICE_STATE_UNKNOWN      = 0,
-	NM_DEVICE_STATE_UNMANAGED    = 10,
-	NM_DEVICE_STATE_UNAVAILABLE  = 20,
-	NM_DEVICE_STATE_DISCONNECTED = 30,
-	NM_DEVICE_STATE_PREPARE      = 40,
-	NM_DEVICE_STATE_CONFIG       = 50,
-	NM_DEVICE_STATE_NEED_AUTH    = 60,
-	NM_DEVICE_STATE_IP_CONFIG    = 70,
-	NM_DEVICE_STATE_IP_CHECK     = 80,
-	NM_DEVICE_STATE_SECONDARIES  = 90,
-	NM_DEVICE_STATE_ACTIVATED    = 100,
-	NM_DEVICE_STATE_DEACTIVATING = 110,
-	NM_DEVICE_STATE_FAILED       = 120
-} NMDeviceState;
-
-

-(Corresponds to the NM_DEVICE_STATE type in nm-device.xml.) -

-
+

(Corresponds to the NM_DEVICE_STATE type in nm-device.xml.)

+
+

Members

+
--+++ - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + +

NM_DEVICE_STATE_UNKNOWN

the device's state is unknown +

NM_DEVICE_STATE_UNKNOWN

+

the device's state is unknown

 

NM_DEVICE_STATE_UNMANAGED

the device is recognized, but not managed by - NetworkManager +

NM_DEVICE_STATE_UNMANAGED

+

the device is recognized, but not managed by + NetworkManager

 

NM_DEVICE_STATE_UNAVAILABLE

the device is managed by NetworkManager, but +

NM_DEVICE_STATE_UNAVAILABLE

+

the device is managed by NetworkManager, but is not available for use. Reasons may include the wireless switched off, missing firmware, no ethernet carrier, missing supplicant or modem manager, - etc. + etc.

 

NM_DEVICE_STATE_DISCONNECTED

the device can be activated, but is currently - idle and not connected to a network. +

NM_DEVICE_STATE_DISCONNECTED

+

the device can be activated, but is currently + idle and not connected to a network.

 

NM_DEVICE_STATE_PREPARE

the device is preparing the connection to the +

NM_DEVICE_STATE_PREPARE

+

the device is preparing the connection to the network. This may include operations like changing the MAC address, setting physical link properties, and anything else required to connect - to the requested network. + to the requested network.

 

NM_DEVICE_STATE_CONFIG

the device is connecting to the requested network. +

NM_DEVICE_STATE_CONFIG

+

the device is connecting to the requested network. This may include operations like associating with the WiFi AP, dialing - the modem, connecting to the remote Bluetooth device, etc. + the modem, connecting to the remote Bluetooth device, etc.

 

NM_DEVICE_STATE_NEED_AUTH

the device requires more information to continue +

NM_DEVICE_STATE_NEED_AUTH

+

the device requires more information to continue connecting to the requested network. This includes secrets like WiFi - passphrases, login passwords, PIN codes, etc. + passphrases, login passwords, PIN codes, etc.

 

NM_DEVICE_STATE_IP_CONFIG

the device is requesting IPv4 and/or IPv6 - addresses and routing information from the network. +

NM_DEVICE_STATE_IP_CONFIG

+

the device is requesting IPv4 and/or IPv6 + addresses and routing information from the network.

 

NM_DEVICE_STATE_IP_CHECK

the device is checking whether further action is +

NM_DEVICE_STATE_IP_CHECK

+

the device is checking whether further action is required for the requested network connection. This may include checking whether only local network access is available, whether a captive portal - is blocking access to the Internet, etc. + is blocking access to the Internet, etc.

 

NM_DEVICE_STATE_SECONDARIES

the device is waiting for a secondary +

NM_DEVICE_STATE_SECONDARIES

+

the device is waiting for a secondary connection (like a VPN) which must activated before the device can be - activated + activated

 

NM_DEVICE_STATE_ACTIVATED

the device has a network connection, either local - or global. +

NM_DEVICE_STATE_ACTIVATED

+

the device has a network connection, either local + or global.

 

NM_DEVICE_STATE_DEACTIVATING

a disconnection from the current network +

NM_DEVICE_STATE_DEACTIVATING

+

a disconnection from the current network connection was requested, and the device is cleaning up resources used for - that connection. The network connection may still be valid. + that connection. The network connection may still be valid.

 

NM_DEVICE_STATE_FAILED

the device failed to connect to the requested - network and is cleaning up the connection request +

NM_DEVICE_STATE_FAILED

+

the device failed to connect to the requested + network and is cleaning up the connection request

 
+

enum NMDeviceStateReason

-
typedef enum {
-	NM_DEVICE_STATE_REASON_NONE = 0,
-	NM_DEVICE_STATE_REASON_UNKNOWN = 1,
-	NM_DEVICE_STATE_REASON_NOW_MANAGED = 2,
-	NM_DEVICE_STATE_REASON_NOW_UNMANAGED = 3,
-	NM_DEVICE_STATE_REASON_CONFIG_FAILED = 4,
-	NM_DEVICE_STATE_REASON_IP_CONFIG_UNAVAILABLE = 5,
-	NM_DEVICE_STATE_REASON_IP_CONFIG_EXPIRED = 6,
-	NM_DEVICE_STATE_REASON_NO_SECRETS = 7,
-	NM_DEVICE_STATE_REASON_SUPPLICANT_DISCONNECT = 8,
-	NM_DEVICE_STATE_REASON_SUPPLICANT_CONFIG_FAILED = 9,
-	NM_DEVICE_STATE_REASON_SUPPLICANT_FAILED = 10,
-	NM_DEVICE_STATE_REASON_SUPPLICANT_TIMEOUT = 11,
-	NM_DEVICE_STATE_REASON_PPP_START_FAILED = 12,
-	NM_DEVICE_STATE_REASON_PPP_DISCONNECT = 13,
-	NM_DEVICE_STATE_REASON_PPP_FAILED = 14,
-	NM_DEVICE_STATE_REASON_DHCP_START_FAILED = 15,
-	NM_DEVICE_STATE_REASON_DHCP_ERROR = 16,
-	NM_DEVICE_STATE_REASON_DHCP_FAILED = 17,
-	NM_DEVICE_STATE_REASON_SHARED_START_FAILED = 18,
-	NM_DEVICE_STATE_REASON_SHARED_FAILED = 19,
-	NM_DEVICE_STATE_REASON_AUTOIP_START_FAILED = 20,
-	NM_DEVICE_STATE_REASON_AUTOIP_ERROR = 21,
-	NM_DEVICE_STATE_REASON_AUTOIP_FAILED = 22,
-	NM_DEVICE_STATE_REASON_MODEM_BUSY = 23,
-	NM_DEVICE_STATE_REASON_MODEM_NO_DIAL_TONE = 24,
-	NM_DEVICE_STATE_REASON_MODEM_NO_CARRIER = 25,
-	NM_DEVICE_STATE_REASON_MODEM_DIAL_TIMEOUT = 26,
-	NM_DEVICE_STATE_REASON_MODEM_DIAL_FAILED = 27,
-	NM_DEVICE_STATE_REASON_MODEM_INIT_FAILED = 28,
-	NM_DEVICE_STATE_REASON_GSM_APN_FAILED = 29,
-	NM_DEVICE_STATE_REASON_GSM_REGISTRATION_NOT_SEARCHING = 30,
-	NM_DEVICE_STATE_REASON_GSM_REGISTRATION_DENIED = 31,
-	NM_DEVICE_STATE_REASON_GSM_REGISTRATION_TIMEOUT = 32,
-	NM_DEVICE_STATE_REASON_GSM_REGISTRATION_FAILED = 33,
-	NM_DEVICE_STATE_REASON_GSM_PIN_CHECK_FAILED = 34,
-	NM_DEVICE_STATE_REASON_FIRMWARE_MISSING = 35,
-	NM_DEVICE_STATE_REASON_REMOVED = 36,
-	NM_DEVICE_STATE_REASON_SLEEPING = 37,
-	NM_DEVICE_STATE_REASON_CONNECTION_REMOVED = 38,
-	NM_DEVICE_STATE_REASON_USER_REQUESTED = 39,
-	NM_DEVICE_STATE_REASON_CARRIER = 40,
-	NM_DEVICE_STATE_REASON_CONNECTION_ASSUMED = 41,
-	NM_DEVICE_STATE_REASON_SUPPLICANT_AVAILABLE = 42,
-	NM_DEVICE_STATE_REASON_MODEM_NOT_FOUND = 43,
-	NM_DEVICE_STATE_REASON_BT_FAILED = 44,
-	NM_DEVICE_STATE_REASON_GSM_SIM_NOT_INSERTED = 45,
-	NM_DEVICE_STATE_REASON_GSM_SIM_PIN_REQUIRED = 46,
-	NM_DEVICE_STATE_REASON_GSM_SIM_PUK_REQUIRED = 47,
-	NM_DEVICE_STATE_REASON_GSM_SIM_WRONG = 48,
-	NM_DEVICE_STATE_REASON_INFINIBAND_MODE = 49,
-	NM_DEVICE_STATE_REASON_DEPENDENCY_FAILED = 50,
-	NM_DEVICE_STATE_REASON_BR2684_FAILED = 51,
-	NM_DEVICE_STATE_REASON_MODEM_MANAGER_UNAVAILABLE = 52,
-	NM_DEVICE_STATE_REASON_SSID_NOT_FOUND = 53,
-	NM_DEVICE_STATE_REASON_SECONDARY_CONNECTION_FAILED = 54,
-	NM_DEVICE_STATE_REASON_DCB_FCOE_FAILED = 55,
-	NM_DEVICE_STATE_REASON_TEAMD_CONTROL_FAILED = 56,
-	NM_DEVICE_STATE_REASON_MODEM_FAILED = 57,
-	NM_DEVICE_STATE_REASON_MODEM_AVAILABLE = 58,
-	NM_DEVICE_STATE_REASON_SIM_PIN_INCORRECT = 59,
-
-	NM_DEVICE_STATE_REASON_LAST = 0xFFFF
-} NMDeviceStateReason;
-
-

-Device state change reason codes -

-

-(Corresponds to the NM_DEVICE_STATE_REASON type in nm-device.xml.) -

-
+

Device state change reason codes

+

(Corresponds to the NM_DEVICE_STATE_REASON type in nm-device.xml.)

+
+

Members

+
--+++ - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + + + + + +

NM_DEVICE_STATE_REASON_NONE

No reason given +

NM_DEVICE_STATE_REASON_NONE

+

No reason given

 

NM_DEVICE_STATE_REASON_UNKNOWN

Unknown error +

NM_DEVICE_STATE_REASON_UNKNOWN

+

Unknown error

 

NM_DEVICE_STATE_REASON_NOW_MANAGED

Device is now managed +

NM_DEVICE_STATE_REASON_NOW_MANAGED

+

Device is now managed

 

NM_DEVICE_STATE_REASON_NOW_UNMANAGED

Device is now unmanaged +

NM_DEVICE_STATE_REASON_NOW_UNMANAGED

+

Device is now unmanaged

 

NM_DEVICE_STATE_REASON_CONFIG_FAILED

The device could not be readied for configuration +

NM_DEVICE_STATE_REASON_CONFIG_FAILED

+

The device could not be readied for configuration

 

NM_DEVICE_STATE_REASON_IP_CONFIG_UNAVAILABLE

IP configuration could not be reserved (no available address, timeout, etc) +

NM_DEVICE_STATE_REASON_IP_CONFIG_UNAVAILABLE

+

IP configuration could not be reserved (no available address, timeout, etc)

 

NM_DEVICE_STATE_REASON_IP_CONFIG_EXPIRED

The IP config is no longer valid +

NM_DEVICE_STATE_REASON_IP_CONFIG_EXPIRED

+

The IP config is no longer valid

 

NM_DEVICE_STATE_REASON_NO_SECRETS

Secrets were required, but not provided +

NM_DEVICE_STATE_REASON_NO_SECRETS

+

Secrets were required, but not provided

 

NM_DEVICE_STATE_REASON_SUPPLICANT_DISCONNECT

802.1x supplicant disconnected +

NM_DEVICE_STATE_REASON_SUPPLICANT_DISCONNECT

+

802.1x supplicant disconnected

 

NM_DEVICE_STATE_REASON_SUPPLICANT_CONFIG_FAILED

802.1x supplicant configuration failed +

NM_DEVICE_STATE_REASON_SUPPLICANT_CONFIG_FAILED

+

802.1x supplicant configuration failed

 

NM_DEVICE_STATE_REASON_SUPPLICANT_FAILED

802.1x supplicant failed +

NM_DEVICE_STATE_REASON_SUPPLICANT_FAILED

+

802.1x supplicant failed

 

NM_DEVICE_STATE_REASON_SUPPLICANT_TIMEOUT

802.1x supplicant took too long to authenticate +

NM_DEVICE_STATE_REASON_SUPPLICANT_TIMEOUT

+

802.1x supplicant took too long to authenticate

 

NM_DEVICE_STATE_REASON_PPP_START_FAILED

PPP service failed to start +

NM_DEVICE_STATE_REASON_PPP_START_FAILED

+

PPP service failed to start

 

NM_DEVICE_STATE_REASON_PPP_DISCONNECT

PPP service disconnected +

NM_DEVICE_STATE_REASON_PPP_DISCONNECT

+

PPP service disconnected

 

NM_DEVICE_STATE_REASON_PPP_FAILED

PPP failed +

NM_DEVICE_STATE_REASON_PPP_FAILED

+

PPP failed

 

NM_DEVICE_STATE_REASON_DHCP_START_FAILED

DHCP client failed to start +

NM_DEVICE_STATE_REASON_DHCP_START_FAILED

+

DHCP client failed to start

 

NM_DEVICE_STATE_REASON_DHCP_ERROR

DHCP client error +

NM_DEVICE_STATE_REASON_DHCP_ERROR

+

DHCP client error

 

NM_DEVICE_STATE_REASON_DHCP_FAILED

DHCP client failed +

NM_DEVICE_STATE_REASON_DHCP_FAILED

+

DHCP client failed

 

NM_DEVICE_STATE_REASON_SHARED_START_FAILED

Shared connection service failed to start +

NM_DEVICE_STATE_REASON_SHARED_START_FAILED

+

Shared connection service failed to start

 

NM_DEVICE_STATE_REASON_SHARED_FAILED

Shared connection service failed +

NM_DEVICE_STATE_REASON_SHARED_FAILED

+

Shared connection service failed

 

NM_DEVICE_STATE_REASON_AUTOIP_START_FAILED

AutoIP service failed to start +

NM_DEVICE_STATE_REASON_AUTOIP_START_FAILED

+

AutoIP service failed to start

 

NM_DEVICE_STATE_REASON_AUTOIP_ERROR

AutoIP service error +

NM_DEVICE_STATE_REASON_AUTOIP_ERROR

+

AutoIP service error

 

NM_DEVICE_STATE_REASON_AUTOIP_FAILED

AutoIP service failed +

NM_DEVICE_STATE_REASON_AUTOIP_FAILED

+

AutoIP service failed

 

NM_DEVICE_STATE_REASON_MODEM_BUSY

The line is busy +

NM_DEVICE_STATE_REASON_MODEM_BUSY

+

The line is busy

 

NM_DEVICE_STATE_REASON_MODEM_NO_DIAL_TONE

No dial tone +

NM_DEVICE_STATE_REASON_MODEM_NO_DIAL_TONE

+

No dial tone

 

NM_DEVICE_STATE_REASON_MODEM_NO_CARRIER

No carrier could be established +

NM_DEVICE_STATE_REASON_MODEM_NO_CARRIER

+

No carrier could be established

 

NM_DEVICE_STATE_REASON_MODEM_DIAL_TIMEOUT

The dialing request timed out +

NM_DEVICE_STATE_REASON_MODEM_DIAL_TIMEOUT

+

The dialing request timed out

 

NM_DEVICE_STATE_REASON_MODEM_DIAL_FAILED

The dialing attempt failed +

NM_DEVICE_STATE_REASON_MODEM_DIAL_FAILED

+

The dialing attempt failed

 

NM_DEVICE_STATE_REASON_MODEM_INIT_FAILED

Modem initialization failed +

NM_DEVICE_STATE_REASON_MODEM_INIT_FAILED

+

Modem initialization failed

 

NM_DEVICE_STATE_REASON_GSM_APN_FAILED

Failed to select the specified APN +

NM_DEVICE_STATE_REASON_GSM_APN_FAILED

+

Failed to select the specified APN

 

NM_DEVICE_STATE_REASON_GSM_REGISTRATION_NOT_SEARCHING

Not searching for networks +

NM_DEVICE_STATE_REASON_GSM_REGISTRATION_NOT_SEARCHING

+

Not searching for networks

 

NM_DEVICE_STATE_REASON_GSM_REGISTRATION_DENIED

Network registration denied +

NM_DEVICE_STATE_REASON_GSM_REGISTRATION_DENIED

+

Network registration denied

 

NM_DEVICE_STATE_REASON_GSM_REGISTRATION_TIMEOUT

Network registration timed out +

NM_DEVICE_STATE_REASON_GSM_REGISTRATION_TIMEOUT

+

Network registration timed out

 

NM_DEVICE_STATE_REASON_GSM_REGISTRATION_FAILED

Failed to register with the requested network +

NM_DEVICE_STATE_REASON_GSM_REGISTRATION_FAILED

+

Failed to register with the requested network

 

NM_DEVICE_STATE_REASON_GSM_PIN_CHECK_FAILED

PIN check failed +

NM_DEVICE_STATE_REASON_GSM_PIN_CHECK_FAILED

+

PIN check failed

 

NM_DEVICE_STATE_REASON_FIRMWARE_MISSING

Necessary firmware for the device may be missing +

NM_DEVICE_STATE_REASON_FIRMWARE_MISSING

+

Necessary firmware for the device may be missing

 

NM_DEVICE_STATE_REASON_REMOVED

The device was removed +

NM_DEVICE_STATE_REASON_REMOVED

+

The device was removed

 

NM_DEVICE_STATE_REASON_SLEEPING

NetworkManager went to sleep +

NM_DEVICE_STATE_REASON_SLEEPING

+

NetworkManager went to sleep

 

NM_DEVICE_STATE_REASON_CONNECTION_REMOVED

The device's active connection disappeared +

NM_DEVICE_STATE_REASON_CONNECTION_REMOVED

+

The device's active connection disappeared

 

NM_DEVICE_STATE_REASON_USER_REQUESTED

Device disconnected by user or client +

NM_DEVICE_STATE_REASON_USER_REQUESTED

+

Device disconnected by user or client

 

NM_DEVICE_STATE_REASON_CARRIER

Carrier/link changed +

NM_DEVICE_STATE_REASON_CARRIER

+

Carrier/link changed

 

NM_DEVICE_STATE_REASON_CONNECTION_ASSUMED

The device's existing connection was assumed +

NM_DEVICE_STATE_REASON_CONNECTION_ASSUMED

+

The device's existing connection was assumed

 

NM_DEVICE_STATE_REASON_SUPPLICANT_AVAILABLE

The supplicant is now available +

NM_DEVICE_STATE_REASON_SUPPLICANT_AVAILABLE

+

The supplicant is now available

 

NM_DEVICE_STATE_REASON_MODEM_NOT_FOUND

The modem could not be found +

NM_DEVICE_STATE_REASON_MODEM_NOT_FOUND

+

The modem could not be found

 

NM_DEVICE_STATE_REASON_BT_FAILED

The Bluetooth connection failed or timed out +

NM_DEVICE_STATE_REASON_BT_FAILED

+

The Bluetooth connection failed or timed out

 

NM_DEVICE_STATE_REASON_GSM_SIM_NOT_INSERTED

GSM Modem's SIM Card not inserted +

NM_DEVICE_STATE_REASON_GSM_SIM_NOT_INSERTED

+

GSM Modem's SIM Card not inserted

 

NM_DEVICE_STATE_REASON_GSM_SIM_PIN_REQUIRED

GSM Modem's SIM Pin required +

NM_DEVICE_STATE_REASON_GSM_SIM_PIN_REQUIRED

+

GSM Modem's SIM Pin required

 

NM_DEVICE_STATE_REASON_GSM_SIM_PUK_REQUIRED

GSM Modem's SIM Puk required +

NM_DEVICE_STATE_REASON_GSM_SIM_PUK_REQUIRED

+

GSM Modem's SIM Puk required

 

NM_DEVICE_STATE_REASON_GSM_SIM_WRONG

GSM Modem's SIM wrong +

NM_DEVICE_STATE_REASON_GSM_SIM_WRONG

+

GSM Modem's SIM wrong

 

NM_DEVICE_STATE_REASON_INFINIBAND_MODE

InfiniBand device does not support connected mode +

NM_DEVICE_STATE_REASON_INFINIBAND_MODE

+

InfiniBand device does not support connected mode

 

NM_DEVICE_STATE_REASON_DEPENDENCY_FAILED

A dependency of the connection failed +

NM_DEVICE_STATE_REASON_DEPENDENCY_FAILED

+

A dependency of the connection failed

 

NM_DEVICE_STATE_REASON_BR2684_FAILED

Problem with the RFC 2684 Ethernet over ADSL bridge +

NM_DEVICE_STATE_REASON_BR2684_FAILED

+

Problem with the RFC 2684 Ethernet over ADSL bridge

 

NM_DEVICE_STATE_REASON_MODEM_MANAGER_UNAVAILABLE

ModemManager not running +

NM_DEVICE_STATE_REASON_MODEM_MANAGER_UNAVAILABLE

+

ModemManager not running

 

NM_DEVICE_STATE_REASON_SSID_NOT_FOUND

The WiFi network could not be found +

NM_DEVICE_STATE_REASON_SSID_NOT_FOUND

+

The WiFi network could not be found

 

NM_DEVICE_STATE_REASON_SECONDARY_CONNECTION_FAILED

A secondary connection of the base connection failed +

NM_DEVICE_STATE_REASON_SECONDARY_CONNECTION_FAILED

+

A secondary connection of the base connection failed

 

NM_DEVICE_STATE_REASON_DCB_FCOE_FAILED

DCB or FCoE setup failed +

NM_DEVICE_STATE_REASON_DCB_FCOE_FAILED

+

DCB or FCoE setup failed

 

NM_DEVICE_STATE_REASON_TEAMD_CONTROL_FAILED

teamd control failed +

NM_DEVICE_STATE_REASON_TEAMD_CONTROL_FAILED

+

teamd control failed

 

NM_DEVICE_STATE_REASON_MODEM_FAILED

Modem failed or no longer available +

NM_DEVICE_STATE_REASON_MODEM_FAILED

+

Modem failed or no longer available

 

NM_DEVICE_STATE_REASON_MODEM_AVAILABLE

Modem now ready and available +

NM_DEVICE_STATE_REASON_MODEM_AVAILABLE

+

Modem now ready and available

 

NM_DEVICE_STATE_REASON_SIM_PIN_INCORRECT

SIM PIN was incorrect +

NM_DEVICE_STATE_REASON_SIM_PIN_INCORRECT

+

SIM PIN was incorrect

 

NM_DEVICE_STATE_REASON_LAST

+

NM_DEVICE_STATE_REASON_NEW_ACTIVATION

+

New connection activation was enqueued

 

NM_DEVICE_STATE_REASON_LAST

  
+

enum NMActiveConnectionState

-
typedef enum {
-	NM_ACTIVE_CONNECTION_STATE_UNKNOWN = 0,
-	NM_ACTIVE_CONNECTION_STATE_ACTIVATING,
-	NM_ACTIVE_CONNECTION_STATE_ACTIVATED,
-	NM_ACTIVE_CONNECTION_STATE_DEACTIVATING,
-	NM_ACTIVE_CONNECTION_STATE_DEACTIVATED
-} NMActiveConnectionState;
-
-

-NMActiveConnectionState values indicate the state of a connection to a +

NMActiveConnectionState values indicate the state of a connection to a specific network while it is starting, connected, or disconnecting from that -network. -

-

-(Corresponds to the NM_ACTIVE_CONNECTION_STATE type in nm-active-connection.xml.) -

-
+network.

+

(Corresponds to the NM_ACTIVE_CONNECTION_STATE type in nm-active-connection.xml.)

+
+

Members

+
--+++ - - + + - - + + - - + + - - + + - - + +

NM_ACTIVE_CONNECTION_STATE_UNKNOWN

the state of the connection is unknown +

NM_ACTIVE_CONNECTION_STATE_UNKNOWN

+

the state of the connection is unknown

 

NM_ACTIVE_CONNECTION_STATE_ACTIVATING

a network connection is being prepared +

NM_ACTIVE_CONNECTION_STATE_ACTIVATING

+

a network connection is being prepared

 

NM_ACTIVE_CONNECTION_STATE_ACTIVATED

there is a connection to the network +

NM_ACTIVE_CONNECTION_STATE_ACTIVATED

+

there is a connection to the network

 

NM_ACTIVE_CONNECTION_STATE_DEACTIVATING

the network connection is being - torn down and cleaned up +

NM_ACTIVE_CONNECTION_STATE_DEACTIVATING

+

the network connection is being + torn down and cleaned up

 

NM_ACTIVE_CONNECTION_STATE_DEACTIVATED

the network connection is disconnected - and will be removed +

NM_ACTIVE_CONNECTION_STATE_DEACTIVATED

+

the network connection is disconnected + and will be removed

 
+ + Generated by GTK-Doc V1.21 \ No newline at end of file diff --git a/docs/libnm-util/html/libnm-util-NetworkManagerVPN.html b/docs/libnm-util/html/libnm-util-NetworkManagerVPN.html index 217138c0..3d488c04 100644 --- a/docs/libnm-util/html/libnm-util-NetworkManagerVPN.html +++ b/docs/libnm-util/html/libnm-util-NetworkManagerVPN.html @@ -2,30 +2,26 @@ -NetworkManagerVPN +libnm-util Reference Manual: NetworkManagerVPN - + - - - - - - - - - - + + + + + + +
@@ -33,73 +29,266 @@

NetworkManagerVPN

NetworkManagerVPN

- +
-
-

Synopsis

-
#define             NM_DBUS_PATH_VPN
-#define             NM_DBUS_INTERFACE_VPN
-#define             NM_DBUS_PATH_VPN_CONNECTION
-#define             NM_DBUS_INTERFACE_VPN_CONNECTION
-#define             NM_VPN_DBUS_PLUGIN_PATH
-#define             NM_VPN_DBUS_PLUGIN_INTERFACE
-#define             NM_DBUS_NO_ACTIVE_VPN_CONNECTION
-#define             NM_DBUS_NO_VPN_CONNECTIONS
-#define             NM_DBUS_INVALID_VPN_CONNECTION
-#define             NM_DBUS_VPN_ERROR_PREFIX
-#define             NM_DBUS_VPN_STARTING_IN_PROGRESS
-#define             NM_DBUS_VPN_ALREADY_STARTED
-#define             NM_DBUS_VPN_STOPPING_IN_PROGRESS
-#define             NM_DBUS_VPN_ALREADY_STOPPED
-#define             NM_DBUS_VPN_WRONG_STATE
-#define             NM_DBUS_VPN_BAD_ARGUMENTS
-#define             NM_DBUS_VPN_INTERACTIVE_NOT_SUPPORTED
-#define             NM_DBUS_VPN_SIGNAL_LOGIN_BANNER
-#define             NM_DBUS_VPN_SIGNAL_LOGIN_FAILED
-#define             NM_DBUS_VPN_SIGNAL_LAUNCH_FAILED
-#define             NM_DBUS_VPN_SIGNAL_CONNECT_FAILED
-#define             NM_DBUS_VPN_SIGNAL_VPN_CONFIG_BAD
-#define             NM_DBUS_VPN_SIGNAL_IP_CONFIG_BAD
-#define             NM_DBUS_VPN_SIGNAL_STATE_CHANGE
-#define             NM_DBUS_VPN_SIGNAL_IP4_CONFIG
-enum                NMVPNServiceState;
-enum                NMVPNConnectionState;
-enum                NMVPNConnectionStateReason;
-enum                NMVPNPluginFailure;
-#define             NM_VPN_PLUGIN_CONFIG_TUNDEV
-#define             NM_VPN_PLUGIN_CONFIG_BANNER
-#define             NM_VPN_PLUGIN_CONFIG_EXT_GATEWAY
-#define             NM_VPN_PLUGIN_CONFIG_MTU
-#define             NM_VPN_PLUGIN_CONFIG_HAS_IP4
-#define             NM_VPN_PLUGIN_CONFIG_HAS_IP6
-#define             NM_VPN_PLUGIN_CAN_PERSIST
-#define             NM_VPN_PLUGIN_IP4_CONFIG_INT_GATEWAY
-#define             NM_VPN_PLUGIN_IP4_CONFIG_ADDRESS
-#define             NM_VPN_PLUGIN_IP4_CONFIG_PTP
-#define             NM_VPN_PLUGIN_IP4_CONFIG_PREFIX
-#define             NM_VPN_PLUGIN_IP4_CONFIG_DNS
-#define             NM_VPN_PLUGIN_IP4_CONFIG_NBNS
-#define             NM_VPN_PLUGIN_IP4_CONFIG_MSS
-#define             NM_VPN_PLUGIN_IP4_CONFIG_DOMAIN
-#define             NM_VPN_PLUGIN_IP4_CONFIG_DOMAINS
-#define             NM_VPN_PLUGIN_IP4_CONFIG_ROUTES
-#define             NM_VPN_PLUGIN_IP4_CONFIG_NEVER_DEFAULT
-#define             NM_VPN_PLUGIN_IP4_CONFIG_GATEWAY
-#define             NM_VPN_PLUGIN_IP4_CONFIG_BANNER
-#define             NM_VPN_PLUGIN_IP4_CONFIG_EXT_GATEWAY
-#define             NM_VPN_PLUGIN_IP4_CONFIG_MTU
-#define             NM_VPN_PLUGIN_IP4_CONFIG_TUNDEV
-#define             NM_VPN_PLUGIN_IP6_CONFIG_INT_GATEWAY
-#define             NM_VPN_PLUGIN_IP6_CONFIG_ADDRESS
-#define             NM_VPN_PLUGIN_IP6_CONFIG_PTP
-#define             NM_VPN_PLUGIN_IP6_CONFIG_PREFIX
-#define             NM_VPN_PLUGIN_IP6_CONFIG_DNS
-#define             NM_VPN_PLUGIN_IP6_CONFIG_MSS
-#define             NM_VPN_PLUGIN_IP6_CONFIG_DOMAIN
-#define             NM_VPN_PLUGIN_IP6_CONFIG_DOMAINS
-#define             NM_VPN_PLUGIN_IP6_CONFIG_ROUTES
-#define             NM_VPN_PLUGIN_IP6_CONFIG_NEVER_DEFAULT
-
+
+

Types and Values

+
++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
#defineNM_DBUS_PATH_VPN
#defineNM_DBUS_INTERFACE_VPN
#defineNM_DBUS_PATH_VPN_CONNECTION
#defineNM_DBUS_INTERFACE_VPN_CONNECTION
#defineNM_VPN_DBUS_PLUGIN_PATH
#defineNM_VPN_DBUS_PLUGIN_INTERFACE
#defineNM_DBUS_NO_ACTIVE_VPN_CONNECTION
#defineNM_DBUS_NO_VPN_CONNECTIONS
#defineNM_DBUS_INVALID_VPN_CONNECTION
#defineNM_DBUS_VPN_ERROR_PREFIX
#defineNM_DBUS_VPN_STARTING_IN_PROGRESS
#defineNM_DBUS_VPN_ALREADY_STARTED
#defineNM_DBUS_VPN_STOPPING_IN_PROGRESS
#defineNM_DBUS_VPN_ALREADY_STOPPED
#defineNM_DBUS_VPN_WRONG_STATE
#defineNM_DBUS_VPN_BAD_ARGUMENTS
#defineNM_DBUS_VPN_INTERACTIVE_NOT_SUPPORTED
#defineNM_DBUS_VPN_SIGNAL_LOGIN_BANNER
#defineNM_DBUS_VPN_SIGNAL_LOGIN_FAILED
#defineNM_DBUS_VPN_SIGNAL_LAUNCH_FAILED
#defineNM_DBUS_VPN_SIGNAL_CONNECT_FAILED
#defineNM_DBUS_VPN_SIGNAL_VPN_CONFIG_BAD
#defineNM_DBUS_VPN_SIGNAL_IP_CONFIG_BAD
#defineNM_DBUS_VPN_SIGNAL_STATE_CHANGE
#defineNM_DBUS_VPN_SIGNAL_IP4_CONFIG
enumNMVPNServiceState
enumNMVPNConnectionState
enumNMVPNConnectionStateReason
enumNMVPNPluginFailure
#defineNM_VPN_PLUGIN_CONFIG_TUNDEV
#defineNM_VPN_PLUGIN_CONFIG_BANNER
#defineNM_VPN_PLUGIN_CONFIG_EXT_GATEWAY
#defineNM_VPN_PLUGIN_CONFIG_MTU
#defineNM_VPN_PLUGIN_CONFIG_HAS_IP4
#defineNM_VPN_PLUGIN_CONFIG_HAS_IP6
#defineNM_VPN_PLUGIN_CAN_PERSIST
#defineNM_VPN_PLUGIN_IP4_CONFIG_INT_GATEWAY
#defineNM_VPN_PLUGIN_IP4_CONFIG_ADDRESS
#defineNM_VPN_PLUGIN_IP4_CONFIG_PTP
#defineNM_VPN_PLUGIN_IP4_CONFIG_PREFIX
#defineNM_VPN_PLUGIN_IP4_CONFIG_DNS
#defineNM_VPN_PLUGIN_IP4_CONFIG_NBNS
#defineNM_VPN_PLUGIN_IP4_CONFIG_MSS
#defineNM_VPN_PLUGIN_IP4_CONFIG_DOMAIN
#defineNM_VPN_PLUGIN_IP4_CONFIG_DOMAINS
#defineNM_VPN_PLUGIN_IP4_CONFIG_ROUTES
#defineNM_VPN_PLUGIN_IP4_CONFIG_NEVER_DEFAULT
#defineNM_VPN_PLUGIN_IP4_CONFIG_GATEWAY
#defineNM_VPN_PLUGIN_IP4_CONFIG_BANNER
#defineNM_VPN_PLUGIN_IP4_CONFIG_EXT_GATEWAY
#defineNM_VPN_PLUGIN_IP4_CONFIG_MTU
#defineNM_VPN_PLUGIN_IP4_CONFIG_TUNDEV
#defineNM_VPN_PLUGIN_IP6_CONFIG_INT_GATEWAY
#defineNM_VPN_PLUGIN_IP6_CONFIG_ADDRESS
#defineNM_VPN_PLUGIN_IP6_CONFIG_PTP
#defineNM_VPN_PLUGIN_IP6_CONFIG_PREFIX
#defineNM_VPN_PLUGIN_IP6_CONFIG_DNS
#defineNM_VPN_PLUGIN_IP6_CONFIG_MSS
#defineNM_VPN_PLUGIN_IP6_CONFIG_DOMAIN
#defineNM_VPN_PLUGIN_IP6_CONFIG_DOMAINS
#defineNM_VPN_PLUGIN_IP6_CONFIG_ROUTES
#defineNM_VPN_PLUGIN_IP6_CONFIG_NEVER_DEFAULT

Description

@@ -107,7 +296,10 @@ enum -

Details

+

Functions

+
+
+

Types and Values

NM_DBUS_PATH_VPN

#define NM_DBUS_PATH_VPN                  "/org/freedesktop/NetworkManager/VPN/Manager"
@@ -310,284 +502,302 @@ enum                
 

enum NMVPNServiceState

-
typedef enum {
-	NM_VPN_SERVICE_STATE_UNKNOWN = 0,
-	NM_VPN_SERVICE_STATE_INIT,
-	NM_VPN_SERVICE_STATE_SHUTDOWN,
-	NM_VPN_SERVICE_STATE_STARTING,
-	NM_VPN_SERVICE_STATE_STARTED,
-	NM_VPN_SERVICE_STATE_STOPPING,
-	NM_VPN_SERVICE_STATE_STOPPED
-} NMVPNServiceState;
-
-

-VPN daemon states -

-

-(Corresponds to the NM_VPN_SERVICE_STATE type in nm-vpn-connection.xml.) -

-
+

VPN daemon states

+

(Corresponds to the NM_VPN_SERVICE_STATE type in nm-vpn-connection.xml.)

+
+

Members

+
--+++ - - + + - - + + - - + + - - + + - - + + - - + + - - + +

NM_VPN_SERVICE_STATE_UNKNOWN

The state of the VPN plugin is unknown. +

NM_VPN_SERVICE_STATE_UNKNOWN

+

The state of the VPN plugin is unknown.

 

NM_VPN_SERVICE_STATE_INIT

The VPN plugin is initialized. +

NM_VPN_SERVICE_STATE_INIT

+

The VPN plugin is initialized.

 

NM_VPN_SERVICE_STATE_SHUTDOWN

Not used. +

NM_VPN_SERVICE_STATE_SHUTDOWN

+

Not used.

 

NM_VPN_SERVICE_STATE_STARTING

The plugin is attempting to connect to a VPN server. +

NM_VPN_SERVICE_STATE_STARTING

+

The plugin is attempting to connect to a VPN server.

 

NM_VPN_SERVICE_STATE_STARTED

The plugin has connected to a VPN server. +

NM_VPN_SERVICE_STATE_STARTED

+

The plugin has connected to a VPN server.

 

NM_VPN_SERVICE_STATE_STOPPING

The plugin is disconnecting from the VPN server. +

NM_VPN_SERVICE_STATE_STOPPING

+

The plugin is disconnecting from the VPN server.

 

NM_VPN_SERVICE_STATE_STOPPED

The plugin has disconnected from the VPN server. +

NM_VPN_SERVICE_STATE_STOPPED

+

The plugin has disconnected from the VPN server.

 
+

enum NMVPNConnectionState

-
typedef enum {
-	NM_VPN_CONNECTION_STATE_UNKNOWN = 0,
-	NM_VPN_CONNECTION_STATE_PREPARE,
-	NM_VPN_CONNECTION_STATE_NEED_AUTH,
-	NM_VPN_CONNECTION_STATE_CONNECT,
-	NM_VPN_CONNECTION_STATE_IP_CONFIG_GET,
-	NM_VPN_CONNECTION_STATE_ACTIVATED,
-	NM_VPN_CONNECTION_STATE_FAILED,
-	NM_VPN_CONNECTION_STATE_DISCONNECTED
-} NMVPNConnectionState;
-
-

-VPN connection states -

-

-(Corresponds to the NM_VPN_CONNECTION_STATE type in nm-vpn-connection.xml.) -

-
+

VPN connection states

+

(Corresponds to the NM_VPN_CONNECTION_STATE type in nm-vpn-connection.xml.)

+
+

Members

+
--+++ - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + +

NM_VPN_CONNECTION_STATE_UNKNOWN

The state of the VPN connection is - unknown. +

NM_VPN_CONNECTION_STATE_UNKNOWN

+

The state of the VPN connection is + unknown.

 

NM_VPN_CONNECTION_STATE_PREPARE

The VPN connection is preparing to - connect. +

NM_VPN_CONNECTION_STATE_PREPARE

+

The VPN connection is preparing to + connect.

 

NM_VPN_CONNECTION_STATE_NEED_AUTH

The VPN connection needs authorization - credentials. +

NM_VPN_CONNECTION_STATE_NEED_AUTH

+

The VPN connection needs authorization + credentials.

 

NM_VPN_CONNECTION_STATE_CONNECT

The VPN connection is being established. +

NM_VPN_CONNECTION_STATE_CONNECT

+

The VPN connection is being established.

 

NM_VPN_CONNECTION_STATE_IP_CONFIG_GET

The VPN connection is getting an IP - address. +

NM_VPN_CONNECTION_STATE_IP_CONFIG_GET

+

The VPN connection is getting an IP + address.

 

NM_VPN_CONNECTION_STATE_ACTIVATED

The VPN connection is active. +

NM_VPN_CONNECTION_STATE_ACTIVATED

+

The VPN connection is active.

 

NM_VPN_CONNECTION_STATE_FAILED

The VPN connection failed. +

NM_VPN_CONNECTION_STATE_FAILED

+

The VPN connection failed.

 

NM_VPN_CONNECTION_STATE_DISCONNECTED

The VPN connection is disconnected. +

NM_VPN_CONNECTION_STATE_DISCONNECTED

+

The VPN connection is disconnected.

 
+

enum NMVPNConnectionStateReason

-
typedef enum {
-	NM_VPN_CONNECTION_STATE_REASON_UNKNOWN = 0,
-	NM_VPN_CONNECTION_STATE_REASON_NONE,
-	NM_VPN_CONNECTION_STATE_REASON_USER_DISCONNECTED,
-	NM_VPN_CONNECTION_STATE_REASON_DEVICE_DISCONNECTED,
-	NM_VPN_CONNECTION_STATE_REASON_SERVICE_STOPPED,
-	NM_VPN_CONNECTION_STATE_REASON_IP_CONFIG_INVALID,
-	NM_VPN_CONNECTION_STATE_REASON_CONNECT_TIMEOUT,
-	NM_VPN_CONNECTION_STATE_REASON_SERVICE_START_TIMEOUT,
-	NM_VPN_CONNECTION_STATE_REASON_SERVICE_START_FAILED,
-	NM_VPN_CONNECTION_STATE_REASON_NO_SECRETS,
-	NM_VPN_CONNECTION_STATE_REASON_LOGIN_FAILED,
-	NM_VPN_CONNECTION_STATE_REASON_CONNECTION_REMOVED
-} NMVPNConnectionStateReason;
-
-

-VPN connection state reasons -

-

-(Corresponds to the NM_VPN_CONNECTION_STATE_REASON type in nm-vpn-connection.xml.) -

-
+

VPN connection state reasons

+

(Corresponds to the NM_VPN_CONNECTION_STATE_REASON type in nm-vpn-connection.xml.)

+
+

Members

+
--+++ - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + +

NM_VPN_CONNECTION_STATE_REASON_UNKNOWN

The reason for the VPN connection - state change is unknown. +

NM_VPN_CONNECTION_STATE_REASON_UNKNOWN

+

The reason for the VPN connection + state change is unknown.

 

NM_VPN_CONNECTION_STATE_REASON_NONE

No reason was given for the VPN - connection state change. +

NM_VPN_CONNECTION_STATE_REASON_NONE

+

No reason was given for the VPN + connection state change.

 

NM_VPN_CONNECTION_STATE_REASON_USER_DISCONNECTED

The VPN connection changed - state because the user disconnected it. +

NM_VPN_CONNECTION_STATE_REASON_USER_DISCONNECTED

+

The VPN connection changed + state because the user disconnected it.

 

NM_VPN_CONNECTION_STATE_REASON_DEVICE_DISCONNECTED

The VPN connection - changed state because the device it was using was disconnected. +

NM_VPN_CONNECTION_STATE_REASON_DEVICE_DISCONNECTED

+

The VPN connection + changed state because the device it was using was disconnected.

 

NM_VPN_CONNECTION_STATE_REASON_SERVICE_STOPPED

The service providing the - VPN connection was stopped. +

NM_VPN_CONNECTION_STATE_REASON_SERVICE_STOPPED

+

The service providing the + VPN connection was stopped.

 

NM_VPN_CONNECTION_STATE_REASON_IP_CONFIG_INVALID

The IP config of the VPN - connection was invalid. +

NM_VPN_CONNECTION_STATE_REASON_IP_CONFIG_INVALID

+

The IP config of the VPN + connection was invalid.

 

NM_VPN_CONNECTION_STATE_REASON_CONNECT_TIMEOUT

The connection attempt to - the VPN service timed out. +

NM_VPN_CONNECTION_STATE_REASON_CONNECT_TIMEOUT

+

The connection attempt to + the VPN service timed out.

 

NM_VPN_CONNECTION_STATE_REASON_SERVICE_START_TIMEOUT

A timeout occurred - while starting the service providing the VPN connection. +

NM_VPN_CONNECTION_STATE_REASON_SERVICE_START_TIMEOUT

+

A timeout occurred + while starting the service providing the VPN connection.

 

NM_VPN_CONNECTION_STATE_REASON_SERVICE_START_FAILED

Starting the service - starting the service providing the VPN connection failed. +

NM_VPN_CONNECTION_STATE_REASON_SERVICE_START_FAILED

+

Starting the service + starting the service providing the VPN connection failed.

 

NM_VPN_CONNECTION_STATE_REASON_NO_SECRETS

Necessary secrets for the VPN - connection were not provided. +

NM_VPN_CONNECTION_STATE_REASON_NO_SECRETS

+

Necessary secrets for the VPN + connection were not provided.

 

NM_VPN_CONNECTION_STATE_REASON_LOGIN_FAILED

Authentication to the VPN - server failed. +

NM_VPN_CONNECTION_STATE_REASON_LOGIN_FAILED

+

Authentication to the VPN + server failed.

 

NM_VPN_CONNECTION_STATE_REASON_CONNECTION_REMOVED

The connection was - deleted from settings. +

NM_VPN_CONNECTION_STATE_REASON_CONNECTION_REMOVED

+

The connection was + deleted from settings.

 
+

enum NMVPNPluginFailure

-
typedef enum {
-	NM_VPN_PLUGIN_FAILURE_LOGIN_FAILED,
-	NM_VPN_PLUGIN_FAILURE_CONNECT_FAILED,
-	NM_VPN_PLUGIN_FAILURE_BAD_IP_CONFIG
-} NMVPNPluginFailure;
-
-

-VPN plugin failure reasons -

-

-(Corresponds to the NM_VPN_PLUGIN_FAILURE type in nm-vpn-plugin.xml.) -

-
+

VPN plugin failure reasons

+

(Corresponds to the NM_VPN_PLUGIN_FAILURE type in nm-vpn-plugin.xml.)

+
+

Members

+
--+++ - - + + - - + + - - + +

NM_VPN_PLUGIN_FAILURE_LOGIN_FAILED

Login failed. +

NM_VPN_PLUGIN_FAILURE_LOGIN_FAILED

+

Login failed.

 

NM_VPN_PLUGIN_FAILURE_CONNECT_FAILED

Connect failed. +

NM_VPN_PLUGIN_FAILURE_CONNECT_FAILED

+

Connect failed.

 

NM_VPN_PLUGIN_FAILURE_BAD_IP_CONFIG

Invalid IP configuration returned from - the VPN plugin. +

NM_VPN_PLUGIN_FAILURE_BAD_IP_CONFIG

+

Invalid IP configuration returned from + the VPN plugin.

 
+

NM_VPN_PLUGIN_CONFIG_TUNDEV

@@ -856,6 +1066,6 @@ VPN plugin failure reasons
+ Generated by GTK-Doc V1.21 \ No newline at end of file diff --git a/docs/libnm-util/html/libnm-util-nm-utils.html b/docs/libnm-util/html/libnm-util-nm-utils.html index 3d5c24ea..bdd5ddbd 100644 --- a/docs/libnm-util/html/libnm-util-nm-utils.html +++ b/docs/libnm-util/html/libnm-util-nm-utils.html @@ -2,32 +2,27 @@ -nm-utils +libnm-util Reference Manual: nm-utils - + - - - - - - - - - - + + + + + + +
@@ -35,297 +30,645 @@

nm-utils

nm-utils — Utility functions

- +
-
-

Synopsis

-
-#include <nm-utils.h>
-
-gboolean            nm_utils_init                       (GError **error);
-void                nm_utils_deinit                     (void);
-gboolean            nm_utils_is_empty_ssid              (const guint8 *ssid,
-                                                         int len);
-const char *        nm_utils_escape_ssid                (const guint8 *ssid,
-                                                         guint32 len);
-gboolean            nm_utils_same_ssid                  (const GByteArray *ssid1,
-                                                         const GByteArray *ssid2,
-                                                         gboolean ignore_trailing_null);
-char *              nm_utils_ssid_to_utf8               (const GByteArray *ssid);
-GHashTable *        nm_utils_gvalue_hash_dup            (GHashTable *hash);
-void                nm_utils_slist_free                 (GSList *list,
-                                                         GDestroyNotify elem_destroy_fn);
-enum                NMUtilsSecurityType;
-gboolean            nm_utils_security_valid             (NMUtilsSecurityType type,
-                                                         NMDeviceWifiCapabilities wifi_caps,
-                                                         gboolean have_ap,
-                                                         gboolean adhoc,
-                                                         NM80211ApFlags ap_flags,
-                                                         NM80211ApSecurityFlags ap_wpa,
-                                                         NM80211ApSecurityFlags ap_rsn);
-gboolean            nm_utils_ap_mode_security_valid     (NMUtilsSecurityType type,
-                                                         NMDeviceWifiCapabilities wifi_caps);
-gboolean            nm_utils_wep_key_valid              (const char *key,
-                                                         NMWepKeyType wep_type);
-gboolean            nm_utils_wpa_psk_valid              (const char *psk);
-GSList *            nm_utils_ip4_addresses_from_gvalue  (const GValue *value);
-void                nm_utils_ip4_addresses_to_gvalue    (GSList *list,
-                                                         GValue *value);
-GSList *            nm_utils_ip4_routes_from_gvalue     (const GValue *value);
-void                nm_utils_ip4_routes_to_gvalue       (GSList *list,
-                                                         GValue *value);
-guint32             nm_utils_ip4_netmask_to_prefix      (guint32 netmask);
-guint32             nm_utils_ip4_prefix_to_netmask      (guint32 prefix);
-guint32             nm_utils_ip4_get_default_prefix     (guint32 ip);
-GSList *            nm_utils_ip6_addresses_from_gvalue  (const GValue *value);
-void                nm_utils_ip6_addresses_to_gvalue    (GSList *list,
-                                                         GValue *value);
-GSList *            nm_utils_ip6_routes_from_gvalue     (const GValue *value);
-void                nm_utils_ip6_routes_to_gvalue       (GSList *list,
-                                                         GValue *value);
-GSList *            nm_utils_ip6_dns_from_gvalue        (const GValue *value);
-void                nm_utils_ip6_dns_to_gvalue          (GSList *list,
-                                                         GValue *value);
-char *              nm_utils_uuid_generate              (void);
-char *              nm_utils_uuid_generate_from_string  (const char *s);
-GByteArray *        nm_utils_rsa_key_encrypt            (const GByteArray *data,
-                                                         const char *in_password,
-                                                         char **out_password,
-                                                         GError **error);
-GByteArray *        nm_utils_rsa_key_encrypt_aes        (const GByteArray *data,
-                                                         const char *in_password,
-                                                         char **out_password,
-                                                         GError **error);
-gboolean            nm_utils_file_is_pkcs12             (const char *filename);
-gboolean            (*NMUtilsFileSearchInPathsPredicate)
-                                                        (const char *filename,
-                                                         gpointer user_data);
-const char *        nm_utils_file_search_in_paths       (const char *progname,
-                                                         const char *try_first,
-                                                         const char *const *paths,
-                                                         GFileTest file_test_flags,
-                                                         NMUtilsFileSearchInPathsPredicate predicate,
-                                                         gpointer user_data,
-                                                         GError **error);
-guint32             nm_utils_wifi_freq_to_channel       (guint32 freq);
-guint32             nm_utils_wifi_channel_to_freq       (guint32 channel,
-                                                         const char *band);
-guint32             nm_utils_wifi_find_next_channel     (guint32 channel,
-                                                         int direction,
-                                                         char *band);
-gboolean            nm_utils_wifi_is_channel_valid      (guint32 channel,
-                                                         const char *band);
-#define             NM_UTILS_HWADDR_LEN_MAX
-int                 nm_utils_hwaddr_len                 (int type);
-int                 nm_utils_hwaddr_type                (int len);
-char *              nm_utils_hwaddr_ntoa                (gconstpointer addr,
-                                                         int type);
-GByteArray *        nm_utils_hwaddr_atoba               (const char *asc,
-                                                         int type);
-guint8 *            nm_utils_hwaddr_aton                (const char *asc,
-                                                         int type,
-                                                         gpointer buffer);
-char *              nm_utils_hwaddr_ntoa_len            (gconstpointer addr,
-                                                         gsize length);
-guint8 *            nm_utils_hwaddr_aton_len            (const char *asc,
-                                                         gpointer buffer,
-                                                         gsize length);
-gboolean            nm_utils_hwaddr_valid               (const char *asc);
-char *              nm_utils_bin2hexstr                 (const char *bytes,
-                                                         int len,
-                                                         int final_len);
-int                 nm_utils_hex2byte                   (const char *hex);
-char *              nm_utils_hexstr2bin                 (const char *hex,
-                                                         size_t len);
-gboolean            nm_utils_iface_valid_name           (const char *name);
-gboolean            nm_utils_is_uuid                    (const char *str);
-#define             NM_UTILS_INET_ADDRSTRLEN
-const char *        nm_utils_inet4_ntop                 (in_addr_t inaddr,
-                                                         char *dst);
-const char *        nm_utils_inet6_ntop                 (const struct in6_addr *in6addr,
-                                                         char *dst);
-gboolean            nm_utils_check_virtual_device_compatibility
-                                                        (GType virtual_type,
-                                                         GType other_type);
-
+
+

Functions

+
++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+gboolean + +nm_utils_init () +
+void + +nm_utils_deinit () +
+gboolean + +nm_utils_is_empty_ssid () +
const char * + +nm_utils_escape_ssid () +
+gboolean + +nm_utils_same_ssid () +
+char * + +nm_utils_ssid_to_utf8 () +
+GHashTable * + +nm_utils_gvalue_hash_dup () +
+void + +nm_utils_slist_free () +
+gboolean + +nm_utils_security_valid () +
+gboolean + +nm_utils_ap_mode_security_valid () +
+gboolean + +nm_utils_wep_key_valid () +
+gboolean + +nm_utils_wpa_psk_valid () +
+GSList * + +nm_utils_ip4_addresses_from_gvalue () +
+void + +nm_utils_ip4_addresses_to_gvalue () +
+GSList * + +nm_utils_ip4_routes_from_gvalue () +
+void + +nm_utils_ip4_routes_to_gvalue () +
+guint32 + +nm_utils_ip4_netmask_to_prefix () +
+guint32 + +nm_utils_ip4_prefix_to_netmask () +
+guint32 + +nm_utils_ip4_get_default_prefix () +
+GSList * + +nm_utils_ip6_addresses_from_gvalue () +
+void + +nm_utils_ip6_addresses_to_gvalue () +
+GSList * + +nm_utils_ip6_routes_from_gvalue () +
+void + +nm_utils_ip6_routes_to_gvalue () +
+GSList * + +nm_utils_ip6_dns_from_gvalue () +
+void + +nm_utils_ip6_dns_to_gvalue () +
+char * + +nm_utils_uuid_generate () +
+char * + +nm_utils_uuid_generate_from_string () +
+GByteArray * + +nm_utils_rsa_key_encrypt () +
+GByteArray * + +nm_utils_rsa_key_encrypt_aes () +
+gboolean + +nm_utils_file_is_pkcs12 () +
+gboolean + +(*NMUtilsFileSearchInPathsPredicate) () +
const char * + +nm_utils_file_search_in_paths () +
+guint32 + +nm_utils_wifi_freq_to_channel () +
+guint32 + +nm_utils_wifi_channel_to_freq () +
+guint32 + +nm_utils_wifi_find_next_channel () +
+gboolean + +nm_utils_wifi_is_channel_valid () +
+int + +nm_utils_hwaddr_len () +
+int + +nm_utils_hwaddr_type () +
+char * + +nm_utils_hwaddr_ntoa () +
+GByteArray * + +nm_utils_hwaddr_atoba () +
+guint8 * + +nm_utils_hwaddr_aton () +
+char * + +nm_utils_hwaddr_ntoa_len () +
+guint8 * + +nm_utils_hwaddr_aton_len () +
+gboolean + +nm_utils_hwaddr_valid () +
+char * + +nm_utils_bin2hexstr () +
+int + +nm_utils_hex2byte () +
+char * + +nm_utils_hexstr2bin () +
+gboolean + +nm_utils_iface_valid_name () +
+gboolean + +nm_utils_is_uuid () +
const char * + +nm_utils_inet4_ntop () +
const char * + +nm_utils_inet6_ntop () +
+gboolean + +nm_utils_check_virtual_device_compatibility () +
+
+
+

Types and Values

+
++++ + + + + + + + + + + + + + + +
enumNMUtilsSecurityType
#defineNM_UTILS_HWADDR_LEN_MAX
#defineNM_UTILS_INET_ADDRSTRLEN

Object Hierarchy

-
-  GEnum
-   +----NMUtilsSecurityType
+
    GEnum
+    ╰── NMUtilsSecurityType
+
+
+
+

Includes

+
#include <nm-utils.h>
 

Description

-

-A collection of utility functions for working with SSIDs, IP addresses, Wi-Fi -access points and devices, among other things. -

+

A collection of utility functions for working with SSIDs, IP addresses, Wi-Fi +access points and devices, among other things.

-

Details

+

Functions

-

nm_utils_init ()

-
gboolean            nm_utils_init                       (GError **error);
-

-Initializes libnm-util; should be called when starting any program that -uses libnm-util. This function can be called more than once. -

-
+

nm_utils_init ()

+
gboolean
+nm_utils_init (GError **error);
+

Initializes libnm-util; should be called when starting any program that +uses libnm-util. This function can be called more than once.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

error :

location to store error, or NULL -

Returns :

-TRUE if the initialization was successful, FALSE on failure.

error

location to store error, or NULL

 
+
+

Returns

+

TRUE if the initialization was successful, FALSE on failure.

+

+
+

-

nm_utils_deinit ()

-
void                nm_utils_deinit                     (void);
-

-No-op. Although this function still exists for ABI compatibility reasons, it -does not have any effect, and does not ever need to be called. -

+

nm_utils_deinit ()

+
void
+nm_utils_deinit (void);
+

No-op. Although this function still exists for ABI compatibility reasons, it +does not have any effect, and does not ever need to be called.


-

nm_utils_is_empty_ssid ()

-
gboolean            nm_utils_is_empty_ssid              (const guint8 *ssid,
-                                                         int len);
-

-Different manufacturers use different mechanisms for not broadcasting the +

nm_utils_is_empty_ssid ()

+
gboolean
+nm_utils_is_empty_ssid (const guint8 *ssid,
+                        int len);
+

Different manufacturers use different mechanisms for not broadcasting the AP's SSID. This function attempts to detect blank/empty SSIDs using a -number of known SSID-cloaking methods. -

-
+number of known SSID-cloaking methods.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + +

ssid :

pointer to a buffer containing the SSID data

len :

length of the SSID data in ssid -

ssid

pointer to a buffer containing the SSID data

 

Returns :

-TRUE if the SSID is "empty", FALSE if it is not

len

length of the SSID data in ssid +

 
+
+

Returns

+

TRUE if the SSID is "empty", FALSE if it is not

+

+
+

-

nm_utils_escape_ssid ()

-
const char *        nm_utils_escape_ssid                (const guint8 *ssid,
-                                                         guint32 len);
-

-This function does a quick printable character conversion of the SSID, simply +

nm_utils_escape_ssid ()

+
const char *
+nm_utils_escape_ssid (const guint8 *ssid,
+                      guint32 len);
+

This function does a quick printable character conversion of the SSID, simply replacing embedded NULLs and non-printable characters with the hexadecimal representation of that character. Intended for debugging only, should not -be used for display of SSIDs. -

-
+be used for display of SSIDs.

+
+

Parameters

+
--+++ - - + + + - - - - - - + + +

ssid :

pointer to a buffer containing the SSID data

ssid

pointer to a buffer containing the SSID data

 

len :

length of the SSID data in ssid -

Returns :

pointer to the escaped SSID, which uses an internal static buffer -and will be overwritten by subsequent calls to this function

len

length of the SSID data in ssid +

 
+
+

Returns

+

pointer to the escaped SSID, which uses an internal static buffer +and will be overwritten by subsequent calls to this function

+

+
+

-

nm_utils_same_ssid ()

-
gboolean            nm_utils_same_ssid                  (const GByteArray *ssid1,
-                                                         const GByteArray *ssid2,
-                                                         gboolean ignore_trailing_null);
-

-Earlier versions of the Linux kernel added a NULL byte to the end of the +

nm_utils_same_ssid ()

+
gboolean
+nm_utils_same_ssid (const GByteArray *ssid1,
+                    const GByteArray *ssid2,
+                    gboolean ignore_trailing_null);
+

Earlier versions of the Linux kernel added a NULL byte to the end of the SSID to enable easy printing of the SSID on the console or in a terminal, but this behavior was problematic (SSIDs are simply byte arrays, not strings) and thus was changed. This function compensates for that behavior at the cost of some compatibility with odd SSIDs that may legitimately have trailing -NULLs, even though that is functionally pointless. -

-
+NULLs, even though that is functionally pointless.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + + - - + + +

ssid1 :

first SSID data to compare

ssid2 :

second SSID data to compare

ssid1

first SSID data to compare

 

ignore_trailing_null :

-TRUE to ignore one trailing NULL byte

ssid2

second SSID data to compare

 

Returns :

-TRUE if the SSIDs are the same, FALSE if they are not

ignore_trailing_null

TRUE to ignore one trailing NULL byte

 
+
+

Returns

+

TRUE if the SSIDs are the same, FALSE if they are not

+

+
+
-

nm_utils_ssid_to_utf8 ()

-
char *              nm_utils_ssid_to_utf8               (const GByteArray *ssid);
-

-Wi-Fi SSIDs are byte arrays, they are _not_ strings. Thus, an SSID may +

nm_utils_ssid_to_utf8 ()

+
char *
+nm_utils_ssid_to_utf8 (const GByteArray *ssid);
+

Wi-Fi SSIDs are byte arrays, they are _not_ strings. Thus, an SSID may contain embedded NULLs and other unprintable characters. Often it is useful to print the SSID out for debugging purposes, but that should be the _only_ use of this function. Do not use this function for any persistent storage of the SSID, since the printable SSID returned from this function -cannot be converted back into the real SSID of the access point. -

-

-This function does almost everything humanly possible to convert the input -into a printable UTF-8 string, using roughly the following procedure: -

-

-1) if the input data is already UTF-8 safe, no conversion is performed +cannot be converted back into the real SSID of the access point.

+

This function does almost everything humanly possible to convert the input +into a printable UTF-8 string, using roughly the following procedure:

+

1) if the input data is already UTF-8 safe, no conversion is performed 2) attempts to get the current system language from the LANG environment variable, and depending on the language, uses a table of alternative encodings to try. For example, if LANG=hu_HU, the table may first try @@ -333,1636 +676,1860 @@ into a printable UTF-8 string, using roughly the following procedure: If all fallback encodings fail, replaces non-UTF-8 characters with '?'. 3) If the system language was unable to be determined, falls back to the ISO-8859-1 encoding, then to the Windows-1251 encoding. -4) If step 3 fails, replaces non-UTF-8 characters with '?'. -

-

-Again, this function should be used for debugging and display purposes -_only_. -

-
+4) If step 3 fails, replaces non-UTF-8 characters with '?'.

+

Again, this function should be used for debugging and display purposes +_only_.

+
+

Parameters

+
--+++ - - - - - - - - - - -

ssid :

a byte array containing the SSID data

Returns :

an allocated string containing a UTF-8 -representation of the SSID, which must be freed by the caller using g_free(). -Returns NULL on errors. [transfer full] -
-
-
-
-

nm_utils_gvalue_hash_dup ()

-
GHashTable *        nm_utils_gvalue_hash_dup            (GHashTable *hash);
-

-Utility function to duplicate a hash table of GValues. -

-
---- - - - - - - - - - - + + + + +

hash :

a GHashTable mapping string:GValue

Returns :

a newly allocated duplicated GHashTable, caller must free the -returned hash with g_hash_table_unref() or g_hash_table_destroy(). [transfer container][element-type utf8 GObject.Value] -

ssid

a byte array containing the SSID data

 
+
+

Returns

+

an allocated string containing a UTF-8 +representation of the SSID, which must be freed by the caller using g_free(). +Returns NULL on errors.

+

[transfer full]

+
+
-

nm_utils_slist_free ()

-
void                nm_utils_slist_free                 (GSList *list,
-                                                         GDestroyNotify elem_destroy_fn);
-
-

Warning

-

nm_utils_slist_free is deprecated and should not be used in newly-written code. use g_slist_free_full().

-
-

-Utility function to free a GSList. -

-
+

nm_utils_gvalue_hash_dup ()

+
GHashTable *
+nm_utils_gvalue_hash_dup (GHashTable *hash);
+

Utility function to duplicate a hash table of GValues.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

list :

a GSList -

elem_destroy_fn :

user function called for each element in list -

hash

a GHashTable mapping string:GValue

 
+
+

Returns

+

a newly allocated duplicated GHashTable, caller must free the +returned hash with g_hash_table_unref() or g_hash_table_destroy().

+

[transfer container][element-type utf8 GObject.Value]

+
+
-

enum NMUtilsSecurityType

-
typedef enum {
-	NMU_SEC_INVALID = 0,
-	NMU_SEC_NONE,
-	NMU_SEC_STATIC_WEP,
-	NMU_SEC_LEAP,
-	NMU_SEC_DYNAMIC_WEP,
-	NMU_SEC_WPA_PSK,
-	NMU_SEC_WPA_ENTERPRISE,
-	NMU_SEC_WPA2_PSK,
-	NMU_SEC_WPA2_ENTERPRISE
-} NMUtilsSecurityType;
-
-

-Describes generic security mechanisms that 802.11 access points may offer. -Used with nm_utils_security_valid() for checking whether a given access -point is compatible with a network device. -

-
+

nm_utils_slist_free ()

+
void
+nm_utils_slist_free (GSList *list,
+                     GDestroyNotify elem_destroy_fn);
+
+

nm_utils_slist_free is deprecated and should not be used in newly-written code.

+

use g_slist_free_full().

+
+

Utility function to free a GSList.

+
+

Parameters

+
--+++ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + - - + + +

NMU_SEC_INVALID

unknown or invalid security, placeholder and not used -

NMU_SEC_NONE

unencrypted and open -

NMU_SEC_STATIC_WEP

static WEP keys are used for encryption -

NMU_SEC_LEAP

Cisco LEAP is used for authentication and for generating the -dynamic WEP keys automatically -

NMU_SEC_DYNAMIC_WEP

standard 802.1x is used for authentication and -generating the dynamic WEP keys automatically -

NMU_SEC_WPA_PSK

WPA1 is used with Pre-Shared Keys (PSK) -

NMU_SEC_WPA_ENTERPRISE

WPA1 is used with 802.1x authentication -

NMU_SEC_WPA2_PSK

WPA2/RSN is used with Pre-Shared Keys (PSK) -

list

a GSList

 

NMU_SEC_WPA2_ENTERPRISE

WPA2 is used with 802.1x authentication -

elem_destroy_fn

user function called for each element in list +

 
+
-

nm_utils_security_valid ()

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

-Given a set of device capabilities, and a desired security type to check +

nm_utils_security_valid ()

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

Given a set of device capabilities, and a desired security type to check against, determines whether the combination of device, desired security -type, and AP capabilities intersect. -

-

-NOTE: this function cannot handle checking security for AP/Hotspot mode; -use nm_utils_ap_mode_security_valid() instead. -

-
+type, and AP capabilities intersect.

+

NOTE: this function cannot handle checking security for AP/Hotspot mode; +use nm_utils_ap_mode_security_valid() instead.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + + - - + + + - - + + + - - + + + - - + + + - - + + +

type :

the security type to check AP flags and device capabilties against, -e.g. NMU_SEC_STATIC_WEP -

wifi_caps :

bitfield of the capabilities of the specific Wi-Fi device, e.g. -NM_WIFI_DEVICE_CAP_CIPHER_WEP40 -

type

the security type to check AP flags and device capabilties against, +e.g. NMU_SEC_STATIC_WEP

 

have_ap :

whether the ap_flags, ap_wpa, and ap_rsn arguments are valid

wifi_caps

bitfield of the capabilities of the specific Wi-Fi device, e.g. +NM_WIFI_DEVICE_CAP_CIPHER_WEP40

 

adhoc :

whether the capabilities being tested are from an Ad-Hoc AP (IBSS)

have_ap

whether the ap_flags +, ap_wpa +, and ap_rsn +arguments are valid

 

ap_flags :

bitfield of AP capabilities, e.g. NM_802_11_AP_FLAGS_PRIVACY -

adhoc

whether the capabilities being tested are from an Ad-Hoc AP (IBSS)

 

ap_wpa :

bitfield of AP capabilties derived from the AP's WPA beacon, -e.g. (NM_802_11_AP_SEC_PAIR_TKIP | NM_802_11_AP_SEC_KEY_MGMT_PSK)

ap_flags

bitfield of AP capabilities, e.g. NM_802_11_AP_FLAGS_PRIVACY

 

ap_rsn :

bitfield of AP capabilties derived from the AP's RSN/WPA2 beacon, -e.g. (NM_802_11_AP_SEC_PAIR_CCMP | NM_802_11_AP_SEC_PAIR_TKIP)

ap_wpa

bitfield of AP capabilties derived from the AP's WPA beacon, +e.g. (NM_802_11_AP_SEC_PAIR_TKIP | NM_802_11_AP_SEC_KEY_MGMT_PSK)

 

Returns :

-TRUE if the device capabilities and AP capabilties intersect and are -compatible with the desired type, FALSE if they are not

ap_rsn

bitfield of AP capabilties derived from the AP's RSN/WPA2 beacon, +e.g. (NM_802_11_AP_SEC_PAIR_CCMP | NM_802_11_AP_SEC_PAIR_TKIP)

 
+
+

Returns

+

TRUE if the device capabilities and AP capabilties intersect and are +compatible with the desired type +, FALSE if they are not

+

+
+
-

nm_utils_ap_mode_security_valid ()

-
gboolean            nm_utils_ap_mode_security_valid     (NMUtilsSecurityType type,
-                                                         NMDeviceWifiCapabilities wifi_caps);
-

-Given a set of device capabilities, and a desired security type to check +

nm_utils_ap_mode_security_valid ()

+
gboolean
+nm_utils_ap_mode_security_valid (NMUtilsSecurityType type,
+                                 NMDeviceWifiCapabilities wifi_caps);
+

Given a set of device capabilities, and a desired security type to check against, determines whether the combination of device capabilities and -desired security type are valid for AP/Hotspot connections. -

-
+desired security type are valid for AP/Hotspot connections.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + +

type :

the security type to check device capabilties against, -e.g. NMU_SEC_STATIC_WEP -

wifi_caps :

bitfield of the capabilities of the specific Wi-Fi device, e.g. -NM_WIFI_DEVICE_CAP_CIPHER_WEP40 -

type

the security type to check device capabilties against, +e.g. NMU_SEC_STATIC_WEP

 

Returns :

-TRUE if the device capabilities are compatible with the desired -type, FALSE if they are not.

wifi_caps

bitfield of the capabilities of the specific Wi-Fi device, e.g. +NM_WIFI_DEVICE_CAP_CIPHER_WEP40

 
+
+
+

Returns

+

TRUE if the device capabilities are compatible with the desired +type +, FALSE if they are not.

+

+

Since 0.9.8


-

nm_utils_wep_key_valid ()

-
gboolean            nm_utils_wep_key_valid              (const char *key,
-                                                         NMWepKeyType wep_type);
-

-Checks if key is a valid WEP key -

-
+

nm_utils_wep_key_valid ()

+
gboolean
+nm_utils_wep_key_valid (const char *key,
+                        NMWepKeyType wep_type);
+

Checks if key + is a valid WEP key

+
+

Parameters

+
--+++ - - + + + - - - - - - + + +

key :

a string that might be a WEP key

key

a string that might be a WEP key

 

wep_type :

the NMWepKeyType type of the WEP key

Returns :

-TRUE if key is a WEP key, FALSE if not

wep_type

the NMWepKeyType type of the WEP key

 
+
+
+

Returns

+

TRUE if key +is a WEP key, FALSE if not

+

+

Since 0.9.8


-

nm_utils_wpa_psk_valid ()

-
gboolean            nm_utils_wpa_psk_valid              (const char *psk);
-

-Checks if psk is a valid WPA PSK -

-
+

nm_utils_wpa_psk_valid ()

+
gboolean
+nm_utils_wpa_psk_valid (const char *psk);
+

Checks if psk + is a valid WPA PSK

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

psk :

a string that might be a WPA PSK

Returns :

-TRUE if psk is a WPA PSK, FALSE if not

psk

a string that might be a WPA PSK

 
+
+
+

Returns

+

TRUE if psk +is a WPA PSK, FALSE if not

+

+

Since 0.9.8


-

nm_utils_ip4_addresses_from_gvalue ()

-
GSList *            nm_utils_ip4_addresses_from_gvalue  (const GValue *value);
-

-Utility function to convert a GPtrArray of GArrays of guint32s representing +

nm_utils_ip4_addresses_from_gvalue ()

+
GSList *
+nm_utils_ip4_addresses_from_gvalue (const GValue *value);
+

Utility function to convert a GPtrArray of GArrays of guint32s representing a list of NetworkManager IPv4 addresses (which is a tuple of address, gateway, -and prefix) into a GSList of NMIP4Address objects. The specific format of -this serialization is not guaranteed to be stable and the GArray may be -extended in the future. -

-
+and prefix) into a GSList of NMIP4Address objects. The specific format of +this serialization is not guaranteed to be stable and the GArray may be +extended in the future.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

value :

-GValue containing a GPtrArray of GArrays of guint32s -

Returns :

a newly allocated GSList of NMIP4Address objects. [transfer full][element-type NMIP4Address] -

value

GValue containing a GPtrArray of GArrays of guint32s

 
+
+

Returns

+

a newly allocated GSList of NMIP4Address objects.

+

[transfer full][element-type NMIP4Address]

+
+
-

nm_utils_ip4_addresses_to_gvalue ()

-
void                nm_utils_ip4_addresses_to_gvalue    (GSList *list,
-                                                         GValue *value);
-

-Utility function to convert a GSList of NMIP4Address objects into a -GPtrArray of GArrays of guint32s representing a list of NetworkManager IPv4 +

nm_utils_ip4_addresses_to_gvalue ()

+
void
+nm_utils_ip4_addresses_to_gvalue (GSList *list,
+                                  GValue *value);
+

Utility function to convert a GSList of NMIP4Address objects into a +GPtrArray of GArrays of guint32s representing a list of NetworkManager IPv4 addresses (which is a tuple of address, gateway, and prefix). The specific format of this serialization is not guaranteed to be stable and may be -extended in the future. -

-
+extended in the future.

+
+

Parameters

+
--+++ - - + + + - - + +g_value_unset().

+

list :

a list of NMIP4Address objects. [element-type NMIP4Address] -

list

a list of NMIP4Address objects.

[element-type NMIP4Address]

value :

a pointer to a GValue into which to place the converted addresses, +

value

a pointer to a GValue into which to place the converted addresses, which should be unset by the caller (when no longer needed) with -g_value_unset().

 
+
-

nm_utils_ip4_routes_from_gvalue ()

-
GSList *            nm_utils_ip4_routes_from_gvalue     (const GValue *value);
-

-Utility function to convert a GPtrArray of GArrays of guint32s representing +

nm_utils_ip4_routes_from_gvalue ()

+
GSList *
+nm_utils_ip4_routes_from_gvalue (const GValue *value);
+

Utility function to convert a GPtrArray of GArrays of guint32s representing a list of NetworkManager IPv4 routes (which is a tuple of route, next hop, -prefix, and metric) into a GSList of NMIP4Route objects. The specific +prefix, and metric) into a GSList of NMIP4Route objects. The specific format of this serialization is not guaranteed to be stable and may be -extended in the future. -

-
+extended in the future.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

value :

-GValue containing a GPtrArray of GArrays of guint32s -

Returns :

a newly allocated GSList of NMIP4Route objects. [transfer full][element-type NMIP4Route] -

value

GValue containing a GPtrArray of GArrays of guint32s

 
+
+

Returns

+

a newly allocated GSList of NMIP4Route objects.

+

[transfer full][element-type NMIP4Route]

+
+
-

nm_utils_ip4_routes_to_gvalue ()

-
void                nm_utils_ip4_routes_to_gvalue       (GSList *list,
-                                                         GValue *value);
-

-Utility function to convert a GSList of NMIP4Route objects into a -GPtrArray of GArrays of guint32s representing a list of NetworkManager IPv4 +

nm_utils_ip4_routes_to_gvalue ()

+
void
+nm_utils_ip4_routes_to_gvalue (GSList *list,
+                               GValue *value);
+

Utility function to convert a GSList of NMIP4Route objects into a +GPtrArray of GArrays of guint32s representing a list of NetworkManager IPv4 routes (which is a tuple of route, next hop, prefix, and metric). The specific format of this serialization is not guaranteed to be stable and may -be extended in the future. -

-
+be extended in the future.

+
+

Parameters

+
--+++ - - + + + - - + +g_value_unset().

+

list :

a list of NMIP4Route objects. [element-type NMIP4Route] -

list

a list of NMIP4Route objects.

[element-type NMIP4Route]

value :

a pointer to a GValue into which to place the converted routes, +

value

a pointer to a GValue into which to place the converted routes, which should be unset by the caller (when no longer needed) with -g_value_unset().

 
+
-

nm_utils_ip4_netmask_to_prefix ()

-
guint32             nm_utils_ip4_netmask_to_prefix      (guint32 netmask);
-
+

nm_utils_ip4_netmask_to_prefix ()

+
guint32
+nm_utils_ip4_netmask_to_prefix (guint32 netmask);
+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

netmask :

an IPv4 netmask in network byte order

Returns :

the CIDR prefix represented by the netmask

netmask

an IPv4 netmask in network byte order

 
+
+

Returns

+

the CIDR prefix represented by the netmask

+

+
+
-

nm_utils_ip4_prefix_to_netmask ()

-
guint32             nm_utils_ip4_prefix_to_netmask      (guint32 prefix);
-
+

nm_utils_ip4_prefix_to_netmask ()

+
guint32
+nm_utils_ip4_prefix_to_netmask (guint32 prefix);
+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

prefix :

a CIDR prefix

Returns :

the netmask represented by the prefix, in network byte order

prefix

a CIDR prefix

 
+
+

Returns

+

the netmask represented by the prefix, in network byte order

+

+
+
-

nm_utils_ip4_get_default_prefix ()

-
guint32             nm_utils_ip4_get_default_prefix     (guint32 ip);
-

-When the Internet was originally set up, various ranges of IP addresses were +

nm_utils_ip4_get_default_prefix ()

+
guint32
+nm_utils_ip4_get_default_prefix (guint32 ip);
+

When the Internet was originally set up, various ranges of IP addresses were segmented into three network classes: A, B, and C. This function will return a prefix that is associated with the IP address specified defining where it -falls in the predefined classes. -

-
+falls in the predefined classes.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

ip :

an IPv4 address (in network byte order)

Returns :

the default class prefix for the given IP

ip

an IPv4 address (in network byte order)

 
+
+

Returns

+

the default class prefix for the given IP

+

+
+
-

nm_utils_ip6_addresses_from_gvalue ()

-
GSList *            nm_utils_ip6_addresses_from_gvalue  (const GValue *value);
-

-Utility function to convert a GPtrArray of GValueArrays of (GArray of guchars) and guint32 +

nm_utils_ip6_addresses_from_gvalue ()

+
GSList *
+nm_utils_ip6_addresses_from_gvalue (const GValue *value);
+

Utility function to convert a GPtrArray of GValueArrays of (GArray of guchars) and guint32 representing a list of NetworkManager IPv6 addresses (which is a tuple of address, -prefix, and gateway), into a GSList of NMIP6Address objects. The specific format of -this serialization is not guaranteed to be stable and the GValueArray may be -extended in the future. -

-
+prefix, and gateway), into a GSList of NMIP6Address objects. The specific format of +this serialization is not guaranteed to be stable and the GValueArray may be +extended in the future.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

value :

gvalue containing a GPtrArray of GValueArrays of (GArray of guchars) and guint32 -

Returns :

a newly allocated GSList of NMIP6Address objects. [transfer full][element-type NMIP6Address] -

value

gvalue containing a GPtrArray of GValueArrays of (GArray of guchars) and guint32

 
+
+

Returns

+

a newly allocated GSList of NMIP6Address objects.

+

[transfer full][element-type NMIP6Address]

+
+
-

nm_utils_ip6_addresses_to_gvalue ()

-
void                nm_utils_ip6_addresses_to_gvalue    (GSList *list,
-                                                         GValue *value);
-

-Utility function to convert a GSList of NMIP6Address objects into a -GPtrArray of GValueArrays representing a list of NetworkManager IPv6 addresses +

nm_utils_ip6_addresses_to_gvalue ()

+
void
+nm_utils_ip6_addresses_to_gvalue (GSList *list,
+                                  GValue *value);
+

Utility function to convert a GSList of NMIP6Address objects into a +GPtrArray of GValueArrays representing a list of NetworkManager IPv6 addresses (which is a tuple of address, prefix, and gateway). The specific format of this serialization is not guaranteed to be stable and may be extended in the -future. -

-
+future.

+
+

Parameters

+
--+++ - - + + + - - + +g_value_unset().

+

list :

a list of NMIP6Address objects. [element-type NMIP6Address] -

list

a list of NMIP6Address objects.

[element-type NMIP6Address]

value :

a pointer to a GValue into which to place the converted addresses, +

value

a pointer to a GValue into which to place the converted addresses, which should be unset by the caller (when no longer needed) with -g_value_unset().

 
+
-

nm_utils_ip6_routes_from_gvalue ()

-
GSList *            nm_utils_ip6_routes_from_gvalue     (const GValue *value);
-

-Utility function GPtrArray of GValueArrays of (GArray of guchars), guint32, -(GArray of guchars), and guint32 representing a list of NetworkManager IPv6 +

nm_utils_ip6_routes_from_gvalue ()

+
GSList *
+nm_utils_ip6_routes_from_gvalue (const GValue *value);
+

Utility function GPtrArray of GValueArrays of (GArray of guchars), guint32, +(GArray of guchars), and guint32 representing a list of NetworkManager IPv6 routes (which is a tuple of destination, prefix, next hop, and metric) -into a GSList of NMIP6Route objects. The specific format of this serialization -is not guaranteed to be stable and may be extended in the future. -

-
+into a GSList of NMIP6Route objects. The specific format of this serialization +is not guaranteed to be stable and may be extended in the future.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

value :

-GValue containing a GPtrArray of GValueArrays of (GArray of guchars), guint32, -(GArray of guchars), and guint32 -

Returns :

a newly allocated GSList of NMIP6Route objects. [transfer full][element-type NMIP6Route] -

value

GValue containing a GPtrArray of GValueArrays of (GArray of guchars), guint32, +(GArray of guchars), and guint32

 
+
+

Returns

+

a newly allocated GSList of NMIP6Route objects.

+

[transfer full][element-type NMIP6Route]

+
+
-

nm_utils_ip6_routes_to_gvalue ()

-
void                nm_utils_ip6_routes_to_gvalue       (GSList *list,
-                                                         GValue *value);
-

-Utility function to convert a GSList of NMIP6Route objects into a GPtrArray of -GValueArrays of (GArray of guchars), guint32, (GArray of guchars), and guint32 +

nm_utils_ip6_routes_to_gvalue ()

+
void
+nm_utils_ip6_routes_to_gvalue (GSList *list,
+                               GValue *value);
+

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

-
+guaranteed to be stable and may be extended in the future.

+
+

Parameters

+
--+++ - - + + + - - + +g_value_unset().

+

list :

a list of NMIP6Route objects. [element-type NMIP6Route] -

list

a list of NMIP6Route objects.

[element-type NMIP6Route]

value :

a pointer to a GValue into which to place the converted routes, +

value

a pointer to a GValue into which to place the converted routes, which should be unset by the caller (when no longer needed) with -g_value_unset().

 
+
-

nm_utils_ip6_dns_from_gvalue ()

-
GSList *            nm_utils_ip6_dns_from_gvalue        (const GValue *value);
-

-Converts a GValue containing a GPtrArray of IP6 DNS, represented as -GByteArrays into a GSList of struct in6_addrs. -

-
+

nm_utils_ip6_dns_from_gvalue ()

+
GSList *
+nm_utils_ip6_dns_from_gvalue (const GValue *value);
+

Converts a GValue containing a GPtrArray of IP6 DNS, represented as +GByteArrays into a GSList of struct in6_addrs.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

value :

a GValue -

Returns :

a GSList of IP6 addresses.

value

a GValue

 
+
+

Returns

+

a GSList of IP6 addresses.

+

+
+
-

nm_utils_ip6_dns_to_gvalue ()

-
void                nm_utils_ip6_dns_to_gvalue          (GSList *list,
-                                                         GValue *value);
-

-Utility function to convert a GSList of struct -in6_addr structs into a GPtrArray of GByteArrays +

nm_utils_ip6_dns_to_gvalue ()

+
void
+nm_utils_ip6_dns_to_gvalue (GSList *list,
+                            GValue *value);
+

Utility function to convert a GSList of struct +in6_addr structs into a GPtrArray of GByteArrays representing each server's IPv6 addresses in network byte order. The specific format of this serialization is not guaranteed to be -stable and may be extended in the future. -

-
+stable and may be extended in the future.

+
+

Parameters

+
--+++ - - + + + - - + +g_value_unset().

+

list :

a list of NMIP6Route objects

list

a list of NMIP6Route objects

 

value :

a pointer to a GValue into which to place the converted DNS server +

value

a pointer to a GValue into which to place the converted DNS server addresses, which should be unset by the caller (when no longer needed) with -g_value_unset().

 
+
-

nm_utils_uuid_generate ()

-
char *              nm_utils_uuid_generate              (void);
-
---- - - - - -

Returns :

a newly allocated UUID suitable for use as the NMSettingConnection -object's "id": property. Should be freed with g_free() -
+

nm_utils_uuid_generate ()

+
char *
+nm_utils_uuid_generate (void);
+
+

Returns

+

a newly allocated UUID suitable for use as the NMSettingConnection +object's “id”: property. Should be freed with g_free()

+

+

-

nm_utils_uuid_generate_from_string ()

-
char *              nm_utils_uuid_generate_from_string  (const char *s);
-

-For a given s, this function will always return the same UUID. -

-
+

nm_utils_uuid_generate_from_string ()

+
char *
+nm_utils_uuid_generate_from_string (const char *s);
+

For a given s +, this function will always return the same UUID.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

s :

a string to use as the seed for the UUID

Returns :

a newly allocated UUID suitable for use as the NMSettingConnection -object's "id": property

s

a string to use as the seed for the UUID

 
+
+

Returns

+

a newly allocated UUID suitable for use as the NMSettingConnection +object's “id”: property

+

+
+
-

nm_utils_rsa_key_encrypt ()

-
GByteArray *        nm_utils_rsa_key_encrypt            (const GByteArray *data,
-                                                         const char *in_password,
-                                                         char **out_password,
-                                                         GError **error);
-

-Encrypts the given RSA private key data with the given password (or generates +

nm_utils_rsa_key_encrypt ()

+
GByteArray *
+nm_utils_rsa_key_encrypt (const GByteArray *data,
+                          const char *in_password,
+                          char **out_password,
+                          GError **error);
+

Encrypts the given RSA private key data with the given password (or generates a password if no password was given) and converts the data to PEM format -suitable for writing to a file. It uses Triple DES cipher for the encryption. -

-
+suitable for writing to a file. It uses Triple DES cipher for the encryption.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + + - - + + + - - + + +

data :

RSA private key data to be encrypted

in_password :

existing password to use, if any. [allow-none] -

data

RSA private key data to be encrypted

 

out_password :

if in_password was NULL, a random password will be generated -and returned in this argument. [out][allow-none] -

in_password

existing password to use, if any.

[allow-none]

error :

detailed error information on return, if an error occurred

out_password

if in_password +was NULL, a random password will be generated +and returned in this argument.

[out][allow-none]

Returns :

on success, PEM-formatted data suitable for writing to a PEM-formatted -certificate/private key file. [transfer full] -

error

detailed error information on return, if an error occurred

 
+
+

Returns

+

on success, PEM-formatted data suitable for writing to a PEM-formatted +certificate/private key file.

+

[transfer full]

+
+
-

nm_utils_rsa_key_encrypt_aes ()

-
GByteArray *        nm_utils_rsa_key_encrypt_aes        (const GByteArray *data,
-                                                         const char *in_password,
-                                                         char **out_password,
-                                                         GError **error);
-

-Encrypts the given RSA private key data with the given password (or generates +

nm_utils_rsa_key_encrypt_aes ()

+
GByteArray *
+nm_utils_rsa_key_encrypt_aes (const GByteArray *data,
+                              const char *in_password,
+                              char **out_password,
+                              GError **error);
+

Encrypts the given RSA private key data with the given password (or generates a password if no password was given) and converts the data to PEM format -suitable for writing to a file. It uses AES cipher for the encryption. -

-
+suitable for writing to a file. It uses AES cipher for the encryption.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + + - - + + + - - + + +

data :

RSA private key data to be encrypted

in_password :

existing password to use, if any. [allow-none] -

data

RSA private key data to be encrypted

 

out_password :

if in_password was NULL, a random password will be generated -and returned in this argument. [out][allow-none] -

in_password

existing password to use, if any.

[allow-none]

error :

detailed error information on return, if an error occurred

out_password

if in_password +was NULL, a random password will be generated +and returned in this argument.

[out][allow-none]

Returns :

on success, PEM-formatted data suitable for writing to a PEM-formatted -certificate/private key file. [transfer full] -

error

detailed error information on return, if an error occurred

 
+
+

Returns

+

on success, PEM-formatted data suitable for writing to a PEM-formatted +certificate/private key file.

+

[transfer full]

+
+
-

nm_utils_file_is_pkcs12 ()

-
gboolean            nm_utils_file_is_pkcs12             (const char *filename);
-

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

-
+

nm_utils_file_is_pkcs12 ()

+
gboolean
+nm_utils_file_is_pkcs12 (const char *filename);
+

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

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

filename :

name of the file to test

Returns :

-TRUE if the file is PKCS#12, FALSE if it is not

filename

name of the file to test

 
+
+

Returns

+

TRUE if the file is PKCS#12, FALSE if it is not

+

+
+
-

NMUtilsFileSearchInPathsPredicate ()

-
gboolean            (*NMUtilsFileSearchInPathsPredicate)
-                                                        (const char *filename,
-                                                         gpointer user_data);
+

NMUtilsFileSearchInPathsPredicate ()

+
gboolean
+(*NMUtilsFileSearchInPathsPredicate) (const char *filename,
+                                      gpointer user_data);

+
+

Returns

+

+

-

nm_utils_file_search_in_paths ()

-
const char *        nm_utils_file_search_in_paths       (const char *progname,
-                                                         const char *try_first,
-                                                         const char *const *paths,
-                                                         GFileTest file_test_flags,
-                                                         NMUtilsFileSearchInPathsPredicate predicate,
-                                                         gpointer user_data,
-                                                         GError **error);
-

-Searches for a progname file in a list of search paths. -

-
+

nm_utils_file_search_in_paths ()

+
const char *
+nm_utils_file_search_in_paths (const char *progname,
+                               const char *try_first,
+                               const char *const *paths,
+                               GFileTest file_test_flags,
+                               NMUtilsFileSearchInPathsPredicate predicate,
+                               gpointer user_data,
+                               GError **error);
+

Searches for a progname + file in a list of search paths +.

+
+

Parameters

+
--+++ - - + + + - - + + + - - + + + - - + + + - - + - - - - +file_test_flags +. You cannot omit both file_test_flags +and predicate +.

+ - - + + + - - + + +

progname :

the helper program name, like "iptables" -Must be a non-empty string, without path separator (/).

progname

the helper program name, like "iptables" +Must be a non-empty string, without path separator (/).

 

try_first :

a custom path to try first before searching. -It is silently ignored if it is empty or not an absolute path. [allow-none] -

try_first

a custom path to try first before searching. +It is silently ignored if it is empty or not an absolute path.

[allow-none]

paths :

a NULL terminated list of search paths. -Can be empty or NULL, in which case only try_first is checked. [allow-none] -

paths

a NULL terminated list of search paths. +Can be empty or NULL, in which case only try_first +is checked.

[allow-none]

file_test_flags :

the flags passed to g_file_test() when searching -for progname. Set it to 0 to skip the g_file_test().

file_test_flags

the flags passed to g_file_test() when searching +for progname +. Set it to 0 to skip the g_file_test().

 

predicate :

if given, pass the file name to this function +

predicate

if given, pass the file name to this function for additional checks. This check is performed after the check for -file_test_flags. You cannot omit both file_test_flags and predicate. [scope call] -

user_data :

(allow-none): user data for predicate function. [closure] -[scope call]

error :

on failure, a "not found" error using error_domain and error_code -

user_data

(allow-none): user data for predicate +function.

[closure]

Returns :

the full path to the helper, if found, or NULL if not found. -The returned string is not owned by the caller, but later -invocations of the function might overwrite it. [transfer none] -

error

on failure, set a "not found" error G_IO_ERROR G_IO_ERROR_NOT_FOUND.

[allow-none]
+
+

Returns

+

the full path to the helper, if found, or NULL if not found. +The returned string is not owned by the caller, but later +invocations of the function might overwrite it.

+

[transfer none]

+
+
-

nm_utils_wifi_freq_to_channel ()

-
guint32             nm_utils_wifi_freq_to_channel       (guint32 freq);
-

-Utility function to translate a Wi-Fi frequency to its corresponding channel. -

-
+

nm_utils_wifi_freq_to_channel ()

+
guint32
+nm_utils_wifi_freq_to_channel (guint32 freq);
+

Utility function to translate a Wi-Fi frequency to its corresponding channel.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

freq :

frequency

Returns :

the channel represented by the frequency or 0

freq

frequency

 
+
+

Returns

+

the channel represented by the frequency or 0

+

+
+
-

nm_utils_wifi_channel_to_freq ()

-
guint32             nm_utils_wifi_channel_to_freq       (guint32 channel,
-                                                         const char *band);
-

-Utility function to translate a Wi-Fi channel to its corresponding frequency. -

-
+

nm_utils_wifi_channel_to_freq ()

+
guint32
+nm_utils_wifi_channel_to_freq (guint32 channel,
+                               const char *band);
+

Utility function to translate a Wi-Fi channel to its corresponding frequency.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + +

channel :

channel

band :

frequency band for wireless ("a" or "bg")

channel

channel

 

Returns :

the frequency represented by the channel of the band, -or -1 when the freq is invalid, or 0 when the band -is invalid

band

frequency band for wireless ("a" or "bg")

 
+
+

Returns

+

the frequency represented by the channel of the band, +or -1 when the freq is invalid, or 0 when the band +is invalid

+

+
+
-

nm_utils_wifi_find_next_channel ()

-
guint32             nm_utils_wifi_find_next_channel     (guint32 channel,
-                                                         int direction,
-                                                         char *band);
-

-Utility function to find out next/previous Wi-Fi channel for a channel. -

-
+

nm_utils_wifi_find_next_channel ()

+
guint32
+nm_utils_wifi_find_next_channel (guint32 channel,
+                                 int direction,
+                                 char *band);
+

Utility function to find out next/previous Wi-Fi channel for a channel.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + + - - + + +

channel :

current channel

direction :

whether going downward (0 or less) or upward (1 or more)

channel

current channel

 

band :

frequency band for wireless ("a" or "bg")

direction

whether going downward (0 or less) or upward (1 or more)

 

Returns :

the next channel in the specified direction or 0

band

frequency band for wireless ("a" or "bg")

 
+
+

Returns

+

the next channel in the specified direction or 0

+

+
+
-

nm_utils_wifi_is_channel_valid ()

-
gboolean            nm_utils_wifi_is_channel_valid      (guint32 channel,
-                                                         const char *band);
-

-Utility function to verify Wi-Fi channel validity. -

-
+

nm_utils_wifi_is_channel_valid ()

+
gboolean
+nm_utils_wifi_is_channel_valid (guint32 channel,
+                                const char *band);
+

Utility function to verify Wi-Fi channel validity.

+
+

Parameters

+
--+++ - - + + + - - - - - - + + +

channel :

channel

channel

channel

 

band :

frequency band for wireless ("a" or "bg")

Returns :

-TRUE or FALSE -

band

frequency band for wireless ("a" or "bg")

 
-
-
-

NM_UTILS_HWADDR_LEN_MAX

-
#define NM_UTILS_HWADDR_LEN_MAX 20 /* INFINIBAND_ALEN */
-
-

-The maximum length of hardware addresses handled by NetworkManager itself, -nm_utils_hwaddr_len(), and nm_utils_hwaddr_aton(). -

+
+

Returns

+

TRUE or FALSE

+

+

-

nm_utils_hwaddr_len ()

-
int                 nm_utils_hwaddr_len                 (int type);
-

-Returns the length in octets of a hardware address of type type. -

-
+

nm_utils_hwaddr_len ()

+
int
+nm_utils_hwaddr_len (int type);
+

Returns the length in octets of a hardware address of type type +.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

type :

the type of address; either ARPHRD_ETHER or -ARPHRD_INFINIBAND -

Returns :

the positive length, or -1 if the type is unknown/unsupported.

type

the type of address; either ARPHRD_ETHER or +ARPHRD_INFINIBAND

 
+
+

Returns

+

the positive length, or -1 if the type is unknown/unsupported.

+

+
+
-

nm_utils_hwaddr_type ()

-
int                 nm_utils_hwaddr_type                (int len);
-
-

Warning

-

nm_utils_hwaddr_type is deprecated and should not be used in newly-written code. This could not be extended to cover other types, since +

nm_utils_hwaddr_type ()

+
int
+nm_utils_hwaddr_type (int len);
+
+

nm_utils_hwaddr_type is deprecated and should not be used in newly-written code.

+

This could not be extended to cover other types, since there is not a one-to-one mapping between types and lengths. This was mostly only used to get a type to pass to -nm_utils_hwaddr_ntoa() or nm_utils_hwaddr_aton() when you only had -a length; but you can just use nm_utils_hwaddr_ntoa_len() or -nm_utils_hwaddr_aton_len() now instead.

+nm_utils_hwaddr_ntoa() or nm_utils_hwaddr_aton() when you only had +a length; but you can just use nm_utils_hwaddr_ntoa_len() or +nm_utils_hwaddr_aton_len() now instead.

-

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

-
+

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

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

len :

the length of hardware address in bytes

Returns :

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

len

the length of hardware address in bytes

 
+
+

Returns

+

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

+

+
+

-

nm_utils_hwaddr_ntoa ()

-
char *              nm_utils_hwaddr_ntoa                (gconstpointer addr,
-                                                         int type);
-

-Converts addr to textual form. -

-

-See also nm_utils_hwaddr_ntoa_len(), which takes a length instead of -a type. -

-
+

nm_utils_hwaddr_ntoa ()

+
char *
+nm_utils_hwaddr_ntoa (gconstpointer addr,
+                      int type);
+

Converts addr + to textual form.

+

See also nm_utils_hwaddr_ntoa_len(), which takes a length instead of +a type.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + +

addr :

a binary hardware address

type :

the type of address; either ARPHRD_ETHER or -ARPHRD_INFINIBAND -

addr

a binary hardware address

 

Returns :

the textual form of addr. [transfer full] -

type

the type of address; either ARPHRD_ETHER or +ARPHRD_INFINIBAND

 
+
+

Returns

+

the textual form of addr +.

+

[transfer full]

+
+
-

nm_utils_hwaddr_atoba ()

-
GByteArray *        nm_utils_hwaddr_atoba               (const char *asc,
-                                                         int type);
-

-Parses asc and converts it to binary form in a GByteArray. See -nm_utils_hwaddr_aton() if you don't want a GByteArray. -

-
+

nm_utils_hwaddr_atoba ()

+
GByteArray *
+nm_utils_hwaddr_atoba (const char *asc,
+                       int type);
+

Parses asc + and converts it to binary form in a GByteArray. See +nm_utils_hwaddr_aton() if you don't want a GByteArray.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + +

asc :

the ASCII representation of a hardware address

type :

the type of address; either ARPHRD_ETHER or -ARPHRD_INFINIBAND -

asc

the ASCII representation of a hardware address

 

Returns :

a new GByteArray, or NULL if asc couldn't -be parsed. [transfer full] -

type

the type of address; either ARPHRD_ETHER or +ARPHRD_INFINIBAND

 
+
+

Returns

+

a new GByteArray, or NULL if asc +couldn't +be parsed.

+

[transfer full]

+
+
-

nm_utils_hwaddr_aton ()

-
guint8 *            nm_utils_hwaddr_aton                (const char *asc,
-                                                         int type,
-                                                         gpointer buffer);
-

-Parses asc and converts it to binary form in buffer. See -nm_utils_hwaddr_atoba() if you'd rather have the result in a -GByteArray. -

-

-See also nm_utils_hwaddr_aton_len(), which takes an output length -instead of a type. -

-
+

nm_utils_hwaddr_aton ()

+
guint8 *
+nm_utils_hwaddr_aton (const char *asc,
+                      int type,
+                      gpointer buffer);
+

Parses asc + and converts it to binary form in buffer +. See +nm_utils_hwaddr_atoba() if you'd rather have the result in a +GByteArray.

+

See also nm_utils_hwaddr_aton_len(), which takes an output length +instead of a type.

+
+

Parameters

+
--+++ - - + + + - - - - - - + + + - - + + +

asc :

the ASCII representation of a hardware address

asc

the ASCII representation of a hardware address

 

type :

the type of address; either ARPHRD_ETHER or -ARPHRD_INFINIBAND -

buffer :

buffer to store the result into

type

the type of address; either ARPHRD_ETHER or +ARPHRD_INFINIBAND

 

Returns :

-buffer, or NULL if asc couldn't be parsed

buffer

buffer to store the result into

 
+
+

Returns

+

buffer +, or NULL if asc +couldn't be parsed

+

+
+
-

nm_utils_hwaddr_ntoa_len ()

-
char *              nm_utils_hwaddr_ntoa_len            (gconstpointer addr,
-                                                         gsize length);
-

-Converts addr to textual form. -

-
+

nm_utils_hwaddr_ntoa_len ()

+
char *
+nm_utils_hwaddr_ntoa_len (gconstpointer addr,
+                          gsize length);
+

Converts addr + to textual form.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + +

addr :

a binary hardware address

length :

the length of addr -

addr

a binary hardware address

 

Returns :

the textual form of addr. [transfer full] -

length

the length of addr +

 
+
+
+

Returns

+

the textual form of addr +.

+

[transfer full]

+

Since 0.9.10


-

nm_utils_hwaddr_aton_len ()

-
guint8 *            nm_utils_hwaddr_aton_len            (const char *asc,
-                                                         gpointer buffer,
-                                                         gsize length);
-

-Parses asc and converts it to binary form in buffer. -Bytes in asc can be sepatared by colons (:), or hyphens (-), but not mixed. -

-
+

nm_utils_hwaddr_aton_len ()

+
guint8 *
+nm_utils_hwaddr_aton_len (const char *asc,
+                          gpointer buffer,
+                          gsize length);
+

Parses asc + and converts it to binary form in buffer +. +Bytes in asc + can be sepatared by colons (:), or hyphens (-), but not mixed.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + + - - + + +

asc :

the ASCII representation of a hardware address

buffer :

buffer to store the result into

asc

the ASCII representation of a hardware address

 

length :

the expected length in bytes of the result and -the size of the buffer in bytes.

buffer

buffer to store the result into

 

Returns :

-buffer, or NULL if asc couldn't be parsed -or would be shorter or longer than length.

length

the expected length in bytes of the result and +the size of the buffer in bytes.

 
+
+
+

Returns

+

buffer +, or NULL if asc +couldn't be parsed +or would be shorter or longer than length +.

+

+

Since 0.9.10


-

nm_utils_hwaddr_valid ()

-
gboolean            nm_utils_hwaddr_valid               (const char *asc);
-

-Parses asc to see if it is a valid hardware address of some type. -

-
+

nm_utils_hwaddr_valid ()

+
gboolean
+nm_utils_hwaddr_valid (const char *asc);
+

Parses asc + to see if it is a valid hardware address of some type.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

asc :

the ASCII representation of a hardware address

Returns :

-TRUE if asc appears to be a valid hardware address -of some type, FALSE if not.

asc

the ASCII representation of a hardware address

 
+
+
+

Returns

+

TRUE if asc +appears to be a valid hardware address +of some type, FALSE if not.

+

+

Since 0.9.10


-

nm_utils_bin2hexstr ()

-
char *              nm_utils_bin2hexstr                 (const char *bytes,
-                                                         int len,
-                                                         int final_len);
-

-Converts a byte-array bytes into a hexadecimal string. -If final_len is greater than -1, the returned string is terminated at -that index (returned_string[final_len] == '\0'), -

-
+

nm_utils_bin2hexstr ()

+
char *
+nm_utils_bin2hexstr (const char *bytes,
+                     int len,
+                     int final_len);
+

Converts a byte-array bytes + into a hexadecimal string. +If final_len + is greater than -1, the returned string is terminated at +that index (returned_string[final_len] == '\0'),

+
+

Parameters

+
--+++ - - - - - - + + + - - + + + - - + + +

bytes :

an array of bytes

len :

the length of the bytes array

bytes

an array of bytes

 

final_len :

an index where to cut off the returned string, or -1

len

the length of the bytes +array

 

Returns :

the textual form of bytes. [transfer full] -

final_len

an index where to cut off the returned string, or -1

 
+
+
+

Returns

+

the textual form of bytes +.

+

[transfer full]

+

Since 0.9.10


-

nm_utils_hex2byte ()

-
int                 nm_utils_hex2byte                   (const char *hex);
-

-Converts a hex string (2 characters) into its byte representation. -

-
+

nm_utils_hex2byte ()

+
int
+nm_utils_hex2byte (const char *hex);
+

Converts a hex string (2 characters) into its byte representation.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

hex :

a string representing a hex byte

Returns :

a byte, or -1 if hex doesn't represent a hex byte

hex

a string representing a hex byte

 
+
+
+

Returns

+

a byte, or -1 if hex +doesn't represent a hex byte

+

+

Since 0.9.10


-

nm_utils_hexstr2bin ()

-
char *              nm_utils_hexstr2bin                 (const char *hex,
-                                                         size_t len);
-

-Converts a hexadecimal string hex into a byte-array. The returned array -length is len/2. -

-
+

nm_utils_hexstr2bin ()

+
char *
+nm_utils_hexstr2bin (const char *hex,
+                     size_t len);
+

Converts a hexadecimal string hex + into a byte-array. The returned array +length is len +/2.

+
+

Parameters

+
--+++ - - + + + - - - - - - + + +

hex :

an hex string

hex

an hex string

 

len :

the length of the hex string (it has to be even)

Returns :

a array of bytes, or NULL on error. [transfer full] -

len

the length of the hex +string (it has to be even)

 
+
+
+

Returns

+

a array of bytes, or NULL on error.

+

[transfer full]

+

Since 0.9.10


-

nm_utils_iface_valid_name ()

-
gboolean            nm_utils_iface_valid_name           (const char *name);
-

-This function is a 1:1 copy of the kernel's interface validation -function in net/core/dev.c. -

-
+

nm_utils_iface_valid_name ()

+
gboolean
+nm_utils_iface_valid_name (const char *name);
+

This function is a 1:1 copy of the kernel's interface validation +function in net/core/dev.c.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

name :

Name of interface

Returns :

-TRUE if interface name is valid, otherwise FALSE is returned.

name

Name of interface

 
+
+
+

Returns

+

TRUE if interface name is valid, otherwise FALSE is returned.

+

+

Since 0.9.8


-

nm_utils_is_uuid ()

-
gboolean            nm_utils_is_uuid                    (const char *str);
-

-Checks if str is a UUID -

-
+

nm_utils_is_uuid ()

+
gboolean
+nm_utils_is_uuid (const char *str);
+

Checks if str + is a UUID

+
+

Parameters

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

str

a string that might be a UUID

 
+
+
+

Returns

+

TRUE if str +is a UUID, FALSE if not

+

+
+

Since 0.9.8

+ +
+
+

nm_utils_inet4_ntop ()

+
const char *
+nm_utils_inet4_ntop (in_addr_t inaddr,
+                     char *dst);
+

Wrapper for inet_ntop.

+
+

Parameters

+
--+++ - - + + + - - + + +

str :

a string that might be a UUID

inaddr

the address that should be converted to string.

 

Returns :

-TRUE if str is a UUID, FALSE if not

dst

the destination buffer, it must contain at least +INET_ADDRSTRLEN or NM_UTILS_INET_ADDRSTRLEN +characters. If set to NULL, it will return a pointer to an internal, static +buffer (shared with nm_utils_inet6_ntop()). Beware, that the internal +buffer will be overwritten with ever new call of nm_utils_inet4_ntop() or +nm_utils_inet6_ntop() that does not provied it's own dst +buffer. Also, +using the internal buffer is not thread safe. When in doubt, pass your own +dst +buffer to avoid these issues.

 
-

Since 0.9.8

-
-
-

NM_UTILS_INET_ADDRSTRLEN

-
#define NM_UTILS_INET_ADDRSTRLEN     INET6_ADDRSTRLEN
-
-

-Defines the minimal length for a char buffer that is suitable as dst argument -for both nm_utils_inet4_ntop() and nm_utils_inet6_ntop(). -

+
+

Returns

+

the input buffer dst +, or a pointer to an +internal, static buffer. This function cannot fail.

+

+
+

Since 0.9.10


-

nm_utils_inet4_ntop ()

-
const char *        nm_utils_inet4_ntop                 (in_addr_t inaddr,
-                                                         char *dst);
-

-Wrapper for inet_ntop. -

-
+

nm_utils_inet6_ntop ()

+
const char *
+nm_utils_inet6_ntop (const struct in6_addr *in6addr,
+                     char *dst);
+

Wrapper for inet_ntop.

+
+

Parameters

+
--+++ - - + + + - - + - - - - +dst +buffer to avoid these issues.

+

inaddr :

the address that should be converted to string.

in6addr

the address that should be converted to string.

 

dst :

the destination buffer, it must contain at least -INET_ADDRSTRLEN or NM_UTILS_INET_ADDRSTRLEN -characters. If set to NULL, it will return a pointer to an internal, static -buffer (shared with nm_utils_inet6_ntop()). Beware, that the internal -buffer will be overwritten with ever new call of nm_utils_inet4_ntop() or -nm_utils_inet6_ntop() that does not provied it's own dst buffer. Also, +

dst

the destination buffer, it must contain at least +INET6_ADDRSTRLEN or NM_UTILS_INET_ADDRSTRLEN +characters. If set to NULL, it will return a pointer to an internal, static +buffer (shared with nm_utils_inet4_ntop()). Beware, that the internal +buffer will be overwritten with ever new call of nm_utils_inet4_ntop() or +nm_utils_inet6_ntop() that does not provied it's own dst +buffer. Also, using the internal buffer is not thread safe. When in doubt, pass your own -dst buffer to avoid these issues.

Returns :

the input buffer dst, or a pointer to an -internal, static buffer. This function cannot fail. 
+
+
+

Returns

+

the input buffer dst +, or a pointer to an +internal, static buffer. NULL is not allowed as in6addr +, +otherwise, this function cannot fail.

+

+

Since 0.9.10


-

nm_utils_inet6_ntop ()

-
const char *        nm_utils_inet6_ntop                 (const struct in6_addr *in6addr,
-                                                         char *dst);
-

-Wrapper for inet_ntop. -

-
+

nm_utils_check_virtual_device_compatibility ()

+
gboolean
+nm_utils_check_virtual_device_compatibility
+                               (GType virtual_type,
+                                GType other_type);
+

Determines if a connection of type virtual_type + can (in the +general case) work with connections of type other_type +.

+

If virtual_type + is NM_TYPE_SETTING_VLAN, then this checks if +other_type + is a valid type for the parent of a VLAN.

+

If virtual_type + is a "master" type (eg, NM_TYPE_SETTING_BRIDGE), +then this checks if other_type + is a valid type for a slave of that +master.

+

Note that even if this returns TRUE it is not guaranteed that +every connection of type other_type + is +compatible with virtual_type +; it may depend on the exact +configuration of the two connections, or on the capabilities of an +underlying device driver.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + +

in6addr :

the address that should be converted to string.

dst :

the destination buffer, it must contain at least -INET6_ADDRSTRLEN or NM_UTILS_INET_ADDRSTRLEN -characters. If set to NULL, it will return a pointer to an internal, static -buffer (shared with nm_utils_inet4_ntop()). Beware, that the internal -buffer will be overwritten with ever new call of nm_utils_inet4_ntop() or -nm_utils_inet6_ntop() that does not provied it's own dst buffer. Also, -using the internal buffer is not thread safe. When in doubt, pass your own -dst buffer to avoid these issues.

virtual_type

a virtual connection type

 

Returns :

the input buffer dst, or a pointer to an -internal, static buffer. NULL is not allowed as in6addr, -otherwise, this function cannot fail.

other_type

a connection type to test against virtual_type +

 
+
+
+

Returns

+

TRUE or FALSE

+

+

Since 0.9.10

-
+ +
+

Types and Values

-

nm_utils_check_virtual_device_compatibility ()

-
gboolean            nm_utils_check_virtual_device_compatibility
-                                                        (GType virtual_type,
-                                                         GType other_type);
-

-Determines if a connection of type virtual_type can (in the -general case) work with connections of type other_type. -

-

-If virtual_type is NM_TYPE_SETTING_VLAN, then this checks if -other_type is a valid type for the parent of a VLAN. -

-

-If virtual_type is a "master" type (eg, NM_TYPE_SETTING_BRIDGE), -then this checks if other_type is a valid type for a slave of that -master. -

-

-Note that even if this returns TRUE it is not guaranteed that -every connection of type other_type is -compatible with virtual_type; it may depend on the exact -configuration of the two connections, or on the capabilities of an -underlying device driver. -

-
+

enum NMUtilsSecurityType

+

Describes generic security mechanisms that 802.11 access points may offer. +Used with nm_utils_security_valid() for checking whether a given access +point is compatible with a network device.

+
+

Members

+
--+++ - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - - + + - - + +

virtual_type :

a virtual connection type

NMU_SEC_INVALID

+

unknown or invalid security, placeholder and not used

+
 

NMU_SEC_NONE

+

unencrypted and open

+
 

NMU_SEC_STATIC_WEP

+

static WEP keys are used for encryption

+
 

NMU_SEC_LEAP

+

Cisco LEAP is used for authentication and for generating the +dynamic WEP keys automatically

+
 

NMU_SEC_DYNAMIC_WEP

+

standard 802.1x is used for authentication and +generating the dynamic WEP keys automatically

+
 

NMU_SEC_WPA_PSK

+

WPA1 is used with Pre-Shared Keys (PSK)

+
 

NMU_SEC_WPA_ENTERPRISE

+

WPA1 is used with 802.1x authentication

+
 

other_type :

a connection type to test against virtual_type +

NMU_SEC_WPA2_PSK

+

WPA2/RSN is used with Pre-Shared Keys (PSK)

 

Returns :

-TRUE or FALSE +

NMU_SEC_WPA2_ENTERPRISE

+

WPA2 is used with 802.1x authentication

 
-

Since 0.9.10

+
+
+
+
+

NM_UTILS_HWADDR_LEN_MAX

+
#define NM_UTILS_HWADDR_LEN_MAX 20 /* INFINIBAND_ALEN */
+
+

The maximum length of hardware addresses handled by NetworkManager itself, +nm_utils_hwaddr_len(), and nm_utils_hwaddr_aton().

+
+
+
+

NM_UTILS_INET_ADDRSTRLEN

+
#define NM_UTILS_INET_ADDRSTRLEN     INET6_ADDRSTRLEN
+
+

Defines the minimal length for a char buffer that is suitable as dst + argument +for both nm_utils_inet4_ntop() and nm_utils_inet6_ntop().

+ Generated by GTK-Doc V1.21 \ No newline at end of file diff --git a/docs/libnm-util/html/libnm-util.devhelp2 b/docs/libnm-util/html/libnm-util.devhelp2 index 573c7c53..144f60eb 100644 --- a/docs/libnm-util/html/libnm-util.devhelp2 +++ b/docs/libnm-util/html/libnm-util.devhelp2 @@ -40,115 +40,137 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + + + - - + + - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + - + - @@ -163,48 +185,46 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - + - @@ -216,46 +236,45 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - + - @@ -273,51 +292,56 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - + - - + @@ -335,116 +359,90 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + - + - - - - - - - - + + + + + + + + + - + - - - - - - - - - - - - - - + + + + + + + + + + + - + - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + - + - @@ -456,51 +454,44 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + - + - - - - - - - - + + + + + + + + + + + + + - + - @@ -518,24 +509,21 @@ - - - - - - - - - - - - - - + + + + + + + + + + + + - + - @@ -544,146 +532,129 @@ - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + - + - - - - - - - - - - + + + + + + + - + - - - - - - - - + + + + + - + - - - - - - + + + - + - - - - + + + + + + + - + - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + - + - - - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + - + - - - - - - - - - - + + + + + + + + + + + + - + - @@ -696,28 +667,40 @@ - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - + - - + @@ -735,51 +718,95 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - + - @@ -812,112 +839,100 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - + - @@ -936,85 +951,80 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - + - @@ -1033,84 +1043,42 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - + - @@ -1129,150 +1097,125 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + + - + - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - - - - - - - - - - - - - - - - @@ -1389,362 +1332,5 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - diff --git a/docs/libnm-util/html/object-tree.html b/docs/libnm-util/html/object-tree.html index c073e707..0efce8c7 100644 --- a/docs/libnm-util/html/object-tree.html +++ b/docs/libnm-util/html/object-tree.html @@ -2,108 +2,108 @@ -Object Hierarchy +libnm-util Reference Manual: Object Hierarchy - + - - - - - - + + + + + +

Object Hierarchy

-    GObject
-        NMSetting
-            NMSetting8021x
-            NMSettingAdsl
-            NMSettingBluetooth
-            NMSettingBond
-            NMSettingTeam
-            NMSettingTeamPort
-            NMSettingBridge
-            NMSettingBridgePort
-            NMSettingConnection
-            NMSettingDcb
-            NMSettingInfiniband
-            NMSettingIP4Config
-            NMSettingVlan
-            NMSettingIP6Config
-            NMSettingPPP
-            NMSettingPPPOE
-            NMSettingSerial
-            NMSettingGeneric
-            NMSettingGsm
-            NMSettingCdma
-            NMSettingOlpcMesh
-            NMSettingWimax
-            NMSettingWired
-            NMSettingWireless
-            NMSettingWirelessSecurity
-            NMSettingVPN
-        NMConnection
-    GEnum
-        NMConnectionError
-        NMSetting8021xCKFormat
-        NMSetting8021xCKScheme
-        NMSetting8021xError
-        NMSettingAdslError
-        NMSettingBluetoothError
-        NMSettingBondError
-        NMSettingBridgeError
-        NMSettingBridgePortError
-        NMSettingCdmaError
-        NMSettingCompareFlags
-        NMSettingConnectionError
-        NMSettingDcbError
-        NMSettingDcbFlags
-        NMSettingDiffResult
-        NMSettingError
-        NMSettingGenericError
-        NMSettingGsmError
-        NMSettingGsmNetworkBand
-        NMSettingGsmNetworkType
-        NMSettingHashFlags
-        NMSettingInfinibandError
-        NMSettingIP4ConfigError
-        NMSettingIP6ConfigError
-        NMSettingIP6ConfigPrivacy
-        NMSettingOlpcMeshError
-        NMSettingPPPError
-        NMSettingPPPOEError
-        NMSettingSecretFlags
-        NMSettingSerialError
-        NMSettingTeamError
-        NMSettingTeamPortError
-        NMSettingVlanError
-        NMSettingVpnError
-        NMSettingWimaxError
-        NMSettingWiredError
-        NMSettingWirelessError
-        NMSettingWirelessSecurityError
-        NMUtilsSecurityType
-        NMVlanFlags
-        NMVlanPriorityMap
-        NMWepKeyType
-    GBoxed
-        NMIP4Address
-        NMIP4Route
-        NMIP6Address
-        NMIP6Route
+    GObject
+    ├── NMSetting
+       ├── NMSetting8021x
+       ├── NMSettingAdsl
+       ├── NMSettingBluetooth
+       ├── NMSettingBond
+       ├── NMSettingTeam
+       ├── NMSettingTeamPort
+       ├── NMSettingBridge
+       ├── NMSettingBridgePort
+       ├── NMSettingConnection
+       ├── NMSettingDcb
+       ├── NMSettingInfiniband
+       ├── NMSettingIP4Config
+       ├── NMSettingVlan
+       ├── NMSettingIP6Config
+       ├── NMSettingPPP
+       ├── NMSettingPPPOE
+       ├── NMSettingSerial
+       ├── NMSettingGeneric
+       ├── NMSettingGsm
+       ├── NMSettingCdma
+       ├── NMSettingOlpcMesh
+       ├── NMSettingWimax
+       ├── NMSettingWired
+       ├── NMSettingWireless
+       ├── NMSettingWirelessSecurity
+       ╰── NMSettingVPN
+    ╰── NMConnection
+    GEnum
+    ├── NMConnectionError
+    ├── NMSetting8021xCKFormat
+    ├── NMSetting8021xCKScheme
+    ├── NMSetting8021xError
+    ├── NMSettingAdslError
+    ├── NMSettingBluetoothError
+    ├── NMSettingBondError
+    ├── NMSettingBridgeError
+    ├── NMSettingBridgePortError
+    ├── NMSettingCdmaError
+    ├── NMSettingCompareFlags
+    ├── NMSettingConnectionError
+    ├── NMSettingDcbError
+    ├── NMSettingDcbFlags
+    ├── NMSettingDiffResult
+    ├── NMSettingError
+    ├── NMSettingGenericError
+    ├── NMSettingGsmError
+    ├── NMSettingGsmNetworkBand
+    ├── NMSettingGsmNetworkType
+    ├── NMSettingHashFlags
+    ├── NMSettingInfinibandError
+    ├── NMSettingIP4ConfigError
+    ├── NMSettingIP6ConfigError
+    ├── NMSettingIP6ConfigPrivacy
+    ├── NMSettingOlpcMeshError
+    ├── NMSettingPPPError
+    ├── NMSettingPPPOEError
+    ├── NMSettingSecretFlags
+    ├── NMSettingSerialError
+    ├── NMSettingTeamError
+    ├── NMSettingTeamPortError
+    ├── NMSettingVlanError
+    ├── NMSettingVpnError
+    ├── NMSettingWimaxError
+    ├── NMSettingWiredError
+    ├── NMSettingWirelessError
+    ├── NMSettingWirelessSecurityError
+    ├── NMUtilsSecurityType
+    ├── NMVlanFlags
+    ├── NMVlanPriorityMap
+    ╰── NMWepKeyType
+    GBoxed
+    ├── NMIP4Address
+    ├── NMIP4Route
+    ├── NMIP6Address
+    ╰── NMIP6Route
 
+ Generated by GTK-Doc V1.21 \ No newline at end of file diff --git a/docs/libnm-util/html/right-insensitive.png b/docs/libnm-util/html/right-insensitive.png new file mode 100644 index 00000000..4c95785b Binary files /dev/null and b/docs/libnm-util/html/right-insensitive.png differ diff --git a/docs/libnm-util/html/right.png b/docs/libnm-util/html/right.png index 92832e3a..76260ec8 100644 Binary files a/docs/libnm-util/html/right.png and b/docs/libnm-util/html/right.png differ diff --git a/docs/libnm-util/html/style.css b/docs/libnm-util/html/style.css index d6f6c26e..c141ddd2 100644 --- a/docs/libnm-util/html/style.css +++ b/docs/libnm-util/html/style.css @@ -1,15 +1,23 @@ +body +{ + font-family: cantarell, sans-serif; +} .synopsis, .classsynopsis { /* tango:aluminium 1/2 */ background: #eeeeec; - border: solid 1px #d3d7cf; + background: rgba(238, 238, 236, 0.5); + border: solid 1px rgb(238, 238, 236); padding: 0.5em; } .programlisting { /* tango:sky blue 0/1 */ + /* fallback for no rgba support */ background: #e6f3ff; border: solid 1px #729fcf; + background: rgba(114, 159, 207, 0.1); + border: solid 1px rgba(114, 159, 207, 0.2); padding: 0.5em; } .variablelist @@ -22,89 +30,6 @@ vertical-align: top; } -@media screen { - sup a.footnote - { - position: relative; - top: 0em ! important; - - } - /* this is needed so that the local anchors are displayed below the naviagtion */ - div.footnote a[name], div.refnamediv a[name], div.refsect1 a[name], div.refsect2 a[name], div.index a[name], div.glossary a[name], div.sect1 a[name] - { - display: inline-block; - position: relative; - top:-5em; - } - /* this seems to be a bug in the xsl style sheets when generating indexes */ - div.index div.index - { - top: 0em; - } - /* make space for the fixed navigation bar and add space at the bottom so that - * link targets appear somewhat close to top - */ - body - { - padding-top: 3.2em; - padding-bottom: 20em; - } - /* style and size the navigation bar */ - table.navigation#top - { - position: fixed; - /* tango:scarlet red 0/1 */ - background: #ffe6e6; - border: solid 1px #ef2929; - margin-top: 0; - margin-bottom: 0; - top: 0; - left: 0; - height: 3em; - z-index: 10; - } - .navigation a, .navigation a:visited - { - /* tango:scarlet red 3 */ - color: #a40000; - } - .navigation a:hover - { - /* tango:scarlet red 1 */ - color: #ef2929; - } - td.shortcuts - { - /* tango:scarlet red 1 */ - color: #ef2929; - font-size: 80%; - white-space: nowrap; - } -} -@media print { - table.navigation { - visibility: collapse; - display: none; - } - div.titlepage table.navigation { - visibility: visible; - display: table; - /* tango:scarlet red 0/1 */ - background: #ffe6e6; - border: solid 1px #ef2929; - margin-top: 0; - margin-bottom: 0; - top: 0; - left: 0; - height: 3em; - } -} - -.navigation .title -{ - font-size: 200%; -} - div.gallery-float { float: left; @@ -132,6 +57,72 @@ a:hover color: #729fcf; } +div.informaltable table +{ + border-collapse: separate; + border-spacing: 1em 0.5em; + border: none; +} + +div.informaltable table td, div.informaltable table th +{ + vertical-align: top; +} + +.function_type, +.variable_type, +.property_type, +.signal_type, +.parameter_name, +.struct_member_name, +.union_member_name, +.define_keyword, +.datatype_keyword, +.typedef_keyword +{ + text-align: right; +} + +/* dim non-primary columns */ +.c_punctuation, +.function_type, +.variable_type, +.property_type, +.signal_type, +.define_keyword, +.datatype_keyword, +.typedef_keyword, +.property_flags, +.signal_flags, +.parameter_annotations, +.enum_member_annotations, +.struct_member_annotations, +.union_member_annotations +{ + color: #888a85; +} + +.function_type a, +.function_type a:visited, +.function_type a:hover, +.property_type a, +.property_type a:visited, +.property_type a:hover, +.signal_type a, +.signal_type a:visited, +.signal_type a:hover, +.signal_flags a, +.signal_flags a:visited, +.signal_flags a:hover +{ + color: #729fcf; +} + +td p +{ + margin: 0.25em; +} + div.table table { border-collapse: collapse; @@ -154,14 +145,43 @@ div.table table th background-color: #d3d7cf; } +h4 +{ + color: #555753; +} + hr { - /* tango:aluminium 3 */ - color: #babdb6; - background: #babdb6; + /* tango:aluminium 1 */ + color: #d3d7cf; + background: #d3d7cf; border: none 0px; height: 1px; clear: both; + margin: 2.0em 0em 2.0em 0em; +} + +dl.toc dt +{ + padding-bottom: 0.25em; +} + +dl.toc > dd > dl > dt +{ + padding-top: 0.25em; + padding-bottom: 0.25em; +} + +dl.toc > dt +{ + padding-top: 1em; + padding-bottom: 0.5em; + font-weight: bold; +} + +.parameter +{ + font-style: normal; } .footer @@ -173,31 +193,70 @@ hr font-size: 80%; } +.informalfigure, +.figure +{ + margin: 1em; +} + +.informalexample, +.example +{ + margin-top: 1em; + margin-bottom: 1em; +} + .warning { /* tango:orange 0/1 */ background: #ffeed9; + background: rgba(252, 175, 62, 0.1); border-color: #ffb04f; + border-color: rgba(252, 175, 62, 0.2); } .note { /* tango:chameleon 0/0.5 */ background: #d8ffb2; + background: rgba(138, 226, 52, 0.1); border-color: #abf562; + border-color: rgba(138, 226, 52, 0.2); } -.note, .warning +div.blockquote +{ + border-color: #eeeeec; +} +.note, .warning, div.blockquote { padding: 0.5em; border-width: 1px; border-style: solid; + margin: 2em; } -.note h3, .warning h3 +.note p, .warning p { - margin-top: 0.0em + margin: 0; } -.note p, .warning p + +div.warning h3.title, +div.note h3.title +{ + display: none; +} + +p + div.section { - margin-bottom: 0.0em + margin-top: 1em; +} + +div.refnamediv, +div.refsynopsisdiv, +div.refsect1, +div.refsect2, +div.toc, +div.section +{ + margin-bottom: 1em; } /* blob links */ @@ -210,33 +269,52 @@ h2 .extralinks, h3 .extralinks font-weight: normal; } +.lineart +{ + color: #d3d7cf; + font-weight: normal; +} + .annotation { /* tango:aluminium 5 */ color: #555753; - font-size: 80%; font-weight: normal; } +.structfield +{ + font-style: normal; + font-weight: normal; +} + +acronym,abbr +{ + border-bottom: 1px dotted gray; +} + /* code listings */ -.listing_code .programlisting .cbracket { color: #a40000; } /* tango: scarlet red 3 */ -.listing_code .programlisting .comment { color: #a1a39d; } /* tango: aluminium 4 */ -.listing_code .programlisting .function { color: #000000; font-weight: bold; } -.listing_code .programlisting .function a { color: #11326b; font-weight: bold; } /* tango: sky blue 4 */ -.listing_code .programlisting .keyword { color: #4e9a06; } /* tango: chameleon 3 */ +.listing_code .programlisting .normal, +.listing_code .programlisting .normal a, +.listing_code .programlisting .number, +.listing_code .programlisting .cbracket, +.listing_code .programlisting .symbol { color: #555753; } +.listing_code .programlisting .comment, .listing_code .programlisting .linenum { color: #babdb6; } /* tango: aluminium 3 */ -.listing_code .programlisting .normal { color: #000000; } -.listing_code .programlisting .number { color: #75507b; } /* tango: plum 2 */ +.listing_code .programlisting .function, +.listing_code .programlisting .function a, .listing_code .programlisting .preproc { color: #204a87; } /* tango: sky blue 3 */ -.listing_code .programlisting .string { color: #c17d11; } /* tango: chocolate 2 */ -.listing_code .programlisting .type { color: #000000; } -.listing_code .programlisting .type a { color: #11326b; } /* tango: sky blue 4 */ -.listing_code .programlisting .symbol { color: #ce5c00; } /* tango: orange 3 */ +.listing_code .programlisting .string { color: #ad7fa8; } /* tango: plum */ +.listing_code .programlisting .keyword, +.listing_code .programlisting .usertype, +.listing_code .programlisting .type, +.listing_code .programlisting .type a { color: #4e9a06; } /* tango: chameleon 3 */ .listing_frame { /* tango:sky blue 1 */ border: solid 1px #729fcf; + border: solid 1px rgba(114, 159, 207, 0.2); padding: 0px; } @@ -248,19 +326,151 @@ h2 .extralinks, h3 .extralinks .listing_lines { /* tango:sky blue 0.5 */ background: #a6c5e3; + background: rgba(114, 159, 207, 0.2); /* tango:aluminium 6 */ color: #2e3436; } .listing_code { /* tango:sky blue 0 */ background: #e6f3ff; + background: rgba(114, 159, 207, 0.1); } .listing_code .programlisting { /* override from previous */ border: none 0px; padding: 0px; + background: none; } .listing_lines pre, .listing_code pre { margin: 0px; } +@media screen { + sup a.footnote + { + position: relative; + top: 0em ! important; + } + /* this is needed so that the local anchors are displayed below the naviagtion */ + div.footnote a[name], div.refnamediv a[name], div.refsect1 a[name], div.refsect2 a[name], div.index a[name], div.glossary a[name], div.sect1 a[name] + { + display: inline-block; + position: relative; + top:-5em; + } + /* this seems to be a bug in the xsl style sheets when generating indexes */ + div.index div.index + { + top: 0em; + } + /* make space for the fixed navigation bar and add space at the bottom so that + * link targets appear somewhat close to top + */ + body + { + padding-top: 2.5em; + padding-bottom: 500px; + max-width: 60em; + } + p + { + max-width: 60em; + } + /* style and size the navigation bar */ + table.navigation#top + { + position: fixed; + background: #e2e2e2; + border-bottom: solid 1px #babdb6; + border-spacing: 5px; + margin-top: 0; + margin-bottom: 0; + top: 0; + left: 0; + z-index: 10; + } + table.navigation#top td + { + padding-left: 6px; + padding-right: 6px; + } + .navigation a, .navigation a:visited + { + /* tango:sky blue 3 */ + color: #204a87; + } + .navigation a:hover + { + /* tango:sky blue 2 */ + color: #3465a4; + } + td.shortcuts + { + /* tango:sky blue 2 */ + color: #3465a4; + font-size: 80%; + white-space: nowrap; + } + td.shortcuts .dim + { + color: #babdb6; + } + .navigation .title + { + font-size: 80%; + max-width: none; + margin: 0px; + font-weight: normal; + } +} +@media screen and (min-width: 60em) { + /* screen larger than 60em */ + body { margin: auto; } +} +@media screen and (max-width: 60em) { + /* screen less than 60em */ + #nav_hierarchy { display: none; } + #nav_interfaces { display: none; } + #nav_prerequisites { display: none; } + #nav_derived_interfaces { display: none; } + #nav_implementations { display: none; } + #nav_child_properties { display: none; } + #nav_style_properties { display: none; } + #nav_index { display: none; } + #nav_glossary { display: none; } + .gallery_image { display: none; } + .property_flags { display: none; } + .signal_flags { display: none; } + .parameter_annotations { display: none; } + .enum_member_annotations { display: none; } + .struct_member_annotations { display: none; } + .union_member_annotations { display: none; } + /* now that a column is hidden, optimize space */ + col.parameters_name { width: auto; } + col.parameters_description { width: auto; } + col.struct_members_name { width: auto; } + col.struct_members_description { width: auto; } + col.enum_members_name { width: auto; } + col.enum_members_description { width: auto; } + col.union_members_name { width: auto; } + col.union_members_description { width: auto; } + .listing_lines { display: none; } +} +@media print { + table.navigation { + visibility: collapse; + display: none; + } + div.titlepage table.navigation { + visibility: visible; + display: table; + background: #e2e2e2; + border: solid 1px #babdb6; + margin-top: 0; + margin-bottom: 0; + top: 0; + left: 0; + height: 3em; + } +} + diff --git a/docs/libnm-util/html/up-insensitive.png b/docs/libnm-util/html/up-insensitive.png new file mode 100644 index 00000000..f4049860 Binary files /dev/null and b/docs/libnm-util/html/up-insensitive.png differ diff --git a/docs/libnm-util/html/up.png b/docs/libnm-util/html/up.png index 85b3e2a2..80b4b37e 100644 Binary files a/docs/libnm-util/html/up.png and b/docs/libnm-util/html/up.png differ diff --git a/docs/libnm-util/libnm-util-sections.txt b/docs/libnm-util/libnm-util-sections.txt index 89afa31a..839ba681 100644 --- a/docs/libnm-util/libnm-util-sections.txt +++ b/docs/libnm-util/libnm-util-sections.txt @@ -134,7 +134,6 @@ NM_CONNECTION_NORMALIZE_PARAM_IP6_CONFIG_METHOD NM_CONNECTION_ERROR nm_connection_error_quark NMConnection -NMConnectionClass nm_connection_new nm_connection_new_from_hash nm_connection_duplicate @@ -194,6 +193,7 @@ nm_connection_get_setting_wireless nm_connection_get_setting_wireless_security nm_connection_get_setting_vlan +NMConnectionClass NM_CONNECTION NM_CONNECTION_CLASS NM_CONNECTION_GET_CLASS @@ -218,7 +218,6 @@ NMSettingSecretFlags NMSettingCompareFlags NMSetting NMSettingClearSecretsWithFlagsFn -NMSettingClass NMSettingValueIterFn NMSettingHashFlags nm_setting_to_hash @@ -239,6 +238,7 @@ nm_setting_get_secret_flags nm_setting_set_secret_flags nm_setting_get_virtual_iface_name +NMSettingClass NM_IS_SETTING NM_IS_SETTING_CLASS NM_SETTING @@ -289,8 +289,6 @@ NM_SETTING_802_1X_PHASE2_PRIVATE_KEY_PASSWORD_FLAGS NM_SETTING_802_1X_PIN NM_SETTING_802_1X_PIN_FLAGS NM_SETTING_802_1X_SYSTEM_CA_CERTS -NMSetting8021x -NMSetting8021xClass nm_setting_802_1x_new nm_setting_802_1x_get_num_eap_methods nm_setting_802_1x_get_eap_method @@ -360,6 +358,8 @@ nm_setting_802_1x_get_phase2_private_key_password nm_setting_802_1x_get_phase2_private_key_password_flags nm_setting_802_1x_get_phase2_private_key_format +NMSetting8021x +NMSetting8021xClass NM_IS_SETTING_802_1X NM_IS_SETTING_802_1X_CLASS NM_SETTING_802_1X @@ -388,8 +388,6 @@ NM_SETTING_ADSL_PROTOCOL_PPPOE NM_SETTING_ADSL_PROTOCOL_IPOATM NM_SETTING_ADSL_ENCAPSULATION_VCMUX NM_SETTING_ADSL_ENCAPSULATION_LLC -NMSettingAdsl -NMSettingAdslClass nm_setting_adsl_new nm_setting_adsl_get_username nm_setting_adsl_get_password @@ -399,6 +397,8 @@ nm_setting_adsl_get_vpi nm_setting_adsl_get_vci nm_setting_adsl_get_password_flags +NMSettingAdsl +NMSettingAdslClass NM_IS_SETTING_ADSL NM_IS_SETTING_ADSL_CLASS NM_SETTING_ADSL @@ -419,12 +419,12 @@ NM_SETTING_BLUETOOTH_BDADDR NM_SETTING_BLUETOOTH_TYPE NM_SETTING_BLUETOOTH_TYPE_DUN NM_SETTING_BLUETOOTH_TYPE_PANU -NMSettingBluetooth -NMSettingBluetoothClass nm_setting_bluetooth_new nm_setting_bluetooth_get_bdaddr nm_setting_bluetooth_get_connection_type +NMSettingBluetooth +NMSettingBluetoothClass NM_IS_SETTING_BLUETOOTH NM_IS_SETTING_BLUETOOTH_CLASS NM_SETTING_BLUETOOTH @@ -458,8 +458,6 @@ NM_SETTING_BOND_OPTION_AD_SELECT NM_SETTING_BOND_OPTION_XMIT_HASH_POLICY NM_SETTING_BOND_OPTION_RESEND_IGMP NM_SETTING_BOND_OPTION_LACP_RATE -NMSettingBond -NMSettingBondClass nm_setting_bond_new nm_setting_bond_get_interface_name nm_setting_bond_get_num_options @@ -471,6 +469,8 @@ nm_setting_bond_validate_option nm_setting_bond_get_valid_options nm_setting_bond_get_option_default +NMSettingBond +NMSettingBondClass NM_IS_SETTING_BOND NM_IS_SETTING_BOND_CLASS NM_SETTING_BOND @@ -495,8 +495,6 @@ NM_SETTING_BRIDGE_FORWARD_DELAY NM_SETTING_BRIDGE_HELLO_TIME NM_SETTING_BRIDGE_MAX_AGE NM_SETTING_BRIDGE_AGEING_TIME -NMSettingBridge -NMSettingBridgeClass nm_setting_bridge_new nm_setting_bridge_get_interface_name nm_setting_bridge_get_mac_address @@ -507,6 +505,8 @@ nm_setting_bridge_get_hello_time nm_setting_bridge_get_max_age nm_setting_bridge_get_ageing_time +NMSettingBridge +NMSettingBridgeClass NM_IS_SETTING_BRIDGE NM_IS_SETTING_BRIDGE_CLASS NM_SETTING_BRIDGE @@ -526,13 +526,13 @@ nm_setting_bridge_port_error_quark NM_SETTING_BRIDGE_PORT_PRIORITY NM_SETTING_BRIDGE_PORT_PATH_COST NM_SETTING_BRIDGE_PORT_HAIRPIN_MODE -NMSettingBridgePort -NMSettingBridgePortClass nm_setting_bridge_port_new nm_setting_bridge_port_get_priority nm_setting_bridge_port_get_path_cost nm_setting_bridge_port_get_hairpin_mode +NMSettingBridgePort +NMSettingBridgePortClass NM_IS_SETTING_BRIDGE_PORT NM_IS_SETTING_BRIDGE_PORT_CLASS NM_SETTING_BRIDGE_PORT @@ -553,14 +553,14 @@ NM_SETTING_CDMA_NUMBER NM_SETTING_CDMA_USERNAME NM_SETTING_CDMA_PASSWORD NM_SETTING_CDMA_PASSWORD_FLAGS -NMSettingCdma -NMSettingCdmaClass nm_setting_cdma_new nm_setting_cdma_get_number nm_setting_cdma_get_username nm_setting_cdma_get_password nm_setting_cdma_get_password_flags +NMSettingCdma +NMSettingCdmaClass NM_IS_SETTING_CDMA NM_IS_SETTING_CDMA_CLASS NM_SETTING_CDMA @@ -591,7 +591,6 @@ NM_SETTING_CONNECTION_SLAVE_TYPE NM_SETTING_CONNECTION_SECONDARIES NM_SETTING_CONNECTION_GATEWAY_PING_TIMEOUT NMSettingConnection -NMSettingConnectionClass nm_setting_connection_new nm_setting_connection_get_id nm_setting_connection_get_uuid @@ -617,6 +616,7 @@ nm_setting_connection_remove_secondary nm_setting_connection_remove_secondary_by_value nm_setting_connection_get_gateway_ping_timeout +NMSettingConnectionClass NM_IS_SETTING_CONNECTION NM_IS_SETTING_CONNECTION_CLASS NM_SETTING_CONNECTION @@ -651,8 +651,6 @@ NM_SETTING_DCB_PRIORITY_GROUP_BANDWIDTH NM_SETTING_DCB_PRIORITY_BANDWIDTH NM_SETTING_DCB_PRIORITY_STRICT_BANDWIDTH NM_SETTING_DCB_PRIORITY_TRAFFIC_CLASS -NMSettingDcb -NMSettingDcbClass nm_setting_dcb_new nm_setting_dcb_get_app_fcoe_flags nm_setting_dcb_get_app_fcoe_priority @@ -676,6 +674,8 @@ nm_setting_dcb_set_priority_strict_bandwidth nm_setting_dcb_get_priority_traffic_class nm_setting_dcb_set_priority_traffic_class +NMSettingDcb +NMSettingDcbClass NM_IS_SETTING_DCB NM_IS_SETTING_DCB_CLASS NM_SETTING_DCB @@ -692,10 +692,10 @@ NM_SETTING_GENERIC_SETTING_NAME NMSettingGenericError NM_SETTING_GENERIC_ERROR nm_setting_generic_error_quark -NMSettingGeneric -NMSettingGenericClass nm_setting_generic_new +NMSettingGeneric +NMSettingGenericClass NM_IS_SETTING_GENERIC NM_IS_SETTING_GENERIC_CLASS NM_SETTING_GENERIC @@ -726,8 +726,6 @@ NM_SETTING_GSM_NETWORK_TYPE NMSettingGsmNetworkType NMSettingGsmNetworkBand NM_SETTING_GSM_BANDS_MAX -NMSettingGsm -NMSettingGsmClass nm_setting_gsm_new nm_setting_gsm_get_number nm_setting_gsm_get_username @@ -741,6 +739,8 @@ nm_setting_gsm_get_password_flags nm_setting_gsm_get_network_type nm_setting_gsm_get_allowed_bands +NMSettingGsm +NMSettingGsmClass NM_IS_SETTING_GSM NM_IS_SETTING_GSM_CLASS NM_SETTING_GSM @@ -762,8 +762,6 @@ NM_SETTING_INFINIBAND_MTU NM_SETTING_INFINIBAND_TRANSPORT_MODE NM_SETTING_INFINIBAND_P_KEY NM_SETTING_INFINIBAND_PARENT -NMSettingInfiniband -NMSettingInfinibandClass nm_setting_infiniband_new nm_setting_infiniband_get_mac_address nm_setting_infiniband_get_mtu @@ -771,6 +769,8 @@ nm_setting_infiniband_get_transport_mode nm_setting_infiniband_get_p_key nm_setting_infiniband_get_parent +NMSettingInfiniband +NMSettingInfinibandClass NM_IS_SETTING_INFINIBAND NM_IS_SETTING_INFINIBAND_CLASS NM_SETTING_INFINIBAND @@ -805,7 +805,6 @@ NM_SETTING_IP4_CONFIG_METHOD_LINK_LOCAL NM_SETTING_IP4_CONFIG_METHOD_MANUAL NM_SETTING_IP4_CONFIG_METHOD_SHARED NM_SETTING_IP4_CONFIG_METHOD_DISABLED -NMIP4Address nm_ip4_address_new nm_ip4_address_dup nm_ip4_address_ref @@ -817,7 +816,6 @@ nm_ip4_address_get_prefix nm_ip4_address_set_prefix nm_ip4_address_get_gateway nm_ip4_address_set_gateway -NMIP4Route nm_ip4_route_new nm_ip4_route_dup nm_ip4_route_ref @@ -831,8 +829,6 @@ nm_ip4_route_get_next_hop nm_ip4_route_set_next_hop nm_ip4_route_get_metric nm_ip4_route_set_metric -NMSettingIP4Config -NMSettingIP4ConfigClass nm_setting_ip4_config_new nm_setting_ip4_config_get_method nm_setting_ip4_config_get_num_dns @@ -868,6 +864,10 @@ nm_setting_ip4_config_get_dhcp_hostname nm_setting_ip4_config_get_never_default nm_setting_ip4_config_get_may_fail +NMIP4Address +NMIP4Route +NMSettingIP4Config +NMSettingIP4ConfigClass NM_IS_SETTING_IP4_CONFIG NM_IS_SETTING_IP4_CONFIG_CLASS NM_SETTING_IP4_CONFIG @@ -905,7 +905,6 @@ NM_SETTING_IP6_CONFIG_METHOD_LINK_LOCAL NM_SETTING_IP6_CONFIG_METHOD_MANUAL NM_SETTING_IP6_CONFIG_METHOD_SHARED NMSettingIP6ConfigPrivacy -NMIP6Address nm_ip6_address_new nm_ip6_address_dup nm_ip6_address_ref @@ -917,7 +916,6 @@ nm_ip6_address_get_prefix nm_ip6_address_set_prefix nm_ip6_address_get_gateway nm_ip6_address_set_gateway -NMIP6Route nm_ip6_route_new nm_ip6_route_dup nm_ip6_route_ref @@ -931,8 +929,6 @@ nm_ip6_route_get_next_hop nm_ip6_route_set_next_hop nm_ip6_route_get_metric nm_ip6_route_set_metric -NMSettingIP6Config -NMSettingIP6ConfigClass nm_setting_ip6_config_new nm_setting_ip6_config_get_method nm_setting_ip6_config_get_num_dns @@ -967,6 +963,10 @@ nm_setting_ip6_config_get_never_default nm_setting_ip6_config_get_may_fail nm_setting_ip6_config_get_ip6_privacy +NMIP6Address +NMIP6Route +NMSettingIP6Config +NMSettingIP6ConfigClass NM_IS_SETTING_IP6_CONFIG NM_IS_SETTING_IP6_CONFIG_CLASS NM_SETTING_IP6_CONFIG @@ -988,13 +988,13 @@ nm_setting_olpc_mesh_error_quark NM_SETTING_OLPC_MESH_SSID NM_SETTING_OLPC_MESH_CHANNEL NM_SETTING_OLPC_MESH_DHCP_ANYCAST_ADDRESS -NMSettingOlpcMesh -NMSettingOlpcMeshClass nm_setting_olpc_mesh_new nm_setting_olpc_mesh_get_ssid nm_setting_olpc_mesh_get_channel nm_setting_olpc_mesh_get_dhcp_anycast_address +NMSettingOlpcMesh +NMSettingOlpcMeshClass NM_IS_SETTING_OLPC_MESH NM_IS_SETTING_OLPC_MESH_CLASS NM_SETTING_OLPC_MESH @@ -1029,8 +1029,6 @@ NM_SETTING_PPP_MRU NM_SETTING_PPP_MTU NM_SETTING_PPP_LCP_ECHO_FAILURE NM_SETTING_PPP_LCP_ECHO_INTERVAL -NMSettingPPP -NMSettingPPPClass nm_setting_ppp_new nm_setting_ppp_get_noauth nm_setting_ppp_get_refuse_eap @@ -1051,6 +1049,8 @@ nm_setting_ppp_get_mtu nm_setting_ppp_get_lcp_echo_failure nm_setting_ppp_get_lcp_echo_interval +NMSettingPPP +NMSettingPPPClass NM_IS_SETTING_PPP NM_IS_SETTING_PPP_CLASS NM_SETTING_PPP @@ -1071,14 +1071,14 @@ NM_SETTING_PPPOE_SERVICE NM_SETTING_PPPOE_USERNAME NM_SETTING_PPPOE_PASSWORD NM_SETTING_PPPOE_PASSWORD_FLAGS -NMSettingPPPOE -NMSettingPPPOEClass nm_setting_pppoe_new nm_setting_pppoe_get_service nm_setting_pppoe_get_username nm_setting_pppoe_get_password nm_setting_pppoe_get_password_flags +NMSettingPPPOE +NMSettingPPPOEClass NM_IS_SETTING_PPPOE NM_IS_SETTING_PPPOE_CLASS NM_SETTING_PPPOE @@ -1100,8 +1100,6 @@ NM_SETTING_SERIAL_BITS NM_SETTING_SERIAL_PARITY NM_SETTING_SERIAL_STOPBITS NM_SETTING_SERIAL_SEND_DELAY -NMSettingSerial -NMSettingSerialClass nm_setting_serial_new nm_setting_serial_get_baud nm_setting_serial_get_bits @@ -1109,6 +1107,8 @@ nm_setting_serial_get_parity nm_setting_serial_get_stopbits nm_setting_serial_get_send_delay +NMSettingSerial +NMSettingSerialClass NM_IS_SETTING_SERIAL NM_IS_SETTING_SERIAL_CLASS NM_SETTING_SERIAL @@ -1127,12 +1127,12 @@ NM_SETTING_TEAM_ERROR nm_setting_team_error_quark NM_SETTING_TEAM_INTERFACE_NAME NM_SETTING_TEAM_CONFIG -NMSettingTeam -NMSettingTeamClass nm_setting_team_new nm_setting_team_get_interface_name nm_setting_team_get_config +NMSettingTeam +NMSettingTeamClass NM_IS_SETTING_TEAM NM_IS_SETTING_TEAM_CLASS NM_SETTING_TEAM @@ -1150,11 +1150,11 @@ NMSettingTeamPortError NM_SETTING_TEAM_PORT_ERROR nm_setting_team_port_error_quark NM_SETTING_TEAM_PORT_CONFIG -NMSettingTeamPort -NMSettingTeamPortClass nm_setting_team_port_new nm_setting_team_port_get_config +NMSettingTeamPort +NMSettingTeamPortClass NM_IS_SETTING_TEAM_PORT NM_IS_SETTING_TEAM_PORT_CLASS NM_SETTING_TEAM_PORT @@ -1177,8 +1177,6 @@ NM_SETTING_VLAN_ID NM_SETTING_VLAN_FLAGS NM_SETTING_VLAN_INGRESS_PRIORITY_MAP NM_SETTING_VLAN_EGRESS_PRIORITY_MAP -NMSettingVlan -NMSettingVlanClass NMVlanPriorityMap NMVlanFlags nm_setting_vlan_new @@ -1195,6 +1193,8 @@ nm_setting_vlan_remove_priority_str_by_value nm_setting_vlan_clear_priorities nm_setting_vlan_add_priority_str +NMSettingVlan +NMSettingVlanClass NM_IS_SETTING_VLAN NM_IS_SETTING_VLAN_CLASS NM_SETTING_VLAN @@ -1216,8 +1216,6 @@ NM_SETTING_VPN_USER_NAME NM_SETTING_VPN_PERSISTENT NM_SETTING_VPN_DATA NM_SETTING_VPN_SECRETS -NMSettingVPN -NMSettingVPNClass NMVPNIterFunc nm_setting_vpn_new nm_setting_vpn_get_service_type @@ -1234,6 +1232,8 @@ nm_setting_vpn_get_secret nm_setting_vpn_remove_secret nm_setting_vpn_foreach_secret +NMSettingVPN +NMSettingVPNClass NM_IS_SETTING_VPN NM_IS_SETTING_VPN_CLASS NM_SETTING_VPN @@ -1252,12 +1252,12 @@ NM_SETTING_WIMAX_ERROR nm_setting_wimax_error_quark NM_SETTING_WIMAX_NETWORK_NAME NM_SETTING_WIMAX_MAC_ADDRESS -NMSettingWimax -NMSettingWimaxClass nm_setting_wimax_new nm_setting_wimax_get_network_name nm_setting_wimax_get_mac_address +NMSettingWimax +NMSettingWimaxClass NM_IS_SETTING_WIMAX NM_IS_SETTING_WIMAX_CLASS NM_SETTING_WIMAX @@ -1285,8 +1285,6 @@ NM_SETTING_WIRED_MTU NM_SETTING_WIRED_S390_SUBCHANNELS NM_SETTING_WIRED_S390_NETTYPE NM_SETTING_WIRED_S390_OPTIONS -NMSettingWired -NMSettingWiredClass nm_setting_wired_new nm_setting_wired_get_port nm_setting_wired_get_speed @@ -1311,6 +1309,8 @@ nm_setting_wired_add_s390_option nm_setting_wired_remove_s390_option nm_setting_wired_get_valid_s390_options +NMSettingWired +NMSettingWiredClass NM_IS_SETTING_WIRED NM_IS_SETTING_WIRED_CLASS NM_SETTING_WIRED @@ -1344,8 +1344,6 @@ NM_SETTING_WIRELESS_SEC NM_SETTING_WIRELESS_MODE_ADHOC NM_SETTING_WIRELESS_MODE_AP NM_SETTING_WIRELESS_MODE_INFRA -NMSettingWireless -NMSettingWirelessClass nm_setting_wireless_new nm_setting_wireless_get_ssid nm_setting_wireless_get_mode @@ -1371,6 +1369,8 @@ nm_setting_wireless_get_seen_bssid nm_setting_wireless_ap_security_compatible nm_setting_wireless_get_security +NMSettingWireless +NMSettingWirelessClass NM_IS_SETTING_WIRELESS NM_IS_SETTING_WIRELESS_CLASS NM_SETTING_WIRELESS @@ -1405,8 +1405,6 @@ NM_SETTING_WIRELESS_SECURITY_PSK NM_SETTING_WIRELESS_SECURITY_PSK_FLAGS NM_SETTING_WIRELESS_SECURITY_LEAP_PASSWORD NM_SETTING_WIRELESS_SECURITY_LEAP_PASSWORD_FLAGS -NMSettingWirelessSecurity -NMSettingWirelessSecurityClass nm_setting_wireless_security_new nm_setting_wireless_security_get_key_mgmt nm_setting_wireless_security_get_num_protos @@ -1439,6 +1437,8 @@ nm_setting_wireless_security_get_auth_alg nm_setting_wireless_security_get_wep_key_flags nm_setting_wireless_security_get_wep_key_type +NMSettingWirelessSecurity +NMSettingWirelessSecurityClass NM_IS_SETTING_WIRELESS_SECURITY NM_IS_SETTING_WIRELESS_SECURITY_CLASS NM_SETTING_WIRELESS_SECURITY diff --git a/docs/libnm-util/tmpl/NetworkManager.sgml b/docs/libnm-util/tmpl/NetworkManager.sgml index 44e92a73..008d08b8 100644 --- a/docs/libnm-util/tmpl/NetworkManager.sgml +++ b/docs/libnm-util/tmpl/NetworkManager.sgml @@ -380,6 +380,9 @@ NetworkManager @NM_WIFI_DEVICE_CAP_RSN: @NM_WIFI_DEVICE_CAP_AP: @NM_WIFI_DEVICE_CAP_ADHOC: +@NM_WIFI_DEVICE_CAP_FREQ_VALID: +@NM_WIFI_DEVICE_CAP_FREQ_2GHZ: +@NM_WIFI_DEVICE_CAP_FREQ_5GHZ: @@ -520,6 +523,7 @@ NetworkManager @NM_DEVICE_STATE_REASON_MODEM_FAILED: @NM_DEVICE_STATE_REASON_MODEM_AVAILABLE: @NM_DEVICE_STATE_REASON_SIM_PIN_INCORRECT: +@NM_DEVICE_STATE_REASON_NEW_ACTIVATION: @NM_DEVICE_STATE_REASON_LAST: diff --git a/docs/libnm-util/tmpl/nm-connection.sgml b/docs/libnm-util/tmpl/nm-connection.sgml index 4c0db74e..27d34bb6 100644 --- a/docs/libnm-util/tmpl/nm-connection.sgml +++ b/docs/libnm-util/tmpl/nm-connection.sgml @@ -117,14 +117,6 @@ NMConnection - - - - - -@parent: -@secrets_updated: - diff --git a/docs/libnm-util/tmpl/nm-setting-8021x.sgml b/docs/libnm-util/tmpl/nm-setting-8021x.sgml index 9b331510..a5b6f315 100644 --- a/docs/libnm-util/tmpl/nm-setting-8021x.sgml +++ b/docs/libnm-util/tmpl/nm-setting-8021x.sgml @@ -297,183 +297,6 @@ NMSetting8021x - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -@parent: -@_reserved1: -@_reserved2: -@_reserved3: -@_reserved4: - diff --git a/docs/libnm-util/tmpl/nm-setting-adsl.sgml b/docs/libnm-util/tmpl/nm-setting-adsl.sgml index 4b3716ef..aa9a1661 100644 --- a/docs/libnm-util/tmpl/nm-setting-adsl.sgml +++ b/docs/libnm-util/tmpl/nm-setting-adsl.sgml @@ -138,58 +138,6 @@ NMSettingAdsl - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -@parent: -@_reserved1: -@_reserved2: -@_reserved3: -@_reserved4: - diff --git a/docs/libnm-util/tmpl/nm-setting-bluetooth.sgml b/docs/libnm-util/tmpl/nm-setting-bluetooth.sgml index 3a9c9773..058e98fc 100644 --- a/docs/libnm-util/tmpl/nm-setting-bluetooth.sgml +++ b/docs/libnm-util/tmpl/nm-setting-bluetooth.sgml @@ -83,33 +83,6 @@ NMSettingBluetooth - - - - - - - - - - - - - - - - - - - - - -@parent: -@_reserved1: -@_reserved2: -@_reserved3: -@_reserved4: - diff --git a/docs/libnm-util/tmpl/nm-setting-bond.sgml b/docs/libnm-util/tmpl/nm-setting-bond.sgml index 9a67232a..2131ced0 100644 --- a/docs/libnm-util/tmpl/nm-setting-bond.sgml +++ b/docs/libnm-util/tmpl/nm-setting-bond.sgml @@ -175,33 +175,6 @@ NMSettingBond - - - - - - - - - - - - - - - - - - - - - -@parent: -@_reserved1: -@_reserved2: -@_reserved3: -@_reserved4: - diff --git a/docs/libnm-util/tmpl/nm-setting-bridge-port.sgml b/docs/libnm-util/tmpl/nm-setting-bridge-port.sgml index 692cb73d..ebbed6db 100644 --- a/docs/libnm-util/tmpl/nm-setting-bridge-port.sgml +++ b/docs/libnm-util/tmpl/nm-setting-bridge-port.sgml @@ -75,38 +75,6 @@ NMSettingBridgePort - - - - - - - - - - - - - - - - - - - - - - - - - - -@parent: -@_reserved1: -@_reserved2: -@_reserved3: -@_reserved4: - diff --git a/docs/libnm-util/tmpl/nm-setting-bridge.sgml b/docs/libnm-util/tmpl/nm-setting-bridge.sgml index 8a1d6e86..1b14c3d8 100644 --- a/docs/libnm-util/tmpl/nm-setting-bridge.sgml +++ b/docs/libnm-util/tmpl/nm-setting-bridge.sgml @@ -110,63 +110,6 @@ NMSettingBridge - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -@parent: -@_reserved1: -@_reserved2: -@_reserved3: -@_reserved4: - diff --git a/docs/libnm-util/tmpl/nm-setting-cdma.sgml b/docs/libnm-util/tmpl/nm-setting-cdma.sgml index 4c90acb1..fdcad0de 100644 --- a/docs/libnm-util/tmpl/nm-setting-cdma.sgml +++ b/docs/libnm-util/tmpl/nm-setting-cdma.sgml @@ -83,43 +83,6 @@ NMSettingCdma - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -@parent: -@_reserved1: -@_reserved2: -@_reserved3: -@_reserved4: - diff --git a/docs/libnm-util/tmpl/nm-setting-connection.sgml b/docs/libnm-util/tmpl/nm-setting-connection.sgml index 83399625..732527f6 100644 --- a/docs/libnm-util/tmpl/nm-setting-connection.sgml +++ b/docs/libnm-util/tmpl/nm-setting-connection.sgml @@ -218,17 +218,6 @@ NMSettingConnection - - - - - -@parent: -@_reserved1: -@_reserved2: -@_reserved3: -@_reserved4: - diff --git a/docs/libnm-util/tmpl/nm-setting-dcb.sgml b/docs/libnm-util/tmpl/nm-setting-dcb.sgml index 8de442f4..f7b8abb1 100644 --- a/docs/libnm-util/tmpl/nm-setting-dcb.sgml +++ b/docs/libnm-util/tmpl/nm-setting-dcb.sgml @@ -183,98 +183,6 @@ NMSettingDcb - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -@parent: -@_reserved1: -@_reserved2: -@_reserved3: -@_reserved4: - diff --git a/docs/libnm-util/tmpl/nm-setting-generic.sgml b/docs/libnm-util/tmpl/nm-setting-generic.sgml index 54eb106e..2c88c208 100644 --- a/docs/libnm-util/tmpl/nm-setting-generic.sgml +++ b/docs/libnm-util/tmpl/nm-setting-generic.sgml @@ -54,23 +54,6 @@ NMSettingGeneric @Returns: - - - - - - - - - - - -@parent: -@_reserved1: -@_reserved2: -@_reserved3: -@_reserved4: - diff --git a/docs/libnm-util/tmpl/nm-setting-gsm.sgml b/docs/libnm-util/tmpl/nm-setting-gsm.sgml index e37ed410..6dc2d3bf 100644 --- a/docs/libnm-util/tmpl/nm-setting-gsm.sgml +++ b/docs/libnm-util/tmpl/nm-setting-gsm.sgml @@ -173,78 +173,6 @@ NMSettingGsm - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -@parent: -@_reserved1: -@_reserved2: -@_reserved3: -@_reserved4: - diff --git a/docs/libnm-util/tmpl/nm-setting-infiniband.sgml b/docs/libnm-util/tmpl/nm-setting-infiniband.sgml index 550fc453..7a695cdd 100644 --- a/docs/libnm-util/tmpl/nm-setting-infiniband.sgml +++ b/docs/libnm-util/tmpl/nm-setting-infiniband.sgml @@ -89,48 +89,6 @@ NMSettingInfiniband - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -@parent: -@_reserved1: -@_reserved2: -@_reserved3: -@_reserved4: - diff --git a/docs/libnm-util/tmpl/nm-setting-ip4-config.sgml b/docs/libnm-util/tmpl/nm-setting-ip4-config.sgml index bf4fbee1..e035c493 100644 --- a/docs/libnm-util/tmpl/nm-setting-ip4-config.sgml +++ b/docs/libnm-util/tmpl/nm-setting-ip4-config.sgml @@ -181,12 +181,6 @@ NMSettingIP4Config - - - - - - @@ -285,12 +279,6 @@ NMSettingIP4Config @gateway: - - - - - - @@ -407,88 +395,6 @@ NMSettingIP4Config @metric: - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -@parent: -@_reserved1: -@_reserved2: -@_reserved3: -@_reserved4: - diff --git a/docs/libnm-util/tmpl/nm-setting-ip6-config.sgml b/docs/libnm-util/tmpl/nm-setting-ip6-config.sgml index 1894b0a0..1f089c63 100644 --- a/docs/libnm-util/tmpl/nm-setting-ip6-config.sgml +++ b/docs/libnm-util/tmpl/nm-setting-ip6-config.sgml @@ -191,12 +191,6 @@ NMSettingIP6Config @NM_SETTING_IP6_CONFIG_PRIVACY_PREFER_PUBLIC_ADDR: @NM_SETTING_IP6_CONFIG_PRIVACY_PREFER_TEMP_ADDR: - - - - - - @@ -295,12 +289,6 @@ NMSettingIP6Config @gateway: - - - - - - @@ -417,83 +405,6 @@ NMSettingIP6Config @metric: - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -@parent: -@_reserved1: -@_reserved2: -@_reserved3: -@_reserved4: - diff --git a/docs/libnm-util/tmpl/nm-setting-olpc-mesh.sgml b/docs/libnm-util/tmpl/nm-setting-olpc-mesh.sgml index 6d525379..c3971303 100644 --- a/docs/libnm-util/tmpl/nm-setting-olpc-mesh.sgml +++ b/docs/libnm-util/tmpl/nm-setting-olpc-mesh.sgml @@ -75,38 +75,6 @@ NMSettingOlpcMesh - - - - - - - - - - - - - - - - - - - - - - - - - - -@parent: -@_reserved1: -@_reserved2: -@_reserved3: -@_reserved4: - diff --git a/docs/libnm-util/tmpl/nm-setting-ppp.sgml b/docs/libnm-util/tmpl/nm-setting-ppp.sgml index 69cf509c..ccf4f0d9 100644 --- a/docs/libnm-util/tmpl/nm-setting-ppp.sgml +++ b/docs/libnm-util/tmpl/nm-setting-ppp.sgml @@ -181,113 +181,6 @@ NMSettingPPP - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -@parent: -@_reserved1: -@_reserved2: -@_reserved3: -@_reserved4: - diff --git a/docs/libnm-util/tmpl/nm-setting-pppoe.sgml b/docs/libnm-util/tmpl/nm-setting-pppoe.sgml index 1ab1ae55..f34ba1d2 100644 --- a/docs/libnm-util/tmpl/nm-setting-pppoe.sgml +++ b/docs/libnm-util/tmpl/nm-setting-pppoe.sgml @@ -83,43 +83,6 @@ NMSettingPPPOE - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -@parent: -@_reserved1: -@_reserved2: -@_reserved3: -@_reserved4: - diff --git a/docs/libnm-util/tmpl/nm-setting-serial.sgml b/docs/libnm-util/tmpl/nm-setting-serial.sgml index b79ec0a9..fcd7e170 100644 --- a/docs/libnm-util/tmpl/nm-setting-serial.sgml +++ b/docs/libnm-util/tmpl/nm-setting-serial.sgml @@ -90,48 +90,6 @@ NMSettingSerial - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -@parent: -@_reserved1: -@_reserved2: -@_reserved3: -@_reserved4: - diff --git a/docs/libnm-util/tmpl/nm-setting-team-port.sgml b/docs/libnm-util/tmpl/nm-setting-team-port.sgml index 3fe5f784..37ed15ee 100644 --- a/docs/libnm-util/tmpl/nm-setting-team-port.sgml +++ b/docs/libnm-util/tmpl/nm-setting-team-port.sgml @@ -61,28 +61,6 @@ NMSettingTeamPort - - - - - - - - - - - - - - - - -@parent: -@_reserved1: -@_reserved2: -@_reserved3: -@_reserved4: - diff --git a/docs/libnm-util/tmpl/nm-setting-team.sgml b/docs/libnm-util/tmpl/nm-setting-team.sgml index bc7a3572..161fc193 100644 --- a/docs/libnm-util/tmpl/nm-setting-team.sgml +++ b/docs/libnm-util/tmpl/nm-setting-team.sgml @@ -68,33 +68,6 @@ NMSettingTeam - - - - - - - - - - - - - - - - - - - - - -@parent: -@_reserved1: -@_reserved2: -@_reserved3: -@_reserved4: - diff --git a/docs/libnm-util/tmpl/nm-setting-vlan.sgml b/docs/libnm-util/tmpl/nm-setting-vlan.sgml index 9ae77248..79053ea5 100644 --- a/docs/libnm-util/tmpl/nm-setting-vlan.sgml +++ b/docs/libnm-util/tmpl/nm-setting-vlan.sgml @@ -97,53 +97,6 @@ NMSettingVlan - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -@parent: -@_reserved1: -@_reserved2: -@_reserved3: -@_reserved4: - diff --git a/docs/libnm-util/tmpl/nm-setting-vpn.sgml b/docs/libnm-util/tmpl/nm-setting-vpn.sgml index 2f8652cb..3d2b9a3a 100644 --- a/docs/libnm-util/tmpl/nm-setting-vpn.sgml +++ b/docs/libnm-util/tmpl/nm-setting-vpn.sgml @@ -89,48 +89,6 @@ NMSettingVPN - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -@parent: -@_reserved1: -@_reserved2: -@_reserved3: -@_reserved4: - diff --git a/docs/libnm-util/tmpl/nm-setting-wimax.sgml b/docs/libnm-util/tmpl/nm-setting-wimax.sgml index 151e723e..ebfbd61a 100644 --- a/docs/libnm-util/tmpl/nm-setting-wimax.sgml +++ b/docs/libnm-util/tmpl/nm-setting-wimax.sgml @@ -68,29 +68,6 @@ NMSettingWimax - - - - - - - - - - - - - - - - - - - - - -@parent: - diff --git a/docs/libnm-util/tmpl/nm-setting-wired.sgml b/docs/libnm-util/tmpl/nm-setting-wired.sgml index 7d169ea4..fe4f2d32 100644 --- a/docs/libnm-util/tmpl/nm-setting-wired.sgml +++ b/docs/libnm-util/tmpl/nm-setting-wired.sgml @@ -131,78 +131,6 @@ NMSettingWired - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -@parent: -@_reserved1: -@_reserved2: -@_reserved3: -@_reserved4: - diff --git a/docs/libnm-util/tmpl/nm-setting-wireless-security.sgml b/docs/libnm-util/tmpl/nm-setting-wireless-security.sgml index bcb0b702..dea50cd7 100644 --- a/docs/libnm-util/tmpl/nm-setting-wireless-security.sgml +++ b/docs/libnm-util/tmpl/nm-setting-wireless-security.sgml @@ -187,108 +187,6 @@ NMSettingWirelessSecurity - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -@parent: -@_reserved1: -@_reserved2: -@_reserved3: -@_reserved4: - diff --git a/docs/libnm-util/tmpl/nm-setting-wireless.sgml b/docs/libnm-util/tmpl/nm-setting-wireless.sgml index 9e071371..08c526b1 100644 --- a/docs/libnm-util/tmpl/nm-setting-wireless.sgml +++ b/docs/libnm-util/tmpl/nm-setting-wireless.sgml @@ -175,93 +175,6 @@ NMSettingWireless - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -@parent: -@_reserved1: -@_reserved2: -@_reserved3: -@_reserved4: - diff --git a/docs/libnm-util/tmpl/nm-setting.sgml b/docs/libnm-util/tmpl/nm-setting.sgml index d781e4cc..61a3bdc2 100644 --- a/docs/libnm-util/tmpl/nm-setting.sgml +++ b/docs/libnm-util/tmpl/nm-setting.sgml @@ -130,22 +130,6 @@ NMSetting @Returns: - - - - - -@parent: -@verify: -@need_secrets: -@update_one_secret: -@get_secret_flags: -@set_secret_flags: -@compare_property: -@clear_secrets_with_flags: -@get_virtual_iface_name: -@_reserved1: - diff --git a/docs/libnm-util/version.xml b/docs/libnm-util/version.xml index 3eefcb9d..6d7de6e6 100644 --- a/docs/libnm-util/version.xml +++ b/docs/libnm-util/version.xml @@ -1 +1 @@ -1.0.0 +1.0.2 diff --git a/docs/libnm/Makefile.in b/docs/libnm/Makefile.in index 4f5a7966..04cec2f1 100644 --- a/docs/libnm/Makefile.in +++ b/docs/libnm/Makefile.in @@ -1,7 +1,7 @@ -# Makefile.in generated by automake 1.13.4 from Makefile.am. +# Makefile.in generated by automake 1.15 from Makefile.am. # @configure_input@ -# Copyright (C) 1994-2013 Free Software Foundation, Inc. +# Copyright (C) 1994-2014 Free Software Foundation, Inc. # This Makefile.in is free software; the Free Software Foundation # gives unlimited permission to copy and/or distribute it, @@ -20,7 +20,17 @@ # Everything below here is generic # #################################### VPATH = @srcdir@ -am__is_gnu_make = test -n '$(MAKEFILE_LIST)' && test -n '$(MAKELEVEL)' +am__is_gnu_make = { \ + if test -z '$(MAKELEVEL)'; then \ + false; \ + elif test -n '$(MAKE_HOST)'; then \ + true; \ + elif test -n '$(MAKE_VERSION)' && test -n '$(CURDIR)'; then \ + true; \ + else \ + false; \ + fi; \ +} am__make_running_with_option = \ case $${target_option-} in \ ?) ;; \ @@ -83,8 +93,6 @@ PRE_UNINSTALL = : POST_UNINSTALL = : build_triplet = @build@ host_triplet = @host@ -DIST_COMMON = $(top_srcdir)/gtk-doc.make $(srcdir)/Makefile.in \ - $(srcdir)/Makefile.am $(srcdir)/version.xml.in subdir = docs/libnm ACLOCAL_M4 = $(top_srcdir)/aclocal.m4 am__aclocal_m4_deps = $(top_srcdir)/m4/ax_lib_readline.m4 \ @@ -102,6 +110,7 @@ am__aclocal_m4_deps = $(top_srcdir)/m4/ax_lib_readline.m4 \ $(top_srcdir)/m4/vapigen.m4 $(top_srcdir)/configure.ac am__configure_deps = $(am__aclocal_m4_deps) $(CONFIGURE_DEPENDENCIES) \ $(ACLOCAL_M4) +DIST_COMMON = $(srcdir)/Makefile.am $(am__DIST_COMMON) mkinstalldirs = $(install_sh) -d CONFIG_HEADER = $(top_builddir)/config.h CONFIG_CLEAN_FILES = version.xml @@ -126,6 +135,8 @@ am__can_run_installinfo = \ *) (install-info --version) >/dev/null 2>&1;; \ esac am__tagged_files = $(HEADERS) $(SOURCES) $(TAGS_FILES) $(LISP) +am__DIST_COMMON = $(srcdir)/Makefile.in $(srcdir)/version.xml.in \ + $(top_srcdir)/gtk-doc.make DISTFILES = $(DIST_COMMON) $(DIST_SOURCES) $(TEXINFOS) $(EXTRA_DIST) ACLOCAL = @ACLOCAL@ ALL_LINGUAS = @ALL_LINGUAS@ @@ -152,7 +163,6 @@ CXXCPP = @CXXCPP@ CXXDEPMODE = @CXXDEPMODE@ CXXFLAGS = @CXXFLAGS@ CYGPATH_W = @CYGPATH_W@ -DATADIRNAME = @DATADIRNAME@ DBUS_CFLAGS = @DBUS_CFLAGS@ DBUS_GLIB_100_CFLAGS = @DBUS_GLIB_100_CFLAGS@ DBUS_GLIB_100_LIBS = @DBUS_GLIB_100_LIBS@ @@ -187,6 +197,7 @@ GNUTLS_CFLAGS = @GNUTLS_CFLAGS@ GNUTLS_LIBS = @GNUTLS_LIBS@ GREP = @GREP@ GTKDOC_CHECK = @GTKDOC_CHECK@ +GTKDOC_CHECK_PATH = @GTKDOC_CHECK_PATH@ GTKDOC_DEPS_CFLAGS = @GTKDOC_DEPS_CFLAGS@ GTKDOC_DEPS_LIBS = @GTKDOC_DEPS_LIBS@ GTKDOC_MKPDF = @GTKDOC_MKPDF@ @@ -508,11 +519,12 @@ REPORT_FILES = \ $(DOC_MODULE)-unused.txt CLEANFILES = $(SCANOBJ_FILES) $(REPORT_FILES) $(DOC_STAMPS) \ - libnm-sections.txt libnm-overrides.txt html/* tmpl/* xml/* -@ENABLE_GTK_DOC_TRUE@@GTK_DOC_BUILD_HTML_FALSE@HTML_BUILD_STAMP = -@ENABLE_GTK_DOC_TRUE@@GTK_DOC_BUILD_HTML_TRUE@HTML_BUILD_STAMP = html-build.stamp -@ENABLE_GTK_DOC_TRUE@@GTK_DOC_BUILD_PDF_FALSE@PDF_BUILD_STAMP = -@ENABLE_GTK_DOC_TRUE@@GTK_DOC_BUILD_PDF_TRUE@PDF_BUILD_STAMP = pdf-build.stamp + gtkdoc-check.test libnm-sections.txt libnm-overrides.txt \ + html/* tmpl/* xml/* +@GTK_DOC_BUILD_HTML_FALSE@HTML_BUILD_STAMP = +@GTK_DOC_BUILD_HTML_TRUE@HTML_BUILD_STAMP = html-build.stamp +@GTK_DOC_BUILD_PDF_FALSE@PDF_BUILD_STAMP = +@GTK_DOC_BUILD_PDF_TRUE@PDF_BUILD_STAMP = pdf-build.stamp #### setup #### GTK_DOC_V_SETUP = $(GTK_DOC_V_SETUP_$(V)) @@ -564,7 +576,6 @@ $(srcdir)/Makefile.in: @MAINTAINER_MODE_TRUE@ $(srcdir)/Makefile.am $(top_srcdir echo ' cd $(top_srcdir) && $(AUTOMAKE) --gnu docs/libnm/Makefile'; \ $(am__cd) $(top_srcdir) && \ $(AUTOMAKE) --gnu docs/libnm/Makefile -.PRECIOUS: Makefile Makefile: $(srcdir)/Makefile.in $(top_builddir)/config.status @case '$?' in \ *config.status*) \ @@ -573,7 +584,7 @@ Makefile: $(srcdir)/Makefile.in $(top_builddir)/config.status echo ' cd $(top_builddir) && $(SHELL) ./config.status $(subdir)/$@ $(am__depfiles_maybe)'; \ cd $(top_builddir) && $(SHELL) ./config.status $(subdir)/$@ $(am__depfiles_maybe);; \ esac; -$(top_srcdir)/gtk-doc.make: +$(top_srcdir)/gtk-doc.make $(am__empty): $(top_builddir)/config.status: $(top_srcdir)/configure $(CONFIG_STATUS_DEPENDENCIES) cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh @@ -633,6 +644,7 @@ distdir: $(DISTFILES) dist-hook check-am: all-am check: check-am +@ENABLE_GTK_DOC_FALSE@all-local: all-am: Makefile all-local installdirs: install: install-am @@ -749,9 +761,18 @@ uninstall-am: uninstall-local mostlyclean-libtool pdf pdf-am ps ps-am tags-am uninstall \ uninstall-am uninstall-local +.PRECIOUS: Makefile -@ENABLE_GTK_DOC_TRUE@all-local: $(HTML_BUILD_STAMP) $(PDF_BUILD_STAMP) -@ENABLE_GTK_DOC_FALSE@all-local: + +gtkdoc-check.test: Makefile + $(AM_V_GEN)echo "#!/bin/sh -e" > $@; \ + echo "$(GTKDOC_CHECK_PATH) || exit 1" >> $@; \ + chmod +x $@ + +all-gtk-doc: $(HTML_BUILD_STAMP) $(PDF_BUILD_STAMP) +.PHONY: all-gtk-doc + +@ENABLE_GTK_DOC_TRUE@all-local: all-gtk-doc docs: $(HTML_BUILD_STAMP) $(PDF_BUILD_STAMP) @@ -762,17 +783,19 @@ setup-build.stamp: files=`echo $(SETUP_FILES) $(expand_content_files) $(DOC_MODULE).types`; \ if test "x$$files" != "x" ; then \ for file in $$files ; do \ + destdir=`dirname $(abs_builddir)/$$file` ;\ + test -d "$$destdir" || mkdir -p "$$destdir"; \ test -f $(abs_srcdir)/$$file && \ - cp -pu $(abs_srcdir)/$$file $(abs_builddir)/$$file || true; \ + cp -pf $(abs_srcdir)/$$file $(abs_builddir)/$$file || true; \ done; \ fi; \ test -d $(abs_srcdir)/tmpl && \ - { cp -rp $(abs_srcdir)/tmpl $(abs_builddir)/; \ + { cp -pR $(abs_srcdir)/tmpl $(abs_builddir)/; \ chmod -R u+w $(abs_builddir)/tmpl; } \ fi $(AM_V_at)touch setup-build.stamp -scan-build.stamp: $(HFILE_GLOB) $(CFILE_GLOB) +scan-build.stamp: setup-build.stamp $(HFILE_GLOB) $(CFILE_GLOB) $(GTK_DOC_V_SCAN)_source_dir='' ; \ for i in $(DOC_SOURCE_DIR) ; do \ _source_dir="$${_source_dir} --source-dir=$$i" ; \ @@ -802,7 +825,7 @@ tmpl-build.stamp: setup-build.stamp $(DOC_MODULE)-decl.txt $(SCANOBJ_FILES) $(DO $(GTK_DOC_V_TMPL)gtkdoc-mktmpl --module=$(DOC_MODULE) $(MKTMPL_OPTIONS) $(AM_V_at)if test "$(abs_srcdir)" != "$(abs_builddir)" ; then \ if test -w $(abs_srcdir) ; then \ - cp -rp $(abs_builddir)/tmpl $(abs_srcdir)/; \ + cp -pR $(abs_builddir)/tmpl $(abs_srcdir)/; \ fi \ fi $(AM_V_at)touch tmpl-build.stamp @@ -814,7 +837,7 @@ $(srcdir)/tmpl/*.sgml: @true sgml-build.stamp: tmpl.stamp $(DOC_MODULE)-sections.txt $(srcdir)/tmpl/*.sgml $(expand_content_files) - $(GTK_DOC_V_XML)-chmod -R u+w $(srcdir) && _source_dir='' ; \ + -$(GTK_DOC_V_XML)chmod -R u+w $(srcdir) && _source_dir='' ; \ for i in $(DOC_SOURCE_DIR) ; do \ _source_dir="$${_source_dir} --source-dir=$$i" ; \ done ; \ @@ -876,6 +899,9 @@ pdf-build.stamp: sgml.stamp $(DOC_MAIN_SGML_FILE) $(content_files) clean-local: @rm -f *~ *.bak @rm -rf .libs + @if echo $(SCAN_OPTIONS) | grep -q "\-\-rebuild-types" ; then \ + rm -f $(DOC_MODULE).types; \ + fi distclean-local: @rm -rf xml html $(REPORT_FILES) $(DOC_MODULE).pdf \ @@ -921,12 +947,14 @@ uninstall-local: # # Require gtk-doc when making dist # -@ENABLE_GTK_DOC_TRUE@dist-check-gtkdoc: docs -@ENABLE_GTK_DOC_FALSE@dist-check-gtkdoc: -@ENABLE_GTK_DOC_FALSE@ @echo "*** gtk-doc must be installed and enabled in order to make dist" -@ENABLE_GTK_DOC_FALSE@ @false - -dist-hook: dist-check-gtkdoc dist-hook-local +@HAVE_GTK_DOC_TRUE@dist-check-gtkdoc: docs +@HAVE_GTK_DOC_FALSE@dist-check-gtkdoc: +@HAVE_GTK_DOC_FALSE@ @echo "*** gtk-doc is needed to run 'make dist'. ***" +@HAVE_GTK_DOC_FALSE@ @echo "*** gtk-doc was not found when 'configure' ran. ***" +@HAVE_GTK_DOC_FALSE@ @echo "*** please install gtk-doc and rerun 'configure'. ***" +@HAVE_GTK_DOC_FALSE@ @false + +dist-hook: dist-check-gtkdoc all-gtk-doc dist-hook-local @mkdir $(distdir)/tmpl @mkdir $(distdir)/html @-cp ./tmpl/*.sgml $(distdir)/tmpl diff --git a/docs/libnm/html/NMAccessPoint.html b/docs/libnm/html/NMAccessPoint.html index 9b21cae9..8391ef44 100644 --- a/docs/libnm/html/NMAccessPoint.html +++ b/docs/libnm/html/NMAccessPoint.html @@ -2,36 +2,28 @@ -NMAccessPoint +libnm Reference Manual: NMAccessPoint - + - - - - - - - - - - + + + + + + +
@@ -39,64 +31,227 @@

NMAccessPoint

NMAccessPoint

- +
-
-

Synopsis

-
#define             NM_ACCESS_POINT_FLAGS
-#define             NM_ACCESS_POINT_WPA_FLAGS
-#define             NM_ACCESS_POINT_RSN_FLAGS
-#define             NM_ACCESS_POINT_SSID
-#define             NM_ACCESS_POINT_BSSID
-#define             NM_ACCESS_POINT_FREQUENCY
-#define             NM_ACCESS_POINT_MODE
-#define             NM_ACCESS_POINT_MAX_BITRATE
-#define             NM_ACCESS_POINT_STRENGTH
-#define             NM_ACCESS_POINT_HW_ADDRESS
-struct              NMAccessPoint;
-                    NMAccessPointClass;
-NM80211ApFlags      nm_access_point_get_flags           (NMAccessPoint *ap);
-NM80211ApSecurityFlags nm_access_point_get_wpa_flags    (NMAccessPoint *ap);
-NM80211ApSecurityFlags nm_access_point_get_rsn_flags    (NMAccessPoint *ap);
-GBytes *            nm_access_point_get_ssid            (NMAccessPoint *ap);
-const char *        nm_access_point_get_bssid           (NMAccessPoint *ap);
-guint32             nm_access_point_get_frequency       (NMAccessPoint *ap);
-NM80211Mode         nm_access_point_get_mode            (NMAccessPoint *ap);
-guint32             nm_access_point_get_max_bitrate     (NMAccessPoint *ap);
-guint8              nm_access_point_get_strength        (NMAccessPoint *ap);
-GPtrArray *         nm_access_point_filter_connections  (NMAccessPoint *ap,
-                                                         const GPtrArray *connections);
-gboolean            nm_access_point_connection_valid    (NMAccessPoint *ap,
-                                                         NMConnection *connection);
-
+
+

Functions

+
++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+NM80211ApFlags + +nm_access_point_get_flags () +
+NM80211ApSecurityFlags + +nm_access_point_get_wpa_flags () +
+NM80211ApSecurityFlags + +nm_access_point_get_rsn_flags () +
+GBytes * + +nm_access_point_get_ssid () +
const char * + +nm_access_point_get_bssid () +
+guint32 + +nm_access_point_get_frequency () +
+NM80211Mode + +nm_access_point_get_mode () +
+guint32 + +nm_access_point_get_max_bitrate () +
+guint8 + +nm_access_point_get_strength () +
+GPtrArray * + +nm_access_point_filter_connections () +
+gboolean + +nm_access_point_connection_valid () +
-

Object Hierarchy

-
-  GObject
-   +----NMObject
-         +----NMAccessPoint
-
+

Properties

+
+++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+gchar *bssidRead
NM80211ApFlagsflagsRead
guintfrequencyRead
+gchar *hw-addressRead
guintmax-bitrateRead
NM80211ModemodeRead
NM80211ApSecurityFlagsrsn-flagsRead
+GBytes *ssidRead
gucharstrengthRead
NM80211ApSecurityFlagswpa-flagsRead
-

Implemented Interfaces

-

-NMAccessPoint implements - GInitable and GAsyncInitable.

+

Types and Values

+
++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
#defineNM_ACCESS_POINT_FLAGS
#defineNM_ACCESS_POINT_WPA_FLAGS
#defineNM_ACCESS_POINT_RSN_FLAGS
#defineNM_ACCESS_POINT_SSID
#defineNM_ACCESS_POINT_BSSID
#defineNM_ACCESS_POINT_FREQUENCY
#defineNM_ACCESS_POINT_MODE
#defineNM_ACCESS_POINT_MAX_BITRATE
#defineNM_ACCESS_POINT_STRENGTH
#defineNM_ACCESS_POINT_HW_ADDRESS
-

Properties

-
-  "bssid"                    gchar*                : Read
-  "flags"                    NM80211ApFlags        : Read
-  "frequency"                guint                 : Read
-  "hw-address"               gchar*                : Read
-  "max-bitrate"              guint                 : Read
-  "mode"                     NM80211Mode           : Read
-  "rsn-flags"                NM80211ApSecurityFlags  : Read
-  "ssid"                     GBytes*               : Read
-  "strength"                 guchar                : Read
-  "wpa-flags"                NM80211ApSecurityFlags  : Read
+

Object Hierarchy

+
    GObject
+    ╰── NMObject
+        ╰── NMAccessPoint
 
@@ -105,509 +260,510 @@ NMAccessPoint implements

-

Details

-
-

NM_ACCESS_POINT_FLAGS

-
#define NM_ACCESS_POINT_FLAGS       "flags"
-
-

-

+

Functions

+
+

nm_access_point_get_flags ()

+
NM80211ApFlags
+nm_access_point_get_flags (NMAccessPoint *ap);
+

Gets the flags of the access point.

+
+

Parameters

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

ap

a NMAccessPoint

 
-
-
-

NM_ACCESS_POINT_WPA_FLAGS

-
#define NM_ACCESS_POINT_WPA_FLAGS   "wpa-flags"
-
-

-

+
+

Returns

+

the flags

+

-
-
-

NM_ACCESS_POINT_RSN_FLAGS

-
#define NM_ACCESS_POINT_RSN_FLAGS   "rsn-flags"
-
-

-


-

NM_ACCESS_POINT_SSID

-
#define NM_ACCESS_POINT_SSID        "ssid"
-
-

-

+

nm_access_point_get_wpa_flags ()

+
NM80211ApSecurityFlags
+nm_access_point_get_wpa_flags (NMAccessPoint *ap);
+

Gets the WPA (version 1) flags of the access point.

+
+

Parameters

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

ap

a NMAccessPoint

 
-
-
-

NM_ACCESS_POINT_BSSID

-
#define NM_ACCESS_POINT_BSSID       "bssid"
-
-

-

+
+

Returns

+

the WPA flags

+

-
-
-

NM_ACCESS_POINT_FREQUENCY

-
#define NM_ACCESS_POINT_FREQUENCY   "frequency"
-
-

-


-

NM_ACCESS_POINT_MODE

-
#define NM_ACCESS_POINT_MODE        "mode"
-
-

-

+

nm_access_point_get_rsn_flags ()

+
NM80211ApSecurityFlags
+nm_access_point_get_rsn_flags (NMAccessPoint *ap);
+

Gets the RSN (Robust Secure Network, ie WPA version 2) flags of the access +point.

+
+

Parameters

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

ap

a NMAccessPoint

 
+
+
+

Returns

+

the RSN flags

+

+

-

NM_ACCESS_POINT_MAX_BITRATE

-
#define NM_ACCESS_POINT_MAX_BITRATE "max-bitrate"
-
-

-

+

nm_access_point_get_ssid ()

+
GBytes *
+nm_access_point_get_ssid (NMAccessPoint *ap);
+

Gets the SSID of the access point.

+
+

Parameters

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

ap

a NMAccessPoint

 
+
+
+

Returns

+

the GBytes containing the SSID, or NULL if the +SSID is unknown.

+

[transfer none]

+

-

NM_ACCESS_POINT_STRENGTH

-
#define NM_ACCESS_POINT_STRENGTH    "strength"
-
-

-

+

nm_access_point_get_bssid ()

+
const char *
+nm_access_point_get_bssid (NMAccessPoint *ap);
+

Gets the Basic Service Set ID (BSSID) of the Wi-Fi access point.

+
+

Parameters

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

ap

a NMAccessPoint

 
+
+
+

Returns

+

the BSSID of the access point. This is an internal string and must +not be modified or freed.

+

+

-

NM_ACCESS_POINT_HW_ADDRESS

-
#define NM_ACCESS_POINT_HW_ADDRESS  "hw-address"
-
-

-

+

nm_access_point_get_frequency ()

+
guint32
+nm_access_point_get_frequency (NMAccessPoint *ap);
+

Gets the frequency of the access point.

+
+

Parameters

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

ap

a NMAccessPoint

 
+
+
+

Returns

+

the frequency

+

+

-

struct NMAccessPoint

-
struct NMAccessPoint;
-

-

+

nm_access_point_get_mode ()

+
NM80211Mode
+nm_access_point_get_mode (NMAccessPoint *ap);
+

Gets the mode of the access point.

+
+

Parameters

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

ap

a NMAccessPoint

 
+
+
+

Returns

+

the mode

+

+

-

NMAccessPointClass

-
typedef struct {
-	NMObjectClass parent;
-} NMAccessPointClass;
-
-

-

+

nm_access_point_get_max_bitrate ()

+
guint32
+nm_access_point_get_max_bitrate (NMAccessPoint *ap);
+

Gets the maximum bit rate of the access point in kbit/s.

+
+

Parameters

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

ap

a NMAccessPoint

 
+
+
+

Returns

+

the maximum bit rate (kbit/s)

+

+

-

nm_access_point_get_flags ()

-
NM80211ApFlags      nm_access_point_get_flags           (NMAccessPoint *ap);
-

-Gets the flags of the access point. -

-
+

nm_access_point_get_strength ()

+
guint8
+nm_access_point_get_strength (NMAccessPoint *ap);
+

Gets the current signal strength of the access point.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

ap :

a NMAccessPoint -

Returns :

the flags

ap

a NMAccessPoint

 
+
+

Returns

+

the signal strength

+

+
+

-

nm_access_point_get_wpa_flags ()

-
NM80211ApSecurityFlags nm_access_point_get_wpa_flags    (NMAccessPoint *ap);
-

-Gets the WPA (version 1) flags of the access point. -

-
+

nm_access_point_filter_connections ()

+
GPtrArray *
+nm_access_point_filter_connections (NMAccessPoint *ap,
+                                    const GPtrArray *connections);
+

Filters a given array of connections for a given NMAccessPoint object and +returns connections which may be activated with the access point. Any +returned connections will match the ap +'s SSID and (if given) BSSID and +other attributes like security settings, channel, etc.

+

To obtain the list of connections that are compatible with this access point, +use nm_client_get_connections() and then filter the returned list for a given +NMDevice using nm_device_filter_connections() and finally filter that list +with this function.

+
+

Parameters

+
--+++ - - + + + - - + + +

ap :

a NMAccessPoint -

ap

an NMAccessPoint to filter connections for

 

Returns :

the WPA flags

connections

an array of NMConnections to +filter.

[element-type NMConnection]
+
+

Returns

+

an array of +NMConnections that could be activated with the given ap +. The array should +be freed with g_ptr_array_unref() when it is no longer required.

+

[transfer container][element-type NMConnection]

+
+

-

nm_access_point_get_rsn_flags ()

-
NM80211ApSecurityFlags nm_access_point_get_rsn_flags    (NMAccessPoint *ap);
-

-Gets the RSN (Robust Secure Network, ie WPA version 2) flags of the access -point. -

-
+

nm_access_point_connection_valid ()

+
gboolean
+nm_access_point_connection_valid (NMAccessPoint *ap,
+                                  NMConnection *connection);
+

Validates a given connection against a given Wi-Fi access point to ensure that +the connection may be activated with that AP. The connection must match the +ap +'s SSID, (if given) BSSID, and other attributes like security settings, +channel, band, etc.

+
+

Parameters

+
--+++ - - + + + - - + + +

ap :

a NMAccessPoint -

ap

an NMAccessPoint to validate connection +against

 

Returns :

the RSN flags

connection

an NMConnection to validate against ap +

 
+
+

Returns

+

TRUE if the connection may be activated with this Wi-Fi AP, +FALSE if it cannot be.

+

+
+
+
+
+

Types and Values

+
+

NM_ACCESS_POINT_FLAGS

+
#define NM_ACCESS_POINT_FLAGS       "flags"
+
+

+

+

-

nm_access_point_get_ssid ()

-
GBytes *            nm_access_point_get_ssid            (NMAccessPoint *ap);
+

NM_ACCESS_POINT_WPA_FLAGS

+
#define NM_ACCESS_POINT_WPA_FLAGS   "wpa-flags"
+

-Gets the SSID of the access point.

-
---- - - - - - - - - - - -

ap :

a NMAccessPoint -

Returns :

the GBytes containing the SSID, or NULL if the -SSID is unknown. [transfer none] -

-

nm_access_point_get_bssid ()

-
const char *        nm_access_point_get_bssid           (NMAccessPoint *ap);
+

NM_ACCESS_POINT_RSN_FLAGS

+
#define NM_ACCESS_POINT_RSN_FLAGS   "rsn-flags"
+

-Gets the Basic Service Set ID (BSSID) of the Wi-Fi access point.

-
---- - - - - - - - - - - -

ap :

a NMAccessPoint -

Returns :

the BSSID of the access point. This is an internal string and must -not be modified or freed.

-

nm_access_point_get_frequency ()

-
guint32             nm_access_point_get_frequency       (NMAccessPoint *ap);
+

NM_ACCESS_POINT_SSID

+
#define NM_ACCESS_POINT_SSID        "ssid"
+

-Gets the frequency of the access point.

-
---- - - - - - - - - - - -

ap :

a NMAccessPoint -

Returns :

the frequency

-

nm_access_point_get_mode ()

-
NM80211Mode         nm_access_point_get_mode            (NMAccessPoint *ap);
+

NM_ACCESS_POINT_BSSID

+
#define NM_ACCESS_POINT_BSSID       "bssid"
+

-Gets the mode of the access point.

-
---- - - - - - - - - - - -

ap :

a NMAccessPoint -

Returns :

the mode

-

nm_access_point_get_max_bitrate ()

-
guint32             nm_access_point_get_max_bitrate     (NMAccessPoint *ap);
+

NM_ACCESS_POINT_FREQUENCY

+
#define NM_ACCESS_POINT_FREQUENCY   "frequency"
+

-Gets the maximum bit rate of the access point in kbit/s.

-
---- - - - - - - - - - - -

ap :

a NMAccessPoint -

Returns :

the maximum bit rate (kbit/s)

-

nm_access_point_get_strength ()

-
guint8              nm_access_point_get_strength        (NMAccessPoint *ap);
+

NM_ACCESS_POINT_MODE

+
#define NM_ACCESS_POINT_MODE        "mode"
+

-Gets the current signal strength of the access point.

-
---- - - - - - - - - - - -

ap :

a NMAccessPoint -

Returns :

the signal strength

-

nm_access_point_filter_connections ()

-
GPtrArray *         nm_access_point_filter_connections  (NMAccessPoint *ap,
-                                                         const GPtrArray *connections);
+

NM_ACCESS_POINT_MAX_BITRATE

+
#define NM_ACCESS_POINT_MAX_BITRATE "max-bitrate"
+

-Filters a given array of connections for a given NMAccessPoint object and -returns connections which may be activated with the access point. Any -returned connections will match the ap's SSID and (if given) BSSID and -other attributes like security settings, channel, etc.

+
+
+
+

NM_ACCESS_POINT_STRENGTH

+
#define NM_ACCESS_POINT_STRENGTH    "strength"
+

-To obtain the list of connections that are compatible with this access point, -use nm_client_get_connections() and then filter the returned list for a given -NMDevice using nm_device_filter_connections() and finally filter that list -with this function.

-
---- - - - - - - - - - - - - - - -

ap :

an NMAccessPoint to filter connections for

connections :

an array of NMConnections to -filter. [element-type NMConnection] -

Returns :

an array of -NMConnections that could be activated with the given ap. The array should -be freed with g_ptr_array_unref() when it is no longer required. [transfer container][element-type NMConnection] -

-

nm_access_point_connection_valid ()

-
gboolean            nm_access_point_connection_valid    (NMAccessPoint *ap,
-                                                         NMConnection *connection);
+

NM_ACCESS_POINT_HW_ADDRESS

+
#define NM_ACCESS_POINT_HW_ADDRESS  "hw-address"
+

-Validates a given connection against a given Wi-Fi access point to ensure that -the connection may be activated with that AP. The connection must match the -ap's SSID, (if given) BSSID, and other attributes like security settings, -channel, band, etc.

-
---- - - - - - - - - - - - - - - -

ap :

an NMAccessPoint to validate connection against

connection :

an NMConnection to validate against ap -

Returns :

-TRUE if the connection may be activated with this Wi-Fi AP, -FALSE if it cannot be.

Property Details

-

The "bssid" property

-
  "bssid"                    gchar*                : Read
-

-The BSSID of the access point. -

+

The “bssid” property

+
  “bssid”                    gchar *
+

+

Flags: Read

Default value: NULL


-

The "flags" property

-
  "flags"                    NM80211ApFlags        : Read
-

-The flags of the access point. -

+

The “flags” property

+
  “flags”                    NM80211ApFlags
+

+

Flags: Read


-

The "frequency" property

-
  "frequency"                guint                 : Read
-

-The frequency of the access point. -

+

The “frequency” property

+
  “frequency”                guint
+

+

Flags: Read

Allowed values: <= 10000

Default value: 0


-

The "hw-address" property

-
  "hw-address"               gchar*                : Read
-
-

Warning

-

NMAccessPoint:hw-address has been deprecated since version 1.0 and should not be used in newly-written code. use "bssid".

+

The “hw-address” property

+
  “hw-address”               gchar *
+

+
+

NMAccessPoint:hw-address has been deprecated since version 1.0 and should not be used in newly-written code.

+

use “bssid”.

-

-Alias for "bssid". -

+

Flags: Read

Default value: NULL


-

The "max-bitrate" property

-
  "max-bitrate"              guint                 : Read
-

-The maximum bit rate of the access point in kbit/s. -

+

The “max-bitrate” property

+
  “max-bitrate”              guint
+

+

Flags: Read

Default value: 0


-

The "mode" property

-
  "mode"                     NM80211Mode           : Read
-

-The mode of the access point; either "infrastructure" (a central -coordinator of the wireless network allowing clients to connect) or -"ad-hoc" (a network with no central controller). -

+

The “mode” property

+
  “mode”                     NM80211Mode
+

+

Flags: Read

Default value: NM_802_11_MODE_INFRA


-

The "rsn-flags" property

-
  "rsn-flags"                NM80211ApSecurityFlags  : Read
-

-The RSN flags of the access point. -

+

The “rsn-flags” property

+
  “rsn-flags”                NM80211ApSecurityFlags
+

+

Flags: Read


-

The "ssid" property

-
  "ssid"                     GBytes*               : Read
-

-The SSID of the access point, or NULL if it is not known. -

+

The “ssid” property

+
  “ssid”                     GBytes *
+

+

Flags: Read


-

The "strength" property

-
  "strength"                 guchar                : Read
-

-The current signal strength of the access point. -

+

The “strength” property

+
  “strength”                 guchar
+

+

Flags: Read

Default value: 0


-

The "wpa-flags" property

-
  "wpa-flags"                NM80211ApSecurityFlags  : Read
-

-The WPA flags of the access point. -

+

The “wpa-flags” property

+
  “wpa-flags”                NM80211ApSecurityFlags
+

+

Flags: Read

+ Generated by GTK-Doc V1.21
\ No newline at end of file diff --git a/docs/libnm/html/NMActiveConnection.html b/docs/libnm/html/NMActiveConnection.html index 15ac0158..bbe1a3fe 100644 --- a/docs/libnm/html/NMActiveConnection.html +++ b/docs/libnm/html/NMActiveConnection.html @@ -2,36 +2,28 @@ -NMActiveConnection +libnm Reference Manual: NMActiveConnection - + - - - - - - - - - - + + + + + + +
@@ -39,778 +31,988 @@

NMActiveConnection

NMActiveConnection

- +
-
-

Synopsis

-
#define             NM_ACTIVE_CONNECTION_CONNECTION
-#define             NM_ACTIVE_CONNECTION_ID
-#define             NM_ACTIVE_CONNECTION_UUID
-#define             NM_ACTIVE_CONNECTION_TYPE
-#define             NM_ACTIVE_CONNECTION_SPECIFIC_OBJECT_PATH
-#define             NM_ACTIVE_CONNECTION_DEVICES
-#define             NM_ACTIVE_CONNECTION_STATE
-#define             NM_ACTIVE_CONNECTION_DEFAULT
-#define             NM_ACTIVE_CONNECTION_IP4_CONFIG
-#define             NM_ACTIVE_CONNECTION_DHCP4_CONFIG
-#define             NM_ACTIVE_CONNECTION_DEFAULT6
-#define             NM_ACTIVE_CONNECTION_IP6_CONFIG
-#define             NM_ACTIVE_CONNECTION_DHCP6_CONFIG
-#define             NM_ACTIVE_CONNECTION_VPN
-#define             NM_ACTIVE_CONNECTION_MASTER
-struct              NMActiveConnection;
-                    NMActiveConnectionClass;
-NMRemoteConnection * nm_active_connection_get_connection
-                                                        (NMActiveConnection *connection);
-const char *        nm_active_connection_get_id         (NMActiveConnection *connection);
-const char *        nm_active_connection_get_uuid       (NMActiveConnection *connection);
-const char *        nm_active_connection_get_connection_type
-                                                        (NMActiveConnection *connection);
-const char *        nm_active_connection_get_specific_object_path
-                                                        (NMActiveConnection *connection);
-const GPtrArray *   nm_active_connection_get_devices    (NMActiveConnection *connection);
-NMActiveConnectionState nm_active_connection_get_state  (NMActiveConnection *connection);
-NMDevice *          nm_active_connection_get_master     (NMActiveConnection *connection);
-gboolean            nm_active_connection_get_default    (NMActiveConnection *connection);
-NMIPConfig *        nm_active_connection_get_ip4_config (NMActiveConnection *connection);
-NMDhcpConfig *      nm_active_connection_get_dhcp4_config
-                                                        (NMActiveConnection *connection);
-gboolean            nm_active_connection_get_default6   (NMActiveConnection *connection);
-NMIPConfig *        nm_active_connection_get_ip6_config (NMActiveConnection *connection);
-NMDhcpConfig *      nm_active_connection_get_dhcp6_config
-                                                        (NMActiveConnection *connection);
-gboolean            nm_active_connection_get_vpn        (NMActiveConnection *connection);
-
-
-
-

Object Hierarchy

-
-  GObject
-   +----NMObject
-         +----NMActiveConnection
-               +----NMVpnConnection
-
-
-
-

Implemented Interfaces

-

-NMActiveConnection implements - GInitable and GAsyncInitable.

-
-
-

Properties

-
-  "connection"               NMRemoteConnection*   : Read
-  "default"                  gboolean              : Read
-  "default6"                 gboolean              : Read
-  "devices"                  GPtrArray*            : Read
-  "dhcp4-config"             NMDhcpConfig*         : Read
-  "dhcp6-config"             NMDhcpConfig*         : Read
-  "id"                       gchar*                : Read
-  "ip4-config"               NMIPConfig*           : Read
-  "ip6-config"               NMIPConfig*           : Read
-  "master"                   NMDevice*             : Read
-  "specific-object-path"     gchar*                : Read
-  "state"                    NMActiveConnectionState  : Read
-  "type"                     gchar*                : Read
-  "uuid"                     gchar*                : Read
-  "vpn"                      gboolean              : Read
-
-
-
-

Description

-

-

-
-

Details

-
-

NM_ACTIVE_CONNECTION_CONNECTION

-
#define NM_ACTIVE_CONNECTION_CONNECTION           "connection"
-
-

-

-
-
-
-

NM_ACTIVE_CONNECTION_ID

-
#define NM_ACTIVE_CONNECTION_ID                   "id"
-
-

-

-
-
-
-

NM_ACTIVE_CONNECTION_UUID

-
#define NM_ACTIVE_CONNECTION_UUID                 "uuid"
-
-

-

-
-
-
-

NM_ACTIVE_CONNECTION_TYPE

-
#define NM_ACTIVE_CONNECTION_TYPE                 "type"
-
-

-

-
-
-
-

NM_ACTIVE_CONNECTION_SPECIFIC_OBJECT_PATH

-
#define NM_ACTIVE_CONNECTION_SPECIFIC_OBJECT_PATH "specific-object-path"
-
-

-

-
-
-
-

NM_ACTIVE_CONNECTION_DEVICES

-
#define NM_ACTIVE_CONNECTION_DEVICES              "devices"
-
-

-

-
-
-
-

NM_ACTIVE_CONNECTION_STATE

-
#define NM_ACTIVE_CONNECTION_STATE                "state"
-
-

-

-
-
-
-

NM_ACTIVE_CONNECTION_DEFAULT

-
#define NM_ACTIVE_CONNECTION_DEFAULT              "default"
-
-

-

-
-
-
-

NM_ACTIVE_CONNECTION_IP4_CONFIG

-
#define NM_ACTIVE_CONNECTION_IP4_CONFIG           "ip4-config"
-
-

-

-
-
-
-

NM_ACTIVE_CONNECTION_DHCP4_CONFIG

-
#define NM_ACTIVE_CONNECTION_DHCP4_CONFIG         "dhcp4-config"
-
-

-

-
-
-
-

NM_ACTIVE_CONNECTION_DEFAULT6

-
#define NM_ACTIVE_CONNECTION_DEFAULT6             "default6"
-
-

-

-
-
-
-

NM_ACTIVE_CONNECTION_IP6_CONFIG

-
#define NM_ACTIVE_CONNECTION_IP6_CONFIG           "ip6-config"
-
-

-

-
-
-
-

NM_ACTIVE_CONNECTION_DHCP6_CONFIG

-
#define NM_ACTIVE_CONNECTION_DHCP6_CONFIG         "dhcp6-config"
-
-

-

-
-
-
-

NM_ACTIVE_CONNECTION_VPN

-
#define NM_ACTIVE_CONNECTION_VPN                  "vpn"
-
-

-

-
-
-
-

NM_ACTIVE_CONNECTION_MASTER

-
#define NM_ACTIVE_CONNECTION_MASTER               "master"
-
-

-

-
-
-
-

struct NMActiveConnection

-
struct NMActiveConnection;
-

-

-
-
-
-

NMActiveConnectionClass

-
typedef struct {
-	NMObjectClass parent;
-} NMActiveConnectionClass;
-
-

-

-
-
-
-

nm_active_connection_get_connection ()

-
NMRemoteConnection * nm_active_connection_get_connection
-                                                        (NMActiveConnection *connection);
-

-Gets the NMRemoteConnection associated with connection. -

-
+

Functions

+
--++ - - + + + + + + + + + + + + + + + + + + + + + - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

connection :

a NMActiveConnection + +NMRemoteConnection * + +nm_active_connection_get_connection () +
const char * + +nm_active_connection_get_id () +
const char * + +nm_active_connection_get_uuid () +
const char * + +nm_active_connection_get_connection_type () +
const char * + +nm_active_connection_get_specific_object_path () +
const GPtrArray * + +nm_active_connection_get_devices ()

Returns :

the NMRemoteConnection which this -NMActiveConnection is an active instance of. [transfer none] + +NMActiveConnectionState + +nm_active_connection_get_state () +
+NMDevice * + +nm_active_connection_get_master () +
+gboolean + +nm_active_connection_get_default () +
+NMIPConfig * + +nm_active_connection_get_ip4_config () +
+NMDhcpConfig * + +nm_active_connection_get_dhcp4_config () +
+gboolean + +nm_active_connection_get_default6 () +
+NMIPConfig * + +nm_active_connection_get_ip6_config () +
+NMDhcpConfig * + +nm_active_connection_get_dhcp6_config () +
+gboolean + +nm_active_connection_get_vpn ()
-
-
-

nm_active_connection_get_id ()

-
const char *        nm_active_connection_get_id         (NMActiveConnection *connection);
-

-Gets the NMConnection's ID. -

-
+
+

Properties

+
--+++ - - + + + + + + + + - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

connection :

a NMActiveConnection - +NMRemoteConnection *connectionRead
gbooleandefaultRead

Returns :

the ID of the NMConnection that backs the NMActiveConnection. -This is the internal string used by the connection, and must not be modified.gbooleandefault6Read
+GPtrArray *devicesRead
+NMDhcpConfig *dhcp4-configRead
+NMDhcpConfig *dhcp6-configRead
+gchar *idRead
+NMIPConfig *ip4-configRead
+NMIPConfig *ip6-configRead
+NMDevice *masterRead
+gchar *specific-object-pathRead
NMActiveConnectionStatestateRead
+gchar *typeRead
+gchar *uuidRead
gbooleanvpnRead
-
-
-

nm_active_connection_get_uuid ()

-
const char *        nm_active_connection_get_uuid       (NMActiveConnection *connection);
-

-Gets the NMConnection's UUID. -

-
+
+

Types and Values

+
--++ - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - - + + + + + + + + + + + + + + + + + + + + + +

connection :

a NMActiveConnection -#defineNM_ACTIVE_CONNECTION_CONNECTION
#defineNM_ACTIVE_CONNECTION_ID
#defineNM_ACTIVE_CONNECTION_UUID
#defineNM_ACTIVE_CONNECTION_TYPE
#defineNM_ACTIVE_CONNECTION_SPECIFIC_OBJECT_PATH
#defineNM_ACTIVE_CONNECTION_DEVICES
#defineNM_ACTIVE_CONNECTION_STATE
#defineNM_ACTIVE_CONNECTION_DEFAULT
#defineNM_ACTIVE_CONNECTION_IP4_CONFIG

Returns :

the UUID of the NMConnection that backs the NMActiveConnection. -This is the internal string used by the connection, and must not be modified.#defineNM_ACTIVE_CONNECTION_DHCP4_CONFIG
#defineNM_ACTIVE_CONNECTION_DEFAULT6
#defineNM_ACTIVE_CONNECTION_IP6_CONFIG
#defineNM_ACTIVE_CONNECTION_DHCP6_CONFIG
#defineNM_ACTIVE_CONNECTION_VPN
#defineNM_ACTIVE_CONNECTION_MASTER
+
+

Object Hierarchy

+
    GObject
+    ╰── NMObject
+        ╰── NMActiveConnection
+            ╰── NMVpnConnection
+
+
+
+

Description

+

+

+
+
+

Functions

+
+

nm_active_connection_get_connection ()

+
NMRemoteConnection *
+nm_active_connection_get_connection (NMActiveConnection *connection);
+

Gets the NMRemoteConnection associated with connection +.

+
+

Parameters

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

connection

a NMActiveConnection

 
+
+
+

Returns

+

the NMRemoteConnection which this +NMActiveConnection is an active instance of.

+

[transfer none]

+
+
+
+
+

nm_active_connection_get_id ()

+
const char *
+nm_active_connection_get_id (NMActiveConnection *connection);
+

Gets the NMConnection's ID.

+
+

Parameters

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

connection

a NMActiveConnection

 
+
+
+

Returns

+

the ID of the NMConnection that backs the NMActiveConnection. +This is the internal string used by the connection, and must not be modified.

+

+
+
+
+
+

nm_active_connection_get_uuid ()

+
const char *
+nm_active_connection_get_uuid (NMActiveConnection *connection);
+

Gets the NMConnection's UUID.

+
+

Parameters

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

connection

a NMActiveConnection

 
+
+
+

Returns

+

the UUID of the NMConnection that backs the NMActiveConnection. +This is the internal string used by the connection, and must not be modified.

+

+
+

-

nm_active_connection_get_connection_type ()

-
const char *        nm_active_connection_get_connection_type
-                                                        (NMActiveConnection *connection);
-

-Gets the NMConnection's type. -

-
+

nm_active_connection_get_connection_type ()

+
const char *
+nm_active_connection_get_connection_type
+                               (NMActiveConnection *connection);
+

Gets the NMConnection's type.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

connection :

a NMActiveConnection -

Returns :

the type of the NMConnection that backs the NMActiveConnection. -This is the internal string used by the connection, and must not be modified.

connection

a NMActiveConnection

 
+
+

Returns

+

the type of the NMConnection that backs the NMActiveConnection. +This is the internal string used by the connection, and must not be modified.

+

+
+

-

nm_active_connection_get_specific_object_path ()

-
const char *        nm_active_connection_get_specific_object_path
-                                                        (NMActiveConnection *connection);
-

-Gets the path of the "specific object" used at activation. -

-

-Currently there is no single method that will allow you to automatically turn +

nm_active_connection_get_specific_object_path ()

+
const char *
+nm_active_connection_get_specific_object_path
+                               (NMActiveConnection *connection);
+

Gets the path of the "specific object" used at activation.

+

Currently there is no single method that will allow you to automatically turn this into an appropriate NMObject; you need to know what kind of object it -is based on other information. (Eg, if connection corresponds to a Wi-Fi +is based on other information. (Eg, if connection + corresponds to a Wi-Fi connection, then the specific object will be an NMAccessPoint, and you can -resolve it with nm_device_wifi_get_access_point_by_path().) -

-
+resolve it with nm_device_wifi_get_access_point_by_path().)

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

connection :

a NMActiveConnection -

Returns :

the specific object's D-Bus path. This is the internal string used -by the connection, and must not be modified.

connection

a NMActiveConnection

 
+
+

Returns

+

the specific object's D-Bus path. This is the internal string used +by the connection, and must not be modified.

+

+
+

-

nm_active_connection_get_devices ()

-
const GPtrArray *   nm_active_connection_get_devices    (NMActiveConnection *connection);
-

-Gets the NMDevices used for the active connections. -

-
+

nm_active_connection_get_devices ()

+
const GPtrArray *
+nm_active_connection_get_devices (NMActiveConnection *connection);
+

Gets the NMDevices used for the active connections.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

connection :

a NMActiveConnection -

Returns :

the GPtrArray containing NMDevices. -This is the internal copy used by the connection, and must not be modified. [element-type NMDevice] -

connection

a NMActiveConnection

 
+
+

Returns

+

the GPtrArray containing NMDevices. +This is the internal copy used by the connection, and must not be modified.

+

[element-type NMDevice]

+
+

-

nm_active_connection_get_state ()

-
NMActiveConnectionState nm_active_connection_get_state  (NMActiveConnection *connection);
-

-Gets the active connection's state. -

-
+

nm_active_connection_get_state ()

+
NMActiveConnectionState
+nm_active_connection_get_state (NMActiveConnection *connection);
+

Gets the active connection's state.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

connection :

a NMActiveConnection -

Returns :

the state

connection

a NMActiveConnection

 
+
+

Returns

+

the state

+

+
+

-

nm_active_connection_get_master ()

-
NMDevice *          nm_active_connection_get_master     (NMActiveConnection *connection);
-

-Gets the master NMDevice of the connection. -

-
+

nm_active_connection_get_master ()

+
NMDevice *
+nm_active_connection_get_master (NMActiveConnection *connection);
+

Gets the master NMDevice of the connection.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

connection :

a NMActiveConnection -

Returns :

the master NMDevice of the NMActiveConnection. [transfer none] -

connection

a NMActiveConnection

 
+
+

Returns

+

the master NMDevice of the NMActiveConnection.

+

[transfer none]

+
+

-

nm_active_connection_get_default ()

-
gboolean            nm_active_connection_get_default    (NMActiveConnection *connection);
-

-Whether the active connection is the default IPv4 one (that is, is used for -the default IPv4 route and DNS information). -

-
+

nm_active_connection_get_default ()

+
gboolean
+nm_active_connection_get_default (NMActiveConnection *connection);
+

Whether the active connection is the default IPv4 one (that is, is used for +the default IPv4 route and DNS information).

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

connection :

a NMActiveConnection -

Returns :

-TRUE if the active connection is the default IPv4 connection

connection

a NMActiveConnection

 
+
+

Returns

+

TRUE if the active connection is the default IPv4 connection

+

+
+

-

nm_active_connection_get_ip4_config ()

-
NMIPConfig *        nm_active_connection_get_ip4_config (NMActiveConnection *connection);
-

-Gets the current IPv4 NMIPConfig associated with the NMActiveConnection. -

-
+

nm_active_connection_get_ip4_config ()

+
NMIPConfig *
+nm_active_connection_get_ip4_config (NMActiveConnection *connection);
+

Gets the current IPv4 NMIPConfig associated with the NMActiveConnection.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

connection :

an NMActiveConnection -

Returns :

the IPv4 NMIPConfig, or NULL if the connection is -not in the NM_ACTIVE_CONNECTION_STATE_ACTIVATED state. [transfer none] -

connection

an NMActiveConnection

 
+
+

Returns

+

the IPv4 NMIPConfig, or NULL if the connection is +not in the NM_ACTIVE_CONNECTION_STATE_ACTIVATED state.

+

[transfer none]

+
+
-

nm_active_connection_get_dhcp4_config ()

-
NMDhcpConfig *      nm_active_connection_get_dhcp4_config
-                                                        (NMActiveConnection *connection);
-

-Gets the current IPv4 NMDhcpConfig (if any) associated with the -NMActiveConnection. -

-
+

nm_active_connection_get_dhcp4_config ()

+
NMDhcpConfig *
+nm_active_connection_get_dhcp4_config (NMActiveConnection *connection);
+

Gets the current IPv4 NMDhcpConfig (if any) associated with the +NMActiveConnection.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

connection :

an NMActiveConnection -

Returns :

the IPv4 NMDhcpConfig, or NULL if the connection -does not use DHCP, or is not in the NM_ACTIVE_CONNECTION_STATE_ACTIVATED -state. [transfer none] -

connection

an NMActiveConnection

 
+
+

Returns

+

the IPv4 NMDhcpConfig, or NULL if the connection +does not use DHCP, or is not in the NM_ACTIVE_CONNECTION_STATE_ACTIVATED +state.

+

[transfer none]

+
+
-

nm_active_connection_get_default6 ()

-
gboolean            nm_active_connection_get_default6   (NMActiveConnection *connection);
-

-Whether the active connection is the default IPv6 one (that is, is used for -the default IPv6 route and DNS information). -

-
+

nm_active_connection_get_default6 ()

+
gboolean
+nm_active_connection_get_default6 (NMActiveConnection *connection);
+

Whether the active connection is the default IPv6 one (that is, is used for +the default IPv6 route and DNS information).

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

connection :

a NMActiveConnection -

Returns :

-TRUE if the active connection is the default IPv6 connection

connection

a NMActiveConnection

 
+
+

Returns

+

TRUE if the active connection is the default IPv6 connection

+

+
+
-

nm_active_connection_get_ip6_config ()

-
NMIPConfig *        nm_active_connection_get_ip6_config (NMActiveConnection *connection);
-

-Gets the current IPv6 NMIPConfig associated with the NMActiveConnection. -

-
+

nm_active_connection_get_ip6_config ()

+
NMIPConfig *
+nm_active_connection_get_ip6_config (NMActiveConnection *connection);
+

Gets the current IPv6 NMIPConfig associated with the NMActiveConnection.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

connection :

an NMActiveConnection -

Returns :

the IPv6 NMIPConfig, or NULL if the connection is -not in the NM_ACTIVE_CONNECTION_STATE_ACTIVATED state. [transfer none] -

connection

an NMActiveConnection

 
+
+

Returns

+

the IPv6 NMIPConfig, or NULL if the connection is +not in the NM_ACTIVE_CONNECTION_STATE_ACTIVATED state.

+

[transfer none]

+
+
-

nm_active_connection_get_dhcp6_config ()

-
NMDhcpConfig *      nm_active_connection_get_dhcp6_config
-                                                        (NMActiveConnection *connection);
-

-Gets the current IPv6 NMDhcpConfig (if any) associated with the -NMActiveConnection. -

-
+

nm_active_connection_get_dhcp6_config ()

+
NMDhcpConfig *
+nm_active_connection_get_dhcp6_config (NMActiveConnection *connection);
+

Gets the current IPv6 NMDhcpConfig (if any) associated with the +NMActiveConnection.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

connection :

an NMActiveConnection -

Returns :

the IPv6 NMDhcpConfig, or NULL if the connection -does not use DHCPv6, or is not in the NM_ACTIVE_CONNECTION_STATE_ACTIVATED -state. [transfer none] -

connection

an NMActiveConnection

 
+
+

Returns

+

the IPv6 NMDhcpConfig, or NULL if the connection +does not use DHCPv6, or is not in the NM_ACTIVE_CONNECTION_STATE_ACTIVATED +state.

+

[transfer none]

+
+
-

nm_active_connection_get_vpn ()

-
gboolean            nm_active_connection_get_vpn        (NMActiveConnection *connection);
-

-Whether the active connection is a VPN connection. -

-
+

nm_active_connection_get_vpn ()

+
gboolean
+nm_active_connection_get_vpn (NMActiveConnection *connection);
+

Whether the active connection is a VPN connection.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

connection :

a NMActiveConnection -

Returns :

-TRUE if the active connection is a VPN connection

connection

a NMActiveConnection

 
+
+

Returns

+

TRUE if the active connection is a VPN connection

+

+
+
-

Property Details

+

Types and Values

-

The "connection" property

-
  "connection"               NMRemoteConnection*   : Read
+

NM_ACTIVE_CONNECTION_CONNECTION

+
#define NM_ACTIVE_CONNECTION_CONNECTION           "connection"
+

-The connection that this is an active instance of.


-

The "default" property

-
  "default"                  gboolean              : Read
+

NM_ACTIVE_CONNECTION_ID

+
#define NM_ACTIVE_CONNECTION_ID                   "id"
+

-Whether the active connection is the default IPv4 one.

-

Default value: FALSE


-

The "default6" property

-
  "default6"                 gboolean              : Read
+

NM_ACTIVE_CONNECTION_UUID

+
#define NM_ACTIVE_CONNECTION_UUID                 "uuid"
+

-Whether the active connection is the default IPv6 one.

-

Default value: FALSE


-

The "devices" property

-
  "devices"                  GPtrArray*            : Read
+

NM_ACTIVE_CONNECTION_TYPE

+
#define NM_ACTIVE_CONNECTION_TYPE                 "type"
+

-The devices of the active connection.

+
+
+
+

NM_ACTIVE_CONNECTION_SPECIFIC_OBJECT_PATH

+
#define NM_ACTIVE_CONNECTION_SPECIFIC_OBJECT_PATH "specific-object-path"
+

-Element-type: NMDevice


-

The "dhcp4-config" property

-
  "dhcp4-config"             NMDhcpConfig*         : Read
+

NM_ACTIVE_CONNECTION_DEVICES

+
#define NM_ACTIVE_CONNECTION_DEVICES              "devices"
+

-The IPv4 NMDhcpConfig of the connection.


-

The "dhcp6-config" property

-
  "dhcp6-config"             NMDhcpConfig*         : Read
+

NM_ACTIVE_CONNECTION_STATE

+
#define NM_ACTIVE_CONNECTION_STATE                "state"
+

-The IPv6 NMDhcpConfig of the connection.


-

The "id" property

-
  "id"                       gchar*                : Read
+

NM_ACTIVE_CONNECTION_DEFAULT

+
#define NM_ACTIVE_CONNECTION_DEFAULT              "default"
+

-The active connection's ID

-

Default value: NULL


-

The "ip4-config" property

-
  "ip4-config"               NMIPConfig*           : Read
+

NM_ACTIVE_CONNECTION_IP4_CONFIG

+
#define NM_ACTIVE_CONNECTION_IP4_CONFIG           "ip4-config"
+

-The IPv4 NMIPConfig of the connection.


-

The "ip6-config" property

-
  "ip6-config"               NMIPConfig*           : Read
+

NM_ACTIVE_CONNECTION_DHCP4_CONFIG

+
#define NM_ACTIVE_CONNECTION_DHCP4_CONFIG         "dhcp4-config"
+

-The IPv6 NMIPConfig of the connection.


-

The "master" property

-
  "master"                   NMDevice*             : Read
+

NM_ACTIVE_CONNECTION_DEFAULT6

+
#define NM_ACTIVE_CONNECTION_DEFAULT6             "default6"
+

-The master device if one exists.


-

The "specific-object-path" property

-
  "specific-object-path"     gchar*                : Read
+

NM_ACTIVE_CONNECTION_IP6_CONFIG

+
#define NM_ACTIVE_CONNECTION_IP6_CONFIG           "ip6-config"
+

-The path to the "specific object" of the active connection; see -nm_active_connection_get_specific_object_path() for more details.

-

Default value: NULL


-

The "state" property

-
  "state"                    NMActiveConnectionState  : Read
+

NM_ACTIVE_CONNECTION_DHCP6_CONFIG

+
#define NM_ACTIVE_CONNECTION_DHCP6_CONFIG         "dhcp6-config"
+

-The state of the active connection.

-

Default value: NM_ACTIVE_CONNECTION_STATE_UNKNOWN


-

The "type" property

-
  "type"                     gchar*                : Read
+

NM_ACTIVE_CONNECTION_VPN

+
#define NM_ACTIVE_CONNECTION_VPN                  "vpn"
+

-The active connection's type

-

Default value: NULL


-

The "uuid" property

-
  "uuid"                     gchar*                : Read
+

NM_ACTIVE_CONNECTION_MASTER

+
#define NM_ACTIVE_CONNECTION_MASTER               "master"
+

-The active connection's UUID

+
+
+
+

Property Details

+
+

The “connection” property

+
  “connection”               NMRemoteConnection *
+

+

Flags: Read

+
+
+
+

The “default” property

+
  “default”                  gboolean
+

+

Flags: Read

+

Default value: FALSE

+
+
+
+

The “default6” property

+
  “default6”                 gboolean
+

+

Flags: Read

+

Default value: FALSE

+
+
+
+

The “devices” property

+
  “devices”                  GPtrArray *
+

+

Flags: Read

+
+
+
+

The “dhcp4-config” property

+
  “dhcp4-config”             NMDhcpConfig *
+

+

Flags: Read

+
+
+
+

The “dhcp6-config” property

+
  “dhcp6-config”             NMDhcpConfig *
+

+

Flags: Read

+
+
+
+

The “id” property

+
  “id”                       gchar *
+

+

Flags: Read

Default value: NULL


-

The "vpn" property

-
  "vpn"                      gboolean              : Read
-

-Whether the active connection is a VPN connection. -

+

The “ip4-config” property

+
  “ip4-config”               NMIPConfig *
+

+

Flags: Read

+
+
+
+

The “ip6-config” property

+
  “ip6-config”               NMIPConfig *
+

+

Flags: Read

+
+
+
+

The “master” property

+
  “master”                   NMDevice *
+

+

Flags: Read

+
+
+
+

The “specific-object-path” property

+
  “specific-object-path”     gchar *
+

+

Flags: Read

+

Default value: NULL

+
+
+
+

The “state” property

+
  “state”                    NMActiveConnectionState
+

+

Flags: Read

+

Default value: NM_ACTIVE_CONNECTION_STATE_UNKNOWN

+
+
+
+

The “type” property

+
  “type”                     gchar *
+

+

Flags: Read

+

Default value: NULL

+
+
+
+

The “uuid” property

+
  “uuid”                     gchar *
+

+

Flags: Read

+

Default value: NULL

+
+
+
+

The “vpn” property

+
  “vpn”                      gboolean
+

+

Flags: Read

Default value: FALSE

+ Generated by GTK-Doc V1.21 \ No newline at end of file diff --git a/docs/libnm/html/NMClient.html b/docs/libnm/html/NMClient.html index 604d0330..b038c231 100644 --- a/docs/libnm/html/NMClient.html +++ b/docs/libnm/html/NMClient.html @@ -2,38 +2,29 @@ -NMClient +libnm Reference Manual: NMClient - + - - - - - - - - - - + + + + + + +
@@ -41,3019 +32,3491 @@

NMClient

NMClient

- +
-
-

Synopsis

-
#define             NM_CLIENT_VERSION
-#define             NM_CLIENT_STATE
-#define             NM_CLIENT_STARTUP
-#define             NM_CLIENT_NM_RUNNING
-#define             NM_CLIENT_NETWORKING_ENABLED
-#define             NM_CLIENT_WIRELESS_ENABLED
-#define             NM_CLIENT_WIRELESS_HARDWARE_ENABLED
-#define             NM_CLIENT_WWAN_ENABLED
-#define             NM_CLIENT_WWAN_HARDWARE_ENABLED
-#define             NM_CLIENT_WIMAX_ENABLED
-#define             NM_CLIENT_WIMAX_HARDWARE_ENABLED
-#define             NM_CLIENT_ACTIVE_CONNECTIONS
-#define             NM_CLIENT_CONNECTIVITY
-#define             NM_CLIENT_PRIMARY_CONNECTION
-#define             NM_CLIENT_ACTIVATING_CONNECTION
-#define             NM_CLIENT_DEVICES
-#define             NM_CLIENT_CONNECTIONS
-#define             NM_CLIENT_HOSTNAME
-#define             NM_CLIENT_CAN_MODIFY
-#define             NM_CLIENT_DEVICE_ADDED
-#define             NM_CLIENT_DEVICE_REMOVED
-#define             NM_CLIENT_PERMISSION_CHANGED
-#define             NM_CLIENT_CONNECTION_ADDED
-#define             NM_CLIENT_CONNECTION_REMOVED
-enum                NMClientPermission;
-enum                NMClientPermissionResult;
-enum                NMClientError;
-#define             NM_CLIENT_ERROR
-GQuark              nm_client_error_quark               (void);
-struct              NMClient;
-                    NMClientClass;
-NMClient *          nm_client_new                       (GCancellable *cancellable,
-                                                         GError **error);
-void                nm_client_new_async                 (GCancellable *cancellable,
-                                                         GAsyncReadyCallback callback,
-                                                         gpointer user_data);
-NMClient *          nm_client_new_finish                (GAsyncResult *result,
-                                                         GError **error);
-const char *        nm_client_get_version               (NMClient *client);
-NMState             nm_client_get_state                 (NMClient *client);
-gboolean            nm_client_get_startup               (NMClient *client);
-gboolean            nm_client_get_nm_running            (NMClient *client);
-gboolean            nm_client_networking_get_enabled    (NMClient *client);
-gboolean            nm_client_networking_set_enabled    (NMClient *client,
-                                                         gboolean enabled,
-                                                         GError **error);
-gboolean            nm_client_wireless_get_enabled      (NMClient *client);
-void                nm_client_wireless_set_enabled      (NMClient *client,
-                                                         gboolean enabled);
-gboolean            nm_client_wireless_hardware_get_enabled
-                                                        (NMClient *client);
-gboolean            nm_client_wwan_get_enabled          (NMClient *client);
-void                nm_client_wwan_set_enabled          (NMClient *client,
-                                                         gboolean enabled);
-gboolean            nm_client_wwan_hardware_get_enabled (NMClient *client);
-gboolean            nm_client_wimax_get_enabled         (NMClient *client);
-void                nm_client_wimax_set_enabled         (NMClient *client,
-                                                         gboolean enabled);
-gboolean            nm_client_wimax_hardware_get_enabled
-                                                        (NMClient *client);
-gboolean            nm_client_get_logging               (NMClient *client,
-                                                         char **level,
-                                                         char **domains,
-                                                         GError **error);
-gboolean            nm_client_set_logging               (NMClient *client,
-                                                         const char *level,
-                                                         const char *domains,
-                                                         GError **error);
-NMClientPermissionResult nm_client_get_permission_result
-                                                        (NMClient *client,
-                                                         NMClientPermission permission);
-NMConnectivityState nm_client_get_connectivity          (NMClient *client);
-NMConnectivityState nm_client_check_connectivity        (NMClient *client,
-                                                         GCancellable *cancellable,
-                                                         GError **error);
-void                nm_client_check_connectivity_async  (NMClient *client,
-                                                         GCancellable *cancellable,
-                                                         GAsyncReadyCallback callback,
-                                                         gpointer user_data);
-NMConnectivityState nm_client_check_connectivity_finish (NMClient *client,
-                                                         GAsyncResult *result,
-                                                         GError **error);
-gboolean            nm_client_save_hostname             (NMClient *client,
-                                                         const char *hostname,
-                                                         GCancellable *cancellable,
-                                                         GError **error);
-void                nm_client_save_hostname_async       (NMClient *client,
-                                                         const char *hostname,
-                                                         GCancellable *cancellable,
-                                                         GAsyncReadyCallback callback,
-                                                         gpointer user_data);
-gboolean            nm_client_save_hostname_finish      (NMClient *client,
-                                                         GAsyncResult *result,
-                                                         GError **error);
-const GPtrArray *   nm_client_get_devices               (NMClient *client);
-NMDevice *          nm_client_get_device_by_path        (NMClient *client,
-                                                         const char *object_path);
-NMDevice *          nm_client_get_device_by_iface       (NMClient *client,
-                                                         const char *iface);
-const GPtrArray *   nm_client_get_active_connections    (NMClient *client);
-NMActiveConnection * nm_client_get_primary_connection   (NMClient *client);
-NMActiveConnection * nm_client_get_activating_connection
-                                                        (NMClient *client);
-void                nm_client_activate_connection_async (NMClient *client,
-                                                         NMConnection *connection,
-                                                         NMDevice *device,
-                                                         const char *specific_object,
-                                                         GCancellable *cancellable,
-                                                         GAsyncReadyCallback callback,
-                                                         gpointer user_data);
-NMActiveConnection * nm_client_activate_connection_finish
-                                                        (NMClient *client,
-                                                         GAsyncResult *result,
-                                                         GError **error);
-void                nm_client_add_and_activate_connection_async
-                                                        (NMClient *client,
-                                                         NMConnection *partial,
-                                                         NMDevice *device,
-                                                         const char *specific_object,
-                                                         GCancellable *cancellable,
-                                                         GAsyncReadyCallback callback,
-                                                         gpointer user_data);
-NMActiveConnection * nm_client_add_and_activate_connection_finish
-                                                        (NMClient *client,
-                                                         GAsyncResult *result,
-                                                         GError **error);
-gboolean            nm_client_deactivate_connection     (NMClient *client,
-                                                         NMActiveConnection *active,
-                                                         GCancellable *cancellable,
-                                                         GError **error);
-void                nm_client_deactivate_connection_async
-                                                        (NMClient *client,
-                                                         NMActiveConnection *active,
-                                                         GCancellable *cancellable,
-                                                         GAsyncReadyCallback callback,
-                                                         gpointer user_data);
-gboolean            nm_client_deactivate_connection_finish
-                                                        (NMClient *client,
-                                                         GAsyncResult *result,
-                                                         GError **error);
-const GPtrArray *   nm_client_get_connections           (NMClient *client);
-NMRemoteConnection * nm_client_get_connection_by_id     (NMClient *client,
-                                                         const char *id);
-NMRemoteConnection * nm_client_get_connection_by_path   (NMClient *client,
-                                                         const char *path);
-NMRemoteConnection * nm_client_get_connection_by_uuid   (NMClient *client,
-                                                         const char *uuid);
-void                nm_client_add_connection_async      (NMClient *client,
-                                                         NMConnection *connection,
-                                                         gboolean save_to_disk,
-                                                         GCancellable *cancellable,
-                                                         GAsyncReadyCallback callback,
-                                                         gpointer user_data);
-NMRemoteConnection * nm_client_add_connection_finish    (NMClient *client,
-                                                         GAsyncResult *result,
-                                                         GError **error);
-gboolean            nm_client_load_connections          (NMClient *client,
-                                                         char **filenames,
-                                                         char ***failures,
-                                                         GCancellable *cancellable,
-                                                         GError **error);
-void                nm_client_load_connections_async    (NMClient *client,
-                                                         char **filenames,
-                                                         GCancellable *cancellable,
-                                                         GAsyncReadyCallback callback,
-                                                         gpointer user_data);
-gboolean            nm_client_load_connections_finish   (NMClient *client,
-                                                         char ***failures,
-                                                         GAsyncResult *result,
-                                                         GError **error);
-gboolean            nm_client_reload_connections        (NMClient *client,
-                                                         GCancellable *cancellable,
-                                                         GError **error);
-void                nm_client_reload_connections_async  (NMClient *client,
-                                                         GCancellable *cancellable,
-                                                         GAsyncReadyCallback callback,
-                                                         gpointer user_data);
-gboolean            nm_client_reload_connections_finish (NMClient *client,
-                                                         GAsyncResult *result,
-                                                         GError **error);
-
-
-
-

Object Hierarchy

-
-  GEnum
-   +----NMClientPermission
-
-
-  GEnum
-   +----NMClientPermissionResult
-
-
-  GEnum
-   +----NMClientError
-
-
-  GObject
-   +----NMClient
-
-
-
-

Implemented Interfaces

-

-NMClient implements - GInitable and GAsyncInitable.

-
-
-

Properties

-
-  "activating-connection"    NMActiveConnection*   : Read
-  "active-connections"       GPtrArray*            : Read
-  "can-modify"               gboolean              : Read
-  "connections"              GPtrArray*            : Read
-  "connectivity"             NMConnectivityState   : Read
-  "devices"                  GPtrArray*            : Read
-  "hostname"                 gchar*                : Read
-  "networking-enabled"       gboolean              : Read / Write
-  "nm-running"               gboolean              : Read
-  "primary-connection"       NMActiveConnection*   : Read
-  "startup"                  gboolean              : Read
-  "state"                    NMState               : Read
-  "version"                  gchar*                : Read
-  "wimax-enabled"            gboolean              : Read / Write
-  "wimax-hardware-enabled"   gboolean              : Read
-  "wireless-enabled"         gboolean              : Read / Write
-  "wireless-hardware-enabled" gboolean              : Read
-  "wwan-enabled"             gboolean              : Read / Write
-  "wwan-hardware-enabled"    gboolean              : Read
-
-
-
-

Description

-

-

-
-
-

Details

-
-

NM_CLIENT_VERSION

-
#define NM_CLIENT_VERSION "version"
-
-

-

-
-
-
-

NM_CLIENT_STATE

-
#define NM_CLIENT_STATE "state"
-
-

-

-
-
-
-

NM_CLIENT_STARTUP

-
#define NM_CLIENT_STARTUP "startup"
-
-

-

-
-
-
-

NM_CLIENT_NM_RUNNING

-
#define NM_CLIENT_NM_RUNNING "nm-running"
-
-

-

-
-
-
-

NM_CLIENT_NETWORKING_ENABLED

-
#define NM_CLIENT_NETWORKING_ENABLED "networking-enabled"
-
-

-

-
-
-
-

NM_CLIENT_WIRELESS_ENABLED

-
#define NM_CLIENT_WIRELESS_ENABLED "wireless-enabled"
-
-

-

-
-
-
-

NM_CLIENT_WIRELESS_HARDWARE_ENABLED

-
#define NM_CLIENT_WIRELESS_HARDWARE_ENABLED "wireless-hardware-enabled"
-
-

-

-
-
-
-

NM_CLIENT_WWAN_ENABLED

-
#define NM_CLIENT_WWAN_ENABLED "wwan-enabled"
-
-

-

-
-
-
-

NM_CLIENT_WWAN_HARDWARE_ENABLED

-
#define NM_CLIENT_WWAN_HARDWARE_ENABLED "wwan-hardware-enabled"
-
-

-

-
-
-
-

NM_CLIENT_WIMAX_ENABLED

-
#define NM_CLIENT_WIMAX_ENABLED "wimax-enabled"
-
-

-

-
-
-
-

NM_CLIENT_WIMAX_HARDWARE_ENABLED

-
#define NM_CLIENT_WIMAX_HARDWARE_ENABLED "wimax-hardware-enabled"
-
-

-

-
-
-
-

NM_CLIENT_ACTIVE_CONNECTIONS

-
#define NM_CLIENT_ACTIVE_CONNECTIONS "active-connections"
-
-

-

-
-
-
-

NM_CLIENT_CONNECTIVITY

-
#define NM_CLIENT_CONNECTIVITY "connectivity"
-
-

-

-
-
-
-

NM_CLIENT_PRIMARY_CONNECTION

-
#define NM_CLIENT_PRIMARY_CONNECTION "primary-connection"
-
-

-

-
-
-
-

NM_CLIENT_ACTIVATING_CONNECTION

-
#define NM_CLIENT_ACTIVATING_CONNECTION "activating-connection"
-
-

-

-
-
-
-

NM_CLIENT_DEVICES

-
#define NM_CLIENT_DEVICES "devices"
-
-

-

-
-
-
-

NM_CLIENT_CONNECTIONS

-
#define NM_CLIENT_CONNECTIONS "connections"
-
-

-

-
-
-
-

NM_CLIENT_HOSTNAME

-
#define NM_CLIENT_HOSTNAME "hostname"
-
-

-

-
-
-
-

NM_CLIENT_CAN_MODIFY

-
#define NM_CLIENT_CAN_MODIFY "can-modify"
-
-

-

-
-
-
-

NM_CLIENT_DEVICE_ADDED

-
#define NM_CLIENT_DEVICE_ADDED "device-added"
-
-

-

-
-
-
-

NM_CLIENT_DEVICE_REMOVED

-
#define NM_CLIENT_DEVICE_REMOVED "device-removed"
-
-

-

-
-
-
-

NM_CLIENT_PERMISSION_CHANGED

-
#define NM_CLIENT_PERMISSION_CHANGED "permission-changed"
-
-

-

-
-
-
-

NM_CLIENT_CONNECTION_ADDED

-
#define NM_CLIENT_CONNECTION_ADDED "connection-added"
-
-

-

-
-
-
-

NM_CLIENT_CONNECTION_REMOVED

-
#define NM_CLIENT_CONNECTION_REMOVED "connection-removed"
-
-

-

-
-
-
-

enum NMClientPermission

-
typedef enum {
-	NM_CLIENT_PERMISSION_NONE = 0,
-	NM_CLIENT_PERMISSION_ENABLE_DISABLE_NETWORK = 1,
-	NM_CLIENT_PERMISSION_ENABLE_DISABLE_WIFI = 2,
-	NM_CLIENT_PERMISSION_ENABLE_DISABLE_WWAN = 3,
-	NM_CLIENT_PERMISSION_ENABLE_DISABLE_WIMAX = 4,
-	NM_CLIENT_PERMISSION_SLEEP_WAKE = 5,
-	NM_CLIENT_PERMISSION_NETWORK_CONTROL = 6,
-	NM_CLIENT_PERMISSION_WIFI_SHARE_PROTECTED = 7,
-	NM_CLIENT_PERMISSION_WIFI_SHARE_OPEN = 8,
-	NM_CLIENT_PERMISSION_SETTINGS_MODIFY_SYSTEM = 9,
-	NM_CLIENT_PERMISSION_SETTINGS_MODIFY_OWN = 10,
-	NM_CLIENT_PERMISSION_SETTINGS_MODIFY_HOSTNAME = 11,
-
-	NM_CLIENT_PERMISSION_LAST = NM_CLIENT_PERMISSION_SETTINGS_MODIFY_HOSTNAME
-} NMClientPermission;
-
-

-NMClientPermission values indicate various permissions that NetworkManager -clients can obtain to perform certain tasks on behalf of the current user. -

-
+

Functions

+
--++ - - + + + + + + + + + + + + + + + + + + + + + + + + + - - + - - + - - + - - + - - + - - + - - + - - + - - + - - + - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

NM_CLIENT_PERMISSION_NONE

unknown or no permission + +GQuark + +nm_client_error_quark () +
+NMClient * + +nm_client_new () +
+void + +nm_client_new_async () +
+NMClient * + +nm_client_new_finish () +
const char * + +nm_client_get_version () +
+NMState + +nm_client_get_state () +
+gboolean + +nm_client_get_startup ()

NM_CLIENT_PERMISSION_ENABLE_DISABLE_NETWORK

controls whether networking - can be globally enabled or disabled + +gboolean + +nm_client_get_nm_running ()

NM_CLIENT_PERMISSION_ENABLE_DISABLE_WIFI

controls whether Wi-Fi can be - globally enabled or disabled + +gboolean + +nm_client_networking_get_enabled ()

NM_CLIENT_PERMISSION_ENABLE_DISABLE_WWAN

controls whether WWAN (3G) can be - globally enabled or disabled + +gboolean + +nm_client_networking_set_enabled ()

NM_CLIENT_PERMISSION_ENABLE_DISABLE_WIMAX

controls whether WiMAX can be - globally enabled or disabled + +gboolean + +nm_client_wireless_get_enabled ()

NM_CLIENT_PERMISSION_SLEEP_WAKE

controls whether the client can ask - NetworkManager to sleep and wake + +void + +nm_client_wireless_set_enabled ()

NM_CLIENT_PERMISSION_NETWORK_CONTROL

controls whether networking connections - can be started, stopped, and changed + +gboolean + +nm_client_wireless_hardware_get_enabled ()

NM_CLIENT_PERMISSION_WIFI_SHARE_PROTECTED

controls whether a password - protected Wi-Fi hotspot can be created + +gboolean + +nm_client_wwan_get_enabled ()

NM_CLIENT_PERMISSION_WIFI_SHARE_OPEN

controls whether an open Wi-Fi hotspot - can be created + +void + +nm_client_wwan_set_enabled ()

NM_CLIENT_PERMISSION_SETTINGS_MODIFY_SYSTEM

controls whether connections - that are available to all users can be modified + +gboolean + +nm_client_wwan_hardware_get_enabled ()

NM_CLIENT_PERMISSION_SETTINGS_MODIFY_OWN

controls whether connections - owned by the current user can be modified + +gboolean + +nm_client_wimax_get_enabled ()

NM_CLIENT_PERMISSION_SETTINGS_MODIFY_HOSTNAME

controls whether the - persistent hostname can be changed - +void + +nm_client_wimax_set_enabled () +
+gboolean + +nm_client_wimax_hardware_get_enabled () +
+gboolean + +nm_client_get_logging () +
+gboolean + +nm_client_set_logging () +
+NMClientPermissionResult + +nm_client_get_permission_result () +
+NMConnectivityState + +nm_client_get_connectivity () +
+NMConnectivityState + +nm_client_check_connectivity () +
+void + +nm_client_check_connectivity_async () +
+NMConnectivityState + +nm_client_check_connectivity_finish () +
+gboolean + +nm_client_save_hostname () +
+void + +nm_client_save_hostname_async () +
+gboolean + +nm_client_save_hostname_finish () +
const GPtrArray * + +nm_client_get_devices () +
+NMDevice * + +nm_client_get_device_by_path () +
+NMDevice * + +nm_client_get_device_by_iface () +
const GPtrArray * + +nm_client_get_active_connections () +
+NMActiveConnection * + +nm_client_get_primary_connection () +
+NMActiveConnection * + +nm_client_get_activating_connection () +
+void + +nm_client_activate_connection_async () +
+NMActiveConnection * + +nm_client_activate_connection_finish () +
+void + +nm_client_add_and_activate_connection_async () +
+NMActiveConnection * + +nm_client_add_and_activate_connection_finish () +
+gboolean + +nm_client_deactivate_connection () +
+void + +nm_client_deactivate_connection_async () +
+gboolean + +nm_client_deactivate_connection_finish () +
const GPtrArray * + +nm_client_get_connections () +
+NMRemoteConnection * + +nm_client_get_connection_by_id () +
+NMRemoteConnection * + +nm_client_get_connection_by_path () +
+NMRemoteConnection * + +nm_client_get_connection_by_uuid () +
+void + +nm_client_add_connection_async () +
+NMRemoteConnection * + +nm_client_add_connection_finish () +
+gboolean + +nm_client_load_connections () +
+void + +nm_client_load_connections_async () +
+gboolean + +nm_client_load_connections_finish () +
+gboolean + +nm_client_reload_connections () +
+void + +nm_client_reload_connections_async () +
+gboolean + +nm_client_reload_connections_finish () +
+
+
+

Properties

+
+++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+NMActiveConnection *activating-connectionRead
+GPtrArray *active-connectionsRead
gbooleancan-modifyRead
+GPtrArray *connectionsRead
NMConnectivityStateconnectivityRead
+GPtrArray *devicesRead
+gchar *hostnameRead
gbooleannetworking-enabledRead / Write
gbooleannm-runningRead
+NMActiveConnection *primary-connectionRead
gbooleanstartupRead
NMStatestateRead
+gchar *versionRead
gbooleanwimax-enabledRead / Write
gbooleanwimax-hardware-enabledRead
gbooleanwireless-enabledRead / Write
gbooleanwireless-hardware-enabledRead
gbooleanwwan-enabledRead / Write
gbooleanwwan-hardware-enabledRead
+
+
+

Signals

+
+++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + +
voidconnection-addedRun First
voidconnection-removedRun First
voiddevice-addedRun First
voiddevice-removedRun First
voidpermission-changedRun First
+
+
+

Types and Values

+ +
+
+

Object Hierarchy

+
    GEnum
+    ├── NMClientError
+    ├── NMClientPermission
+    ╰── NMClientPermissionResult
+    GObject
+    ╰── NMClient
+
+
+
+

Description

+

+

+
+
+

Functions

+
+

nm_client_error_quark ()

+
GQuark
+nm_client_error_quark (void);
+

Registers an error quark for NMClient if necessary.

+
+

Returns

+

the error quark used for NMClient errors.

+

+
+
+
+
+

nm_client_new ()

+
NMClient *
+nm_client_new (GCancellable *cancellable,
+               GError **error);
+

Creates a new NMClient.

+

Note that this will do blocking D-Bus calls to initialize the +client. You can use nm_client_new_async() if you want to avoid +that.

+
+

Parameters

+
+++++ + + + + + - - + + +

cancellable

a GCancellable, or NULL

 

NM_CLIENT_PERMISSION_LAST

a reserved boundary value -

error

location for a GError, or NULL

 
+
+

Returns

+

a new NMClient or NULL on an error

+

+
+

-

enum NMClientPermissionResult

-
typedef enum {
-	NM_CLIENT_PERMISSION_RESULT_UNKNOWN = 0,
-	NM_CLIENT_PERMISSION_RESULT_YES,
-	NM_CLIENT_PERMISSION_RESULT_AUTH,
-	NM_CLIENT_PERMISSION_RESULT_NO
-} NMClientPermissionResult;
-
-

-NMClientPermissionResult values indicate what authorizations and permissions -the user requires to obtain a given NMClientPermission -

-
+

nm_client_new_async ()

+
void
+nm_client_new_async (GCancellable *cancellable,
+                     GAsyncReadyCallback callback,
+                     gpointer user_data);
+

Creates a new NMClient and begins asynchronously initializing it. +callback + will be called when it is done; use +nm_client_new_finish() to get the result. Note that on an error, +the callback can be invoked with two first parameters as NULL.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + + - - + + +

NM_CLIENT_PERMISSION_RESULT_UNKNOWN

unknown or no authorization -

NM_CLIENT_PERMISSION_RESULT_YES

the permission is available -

cancellable

a GCancellable, or NULL

 

NM_CLIENT_PERMISSION_RESULT_AUTH

authorization is necessary before the - permission is available -

callback

callback to call when the client is created

 

NM_CLIENT_PERMISSION_RESULT_NO

permission to perform the operation is - denied by system policy -

user_data

data for callback +

 
+

-

enum NMClientError

-
typedef enum {
-	NM_CLIENT_ERROR_FAILED = 0,
-	NM_CLIENT_ERROR_MANAGER_NOT_RUNNING,
-	NM_CLIENT_ERROR_OBJECT_CREATION_FAILED,
-} NMClientError;
-
-

-Describes errors that may result from operations involving a NMClient. -

-

-D-Bus operations may also return errors from other domains, including -NMManagerError, NMSettingsError, NMAgentManagerError, and NMConnectionError. -

-
+

nm_client_new_finish ()

+
NMClient *
+nm_client_new_finish (GAsyncResult *result,
+                      GError **error);
+

Gets the result of an nm_client_new_async() call.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + +

NM_CLIENT_ERROR_FAILED

unknown or unclassified error -

NM_CLIENT_ERROR_MANAGER_NOT_RUNNING

an operation that requires NetworkManager - failed because NetworkManager is not running -

result

a GAsyncResult

 

NM_CLIENT_ERROR_OBJECT_CREATION_FAILED

NetworkManager claimed that an - operation succeeded, but the object that was allegedly created (eg, - NMRemoteConnection, NMActiveConnection) was apparently destroyed before - NMClient could create a representation of it. -

error

location for a GError, or NULL

 
-
-
-

NM_CLIENT_ERROR

-
#define NM_CLIENT_ERROR nm_client_error_quark ()
-
-

-

+
+

Returns

+

a new NMClient, or NULL on error

+

+

-

nm_client_error_quark ()

-
GQuark              nm_client_error_quark               (void);
-

-Registers an error quark for NMClient if necessary. -

-
+

nm_client_get_version ()

+
const char *
+nm_client_get_version (NMClient *client);
+

Gets NetworkManager version.

+
+

Parameters

+
--+++ - - + + +

Returns :

the error quark used for NMClient errors.

client

a NMClient

 
+
+

Returns

+

string with the version (or NULL if NetworkManager is not running)

+

+
+

-

struct NMClient

-
struct NMClient;
-

-

+

nm_client_get_state ()

+
NMState
+nm_client_get_state (NMClient *client);
+

Gets the current daemon state.

+
+

Parameters

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

client

a NMClient

 
+
+
+

Returns

+

the current NMState

+

+

-

NMClientClass

-
typedef struct {
-	GObjectClass parent;
-
-	/* Signals */
-	void (*device_added) (NMClient *client, NMDevice *device);
-	void (*device_removed) (NMClient *client, NMDevice *device);
-	void (*permission_changed) (NMClient *client,
-	                            NMClientPermission permission,
-	                            NMClientPermissionResult result);
-	void (*connection_added)   (NMClient *client, NMRemoteConnection *connection);
-	void (*connection_removed) (NMClient *client, NMRemoteConnection *connection);
-} NMClientClass;
-
-

-

+

nm_client_get_startup ()

+
gboolean
+nm_client_get_startup (NMClient *client);
+

Tests whether the daemon is still in the process of activating +connections at startup.

+
+

Parameters

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

client

a NMClient

 
+
+
+

Returns

+

whether the daemon is still starting up

+

+

-

nm_client_new ()

-
NMClient *          nm_client_new                       (GCancellable *cancellable,
-                                                         GError **error);
-

-Creates a new NMClient. -

-

-Note that this will do blocking D-Bus calls to initialize the -client. You can use nm_client_new_async() if you want to avoid -that. -

-
+

nm_client_get_nm_running ()

+
gboolean
+nm_client_get_nm_running (NMClient *client);
+

Determines whether the daemon is running.

+
+

Parameters

+
--+++ - - - - - - - - - - - - - - + + + + +

cancellable :

a GCancellable, or NULL -

error :

location for a GError, or NULL -

Returns :

a new NMClient or NULL on an error

client

a NMClient

 
+
+

Returns

+

TRUE if the daemon is running

+

+
+

-

nm_client_new_async ()

-
void                nm_client_new_async                 (GCancellable *cancellable,
-                                                         GAsyncReadyCallback callback,
-                                                         gpointer user_data);
-

-Creates a new NMClient and begins asynchronously initializing it. -callback will be called when it is done; use -nm_client_new_finish() to get the result. Note that on an error, -the callback can be invoked with two first parameters as NULL. -

-
+

nm_client_networking_get_enabled ()

+
gboolean
+nm_client_networking_get_enabled (NMClient *client);
+

Whether networking is enabled or disabled.

+
+

Parameters

+
--+++ - - - - - - - - - - - - - - + + + + +

cancellable :

a GCancellable, or NULL -

callback :

callback to call when the client is created

user_data :

data for callback -

client

a NMClient

 
+
+

Returns

+

TRUE if networking is enabled, FALSE if networking is disabled

+

+
+
-

nm_client_new_finish ()

-
NMClient *          nm_client_new_finish                (GAsyncResult *result,
-                                                         GError **error);
-

-Gets the result of an nm_client_new_async() call. -

-
+

nm_client_networking_set_enabled ()

+
gboolean
+nm_client_networking_set_enabled (NMClient *client,
+                                  gboolean enabled,
+                                  GError **error);
+

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.

+
+

Parameters

+
--+++ - - + + + - - + + + - - + + +

result :

a GAsyncResult -

client

a NMClient

 

error :

location for a GError, or NULL -

enabled

TRUE to set networking enabled, FALSE to set networking disabled

 

Returns :

a new NMClient, or NULL on error

error

return location for a GError, or NULL.

[allow-none]
+
+

Returns

+

TRUE on success, FALSE otherwise

+

+
+
-

nm_client_get_version ()

-
const char *        nm_client_get_version               (NMClient *client);
-

-Gets NetworkManager version. -

-
+

nm_client_wireless_get_enabled ()

+
gboolean
+nm_client_wireless_get_enabled (NMClient *client);
+

Determines whether the wireless is enabled.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

client :

a NMClient -

Returns :

string with the version (or NULL if NetworkManager is not running)

client

a NMClient

 
+
+

Returns

+

TRUE if wireless is enabled

+

+
+
-

nm_client_get_state ()

-
NMState             nm_client_get_state                 (NMClient *client);
-

-Gets the current daemon state. -

-
+

nm_client_wireless_set_enabled ()

+
void
+nm_client_wireless_set_enabled (NMClient *client,
+                                gboolean enabled);
+

Enables or disables wireless devices.

+
+

Parameters

+
--+++ - - + + + - - + + +

client :

a NMClient -

client

a NMClient

 

Returns :

the current NMState -

enabled

TRUE to enable wireless

 
+
-

nm_client_get_startup ()

-
gboolean            nm_client_get_startup               (NMClient *client);
-

-Tests whether the daemon is still in the process of activating -connections at startup. -

-
+

nm_client_wireless_hardware_get_enabled ()

+
gboolean
+nm_client_wireless_hardware_get_enabled
+                               (NMClient *client);
+

Determines whether the wireless hardware is enabled.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

client :

a NMClient -

Returns :

whether the daemon is still starting up

client

a NMClient

 
+
+

Returns

+

TRUE if the wireless hardware is enabled

+

+
+
-

nm_client_get_nm_running ()

-
gboolean            nm_client_get_nm_running            (NMClient *client);
-

-Determines whether the daemon is running. -

-
+

nm_client_wwan_get_enabled ()

+
gboolean
+nm_client_wwan_get_enabled (NMClient *client);
+

Determines whether WWAN is enabled.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

client :

a NMClient -

Returns :

-TRUE if the daemon is running

client

a NMClient

 
+
+

Returns

+

TRUE if WWAN is enabled

+

+
+
-

nm_client_networking_get_enabled ()

-
gboolean            nm_client_networking_get_enabled    (NMClient *client);
-

-Whether networking is enabled or disabled. -

-
+

nm_client_wwan_set_enabled ()

+
void
+nm_client_wwan_set_enabled (NMClient *client,
+                            gboolean enabled);
+

Enables or disables WWAN devices.

+
+

Parameters

+
--+++ - - + + + - - + + +

client :

a NMClient -

client

a NMClient

 

Returns :

-TRUE if networking is enabled, FALSE if networking is disabled

enabled

TRUE to enable WWAN

 
+
-

nm_client_networking_set_enabled ()

-
gboolean            nm_client_networking_set_enabled    (NMClient *client,
-                                                         gboolean enabled,
-                                                         GError **error);
-

-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. -

-
+

nm_client_wwan_hardware_get_enabled ()

+
gboolean
+nm_client_wwan_hardware_get_enabled (NMClient *client);
+

Determines whether the WWAN hardware is enabled.

+
+

Parameters

+
--+++ - - - - - - - - - - - - - - - - - - + + + + +

client :

a NMClient -

enabled :

-TRUE to set networking enabled, FALSE to set networking disabled

error :

return location for a GError, or NULL. [allow-none] -

Returns :

-TRUE on success, FALSE otherwise

client

a NMClient

 
+
+

Returns

+

TRUE if the WWAN hardware is enabled

+

+
+
-

nm_client_wireless_get_enabled ()

-
gboolean            nm_client_wireless_get_enabled      (NMClient *client);
-

-Determines whether the wireless is enabled. -

-
+

nm_client_wimax_get_enabled ()

+
gboolean
+nm_client_wimax_get_enabled (NMClient *client);
+

Determines whether WiMAX is enabled.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

client :

a NMClient -

Returns :

-TRUE if wireless is enabled

client

a NMClient

 
+
+

Returns

+

TRUE if WiMAX is enabled

+

+
+
-

nm_client_wireless_set_enabled ()

-
void                nm_client_wireless_set_enabled      (NMClient *client,
-                                                         gboolean enabled);
-

-Enables or disables wireless devices. -

-
+

nm_client_wimax_set_enabled ()

+
void
+nm_client_wimax_set_enabled (NMClient *client,
+                             gboolean enabled);
+

Enables or disables WiMAX devices.

+
+

Parameters

+
--+++ - - + + + - - + + +

client :

a NMClient -

client

a NMClient

 

enabled :

-TRUE to enable wireless

enabled

TRUE to enable WiMAX

 
+
-

nm_client_wireless_hardware_get_enabled ()

-
gboolean            nm_client_wireless_hardware_get_enabled
-                                                        (NMClient *client);
-

-Determines whether the wireless hardware is enabled. -

-
+

nm_client_wimax_hardware_get_enabled ()

+
gboolean
+nm_client_wimax_hardware_get_enabled (NMClient *client);
+

Determines whether the WiMAX hardware is enabled.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

client :

a NMClient -

Returns :

-TRUE if the wireless hardware is enabled

client

a NMClient

 
+
+

Returns

+

TRUE if the WiMAX hardware is enabled

+

+
+
-

nm_client_wwan_get_enabled ()

-
gboolean            nm_client_wwan_get_enabled          (NMClient *client);
-

-Determines whether WWAN is enabled. -

-
+

nm_client_get_logging ()

+
gboolean
+nm_client_get_logging (NMClient *client,
+                       char **level,
+                       char **domains,
+                       GError **error);
+

Gets NetworkManager current logging level and domains.

+
+

Parameters

+
--+++ - - + + + - - + + + - -

client :

a NMClient -

client

a NMClient

 

Returns :

-TRUE if WWAN is enabled

level

return location for logging level string.

[allow-none]
-
-
-
-

nm_client_wwan_set_enabled ()

-
void                nm_client_wwan_set_enabled          (NMClient *client,
-                                                         gboolean enabled);
-

-Enables or disables WWAN devices. -

-
---- - - - + + + - - + + +

client :

a NMClient -

domains

return location for log domains string. The string is +a list of domains separated by ",".

[allow-none]

enabled :

-TRUE to enable WWAN

error

return location for a GError, or NULL.

[allow-none]
+
+

Returns

+

TRUE on success, FALSE otherwise

+

+
+
-

nm_client_wwan_hardware_get_enabled ()

-
gboolean            nm_client_wwan_hardware_get_enabled (NMClient *client);
-

-Determines whether the WWAN hardware is enabled. -

-
+

nm_client_set_logging ()

+
gboolean
+nm_client_set_logging (NMClient *client,
+                       const char *level,
+                       const char *domains,
+                       GError **error);
+

Sets NetworkManager logging level and/or domains.

+
+

Parameters

+
--+++ - - + + + - - + + + - -

client :

a NMClient -

client

a NMClient

 

Returns :

-TRUE if the WWAN hardware is enabled

level

logging level to set (NULL or an empty string for no change).

[allow-none]
-
-
-
-

nm_client_wimax_get_enabled ()

-
gboolean            nm_client_wimax_get_enabled         (NMClient *client);
-

-Determines whether WiMAX is enabled. -

-
---- - - - + + + - - + + +

client :

a NMClient -

domains

logging domains to set. The string should be a list of log +domains separated by ",". (NULL or an empty string for no change).

[allow-none]

Returns :

-TRUE if WiMAX is enabled

error

return location for a GError, or NULL.

[allow-none]
+
+

Returns

+

TRUE on success, FALSE otherwise

+

+
+
-

nm_client_wimax_set_enabled ()

-
void                nm_client_wimax_set_enabled         (NMClient *client,
-                                                         gboolean enabled);
-

-Enables or disables WiMAX devices. -

-
+

nm_client_get_permission_result ()

+
NMClientPermissionResult
+nm_client_get_permission_result (NMClient *client,
+                                 NMClientPermission permission);
+

Requests the result of a specific permission, which indicates whether the +client can or cannot perform the action the permission represents

+
+

Parameters

+
--+++ - - + + + - - + + +

client :

a NMClient -

client

a NMClient

 

enabled :

-TRUE to enable WiMAX

permission

the permission for which to return the result, one of NMClientPermission

 
+
+

Returns

+

the permission's result, one of NMClientPermissionResult

+

+
+
-

nm_client_wimax_hardware_get_enabled ()

-
gboolean            nm_client_wimax_hardware_get_enabled
-                                                        (NMClient *client);
-

-Determines whether the WiMAX hardware is enabled. -

-
+

nm_client_get_connectivity ()

+
NMConnectivityState
+nm_client_get_connectivity (NMClient *client);
+

Gets the current network connectivity state. Contrast +nm_client_check_connectivity() and +nm_client_check_connectivity_async(), which re-check the +connectivity state first before returning any information.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

client :

a NMClient -

Returns :

-TRUE if the WiMAX hardware is enabled

client

an NMClient

 
+
+

Returns

+

the current connectivity state

+

+
+
-

nm_client_get_logging ()

-
gboolean            nm_client_get_logging               (NMClient *client,
-                                                         char **level,
-                                                         char **domains,
-                                                         GError **error);
-

-Gets NetworkManager current logging level and domains. -

-
+

nm_client_check_connectivity ()

+
NMConnectivityState
+nm_client_check_connectivity (NMClient *client,
+                              GCancellable *cancellable,
+                              GError **error);
+

Updates the network connectivity state and returns the (new) +current state. Contrast nm_client_get_connectivity(), which returns +the most recent known state without re-checking.

+

This is a blocking call; use nm_client_check_connectivity_async() +if you do not want to block.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + - - + + + - - + + +

client :

a NMClient -

level :

return location for logging level string. [allow-none] -

domains :

return location for log domains string. The string is -a list of domains separated by ",". [allow-none] -

client

an NMClient

 

error :

return location for a GError, or NULL. [allow-none] -

cancellable

a GCancellable

 

Returns :

-TRUE on success, FALSE otherwise

error

return location for a GError

 
+
+

Returns

+

the (new) current connectivity state

+

+
+
-

nm_client_set_logging ()

-
gboolean            nm_client_set_logging               (NMClient *client,
-                                                         const char *level,
-                                                         const char *domains,
-                                                         GError **error);
-

-Sets NetworkManager logging level and/or domains. -

-
+

nm_client_check_connectivity_async ()

+
void
+nm_client_check_connectivity_async (NMClient *client,
+                                    GCancellable *cancellable,
+                                    GAsyncReadyCallback callback,
+                                    gpointer user_data);
+

Asynchronously updates the network connectivity state and invokes +callback + when complete. Contrast nm_client_get_connectivity(), +which (immediately) returns the most recent known state without +re-checking, and nm_client_check_connectivity(), which blocks.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + + - - + + + - - + + +

client :

a NMClient -

level :

logging level to set (NULL or an empty string for no change). [allow-none] -

client

an NMClient

 

domains :

logging domains to set. The string should be a list of log -domains separated by ",". (NULL or an empty string for no change). [allow-none] -

cancellable

a GCancellable

 

error :

return location for a GError, or NULL. [allow-none] -

callback

callback to call with the result

 

Returns :

-TRUE on success, FALSE otherwise

user_data

data for callback +.

 
+
-

nm_client_get_permission_result ()

-
NMClientPermissionResult nm_client_get_permission_result
-                                                        (NMClient *client,
-                                                         NMClientPermission permission);
-

-Requests the result of a specific permission, which indicates whether the -client can or cannot perform the action the permission represents -

-
+

nm_client_check_connectivity_finish ()

+
NMConnectivityState
+nm_client_check_connectivity_finish (NMClient *client,
+                                     GAsyncResult *result,
+                                     GError **error);
+

Retrieves the result of an nm_client_check_connectivity_async() +call.

+
+

Parameters

+
--+++ - - + + + - - + + + - - + + +

client :

a NMClient -

client

an NMClient

 

permission :

the permission for which to return the result, one of NMClientPermission -

result

the GAsyncResult

 

Returns :

the permission's result, one of NMClientPermissionResult -

error

return location for a GError

 
+
+

Returns

+

the (new) current connectivity state

+

+
+
-

nm_client_get_connectivity ()

-
NMConnectivityState nm_client_get_connectivity          (NMClient *client);
-

-Gets the current network connectivity state. Contrast -nm_client_check_connectivity() and -nm_client_check_connectivity_async(), which re-check the -connectivity state first before returning any information. -

-
+

nm_client_save_hostname ()

+
gboolean
+nm_client_save_hostname (NMClient *client,
+                         const char *hostname,
+                         GCancellable *cancellable,
+                         GError **error);
+

Requests that the machine's persistent hostname be set to the specified value +or cleared.

+
+

Parameters

+
--+++ - - + + + - - + + + + + + + + + + + + +

client :

an NMClient -

client

the NMClient

 

Returns :

the current connectivity state

hostname

the new persistent hostname to set, or NULL to +clear any existing persistent hostname.

[allow-none]

cancellable

a GCancellable, or NULL

 

error

return location for GError

 
+
+

Returns

+

TRUE if the request was successful, FALSE if it failed

+

+
+
-

nm_client_check_connectivity ()

-
NMConnectivityState nm_client_check_connectivity        (NMClient *client,
-                                                         GCancellable *cancellable,
-                                                         GError **error);
-

-Updates the network connectivity state and returns the (new) -current state. Contrast nm_client_get_connectivity(), which returns -the most recent known state without re-checking. -

-

-This is a blocking call; use nm_client_check_connectivity_async() -if you do not want to block. -

-
+

nm_client_save_hostname_async ()

+
void
+nm_client_save_hostname_async (NMClient *client,
+                               const char *hostname,
+                               GCancellable *cancellable,
+                               GAsyncReadyCallback callback,
+                               gpointer user_data);
+

Requests that the machine's persistent hostname be set to the specified value +or cleared.

+
+

Parameters

+
--+++ - - + + + - - + + + - - + + + + + + + + - - + + +

client :

an NMClient -

client

the NMClient

 

cancellable :

a GCancellable -

hostname

the new persistent hostname to set, or NULL to +clear any existing persistent hostname.

[allow-none]

error :

return location for a GError -

cancellable

a GCancellable, or NULL

 

callback

callback to be called when the operation completes.

[scope async]

Returns :

the (new) current connectivity state

user_data

caller-specific data passed to callback +.

[closure]
+
-

nm_client_check_connectivity_async ()

-
void                nm_client_check_connectivity_async  (NMClient *client,
-                                                         GCancellable *cancellable,
-                                                         GAsyncReadyCallback callback,
-                                                         gpointer user_data);
-

-Asynchronously updates the network connectivity state and invokes -callback when complete. Contrast nm_client_get_connectivity(), -which (immediately) returns the most recent known state without -re-checking, and nm_client_check_connectivity(), which blocks. -

-
+

nm_client_save_hostname_finish ()

+
gboolean
+nm_client_save_hostname_finish (NMClient *client,
+                                GAsyncResult *result,
+                                GError **error);
+

Gets the result of an nm_client_save_hostname_async() call.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + + - - + + +

client :

an NMClient -

cancellable :

a GCancellable -

client

the NMClient

 

callback :

callback to call with the result

result

the result passed to the GAsyncReadyCallback

 

user_data :

data for callback.

error

return location for GError

 
+
+

Returns

+

TRUE if the request was successful, FALSE if it failed

+

+
+ +
+
+

nm_client_get_devices ()

+
const GPtrArray *
+nm_client_get_devices (NMClient *client);
+

Gets all the known network devices. Use nm_device_get_type() or the +NM_IS_DEVICE_XXXX functions to determine what kind of +device member of the returned array is, and then you may use device-specific +methods such as nm_device_ethernet_get_hw_address().

+
+

Parameters

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

client

a NMClient

 
+
+
+

Returns

+

a GPtrArray +containing all the NMDevices. The returned array is owned by the +NMClient object and should not be modified.

+

[transfer none][element-type NMDevice]

+
+

-

nm_client_check_connectivity_finish ()

-
NMConnectivityState nm_client_check_connectivity_finish (NMClient *client,
-                                                         GAsyncResult *result,
-                                                         GError **error);
-

-Retrieves the result of an nm_client_check_connectivity_async() -call. -

-
+

nm_client_get_device_by_path ()

+
NMDevice *
+nm_client_get_device_by_path (NMClient *client,
+                              const char *object_path);
+

Gets a NMDevice from a NMClient.

+
+

Parameters

+
--+++ - - - - - - + + + - - - - - - + + +

client :

an NMClient -

result :

the GAsyncResult -

client

a NMClient

 

error :

return location for a GError -

Returns :

the (new) current connectivity state

object_path

the object path to search for

 
+
+

Returns

+

the NMDevice for the given object_path +or NULL if none is found.

+

[transfer none]

+
+
-

nm_client_save_hostname ()

-
gboolean            nm_client_save_hostname             (NMClient *client,
-                                                         const char *hostname,
-                                                         GCancellable *cancellable,
-                                                         GError **error);
-

-Requests that the machine's persistent hostname be set to the specified value -or cleared. -

-
+

nm_client_get_device_by_iface ()

+
NMDevice *
+nm_client_get_device_by_iface (NMClient *client,
+                               const char *iface);
+

Gets a NMDevice from a NMClient.

+
+

Parameters

+
--+++ - - - - - - - - - - - - - - + + + - - + + +

client :

the NMClient -

hostname :

the new persistent hostname to set, or NULL to -clear any existing persistent hostname. [allow-none] -

cancellable :

a GCancellable, or NULL -

error :

return location for GError -

client

a NMClient

 

Returns :

-TRUE if the request was successful, FALSE if it failed

iface

the interface name to search for

 
+
+

Returns

+

the NMDevice for the given iface +or NULL if none is found.

+

[transfer none]

+
+
-

nm_client_save_hostname_async ()

-
void                nm_client_save_hostname_async       (NMClient *client,
-                                                         const char *hostname,
-                                                         GCancellable *cancellable,
-                                                         GAsyncReadyCallback callback,
-                                                         gpointer user_data);
-

-Requests that the machine's persistent hostname be set to the specified value -or cleared. -

-
+

nm_client_get_active_connections ()

+
const GPtrArray *
+nm_client_get_active_connections (NMClient *client);
+

Gets the active connections.

+
+

Parameters

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

client

a NMClient

 
+
+
+

Returns

+

a GPtrArray +containing all the active NMActiveConnections. +The returned array is owned by the client and should not be modified.

+

[transfer none][element-type NMActiveConnection]

+
+ +
+
+

nm_client_get_primary_connection ()

+
NMActiveConnection *
+nm_client_get_primary_connection (NMClient *client);
+

Gets the NMActiveConnection corresponding to the primary active +network device.

+

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.

+

If there is no default route, or the default route is over a +non-NetworkManager-recognized device, this will return NULL.

+
+

Parameters

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

client

an NMClient

 
+
+
+

Returns

+

the appropriate NMActiveConnection, if +any.

+

[transfer none]

+
+
+
+
+

nm_client_get_activating_connection ()

+
NMActiveConnection *
+nm_client_get_activating_connection (NMClient *client);
+

Gets the NMActiveConnection corresponding to a +currently-activating connection that is expected to become the new +“primary-connection” upon successful activation.

+
+

Parameters

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

client

an NMClient

 
+
+
+

Returns

+

the appropriate NMActiveConnection, if +any.

+

[transfer none]

+
+
+
+
+

nm_client_activate_connection_async ()

+
void
+nm_client_activate_connection_async (NMClient *client,
+                                     NMConnection *connection,
+                                     NMDevice *device,
+                                     const char *specific_object,
+                                     GCancellable *cancellable,
+                                     GAsyncReadyCallback callback,
+                                     gpointer user_data);
+

Asynchronously starts a connection to a particular network using the +configuration settings from connection + and the network device device +. +Certain connection types also take a "specific object" which is the object +path of a connection- specific object, like an NMAccessPoint for Wi-Fi +connections, or an NMWimaxNsp 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 connection +.

+

If connection + is not given for a device-based activation, NetworkManager +picks the best available connection for the device and activates it.

+

Note that the callback is invoked when NetworkManager has started activating +the new connection, not when it finishes. You can used the returned +NMActiveConnection object (in particular, “state”) to +track the activation to its completion.

+
+

Parameters

+
--+++ - - + + + - - + + + - - + + + - - + + + - - + + + + + + + + + + + + +

client :

the NMClient -

client

a NMClient

 

hostname :

the new persistent hostname to set, or NULL to -clear any existing persistent hostname. [allow-none] -

connection

an NMConnection.

[allow-none]

cancellable :

a GCancellable, or NULL -

device

the NMDevice.

[allow-none]

callback :

callback to be called when the operation completes. [scope async] -

specific_object

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 NULL should be used +(ie, no specific object). For Wi-Fi or WiMAX connections, pass the object +path of a NMAccessPoint or NMWimaxNsp owned by device +, which you can +get using nm_object_get_path(), and which will be used to complete the +details of the newly added connection.

[allow-none]

user_data :

caller-specific data passed to callback. [closure] -

cancellable

a GCancellable, or NULL

 

callback

callback to be called when the activation has started

 

user_data

caller-specific data passed to callback +

 
+

-

nm_client_save_hostname_finish ()

-
gboolean            nm_client_save_hostname_finish      (NMClient *client,
-                                                         GAsyncResult *result,
-                                                         GError **error);
-

-Gets the result of an nm_client_save_hostname_async() call. -

-
+

nm_client_activate_connection_finish ()

+
NMActiveConnection *
+nm_client_activate_connection_finish (NMClient *client,
+                                      GAsyncResult *result,
+                                      GError **error);
+

Gets the result of a call to nm_client_activate_connection_async().

+
+

Parameters

+
--+++ - - - - - - + + + - - + + + - - + + +

client :

the NMClient -

result :

the result passed to the GAsyncReadyCallback -

client

an NMClient

 

error :

return location for GError -

result

the result passed to the GAsyncReadyCallback

 

Returns :

-TRUE if the request was successful, FALSE if it failed

error

location for a GError, or NULL

 
+
+

Returns

+

the new NMActiveConnection on success, NULL on +failure, in which case error +will be set.

+

[transfer full]

+
+
-

nm_client_get_devices ()

-
const GPtrArray *   nm_client_get_devices               (NMClient *client);
-

-Gets all the known network devices. Use nm_device_get_type() or the -NM_IS_DEVICE_XXXX functions to determine what kind of -device member of the returned array is, and then you may use device-specific -methods such as nm_device_ethernet_get_hw_address(). -

-
+

nm_client_add_and_activate_connection_async ()

+
void
+nm_client_add_and_activate_connection_async
+                               (NMClient *client,
+                                NMConnection *partial,
+                                NMDevice *device,
+                                const char *specific_object,
+                                GCancellable *cancellable,
+                                GAsyncReadyCallback callback,
+                                gpointer user_data);
+

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 nm_client_activate_connection_async(). Cannot be used for +VPN connections at this time.

+

Note that the callback is invoked when NetworkManager has started activating +the new connection, not when it finishes. You can used the returned +NMActiveConnection object (in particular, “state”) to +track the activation to its completion.

+
+

Parameters

+
--+++ - - + + + - - + + + - -

client :

a NMClient -

client

a NMClient

 

Returns :

a GPtrArray -containing all the NMDevices. The returned array is owned by the -NMClient object and should not be modified. [transfer none][element-type NMDevice] -

partial

an NMConnection to add; the connection may be +partially filled (or even NULL) and will be completed by NetworkManager +using the given device +and specific_object +before being added.

[allow-none]
-
-
-
-

nm_client_get_device_by_path ()

-
NMDevice *          nm_client_get_device_by_path        (NMClient *client,
-                                                         const char *object_path);
-

-Gets a NMDevice from a NMClient. -

-
---- - - - + + + - - + + + - - + + + + + + + + + + + + +

client :

a NMClient -

device

the NMDevice

 

object_path :

the object path to search for

specific_object

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 NULL should be used +(ie, no specific object). For Wi-Fi or WiMAX connections, pass the object +path of a NMAccessPoint or NMWimaxNsp owned by device +, which you can +get using nm_object_get_path(), and which will be used to complete the +details of the newly added connection.

[allow-none]

Returns :

the NMDevice for the given object_path or NULL if none is found. [transfer none] -

cancellable

a GCancellable, or NULL

 

callback

callback to be called when the activation has started

 

user_data

caller-specific data passed to callback +

 
+
-

nm_client_get_device_by_iface ()

-
NMDevice *          nm_client_get_device_by_iface       (NMClient *client,
-                                                         const char *iface);
-

-Gets a NMDevice from a NMClient. -

-
+

nm_client_add_and_activate_connection_finish ()

+
NMActiveConnection *
+nm_client_add_and_activate_connection_finish
+                               (NMClient *client,
+                                GAsyncResult *result,
+                                GError **error);
+

Gets the result of a call to nm_client_add_and_activate_connection_async().

+

You can call nm_active_connection_get_connection() on the returned +NMActiveConnection to find the path of the created NMConnection.

+
+

Parameters

+
--+++ - - + + + - - + + + - - + + +

client :

a NMClient -

client

an NMClient

 

iface :

the interface name to search for

result

the result passed to the GAsyncReadyCallback

 

Returns :

the NMDevice for the given iface or NULL if none is found. [transfer none] -

error

location for a GError, or NULL

 
+
+

Returns

+

the new NMActiveConnection on success, NULL on +failure, in which case error +will be set.

+

[transfer full]

+
+
-

nm_client_get_active_connections ()

-
const GPtrArray *   nm_client_get_active_connections    (NMClient *client);
-

-Gets the active connections. -

-
+

nm_client_deactivate_connection ()

+
gboolean
+nm_client_deactivate_connection (NMClient *client,
+                                 NMActiveConnection *active,
+                                 GCancellable *cancellable,
+                                 GError **error);
+

Deactivates an active NMActiveConnection.

+
+

Parameters

+
--+++ - - + + + - - + + + + + + + + + + + + +

client :

a NMClient -

client

a NMClient

 

Returns :

a GPtrArray -containing all the active NMActiveConnections. -The returned array is owned by the client and should not be modified. [transfer none][element-type NMActiveConnection] -

active

the NMActiveConnection to deactivate

 

cancellable

a GCancellable, or NULL

 

error

location for a GError, or NULL

 
+
+

Returns

+

success or failure

+

+
+
-

nm_client_get_primary_connection ()

-
NMActiveConnection * nm_client_get_primary_connection   (NMClient *client);
-

-Gets the NMActiveConnection corresponding to the primary active -network device. -

-

-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. -

-

-If there is no default route, or the default route is over a -non-NetworkManager-recognized device, this will return NULL. -

-
+

nm_client_deactivate_connection_async ()

+
void
+nm_client_deactivate_connection_async (NMClient *client,
+                                       NMActiveConnection *active,
+                                       GCancellable *cancellable,
+                                       GAsyncReadyCallback callback,
+                                       gpointer user_data);
+

Asynchronously deactivates an active NMActiveConnection.

+
+

Parameters

+
--+++ - - + + + - - + + + + + + + + + + + + + + + + + +

client :

an NMClient -

client

a NMClient

 

Returns :

the appropriate NMActiveConnection, if -any. [transfer none] -

active

the NMActiveConnection to deactivate

 

cancellable

a GCancellable, or NULL

 

callback

callback to be called when the deactivation has completed

 

user_data

caller-specific data passed to callback +

 
+
-

nm_client_get_activating_connection ()

-
NMActiveConnection * nm_client_get_activating_connection
-                                                        (NMClient *client);
-

-Gets the NMActiveConnection corresponding to a -currently-activating connection that is expected to become the new -"primary-connection" upon successful activation. -

-
+

nm_client_deactivate_connection_finish ()

+
gboolean
+nm_client_deactivate_connection_finish
+                               (NMClient *client,
+                                GAsyncResult *result,
+                                GError **error);
+

Gets the result of a call to nm_client_deactivate_connection_async().

+
+

Parameters

+
--+++ - - + + + - - + + + + + + + +

client :

an NMClient -

client

a NMClient

 

Returns :

the appropriate NMActiveConnection, if -any. [transfer none] -

result

the result passed to the GAsyncReadyCallback

 

error

location for a GError, or NULL

 
+
+

Returns

+

success or failure

+

+
+
-

nm_client_activate_connection_async ()

-
void                nm_client_activate_connection_async (NMClient *client,
-                                                         NMConnection *connection,
-                                                         NMDevice *device,
-                                                         const char *specific_object,
-                                                         GCancellable *cancellable,
-                                                         GAsyncReadyCallback callback,
-                                                         gpointer user_data);
-

-Asynchronously starts a connection to a particular network using the -configuration settings from connection and the network device device. -Certain connection types also take a "specific object" which is the object -path of a connection- specific object, like an NMAccessPoint for Wi-Fi -connections, or an NMWimaxNsp 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 connection. -

-

-If connection is not given for a device-based activation, NetworkManager -picks the best available connection for the device and activates it. -

-

-Note that the callback is invoked when NetworkManager has started activating -the new connection, not when it finishes. You can used the returned -NMActiveConnection object (in particular, "state") to -track the activation to its completion. -

-
+

nm_client_get_connections ()

+
const GPtrArray *
+nm_client_get_connections (NMClient *client);
+
+

Parameters

+
--+++ - - - - - - - - - - - - - - - - - - - - - + + + + + +

client :

a NMClient -

connection :

an NMConnection. [allow-none] -

device :

the NMDevice. [allow-none] -

specific_object :

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 NULL should be used -(ie, no specific object). For Wi-Fi or WiMAX connections, pass the object -path of a NMAccessPoint or NMWimaxNsp owned by device, which you can -get using nm_object_get_path(), and which will be used to complete the -details of the newly added connection. [allow-none] -

cancellable :

a GCancellable, or NULL -

client

the NMClient

 
+
+
+

Returns

+

an array +containing all connections provided by the remote settings service. The +returned array is owned by the NMClient object and should not be modified.

+

[transfer none][element-type NMRemoteConnection]

+
+ +
+
+

nm_client_get_connection_by_id ()

+
NMRemoteConnection *
+nm_client_get_connection_by_id (NMClient *client,
+                                const char *id);
+

Returns the first matching NMRemoteConnection matching a given id +.

+
+

Parameters

+
+++++ + - - + + + - - + + +

callback :

callback to be called when the activation has started

client

the NMClient

 

user_data :

caller-specific data passed to callback -

id

the id of the remote connection

 
+
+

Returns

+

the remote connection object on success, or NULL if no +matching object was found.

+

[transfer none]

+
+

-

nm_client_activate_connection_finish ()

-
NMActiveConnection * nm_client_activate_connection_finish
-                                                        (NMClient *client,
-                                                         GAsyncResult *result,
-                                                         GError **error);
-

-Gets the result of a call to nm_client_activate_connection_async(). -

-
+

nm_client_get_connection_by_path ()

+
NMRemoteConnection *
+nm_client_get_connection_by_path (NMClient *client,
+                                  const char *path);
+

Returns the NMRemoteConnection representing the connection at path +.

+
+

Parameters

+
--+++ - - + + + - - + + + + +

client :

an NMClient -

client

the NMClient

 

result :

the result passed to the GAsyncReadyCallback -

path

the D-Bus object path of the remote connection

 
+
+
+

Returns

+

the remote connection object on success, or NULL if the object was +not known.

+

[transfer none]

+
+ +
+
+

nm_client_get_connection_by_uuid ()

+
NMRemoteConnection *
+nm_client_get_connection_by_uuid (NMClient *client,
+                                  const char *uuid);
+

Returns the NMRemoteConnection identified by uuid +.

+
+

Parameters

+
+++++ + - - + + + - - + + +

error :

location for a GError, or NULL -

client

the NMClient

 

Returns :

the new NMActiveConnection on success, NULL on -failure, in which case error will be set. [transfer full] -

uuid

the UUID of the remote connection

 
+
+

Returns

+

the remote connection object on success, or NULL if the object was +not known.

+

[transfer none]

+
+

-

nm_client_add_and_activate_connection_async ()

-
void                nm_client_add_and_activate_connection_async
-                                                        (NMClient *client,
-                                                         NMConnection *partial,
-                                                         NMDevice *device,
-                                                         const char *specific_object,
-                                                         GCancellable *cancellable,
-                                                         GAsyncReadyCallback callback,
-                                                         gpointer user_data);
-

-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 nm_client_activate_connection_async(). Cannot be used for -VPN connections at this time. -

-

-Note that the callback is invoked when NetworkManager has started activating -the new connection, not when it finishes. You can used the returned -NMActiveConnection object (in particular, "state") to -track the activation to its completion. -

-
+

nm_client_add_connection_async ()

+
void
+nm_client_add_connection_async (NMClient *client,
+                                NMConnection *connection,
+                                gboolean save_to_disk,
+                                GCancellable *cancellable,
+                                GAsyncReadyCallback callback,
+                                gpointer user_data);
+

Requests that the remote settings service add the given settings to a new +connection. If save_to_disk + is TRUE, 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 nm_remote_connection_commit_changes() +method.

+

connection + is untouched by this function and only serves as a template of +the settings to add. The NMRemoteConnection object that represents what +NetworkManager actually added is returned to callback + when the addition +operation is complete.

+

Note that the NMRemoteConnection returned in callback + may not contain +identical settings to connection + as NetworkManager may perform automatic +completion and/or normalization of connection properties.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + + - - + + + - - + + + - - + + + - - + + +

client :

a NMClient -

partial :

an NMConnection to add; the connection may be -partially filled (or even NULL) and will be completed by NetworkManager -using the given device and specific_object before being added. [allow-none] -

client

the NMClient

 

device :

the NMDevice -

connection

the connection to add. Note that this object's settings will be +added, not the object itself

 

specific_object :

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 NULL should be used -(ie, no specific object). For Wi-Fi or WiMAX connections, pass the object -path of a NMAccessPoint or NMWimaxNsp owned by device, which you can -get using nm_object_get_path(), and which will be used to complete the -details of the newly added connection. [allow-none] -

save_to_disk

whether to immediately save the connection to disk

 

cancellable :

a GCancellable, or NULL -

cancellable

a GCancellable, or NULL

 

callback :

callback to be called when the activation has started

callback

callback to be called when the add operation completes.

[scope async]

user_data :

caller-specific data passed to callback -

user_data

caller-specific data passed to callback +.

[closure]
+
-

nm_client_add_and_activate_connection_finish ()

-
NMActiveConnection * nm_client_add_and_activate_connection_finish
-                                                        (NMClient *client,
-                                                         GAsyncResult *result,
-                                                         GError **error);
-

-Gets the result of a call to nm_client_add_and_activate_connection_async(). -

-

-You can call nm_active_connection_get_connection() on the returned -NMActiveConnection to find the path of the created NMConnection. -

-
+

nm_client_add_connection_finish ()

+
NMRemoteConnection *
+nm_client_add_connection_finish (NMClient *client,
+                                 GAsyncResult *result,
+                                 GError **error);
+

Gets the result of a call to nm_client_add_connection_async().

+
+

Parameters

+
--+++ - - - - - - + + + - - + + + - - + + +

client :

an NMClient -

result :

the result passed to the GAsyncReadyCallback -

client

an NMClient

 

error :

location for a GError, or NULL -

result

the result passed to the GAsyncReadyCallback

 

Returns :

the new NMActiveConnection on success, NULL on -failure, in which case error will be set. [transfer full] -

error

location for a GError, or NULL

 
-
-
-

nm_client_deactivate_connection ()

-
gboolean            nm_client_deactivate_connection     (NMClient *client,
-                                                         NMActiveConnection *active,
-                                                         GCancellable *cancellable,
-                                                         GError **error);
-

-Deactivates an active NMActiveConnection. -

-
+
+

Returns

+

the new NMRemoteConnection on success, NULL on +failure, in which case error +will be set.

+

[transfer full]

+
+ +
+
+

nm_client_load_connections ()

+
gboolean
+nm_client_load_connections (NMClient *client,
+                            char **filenames,
+                            char ***failures,
+                            GCancellable *cancellable,
+                            GError **error);
+

Requests that the remote settings service load or reload the given files, +adding or updating the connections described within.

+

The changes to the indicated files will not yet be reflected in +client +'s connections array when the function returns.

+

If all of the indicated files were successfully loaded, the +function will return TRUE, and failures + will be set to NULL. If +NetworkManager tried to load the files, but some (or all) failed, +then failures + will be set to a NULL-terminated array of the +filenames that failed to load.

+
+

Parameters

+
--+++ - - + + + - - + + + - - + + + - - + + + - - + + +

client :

a NMClient -

client

the NMClient

 

active :

the NMActiveConnection to deactivate

filenames

NULL-terminated array of filenames to load

 

cancellable :

a GCancellable, or NULL -

failures

on return, a NULL-terminated array of +filenames that failed to load.

[out][transfer full]

error :

location for a GError, or NULL -

cancellable

a GCancellable, or NULL

 

Returns :

success or failure

error

return location for GError

 
-
-
-

nm_client_deactivate_connection_async ()

-
void                nm_client_deactivate_connection_async
-                                                        (NMClient *client,
-                                                         NMActiveConnection *active,
-                                                         GCancellable *cancellable,
-                                                         GAsyncReadyCallback callback,
-                                                         gpointer user_data);
-

-Asynchronously deactivates an active NMActiveConnection. -

-
+
+

Returns

+

TRUE if NetworkManager at least tried to load filenames +, +FALSE if an error occurred (eg, permission denied).

+

+
+ +
+
+

nm_client_load_connections_async ()

+
void
+nm_client_load_connections_async (NMClient *client,
+                                  char **filenames,
+                                  GCancellable *cancellable,
+                                  GAsyncReadyCallback callback,
+                                  gpointer user_data);
+

Requests that the remote settings service asynchronously load or reload the +given files, adding or updating the connections described within.

+

See nm_client_load_connections() for more details.

+
+

Parameters

+
--+++ - - + + + - - + + + - - + + + - - + + + - - + + +

client :

a NMClient -

client

the NMClient

 

active :

the NMActiveConnection to deactivate

filenames

NULL-terminated array of filenames to load

 

cancellable :

a GCancellable, or NULL -

cancellable

a GCancellable, or NULL

 

callback :

callback to be called when the deactivation has completed

callback

callback to be called when the operation completes.

[scope async]

user_data :

caller-specific data passed to callback -

user_data

caller-specific data passed to callback +.

[closure]
+
-

nm_client_deactivate_connection_finish ()

-
gboolean            nm_client_deactivate_connection_finish
-                                                        (NMClient *client,
-                                                         GAsyncResult *result,
-                                                         GError **error);
-

-Gets the result of a call to nm_client_deactivate_connection_async(). -

-
+

nm_client_load_connections_finish ()

+
gboolean
+nm_client_load_connections_finish (NMClient *client,
+                                   char ***failures,
+                                   GAsyncResult *result,
+                                   GError **error);
+

Gets the result of an nm_client_load_connections_async() call.

+

See nm_client_load_connections() for more details.

+
+

Parameters

+
--+++ - - + + + - - + + + - - + + + - - + + +

client :

a NMClient -

client

the NMClient

 

result :

the result passed to the GAsyncReadyCallback -

failures

on return, a NULL-terminated array of +filenames that failed to load.

[out][transfer full]

error :

location for a GError, or NULL -

result

the result passed to the GAsyncReadyCallback

 

Returns :

success or failure

error

location for a GError, or NULL

 
+
+

Returns

+

TRUE if NetworkManager at least tried to load filenames +, +FALSE if an error occurred (eg, permission denied).

+

+
+
-

nm_client_get_connections ()

-
const GPtrArray *   nm_client_get_connections           (NMClient *client);
-
+

nm_client_reload_connections ()

+
gboolean
+nm_client_reload_connections (NMClient *client,
+                              GCancellable *cancellable,
+                              GError **error);
+

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.

+
+

Parameters

+
--+++ - - + + + - - + + + + + + + +

client :

the NMClient -

client

the NMClient

 

Returns :

an array -containing all connections provided by the remote settings service. The -returned array is owned by the NMClient object and should not be modified. [transfer none][element-type NMRemoteConnection] -

cancellable

a GCancellable, or NULL

 

error

return location for GError

 
+
+

Returns

+

TRUE on success, FALSE on failure

+

+
+
-

nm_client_get_connection_by_id ()

-
NMRemoteConnection * nm_client_get_connection_by_id     (NMClient *client,
-                                                         const char *id);
-

-Returns the first matching NMRemoteConnection matching a given id. -

-
+

nm_client_reload_connections_async ()

+
void
+nm_client_reload_connections_async (NMClient *client,
+                                    GCancellable *cancellable,
+                                    GAsyncReadyCallback callback,
+                                    gpointer user_data);
+

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.

+
+

Parameters

+
--+++ - - + + + - - + + + - - + + + + + + + +

client :

the NMClient -

client

the NMClient

 

id :

the id of the remote connection

cancellable

a GCancellable, or NULL

 

Returns :

the remote connection object on success, or NULL if no -matching object was found. [transfer none] -

callback

callback to be called when the reload operation completes.

[scope async]

user_data

caller-specific data passed to callback +.

[closure]
+
-

nm_client_get_connection_by_path ()

-
NMRemoteConnection * nm_client_get_connection_by_path   (NMClient *client,
-                                                         const char *path);
-

-Returns the NMRemoteConnection representing the connection at path. -

-
+

nm_client_reload_connections_finish ()

+
gboolean
+nm_client_reload_connections_finish (NMClient *client,
+                                     GAsyncResult *result,
+                                     GError **error);
+

Gets the result of an nm_client_reload_connections_async() call.

+
+

Parameters

+
--+++ - - + + + - - + + + - - + + +

client :

the NMClient -

client

the NMClient

 

path :

the D-Bus object path of the remote connection

result

the result passed to the GAsyncReadyCallback

 

Returns :

the remote connection object on success, or NULL if the object was -not known. [transfer none] -

error

return location for GError

 
+
+

Returns

+

TRUE on success, FALSE on failure

+

+
+ + +
+

Types and Values

+
+

NM_CLIENT_VERSION

+
#define NM_CLIENT_VERSION "version"
+
+

+

+

-

nm_client_get_connection_by_uuid ()

-
NMRemoteConnection * nm_client_get_connection_by_uuid   (NMClient *client,
-                                                         const char *uuid);
+

NM_CLIENT_STATE

+
#define NM_CLIENT_STATE "state"
+
+

+

+
+
+
+

NM_CLIENT_STARTUP

+
#define NM_CLIENT_STARTUP "startup"
+
+

+

+
+
+
+

NM_CLIENT_NM_RUNNING

+
#define NM_CLIENT_NM_RUNNING "nm-running"
+
+

+

+
+
+
+

NM_CLIENT_NETWORKING_ENABLED

+
#define NM_CLIENT_NETWORKING_ENABLED "networking-enabled"
+
+

+

+
+
+
+

NM_CLIENT_WIRELESS_ENABLED

+
#define NM_CLIENT_WIRELESS_ENABLED "wireless-enabled"
+
+

+

+
+
+
+

NM_CLIENT_WIRELESS_HARDWARE_ENABLED

+
#define NM_CLIENT_WIRELESS_HARDWARE_ENABLED "wireless-hardware-enabled"
+
+

+

+
+
+
+

NM_CLIENT_WWAN_ENABLED

+
#define NM_CLIENT_WWAN_ENABLED "wwan-enabled"
+
+

+

+
+
+
+

NM_CLIENT_WWAN_HARDWARE_ENABLED

+
#define NM_CLIENT_WWAN_HARDWARE_ENABLED "wwan-hardware-enabled"
+
+

+

+
+
+
+

NM_CLIENT_WIMAX_ENABLED

+
#define NM_CLIENT_WIMAX_ENABLED "wimax-enabled"
+
+

+

+
+
+
+

NM_CLIENT_WIMAX_HARDWARE_ENABLED

+
#define NM_CLIENT_WIMAX_HARDWARE_ENABLED "wimax-hardware-enabled"
+
+

+

+
+
+
+

NM_CLIENT_ACTIVE_CONNECTIONS

+
#define NM_CLIENT_ACTIVE_CONNECTIONS "active-connections"
+
+

+

+
+
+
+

NM_CLIENT_CONNECTIVITY

+
#define NM_CLIENT_CONNECTIVITY "connectivity"
+
+

+

+
+
+
+

NM_CLIENT_PRIMARY_CONNECTION

+
#define NM_CLIENT_PRIMARY_CONNECTION "primary-connection"
+
+

+

+
+
+
+

NM_CLIENT_ACTIVATING_CONNECTION

+
#define NM_CLIENT_ACTIVATING_CONNECTION "activating-connection"
+
+

+

+
+
+
+

NM_CLIENT_DEVICES

+
#define NM_CLIENT_DEVICES "devices"
+
+

+

+
+
+
+

NM_CLIENT_CONNECTIONS

+
#define NM_CLIENT_CONNECTIONS "connections"
+
+

+

+
+
+
+

NM_CLIENT_HOSTNAME

+
#define NM_CLIENT_HOSTNAME "hostname"
+

-Returns the NMRemoteConnection identified by uuid.

-
---- - - - - - - - - - - - - - - -

client :

the NMClient -

uuid :

the UUID of the remote connection

Returns :

the remote connection object on success, or NULL if the object was -not known. [transfer none] -

-

nm_client_add_connection_async ()

-
void                nm_client_add_connection_async      (NMClient *client,
-                                                         NMConnection *connection,
-                                                         gboolean save_to_disk,
-                                                         GCancellable *cancellable,
-                                                         GAsyncReadyCallback callback,
-                                                         gpointer user_data);
-

-Requests that the remote settings service add the given settings to a new -connection. If save_to_disk is TRUE, 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 nm_remote_connection_commit_changes() -method. -

+

NM_CLIENT_CAN_MODIFY

+
#define NM_CLIENT_CAN_MODIFY "can-modify"
+

-connection is untouched by this function and only serves as a template of -the settings to add. The NMRemoteConnection object that represents what -NetworkManager actually added is returned to callback when the addition -operation is complete.

+
+
+
+

NM_CLIENT_DEVICE_ADDED

+
#define NM_CLIENT_DEVICE_ADDED "device-added"
+

-Note that the NMRemoteConnection returned in callback may not contain -identical settings to connection as NetworkManager may perform automatic -completion and/or normalization of connection properties.

-
---- - - - - - - - - - - - - - - - - - - - - - - - - - - -

client :

the NMClient -

connection :

the connection to add. Note that this object's settings will be -added, not the object itself

save_to_disk :

whether to immediately save the connection to disk

cancellable :

a GCancellable, or NULL -

callback :

callback to be called when the add operation completes. [scope async] -

user_data :

caller-specific data passed to callback. [closure] -

-

nm_client_add_connection_finish ()

-
NMRemoteConnection * nm_client_add_connection_finish    (NMClient *client,
-                                                         GAsyncResult *result,
-                                                         GError **error);
+

NM_CLIENT_DEVICE_REMOVED

+
#define NM_CLIENT_DEVICE_REMOVED "device-removed"
+

-Gets the result of a call to nm_client_add_connection_async().

-
---- - - - - - - - - - - - - - - - - - - -

client :

an NMClient -

result :

the result passed to the GAsyncReadyCallback -

error :

location for a GError, or NULL -

Returns :

the new NMRemoteConnection on success, NULL on -failure, in which case error will be set. [transfer full] -

-

nm_client_load_connections ()

-
gboolean            nm_client_load_connections          (NMClient *client,
-                                                         char **filenames,
-                                                         char ***failures,
-                                                         GCancellable *cancellable,
-                                                         GError **error);
+

NM_CLIENT_PERMISSION_CHANGED

+
#define NM_CLIENT_PERMISSION_CHANGED "permission-changed"
+

-Requests that the remote settings service load or reload the given files, -adding or updating the connections described within.

+
+
+
+

NM_CLIENT_CONNECTION_ADDED

+
#define NM_CLIENT_CONNECTION_ADDED "connection-added"
+

-The changes to the indicated files will not yet be reflected in -client's connections array when the function returns.

+
+
+
+

NM_CLIENT_CONNECTION_REMOVED

+
#define NM_CLIENT_CONNECTION_REMOVED "connection-removed"
+

-If all of the indicated files were successfully loaded, the -function will return TRUE, and failures will be set to NULL. If -NetworkManager tried to load the files, but some (or all) failed, -then failures will be set to a NULL-terminated array of the -filenames that failed to load.

-
+ +
+
+

enum NMClientPermission

+

NMClientPermission values indicate various permissions that NetworkManager +clients can obtain to perform certain tasks on behalf of the current user.

+
+

Members

+
--+++ - - + + - - - - - - + + - - + + - - + + - - - - -

client :

the NMClient +

NM_CLIENT_PERMISSION_NONE

+

unknown or no permission

 

filenames :

-NULL-terminated array of filenames to load

failures :

on return, a NULL-terminated array of -filenames that failed to load. [out][transfer full] +

NM_CLIENT_PERMISSION_ENABLE_DISABLE_NETWORK

+

controls whether networking + can be globally enabled or disabled

 

cancellable :

a GCancellable, or NULL +

NM_CLIENT_PERMISSION_ENABLE_DISABLE_WIFI

+

controls whether Wi-Fi can be + globally enabled or disabled

 

error :

return location for GError +

NM_CLIENT_PERMISSION_ENABLE_DISABLE_WWAN

+

controls whether WWAN (3G) can be + globally enabled or disabled

 

Returns :

-TRUE if NetworkManager at least tried to load filenames, -FALSE if an error occurred (eg, permission denied).
-
-
-
-

nm_client_load_connections_async ()

-
void                nm_client_load_connections_async    (NMClient *client,
-                                                         char **filenames,
-                                                         GCancellable *cancellable,
-                                                         GAsyncReadyCallback callback,
-                                                         gpointer user_data);
-

-Requests that the remote settings service asynchronously load or reload the -given files, adding or updating the connections described within. -

-

-See nm_client_load_connections() for more details. -

-
---- - - - - + + - - - - - - + + - - + + - - + + - -

client :

the NMClient +

NM_CLIENT_PERMISSION_ENABLE_DISABLE_WIMAX

+

controls whether WiMAX can be + globally enabled or disabled

 

filenames :

-NULL-terminated array of filenames to load

cancellable :

a GCancellable, or NULL +

NM_CLIENT_PERMISSION_SLEEP_WAKE

+

controls whether the client can ask + NetworkManager to sleep and wake

 

callback :

callback to be called when the operation completes. [scope async] +

NM_CLIENT_PERMISSION_NETWORK_CONTROL

+

controls whether networking connections + can be started, stopped, and changed

 

user_data :

caller-specific data passed to callback. [closure] +

NM_CLIENT_PERMISSION_WIFI_SHARE_PROTECTED

+

controls whether a password + protected Wi-Fi hotspot can be created

 
-
-
-
-

nm_client_load_connections_finish ()

-
gboolean            nm_client_load_connections_finish   (NMClient *client,
-                                                         char ***failures,
-                                                         GAsyncResult *result,
-                                                         GError **error);
-

-Gets the result of an nm_client_load_connections_async() call. -

-

-See nm_client_load_connections() for more details. -

-
---- - - - + + - - + + - - + + - - + + - - + + +

client :

the NMClient +

NM_CLIENT_PERMISSION_WIFI_SHARE_OPEN

+

controls whether an open Wi-Fi hotspot + can be created

 

failures :

on return, a NULL-terminated array of -filenames that failed to load. [out][transfer full] +

NM_CLIENT_PERMISSION_SETTINGS_MODIFY_SYSTEM

+

controls whether connections + that are available to all users can be modified

 

result :

the result passed to the GAsyncReadyCallback +

NM_CLIENT_PERMISSION_SETTINGS_MODIFY_OWN

+

controls whether connections + owned by the current user can be modified

 

error :

location for a GError, or NULL +

NM_CLIENT_PERMISSION_SETTINGS_MODIFY_HOSTNAME

+

controls whether the + persistent hostname can be changed

 

Returns :

-TRUE if NetworkManager at least tried to load filenames, -FALSE if an error occurred (eg, permission denied).

NM_CLIENT_PERMISSION_LAST

+

a reserved boundary value

+
 
+

-

nm_client_reload_connections ()

-
gboolean            nm_client_reload_connections        (NMClient *client,
-                                                         GCancellable *cancellable,
-                                                         GError **error);
-

-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. -

-
+

enum NMClientPermissionResult

+

NMClientPermissionResult values indicate what authorizations and permissions +the user requires to obtain a given NMClientPermission

+
+

Members

+
--+++ - - + + - - + + - - + + - - + + +

client :

the NMClient +

NM_CLIENT_PERMISSION_RESULT_UNKNOWN

+

unknown or no authorization

 

cancellable :

a GCancellable, or NULL +

NM_CLIENT_PERMISSION_RESULT_YES

+

the permission is available

 

error :

return location for GError +

NM_CLIENT_PERMISSION_RESULT_AUTH

+

authorization is necessary before the + permission is available

 

Returns :

-TRUE on success, FALSE on failure

NM_CLIENT_PERMISSION_RESULT_NO

+

permission to perform the operation is + denied by system policy

+
 
+
-

nm_client_reload_connections_async ()

-
void                nm_client_reload_connections_async  (NMClient *client,
-                                                         GCancellable *cancellable,
-                                                         GAsyncReadyCallback callback,
-                                                         gpointer user_data);
-

-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. -

-
+

enum NMClientError

+

Describes errors that may result from operations involving a NMClient.

+

D-Bus operations may also return errors from other domains, including +NMManagerError, NMSettingsError, NMAgentManagerError, and NMConnectionError.

+
+

Members

+
--+++ - - + + - - + + - - - - - - + +

client :

the NMClient +

NM_CLIENT_ERROR_FAILED

+

unknown or unclassified error

 

cancellable :

a GCancellable, or NULL +

NM_CLIENT_ERROR_MANAGER_NOT_RUNNING

+

an operation that requires NetworkManager + failed because NetworkManager is not running

 

callback :

callback to be called when the reload operation completes. [scope async] -

user_data :

caller-specific data passed to callback. [closure] +

NM_CLIENT_ERROR_OBJECT_CREATION_FAILED

+

NetworkManager claimed that an + operation succeeded, but the object that was allegedly created (eg, + NMRemoteConnection, NMActiveConnection) was apparently destroyed before + NMClient could create a representation of it.

 
+
-

nm_client_reload_connections_finish ()

-
gboolean            nm_client_reload_connections_finish (NMClient *client,
-                                                         GAsyncResult *result,
-                                                         GError **error);
+

NM_CLIENT_ERROR

+
#define NM_CLIENT_ERROR nm_client_error_quark ()
+

-Gets the result of an nm_client_reload_connections_async() call.

-
---- - - - - - - - - - - - - - - - - - - -

client :

the NMClient -

result :

the result passed to the GAsyncReadyCallback -

error :

return location for GError -

Returns :

-TRUE on success, FALSE on failure

Property Details

-

The "activating-connection" property

-
  "activating-connection"    NMActiveConnection*   : Read
-

-The NMActiveConnection of the activating connection that is -likely to become the new "primary-connection". -

+

The “activating-connection” property

+
  “activating-connection”    NMActiveConnection *
+

+

Flags: Read


-

The "active-connections" property

-
  "active-connections"       GPtrArray*            : Read
-

-The active connections. -

-

-Element-type: NMActiveConnection -

+

The “active-connections” property

+
  “active-connections”       GPtrArray *
+

+

Flags: Read


-

The "can-modify" property

-
  "can-modify"               gboolean              : Read
-

-If TRUE, adding and modifying connections is supported. -

+

The “can-modify” property

+
  “can-modify”               gboolean
+

+

Flags: Read

Default value: FALSE


-

The "connections" property

-
  "connections"              GPtrArray*            : Read
-

-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.) -

-

-Element-type: NMRemoteConnection -

+

The “connections” property

+
  “connections”              GPtrArray *
+

+

Flags: Read


-

The "connectivity" property

-
  "connectivity"             NMConnectivityState   : Read
-

-The network connectivity state. -

+

The “connectivity” property

+
  “connectivity”             NMConnectivityState
+

+

Flags: Read

Default value: NM_CONNECTIVITY_UNKNOWN


-

The "devices" property

-
  "devices"                  GPtrArray*            : Read
-

-List of known network devices. -

-

-Element-type: NMDevice -

+

The “devices” property

+
  “devices”                  GPtrArray *
+

+

Flags: Read


-

The "hostname" property

-
  "hostname"                 gchar*                : Read
-

-The machine hostname stored in persistent configuration. This can be -modified by calling nm_client_save_hostname(). -

+

The “hostname” property

+
  “hostname”                 gchar *
+

+

Flags: Read

Default value: NULL


-

The "networking-enabled" property

-
  "networking-enabled"       gboolean              : Read / Write
-

-Whether networking is enabled. -

+

The “networking-enabled” property

+
  “networking-enabled”       gboolean
+

+

Flags: Read / Write

Default value: TRUE


-

The "nm-running" property

-
  "nm-running"               gboolean              : Read
-

-Whether the daemon is running. -

+

The “nm-running” property

+
  “nm-running”               gboolean
+

+

Flags: Read

Default value: FALSE


-

The "primary-connection" property

-
  "primary-connection"       NMActiveConnection*   : Read
-

-The NMActiveConnection of the device with the default route; -see nm_client_get_primary_connection() for more details. -

+

The “primary-connection” property

+
  “primary-connection”       NMActiveConnection *
+

+

Flags: Read


-

The "startup" property

-
  "startup"                  gboolean              : Read
-

-Whether the daemon is still starting up. -

+

The “startup” property

+
  “startup”                  gboolean
+

+

Flags: Read

Default value: FALSE


-

The "state" property

-
  "state"                    NMState               : Read
-

-The current daemon state. -

+

The “state” property

+
  “state”                    NMState
+

+

Flags: Read

Default value: NM_STATE_UNKNOWN


-

The "version" property

-
  "version"                  gchar*                : Read
-

-The NetworkManager version. -

+

The “version” property

+
  “version”                  gchar *
+

+

Flags: Read

Default value: NULL


-

The "wimax-enabled" property

-
  "wimax-enabled"            gboolean              : Read / Write
-

-Whether WiMAX functionality is enabled. -

+

The “wimax-enabled” property

+
  “wimax-enabled”            gboolean
+

+

Flags: Read / Write

Default value: FALSE


-

The "wimax-hardware-enabled" property

-
  "wimax-hardware-enabled"   gboolean              : Read
-

-Whether the WiMAX hardware is enabled. -

+

The “wimax-hardware-enabled” property

+
  “wimax-hardware-enabled”   gboolean
+

+

Flags: Read

Default value: FALSE


-

The "wireless-enabled" property

-
  "wireless-enabled"         gboolean              : Read / Write
-

-Whether wireless is enabled. -

+

The “wireless-enabled” property

+
  “wireless-enabled”         gboolean
+

+

Flags: Read / Write

Default value: FALSE


-

The "wireless-hardware-enabled" property

-
  "wireless-hardware-enabled" gboolean              : Read
-

-Whether the wireless hardware is enabled. -

+

The “wireless-hardware-enabled” property

+
  “wireless-hardware-enabled” gboolean
+

+

Flags: Read

Default value: TRUE


-

The "wwan-enabled" property

-
  "wwan-enabled"             gboolean              : Read / Write
-

-Whether WWAN functionality is enabled. -

+

The “wwan-enabled” property

+
  “wwan-enabled”             gboolean
+

+

Flags: Read / Write

Default value: FALSE


-

The "wwan-hardware-enabled" property

-
  "wwan-hardware-enabled"    gboolean              : Read
-

-Whether the WWAN hardware is enabled. -

+

The “wwan-hardware-enabled” property

+
  “wwan-hardware-enabled”    gboolean
+

+

Flags: Read

Default value: FALSE

Signal Details

-

The "connection-added" signal

-
void                user_function                      (NMClient           *client,
-                                                        NMRemoteConnection *connection,
-                                                        gpointer            user_data)       : Run First
-

-Notifies that a NMConnection has been added. -

-
---- - - - - - - - - - - - - - - -

client :

the settings object that received the signal

connection :

the new connection

user_data :

user data set when the signal handler was connected.
+

The “connection-added” signal

+
void
+user_function (NMClient           *client,
+               NMRemoteConnection *connection,
+               gpointer            user_data)
+

Flags: Run First


-

The "connection-removed" signal

-
void                user_function                      (NMClient           *client,
-                                                        NMRemoteConnection *connection,
-                                                        gpointer            user_data)       : Run First
-

-Notifies that a NMConnection has been removed. -

-
---- - - - - - - - - - - - - - - -

client :

the settings object that received the signal

connection :

the removed connection

user_data :

user data set when the signal handler was connected.
+

The “connection-removed” signal

+
void
+user_function (NMClient           *client,
+               NMRemoteConnection *connection,
+               gpointer            user_data)
+

Flags: Run First


-

The "device-added" signal

-
void                user_function                      (NMClient *client,
-                                                        GObject  *device,
-                                                        gpointer  user_data)      : Run First
-

-Notifies that a NMDevice is added. -

-
---- - - - - - - - - - - - - - - -

client :

the client that received the signal

device :

the new device. [type NMDevice] -

user_data :

user data set when the signal handler was connected.
+

The “device-added” signal

+
void
+user_function (NMClient *client,
+               GObject  *device,
+               gpointer  user_data)
+

Flags: Run First


-

The "device-removed" signal

-
void                user_function                      (NMClient *client,
-                                                        GObject  *device,
-                                                        gpointer  user_data)      : Run First
-

-Notifies that a NMDevice is removed. -

-
---- - - - - - - - - - - - - - - -

client :

the client that received the signal

device :

the removed device. [type NMDevice] -

user_data :

user data set when the signal handler was connected.
+

The “device-removed” signal

+
void
+user_function (NMClient *client,
+               GObject  *device,
+               gpointer  user_data)
+

Flags: Run First


-

The "permission-changed" signal

-
void                user_function                      (NMClient *client,
-                                                        guint     permission,
-                                                        guint     result,
-                                                        gpointer  user_data)       : Run First
-

-Notifies that a permission has changed -

-
---- - - - - - - - - - - - - - - - - - - -

client :

the client that received the signal

permission :

a permission from NMClientPermission -

result :

the permission's result, one of NMClientPermissionResult -

user_data :

user data set when the signal handler was connected.
+

The “permission-changed” signal

+
void
+user_function (NMClient *client,
+               guint     permission,
+               guint     result,
+               gpointer  user_data)
+

Flags: Run First

+ Generated by GTK-Doc V1.21 \ No newline at end of file diff --git a/docs/libnm/html/NMDevice.html b/docs/libnm/html/NMDevice.html index 9ac8d27a..13cae2db 100644 --- a/docs/libnm/html/NMDevice.html +++ b/docs/libnm/html/NMDevice.html @@ -2,38 +2,29 @@ -NMDevice +libnm Reference Manual: NMDevice - + - - - - - - - - - - + + + + + + +
@@ -41,1818 +32,2260 @@

NMDevice

NMDevice

- +
-
-

Synopsis

-
#define             NM_DEVICE_DEVICE_TYPE
-#define             NM_DEVICE_UDI
-#define             NM_DEVICE_INTERFACE
-#define             NM_DEVICE_IP_INTERFACE
-#define             NM_DEVICE_DRIVER
-#define             NM_DEVICE_DRIVER_VERSION
-#define             NM_DEVICE_FIRMWARE_VERSION
-#define             NM_DEVICE_CAPABILITIES
-#define             NM_DEVICE_MANAGED
-#define             NM_DEVICE_AUTOCONNECT
-#define             NM_DEVICE_FIRMWARE_MISSING
-#define             NM_DEVICE_IP4_CONFIG
-#define             NM_DEVICE_DHCP4_CONFIG
-#define             NM_DEVICE_IP6_CONFIG
-#define             NM_DEVICE_DHCP6_CONFIG
-#define             NM_DEVICE_STATE
-#define             NM_DEVICE_STATE_REASON
-#define             NM_DEVICE_ACTIVE_CONNECTION
-#define             NM_DEVICE_AVAILABLE_CONNECTIONS
-#define             NM_DEVICE_VENDOR
-#define             NM_DEVICE_PRODUCT
-#define             NM_DEVICE_PHYSICAL_PORT_ID
-#define             NM_DEVICE_MTU
-struct              NMDevice;
-                    NMDeviceClass;
-const char *        nm_device_get_iface                 (NMDevice *device);
-const char *        nm_device_get_ip_iface              (NMDevice *device);
-NMDeviceType        nm_device_get_device_type           (NMDevice *device);
-const char *        nm_device_get_udi                   (NMDevice *device);
-const char *        nm_device_get_driver                (NMDevice *device);
-const char *        nm_device_get_driver_version        (NMDevice *device);
-const char *        nm_device_get_firmware_version      (NMDevice *device);
-const char *        nm_device_get_type_description      (NMDevice *device);
-const char *        nm_device_get_hw_address            (NMDevice *device);
-NMDeviceCapabilities nm_device_get_capabilities         (NMDevice *device);
-gboolean            nm_device_get_managed               (NMDevice *device);
-gboolean            nm_device_get_autoconnect           (NMDevice *device);
-void                nm_device_set_autoconnect           (NMDevice *device,
-                                                         gboolean autoconnect);
-gboolean            nm_device_get_firmware_missing      (NMDevice *device);
-NMIPConfig *        nm_device_get_ip4_config            (NMDevice *device);
-NMDhcpConfig *      nm_device_get_dhcp4_config          (NMDevice *device);
-NMIPConfig *        nm_device_get_ip6_config            (NMDevice *device);
-NMDhcpConfig *      nm_device_get_dhcp6_config          (NMDevice *device);
-NMDeviceState       nm_device_get_state                 (NMDevice *device);
-NMDeviceStateReason nm_device_get_state_reason          (NMDevice *device);
-NMActiveConnection * nm_device_get_active_connection    (NMDevice *device);
-const GPtrArray *   nm_device_get_available_connections (NMDevice *device);
-const char *        nm_device_get_physical_port_id      (NMDevice *device);
-guint32             nm_device_get_mtu                   (NMDevice *device);
-gboolean            nm_device_is_software               (NMDevice *device);
-const char *        nm_device_get_product               (NMDevice *device);
-const char *        nm_device_get_vendor                (NMDevice *device);
-const char *        nm_device_get_description           (NMDevice *device);
-char **             nm_device_disambiguate_names        (NMDevice **devices,
-                                                         int num_devices);
-gboolean            nm_device_disconnect                (NMDevice *device,
-                                                         GCancellable *cancellable,
-                                                         GError **error);
-void                nm_device_disconnect_async          (NMDevice *device,
-                                                         GCancellable *cancellable,
-                                                         GAsyncReadyCallback callback,
-                                                         gpointer user_data);
-gboolean            nm_device_disconnect_finish         (NMDevice *device,
-                                                         GAsyncResult *result,
-                                                         GError **error);
-gboolean            nm_device_delete                    (NMDevice *device,
-                                                         GCancellable *cancellable,
-                                                         GError **error);
-void                nm_device_delete_async              (NMDevice *device,
-                                                         GCancellable *cancellable,
-                                                         GAsyncReadyCallback callback,
-                                                         gpointer user_data);
-gboolean            nm_device_delete_finish             (NMDevice *device,
-                                                         GAsyncResult *result,
-                                                         GError **error);
-GPtrArray *         nm_device_filter_connections        (NMDevice *device,
-                                                         const GPtrArray *connections);
-gboolean            nm_device_connection_valid          (NMDevice *device,
-                                                         NMConnection *connection);
-gboolean            nm_device_connection_compatible     (NMDevice *device,
-                                                         NMConnection *connection,
-                                                         GError **error);
-GType               nm_device_get_setting_type          (NMDevice *device);
-
-
-
-

Object Hierarchy

-
-  GObject
-   +----NMObject
-         +----NMDevice
-               +----NMDeviceAdsl
-               +----NMDeviceBond
-               +----NMDeviceBridge
-               +----NMDeviceBt
-               +----NMDeviceEthernet
-               +----NMDeviceGeneric
-               +----NMDeviceInfiniband
-               +----NMDeviceModem
-               +----NMDeviceOlpcMesh
-               +----NMDeviceTeam
-               +----NMDeviceVlan
-               +----NMDeviceWifi
-               +----NMDeviceWimax
-
-
-
-

Implemented Interfaces

-

-NMDevice implements - GInitable and GAsyncInitable.

-
-
-

Properties

-
-  "active-connection"        NMActiveConnection*   : Read
-  "autoconnect"              gboolean              : Read / Write
-  "available-connections"    GPtrArray*            : Read
-  "capabilities"             NMDeviceCapabilities  : Read
-  "device-type"              NMDeviceType          : Read
-  "dhcp4-config"             NMDhcpConfig*         : Read
-  "dhcp6-config"             NMDhcpConfig*         : Read
-  "driver"                   gchar*                : Read
-  "driver-version"           gchar*                : Read
-  "firmware-missing"         gboolean              : Read
-  "firmware-version"         gchar*                : Read
-  "interface"                gchar*                : Read
-  "ip-interface"             gchar*                : Read
-  "ip4-config"               NMIPConfig*           : Read
-  "ip6-config"               NMIPConfig*           : Read
-  "managed"                  gboolean              : Read
-  "mtu"                      guint                 : Read
-  "physical-port-id"         gchar*                : Read
-  "product"                  gchar*                : Read
-  "state"                    NMDeviceState         : Read
-  "state-reason"             guint                 : Read
-  "udi"                      gchar*                : Read
-  "vendor"                   gchar*                : Read
-
-
-
-

Signals

-
-  "state-changed"                                  : Run First
-
-
-
-

Description

-

-

-
-

Details

-
-

NM_DEVICE_DEVICE_TYPE

-
#define NM_DEVICE_DEVICE_TYPE "device-type"
-
-

-

-
-
-
-

NM_DEVICE_UDI

-
#define NM_DEVICE_UDI "udi"
-
-

-

-
-
-
-

NM_DEVICE_INTERFACE

-
#define NM_DEVICE_INTERFACE "interface"
-
-

-

-
-
-
-

NM_DEVICE_IP_INTERFACE

-
#define NM_DEVICE_IP_INTERFACE "ip-interface"
-
-

-

-
-
-
-

NM_DEVICE_DRIVER

-
#define NM_DEVICE_DRIVER "driver"
-
-

-

-
-
-
-

NM_DEVICE_DRIVER_VERSION

-
#define NM_DEVICE_DRIVER_VERSION "driver-version"
-
-

-

-
-
-
-

NM_DEVICE_FIRMWARE_VERSION

-
#define NM_DEVICE_FIRMWARE_VERSION "firmware-version"
-
-

-

-
-
-
-

NM_DEVICE_CAPABILITIES

-
#define NM_DEVICE_CAPABILITIES "capabilities"
-
-

-

-
-
-
-

NM_DEVICE_MANAGED

-
#define NM_DEVICE_MANAGED "managed"
-
-

-

-
-
-
-

NM_DEVICE_AUTOCONNECT

-
#define NM_DEVICE_AUTOCONNECT "autoconnect"
-
-

-

-
-
-
-

NM_DEVICE_FIRMWARE_MISSING

-
#define NM_DEVICE_FIRMWARE_MISSING "firmware-missing"
-
-

-

-
-
-
-

NM_DEVICE_IP4_CONFIG

-
#define NM_DEVICE_IP4_CONFIG "ip4-config"
-
-

-

-
-
-
-

NM_DEVICE_DHCP4_CONFIG

-
#define NM_DEVICE_DHCP4_CONFIG "dhcp4-config"
-
-

-

-
-
-
-

NM_DEVICE_IP6_CONFIG

-
#define NM_DEVICE_IP6_CONFIG "ip6-config"
-
-

-

-
-
-
-

NM_DEVICE_DHCP6_CONFIG

-
#define NM_DEVICE_DHCP6_CONFIG "dhcp6-config"
-
-

-

-
-
-
-

NM_DEVICE_STATE

-
#define NM_DEVICE_STATE "state"
-
-

-

-
-
-
-

NM_DEVICE_STATE_REASON

-
#define NM_DEVICE_STATE_REASON "state-reason"
-
-

-

-
-
-
-

NM_DEVICE_ACTIVE_CONNECTION

-
#define NM_DEVICE_ACTIVE_CONNECTION "active-connection"
-
-

-

-
-
-
-

NM_DEVICE_AVAILABLE_CONNECTIONS

-
#define NM_DEVICE_AVAILABLE_CONNECTIONS "available-connections"
-
-

-

-
-
-
-

NM_DEVICE_VENDOR

-
#define NM_DEVICE_VENDOR "vendor"
-
-

-

-
-
-
-

NM_DEVICE_PRODUCT

-
#define NM_DEVICE_PRODUCT "product"
-
-

-

-
-
-
-

NM_DEVICE_PHYSICAL_PORT_ID

-
#define NM_DEVICE_PHYSICAL_PORT_ID "physical-port-id"
-
-

-

-
-
-
-

NM_DEVICE_MTU

-
#define NM_DEVICE_MTU "mtu"
-
-

-

-
-
-
-

struct NMDevice

-
struct NMDevice;
-

-

-
-
-
-

NMDeviceClass

-
typedef struct {
-	NMObjectClass parent;
-
-	/* Signals */
-	void (*state_changed) (NMDevice *device,
-	                       NMDeviceState new_state,
-	                       NMDeviceState old_state,
-	                       NMDeviceStateReason reason);
-
-	/* Methods */
-	gboolean (*connection_compatible) (NMDevice *device,
-	                                   NMConnection *connection,
-	                                   GError **error);
-
-	const char * (*get_type_description) (NMDevice *device);
-	const char * (*get_hw_address) (NMDevice *device);
-
-	GType (*get_setting_type) (NMDevice *device);
-} NMDeviceClass;
-
-

-

-
-
-
-

nm_device_get_iface ()

-
const char *        nm_device_get_iface                 (NMDevice *device);
-

-Gets the interface name of the NMDevice. -

-
+

Functions

+
--++ - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - - + +

device :

a NMDevice +const char * + +nm_device_get_iface () +
const char * + +nm_device_get_ip_iface () +
+NMDeviceType + +nm_device_get_device_type () +
const char * + +nm_device_get_udi () +
const char * + +nm_device_get_driver () +
const char * + +nm_device_get_driver_version () +
const char * + +nm_device_get_firmware_version () +
const char * + +nm_device_get_type_description () +
const char * + +nm_device_get_hw_address () +
+NMDeviceCapabilities + +nm_device_get_capabilities () +
+gboolean + +nm_device_get_managed () +
+gboolean + +nm_device_get_autoconnect () +
+void + +nm_device_set_autoconnect () +
+gboolean + +nm_device_get_firmware_missing () +
+NMIPConfig * + +nm_device_get_ip4_config () +
+NMDhcpConfig * + +nm_device_get_dhcp4_config () +
+NMIPConfig * + +nm_device_get_ip6_config () +
+NMDhcpConfig * + +nm_device_get_dhcp6_config () +
+NMDeviceState + +nm_device_get_state () +
+NMDeviceStateReason + +nm_device_get_state_reason () +
+NMActiveConnection * + +nm_device_get_active_connection () +
const GPtrArray * + +nm_device_get_available_connections () +
const char * + +nm_device_get_physical_port_id () +
+guint32 + +nm_device_get_mtu () +
+gboolean + +nm_device_is_software () +
const char * + +nm_device_get_product () +
const char * + +nm_device_get_vendor () +
const char * + +nm_device_get_description () +
+char ** + +nm_device_disambiguate_names () +
+gboolean + +nm_device_disconnect () +
+void + +nm_device_disconnect_async () +
+gboolean + +nm_device_disconnect_finish () +
+gboolean + +nm_device_delete () +
+void + +nm_device_delete_async () +
+gboolean + +nm_device_delete_finish () +
+GPtrArray * + +nm_device_filter_connections () +
+gboolean + +nm_device_connection_valid () +
+gboolean + +nm_device_connection_compatible ()

Returns :

the interface of the device. This is the internal string used by the -device, and must not be modified. +GType + +nm_device_get_setting_type () +
-
-
-

nm_device_get_ip_iface ()

-
const char *        nm_device_get_ip_iface              (NMDevice *device);
-

-Gets the IP interface name of the NMDevice over which IP traffic flows -when the device is in the ACTIVATED state. -

-
+
+

Properties

+
--+++ - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

device :

a NMDevice - +NMActiveConnection *active-connectionRead
gbooleanautoconnectRead / Write
+GPtrArray *available-connectionsRead
NMDeviceCapabilitiescapabilitiesRead
NMDeviceTypedevice-typeRead
+NMDhcpConfig *dhcp4-configRead
+NMDhcpConfig *dhcp6-configRead
+gchar *driverRead
+gchar *driver-versionRead
gbooleanfirmware-missingRead
+gchar *firmware-versionRead
+gchar *interfaceRead
+gchar *ip-interfaceRead
+NMIPConfig *ip4-configRead

Returns :

the IP traffic interface of the device. This is the internal string -used by the device, and must not be modified. +NMIPConfig *ip6-configRead
gbooleanmanagedRead
guintmtuRead
+gchar *physical-port-idRead
+gchar *productRead
NMDeviceStatestateRead
guintstate-reasonRead
+gchar *udiRead
+gchar *vendorRead
-
-
-

nm_device_get_device_type ()

-
NMDeviceType        nm_device_get_device_type           (NMDevice *device);
-

-Returns the numeric type of the NMDevice, ie Ethernet, Wi-Fi, etc. -

-
+
+

Signals

+
+++++ + + + + + +
voidstate-changedRun First
+
+
+

Types and Values

+
--++ - - + + + + + + + + + + - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

device :

a NMDevice -#defineNM_DEVICE_DEVICE_TYPE
#defineNM_DEVICE_UDI
#defineNM_DEVICE_INTERFACE

Returns :

the device type#defineNM_DEVICE_IP_INTERFACE
#defineNM_DEVICE_DRIVER
#defineNM_DEVICE_DRIVER_VERSION
#defineNM_DEVICE_FIRMWARE_VERSION
#defineNM_DEVICE_CAPABILITIES
#defineNM_DEVICE_MANAGED
#defineNM_DEVICE_AUTOCONNECT
#defineNM_DEVICE_FIRMWARE_MISSING
#defineNM_DEVICE_IP4_CONFIG
#defineNM_DEVICE_DHCP4_CONFIG
#defineNM_DEVICE_IP6_CONFIG
#defineNM_DEVICE_DHCP6_CONFIG
#defineNM_DEVICE_STATE
#defineNM_DEVICE_STATE_REASON
#defineNM_DEVICE_ACTIVE_CONNECTION
#defineNM_DEVICE_AVAILABLE_CONNECTIONS
#defineNM_DEVICE_VENDOR
#defineNM_DEVICE_PRODUCT
#defineNM_DEVICE_PHYSICAL_PORT_ID
#defineNM_DEVICE_MTU
-
-
-

nm_device_get_udi ()

-
const char *        nm_device_get_udi                   (NMDevice *device);
+
+

Object Hierarchy

+
    GObject
+    ╰── NMObject
+        ╰── NMDevice
+            ├── NMDeviceAdsl
+            ├── NMDeviceBond
+            ├── NMDeviceBridge
+            ├── NMDeviceBt
+            ├── NMDeviceEthernet
+            ├── NMDeviceGeneric
+            ├── NMDeviceInfiniband
+            ├── NMDeviceModem
+            ├── NMDeviceOlpcMesh
+            ├── NMDeviceTeam
+            ├── NMDeviceVlan
+            ├── NMDeviceWifi
+            ╰── NMDeviceWimax
+
+
+
+

Description

-Gets the Unique Device Identifier of the NMDevice.

-
+ +
+

Functions

+
+

nm_device_get_iface ()

+
const char *
+nm_device_get_iface (NMDevice *device);
+

Gets the interface name of the NMDevice.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

device :

a NMDevice -

Returns :

the Unique Device Identifier of the device. This identifier may be -used to gather more information about the device from various operating -system services like udev or sysfs.

device

a NMDevice

 
+
+

Returns

+

the interface of the device. This is the internal string used by the +device, and must not be modified.

+

+
+

-

nm_device_get_driver ()

-
const char *        nm_device_get_driver                (NMDevice *device);
-

-Gets the driver of the NMDevice. -

-
+

nm_device_get_ip_iface ()

+
const char *
+nm_device_get_ip_iface (NMDevice *device);
+

Gets the IP interface name of the NMDevice over which IP traffic flows +when the device is in the ACTIVATED state.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

device :

a NMDevice -

Returns :

the driver of the device. This is the internal string used by the -device, and must not be modified.

device

a NMDevice

 
+
+

Returns

+

the IP traffic interface of the device. This is the internal string +used by the device, and must not be modified.

+

+
+

-

nm_device_get_driver_version ()

-
const char *        nm_device_get_driver_version        (NMDevice *device);
-

-Gets the driver version of the NMDevice. -

-
+

nm_device_get_device_type ()

+
NMDeviceType
+nm_device_get_device_type (NMDevice *device);
+

Returns the numeric type of the NMDevice, ie Ethernet, Wi-Fi, etc.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

device :

a NMDevice -

Returns :

the version of the device driver. This is the internal string used by the -device, and must not be modified.

device

a NMDevice

 
+
+

Returns

+

the device type

+

+
+

-

nm_device_get_firmware_version ()

-
const char *        nm_device_get_firmware_version      (NMDevice *device);
-

-Gets the firmware version of the NMDevice. -

-
+

nm_device_get_udi ()

+
const char *
+nm_device_get_udi (NMDevice *device);
+

Gets the Unique Device Identifier of the NMDevice.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

device :

a NMDevice -

Returns :

the firmware version of the device. This is the internal string used by the -device, and must not be modified.

device

a NMDevice

 
+
+

Returns

+

the Unique Device Identifier of the device. This identifier may be +used to gather more information about the device from various operating +system services like udev or sysfs.

+

+
+
-

nm_device_get_type_description ()

-
const char *        nm_device_get_type_description      (NMDevice *device);
-

-Gets a (non-localized) description of the type of device that -device is. -

-
+

nm_device_get_driver ()

+
const char *
+nm_device_get_driver (NMDevice *device);
+

Gets the driver of the NMDevice.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

device :

a NMDevice -

Returns :

the type description of the device. This is the internal -string used by the device, and must not be modified.

device

a NMDevice

 
+
+

Returns

+

the driver of the device. This is the internal string used by the +device, and must not be modified.

+

+
+
-

nm_device_get_hw_address ()

-
const char *        nm_device_get_hw_address            (NMDevice *device);
-

-Gets the current a hardware address (MAC) for the device. -

-
+

nm_device_get_driver_version ()

+
const char *
+nm_device_get_driver_version (NMDevice *device);
+

Gets the driver version of the NMDevice.

+
+

Parameters

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

device

a NMDevice

 
+
+
+

Returns

+

the version of the device driver. This is the internal string used by the +device, and must not be modified.

+

+
+ +
+
+

nm_device_get_firmware_version ()

+
const char *
+nm_device_get_firmware_version (NMDevice *device);
+

Gets the firmware version of the NMDevice.

+
+

Parameters

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

device

a NMDevice

 
+
+
+

Returns

+

the firmware version of the device. This is the internal string used by the +device, and must not be modified.

+

+
+
+
+
+

nm_device_get_type_description ()

+
const char *
+nm_device_get_type_description (NMDevice *device);
+

Gets a (non-localized) description of the type of device that +device + is.

+
+

Parameters

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

device

a NMDevice

 
+
+
+

Returns

+

the type description of the device. This is the internal +string used by the device, and must not be modified.

+

+
+
+
+
+

nm_device_get_hw_address ()

+
const char *
+nm_device_get_hw_address (NMDevice *device);
+

Gets the current a hardware address (MAC) for the device +.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

device :

a NMDevice -

Returns :

the current MAC of the device, or NULL. -This is the internal string used by the device, and must not be modified.

device

a NMDevice

 
+
+

Returns

+

the current MAC of the device, or NULL. +This is the internal string used by the device, and must not be modified.

+

+
+

-

nm_device_get_capabilities ()

-
NMDeviceCapabilities nm_device_get_capabilities         (NMDevice *device);
-

-Gets the device' capabilities. -

-
+

nm_device_get_capabilities ()

+
NMDeviceCapabilities
+nm_device_get_capabilities (NMDevice *device);
+

Gets the device' capabilities.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

device :

a NMDevice -

Returns :

the capabilities

device

a NMDevice

 
+
+

Returns

+

the capabilities

+

+
+
-

nm_device_get_managed ()

-
gboolean            nm_device_get_managed               (NMDevice *device);
-

-Whether the NMDevice is managed by NetworkManager. -

-
+

nm_device_get_managed ()

+
gboolean
+nm_device_get_managed (NMDevice *device);
+

Whether the NMDevice is managed by NetworkManager.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

device :

a NMDevice -

Returns :

-TRUE if the device is managed by NetworkManager

device

a NMDevice

 
+
+

Returns

+

TRUE if the device is managed by NetworkManager

+

+
+
-

nm_device_get_autoconnect ()

-
gboolean            nm_device_get_autoconnect           (NMDevice *device);
-

-Whether the NMDevice can be autoconnected. -

-
+

nm_device_get_autoconnect ()

+
gboolean
+nm_device_get_autoconnect (NMDevice *device);
+

Whether the NMDevice can be autoconnected.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

device :

a NMDevice -

Returns :

-TRUE if the device is allowed to be autoconnected

device

a NMDevice

 
+
+

Returns

+

TRUE if the device is allowed to be autoconnected

+

+
+
-

nm_device_set_autoconnect ()

-
void                nm_device_set_autoconnect           (NMDevice *device,
-                                                         gboolean autoconnect);
-

-Enables or disables automatic activation of the NMDevice. -

-
+

nm_device_set_autoconnect ()

+
void
+nm_device_set_autoconnect (NMDevice *device,
+                           gboolean autoconnect);
+

Enables or disables automatic activation of the NMDevice.

+
+

Parameters

+
--+++ - - + + + - - + + +

device :

a NMDevice -

device

a NMDevice

 

autoconnect :

-TRUE to enable autoconnecting

autoconnect

TRUE to enable autoconnecting

 
+
-

nm_device_get_firmware_missing ()

-
gboolean            nm_device_get_firmware_missing      (NMDevice *device);
-

-Indicates that firmware required for the device's operation is likely -to be missing. -

-
+

nm_device_get_firmware_missing ()

+
gboolean
+nm_device_get_firmware_missing (NMDevice *device);
+

Indicates that firmware required for the device's operation is likely +to be missing.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

device :

a NMDevice -

Returns :

-TRUE if firmware required for the device's operation is likely -to be missing.

device

a NMDevice

 
+
+

Returns

+

TRUE if firmware required for the device's operation is likely +to be missing.

+

+
+
-

nm_device_get_ip4_config ()

-
NMIPConfig *        nm_device_get_ip4_config            (NMDevice *device);
-

-Gets the current IPv4 NMIPConfig associated with the NMDevice. -

-

-You can alternatively use nm_active_connection_get_ip4_config(), which also -works with VPN connections. -

-
+

nm_device_get_ip4_config ()

+
NMIPConfig *
+nm_device_get_ip4_config (NMDevice *device);
+

Gets the current IPv4 NMIPConfig associated with the NMDevice.

+

You can alternatively use nm_active_connection_get_ip4_config(), which also +works with VPN connections.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

device :

a NMDevice -

Returns :

the IPv4 NMIPConfig, or NULL if the device is not -activated. [transfer none] -

device

a NMDevice

 
+
+

Returns

+

the IPv4 NMIPConfig, or NULL if the device is not +activated.

+

[transfer none]

+
+
-

nm_device_get_dhcp4_config ()

-
NMDhcpConfig *      nm_device_get_dhcp4_config          (NMDevice *device);
-

-Gets the current IPv4 NMDhcpConfig associated with the NMDevice. -

-

-You can alternatively use nm_active_connection_get_dhcp4_config(), which also -works with VPN connections. -

-
+

nm_device_get_dhcp4_config ()

+
NMDhcpConfig *
+nm_device_get_dhcp4_config (NMDevice *device);
+

Gets the current IPv4 NMDhcpConfig associated with the NMDevice.

+

You can alternatively use nm_active_connection_get_dhcp4_config(), which also +works with VPN connections.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

device :

a NMDevice -

Returns :

the IPv4 NMDhcpConfig, or NULL if the device is -not activated or not using DHCP. [transfer none] -

device

a NMDevice

 
+
+

Returns

+

the IPv4 NMDhcpConfig, or NULL if the device is +not activated or not using DHCP.

+

[transfer none]

+
+
-

nm_device_get_ip6_config ()

-
NMIPConfig *        nm_device_get_ip6_config            (NMDevice *device);
-

-Gets the current IPv6 NMIPConfig associated with the NMDevice. -

-

-You can alternatively use nm_active_connection_get_ip6_config(), which also -works with VPN connections. -

-
+

nm_device_get_ip6_config ()

+
NMIPConfig *
+nm_device_get_ip6_config (NMDevice *device);
+

Gets the current IPv6 NMIPConfig associated with the NMDevice.

+

You can alternatively use nm_active_connection_get_ip6_config(), which also +works with VPN connections.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

device :

a NMDevice -

Returns :

the IPv6 NMIPConfig or NULL if the device is not activated. [transfer none] -

device

a NMDevice

 
+
+

Returns

+

the IPv6 NMIPConfig or NULL if the device is not activated.

+

[transfer none]

+
+
-

nm_device_get_dhcp6_config ()

-
NMDhcpConfig *      nm_device_get_dhcp6_config          (NMDevice *device);
-

-Gets the current IPv6 NMDhcpConfig associated with the NMDevice. -

-

-You can alternatively use nm_active_connection_get_dhcp6_config(), which also -works with VPN connections. -

-
+

nm_device_get_dhcp6_config ()

+
NMDhcpConfig *
+nm_device_get_dhcp6_config (NMDevice *device);
+

Gets the current IPv6 NMDhcpConfig associated with the NMDevice.

+

You can alternatively use nm_active_connection_get_dhcp6_config(), which also +works with VPN connections.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

device :

a NMDevice -

Returns :

the IPv6 NMDhcpConfig, or NULL if the device is -not activated or not using DHCPv6. [transfer none] -

device

a NMDevice

 
+
+

Returns

+

the IPv6 NMDhcpConfig, or NULL if the device is +not activated or not using DHCPv6.

+

[transfer none]

+
+
-

nm_device_get_state ()

-
NMDeviceState       nm_device_get_state                 (NMDevice *device);
-

-Gets the current NMDevice state. -

-
+

nm_device_get_state ()

+
NMDeviceState
+nm_device_get_state (NMDevice *device);
+

Gets the current NMDevice state.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

device :

a NMDevice -

Returns :

the current device state

device

a NMDevice

 
+
+

Returns

+

the current device state

+

+
+
-

nm_device_get_state_reason ()

-
NMDeviceStateReason nm_device_get_state_reason          (NMDevice *device);
-

-Gets the reason for entering the current NMDevice state. -

-
+

nm_device_get_state_reason ()

+
NMDeviceStateReason
+nm_device_get_state_reason (NMDevice *device);
+

Gets the reason for entering the current NMDevice state.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

device :

a NMDevice -

Returns :

the reason for entering the current device state

device

a NMDevice

 
+
+

Returns

+

the reason for entering the current device state

+

+
+
-

nm_device_get_active_connection ()

-
NMActiveConnection * nm_device_get_active_connection    (NMDevice *device);
-

-Gets the NMActiveConnection object which owns this device during activation. -

-
+

nm_device_get_active_connection ()

+
NMActiveConnection *
+nm_device_get_active_connection (NMDevice *device);
+

Gets the NMActiveConnection object which owns this device during activation.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

device :

a NMDevice -

Returns :

the NMActiveConnection or NULL if the device is -not part of an active connection. [transfer none] -

device

a NMDevice

 
+
+

Returns

+

the NMActiveConnection or NULL if the device is +not part of an active connection.

+

[transfer none]

+
+
-

nm_device_get_available_connections ()

-
const GPtrArray *   nm_device_get_available_connections (NMDevice *device);
-

-Gets the NMRemoteConnections currently known to the daemon that could -be activated on device. -

-
+

nm_device_get_available_connections ()

+
const GPtrArray *
+nm_device_get_available_connections (NMDevice *device);
+

Gets the NMRemoteConnections currently known to the daemon that could +be activated on device +.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

device :

a NMDevice -

Returns :

the GPtrArray -containing NMRemoteConnections. This is the internal copy used by -the connection, and must not be modified. [element-type NMRemoteConnection] -

device

a NMDevice

 
+
+

Returns

+

the GPtrArray +containing NMRemoteConnections. This is the internal copy used by +the connection, and must not be modified.

+

[element-type NMRemoteConnection]

+
+
-

nm_device_get_physical_port_id ()

-
const char *        nm_device_get_physical_port_id      (NMDevice *device);
-

-Gets the physical port ID of the NMDevice. If non-NULL, this is +

nm_device_get_physical_port_id ()

+
const char *
+nm_device_get_physical_port_id (NMDevice *device);
+

Gets the physical port ID of the NMDevice. If non-NULL, this is an opaque string that can be used to recognize when seemingly-unrelated NMDevices are actually just different virtual -ports on a single physical port. (Eg, NPAR / SR-IOV.) -

-
+ports on a single physical port. (Eg, NPAR / SR-IOV.)

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

device :

a NMDevice -

Returns :

the physical port ID of the device, or NULL if the port -ID is unknown. This is the internal string used by the device and -must not be modified.

device

a NMDevice

 
+
+

Returns

+

the physical port ID of the device, or NULL if the port +ID is unknown. This is the internal string used by the device and +must not be modified.

+

+
+
-

nm_device_get_mtu ()

-
guint32             nm_device_get_mtu                   (NMDevice *device);
-

-Gets the MTU of the NMDevice. -

-
+

nm_device_get_mtu ()

+
guint32
+nm_device_get_mtu (NMDevice *device);
+

Gets the MTU of the NMDevice.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

device :

a NMDevice -

Returns :

the MTU of the device.

device

a NMDevice

 
+
+

Returns

+

the MTU of the device.

+

+
+
-

nm_device_is_software ()

-
gboolean            nm_device_is_software               (NMDevice *device);
-

-Whether the device is a software device. -

-
+

nm_device_is_software ()

+
gboolean
+nm_device_is_software (NMDevice *device);
+

Whether the device is a software device.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

device :

a NMDevice -

Returns :

-TRUE if device is a software device, FALSE if it is a hardware device.

device

a NMDevice

 
+
+

Returns

+

TRUE if device +is a software device, FALSE if it is a hardware device.

+

+
+
-

nm_device_get_product ()

-
const char *        nm_device_get_product               (NMDevice *device);
-

-Gets the product string of the NMDevice. -

-
+

nm_device_get_product ()

+
const char *
+nm_device_get_product (NMDevice *device);
+

Gets the product string of the NMDevice.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

device :

a NMDevice -

Returns :

the product name of the device. This is the internal string used by the -device, and must not be modified.

device

a NMDevice

 
+
+

Returns

+

the product name of the device. This is the internal string used by the +device, and must not be modified.

+

+
+
-

nm_device_get_vendor ()

-
const char *        nm_device_get_vendor                (NMDevice *device);
-

-Gets the vendor string of the NMDevice. -

-
+

nm_device_get_vendor ()

+
const char *
+nm_device_get_vendor (NMDevice *device);
+

Gets the vendor string of the NMDevice.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

device :

a NMDevice -

Returns :

the vendor name of the device. This is the internal string used by the -device, and must not be modified.

device

a NMDevice

 
+
+

Returns

+

the vendor name of the device. This is the internal string used by the +device, and must not be modified.

+

+
+
-

nm_device_get_description ()

-
const char *        nm_device_get_description           (NMDevice *device);
-

-Gets a description of device, based on its vendor and product names. -

-
+

nm_device_get_description ()

+
const char *
+nm_device_get_description (NMDevice *device);
+

Gets a description of device +, based on its vendor and product names.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

device :

an NMDevice -

Returns :

a description of device. If either the vendor or the -product name is unknown, this returns the interface name.

device

an NMDevice

 
+
+

Returns

+

a description of device +. If either the vendor or the +product name is unknown, this returns the interface name.

+

+
+
-

nm_device_disambiguate_names ()

-
char **             nm_device_disambiguate_names        (NMDevice **devices,
-                                                         int num_devices);
-

-Generates a list of short-ish unique presentation names for the -devices in devices. -

-
+

nm_device_disambiguate_names ()

+
char **
+nm_device_disambiguate_names (NMDevice **devices,
+                              int num_devices);
+

Generates a list of short-ish unique presentation names for the +devices in devices +.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + +

devices :

an array of NMDevice. [array length=num_devices] -

num_devices :

length of devices -

devices

an array of NMDevice.

[array length=num_devices]

Returns :

the device names. [transfer full][array zero-terminated=1] -

num_devices

length of devices +

 
+
+

Returns

+

the device names.

+

[transfer full][array zero-terminated=1]

+
+
-

nm_device_disconnect ()

-
gboolean            nm_device_disconnect                (NMDevice *device,
-                                                         GCancellable *cancellable,
-                                                         GError **error);
-

-Disconnects the device if currently connected, and prevents the device from +

nm_device_disconnect ()

+
gboolean
+nm_device_disconnect (NMDevice *device,
+                      GCancellable *cancellable,
+                      GError **error);
+

Disconnects the device if currently connected, and prevents the device from automatically connecting to networks until the next manual network connection -request. -

-
+request.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + + - - + + +

device :

a NMDevice -

cancellable :

a GCancellable, or NULL -

device

a NMDevice

 

error :

location for a GError, or NULL -

cancellable

a GCancellable, or NULL

 

Returns :

-TRUE on success, FALSE on error, in which case error will be set.

error

location for a GError, or NULL

 
+
+

Returns

+

TRUE on success, FALSE on error, in which case error +will be set.

+

+
+
-

nm_device_disconnect_async ()

-
void                nm_device_disconnect_async          (NMDevice *device,
-                                                         GCancellable *cancellable,
-                                                         GAsyncReadyCallback callback,
-                                                         gpointer user_data);
-

-Asynchronously begins disconnecting the device if currently connected, and +

nm_device_disconnect_async ()

+
void
+nm_device_disconnect_async (NMDevice *device,
+                            GCancellable *cancellable,
+                            GAsyncReadyCallback callback,
+                            gpointer user_data);
+

Asynchronously begins disconnecting the device if currently connected, and prevents the device from automatically connecting to networks until the next -manual network connection request. -

-
+manual network connection request.

+
+

Parameters

+
--+++ - - + + + - - + + + - - + + + - - + + +

device :

a NMDevice -

device

a NMDevice

 

cancellable :

a GCancellable, or NULL -

cancellable

a GCancellable, or NULL

 

callback :

callback to be called when the disconnect operation completes

callback

callback to be called when the disconnect operation completes

 

user_data :

caller-specific data passed to callback -

user_data

caller-specific data passed to callback +

 
+
-

nm_device_disconnect_finish ()

-
gboolean            nm_device_disconnect_finish         (NMDevice *device,
-                                                         GAsyncResult *result,
-                                                         GError **error);
-

-Gets the result of a call to nm_device_disconnect_async(). -

-
+

nm_device_disconnect_finish ()

+
gboolean
+nm_device_disconnect_finish (NMDevice *device,
+                             GAsyncResult *result,
+                             GError **error);
+

Gets the result of a call to nm_device_disconnect_async().

+
+

Parameters

+
--+++ - - - - - - + + + - - + + + - - + + +

device :

a NMDevice -

result :

the result passed to the GAsyncReadyCallback -

device

a NMDevice

 

error :

location for a GError, or NULL -

result

the result passed to the GAsyncReadyCallback

 

Returns :

-TRUE on success, FALSE on error, in which case error -will be set.

error

location for a GError, or NULL

 
+
+

Returns

+

TRUE on success, FALSE on error, in which case error +will be set.

+

+
+
-

nm_device_delete ()

-
gboolean            nm_device_delete                    (NMDevice *device,
-                                                         GCancellable *cancellable,
-                                                         GError **error);
-

-Deletes the software device. Hardware devices can't be deleted. -

-
+

nm_device_delete ()

+
gboolean
+nm_device_delete (NMDevice *device,
+                  GCancellable *cancellable,
+                  GError **error);
+

Deletes the software device. Hardware devices can't be deleted.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + + - - + + +

device :

a NMDevice -

cancellable :

a GCancellable, or NULL -

device

a NMDevice

 

error :

location for a GError, or NULL -

cancellable

a GCancellable, or NULL

 

Returns :

-TRUE on success, FALSE on error, in which case error -will be set.

error

location for a GError, or NULL

 
+
+

Returns

+

TRUE on success, FALSE on error, in which case error +will be set.

+

+
+
-

nm_device_delete_async ()

-
void                nm_device_delete_async              (NMDevice *device,
-                                                         GCancellable *cancellable,
-                                                         GAsyncReadyCallback callback,
-                                                         gpointer user_data);
-

-Asynchronously begins deleteing the software device. Hardware devices can't -be deleted. -

-
+

nm_device_delete_async ()

+
void
+nm_device_delete_async (NMDevice *device,
+                        GCancellable *cancellable,
+                        GAsyncReadyCallback callback,
+                        gpointer user_data);
+

Asynchronously begins deleteing the software device. Hardware devices can't +be deleted.

+
+

Parameters

+
--+++ - - + + + - - + + + - - + + + - - + + +

device :

a NMDevice -

device

a NMDevice

 

cancellable :

a GCancellable, or NULL -

cancellable

a GCancellable, or NULL

 

callback :

callback to be called when delete operation completes

callback

callback to be called when delete operation completes

 

user_data :

caller-specific data passed to callback -

user_data

caller-specific data passed to callback +

 
+
-

nm_device_delete_finish ()

-
gboolean            nm_device_delete_finish             (NMDevice *device,
-                                                         GAsyncResult *result,
-                                                         GError **error);
-

-Gets the result of a call to nm_device_delete_async(). -

-
+

nm_device_delete_finish ()

+
gboolean
+nm_device_delete_finish (NMDevice *device,
+                         GAsyncResult *result,
+                         GError **error);
+

Gets the result of a call to nm_device_delete_async().

+
+

Parameters

+
--+++ - - - - - - + + + - - + + + - - + + +

device :

a NMDevice -

result :

the result passed to the GAsyncReadyCallback -

device

a NMDevice

 

error :

location for a GError, or NULL -

result

the result passed to the GAsyncReadyCallback

 

Returns :

-TRUE on success, FALSE on error, in which case error -will be set.

error

location for a GError, or NULL

 
+
+

Returns

+

TRUE on success, FALSE on error, in which case error +will be set.

+

+
+
-

nm_device_filter_connections ()

-
GPtrArray *         nm_device_filter_connections        (NMDevice *device,
-                                                         const GPtrArray *connections);
-

-Filters a given array of connections for a given NMDevice object and returns +

nm_device_filter_connections ()

+
GPtrArray *
+nm_device_filter_connections (NMDevice *device,
+                              const GPtrArray *connections);
+

Filters a given array of connections for a given NMDevice object and returns connections which may be activated with the device. For example if device + is a Wi-Fi device that supports only WEP encryption, the returned array will -contain any Wi-Fi connections in connections that allow connection to +contain any Wi-Fi connections in connections + that allow connection to unencrypted or WEP-enabled SSIDs. The returned array will not contain Ethernet, Bluetooth, Wi-Fi WPA connections, or any other connection that is incompatible with the device. To get the full list of connections see -nm_client_get_connections(). -

-
+nm_client_get_connections().

+
+

Parameters

+
--+++ - - - - - - + + + - - + + +

device :

an NMDevice to filter connections for

connections :

an array of NMConnections to filter. [element-type NMConnection] -

device

an NMDevice to filter connections for

 

Returns :

an array of -NMConnections that could be activated with the given device. The array -should be freed with g_ptr_array_unref() when it is no longer required. [transfer container][element-type NMConnection] -

connections

an array of NMConnections to filter.

[element-type NMConnection]
+
+

Returns

+

an array of +NMConnections that could be activated with the given device +. The array +should be freed with g_ptr_array_unref() when it is no longer required.

+

[transfer container][element-type NMConnection]

+
+
-

nm_device_connection_valid ()

-
gboolean            nm_device_connection_valid          (NMDevice *device,
-                                                         NMConnection *connection);
-

-Validates a given connection for a given NMDevice object and returns +

nm_device_connection_valid ()

+
gboolean
+nm_device_connection_valid (NMDevice *device,
+                            NMConnection *connection);
+

Validates a given connection for a given NMDevice object and returns whether the connection may be activated with the device. For example if -device is a Wi-Fi device that supports only WEP encryption, the connection +device + is a Wi-Fi device that supports only WEP encryption, the connection will only be valid if it is a Wi-Fi connection which describes a WEP or open network, and will not be valid if it describes a WPA network, or if it is an Ethernet, Bluetooth, WWAN, etc connection that is incompatible with the -device. -

-
+device.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + +

device :

an NMDevice to validate connection against

connection :

an NMConnection to validate against device -

device

an NMDevice to validate connection +against

 

Returns :

-TRUE if the connection may be activated with this device, FALSE -if is incompatible with the device's capabilities and characteristics.

connection

an NMConnection to validate against device +

 
+
+

Returns

+

TRUE if the connection may be activated with this device, FALSE +if is incompatible with the device's capabilities and characteristics.

+

+
+
-

nm_device_connection_compatible ()

-
gboolean            nm_device_connection_compatible     (NMDevice *device,
-                                                         NMConnection *connection,
-                                                         GError **error);
-

-Validates a given connection for a given NMDevice object and returns +

nm_device_connection_compatible ()

+
gboolean
+nm_device_connection_compatible (NMDevice *device,
+                                 NMConnection *connection,
+                                 GError **error);
+

Validates a given connection for a given NMDevice object and returns whether the connection may be activated with the device. For example if -device is a Wi-Fi device that supports only WEP encryption, the connection +device + is a Wi-Fi device that supports only WEP encryption, the connection will only be valid if it is a Wi-Fi connection which describes a WEP or open network, and will not be valid if it describes a WPA network, or if it is an Ethernet, Bluetooth, WWAN, etc connection that is incompatible with the -device. -

-

-This function does the same as nm_device_connection_valid(), i.e. checking +device.

+

This function does the same as nm_device_connection_valid(), i.e. checking compatibility of the given device and connection. But, in addition, it sets -GError when FALSE is returned. -

-
+GError when FALSE is returned.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + + - - + + +

device :

an NMDevice to validate connection against

connection :

an NMConnection to validate against device -

device

an NMDevice to validate connection +against

 

error :

return location for a GError, or NULL -

connection

an NMConnection to validate against device +

 

Returns :

-TRUE if the connection may be activated with this device, FALSE -if is incompatible with the device's capabilities and characteristics.

error

return location for a GError, or NULL

 
+
+

Returns

+

TRUE if the connection may be activated with this device, FALSE +if is incompatible with the device's capabilities and characteristics.

+

+
+
-

nm_device_get_setting_type ()

-
GType               nm_device_get_setting_type          (NMDevice *device);
-

-Gets the (primary) NMSetting subtype associated with connections -that can be used on device. -

-
+

nm_device_get_setting_type ()

+
GType
+nm_device_get_setting_type (NMDevice *device);
+

Gets the (primary) NMSetting subtype associated with connections +that can be used on device +.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

device :

an NMDevice -

Returns :

-device's associated NMSetting type

device

an NMDevice

 
+
+

Returns

+

device +'s associated NMSetting type

+

+
+
-

Property Details

+

Types and Values

-

The "active-connection" property

-
  "active-connection"        NMActiveConnection*   : Read
+

NM_DEVICE_DEVICE_TYPE

+
#define NM_DEVICE_DEVICE_TYPE "device-type"
+

-The NMActiveConnection object that "owns" this device during activation.


-

The "autoconnect" property

-
  "autoconnect"              gboolean              : Read / Write
+

NM_DEVICE_UDI

+
#define NM_DEVICE_UDI "udi"
+

-Whether the device can auto-activate a connection.

-

Default value: TRUE


-

The "available-connections" property

-
  "available-connections"    GPtrArray*            : Read
+

NM_DEVICE_INTERFACE

+
#define NM_DEVICE_INTERFACE "interface"
+

-The available connections of the device

+
+
+
+

NM_DEVICE_IP_INTERFACE

+
#define NM_DEVICE_IP_INTERFACE "ip-interface"
+

-Element-type: NMRemoteConnection


-

The "capabilities" property

-
  "capabilities"             NMDeviceCapabilities  : Read
+

NM_DEVICE_DRIVER

+
#define NM_DEVICE_DRIVER "driver"
+

-The capabilities of the device.


-

The "device-type" property

-
  "device-type"              NMDeviceType          : Read
+

NM_DEVICE_DRIVER_VERSION

+
#define NM_DEVICE_DRIVER_VERSION "driver-version"
+

-The numeric type of the device.

-

Default value: NM_DEVICE_TYPE_UNKNOWN


-

The "dhcp4-config" property

-
  "dhcp4-config"             NMDhcpConfig*         : Read
+

NM_DEVICE_FIRMWARE_VERSION

+
#define NM_DEVICE_FIRMWARE_VERSION "firmware-version"
+

-The IPv4 NMDhcpConfig of the device.


-

The "dhcp6-config" property

-
  "dhcp6-config"             NMDhcpConfig*         : Read
+

NM_DEVICE_CAPABILITIES

+
#define NM_DEVICE_CAPABILITIES "capabilities"
+

-The IPv6 NMDhcpConfig of the device.


-

The "driver" property

-
  "driver"                   gchar*                : Read
+

NM_DEVICE_MANAGED

+
#define NM_DEVICE_MANAGED "managed"
+

-The driver of the device.

-

Default value: NULL


-

The "driver-version" property

-
  "driver-version"           gchar*                : Read
+

NM_DEVICE_AUTOCONNECT

+
#define NM_DEVICE_AUTOCONNECT "autoconnect"
+

-The version of the device driver.

-

Default value: NULL


-

The "firmware-missing" property

-
  "firmware-missing"         gboolean              : Read
+

NM_DEVICE_FIRMWARE_MISSING

+
#define NM_DEVICE_FIRMWARE_MISSING "firmware-missing"
+

-When TRUE indicates the device is likely missing firmware required -for its operation.

-

Default value: FALSE


-

The "firmware-version" property

-
  "firmware-version"         gchar*                : Read
+

NM_DEVICE_IP4_CONFIG

+
#define NM_DEVICE_IP4_CONFIG "ip4-config"
+

-The firmware version of the device.

-

Default value: NULL


-

The "interface" property

-
  "interface"                gchar*                : Read
+

NM_DEVICE_DHCP4_CONFIG

+
#define NM_DEVICE_DHCP4_CONFIG "dhcp4-config"
+

-The interface of the device.

-

Default value: NULL


-

The "ip-interface" property

-
  "ip-interface"             gchar*                : Read
+

NM_DEVICE_IP6_CONFIG

+
#define NM_DEVICE_IP6_CONFIG "ip6-config"
+

-The IP interface of the device which should be used for all IP-related -operations like addressing and routing.

-

Default value: NULL


-

The "ip4-config" property

-
  "ip4-config"               NMIPConfig*           : Read
+

NM_DEVICE_DHCP6_CONFIG

+
#define NM_DEVICE_DHCP6_CONFIG "dhcp6-config"
+

-The NMIP4Config of the device.


-

The "ip6-config" property

-
  "ip6-config"               NMIPConfig*           : Read
+

NM_DEVICE_STATE

+
#define NM_DEVICE_STATE "state"
+

-The IPv6 NMIPConfig of the device.


-

The "managed" property

-
  "managed"                  gboolean              : Read
+

NM_DEVICE_STATE_REASON

+
#define NM_DEVICE_STATE_REASON "state-reason"
+

-Whether the device is managed by NetworkManager.

-

Default value: FALSE


-

The "mtu" property

-
  "mtu"                      guint                 : Read
+

NM_DEVICE_ACTIVE_CONNECTION

+
#define NM_DEVICE_ACTIVE_CONNECTION "active-connection"
+

-The MTU of the device.

-

Default value: 1500


-

The "physical-port-id" property

-
  "physical-port-id"         gchar*                : Read
+

NM_DEVICE_AVAILABLE_CONNECTIONS

+
#define NM_DEVICE_AVAILABLE_CONNECTIONS "available-connections"
+

-The physical port ID of the device. (See -nm_device_get_physical_port_id().)

-

Default value: NULL


-

The "product" property

-
  "product"                  gchar*                : Read
+

NM_DEVICE_VENDOR

+
#define NM_DEVICE_VENDOR "vendor"
+

-The product string of the device.

-

Default value: NULL


-

The "state" property

-
  "state"                    NMDeviceState         : Read
+

NM_DEVICE_PRODUCT

+
#define NM_DEVICE_PRODUCT "product"
+

-The state of the device.

-

Default value: NM_DEVICE_STATE_UNKNOWN


-

The "state-reason" property

-
  "state-reason"             guint                 : Read
+

NM_DEVICE_PHYSICAL_PORT_ID

+
#define NM_DEVICE_PHYSICAL_PORT_ID "physical-port-id"
+

-The reason for the device state.

-

Default value: 0


-

The "udi" property

-
  "udi"                      gchar*                : Read
+

NM_DEVICE_MTU

+
#define NM_DEVICE_MTU "mtu"
+

-An operating-system specific device hardware identifier; this is not -unique to a specific hardware device across reboots or hotplugs. It -is an opaque string which for some device types (Bluetooth, Modem) -contains an identifier provided by the underlying hardware service daemon -such as Bluez or ModemManager, and clients can use this property to -request more information about the device from those services.

+
+
+
+

Property Details

+
+

The “active-connection” property

+
  “active-connection”        NMActiveConnection *
+

+

Flags: Read

+
+
+
+

The “autoconnect” property

+
  “autoconnect”              gboolean
+

+

Flags: Read / Write

+

Default value: TRUE

+
+
+
+

The “available-connections” property

+
  “available-connections”    GPtrArray *
+

+

Flags: Read

+
+
+
+

The “capabilities” property

+
  “capabilities”             NMDeviceCapabilities
+

+

Flags: Read

+
+
+
+

The “device-type” property

+
  “device-type”              NMDeviceType
+

+

Flags: Read

+

Default value: NM_DEVICE_TYPE_UNKNOWN

+
+
+
+

The “dhcp4-config” property

+
  “dhcp4-config”             NMDhcpConfig *
+

+

Flags: Read

+
+
+
+

The “dhcp6-config” property

+
  “dhcp6-config”             NMDhcpConfig *
+

+

Flags: Read

+
+
+
+

The “driver” property

+
  “driver”                   gchar *
+

+

Flags: Read

Default value: NULL


-

The "vendor" property

-
  "vendor"                   gchar*                : Read
-

-The vendor string of the device. -

+

The “driver-version” property

+
  “driver-version”           gchar *
+

+

Flags: Read

+

Default value: NULL

+
+
+
+

The “firmware-missing” property

+
  “firmware-missing”         gboolean
+

+

Flags: Read

+

Default value: FALSE

+
+
+
+

The “firmware-version” property

+
  “firmware-version”         gchar *
+

+

Flags: Read

+

Default value: NULL

+
+
+
+

The “interface” property

+
  “interface”                gchar *
+

+

Flags: Read

+

Default value: NULL

+
+
+
+

The “ip-interface” property

+
  “ip-interface”             gchar *
+

+

Flags: Read

+

Default value: NULL

+
+
+
+

The “ip4-config” property

+
  “ip4-config”               NMIPConfig *
+

+

Flags: Read

+
+
+
+

The “ip6-config” property

+
  “ip6-config”               NMIPConfig *
+

+

Flags: Read

+
+
+
+

The “managed” property

+
  “managed”                  gboolean
+

+

Flags: Read

+

Default value: FALSE

+
+
+
+

The “mtu” property

+
  “mtu”                      guint
+

+

Flags: Read

+

Default value: 1500

+
+
+
+

The “physical-port-id” property

+
  “physical-port-id”         gchar *
+

+

Flags: Read

+

Default value: NULL

+
+
+
+

The “product” property

+
  “product”                  gchar *
+

+

Flags: Read

+

Default value: NULL

+
+
+
+

The “state” property

+
  “state”                    NMDeviceState
+

+

Flags: Read

+

Default value: NM_DEVICE_STATE_UNKNOWN

+
+
+
+

The “state-reason” property

+
  “state-reason”             guint
+

+

Flags: Read

+

Default value: 0

+
+
+
+

The “udi” property

+
  “udi”                      gchar *
+

+

Flags: Read

+

Default value: NULL

+
+
+
+

The “vendor” property

+
  “vendor”                   gchar *
+

+

Flags: Read

Default value: NULL

Signal Details

-

The "state-changed" signal

-
void                user_function                      (NMDevice *device,
-                                                        guint     new_state,
-                                                        guint     old_state,
-                                                        guint     reason,
-                                                        gpointer  user_data)      : Run First
-

-Notifies the state change of a NMDevice. -

-
---- - - - - - - - - - - - - - - - - - - - - - - -

device :

the device object that received the signal

new_state :

the new state of the device

old_state :

the previous state of the device

reason :

the reason describing the state change

user_data :

user data set when the signal handler was connected.
+

The “state-changed” signal

+
void
+user_function (NMDevice *device,
+               guint     new_state,
+               guint     old_state,
+               guint     reason,
+               gpointer  user_data)
+

Flags: Run First

+ Generated by GTK-Doc V1.21 \ No newline at end of file diff --git a/docs/libnm/html/NMDeviceAdsl.html b/docs/libnm/html/NMDeviceAdsl.html index e983c287..168d4ad8 100644 --- a/docs/libnm/html/NMDeviceAdsl.html +++ b/docs/libnm/html/NMDeviceAdsl.html @@ -2,36 +2,28 @@ -NMDeviceAdsl +libnm Reference Manual: NMDeviceAdsl - + - - - - - - - - - - + + + + + + +
@@ -39,35 +31,59 @@

NMDeviceAdsl

NMDeviceAdsl

- +
-
-

Synopsis

-
#define             NM_DEVICE_ADSL_CARRIER
-struct              NMDeviceAdsl;
-                    NMDeviceAdslClass;
-gboolean            nm_device_adsl_get_carrier          (NMDeviceAdsl *device);
-
+
+

Functions

+
++++ + + + + +
+gboolean + +nm_device_adsl_get_carrier () +
-

Object Hierarchy

-
-  GObject
-   +----NMObject
-         +----NMDevice
-               +----NMDeviceAdsl
-
+

Properties

+
+++++ + + + + + +
gbooleancarrierRead
-

Implemented Interfaces

-

-NMDeviceAdsl implements - GInitable and GAsyncInitable.

+

Types and Values

+
++++ + + + + +
#defineNM_DEVICE_ADSL_CARRIER
-

Properties

-
-  "carrier"                  gboolean              : Read
+

Object Hierarchy

+
    GObject
+    ╰── NMObject
+        ╰── NMDevice
+            ╰── NMDeviceAdsl
 
@@ -76,72 +92,57 @@ NMDeviceAdsl implements

-

Details

+

Functions

-

NM_DEVICE_ADSL_CARRIER

-
#define NM_DEVICE_ADSL_CARRIER "carrier"
-
-

-

+

nm_device_adsl_get_carrier ()

+
gboolean
+nm_device_adsl_get_carrier (NMDeviceAdsl *device);
+

Whether the device has carrier.

+
+

Parameters

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

device

a NMDeviceAdsl

 
-
-
-

struct NMDeviceAdsl

-
struct NMDeviceAdsl;
-

-

+
+

Returns

+

TRUE if the device has carrier

+

-
-
-

NMDeviceAdslClass

-
typedef struct {
-	NMDeviceClass parent;
-} NMDeviceAdslClass;
-
-

-

-
+
+
+

Types and Values

-

nm_device_adsl_get_carrier ()

-
gboolean            nm_device_adsl_get_carrier          (NMDeviceAdsl *device);
+

NM_DEVICE_ADSL_CARRIER

+
#define NM_DEVICE_ADSL_CARRIER "carrier"
+

-Whether the device has carrier.

-
---- - - - - - - - - - - -

device :

a NMDeviceAdsl -

Returns :

-TRUE if the device has carrier

Property Details

-

The "carrier" property

-
  "carrier"                  gboolean              : Read
-

-Whether the device has carrier. -

+

The “carrier” property

+
  “carrier”                  gboolean
+

+

Flags: Read

Default value: FALSE

+ Generated by GTK-Doc V1.21
\ No newline at end of file diff --git a/docs/libnm/html/NMDeviceBond.html b/docs/libnm/html/NMDeviceBond.html index 7213a45a..03023581 100644 --- a/docs/libnm/html/NMDeviceBond.html +++ b/docs/libnm/html/NMDeviceBond.html @@ -2,36 +2,28 @@ -NMDeviceBond +libnm Reference Manual: NMDeviceBond - + - - - - - - - - - - + + + + + + +
@@ -39,41 +31,99 @@

NMDeviceBond

NMDeviceBond

- +
-
-

Synopsis

-
#define             NM_DEVICE_BOND_HW_ADDRESS
-#define             NM_DEVICE_BOND_CARRIER
-#define             NM_DEVICE_BOND_SLAVES
-struct              NMDeviceBond;
-                    NMDeviceBondClass;
-const char *        nm_device_bond_get_hw_address       (NMDeviceBond *device);
-gboolean            nm_device_bond_get_carrier          (NMDeviceBond *device);
-const GPtrArray *   nm_device_bond_get_slaves           (NMDeviceBond *device);
-
+
+

Functions

+
++++ + + + + + + + + + + + + + + +
const char * + +nm_device_bond_get_hw_address () +
+gboolean + +nm_device_bond_get_carrier () +
const GPtrArray * + +nm_device_bond_get_slaves () +
-

Object Hierarchy

-
-  GObject
-   +----NMObject
-         +----NMDevice
-               +----NMDeviceBond
-
+

Properties

+
+++++ + + + + + + + + + + + + + + + + + +
gbooleancarrierRead
+gchar *hw-addressRead
+GPtrArray *slavesRead
-

Implemented Interfaces

-

-NMDeviceBond implements - GInitable and GAsyncInitable.

+

Types and Values

+
++++ + + + + + + + + + + + + + + +
#defineNM_DEVICE_BOND_HW_ADDRESS
#defineNM_DEVICE_BOND_CARRIER
#defineNM_DEVICE_BOND_SLAVES
-

Properties

-
-  "carrier"                  gboolean              : Read
-  "hw-address"               gchar*                : Read
-  "slaves"                   GPtrArray*            : Read
+

Object Hierarchy

+
    GObject
+    ╰── NMObject
+        ╰── NMDevice
+            ╰── NMDeviceBond
 
@@ -82,162 +132,147 @@ NMDeviceBond implements

-

Details

+

Functions

-

NM_DEVICE_BOND_HW_ADDRESS

-
#define NM_DEVICE_BOND_HW_ADDRESS  "hw-address"
-
-

-

+

nm_device_bond_get_hw_address ()

+
const char *
+nm_device_bond_get_hw_address (NMDeviceBond *device);
+

Gets the hardware (MAC) address of the NMDeviceBond

+
+

Parameters

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

device

a NMDeviceBond

 
-
-
-

NM_DEVICE_BOND_CARRIER

-
#define NM_DEVICE_BOND_CARRIER     "carrier"
-
-

-

+
+

Returns

+

the hardware address. This is the internal string used by the +device, and must not be modified.

+

-
-
-

NM_DEVICE_BOND_SLAVES

-
#define NM_DEVICE_BOND_SLAVES      "slaves"
-
-

-


-

struct NMDeviceBond

-
struct NMDeviceBond;
-

-

+

nm_device_bond_get_carrier ()

+
gboolean
+nm_device_bond_get_carrier (NMDeviceBond *device);
+

Whether the device has carrier.

+
+

Parameters

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

device

a NMDeviceBond

 
+
+
+

Returns

+

TRUE if the device has carrier

+

-
-
-

NMDeviceBondClass

-
typedef struct {
-	NMDeviceClass parent;
-} NMDeviceBondClass;
-
-

-


-

nm_device_bond_get_hw_address ()

-
const char *        nm_device_bond_get_hw_address       (NMDeviceBond *device);
-

-Gets the hardware (MAC) address of the NMDeviceBond -

-
+

nm_device_bond_get_slaves ()

+
const GPtrArray *
+nm_device_bond_get_slaves (NMDeviceBond *device);
+

Gets the devices currently slaved to device +.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

device :

a NMDeviceBond -

Returns :

the hardware address. This is the internal string used by the -device, and must not be modified.

device

a NMDeviceBond

 
+
+

Returns

+

the GPtrArray containing +NMDevices that are slaves of device +. This is the internal +copy used by the device, and must not be modified.

+

[element-type NMDevice]

+
+
+
+
+

Types and Values

+
+

NM_DEVICE_BOND_HW_ADDRESS

+
#define NM_DEVICE_BOND_HW_ADDRESS  "hw-address"
+
+

+

+

-

nm_device_bond_get_carrier ()

-
gboolean            nm_device_bond_get_carrier          (NMDeviceBond *device);
+

NM_DEVICE_BOND_CARRIER

+
#define NM_DEVICE_BOND_CARRIER     "carrier"
+

-Whether the device has carrier.

-
---- - - - - - - - - - - -

device :

a NMDeviceBond -

Returns :

-TRUE if the device has carrier

-

nm_device_bond_get_slaves ()

-
const GPtrArray *   nm_device_bond_get_slaves           (NMDeviceBond *device);
+

NM_DEVICE_BOND_SLAVES

+
#define NM_DEVICE_BOND_SLAVES      "slaves"
+

-Gets the devices currently slaved to device.

-
---- - - - - - - - - - - -

device :

a NMDeviceBond -

Returns :

the GPtrArray containing -NMDevices that are slaves of device. This is the internal -copy used by the device, and must not be modified. [element-type NMDevice] -

Property Details

-

The "carrier" property

-
  "carrier"                  gboolean              : Read
-

-Whether the device has carrier. -

+

The “carrier” property

+
  “carrier”                  gboolean
+

+

Flags: Read

Default value: FALSE


-

The "hw-address" property

-
  "hw-address"               gchar*                : Read
-

-The hardware (MAC) address of the device. -

+

The “hw-address” property

+
  “hw-address”               gchar *
+

+

Flags: Read

Default value: NULL


-

The "slaves" property

-
  "slaves"                   GPtrArray*            : Read
-

-The devices slaved to the bond device. -

-

-Element-type: NMDevice -

+

The “slaves” property

+
  “slaves”                   GPtrArray *
+

+

Flags: Read

+ Generated by GTK-Doc V1.21
\ No newline at end of file diff --git a/docs/libnm/html/NMDeviceBridge.html b/docs/libnm/html/NMDeviceBridge.html index 14ed6a10..6fd332de 100644 --- a/docs/libnm/html/NMDeviceBridge.html +++ b/docs/libnm/html/NMDeviceBridge.html @@ -2,36 +2,28 @@ -NMDeviceBridge +libnm Reference Manual: NMDeviceBridge - + - - - - - - - - - - + + + + + + +
@@ -39,41 +31,99 @@

NMDeviceBridge

NMDeviceBridge

- +
-
-

Synopsis

-
#define             NM_DEVICE_BRIDGE_HW_ADDRESS
-#define             NM_DEVICE_BRIDGE_CARRIER
-#define             NM_DEVICE_BRIDGE_SLAVES
-struct              NMDeviceBridge;
-                    NMDeviceBridgeClass;
-const char *        nm_device_bridge_get_hw_address     (NMDeviceBridge *device);
-gboolean            nm_device_bridge_get_carrier        (NMDeviceBridge *device);
-const GPtrArray *   nm_device_bridge_get_slaves         (NMDeviceBridge *device);
-
+
+

Functions

+
++++ + + + + + + + + + + + + + + +
const char * + +nm_device_bridge_get_hw_address () +
+gboolean + +nm_device_bridge_get_carrier () +
const GPtrArray * + +nm_device_bridge_get_slaves () +
-

Object Hierarchy

-
-  GObject
-   +----NMObject
-         +----NMDevice
-               +----NMDeviceBridge
-
+

Properties

+
+++++ + + + + + + + + + + + + + + + + + +
gbooleancarrierRead
+gchar *hw-addressRead
+GPtrArray *slavesRead
-

Implemented Interfaces

-

-NMDeviceBridge implements - GInitable and GAsyncInitable.

+

Types and Values

+
++++ + + + + + + + + + + + + + + +
#defineNM_DEVICE_BRIDGE_HW_ADDRESS
#defineNM_DEVICE_BRIDGE_CARRIER
#defineNM_DEVICE_BRIDGE_SLAVES
-

Properties

-
-  "carrier"                  gboolean              : Read
-  "hw-address"               gchar*                : Read
-  "slaves"                   GPtrArray*            : Read
+

Object Hierarchy

+
    GObject
+    ╰── NMObject
+        ╰── NMDevice
+            ╰── NMDeviceBridge
 
@@ -82,162 +132,147 @@ NMDeviceBridge implements

-

Details

+

Functions

-

NM_DEVICE_BRIDGE_HW_ADDRESS

-
#define NM_DEVICE_BRIDGE_HW_ADDRESS  "hw-address"
-
-

-

+

nm_device_bridge_get_hw_address ()

+
const char *
+nm_device_bridge_get_hw_address (NMDeviceBridge *device);
+

Gets the hardware (MAC) address of the NMDeviceBridge

+
+

Parameters

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

device

a NMDeviceBridge

 
-
-
-

NM_DEVICE_BRIDGE_CARRIER

-
#define NM_DEVICE_BRIDGE_CARRIER     "carrier"
-
-

-

+
+

Returns

+

the hardware address. This is the internal string used by the +device, and must not be modified.

+

-
-
-

NM_DEVICE_BRIDGE_SLAVES

-
#define NM_DEVICE_BRIDGE_SLAVES      "slaves"
-
-

-


-

struct NMDeviceBridge

-
struct NMDeviceBridge;
-

-

+

nm_device_bridge_get_carrier ()

+
gboolean
+nm_device_bridge_get_carrier (NMDeviceBridge *device);
+

Whether the device has carrier.

+
+

Parameters

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

device

a NMDeviceBridge

 
+
+
+

Returns

+

TRUE if the device has carrier

+

-
-
-

NMDeviceBridgeClass

-
typedef struct {
-	NMDeviceClass parent;
-} NMDeviceBridgeClass;
-
-

-


-

nm_device_bridge_get_hw_address ()

-
const char *        nm_device_bridge_get_hw_address     (NMDeviceBridge *device);
-

-Gets the hardware (MAC) address of the NMDeviceBridge -

-
+

nm_device_bridge_get_slaves ()

+
const GPtrArray *
+nm_device_bridge_get_slaves (NMDeviceBridge *device);
+

Gets the devices currently slaved to device +.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

device :

a NMDeviceBridge -

Returns :

the hardware address. This is the internal string used by the -device, and must not be modified.

device

a NMDeviceBridge

 
+
+

Returns

+

the GPtrArray containing +NMDevices that are slaves of device +. This is the internal +copy used by the device, and must not be modified.

+

[element-type NMDevice]

+
+
+
+
+

Types and Values

+
+

NM_DEVICE_BRIDGE_HW_ADDRESS

+
#define NM_DEVICE_BRIDGE_HW_ADDRESS  "hw-address"
+
+

+

+

-

nm_device_bridge_get_carrier ()

-
gboolean            nm_device_bridge_get_carrier        (NMDeviceBridge *device);
+

NM_DEVICE_BRIDGE_CARRIER

+
#define NM_DEVICE_BRIDGE_CARRIER     "carrier"
+

-Whether the device has carrier.

-
---- - - - - - - - - - - -

device :

a NMDeviceBridge -

Returns :

-TRUE if the device has carrier

-

nm_device_bridge_get_slaves ()

-
const GPtrArray *   nm_device_bridge_get_slaves         (NMDeviceBridge *device);
+

NM_DEVICE_BRIDGE_SLAVES

+
#define NM_DEVICE_BRIDGE_SLAVES      "slaves"
+

-Gets the devices currently slaved to device.

-
---- - - - - - - - - - - -

device :

a NMDeviceBridge -

Returns :

the GPtrArray containing -NMDevices that are slaves of device. This is the internal -copy used by the device, and must not be modified. [element-type NMDevice] -

Property Details

-

The "carrier" property

-
  "carrier"                  gboolean              : Read
-

-Whether the device has carrier. -

+

The “carrier” property

+
  “carrier”                  gboolean
+

+

Flags: Read

Default value: FALSE


-

The "hw-address" property

-
  "hw-address"               gchar*                : Read
-

-The hardware (MAC) address of the device. -

+

The “hw-address” property

+
  “hw-address”               gchar *
+

+

Flags: Read

Default value: NULL


-

The "slaves" property

-
  "slaves"                   GPtrArray*            : Read
-

-The devices slaved to the bridge device. -

-

-Element-type: NMDevice -

+

The “slaves” property

+
  “slaves”                   GPtrArray *
+

+

Flags: Read

+ Generated by GTK-Doc V1.21
\ No newline at end of file diff --git a/docs/libnm/html/NMDeviceBt.html b/docs/libnm/html/NMDeviceBt.html index d074d0bf..8aad8df8 100644 --- a/docs/libnm/html/NMDeviceBt.html +++ b/docs/libnm/html/NMDeviceBt.html @@ -2,36 +2,28 @@ -NMDeviceBt +libnm Reference Manual: NMDeviceBt - + - - - - - - - - - - + + + + + + +
@@ -39,41 +31,99 @@

NMDeviceBt

NMDeviceBt

- +
-
-

Synopsis

-
#define             NM_DEVICE_BT_HW_ADDRESS
-#define             NM_DEVICE_BT_NAME
-#define             NM_DEVICE_BT_CAPABILITIES
-struct              NMDeviceBt;
-                    NMDeviceBtClass;
-const char *        nm_device_bt_get_hw_address         (NMDeviceBt *device);
-const char *        nm_device_bt_get_name               (NMDeviceBt *device);
-NMBluetoothCapabilities nm_device_bt_get_capabilities   (NMDeviceBt *device);
-
+
+

Functions

+
++++ + + + + + + + + + + + + + + +
const char * + +nm_device_bt_get_hw_address () +
const char * + +nm_device_bt_get_name () +
+NMBluetoothCapabilities + +nm_device_bt_get_capabilities () +
-

Object Hierarchy

-
-  GObject
-   +----NMObject
-         +----NMDevice
-               +----NMDeviceBt
-
+

Properties

+
+++++ + + + + + + + + + + + + + + + + + +
NMBluetoothCapabilitiesbt-capabilitiesRead
+gchar *hw-addressRead
+gchar *nameRead
-

Implemented Interfaces

-

-NMDeviceBt implements - GInitable and GAsyncInitable.

+

Types and Values

+
++++ + + + + + + + + + + + + + + +
#defineNM_DEVICE_BT_HW_ADDRESS
#defineNM_DEVICE_BT_NAME
#defineNM_DEVICE_BT_CAPABILITIES
-

Properties

-
-  "bt-capabilities"          NMBluetoothCapabilities  : Read
-  "hw-address"               gchar*                : Read
-  "name"                     gchar*                : Read
+

Object Hierarchy

+
    GObject
+    ╰── NMObject
+        ╰── NMDevice
+            ╰── NMDeviceBt
 
@@ -82,156 +132,143 @@ NMDeviceBt implements

-

Details

+

Functions

-

NM_DEVICE_BT_HW_ADDRESS

-
#define NM_DEVICE_BT_HW_ADDRESS   "hw-address"
-
-

-

+

nm_device_bt_get_hw_address ()

+
const char *
+nm_device_bt_get_hw_address (NMDeviceBt *device);
+

Gets the hardware (MAC) address of the NMDeviceBt

+
+

Parameters

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

device

a NMDeviceBt

 
-
-
-

NM_DEVICE_BT_NAME

-
#define NM_DEVICE_BT_NAME         "name"
-
-

-

+
+

Returns

+

the hardware address. This is the internal string used by the +device, and must not be modified.

+

-
-
-

NM_DEVICE_BT_CAPABILITIES

-
#define NM_DEVICE_BT_CAPABILITIES "bt-capabilities"
-
-

-


-

struct NMDeviceBt

-
struct NMDeviceBt;
-

-

+

nm_device_bt_get_name ()

+
const char *
+nm_device_bt_get_name (NMDeviceBt *device);
+

Gets the name of the NMDeviceBt.

+
+

Parameters

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

device

a NMDeviceBt

 
+
+
+

Returns

+

the name of the device

+

-
-
-

NMDeviceBtClass

-
typedef struct {
-	NMDeviceClass parent;
-} NMDeviceBtClass;
-
-

-


-

nm_device_bt_get_hw_address ()

-
const char *        nm_device_bt_get_hw_address         (NMDeviceBt *device);
-

-Gets the hardware (MAC) address of the NMDeviceBt -

-
+

nm_device_bt_get_capabilities ()

+
NMBluetoothCapabilities
+nm_device_bt_get_capabilities (NMDeviceBt *device);
+

Returns the Bluetooth device's usable capabilities.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

device :

a NMDeviceBt -

Returns :

the hardware address. This is the internal string used by the -device, and must not be modified.

device

a NMDeviceBt

 
+
+

Returns

+

a combination of NMBluetoothCapabilities

+

+
+
+
+
+

Types and Values

+
+

NM_DEVICE_BT_HW_ADDRESS

+
#define NM_DEVICE_BT_HW_ADDRESS   "hw-address"
+
+

+

+

-

nm_device_bt_get_name ()

-
const char *        nm_device_bt_get_name               (NMDeviceBt *device);
+

NM_DEVICE_BT_NAME

+
#define NM_DEVICE_BT_NAME         "name"
+

-Gets the name of the NMDeviceBt.

-
---- - - - - - - - - - - -

device :

a NMDeviceBt -

Returns :

the name of the device

-

nm_device_bt_get_capabilities ()

-
NMBluetoothCapabilities nm_device_bt_get_capabilities   (NMDeviceBt *device);
+

NM_DEVICE_BT_CAPABILITIES

+
#define NM_DEVICE_BT_CAPABILITIES "bt-capabilities"
+

-Returns the Bluetooth device's usable capabilities.

-
---- - - - - - - - - - - -

device :

a NMDeviceBt -

Returns :

a combination of NMBluetoothCapabilities -

Property Details

-

The "bt-capabilities" property

-
  "bt-capabilities"          NMBluetoothCapabilities  : Read
-

-The device's bluetooth capabilities, a combination of NMBluetoothCapabilities. -

+

The “bt-capabilities” property

+
  “bt-capabilities”          NMBluetoothCapabilities
+

+

Flags: Read


-

The "hw-address" property

-
  "hw-address"               gchar*                : Read
-

-The hardware (MAC) address of the device. -

+

The “hw-address” property

+
  “hw-address”               gchar *
+

+

Flags: Read

Default value: NULL


-

The "name" property

-
  "name"                     gchar*                : Read
-

-The name of the bluetooth device. -

+

The “name” property

+
  “name”                     gchar *
+

+

Flags: Read

Default value: NULL

+ Generated by GTK-Doc V1.21
\ No newline at end of file diff --git a/docs/libnm/html/NMDeviceEthernet.html b/docs/libnm/html/NMDeviceEthernet.html index 2b5681d9..2beee10d 100644 --- a/docs/libnm/html/NMDeviceEthernet.html +++ b/docs/libnm/html/NMDeviceEthernet.html @@ -2,36 +2,28 @@ -NMDeviceEthernet +libnm Reference Manual: NMDeviceEthernet - + - - - - - - - - - - + + + + + + +
@@ -39,45 +31,116 @@

NMDeviceEthernet

NMDeviceEthernet

- +
-
-

Synopsis

-
#define             NM_DEVICE_ETHERNET_HW_ADDRESS
-#define             NM_DEVICE_ETHERNET_PERMANENT_HW_ADDRESS
-#define             NM_DEVICE_ETHERNET_SPEED
-#define             NM_DEVICE_ETHERNET_CARRIER
-struct              NMDeviceEthernet;
-                    NMDeviceEthernetClass;
-const char *        nm_device_ethernet_get_hw_address   (NMDeviceEthernet *device);
-const char *        nm_device_ethernet_get_permanent_hw_address
-                                                        (NMDeviceEthernet *device);
-guint32             nm_device_ethernet_get_speed        (NMDeviceEthernet *device);
-gboolean            nm_device_ethernet_get_carrier      (NMDeviceEthernet *device);
-
+
+

Functions

+
++++ + + + + + + + + + + + + + + + + + + +
const char * + +nm_device_ethernet_get_hw_address () +
const char * + +nm_device_ethernet_get_permanent_hw_address () +
+guint32 + +nm_device_ethernet_get_speed () +
+gboolean + +nm_device_ethernet_get_carrier () +
-

Object Hierarchy

-
-  GObject
-   +----NMObject
-         +----NMDevice
-               +----NMDeviceEthernet
-
+

Properties

+
+++++ + + + + + + + + + + + + + + + + + + + + + + +
gbooleancarrierRead
+gchar *hw-addressRead
+gchar *perm-hw-addressRead
guintspeedRead
-

Implemented Interfaces

-

-NMDeviceEthernet implements - GInitable and GAsyncInitable.

+

Types and Values

+
-

Properties

-
-  "carrier"                  gboolean              : Read
-  "hw-address"               gchar*                : Read
-  "perm-hw-address"          gchar*                : Read
-  "speed"                    guint                 : Read
+

Object Hierarchy

+
    GObject
+    ╰── NMObject
+        ╰── NMDevice
+            ╰── NMDeviceEthernet
 
@@ -86,201 +149,189 @@ NMDeviceEthernet implements

-

Details

+

Functions

-

NM_DEVICE_ETHERNET_HW_ADDRESS

-
#define NM_DEVICE_ETHERNET_HW_ADDRESS  "hw-address"
-
-

-

+

nm_device_ethernet_get_hw_address ()

+
const char *
+nm_device_ethernet_get_hw_address (NMDeviceEthernet *device);
+

Gets the active hardware (MAC) address of the NMDeviceEthernet

+
+

Parameters

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

device

a NMDeviceEthernet

 
-
-
-

NM_DEVICE_ETHERNET_PERMANENT_HW_ADDRESS

-
#define NM_DEVICE_ETHERNET_PERMANENT_HW_ADDRESS "perm-hw-address"
-
-

-

+
+

Returns

+

the active hardware address. This is the internal string used by the +device, and must not be modified.

+

-
-
-

NM_DEVICE_ETHERNET_SPEED

-
#define NM_DEVICE_ETHERNET_SPEED       "speed"
-
-

-


-

NM_DEVICE_ETHERNET_CARRIER

-
#define NM_DEVICE_ETHERNET_CARRIER     "carrier"
-
-

-

+

nm_device_ethernet_get_permanent_hw_address ()

+
const char *
+nm_device_ethernet_get_permanent_hw_address
+                               (NMDeviceEthernet *device);
+

Gets the permanent hardware (MAC) address of the NMDeviceEthernet

+
+

Parameters

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

device

a NMDeviceEthernet

 
+
+
+

Returns

+

the permanent hardware address. This is the internal string used by the +device, and must not be modified.

+

-
-
-

struct NMDeviceEthernet

-
struct NMDeviceEthernet;
-

-


-

NMDeviceEthernetClass

-
typedef struct {
-	NMDeviceClass parent;
-} NMDeviceEthernetClass;
-
-

-

+

nm_device_ethernet_get_speed ()

+
guint32
+nm_device_ethernet_get_speed (NMDeviceEthernet *device);
+

Gets the speed of the NMDeviceEthernet.

+
+

Parameters

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

device

a NMDeviceEthernet

 
+
+
+

Returns

+

the speed of the device

+

+

-

nm_device_ethernet_get_hw_address ()

-
const char *        nm_device_ethernet_get_hw_address   (NMDeviceEthernet *device);
-

-Gets the active hardware (MAC) address of the NMDeviceEthernet -

-
+

nm_device_ethernet_get_carrier ()

+
gboolean
+nm_device_ethernet_get_carrier (NMDeviceEthernet *device);
+

Whether the device has carrier.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

device :

a NMDeviceEthernet -

Returns :

the active hardware address. This is the internal string used by the -device, and must not be modified.

device

a NMDeviceEthernet

 
+
+

Returns

+

TRUE if the device has carrier

+

+
+
+
+
+

Types and Values

+
+

NM_DEVICE_ETHERNET_HW_ADDRESS

+
#define NM_DEVICE_ETHERNET_HW_ADDRESS  "hw-address"
+
+

+

+

-

nm_device_ethernet_get_permanent_hw_address ()

-
const char *        nm_device_ethernet_get_permanent_hw_address
-                                                        (NMDeviceEthernet *device);
+

NM_DEVICE_ETHERNET_PERMANENT_HW_ADDRESS

+
#define NM_DEVICE_ETHERNET_PERMANENT_HW_ADDRESS "perm-hw-address"
+

-Gets the permanent hardware (MAC) address of the NMDeviceEthernet

-
---- - - - - - - - - - - -

device :

a NMDeviceEthernet -

Returns :

the permanent hardware address. This is the internal string used by the -device, and must not be modified.

-

nm_device_ethernet_get_speed ()

-
guint32             nm_device_ethernet_get_speed        (NMDeviceEthernet *device);
+

NM_DEVICE_ETHERNET_SPEED

+
#define NM_DEVICE_ETHERNET_SPEED       "speed"
+

-Gets the speed of the NMDeviceEthernet.

-
---- - - - - - - - - - - -

device :

a NMDeviceEthernet -

Returns :

the speed of the device

-

nm_device_ethernet_get_carrier ()

-
gboolean            nm_device_ethernet_get_carrier      (NMDeviceEthernet *device);
+

NM_DEVICE_ETHERNET_CARRIER

+
#define NM_DEVICE_ETHERNET_CARRIER     "carrier"
+

-Whether the device has carrier.

-
---- - - - - - - - - - - -

device :

a NMDeviceEthernet -

Returns :

-TRUE if the device has carrier

Property Details

-

The "carrier" property

-
  "carrier"                  gboolean              : Read
-

-Whether the device has carrier. -

+

The “carrier” property

+
  “carrier”                  gboolean
+

+

Flags: Read

Default value: FALSE


-

The "hw-address" property

-
  "hw-address"               gchar*                : Read
-

-The active hardware (MAC) address of the device. -

+

The “hw-address” property

+
  “hw-address”               gchar *
+

+

Flags: Read

Default value: NULL


-

The "perm-hw-address" property

-
  "perm-hw-address"          gchar*                : Read
-

-The permanent hardware (MAC) address of the device. -

+

The “perm-hw-address” property

+
  “perm-hw-address”          gchar *
+

+

Flags: Read

Default value: NULL


-

The "speed" property

-
  "speed"                    guint                 : Read
-

-The speed of the device. -

+

The “speed” property

+
  “speed”                    guint
+

+

Flags: Read

Default value: 0

+ Generated by GTK-Doc V1.21
\ No newline at end of file diff --git a/docs/libnm/html/NMDeviceGeneric.html b/docs/libnm/html/NMDeviceGeneric.html index 3efbf0a6..28a8bb86 100644 --- a/docs/libnm/html/NMDeviceGeneric.html +++ b/docs/libnm/html/NMDeviceGeneric.html @@ -2,36 +2,28 @@ -NMDeviceGeneric +libnm Reference Manual: NMDeviceGeneric - + - - - - - - - - - - + + + + + + +
@@ -39,37 +31,73 @@

NMDeviceGeneric

NMDeviceGeneric

- +
-
-

Synopsis

-
#define             NM_DEVICE_GENERIC_HW_ADDRESS
-#define             NM_DEVICE_GENERIC_TYPE_DESCRIPTION
-struct              NMDeviceGeneric;
-                    NMDeviceGenericClass;
-const char *        nm_device_generic_get_hw_address    (NMDeviceGeneric *device);
-
+
+

Functions

+
++++ + + + + +
const char * + +nm_device_generic_get_hw_address () +
-

Object Hierarchy

-
-  GObject
-   +----NMObject
-         +----NMDevice
-               +----NMDeviceGeneric
-
+

Properties

+
+++++ + + + + + + + + + + + + +
+gchar *hw-addressRead
+gchar *type-descriptionRead
-

Implemented Interfaces

-

-NMDeviceGeneric implements - GInitable and GAsyncInitable.

+

Types and Values

+
++++ + + + + + + + + + + +
#defineNM_DEVICE_GENERIC_HW_ADDRESS
#defineNM_DEVICE_GENERIC_TYPE_DESCRIPTION
-

Properties

-
-  "hw-address"               gchar*                : Read
-  "type-description"         gchar*                : Read
+

Object Hierarchy

+
    GObject
+    ╰── NMObject
+        ╰── NMDevice
+            ╰── NMDeviceGeneric
 
@@ -78,7 +106,37 @@ NMDeviceGeneric implements

-

Details

+

Functions

+
+

nm_device_generic_get_hw_address ()

+
const char *
+nm_device_generic_get_hw_address (NMDeviceGeneric *device);
+

Gets the hardware address of the NMDeviceGeneric

+
+

Parameters

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

device

a NMDeviceGeneric

 
+
+
+

Returns

+

the hardware address. This is the internal string used by the +device, and must not be modified.

+

+
+
+
+
+

Types and Values

NM_DEVICE_GENERIC_HW_ADDRESS

#define NM_DEVICE_GENERIC_HW_ADDRESS       "hw-address"
@@ -94,74 +152,28 @@ NMDeviceGeneric implements
 

-
-
-

struct NMDeviceGeneric

-
struct NMDeviceGeneric;
-

-

-
-
-
-

NMDeviceGenericClass

-
typedef struct {
-	NMDeviceClass parent;
-} NMDeviceGenericClass;
-
-

-

-
-
-
-

nm_device_generic_get_hw_address ()

-
const char *        nm_device_generic_get_hw_address    (NMDeviceGeneric *device);
-

-Gets the hardware address of the NMDeviceGeneric -

-
---- - - - - - - - - - - -

device :

a NMDeviceGeneric -

Returns :

the hardware address. This is the internal string used by the -device, and must not be modified.
-

Property Details

-

The "hw-address" property

-
  "hw-address"               gchar*                : Read
-

-The hardware address of the device. -

+

The “hw-address” property

+
  “hw-address”               gchar *
+

+

Flags: Read

Default value: NULL


-

The "type-description" property

-
  "type-description"         gchar*                : Read
-

-A description of the specific type of device this is, or NULL -if not known. -

+

The “type-description” property

+
  “type-description”         gchar *
+

+

Flags: Read

Default value: NULL

+ Generated by GTK-Doc V1.21
\ No newline at end of file diff --git a/docs/libnm/html/NMDeviceInfiniband.html b/docs/libnm/html/NMDeviceInfiniband.html index b5646e85..60783944 100644 --- a/docs/libnm/html/NMDeviceInfiniband.html +++ b/docs/libnm/html/NMDeviceInfiniband.html @@ -2,36 +2,28 @@ -NMDeviceInfiniband +libnm Reference Manual: NMDeviceInfiniband - + - - - - - - - - - - + + + + + + +
@@ -39,38 +31,82 @@

NMDeviceInfiniband

NMDeviceInfiniband

- +
-
-

Synopsis

-
#define             NM_DEVICE_INFINIBAND_HW_ADDRESS
-#define             NM_DEVICE_INFINIBAND_CARRIER
-struct              NMDeviceInfiniband;
-                    NMDeviceInfinibandClass;
-const char *        nm_device_infiniband_get_hw_address (NMDeviceInfiniband *device);
-gboolean            nm_device_infiniband_get_carrier    (NMDeviceInfiniband *device);
-
+
+

Functions

+
++++ + + + + + + + + + + +
const char * + +nm_device_infiniband_get_hw_address () +
+gboolean + +nm_device_infiniband_get_carrier () +
-

Object Hierarchy

-
-  GObject
-   +----NMObject
-         +----NMDevice
-               +----NMDeviceInfiniband
-
+

Properties

+
+++++ + + + + + + + + + + + + +
gbooleancarrierRead
+gchar *hw-addressRead
-

Implemented Interfaces

-

-NMDeviceInfiniband implements - GInitable and GAsyncInitable.

+

Types and Values

+
++++ + + + + + + + + + + +
#defineNM_DEVICE_INFINIBAND_HW_ADDRESS
#defineNM_DEVICE_INFINIBAND_CARRIER
-

Properties

-
-  "carrier"                  gboolean              : Read
-  "hw-address"               gchar*                : Read
+

Object Hierarchy

+
    GObject
+    ╰── NMObject
+        ╰── NMDevice
+            ╰── NMDeviceInfiniband
 
@@ -79,115 +115,101 @@ NMDeviceInfiniband implements

-

Details

+

Functions

-

NM_DEVICE_INFINIBAND_HW_ADDRESS

-
#define NM_DEVICE_INFINIBAND_HW_ADDRESS  "hw-address"
-
-

-

+

nm_device_infiniband_get_hw_address ()

+
const char *
+nm_device_infiniband_get_hw_address (NMDeviceInfiniband *device);
+

Gets the hardware (MAC) address of the NMDeviceInfiniband

+
+

Parameters

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

device

a NMDeviceInfiniband

 
-
-
-

NM_DEVICE_INFINIBAND_CARRIER

-
#define NM_DEVICE_INFINIBAND_CARRIER     "carrier"
-
-

-

+
+

Returns

+

the hardware address. This is the internal string used by the +device, and must not be modified.

+

-
-
-

struct NMDeviceInfiniband

-
struct NMDeviceInfiniband;
-

-


-

NMDeviceInfinibandClass

-
typedef struct {
-	NMDeviceClass parent;
-} NMDeviceInfinibandClass;
-
-

-

+

nm_device_infiniband_get_carrier ()

+
gboolean
+nm_device_infiniband_get_carrier (NMDeviceInfiniband *device);
+

Whether the device has carrier.

+
+

Parameters

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

device

a NMDeviceInfiniband

 
-
+
+

Returns

+

TRUE if the device has carrier

+

+
+
+
+
+

Types and Values

-

nm_device_infiniband_get_hw_address ()

-
const char *        nm_device_infiniband_get_hw_address (NMDeviceInfiniband *device);
+

NM_DEVICE_INFINIBAND_HW_ADDRESS

+
#define NM_DEVICE_INFINIBAND_HW_ADDRESS  "hw-address"
+

-Gets the hardware (MAC) address of the NMDeviceInfiniband

-
---- - - - - - - - - - - -

device :

a NMDeviceInfiniband -

Returns :

the hardware address. This is the internal string used by the -device, and must not be modified.

-

nm_device_infiniband_get_carrier ()

-
gboolean            nm_device_infiniband_get_carrier    (NMDeviceInfiniband *device);
+

NM_DEVICE_INFINIBAND_CARRIER

+
#define NM_DEVICE_INFINIBAND_CARRIER     "carrier"
+

-Whether the device has carrier.

-
---- - - - - - - - - - - -

device :

a NMDeviceInfiniband -

Returns :

-TRUE if the device has carrier

Property Details

-

The "carrier" property

-
  "carrier"                  gboolean              : Read
-

-Whether the device has carrier. -

+

The “carrier” property

+
  “carrier”                  gboolean
+

+

Flags: Read

Default value: FALSE


-

The "hw-address" property

-
  "hw-address"               gchar*                : Read
-

-The hardware (MAC) address of the device. -

+

The “hw-address” property

+
  “hw-address”               gchar *
+

+

Flags: Read

Default value: NULL

+ Generated by GTK-Doc V1.21
\ No newline at end of file diff --git a/docs/libnm/html/NMDeviceModem.html b/docs/libnm/html/NMDeviceModem.html index 12e5d37d..49cd12df 100644 --- a/docs/libnm/html/NMDeviceModem.html +++ b/docs/libnm/html/NMDeviceModem.html @@ -2,36 +2,28 @@ -NMDeviceModem +libnm Reference Manual: NMDeviceModem - + - - - - - - - - - - + + + + + + +
@@ -39,40 +31,82 @@

NMDeviceModem

NMDeviceModem

- +
-
-

Synopsis

-
#define             NM_DEVICE_MODEM_MODEM_CAPABILITIES
-#define             NM_DEVICE_MODEM_CURRENT_CAPABILITIES
-struct              NMDeviceModem;
-                    NMDeviceModemClass;
-NMDeviceModemCapabilities nm_device_modem_get_modem_capabilities
-                                                        (NMDeviceModem *self);
-NMDeviceModemCapabilities nm_device_modem_get_current_capabilities
-                                                        (NMDeviceModem *self);
-
+
-

Object Hierarchy

-
-  GObject
-   +----NMObject
-         +----NMDevice
-               +----NMDeviceModem
-
+

Properties

+
-

Implemented Interfaces

-

-NMDeviceModem implements - GInitable and GAsyncInitable.

+

Types and Values

+
-

Properties

-
-  "current-capabilities"     NMDeviceModemCapabilities  : Read
-  "modem-capabilities"       NMDeviceModemCapabilities  : Read
+

Object Hierarchy

+
    GObject
+    ╰── NMObject
+        ╰── NMDevice
+            ╰── NMDeviceModem
 
@@ -81,122 +115,105 @@ NMDeviceModem implements

-

Details

+

Functions

-

NM_DEVICE_MODEM_MODEM_CAPABILITIES

-
#define NM_DEVICE_MODEM_MODEM_CAPABILITIES   "modem-capabilities"
-
-

-

-
-
-
-

NM_DEVICE_MODEM_CURRENT_CAPABILITIES

-
#define NM_DEVICE_MODEM_CURRENT_CAPABILITIES "current-capabilities"
-
-

-

-
-
-
-

struct NMDeviceModem

-
struct NMDeviceModem;
-

-

-
-
-
-

NMDeviceModemClass

-
typedef struct {
-	NMDeviceClass parent;
-} NMDeviceModemClass;
-
-

-

-
-
-
-

nm_device_modem_get_modem_capabilities ()

-
NMDeviceModemCapabilities nm_device_modem_get_modem_capabilities
-                                                        (NMDeviceModem *self);
-

-Returns a bitfield of the generic access technology families the modem +

nm_device_modem_get_modem_capabilities ()

+
NMDeviceModemCapabilities
+nm_device_modem_get_modem_capabilities
+                               (NMDeviceModem *self);
+

Returns a bitfield of the generic access technology families the modem supports. Not all capabilities are available concurrently however; some -may require a firmware reload or reinitialization. -

-
+may require a firmware reload or reinitialization.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

self :

a NMDeviceModem -

Returns :

the generic access technology families the modem supports

self

a NMDeviceModem

 
+
+

Returns

+

the generic access technology families the modem supports

+

+
+

-

nm_device_modem_get_current_capabilities ()

-
NMDeviceModemCapabilities nm_device_modem_get_current_capabilities
-                                                        (NMDeviceModem *self);
-

-Returns a bitfield of the generic access technology families the modem +

nm_device_modem_get_current_capabilities ()

+
NMDeviceModemCapabilities
+nm_device_modem_get_current_capabilities
+                               (NMDeviceModem *self);
+

Returns a bitfield of the generic access technology families the modem supports without a firmware reload or reinitialization. This value -represents the network types the modem can immediately connect to. -

-
+represents the network types the modem can immediately connect to.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

self :

a NMDeviceModem -

Returns :

the generic access technology families the modem supports without -a firmware reload or other reinitialization

self

a NMDeviceModem

 
+
+

Returns

+

the generic access technology families the modem supports without +a firmware reload or other reinitialization

+

+
+
-

Property Details

+

Types and Values

-

The "current-capabilities" property

-
  "current-capabilities"     NMDeviceModemCapabilities  : Read
+

NM_DEVICE_MODEM_MODEM_CAPABILITIES

+
#define NM_DEVICE_MODEM_MODEM_CAPABILITIES   "modem-capabilities"
+

-The generic family of access technologies the modem currently supports -without a firmware reload or reinitialization.


-

The "modem-capabilities" property

-
  "modem-capabilities"       NMDeviceModemCapabilities  : Read
+

NM_DEVICE_MODEM_CURRENT_CAPABILITIES

+
#define NM_DEVICE_MODEM_CURRENT_CAPABILITIES "current-capabilities"
+

-The generic family of access technologies the modem supports. Not all -capabilities are available at the same time however; some modems require -a firmware reload or other reinitialization to switch between eg -CDMA/EVDO and GSM/UMTS.

+
+

Property Details

+
+

The “current-capabilities” property

+
  “current-capabilities”     NMDeviceModemCapabilities
+

+

Flags: Read

+
+
+
+

The “modem-capabilities” property

+
  “modem-capabilities”       NMDeviceModemCapabilities
+

+

Flags: Read

+
+
+ Generated by GTK-Doc V1.21
\ No newline at end of file diff --git a/docs/libnm/html/NMDeviceOlpcMesh.html b/docs/libnm/html/NMDeviceOlpcMesh.html index 88a6d71b..0bdbf9aa 100644 --- a/docs/libnm/html/NMDeviceOlpcMesh.html +++ b/docs/libnm/html/NMDeviceOlpcMesh.html @@ -2,36 +2,28 @@ -NMDeviceOlpcMesh +libnm Reference Manual: NMDeviceOlpcMesh - + - - - - - - - - - - + + + + + + +
@@ -39,42 +31,100 @@

NMDeviceOlpcMesh

NMDeviceOlpcMesh

- +
-
-

Synopsis

-
#define             NM_DEVICE_OLPC_MESH_HW_ADDRESS
-#define             NM_DEVICE_OLPC_MESH_COMPANION
-#define             NM_DEVICE_OLPC_MESH_ACTIVE_CHANNEL
-struct              NMDeviceOlpcMesh;
-                    NMDeviceOlpcMeshClass;
-const char *        nm_device_olpc_mesh_get_hw_address  (NMDeviceOlpcMesh *device);
-NMDeviceWifi *      nm_device_olpc_mesh_get_companion   (NMDeviceOlpcMesh *device);
-guint32             nm_device_olpc_mesh_get_active_channel
-                                                        (NMDeviceOlpcMesh *device);
-
+
+

Functions

+
++++ + + + + + + + + + + + + + + +
const char * + +nm_device_olpc_mesh_get_hw_address () +
+NMDeviceWifi * + +nm_device_olpc_mesh_get_companion () +
+guint32 + +nm_device_olpc_mesh_get_active_channel () +
-

Object Hierarchy

-
-  GObject
-   +----NMObject
-         +----NMDevice
-               +----NMDeviceOlpcMesh
-
+

Properties

+
+++++ + + + + + + + + + + + + + + + + + +
guintactive-channelRead
+NMDeviceWifi *companionRead
+gchar *hw-addressRead
-

Implemented Interfaces

-

-NMDeviceOlpcMesh implements - GInitable and GAsyncInitable.

+

Types and Values

+
-

Properties

-
-  "active-channel"           guint                 : Read
-  "companion"                NMDeviceWifi*         : Read
-  "hw-address"               gchar*                : Read
+

Object Hierarchy

+
    GObject
+    ╰── NMObject
+        ╰── NMDevice
+            ╰── NMDeviceOlpcMesh
 
@@ -83,157 +133,144 @@ NMDeviceOlpcMesh implements

-

Details

+

Functions

-

NM_DEVICE_OLPC_MESH_HW_ADDRESS

-
#define NM_DEVICE_OLPC_MESH_HW_ADDRESS     "hw-address"
-
-

-

+

nm_device_olpc_mesh_get_hw_address ()

+
const char *
+nm_device_olpc_mesh_get_hw_address (NMDeviceOlpcMesh *device);
+

Gets the hardware (MAC) address of the NMDeviceOlpcMesh

+
+

Parameters

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

device

a NMDeviceOlpcMesh

 
-
-
-

NM_DEVICE_OLPC_MESH_COMPANION

-
#define NM_DEVICE_OLPC_MESH_COMPANION      "companion"
-
-

-

+
+

Returns

+

the hardware address. This is the internal string used by the +device, and must not be modified.

+

-
-
-

NM_DEVICE_OLPC_MESH_ACTIVE_CHANNEL

-
#define NM_DEVICE_OLPC_MESH_ACTIVE_CHANNEL "active-channel"
-
-

-


-

struct NMDeviceOlpcMesh

-
struct NMDeviceOlpcMesh;
-

-

+

nm_device_olpc_mesh_get_companion ()

+
NMDeviceWifi *
+nm_device_olpc_mesh_get_companion (NMDeviceOlpcMesh *device);
+

Gets the companion device of the NMDeviceOlpcMesh.

+
+

Parameters

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

device

a NMDeviceOlpcMesh

 
+
+
+

Returns

+

the companion of the device of NULL.

+

[transfer none]

-
-
-

NMDeviceOlpcMeshClass

-
typedef struct {
-	NMDeviceClass parent;
-} NMDeviceOlpcMeshClass;
-
-

-


-

nm_device_olpc_mesh_get_hw_address ()

-
const char *        nm_device_olpc_mesh_get_hw_address  (NMDeviceOlpcMesh *device);
-

-Gets the hardware (MAC) address of the NMDeviceOlpcMesh -

-
+

nm_device_olpc_mesh_get_active_channel ()

+
guint32
+nm_device_olpc_mesh_get_active_channel
+                               (NMDeviceOlpcMesh *device);
+

Returns the active channel of the NMDeviceOlpcMesh device.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

device :

a NMDeviceOlpcMesh -

Returns :

the hardware address. This is the internal string used by the -device, and must not be modified.

device

a NMDeviceOlpcMesh

 
+
+

Returns

+

active channel of the device

+

+
+
+
+
+

Types and Values

+
+

NM_DEVICE_OLPC_MESH_HW_ADDRESS

+
#define NM_DEVICE_OLPC_MESH_HW_ADDRESS     "hw-address"
+
+

+

+

-

nm_device_olpc_mesh_get_companion ()

-
NMDeviceWifi *      nm_device_olpc_mesh_get_companion   (NMDeviceOlpcMesh *device);
+

NM_DEVICE_OLPC_MESH_COMPANION

+
#define NM_DEVICE_OLPC_MESH_COMPANION      "companion"
+

-Gets the companion device of the NMDeviceOlpcMesh.

-
---- - - - - - - - - - - -

device :

a NMDeviceOlpcMesh -

Returns :

the companion of the device of NULL. [transfer none] -

-

nm_device_olpc_mesh_get_active_channel ()

-
guint32             nm_device_olpc_mesh_get_active_channel
-                                                        (NMDeviceOlpcMesh *device);
+

NM_DEVICE_OLPC_MESH_ACTIVE_CHANNEL

+
#define NM_DEVICE_OLPC_MESH_ACTIVE_CHANNEL "active-channel"
+

-Returns the active channel of the NMDeviceOlpcMesh device.

-
---- - - - - - - - - - - -

device :

a NMDeviceOlpcMesh -

Returns :

active channel of the device

Property Details

-

The "active-channel" property

-
  "active-channel"           guint                 : Read
-

-The device's active channel. -

+

The “active-channel” property

+
  “active-channel”           guint
+

+

Flags: Read

Default value: 0


-

The "companion" property

-
  "companion"                NMDeviceWifi*         : Read
-

-The companion device. -

+

The “companion” property

+
  “companion”                NMDeviceWifi *
+

+

Flags: Read


-

The "hw-address" property

-
  "hw-address"               gchar*                : Read
-

-The hardware (MAC) address of the device. -

+

The “hw-address” property

+
  “hw-address”               gchar *
+

+

Flags: Read

Default value: NULL

+ Generated by GTK-Doc V1.21
\ No newline at end of file diff --git a/docs/libnm/html/NMDeviceTeam.html b/docs/libnm/html/NMDeviceTeam.html index 9edc63f6..ded0ca8f 100644 --- a/docs/libnm/html/NMDeviceTeam.html +++ b/docs/libnm/html/NMDeviceTeam.html @@ -2,36 +2,28 @@ -NMDeviceTeam +libnm Reference Manual: NMDeviceTeam - + - - - - - - - - - - + + + + + + +
@@ -39,41 +31,99 @@

NMDeviceTeam

NMDeviceTeam

- +
-
-

Synopsis

-
#define             NM_DEVICE_TEAM_HW_ADDRESS
-#define             NM_DEVICE_TEAM_CARRIER
-#define             NM_DEVICE_TEAM_SLAVES
-struct              NMDeviceTeam;
-                    NMDeviceTeamClass;
-const char *        nm_device_team_get_hw_address       (NMDeviceTeam *device);
-gboolean            nm_device_team_get_carrier          (NMDeviceTeam *device);
-const GPtrArray *   nm_device_team_get_slaves           (NMDeviceTeam *device);
-
+
+

Functions

+
++++ + + + + + + + + + + + + + + +
const char * + +nm_device_team_get_hw_address () +
+gboolean + +nm_device_team_get_carrier () +
const GPtrArray * + +nm_device_team_get_slaves () +
-

Object Hierarchy

-
-  GObject
-   +----NMObject
-         +----NMDevice
-               +----NMDeviceTeam
-
+

Properties

+
+++++ + + + + + + + + + + + + + + + + + +
gbooleancarrierRead
+gchar *hw-addressRead
+GPtrArray *slavesRead
-

Implemented Interfaces

-

-NMDeviceTeam implements - GInitable and GAsyncInitable.

+

Types and Values

+
++++ + + + + + + + + + + + + + + +
#defineNM_DEVICE_TEAM_HW_ADDRESS
#defineNM_DEVICE_TEAM_CARRIER
#defineNM_DEVICE_TEAM_SLAVES
-

Properties

-
-  "carrier"                  gboolean              : Read
-  "hw-address"               gchar*                : Read
-  "slaves"                   GPtrArray*            : Read
+

Object Hierarchy

+
    GObject
+    ╰── NMObject
+        ╰── NMDevice
+            ╰── NMDeviceTeam
 
@@ -82,162 +132,147 @@ NMDeviceTeam implements

-

Details

+

Functions

-

NM_DEVICE_TEAM_HW_ADDRESS

-
#define NM_DEVICE_TEAM_HW_ADDRESS  "hw-address"
-
-

-

+

nm_device_team_get_hw_address ()

+
const char *
+nm_device_team_get_hw_address (NMDeviceTeam *device);
+

Gets the hardware (MAC) address of the NMDeviceTeam

+
+

Parameters

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

device

a NMDeviceTeam

 
-
-
-

NM_DEVICE_TEAM_CARRIER

-
#define NM_DEVICE_TEAM_CARRIER     "carrier"
-
-

-

+
+

Returns

+

the hardware address. This is the internal string used by the +device, and must not be modified.

+

-
-
-

NM_DEVICE_TEAM_SLAVES

-
#define NM_DEVICE_TEAM_SLAVES      "slaves"
-
-

-


-

struct NMDeviceTeam

-
struct NMDeviceTeam;
-

-

+

nm_device_team_get_carrier ()

+
gboolean
+nm_device_team_get_carrier (NMDeviceTeam *device);
+

Whether the device has carrier.

+
+

Parameters

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

device

a NMDeviceTeam

 
+
+
+

Returns

+

TRUE if the device has carrier

+

-
-
-

NMDeviceTeamClass

-
typedef struct {
-	NMDeviceClass parent;
-} NMDeviceTeamClass;
-
-

-


-

nm_device_team_get_hw_address ()

-
const char *        nm_device_team_get_hw_address       (NMDeviceTeam *device);
-

-Gets the hardware (MAC) address of the NMDeviceTeam -

-
+

nm_device_team_get_slaves ()

+
const GPtrArray *
+nm_device_team_get_slaves (NMDeviceTeam *device);
+

Gets the devices currently enslaved to device +.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

device :

a NMDeviceTeam -

Returns :

the hardware address. This is the internal string used by the -device, and must not be modified.

device

a NMDeviceTeam

 
+
+

Returns

+

the GPtrArray containing +NMDevices that are slaves of device +. This is the internal +copy used by the device, and must not be modified.

+

[element-type NMDevice]

+
+
+
+
+

Types and Values

+
+

NM_DEVICE_TEAM_HW_ADDRESS

+
#define NM_DEVICE_TEAM_HW_ADDRESS  "hw-address"
+
+

+

+

-

nm_device_team_get_carrier ()

-
gboolean            nm_device_team_get_carrier          (NMDeviceTeam *device);
+

NM_DEVICE_TEAM_CARRIER

+
#define NM_DEVICE_TEAM_CARRIER     "carrier"
+

-Whether the device has carrier.

-
---- - - - - - - - - - - -

device :

a NMDeviceTeam -

Returns :

-TRUE if the device has carrier

-

nm_device_team_get_slaves ()

-
const GPtrArray *   nm_device_team_get_slaves           (NMDeviceTeam *device);
+

NM_DEVICE_TEAM_SLAVES

+
#define NM_DEVICE_TEAM_SLAVES      "slaves"
+

-Gets the devices currently enslaved to device.

-
---- - - - - - - - - - - -

device :

a NMDeviceTeam -

Returns :

the GPtrArray containing -NMDevices that are slaves of device. This is the internal -copy used by the device, and must not be modified. [element-type NMDevice] -

Property Details

-

The "carrier" property

-
  "carrier"                  gboolean              : Read
-

-Whether the device has carrier. -

+

The “carrier” property

+
  “carrier”                  gboolean
+

+

Flags: Read

Default value: FALSE


-

The "hw-address" property

-
  "hw-address"               gchar*                : Read
-

-The hardware (MAC) address of the device. -

+

The “hw-address” property

+
  “hw-address”               gchar *
+

+

Flags: Read

Default value: NULL


-

The "slaves" property

-
  "slaves"                   GPtrArray*            : Read
-

-The devices enslaved to the team device. -

-

-Element-type: NMDevice -

+

The “slaves” property

+
  “slaves”                   GPtrArray *
+

+

Flags: Read

+ Generated by GTK-Doc V1.21
\ No newline at end of file diff --git a/docs/libnm/html/NMDeviceVlan.html b/docs/libnm/html/NMDeviceVlan.html index 7351cc96..3febf838 100644 --- a/docs/libnm/html/NMDeviceVlan.html +++ b/docs/libnm/html/NMDeviceVlan.html @@ -2,36 +2,28 @@ -NMDeviceVlan +libnm Reference Manual: NMDeviceVlan - + - - - - - - - - - - + + + + + + +
@@ -39,44 +31,117 @@

NMDeviceVlan

NMDeviceVlan

- +
-
-

Synopsis

-
#define             NM_DEVICE_VLAN_HW_ADDRESS
-#define             NM_DEVICE_VLAN_CARRIER
-#define             NM_DEVICE_VLAN_PARENT
-#define             NM_DEVICE_VLAN_VLAN_ID
-struct              NMDeviceVlan;
-                    NMDeviceVlanClass;
-const char *        nm_device_vlan_get_hw_address       (NMDeviceVlan *device);
-gboolean            nm_device_vlan_get_carrier          (NMDeviceVlan *device);
-NMDevice *          nm_device_vlan_get_parent           (NMDeviceVlan *device);
-guint               nm_device_vlan_get_vlan_id          (NMDeviceVlan *device);
-
+
+

Functions

+
++++ + + + + + + + + + + + + + + + + + + +
const char * + +nm_device_vlan_get_hw_address () +
+gboolean + +nm_device_vlan_get_carrier () +
+NMDevice * + +nm_device_vlan_get_parent () +
+guint + +nm_device_vlan_get_vlan_id () +
-

Object Hierarchy

-
-  GObject
-   +----NMObject
-         +----NMDevice
-               +----NMDeviceVlan
-
+

Properties

+
+++++ + + + + + + + + + + + + + + + + + + + + + + +
gbooleancarrierRead
+gchar *hw-addressRead
+NMDevice *parentRead
guintvlan-idRead
-

Implemented Interfaces

-

-NMDeviceVlan implements - GInitable and GAsyncInitable.

+

Types and Values

+
++++ + + + + + + + + + + + + + + + + + + +
#defineNM_DEVICE_VLAN_HW_ADDRESS
#defineNM_DEVICE_VLAN_CARRIER
#defineNM_DEVICE_VLAN_PARENT
#defineNM_DEVICE_VLAN_VLAN_ID
-

Properties

-
-  "carrier"                  gboolean              : Read
-  "hw-address"               gchar*                : Read
-  "parent"                   NMDevice*             : Read
-  "vlan-id"                  guint                 : Read
+

Object Hierarchy

+
    GObject
+    ╰── NMObject
+        ╰── NMDevice
+            ╰── NMDeviceVlan
 
@@ -85,187 +150,178 @@ NMDeviceVlan implements

-

Details

+

Functions

-

NM_DEVICE_VLAN_HW_ADDRESS

-
#define NM_DEVICE_VLAN_HW_ADDRESS  "hw-address"
-
-

-

+

nm_device_vlan_get_hw_address ()

+
const char *
+nm_device_vlan_get_hw_address (NMDeviceVlan *device);
+

Gets the hardware (MAC) address of the NMDeviceVlan

+
+

Parameters

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

device

a NMDeviceVlan

 
+
+
+

Returns

+

the hardware address. This is the internal string used by the +device, and must not be modified.

+

+

-

NM_DEVICE_VLAN_CARRIER

-
#define NM_DEVICE_VLAN_CARRIER     "carrier"
-
-

-

+

nm_device_vlan_get_carrier ()

+
gboolean
+nm_device_vlan_get_carrier (NMDeviceVlan *device);
+

Whether the device has carrier.

+
+

Parameters

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

device

a NMDeviceVlan

 
+
+
+

Returns

+

TRUE if the device has carrier

+

+

-

NM_DEVICE_VLAN_PARENT

-
#define NM_DEVICE_VLAN_PARENT      "parent"
-
-

-

+

nm_device_vlan_get_parent ()

+
NMDevice *
+nm_device_vlan_get_parent (NMDeviceVlan *device);
+
+

Parameters

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

device

a NMDeviceVlan

 
+
+
+

Returns

+

the device's parent device.

+

[transfer none]

+

-

NM_DEVICE_VLAN_VLAN_ID

-
#define NM_DEVICE_VLAN_VLAN_ID     "vlan-id"
-
-

-

+

nm_device_vlan_get_vlan_id ()

+
guint
+nm_device_vlan_get_vlan_id (NMDeviceVlan *device);
+
+

Parameters

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

device

a NMDeviceVlan

 
-
+
+

Returns

+

the device's VLAN ID

+

+
+
+
+
+

Types and Values

-

struct NMDeviceVlan

-
struct NMDeviceVlan;
+

NM_DEVICE_VLAN_HW_ADDRESS

+
#define NM_DEVICE_VLAN_HW_ADDRESS  "hw-address"
+


-

NMDeviceVlanClass

-
typedef struct {
-	NMDeviceClass parent;
-} NMDeviceVlanClass;
+

NM_DEVICE_VLAN_CARRIER

+
#define NM_DEVICE_VLAN_CARRIER     "carrier"
 


-

nm_device_vlan_get_hw_address ()

-
const char *        nm_device_vlan_get_hw_address       (NMDeviceVlan *device);
+

NM_DEVICE_VLAN_PARENT

+
#define NM_DEVICE_VLAN_PARENT      "parent"
+

-Gets the hardware (MAC) address of the NMDeviceVlan

-
---- - - - - - - - - - - -

device :

a NMDeviceVlan -

Returns :

the hardware address. This is the internal string used by the -device, and must not be modified.

-

nm_device_vlan_get_carrier ()

-
gboolean            nm_device_vlan_get_carrier          (NMDeviceVlan *device);
+

NM_DEVICE_VLAN_VLAN_ID

+
#define NM_DEVICE_VLAN_VLAN_ID     "vlan-id"
+

-Whether the device has carrier.

-
---- - - - - - - - - - - -

device :

a NMDeviceVlan -

Returns :

-TRUE if the device has carrier
-
-
-
-

nm_device_vlan_get_parent ()

-
NMDevice *          nm_device_vlan_get_parent           (NMDeviceVlan *device);
-
---- - - - - - - - - - - -

device :

a NMDeviceVlan -

Returns :

the device's parent device. [transfer none] -
-
-
-
-

nm_device_vlan_get_vlan_id ()

-
guint               nm_device_vlan_get_vlan_id          (NMDeviceVlan *device);
-
---- - - - - - - - - - - -

device :

a NMDeviceVlan -

Returns :

the device's VLAN ID

Property Details

-

The "carrier" property

-
  "carrier"                  gboolean              : Read
-

-Whether the device has carrier. -

+

The “carrier” property

+
  “carrier”                  gboolean
+

+

Flags: Read

Default value: FALSE


-

The "hw-address" property

-
  "hw-address"               gchar*                : Read
-

-The hardware (MAC) address of the device. -

+

The “hw-address” property

+
  “hw-address”               gchar *
+

+

Flags: Read

Default value: NULL


-

The "parent" property

-
  "parent"                   NMDevice*             : Read
-

-The devices's parent device. -

+

The “parent” property

+
  “parent”                   NMDevice *
+

+

Flags: Read


-

The "vlan-id" property

-
  "vlan-id"                  guint                 : Read
-

-The device's VLAN ID. -

+

The “vlan-id” property

+
  “vlan-id”                  guint
+

+

Flags: Read

Allowed values: <= 4095

Default value: 0

@@ -273,6 +329,6 @@ The device's VLAN ID.
+ Generated by GTK-Doc V1.21
\ No newline at end of file diff --git a/docs/libnm/html/NMDeviceWifi.html b/docs/libnm/html/NMDeviceWifi.html index 4fce8985..6bbad017 100644 --- a/docs/libnm/html/NMDeviceWifi.html +++ b/docs/libnm/html/NMDeviceWifi.html @@ -2,38 +2,29 @@ -NMDeviceWifi +libnm Reference Manual: NMDeviceWifi - + - - - - - - - - - - + + + + + + +
@@ -41,628 +32,734 @@

NMDeviceWifi

NMDeviceWifi

- +
- -
-

Object Hierarchy

-
-  GObject
-   +----NMObject
-         +----NMDevice
-               +----NMDeviceWifi
-
-
-
-

Implemented Interfaces

-

-NMDeviceWifi implements - GInitable and GAsyncInitable.

-
-
-

Properties

-
-  "access-points"            GPtrArray*            : Read
-  "active-access-point"      NMAccessPoint*        : Read
-  "bitrate"                  guint                 : Read
-  "hw-address"               gchar*                : Read
-  "mode"                     NM80211Mode           : Read
-  "perm-hw-address"          gchar*                : Read
-  "wireless-capabilities"    NMDeviceWifiCapabilities  : Read
-
-
- -
-

Description

-

-

-
-

Details

-
-

NM_DEVICE_WIFI_HW_ADDRESS

-
#define NM_DEVICE_WIFI_HW_ADDRESS          "hw-address"
-
-

-

-
-
-
-

NM_DEVICE_WIFI_PERMANENT_HW_ADDRESS

-
#define NM_DEVICE_WIFI_PERMANENT_HW_ADDRESS "perm-hw-address"
-
-

-

-
-
-
-

NM_DEVICE_WIFI_MODE

-
#define NM_DEVICE_WIFI_MODE                "mode"
-
-

-

-
-
-
-

NM_DEVICE_WIFI_BITRATE

-
#define NM_DEVICE_WIFI_BITRATE             "bitrate"
-
-

-

-
-
-
-

NM_DEVICE_WIFI_ACTIVE_ACCESS_POINT

-
#define NM_DEVICE_WIFI_ACTIVE_ACCESS_POINT "active-access-point"
-
-

-

-
-
-
-

NM_DEVICE_WIFI_CAPABILITIES

-
#define NM_DEVICE_WIFI_CAPABILITIES        "wireless-capabilities"
-
-

-

-
-
-
-

NM_DEVICE_WIFI_ACCESS_POINTS

-
#define NM_DEVICE_WIFI_ACCESS_POINTS       "access-points"
-
-

-

-
-
-
-

struct NMDeviceWifi

-
struct NMDeviceWifi;
-

-

-
-
-
-

NMDeviceWifiClass

-
typedef struct {
-	NMDeviceClass parent;
-
-	/* Signals */
-	void (*access_point_added) (NMDeviceWifi *device, NMAccessPoint *ap);
-	void (*access_point_removed) (NMDeviceWifi *device, NMAccessPoint *ap);
-} NMDeviceWifiClass;
-
-

-

-
-
-
-

nm_device_wifi_get_hw_address ()

-
const char *        nm_device_wifi_get_hw_address       (NMDeviceWifi *device);
-

-Gets the actual hardware (MAC) address of the NMDeviceWifi -

-
+

Functions

+
--++ - - + + + + + - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

device :

a NMDeviceWifi +const char * + +nm_device_wifi_get_hw_address () +
const char * + +nm_device_wifi_get_permanent_hw_address ()

Returns :

the actual hardware address. This is the internal string used by the -device, and must not be modified. +NM80211Mode + +nm_device_wifi_get_mode () +
+guint32 + +nm_device_wifi_get_bitrate () +
+NMDeviceWifiCapabilities + +nm_device_wifi_get_capabilities () +
+NMAccessPoint * + +nm_device_wifi_get_active_access_point () +
+NMAccessPoint * + +nm_device_wifi_get_access_point_by_path () +
const GPtrArray * + +nm_device_wifi_get_access_points () +
+gboolean + +nm_device_wifi_request_scan () +
+void + +nm_device_wifi_request_scan_async () +
+gboolean + +nm_device_wifi_request_scan_finish () +
-
-
-

nm_device_wifi_get_permanent_hw_address ()

-
const char *        nm_device_wifi_get_permanent_hw_address
-                                                        (NMDeviceWifi *device);
-

-Gets the permanent hardware (MAC) address of the NMDeviceWifi -

-
+
+

Properties

+
--+++ - - + + + + + + + + + + + + + + + + + + - - + + + + + + + + + + + + +

device :

a NMDeviceWifi - +GPtrArray *access-pointsRead
+NMAccessPoint *active-access-pointRead
guintbitrateRead
+gchar *hw-addressRead

Returns :

the permanent hardware address. This is the internal string used by the -device, and must not be modified.NM80211ModemodeRead
+gchar *perm-hw-addressRead
NMDeviceWifiCapabilitieswireless-capabilitiesRead
-
-
-

nm_device_wifi_get_mode ()

-
NM80211Mode         nm_device_wifi_get_mode             (NMDeviceWifi *device);
-

-Gets the NMDeviceWifi mode. -

-
+
+

Signals

+
--+++ - - + + + - - + + +

device :

a NMDeviceWifi -voidaccess-point-addedRun First

Returns :

the modevoidaccess-point-removedRun First
-
-
-

nm_device_wifi_get_bitrate ()

-
guint32             nm_device_wifi_get_bitrate          (NMDeviceWifi *device);
-

-Gets the bit rate of the NMDeviceWifi in kbit/s. -

-
+
+

Types and Values

+
--++ - - + + + + + + + + + + + + + + + + + + - - + + + + + +

device :

a NMDeviceWifi -#defineNM_DEVICE_WIFI_HW_ADDRESS
#defineNM_DEVICE_WIFI_PERMANENT_HW_ADDRESS
#defineNM_DEVICE_WIFI_MODE
#defineNM_DEVICE_WIFI_BITRATE
#defineNM_DEVICE_WIFI_ACTIVE_ACCESS_POINT

Returns :

the bit rate (kbit/s)#defineNM_DEVICE_WIFI_CAPABILITIES
#defineNM_DEVICE_WIFI_ACCESS_POINTS
-
-
-

nm_device_wifi_get_capabilities ()

-
NMDeviceWifiCapabilities nm_device_wifi_get_capabilities
-                                                        (NMDeviceWifi *device);
+
+

Object Hierarchy

+
    GObject
+    ╰── NMObject
+        ╰── NMDevice
+            ╰── NMDeviceWifi
+
+
+
+

Description

-Gets the Wi-Fi capabilities of the NMDeviceWifi.

-
+ +
+

Functions

+
+

nm_device_wifi_get_hw_address ()

+
const char *
+nm_device_wifi_get_hw_address (NMDeviceWifi *device);
+

Gets the actual hardware (MAC) address of the NMDeviceWifi

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

device :

a NMDeviceWifi -

Returns :

the capabilities

device

a NMDeviceWifi

 
+
+

Returns

+

the actual hardware address. This is the internal string used by the +device, and must not be modified.

+

+
+

-

nm_device_wifi_get_active_access_point ()

-
NMAccessPoint *     nm_device_wifi_get_active_access_point
-                                                        (NMDeviceWifi *device);
-

-Gets the active NMAccessPoint. -

-
+

nm_device_wifi_get_permanent_hw_address ()

+
const char *
+nm_device_wifi_get_permanent_hw_address
+                               (NMDeviceWifi *device);
+

Gets the permanent hardware (MAC) address of the NMDeviceWifi

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

device :

a NMDeviceWifi -

Returns :

the access point or NULL if none is active. [transfer none] -

device

a NMDeviceWifi

 
+
+

Returns

+

the permanent hardware address. This is the internal string used by the +device, and must not be modified.

+

+
+

-

nm_device_wifi_get_access_point_by_path ()

-
NMAccessPoint *     nm_device_wifi_get_access_point_by_path
-                                                        (NMDeviceWifi *device,
-                                                         const char *path);
-

-Gets a NMAccessPoint by path. -

-
+

nm_device_wifi_get_mode ()

+
NM80211Mode
+nm_device_wifi_get_mode (NMDeviceWifi *device);
+

Gets the NMDeviceWifi mode.

+
+

Parameters

+
--+++ - - - - - - - - - - - - - - + + + + +

device :

a NMDeviceWifi -

path :

the object path of the access point

Returns :

the access point or NULL if none is found. [transfer none] -

device

a NMDeviceWifi

 
+
+

Returns

+

the mode

+

+
+

-

nm_device_wifi_get_access_points ()

-
const GPtrArray *   nm_device_wifi_get_access_points    (NMDeviceWifi *device);
-

-Gets all the scanned access points of the NMDeviceWifi. -

-
+

nm_device_wifi_get_bitrate ()

+
guint32
+nm_device_wifi_get_bitrate (NMDeviceWifi *device);
+

Gets the bit rate of the NMDeviceWifi in kbit/s.

+
+

Parameters

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

device

a NMDeviceWifi

 
+
+
+

Returns

+

the bit rate (kbit/s)

+

+
+
+
+
+

nm_device_wifi_get_capabilities ()

+
NMDeviceWifiCapabilities
+nm_device_wifi_get_capabilities (NMDeviceWifi *device);
+

Gets the Wi-Fi capabilities of the NMDeviceWifi.

+
+

Parameters

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

device

a NMDeviceWifi

 
+
+
+

Returns

+

the capabilities

+

+
+
+
+
+

nm_device_wifi_get_active_access_point ()

+
NMAccessPoint *
+nm_device_wifi_get_active_access_point
+                               (NMDeviceWifi *device);
+

Gets the active NMAccessPoint.

+
+

Parameters

+
--++++ + + + + + +

device

a NMDeviceWifi

 
+
+
+

Returns

+

the access point or NULL if none is active.

+

[transfer none]

+
+
+
+
+

nm_device_wifi_get_access_point_by_path ()

+
NMAccessPoint *
+nm_device_wifi_get_access_point_by_path
+                               (NMDeviceWifi *device,
+                                const char *path);
+

Gets a NMAccessPoint by path.

+
+

Parameters

+
++++ - - + + + - - + + +

device :

a NMDeviceWifi -

device

a NMDeviceWifi

 

Returns :

a GPtrArray containing all the -scanned NMAccessPoints. -The returned array is owned by the client and should not be modified. [element-type NMAccessPoint] -

path

the object path of the access point

 
+
+

Returns

+

the access point or NULL if none is found.

+

[transfer none]

+
+

-

nm_device_wifi_request_scan ()

-
gboolean            nm_device_wifi_request_scan         (NMDeviceWifi *device,
-                                                         GCancellable *cancellable,
-                                                         GError **error);
-

-Request NM to scan for access points on device. Note that the function +

nm_device_wifi_get_access_points ()

+
const GPtrArray *
+nm_device_wifi_get_access_points (NMDeviceWifi *device);
+

Gets all the scanned access points of the NMDeviceWifi.

+
+

Parameters

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

device

a NMDeviceWifi

 
+
+
+

Returns

+

a GPtrArray containing all the +scanned NMAccessPoints. +The returned array is owned by the client and should not be modified.

+

[element-type NMAccessPoint]

+
+
+
+
+

nm_device_wifi_request_scan ()

+
gboolean
+nm_device_wifi_request_scan (NMDeviceWifi *device,
+                             GCancellable *cancellable,
+                             GError **error);
+

Request NM to scan for access points on device +. Note that the function returns immediately after requesting the scan, and it may take some time -after that for the scan to complete. -

-
+after that for the scan to complete.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + + - - + + +

device :

a NMDeviceWifi -

cancellable :

a GCancellable, or NULL -

device

a NMDeviceWifi

 

error :

location for a GError, or NULL -

cancellable

a GCancellable, or NULL

 

Returns :

-TRUE on success, FALSE on error, in which case error will be -set.

error

location for a GError, or NULL

 
+
+

Returns

+

TRUE on success, FALSE on error, in which case error +will be +set.

+

+
+

-

nm_device_wifi_request_scan_async ()

-
void                nm_device_wifi_request_scan_async   (NMDeviceWifi *device,
-                                                         GCancellable *cancellable,
-                                                         GAsyncReadyCallback callback,
-                                                         gpointer user_data);
-

-Request NM to scan for access points on device. Note that callback will be +

nm_device_wifi_request_scan_async ()

+
void
+nm_device_wifi_request_scan_async (NMDeviceWifi *device,
+                                   GCancellable *cancellable,
+                                   GAsyncReadyCallback callback,
+                                   gpointer user_data);
+

Request NM to scan for access points on device +. Note that callback + will be called immediately after requesting the scan, and it may take some time after -that for the scan to complete. -

-
+that for the scan to complete.

+
+

Parameters

+
--+++ - - + + + - - + + + - - + + + - - + + +

device :

a NMDeviceWifi -

device

a NMDeviceWifi

 

cancellable :

a GCancellable, or NULL -

cancellable

a GCancellable, or NULL

 

callback :

callback to be called when the scan has been requested

callback

callback to be called when the scan has been requested

 

user_data :

caller-specific data passed to callback -

user_data

caller-specific data passed to callback +

 
+

-

nm_device_wifi_request_scan_finish ()

-
gboolean            nm_device_wifi_request_scan_finish  (NMDeviceWifi *device,
-                                                         GAsyncResult *result,
-                                                         GError **error);
-

-Gets the result of a call to nm_device_wifi_request_scan_async(). -

-
+

nm_device_wifi_request_scan_finish ()

+
gboolean
+nm_device_wifi_request_scan_finish (NMDeviceWifi *device,
+                                    GAsyncResult *result,
+                                    GError **error);
+

Gets the result of a call to nm_device_wifi_request_scan_async().

+
+

Parameters

+
--+++ - - - - - - + + + - - + + + - - + + +

device :

a NMDeviceWifi -

result :

the result passed to the GAsyncReadyCallback -

device

a NMDeviceWifi

 

error :

location for a GError, or NULL -

result

the result passed to the GAsyncReadyCallback

 

Returns :

-TRUE on success, FALSE on error, in which case error will be -set.

error

location for a GError, or NULL

 
+
+

Returns

+

TRUE on success, FALSE on error, in which case error +will be +set.

+

+
+
-

Property Details

+

Types and Values

-

The "access-points" property

-
  "access-points"            GPtrArray*            : Read
+

NM_DEVICE_WIFI_HW_ADDRESS

+
#define NM_DEVICE_WIFI_HW_ADDRESS          "hw-address"
+

-List of all Wi-Fi access points the device can see.

+
+
+
+

NM_DEVICE_WIFI_PERMANENT_HW_ADDRESS

+
#define NM_DEVICE_WIFI_PERMANENT_HW_ADDRESS "perm-hw-address"
+

-Element-type: NMAccessPoint


-

The "active-access-point" property

-
  "active-access-point"      NMAccessPoint*        : Read
+

NM_DEVICE_WIFI_MODE

+
#define NM_DEVICE_WIFI_MODE                "mode"
+

-The active NMAccessPoint of the device.


-

The "bitrate" property

-
  "bitrate"                  guint                 : Read
+

NM_DEVICE_WIFI_BITRATE

+
#define NM_DEVICE_WIFI_BITRATE             "bitrate"
+

-The bit rate of the device in kbit/s.

-

Default value: 0


-

The "hw-address" property

-
  "hw-address"               gchar*                : Read
+

NM_DEVICE_WIFI_ACTIVE_ACCESS_POINT

+
#define NM_DEVICE_WIFI_ACTIVE_ACCESS_POINT "active-access-point"
+

-The hardware (MAC) address of the device.

-

Default value: NULL


-

The "mode" property

-
  "mode"                     NM80211Mode           : Read
+

NM_DEVICE_WIFI_CAPABILITIES

+
#define NM_DEVICE_WIFI_CAPABILITIES        "wireless-capabilities"
+

-The mode of the device.

-

Default value: NM_802_11_MODE_UNKNOWN


-

The "perm-hw-address" property

-
  "perm-hw-address"          gchar*                : Read
+

NM_DEVICE_WIFI_ACCESS_POINTS

+
#define NM_DEVICE_WIFI_ACCESS_POINTS       "access-points"
+

-The hardware (MAC) address of the device.

+
+
+
+

Property Details

+
+

The “access-points” property

+
  “access-points”            GPtrArray *
+

+

Flags: Read

+
+
+
+

The “active-access-point” property

+
  “active-access-point”      NMAccessPoint *
+

+

Flags: Read

+
+
+
+

The “bitrate” property

+
  “bitrate”                  guint
+

+

Flags: Read

+

Default value: 0

+
+
+
+

The “hw-address” property

+
  “hw-address”               gchar *
+

+

Flags: Read

Default value: NULL


-

The "wireless-capabilities" property

-
  "wireless-capabilities"    NMDeviceWifiCapabilities  : Read
-

-The wireless capabilities of the device. -

+

The “mode” property

+
  “mode”                     NM80211Mode
+

+

Flags: Read

+

Default value: NM_802_11_MODE_UNKNOWN

+
+
+
+

The “perm-hw-address” property

+
  “perm-hw-address”          gchar *
+

+

Flags: Read

+

Default value: NULL

+
+
+
+

The “wireless-capabilities” property

+
  “wireless-capabilities”    NMDeviceWifiCapabilities
+

+

Flags: Read

Signal Details

-

The "access-point-added" signal

-
void                user_function                      (NMDeviceWifi *device,
-                                                        GObject      *ap,
-                                                        gpointer      user_data)      : Run First
-

-Notifies that a NMAccessPoint is added to the Wi-Fi device. -

-
---- - - - - - - - - - - - - - - -

device :

the Wi-Fi device that received the signal

ap :

the new access point

user_data :

user data set when the signal handler was connected.
+

The “access-point-added” signal

+
void
+user_function (NMDeviceWifi *device,
+               GObject      *ap,
+               gpointer      user_data)
+

Flags: Run First


-

The "access-point-removed" signal

-
void                user_function                      (NMDeviceWifi *device,
-                                                        GObject      *ap,
-                                                        gpointer      user_data)      : Run First
-

-Notifies that a NMAccessPoint is removed from the Wi-Fi device. -

-
---- - - - - - - - - - - - - - - -

device :

the Wi-Fi device that received the signal

ap :

the removed access point

user_data :

user data set when the signal handler was connected.
+

The “access-point-removed” signal

+
void
+user_function (NMDeviceWifi *device,
+               GObject      *ap,
+               gpointer      user_data)
+

Flags: Run First

+ Generated by GTK-Doc V1.21
\ No newline at end of file diff --git a/docs/libnm/html/NMDeviceWimax.html b/docs/libnm/html/NMDeviceWimax.html index 2a97f81d..f1d58b57 100644 --- a/docs/libnm/html/NMDeviceWimax.html +++ b/docs/libnm/html/NMDeviceWimax.html @@ -2,38 +2,29 @@ -NMDeviceWimax +libnm Reference Manual: NMDeviceWimax - + - - - - - - - - - - + + + + + + +
@@ -41,557 +32,640 @@

NMDeviceWimax

NMDeviceWimax

- +
- -
-

Object Hierarchy

-
-  GObject
-   +----NMObject
-         +----NMDevice
-               +----NMDeviceWimax
-
-
-

Implemented Interfaces

-

-NMDeviceWimax implements - GInitable and GAsyncInitable.

+

Functions

+
++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
const char * + +nm_device_wimax_get_hw_address () +
+NMWimaxNsp * + +nm_device_wimax_get_active_nsp () +
+NMWimaxNsp * + +nm_device_wimax_get_nsp_by_path () +
const GPtrArray * + +nm_device_wimax_get_nsps () +
+guint + +nm_device_wimax_get_center_frequency () +
+gint + +nm_device_wimax_get_rssi () +
+gint + +nm_device_wimax_get_cinr () +
+gint + +nm_device_wimax_get_tx_power () +
const char * + +nm_device_wimax_get_bsid () +

Properties

-
-  "active-nsp"               NMWimaxNsp*           : Read
-  "bsid"                     gchar*                : Read
-  "center-frequency"         guint                 : Read
-  "cinr"                     gint                  : Read
-  "hw-address"               gchar*                : Read
-  "nsps"                     GPtrArray*            : Read
-  "rssi"                     gint                  : Read
-  "tx-power"                 gint                  : Read
-
-
-
-

Signals

-
-  "nsp-added"                                      : Run First
-  "nsp-removed"                                    : Run First
-
-
-
-

Description

-

-

-
-
-

Details

-
-

NM_DEVICE_WIMAX_HW_ADDRESS

-
#define NM_DEVICE_WIMAX_HW_ADDRESS       "hw-address"
-
-

-

-
-
-
-

NM_DEVICE_WIMAX_ACTIVE_NSP

-
#define NM_DEVICE_WIMAX_ACTIVE_NSP       "active-nsp"
-
-

-

-
-
-
-

NM_DEVICE_WIMAX_CENTER_FREQUENCY

-
#define NM_DEVICE_WIMAX_CENTER_FREQUENCY "center-frequency"
-
-

-

-
-
-
-

NM_DEVICE_WIMAX_RSSI

-
#define NM_DEVICE_WIMAX_RSSI             "rssi"
-
-

-

-
-
-
-

NM_DEVICE_WIMAX_CINR

-
#define NM_DEVICE_WIMAX_CINR             "cinr"
-
-

-

-
-
-
-

NM_DEVICE_WIMAX_TX_POWER

-
#define NM_DEVICE_WIMAX_TX_POWER         "tx-power"
-
-

-

-
-
-
-

NM_DEVICE_WIMAX_BSID

-
#define NM_DEVICE_WIMAX_BSID             "bsid"
-
-

-

-
-
-
-

NM_DEVICE_WIMAX_NSPS

-
#define NM_DEVICE_WIMAX_NSPS             "nsps"
-
-

-

-
-
-
-

struct NMDeviceWimax

-
struct NMDeviceWimax;
-

-

-
-
-
-

NMDeviceWimaxClass

-
typedef struct {
-	NMDeviceClass parent;
-
-	/* Signals */
-	void (*nsp_added)   (NMDeviceWimax *self, NMWimaxNsp *nsp);
-	void (*nsp_removed) (NMDeviceWimax *self, NMWimaxNsp *nsp);
-} NMDeviceWimaxClass;
-
-

-

-
-
-
-

nm_device_wimax_get_hw_address ()

-
const char *        nm_device_wimax_get_hw_address      (NMDeviceWimax *wimax);
-

-Gets the hardware (MAC) address of the NMDeviceWimax -

-
+
--+++ - - + + + + + + + + + + + + + + + + + + + + + + + - - + + + + + + + + + + + + +

wimax :

a NMDeviceWimax - +NMWimaxNsp *active-nspRead
+gchar *bsidRead
guintcenter-frequencyRead
gintcinrRead
+gchar *hw-addressRead

Returns :

the hardware address. This is the internal string used by the -device, and must not be modified. +GPtrArray *nspsRead
gintrssiRead
ginttx-powerRead
-
-
-

nm_device_wimax_get_active_nsp ()

-
NMWimaxNsp *        nm_device_wimax_get_active_nsp      (NMDeviceWimax *wimax);
-

-Gets the active NMWimaxNsp. -

-
+
+

Signals

+
--+++ - - + + + - - + + +

wimax :

a NMDeviceWimax -voidnsp-addedRun First

Returns :

the access point or NULL if none is active. [transfer full] -voidnsp-removedRun First
-
-
-

nm_device_wimax_get_nsp_by_path ()

-
NMWimaxNsp *        nm_device_wimax_get_nsp_by_path     (NMDeviceWimax *wimax,
-                                                         const char *path);
-

-Gets a NMWimaxNsp by path. -

-
+
+

Types and Values

+
--++ - - + + - - + + - - + + + + + + + + + + + + + + + + + + + + + +

wimax :

a NMDeviceWimax -#defineNM_DEVICE_WIMAX_HW_ADDRESS

path :

the object path of the NSP#defineNM_DEVICE_WIMAX_ACTIVE_NSP

Returns :

the access point or NULL if none is found. [transfer none] -#defineNM_DEVICE_WIMAX_CENTER_FREQUENCY
#defineNM_DEVICE_WIMAX_RSSI
#defineNM_DEVICE_WIMAX_CINR
#defineNM_DEVICE_WIMAX_TX_POWER
#defineNM_DEVICE_WIMAX_BSID
#defineNM_DEVICE_WIMAX_NSPS
-
-
-

nm_device_wimax_get_nsps ()

-
const GPtrArray *   nm_device_wimax_get_nsps            (NMDeviceWimax *wimax);
+
+

Object Hierarchy

+
    GObject
+    ╰── NMObject
+        ╰── NMDevice
+            ╰── NMDeviceWimax
+
+
+
+

Description

-Gets all the scanned NSPs of the NMDeviceWimax.

-
+ +
+

Functions

+
+

nm_device_wimax_get_hw_address ()

+
const char *
+nm_device_wimax_get_hw_address (NMDeviceWimax *wimax);
+

Gets the hardware (MAC) address of the NMDeviceWimax

+
+

Parameters

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

wimax

a NMDeviceWimax

 
+
+
+

Returns

+

the hardware address. This is the internal string used by the +device, and must not be modified.

+

+
+
+
+
+

nm_device_wimax_get_active_nsp ()

+
NMWimaxNsp *
+nm_device_wimax_get_active_nsp (NMDeviceWimax *wimax);
+

Gets the active NMWimaxNsp.

+
+

Parameters

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

wimax

a NMDeviceWimax

 
+
+
+

Returns

+

the access point or NULL if none is active.

+

[transfer full]

+
+
+
+
+

nm_device_wimax_get_nsp_by_path ()

+
NMWimaxNsp *
+nm_device_wimax_get_nsp_by_path (NMDeviceWimax *wimax,
+                                 const char *path);
+

Gets a NMWimaxNsp by path.

+
+

Parameters

+
--+++ - - + + + - - + + +

wimax :

a NMDeviceWimax -

wimax

a NMDeviceWimax

 

Returns :

a GPtrArray containing -all the scanned NMWimaxNsps. -The returned array is owned by the client and should not be modified. [element-type NMWimaxNsp] -

path

the object path of the NSP

 
+
+

Returns

+

the access point or NULL if none is found.

+

[transfer none]

+
+

-

nm_device_wimax_get_center_frequency ()

-
guint               nm_device_wimax_get_center_frequency
-                                                        (NMDeviceWimax *self);
-

-Gets the center frequency (in KHz) of the radio channel the device is using +

nm_device_wimax_get_nsps ()

+
const GPtrArray *
+nm_device_wimax_get_nsps (NMDeviceWimax *wimax);
+

Gets all the scanned NSPs of the NMDeviceWimax.

+
+

Parameters

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

wimax

a NMDeviceWimax

 
+
+
+

Returns

+

a GPtrArray containing +all the scanned NMWimaxNsps. +The returned array is owned by the client and should not be modified.

+

[element-type NMWimaxNsp]

+
+
+
+
+

nm_device_wimax_get_center_frequency ()

+
guint
+nm_device_wimax_get_center_frequency (NMDeviceWimax *self);
+

Gets the center frequency (in KHz) of the radio channel the device is using to communicate with the network when connected. Has no meaning when the -device is not connected. -

-
+device is not connected.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

self :

a NMDeviceWimax -

Returns :

the center frequency in KHz, or 0

self

a NMDeviceWimax

 
+
+

Returns

+

the center frequency in KHz, or 0

+

+
+

-

nm_device_wimax_get_rssi ()

-
gint                nm_device_wimax_get_rssi            (NMDeviceWimax *self);
-

-Gets the RSSI of the current radio link in dBm. This value indicates how +

nm_device_wimax_get_rssi ()

+
gint
+nm_device_wimax_get_rssi (NMDeviceWimax *self);
+

Gets the RSSI of the current radio link in dBm. This value indicates how strong the raw received RF signal from the base station is, but does not indicate the overall quality of the radio link. Has no meaning when the -device is not connected. -

-
+device is not connected.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

self :

a NMDeviceWimax -

Returns :

the RSSI in dBm, or 0

self

a NMDeviceWimax

 
+
+

Returns

+

the RSSI in dBm, or 0

+

+
+

-

nm_device_wimax_get_cinr ()

-
gint                nm_device_wimax_get_cinr            (NMDeviceWimax *self);
-

-Gets the CINR (Carrier to Interference + Noise Ratio) of the current radio +

nm_device_wimax_get_cinr ()

+
gint
+nm_device_wimax_get_cinr (NMDeviceWimax *self);
+

Gets the CINR (Carrier to Interference + Noise Ratio) of the current radio link in dB. CINR is a more accurate measure of radio link quality. Has no -meaning when the device is not connected. -

-
+meaning when the device is not connected.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

self :

a NMDeviceWimax -

Returns :

the CINR in dB, or 0

self

a NMDeviceWimax

 
+
+

Returns

+

the CINR in dB, or 0

+

+
+

-

nm_device_wimax_get_tx_power ()

-
gint                nm_device_wimax_get_tx_power        (NMDeviceWimax *self);
-

-Average power of the last burst transmitted by the device, in units of +

nm_device_wimax_get_tx_power ()

+
gint
+nm_device_wimax_get_tx_power (NMDeviceWimax *self);
+

Average power of the last burst transmitted by the device, in units of 0.5 dBm. i.e. a TxPower of -11 represents an actual device TX power of --5.5 dBm. Has no meaning when the device is not connected. -

-
+-5.5 dBm. Has no meaning when the device is not connected.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

self :

a NMDeviceWimax -

Returns :

the TX power in dBm, or 0

self

a NMDeviceWimax

 
+
+

Returns

+

the TX power in dBm, or 0

+

+
+

-

nm_device_wimax_get_bsid ()

-
const char *        nm_device_wimax_get_bsid            (NMDeviceWimax *self);
-

-Gets the ID of the serving Base Station when the device is connected. -

-
+

nm_device_wimax_get_bsid ()

+
const char *
+nm_device_wimax_get_bsid (NMDeviceWimax *self);
+

Gets the ID of the serving Base Station when the device is connected.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

self :

a NMDeviceWimax -

Returns :

the ID of the serving Base Station, or NULL -

self

a NMDeviceWimax

 
+
+

Returns

+

the ID of the serving Base Station, or NULL

+

+
+
-

Property Details

+

Types and Values

-

The "active-nsp" property

-
  "active-nsp"               NMWimaxNsp*           : Read
+

NM_DEVICE_WIMAX_HW_ADDRESS

+
#define NM_DEVICE_WIMAX_HW_ADDRESS       "hw-address"
+

-The active NMWimaxNsp of the device.


-

The "bsid" property

-
  "bsid"                     gchar*                : Read
+

NM_DEVICE_WIMAX_ACTIVE_NSP

+
#define NM_DEVICE_WIMAX_ACTIVE_NSP       "active-nsp"
+

-The ID of the serving base station as received from the network. Has -no meaning when the device is not connected.

-

Default value: NULL


-

The "center-frequency" property

-
  "center-frequency"         guint                 : Read
+

NM_DEVICE_WIMAX_CENTER_FREQUENCY

+
#define NM_DEVICE_WIMAX_CENTER_FREQUENCY "center-frequency"
+

-The center frequency (in KHz) of the radio channel the device is using to -communicate with the network when connected. Has no meaning when the -device is not connected.

-

Default value: 0


-

The "cinr" property

-
  "cinr"                     gint                  : Read
+

NM_DEVICE_WIMAX_RSSI

+
#define NM_DEVICE_WIMAX_RSSI             "rssi"
+

-CINR (Carrier to Interference + Noise Ratio) of the current radio link -in dB. CINR is a more accurate measure of radio link quality. Has no -meaning when the device is not connected.

-

Default value: 0


-

The "hw-address" property

-
  "hw-address"               gchar*                : Read
+

NM_DEVICE_WIMAX_CINR

+
#define NM_DEVICE_WIMAX_CINR             "cinr"
+

-The hardware (MAC) address of the device.

-

Default value: NULL


-

The "nsps" property

-
  "nsps"                     GPtrArray*            : Read
+

NM_DEVICE_WIMAX_TX_POWER

+
#define NM_DEVICE_WIMAX_TX_POWER         "tx-power"
+

-List of all WiMAX Network Service Providers the device can see.

+
+
+
+

NM_DEVICE_WIMAX_BSID

+
#define NM_DEVICE_WIMAX_BSID             "bsid"
+

-Element-type: NMWimaxNsp


-

The "rssi" property

-
  "rssi"                     gint                  : Read
+

NM_DEVICE_WIMAX_NSPS

+
#define NM_DEVICE_WIMAX_NSPS             "nsps"
+

-RSSI of the current radio link in dBm. This value indicates how strong -the raw received RF signal from the base station is, but does not -indicate the overall quality of the radio link. Has no meaning when the -device is not connected.

+
+
+
+

Property Details

+
+

The “active-nsp” property

+
  “active-nsp”               NMWimaxNsp *
+

+

Flags: Read

+
+
+
+

The “bsid” property

+
  “bsid”                     gchar *
+

+

Flags: Read

+

Default value: NULL

+
+
+
+

The “center-frequency” property

+
  “center-frequency”         guint
+

+

Flags: Read

Default value: 0


-

The "tx-power" property

-
  "tx-power"                 gint                  : Read
-

-Average power of the last burst transmitted by the device, in units of -0.5 dBm. i.e. a TxPower of -11 represents an actual device TX power of --5.5 dBm. Has no meaning when the device is not connected. -

+

The “cinr” property

+
  “cinr”                     gint
+

+

Flags: Read

+

Default value: 0

+
+
+
+

The “hw-address” property

+
  “hw-address”               gchar *
+

+

Flags: Read

+

Default value: NULL

+
+
+
+

The “nsps” property

+
  “nsps”                     GPtrArray *
+

+

Flags: Read

+
+
+
+

The “rssi” property

+
  “rssi”                     gint
+

+

Flags: Read

+

Default value: 0

+
+
+
+

The “tx-power” property

+
  “tx-power”                 gint
+

+

Flags: Read

Default value: 0

Signal Details

-

The "nsp-added" signal

-
void                user_function                      (NMDeviceWimax *self,
-                                                        GObject       *nsp,
-                                                        gpointer       user_data)      : Run First
-

-Notifies that a NMWimaxNsp is added to the wimax device. -

-
---- - - - - - - - - - - - - - - -

self :

the wimax device that received the signal

nsp :

the new NSP

user_data :

user data set when the signal handler was connected.
+

The “nsp-added” signal

+
void
+user_function (NMDeviceWimax *self,
+               GObject       *nsp,
+               gpointer       user_data)
+

Flags: Run First


-

The "nsp-removed" signal

-
void                user_function                      (NMDeviceWimax *self,
-                                                        GObject       *nsp,
-                                                        gpointer       user_data)      : Run First
-

-Notifies that a NMWimaxNsp is removed from the wimax device. -

-
---- - - - - - - - - - - - - - - -

self :

the wimax device that received the signal

nsp :

the removed NSP

user_data :

user data set when the signal handler was connected.
+

The “nsp-removed” signal

+
void
+user_function (NMDeviceWimax *self,
+               GObject       *nsp,
+               gpointer       user_data)
+

Flags: Run First

+ Generated by GTK-Doc V1.21
\ No newline at end of file diff --git a/docs/libnm/html/NMDhcpConfig.html b/docs/libnm/html/NMDhcpConfig.html index 3a48d730..3a4a0229 100644 --- a/docs/libnm/html/NMDhcpConfig.html +++ b/docs/libnm/html/NMDhcpConfig.html @@ -2,36 +2,28 @@ -NMDhcpConfig +libnm Reference Manual: NMDhcpConfig - + - - - - - - - - - - + + + + + + +
@@ -39,39 +31,89 @@

NMDhcpConfig

NMDhcpConfig

- +
-
-

Synopsis

-
struct              NMDhcpConfig;
-                    NMDhcpConfigClass;
-#define             NM_DHCP_CONFIG_FAMILY
-#define             NM_DHCP_CONFIG_OPTIONS
-int                 nm_dhcp_config_get_family           (NMDhcpConfig *config);
-GHashTable *        nm_dhcp_config_get_options          (NMDhcpConfig *config);
-const char *        nm_dhcp_config_get_one_option       (NMDhcpConfig *config,
-                                                         const char *option);
-
+
+

Functions

+
++++ + + + + + + + + + + + + + + +
+int + +nm_dhcp_config_get_family () +
+GHashTable * + +nm_dhcp_config_get_options () +
const char * + +nm_dhcp_config_get_one_option () +
-

Object Hierarchy

-
-  GObject
-   +----NMObject
-         +----NMDhcpConfig
-
+

Properties

+
+++++ + + + + + + + + + + + + +
gintfamilyRead
+GHashTable *optionsRead
-

Implemented Interfaces

-

-NMDhcpConfig implements - GInitable and GAsyncInitable.

+

Types and Values

+
++++ + + + + + + + + + + +
#defineNM_DHCP_CONFIG_FAMILY
#defineNM_DHCP_CONFIG_OPTIONS
-

Properties

-
-  "family"                   gint                  : Read
-  "options"                  GHashTable*           : Read
+

Object Hierarchy

+
    GObject
+    ╰── NMObject
+        ╰── NMDhcpConfig
 
@@ -80,153 +122,139 @@ NMDhcpConfig implements

-

Details

+

Functions

-

struct NMDhcpConfig

-
struct NMDhcpConfig;
-

-

+

nm_dhcp_config_get_family ()

+
int
+nm_dhcp_config_get_family (NMDhcpConfig *config);
+

Gets the IP address family of the configuration

+
+

Parameters

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

config

a NMDhcpConfig

 
-
-
-

NMDhcpConfigClass

-
typedef struct {
-	NMObjectClass parent;
-} NMDhcpConfigClass;
-
-

-

+
+

Returns

+

the IP address family; either AF_INET or +AF_INET6

+

-
-
-

NM_DHCP_CONFIG_FAMILY

-
#define NM_DHCP_CONFIG_FAMILY  "family"
-
-

-


-

NM_DHCP_CONFIG_OPTIONS

-
#define NM_DHCP_CONFIG_OPTIONS "options"
-
-

-

+

nm_dhcp_config_get_options ()

+
GHashTable *
+nm_dhcp_config_get_options (NMDhcpConfig *config);
+

Gets all the options contained in the configuration.

+
+

Parameters

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

config

a NMDhcpConfig

 
+
+
+

Returns

+

the GHashTable containing +strings for keys and values. This is the internal copy used by the +configuration, and must not be modified.

+

[transfer none][element-type utf8 utf8]

+

-

nm_dhcp_config_get_family ()

-
int                 nm_dhcp_config_get_family           (NMDhcpConfig *config);
-

-Gets the IP address family of the configuration -

-
+

nm_dhcp_config_get_one_option ()

+
const char *
+nm_dhcp_config_get_one_option (NMDhcpConfig *config,
+                               const char *option);
+

Gets one option by option name.

+
+

Parameters

+
--+++ - - + + + - - + + +

config :

a NMDhcpConfig -

config

a NMDhcpConfig

 

Returns :

the IP address family; either AF_INET or -AF_INET6 -

option

the option to retrieve

 
-
+
+

Returns

+

the configuration option's value. This is the internal string used by the +configuration, and must not be modified.

+

+
+
+
+
+

Types and Values

-

nm_dhcp_config_get_options ()

-
GHashTable *        nm_dhcp_config_get_options          (NMDhcpConfig *config);
+

NM_DHCP_CONFIG_FAMILY

+
#define NM_DHCP_CONFIG_FAMILY  "family"
+

-Gets all the options contained in the configuration.

-
---- - - - - - - - - - - -

config :

a NMDhcpConfig -

Returns :

the GHashTable containing -strings for keys and values. This is the internal copy used by the -configuration, and must not be modified. [transfer none][element-type utf8 utf8] -

-

nm_dhcp_config_get_one_option ()

-
const char *        nm_dhcp_config_get_one_option       (NMDhcpConfig *config,
-                                                         const char *option);
+

NM_DHCP_CONFIG_OPTIONS

+
#define NM_DHCP_CONFIG_OPTIONS "options"
+

-Gets one option by option name.

-
---- - - - - - - - - - - - - - - -

config :

a NMDhcpConfig -

option :

the option to retrieve

Returns :

the configuration option's value. This is the internal string used by the -configuration, and must not be modified.

Property Details

-

The "family" property

-
  "family"                   gint                  : Read
-

-The IP address family of the configuration; either -AF_INET or AF_INET6. -

+

The “family” property

+
  “family”                   gint
+

+

Flags: Read

Allowed values: [0,255]

Default value: 0


-

The "options" property

-
  "options"                  GHashTable*           : Read
-

-The GHashTable containing options of the configuration. -

-

-Type: GLib.HashTable(utf8,utf8) -

+

The “options” property

+
  “options”                  GHashTable *
+

+

Flags: Read

+ Generated by GTK-Doc V1.21
\ No newline at end of file diff --git a/docs/libnm/html/NMIPConfig.html b/docs/libnm/html/NMIPConfig.html index 83ede1e4..a93213ab 100644 --- a/docs/libnm/html/NMIPConfig.html +++ b/docs/libnm/html/NMIPConfig.html @@ -2,36 +2,28 @@ -NMIPConfig +libnm Reference Manual: NMIPConfig - + - - - - - - - - - - + + + + + + +
@@ -39,55 +31,181 @@

NMIPConfig

NMIPConfig

- +
-
-

Synopsis

-
struct              NMIPConfig;
-                    NMIPConfigClass;
-#define             NM_IP_CONFIG_FAMILY
-#define             NM_IP_CONFIG_GATEWAY
-#define             NM_IP_CONFIG_ADDRESSES
-#define             NM_IP_CONFIG_ROUTES
-#define             NM_IP_CONFIG_NAMESERVERS
-#define             NM_IP_CONFIG_DOMAINS
-#define             NM_IP_CONFIG_SEARCHES
-#define             NM_IP_CONFIG_WINS_SERVERS
-int                 nm_ip_config_get_family             (NMIPConfig *config);
-const char *        nm_ip_config_get_gateway            (NMIPConfig *config);
-GPtrArray *         nm_ip_config_get_addresses          (NMIPConfig *config);
-GPtrArray *         nm_ip_config_get_routes             (NMIPConfig *config);
-const char * const * nm_ip_config_get_nameservers       (NMIPConfig *config);
-const char * const * nm_ip_config_get_domains           (NMIPConfig *config);
-const char * const * nm_ip_config_get_searches          (NMIPConfig *config);
-const char * const * nm_ip_config_get_wins_servers      (NMIPConfig *config);
-
+
+

Functions

+
++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+int + +nm_ip_config_get_family () +
const char * + +nm_ip_config_get_gateway () +
+GPtrArray * + +nm_ip_config_get_addresses () +
+GPtrArray * + +nm_ip_config_get_routes () +
const char * const * + +nm_ip_config_get_nameservers () +
const char * const * + +nm_ip_config_get_domains () +
const char * const * + +nm_ip_config_get_searches () +
const char * const * + +nm_ip_config_get_wins_servers () +
-

Object Hierarchy

-
-  GObject
-   +----NMObject
-         +----NMIPConfig
-
+

Properties

+
+++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+GPtrArray *addressesRead
GStrvdomainsRead
gintfamilyRead
+gchar *gatewayRead
GStrvnameserversRead
+GPtrArray *routesRead
GStrvsearchesRead
GStrvwins-serversRead
-

Implemented Interfaces

-

-NMIPConfig implements - GInitable and GAsyncInitable.

+

Types and Values

+
++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
#defineNM_IP_CONFIG_FAMILY
#defineNM_IP_CONFIG_GATEWAY
#defineNM_IP_CONFIG_ADDRESSES
#defineNM_IP_CONFIG_ROUTES
#defineNM_IP_CONFIG_NAMESERVERS
#defineNM_IP_CONFIG_DOMAINS
#defineNM_IP_CONFIG_SEARCHES
#defineNM_IP_CONFIG_WINS_SERVERS
-

Properties

-
-  "addresses"                GPtrArray*            : Read
-  "domains"                  GStrv                 : Read
-  "family"                   gint                  : Read
-  "gateway"                  gchar*                : Read
-  "nameservers"              GStrv                 : Read
-  "routes"                   GPtrArray*            : Read
-  "searches"                 GStrv                 : Read
-  "wins-servers"             GStrv                 : Read
+

Object Hierarchy

+
    GObject
+    ╰── NMObject
+        ╰── NMIPConfig
 
@@ -96,25 +214,234 @@ NMIPConfig implements

-

Details

+

Functions

-

struct NMIPConfig

-
struct NMIPConfig;
-

-

+

nm_ip_config_get_family ()

+
int
+nm_ip_config_get_family (NMIPConfig *config);
+

Gets the IP address family

+
+

Parameters

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

config

a NMIPConfig

 
+
+
+

Returns

+

the IP address family; either AF_INET or +AF_INET6

+

+

-

NMIPConfigClass

-
typedef struct {
-	NMObjectClass parent;
-} NMIPConfigClass;
-
-

-

+

nm_ip_config_get_gateway ()

+
const char *
+nm_ip_config_get_gateway (NMIPConfig *config);
+

Gets the IP gateway address.

+
+

Parameters

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

config

a NMIPConfig

 
+
+
+

Returns

+

the IP address of the gateway.

+

[transfer none]

+

+

nm_ip_config_get_addresses ()

+
GPtrArray *
+nm_ip_config_get_addresses (NMIPConfig *config);
+

Gets the IP addresses (containing the address, prefix, and gateway).

+
+

Parameters

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

config

a NMIPConfig

 
+
+
+

Returns

+

the GPtrArray +containing NMIPAddresses. This is the internal copy used by the +configuration and must not be modified.

+

[element-type NMIPAddress][transfer none]

+
+
+
+
+

nm_ip_config_get_routes ()

+
GPtrArray *
+nm_ip_config_get_routes (NMIPConfig *config);
+

Gets the routes.

+
+

Parameters

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

config

a NMIPConfig

 
+
+
+

Returns

+

the GPtrArray containing +NMIPRoutes. This is the internal copy used by the configuration, and must +not be modified.

+

[element-type NMIPRoute][transfer none]

+
+
+
+
+

nm_ip_config_get_nameservers ()

+
const char * const *
+nm_ip_config_get_nameservers (NMIPConfig *config);
+

Gets the domain name servers (DNS).

+
+

Parameters

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

config

a NMIPConfig

 
+
+
+

Returns

+

the array of nameserver IP addresses.

+

[transfer none]

+
+
+
+
+

nm_ip_config_get_domains ()

+
const char * const *
+nm_ip_config_get_domains (NMIPConfig *config);
+

Gets the domain names.

+
+

Parameters

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

config

a NMIPConfig

 
+
+
+

Returns

+

the array of domains. +(This is never NULL, though it may be 0-length).

+

[transfer none]

+
+
+
+
+

nm_ip_config_get_searches ()

+
const char * const *
+nm_ip_config_get_searches (NMIPConfig *config);
+

Gets the DNS searches.

+
+

Parameters

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

config

a NMIPConfig

 
+
+
+

Returns

+

the array of DNS search strings. +(This is never NULL, though it may be 0-length).

+

[transfer none]

+
+
+
+
+

nm_ip_config_get_wins_servers ()

+
const char * const *
+nm_ip_config_get_wins_servers (NMIPConfig *config);
+

Gets the Windows Internet Name Service servers (WINS).

+
+

Parameters

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

config

a NMIPConfig

 
+
+
+

Returns

+

the arry of WINS server IP address strings. +(This is never NULL, though it may be 0-length.).

+

[transfer none]

+
+
+
+
+

Types and Values

+

NM_IP_CONFIG_FAMILY

#define NM_IP_CONFIG_FAMILY "family"
 
@@ -177,297 +504,71 @@ NMIPConfig implements

-
-
-

nm_ip_config_get_family ()

-
int                 nm_ip_config_get_family             (NMIPConfig *config);
-

-Gets the IP address family -

-
---- - - - - - - - - - - -

config :

a NMIPConfig -

Returns :

the IP address family; either AF_INET or -AF_INET6 -
-
-
-
-

nm_ip_config_get_gateway ()

-
const char *        nm_ip_config_get_gateway            (NMIPConfig *config);
-

-Gets the IP gateway address. -

-
---- - - - - - - - - - - -

config :

a NMIPConfig -

Returns :

the IP address of the gateway. [transfer none] -
-
-
-
-

nm_ip_config_get_addresses ()

-
GPtrArray *         nm_ip_config_get_addresses          (NMIPConfig *config);
-

-Gets the IP addresses (containing the address, prefix, and gateway). -

-
---- - - - - - - - - - - -

config :

a NMIPConfig -

Returns :

the GPtrArray -containing NMIPAddresses. This is the internal copy used by the -configuration and must not be modified. [element-type NMIPAddress][transfer none] -
-
-
-
-

nm_ip_config_get_routes ()

-
GPtrArray *         nm_ip_config_get_routes             (NMIPConfig *config);
-

-Gets the routes. -

-
---- - - - - - - - - - - -

config :

a NMIPConfig -

Returns :

the GPtrArray containing -NMIPRoutes. This is the internal copy used by the configuration, and must -not be modified. [element-type NMIPRoute][transfer none] -
-
-
-
-

nm_ip_config_get_nameservers ()

-
const char * const * nm_ip_config_get_nameservers       (NMIPConfig *config);
-

-Gets the domain name servers (DNS). -

-
---- - - - - - - - - - - -

config :

a NMIPConfig -

Returns :

the array of nameserver IP addresses. [transfer none] -
-
-
-
-

nm_ip_config_get_domains ()

-
const char * const * nm_ip_config_get_domains           (NMIPConfig *config);
-

-Gets the domain names. -

-
---- - - - - - - - - - - -

config :

a NMIPConfig -

Returns :

the array of domains. -(This is never NULL, though it may be 0-length). [transfer none] -
-
-
-
-

nm_ip_config_get_searches ()

-
const char * const * nm_ip_config_get_searches          (NMIPConfig *config);
-

-Gets the DNS searches. -

-
---- - - - - - - - - - - -

config :

a NMIPConfig -

Returns :

the array of DNS search strings. -(This is never NULL, though it may be 0-length). [transfer none] -
-
-
-
-

nm_ip_config_get_wins_servers ()

-
const char * const * nm_ip_config_get_wins_servers      (NMIPConfig *config);
-

-Gets the Windows Internet Name Service servers (WINS). -

-
---- - - - - - - - - - - -

config :

a NMIPConfig -

Returns :

the arry of WINS server IP address strings. -(This is never NULL, though it may be 0-length.). [transfer none] -
-

Property Details

-

The "addresses" property

-
  "addresses"                GPtrArray*            : Read
-

-A GPtrArray containing the addresses (NMIPAddress) of the configuration. -

+

The “addresses” property

+
  “addresses”                GPtrArray *
+

+

Flags: Read


-

The "domains" property

-
  "domains"                  GStrv                 : Read
-

-The array containing domain strings of the configuration. -

+

The “domains” property

+
  “domains”                  GStrv
+

+

Flags: Read


-

The "family" property

-
  "family"                   gint                  : Read
-

-The IP address family of the configuration; either -AF_INET or AF_INET6. -

+

The “family” property

+
  “family”                   gint
+

+

Flags: Read

Allowed values: [0,255]

Default value: 0


-

The "gateway" property

-
  "gateway"                  gchar*                : Read
-

-The IP gateway address of the configuration as string. -

+

The “gateway” property

+
  “gateway”                  gchar *
+

+

Flags: Read

Default value: NULL


-

The "nameservers" property

-
  "nameservers"              GStrv                 : Read
-

-The array containing name server IP addresses of the configuration. -

+

The “nameservers” property

+
  “nameservers”              GStrv
+

+

Flags: Read


-

The "routes" property

-
  "routes"                   GPtrArray*            : Read
-

-A GPtrArray containing the routes (NMIPRoute) of the configuration. -

+

The “routes” property

+
  “routes”                   GPtrArray *
+

+

Flags: Read


-

The "searches" property

-
  "searches"                 GStrv                 : Read
-

-The array containing DNS search strings of the configuration. -

+

The “searches” property

+
  “searches”                 GStrv
+

+

Flags: Read


-

The "wins-servers" property

-
  "wins-servers"             GStrv                 : Read
-

-The array containing WINS server IP addresses of the configuration. -(This will always be empty for IPv6 configurations.) -

+

The “wins-servers” property

+
  “wins-servers”             GStrv
+

+

Flags: Read

+ Generated by GTK-Doc V1.21
\ No newline at end of file diff --git a/docs/libnm/html/NMObject.html b/docs/libnm/html/NMObject.html index 84324d98..38da67a0 100644 --- a/docs/libnm/html/NMObject.html +++ b/docs/libnm/html/NMObject.html @@ -2,36 +2,28 @@ -NMObject +libnm Reference Manual: NMObject - + - - - - - - - - - - + + + + + + +
@@ -39,43 +31,83 @@

NMObject

NMObject

- +
-
-

Synopsis

-
#define             NM_OBJECT_PATH
-#define             NM_OBJECT_DBUS_CONNECTION
-struct              NMObject;
-                    NMObjectClass;
-const char *        nm_object_get_path                  (NMObject *object);
-
+
+

Functions

+
++++ + + + + +
const char * + +nm_object_get_path () +
-

Object Hierarchy

-
-  GObject
-   +----NMObject
-         +----NMAccessPoint
-         +----NMActiveConnection
-         +----NMDevice
-         +----NMDhcpConfig
-         +----NMIPConfig
-         +----NMRemoteConnection
-         +----NMWimaxNsp
-
+

Properties

+
+++++ + + + + + + + + + + + + + + + + + +
+GDBusConnection *dbus-connectionRead / Write / Construct Only
gbooleannm-running-internalRead
+gchar *pathRead / Write / Construct Only
-

Implemented Interfaces

-

-NMObject implements - GInitable and GAsyncInitable.

+

Types and Values

+
++++ + + + + + + + + + + +
#defineNM_OBJECT_PATH
#defineNM_OBJECT_DBUS_CONNECTION
-

Properties

-
-  "dbus-connection"          GDBusConnection*      : Read / Write / Construct Only
-  "nm-running-internal"      gboolean              : Read
-  "path"                     gchar*                : Read / Write / Construct Only
+

Object Hierarchy

+
    GObject
+    ╰── NMObject
+        ├── NMAccessPoint
+        ├── NMActiveConnection
+        ├── NMDevice
+        ├── NMDhcpConfig
+        ├── NMIPConfig
+        ├── NMRemoteConnection
+        ╰── NMWimaxNsp
 
@@ -84,7 +116,37 @@ NMObject implements

-

Details

+

Functions

+
+

nm_object_get_path ()

+
const char *
+nm_object_get_path (NMObject *object);
+

Gets the DBus path of the NMObject.

+
+

Parameters

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

object

a NMObject

 
+
+
+

Returns

+

the object's path. This is the internal string used by the +device, and must not be modified.

+

+
+
+
+
+

Types and Values

NM_OBJECT_PATH

#define NM_OBJECT_PATH "path"
@@ -100,89 +162,35 @@ NMObject implements
 

-
-
-

struct NMObject

-
struct NMObject;
-

-

-
-
-
-

NMObjectClass

-
typedef struct {
-	GObjectClass parent;
-
-	/* Methods */
-	void (*init_dbus) (NMObject *object);
-
-	/* The "object-creation-failed" method is PRIVATE for libnm and
-	 * is not meant for any external usage.  It indicates that an error
-	 * occured during creation of an object.
-	 */
-	void (*object_creation_failed) (NMObject *master_object,
-	                                const char *failed_path);
-} NMObjectClass;
-
-

-

-
-
-
-

nm_object_get_path ()

-
const char *        nm_object_get_path                  (NMObject *object);
-

-Gets the DBus path of the NMObject. -

-
---- - - - - - - - - - - -

object :

a NMObject -

Returns :

the object's path. This is the internal string used by the -device, and must not be modified.
-

Property Details

-

The "dbus-connection" property

-
  "dbus-connection"          GDBusConnection*      : Read / Write / Construct Only
-

-The GDBusConnection of the object. -

+

The “dbus-connection” property

+
  “dbus-connection”          GDBusConnection *
+

+

Flags: Read / Write / Construct Only


-

The "nm-running-internal" property

-
  "nm-running-internal"      gboolean              : Read
+

The “nm-running-internal” property

+
  “nm-running-internal”      gboolean

+

Flags: Read

Default value: FALSE


-

The "path" property

-
  "path"                     gchar*                : Read / Write / Construct Only
-

-The D-Bus object path. -

+

The “path” property

+
  “path”                     gchar *
+

+

Flags: Read / Write / Construct Only

Default value: NULL

+ Generated by GTK-Doc V1.21
\ No newline at end of file diff --git a/docs/libnm/html/NMRemoteConnection.html b/docs/libnm/html/NMRemoteConnection.html index 96e95e2e..0bead3ba 100644 --- a/docs/libnm/html/NMRemoteConnection.html +++ b/docs/libnm/html/NMRemoteConnection.html @@ -2,36 +2,28 @@ -NMRemoteConnection +libnm Reference Manual: NMRemoteConnection - + - - - - - - - - - - + + + + + + +
@@ -39,87 +31,185 @@

NMRemoteConnection

NMRemoteConnection

- +
-
-

Synopsis

-
#define             NM_REMOTE_CONNECTION_DBUS_CONNECTION
-#define             NM_REMOTE_CONNECTION_PATH
-#define             NM_REMOTE_CONNECTION_UNSAVED
-#define             NM_REMOTE_CONNECTION_VISIBLE
-struct              NMRemoteConnection;
-                    NMRemoteConnectionClass;
-gboolean            nm_remote_connection_commit_changes (NMRemoteConnection *connection,
-                                                         gboolean save_to_disk,
-                                                         GCancellable *cancellable,
-                                                         GError **error);
-void                nm_remote_connection_commit_changes_async
-                                                        (NMRemoteConnection *connection,
-                                                         gboolean save_to_disk,
-                                                         GCancellable *cancellable,
-                                                         GAsyncReadyCallback callback,
-                                                         gpointer user_data);
-gboolean            nm_remote_connection_commit_changes_finish
-                                                        (NMRemoteConnection *connection,
-                                                         GAsyncResult *result,
-                                                         GError **error);
-gboolean            nm_remote_connection_save           (NMRemoteConnection *connection,
-                                                         GCancellable *cancellable,
-                                                         GError **error);
-void                nm_remote_connection_save_async     (NMRemoteConnection *connection,
-                                                         GCancellable *cancellable,
-                                                         GAsyncReadyCallback callback,
-                                                         gpointer user_data);
-gboolean            nm_remote_connection_save_finish    (NMRemoteConnection *connection,
-                                                         GAsyncResult *result,
-                                                         GError **error);
-gboolean            nm_remote_connection_delete         (NMRemoteConnection *connection,
-                                                         GCancellable *cancellable,
-                                                         GError **error);
-void                nm_remote_connection_delete_async   (NMRemoteConnection *connection,
-                                                         GCancellable *cancellable,
-                                                         GAsyncReadyCallback callback,
-                                                         gpointer user_data);
-gboolean            nm_remote_connection_delete_finish  (NMRemoteConnection *connection,
-                                                         GAsyncResult *result,
-                                                         GError **error);
-GVariant *          nm_remote_connection_get_secrets    (NMRemoteConnection *connection,
-                                                         const char *setting_name,
-                                                         GCancellable *cancellable,
-                                                         GError **error);
-void                nm_remote_connection_get_secrets_async
-                                                        (NMRemoteConnection *connection,
-                                                         const char *setting_name,
-                                                         GCancellable *cancellable,
-                                                         GAsyncReadyCallback callback,
-                                                         gpointer user_data);
-GVariant *          nm_remote_connection_get_secrets_finish
-                                                        (NMRemoteConnection *connection,
-                                                         GAsyncResult *result,
-                                                         GError **error);
-gboolean            nm_remote_connection_get_unsaved    (NMRemoteConnection *connection);
-gboolean            nm_remote_connection_get_visible    (NMRemoteConnection *connection);
-
+
+

Functions

+
++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+gboolean + +nm_remote_connection_commit_changes () +
+void + +nm_remote_connection_commit_changes_async () +
+gboolean + +nm_remote_connection_commit_changes_finish () +
+gboolean + +nm_remote_connection_save () +
+void + +nm_remote_connection_save_async () +
+gboolean + +nm_remote_connection_save_finish () +
+gboolean + +nm_remote_connection_delete () +
+void + +nm_remote_connection_delete_async () +
+gboolean + +nm_remote_connection_delete_finish () +
+GVariant * + +nm_remote_connection_get_secrets () +
+void + +nm_remote_connection_get_secrets_async () +
+GVariant * + +nm_remote_connection_get_secrets_finish () +
+gboolean + +nm_remote_connection_get_unsaved () +
+gboolean + +nm_remote_connection_get_visible () +
-

Object Hierarchy

-
-  GObject
-   +----NMObject
-         +----NMRemoteConnection
-
+

Properties

+
+++++ + + + + + + + + + + + + +
gbooleanunsavedRead
gbooleanvisibleRead
-

Implemented Interfaces

-

-NMRemoteConnection implements - GInitable, GAsyncInitable and NMConnection.

+

Types and Values

+
-

Properties

-
-  "unsaved"                  gboolean              : Read
-  "visible"                  gboolean              : Read
+

Object Hierarchy

+
    GObject
+    ╰── NMObject
+        ╰── NMRemoteConnection
 
@@ -128,634 +218,675 @@ NMRemoteConnection implements

-

Details

-
-

NM_REMOTE_CONNECTION_DBUS_CONNECTION

-
#define NM_REMOTE_CONNECTION_DBUS_CONNECTION "dbus-connection"
-
-

-

-
-
-
-

NM_REMOTE_CONNECTION_PATH

-
#define NM_REMOTE_CONNECTION_PATH            "path"
-
-

-

-
-
+

Functions

-

NM_REMOTE_CONNECTION_UNSAVED

-
#define NM_REMOTE_CONNECTION_UNSAVED         "unsaved"
-
-

-

-
-
-
-

NM_REMOTE_CONNECTION_VISIBLE

-
#define NM_REMOTE_CONNECTION_VISIBLE         "visible"
-
-

-

-
-
-
-

struct NMRemoteConnection

-
struct NMRemoteConnection;
-

-

-
-
-
-

NMRemoteConnectionClass

-
typedef struct {
-	NMObjectClass parent_class;
-} NMRemoteConnectionClass;
-
-

-

-
-
-
-

nm_remote_connection_commit_changes ()

-
gboolean            nm_remote_connection_commit_changes (NMRemoteConnection *connection,
-                                                         gboolean save_to_disk,
-                                                         GCancellable *cancellable,
-                                                         GError **error);
-

-Send any local changes to the settings and properties of connection to -NetworkManager. If save_to_disk is TRUE, the updated connection will be saved to -disk; if FALSE, then only the in-memory representation will be changed. -

-
+

nm_remote_connection_commit_changes ()

+
gboolean
+nm_remote_connection_commit_changes (NMRemoteConnection *connection,
+                                     gboolean save_to_disk,
+                                     GCancellable *cancellable,
+                                     GError **error);
+

Send any local changes to the settings and properties of connection + to +NetworkManager. If save_to_disk + is TRUE, the updated connection will be saved to +disk; if FALSE, then only the in-memory representation will be changed.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + + - - + + + - - + + +

connection :

the NMRemoteConnection -

save_to_disk :

whether to persist the changes to disk

connection

the NMRemoteConnection

 

cancellable :

a GCancellable, or NULL -

save_to_disk

whether to persist the changes to disk

 

error :

location for a GError, or NULL -

cancellable

a GCancellable, or NULL

 

Returns :

-TRUE on success, FALSE on error, in which case error will be set.

error

location for a GError, or NULL

 
+
+

Returns

+

TRUE on success, FALSE on error, in which case error +will be set.

+

+
+

-

nm_remote_connection_commit_changes_async ()

-
void                nm_remote_connection_commit_changes_async
-                                                        (NMRemoteConnection *connection,
-                                                         gboolean save_to_disk,
-                                                         GCancellable *cancellable,
-                                                         GAsyncReadyCallback callback,
-                                                         gpointer user_data);
-

-Asynchronously sends any local changes to the settings and properties of -connection to NetworkManager. If save is TRUE, the updated connection will -be saved to disk; if FALSE, then only the in-memory representation will be -changed. -

-
+

nm_remote_connection_commit_changes_async ()

+
void
+nm_remote_connection_commit_changes_async
+                               (NMRemoteConnection *connection,
+                                gboolean save_to_disk,
+                                GCancellable *cancellable,
+                                GAsyncReadyCallback callback,
+                                gpointer user_data);
+

Asynchronously sends any local changes to the settings and properties of +connection + to NetworkManager. If save + is TRUE, the updated connection will +be saved to disk; if FALSE, then only the in-memory representation will be +changed.

+
+

Parameters

+
--+++ - - + + + - - + + + - - + + + - - + + + - - + + +

connection :

the NMRemoteConnection -

connection

the NMRemoteConnection

 

save_to_disk :

whether to save the changes to persistent storage

save_to_disk

whether to save the changes to persistent storage

 

cancellable :

a GCancellable, or NULL -

cancellable

a GCancellable, or NULL

 

callback :

callback to be called when the commit operation completes

callback

callback to be called when the commit operation completes

 

user_data :

caller-specific data passed to callback -

user_data

caller-specific data passed to callback +

 
+

-

nm_remote_connection_commit_changes_finish ()

-
gboolean            nm_remote_connection_commit_changes_finish
-                                                        (NMRemoteConnection *connection,
-                                                         GAsyncResult *result,
-                                                         GError **error);
-

-Gets the result of a call to nm_remote_connection_commit_changes_async(). -

-
+

nm_remote_connection_commit_changes_finish ()

+
gboolean
+nm_remote_connection_commit_changes_finish
+                               (NMRemoteConnection *connection,
+                                GAsyncResult *result,
+                                GError **error);
+

Gets the result of a call to nm_remote_connection_commit_changes_async().

+
+

Parameters

+
--+++ - - + + + - - - - - - + + + - - + + +

connection :

the NMRemoteConnection -

connection

the NMRemoteConnection

 

result :

the result passed to the GAsyncReadyCallback -

error :

location for a GError, or NULL -

result

the result passed to the GAsyncReadyCallback

 

Returns :

-TRUE on success, FALSE on error, in which case error will be set.

error

location for a GError, or NULL

 
+
+

Returns

+

TRUE on success, FALSE on error, in which case error +will be set.

+

+
+

-

nm_remote_connection_save ()

-
gboolean            nm_remote_connection_save           (NMRemoteConnection *connection,
-                                                         GCancellable *cancellable,
-                                                         GError **error);
-

-Saves the connection to disk if the connection has changes that have not yet -been written to disk, or if the connection has never been saved. -

-
+

nm_remote_connection_save ()

+
gboolean
+nm_remote_connection_save (NMRemoteConnection *connection,
+                           GCancellable *cancellable,
+                           GError **error);
+

Saves the connection to disk if the connection has changes that have not yet +been written to disk, or if the connection has never been saved.

+
+

Parameters

+
--+++ - - + + + - - - - - - + + + - - + + +

connection :

the NMRemoteConnection -

connection

the NMRemoteConnection

 

cancellable :

a GCancellable, or NULL -

error :

location for a GError, or NULL -

cancellable

a GCancellable, or NULL

 

Returns :

-TRUE on success, FALSE on error, in which case error will be set.

error

location for a GError, or NULL

 
+
+

Returns

+

TRUE on success, FALSE on error, in which case error +will be set.

+

+
+

-

nm_remote_connection_save_async ()

-
void                nm_remote_connection_save_async     (NMRemoteConnection *connection,
-                                                         GCancellable *cancellable,
-                                                         GAsyncReadyCallback callback,
-                                                         gpointer user_data);
-

-Saves the connection to disk if the connection has changes that have not yet -been written to disk, or if the connection has never been saved. -

-
+

nm_remote_connection_save_async ()

+
void
+nm_remote_connection_save_async (NMRemoteConnection *connection,
+                                 GCancellable *cancellable,
+                                 GAsyncReadyCallback callback,
+                                 gpointer user_data);
+

Saves the connection to disk if the connection has changes that have not yet +been written to disk, or if the connection has never been saved.

+
+

Parameters

+
--+++ - - + + + - - + + + - - + + + - - + + +

connection :

the NMRemoteConnection -

connection

the NMRemoteConnection

 

cancellable :

a GCancellable, or NULL -

cancellable

a GCancellable, or NULL

 

callback :

callback to be called when the save operation completes

callback

callback to be called when the save operation completes

 

user_data :

caller-specific data passed to callback -

user_data

caller-specific data passed to callback +

 
+

-

nm_remote_connection_save_finish ()

-
gboolean            nm_remote_connection_save_finish    (NMRemoteConnection *connection,
-                                                         GAsyncResult *result,
-                                                         GError **error);
-

-Gets the result of a call to nm_remote_connection_save_async(). -

-
+

nm_remote_connection_save_finish ()

+
gboolean
+nm_remote_connection_save_finish (NMRemoteConnection *connection,
+                                  GAsyncResult *result,
+                                  GError **error);
+

Gets the result of a call to nm_remote_connection_save_async().

+
+

Parameters

+
--+++ - - + + + - - + + + - - - - - - + + +

connection :

the NMRemoteConnection -

connection

the NMRemoteConnection

 

result :

the result passed to the GAsyncReadyCallback -

result

the result passed to the GAsyncReadyCallback

 

error :

location for a GError, or NULL -

Returns :

-TRUE on success, FALSE on error, in which case error will be set.

error

location for a GError, or NULL

 
+
+

Returns

+

TRUE on success, FALSE on error, in which case error +will be set.

+

+
+

-

nm_remote_connection_delete ()

-
gboolean            nm_remote_connection_delete         (NMRemoteConnection *connection,
-                                                         GCancellable *cancellable,
-                                                         GError **error);
-

-Deletes the connection. -

-
+

nm_remote_connection_delete ()

+
gboolean
+nm_remote_connection_delete (NMRemoteConnection *connection,
+                             GCancellable *cancellable,
+                             GError **error);
+

Deletes the connection.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + + - - + + +

connection :

the NMRemoteConnection -

cancellable :

a GCancellable, or NULL -

connection

the NMRemoteConnection

 

error :

location for a GError, or NULL -

cancellable

a GCancellable, or NULL

 

Returns :

-TRUE on success, FALSE on error, in which case error will be set.

error

location for a GError, or NULL

 
+
+

Returns

+

TRUE on success, FALSE on error, in which case error +will be set.

+

+
+
-

nm_remote_connection_delete_async ()

-
void                nm_remote_connection_delete_async   (NMRemoteConnection *connection,
-                                                         GCancellable *cancellable,
-                                                         GAsyncReadyCallback callback,
-                                                         gpointer user_data);
-

-Asynchronously deletes the connection. -

-
+

nm_remote_connection_delete_async ()

+
void
+nm_remote_connection_delete_async (NMRemoteConnection *connection,
+                                   GCancellable *cancellable,
+                                   GAsyncReadyCallback callback,
+                                   gpointer user_data);
+

Asynchronously deletes the connection.

+
+

Parameters

+
--+++ - - + + + - - + + + - - + + + - - + + +

connection :

the NMRemoteConnection -

connection

the NMRemoteConnection

 

cancellable :

a GCancellable, or NULL -

cancellable

a GCancellable, or NULL

 

callback :

callback to be called when the delete operation completes

callback

callback to be called when the delete operation completes

 

user_data :

caller-specific data passed to callback -

user_data

caller-specific data passed to callback +

 
+
-

nm_remote_connection_delete_finish ()

-
gboolean            nm_remote_connection_delete_finish  (NMRemoteConnection *connection,
-                                                         GAsyncResult *result,
-                                                         GError **error);
-

-Gets the result of a call to nm_remote_connection_delete_async(). -

-
+

nm_remote_connection_delete_finish ()

+
gboolean
+nm_remote_connection_delete_finish (NMRemoteConnection *connection,
+                                    GAsyncResult *result,
+                                    GError **error);
+

Gets the result of a call to nm_remote_connection_delete_async().

+
+

Parameters

+
--+++ - - + + + - - + + + - - - - - - + + +

connection :

the NMRemoteConnection -

connection

the NMRemoteConnection

 

result :

the result passed to the GAsyncReadyCallback -

result

the result passed to the GAsyncReadyCallback

 

error :

location for a GError, or NULL -

Returns :

-TRUE on success, FALSE on error, in which case error will be set.

error

location for a GError, or NULL

 
+
+

Returns

+

TRUE on success, FALSE on error, in which case error +will be set.

+

+
+
-

nm_remote_connection_get_secrets ()

-
GVariant *          nm_remote_connection_get_secrets    (NMRemoteConnection *connection,
-                                                         const char *setting_name,
-                                                         GCancellable *cancellable,
-                                                         GError **error);
-

-Request the connection's secrets. Note that this is a blocking D-Bus call, -not a simple property accessor. -

-
+

nm_remote_connection_get_secrets ()

+
GVariant *
+nm_remote_connection_get_secrets (NMRemoteConnection *connection,
+                                  const char *setting_name,
+                                  GCancellable *cancellable,
+                                  GError **error);
+

Request the connection's secrets. Note that this is a blocking D-Bus call, +not a simple property accessor.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + + - - + + + - - + + +

connection :

the NMRemoteConnection -

setting_name :

the NMSetting object name to get secrets for

connection

the NMRemoteConnection

 

cancellable :

a GCancellable, or NULL -

setting_name

the NMSetting object name to get secrets for

 

error :

location for a GError, or NULL -

cancellable

a GCancellable, or NULL

 

Returns :

a GVariant of type NM_VARIANT_TYPE_CONNECTION containing -connection's secrets, or NULL on error.

error

location for a GError, or NULL

 
+
+

Returns

+

a GVariant of type NM_VARIANT_TYPE_CONNECTION containing +connection +'s secrets, or NULL on error.

+

+
+
-

nm_remote_connection_get_secrets_async ()

-
void                nm_remote_connection_get_secrets_async
-                                                        (NMRemoteConnection *connection,
-                                                         const char *setting_name,
-                                                         GCancellable *cancellable,
-                                                         GAsyncReadyCallback callback,
-                                                         gpointer user_data);
-

-Asynchronously requests the connection's secrets. -

-
+

nm_remote_connection_get_secrets_async ()

+
void
+nm_remote_connection_get_secrets_async
+                               (NMRemoteConnection *connection,
+                                const char *setting_name,
+                                GCancellable *cancellable,
+                                GAsyncReadyCallback callback,
+                                gpointer user_data);
+

Asynchronously requests the connection's secrets.

+
+

Parameters

+
--+++ - - + + + - - + + + - - + + + - - + + + - - + + +

connection :

the NMRemoteConnection -

connection

the NMRemoteConnection

 

setting_name :

the NMSetting object name to get secrets for

setting_name

the NMSetting object name to get secrets for

 

cancellable :

a GCancellable, or NULL -

cancellable

a GCancellable, or NULL

 

callback :

callback to be called when the secret request completes

callback

callback to be called when the secret request completes

 

user_data :

caller-specific data passed to callback -

user_data

caller-specific data passed to callback +

 
+
-

nm_remote_connection_get_secrets_finish ()

-
GVariant *          nm_remote_connection_get_secrets_finish
-                                                        (NMRemoteConnection *connection,
-                                                         GAsyncResult *result,
-                                                         GError **error);
-

-Gets the result of a call to nm_remote_connection_get_secrets_async(). -

-
+

nm_remote_connection_get_secrets_finish ()

+
GVariant *
+nm_remote_connection_get_secrets_finish
+                               (NMRemoteConnection *connection,
+                                GAsyncResult *result,
+                                GError **error);
+

Gets the result of a call to nm_remote_connection_get_secrets_async().

+
+

Parameters

+
--+++ - - + + + - - + + + - - - - - - + + +

connection :

the NMRemoteConnection -

connection

the NMRemoteConnection

 

result :

the result passed to the GAsyncReadyCallback -

result

the result passed to the GAsyncReadyCallback

 

error :

location for a GError, or NULL -

Returns :

a GVariant of type NM_VARIANT_TYPE_CONNECTION -containing connection's secrets, or NULL on error. [transfer full] -

error

location for a GError, or NULL

 
+
+

Returns

+

a GVariant of type NM_VARIANT_TYPE_CONNECTION +containing connection +'s secrets, or NULL on error.

+

[transfer full]

+
+
-

nm_remote_connection_get_unsaved ()

-
gboolean            nm_remote_connection_get_unsaved    (NMRemoteConnection *connection);
-
+

nm_remote_connection_get_unsaved ()

+
gboolean
+nm_remote_connection_get_unsaved (NMRemoteConnection *connection);
+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

connection :

the NMRemoteConnection -

Returns :

-TRUE if the remote connection contains changes that have not -been saved to disk, FALSE if the connection is the same as its on-disk -representation.

connection

the NMRemoteConnection

 
+
+

Returns

+

TRUE if the remote connection contains changes that have not +been saved to disk, FALSE if the connection is the same as its on-disk +representation.

+

+
+
-

nm_remote_connection_get_visible ()

-
gboolean            nm_remote_connection_get_visible    (NMRemoteConnection *connection);
-

-Checks if the connection is visible to the current user. If the +

nm_remote_connection_get_visible ()

+
gboolean
+nm_remote_connection_get_visible (NMRemoteConnection *connection);
+

Checks if the connection is visible to the current user. If the connection is not visible then it is essentially useless; it will not contain any settings, and operations such as -nm_remote_connection_save() and nm_remote_connection_delete() will +nm_remote_connection_save() and nm_remote_connection_delete() will always fail. (NMRemoteSettings will not normally return non-visible connections to callers, but it is possible for a connection's visibility to change after you already have a -reference to it.) -

-
+reference to it.)

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

connection :

the NMRemoteConnection -

Returns :

-TRUE if the remote connection is visible to the current -user, FALSE if not.

connection

the NMRemoteConnection

 
+
+

Returns

+

TRUE if the remote connection is visible to the current +user, FALSE if not.

+

+
+
-

Property Details

+

Types and Values

-

The "unsaved" property

-
  "unsaved"                  gboolean              : Read
+

NM_REMOTE_CONNECTION_DBUS_CONNECTION

+
#define NM_REMOTE_CONNECTION_DBUS_CONNECTION "dbus-connection"
+
+

+

+
+
+
+

NM_REMOTE_CONNECTION_PATH

+
#define NM_REMOTE_CONNECTION_PATH            "path"
+

-TRUE if the remote connection contains changes that have not been saved -to disk, FALSE if the connection is the same as its on-disk representation.

-

Default value: FALSE


-

The "visible" property

-
  "visible"                  gboolean              : Read
+

NM_REMOTE_CONNECTION_UNSAVED

+
#define NM_REMOTE_CONNECTION_UNSAVED         "unsaved"
+

-TRUE if the remote connection is visible to the current user, FALSE if -not. If the connection is not visible then it is essentially useless; it -will not contain any settings, and operations such as -nm_remote_connection_save() and nm_remote_connection_delete() will always -fail. (NMRemoteSettings will not normally return non-visible connections -to callers, but it is possible for a connection's visibility to change -after you already have a reference to it.)

+
+
+
+

NM_REMOTE_CONNECTION_VISIBLE

+
#define NM_REMOTE_CONNECTION_VISIBLE         "visible"
+
+

+

+
+
+
+

Property Details

+
+

The “unsaved” property

+
  “unsaved”                  gboolean
+

+

Flags: Read

+

Default value: FALSE

+
+
+
+

The “visible” property

+
  “visible”                  gboolean
+

+

Flags: Read

Default value: FALSE

+ Generated by GTK-Doc V1.21 \ No newline at end of file diff --git a/docs/libnm/html/NMSecretAgentOld.html b/docs/libnm/html/NMSecretAgentOld.html index 8ba81e68..4eb3641b 100644 --- a/docs/libnm/html/NMSecretAgentOld.html +++ b/docs/libnm/html/NMSecretAgentOld.html @@ -2,36 +2,28 @@ -NMSecretAgentOld +libnm Reference Manual: NMSecretAgentOld - + - - - - - - - - - - + + + + + + +
@@ -39,90 +31,187 @@

NMSecretAgentOld

NMSecretAgentOld

- +
-
-

Synopsis

-
#define             NM_SECRET_AGENT_OLD_IDENTIFIER
-#define             NM_SECRET_AGENT_OLD_AUTO_REGISTER
-#define             NM_SECRET_AGENT_OLD_REGISTERED
-#define             NM_SECRET_AGENT_OLD_CAPABILITIES
-                    NMSecretAgentOld;
-void                (*NMSecretAgentOldGetSecretsFunc)   (NMSecretAgentOld *agent,
-                                                         NMConnection *connection,
-                                                         GVariant *secrets,
-                                                         GError *error,
-                                                         gpointer user_data);
-void                (*NMSecretAgentOldSaveSecretsFunc)  (NMSecretAgentOld *agent,
-                                                         NMConnection *connection,
-                                                         GError *error,
-                                                         gpointer user_data);
-void                (*NMSecretAgentOldDeleteSecretsFunc)
-                                                        (NMSecretAgentOld *agent,
-                                                         NMConnection *connection,
-                                                         GError *error,
-                                                         gpointer user_data);
-                    NMSecretAgentOldClass;
-gboolean            nm_secret_agent_old_register        (NMSecretAgentOld *self,
-                                                         GCancellable *cancellable,
-                                                         GError **error);
-void                nm_secret_agent_old_register_async  (NMSecretAgentOld *self,
-                                                         GCancellable *cancellable,
-                                                         GAsyncReadyCallback callback,
-                                                         gpointer user_data);
-gboolean            nm_secret_agent_old_register_finish (NMSecretAgentOld *self,
-                                                         GAsyncResult *result,
-                                                         GError **error);
-gboolean            nm_secret_agent_old_unregister      (NMSecretAgentOld *self,
-                                                         GCancellable *cancellable,
-                                                         GError **error);
-void                nm_secret_agent_old_unregister_async
-                                                        (NMSecretAgentOld *self,
-                                                         GCancellable *cancellable,
-                                                         GAsyncReadyCallback callback,
-                                                         gpointer user_data);
-gboolean            nm_secret_agent_old_unregister_finish
-                                                        (NMSecretAgentOld *self,
-                                                         GAsyncResult *result,
-                                                         GError **error);
-gboolean            nm_secret_agent_old_get_registered  (NMSecretAgentOld *self);
-void                nm_secret_agent_old_get_secrets     (NMSecretAgentOld *self,
-                                                         NMConnection *connection,
-                                                         const char *setting_name,
-                                                         const char **hints,
-                                                         NMSecretAgentGetSecretsFlags flags,
-                                                         NMSecretAgentOldGetSecretsFunc callback,
-                                                         gpointer user_data);
-void                nm_secret_agent_old_save_secrets    (NMSecretAgentOld *self,
-                                                         NMConnection *connection,
-                                                         NMSecretAgentOldSaveSecretsFunc callback,
-                                                         gpointer user_data);
-void                nm_secret_agent_old_delete_secrets  (NMSecretAgentOld *self,
-                                                         NMConnection *connection,
-                                                         NMSecretAgentOldDeleteSecretsFunc callback,
-                                                         gpointer user_data);
-
+
+

Functions

+
++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+void + +(*NMSecretAgentOldGetSecretsFunc) () +
+void + +(*NMSecretAgentOldSaveSecretsFunc) () +
+void + +(*NMSecretAgentOldDeleteSecretsFunc) () +
+gboolean + +nm_secret_agent_old_register () +
+void + +nm_secret_agent_old_register_async () +
+gboolean + +nm_secret_agent_old_register_finish () +
+gboolean + +nm_secret_agent_old_unregister () +
+void + +nm_secret_agent_old_unregister_async () +
+gboolean + +nm_secret_agent_old_unregister_finish () +
+gboolean + +nm_secret_agent_old_get_registered () +
+void + +nm_secret_agent_old_get_secrets () +
+void + +nm_secret_agent_old_save_secrets () +
+void + +nm_secret_agent_old_delete_secrets () +
-

Object Hierarchy

-
-  GObject
-   +----NMSecretAgentOld
-
+

Properties

+
+++++ + + + + + + + + + + + + + + + + + + + + + + +
gbooleanauto-registerRead / Write / Construct
NMSecretAgentCapabilitiescapabilitiesRead / Write / Construct
+gchar *identifierRead / Write / Construct Only
gbooleanregisteredRead
-

Implemented Interfaces

-

-NMSecretAgentOld implements - GInitable and GAsyncInitable.

+

Types and Values

+
-

Properties

-
-  "auto-register"            gboolean              : Read / Write / Construct
-  "capabilities"             NMSecretAgentCapabilities  : Read / Write / Construct
-  "identifier"               gchar*                : Read / Write / Construct Only
-  "registered"               gboolean              : Read
+

Object Hierarchy

+
    GObject
+    ╰── NMSecretAgentOld
 
@@ -131,65 +220,23 @@ NMSecretAgentOld implements

-

Details

+

Functions

-

NM_SECRET_AGENT_OLD_IDENTIFIER

-
#define NM_SECRET_AGENT_OLD_IDENTIFIER          "identifier"
-
-

-

-
-
-
-

NM_SECRET_AGENT_OLD_AUTO_REGISTER

-
#define NM_SECRET_AGENT_OLD_AUTO_REGISTER       "auto-register"
-
-

-

-
-
-
-

NM_SECRET_AGENT_OLD_REGISTERED

-
#define NM_SECRET_AGENT_OLD_REGISTERED          "registered"
-
-

-

-
-
-
-

NM_SECRET_AGENT_OLD_CAPABILITIES

-
#define NM_SECRET_AGENT_OLD_CAPABILITIES        "capabilities"
-
-

-

-
-
-
-

NMSecretAgentOld

-
typedef struct _NMSecretAgentOld NMSecretAgentOld;
-

-

-
-
-
-

NMSecretAgentOldGetSecretsFunc ()

-
void                (*NMSecretAgentOldGetSecretsFunc)   (NMSecretAgentOld *agent,
-                                                         NMConnection *connection,
-                                                         GVariant *secrets,
-                                                         GError *error,
-                                                         gpointer user_data);
-

-Called as a result of a request by NM to retrieve secrets. When the +

NMSecretAgentOldGetSecretsFunc ()

+
void
+(*NMSecretAgentOldGetSecretsFunc) (NMSecretAgentOld *agent,
+                                   NMConnection *connection,
+                                   GVariant *secrets,
+                                   GError *error,
+                                   gpointer user_data);
+

Called as a result of a request by NM to retrieve secrets. When the NMSecretAgentOld subclass has finished retrieving secrets and is ready to return them, or to return an error, this function should be called with -those secrets or the error. -

-

-To easily create the dictionary to return the Wi-Fi PSK, you could do -something like this: -

+those secrets or the error.

+

To easily create the dictionary to return the Wi-Fi PSK, you could do +something like this:

-

Example 1. Creating a secrets dictionary

+

Example 1. Creating a secrets dictionary

@@ -216,696 +263,686 @@ something like this: secrets = nm_simple_connection_new ();s_wsec = (NMSettingWirelessSecurity *) nm_setting_wireless_security_new (); -g_object_set (G_OBJECT (s_wsec), +g_object_set (G_OBJECT (s_wsec), NM_SETTING_WIRELESS_SECURITY_PSK, "my really cool PSK", - NULL); + NULL);nm_connection_add_setting (secrets, NM_SETTING (s_wsec)); -secrets_dict = nm_connection_to_dbus (secrets, NM_CONNECTION_SERIALIZE_ALL); +secrets_dict = nm_connection_to_dbus (secrets, NM_CONNECTION_SERIALIZE_ALL);(call the NMSecretAgentOldGetSecretsFunc with secrets_dict) -g_object_unref (secrets); -g_variant_unref (secrets_dict); +g_object_unref (secrets); +g_variant_unref (secrets_dict);
-


-

-
+
+

Parameters

+
--+++ - - + + + - - + +g_object_ref()/g_object_unref() if you want to use this object after the callback +has returned.

+ - - + +and the value is the secret

+ - - + + + - - + + +

agent :

the secret agent object

agent

the secret agent object

 

connection :

the connection for which secrets were requested, +

connection

the connection for which secrets were requested, note that this object will be unrefed after the callback has returned, use -g_object_ref()/g_object_unref() if you want to use this object after the callback -has returned. [transfer none] -

[transfer none]

secrets :

the GVariant of type NM_VARIANT_TYPE_CONNECTION containing the requested -secrets (as created by nm_connection_to_dbus() for example). Each key in secrets +

secrets

the GVariant of type NM_VARIANT_TYPE_CONNECTION containing the requested +secrets (as created by nm_connection_to_dbus() for example). Each key in secrets should be the name of a NMSetting object (like "802-11-wireless-security") and each value should be an NM_VARIANT_TYPE_SETTING variant. The sub-dicts map string:value, where the string is the setting property name (like "psk") -and the value is the secret

 

error :

if the secrets request failed, give a descriptive error here

error

if the secrets request failed, give a descriptive error here

 

user_data :

caller-specific data to be passed to the function

user_data

caller-specific data to be passed to the function

 
+

-

NMSecretAgentOldSaveSecretsFunc ()

-
void                (*NMSecretAgentOldSaveSecretsFunc)  (NMSecretAgentOld *agent,
-                                                         NMConnection *connection,
-                                                         GError *error,
-                                                         gpointer user_data);
-

-Called as a result of a request by NM to save secrets. When the +

NMSecretAgentOldSaveSecretsFunc ()

+
void
+(*NMSecretAgentOldSaveSecretsFunc) (NMSecretAgentOld *agent,
+                                    NMConnection *connection,
+                                    GError *error,
+                                    gpointer user_data);
+

Called as a result of a request by NM to save secrets. When the NMSecretAgentOld subclass has finished saving the secrets, this function -should be called. -

-
+should be called.

+
+

Parameters

+
--+++ - - + + + - - + +g_object_ref()/g_object_unref() if you want to use this object after the callback +has returned.

+ - - + + + - - + + +

agent :

the secret agent object

agent

the secret agent object

 

connection :

the connection for which secrets were to be saved, +

connection

the connection for which secrets were to be saved, note that this object will be unrefed after the callback has returned, use -g_object_ref()/g_object_unref() if you want to use this object after the callback -has returned. [transfer none] -

[transfer none]

error :

if the saving secrets failed, give a descriptive error here

error

if the saving secrets failed, give a descriptive error here

 

user_data :

caller-specific data to be passed to the function

user_data

caller-specific data to be passed to the function

 
+

-

NMSecretAgentOldDeleteSecretsFunc ()

-
void                (*NMSecretAgentOldDeleteSecretsFunc)
-                                                        (NMSecretAgentOld *agent,
-                                                         NMConnection *connection,
-                                                         GError *error,
-                                                         gpointer user_data);
-

-Called as a result of a request by NM to delete secrets. When the +

NMSecretAgentOldDeleteSecretsFunc ()

+
void
+(*NMSecretAgentOldDeleteSecretsFunc) (NMSecretAgentOld *agent,
+                                      NMConnection *connection,
+                                      GError *error,
+                                      gpointer user_data);
+

Called as a result of a request by NM to delete secrets. When the NMSecretAgentOld subclass has finished deleting the secrets, this function -should be called. -

-
+should be called.

+
+

Parameters

+
--+++ - - + + + - - + +g_object_ref()/g_object_unref() if you want to use this object after the callback +has returned.

+ - - + + + - - + + +

agent :

the secret agent object

agent

the secret agent object

 

connection :

the connection for which secrets were to be deleted, +

connection

the connection for which secrets were to be deleted, note that this object will be unrefed after the callback has returned, use -g_object_ref()/g_object_unref() if you want to use this object after the callback -has returned. [transfer none] -

[transfer none]

error :

if the deleting secrets failed, give a descriptive error here

error

if the deleting secrets failed, give a descriptive error here

 

user_data :

caller-specific data to be passed to the function

user_data

caller-specific data to be passed to the function

 
-
-
-

NMSecretAgentOldClass

-
typedef struct {
-	GObjectClass parent;
-
-	/* Virtual methods for subclasses */
-
-	/* Called when the subclass should retrieve and return secrets.  Subclass
-	 * must copy or reference any arguments it may require after returning from
-	 * this method, as the arguments will freed (except for 'self', 'callback',
-	 * and 'user_data' of course).  If the request is canceled, the callback
-	 * should still be called, but with the
-	 * NM_SECRET_AGENT_OLD_ERROR_AGENT_CANCELED error.
-	 */
-	void (*get_secrets) (NMSecretAgentOld *self,
-	                     NMConnection *connection,
-	                     const char *connection_path,
-	                     const char *setting_name,
-	                     const char **hints,
-	                     NMSecretAgentGetSecretsFlags flags,
-	                     NMSecretAgentOldGetSecretsFunc callback,
-	                     gpointer user_data);
-
-	/* Called when the subclass should cancel an outstanding request to
-	 * get secrets for a given connection.  Canceling the request MUST
-	 * call the callback that was passed along with the initial get_secrets
-	 * call, sending the NM_SECRET_AGENT_OLD_ERROR/
-	 * NM_SECRET_AGENT_OLD_ERROR_AGENT_CANCELED error to that callback.
-	 */
-	void (*cancel_get_secrets) (NMSecretAgentOld *self,
-	                            const char *connection_path,
-	                            const char *setting_name);
-
-	/* Called when the subclass should save the secrets contained in the
-	 * connection to backing storage.  Subclass must copy or reference any
-	 * arguments it may require after returning from this method, as the
-	 * arguments will freed (except for 'self', 'callback', and 'user_data'
-	 * of course).
-	 */
-	void (*save_secrets) (NMSecretAgentOld *self,
-	                      NMConnection *connection,
-	                      const char *connection_path,
-	                      NMSecretAgentOldSaveSecretsFunc callback,
-	                      gpointer user_data);
-
-	/* Called when the subclass should delete the secrets contained in the
-	 * connection from backing storage.  Subclass must copy or reference any
-	 * arguments it may require after returning from this method, as the
-	 * arguments will freed (except for 'self', 'callback', and 'user_data'
-	 * of course).
-	 */
-	void (*delete_secrets) (NMSecretAgentOld *self,
-	                        NMConnection *connection,
-	                        const char *connection_path,
-	                        NMSecretAgentOldDeleteSecretsFunc callback,
-	                        gpointer user_data);
-} NMSecretAgentOldClass;
-
-

-


-

nm_secret_agent_old_register ()

-
gboolean            nm_secret_agent_old_register        (NMSecretAgentOld *self,
-                                                         GCancellable *cancellable,
-                                                         GError **error);
-

-Registers the NMSecretAgentOld with the NetworkManager secret manager, +

nm_secret_agent_old_register ()

+
gboolean
+nm_secret_agent_old_register (NMSecretAgentOld *self,
+                              GCancellable *cancellable,
+                              GError **error);
+

Registers the NMSecretAgentOld with the NetworkManager secret manager, indicating to NetworkManager that the agent is able to provide and save -secrets for connections on behalf of its user. -

-

-It is a programmer error to attempt to register an agent that is already -registered, or in the process of registering. -

-
+secrets for connections on behalf of its user.

+

It is a programmer error to attempt to register an agent that is already +registered, or in the process of registering.

+
+

Parameters

+
--+++ - - + + + - - + + + - - - - - - + + +

self :

a NMSecretAgentOld -

self

a NMSecretAgentOld

 

cancellable :

a GCancellable, or NULL -

cancellable

a GCancellable, or NULL

 

error :

return location for a GError, or NULL -

Returns :

-TRUE if registration was successful, FALSE on error.

error

return location for a GError, or NULL

 
+
+

Returns

+

TRUE if registration was successful, FALSE on error.

+

+
+

-

nm_secret_agent_old_register_async ()

-
void                nm_secret_agent_old_register_async  (NMSecretAgentOld *self,
-                                                         GCancellable *cancellable,
-                                                         GAsyncReadyCallback callback,
-                                                         gpointer user_data);
-

-Asynchronously registers the NMSecretAgentOld with the NetworkManager secret +

nm_secret_agent_old_register_async ()

+
void
+nm_secret_agent_old_register_async (NMSecretAgentOld *self,
+                                    GCancellable *cancellable,
+                                    GAsyncReadyCallback callback,
+                                    gpointer user_data);
+

Asynchronously registers the NMSecretAgentOld with the NetworkManager secret manager, indicating to NetworkManager that the agent is able to provide and -save secrets for connections on behalf of its user. -

-

-It is a programmer error to attempt to register an agent that is already -registered, or in the process of registering. -

-
+save secrets for connections on behalf of its user.

+

It is a programmer error to attempt to register an agent that is already +registered, or in the process of registering.

+
+

Parameters

+
--+++ - - + + + - - + + + - - + + + - - + + +

self :

a NMSecretAgentOld -

self

a NMSecretAgentOld

 

cancellable :

a GCancellable, or NULL -

cancellable

a GCancellable, or NULL

 

callback :

callback to call when the agent is registered

callback

callback to call when the agent is registered

 

user_data :

data for callback -

user_data

data for callback +

 
+
-

nm_secret_agent_old_register_finish ()

-
gboolean            nm_secret_agent_old_register_finish (NMSecretAgentOld *self,
-                                                         GAsyncResult *result,
-                                                         GError **error);
-

-Gets the result of a call to nm_secret_agent_old_register_async(). -

-
+

nm_secret_agent_old_register_finish ()

+
gboolean
+nm_secret_agent_old_register_finish (NMSecretAgentOld *self,
+                                     GAsyncResult *result,
+                                     GError **error);
+

Gets the result of a call to nm_secret_agent_old_register_async().

+
+

Parameters

+
--+++ - - + + + - - + + + - - - - - - + + +

self :

a NMSecretAgentOld -

self

a NMSecretAgentOld

 

result :

the result passed to the GAsyncReadyCallback -

result

the result passed to the GAsyncReadyCallback

 

error :

return location for a GError, or NULL -

Returns :

-TRUE if registration was successful, FALSE on error.

error

return location for a GError, or NULL

 
+
+

Returns

+

TRUE if registration was successful, FALSE on error.

+

+
+
-

nm_secret_agent_old_unregister ()

-
gboolean            nm_secret_agent_old_unregister      (NMSecretAgentOld *self,
-                                                         GCancellable *cancellable,
-                                                         GError **error);
-

-Unregisters the NMSecretAgentOld with the NetworkManager secret manager, +

nm_secret_agent_old_unregister ()

+
gboolean
+nm_secret_agent_old_unregister (NMSecretAgentOld *self,
+                                GCancellable *cancellable,
+                                GError **error);
+

Unregisters the NMSecretAgentOld with the NetworkManager secret manager, indicating to NetworkManager that the agent will no longer provide or -store secrets on behalf of this user. -

-

-It is a programmer error to attempt to unregister an agent that is not -registered. -

-
+store secrets on behalf of this user.

+

It is a programmer error to attempt to unregister an agent that is not +registered.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + + - - + + +

self :

a NMSecretAgentOld -

cancellable :

a GCancellable, or NULL -

self

a NMSecretAgentOld

 

error :

return location for a GError, or NULL -

cancellable

a GCancellable, or NULL

 

Returns :

-TRUE if unregistration was successful, FALSE on error

error

return location for a GError, or NULL

 
+
+

Returns

+

TRUE if unregistration was successful, FALSE on error

+

+
+
-

nm_secret_agent_old_unregister_async ()

-
void                nm_secret_agent_old_unregister_async
-                                                        (NMSecretAgentOld *self,
-                                                         GCancellable *cancellable,
-                                                         GAsyncReadyCallback callback,
-                                                         gpointer user_data);
-

-Asynchronously unregisters the NMSecretAgentOld with the NetworkManager secret +

nm_secret_agent_old_unregister_async ()

+
void
+nm_secret_agent_old_unregister_async (NMSecretAgentOld *self,
+                                      GCancellable *cancellable,
+                                      GAsyncReadyCallback callback,
+                                      gpointer user_data);
+

Asynchronously unregisters the NMSecretAgentOld with the NetworkManager secret manager, indicating to NetworkManager that the agent will no longer provide -or store secrets on behalf of this user. -

-

-It is a programmer error to attempt to unregister an agent that is not -registered. -

-
+or store secrets on behalf of this user.

+

It is a programmer error to attempt to unregister an agent that is not +registered.

+
+

Parameters

+
--+++ - - + + + - - + + + - - + + + - - + + +

self :

a NMSecretAgentOld -

self

a NMSecretAgentOld

 

cancellable :

a GCancellable, or NULL -

cancellable

a GCancellable, or NULL

 

callback :

callback to call when the agent is unregistered

callback

callback to call when the agent is unregistered

 

user_data :

data for callback -

user_data

data for callback +

 
+
-

nm_secret_agent_old_unregister_finish ()

-
gboolean            nm_secret_agent_old_unregister_finish
-                                                        (NMSecretAgentOld *self,
-                                                         GAsyncResult *result,
-                                                         GError **error);
-

-Gets the result of a call to nm_secret_agent_old_unregister_async(). -

-
+

nm_secret_agent_old_unregister_finish ()

+
gboolean
+nm_secret_agent_old_unregister_finish (NMSecretAgentOld *self,
+                                       GAsyncResult *result,
+                                       GError **error);
+

Gets the result of a call to nm_secret_agent_old_unregister_async().

+
+

Parameters

+
--+++ - - - - - - + + + - - + + + - - + + +

self :

a NMSecretAgentOld -

result :

the result passed to the GAsyncReadyCallback -

self

a NMSecretAgentOld

 

error :

return location for a GError, or NULL -

result

the result passed to the GAsyncReadyCallback

 

Returns :

-TRUE if unregistration was successful, FALSE on error.

error

return location for a GError, or NULL

 
+
+

Returns

+

TRUE if unregistration was successful, FALSE on error.

+

+
+
-

nm_secret_agent_old_get_registered ()

-
gboolean            nm_secret_agent_old_get_registered  (NMSecretAgentOld *self);
-
+

nm_secret_agent_old_get_registered ()

+
gboolean
+nm_secret_agent_old_get_registered (NMSecretAgentOld *self);
+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

self :

a NMSecretAgentOld -

Returns :

a TRUE if the agent is registered, FALSE if it is not.

self

a NMSecretAgentOld

 
+
+

Returns

+

a TRUE if the agent is registered, FALSE if it is not.

+

+
+
-

nm_secret_agent_old_get_secrets ()

-
void                nm_secret_agent_old_get_secrets     (NMSecretAgentOld *self,
-                                                         NMConnection *connection,
-                                                         const char *setting_name,
-                                                         const char **hints,
-                                                         NMSecretAgentGetSecretsFlags flags,
-                                                         NMSecretAgentOldGetSecretsFunc callback,
-                                                         gpointer user_data);
-

-Asynchronously retrieves secrets belonging to connection for the -setting setting_name. flags indicate specific behavior that the secret +

nm_secret_agent_old_get_secrets ()

+
void
+nm_secret_agent_old_get_secrets (NMSecretAgentOld *self,
+                                 NMConnection *connection,
+                                 const char *setting_name,
+                                 const char **hints,
+                                 NMSecretAgentGetSecretsFlags flags,
+                                 NMSecretAgentOldGetSecretsFunc callback,
+                                 gpointer user_data);
+

Asynchronously retrieves secrets belonging to connection + for the +setting setting_name +. flags + indicate specific behavior that the secret agent should use when performing the request, for example returning only existing secrets without user interaction, or requesting entirely new -secrets from the user. -

-

-Virtual: get_secrets -

-
+secrets from the user.

+

Virtual: get_secrets

+
+

Parameters

+
--+++ - - + + + - - + + + - - + + + - - + + + - - + + + - - + + + - - + + +

self :

a NMSecretAgentOld -

self

a NMSecretAgentOld

 

connection :

the NMConnection for which we're asked secrets

connection

the NMConnection for which we're asked secrets

 

setting_name :

the name of the secret setting

setting_name

the name of the secret setting

 

hints :

hints to the agent. [array zero-terminated=1] -

hints

hints to the agent.

[array zero-terminated=1]

flags :

flags that modify the behavior of the request

flags

flags that modify the behavior of the request

 

callback :

a callback, to be invoked when the operation is done. [scope async] -

callback

a callback, to be invoked when the operation is done.

[scope async]

user_data :

caller-specific data to be passed to callback. [closure] -

user_data

caller-specific data to be passed to callback +.

[closure]
+
-

nm_secret_agent_old_save_secrets ()

-
void                nm_secret_agent_old_save_secrets    (NMSecretAgentOld *self,
-                                                         NMConnection *connection,
-                                                         NMSecretAgentOldSaveSecretsFunc callback,
-                                                         gpointer user_data);
-

-Asynchronously ensures that all secrets inside connection are stored to -disk. -

-

-Virtual: save_secrets -

-
+

nm_secret_agent_old_save_secrets ()

+
void
+nm_secret_agent_old_save_secrets (NMSecretAgentOld *self,
+                                  NMConnection *connection,
+                                  NMSecretAgentOldSaveSecretsFunc callback,
+                                  gpointer user_data);
+

Asynchronously ensures that all secrets inside connection + are stored to +disk.

+

Virtual: save_secrets

+
+

Parameters

+
--+++ - - + + + - - + + + - - + + + - - + + +

self :

a NMSecretAgentOld -

self

a NMSecretAgentOld

 

connection :

a NMConnection -

connection

a NMConnection

 

callback :

a callback, to be invoked when the operation is done. [scope async] -

callback

a callback, to be invoked when the operation is done.

[scope async]

user_data :

caller-specific data to be passed to callback. [closure] -

user_data

caller-specific data to be passed to callback +.

[closure]
+
-

nm_secret_agent_old_delete_secrets ()

-
void                nm_secret_agent_old_delete_secrets  (NMSecretAgentOld *self,
-                                                         NMConnection *connection,
-                                                         NMSecretAgentOldDeleteSecretsFunc callback,
-                                                         gpointer user_data);
-

-Asynchronously asks the agent to delete all saved secrets belonging to -connection. -

-

-Virtual: delete_secrets -

-
+

nm_secret_agent_old_delete_secrets ()

+
void
+nm_secret_agent_old_delete_secrets (NMSecretAgentOld *self,
+                                    NMConnection *connection,
+                                    NMSecretAgentOldDeleteSecretsFunc callback,
+                                    gpointer user_data);
+

Asynchronously asks the agent to delete all saved secrets belonging to +connection +.

+

Virtual: delete_secrets

+
+

Parameters

+
--+++ - - + + + - - + + + - - + + + - - + + +

self :

a NMSecretAgentOld -

self

a NMSecretAgentOld

 

connection :

a NMConnection -

connection

a NMConnection

 

callback :

a callback, to be invoked when the operation is done. [scope async] -

callback

a callback, to be invoked when the operation is done.

[scope async]

user_data :

caller-specific data to be passed to callback. [closure] -

user_data

caller-specific data to be passed to callback +.

[closure]
+
-

Property Details

+

Types and Values

-

The "auto-register" property

-
  "auto-register"            gboolean              : Read / Write / Construct
+

NM_SECRET_AGENT_OLD_IDENTIFIER

+
#define NM_SECRET_AGENT_OLD_IDENTIFIER          "identifier"
+

-If TRUE (the default), the agent will always be registered when -NetworkManager is running; if NetworkManager exits and restarts, the -agent will re-register itself automatically.

+
+
+
+

NM_SECRET_AGENT_OLD_AUTO_REGISTER

+
#define NM_SECRET_AGENT_OLD_AUTO_REGISTER       "auto-register"
+

-In particular, if this property is TRUE at construct time, then the -agent will register itself with NetworkManager during -construction/initialization, and initialization will fail with an error -if the agent is unable to register itself.

+
+
+
+

NM_SECRET_AGENT_OLD_REGISTERED

+
#define NM_SECRET_AGENT_OLD_REGISTERED          "registered"
+

-If the property is FALSE, the agent will not automatically register with -NetworkManager, and nm_secret_agent_old_register() or -nm_secret_agent_old_register_async() must be called to register it.

+
+
+
+

NM_SECRET_AGENT_OLD_CAPABILITIES

+
#define NM_SECRET_AGENT_OLD_CAPABILITIES        "capabilities"
+

-Calling nm_secret_agent_old_unregister() will suppress auto-registration -until nm_secret_agent_old_register() is called, which re-enables -auto-registration. This ensures that the agent remains un-registered when -you expect it to be unregistered.

+
+
+
+

Property Details

+
+

The “auto-register” property

+
  “auto-register”            gboolean
+

+

Flags: Read / Write / Construct

Default value: TRUE


-

The "capabilities" property

-
  "capabilities"             NMSecretAgentCapabilities  : Read / Write / Construct
-

-A bitfield of NMSecretAgentCapabilities. -

+

The “capabilities” property

+
  “capabilities”             NMSecretAgentCapabilities
+

+

Flags: Read / Write / Construct


-

The "identifier" property

-
  "identifier"               gchar*                : Read / Write / Construct Only
-

-Identifies this agent; only one agent in each user session may use the -same identifier. Identifier formatting follows the same rules as -D-Bus bus names with the exception that the ':' character is not -allowed. The valid set of characters is "[A-Z][a-z][0-9]_-." and the -identifier is limited in length to 255 characters with a minimum -of 3 characters. An example valid identifier is 'org.gnome.nm-applet' -(without quotes). -

+

The “identifier” property

+
  “identifier”               gchar *
+

+

Flags: Read / Write / Construct Only

Default value: NULL


-

The "registered" property

-
  "registered"               gboolean              : Read
-

-TRUE if the agent is registered with NetworkManager, FALSE if not. -

+

The “registered” property

+
  “registered”               gboolean
+

+

Flags: Read

Default value: FALSE

+ Generated by GTK-Doc V1.21 \ No newline at end of file diff --git a/docs/libnm/html/NMSetting.html b/docs/libnm/html/NMSetting.html index 6c7f830b..5e5d535b 100644 --- a/docs/libnm/html/NMSetting.html +++ b/docs/libnm/html/NMSetting.html @@ -2,34 +2,28 @@ -NMSetting +libnm Reference Manual: NMSetting - + - - - - - - - - - - + + + + + + +
@@ -37,896 +31,1040 @@

NMSetting

NMSetting — Describes related configuration information

- +
-
-

Synopsis

-
#define             NM_SETTING_PARAM_REQUIRED
-#define             NM_SETTING_PARAM_SECRET
-#define             NM_SETTING_PARAM_FUZZY_IGNORE
-#define             NM_SETTING_NAME
-enum                NMSettingSecretFlags;
-enum                NMSettingCompareFlags;
-struct              NMSetting;
-gboolean            (*NMSettingClearSecretsWithFlagsFn) (NMSetting *setting,
-                                                         const char *secret,
-                                                         NMSettingSecretFlags flags,
-                                                         gpointer user_data);
-                    NMSettingClass;
-void                (*NMSettingValueIterFn)             (NMSetting *setting,
-                                                         const char *key,
-                                                         const GValue *value,
-                                                         GParamFlags flags,
-                                                         gpointer user_data);
-GType               nm_setting_lookup_type              (const char *name);
-NMSetting *         nm_setting_duplicate                (NMSetting *setting);
-const char *        nm_setting_get_name                 (NMSetting *setting);
-gboolean            nm_setting_verify                   (NMSetting *setting,
-                                                         NMConnection *connection,
-                                                         GError **error);
-gboolean            nm_setting_compare                  (NMSetting *a,
-                                                         NMSetting *b,
-                                                         NMSettingCompareFlags flags);
-enum                NMSettingDiffResult;
-gboolean            nm_setting_diff                     (NMSetting *a,
-                                                         NMSetting *b,
-                                                         NMSettingCompareFlags flags,
-                                                         gboolean invert_results,
-                                                         GHashTable **results);
-void                nm_setting_enumerate_values         (NMSetting *setting,
-                                                         NMSettingValueIterFn func,
-                                                         gpointer user_data);
-char *              nm_setting_to_string                (NMSetting *setting);
-gboolean            nm_setting_get_secret_flags         (NMSetting *setting,
-                                                         const char *secret_name,
-                                                         NMSettingSecretFlags *out_flags,
-                                                         GError **error);
-gboolean            nm_setting_set_secret_flags         (NMSetting *setting,
-                                                         const char *secret_name,
-                                                         NMSettingSecretFlags flags,
-                                                         GError **error);
-const GVariantType * nm_setting_get_dbus_property_type  (NMSetting *setting,
-                                                         const char *property_name);
-
-
-
-

Object Hierarchy

-
-  GFlags
-   +----NMSettingSecretFlags
-
-
-  GEnum
-   +----NMSettingCompareFlags
-
-
-  GObject
-   +----NMSetting
-         +----NMSetting8021x
-         +----NMSettingAdsl
-         +----NMSettingBluetooth
-         +----NMSettingBond
-         +----NMSettingBridgePort
-         +----NMSettingBridge
-         +----NMSettingCdma
-         +----NMSettingConnection
-         +----NMSettingDcb
-         +----NMSettingGeneric
-         +----NMSettingGsm
-         +----NMSettingInfiniband
-         +----NMSettingIPConfig
-         +----NMSettingOlpcMesh
-         +----NMSettingPpp
-         +----NMSettingPppoe
-         +----NMSettingSerial
-         +----NMSettingTeamPort
-         +----NMSettingTeam
-         +----NMSettingVlan
-         +----NMSettingVpn
-         +----NMSettingWimax
-         +----NMSettingWired
-         +----NMSettingWirelessSecurity
-         +----NMSettingWireless
-
-
-  GEnum
-   +----NMSettingDiffResult
-
-
-
-

Properties

-
-  "name"                     gchar*                : Read
-
-
-

Description

-

-Each NMSetting contains properties that describe configuration that applies -to a specific network layer (like IPv4 or IPv6 configuration) or device type -(like Ethernet, or Wi-Fi). A collection of individual settings together -make up an NMConnection. Each property is strongly typed and usually has -a number of allowed values. See each NMSetting subclass for a description -of properties and allowed values. -

-
-
-

Details

-
-

NM_SETTING_PARAM_REQUIRED

-
#define NM_SETTING_PARAM_REQUIRED     (1 << (1 + G_PARAM_USER_SHIFT))
-
-

-

-
-
-
-

NM_SETTING_PARAM_SECRET

-
#define NM_SETTING_PARAM_SECRET       (1 << (2 + G_PARAM_USER_SHIFT))
-
-

-

-
-
-
-

NM_SETTING_PARAM_FUZZY_IGNORE

-
#define NM_SETTING_PARAM_FUZZY_IGNORE (1 << (3 + G_PARAM_USER_SHIFT))
-
-

-

-
-
-
-

NM_SETTING_NAME

-
#define NM_SETTING_NAME "name"
-
-

-

-
-
-
-

enum NMSettingSecretFlags

-
typedef enum {
- /*< flags >*/
-	NM_SETTING_SECRET_FLAG_NONE         = 0x00000000,
-	NM_SETTING_SECRET_FLAG_AGENT_OWNED  = 0x00000001,
-	NM_SETTING_SECRET_FLAG_NOT_SAVED    = 0x00000002,
-	NM_SETTING_SECRET_FLAG_NOT_REQUIRED = 0x00000004
-
-	/* NOTE: if adding flags, update nm-core-internal.h as well */
-} NMSettingSecretFlags;
-
-

-These flags indicate specific behavior related to handling of a secret. Each -secret has a corresponding set of these flags which indicate how the secret -is to be stored and/or requested when it is needed. -

-
+

Functions

+
--++ - - + + + + + + + + + + + + + - - + - - + - - + - -

NM_SETTING_SECRET_FLAG_NONE

the system is responsible for providing and -storing this secret (default) +#defineNM_SETTING_PARAM_REQUIRED
#defineNM_SETTING_PARAM_SECRET
#defineNM_SETTING_PARAM_FUZZY_IGNORE
+gboolean + +(*NMSettingClearSecretsWithFlagsFn) ()

NM_SETTING_SECRET_FLAG_AGENT_OWNED

a user secret agent is responsible -for providing and storing this secret; when it is required agents will be -asked to retrieve it + +void + +(*NMSettingValueIterFn) ()

NM_SETTING_SECRET_FLAG_NOT_SAVED

this secret should not be saved, but -should be requested from the user each time it is needed + +GType + +nm_setting_lookup_type ()

NM_SETTING_SECRET_FLAG_NOT_REQUIRED

in situations where it cannot be -automatically determined that the secret is required (some VPNs and PPP -providers dont require all secrets) this flag indicates that the specific -secret is not required + +NMSetting * + +nm_setting_duplicate ()
-
-
-
-

enum NMSettingCompareFlags

-
typedef enum {
-	NM_SETTING_COMPARE_FLAG_EXACT = 0x00000000,
-	NM_SETTING_COMPARE_FLAG_FUZZY = 0x00000001,
-	NM_SETTING_COMPARE_FLAG_IGNORE_ID = 0x00000002,
-	NM_SETTING_COMPARE_FLAG_IGNORE_SECRETS = 0x00000004,
-	NM_SETTING_COMPARE_FLAG_IGNORE_AGENT_OWNED_SECRETS = 0x00000008,
-	NM_SETTING_COMPARE_FLAG_IGNORE_NOT_SAVED_SECRETS = 0x00000010,
-	NM_SETTING_COMPARE_FLAG_DIFF_RESULT_WITH_DEFAULT = 0x00000020,
-	NM_SETTING_COMPARE_FLAG_DIFF_RESULT_NO_DEFAULT = 0x00000040,
-	NM_SETTING_COMPARE_FLAG_IGNORE_TIMESTAMP = 0x00000080,
-
-	/* 0x80000000 is used for a private flag */
-} NMSettingCompareFlags;
-
-

-These flags modify the comparison behavior when comparing two settings or -two connections. -

-
---- - - - + - - + - - + - - + - - + - - + - - + - - + - - +

NM_SETTING_COMPARE_FLAG_EXACT

match all properties exactly +const char * + +nm_setting_get_name ()

NM_SETTING_COMPARE_FLAG_FUZZY

match only important attributes, like SSID, - type, security settings, etc. Does not match, for example, connection ID - or UUID. + +gboolean + +nm_setting_verify ()

NM_SETTING_COMPARE_FLAG_IGNORE_ID

ignore the connection's ID + +gboolean + +nm_setting_compare ()

NM_SETTING_COMPARE_FLAG_IGNORE_SECRETS

ignore all secrets + +gboolean + +nm_setting_diff ()

NM_SETTING_COMPARE_FLAG_IGNORE_AGENT_OWNED_SECRETS

ignore secrets for which - the secret's flags indicate the secret is owned by a user secret agent - (ie, the secret's flag includes NM_SETTING_SECRET_FLAG_AGENT_OWNED) + +void + +nm_setting_enumerate_values ()

NM_SETTING_COMPARE_FLAG_IGNORE_NOT_SAVED_SECRETS

ignore secrets for which - the secret's flags indicate the secret should not be saved to persistent - storage (ie, the secret's flag includes NM_SETTING_SECRET_FLAG_NOT_SAVED) + +char * + +nm_setting_to_string ()

NM_SETTING_COMPARE_FLAG_DIFF_RESULT_WITH_DEFAULT

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

NM_SETTING_COMPARE_FLAG_DIFF_RESULT_NO_DEFAULT

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

NM_SETTING_COMPARE_FLAG_IGNORE_TIMESTAMP

ignore the connection's timestamp +const GVariantType * + +nm_setting_get_dbus_property_type ()
-
-
-

struct NMSetting

-
struct NMSetting;
-

-The NMSetting struct contains only private data. -It should only be accessed through the functions described below. -

+
+

Properties

+
+++++ + + + + + +
+gchar *nameRead
-
-
-

NMSettingClearSecretsWithFlagsFn ()

-
gboolean            (*NMSettingClearSecretsWithFlagsFn) (NMSetting *setting,
-                                                         const char *secret,
-                                                         NMSettingSecretFlags flags,
-                                                         gpointer user_data);
-
+
+

Types and Values

+
--++ - - + + - - + + - - + + - - + + - - + +

setting :

The setting for which secrets are being iterated#defineNM_SETTING_NAME

secret :

The secret's nameenumNMSettingSecretFlags

flags :

The secret's flags, eg NM_SETTING_SECRET_FLAG_AGENT_OWNED -enumNMSettingCompareFlags

user_data :

User data passed to nm_connection_clear_secrets_with_flags() -structNMSetting

Returns :

-TRUE to clear the secret, FALSE to not clear the secretenumNMSettingDiffResult
+
+

Object Hierarchy

+
    GEnum
+    ├── NMSettingCompareFlags
+    ╰── NMSettingDiffResult
+    GFlags
+    ╰── NMSettingSecretFlags
+    GObject
+    ╰── NMSetting
+        ├── NMSetting8021x
+        ├── NMSettingAdsl
+        ├── NMSettingBluetooth
+        ├── NMSettingBond
+        ├── NMSettingBridgePort
+        ├── NMSettingBridge
+        ├── NMSettingCdma
+        ├── NMSettingConnection
+        ├── NMSettingDcb
+        ├── NMSettingGeneric
+        ├── NMSettingGsm
+        ├── NMSettingInfiniband
+        ├── NMSettingIPConfig
+        ├── NMSettingOlpcMesh
+        ├── NMSettingPpp
+        ├── NMSettingPppoe
+        ├── NMSettingSerial
+        ├── NMSettingTeamPort
+        ├── NMSettingTeam
+        ├── NMSettingVlan
+        ├── NMSettingVpn
+        ├── NMSettingWimax
+        ├── NMSettingWired
+        ├── NMSettingWirelessSecurity
+        ╰── NMSettingWireless
+
+
+
+

Description

+

Each NMSetting contains properties that describe configuration that applies +to a specific network layer (like IPv4 or IPv6 configuration) or device type +(like Ethernet, or Wi-Fi). A collection of individual settings together +make up an NMConnection. Each property is strongly typed and usually has +a number of allowed values. See each NMSetting subclass for a description +of properties and allowed values.

+
+
+

Functions

+
+

NM_SETTING_PARAM_REQUIRED

+
#define NM_SETTING_PARAM_REQUIRED     (1 << (1 + G_PARAM_USER_SHIFT))
+
+

+

+

-

NMSettingClass

-
typedef struct {
-	GObjectClass parent;
-
-	/* Virtual functions */
-	gint        (*verify)            (NMSetting     *setting,
-	                                  NMConnection  *connection,
-	                                  GError       **error);
-
-	GPtrArray  *(*need_secrets)      (NMSetting  *setting);
-
-	int         (*update_one_secret) (NMSetting  *setting,
-	                                  const char *key,
-	                                  GVariant   *value,
-	                                  GError    **error);
-
-	gboolean    (*get_secret_flags)  (NMSetting  *setting,
-	                                  const char *secret_name,
-	                                  gboolean verify_secret,
-	                                  NMSettingSecretFlags *out_flags,
-	                                  GError **error);
-
-	gboolean    (*set_secret_flags)  (NMSetting  *setting,
-	                                  const char *secret_name,
-	                                  gboolean verify_secret,
-	                                  NMSettingSecretFlags flags,
-	                                  GError **error);
-
-	gboolean    (*clear_secrets_with_flags) (NMSetting *setting,
-	                                         GParamSpec *pspec,
-	                                         NMSettingClearSecretsWithFlagsFn func,
-	                                         gpointer user_data);
-
-	/* Returns TRUE if the given property contains the same value in both settings */
-	gboolean    (*compare_property)  (NMSetting *setting,
-	                                  NMSetting *other,
-	                                  const GParamSpec *prop_spec,
-	                                  NMSettingCompareFlags flags);
-} NMSettingClass;
+

NM_SETTING_PARAM_SECRET

+
#define NM_SETTING_PARAM_SECRET       (1 << (2 + G_PARAM_USER_SHIFT))
+
+

+

+
+
+
+

NM_SETTING_PARAM_FUZZY_IGNORE

+
#define NM_SETTING_PARAM_FUZZY_IGNORE (1 << (3 + G_PARAM_USER_SHIFT))
 


-

NMSettingValueIterFn ()

-
void                (*NMSettingValueIterFn)             (NMSetting *setting,
-                                                         const char *key,
-                                                         const GValue *value,
-                                                         GParamFlags flags,
-                                                         gpointer user_data);
-
+

NMSettingClearSecretsWithFlagsFn ()

+
gboolean
+(*NMSettingClearSecretsWithFlagsFn) (NMSetting *setting,
+                                     const char *secret,
+                                     NMSettingSecretFlags flags,
+                                     gpointer user_data);
+
+

Parameters

+
--+++ - - + + + - - + + + - - + + + - - - - - - + + +

setting :

The setting for which properties are being iterated, given to -nm_setting_enumerate_values() -

setting

The setting for which secrets are being iterated

 

key :

The value/property name

secret

The secret's name

 

value :

The property's value

flags

The secret's flags, eg NM_SETTING_SECRET_FLAG_AGENT_OWNED

 

flags :

The property's flags, like NM_SETTING_PARAM_SECRET -

user_data :

User data passed to nm_setting_enumerate_values() -

user_data

User data passed to nm_connection_clear_secrets_with_flags()

 
+
+

Returns

+

TRUE to clear the secret, FALSE to not clear the secret

+

+
+

-

nm_setting_lookup_type ()

-
GType               nm_setting_lookup_type              (const char *name);
-

-Returns the GType of the setting's class for a given setting name. -

-
+

NMSettingValueIterFn ()

+
void
+(*NMSettingValueIterFn) (NMSetting *setting,
+                         const char *key,
+                         const GValue *value,
+                         GParamFlags flags,
+                         gpointer user_data);
+
+

Parameters

+
--+++ - - + + + + + + + + + + + + + + + + + + - - + + +

name :

a setting name

setting

The setting for which properties are being iterated, given to +nm_setting_enumerate_values()

 

key

The value/property name

 

value

The property's value

 

flags

The property's flags, like NM_SETTING_PARAM_SECRET

 

Returns :

the GType of the setting's class, or G_TYPE_INVALID if -name is not recognized.

user_data

User data passed to nm_setting_enumerate_values()

 
+

-

nm_setting_duplicate ()

-
NMSetting *         nm_setting_duplicate                (NMSetting *setting);
-

-Duplicates a NMSetting. -

-
+

nm_setting_lookup_type ()

+
GType
+nm_setting_lookup_type (const char *name);
+

Returns the GType of the setting's class for a given setting name.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSetting to duplicate

Returns :

a new NMSetting containing the same properties and values as the -source NMSetting. [transfer full] -

name

a setting name

 
+
+

Returns

+

the GType of the setting's class, or G_TYPE_INVALID if +name +is not recognized.

+

+
+

-

nm_setting_get_name ()

-
const char *        nm_setting_get_name                 (NMSetting *setting);
-

-Returns the type name of the NMSetting object -

-
+

nm_setting_duplicate ()

+
NMSetting *
+nm_setting_duplicate (NMSetting *setting);
+

Duplicates a NMSetting.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSetting -

Returns :

a string containing the type name of the NMSetting object, -like 'ppp' or 'wireless' or 'wired'.

setting

the NMSetting to duplicate

 
+
+

Returns

+

a new NMSetting containing the same properties and values as the +source NMSetting.

+

[transfer full]

+
+

-

nm_setting_verify ()

-
gboolean            nm_setting_verify                   (NMSetting *setting,
-                                                         NMConnection *connection,
-                                                         GError **error);
-

-Validates the setting. Each setting's properties have allowed values, and -some are dependent on other values (hence the need for connection). The -returned GError contains information about which property of the setting -failed validation, and in what way that property failed validation. -

-
+

nm_setting_get_name ()

+
const char *
+nm_setting_get_name (NMSetting *setting);
+

Returns the type name of the NMSetting object

+
+

Parameters

+
--++++ + + + + + +

setting

the NMSetting

 
+
+
+

Returns

+

a string containing the type name of the NMSetting object, +like 'ppp' or 'wireless' or 'wired'.

+

+
+ +
+
+

nm_setting_verify ()

+
gboolean
+nm_setting_verify (NMSetting *setting,
+                   NMConnection *connection,
+                   GError **error);
+

Validates the setting. Each setting's properties have allowed values, and +some are dependent on other values (hence the need for connection +). The +returned GError contains information about which property of the setting +failed validation, and in what way that property failed validation.

+
+

Parameters

+
++++ - - + + + - - + + + - - - - - - + + +

setting :

the NMSetting to verify

setting

the NMSetting to verify

 

connection :

the NMConnection that setting came from, or -NULL if setting is being verified in isolation. [allow-none] -

connection

the NMConnection that setting +came from, or +NULL if setting +is being verified in isolation.

[allow-none]

error :

location to store error, or NULL -

Returns :

-TRUE if the setting is valid, FALSE if it is not

error

location to store error, or NULL

 
+
+

Returns

+

TRUE if the setting is valid, FALSE if it is not

+

+
+

-

nm_setting_compare ()

-
gboolean            nm_setting_compare                  (NMSetting *a,
-                                                         NMSetting *b,
-                                                         NMSettingCompareFlags flags);
-

-Compares two NMSetting objects for similarity, with comparison behavior -modified by a set of flags. See the documentation for NMSettingCompareFlags -for a description of each flag's behavior. -

-
+

nm_setting_compare ()

+
gboolean
+nm_setting_compare (NMSetting *a,
+                    NMSetting *b,
+                    NMSettingCompareFlags flags);
+

Compares two NMSetting objects for similarity, with comparison behavior +modified by a set of flags. See the documentation for NMSettingCompareFlags +for a description of each flag's behavior.

+
+

Parameters

+
--+++ - - + + + - - - - - - + + + - - + + +

a :

a NMSetting -

a

a NMSetting

 

b :

a second NMSetting to compare with the first

flags :

compare flags, e.g. NM_SETTING_COMPARE_FLAG_EXACT -

b

a second NMSetting to compare with the first

 

Returns :

-TRUE if the comparison succeeds, FALSE if it does not

flags

compare flags, e.g. NM_SETTING_COMPARE_FLAG_EXACT

 
+
+

Returns

+

TRUE if the comparison succeeds, FALSE if it does not

+

+
+
-

enum NMSettingDiffResult

-
typedef enum {
-	NM_SETTING_DIFF_RESULT_UNKNOWN = 0x00000000,
-	NM_SETTING_DIFF_RESULT_IN_A =    0x00000001,
-	NM_SETTING_DIFF_RESULT_IN_B =    0x00000002,
-	NM_SETTING_DIFF_RESULT_IN_A_DEFAULT = 0x00000004,
-	NM_SETTING_DIFF_RESULT_IN_B_DEFAULT = 0x00000004,
-} NMSettingDiffResult;
-
-

-These values indicate the result of a setting difference operation. -

-
+

nm_setting_diff ()

+
gboolean
+nm_setting_diff (NMSetting *a,
+                 NMSetting *b,
+                 NMSettingCompareFlags flags,
+                 gboolean invert_results,
+                 GHashTable **results);
+

Compares two NMSetting objects for similarity, with comparison behavior +modified by a set of flags. See the documentation for NMSettingCompareFlags +for a description of each flag's behavior. If the settings differ, the keys +of each setting that differ from the other are added to results +, mapped to +one or more NMSettingDiffResult values.

+
+

Parameters

+
--+++ - - + + + - - + + + - - + + + - - + + + - - + + +

NM_SETTING_DIFF_RESULT_UNKNOWN

unknown result -

a

a NMSetting

 

NM_SETTING_DIFF_RESULT_IN_A

the property is present in setting A -

b

a second NMSetting to compare with the first

 

NM_SETTING_DIFF_RESULT_IN_B

the property is present in setting B -

flags

compare flags, e.g. NM_SETTING_COMPARE_FLAG_EXACT

 

NM_SETTING_DIFF_RESULT_IN_A_DEFAULT

the property is present in -setting A but is set to the default value. This flag is only set, -if you specify NM_SETTING_COMPARE_FLAG_DIFF_RESULT_WITH_DEFAULT. -

invert_results

this parameter is used internally by libnm and should +be set to FALSE. If TRUE inverts the meaning of the NMSettingDiffResult.

 

NM_SETTING_DIFF_RESULT_IN_B_DEFAULT

analog to NM_SETTING_DIFF_RESULT_IN_A_DEFAULT. -

results

if the +settings differ, on return a hash table mapping the differing keys to one or +more NMSettingDiffResult values OR-ed together. If the settings do not +differ, any hash table passed in is unmodified. If no hash table is passed +in and the settings differ, a new one is created and returned.

[inout][transfer full][element-type utf8 guint32]
+
+

Returns

+

TRUE if the settings contain the same values, FALSE if they do not

+

+
+
-

nm_setting_diff ()

-
gboolean            nm_setting_diff                     (NMSetting *a,
-                                                         NMSetting *b,
-                                                         NMSettingCompareFlags flags,
-                                                         gboolean invert_results,
-                                                         GHashTable **results);
-

-Compares two NMSetting objects for similarity, with comparison behavior -modified by a set of flags. See the documentation for NMSettingCompareFlags -for a description of each flag's behavior. If the settings differ, the keys -of each setting that differ from the other are added to results, mapped to -one or more NMSettingDiffResult values. -

-
+

nm_setting_enumerate_values ()

+
void
+nm_setting_enumerate_values (NMSetting *setting,
+                             NMSettingValueIterFn func,
+                             gpointer user_data);
+

Iterates over each property of the NMSetting object, calling the supplied +user function for each property.

+
+

Parameters

+
--+++ - - + + + - - + + + - - + + + + +

a :

a NMSetting -

setting

the NMSetting

 

b :

a second NMSetting to compare with the first

func

user-supplied function called for each property of the setting.

[scope call]

flags :

compare flags, e.g. NM_SETTING_COMPARE_FLAG_EXACT -

user_data

user data passed to func +at each invocation

 
+
+ +
+
+

nm_setting_to_string ()

+
char *
+nm_setting_to_string (NMSetting *setting);
+

Convert the setting into a string. For debugging purposes ONLY, should NOT +be used for serialization of the setting, or machine-parsed in any way. The +output format is not guaranteed to be stable and may change at any time.

+
+

Parameters

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

setting

the NMSetting

 
+
+
+

Returns

+

an allocated string containing a textual representation of the +setting's properties and values (including secrets!), which the caller should +free with g_free()

+

+
+
+
+
+

nm_setting_get_secret_flags ()

+
gboolean
+nm_setting_get_secret_flags (NMSetting *setting,
+                             const char *secret_name,
+                             NMSettingSecretFlags *out_flags,
+                             GError **error);
+

For a given secret, retrieves the NMSettingSecretFlags describing how to +handle that secret.

+
+

Parameters

+
+++++ + - - + + + - - + + + + + + + + - - + + +

invert_results :

this parameter is used internally by libnm and should -be set to FALSE. If TRUE inverts the meaning of the NMSettingDiffResult.

setting

the NMSetting

 

results :

if the -settings differ, on return a hash table mapping the differing keys to one or -more NMSettingDiffResult values OR-ed together. If the settings do not -differ, any hash table passed in is unmodified. If no hash table is passed -in and the settings differ, a new one is created and returned. [inout][transfer full][element-type utf8 guint32] -

secret_name

the secret key name to get flags for

 

out_flags

on success, the NMSettingSecretFlags for the secret

 

Returns :

-TRUE if the settings contain the same values, FALSE if they do not

error

location to store error, or NULL

 
+
+

Returns

+

TRUE on success (if the given secret name was a valid property of +this setting, and if that property is secret), FALSE if not

+

+
+

-

nm_setting_enumerate_values ()

-
void                nm_setting_enumerate_values         (NMSetting *setting,
-                                                         NMSettingValueIterFn func,
-                                                         gpointer user_data);
-

-Iterates over each property of the NMSetting object, calling the supplied -user function for each property. -

-
+

nm_setting_set_secret_flags ()

+
gboolean
+nm_setting_set_secret_flags (NMSetting *setting,
+                             const char *secret_name,
+                             NMSettingSecretFlags flags,
+                             GError **error);
+

For a given secret, stores the NMSettingSecretFlags describing how to +handle that secret.

+
+

Parameters

+
--+++ - - + + + - - + + + + + + + + - - + + +

setting :

the NMSetting -

setting

the NMSetting

 

func :

user-supplied function called for each property of the setting. [scope call] -

secret_name

the secret key name to set flags for

 

flags

the NMSettingSecretFlags for the secret

 

user_data :

user data passed to func at each invocation

error

location to store error, or NULL

 
+
+

Returns

+

TRUE on success (if the given secret name was a valid property of +this setting, and if that property is secret), FALSE if not

+

+
+
-

nm_setting_to_string ()

-
char *              nm_setting_to_string                (NMSetting *setting);
-

-Convert the setting into a string. For debugging purposes ONLY, should NOT -be used for serialization of the setting, or machine-parsed in any way. The -output format is not guaranteed to be stable and may change at any time. -

-
+

nm_setting_get_dbus_property_type ()

+
const GVariantType *
+nm_setting_get_dbus_property_type (NMSetting *setting,
+                                   const char *property_name);
+

Gets the D-Bus marshalling type of a property. property_name + is a D-Bus +property name, which may not necessarily be a GObject property.

+
+

Parameters

+
--+++ - - + + + - - + + +

setting :

the NMSetting -

setting

an NMSetting

 

Returns :

an allocated string containing a textual representation of the -setting's properties and values (including secrets!), which the caller should -free with g_free() -

property_name

the property of setting +to get the type of

 
-
+
+

Returns

+

the D-Bus marshalling type of property +on setting +.

+

+
+ + +
+

Types and Values

-

nm_setting_get_secret_flags ()

-
gboolean            nm_setting_get_secret_flags         (NMSetting *setting,
-                                                         const char *secret_name,
-                                                         NMSettingSecretFlags *out_flags,
-                                                         GError **error);
+

NM_SETTING_NAME

+
#define NM_SETTING_NAME "name"
+

-For a given secret, retrieves the NMSettingSecretFlags describing how to -handle that secret.

-
+ +
+
+

enum NMSettingSecretFlags

+

These flags indicate specific behavior related to handling of a secret. Each +secret has a corresponding set of these flags which indicate how the secret +is to be stored and/or requested when it is needed.

+
+

Members

+
--+++ - - + + - - - - - - + + + - - + + - - + + +

setting :

the NMSetting +

NM_SETTING_SECRET_FLAG_NONE

+

the system is responsible for providing and +storing this secret (default)

 

secret_name :

the secret key name to get flags for

out_flags :

on success, the NMSettingSecretFlags for the secret

NM_SETTING_SECRET_FLAG_AGENT_OWNED

+

a user secret agent is responsible +for providing and storing this secret; when it is required agents will be +asked to retrieve it

+
 

error :

location to store error, or NULL +

NM_SETTING_SECRET_FLAG_NOT_SAVED

+

this secret should not be saved, but +should be requested from the user each time it is needed

 

Returns :

-TRUE on success (if the given secret name was a valid property of -this setting, and if that property is secret), FALSE if not

NM_SETTING_SECRET_FLAG_NOT_REQUIRED

+

in situations where it cannot be +automatically determined that the secret is required (some VPNs and PPP +providers dont require all secrets) this flag indicates that the specific +secret is not required

+
 
+

-

nm_setting_set_secret_flags ()

-
gboolean            nm_setting_set_secret_flags         (NMSetting *setting,
-                                                         const char *secret_name,
-                                                         NMSettingSecretFlags flags,
-                                                         GError **error);
-

-For a given secret, stores the NMSettingSecretFlags describing how to -handle that secret. -

-
+

enum NMSettingCompareFlags

+

These flags modify the comparison behavior when comparing two settings or +two connections.

+
+

Members

+
--+++ - - + + - - + + + - - + + + + + + + + - - + + + + + + + + + + + + + + + + + - - + + +

setting :

the NMSetting +

NM_SETTING_COMPARE_FLAG_EXACT

+

match all properties exactly

 

secret_name :

the secret key name to set flags for

NM_SETTING_COMPARE_FLAG_FUZZY

+

match only important attributes, like SSID, + type, security settings, etc. Does not match, for example, connection ID + or UUID.

+
 

flags :

the NMSettingSecretFlags for the secret

NM_SETTING_COMPARE_FLAG_IGNORE_ID

+

ignore the connection's ID

+
 

NM_SETTING_COMPARE_FLAG_IGNORE_SECRETS

+

ignore all secrets

+
 

error :

location to store error, or NULL +

NM_SETTING_COMPARE_FLAG_IGNORE_AGENT_OWNED_SECRETS

+

ignore secrets for which + the secret's flags indicate the secret is owned by a user secret agent + (ie, the secret's flag includes NM_SETTING_SECRET_FLAG_AGENT_OWNED +)

+
 

NM_SETTING_COMPARE_FLAG_IGNORE_NOT_SAVED_SECRETS

+

ignore secrets for which + the secret's flags indicate the secret should not be saved to persistent + storage (ie, the secret's flag includes NM_SETTING_SECRET_FLAG_NOT_SAVED +)

+
 

NM_SETTING_COMPARE_FLAG_DIFF_RESULT_WITH_DEFAULT

+

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

+
 

NM_SETTING_COMPARE_FLAG_DIFF_RESULT_NO_DEFAULT

+

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

 

Returns :

-TRUE on success (if the given secret name was a valid property of -this setting, and if that property is secret), FALSE if not

NM_SETTING_COMPARE_FLAG_IGNORE_TIMESTAMP

+

ignore the connection's timestamp

+
 
+
-

nm_setting_get_dbus_property_type ()

-
const GVariantType * nm_setting_get_dbus_property_type  (NMSetting *setting,
-                                                         const char *property_name);
-

-Gets the D-Bus marshalling type of a property. property_name is a D-Bus -property name, which may not necessarily be a GObject property. -

-
+

struct NMSetting

+
struct NMSetting;
+

The NMSetting struct contains only private data. +It should only be accessed through the functions described below.

+ +
+
+

enum NMSettingDiffResult

+

These values indicate the result of a setting difference operation.

+
+

Members

+
--+++ - - + + - - + + + - - + + + + + + + + + + + + +

setting :

an NMSetting +

NM_SETTING_DIFF_RESULT_UNKNOWN

+

unknown result

 

property_name :

the property of setting to get the type of

NM_SETTING_DIFF_RESULT_IN_A

+

the property is present in setting A

+
 

Returns :

the D-Bus marshalling type of property on setting.

NM_SETTING_DIFF_RESULT_IN_B

+

the property is present in setting B

+
 

NM_SETTING_DIFF_RESULT_IN_A_DEFAULT

+

the property is present in +setting A but is set to the default value. This flag is only set, +if you specify NM_SETTING_COMPARE_FLAG_DIFF_RESULT_WITH_DEFAULT +.

+
 

NM_SETTING_DIFF_RESULT_IN_B_DEFAULT

+

analog to NM_SETTING_DIFF_RESULT_IN_A_DEFAULT +.

+
 
+

Property Details

-

The "name" property

-
  "name"                     gchar*                : Read
-

-The setting's name, which uniquely identifies the setting within the +

The “name” property

+
  “name”                     gchar *
+

The setting's name, which uniquely identifies the setting within the connection. Each setting type has a name unique to that type, for -example "ppp" or "wireless" or "wired". -

+example "ppp" or "wireless" or "wired".

+

Flags: Read

Default value: NULL

+ Generated by GTK-Doc V1.21 \ No newline at end of file diff --git a/docs/libnm/html/NMSetting8021x.html b/docs/libnm/html/NMSetting8021x.html index ea6a7740..ba6aa73f 100644 --- a/docs/libnm/html/NMSetting8021x.html +++ b/docs/libnm/html/NMSetting8021x.html @@ -2,34 +2,28 @@ -NMSetting8021x +libnm Reference Manual: NMSetting8021x - + - - - - - - - - - - + + + + + + +
@@ -37,3215 +31,3831 @@

NMSetting8021x

NMSetting8021x — Describes 802.1x-authenticated connection properties

- +
-
-

Synopsis

-
enum                NMSetting8021xCKFormat;
-enum                NMSetting8021xCKScheme;
-#define             NM_SETTING_802_1X_SETTING_NAME
-#define             NM_SETTING_802_1X_EAP
-#define             NM_SETTING_802_1X_IDENTITY
-#define             NM_SETTING_802_1X_ANONYMOUS_IDENTITY
-#define             NM_SETTING_802_1X_PAC_FILE
-#define             NM_SETTING_802_1X_CA_CERT
-#define             NM_SETTING_802_1X_CA_PATH
-#define             NM_SETTING_802_1X_SUBJECT_MATCH
-#define             NM_SETTING_802_1X_ALTSUBJECT_MATCHES
-#define             NM_SETTING_802_1X_CLIENT_CERT
-#define             NM_SETTING_802_1X_PHASE1_PEAPVER
-#define             NM_SETTING_802_1X_PHASE1_PEAPLABEL
-#define             NM_SETTING_802_1X_PHASE1_FAST_PROVISIONING
-#define             NM_SETTING_802_1X_PHASE2_AUTH
-#define             NM_SETTING_802_1X_PHASE2_AUTHEAP
-#define             NM_SETTING_802_1X_PHASE2_CA_CERT
-#define             NM_SETTING_802_1X_PHASE2_CA_PATH
-#define             NM_SETTING_802_1X_PHASE2_SUBJECT_MATCH
-#define             NM_SETTING_802_1X_PHASE2_ALTSUBJECT_MATCHES
-#define             NM_SETTING_802_1X_PHASE2_CLIENT_CERT
-#define             NM_SETTING_802_1X_PASSWORD
-#define             NM_SETTING_802_1X_PASSWORD_FLAGS
-#define             NM_SETTING_802_1X_PASSWORD_RAW
-#define             NM_SETTING_802_1X_PASSWORD_RAW_FLAGS
-#define             NM_SETTING_802_1X_PRIVATE_KEY
-#define             NM_SETTING_802_1X_PRIVATE_KEY_PASSWORD
-#define             NM_SETTING_802_1X_PRIVATE_KEY_PASSWORD_FLAGS
-#define             NM_SETTING_802_1X_PHASE2_PRIVATE_KEY
-#define             NM_SETTING_802_1X_PHASE2_PRIVATE_KEY_PASSWORD
-#define             NM_SETTING_802_1X_PHASE2_PRIVATE_KEY_PASSWORD_FLAGS
-#define             NM_SETTING_802_1X_PIN
-#define             NM_SETTING_802_1X_PIN_FLAGS
-#define             NM_SETTING_802_1X_SYSTEM_CA_CERTS
-struct              NMSetting8021x;
-                    NMSetting8021xClass;
-NMSetting *         nm_setting_802_1x_new               (void);
-guint32             nm_setting_802_1x_get_num_eap_methods
-                                                        (NMSetting8021x *setting);
-const char *        nm_setting_802_1x_get_eap_method    (NMSetting8021x *setting,
-                                                         guint32 i);
-gboolean            nm_setting_802_1x_add_eap_method    (NMSetting8021x *setting,
-                                                         const char *eap);
-void                nm_setting_802_1x_remove_eap_method (NMSetting8021x *setting,
-                                                         guint32 i);
-gboolean            nm_setting_802_1x_remove_eap_method_by_value
-                                                        (NMSetting8021x *setting,
-                                                         const char *eap);
-void                nm_setting_802_1x_clear_eap_methods (NMSetting8021x *setting);
-const char *        nm_setting_802_1x_get_identity      (NMSetting8021x *setting);
-const char *        nm_setting_802_1x_get_anonymous_identity
-                                                        (NMSetting8021x *setting);
-const char *        nm_setting_802_1x_get_pac_file      (NMSetting8021x *setting);
-gboolean            nm_setting_802_1x_get_system_ca_certs
-                                                        (NMSetting8021x *setting);
-const char *        nm_setting_802_1x_get_ca_path       (NMSetting8021x *setting);
-const char *        nm_setting_802_1x_get_phase2_ca_path
-                                                        (NMSetting8021x *setting);
-NMSetting8021xCKScheme nm_setting_802_1x_get_ca_cert_scheme
-                                                        (NMSetting8021x *setting);
-GBytes *            nm_setting_802_1x_get_ca_cert_blob  (NMSetting8021x *setting);
-const char *        nm_setting_802_1x_get_ca_cert_path  (NMSetting8021x *setting);
-gboolean            nm_setting_802_1x_set_ca_cert       (NMSetting8021x *setting,
-                                                         const char *cert_path,
-                                                         NMSetting8021xCKScheme scheme,
-                                                         NMSetting8021xCKFormat *out_format,
-                                                         GError **error);
-const char *        nm_setting_802_1x_get_subject_match (NMSetting8021x *setting);
-guint32             nm_setting_802_1x_get_num_altsubject_matches
-                                                        (NMSetting8021x *setting);
-const char *        nm_setting_802_1x_get_altsubject_match
-                                                        (NMSetting8021x *setting,
-                                                         guint32 i);
-gboolean            nm_setting_802_1x_add_altsubject_match
-                                                        (NMSetting8021x *setting,
-                                                         const char *altsubject_match);
-void                nm_setting_802_1x_remove_altsubject_match
-                                                        (NMSetting8021x *setting,
-                                                         guint32 i);
-gboolean            nm_setting_802_1x_remove_altsubject_match_by_value
-                                                        (NMSetting8021x *setting,
-                                                         const char *altsubject_match);
-void                nm_setting_802_1x_clear_altsubject_matches
-                                                        (NMSetting8021x *setting);
-NMSetting8021xCKScheme nm_setting_802_1x_get_client_cert_scheme
-                                                        (NMSetting8021x *setting);
-GBytes *            nm_setting_802_1x_get_client_cert_blob
-                                                        (NMSetting8021x *setting);
-const char *        nm_setting_802_1x_get_client_cert_path
-                                                        (NMSetting8021x *setting);
-gboolean            nm_setting_802_1x_set_client_cert   (NMSetting8021x *setting,
-                                                         const char *cert_path,
-                                                         NMSetting8021xCKScheme scheme,
-                                                         NMSetting8021xCKFormat *out_format,
-                                                         GError **error);
-const char *        nm_setting_802_1x_get_phase1_peapver
-                                                        (NMSetting8021x *setting);
-const char *        nm_setting_802_1x_get_phase1_peaplabel
-                                                        (NMSetting8021x *setting);
-const char *        nm_setting_802_1x_get_phase1_fast_provisioning
-                                                        (NMSetting8021x *setting);
-const char *        nm_setting_802_1x_get_phase2_auth   (NMSetting8021x *setting);
-const char *        nm_setting_802_1x_get_phase2_autheap
-                                                        (NMSetting8021x *setting);
-NMSetting8021xCKScheme nm_setting_802_1x_get_phase2_ca_cert_scheme
-                                                        (NMSetting8021x *setting);
-GBytes *            nm_setting_802_1x_get_phase2_ca_cert_blob
-                                                        (NMSetting8021x *setting);
-const char *        nm_setting_802_1x_get_phase2_ca_cert_path
-                                                        (NMSetting8021x *setting);
-gboolean            nm_setting_802_1x_set_phase2_ca_cert
-                                                        (NMSetting8021x *setting,
-                                                         const char *cert_path,
-                                                         NMSetting8021xCKScheme scheme,
-                                                         NMSetting8021xCKFormat *out_format,
-                                                         GError **error);
-const char *        nm_setting_802_1x_get_phase2_subject_match
-                                                        (NMSetting8021x *setting);
-guint32             nm_setting_802_1x_get_num_phase2_altsubject_matches
-                                                        (NMSetting8021x *setting);
-const char *        nm_setting_802_1x_get_phase2_altsubject_match
-                                                        (NMSetting8021x *setting,
-                                                         guint32 i);
-gboolean            nm_setting_802_1x_add_phase2_altsubject_match
-                                                        (NMSetting8021x *setting,
-                                                         const char *phase2_altsubject_match);
-void                nm_setting_802_1x_remove_phase2_altsubject_match
-                                                        (NMSetting8021x *setting,
-                                                         guint32 i);
-gboolean            nm_setting_802_1x_remove_phase2_altsubject_match_by_value
-                                                        (NMSetting8021x *setting,
-                                                         const char *phase2_altsubject_match);
-void                nm_setting_802_1x_clear_phase2_altsubject_matches
-                                                        (NMSetting8021x *setting);
-NMSetting8021xCKScheme nm_setting_802_1x_get_phase2_client_cert_scheme
-                                                        (NMSetting8021x *setting);
-GBytes *            nm_setting_802_1x_get_phase2_client_cert_blob
-                                                        (NMSetting8021x *setting);
-const char *        nm_setting_802_1x_get_phase2_client_cert_path
-                                                        (NMSetting8021x *setting);
-gboolean            nm_setting_802_1x_set_phase2_client_cert
-                                                        (NMSetting8021x *setting,
-                                                         const char *cert_path,
-                                                         NMSetting8021xCKScheme scheme,
-                                                         NMSetting8021xCKFormat *out_format,
-                                                         GError **error);
-const char *        nm_setting_802_1x_get_password      (NMSetting8021x *setting);
-NMSettingSecretFlags nm_setting_802_1x_get_password_flags
-                                                        (NMSetting8021x *setting);
-GBytes *            nm_setting_802_1x_get_password_raw  (NMSetting8021x *setting);
-NMSettingSecretFlags nm_setting_802_1x_get_password_raw_flags
-                                                        (NMSetting8021x *setting);
-const char *        nm_setting_802_1x_get_pin           (NMSetting8021x *setting);
-NMSettingSecretFlags nm_setting_802_1x_get_pin_flags    (NMSetting8021x *setting);
-NMSetting8021xCKScheme nm_setting_802_1x_get_private_key_scheme
-                                                        (NMSetting8021x *setting);
-GBytes *            nm_setting_802_1x_get_private_key_blob
-                                                        (NMSetting8021x *setting);
-const char *        nm_setting_802_1x_get_private_key_path
-                                                        (NMSetting8021x *setting);
-gboolean            nm_setting_802_1x_set_private_key   (NMSetting8021x *setting,
-                                                         const char *key_path,
-                                                         const char *password,
-                                                         NMSetting8021xCKScheme scheme,
-                                                         NMSetting8021xCKFormat *out_format,
-                                                         GError **error);
-const char *        nm_setting_802_1x_get_private_key_password
-                                                        (NMSetting8021x *setting);
-NMSettingSecretFlags nm_setting_802_1x_get_private_key_password_flags
-                                                        (NMSetting8021x *setting);
-NMSetting8021xCKFormat nm_setting_802_1x_get_private_key_format
-                                                        (NMSetting8021x *setting);
-NMSetting8021xCKScheme nm_setting_802_1x_get_phase2_private_key_scheme
-                                                        (NMSetting8021x *setting);
-GBytes *            nm_setting_802_1x_get_phase2_private_key_blob
-                                                        (NMSetting8021x *setting);
-const char *        nm_setting_802_1x_get_phase2_private_key_path
-                                                        (NMSetting8021x *setting);
-gboolean            nm_setting_802_1x_set_phase2_private_key
-                                                        (NMSetting8021x *setting,
-                                                         const char *key_path,
-                                                         const char *password,
-                                                         NMSetting8021xCKScheme scheme,
-                                                         NMSetting8021xCKFormat *out_format,
-                                                         GError **error);
-const char *        nm_setting_802_1x_get_phase2_private_key_password
-                                                        (NMSetting8021x *setting);
-NMSettingSecretFlags nm_setting_802_1x_get_phase2_private_key_password_flags
-                                                        (NMSetting8021x *setting);
-NMSetting8021xCKFormat nm_setting_802_1x_get_phase2_private_key_format
-                                                        (NMSetting8021x *setting);
-
-
-
-

Object Hierarchy

-
-  GEnum
-   +----NMSetting8021xCKFormat
-
-
-  GEnum
-   +----NMSetting8021xCKScheme
-
-
-  GObject
-   +----NMSetting
-         +----NMSetting8021x
-
-
-
-

Properties

-
-  "altsubject-matches"       GStrv                 : Read / Write
-  "anonymous-identity"       gchar*                : Read / Write
-  "ca-cert"                  GBytes*               : Read / Write
-  "ca-path"                  gchar*                : Read / Write
-  "client-cert"              GBytes*               : Read / Write
-  "eap"                      GStrv                 : Read / Write
-  "identity"                 gchar*                : Read / Write
-  "pac-file"                 gchar*                : Read / Write
-  "password"                 gchar*                : Read / Write
-  "password-flags"           NMSettingSecretFlags  : Read / Write
-  "password-raw"             GBytes*               : Read / Write
-  "password-raw-flags"       NMSettingSecretFlags  : Read / Write
-  "phase1-fast-provisioning" gchar*                : Read / Write
-  "phase1-peaplabel"         gchar*                : Read / Write
-  "phase1-peapver"           gchar*                : Read / Write
-  "phase2-altsubject-matches" GStrv                 : Read / Write
-  "phase2-auth"              gchar*                : Read / Write
-  "phase2-autheap"           gchar*                : Read / Write
-  "phase2-ca-cert"           GBytes*               : Read / Write
-  "phase2-ca-path"           gchar*                : Read / Write
-  "phase2-client-cert"       GBytes*               : Read / Write
-  "phase2-private-key"       GBytes*               : Read / Write
-  "phase2-private-key-password" gchar*                : Read / Write
-  "phase2-private-key-password-flags" NMSettingSecretFlags  : Read / Write
-  "phase2-subject-match"     gchar*                : Read / Write
-  "pin"                      gchar*                : Read / Write
-  "pin-flags"                NMSettingSecretFlags  : Read / Write
-  "private-key"              GBytes*               : Read / Write
-  "private-key-password"     gchar*                : Read / Write
-  "private-key-password-flags" NMSettingSecretFlags  : Read / Write
-  "subject-match"            gchar*                : Read / Write
-  "system-ca-certs"          gboolean              : Read / Write / Construct
-
-
-
-

Description

-

-The NMSetting8021x object is a NMSetting subclass that describes -properties necessary for connection to 802.1x-authenticated networks, such as -WPA and WPA2 Enterprise Wi-Fi networks and wired 802.1x networks. 802.1x -connections typically use certificates and/or EAP authentication methods to -securely verify, identify, and authenticate the client to the network itself, -instead of simply relying on a widely shared static key. -

-

-It's a good idea to read up on wpa_supplicant configuration before using this -setting extensively, since most of the options here correspond closely with -the relevant wpa_supplicant configuration options. -

-

-Furthermore, to get a good idea of 802.1x, EAP, TLS, TTLS, etc and their -applications to Wi-Fi and wired networks, you'll want to get copies of the -following books. -

-

- 802.11 Wireless Networks: The Definitive Guide, Second Edition - Author: Matthew Gast - ISBN: 978-0596100520 -

-

- Cisco Wireless LAN Security - Authors: Krishna Sankar, Sri Sundaralingam, Darrin Miller, and Andrew Balinsky - ISBN: 978-1587051548 -

-
-

Details

-
-

enum NMSetting8021xCKFormat

-
typedef enum {
- /*< underscore_name=nm_setting_802_1x_ck_format >*/
-	NM_SETTING_802_1X_CK_FORMAT_UNKNOWN = 0,
-	NM_SETTING_802_1X_CK_FORMAT_X509,
-	NM_SETTING_802_1X_CK_FORMAT_RAW_KEY,
-	NM_SETTING_802_1X_CK_FORMAT_PKCS12
-} NMSetting8021xCKFormat;
-
-

-NMSetting8021xCKFormat values indicate the general type of a certificate -or private key -

-
+

Functions

+
--++ - - + - - + - - + - - + - -

NM_SETTING_802_1X_CK_FORMAT_UNKNOWN

unknown file format + +NMSetting * + +nm_setting_802_1x_new ()

NM_SETTING_802_1X_CK_FORMAT_X509

file contains an X.509 format certificate + +guint32 + +nm_setting_802_1x_get_num_eap_methods ()

NM_SETTING_802_1X_CK_FORMAT_RAW_KEY

file contains an old-style OpenSSL PEM -or DER private key +const char * + +nm_setting_802_1x_get_eap_method ()

NM_SETTING_802_1X_CK_FORMAT_PKCS12

file contains a PKCS#12 certificate -and private key + +gboolean + +nm_setting_802_1x_add_eap_method ()
-
-
-
-

enum NMSetting8021xCKScheme

-
typedef enum {
- /*< underscore_name=nm_setting_802_1x_ck_scheme >*/
-	NM_SETTING_802_1X_CK_SCHEME_UNKNOWN = 0,
-	NM_SETTING_802_1X_CK_SCHEME_BLOB,
-	NM_SETTING_802_1X_CK_SCHEME_PATH
-} NMSetting8021xCKScheme;
-
-

-NMSetting8021xCKScheme values indicate how a certificate or private key is -stored in the setting properties, either as a blob of the item's data, or as -a path to a certificate or private key file on the filesystem -

-
---- - - - + - - + - - + - -

NM_SETTING_802_1X_CK_SCHEME_UNKNOWN

unknown certificate or private key -scheme + +void + +nm_setting_802_1x_remove_eap_method ()

NM_SETTING_802_1X_CK_SCHEME_BLOB

certificate or key is stored as the raw -item data + +gboolean + +nm_setting_802_1x_remove_eap_method_by_value ()

NM_SETTING_802_1X_CK_SCHEME_PATH

certificate or key is stored as a path -to a file containing the certificate or key data + +void + +nm_setting_802_1x_clear_eap_methods ()
-
-
-
-

NM_SETTING_802_1X_SETTING_NAME

-
#define NM_SETTING_802_1X_SETTING_NAME "802-1x"
-
-

-

-
-
-
-

NM_SETTING_802_1X_EAP

-
#define NM_SETTING_802_1X_EAP "eap"
-
-

-

-
-
-
-

NM_SETTING_802_1X_IDENTITY

-
#define NM_SETTING_802_1X_IDENTITY "identity"
-
-

-

-
-
-
-

NM_SETTING_802_1X_ANONYMOUS_IDENTITY

-
#define NM_SETTING_802_1X_ANONYMOUS_IDENTITY "anonymous-identity"
-
-

-

-
-
-
-

NM_SETTING_802_1X_PAC_FILE

-
#define NM_SETTING_802_1X_PAC_FILE "pac-file"
-
-

-

-
-
-
-

NM_SETTING_802_1X_CA_CERT

-
#define NM_SETTING_802_1X_CA_CERT "ca-cert"
-
-

-

-
-
-
-

NM_SETTING_802_1X_CA_PATH

-
#define NM_SETTING_802_1X_CA_PATH "ca-path"
-
-

-

-
-
-
-

NM_SETTING_802_1X_SUBJECT_MATCH

-
#define NM_SETTING_802_1X_SUBJECT_MATCH "subject-match"
-
-

-

-
-
-
-

NM_SETTING_802_1X_ALTSUBJECT_MATCHES

-
#define NM_SETTING_802_1X_ALTSUBJECT_MATCHES "altsubject-matches"
-
-

-

-
-
-
-

NM_SETTING_802_1X_CLIENT_CERT

-
#define NM_SETTING_802_1X_CLIENT_CERT "client-cert"
-
-

-

-
-
-
-

NM_SETTING_802_1X_PHASE1_PEAPVER

-
#define NM_SETTING_802_1X_PHASE1_PEAPVER "phase1-peapver"
-
-

-

-
-
-
-

NM_SETTING_802_1X_PHASE1_PEAPLABEL

-
#define NM_SETTING_802_1X_PHASE1_PEAPLABEL "phase1-peaplabel"
-
-

-

-
-
-
-

NM_SETTING_802_1X_PHASE1_FAST_PROVISIONING

-
#define NM_SETTING_802_1X_PHASE1_FAST_PROVISIONING "phase1-fast-provisioning"
-
-

-

-
-
-
-

NM_SETTING_802_1X_PHASE2_AUTH

-
#define NM_SETTING_802_1X_PHASE2_AUTH "phase2-auth"
-
-

-

-
-
-
-

NM_SETTING_802_1X_PHASE2_AUTHEAP

-
#define NM_SETTING_802_1X_PHASE2_AUTHEAP "phase2-autheap"
-
-

-

-
-
-
-

NM_SETTING_802_1X_PHASE2_CA_CERT

-
#define NM_SETTING_802_1X_PHASE2_CA_CERT "phase2-ca-cert"
-
-

-

-
-
-
-

NM_SETTING_802_1X_PHASE2_CA_PATH

-
#define NM_SETTING_802_1X_PHASE2_CA_PATH "phase2-ca-path"
-
-

-

-
-
-
-

NM_SETTING_802_1X_PHASE2_SUBJECT_MATCH

-
#define NM_SETTING_802_1X_PHASE2_SUBJECT_MATCH "phase2-subject-match"
-
-

-

-
-
-
-

NM_SETTING_802_1X_PHASE2_ALTSUBJECT_MATCHES

-
#define NM_SETTING_802_1X_PHASE2_ALTSUBJECT_MATCHES "phase2-altsubject-matches"
-
-

-

-
-
-
-

NM_SETTING_802_1X_PHASE2_CLIENT_CERT

-
#define NM_SETTING_802_1X_PHASE2_CLIENT_CERT "phase2-client-cert"
-
-

-

-
-
-
-

NM_SETTING_802_1X_PASSWORD

-
#define NM_SETTING_802_1X_PASSWORD "password"
-
-

-

-
-
-
-

NM_SETTING_802_1X_PASSWORD_FLAGS

-
#define NM_SETTING_802_1X_PASSWORD_FLAGS "password-flags"
-
-

-

-
-
-
-

NM_SETTING_802_1X_PASSWORD_RAW

-
#define NM_SETTING_802_1X_PASSWORD_RAW "password-raw"
-
-

-

-
-
-
-

NM_SETTING_802_1X_PASSWORD_RAW_FLAGS

-
#define NM_SETTING_802_1X_PASSWORD_RAW_FLAGS "password-raw-flags"
-
-

-

-
-
-
-

NM_SETTING_802_1X_PRIVATE_KEY

-
#define NM_SETTING_802_1X_PRIVATE_KEY "private-key"
-
-

-

-
-
-
-

NM_SETTING_802_1X_PRIVATE_KEY_PASSWORD

-
#define NM_SETTING_802_1X_PRIVATE_KEY_PASSWORD "private-key-password"
-
-

-

-
-
-
-

NM_SETTING_802_1X_PRIVATE_KEY_PASSWORD_FLAGS

-
#define NM_SETTING_802_1X_PRIVATE_KEY_PASSWORD_FLAGS "private-key-password-flags"
-
-

-

-
-
-
-

NM_SETTING_802_1X_PHASE2_PRIVATE_KEY

-
#define NM_SETTING_802_1X_PHASE2_PRIVATE_KEY "phase2-private-key"
-
-

-

-
-
-
-

NM_SETTING_802_1X_PHASE2_PRIVATE_KEY_PASSWORD

-
#define NM_SETTING_802_1X_PHASE2_PRIVATE_KEY_PASSWORD "phase2-private-key-password"
-
-

-

-
-
-
-

NM_SETTING_802_1X_PHASE2_PRIVATE_KEY_PASSWORD_FLAGS

-
#define NM_SETTING_802_1X_PHASE2_PRIVATE_KEY_PASSWORD_FLAGS "phase2-private-key-password-flags"
-
-

-

+ +const char * + + +nm_setting_802_1x_get_identity () + + + +const char * + + +nm_setting_802_1x_get_anonymous_identity () + + + +const char * + + +nm_setting_802_1x_get_pac_file () + + + + +gboolean + + +nm_setting_802_1x_get_system_ca_certs () + + + +const char * + + +nm_setting_802_1x_get_ca_path () + + + +const char * + + +nm_setting_802_1x_get_phase2_ca_path () + + + + +NMSetting8021xCKScheme + + +nm_setting_802_1x_get_ca_cert_scheme () + + + + +GBytes * + + +nm_setting_802_1x_get_ca_cert_blob () + + + +const char * + + +nm_setting_802_1x_get_ca_cert_path () + + + + +gboolean + + +nm_setting_802_1x_set_ca_cert () + + + +const char * + + +nm_setting_802_1x_get_subject_match () + + + + +guint32 + + +nm_setting_802_1x_get_num_altsubject_matches () + + + +const char * + + +nm_setting_802_1x_get_altsubject_match () + + + + +gboolean + + +nm_setting_802_1x_add_altsubject_match () + + + + +void + + +nm_setting_802_1x_remove_altsubject_match () + + + + +gboolean + + +nm_setting_802_1x_remove_altsubject_match_by_value () + + + + +void + + +nm_setting_802_1x_clear_altsubject_matches () + + + + +NMSetting8021xCKScheme + + +nm_setting_802_1x_get_client_cert_scheme () + + + + +GBytes * + + +nm_setting_802_1x_get_client_cert_blob () + + + +const char * + + +nm_setting_802_1x_get_client_cert_path () + + + + +gboolean + + +nm_setting_802_1x_set_client_cert () + + + +const char * + + +nm_setting_802_1x_get_phase1_peapver () + + + +const char * + + +nm_setting_802_1x_get_phase1_peaplabel () + + + +const char * + + +nm_setting_802_1x_get_phase1_fast_provisioning () + + + +const char * + + +nm_setting_802_1x_get_phase2_auth () + + + +const char * + + +nm_setting_802_1x_get_phase2_autheap () + + + + +NMSetting8021xCKScheme + + +nm_setting_802_1x_get_phase2_ca_cert_scheme () + + + + +GBytes * + + +nm_setting_802_1x_get_phase2_ca_cert_blob () + + + +const char * + + +nm_setting_802_1x_get_phase2_ca_cert_path () + + + + +gboolean + + +nm_setting_802_1x_set_phase2_ca_cert () + + + +const char * + + +nm_setting_802_1x_get_phase2_subject_match () + + + + +guint32 + + +nm_setting_802_1x_get_num_phase2_altsubject_matches () + + + +const char * + + +nm_setting_802_1x_get_phase2_altsubject_match () + + + + +gboolean + + +nm_setting_802_1x_add_phase2_altsubject_match () + + + + +void + + +nm_setting_802_1x_remove_phase2_altsubject_match () + + + + +gboolean + + +nm_setting_802_1x_remove_phase2_altsubject_match_by_value () + + + + +void + + +nm_setting_802_1x_clear_phase2_altsubject_matches () + + + + +NMSetting8021xCKScheme + + +nm_setting_802_1x_get_phase2_client_cert_scheme () + + + + +GBytes * + + +nm_setting_802_1x_get_phase2_client_cert_blob () + + + +const char * + + +nm_setting_802_1x_get_phase2_client_cert_path () + + + + +gboolean + + +nm_setting_802_1x_set_phase2_client_cert () + + + +const char * + + +nm_setting_802_1x_get_password () + + + + +NMSettingSecretFlags + + +nm_setting_802_1x_get_password_flags () + + + + +GBytes * + + +nm_setting_802_1x_get_password_raw () + + + + +NMSettingSecretFlags + + +nm_setting_802_1x_get_password_raw_flags () + + + +const char * + + +nm_setting_802_1x_get_pin () + + + + +NMSettingSecretFlags + + +nm_setting_802_1x_get_pin_flags () + + + + +NMSetting8021xCKScheme + + +nm_setting_802_1x_get_private_key_scheme () + + + + +GBytes * + + +nm_setting_802_1x_get_private_key_blob () + + + +const char * + + +nm_setting_802_1x_get_private_key_path () + + + + +gboolean + + +nm_setting_802_1x_set_private_key () + + + +const char * + + +nm_setting_802_1x_get_private_key_password () + + + + +NMSettingSecretFlags + + +nm_setting_802_1x_get_private_key_password_flags () + + + + +NMSetting8021xCKFormat + + +nm_setting_802_1x_get_private_key_format () + + + + +NMSetting8021xCKScheme + + +nm_setting_802_1x_get_phase2_private_key_scheme () + + + + +GBytes * + + +nm_setting_802_1x_get_phase2_private_key_blob () + + + +const char * + + +nm_setting_802_1x_get_phase2_private_key_path () + + + + +gboolean + + +nm_setting_802_1x_set_phase2_private_key () + + + +const char * + + +nm_setting_802_1x_get_phase2_private_key_password () + + + + +NMSettingSecretFlags + + +nm_setting_802_1x_get_phase2_private_key_password_flags () + + + + +NMSetting8021xCKFormat + + +nm_setting_802_1x_get_phase2_private_key_format () + + + +
-
-
-

NM_SETTING_802_1X_PIN

-
#define NM_SETTING_802_1X_PIN "pin"
-
-

-

+
+

Properties

+
+++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
GStrvaltsubject-matchesRead / Write
+gchar *anonymous-identityRead / Write
+GBytes *ca-certRead / Write
+gchar *ca-pathRead / Write
+GBytes *client-certRead / Write
GStrveapRead / Write
+gchar *identityRead / Write
+gchar *pac-fileRead / Write
+gchar *passwordRead / Write
NMSettingSecretFlagspassword-flagsRead / Write
+GBytes *password-rawRead / Write
NMSettingSecretFlagspassword-raw-flagsRead / Write
+gchar *phase1-fast-provisioningRead / Write
+gchar *phase1-peaplabelRead / Write
+gchar *phase1-peapverRead / Write
GStrvphase2-altsubject-matchesRead / Write
+gchar *phase2-authRead / Write
+gchar *phase2-autheapRead / Write
+GBytes *phase2-ca-certRead / Write
+gchar *phase2-ca-pathRead / Write
+GBytes *phase2-client-certRead / Write
+GBytes *phase2-private-keyRead / Write
+gchar *phase2-private-key-passwordRead / Write
NMSettingSecretFlagsphase2-private-key-password-flagsRead / Write
+gchar *phase2-subject-matchRead / Write
+gchar *pinRead / Write
NMSettingSecretFlagspin-flagsRead / Write
+GBytes *private-keyRead / Write
+gchar *private-key-passwordRead / Write
NMSettingSecretFlagsprivate-key-password-flagsRead / Write
+gchar *subject-matchRead / Write
gbooleansystem-ca-certsRead / Write / Construct
-
-
-

NM_SETTING_802_1X_PIN_FLAGS

-
#define NM_SETTING_802_1X_PIN_FLAGS "pin-flags"
-
-

-

+
+

Types and Values

+
++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
enumNMSetting8021xCKFormat
enumNMSetting8021xCKScheme
#defineNM_SETTING_802_1X_SETTING_NAME
#defineNM_SETTING_802_1X_EAP
#defineNM_SETTING_802_1X_IDENTITY
#defineNM_SETTING_802_1X_ANONYMOUS_IDENTITY
#defineNM_SETTING_802_1X_PAC_FILE
#defineNM_SETTING_802_1X_CA_CERT
#defineNM_SETTING_802_1X_CA_PATH
#defineNM_SETTING_802_1X_SUBJECT_MATCH
#defineNM_SETTING_802_1X_ALTSUBJECT_MATCHES
#defineNM_SETTING_802_1X_CLIENT_CERT
#defineNM_SETTING_802_1X_PHASE1_PEAPVER
#defineNM_SETTING_802_1X_PHASE1_PEAPLABEL
#defineNM_SETTING_802_1X_PHASE1_FAST_PROVISIONING
#defineNM_SETTING_802_1X_PHASE2_AUTH
#defineNM_SETTING_802_1X_PHASE2_AUTHEAP
#defineNM_SETTING_802_1X_PHASE2_CA_CERT
#defineNM_SETTING_802_1X_PHASE2_CA_PATH
#defineNM_SETTING_802_1X_PHASE2_SUBJECT_MATCH
#defineNM_SETTING_802_1X_PHASE2_ALTSUBJECT_MATCHES
#defineNM_SETTING_802_1X_PHASE2_CLIENT_CERT
#defineNM_SETTING_802_1X_PASSWORD
#defineNM_SETTING_802_1X_PASSWORD_FLAGS
#defineNM_SETTING_802_1X_PASSWORD_RAW
#defineNM_SETTING_802_1X_PASSWORD_RAW_FLAGS
#defineNM_SETTING_802_1X_PRIVATE_KEY
#defineNM_SETTING_802_1X_PRIVATE_KEY_PASSWORD
#defineNM_SETTING_802_1X_PRIVATE_KEY_PASSWORD_FLAGS
#defineNM_SETTING_802_1X_PHASE2_PRIVATE_KEY
#defineNM_SETTING_802_1X_PHASE2_PRIVATE_KEY_PASSWORD
#defineNM_SETTING_802_1X_PHASE2_PRIVATE_KEY_PASSWORD_FLAGS
#defineNM_SETTING_802_1X_PIN
#defineNM_SETTING_802_1X_PIN_FLAGS
#defineNM_SETTING_802_1X_SYSTEM_CA_CERTS
-
-
-

NM_SETTING_802_1X_SYSTEM_CA_CERTS

-
#define NM_SETTING_802_1X_SYSTEM_CA_CERTS "system-ca-certs"
+
+

Object Hierarchy

+
    GEnum
+    ├── NMSetting8021xCKFormat
+    ╰── NMSetting8021xCKScheme
+    GObject
+    ╰── NMSetting
+        ╰── NMSetting8021x
 
-

-

-
-
-

struct NMSetting8021x

-
struct NMSetting8021x;
-

-

+
+

Description

+

The NMSetting8021x object is a NMSetting subclass that describes +properties necessary for connection to 802.1x-authenticated networks, such as +WPA and WPA2 Enterprise Wi-Fi networks and wired 802.1x networks. 802.1x +connections typically use certificates and/or EAP authentication methods to +securely verify, identify, and authenticate the client to the network itself, +instead of simply relying on a widely shared static key.

+

It's a good idea to read up on wpa_supplicant configuration before using this +setting extensively, since most of the options here correspond closely with +the relevant wpa_supplicant configuration options.

+

Furthermore, to get a good idea of 802.1x, EAP, TLS, TTLS, etc and their +applications to Wi-Fi and wired networks, you'll want to get copies of the +following books.

+

802.11 Wireless Networks: The Definitive Guide, Second Edition + Author: Matthew Gast + ISBN: 978-0596100520

+

Cisco Wireless LAN Security + Authors: Krishna Sankar, Sri Sundaralingam, Darrin Miller, and Andrew Balinsky + ISBN: 978-1587051548

-
+
+

Functions

-

NMSetting8021xClass

-
typedef struct {
-	NMSettingClass parent;
-} NMSetting8021xClass;
-
-

-

+

nm_setting_802_1x_new ()

+
NMSetting *
+nm_setting_802_1x_new (void);
+

Creates a new NMSetting8021x object with default values.

+
+

Returns

+

the new empty NMSetting8021x object

+

+

-

nm_setting_802_1x_new ()

-
NMSetting *         nm_setting_802_1x_new               (void);
-

-Creates a new NMSetting8021x object with default values. -

-
+

nm_setting_802_1x_get_num_eap_methods ()

+
guint32
+nm_setting_802_1x_get_num_eap_methods (NMSetting8021x *setting);
+

Returns the number of eap methods allowed for use when connecting to the +network. Generally only one EAP method is used. Use the functions +nm_setting_802_1x_get_eap_method(), nm_setting_802_1x_add_eap_method(), +and nm_setting_802_1x_remove_eap_method() for adding, removing, and retrieving +allowed EAP methods.

+
+

Parameters

+
--+++ - - + + +

Returns :

the new empty NMSetting8021x object

setting

the NMSetting8021x

 
+
+

Returns

+

the number of allowed EAP methods

+

+
+

-

nm_setting_802_1x_get_num_eap_methods ()

-
guint32             nm_setting_802_1x_get_num_eap_methods
-                                                        (NMSetting8021x *setting);
-

-Returns the number of eap methods allowed for use when connecting to the -network. Generally only one EAP method is used. Use the functions -nm_setting_802_1x_get_eap_method(), nm_setting_802_1x_add_eap_method(), -and nm_setting_802_1x_remove_eap_method() for adding, removing, and retrieving -allowed EAP methods. -

-
+

nm_setting_802_1x_get_eap_method ()

+
const char *
+nm_setting_802_1x_get_eap_method (NMSetting8021x *setting,
+                                  guint32 i);
+

Returns the name of the allowed EAP method at index i +.

+
+

Parameters

+
--+++ - - + + + - - + + +

setting :

the NMSetting8021x -

setting

the NMSetting8021x

 

Returns :

the number of allowed EAP methods

i

the index of the EAP method name to return

 
-
-
-

nm_setting_802_1x_get_eap_method ()

-
const char *        nm_setting_802_1x_get_eap_method    (NMSetting8021x *setting,
-                                                         guint32 i);
-

-Returns the name of the allowed EAP method at index i. +

+

Returns

+

the name of the allowed EAP method at index i

-
---- - - - - - - - - - - - - - - -

setting :

the NMSetting8021x -

i :

the index of the EAP method name to return

Returns :

the name of the allowed EAP method at index i -
+

+

-

nm_setting_802_1x_add_eap_method ()

-
gboolean            nm_setting_802_1x_add_eap_method    (NMSetting8021x *setting,
-                                                         const char *eap);
-

-Adds an allowed EAP method. The setting is not valid until at least one -EAP method has been added. See "eap" property for a list of -allowed EAP methods. -

-
+

nm_setting_802_1x_add_eap_method ()

+
gboolean
+nm_setting_802_1x_add_eap_method (NMSetting8021x *setting,
+                                  const char *eap);
+

Adds an allowed EAP method. The setting is not valid until at least one +EAP method has been added. See “eap” property for a list of +allowed EAP methods.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + +

setting :

the NMSetting8021x -

eap :

the name of the EAP method to allow for this connection

setting

the NMSetting8021x

 

Returns :

-TRUE if the EAP method was successfully added, FALSE if it was -not a valid method or if it was already allowed.

eap

the name of the EAP method to allow for this connection

 
+
+

Returns

+

TRUE if the EAP method was successfully added, FALSE if it was +not a valid method or if it was already allowed.

+

+
+

-

nm_setting_802_1x_remove_eap_method ()

-
void                nm_setting_802_1x_remove_eap_method (NMSetting8021x *setting,
-                                                         guint32 i);
-

-Removes the allowed EAP method at the specified index. -

-
+

nm_setting_802_1x_remove_eap_method ()

+
void
+nm_setting_802_1x_remove_eap_method (NMSetting8021x *setting,
+                                     guint32 i);
+

Removes the allowed EAP method at the specified index.

+
+

Parameters

+
--+++ - - + + + - - + + +

setting :

the NMSetting8021x -

setting

the NMSetting8021x

 

i :

the index of the EAP method to remove

i

the index of the EAP method to remove

 
+

-

nm_setting_802_1x_remove_eap_method_by_value ()

-
gboolean            nm_setting_802_1x_remove_eap_method_by_value
-                                                        (NMSetting8021x *setting,
-                                                         const char *eap);
-

-Removes the allowed EAP method method. -

-
+

nm_setting_802_1x_remove_eap_method_by_value ()

+
gboolean
+nm_setting_802_1x_remove_eap_method_by_value
+                               (NMSetting8021x *setting,
+                                const char *eap);
+

Removes the allowed EAP method method +.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + +

setting :

the NMSetting8021x -

eap :

the name of the EAP method to remove

setting

the NMSetting8021x

 

Returns :

-TRUE if the EAP method was founs and removed, FALSE if it was not.

eap

the name of the EAP method to remove

 
+
+

Returns

+

TRUE if the EAP method was founs and removed, FALSE if it was not.

+

+
+

-

nm_setting_802_1x_clear_eap_methods ()

-
void                nm_setting_802_1x_clear_eap_methods (NMSetting8021x *setting);
-

-Clears all allowed EAP methods. -

-
+

nm_setting_802_1x_clear_eap_methods ()

+
void
+nm_setting_802_1x_clear_eap_methods (NMSetting8021x *setting);
+

Clears all allowed EAP methods.

+
+

Parameters

+
--+++ - - + + +

setting :

the NMSetting8021x -

setting

the NMSetting8021x

 
+

-

nm_setting_802_1x_get_identity ()

-
const char *        nm_setting_802_1x_get_identity      (NMSetting8021x *setting);
-

-Returns the identifier used by some EAP methods (like TLS) to -authenticate the user. Often this is a username or login name. -

-
+

nm_setting_802_1x_get_identity ()

+
const char *
+nm_setting_802_1x_get_identity (NMSetting8021x *setting);
+

Returns the identifier used by some EAP methods (like TLS) to +authenticate the user. Often this is a username or login name.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSetting8021x -

Returns :

the user identifier

setting

the NMSetting8021x

 
+
+

Returns

+

the user identifier

+

+
+

-

nm_setting_802_1x_get_anonymous_identity ()

-
const char *        nm_setting_802_1x_get_anonymous_identity
-                                                        (NMSetting8021x *setting);
-

-Returns the anonymous identifier used by some EAP methods (like TTLS) to +

nm_setting_802_1x_get_anonymous_identity ()

+
const char *
+nm_setting_802_1x_get_anonymous_identity
+                               (NMSetting8021x *setting);
+

Returns the anonymous identifier used by some EAP methods (like TTLS) to authenticate the user in the outer unencrypted "phase 1" authentication. The -inner "phase 2" authentication will use the "identity" in -a secure form, if applicable for that EAP method. -

-
+inner "phase 2" authentication will use the “identity” in +a secure form, if applicable for that EAP method.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSetting8021x -

Returns :

the anonymous identifier

setting

the NMSetting8021x

 
+
+

Returns

+

the anonymous identifier

+

+
+
-

nm_setting_802_1x_get_pac_file ()

-
const char *        nm_setting_802_1x_get_pac_file      (NMSetting8021x *setting);
-

-Returns the file containing PAC credentials used by EAP-FAST method. -

-
+

nm_setting_802_1x_get_pac_file ()

+
const char *
+nm_setting_802_1x_get_pac_file (NMSetting8021x *setting);
+

Returns the file containing PAC credentials used by EAP-FAST method.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSetting8021x -

Returns :

the PAC file

setting

the NMSetting8021x

 
+
+

Returns

+

the PAC file

+

+
+
-

nm_setting_802_1x_get_system_ca_certs ()

-
gboolean            nm_setting_802_1x_get_system_ca_certs
-                                                        (NMSetting8021x *setting);
-

-Sets the "system-ca-certs" property. The -"ca-path" and "phase2-ca-path" -properties are ignored if the "system-ca-certs" property is -TRUE, in which case a system-wide CA certificate directory specified at +

nm_setting_802_1x_get_system_ca_certs ()

+
gboolean
+nm_setting_802_1x_get_system_ca_certs (NMSetting8021x *setting);
+

Sets the “system-ca-certs” property. The +“ca-path” and “phase2-ca-path” +properties are ignored if the “system-ca-certs” property is +TRUE, in which case a system-wide CA certificate directory specified at compile time (using the --system-ca-path configure option) is used in place -of these properties. -

-
+of these properties.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSetting8021x -

Returns :

-TRUE if a system CA certificate path should be used, FALSE if not

setting

the NMSetting8021x

 
+
+

Returns

+

TRUE if a system CA certificate path should be used, FALSE if not

+

+
+
-

nm_setting_802_1x_get_ca_path ()

-
const char *        nm_setting_802_1x_get_ca_path       (NMSetting8021x *setting);
-

-Returns the path of the CA certificate directory if previously set. Systems +

nm_setting_802_1x_get_ca_path ()

+
const char *
+nm_setting_802_1x_get_ca_path (NMSetting8021x *setting);
+

Returns the path of the CA certificate directory if previously set. Systems will often have a directory that contains multiple individual CA certificates which the supplicant can then add to the verification chain. This may be -used in addition to the "ca-cert" property to add more CA -certificates for verifying the network to client. -

-
+used in addition to the “ca-cert” property to add more CA +certificates for verifying the network to client.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSetting8021x -

Returns :

the CA certificate directory path

setting

the NMSetting8021x

 
+
+

Returns

+

the CA certificate directory path

+

+
+
-

nm_setting_802_1x_get_phase2_ca_path ()

-
const char *        nm_setting_802_1x_get_phase2_ca_path
-                                                        (NMSetting8021x *setting);
-

-Returns the path of the "phase 2" CA certificate directory if previously set. +

nm_setting_802_1x_get_phase2_ca_path ()

+
const char *
+nm_setting_802_1x_get_phase2_ca_path (NMSetting8021x *setting);
+

Returns the path of the "phase 2" CA certificate directory if previously set. Systems will often have a directory that contains multiple individual CA certificates which the supplicant can then add to the verification chain. -This may be used in addition to the "phase2-ca-cert" property -to add more CA certificates for verifying the network to client. -

-
+This may be used in addition to the “phase2-ca-cert” property +to add more CA certificates for verifying the network to client.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSetting8021x -

Returns :

the "phase 2" CA certificate directory path

setting

the NMSetting8021x

 
+
+

Returns

+

the "phase 2" CA certificate directory path

+

+
+
-

nm_setting_802_1x_get_ca_cert_scheme ()

-
NMSetting8021xCKScheme nm_setting_802_1x_get_ca_cert_scheme
-                                                        (NMSetting8021x *setting);
-

-Returns the scheme used to store the CA certificate. If the returned scheme -is NM_SETTING_802_1X_CK_SCHEME_BLOB, use nm_setting_802_1x_get_ca_cert_blob(); -if NM_SETTING_802_1X_CK_SCHEME_PATH, use nm_setting_802_1x_get_ca_cert_path(). -

-
+

nm_setting_802_1x_get_ca_cert_scheme ()

+
NMSetting8021xCKScheme
+nm_setting_802_1x_get_ca_cert_scheme (NMSetting8021x *setting);
+

Returns the scheme used to store the CA certificate. If the returned scheme +is NM_SETTING_802_1X_CK_SCHEME_BLOB, use nm_setting_802_1x_get_ca_cert_blob(); +if NM_SETTING_802_1X_CK_SCHEME_PATH, use nm_setting_802_1x_get_ca_cert_path().

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSetting8021x -

Returns :

scheme used to store the CA certificate (blob or path)

setting

the NMSetting8021x

 
+
+

Returns

+

scheme used to store the CA certificate (blob or path)

+

+
+
-

nm_setting_802_1x_get_ca_cert_blob ()

-
GBytes *            nm_setting_802_1x_get_ca_cert_blob  (NMSetting8021x *setting);
-

-Returns the CA certificate blob if the CA certificate is stored using the +

nm_setting_802_1x_get_ca_cert_blob ()

+
GBytes *
+nm_setting_802_1x_get_ca_cert_blob (NMSetting8021x *setting);
+

Returns the CA certificate blob if the CA certificate is stored using the NM_SETTING_802_1X_CK_SCHEME_BLOB scheme. Not all EAP methods use a CA certificate (LEAP for example), and those that can take advantage of the CA certificate allow it to be unset. Note that lack of a CA certificate reduces security by allowing man-in-the-middle attacks, because the identity -of the network cannot be confirmed by the client. -

-
+of the network cannot be confirmed by the client.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSetting8021x -

Returns :

the CA certificate data. [transfer none] -

setting

the NMSetting8021x

 
+
+

Returns

+

the CA certificate data.

+

[transfer none]

+
+
-

nm_setting_802_1x_get_ca_cert_path ()

-
const char *        nm_setting_802_1x_get_ca_cert_path  (NMSetting8021x *setting);
-

-Returns the CA certificate path if the CA certificate is stored using the +

nm_setting_802_1x_get_ca_cert_path ()

+
const char *
+nm_setting_802_1x_get_ca_cert_path (NMSetting8021x *setting);
+

Returns the CA certificate path if the CA certificate is stored using the NM_SETTING_802_1X_CK_SCHEME_PATH scheme. Not all EAP methods use a CA certificate (LEAP for example), and those that can take advantage of the CA certificate allow it to be unset. Note that lack of a CA certificate reduces security by allowing man-in-the-middle attacks, because the identity -of the network cannot be confirmed by the client. -

-
+of the network cannot be confirmed by the client.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSetting8021x -

Returns :

path to the CA certificate file

setting

the NMSetting8021x

 
+
+

Returns

+

path to the CA certificate file

+

+
+
-

nm_setting_802_1x_set_ca_cert ()

-
gboolean            nm_setting_802_1x_set_ca_cert       (NMSetting8021x *setting,
-                                                         const char *cert_path,
-                                                         NMSetting8021xCKScheme scheme,
-                                                         NMSetting8021xCKFormat *out_format,
-                                                         GError **error);
-

-Reads a certificate from disk and sets the "ca-cert" property +

nm_setting_802_1x_set_ca_cert ()

+
gboolean
+nm_setting_802_1x_set_ca_cert (NMSetting8021x *setting,
+                               const char *cert_path,
+                               NMSetting8021xCKScheme scheme,
+                               NMSetting8021xCKFormat *out_format,
+                               GError **error);
+

Reads a certificate from disk and sets the “ca-cert” property with the raw certificate data if using the NM_SETTING_802_1X_CK_SCHEME_BLOB scheme, or with the path to the certificate file if using the -NM_SETTING_802_1X_CK_SCHEME_PATH scheme. -

-
+NM_SETTING_802_1X_CK_SCHEME_PATH scheme.

+
+

Parameters

+
--+++ - - + + + - - + +g_filename_to_utf8() to convert if needed. Passing NULL with any scheme +clears the CA certificate.

+ - - + + + - - + + + - - - - - - + + +

setting :

the NMSetting8021x -

setting

the NMSetting8021x

 

cert_path :

when scheme is set to either NM_SETTING_802_1X_CK_SCHEME_PATH +

cert_path

when scheme +is set to either NM_SETTING_802_1X_CK_SCHEME_PATH or NM_SETTING_802_1X_CK_SCHEME_BLOB, pass the path of the CA certificate file (PEM or DER format). The path must be UTF-8 encoded; use -g_filename_to_utf8() to convert if needed. Passing NULL with any scheme -clears the CA certificate.

 

scheme :

desired storage scheme for the certificate

scheme

desired storage scheme for the certificate

 

out_format :

on successful return, the type of the certificate added

out_format

on successful return, the type of the certificate added

 

error :

on unsuccessful return, an error

Returns :

-TRUE if the operation succeeded, FALSE if it was unsuccessful

error

on unsuccessful return, an error

 
+
+

Returns

+

TRUE if the operation succeeded, FALSE if it was unsuccessful

+

+
+
-

nm_setting_802_1x_get_subject_match ()

-
const char *        nm_setting_802_1x_get_subject_match (NMSetting8021x *setting);
-
+

nm_setting_802_1x_get_subject_match ()

+
const char *
+nm_setting_802_1x_get_subject_match (NMSetting8021x *setting);
+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSetting8021x -

Returns :

the "subject-match" property. This is the -substring to be matched against the subject of the authentication -server certificate, or NULL no subject verification is to be -performed.

setting

the NMSetting8021x

 
+
+

Returns

+

the “subject-match” property. This is the +substring to be matched against the subject of the authentication +server certificate, or NULL no subject verification is to be +performed.

+

+
+
-

nm_setting_802_1x_get_num_altsubject_matches ()

-
guint32             nm_setting_802_1x_get_num_altsubject_matches
-                                                        (NMSetting8021x *setting);
-

-Returns the number of entries in the -"altsubject-matches" property of this setting. -

-
+

nm_setting_802_1x_get_num_altsubject_matches ()

+
guint32
+nm_setting_802_1x_get_num_altsubject_matches
+                               (NMSetting8021x *setting);
+

Returns the number of entries in the +“altsubject-matches” property of this setting.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSetting8021x -

Returns :

the number of altsubject-matches entries.

setting

the NMSetting8021x

 
+
+

Returns

+

the number of altsubject-matches entries.

+

+
+
-

nm_setting_802_1x_get_altsubject_match ()

-
const char *        nm_setting_802_1x_get_altsubject_match
-                                                        (NMSetting8021x *setting,
-                                                         guint32 i);
-

-Returns the altSubjectName match at index i. -

-
+

nm_setting_802_1x_get_altsubject_match ()

+
const char *
+nm_setting_802_1x_get_altsubject_match
+                               (NMSetting8021x *setting,
+                                guint32 i);
+

Returns the altSubjectName match at index i +.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + +

setting :

the NMSettingConnection -

i :

the zero-based index of the array of altSubjectName matches

setting

the NMSettingConnection

 

Returns :

the altSubjectName match at index i -

i

the zero-based index of the array of altSubjectName matches

 
+
+

Returns

+

the altSubjectName match at index i +

+

+
+
-

nm_setting_802_1x_add_altsubject_match ()

-
gboolean            nm_setting_802_1x_add_altsubject_match
-                                                        (NMSetting8021x *setting,
-                                                         const char *altsubject_match);
-

-Adds an allowed alternate subject name match. Until at least one +

nm_setting_802_1x_add_altsubject_match ()

+
gboolean
+nm_setting_802_1x_add_altsubject_match
+                               (NMSetting8021x *setting,
+                                const char *altsubject_match);
+

Adds an allowed alternate subject name match. Until at least one match is added, the altSubjectName of the remote authentication -server is not verified. -

-
+server is not verified.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + +

setting :

the NMSetting8021x -

altsubject_match :

the altSubjectName to allow for this connection

setting

the NMSetting8021x

 

Returns :

-TRUE if the alternative subject name match was -successfully added, FALSE if it was already allowed.

altsubject_match

the altSubjectName to allow for this connection

 
+
+

Returns

+

TRUE if the alternative subject name match was +successfully added, FALSE if it was already allowed.

+

+
+
-

nm_setting_802_1x_remove_altsubject_match ()

-
void                nm_setting_802_1x_remove_altsubject_match
-                                                        (NMSetting8021x *setting,
-                                                         guint32 i);
-

-Removes the allowed altSubjectName at the specified index. -

-
+

nm_setting_802_1x_remove_altsubject_match ()

+
void
+nm_setting_802_1x_remove_altsubject_match
+                               (NMSetting8021x *setting,
+                                guint32 i);
+

Removes the allowed altSubjectName at the specified index.

+
+

Parameters

+
--+++ - - + + + - - + + +

setting :

the NMSetting8021x -

setting

the NMSetting8021x

 

i :

the index of the altSubjectName match to remove

i

the index of the altSubjectName match to remove

 
+
-

nm_setting_802_1x_remove_altsubject_match_by_value ()

-
gboolean            nm_setting_802_1x_remove_altsubject_match_by_value
-                                                        (NMSetting8021x *setting,
-                                                         const char *altsubject_match);
-

-Removes the allowed altSubjectName altsubject_match. -

-
+

nm_setting_802_1x_remove_altsubject_match_by_value ()

+
gboolean
+nm_setting_802_1x_remove_altsubject_match_by_value
+                               (NMSetting8021x *setting,
+                                const char *altsubject_match);
+

Removes the allowed altSubjectName altsubject_match +.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + +

setting :

the NMSetting8021x -

altsubject_match :

the altSubjectName to remove

setting

the NMSetting8021x

 

Returns :

-TRUE if the alternative subject name match was found and removed, -FALSE if it was not.

altsubject_match

the altSubjectName to remove

 
+
+

Returns

+

TRUE if the alternative subject name match was found and removed, +FALSE if it was not.

+

+
+
-

nm_setting_802_1x_clear_altsubject_matches ()

-
void                nm_setting_802_1x_clear_altsubject_matches
-                                                        (NMSetting8021x *setting);
-

-Clears all altSubjectName matches. -

-
+

nm_setting_802_1x_clear_altsubject_matches ()

+
void
+nm_setting_802_1x_clear_altsubject_matches
+                               (NMSetting8021x *setting);
+

Clears all altSubjectName matches.

+
+

Parameters

+
--+++ - - + + +

setting :

the NMSetting8021x -

setting

the NMSetting8021x

 
+
-
-

nm_setting_802_1x_get_client_cert_scheme ()

-
NMSetting8021xCKScheme nm_setting_802_1x_get_client_cert_scheme
-                                                        (NMSetting8021x *setting);
-

-Returns the scheme used to store the client certificate. If the returned scheme -is NM_SETTING_802_1X_CK_SCHEME_BLOB, use nm_setting_802_1x_get_client_cert_blob(); -if NM_SETTING_802_1X_CK_SCHEME_PATH, use nm_setting_802_1x_get_client_cert_path(). -

-
+
+

nm_setting_802_1x_get_client_cert_scheme ()

+
NMSetting8021xCKScheme
+nm_setting_802_1x_get_client_cert_scheme
+                               (NMSetting8021x *setting);
+

Returns the scheme used to store the client certificate. If the returned scheme +is NM_SETTING_802_1X_CK_SCHEME_BLOB, use nm_setting_802_1x_get_client_cert_blob(); +if NM_SETTING_802_1X_CK_SCHEME_PATH, use nm_setting_802_1x_get_client_cert_path().

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSetting8021x -

Returns :

scheme used to store the client certificate (blob or path)

setting

the NMSetting8021x

 
+
+

Returns

+

scheme used to store the client certificate (blob or path)

+

+
+
-

nm_setting_802_1x_get_client_cert_blob ()

-
GBytes *            nm_setting_802_1x_get_client_cert_blob
-                                                        (NMSetting8021x *setting);
-

-Client certificates are used to identify the connecting client to the network +

nm_setting_802_1x_get_client_cert_blob ()

+
GBytes *
+nm_setting_802_1x_get_client_cert_blob
+                               (NMSetting8021x *setting);
+

Client certificates are used to identify the connecting client to the network when EAP-TLS is used as either the "phase 1" or "phase 2" 802.1x -authentication method. -

-
+authentication method.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSetting8021x -

Returns :

the client certificate data. [transfer none] -

setting

the NMSetting8021x

 
+
+

Returns

+

the client certificate data.

+

[transfer none]

+
+
-

nm_setting_802_1x_get_client_cert_path ()

-
const char *        nm_setting_802_1x_get_client_cert_path
-                                                        (NMSetting8021x *setting);
-

-Client certificates are used to identify the connecting client to the network +

nm_setting_802_1x_get_client_cert_path ()

+
const char *
+nm_setting_802_1x_get_client_cert_path
+                               (NMSetting8021x *setting);
+

Client certificates are used to identify the connecting client to the network when EAP-TLS is used as either the "phase 1" or "phase 2" 802.1x -authentication method. -

-
+authentication method.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSetting8021x -

Returns :

path to the client certificate file

setting

the NMSetting8021x

 
+
+

Returns

+

path to the client certificate file

+

+
+
-

nm_setting_802_1x_set_client_cert ()

-
gboolean            nm_setting_802_1x_set_client_cert   (NMSetting8021x *setting,
-                                                         const char *cert_path,
-                                                         NMSetting8021xCKScheme scheme,
-                                                         NMSetting8021xCKFormat *out_format,
-                                                         GError **error);
-

-Reads a certificate from disk and sets the "client-cert" +

nm_setting_802_1x_set_client_cert ()

+
gboolean
+nm_setting_802_1x_set_client_cert (NMSetting8021x *setting,
+                                   const char *cert_path,
+                                   NMSetting8021xCKScheme scheme,
+                                   NMSetting8021xCKFormat *out_format,
+                                   GError **error);
+

Reads a certificate from disk and sets the “client-cert” property with the raw certificate data if using the NM_SETTING_802_1X_CK_SCHEME_BLOB scheme, or with the path to the certificate -file if using the NM_SETTING_802_1X_CK_SCHEME_PATH scheme. -

-

-Client certificates are used to identify the connecting client to the network +file if using the NM_SETTING_802_1X_CK_SCHEME_PATH scheme.

+

Client certificates are used to identify the connecting client to the network when EAP-TLS is used as either the "phase 1" or "phase 2" 802.1x -authentication method. -

-
+authentication method.

+
+

Parameters

+
--+++ - - + + + - - + +encoded; use g_filename_to_utf8() to convert if needed. Passing NULL with +any scheme +clears the client certificate.

+ - - + + + - - + + + - - - - - - + + +

setting :

the NMSetting8021x -

setting

the NMSetting8021x

 

cert_path :

when scheme is set to either NM_SETTING_802_1X_CK_SCHEME_PATH +

cert_path

when scheme +is set to either NM_SETTING_802_1X_CK_SCHEME_PATH or NM_SETTING_802_1X_CK_SCHEME_BLOB, pass the path of the client certificate file (PEM, DER, or PKCS#12 format). The path must be UTF-8 -encoded; use g_filename_to_utf8() to convert if needed. Passing NULL with -any scheme clears the client certificate.

 

scheme :

desired storage scheme for the certificate

scheme

desired storage scheme for the certificate

 

out_format :

on successful return, the type of the certificate added

out_format

on successful return, the type of the certificate added

 

error :

on unsuccessful return, an error

Returns :

-TRUE if the operation succeeded, FALSE if it was unsuccessful

error

on unsuccessful return, an error

 
+
+

Returns

+

TRUE if the operation succeeded, FALSE if it was unsuccessful

+

+
+
-

nm_setting_802_1x_get_phase1_peapver ()

-
const char *        nm_setting_802_1x_get_phase1_peapver
-                                                        (NMSetting8021x *setting);
-
+

nm_setting_802_1x_get_phase1_peapver ()

+
const char *
+nm_setting_802_1x_get_phase1_peapver (NMSetting8021x *setting);
+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSetting8021x -

Returns :

the "phase 1" PEAP version to be used when authenticating with -EAP-PEAP as contained in the "phase1-peapver" property. Valid -values are NULL (unset), "0" (PEAP version 0), and "1" (PEAP version 1).

setting

the NMSetting8021x

 
+
+

Returns

+

the "phase 1" PEAP version to be used when authenticating with +EAP-PEAP as contained in the “phase1-peapver” property. Valid +values are NULL (unset), "0" (PEAP version 0), and "1" (PEAP version 1).

+

+
+
-

nm_setting_802_1x_get_phase1_peaplabel ()

-
const char *        nm_setting_802_1x_get_phase1_peaplabel
-                                                        (NMSetting8021x *setting);
-
+

nm_setting_802_1x_get_phase1_peaplabel ()

+
const char *
+nm_setting_802_1x_get_phase1_peaplabel
+                               (NMSetting8021x *setting);
+
+

Parameters

+
--+++ - - - - - - - - + + + + +

setting :

the NMSetting8021x -

Returns :

whether the "phase 1" PEAP label is new-style or old-style, to be +

setting

the NMSetting8021x

 
+
+
+

Returns

+

whether the "phase 1" PEAP label is new-style or old-style, to be used when authenticating with EAP-PEAP, as contained in the -"phase1-peaplabel" property. Valid values are NULL (unset), +“phase1-peaplabel” property. Valid values are NULL (unset), "0" (use old-style label), and "1" (use new-style label). See the -wpa_supplicant documentation for more details. - - -

+wpa_supplicant documentation for more details.

+

+
-

nm_setting_802_1x_get_phase1_fast_provisioning ()

-
const char *        nm_setting_802_1x_get_phase1_fast_provisioning
-                                                        (NMSetting8021x *setting);
-
+

nm_setting_802_1x_get_phase1_fast_provisioning ()

+
const char *
+nm_setting_802_1x_get_phase1_fast_provisioning
+                               (NMSetting8021x *setting);
+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSetting8021x -

Returns :

whether "phase 1" PEAP fast provisioning should be used, as specified -by the "phase1-fast-provisioning" property. See the -wpa_supplicant documentation for more details.

setting

the NMSetting8021x

 
+
+

Returns

+

whether "phase 1" PEAP fast provisioning should be used, as specified +by the “phase1-fast-provisioning” property. See the +wpa_supplicant documentation for more details.

+

+
+
-

nm_setting_802_1x_get_phase2_auth ()

-
const char *        nm_setting_802_1x_get_phase2_auth   (NMSetting8021x *setting);
-
+

nm_setting_802_1x_get_phase2_auth ()

+
const char *
+nm_setting_802_1x_get_phase2_auth (NMSetting8021x *setting);
+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSetting8021x -

Returns :

the "phase 2" non-EAP (ex MD5) allowed authentication method as -specified by the "phase2-auth" property.

setting

the NMSetting8021x

 
+
+

Returns

+

the "phase 2" non-EAP (ex MD5) allowed authentication method as +specified by the “phase2-auth” property.

+

+
+
-

nm_setting_802_1x_get_phase2_autheap ()

-
const char *        nm_setting_802_1x_get_phase2_autheap
-                                                        (NMSetting8021x *setting);
-
+

nm_setting_802_1x_get_phase2_autheap ()

+
const char *
+nm_setting_802_1x_get_phase2_autheap (NMSetting8021x *setting);
+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSetting8021x -

Returns :

the "phase 2" EAP-based (ex TLS) allowed authentication method as -specified by the "phase2-autheap" property.

setting

the NMSetting8021x

 
+
+

Returns

+

the "phase 2" EAP-based (ex TLS) allowed authentication method as +specified by the “phase2-autheap” property.

+

+
+
-

nm_setting_802_1x_get_phase2_ca_cert_scheme ()

-
NMSetting8021xCKScheme nm_setting_802_1x_get_phase2_ca_cert_scheme
-                                                        (NMSetting8021x *setting);
-

-Returns the scheme used to store the "phase 2" CA certificate. If the +

nm_setting_802_1x_get_phase2_ca_cert_scheme ()

+
NMSetting8021xCKScheme
+nm_setting_802_1x_get_phase2_ca_cert_scheme
+                               (NMSetting8021x *setting);
+

Returns the scheme used to store the "phase 2" CA certificate. If the returned scheme is NM_SETTING_802_1X_CK_SCHEME_BLOB, use -nm_setting_802_1x_get_ca_cert_blob(); if NM_SETTING_802_1X_CK_SCHEME_PATH, -use nm_setting_802_1x_get_ca_cert_path(). -

-
+nm_setting_802_1x_get_ca_cert_blob(); if NM_SETTING_802_1X_CK_SCHEME_PATH, +use nm_setting_802_1x_get_ca_cert_path().

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSetting8021x -

Returns :

scheme used to store the "phase 2" CA certificate (blob or path)

setting

the NMSetting8021x

 
+
+

Returns

+

scheme used to store the "phase 2" CA certificate (blob or path)

+

+
+
-

nm_setting_802_1x_get_phase2_ca_cert_blob ()

-
GBytes *            nm_setting_802_1x_get_phase2_ca_cert_blob
-                                                        (NMSetting8021x *setting);
-

-Returns the "phase 2" CA certificate blob if the CA certificate is stored +

nm_setting_802_1x_get_phase2_ca_cert_blob ()

+
GBytes *
+nm_setting_802_1x_get_phase2_ca_cert_blob
+                               (NMSetting8021x *setting);
+

Returns the "phase 2" CA certificate blob if the CA certificate is stored using the NM_SETTING_802_1X_CK_SCHEME_BLOB scheme. Not all EAP methods use a CA certificate (LEAP for example), and those that can take advantage of the CA certificate allow it to be unset. Note that lack of a CA certificate reduces security by allowing man-in-the-middle attacks, because the identity -of the network cannot be confirmed by the client. -

-
+of the network cannot be confirmed by the client.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSetting8021x -

Returns :

the "phase 2" CA certificate data. [transfer none] -

setting

the NMSetting8021x

 
+
+

Returns

+

the "phase 2" CA certificate data.

+

[transfer none]

+
+
-

nm_setting_802_1x_get_phase2_ca_cert_path ()

-
const char *        nm_setting_802_1x_get_phase2_ca_cert_path
-                                                        (NMSetting8021x *setting);
-

-Returns the "phase 2" CA certificate path if the CA certificate is stored +

nm_setting_802_1x_get_phase2_ca_cert_path ()

+
const char *
+nm_setting_802_1x_get_phase2_ca_cert_path
+                               (NMSetting8021x *setting);
+

Returns the "phase 2" CA certificate path if the CA certificate is stored using the NM_SETTING_802_1X_CK_SCHEME_PATH scheme. Not all EAP methods use a CA certificate (LEAP for example), and those that can take advantage of the CA certificate allow it to be unset. Note that lack of a CA certificate reduces security by allowing man-in-the-middle attacks, because the identity -of the network cannot be confirmed by the client. -

-
+of the network cannot be confirmed by the client.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSetting8021x -

Returns :

path to the "phase 2" CA certificate file

setting

the NMSetting8021x

 
+
+

Returns

+

path to the "phase 2" CA certificate file

+

+
+
-

nm_setting_802_1x_set_phase2_ca_cert ()

-
gboolean            nm_setting_802_1x_set_phase2_ca_cert
-                                                        (NMSetting8021x *setting,
-                                                         const char *cert_path,
-                                                         NMSetting8021xCKScheme scheme,
-                                                         NMSetting8021xCKFormat *out_format,
-                                                         GError **error);
-

-Reads a certificate from disk and sets the "phase2-ca-cert" +

nm_setting_802_1x_set_phase2_ca_cert ()

+
gboolean
+nm_setting_802_1x_set_phase2_ca_cert (NMSetting8021x *setting,
+                                      const char *cert_path,
+                                      NMSetting8021xCKScheme scheme,
+                                      NMSetting8021xCKFormat *out_format,
+                                      GError **error);
+

Reads a certificate from disk and sets the “phase2-ca-cert” property with the raw certificate data if using the NM_SETTING_802_1X_CK_SCHEME_BLOB scheme, or with the path to the certificate -file if using the NM_SETTING_802_1X_CK_SCHEME_PATH scheme. -

-
+file if using the NM_SETTING_802_1X_CK_SCHEME_PATH scheme.

+
+

Parameters

+
--+++ - - + + + - - + +g_filename_to_utf8() to convert if needed. Passing NULL with any scheme +clears the "phase2" CA certificate.

+ - - + + + - - + + + - - - - - - + + +

setting :

the NMSetting8021x -

setting

the NMSetting8021x

 

cert_path :

when scheme is set to either NM_SETTING_802_1X_CK_SCHEME_PATH +

cert_path

when scheme +is set to either NM_SETTING_802_1X_CK_SCHEME_PATH or NM_SETTING_802_1X_CK_SCHEME_BLOB, pass the path of the "phase2" CA certificate file (PEM or DER format). The path must be UTF-8 encoded; use -g_filename_to_utf8() to convert if needed. Passing NULL with any scheme -clears the "phase2" CA certificate.

 

scheme :

desired storage scheme for the certificate

scheme

desired storage scheme for the certificate

 

out_format :

on successful return, the type of the certificate added

out_format

on successful return, the type of the certificate added

 

error :

on unsuccessful return, an error

Returns :

-TRUE if the operation succeeded, FALSE if it was unsuccessful

error

on unsuccessful return, an error

 
+
+

Returns

+

TRUE if the operation succeeded, FALSE if it was unsuccessful

+

+
+
-

nm_setting_802_1x_get_phase2_subject_match ()

-
const char *        nm_setting_802_1x_get_phase2_subject_match
-                                                        (NMSetting8021x *setting);
-
+

nm_setting_802_1x_get_phase2_subject_match ()

+
const char *
+nm_setting_802_1x_get_phase2_subject_match
+                               (NMSetting8021x *setting);
+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSetting8021x -

Returns :

the "phase2-subject-match" property. This is -the substring to be matched against the subject of the "phase 2" -authentication server certificate, or NULL no subject verification -is to be performed.

setting

the NMSetting8021x

 
+
+

Returns

+

the “phase2-subject-match” property. This is +the substring to be matched against the subject of the "phase 2" +authentication server certificate, or NULL no subject verification +is to be performed.

+

+
+
-

nm_setting_802_1x_get_num_phase2_altsubject_matches ()

-
guint32             nm_setting_802_1x_get_num_phase2_altsubject_matches
-                                                        (NMSetting8021x *setting);
-

-Returns the number of entries in the -"phase2-altsubject-matches" property of this setting. -

-
+

nm_setting_802_1x_get_num_phase2_altsubject_matches ()

+
guint32
+nm_setting_802_1x_get_num_phase2_altsubject_matches
+                               (NMSetting8021x *setting);
+

Returns the number of entries in the +“phase2-altsubject-matches” property of this setting.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSetting8021x -

Returns :

the number of phase2-altsubject-matches entries.

setting

the NMSetting8021x

 
+
+

Returns

+

the number of phase2-altsubject-matches entries.

+

+
+
-

nm_setting_802_1x_get_phase2_altsubject_match ()

-
const char *        nm_setting_802_1x_get_phase2_altsubject_match
-                                                        (NMSetting8021x *setting,
-                                                         guint32 i);
-

-Returns the "phase 2" altSubjectName match at index i. -

-
+

nm_setting_802_1x_get_phase2_altsubject_match ()

+
const char *
+nm_setting_802_1x_get_phase2_altsubject_match
+                               (NMSetting8021x *setting,
+                                guint32 i);
+

Returns the "phase 2" altSubjectName match at index i +.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + +

setting :

the NMSettingConnection -

i :

the zero-based index of the array of "phase 2" altSubjectName matches

setting

the NMSettingConnection

 

Returns :

the "phase 2" altSubjectName match at index i -

i

the zero-based index of the array of "phase 2" altSubjectName matches

 
+
+

Returns

+

the "phase 2" altSubjectName match at index i +

+

+
+
-

nm_setting_802_1x_add_phase2_altsubject_match ()

-
gboolean            nm_setting_802_1x_add_phase2_altsubject_match
-                                                        (NMSetting8021x *setting,
-                                                         const char *phase2_altsubject_match);
-

-Adds an allowed alternate subject name match for "phase 2". Until +

nm_setting_802_1x_add_phase2_altsubject_match ()

+
gboolean
+nm_setting_802_1x_add_phase2_altsubject_match
+                               (NMSetting8021x *setting,
+                                const char *phase2_altsubject_match);
+

Adds an allowed alternate subject name match for "phase 2". Until at least one match is added, the altSubjectName of the "phase 2" -remote authentication server is not verified. -

-
+remote authentication server is not verified.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + +

setting :

the NMSetting8021x -

phase2_altsubject_match :

the "phase 2" altSubjectName to allow for this -connection

setting

the NMSetting8021x

 

Returns :

-TRUE if the "phase 2" alternative subject name match was -successfully added, FALSE if it was already allowed.

phase2_altsubject_match

the "phase 2" altSubjectName to allow for this +connection

 
+
+

Returns

+

TRUE if the "phase 2" alternative subject name match was +successfully added, FALSE if it was already allowed.

+

+
+
-

nm_setting_802_1x_remove_phase2_altsubject_match ()

-
void                nm_setting_802_1x_remove_phase2_altsubject_match
-                                                        (NMSetting8021x *setting,
-                                                         guint32 i);
-

-Removes the allowed "phase 2" altSubjectName at the specified index. -

-
+

nm_setting_802_1x_remove_phase2_altsubject_match ()

+
void
+nm_setting_802_1x_remove_phase2_altsubject_match
+                               (NMSetting8021x *setting,
+                                guint32 i);
+

Removes the allowed "phase 2" altSubjectName at the specified index.

+
+

Parameters

+
--+++ - - + + + - - + + +

setting :

the NMSetting8021x -

setting

the NMSetting8021x

 

i :

the index of the "phase 2" altSubjectName match to remove

i

the index of the "phase 2" altSubjectName match to remove

 
+
-

nm_setting_802_1x_remove_phase2_altsubject_match_by_value ()

-
gboolean            nm_setting_802_1x_remove_phase2_altsubject_match_by_value
-                                                        (NMSetting8021x *setting,
-                                                         const char *phase2_altsubject_match);
-

-Removes the allowed "phase 2" altSubjectName phase2_altsubject_match. -

-
+

nm_setting_802_1x_remove_phase2_altsubject_match_by_value ()

+
gboolean
+nm_setting_802_1x_remove_phase2_altsubject_match_by_value
+                               (NMSetting8021x *setting,
+                                const char *phase2_altsubject_match);
+

Removes the allowed "phase 2" altSubjectName phase2_altsubject_match +.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + +

setting :

the NMSetting8021x -

phase2_altsubject_match :

the "phase 2" altSubjectName to remove

setting

the NMSetting8021x

 

Returns :

-TRUE if the alternative subject name match for "phase 2" was found and removed, -FALSE if it was not.

phase2_altsubject_match

the "phase 2" altSubjectName to remove

 
+
+

Returns

+

TRUE if the alternative subject name match for "phase 2" was found and removed, +FALSE if it was not.

+

+
+
-

nm_setting_802_1x_clear_phase2_altsubject_matches ()

-
void                nm_setting_802_1x_clear_phase2_altsubject_matches
-                                                        (NMSetting8021x *setting);
-

-Clears all "phase 2" altSubjectName matches. -

-
+

nm_setting_802_1x_clear_phase2_altsubject_matches ()

+
void
+nm_setting_802_1x_clear_phase2_altsubject_matches
+                               (NMSetting8021x *setting);
+

Clears all "phase 2" altSubjectName matches.

+
+

Parameters

+
--+++ - - + + +

setting :

the NMSetting8021x -

setting

the NMSetting8021x

 
+
-

nm_setting_802_1x_get_phase2_client_cert_scheme ()

-
NMSetting8021xCKScheme nm_setting_802_1x_get_phase2_client_cert_scheme
-                                                        (NMSetting8021x *setting);
-

-Returns the scheme used to store the "phase 2" client certificate. If the +

nm_setting_802_1x_get_phase2_client_cert_scheme ()

+
NMSetting8021xCKScheme
+nm_setting_802_1x_get_phase2_client_cert_scheme
+                               (NMSetting8021x *setting);
+

Returns the scheme used to store the "phase 2" client certificate. If the returned scheme is NM_SETTING_802_1X_CK_SCHEME_BLOB, use -nm_setting_802_1x_get_client_cert_blob(); if +nm_setting_802_1x_get_client_cert_blob(); if NM_SETTING_802_1X_CK_SCHEME_PATH, use -nm_setting_802_1x_get_client_cert_path(). -

-
+nm_setting_802_1x_get_client_cert_path().

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSetting8021x -

Returns :

scheme used to store the "phase 2" client certificate (blob or path)

setting

the NMSetting8021x

 
+
+

Returns

+

scheme used to store the "phase 2" client certificate (blob or path)

+

+
+
-

nm_setting_802_1x_get_phase2_client_cert_blob ()

-
GBytes *            nm_setting_802_1x_get_phase2_client_cert_blob
-                                                        (NMSetting8021x *setting);
-

-Client certificates are used to identify the connecting client to the network +

nm_setting_802_1x_get_phase2_client_cert_blob ()

+
GBytes *
+nm_setting_802_1x_get_phase2_client_cert_blob
+                               (NMSetting8021x *setting);
+

Client certificates are used to identify the connecting client to the network when EAP-TLS is used as either the "phase 1" or "phase 2" 802.1x -authentication method. -

-
+authentication method.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSetting8021x -

Returns :

the "phase 2" client certificate data. [transfer none] -

setting

the NMSetting8021x

 
+
+

Returns

+

the "phase 2" client certificate data.

+

[transfer none]

+
+
-

nm_setting_802_1x_get_phase2_client_cert_path ()

-
const char *        nm_setting_802_1x_get_phase2_client_cert_path
-                                                        (NMSetting8021x *setting);
-

-Client certificates are used to identify the connecting client to the network +

nm_setting_802_1x_get_phase2_client_cert_path ()

+
const char *
+nm_setting_802_1x_get_phase2_client_cert_path
+                               (NMSetting8021x *setting);
+

Client certificates are used to identify the connecting client to the network when EAP-TLS is used as either the "phase 1" or "phase 2" 802.1x -authentication method. -

-
+authentication method.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSetting8021x -

Returns :

path to the "phase 2" client certificate file

setting

the NMSetting8021x

 
+
+

Returns

+

path to the "phase 2" client certificate file

+

+
+
-

nm_setting_802_1x_set_phase2_client_cert ()

-
gboolean            nm_setting_802_1x_set_phase2_client_cert
-                                                        (NMSetting8021x *setting,
-                                                         const char *cert_path,
-                                                         NMSetting8021xCKScheme scheme,
-                                                         NMSetting8021xCKFormat *out_format,
-                                                         GError **error);
-

-Reads a certificate from disk and sets the "phase2-client-cert" +

nm_setting_802_1x_set_phase2_client_cert ()

+
gboolean
+nm_setting_802_1x_set_phase2_client_cert
+                               (NMSetting8021x *setting,
+                                const char *cert_path,
+                                NMSetting8021xCKScheme scheme,
+                                NMSetting8021xCKFormat *out_format,
+                                GError **error);
+

Reads a certificate from disk and sets the “phase2-client-cert” property with the raw certificate data if using the NM_SETTING_802_1X_CK_SCHEME_BLOB scheme, or with the path to the certificate -file if using the NM_SETTING_802_1X_CK_SCHEME_PATH scheme. -

-

-Client certificates are used to identify the connecting client to the network +file if using the NM_SETTING_802_1X_CK_SCHEME_PATH scheme.

+

Client certificates are used to identify the connecting client to the network when EAP-TLS is used as either the "phase 1" or "phase 2" 802.1x -authentication method. -

-
+authentication method.

+
+

Parameters

+
--+++ - - + + + - - + - - - - +encoded; use g_filename_to_utf8() to convert if needed. Passing NULL with +any scheme +clears the "phase2" client certificate.

+ - - + + + - - + + + - - + + +

setting :

the NMSetting8021x -

setting

the NMSetting8021x

 

cert_path :

when scheme is set to either NM_SETTING_802_1X_CK_SCHEME_PATH +

cert_path

when scheme +is set to either NM_SETTING_802_1X_CK_SCHEME_PATH or NM_SETTING_802_1X_CK_SCHEME_BLOB, pass the path of the "phase2" client certificate file (PEM, DER, or PKCS#12 format). The path must be UTF-8 -encoded; use g_filename_to_utf8() to convert if needed. Passing NULL with -any scheme clears the "phase2" client certificate.

scheme :

desired storage scheme for the certificate 

out_format :

on successful return, the type of the certificate added

scheme

desired storage scheme for the certificate

 

error :

on unsuccessful return, an error

out_format

on successful return, the type of the certificate added

 

Returns :

-TRUE if the operation succeeded, FALSE if it was unsuccessful

error

on unsuccessful return, an error

 
+
+

Returns

+

TRUE if the operation succeeded, FALSE if it was unsuccessful

+

+
+
-

nm_setting_802_1x_get_password ()

-
const char *        nm_setting_802_1x_get_password      (NMSetting8021x *setting);
-
+

nm_setting_802_1x_get_password ()

+
const char *
+nm_setting_802_1x_get_password (NMSetting8021x *setting);
+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSetting8021x -

Returns :

the password used by the authentication method, if any, as specified -by the "password" property

setting

the NMSetting8021x

 
+
+

Returns

+

the password used by the authentication method, if any, as specified +by the “password” property

+

+
+
-

nm_setting_802_1x_get_password_flags ()

-
NMSettingSecretFlags nm_setting_802_1x_get_password_flags
-                                                        (NMSetting8021x *setting);
-
+

nm_setting_802_1x_get_password_flags ()

+
NMSettingSecretFlags
+nm_setting_802_1x_get_password_flags (NMSetting8021x *setting);
+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSetting8021x -

Returns :

the NMSettingSecretFlags pertaining to the "password" -

setting

the NMSetting8021x

 
+
+

Returns

+

the NMSettingSecretFlags pertaining to the “password”

+

+
+
-

nm_setting_802_1x_get_password_raw ()

-
GBytes *            nm_setting_802_1x_get_password_raw  (NMSetting8021x *setting);
-
+

nm_setting_802_1x_get_password_raw ()

+
GBytes *
+nm_setting_802_1x_get_password_raw (NMSetting8021x *setting);
+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSetting8021x -

Returns :

the password used by the authentication method as a -UTF-8-encoded array of bytes, as specified by the -"password-raw" property. [transfer none] -

setting

the NMSetting8021x

 
+
+

Returns

+

the password used by the authentication method as a +UTF-8-encoded array of bytes, as specified by the +“password-raw” property.

+

[transfer none]

+
+
-

nm_setting_802_1x_get_password_raw_flags ()

-
NMSettingSecretFlags nm_setting_802_1x_get_password_raw_flags
-                                                        (NMSetting8021x *setting);
-
+

nm_setting_802_1x_get_password_raw_flags ()

+
NMSettingSecretFlags
+nm_setting_802_1x_get_password_raw_flags
+                               (NMSetting8021x *setting);
+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSetting8021x -

Returns :

the NMSettingSecretFlags pertaining to the -"password-raw" -

setting

the NMSetting8021x

 
+
+

Returns

+

the NMSettingSecretFlags pertaining to the +“password-raw”

+

+
+
-

nm_setting_802_1x_get_pin ()

-
const char *        nm_setting_802_1x_get_pin           (NMSetting8021x *setting);
-
+

nm_setting_802_1x_get_pin ()

+
const char *
+nm_setting_802_1x_get_pin (NMSetting8021x *setting);
+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSetting8021x -

Returns :

the PIN used by the authentication method, if any, as specified -by the "pin" property

setting

the NMSetting8021x

 
+
+

Returns

+

the PIN used by the authentication method, if any, as specified +by the “pin” property

+

+
+
-

nm_setting_802_1x_get_pin_flags ()

-
NMSettingSecretFlags nm_setting_802_1x_get_pin_flags    (NMSetting8021x *setting);
-
+

nm_setting_802_1x_get_pin_flags ()

+
NMSettingSecretFlags
+nm_setting_802_1x_get_pin_flags (NMSetting8021x *setting);
+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSetting8021x -

Returns :

the NMSettingSecretFlags pertaining to the -"pin" -

setting

the NMSetting8021x

 
+
+

Returns

+

the NMSettingSecretFlags pertaining to the +“pin”

+

+
+
-

nm_setting_802_1x_get_private_key_scheme ()

-
NMSetting8021xCKScheme nm_setting_802_1x_get_private_key_scheme
-                                                        (NMSetting8021x *setting);
-

-Returns the scheme used to store the private key. If the returned scheme is +

nm_setting_802_1x_get_private_key_scheme ()

+
NMSetting8021xCKScheme
+nm_setting_802_1x_get_private_key_scheme
+                               (NMSetting8021x *setting);
+

Returns the scheme used to store the private key. If the returned scheme is NM_SETTING_802_1X_CK_SCHEME_BLOB, use -nm_setting_802_1x_get_client_cert_blob(); if +nm_setting_802_1x_get_client_cert_blob(); if NM_SETTING_802_1X_CK_SCHEME_PATH, use -nm_setting_802_1x_get_client_cert_path(). -

-
+nm_setting_802_1x_get_client_cert_path().

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSetting8021x -

Returns :

scheme used to store the private key (blob or path)

setting

the NMSetting8021x

 
+
+

Returns

+

scheme used to store the private key (blob or path)

+

+
+
-

nm_setting_802_1x_get_private_key_blob ()

-
GBytes *            nm_setting_802_1x_get_private_key_blob
-                                                        (NMSetting8021x *setting);
-

-Private keys are used to authenticate the connecting client to the network +

nm_setting_802_1x_get_private_key_blob ()

+
GBytes *
+nm_setting_802_1x_get_private_key_blob
+                               (NMSetting8021x *setting);
+

Private keys are used to authenticate the connecting client to the network when EAP-TLS is used as either the "phase 1" or "phase 2" 802.1x -authentication method. -

-

-WARNING: the private key property is not a "secret" property, and thus +authentication method.

+

WARNING: the private key property is not a "secret" property, and thus unencrypted private key data may be readable by unprivileged users. Private -keys should always be encrypted with a private key password. -

-
+keys should always be encrypted with a private key password.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSetting8021x -

Returns :

the private key data. [transfer none] -

setting

the NMSetting8021x

 
+
+

Returns

+

the private key data.

+

[transfer none]

+
+
-

nm_setting_802_1x_get_private_key_path ()

-
const char *        nm_setting_802_1x_get_private_key_path
-                                                        (NMSetting8021x *setting);
-

-Private keys are used to authenticate the connecting client to the network +

nm_setting_802_1x_get_private_key_path ()

+
const char *
+nm_setting_802_1x_get_private_key_path
+                               (NMSetting8021x *setting);
+

Private keys are used to authenticate the connecting client to the network when EAP-TLS is used as either the "phase 1" or "phase 2" 802.1x -authentication method. -

-
+authentication method.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSetting8021x -

Returns :

path to the private key file

setting

the NMSetting8021x

 
+
+

Returns

+

path to the private key file

+

+
+
-

nm_setting_802_1x_set_private_key ()

-
gboolean            nm_setting_802_1x_set_private_key   (NMSetting8021x *setting,
-                                                         const char *key_path,
-                                                         const char *password,
-                                                         NMSetting8021xCKScheme scheme,
-                                                         NMSetting8021xCKFormat *out_format,
-                                                         GError **error);
-

-Private keys are used to authenticate the connecting client to the network +

nm_setting_802_1x_set_private_key ()

+
gboolean
+nm_setting_802_1x_set_private_key (NMSetting8021x *setting,
+                                   const char *key_path,
+                                   const char *password,
+                                   NMSetting8021xCKScheme scheme,
+                                   NMSetting8021xCKFormat *out_format,
+                                   GError **error);
+

Private keys are used to authenticate the connecting client to the network when EAP-TLS is used as either the "phase 1" or "phase 2" 802.1x -authentication method. -

-

-This function reads a private key from disk and sets the -"private-key" property with the private key file data if using +authentication method.

+

This function reads a private key from disk and sets the +“private-key” property with the private key file data if using the NM_SETTING_802_1X_CK_SCHEME_BLOB scheme, or with the path to the private -key file if using the NM_SETTING_802_1X_CK_SCHEME_PATH scheme. -

-

-If password is given, this function attempts to decrypt the private key to -verify that password is correct, and if it is, updates the -"private-key-password" property with the given password. If -the decryption is unsuccessful, FALSE is returned, error is set, and no -internal data is changed. If no password is given, the private key is +key file if using the NM_SETTING_802_1X_CK_SCHEME_PATH scheme.

+

If password + is given, this function attempts to decrypt the private key to +verify that password + is correct, and if it is, updates the +“private-key-password” property with the given password +. If +the decryption is unsuccessful, FALSE is returned, error + is set, and no +internal data is changed. If no password + is given, the private key is assumed to be valid, no decryption is performed, and the password may be set -at a later time. -

-

-WARNING: the private key property is not a "secret" property, and thus +at a later time.

+

WARNING: the private key property is not a "secret" property, and thus unencrypted private key data using the BLOB scheme may be readable by unprivileged users. Private keys should always be encrypted with a private -key password to prevent unauthorized access to unencrypted private key data. -

-
+key password to prevent unauthorized access to unencrypted private key data.

+
+

Parameters

+
--+++ - - + + + - - + +g_filename_to_utf8() to convert if needed. Passing NULL with any scheme +clears the private key.

+ - - + - - - - +an error is returned.

+ - - + + + - - + + + - - + + +

setting :

the NMSetting8021x -

setting

the NMSetting8021x

 

key_path :

when scheme is set to either NM_SETTING_802_1X_CK_SCHEME_PATH or +

key_path

when scheme +is set to either NM_SETTING_802_1X_CK_SCHEME_PATH or NM_SETTING_802_1X_CK_SCHEME_BLOB, pass the path of the private key file (PEM, DER, or PKCS#12 format). The path must be UTF-8 encoded; use -g_filename_to_utf8() to convert if needed. Passing NULL with any scheme -clears the private key.

 

password :

password used to decrypt the private key, or NULL if the password +

password

password used to decrypt the private key, or NULL if the password is unknown. If the password is given but fails to decrypt the private key, -an error is returned.

scheme :

desired storage scheme for the private key 

out_format :

on successful return, the type of the private key added

scheme

desired storage scheme for the private key

 

error :

on unsuccessful return, an error

out_format

on successful return, the type of the private key added

 

Returns :

-TRUE if the operation succeeded, FALSE if it was unsuccessful

error

on unsuccessful return, an error

 
+
+

Returns

+

TRUE if the operation succeeded, FALSE if it was unsuccessful

+

+
+
-

nm_setting_802_1x_get_private_key_password ()

-
const char *        nm_setting_802_1x_get_private_key_password
-                                                        (NMSetting8021x *setting);
-
+

nm_setting_802_1x_get_private_key_password ()

+
const char *
+nm_setting_802_1x_get_private_key_password
+                               (NMSetting8021x *setting);
+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSetting8021x -

Returns :

the private key password used to decrypt the private key if -previously set with nm_setting_802_1x_set_private_key(), or the -"private-key-password" property.

setting

the NMSetting8021x

 
+
+

Returns

+

the private key password used to decrypt the private key if +previously set with nm_setting_802_1x_set_private_key(), or the +“private-key-password” property.

+

+
+
-

nm_setting_802_1x_get_private_key_password_flags ()

-
NMSettingSecretFlags nm_setting_802_1x_get_private_key_password_flags
-                                                        (NMSetting8021x *setting);
-
+

nm_setting_802_1x_get_private_key_password_flags ()

+
NMSettingSecretFlags
+nm_setting_802_1x_get_private_key_password_flags
+                               (NMSetting8021x *setting);
+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSetting8021x -

Returns :

the NMSettingSecretFlags pertaining to the -"private-key-password" -

setting

the NMSetting8021x

 
+
+

Returns

+

the NMSettingSecretFlags pertaining to the +“private-key-password”

+

+
+
-

nm_setting_802_1x_get_private_key_format ()

-
NMSetting8021xCKFormat nm_setting_802_1x_get_private_key_format
-                                                        (NMSetting8021x *setting);
-
+

nm_setting_802_1x_get_private_key_format ()

+
NMSetting8021xCKFormat
+nm_setting_802_1x_get_private_key_format
+                               (NMSetting8021x *setting);
+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSetting8021x -

Returns :

the data format of the private key data stored in the -"private-key" property

setting

the NMSetting8021x

 
+
+

Returns

+

the data format of the private key data stored in the +“private-key” property

+

+
+
-

nm_setting_802_1x_get_phase2_private_key_scheme ()

-
NMSetting8021xCKScheme nm_setting_802_1x_get_phase2_private_key_scheme
-                                                        (NMSetting8021x *setting);
-

-Returns the scheme used to store the "phase 2" private key. If the returned +

nm_setting_802_1x_get_phase2_private_key_scheme ()

+
NMSetting8021xCKScheme
+nm_setting_802_1x_get_phase2_private_key_scheme
+                               (NMSetting8021x *setting);
+

Returns the scheme used to store the "phase 2" private key. If the returned scheme is NM_SETTING_802_1X_CK_SCHEME_BLOB, use -nm_setting_802_1x_get_client_cert_blob(); if +nm_setting_802_1x_get_client_cert_blob(); if NM_SETTING_802_1X_CK_SCHEME_PATH, use -nm_setting_802_1x_get_client_cert_path(). -

-
+nm_setting_802_1x_get_client_cert_path().

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSetting8021x -

Returns :

scheme used to store the "phase 2" private key (blob or path)

setting

the NMSetting8021x

 
+
+

Returns

+

scheme used to store the "phase 2" private key (blob or path)

+

+
+
-

nm_setting_802_1x_get_phase2_private_key_blob ()

-
GBytes *            nm_setting_802_1x_get_phase2_private_key_blob
-                                                        (NMSetting8021x *setting);
-

-Private keys are used to authenticate the connecting client to the network +

nm_setting_802_1x_get_phase2_private_key_blob ()

+
GBytes *
+nm_setting_802_1x_get_phase2_private_key_blob
+                               (NMSetting8021x *setting);
+

Private keys are used to authenticate the connecting client to the network when EAP-TLS is used as either the "phase 1" or "phase 2" 802.1x -authentication method. -

-

-WARNING: the phase2 private key property is not a "secret" property, and thus +authentication method.

+

WARNING: the phase2 private key property is not a "secret" property, and thus unencrypted private key data may be readable by unprivileged users. Private -keys should always be encrypted with a private key password. -

-
+keys should always be encrypted with a private key password.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSetting8021x -

Returns :

the "phase 2" private key data. [transfer none] -

setting

the NMSetting8021x

 
+
+

Returns

+

the "phase 2" private key data.

+

[transfer none]

+
+
-

nm_setting_802_1x_get_phase2_private_key_path ()

-
const char *        nm_setting_802_1x_get_phase2_private_key_path
-                                                        (NMSetting8021x *setting);
-

-Private keys are used to authenticate the connecting client to the network +

nm_setting_802_1x_get_phase2_private_key_path ()

+
const char *
+nm_setting_802_1x_get_phase2_private_key_path
+                               (NMSetting8021x *setting);
+

Private keys are used to authenticate the connecting client to the network when EAP-TLS is used as either the "phase 1" or "phase 2" 802.1x -authentication method. -

-
+authentication method.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSetting8021x -

Returns :

path to the "phase 2" private key file

setting

the NMSetting8021x

 
+
+

Returns

+

path to the "phase 2" private key file

+

+
+
-

nm_setting_802_1x_set_phase2_private_key ()

-
gboolean            nm_setting_802_1x_set_phase2_private_key
-                                                        (NMSetting8021x *setting,
-                                                         const char *key_path,
-                                                         const char *password,
-                                                         NMSetting8021xCKScheme scheme,
-                                                         NMSetting8021xCKFormat *out_format,
-                                                         GError **error);
-

-Private keys are used to authenticate the connecting client to the network +

nm_setting_802_1x_set_phase2_private_key ()

+
gboolean
+nm_setting_802_1x_set_phase2_private_key
+                               (NMSetting8021x *setting,
+                                const char *key_path,
+                                const char *password,
+                                NMSetting8021xCKScheme scheme,
+                                NMSetting8021xCKFormat *out_format,
+                                GError **error);
+

Private keys are used to authenticate the connecting client to the network when EAP-TLS is used as either the "phase 1" or "phase 2" 802.1x -authentication method. -

-

-This function reads a private key from disk and sets the -"phase2-private-key" property with the private key file data if +authentication method.

+

This function reads a private key from disk and sets the +“phase2-private-key” property with the private key file data if using the NM_SETTING_802_1X_CK_SCHEME_BLOB scheme, or with the path to the -private key file if using the NM_SETTING_802_1X_CK_SCHEME_PATH scheme. -

-

-If password is given, this function attempts to decrypt the private key to -verify that password is correct, and if it is, updates the -"phase2-private-key-password" property with the given -password. If the decryption is unsuccessful, FALSE is returned, error is -set, and no internal data is changed. If no password is given, the private +private key file if using the NM_SETTING_802_1X_CK_SCHEME_PATH scheme.

+

If password + is given, this function attempts to decrypt the private key to +verify that password + is correct, and if it is, updates the +“phase2-private-key-password” property with the given +password +. If the decryption is unsuccessful, FALSE is returned, error + is +set, and no internal data is changed. If no password + is given, the private key is assumed to be valid, no decryption is performed, and the password may -be set at a later time. -

-

-WARNING: the "phase2" private key property is not a "secret" property, and +be set at a later time.

+

WARNING: the "phase2" private key property is not a "secret" property, and thus unencrypted private key data using the BLOB scheme may be readable by unprivileged users. Private keys should always be encrypted with a private -key password to prevent unauthorized access to unencrypted private key data. -

-
+key password to prevent unauthorized access to unencrypted private key data.

+
+

Parameters

+
--+++ - - + + + - - + +use g_filename_to_utf8() to convert if needed. Passing NULL with any +scheme +clears the private key.

+ - - + - - - - +an error is returned.

+ - - + + + - - + + + - - + + +

setting :

the NMSetting8021x -

setting

the NMSetting8021x

 

key_path :

when scheme is set to either NM_SETTING_802_1X_CK_SCHEME_PATH or +

key_path

when scheme +is set to either NM_SETTING_802_1X_CK_SCHEME_PATH or NM_SETTING_802_1X_CK_SCHEME_BLOB, pass the path of the "phase2" private key file (PEM, DER, or PKCS#12 format). The path must be UTF-8 encoded; -use g_filename_to_utf8() to convert if needed. Passing NULL with any -scheme clears the private key.

 

password :

password used to decrypt the private key, or NULL if the password +

password

password used to decrypt the private key, or NULL if the password is unknown. If the password is given but fails to decrypt the private key, -an error is returned.

scheme :

desired storage scheme for the private key 

out_format :

on successful return, the type of the private key added

scheme

desired storage scheme for the private key

 

error :

on unsuccessful return, an error

out_format

on successful return, the type of the private key added

 

Returns :

-TRUE if the operation succeeded, FALSE if it was unsuccessful

error

on unsuccessful return, an error

 
+
+

Returns

+

TRUE if the operation succeeded, FALSE if it was unsuccessful

+

+
+
-

nm_setting_802_1x_get_phase2_private_key_password ()

-
const char *        nm_setting_802_1x_get_phase2_private_key_password
-                                                        (NMSetting8021x *setting);
-
+

nm_setting_802_1x_get_phase2_private_key_password ()

+
const char *
+nm_setting_802_1x_get_phase2_private_key_password
+                               (NMSetting8021x *setting);
+
+

Parameters

+
--+++ - - - - - - - - - - + + + + + +

setting :

the NMSetting8021x -

Returns :

the private key password used to decrypt the private key if -previously set with nm_setting_802_1x_set_phase2_private_key() or the -"phase2-private-key-password" property.

setting

the NMSetting8021x

 
+
+
+

Returns

+

the private key password used to decrypt the private key if +previously set with nm_setting_802_1x_set_phase2_private_key() or the +“phase2-private-key-password” property.

+

+
+ +
+
+

nm_setting_802_1x_get_phase2_private_key_password_flags ()

+
NMSettingSecretFlags
+nm_setting_802_1x_get_phase2_private_key_password_flags
+                               (NMSetting8021x *setting);
+
+

Parameters

+
+++++ + + + + +

setting

the NMSetting8021x

 
+
+

Returns

+

the NMSettingSecretFlags pertaining to the +“phase2-private-key-password”

+

+
+

-

nm_setting_802_1x_get_phase2_private_key_password_flags ()

-
NMSettingSecretFlags nm_setting_802_1x_get_phase2_private_key_password_flags
-                                                        (NMSetting8021x *setting);
-
+

nm_setting_802_1x_get_phase2_private_key_format ()

+
NMSetting8021xCKFormat
+nm_setting_802_1x_get_phase2_private_key_format
+                               (NMSetting8021x *setting);
+
+

Parameters

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

setting

the NMSetting8021x

 
+
+
+

Returns

+

the data format of the "phase 2" private key data stored in the +“phase2-private-key” property

+

+
+ + +
+

Types and Values

+
+

enum NMSetting8021xCKFormat

+

NMSetting8021xCKFormat values indicate the general type of a certificate +or private key

+
+

Members

+
--+++ - - + + + + + + + + + + + + - - + +

setting :

the NMSetting8021x +

NM_SETTING_802_1X_CK_FORMAT_UNKNOWN

+

unknown file format

+
 

NM_SETTING_802_1X_CK_FORMAT_X509

+

file contains an X.509 format certificate

+
 

NM_SETTING_802_1X_CK_FORMAT_RAW_KEY

+

file contains an old-style OpenSSL PEM +or DER private key

 

Returns :

the NMSettingSecretFlags pertaining to the -"phase2-private-key-password" +

NM_SETTING_802_1X_CK_FORMAT_PKCS12

+

file contains a PKCS#12 certificate +and private key

 
+

-

nm_setting_802_1x_get_phase2_private_key_format ()

-
NMSetting8021xCKFormat nm_setting_802_1x_get_phase2_private_key_format
-                                                        (NMSetting8021x *setting);
-
+

enum NMSetting8021xCKScheme

+

NMSetting8021xCKScheme values indicate how a certificate or private key is +stored in the setting properties, either as a blob of the item's data, or as +a path to a certificate or private key file on the filesystem

+
+

Members

+
--+++ - - + + + + + + + - - + + +

setting :

the NMSetting8021x +

NM_SETTING_802_1X_CK_SCHEME_UNKNOWN

+

unknown certificate or private key +scheme

+
 

NM_SETTING_802_1X_CK_SCHEME_BLOB

+

certificate or key is stored as the raw +item data

 

Returns :

the data format of the "phase 2" private key data stored in the -"phase2-private-key" property

NM_SETTING_802_1X_CK_SCHEME_PATH

+

certificate or key is stored as a path +to a file containing the certificate or key data

+
 
-
-

Property Details

+
-

The "altsubject-matches" property

-
  "altsubject-matches"       GStrv                 : Read / Write
+

NM_SETTING_802_1X_SETTING_NAME

+
#define NM_SETTING_802_1X_SETTING_NAME "802-1x"
+

-List of strings to be matched against the altSubjectName of the -certificate presented by the authentication server. If the list is empty, -no verification of the server certificate's altSubjectName is performed.


-

The "anonymous-identity" property

-
  "anonymous-identity"       gchar*                : Read / Write
+

NM_SETTING_802_1X_EAP

+
#define NM_SETTING_802_1X_EAP "eap"
+

-Anonymous identity string for EAP authentication methods. Used as the -unencrypted identity with EAP types that support different tunneled -identity like EAP-TTLS.

-

Default value: NULL


-

The "ca-cert" property

-
  "ca-cert"                  GBytes*               : Read / Write
+

NM_SETTING_802_1X_IDENTITY

+
#define NM_SETTING_802_1X_IDENTITY "identity"
+

-Contains the CA certificate if used by the EAP method specified in the -"eap" property.

+
+
+
+

NM_SETTING_802_1X_ANONYMOUS_IDENTITY

+
#define NM_SETTING_802_1X_ANONYMOUS_IDENTITY "anonymous-identity"
+

-Certificate data is specified using a "scheme"; two are currently -supported: blob and path. When using the blob scheme (which is backwards -compatible with NM 0.7.x) this property should be set to the -certificate's DER encoded data. When using the path scheme, this property -should be set to the full UTF-8 encoded path of the certificate, prefixed -with the string "file://" and ending with a terminating NUL byte. This -property can be unset even if the EAP method supports CA certificates, -but this allows man-in-the-middle attacks and is NOT recommended.

+
+
+
+

NM_SETTING_802_1X_PAC_FILE

+
#define NM_SETTING_802_1X_PAC_FILE "pac-file"
+

-Setting this property directly is discouraged; use the -nm_setting_802_1x_set_ca_cert() function instead.


-

The "ca-path" property

-
  "ca-path"                  gchar*                : Read / Write
+

NM_SETTING_802_1X_CA_CERT

+
#define NM_SETTING_802_1X_CA_CERT "ca-cert"
+

-UTF-8 encoded path to a directory containing PEM or DER formatted -certificates to be added to the verification chain in addition to the -certificate specified in the "ca-cert" property.

-

Default value: NULL


-

The "client-cert" property

-
  "client-cert"              GBytes*               : Read / Write
+

NM_SETTING_802_1X_CA_PATH

+
#define NM_SETTING_802_1X_CA_PATH "ca-path"
+

-Contains the client certificate if used by the EAP method specified in -the "eap" property.

+
+
+
+

NM_SETTING_802_1X_SUBJECT_MATCH

+
#define NM_SETTING_802_1X_SUBJECT_MATCH "subject-match"
+

-Certificate data is specified using a "scheme"; two are currently -supported: blob and path. When using the blob scheme (which is backwards -compatible with NM 0.7.x) this property should be set to the -certificate's DER encoded data. When using the path scheme, this property -should be set to the full UTF-8 encoded path of the certificate, prefixed -with the string "file://" and ending with a terminating NUL byte.

+
+
+
+

NM_SETTING_802_1X_ALTSUBJECT_MATCHES

+
#define NM_SETTING_802_1X_ALTSUBJECT_MATCHES "altsubject-matches"
+

-Setting this property directly is discouraged; use the -nm_setting_802_1x_set_client_cert() function instead.


-

The "eap" property

-
  "eap"                      GStrv                 : Read / Write
+

NM_SETTING_802_1X_CLIENT_CERT

+
#define NM_SETTING_802_1X_CLIENT_CERT "client-cert"
+

-The allowed EAP method to be used when authenticating to the network with -802.1x. Valid methods are: "leap", "md5", "tls", "peap", "ttls", "pwd", -and "fast". Each method requires different configuration using the -properties of this setting; refer to wpa_supplicant documentation for the -allowed combinations.


-

The "identity" property

-
  "identity"                 gchar*                : Read / Write
+

NM_SETTING_802_1X_PHASE1_PEAPVER

+
#define NM_SETTING_802_1X_PHASE1_PEAPVER "phase1-peapver"
+

-Identity string for EAP authentication methods. Often the user's user or -login name.

-

Default value: NULL


-

The "pac-file" property

-
  "pac-file"                 gchar*                : Read / Write
+

NM_SETTING_802_1X_PHASE1_PEAPLABEL

+
#define NM_SETTING_802_1X_PHASE1_PEAPLABEL "phase1-peaplabel"
+

-UTF-8 encoded file path containing PAC for EAP-FAST.

-

Default value: NULL


-

The "password" property

-
  "password"                 gchar*                : Read / Write
+

NM_SETTING_802_1X_PHASE1_FAST_PROVISIONING

+
#define NM_SETTING_802_1X_PHASE1_FAST_PROVISIONING "phase1-fast-provisioning"
+

-UTF-8 encoded password used for EAP authentication methods. If both the -"password" property and the "password-raw" -property are specified, "password" is preferred.

-

Default value: NULL


-

The "password-flags" property

-
  "password-flags"           NMSettingSecretFlags  : Read / Write
+

NM_SETTING_802_1X_PHASE2_AUTH

+
#define NM_SETTING_802_1X_PHASE2_AUTH "phase2-auth"
+

-Flags indicating how to handle the "password" property.


-

The "password-raw" property

-
  "password-raw"             GBytes*               : Read / Write
+

NM_SETTING_802_1X_PHASE2_AUTHEAP

+
#define NM_SETTING_802_1X_PHASE2_AUTHEAP "phase2-autheap"
+

-Password used for EAP authentication methods, given as a byte array to -allow passwords in other encodings than UTF-8 to be used. If both the -"password" property and the "password-raw" -property are specified, "password" is preferred.


-

The "password-raw-flags" property

-
  "password-raw-flags"       NMSettingSecretFlags  : Read / Write
+

NM_SETTING_802_1X_PHASE2_CA_CERT

+
#define NM_SETTING_802_1X_PHASE2_CA_CERT "phase2-ca-cert"
+

-Flags indicating how to handle the "password-raw" property.


-

The "phase1-fast-provisioning" property

-
  "phase1-fast-provisioning" gchar*                : Read / Write
+

NM_SETTING_802_1X_PHASE2_CA_PATH

+
#define NM_SETTING_802_1X_PHASE2_CA_PATH "phase2-ca-path"
+

-Enables or disables in-line provisioning of EAP-FAST credentials when -FAST is specified as the EAP method in the "eap" property. -Recognized values are "0" (disabled), "1" (allow unauthenticated -provisioning), "2" (allow authenticated provisioning), and "3" (allow -both authenticated and unauthenticated provisioning). See the -wpa_supplicant documentation for more details.

-

Default value: NULL


-

The "phase1-peaplabel" property

-
  "phase1-peaplabel"         gchar*                : Read / Write
+

NM_SETTING_802_1X_PHASE2_SUBJECT_MATCH

+
#define NM_SETTING_802_1X_PHASE2_SUBJECT_MATCH "phase2-subject-match"
+

-Forces use of the new PEAP label during key derivation. Some RADIUS -servers may require forcing the new PEAP label to interoperate with -PEAPv1. Set to "1" to force use of the new PEAP label. See the -wpa_supplicant documentation for more details.

-

Default value: NULL


-

The "phase1-peapver" property

-
  "phase1-peapver"           gchar*                : Read / Write
+

NM_SETTING_802_1X_PHASE2_ALTSUBJECT_MATCHES

+
#define NM_SETTING_802_1X_PHASE2_ALTSUBJECT_MATCHES "phase2-altsubject-matches"
+

-Forces which PEAP version is used when PEAP is set as the EAP method in -the "eap" property. When unset, the version reported by -the server will be used. Sometimes when using older RADIUS servers, it -is necessary to force the client to use a particular PEAP version. To do -so, this property may be set to "0" or "1" to force that specific PEAP -version.

-

Default value: NULL


-

The "phase2-altsubject-matches" property

-
  "phase2-altsubject-matches" GStrv                 : Read / Write
+

NM_SETTING_802_1X_PHASE2_CLIENT_CERT

+
#define NM_SETTING_802_1X_PHASE2_CLIENT_CERT "phase2-client-cert"
+

-List of strings to be matched against the altSubjectName of the -certificate presented by the authentication server during the inner -"phase 2" authentication. If the list is empty, no verification of the -server certificate's altSubjectName is performed.


-

The "phase2-auth" property

-
  "phase2-auth"              gchar*                : Read / Write
+

NM_SETTING_802_1X_PASSWORD

+
#define NM_SETTING_802_1X_PASSWORD "password"
+

-Specifies the allowed "phase 2" inner non-EAP authentication methods when -an EAP method that uses an inner TLS tunnel is specified in the -"eap" property. Recognized non-EAP "phase 2" methods are -"pap", "chap", "mschap", "mschapv2", "gtc", "otp", "md5", and "tls". -Each "phase 2" inner method requires specific parameters for successful -authentication; see the wpa_supplicant documentation for more details.

-

Default value: NULL


-

The "phase2-autheap" property

-
  "phase2-autheap"           gchar*                : Read / Write
+

NM_SETTING_802_1X_PASSWORD_FLAGS

+
#define NM_SETTING_802_1X_PASSWORD_FLAGS "password-flags"
+

-Specifies the allowed "phase 2" inner EAP-based authentication methods -when an EAP method that uses an inner TLS tunnel is specified in the -"eap" property. Recognized EAP-based "phase 2" methods are -"md5", "mschapv2", "otp", "gtc", and "tls". Each "phase 2" inner method -requires specific parameters for successful authentication; see the -wpa_supplicant documentation for more details.

-

Default value: NULL


-

The "phase2-ca-cert" property

-
  "phase2-ca-cert"           GBytes*               : Read / Write
+

NM_SETTING_802_1X_PASSWORD_RAW

+
#define NM_SETTING_802_1X_PASSWORD_RAW "password-raw"
+

-Contains the "phase 2" CA certificate if used by the EAP method specified -in the "phase2-auth" or "phase2-autheap" -properties.

+
+
+
+

NM_SETTING_802_1X_PASSWORD_RAW_FLAGS

+
#define NM_SETTING_802_1X_PASSWORD_RAW_FLAGS "password-raw-flags"
+

-Certificate data is specified using a "scheme"; two are currently -supported: blob and path. When using the blob scheme (which is backwards -compatible with NM 0.7.x) this property should be set to the -certificate's DER encoded data. When using the path scheme, this property -should be set to the full UTF-8 encoded path of the certificate, prefixed -with the string "file://" and ending with a terminating NUL byte. This -property can be unset even if the EAP method supports CA certificates, -but this allows man-in-the-middle attacks and is NOT recommended.

+
+
+
+

NM_SETTING_802_1X_PRIVATE_KEY

+
#define NM_SETTING_802_1X_PRIVATE_KEY "private-key"
+

-Setting this property directly is discouraged; use the -nm_setting_802_1x_set_phase2_ca_cert() function instead.


-

The "phase2-ca-path" property

-
  "phase2-ca-path"           gchar*                : Read / Write
+

NM_SETTING_802_1X_PRIVATE_KEY_PASSWORD

+
#define NM_SETTING_802_1X_PRIVATE_KEY_PASSWORD "private-key-password"
+

-UTF-8 encoded path to a directory containing PEM or DER formatted -certificates to be added to the verification chain in addition to the -certificate specified in the "phase2-ca-cert" property.

-

Default value: NULL


-

The "phase2-client-cert" property

-
  "phase2-client-cert"       GBytes*               : Read / Write
+

NM_SETTING_802_1X_PRIVATE_KEY_PASSWORD_FLAGS

+
#define NM_SETTING_802_1X_PRIVATE_KEY_PASSWORD_FLAGS "private-key-password-flags"
+

-Contains the "phase 2" client certificate if used by the EAP method -specified in the "phase2-auth" or -"phase2-autheap" properties.

+
+
+
+

NM_SETTING_802_1X_PHASE2_PRIVATE_KEY

+
#define NM_SETTING_802_1X_PHASE2_PRIVATE_KEY "phase2-private-key"
+

-Certificate data is specified using a "scheme"; two are currently -supported: blob and path. When using the blob scheme (which is backwards -compatible with NM 0.7.x) this property should be set to the -certificate's DER encoded data. When using the path scheme, this property -should be set to the full UTF-8 encoded path of the certificate, prefixed -with the string "file://" and ending with a terminating NUL byte. This -property can be unset even if the EAP method supports CA certificates, -but this allows man-in-the-middle attacks and is NOT recommended.

+
+
+
+

NM_SETTING_802_1X_PHASE2_PRIVATE_KEY_PASSWORD

+
#define NM_SETTING_802_1X_PHASE2_PRIVATE_KEY_PASSWORD "phase2-private-key-password"
+

-Setting this property directly is discouraged; use the -nm_setting_802_1x_set_phase2_client_cert() function instead.


-

The "phase2-private-key" property

-
  "phase2-private-key"       GBytes*               : Read / Write
+

NM_SETTING_802_1X_PHASE2_PRIVATE_KEY_PASSWORD_FLAGS

+
#define NM_SETTING_802_1X_PHASE2_PRIVATE_KEY_PASSWORD_FLAGS "phase2-private-key-password-flags"
+

-Contains the "phase 2" inner private key when the -"phase2-auth" or "phase2-autheap" property is -set to "tls".

+
+
+
+

NM_SETTING_802_1X_PIN

+
#define NM_SETTING_802_1X_PIN "pin"
+

-Key data is specified using a "scheme"; two are currently supported: blob -and path. When using the blob scheme and private keys, this property -should be set to the key's encrypted PEM encoded data. When using private -keys with the path scheme, this property should be set to the full UTF-8 -encoded path of the key, prefixed with the string "file://" and ending -with a terminating NUL byte. When using PKCS#12 format private -keys and the blob scheme, this property should be set to the -PKCS#12 data and the "phase2-private-key-password" -property must be set to password used to decrypt the PKCS#12 -certificate and key. When using PKCS#12 files and the path -scheme, this property should be set to the full UTF-8 encoded path of the -key, prefixed with the string "file://" and and ending with a terminating -NUL byte, and as with the blob scheme the -"phase2-private-key-password" property must be set to the -password used to decode the PKCS#12 private key and certificate.

+
+
+
+

NM_SETTING_802_1X_PIN_FLAGS

+
#define NM_SETTING_802_1X_PIN_FLAGS "pin-flags"
+

-Setting this property directly is discouraged; use the -nm_setting_802_1x_set_phase2_private_key() function instead.


-

The "phase2-private-key-password" property

-
  "phase2-private-key-password" gchar*                : Read / Write
+

NM_SETTING_802_1X_SYSTEM_CA_CERTS

+
#define NM_SETTING_802_1X_SYSTEM_CA_CERTS "system-ca-certs"
+

-The password used to decrypt the "phase 2" private key specified in the -"phase2-private-key" property when the private key either -uses the path scheme, or is a PKCS#12 format key. Setting this -property directly is not generally necessary except when returning -secrets to NetworkManager; it is generally set automatically when setting -the private key by the nm_setting_802_1x_set_phase2_private_key() -function.

+
+
+
+

Property Details

+
+

The “altsubject-matches” property

+
  “altsubject-matches”       GStrv
+

+

Flags: Read / Write

+
+
+
+

The “anonymous-identity” property

+
  “anonymous-identity”       gchar *
+

+

Flags: Read / Write

Default value: NULL


-

The "phase2-private-key-password-flags" property

-
  "phase2-private-key-password-flags" NMSettingSecretFlags  : Read / Write
-

-Flags indicating how to handle the -"phase2-private-key-password" property. -

+

The “ca-cert” property

+
  “ca-cert”                  GBytes *
+

+

Flags: Read / Write


-

The "phase2-subject-match" property

-
  "phase2-subject-match"     gchar*                : Read / Write
-

-Substring to be matched against the subject of the certificate presented -by the authentication server during the inner "phase 2" -authentication. When unset, no verification of the authentication server -certificate's subject is performed. -

+

The “ca-path” property

+
  “ca-path”                  gchar *
+

+

Flags: Read / Write

Default value: NULL


-

The "pin" property

-
  "pin"                      gchar*                : Read / Write
-

-PIN used for EAP authentication methods. -

+

The “client-cert” property

+
  “client-cert”              GBytes *
+

+

Flags: Read / Write

+
+
+
+

The “eap” property

+
  “eap”                      GStrv
+

+

Flags: Read / Write

+
+
+
+

The “identity” property

+
  “identity”                 gchar *
+

+

Flags: Read / Write

Default value: NULL


-

The "pin-flags" property

-
  "pin-flags"                NMSettingSecretFlags  : Read / Write
-

-Flags indicating how to handle the "pin" property. -

+

The “pac-file” property

+
  “pac-file”                 gchar *
+

+

Flags: Read / Write

+

Default value: NULL


-

The "private-key" property

-
  "private-key"              GBytes*               : Read / Write
-

-Contains the private key when the "eap" property is set to -"tls". -

-

-Key data is specified using a "scheme"; two are currently supported: blob -and path. When using the blob scheme and private keys, this property -should be set to the key's encrypted PEM encoded data. When using private -keys with the path scheme, this property should be set to the full UTF-8 -encoded path of the key, prefixed with the string "file://" and ending -with a terminating NUL byte. When using PKCS#12 format private -keys and the blob scheme, this property should be set to the -PKCS#12 data and the "private-key-password" -property must be set to password used to decrypt the PKCS#12 -certificate and key. When using PKCS#12 files and the path -scheme, this property should be set to the full UTF-8 encoded path of the -key, prefixed with the string "file://" and and ending with a terminating -NUL byte, and as with the blob scheme the "private-key-password" property -must be set to the password used to decode the PKCS#12 private -key and certificate. -

-

-Setting this property directly is discouraged; use the -nm_setting_802_1x_set_private_key() function instead. -

-

-WARNING: "private-key" is not a "secret" property, and thus -unencrypted private key data using the BLOB scheme may be readable by -unprivileged users. Private keys should always be encrypted with a -private key password to prevent unauthorized access to unencrypted -private key data. -

+

The “password” property

+
  “password”                 gchar *
+

+

Flags: Read / Write

+

Default value: NULL


-

The "private-key-password" property

-
  "private-key-password"     gchar*                : Read / Write
-

-The password used to decrypt the private key specified in the -"private-key" property when the private key either uses the -path scheme, or if the private key is a PKCS#12 format key. Setting this -property directly is not generally necessary except when returning -secrets to NetworkManager; it is generally set automatically when setting -the private key by the nm_setting_802_1x_set_private_key() function. -

+

The “password-flags” property

+
  “password-flags”           NMSettingSecretFlags
+

+

Flags: Read / Write

+
+
+
+

The “password-raw” property

+
  “password-raw”             GBytes *
+

+

Flags: Read / Write

+
+
+
+

The “password-raw-flags” property

+
  “password-raw-flags”       NMSettingSecretFlags
+

+

Flags: Read / Write

+
+
+
+

The “phase1-fast-provisioning” property

+
  “phase1-fast-provisioning” gchar *
+

+

Flags: Read / Write

Default value: NULL


-

The "private-key-password-flags" property

-
  "private-key-password-flags" NMSettingSecretFlags  : Read / Write
-

-Flags indicating how to handle the "private-key-password" -property. -

+

The “phase1-peaplabel” property

+
  “phase1-peaplabel”         gchar *
+

+

Flags: Read / Write

+

Default value: NULL


-

The "subject-match" property

-
  "subject-match"            gchar*                : Read / Write
-

-Substring to be matched against the subject of the certificate presented -by the authentication server. When unset, no verification of the -authentication server certificate's subject is performed. -

+

The “phase1-peapver” property

+
  “phase1-peapver”           gchar *
+

+

Flags: Read / Write

Default value: NULL


-

The "system-ca-certs" property

-
  "system-ca-certs"          gboolean              : Read / Write / Construct
-

-When TRUE, overrides the "ca-path" and -"phase2-ca-path" properties using the system CA directory -specified at configure time with the --system-ca-path switch. The -certificates in this directory are added to the verification chain in -addition to any certificates specified by the "ca-cert" and -"phase2-ca-cert" properties. -

+

The “phase2-altsubject-matches” property

+
  “phase2-altsubject-matches” GStrv
+

+

Flags: Read / Write

+
+
+
+

The “phase2-auth” property

+
  “phase2-auth”              gchar *
+

+

Flags: Read / Write

+

Default value: NULL

+
+
+
+

The “phase2-autheap” property

+
  “phase2-autheap”           gchar *
+

+

Flags: Read / Write

+

Default value: NULL

+
+
+
+

The “phase2-ca-cert” property

+
  “phase2-ca-cert”           GBytes *
+

+

Flags: Read / Write

+
+
+
+

The “phase2-ca-path” property

+
  “phase2-ca-path”           gchar *
+

+

Flags: Read / Write

+

Default value: NULL

+
+
+
+

The “phase2-client-cert” property

+
  “phase2-client-cert”       GBytes *
+

+

Flags: Read / Write

+
+
+
+

The “phase2-private-key” property

+
  “phase2-private-key”       GBytes *
+

+

Flags: Read / Write

+
+
+
+

The “phase2-private-key-password” property

+
  “phase2-private-key-password” gchar *
+

+

Flags: Read / Write

+

Default value: NULL

+
+
+
+

The “phase2-private-key-password-flags” property

+
  “phase2-private-key-password-flags” NMSettingSecretFlags
+

+

Flags: Read / Write

+
+
+
+

The “phase2-subject-match” property

+
  “phase2-subject-match”     gchar *
+

+

Flags: Read / Write

+

Default value: NULL

+
+
+
+

The “pin” property

+
  “pin”                      gchar *
+

+

Flags: Read / Write

+

Default value: NULL

+
+
+
+

The “pin-flags” property

+
  “pin-flags”                NMSettingSecretFlags
+

+

Flags: Read / Write

+
+
+
+

The “private-key” property

+
  “private-key”              GBytes *
+

+

Flags: Read / Write

+
+
+
+

The “private-key-password” property

+
  “private-key-password”     gchar *
+

+

Flags: Read / Write

+

Default value: NULL

+
+
+
+

The “private-key-password-flags” property

+
  “private-key-password-flags” NMSettingSecretFlags
+

+

Flags: Read / Write

+
+
+
+

The “subject-match” property

+
  “subject-match”            gchar *
+

+

Flags: Read / Write

+

Default value: NULL

+
+
+
+

The “system-ca-certs” property

+
  “system-ca-certs”          gboolean
+

+

Flags: Read / Write / Construct

Default value: FALSE

+ Generated by GTK-Doc V1.21 \ No newline at end of file diff --git a/docs/libnm/html/NMSettingAdsl.html b/docs/libnm/html/NMSettingAdsl.html index cbbf1701..f96005af 100644 --- a/docs/libnm/html/NMSettingAdsl.html +++ b/docs/libnm/html/NMSettingAdsl.html @@ -2,34 +2,28 @@ -NMSettingAdsl +libnm Reference Manual: NMSettingAdsl - + - - - - - - - - - - + + + + + + +
@@ -37,64 +31,403 @@

NMSettingAdsl

NMSettingAdsl — Describes ADSL-based properties

- +
-
-

Object Hierarchy

-
-  GObject
-   +----NMSetting
-         +----NMSettingAdsl
-
+

Functions

+
++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+NMSetting * + +nm_setting_adsl_new () +
const char * + +nm_setting_adsl_get_username () +
const char * + +nm_setting_adsl_get_password () +
const char * + +nm_setting_adsl_get_protocol () +
const char * + +nm_setting_adsl_get_encapsulation () +
+guint32 + +nm_setting_adsl_get_vpi () +
+guint32 + +nm_setting_adsl_get_vci () +
+NMSettingSecretFlags + +nm_setting_adsl_get_password_flags () +

Properties

-
-  "encapsulation"            gchar*                : Read / Write
-  "password"                 gchar*                : Read / Write
-  "password-flags"           NMSettingSecretFlags  : Read / Write
-  "protocol"                 gchar*                : Read / Write
-  "username"                 gchar*                : Read / Write
-  "vci"                      guint                 : Read / Write
-  "vpi"                      guint                 : Read / Write
+
+++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+gchar *encapsulationRead / Write
+gchar *passwordRead / Write
NMSettingSecretFlagspassword-flagsRead / Write
+gchar *protocolRead / Write
+gchar *usernameRead / Write
guintvciRead / Write
guintvpiRead / Write
+
+ +
+

Object Hierarchy

+
    GObject
+    ╰── NMSetting
+        ╰── NMSettingAdsl
 

Description

-

-The NMSettingAdsl object is a NMSetting subclass that describes -properties of ADSL connections. -

+

The NMSettingAdsl object is a NMSetting subclass that describes +properties of ADSL connections.

+
+
+

Functions

+
+

nm_setting_adsl_new ()

+
NMSetting *
+nm_setting_adsl_new (void);
+

Creates a new NMSettingAdsl object with default values.

+
+

Returns

+

the new empty NMSettingAdsl object

+

+
+
+
+
+

nm_setting_adsl_get_username ()

+
const char *
+nm_setting_adsl_get_username (NMSettingAdsl *setting);
+
+

Parameters

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

setting

the NMSettingAdsl

 
+
+
+

Returns

+

the “username” property of the setting

+

+
+
+
+
+

nm_setting_adsl_get_password ()

+
const char *
+nm_setting_adsl_get_password (NMSettingAdsl *setting);
+
+

Parameters

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

setting

the NMSettingAdsl

 
+
+
+

Returns

+

the “password” property of the setting

+

+
+
+
+
+

nm_setting_adsl_get_protocol ()

+
const char *
+nm_setting_adsl_get_protocol (NMSettingAdsl *setting);
+
+

Parameters

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

setting

the NMSettingAdsl

 
+
+
+

Returns

+

the “protocol” property of the setting

+

+
+
+
+
+

nm_setting_adsl_get_encapsulation ()

+
const char *
+nm_setting_adsl_get_encapsulation (NMSettingAdsl *setting);
+
+

Parameters

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

setting

the NMSettingAdsl

 
+
+
+

Returns

+

the “encapsulation” property of the setting

+

+
+
+
+
+

nm_setting_adsl_get_vpi ()

+
guint32
+nm_setting_adsl_get_vpi (NMSettingAdsl *setting);
+
+

Parameters

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

setting

the NMSettingAdsl

 
+
+
+

Returns

+

the “vpi” property of the setting

+

+
+
+
+
+

nm_setting_adsl_get_vci ()

+
guint32
+nm_setting_adsl_get_vci (NMSettingAdsl *setting);
+
+

Parameters

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

setting

the NMSettingAdsl

 
+
+
+

Returns

+

the “vci” property of the setting

+

+
+
+
+
+

nm_setting_adsl_get_password_flags ()

+
NMSettingSecretFlags
+nm_setting_adsl_get_password_flags (NMSettingAdsl *setting);
+
+

Parameters

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

setting

the NMSettingAdsl

 
+
+
+

Returns

+

the NMSettingSecretFlags pertaining to the “password”

+

+
+
-

Details

+

Types and Values

NM_SETTING_ADSL_SETTING_NAME

#define NM_SETTING_ADSL_SETTING_NAME "adsl"
@@ -198,259 +531,62 @@ properties of ADSL connections.
 

-
-
-

struct NMSettingAdsl

-
struct NMSettingAdsl;
-

-

-
-
-
-

NMSettingAdslClass

-
typedef struct {
-	NMSettingClass parent;
-} NMSettingAdslClass;
-
-

-

-
-
-
-

nm_setting_adsl_new ()

-
NMSetting *         nm_setting_adsl_new                 (void);
-

-Creates a new NMSettingAdsl object with default values. -

-
---- - - - - -

Returns :

the new empty NMSettingAdsl object
-
-
-
-

nm_setting_adsl_get_username ()

-
const char *        nm_setting_adsl_get_username        (NMSettingAdsl *setting);
-
---- - - - - - - - - - - -

setting :

the NMSettingAdsl -

Returns :

the "username" property of the setting
-
-
-
-

nm_setting_adsl_get_password ()

-
const char *        nm_setting_adsl_get_password        (NMSettingAdsl *setting);
-
---- - - - - - - - - - - -

setting :

the NMSettingAdsl -

Returns :

the "password" property of the setting
-
-
-
-

nm_setting_adsl_get_protocol ()

-
const char *        nm_setting_adsl_get_protocol        (NMSettingAdsl *setting);
-
---- - - - - - - - - - - -

setting :

the NMSettingAdsl -

Returns :

the "protocol" property of the setting
-
-
-
-

nm_setting_adsl_get_encapsulation ()

-
const char *        nm_setting_adsl_get_encapsulation   (NMSettingAdsl *setting);
-
---- - - - - - - - - - - -

setting :

the NMSettingAdsl -

Returns :

the "encapsulation" property of the setting
-
-
-
-

nm_setting_adsl_get_vpi ()

-
guint32             nm_setting_adsl_get_vpi             (NMSettingAdsl *setting);
-
---- - - - - - - - - - - -

setting :

the NMSettingAdsl -

Returns :

the "vpi" property of the setting
-
-
-
-

nm_setting_adsl_get_vci ()

-
guint32             nm_setting_adsl_get_vci             (NMSettingAdsl *setting);
-
---- - - - - - - - - - - -

setting :

the NMSettingAdsl -

Returns :

the "vci" property of the setting
-
-
-
-

nm_setting_adsl_get_password_flags ()

-
NMSettingSecretFlags nm_setting_adsl_get_password_flags (NMSettingAdsl *setting);
-
---- - - - - - - - - - - -

setting :

the NMSettingAdsl -

Returns :

the NMSettingSecretFlags pertaining to the "password" -
-

Property Details

-

The "encapsulation" property

-
  "encapsulation"            gchar*                : Read / Write
-

-Encapsulation of ADSL connection. Can be "vcmux" or "llc". -

+

The “encapsulation” property

+
  “encapsulation”            gchar *
+

+

Flags: Read / Write

Default value: NULL


-

The "password" property

-
  "password"                 gchar*                : Read / Write
-

-Password used to authenticate with the ADSL service. -

+

The “password” property

+
  “password”                 gchar *
+

+

Flags: Read / Write

Default value: NULL


-

The "password-flags" property

-
  "password-flags"           NMSettingSecretFlags  : Read / Write
-

-Flags indicating how to handle the "password" property. -

+

The “password-flags” property

+
  “password-flags”           NMSettingSecretFlags
+

+

Flags: Read / Write


-

The "protocol" property

-
  "protocol"                 gchar*                : Read / Write
-

-ADSL connection protocol. Can be "pppoa", "pppoe" or "ipoatm". -

+

The “protocol” property

+
  “protocol”                 gchar *
+

+

Flags: Read / Write

Default value: NULL


-

The "username" property

-
  "username"                 gchar*                : Read / Write
-

-Username used to authenticate with the ADSL service. -

+

The “username” property

+
  “username”                 gchar *
+

+

Flags: Read / Write

Default value: NULL


-

The "vci" property

-
  "vci"                      guint                 : Read / Write
-

-VCI of ADSL connection -

+

The “vci” property

+
  “vci”                      guint
+

+

Flags: Read / Write

Allowed values: <= 65536

Default value: 0


-

The "vpi" property

-
  "vpi"                      guint                 : Read / Write
-

-VPI of ADSL connection -

+

The “vpi” property

+
  “vpi”                      guint
+

+

Flags: Read / Write

Allowed values: <= 65536

Default value: 0

@@ -458,6 +594,6 @@ VPI of ADSL connection
+ Generated by GTK-Doc V1.21
\ No newline at end of file diff --git a/docs/libnm/html/NMSettingBluetooth.html b/docs/libnm/html/NMSettingBluetooth.html index 203c3911..89118318 100644 --- a/docs/libnm/html/NMSettingBluetooth.html +++ b/docs/libnm/html/NMSettingBluetooth.html @@ -2,34 +2,28 @@ -NMSettingBluetooth +libnm Reference Manual: NMSettingBluetooth - + - - - - - - - - - - + + + + + + +
@@ -37,49 +31,184 @@

NMSettingBluetooth

NMSettingBluetooth — Describes Bluetooth connection properties

- +
-
-

Object Hierarchy

-
-  GObject
-   +----NMSetting
-         +----NMSettingBluetooth
-
+

Functions

+
++++ + + + + + + + + + + + + + + +
+NMSetting * + +nm_setting_bluetooth_new () +
const char * + +nm_setting_bluetooth_get_bdaddr () +
const char * + +nm_setting_bluetooth_get_connection_type () +

Properties

-
-  "bdaddr"                   gchar*                : Read / Write
-  "type"                     gchar*                : Read / Write
+
+++++ + + + + + + + + + + + + +
+gchar *bdaddrRead / Write
+gchar *typeRead / Write
+
+
+

Types and Values

+ +
+
+

Object Hierarchy

+
    GObject
+    ╰── NMSetting
+        ╰── NMSettingBluetooth
 

Description

-

-The NMSettingBluetooth object is a NMSetting subclass that describes +

The NMSettingBluetooth object is a NMSetting subclass that describes properties necessary for connection to devices that provide network connections via the Bluetooth Dial-Up Networking (DUN) and Network Access -Point (NAP) profiles. -

+Point (NAP) profiles.

+
+
+

Functions

+
+

nm_setting_bluetooth_new ()

+
NMSetting *
+nm_setting_bluetooth_new (void);
+

Creates a new NMSettingBluetooth object with default values.

+
+

Returns

+

the new empty NMSettingBluetooth object.

+

[transfer full]

+
+
+
+
+

nm_setting_bluetooth_get_bdaddr ()

+
const char *
+nm_setting_bluetooth_get_bdaddr (NMSettingBluetooth *setting);
+

Gets the Bluetooth address of the remote device which this setting +describes a connection to.

+
+

Parameters

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

setting

the NMSettingBluetooth

 
+
+
+

Returns

+

the Bluetooth address

+

+
+
+
+
+

nm_setting_bluetooth_get_connection_type ()

+
const char *
+nm_setting_bluetooth_get_connection_type
+                               (NMSettingBluetooth *setting);
+

Returns the connection method for communicating with the remote device (i.e. +either DUN to a DUN-capable device or PANU to a NAP-capable device).

+
+

Parameters

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

setting

the NMSettingBluetooth

 
+
+ +
-

Details

+

Types and Values

NM_SETTING_BLUETOOTH_SETTING_NAME

#define NM_SETTING_BLUETOOTH_SETTING_NAME "bluetooth"
@@ -108,137 +237,39 @@ Point (NAP) profiles.
 

NM_SETTING_BLUETOOTH_TYPE_DUN

#define NM_SETTING_BLUETOOTH_TYPE_DUN  "dun"
 
-

-Connection type describing a connection to devices that support the Bluetooth -DUN profile. -

+

Connection type describing a connection to devices that support the Bluetooth +DUN profile.


NM_SETTING_BLUETOOTH_TYPE_PANU

#define NM_SETTING_BLUETOOTH_TYPE_PANU "panu"
 
-

-Connection type describing a connection to devices that support the Bluetooth -NAP (Network Access Point) protocol, which accepts connections via PANU. -

-
-
-
-

struct NMSettingBluetooth

-
struct NMSettingBluetooth;
-

-

-
-
-
-

NMSettingBluetoothClass

-
typedef struct {
-	NMSettingClass parent;
-} NMSettingBluetoothClass;
-
-

-

-
-
-
-

nm_setting_bluetooth_new ()

-
NMSetting *         nm_setting_bluetooth_new            (void);
-

-Creates a new NMSettingBluetooth object with default values. -

-
---- - - - - -

Returns :

the new empty NMSettingBluetooth object. [transfer full] -
-
-
-
-

nm_setting_bluetooth_get_bdaddr ()

-
const char *        nm_setting_bluetooth_get_bdaddr     (NMSettingBluetooth *setting);
-

-Gets the Bluetooth address of the remote device which this setting -describes a connection to. -

-
---- - - - - - - - - - - -

setting :

the NMSettingBluetooth -

Returns :

the Bluetooth address
-
-
-
-

nm_setting_bluetooth_get_connection_type ()

-
const char *        nm_setting_bluetooth_get_connection_type
-                                                        (NMSettingBluetooth *setting);
-

-Returns the connection method for communicating with the remote device (i.e. -either DUN to a DUN-capable device or PANU to a NAP-capable device). -

-
---- - - - - - - - - - - -

setting :

the NMSettingBluetooth -

Returns :

the type, either NM_SETTING_BLUETOOTH_TYPE_PANU or -NM_SETTING_BLUETOOTH_TYPE_DUN -
+

Connection type describing a connection to devices that support the Bluetooth +NAP (Network Access Point) protocol, which accepts connections via PANU.

Property Details

-

The "bdaddr" property

-
  "bdaddr"                   gchar*                : Read / Write
-

-The Bluetooth address of the device. -

+

The “bdaddr” property

+
  “bdaddr”                   gchar *
+

+

Flags: Read / Write

Default value: NULL


-

The "type" property

-
  "type"                     gchar*                : Read / Write
-

-Either "dun" for Dial-Up Networking connections or "panu" for Personal -Area Networking connections to devices supporting the NAP profile. -

+

The “type” property

+
  “type”                     gchar *
+

+

Flags: Read / Write

Default value: NULL

+ Generated by GTK-Doc V1.21 \ No newline at end of file diff --git a/docs/libnm/html/NMSettingBond.html b/docs/libnm/html/NMSettingBond.html index 6a4d566c..3df3d490 100644 --- a/docs/libnm/html/NMSettingBond.html +++ b/docs/libnm/html/NMSettingBond.html @@ -2,34 +2,28 @@ -NMSettingBond +libnm Reference Manual: NMSettingBond - + - - - - - - - - - - + + + + + + +
@@ -37,72 +31,525 @@

NMSettingBond

NMSettingBond — Describes connection properties for bonds

- +
-
-

Synopsis

-
#define             NM_SETTING_BOND_SETTING_NAME
-#define             NM_SETTING_BOND_OPTIONS
-#define             NM_SETTING_BOND_OPTION_MODE
-#define             NM_SETTING_BOND_OPTION_MIIMON
-#define             NM_SETTING_BOND_OPTION_DOWNDELAY
-#define             NM_SETTING_BOND_OPTION_UPDELAY
-#define             NM_SETTING_BOND_OPTION_ARP_INTERVAL
-#define             NM_SETTING_BOND_OPTION_ARP_IP_TARGET
-#define             NM_SETTING_BOND_OPTION_ARP_VALIDATE
-#define             NM_SETTING_BOND_OPTION_PRIMARY
-#define             NM_SETTING_BOND_OPTION_PRIMARY_RESELECT
-#define             NM_SETTING_BOND_OPTION_FAIL_OVER_MAC
-#define             NM_SETTING_BOND_OPTION_USE_CARRIER
-#define             NM_SETTING_BOND_OPTION_AD_SELECT
-#define             NM_SETTING_BOND_OPTION_XMIT_HASH_POLICY
-#define             NM_SETTING_BOND_OPTION_RESEND_IGMP
-#define             NM_SETTING_BOND_OPTION_LACP_RATE
-struct              NMSettingBond;
-                    NMSettingBondClass;
-NMSetting *         nm_setting_bond_new                 (void);
-guint32             nm_setting_bond_get_num_options     (NMSettingBond *setting);
-gboolean            nm_setting_bond_get_option          (NMSettingBond *setting,
-                                                         guint32 idx,
-                                                         const char **out_name,
-                                                         const char **out_value);
-const char *        nm_setting_bond_get_option_by_name  (NMSettingBond *setting,
-                                                         const char *name);
-gboolean            nm_setting_bond_add_option          (NMSettingBond *setting,
-                                                         const char *name,
-                                                         const char *value);
-gboolean            nm_setting_bond_remove_option       (NMSettingBond *setting,
-                                                         const char *name);
-gboolean            nm_setting_bond_validate_option     (const char *name,
-                                                         const char *value);
-const char **       nm_setting_bond_get_valid_options   (NMSettingBond *setting);
-const char *        nm_setting_bond_get_option_default  (NMSettingBond *setting,
-                                                         const char *name);
-
-
-

Object Hierarchy

-
-  GObject
-   +----NMSetting
-         +----NMSettingBond
-
+

Functions

+
++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+NMSetting * + +nm_setting_bond_new () +
+guint32 + +nm_setting_bond_get_num_options () +
+gboolean + +nm_setting_bond_get_option () +
const char * + +nm_setting_bond_get_option_by_name () +
+gboolean + +nm_setting_bond_add_option () +
+gboolean + +nm_setting_bond_remove_option () +
+gboolean + +nm_setting_bond_validate_option () +
const char ** + +nm_setting_bond_get_valid_options () +
const char * + +nm_setting_bond_get_option_default () +

Properties

-
-  "options"                  GHashTable*           : Read / Write
+
+++++ + + + + + +
+GHashTable *optionsRead / Write
+
+ +
+

Object Hierarchy

+
    GObject
+    ╰── NMSetting
+        ╰── NMSettingBond
 

Description

-

-The NMSettingBond object is a NMSetting subclass that describes properties -necessary for bond connections. -

+

The NMSettingBond object is a NMSetting subclass that describes properties +necessary for bond connections.

+
+
+

Functions

+
+

nm_setting_bond_new ()

+
NMSetting *
+nm_setting_bond_new (void);
+

Creates a new NMSettingBond object with default values.

+
+

Returns

+

the new empty NMSettingBond object.

+

[transfer full]

+
+
+
+
+

nm_setting_bond_get_num_options ()

+
guint32
+nm_setting_bond_get_num_options (NMSettingBond *setting);
+

Returns the number of options that should be set for this bond when it +is activated. This can be used to retrieve each option individually +using nm_setting_bond_get_option().

+
+

Parameters

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

setting

the NMSettingBond

 
+
+
+

Returns

+

the number of bonding options

+

+
+
+
+
+

nm_setting_bond_get_option ()

+
gboolean
+nm_setting_bond_get_option (NMSettingBond *setting,
+                            guint32 idx,
+                            const char **out_name,
+                            const char **out_value);
+

Given an index, return the value of the bonding option at that index. Indexes +are *not* guaranteed to be static across modifications to options done by +nm_setting_bond_add_option() and nm_setting_bond_remove_option(), +and should not be used to refer to options except for short periods of time +such as during option iteration.

+
+

Parameters

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

setting

the NMSettingBond

 

idx

index of the desired option, from 0 to +nm_setting_bond_get_num_options() - 1

 

out_name

on return, the name of the bonding option; +this value is owned by the setting and should not be modified.

[out][transfer none]

out_value

on return, the value of the name of the +bonding option; this value is owned by the setting and should not be +modified.

[out][transfer none]
+
+
+

Returns

+

TRUE on success if the index was valid and an option was found, +FALSE if the index was invalid (ie, greater than the number of options +currently held by the setting)

+

+
+
+
+
+

nm_setting_bond_get_option_by_name ()

+
const char *
+nm_setting_bond_get_option_by_name (NMSettingBond *setting,
+                                    const char *name);
+

Returns the value associated with the bonding option specified by +name +, if it exists.

+
+

Parameters

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

setting

the NMSettingBond

 

name

the option name for which to retrieve the value

 
+
+
+

Returns

+

the value, or NULL if the key/value pair was never added to the +setting; the value is owned by the setting and must not be modified

+

+
+
+
+
+

nm_setting_bond_add_option ()

+
gboolean
+nm_setting_bond_add_option (NMSettingBond *setting,
+                            const char *name,
+                            const char *value);
+

Add an option to the table. The option is compared to an internal list +of allowed options. Option names may contain only alphanumeric characters +(ie [a-zA-Z0-9]). Adding a new name replaces any existing name/value pair +that may already exist.

+

The order of how to set several options is relevant because there are options +that conflict with each other.

+
+

Parameters

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

setting

the NMSettingBond

 

name

name for the option

 

value

value for the option

 
+
+
+

Returns

+

TRUE if the option was valid and was added to the internal option +list, FALSE if it was not.

+

+
+
+
+
+

nm_setting_bond_remove_option ()

+
gboolean
+nm_setting_bond_remove_option (NMSettingBond *setting,
+                               const char *name);
+

Remove the bonding option referenced by name + from the internal option +list.

+
+

Parameters

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

setting

the NMSettingBond

 

name

name of the option to remove

 
+
+
+

Returns

+

TRUE if the option was found and removed from the internal option +list, FALSE if it was not.

+

+
+
+
+
+

nm_setting_bond_validate_option ()

+
gboolean
+nm_setting_bond_validate_option (const char *name,
+                                 const char *value);
+

Checks whether name + is a valid bond option and value + is a valid value for +the name +. If value + is NULL, the function only validates the option name.

+
+

Parameters

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

name

the name of the option to validate

 

value

the value of the option to validate

 
+
+
+

Returns

+

TRUE, if the value +is valid for the given name. +If the name +is not a valid option, FALSE will be returned.

+

+
+
+
+
+

nm_setting_bond_get_valid_options ()

+
const char **
+nm_setting_bond_get_valid_options (NMSettingBond *setting);
+

Returns a list of valid bond options.

+
+

Parameters

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

setting

the NMSettingBond

 
+
+
+

Returns

+

a NULL-terminated array of strings of valid bond options.

+

[transfer none]

+
+
+
+
+

nm_setting_bond_get_option_default ()

+
const char *
+nm_setting_bond_get_option_default (NMSettingBond *setting,
+                                    const char *name);
+
+

Parameters

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

setting

the NMSettingBond

 

name

the name of the option

 
+
+
+

Returns

+

the value of the bond option if not overridden by an entry in +the “options” property.

+

+
+
-

Details

+

Types and Values

NM_SETTING_BOND_SETTING_NAME

#define NM_SETTING_BOND_SETTING_NAME "bond"
@@ -238,336 +685,19 @@ necessary for bond connections.
 

-
-
-

struct NMSettingBond

-
struct NMSettingBond;
-

-

-
-
-
-

NMSettingBondClass

-
typedef struct {
-	NMSettingClass parent;
-} NMSettingBondClass;
-
-

-

-
-
-
-

nm_setting_bond_new ()

-
NMSetting *         nm_setting_bond_new                 (void);
-

-Creates a new NMSettingBond object with default values. -

-
---- - - - - -

Returns :

the new empty NMSettingBond object. [transfer full] -
-
-
-
-

nm_setting_bond_get_num_options ()

-
guint32             nm_setting_bond_get_num_options     (NMSettingBond *setting);
-

-Returns the number of options that should be set for this bond when it -is activated. This can be used to retrieve each option individually -using nm_setting_bond_get_option(). -

-
---- - - - - - - - - - - -

setting :

the NMSettingBond -

Returns :

the number of bonding options
-
-
-
-

nm_setting_bond_get_option ()

-
gboolean            nm_setting_bond_get_option          (NMSettingBond *setting,
-                                                         guint32 idx,
-                                                         const char **out_name,
-                                                         const char **out_value);
-

-Given an index, return the value of the bonding option at that index. Indexes -are *not* guaranteed to be static across modifications to options done by -nm_setting_bond_add_option() and nm_setting_bond_remove_option(), -and should not be used to refer to options except for short periods of time -such as during option iteration. -

-
---- - - - - - - - - - - - - - - - - - - - - - - -

setting :

the NMSettingBond -

idx :

index of the desired option, from 0 to -nm_setting_bond_get_num_options() - 1

out_name :

on return, the name of the bonding option; -this value is owned by the setting and should not be modified. [out][transfer none] -

out_value :

on return, the value of the name of the -bonding option; this value is owned by the setting and should not be -modified. [out][transfer none] -

Returns :

-TRUE on success if the index was valid and an option was found, -FALSE if the index was invalid (ie, greater than the number of options -currently held by the setting)
-
-
-
-

nm_setting_bond_get_option_by_name ()

-
const char *        nm_setting_bond_get_option_by_name  (NMSettingBond *setting,
-                                                         const char *name);
-

-Returns the value associated with the bonding option specified by -name, if it exists. -

-
---- - - - - - - - - - - - - - - -

setting :

the NMSettingBond -

name :

the option name for which to retrieve the value

Returns :

the value, or NULL if the key/value pair was never added to the -setting; the value is owned by the setting and must not be modified
-
-
-
-

nm_setting_bond_add_option ()

-
gboolean            nm_setting_bond_add_option          (NMSettingBond *setting,
-                                                         const char *name,
-                                                         const char *value);
-

-Add an option to the table. The option is compared to an internal list -of allowed options. Option names may contain only alphanumeric characters -(ie [a-zA-Z0-9]). Adding a new name replaces any existing name/value pair -that may already exist. -

-

-The order of how to set several options is relevant because there are options -that conflict with each other. -

-
---- - - - - - - - - - - - - - - - - - - -

setting :

the NMSettingBond -

name :

name for the option

value :

value for the option

Returns :

-TRUE if the option was valid and was added to the internal option -list, FALSE if it was not.
-
-
-
-

nm_setting_bond_remove_option ()

-
gboolean            nm_setting_bond_remove_option       (NMSettingBond *setting,
-                                                         const char *name);
-

-Remove the bonding option referenced by name from the internal option -list. -

-
---- - - - - - - - - - - - - - - -

setting :

the NMSettingBond -

name :

name of the option to remove

Returns :

-TRUE if the option was found and removed from the internal option -list, FALSE if it was not.
-
-
-
-

nm_setting_bond_validate_option ()

-
gboolean            nm_setting_bond_validate_option     (const char *name,
-                                                         const char *value);
-

-Checks whether name is a valid bond option and value is a valid value for -the name. If value is NULL, the function only validates the option name. -

-
---- - - - - - - - - - - - - - - -

name :

the name of the option to validate

value :

the value of the option to validate

Returns :

-TRUE, if the value is valid for the given name. -If the name is not a valid option, FALSE will be returned.
-
-
-
-

nm_setting_bond_get_valid_options ()

-
const char **       nm_setting_bond_get_valid_options   (NMSettingBond *setting);
-

-Returns a list of valid bond options. -

-
---- - - - - - - - - - - -

setting :

the NMSettingBond -

Returns :

a NULL-terminated array of strings of valid bond options. [transfer none] -
-
-
-
-

nm_setting_bond_get_option_default ()

-
const char *        nm_setting_bond_get_option_default  (NMSettingBond *setting,
-                                                         const char *name);
-
---- - - - - - - - - - - - - - - -

setting :

the NMSettingBond -

name :

the name of the option

Returns :

the value of the bond option if not overridden by an entry in -the "options" property.
-

Property Details

-

The "options" property

-
  "options"                  GHashTable*           : Read / Write
-

-Dictionary of key/value pairs of bonding options. Both keys and values -must be strings. Option names must contain only alphanumeric characters -(ie, [a-zA-Z0-9]). -

-

-Type: GHashTable(utf8,utf8) -

+

The “options” property

+
  “options”                  GHashTable *
+

+

Flags: Read / Write

+ Generated by GTK-Doc V1.21 \ No newline at end of file diff --git a/docs/libnm/html/NMSettingBridge.html b/docs/libnm/html/NMSettingBridge.html index 7248b61b..addccbb4 100644 --- a/docs/libnm/html/NMSettingBridge.html +++ b/docs/libnm/html/NMSettingBridge.html @@ -2,34 +2,28 @@ -NMSettingBridge +libnm Reference Manual: NMSettingBridge - + - - - - - - - - - - + + + + + + +
@@ -37,59 +31,383 @@

NMSettingBridge

NMSettingBridge — Describes connection properties for bridges

- +
-
-

Object Hierarchy

-
-  GObject
-   +----NMSetting
-         +----NMSettingBridge
-
+

Functions

+
++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+NMSetting * + +nm_setting_bridge_new () +
const char * + +nm_setting_bridge_get_mac_address () +
+gboolean + +nm_setting_bridge_get_stp () +
+guint16 + +nm_setting_bridge_get_priority () +
+guint16 + +nm_setting_bridge_get_forward_delay () +
+guint16 + +nm_setting_bridge_get_hello_time () +
+guint16 + +nm_setting_bridge_get_max_age () +
+guint32 + +nm_setting_bridge_get_ageing_time () +

Properties

-
-  "ageing-time"              guint                 : Read / Write / Construct
-  "forward-delay"            guint                 : Read / Write / Construct
-  "hello-time"               guint                 : Read / Write / Construct
-  "mac-address"              gchar*                : Read / Write
-  "max-age"                  guint                 : Read / Write / Construct
-  "priority"                 guint                 : Read / Write / Construct
-  "stp"                      gboolean              : Read / Write / Construct
+
+++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
guintageing-timeRead / Write / Construct
guintforward-delayRead / Write / Construct
guinthello-timeRead / Write / Construct
+gchar *mac-addressRead / Write
guintmax-ageRead / Write / Construct
guintpriorityRead / Write / Construct
gbooleanstpRead / Write / Construct
+
+
+

Types and Values

+ +
+
+

Object Hierarchy

+
    GObject
+    ╰── NMSetting
+        ╰── NMSettingBridge
 

Description

-

-The NMSettingBridge object is a NMSetting subclass that describes properties -necessary for bridging connections. -

+

The NMSettingBridge object is a NMSetting subclass that describes properties +necessary for bridging connections.

+
+
+

Functions

+
+

nm_setting_bridge_new ()

+
NMSetting *
+nm_setting_bridge_new (void);
+

Creates a new NMSettingBridge object with default values.

+
+

Returns

+

the new empty NMSettingBridge object.

+

[transfer full]

+
+
+
+
+

nm_setting_bridge_get_mac_address ()

+
const char *
+nm_setting_bridge_get_mac_address (NMSettingBridge *setting);
+
+

Parameters

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

setting

the NMSettingBridge

 
+
+
+

Returns

+

the “mac-address” property of the setting

+

+
+
+
+
+

nm_setting_bridge_get_stp ()

+
gboolean
+nm_setting_bridge_get_stp (NMSettingBridge *setting);
+
+

Parameters

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

setting

the NMSettingBridge

 
+
+
+

Returns

+

the “stp” property of the setting

+

+
+
+
+
+

nm_setting_bridge_get_priority ()

+
guint16
+nm_setting_bridge_get_priority (NMSettingBridge *setting);
+
+

Parameters

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

setting

the NMSettingBridge

 
+
+
+

Returns

+

the “priority” property of the setting

+

+
+
+
+
+

nm_setting_bridge_get_forward_delay ()

+
guint16
+nm_setting_bridge_get_forward_delay (NMSettingBridge *setting);
+
+

Parameters

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

setting

the NMSettingBridge

 
+
+
+

Returns

+

the “forward-delay” property of the setting

+

+
+
+
+
+

nm_setting_bridge_get_hello_time ()

+
guint16
+nm_setting_bridge_get_hello_time (NMSettingBridge *setting);
+
+

Parameters

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

setting

the NMSettingBridge

 
+
+
+

Returns

+

the “hello-time” property of the setting

+

+
+
+
+
+

nm_setting_bridge_get_max_age ()

+
guint16
+nm_setting_bridge_get_max_age (NMSettingBridge *setting);
+
+

Parameters

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

setting

the NMSettingBridge

 
+
+
+

Returns

+

the “max-age” property of the setting

+

+
+
+
+
+

nm_setting_bridge_get_ageing_time ()

+
guint32
+nm_setting_bridge_get_ageing_time (NMSettingBridge *setting);
+
+

Parameters

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

setting

the NMSettingBridge

 
+
+
+

Returns

+

the “ageing-time” property of the setting

+

+
+
-

Details

+

Types and Values

NM_SETTING_BRIDGE_SETTING_NAME

#define NM_SETTING_BRIDGE_SETTING_NAME "bridge"
@@ -153,274 +471,73 @@ necessary for bridging connections.
 

-
-
-

struct NMSettingBridge

-
struct NMSettingBridge;
-

-

-
-
-
-

NMSettingBridgeClass

-
typedef struct {
-	NMSettingClass parent;
-} NMSettingBridgeClass;
-
-

-

-
-
-
-

nm_setting_bridge_new ()

-
NMSetting *         nm_setting_bridge_new               (void);
-

-Creates a new NMSettingBridge object with default values. -

-
---- - - - - -

Returns :

the new empty NMSettingBridge object. [transfer full] -
-
-
-
-

nm_setting_bridge_get_mac_address ()

-
const char *        nm_setting_bridge_get_mac_address   (NMSettingBridge *setting);
-
---- - - - - - - - - - - -

setting :

the NMSettingBridge -

Returns :

the "mac-address" property of the setting
-
-
-
-

nm_setting_bridge_get_stp ()

-
gboolean            nm_setting_bridge_get_stp           (NMSettingBridge *setting);
-
---- - - - - - - - - - - -

setting :

the NMSettingBridge -

Returns :

the "stp" property of the setting
-
-
-
-

nm_setting_bridge_get_priority ()

-
guint16             nm_setting_bridge_get_priority      (NMSettingBridge *setting);
-
---- - - - - - - - - - - -

setting :

the NMSettingBridge -

Returns :

the "priority" property of the setting
-
-
-
-

nm_setting_bridge_get_forward_delay ()

-
guint16             nm_setting_bridge_get_forward_delay (NMSettingBridge *setting);
-
---- - - - - - - - - - - -

setting :

the NMSettingBridge -

Returns :

the "forward-delay" property of the setting
-
-
-
-

nm_setting_bridge_get_hello_time ()

-
guint16             nm_setting_bridge_get_hello_time    (NMSettingBridge *setting);
-
---- - - - - - - - - - - -

setting :

the NMSettingBridge -

Returns :

the "hello-time" property of the setting
-
-
-
-

nm_setting_bridge_get_max_age ()

-
guint16             nm_setting_bridge_get_max_age       (NMSettingBridge *setting);
-
---- - - - - - - - - - - -

setting :

the NMSettingBridge -

Returns :

the "max-age" property of the setting
-
-
-
-

nm_setting_bridge_get_ageing_time ()

-
guint32             nm_setting_bridge_get_ageing_time   (NMSettingBridge *setting);
-
---- - - - - - - - - - - -

setting :

the NMSettingBridge -

Returns :

the "ageing-time" property of the setting
-

Property Details

-

The "ageing-time" property

-
  "ageing-time"              guint                 : Read / Write / Construct
-

-The Ethernet MAC address aging time, in seconds. -

+

The “ageing-time” property

+
  “ageing-time”              guint
+

+

Flags: Read / Write / Construct

Allowed values: <= 1000000

Default value: 300


-

The "forward-delay" property

-
  "forward-delay"            guint                 : Read / Write / Construct
-

-The Spanning Tree Protocol (STP) forwarding delay, in seconds. -

+

The “forward-delay” property

+
  “forward-delay”            guint
+

+

Flags: Read / Write / Construct

Allowed values: <= 30

Default value: 15


-

The "hello-time" property

-
  "hello-time"               guint                 : Read / Write / Construct
-

-The Spanning Tree Protocol (STP) hello time, in seconds. -

+

The “hello-time” property

+
  “hello-time”               guint
+

+

Flags: Read / Write / Construct

Allowed values: <= 10

Default value: 2


-

The "mac-address" property

-
  "mac-address"              gchar*                : Read / Write
-

-If specified, the MAC address of bridge. When creating a new bridge, this -MAC address will be set. When matching an existing (outside -NetworkManager created) bridge, this MAC address must match. -

+

The “mac-address” property

+
  “mac-address”              gchar *
+

+

Flags: Read / Write

Default value: NULL


-

The "max-age" property

-
  "max-age"                  guint                 : Read / Write / Construct
-

-The Spanning Tree Protocol (STP) maximum message age, in seconds. -

+

The “max-age” property

+
  “max-age”                  guint
+

+

Flags: Read / Write / Construct

Allowed values: <= 40

Default value: 20


-

The "priority" property

-
  "priority"                 guint                 : Read / Write / Construct
-

-Sets the Spanning Tree Protocol (STP) priority for this bridge. Lower -values are "better"; the lowest priority bridge will be elected the root -bridge. -

+

The “priority” property

+
  “priority”                 guint
+

+

Flags: Read / Write / Construct

Allowed values: <= 65535

Default value: 32768


-

The "stp" property

-
  "stp"                      gboolean              : Read / Write / Construct
-

-Controls whether Spanning Tree Protocol (STP) is enabled for this bridge. -

+

The “stp” property

+
  “stp”                      gboolean
+

+

Flags: Read / Write / Construct

Default value: TRUE

+ Generated by GTK-Doc V1.21 \ No newline at end of file diff --git a/docs/libnm/html/NMSettingBridgePort.html b/docs/libnm/html/NMSettingBridgePort.html index b6e0035f..c2c4f18b 100644 --- a/docs/libnm/html/NMSettingBridgePort.html +++ b/docs/libnm/html/NMSettingBridgePort.html @@ -2,34 +2,28 @@ -NMSettingBridgePort +libnm Reference Manual: NMSettingBridgePort - + - - - - - - - - - - + + + + + + +
@@ -37,49 +31,212 @@

NMSettingBridgePort

NMSettingBridgePort — Describes connection properties for bridge ports

- +
-
-

Object Hierarchy

-
-  GObject
-   +----NMSetting
-         +----NMSettingBridgePort
-
+

Functions

+
++++ + + + + + + + + + + + + + + + + + + +
+NMSetting * + +nm_setting_bridge_port_new () +
+guint16 + +nm_setting_bridge_port_get_priority () +
+guint16 + +nm_setting_bridge_port_get_path_cost () +
+gboolean + +nm_setting_bridge_port_get_hairpin_mode () +

Properties

-
-  "hairpin-mode"             gboolean              : Read / Write
-  "path-cost"                guint                 : Read / Write / Construct
-  "priority"                 guint                 : Read / Write / Construct
+
+++++ + + + + + + + + + + + + + + + + + +
gbooleanhairpin-modeRead / Write
guintpath-costRead / Write / Construct
guintpriorityRead / Write / Construct
+
+
+

Types and Values

+ +
+
+

Object Hierarchy

+
    GObject
+    ╰── NMSetting
+        ╰── NMSettingBridgePort
 

Description

-

-The NMSettingBridgePort object is a NMSetting subclass that describes -optional properties that apply to bridge ports. -

+

The NMSettingBridgePort object is a NMSetting subclass that describes +optional properties that apply to bridge ports.

+
+
+

Functions

+
+

nm_setting_bridge_port_new ()

+
NMSetting *
+nm_setting_bridge_port_new (void);
+

Creates a new NMSettingBridgePort object with default values.

+
+

Returns

+

the new empty NMSettingBridgePort object.

+

[transfer full]

+
+
+
+
+

nm_setting_bridge_port_get_priority ()

+
guint16
+nm_setting_bridge_port_get_priority (NMSettingBridgePort *setting);
+
+

Parameters

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

setting

the NMSettingBridgePort

 
+
+
+

Returns

+

the “priority” property of the setting

+

+
+
+
+
+

nm_setting_bridge_port_get_path_cost ()

+
guint16
+nm_setting_bridge_port_get_path_cost (NMSettingBridgePort *setting);
+
+

Parameters

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

setting

the NMSettingBridgePort

 
+
+
+

Returns

+

the “path-cost” property of the setting

+

+
+
+
+
+

nm_setting_bridge_port_get_hairpin_mode ()

+
gboolean
+nm_setting_bridge_port_get_hairpin_mode
+                               (NMSettingBridgePort *setting);
+
+

Parameters

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

setting

the NMSettingBridgePort

 
+
+
+

Returns

+

the “hairpin-mode” property of the setting

+

+
+
-

Details

+

Types and Values

NM_SETTING_BRIDGE_PORT_SETTING_NAME

#define NM_SETTING_BRIDGE_PORT_SETTING_NAME "bridge-port"
@@ -111,140 +268,31 @@ optional properties that apply to bridge ports.
 

-
-
-

struct NMSettingBridgePort

-
struct NMSettingBridgePort;
-

-

-
-
-
-

NMSettingBridgePortClass

-
typedef struct {
-	NMSettingClass parent;
-} NMSettingBridgePortClass;
-
-

-

-
-
-
-

nm_setting_bridge_port_new ()

-
NMSetting *         nm_setting_bridge_port_new          (void);
-

-Creates a new NMSettingBridgePort object with default values. -

-
---- - - - - -

Returns :

the new empty NMSettingBridgePort object. [transfer full] -
-
-
-
-

nm_setting_bridge_port_get_priority ()

-
guint16             nm_setting_bridge_port_get_priority (NMSettingBridgePort *setting);
-
---- - - - - - - - - - - -

setting :

the NMSettingBridgePort -

Returns :

the "priority" property of the setting
-
-
-
-

nm_setting_bridge_port_get_path_cost ()

-
guint16             nm_setting_bridge_port_get_path_cost
-                                                        (NMSettingBridgePort *setting);
-
---- - - - - - - - - - - -

setting :

the NMSettingBridgePort -

Returns :

the "path-cost" property of the setting
-
-
-
-

nm_setting_bridge_port_get_hairpin_mode ()

-
gboolean            nm_setting_bridge_port_get_hairpin_mode
-                                                        (NMSettingBridgePort *setting);
-
---- - - - - - - - - - - -

setting :

the NMSettingBridgePort -

Returns :

the "hairpin-mode" property of the setting
-

Property Details

-

The "hairpin-mode" property

-
  "hairpin-mode"             gboolean              : Read / Write
-

-Enables or disabled "hairpin mode" for the port, which allows frames to -be sent back out through the port the frame was received on. -

+

The “hairpin-mode” property

+
  “hairpin-mode”             gboolean
+

+

Flags: Read / Write

Default value: FALSE


-

The "path-cost" property

-
  "path-cost"                guint                 : Read / Write / Construct
-

-The Spanning Tree Protocol (STP) port cost for destinations via this -port. -

+

The “path-cost” property

+
  “path-cost”                guint
+

+

Flags: Read / Write / Construct

Allowed values: <= 65535

Default value: 100


-

The "priority" property

-
  "priority"                 guint                 : Read / Write / Construct
-

-The Spanning Tree Protocol (STP) priority of this bridge port. -

+

The “priority” property

+
  “priority”                 guint
+

+

Flags: Read / Write / Construct

Allowed values: <= 63

Default value: 32

@@ -252,6 +300,6 @@ The Spanning Tree Protocol (STP) priority of this bridge port.
+ Generated by GTK-Doc V1.21
\ No newline at end of file diff --git a/docs/libnm/html/NMSettingCdma.html b/docs/libnm/html/NMSettingCdma.html index 653c020b..23dd4122 100644 --- a/docs/libnm/html/NMSettingCdma.html +++ b/docs/libnm/html/NMSettingCdma.html @@ -2,34 +2,28 @@ -NMSettingCdma +libnm Reference Manual: NMSettingCdma - + - - - - - - - - - - + + + + + + +
@@ -37,51 +31,255 @@

NMSettingCdma

NMSettingCdma — Describes CDMA-based mobile broadband properties

- +
-
-

Object Hierarchy

-
-  GObject
-   +----NMSetting
-         +----NMSettingCdma
-
+

Functions

+
++++ + + + + + + + + + + + + + + + + + + + + + + +
+NMSetting * + +nm_setting_cdma_new () +
const char * + +nm_setting_cdma_get_number () +
const char * + +nm_setting_cdma_get_username () +
const char * + +nm_setting_cdma_get_password () +
+NMSettingSecretFlags + +nm_setting_cdma_get_password_flags () +

Properties

-
-  "number"                   gchar*                : Read / Write
-  "password"                 gchar*                : Read / Write
-  "password-flags"           NMSettingSecretFlags  : Read / Write
-  "username"                 gchar*                : Read / Write
+
+++++ + + + + + + + + + + + + + + + + + + + + + + +
+gchar *numberRead / Write
+gchar *passwordRead / Write
NMSettingSecretFlagspassword-flagsRead / Write
+gchar *usernameRead / Write
+
+
+

Types and Values

+
++++ + + + + + + + + + + + + + + + + + + + + + + +
#defineNM_SETTING_CDMA_SETTING_NAME
#defineNM_SETTING_CDMA_NUMBER
#defineNM_SETTING_CDMA_USERNAME
#defineNM_SETTING_CDMA_PASSWORD
#defineNM_SETTING_CDMA_PASSWORD_FLAGS
+
+
+

Object Hierarchy

+
    GObject
+    ╰── NMSetting
+        ╰── NMSettingCdma
 

Description

-

-The NMSettingCdma object is a NMSetting subclass that describes +

The NMSettingCdma object is a NMSetting subclass that describes properties that allow connections to IS-95-based mobile broadband -networks, including those using CDMA2000/EVDO technology. -

+networks, including those using CDMA2000/EVDO technology.

-

Details

+

Functions

+
+

nm_setting_cdma_new ()

+
NMSetting *
+nm_setting_cdma_new (void);
+

Creates a new NMSettingCdma object with default values.

+
+

Returns

+

the new empty NMSettingCdma object

+

+
+
+
+
+

nm_setting_cdma_get_number ()

+
const char *
+nm_setting_cdma_get_number (NMSettingCdma *setting);
+
+

Parameters

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

setting

the NMSettingCdma

 
+
+
+

Returns

+

the “number” property of the setting

+

+
+
+
+
+

nm_setting_cdma_get_username ()

+
const char *
+nm_setting_cdma_get_username (NMSettingCdma *setting);
+
+

Parameters

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

setting

the NMSettingCdma

 
+
+
+

Returns

+

the “username” property of the setting

+

+
+
+
+
+

nm_setting_cdma_get_password ()

+
const char *
+nm_setting_cdma_get_password (NMSettingCdma *setting);
+
+

Parameters

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

setting

the NMSettingCdma

 
+
+
+

Returns

+

the “password” property of the setting

+

+
+
+
+
+

nm_setting_cdma_get_password_flags ()

+
NMSettingSecretFlags
+nm_setting_cdma_get_password_flags (NMSettingCdma *setting);
+
+

Parameters

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

setting

the NMSettingCdma

 
+
+
+

Returns

+

the NMSettingSecretFlags pertaining to the “password”

+

+
+
+
+
+

Types and Values

NM_SETTING_CDMA_SETTING_NAME

#define NM_SETTING_CDMA_SETTING_NAME "cdma"
@@ -121,177 +319,43 @@ networks, including those using CDMA2000/EVDO technology.
 

-
-
-

struct NMSettingCdma

-
struct NMSettingCdma;
-

-

-
-
-
-

NMSettingCdmaClass

-
typedef struct {
-	NMSettingClass parent;
-} NMSettingCdmaClass;
-
-

-

-
-
-
-

nm_setting_cdma_new ()

-
NMSetting *         nm_setting_cdma_new                 (void);
-

-Creates a new NMSettingCdma object with default values. -

-
---- - - - - -

Returns :

the new empty NMSettingCdma object
-
-
-
-

nm_setting_cdma_get_number ()

-
const char *        nm_setting_cdma_get_number          (NMSettingCdma *setting);
-
---- - - - - - - - - - - -

setting :

the NMSettingCdma -

Returns :

the "number" property of the setting
-
-
-
-

nm_setting_cdma_get_username ()

-
const char *        nm_setting_cdma_get_username        (NMSettingCdma *setting);
-
---- - - - - - - - - - - -

setting :

the NMSettingCdma -

Returns :

the "username" property of the setting
-
-
-
-

nm_setting_cdma_get_password ()

-
const char *        nm_setting_cdma_get_password        (NMSettingCdma *setting);
-
---- - - - - - - - - - - -

setting :

the NMSettingCdma -

Returns :

the "password" property of the setting
-
-
-
-

nm_setting_cdma_get_password_flags ()

-
NMSettingSecretFlags nm_setting_cdma_get_password_flags (NMSettingCdma *setting);
-
---- - - - - - - - - - - -

setting :

the NMSettingCdma -

Returns :

the NMSettingSecretFlags pertaining to the "password" -
-

Property Details

-

The "number" property

-
  "number"                   gchar*                : Read / Write
-

-The number to dial to establish the connection to the CDMA-based mobile -broadband network, if any. If not specified, the default number (777) -is used when required. -

+

The “number” property

+
  “number”                   gchar *
+

+

Flags: Read / Write

Default value: NULL


-

The "password" property

-
  "password"                 gchar*                : Read / Write
-

-The password used to authenticate with the network, if required. Many -providers do not require a password, or accept any password. But if a -password is required, it is specified here. -

+

The “password” property

+
  “password”                 gchar *
+

+

Flags: Read / Write

Default value: NULL


-

The "password-flags" property

-
  "password-flags"           NMSettingSecretFlags  : Read / Write
-

-Flags indicating how to handle the "password" property. -

+

The “password-flags” property

+
  “password-flags”           NMSettingSecretFlags
+

+

Flags: Read / Write


-

The "username" property

-
  "username"                 gchar*                : Read / Write
-

-The username used to authenticate with the network, if required. Many -providers do not require a username, or accept any username. But if a -username is required, it is specified here. -

+

The “username” property

+
  “username”                 gchar *
+

+

Flags: Read / Write

Default value: NULL

+ Generated by GTK-Doc V1.21 \ No newline at end of file diff --git a/docs/libnm/html/NMSettingConnection.html b/docs/libnm/html/NMSettingConnection.html index 2ebace0b..ebb16ae9 100644 --- a/docs/libnm/html/NMSettingConnection.html +++ b/docs/libnm/html/NMSettingConnection.html @@ -2,34 +2,28 @@ -NMSettingConnection +libnm Reference Manual: NMSettingConnection - + - - - - - - - - - - + + + + + + +
@@ -37,1210 +31,1533 @@

NMSettingConnection

NMSettingConnection — Describes general connection properties

- +
-
-

Synopsis

-
#define             NM_SETTING_CONNECTION_SETTING_NAME
-#define             NM_SETTING_CONNECTION_AUTOCONNECT_PRIORITY_MIN
-#define             NM_SETTING_CONNECTION_AUTOCONNECT_PRIORITY_MAX
-#define             NM_SETTING_CONNECTION_AUTOCONNECT_PRIORITY_DEFAULT
-#define             NM_SETTING_CONNECTION_ID
-#define             NM_SETTING_CONNECTION_UUID
-#define             NM_SETTING_CONNECTION_INTERFACE_NAME
-#define             NM_SETTING_CONNECTION_TYPE
-#define             NM_SETTING_CONNECTION_AUTOCONNECT
-#define             NM_SETTING_CONNECTION_AUTOCONNECT_PRIORITY
-#define             NM_SETTING_CONNECTION_TIMESTAMP
-#define             NM_SETTING_CONNECTION_READ_ONLY
-#define             NM_SETTING_CONNECTION_PERMISSIONS
-#define             NM_SETTING_CONNECTION_ZONE
-#define             NM_SETTING_CONNECTION_MASTER
-#define             NM_SETTING_CONNECTION_SLAVE_TYPE
-#define             NM_SETTING_CONNECTION_SECONDARIES
-#define             NM_SETTING_CONNECTION_GATEWAY_PING_TIMEOUT
-struct              NMSettingConnection;
-                    NMSettingConnectionClass;
-NMSetting *         nm_setting_connection_new           (void);
-const char *        nm_setting_connection_get_id        (NMSettingConnection *setting);
-const char *        nm_setting_connection_get_uuid      (NMSettingConnection *setting);
-const char *        nm_setting_connection_get_interface_name
-                                                        (NMSettingConnection *setting);
-const char *        nm_setting_connection_get_connection_type
-                                                        (NMSettingConnection *setting);
-gboolean            nm_setting_connection_get_autoconnect
-                                                        (NMSettingConnection *setting);
-gint                nm_setting_connection_get_autoconnect_priority
-                                                        (NMSettingConnection *setting);
-guint64             nm_setting_connection_get_timestamp (NMSettingConnection *setting);
-gboolean            nm_setting_connection_get_read_only (NMSettingConnection *setting);
-guint32             nm_setting_connection_get_num_permissions
-                                                        (NMSettingConnection *setting);
-gboolean            nm_setting_connection_get_permission
-                                                        (NMSettingConnection *setting,
-                                                         guint32 idx,
-                                                         const char **out_ptype,
-                                                         const char **out_pitem,
-                                                         const char **out_detail);
-const char *        nm_setting_connection_get_zone      (NMSettingConnection *setting);
-gboolean            nm_setting_connection_permissions_user_allowed
-                                                        (NMSettingConnection *setting,
-                                                         const char *uname);
-gboolean            nm_setting_connection_add_permission
-                                                        (NMSettingConnection *setting,
-                                                         const char *ptype,
-                                                         const char *pitem,
-                                                         const char *detail);
-void                nm_setting_connection_remove_permission
-                                                        (NMSettingConnection *setting,
-                                                         guint32 idx);
-gboolean            nm_setting_connection_remove_permission_by_value
-                                                        (NMSettingConnection *setting,
-                                                         const char *ptype,
-                                                         const char *pitem,
-                                                         const char *detail);
-const char *        nm_setting_connection_get_master    (NMSettingConnection *setting);
-gboolean            nm_setting_connection_is_slave_type (NMSettingConnection *setting,
-                                                         const char *type);
-const char *        nm_setting_connection_get_slave_type
-                                                        (NMSettingConnection *setting);
-guint32             nm_setting_connection_get_num_secondaries
-                                                        (NMSettingConnection *setting);
-const char *        nm_setting_connection_get_secondary (NMSettingConnection *setting,
-                                                         guint32 idx);
-gboolean            nm_setting_connection_add_secondary (NMSettingConnection *setting,
-                                                         const char *sec_uuid);
-void                nm_setting_connection_remove_secondary
-                                                        (NMSettingConnection *setting,
-                                                         guint32 idx);
-gboolean            nm_setting_connection_remove_secondary_by_value
-                                                        (NMSettingConnection *setting,
-                                                         const char *sec_uuid);
-guint32             nm_setting_connection_get_gateway_ping_timeout
-                                                        (NMSettingConnection *setting);
-
-
-
-

Object Hierarchy

-
-  GObject
-   +----NMSetting
-         +----NMSettingConnection
-
-
-
-

Properties

-
-  "autoconnect"              gboolean              : Read / Write / Construct
-  "autoconnect-priority"     gint                  : Read / Write / Construct
-  "gateway-ping-timeout"     guint                 : Read / Write / Construct
-  "id"                       gchar*                : Read / Write
-  "interface-name"           gchar*                : Read / Write
-  "master"                   gchar*                : Read / Write
-  "permissions"              GStrv                 : Read / Write
-  "read-only"                gboolean              : Read / Write / Construct
-  "secondaries"              GStrv                 : Read / Write
-  "slave-type"               gchar*                : Read / Write
-  "timestamp"                guint64               : Read / Write / Construct
-  "type"                     gchar*                : Read / Write
-  "uuid"                     gchar*                : Read / Write
-  "zone"                     gchar*                : Read / Write / Construct
-
-
-
-

Description

-

-The NMSettingConnection object is a NMSetting subclass that describes -properties that apply to all NMConnection objects, regardless of what type -of network connection they describe. Each NMConnection object must contain -a NMSettingConnection setting. -

-
-

Details

-
-

NM_SETTING_CONNECTION_SETTING_NAME

-
#define NM_SETTING_CONNECTION_SETTING_NAME "connection"
-
-

-

-
-
-
-

NM_SETTING_CONNECTION_AUTOCONNECT_PRIORITY_MIN

-
#define NM_SETTING_CONNECTION_AUTOCONNECT_PRIORITY_MIN -999
-
-

-

-
-
-
-

NM_SETTING_CONNECTION_AUTOCONNECT_PRIORITY_MAX

-
#define NM_SETTING_CONNECTION_AUTOCONNECT_PRIORITY_MAX 999
-
-

-

-
-
-
-

NM_SETTING_CONNECTION_AUTOCONNECT_PRIORITY_DEFAULT

-
#define NM_SETTING_CONNECTION_AUTOCONNECT_PRIORITY_DEFAULT 0
-
-

-

-
-
-
-

NM_SETTING_CONNECTION_ID

-
#define NM_SETTING_CONNECTION_ID             "id"
-
-

-

-
-
-
-

NM_SETTING_CONNECTION_UUID

-
#define NM_SETTING_CONNECTION_UUID           "uuid"
-
-

-

-
-
-
-

NM_SETTING_CONNECTION_INTERFACE_NAME

-
#define NM_SETTING_CONNECTION_INTERFACE_NAME "interface-name"
-
-

-

-
-
-
-

NM_SETTING_CONNECTION_TYPE

-
#define NM_SETTING_CONNECTION_TYPE           "type"
-
-

-

-
-
-
-

NM_SETTING_CONNECTION_AUTOCONNECT

-
#define NM_SETTING_CONNECTION_AUTOCONNECT    "autoconnect"
-
-

-

-
-
-
-

NM_SETTING_CONNECTION_AUTOCONNECT_PRIORITY

-
#define NM_SETTING_CONNECTION_AUTOCONNECT_PRIORITY "autoconnect-priority"
-
-

-

-
-
-
-

NM_SETTING_CONNECTION_TIMESTAMP

-
#define NM_SETTING_CONNECTION_TIMESTAMP      "timestamp"
-
-

-

-
-
-
-

NM_SETTING_CONNECTION_READ_ONLY

-
#define NM_SETTING_CONNECTION_READ_ONLY      "read-only"
-
-

-

-
-
-
-

NM_SETTING_CONNECTION_PERMISSIONS

-
#define NM_SETTING_CONNECTION_PERMISSIONS    "permissions"
-
-

-

-
-
-
-

NM_SETTING_CONNECTION_ZONE

-
#define NM_SETTING_CONNECTION_ZONE           "zone"
-
-

-

-
-
-
-

NM_SETTING_CONNECTION_MASTER

-
#define NM_SETTING_CONNECTION_MASTER         "master"
-
-

-

-
-
-
-

NM_SETTING_CONNECTION_SLAVE_TYPE

-
#define NM_SETTING_CONNECTION_SLAVE_TYPE     "slave-type"
-
-

-

-
-
-
-

NM_SETTING_CONNECTION_SECONDARIES

-
#define NM_SETTING_CONNECTION_SECONDARIES    "secondaries"
-
-

-

-
-
-
-

NM_SETTING_CONNECTION_GATEWAY_PING_TIMEOUT

-
#define NM_SETTING_CONNECTION_GATEWAY_PING_TIMEOUT "gateway-ping-timeout"
-
-

-

-
-
-
-

struct NMSettingConnection

-
struct NMSettingConnection;
-

-The NMSettingConnection struct contains only private data. -It should only be accessed through the functions described below. -

-
-
-
-

NMSettingConnectionClass

-
typedef struct {
-	NMSettingClass parent;
-} NMSettingConnectionClass;
-
-

-

-
-
-
-

nm_setting_connection_new ()

-
NMSetting *         nm_setting_connection_new           (void);
-

-Creates a new NMSettingConnection object with default values. -

-
---- - - - - -

Returns :

the new empty NMSettingConnection object
-
-
-
-

nm_setting_connection_get_id ()

-
const char *        nm_setting_connection_get_id        (NMSettingConnection *setting);
-

-Returns the "id" property of the connection. -

-
+

Functions

+
--++ - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - - + +

setting :

the NMSettingConnection + +NMSetting * + +nm_setting_connection_new () +
const char * + +nm_setting_connection_get_id () +
const char * + +nm_setting_connection_get_uuid () +
const char * + +nm_setting_connection_get_interface_name () +
const char * + +nm_setting_connection_get_connection_type () +
+gboolean + +nm_setting_connection_get_autoconnect () +
+gint + +nm_setting_connection_get_autoconnect_priority () +
+guint64 + +nm_setting_connection_get_timestamp () +
+gboolean + +nm_setting_connection_get_read_only () +
+guint32 + +nm_setting_connection_get_num_permissions () +
+gboolean + +nm_setting_connection_get_permission () +
const char * + +nm_setting_connection_get_zone () +
+gboolean + +nm_setting_connection_permissions_user_allowed () +
+gboolean + +nm_setting_connection_add_permission () +
+void + +nm_setting_connection_remove_permission () +
+gboolean + +nm_setting_connection_remove_permission_by_value () +
const char * + +nm_setting_connection_get_master () +
+gboolean + +nm_setting_connection_is_slave_type () +
const char * + +nm_setting_connection_get_slave_type () +
+guint32 + +nm_setting_connection_get_num_secondaries () +
const char * + +nm_setting_connection_get_secondary () +
+gboolean + +nm_setting_connection_add_secondary () +
+void + +nm_setting_connection_remove_secondary () +
+gboolean + +nm_setting_connection_remove_secondary_by_value ()

Returns :

the connection ID +guint32 + +nm_setting_connection_get_gateway_ping_timeout () +
-
-
-

nm_setting_connection_get_uuid ()

-
const char *        nm_setting_connection_get_uuid      (NMSettingConnection *setting);
-

-Returns the "uuid" property of the connection. -

-
+
+

Properties

+
--+++ - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - - + + + + + + + + + + + + + + + + + + + + + + + + + + + +

setting :

the NMSettingConnection -gbooleanautoconnectRead / Write / Construct
gintautoconnect-priorityRead / Write / Construct
guintgateway-ping-timeoutRead / Write / Construct
+gchar *idRead / Write
+gchar *interface-nameRead / Write
+gchar *masterRead / Write
GStrvpermissionsRead / Write
gbooleanread-onlyRead / Write / Construct

Returns :

the connection UUIDGStrvsecondariesRead / Write
+gchar *slave-typeRead / Write
guint64timestampRead / Write / Construct
+gchar *typeRead / Write
+gchar *uuidRead / Write
+gchar *zoneRead / Write / Construct
-
-
-

nm_setting_connection_get_interface_name ()

-
const char *        nm_setting_connection_get_interface_name
-                                                        (NMSettingConnection *setting);
-

-Returns the "interface-name" property of the connection. -

-
+
+

Object Hierarchy

+
    GObject
+    ╰── NMSetting
+        ╰── NMSettingConnection
+
+
+
+

Description

+

The NMSettingConnection object is a NMSetting subclass that describes +properties that apply to all NMConnection objects, regardless of what type +of network connection they describe. Each NMConnection object must contain +a NMSettingConnection setting.

+
+
+

Functions

+
+

nm_setting_connection_new ()

+
NMSetting *
+nm_setting_connection_new (void);
+

Creates a new NMSettingConnection object with default values.

+
+

Returns

+

the new empty NMSettingConnection object

+

+
+

-

nm_setting_connection_get_connection_type ()

-
const char *        nm_setting_connection_get_connection_type
-                                                        (NMSettingConnection *setting);
-

-Returns the "type" property of the connection. -

-
+

nm_setting_connection_get_id ()

+
const char *
+nm_setting_connection_get_id (NMSettingConnection *setting);
+

Returns the “id” property of the connection.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSettingConnection -

Returns :

the connection type

setting

the NMSettingConnection

 
+
+

Returns

+

the connection ID

+

+
+

-

nm_setting_connection_get_autoconnect ()

-
gboolean            nm_setting_connection_get_autoconnect
-                                                        (NMSettingConnection *setting);
-

-Returns the "autoconnect" property of the connection. -

-
+

nm_setting_connection_get_uuid ()

+
const char *
+nm_setting_connection_get_uuid (NMSettingConnection *setting);
+

Returns the “uuid” property of the connection.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSettingConnection -

Returns :

the connection's autoconnect behavior

setting

the NMSettingConnection

 
+
+

Returns

+

the connection UUID

+

+
+

-

nm_setting_connection_get_autoconnect_priority ()

-
gint                nm_setting_connection_get_autoconnect_priority
-                                                        (NMSettingConnection *setting);
-

-Returns the "autoconnect-priority" property of the connection. -The higher number, the higher priority. -

-
+

nm_setting_connection_get_interface_name ()

+
const char *
+nm_setting_connection_get_interface_name
+                               (NMSettingConnection *setting);
+

Returns the “interface-name” property of the connection.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSettingConnection -

Returns :

the connection's autoconnect priority

setting

the NMSettingConnection

 
+
+

Returns

+

the connection's interface name

+

+
+

-

nm_setting_connection_get_timestamp ()

-
guint64             nm_setting_connection_get_timestamp (NMSettingConnection *setting);
-

-Returns the "timestamp" property of the connection. -

-
+

nm_setting_connection_get_connection_type ()

+
const char *
+nm_setting_connection_get_connection_type
+                               (NMSettingConnection *setting);
+

Returns the “type” property of the connection.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSettingConnection -

Returns :

the connection's timestamp

setting

the NMSettingConnection

 
+
+

Returns

+

the connection type

+

+
+
-

nm_setting_connection_get_read_only ()

-
gboolean            nm_setting_connection_get_read_only (NMSettingConnection *setting);
-

-Returns the "read-only" property of the connection. -

-
+

nm_setting_connection_get_autoconnect ()

+
gboolean
+nm_setting_connection_get_autoconnect (NMSettingConnection *setting);
+

Returns the “autoconnect” property of the connection.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSettingConnection -

Returns :

-TRUE if the connection is read-only, FALSE if it is not

setting

the NMSettingConnection

 
+
+

Returns

+

the connection's autoconnect behavior

+

+
+
-

nm_setting_connection_get_num_permissions ()

-
guint32             nm_setting_connection_get_num_permissions
-                                                        (NMSettingConnection *setting);
-

-Returns the number of entires in the "permissions" -property of this setting. -

-
+

nm_setting_connection_get_autoconnect_priority ()

+
gint
+nm_setting_connection_get_autoconnect_priority
+                               (NMSettingConnection *setting);
+

Returns the “autoconnect-priority” property of the connection. +The higher number, the higher priority.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSettingConnection -

Returns :

the number of permissions entires

setting

the NMSettingConnection

 
+
+

Returns

+

the connection's autoconnect priority

+

+
+
-

nm_setting_connection_get_permission ()

-
gboolean            nm_setting_connection_get_permission
-                                                        (NMSettingConnection *setting,
-                                                         guint32 idx,
-                                                         const char **out_ptype,
-                                                         const char **out_pitem,
-                                                         const char **out_detail);
-

-Retrieve one of the entries of the "permissions" property -of this setting. -

-
+

nm_setting_connection_get_timestamp ()

+
guint64
+nm_setting_connection_get_timestamp (NMSettingConnection *setting);
+

Returns the “timestamp” property of the connection.

+
+

Parameters

+
--+++ - - - - - - - - - - - - - - - - - - - - - - - - - - + + + + +

setting :

the NMSettingConnection -

idx :

the zero-based index of the permissions entry

out_ptype :

on return, the permission type (at this time, always "user")

out_pitem :

on return, the permission item (formatted accoring to ptype, see -"permissions" for more detail

out_detail :

on return, the permission detail (at this time, always NULL)

Returns :

-TRUE if a permission was returned, FALSE if idx was invalid

setting

the NMSettingConnection

 
+
+

Returns

+

the connection's timestamp

+

+
+
-

nm_setting_connection_get_zone ()

-
const char *        nm_setting_connection_get_zone      (NMSettingConnection *setting);
-

-Returns the "zone" property of the connection. -

-
+

nm_setting_connection_get_read_only ()

+
gboolean
+nm_setting_connection_get_read_only (NMSettingConnection *setting);
+

Returns the “read-only” property of the connection.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSettingConnection -

Returns :

the trust level of a connection

setting

the NMSettingConnection

 
+
+

Returns

+

TRUE if the connection is read-only, FALSE if it is not

+

+
+
-

nm_setting_connection_permissions_user_allowed ()

-
gboolean            nm_setting_connection_permissions_user_allowed
-                                                        (NMSettingConnection *setting,
-                                                         const char *uname);
-

-Checks whether the given username is allowed to view/access this connection. -

-
+

nm_setting_connection_get_num_permissions ()

+
guint32
+nm_setting_connection_get_num_permissions
+                               (NMSettingConnection *setting);
+

Returns the number of entires in the “permissions” +property of this setting.

+
+

Parameters

+
--+++ - - - - - - - - - - - - - - + + + + +

setting :

the NMSettingConnection -

uname :

the user name to check permissions for

Returns :

-TRUE if the requested user is allowed to view this connection, -FALSE if the given user is not allowed to view this connection

setting

the NMSettingConnection

 
+
+

Returns

+

the number of permissions entires

+

+
+
-

nm_setting_connection_add_permission ()

-
gboolean            nm_setting_connection_add_permission
-                                                        (NMSettingConnection *setting,
-                                                         const char *ptype,
-                                                         const char *pitem,
-                                                         const char *detail);
-

-Adds a permission to the connection's permission list. At this time, only -the "user" permission type is supported, and pitem must be a username. See -"permissions": for more details. -

-
+

nm_setting_connection_get_permission ()

+
gboolean
+nm_setting_connection_get_permission (NMSettingConnection *setting,
+                                      guint32 idx,
+                                      const char **out_ptype,
+                                      const char **out_pitem,
+                                      const char **out_detail);
+

Retrieve one of the entries of the “permissions” property +of this setting.

+
+

Parameters

+
--+++ - - + + + - - + + + - - + + + - - + + + - - + + +

setting :

the NMSettingConnection -

setting

the NMSettingConnection

 

ptype :

the permission type; at this time only "user" is supported

idx

the zero-based index of the permissions entry

 

pitem :

the permission item formatted as required for ptype -

out_ptype

on return, the permission type (at this time, always "user")

 

detail :

unused at this time; must be NULL. [allow-none] -

out_pitem

on return, the permission item (formatted accoring to ptype +, see +“permissions” for more detail

 

Returns :

-TRUE if the permission was unique and was successfully added to the -list, FALSE if ptype or pitem was invalid or it the permission was already -present in the list

out_detail

on return, the permission detail (at this time, always NULL)

 
+
+

Returns

+

TRUE if a permission was returned, FALSE if idx +was invalid

+

+
+
-

nm_setting_connection_remove_permission ()

-
void                nm_setting_connection_remove_permission
-                                                        (NMSettingConnection *setting,
-                                                         guint32 idx);
-

-Removes the permission at index idx from the connection. -

-
+

nm_setting_connection_get_zone ()

+
const char *
+nm_setting_connection_get_zone (NMSettingConnection *setting);
+

Returns the “zone” property of the connection.

+
+

Parameters

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

setting

the NMSettingConnection

 
+
+
+

Returns

+

the trust level of a connection

+

+
+ +
+
+

nm_setting_connection_permissions_user_allowed ()

+
gboolean
+nm_setting_connection_permissions_user_allowed
+                               (NMSettingConnection *setting,
+                                const char *uname);
+

Checks whether the given username is allowed to view/access this connection.

+
+

Parameters

+
--+++ - - + + + - - + + +

setting :

the NMSettingConnection -

setting

the NMSettingConnection

 

idx :

the zero-based index of the permission to remove

uname

the user name to check permissions for

 
+
+

Returns

+

TRUE if the requested user is allowed to view this connection, +FALSE if the given user is not allowed to view this connection

+

+
+

-

nm_setting_connection_remove_permission_by_value ()

-
gboolean            nm_setting_connection_remove_permission_by_value
-                                                        (NMSettingConnection *setting,
-                                                         const char *ptype,
-                                                         const char *pitem,
-                                                         const char *detail);
-

-Removes the permission from the connection. -At this time, only the "user" permission type is supported, and pitem must -be a username. See "permissions": for more details. -

-
+

nm_setting_connection_add_permission ()

+
gboolean
+nm_setting_connection_add_permission (NMSettingConnection *setting,
+                                      const char *ptype,
+                                      const char *pitem,
+                                      const char *detail);
+

Adds a permission to the connection's permission list. At this time, only +the "user" permission type is supported, and pitem + must be a username. See +“permissions”: for more details.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + + - - + + + - - + + +

setting :

the NMSettingConnection -

ptype :

the permission type; at this time only "user" is supported

setting

the NMSettingConnection

 

pitem :

the permission item formatted as required for ptype -

ptype

the permission type; at this time only "user" is supported

 

detail :

unused at this time; must be NULL. [allow-none] -

pitem

the permission item formatted as required for ptype +

 

Returns :

-TRUE if the permission was found and removed; FALSE if it was not.

detail

unused at this time; must be NULL.

[allow-none]
+
+

Returns

+

TRUE if the permission was unique and was successfully added to the +list, FALSE if ptype +or pitem +was invalid or it the permission was already +present in the list

+

+
+
-

nm_setting_connection_get_master ()

-
const char *        nm_setting_connection_get_master    (NMSettingConnection *setting);
-

-Returns the "master" property of the connection. -

-
+

nm_setting_connection_remove_permission ()

+
void
+nm_setting_connection_remove_permission
+                               (NMSettingConnection *setting,
+                                guint32 idx);
+

Removes the permission at index idx + from the connection.

+
+

Parameters

+
--+++ - - + + + - - + + +

setting :

the NMSettingConnection -

setting

the NMSettingConnection

 

Returns :

interface name of the master device or UUID of the master -connection.

idx

the zero-based index of the permission to remove

 
+
-

nm_setting_connection_is_slave_type ()

-
gboolean            nm_setting_connection_is_slave_type (NMSettingConnection *setting,
-                                                         const char *type);
-
+

nm_setting_connection_remove_permission_by_value ()

+
gboolean
+nm_setting_connection_remove_permission_by_value
+                               (NMSettingConnection *setting,
+                                const char *ptype,
+                                const char *pitem,
+                                const char *detail);
+

Removes the permission from the connection. +At this time, only the "user" permission type is supported, and pitem + must +be a username. See “permissions”: for more details.

+
+

Parameters

+
--+++ - - + + + - - + + + - - + + + + + + + +

setting :

the NMSettingConnection -

setting

the NMSettingConnection

 

type :

the setting name (ie NM_SETTING_BOND_SETTING_NAME) to be matched -against setting's slave type

ptype

the permission type; at this time only "user" is supported

 

Returns :

-TRUE if connection is of the given slave type -

pitem

the permission item formatted as required for ptype +

 

detail

unused at this time; must be NULL.

[allow-none]
+
+

Returns

+

TRUE if the permission was found and removed; FALSE if it was not.

+

+
+
-

nm_setting_connection_get_slave_type ()

-
const char *        nm_setting_connection_get_slave_type
-                                                        (NMSettingConnection *setting);
-

-Returns the "slave-type" property of the connection. -

-
+

nm_setting_connection_get_master ()

+
const char *
+nm_setting_connection_get_master (NMSettingConnection *setting);
+

Returns the “master” property of the connection.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSettingConnection -

Returns :

the type of slave this connection is, if any

setting

the NMSettingConnection

 
+
+

Returns

+

interface name of the master device or UUID of the master +connection.

+

+
+
-

nm_setting_connection_get_num_secondaries ()

-
guint32             nm_setting_connection_get_num_secondaries
-                                                        (NMSettingConnection *setting);
-
+

nm_setting_connection_is_slave_type ()

+
gboolean
+nm_setting_connection_is_slave_type (NMSettingConnection *setting,
+                                     const char *type);
+
+

Parameters

+
--+++ - - + + + - - + + +

setting :

the NMSettingConnection -

setting

the NMSettingConnection

 

Returns :

the number of configured secondary connection UUIDs

type

the setting name (ie NM_SETTING_BOND_SETTING_NAME) to be matched +against setting +'s slave type

 
+
+

Returns

+

TRUE if connection is of the given slave type +

+

+
+
-

nm_setting_connection_get_secondary ()

-
const char *        nm_setting_connection_get_secondary (NMSettingConnection *setting,
-                                                         guint32 idx);
-
+

nm_setting_connection_get_slave_type ()

+
const char *
+nm_setting_connection_get_slave_type (NMSettingConnection *setting);
+

Returns the “slave-type” property of the connection.

+
+

Parameters

+
--+++ - - - - - - - - - - - - - - + + + + +

setting :

the NMSettingConnection -

idx :

the zero-based index of the secondary connection UUID entry

Returns :

the secondary connection UUID at index idx -

setting

the NMSettingConnection

 
+
+

Returns

+

the type of slave this connection is, if any

+

+
+
-

nm_setting_connection_add_secondary ()

-
gboolean            nm_setting_connection_add_secondary (NMSettingConnection *setting,
-                                                         const char *sec_uuid);
-

-Adds a new secondary connetion UUID to the setting. -

-
+

nm_setting_connection_get_num_secondaries ()

+
guint32
+nm_setting_connection_get_num_secondaries
+                               (NMSettingConnection *setting);
+
+

Parameters

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

setting

the NMSettingConnection

 
+
+
+

Returns

+

the number of configured secondary connection UUIDs

+

+
+ +
+
+

nm_setting_connection_get_secondary ()

+
const char *
+nm_setting_connection_get_secondary (NMSettingConnection *setting,
+                                     guint32 idx);
+
+

Parameters

+
--+++ - - - - - - + + + - - + + +

setting :

the NMSettingConnection -

sec_uuid :

the secondary connection UUID to add

setting

the NMSettingConnection

 

Returns :

-TRUE if the secondary connection UUID was added; FALSE if the UUID -was already present

idx

the zero-based index of the secondary connection UUID entry

 
+
+

Returns

+

the secondary connection UUID at index idx +

+

+
+

-

nm_setting_connection_remove_secondary ()

-
void                nm_setting_connection_remove_secondary
-                                                        (NMSettingConnection *setting,
-                                                         guint32 idx);
-

-Removes the secondary coonnection UUID at index idx. -

-
+

nm_setting_connection_add_secondary ()

+
gboolean
+nm_setting_connection_add_secondary (NMSettingConnection *setting,
+                                     const char *sec_uuid);
+

Adds a new secondary connetion UUID to the setting.

+
+

Parameters

+
--+++ - - + + + - - + + +

setting :

the NMSettingConnection -

setting

the NMSettingConnection

 

idx :

index number of the secondary connection UUID

sec_uuid

the secondary connection UUID to add

 
+
+

Returns

+

TRUE if the secondary connection UUID was added; FALSE if the UUID +was already present

+

+
+
-

nm_setting_connection_remove_secondary_by_value ()

-
gboolean            nm_setting_connection_remove_secondary_by_value
-                                                        (NMSettingConnection *setting,
-                                                         const char *sec_uuid);
-

-Removes the secondary coonnection UUID sec_uuid. -

-
+

nm_setting_connection_remove_secondary ()

+
void
+nm_setting_connection_remove_secondary
+                               (NMSettingConnection *setting,
+                                guint32 idx);
+

Removes the secondary coonnection UUID at index idx +.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + +

setting :

the NMSettingConnection -

sec_uuid :

the secondary connection UUID to remove

setting

the NMSettingConnection

 

Returns :

-TRUE if the secondary connection UUID was found and removed; FALSE if it was not.

idx

index number of the secondary connection UUID

 
+
-

nm_setting_connection_get_gateway_ping_timeout ()

-
guint32             nm_setting_connection_get_gateway_ping_timeout
-                                                        (NMSettingConnection *setting);
-
+

nm_setting_connection_remove_secondary_by_value ()

+
gboolean
+nm_setting_connection_remove_secondary_by_value
+                               (NMSettingConnection *setting,
+                                const char *sec_uuid);
+

Removes the secondary coonnection UUID sec_uuid +.

+
+

Parameters

+
--+++ - - + + + - - + + +

setting :

the NMSettingConnection -

setting

the NMSettingConnection

 

Returns :

the value contained in the "gateway-ping-timeout" -property.

sec_uuid

the secondary connection UUID to remove

 
+
+

Returns

+

TRUE if the secondary connection UUID was found and removed; FALSE if it was not.

+

+
+ +
+
+

nm_setting_connection_get_gateway_ping_timeout ()

+
guint32
+nm_setting_connection_get_gateway_ping_timeout
+                               (NMSettingConnection *setting);
+
+

Parameters

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

setting

the NMSettingConnection

 
+
+
+

Returns

+

the value contained in the “gateway-ping-timeout” +property.

+

+
+
-

Property Details

+

Types and Values

-

The "autoconnect" property

-
  "autoconnect"              gboolean              : Read / Write / Construct
+

NM_SETTING_CONNECTION_SETTING_NAME

+
#define NM_SETTING_CONNECTION_SETTING_NAME "connection"
+

-Whether or not the connection should be automatically connected by -NetworkManager when the resources for the connection are available. -TRUE to automatically activate the connection, FALSE to require manual -intervention to activate the connection.

-

Default value: TRUE


-

The "autoconnect-priority" property

-
  "autoconnect-priority"     gint                  : Read / Write / Construct
+

NM_SETTING_CONNECTION_AUTOCONNECT_PRIORITY_MIN

+
#define NM_SETTING_CONNECTION_AUTOCONNECT_PRIORITY_MIN -999
+

-The autoconnect priority. If the connection is set to autoconnect, -connections with higher priority will be preferred. Defaults to 0. -The higher number means higher priority.

-

Allowed values: [-999,999]

-

Default value: 0


-

The "gateway-ping-timeout" property

-
  "gateway-ping-timeout"     guint                 : Read / Write / Construct
+

NM_SETTING_CONNECTION_AUTOCONNECT_PRIORITY_MAX

+
#define NM_SETTING_CONNECTION_AUTOCONNECT_PRIORITY_MAX 999
+

-If greater than zero, delay success of IP addressing until either the -timeout is reached, or an IP gateway replies to a ping.

-

Allowed values: <= 30

-

Default value: 0


-

The "id" property

-
  "id"                       gchar*                : Read / Write
+

NM_SETTING_CONNECTION_AUTOCONNECT_PRIORITY_DEFAULT

+
#define NM_SETTING_CONNECTION_AUTOCONNECT_PRIORITY_DEFAULT 0
+

-A human readable unique identifier for the connection, like "Work Wi-Fi" -or "T-Mobile 3G".

-

Default value: NULL


-

The "interface-name" property

-
  "interface-name"           gchar*                : Read / Write
+

NM_SETTING_CONNECTION_ID

+
#define NM_SETTING_CONNECTION_ID             "id"
+

-The name of the network interface this connection is bound to. If not -set, then the connection can be attached to any interface of the -appropriate type (subject to restrictions imposed by other settings).

+
+
+
+

NM_SETTING_CONNECTION_UUID

+
#define NM_SETTING_CONNECTION_UUID           "uuid"
+

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

+
+
+
+

NM_SETTING_CONNECTION_INTERFACE_NAME

+
#define NM_SETTING_CONNECTION_INTERFACE_NAME "interface-name"
+

-For connection types where interface names cannot easily be made -persistent (e.g. mobile broadband or USB Ethernet), this property should -not be used. Setting this property restricts the interfaces a connection -can be used with, and if interface names change or are reordered the -connection may be applied to the wrong interface.

-

Default value: NULL


-

The "master" property

-
  "master"                   gchar*                : Read / Write
+

NM_SETTING_CONNECTION_TYPE

+
#define NM_SETTING_CONNECTION_TYPE           "type"
+
+

+

+
+
+
+

NM_SETTING_CONNECTION_AUTOCONNECT

+
#define NM_SETTING_CONNECTION_AUTOCONNECT    "autoconnect"
+

-Interface name of the master device or UUID of the master connection.

-

Default value: NULL


-

The "permissions" property

-
  "permissions"              GStrv                 : Read / Write
+

NM_SETTING_CONNECTION_AUTOCONNECT_PRIORITY

+
#define NM_SETTING_CONNECTION_AUTOCONNECT_PRIORITY "autoconnect-priority"
+

-An array of strings defining what access a given user has to this -connection. If this is NULL or empty, all users are allowed to access -this connection. Otherwise a user is allowed to access this connection -if and only if they are in this list. Each entry is of the form -"[type]:[id]:[reserved]"; for example, "user:dcbw:blah".

+
+
+
+

NM_SETTING_CONNECTION_TIMESTAMP

+
#define NM_SETTING_CONNECTION_TIMESTAMP      "timestamp"
+

-At this time only the "user" [type] is allowed. Any other values are -ignored and reserved for future use. [id] is the username that this -permission refers to, which may not contain the ":" character. Any -[reserved] information present must be ignored and is reserved for future -use. All of [type], [id], and [reserved] must be valid UTF-8.


-

The "read-only" property

-
  "read-only"                gboolean              : Read / Write / Construct
+

NM_SETTING_CONNECTION_READ_ONLY

+
#define NM_SETTING_CONNECTION_READ_ONLY      "read-only"
+

-FALSE if the connection can be modified using the provided settings -service's D-Bus interface with the right privileges, or TRUE if the -connection is read-only and cannot be modified.

-

Default value: FALSE


-

The "secondaries" property

-
  "secondaries"              GStrv                 : Read / Write
+

NM_SETTING_CONNECTION_PERMISSIONS

+
#define NM_SETTING_CONNECTION_PERMISSIONS    "permissions"
+

-List of connection UUIDs that should be activated when the base -connection itself is activated. Currently only VPN connections are -supported.


-

The "slave-type" property

-
  "slave-type"               gchar*                : Read / Write
+

NM_SETTING_CONNECTION_ZONE

+
#define NM_SETTING_CONNECTION_ZONE           "zone"
+
+

+

+
+
+
+

NM_SETTING_CONNECTION_MASTER

+
#define NM_SETTING_CONNECTION_MASTER         "master"
+
+

+

+
+
+
+

NM_SETTING_CONNECTION_SLAVE_TYPE

+
#define NM_SETTING_CONNECTION_SLAVE_TYPE     "slave-type"
+

-Setting name of the device type of this slave's master connection (eg, -NM_SETTING_BOND_SETTING_NAME), or NULL if this connection is not a -slave.

-

Default value: NULL


-

The "timestamp" property

-
  "timestamp"                guint64               : Read / Write / Construct
+

NM_SETTING_CONNECTION_SECONDARIES

+
#define NM_SETTING_CONNECTION_SECONDARIES    "secondaries"
+

-The time, in seconds since the Unix Epoch, that the connection was last -_successfully_ fully activated.

+
+
+
+

NM_SETTING_CONNECTION_GATEWAY_PING_TIMEOUT

+
#define NM_SETTING_CONNECTION_GATEWAY_PING_TIMEOUT "gateway-ping-timeout"
+

-NetworkManager updates the connection timestamp periodically when the +

+
+
+
+

struct NMSettingConnection

+
struct NMSettingConnection;
+

The NMSettingConnection struct contains only private data. +It should only be accessed through the functions described below.

+
+
+
+

Property Details

+
+

The “autoconnect” property

+
  “autoconnect”              gboolean
+

Whether or not the connection should be automatically connected by +NetworkManager when the resources for the connection are available. +TRUE to automatically activate the connection, FALSE to require manual +intervention to activate the connection.

+

Flags: Read / Write / Construct

+

Default value: TRUE

+
+
+
+

The “autoconnect-priority” property

+
  “autoconnect-priority”     gint
+

The autoconnect priority. If the connection is set to autoconnect, +connections with higher priority will be preferred. Defaults to 0. +The higher number means higher priority.

+

Flags: Read / Write / Construct

+

Allowed values: [-999,999]

+

Default value: 0

+
+
+
+

The “gateway-ping-timeout” property

+
  “gateway-ping-timeout”     guint
+

If greater than zero, delay success of IP addressing until either the +timeout is reached, or an IP gateway replies to a ping.

+

Flags: Read / Write / Construct

+

Allowed values: <= 30

+

Default value: 0

+
+
+
+

The “id” property

+
  “id”                       gchar *
+

A human readable unique identifier for the connection, like "Work Wi-Fi" +or "T-Mobile 3G".

+

Flags: Read / Write

+

Default value: NULL

+
+
+
+

The “interface-name” property

+
  “interface-name”           gchar *
+

The name of the network interface this connection is bound to. If not +set, then the connection can be attached to any interface of the +appropriate type (subject to restrictions imposed by other settings).

+

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

+

For connection types where interface names cannot easily be made +persistent (e.g. mobile broadband or USB Ethernet), this property should +not be used. Setting this property restricts the interfaces a connection +can be used with, and if interface names change or are reordered the +connection may be applied to the wrong interface.

+

Flags: Read / Write

+

Default value: NULL

+
+
+
+

The “master” property

+
  “master”                   gchar *
+

Interface name of the master device or UUID of the master connection.

+

Flags: Read / Write

+

Default value: NULL

+
+
+
+

The “permissions” property

+
  “permissions”              GStrv
+

An array of strings defining what access a given user has to this +connection. If this is NULL or empty, all users are allowed to access +this connection. Otherwise a user is allowed to access this connection +if and only if they are in this list. Each entry is of the form +"[type]:[id]:[reserved]"; for example, "user:dcbw:blah".

+

At this time only the "user" [type] is allowed. Any other values are +ignored and reserved for future use. [id] is the username that this +permission refers to, which may not contain the ":" character. Any +[reserved] information present must be ignored and is reserved for future +use. All of [type], [id], and [reserved] must be valid UTF-8.

+

Flags: Read / Write

+
+
+
+

The “read-only” property

+
  “read-only”                gboolean
+

FALSE if the connection can be modified using the provided settings +service's D-Bus interface with the right privileges, or TRUE if the +connection is read-only and cannot be modified.

+

Flags: Read / Write / Construct

+

Default value: FALSE

+
+
+
+

The “secondaries” property

+
  “secondaries”              GStrv
+

List of connection UUIDs that should be activated when the base +connection itself is activated. Currently only VPN connections are +supported.

+

Flags: Read / Write

+
+
+
+

The “slave-type” property

+
  “slave-type”               gchar *
+

Setting name of the device type of this slave's master connection (eg, +NM_SETTING_BOND_SETTING_NAME), or NULL if this connection is not a +slave.

+

Flags: Read / Write

+

Default value: NULL

+
+
+
+

The “timestamp” property

+
  “timestamp”                guint64
+

The time, in seconds since the Unix Epoch, that the connection was last +_successfully_ fully activated.

+

NetworkManager updates the connection timestamp periodically when the connection is active to ensure that an active connection has the latest timestamp. The property is only meant for reading (changes to this -property will not be preserved). -

+property will not be preserved).

+

Flags: Read / Write / Construct

Default value: 0


-

The "type" property

-
  "type"                     gchar*                : Read / Write
-

-Base type of the connection. For hardware-dependent connections, should +

The “type” property

+
  “type”                     gchar *
+

Base type of the connection. For hardware-dependent connections, should contain the setting name of the hardware-type specific setting (ie, "802-3-ethernet" or "802-11-wireless" or "bluetooth", etc), and for non-hardware dependent connections like VPN or otherwise, should contain -the setting name of that setting type (ie, "vpn" or "bridge", etc). -

+the setting name of that setting type (ie, "vpn" or "bridge", etc).

+

Flags: Read / Write

Default value: NULL


-

The "uuid" property

-
  "uuid"                     gchar*                : Read / Write
-

-A universally unique identifier for the connection, for example generated +

The “uuid” property

+
  “uuid”                     gchar *
+

A universally unique identifier for the connection, for example generated with libuuid. It should be assigned when the connection is created, and never changed as long as the connection still applies to the same network. For example, it should not be changed when the -"id" property or NMSettingIP4Config changes, but +“id” property or NMSettingIP4Config changes, but might need to be re-created when the Wi-Fi SSID, mobile broadband network -provider, or "type" property changes. -

-

-The UUID must be in the format "2815492f-7e56-435e-b2e9-246bd7cdc664" +provider, or “type” property changes.

+

The UUID must be in the format "2815492f-7e56-435e-b2e9-246bd7cdc664" (ie, contains only hexadecimal characters and "-"). A suitable UUID may -be generated by nm_utils_uuid_generate() or -nm_utils_uuid_generate_from_string(). -

+be generated by nm_utils_uuid_generate() or +nm_utils_uuid_generate_from_string().

+

Flags: Read / Write

Default value: NULL


-

The "zone" property

-
  "zone"                     gchar*                : Read / Write / Construct
-

-The trust level of a the connection. Free form case-insensitive string -(for example "Home", "Work", "Public"). NULL or unspecified zone means +

The “zone” property

+
  “zone”                     gchar *
+

The trust level of a the connection. Free form case-insensitive string +(for example "Home", "Work", "Public"). NULL or unspecified zone means the connection will be placed in the default zone as defined by the -firewall. -

+firewall.

+

Flags: Read / Write / Construct

Default value: NULL

+ Generated by GTK-Doc V1.21 \ No newline at end of file diff --git a/docs/libnm/html/NMSettingDcb.html b/docs/libnm/html/NMSettingDcb.html index e9d9de64..ebfedd69 100644 --- a/docs/libnm/html/NMSettingDcb.html +++ b/docs/libnm/html/NMSettingDcb.html @@ -2,34 +2,28 @@ -NMSettingDcb +libnm Reference Manual: NMSettingDcb - + - - - - - - - - - - + + + + + + +
@@ -37,1104 +31,1380 @@

NMSettingDcb

NMSettingDcb — Connection properties for Data Center Bridging

- +
-
-

Synopsis

-
#define             NM_SETTING_DCB_SETTING_NAME
-enum                NMSettingDcbFlags;
-#define             NM_SETTING_DCB_FCOE_MODE_FABRIC
-#define             NM_SETTING_DCB_FCOE_MODE_VN2VN
-#define             NM_SETTING_DCB_APP_FCOE_FLAGS
-#define             NM_SETTING_DCB_APP_FCOE_PRIORITY
-#define             NM_SETTING_DCB_APP_FCOE_MODE
-#define             NM_SETTING_DCB_APP_ISCSI_FLAGS
-#define             NM_SETTING_DCB_APP_ISCSI_PRIORITY
-#define             NM_SETTING_DCB_APP_FIP_FLAGS
-#define             NM_SETTING_DCB_APP_FIP_PRIORITY
-#define             NM_SETTING_DCB_PRIORITY_FLOW_CONTROL_FLAGS
-#define             NM_SETTING_DCB_PRIORITY_FLOW_CONTROL
-#define             NM_SETTING_DCB_PRIORITY_GROUP_FLAGS
-#define             NM_SETTING_DCB_PRIORITY_GROUP_ID
-#define             NM_SETTING_DCB_PRIORITY_GROUP_BANDWIDTH
-#define             NM_SETTING_DCB_PRIORITY_BANDWIDTH
-#define             NM_SETTING_DCB_PRIORITY_STRICT_BANDWIDTH
-#define             NM_SETTING_DCB_PRIORITY_TRAFFIC_CLASS
-struct              NMSettingDcb;
-                    NMSettingDcbClass;
-NMSetting *         nm_setting_dcb_new                  (void);
-NMSettingDcbFlags   nm_setting_dcb_get_app_fcoe_flags   (NMSettingDcb *setting);
-gint                nm_setting_dcb_get_app_fcoe_priority
-                                                        (NMSettingDcb *setting);
-const char *        nm_setting_dcb_get_app_fcoe_mode    (NMSettingDcb *setting);
-NMSettingDcbFlags   nm_setting_dcb_get_app_iscsi_flags  (NMSettingDcb *setting);
-gint                nm_setting_dcb_get_app_iscsi_priority
-                                                        (NMSettingDcb *setting);
-NMSettingDcbFlags   nm_setting_dcb_get_app_fip_flags    (NMSettingDcb *setting);
-gint                nm_setting_dcb_get_app_fip_priority (NMSettingDcb *setting);
-NMSettingDcbFlags   nm_setting_dcb_get_priority_flow_control_flags
-                                                        (NMSettingDcb *setting);
-gboolean            nm_setting_dcb_get_priority_flow_control
-                                                        (NMSettingDcb *setting,
-                                                         guint user_priority);
-void                nm_setting_dcb_set_priority_flow_control
-                                                        (NMSettingDcb *setting,
-                                                         guint user_priority,
-                                                         gboolean enabled);
-NMSettingDcbFlags   nm_setting_dcb_get_priority_group_flags
-                                                        (NMSettingDcb *setting);
-guint               nm_setting_dcb_get_priority_group_id
-                                                        (NMSettingDcb *setting,
-                                                         guint user_priority);
-void                nm_setting_dcb_set_priority_group_id
-                                                        (NMSettingDcb *setting,
-                                                         guint user_priority,
-                                                         guint group_id);
-guint               nm_setting_dcb_get_priority_group_bandwidth
-                                                        (NMSettingDcb *setting,
-                                                         guint group_id);
-void                nm_setting_dcb_set_priority_group_bandwidth
-                                                        (NMSettingDcb *setting,
-                                                         guint group_id,
-                                                         guint bandwidth_percent);
-guint               nm_setting_dcb_get_priority_bandwidth
-                                                        (NMSettingDcb *setting,
-                                                         guint user_priority);
-void                nm_setting_dcb_set_priority_bandwidth
-                                                        (NMSettingDcb *setting,
-                                                         guint user_priority,
-                                                         guint bandwidth_percent);
-gboolean            nm_setting_dcb_get_priority_strict_bandwidth
-                                                        (NMSettingDcb *setting,
-                                                         guint user_priority);
-void                nm_setting_dcb_set_priority_strict_bandwidth
-                                                        (NMSettingDcb *setting,
-                                                         guint user_priority,
-                                                         gboolean strict);
-guint               nm_setting_dcb_get_priority_traffic_class
-                                                        (NMSettingDcb *setting,
-                                                         guint user_priority);
-void                nm_setting_dcb_set_priority_traffic_class
-                                                        (NMSettingDcb *setting,
-                                                         guint user_priority,
-                                                         guint traffic_class);
-
-
-
-

Object Hierarchy

-
-  GFlags
-   +----NMSettingDcbFlags
-
-
-  GObject
-   +----NMSetting
-         +----NMSettingDcb
-
-
-
-

Properties

-
-  "app-fcoe-flags"           NMSettingDcbFlags     : Read / Write
-  "app-fcoe-mode"            gchar*                : Read / Write / Construct
-  "app-fcoe-priority"        gint                  : Read / Write / Construct
-  "app-fip-flags"            NMSettingDcbFlags     : Read / Write
-  "app-fip-priority"         gint                  : Read / Write / Construct
-  "app-iscsi-flags"          NMSettingDcbFlags     : Read / Write
-  "app-iscsi-priority"       gint                  : Read / Write / Construct
-  "priority-bandwidth"       GArray*               : Read / Write
-  "priority-flow-control"    GArray*               : Read / Write
-  "priority-flow-control-flags" NMSettingDcbFlags     : Read / Write
-  "priority-group-bandwidth" GArray*               : Read / Write
-  "priority-group-flags"     NMSettingDcbFlags     : Read / Write
-  "priority-group-id"        GArray*               : Read / Write
-  "priority-strict-bandwidth" GArray*               : Read / Write
-  "priority-traffic-class"   GArray*               : Read / Write
-
-
-

Description

-

-The NMSettingDcb object is a NMSetting subclass that describes properties -for enabling and using Data Center Bridging (DCB) on Ethernet networks. -DCB is a set of protocols (including 802.1Qbb, 802.1Qaz, 802.1Qau, and -802.1AB) to eliminate packet loss in Ethernet networks and support the use -of storage technologies like Fibre Channel over Ethernet (FCoE) and iSCSI. -

-
-
-

Details

-
-

NM_SETTING_DCB_SETTING_NAME

-
#define NM_SETTING_DCB_SETTING_NAME "dcb"
-
-

-

-
-
-
-

enum NMSettingDcbFlags

-
typedef enum {
- /*< flags >*/
-	NM_SETTING_DCB_FLAG_NONE      = 0x00000000,
-	NM_SETTING_DCB_FLAG_ENABLE    = 0x00000001,
-	NM_SETTING_DCB_FLAG_ADVERTISE = 0x00000002,
-	NM_SETTING_DCB_FLAG_WILLING   = 0x00000004
-} NMSettingDcbFlags;
-
-

-DCB feature flags. -

-
+

Functions

+
--++ - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - - + - - + - - +

NM_SETTING_DCB_FLAG_NONE

no flag + +NMSetting * + +nm_setting_dcb_new () +
+NMSettingDcbFlags + +nm_setting_dcb_get_app_fcoe_flags () +
+gint + +nm_setting_dcb_get_app_fcoe_priority () +
const char * + +nm_setting_dcb_get_app_fcoe_mode () +
+NMSettingDcbFlags + +nm_setting_dcb_get_app_iscsi_flags () +
+gint + +nm_setting_dcb_get_app_iscsi_priority () +
+NMSettingDcbFlags + +nm_setting_dcb_get_app_fip_flags () +
+gint + +nm_setting_dcb_get_app_fip_priority () +
+NMSettingDcbFlags + +nm_setting_dcb_get_priority_flow_control_flags () +
+gboolean + +nm_setting_dcb_get_priority_flow_control () +
+void + +nm_setting_dcb_set_priority_flow_control () +
+NMSettingDcbFlags + +nm_setting_dcb_get_priority_group_flags () +
+guint + +nm_setting_dcb_get_priority_group_id () +
+void + +nm_setting_dcb_set_priority_group_id () +
+guint + +nm_setting_dcb_get_priority_group_bandwidth () +
+void + +nm_setting_dcb_set_priority_group_bandwidth () +
+guint + +nm_setting_dcb_get_priority_bandwidth () +
+void + +nm_setting_dcb_set_priority_bandwidth () +
+gboolean + +nm_setting_dcb_get_priority_strict_bandwidth ()

NM_SETTING_DCB_FLAG_ENABLE

the feature is enabled + +void + +nm_setting_dcb_set_priority_strict_bandwidth ()

NM_SETTING_DCB_FLAG_ADVERTISE

the feature is advertised + +guint + +nm_setting_dcb_get_priority_traffic_class ()

NM_SETTING_DCB_FLAG_WILLING

the feature is willing to change based on -peer configuration advertisements + +void + +nm_setting_dcb_set_priority_traffic_class ()
-
-
-

NM_SETTING_DCB_FCOE_MODE_FABRIC

-
#define NM_SETTING_DCB_FCOE_MODE_FABRIC  "fabric"
-
-

-Indicates that the FCoE controller should use "fabric" mode (default) -

-
-
-
-

NM_SETTING_DCB_FCOE_MODE_VN2VN

-
#define NM_SETTING_DCB_FCOE_MODE_VN2VN   "vn2vn"
-
-

-Indicates that the FCoE controller should use "VN2VN" mode. -

-
-
-
-

NM_SETTING_DCB_APP_FCOE_FLAGS

-
#define NM_SETTING_DCB_APP_FCOE_FLAGS         "app-fcoe-flags"
-
-

-

-
-
-
-

NM_SETTING_DCB_APP_FCOE_PRIORITY

-
#define NM_SETTING_DCB_APP_FCOE_PRIORITY      "app-fcoe-priority"
-
-

-

-
-
-
-

NM_SETTING_DCB_APP_FCOE_MODE

-
#define NM_SETTING_DCB_APP_FCOE_MODE          "app-fcoe-mode"
-
-

-

-
-
-
-

NM_SETTING_DCB_APP_ISCSI_FLAGS

-
#define NM_SETTING_DCB_APP_ISCSI_FLAGS        "app-iscsi-flags"
-
-

-

-
-
-
-

NM_SETTING_DCB_APP_ISCSI_PRIORITY

-
#define NM_SETTING_DCB_APP_ISCSI_PRIORITY     "app-iscsi-priority"
-
-

-

-
-
-
-

NM_SETTING_DCB_APP_FIP_FLAGS

-
#define NM_SETTING_DCB_APP_FIP_FLAGS          "app-fip-flags"
-
-

-

-
-
-
-

NM_SETTING_DCB_APP_FIP_PRIORITY

-
#define NM_SETTING_DCB_APP_FIP_PRIORITY       "app-fip-priority"
-
-

-

-
-
-
-

NM_SETTING_DCB_PRIORITY_FLOW_CONTROL_FLAGS

-
#define NM_SETTING_DCB_PRIORITY_FLOW_CONTROL_FLAGS  "priority-flow-control-flags"
-
-

-

-
-
-
-

NM_SETTING_DCB_PRIORITY_FLOW_CONTROL

-
#define NM_SETTING_DCB_PRIORITY_FLOW_CONTROL        "priority-flow-control"
-
-

-

-
-
-
-

NM_SETTING_DCB_PRIORITY_GROUP_FLAGS

-
#define NM_SETTING_DCB_PRIORITY_GROUP_FLAGS      "priority-group-flags"
-
-

-

-
-
-
-

NM_SETTING_DCB_PRIORITY_GROUP_ID

-
#define NM_SETTING_DCB_PRIORITY_GROUP_ID         "priority-group-id"
-
-

-

-
-
-
-

NM_SETTING_DCB_PRIORITY_GROUP_BANDWIDTH

-
#define NM_SETTING_DCB_PRIORITY_GROUP_BANDWIDTH  "priority-group-bandwidth"
-
-

-

+
+

Properties

+
+++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
NMSettingDcbFlagsapp-fcoe-flagsRead / Write
+gchar *app-fcoe-modeRead / Write / Construct
gintapp-fcoe-priorityRead / Write / Construct
NMSettingDcbFlagsapp-fip-flagsRead / Write
gintapp-fip-priorityRead / Write / Construct
NMSettingDcbFlagsapp-iscsi-flagsRead / Write
gintapp-iscsi-priorityRead / Write / Construct
+GArray *priority-bandwidthRead / Write
+GArray *priority-flow-controlRead / Write
NMSettingDcbFlagspriority-flow-control-flagsRead / Write
+GArray *priority-group-bandwidthRead / Write
NMSettingDcbFlagspriority-group-flagsRead / Write
+GArray *priority-group-idRead / Write
+GArray *priority-strict-bandwidthRead / Write
+GArray *priority-traffic-classRead / Write
-
-
-

NM_SETTING_DCB_PRIORITY_BANDWIDTH

-
#define NM_SETTING_DCB_PRIORITY_BANDWIDTH        "priority-bandwidth"
-
-

-

+ -
-
-

NM_SETTING_DCB_PRIORITY_STRICT_BANDWIDTH

-
#define NM_SETTING_DCB_PRIORITY_STRICT_BANDWIDTH "priority-strict-bandwidth"
+
+

Object Hierarchy

+
    GFlags
+    ╰── NMSettingDcbFlags
+    GObject
+    ╰── NMSetting
+        ╰── NMSettingDcb
 
-

-

-
-
-

NM_SETTING_DCB_PRIORITY_TRAFFIC_CLASS

-
#define NM_SETTING_DCB_PRIORITY_TRAFFIC_CLASS    "priority-traffic-class"
-
-

-

+
+

Description

+

The NMSettingDcb object is a NMSetting subclass that describes properties +for enabling and using Data Center Bridging (DCB) on Ethernet networks. +DCB is a set of protocols (including 802.1Qbb, 802.1Qaz, 802.1Qau, and +802.1AB) to eliminate packet loss in Ethernet networks and support the use +of storage technologies like Fibre Channel over Ethernet (FCoE) and iSCSI.

-
+
+

Functions

-

struct NMSettingDcb

-
struct NMSettingDcb;
-

-

+

nm_setting_dcb_new ()

+
NMSetting *
+nm_setting_dcb_new (void);
+

Creates a new NMSettingDcb object with default values.

+
+

Returns

+

the new empty NMSettingDcb object.

+

[transfer full]

-
-
-

NMSettingDcbClass

-
typedef struct {
-	NMSettingClass parent;
-} NMSettingDcbClass;
-
-

-


-

nm_setting_dcb_new ()

-
NMSetting *         nm_setting_dcb_new                  (void);
-

-Creates a new NMSettingDcb object with default values. -

-
+

nm_setting_dcb_get_app_fcoe_flags ()

+
NMSettingDcbFlags
+nm_setting_dcb_get_app_fcoe_flags (NMSettingDcb *setting);
+
+

Parameters

+
--+++ - - + + +

Returns :

the new empty NMSettingDcb object. [transfer full] -

setting

the NMSettingDcb

 
+
+

Returns

+

the “app-fcoe-flags” property of the setting

+

+
+

-

nm_setting_dcb_get_app_fcoe_flags ()

-
NMSettingDcbFlags   nm_setting_dcb_get_app_fcoe_flags   (NMSettingDcb *setting);
-
+

nm_setting_dcb_get_app_fcoe_priority ()

+
gint
+nm_setting_dcb_get_app_fcoe_priority (NMSettingDcb *setting);
+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSettingDcb -

Returns :

the "app-fcoe-flags" property of the setting

setting

the NMSettingDcb

 
+
+

Returns

+

the “app-fcoe-priority” property of the setting

+

+
+

-

nm_setting_dcb_get_app_fcoe_priority ()

-
gint                nm_setting_dcb_get_app_fcoe_priority
-                                                        (NMSettingDcb *setting);
-
+

nm_setting_dcb_get_app_fcoe_mode ()

+
const char *
+nm_setting_dcb_get_app_fcoe_mode (NMSettingDcb *setting);
+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSettingDcb -

Returns :

the "app-fcoe-priority" property of the setting

setting

the NMSettingDcb

 
+
+

Returns

+

the “app-fcoe-mode” property of the setting

+

+
+

-

nm_setting_dcb_get_app_fcoe_mode ()

-
const char *        nm_setting_dcb_get_app_fcoe_mode    (NMSettingDcb *setting);
-
+

nm_setting_dcb_get_app_iscsi_flags ()

+
NMSettingDcbFlags
+nm_setting_dcb_get_app_iscsi_flags (NMSettingDcb *setting);
+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSettingDcb -

Returns :

the "app-fcoe-mode" property of the setting

setting

the NMSettingDcb

 
+
+

Returns

+

the “app-iscsi-flags” property of the setting

+

+
+

-

nm_setting_dcb_get_app_iscsi_flags ()

-
NMSettingDcbFlags   nm_setting_dcb_get_app_iscsi_flags  (NMSettingDcb *setting);
-
+

nm_setting_dcb_get_app_iscsi_priority ()

+
gint
+nm_setting_dcb_get_app_iscsi_priority (NMSettingDcb *setting);
+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSettingDcb -

Returns :

the "app-iscsi-flags" property of the setting

setting

the NMSettingDcb

 
+
+

Returns

+

the “app-iscsi-priority” property of the setting

+

+
+

-

nm_setting_dcb_get_app_iscsi_priority ()

-
gint                nm_setting_dcb_get_app_iscsi_priority
-                                                        (NMSettingDcb *setting);
-
+

nm_setting_dcb_get_app_fip_flags ()

+
NMSettingDcbFlags
+nm_setting_dcb_get_app_fip_flags (NMSettingDcb *setting);
+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSettingDcb -

Returns :

the "app-iscsi-priority" property of the setting

setting

the NMSettingDcb

 
+
+

Returns

+

the “app-fip-flags” property of the setting

+

+
+

-

nm_setting_dcb_get_app_fip_flags ()

-
NMSettingDcbFlags   nm_setting_dcb_get_app_fip_flags    (NMSettingDcb *setting);
-
+

nm_setting_dcb_get_app_fip_priority ()

+
gint
+nm_setting_dcb_get_app_fip_priority (NMSettingDcb *setting);
+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSettingDcb -

Returns :

the "app-fip-flags" property of the setting

setting

the NMSettingDcb

 
+
+

Returns

+

the “app-fip-priority” property of the setting

+

+
+

-

nm_setting_dcb_get_app_fip_priority ()

-
gint                nm_setting_dcb_get_app_fip_priority (NMSettingDcb *setting);
-
+

nm_setting_dcb_get_priority_flow_control_flags ()

+
NMSettingDcbFlags
+nm_setting_dcb_get_priority_flow_control_flags
+                               (NMSettingDcb *setting);
+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSettingDcb -

Returns :

the "app-fip-priority" property of the setting

setting

the NMSettingDcb

 
+
+

Returns

+

the “priority-flow-control-flags” property of the setting

+

+
+

-

nm_setting_dcb_get_priority_flow_control_flags ()

-
NMSettingDcbFlags   nm_setting_dcb_get_priority_flow_control_flags
-                                                        (NMSettingDcb *setting);
-
+

nm_setting_dcb_get_priority_flow_control ()

+
gboolean
+nm_setting_dcb_get_priority_flow_control
+                               (NMSettingDcb *setting,
+                                guint user_priority);
+
+

Parameters

+
--+++ - - + + + - - + + +

setting :

the NMSettingDcb -

setting

the NMSettingDcb

 

Returns :

the "priority-flow-control-flags" property of the setting

user_priority

the User Priority (0 - 7) to retrieve flow control for

 
+
+

Returns

+

TRUE if flow control is enabled for the given user_priority +, +FALSE if not enabled

+

+
+
-

nm_setting_dcb_get_priority_flow_control ()

-
gboolean            nm_setting_dcb_get_priority_flow_control
-                                                        (NMSettingDcb *setting,
-                                                         guint user_priority);
-
+

nm_setting_dcb_set_priority_flow_control ()

+
void
+nm_setting_dcb_set_priority_flow_control
+                               (NMSettingDcb *setting,
+                                guint user_priority,
+                                gboolean enabled);
+

These values are only valid when “priority-flow-control” includes +the NM_SETTING_DCB_FLAG_ENABLE flag.

+
+

Parameters

+
--+++ - - + + + - - + + + - - + + +

setting :

the NMSettingDcb -

setting

the NMSettingDcb

 

user_priority :

the User Priority (0 - 7) to retrieve flow control for

user_priority

the User Priority (0 - 7) to set flow control for

 

Returns :

-TRUE if flow control is enabled for the given user_priority, -FALSE if not enabled

enabled

TRUE to enable flow control for this priority, FALSE to disable it

 
+
-

nm_setting_dcb_set_priority_flow_control ()

-
void                nm_setting_dcb_set_priority_flow_control
-                                                        (NMSettingDcb *setting,
-                                                         guint user_priority,
-                                                         gboolean enabled);
-

-These values are only valid when "priority-flow-control" includes -the NM_SETTING_DCB_FLAG_ENABLE flag. -

-
+

nm_setting_dcb_get_priority_group_flags ()

+
NMSettingDcbFlags
+nm_setting_dcb_get_priority_group_flags
+                               (NMSettingDcb *setting);
+
+

Parameters

+
--+++ - - - - - - - - - - - - - - + + + + +

setting :

the NMSettingDcb -

user_priority :

the User Priority (0 - 7) to set flow control for

enabled :

-TRUE to enable flow control for this priority, FALSE to disable it

setting

the NMSettingDcb

 
+
+

Returns

+

the “priority-group-flags” property of the setting

+

+
+
-

nm_setting_dcb_get_priority_group_flags ()

-
NMSettingDcbFlags   nm_setting_dcb_get_priority_group_flags
-                                                        (NMSettingDcb *setting);
-
+

nm_setting_dcb_get_priority_group_id ()

+
guint
+nm_setting_dcb_get_priority_group_id (NMSettingDcb *setting,
+                                      guint user_priority);
+
+

Parameters

+
--+++ - - + + + - - + + +

setting :

the NMSettingDcb -

setting

the NMSettingDcb

 

Returns :

the "priority-group-flags" property of the setting

user_priority

the User Priority (0 - 7) to retrieve the group ID for

 
+
+

Returns

+

the group number user_priority +is assigned to. These values are +only valid when “priority-group-flags” includes the +NM_SETTING_DCB_FLAG_ENABLE flag.

+

+
+
-

nm_setting_dcb_get_priority_group_id ()

-
guint               nm_setting_dcb_get_priority_group_id
-                                                        (NMSettingDcb *setting,
-                                                         guint user_priority);
-
+

nm_setting_dcb_set_priority_group_id ()

+
void
+nm_setting_dcb_set_priority_group_id (NMSettingDcb *setting,
+                                      guint user_priority,
+                                      guint group_id);
+

These values are only valid when “priority-group-flags” includes +the NM_SETTING_DCB_FLAG_ENABLE flag.

+
+

Parameters

+
--+++ - - + + + - - + + + - - + + +

setting :

the NMSettingDcb -

setting

the NMSettingDcb

 

user_priority :

the User Priority (0 - 7) to retrieve the group ID for

user_priority

the User Priority (0 - 7) to set flow control for

 

Returns :

the group number user_priority is assigned to. These values are -only valid when "priority-group-flags" includes the -NM_SETTING_DCB_FLAG_ENABLE flag.

group_id

the group (0 - 7) to assign user_priority +to, or 15 for the +unrestricted group.

 
+
-

nm_setting_dcb_set_priority_group_id ()

-
void                nm_setting_dcb_set_priority_group_id
-                                                        (NMSettingDcb *setting,
-                                                         guint user_priority,
-                                                         guint group_id);
-

-These values are only valid when "priority-group-flags" includes -the NM_SETTING_DCB_FLAG_ENABLE flag. -

-
+

nm_setting_dcb_get_priority_group_bandwidth ()

+
guint
+nm_setting_dcb_get_priority_group_bandwidth
+                               (NMSettingDcb *setting,
+                                guint group_id);
+
+

Parameters

+
--+++ - - - - - - + + + - - + + +

setting :

the NMSettingDcb -

user_priority :

the User Priority (0 - 7) to set flow control for

setting

the NMSettingDcb

 

group_id :

the group (0 - 7) to assign user_priority to, or 15 for the -unrestricted group.

group_id

the priority group (0 - 7) to retrieve the bandwidth percentage for

 
+
+

Returns

+

the bandwidth percentage assigned to group_id +. These values are +only valid when “priority-group-flags” includes the +NM_SETTING_DCB_FLAG_ENABLE flag.

+

+
+
-

nm_setting_dcb_get_priority_group_bandwidth ()

-
guint               nm_setting_dcb_get_priority_group_bandwidth
-                                                        (NMSettingDcb *setting,
-                                                         guint group_id);
-
+

nm_setting_dcb_set_priority_group_bandwidth ()

+
void
+nm_setting_dcb_set_priority_group_bandwidth
+                               (NMSettingDcb *setting,
+                                guint group_id,
+                                guint bandwidth_percent);
+

These values are only valid when “priority-group-flags” includes +the NM_SETTING_DCB_FLAG_ENABLE flag.

+
+

Parameters

+
--+++ - - + + + - - + + + - - + + +

setting :

the NMSettingDcb -

setting

the NMSettingDcb

 

group_id :

the priority group (0 - 7) to retrieve the bandwidth percentage for

group_id

the priority group (0 - 7) to set the bandwidth percentage for

 

Returns :

the bandwidth percentage assigned to group_id. These values are -only valid when "priority-group-flags" includes the -NM_SETTING_DCB_FLAG_ENABLE flag.

bandwidth_percent

the bandwidth percentage (0 - 100) to assign to group_id +to

 
+
-

nm_setting_dcb_set_priority_group_bandwidth ()

-
void                nm_setting_dcb_set_priority_group_bandwidth
-                                                        (NMSettingDcb *setting,
-                                                         guint group_id,
-                                                         guint bandwidth_percent);
-

-These values are only valid when "priority-group-flags" includes -the NM_SETTING_DCB_FLAG_ENABLE flag. -

-
+

nm_setting_dcb_get_priority_bandwidth ()

+
guint
+nm_setting_dcb_get_priority_bandwidth (NMSettingDcb *setting,
+                                       guint user_priority);
+
+

Parameters

+
--+++ - - - - - - + + + - - + + +

setting :

the NMSettingDcb -

group_id :

the priority group (0 - 7) to set the bandwidth percentage for

setting

the NMSettingDcb

 

bandwidth_percent :

the bandwidth percentage (0 - 100) to assign to group_id to

user_priority

the User Priority (0 - 7) to retrieve the group bandwidth percentage for

 
+
+

Returns

+

the allowed bandwidth percentage of user_priority +in its priority group. +These values are only valid when “priority-group-flags” includes the +NM_SETTING_DCB_FLAG_ENABLE flag.

+

+
+
-

nm_setting_dcb_get_priority_bandwidth ()

-
guint               nm_setting_dcb_get_priority_bandwidth
-                                                        (NMSettingDcb *setting,
-                                                         guint user_priority);
-
+

nm_setting_dcb_set_priority_bandwidth ()

+
void
+nm_setting_dcb_set_priority_bandwidth (NMSettingDcb *setting,
+                                       guint user_priority,
+                                       guint bandwidth_percent);
+

These values are only valid when “priority-group-flags” includes +the NM_SETTING_DCB_FLAG_ENABLE flag.

+
+

Parameters

+
--+++ - - + + + - - + + + - - + + +

setting :

the NMSettingDcb -

setting

the NMSettingDcb

 

user_priority :

the User Priority (0 - 7) to retrieve the group bandwidth percentage for

user_priority

the User Priority (0 - 7) to set the bandwidth percentage for

 

Returns :

the allowed bandwidth percentage of user_priority in its priority group. -These values are only valid when "priority-group-flags" includes the -NM_SETTING_DCB_FLAG_ENABLE flag.

bandwidth_percent

the bandwidth percentage (0 - 100) that user_priority +is +allowed to use within its priority group

 
+
-

nm_setting_dcb_set_priority_bandwidth ()

-
void                nm_setting_dcb_set_priority_bandwidth
-                                                        (NMSettingDcb *setting,
-                                                         guint user_priority,
-                                                         guint bandwidth_percent);
-

-These values are only valid when "priority-group-flags" includes -the NM_SETTING_DCB_FLAG_ENABLE flag. -

-
+

nm_setting_dcb_get_priority_strict_bandwidth ()

+
gboolean
+nm_setting_dcb_get_priority_strict_bandwidth
+                               (NMSettingDcb *setting,
+                                guint user_priority);
+
+

Parameters

+
--+++ - - - - - - + + + - - + + +

setting :

the NMSettingDcb -

user_priority :

the User Priority (0 - 7) to set the bandwidth percentage for

setting

the NMSettingDcb

 

bandwidth_percent :

the bandwidth percentage (0 - 100) that user_priority is -allowed to use within its priority group

user_priority

the User Priority (0 - 7) to retrieve strict bandwidth for

 
+
+

Returns

+

TRUE if user_priority +may use all of the bandwidth allocated to its +assigned group, or FALSE if not. These values are only valid when +“priority-group-flags” includes the NM_SETTING_DCB_FLAG_ENABLE flag.

+

+
+
-

nm_setting_dcb_get_priority_strict_bandwidth ()

-
gboolean            nm_setting_dcb_get_priority_strict_bandwidth
-                                                        (NMSettingDcb *setting,
-                                                         guint user_priority);
-
+

nm_setting_dcb_set_priority_strict_bandwidth ()

+
void
+nm_setting_dcb_set_priority_strict_bandwidth
+                               (NMSettingDcb *setting,
+                                guint user_priority,
+                                gboolean strict);
+

These values are only valid when “priority-group-flags” includes +the NM_SETTING_DCB_FLAG_ENABLE flag.

+
+

Parameters

+
--+++ - - + + + - - + + + - - + + +

setting :

the NMSettingDcb -

setting

the NMSettingDcb

 

user_priority :

the User Priority (0 - 7) to retrieve strict bandwidth for

user_priority

the User Priority (0 - 7) to set strict bandwidth for

 

Returns :

-TRUE if user_priority may use all of the bandwidth allocated to its -assigned group, or FALSE if not. These values are only valid when -"priority-group-flags" includes the NM_SETTING_DCB_FLAG_ENABLE flag.

strict

TRUE to allow user_priority +to use all the bandwidth allocated to +its priority group, or FALSE if not

 
+
-

nm_setting_dcb_set_priority_strict_bandwidth ()

-
void                nm_setting_dcb_set_priority_strict_bandwidth
-                                                        (NMSettingDcb *setting,
-                                                         guint user_priority,
-                                                         gboolean strict);
-

-These values are only valid when "priority-group-flags" includes -the NM_SETTING_DCB_FLAG_ENABLE flag. -

-
+

nm_setting_dcb_get_priority_traffic_class ()

+
guint
+nm_setting_dcb_get_priority_traffic_class
+                               (NMSettingDcb *setting,
+                                guint user_priority);
+
+

Parameters

+
--+++ - - - - - - + + + - - + + +

setting :

the NMSettingDcb -

user_priority :

the User Priority (0 - 7) to set strict bandwidth for

setting

the NMSettingDcb

 

strict :

-TRUE to allow user_priority to use all the bandwidth allocated to -its priority group, or FALSE if not

user_priority

the User Priority (0 - 7) to retrieve the traffic class for

 
+
+

Returns

+

the traffic class assigned to user_priority +. These values are only +valid when “priority-group-flags” includes the +NM_SETTING_DCB_FLAG_ENABLE flag.

+

+
+ +
+
+

nm_setting_dcb_set_priority_traffic_class ()

+
void
+nm_setting_dcb_set_priority_traffic_class
+                               (NMSettingDcb *setting,
+                                guint user_priority,
+                                guint traffic_class);
+

+

+
+ +
+

Types and Values

+
+

NM_SETTING_DCB_SETTING_NAME

+
#define NM_SETTING_DCB_SETTING_NAME "dcb"
+
+

+

+

-

nm_setting_dcb_get_priority_traffic_class ()

-
guint               nm_setting_dcb_get_priority_traffic_class
-                                                        (NMSettingDcb *setting,
-                                                         guint user_priority);
-
+

enum NMSettingDcbFlags

+

DCB feature flags.

+
+

Members

+
--+++ - - + + + + + + + - - + + + - - + + +

setting :

the NMSettingDcb +

NM_SETTING_DCB_FLAG_NONE

+

no flag

+
 

NM_SETTING_DCB_FLAG_ENABLE

+

the feature is enabled

 

user_priority :

the User Priority (0 - 7) to retrieve the traffic class for

NM_SETTING_DCB_FLAG_ADVERTISE

+

the feature is advertised

+
 

Returns :

the traffic class assigned to user_priority. These values are only -valid when "priority-group-flags" includes the -NM_SETTING_DCB_FLAG_ENABLE flag.

NM_SETTING_DCB_FLAG_WILLING

+

the feature is willing to change based on +peer configuration advertisements

+
 
+

-

nm_setting_dcb_set_priority_traffic_class ()

-
void                nm_setting_dcb_set_priority_traffic_class
-                                                        (NMSettingDcb *setting,
-                                                         guint user_priority,
-                                                         guint traffic_class);
-

-

+

NM_SETTING_DCB_FCOE_MODE_FABRIC

+
#define NM_SETTING_DCB_FCOE_MODE_FABRIC  "fabric"
+
+

Indicates that the FCoE controller should use "fabric" mode (default)

+
+
+

NM_SETTING_DCB_FCOE_MODE_VN2VN

+
#define NM_SETTING_DCB_FCOE_MODE_VN2VN   "vn2vn"
+
+

Indicates that the FCoE controller should use "VN2VN" mode.

-
-

Property Details

+
-

The "app-fcoe-flags" property

-
  "app-fcoe-flags"           NMSettingDcbFlags     : Read / Write
+

NM_SETTING_DCB_APP_FCOE_FLAGS

+
#define NM_SETTING_DCB_APP_FCOE_FLAGS         "app-fcoe-flags"
+

-Specifies the NMSettingDcbFlags for the DCB FCoE application. Flags may -be any combination of NM_SETTING_DCB_FLAG_ENABLE, -NM_SETTING_DCB_FLAG_ADVERTISE, and NM_SETTING_DCB_FLAG_WILLING.


-

The "app-fcoe-mode" property

-
  "app-fcoe-mode"            gchar*                : Read / Write / Construct
+

NM_SETTING_DCB_APP_FCOE_PRIORITY

+
#define NM_SETTING_DCB_APP_FCOE_PRIORITY      "app-fcoe-priority"
+

-The FCoE controller mode; either NM_SETTING_DCB_FCOE_MODE_FABRIC -(default) or NM_SETTING_DCB_FCOE_MODE_VN2VN.

-

Default value: "fabric"


-

The "app-fcoe-priority" property

-
  "app-fcoe-priority"        gint                  : Read / Write / Construct
+

NM_SETTING_DCB_APP_FCOE_MODE

+
#define NM_SETTING_DCB_APP_FCOE_MODE          "app-fcoe-mode"
+

-The highest User Priority (0 - 7) which FCoE frames should use, or -1 for -default priority. Only used when the "app-fcoe-flags" -property includes the NM_SETTING_DCB_FLAG_ENABLE flag.

-

Allowed values: [-1,7]

-

Default value: -1


-

The "app-fip-flags" property

-
  "app-fip-flags"            NMSettingDcbFlags     : Read / Write
+

NM_SETTING_DCB_APP_ISCSI_FLAGS

+
#define NM_SETTING_DCB_APP_ISCSI_FLAGS        "app-iscsi-flags"
+

-Specifies the NMSettingDcbFlags for the DCB FIP application. Flags may -be any combination of NM_SETTING_DCB_FLAG_ENABLE, -NM_SETTING_DCB_FLAG_ADVERTISE, and NM_SETTING_DCB_FLAG_WILLING.


-

The "app-fip-priority" property

-
  "app-fip-priority"         gint                  : Read / Write / Construct
+

NM_SETTING_DCB_APP_ISCSI_PRIORITY

+
#define NM_SETTING_DCB_APP_ISCSI_PRIORITY     "app-iscsi-priority"
+

-The highest User Priority (0 - 7) which FIP frames should use, or -1 for -default priority. Only used when the "app-fip-flags" -property includes the NM_SETTING_DCB_FLAG_ENABLE flag.

-

Allowed values: [-1,7]

-

Default value: -1


-

The "app-iscsi-flags" property

-
  "app-iscsi-flags"          NMSettingDcbFlags     : Read / Write
+

NM_SETTING_DCB_APP_FIP_FLAGS

+
#define NM_SETTING_DCB_APP_FIP_FLAGS          "app-fip-flags"
+

-Specifies the NMSettingDcbFlags for the DCB iSCSI application. Flags -may be any combination of NM_SETTING_DCB_FLAG_ENABLE, -NM_SETTING_DCB_FLAG_ADVERTISE, and NM_SETTING_DCB_FLAG_WILLING.


-

The "app-iscsi-priority" property

-
  "app-iscsi-priority"       gint                  : Read / Write / Construct
+

NM_SETTING_DCB_APP_FIP_PRIORITY

+
#define NM_SETTING_DCB_APP_FIP_PRIORITY       "app-fip-priority"
+

-The highest User Priority (0 - 7) which iSCSI frames should use, or -1 -for default priority. Only used when the "app-iscsi-flags" -property includes the NM_SETTING_DCB_FLAG_ENABLE flag.

-

Allowed values: [-1,7]

-

Default value: -1


-

The "priority-bandwidth" property

-
  "priority-bandwidth"       GArray*               : Read / Write
-

-An array of 8 uint values, where the array index corresponds to the User -Priority (0 - 7) and the value indicates the percentage of bandwidth of -the priority's assigned group that the priority may use. The sum of all -percentages for priorities which belong to the same group must total 100 -percent. -

+

NM_SETTING_DCB_PRIORITY_FLOW_CONTROL_FLAGS

+
#define NM_SETTING_DCB_PRIORITY_FLOW_CONTROL_FLAGS  "priority-flow-control-flags"
+

-Element-type: guint


-

The "priority-flow-control" property

-
  "priority-flow-control"    GArray*               : Read / Write
-

-An array of 8 boolean values, where the array index corresponds to the User -Priority (0 - 7) and the value indicates whether or not the corresponding -priority should transmit priority pause. -

+

NM_SETTING_DCB_PRIORITY_FLOW_CONTROL

+
#define NM_SETTING_DCB_PRIORITY_FLOW_CONTROL        "priority-flow-control"
+

-Element-type: gboolean


-

The "priority-flow-control-flags" property

-
  "priority-flow-control-flags" NMSettingDcbFlags     : Read / Write
+

NM_SETTING_DCB_PRIORITY_GROUP_FLAGS

+
#define NM_SETTING_DCB_PRIORITY_GROUP_FLAGS      "priority-group-flags"
+

-Specifies the NMSettingDcbFlags for DCB Priority Flow Control (PFC). -Flags may be any combination of NM_SETTING_DCB_FLAG_ENABLE, -NM_SETTING_DCB_FLAG_ADVERTISE, and NM_SETTING_DCB_FLAG_WILLING.


-

The "priority-group-bandwidth" property

-
  "priority-group-bandwidth" GArray*               : Read / Write
-

-An array of 8 uint values, where the array index corresponds to the -Priority Group ID (0 - 7) and the value indicates the percentage of link -bandwidth allocated to that group. Allowed values are 0 - 100, and the -sum of all values must total 100 percent. -

+

NM_SETTING_DCB_PRIORITY_GROUP_ID

+
#define NM_SETTING_DCB_PRIORITY_GROUP_ID         "priority-group-id"
+

-Element-type: guint


-

The "priority-group-flags" property

-
  "priority-group-flags"     NMSettingDcbFlags     : Read / Write
+

NM_SETTING_DCB_PRIORITY_GROUP_BANDWIDTH

+
#define NM_SETTING_DCB_PRIORITY_GROUP_BANDWIDTH  "priority-group-bandwidth"
+

-Specifies the NMSettingDcbFlags for DCB Priority Groups. Flags may be -any combination of NM_SETTING_DCB_FLAG_ENABLE, -NM_SETTING_DCB_FLAG_ADVERTISE, and NM_SETTING_DCB_FLAG_WILLING.


-

The "priority-group-id" property

-
  "priority-group-id"        GArray*               : Read / Write
-

-An array of 8 uint values, where the array index corresponds to the User -Priority (0 - 7) and the value indicates the Priority Group ID. Allowed -Priority Group ID values are 0 - 7 or 15 for the unrestricted group. -

+

NM_SETTING_DCB_PRIORITY_BANDWIDTH

+
#define NM_SETTING_DCB_PRIORITY_BANDWIDTH        "priority-bandwidth"
+

-Element-type: guint


-

The "priority-strict-bandwidth" property

-
  "priority-strict-bandwidth" GArray*               : Read / Write
-

-An array of 8 boolean values, where the array index corresponds to the User -Priority (0 - 7) and the value indicates whether or not the priority may -use all of the bandwidth allocated to its assigned group. -

+

NM_SETTING_DCB_PRIORITY_STRICT_BANDWIDTH

+
#define NM_SETTING_DCB_PRIORITY_STRICT_BANDWIDTH "priority-strict-bandwidth"
+

-Element-type: gboolean


-

The "priority-traffic-class" property

-
  "priority-traffic-class"   GArray*               : Read / Write
-

-An array of 8 uint values, where the array index corresponds to the User -Priority (0 - 7) and the value indicates the traffic class (0 - 7) to -which the priority is mapped. -

+

NM_SETTING_DCB_PRIORITY_TRAFFIC_CLASS

+
#define NM_SETTING_DCB_PRIORITY_TRAFFIC_CLASS    "priority-traffic-class"
+

-Element-type: guint

+
+

Property Details

+
+

The “app-fcoe-flags” property

+
  “app-fcoe-flags”           NMSettingDcbFlags
+

+

Flags: Read / Write

+
+
+
+

The “app-fcoe-mode” property

+
  “app-fcoe-mode”            gchar *
+

+

Flags: Read / Write / Construct

+

Default value: "fabric"

+
+
+
+

The “app-fcoe-priority” property

+
  “app-fcoe-priority”        gint
+

+

Flags: Read / Write / Construct

+

Allowed values: [-1,7]

+

Default value: -1

+
+
+
+

The “app-fip-flags” property

+
  “app-fip-flags”            NMSettingDcbFlags
+

+

Flags: Read / Write

+
+
+
+

The “app-fip-priority” property

+
  “app-fip-priority”         gint
+

+

Flags: Read / Write / Construct

+

Allowed values: [-1,7]

+

Default value: -1

+
+
+
+

The “app-iscsi-flags” property

+
  “app-iscsi-flags”          NMSettingDcbFlags
+

+

Flags: Read / Write

+
+
+
+

The “app-iscsi-priority” property

+
  “app-iscsi-priority”       gint
+

+

Flags: Read / Write / Construct

+

Allowed values: [-1,7]

+

Default value: -1

+
+
+
+

The “priority-bandwidth” property

+
  “priority-bandwidth”       GArray *
+

+

Flags: Read / Write

+
+
+
+

The “priority-flow-control” property

+
  “priority-flow-control”    GArray *
+

+

Flags: Read / Write

+
+
+
+

The “priority-flow-control-flags” property

+
  “priority-flow-control-flags” NMSettingDcbFlags
+

+

Flags: Read / Write

+
+
+
+

The “priority-group-bandwidth” property

+
  “priority-group-bandwidth” GArray *
+

+

Flags: Read / Write

+
+
+
+

The “priority-group-flags” property

+
  “priority-group-flags”     NMSettingDcbFlags
+

+

Flags: Read / Write

+
+
+
+

The “priority-group-id” property

+
  “priority-group-id”        GArray *
+

+

Flags: Read / Write

+
+
+
+

The “priority-strict-bandwidth” property

+
  “priority-strict-bandwidth” GArray *
+

+

Flags: Read / Write

+
+
+
+

The “priority-traffic-class” property

+
  “priority-traffic-class”   GArray *
+

+

Flags: Read / Write

+
+
+ Generated by GTK-Doc V1.21 \ No newline at end of file diff --git a/docs/libnm/html/NMSettingGeneric.html b/docs/libnm/html/NMSettingGeneric.html index 1ade9b46..13bf6b87 100644 --- a/docs/libnm/html/NMSettingGeneric.html +++ b/docs/libnm/html/NMSettingGeneric.html @@ -2,32 +2,27 @@ -NMSettingGeneric +libnm Reference Manual: NMSettingGeneric - + - - - - - - - - - - + + + + + + +
@@ -35,85 +30,80 @@

NMSettingGeneric

NMSettingGeneric — Describes connection properties for generic devices

- +
-
-

Synopsis

-
#define             NM_SETTING_GENERIC_SETTING_NAME
-struct              NMSettingGeneric;
-                    NMSettingGenericClass;
-NMSetting *         nm_setting_generic_new              (void);
-
+
+

Functions

+
++++ + + + + +
+NMSetting * + +nm_setting_generic_new () +
+
+
+

Types and Values

+
++++ + + + + +
#defineNM_SETTING_GENERIC_SETTING_NAME

Object Hierarchy

-
-  GObject
-   +----NMSetting
-         +----NMSettingGeneric
+
    GObject
+    ╰── NMSetting
+        ╰── NMSettingGeneric
 

Description

-

-The NMSettingGeneric object is a NMSetting subclass that describes +

The NMSettingGeneric object is a NMSetting subclass that describes optional properties that apply to "generic" devices (ie, devices that -NetworkManager does not specifically recognize). -

-

-There are currently no properties on this object; it exists only to be -the "connection type" setting on NMConnections for generic devices. -

+NetworkManager does not specifically recognize).

+

There are currently no properties on this object; it exists only to be +the "connection type" setting on NMConnections for generic devices.

-

Details

+

Functions

-

NM_SETTING_GENERIC_SETTING_NAME

-
#define NM_SETTING_GENERIC_SETTING_NAME "generic"
-
-

-

+

nm_setting_generic_new ()

+
NMSetting *
+nm_setting_generic_new (void);
+

Creates a new NMSettingGeneric object with default values.

+
+

Returns

+

the new empty NMSettingGeneric object.

+

[transfer full]

-
-
-

struct NMSettingGeneric

-
struct NMSettingGeneric;
-

-

-
-
-

NMSettingGenericClass

-
typedef struct {
-	NMSettingClass parent;
-} NMSettingGenericClass;
-
-

-

-
+
+

Types and Values

-

nm_setting_generic_new ()

-
NMSetting *         nm_setting_generic_new              (void);
+

NM_SETTING_GENERIC_SETTING_NAME

+
#define NM_SETTING_GENERIC_SETTING_NAME "generic"
+

-Creates a new NMSettingGeneric object with default values.

-
---- - - - - -

Returns :

the new empty NMSettingGeneric object. [transfer full] -
+ Generated by GTK-Doc V1.21
\ No newline at end of file diff --git a/docs/libnm/html/NMSettingGsm.html b/docs/libnm/html/NMSettingGsm.html index f3bd95cd..2da1fa2e 100644 --- a/docs/libnm/html/NMSettingGsm.html +++ b/docs/libnm/html/NMSettingGsm.html @@ -2,34 +2,28 @@ -NMSettingGsm +libnm Reference Manual: NMSettingGsm - + - - - - - - - - - - + + + + + + +
@@ -37,66 +31,470 @@

NMSettingGsm

NMSettingGsm — Describes GSM/3GPP-based mobile broadband properties

- +
-
-

Object Hierarchy

-
-  GObject
-   +----NMSetting
-         +----NMSettingGsm
-
+

Functions

+
++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+NMSetting * + +nm_setting_gsm_new () +
const char * + +nm_setting_gsm_get_number () +
const char * + +nm_setting_gsm_get_username () +
const char * + +nm_setting_gsm_get_password () +
const char * + +nm_setting_gsm_get_apn () +
const char * + +nm_setting_gsm_get_network_id () +
const char * + +nm_setting_gsm_get_pin () +
+gboolean + +nm_setting_gsm_get_home_only () +
+NMSettingSecretFlags + +nm_setting_gsm_get_pin_flags () +
+NMSettingSecretFlags + +nm_setting_gsm_get_password_flags () +

Properties

-
-  "apn"                      gchar*                : Read / Write
-  "home-only"                gboolean              : Read / Write
-  "network-id"               gchar*                : Read / Write
-  "number"                   gchar*                : Read / Write
-  "password"                 gchar*                : Read / Write
-  "password-flags"           NMSettingSecretFlags  : Read / Write
-  "pin"                      gchar*                : Read / Write
-  "pin-flags"                NMSettingSecretFlags  : Read / Write
-  "username"                 gchar*                : Read / Write
+
+++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+gchar *apnRead / Write
gbooleanhome-onlyRead / Write
+gchar *network-idRead / Write
+gchar *numberRead / Write
+gchar *passwordRead / Write
NMSettingSecretFlagspassword-flagsRead / Write
+gchar *pinRead / Write
NMSettingSecretFlagspin-flagsRead / Write
+gchar *usernameRead / Write
+
+
+

Types and Values

+
++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
#defineNM_SETTING_GSM_SETTING_NAME
#defineNM_SETTING_GSM_NUMBER
#defineNM_SETTING_GSM_USERNAME
#defineNM_SETTING_GSM_PASSWORD
#defineNM_SETTING_GSM_PASSWORD_FLAGS
#defineNM_SETTING_GSM_APN
#defineNM_SETTING_GSM_NETWORK_ID
#defineNM_SETTING_GSM_PIN
#defineNM_SETTING_GSM_PIN_FLAGS
#defineNM_SETTING_GSM_HOME_ONLY
+
+
+

Object Hierarchy

+
    GObject
+    ╰── NMSetting
+        ╰── NMSettingGsm
 

Description

-

-The NMSettingGsm object is a NMSetting subclass that describes +

The NMSettingGsm object is a NMSetting subclass that describes properties that allow connections to 3GPP-based mobile broadband -networks, including those using GPRS/EDGE and UMTS/HSPA technology. -

+networks, including those using GPRS/EDGE and UMTS/HSPA technology.

-

Details

+

Functions

+
+

nm_setting_gsm_new ()

+
NMSetting *
+nm_setting_gsm_new (void);
+

Creates a new NMSettingGsm object with default values.

+
+

Returns

+

the new empty NMSettingGsm object

+

+
+
+
+
+

nm_setting_gsm_get_number ()

+
const char *
+nm_setting_gsm_get_number (NMSettingGsm *setting);
+
+

Parameters

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

setting

the NMSettingGsm

 
+
+
+

Returns

+

the “number” property of the setting

+

+
+
+
+
+

nm_setting_gsm_get_username ()

+
const char *
+nm_setting_gsm_get_username (NMSettingGsm *setting);
+
+

Parameters

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

setting

the NMSettingGsm

 
+
+
+

Returns

+

the “username” property of the setting

+

+
+
+
+
+

nm_setting_gsm_get_password ()

+
const char *
+nm_setting_gsm_get_password (NMSettingGsm *setting);
+
+

Parameters

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

setting

the NMSettingGsm

 
+
+
+

Returns

+

the “password” property of the setting

+

+
+
+
+
+

nm_setting_gsm_get_apn ()

+
const char *
+nm_setting_gsm_get_apn (NMSettingGsm *setting);
+
+

Parameters

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

setting

the NMSettingGsm

 
+
+
+

Returns

+

the “apn” property of the setting

+

+
+
+
+
+

nm_setting_gsm_get_network_id ()

+
const char *
+nm_setting_gsm_get_network_id (NMSettingGsm *setting);
+
+

Parameters

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

setting

the NMSettingGsm

 
+
+
+

Returns

+

the “network-id” property of the setting

+

+
+
+
+
+

nm_setting_gsm_get_pin ()

+
const char *
+nm_setting_gsm_get_pin (NMSettingGsm *setting);
+
+

Parameters

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

setting

the NMSettingGsm

 
+
+
+

Returns

+

the “pin” property of the setting

+

+
+
+
+
+

nm_setting_gsm_get_home_only ()

+
gboolean
+nm_setting_gsm_get_home_only (NMSettingGsm *setting);
+
+

Parameters

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

setting

the NMSettingGsm

 
+
+
+

Returns

+

the “home-only” property of the setting

+

+
+
+
+
+

nm_setting_gsm_get_pin_flags ()

+
NMSettingSecretFlags
+nm_setting_gsm_get_pin_flags (NMSettingGsm *setting);
+
+

Parameters

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

setting

the NMSettingGsm

 
+
+
+

Returns

+

the NMSettingSecretFlags pertaining to the “pin”

+

+
+
+
+
+

nm_setting_gsm_get_password_flags ()

+
NMSettingSecretFlags
+nm_setting_gsm_get_password_flags (NMSettingGsm *setting);
+
+

Parameters

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

setting

the NMSettingGsm

 
+
+
+

Returns

+

the NMSettingSecretFlags pertaining to the “password”

+

+
+
+
+
+

Types and Values

NM_SETTING_GSM_SETTING_NAME

#define NM_SETTING_GSM_SETTING_NAME "gsm"
@@ -176,346 +574,82 @@ networks, including those using GPRS/EDGE and UMTS/HSPA technology.
 

-
-
-

struct NMSettingGsm

-
struct NMSettingGsm;
-

-

-
-
-
-

NMSettingGsmClass

-
typedef struct {
-	NMSettingClass parent;
-} NMSettingGsmClass;
-
-

-

-
-
-
-

nm_setting_gsm_new ()

-
NMSetting *         nm_setting_gsm_new                  (void);
-

-Creates a new NMSettingGsm object with default values. -

-
---- - - - - -

Returns :

the new empty NMSettingGsm object
-
-
-
-

nm_setting_gsm_get_number ()

-
const char *        nm_setting_gsm_get_number           (NMSettingGsm *setting);
-
---- - - - - - - - - - - -

setting :

the NMSettingGsm -

Returns :

the "number" property of the setting
-
-
-
-

nm_setting_gsm_get_username ()

-
const char *        nm_setting_gsm_get_username         (NMSettingGsm *setting);
-
---- - - - - - - - - - - -

setting :

the NMSettingGsm -

Returns :

the "username" property of the setting
-
-
-
-

nm_setting_gsm_get_password ()

-
const char *        nm_setting_gsm_get_password         (NMSettingGsm *setting);
-
---- - - - - - - - - - - -

setting :

the NMSettingGsm -

Returns :

the "password" property of the setting
-
-
-
-

nm_setting_gsm_get_apn ()

-
const char *        nm_setting_gsm_get_apn              (NMSettingGsm *setting);
-
---- - - - - - - - - - - -

setting :

the NMSettingGsm -

Returns :

the "apn" property of the setting
-
-
-
-

nm_setting_gsm_get_network_id ()

-
const char *        nm_setting_gsm_get_network_id       (NMSettingGsm *setting);
-
---- - - - - - - - - - - -

setting :

the NMSettingGsm -

Returns :

the "network-id" property of the setting
-
-
-
-

nm_setting_gsm_get_pin ()

-
const char *        nm_setting_gsm_get_pin              (NMSettingGsm *setting);
-
---- - - - - - - - - - - -

setting :

the NMSettingGsm -

Returns :

the "pin" property of the setting
-
-
-
-

nm_setting_gsm_get_home_only ()

-
gboolean            nm_setting_gsm_get_home_only        (NMSettingGsm *setting);
-
---- - - - - - - - - - - -

setting :

the NMSettingGsm -

Returns :

the "home-only" property of the setting
-
-
-
-

nm_setting_gsm_get_pin_flags ()

-
NMSettingSecretFlags nm_setting_gsm_get_pin_flags       (NMSettingGsm *setting);
-
---- - - - - - - - - - - -

setting :

the NMSettingGsm -

Returns :

the NMSettingSecretFlags pertaining to the "pin" -
-
-
-
-

nm_setting_gsm_get_password_flags ()

-
NMSettingSecretFlags nm_setting_gsm_get_password_flags  (NMSettingGsm *setting);
-
---- - - - - - - - - - - -

setting :

the NMSettingGsm -

Returns :

the NMSettingSecretFlags pertaining to the "password" -
-

Property Details

-

The "apn" property

-
  "apn"                      gchar*                : Read / Write
-

-The GPRS Access Point Name specifying the APN used when establishing a -data session with the GSM-based network. The APN often determines how -the user will be billed for their network usage and whether the user has -access to the Internet or just a provider-specific walled-garden, so it -is important to use the correct APN for the user's mobile broadband plan. -The APN may only be composed of the characters a-z, 0-9, ., and - per GSM -03.60 Section 14.9. -

+

The “apn” property

+
  “apn”                      gchar *
+

+

Flags: Read / Write

Default value: NULL


-

The "home-only" property

-
  "home-only"                gboolean              : Read / Write
-

-When TRUE, only connections to the home network will be allowed. -Connections to roaming networks will not be made. -

+

The “home-only” property

+
  “home-only”                gboolean
+

+

Flags: Read / Write

Default value: FALSE


-

The "network-id" property

-
  "network-id"               gchar*                : Read / Write
-

-The Network ID (GSM LAI format, ie MCC-MNC) to force specific network -registration. If the Network ID is specified, NetworkManager will -attempt to force the device to register only on the specified network. -This can be used to ensure that the device does not roam when direct -roaming control of the device is not otherwise possible. -

+

The “network-id” property

+
  “network-id”               gchar *
+

+

Flags: Read / Write

Default value: NULL


-

The "number" property

-
  "number"                   gchar*                : Read / Write
-

-Number to dial when establishing a PPP data session with the GSM-based -mobile broadband network. Many modems do not require PPP for connections -to the mobile network and thus this property should be left blank, which -allows NetworkManager to select the appropriate settings automatically. -

+

The “number” property

+
  “number”                   gchar *
+

+

Flags: Read / Write

Default value: NULL


-

The "password" property

-
  "password"                 gchar*                : Read / Write
-

-The password used to authenticate with the network, if required. Many -providers do not require a password, or accept any password. But if a -password is required, it is specified here. -

+

The “password” property

+
  “password”                 gchar *
+

+

Flags: Read / Write

Default value: NULL


-

The "password-flags" property

-
  "password-flags"           NMSettingSecretFlags  : Read / Write
-

-Flags indicating how to handle the "password" property. -

+

The “password-flags” property

+
  “password-flags”           NMSettingSecretFlags
+

+

Flags: Read / Write


-

The "pin" property

-
  "pin"                      gchar*                : Read / Write
-

-If the SIM is locked with a PIN it must be unlocked before any other -operations are requested. Specify the PIN here to allow operation of the -device. -

+

The “pin” property

+
  “pin”                      gchar *
+

+

Flags: Read / Write

Default value: NULL


-

The "pin-flags" property

-
  "pin-flags"                NMSettingSecretFlags  : Read / Write
-

-Flags indicating how to handle the "pin" property. -

+

The “pin-flags” property

+
  “pin-flags”                NMSettingSecretFlags
+

+

Flags: Read / Write


-

The "username" property

-
  "username"                 gchar*                : Read / Write
-

-The username used to authenticate with the network, if required. Many -providers do not require a username, or accept any username. But if a -username is required, it is specified here. -

+

The “username” property

+
  “username”                 gchar *
+

+

Flags: Read / Write

Default value: NULL

+ Generated by GTK-Doc V1.21
\ No newline at end of file diff --git a/docs/libnm/html/NMSettingIP4Config.html b/docs/libnm/html/NMSettingIP4Config.html index cb7542b8..95b3dc6d 100644 --- a/docs/libnm/html/NMSettingIP4Config.html +++ b/docs/libnm/html/NMSettingIP4Config.html @@ -2,34 +2,28 @@ -NMSettingIP4Config +libnm Reference Manual: NMSettingIP4Config - + - - - - - - - - - - + + + + + + +
@@ -37,51 +31,104 @@

NMSettingIP4Config

NMSettingIP4Config — Describes IPv4 addressing, routing, and name service properties

- +
-
-

Object Hierarchy

-
-  GObject
-   +----NMSetting
-         +----NMSettingIPConfig
-               +----NMSettingIP4Config
-
+

Functions

+
++++ + + + + + + + + + + +
+NMSetting * + +nm_setting_ip4_config_new () +
const char * + +nm_setting_ip4_config_get_dhcp_client_id () +

Properties

-
-  "dhcp-client-id"           gchar*                : Read / Write
+
+++++ + + + + + +
+gchar *dhcp-client-idRead / Write
+
+ +
+

Object Hierarchy

+
    GObject
+    ╰── NMSetting
+        ╰── NMSettingIPConfig
+            ╰── NMSettingIP4Config
 

Description

-

-The NMSettingIP4Config object is a NMSetting subclass that describes -properties related to IPv4 addressing, routing, and Domain Name Service. -

-

-NMSettingIP4Config has few properties or methods of its own; it inherits -almost everything from NMSettingIPConfig. -

-

-NetworkManager supports 5 values for the "method" property +

The NMSettingIP4Config object is a NMSetting subclass that describes +properties related to IPv4 addressing, routing, and Domain Name Service.

+

NMSettingIP4Config has few properties or methods of its own; it inherits +almost everything from NMSettingIPConfig.

+

NetworkManager supports 5 values for the “method” property for IPv4. If "auto" is specified then the appropriate automatic method (DHCP, PPP, etc) is used for the interface and most other properties can be left unset. If "link-local" is specified, then a link-local address in the @@ -92,11 +139,54 @@ this connection will provide network access to other computers) then the interface is assigned an address in the 10.42.x.1/24 range and a DHCP and forwarding DNS server are started, and the interface is NAT-ed to the current default network connection. "disabled" means IPv4 will not be used on this -connection. -

+connection.

+
+
+

Functions

+
+

nm_setting_ip4_config_new ()

+
NMSetting *
+nm_setting_ip4_config_new (void);
+

Creates a new NMSettingIP4Config object with default values.

+
+

Returns

+

the new empty NMSettingIP4Config object.

+

[transfer full]

+
+
+
+
+

nm_setting_ip4_config_get_dhcp_client_id ()

+
const char *
+nm_setting_ip4_config_get_dhcp_client_id
+                               (NMSettingIP4Config *setting);
+

Returns the value contained in the “dhcp-client-id” +property.

+
+

Parameters

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

setting

the NMSettingIP4Config

 
+
+
+

Returns

+

the configured Client ID to send to the DHCP server when requesting +addresses via DHCP.

+

+
+
-

Details

+

Types and Values

NM_SETTING_IP4_CONFIG_SETTING_NAME

#define NM_SETTING_IP4_CONFIG_SETTING_NAME "ipv4"
@@ -117,135 +207,59 @@ connection.
 

NM_SETTING_IP4_CONFIG_METHOD_AUTO

#define NM_SETTING_IP4_CONFIG_METHOD_AUTO       "auto"
 
-

-IPv4 configuration should be automatically determined via a method appropriate +

IPv4 configuration should be automatically determined via a method appropriate for the hardware interface, ie DHCP or PPP or some other device-specific -manner. -

+manner.


NM_SETTING_IP4_CONFIG_METHOD_LINK_LOCAL

#define NM_SETTING_IP4_CONFIG_METHOD_LINK_LOCAL "link-local"
 
-

-IPv4 configuration should be automatically configured for link-local-only -operation. -

+

IPv4 configuration should be automatically configured for link-local-only +operation.


NM_SETTING_IP4_CONFIG_METHOD_MANUAL

#define NM_SETTING_IP4_CONFIG_METHOD_MANUAL     "manual"
 
-

-All necessary IPv4 configuration (addresses, prefix, DNS, etc) is specified -in the setting's properties. -

+

All necessary IPv4 configuration (addresses, prefix, DNS, etc) is specified +in the setting's properties.


NM_SETTING_IP4_CONFIG_METHOD_SHARED

#define NM_SETTING_IP4_CONFIG_METHOD_SHARED     "shared"
 
-

-This connection specifies configuration that allows other computers to +

This connection specifies configuration that allows other computers to connect through it to the default network (usually the Internet). The connection's interface will be assigned a private address, and a DHCP server, caching DNS server, and Network Address Translation (NAT) functionality will be started on this connection's interface to allow other devices to connect -through that interface to the default network. -

+through that interface to the default network.


NM_SETTING_IP4_CONFIG_METHOD_DISABLED

#define NM_SETTING_IP4_CONFIG_METHOD_DISABLED   "disabled"
 
-

-This connection does not use or require IPv4 address and it should be disabled. -

-
-
-
-

struct NMSettingIP4Config

-
struct NMSettingIP4Config;
-

-

-
-
-
-

NMSettingIP4ConfigClass

-
typedef struct {
-	NMSettingIPConfigClass parent;
-} NMSettingIP4ConfigClass;
-
-

-

-
-
-
-

nm_setting_ip4_config_new ()

-
NMSetting *         nm_setting_ip4_config_new           (void);
-

-Creates a new NMSettingIP4Config object with default values. -

-
---- - - - - -

Returns :

the new empty NMSettingIP4Config object. [transfer full] -
-
-
-
-

nm_setting_ip4_config_get_dhcp_client_id ()

-
const char *        nm_setting_ip4_config_get_dhcp_client_id
-                                                        (NMSettingIP4Config *setting);
-

-Returns the value contained in the "dhcp-client-id" -property. -

-
---- - - - - - - - - - - -

setting :

the NMSettingIP4Config -

Returns :

the configured Client ID to send to the DHCP server when requesting -addresses via DHCP.
+

This connection does not use or require IPv4 address and it should be disabled.

Property Details

-

The "dhcp-client-id" property

-
  "dhcp-client-id"           gchar*                : Read / Write
-

-A string sent to the DHCP server to identify the local machine which the -DHCP server may use to customize the DHCP lease and options. -

+

The “dhcp-client-id” property

+
  “dhcp-client-id”           gchar *
+

+

Flags: Read / Write

Default value: NULL

+ Generated by GTK-Doc V1.21
\ No newline at end of file diff --git a/docs/libnm/html/NMSettingIP6Config.html b/docs/libnm/html/NMSettingIP6Config.html index c5640b40..75c33f7f 100644 --- a/docs/libnm/html/NMSettingIP6Config.html +++ b/docs/libnm/html/NMSettingIP6Config.html @@ -2,34 +2,28 @@ -NMSettingIP6Config +libnm Reference Manual: NMSettingIP6Config - + - - - - - - - - - - + + + + + + +
@@ -37,57 +31,114 @@

NMSettingIP6Config

NMSettingIP6Config — Describes IPv6 addressing, routing, and name service properties

- +
-
-

Object Hierarchy

-
-  GEnum
-   +----NMSettingIP6ConfigPrivacy
-
-
-  GObject
-   +----NMSetting
-         +----NMSettingIPConfig
-               +----NMSettingIP6Config
-
+

Functions

+

Properties

-
-  "ip6-privacy"              NMSettingIP6ConfigPrivacy  : Read / Write / Construct
+
+++++ + + + + + +
NMSettingIP6ConfigPrivacyip6-privacyRead / Write / Construct
+
+ +
+

Object Hierarchy

+
    GEnum
+    ╰── NMSettingIP6ConfigPrivacy
+    GObject
+    ╰── NMSetting
+        ╰── NMSettingIPConfig
+            ╰── NMSettingIP6Config
 

Description

-

-The NMSettingIP6Config object is a NMSetting subclass that describes -properties related to IPv6 addressing, routing, and Domain Name Service -

-

-NMSettingIP6Config has few properties or methods of its own; it inherits -almost everything from NMSettingIPConfig. -

-

-NetworkManager supports 6 values for the "method" property +

The NMSettingIP6Config object is a NMSetting subclass that describes +properties related to IPv6 addressing, routing, and Domain Name Service

+

NMSettingIP6Config has few properties or methods of its own; it inherits +almost everything from NMSettingIPConfig.

+

NetworkManager supports 6 values for the “method” property for IPv6. If "auto" is specified then the appropriate automatic method (PPP, router advertisement, etc) is used for the device and most other properties can be left unset. To force the use of DHCP only, specify "dhcp"; this @@ -96,11 +147,52 @@ specified, then an IPv6 link-local address will be assigned to the interface. If "manual" is specified, static IP addressing is used and at least one IP address must be given in the "addresses" property. If "ignore" is specified, IPv6 configuration is not done. Note: the "shared" method is not yet -supported. -

+supported.

-

Details

+

Functions

+
+

nm_setting_ip6_config_new ()

+
NMSetting *
+nm_setting_ip6_config_new (void);
+

Creates a new NMSettingIP6Config object with default values.

+
+

Returns

+

the new empty NMSettingIP6Config object.

+

[transfer full]

+
+
+
+
+

nm_setting_ip6_config_get_ip6_privacy ()

+
NMSettingIP6ConfigPrivacy
+nm_setting_ip6_config_get_ip6_privacy (NMSettingIP6Config *setting);
+

Returns the value contained in the “ip6-privacy” +property.

+
+

Parameters

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

setting

the NMSettingIP6Config

 
+
+
+

Returns

+

IPv6 Privacy Extensions configuration value (NMSettingIP6ConfigPrivacy).

+

+
+
+
+
+

Types and Values

NM_SETTING_IP6_CONFIG_SETTING_NAME

#define NM_SETTING_IP6_CONFIG_SETTING_NAME "ipv6"
@@ -121,196 +213,117 @@ supported.
 

NM_SETTING_IP6_CONFIG_METHOD_IGNORE

#define NM_SETTING_IP6_CONFIG_METHOD_IGNORE     "ignore"
 
-

-IPv6 is not required or is handled by some other mechanism, and NetworkManager -should not configure IPv6 for this connection. -

+

IPv6 is not required or is handled by some other mechanism, and NetworkManager +should not configure IPv6 for this connection.


NM_SETTING_IP6_CONFIG_METHOD_AUTO

#define NM_SETTING_IP6_CONFIG_METHOD_AUTO       "auto"
 
-

-IPv6 configuration should be automatically determined via a method appropriate +

IPv6 configuration should be automatically determined via a method appropriate for the hardware interface, ie router advertisements, DHCP, or PPP or some -other device-specific manner. -

+other device-specific manner.


NM_SETTING_IP6_CONFIG_METHOD_DHCP

#define NM_SETTING_IP6_CONFIG_METHOD_DHCP       "dhcp"
 
-

-IPv6 configuration should be automatically determined via DHCPv6 only and -router advertisements should be ignored. -

+

IPv6 configuration should be automatically determined via DHCPv6 only and +router advertisements should be ignored.


NM_SETTING_IP6_CONFIG_METHOD_LINK_LOCAL

#define NM_SETTING_IP6_CONFIG_METHOD_LINK_LOCAL "link-local"
 
-

-IPv6 configuration should be automatically configured for link-local-only -operation. -

+

IPv6 configuration should be automatically configured for link-local-only +operation.


NM_SETTING_IP6_CONFIG_METHOD_MANUAL

#define NM_SETTING_IP6_CONFIG_METHOD_MANUAL     "manual"
 
-

-All necessary IPv6 configuration (addresses, prefix, DNS, etc) is specified -in the setting's properties. -

+

All necessary IPv6 configuration (addresses, prefix, DNS, etc) is specified +in the setting's properties.


NM_SETTING_IP6_CONFIG_METHOD_SHARED

#define NM_SETTING_IP6_CONFIG_METHOD_SHARED     "shared"
 
-

-This connection specifies configuration that allows other computers to +

This connection specifies configuration that allows other computers to connect through it to the default network (usually the Internet). The connection's interface will be assigned a private address, and router advertisements, a caching DNS server, and Network Address Translation (NAT) functionality will be started on this connection's interface to allow other devices to connect through that interface to the default network. (not yet -supported for IPv6) -

+supported for IPv6)


-

enum NMSettingIP6ConfigPrivacy

-
typedef enum {
-	NM_SETTING_IP6_CONFIG_PRIVACY_UNKNOWN = -1,
-	NM_SETTING_IP6_CONFIG_PRIVACY_DISABLED = 0,
-	NM_SETTING_IP6_CONFIG_PRIVACY_PREFER_PUBLIC_ADDR = 1,
-	NM_SETTING_IP6_CONFIG_PRIVACY_PREFER_TEMP_ADDR = 2
-} NMSettingIP6ConfigPrivacy;
-
-

-NMSettingIP6ConfigPrivacy values indicate if and how IPv6 Privacy -Extensions are used (RFC4941). -

-
+

enum NMSettingIP6ConfigPrivacy

+

NMSettingIP6ConfigPrivacy values indicate if and how IPv6 Privacy +Extensions are used (RFC4941).

+
+

Members

+
--+++ - - + + - - + + - - + + - - + +

NM_SETTING_IP6_CONFIG_PRIVACY_UNKNOWN

unknown or no value specified +

NM_SETTING_IP6_CONFIG_PRIVACY_UNKNOWN

+

unknown or no value specified

 

NM_SETTING_IP6_CONFIG_PRIVACY_DISABLED

IPv6 Privacy Extensions are disabled +

NM_SETTING_IP6_CONFIG_PRIVACY_DISABLED

+

IPv6 Privacy Extensions are disabled

 

NM_SETTING_IP6_CONFIG_PRIVACY_PREFER_PUBLIC_ADDR

IPv6 Privacy Extensions -are enabled, but public addresses are preferred over temporary addresses +

NM_SETTING_IP6_CONFIG_PRIVACY_PREFER_PUBLIC_ADDR

+

IPv6 Privacy Extensions +are enabled, but public addresses are preferred over temporary addresses

 

NM_SETTING_IP6_CONFIG_PRIVACY_PREFER_TEMP_ADDR

IPv6 Privacy Extensions -are enabled and temporary addresses are preferred over public addresses +

NM_SETTING_IP6_CONFIG_PRIVACY_PREFER_TEMP_ADDR

+

IPv6 Privacy Extensions +are enabled and temporary addresses are preferred over public addresses

 
-
-
-

struct NMSettingIP6Config

-
struct NMSettingIP6Config;
-

-

-
-
-
-

NMSettingIP6ConfigClass

-
typedef struct {
-	NMSettingIPConfigClass parent;
-} NMSettingIP6ConfigClass;
-
-

-

-
-
-
-

nm_setting_ip6_config_new ()

-
NMSetting *         nm_setting_ip6_config_new           (void);
-

-Creates a new NMSettingIP6Config object with default values. -

-
---- - - - - -

Returns :

the new empty NMSettingIP6Config object. [transfer full] -
-
-
-
-

nm_setting_ip6_config_get_ip6_privacy ()

-
NMSettingIP6ConfigPrivacy nm_setting_ip6_config_get_ip6_privacy
-                                                        (NMSettingIP6Config *setting);
-

-Returns the value contained in the "ip6-privacy" -property. -

-
---- - - - - - - - - - - -

setting :

the NMSettingIP6Config -

Returns :

IPv6 Privacy Extensions configuration value (NMSettingIP6ConfigPrivacy).

Property Details

-

The "ip6-privacy" property

-
  "ip6-privacy"              NMSettingIP6ConfigPrivacy  : Read / Write / Construct
-

-Configure IPv6 Privacy Extensions for SLAAC, described in RFC4941. If -enabled, it makes the kernel generate a temporary IPv6 address in -addition to the public one generated from MAC address via modified -EUI-64. This enhances privacy, but could cause problems in some -applications, on the other hand. The permitted values are: 0: disabled, -1: enabled (prefer public address), 2: enabled (prefer temporary -addresses). -

+

The “ip6-privacy” property

+
  “ip6-privacy”              NMSettingIP6ConfigPrivacy
+

+

Flags: Read / Write / Construct

Default value: NM_SETTING_IP6_CONFIG_PRIVACY_UNKNOWN

+ Generated by GTK-Doc V1.21 \ No newline at end of file diff --git a/docs/libnm/html/NMSettingIPConfig.html b/docs/libnm/html/NMSettingIPConfig.html index 413c392a..ae386b27 100644 --- a/docs/libnm/html/NMSettingIPConfig.html +++ b/docs/libnm/html/NMSettingIPConfig.html @@ -2,34 +2,28 @@ -NMSettingIPConfig +libnm Reference Manual: NMSettingIPConfig - + - - - - - - - - - - + + + + + + +
@@ -38,2543 +32,3261 @@

NMSettingIPConfig — Abstract base class for IPv4 and IPv6 addressing, routing, and name service properties

- +
-
-

Synopsis

-
-#include <nm-setting-ip-config.h>
-
-typedef             NMIPAddress;
-NMIPAddress *       nm_ip_address_new                   (int family,
-                                                         const char *addr,
-                                                         guint prefix,
-                                                         GError **error);
-NMIPAddress *       nm_ip_address_new_binary            (int family,
-                                                         gconstpointer addr,
-                                                         guint prefix,
-                                                         GError **error);
-void                nm_ip_address_ref                   (NMIPAddress *address);
-void                nm_ip_address_unref                 (NMIPAddress *address);
-gboolean            nm_ip_address_equal                 (NMIPAddress *address,
-                                                         NMIPAddress *other);
-NMIPAddress *       nm_ip_address_dup                   (NMIPAddress *address);
-int                 nm_ip_address_get_family            (NMIPAddress *address);
-const char *        nm_ip_address_get_address           (NMIPAddress *address);
-void                nm_ip_address_set_address           (NMIPAddress *address,
-                                                         const char *addr);
-void                nm_ip_address_get_address_binary    (NMIPAddress *address,
-                                                         gpointer addr);
-void                nm_ip_address_set_address_binary    (NMIPAddress *address,
-                                                         gconstpointer addr);
-guint               nm_ip_address_get_prefix            (NMIPAddress *address);
-void                nm_ip_address_set_prefix            (NMIPAddress *address,
-                                                         guint prefix);
-char **             nm_ip_address_get_attribute_names   (NMIPAddress *address);
-GVariant *          nm_ip_address_get_attribute         (NMIPAddress *address,
-                                                         const char *name);
-void                nm_ip_address_set_attribute         (NMIPAddress *address,
-                                                         const char *name,
-                                                         GVariant *value);
-typedef             NMIPRoute;
-NMIPRoute *         nm_ip_route_new                     (int family,
-                                                         const char *dest,
-                                                         guint prefix,
-                                                         const char *next_hop,
-                                                         gint64 metric,
-                                                         GError **error);
-NMIPRoute *         nm_ip_route_new_binary              (int family,
-                                                         gconstpointer dest,
-                                                         guint prefix,
-                                                         gconstpointer next_hop,
-                                                         gint64 metric,
-                                                         GError **error);
-void                nm_ip_route_ref                     (NMIPRoute *route);
-void                nm_ip_route_unref                   (NMIPRoute *route);
-gboolean            nm_ip_route_equal                   (NMIPRoute *route,
-                                                         NMIPRoute *other);
-NMIPRoute *         nm_ip_route_dup                     (NMIPRoute *route);
-int                 nm_ip_route_get_family              (NMIPRoute *route);
-const char *        nm_ip_route_get_dest                (NMIPRoute *route);
-void                nm_ip_route_set_dest                (NMIPRoute *route,
-                                                         const char *dest);
-void                nm_ip_route_get_dest_binary         (NMIPRoute *route,
-                                                         gpointer dest);
-void                nm_ip_route_set_dest_binary         (NMIPRoute *route,
-                                                         gconstpointer dest);
-guint               nm_ip_route_get_prefix              (NMIPRoute *route);
-void                nm_ip_route_set_prefix              (NMIPRoute *route,
-                                                         guint prefix);
-const char *        nm_ip_route_get_next_hop            (NMIPRoute *route);
-void                nm_ip_route_set_next_hop            (NMIPRoute *route,
-                                                         const char *next_hop);
-gboolean            nm_ip_route_get_next_hop_binary     (NMIPRoute *route,
-                                                         gpointer next_hop);
-void                nm_ip_route_set_next_hop_binary     (NMIPRoute *route,
-                                                         gconstpointer next_hop);
-gint64              nm_ip_route_get_metric              (NMIPRoute *route);
-void                nm_ip_route_set_metric              (NMIPRoute *route,
-                                                         gint64 metric);
-char **             nm_ip_route_get_attribute_names     (NMIPRoute *route);
-GVariant *          nm_ip_route_get_attribute           (NMIPRoute *route,
-                                                         const char *name);
-void                nm_ip_route_set_attribute           (NMIPRoute *route,
-                                                         const char *name,
-                                                         GVariant *value);
-#define             NM_SETTING_IP_CONFIG_METHOD
-#define             NM_SETTING_IP_CONFIG_DNS
-#define             NM_SETTING_IP_CONFIG_DNS_SEARCH
-#define             NM_SETTING_IP_CONFIG_ADDRESSES
-#define             NM_SETTING_IP_CONFIG_GATEWAY
-#define             NM_SETTING_IP_CONFIG_ROUTES
-#define             NM_SETTING_IP_CONFIG_ROUTE_METRIC
-#define             NM_SETTING_IP_CONFIG_IGNORE_AUTO_ROUTES
-#define             NM_SETTING_IP_CONFIG_IGNORE_AUTO_DNS
-#define             NM_SETTING_IP_CONFIG_DHCP_HOSTNAME
-#define             NM_SETTING_IP_CONFIG_DHCP_SEND_HOSTNAME
-#define             NM_SETTING_IP_CONFIG_NEVER_DEFAULT
-#define             NM_SETTING_IP_CONFIG_MAY_FAIL
-struct              NMSettingIPConfig;
-                    NMSettingIPConfigClass;
-const char *        nm_setting_ip_config_get_method     (NMSettingIPConfig *setting);
-guint               nm_setting_ip_config_get_num_dns    (NMSettingIPConfig *setting);
-const char *        nm_setting_ip_config_get_dns        (NMSettingIPConfig *setting,
-                                                         int i);
-gboolean            nm_setting_ip_config_add_dns        (NMSettingIPConfig *setting,
-                                                         const char *dns);
-void                nm_setting_ip_config_remove_dns     (NMSettingIPConfig *setting,
-                                                         int i);
-gboolean            nm_setting_ip_config_remove_dns_by_value
-                                                        (NMSettingIPConfig *setting,
-                                                         const char *dns);
-void                nm_setting_ip_config_clear_dns      (NMSettingIPConfig *setting);
-guint               nm_setting_ip_config_get_num_dns_searches
-                                                        (NMSettingIPConfig *setting);
-const char *        nm_setting_ip_config_get_dns_search (NMSettingIPConfig *setting,
-                                                         int i);
-gboolean            nm_setting_ip_config_add_dns_search (NMSettingIPConfig *setting,
-                                                         const char *dns_search);
-void                nm_setting_ip_config_remove_dns_search
-                                                        (NMSettingIPConfig *setting,
-                                                         int i);
-gboolean            nm_setting_ip_config_remove_dns_search_by_value
-                                                        (NMSettingIPConfig *setting,
-                                                         const char *dns_search);
-void                nm_setting_ip_config_clear_dns_searches
-                                                        (NMSettingIPConfig *setting);
-guint               nm_setting_ip_config_get_num_addresses
-                                                        (NMSettingIPConfig *setting);
-NMIPAddress *       nm_setting_ip_config_get_address    (NMSettingIPConfig *setting,
-                                                         int i);
-gboolean            nm_setting_ip_config_add_address    (NMSettingIPConfig *setting,
-                                                         NMIPAddress *address);
-void                nm_setting_ip_config_remove_address (NMSettingIPConfig *setting,
-                                                         int i);
-gboolean            nm_setting_ip_config_remove_address_by_value
-                                                        (NMSettingIPConfig *setting,
-                                                         NMIPAddress *address);
-void                nm_setting_ip_config_clear_addresses
-                                                        (NMSettingIPConfig *setting);
-const char *        nm_setting_ip_config_get_gateway    (NMSettingIPConfig *setting);
-guint               nm_setting_ip_config_get_num_routes (NMSettingIPConfig *setting);
-NMIPRoute *         nm_setting_ip_config_get_route      (NMSettingIPConfig *setting,
-                                                         int i);
-gboolean            nm_setting_ip_config_add_route      (NMSettingIPConfig *setting,
-                                                         NMIPRoute *route);
-void                nm_setting_ip_config_remove_route   (NMSettingIPConfig *setting,
-                                                         int i);
-gboolean            nm_setting_ip_config_remove_route_by_value
-                                                        (NMSettingIPConfig *setting,
-                                                         NMIPRoute *route);
-void                nm_setting_ip_config_clear_routes   (NMSettingIPConfig *setting);
-gint64              nm_setting_ip_config_get_route_metric
-                                                        (NMSettingIPConfig *setting);
-gboolean            nm_setting_ip_config_get_ignore_auto_routes
-                                                        (NMSettingIPConfig *setting);
-gboolean            nm_setting_ip_config_get_ignore_auto_dns
-                                                        (NMSettingIPConfig *setting);
-const char *        nm_setting_ip_config_get_dhcp_hostname
-                                                        (NMSettingIPConfig *setting);
-gboolean            nm_setting_ip_config_get_dhcp_send_hostname
-                                                        (NMSettingIPConfig *setting);
-gboolean            nm_setting_ip_config_get_never_default
-                                                        (NMSettingIPConfig *setting);
-gboolean            nm_setting_ip_config_get_may_fail   (NMSettingIPConfig *setting);
-
-
-
-

Object Hierarchy

-
-  GBoxed
-   +----NMIPAddress
-
-
-  GBoxed
-   +----NMIPRoute
-
-
-  GObject
-   +----NMSetting
-         +----NMSettingIPConfig
-               +----NMSettingIP4Config
-               +----NMSettingIP6Config
-
-
-

Properties

-
-  "addresses"                GPtrArray*            : Read / Write
-  "dhcp-hostname"            gchar*                : Read / Write
-  "dhcp-send-hostname"       gboolean              : Read / Write / Construct
-  "dns"                      GStrv                 : Read / Write
-  "dns-search"               GStrv                 : Read / Write
-  "gateway"                  gchar*                : Read / Write
-  "ignore-auto-dns"          gboolean              : Read / Write / Construct
-  "ignore-auto-routes"       gboolean              : Read / Write / Construct
-  "may-fail"                 gboolean              : Read / Write / Construct
-  "method"                   gchar*                : Read / Write
-  "never-default"            gboolean              : Read / Write / Construct
-  "route-metric"             gint64                : Read / Write / Construct
-  "routes"                   GPtrArray*            : Read / Write
-
-
-
-

Description

-

-NMSettingIPConfig is the abstract base class of -NMSettingIP4Config and NMSettingIP6Config, providing properties -related to IP addressing, routing, and Domain Name Service. -

-
-
-

Details

-
-

NMIPAddress

-
typedef struct NMIPAddress NMIPAddress;
-
-

-

-
-
-
-

nm_ip_address_new ()

-
NMIPAddress *       nm_ip_address_new                   (int family,
-                                                         const char *addr,
-                                                         guint prefix,
-                                                         GError **error);
-

-Creates a new NMIPAddress object. -

-
+

Functions

+
--++ - - + + - - + + - - + + - - + - - + - -

family :

the IP address family (AF_INET or -AF_INET6) +NMIPAddress * + +nm_ip_address_new () +

addr :

the IP address +NMIPAddress * + +nm_ip_address_new_binary () +

prefix :

the address prefix length +void + +nm_ip_address_ref () +

error :

location to store error, or NULL + +void + +nm_ip_address_unref ()

Returns :

the new NMIPAddress object, or NULL on error. [transfer full] + +gboolean + +nm_ip_address_equal ()
-
-
-
-

nm_ip_address_new_binary ()

-
NMIPAddress *       nm_ip_address_new_binary            (int family,
-                                                         gconstpointer addr,
-                                                         guint prefix,
-                                                         GError **error);
-

-Creates a new NMIPAddress object. addr must point to a buffer of the -correct size for family. -

-
---- - - - + + - - + + - - + + - - + - - + - -

family :

the IP address family (AF_INET or -AF_INET6) +NMIPAddress * + +nm_ip_address_dup () +

addr :

the IP address +int + +nm_ip_address_get_family () +

prefix :

the address prefix lengthconst char * + +nm_ip_address_get_address () +

error :

location to store error, or NULL + +void + +nm_ip_address_set_address ()

Returns :

the new NMIPAddress object, or NULL on error. [transfer full] + +void + +nm_ip_address_get_address_binary ()
-
-
-
-

nm_ip_address_ref ()

-
void                nm_ip_address_ref                   (NMIPAddress *address);
-

-Increases the reference count of the object. -

-
---- - - - + - -

address :

the NMIPAddress +
+void
-
-
-
-

nm_ip_address_unref ()

-
void                nm_ip_address_unref                 (NMIPAddress *address);
-

-Decreases the reference count of the object. If the reference count -reaches zero, the object will be destroyed. -

-
---- - - - - -

address :

the NMIPAddress + +nm_ip_address_set_address_binary ()
-
-
-
-

nm_ip_address_equal ()

-
gboolean            nm_ip_address_equal                 (NMIPAddress *address,
-                                                         NMIPAddress *other);
-

-Determines if two NMIPAddress objects contain the same address and prefix -(attributes are not compared). -

-
---- - + - - + - - + + - - + + - -

address :

the NMIPAddress + +guint + +nm_ip_address_get_prefix ()

other :

the NMIPAddress to compare address to. +void + +nm_ip_address_set_prefix () +

Returns :

-TRUE if the objects contain the same values, FALSE if they do not. +char ** + +nm_ip_address_get_attribute_names () +
-
-
-
-

nm_ip_address_dup ()

-
NMIPAddress *       nm_ip_address_dup                   (NMIPAddress *address);
-

-Creates a copy of address -

-
---- - - - + - - + - -

address :

the NMIPAddress + +GVariant * + +nm_ip_address_get_attribute ()

Returns :

a copy of address. [transfer full] + +void + +nm_ip_address_set_attribute ()
-
-
-
-

nm_ip_address_get_family ()

-
int                 nm_ip_address_get_family            (NMIPAddress *address);
-

-Gets the IP address family (eg, AF_INET) property of this address -object. -

-
---- - - - + - - + + - -

address :

the NMIPAddress + +NMIPRoute * + +nm_ip_route_new ()

Returns :

the IP address family +NMIPRoute * + +nm_ip_route_new_binary () +
-
-
-
-

nm_ip_address_get_address ()

-
const char *        nm_ip_address_get_address           (NMIPAddress *address);
-

-Gets the IP address property of this address object. -

-
---- - - - + - - + + - -

address :

the NMIPAddress + +void + +nm_ip_route_ref ()

Returns :

the IP address +void + +nm_ip_route_unref () +
-
-
-
-

nm_ip_address_set_address ()

-
void                nm_ip_address_set_address           (NMIPAddress *address,
-                                                         const char *addr);
-

-Sets the IP address property of this address object. -

-

-addr must be a valid address of address's family. If you aren't sure you -have a valid address, use nm_utils_ipaddr_valid() to check it. -

-
---- - - - + - - + + - -

address :

the NMIPAddress + +gboolean + +nm_ip_route_equal ()

addr :

the IP address, as a string +NMIPRoute * + +nm_ip_route_dup () +
-
-
-
-

nm_ip_address_get_address_binary ()

-
void                nm_ip_address_get_address_binary    (NMIPAddress *address,
-                                                         gpointer addr);
-

-Gets the IP address property of this address object. -

-

-addr must point to a buffer that is the correct size for address's family. -

-
---- - - - + - - + + - -

address :

the NMIPAddress + +int + +nm_ip_route_get_family ()

addr :

a buffer in which to store the address in binary format.const char * + +nm_ip_route_get_dest () +
-
-
-
-

nm_ip_address_set_address_binary ()

-
void                nm_ip_address_set_address_binary    (NMIPAddress *address,
-                                                         gconstpointer addr);
-

-Sets the IP address property of this address object. -

-

-addr must point to a buffer that is the correct size for address's family. -

-
---- - - - + - - + + - -

address :

the NMIPAddress + +void + +nm_ip_route_set_dest ()

addr :

the address, in binary format +void + +nm_ip_route_get_dest_binary () +
-
-
-
-

nm_ip_address_get_prefix ()

-
guint               nm_ip_address_get_prefix            (NMIPAddress *address);
-

-Gets the IP address prefix (ie "24" or "30" etc) property of this address -object. -

-
---- - - - + - - + + - -

address :

the NMIPAddress + +void + +nm_ip_route_set_dest_binary ()

Returns :

the IP address prefix +guint + +nm_ip_route_get_prefix () +
-
-
-
-

nm_ip_address_set_prefix ()

-
void                nm_ip_address_set_prefix            (NMIPAddress *address,
-                                                         guint prefix);
-

-Sets the IP address prefix property of this address object. -

-
---- - - - + - - + + - -

address :

the NMIPAddress + +void + +nm_ip_route_set_prefix ()

prefix :

the IP address prefixconst char * + +nm_ip_route_get_next_hop () +
-
-
-
-

nm_ip_address_get_attribute_names ()

-
char **             nm_ip_address_get_attribute_names   (NMIPAddress *address);
-

-Gets an array of attribute names defined on address. -

-
---- - - - + - - + - -

address :

the NMIPAddress + +void + +nm_ip_route_set_next_hop ()

Returns :

a NULL-terminated array of attribute names,. [transfer full] + +gboolean + +nm_ip_route_get_next_hop_binary ()
-
-
-
-

nm_ip_address_get_attribute ()

-
GVariant *          nm_ip_address_get_attribute         (NMIPAddress *address,
-                                                         const char *name);
-

-Gets the value of the attribute with name name on address -

-
---- - - - + - - + + - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

address :

the NMIPAddress + +void + +nm_ip_route_set_next_hop_binary ()

name :

the name of an address attribute +gint64 + +nm_ip_route_get_metric () +

Returns :

the value of the attribute with name name on -address, or NULL if address has no such attribute. [transfer none] + +void + +nm_ip_route_set_metric () +
+char ** + +nm_ip_route_get_attribute_names () +
+GVariant * + +nm_ip_route_get_attribute () +
+void + +nm_ip_route_set_attribute () +
const char * + +nm_setting_ip_config_get_method () +
+guint + +nm_setting_ip_config_get_num_dns () +
const char * + +nm_setting_ip_config_get_dns () +
+gboolean + +nm_setting_ip_config_add_dns () +
+void + +nm_setting_ip_config_remove_dns () +
+gboolean + +nm_setting_ip_config_remove_dns_by_value () +
+void + +nm_setting_ip_config_clear_dns () +
+guint + +nm_setting_ip_config_get_num_dns_searches () +
const char * + +nm_setting_ip_config_get_dns_search () +
+gboolean + +nm_setting_ip_config_add_dns_search () +
+void + +nm_setting_ip_config_remove_dns_search () +
+gboolean + +nm_setting_ip_config_remove_dns_search_by_value () +
+void + +nm_setting_ip_config_clear_dns_searches () +
+guint + +nm_setting_ip_config_get_num_addresses () +
+NMIPAddress * + +nm_setting_ip_config_get_address () +
+gboolean + +nm_setting_ip_config_add_address () +
+void + +nm_setting_ip_config_remove_address () +
+gboolean + +nm_setting_ip_config_remove_address_by_value () +
+void + +nm_setting_ip_config_clear_addresses () +
const char * + +nm_setting_ip_config_get_gateway () +
+guint + +nm_setting_ip_config_get_num_routes () +
+NMIPRoute * + +nm_setting_ip_config_get_route () +
+gboolean + +nm_setting_ip_config_add_route () +
+void + +nm_setting_ip_config_remove_route () +
+gboolean + +nm_setting_ip_config_remove_route_by_value () +
+void + +nm_setting_ip_config_clear_routes () +
+gint64 + +nm_setting_ip_config_get_route_metric () +
+gboolean + +nm_setting_ip_config_get_ignore_auto_routes () +
+gboolean + +nm_setting_ip_config_get_ignore_auto_dns () +
const char * + +nm_setting_ip_config_get_dhcp_hostname () +
+gboolean + +nm_setting_ip_config_get_dhcp_send_hostname () +
+gboolean + +nm_setting_ip_config_get_never_default () +
+gboolean + +nm_setting_ip_config_get_may_fail ()
-
-
-

nm_ip_address_set_attribute ()

-
void                nm_ip_address_set_attribute         (NMIPAddress *address,
-                                                         const char *name,
-                                                         GVariant *value);
-

-Sets or clears the named attribute on address to the given value. -

-
+
+

Properties

+
--+++ - - + + + - - + + + - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

address :

the NMIPAddress - +GPtrArray *addressesRead / Write

name :

the name of an address attribute +gchar *dhcp-hostnameRead / Write

value :

the value. [transfer none][allow-none] -gbooleandhcp-send-hostnameRead / Write / Construct
GStrvdnsRead / Write
GStrvdns-searchRead / Write
+gchar *gatewayRead / Write
gbooleanignore-auto-dnsRead / Write / Construct
gbooleanignore-auto-routesRead / Write / Construct
gbooleanmay-failRead / Write / Construct
+gchar *methodRead / Write
gbooleannever-defaultRead / Write / Construct
gint64route-metricRead / Write / Construct
+GPtrArray *routesRead / Write
-
-
-

NMIPRoute

-
typedef struct NMIPRoute NMIPRoute;
-
-

-

-
-
-
-

nm_ip_route_new ()

-
NMIPRoute *         nm_ip_route_new                     (int family,
-                                                         const char *dest,
-                                                         guint prefix,
-                                                         const char *next_hop,
-                                                         gint64 metric,
-                                                         GError **error);
-

-Creates a new NMIPRoute object. -

-
+
+

Types and Values

+
--++ - - + + - - + + - - + + - - + + - - + + - - + + - - + + + + + + + + + + + + + + + + + + + + + + + + + +

family :

the IP address family (AF_INET or -AF_INET6)#defineNM_SETTING_IP_CONFIG_METHOD

dest :

the IP address of the route's destination#defineNM_SETTING_IP_CONFIG_DNS

prefix :

the address prefix length#defineNM_SETTING_IP_CONFIG_DNS_SEARCH

next_hop :

the IP address of the next hop (or NULL). [allow-none] -#defineNM_SETTING_IP_CONFIG_ADDRESSES

metric :

the route metric (or -1 for "default")#defineNM_SETTING_IP_CONFIG_GATEWAY

error :

location to store error, or NULL -#defineNM_SETTING_IP_CONFIG_ROUTES

Returns :

the new NMIPRoute object, or NULL on error. [transfer full] -#defineNM_SETTING_IP_CONFIG_ROUTE_METRIC
#defineNM_SETTING_IP_CONFIG_IGNORE_AUTO_ROUTES
#defineNM_SETTING_IP_CONFIG_IGNORE_AUTO_DNS
#defineNM_SETTING_IP_CONFIG_DHCP_HOSTNAME
#defineNM_SETTING_IP_CONFIG_DHCP_SEND_HOSTNAME
#defineNM_SETTING_IP_CONFIG_NEVER_DEFAULT
#defineNM_SETTING_IP_CONFIG_MAY_FAIL
-
-
-

nm_ip_route_new_binary ()

-
NMIPRoute *         nm_ip_route_new_binary              (int family,
-                                                         gconstpointer dest,
-                                                         guint prefix,
-                                                         gconstpointer next_hop,
-                                                         gint64 metric,
-                                                         GError **error);
-

-Creates a new NMIPRoute object. dest and next_hop (if non-NULL) must -point to buffers of the correct size for family. -

-
---+
+

Object Hierarchy

+
    GBoxed
+    ├── NMIPAddress
+    ╰── NMIPRoute
+    GObject
+    ╰── NMSetting
+        ╰── NMSettingIPConfig
+            ├── NMSettingIP4Config
+            ╰── NMSettingIP6Config
+
+
+
+

Includes

+
#include <nm-setting-ip-config.h>
+
+
+
+

Description

+

NMSettingIPConfig is the abstract base class of +NMSettingIP4Config and NMSettingIP6Config, providing properties +related to IP addressing, routing, and Domain Name Service.

+
+
+

Functions

+
+

nm_ip_address_new ()

+
NMIPAddress *
+nm_ip_address_new (int family,
+                   const char *addr,
+                   guint prefix,
+                   GError **error);
+

Creates a new NMIPAddress object.

+
+

Parameters

+
++++ - - + + + - - + + + - - + + + - - + + + + + +

family :

the IP address family (AF_INET or -AF_INET6)

family

the IP address family (AF_INET or +AF_INET6)

 

dest :

the IP address of the route's destination

addr

the IP address

 

prefix :

the address prefix length

prefix

the address prefix length

 

next_hop :

the IP address of the next hop (or NULL). [allow-none] -

error

location to store error, or NULL

 
+
+
+

Returns

+

the new NMIPAddress object, or NULL on error.

+

[transfer full]

+
+
+
+
+

nm_ip_address_new_binary ()

+
NMIPAddress *
+nm_ip_address_new_binary (int family,
+                          gconstpointer addr,
+                          guint prefix,
+                          GError **error);
+

Creates a new NMIPAddress object. addr + must point to a buffer of the +correct size for family +.

+
+

Parameters

+
+++++ + + + + + - - + + + - - + + + - - + + +

family

the IP address family (AF_INET or +AF_INET6)

 

metric :

the route metric (or -1 for "default")

addr

the IP address

 

error :

location to store error, or NULL -

prefix

the address prefix length

 

Returns :

the new NMIPRoute object, or NULL on error. [transfer full] -

error

location to store error, or NULL

 
+
+

Returns

+

the new NMIPAddress object, or NULL on error.

+

[transfer full]

+
+

-

nm_ip_route_ref ()

-
void                nm_ip_route_ref                     (NMIPRoute *route);
-

-Increases the reference count of the object. -

-
+

nm_ip_address_ref ()

+
void
+nm_ip_address_ref (NMIPAddress *address);
+

Increases the reference count of the object.

+
+

Parameters

+
--+++ - - + + +

route :

the NMIPRoute -

address

the NMIPAddress

 
+

-

nm_ip_route_unref ()

-
void                nm_ip_route_unref                   (NMIPRoute *route);
-

-Decreases the reference count of the object. If the reference count -reaches zero, the object will be destroyed. -

-
+

nm_ip_address_unref ()

+
void
+nm_ip_address_unref (NMIPAddress *address);
+

Decreases the reference count of the object. If the reference count +reaches zero, the object will be destroyed.

+
+

Parameters

+
--+++ - - + + +

route :

the NMIPRoute -

address

the NMIPAddress

 
+
-

nm_ip_route_equal ()

-
gboolean            nm_ip_route_equal                   (NMIPRoute *route,
-                                                         NMIPRoute *other);
-

-Determines if two NMIPRoute objects contain the same destination, prefix, -next hop, and metric. (Attributes are not compared.) -

-
+

nm_ip_address_equal ()

+
gboolean
+nm_ip_address_equal (NMIPAddress *address,
+                     NMIPAddress *other);
+

Determines if two NMIPAddress objects contain the same address and prefix +(attributes are not compared).

+
+

Parameters

+
--+++ - - - - - - + + + - - + + +

route :

the NMIPRoute -

other :

the NMIPRoute to compare route to.

address

the NMIPAddress

 

Returns :

-TRUE if the objects contain the same values, FALSE if they do not.

other

the NMIPAddress to compare address +to.

 
+
+

Returns

+

TRUE if the objects contain the same values, FALSE if they do not.

+

+
+
-

nm_ip_route_dup ()

-
NMIPRoute *         nm_ip_route_dup                     (NMIPRoute *route);
-

-Creates a copy of route +

nm_ip_address_dup ()

+
NMIPAddress *
+nm_ip_address_dup (NMIPAddress *address);
+

Creates a copy of address

-
+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

route :

the NMIPRoute -

Returns :

a copy of route. [transfer full] -

address

the NMIPAddress

 
+
+

Returns

+

a copy of address +.

+

[transfer full]

+
+
-

nm_ip_route_get_family ()

-
int                 nm_ip_route_get_family              (NMIPRoute *route);
-

-Gets the IP address family (eg, AF_INET) property of this route -object. -

-
+

nm_ip_address_get_family ()

+
int
+nm_ip_address_get_family (NMIPAddress *address);
+

Gets the IP address family (eg, AF_INET) property of this address +object.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

route :

the NMIPRoute -

Returns :

the IP address family

address

the NMIPAddress

 
+
+

Returns

+

the IP address family

+

+
+
-

nm_ip_route_get_dest ()

-
const char *        nm_ip_route_get_dest                (NMIPRoute *route);
-

-Gets the IP destination address property of this route object. -

-
+

nm_ip_address_get_address ()

+
const char *
+nm_ip_address_get_address (NMIPAddress *address);
+

Gets the IP address property of this address object.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

route :

the NMIPRoute -

Returns :

the IP address of the route's destination

address

the NMIPAddress

 
+
+

Returns

+

the IP address

+

+
+
-

nm_ip_route_set_dest ()

-
void                nm_ip_route_set_dest                (NMIPRoute *route,
-                                                         const char *dest);
-

-Sets the destination property of this route object. -

-

-dest must be a valid address of route's family. If you aren't sure you -have a valid address, use nm_utils_ipaddr_valid() to check it. -

-
+

nm_ip_address_set_address ()

+
void
+nm_ip_address_set_address (NMIPAddress *address,
+                           const char *addr);
+

Sets the IP address property of this address object.

+

addr + must be a valid address of address +'s family. If you aren't sure you +have a valid address, use nm_utils_ipaddr_valid() to check it.

+
+

Parameters

+
--+++ - - + + + - - + + +

route :

the NMIPRoute -

address

the NMIPAddress

 

dest :

the route's destination, as a string

addr

the IP address, as a string

 
+
-

nm_ip_route_get_dest_binary ()

-
void                nm_ip_route_get_dest_binary         (NMIPRoute *route,
-                                                         gpointer dest);
-

-Gets the destination property of this route object. -

-

-dest must point to a buffer that is the correct size for route's family. -

-
+

nm_ip_address_get_address_binary ()

+
void
+nm_ip_address_get_address_binary (NMIPAddress *address,
+                                  gpointer addr);
+

Gets the IP address property of this address object.

+

addr + must point to a buffer that is the correct size for address +'s family.

+
+

Parameters

+
--+++ - - + + + - - + + +

route :

the NMIPRoute -

address

the NMIPAddress

 

dest :

a buffer in which to store the destination in binary format.

addr

a buffer in which to store the address in binary format.

 
+
-

nm_ip_route_set_dest_binary ()

-
void                nm_ip_route_set_dest_binary         (NMIPRoute *route,
-                                                         gconstpointer dest);
-

-Sets the destination property of this route object. -

-

-dest must point to a buffer that is the correct size for route's family. -

-
+

nm_ip_address_set_address_binary ()

+
void
+nm_ip_address_set_address_binary (NMIPAddress *address,
+                                  gconstpointer addr);
+

Sets the IP address property of this address object.

+

addr + must point to a buffer that is the correct size for address +'s family.

+
+

Parameters

+
--+++ - - + + + - - + + +

route :

the NMIPRoute -

address

the NMIPAddress

 

dest :

the route's destination, in binary format

addr

the address, in binary format

 
+
-

nm_ip_route_get_prefix ()

-
guint               nm_ip_route_get_prefix              (NMIPRoute *route);
-

-Gets the IP prefix (ie "24" or "30" etc) of this route. -

-
+

nm_ip_address_get_prefix ()

+
guint
+nm_ip_address_get_prefix (NMIPAddress *address);
+

Gets the IP address prefix (ie "24" or "30" etc) property of this address +object.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

route :

the NMIPRoute -

Returns :

the IP prefix

address

the NMIPAddress

 
+
+

Returns

+

the IP address prefix

+

+
+
-

nm_ip_route_set_prefix ()

-
void                nm_ip_route_set_prefix              (NMIPRoute *route,
-                                                         guint prefix);
-

-Sets the prefix property of this route object. -

-
+

nm_ip_address_set_prefix ()

+
void
+nm_ip_address_set_prefix (NMIPAddress *address,
+                          guint prefix);
+

Sets the IP address prefix property of this address object.

+
+

Parameters

+
--+++ - - + + + - - + + +

route :

the NMIPRoute -

address

the NMIPAddress

 

prefix :

the route prefix

prefix

the IP address prefix

 
+
-

nm_ip_route_get_next_hop ()

-
const char *        nm_ip_route_get_next_hop            (NMIPRoute *route);
-

-Gets the IP address of the next hop of this route; this will be NULL if the -route has no next hop. -

-
+

nm_ip_address_get_attribute_names ()

+
char **
+nm_ip_address_get_attribute_names (NMIPAddress *address);
+

Gets an array of attribute names defined on address +.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

route :

the NMIPRoute -

Returns :

the IP address of the next hop, or NULL if this is a device route.

address

the NMIPAddress

 
+
+

Returns

+

a NULL-terminated array of attribute names,.

+

[transfer full]

+
+
-

nm_ip_route_set_next_hop ()

-
void                nm_ip_route_set_next_hop            (NMIPRoute *route,
-                                                         const char *next_hop);
-

-Sets the next-hop property of this route object. +

nm_ip_address_get_attribute ()

+
GVariant *
+nm_ip_address_get_attribute (NMIPAddress *address,
+                             const char *name);
+

Gets the value of the attribute with name name + on address

-

-next_hop (if non-NULL) must be a valid address of route's family. If you -aren't sure you have a valid address, use nm_utils_ipaddr_valid() to check -it. -

-
+
+

Parameters

+
--+++ - - + + + - - + + +

route :

the NMIPRoute -

address

the NMIPAddress

 

next_hop :

the route's next hop, as a string. [allow-none] -

name

the name of an address attribute

 
+
+

Returns

+

the value of the attribute with name name +on +address +, or NULL if address +has no such attribute.

+

[transfer none]

+
+
-

nm_ip_route_get_next_hop_binary ()

-
gboolean            nm_ip_route_get_next_hop_binary     (NMIPRoute *route,
-                                                         gpointer next_hop);
-

-Gets the next hop property of this route object. -

-

-next_hop must point to a buffer that is the correct size for route's family. -

-
+

nm_ip_address_set_attribute ()

+
void
+nm_ip_address_set_attribute (NMIPAddress *address,
+                             const char *name,
+                             GVariant *value);
+

Sets or clears the named attribute on address + to the given value.

+
+

Parameters

+
--+++ - - + + + - - + + + - - + + +

route :

the NMIPRoute -

address

the NMIPAddress

 

next_hop :

a buffer in which to store the next hop in binary format.

name

the name of an address attribute

 

Returns :

-TRUE if route has a next hop, FALSE if not (in which case -next_hop will be zeroed out)

value

the value.

[transfer none][allow-none]
+
-

nm_ip_route_set_next_hop_binary ()

-
void                nm_ip_route_set_next_hop_binary     (NMIPRoute *route,
-                                                         gconstpointer next_hop);
-

-Sets the destination property of this route object. -

-

-next_hop (if non-NULL) must point to a buffer that is the correct size for -route's family. -

-
+

nm_ip_route_new ()

+
NMIPRoute *
+nm_ip_route_new (int family,
+                 const char *dest,
+                 guint prefix,
+                 const char *next_hop,
+                 gint64 metric,
+                 GError **error);
+

Creates a new NMIPRoute object.

+
+

Parameters

+
--+++ - - + + + - - + + + - -

route :

the NMIPRoute -

family

the IP address family (AF_INET or +AF_INET6)

 

next_hop :

the route's next hop, in binary format

dest

the IP address of the route's destination

 
-
-
-
-

nm_ip_route_get_metric ()

-
gint64              nm_ip_route_get_metric              (NMIPRoute *route);
-

-Gets the route metric property of this route object; lower values -indicate "better" or more preferred routes; -1 indicates "default" -(meaning NetworkManager will set it appropriately). -

-
---- - - - + + + + + + + + + + + + + - - + + +

route :

the NMIPRoute -

prefix

the address prefix length

 

next_hop

the IP address of the next hop (or NULL).

[allow-none]

metric

the route metric (or -1 for "default")

 

Returns :

the route metric

error

location to store error, or NULL

 
+
+

Returns

+

the new NMIPRoute object, or NULL on error.

+

[transfer full]

+
+
-

nm_ip_route_set_metric ()

-
void                nm_ip_route_set_metric              (NMIPRoute *route,
-                                                         gint64 metric);
-

-Sets the metric property of this route object. -

-
+

nm_ip_route_new_binary ()

+
NMIPRoute *
+nm_ip_route_new_binary (int family,
+                        gconstpointer dest,
+                        guint prefix,
+                        gconstpointer next_hop,
+                        gint64 metric,
+                        GError **error);
+

Creates a new NMIPRoute object. dest + and next_hop + (if non-NULL) must +point to buffers of the correct size for family +.

+
+

Parameters

+
--+++ - - + + + + + + + + - - + + + + + + + + + + + + + + + + + +

route :

the NMIPRoute -

family

the IP address family (AF_INET or +AF_INET6)

 

dest

the IP address of the route's destination

 

metric :

the route metric (or -1 for "default")

prefix

the address prefix length

 

next_hop

the IP address of the next hop (or NULL).

[allow-none]

metric

the route metric (or -1 for "default")

 

error

location to store error, or NULL

 
+
+

Returns

+

the new NMIPRoute object, or NULL on error.

+

[transfer full]

+
+
-

nm_ip_route_get_attribute_names ()

-
char **             nm_ip_route_get_attribute_names     (NMIPRoute *route);
-

-Gets an array of attribute names defined on route. -

-
+

nm_ip_route_ref ()

+
void
+nm_ip_route_ref (NMIPRoute *route);
+

Increases the reference count of the object.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

route :

the NMIPRoute -

Returns :

a NULL-terminated array of attribute names. [transfer full] -

route

the NMIPRoute

 
+
-

nm_ip_route_get_attribute ()

-
GVariant *          nm_ip_route_get_attribute           (NMIPRoute *route,
-                                                         const char *name);
-

-Gets the value of the attribute with name name on route -

-
+

nm_ip_route_unref ()

+
void
+nm_ip_route_unref (NMIPRoute *route);
+

Decreases the reference count of the object. If the reference count +reaches zero, the object will be destroyed.

+
+

Parameters

+
--+++ - - - - - - - - - - - - - - + + + + +

route :

the NMIPRoute -

name :

the name of an route attribute

Returns :

the value of the attribute with name name on -route, or NULL if route has no such attribute. [transfer none] -

route

the NMIPRoute

 
+
-

nm_ip_route_set_attribute ()

-
void                nm_ip_route_set_attribute           (NMIPRoute *route,
-                                                         const char *name,
-                                                         GVariant *value);
-

-Sets the named attribute on route to the given value. -

-
+

nm_ip_route_equal ()

+
gboolean
+nm_ip_route_equal (NMIPRoute *route,
+                   NMIPRoute *other);
+

Determines if two NMIPRoute objects contain the same destination, prefix, +next hop, and metric. (Attributes are not compared.)

+
+

Parameters

+
--+++ - - - - - - + + + - - + + +

route :

the NMIPRoute -

name :

the name of a route attribute

route

the NMIPRoute

 

value :

the value. [transfer none][allow-none] -

other

the NMIPRoute to compare route +to.

 
-
-
-

NM_SETTING_IP_CONFIG_METHOD

-
#define NM_SETTING_IP_CONFIG_METHOD             "method"
-
-

-

+
+

Returns

+

TRUE if the objects contain the same values, FALSE if they do not.

+

-
-
-

NM_SETTING_IP_CONFIG_DNS

-
#define NM_SETTING_IP_CONFIG_DNS                "dns"
-
-

-


-

NM_SETTING_IP_CONFIG_DNS_SEARCH

-
#define NM_SETTING_IP_CONFIG_DNS_SEARCH         "dns-search"
-
-

+

nm_ip_route_dup ()

+
NMIPRoute *
+nm_ip_route_dup (NMIPRoute *route);
+

Creates a copy of route

+
+

Parameters

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

route

the NMIPRoute

 
-
-
-

NM_SETTING_IP_CONFIG_ADDRESSES

-
#define NM_SETTING_IP_CONFIG_ADDRESSES          "addresses"
-
-

-

+
+

Returns

+

a copy of route +.

+

[transfer full]

-
-
-

NM_SETTING_IP_CONFIG_GATEWAY

-
#define NM_SETTING_IP_CONFIG_GATEWAY            "gateway"
-
-

-


-

NM_SETTING_IP_CONFIG_ROUTES

-
#define NM_SETTING_IP_CONFIG_ROUTES             "routes"
-
-

-

+

nm_ip_route_get_family ()

+
int
+nm_ip_route_get_family (NMIPRoute *route);
+

Gets the IP address family (eg, AF_INET) property of this route +object.

+
+

Parameters

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

route

the NMIPRoute

 
-
-
-

NM_SETTING_IP_CONFIG_ROUTE_METRIC

-
#define NM_SETTING_IP_CONFIG_ROUTE_METRIC       "route-metric"
-
-

-

+
+

Returns

+

the IP address family

+

-
-
-

NM_SETTING_IP_CONFIG_IGNORE_AUTO_ROUTES

-
#define NM_SETTING_IP_CONFIG_IGNORE_AUTO_ROUTES "ignore-auto-routes"
-
-

-


-

NM_SETTING_IP_CONFIG_IGNORE_AUTO_DNS

-
#define NM_SETTING_IP_CONFIG_IGNORE_AUTO_DNS    "ignore-auto-dns"
-
-

-

+

nm_ip_route_get_dest ()

+
const char *
+nm_ip_route_get_dest (NMIPRoute *route);
+

Gets the IP destination address property of this route object.

+
+

Parameters

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

route

the NMIPRoute

 
+
+
+

Returns

+

the IP address of the route's destination

+

+

-

NM_SETTING_IP_CONFIG_DHCP_HOSTNAME

-
#define NM_SETTING_IP_CONFIG_DHCP_HOSTNAME      "dhcp-hostname"
-
-

-

+

nm_ip_route_set_dest ()

+
void
+nm_ip_route_set_dest (NMIPRoute *route,
+                      const char *dest);
+

Sets the destination property of this route object.

+

dest + must be a valid address of route +'s family. If you aren't sure you +have a valid address, use nm_utils_ipaddr_valid() to check it.

+
+

Parameters

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

route

the NMIPRoute

 

dest

the route's destination, as a string

 
+

-

NM_SETTING_IP_CONFIG_DHCP_SEND_HOSTNAME

-
#define NM_SETTING_IP_CONFIG_DHCP_SEND_HOSTNAME "dhcp-send-hostname"
-
-

-

+

nm_ip_route_get_dest_binary ()

+
void
+nm_ip_route_get_dest_binary (NMIPRoute *route,
+                             gpointer dest);
+

Gets the destination property of this route object.

+

dest + must point to a buffer that is the correct size for route +'s family.

+
+

Parameters

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

route

the NMIPRoute

 

dest

a buffer in which to store the destination in binary format.

 
+

-

NM_SETTING_IP_CONFIG_NEVER_DEFAULT

-
#define NM_SETTING_IP_CONFIG_NEVER_DEFAULT      "never-default"
-
-

-

+

nm_ip_route_set_dest_binary ()

+
void
+nm_ip_route_set_dest_binary (NMIPRoute *route,
+                             gconstpointer dest);
+

Sets the destination property of this route object.

+

dest + must point to a buffer that is the correct size for route +'s family.

+
+

Parameters

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

route

the NMIPRoute

 

dest

the route's destination, in binary format

 
+

-

NM_SETTING_IP_CONFIG_MAY_FAIL

-
#define NM_SETTING_IP_CONFIG_MAY_FAIL           "may-fail"
-
-

-

+

nm_ip_route_get_prefix ()

+
guint
+nm_ip_route_get_prefix (NMIPRoute *route);
+

Gets the IP prefix (ie "24" or "30" etc) of this route.

+
+

Parameters

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

route

the NMIPRoute

 
+
+
+

Returns

+

the IP prefix

+

+

-

struct NMSettingIPConfig

-
struct NMSettingIPConfig;
-

-

+

nm_ip_route_set_prefix ()

+
void
+nm_ip_route_set_prefix (NMIPRoute *route,
+                        guint prefix);
+

Sets the prefix property of this route object.

+
+

Parameters

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

route

the NMIPRoute

 

prefix

the route prefix

 
+

-

NMSettingIPConfigClass

-
typedef struct {
-	NMSettingClass parent;
-
-	/* Padding for future expansion */
-	gpointer padding[8];
-} NMSettingIPConfigClass;
-
-

-

+

nm_ip_route_get_next_hop ()

+
const char *
+nm_ip_route_get_next_hop (NMIPRoute *route);
+

Gets the IP address of the next hop of this route; this will be NULL if the +route has no next hop.

+
+

Parameters

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

route

the NMIPRoute

 
+
+
+

Returns

+

the IP address of the next hop, or NULL if this is a device route.

+

+

-

nm_setting_ip_config_get_method ()

-
const char *        nm_setting_ip_config_get_method     (NMSettingIPConfig *setting);
-
+

nm_ip_route_set_next_hop ()

+
void
+nm_ip_route_set_next_hop (NMIPRoute *route,
+                          const char *next_hop);
+

Sets the next-hop property of this route object.

+

next_hop + (if non-NULL) must be a valid address of route +'s family. If you +aren't sure you have a valid address, use nm_utils_ipaddr_valid() to check +it.

+
+

Parameters

+
--+++ - - + + + - - + + +

setting :

the NMSettingIPConfig -

route

the NMIPRoute

 

Returns :

the "method" property of the setting; see -NMSettingIP4Config and NMSettingIP6Config for details of the -methods available with each type.

next_hop

the route's next hop, as a string.

[allow-none]
+

-

nm_setting_ip_config_get_num_dns ()

-
guint               nm_setting_ip_config_get_num_dns    (NMSettingIPConfig *setting);
-
+

nm_ip_route_get_next_hop_binary ()

+
gboolean
+nm_ip_route_get_next_hop_binary (NMIPRoute *route,
+                                 gpointer next_hop);
+

Gets the next hop property of this route object.

+

next_hop + must point to a buffer that is the correct size for route +'s family.

+
+

Parameters

+
--+++ - - + + + - - + + +

setting :

the NMSettingIPConfig -

route

the NMIPRoute

 

Returns :

the number of configured DNS servers

next_hop

a buffer in which to store the next hop in binary format.

 
+
+

Returns

+

TRUE if route +has a next hop, FALSE if not (in which case +next_hop +will be zeroed out)

+

+
+

-

nm_setting_ip_config_get_dns ()

-
const char *        nm_setting_ip_config_get_dns        (NMSettingIPConfig *setting,
-                                                         int i);
-
+

nm_ip_route_set_next_hop_binary ()

+
void
+nm_ip_route_set_next_hop_binary (NMIPRoute *route,
+                                 gconstpointer next_hop);
+

Sets the destination property of this route object.

+

next_hop + (if non-NULL) must point to a buffer that is the correct size for +route +'s family.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + +

setting :

the NMSettingIPConfig -

i :

index number of the DNS server to return

route

the NMIPRoute

 

Returns :

the IP address of the DNS server at index i -

next_hop

the route's next hop, in binary format

 
+

-

nm_setting_ip_config_add_dns ()

-
gboolean            nm_setting_ip_config_add_dns        (NMSettingIPConfig *setting,
-                                                         const char *dns);
-

-Adds a new DNS server to the setting. -

-
+

nm_ip_route_get_metric ()

+
gint64
+nm_ip_route_get_metric (NMIPRoute *route);
+

Gets the route metric property of this route object; lower values +indicate "better" or more preferred routes; -1 indicates "default" +(meaning NetworkManager will set it appropriately).

+
+

Parameters

+
--++++ + + + + + +

route

the NMIPRoute

 
+
+
+

Returns

+

the route metric

+

+
+
+
+
+

nm_ip_route_set_metric ()

+
void
+nm_ip_route_set_metric (NMIPRoute *route,
+                        gint64 metric);
+

Sets the metric property of this route object.

+
+

Parameters

+
++++ - - - - - - + + + - - + + +

setting :

the NMSettingIPConfig -

dns :

the IP address of the DNS server to add

route

the NMIPRoute

 

Returns :

-TRUE if the DNS server was added; FALSE if the server was already -known

metric

the route metric (or -1 for "default")

 
+

-

nm_setting_ip_config_remove_dns ()

-
void                nm_setting_ip_config_remove_dns     (NMSettingIPConfig *setting,
-                                                         int i);
-

-Removes the DNS server at index i. +

nm_ip_route_get_attribute_names ()

+
char **
+nm_ip_route_get_attribute_names (NMIPRoute *route);
+

Gets an array of attribute names defined on route +.

+
+

Parameters

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

route

the NMIPRoute

 
+
+
+

Returns

+

a NULL-terminated array of attribute names.

+

[transfer full]

+
+
+
+
+

nm_ip_route_get_attribute ()

+
GVariant *
+nm_ip_route_get_attribute (NMIPRoute *route,
+                           const char *name);
+

Gets the value of the attribute with name name + on route

-
+
+

Parameters

+
--+++ - - + + + - - + + +

setting :

the NMSettingIPConfig -

route

the NMIPRoute

 

i :

index number of the DNS server to remove

name

the name of an route attribute

 
+
+

Returns

+

the value of the attribute with name name +on +route +, or NULL if route +has no such attribute.

+

[transfer none]

+
+

-

nm_setting_ip_config_remove_dns_by_value ()

-
gboolean            nm_setting_ip_config_remove_dns_by_value
-                                                        (NMSettingIPConfig *setting,
-                                                         const char *dns);
-

-Removes the DNS server dns. -

-
+

nm_ip_route_set_attribute ()

+
void
+nm_ip_route_set_attribute (NMIPRoute *route,
+                           const char *name,
+                           GVariant *value);
+

Sets the named attribute on route + to the given value.

+
+

Parameters

+
--+++ - - + + + - - + + + - - + + +

setting :

the NMSettingIPConfig -

route

the NMIPRoute

 

dns :

the DNS server to remove

name

the name of a route attribute

 

Returns :

-TRUE if the DNS server was found and removed; FALSE if it was not.

value

the value.

[transfer none][allow-none]
+ +
+
+

nm_setting_ip_config_get_method ()

+
const char *
+nm_setting_ip_config_get_method (NMSettingIPConfig *setting);
+
+

Parameters

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

setting

the NMSettingIPConfig

 
+
+
+

Returns

+

the “method” property of the setting; see +NMSettingIP4Config and NMSettingIP6Config for details of the +methods available with each type.

+

+
+

-

nm_setting_ip_config_clear_dns ()

-
void                nm_setting_ip_config_clear_dns      (NMSettingIPConfig *setting);
-

-Removes all configured DNS servers. -

-
+

nm_setting_ip_config_get_num_dns ()

+
guint
+nm_setting_ip_config_get_num_dns (NMSettingIPConfig *setting);
+
+

Parameters

+
--+++ - - + + +

setting :

the NMSettingIPConfig -

setting

the NMSettingIPConfig

 
+
+

Returns

+

the number of configured DNS servers

+

+
+
-

nm_setting_ip_config_get_num_dns_searches ()

-
guint               nm_setting_ip_config_get_num_dns_searches
-                                                        (NMSettingIPConfig *setting);
-
+

nm_setting_ip_config_get_dns ()

+
const char *
+nm_setting_ip_config_get_dns (NMSettingIPConfig *setting,
+                              int i);
+
+

Parameters

+
--+++ - - + + + - - + + +

setting :

the NMSettingIPConfig -

setting

the NMSettingIPConfig

 

Returns :

the number of configured DNS search domains

i

index number of the DNS server to return

 
+
+

Returns

+

the IP address of the DNS server at index i +

+

+
+
-

nm_setting_ip_config_get_dns_search ()

-
const char *        nm_setting_ip_config_get_dns_search (NMSettingIPConfig *setting,
-                                                         int i);
-
+

nm_setting_ip_config_add_dns ()

+
gboolean
+nm_setting_ip_config_add_dns (NMSettingIPConfig *setting,
+                              const char *dns);
+

Adds a new DNS server to the setting.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + +

setting :

the NMSettingIPConfig -

i :

index number of the DNS search domain to return

setting

the NMSettingIPConfig

 

Returns :

the DNS search domain at index i -

dns

the IP address of the DNS server to add

 
+
+

Returns

+

TRUE if the DNS server was added; FALSE if the server was already +known

+

+
+
-

nm_setting_ip_config_add_dns_search ()

-
gboolean            nm_setting_ip_config_add_dns_search (NMSettingIPConfig *setting,
-                                                         const char *dns_search);
-

-Adds a new DNS search domain to the setting. -

-
+

nm_setting_ip_config_remove_dns ()

+
void
+nm_setting_ip_config_remove_dns (NMSettingIPConfig *setting,
+                                 int i);
+

Removes the DNS server at index i +.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + +

setting :

the NMSettingIPConfig -

dns_search :

the search domain to add

setting

the NMSettingIPConfig

 

Returns :

-TRUE if the DNS search domain was added; FALSE if the search -domain was already known

i

index number of the DNS server to remove

 
+
-

nm_setting_ip_config_remove_dns_search ()

-
void                nm_setting_ip_config_remove_dns_search
-                                                        (NMSettingIPConfig *setting,
-                                                         int i);
-

-Removes the DNS search domain at index i. -

-
+

nm_setting_ip_config_remove_dns_by_value ()

+
gboolean
+nm_setting_ip_config_remove_dns_by_value
+                               (NMSettingIPConfig *setting,
+                                const char *dns);
+

Removes the DNS server dns +.

+
+

Parameters

+
--+++ - - + + + - - + + +

setting :

the NMSettingIPConfig -

setting

the NMSettingIPConfig

 

i :

index number of the DNS search domain

dns

the DNS server to remove

 
+
+

Returns

+

TRUE if the DNS server was found and removed; FALSE if it was not.

+

+
+
-

nm_setting_ip_config_remove_dns_search_by_value ()

-
gboolean            nm_setting_ip_config_remove_dns_search_by_value
-                                                        (NMSettingIPConfig *setting,
-                                                         const char *dns_search);
-

-Removes the DNS search domain dns_search. -

-
+

nm_setting_ip_config_clear_dns ()

+
void
+nm_setting_ip_config_clear_dns (NMSettingIPConfig *setting);
+

Removes all configured DNS servers.

+
+

Parameters

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

setting

the NMSettingIPConfig

 
+
+ +
+
+

nm_setting_ip_config_get_num_dns_searches ()

+
guint
+nm_setting_ip_config_get_num_dns_searches
+                               (NMSettingIPConfig *setting);
+
+

Parameters

+
--++++ + + + + + +

setting

the NMSettingIPConfig

 
+
+
+

Returns

+

the number of configured DNS search domains

+

+
+
+
+
+

nm_setting_ip_config_get_dns_search ()

+
const char *
+nm_setting_ip_config_get_dns_search (NMSettingIPConfig *setting,
+                                     int i);
+
+

Parameters

+
++++ - - - - - - + + + - - + + +

setting :

the NMSettingIPConfig -

dns_search :

the search domain to remove

setting

the NMSettingIPConfig

 

Returns :

-TRUE if the DNS search domain was found and removed; FALSE if it was not. -Since 0.9.10

i

index number of the DNS search domain to return

 
+
+

Returns

+

the DNS search domain at index i +

+

+
+

-

nm_setting_ip_config_clear_dns_searches ()

-
void                nm_setting_ip_config_clear_dns_searches
-                                                        (NMSettingIPConfig *setting);
-

-Removes all configured DNS search domains. -

-
+

nm_setting_ip_config_add_dns_search ()

+
gboolean
+nm_setting_ip_config_add_dns_search (NMSettingIPConfig *setting,
+                                     const char *dns_search);
+

Adds a new DNS search domain to the setting.

+
+

Parameters

+
--+++ - - - - + + + + + + + + + + + +

setting :

the NMSettingIPConfig -

setting

the NMSettingIPConfig

 

dns_search

the search domain to add

 
+
+

Returns

+

TRUE if the DNS search domain was added; FALSE if the search +domain was already known

+

+
+
-

nm_setting_ip_config_get_num_addresses ()

-
guint               nm_setting_ip_config_get_num_addresses
-                                                        (NMSettingIPConfig *setting);
-
+

nm_setting_ip_config_remove_dns_search ()

+
void
+nm_setting_ip_config_remove_dns_search
+                               (NMSettingIPConfig *setting,
+                                int i);
+

Removes the DNS search domain at index i +.

+
+

Parameters

+
--+++ - - + + + - - + + +

setting :

the NMSettingIPConfig -

setting

the NMSettingIPConfig

 

Returns :

the number of configured addresses

i

index number of the DNS search domain

 
+
-

nm_setting_ip_config_get_address ()

-
NMIPAddress *       nm_setting_ip_config_get_address    (NMSettingIPConfig *setting,
-                                                         int i);
-
+

nm_setting_ip_config_remove_dns_search_by_value ()

+
gboolean
+nm_setting_ip_config_remove_dns_search_by_value
+                               (NMSettingIPConfig *setting,
+                                const char *dns_search);
+

Removes the DNS search domain dns_search +.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + +

setting :

the NMSettingIPConfig -

i :

index number of the address to return

setting

the NMSettingIPConfig

 

Returns :

the address at index i -

dns_search

the search domain to remove

 
+
+

Returns

+

TRUE if the DNS search domain was found and removed; FALSE if it was not.

+

Since 0.9.10

+

+
+
-

nm_setting_ip_config_add_address ()

-
gboolean            nm_setting_ip_config_add_address    (NMSettingIPConfig *setting,
-                                                         NMIPAddress *address);
-

-Adds a new IP address and associated information to the setting. The -given address is duplicated internally and is not changed by this function. -

-
+

nm_setting_ip_config_clear_dns_searches ()

+
void
+nm_setting_ip_config_clear_dns_searches
+                               (NMSettingIPConfig *setting);
+

Removes all configured DNS search domains.

+
+

Parameters

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

setting

the NMSettingIPConfig

 
+
+ +
+
+

nm_setting_ip_config_get_num_addresses ()

+
guint
+nm_setting_ip_config_get_num_addresses
+                               (NMSettingIPConfig *setting);
+
+

Parameters

+
--++++ + + + + + +

setting

the NMSettingIPConfig

 
+
+
+

Returns

+

the number of configured addresses

+

+
+
+
+
+

nm_setting_ip_config_get_address ()

+
NMIPAddress *
+nm_setting_ip_config_get_address (NMSettingIPConfig *setting,
+                                  int i);
+
+

Parameters

+
++++ - - + + + + + + + + + +

setting :

the NMSettingIPConfig -

setting

the NMSettingIPConfig

 

i

index number of the address to return

 
+
+
+

Returns

+

the address at index i +

+

+
+
+
+
+

nm_setting_ip_config_add_address ()

+
gboolean
+nm_setting_ip_config_add_address (NMSettingIPConfig *setting,
+                                  NMIPAddress *address);
+

Adds a new IP address and associated information to the setting. The +given address is duplicated internally and is not changed by this function.

+
+

Parameters

+
+++++ + - - + + + - - + + +

address :

the new address to add

setting

the NMSettingIPConfig

 

Returns :

-TRUE if the address was added; FALSE if the address was already -known.

address

the new address to add

 
+
+

Returns

+

TRUE if the address was added; FALSE if the address was already +known.

+

+
+

-

nm_setting_ip_config_remove_address ()

-
void                nm_setting_ip_config_remove_address (NMSettingIPConfig *setting,
-                                                         int i);
-

-Removes the address at index i. -

-
+

nm_setting_ip_config_remove_address ()

+
void
+nm_setting_ip_config_remove_address (NMSettingIPConfig *setting,
+                                     int i);
+

Removes the address at index i +.

+
+

Parameters

+
--+++ - - + + + - - + + +

setting :

the NMSettingIPConfig -

setting

the NMSettingIPConfig

 

i :

index number of the address to remove

i

index number of the address to remove

 
+
-

nm_setting_ip_config_remove_address_by_value ()

-
gboolean            nm_setting_ip_config_remove_address_by_value
-                                                        (NMSettingIPConfig *setting,
-                                                         NMIPAddress *address);
-

-Removes the address address. -

-
+

nm_setting_ip_config_remove_address_by_value ()

+
gboolean
+nm_setting_ip_config_remove_address_by_value
+                               (NMSettingIPConfig *setting,
+                                NMIPAddress *address);
+

Removes the address address +.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + +

setting :

the NMSettingIPConfig -

address :

the IP address to remove

setting

the NMSettingIPConfig

 

Returns :

-TRUE if the address was found and removed; FALSE if it was not.

address

the IP address to remove

 
+
+

Returns

+

TRUE if the address was found and removed; FALSE if it was not.

+

+
+
-

nm_setting_ip_config_clear_addresses ()

-
void                nm_setting_ip_config_clear_addresses
-                                                        (NMSettingIPConfig *setting);
-

-Removes all configured addresses. -

-
+

nm_setting_ip_config_clear_addresses ()

+
void
+nm_setting_ip_config_clear_addresses (NMSettingIPConfig *setting);
+

Removes all configured addresses.

+
+

Parameters

+
--+++ - - + + +

setting :

the NMSettingIPConfig -

setting

the NMSettingIPConfig

 
+
-

nm_setting_ip_config_get_gateway ()

-
const char *        nm_setting_ip_config_get_gateway    (NMSettingIPConfig *setting);
-
+

nm_setting_ip_config_get_gateway ()

+
const char *
+nm_setting_ip_config_get_gateway (NMSettingIPConfig *setting);
+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSettingIPConfig -

Returns :

the IP address of the gateway associated with this configuration, or -NULL.

setting

the NMSettingIPConfig

 
+
+

Returns

+

the IP address of the gateway associated with this configuration, or +NULL.

+

+
+
-

nm_setting_ip_config_get_num_routes ()

-
guint               nm_setting_ip_config_get_num_routes (NMSettingIPConfig *setting);
-
+

nm_setting_ip_config_get_num_routes ()

+
guint
+nm_setting_ip_config_get_num_routes (NMSettingIPConfig *setting);
+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSettingIPConfig -

Returns :

the number of configured routes

setting

the NMSettingIPConfig

 
+
+

Returns

+

the number of configured routes

+

+
+
-

nm_setting_ip_config_get_route ()

-
NMIPRoute *         nm_setting_ip_config_get_route      (NMSettingIPConfig *setting,
-                                                         int i);
-
+

nm_setting_ip_config_get_route ()

+
NMIPRoute *
+nm_setting_ip_config_get_route (NMSettingIPConfig *setting,
+                                int i);
+
+

Parameters

+
--+++ - - - - - - + + + - - + + +

setting :

the NMSettingIPConfig -

i :

index number of the route to return

setting

the NMSettingIPConfig

 

Returns :

the route at index i -

i

index number of the route to return

 
+
+

Returns

+

the route at index i +

+

+
+
-

nm_setting_ip_config_add_route ()

-
gboolean            nm_setting_ip_config_add_route      (NMSettingIPConfig *setting,
-                                                         NMIPRoute *route);
-

-Adds a new route and associated information to the setting. The -given route is duplicated internally and is not changed by this function. -

-
+

nm_setting_ip_config_add_route ()

+
gboolean
+nm_setting_ip_config_add_route (NMSettingIPConfig *setting,
+                                NMIPRoute *route);
+

Adds a new route and associated information to the setting. The +given route is duplicated internally and is not changed by this function.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + +

setting :

the NMSettingIPConfig -

route :

the route to add

setting

the NMSettingIPConfig

 

Returns :

-TRUE if the route was added; FALSE if the route was already known.

route

the route to add

 
+
+

Returns

+

TRUE if the route was added; FALSE if the route was already known.

+

+
+
-

nm_setting_ip_config_remove_route ()

-
void                nm_setting_ip_config_remove_route   (NMSettingIPConfig *setting,
-                                                         int i);
-

-Removes the route at index i. -

-
+

nm_setting_ip_config_remove_route ()

+
void
+nm_setting_ip_config_remove_route (NMSettingIPConfig *setting,
+                                   int i);
+

Removes the route at index i +.

+
+

Parameters

+
--+++ - - + + + - - + + +

setting :

the NMSettingIPConfig -

setting

the NMSettingIPConfig

 

i :

index number of the route

i

index number of the route

 
+
-

nm_setting_ip_config_remove_route_by_value ()

-
gboolean            nm_setting_ip_config_remove_route_by_value
-                                                        (NMSettingIPConfig *setting,
-                                                         NMIPRoute *route);
-

-Removes the route route. -

-
+

nm_setting_ip_config_remove_route_by_value ()

+
gboolean
+nm_setting_ip_config_remove_route_by_value
+                               (NMSettingIPConfig *setting,
+                                NMIPRoute *route);
+

Removes the route route +.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + +

setting :

the NMSettingIPConfig -

route :

the route to remove

setting

the NMSettingIPConfig

 

Returns :

-TRUE if the route was found and removed; FALSE if it was not.

route

the route to remove

 
+
+

Returns

+

TRUE if the route was found and removed; FALSE if it was not.

+

+
+
-

nm_setting_ip_config_clear_routes ()

-
void                nm_setting_ip_config_clear_routes   (NMSettingIPConfig *setting);
-

-Removes all configured routes. -

-
+

nm_setting_ip_config_clear_routes ()

+
void
+nm_setting_ip_config_clear_routes (NMSettingIPConfig *setting);
+

Removes all configured routes.

+
+

Parameters

+
--+++ - - + + +

setting :

the NMSettingIPConfig -

setting

the NMSettingIPConfig

 
+
-

nm_setting_ip_config_get_route_metric ()

-
gint64              nm_setting_ip_config_get_route_metric
-                                                        (NMSettingIPConfig *setting);
-

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

-
+

nm_setting_ip_config_get_route_metric ()

+
gint64
+nm_setting_ip_config_get_route_metric (NMSettingIPConfig *setting);
+

Returns the value contained in the “route-metric” +property.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSettingIPConfig -

Returns :

the route metric that is used for routes that don't explicitly -specify a metric. See "route-metric" for more details.

setting

the NMSettingIPConfig

 
+
+

Returns

+

the route metric that is used for routes that don't explicitly +specify a metric. See “route-metric” for more details.

+

+
+
-

nm_setting_ip_config_get_ignore_auto_routes ()

-
gboolean            nm_setting_ip_config_get_ignore_auto_routes
-                                                        (NMSettingIPConfig *setting);
-

-Returns the value contained in the "ignore-auto-routes" -property. -

-
+

nm_setting_ip_config_get_ignore_auto_routes ()

+
gboolean
+nm_setting_ip_config_get_ignore_auto_routes
+                               (NMSettingIPConfig *setting);
+

Returns the value contained in the “ignore-auto-routes” +property.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSettingIPConfig -

Returns :

-TRUE if automatically configured (ie via DHCP) routes should be -ignored.

setting

the NMSettingIPConfig

 
+
+

Returns

+

TRUE if automatically configured (ie via DHCP) routes should be +ignored.

+

+
+
-

nm_setting_ip_config_get_ignore_auto_dns ()

-
gboolean            nm_setting_ip_config_get_ignore_auto_dns
-                                                        (NMSettingIPConfig *setting);
-

-Returns the value contained in the "ignore-auto-dns" -property. -

-
+

nm_setting_ip_config_get_ignore_auto_dns ()

+
gboolean
+nm_setting_ip_config_get_ignore_auto_dns
+                               (NMSettingIPConfig *setting);
+

Returns the value contained in the “ignore-auto-dns” +property.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSettingIPConfig -

Returns :

-TRUE if automatically configured (ie via DHCP) DNS information -should be ignored.

setting

the NMSettingIPConfig

 
+
+

Returns

+

TRUE if automatically configured (ie via DHCP) DNS information +should be ignored.

+

+
+
-

nm_setting_ip_config_get_dhcp_hostname ()

-
const char *        nm_setting_ip_config_get_dhcp_hostname
-                                                        (NMSettingIPConfig *setting);
-

-Returns the value contained in the "dhcp-hostname" -property. -

-
+

nm_setting_ip_config_get_dhcp_hostname ()

+
const char *
+nm_setting_ip_config_get_dhcp_hostname
+                               (NMSettingIPConfig *setting);
+

Returns the value contained in the “dhcp-hostname” +property.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSettingIPConfig -

Returns :

the configured hostname to send to the DHCP server

setting

the NMSettingIPConfig

 
+
+

Returns

+

the configured hostname to send to the DHCP server

+

+
+
-

nm_setting_ip_config_get_dhcp_send_hostname ()

-
gboolean            nm_setting_ip_config_get_dhcp_send_hostname
-                                                        (NMSettingIPConfig *setting);
-

-Returns the value contained in the "dhcp-send-hostname" -property. -

-
+

nm_setting_ip_config_get_dhcp_send_hostname ()

+
gboolean
+nm_setting_ip_config_get_dhcp_send_hostname
+                               (NMSettingIPConfig *setting);
+

Returns the value contained in the “dhcp-send-hostname” +property.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSettingIPConfig -

Returns :

-TRUE if NetworkManager should send the machine hostname to the -DHCP server when requesting addresses to allow the server to automatically -update DNS information for this machine.

setting

the NMSettingIPConfig

 
+
+

Returns

+

TRUE if NetworkManager should send the machine hostname to the +DHCP server when requesting addresses to allow the server to automatically +update DNS information for this machine.

+

+
+
-

nm_setting_ip_config_get_never_default ()

-
gboolean            nm_setting_ip_config_get_never_default
-                                                        (NMSettingIPConfig *setting);
-

-Returns the value contained in the "never-default" -property. -

-
+

nm_setting_ip_config_get_never_default ()

+
gboolean
+nm_setting_ip_config_get_never_default
+                               (NMSettingIPConfig *setting);
+

Returns the value contained in the “never-default” +property.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSettingIPConfig -

Returns :

-TRUE if this connection should never be the default -connection

setting

the NMSettingIPConfig

 
+
+

Returns

+

TRUE if this connection should never be the default +connection

+

+
+
-

nm_setting_ip_config_get_may_fail ()

-
gboolean            nm_setting_ip_config_get_may_fail   (NMSettingIPConfig *setting);
-

-Returns the value contained in the "may-fail" -property. -

-
+

nm_setting_ip_config_get_may_fail ()

+
gboolean
+nm_setting_ip_config_get_may_fail (NMSettingIPConfig *setting);
+

Returns the value contained in the “may-fail” +property.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSettingIPConfig -

Returns :

-TRUE if this connection doesn't require this type of IP -addressing to complete for the connection to succeed.

setting

the NMSettingIPConfig

 
+
+

Returns

+

TRUE if this connection doesn't require this type of IP +addressing to complete for the connection to succeed.

+

+
+
-

Property Details

+

Types and Values

-

The "addresses" property

-
  "addresses"                GPtrArray*            : Read / Write
-

-Array of IP addresses. -

+

NM_SETTING_IP_CONFIG_METHOD

+
#define NM_SETTING_IP_CONFIG_METHOD             "method"
+

-Element-Type: NMIPAddress


-

The "dhcp-hostname" property

-
  "dhcp-hostname"            gchar*                : Read / Write
+

NM_SETTING_IP_CONFIG_DNS

+
#define NM_SETTING_IP_CONFIG_DNS                "dns"
+

-If the "dhcp-send-hostname" property is TRUE, then the -specified name will be sent to the DHCP server when acquiring a lease.

-

Default value: NULL


-

The "dhcp-send-hostname" property

-
  "dhcp-send-hostname"       gboolean              : Read / Write / Construct
+

NM_SETTING_IP_CONFIG_DNS_SEARCH

+
#define NM_SETTING_IP_CONFIG_DNS_SEARCH         "dns-search"
+

-If TRUE, a hostname is sent to the DHCP server when acquiring a lease. -Some DHCP servers use this hostname to update DNS databases, essentially -providing a static hostname for the computer. If the -"dhcp-hostname" property is NULL and this property is -TRUE, the current persistent hostname of the computer is sent.

-

Default value: TRUE


-

The "dns" property

-
  "dns"                      GStrv                 : Read / Write
+

NM_SETTING_IP_CONFIG_ADDRESSES

+
#define NM_SETTING_IP_CONFIG_ADDRESSES          "addresses"
+

-Array of IP addresses of DNS servers.


-

The "dns-search" property

-
  "dns-search"               GStrv                 : Read / Write
+

NM_SETTING_IP_CONFIG_GATEWAY

+
#define NM_SETTING_IP_CONFIG_GATEWAY            "gateway"
+

-Array of DNS search domains.


-

The "gateway" property

-
  "gateway"                  gchar*                : Read / Write
+

NM_SETTING_IP_CONFIG_ROUTES

+
#define NM_SETTING_IP_CONFIG_ROUTES             "routes"
+

-The gateway associated with this configuration. This is only meaningful -if "addresses" is also set.

-

Default value: NULL


-

The "ignore-auto-dns" property

-
  "ignore-auto-dns"          gboolean              : Read / Write / Construct
+

NM_SETTING_IP_CONFIG_ROUTE_METRIC

+
#define NM_SETTING_IP_CONFIG_ROUTE_METRIC       "route-metric"
+

-When "method" is set to "auto" and this property to -TRUE, automatically configured nameservers and search domains are -ignored and only nameservers and search domains specified in the -"dns" and "dns-search" properties, if -any, are used.

-

Default value: FALSE


-

The "ignore-auto-routes" property

-
  "ignore-auto-routes"       gboolean              : Read / Write / Construct
+

NM_SETTING_IP_CONFIG_IGNORE_AUTO_ROUTES

+
#define NM_SETTING_IP_CONFIG_IGNORE_AUTO_ROUTES "ignore-auto-routes"
+

-When "method" is set to "auto" and this property to -TRUE, automatically configured routes are ignored and only routes -specified in the "routes" property, if any, are used.

-

Default value: FALSE


-

The "may-fail" property

-
  "may-fail"                 gboolean              : Read / Write / Construct
+

NM_SETTING_IP_CONFIG_IGNORE_AUTO_DNS

+
#define NM_SETTING_IP_CONFIG_IGNORE_AUTO_DNS    "ignore-auto-dns"
+

-If TRUE, allow overall network configuration to proceed even if the -configuration specified by this property times out. Note that at least -one IP configuration must succeed or overall network configuration will -still fail. For example, in IPv6-only networks, setting this property to -TRUE on the NMSettingIP4Config allows the overall network configuration -to succeed if IPv4 configuration fails but IPv6 configuration completes -successfully.

-

Default value: TRUE


-

The "method" property

-
  "method"                   gchar*                : Read / Write
+

NM_SETTING_IP_CONFIG_DHCP_HOSTNAME

+
#define NM_SETTING_IP_CONFIG_DHCP_HOSTNAME      "dhcp-hostname"
+

-IP configuration method.

+
+
+
+

NM_SETTING_IP_CONFIG_DHCP_SEND_HOSTNAME

+
#define NM_SETTING_IP_CONFIG_DHCP_SEND_HOSTNAME "dhcp-send-hostname"
+

-NMSettingIP4Config and NMSettingIP6Config both support "auto", -"manual", and "link-local". See the subclass-specific documentation for -other values.

+
+
+
+

NM_SETTING_IP_CONFIG_NEVER_DEFAULT

+
#define NM_SETTING_IP_CONFIG_NEVER_DEFAULT      "never-default"
+

-In general, for the "auto" method, properties such as -"dns" and "routes" specify information -that is added on to the information returned from automatic -configuration. The "ignore-auto-routes" and -"ignore-auto-dns" properties modify this behavior.

+
+
+
+

NM_SETTING_IP_CONFIG_MAY_FAIL

+
#define NM_SETTING_IP_CONFIG_MAY_FAIL           "may-fail"
+

-For methods that imply no upstream network, such as "shared" or -"link-local", these properties must be empty.

+
+
+
+

Property Details

+
+

The “addresses” property

+
  “addresses”                GPtrArray *
+

+

Flags: Read / Write

+
+
+
+

The “dhcp-hostname” property

+
  “dhcp-hostname”            gchar *
+

+

Flags: Read / Write

Default value: NULL


-

The "never-default" property

-
  "never-default"            gboolean              : Read / Write / Construct
-

-If TRUE, this connection will never be the default connection for this -IP type, meaning it will never be assigned the default route by -NetworkManager. -

+

The “dhcp-send-hostname” property

+
  “dhcp-send-hostname”       gboolean
+

+

Flags: Read / Write / Construct

+

Default value: TRUE

+
+
+
+

The “dns” property

+
  “dns”                      GStrv
+

+

Flags: Read / Write

+
+
+
+

The “dns-search” property

+
  “dns-search”               GStrv
+

+

Flags: Read / Write

+
+
+
+

The “gateway” property

+
  “gateway”                  gchar *
+

+

Flags: Read / Write

+

Default value: NULL

+
+
+
+

The “ignore-auto-dns” property

+
  “ignore-auto-dns”          gboolean
+

+

Flags: Read / Write / Construct

Default value: FALSE


-

The "route-metric" property

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

-The default metric for routes that don't explicitly specify a metric. -The default value -1 means that the metric is choosen automatically -based on the device type. -The metric applies to dynamic routes, manual (static) routes that -don't have an explicit metric setting, address prefix routes, and -the default route. -Note that for IPv6, the kernel accepts zero (0) but coerces it to -1024 (user default). Hence, setting this property to zero effectively -mean setting it to 1024. -For IPv4, zero is a regular value for the metric. -

+

The “ignore-auto-routes” property

+
  “ignore-auto-routes”       gboolean
+

+

Flags: Read / Write / Construct

+

Default value: FALSE

+
+
+
+

The “may-fail” property

+
  “may-fail”                 gboolean
+

+

Flags: Read / Write / Construct

+

Default value: TRUE

+
+
+
+

The “method” property

+
  “method”                   gchar *
+

+

Flags: Read / Write

+

Default value: NULL

+
+
+
+

The “never-default” property

+
  “never-default”            gboolean
+

+

Flags: Read / Write / Construct

+

Default value: FALSE

+
+
+
+

The “route-metric” property

+
  “route-metric”             gint64
+

+

Flags: Read / Write / Construct

Allowed values: [-1,4294967295]

Default value: -1


-

The "routes" property

-
  "routes"                   GPtrArray*            : Read / Write
-

-Array of IP routes. -

-

-Element-Type: NMIPRoute -

+

The “routes” property

+
  “routes”                   GPtrArray *
+

+

Flags: Read / Write

+ Generated by GTK-Doc V1.21 \ No newline at end of file diff --git a/docs/libnm/html/NMSettingInfiniband.html b/docs/libnm/html/NMSettingInfiniband.html index 42a8063c..d68c9929 100644 --- a/docs/libnm/html/NMSettingInfiniband.html +++ b/docs/libnm/html/NMSettingInfiniband.html @@ -2,34 +2,28 @@ -NMSettingInfiniband +libnm Reference Manual: NMSettingInfiniband - + - - - - - - - - - - + + + + + + +
@@ -37,355 +31,435 @@

NMSettingInfiniband

NMSettingInfiniband — Describes connection properties for IP-over-InfiniBand networks

- +
-
-

Object Hierarchy

-
-  GObject
-   +----NMSetting
-         +----NMSettingInfiniband
-
+

Functions

+
++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+NMSetting * + +nm_setting_infiniband_new () +
const char * + +nm_setting_infiniband_get_mac_address () +
+guint32 + +nm_setting_infiniband_get_mtu () +
const char * + +nm_setting_infiniband_get_transport_mode () +
+int + +nm_setting_infiniband_get_p_key () +
const char * + +nm_setting_infiniband_get_parent () +
const char * + +nm_setting_infiniband_get_virtual_interface_name () +

Properties

-
-  "mac-address"              gchar*                : Read / Write
-  "mtu"                      guint                 : Read / Write / Construct
-  "p-key"                    gint                  : Read / Write / Construct
-  "parent"                   gchar*                : Read / Write / Construct
-  "transport-mode"           gchar*                : Read / Write / Construct
+
+++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+gchar *mac-addressRead / Write
guintmtuRead / Write / Construct
gintp-keyRead / Write / Construct
+gchar *parentRead / Write / Construct
+gchar *transport-modeRead / Write / Construct
+
+
+

Types and Values

+ +
+
+

Object Hierarchy

+
    GObject
+    ╰── NMSetting
+        ╰── NMSettingInfiniband
 

Description

-

-The NMSettingInfiniband object is a NMSetting subclass that describes properties -necessary for connection to IP-over-InfiniBand networks. -

+

The NMSettingInfiniband object is a NMSetting subclass that describes properties +necessary for connection to IP-over-InfiniBand networks.

-

Details

+

Functions

-

NM_SETTING_INFINIBAND_SETTING_NAME

-
#define NM_SETTING_INFINIBAND_SETTING_NAME "infiniband"
-
-

-

+

nm_setting_infiniband_new ()

+
NMSetting *
+nm_setting_infiniband_new (void);
+

Creates a new NMSettingInfiniband object with default values.

+
+

Returns

+

the new empty NMSettingInfiniband object.

+

[transfer full]

-
-
-

NM_SETTING_INFINIBAND_MAC_ADDRESS

-
#define NM_SETTING_INFINIBAND_MAC_ADDRESS    "mac-address"
-
-

-


-

NM_SETTING_INFINIBAND_MTU

-
#define NM_SETTING_INFINIBAND_MTU            "mtu"
-
-

-

+

nm_setting_infiniband_get_mac_address ()

+
const char *
+nm_setting_infiniband_get_mac_address (NMSettingInfiniband *setting);
+
+

Parameters

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

setting

the NMSettingInfiniband

 
-
-
-

NM_SETTING_INFINIBAND_TRANSPORT_MODE

-
#define NM_SETTING_INFINIBAND_TRANSPORT_MODE "transport-mode"
-
-

-

+
+

Returns

+

the “mac-address” property of the setting

+

-
-
-

NM_SETTING_INFINIBAND_P_KEY

-
#define NM_SETTING_INFINIBAND_P_KEY          "p-key"
-
-

-


-

NM_SETTING_INFINIBAND_PARENT

-
#define NM_SETTING_INFINIBAND_PARENT         "parent"
-
-

-

+

nm_setting_infiniband_get_mtu ()

+
guint32
+nm_setting_infiniband_get_mtu (NMSettingInfiniband *setting);
+
+

Parameters

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

setting

the NMSettingInfiniband

 
+
+
+

Returns

+

the “mtu” property of the setting

+

-
-
-

struct NMSettingInfiniband

-
struct NMSettingInfiniband;
-

-


-

NMSettingInfinibandClass

-
typedef struct {
-	NMSettingClass parent;
-} NMSettingInfinibandClass;
-
-

-

+

nm_setting_infiniband_get_transport_mode ()

+
const char *
+nm_setting_infiniband_get_transport_mode
+                               (NMSettingInfiniband *setting);
+

Returns the transport mode for this device. Either 'datagram' or +'connected'.

+
+

Parameters

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

setting

the NMSettingInfiniband

 
+
+
+

Returns

+

the IPoIB transport mode

+

+

-

nm_setting_infiniband_new ()

-
NMSetting *         nm_setting_infiniband_new           (void);
-

-Creates a new NMSettingInfiniband object with default values. -

-
+

nm_setting_infiniband_get_p_key ()

+
int
+nm_setting_infiniband_get_p_key (NMSettingInfiniband *setting);
+

Returns the P_Key to use for this device. A value of -1 means to +use the default P_Key (aka "the P_Key at index 0"). Otherwise it is +a 16-bit unsigned integer.

+
+

Parameters

+
--+++ - - + + +

Returns :

the new empty NMSettingInfiniband object. [transfer full] -

setting

the NMSettingInfiniband

 
+
+

Returns

+

the IPoIB P_Key

+

+
+

-

nm_setting_infiniband_get_mac_address ()

-
const char *        nm_setting_infiniband_get_mac_address
-                                                        (NMSettingInfiniband *setting);
-
+

nm_setting_infiniband_get_parent ()

+
const char *
+nm_setting_infiniband_get_parent (NMSettingInfiniband *setting);
+

Returns the parent interface name for this device, if set.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSettingInfiniband -

Returns :

the "mac-address" property of the setting

setting

the NMSettingInfiniband

 
+
+

Returns

+

the parent interface name

+

+
+

-

nm_setting_infiniband_get_mtu ()

-
guint32             nm_setting_infiniband_get_mtu       (NMSettingInfiniband *setting);
-
+

nm_setting_infiniband_get_virtual_interface_name ()

+
const char *
+nm_setting_infiniband_get_virtual_interface_name
+                               (NMSettingInfiniband *setting);
+

Returns the interface name created by combining “parent” +and “p-key”. (If either property is unset, this will +return NULL.)

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSettingInfiniband -

Returns :

the "mtu" property of the setting

setting

the NMSettingInfiniband

 
+
+

Returns

+

the interface name, or NULL

+

+
+
+
+
+

Types and Values

+
+

NM_SETTING_INFINIBAND_SETTING_NAME

+
#define NM_SETTING_INFINIBAND_SETTING_NAME "infiniband"
+
+

+

+

-

nm_setting_infiniband_get_transport_mode ()

-
const char *        nm_setting_infiniband_get_transport_mode
-                                                        (NMSettingInfiniband *setting);
+

NM_SETTING_INFINIBAND_MAC_ADDRESS

+
#define NM_SETTING_INFINIBAND_MAC_ADDRESS    "mac-address"
+

-Returns the transport mode for this device. Either 'datagram' or -'connected'.

-
---- - - - - - - - - - - -

setting :

the NMSettingInfiniband -

Returns :

the IPoIB transport mode

-

nm_setting_infiniband_get_p_key ()

-
int                 nm_setting_infiniband_get_p_key     (NMSettingInfiniband *setting);
+

NM_SETTING_INFINIBAND_MTU

+
#define NM_SETTING_INFINIBAND_MTU            "mtu"
+

-Returns the P_Key to use for this device. A value of -1 means to -use the default P_Key (aka "the P_Key at index 0"). Otherwise it is -a 16-bit unsigned integer.

-
---- - - - - - - - - - - -

setting :

the NMSettingInfiniband -

Returns :

the IPoIB P_Key

-

nm_setting_infiniband_get_parent ()

-
const char *        nm_setting_infiniband_get_parent    (NMSettingInfiniband *setting);
+

NM_SETTING_INFINIBAND_TRANSPORT_MODE

+
#define NM_SETTING_INFINIBAND_TRANSPORT_MODE "transport-mode"
+
+

+

+
+
+
+

NM_SETTING_INFINIBAND_P_KEY

+
#define NM_SETTING_INFINIBAND_P_KEY          "p-key"
+

-Returns the parent interface name for this device, if set.

-
---- - - - - - - - - - - -

setting :

the NMSettingInfiniband -

Returns :

the parent interface name

-

nm_setting_infiniband_get_virtual_interface_name ()

-
const char *        nm_setting_infiniband_get_virtual_interface_name
-                                                        (NMSettingInfiniband *setting);
+

NM_SETTING_INFINIBAND_PARENT

+
#define NM_SETTING_INFINIBAND_PARENT         "parent"
+

-Returns the interface name created by combining "parent" -and "p-key". (If either property is unset, this will -return NULL.)

-
---- - - - - - - - - - - -

setting :

the NMSettingInfiniband -

Returns :

the interface name, or NULL -

Property Details

-

The "mac-address" property

-
  "mac-address"              gchar*                : Read / Write
-

-If specified, this connection will only apply to the IPoIB device whose -permanent MAC address matches. This property does not change the MAC -address of the device (i.e. MAC spoofing). -

+

The “mac-address” property

+
  “mac-address”              gchar *
+

+

Flags: Read / Write

Default value: NULL


-

The "mtu" property

-
  "mtu"                      guint                 : Read / Write / Construct
-

-If non-zero, only transmit packets of the specified size or smaller, -breaking larger packets up into multiple frames. -

+

The “mtu” property

+
  “mtu”                      guint
+

+

Flags: Read / Write / Construct

Default value: 0


-

The "p-key" property

-
  "p-key"                    gint                  : Read / Write / Construct
-

-The InfiniBand P_Key to use for this device. A value of -1 means to use -the default P_Key (aka "the P_Key at index 0"). Otherwise it is a 16-bit -unsigned integer, whose high bit is set if it is a "full membership" -P_Key. -

+

The “p-key” property

+
  “p-key”                    gint
+

+

Flags: Read / Write / Construct

Allowed values: [-1,65535]

Default value: -1


-

The "parent" property

-
  "parent"                   gchar*                : Read / Write / Construct
-

-The interface name of the parent device of this device. Normally NULL, -but if the "p_key" property is set, then you must -specify the base device by setting either this property or -"mac-address". -

+

The “parent” property

+
  “parent”                   gchar *
+

+

Flags: Read / Write / Construct

Default value: NULL


-

The "transport-mode" property

-
  "transport-mode"           gchar*                : Read / Write / Construct
-

-The IP-over-InfiniBand transport mode. Either "datagram" or -"connected". -

+

The “transport-mode” property

+
  “transport-mode”           gchar *
+

+

Flags: Read / Write / Construct

Default value: NULL

+ Generated by GTK-Doc V1.21
\ No newline at end of file diff --git a/docs/libnm/html/NMSettingOlpcMesh.html b/docs/libnm/html/NMSettingOlpcMesh.html index 0c3eb7bb..8291a313 100644 --- a/docs/libnm/html/NMSettingOlpcMesh.html +++ b/docs/libnm/html/NMSettingOlpcMesh.html @@ -2,34 +2,28 @@ -NMSettingOlpcMesh +libnm Reference Manual: NMSettingOlpcMesh - + - - - - - - - - - - + + + + + + +
@@ -37,37 +31,111 @@

NMSettingOlpcMesh

NMSettingOlpcMesh

- +
-
-

Object Hierarchy

-
-  GObject
-   +----NMSetting
-         +----NMSettingOlpcMesh
-
+

Functions

+
++++ + + + + + + + + + + + + + + + + + + +
+NMSetting * + +nm_setting_olpc_mesh_new () +
+GBytes * + +nm_setting_olpc_mesh_get_ssid () +
+guint32 + +nm_setting_olpc_mesh_get_channel () +
const char * + +nm_setting_olpc_mesh_get_dhcp_anycast_address () +

Properties

-
-  "channel"                  guint                 : Read / Write / Construct
-  "dhcp-anycast-address"     gchar*                : Read / Write
-  "ssid"                     GBytes*               : Read / Write
+
+++++ + + + + + + + + + + + + + + + + + +
guintchannelRead / Write / Construct
+gchar *dhcp-anycast-addressRead / Write
+GBytes *ssidRead / Write
+
+
+

Types and Values

+ +
+
+

Object Hierarchy

+
    GObject
+    ╰── NMSetting
+        ╰── NMSettingOlpcMesh
 
@@ -76,101 +144,85 @@ const char * -

Details

+

Functions

-

NM_SETTING_OLPC_MESH_SETTING_NAME

-
#define NM_SETTING_OLPC_MESH_SETTING_NAME "802-11-olpc-mesh"
-
-

-

+

nm_setting_olpc_mesh_new ()

+
NMSetting *
+nm_setting_olpc_mesh_new (void);
+

Creates a new NMSettingOlpcMesh object with default values.

+
+

Returns

+

the new empty NMSettingOlpcMesh object

+

-
-
-

NM_SETTING_OLPC_MESH_SSID

-
#define NM_SETTING_OLPC_MESH_SSID                 "ssid"
-
-

-


-

NM_SETTING_OLPC_MESH_CHANNEL

-
#define NM_SETTING_OLPC_MESH_CHANNEL              "channel"
-
-

-

+

nm_setting_olpc_mesh_get_ssid ()

+
GBytes *
+nm_setting_olpc_mesh_get_ssid (NMSettingOlpcMesh *setting);
+
+

Returns

+

.

+

[transfer none]

+

-

NM_SETTING_OLPC_MESH_DHCP_ANYCAST_ADDRESS

-
#define NM_SETTING_OLPC_MESH_DHCP_ANYCAST_ADDRESS "dhcp-anycast-address"
-
+

nm_setting_olpc_mesh_get_channel ()

+
guint32
+nm_setting_olpc_mesh_get_channel (NMSettingOlpcMesh *setting);

+
+

Returns

+

+

-

struct NMSettingOlpcMesh

-
struct NMSettingOlpcMesh;
+

nm_setting_olpc_mesh_get_dhcp_anycast_address ()

+
const char *
+nm_setting_olpc_mesh_get_dhcp_anycast_address
+                               (NMSettingOlpcMesh *setting);

+
+

Returns

+

-
+
+
+
+

Types and Values

-

NMSettingOlpcMeshClass

-
typedef struct {
-	NMSettingClass parent;
-} NMSettingOlpcMeshClass;
+

NM_SETTING_OLPC_MESH_SETTING_NAME

+
#define NM_SETTING_OLPC_MESH_SETTING_NAME "802-11-olpc-mesh"
 


-

nm_setting_olpc_mesh_new ()

-
NMSetting *         nm_setting_olpc_mesh_new            (void);
+

NM_SETTING_OLPC_MESH_SSID

+
#define NM_SETTING_OLPC_MESH_SSID                 "ssid"
+

-Creates a new NMSettingOlpcMesh object with default values.

-
---- - - - - -

Returns :

the new empty NMSettingOlpcMesh object
-
-
-
-

nm_setting_olpc_mesh_get_ssid ()

-
GBytes *            nm_setting_olpc_mesh_get_ssid       (NMSettingOlpcMesh *setting);
-
---- - - - - -

Returns :

. [transfer none] -

-

nm_setting_olpc_mesh_get_channel ()

-
guint32             nm_setting_olpc_mesh_get_channel    (NMSettingOlpcMesh *setting);
+

NM_SETTING_OLPC_MESH_CHANNEL

+
#define NM_SETTING_OLPC_MESH_CHANNEL              "channel"
+


-

nm_setting_olpc_mesh_get_dhcp_anycast_address ()

-
const char *        nm_setting_olpc_mesh_get_dhcp_anycast_address
-                                                        (NMSettingOlpcMesh *setting);
+

NM_SETTING_OLPC_MESH_DHCP_ANYCAST_ADDRESS

+
#define NM_SETTING_OLPC_MESH_DHCP_ANYCAST_ADDRESS "dhcp-anycast-address"
+

@@ -178,36 +230,31 @@ Creates a new

Property Details

-

The "channel" property

-
  "channel"                  guint                 : Read / Write / Construct
-

-Channel on which the mesh network to join is located. -

+

The “channel” property

+
  “channel”                  guint
+

+

Flags: Read / Write / Construct

Default value: 0


-

The "dhcp-anycast-address" property

-
  "dhcp-anycast-address"     gchar*                : Read / Write
-

-Anycast DHCP MAC address used when requesting an IP address via DHCP. -The specific anycast address used determines which DHCP server class -answers the request. -

+

The “dhcp-anycast-address” property

+
  “dhcp-anycast-address”     gchar *
+

+

Flags: Read / Write

Default value: NULL


-

The "ssid" property

-
  "ssid"                     GBytes*               : Read / Write
-

-SSID of the mesh network to join. -

+

The “ssid” property

+
  “ssid”                     GBytes *
+

+

Flags: Read / Write

+ Generated by GTK-Doc V1.21
\ No newline at end of file diff --git a/docs/libnm/html/NMSettingPpp.html b/docs/libnm/html/NMSettingPpp.html index d1752861..832e3fcd 100644 --- a/docs/libnm/html/NMSettingPpp.html +++ b/docs/libnm/html/NMSettingPpp.html @@ -2,34 +2,28 @@ -NMSettingPpp +libnm Reference Manual: NMSettingPpp - + - - - - - - - - - - + + + + + + +
@@ -38,868 +32,1159 @@

NMSettingPpp — Describes connection properties for devices/networks that require PPP to deliver IP capability

- +
-
-

Synopsis

-
#define             NM_SETTING_PPP_SETTING_NAME
-#define             NM_SETTING_PPP_NOAUTH
-#define             NM_SETTING_PPP_REFUSE_EAP
-#define             NM_SETTING_PPP_REFUSE_PAP
-#define             NM_SETTING_PPP_REFUSE_CHAP
-#define             NM_SETTING_PPP_REFUSE_MSCHAP
-#define             NM_SETTING_PPP_REFUSE_MSCHAPV2
-#define             NM_SETTING_PPP_NOBSDCOMP
-#define             NM_SETTING_PPP_NODEFLATE
-#define             NM_SETTING_PPP_NO_VJ_COMP
-#define             NM_SETTING_PPP_REQUIRE_MPPE
-#define             NM_SETTING_PPP_REQUIRE_MPPE_128
-#define             NM_SETTING_PPP_MPPE_STATEFUL
-#define             NM_SETTING_PPP_CRTSCTS
-#define             NM_SETTING_PPP_BAUD
-#define             NM_SETTING_PPP_MRU
-#define             NM_SETTING_PPP_MTU
-#define             NM_SETTING_PPP_LCP_ECHO_FAILURE
-#define             NM_SETTING_PPP_LCP_ECHO_INTERVAL
-struct              NMSettingPpp;
-                    NMSettingPppClass;
-NMSetting *         nm_setting_ppp_new                  (void);
-gboolean            nm_setting_ppp_get_noauth           (NMSettingPpp *setting);
-gboolean            nm_setting_ppp_get_refuse_eap       (NMSettingPpp *setting);
-gboolean            nm_setting_ppp_get_refuse_pap       (NMSettingPpp *setting);
-gboolean            nm_setting_ppp_get_refuse_chap      (NMSettingPpp *setting);
-gboolean            nm_setting_ppp_get_refuse_mschap    (NMSettingPpp *setting);
-gboolean            nm_setting_ppp_get_refuse_mschapv2  (NMSettingPpp *setting);
-gboolean            nm_setting_ppp_get_nobsdcomp        (NMSettingPpp *setting);
-gboolean            nm_setting_ppp_get_nodeflate        (NMSettingPpp *setting);
-gboolean            nm_setting_ppp_get_no_vj_comp       (NMSettingPpp *setting);
-gboolean            nm_setting_ppp_get_require_mppe     (NMSettingPpp *setting);
-gboolean            nm_setting_ppp_get_require_mppe_128 (NMSettingPpp *setting);
-gboolean            nm_setting_ppp_get_mppe_stateful    (NMSettingPpp *setting);
-gboolean            nm_setting_ppp_get_crtscts          (NMSettingPpp *setting);
-guint32             nm_setting_ppp_get_baud             (NMSettingPpp *setting);
-guint32             nm_setting_ppp_get_mru              (NMSettingPpp *setting);
-guint32             nm_setting_ppp_get_mtu              (NMSettingPpp *setting);
-guint32             nm_setting_ppp_get_lcp_echo_failure (NMSettingPpp *setting);
-guint32             nm_setting_ppp_get_lcp_echo_interval
-                                                        (NMSettingPpp *setting);
-
-
-

Object Hierarchy

-
-  GObject
-   +----NMSetting
-         +----NMSettingPpp
-
+

Functions

+
++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+NMSetting * + +nm_setting_ppp_new () +
+gboolean + +nm_setting_ppp_get_noauth () +
+gboolean + +nm_setting_ppp_get_refuse_eap () +
+gboolean + +nm_setting_ppp_get_refuse_pap () +
+gboolean + +nm_setting_ppp_get_refuse_chap () +
+gboolean + +nm_setting_ppp_get_refuse_mschap () +
+gboolean + +nm_setting_ppp_get_refuse_mschapv2 () +
+gboolean + +nm_setting_ppp_get_nobsdcomp () +
+gboolean + +nm_setting_ppp_get_nodeflate () +
+gboolean + +nm_setting_ppp_get_no_vj_comp () +
+gboolean + +nm_setting_ppp_get_require_mppe () +
+gboolean + +nm_setting_ppp_get_require_mppe_128 () +
+gboolean + +nm_setting_ppp_get_mppe_stateful () +
+gboolean + +nm_setting_ppp_get_crtscts () +
+guint32 + +nm_setting_ppp_get_baud () +
+guint32 + +nm_setting_ppp_get_mru () +
+guint32 + +nm_setting_ppp_get_mtu () +
+guint32 + +nm_setting_ppp_get_lcp_echo_failure () +
+guint32 + +nm_setting_ppp_get_lcp_echo_interval () +

Properties

-
-  "baud"                     guint                 : Read / Write / Construct
-  "crtscts"                  gboolean              : Read / Write / Construct
-  "lcp-echo-failure"         guint                 : Read / Write / Construct
-  "lcp-echo-interval"        guint                 : Read / Write / Construct
-  "mppe-stateful"            gboolean              : Read / Write / Construct
-  "mru"                      guint                 : Read / Write / Construct
-  "mtu"                      guint                 : Read / Write / Construct
-  "no-vj-comp"               gboolean              : Read / Write / Construct
-  "noauth"                   gboolean              : Read / Write / Construct
-  "nobsdcomp"                gboolean              : Read / Write / Construct
-  "nodeflate"                gboolean              : Read / Write / Construct
-  "refuse-chap"              gboolean              : Read / Write / Construct
-  "refuse-eap"               gboolean              : Read / Write / Construct
-  "refuse-mschap"            gboolean              : Read / Write / Construct
-  "refuse-mschapv2"          gboolean              : Read / Write / Construct
-  "refuse-pap"               gboolean              : Read / Write / Construct
-  "require-mppe"             gboolean              : Read / Write / Construct
-  "require-mppe-128"         gboolean              : Read / Write / Construct
-
+
+++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
guintbaudRead / Write / Construct
gbooleancrtsctsRead / Write / Construct
guintlcp-echo-failureRead / Write / Construct
guintlcp-echo-intervalRead / Write / Construct
gbooleanmppe-statefulRead / Write / Construct
guintmruRead / Write / Construct
guintmtuRead / Write / Construct
gbooleanno-vj-compRead / Write / Construct
gbooleannoauthRead / Write / Construct
gbooleannobsdcompRead / Write / Construct
gbooleannodeflateRead / Write / Construct
gbooleanrefuse-chapRead / Write / Construct
gbooleanrefuse-eapRead / Write / Construct
gbooleanrefuse-mschapRead / Write / Construct
gbooleanrefuse-mschapv2Read / Write / Construct
gbooleanrefuse-papRead / Write / Construct
gbooleanrequire-mppeRead / Write / Construct
gbooleanrequire-mppe-128Read / Write / Construct
-

Description

-

-The NMSettingPpp object is a NMSetting subclass that describes properties -necessary for connection to networks that require PPP transport, like PPPoE -cable and DSL modems and some mobile broadband devices. -

+

Types and Values

+
-

Details

-
-

NM_SETTING_PPP_SETTING_NAME

-
#define NM_SETTING_PPP_SETTING_NAME "ppp"
-
-

-

-
-
-
-

NM_SETTING_PPP_NOAUTH

-
#define NM_SETTING_PPP_NOAUTH            "noauth"
-
-

-

-
-
-
-

NM_SETTING_PPP_REFUSE_EAP

-
#define NM_SETTING_PPP_REFUSE_EAP        "refuse-eap"
-
-

-

-
-
-
-

NM_SETTING_PPP_REFUSE_PAP

-
#define NM_SETTING_PPP_REFUSE_PAP        "refuse-pap"
-
-

-

-
-
-
-

NM_SETTING_PPP_REFUSE_CHAP

-
#define NM_SETTING_PPP_REFUSE_CHAP       "refuse-chap"
-
-

-

-
-
-
-

NM_SETTING_PPP_REFUSE_MSCHAP

-
#define NM_SETTING_PPP_REFUSE_MSCHAP     "refuse-mschap"
-
-

-

-
-
-
-

NM_SETTING_PPP_REFUSE_MSCHAPV2

-
#define NM_SETTING_PPP_REFUSE_MSCHAPV2   "refuse-mschapv2"
-
-

-

-
-
-
-

NM_SETTING_PPP_NOBSDCOMP

-
#define NM_SETTING_PPP_NOBSDCOMP         "nobsdcomp"
-
-

-

-
-
-
-

NM_SETTING_PPP_NODEFLATE

-
#define NM_SETTING_PPP_NODEFLATE         "nodeflate"
-
-

-

-
-
-
-

NM_SETTING_PPP_NO_VJ_COMP

-
#define NM_SETTING_PPP_NO_VJ_COMP        "no-vj-comp"
-
-

-

-
-
-
-

NM_SETTING_PPP_REQUIRE_MPPE

-
#define NM_SETTING_PPP_REQUIRE_MPPE      "require-mppe"
-
-

-

-
-
-
-

NM_SETTING_PPP_REQUIRE_MPPE_128

-
#define NM_SETTING_PPP_REQUIRE_MPPE_128  "require-mppe-128"
-
-

-

-
-
-
-

NM_SETTING_PPP_MPPE_STATEFUL

-
#define NM_SETTING_PPP_MPPE_STATEFUL     "mppe-stateful"
-
-

-

-
-
-
-

NM_SETTING_PPP_CRTSCTS

-
#define NM_SETTING_PPP_CRTSCTS           "crtscts"
-
-

-

-
-
-
-

NM_SETTING_PPP_BAUD

-
#define NM_SETTING_PPP_BAUD              "baud"
-
-

-

-
-
-
-

NM_SETTING_PPP_MRU

-
#define NM_SETTING_PPP_MRU               "mru"
+

Object Hierarchy

+
    GObject
+    ╰── NMSetting
+        ╰── NMSettingPpp
 
-

-

-
-
-

NM_SETTING_PPP_MTU

-
#define NM_SETTING_PPP_MTU               "mtu"
-
-

-

+
+

Description

+

The NMSettingPpp object is a NMSetting subclass that describes properties +necessary for connection to networks that require PPP transport, like PPPoE +cable and DSL modems and some mobile broadband devices.

-
+
+

Functions

-

NM_SETTING_PPP_LCP_ECHO_FAILURE

-
#define NM_SETTING_PPP_LCP_ECHO_FAILURE  "lcp-echo-failure"
-
-

-

+

nm_setting_ppp_new ()

+
NMSetting *
+nm_setting_ppp_new (void);
+

Creates a new NMSettingPpp object with default values.

+
+

Returns

+

the new empty NMSettingPpp object.

+

[transfer full]

-
-
-

NM_SETTING_PPP_LCP_ECHO_INTERVAL

-
#define NM_SETTING_PPP_LCP_ECHO_INTERVAL "lcp-echo-interval"
-
-

-


-

struct NMSettingPpp

-
struct NMSettingPpp;
-

-

-
-
-
-

NMSettingPppClass

-
typedef struct {
-	NMSettingClass parent;
-} NMSettingPppClass;
-
-

-

-
-
-
-

nm_setting_ppp_new ()

-
NMSetting *         nm_setting_ppp_new                  (void);
-

-Creates a new NMSettingPpp object with default values. -

-
+

nm_setting_ppp_get_noauth ()

+
gboolean
+nm_setting_ppp_get_noauth (NMSettingPpp *setting);
+
+

Parameters

+
--+++ - - + + +

Returns :

the new empty NMSettingPpp object. [transfer full] -

setting

the NMSettingPpp

 
-
-
-

nm_setting_ppp_get_noauth ()

-
gboolean            nm_setting_ppp_get_noauth           (NMSettingPpp *setting);
-
---- - - - - - - - - - - -

setting :

the NMSettingPpp -

Returns :

the "noauth" property of the setting
+
+

Returns

+

the “noauth” property of the setting

+

+

-

nm_setting_ppp_get_refuse_eap ()

-
gboolean            nm_setting_ppp_get_refuse_eap       (NMSettingPpp *setting);
-
+

nm_setting_ppp_get_refuse_eap ()

+
gboolean
+nm_setting_ppp_get_refuse_eap (NMSettingPpp *setting);
+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSettingPpp -

Returns :

the "refuse-eap" property of the setting

setting

the NMSettingPpp

 
+
+

Returns

+

the “refuse-eap” property of the setting

+

+
+

-

nm_setting_ppp_get_refuse_pap ()

-
gboolean            nm_setting_ppp_get_refuse_pap       (NMSettingPpp *setting);
-
+

nm_setting_ppp_get_refuse_pap ()

+
gboolean
+nm_setting_ppp_get_refuse_pap (NMSettingPpp *setting);
+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSettingPpp -

Returns :

the "refuse-pap" property of the setting

setting

the NMSettingPpp

 
+
+

Returns

+

the “refuse-pap” property of the setting

+

+
+

-

nm_setting_ppp_get_refuse_chap ()

-
gboolean            nm_setting_ppp_get_refuse_chap      (NMSettingPpp *setting);
-
+

nm_setting_ppp_get_refuse_chap ()

+
gboolean
+nm_setting_ppp_get_refuse_chap (NMSettingPpp *setting);
+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSettingPpp -

Returns :

the "refuse-chap" property of the setting

setting

the NMSettingPpp

 
+
+

Returns

+

the “refuse-chap” property of the setting

+

+
+

-

nm_setting_ppp_get_refuse_mschap ()

-
gboolean            nm_setting_ppp_get_refuse_mschap    (NMSettingPpp *setting);
-
+

nm_setting_ppp_get_refuse_mschap ()

+
gboolean
+nm_setting_ppp_get_refuse_mschap (NMSettingPpp *setting);
+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSettingPpp -

Returns :

the "refuse-mschap" property of the setting

setting

the NMSettingPpp

 
+
+

Returns

+

the “refuse-mschap” property of the setting

+

+
+

-

nm_setting_ppp_get_refuse_mschapv2 ()

-
gboolean            nm_setting_ppp_get_refuse_mschapv2  (NMSettingPpp *setting);
-
+

nm_setting_ppp_get_refuse_mschapv2 ()

+
gboolean
+nm_setting_ppp_get_refuse_mschapv2 (NMSettingPpp *setting);
+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSettingPpp -

Returns :

the "refuse-mschapv2" property of the setting

setting

the NMSettingPpp

 
+
+

Returns

+

the “refuse-mschapv2” property of the setting

+

+
+

-

nm_setting_ppp_get_nobsdcomp ()

-
gboolean            nm_setting_ppp_get_nobsdcomp        (NMSettingPpp *setting);
-
+

nm_setting_ppp_get_nobsdcomp ()

+
gboolean
+nm_setting_ppp_get_nobsdcomp (NMSettingPpp *setting);
+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSettingPpp -

Returns :

the "nobsdcomp" property of the setting

setting

the NMSettingPpp

 
+
+

Returns

+

the “nobsdcomp” property of the setting

+

+
+
-

nm_setting_ppp_get_nodeflate ()

-
gboolean            nm_setting_ppp_get_nodeflate        (NMSettingPpp *setting);
-
+

nm_setting_ppp_get_nodeflate ()

+
gboolean
+nm_setting_ppp_get_nodeflate (NMSettingPpp *setting);
+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSettingPpp -

Returns :

the "nodeflate" property of the setting

setting

the NMSettingPpp

 
+
+

Returns

+

the “nodeflate” property of the setting

+

+
+
-

nm_setting_ppp_get_no_vj_comp ()

-
gboolean            nm_setting_ppp_get_no_vj_comp       (NMSettingPpp *setting);
-
+

nm_setting_ppp_get_no_vj_comp ()

+
gboolean
+nm_setting_ppp_get_no_vj_comp (NMSettingPpp *setting);
+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSettingPpp -

Returns :

the "no-vj-comp" property of the setting

setting

the NMSettingPpp

 
+
+

Returns

+

the “no-vj-comp” property of the setting

+

+
+
-

nm_setting_ppp_get_require_mppe ()

-
gboolean            nm_setting_ppp_get_require_mppe     (NMSettingPpp *setting);
-
+

nm_setting_ppp_get_require_mppe ()

+
gboolean
+nm_setting_ppp_get_require_mppe (NMSettingPpp *setting);
+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSettingPpp -

Returns :

the "require-mppe" property of the setting

setting

the NMSettingPpp

 
+
+

Returns

+

the “require-mppe” property of the setting

+

+
+
-

nm_setting_ppp_get_require_mppe_128 ()

-
gboolean            nm_setting_ppp_get_require_mppe_128 (NMSettingPpp *setting);
-
+

nm_setting_ppp_get_require_mppe_128 ()

+
gboolean
+nm_setting_ppp_get_require_mppe_128 (NMSettingPpp *setting);
+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSettingPpp -

Returns :

the "require-mppe-128" property of the setting

setting

the NMSettingPpp

 
+
+

Returns

+

the “require-mppe-128” property of the setting

+

+
+
-

nm_setting_ppp_get_mppe_stateful ()

-
gboolean            nm_setting_ppp_get_mppe_stateful    (NMSettingPpp *setting);
-
+

nm_setting_ppp_get_mppe_stateful ()

+
gboolean
+nm_setting_ppp_get_mppe_stateful (NMSettingPpp *setting);
+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSettingPpp -

Returns :

the "mppe-stateful" property of the setting

setting

the NMSettingPpp

 
+
+

Returns

+

the “mppe-stateful” property of the setting

+

+
+
-

nm_setting_ppp_get_crtscts ()

-
gboolean            nm_setting_ppp_get_crtscts          (NMSettingPpp *setting);
-
+

nm_setting_ppp_get_crtscts ()

+
gboolean
+nm_setting_ppp_get_crtscts (NMSettingPpp *setting);
+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSettingPpp -

Returns :

the "crtscts" property of the setting

setting

the NMSettingPpp

 
+
+

Returns

+

the “crtscts” property of the setting

+

+
+
-

nm_setting_ppp_get_baud ()

-
guint32             nm_setting_ppp_get_baud             (NMSettingPpp *setting);
-
+

nm_setting_ppp_get_baud ()

+
guint32
+nm_setting_ppp_get_baud (NMSettingPpp *setting);
+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSettingPpp -

Returns :

the "baud" property of the setting

setting

the NMSettingPpp

 
+
+

Returns

+

the “baud” property of the setting

+

+
+
-

nm_setting_ppp_get_mru ()

-
guint32             nm_setting_ppp_get_mru              (NMSettingPpp *setting);
-
+

nm_setting_ppp_get_mru ()

+
guint32
+nm_setting_ppp_get_mru (NMSettingPpp *setting);
+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSettingPpp -

Returns :

the "mru" property of the setting

setting

the NMSettingPpp

 
+
+

Returns

+

the “mru” property of the setting

+

+
+
-

nm_setting_ppp_get_mtu ()

-
guint32             nm_setting_ppp_get_mtu              (NMSettingPpp *setting);
-
+

nm_setting_ppp_get_mtu ()

+
guint32
+nm_setting_ppp_get_mtu (NMSettingPpp *setting);
+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSettingPpp -

Returns :

the "mtu" property of the setting

setting

the NMSettingPpp

 
+
+

Returns

+

the “mtu” property of the setting

+

+
+
-

nm_setting_ppp_get_lcp_echo_failure ()

-
guint32             nm_setting_ppp_get_lcp_echo_failure (NMSettingPpp *setting);
-
+

nm_setting_ppp_get_lcp_echo_failure ()

+
guint32
+nm_setting_ppp_get_lcp_echo_failure (NMSettingPpp *setting);
+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSettingPpp -

Returns :

the "lcp-echo-failure" property of the setting

setting

the NMSettingPpp

 
+
+

Returns

+

the “lcp-echo-failure” property of the setting

+

+
+
-

nm_setting_ppp_get_lcp_echo_interval ()

-
guint32             nm_setting_ppp_get_lcp_echo_interval
-                                                        (NMSettingPpp *setting);
-
+

nm_setting_ppp_get_lcp_echo_interval ()

+
guint32
+nm_setting_ppp_get_lcp_echo_interval (NMSettingPpp *setting);
+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSettingPpp -

Returns :

the "lcp-echo-interval" property of the setting

setting

the NMSettingPpp

 
+
+

Returns

+

the “lcp-echo-interval” property of the setting

+

+
+
-

Property Details

+

Types and Values

-

The "baud" property

-
  "baud"                     guint                 : Read / Write / Construct
+

NM_SETTING_PPP_SETTING_NAME

+
#define NM_SETTING_PPP_SETTING_NAME "ppp"
+

-If non-zero, instruct pppd to set the serial port to the specified -baudrate. This value should normally be left as 0 to automatically -choose the speed.

-

Default value: 0


-

The "crtscts" property

-
  "crtscts"                  gboolean              : Read / Write / Construct
+

NM_SETTING_PPP_NOAUTH

+
#define NM_SETTING_PPP_NOAUTH            "noauth"
+

-If TRUE, specify that pppd should set the serial port to use hardware -flow control with RTS and CTS signals. This value should normally be set -to FALSE.

-

Default value: FALSE


-

The "lcp-echo-failure" property

-
  "lcp-echo-failure"         guint                 : Read / Write / Construct
+

NM_SETTING_PPP_REFUSE_EAP

+
#define NM_SETTING_PPP_REFUSE_EAP        "refuse-eap"
+

-If non-zero, instruct pppd to presume the connection to the peer has -failed if the specified number of LCP echo-requests go unanswered by the -peer. The "lcp-echo-interval" property must also be set to a non-zero -value if this property is used.

-

Default value: 0


-

The "lcp-echo-interval" property

-
  "lcp-echo-interval"        guint                 : Read / Write / Construct
+

NM_SETTING_PPP_REFUSE_PAP

+
#define NM_SETTING_PPP_REFUSE_PAP        "refuse-pap"
+

-If non-zero, instruct pppd to send an LCP echo-request frame to the peer -every n seconds (where n is the specified value). Note that some PPP -peers will respond to echo requests and some will not, and it is not -possible to autodetect this.

-

Default value: 0


-

The "mppe-stateful" property

-
  "mppe-stateful"            gboolean              : Read / Write / Construct
+

NM_SETTING_PPP_REFUSE_CHAP

+
#define NM_SETTING_PPP_REFUSE_CHAP       "refuse-chap"
+

-If TRUE, stateful MPPE is used. See pppd documentation for more -information on stateful MPPE.

-

Default value: FALSE


-

The "mru" property

-
  "mru"                      guint                 : Read / Write / Construct
+

NM_SETTING_PPP_REFUSE_MSCHAP

+
#define NM_SETTING_PPP_REFUSE_MSCHAP     "refuse-mschap"
+
+

+

+
+
+
+

NM_SETTING_PPP_REFUSE_MSCHAPV2

+
#define NM_SETTING_PPP_REFUSE_MSCHAPV2   "refuse-mschapv2"
+

-If non-zero, instruct pppd to request that the peer send packets no -larger than the specified size. If non-zero, the MRU should be between -128 and 16384.

-

Allowed values: <= 16384

-

Default value: 0


-

The "mtu" property

-
  "mtu"                      guint                 : Read / Write / Construct
+

NM_SETTING_PPP_NOBSDCOMP

+
#define NM_SETTING_PPP_NOBSDCOMP         "nobsdcomp"
+

-If non-zero, instruct pppd to send packets no larger than the specified -size.

-

Default value: 0


-

The "no-vj-comp" property

-
  "no-vj-comp"               gboolean              : Read / Write / Construct
+

NM_SETTING_PPP_NODEFLATE

+
#define NM_SETTING_PPP_NODEFLATE         "nodeflate"
+

-If TRUE, Van Jacobsen TCP header compression will not be requested.

-

Default value: FALSE


-

The "noauth" property

-
  "noauth"                   gboolean              : Read / Write / Construct
+

NM_SETTING_PPP_NO_VJ_COMP

+
#define NM_SETTING_PPP_NO_VJ_COMP        "no-vj-comp"
+

-If TRUE, do not require the other side (usually the PPP server) to -authenticate itself to the client. If FALSE, require authentication -from the remote side. In almost all cases, this should be TRUE.

-

Default value: TRUE


-

The "nobsdcomp" property

-
  "nobsdcomp"                gboolean              : Read / Write / Construct
+

NM_SETTING_PPP_REQUIRE_MPPE

+
#define NM_SETTING_PPP_REQUIRE_MPPE      "require-mppe"
+

-If TRUE, BSD compression will not be requested.

-

Default value: FALSE


-

The "nodeflate" property

-
  "nodeflate"                gboolean              : Read / Write / Construct
+

NM_SETTING_PPP_REQUIRE_MPPE_128

+
#define NM_SETTING_PPP_REQUIRE_MPPE_128  "require-mppe-128"
+

-If TRUE, "deflate" compression will not be requested.

-

Default value: FALSE


-

The "refuse-chap" property

-
  "refuse-chap"              gboolean              : Read / Write / Construct
+

NM_SETTING_PPP_MPPE_STATEFUL

+
#define NM_SETTING_PPP_MPPE_STATEFUL     "mppe-stateful"
+

-If TRUE, the CHAP authentication method will not be used.

-

Default value: FALSE


-

The "refuse-eap" property

-
  "refuse-eap"               gboolean              : Read / Write / Construct
+

NM_SETTING_PPP_CRTSCTS

+
#define NM_SETTING_PPP_CRTSCTS           "crtscts"
+

-If TRUE, the EAP authentication method will not be used.

-

Default value: FALSE


-

The "refuse-mschap" property

-
  "refuse-mschap"            gboolean              : Read / Write / Construct
+

NM_SETTING_PPP_BAUD

+
#define NM_SETTING_PPP_BAUD              "baud"
+

-If TRUE, the MSCHAP authentication method will not be used.

-

Default value: FALSE


-

The "refuse-mschapv2" property

-
  "refuse-mschapv2"          gboolean              : Read / Write / Construct
+

NM_SETTING_PPP_MRU

+
#define NM_SETTING_PPP_MRU               "mru"
+

-If TRUE, the MSCHAPv2 authentication method will not be used.

-

Default value: FALSE


-

The "refuse-pap" property

-
  "refuse-pap"               gboolean              : Read / Write / Construct
+

NM_SETTING_PPP_MTU

+
#define NM_SETTING_PPP_MTU               "mtu"
+

-If TRUE, the PAP authentication method will not be used.

-

Default value: FALSE


-

The "require-mppe" property

-
  "require-mppe"             gboolean              : Read / Write / Construct
+

NM_SETTING_PPP_LCP_ECHO_FAILURE

+
#define NM_SETTING_PPP_LCP_ECHO_FAILURE  "lcp-echo-failure"
+

-If TRUE, MPPE (Microsoft Point-to-Point Encrpytion) will be required for -the PPP session. If either 64-bit or 128-bit MPPE is not available the -session will fail. Note that MPPE is not used on mobile broadband -connections.

-

Default value: FALSE


-

The "require-mppe-128" property

-
  "require-mppe-128"         gboolean              : Read / Write / Construct
+

NM_SETTING_PPP_LCP_ECHO_INTERVAL

+
#define NM_SETTING_PPP_LCP_ECHO_INTERVAL "lcp-echo-interval"
+

-If TRUE, 128-bit MPPE (Microsoft Point-to-Point Encrpytion) will be -required for the PPP session, and the "require-mppe" property must also -be set to TRUE. If 128-bit MPPE is not available the session will fail.

+
+
+
+

Property Details

+
+

The “baud” property

+
  “baud”                     guint
+

+

Flags: Read / Write / Construct

+

Default value: 0

+
+
+
+

The “crtscts” property

+
  “crtscts”                  gboolean
+

+

Flags: Read / Write / Construct

+

Default value: FALSE

+
+
+
+

The “lcp-echo-failure” property

+
  “lcp-echo-failure”         guint
+

+

Flags: Read / Write / Construct

+

Default value: 0

+
+
+
+

The “lcp-echo-interval” property

+
  “lcp-echo-interval”        guint
+

+

Flags: Read / Write / Construct

+

Default value: 0

+
+
+
+

The “mppe-stateful” property

+
  “mppe-stateful”            gboolean
+

+

Flags: Read / Write / Construct

+

Default value: FALSE

+
+
+
+

The “mru” property

+
  “mru”                      guint
+

+

Flags: Read / Write / Construct

+

Allowed values: <= 16384

+

Default value: 0

+
+
+
+

The “mtu” property

+
  “mtu”                      guint
+

+

Flags: Read / Write / Construct

+

Default value: 0

+
+
+
+

The “no-vj-comp” property

+
  “no-vj-comp”               gboolean
+

+

Flags: Read / Write / Construct

+

Default value: FALSE

+
+
+
+

The “noauth” property

+
  “noauth”                   gboolean
+

+

Flags: Read / Write / Construct

+

Default value: TRUE

+
+
+
+

The “nobsdcomp” property

+
  “nobsdcomp”                gboolean
+

+

Flags: Read / Write / Construct

+

Default value: FALSE

+
+
+
+

The “nodeflate” property

+
  “nodeflate”                gboolean
+

+

Flags: Read / Write / Construct

+

Default value: FALSE

+
+
+
+

The “refuse-chap” property

+
  “refuse-chap”              gboolean
+

+

Flags: Read / Write / Construct

+

Default value: FALSE

+
+
+
+

The “refuse-eap” property

+
  “refuse-eap”               gboolean
+

+

Flags: Read / Write / Construct

+

Default value: FALSE

+
+
+
+

The “refuse-mschap” property

+
  “refuse-mschap”            gboolean
+

+

Flags: Read / Write / Construct

+

Default value: FALSE

+
+
+
+

The “refuse-mschapv2” property

+
  “refuse-mschapv2”          gboolean
+

+

Flags: Read / Write / Construct

+

Default value: FALSE

+
+
+
+

The “refuse-pap” property

+
  “refuse-pap”               gboolean
+

+

Flags: Read / Write / Construct

+

Default value: FALSE

+
+
+
+

The “require-mppe” property

+
  “require-mppe”             gboolean
+

+

Flags: Read / Write / Construct

+

Default value: FALSE

+
+
+
+

The “require-mppe-128” property

+
  “require-mppe-128”         gboolean
+

+

Flags: Read / Write / Construct

Default value: FALSE

+ Generated by GTK-Doc V1.21 \ No newline at end of file diff --git a/docs/libnm/html/NMSettingPppoe.html b/docs/libnm/html/NMSettingPppoe.html index 583028d3..daa5f943 100644 --- a/docs/libnm/html/NMSettingPppoe.html +++ b/docs/libnm/html/NMSettingPppoe.html @@ -2,34 +2,28 @@ -NMSettingPppoe +libnm Reference Manual: NMSettingPppoe - + - - - - - - - - - - + + + + + + +
@@ -37,52 +31,255 @@

NMSettingPppoe

NMSettingPppoe — Describes PPPoE connection properties

- +
-
-

Object Hierarchy

-
-  GObject
-   +----NMSetting
-         +----NMSettingPppoe
-
+

Functions

+
++++ + + + + + + + + + + + + + + + + + + + + + + +
+NMSetting * + +nm_setting_pppoe_new () +
const char * + +nm_setting_pppoe_get_service () +
const char * + +nm_setting_pppoe_get_username () +
const char * + +nm_setting_pppoe_get_password () +
+NMSettingSecretFlags + +nm_setting_pppoe_get_password_flags () +

Properties

-
-  "password"                 gchar*                : Read / Write
-  "password-flags"           NMSettingSecretFlags  : Read / Write
-  "service"                  gchar*                : Read / Write
-  "username"                 gchar*                : Read / Write
+
+++++ + + + + + + + + + + + + + + + + + + + + + + +
+gchar *passwordRead / Write
NMSettingSecretFlagspassword-flagsRead / Write
+gchar *serviceRead / Write
+gchar *usernameRead / Write
+
+
+

Types and Values

+ +
+
+

Object Hierarchy

+
    GObject
+    ╰── NMSetting
+        ╰── NMSettingPppoe
 

Description

-

-The NMSettingPppoe object is a NMSetting subclass that describes +

The NMSettingPppoe object is a NMSetting subclass that describes properties necessary for connection to networks that require PPPoE connections -to provide IP transport, for example cable or DSL modems. -

+to provide IP transport, for example cable or DSL modems.

+
+
+

Functions

+
+

nm_setting_pppoe_new ()

+
NMSetting *
+nm_setting_pppoe_new (void);
+

Creates a new NMSettingPppoe object with default values.

+
+

Returns

+

the new empty NMSettingPppoe object.

+

[transfer full]

+
+
+
+
+

nm_setting_pppoe_get_service ()

+
const char *
+nm_setting_pppoe_get_service (NMSettingPppoe *setting);
+
+

Parameters

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

setting

the NMSettingPppoe

 
+
+
+

Returns

+

the “service” property of the setting

+

+
+
+
+
+

nm_setting_pppoe_get_username ()

+
const char *
+nm_setting_pppoe_get_username (NMSettingPppoe *setting);
+
+

Parameters

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

setting

the NMSettingPppoe

 
+
+
+

Returns

+

the “username” property of the setting

+

+
+
+
+
+

nm_setting_pppoe_get_password ()

+
const char *
+nm_setting_pppoe_get_password (NMSettingPppoe *setting);
+
+

Parameters

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

setting

the NMSettingPppoe

 
+
+
+

Returns

+

the “password” property of the setting

+

+
+
+
+
+

nm_setting_pppoe_get_password_flags ()

+
NMSettingSecretFlags
+nm_setting_pppoe_get_password_flags (NMSettingPppoe *setting);
+
+

Parameters

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

setting

the NMSettingPppoe

 
+
+
+

Returns

+

the NMSettingSecretFlags pertaining to the “password”

+

+
+
-

Details

+

Types and Values

NM_SETTING_PPPOE_SETTING_NAME

#define NM_SETTING_PPPOE_SETTING_NAME "pppoe"
@@ -122,176 +319,43 @@ to provide IP transport, for example cable or DSL modems.
 

-
-
-

struct NMSettingPppoe

-
struct NMSettingPppoe;
-

-

-
-
-
-

NMSettingPppoeClass

-
typedef struct {
-	NMSettingClass parent;
-} NMSettingPppoeClass;
-
-

-

-
-
-
-

nm_setting_pppoe_new ()

-
NMSetting *         nm_setting_pppoe_new                (void);
-

-Creates a new NMSettingPppoe object with default values. -

-
---- - - - - -

Returns :

the new empty NMSettingPppoe object. [transfer full] -
-
-
-
-

nm_setting_pppoe_get_service ()

-
const char *        nm_setting_pppoe_get_service        (NMSettingPppoe *setting);
-
---- - - - - - - - - - - -

setting :

the NMSettingPppoe -

Returns :

the "service" property of the setting
-
-
-
-

nm_setting_pppoe_get_username ()

-
const char *        nm_setting_pppoe_get_username       (NMSettingPppoe *setting);
-
---- - - - - - - - - - - -

setting :

the NMSettingPppoe -

Returns :

the "username" property of the setting
-
-
-
-

nm_setting_pppoe_get_password ()

-
const char *        nm_setting_pppoe_get_password       (NMSettingPppoe *setting);
-
---- - - - - - - - - - - -

setting :

the NMSettingPppoe -

Returns :

the "password" property of the setting
-
-
-
-

nm_setting_pppoe_get_password_flags ()

-
NMSettingSecretFlags nm_setting_pppoe_get_password_flags
-                                                        (NMSettingPppoe *setting);
-
---- - - - - - - - - - - -

setting :

the NMSettingPppoe -

Returns :

the NMSettingSecretFlags pertaining to the "password" -
-

Property Details

-

The "password" property

-
  "password"                 gchar*                : Read / Write
-

-Password used to authenticate with the PPPoE service. -

+

The “password” property

+
  “password”                 gchar *
+

+

Flags: Read / Write

Default value: NULL


-

The "password-flags" property

-
  "password-flags"           NMSettingSecretFlags  : Read / Write
-

-Flags indicating how to handle the "password" property. -

+

The “password-flags” property

+
  “password-flags”           NMSettingSecretFlags
+

+

Flags: Read / Write


-

The "service" property

-
  "service"                  gchar*                : Read / Write
-

-If specified, instruct PPPoE to only initiate sessions with access -concentrators that provide the specified service. For most providers, -this should be left blank. It is only required if there are multiple -access concentrators or a specific service is known to be required. -

+

The “service” property

+
  “service”                  gchar *
+

+

Flags: Read / Write

Default value: NULL


-

The "username" property

-
  "username"                 gchar*                : Read / Write
-

-Username used to authenticate with the PPPoE service. -

+

The “username” property

+
  “username”                 gchar *
+

+

Flags: Read / Write

Default value: NULL

+ Generated by GTK-Doc V1.21 \ No newline at end of file diff --git a/docs/libnm/html/NMSettingSerial.html b/docs/libnm/html/NMSettingSerial.html index 65971e1c..f27e73ee 100644 --- a/docs/libnm/html/NMSettingSerial.html +++ b/docs/libnm/html/NMSettingSerial.html @@ -2,34 +2,28 @@ -NMSettingSerial +libnm Reference Manual: NMSettingSerial - + - - - - - - - - - - + + + + + + +
@@ -38,59 +32,304 @@

NMSettingSerial — Describes connection properties for devices that use serial communications

- +
-
-

Object Hierarchy

-
-  GEnum
-   +----NMSettingSerialParity
-
-
-  GObject
-   +----NMSetting
-         +----NMSettingSerial
-
+

Functions

+
++++ + + + + + + + + + + + + + + + + + + + + + + + + + + +
+NMSetting * + +nm_setting_serial_new () +
+guint + +nm_setting_serial_get_baud () +
+guint + +nm_setting_serial_get_bits () +
+NMSettingSerialParity + +nm_setting_serial_get_parity () +
+guint + +nm_setting_serial_get_stopbits () +
+guint64 + +nm_setting_serial_get_send_delay () +

Properties

-
-  "baud"                     guint                 : Read / Write / Construct
-  "bits"                     guint                 : Read / Write / Construct
-  "parity"                   NMSettingSerialParity  : Read / Write / Construct
-  "send-delay"               guint64               : Read / Write / Construct
-  "stopbits"                 guint                 : Read / Write / Construct
+
+++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + +
guintbaudRead / Write / Construct
guintbitsRead / Write / Construct
NMSettingSerialParityparityRead / Write / Construct
guint64send-delayRead / Write / Construct
guintstopbitsRead / Write / Construct
+
+
+

Types and Values

+ +
+
+

Object Hierarchy

+
    GEnum
+    ╰── NMSettingSerialParity
+    GObject
+    ╰── NMSetting
+        ╰── NMSettingSerial
 

Description

-

-The NMSettingSerial object is a NMSetting subclass that describes +

The NMSettingSerial object is a NMSetting subclass that describes properties necessary for connections that may use serial communications, -such as mobile broadband or analog telephone connections. -

+such as mobile broadband or analog telephone connections.

-

Details

+

Functions

+
+

nm_setting_serial_new ()

+
NMSetting *
+nm_setting_serial_new (void);
+

Creates a new NMSettingSerial object with default values.

+
+

Returns

+

the new empty NMSettingSerial object.

+

[transfer full]

+
+
+
+
+

nm_setting_serial_get_baud ()

+
guint
+nm_setting_serial_get_baud (NMSettingSerial *setting);
+
+

Parameters

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

setting

the NMSettingSerial

 
+
+
+

Returns

+

the “baud” property of the setting

+

+
+
+
+
+

nm_setting_serial_get_bits ()

+
guint
+nm_setting_serial_get_bits (NMSettingSerial *setting);
+
+

Parameters

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

setting

the NMSettingSerial

 
+
+
+

Returns

+

the “bits” property of the setting

+

+
+
+
+
+

nm_setting_serial_get_parity ()

+
NMSettingSerialParity
+nm_setting_serial_get_parity (NMSettingSerial *setting);
+
+

Parameters

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

setting

the NMSettingSerial

 
+
+
+

Returns

+

the “parity” property of the setting

+

+
+
+
+
+

nm_setting_serial_get_stopbits ()

+
guint
+nm_setting_serial_get_stopbits (NMSettingSerial *setting);
+
+

Parameters

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

setting

the NMSettingSerial

 
+
+
+

Returns

+

the “stopbits” property of the setting

+

+
+
+
+
+

nm_setting_serial_get_send_delay ()

+
guint64
+nm_setting_serial_get_send_delay (NMSettingSerial *setting);
+
+

Parameters

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

setting

the NMSettingSerial

 
+
+
+

Returns

+

the “send-delay” property of the setting

+

+
+
+
+
+

Types and Values

NM_SETTING_SERIAL_SETTING_NAME

#define NM_SETTING_SERIAL_SETTING_NAME "serial"
@@ -100,40 +339,42 @@ such as mobile broadband or analog telephone connections.
 

-

enum NMSettingSerialParity

-
typedef enum {
-	NM_SETTING_SERIAL_PARITY_NONE = 0,
-	NM_SETTING_SERIAL_PARITY_EVEN,
-	NM_SETTING_SERIAL_PARITY_ODD
-} NMSettingSerialParity;
-
-

-The parity setting of a serial port. -

-
+

enum NMSettingSerialParity

+

The parity setting of a serial port.

+
+

Members

+
--+++ - - + + - - + + - - + +

NM_SETTING_SERIAL_PARITY_NONE

No parity bits (default) +

NM_SETTING_SERIAL_PARITY_NONE

+

No parity bits (default)

 

NM_SETTING_SERIAL_PARITY_EVEN

Even parity +

NM_SETTING_SERIAL_PARITY_EVEN

+

Even parity

 

NM_SETTING_SERIAL_PARITY_ODD

Odd parity +

NM_SETTING_SERIAL_PARITY_ODD

+

Odd parity

 
+

NM_SETTING_SERIAL_BAUD

@@ -174,201 +415,47 @@ The parity setting of a serial port.

-
-
-

struct NMSettingSerial

-
struct NMSettingSerial;
-

-

-
-
-
-

NMSettingSerialClass

-
typedef struct {
-	NMSettingClass parent;
-} NMSettingSerialClass;
-
-

-

-
-
-
-

nm_setting_serial_new ()

-
NMSetting *         nm_setting_serial_new               (void);
-

-Creates a new NMSettingSerial object with default values. -

-
---- - - - - -

Returns :

the new empty NMSettingSerial object. [transfer full] -
-
-
-
-

nm_setting_serial_get_baud ()

-
guint               nm_setting_serial_get_baud          (NMSettingSerial *setting);
-
---- - - - - - - - - - - -

setting :

the NMSettingSerial -

Returns :

the "baud" property of the setting
-
-
-
-

nm_setting_serial_get_bits ()

-
guint               nm_setting_serial_get_bits          (NMSettingSerial *setting);
-
---- - - - - - - - - - - -

setting :

the NMSettingSerial -

Returns :

the "bits" property of the setting
-
-
-
-

nm_setting_serial_get_parity ()

-
NMSettingSerialParity nm_setting_serial_get_parity      (NMSettingSerial *setting);
-
---- - - - - - - - - - - -

setting :

the NMSettingSerial -

Returns :

the "parity" property of the setting
-
-
-
-

nm_setting_serial_get_stopbits ()

-
guint               nm_setting_serial_get_stopbits      (NMSettingSerial *setting);
-
---- - - - - - - - - - - -

setting :

the NMSettingSerial -

Returns :

the "stopbits" property of the setting
-
-
-
-

nm_setting_serial_get_send_delay ()

-
guint64             nm_setting_serial_get_send_delay    (NMSettingSerial *setting);
-
---- - - - - - - - - - - -

setting :

the NMSettingSerial -

Returns :

the "send-delay" property of the setting
-

Property Details

-

The "baud" property

-
  "baud"                     guint                 : Read / Write / Construct
-

-Speed to use for communication over the serial port. Note that this -value usually has no effect for mobile broadband modems as they generally -ignore speed settings and use the highest available speed. -

+

The “baud” property

+
  “baud”                     guint
+

+

Flags: Read / Write / Construct

Default value: 57600


-

The "bits" property

-
  "bits"                     guint                 : Read / Write / Construct
-

-Byte-width of the serial communication. The 8 in "8n1" for example. -

+

The “bits” property

+
  “bits”                     guint
+

+

Flags: Read / Write / Construct

Allowed values: [5,8]

Default value: 8


-

The "parity" property

-
  "parity"                   NMSettingSerialParity  : Read / Write / Construct
-

-Parity setting of the serial port. -

+

The “parity” property

+
  “parity”                   NMSettingSerialParity
+

+

Flags: Read / Write / Construct

Default value: NM_SETTING_SERIAL_PARITY_NONE


-

The "send-delay" property

-
  "send-delay"               guint64               : Read / Write / Construct
-

-Time to delay between each byte sent to the modem, in microseconds. -

+

The “send-delay” property

+
  “send-delay”               guint64
+

+

Flags: Read / Write / Construct

Default value: 0


-

The "stopbits" property

-
  "stopbits"                 guint                 : Read / Write / Construct
-

-Number of stop bits for communication on the serial port. Either 1 or 2. -The 1 in "8n1" for example. -

+

The “stopbits” property

+
  “stopbits”                 guint
+

+

Flags: Read / Write / Construct

Allowed values: [1,2]

Default value: 1

@@ -376,6 +463,6 @@ The 1 in "8n1" for example.
+ Generated by GTK-Doc V1.21 \ No newline at end of file diff --git a/docs/libnm/html/NMSettingTeam.html b/docs/libnm/html/NMSettingTeam.html index d8e50195..85f6eeea 100644 --- a/docs/libnm/html/NMSettingTeam.html +++ b/docs/libnm/html/NMSettingTeam.html @@ -2,34 +2,28 @@ -NMSettingTeam +libnm Reference Manual: NMSettingTeam - + - - - - - - - - - - + + + + + + +
@@ -37,132 +31,152 @@

NMSettingTeam

NMSettingTeam — Describes connection properties for teams

- +
-
-

Object Hierarchy

-
-  GObject
-   +----NMSetting
-         +----NMSettingTeam
-
+

Functions

+
++++ + + + + + + + + + + +
+NMSetting * + +nm_setting_team_new () +
const char * + +nm_setting_team_get_config () +

Properties

-
-  "config"                   gchar*                : Read / Write
+
+++++ + + + + + +
+gchar *configRead / Write
+
+
+

Types and Values

+
++++ + + + + + + + + + + +
#defineNM_SETTING_TEAM_SETTING_NAME
#defineNM_SETTING_TEAM_CONFIG
+
+
+

Object Hierarchy

+
    GObject
+    ╰── NMSetting
+        ╰── NMSettingTeam
 

Description

-

-The NMSettingTeam object is a NMSetting subclass that describes properties -necessary for team connections. -

+

The NMSettingTeam object is a NMSetting subclass that describes properties +necessary for team connections.

-

Details

+

Functions

-

NM_SETTING_TEAM_SETTING_NAME

-
#define NM_SETTING_TEAM_SETTING_NAME "team"
-
-

-

+

nm_setting_team_new ()

+
NMSetting *
+nm_setting_team_new (void);
+

Creates a new NMSettingTeam object with default values.

+
+

Returns

+

the new empty NMSettingTeam object.

+

[transfer full]

-
-
-

NM_SETTING_TEAM_CONFIG

-
#define NM_SETTING_TEAM_CONFIG "config"
-
-

-


-

struct NMSettingTeam

-
struct NMSettingTeam;
-

-

+

nm_setting_team_get_config ()

+
const char *
+nm_setting_team_get_config (NMSettingTeam *setting);
+
+

Parameters

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

setting

the NMSettingTeam

 
-
+
+

Returns

+

the “config” property of the setting

+

+
+
+
+
+

Types and Values

-

NMSettingTeamClass

-
typedef struct {
-	NMSettingClass parent;
-} NMSettingTeamClass;
+

NM_SETTING_TEAM_SETTING_NAME

+
#define NM_SETTING_TEAM_SETTING_NAME "team"
 


-

nm_setting_team_new ()

-
NMSetting *         nm_setting_team_new                 (void);
+

NM_SETTING_TEAM_CONFIG

+
#define NM_SETTING_TEAM_CONFIG "config"
+

-Creates a new NMSettingTeam object with default values.

-
---- - - - - -

Returns :

the new empty NMSettingTeam object. [transfer full] -
-
-
-
-

nm_setting_team_get_config ()

-
const char *        nm_setting_team_get_config          (NMSettingTeam *setting);
-
---- - - - - - - - - - - -

setting :

the NMSettingTeam -

Returns :

the "config" property of the setting

Property Details

-

The "config" property

-
  "config"                   gchar*                : Read / Write
-

-The JSON configuration for the team network interface. The property -should contain raw JSON configuration data suitable for teamd, because -the value is passed directly to teamd. If not specified, the default -configuration is used. See man teamd.conf for the format details. -

+

The “config” property

+
  “config”                   gchar *
+

+

Flags: Read / Write

Default value: NULL

+ Generated by GTK-Doc V1.21
\ No newline at end of file diff --git a/docs/libnm/html/NMSettingTeamPort.html b/docs/libnm/html/NMSettingTeamPort.html index 90835aa5..e25e1e4e 100644 --- a/docs/libnm/html/NMSettingTeamPort.html +++ b/docs/libnm/html/NMSettingTeamPort.html @@ -2,34 +2,28 @@ -NMSettingTeamPort +libnm Reference Manual: NMSettingTeamPort - + - - - - - - - - - - + + + + + + +
@@ -37,132 +31,152 @@

NMSettingTeamPort

NMSettingTeamPort — Describes connection properties for team ports

- +
-
-

Object Hierarchy

-
-  GObject
-   +----NMSetting
-         +----NMSettingTeamPort
-
+

Functions

+
++++ + + + + + + + + + + +
+NMSetting * + +nm_setting_team_port_new () +
const char * + +nm_setting_team_port_get_config () +

Properties

-
-  "config"                   gchar*                : Read / Write
+
+++++ + + + + + +
+gchar *configRead / Write
+
+
+

Types and Values

+
++++ + + + + + + + + + + +
#defineNM_SETTING_TEAM_PORT_SETTING_NAME
#defineNM_SETTING_TEAM_PORT_CONFIG
+
+
+

Object Hierarchy

+
    GObject
+    ╰── NMSetting
+        ╰── NMSettingTeamPort
 

Description

-

-The NMSettingTeamPort object is a NMSetting subclass that describes -optional properties that apply to team ports. -

+

The NMSettingTeamPort object is a NMSetting subclass that describes +optional properties that apply to team ports.

-

Details

+

Functions

-

NM_SETTING_TEAM_PORT_SETTING_NAME

-
#define NM_SETTING_TEAM_PORT_SETTING_NAME "team-port"
-
-

-

+

nm_setting_team_port_new ()

+
NMSetting *
+nm_setting_team_port_new (void);
+

Creates a new NMSettingTeamPort object with default values.

+
+

Returns

+

the new empty NMSettingTeamPort object.

+

[transfer full]

-
-
-

NM_SETTING_TEAM_PORT_CONFIG

-
#define NM_SETTING_TEAM_PORT_CONFIG     "config"
-
-

-


-

struct NMSettingTeamPort

-
struct NMSettingTeamPort;
-

-

+

nm_setting_team_port_get_config ()

+
const char *
+nm_setting_team_port_get_config (NMSettingTeamPort *setting);
+
+

Parameters

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

setting

the NMSettingTeamPort

 
-
+
+

Returns

+

the “config” property of the setting

+

+
+
+
+
+

Types and Values

-

NMSettingTeamPortClass

-
typedef struct {
-	NMSettingClass parent;
-} NMSettingTeamPortClass;
+

NM_SETTING_TEAM_PORT_SETTING_NAME

+
#define NM_SETTING_TEAM_PORT_SETTING_NAME "team-port"
 


-

nm_setting_team_port_new ()

-
NMSetting *         nm_setting_team_port_new            (void);
+

NM_SETTING_TEAM_PORT_CONFIG

+
#define NM_SETTING_TEAM_PORT_CONFIG     "config"
+

-Creates a new NMSettingTeamPort object with default values.

-
---- - - - - -

Returns :

the new empty NMSettingTeamPort object. [transfer full] -
-
-
-
-

nm_setting_team_port_get_config ()

-
const char *        nm_setting_team_port_get_config     (NMSettingTeamPort *setting);
-
---- - - - - - - - - - - -

setting :

the NMSettingTeamPort -

Returns :

the "config" property of the setting

Property Details

-

The "config" property

-
  "config"                   gchar*                : Read / Write
-

-The JSON configuration for the team port. The property should contain raw -JSON configuration data suitable for teamd, because the value is passed -directly to teamd. If not specified, the default configuration is -used. See man teamd.conf for the format details. -

+

The “config” property

+
  “config”                   gchar *
+

+

Flags: Read / Write

Default value: NULL

+ Generated by GTK-Doc V1.21
\ No newline at end of file diff --git a/docs/libnm/html/NMSettingVlan.html b/docs/libnm/html/NMSettingVlan.html index 52175ad8..a82533dc 100644 --- a/docs/libnm/html/NMSettingVlan.html +++ b/docs/libnm/html/NMSettingVlan.html @@ -2,34 +2,28 @@ -NMSettingVlan +libnm Reference Manual: NMSettingVlan - + - - - - - - - - - - + + + + + + +
@@ -37,691 +31,841 @@

NMSettingVlan

NMSettingVlan — Describes connection properties for VLAN interfaces

- +
-
-

Object Hierarchy

-
-  GObject
-   +----NMSetting
-         +----NMSettingVlan
-
-
-  GEnum
-   +----NMVlanPriorityMap
-
-
-  GFlags
-   +----NMVlanFlags
-
+

Functions

+
++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+NMSetting * + +nm_setting_vlan_new () +
const char * + +nm_setting_vlan_get_parent () +
+guint32 + +nm_setting_vlan_get_id () +
+guint32 + +nm_setting_vlan_get_flags () +
+gint32 + +nm_setting_vlan_get_num_priorities () +
+gboolean + +nm_setting_vlan_get_priority () +
+gboolean + +nm_setting_vlan_add_priority () +
+void + +nm_setting_vlan_remove_priority () +
+gboolean + +nm_setting_vlan_remove_priority_by_value () +
+gboolean + +nm_setting_vlan_remove_priority_str_by_value () +
+void + +nm_setting_vlan_clear_priorities () +
+gboolean + +nm_setting_vlan_add_priority_str () +

Properties

-
-  "egress-priority-map"      GStrv                 : Read / Write
-  "flags"                    NMVlanFlags           : Read / Write / Construct
-  "id"                       guint                 : Read / Write / Construct
-  "ingress-priority-map"     GStrv                 : Read / Write
-  "parent"                   gchar*                : Read / Write / Construct
-
-
-
-

Description

-

-The NMSettingVlan object is a NMSetting subclass that describes properties -necessary for connection to VLAN interfaces. -

-
-
-

Details

-
-

NM_SETTING_VLAN_SETTING_NAME

-
#define NM_SETTING_VLAN_SETTING_NAME "vlan"
-
-

-

-
-
-
-

NM_SETTING_VLAN_PARENT

-
#define NM_SETTING_VLAN_PARENT               "parent"
-
-

-

-
-
-
-

NM_SETTING_VLAN_ID

-
#define NM_SETTING_VLAN_ID                   "id"
-
-

-

-
-
-
-

NM_SETTING_VLAN_FLAGS

-
#define NM_SETTING_VLAN_FLAGS                "flags"
-
-

-

-
-
-
-

NM_SETTING_VLAN_INGRESS_PRIORITY_MAP

-
#define NM_SETTING_VLAN_INGRESS_PRIORITY_MAP "ingress-priority-map"
-
-

-

-
-
-
-

NM_SETTING_VLAN_EGRESS_PRIORITY_MAP

-
#define NM_SETTING_VLAN_EGRESS_PRIORITY_MAP  "egress-priority-map"
-
-

-

-
-
-
-

struct NMSettingVlan

-
struct NMSettingVlan;
-

-

-
-
-
-

NMSettingVlanClass

-
typedef struct {
-	NMSettingClass parent;
-} NMSettingVlanClass;
-
-

-

-
-
-
-

enum NMVlanPriorityMap

-
typedef enum {
-	NM_VLAN_INGRESS_MAP,
-	NM_VLAN_EGRESS_MAP
-} NMVlanPriorityMap;
-
-

-A selector for traffic priority maps; these map Linux SKB priorities -to 802.1p priorities used in VLANs. -

-
+
--+++ - - + + + - - + + + + + + + + + + + + + + + + + +

NM_VLAN_INGRESS_MAP

map for incoming data -GStrvegress-priority-mapRead / Write

NM_VLAN_EGRESS_MAP

map for outgoing data -NMVlanFlagsflagsRead / Write / Construct
guintidRead / Write / Construct
GStrvingress-priority-mapRead / Write
+gchar *parentRead / Write / Construct
-
-
-

enum NMVlanFlags

-
typedef enum {
- /*< flags >*/
-	NM_VLAN_FLAG_REORDER_HEADERS = 0x1,
-	NM_VLAN_FLAG_GVRP            = 0x2,
-	NM_VLAN_FLAG_LOOSE_BINDING   = 0x4,
-
-	/* NOTE: if adding flags update nm-setting-vlan.c::verify() */
-} NMVlanFlags;
-
-

-NMVlanFlags values control the behavior of the VLAN interface. -

-
+
+

Types and Values

+
--++ - - + + - - + + - - + + + + + + + + + + + + + + + + + + + + + +

NM_VLAN_FLAG_REORDER_HEADERS

indicates that this interface should reorder - outgoing packet headers to look more like a non-VLAN Ethernet interface -#defineNM_SETTING_VLAN_SETTING_NAME

NM_VLAN_FLAG_GVRP

indicates that this interface should use GVRP to register - itself with it's switch -#defineNM_SETTING_VLAN_PARENT

NM_VLAN_FLAG_LOOSE_BINDING

indicates that this interface's operating - state is tied to the underlying network interface but other details - (like routing) are not. -#defineNM_SETTING_VLAN_ID
#defineNM_SETTING_VLAN_FLAGS
#defineNM_SETTING_VLAN_INGRESS_PRIORITY_MAP
#defineNM_SETTING_VLAN_EGRESS_PRIORITY_MAP
enumNMVlanPriorityMap
enumNMVlanFlags
+
+

Object Hierarchy

+
    GEnum
+    ╰── NMVlanPriorityMap
+    GFlags
+    ╰── NMVlanFlags
+    GObject
+    ╰── NMSetting
+        ╰── NMSettingVlan
+
+
+
+

Description

+

The NMSettingVlan object is a NMSetting subclass that describes properties +necessary for connection to VLAN interfaces.

+
+
+

Functions

+
+

nm_setting_vlan_new ()

+
NMSetting *
+nm_setting_vlan_new (void);
+

Creates a new NMSettingVlan object with default values.

+
+

Returns

+

the new empty NMSettingVlan object.

+

[transfer full]

+
+

-

nm_setting_vlan_new ()

-
NMSetting *         nm_setting_vlan_new                 (void);
-

-Creates a new NMSettingVlan object with default values. -

-
+

nm_setting_vlan_get_parent ()

+
const char *
+nm_setting_vlan_get_parent (NMSettingVlan *setting);
+
+

Parameters

+
--+++ - - + + +

Returns :

the new empty NMSettingVlan object. [transfer full] -

setting

the NMSettingVlan

 
+
+

Returns

+

the “parent” property of the setting

+

+
+

-

nm_setting_vlan_get_parent ()

-
const char *        nm_setting_vlan_get_parent          (NMSettingVlan *setting);
-
+

nm_setting_vlan_get_id ()

+
guint32
+nm_setting_vlan_get_id (NMSettingVlan *setting);
+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSettingVlan -

Returns :

the "parent" property of the setting

setting

the NMSettingVlan

 
+
+

Returns

+

the “id” property of the setting

+

+
+

-

nm_setting_vlan_get_id ()

-
guint32             nm_setting_vlan_get_id              (NMSettingVlan *setting);
-
+

nm_setting_vlan_get_flags ()

+
guint32
+nm_setting_vlan_get_flags (NMSettingVlan *setting);
+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSettingVlan -

Returns :

the "id" property of the setting

setting

the NMSettingVlan

 
+
+

Returns

+

the “flags” property of the setting

+

+
+

-

nm_setting_vlan_get_flags ()

-
guint32             nm_setting_vlan_get_flags           (NMSettingVlan *setting);
-
+

nm_setting_vlan_get_num_priorities ()

+
gint32
+nm_setting_vlan_get_num_priorities (NMSettingVlan *setting,
+                                    NMVlanPriorityMap map);
+

Returns the number of entires in the +“ingress_priority_map” or “egress_priority_map” +properties of this setting.

+
+

Parameters

+
--+++ - - + + + - - + + +

setting :

the NMSettingVlan -

setting

the NMSettingVlan

 

Returns :

the "flags" property of the setting

map

the type of priority map

 
+
+

Returns

+

return the number of ingress/egress priority entries, -1 if error

+

+
+
-

nm_setting_vlan_get_num_priorities ()

-
gint32              nm_setting_vlan_get_num_priorities  (NMSettingVlan *setting,
-                                                         NMVlanPriorityMap map);
-

-Returns the number of entires in the -"ingress_priority_map" or "egress_priority_map" -properties of this setting. -

-
+

nm_setting_vlan_get_priority ()

+
gboolean
+nm_setting_vlan_get_priority (NMSettingVlan *setting,
+                              NMVlanPriorityMap map,
+                              guint32 idx,
+                              guint32 *out_from,
+                              guint32 *out_to);
+

Retrieve one of the entries of the “ingress_priority_map” +or “egress_priority_map” properties of this setting.

+
+

Parameters

+
--+++ - - + + + - - + + + - - + + + + + + + + + + + + +

setting :

the NMSettingVlan -

setting

the NMSettingVlan

 

map :

the type of priority map

map

the type of priority map

 

Returns :

return the number of ingress/egress priority entries, -1 if error

idx

the zero-based index of the ingress/egress priority map entry

 

out_from

on return the value of the priority map's 'from' item.

[out]

out_to

on return the value of priority map's 'to' item.

[out]
+
+

Returns

+

TRUE if a priority map was returned, FALSE if error

+

+
+
-

nm_setting_vlan_get_priority ()

-
gboolean            nm_setting_vlan_get_priority        (NMSettingVlan *setting,
-                                                         NMVlanPriorityMap map,
-                                                         guint32 idx,
-                                                         guint32 *out_from,
-                                                         guint32 *out_to);
-

-Retrieve one of the entries of the "ingress_priority_map" -or "egress_priority_map" properties of this setting. -

-
+

nm_setting_vlan_add_priority ()

+
gboolean
+nm_setting_vlan_add_priority (NMSettingVlan *setting,
+                              NMVlanPriorityMap map,
+                              guint32 from,
+                              guint32 to);
+

Adds a priority mapping to the “ingress_priority_map” or +“egress_priority_map” properties of the setting. If from + is +already in the given priority map, this function will overwrite the +existing entry with the new to +.

+

If map + is NM_VLAN_INGRESS_MAP then from + is the incoming 802.1q VLAN +Priority Code Point (PCP) value, and to + is the Linux SKB priority value.

+

If map + is NM_VLAN_EGRESS_MAP then from + is the Linux SKB priority value and +to + is the outgoing 802.1q VLAN Priority Code Point (PCP) value.

+
+

Parameters

+
--+++ - - + + + - - + + + - - - - - - - - - - + + + - - + + +

setting :

the NMSettingVlan -

setting

the NMSettingVlan

 

map :

the type of priority map

map

the type of priority map

 

idx :

the zero-based index of the ingress/egress priority map entry

out_from :

on return the value of the priority map's 'from' item. [out] -

out_to :

on return the value of priority map's 'to' item. [out] -

from

the priority to map to to +

 

Returns :

-TRUE if a priority map was returned, FALSE if error

to

the priority to map from +to

 
+
+

Returns

+

TRUE if the new priority mapping was successfully added to the +list, FALSE if error

+

+
+
-

nm_setting_vlan_add_priority ()

-
gboolean            nm_setting_vlan_add_priority        (NMSettingVlan *setting,
-                                                         NMVlanPriorityMap map,
-                                                         guint32 from,
-                                                         guint32 to);
-

-Adds a priority mapping to the "ingress_priority_map" or -"egress_priority_map" properties of the setting. If from is -already in the given priority map, this function will overwrite the -existing entry with the new to. -

-

-If map is NM_VLAN_INGRESS_MAP then from is the incoming 802.1q VLAN -Priority Code Point (PCP) value, and to is the Linux SKB priority value. -

-

-If map is NM_VLAN_EGRESS_MAP then from is the Linux SKB priority value and -to is the outgoing 802.1q VLAN Priority Code Point (PCP) value. -

-
+

nm_setting_vlan_remove_priority ()

+
void
+nm_setting_vlan_remove_priority (NMSettingVlan *setting,
+                                 NMVlanPriorityMap map,
+                                 guint32 idx);
+

Removes the priority map at index idx + from the +“ingress_priority_map” or “egress_priority_map” +properties.

+
+

Parameters

+
--+++ - - + + + - - + + + - - - - - - - - - - + + +

setting :

the NMSettingVlan -

setting

the NMSettingVlan

 

map :

the type of priority map

map

the type of priority map

 

from :

the priority to map to to -

to :

the priority to map from to

Returns :

-TRUE if the new priority mapping was successfully added to the -list, FALSE if error

idx

the zero-based index of the priority map to remove

 
+
-

nm_setting_vlan_remove_priority ()

-
void                nm_setting_vlan_remove_priority     (NMSettingVlan *setting,
-                                                         NMVlanPriorityMap map,
-                                                         guint32 idx);
-

-Removes the priority map at index idx from the -"ingress_priority_map" or "egress_priority_map" -properties. -

-
+

nm_setting_vlan_remove_priority_by_value ()

+
gboolean
+nm_setting_vlan_remove_priority_by_value
+                               (NMSettingVlan *setting,
+                                NMVlanPriorityMap map,
+                                guint32 from,
+                                guint32 to);
+

Removes the priority map form +:to + from the “ingress_priority_map” +or “egress_priority_map” (according to map + argument) +properties.

+
+

Parameters

+
--+++ - - + + + + + + + + - - + + + - - + + +

setting :

the NMSettingVlan -

setting

the NMSettingVlan

 

map

the type of priority map

 

map :

the type of priority map

from

the priority to map to to +

 

idx :

the zero-based index of the priority map to remove

to

the priority to map from +to

 
+
+

Returns

+

TRUE if the priority mapping was found and removed; FALSE if it was not.

+

+
+
-

nm_setting_vlan_remove_priority_by_value ()

-
gboolean            nm_setting_vlan_remove_priority_by_value
-                                                        (NMSettingVlan *setting,
-                                                         NMVlanPriorityMap map,
-                                                         guint32 from,
-                                                         guint32 to);
-

-Removes the priority map form:to from the "ingress_priority_map" -or "egress_priority_map" (according to map argument) -properties. -

-
+

nm_setting_vlan_remove_priority_str_by_value ()

+
gboolean
+nm_setting_vlan_remove_priority_str_by_value
+                               (NMSettingVlan *setting,
+                                NMVlanPriorityMap map,
+                                const char *str);
+

Removes the priority map str + from the “ingress_priority_map” +or “egress_priority_map” (according to map + argument) +properties.

+
+

Parameters

+
--+++ - - + + + - - + + + - - + + + + +

setting :

the NMSettingVlan -

setting

the NMSettingVlan

 

map :

the type of priority map

map

the type of priority map

 

from :

the priority to map to to -

str

the string which contains a priority map, like "3:7"

 
+
+
+

Returns

+

TRUE if the priority mapping was found and removed; FALSE if it was not.

+

+
+ +
+
+

nm_setting_vlan_clear_priorities ()

+
void
+nm_setting_vlan_clear_priorities (NMSettingVlan *setting,
+                                  NMVlanPriorityMap map);
+

Clear all the entires from “ingress_priority_map” or +“egress_priority_map” properties.

+
+

Parameters

+
+++++ + - - + + + - - + + +

to :

the priority to map from to

setting

the NMSettingVlan

 

Returns :

-TRUE if the priority mapping was found and removed; FALSE if it was not.

map

the type of priority map

 
+

-

nm_setting_vlan_remove_priority_str_by_value ()

-
gboolean            nm_setting_vlan_remove_priority_str_by_value
-                                                        (NMSettingVlan *setting,
-                                                         NMVlanPriorityMap map,
-                                                         const char *str);
-

-Removes the priority map str from the "ingress_priority_map" -or "egress_priority_map" (according to map argument) -properties. -

-
+

nm_setting_vlan_add_priority_str ()

+
gboolean
+nm_setting_vlan_add_priority_str (NMSettingVlan *setting,
+                                  NMVlanPriorityMap map,
+                                  const char *str);
+

Adds a priority map entry into either the “ingress_priority_map” +or the “egress_priority_map” properties. The priority map maps +the Linux SKB priorities to 802.1p priorities.

+
+

Parameters

+
--+++ - - + + + - - + + + - - - - - - + + +

setting :

the NMSettingVlan -

setting

the NMSettingVlan

 

map :

the type of priority map

map

the type of priority map

 

str :

the string which contains a priority map, like "3:7"

Returns :

-TRUE if the priority mapping was found and removed; FALSE if it was not.

str

the string which contains a priority map, like "3:7"

 
+
+

Returns

+

TRUE if the entry was successfully added to the list, or it +overwrote the old value, FALSE if error

+

+
+ + +
+

Types and Values

+
+

NM_SETTING_VLAN_SETTING_NAME

+
#define NM_SETTING_VLAN_SETTING_NAME "vlan"
+
+

+

+
+
+
+

NM_SETTING_VLAN_PARENT

+
#define NM_SETTING_VLAN_PARENT               "parent"
+
+

+

+
+
+
+

NM_SETTING_VLAN_ID

+
#define NM_SETTING_VLAN_ID                   "id"
+
+

+

+
+
+
+

NM_SETTING_VLAN_FLAGS

+
#define NM_SETTING_VLAN_FLAGS                "flags"
+
+

+

+

-

nm_setting_vlan_clear_priorities ()

-
void                nm_setting_vlan_clear_priorities    (NMSettingVlan *setting,
-                                                         NMVlanPriorityMap map);
+

NM_SETTING_VLAN_INGRESS_PRIORITY_MAP

+
#define NM_SETTING_VLAN_INGRESS_PRIORITY_MAP "ingress-priority-map"
+

-Clear all the entires from "ingress_priority_map" or -"egress_priority_map" properties.

-
+ +
+
+

NM_SETTING_VLAN_EGRESS_PRIORITY_MAP

+
#define NM_SETTING_VLAN_EGRESS_PRIORITY_MAP  "egress-priority-map"
+
+

+

+
+
+
+

enum NMVlanPriorityMap

+

A selector for traffic priority maps; these map Linux SKB priorities +to 802.1p priorities used in VLANs.

+
+

Members

+
--+++ - - + + - - + + +

setting :

the NMSettingVlan +

NM_VLAN_INGRESS_MAP

+

map for incoming data

 

map :

the type of priority map

NM_VLAN_EGRESS_MAP

+

map for outgoing data

+
 
+

-

nm_setting_vlan_add_priority_str ()

-
gboolean            nm_setting_vlan_add_priority_str    (NMSettingVlan *setting,
-                                                         NMVlanPriorityMap map,
-                                                         const char *str);
-

-Adds a priority map entry into either the "ingress_priority_map" -or the "egress_priority_map" properties. The priority map maps -the Linux SKB priorities to 802.1p priorities. -

-
+

enum NMVlanFlags

+

NMVlanFlags values control the behavior of the VLAN interface.

+
+

Members

+
--+++ - - + + - - - - - - + + + - - + + +

setting :

the NMSettingVlan +

NM_VLAN_FLAG_REORDER_HEADERS

+

indicates that this interface should reorder + outgoing packet headers to look more like a non-VLAN Ethernet interface

 

map :

the type of priority map

str :

the string which contains a priority map, like "3:7"

NM_VLAN_FLAG_GVRP

+

indicates that this interface should use GVRP to register + itself with it's switch

+
 

Returns :

-TRUE if the entry was successfully added to the list, or it -overwrote the old value, FALSE if error

NM_VLAN_FLAG_LOOSE_BINDING

+

indicates that this interface's operating + state is tied to the underlying network interface but other details + (like routing) are not.

+
 
+

Property Details

-

The "egress-priority-map" property

-
  "egress-priority-map"      GStrv                 : Read / Write
-

-For outgoing packets, a list of mappings from Linux SKB priorities to -802.1p priorities. The mapping is given in the format "from:to" where -both "from" and "to" are unsigned integers, ie "7:3". -

+

The “egress-priority-map” property

+
  “egress-priority-map”      GStrv
+

+

Flags: Read / Write


-

The "flags" property

-
  "flags"                    NMVlanFlags           : Read / Write / Construct
-

-One or more flags which control the behavior and features of the VLAN -interface. Flags include NM_VLAN_FLAG_REORDER_HEADERS (reordering of -output packet headers), NM_VLAN_FLAG_GVRP (use of the GVRP protocol), -and NM_VLAN_FLAG_LOOSE_BINDING (loose binding of the interface to its -master device's operating state). -

+

The “flags” property

+
  “flags”                    NMVlanFlags
+

+

Flags: Read / Write / Construct


-

The "id" property

-
  "id"                       guint                 : Read / Write / Construct
-

-The VLAN identifier that the interface created by this connection should -be assigned. -

+

The “id” property

+
  “id”                       guint
+

+

Flags: Read / Write / Construct

Allowed values: <= 4095

Default value: 0


-

The "ingress-priority-map" property

-
  "ingress-priority-map"     GStrv                 : Read / Write
-

-For incoming packets, a list of mappings from 802.1p priorities to Linux -SKB priorities. The mapping is given in the format "from:to" where both -"from" and "to" are unsigned integers, ie "7:3". -

+

The “ingress-priority-map” property

+
  “ingress-priority-map”     GStrv
+

+

Flags: Read / Write


-

The "parent" property

-
  "parent"                   gchar*                : Read / Write / Construct
-

-If given, specifies the parent interface name or parent connection UUID -from which this VLAN interface should be created. If this property is -not specified, the connection must contain an NMSettingWired setting -with a "mac-address" property. -

+

The “parent” property

+
  “parent”                   gchar *
+

+

Flags: Read / Write / Construct

Default value: NULL

+ Generated by GTK-Doc V1.21 \ No newline at end of file diff --git a/docs/libnm/html/NMSettingVpn.html b/docs/libnm/html/NMSettingVpn.html index a83c0145..a55a552a 100644 --- a/docs/libnm/html/NMSettingVpn.html +++ b/docs/libnm/html/NMSettingVpn.html @@ -2,34 +2,28 @@ -NMSettingVpn +libnm Reference Manual: NMSettingVpn - + - - - - - - - - - - + + + + + + +
@@ -37,646 +31,814 @@

NMSettingVpn

NMSettingVpn — Describes connection properties for Virtual Private Networks

- +
-
-

Synopsis

-
#define             NM_SETTING_VPN_SETTING_NAME
-#define             NM_SETTING_VPN_SERVICE_TYPE
-#define             NM_SETTING_VPN_USER_NAME
-#define             NM_SETTING_VPN_PERSISTENT
-#define             NM_SETTING_VPN_DATA
-#define             NM_SETTING_VPN_SECRETS
-struct              NMSettingVpn;
-                    NMSettingVpnClass;
-void                (*NMVpnIterFunc)                    (const char *key,
-                                                         const char *value,
-                                                         gpointer user_data);
-NMSetting *         nm_setting_vpn_new                  (void);
-const char *        nm_setting_vpn_get_service_type     (NMSettingVpn *setting);
-const char *        nm_setting_vpn_get_user_name        (NMSettingVpn *setting);
-gboolean            nm_setting_vpn_get_persistent       (NMSettingVpn *setting);
-guint32             nm_setting_vpn_get_num_data_items   (NMSettingVpn *setting);
-void                nm_setting_vpn_add_data_item        (NMSettingVpn *setting,
-                                                         const char *key,
-                                                         const char *item);
-const char *        nm_setting_vpn_get_data_item        (NMSettingVpn *setting,
-                                                         const char *key);
-gboolean            nm_setting_vpn_remove_data_item     (NMSettingVpn *setting,
-                                                         const char *key);
-void                nm_setting_vpn_foreach_data_item    (NMSettingVpn *setting,
-                                                         NMVpnIterFunc func,
-                                                         gpointer user_data);
-guint32             nm_setting_vpn_get_num_secrets      (NMSettingVpn *setting);
-void                nm_setting_vpn_add_secret           (NMSettingVpn *setting,
-                                                         const char *key,
-                                                         const char *secret);
-const char *        nm_setting_vpn_get_secret           (NMSettingVpn *setting,
-                                                         const char *key);
-gboolean            nm_setting_vpn_remove_secret        (NMSettingVpn *setting,
-                                                         const char *key);
-void                nm_setting_vpn_foreach_secret       (NMSettingVpn *setting,
-                                                         NMVpnIterFunc func,
-                                                         gpointer user_data);
-
-
-

Object Hierarchy

-
-  GObject
-   +----NMSetting
-         +----NMSettingVpn
-
+

Functions

+
++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+void + +(*NMVpnIterFunc) () +
+NMSetting * + +nm_setting_vpn_new () +
const char * + +nm_setting_vpn_get_service_type () +
const char * + +nm_setting_vpn_get_user_name () +
+gboolean + +nm_setting_vpn_get_persistent () +
+guint32 + +nm_setting_vpn_get_num_data_items () +
+void + +nm_setting_vpn_add_data_item () +
const char * + +nm_setting_vpn_get_data_item () +
+gboolean + +nm_setting_vpn_remove_data_item () +
+void + +nm_setting_vpn_foreach_data_item () +
+guint32 + +nm_setting_vpn_get_num_secrets () +
+void + +nm_setting_vpn_add_secret () +
const char * + +nm_setting_vpn_get_secret () +
+gboolean + +nm_setting_vpn_remove_secret () +
+void + +nm_setting_vpn_foreach_secret () +

Properties

-
-  "data"                     GHashTable*           : Read / Write
-  "persistent"               gboolean              : Read / Write
-  "secrets"                  GHashTable*           : Read / Write
-  "service-type"             gchar*                : Read / Write
-  "user-name"                gchar*                : Read / Write
+
+++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+GHashTable *dataRead / Write
gbooleanpersistentRead / Write
+GHashTable *secretsRead / Write
+gchar *service-typeRead / Write
+gchar *user-nameRead / Write
+
+
+

Types and Values

+
++++ + + + + + + + + + + + + + + + + + + + + + + + + + + +
#defineNM_SETTING_VPN_SETTING_NAME
#defineNM_SETTING_VPN_SERVICE_TYPE
#defineNM_SETTING_VPN_USER_NAME
#defineNM_SETTING_VPN_PERSISTENT
#defineNM_SETTING_VPN_DATA
#defineNM_SETTING_VPN_SECRETS
+
+
+

Object Hierarchy

+
    GObject
+    ╰── NMSetting
+        ╰── NMSettingVpn
 

Description

-

-The NMSettingVpn object is a NMSetting subclass that describes properties +

The NMSettingVpn object is a NMSetting subclass that describes properties necessary for connection to Virtual Private Networks. NetworkManager uses a plugin architecture to allow easier use of new VPN types, and this setting abstracts the configuration for those plugins. Since the configuration options are only known to the VPN plugins themselves, the VPN configuration options are stored as key/value pairs of strings rather than GObject -properties. -

+properties.

-

Details

-
-

NM_SETTING_VPN_SETTING_NAME

-
#define NM_SETTING_VPN_SETTING_NAME "vpn"
-
-

-

-
-
-
-

NM_SETTING_VPN_SERVICE_TYPE

-
#define NM_SETTING_VPN_SERVICE_TYPE "service-type"
-
-

-

-
-
-
-

NM_SETTING_VPN_USER_NAME

-
#define NM_SETTING_VPN_USER_NAME    "user-name"
-
-

-

-
-
-
-

NM_SETTING_VPN_PERSISTENT

-
#define NM_SETTING_VPN_PERSISTENT   "persistent"
-
-

-

-
-
-
-

NM_SETTING_VPN_DATA

-
#define NM_SETTING_VPN_DATA         "data"
-
-

-

-
-
-
-

NM_SETTING_VPN_SECRETS

-
#define NM_SETTING_VPN_SECRETS      "secrets"
-
-

-

-
-
-
-

struct NMSettingVpn

-
struct NMSettingVpn;
-

-

-
-
-
-

NMSettingVpnClass

-
typedef struct {
-	NMSettingClass parent;
-} NMSettingVpnClass;
-
-

-

-
-
+

Functions

-

NMVpnIterFunc ()

-
void                (*NMVpnIterFunc)                    (const char *key,
-                                                         const char *value,
-                                                         gpointer user_data);
-
+

NMVpnIterFunc ()

+
void
+(*NMVpnIterFunc) (const char *key,
+                  const char *value,
+                  gpointer user_data);
+
+

Parameters

+
--+++ - - + + + - - + + + - - + + +

key :

the name of the data or secret item

key

the name of the data or secret item

 

value :

the value of the data or secret item

value

the value of the data or secret item

 

user_data :

User data passed to nm_setting_vpn_foreach_data_item() or -nm_setting_vpn_foreach_secret() -

user_data

User data passed to nm_setting_vpn_foreach_data_item() or +nm_setting_vpn_foreach_secret()

 
+

-

nm_setting_vpn_new ()

-
NMSetting *         nm_setting_vpn_new                  (void);
-

-Creates a new NMSettingVpn object with default values. -

-
---- - - - - -

Returns :

the new empty NMSettingVpn object. [transfer full] -
+

nm_setting_vpn_new ()

+
NMSetting *
+nm_setting_vpn_new (void);
+

Creates a new NMSettingVpn object with default values.

+
+

Returns

+

the new empty NMSettingVpn object.

+

[transfer full]

+

-

nm_setting_vpn_get_service_type ()

-
const char *        nm_setting_vpn_get_service_type     (NMSettingVpn *setting);
-

-Returns the service name of the VPN, which identifies the specific VPN -plugin that should be used to connect to this VPN. -

-
+

nm_setting_vpn_get_service_type ()

+
const char *
+nm_setting_vpn_get_service_type (NMSettingVpn *setting);
+

Returns the service name of the VPN, which identifies the specific VPN +plugin that should be used to connect to this VPN.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSettingVpn -

Returns :

the VPN plugin's service name

setting

the NMSettingVpn

 
+
+

Returns

+

the VPN plugin's service name

+

+
+

-

nm_setting_vpn_get_user_name ()

-
const char *        nm_setting_vpn_get_user_name        (NMSettingVpn *setting);
-
+

nm_setting_vpn_get_user_name ()

+
const char *
+nm_setting_vpn_get_user_name (NMSettingVpn *setting);
+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSettingVpn -

Returns :

the "user-name" property of the setting

setting

the NMSettingVpn

 
+
+

Returns

+

the “user-name” property of the setting

+

+
+
-

nm_setting_vpn_get_persistent ()

-
gboolean            nm_setting_vpn_get_persistent       (NMSettingVpn *setting);
-
+

nm_setting_vpn_get_persistent ()

+
gboolean
+nm_setting_vpn_get_persistent (NMSettingVpn *setting);
+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSettingVpn -

Returns :

the "persistent" property of the setting

setting

the NMSettingVpn

 
+
+

Returns

+

the “persistent” property of the setting

+

+
+
-

nm_setting_vpn_get_num_data_items ()

-
guint32             nm_setting_vpn_get_num_data_items   (NMSettingVpn *setting);
-

-Gets number of key/value pairs of VPN configuration data. -

-
+

nm_setting_vpn_get_num_data_items ()

+
guint32
+nm_setting_vpn_get_num_data_items (NMSettingVpn *setting);
+

Gets number of key/value pairs of VPN configuration data.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSettingVpn -

Returns :

the number of VPN plugin specific configuration data items

setting

the NMSettingVpn

 
+
+

Returns

+

the number of VPN plugin specific configuration data items

+

+
+
-

nm_setting_vpn_add_data_item ()

-
void                nm_setting_vpn_add_data_item        (NMSettingVpn *setting,
-                                                         const char *key,
-                                                         const char *item);
-

-Establishes a relationship between key and item internally in the +

nm_setting_vpn_add_data_item ()

+
void
+nm_setting_vpn_add_data_item (NMSettingVpn *setting,
+                              const char *key,
+                              const char *item);
+

Establishes a relationship between key + and item + internally in the setting which may be retrieved later. Should not be used to store passwords -or other secrets, which is what nm_setting_vpn_add_secret() is for. -

-
+or other secrets, which is what nm_setting_vpn_add_secret() is for.

+
+

Parameters

+
--+++ - - + + + - - + + + - - + + +

setting :

the NMSettingVpn -

setting

the NMSettingVpn

 

key :

a name that uniquely identifies the given value item -

key

a name that uniquely identifies the given value item +

 

item :

the value to be referenced by key -

item

the value to be referenced by key +

 
+
-

nm_setting_vpn_get_data_item ()

-
const char *        nm_setting_vpn_get_data_item        (NMSettingVpn *setting,
-                                                         const char *key);
-

-Retrieves the data item of a key/value relationship previously established -by nm_setting_vpn_add_data_item(). -

-
+

nm_setting_vpn_get_data_item ()

+
const char *
+nm_setting_vpn_get_data_item (NMSettingVpn *setting,
+                              const char *key);
+

Retrieves the data item of a key/value relationship previously established +by nm_setting_vpn_add_data_item().

+
+

Parameters

+
--+++ - - + + + - - - - - - + + +

setting :

the NMSettingVpn -

setting

the NMSettingVpn

 

key :

the name of the data item to retrieve

Returns :

the data item, if any

key

the name of the data item to retrieve

 
+
+

Returns

+

the data item, if any

+

+
+
-

nm_setting_vpn_remove_data_item ()

-
gboolean            nm_setting_vpn_remove_data_item     (NMSettingVpn *setting,
-                                                         const char *key);
-

-Deletes a key/value relationship previously established by -nm_setting_vpn_add_data_item(). -

-
+

nm_setting_vpn_remove_data_item ()

+
gboolean
+nm_setting_vpn_remove_data_item (NMSettingVpn *setting,
+                                 const char *key);
+

Deletes a key/value relationship previously established by +nm_setting_vpn_add_data_item().

+
+

Parameters

+
--+++ - - - - - - + + + - - + + +

setting :

the NMSettingVpn -

key :

the name of the data item to remove

setting

the NMSettingVpn

 

Returns :

-TRUE if the data item was found and removed from the internal list, -FALSE if it was not.

key

the name of the data item to remove

 
+
+

Returns

+

TRUE if the data item was found and removed from the internal list, +FALSE if it was not.

+

+
+
-

nm_setting_vpn_foreach_data_item ()

-
void                nm_setting_vpn_foreach_data_item    (NMSettingVpn *setting,
-                                                         NMVpnIterFunc func,
-                                                         gpointer user_data);
-

-Iterates all data items stored in this setting. It is safe to add, remove, -and modify data items inside func, though any additions or removals made -during iteration will not be part of the iteration. -

-
+

nm_setting_vpn_foreach_data_item ()

+
void
+nm_setting_vpn_foreach_data_item (NMSettingVpn *setting,
+                                  NMVpnIterFunc func,
+                                  gpointer user_data);
+

Iterates all data items stored in this setting. It is safe to add, remove, +and modify data items inside func +, though any additions or removals made +during iteration will not be part of the iteration.

+
+

Parameters

+
--+++ - - + + + - - + + + - - + + +

setting :

a NMSettingVpn -

setting

a NMSettingVpn

 

func :

an user provided function. [scope call] -

func

an user provided function.

[scope call]

user_data :

data to be passed to func -

user_data

data to be passed to func +

 
+
-

nm_setting_vpn_get_num_secrets ()

-
guint32             nm_setting_vpn_get_num_secrets      (NMSettingVpn *setting);
-

-Gets number of VPN plugin specific secrets in the setting. -

-
+

nm_setting_vpn_get_num_secrets ()

+
guint32
+nm_setting_vpn_get_num_secrets (NMSettingVpn *setting);
+

Gets number of VPN plugin specific secrets in the setting.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSettingVpn -

Returns :

the number of VPN plugin specific secrets

setting

the NMSettingVpn

 
+
+

Returns

+

the number of VPN plugin specific secrets

+

+
+
-

nm_setting_vpn_add_secret ()

-
void                nm_setting_vpn_add_secret           (NMSettingVpn *setting,
-                                                         const char *key,
-                                                         const char *secret);
-

-Establishes a relationship between key and secret internally in the -setting which may be retrieved later. -

-
+

nm_setting_vpn_add_secret ()

+
void
+nm_setting_vpn_add_secret (NMSettingVpn *setting,
+                           const char *key,
+                           const char *secret);
+

Establishes a relationship between key + and secret + internally in the +setting which may be retrieved later.

+
+

Parameters

+
--+++ - - + + + - - + + + - - + + +

setting :

the NMSettingVpn -

setting

the NMSettingVpn

 

key :

a name that uniquely identifies the given secret secret -

key

a name that uniquely identifies the given secret secret +

 

secret :

the secret to be referenced by key -

secret

the secret to be referenced by key +

 
+
-

nm_setting_vpn_get_secret ()

-
const char *        nm_setting_vpn_get_secret           (NMSettingVpn *setting,
-                                                         const char *key);
-

-Retrieves the secret of a key/value relationship previously established -by nm_setting_vpn_add_secret(). -

-
+

nm_setting_vpn_get_secret ()

+
const char *
+nm_setting_vpn_get_secret (NMSettingVpn *setting,
+                           const char *key);
+

Retrieves the secret of a key/value relationship previously established +by nm_setting_vpn_add_secret().

+
+

Parameters

+
--+++ - - - - - - + + + - - + + +

setting :

the NMSettingVpn -

key :

the name of the secret to retrieve

setting

the NMSettingVpn

 

Returns :

the secret, if any

key

the name of the secret to retrieve

 
+
+

Returns

+

the secret, if any

+

+
+
-

nm_setting_vpn_remove_secret ()

-
gboolean            nm_setting_vpn_remove_secret        (NMSettingVpn *setting,
-                                                         const char *key);
-

-Deletes a key/value relationship previously established by -nm_setting_vpn_add_secret(). -

-
+

nm_setting_vpn_remove_secret ()

+
gboolean
+nm_setting_vpn_remove_secret (NMSettingVpn *setting,
+                              const char *key);
+

Deletes a key/value relationship previously established by +nm_setting_vpn_add_secret().

+
+

Parameters

+
--+++ - - - - - - + + + - - + + +

setting :

the NMSettingVpn -

key :

the name of the secret to remove

setting

the NMSettingVpn

 

Returns :

-TRUE if the secret was found and removed from the internal list, -FALSE if it was not.

key

the name of the secret to remove

 
+
+

Returns

+

TRUE if the secret was found and removed from the internal list, +FALSE if it was not.

+

+
+
-

nm_setting_vpn_foreach_secret ()

-
void                nm_setting_vpn_foreach_secret       (NMSettingVpn *setting,
-                                                         NMVpnIterFunc func,
-                                                         gpointer user_data);
-

-Iterates all secrets stored in this setting. It is safe to add, remove, -and modify secrets inside func, though any additions or removals made during -iteration will not be part of the iteration. -

-
+

nm_setting_vpn_foreach_secret ()

+
void
+nm_setting_vpn_foreach_secret (NMSettingVpn *setting,
+                               NMVpnIterFunc func,
+                               gpointer user_data);
+

Iterates all secrets stored in this setting. It is safe to add, remove, +and modify secrets inside func +, though any additions or removals made during +iteration will not be part of the iteration.

+
+

Parameters

+
--+++ - - + + + - - + + + - - + + +

setting :

a NMSettingVpn -

setting

a NMSettingVpn

 

func :

an user provided function. [scope call] -

func

an user provided function.

[scope call]

user_data :

data to be passed to func -

user_data

data to be passed to func +

 
+
-

Property Details

+

Types and Values

-

The "data" property

-
  "data"                     GHashTable*           : Read / Write
+

NM_SETTING_VPN_SETTING_NAME

+
#define NM_SETTING_VPN_SETTING_NAME "vpn"
+

-Dictionary of key/value pairs of VPN plugin specific data. Both keys and -values must be strings.

+
+
+
+

NM_SETTING_VPN_SERVICE_TYPE

+
#define NM_SETTING_VPN_SERVICE_TYPE "service-type"
+

-Type: GHashTable(utf8,utf8)


-

The "persistent" property

-
  "persistent"               gboolean              : Read / Write
+

NM_SETTING_VPN_USER_NAME

+
#define NM_SETTING_VPN_USER_NAME    "user-name"
+

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

-

Default value: FALSE


-

The "secrets" property

-
  "secrets"                  GHashTable*           : Read / Write
+

NM_SETTING_VPN_PERSISTENT

+
#define NM_SETTING_VPN_PERSISTENT   "persistent"
+

-Dictionary of key/value pairs of VPN plugin specific secrets like -passwords or private keys. Both keys and values must be strings.

+
+
+
+

NM_SETTING_VPN_DATA

+
#define NM_SETTING_VPN_DATA         "data"
+

-Type: GHashTable(utf8,utf8)


-

The "service-type" property

-
  "service-type"             gchar*                : Read / Write
+

NM_SETTING_VPN_SECRETS

+
#define NM_SETTING_VPN_SECRETS      "secrets"
+

-D-Bus service name of the VPN plugin that this setting uses to connect to -its network. i.e. org.freedesktop.NetworkManager.vpnc for the vpnc -plugin.

+
+
+
+

Property Details

+
+

The “data” property

+
  “data”                     GHashTable *
+

+

Flags: Read / Write

+
+
+
+

The “persistent” property

+
  “persistent”               gboolean
+

+

Flags: Read / Write

+

Default value: FALSE

+
+
+
+

The “secrets” property

+
  “secrets”                  GHashTable *
+

+

Flags: Read / Write

+
+
+
+

The “service-type” property

+
  “service-type”             gchar *
+

+

Flags: Read / Write

Default value: NULL


-

The "user-name" property

-
  "user-name"                gchar*                : Read / Write
-

-If the VPN connection requires a user name for authentication, that name -should be provided here. If the connection is available to more than one -user, and the VPN requires each user to supply a different name, then -leave this property empty. If this property is empty, NetworkManager -will automatically supply the username of the user which requested the -VPN connection. -

+

The “user-name” property

+
  “user-name”                gchar *
+

+

Flags: Read / Write

Default value: NULL

+ Generated by GTK-Doc V1.21 \ No newline at end of file diff --git a/docs/libnm/html/NMSettingWimax.html b/docs/libnm/html/NMSettingWimax.html index 7b2f64f9..99666051 100644 --- a/docs/libnm/html/NMSettingWimax.html +++ b/docs/libnm/html/NMSettingWimax.html @@ -2,34 +2,28 @@ -NMSettingWimax +libnm Reference Manual: NMSettingWimax - + - - - - - - - - - - + + + + + + +
@@ -37,181 +31,217 @@

NMSettingWimax

NMSettingWimax — Describes 802.16e Mobile WiMAX connection properties

- +
-
-

Object Hierarchy

-
-  GObject
-   +----NMSetting
-         +----NMSettingWimax
-
+

Functions

+
++++ + + + + + + + + + + + + + + +
+NMSetting * + +nm_setting_wimax_new () +
const char * + +nm_setting_wimax_get_network_name () +
const char * + +nm_setting_wimax_get_mac_address () +

Properties

-
-  "mac-address"              gchar*                : Read / Write
-  "network-name"             gchar*                : Read / Write
+
+++++ + + + + + + + + + + + + +
+gchar *mac-addressRead / Write
+gchar *network-nameRead / Write
+
+
+

Types and Values

+ +
+
+

Object Hierarchy

+
    GObject
+    ╰── NMSetting
+        ╰── NMSettingWimax
 

Description

-

-The NMSettingWimax object is a NMSetting subclass that describes properties -necessary for connection to 802.16e Mobile WiMAX networks. -

+

The NMSettingWimax object is a NMSetting subclass that describes properties +necessary for connection to 802.16e Mobile WiMAX networks.

-

Details

+

Functions

-

NM_SETTING_WIMAX_SETTING_NAME

-
#define NM_SETTING_WIMAX_SETTING_NAME "wimax"
-
-

-

+

nm_setting_wimax_new ()

+
NMSetting *
+nm_setting_wimax_new (void);
+

Creates a new NMSettingWimax object with default values.

+
+

Returns

+

the new empty NMSettingWimax object

+

-
-
-

NM_SETTING_WIMAX_NETWORK_NAME

-
#define NM_SETTING_WIMAX_NETWORK_NAME "network-name"
-
-

-


-

NM_SETTING_WIMAX_MAC_ADDRESS

-
#define NM_SETTING_WIMAX_MAC_ADDRESS  "mac-address"
-
-

-

+

nm_setting_wimax_get_network_name ()

+
const char *
+nm_setting_wimax_get_network_name (NMSettingWimax *setting);
+

Returns the WiMAX NSP name (ex "Sprint" or "CLEAR") which identifies the +specific WiMAX network this setting describes a connection to.

+
+

Parameters

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

setting

the NMSettingWimax

 
-
-
-

struct NMSettingWimax

-
struct NMSettingWimax;
-

-

+
+

Returns

+

the WiMAX NSP name

+

-
-
-

NMSettingWimaxClass

-
typedef struct {
-	NMSettingClass parent;
-} NMSettingWimaxClass;
-
-

-


-

nm_setting_wimax_new ()

-
NMSetting *         nm_setting_wimax_new                (void);
-

-Creates a new NMSettingWimax object with default values. -

-
+

nm_setting_wimax_get_mac_address ()

+
const char *
+nm_setting_wimax_get_mac_address (NMSettingWimax *setting);
+

Returns the MAC address of a WiMAX device which this connection is locked +to.

+
+

Parameters

+
--+++ - - + + +

Returns :

the new empty NMSettingWimax object

setting

the NMSettingWimax

 
+
+

Returns

+

the MAC address

+

+
+
+
+
+

Types and Values

+
+

NM_SETTING_WIMAX_SETTING_NAME

+
#define NM_SETTING_WIMAX_SETTING_NAME "wimax"
+
+

+

+

-

nm_setting_wimax_get_network_name ()

-
const char *        nm_setting_wimax_get_network_name   (NMSettingWimax *setting);
+

NM_SETTING_WIMAX_NETWORK_NAME

+
#define NM_SETTING_WIMAX_NETWORK_NAME "network-name"
+

-Returns the WiMAX NSP name (ex "Sprint" or "CLEAR") which identifies the -specific WiMAX network this setting describes a connection to.

-
---- - - - - - - - - - - -

setting :

the NMSettingWimax -

Returns :

the WiMAX NSP name

-

nm_setting_wimax_get_mac_address ()

-
const char *        nm_setting_wimax_get_mac_address    (NMSettingWimax *setting);
+

NM_SETTING_WIMAX_MAC_ADDRESS

+
#define NM_SETTING_WIMAX_MAC_ADDRESS  "mac-address"
+

-Returns the MAC address of a WiMAX device which this connection is locked -to.

-
---- - - - - - - - - - - -

setting :

the NMSettingWimax -

Returns :

the MAC address

Property Details

-

The "mac-address" property

-
  "mac-address"              gchar*                : Read / Write
-

-If specified, this connection will only apply to the WiMAX device whose -MAC address matches. This property does not change the MAC address of the -device (known as MAC spoofing). -

+

The “mac-address” property

+
  “mac-address”              gchar *
+

+

Flags: Read / Write

Default value: NULL


-

The "network-name" property

-
  "network-name"             gchar*                : Read / Write
-

-Network Service Provider (NSP) name of the WiMAX network this connection -should use. -

+

The “network-name” property

+
  “network-name”             gchar *
+

+

Flags: Read / Write

Default value: NULL

+ Generated by GTK-Doc V1.21
\ No newline at end of file diff --git a/docs/libnm/html/NMSettingWired.html b/docs/libnm/html/NMSettingWired.html index b9f0ad4b..a65d2e22 100644 --- a/docs/libnm/html/NMSettingWired.html +++ b/docs/libnm/html/NMSettingWired.html @@ -2,34 +2,28 @@ -NMSettingWired +libnm Reference Manual: NMSettingWired - + - - - - - - - - - - + + + + + + +
@@ -37,979 +31,1237 @@

NMSettingWired

NMSettingWired — Describes connection properties for Ethernet-based networks

- +
-
-

Synopsis

-
#define             NM_SETTING_WIRED_SETTING_NAME
-#define             NM_SETTING_WIRED_PORT
-#define             NM_SETTING_WIRED_SPEED
-#define             NM_SETTING_WIRED_DUPLEX
-#define             NM_SETTING_WIRED_AUTO_NEGOTIATE
-#define             NM_SETTING_WIRED_MAC_ADDRESS
-#define             NM_SETTING_WIRED_CLONED_MAC_ADDRESS
-#define             NM_SETTING_WIRED_MAC_ADDRESS_BLACKLIST
-#define             NM_SETTING_WIRED_MTU
-#define             NM_SETTING_WIRED_S390_SUBCHANNELS
-#define             NM_SETTING_WIRED_S390_NETTYPE
-#define             NM_SETTING_WIRED_S390_OPTIONS
-struct              NMSettingWired;
-                    NMSettingWiredClass;
-NMSetting *         nm_setting_wired_new                (void);
-const char *        nm_setting_wired_get_port           (NMSettingWired *setting);
-guint32             nm_setting_wired_get_speed          (NMSettingWired *setting);
-const char *        nm_setting_wired_get_duplex         (NMSettingWired *setting);
-gboolean            nm_setting_wired_get_auto_negotiate (NMSettingWired *setting);
-const char *        nm_setting_wired_get_mac_address    (NMSettingWired *setting);
-const char *        nm_setting_wired_get_cloned_mac_address
-                                                        (NMSettingWired *setting);
-const char * const * nm_setting_wired_get_mac_address_blacklist
-                                                        (NMSettingWired *setting);
-guint32             nm_setting_wired_get_num_mac_blacklist_items
-                                                        (NMSettingWired *setting);
-const char *        nm_setting_wired_get_mac_blacklist_item
-                                                        (NMSettingWired *setting,
-                                                         guint32 idx);
-gboolean            nm_setting_wired_add_mac_blacklist_item
-                                                        (NMSettingWired *setting,
-                                                         const char *mac);
-void                nm_setting_wired_remove_mac_blacklist_item
-                                                        (NMSettingWired *setting,
-                                                         guint32 idx);
-gboolean            nm_setting_wired_remove_mac_blacklist_item_by_value
-                                                        (NMSettingWired *setting,
-                                                         const char *mac);
-void                nm_setting_wired_clear_mac_blacklist_items
-                                                        (NMSettingWired *setting);
-guint32             nm_setting_wired_get_mtu            (NMSettingWired *setting);
-const char * const * nm_setting_wired_get_s390_subchannels
-                                                        (NMSettingWired *setting);
-const char *        nm_setting_wired_get_s390_nettype   (NMSettingWired *setting);
-guint32             nm_setting_wired_get_num_s390_options
-                                                        (NMSettingWired *setting);
-gboolean            nm_setting_wired_get_s390_option    (NMSettingWired *setting,
-                                                         guint32 idx,
-                                                         const char **out_key,
-                                                         const char **out_value);
-const char *        nm_setting_wired_get_s390_option_by_key
-                                                        (NMSettingWired *setting,
-                                                         const char *key);
-gboolean            nm_setting_wired_add_s390_option    (NMSettingWired *setting,
-                                                         const char *key,
-                                                         const char *value);
-gboolean            nm_setting_wired_remove_s390_option (NMSettingWired *setting,
-                                                         const char *key);
-const char **       nm_setting_wired_get_valid_s390_options
-                                                        (NMSettingWired *setting);
-
-
-
-

Object Hierarchy

-
-  GObject
-   +----NMSetting
-         +----NMSettingWired
-
-
-
-

Properties

-
-  "auto-negotiate"           gboolean              : Read / Write / Construct
-  "cloned-mac-address"       gchar*                : Read / Write
-  "duplex"                   gchar*                : Read / Write
-  "mac-address"              gchar*                : Read / Write
-  "mac-address-blacklist"    GStrv                 : Read / Write
-  "mtu"                      guint                 : Read / Write / Construct
-  "port"                     gchar*                : Read / Write
-  "s390-nettype"             gchar*                : Read / Write
-  "s390-options"             GHashTable*           : Read / Write
-  "s390-subchannels"         GStrv                 : Read / Write
-  "speed"                    guint                 : Read / Write / Construct
-
-
-

Description

-

-The NMSettingWired object is a NMSetting subclass that describes properties -necessary for connection to Ethernet networks. -

-
-
-

Details

-
-

NM_SETTING_WIRED_SETTING_NAME

-
#define NM_SETTING_WIRED_SETTING_NAME "802-3-ethernet"
-
-

-

-
-
-
-

NM_SETTING_WIRED_PORT

-
#define NM_SETTING_WIRED_PORT "port"
-
-

-

-
-
-
-

NM_SETTING_WIRED_SPEED

-
#define NM_SETTING_WIRED_SPEED "speed"
-
-

-

-
-
-
-

NM_SETTING_WIRED_DUPLEX

-
#define NM_SETTING_WIRED_DUPLEX "duplex"
-
-

-

-
-
-
-

NM_SETTING_WIRED_AUTO_NEGOTIATE

-
#define NM_SETTING_WIRED_AUTO_NEGOTIATE "auto-negotiate"
-
-

-

-
-
-
-

NM_SETTING_WIRED_MAC_ADDRESS

-
#define NM_SETTING_WIRED_MAC_ADDRESS "mac-address"
-
-

-

-
-
-
-

NM_SETTING_WIRED_CLONED_MAC_ADDRESS

-
#define NM_SETTING_WIRED_CLONED_MAC_ADDRESS "cloned-mac-address"
-
-

-

-
-
-
-

NM_SETTING_WIRED_MAC_ADDRESS_BLACKLIST

-
#define NM_SETTING_WIRED_MAC_ADDRESS_BLACKLIST "mac-address-blacklist"
-
-

-

-
-
-
-

NM_SETTING_WIRED_MTU

-
#define NM_SETTING_WIRED_MTU "mtu"
-
-

-

-
-
-
-

NM_SETTING_WIRED_S390_SUBCHANNELS

-
#define NM_SETTING_WIRED_S390_SUBCHANNELS "s390-subchannels"
-
-

-

-
-
-
-

NM_SETTING_WIRED_S390_NETTYPE

-
#define NM_SETTING_WIRED_S390_NETTYPE "s390-nettype"
-
-

-

-
-
-
-

NM_SETTING_WIRED_S390_OPTIONS

-
#define NM_SETTING_WIRED_S390_OPTIONS "s390-options"
-
-

-

-
-
-
-

struct NMSettingWired

-
struct NMSettingWired;
-

-

-
-
-
-

NMSettingWiredClass

-
typedef struct {
-	NMSettingClass parent;
-} NMSettingWiredClass;
-
-

-

-
-
-
-

nm_setting_wired_new ()

-
NMSetting *         nm_setting_wired_new                (void);
-

-Creates a new NMSettingWired object with default values. -

-
---- - - - - -

Returns :

the new empty NMSettingWired object. [transfer full] -
-
-
-
-

nm_setting_wired_get_port ()

-
const char *        nm_setting_wired_get_port           (NMSettingWired *setting);
-
+

Functions

+
--++ - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

setting :

the NMSettingWired + +NMSetting * + +nm_setting_wired_new () +
const char * + +nm_setting_wired_get_port () +
+guint32 + +nm_setting_wired_get_speed () +
const char * + +nm_setting_wired_get_duplex () +
+gboolean + +nm_setting_wired_get_auto_negotiate () +
const char * + +nm_setting_wired_get_mac_address () +
const char * + +nm_setting_wired_get_cloned_mac_address () +
const char * const * + +nm_setting_wired_get_mac_address_blacklist ()

Returns :

the "port" property of the setting +guint32 + +nm_setting_wired_get_num_mac_blacklist_items () +
const char * + +nm_setting_wired_get_mac_blacklist_item () +
+gboolean + +nm_setting_wired_add_mac_blacklist_item () +
+void + +nm_setting_wired_remove_mac_blacklist_item () +
+gboolean + +nm_setting_wired_remove_mac_blacklist_item_by_value () +
+void + +nm_setting_wired_clear_mac_blacklist_items () +
+guint32 + +nm_setting_wired_get_mtu () +
const char * const * + +nm_setting_wired_get_s390_subchannels () +
const char * + +nm_setting_wired_get_s390_nettype () +
+guint32 + +nm_setting_wired_get_num_s390_options () +
+gboolean + +nm_setting_wired_get_s390_option () +
const char * + +nm_setting_wired_get_s390_option_by_key () +
+gboolean + +nm_setting_wired_add_s390_option () +
+gboolean + +nm_setting_wired_remove_s390_option () +
const char ** + +nm_setting_wired_get_valid_s390_options () +
-
-
-

nm_setting_wired_get_speed ()

-
guint32             nm_setting_wired_get_speed          (NMSettingWired *setting);
-
+
+

Properties

+
--+++ - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - - + + + + + + + +

setting :

the NMSettingWired -gbooleanauto-negotiateRead / Write / Construct
+gchar *cloned-mac-addressRead / Write
+gchar *duplexRead / Write
+gchar *mac-addressRead / Write
GStrvmac-address-blacklistRead / Write
guintmtuRead / Write / Construct
+gchar *portRead / Write
+gchar *s390-nettypeRead / Write
+GHashTable *s390-optionsRead / Write

Returns :

the "speed" property of the settingGStrvs390-subchannelsRead / Write
guintspeedRead / Write / Construct
-
-
-

nm_setting_wired_get_duplex ()

-
const char *        nm_setting_wired_get_duplex         (NMSettingWired *setting);
-
+
+

Types and Values

+
--++ - - + + - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

setting :

the NMSettingWired -#defineNM_SETTING_WIRED_SETTING_NAME

Returns :

the "duplex" property of the setting#defineNM_SETTING_WIRED_PORT
#defineNM_SETTING_WIRED_SPEED
#defineNM_SETTING_WIRED_DUPLEX
#defineNM_SETTING_WIRED_AUTO_NEGOTIATE
#defineNM_SETTING_WIRED_MAC_ADDRESS
#defineNM_SETTING_WIRED_CLONED_MAC_ADDRESS
#defineNM_SETTING_WIRED_MAC_ADDRESS_BLACKLIST
#defineNM_SETTING_WIRED_MTU
#defineNM_SETTING_WIRED_S390_SUBCHANNELS
#defineNM_SETTING_WIRED_S390_NETTYPE
#defineNM_SETTING_WIRED_S390_OPTIONS
+
+

Object Hierarchy

+
    GObject
+    ╰── NMSetting
+        ╰── NMSettingWired
+
+
+
+

Description

+

The NMSettingWired object is a NMSetting subclass that describes properties +necessary for connection to Ethernet networks.

+
+
+

Functions

+
+

nm_setting_wired_new ()

+
NMSetting *
+nm_setting_wired_new (void);
+

Creates a new NMSettingWired object with default values.

+
+

Returns

+

the new empty NMSettingWired object.

+

[transfer full]

+
+

-

nm_setting_wired_get_auto_negotiate ()

-
gboolean            nm_setting_wired_get_auto_negotiate (NMSettingWired *setting);
-
+

nm_setting_wired_get_port ()

+
const char *
+nm_setting_wired_get_port (NMSettingWired *setting);
+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSettingWired -

Returns :

the "auto-negotiate" property of the setting

setting

the NMSettingWired

 
+
+

Returns

+

the “port” property of the setting

+

+
+

-

nm_setting_wired_get_mac_address ()

-
const char *        nm_setting_wired_get_mac_address    (NMSettingWired *setting);
-
+

nm_setting_wired_get_speed ()

+
guint32
+nm_setting_wired_get_speed (NMSettingWired *setting);
+
+

Parameters

+
--+++ - - - - - - - - - - + + + + + +

setting :

the NMSettingWired -

Returns :

the "mac-address" property of the setting

setting

the NMSettingWired

 
+
+
+

Returns

+

the “speed” property of the setting

+

+
+
+
+
+

nm_setting_wired_get_duplex ()

+
const char *
+nm_setting_wired_get_duplex (NMSettingWired *setting);
+
+

Parameters

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

setting

the NMSettingWired

 
+
+
+

Returns

+

the “duplex” property of the setting

+

+
+
+
+
+

nm_setting_wired_get_auto_negotiate ()

+
gboolean
+nm_setting_wired_get_auto_negotiate (NMSettingWired *setting);
+
+

Parameters

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

setting

the NMSettingWired

 
+
+
+

Returns

+

the “auto-negotiate” property of the setting

+

+
+
+
+
+

nm_setting_wired_get_mac_address ()

+
const char *
+nm_setting_wired_get_mac_address (NMSettingWired *setting);
+
+

Parameters

+
+++++ + + + + +

setting

the NMSettingWired

 
+
+

Returns

+

the “mac-address” property of the setting

+

+
+

-

nm_setting_wired_get_cloned_mac_address ()

-
const char *        nm_setting_wired_get_cloned_mac_address
-                                                        (NMSettingWired *setting);
-
+

nm_setting_wired_get_cloned_mac_address ()

+
const char *
+nm_setting_wired_get_cloned_mac_address
+                               (NMSettingWired *setting);
+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSettingWired -

Returns :

the "cloned-mac-address" property of the setting

setting

the NMSettingWired

 
+
+

Returns

+

the “cloned-mac-address” property of the setting

+

+
+

-

nm_setting_wired_get_mac_address_blacklist ()

-
const char * const * nm_setting_wired_get_mac_address_blacklist
-                                                        (NMSettingWired *setting);
-
+

nm_setting_wired_get_mac_address_blacklist ()

+
const char * const *
+nm_setting_wired_get_mac_address_blacklist
+                               (NMSettingWired *setting);
+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSettingWired -

Returns :

the "mac-address-blacklist" property of the setting

setting

the NMSettingWired

 
+
+

Returns

+

the “mac-address-blacklist” property of the setting

+

+
+

-

nm_setting_wired_get_num_mac_blacklist_items ()

-
guint32             nm_setting_wired_get_num_mac_blacklist_items
-                                                        (NMSettingWired *setting);
-
+

nm_setting_wired_get_num_mac_blacklist_items ()

+
guint32
+nm_setting_wired_get_num_mac_blacklist_items
+                               (NMSettingWired *setting);
+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSettingWired -

Returns :

the number of blacklisted MAC addresses

setting

the NMSettingWired

 
+
+

Returns

+

the number of blacklisted MAC addresses

+

+
+
-

nm_setting_wired_get_mac_blacklist_item ()

-
const char *        nm_setting_wired_get_mac_blacklist_item
-                                                        (NMSettingWired *setting,
-                                                         guint32 idx);
-
+

nm_setting_wired_get_mac_blacklist_item ()

+
const char *
+nm_setting_wired_get_mac_blacklist_item
+                               (NMSettingWired *setting,
+                                guint32 idx);
+
+

Parameters

+
--+++ - - - - - - + + + - - + + +

setting :

the NMSettingWired -

idx :

the zero-based index of the MAC address entry

setting

the NMSettingWired

 

Returns :

the blacklisted MAC address string (hex-digits-and-colons notation) -at index idx -

idx

the zero-based index of the MAC address entry

 
+
+

Returns

+

the blacklisted MAC address string (hex-digits-and-colons notation) +at index idx +

+

+
+
-

nm_setting_wired_add_mac_blacklist_item ()

-
gboolean            nm_setting_wired_add_mac_blacklist_item
-                                                        (NMSettingWired *setting,
-                                                         const char *mac);
-

-Adds a new MAC address to the "mac-address-blacklist" property. -

-
+

nm_setting_wired_add_mac_blacklist_item ()

+
gboolean
+nm_setting_wired_add_mac_blacklist_item
+                               (NMSettingWired *setting,
+                                const char *mac);
+

Adds a new MAC address to the “mac-address-blacklist” property.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + +

setting :

the NMSettingWired -

mac :

the MAC address string (hex-digits-and-colons notation) to blacklist

setting

the NMSettingWired

 

Returns :

-TRUE if the MAC address was added; FALSE if the MAC address -is invalid or was already present

mac

the MAC address string (hex-digits-and-colons notation) to blacklist

 
+
+

Returns

+

TRUE if the MAC address was added; FALSE if the MAC address +is invalid or was already present

+

+
+
-

nm_setting_wired_remove_mac_blacklist_item ()

-
void                nm_setting_wired_remove_mac_blacklist_item
-                                                        (NMSettingWired *setting,
-                                                         guint32 idx);
-

-Removes the MAC address at index idx from the blacklist. -

-
+

nm_setting_wired_remove_mac_blacklist_item ()

+
void
+nm_setting_wired_remove_mac_blacklist_item
+                               (NMSettingWired *setting,
+                                guint32 idx);
+

Removes the MAC address at index idx + from the blacklist.

+
+

Parameters

+
--+++ - - + + + - - + + +

setting :

the NMSettingWired -

setting

the NMSettingWired

 

idx :

index number of the MAC address

idx

index number of the MAC address

 
+
-

nm_setting_wired_remove_mac_blacklist_item_by_value ()

-
gboolean            nm_setting_wired_remove_mac_blacklist_item_by_value
-                                                        (NMSettingWired *setting,
-                                                         const char *mac);
-

-Removes the MAC address mac from the blacklist. -

-
+

nm_setting_wired_remove_mac_blacklist_item_by_value ()

+
gboolean
+nm_setting_wired_remove_mac_blacklist_item_by_value
+                               (NMSettingWired *setting,
+                                const char *mac);
+

Removes the MAC address mac + from the blacklist.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + +

setting :

the NMSettingWired -

mac :

the MAC address string (hex-digits-and-colons notation) to remove from -the blacklist

setting

the NMSettingWired

 

Returns :

-TRUE if the MAC address was found and removed; FALSE if it was not.

mac

the MAC address string (hex-digits-and-colons notation) to remove from +the blacklist

 
+
+

Returns

+

TRUE if the MAC address was found and removed; FALSE if it was not.

+

+
+
-

nm_setting_wired_clear_mac_blacklist_items ()

-
void                nm_setting_wired_clear_mac_blacklist_items
-                                                        (NMSettingWired *setting);
-

-Removes all blacklisted MAC addresses. -

-
+

nm_setting_wired_clear_mac_blacklist_items ()

+
void
+nm_setting_wired_clear_mac_blacklist_items
+                               (NMSettingWired *setting);
+

Removes all blacklisted MAC addresses.

+
+

Parameters

+
--+++ - - + + +

setting :

the NMSettingWired -

setting

the NMSettingWired

 
+
-

nm_setting_wired_get_mtu ()

-
guint32             nm_setting_wired_get_mtu            (NMSettingWired *setting);
-
+

nm_setting_wired_get_mtu ()

+
guint32
+nm_setting_wired_get_mtu (NMSettingWired *setting);
+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSettingWired -

Returns :

the "mtu" property of the setting

setting

the NMSettingWired

 
+
+

Returns

+

the “mtu” property of the setting

+

+
+
-

nm_setting_wired_get_s390_subchannels ()

-
const char * const * nm_setting_wired_get_s390_subchannels
-                                                        (NMSettingWired *setting);
-

-Return the list of s390 subchannels that identify the device that this +

nm_setting_wired_get_s390_subchannels ()

+
const char * const *
+nm_setting_wired_get_s390_subchannels (NMSettingWired *setting);
+

Return the list of s390 subchannels that identify the device that this connection is applicable to. The connection should only be used in -conjunction with that device. -

-
+conjunction with that device.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSettingWired -

Returns :

array of strings, each specifying -one subchannel the s390 device uses to communicate to the host. [transfer none][element-type utf8] -

setting

the NMSettingWired

 
+
+

Returns

+

array of strings, each specifying +one subchannel the s390 device uses to communicate to the host.

+

[transfer none][element-type utf8]

+
+
-

nm_setting_wired_get_s390_nettype ()

-
const char *        nm_setting_wired_get_s390_nettype   (NMSettingWired *setting);
-

-Returns the s390 device type this connection should apply to. Will be one -of 'qeth', 'lcs', or 'ctc'. -

-
+

nm_setting_wired_get_s390_nettype ()

+
const char *
+nm_setting_wired_get_s390_nettype (NMSettingWired *setting);
+

Returns the s390 device type this connection should apply to. Will be one +of 'qeth', 'lcs', or 'ctc'.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSettingWired -

Returns :

the s390 device type

setting

the NMSettingWired

 
+
+

Returns

+

the s390 device type

+

+
+
-

nm_setting_wired_get_num_s390_options ()

-
guint32             nm_setting_wired_get_num_s390_options
-                                                        (NMSettingWired *setting);
-

-Returns the number of s390-specific options that should be set for this +

nm_setting_wired_get_num_s390_options ()

+
guint32
+nm_setting_wired_get_num_s390_options (NMSettingWired *setting);
+

Returns the number of s390-specific options that should be set for this device when it is activated. This can be used to retrieve each s390 -option individually using nm_setting_wired_get_s390_option(). -

-
+option individually using nm_setting_wired_get_s390_option().

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSettingWired -

Returns :

the number of s390-specific device options

setting

the NMSettingWired

 
+
+

Returns

+

the number of s390-specific device options

+

+
+
-

nm_setting_wired_get_s390_option ()

-
gboolean            nm_setting_wired_get_s390_option    (NMSettingWired *setting,
-                                                         guint32 idx,
-                                                         const char **out_key,
-                                                         const char **out_value);
-

-Given an index, return the value of the s390 option at that index. indexes +

nm_setting_wired_get_s390_option ()

+
gboolean
+nm_setting_wired_get_s390_option (NMSettingWired *setting,
+                                  guint32 idx,
+                                  const char **out_key,
+                                  const char **out_value);
+

Given an index, return the value of the s390 option at that index. indexes are *not* guaranteed to be static across modifications to options done by -nm_setting_wired_add_s390_option() and nm_setting_wired_remove_s390_option(), +nm_setting_wired_add_s390_option() and nm_setting_wired_remove_s390_option(), and should not be used to refer to options except for short periods of time -such as during option iteration. -

-
+such as during option iteration.

+
+

Parameters

+
--+++ - - + + + - - + + + - - + + + - - + - - - - +modified.

+

setting :

the NMSettingWired -

setting

the NMSettingWired

 

idx :

index of the desired option, from 0 to -nm_setting_wired_get_num_s390_options() - 1

idx

index of the desired option, from 0 to +nm_setting_wired_get_num_s390_options() - 1

 

out_key :

on return, the key name of the s390 specific -option; this value is owned by the setting and should not be modified. [out][transfer none] -

out_key

on return, the key name of the s390 specific +option; this value is owned by the setting and should not be modified.

[out][transfer none]

out_value :

on return, the value of the key of the +

out_value

on return, the value of the key of the s390 specific option; this value is owned by the setting and should not be -modified. [out][transfer none] -

Returns :

-TRUE on success if the index was valid and an option was found, -FALSE if the index was invalid (ie, greater than the number of options -currently held by the setting)[out][transfer none]
+
+

Returns

+

TRUE on success if the index was valid and an option was found, +FALSE if the index was invalid (ie, greater than the number of options +currently held by the setting)

+

+
+
-

nm_setting_wired_get_s390_option_by_key ()

-
const char *        nm_setting_wired_get_s390_option_by_key
-                                                        (NMSettingWired *setting,
-                                                         const char *key);
-

-Returns the value associated with the s390-specific option specified by -key, if it exists. -

-
+

nm_setting_wired_get_s390_option_by_key ()

+
const char *
+nm_setting_wired_get_s390_option_by_key
+                               (NMSettingWired *setting,
+                                const char *key);
+

Returns the value associated with the s390-specific option specified by +key +, if it exists.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + +

setting :

the NMSettingWired -

key :

the key for which to retrieve the value

setting

the NMSettingWired

 

Returns :

the value, or NULL if the key/value pair was never added to the -setting; the value is owned by the setting and must not be modified

key

the key for which to retrieve the value

 
+
+

Returns

+

the value, or NULL if the key/value pair was never added to the +setting; the value is owned by the setting and must not be modified

+

+
+
-

nm_setting_wired_add_s390_option ()

-
gboolean            nm_setting_wired_add_s390_option    (NMSettingWired *setting,
-                                                         const char *key,
-                                                         const char *value);
-

-Add an option to the table. The option is compared to an internal list +

nm_setting_wired_add_s390_option ()

+
gboolean
+nm_setting_wired_add_s390_option (NMSettingWired *setting,
+                                  const char *key,
+                                  const char *value);
+

Add an option to the table. The option is compared to an internal list of allowed options. Key names may contain only alphanumeric characters (ie [a-zA-Z0-9]). Adding a new key replaces any existing key/value pair that -may already exist. -

-
+may already exist.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + + - - + + +

setting :

the NMSettingWired -

key :

key name for the option

setting

the NMSettingWired

 

value :

value for the option

key

key name for the option

 

Returns :

-TRUE if the option was valid and was added to the internal option -list, FALSE if it was not.

value

value for the option

 
+
+

Returns

+

TRUE if the option was valid and was added to the internal option +list, FALSE if it was not.

+

+
+
-

nm_setting_wired_remove_s390_option ()

-
gboolean            nm_setting_wired_remove_s390_option (NMSettingWired *setting,
-                                                         const char *key);
-

-Remove the s390-specific option referenced by key from the internal option -list. -

-
+

nm_setting_wired_remove_s390_option ()

+
gboolean
+nm_setting_wired_remove_s390_option (NMSettingWired *setting,
+                                     const char *key);
+

Remove the s390-specific option referenced by key + from the internal option +list.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + +

setting :

the NMSettingWired -

key :

key name for the option to remove

setting

the NMSettingWired

 

Returns :

-TRUE if the option was found and removed from the internal option -list, FALSE if it was not.

key

key name for the option to remove

 
+
+

Returns

+

TRUE if the option was found and removed from the internal option +list, FALSE if it was not.

+

+
+
-

nm_setting_wired_get_valid_s390_options ()

-
const char **       nm_setting_wired_get_valid_s390_options
-                                                        (NMSettingWired *setting);
-

-Returns a list of valid s390 options. -

-
+

nm_setting_wired_get_valid_s390_options ()

+
const char **
+nm_setting_wired_get_valid_s390_options
+                               (NMSettingWired *setting);
+

Returns a list of valid s390 options.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSettingWired -

Returns :

a NULL-terminated array of strings of valid s390 options. [transfer none] -

setting

the NMSettingWired

 
+
+

Returns

+

a NULL-terminated array of strings of valid s390 options.

+

[transfer none]

+
+
-

Property Details

+

Types and Values

-

The "auto-negotiate" property

-
  "auto-negotiate"           gboolean              : Read / Write / Construct
+

NM_SETTING_WIRED_SETTING_NAME

+
#define NM_SETTING_WIRED_SETTING_NAME "802-3-ethernet"
+

-If TRUE, allow auto-negotiation of port speed and duplex mode. If -FALSE, do not allow auto-negotiation, in which case the "speed" and -"duplex" properties should be set.

-

Default value: TRUE


-

The "cloned-mac-address" property

-
  "cloned-mac-address"       gchar*                : Read / Write
+

NM_SETTING_WIRED_PORT

+
#define NM_SETTING_WIRED_PORT "port"
+

-If specified, request that the device use this MAC address instead of its -permanent MAC address. This is known as MAC cloning or spoofing.

-

Default value: NULL


-

The "duplex" property

-
  "duplex"                   gchar*                : Read / Write
+

NM_SETTING_WIRED_SPEED

+
#define NM_SETTING_WIRED_SPEED "speed"
+

-If specified, request that the device only use the specified duplex mode. -Either "half" or "full".

-

Default value: NULL


-

The "mac-address" property

-
  "mac-address"              gchar*                : Read / Write
+

NM_SETTING_WIRED_DUPLEX

+
#define NM_SETTING_WIRED_DUPLEX "duplex"
+

-If specified, this connection will only apply to the Ethernet device -whose permanent MAC address matches. This property does not change the -MAC address of the device (i.e. MAC spoofing).

-

Default value: NULL


-

The "mac-address-blacklist" property

-
  "mac-address-blacklist"    GStrv                 : Read / Write
+

NM_SETTING_WIRED_AUTO_NEGOTIATE

+
#define NM_SETTING_WIRED_AUTO_NEGOTIATE "auto-negotiate"
+

-If specified, this connection will never apply to the Ethernet device -whose permanent MAC address matches an address in the list. Each MAC -address is in the standard hex-digits-and-colons notation -(00:11:22:33:44:55).


-

The "mtu" property

-
  "mtu"                      guint                 : Read / Write / Construct
+

NM_SETTING_WIRED_MAC_ADDRESS

+
#define NM_SETTING_WIRED_MAC_ADDRESS "mac-address"
+

-If non-zero, only transmit packets of the specified size or smaller, -breaking larger packets up into multiple Ethernet frames.

-

Default value: 0


-

The "port" property

-
  "port"                     gchar*                : Read / Write
+

NM_SETTING_WIRED_CLONED_MAC_ADDRESS

+
#define NM_SETTING_WIRED_CLONED_MAC_ADDRESS "cloned-mac-address"
+

-Specific port type to use if multiple the device supports multiple -attachment methods. One of "tp" (Twisted Pair), "aui" (Attachment Unit -Interface), "bnc" (Thin Ethernet) or "mii" (Media Independent Interface. -If the device supports only one port type, this setting is ignored.

-

Default value: NULL


-

The "s390-nettype" property

-
  "s390-nettype"             gchar*                : Read / Write
+

NM_SETTING_WIRED_MAC_ADDRESS_BLACKLIST

+
#define NM_SETTING_WIRED_MAC_ADDRESS_BLACKLIST "mac-address-blacklist"
+

-s390 network device type; one of "qeth", "lcs", or "ctc", representing -the different types of virtual network devices available on s390 systems.

-

Default value: NULL


-

The "s390-options" property

-
  "s390-options"             GHashTable*           : Read / Write
+

NM_SETTING_WIRED_MTU

+
#define NM_SETTING_WIRED_MTU "mtu"
+

-Dictionary of key/value pairs of s390-specific device options. Both keys -and values must be strings. Allowed keys include "portno", "layer2", -"portname", "protocol", among others. Key names must contain only -alphanumeric characters (ie, [a-zA-Z0-9]).

+
+
+
+

NM_SETTING_WIRED_S390_SUBCHANNELS

+
#define NM_SETTING_WIRED_S390_SUBCHANNELS "s390-subchannels"
+

-Type: GHashTable(utf8,utf8)


-

The "s390-subchannels" property

-
  "s390-subchannels"         GStrv                 : Read / Write
+

NM_SETTING_WIRED_S390_NETTYPE

+
#define NM_SETTING_WIRED_S390_NETTYPE "s390-nettype"
+

-Identifies specific subchannels that this network device uses for -communication with z/VM or s390 host. Like the -"mac-address" property for non-z/VM devices, this property -can be used to ensure this connection only applies to the network device -that uses these subchannels. The list should contain exactly 3 strings, -and each string may only be composed of hexadecimal characters and the -period (.) character.


-

The "speed" property

-
  "speed"                    guint                 : Read / Write / Construct
+

NM_SETTING_WIRED_S390_OPTIONS

+
#define NM_SETTING_WIRED_S390_OPTIONS "s390-options"
+

-If non-zero, request that the device use only the specified speed. In -Mbit/s, ie 100 == 100Mbit/s.

+
+
+
+

Property Details

+
+

The “auto-negotiate” property

+
  “auto-negotiate”           gboolean
+

+

Flags: Read / Write / Construct

+

Default value: TRUE

+
+
+
+

The “cloned-mac-address” property

+
  “cloned-mac-address”       gchar *
+

+

Flags: Read / Write

+

Default value: NULL

+
+
+
+

The “duplex” property

+
  “duplex”                   gchar *
+

+

Flags: Read / Write

+

Default value: NULL

+
+
+
+

The “mac-address” property

+
  “mac-address”              gchar *
+

+

Flags: Read / Write

+

Default value: NULL

+
+
+
+

The “mac-address-blacklist” property

+
  “mac-address-blacklist”    GStrv
+

+

Flags: Read / Write

+
+
+
+

The “mtu” property

+
  “mtu”                      guint
+

+

Flags: Read / Write / Construct

+

Default value: 0

+
+
+
+

The “port” property

+
  “port”                     gchar *
+

+

Flags: Read / Write

+

Default value: NULL

+
+
+
+

The “s390-nettype” property

+
  “s390-nettype”             gchar *
+

+

Flags: Read / Write

+

Default value: NULL

+
+
+
+

The “s390-options” property

+
  “s390-options”             GHashTable *
+

+

Flags: Read / Write

+
+
+
+

The “s390-subchannels” property

+
  “s390-subchannels”         GStrv
+

+

Flags: Read / Write

+
+
+
+

The “speed” property

+
  “speed”                    guint
+

+

Flags: Read / Write / Construct

Default value: 0

+ Generated by GTK-Doc V1.21 \ No newline at end of file diff --git a/docs/libnm/html/NMSettingWireless.html b/docs/libnm/html/NMSettingWireless.html index 8cc9a471..1c59261b 100644 --- a/docs/libnm/html/NMSettingWireless.html +++ b/docs/libnm/html/NMSettingWireless.html @@ -2,34 +2,28 @@ -NMSettingWireless +libnm Reference Manual: NMSettingWireless - + - - - - - - - - - - + + + + + + +
@@ -37,1017 +31,1303 @@

NMSettingWireless

NMSettingWireless — Describes connection properties for 802.11 Wi-Fi networks

- +
-
-

Synopsis

-
#define             NM_SETTING_WIRELESS_SETTING_NAME
-#define             NM_SETTING_WIRELESS_SSID
-#define             NM_SETTING_WIRELESS_MODE
-#define             NM_SETTING_WIRELESS_BAND
-#define             NM_SETTING_WIRELESS_CHANNEL
-#define             NM_SETTING_WIRELESS_BSSID
-#define             NM_SETTING_WIRELESS_RATE
-#define             NM_SETTING_WIRELESS_TX_POWER
-#define             NM_SETTING_WIRELESS_MAC_ADDRESS
-#define             NM_SETTING_WIRELESS_CLONED_MAC_ADDRESS
-#define             NM_SETTING_WIRELESS_MAC_ADDRESS_BLACKLIST
-#define             NM_SETTING_WIRELESS_MTU
-#define             NM_SETTING_WIRELESS_SEEN_BSSIDS
-#define             NM_SETTING_WIRELESS_HIDDEN
-#define             NM_SETTING_WIRELESS_MODE_ADHOC
-#define             NM_SETTING_WIRELESS_MODE_AP
-#define             NM_SETTING_WIRELESS_MODE_INFRA
-struct              NMSettingWireless;
-                    NMSettingWirelessClass;
-NMSetting *         nm_setting_wireless_new             (void);
-GBytes *            nm_setting_wireless_get_ssid        (NMSettingWireless *setting);
-const char *        nm_setting_wireless_get_mode        (NMSettingWireless *setting);
-const char *        nm_setting_wireless_get_band        (NMSettingWireless *setting);
-guint32             nm_setting_wireless_get_channel     (NMSettingWireless *setting);
-const char *        nm_setting_wireless_get_bssid       (NMSettingWireless *setting);
-guint32             nm_setting_wireless_get_rate        (NMSettingWireless *setting);
-guint32             nm_setting_wireless_get_tx_power    (NMSettingWireless *setting);
-const char *        nm_setting_wireless_get_mac_address (NMSettingWireless *setting);
-const char *        nm_setting_wireless_get_cloned_mac_address
-                                                        (NMSettingWireless *setting);
-const char * const * nm_setting_wireless_get_mac_address_blacklist
-                                                        (NMSettingWireless *setting);
-guint32             nm_setting_wireless_get_num_mac_blacklist_items
-                                                        (NMSettingWireless *setting);
-const char *        nm_setting_wireless_get_mac_blacklist_item
-                                                        (NMSettingWireless *setting,
-                                                         guint32 idx);
-gboolean            nm_setting_wireless_add_mac_blacklist_item
-                                                        (NMSettingWireless *setting,
-                                                         const char *mac);
-void                nm_setting_wireless_remove_mac_blacklist_item
-                                                        (NMSettingWireless *setting,
-                                                         guint32 idx);
-gboolean            nm_setting_wireless_remove_mac_blacklist_item_by_value
-                                                        (NMSettingWireless *setting,
-                                                         const char *mac);
-void                nm_setting_wireless_clear_mac_blacklist_items
-                                                        (NMSettingWireless *setting);
-guint32             nm_setting_wireless_get_mtu         (NMSettingWireless *setting);
-gboolean            nm_setting_wireless_get_hidden      (NMSettingWireless *setting);
-gboolean            nm_setting_wireless_add_seen_bssid  (NMSettingWireless *setting,
-                                                         const char *bssid);
-guint32             nm_setting_wireless_get_num_seen_bssids
-                                                        (NMSettingWireless *setting);
-const char *        nm_setting_wireless_get_seen_bssid  (NMSettingWireless *setting,
-                                                         guint32 i);
-gboolean            nm_setting_wireless_ap_security_compatible
-                                                        (NMSettingWireless *s_wireless,
-                                                         NMSettingWirelessSecurity *s_wireless_sec,
-                                                         NM80211ApFlags ap_flags,
-                                                         NM80211ApSecurityFlags ap_wpa,
-                                                         NM80211ApSecurityFlags ap_rsn,
-                                                         NM80211Mode ap_mode);
-
-
-

Object Hierarchy

-
-  GObject
-   +----NMSetting
-         +----NMSettingWireless
-
+

Functions

+
++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+NMSetting * + +nm_setting_wireless_new () +
+GBytes * + +nm_setting_wireless_get_ssid () +
const char * + +nm_setting_wireless_get_mode () +
const char * + +nm_setting_wireless_get_band () +
+guint32 + +nm_setting_wireless_get_channel () +
const char * + +nm_setting_wireless_get_bssid () +
+guint32 + +nm_setting_wireless_get_rate () +
+guint32 + +nm_setting_wireless_get_tx_power () +
const char * + +nm_setting_wireless_get_mac_address () +
const char * + +nm_setting_wireless_get_cloned_mac_address () +
const char * const * + +nm_setting_wireless_get_mac_address_blacklist () +
+guint32 + +nm_setting_wireless_get_num_mac_blacklist_items () +
const char * + +nm_setting_wireless_get_mac_blacklist_item () +
+gboolean + +nm_setting_wireless_add_mac_blacklist_item () +
+void + +nm_setting_wireless_remove_mac_blacklist_item () +
+gboolean + +nm_setting_wireless_remove_mac_blacklist_item_by_value () +
+void + +nm_setting_wireless_clear_mac_blacklist_items () +
+guint32 + +nm_setting_wireless_get_mtu () +
+gboolean + +nm_setting_wireless_get_hidden () +
+gboolean + +nm_setting_wireless_add_seen_bssid () +
+guint32 + +nm_setting_wireless_get_num_seen_bssids () +
const char * + +nm_setting_wireless_get_seen_bssid () +
+gboolean + +nm_setting_wireless_ap_security_compatible () +

Properties

-
-  "band"                     gchar*                : Read / Write
-  "bssid"                    gchar*                : Read / Write
-  "channel"                  guint                 : Read / Write / Construct
-  "cloned-mac-address"       gchar*                : Read / Write
-  "hidden"                   gboolean              : Read / Write
-  "mac-address"              gchar*                : Read / Write
-  "mac-address-blacklist"    GStrv                 : Read / Write
-  "mode"                     gchar*                : Read / Write
-  "mtu"                      guint                 : Read / Write / Construct
-  "rate"                     guint                 : Read / Write / Construct
-  "seen-bssids"              GStrv                 : Read / Write
-  "ssid"                     GBytes*               : Read / Write
-  "tx-power"                 guint                 : Read / Write / Construct
-
+
+++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+gchar *bandRead / Write
+gchar *bssidRead / Write
guintchannelRead / Write / Construct
+gchar *cloned-mac-addressRead / Write
gbooleanhiddenRead / Write
+gchar *mac-addressRead / Write
GStrvmac-address-blacklistRead / Write
+gchar *modeRead / Write
guintmtuRead / Write / Construct
guintrateRead / Write / Construct
GStrvseen-bssidsRead / Write
+GBytes *ssidRead / Write
guinttx-powerRead / Write / Construct
-

Description

-

-The NMSettingWireless object is a NMSetting subclass that describes properties -necessary for connection to 802.11 Wi-Fi networks. -

+

Types and Values

+
-

Details

-
-

NM_SETTING_WIRELESS_SETTING_NAME

-
#define NM_SETTING_WIRELESS_SETTING_NAME "802-11-wireless"
-
-

-

-
-
-
-

NM_SETTING_WIRELESS_SSID

-
#define NM_SETTING_WIRELESS_SSID        "ssid"
-
-

-

-
-
-
-

NM_SETTING_WIRELESS_MODE

-
#define NM_SETTING_WIRELESS_MODE        "mode"
-
-

-

-
-
-
-

NM_SETTING_WIRELESS_BAND

-
#define NM_SETTING_WIRELESS_BAND        "band"
-
-

-

-
-
-
-

NM_SETTING_WIRELESS_CHANNEL

-
#define NM_SETTING_WIRELESS_CHANNEL     "channel"
-
-

-

-
-
-
-

NM_SETTING_WIRELESS_BSSID

-
#define NM_SETTING_WIRELESS_BSSID       "bssid"
-
-

-

-
-
-
-

NM_SETTING_WIRELESS_RATE

-
#define NM_SETTING_WIRELESS_RATE        "rate"
-
-

-

-
-
-
-

NM_SETTING_WIRELESS_TX_POWER

-
#define NM_SETTING_WIRELESS_TX_POWER    "tx-power"
-
-

-

-
-
-
-

NM_SETTING_WIRELESS_MAC_ADDRESS

-
#define NM_SETTING_WIRELESS_MAC_ADDRESS "mac-address"
-
-

-

-
-
-
-

NM_SETTING_WIRELESS_CLONED_MAC_ADDRESS

-
#define NM_SETTING_WIRELESS_CLONED_MAC_ADDRESS "cloned-mac-address"
-
-

-

-
-
-
-

NM_SETTING_WIRELESS_MAC_ADDRESS_BLACKLIST

-
#define NM_SETTING_WIRELESS_MAC_ADDRESS_BLACKLIST "mac-address-blacklist"
-
-

-

-
-
-
-

NM_SETTING_WIRELESS_MTU

-
#define NM_SETTING_WIRELESS_MTU         "mtu"
-
-

-

-
-
-
-

NM_SETTING_WIRELESS_SEEN_BSSIDS

-
#define NM_SETTING_WIRELESS_SEEN_BSSIDS "seen-bssids"
-
-

-

-
-
-
-

NM_SETTING_WIRELESS_HIDDEN

-
#define NM_SETTING_WIRELESS_HIDDEN      "hidden"
-
-

-

-
-
-
-

NM_SETTING_WIRELESS_MODE_ADHOC

-
#define NM_SETTING_WIRELESS_MODE_ADHOC  "adhoc"
-
-

-Indicates Ad-Hoc mode where no access point is expected to be present. -

-
-
-
-

NM_SETTING_WIRELESS_MODE_AP

-
#define NM_SETTING_WIRELESS_MODE_AP     "ap"
+

Object Hierarchy

+
    GObject
+    ╰── NMSetting
+        ╰── NMSettingWireless
 
-

-Indicates AP/master mode where the wireless device is started as an access -point/hotspot. -

-
-
-

NM_SETTING_WIRELESS_MODE_INFRA

-
#define NM_SETTING_WIRELESS_MODE_INFRA  "infrastructure"
-
-

-Indicates infrastructure mode where an access point is expected to be present -for this connection. -

+
+

Description

+

The NMSettingWireless object is a NMSetting subclass that describes properties +necessary for connection to 802.11 Wi-Fi networks.

-
+
+

Functions

-

struct NMSettingWireless

-
struct NMSettingWireless;
-

-

+

nm_setting_wireless_new ()

+
NMSetting *
+nm_setting_wireless_new (void);
+

Creates a new NMSettingWireless object with default values.

+
+

Returns

+

the new empty NMSettingWireless object.

+

[transfer full]

-
-
-

NMSettingWirelessClass

-
typedef struct {
-	NMSettingClass parent;
-} NMSettingWirelessClass;
-
-

-


-

nm_setting_wireless_new ()

-
NMSetting *         nm_setting_wireless_new             (void);
-

-Creates a new NMSettingWireless object with default values. -

-
+

nm_setting_wireless_get_ssid ()

+
GBytes *
+nm_setting_wireless_get_ssid (NMSettingWireless *setting);
+
+

Parameters

+
--+++ - - + + +

Returns :

the new empty NMSettingWireless object. [transfer full] -

setting

the NMSettingWireless

 
-
-
-

nm_setting_wireless_get_ssid ()

-
GBytes *            nm_setting_wireless_get_ssid        (NMSettingWireless *setting);
-
---- - - - - - - - - - - -

setting :

the NMSettingWireless -

Returns :

the "ssid" property of the setting. [transfer none] -
+
+

Returns

+

the “ssid” property of the setting.

+

[transfer none]

+

-

nm_setting_wireless_get_mode ()

-
const char *        nm_setting_wireless_get_mode        (NMSettingWireless *setting);
-
+

nm_setting_wireless_get_mode ()

+
const char *
+nm_setting_wireless_get_mode (NMSettingWireless *setting);
+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSettingWireless -

Returns :

the "mode" property of the setting

setting

the NMSettingWireless

 
+
+

Returns

+

the “mode” property of the setting

+

+
+

-

nm_setting_wireless_get_band ()

-
const char *        nm_setting_wireless_get_band        (NMSettingWireless *setting);
-
+

nm_setting_wireless_get_band ()

+
const char *
+nm_setting_wireless_get_band (NMSettingWireless *setting);
+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSettingWireless -

Returns :

the "band" property of the setting

setting

the NMSettingWireless

 
+
+

Returns

+

the “band” property of the setting

+

+
+

-

nm_setting_wireless_get_channel ()

-
guint32             nm_setting_wireless_get_channel     (NMSettingWireless *setting);
-
+

nm_setting_wireless_get_channel ()

+
guint32
+nm_setting_wireless_get_channel (NMSettingWireless *setting);
+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSettingWireless -

Returns :

the "channel" property of the setting

setting

the NMSettingWireless

 
+
+

Returns

+

the “channel” property of the setting

+

+
+

-

nm_setting_wireless_get_bssid ()

-
const char *        nm_setting_wireless_get_bssid       (NMSettingWireless *setting);
-
+

nm_setting_wireless_get_bssid ()

+
const char *
+nm_setting_wireless_get_bssid (NMSettingWireless *setting);
+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSettingWireless -

Returns :

the "bssid" property of the setting

setting

the NMSettingWireless

 
+
+

Returns

+

the “bssid” property of the setting

+

+
+

-

nm_setting_wireless_get_rate ()

-
guint32             nm_setting_wireless_get_rate        (NMSettingWireless *setting);
-
+

nm_setting_wireless_get_rate ()

+
guint32
+nm_setting_wireless_get_rate (NMSettingWireless *setting);
+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSettingWireless -

Returns :

the "rate" property of the setting

setting

the NMSettingWireless

 
+
+

Returns

+

the “rate” property of the setting

+

+
+

-

nm_setting_wireless_get_tx_power ()

-
guint32             nm_setting_wireless_get_tx_power    (NMSettingWireless *setting);
-
+

nm_setting_wireless_get_tx_power ()

+
guint32
+nm_setting_wireless_get_tx_power (NMSettingWireless *setting);
+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSettingWireless -

Returns :

the "tx-power" property of the setting

setting

the NMSettingWireless

 
+
+

Returns

+

the “tx-power” property of the setting

+

+
+
-

nm_setting_wireless_get_mac_address ()

-
const char *        nm_setting_wireless_get_mac_address (NMSettingWireless *setting);
-
+

nm_setting_wireless_get_mac_address ()

+
const char *
+nm_setting_wireless_get_mac_address (NMSettingWireless *setting);
+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSettingWireless -

Returns :

the "mac-address" property of the setting

setting

the NMSettingWireless

 
+
+

Returns

+

the “mac-address” property of the setting

+

+
+
-

nm_setting_wireless_get_cloned_mac_address ()

-
const char *        nm_setting_wireless_get_cloned_mac_address
-                                                        (NMSettingWireless *setting);
-
+

nm_setting_wireless_get_cloned_mac_address ()

+
const char *
+nm_setting_wireless_get_cloned_mac_address
+                               (NMSettingWireless *setting);
+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSettingWireless -

Returns :

the "cloned-mac-address" property of the setting

setting

the NMSettingWireless

 
+
+

Returns

+

the “cloned-mac-address” property of the setting

+

+
+
-

nm_setting_wireless_get_mac_address_blacklist ()

-
const char * const * nm_setting_wireless_get_mac_address_blacklist
-                                                        (NMSettingWireless *setting);
-
+

nm_setting_wireless_get_mac_address_blacklist ()

+
const char * const *
+nm_setting_wireless_get_mac_address_blacklist
+                               (NMSettingWireless *setting);
+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSettingWireless -

Returns :

the "mac-address-blacklist" property of the setting

setting

the NMSettingWireless

 
+
+

Returns

+

the “mac-address-blacklist” property of the setting

+

+
+
-

nm_setting_wireless_get_num_mac_blacklist_items ()

-
guint32             nm_setting_wireless_get_num_mac_blacklist_items
-                                                        (NMSettingWireless *setting);
-
+

nm_setting_wireless_get_num_mac_blacklist_items ()

+
guint32
+nm_setting_wireless_get_num_mac_blacklist_items
+                               (NMSettingWireless *setting);
+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSettingWireless -

Returns :

the number of blacklisted MAC addresses

setting

the NMSettingWireless

 
+
+

Returns

+

the number of blacklisted MAC addresses

+

+
+
-

nm_setting_wireless_get_mac_blacklist_item ()

-
const char *        nm_setting_wireless_get_mac_blacklist_item
-                                                        (NMSettingWireless *setting,
-                                                         guint32 idx);
-
+

nm_setting_wireless_get_mac_blacklist_item ()

+
const char *
+nm_setting_wireless_get_mac_blacklist_item
+                               (NMSettingWireless *setting,
+                                guint32 idx);
+
+

Parameters

+
--+++ - - - - - - + + + - - + + +

setting :

the NMSettingWireless -

idx :

the zero-based index of the MAC address entry

setting

the NMSettingWireless

 

Returns :

the blacklisted MAC address string (hex-digits-and-colons notation) -at index idx -

idx

the zero-based index of the MAC address entry

 
+
+

Returns

+

the blacklisted MAC address string (hex-digits-and-colons notation) +at index idx +

+

+
+
-

nm_setting_wireless_add_mac_blacklist_item ()

-
gboolean            nm_setting_wireless_add_mac_blacklist_item
-                                                        (NMSettingWireless *setting,
-                                                         const char *mac);
-

-Adds a new MAC address to the "mac-address-blacklist" property. -

-
+

nm_setting_wireless_add_mac_blacklist_item ()

+
gboolean
+nm_setting_wireless_add_mac_blacklist_item
+                               (NMSettingWireless *setting,
+                                const char *mac);
+

Adds a new MAC address to the “mac-address-blacklist” property.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + +

setting :

the NMSettingWireless -

mac :

the MAC address string (hex-digits-and-colons notation) to blacklist

setting

the NMSettingWireless

 

Returns :

-TRUE if the MAC address was added; FALSE if the MAC address -is invalid or was already present

mac

the MAC address string (hex-digits-and-colons notation) to blacklist

 
+
+

Returns

+

TRUE if the MAC address was added; FALSE if the MAC address +is invalid or was already present

+

+
+
-

nm_setting_wireless_remove_mac_blacklist_item ()

-
void                nm_setting_wireless_remove_mac_blacklist_item
-                                                        (NMSettingWireless *setting,
-                                                         guint32 idx);
-

-Removes the MAC address at index idx from the blacklist. -

-
+

nm_setting_wireless_remove_mac_blacklist_item ()

+
void
+nm_setting_wireless_remove_mac_blacklist_item
+                               (NMSettingWireless *setting,
+                                guint32 idx);
+

Removes the MAC address at index idx + from the blacklist.

+
+

Parameters

+
--+++ - - + + + - - + + +

setting :

the NMSettingWireless -

setting

the NMSettingWireless

 

idx :

index number of the MAC address

idx

index number of the MAC address

 
+
-

nm_setting_wireless_remove_mac_blacklist_item_by_value ()

-
gboolean            nm_setting_wireless_remove_mac_blacklist_item_by_value
-                                                        (NMSettingWireless *setting,
-                                                         const char *mac);
-

-Removes the MAC address mac from the blacklist. -

-
+

nm_setting_wireless_remove_mac_blacklist_item_by_value ()

+
gboolean
+nm_setting_wireless_remove_mac_blacklist_item_by_value
+                               (NMSettingWireless *setting,
+                                const char *mac);
+

Removes the MAC address mac + from the blacklist.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + +

setting :

the NMSettingWireless -

mac :

the MAC address string (hex-digits-and-colons notation) to remove from -the blacklist

setting

the NMSettingWireless

 

Returns :

-TRUE if the MAC address was found and removed; FALSE if it was not.

mac

the MAC address string (hex-digits-and-colons notation) to remove from +the blacklist

 
+
+

Returns

+

TRUE if the MAC address was found and removed; FALSE if it was not.

+

+
+
-

nm_setting_wireless_clear_mac_blacklist_items ()

-
void                nm_setting_wireless_clear_mac_blacklist_items
-                                                        (NMSettingWireless *setting);
-

-Removes all blacklisted MAC addresses. -

-
+

nm_setting_wireless_clear_mac_blacklist_items ()

+
void
+nm_setting_wireless_clear_mac_blacklist_items
+                               (NMSettingWireless *setting);
+

Removes all blacklisted MAC addresses.

+
+

Parameters

+
--+++ - - + + +

setting :

the NMSettingWireless -

setting

the NMSettingWireless

 
+
-

nm_setting_wireless_get_mtu ()

-
guint32             nm_setting_wireless_get_mtu         (NMSettingWireless *setting);
-
+

nm_setting_wireless_get_mtu ()

+
guint32
+nm_setting_wireless_get_mtu (NMSettingWireless *setting);
+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSettingWireless -

Returns :

the "mtu" property of the setting

setting

the NMSettingWireless

 
+
+

Returns

+

the “mtu” property of the setting

+

+
+
-

nm_setting_wireless_get_hidden ()

-
gboolean            nm_setting_wireless_get_hidden      (NMSettingWireless *setting);
-
+

nm_setting_wireless_get_hidden ()

+
gboolean
+nm_setting_wireless_get_hidden (NMSettingWireless *setting);
+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSettingWireless -

Returns :

the "hidden" property of the setting

setting

the NMSettingWireless

 
+
+

Returns

+

the “hidden” property of the setting

+

+
+
-

nm_setting_wireless_add_seen_bssid ()

-
gboolean            nm_setting_wireless_add_seen_bssid  (NMSettingWireless *setting,
-                                                         const char *bssid);
-

-Adds a new Wi-Fi AP's BSSID to the previously seen BSSID list of the setting. +

nm_setting_wireless_add_seen_bssid ()

+
gboolean
+nm_setting_wireless_add_seen_bssid (NMSettingWireless *setting,
+                                    const char *bssid);
+

Adds a new Wi-Fi AP's BSSID to the previously seen BSSID list of the setting. NetworkManager now tracks previously seen BSSIDs internally so this function no longer has much use. Actually, changes you make using this function will -not be preserved. -

-
+not be preserved.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + +

setting :

the NMSettingWireless -

bssid :

the new BSSID to add to the list

setting

the NMSettingWireless

 

Returns :

-TRUE if bssid was already known, FALSE if not

bssid

the new BSSID to add to the list

 
+
+

Returns

+

TRUE if bssid +was already known, FALSE if not

+

+
+
-

nm_setting_wireless_get_num_seen_bssids ()

-
guint32             nm_setting_wireless_get_num_seen_bssids
-                                                        (NMSettingWireless *setting);
-
+

nm_setting_wireless_get_num_seen_bssids ()

+
guint32
+nm_setting_wireless_get_num_seen_bssids
+                               (NMSettingWireless *setting);
+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSettingWireless -

Returns :

the number of BSSIDs in the previously seen BSSID list

setting

the NMSettingWireless

 
+
+

Returns

+

the number of BSSIDs in the previously seen BSSID list

+

+
+
-

nm_setting_wireless_get_seen_bssid ()

-
const char *        nm_setting_wireless_get_seen_bssid  (NMSettingWireless *setting,
-                                                         guint32 i);
-
+

nm_setting_wireless_get_seen_bssid ()

+
const char *
+nm_setting_wireless_get_seen_bssid (NMSettingWireless *setting,
+                                    guint32 i);
+
+

Parameters

+
--+++ - - - - - - + + + - - + + +

setting :

the NMSettingWireless -

i :

index of a BSSID in the previously seen BSSID list

setting

the NMSettingWireless

 

Returns :

the BSSID at index i -

i

index of a BSSID in the previously seen BSSID list

 
+
+

Returns

+

the BSSID at index i +

+

+
+
-

nm_setting_wireless_ap_security_compatible ()

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

-Given a NMSettingWireless and an optional NMSettingWirelessSecurity, +

nm_setting_wireless_ap_security_compatible ()

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

Given a NMSettingWireless and an optional NMSettingWirelessSecurity, determine if the configuration given by the settings is compatible with the security of an access point using that access point's capability flags and mode. Useful for clients that wish to filter a set of connections against a set of access points and determine which connections are -compatible with which access points. -

-
+compatible with which access points.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + + - - + + + - - + + + - - + + + - - + + +

s_wireless :

a NMSettingWireless -

s_wireless_sec :

a NMSettingWirelessSecurity or NULL -

s_wireless

a NMSettingWireless

 

ap_flags :

the NM80211ApFlags of the given access point

s_wireless_sec

a NMSettingWirelessSecurity or NULL

 

ap_wpa :

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

ap_flags

the NM80211ApFlags of the given access point

 

ap_rsn :

the NM80211ApSecurityFlags of the given access point's WPA2/RSN -capabilities

ap_wpa

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

 

ap_mode :

the 802.11 mode of the AP, either Ad-Hoc or Infrastructure

ap_rsn

the NM80211ApSecurityFlags of the given access point's WPA2/RSN +capabilities

 

Returns :

-TRUE if the given settings are compatible with the access point's -security flags and mode, FALSE if they are not.

ap_mode

the 802.11 mode of the AP, either Ad-Hoc or Infrastructure

 
+
+

Returns

+

TRUE if the given settings are compatible with the access point's +security flags and mode, FALSE if they are not.

+

+
+
-

Property Details

+

Types and Values

-

The "band" property

-
  "band"                     gchar*                : Read / Write
+

NM_SETTING_WIRELESS_SETTING_NAME

+
#define NM_SETTING_WIRELESS_SETTING_NAME "802-11-wireless"
+

-802.11 frequency band of the network. One of "a" for 5GHz 802.11a or -"bg" for 2.4GHz 802.11. This will lock associations to the Wi-Fi network -to the specific band, i.e. if "a" is specified, the device will not -associate with the same network in the 2.4GHz band even if the network's -settings are compatible. This setting depends on specific driver -capability and may not work with all drivers.

-

Default value: NULL


-

The "bssid" property

-
  "bssid"                    gchar*                : Read / Write
+

NM_SETTING_WIRELESS_SSID

+
#define NM_SETTING_WIRELESS_SSID        "ssid"
+

-If specified, directs the device to only associate with the given access -point. This capability is highly driver dependent and not supported by -all devices. Note: this property does not control the BSSID used when -creating an Ad-Hoc network and is unlikely to in the future.

-

Default value: NULL


-

The "channel" property

-
  "channel"                  guint                 : Read / Write / Construct
+

NM_SETTING_WIRELESS_MODE

+
#define NM_SETTING_WIRELESS_MODE        "mode"
+

-Wireless channel to use for the Wi-Fi connection. The device will only -join (or create for Ad-Hoc networks) a Wi-Fi network on the specified -channel. Because channel numbers overlap between bands, this property -also requires the "band" property to be set.

-

Default value: 0


-

The "cloned-mac-address" property

-
  "cloned-mac-address"       gchar*                : Read / Write
+

NM_SETTING_WIRELESS_BAND

+
#define NM_SETTING_WIRELESS_BAND        "band"
+

-If specified, request that the Wi-Fi device use this MAC address instead -of its permanent MAC address. This is known as MAC cloning or spoofing.

-

Default value: NULL


-

The "hidden" property

-
  "hidden"                   gboolean              : Read / Write
+

NM_SETTING_WIRELESS_CHANNEL

+
#define NM_SETTING_WIRELESS_CHANNEL     "channel"
+

-If TRUE, indicates this network is a non-broadcasting network that hides -its SSID. In this case various workarounds may take place, such as -probe-scanning the SSID for more reliable network discovery. However, -these workarounds expose inherent insecurities with hidden SSID networks, -and thus hidden SSID networks should be used with caution.

-

Default value: FALSE


-

The "mac-address" property

-
  "mac-address"              gchar*                : Read / Write
+

NM_SETTING_WIRELESS_BSSID

+
#define NM_SETTING_WIRELESS_BSSID       "bssid"
+
+

+

+
+
+
+

NM_SETTING_WIRELESS_RATE

+
#define NM_SETTING_WIRELESS_RATE        "rate"
+

-If specified, this connection will only apply to the Wi-Fi device whose -permanent MAC address matches. This property does not change the MAC -address of the device (i.e. MAC spoofing).

-

Default value: NULL


-

The "mac-address-blacklist" property

-
  "mac-address-blacklist"    GStrv                 : Read / Write
+

NM_SETTING_WIRELESS_TX_POWER

+
#define NM_SETTING_WIRELESS_TX_POWER    "tx-power"
+

-A list of permanent MAC addresses of Wi-Fi devices to which this -connection should never apply. Each MAC address should be given in the -standard hex-digits-and-colons notation (eg "00:11:22:33:44:55").


-

The "mode" property

-
  "mode"                     gchar*                : Read / Write
+

NM_SETTING_WIRELESS_MAC_ADDRESS

+
#define NM_SETTING_WIRELESS_MAC_ADDRESS "mac-address"
+

-Wi-Fi network mode; one of "infrastructure", "adhoc" or "ap". If blank, -infrastructure is assumed.

-

Default value: NULL


-

The "mtu" property

-
  "mtu"                      guint                 : Read / Write / Construct
+

NM_SETTING_WIRELESS_CLONED_MAC_ADDRESS

+
#define NM_SETTING_WIRELESS_CLONED_MAC_ADDRESS "cloned-mac-address"
+

-If non-zero, only transmit packets of the specified size or smaller, -breaking larger packets up into multiple Ethernet frames.

-

Default value: 0


-

The "rate" property

-
  "rate"                     guint                 : Read / Write / Construct
+

NM_SETTING_WIRELESS_MAC_ADDRESS_BLACKLIST

+
#define NM_SETTING_WIRELESS_MAC_ADDRESS_BLACKLIST "mac-address-blacklist"
+

-If non-zero, directs the device to only use the specified bitrate for -communication with the access point. Units are in Kb/s, ie 5500 = 5.5 -Mbit/s. This property is highly driver dependent and not all devices -support setting a static bitrate.

-

Default value: 0


-

The "seen-bssids" property

-
  "seen-bssids"              GStrv                 : Read / Write
+

NM_SETTING_WIRELESS_MTU

+
#define NM_SETTING_WIRELESS_MTU         "mtu"
+

-A list of BSSIDs (each BSSID formatted as a MAC address like -"00:11:22:33:44:55") that have been detected as part of the Wi-Fi -network. NetworkManager internally tracks previously seen BSSIDs. The -property is only meant for reading and reflects the BSSID list of -NetworkManager. The changes you make to this property will not be -preserved.


-

The "ssid" property

-
  "ssid"                     GBytes*               : Read / Write
+

NM_SETTING_WIRELESS_SEEN_BSSIDS

+
#define NM_SETTING_WIRELESS_SEEN_BSSIDS "seen-bssids"
+

-SSID of the Wi-Fi network. Must be specified.


-

The "tx-power" property

-
  "tx-power"                 guint                 : Read / Write / Construct
+

NM_SETTING_WIRELESS_HIDDEN

+
#define NM_SETTING_WIRELESS_HIDDEN      "hidden"
+

-If non-zero, directs the device to use the specified transmit power. -Units are dBm. This property is highly driver dependent and not all -devices support setting a static transmit power.

+
+
+
+

NM_SETTING_WIRELESS_MODE_ADHOC

+
#define NM_SETTING_WIRELESS_MODE_ADHOC  "adhoc"
+
+

Indicates Ad-Hoc mode where no access point is expected to be present.

+
+
+
+

NM_SETTING_WIRELESS_MODE_AP

+
#define NM_SETTING_WIRELESS_MODE_AP     "ap"
+
+

Indicates AP/master mode where the wireless device is started as an access +point/hotspot.

+
+
+
+

NM_SETTING_WIRELESS_MODE_INFRA

+
#define NM_SETTING_WIRELESS_MODE_INFRA  "infrastructure"
+
+

Indicates infrastructure mode where an access point is expected to be present +for this connection.

+
+
+
+

Property Details

+
+

The “band” property

+
  “band”                     gchar *
+

+

Flags: Read / Write

+

Default value: NULL

+
+
+
+

The “bssid” property

+
  “bssid”                    gchar *
+

+

Flags: Read / Write

+

Default value: NULL

+
+
+
+

The “channel” property

+
  “channel”                  guint
+

+

Flags: Read / Write / Construct

+

Default value: 0

+
+
+
+

The “cloned-mac-address” property

+
  “cloned-mac-address”       gchar *
+

+

Flags: Read / Write

+

Default value: NULL

+
+
+
+

The “hidden” property

+
  “hidden”                   gboolean
+

+

Flags: Read / Write

+

Default value: FALSE

+
+
+
+

The “mac-address” property

+
  “mac-address”              gchar *
+

+

Flags: Read / Write

+

Default value: NULL

+
+
+
+

The “mac-address-blacklist” property

+
  “mac-address-blacklist”    GStrv
+

+

Flags: Read / Write

+
+
+
+

The “mode” property

+
  “mode”                     gchar *
+

+

Flags: Read / Write

+

Default value: NULL

+
+
+
+

The “mtu” property

+
  “mtu”                      guint
+

+

Flags: Read / Write / Construct

+

Default value: 0

+
+
+
+

The “rate” property

+
  “rate”                     guint
+

+

Flags: Read / Write / Construct

+

Default value: 0

+
+
+
+

The “seen-bssids” property

+
  “seen-bssids”              GStrv
+

+

Flags: Read / Write

+
+
+
+

The “ssid” property

+
  “ssid”                     GBytes *
+

+

Flags: Read / Write

+
+
+
+

The “tx-power” property

+
  “tx-power”                 guint
+

+

Flags: Read / Write / Construct

Default value: 0

+ Generated by GTK-Doc V1.21 \ No newline at end of file diff --git a/docs/libnm/html/NMSettingWirelessSecurity.html b/docs/libnm/html/NMSettingWirelessSecurity.html index b302a113..4542c113 100644 --- a/docs/libnm/html/NMSettingWirelessSecurity.html +++ b/docs/libnm/html/NMSettingWirelessSecurity.html @@ -2,34 +2,28 @@ -NMSettingWirelessSecurity +libnm Reference Manual: NMSettingWirelessSecurity - + - - - - - - - - - - + + + + + + +
@@ -38,1406 +32,1763 @@

NMSettingWirelessSecurity — Describes connection properties for Wi-Fi networks that use WEP, LEAP, WPA or WPA2/RSN security

- +
-
-

Synopsis

-
#define             NM_SETTING_WIRELESS_SECURITY_SETTING_NAME
-enum                NMWepKeyType;
-#define             NM_SETTING_WIRELESS_SECURITY_KEY_MGMT
-#define             NM_SETTING_WIRELESS_SECURITY_WEP_TX_KEYIDX
-#define             NM_SETTING_WIRELESS_SECURITY_AUTH_ALG
-#define             NM_SETTING_WIRELESS_SECURITY_PROTO
-#define             NM_SETTING_WIRELESS_SECURITY_PAIRWISE
-#define             NM_SETTING_WIRELESS_SECURITY_GROUP
-#define             NM_SETTING_WIRELESS_SECURITY_LEAP_USERNAME
-#define             NM_SETTING_WIRELESS_SECURITY_WEP_KEY0
-#define             NM_SETTING_WIRELESS_SECURITY_WEP_KEY1
-#define             NM_SETTING_WIRELESS_SECURITY_WEP_KEY2
-#define             NM_SETTING_WIRELESS_SECURITY_WEP_KEY3
-#define             NM_SETTING_WIRELESS_SECURITY_WEP_KEY_FLAGS
-#define             NM_SETTING_WIRELESS_SECURITY_WEP_KEY_TYPE
-#define             NM_SETTING_WIRELESS_SECURITY_PSK
-#define             NM_SETTING_WIRELESS_SECURITY_PSK_FLAGS
-#define             NM_SETTING_WIRELESS_SECURITY_LEAP_PASSWORD
-#define             NM_SETTING_WIRELESS_SECURITY_LEAP_PASSWORD_FLAGS
-struct              NMSettingWirelessSecurity;
-                    NMSettingWirelessSecurityClass;
-NMSetting *         nm_setting_wireless_security_new    (void);
-const char *        nm_setting_wireless_security_get_key_mgmt
-                                                        (NMSettingWirelessSecurity *setting);
-guint32             nm_setting_wireless_security_get_num_protos
-                                                        (NMSettingWirelessSecurity *setting);
-const char *        nm_setting_wireless_security_get_proto
-                                                        (NMSettingWirelessSecurity *setting,
-                                                         guint32 i);
-gboolean            nm_setting_wireless_security_add_proto
-                                                        (NMSettingWirelessSecurity *setting,
-                                                         const char *proto);
-void                nm_setting_wireless_security_remove_proto
-                                                        (NMSettingWirelessSecurity *setting,
-                                                         guint32 i);
-gboolean            nm_setting_wireless_security_remove_proto_by_value
-                                                        (NMSettingWirelessSecurity *setting,
-                                                         const char *proto);
-void                nm_setting_wireless_security_clear_protos
-                                                        (NMSettingWirelessSecurity *setting);
-guint32             nm_setting_wireless_security_get_num_pairwise
-                                                        (NMSettingWirelessSecurity *setting);
-const char *        nm_setting_wireless_security_get_pairwise
-                                                        (NMSettingWirelessSecurity *setting,
-                                                         guint32 i);
-gboolean            nm_setting_wireless_security_add_pairwise
-                                                        (NMSettingWirelessSecurity *setting,
-                                                         const char *pairwise);
-void                nm_setting_wireless_security_remove_pairwise
-                                                        (NMSettingWirelessSecurity *setting,
-                                                         guint32 i);
-gboolean            nm_setting_wireless_security_remove_pairwise_by_value
-                                                        (NMSettingWirelessSecurity *setting,
-                                                         const char *pairwise);
-void                nm_setting_wireless_security_clear_pairwise
-                                                        (NMSettingWirelessSecurity *setting);
-guint32             nm_setting_wireless_security_get_num_groups
-                                                        (NMSettingWirelessSecurity *setting);
-const char *        nm_setting_wireless_security_get_group
-                                                        (NMSettingWirelessSecurity *setting,
-                                                         guint32 i);
-gboolean            nm_setting_wireless_security_add_group
-                                                        (NMSettingWirelessSecurity *setting,
-                                                         const char *group);
-void                nm_setting_wireless_security_remove_group
-                                                        (NMSettingWirelessSecurity *setting,
-                                                         guint32 i);
-gboolean            nm_setting_wireless_security_remove_group_by_value
-                                                        (NMSettingWirelessSecurity *setting,
-                                                         const char *group);
-void                nm_setting_wireless_security_clear_groups
-                                                        (NMSettingWirelessSecurity *setting);
-const char *        nm_setting_wireless_security_get_psk
-                                                        (NMSettingWirelessSecurity *setting);
-NMSettingSecretFlags nm_setting_wireless_security_get_psk_flags
-                                                        (NMSettingWirelessSecurity *setting);
-const char *        nm_setting_wireless_security_get_leap_username
-                                                        (NMSettingWirelessSecurity *setting);
-const char *        nm_setting_wireless_security_get_leap_password
-                                                        (NMSettingWirelessSecurity *setting);
-NMSettingSecretFlags nm_setting_wireless_security_get_leap_password_flags
-                                                        (NMSettingWirelessSecurity *setting);
-const char *        nm_setting_wireless_security_get_wep_key
-                                                        (NMSettingWirelessSecurity *setting,
-                                                         guint32 idx);
-void                nm_setting_wireless_security_set_wep_key
-                                                        (NMSettingWirelessSecurity *setting,
-                                                         guint32 idx,
-                                                         const char *key);
-guint32             nm_setting_wireless_security_get_wep_tx_keyidx
-                                                        (NMSettingWirelessSecurity *setting);
-const char *        nm_setting_wireless_security_get_auth_alg
-                                                        (NMSettingWirelessSecurity *setting);
-NMSettingSecretFlags nm_setting_wireless_security_get_wep_key_flags
-                                                        (NMSettingWirelessSecurity *setting);
-NMWepKeyType        nm_setting_wireless_security_get_wep_key_type
-                                                        (NMSettingWirelessSecurity *setting);
-
-
-
-

Object Hierarchy

-
-  GEnum
-   +----NMWepKeyType
-
-
-  GObject
-   +----NMSetting
-         +----NMSettingWirelessSecurity
-
-
-
-

Properties

-
-  "auth-alg"                 gchar*                : Read / Write
-  "group"                    GStrv                 : Read / Write
-  "key-mgmt"                 gchar*                : Read / Write
-  "leap-password"            gchar*                : Read / Write
-  "leap-password-flags"      NMSettingSecretFlags  : Read / Write
-  "leap-username"            gchar*                : Read / Write
-  "pairwise"                 GStrv                 : Read / Write
-  "proto"                    GStrv                 : Read / Write
-  "psk"                      gchar*                : Read / Write
-  "psk-flags"                NMSettingSecretFlags  : Read / Write
-  "wep-key-flags"            NMSettingSecretFlags  : Read / Write
-  "wep-key-type"             NMWepKeyType          : Read / Write / Construct
-  "wep-key0"                 gchar*                : Read / Write
-  "wep-key1"                 gchar*                : Read / Write
-  "wep-key2"                 gchar*                : Read / Write
-  "wep-key3"                 gchar*                : Read / Write
-  "wep-tx-keyidx"            guint                 : Read / Write / Construct
-
-
-
-

Description

-

-The NMSettingWirelessSecurity object is a NMSetting subclass that describes -properties necessary for connection to encrypted Wi-Fi networks. -

-

-It's a good idea to read up on wpa_supplicant configuration before using this -setting extensively, since most of the options here correspond closely with -the relevant wpa_supplicant configuration options. To get a better overview -of how Wi-Fi security works, you may want to get copies of the following books. -

-

- 802.11 Wireless Networks: The Definitive Guide, Second Edition - Author: Matthew Gast - ISBN: 978-0596100520 -

-

- Cisco Wireless LAN Security - Authors: Krishna Sankar, Sri Sundaralingam, Darrin Miller, and Andrew Balinsky - ISBN: 978-1587051548 -

-
-

Details

-
-

NM_SETTING_WIRELESS_SECURITY_SETTING_NAME

-
#define NM_SETTING_WIRELESS_SECURITY_SETTING_NAME "802-11-wireless-security"
-
-

-

-
-
-
-

enum NMWepKeyType

-
typedef enum {
-	NM_WEP_KEY_TYPE_UNKNOWN = 0,
-	NM_WEP_KEY_TYPE_KEY = 1,          /* Hex or ASCII */
-	NM_WEP_KEY_TYPE_PASSPHRASE = 2,   /* 104/128-bit Passphrase */
-
-	NM_WEP_KEY_TYPE_LAST = NM_WEP_KEY_TYPE_PASSPHRASE
-} NMWepKeyType;
-
-

-The NMWepKeyType values specify how any WEP keys present in the setting -are intepreted. There are no standards governing how to hash the various WEP -key/passphrase formats into the actual WEP key. Unfortunately some WEP keys -can be interpreted in multiple ways, requring the setting to specify how to -interpret the any WEP keys. For example, the key "732f2d712e4a394a375d366931" -is both a valid Hexadecimal WEP key and a WEP passphrase. Further, many -ASCII keys are also valid WEP passphrases, but since passphrases and ASCII -keys are hashed differently to determine the actual WEP key the type must be -specified. -

-
+

Functions

+
--++ - - + - - + - - + - - + - -

NM_WEP_KEY_TYPE_UNKNOWN

unknown WEP key type + +NMSetting * + +nm_setting_wireless_security_new ()

NM_WEP_KEY_TYPE_KEY

indicates a hexadecimal or ASCII formatted WEP key. -Hex keys are either 10 or 26 hexadecimal characters (ie "5f782f2f5f" or -"732f2d712e4a394a375d366931"), while ASCII keys are either 5 or 13 ASCII -characters (ie "abcde" or "blahblah99$*1"). +const char * + +nm_setting_wireless_security_get_key_mgmt ()

NM_WEP_KEY_TYPE_PASSPHRASE

indicates a WEP passphrase (ex "I bought a duck -on my way back from the market 235Q&^%^*%") instead of a hexadecimal or ASCII -key. Passphrases are between 8 and 64 characters inclusive and are hashed -the actual WEP key using the MD5 hash algorithm. + +guint32 + +nm_setting_wireless_security_get_num_protos ()

NM_WEP_KEY_TYPE_LAST

placeholder value for bounds-checking +const char * + +nm_setting_wireless_security_get_proto ()
-
-
-
-

NM_SETTING_WIRELESS_SECURITY_KEY_MGMT

-
#define NM_SETTING_WIRELESS_SECURITY_KEY_MGMT "key-mgmt"
-
-

-

-
-
-
-

NM_SETTING_WIRELESS_SECURITY_WEP_TX_KEYIDX

-
#define NM_SETTING_WIRELESS_SECURITY_WEP_TX_KEYIDX "wep-tx-keyidx"
-
-

-

-
-
-
-

NM_SETTING_WIRELESS_SECURITY_AUTH_ALG

-
#define NM_SETTING_WIRELESS_SECURITY_AUTH_ALG "auth-alg"
-
-

-

-
-
-
-

NM_SETTING_WIRELESS_SECURITY_PROTO

-
#define NM_SETTING_WIRELESS_SECURITY_PROTO "proto"
-
-

-

-
-
-
-

NM_SETTING_WIRELESS_SECURITY_PAIRWISE

-
#define NM_SETTING_WIRELESS_SECURITY_PAIRWISE "pairwise"
-
-

-

-
-
-
-

NM_SETTING_WIRELESS_SECURITY_GROUP

-
#define NM_SETTING_WIRELESS_SECURITY_GROUP "group"
-
-

-

-
-
-
-

NM_SETTING_WIRELESS_SECURITY_LEAP_USERNAME

-
#define NM_SETTING_WIRELESS_SECURITY_LEAP_USERNAME "leap-username"
-
-

-

-
-
-
-

NM_SETTING_WIRELESS_SECURITY_WEP_KEY0

-
#define NM_SETTING_WIRELESS_SECURITY_WEP_KEY0 "wep-key0"
-
-

-

-
-
-
-

NM_SETTING_WIRELESS_SECURITY_WEP_KEY1

-
#define NM_SETTING_WIRELESS_SECURITY_WEP_KEY1 "wep-key1"
-
-

-

-
-
-
-

NM_SETTING_WIRELESS_SECURITY_WEP_KEY2

-
#define NM_SETTING_WIRELESS_SECURITY_WEP_KEY2 "wep-key2"
-
-

-

-
-
-
-

NM_SETTING_WIRELESS_SECURITY_WEP_KEY3

-
#define NM_SETTING_WIRELESS_SECURITY_WEP_KEY3 "wep-key3"
-
-

-

-
-
-
-

NM_SETTING_WIRELESS_SECURITY_WEP_KEY_FLAGS

-
#define NM_SETTING_WIRELESS_SECURITY_WEP_KEY_FLAGS "wep-key-flags"
-
-

-

-
-
-
-

NM_SETTING_WIRELESS_SECURITY_WEP_KEY_TYPE

-
#define NM_SETTING_WIRELESS_SECURITY_WEP_KEY_TYPE "wep-key-type"
-
-

-

-
-
-
-

NM_SETTING_WIRELESS_SECURITY_PSK

-
#define NM_SETTING_WIRELESS_SECURITY_PSK "psk"
-
-

-

-
-
-
-

NM_SETTING_WIRELESS_SECURITY_PSK_FLAGS

-
#define NM_SETTING_WIRELESS_SECURITY_PSK_FLAGS "psk-flags"
-
-

-

-
-
-
-

NM_SETTING_WIRELESS_SECURITY_LEAP_PASSWORD

-
#define NM_SETTING_WIRELESS_SECURITY_LEAP_PASSWORD "leap-password"
-
-

-

-
-
-
-

NM_SETTING_WIRELESS_SECURITY_LEAP_PASSWORD_FLAGS

-
#define NM_SETTING_WIRELESS_SECURITY_LEAP_PASSWORD_FLAGS "leap-password-flags"
-
-

-

-
-
-
-

struct NMSettingWirelessSecurity

-
struct NMSettingWirelessSecurity;
-

-

-
-
-
-

NMSettingWirelessSecurityClass

-
typedef struct {
-	NMSettingClass parent;
-} NMSettingWirelessSecurityClass;
-
-

-

-
-
-
-

nm_setting_wireless_security_new ()

-
NMSetting *         nm_setting_wireless_security_new    (void);
-

-Creates a new NMSettingWirelessSecurity object with default values. -

-
---- - - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - + + + + + + + + + + + + + + + + + + +

Returns :

the new empty NMSettingWirelessSecurity object. [transfer full] +
+gboolean + +nm_setting_wireless_security_add_proto () +
+void + +nm_setting_wireless_security_remove_proto () +
+gboolean + +nm_setting_wireless_security_remove_proto_by_value () +
+void + +nm_setting_wireless_security_clear_protos () +
+guint32 + +nm_setting_wireless_security_get_num_pairwise () +
const char * + +nm_setting_wireless_security_get_pairwise () +
+gboolean + +nm_setting_wireless_security_add_pairwise () +
+void + +nm_setting_wireless_security_remove_pairwise () +
+gboolean + +nm_setting_wireless_security_remove_pairwise_by_value () +
+void + +nm_setting_wireless_security_clear_pairwise () +
+guint32 + +nm_setting_wireless_security_get_num_groups () +
const char * + +nm_setting_wireless_security_get_group () +
+gboolean + +nm_setting_wireless_security_add_group () +
+void + +nm_setting_wireless_security_remove_group () +
+gboolean + +nm_setting_wireless_security_remove_group_by_value () +
+void + +nm_setting_wireless_security_clear_groups () +
const char * + +nm_setting_wireless_security_get_psk () +
+NMSettingSecretFlags + +nm_setting_wireless_security_get_psk_flags () +
const char * + +nm_setting_wireless_security_get_leap_username () +
const char * + +nm_setting_wireless_security_get_leap_password () +
+NMSettingSecretFlags + +nm_setting_wireless_security_get_leap_password_flags () +
const char * + +nm_setting_wireless_security_get_wep_key () +
+void
+nm_setting_wireless_security_set_wep_key () +
+guint32 + +nm_setting_wireless_security_get_wep_tx_keyidx () +
const char * + +nm_setting_wireless_security_get_auth_alg () +
+NMSettingSecretFlags + +nm_setting_wireless_security_get_wep_key_flags () +
+NMWepKeyType + +nm_setting_wireless_security_get_wep_key_type () +
-
-
-

nm_setting_wireless_security_get_key_mgmt ()

-
const char *        nm_setting_wireless_security_get_key_mgmt
-                                                        (NMSettingWirelessSecurity *setting);
-
+
+

Properties

+
--+++ - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - - + + +

setting :

the NMSettingWirelessSecurity - +gchar *auth-algRead / Write
GStrvgroupRead / Write
+gchar *key-mgmtRead / Write
+gchar *leap-passwordRead / Write
NMSettingSecretFlagsleap-password-flagsRead / Write
+gchar *leap-usernameRead / Write
GStrvpairwiseRead / Write
GStrvprotoRead / Write
+gchar *pskRead / Write
NMSettingSecretFlagspsk-flagsRead / Write
NMSettingSecretFlagswep-key-flagsRead / Write
NMWepKeyTypewep-key-typeRead / Write / Construct
+gchar *wep-key0Read / Write
+gchar *wep-key1Read / Write
+gchar *wep-key2Read / Write
+gchar *wep-key3Read / Write

Returns :

the "key-mgmt" property of the settingguintwep-tx-keyidxRead / Write / Construct
-
-
-

nm_setting_wireless_security_get_num_protos ()

-
guint32             nm_setting_wireless_security_get_num_protos
-                                                        (NMSettingWirelessSecurity *setting);
-
+
+

Object Hierarchy

+
    GEnum
+    ╰── NMWepKeyType
+    GObject
+    ╰── NMSetting
+        ╰── NMSettingWirelessSecurity
+
+
+
+

Description

+

The NMSettingWirelessSecurity object is a NMSetting subclass that describes +properties necessary for connection to encrypted Wi-Fi networks.

+

It's a good idea to read up on wpa_supplicant configuration before using this +setting extensively, since most of the options here correspond closely with +the relevant wpa_supplicant configuration options. To get a better overview +of how Wi-Fi security works, you may want to get copies of the following books.

+

802.11 Wireless Networks: The Definitive Guide, Second Edition + Author: Matthew Gast + ISBN: 978-0596100520

+

Cisco Wireless LAN Security + Authors: Krishna Sankar, Sri Sundaralingam, Darrin Miller, and Andrew Balinsky + ISBN: 978-1587051548

+
+
+

Functions

+
+

nm_setting_wireless_security_new ()

+
NMSetting *
+nm_setting_wireless_security_new (void);
+

Creates a new NMSettingWirelessSecurity object with default values.

+
+

Returns

+

the new empty NMSettingWirelessSecurity object.

+

[transfer full]

+
+
+
+
+

nm_setting_wireless_security_get_key_mgmt ()

+
const char *
+nm_setting_wireless_security_get_key_mgmt
+                               (NMSettingWirelessSecurity *setting);
+
+

Parameters

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

setting

the NMSettingWirelessSecurity

 
+
+
+

Returns

+

the “key-mgmt” property of the setting

+

+
+
+
+
+

nm_setting_wireless_security_get_num_protos ()

+
guint32
+nm_setting_wireless_security_get_num_protos
+                               (NMSettingWirelessSecurity *setting);
+
+

Parameters

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

setting

the NMSettingWirelessSecurity

 
+
+
+

Returns

+

the number of security protocols this connection allows when +connecting to secure Wi-Fi networks

+

+
+

-

nm_setting_wireless_security_get_proto ()

-
const char *        nm_setting_wireless_security_get_proto
-                                                        (NMSettingWirelessSecurity *setting,
-                                                         guint32 i);
-
+

nm_setting_wireless_security_get_proto ()

+
const char *
+nm_setting_wireless_security_get_proto
+                               (NMSettingWirelessSecurity *setting,
+                                guint32 i);
+
+

Parameters

+
--+++ - - - - - - + + + - - + + +

setting :

the NMSettingWirelessSecurity -

i :

an index into the protocol list

setting

the NMSettingWirelessSecurity

 

Returns :

the protocol at index i -

i

an index into the protocol list

 
+
+

Returns

+

the protocol at index i +

+

+
+

-

nm_setting_wireless_security_add_proto ()

-
gboolean            nm_setting_wireless_security_add_proto
-                                                        (NMSettingWirelessSecurity *setting,
-                                                         const char *proto);
-

-Adds a Wi-Fi security protocol (one of "wpa" or "rsn") to the allowed list; +

nm_setting_wireless_security_add_proto ()

+
gboolean
+nm_setting_wireless_security_add_proto
+                               (NMSettingWirelessSecurity *setting,
+                                const char *proto);
+

Adds a Wi-Fi security protocol (one of "wpa" or "rsn") to the allowed list; only protocols in this list will be used when finding and connecting to the Wi-Fi network specified by this connection. For example, if the protocol list contains only "wpa" but the access point for the SSID specified by this connection only supports WPA2/RSN, the connection cannot be used -with the access point. -

-
+with the access point.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + +

setting :

the NMSettingWirelessSecurity -

proto :

the protocol to add, one of "wpa" or "rsn"

setting

the NMSettingWirelessSecurity

 

Returns :

-TRUE if the protocol was new and and was added to the allowed -protocol list, or FALSE if it was already in the list

proto

the protocol to add, one of "wpa" or "rsn"

 
+
+

Returns

+

TRUE if the protocol was new and and was added to the allowed +protocol list, or FALSE if it was already in the list

+

+
+

-

nm_setting_wireless_security_remove_proto ()

-
void                nm_setting_wireless_security_remove_proto
-                                                        (NMSettingWirelessSecurity *setting,
-                                                         guint32 i);
-

-Removes a protocol from the allowed protocol list. -

-
+

nm_setting_wireless_security_remove_proto ()

+
void
+nm_setting_wireless_security_remove_proto
+                               (NMSettingWirelessSecurity *setting,
+                                guint32 i);
+

Removes a protocol from the allowed protocol list.

+
+

Parameters

+
--+++ - - + + + - - + + +

setting :

the NMSettingWirelessSecurity -

setting

the NMSettingWirelessSecurity

 

i :

index of the protocol to remove

i

index of the protocol to remove

 
+

-

nm_setting_wireless_security_remove_proto_by_value ()

-
gboolean            nm_setting_wireless_security_remove_proto_by_value
-                                                        (NMSettingWirelessSecurity *setting,
-                                                         const char *proto);
-

-Removes a protocol from the allowed protocol list. -

-
+

nm_setting_wireless_security_remove_proto_by_value ()

+
gboolean
+nm_setting_wireless_security_remove_proto_by_value
+                               (NMSettingWirelessSecurity *setting,
+                                const char *proto);
+

Removes a protocol from the allowed protocol list.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + +

setting :

the NMSettingWirelessSecurity -

proto :

the protocol to remove, one of "wpa" or "rsn"

setting

the NMSettingWirelessSecurity

 

Returns :

-TRUE if the protocol was found and removed; FALSE it it was not.

proto

the protocol to remove, one of "wpa" or "rsn"

 
+
+

Returns

+

TRUE if the protocol was found and removed; FALSE it it was not.

+

+
+
-

nm_setting_wireless_security_clear_protos ()

-
void                nm_setting_wireless_security_clear_protos
-                                                        (NMSettingWirelessSecurity *setting);
-

-Removes all protocols from the allowed list. If there are no protocols -specified then all protocols are allowed. -

-
+

nm_setting_wireless_security_clear_protos ()

+
void
+nm_setting_wireless_security_clear_protos
+                               (NMSettingWirelessSecurity *setting);
+

Removes all protocols from the allowed list. If there are no protocols +specified then all protocols are allowed.

+
+

Parameters

+
--+++ - - + + +

setting :

the NMSettingWirelessSecurity -

setting

the NMSettingWirelessSecurity

 
+
-

nm_setting_wireless_security_get_num_pairwise ()

-
guint32             nm_setting_wireless_security_get_num_pairwise
-                                                        (NMSettingWirelessSecurity *setting);
-
+

nm_setting_wireless_security_get_num_pairwise ()

+
guint32
+nm_setting_wireless_security_get_num_pairwise
+                               (NMSettingWirelessSecurity *setting);
+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSettingWirelessSecurity -

Returns :

the number of pairwise encryption algorithms in the allowed list

setting

the NMSettingWirelessSecurity

 
+
+

Returns

+

the number of pairwise encryption algorithms in the allowed list

+

+
+
-

nm_setting_wireless_security_get_pairwise ()

-
const char *        nm_setting_wireless_security_get_pairwise
-                                                        (NMSettingWirelessSecurity *setting,
-                                                         guint32 i);
-

-Returns the allowed pairwise encryption algorithm from allowed algorithm -list. -

-
+

nm_setting_wireless_security_get_pairwise ()

+
const char *
+nm_setting_wireless_security_get_pairwise
+                               (NMSettingWirelessSecurity *setting,
+                                guint32 i);
+

Returns the allowed pairwise encryption algorithm from allowed algorithm +list.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + +

setting :

the NMSettingWirelessSecurity -

i :

index of an item in the allowed pairwise encryption algorithm list

setting

the NMSettingWirelessSecurity

 

Returns :

the pairwise encryption algorithm at index i -

i

index of an item in the allowed pairwise encryption algorithm list

 
+
+

Returns

+

the pairwise encryption algorithm at index i +

+

+
+
-

nm_setting_wireless_security_add_pairwise ()

-
gboolean            nm_setting_wireless_security_add_pairwise
-                                                        (NMSettingWirelessSecurity *setting,
-                                                         const char *pairwise);
-

-Adds an encryption algorithm to the list of allowed pairwise encryption +

nm_setting_wireless_security_add_pairwise ()

+
gboolean
+nm_setting_wireless_security_add_pairwise
+                               (NMSettingWirelessSecurity *setting,
+                                const char *pairwise);
+

Adds an encryption algorithm to the list of allowed pairwise encryption algorithms. If the list is not empty, then only access points that support one or more of the encryption algorithms in the list will be considered -compatible with this connection. -

-
+compatible with this connection.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + +

setting :

the NMSettingWirelessSecurity -

pairwise :

the encryption algorithm to add, one of "tkip" or "ccmp"

setting

the NMSettingWirelessSecurity

 

Returns :

-TRUE if the algorithm was added to the list, FALSE if it was -already in the list

pairwise

the encryption algorithm to add, one of "tkip" or "ccmp"

 
+
+

Returns

+

TRUE if the algorithm was added to the list, FALSE if it was +already in the list

+

+
+
-

nm_setting_wireless_security_remove_pairwise ()

-
void                nm_setting_wireless_security_remove_pairwise
-                                                        (NMSettingWirelessSecurity *setting,
-                                                         guint32 i);
-

-Removes an encryption algorithm from the allowed pairwise encryption -algorithm list. -

-
+

nm_setting_wireless_security_remove_pairwise ()

+
void
+nm_setting_wireless_security_remove_pairwise
+                               (NMSettingWirelessSecurity *setting,
+                                guint32 i);
+

Removes an encryption algorithm from the allowed pairwise encryption +algorithm list.

+
+

Parameters

+
--+++ - - + + + - - + + +

setting :

the NMSettingWirelessSecurity -

setting

the NMSettingWirelessSecurity

 

i :

the index of an item in the allowed pairwise encryption algorithm list

i

the index of an item in the allowed pairwise encryption algorithm list

 
+
-

nm_setting_wireless_security_remove_pairwise_by_value ()

-
gboolean            nm_setting_wireless_security_remove_pairwise_by_value
-                                                        (NMSettingWirelessSecurity *setting,
-                                                         const char *pairwise);
-

-Removes an encryption algorithm from the allowed pairwise encryption -algorithm list. -

-
+

nm_setting_wireless_security_remove_pairwise_by_value ()

+
gboolean
+nm_setting_wireless_security_remove_pairwise_by_value
+                               (NMSettingWirelessSecurity *setting,
+                                const char *pairwise);
+

Removes an encryption algorithm from the allowed pairwise encryption +algorithm list.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + +

setting :

the NMSettingWirelessSecurity -

pairwise :

the encryption algorithm to remove, one of "tkip" or "ccmp"

setting

the NMSettingWirelessSecurity

 

Returns :

-TRUE if the encryption algorith was found and removed; FALSE it it was not.

pairwise

the encryption algorithm to remove, one of "tkip" or "ccmp"

 
+
+

Returns

+

TRUE if the encryption algorith was found and removed; FALSE it it was not.

+

+
+
-

nm_setting_wireless_security_clear_pairwise ()

-
void                nm_setting_wireless_security_clear_pairwise
-                                                        (NMSettingWirelessSecurity *setting);
-

-Removes all algorithms from the allowed list. If there are no algorithms -specified then all pairwise encryption algorithms are allowed. -

-
+

nm_setting_wireless_security_clear_pairwise ()

+
void
+nm_setting_wireless_security_clear_pairwise
+                               (NMSettingWirelessSecurity *setting);
+

Removes all algorithms from the allowed list. If there are no algorithms +specified then all pairwise encryption algorithms are allowed.

+
+

Parameters

+
--+++ - - + + +

setting :

the NMSettingWirelessSecurity -

setting

the NMSettingWirelessSecurity

 
+
-

nm_setting_wireless_security_get_num_groups ()

-
guint32             nm_setting_wireless_security_get_num_groups
-                                                        (NMSettingWirelessSecurity *setting);
-
+

nm_setting_wireless_security_get_num_groups ()

+
guint32
+nm_setting_wireless_security_get_num_groups
+                               (NMSettingWirelessSecurity *setting);
+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSettingWirelessSecurity -

Returns :

the number of groupwise encryption algorithms in the allowed list

setting

the NMSettingWirelessSecurity

 
+
+

Returns

+

the number of groupwise encryption algorithms in the allowed list

+

+
+
-

nm_setting_wireless_security_get_group ()

-
const char *        nm_setting_wireless_security_get_group
-                                                        (NMSettingWirelessSecurity *setting,
-                                                         guint32 i);
-

-Returns the allowed groupwise encryption algorithm from allowed algorithm -list. -

-
+

nm_setting_wireless_security_get_group ()

+
const char *
+nm_setting_wireless_security_get_group
+                               (NMSettingWirelessSecurity *setting,
+                                guint32 i);
+

Returns the allowed groupwise encryption algorithm from allowed algorithm +list.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + +

setting :

the NMSettingWirelessSecurity -

i :

index of an item in the allowed groupwise encryption algorithm list

setting

the NMSettingWirelessSecurity

 

Returns :

the groupwise encryption algorithm at index i -

i

index of an item in the allowed groupwise encryption algorithm list

 
+
+

Returns

+

the groupwise encryption algorithm at index i +

+

+
+
-

nm_setting_wireless_security_add_group ()

-
gboolean            nm_setting_wireless_security_add_group
-                                                        (NMSettingWirelessSecurity *setting,
-                                                         const char *group);
-

-Adds an encryption algorithm to the list of allowed groupwise encryption +

nm_setting_wireless_security_add_group ()

+
gboolean
+nm_setting_wireless_security_add_group
+                               (NMSettingWirelessSecurity *setting,
+                                const char *group);
+

Adds an encryption algorithm to the list of allowed groupwise encryption algorithms. If the list is not empty, then only access points that support one or more of the encryption algorithms in the list will be considered -compatible with this connection. -

-
+compatible with this connection.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + +

setting :

the NMSettingWirelessSecurity -

group :

the encryption algorithm to add, one of "wep40", "wep104", -"tkip", or "ccmp"

setting

the NMSettingWirelessSecurity

 

Returns :

-TRUE if the algorithm was added to the list, FALSE if it was -already in the list

group

the encryption algorithm to add, one of "wep40", "wep104", +"tkip", or "ccmp"

 
+
+

Returns

+

TRUE if the algorithm was added to the list, FALSE if it was +already in the list

+

+
+
-

nm_setting_wireless_security_remove_group ()

-
void                nm_setting_wireless_security_remove_group
-                                                        (NMSettingWirelessSecurity *setting,
-                                                         guint32 i);
-

-Removes an encryption algorithm from the allowed groupwise encryption -algorithm list. -

-
+

nm_setting_wireless_security_remove_group ()

+
void
+nm_setting_wireless_security_remove_group
+                               (NMSettingWirelessSecurity *setting,
+                                guint32 i);
+

Removes an encryption algorithm from the allowed groupwise encryption +algorithm list.

+
+

Parameters

+
--+++ - - + + + - - + + +

setting :

the NMSettingWirelessSecurity -

setting

the NMSettingWirelessSecurity

 

i :

the index of an item in the allowed groupwise encryption algorithm list

i

the index of an item in the allowed groupwise encryption algorithm list

 
+
-

nm_setting_wireless_security_remove_group_by_value ()

-
gboolean            nm_setting_wireless_security_remove_group_by_value
-                                                        (NMSettingWirelessSecurity *setting,
-                                                         const char *group);
-

-Removes an encryption algorithm from the allowed groupwise encryption -algorithm list. -

-
+

nm_setting_wireless_security_remove_group_by_value ()

+
gboolean
+nm_setting_wireless_security_remove_group_by_value
+                               (NMSettingWirelessSecurity *setting,
+                                const char *group);
+

Removes an encryption algorithm from the allowed groupwise encryption +algorithm list.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + +

setting :

the NMSettingWirelessSecurity -

group :

the encryption algorithm to remove, one of "wep40", "wep104", -"tkip", or "ccmp"

setting

the NMSettingWirelessSecurity

 

Returns :

-TRUE if the algorithm was found and removed; FALSE it it was not.

group

the encryption algorithm to remove, one of "wep40", "wep104", +"tkip", or "ccmp"

 
+
+

Returns

+

TRUE if the algorithm was found and removed; FALSE it it was not.

+

+
+ +
+
+

nm_setting_wireless_security_clear_groups ()

+
void
+nm_setting_wireless_security_clear_groups
+                               (NMSettingWirelessSecurity *setting);
+

Removes all algorithms from the allowed list. If there are no algorithms +specified then all groupwise encryption algorithms are allowed.

+
+

Parameters

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

setting

the NMSettingWirelessSecurity

 
+
+
+
+
+

nm_setting_wireless_security_get_psk ()

+
const char *
+nm_setting_wireless_security_get_psk (NMSettingWirelessSecurity *setting);
+
+

Parameters

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

setting

the NMSettingWirelessSecurity

 
+
+
+

Returns

+

the “psk” property of the setting

+

+
+

-

nm_setting_wireless_security_clear_groups ()

-
void                nm_setting_wireless_security_clear_groups
-                                                        (NMSettingWirelessSecurity *setting);
-

-Removes all algorithms from the allowed list. If there are no algorithms -specified then all groupwise encryption algorithms are allowed. -

-
+

nm_setting_wireless_security_get_psk_flags ()

+
NMSettingSecretFlags
+nm_setting_wireless_security_get_psk_flags
+                               (NMSettingWirelessSecurity *setting);
+
+

Parameters

+
--+++ - - + + +

setting :

the NMSettingWirelessSecurity -

setting

the NMSettingWirelessSecurity

 
+
+

Returns

+

the NMSettingSecretFlags pertaining to the +“psk”

+

+
+
-

nm_setting_wireless_security_get_psk ()

-
const char *        nm_setting_wireless_security_get_psk
-                                                        (NMSettingWirelessSecurity *setting);
-
+

nm_setting_wireless_security_get_leap_username ()

+
const char *
+nm_setting_wireless_security_get_leap_username
+                               (NMSettingWirelessSecurity *setting);
+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSettingWirelessSecurity -

Returns :

the "psk" property of the setting

setting

the NMSettingWirelessSecurity

 
+
+

Returns

+

the “leap-username” property of the setting

+

+
+
-

nm_setting_wireless_security_get_psk_flags ()

-
NMSettingSecretFlags nm_setting_wireless_security_get_psk_flags
-                                                        (NMSettingWirelessSecurity *setting);
-
+

nm_setting_wireless_security_get_leap_password ()

+
const char *
+nm_setting_wireless_security_get_leap_password
+                               (NMSettingWirelessSecurity *setting);
+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSettingWirelessSecurity -

Returns :

the NMSettingSecretFlags pertaining to the -"psk" -

setting

the NMSettingWirelessSecurity

 
+
+

Returns

+

the “leap-password” property of the setting

+

+
+
-

nm_setting_wireless_security_get_leap_username ()

-
const char *        nm_setting_wireless_security_get_leap_username
-                                                        (NMSettingWirelessSecurity *setting);
-
+

nm_setting_wireless_security_get_leap_password_flags ()

+
NMSettingSecretFlags
+nm_setting_wireless_security_get_leap_password_flags
+                               (NMSettingWirelessSecurity *setting);
+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSettingWirelessSecurity -

Returns :

the "leap-username" property of the setting

setting

the NMSettingWirelessSecurity

 
+
+

Returns

+

the NMSettingSecretFlags pertaining to the +“leap-password”

+

+
+
-

nm_setting_wireless_security_get_leap_password ()

-
const char *        nm_setting_wireless_security_get_leap_password
-                                                        (NMSettingWirelessSecurity *setting);
-
+

nm_setting_wireless_security_get_wep_key ()

+
const char *
+nm_setting_wireless_security_get_wep_key
+                               (NMSettingWirelessSecurity *setting,
+                                guint32 idx);
+
+

Parameters

+
--+++ - - + + + - - + + +

setting :

the NMSettingWirelessSecurity -

setting

the NMSettingWirelessSecurity

 

Returns :

the "leap-password" property of the setting

idx

the WEP key index (0..3 inclusive)

 
+
+

Returns

+

the WEP key at the given index

+

+
+
-

nm_setting_wireless_security_get_leap_password_flags ()

-
NMSettingSecretFlags nm_setting_wireless_security_get_leap_password_flags
-                                                        (NMSettingWirelessSecurity *setting);
-
+

nm_setting_wireless_security_set_wep_key ()

+
void
+nm_setting_wireless_security_set_wep_key
+                               (NMSettingWirelessSecurity *setting,
+                                guint32 idx,
+                                const char *key);
+

Sets a WEP key in the given index.

+
+

Parameters

+
--+++ - - + + + - - + + + + + + + +

setting :

the NMSettingWirelessSecurity -

setting

the NMSettingWirelessSecurity

 

Returns :

the NMSettingSecretFlags pertaining to the -"leap-password" -

idx

the index of the key (0..3 inclusive)

 

key

the WEP key as a string, in either hexadecimal, ASCII, or passphrase +form as determiend by the value of the “wep-key-type” +property.

 
+
-

nm_setting_wireless_security_get_wep_key ()

-
const char *        nm_setting_wireless_security_get_wep_key
-                                                        (NMSettingWirelessSecurity *setting,
-                                                         guint32 idx);
-
+

nm_setting_wireless_security_get_wep_tx_keyidx ()

+
guint32
+nm_setting_wireless_security_get_wep_tx_keyidx
+                               (NMSettingWirelessSecurity *setting);
+
+

Parameters

+
--+++ - - - - - - - - - - - - - - + + + + +

setting :

the NMSettingWirelessSecurity -

idx :

the WEP key index (0..3 inclusive)

Returns :

the WEP key at the given index

setting

the NMSettingWirelessSecurity

 
+
+

Returns

+

the “wep-tx-keyidx” property of the setting

+

+
+
-

nm_setting_wireless_security_set_wep_key ()

-
void                nm_setting_wireless_security_set_wep_key
-                                                        (NMSettingWirelessSecurity *setting,
-                                                         guint32 idx,
-                                                         const char *key);
-

-Sets a WEP key in the given index. -

-
+

nm_setting_wireless_security_get_auth_alg ()

+
const char *
+nm_setting_wireless_security_get_auth_alg
+                               (NMSettingWirelessSecurity *setting);
+
+

Parameters

+
--+++ - - - - - - - - - - - - - - + + + + +

setting :

the NMSettingWirelessSecurity -

idx :

the index of the key (0..3 inclusive)

key :

the WEP key as a string, in either hexadecimal, ASCII, or passphrase -form as determiend by the value of the "wep-key-type" -property.

setting

the NMSettingWirelessSecurity

 
+
+

Returns

+

the “auth-alg” property of the setting

+

+
+
-

nm_setting_wireless_security_get_wep_tx_keyidx ()

-
guint32             nm_setting_wireless_security_get_wep_tx_keyidx
-                                                        (NMSettingWirelessSecurity *setting);
-
+

nm_setting_wireless_security_get_wep_key_flags ()

+
NMSettingSecretFlags
+nm_setting_wireless_security_get_wep_key_flags
+                               (NMSettingWirelessSecurity *setting);
+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSettingWirelessSecurity -

Returns :

the "wep-tx-keyidx" property of the setting

setting

the NMSettingWirelessSecurity

 
+
+

Returns

+

the NMSettingSecretFlags pertaining to the all WEP keys

+

+
+
-

nm_setting_wireless_security_get_auth_alg ()

-
const char *        nm_setting_wireless_security_get_auth_alg
-                                                        (NMSettingWirelessSecurity *setting);
-
+

nm_setting_wireless_security_get_wep_key_type ()

+
NMWepKeyType
+nm_setting_wireless_security_get_wep_key_type
+                               (NMSettingWirelessSecurity *setting);
+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

setting :

the NMSettingWirelessSecurity -

Returns :

the "auth-alg" property of the setting

setting

the NMSettingWirelessSecurity

 
+
+

Returns

+

the “wep-key-type” property of the setting

+

+
+ + +
+

Types and Values

+
+

NM_SETTING_WIRELESS_SECURITY_SETTING_NAME

+
#define NM_SETTING_WIRELESS_SECURITY_SETTING_NAME "802-11-wireless-security"
+
+

+

+

-

nm_setting_wireless_security_get_wep_key_flags ()

-
NMSettingSecretFlags nm_setting_wireless_security_get_wep_key_flags
-                                                        (NMSettingWirelessSecurity *setting);
-
+

enum NMWepKeyType

+

The NMWepKeyType values specify how any WEP keys present in the setting +are intepreted. There are no standards governing how to hash the various WEP +key/passphrase formats into the actual WEP key. Unfortunately some WEP keys +can be interpreted in multiple ways, requring the setting to specify how to +interpret the any WEP keys. For example, the key "732f2d712e4a394a375d366931" +is both a valid Hexadecimal WEP key and a WEP passphrase. Further, many +ASCII keys are also valid WEP passphrases, but since passphrases and ASCII +keys are hashed differently to determine the actual WEP key the type must be +specified.

+
+

Members

+
--+++ - - + + - - + + + - -

setting :

the NMSettingWirelessSecurity +

NM_WEP_KEY_TYPE_UNKNOWN

+

unknown WEP key type

 

Returns :

the NMSettingSecretFlags pertaining to the all WEP keys

NM_WEP_KEY_TYPE_KEY

+

indicates a hexadecimal or ASCII formatted WEP key. +Hex keys are either 10 or 26 hexadecimal characters (ie "5f782f2f5f" or +"732f2d712e4a394a375d366931"), while ASCII keys are either 5 or 13 ASCII +characters (ie "abcde" or "blahblah99$*1").

+
 
-
-
-
-

nm_setting_wireless_security_get_wep_key_type ()

-
NMWepKeyType        nm_setting_wireless_security_get_wep_key_type
-                                                        (NMSettingWirelessSecurity *setting);
-
---- - - - + + - - + + +

setting :

the NMSettingWirelessSecurity +

NM_WEP_KEY_TYPE_PASSPHRASE

+

indicates a WEP passphrase (ex "I bought a duck +on my way back from the market 235Q&^%^*%") instead of a hexadecimal or ASCII +key. Passphrases are between 8 and 64 characters inclusive and are hashed +the actual WEP key using the MD5 hash algorithm.

 

Returns :

the "wep-key-type" property of the setting

NM_WEP_KEY_TYPE_LAST

+

placeholder value for bounds-checking

+
 
-
-

Property Details

+
-

The "auth-alg" property

-
  "auth-alg"                 gchar*                : Read / Write
+

NM_SETTING_WIRELESS_SECURITY_KEY_MGMT

+
#define NM_SETTING_WIRELESS_SECURITY_KEY_MGMT "key-mgmt"
+

-When WEP is used (ie, key-mgmt = "none" or "ieee8021x") indicate the -802.11 authentication algorithm required by the AP here. One of "open" -for Open System, "shared" for Shared Key, or "leap" for Cisco LEAP. When -using Cisco LEAP (ie, key-mgmt = "ieee8021x" and auth-alg = "leap") the -"leap-username" and "leap-password" properties must be specified.

-

Default value: NULL


-

The "group" property

-
  "group"                    GStrv                 : Read / Write
+

NM_SETTING_WIRELESS_SECURITY_WEP_TX_KEYIDX

+
#define NM_SETTING_WIRELESS_SECURITY_WEP_TX_KEYIDX "wep-tx-keyidx"
+

-A list of group/broadcast encryption algorithms which prevents -connections to Wi-Fi networks that do not utilize one of the algorithms -in the list. For maximum compatibility leave this property empty. Each -list element may be one of "wep40", "wep104", "tkip", or "ccmp".


-

The "key-mgmt" property

-
  "key-mgmt"                 gchar*                : Read / Write
+

NM_SETTING_WIRELESS_SECURITY_AUTH_ALG

+
#define NM_SETTING_WIRELESS_SECURITY_AUTH_ALG "auth-alg"
+

-Key management used for the connection. One of "none" (WEP), "ieee8021x" -(Dynamic WEP), "wpa-none" (Ad-Hoc WPA-PSK), "wpa-psk" (infrastructure -WPA-PSK), or "wpa-eap" (WPA-Enterprise). This property must be set for -any Wi-Fi connection that uses security.

-

Default value: NULL


-

The "leap-password" property

-
  "leap-password"            gchar*                : Read / Write
+

NM_SETTING_WIRELESS_SECURITY_PROTO

+
#define NM_SETTING_WIRELESS_SECURITY_PROTO "proto"
+

-The login password for legacy LEAP connections (ie, key-mgmt = -"ieee8021x" and auth-alg = "leap").

-

Default value: NULL


-

The "leap-password-flags" property

-
  "leap-password-flags"      NMSettingSecretFlags  : Read / Write
+

NM_SETTING_WIRELESS_SECURITY_PAIRWISE

+
#define NM_SETTING_WIRELESS_SECURITY_PAIRWISE "pairwise"
+

-Flags indicating how to handle the -"leap-password" property.


-

The "leap-username" property

-
  "leap-username"            gchar*                : Read / Write
+

NM_SETTING_WIRELESS_SECURITY_GROUP

+
#define NM_SETTING_WIRELESS_SECURITY_GROUP "group"
+

-The login username for legacy LEAP connections (ie, key-mgmt = -"ieee8021x" and auth-alg = "leap").

-

Default value: NULL


-

The "pairwise" property

-
  "pairwise"                 GStrv                 : Read / Write
+

NM_SETTING_WIRELESS_SECURITY_LEAP_USERNAME

+
#define NM_SETTING_WIRELESS_SECURITY_LEAP_USERNAME "leap-username"
+

-A list of pairwise encryption algorithms which prevents connections to -Wi-Fi networks that do not utilize one of the algorithms in the list. -For maximum compatibility leave this property empty. Each list element -may be one of "tkip" or "ccmp".


-

The "proto" property

-
  "proto"                    GStrv                 : Read / Write
+

NM_SETTING_WIRELESS_SECURITY_WEP_KEY0

+
#define NM_SETTING_WIRELESS_SECURITY_WEP_KEY0 "wep-key0"
+

-List of strings specifying the allowed WPA protocol versions to use. -Each element may be one "wpa" (allow WPA) or "rsn" (allow WPA2/RSN). If -not specified, both WPA and RSN connections are allowed.


-

The "psk" property

-
  "psk"                      gchar*                : Read / Write
+

NM_SETTING_WIRELESS_SECURITY_WEP_KEY1

+
#define NM_SETTING_WIRELESS_SECURITY_WEP_KEY1 "wep-key1"
+

-Pre-Shared-Key for WPA networks. If the key is 64-characters long, it -must contain only hexadecimal characters and is interpreted as a -hexadecimal WPA key. Otherwise, the key must be between 8 and 63 ASCII -characters (as specified in the 802.11i standard) and is interpreted as a -WPA passphrase, and is hashed to derive the actual WPA-PSK used when -connecting to the Wi-Fi network.

-

Default value: NULL


-

The "psk-flags" property

-
  "psk-flags"                NMSettingSecretFlags  : Read / Write
+

NM_SETTING_WIRELESS_SECURITY_WEP_KEY2

+
#define NM_SETTING_WIRELESS_SECURITY_WEP_KEY2 "wep-key2"
+

-Flags indicating how to handle the "psk" -property.


-

The "wep-key-flags" property

-
  "wep-key-flags"            NMSettingSecretFlags  : Read / Write
+

NM_SETTING_WIRELESS_SECURITY_WEP_KEY3

+
#define NM_SETTING_WIRELESS_SECURITY_WEP_KEY3 "wep-key3"
+

-Flags indicating how to handle the "wep-key0", -"wep-key1", "wep-key2", -and "wep-key3" properties.


-

The "wep-key-type" property

-
  "wep-key-type"             NMWepKeyType          : Read / Write / Construct
+

NM_SETTING_WIRELESS_SECURITY_WEP_KEY_FLAGS

+
#define NM_SETTING_WIRELESS_SECURITY_WEP_KEY_FLAGS "wep-key-flags"
+

-Controls the interpretation of WEP keys. Allowed values are -NM_WEP_KEY_TYPE_KEY, in which case the key is either a 10- or -26-character hexadecimal string, or a 5- or 13-character ASCII password; -or NM_WEP_KEY_TYPE_PASSPHRASE, in which case the passphrase is provided -as a string and will be hashed using the de-facto MD5 method to derive -the actual WEP key.

-

Default value: NM_WEP_KEY_TYPE_UNKNOWN


-

The "wep-key0" property

-
  "wep-key0"                 gchar*                : Read / Write
+

NM_SETTING_WIRELESS_SECURITY_WEP_KEY_TYPE

+
#define NM_SETTING_WIRELESS_SECURITY_WEP_KEY_TYPE "wep-key-type"
+

-Index 0 WEP key. This is the WEP key used in most networks. See the -"wep-key-type" property for a description of how this key is interpreted.

-

Default value: NULL


-

The "wep-key1" property

-
  "wep-key1"                 gchar*                : Read / Write
+

NM_SETTING_WIRELESS_SECURITY_PSK

+
#define NM_SETTING_WIRELESS_SECURITY_PSK "psk"
+

-Index 1 WEP key. This WEP index is not used by most networks. See the -"wep-key-type" property for a description of how this key is interpreted.

-

Default value: NULL


-

The "wep-key2" property

-
  "wep-key2"                 gchar*                : Read / Write
+

NM_SETTING_WIRELESS_SECURITY_PSK_FLAGS

+
#define NM_SETTING_WIRELESS_SECURITY_PSK_FLAGS "psk-flags"
+

-Index 2 WEP key. This WEP index is not used by most networks. See the -"wep-key-type" property for a description of how this key is interpreted.

-

Default value: NULL


-

The "wep-key3" property

-
  "wep-key3"                 gchar*                : Read / Write
+

NM_SETTING_WIRELESS_SECURITY_LEAP_PASSWORD

+
#define NM_SETTING_WIRELESS_SECURITY_LEAP_PASSWORD "leap-password"
+

-Index 3 WEP key. This WEP index is not used by most networks. See the -"wep-key-type" property for a description of how this key is interpreted.

-

Default value: NULL


-

The "wep-tx-keyidx" property

-
  "wep-tx-keyidx"            guint                 : Read / Write / Construct
+

NM_SETTING_WIRELESS_SECURITY_LEAP_PASSWORD_FLAGS

+
#define NM_SETTING_WIRELESS_SECURITY_LEAP_PASSWORD_FLAGS "leap-password-flags"
+

-When static WEP is used (ie, key-mgmt = "none") and a non-default WEP key -index is used by the AP, put that WEP key index here. Valid values are 0 -(default key) through 3. Note that some consumer access points (like the -Linksys WRT54G) number the keys 1 - 4.

+
+
+
+

Property Details

+
+

The “auth-alg” property

+
  “auth-alg”                 gchar *
+

+

Flags: Read / Write

+

Default value: NULL

+
+
+
+

The “group” property

+
  “group”                    GStrv
+

+

Flags: Read / Write

+
+
+
+

The “key-mgmt” property

+
  “key-mgmt”                 gchar *
+

+

Flags: Read / Write

+

Default value: NULL

+
+
+
+

The “leap-password” property

+
  “leap-password”            gchar *
+

+

Flags: Read / Write

+

Default value: NULL

+
+
+
+

The “leap-password-flags” property

+
  “leap-password-flags”      NMSettingSecretFlags
+

+

Flags: Read / Write

+
+
+
+

The “leap-username” property

+
  “leap-username”            gchar *
+

+

Flags: Read / Write

+

Default value: NULL

+
+
+
+

The “pairwise” property

+
  “pairwise”                 GStrv
+

+

Flags: Read / Write

+
+
+
+

The “proto” property

+
  “proto”                    GStrv
+

+

Flags: Read / Write

+
+
+
+

The “psk” property

+
  “psk”                      gchar *
+

+

Flags: Read / Write

+

Default value: NULL

+
+
+
+

The “psk-flags” property

+
  “psk-flags”                NMSettingSecretFlags
+

+

Flags: Read / Write

+
+
+
+

The “wep-key-flags” property

+
  “wep-key-flags”            NMSettingSecretFlags
+

+

Flags: Read / Write

+
+
+
+

The “wep-key-type” property

+
  “wep-key-type”             NMWepKeyType
+

+

Flags: Read / Write / Construct

+

Default value: NM_WEP_KEY_TYPE_UNKNOWN

+
+
+
+

The “wep-key0” property

+
  “wep-key0”                 gchar *
+

+

Flags: Read / Write

+

Default value: NULL

+
+
+
+

The “wep-key1” property

+
  “wep-key1”                 gchar *
+

+

Flags: Read / Write

+

Default value: NULL

+
+
+
+

The “wep-key2” property

+
  “wep-key2”                 gchar *
+

+

Flags: Read / Write

+

Default value: NULL

+
+
+
+

The “wep-key3” property

+
  “wep-key3”                 gchar *
+

+

Flags: Read / Write

+

Default value: NULL

+
+
+
+

The “wep-tx-keyidx” property

+
  “wep-tx-keyidx”            guint
+

+

Flags: Read / Write / Construct

Allowed values: <= 3

Default value: 0

@@ -1445,6 +1796,6 @@ Linksys WRT54G) number the keys 1 - 4.
+ Generated by GTK-Doc V1.21 \ No newline at end of file diff --git a/docs/libnm/html/NMSimpleConnection.html b/docs/libnm/html/NMSimpleConnection.html index c017881e..b1e77edb 100644 --- a/docs/libnm/html/NMSimpleConnection.html +++ b/docs/libnm/html/NMSimpleConnection.html @@ -2,34 +2,27 @@ -NMSimpleConnection +libnm Reference Manual: NMSimpleConnection - + - - - - - - - - - - + + + + + + +
@@ -37,139 +30,143 @@

NMSimpleConnection

NMSimpleConnection

- +
-
-

Synopsis

-
struct              NMSimpleConnection;
-                    NMSimpleConnectionClass;
-NMConnection *      nm_simple_connection_new            (void);
-NMConnection *      nm_simple_connection_new_from_dbus  (GVariant *dict,
-                                                         GError **error);
-NMConnection *      nm_simple_connection_new_clone      (NMConnection *connection);
-
+
+

Functions

+

Object Hierarchy

-
-  GObject
-   +----NMSimpleConnection
+
    GObject
+    ╰── NMSimpleConnection
 
-

Implemented Interfaces

-

-NMSimpleConnection implements - NMConnection.

-
-

Description

-

Details

-
-

struct NMSimpleConnection

-
struct NMSimpleConnection;
-

-

-
-
-
-

NMSimpleConnectionClass

-
typedef struct {
-	GObjectClass parent_class;
-} NMSimpleConnectionClass;
-
-

-

-
-
+

Functions

-

nm_simple_connection_new ()

-
NMConnection *      nm_simple_connection_new            (void);
-

-Creates a new NMSimpleConnection object with no NMSetting objects. An +

nm_simple_connection_new ()

+
NMConnection *
+nm_simple_connection_new (void);
+

Creates a new NMSimpleConnection object with no NMSetting objects. An NMSimpleConnection does not directly represent a D-Bus-exported connection, -but might be used in the process of creating a new one. -

-
---- - - - - -

Returns :

the new empty NMConnection object. [transfer full] -
+but might be used in the process of creating a new one.

+
+

Returns

+

the new empty NMConnection object.

+

[transfer full]

+

-

nm_simple_connection_new_from_dbus ()

-
NMConnection *      nm_simple_connection_new_from_dbus  (GVariant *dict,
-                                                         GError **error);
-

-Creates a new NMSimpleConnection from a hash table describing the -connection. See nm_connection_to_dbus() for a description of the expected -hash table. -

-
+

nm_simple_connection_new_from_dbus ()

+
NMConnection *
+nm_simple_connection_new_from_dbus (GVariant *dict,
+                                    GError **error);
+

Creates a new NMSimpleConnection from a hash table describing the +connection. See nm_connection_to_dbus() for a description of the expected +hash table.

+
+

Parameters

+
--+++ - - + + + - - - - - - + + +

dict :

a GVariant of type NM_VARIANT_TYPE_CONNECTION describing the connection

dict

a GVariant of type NM_VARIANT_TYPE_CONNECTION describing the connection

 

error :

on unsuccessful return, an error

Returns :

the new NMSimpleConnection object, populated with -settings created from the values in the hash table, or NULL if the -connection failed to validate. [transfer full] -

error

on unsuccessful return, an error

 
+
+

Returns

+

the new NMSimpleConnection object, populated with +settings created from the values in the hash table, or NULL if the +connection failed to validate.

+

[transfer full]

+
+

-

nm_simple_connection_new_clone ()

-
NMConnection *      nm_simple_connection_new_clone      (NMConnection *connection);
-

-Clones an NMConnection as an NMSimpleConnection. -

-
+

nm_simple_connection_new_clone ()

+
NMConnection *
+nm_simple_connection_new_clone (NMConnection *connection);
+

Clones an NMConnection as an NMSimpleConnection.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

connection :

the NMConnection to clone

Returns :

a new NMConnection containing the same settings -and properties as the source NMConnection. [transfer full] -

connection

the NMConnection to clone

 
+
+

Returns

+

a new NMConnection containing the same settings +and properties as the source NMConnection.

+

[transfer full]

+
+
+
+
+

Types and Values

+ Generated by GTK-Doc V1.21 \ No newline at end of file diff --git a/docs/libnm/html/NMVpnConnection.html b/docs/libnm/html/NMVpnConnection.html index 33abdad9..e1e8ab62 100644 --- a/docs/libnm/html/NMVpnConnection.html +++ b/docs/libnm/html/NMVpnConnection.html @@ -2,38 +2,29 @@ -NMVpnConnection +libnm Reference Manual: NMVpnConnection - + - - - - - - - - - - + + + + + + +
@@ -41,44 +32,97 @@

NMVpnConnection

NMVpnConnection

- +
-
-

Synopsis

-
#define             NM_VPN_CONNECTION_VPN_STATE
-#define             NM_VPN_CONNECTION_BANNER
-struct              NMVpnConnection;
-                    NMVpnConnectionClass;
-NMVpnConnectionState nm_vpn_connection_get_vpn_state    (NMVpnConnection *vpn);
-const char *        nm_vpn_connection_get_banner        (NMVpnConnection *vpn);
-
+
+

Functions

+
++++ + + + + + + + + + + +
+NMVpnConnectionState + +nm_vpn_connection_get_vpn_state () +
const char * + +nm_vpn_connection_get_banner () +
-

Object Hierarchy

-
-  GObject
-   +----NMObject
-         +----NMActiveConnection
-               +----NMVpnConnection
-
+

Properties

+
+++++ + + + + + + + + + + + + +
+gchar *bannerRead
NMVpnConnectionStatevpn-stateRead
-

Implemented Interfaces

-

-NMVpnConnection implements - GInitable and GAsyncInitable.

+

Signals

+
+++++ + + + + + +
voidvpn-state-changedRun First
-

Properties

-
-  "banner"                   gchar*                : Read
-  "vpn-state"                NMVpnConnectionState  : Read
-
+

Types and Values

+
++++ + + + + + + + + + + +
#defineNM_VPN_CONNECTION_VPN_STATE
#defineNM_VPN_CONNECTION_BANNER
-

Signals

-
-  "vpn-state-changed"                              : Run First
+

Object Hierarchy

+
    GObject
+    ╰── NMObject
+        ╰── NMActiveConnection
+            ╰── NMVpnConnection
 
@@ -87,147 +131,113 @@ NMVpnConnection implements

-

Details

+

Functions

-

NM_VPN_CONNECTION_VPN_STATE

-
#define NM_VPN_CONNECTION_VPN_STATE "vpn-state"
-
-

-

+

nm_vpn_connection_get_vpn_state ()

+
NMVpnConnectionState
+nm_vpn_connection_get_vpn_state (NMVpnConnection *vpn);
+

Gets the current NMVpnConnection state.

+
+

Parameters

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

vpn

a NMVpnConnection

 
+
+
+

Returns

+

the VPN state of the active VPN connection.

+

-
-
-

NM_VPN_CONNECTION_BANNER

-
#define NM_VPN_CONNECTION_BANNER "banner"
-
-

-


-

struct NMVpnConnection

-
struct NMVpnConnection;
-

-

+

nm_vpn_connection_get_banner ()

+
const char *
+nm_vpn_connection_get_banner (NMVpnConnection *vpn);
+

Gets the VPN login banner of the active NMVpnConnection.

+
+

Parameters

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

vpn

a NMVpnConnection

 
-
+
+

Returns

+

the VPN login banner of the VPN connection. This is the internal +string used by the connection, and must not be modified.

+

+
+
+
+
+

Types and Values

-

NMVpnConnectionClass

-
typedef struct {
-	NMActiveConnectionClass parent;
-
-	/* Signals */
-	void (*vpn_state_changed) (NMVpnConnection *connection,
-	                           NMVpnConnectionState state,
-	                           NMVpnConnectionStateReason reason);
-} NMVpnConnectionClass;
+

NM_VPN_CONNECTION_VPN_STATE

+
#define NM_VPN_CONNECTION_VPN_STATE "vpn-state"
 


-

nm_vpn_connection_get_vpn_state ()

-
NMVpnConnectionState nm_vpn_connection_get_vpn_state    (NMVpnConnection *vpn);
-

-Gets the current NMVpnConnection state. -

-
---- - - - - - - - - - - -

vpn :

a NMVpnConnection -

Returns :

the VPN state of the active VPN connection.
-
-
-
-

nm_vpn_connection_get_banner ()

-
const char *        nm_vpn_connection_get_banner        (NMVpnConnection *vpn);
+

NM_VPN_CONNECTION_BANNER

+
#define NM_VPN_CONNECTION_BANNER "banner"
+

-Gets the VPN login banner of the active NMVpnConnection.

-
---- - - - - - - - - - - -

vpn :

a NMVpnConnection -

Returns :

the VPN login banner of the VPN connection. This is the internal -string used by the connection, and must not be modified.

Property Details

-

The "banner" property

-
  "banner"                   gchar*                : Read
-

-The VPN login banner of the active VPN connection. -

+

The “banner” property

+
  “banner”                   gchar *
+

+

Flags: Read

Default value: NULL


-

The "vpn-state" property

-
  "vpn-state"                NMVpnConnectionState  : Read
-

-The VPN state of the active VPN connection. -

+

The “vpn-state” property

+
  “vpn-state”                NMVpnConnectionState
+

+

Flags: Read

Default value: NM_VPN_CONNECTION_STATE_UNKNOWN

Signal Details

-

The "vpn-state-changed" signal

-
void                user_function                      (NMVpnConnection *nmvpnconnection,
-                                                        guint            arg1,
-                                                        guint            arg2,
-                                                        gpointer         user_data)            : Run First
-

-

-
---- - - - - - - - - - - -

nmvpnconnection :

the object which received the signal.

user_data :

user data set when the signal handler was connected.
+

The “vpn-state-changed” signal

+
void
+user_function (NMVpnConnection *nmvpnconnection,
+               guint            arg1,
+               guint            arg2,
+               gpointer         user_data)
+

Flags: Run First

+ Generated by GTK-Doc V1.21
\ No newline at end of file diff --git a/docs/libnm/html/NMVpnEditor.html b/docs/libnm/html/NMVpnEditor.html new file mode 100644 index 00000000..ee18c74d --- /dev/null +++ b/docs/libnm/html/NMVpnEditor.html @@ -0,0 +1,591 @@ + + + + +libnm Reference Manual: NMVpnEditor + + + + + + + + + + + + + + + + +
+
+
+ + +
+

NMVpnEditor

+

NMVpnEditor

+
+
+

Functions

+
++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+NMVpnEditorPlugin * + +(*NMVpnEditorPluginFactory) () +
+NMVpnEditorPlugin * + +nm_vpn_editor_plugin_factory () +
+NMVpnEditor * + +nm_vpn_editor_plugin_get_editor () +
+NMVpnEditorPluginCapability + +nm_vpn_editor_plugin_get_capabilities () +
+NMConnection * + +nm_vpn_editor_plugin_import () +
+gboolean + +nm_vpn_editor_plugin_export () +
+char * + +nm_vpn_editor_plugin_get_suggested_filename () +
+GObject * + +nm_vpn_editor_get_widget () +
+gboolean + +nm_vpn_editor_update_connection () +
+
+
+

Properties

+
+++++ + + + + + + + + + + + + + + + + + +
+gchar *descriptionRead
+gchar *nameRead
+gchar *serviceRead
+
+
+

Signals

+
+++++ + + + + + +
voidchangedRun First
+
+
+

Types and Values

+ +
+
+

Object Hierarchy

+
    GFlags
+    ╰── NMVpnEditorPluginCapability
+    GInterface
+    ├── NMVpnEditor
+    ╰── NMVpnEditorPlugin
+
+
+
+

Description

+

+

+
+
+

Functions

+
+

NMVpnEditorPluginFactory ()

+
NMVpnEditorPlugin *
+(*NMVpnEditorPluginFactory) (GError **error);
+

+

+
+

Returns

+

+
+
+
+
+

nm_vpn_editor_plugin_factory ()

+
NMVpnEditorPlugin *
+nm_vpn_editor_plugin_factory (GError **error);
+

+

+
+

Returns

+

+
+
+
+
+

nm_vpn_editor_plugin_get_editor ()

+
NMVpnEditor *
+nm_vpn_editor_plugin_get_editor (NMVpnEditorPlugin *plugin,
+                                 NMConnection *connection,
+                                 GError **error);
+
+

Returns

+

.

+

[transfer full]

+
+
+
+
+

nm_vpn_editor_plugin_get_capabilities ()

+
NMVpnEditorPluginCapability
+nm_vpn_editor_plugin_get_capabilities (NMVpnEditorPlugin *plugin);
+

+

+
+

Returns

+

+
+
+
+
+

nm_vpn_editor_plugin_import ()

+
NMConnection *
+nm_vpn_editor_plugin_import (NMVpnEditorPlugin *plugin,
+                             const char *path,
+                             GError **error);
+
+

Returns

+

.

+

[transfer full]

+
+
+
+
+

nm_vpn_editor_plugin_export ()

+
gboolean
+nm_vpn_editor_plugin_export (NMVpnEditorPlugin *plugin,
+                             const char *path,
+                             NMConnection *connection,
+                             GError **error);
+

+

+
+

Returns

+

+
+
+
+
+

nm_vpn_editor_plugin_get_suggested_filename ()

+
char *
+nm_vpn_editor_plugin_get_suggested_filename
+                               (NMVpnEditorPlugin *plugin,
+                                NMConnection *connection);
+

+

+
+

Returns

+

+
+
+
+
+

nm_vpn_editor_get_widget ()

+
GObject *
+nm_vpn_editor_get_widget (NMVpnEditor *editor);
+
+

Returns

+

.

+

[transfer none]

+
+
+
+
+

nm_vpn_editor_update_connection ()

+
gboolean
+nm_vpn_editor_update_connection (NMVpnEditor *editor,
+                                 NMConnection *connection,
+                                 GError **error);
+

+

+
+

Returns

+

+
+
+
+
+

Types and Values

+
+

enum NMVpnEditorPluginCapability

+

Flags that indicate certain capabilities of the plugin to editor programs.

+
+

Members

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

NM_VPN_EDITOR_PLUGIN_CAPABILITY_NONE

+

unknown or no capability

+
 

NM_VPN_EDITOR_PLUGIN_CAPABILITY_IMPORT

+

the plugin can import new connections

+
 

NM_VPN_EDITOR_PLUGIN_CAPABILITY_EXPORT

+

the plugin can export connections

+
 

NM_VPN_EDITOR_PLUGIN_CAPABILITY_IPV6

+

the plugin supports IPv6 addressing

+
 
+
+
+
+
+

NM_VPN_EDITOR_PLUGIN_NAME

+
#define NM_VPN_EDITOR_PLUGIN_NAME "name"
+
+

+

+
+
+
+

NM_VPN_EDITOR_PLUGIN_DESCRIPTION

+
#define NM_VPN_EDITOR_PLUGIN_DESCRIPTION "description"
+
+

+

+
+
+
+

NM_VPN_EDITOR_PLUGIN_SERVICE

+
#define NM_VPN_EDITOR_PLUGIN_SERVICE "service"
+
+

+

+
+
+
+

NMVpnEditorPluginInterface

+
typedef struct {
+	GTypeInterface g_iface;
+
+	NMVpnEditor * (*get_editor) (NMVpnEditorPlugin *plugin,
+	                             NMConnection *connection,
+	                             GError **error);
+
+	NMVpnEditorPluginCapability (*get_capabilities) (NMVpnEditorPlugin *plugin);
+
+	NMConnection * (*import_from_file) (NMVpnEditorPlugin *plugin,
+	                                    const char *path,
+	                                    GError **error);
+
+	gboolean (*export_to_file) (NMVpnEditorPlugin *plugin,
+	                            const char *path,
+	                            NMConnection *connection,
+	                            GError **error);
+
+	char * (*get_suggested_filename) (NMVpnEditorPlugin *plugin, NMConnection *connection);
+} NMVpnEditorPluginInterface;
+
+

Interface for VPN editor plugins.

+
+

Members

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

GTypeInterface g_iface;

the parent interface

 

get_editor ()

returns an NMVpnEditor, pre-filled with values from connection +if non-NULL.

 

get_capabilities ()

returns a bitmask of capabilities.

 

import_from_file ()

Try to import a connection from the specified path. On +success, return a partial NMConnection object. On error, return NULL and +set error +with additional information. Note that error +can be NULL, in +which case no additional error information should be provided.

 

export_to_file ()

Export the given connection to the specified path. Return +TRUE on success. On error, return FALSE and set error +with additional +error information. Note that error +can be NULL, in which case no +additional error information should be provided.

 

get_suggested_filename ()

For a given connection, return a suggested file +name. Returned value will be NULL or a suggested file name to be freed by +the caller.

 
+
+
+
+
+

NMVpnEditorInterface

+
typedef struct {
+	GTypeInterface g_iface;
+
+	GObject * (*get_widget) (NMVpnEditor *editor);
+
+	void (*placeholder) (void);
+
+	gboolean (*update_connection) (NMVpnEditor *editor,
+	                               NMConnection *connection,
+	                               GError **error);
+
+	void (*changed) (NMVpnEditor *editor);
+} NMVpnEditorInterface;
+
+

Interface for editing a specific NMConnection

+
+

Members

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

GTypeInterface g_iface;

the parent interface

 

get_widget ()

return the GtkWidget for the VPN editor's UI

 

placeholder ()

not currently used

 

update_connection ()

called to save the user-entered options to the connection +object. Should return FALSE and set error +if the current options are +invalid. error +should contain enough information for the plugin to +determine which UI widget is invalid at a later point in time. For +example, creating unique error codes for what error occurred and populating +the message field of error +with the name of the invalid property.

 

changed ()

emitted when the value of a UI widget changes. May trigger a +validity check via update_connection +to write values to the connection.

 
+
+
+
+
+

Property Details

+
+

The “description” property

+
  “description”              gchar *
+

+

Flags: Read

+

Default value: NULL

+
+
+
+

The “name” property

+
  “name”                     gchar *
+

+

Flags: Read

+

Default value: NULL

+
+
+
+

The “service” property

+
  “service”                  gchar *
+

+

Flags: Read

+

Default value: NULL

+
+
+
+

Signal Details

+
+

The “changed” signal

+
void
+user_function (NMVpnEditor *nmvpneditor,
+               gpointer     user_data)
+

Flags: Run First

+
+
+
+ + + \ No newline at end of file diff --git a/docs/libnm/html/NMWimaxNsp.html b/docs/libnm/html/NMWimaxNsp.html index fa705867..6b4d8307 100644 --- a/docs/libnm/html/NMWimaxNsp.html +++ b/docs/libnm/html/NMWimaxNsp.html @@ -2,36 +2,28 @@ -NMWimaxNsp +libnm Reference Manual: NMWimaxNsp - + - - - - - - - - - - + + + + + + +
@@ -39,312 +31,387 @@

NMWimaxNsp

NMWimaxNsp

- +
- -
-

Object Hierarchy

-
-  GEnum
-   +----NMWimaxNspNetworkType
-
-
-  GObject
-   +----NMObject
-         +----NMWimaxNsp
-
-
-
-

Implemented Interfaces

-

-NMWimaxNsp implements - GInitable and GAsyncInitable.

-
-
-

Properties

-
-  "name"                     gchar*                : Read
-  "network-type"             NMWimaxNspNetworkType  : Read
-  "signal-quality"           guint                 : Read
-
-
-

Description

-

-

-
-
-

Details

-
-

NM_WIMAX_NSP_NAME

-
#define NM_WIMAX_NSP_NAME           "name"
-
-

-

-
-
-
-

NM_WIMAX_NSP_SIGNAL_QUALITY

-
#define NM_WIMAX_NSP_SIGNAL_QUALITY "signal-quality"
-
-

-

-
-
-
-

NM_WIMAX_NSP_NETWORK_TYPE

-
#define NM_WIMAX_NSP_NETWORK_TYPE   "network-type"
-
-

-

-
-
-
-

enum NMWimaxNspNetworkType

-
typedef enum {
-	NM_WIMAX_NSP_NETWORK_TYPE_UNKNOWN         = 0,
-	NM_WIMAX_NSP_NETWORK_TYPE_HOME            = 1,
-	NM_WIMAX_NSP_NETWORK_TYPE_PARTNER         = 2,
-	NM_WIMAX_NSP_NETWORK_TYPE_ROAMING_PARTNER = 3
-} NMWimaxNspNetworkType;
-
-

-WiMAX network type. -

-
+

Functions

+
--++ - - + + + + + - - + - - + - - +

NM_WIMAX_NSP_NETWORK_TYPE_UNKNOWN

unknown network type +const char * + +nm_wimax_nsp_get_name () +
+guint32 + +nm_wimax_nsp_get_signal_quality ()

NM_WIMAX_NSP_NETWORK_TYPE_HOME

home network + +NMWimaxNspNetworkType + +nm_wimax_nsp_get_network_type ()

NM_WIMAX_NSP_NETWORK_TYPE_PARTNER

partner network + +GPtrArray * + +nm_wimax_nsp_filter_connections ()

NM_WIMAX_NSP_NETWORK_TYPE_ROAMING_PARTNER

roaming partner network + +gboolean + +nm_wimax_nsp_connection_valid ()
-
-
-

struct NMWimaxNsp

-
struct NMWimaxNsp;
-

-

-
-
-
-

NMWimaxNspClass

-
typedef struct {
-	NMObjectClass parent;
-} NMWimaxNspClass;
-
-

-

-
-
-
-

nm_wimax_nsp_get_name ()

-
const char *        nm_wimax_nsp_get_name               (NMWimaxNsp *nsp);
-

-Gets the name of the wimax NSP -

-
+
+

Properties

+
--+++ - - + + + - - + + + + + + + +

nsp :

a NMWimaxNsp - +gchar *nameRead

Returns :

the nameNMWimaxNspNetworkTypenetwork-typeRead
guintsignal-qualityRead
-
-
-

nm_wimax_nsp_get_signal_quality ()

-
guint32             nm_wimax_nsp_get_signal_quality     (NMWimaxNsp *nsp);
-

-Gets the WPA signal quality of the wimax NSP. -

-
+
+

Types and Values

+
--++ - - + + + + + + + + + + - - + +

nsp :

a NMWimaxNsp -#defineNM_WIMAX_NSP_NAME
#defineNM_WIMAX_NSP_SIGNAL_QUALITY
#defineNM_WIMAX_NSP_NETWORK_TYPE

Returns :

the signal qualityenumNMWimaxNspNetworkType
-
-
-

nm_wimax_nsp_get_network_type ()

-
NMWimaxNspNetworkType nm_wimax_nsp_get_network_type     (NMWimaxNsp *nsp);
+
+

Object Hierarchy

+
    GEnum
+    ╰── NMWimaxNspNetworkType
+    GObject
+    ╰── NMObject
+        ╰── NMWimaxNsp
+
+
+
+

Description

-Gets the network type of the wimax NSP.

-
+ +
+

Functions

+
+

nm_wimax_nsp_get_name ()

+
const char *
+nm_wimax_nsp_get_name (NMWimaxNsp *nsp);
+

Gets the name of the wimax NSP

+
+

Parameters

+
--++++ + + + + + +

nsp

a NMWimaxNsp

 
+
+
+

Returns

+

the name

+

+
+
+
+
+

nm_wimax_nsp_get_signal_quality ()

+
guint32
+nm_wimax_nsp_get_signal_quality (NMWimaxNsp *nsp);
+

Gets the WPA signal quality of the wimax NSP.

+
+

Parameters

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

nsp

a NMWimaxNsp

 
+
+
+

Returns

+

the signal quality

+

+
+
+
+
+

nm_wimax_nsp_get_network_type ()

+
NMWimaxNspNetworkType
+nm_wimax_nsp_get_network_type (NMWimaxNsp *nsp);
+

Gets the network type of the wimax NSP.

+
+

Parameters

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

nsp

a NMWimaxNsp

 
+
+
+

Returns

+

the network type

+

+
+
+
+
+

nm_wimax_nsp_filter_connections ()

+
GPtrArray *
+nm_wimax_nsp_filter_connections (NMWimaxNsp *nsp,
+                                 const GPtrArray *connections);
+

Filters a given array of connections for a given NMWimaxNsp object and +return connections which may be activated with the NSP. Any returned +connections will match the nsp +'s network name and other attributes.

+
+

Parameters

+
++++ - - + + + - - + + +

nsp :

a NMWimaxNsp -

nsp

an NMWimaxNsp to filter connections for

 

Returns :

the network type

connections

an array of NMConnections to +filter.

[element-type NMConnection]
+
+

Returns

+

an array of +NMConnections that could be activated with the given nsp +. The array should +be freed with g_ptr_array_unref() when it is no longer required.

+

[transfer container][element-type NMConnection]

+
+

-

nm_wimax_nsp_filter_connections ()

-
GPtrArray *         nm_wimax_nsp_filter_connections     (NMWimaxNsp *nsp,
-                                                         const GPtrArray *connections);
-

-Filters a given array of connections for a given NMWimaxNsp object and -return connections which may be activated with the NSP. Any returned -connections will match the nsp's network name and other attributes. -

-
+

nm_wimax_nsp_connection_valid ()

+
gboolean
+nm_wimax_nsp_connection_valid (NMWimaxNsp *nsp,
+                               NMConnection *connection);
+

Validates a given connection against a given WiMAX NSP to ensure that the +connection may be activated with that NSP. The connection must match the +nsp +'s network name and other attributes.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + +

nsp :

an NMWimaxNsp to filter connections for

connections :

an array of NMConnections to -filter. [element-type NMConnection] -

nsp

an NMWimaxNsp to validate connection +against

 

Returns :

an array of -NMConnections that could be activated with the given nsp. The array should -be freed with g_ptr_array_unref() when it is no longer required. [transfer container][element-type NMConnection] -

connection

an NMConnection to validate against nsp +

 
+
+

Returns

+

TRUE if the connection may be activated with this WiMAX NSP, +FALSE if it cannot be.

+

+
+
+
+
+

Types and Values

+
+

NM_WIMAX_NSP_NAME

+
#define NM_WIMAX_NSP_NAME           "name"
+
+

+

+

-

nm_wimax_nsp_connection_valid ()

-
gboolean            nm_wimax_nsp_connection_valid       (NMWimaxNsp *nsp,
-                                                         NMConnection *connection);
+

NM_WIMAX_NSP_SIGNAL_QUALITY

+
#define NM_WIMAX_NSP_SIGNAL_QUALITY "signal-quality"
+

-Validates a given connection against a given WiMAX NSP to ensure that the -connection may be activated with that NSP. The connection must match the -nsp's network name and other attributes.

-
+ +
+
+

NM_WIMAX_NSP_NETWORK_TYPE

+
#define NM_WIMAX_NSP_NETWORK_TYPE   "network-type"
+
+

+

+
+
+
+

enum NMWimaxNspNetworkType

+

WiMAX network type.

+
+

Members

+
--+++ - - + + + - - + + - - + + + + + + + +

nsp :

an NMWimaxNsp to validate connection against

NM_WIMAX_NSP_NETWORK_TYPE_UNKNOWN

+

unknown network type

+
 

connection :

an NMConnection to validate against nsp +

NM_WIMAX_NSP_NETWORK_TYPE_HOME

+

home network

 

Returns :

-TRUE if the connection may be activated with this WiMAX NSP, -FALSE if it cannot be.

NM_WIMAX_NSP_NETWORK_TYPE_PARTNER

+

partner network

+
 

NM_WIMAX_NSP_NETWORK_TYPE_ROAMING_PARTNER

+

roaming partner network

+
 
+

Property Details

-

The "name" property

-
  "name"                     gchar*                : Read
-

-The name of the WiMAX NSP. -

+

The “name” property

+
  “name”                     gchar *
+

+

Flags: Read

Default value: NULL


-

The "network-type" property

-
  "network-type"             NMWimaxNspNetworkType  : Read
-

-The network type of the WiMAX NSP. -

+

The “network-type” property

+
  “network-type”             NMWimaxNspNetworkType
+

+

Flags: Read

Default value: NM_WIMAX_NSP_NETWORK_TYPE_UNKNOWN


-

The "signal-quality" property

-
  "signal-quality"           guint                 : Read
-

-The signal quality of the WiMAX NSP. -

+

The “signal-quality” property

+
  “signal-quality”           guint
+

+

Flags: Read

Allowed values: <= 100

Default value: 0

@@ -352,6 +419,6 @@ The signal quality of the WiMAX NSP.
+ Generated by GTK-Doc V1.21 \ No newline at end of file diff --git a/docs/libnm/html/annotation-glossary.html b/docs/libnm/html/annotation-glossary.html index 11787bca..ffa567c1 100644 --- a/docs/libnm/html/annotation-glossary.html +++ b/docs/libnm/html/annotation-glossary.html @@ -2,45 +2,40 @@ -Annotation Glossary +libnm Reference Manual: Annotation Glossary - + - - - - - - - - - - + + + + + + +

Annotation Glossary

A

allow-none
-

NULL is ok, both for passing and for returning.

+

NULL is OK, both for passing and for returning.

array

Parameter points to an array of items.

C

@@ -72,6 +67,6 @@
+ Generated by GTK-Doc V1.21 \ No newline at end of file diff --git a/docs/libnm/html/api-index-full.html b/docs/libnm/html/api-index-full.html index c0db3a8b..e64d6477 100644 --- a/docs/libnm/html/api-index-full.html +++ b/docs/libnm/html/api-index-full.html @@ -2,117 +2,104 @@ -API Index +libnm Reference Manual: API Index - + - - - - - - - - - - + + + + + + +

API Index

8

-NM80211ApFlags, enum in nm-dbus-interface +NM80211ApFlags, enum in nm-dbus-interface
-NM80211ApSecurityFlags, enum in nm-dbus-interface +NM80211ApSecurityFlags, enum in nm-dbus-interface
-NM80211Mode, enum in nm-dbus-interface +NM80211Mode, enum in nm-dbus-interface

A

-NMAccessPoint, struct in NMAccessPoint +NMAccessPoint:bssid, object property in NMAccessPoint
-NMAccessPoint:bssid, object property in NMAccessPoint +NMAccessPoint:flags, object property in NMAccessPoint
-NMAccessPoint:flags, object property in NMAccessPoint +NMAccessPoint:frequency, object property in NMAccessPoint
-NMAccessPoint:frequency, object property in NMAccessPoint +NMAccessPoint:hw-address, object property in NMAccessPoint
-NMAccessPoint:hw-address, object property in NMAccessPoint +NMAccessPoint:max-bitrate, object property in NMAccessPoint
-NMAccessPoint:max-bitrate, object property in NMAccessPoint +NMAccessPoint:mode, object property in NMAccessPoint
-NMAccessPoint:mode, object property in NMAccessPoint +NMAccessPoint:rsn-flags, object property in NMAccessPoint
-NMAccessPoint:rsn-flags, object property in NMAccessPoint +NMAccessPoint:ssid, object property in NMAccessPoint
-NMAccessPoint:ssid, object property in NMAccessPoint +NMAccessPoint:strength, object property in NMAccessPoint
-NMAccessPoint:strength, object property in NMAccessPoint -
-
-
-NMAccessPoint:wpa-flags, object property in NMAccessPoint -
-
-
-NMAccessPointClass, struct in NMAccessPoint +NMAccessPoint:wpa-flags, object property in NMAccessPoint
@@ -120,11 +107,11 @@
-nm_access_point_connection_valid, function in NMAccessPoint +nm_access_point_connection_valid, function in NMAccessPoint
-nm_access_point_filter_connections, function in NMAccessPoint +nm_access_point_filter_connections, function in NMAccessPoint
@@ -136,39 +123,39 @@
-nm_access_point_get_bssid, function in NMAccessPoint +nm_access_point_get_bssid, function in NMAccessPoint
-nm_access_point_get_flags, function in NMAccessPoint +nm_access_point_get_flags, function in NMAccessPoint
-nm_access_point_get_frequency, function in NMAccessPoint +nm_access_point_get_frequency, function in NMAccessPoint
-nm_access_point_get_max_bitrate, function in NMAccessPoint +nm_access_point_get_max_bitrate, function in NMAccessPoint
-nm_access_point_get_mode, function in NMAccessPoint +nm_access_point_get_mode, function in NMAccessPoint
-nm_access_point_get_rsn_flags, function in NMAccessPoint +nm_access_point_get_rsn_flags, function in NMAccessPoint
-nm_access_point_get_ssid, function in NMAccessPoint +nm_access_point_get_ssid, function in NMAccessPoint
-nm_access_point_get_strength, function in NMAccessPoint +nm_access_point_get_strength, function in NMAccessPoint
-nm_access_point_get_wpa_flags, function in NMAccessPoint +nm_access_point_get_wpa_flags, function in NMAccessPoint
@@ -200,75 +187,67 @@
-NMActiveConnection, struct in NMActiveConnection -
-
-
-NMActiveConnection:connection, object property in NMActiveConnection -
-
-
-NMActiveConnection:default, object property in NMActiveConnection +NMActiveConnection:connection, object property in NMActiveConnection
-NMActiveConnection:default6, object property in NMActiveConnection +NMActiveConnection:default, object property in NMActiveConnection
-NMActiveConnection:devices, object property in NMActiveConnection +NMActiveConnection:default6, object property in NMActiveConnection
-NMActiveConnection:dhcp4-config, object property in NMActiveConnection +NMActiveConnection:devices, object property in NMActiveConnection
-NMActiveConnection:dhcp6-config, object property in NMActiveConnection +NMActiveConnection:dhcp4-config, object property in NMActiveConnection
-NMActiveConnection:id, object property in NMActiveConnection +NMActiveConnection:dhcp6-config, object property in NMActiveConnection
-NMActiveConnection:ip4-config, object property in NMActiveConnection +NMActiveConnection:id, object property in NMActiveConnection
-NMActiveConnection:ip6-config, object property in NMActiveConnection +NMActiveConnection:ip4-config, object property in NMActiveConnection
-NMActiveConnection:master, object property in NMActiveConnection +NMActiveConnection:ip6-config, object property in NMActiveConnection
-NMActiveConnection:specific-object-path, object property in NMActiveConnection +NMActiveConnection:master, object property in NMActiveConnection
-NMActiveConnection:state, object property in NMActiveConnection +NMActiveConnection:specific-object-path, object property in NMActiveConnection
-NMActiveConnection:type, object property in NMActiveConnection +NMActiveConnection:state, object property in NMActiveConnection
-NMActiveConnection:uuid, object property in NMActiveConnection +NMActiveConnection:type, object property in NMActiveConnection
-NMActiveConnection:vpn, object property in NMActiveConnection +NMActiveConnection:uuid, object property in NMActiveConnection
-NMActiveConnectionClass, struct in NMActiveConnection +NMActiveConnection:vpn, object property in NMActiveConnection
-NMActiveConnectionState, enum in nm-dbus-interface +NMActiveConnectionState, enum in nm-dbus-interface
@@ -296,63 +275,63 @@
-nm_active_connection_get_connection, function in NMActiveConnection +nm_active_connection_get_connection, function in NMActiveConnection
-nm_active_connection_get_connection_type, function in NMActiveConnection +nm_active_connection_get_connection_type, function in NMActiveConnection
-nm_active_connection_get_default, function in NMActiveConnection +nm_active_connection_get_default, function in NMActiveConnection
-nm_active_connection_get_default6, function in NMActiveConnection +nm_active_connection_get_default6, function in NMActiveConnection
-nm_active_connection_get_devices, function in NMActiveConnection +nm_active_connection_get_devices, function in NMActiveConnection
-nm_active_connection_get_dhcp4_config, function in NMActiveConnection +nm_active_connection_get_dhcp4_config, function in NMActiveConnection
-nm_active_connection_get_dhcp6_config, function in NMActiveConnection +nm_active_connection_get_dhcp6_config, function in NMActiveConnection
-nm_active_connection_get_id, function in NMActiveConnection +nm_active_connection_get_id, function in NMActiveConnection
-nm_active_connection_get_ip4_config, function in NMActiveConnection +nm_active_connection_get_ip4_config, function in NMActiveConnection
-nm_active_connection_get_ip6_config, function in NMActiveConnection +nm_active_connection_get_ip6_config, function in NMActiveConnection
-nm_active_connection_get_master, function in NMActiveConnection +nm_active_connection_get_master, function in NMActiveConnection
-nm_active_connection_get_specific_object_path, function in NMActiveConnection +nm_active_connection_get_specific_object_path, function in NMActiveConnection
-nm_active_connection_get_state, function in NMActiveConnection +nm_active_connection_get_state, function in NMActiveConnection
-nm_active_connection_get_uuid, function in NMActiveConnection +nm_active_connection_get_uuid, function in NMActiveConnection
-nm_active_connection_get_vpn, function in NMActiveConnection +nm_active_connection_get_vpn, function in NMActiveConnection
@@ -392,7 +371,7 @@
-NMAgentManagerError, enum in nm-errors +NMAgentManagerError, enum in nm-errors
@@ -400,7 +379,7 @@
-nm_agent_manager_error_quark, function in nm-errors +nm_agent_manager_error_quark, function in nm-errors
@@ -413,7 +392,7 @@

B

-NMBluetoothCapabilities, enum in nm-dbus-interface +NMBluetoothCapabilities, enum in nm-dbus-interface

C

@@ -422,127 +401,119 @@
-NMClient, struct in NMClient -
-
-
-NMClient::connection-added, object signal in NMClient +NMClient::connection-added, object signal in NMClient
-NMClient::connection-removed, object signal in NMClient +NMClient::connection-removed, object signal in NMClient
-NMClient::device-added, object signal in NMClient +NMClient::device-added, object signal in NMClient
-NMClient::device-removed, object signal in NMClient +NMClient::device-removed, object signal in NMClient
-NMClient::permission-changed, object signal in NMClient +NMClient::permission-changed, object signal in NMClient
-NMClient:activating-connection, object property in NMClient +NMClient:activating-connection, object property in NMClient
-NMClient:active-connections, object property in NMClient +NMClient:active-connections, object property in NMClient
-NMClient:can-modify, object property in NMClient +NMClient:can-modify, object property in NMClient
-NMClient:connections, object property in NMClient +NMClient:connections, object property in NMClient
-NMClient:connectivity, object property in NMClient +NMClient:connectivity, object property in NMClient
-NMClient:devices, object property in NMClient +NMClient:devices, object property in NMClient
-NMClient:hostname, object property in NMClient +NMClient:hostname, object property in NMClient
-NMClient:networking-enabled, object property in NMClient +NMClient:networking-enabled, object property in NMClient
-NMClient:nm-running, object property in NMClient +NMClient:nm-running, object property in NMClient
-NMClient:primary-connection, object property in NMClient +NMClient:primary-connection, object property in NMClient
-NMClient:startup, object property in NMClient +NMClient:startup, object property in NMClient
-NMClient:state, object property in NMClient +NMClient:state, object property in NMClient
-NMClient:version, object property in NMClient +NMClient:version, object property in NMClient
-NMClient:wimax-enabled, object property in NMClient +NMClient:wimax-enabled, object property in NMClient
-NMClient:wimax-hardware-enabled, object property in NMClient +NMClient:wimax-hardware-enabled, object property in NMClient
-NMClient:wireless-enabled, object property in NMClient +NMClient:wireless-enabled, object property in NMClient
-NMClient:wireless-hardware-enabled, object property in NMClient +NMClient:wireless-hardware-enabled, object property in NMClient
-NMClient:wwan-enabled, object property in NMClient +NMClient:wwan-enabled, object property in NMClient
-NMClient:wwan-hardware-enabled, object property in NMClient +NMClient:wwan-hardware-enabled, object property in NMClient
-NMClientClass, struct in NMClient +NMClientError, enum in NMClient
-NMClientError, enum in NMClient +NMClientPermission, enum in NMClient
-NMClientPermission, enum in NMClient +NMClientPermissionResult, enum in NMClient
-NMClientPermissionResult, enum in NMClient +nm_client_activate_connection_async, function in NMClient
-nm_client_activate_connection_async, function in NMClient -
-
-
-nm_client_activate_connection_finish, function in NMClient +nm_client_activate_connection_finish, function in NMClient
@@ -554,19 +525,19 @@
-nm_client_add_and_activate_connection_async, function in NMClient +nm_client_add_and_activate_connection_async, function in NMClient
-nm_client_add_and_activate_connection_finish, function in NMClient +nm_client_add_and_activate_connection_finish, function in NMClient
-nm_client_add_connection_async, function in NMClient +nm_client_add_connection_async, function in NMClient
-nm_client_add_connection_finish, function in NMClient +nm_client_add_connection_finish, function in NMClient
@@ -574,15 +545,15 @@
-nm_client_check_connectivity, function in NMClient +nm_client_check_connectivity, function in NMClient
-nm_client_check_connectivity_async, function in NMClient +nm_client_check_connectivity_async, function in NMClient
-nm_client_check_connectivity_finish, function in NMClient +nm_client_check_connectivity_finish, function in NMClient
@@ -602,15 +573,15 @@
-nm_client_deactivate_connection, function in NMClient +nm_client_deactivate_connection, function in NMClient
-nm_client_deactivate_connection_async, function in NMClient +nm_client_deactivate_connection_async, function in NMClient
-nm_client_deactivate_connection_finish, function in NMClient +nm_client_deactivate_connection_finish, function in NMClient
@@ -630,75 +601,75 @@
-nm_client_error_quark, function in NMClient +nm_client_error_quark, function in NMClient
-nm_client_get_activating_connection, function in NMClient +nm_client_get_activating_connection, function in NMClient
-nm_client_get_active_connections, function in NMClient +nm_client_get_active_connections, function in NMClient
-nm_client_get_connections, function in NMClient +nm_client_get_connections, function in NMClient
-nm_client_get_connection_by_id, function in NMClient +nm_client_get_connection_by_id, function in NMClient
-nm_client_get_connection_by_path, function in NMClient +nm_client_get_connection_by_path, function in NMClient
-nm_client_get_connection_by_uuid, function in NMClient +nm_client_get_connection_by_uuid, function in NMClient
-nm_client_get_connectivity, function in NMClient +nm_client_get_connectivity, function in NMClient
-nm_client_get_devices, function in NMClient +nm_client_get_devices, function in NMClient
-nm_client_get_device_by_iface, function in NMClient +nm_client_get_device_by_iface, function in NMClient
-nm_client_get_device_by_path, function in NMClient +nm_client_get_device_by_path, function in NMClient
-nm_client_get_logging, function in NMClient +nm_client_get_logging, function in NMClient
-nm_client_get_nm_running, function in NMClient +nm_client_get_nm_running, function in NMClient
-nm_client_get_permission_result, function in NMClient +nm_client_get_permission_result, function in NMClient
-nm_client_get_primary_connection, function in NMClient +nm_client_get_primary_connection, function in NMClient
-nm_client_get_startup, function in NMClient +nm_client_get_startup, function in NMClient
-nm_client_get_state, function in NMClient +nm_client_get_state, function in NMClient
-nm_client_get_version, function in NMClient +nm_client_get_version, function in NMClient
@@ -706,15 +677,15 @@
-nm_client_load_connections, function in NMClient +nm_client_load_connections, function in NMClient
-nm_client_load_connections_async, function in NMClient +nm_client_load_connections_async, function in NMClient
-nm_client_load_connections_finish, function in NMClient +nm_client_load_connections_finish, function in NMClient
@@ -722,23 +693,23 @@
-nm_client_networking_get_enabled, function in NMClient +nm_client_networking_get_enabled, function in NMClient
-nm_client_networking_set_enabled, function in NMClient +nm_client_networking_set_enabled, function in NMClient
-nm_client_new, function in NMClient +nm_client_new, function in NMClient
-nm_client_new_async, function in NMClient +nm_client_new_async, function in NMClient
-nm_client_new_finish, function in NMClient +nm_client_new_finish, function in NMClient
@@ -754,31 +725,31 @@
-nm_client_reload_connections, function in NMClient +nm_client_reload_connections, function in NMClient
-nm_client_reload_connections_async, function in NMClient +nm_client_reload_connections_async, function in NMClient
-nm_client_reload_connections_finish, function in NMClient +nm_client_reload_connections_finish, function in NMClient
-nm_client_save_hostname, function in NMClient +nm_client_save_hostname, function in NMClient
-nm_client_save_hostname_async, function in NMClient +nm_client_save_hostname_async, function in NMClient
-nm_client_save_hostname_finish, function in NMClient +nm_client_save_hostname_finish, function in NMClient
-nm_client_set_logging, function in NMClient +nm_client_set_logging, function in NMClient
@@ -798,7 +769,7 @@
-nm_client_wimax_get_enabled, function in NMClient +nm_client_wimax_get_enabled, function in NMClient
@@ -806,11 +777,11 @@
-nm_client_wimax_hardware_get_enabled, function in NMClient +nm_client_wimax_hardware_get_enabled, function in NMClient
-nm_client_wimax_set_enabled, function in NMClient +nm_client_wimax_set_enabled, function in NMClient
@@ -818,7 +789,7 @@
-nm_client_wireless_get_enabled, function in NMClient +nm_client_wireless_get_enabled, function in NMClient
@@ -826,11 +797,11 @@
-nm_client_wireless_hardware_get_enabled, function in NMClient +nm_client_wireless_hardware_get_enabled, function in NMClient
-nm_client_wireless_set_enabled, function in NMClient +nm_client_wireless_set_enabled, function in NMClient
@@ -838,7 +809,7 @@
-nm_client_wwan_get_enabled, function in NMClient +nm_client_wwan_get_enabled, function in NMClient
@@ -846,15 +817,15 @@
-nm_client_wwan_hardware_get_enabled, function in NMClient +nm_client_wwan_hardware_get_enabled, function in NMClient
-nm_client_wwan_set_enabled, function in NMClient +nm_client_wwan_set_enabled, function in NMClient
-NMConnectionError, enum in nm-errors +NMConnectionError, enum in nm-errors
@@ -862,11 +833,11 @@
-NMConnectionSerializationFlags, enum in NMConnection +NMConnectionSerializationFlags, enum in NMConnection
-nm_connection_add_setting, function in NMConnection +nm_connection_add_setting, function in NMConnection
@@ -874,27 +845,27 @@
-nm_connection_clear_secrets, function in NMConnection +nm_connection_clear_secrets, function in NMConnection
-nm_connection_clear_secrets_with_flags, function in NMConnection +nm_connection_clear_secrets_with_flags, function in NMConnection
-nm_connection_clear_settings, function in NMConnection +nm_connection_clear_settings, function in NMConnection
-nm_connection_compare, function in NMConnection +nm_connection_compare, function in NMConnection
-nm_connection_diff, function in NMConnection +nm_connection_diff, function in NMConnection
-nm_connection_dump, function in NMConnection +nm_connection_dump, function in NMConnection
@@ -902,163 +873,163 @@
-nm_connection_error_quark, function in nm-errors +nm_connection_error_quark, function in nm-errors
-nm_connection_for_each_setting_value, function in NMConnection +nm_connection_for_each_setting_value, function in NMConnection
-nm_connection_get_connection_type, function in NMConnection +nm_connection_get_connection_type, function in NMConnection
-nm_connection_get_id, function in NMConnection +nm_connection_get_id, function in NMConnection
-nm_connection_get_interface_name, function in NMConnection +nm_connection_get_interface_name, function in NMConnection
-nm_connection_get_path, function in NMConnection +nm_connection_get_path, function in NMConnection
-nm_connection_get_setting, function in NMConnection +nm_connection_get_setting, function in NMConnection
-nm_connection_get_setting_802_1x, function in NMConnection +nm_connection_get_setting_802_1x, function in NMConnection
-nm_connection_get_setting_adsl, function in NMConnection +nm_connection_get_setting_adsl, function in NMConnection
-nm_connection_get_setting_bluetooth, function in NMConnection +nm_connection_get_setting_bluetooth, function in NMConnection
-nm_connection_get_setting_bond, function in NMConnection +nm_connection_get_setting_bond, function in NMConnection
-nm_connection_get_setting_bridge, function in NMConnection +nm_connection_get_setting_bridge, function in NMConnection
-nm_connection_get_setting_bridge_port, function in NMConnection +nm_connection_get_setting_bridge_port, function in NMConnection
-nm_connection_get_setting_by_name, function in NMConnection +nm_connection_get_setting_by_name, function in NMConnection
-nm_connection_get_setting_cdma, function in NMConnection +nm_connection_get_setting_cdma, function in NMConnection
-nm_connection_get_setting_connection, function in NMConnection +nm_connection_get_setting_connection, function in NMConnection
-nm_connection_get_setting_dcb, function in NMConnection +nm_connection_get_setting_dcb, function in NMConnection
-nm_connection_get_setting_generic, function in NMConnection +nm_connection_get_setting_generic, function in NMConnection
-nm_connection_get_setting_gsm, function in NMConnection +nm_connection_get_setting_gsm, function in NMConnection
-nm_connection_get_setting_infiniband, function in NMConnection +nm_connection_get_setting_infiniband, function in NMConnection
-nm_connection_get_setting_ip4_config, function in NMConnection +nm_connection_get_setting_ip4_config, function in NMConnection
-nm_connection_get_setting_ip6_config, function in NMConnection +nm_connection_get_setting_ip6_config, function in NMConnection
-nm_connection_get_setting_olpc_mesh, function in NMConnection +nm_connection_get_setting_olpc_mesh, function in NMConnection
-nm_connection_get_setting_ppp, function in NMConnection +nm_connection_get_setting_ppp, function in NMConnection
-nm_connection_get_setting_pppoe, function in NMConnection +nm_connection_get_setting_pppoe, function in NMConnection
-nm_connection_get_setting_serial, function in NMConnection +nm_connection_get_setting_serial, function in NMConnection
-nm_connection_get_setting_team, function in NMConnection +nm_connection_get_setting_team, function in NMConnection
-nm_connection_get_setting_team_port, function in NMConnection +nm_connection_get_setting_team_port, function in NMConnection
-nm_connection_get_setting_vlan, function in NMConnection +nm_connection_get_setting_vlan, function in NMConnection
-nm_connection_get_setting_vpn, function in NMConnection +nm_connection_get_setting_vpn, function in NMConnection
-nm_connection_get_setting_wimax, function in NMConnection +nm_connection_get_setting_wimax, function in NMConnection
-nm_connection_get_setting_wired, function in NMConnection +nm_connection_get_setting_wired, function in NMConnection
-nm_connection_get_setting_wireless, function in NMConnection +nm_connection_get_setting_wireless, function in NMConnection
-nm_connection_get_setting_wireless_security, function in NMConnection +nm_connection_get_setting_wireless_security, function in NMConnection
-nm_connection_get_uuid, function in NMConnection +nm_connection_get_uuid, function in NMConnection
-nm_connection_get_virtual_device_description, function in NMConnection +nm_connection_get_virtual_device_description, function in NMConnection
-nm_connection_is_type, function in NMConnection +nm_connection_is_type, function in NMConnection
-nm_connection_is_virtual, function in NMConnection +nm_connection_is_virtual, function in NMConnection
-nm_connection_need_secrets, function in NMConnection +nm_connection_need_secrets, function in NMConnection
-nm_connection_normalize, function in NMConnection +nm_connection_normalize, function in NMConnection
@@ -1066,15 +1037,15 @@
-nm_connection_remove_setting, function in NMConnection +nm_connection_remove_setting, function in NMConnection
-nm_connection_replace_settings, function in NMConnection +nm_connection_replace_settings, function in NMConnection
-nm_connection_replace_settings_from_connection, function in NMConnection +nm_connection_replace_settings_from_connection, function in NMConnection
@@ -1086,27 +1057,27 @@
-nm_connection_set_path, function in NMConnection +nm_connection_set_path, function in NMConnection
-nm_connection_to_dbus, function in NMConnection +nm_connection_to_dbus, function in NMConnection
-nm_connection_update_secrets, function in NMConnection +nm_connection_update_secrets, function in NMConnection
-nm_connection_verify, function in NMConnection +nm_connection_verify, function in NMConnection
-NMConnectivityState, enum in nm-dbus-interface +NMConnectivityState, enum in nm-dbus-interface
-NMCryptoError, enum in nm-errors +NMCryptoError, enum in nm-errors
@@ -1114,7 +1085,7 @@
-nm_crypto_error_quark, function in nm-errors +nm_crypto_error_quark, function in nm-errors

D

@@ -1387,435 +1358,323 @@
-NMDevice, struct in NMDevice -
-
-
-NMDevice::state-changed, object signal in NMDevice -
-
-
-NMDevice:active-connection, object property in NMDevice -
-
-
-NMDevice:autoconnect, object property in NMDevice -
-
-
-NMDevice:available-connections, object property in NMDevice -
-
-
-NMDevice:capabilities, object property in NMDevice -
-
-
-NMDevice:device-type, object property in NMDevice -
-
-
-NMDevice:dhcp4-config, object property in NMDevice -
-
-
-NMDevice:dhcp6-config, object property in NMDevice -
-
-
-NMDevice:driver, object property in NMDevice -
-
-
-NMDevice:driver-version, object property in NMDevice -
-
-
-NMDevice:firmware-missing, object property in NMDevice -
-
-
-NMDevice:firmware-version, object property in NMDevice -
-
-
-NMDevice:interface, object property in NMDevice -
-
-
-NMDevice:ip-interface, object property in NMDevice +NMDevice::state-changed, object signal in NMDevice
-NMDevice:ip4-config, object property in NMDevice +NMDevice:active-connection, object property in NMDevice
-NMDevice:ip6-config, object property in NMDevice +NMDevice:autoconnect, object property in NMDevice
-NMDevice:managed, object property in NMDevice +NMDevice:available-connections, object property in NMDevice
-NMDevice:mtu, object property in NMDevice +NMDevice:capabilities, object property in NMDevice
-NMDevice:physical-port-id, object property in NMDevice +NMDevice:device-type, object property in NMDevice
-NMDevice:product, object property in NMDevice +NMDevice:dhcp4-config, object property in NMDevice
-NMDevice:state, object property in NMDevice +NMDevice:dhcp6-config, object property in NMDevice
-NMDevice:state-reason, object property in NMDevice +NMDevice:driver, object property in NMDevice
-NMDevice:udi, object property in NMDevice +NMDevice:driver-version, object property in NMDevice
-NMDevice:vendor, object property in NMDevice +NMDevice:firmware-missing, object property in NMDevice
-NMDeviceAdsl, struct in NMDeviceAdsl +NMDevice:firmware-version, object property in NMDevice
-NMDeviceAdsl:carrier, object property in NMDeviceAdsl +NMDevice:interface, object property in NMDevice
-NMDeviceAdslClass, struct in NMDeviceAdsl +NMDevice:ip-interface, object property in NMDevice
-NMDeviceBond, struct in NMDeviceBond +NMDevice:ip4-config, object property in NMDevice
-NMDeviceBond:carrier, object property in NMDeviceBond +NMDevice:ip6-config, object property in NMDevice
-NMDeviceBond:hw-address, object property in NMDeviceBond +NMDevice:managed, object property in NMDevice
-NMDeviceBond:slaves, object property in NMDeviceBond +NMDevice:mtu, object property in NMDevice
-NMDeviceBondClass, struct in NMDeviceBond +NMDevice:physical-port-id, object property in NMDevice
-NMDeviceBridge, struct in NMDeviceBridge +NMDevice:product, object property in NMDevice
-NMDeviceBridge:carrier, object property in NMDeviceBridge +NMDevice:state, object property in NMDevice
-NMDeviceBridge:hw-address, object property in NMDeviceBridge +NMDevice:state-reason, object property in NMDevice
-NMDeviceBridge:slaves, object property in NMDeviceBridge +NMDevice:udi, object property in NMDevice
-NMDeviceBridgeClass, struct in NMDeviceBridge +NMDevice:vendor, object property in NMDevice
-NMDeviceBt, struct in NMDeviceBt +NMDeviceAdsl:carrier, object property in NMDeviceAdsl
-NMDeviceBt:bt-capabilities, object property in NMDeviceBt +NMDeviceBond:carrier, object property in NMDeviceBond
-NMDeviceBt:hw-address, object property in NMDeviceBt +NMDeviceBond:hw-address, object property in NMDeviceBond
-NMDeviceBt:name, object property in NMDeviceBt +NMDeviceBond:slaves, object property in NMDeviceBond
-NMDeviceBtClass, struct in NMDeviceBt +NMDeviceBridge:carrier, object property in NMDeviceBridge
-NMDeviceCapabilities, enum in nm-dbus-interface +NMDeviceBridge:hw-address, object property in NMDeviceBridge
-NMDeviceClass, struct in NMDevice +NMDeviceBridge:slaves, object property in NMDeviceBridge
-NMDeviceError, enum in nm-errors +NMDeviceBt:bt-capabilities, object property in NMDeviceBt
-NMDeviceEthernet, struct in NMDeviceEthernet +NMDeviceBt:hw-address, object property in NMDeviceBt
-NMDeviceEthernet:carrier, object property in NMDeviceEthernet +NMDeviceBt:name, object property in NMDeviceBt
-NMDeviceEthernet:hw-address, object property in NMDeviceEthernet +NMDeviceCapabilities, enum in nm-dbus-interface
-NMDeviceEthernet:perm-hw-address, object property in NMDeviceEthernet +NMDeviceError, enum in nm-errors
-NMDeviceEthernet:speed, object property in NMDeviceEthernet +NMDeviceEthernet:carrier, object property in NMDeviceEthernet
-NMDeviceEthernetClass, struct in NMDeviceEthernet +NMDeviceEthernet:hw-address, object property in NMDeviceEthernet
-NMDeviceGeneric, struct in NMDeviceGeneric +NMDeviceEthernet:perm-hw-address, object property in NMDeviceEthernet
-NMDeviceGeneric:hw-address, object property in NMDeviceGeneric +NMDeviceEthernet:speed, object property in NMDeviceEthernet
-NMDeviceGeneric:type-description, object property in NMDeviceGeneric +NMDeviceGeneric:hw-address, object property in NMDeviceGeneric
-NMDeviceGenericClass, struct in NMDeviceGeneric +NMDeviceGeneric:type-description, object property in NMDeviceGeneric
-NMDeviceInfiniband, struct in NMDeviceInfiniband +NMDeviceInfiniband:carrier, object property in NMDeviceInfiniband
-NMDeviceInfiniband:carrier, object property in NMDeviceInfiniband +NMDeviceInfiniband:hw-address, object property in NMDeviceInfiniband
-NMDeviceInfiniband:hw-address, object property in NMDeviceInfiniband +NMDeviceModem:current-capabilities, object property in NMDeviceModem
-NMDeviceInfinibandClass, struct in NMDeviceInfiniband +NMDeviceModem:modem-capabilities, object property in NMDeviceModem
-NMDeviceModem, struct in NMDeviceModem +NMDeviceModemCapabilities, enum in nm-dbus-interface
-NMDeviceModem:current-capabilities, object property in NMDeviceModem +NMDeviceOlpcMesh:active-channel, object property in NMDeviceOlpcMesh
-NMDeviceModem:modem-capabilities, object property in NMDeviceModem +NMDeviceOlpcMesh:companion, object property in NMDeviceOlpcMesh
-NMDeviceModemCapabilities, enum in nm-dbus-interface +NMDeviceOlpcMesh:hw-address, object property in NMDeviceOlpcMesh
-NMDeviceModemClass, struct in NMDeviceModem +NMDeviceState, enum in nm-dbus-interface
-NMDeviceOlpcMesh, struct in NMDeviceOlpcMesh +NMDeviceStateReason, enum in nm-dbus-interface
-NMDeviceOlpcMesh:active-channel, object property in NMDeviceOlpcMesh +NMDeviceTeam:carrier, object property in NMDeviceTeam
-NMDeviceOlpcMesh:companion, object property in NMDeviceOlpcMesh +NMDeviceTeam:hw-address, object property in NMDeviceTeam
-NMDeviceOlpcMesh:hw-address, object property in NMDeviceOlpcMesh +NMDeviceTeam:slaves, object property in NMDeviceTeam
-NMDeviceOlpcMeshClass, struct in NMDeviceOlpcMesh +NMDeviceType, enum in nm-dbus-interface
-NMDeviceState, enum in nm-dbus-interface +NMDeviceVlan:carrier, object property in NMDeviceVlan
-NMDeviceStateReason, enum in nm-dbus-interface +NMDeviceVlan:hw-address, object property in NMDeviceVlan
-NMDeviceTeam, struct in NMDeviceTeam +NMDeviceVlan:parent, object property in NMDeviceVlan
-NMDeviceTeam:carrier, object property in NMDeviceTeam +NMDeviceVlan:vlan-id, object property in NMDeviceVlan
-NMDeviceTeam:hw-address, object property in NMDeviceTeam +NMDeviceWifi::access-point-added, object signal in NMDeviceWifi
-NMDeviceTeam:slaves, object property in NMDeviceTeam +NMDeviceWifi::access-point-removed, object signal in NMDeviceWifi
-NMDeviceTeamClass, struct in NMDeviceTeam +NMDeviceWifi:access-points, object property in NMDeviceWifi
-NMDeviceType, enum in nm-dbus-interface +NMDeviceWifi:active-access-point, object property in NMDeviceWifi
-NMDeviceVlan, struct in NMDeviceVlan +NMDeviceWifi:bitrate, object property in NMDeviceWifi
-NMDeviceVlan:carrier, object property in NMDeviceVlan +NMDeviceWifi:hw-address, object property in NMDeviceWifi
-NMDeviceVlan:hw-address, object property in NMDeviceVlan +NMDeviceWifi:mode, object property in NMDeviceWifi
-NMDeviceVlan:parent, object property in NMDeviceVlan +NMDeviceWifi:perm-hw-address, object property in NMDeviceWifi
-NMDeviceVlan:vlan-id, object property in NMDeviceVlan +NMDeviceWifi:wireless-capabilities, object property in NMDeviceWifi
-NMDeviceVlanClass, struct in NMDeviceVlan +NMDeviceWifiCapabilities, enum in nm-dbus-interface
-NMDeviceWifi, struct in NMDeviceWifi +NMDeviceWimax::nsp-added, object signal in NMDeviceWimax
-NMDeviceWifi::access-point-added, object signal in NMDeviceWifi +NMDeviceWimax::nsp-removed, object signal in NMDeviceWimax
-NMDeviceWifi::access-point-removed, object signal in NMDeviceWifi +NMDeviceWimax:active-nsp, object property in NMDeviceWimax
-NMDeviceWifi:access-points, object property in NMDeviceWifi +NMDeviceWimax:bsid, object property in NMDeviceWimax
-NMDeviceWifi:active-access-point, object property in NMDeviceWifi +NMDeviceWimax:center-frequency, object property in NMDeviceWimax
-NMDeviceWifi:bitrate, object property in NMDeviceWifi +NMDeviceWimax:cinr, object property in NMDeviceWimax
-NMDeviceWifi:hw-address, object property in NMDeviceWifi +NMDeviceWimax:hw-address, object property in NMDeviceWimax
-NMDeviceWifi:mode, object property in NMDeviceWifi +NMDeviceWimax:nsps, object property in NMDeviceWimax
-NMDeviceWifi:perm-hw-address, object property in NMDeviceWifi +NMDeviceWimax:rssi, object property in NMDeviceWimax
-NMDeviceWifi:wireless-capabilities, object property in NMDeviceWifi -
-
-
-NMDeviceWifiCapabilities, enum in nm-dbus-interface -
-
-
-NMDeviceWifiClass, struct in NMDeviceWifi -
-
-
-NMDeviceWimax, struct in NMDeviceWimax -
-
-
-NMDeviceWimax::nsp-added, object signal in NMDeviceWimax -
-
-
-NMDeviceWimax::nsp-removed, object signal in NMDeviceWimax -
-
-
-NMDeviceWimax:active-nsp, object property in NMDeviceWimax -
-
-
-NMDeviceWimax:bsid, object property in NMDeviceWimax -
-
-
-NMDeviceWimax:center-frequency, object property in NMDeviceWimax -
-
-
-NMDeviceWimax:cinr, object property in NMDeviceWimax -
-
-
-NMDeviceWimax:hw-address, object property in NMDeviceWimax -
-
-
-NMDeviceWimax:nsps, object property in NMDeviceWimax -
-
-
-NMDeviceWimax:rssi, object property in NMDeviceWimax -
-
-
-NMDeviceWimax:tx-power, object property in NMDeviceWimax -
-
-
-NMDeviceWimaxClass, struct in NMDeviceWimax +NMDeviceWimax:tx-power, object property in NMDeviceWimax
@@ -1827,7 +1686,7 @@
-nm_device_adsl_get_carrier, function in NMDeviceAdsl +nm_device_adsl_get_carrier, function in NMDeviceAdsl
@@ -1843,15 +1702,15 @@
-nm_device_bond_get_carrier, function in NMDeviceBond +nm_device_bond_get_carrier, function in NMDeviceBond
-nm_device_bond_get_hw_address, function in NMDeviceBond +nm_device_bond_get_hw_address, function in NMDeviceBond
-nm_device_bond_get_slaves, function in NMDeviceBond +nm_device_bond_get_slaves, function in NMDeviceBond
@@ -1867,15 +1726,15 @@
-nm_device_bridge_get_carrier, function in NMDeviceBridge +nm_device_bridge_get_carrier, function in NMDeviceBridge
-nm_device_bridge_get_hw_address, function in NMDeviceBridge +nm_device_bridge_get_hw_address, function in NMDeviceBridge
-nm_device_bridge_get_slaves, function in NMDeviceBridge +nm_device_bridge_get_slaves, function in NMDeviceBridge
@@ -1891,15 +1750,15 @@
-nm_device_bt_get_capabilities, function in NMDeviceBt +nm_device_bt_get_capabilities, function in NMDeviceBt
-nm_device_bt_get_hw_address, function in NMDeviceBt +nm_device_bt_get_hw_address, function in NMDeviceBt
-nm_device_bt_get_name, function in NMDeviceBt +nm_device_bt_get_name, function in NMDeviceBt
@@ -1915,23 +1774,23 @@
-nm_device_connection_compatible, function in NMDevice +nm_device_connection_compatible, function in NMDevice
-nm_device_connection_valid, function in NMDevice +nm_device_connection_valid, function in NMDevice
-nm_device_delete, function in NMDevice +nm_device_delete, function in NMDevice
-nm_device_delete_async, function in NMDevice +nm_device_delete_async, function in NMDevice
-nm_device_delete_finish, function in NMDevice +nm_device_delete_finish, function in NMDevice
@@ -1947,19 +1806,19 @@
-nm_device_disambiguate_names, function in NMDevice +nm_device_disambiguate_names, function in NMDevice
-nm_device_disconnect, function in NMDevice +nm_device_disconnect, function in NMDevice
-nm_device_disconnect_async, function in NMDevice +nm_device_disconnect_async, function in NMDevice
-nm_device_disconnect_finish, function in NMDevice +nm_device_disconnect_finish, function in NMDevice
@@ -1975,7 +1834,7 @@
-nm_device_error_quark, function in nm-errors +nm_device_error_quark, function in nm-errors
@@ -1983,19 +1842,19 @@
-nm_device_ethernet_get_carrier, function in NMDeviceEthernet +nm_device_ethernet_get_carrier, function in NMDeviceEthernet
-nm_device_ethernet_get_hw_address, function in NMDeviceEthernet +nm_device_ethernet_get_hw_address, function in NMDeviceEthernet
-nm_device_ethernet_get_permanent_hw_address, function in NMDeviceEthernet +nm_device_ethernet_get_permanent_hw_address, function in NMDeviceEthernet
-nm_device_ethernet_get_speed, function in NMDeviceEthernet +nm_device_ethernet_get_speed, function in NMDeviceEthernet
@@ -2011,7 +1870,7 @@
-nm_device_filter_connections, function in NMDevice +nm_device_filter_connections, function in NMDevice
@@ -2023,7 +1882,7 @@
-nm_device_generic_get_hw_address, function in NMDeviceGeneric +nm_device_generic_get_hw_address, function in NMDeviceGeneric
@@ -2035,111 +1894,111 @@
-nm_device_get_active_connection, function in NMDevice +nm_device_get_active_connection, function in NMDevice
-nm_device_get_autoconnect, function in NMDevice +nm_device_get_autoconnect, function in NMDevice
-nm_device_get_available_connections, function in NMDevice +nm_device_get_available_connections, function in NMDevice
-nm_device_get_capabilities, function in NMDevice +nm_device_get_capabilities, function in NMDevice
-nm_device_get_description, function in NMDevice +nm_device_get_description, function in NMDevice
-nm_device_get_device_type, function in NMDevice +nm_device_get_device_type, function in NMDevice
-nm_device_get_dhcp4_config, function in NMDevice +nm_device_get_dhcp4_config, function in NMDevice
-nm_device_get_dhcp6_config, function in NMDevice +nm_device_get_dhcp6_config, function in NMDevice
-nm_device_get_driver, function in NMDevice +nm_device_get_driver, function in NMDevice
-nm_device_get_driver_version, function in NMDevice +nm_device_get_driver_version, function in NMDevice
-nm_device_get_firmware_missing, function in NMDevice +nm_device_get_firmware_missing, function in NMDevice
-nm_device_get_firmware_version, function in NMDevice +nm_device_get_firmware_version, function in NMDevice
-nm_device_get_hw_address, function in NMDevice +nm_device_get_hw_address, function in NMDevice
-nm_device_get_iface, function in NMDevice +nm_device_get_iface, function in NMDevice
-nm_device_get_ip4_config, function in NMDevice +nm_device_get_ip4_config, function in NMDevice
-nm_device_get_ip6_config, function in NMDevice +nm_device_get_ip6_config, function in NMDevice
-nm_device_get_ip_iface, function in NMDevice +nm_device_get_ip_iface, function in NMDevice
-nm_device_get_managed, function in NMDevice +nm_device_get_managed, function in NMDevice
-nm_device_get_mtu, function in NMDevice +nm_device_get_mtu, function in NMDevice
-nm_device_get_physical_port_id, function in NMDevice +nm_device_get_physical_port_id, function in NMDevice
-nm_device_get_product, function in NMDevice +nm_device_get_product, function in NMDevice
-nm_device_get_setting_type, function in NMDevice +nm_device_get_setting_type, function in NMDevice
-nm_device_get_state, function in NMDevice +nm_device_get_state, function in NMDevice
-nm_device_get_state_reason, function in NMDevice +nm_device_get_state_reason, function in NMDevice
-nm_device_get_type_description, function in NMDevice +nm_device_get_type_description, function in NMDevice
-nm_device_get_udi, function in NMDevice +nm_device_get_udi, function in NMDevice
-nm_device_get_vendor, function in NMDevice +nm_device_get_vendor, function in NMDevice
@@ -2147,11 +2006,11 @@
-nm_device_infiniband_get_carrier, function in NMDeviceInfiniband +nm_device_infiniband_get_carrier, function in NMDeviceInfiniband
-nm_device_infiniband_get_hw_address, function in NMDeviceInfiniband +nm_device_infiniband_get_hw_address, function in NMDeviceInfiniband
@@ -2175,7 +2034,7 @@
-nm_device_is_software, function in NMDevice +nm_device_is_software, function in NMDevice
@@ -2187,11 +2046,11 @@
-nm_device_modem_get_current_capabilities, function in NMDeviceModem +nm_device_modem_get_current_capabilities, function in NMDeviceModem
-nm_device_modem_get_modem_capabilities, function in NMDeviceModem +nm_device_modem_get_modem_capabilities, function in NMDeviceModem
@@ -2211,15 +2070,15 @@
-nm_device_olpc_mesh_get_active_channel, function in NMDeviceOlpcMesh +nm_device_olpc_mesh_get_active_channel, function in NMDeviceOlpcMesh
-nm_device_olpc_mesh_get_companion, function in NMDeviceOlpcMesh +nm_device_olpc_mesh_get_companion, function in NMDeviceOlpcMesh
-nm_device_olpc_mesh_get_hw_address, function in NMDeviceOlpcMesh +nm_device_olpc_mesh_get_hw_address, function in NMDeviceOlpcMesh
@@ -2235,7 +2094,7 @@
-nm_device_set_autoconnect, function in NMDevice +nm_device_set_autoconnect, function in NMDevice
@@ -2251,15 +2110,15 @@
-nm_device_team_get_carrier, function in NMDeviceTeam +nm_device_team_get_carrier, function in NMDeviceTeam
-nm_device_team_get_hw_address, function in NMDeviceTeam +nm_device_team_get_hw_address, function in NMDeviceTeam
-nm_device_team_get_slaves, function in NMDeviceTeam +nm_device_team_get_slaves, function in NMDeviceTeam
@@ -2283,19 +2142,19 @@
-nm_device_vlan_get_carrier, function in NMDeviceVlan +nm_device_vlan_get_carrier, function in NMDeviceVlan
-nm_device_vlan_get_hw_address, function in NMDeviceVlan +nm_device_vlan_get_hw_address, function in NMDeviceVlan
-nm_device_vlan_get_parent, function in NMDeviceVlan +nm_device_vlan_get_parent, function in NMDeviceVlan
-nm_device_vlan_get_vlan_id, function in NMDeviceVlan +nm_device_vlan_get_vlan_id, function in NMDeviceVlan
@@ -2327,35 +2186,35 @@
-nm_device_wifi_get_access_points, function in NMDeviceWifi +nm_device_wifi_get_access_points, function in NMDeviceWifi
-nm_device_wifi_get_access_point_by_path, function in NMDeviceWifi +nm_device_wifi_get_access_point_by_path, function in NMDeviceWifi
-nm_device_wifi_get_active_access_point, function in NMDeviceWifi +nm_device_wifi_get_active_access_point, function in NMDeviceWifi
-nm_device_wifi_get_bitrate, function in NMDeviceWifi +nm_device_wifi_get_bitrate, function in NMDeviceWifi
-nm_device_wifi_get_capabilities, function in NMDeviceWifi +nm_device_wifi_get_capabilities, function in NMDeviceWifi
-nm_device_wifi_get_hw_address, function in NMDeviceWifi +nm_device_wifi_get_hw_address, function in NMDeviceWifi
-nm_device_wifi_get_mode, function in NMDeviceWifi +nm_device_wifi_get_mode, function in NMDeviceWifi
-nm_device_wifi_get_permanent_hw_address, function in NMDeviceWifi +nm_device_wifi_get_permanent_hw_address, function in NMDeviceWifi
@@ -2371,15 +2230,15 @@
-nm_device_wifi_request_scan, function in NMDeviceWifi +nm_device_wifi_request_scan, function in NMDeviceWifi
-nm_device_wifi_request_scan_async, function in NMDeviceWifi +nm_device_wifi_request_scan_async, function in NMDeviceWifi
-nm_device_wifi_request_scan_finish, function in NMDeviceWifi +nm_device_wifi_request_scan_finish, function in NMDeviceWifi
@@ -2399,39 +2258,39 @@
-nm_device_wimax_get_active_nsp, function in NMDeviceWimax +nm_device_wimax_get_active_nsp, function in NMDeviceWimax
-nm_device_wimax_get_bsid, function in NMDeviceWimax +nm_device_wimax_get_bsid, function in NMDeviceWimax
-nm_device_wimax_get_center_frequency, function in NMDeviceWimax +nm_device_wimax_get_center_frequency, function in NMDeviceWimax
-nm_device_wimax_get_cinr, function in NMDeviceWimax +nm_device_wimax_get_cinr, function in NMDeviceWimax
-nm_device_wimax_get_hw_address, function in NMDeviceWimax +nm_device_wimax_get_hw_address, function in NMDeviceWimax
-nm_device_wimax_get_nsps, function in NMDeviceWimax +nm_device_wimax_get_nsps, function in NMDeviceWimax
-nm_device_wimax_get_nsp_by_path, function in NMDeviceWimax +nm_device_wimax_get_nsp_by_path, function in NMDeviceWimax
-nm_device_wimax_get_rssi, function in NMDeviceWimax +nm_device_wimax_get_rssi, function in NMDeviceWimax
-nm_device_wimax_get_tx_power, function in NMDeviceWimax +nm_device_wimax_get_tx_power, function in NMDeviceWimax
@@ -2451,19 +2310,11 @@
-NMDhcpConfig, struct in NMDhcpConfig -
-
-
-NMDhcpConfig:family, object property in NMDhcpConfig +NMDhcpConfig:family, object property in NMDhcpConfig
-NMDhcpConfig:options, object property in NMDhcpConfig -
-
-
-NMDhcpConfigClass, struct in NMDhcpConfig +NMDhcpConfig:options, object property in NMDhcpConfig
@@ -2471,15 +2322,15 @@
-nm_dhcp_config_get_family, function in NMDhcpConfig +nm_dhcp_config_get_family, function in NMDhcpConfig
-nm_dhcp_config_get_one_option, function in NMDhcpConfig +nm_dhcp_config_get_one_option, function in NMDhcpConfig
-nm_dhcp_config_get_options, function in NMDhcpConfig +nm_dhcp_config_get_options, function in NMDhcpConfig
@@ -2493,115 +2344,99 @@

I

-NMIPAddress, typedef in NMSettingIPConfig -
-
-
-NMIPConfig, struct in NMIPConfig -
-
-
-NMIPConfig:addresses, object property in NMIPConfig -
-
-
-NMIPConfig:domains, object property in NMIPConfig -
-
-
-NMIPConfig:family, object property in NMIPConfig +NMIPConfig:addresses, object property in NMIPConfig
-NMIPConfig:gateway, object property in NMIPConfig +NMIPConfig:domains, object property in NMIPConfig
-NMIPConfig:nameservers, object property in NMIPConfig +NMIPConfig:family, object property in NMIPConfig
-NMIPConfig:routes, object property in NMIPConfig +NMIPConfig:gateway, object property in NMIPConfig
-NMIPConfig:searches, object property in NMIPConfig +NMIPConfig:nameservers, object property in NMIPConfig
-NMIPConfig:wins-servers, object property in NMIPConfig +NMIPConfig:routes, object property in NMIPConfig
-NMIPConfigClass, struct in NMIPConfig +NMIPConfig:searches, object property in NMIPConfig
-NMIPRoute, typedef in NMSettingIPConfig +NMIPConfig:wins-servers, object property in NMIPConfig
-nm_ip_address_dup, function in NMSettingIPConfig +nm_ip_address_dup, function in NMSettingIPConfig
-nm_ip_address_equal, function in NMSettingIPConfig +nm_ip_address_equal, function in NMSettingIPConfig
-nm_ip_address_get_address, function in NMSettingIPConfig +nm_ip_address_get_address, function in NMSettingIPConfig
-nm_ip_address_get_address_binary, function in NMSettingIPConfig +nm_ip_address_get_address_binary, function in NMSettingIPConfig
-nm_ip_address_get_attribute, function in NMSettingIPConfig +nm_ip_address_get_attribute, function in NMSettingIPConfig
-nm_ip_address_get_attribute_names, function in NMSettingIPConfig +nm_ip_address_get_attribute_names, function in NMSettingIPConfig
-nm_ip_address_get_family, function in NMSettingIPConfig +nm_ip_address_get_family, function in NMSettingIPConfig
-nm_ip_address_get_prefix, function in NMSettingIPConfig +nm_ip_address_get_prefix, function in NMSettingIPConfig
-nm_ip_address_new, function in NMSettingIPConfig +nm_ip_address_new, function in NMSettingIPConfig
-nm_ip_address_new_binary, function in NMSettingIPConfig +nm_ip_address_new_binary, function in NMSettingIPConfig
-nm_ip_address_ref, function in NMSettingIPConfig +nm_ip_address_ref, function in NMSettingIPConfig
-nm_ip_address_set_address, function in NMSettingIPConfig +nm_ip_address_set_address, function in NMSettingIPConfig
-nm_ip_address_set_address_binary, function in NMSettingIPConfig +nm_ip_address_set_address_binary, function in NMSettingIPConfig
-nm_ip_address_set_attribute, function in NMSettingIPConfig +nm_ip_address_set_attribute, function in NMSettingIPConfig
-nm_ip_address_set_prefix, function in NMSettingIPConfig +nm_ip_address_set_prefix, function in NMSettingIPConfig
-nm_ip_address_unref, function in NMSettingIPConfig +nm_ip_address_unref, function in NMSettingIPConfig
@@ -2621,35 +2456,35 @@
-nm_ip_config_get_addresses, function in NMIPConfig +nm_ip_config_get_addresses, function in NMIPConfig
-nm_ip_config_get_domains, function in NMIPConfig +nm_ip_config_get_domains, function in NMIPConfig
-nm_ip_config_get_family, function in NMIPConfig +nm_ip_config_get_family, function in NMIPConfig
-nm_ip_config_get_gateway, function in NMIPConfig +nm_ip_config_get_gateway, function in NMIPConfig
-nm_ip_config_get_nameservers, function in NMIPConfig +nm_ip_config_get_nameservers, function in NMIPConfig
-nm_ip_config_get_routes, function in NMIPConfig +nm_ip_config_get_routes, function in NMIPConfig
-nm_ip_config_get_searches, function in NMIPConfig +nm_ip_config_get_searches, function in NMIPConfig
-nm_ip_config_get_wins_servers, function in NMIPConfig +nm_ip_config_get_wins_servers, function in NMIPConfig
@@ -2669,91 +2504,91 @@
-nm_ip_route_dup, function in NMSettingIPConfig +nm_ip_route_dup, function in NMSettingIPConfig
-nm_ip_route_equal, function in NMSettingIPConfig +nm_ip_route_equal, function in NMSettingIPConfig
-nm_ip_route_get_attribute, function in NMSettingIPConfig +nm_ip_route_get_attribute, function in NMSettingIPConfig
-nm_ip_route_get_attribute_names, function in NMSettingIPConfig +nm_ip_route_get_attribute_names, function in NMSettingIPConfig
-nm_ip_route_get_dest, function in NMSettingIPConfig +nm_ip_route_get_dest, function in NMSettingIPConfig
-nm_ip_route_get_dest_binary, function in NMSettingIPConfig +nm_ip_route_get_dest_binary, function in NMSettingIPConfig
-nm_ip_route_get_family, function in NMSettingIPConfig +nm_ip_route_get_family, function in NMSettingIPConfig
-nm_ip_route_get_metric, function in NMSettingIPConfig +nm_ip_route_get_metric, function in NMSettingIPConfig
-nm_ip_route_get_next_hop, function in NMSettingIPConfig +nm_ip_route_get_next_hop, function in NMSettingIPConfig
-nm_ip_route_get_next_hop_binary, function in NMSettingIPConfig +nm_ip_route_get_next_hop_binary, function in NMSettingIPConfig
-nm_ip_route_get_prefix, function in NMSettingIPConfig +nm_ip_route_get_prefix, function in NMSettingIPConfig
-nm_ip_route_new, function in NMSettingIPConfig +nm_ip_route_new, function in NMSettingIPConfig
-nm_ip_route_new_binary, function in NMSettingIPConfig +nm_ip_route_new_binary, function in NMSettingIPConfig
-nm_ip_route_ref, function in NMSettingIPConfig +nm_ip_route_ref, function in NMSettingIPConfig
-nm_ip_route_set_attribute, function in NMSettingIPConfig +nm_ip_route_set_attribute, function in NMSettingIPConfig
-nm_ip_route_set_dest, function in NMSettingIPConfig +nm_ip_route_set_dest, function in NMSettingIPConfig
-nm_ip_route_set_dest_binary, function in NMSettingIPConfig +nm_ip_route_set_dest_binary, function in NMSettingIPConfig
-nm_ip_route_set_metric, function in NMSettingIPConfig +nm_ip_route_set_metric, function in NMSettingIPConfig
-nm_ip_route_set_next_hop, function in NMSettingIPConfig +nm_ip_route_set_next_hop, function in NMSettingIPConfig
-nm_ip_route_set_next_hop_binary, function in NMSettingIPConfig +nm_ip_route_set_next_hop_binary, function in NMSettingIPConfig
-nm_ip_route_set_prefix, function in NMSettingIPConfig +nm_ip_route_set_prefix, function in NMSettingIPConfig
-nm_ip_route_unref, function in NMSettingIPConfig +nm_ip_route_unref, function in NMSettingIPConfig

M

@@ -2762,7 +2597,7 @@
-NMManagerError, enum in nm-errors +NMManagerError, enum in nm-errors
@@ -2770,7 +2605,7 @@
-nm_manager_error_quark, function in nm-errors +nm_manager_error_quark, function in nm-errors
@@ -2783,23 +2618,15 @@

O

-NMObject, struct in NMObject +NMObject:dbus-connection, object property in NMObject
-NMObject:dbus-connection, object property in NMObject +NMObject:nm-running-internal, object property in NMObject
-NMObject:nm-running-internal, object property in NMObject -
-
-
-NMObject:path, object property in NMObject -
-
-
-NMObjectClass, struct in NMObject +NMObject:path, object property in NMObject
@@ -2807,7 +2634,7 @@
-nm_object_get_path, function in NMObject +nm_object_get_path, function in NMObject
@@ -2816,31 +2643,23 @@

R

-NMRemoteConnection, struct in NMRemoteConnection -
-
-
-NMRemoteConnection:unsaved, object property in NMRemoteConnection -
-
-
-NMRemoteConnection:visible, object property in NMRemoteConnection +NMRemoteConnection:unsaved, object property in NMRemoteConnection
-NMRemoteConnectionClass, struct in NMRemoteConnection +NMRemoteConnection:visible, object property in NMRemoteConnection
-nm_remote_connection_commit_changes, function in NMRemoteConnection +nm_remote_connection_commit_changes, function in NMRemoteConnection
-nm_remote_connection_commit_changes_async, function in NMRemoteConnection +nm_remote_connection_commit_changes_async, function in NMRemoteConnection
-nm_remote_connection_commit_changes_finish, function in NMRemoteConnection +nm_remote_connection_commit_changes_finish, function in NMRemoteConnection
@@ -2848,35 +2667,35 @@
-nm_remote_connection_delete, function in NMRemoteConnection +nm_remote_connection_delete, function in NMRemoteConnection
-nm_remote_connection_delete_async, function in NMRemoteConnection +nm_remote_connection_delete_async, function in NMRemoteConnection
-nm_remote_connection_delete_finish, function in NMRemoteConnection +nm_remote_connection_delete_finish, function in NMRemoteConnection
-nm_remote_connection_get_secrets, function in NMRemoteConnection +nm_remote_connection_get_secrets, function in NMRemoteConnection
-nm_remote_connection_get_secrets_async, function in NMRemoteConnection +nm_remote_connection_get_secrets_async, function in NMRemoteConnection
-nm_remote_connection_get_secrets_finish, function in NMRemoteConnection +nm_remote_connection_get_secrets_finish, function in NMRemoteConnection
-nm_remote_connection_get_unsaved, function in NMRemoteConnection +nm_remote_connection_get_unsaved, function in NMRemoteConnection
-nm_remote_connection_get_visible, function in NMRemoteConnection +nm_remote_connection_get_visible, function in NMRemoteConnection
@@ -2884,15 +2703,15 @@
-nm_remote_connection_save, function in NMRemoteConnection +nm_remote_connection_save, function in NMRemoteConnection
-nm_remote_connection_save_async, function in NMRemoteConnection +nm_remote_connection_save_async, function in NMRemoteConnection
-nm_remote_connection_save_finish, function in NMRemoteConnection +nm_remote_connection_save_finish, function in NMRemoteConnection
@@ -2905,51 +2724,43 @@

S

-NMSecretAgentCapabilities, enum in nm-dbus-interface -
-
-
-NMSecretAgentError, enum in nm-errors +NMSecretAgentCapabilities, enum in nm-dbus-interface
-NMSecretAgentGetSecretsFlags, enum in nm-dbus-interface +NMSecretAgentError, enum in nm-errors
-NMSecretAgentOld, struct in NMSecretAgentOld +NMSecretAgentGetSecretsFlags, enum in nm-dbus-interface
-NMSecretAgentOld:auto-register, object property in NMSecretAgentOld +NMSecretAgentOld:auto-register, object property in NMSecretAgentOld
-NMSecretAgentOld:capabilities, object property in NMSecretAgentOld +NMSecretAgentOld:capabilities, object property in NMSecretAgentOld
-NMSecretAgentOld:identifier, object property in NMSecretAgentOld +NMSecretAgentOld:identifier, object property in NMSecretAgentOld
-NMSecretAgentOld:registered, object property in NMSecretAgentOld +NMSecretAgentOld:registered, object property in NMSecretAgentOld
-NMSecretAgentOldClass, struct in NMSecretAgentOld +NMSecretAgentOldDeleteSecretsFunc, user_function in NMSecretAgentOld
-NMSecretAgentOldDeleteSecretsFunc, user_function in NMSecretAgentOld +NMSecretAgentOldGetSecretsFunc, user_function in NMSecretAgentOld
-NMSecretAgentOldGetSecretsFunc, user_function in NMSecretAgentOld -
-
-
-NMSecretAgentOldSaveSecretsFunc, user_function in NMSecretAgentOld +NMSecretAgentOldSaveSecretsFunc, user_function in NMSecretAgentOld
@@ -2957,7 +2768,7 @@
-nm_secret_agent_error_quark, function in nm-errors +nm_secret_agent_error_quark, function in nm-errors
@@ -2969,15 +2780,15 @@
-nm_secret_agent_old_delete_secrets, function in NMSecretAgentOld +nm_secret_agent_old_delete_secrets, function in NMSecretAgentOld
-nm_secret_agent_old_get_registered, function in NMSecretAgentOld +nm_secret_agent_old_get_registered, function in NMSecretAgentOld
-nm_secret_agent_old_get_secrets, function in NMSecretAgentOld +nm_secret_agent_old_get_secrets, function in NMSecretAgentOld
@@ -2985,7 +2796,7 @@
-nm_secret_agent_old_register, function in NMSecretAgentOld +nm_secret_agent_old_register, function in NMSecretAgentOld
@@ -2993,27 +2804,27 @@
-nm_secret_agent_old_register_async, function in NMSecretAgentOld +nm_secret_agent_old_register_async, function in NMSecretAgentOld
-nm_secret_agent_old_register_finish, function in NMSecretAgentOld +nm_secret_agent_old_register_finish, function in NMSecretAgentOld
-nm_secret_agent_old_save_secrets, function in NMSecretAgentOld +nm_secret_agent_old_save_secrets, function in NMSecretAgentOld
-nm_secret_agent_old_unregister, function in NMSecretAgentOld +nm_secret_agent_old_unregister, function in NMSecretAgentOld
-nm_secret_agent_old_unregister_async, function in NMSecretAgentOld +nm_secret_agent_old_unregister_async, function in NMSecretAgentOld
-nm_secret_agent_old_unregister_finish, function in NMSecretAgentOld +nm_secret_agent_old_unregister_finish, function in NMSecretAgentOld
@@ -3021,307 +2832,247 @@
-NMSetting8021x, struct in NMSetting8021x -
-
-
-NMSetting8021x:altsubject-matches, object property in NMSetting8021x -
-
-
-NMSetting8021x:anonymous-identity, object property in NMSetting8021x -
-
-
-NMSetting8021x:ca-cert, object property in NMSetting8021x -
-
-
-NMSetting8021x:ca-path, object property in NMSetting8021x -
-
-
-NMSetting8021x:client-cert, object property in NMSetting8021x -
-
-
-NMSetting8021x:eap, object property in NMSetting8021x -
-
-
-NMSetting8021x:identity, object property in NMSetting8021x +NMSetting8021x:altsubject-matches, object property in NMSetting8021x
-NMSetting8021x:pac-file, object property in NMSetting8021x +NMSetting8021x:anonymous-identity, object property in NMSetting8021x
-NMSetting8021x:password, object property in NMSetting8021x +NMSetting8021x:ca-cert, object property in NMSetting8021x
-NMSetting8021x:password-flags, object property in NMSetting8021x +NMSetting8021x:ca-path, object property in NMSetting8021x
-NMSetting8021x:password-raw, object property in NMSetting8021x +NMSetting8021x:client-cert, object property in NMSetting8021x
-NMSetting8021x:password-raw-flags, object property in NMSetting8021x +NMSetting8021x:eap, object property in NMSetting8021x
-NMSetting8021x:phase1-fast-provisioning, object property in NMSetting8021x +NMSetting8021x:identity, object property in NMSetting8021x
-NMSetting8021x:phase1-peaplabel, object property in NMSetting8021x +NMSetting8021x:pac-file, object property in NMSetting8021x
-NMSetting8021x:phase1-peapver, object property in NMSetting8021x +NMSetting8021x:password, object property in NMSetting8021x
-NMSetting8021x:phase2-altsubject-matches, object property in NMSetting8021x +NMSetting8021x:password-flags, object property in NMSetting8021x
-NMSetting8021x:phase2-auth, object property in NMSetting8021x +NMSetting8021x:password-raw, object property in NMSetting8021x
-NMSetting8021x:phase2-autheap, object property in NMSetting8021x +NMSetting8021x:password-raw-flags, object property in NMSetting8021x
-NMSetting8021x:phase2-ca-cert, object property in NMSetting8021x +NMSetting8021x:phase1-fast-provisioning, object property in NMSetting8021x
-NMSetting8021x:phase2-ca-path, object property in NMSetting8021x +NMSetting8021x:phase1-peaplabel, object property in NMSetting8021x
-NMSetting8021x:phase2-client-cert, object property in NMSetting8021x +NMSetting8021x:phase1-peapver, object property in NMSetting8021x
-NMSetting8021x:phase2-private-key, object property in NMSetting8021x +NMSetting8021x:phase2-altsubject-matches, object property in NMSetting8021x
-NMSetting8021x:phase2-private-key-password, object property in NMSetting8021x +NMSetting8021x:phase2-auth, object property in NMSetting8021x
-NMSetting8021x:phase2-private-key-password-flags, object property in NMSetting8021x +NMSetting8021x:phase2-autheap, object property in NMSetting8021x
-NMSetting8021x:phase2-subject-match, object property in NMSetting8021x +NMSetting8021x:phase2-ca-cert, object property in NMSetting8021x
-NMSetting8021x:pin, object property in NMSetting8021x +NMSetting8021x:phase2-ca-path, object property in NMSetting8021x
-NMSetting8021x:pin-flags, object property in NMSetting8021x +NMSetting8021x:phase2-client-cert, object property in NMSetting8021x
-NMSetting8021x:private-key, object property in NMSetting8021x +NMSetting8021x:phase2-private-key, object property in NMSetting8021x
-NMSetting8021x:private-key-password, object property in NMSetting8021x +NMSetting8021x:phase2-private-key-password, object property in NMSetting8021x
-NMSetting8021x:private-key-password-flags, object property in NMSetting8021x +NMSetting8021x:phase2-private-key-password-flags, object property in NMSetting8021x
-NMSetting8021x:subject-match, object property in NMSetting8021x +NMSetting8021x:phase2-subject-match, object property in NMSetting8021x
-NMSetting8021x:system-ca-certs, object property in NMSetting8021x +NMSetting8021x:pin, object property in NMSetting8021x
-NMSetting8021xCKFormat, enum in NMSetting8021x +NMSetting8021x:pin-flags, object property in NMSetting8021x
-NMSetting8021xCKScheme, enum in NMSetting8021x +NMSetting8021x:private-key, object property in NMSetting8021x
-NMSetting8021xClass, struct in NMSetting8021x +NMSetting8021x:private-key-password, object property in NMSetting8021x
-NMSetting:name, object property in NMSetting +NMSetting8021x:private-key-password-flags, object property in NMSetting8021x
-NMSettingAdsl, struct in NMSettingAdsl +NMSetting8021x:subject-match, object property in NMSetting8021x
-NMSettingAdsl:encapsulation, object property in NMSettingAdsl +NMSetting8021x:system-ca-certs, object property in NMSetting8021x
-NMSettingAdsl:password, object property in NMSettingAdsl +NMSetting8021xCKFormat, enum in NMSetting8021x
-NMSettingAdsl:password-flags, object property in NMSettingAdsl +NMSetting8021xCKScheme, enum in NMSetting8021x
-NMSettingAdsl:protocol, object property in NMSettingAdsl +NMSetting:name, object property in NMSetting
-NMSettingAdsl:username, object property in NMSettingAdsl +NMSettingAdsl:encapsulation, object property in NMSettingAdsl
-NMSettingAdsl:vci, object property in NMSettingAdsl +NMSettingAdsl:password, object property in NMSettingAdsl
-NMSettingAdsl:vpi, object property in NMSettingAdsl +NMSettingAdsl:password-flags, object property in NMSettingAdsl
-NMSettingAdslClass, struct in NMSettingAdsl +NMSettingAdsl:protocol, object property in NMSettingAdsl
-NMSettingBluetooth, struct in NMSettingBluetooth +NMSettingAdsl:username, object property in NMSettingAdsl
-NMSettingBluetooth:bdaddr, object property in NMSettingBluetooth +NMSettingAdsl:vci, object property in NMSettingAdsl
-NMSettingBluetooth:type, object property in NMSettingBluetooth +NMSettingAdsl:vpi, object property in NMSettingAdsl
-NMSettingBluetoothClass, struct in NMSettingBluetooth +NMSettingBluetooth:bdaddr, object property in NMSettingBluetooth
-NMSettingBond, struct in NMSettingBond +NMSettingBluetooth:type, object property in NMSettingBluetooth
-NMSettingBond:options, object property in NMSettingBond +NMSettingBond:options, object property in NMSettingBond
-NMSettingBondClass, struct in NMSettingBond +NMSettingBridge:ageing-time, object property in NMSettingBridge
-NMSettingBridge, struct in NMSettingBridge +NMSettingBridge:forward-delay, object property in NMSettingBridge
-NMSettingBridge:ageing-time, object property in NMSettingBridge +NMSettingBridge:hello-time, object property in NMSettingBridge
-NMSettingBridge:forward-delay, object property in NMSettingBridge +NMSettingBridge:mac-address, object property in NMSettingBridge
-NMSettingBridge:hello-time, object property in NMSettingBridge +NMSettingBridge:max-age, object property in NMSettingBridge
-NMSettingBridge:mac-address, object property in NMSettingBridge +NMSettingBridge:priority, object property in NMSettingBridge
-NMSettingBridge:max-age, object property in NMSettingBridge +NMSettingBridge:stp, object property in NMSettingBridge
-NMSettingBridge:priority, object property in NMSettingBridge +NMSettingBridgePort:hairpin-mode, object property in NMSettingBridgePort
-NMSettingBridge:stp, object property in NMSettingBridge +NMSettingBridgePort:path-cost, object property in NMSettingBridgePort
-NMSettingBridgeClass, struct in NMSettingBridge +NMSettingBridgePort:priority, object property in NMSettingBridgePort
-NMSettingBridgePort, struct in NMSettingBridgePort +NMSettingCdma:number, object property in NMSettingCdma
-NMSettingBridgePort:hairpin-mode, object property in NMSettingBridgePort +NMSettingCdma:password, object property in NMSettingCdma
-NMSettingBridgePort:path-cost, object property in NMSettingBridgePort +NMSettingCdma:password-flags, object property in NMSettingCdma
-NMSettingBridgePort:priority, object property in NMSettingBridgePort +NMSettingCdma:username, object property in NMSettingCdma
-NMSettingBridgePortClass, struct in NMSettingBridgePort +NMSettingClearSecretsWithFlagsFn, user_function in NMSetting
-NMSettingCdma, struct in NMSettingCdma -
-
-
-NMSettingCdma:number, object property in NMSettingCdma -
-
-
-NMSettingCdma:password, object property in NMSettingCdma -
-
-
-NMSettingCdma:password-flags, object property in NMSettingCdma -
-
-
-NMSettingCdma:username, object property in NMSettingCdma -
-
-
-NMSettingCdmaClass, struct in NMSettingCdma -
-
-
-NMSettingClass, struct in NMSetting -
-
-
-NMSettingClearSecretsWithFlagsFn, user_function in NMSetting -
-
-
-NMSettingCompareFlags, enum in NMSetting +NMSettingCompareFlags, enum in NMSetting
@@ -3329,471 +3080,379 @@
-NMSettingConnection:autoconnect, object property in NMSettingConnection -
-
-
-NMSettingConnection:autoconnect-priority, object property in NMSettingConnection -
-
-
-NMSettingConnection:gateway-ping-timeout, object property in NMSettingConnection -
-
-
-NMSettingConnection:id, object property in NMSettingConnection -
-
-
-NMSettingConnection:interface-name, object property in NMSettingConnection -
-
-
-NMSettingConnection:master, object property in NMSettingConnection -
-
-
-NMSettingConnection:permissions, object property in NMSettingConnection -
-
-
-NMSettingConnection:read-only, object property in NMSettingConnection -
-
-
-NMSettingConnection:secondaries, object property in NMSettingConnection -
-
-
-NMSettingConnection:slave-type, object property in NMSettingConnection -
-
-
-NMSettingConnection:timestamp, object property in NMSettingConnection -
-
-
-NMSettingConnection:type, object property in NMSettingConnection -
-
-
-NMSettingConnection:uuid, object property in NMSettingConnection +NMSettingConnection:autoconnect, object property in NMSettingConnection
-NMSettingConnection:zone, object property in NMSettingConnection +NMSettingConnection:autoconnect-priority, object property in NMSettingConnection
-NMSettingConnectionClass, struct in NMSettingConnection +NMSettingConnection:gateway-ping-timeout, object property in NMSettingConnection
-NMSettingDcb, struct in NMSettingDcb +NMSettingConnection:id, object property in NMSettingConnection
-NMSettingDcb:app-fcoe-flags, object property in NMSettingDcb +NMSettingConnection:interface-name, object property in NMSettingConnection
-NMSettingDcb:app-fcoe-mode, object property in NMSettingDcb +NMSettingConnection:master, object property in NMSettingConnection
-NMSettingDcb:app-fcoe-priority, object property in NMSettingDcb +NMSettingConnection:permissions, object property in NMSettingConnection
-NMSettingDcb:app-fip-flags, object property in NMSettingDcb +NMSettingConnection:read-only, object property in NMSettingConnection
-NMSettingDcb:app-fip-priority, object property in NMSettingDcb +NMSettingConnection:secondaries, object property in NMSettingConnection
-NMSettingDcb:app-iscsi-flags, object property in NMSettingDcb +NMSettingConnection:slave-type, object property in NMSettingConnection
-NMSettingDcb:app-iscsi-priority, object property in NMSettingDcb +NMSettingConnection:timestamp, object property in NMSettingConnection
-NMSettingDcb:priority-bandwidth, object property in NMSettingDcb +NMSettingConnection:type, object property in NMSettingConnection
-NMSettingDcb:priority-flow-control, object property in NMSettingDcb +NMSettingConnection:uuid, object property in NMSettingConnection
-NMSettingDcb:priority-flow-control-flags, object property in NMSettingDcb +NMSettingConnection:zone, object property in NMSettingConnection
-NMSettingDcb:priority-group-bandwidth, object property in NMSettingDcb +NMSettingDcb:app-fcoe-flags, object property in NMSettingDcb
-NMSettingDcb:priority-group-flags, object property in NMSettingDcb +NMSettingDcb:app-fcoe-mode, object property in NMSettingDcb
-NMSettingDcb:priority-group-id, object property in NMSettingDcb +NMSettingDcb:app-fcoe-priority, object property in NMSettingDcb
-NMSettingDcb:priority-strict-bandwidth, object property in NMSettingDcb +NMSettingDcb:app-fip-flags, object property in NMSettingDcb
-NMSettingDcb:priority-traffic-class, object property in NMSettingDcb +NMSettingDcb:app-fip-priority, object property in NMSettingDcb
-NMSettingDcbClass, struct in NMSettingDcb +NMSettingDcb:app-iscsi-flags, object property in NMSettingDcb
-NMSettingDcbFlags, enum in NMSettingDcb +NMSettingDcb:app-iscsi-priority, object property in NMSettingDcb
-NMSettingDiffResult, enum in NMSetting +NMSettingDcb:priority-bandwidth, object property in NMSettingDcb
-NMSettingGeneric, struct in NMSettingGeneric +NMSettingDcb:priority-flow-control, object property in NMSettingDcb
-NMSettingGenericClass, struct in NMSettingGeneric +NMSettingDcb:priority-flow-control-flags, object property in NMSettingDcb
-NMSettingGsm, struct in NMSettingGsm +NMSettingDcb:priority-group-bandwidth, object property in NMSettingDcb
-NMSettingGsm:apn, object property in NMSettingGsm +NMSettingDcb:priority-group-flags, object property in NMSettingDcb
-NMSettingGsm:home-only, object property in NMSettingGsm +NMSettingDcb:priority-group-id, object property in NMSettingDcb
-NMSettingGsm:network-id, object property in NMSettingGsm +NMSettingDcb:priority-strict-bandwidth, object property in NMSettingDcb
-NMSettingGsm:number, object property in NMSettingGsm +NMSettingDcb:priority-traffic-class, object property in NMSettingDcb
-NMSettingGsm:password, object property in NMSettingGsm +NMSettingDcbFlags, enum in NMSettingDcb
-NMSettingGsm:password-flags, object property in NMSettingGsm +NMSettingDiffResult, enum in NMSetting
-NMSettingGsm:pin, object property in NMSettingGsm +NMSettingGsm:apn, object property in NMSettingGsm
-NMSettingGsm:pin-flags, object property in NMSettingGsm +NMSettingGsm:home-only, object property in NMSettingGsm
-NMSettingGsm:username, object property in NMSettingGsm +NMSettingGsm:network-id, object property in NMSettingGsm
-NMSettingGsmClass, struct in NMSettingGsm +NMSettingGsm:number, object property in NMSettingGsm
-NMSettingInfiniband, struct in NMSettingInfiniband +NMSettingGsm:password, object property in NMSettingGsm
-NMSettingInfiniband:mac-address, object property in NMSettingInfiniband +NMSettingGsm:password-flags, object property in NMSettingGsm
-NMSettingInfiniband:mtu, object property in NMSettingInfiniband +NMSettingGsm:pin, object property in NMSettingGsm
-NMSettingInfiniband:p-key, object property in NMSettingInfiniband +NMSettingGsm:pin-flags, object property in NMSettingGsm
-NMSettingInfiniband:parent, object property in NMSettingInfiniband +NMSettingGsm:username, object property in NMSettingGsm
-NMSettingInfiniband:transport-mode, object property in NMSettingInfiniband +NMSettingInfiniband:mac-address, object property in NMSettingInfiniband
-NMSettingInfinibandClass, struct in NMSettingInfiniband +NMSettingInfiniband:mtu, object property in NMSettingInfiniband
-NMSettingIP4Config, struct in NMSettingIP4Config +NMSettingInfiniband:p-key, object property in NMSettingInfiniband
-NMSettingIP4Config:dhcp-client-id, object property in NMSettingIP4Config +NMSettingInfiniband:parent, object property in NMSettingInfiniband
-NMSettingIP4ConfigClass, struct in NMSettingIP4Config +NMSettingInfiniband:transport-mode, object property in NMSettingInfiniband
-NMSettingIP6Config, struct in NMSettingIP6Config +NMSettingIP4Config:dhcp-client-id, object property in NMSettingIP4Config
-NMSettingIP6Config:ip6-privacy, object property in NMSettingIP6Config +NMSettingIP6Config:ip6-privacy, object property in NMSettingIP6Config
-NMSettingIP6ConfigClass, struct in NMSettingIP6Config +NMSettingIP6ConfigPrivacy, enum in NMSettingIP6Config
-NMSettingIP6ConfigPrivacy, enum in NMSettingIP6Config +NMSettingIPConfig:addresses, object property in NMSettingIPConfig
-NMSettingIPConfig, struct in NMSettingIPConfig +NMSettingIPConfig:dhcp-hostname, object property in NMSettingIPConfig
-NMSettingIPConfig:addresses, object property in NMSettingIPConfig +NMSettingIPConfig:dhcp-send-hostname, object property in NMSettingIPConfig
-NMSettingIPConfig:dhcp-hostname, object property in NMSettingIPConfig +NMSettingIPConfig:dns, object property in NMSettingIPConfig
-NMSettingIPConfig:dhcp-send-hostname, object property in NMSettingIPConfig +NMSettingIPConfig:dns-search, object property in NMSettingIPConfig
-NMSettingIPConfig:dns, object property in NMSettingIPConfig +NMSettingIPConfig:gateway, object property in NMSettingIPConfig
-NMSettingIPConfig:dns-search, object property in NMSettingIPConfig +NMSettingIPConfig:ignore-auto-dns, object property in NMSettingIPConfig
-NMSettingIPConfig:gateway, object property in NMSettingIPConfig +NMSettingIPConfig:ignore-auto-routes, object property in NMSettingIPConfig
-NMSettingIPConfig:ignore-auto-dns, object property in NMSettingIPConfig +NMSettingIPConfig:may-fail, object property in NMSettingIPConfig
-NMSettingIPConfig:ignore-auto-routes, object property in NMSettingIPConfig +NMSettingIPConfig:method, object property in NMSettingIPConfig
-NMSettingIPConfig:may-fail, object property in NMSettingIPConfig +NMSettingIPConfig:never-default, object property in NMSettingIPConfig
-NMSettingIPConfig:method, object property in NMSettingIPConfig +NMSettingIPConfig:route-metric, object property in NMSettingIPConfig
-NMSettingIPConfig:never-default, object property in NMSettingIPConfig +NMSettingIPConfig:routes, object property in NMSettingIPConfig
-NMSettingIPConfig:route-metric, object property in NMSettingIPConfig +NMSettingOlpcMesh:channel, object property in NMSettingOlpcMesh
-NMSettingIPConfig:routes, object property in NMSettingIPConfig +NMSettingOlpcMesh:dhcp-anycast-address, object property in NMSettingOlpcMesh
-NMSettingIPConfigClass, struct in NMSettingIPConfig +NMSettingOlpcMesh:ssid, object property in NMSettingOlpcMesh
-NMSettingOlpcMesh, struct in NMSettingOlpcMesh +NMSettingPpp:baud, object property in NMSettingPpp
-NMSettingOlpcMesh:channel, object property in NMSettingOlpcMesh +NMSettingPpp:crtscts, object property in NMSettingPpp
-NMSettingOlpcMesh:dhcp-anycast-address, object property in NMSettingOlpcMesh +NMSettingPpp:lcp-echo-failure, object property in NMSettingPpp
-NMSettingOlpcMesh:ssid, object property in NMSettingOlpcMesh +NMSettingPpp:lcp-echo-interval, object property in NMSettingPpp
-NMSettingOlpcMeshClass, struct in NMSettingOlpcMesh +NMSettingPpp:mppe-stateful, object property in NMSettingPpp
-NMSettingPpp, struct in NMSettingPpp +NMSettingPpp:mru, object property in NMSettingPpp
-NMSettingPpp:baud, object property in NMSettingPpp +NMSettingPpp:mtu, object property in NMSettingPpp
-NMSettingPpp:crtscts, object property in NMSettingPpp +NMSettingPpp:no-vj-comp, object property in NMSettingPpp
-NMSettingPpp:lcp-echo-failure, object property in NMSettingPpp +NMSettingPpp:noauth, object property in NMSettingPpp
-NMSettingPpp:lcp-echo-interval, object property in NMSettingPpp +NMSettingPpp:nobsdcomp, object property in NMSettingPpp
-NMSettingPpp:mppe-stateful, object property in NMSettingPpp +NMSettingPpp:nodeflate, object property in NMSettingPpp
-NMSettingPpp:mru, object property in NMSettingPpp +NMSettingPpp:refuse-chap, object property in NMSettingPpp
-NMSettingPpp:mtu, object property in NMSettingPpp +NMSettingPpp:refuse-eap, object property in NMSettingPpp
-NMSettingPpp:no-vj-comp, object property in NMSettingPpp +NMSettingPpp:refuse-mschap, object property in NMSettingPpp
-NMSettingPpp:noauth, object property in NMSettingPpp +NMSettingPpp:refuse-mschapv2, object property in NMSettingPpp
-NMSettingPpp:nobsdcomp, object property in NMSettingPpp +NMSettingPpp:refuse-pap, object property in NMSettingPpp
-NMSettingPpp:nodeflate, object property in NMSettingPpp +NMSettingPpp:require-mppe, object property in NMSettingPpp
-NMSettingPpp:refuse-chap, object property in NMSettingPpp +NMSettingPpp:require-mppe-128, object property in NMSettingPpp
-NMSettingPpp:refuse-eap, object property in NMSettingPpp +NMSettingPppoe:password, object property in NMSettingPppoe
-NMSettingPpp:refuse-mschap, object property in NMSettingPpp +NMSettingPppoe:password-flags, object property in NMSettingPppoe
-NMSettingPpp:refuse-mschapv2, object property in NMSettingPpp +NMSettingPppoe:service, object property in NMSettingPppoe
-NMSettingPpp:refuse-pap, object property in NMSettingPpp +NMSettingPppoe:username, object property in NMSettingPppoe
-NMSettingPpp:require-mppe, object property in NMSettingPpp +NMSettingSecretFlags, enum in NMSetting
-NMSettingPpp:require-mppe-128, object property in NMSettingPpp +NMSettingSerial:baud, object property in NMSettingSerial
-NMSettingPppClass, struct in NMSettingPpp +NMSettingSerial:bits, object property in NMSettingSerial
-NMSettingPppoe, struct in NMSettingPppoe +NMSettingSerial:parity, object property in NMSettingSerial
-NMSettingPppoe:password, object property in NMSettingPppoe +NMSettingSerial:send-delay, object property in NMSettingSerial
-NMSettingPppoe:password-flags, object property in NMSettingPppoe +NMSettingSerial:stopbits, object property in NMSettingSerial
-NMSettingPppoe:service, object property in NMSettingPppoe +NMSettingSerialParity, enum in NMSettingSerial
-NMSettingPppoe:username, object property in NMSettingPppoe -
-
-
-NMSettingPppoeClass, struct in NMSettingPppoe -
-
-
-NMSettingSecretFlags, enum in NMSetting -
-
-
-NMSettingSerial, struct in NMSettingSerial -
-
-
-NMSettingSerial:baud, object property in NMSettingSerial -
-
-
-NMSettingSerial:bits, object property in NMSettingSerial -
-
-
-NMSettingSerial:parity, object property in NMSettingSerial -
-
-
-NMSettingSerial:send-delay, object property in NMSettingSerial -
-
-
-NMSettingSerial:stopbits, object property in NMSettingSerial -
-
-
-NMSettingSerialClass, struct in NMSettingSerial -
-
-
-NMSettingSerialParity, enum in NMSettingSerial -
-
-
-NMSettingsError, enum in nm-errors +NMSettingsError, enum in nm-errors
@@ -3801,307 +3460,243 @@
-nm_settings_error_quark, function in nm-errors -
-
-
-NMSettingTeam, struct in NMSettingTeam -
-
-
-NMSettingTeam:config, object property in NMSettingTeam -
-
-
-NMSettingTeamClass, struct in NMSettingTeam -
-
-
-NMSettingTeamPort, struct in NMSettingTeamPort -
-
-
-NMSettingTeamPort:config, object property in NMSettingTeamPort -
-
-
-NMSettingTeamPortClass, struct in NMSettingTeamPort -
-
-
-NMSettingValueIterFn, user_function in NMSetting -
-
-
-NMSettingVlan, struct in NMSettingVlan -
-
-
-NMSettingVlan:egress-priority-map, object property in NMSettingVlan +nm_settings_error_quark, function in nm-errors
-NMSettingVlan:flags, object property in NMSettingVlan +NMSettingTeam:config, object property in NMSettingTeam
-NMSettingVlan:id, object property in NMSettingVlan +NMSettingTeamPort:config, object property in NMSettingTeamPort
-NMSettingVlan:ingress-priority-map, object property in NMSettingVlan +NMSettingValueIterFn, user_function in NMSetting
-NMSettingVlan:parent, object property in NMSettingVlan +NMSettingVlan:egress-priority-map, object property in NMSettingVlan
-NMSettingVlanClass, struct in NMSettingVlan +NMSettingVlan:flags, object property in NMSettingVlan
-NMSettingVpn, struct in NMSettingVpn +NMSettingVlan:id, object property in NMSettingVlan
-NMSettingVpn:data, object property in NMSettingVpn +NMSettingVlan:ingress-priority-map, object property in NMSettingVlan
-NMSettingVpn:persistent, object property in NMSettingVpn +NMSettingVlan:parent, object property in NMSettingVlan
-NMSettingVpn:secrets, object property in NMSettingVpn +NMSettingVpn:data, object property in NMSettingVpn
-NMSettingVpn:service-type, object property in NMSettingVpn +NMSettingVpn:persistent, object property in NMSettingVpn
-NMSettingVpn:user-name, object property in NMSettingVpn +NMSettingVpn:secrets, object property in NMSettingVpn
-NMSettingVpnClass, struct in NMSettingVpn +NMSettingVpn:service-type, object property in NMSettingVpn
-NMSettingWimax, struct in NMSettingWimax +NMSettingVpn:user-name, object property in NMSettingVpn
-NMSettingWimax:mac-address, object property in NMSettingWimax +NMSettingWimax:mac-address, object property in NMSettingWimax
-NMSettingWimax:network-name, object property in NMSettingWimax +NMSettingWimax:network-name, object property in NMSettingWimax
-NMSettingWimaxClass, struct in NMSettingWimax +NMSettingWired:auto-negotiate, object property in NMSettingWired
-NMSettingWired, struct in NMSettingWired +NMSettingWired:cloned-mac-address, object property in NMSettingWired
-NMSettingWired:auto-negotiate, object property in NMSettingWired +NMSettingWired:duplex, object property in NMSettingWired
-NMSettingWired:cloned-mac-address, object property in NMSettingWired +NMSettingWired:mac-address, object property in NMSettingWired
-NMSettingWired:duplex, object property in NMSettingWired +NMSettingWired:mac-address-blacklist, object property in NMSettingWired
-NMSettingWired:mac-address, object property in NMSettingWired +NMSettingWired:mtu, object property in NMSettingWired
-NMSettingWired:mac-address-blacklist, object property in NMSettingWired +NMSettingWired:port, object property in NMSettingWired
-NMSettingWired:mtu, object property in NMSettingWired +NMSettingWired:s390-nettype, object property in NMSettingWired
-NMSettingWired:port, object property in NMSettingWired +NMSettingWired:s390-options, object property in NMSettingWired
-NMSettingWired:s390-nettype, object property in NMSettingWired +NMSettingWired:s390-subchannels, object property in NMSettingWired
-NMSettingWired:s390-options, object property in NMSettingWired +NMSettingWired:speed, object property in NMSettingWired
-NMSettingWired:s390-subchannels, object property in NMSettingWired +NMSettingWireless:band, object property in NMSettingWireless
-NMSettingWired:speed, object property in NMSettingWired +NMSettingWireless:bssid, object property in NMSettingWireless
-NMSettingWiredClass, struct in NMSettingWired +NMSettingWireless:channel, object property in NMSettingWireless
-NMSettingWireless, struct in NMSettingWireless +NMSettingWireless:cloned-mac-address, object property in NMSettingWireless
-NMSettingWireless:band, object property in NMSettingWireless +NMSettingWireless:hidden, object property in NMSettingWireless
-NMSettingWireless:bssid, object property in NMSettingWireless +NMSettingWireless:mac-address, object property in NMSettingWireless
-NMSettingWireless:channel, object property in NMSettingWireless +NMSettingWireless:mac-address-blacklist, object property in NMSettingWireless
-NMSettingWireless:cloned-mac-address, object property in NMSettingWireless +NMSettingWireless:mode, object property in NMSettingWireless
-NMSettingWireless:hidden, object property in NMSettingWireless +NMSettingWireless:mtu, object property in NMSettingWireless
-NMSettingWireless:mac-address, object property in NMSettingWireless +NMSettingWireless:rate, object property in NMSettingWireless
-NMSettingWireless:mac-address-blacklist, object property in NMSettingWireless +NMSettingWireless:seen-bssids, object property in NMSettingWireless
-NMSettingWireless:mode, object property in NMSettingWireless +NMSettingWireless:ssid, object property in NMSettingWireless
-NMSettingWireless:mtu, object property in NMSettingWireless +NMSettingWireless:tx-power, object property in NMSettingWireless
-NMSettingWireless:rate, object property in NMSettingWireless +NMSettingWirelessSecurity:auth-alg, object property in NMSettingWirelessSecurity
-NMSettingWireless:seen-bssids, object property in NMSettingWireless +NMSettingWirelessSecurity:group, object property in NMSettingWirelessSecurity
-NMSettingWireless:ssid, object property in NMSettingWireless +NMSettingWirelessSecurity:key-mgmt, object property in NMSettingWirelessSecurity
-NMSettingWireless:tx-power, object property in NMSettingWireless +NMSettingWirelessSecurity:leap-password, object property in NMSettingWirelessSecurity
-NMSettingWirelessClass, struct in NMSettingWireless +NMSettingWirelessSecurity:leap-password-flags, object property in NMSettingWirelessSecurity
-NMSettingWirelessSecurity, struct in NMSettingWirelessSecurity +NMSettingWirelessSecurity:leap-username, object property in NMSettingWirelessSecurity
-NMSettingWirelessSecurity:auth-alg, object property in NMSettingWirelessSecurity +NMSettingWirelessSecurity:pairwise, object property in NMSettingWirelessSecurity
-NMSettingWirelessSecurity:group, object property in NMSettingWirelessSecurity +NMSettingWirelessSecurity:proto, object property in NMSettingWirelessSecurity
-NMSettingWirelessSecurity:key-mgmt, object property in NMSettingWirelessSecurity +NMSettingWirelessSecurity:psk, object property in NMSettingWirelessSecurity
-NMSettingWirelessSecurity:leap-password, object property in NMSettingWirelessSecurity +NMSettingWirelessSecurity:psk-flags, object property in NMSettingWirelessSecurity
-NMSettingWirelessSecurity:leap-password-flags, object property in NMSettingWirelessSecurity +NMSettingWirelessSecurity:wep-key-flags, object property in NMSettingWirelessSecurity
-NMSettingWirelessSecurity:leap-username, object property in NMSettingWirelessSecurity +NMSettingWirelessSecurity:wep-key-type, object property in NMSettingWirelessSecurity
-NMSettingWirelessSecurity:pairwise, object property in NMSettingWirelessSecurity +NMSettingWirelessSecurity:wep-key0, object property in NMSettingWirelessSecurity
-NMSettingWirelessSecurity:proto, object property in NMSettingWirelessSecurity +NMSettingWirelessSecurity:wep-key1, object property in NMSettingWirelessSecurity
-NMSettingWirelessSecurity:psk, object property in NMSettingWirelessSecurity +NMSettingWirelessSecurity:wep-key2, object property in NMSettingWirelessSecurity
-NMSettingWirelessSecurity:psk-flags, object property in NMSettingWirelessSecurity +NMSettingWirelessSecurity:wep-key3, object property in NMSettingWirelessSecurity
-NMSettingWirelessSecurity:wep-key-flags, object property in NMSettingWirelessSecurity +NMSettingWirelessSecurity:wep-tx-keyidx, object property in NMSettingWirelessSecurity
-NMSettingWirelessSecurity:wep-key-type, object property in NMSettingWirelessSecurity +nm_setting_802_1x_add_altsubject_match, function in NMSetting8021x
-NMSettingWirelessSecurity:wep-key0, object property in NMSettingWirelessSecurity +nm_setting_802_1x_add_eap_method, function in NMSetting8021x
-NMSettingWirelessSecurity:wep-key1, object property in NMSettingWirelessSecurity -
-
-
-NMSettingWirelessSecurity:wep-key2, object property in NMSettingWirelessSecurity -
-
-
-NMSettingWirelessSecurity:wep-key3, object property in NMSettingWirelessSecurity -
-
-
-NMSettingWirelessSecurity:wep-tx-keyidx, object property in NMSettingWirelessSecurity -
-
-
-NMSettingWirelessSecurityClass, struct in NMSettingWirelessSecurity -
-
-
-nm_setting_802_1x_add_altsubject_match, function in NMSetting8021x -
-
-
-nm_setting_802_1x_add_eap_method, function in NMSetting8021x -
-
-
-nm_setting_802_1x_add_phase2_altsubject_match, function in NMSetting8021x +nm_setting_802_1x_add_phase2_altsubject_match, function in NMSetting8021x
@@ -4121,15 +3716,15 @@
-nm_setting_802_1x_clear_altsubject_matches, function in NMSetting8021x +nm_setting_802_1x_clear_altsubject_matches, function in NMSetting8021x
-nm_setting_802_1x_clear_eap_methods, function in NMSetting8021x +nm_setting_802_1x_clear_eap_methods, function in NMSetting8021x
-nm_setting_802_1x_clear_phase2_altsubject_matches, function in NMSetting8021x +nm_setting_802_1x_clear_phase2_altsubject_matches, function in NMSetting8021x
@@ -4141,199 +3736,199 @@
-nm_setting_802_1x_get_altsubject_match, function in NMSetting8021x +nm_setting_802_1x_get_altsubject_match, function in NMSetting8021x
-nm_setting_802_1x_get_anonymous_identity, function in NMSetting8021x +nm_setting_802_1x_get_anonymous_identity, function in NMSetting8021x
-nm_setting_802_1x_get_ca_cert_blob, function in NMSetting8021x +nm_setting_802_1x_get_ca_cert_blob, function in NMSetting8021x
-nm_setting_802_1x_get_ca_cert_path, function in NMSetting8021x +nm_setting_802_1x_get_ca_cert_path, function in NMSetting8021x
-nm_setting_802_1x_get_ca_cert_scheme, function in NMSetting8021x +nm_setting_802_1x_get_ca_cert_scheme, function in NMSetting8021x
-nm_setting_802_1x_get_ca_path, function in NMSetting8021x +nm_setting_802_1x_get_ca_path, function in NMSetting8021x
-nm_setting_802_1x_get_client_cert_blob, function in NMSetting8021x +nm_setting_802_1x_get_client_cert_blob, function in NMSetting8021x
-nm_setting_802_1x_get_client_cert_path, function in NMSetting8021x +nm_setting_802_1x_get_client_cert_path, function in NMSetting8021x
-nm_setting_802_1x_get_client_cert_scheme, function in NMSetting8021x +nm_setting_802_1x_get_client_cert_scheme, function in NMSetting8021x
-nm_setting_802_1x_get_eap_method, function in NMSetting8021x +nm_setting_802_1x_get_eap_method, function in NMSetting8021x
-nm_setting_802_1x_get_identity, function in NMSetting8021x +nm_setting_802_1x_get_identity, function in NMSetting8021x
-nm_setting_802_1x_get_num_altsubject_matches, function in NMSetting8021x +nm_setting_802_1x_get_num_altsubject_matches, function in NMSetting8021x
-nm_setting_802_1x_get_num_eap_methods, function in NMSetting8021x +nm_setting_802_1x_get_num_eap_methods, function in NMSetting8021x
-nm_setting_802_1x_get_num_phase2_altsubject_matches, function in NMSetting8021x +nm_setting_802_1x_get_num_phase2_altsubject_matches, function in NMSetting8021x
-nm_setting_802_1x_get_pac_file, function in NMSetting8021x +nm_setting_802_1x_get_pac_file, function in NMSetting8021x
-nm_setting_802_1x_get_password, function in NMSetting8021x +nm_setting_802_1x_get_password, function in NMSetting8021x
-nm_setting_802_1x_get_password_flags, function in NMSetting8021x +nm_setting_802_1x_get_password_flags, function in NMSetting8021x
-nm_setting_802_1x_get_password_raw, function in NMSetting8021x +nm_setting_802_1x_get_password_raw, function in NMSetting8021x
-nm_setting_802_1x_get_password_raw_flags, function in NMSetting8021x +nm_setting_802_1x_get_password_raw_flags, function in NMSetting8021x
-nm_setting_802_1x_get_phase1_fast_provisioning, function in NMSetting8021x +nm_setting_802_1x_get_phase1_fast_provisioning, function in NMSetting8021x
-nm_setting_802_1x_get_phase1_peaplabel, function in NMSetting8021x +nm_setting_802_1x_get_phase1_peaplabel, function in NMSetting8021x
-nm_setting_802_1x_get_phase1_peapver, function in NMSetting8021x +nm_setting_802_1x_get_phase1_peapver, function in NMSetting8021x
-nm_setting_802_1x_get_phase2_altsubject_match, function in NMSetting8021x +nm_setting_802_1x_get_phase2_altsubject_match, function in NMSetting8021x
-nm_setting_802_1x_get_phase2_auth, function in NMSetting8021x +nm_setting_802_1x_get_phase2_auth, function in NMSetting8021x
-nm_setting_802_1x_get_phase2_autheap, function in NMSetting8021x +nm_setting_802_1x_get_phase2_autheap, function in NMSetting8021x
-nm_setting_802_1x_get_phase2_ca_cert_blob, function in NMSetting8021x +nm_setting_802_1x_get_phase2_ca_cert_blob, function in NMSetting8021x
-nm_setting_802_1x_get_phase2_ca_cert_path, function in NMSetting8021x +nm_setting_802_1x_get_phase2_ca_cert_path, function in NMSetting8021x
-nm_setting_802_1x_get_phase2_ca_cert_scheme, function in NMSetting8021x +nm_setting_802_1x_get_phase2_ca_cert_scheme, function in NMSetting8021x
-nm_setting_802_1x_get_phase2_ca_path, function in NMSetting8021x +nm_setting_802_1x_get_phase2_ca_path, function in NMSetting8021x
-nm_setting_802_1x_get_phase2_client_cert_blob, function in NMSetting8021x +nm_setting_802_1x_get_phase2_client_cert_blob, function in NMSetting8021x
-nm_setting_802_1x_get_phase2_client_cert_path, function in NMSetting8021x +nm_setting_802_1x_get_phase2_client_cert_path, function in NMSetting8021x
-nm_setting_802_1x_get_phase2_client_cert_scheme, function in NMSetting8021x +nm_setting_802_1x_get_phase2_client_cert_scheme, function in NMSetting8021x
-nm_setting_802_1x_get_phase2_private_key_blob, function in NMSetting8021x +nm_setting_802_1x_get_phase2_private_key_blob, function in NMSetting8021x
-nm_setting_802_1x_get_phase2_private_key_format, function in NMSetting8021x +nm_setting_802_1x_get_phase2_private_key_format, function in NMSetting8021x
-nm_setting_802_1x_get_phase2_private_key_password, function in NMSetting8021x +nm_setting_802_1x_get_phase2_private_key_password, function in NMSetting8021x
-nm_setting_802_1x_get_phase2_private_key_password_flags, function in NMSetting8021x +nm_setting_802_1x_get_phase2_private_key_password_flags, function in NMSetting8021x
-nm_setting_802_1x_get_phase2_private_key_path, function in NMSetting8021x +nm_setting_802_1x_get_phase2_private_key_path, function in NMSetting8021x
-nm_setting_802_1x_get_phase2_private_key_scheme, function in NMSetting8021x +nm_setting_802_1x_get_phase2_private_key_scheme, function in NMSetting8021x
-nm_setting_802_1x_get_phase2_subject_match, function in NMSetting8021x +nm_setting_802_1x_get_phase2_subject_match, function in NMSetting8021x
-nm_setting_802_1x_get_pin, function in NMSetting8021x +nm_setting_802_1x_get_pin, function in NMSetting8021x
-nm_setting_802_1x_get_pin_flags, function in NMSetting8021x +nm_setting_802_1x_get_pin_flags, function in NMSetting8021x
-nm_setting_802_1x_get_private_key_blob, function in NMSetting8021x +nm_setting_802_1x_get_private_key_blob, function in NMSetting8021x
-nm_setting_802_1x_get_private_key_format, function in NMSetting8021x +nm_setting_802_1x_get_private_key_format, function in NMSetting8021x
-nm_setting_802_1x_get_private_key_password, function in NMSetting8021x +nm_setting_802_1x_get_private_key_password, function in NMSetting8021x
-nm_setting_802_1x_get_private_key_password_flags, function in NMSetting8021x +nm_setting_802_1x_get_private_key_password_flags, function in NMSetting8021x
-nm_setting_802_1x_get_private_key_path, function in NMSetting8021x +nm_setting_802_1x_get_private_key_path, function in NMSetting8021x
-nm_setting_802_1x_get_private_key_scheme, function in NMSetting8021x +nm_setting_802_1x_get_private_key_scheme, function in NMSetting8021x
-nm_setting_802_1x_get_subject_match, function in NMSetting8021x +nm_setting_802_1x_get_subject_match, function in NMSetting8021x
-nm_setting_802_1x_get_system_ca_certs, function in NMSetting8021x +nm_setting_802_1x_get_system_ca_certs, function in NMSetting8021x
@@ -4341,7 +3936,7 @@
-nm_setting_802_1x_new, function in NMSetting8021x +nm_setting_802_1x_new, function in NMSetting8021x
@@ -4437,27 +4032,27 @@
-nm_setting_802_1x_remove_altsubject_match, function in NMSetting8021x +nm_setting_802_1x_remove_altsubject_match, function in NMSetting8021x
-nm_setting_802_1x_remove_altsubject_match_by_value, function in NMSetting8021x +nm_setting_802_1x_remove_altsubject_match_by_value, function in NMSetting8021x
-nm_setting_802_1x_remove_eap_method, function in NMSetting8021x +nm_setting_802_1x_remove_eap_method, function in NMSetting8021x
-nm_setting_802_1x_remove_eap_method_by_value, function in NMSetting8021x +nm_setting_802_1x_remove_eap_method_by_value, function in NMSetting8021x
-nm_setting_802_1x_remove_phase2_altsubject_match, function in NMSetting8021x +nm_setting_802_1x_remove_phase2_altsubject_match, function in NMSetting8021x
-nm_setting_802_1x_remove_phase2_altsubject_match_by_value, function in NMSetting8021x +nm_setting_802_1x_remove_phase2_altsubject_match_by_value, function in NMSetting8021x
@@ -4465,27 +4060,27 @@
-nm_setting_802_1x_set_ca_cert, function in NMSetting8021x +nm_setting_802_1x_set_ca_cert, function in NMSetting8021x
-nm_setting_802_1x_set_client_cert, function in NMSetting8021x +nm_setting_802_1x_set_client_cert, function in NMSetting8021x
-nm_setting_802_1x_set_phase2_ca_cert, function in NMSetting8021x +nm_setting_802_1x_set_phase2_ca_cert, function in NMSetting8021x
-nm_setting_802_1x_set_phase2_client_cert, function in NMSetting8021x +nm_setting_802_1x_set_phase2_client_cert, function in NMSetting8021x
-nm_setting_802_1x_set_phase2_private_key, function in NMSetting8021x +nm_setting_802_1x_set_phase2_private_key, function in NMSetting8021x
-nm_setting_802_1x_set_private_key, function in NMSetting8021x +nm_setting_802_1x_set_private_key, function in NMSetting8021x
@@ -4509,35 +4104,35 @@
-nm_setting_adsl_get_encapsulation, function in NMSettingAdsl +nm_setting_adsl_get_encapsulation, function in NMSettingAdsl
-nm_setting_adsl_get_password, function in NMSettingAdsl +nm_setting_adsl_get_password, function in NMSettingAdsl
-nm_setting_adsl_get_password_flags, function in NMSettingAdsl +nm_setting_adsl_get_password_flags, function in NMSettingAdsl
-nm_setting_adsl_get_protocol, function in NMSettingAdsl +nm_setting_adsl_get_protocol, function in NMSettingAdsl
-nm_setting_adsl_get_username, function in NMSettingAdsl +nm_setting_adsl_get_username, function in NMSettingAdsl
-nm_setting_adsl_get_vci, function in NMSettingAdsl +nm_setting_adsl_get_vci, function in NMSettingAdsl
-nm_setting_adsl_get_vpi, function in NMSettingAdsl +nm_setting_adsl_get_vpi, function in NMSettingAdsl
-nm_setting_adsl_new, function in NMSettingAdsl +nm_setting_adsl_new, function in NMSettingAdsl
@@ -4585,15 +4180,15 @@
-nm_setting_bluetooth_get_bdaddr, function in NMSettingBluetooth +nm_setting_bluetooth_get_bdaddr, function in NMSettingBluetooth
-nm_setting_bluetooth_get_connection_type, function in NMSettingBluetooth +nm_setting_bluetooth_get_connection_type, function in NMSettingBluetooth
-nm_setting_bluetooth_new, function in NMSettingBluetooth +nm_setting_bluetooth_new, function in NMSettingBluetooth
@@ -4613,31 +4208,31 @@
-nm_setting_bond_add_option, function in NMSettingBond +nm_setting_bond_add_option, function in NMSettingBond
-nm_setting_bond_get_num_options, function in NMSettingBond +nm_setting_bond_get_num_options, function in NMSettingBond
-nm_setting_bond_get_option, function in NMSettingBond +nm_setting_bond_get_option, function in NMSettingBond
-nm_setting_bond_get_option_by_name, function in NMSettingBond +nm_setting_bond_get_option_by_name, function in NMSettingBond
-nm_setting_bond_get_option_default, function in NMSettingBond +nm_setting_bond_get_option_default, function in NMSettingBond
-nm_setting_bond_get_valid_options, function in NMSettingBond +nm_setting_bond_get_valid_options, function in NMSettingBond
-nm_setting_bond_new, function in NMSettingBond +nm_setting_bond_new, function in NMSettingBond
@@ -4705,7 +4300,7 @@
-nm_setting_bond_remove_option, function in NMSettingBond +nm_setting_bond_remove_option, function in NMSettingBond
@@ -4713,7 +4308,7 @@
-nm_setting_bond_validate_option, function in NMSettingBond +nm_setting_bond_validate_option, function in NMSettingBond
@@ -4725,31 +4320,31 @@
-nm_setting_bridge_get_ageing_time, function in NMSettingBridge +nm_setting_bridge_get_ageing_time, function in NMSettingBridge
-nm_setting_bridge_get_forward_delay, function in NMSettingBridge +nm_setting_bridge_get_forward_delay, function in NMSettingBridge
-nm_setting_bridge_get_hello_time, function in NMSettingBridge +nm_setting_bridge_get_hello_time, function in NMSettingBridge
-nm_setting_bridge_get_mac_address, function in NMSettingBridge +nm_setting_bridge_get_mac_address, function in NMSettingBridge
-nm_setting_bridge_get_max_age, function in NMSettingBridge +nm_setting_bridge_get_max_age, function in NMSettingBridge
-nm_setting_bridge_get_priority, function in NMSettingBridge +nm_setting_bridge_get_priority, function in NMSettingBridge
-nm_setting_bridge_get_stp, function in NMSettingBridge +nm_setting_bridge_get_stp, function in NMSettingBridge
@@ -4765,19 +4360,19 @@
-nm_setting_bridge_new, function in NMSettingBridge +nm_setting_bridge_new, function in NMSettingBridge
-nm_setting_bridge_port_get_hairpin_mode, function in NMSettingBridgePort +nm_setting_bridge_port_get_hairpin_mode, function in NMSettingBridgePort
-nm_setting_bridge_port_get_path_cost, function in NMSettingBridgePort +nm_setting_bridge_port_get_path_cost, function in NMSettingBridgePort
-nm_setting_bridge_port_get_priority, function in NMSettingBridgePort +nm_setting_bridge_port_get_priority, function in NMSettingBridgePort
@@ -4785,7 +4380,7 @@
-nm_setting_bridge_port_new, function in NMSettingBridgePort +nm_setting_bridge_port_new, function in NMSettingBridgePort
@@ -4813,23 +4408,23 @@
-nm_setting_cdma_get_number, function in NMSettingCdma +nm_setting_cdma_get_number, function in NMSettingCdma
-nm_setting_cdma_get_password, function in NMSettingCdma +nm_setting_cdma_get_password, function in NMSettingCdma
-nm_setting_cdma_get_password_flags, function in NMSettingCdma +nm_setting_cdma_get_password_flags, function in NMSettingCdma
-nm_setting_cdma_get_username, function in NMSettingCdma +nm_setting_cdma_get_username, function in NMSettingCdma
-nm_setting_cdma_new, function in NMSettingCdma +nm_setting_cdma_new, function in NMSettingCdma
@@ -4853,15 +4448,15 @@
-nm_setting_compare, function in NMSetting +nm_setting_compare, function in NMSetting
-nm_setting_connection_add_permission, function in NMSettingConnection +nm_setting_connection_add_permission, function in NMSettingConnection
-nm_setting_connection_add_secondary, function in NMSettingConnection +nm_setting_connection_add_secondary, function in NMSettingConnection
@@ -4889,67 +4484,67 @@
-nm_setting_connection_get_autoconnect, function in NMSettingConnection +nm_setting_connection_get_autoconnect, function in NMSettingConnection
-nm_setting_connection_get_autoconnect_priority, function in NMSettingConnection +nm_setting_connection_get_autoconnect_priority, function in NMSettingConnection
-nm_setting_connection_get_connection_type, function in NMSettingConnection +nm_setting_connection_get_connection_type, function in NMSettingConnection
-nm_setting_connection_get_gateway_ping_timeout, function in NMSettingConnection +nm_setting_connection_get_gateway_ping_timeout, function in NMSettingConnection
-nm_setting_connection_get_id, function in NMSettingConnection +nm_setting_connection_get_id, function in NMSettingConnection
-nm_setting_connection_get_interface_name, function in NMSettingConnection +nm_setting_connection_get_interface_name, function in NMSettingConnection
-nm_setting_connection_get_master, function in NMSettingConnection +nm_setting_connection_get_master, function in NMSettingConnection
-nm_setting_connection_get_num_permissions, function in NMSettingConnection +nm_setting_connection_get_num_permissions, function in NMSettingConnection
-nm_setting_connection_get_num_secondaries, function in NMSettingConnection +nm_setting_connection_get_num_secondaries, function in NMSettingConnection
-nm_setting_connection_get_permission, function in NMSettingConnection +nm_setting_connection_get_permission, function in NMSettingConnection
-nm_setting_connection_get_read_only, function in NMSettingConnection +nm_setting_connection_get_read_only, function in NMSettingConnection
-nm_setting_connection_get_secondary, function in NMSettingConnection +nm_setting_connection_get_secondary, function in NMSettingConnection
-nm_setting_connection_get_slave_type, function in NMSettingConnection +nm_setting_connection_get_slave_type, function in NMSettingConnection
-nm_setting_connection_get_timestamp, function in NMSettingConnection +nm_setting_connection_get_timestamp, function in NMSettingConnection
-nm_setting_connection_get_uuid, function in NMSettingConnection +nm_setting_connection_get_uuid, function in NMSettingConnection
-nm_setting_connection_get_zone, function in NMSettingConnection +nm_setting_connection_get_zone, function in NMSettingConnection
@@ -4961,7 +4556,7 @@
-nm_setting_connection_is_slave_type, function in NMSettingConnection +nm_setting_connection_is_slave_type, function in NMSettingConnection
@@ -4969,7 +4564,7 @@
-nm_setting_connection_new, function in NMSettingConnection +nm_setting_connection_new, function in NMSettingConnection
@@ -4977,7 +4572,7 @@
-nm_setting_connection_permissions_user_allowed, function in NMSettingConnection +nm_setting_connection_permissions_user_allowed, function in NMSettingConnection
@@ -4985,19 +4580,19 @@
-nm_setting_connection_remove_permission, function in NMSettingConnection +nm_setting_connection_remove_permission, function in NMSettingConnection
-nm_setting_connection_remove_permission_by_value, function in NMSettingConnection +nm_setting_connection_remove_permission_by_value, function in NMSettingConnection
-nm_setting_connection_remove_secondary, function in NMSettingConnection +nm_setting_connection_remove_secondary, function in NMSettingConnection
-nm_setting_connection_remove_secondary_by_value, function in NMSettingConnection +nm_setting_connection_remove_secondary_by_value, function in NMSettingConnection
@@ -5065,67 +4660,67 @@
-nm_setting_dcb_get_app_fcoe_flags, function in NMSettingDcb +nm_setting_dcb_get_app_fcoe_flags, function in NMSettingDcb
-nm_setting_dcb_get_app_fcoe_mode, function in NMSettingDcb +nm_setting_dcb_get_app_fcoe_mode, function in NMSettingDcb
-nm_setting_dcb_get_app_fcoe_priority, function in NMSettingDcb +nm_setting_dcb_get_app_fcoe_priority, function in NMSettingDcb
-nm_setting_dcb_get_app_fip_flags, function in NMSettingDcb +nm_setting_dcb_get_app_fip_flags, function in NMSettingDcb
-nm_setting_dcb_get_app_fip_priority, function in NMSettingDcb +nm_setting_dcb_get_app_fip_priority, function in NMSettingDcb
-nm_setting_dcb_get_app_iscsi_flags, function in NMSettingDcb +nm_setting_dcb_get_app_iscsi_flags, function in NMSettingDcb
-nm_setting_dcb_get_app_iscsi_priority, function in NMSettingDcb +nm_setting_dcb_get_app_iscsi_priority, function in NMSettingDcb
-nm_setting_dcb_get_priority_bandwidth, function in NMSettingDcb +nm_setting_dcb_get_priority_bandwidth, function in NMSettingDcb
-nm_setting_dcb_get_priority_flow_control, function in NMSettingDcb +nm_setting_dcb_get_priority_flow_control, function in NMSettingDcb
-nm_setting_dcb_get_priority_flow_control_flags, function in NMSettingDcb +nm_setting_dcb_get_priority_flow_control_flags, function in NMSettingDcb
-nm_setting_dcb_get_priority_group_bandwidth, function in NMSettingDcb +nm_setting_dcb_get_priority_group_bandwidth, function in NMSettingDcb
-nm_setting_dcb_get_priority_group_flags, function in NMSettingDcb +nm_setting_dcb_get_priority_group_flags, function in NMSettingDcb
-nm_setting_dcb_get_priority_group_id, function in NMSettingDcb +nm_setting_dcb_get_priority_group_id, function in NMSettingDcb
-nm_setting_dcb_get_priority_strict_bandwidth, function in NMSettingDcb +nm_setting_dcb_get_priority_strict_bandwidth, function in NMSettingDcb
-nm_setting_dcb_get_priority_traffic_class, function in NMSettingDcb +nm_setting_dcb_get_priority_traffic_class, function in NMSettingDcb
-nm_setting_dcb_new, function in NMSettingDcb +nm_setting_dcb_new, function in NMSettingDcb
@@ -5165,43 +4760,43 @@
-nm_setting_dcb_set_priority_bandwidth, function in NMSettingDcb +nm_setting_dcb_set_priority_bandwidth, function in NMSettingDcb
-nm_setting_dcb_set_priority_flow_control, function in NMSettingDcb +nm_setting_dcb_set_priority_flow_control, function in NMSettingDcb
-nm_setting_dcb_set_priority_group_bandwidth, function in NMSettingDcb +nm_setting_dcb_set_priority_group_bandwidth, function in NMSettingDcb
-nm_setting_dcb_set_priority_group_id, function in NMSettingDcb +nm_setting_dcb_set_priority_group_id, function in NMSettingDcb
-nm_setting_dcb_set_priority_strict_bandwidth, function in NMSettingDcb +nm_setting_dcb_set_priority_strict_bandwidth, function in NMSettingDcb
-nm_setting_dcb_set_priority_traffic_class, function in NMSettingDcb +nm_setting_dcb_set_priority_traffic_class, function in NMSettingDcb
-nm_setting_diff, function in NMSetting +nm_setting_diff, function in NMSetting
-nm_setting_duplicate, function in NMSetting +nm_setting_duplicate, function in NMSetting
-nm_setting_enumerate_values, function in NMSetting +nm_setting_enumerate_values, function in NMSetting
-nm_setting_generic_new, function in NMSettingGeneric +nm_setting_generic_new, function in NMSettingGeneric
@@ -5209,15 +4804,15 @@
-nm_setting_get_dbus_property_type, function in NMSetting +nm_setting_get_dbus_property_type, function in NMSetting
-nm_setting_get_name, function in NMSetting +nm_setting_get_name, function in NMSetting
-nm_setting_get_secret_flags, function in NMSetting +nm_setting_get_secret_flags, function in NMSetting
@@ -5225,39 +4820,39 @@
-nm_setting_gsm_get_apn, function in NMSettingGsm +nm_setting_gsm_get_apn, function in NMSettingGsm
-nm_setting_gsm_get_home_only, function in NMSettingGsm +nm_setting_gsm_get_home_only, function in NMSettingGsm
-nm_setting_gsm_get_network_id, function in NMSettingGsm +nm_setting_gsm_get_network_id, function in NMSettingGsm
-nm_setting_gsm_get_number, function in NMSettingGsm +nm_setting_gsm_get_number, function in NMSettingGsm
-nm_setting_gsm_get_password, function in NMSettingGsm +nm_setting_gsm_get_password, function in NMSettingGsm
-nm_setting_gsm_get_password_flags, function in NMSettingGsm +nm_setting_gsm_get_password_flags, function in NMSettingGsm
-nm_setting_gsm_get_pin, function in NMSettingGsm +nm_setting_gsm_get_pin, function in NMSettingGsm
-nm_setting_gsm_get_pin_flags, function in NMSettingGsm +nm_setting_gsm_get_pin_flags, function in NMSettingGsm
-nm_setting_gsm_get_username, function in NMSettingGsm +nm_setting_gsm_get_username, function in NMSettingGsm
@@ -5269,7 +4864,7 @@
-nm_setting_gsm_new, function in NMSettingGsm +nm_setting_gsm_new, function in NMSettingGsm
@@ -5301,27 +4896,27 @@
-nm_setting_infiniband_get_mac_address, function in NMSettingInfiniband +nm_setting_infiniband_get_mac_address, function in NMSettingInfiniband
-nm_setting_infiniband_get_mtu, function in NMSettingInfiniband +nm_setting_infiniband_get_mtu, function in NMSettingInfiniband
-nm_setting_infiniband_get_parent, function in NMSettingInfiniband +nm_setting_infiniband_get_parent, function in NMSettingInfiniband
-nm_setting_infiniband_get_p_key, function in NMSettingInfiniband +nm_setting_infiniband_get_p_key, function in NMSettingInfiniband
-nm_setting_infiniband_get_transport_mode, function in NMSettingInfiniband +nm_setting_infiniband_get_transport_mode, function in NMSettingInfiniband
-nm_setting_infiniband_get_virtual_interface_name, function in NMSettingInfiniband +nm_setting_infiniband_get_virtual_interface_name, function in NMSettingInfiniband
@@ -5333,7 +4928,7 @@
-nm_setting_infiniband_new, function in NMSettingInfiniband +nm_setting_infiniband_new, function in NMSettingInfiniband
@@ -5357,7 +4952,7 @@
-nm_setting_ip4_config_get_dhcp_client_id, function in NMSettingIP4Config +nm_setting_ip4_config_get_dhcp_client_id, function in NMSettingIP4Config
@@ -5381,7 +4976,7 @@
-nm_setting_ip4_config_new, function in NMSettingIP4Config +nm_setting_ip4_config_new, function in NMSettingIP4Config
@@ -5389,7 +4984,7 @@
-nm_setting_ip6_config_get_ip6_privacy, function in NMSettingIP6Config +nm_setting_ip6_config_get_ip6_privacy, function in NMSettingIP6Config
@@ -5421,7 +5016,7 @@
-nm_setting_ip6_config_new, function in NMSettingIP6Config +nm_setting_ip6_config_new, function in NMSettingIP6Config
@@ -5433,35 +5028,35 @@
-nm_setting_ip_config_add_address, function in NMSettingIPConfig +nm_setting_ip_config_add_address, function in NMSettingIPConfig
-nm_setting_ip_config_add_dns, function in NMSettingIPConfig +nm_setting_ip_config_add_dns, function in NMSettingIPConfig
-nm_setting_ip_config_add_dns_search, function in NMSettingIPConfig +nm_setting_ip_config_add_dns_search, function in NMSettingIPConfig
-nm_setting_ip_config_add_route, function in NMSettingIPConfig +nm_setting_ip_config_add_route, function in NMSettingIPConfig
-nm_setting_ip_config_clear_addresses, function in NMSettingIPConfig +nm_setting_ip_config_clear_addresses, function in NMSettingIPConfig
-nm_setting_ip_config_clear_dns, function in NMSettingIPConfig +nm_setting_ip_config_clear_dns, function in NMSettingIPConfig
-nm_setting_ip_config_clear_dns_searches, function in NMSettingIPConfig +nm_setting_ip_config_clear_dns_searches, function in NMSettingIPConfig
-nm_setting_ip_config_clear_routes, function in NMSettingIPConfig +nm_setting_ip_config_clear_routes, function in NMSettingIPConfig
@@ -5485,71 +5080,71 @@
-nm_setting_ip_config_get_address, function in NMSettingIPConfig +nm_setting_ip_config_get_address, function in NMSettingIPConfig
-nm_setting_ip_config_get_dhcp_hostname, function in NMSettingIPConfig +nm_setting_ip_config_get_dhcp_hostname, function in NMSettingIPConfig
-nm_setting_ip_config_get_dhcp_send_hostname, function in NMSettingIPConfig +nm_setting_ip_config_get_dhcp_send_hostname, function in NMSettingIPConfig
-nm_setting_ip_config_get_dns, function in NMSettingIPConfig +nm_setting_ip_config_get_dns, function in NMSettingIPConfig
-nm_setting_ip_config_get_dns_search, function in NMSettingIPConfig +nm_setting_ip_config_get_dns_search, function in NMSettingIPConfig
-nm_setting_ip_config_get_gateway, function in NMSettingIPConfig +nm_setting_ip_config_get_gateway, function in NMSettingIPConfig
-nm_setting_ip_config_get_ignore_auto_dns, function in NMSettingIPConfig +nm_setting_ip_config_get_ignore_auto_dns, function in NMSettingIPConfig
-nm_setting_ip_config_get_ignore_auto_routes, function in NMSettingIPConfig +nm_setting_ip_config_get_ignore_auto_routes, function in NMSettingIPConfig
-nm_setting_ip_config_get_may_fail, function in NMSettingIPConfig +nm_setting_ip_config_get_may_fail, function in NMSettingIPConfig
-nm_setting_ip_config_get_method, function in NMSettingIPConfig +nm_setting_ip_config_get_method, function in NMSettingIPConfig
-nm_setting_ip_config_get_never_default, function in NMSettingIPConfig +nm_setting_ip_config_get_never_default, function in NMSettingIPConfig
-nm_setting_ip_config_get_num_addresses, function in NMSettingIPConfig +nm_setting_ip_config_get_num_addresses, function in NMSettingIPConfig
-nm_setting_ip_config_get_num_dns, function in NMSettingIPConfig +nm_setting_ip_config_get_num_dns, function in NMSettingIPConfig
-nm_setting_ip_config_get_num_dns_searches, function in NMSettingIPConfig +nm_setting_ip_config_get_num_dns_searches, function in NMSettingIPConfig
-nm_setting_ip_config_get_num_routes, function in NMSettingIPConfig +nm_setting_ip_config_get_num_routes, function in NMSettingIPConfig
-nm_setting_ip_config_get_route, function in NMSettingIPConfig +nm_setting_ip_config_get_route, function in NMSettingIPConfig
-nm_setting_ip_config_get_route_metric, function in NMSettingIPConfig +nm_setting_ip_config_get_route_metric, function in NMSettingIPConfig
@@ -5573,35 +5168,35 @@
-nm_setting_ip_config_remove_address, function in NMSettingIPConfig +nm_setting_ip_config_remove_address, function in NMSettingIPConfig
-nm_setting_ip_config_remove_address_by_value, function in NMSettingIPConfig +nm_setting_ip_config_remove_address_by_value, function in NMSettingIPConfig
-nm_setting_ip_config_remove_dns, function in NMSettingIPConfig +nm_setting_ip_config_remove_dns, function in NMSettingIPConfig
-nm_setting_ip_config_remove_dns_by_value, function in NMSettingIPConfig +nm_setting_ip_config_remove_dns_by_value, function in NMSettingIPConfig
-nm_setting_ip_config_remove_dns_search, function in NMSettingIPConfig +nm_setting_ip_config_remove_dns_search, function in NMSettingIPConfig
-nm_setting_ip_config_remove_dns_search_by_value, function in NMSettingIPConfig +nm_setting_ip_config_remove_dns_search_by_value, function in NMSettingIPConfig
-nm_setting_ip_config_remove_route, function in NMSettingIPConfig +nm_setting_ip_config_remove_route, function in NMSettingIPConfig
-nm_setting_ip_config_remove_route_by_value, function in NMSettingIPConfig +nm_setting_ip_config_remove_route_by_value, function in NMSettingIPConfig
@@ -5613,7 +5208,7 @@
-nm_setting_lookup_type, function in NMSetting +nm_setting_lookup_type, function in NMSetting
@@ -5629,19 +5224,19 @@
-nm_setting_olpc_mesh_get_channel, function in NMSettingOlpcMesh +nm_setting_olpc_mesh_get_channel, function in NMSettingOlpcMesh
-nm_setting_olpc_mesh_get_dhcp_anycast_address, function in NMSettingOlpcMesh +nm_setting_olpc_mesh_get_dhcp_anycast_address, function in NMSettingOlpcMesh
-nm_setting_olpc_mesh_get_ssid, function in NMSettingOlpcMesh +nm_setting_olpc_mesh_get_ssid, function in NMSettingOlpcMesh
-nm_setting_olpc_mesh_new, function in NMSettingOlpcMesh +nm_setting_olpc_mesh_new, function in NMSettingOlpcMesh
@@ -5665,23 +5260,23 @@
-nm_setting_pppoe_get_password, function in NMSettingPppoe +nm_setting_pppoe_get_password, function in NMSettingPppoe
-nm_setting_pppoe_get_password_flags, function in NMSettingPppoe +nm_setting_pppoe_get_password_flags, function in NMSettingPppoe
-nm_setting_pppoe_get_service, function in NMSettingPppoe +nm_setting_pppoe_get_service, function in NMSettingPppoe
-nm_setting_pppoe_get_username, function in NMSettingPppoe +nm_setting_pppoe_get_username, function in NMSettingPppoe
-nm_setting_pppoe_new, function in NMSettingPppoe +nm_setting_pppoe_new, function in NMSettingPppoe
@@ -5713,75 +5308,75 @@
-nm_setting_ppp_get_baud, function in NMSettingPpp +nm_setting_ppp_get_baud, function in NMSettingPpp
-nm_setting_ppp_get_crtscts, function in NMSettingPpp +nm_setting_ppp_get_crtscts, function in NMSettingPpp
-nm_setting_ppp_get_lcp_echo_failure, function in NMSettingPpp +nm_setting_ppp_get_lcp_echo_failure, function in NMSettingPpp
-nm_setting_ppp_get_lcp_echo_interval, function in NMSettingPpp +nm_setting_ppp_get_lcp_echo_interval, function in NMSettingPpp
-nm_setting_ppp_get_mppe_stateful, function in NMSettingPpp +nm_setting_ppp_get_mppe_stateful, function in NMSettingPpp
-nm_setting_ppp_get_mru, function in NMSettingPpp +nm_setting_ppp_get_mru, function in NMSettingPpp
-nm_setting_ppp_get_mtu, function in NMSettingPpp +nm_setting_ppp_get_mtu, function in NMSettingPpp
-nm_setting_ppp_get_noauth, function in NMSettingPpp +nm_setting_ppp_get_noauth, function in NMSettingPpp
-nm_setting_ppp_get_nobsdcomp, function in NMSettingPpp +nm_setting_ppp_get_nobsdcomp, function in NMSettingPpp
-nm_setting_ppp_get_nodeflate, function in NMSettingPpp +nm_setting_ppp_get_nodeflate, function in NMSettingPpp
-nm_setting_ppp_get_no_vj_comp, function in NMSettingPpp +nm_setting_ppp_get_no_vj_comp, function in NMSettingPpp
-nm_setting_ppp_get_refuse_chap, function in NMSettingPpp +nm_setting_ppp_get_refuse_chap, function in NMSettingPpp
-nm_setting_ppp_get_refuse_eap, function in NMSettingPpp +nm_setting_ppp_get_refuse_eap, function in NMSettingPpp
-nm_setting_ppp_get_refuse_mschap, function in NMSettingPpp +nm_setting_ppp_get_refuse_mschap, function in NMSettingPpp
-nm_setting_ppp_get_refuse_mschapv2, function in NMSettingPpp +nm_setting_ppp_get_refuse_mschapv2, function in NMSettingPpp
-nm_setting_ppp_get_refuse_pap, function in NMSettingPpp +nm_setting_ppp_get_refuse_pap, function in NMSettingPpp
-nm_setting_ppp_get_require_mppe, function in NMSettingPpp +nm_setting_ppp_get_require_mppe, function in NMSettingPpp
-nm_setting_ppp_get_require_mppe_128, function in NMSettingPpp +nm_setting_ppp_get_require_mppe_128, function in NMSettingPpp
@@ -5805,7 +5400,7 @@
-nm_setting_ppp_new, function in NMSettingPpp +nm_setting_ppp_new, function in NMSettingPpp
@@ -5865,27 +5460,27 @@
-nm_setting_serial_get_baud, function in NMSettingSerial +nm_setting_serial_get_baud, function in NMSettingSerial
-nm_setting_serial_get_bits, function in NMSettingSerial +nm_setting_serial_get_bits, function in NMSettingSerial
-nm_setting_serial_get_parity, function in NMSettingSerial +nm_setting_serial_get_parity, function in NMSettingSerial
-nm_setting_serial_get_send_delay, function in NMSettingSerial +nm_setting_serial_get_send_delay, function in NMSettingSerial
-nm_setting_serial_get_stopbits, function in NMSettingSerial +nm_setting_serial_get_stopbits, function in NMSettingSerial
-nm_setting_serial_new, function in NMSettingSerial +nm_setting_serial_new, function in NMSettingSerial
@@ -5905,7 +5500,7 @@
-nm_setting_set_secret_flags, function in NMSetting +nm_setting_set_secret_flags, function in NMSetting
@@ -5913,11 +5508,11 @@
-nm_setting_team_get_config, function in NMSettingTeam +nm_setting_team_get_config, function in NMSettingTeam
-nm_setting_team_new, function in NMSettingTeam +nm_setting_team_new, function in NMSettingTeam
@@ -5925,11 +5520,11 @@
-nm_setting_team_port_get_config, function in NMSettingTeamPort +nm_setting_team_port_get_config, function in NMSettingTeamPort
-nm_setting_team_port_new, function in NMSettingTeamPort +nm_setting_team_port_new, function in NMSettingTeamPort
@@ -5941,23 +5536,23 @@
-nm_setting_to_string, function in NMSetting +nm_setting_to_string, function in NMSetting
-nm_setting_verify, function in NMSetting +nm_setting_verify, function in NMSetting
-nm_setting_vlan_add_priority, function in NMSettingVlan +nm_setting_vlan_add_priority, function in NMSettingVlan
-nm_setting_vlan_add_priority_str, function in NMSettingVlan +nm_setting_vlan_add_priority_str, function in NMSettingVlan
-nm_setting_vlan_clear_priorities, function in NMSettingVlan +nm_setting_vlan_clear_priorities, function in NMSettingVlan
@@ -5969,23 +5564,23 @@
-nm_setting_vlan_get_flags, function in NMSettingVlan +nm_setting_vlan_get_flags, function in NMSettingVlan
-nm_setting_vlan_get_id, function in NMSettingVlan +nm_setting_vlan_get_id, function in NMSettingVlan
-nm_setting_vlan_get_num_priorities, function in NMSettingVlan +nm_setting_vlan_get_num_priorities, function in NMSettingVlan
-nm_setting_vlan_get_parent, function in NMSettingVlan +nm_setting_vlan_get_parent, function in NMSettingVlan
-nm_setting_vlan_get_priority, function in NMSettingVlan +nm_setting_vlan_get_priority, function in NMSettingVlan
@@ -5997,7 +5592,7 @@
-nm_setting_vlan_new, function in NMSettingVlan +nm_setting_vlan_new, function in NMSettingVlan
@@ -6005,15 +5600,15 @@
-nm_setting_vlan_remove_priority, function in NMSettingVlan +nm_setting_vlan_remove_priority, function in NMSettingVlan
-nm_setting_vlan_remove_priority_by_value, function in NMSettingVlan +nm_setting_vlan_remove_priority_by_value, function in NMSettingVlan
-nm_setting_vlan_remove_priority_str_by_value, function in NMSettingVlan +nm_setting_vlan_remove_priority_str_by_value, function in NMSettingVlan
@@ -6021,11 +5616,11 @@
-nm_setting_vpn_add_data_item, function in NMSettingVpn +nm_setting_vpn_add_data_item, function in NMSettingVpn
-nm_setting_vpn_add_secret, function in NMSettingVpn +nm_setting_vpn_add_secret, function in NMSettingVpn
@@ -6033,43 +5628,43 @@
-nm_setting_vpn_foreach_data_item, function in NMSettingVpn +nm_setting_vpn_foreach_data_item, function in NMSettingVpn
-nm_setting_vpn_foreach_secret, function in NMSettingVpn +nm_setting_vpn_foreach_secret, function in NMSettingVpn
-nm_setting_vpn_get_data_item, function in NMSettingVpn +nm_setting_vpn_get_data_item, function in NMSettingVpn
-nm_setting_vpn_get_num_data_items, function in NMSettingVpn +nm_setting_vpn_get_num_data_items, function in NMSettingVpn
-nm_setting_vpn_get_num_secrets, function in NMSettingVpn +nm_setting_vpn_get_num_secrets, function in NMSettingVpn
-nm_setting_vpn_get_persistent, function in NMSettingVpn +nm_setting_vpn_get_persistent, function in NMSettingVpn
-nm_setting_vpn_get_secret, function in NMSettingVpn +nm_setting_vpn_get_secret, function in NMSettingVpn
-nm_setting_vpn_get_service_type, function in NMSettingVpn +nm_setting_vpn_get_service_type, function in NMSettingVpn
-nm_setting_vpn_get_user_name, function in NMSettingVpn +nm_setting_vpn_get_user_name, function in NMSettingVpn
-nm_setting_vpn_new, function in NMSettingVpn +nm_setting_vpn_new, function in NMSettingVpn
@@ -6077,11 +5672,11 @@
-nm_setting_vpn_remove_data_item, function in NMSettingVpn +nm_setting_vpn_remove_data_item, function in NMSettingVpn
-nm_setting_vpn_remove_secret, function in NMSettingVpn +nm_setting_vpn_remove_secret, function in NMSettingVpn
@@ -6101,11 +5696,11 @@
-nm_setting_wimax_get_mac_address, function in NMSettingWimax +nm_setting_wimax_get_mac_address, function in NMSettingWimax
-nm_setting_wimax_get_network_name, function in NMSettingWimax +nm_setting_wimax_get_network_name, function in NMSettingWimax
@@ -6117,7 +5712,7 @@
-nm_setting_wimax_new, function in NMSettingWimax +nm_setting_wimax_new, function in NMSettingWimax
@@ -6125,11 +5720,11 @@
-nm_setting_wired_add_mac_blacklist_item, function in NMSettingWired +nm_setting_wired_add_mac_blacklist_item, function in NMSettingWired
-nm_setting_wired_add_s390_option, function in NMSettingWired +nm_setting_wired_add_s390_option, function in NMSettingWired
@@ -6137,7 +5732,7 @@
-nm_setting_wired_clear_mac_blacklist_items, function in NMSettingWired +nm_setting_wired_clear_mac_blacklist_items, function in NMSettingWired
@@ -6149,67 +5744,67 @@
-nm_setting_wired_get_auto_negotiate, function in NMSettingWired +nm_setting_wired_get_auto_negotiate, function in NMSettingWired
-nm_setting_wired_get_cloned_mac_address, function in NMSettingWired +nm_setting_wired_get_cloned_mac_address, function in NMSettingWired
-nm_setting_wired_get_duplex, function in NMSettingWired +nm_setting_wired_get_duplex, function in NMSettingWired
-nm_setting_wired_get_mac_address, function in NMSettingWired +nm_setting_wired_get_mac_address, function in NMSettingWired
-nm_setting_wired_get_mac_address_blacklist, function in NMSettingWired +nm_setting_wired_get_mac_address_blacklist, function in NMSettingWired
-nm_setting_wired_get_mac_blacklist_item, function in NMSettingWired +nm_setting_wired_get_mac_blacklist_item, function in NMSettingWired
-nm_setting_wired_get_mtu, function in NMSettingWired +nm_setting_wired_get_mtu, function in NMSettingWired
-nm_setting_wired_get_num_mac_blacklist_items, function in NMSettingWired +nm_setting_wired_get_num_mac_blacklist_items, function in NMSettingWired
-nm_setting_wired_get_num_s390_options, function in NMSettingWired +nm_setting_wired_get_num_s390_options, function in NMSettingWired
-nm_setting_wired_get_port, function in NMSettingWired +nm_setting_wired_get_port, function in NMSettingWired
-nm_setting_wired_get_s390_nettype, function in NMSettingWired +nm_setting_wired_get_s390_nettype, function in NMSettingWired
-nm_setting_wired_get_s390_option, function in NMSettingWired +nm_setting_wired_get_s390_option, function in NMSettingWired
-nm_setting_wired_get_s390_option_by_key, function in NMSettingWired +nm_setting_wired_get_s390_option_by_key, function in NMSettingWired
-nm_setting_wired_get_s390_subchannels, function in NMSettingWired +nm_setting_wired_get_s390_subchannels, function in NMSettingWired
-nm_setting_wired_get_speed, function in NMSettingWired +nm_setting_wired_get_speed, function in NMSettingWired
-nm_setting_wired_get_valid_s390_options, function in NMSettingWired +nm_setting_wired_get_valid_s390_options, function in NMSettingWired
@@ -6225,7 +5820,7 @@
-nm_setting_wired_new, function in NMSettingWired +nm_setting_wired_new, function in NMSettingWired
@@ -6233,15 +5828,15 @@
-nm_setting_wired_remove_mac_blacklist_item, function in NMSettingWired +nm_setting_wired_remove_mac_blacklist_item, function in NMSettingWired
-nm_setting_wired_remove_mac_blacklist_item_by_value, function in NMSettingWired +nm_setting_wired_remove_mac_blacklist_item_by_value, function in NMSettingWired
-nm_setting_wired_remove_s390_option, function in NMSettingWired +nm_setting_wired_remove_s390_option, function in NMSettingWired
@@ -6265,15 +5860,15 @@
-nm_setting_wireless_add_mac_blacklist_item, function in NMSettingWireless +nm_setting_wireless_add_mac_blacklist_item, function in NMSettingWireless
-nm_setting_wireless_add_seen_bssid, function in NMSettingWireless +nm_setting_wireless_add_seen_bssid, function in NMSettingWireless
-nm_setting_wireless_ap_security_compatible, function in NMSettingWireless +nm_setting_wireless_ap_security_compatible, function in NMSettingWireless
@@ -6289,7 +5884,7 @@
-nm_setting_wireless_clear_mac_blacklist_items, function in NMSettingWireless +nm_setting_wireless_clear_mac_blacklist_items, function in NMSettingWireless
@@ -6297,67 +5892,67 @@
-nm_setting_wireless_get_band, function in NMSettingWireless +nm_setting_wireless_get_band, function in NMSettingWireless
-nm_setting_wireless_get_bssid, function in NMSettingWireless +nm_setting_wireless_get_bssid, function in NMSettingWireless
-nm_setting_wireless_get_channel, function in NMSettingWireless +nm_setting_wireless_get_channel, function in NMSettingWireless
-nm_setting_wireless_get_cloned_mac_address, function in NMSettingWireless +nm_setting_wireless_get_cloned_mac_address, function in NMSettingWireless
-nm_setting_wireless_get_hidden, function in NMSettingWireless +nm_setting_wireless_get_hidden, function in NMSettingWireless
-nm_setting_wireless_get_mac_address, function in NMSettingWireless +nm_setting_wireless_get_mac_address, function in NMSettingWireless
-nm_setting_wireless_get_mac_address_blacklist, function in NMSettingWireless +nm_setting_wireless_get_mac_address_blacklist, function in NMSettingWireless
-nm_setting_wireless_get_mac_blacklist_item, function in NMSettingWireless +nm_setting_wireless_get_mac_blacklist_item, function in NMSettingWireless
-nm_setting_wireless_get_mode, function in NMSettingWireless +nm_setting_wireless_get_mode, function in NMSettingWireless
-nm_setting_wireless_get_mtu, function in NMSettingWireless +nm_setting_wireless_get_mtu, function in NMSettingWireless
-nm_setting_wireless_get_num_mac_blacklist_items, function in NMSettingWireless +nm_setting_wireless_get_num_mac_blacklist_items, function in NMSettingWireless
-nm_setting_wireless_get_num_seen_bssids, function in NMSettingWireless +nm_setting_wireless_get_num_seen_bssids, function in NMSettingWireless
-nm_setting_wireless_get_rate, function in NMSettingWireless +nm_setting_wireless_get_rate, function in NMSettingWireless
-nm_setting_wireless_get_seen_bssid, function in NMSettingWireless +nm_setting_wireless_get_seen_bssid, function in NMSettingWireless
-nm_setting_wireless_get_ssid, function in NMSettingWireless +nm_setting_wireless_get_ssid, function in NMSettingWireless
-nm_setting_wireless_get_tx_power, function in NMSettingWireless +nm_setting_wireless_get_tx_power, function in NMSettingWireless
@@ -6393,7 +5988,7 @@
-nm_setting_wireless_new, function in NMSettingWireless +nm_setting_wireless_new, function in NMSettingWireless
@@ -6401,23 +5996,23 @@
-nm_setting_wireless_remove_mac_blacklist_item, function in NMSettingWireless +nm_setting_wireless_remove_mac_blacklist_item, function in NMSettingWireless
-nm_setting_wireless_remove_mac_blacklist_item_by_value, function in NMSettingWireless +nm_setting_wireless_remove_mac_blacklist_item_by_value, function in NMSettingWireless
-nm_setting_wireless_security_add_group, function in NMSettingWirelessSecurity +nm_setting_wireless_security_add_group, function in NMSettingWirelessSecurity
-nm_setting_wireless_security_add_pairwise, function in NMSettingWirelessSecurity +nm_setting_wireless_security_add_pairwise, function in NMSettingWirelessSecurity
-nm_setting_wireless_security_add_proto, function in NMSettingWirelessSecurity +nm_setting_wireless_security_add_proto, function in NMSettingWirelessSecurity
@@ -6425,83 +6020,83 @@
-nm_setting_wireless_security_clear_groups, function in NMSettingWirelessSecurity +nm_setting_wireless_security_clear_groups, function in NMSettingWirelessSecurity
-nm_setting_wireless_security_clear_pairwise, function in NMSettingWirelessSecurity +nm_setting_wireless_security_clear_pairwise, function in NMSettingWirelessSecurity
-nm_setting_wireless_security_clear_protos, function in NMSettingWirelessSecurity +nm_setting_wireless_security_clear_protos, function in NMSettingWirelessSecurity
-nm_setting_wireless_security_get_auth_alg, function in NMSettingWirelessSecurity +nm_setting_wireless_security_get_auth_alg, function in NMSettingWirelessSecurity
-nm_setting_wireless_security_get_group, function in NMSettingWirelessSecurity +nm_setting_wireless_security_get_group, function in NMSettingWirelessSecurity
-nm_setting_wireless_security_get_key_mgmt, function in NMSettingWirelessSecurity +nm_setting_wireless_security_get_key_mgmt, function in NMSettingWirelessSecurity
-nm_setting_wireless_security_get_leap_password, function in NMSettingWirelessSecurity +nm_setting_wireless_security_get_leap_password, function in NMSettingWirelessSecurity
-nm_setting_wireless_security_get_leap_password_flags, function in NMSettingWirelessSecurity +nm_setting_wireless_security_get_leap_password_flags, function in NMSettingWirelessSecurity
-nm_setting_wireless_security_get_leap_username, function in NMSettingWirelessSecurity +nm_setting_wireless_security_get_leap_username, function in NMSettingWirelessSecurity
-nm_setting_wireless_security_get_num_groups, function in NMSettingWirelessSecurity +nm_setting_wireless_security_get_num_groups, function in NMSettingWirelessSecurity
-nm_setting_wireless_security_get_num_pairwise, function in NMSettingWirelessSecurity +nm_setting_wireless_security_get_num_pairwise, function in NMSettingWirelessSecurity
-nm_setting_wireless_security_get_num_protos, function in NMSettingWirelessSecurity +nm_setting_wireless_security_get_num_protos, function in NMSettingWirelessSecurity
-nm_setting_wireless_security_get_pairwise, function in NMSettingWirelessSecurity +nm_setting_wireless_security_get_pairwise, function in NMSettingWirelessSecurity
-nm_setting_wireless_security_get_proto, function in NMSettingWirelessSecurity +nm_setting_wireless_security_get_proto, function in NMSettingWirelessSecurity
-nm_setting_wireless_security_get_psk, function in NMSettingWirelessSecurity +nm_setting_wireless_security_get_psk, function in NMSettingWirelessSecurity
-nm_setting_wireless_security_get_psk_flags, function in NMSettingWirelessSecurity +nm_setting_wireless_security_get_psk_flags, function in NMSettingWirelessSecurity
-nm_setting_wireless_security_get_wep_key, function in NMSettingWirelessSecurity +nm_setting_wireless_security_get_wep_key, function in NMSettingWirelessSecurity
-nm_setting_wireless_security_get_wep_key_flags, function in NMSettingWirelessSecurity +nm_setting_wireless_security_get_wep_key_flags, function in NMSettingWirelessSecurity
-nm_setting_wireless_security_get_wep_key_type, function in NMSettingWirelessSecurity +nm_setting_wireless_security_get_wep_key_type, function in NMSettingWirelessSecurity
-nm_setting_wireless_security_get_wep_tx_keyidx, function in NMSettingWirelessSecurity +nm_setting_wireless_security_get_wep_tx_keyidx, function in NMSettingWirelessSecurity
@@ -6525,7 +6120,7 @@
-nm_setting_wireless_security_new, function in NMSettingWirelessSecurity +nm_setting_wireless_security_new, function in NMSettingWirelessSecurity
@@ -6545,27 +6140,27 @@
-nm_setting_wireless_security_remove_group, function in NMSettingWirelessSecurity +nm_setting_wireless_security_remove_group, function in NMSettingWirelessSecurity
-nm_setting_wireless_security_remove_group_by_value, function in NMSettingWirelessSecurity +nm_setting_wireless_security_remove_group_by_value, function in NMSettingWirelessSecurity
-nm_setting_wireless_security_remove_pairwise, function in NMSettingWirelessSecurity +nm_setting_wireless_security_remove_pairwise, function in NMSettingWirelessSecurity
-nm_setting_wireless_security_remove_pairwise_by_value, function in NMSettingWirelessSecurity +nm_setting_wireless_security_remove_pairwise_by_value, function in NMSettingWirelessSecurity
-nm_setting_wireless_security_remove_proto, function in NMSettingWirelessSecurity +nm_setting_wireless_security_remove_proto, function in NMSettingWirelessSecurity
-nm_setting_wireless_security_remove_proto_by_value, function in NMSettingWirelessSecurity +nm_setting_wireless_security_remove_proto_by_value, function in NMSettingWirelessSecurity
@@ -6573,7 +6168,7 @@
-nm_setting_wireless_security_set_wep_key, function in NMSettingWirelessSecurity +nm_setting_wireless_security_set_wep_key, function in NMSettingWirelessSecurity
@@ -6621,88 +6216,80 @@
-NMSimpleConnection, struct in NMSimpleConnection -
-
-
-NMSimpleConnectionClass, struct in NMSimpleConnection -
-
-
-nm_simple_connection_new, function in NMSimpleConnection +nm_simple_connection_new, function in NMSimpleConnection
-nm_simple_connection_new_clone, function in NMSimpleConnection +nm_simple_connection_new_clone, function in NMSimpleConnection
-nm_simple_connection_new_from_dbus, function in NMSimpleConnection +nm_simple_connection_new_from_dbus, function in NMSimpleConnection
-NMState, enum in nm-dbus-interface +NMState, enum in nm-dbus-interface

U

-NMUtilsFileSearchInPathsPredicate, user_function in nm-utils +NMUtilsFileSearchInPathsPredicate, user_function in nm-utils
-NMUtilsSecurityType, enum in nm-utils +NMUtilsSecurityType, enum in nm-utils
-nm_utils_ap_mode_security_valid, function in nm-utils +nm_utils_ap_mode_security_valid, function in nm-utils
-nm_utils_bin2hexstr, function in nm-utils +nm_utils_bin2hexstr, function in nm-utils
-nm_utils_check_virtual_device_compatibility, function in nm-utils +nm_utils_check_virtual_device_compatibility, function in nm-utils
-nm_utils_escape_ssid, function in nm-utils +nm_utils_escape_ssid, function in nm-utils
-nm_utils_file_is_certificate, function in nm-utils +nm_utils_file_is_certificate, function in nm-utils
-nm_utils_file_is_pkcs12, function in nm-utils +nm_utils_file_is_pkcs12, function in nm-utils
-nm_utils_file_is_private_key, function in nm-utils +nm_utils_file_is_private_key, function in nm-utils
-nm_utils_file_search_in_paths, function in nm-utils +nm_utils_file_search_in_paths, function in nm-utils
-nm_utils_hexstr2bin, function in nm-utils +nm_utils_hexstr2bin, function in nm-utils
-nm_utils_hwaddr_atoba, function in nm-utils +nm_utils_hwaddr_atoba, function in nm-utils
-nm_utils_hwaddr_aton, function in nm-utils +nm_utils_hwaddr_aton, function in nm-utils
-nm_utils_hwaddr_canonical, function in nm-utils +nm_utils_hwaddr_canonical, function in nm-utils
-nm_utils_hwaddr_len, function in nm-utils +nm_utils_hwaddr_len, function in nm-utils
@@ -6710,27 +6297,27 @@
-nm_utils_hwaddr_matches, function in nm-utils +nm_utils_hwaddr_matches, function in nm-utils
-nm_utils_hwaddr_ntoa, function in nm-utils +nm_utils_hwaddr_ntoa, function in nm-utils
-nm_utils_hwaddr_valid, function in nm-utils +nm_utils_hwaddr_valid, function in nm-utils
-nm_utils_iface_valid_name, function in nm-utils +nm_utils_iface_valid_name, function in nm-utils
-nm_utils_inet4_ntop, function in nm-utils +nm_utils_inet4_ntop, function in nm-utils
-nm_utils_inet6_ntop, function in nm-utils +nm_utils_inet6_ntop, function in nm-utils
@@ -6738,135 +6325,135 @@
-nm_utils_ip4_addresses_from_variant, function in nm-utils +nm_utils_ip4_addresses_from_variant, function in nm-utils
-nm_utils_ip4_addresses_to_variant, function in nm-utils +nm_utils_ip4_addresses_to_variant, function in nm-utils
-nm_utils_ip4_dns_from_variant, function in nm-utils +nm_utils_ip4_dns_from_variant, function in nm-utils
-nm_utils_ip4_dns_to_variant, function in nm-utils +nm_utils_ip4_dns_to_variant, function in nm-utils
-nm_utils_ip4_get_default_prefix, function in nm-utils +nm_utils_ip4_get_default_prefix, function in nm-utils
-nm_utils_ip4_netmask_to_prefix, function in nm-utils +nm_utils_ip4_netmask_to_prefix, function in nm-utils
-nm_utils_ip4_prefix_to_netmask, function in nm-utils +nm_utils_ip4_prefix_to_netmask, function in nm-utils
-nm_utils_ip4_routes_from_variant, function in nm-utils +nm_utils_ip4_routes_from_variant, function in nm-utils
-nm_utils_ip4_routes_to_variant, function in nm-utils +nm_utils_ip4_routes_to_variant, function in nm-utils
-nm_utils_ip6_addresses_from_variant, function in nm-utils +nm_utils_ip6_addresses_from_variant, function in nm-utils
-nm_utils_ip6_addresses_to_variant, function in nm-utils +nm_utils_ip6_addresses_to_variant, function in nm-utils
-nm_utils_ip6_dns_from_variant, function in nm-utils +nm_utils_ip6_dns_from_variant, function in nm-utils
-nm_utils_ip6_dns_to_variant, function in nm-utils +nm_utils_ip6_dns_to_variant, function in nm-utils
-nm_utils_ip6_routes_from_variant, function in nm-utils +nm_utils_ip6_routes_from_variant, function in nm-utils
-nm_utils_ip6_routes_to_variant, function in nm-utils +nm_utils_ip6_routes_to_variant, function in nm-utils
-nm_utils_ipaddr_valid, function in nm-utils +nm_utils_ipaddr_valid, function in nm-utils
-nm_utils_ip_addresses_from_variant, function in nm-utils +nm_utils_ip_addresses_from_variant, function in nm-utils
-nm_utils_ip_addresses_to_variant, function in nm-utils +nm_utils_ip_addresses_to_variant, function in nm-utils
-nm_utils_ip_routes_from_variant, function in nm-utils +nm_utils_ip_routes_from_variant, function in nm-utils
-nm_utils_ip_routes_to_variant, function in nm-utils +nm_utils_ip_routes_to_variant, function in nm-utils
-nm_utils_is_empty_ssid, function in nm-utils +nm_utils_is_empty_ssid, function in nm-utils
-nm_utils_is_uuid, function in nm-utils +nm_utils_is_uuid, function in nm-utils
-nm_utils_same_ssid, function in nm-utils +nm_utils_same_ssid, function in nm-utils
-nm_utils_security_valid, function in nm-utils +nm_utils_security_valid, function in nm-utils
-nm_utils_ssid_to_utf8, function in nm-utils +nm_utils_ssid_to_utf8, function in nm-utils
-nm_utils_uuid_generate, function in nm-utils +nm_utils_uuid_generate, function in nm-utils
-nm_utils_wep_key_valid, function in nm-utils +nm_utils_wep_key_valid, function in nm-utils
-nm_utils_wifi_channel_to_freq, function in nm-utils +nm_utils_wifi_channel_to_freq, function in nm-utils
-nm_utils_wifi_find_next_channel, function in nm-utils +nm_utils_wifi_find_next_channel, function in nm-utils
-nm_utils_wifi_freq_to_channel, function in nm-utils +nm_utils_wifi_freq_to_channel, function in nm-utils
-nm_utils_wifi_is_channel_valid, function in nm-utils +nm_utils_wifi_is_channel_valid, function in nm-utils
-nm_utils_wifi_strength_bars, function in nm-utils +nm_utils_wifi_strength_bars, function in nm-utils
-nm_utils_wpa_psk_valid, function in nm-utils +nm_utils_wpa_psk_valid, function in nm-utils

V

@@ -6903,71 +6490,79 @@
-NMVlanFlags, enum in NMSettingVlan +NMVlanFlags, enum in NMSettingVlan +
+
+
+NMVlanPriorityMap, enum in NMSettingVlan
-NMVlanPriorityMap, enum in NMSettingVlan +NMVpnConnection::vpn-state-changed, object signal in NMVpnConnection
-NMVpnConnection, struct in NMVpnConnection +NMVpnConnection:banner, object property in NMVpnConnection
-NMVpnConnection::vpn-state-changed, object signal in NMVpnConnection +NMVpnConnection:vpn-state, object property in NMVpnConnection
-NMVpnConnection:banner, object property in NMVpnConnection +NMVpnConnectionState, enum in nm-vpn-dbus-interface
-NMVpnConnection:vpn-state, object property in NMVpnConnection +NMVpnConnectionStateReason, enum in nm-vpn-dbus-interface
-NMVpnConnectionClass, struct in NMVpnConnection +NMVpnEditor::changed, object signal in NMVpnEditor
-NMVpnConnectionState, enum in nm-vpn-dbus-interface +NMVpnEditorInterface, struct in NMVpnEditor
-NMVpnConnectionStateReason, enum in nm-vpn-dbus-interface +NMVpnEditorPlugin:description, object property in NMVpnEditor
-NMVpnEditorInterface, struct in NMVpnEditorPlugin +NMVpnEditorPlugin:name, object property in NMVpnEditor
-NMVpnEditorPluginCapability, enum in NMVpnEditorPlugin +NMVpnEditorPlugin:service, object property in NMVpnEditor
-NMVpnEditorPluginFactory, user_function in NMVpnEditorPlugin +NMVpnEditorPluginCapability, enum in NMVpnEditor
-NMVpnEditorPluginInterface, struct in NMVpnEditorPlugin +NMVpnEditorPluginFactory, user_function in NMVpnEditor
-NMVpnIterFunc, user_function in NMSettingVpn +NMVpnEditorPluginInterface, struct in NMVpnEditor
-NMVpnPluginError, enum in nm-errors +NMVpnIterFunc, user_function in NMSettingVpn
-NMVpnPluginFailure, enum in nm-vpn-dbus-interface +NMVpnPluginError, enum in nm-errors
-NMVpnServiceState, enum in nm-vpn-dbus-interface +NMVpnPluginFailure, enum in nm-vpn-dbus-interface +
+
+
+NMVpnServiceState, enum in nm-vpn-dbus-interface
@@ -6975,11 +6570,11 @@
-nm_vpn_connection_get_banner, function in NMVpnConnection +nm_vpn_connection_get_banner, function in NMVpnConnection
-nm_vpn_connection_get_vpn_state, function in NMVpnConnection +nm_vpn_connection_get_vpn_state, function in NMVpnConnection
@@ -6995,47 +6590,47 @@
-nm_vpn_editor_get_widget, function in NMVpnEditorPlugin +nm_vpn_editor_get_widget, function in NMVpnEditor
-NM_VPN_EDITOR_PLUGIN_DESCRIPTION, macro in NMVpnEditorPlugin +NM_VPN_EDITOR_PLUGIN_DESCRIPTION, macro in NMVpnEditor
-nm_vpn_editor_plugin_export, function in NMVpnEditorPlugin +nm_vpn_editor_plugin_export, function in NMVpnEditor
-nm_vpn_editor_plugin_factory, function in NMVpnEditorPlugin +nm_vpn_editor_plugin_factory, function in NMVpnEditor
-nm_vpn_editor_plugin_get_capabilities, function in NMVpnEditorPlugin +nm_vpn_editor_plugin_get_capabilities, function in NMVpnEditor
-nm_vpn_editor_plugin_get_editor, function in NMVpnEditorPlugin +nm_vpn_editor_plugin_get_editor, function in NMVpnEditor
-nm_vpn_editor_plugin_get_suggested_filename, function in NMVpnEditorPlugin +nm_vpn_editor_plugin_get_suggested_filename, function in NMVpnEditor
-nm_vpn_editor_plugin_import, function in NMVpnEditorPlugin +nm_vpn_editor_plugin_import, function in NMVpnEditor
-NM_VPN_EDITOR_PLUGIN_NAME, macro in NMVpnEditorPlugin +NM_VPN_EDITOR_PLUGIN_NAME, macro in NMVpnEditor
-NM_VPN_EDITOR_PLUGIN_SERVICE, macro in NMVpnEditorPlugin +NM_VPN_EDITOR_PLUGIN_SERVICE, macro in NMVpnEditor
-nm_vpn_editor_update_connection, function in NMVpnEditorPlugin +nm_vpn_editor_update_connection, function in NMVpnEditor
@@ -7071,7 +6666,7 @@
-nm_vpn_plugin_error_quark, function in nm-errors +nm_vpn_plugin_error_quark, function in nm-errors
@@ -7180,51 +6775,43 @@

W

-NMWepKeyType, enum in NMSettingWirelessSecurity -
-
-
-NMWimaxNsp, struct in NMWimaxNsp -
-
-
-NMWimaxNsp:name, object property in NMWimaxNsp +NMWepKeyType, enum in NMSettingWirelessSecurity
-NMWimaxNsp:network-type, object property in NMWimaxNsp +NMWimaxNsp:name, object property in NMWimaxNsp
-NMWimaxNsp:signal-quality, object property in NMWimaxNsp +NMWimaxNsp:network-type, object property in NMWimaxNsp
-NMWimaxNspClass, struct in NMWimaxNsp +NMWimaxNsp:signal-quality, object property in NMWimaxNsp
-NMWimaxNspNetworkType, enum in NMWimaxNsp +NMWimaxNspNetworkType, enum in NMWimaxNsp
-nm_wimax_nsp_connection_valid, function in NMWimaxNsp +nm_wimax_nsp_connection_valid, function in NMWimaxNsp
-nm_wimax_nsp_filter_connections, function in NMWimaxNsp +nm_wimax_nsp_filter_connections, function in NMWimaxNsp
-nm_wimax_nsp_get_name, function in NMWimaxNsp +nm_wimax_nsp_get_name, function in NMWimaxNsp
-nm_wimax_nsp_get_network_type, function in NMWimaxNsp +nm_wimax_nsp_get_network_type, function in NMWimaxNsp
-nm_wimax_nsp_get_signal_quality, function in NMWimaxNsp +nm_wimax_nsp_get_signal_quality, function in NMWimaxNsp
@@ -7242,6 +6829,6 @@
+ Generated by GTK-Doc V1.21 \ No newline at end of file diff --git a/docs/libnm/html/ch02.html b/docs/libnm/html/ch02.html index ba5f8372..8275cbd8 100644 --- a/docs/libnm/html/ch02.html +++ b/docs/libnm/html/ch02.html @@ -2,22 +2,22 @@ -Client Object API Reference +libnm Reference Manual: Client Object API Reference - + - - - - - - + + + + + +

@@ -42,6 +42,6 @@

+ Generated by GTK-Doc V1.21
\ No newline at end of file diff --git a/docs/libnm/html/ch03.html b/docs/libnm/html/ch03.html index 022ba785..5a52fb4c 100644 --- a/docs/libnm/html/ch03.html +++ b/docs/libnm/html/ch03.html @@ -2,22 +2,22 @@ -Connection and Setting API Reference +libnm Reference Manual: Connection and Setting API Reference - + - - - - - - + + + + + +

@@ -121,6 +121,6 @@ use WEP, LEAP, WPA or WPA2/RSN security

+ Generated by GTK-Doc V1.21
\ No newline at end of file diff --git a/docs/libnm/html/ch04.html b/docs/libnm/html/ch04.html index 0053b1bd..851d3f2b 100644 --- a/docs/libnm/html/ch04.html +++ b/docs/libnm/html/ch04.html @@ -2,22 +2,22 @@ -Device and Runtime Configuration API Reference +libnm Reference Manual: Device and Runtime Configuration API Reference - + - - - - - - + + + + + +

@@ -90,6 +90,6 @@

+ Generated by GTK-Doc V1.21
\ No newline at end of file diff --git a/docs/libnm/html/ch05.html b/docs/libnm/html/ch05.html index e54a51fe..08ddd5cc 100644 --- a/docs/libnm/html/ch05.html +++ b/docs/libnm/html/ch05.html @@ -2,22 +2,22 @@ -Utility API Reference +libnm Reference Manual: Utility API Reference - + - - - - - - + + + + + +

@@ -33,6 +33,6 @@

+ Generated by GTK-Doc V1.21
\ No newline at end of file diff --git a/docs/libnm/html/ch06.html b/docs/libnm/html/ch06.html index e8925722..4e2d3dc4 100644 --- a/docs/libnm/html/ch06.html +++ b/docs/libnm/html/ch06.html @@ -2,22 +2,22 @@ -VPN Plugin API Reference +libnm Reference Manual: VPN Plugin API Reference - + - - - - - - + + + + + +
+ Generated by GTK-Doc V1.21
\ No newline at end of file diff --git a/docs/libnm/html/home.png b/docs/libnm/html/home.png index 17003611..9346b336 100644 Binary files a/docs/libnm/html/home.png and b/docs/libnm/html/home.png differ diff --git a/docs/libnm/html/index.html b/docs/libnm/html/index.html index 8597a0f8..8affed8e 100644 --- a/docs/libnm/html/index.html +++ b/docs/libnm/html/index.html @@ -2,11 +2,11 @@ -libnm Reference Manual +libnm Reference Manual: libnm Reference Manual - + @@ -15,7 +15,7 @@

- for libnm 1.0.0 + for libnm 1.0.2 The latest version of this documentation can be found on-line at https://developer.gnome.org/libnm/1.0/. @@ -244,7 +244,7 @@ use WEP, LEAP, WPA or WPA2/RSN security nm-vpn-dbus-interface

-NMVpnEditorPlugin +NMVpnEditor
Object Hierarchy
@@ -254,6 +254,6 @@ use WEP, LEAP, WPA or WPA2/RSN security
+ Generated by GTK-Doc V1.21
\ No newline at end of file diff --git a/docs/libnm/html/index.sgml b/docs/libnm/html/index.sgml index 20ed7794..ebd23df0 100644 --- a/docs/libnm/html/index.sgml +++ b/docs/libnm/html/index.sgml @@ -1,66 +1,13 @@ - - - - - - + + + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + - - @@ -114,6 +61,35 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + @@ -141,21 +117,15 @@ - - - + + + - - - - - - + - @@ -166,147 +136,68 @@ + + + + + - - - + + + - + + + - - - - - - - - - - - - + + - - - - - - - - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + - - - - - - - - - - - - - - - - + - + + @@ -347,195 +238,31 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + - - + + - - - - - - + - - - - - @@ -585,94 +312,61 @@ + + + + + + + + - + - - - - + + - - - - - + + + - + - - - - - - - - - - - - - - - - - - - - - - - - + + + + + + - - + + + - - - - - - - - - - - - - - - - - - - - - + @@ -698,6 +392,26 @@ + + + + + + + + + + + + + + + + + + + + @@ -714,57 +428,12 @@ - - - - + + + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + @@ -833,45 +502,91 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - - + + + - + + + + + + + + + + @@ -885,16 +600,6 @@ - - - - - - - - - - @@ -904,30 +609,41 @@ - - + + + - + + + + + - - - - - - - + + + - + + + + + + + + + + + @@ -945,35 +661,15 @@ - - - - - - - - - - - - - + + + - - - - - - - - - - - + @@ -982,6 +678,15 @@ + + + + + + + + + @@ -991,80 +696,55 @@ - - + + + - - - - - - - + + + + + + - - + + + - - - - - - - - + + + + + + + - - - + + + - - - - - - - - - - - - - - - - - - - - - - - - - - + @@ -1087,6 +767,26 @@ + + + + + + + + + + + + + + + + + + + + @@ -1104,32 +804,21 @@ - + + - - - - + + + - - + + + - - - - - - - - - - - - - + @@ -1140,6 +829,17 @@ + + + + + + + + + + + @@ -1151,19 +851,12 @@ - - + + + - - - - - - - - - + @@ -1171,6 +864,13 @@ + + + + + + + @@ -1178,14 +878,15 @@ - + + + - + - - + @@ -1202,7 +903,6 @@ - @@ -1225,21 +925,6 @@ - - - - - - - - - - - - - - - @@ -1273,6 +958,20 @@ + + + + + + + + + + + + + + @@ -1289,11 +988,15 @@ - - + + + - + + + + @@ -1301,19 +1004,18 @@ - - - - - - - + + + - + + + + @@ -1322,64 +1024,36 @@ - - - - - - - - - + - - + + + - - - - - - - + + + + + + - - + + + - - - - - - - - - - - - - - - - - - - - - - + @@ -1399,6 +1073,26 @@ + + + + + + + + + + + + + + + + + + + + @@ -1419,53 +1113,49 @@ - - + + + - - - - - - - - + + + + + + + - - - + + + - - - - - - - - - - - - - + + + + + + + + + @@ -1473,56 +1163,40 @@ - - + + + - - - - - + + + + - - + + + - - - - - + + + + - - - - + + + - - - - - - - - - - - - - - - - + @@ -1535,6 +1209,15 @@ + + + + + + + + + @@ -1542,19 +1225,12 @@ - - + + + - - - - - - - - - + @@ -1570,6 +1246,13 @@ + + + + + + + @@ -1577,42 +1260,29 @@ - - + + + - - - - - - + + + + + - - + + + - - - - - - - - - - - - - - - + @@ -1636,6 +1306,19 @@ + + + + + + + + + + + + + @@ -1649,30 +1332,12 @@ - - + + + - - - - - - - - - - - - - - - - - - - - + @@ -1696,6 +1361,24 @@ + + + + + + + + + + + + + + + + + + @@ -1711,37 +1394,12 @@ - - - + + + - - - - - - - - - - - - - - - - - - - - - - - - - - + @@ -1773,6 +1431,26 @@ + + + + + + + + + + + + + + + + + + + + @@ -1792,38 +1470,13 @@ - - - + + + - - - - - - - - - - - - - - - - - - - - - - - - - - + @@ -1863,6 +1516,30 @@ + + + + + + + + + + + + + + + + + + + + + + + + @@ -1890,221 +1567,201 @@ - - - + + + - - - - + + + - - - + + + - - - - - - + + + + + - - - + + + - - - - - - + + + + + - - - + + + - - - - - - + + + + + - - - + + + - - - - - - - + + + + + + - - - + + + - + + + - - - - - - + + + - - - - - + + + + - - - + + + - - - - - + + + + - - - + + + - - - - - - + + + + + - - - + + + - - - - - - + + + + + - - - + + + - - - - - - - + + + + + + - - - + + + - - - - - - - - - - + @@ -2116,6 +1773,14 @@ + + + + + + + + @@ -2128,23 +1793,13 @@ - - - + + + - - - - - - - - - - - + @@ -2154,6 +1809,15 @@ + + + + + + + + + @@ -2167,29 +1831,12 @@ - - - + + + - - - - - - - - - - - - - - - - - - + @@ -2205,6 +1852,22 @@ + + + + + + + + + + + + + + + + @@ -2222,37 +1885,30 @@ - - - + + + - - - - - + + + + - - - + + + - - - - - - - + @@ -2267,28 +1923,21 @@ + + + + + - - - + + + - - - - - - - - - - - - - + @@ -2300,6 +1949,17 @@ + + + + + + + + + + + @@ -2312,49 +1972,33 @@ - - - - + + + - - - - - - - - - - - + + + + + + - - - + + + - - - - - - - - - - - + @@ -2363,6 +2007,15 @@ + + + + + + + + + @@ -2373,42 +2026,31 @@ - - - + + + - - - - - + + + + - - + + - + - - - - - - - - - - @@ -2443,7 +2085,6 @@ - @@ -2455,15 +2096,19 @@ - + + + + - + + - + @@ -2472,25 +2117,23 @@ - - - - + + + + + - - - - - + - + + @@ -2516,40 +2159,10 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + + @@ -2583,31 +2196,37 @@ - - - - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/docs/libnm/html/left-insensitive.png b/docs/libnm/html/left-insensitive.png new file mode 100644 index 00000000..3269393a Binary files /dev/null and b/docs/libnm/html/left-insensitive.png differ diff --git a/docs/libnm/html/left.png b/docs/libnm/html/left.png index 2d05b3d5..2abde032 100644 Binary files a/docs/libnm/html/left.png and b/docs/libnm/html/left.png differ diff --git a/docs/libnm/html/libnm-NMConnection.html b/docs/libnm/html/libnm-NMConnection.html index 46e2ba75..3ff7a3b6 100644 --- a/docs/libnm/html/libnm-NMConnection.html +++ b/docs/libnm/html/libnm-NMConnection.html @@ -2,32 +2,27 @@ -NMConnection +libnm Reference Manual: NMConnection - + - - - - - - - - - - + + + + + + +
@@ -35,1834 +30,2326 @@

NMConnection

NMConnection — Describes a connection to specific network or provider

- +
-
-

Synopsis

-
#define             NM_CONNECTION_SECRETS_UPDATED
-#define             NM_CONNECTION_SECRETS_CLEARED
-#define             NM_CONNECTION_CHANGED
-#define             NM_CONNECTION_NORMALIZE_PARAM_IP6_CONFIG_METHOD
-                    NMConnectionInterface;
-void                nm_connection_add_setting           (NMConnection *connection,
-                                                         NMSetting *setting);
-void                nm_connection_remove_setting        (NMConnection *connection,
-                                                         GType setting_type);
-NMSetting *         nm_connection_get_setting           (NMConnection *connection,
-                                                         GType setting_type);
-NMSetting *         nm_connection_get_setting_by_name   (NMConnection *connection,
-                                                         const char *name);
-#define             NM_VARIANT_TYPE_SETTING
-enum                NMConnectionSerializationFlags;
-GVariant *          nm_connection_to_dbus               (NMConnection *connection,
-                                                         NMConnectionSerializationFlags flags);
-gboolean            nm_connection_replace_settings      (NMConnection *connection,
-                                                         GVariant *new_settings,
-                                                         GError **error);
-void                nm_connection_replace_settings_from_connection
-                                                        (NMConnection *connection,
-                                                         NMConnection *new_connection);
-void                nm_connection_clear_settings        (NMConnection *connection);
-gboolean            nm_connection_compare               (NMConnection *a,
-                                                         NMConnection *b,
-                                                         NMSettingCompareFlags flags);
-gboolean            nm_connection_diff                  (NMConnection *a,
-                                                         NMConnection *b,
-                                                         NMSettingCompareFlags flags,
-                                                         GHashTable **out_settings);
-gboolean            nm_connection_verify                (NMConnection *connection,
-                                                         GError **error);
-gboolean            nm_connection_normalize             (NMConnection *connection,
-                                                         GHashTable *parameters,
-                                                         gboolean *modified,
-                                                         GError **error);
-const char *        nm_connection_need_secrets          (NMConnection *connection,
-                                                         GPtrArray **hints);
-void                nm_connection_clear_secrets         (NMConnection *connection);
-void                nm_connection_clear_secrets_with_flags
-                                                        (NMConnection *connection,
-                                                         NMSettingClearSecretsWithFlagsFn func,
-                                                         gpointer user_data);
-gboolean            nm_connection_update_secrets        (NMConnection *connection,
-                                                         const char *setting_name,
-                                                         GVariant *secrets,
-                                                         GError **error);
-void                nm_connection_set_path              (NMConnection *connection,
-                                                         const char *path);
-const char *        nm_connection_get_path              (NMConnection *connection);
-const char *        nm_connection_get_interface_name    (NMConnection *connection);
-gboolean            nm_connection_is_type               (NMConnection *connection,
-                                                         const char *type);
-void                nm_connection_for_each_setting_value
-                                                        (NMConnection *connection,
-                                                         NMSettingValueIterFn func,
-                                                         gpointer user_data);
-void                nm_connection_dump                  (NMConnection *connection);
-const char *        nm_connection_get_uuid              (NMConnection *connection);
-const char *        nm_connection_get_id                (NMConnection *connection);
-const char *        nm_connection_get_connection_type   (NMConnection *connection);
-gboolean            nm_connection_is_virtual            (NMConnection *connection);
-char *              nm_connection_get_virtual_device_description
-                                                        (NMConnection *connection);
-NMSetting8021x *    nm_connection_get_setting_802_1x    (NMConnection *connection);
-NMSettingBluetooth * nm_connection_get_setting_bluetooth
-                                                        (NMConnection *connection);
-NMSettingBond *     nm_connection_get_setting_bond      (NMConnection *connection);
-NMSettingTeam *     nm_connection_get_setting_team      (NMConnection *connection);
-NMSettingTeamPort * nm_connection_get_setting_team_port (NMConnection *connection);
-NMSettingBridge *   nm_connection_get_setting_bridge    (NMConnection *connection);
-NMSettingBridgePort * nm_connection_get_setting_bridge_port
-                                                        (NMConnection *connection);
-NMSettingCdma *     nm_connection_get_setting_cdma      (NMConnection *connection);
-NMSettingConnection * nm_connection_get_setting_connection
-                                                        (NMConnection *connection);
-NMSettingDcb *      nm_connection_get_setting_dcb       (NMConnection *connection);
-NMSettingGeneric *  nm_connection_get_setting_generic   (NMConnection *connection);
-NMSettingGsm *      nm_connection_get_setting_gsm       (NMConnection *connection);
-NMSettingInfiniband * nm_connection_get_setting_infiniband
-                                                        (NMConnection *connection);
-NMSettingIPConfig * nm_connection_get_setting_ip4_config
-                                                        (NMConnection *connection);
-NMSettingIPConfig * nm_connection_get_setting_ip6_config
-                                                        (NMConnection *connection);
-NMSettingOlpcMesh * nm_connection_get_setting_olpc_mesh (NMConnection *connection);
-NMSettingPpp *      nm_connection_get_setting_ppp       (NMConnection *connection);
-NMSettingPppoe *    nm_connection_get_setting_pppoe     (NMConnection *connection);
-NMSettingSerial *   nm_connection_get_setting_serial    (NMConnection *connection);
-NMSettingVpn *      nm_connection_get_setting_vpn       (NMConnection *connection);
-NMSettingWimax *    nm_connection_get_setting_wimax     (NMConnection *connection);
-NMSettingAdsl *     nm_connection_get_setting_adsl      (NMConnection *connection);
-NMSettingWired *    nm_connection_get_setting_wired     (NMConnection *connection);
-NMSettingWireless * nm_connection_get_setting_wireless  (NMConnection *connection);
-NMSettingWirelessSecurity * nm_connection_get_setting_wireless_security
-                                                        (NMConnection *connection);
-NMSettingVlan *     nm_connection_get_setting_vlan      (NMConnection *connection);
-
-
-
-

Object Hierarchy

-
-  GFlags
-   +----NMConnectionSerializationFlags
-
-
-

Description

-

-An NMConnection describes all the settings and configuration values that -are necessary to configure network devices for operation on a specific -network. Connections are the fundamental operating object for -NetworkManager; no device is connected without a NMConnection, or -disconnected without having been connected with a NMConnection. -

-

-Each NMConnection contains a list of NMSetting objects usually referenced -by name (using nm_connection_get_setting_by_name()) or by type (with -nm_connection_get_setting()). The settings describe the actual parameters -with which the network devices are configured, including device-specific -parameters (MTU, SSID, APN, channel, rate, etc) and IP-level parameters -(addresses, routes, addressing methods, etc). -

-
-
-

Details

-
-

NM_CONNECTION_SECRETS_UPDATED

-
#define NM_CONNECTION_SECRETS_UPDATED "secrets-updated"
-
-

-

-
-
-
-

NM_CONNECTION_SECRETS_CLEARED

-
#define NM_CONNECTION_SECRETS_CLEARED "secrets-cleared"
-
-

-

-
-
-
-

NM_CONNECTION_CHANGED

-
#define NM_CONNECTION_CHANGED         "changed"
-
-

-

-
-
-
-

NM_CONNECTION_NORMALIZE_PARAM_IP6_CONFIG_METHOD

-
#define NM_CONNECTION_NORMALIZE_PARAM_IP6_CONFIG_METHOD "ip6-config-method"
-
-

-

-
-
-
-

NMConnectionInterface

-
typedef struct {
-	GTypeInterface parent;
-
-	/* Signals */
-	void (*secrets_updated) (NMConnection *connection,
-	                         const char   *setting);
-	void (*secrets_cleared) (NMConnection *connection);
-	void (*changed)         (NMConnection *connection);
-} NMConnectionInterface;
-
-
+

Functions

+
--++ - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - - + + - - + + - - + +

GTypeInterface parent;

the parent interace struct +void + +nm_connection_add_setting () +
+void + +nm_connection_remove_setting () +
+NMSetting * + +nm_connection_get_setting () +
+NMSetting * + +nm_connection_get_setting_by_name () +
+GVariant * + +nm_connection_to_dbus () +
+gboolean + +nm_connection_replace_settings () +
+void + +nm_connection_replace_settings_from_connection () +
+void + +nm_connection_clear_settings () +
+gboolean + +nm_connection_compare () +
+gboolean + +nm_connection_diff () +
+gboolean + +nm_connection_verify () +
+gboolean + +nm_connection_normalize () +
const char * + +nm_connection_need_secrets () +
+void + +nm_connection_clear_secrets () +
+void + +nm_connection_clear_secrets_with_flags () +
+gboolean + +nm_connection_update_secrets () +
+void + +nm_connection_set_path () +
const char * + +nm_connection_get_path () +
const char * + +nm_connection_get_interface_name () +
+gboolean + +nm_connection_is_type () +
+void + +nm_connection_for_each_setting_value () +
+void + +nm_connection_dump () +
const char * + +nm_connection_get_uuid () +
const char * + +nm_connection_get_id () +
const char * + +nm_connection_get_connection_type () +
+gboolean + +nm_connection_is_virtual () +
+char * + +nm_connection_get_virtual_device_description () +
+NMSetting8021x * + +nm_connection_get_setting_802_1x () +
+NMSettingBluetooth * + +nm_connection_get_setting_bluetooth () +
+NMSettingBond * + +nm_connection_get_setting_bond () +
+NMSettingTeam * + +nm_connection_get_setting_team () +
+NMSettingTeamPort * + +nm_connection_get_setting_team_port () +
+NMSettingBridge * + +nm_connection_get_setting_bridge () +
+NMSettingBridgePort * + +nm_connection_get_setting_bridge_port () +
+NMSettingCdma * + +nm_connection_get_setting_cdma () +
+NMSettingConnection * + +nm_connection_get_setting_connection () +
+NMSettingDcb * + +nm_connection_get_setting_dcb () +
+NMSettingGeneric * + +nm_connection_get_setting_generic () +
+NMSettingGsm * + +nm_connection_get_setting_gsm () +
+NMSettingInfiniband * + +nm_connection_get_setting_infiniband () +
+NMSettingIPConfig * + +nm_connection_get_setting_ip4_config () +
+NMSettingIPConfig * + +nm_connection_get_setting_ip6_config () +
+NMSettingOlpcMesh * + +nm_connection_get_setting_olpc_mesh () +
+NMSettingPpp * + +nm_connection_get_setting_ppp () +
+NMSettingPppoe * + +nm_connection_get_setting_pppoe () +
+NMSettingSerial * + +nm_connection_get_setting_serial () +
+NMSettingVpn * + +nm_connection_get_setting_vpn () +
+NMSettingWimax * + +nm_connection_get_setting_wimax () +
+NMSettingAdsl * + +nm_connection_get_setting_adsl () +
+NMSettingWired * + +nm_connection_get_setting_wired () +

secrets_updated ()

emitted when the connection's secrets are updated +NMSettingWireless * + +nm_connection_get_setting_wireless () +

secrets_cleared ()

emitted when the connection's secrets are cleared +NMSettingWirelessSecurity * + +nm_connection_get_setting_wireless_security () +

changed ()

emitted when any change to the connection's settings occurs +NMSettingVlan * + +nm_connection_get_setting_vlan () +
-
-
-

nm_connection_add_setting ()

-
void                nm_connection_add_setting           (NMConnection *connection,
-                                                         NMSetting *setting);
-

-Adds a NMSetting to the connection, replacing any previous NMSetting of the -same name which has previously been added to the NMConnection. The -connection takes ownership of the NMSetting object and does not increase -the setting object's reference count. -

-
+
+

Types and Values

+
--++ - - + + - - + + + + + + + + + + + + + + + + + + + + + +

connection :

a NMConnection -#defineNM_CONNECTION_SECRETS_UPDATED

setting :

the NMSetting to add to the connection object. [transfer full] -#defineNM_CONNECTION_SECRETS_CLEARED
#defineNM_CONNECTION_CHANGED
#defineNM_CONNECTION_NORMALIZE_PARAM_IP6_CONFIG_METHOD
 NMConnectionInterface
#defineNM_VARIANT_TYPE_SETTING
enumNMConnectionSerializationFlags
-
+
+

Object Hierarchy

+
    GFlags
+    ╰── NMConnectionSerializationFlags
+
+
+
+

Description

+

An NMConnection describes all the settings and configuration values that +are necessary to configure network devices for operation on a specific +network. Connections are the fundamental operating object for +NetworkManager; no device is connected without a NMConnection, or +disconnected without having been connected with a NMConnection.

+

Each NMConnection contains a list of NMSetting objects usually referenced +by name (using nm_connection_get_setting_by_name()) or by type (with +nm_connection_get_setting()). The settings describe the actual parameters +with which the network devices are configured, including device-specific +parameters (MTU, SSID, APN, channel, rate, etc) and IP-level parameters +(addresses, routes, addressing methods, etc).

+
+
+

Functions

-

nm_connection_remove_setting ()

-
void                nm_connection_remove_setting        (NMConnection *connection,
-                                                         GType setting_type);
-

-Removes the NMSetting with the given GType from the NMConnection. This -operation dereferences the NMSetting object. -

-
+

nm_connection_add_setting ()

+
void
+nm_connection_add_setting (NMConnection *connection,
+                           NMSetting *setting);
+

Adds a NMSetting to the connection, replacing any previous NMSetting of the +same name which has previously been added to the NMConnection. The +connection takes ownership of the NMSetting object and does not increase +the setting object's reference count.

+
+

Parameters

+
--+++ - - + + + - - + + +

connection :

a NMConnection -

connection

a NMConnection

 

setting_type :

the GType of the setting object to remove

setting

the NMSetting to add to the connection object.

[transfer full]
+

-

nm_connection_get_setting ()

-
NMSetting *         nm_connection_get_setting           (NMConnection *connection,
-                                                         GType setting_type);
-

-Gets the NMSetting with the given GType, if one has been previously added -to the NMConnection. -

-
+

nm_connection_remove_setting ()

+
void
+nm_connection_remove_setting (NMConnection *connection,
+                              GType setting_type);
+

Removes the NMSetting with the given GType from the NMConnection. This +operation dereferences the NMSetting object.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + +

connection :

a NMConnection -

setting_type :

the GType of the setting object to return

connection

a NMConnection

 

Returns :

the NMSetting, or NULL if no setting of that type was previously -added to the NMConnection. [transfer none] -

setting_type

the GType of the setting object to remove

 
+

-

nm_connection_get_setting_by_name ()

-
NMSetting *         nm_connection_get_setting_by_name   (NMConnection *connection,
-                                                         const char *name);
-

-Gets the NMSetting with the given name, if one has been previously added -the NMConnection. -

-
+

nm_connection_get_setting ()

+
NMSetting *
+nm_connection_get_setting (NMConnection *connection,
+                           GType setting_type);
+

Gets the NMSetting with the given GType, if one has been previously added +to the NMConnection.

+
+

Parameters

+
--+++ - - + + + - - - - - - + + +

connection :

a NMConnection -

connection

a NMConnection

 

name :

a setting name

Returns :

the NMSetting, or NULL if no setting with that name was previously -added to the NMConnection. [transfer none] -

setting_type

the GType of the setting object to return

 
-
-
-

NM_VARIANT_TYPE_SETTING

-
#define NM_VARIANT_TYPE_SETTING G_VARIANT_TYPE_VARDICT
-
-

-GVariantType for a dictionary mapping from property names to values. This is -an alias for G_VARIANT_TYPE_VARDICT, and is the type of each element of -an NM_VARIANT_TYPE_CONNECTION dictionary. -

+
+

Returns

+

the NMSetting, or NULL if no setting of that type was previously +added to the NMConnection.

+

[transfer none]

+

-

enum NMConnectionSerializationFlags

-
typedef enum {
- /*< flags >*/
-	NM_CONNECTION_SERIALIZE_ALL = 0x00000000,
-	NM_CONNECTION_SERIALIZE_NO_SECRETS = 0x00000001,
-	NM_CONNECTION_SERIALIZE_ONLY_SECRETS = 0x00000002,
-} NMConnectionSerializationFlags;
-
-

-These flags determine which properties are serialized when calling when -calling nm_connection_to_dbus(). -

-
+

nm_connection_get_setting_by_name ()

+
NMSetting *
+nm_connection_get_setting_by_name (NMConnection *connection,
+                                   const char *name);
+

Gets the NMSetting with the given name, if one has been previously added +the NMConnection.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + +

NM_CONNECTION_SERIALIZE_ALL

serialize all properties (including secrets) -

NM_CONNECTION_SERIALIZE_NO_SECRETS

do not include secrets -

connection

a NMConnection

 

NM_CONNECTION_SERIALIZE_ONLY_SECRETS

only serialize secrets -

name

a setting name

 
+
+

Returns

+

the NMSetting, or NULL if no setting with that name was previously +added to the NMConnection.

+

[transfer none]

+
+

-

nm_connection_to_dbus ()

-
GVariant *          nm_connection_to_dbus               (NMConnection *connection,
-                                                         NMConnectionSerializationFlags flags);
-

-Converts the NMConnection into a GVariant of type +

nm_connection_to_dbus ()

+
GVariant *
+nm_connection_to_dbus (NMConnection *connection,
+                       NMConnectionSerializationFlags flags);
+

Converts the NMConnection into a GVariant of type NM_VARIANT_TYPE_CONNECTION describing the connection, suitable for -marshalling over D-Bus or otherwise serializing. -

-
+marshalling over D-Bus or otherwise serializing.

+
+

Parameters

+
--+++ - - + + + - - - - - - + + +

connection :

the NMConnection -

connection

the NMConnection

 

flags :

serialization flags, e.g. NM_CONNECTION_SERIALIZE_ALL -

Returns :

a new floating GVariant describing the connection, -its settings, and each setting's properties. [transfer none] -

flags

serialization flags, e.g. NM_CONNECTION_SERIALIZE_ALL

 
+
+

Returns

+

a new floating GVariant describing the connection, +its settings, and each setting's properties.

+

[transfer none]

+
+

-

nm_connection_replace_settings ()

-
gboolean            nm_connection_replace_settings      (NMConnection *connection,
-                                                         GVariant *new_settings,
-                                                         GError **error);
-

-Replaces connection's settings with new_settings (which must be +

nm_connection_replace_settings ()

+
gboolean
+nm_connection_replace_settings (NMConnection *connection,
+                                GVariant *new_settings,
+                                GError **error);
+

Replaces connection +'s settings with new_settings + (which must be syntactically valid, and describe a known type of connection, but does not -need to result in a connection that passes nm_connection_verify()). -

-
+need to result in a connection that passes nm_connection_verify()).

+
+

Parameters

+
--+++ - - - - - - + + + - - + + + - - + + +

connection :

a NMConnection -

new_settings :

a GVariant of type NM_VARIANT_TYPE_CONNECTION, with the new settings

connection

a NMConnection

 

error :

location to store error, or NULL -

new_settings

a GVariant of type NM_VARIANT_TYPE_CONNECTION, with the new settings

 

Returns :

-TRUE if connection was updated, FALSE if new_settings could not -be deserialized (in which case connection will be unchanged).

error

location to store error, or NULL

 
+
+

Returns

+

TRUE if connection was updated, FALSE if new_settings +could not +be deserialized (in which case connection +will be unchanged).

+

+
+

-

nm_connection_replace_settings_from_connection ()

-
void                nm_connection_replace_settings_from_connection
-                                                        (NMConnection *connection,
-                                                         NMConnection *new_connection);
-

-Deep-copies the settings of new_connection and replaces the settings of connection -with the copied settings. -

-
+

nm_connection_replace_settings_from_connection ()

+
void
+nm_connection_replace_settings_from_connection
+                               (NMConnection *connection,
+                                NMConnection *new_connection);
+

Deep-copies the settings of new_connection + and replaces the settings of connection + +with the copied settings.

+
+

Parameters

+
--+++ - - + + + - - + + +

connection :

a NMConnection -

connection

a NMConnection

 

new_connection :

a NMConnection to replace the settings of connection with

new_connection

a NMConnection to replace the settings of connection +with

 
+

-

nm_connection_clear_settings ()

-
void                nm_connection_clear_settings        (NMConnection *connection);
-

-Deletes all of connection's settings. -

-
+

nm_connection_clear_settings ()

+
void
+nm_connection_clear_settings (NMConnection *connection);
+

Deletes all of connection +'s settings.

+
+

Parameters

+
--+++ - - + + +

connection :

a NMConnection -

connection

a NMConnection

 
+

-

nm_connection_compare ()

-
gboolean            nm_connection_compare               (NMConnection *a,
-                                                         NMConnection *b,
-                                                         NMSettingCompareFlags flags);
-

-Compares two NMConnection objects for similarity, with comparison behavior -modified by a set of flags. See nm_setting_compare() for a description of -each flag's behavior. -

-
+

nm_connection_compare ()

+
gboolean
+nm_connection_compare (NMConnection *a,
+                       NMConnection *b,
+                       NMSettingCompareFlags flags);
+

Compares two NMConnection objects for similarity, with comparison behavior +modified by a set of flags. See nm_setting_compare() for a description of +each flag's behavior.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + + - - + + +

a :

a NMConnection -

b :

a second NMConnection to compare with the first

a

a NMConnection

 

flags :

compare flags, e.g. NM_SETTING_COMPARE_FLAG_EXACT -

b

a second NMConnection to compare with the first

 

Returns :

-TRUE if the comparison succeeds, FALSE if it does not

flags

compare flags, e.g. NM_SETTING_COMPARE_FLAG_EXACT

 
+
+

Returns

+

TRUE if the comparison succeeds, FALSE if it does not

+

+
+

-

nm_connection_diff ()

-
gboolean            nm_connection_diff                  (NMConnection *a,
-                                                         NMConnection *b,
-                                                         NMSettingCompareFlags flags,
-                                                         GHashTable **out_settings);
-

-Compares two NMConnection objects for similarity, with comparison behavior -modified by a set of flags. See nm_setting_compare() for a description of +

nm_connection_diff ()

+
gboolean
+nm_connection_diff (NMConnection *a,
+                    NMConnection *b,
+                    NMSettingCompareFlags flags,
+                    GHashTable **out_settings);
+

Compares two NMConnection objects for similarity, with comparison behavior +modified by a set of flags. See nm_setting_compare() for a description of each flag's behavior. If the connections differ, settings and keys within -each setting that differ are added to the returned out_settings hash table. -No values are returned, only key names. -

-
+each setting that differ are added to the returned out_settings + hash table. +No values are returned, only key names.

+
+

Parameters

+
--+++ - - + + + - - + + + - - + + + - - + - - - - +differ mapped to one or more of NMSettingDiffResult as a bitfield.

+

a :

a NMConnection -

a

a NMConnection

 

b :

a second NMConnection to compare with the first

b

a second NMConnection to compare with the first

 

flags :

compare flags, e.g. NM_SETTING_COMPARE_FLAG_EXACT -

flags

compare flags, e.g. NM_SETTING_COMPARE_FLAG_EXACT

 

out_settings :

if the +

out_settings

if the connections differ, on return a hash table mapping setting names to second-level GHashTable (utf8 to guint32), which contains the key names that -differ mapped to one or more of NMSettingDiffResult as a bitfield. [element-type utf8 GLib.HashTable] -

Returns :

-TRUE if the connections contain the same values, FALSE if they do -not[element-type utf8 GLib.HashTable]
+
+

Returns

+

TRUE if the connections contain the same values, FALSE if they do +not

+

+
+

-

nm_connection_verify ()

-
gboolean            nm_connection_verify                (NMConnection *connection,
-                                                         GError **error);
-

-Validates the connection and all its settings. Each setting's properties +

nm_connection_verify ()

+
gboolean
+nm_connection_verify (NMConnection *connection,
+                      GError **error);
+

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

-
+MAC address. The returned GError contains information about which +setting and which property failed validation, and how it failed validation.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + +

connection :

the NMConnection to verify

error :

location to store error, or NULL -

connection

the NMConnection to verify

 

Returns :

-TRUE if the connection is valid, FALSE if it is not

error

location to store error, or NULL

 
+
+

Returns

+

TRUE if the connection is valid, FALSE if it is not

+

+
+

-

nm_connection_normalize ()

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

-Does some basic normalization and fixup of well known inconsistencies +

nm_connection_normalize ()

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

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

-

-Finally the connection will be verified and TRUE returns if the connection +the output parameter modified + is set TRUE.

+

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

-
+cannot be normalized, the connection will not be modified.

+
+

Parameters

+
--+++ - - + + + - - + - - - - +used. The keys must be strings, hashed by g_str_hash() and g_str_equal() functions. +The values are opaque and depend on the parameter name.

+ - - + + + - - + + +

connection :

the NMConnection to normalize

connection

the NMConnection to normalize

 

parameters :

a GHashTable with +

parameters

a GHashTable with normalization parameters to allow customization of the normalization by providing specific arguments. Unknown arguments will be ignored and the default will be -used. The keys must be strings, hashed by g_str_hash() and g_str_equal() functions. -The values are opaque and depend on the parameter name. [allow-none][element-type utf8 gpointer] -

modified :

outputs whether any settings were modified. [out][allow-none] -[allow-none][element-type utf8 gpointer]

error :

location to store error, or NULL. Contains the reason, -why the connection is invalid, if the function returns an error.

modified

outputs whether any settings were modified.

[out][allow-none]

Returns :

-TRUE if the connection is valid, FALSE if it is not

error

location to store error, or NULL. Contains the reason, +why the connection is invalid, if the function returns an error.

 
+
+

Returns

+

TRUE if the connection is valid, FALSE if it is not

+

+
+

-

nm_connection_need_secrets ()

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

-Returns the name of the first setting object in the connection which would +

nm_connection_need_secrets ()

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

Returns the name of the first setting object in the connection which would need secrets to make a successful connection. The returned hints are only intended as a guide to what secrets may be required, because in some circumstances, there is no way to conclusively determine exactly which -secrets are needed. -

-
+secrets are needed.

+
+

Parameters

+
--+++ - - + + + - - + - - - - +and must free the array itself with g_ptr_array_free(), but not free its +elements.

+

connection :

the NMConnection -

connection

the NMConnection

 

hints :

the address of a pointer to a GPtrArray, initialized to NULL, which on -return points to an allocated GPtrArray containing the property names of +

hints

the address of a pointer to a GPtrArray, initialized to NULL, which on +return points to an allocated GPtrArray containing the property names of secrets of the NMSetting which may be required; the caller owns the array -and must free the array itself with g_ptr_array_free(), but not free its -elements. [out][element-type utf8][allow-none][transfer container] -

Returns :

the setting name of the NMSetting object which has invalid or -missing secrets[out][element-type utf8][allow-none][transfer container]
+
+

Returns

+

the setting name of the NMSetting object which has invalid or +missing secrets

+

+
+

-

nm_connection_clear_secrets ()

-
void                nm_connection_clear_secrets         (NMConnection *connection);
-

-Clears and frees any secrets that may be stored in the connection, to avoid -keeping secret data in memory when not needed. -

-
+

nm_connection_clear_secrets ()

+
void
+nm_connection_clear_secrets (NMConnection *connection);
+

Clears and frees any secrets that may be stored in the connection, to avoid +keeping secret data in memory when not needed.

+
+

Parameters

+
--+++ - - + + +

connection :

the NMConnection -

connection

the NMConnection

 
+
-

nm_connection_clear_secrets_with_flags ()

-
void                nm_connection_clear_secrets_with_flags
-                                                        (NMConnection *connection,
-                                                         NMSettingClearSecretsWithFlagsFn func,
-                                                         gpointer user_data);
-

-Clears and frees secrets determined by func. -

-
+

nm_connection_clear_secrets_with_flags ()

+
void
+nm_connection_clear_secrets_with_flags
+                               (NMConnection *connection,
+                                NMSettingClearSecretsWithFlagsFn func,
+                                gpointer user_data);
+

Clears and frees secrets determined by func +.

+
+

Parameters

+
--+++ - - + + + - - + + + - - + + +

connection :

the NMConnection -

connection

the NMConnection

 

func :

function to be called to determine whether a -specific secret should be cleared or not. [scope call] -

func

function to be called to determine whether a +specific secret should be cleared or not.

[scope call]

user_data :

caller-supplied data passed to func -

user_data

caller-supplied data passed to func +

 
+
-

nm_connection_update_secrets ()

-
gboolean            nm_connection_update_secrets        (NMConnection *connection,
-                                                         const char *setting_name,
-                                                         GVariant *secrets,
-                                                         GError **error);
-

-Update the specified setting's secrets, given a dictionary of secrets +

nm_connection_update_secrets ()

+
gboolean
+nm_connection_update_secrets (NMConnection *connection,
+                              const char *setting_name,
+                              GVariant *secrets,
+                              GError **error);
+

Update the specified setting's secrets, given a dictionary of secrets intended for that setting (deserialized from D-Bus for example). Will also extract the given setting's secrets hash if given a connection dictionary. -If setting_name is NULL, expects a fully serialized NMConnection as -returned by nm_connection_to_dbus() and will update all secrets from all -settings contained in secrets. -

-
+If setting_name + is NULL, expects a fully serialized NMConnection as +returned by nm_connection_to_dbus() and will update all secrets from all +settings contained in secrets +.

+
+

Parameters

+
--+++ - - + + + - - + + + - - + + + - - - - - - + + +

connection :

the NMConnection -

connection

the NMConnection

 

setting_name :

the setting object name to which the secrets apply

setting_name

the setting object name to which the secrets apply

 

secrets :

a GVariant of secrets, of type NM_VARIANT_TYPE_CONNECTION -or NM_VARIANT_TYPE_SETTING -

secrets

a GVariant of secrets, of type NM_VARIANT_TYPE_CONNECTION +or NM_VARIANT_TYPE_SETTING

 

error :

location to store error, or NULL -

Returns :

-TRUE if the secrets were successfully updated, FALSE if the update -failed (tried to update secrets for a setting that doesn't exist, etc)

error

location to store error, or NULL

 
+
+

Returns

+

TRUE if the secrets were successfully updated, FALSE if the update +failed (tried to update secrets for a setting that doesn't exist, etc)

+

+
+
-

nm_connection_set_path ()

-
void                nm_connection_set_path              (NMConnection *connection,
-                                                         const char *path);
-

-Sets the D-Bus path of the connection. This property is not serialized, and -is only for the reference of the caller. Sets the "path" -property. -

-
+

nm_connection_set_path ()

+
void
+nm_connection_set_path (NMConnection *connection,
+                        const char *path);
+

Sets the D-Bus path of the connection. This property is not serialized, and +is only for the reference of the caller. Sets the “path” +property.

+
+

Parameters

+
--+++ - - + + + - - + + +

connection :

the NMConnection -

connection

the NMConnection

 

path :

the D-Bus path of the connection as given by the settings service -which provides the connection

path

the D-Bus path of the connection as given by the settings service +which provides the connection

 
+
-

nm_connection_get_path ()

-
const char *        nm_connection_get_path              (NMConnection *connection);
-

-Returns the connection's D-Bus path. -

-
+

nm_connection_get_path ()

+
const char *
+nm_connection_get_path (NMConnection *connection);
+

Returns the connection's D-Bus path.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

connection :

the NMConnection -

Returns :

the D-Bus path of the connection, previously set by a call to -nm_connection_set_path().

connection

the NMConnection

 
+
+

Returns

+

the D-Bus path of the connection, previously set by a call to +nm_connection_set_path().

+

+
+
-

nm_connection_get_interface_name ()

-
const char *        nm_connection_get_interface_name    (NMConnection *connection);
-

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

-

-For hardware devices and software devices created outside of NetworkManager, +

nm_connection_get_interface_name ()

+
const char *
+nm_connection_get_interface_name (NMConnection *connection);
+

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

+

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

-
+NetworkManager, this is the name of the created interface.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

connection :

The NMConnection -

Returns :

Name of the kernel interface or NULL -

connection

The NMConnection

 
+
+

Returns

+

Name of the kernel interface or NULL

+

+
+
-

nm_connection_is_type ()

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

-A convenience function to check if the given connection is a particular -type (ie wired, Wi-Fi, ppp, etc). Checks the "type" -property of the connection and matches that against type. -

-
+

nm_connection_is_type ()

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

A convenience function to check if the given connection + is a particular +type (ie wired, Wi-Fi, ppp, etc). Checks the “type” +property of the connection and matches that against type +.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + +

connection :

the NMConnection -

type :

a setting name to check the connection's type against (like -NM_SETTING_WIRELESS_SETTING_NAME or NM_SETTING_WIRED_SETTING_NAME)

connection

the NMConnection

 

Returns :

-TRUE if the connection is of the given type, FALSE if not

type

a setting name to check the connection's type against (like +NM_SETTING_WIRELESS_SETTING_NAME or NM_SETTING_WIRED_SETTING_NAME)

 
+
+

Returns

+

TRUE if the connection is of the given type +, FALSE if not

+

+
+
-

nm_connection_for_each_setting_value ()

-
void                nm_connection_for_each_setting_value
-                                                        (NMConnection *connection,
-                                                         NMSettingValueIterFn func,
-                                                         gpointer user_data);
-

-Iterates over the properties of each NMSetting object in the NMConnection, -calling the supplied user function for each property. -

-
+

nm_connection_for_each_setting_value ()

+
void
+nm_connection_for_each_setting_value (NMConnection *connection,
+                                      NMSettingValueIterFn func,
+                                      gpointer user_data);
+

Iterates over the properties of each NMSetting object in the NMConnection, +calling the supplied user function for each property.

+
+

Parameters

+
--+++ - - + + + - - + + + - - + + +

connection :

the NMConnection -

connection

the NMConnection

 

func :

user-supplied function called for each setting's property. [scope call] -

func

user-supplied function called for each setting's property.

[scope call]

user_data :

user data passed to func at each invocation

user_data

user data passed to func +at each invocation

 
+
-

nm_connection_dump ()

-
void                nm_connection_dump                  (NMConnection *connection);
-

-Print the connection to stdout. For debugging purposes ONLY, should NOT +

nm_connection_dump ()

+
void
+nm_connection_dump (NMConnection *connection);
+

Print the connection to stdout. For debugging purposes ONLY, should NOT be used for serialization of the connection or machine-parsed in any way. The -output format is not guaranteed to be stable and may change at any time. -

-
+output format is not guaranteed to be stable and may change at any time.

+
+

Parameters

+
--+++ - - + + +

connection :

the NMConnection -

connection

the NMConnection

 
+
-

nm_connection_get_uuid ()

-
const char *        nm_connection_get_uuid              (NMConnection *connection);
-

-A shortcut to return the UUID from the connection's NMSettingConnection. -

-
+

nm_connection_get_uuid ()

+
const char *
+nm_connection_get_uuid (NMConnection *connection);
+

A shortcut to return the UUID from the connection's NMSettingConnection.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

connection :

the NMConnection -

Returns :

the UUID from the connection's 'connection' setting

connection

the NMConnection

 
+
+

Returns

+

the UUID from the connection's 'connection' setting

+

+
+
-

nm_connection_get_id ()

-
const char *        nm_connection_get_id                (NMConnection *connection);
-

-A shortcut to return the ID from the connection's NMSettingConnection. -

-
+

nm_connection_get_id ()

+
const char *
+nm_connection_get_id (NMConnection *connection);
+

A shortcut to return the ID from the connection's NMSettingConnection.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

connection :

the NMConnection -

Returns :

the ID from the connection's 'connection' setting

connection

the NMConnection

 
+
+

Returns

+

the ID from the connection's 'connection' setting

+

+
+
-

nm_connection_get_connection_type ()

-
const char *        nm_connection_get_connection_type   (NMConnection *connection);
-

-A shortcut to return the type from the connection's NMSettingConnection. -

-
+

nm_connection_get_connection_type ()

+
const char *
+nm_connection_get_connection_type (NMConnection *connection);
+

A shortcut to return the type from the connection's NMSettingConnection.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

connection :

the NMConnection -

Returns :

the type from the connection's 'connection' setting

connection

the NMConnection

 
+
+

Returns

+

the type from the connection's 'connection' setting

+

+
+
-

nm_connection_is_virtual ()

-
gboolean            nm_connection_is_virtual            (NMConnection *connection);
-

-Checks if connection refers to a virtual device (and thus can potentially be -activated even if the device it refers to doesn't exist). -

-
+

nm_connection_is_virtual ()

+
gboolean
+nm_connection_is_virtual (NMConnection *connection);
+

Checks if connection + refers to a virtual device (and thus can potentially be +activated even if the device it refers to doesn't exist).

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

connection :

an NMConnection -

Returns :

whether connection refers to a virtual device

connection

an NMConnection

 
+
+

Returns

+

whether connection +refers to a virtual device

+

+
+
-

nm_connection_get_virtual_device_description ()

-
char *              nm_connection_get_virtual_device_description
-                                                        (NMConnection *connection);
-

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

-
+

nm_connection_get_virtual_device_description ()

+
char *
+nm_connection_get_virtual_device_description
+                               (NMConnection *connection);
+

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

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

connection :

an NMConnection for a virtual device type

Returns :

the name of connection's device, -or NULL if connection is not a virtual connection type. [transfer full] -

connection

an NMConnection for a virtual device type

 
+
+

Returns

+

the name of connection +'s device, +or NULL if connection +is not a virtual connection type.

+

[transfer full]

+
+
-

nm_connection_get_setting_802_1x ()

-
NMSetting8021x *    nm_connection_get_setting_802_1x    (NMConnection *connection);
-

-A shortcut to return any NMSetting8021x the connection might contain. -

-
+

nm_connection_get_setting_802_1x ()

+
NMSetting8021x *
+nm_connection_get_setting_802_1x (NMConnection *connection);
+

A shortcut to return any NMSetting8021x the connection might contain.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

connection :

the NMConnection -

Returns :

an NMSetting8021x if the connection contains one, otherwise NULL. [transfer none] -

connection

the NMConnection

 
+
+

Returns

+

an NMSetting8021x if the connection contains one, otherwise NULL.

+

[transfer none]

+
+
-

nm_connection_get_setting_bluetooth ()

-
NMSettingBluetooth * nm_connection_get_setting_bluetooth
-                                                        (NMConnection *connection);
-

-A shortcut to return any NMSettingBluetooth the connection might contain. -

-
+

nm_connection_get_setting_bluetooth ()

+
NMSettingBluetooth *
+nm_connection_get_setting_bluetooth (NMConnection *connection);
+

A shortcut to return any NMSettingBluetooth the connection might contain.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

connection :

the NMConnection -

Returns :

an NMSettingBluetooth if the connection contains one, otherwise NULL. [transfer none] -

connection

the NMConnection

 
+
+

Returns

+

an NMSettingBluetooth if the connection contains one, otherwise NULL.

+

[transfer none]

+
+
-

nm_connection_get_setting_bond ()

-
NMSettingBond *     nm_connection_get_setting_bond      (NMConnection *connection);
-

-A shortcut to return any NMSettingBond the connection might contain. -

-
+

nm_connection_get_setting_bond ()

+
NMSettingBond *
+nm_connection_get_setting_bond (NMConnection *connection);
+

A shortcut to return any NMSettingBond the connection might contain.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

connection :

the NMConnection -

Returns :

an NMSettingBond if the connection contains one, otherwise NULL. [transfer none] -

connection

the NMConnection

 
+
+

Returns

+

an NMSettingBond if the connection contains one, otherwise NULL.

+

[transfer none]

+
+
-

nm_connection_get_setting_team ()

-
NMSettingTeam *     nm_connection_get_setting_team      (NMConnection *connection);
-

-A shortcut to return any NMSettingTeam the connection might contain. -

-
+

nm_connection_get_setting_team ()

+
NMSettingTeam *
+nm_connection_get_setting_team (NMConnection *connection);
+

A shortcut to return any NMSettingTeam the connection might contain.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

connection :

the NMConnection -

Returns :

an NMSettingTeam if the connection contains one, otherwise NULL. [transfer none] -

connection

the NMConnection

 
+
+

Returns

+

an NMSettingTeam if the connection contains one, otherwise NULL.

+

[transfer none]

+
+
-

nm_connection_get_setting_team_port ()

-
NMSettingTeamPort * nm_connection_get_setting_team_port (NMConnection *connection);
-

-A shortcut to return any NMSettingTeamPort the connection might contain. -

-
+

nm_connection_get_setting_team_port ()

+
NMSettingTeamPort *
+nm_connection_get_setting_team_port (NMConnection *connection);
+

A shortcut to return any NMSettingTeamPort the connection might contain.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

connection :

the NMConnection -

Returns :

an NMSettingTeamPort if the connection contains one, otherwise NULL. [transfer none] -

connection

the NMConnection

 
+
+

Returns

+

an NMSettingTeamPort if the connection contains one, otherwise NULL.

+

[transfer none]

+
+
-

nm_connection_get_setting_bridge ()

-
NMSettingBridge *   nm_connection_get_setting_bridge    (NMConnection *connection);
-

-A shortcut to return any NMSettingBridge the connection might contain. -

-
+

nm_connection_get_setting_bridge ()

+
NMSettingBridge *
+nm_connection_get_setting_bridge (NMConnection *connection);
+

A shortcut to return any NMSettingBridge the connection might contain.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

connection :

the NMConnection -

Returns :

an NMSettingBridge if the connection contains one, otherwise NULL. [transfer none] -

connection

the NMConnection

 
+
+

Returns

+

an NMSettingBridge if the connection contains one, otherwise NULL.

+

[transfer none]

+
+
-

nm_connection_get_setting_bridge_port ()

-
NMSettingBridgePort * nm_connection_get_setting_bridge_port
-                                                        (NMConnection *connection);
-

-A shortcut to return any NMSettingBridgePort the connection might contain. -

-
+

nm_connection_get_setting_bridge_port ()

+
NMSettingBridgePort *
+nm_connection_get_setting_bridge_port (NMConnection *connection);
+

A shortcut to return any NMSettingBridgePort the connection might contain.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

connection :

the NMConnection -

Returns :

an NMSettingBridgePort if the connection contains one, otherwise NULL. [transfer none] -

connection

the NMConnection

 
+
+

Returns

+

an NMSettingBridgePort if the connection contains one, otherwise NULL.

+

[transfer none]

+
+
-

nm_connection_get_setting_cdma ()

-
NMSettingCdma *     nm_connection_get_setting_cdma      (NMConnection *connection);
-

-A shortcut to return any NMSettingCdma the connection might contain. -

-
+

nm_connection_get_setting_cdma ()

+
NMSettingCdma *
+nm_connection_get_setting_cdma (NMConnection *connection);
+

A shortcut to return any NMSettingCdma the connection might contain.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

connection :

the NMConnection -

Returns :

an NMSettingCdma if the connection contains one, otherwise NULL. [transfer none] -

connection

the NMConnection

 
+
+

Returns

+

an NMSettingCdma if the connection contains one, otherwise NULL.

+

[transfer none]

+
+
-

nm_connection_get_setting_connection ()

-
NMSettingConnection * nm_connection_get_setting_connection
-                                                        (NMConnection *connection);
-

-A shortcut to return any NMSettingConnection the connection might contain. -

-
+

nm_connection_get_setting_connection ()

+
NMSettingConnection *
+nm_connection_get_setting_connection (NMConnection *connection);
+

A shortcut to return any NMSettingConnection the connection might contain.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + + +

connection :

the NMConnection -

Returns :

an NMSettingConnection if the connection contains one, otherwise NULL. [transfer none] -

connection

the NMConnection

 
+
+
+

Returns

+

an NMSettingConnection if the connection contains one, otherwise NULL.

+

[transfer none]

+
+ +
+
+

nm_connection_get_setting_dcb ()

+
NMSettingDcb *
+nm_connection_get_setting_dcb (NMConnection *connection);
+

A shortcut to return any NMSettingDcb the connection might contain.

+
+

Parameters

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

connection

the NMConnection

 
+
+
+

Returns

+

an NMSettingDcb if the connection contains one, otherwise NULL.

+

[transfer none]

+
+
+
+
+

nm_connection_get_setting_generic ()

+
NMSettingGeneric *
+nm_connection_get_setting_generic (NMConnection *connection);
+

A shortcut to return any NMSettingGeneric the connection might contain.

+
+

Parameters

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

connection

the NMConnection

 
+
+
+

Returns

+

an NMSettingGeneric if the connection contains one, otherwise NULL.

+

[transfer none]

+
+
+
+
+

nm_connection_get_setting_gsm ()

+
NMSettingGsm *
+nm_connection_get_setting_gsm (NMConnection *connection);
+

A shortcut to return any NMSettingGsm the connection might contain.

+
+

Parameters

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

connection

the NMConnection

 
+
+
+

Returns

+

an NMSettingGsm if the connection contains one, otherwise NULL.

+

[transfer none]

+
+
+
+
+

nm_connection_get_setting_infiniband ()

+
NMSettingInfiniband *
+nm_connection_get_setting_infiniband (NMConnection *connection);
+

A shortcut to return any NMSettingInfiniband the connection might contain.

+
+

Parameters

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

connection

the NMConnection

 
+
+
+

Returns

+

an NMSettingInfiniband if the connection contains one, otherwise NULL.

+

[transfer none]

+
+
+
+
+

nm_connection_get_setting_ip4_config ()

+
NMSettingIPConfig *
+nm_connection_get_setting_ip4_config (NMConnection *connection);
+

A shortcut to return any NMSettingIP4Config the connection might contain.

+

Note that it returns the value as type NMSettingIPConfig, since the vast +majority of IPv4-setting-related methods are on that type, not +NMSettingIP4Config.

+
+

Parameters

+
+++++ + + + + +

connection

the NMConnection

 
+
+

Returns

+

an NMSettingIP4Config if the +connection contains one, otherwise NULL.

+

[type NMSettingIP4Config][transfer none]

+
+

-

nm_connection_get_setting_dcb ()

-
NMSettingDcb *      nm_connection_get_setting_dcb       (NMConnection *connection);
-

-A shortcut to return any NMSettingDcb the connection might contain. -

-
+

nm_connection_get_setting_ip6_config ()

+
NMSettingIPConfig *
+nm_connection_get_setting_ip6_config (NMConnection *connection);
+

A shortcut to return any NMSettingIP6Config the connection might contain.

+

Note that it returns the value as type NMSettingIPConfig, since the vast +majority of IPv6-setting-related methods are on that type, not +NMSettingIP6Config.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

connection :

the NMConnection -

Returns :

an NMSettingDcb if the connection contains one, otherwise NULL. [transfer none] -

connection

the NMConnection

 
+
+

Returns

+

an NMSettingIP6Config if the +connection contains one, otherwise NULL.

+

[type NMSettingIP6Config][transfer none]

+
+
-

nm_connection_get_setting_generic ()

-
NMSettingGeneric *  nm_connection_get_setting_generic   (NMConnection *connection);
-

-A shortcut to return any NMSettingGeneric the connection might contain. -

-
+

nm_connection_get_setting_olpc_mesh ()

+
NMSettingOlpcMesh *
+nm_connection_get_setting_olpc_mesh (NMConnection *connection);
+

A shortcut to return any NMSettingOlpcMesh the connection might contain.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

connection :

the NMConnection -

Returns :

an NMSettingGeneric if the connection contains one, otherwise NULL. [transfer none] -

connection

the NMConnection

 
+
+

Returns

+

an NMSettingOlpcMesh if the connection contains one, otherwise NULL.

+

[transfer none]

+
+
-

nm_connection_get_setting_gsm ()

-
NMSettingGsm *      nm_connection_get_setting_gsm       (NMConnection *connection);
-

-A shortcut to return any NMSettingGsm the connection might contain. -

-
+

nm_connection_get_setting_ppp ()

+
NMSettingPpp *
+nm_connection_get_setting_ppp (NMConnection *connection);
+

A shortcut to return any NMSettingPpp the connection might contain.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

connection :

the NMConnection -

Returns :

an NMSettingGsm if the connection contains one, otherwise NULL. [transfer none] -

connection

the NMConnection

 
+
+

Returns

+

an NMSettingPpp if the connection contains one, otherwise NULL.

+

[transfer none]

+
+
-

nm_connection_get_setting_infiniband ()

-
NMSettingInfiniband * nm_connection_get_setting_infiniband
-                                                        (NMConnection *connection);
-

-A shortcut to return any NMSettingInfiniband the connection might contain. -

-
+

nm_connection_get_setting_pppoe ()

+
NMSettingPppoe *
+nm_connection_get_setting_pppoe (NMConnection *connection);
+

A shortcut to return any NMSettingPppoe the connection might contain.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

connection :

the NMConnection -

Returns :

an NMSettingInfiniband if the connection contains one, otherwise NULL. [transfer none] -

connection

the NMConnection

 
+
+

Returns

+

an NMSettingPppoe if the connection contains one, otherwise NULL.

+

[transfer none]

+
+
-

nm_connection_get_setting_ip4_config ()

-
NMSettingIPConfig * nm_connection_get_setting_ip4_config
-                                                        (NMConnection *connection);
-

-A shortcut to return any NMSettingIP4Config the connection might contain. -

-

-Note that it returns the value as type NMSettingIPConfig, since the vast -majority of IPv4-setting-related methods are on that type, not -NMSettingIP4Config. -

-
+

nm_connection_get_setting_serial ()

+
NMSettingSerial *
+nm_connection_get_setting_serial (NMConnection *connection);
+

A shortcut to return any NMSettingSerial the connection might contain.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

connection :

the NMConnection -

Returns :

an NMSettingIP4Config if the -connection contains one, otherwise NULL. [type NMSettingIP4Config][transfer none] -

connection

the NMConnection

 
+
+

Returns

+

an NMSettingSerial if the connection contains one, otherwise NULL.

+

[transfer none]

+
+
-

nm_connection_get_setting_ip6_config ()

-
NMSettingIPConfig * nm_connection_get_setting_ip6_config
-                                                        (NMConnection *connection);
-

-A shortcut to return any NMSettingIP6Config the connection might contain. -

-

-Note that it returns the value as type NMSettingIPConfig, since the vast -majority of IPv6-setting-related methods are on that type, not -NMSettingIP6Config. -

-
+

nm_connection_get_setting_vpn ()

+
NMSettingVpn *
+nm_connection_get_setting_vpn (NMConnection *connection);
+

A shortcut to return any NMSettingVpn the connection might contain.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

connection :

the NMConnection -

Returns :

an NMSettingIP6Config if the -connection contains one, otherwise NULL. [type NMSettingIP6Config][transfer none] -

connection

the NMConnection

 
+
+

Returns

+

an NMSettingVpn if the connection contains one, otherwise NULL.

+

[transfer none]

+
+
-

nm_connection_get_setting_olpc_mesh ()

-
NMSettingOlpcMesh * nm_connection_get_setting_olpc_mesh (NMConnection *connection);
-

-A shortcut to return any NMSettingOlpcMesh the connection might contain. -

-
+

nm_connection_get_setting_wimax ()

+
NMSettingWimax *
+nm_connection_get_setting_wimax (NMConnection *connection);
+

A shortcut to return any NMSettingWimax the connection might contain.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

connection :

the NMConnection -

Returns :

an NMSettingOlpcMesh if the connection contains one, otherwise NULL. [transfer none] -

connection

the NMConnection

 
+
+

Returns

+

an NMSettingWimax if the connection contains one, otherwise NULL.

+

[transfer none]

+
+
-

nm_connection_get_setting_ppp ()

-
NMSettingPpp *      nm_connection_get_setting_ppp       (NMConnection *connection);
-

-A shortcut to return any NMSettingPpp the connection might contain. -

-
+

nm_connection_get_setting_adsl ()

+
NMSettingAdsl *
+nm_connection_get_setting_adsl (NMConnection *connection);
+

A shortcut to return any NMSettingAdsl the connection might contain.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

connection :

the NMConnection -

Returns :

an NMSettingPpp if the connection contains one, otherwise NULL. [transfer none] -

connection

the NMConnection

 
+
+

Returns

+

an NMSettingAdsl if the connection contains one, otherwise NULL.

+

[transfer none]

+
+
-

nm_connection_get_setting_pppoe ()

-
NMSettingPppoe *    nm_connection_get_setting_pppoe     (NMConnection *connection);
-

-A shortcut to return any NMSettingPppoe the connection might contain. -

-
+

nm_connection_get_setting_wired ()

+
NMSettingWired *
+nm_connection_get_setting_wired (NMConnection *connection);
+

A shortcut to return any NMSettingWired the connection might contain.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

connection :

the NMConnection -

Returns :

an NMSettingPppoe if the connection contains one, otherwise NULL. [transfer none] -

connection

the NMConnection

 
+
+

Returns

+

an NMSettingWired if the connection contains one, otherwise NULL.

+

[transfer none]

+
+
-

nm_connection_get_setting_serial ()

-
NMSettingSerial *   nm_connection_get_setting_serial    (NMConnection *connection);
-

-A shortcut to return any NMSettingSerial the connection might contain. -

-
+

nm_connection_get_setting_wireless ()

+
NMSettingWireless *
+nm_connection_get_setting_wireless (NMConnection *connection);
+

A shortcut to return any NMSettingWireless the connection might contain.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

connection :

the NMConnection -

Returns :

an NMSettingSerial if the connection contains one, otherwise NULL. [transfer none] -

connection

the NMConnection

 
+
+

Returns

+

an NMSettingWireless if the connection contains one, otherwise NULL.

+

[transfer none]

+
+
-

nm_connection_get_setting_vpn ()

-
NMSettingVpn *      nm_connection_get_setting_vpn       (NMConnection *connection);
-

-A shortcut to return any NMSettingVpn the connection might contain. -

-
+

nm_connection_get_setting_wireless_security ()

+
NMSettingWirelessSecurity *
+nm_connection_get_setting_wireless_security
+                               (NMConnection *connection);
+

A shortcut to return any NMSettingWirelessSecurity the connection might contain.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

connection :

the NMConnection -

Returns :

an NMSettingVpn if the connection contains one, otherwise NULL. [transfer none] -

connection

the NMConnection

 
+
+

Returns

+

an NMSettingWirelessSecurity if the connection contains one, otherwise NULL.

+

[transfer none]

+
+
-

nm_connection_get_setting_wimax ()

-
NMSettingWimax *    nm_connection_get_setting_wimax     (NMConnection *connection);
-

-A shortcut to return any NMSettingWimax the connection might contain. -

-
+

nm_connection_get_setting_vlan ()

+
NMSettingVlan *
+nm_connection_get_setting_vlan (NMConnection *connection);
+

A shortcut to return any NMSettingVlan the connection might contain.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

connection :

the NMConnection -

Returns :

an NMSettingWimax if the connection contains one, otherwise NULL. [transfer none] -

connection

the NMConnection

 
-
+
+

Returns

+

an NMSettingVlan if the connection contains one, otherwise NULL.

+

[transfer none]

+
+ + +
+

Types and Values

-

nm_connection_get_setting_adsl ()

-
NMSettingAdsl *     nm_connection_get_setting_adsl      (NMConnection *connection);
+

NM_CONNECTION_SECRETS_UPDATED

+
#define NM_CONNECTION_SECRETS_UPDATED "secrets-updated"
+

-A shortcut to return any NMSettingAdsl the connection might contain.

-
---- - - - - - - - - - - -

connection :

the NMConnection -

Returns :

an NMSettingAdsl if the connection contains one, otherwise NULL. [transfer none] -

-

nm_connection_get_setting_wired ()

-
NMSettingWired *    nm_connection_get_setting_wired     (NMConnection *connection);
+

NM_CONNECTION_SECRETS_CLEARED

+
#define NM_CONNECTION_SECRETS_CLEARED "secrets-cleared"
+

-A shortcut to return any NMSettingWired the connection might contain.

-
---- - - - - - - - - - - -

connection :

the NMConnection -

Returns :

an NMSettingWired if the connection contains one, otherwise NULL. [transfer none] -

-

nm_connection_get_setting_wireless ()

-
NMSettingWireless * nm_connection_get_setting_wireless  (NMConnection *connection);
+

NM_CONNECTION_CHANGED

+
#define NM_CONNECTION_CHANGED         "changed"
+

-A shortcut to return any NMSettingWireless the connection might contain.

-
---- - - - - - - - - - - -

connection :

the NMConnection -

Returns :

an NMSettingWireless if the connection contains one, otherwise NULL. [transfer none] -

-

nm_connection_get_setting_wireless_security ()

-
NMSettingWirelessSecurity * nm_connection_get_setting_wireless_security
-                                                        (NMConnection *connection);
+

NM_CONNECTION_NORMALIZE_PARAM_IP6_CONFIG_METHOD

+
#define NM_CONNECTION_NORMALIZE_PARAM_IP6_CONFIG_METHOD "ip6-config-method"
+

-A shortcut to return any NMSettingWirelessSecurity the connection might contain.

-
+ +
+
+

NMConnectionInterface

+
typedef struct {
+	GTypeInterface parent;
+
+	/* Signals */
+	void (*secrets_updated) (NMConnection *connection,
+	                         const char   *setting);
+	void (*secrets_cleared) (NMConnection *connection);
+	void (*changed)         (NMConnection *connection);
+} NMConnectionInterface;
+
+
+

Members

+
--+++ - - + + + - - + + + + + + + + + + + + +

connection :

the NMConnection -

GTypeInterface parent;

the parent interace struct

 

Returns :

an NMSettingWirelessSecurity if the connection contains one, otherwise NULL. [transfer none] -

secrets_updated ()

emitted when the connection's secrets are updated

 

secrets_cleared ()

emitted when the connection's secrets are cleared

 

changed ()

emitted when any change to the connection's settings occurs

 
+

-

nm_connection_get_setting_vlan ()

-
NMSettingVlan *     nm_connection_get_setting_vlan      (NMConnection *connection);
-

-A shortcut to return any NMSettingVlan the connection might contain. -

-
+

NM_VARIANT_TYPE_SETTING

+
#define NM_VARIANT_TYPE_SETTING G_VARIANT_TYPE_VARDICT
+
+

GVariantType for a dictionary mapping from property names to values. This is +an alias for G_VARIANT_TYPE_VARDICT, and is the type of each element of +an NM_VARIANT_TYPE_CONNECTION dictionary.

+ +
+
+

enum NMConnectionSerializationFlags

+

These flags determine which properties are serialized when calling when +calling nm_connection_to_dbus().

+
+

Members

+
--+++ - - + + - - + + + + + + +

connection :

the NMConnection +

NM_CONNECTION_SERIALIZE_ALL

+

serialize all properties (including secrets)

 

Returns :

an NMSettingVlan if the connection contains one, otherwise NULL. [transfer none] +

NM_CONNECTION_SERIALIZE_NO_SECRETS

+

do not include secrets

 

NM_CONNECTION_SERIALIZE_ONLY_SECRETS

+

only serialize secrets

+
 
+ + Generated by GTK-Doc V1.21 \ No newline at end of file diff --git a/docs/libnm/html/libnm-NMVpnEditorPlugin.html b/docs/libnm/html/libnm-NMVpnEditorPlugin.html deleted file mode 100644 index 1cfdb8e6..00000000 --- a/docs/libnm/html/libnm-NMVpnEditorPlugin.html +++ /dev/null @@ -1,382 +0,0 @@ - - - - -NMVpnEditorPlugin - - - - - - - - - - - - - - - - - - - -
-
-
- - -
-

NMVpnEditorPlugin

-

NMVpnEditorPlugin

-
-
-

Synopsis

-
NMVpnEditorPlugin * (*NMVpnEditorPluginFactory)         (GError **error);
-NMVpnEditorPlugin * nm_vpn_editor_plugin_factory        (GError **error);
-enum                NMVpnEditorPluginCapability;
-#define             NM_VPN_EDITOR_PLUGIN_NAME
-#define             NM_VPN_EDITOR_PLUGIN_DESCRIPTION
-#define             NM_VPN_EDITOR_PLUGIN_SERVICE
-                    NMVpnEditorPluginInterface;
-NMVpnEditor *       nm_vpn_editor_plugin_get_editor     (NMVpnEditorPlugin *plugin,
-                                                         NMConnection *connection,
-                                                         GError **error);
-NMVpnEditorPluginCapability nm_vpn_editor_plugin_get_capabilities
-                                                        (NMVpnEditorPlugin *plugin);
-NMConnection *      nm_vpn_editor_plugin_import         (NMVpnEditorPlugin *plugin,
-                                                         const char *path,
-                                                         GError **error);
-gboolean            nm_vpn_editor_plugin_export         (NMVpnEditorPlugin *plugin,
-                                                         const char *path,
-                                                         NMConnection *connection,
-                                                         GError **error);
-char *              nm_vpn_editor_plugin_get_suggested_filename
-                                                        (NMVpnEditorPlugin *plugin,
-                                                         NMConnection *connection);
-                    NMVpnEditorInterface;
-GObject *           nm_vpn_editor_get_widget            (NMVpnEditor *editor);
-gboolean            nm_vpn_editor_update_connection     (NMVpnEditor *editor,
-                                                         NMConnection *connection,
-                                                         GError **error);
-
-
-
-

Object Hierarchy

-
-  GFlags
-   +----NMVpnEditorPluginCapability
-
-
-
-

Description

-

-

-
-
-

Details

-
-

NMVpnEditorPluginFactory ()

-
NMVpnEditorPlugin * (*NMVpnEditorPluginFactory)         (GError **error);
-

-

-
-
-
-

nm_vpn_editor_plugin_factory ()

-
NMVpnEditorPlugin * nm_vpn_editor_plugin_factory        (GError **error);
-

-

-
-
-
-

enum NMVpnEditorPluginCapability

-
typedef enum {
-	NM_VPN_EDITOR_PLUGIN_CAPABILITY_NONE   = 0x00,
-	NM_VPN_EDITOR_PLUGIN_CAPABILITY_IMPORT = 0x01,
-	NM_VPN_EDITOR_PLUGIN_CAPABILITY_EXPORT = 0x02,
-	NM_VPN_EDITOR_PLUGIN_CAPABILITY_IPV6   = 0x04
-} NMVpnEditorPluginCapability;
-
-

-Flags that indicate certain capabilities of the plugin to editor programs. -

-
---- - - - - - - - - - - - - - - - - - - -

NM_VPN_EDITOR_PLUGIN_CAPABILITY_NONE

unknown or no capability -

NM_VPN_EDITOR_PLUGIN_CAPABILITY_IMPORT

the plugin can import new connections -

NM_VPN_EDITOR_PLUGIN_CAPABILITY_EXPORT

the plugin can export connections -

NM_VPN_EDITOR_PLUGIN_CAPABILITY_IPV6

the plugin supports IPv6 addressing -
-
-
-
-

NM_VPN_EDITOR_PLUGIN_NAME

-
#define NM_VPN_EDITOR_PLUGIN_NAME "name"
-
-

-

-
-
-
-

NM_VPN_EDITOR_PLUGIN_DESCRIPTION

-
#define NM_VPN_EDITOR_PLUGIN_DESCRIPTION "description"
-
-

-

-
-
-
-

NM_VPN_EDITOR_PLUGIN_SERVICE

-
#define NM_VPN_EDITOR_PLUGIN_SERVICE "service"
-
-

-

-
-
-
-

NMVpnEditorPluginInterface

-
typedef struct {
-	GTypeInterface g_iface;
-
-	NMVpnEditor * (*get_editor) (NMVpnEditorPlugin *plugin,
-	                             NMConnection *connection,
-	                             GError **error);
-
-	NMVpnEditorPluginCapability (*get_capabilities) (NMVpnEditorPlugin *plugin);
-
-	NMConnection * (*import_from_file) (NMVpnEditorPlugin *plugin,
-	                                    const char *path,
-	                                    GError **error);
-
-	gboolean (*export_to_file) (NMVpnEditorPlugin *plugin,
-	                            const char *path,
-	                            NMConnection *connection,
-	                            GError **error);
-
-	char * (*get_suggested_filename) (NMVpnEditorPlugin *plugin, NMConnection *connection);
-} NMVpnEditorPluginInterface;
-
-

-Interface for VPN editor plugins. -

-
---- - - - - - - - - - - - - - - - - - - - - - - - - - - -

GTypeInterface g_iface;

the parent interface

get_editor ()

returns an NMVpnEditor, pre-filled with values from connection -if non-NULL.

get_capabilities ()

returns a bitmask of capabilities.

import_from_file ()

Try to import a connection from the specified path. On -success, return a partial NMConnection object. On error, return NULL and -set error with additional information. Note that error can be NULL, in -which case no additional error information should be provided.

export_to_file ()

Export the given connection to the specified path. Return -TRUE on success. On error, return FALSE and set error with additional -error information. Note that error can be NULL, in which case no -additional error information should be provided.

get_suggested_filename ()

For a given connection, return a suggested file -name. Returned value will be NULL or a suggested file name to be freed by -the caller.
-
-
-
-

nm_vpn_editor_plugin_get_editor ()

-
NMVpnEditor *       nm_vpn_editor_plugin_get_editor     (NMVpnEditorPlugin *plugin,
-                                                         NMConnection *connection,
-                                                         GError **error);
-
---- - - - - -

Returns :

. [transfer full] -
-
-
-
-

nm_vpn_editor_plugin_get_capabilities ()

-
NMVpnEditorPluginCapability nm_vpn_editor_plugin_get_capabilities
-                                                        (NMVpnEditorPlugin *plugin);
-

-

-
-
-
-

nm_vpn_editor_plugin_import ()

-
NMConnection *      nm_vpn_editor_plugin_import         (NMVpnEditorPlugin *plugin,
-                                                         const char *path,
-                                                         GError **error);
-
---- - - - - -

Returns :

. [transfer full] -
-
-
-
-

nm_vpn_editor_plugin_export ()

-
gboolean            nm_vpn_editor_plugin_export         (NMVpnEditorPlugin *plugin,
-                                                         const char *path,
-                                                         NMConnection *connection,
-                                                         GError **error);
-

-

-
-
-
-

nm_vpn_editor_plugin_get_suggested_filename ()

-
char *              nm_vpn_editor_plugin_get_suggested_filename
-                                                        (NMVpnEditorPlugin *plugin,
-                                                         NMConnection *connection);
-

-

-
-
-
-

NMVpnEditorInterface

-
typedef struct {
-	GTypeInterface g_iface;
-
-	GObject * (*get_widget) (NMVpnEditor *editor);
-
-	void (*placeholder) (void);
-
-	gboolean (*update_connection) (NMVpnEditor *editor,
-	                               NMConnection *connection,
-	                               GError **error);
-
-	void (*changed) (NMVpnEditor *editor);
-} NMVpnEditorInterface;
-
-

-Interface for editing a specific NMConnection -

-
---- - - - - - - - - - - - - - - - - - - - - - - -

GTypeInterface g_iface;

the parent interface

get_widget ()

return the GtkWidget for the VPN editor's UI

placeholder ()

not currently used

update_connection ()

called to save the user-entered options to the connection -object. Should return FALSE and set error if the current options are -invalid. error should contain enough information for the plugin to -determine which UI widget is invalid at a later point in time. For -example, creating unique error codes for what error occurred and populating -the message field of error with the name of the invalid property.

changed ()

emitted when the value of a UI widget changes. May trigger a -validity check via update_connection to write values to the connection.
-
-
-
-

nm_vpn_editor_get_widget ()

-
GObject *           nm_vpn_editor_get_widget            (NMVpnEditor *editor);
-
---- - - - - -

Returns :

. [transfer none] -
-
-
-
-

nm_vpn_editor_update_connection ()

-
gboolean            nm_vpn_editor_update_connection     (NMVpnEditor *editor,
-                                                         NMConnection *connection,
-                                                         GError **error);
-

-

-
-
-
- - - \ No newline at end of file diff --git a/docs/libnm/html/libnm-nm-dbus-interface.html b/docs/libnm/html/libnm-nm-dbus-interface.html index f2e00fe2..3d03fe4c 100644 --- a/docs/libnm/html/libnm-nm-dbus-interface.html +++ b/docs/libnm/html/libnm-nm-dbus-interface.html @@ -2,32 +2,27 @@ -nm-dbus-interface +libnm Reference Manual: nm-dbus-interface - + - - - - - - - - - - + + + + + + +
@@ -35,128 +30,258 @@

nm-dbus-interface

nm-dbus-interface

- +
-
-

Synopsis

-
#define             NM_DBUS_SERVICE
-#define             NM_DBUS_PATH
-#define             NM_DBUS_INTERFACE
-#define             NM_DBUS_INTERFACE_DEVICE
-#define             NM_DBUS_INTERFACE_DEVICE_WIRED
-#define             NM_DBUS_INTERFACE_DEVICE_ADSL
-#define             NM_DBUS_INTERFACE_DEVICE_WIRELESS
-#define             NM_DBUS_INTERFACE_DEVICE_BLUETOOTH
-#define             NM_DBUS_INTERFACE_DEVICE_OLPC_MESH
-#define             NM_DBUS_PATH_ACCESS_POINT
-#define             NM_DBUS_INTERFACE_ACCESS_POINT
-#define             NM_DBUS_INTERFACE_DEVICE_MODEM
-#define             NM_DBUS_INTERFACE_DEVICE_WIMAX
-#define             NM_DBUS_INTERFACE_WIMAX_NSP
-#define             NM_DBUS_PATH_WIMAX_NSP
-#define             NM_DBUS_INTERFACE_ACTIVE_CONNECTION
-#define             NM_DBUS_INTERFACE_IP4_CONFIG
-#define             NM_DBUS_INTERFACE_DHCP4_CONFIG
-#define             NM_DBUS_INTERFACE_IP6_CONFIG
-#define             NM_DBUS_INTERFACE_DHCP6_CONFIG
-#define             NM_DBUS_INTERFACE_DEVICE_INFINIBAND
-#define             NM_DBUS_INTERFACE_DEVICE_BOND
-#define             NM_DBUS_INTERFACE_DEVICE_TEAM
-#define             NM_DBUS_INTERFACE_DEVICE_VLAN
-#define             NM_DBUS_INTERFACE_DEVICE_BRIDGE
-#define             NM_DBUS_INTERFACE_DEVICE_GENERIC
-#define             NM_DBUS_INTERFACE_DEVICE_VETH
-#define             NM_DBUS_INTERFACE_DEVICE_TUN
-#define             NM_DBUS_INTERFACE_DEVICE_MACVLAN
-#define             NM_DBUS_INTERFACE_DEVICE_VXLAN
-#define             NM_DBUS_INTERFACE_DEVICE_GRE
-#define             NM_DBUS_INTERFACE_SETTINGS
-#define             NM_DBUS_PATH_SETTINGS
-#define             NM_DBUS_INTERFACE_SETTINGS_CONNECTION
-#define             NM_DBUS_PATH_SETTINGS_CONNECTION
-#define             NM_DBUS_INTERFACE_SETTINGS_CONNECTION_SECRETS
-#define             NM_DBUS_INTERFACE_AGENT_MANAGER
-#define             NM_DBUS_PATH_AGENT_MANAGER
-#define             NM_DBUS_INTERFACE_SECRET_AGENT
-#define             NM_DBUS_PATH_SECRET_AGENT
-enum                NMState;
-enum                NMConnectivityState;
-enum                NMDeviceType;
-enum                NMDeviceCapabilities;
-enum                NMDeviceWifiCapabilities;
-enum                NM80211ApFlags;
-enum                NM80211ApSecurityFlags;
-enum                NM80211Mode;
-enum                NMBluetoothCapabilities;
-enum                NMDeviceModemCapabilities;
-enum                NMDeviceState;
-enum                NMDeviceStateReason;
-enum                NMActiveConnectionState;
-enum                NMSecretAgentGetSecretsFlags;
-enum                NMSecretAgentCapabilities;
-
+
+

Types and Values

+
++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
#defineNM_DBUS_SERVICE
#defineNM_DBUS_PATH
#defineNM_DBUS_INTERFACE
#defineNM_DBUS_INTERFACE_DEVICE
#defineNM_DBUS_INTERFACE_DEVICE_WIRED
#defineNM_DBUS_INTERFACE_DEVICE_ADSL
#defineNM_DBUS_INTERFACE_DEVICE_WIRELESS
#defineNM_DBUS_INTERFACE_DEVICE_BLUETOOTH
#defineNM_DBUS_INTERFACE_DEVICE_OLPC_MESH
#defineNM_DBUS_PATH_ACCESS_POINT
#defineNM_DBUS_INTERFACE_ACCESS_POINT
#defineNM_DBUS_INTERFACE_DEVICE_MODEM
#defineNM_DBUS_INTERFACE_DEVICE_WIMAX
#defineNM_DBUS_INTERFACE_WIMAX_NSP
#defineNM_DBUS_PATH_WIMAX_NSP
#defineNM_DBUS_INTERFACE_ACTIVE_CONNECTION
#defineNM_DBUS_INTERFACE_IP4_CONFIG
#defineNM_DBUS_INTERFACE_DHCP4_CONFIG
#defineNM_DBUS_INTERFACE_IP6_CONFIG
#defineNM_DBUS_INTERFACE_DHCP6_CONFIG
#defineNM_DBUS_INTERFACE_DEVICE_INFINIBAND
#defineNM_DBUS_INTERFACE_DEVICE_BOND
#defineNM_DBUS_INTERFACE_DEVICE_TEAM
#defineNM_DBUS_INTERFACE_DEVICE_VLAN
#defineNM_DBUS_INTERFACE_DEVICE_BRIDGE
#defineNM_DBUS_INTERFACE_DEVICE_GENERIC
#defineNM_DBUS_INTERFACE_DEVICE_VETH
#defineNM_DBUS_INTERFACE_DEVICE_TUN
#defineNM_DBUS_INTERFACE_DEVICE_MACVLAN
#defineNM_DBUS_INTERFACE_DEVICE_VXLAN
#defineNM_DBUS_INTERFACE_DEVICE_GRE
#defineNM_DBUS_INTERFACE_SETTINGS
#defineNM_DBUS_PATH_SETTINGS
#defineNM_DBUS_INTERFACE_SETTINGS_CONNECTION
#defineNM_DBUS_PATH_SETTINGS_CONNECTION
#defineNM_DBUS_INTERFACE_SETTINGS_CONNECTION_SECRETS
#defineNM_DBUS_INTERFACE_AGENT_MANAGER
#defineNM_DBUS_PATH_AGENT_MANAGER
#defineNM_DBUS_INTERFACE_SECRET_AGENT
#defineNM_DBUS_PATH_SECRET_AGENT
enumNMState
enumNMConnectivityState
enumNMDeviceType
enumNMDeviceCapabilities
enumNMDeviceWifiCapabilities
enumNM80211ApFlags
enumNM80211ApSecurityFlags
enumNM80211Mode
enumNMBluetoothCapabilities
enumNMDeviceModemCapabilities
enumNMDeviceState
enumNMDeviceStateReason
enumNMActiveConnectionState
enumNMSecretAgentGetSecretsFlags
enumNMSecretAgentCapabilities

Object Hierarchy

-
-  GEnum
-   +----NMState
-
-
-  GEnum
-   +----NMConnectivityState
-
-
-  GEnum
-   +----NMDeviceType
-
-
-  GFlags
-   +----NMDeviceCapabilities
-
-
-  GFlags
-   +----NMDeviceWifiCapabilities
-
-
-  GFlags
-   +----NM80211ApFlags
-
-
-  GFlags
-   +----NM80211ApSecurityFlags
-
-
-  GEnum
-   +----NM80211Mode
-
-
-  GFlags
-   +----NMBluetoothCapabilities
-
-
-  GFlags
-   +----NMDeviceModemCapabilities
-
-
-  GEnum
-   +----NMDeviceState
-
-
-  GEnum
-   +----NMDeviceStateReason
-
-
-  GEnum
-   +----NMActiveConnectionState
-
-
-  GFlags
-   +----NMSecretAgentGetSecretsFlags
-
-
-  GFlags
-   +----NMSecretAgentCapabilities
+
    GEnum
+    ├── NM80211Mode
+    ├── NMActiveConnectionState
+    ├── NMConnectivityState
+    ├── NMDeviceState
+    ├── NMDeviceStateReason
+    ├── NMDeviceType
+    ╰── NMState
+    GFlags
+    ├── NM80211ApFlags
+    ├── NM80211ApSecurityFlags
+    ├── NMBluetoothCapabilities
+    ├── NMDeviceCapabilities
+    ├── NMDeviceModemCapabilities
+    ├── NMDeviceWifiCapabilities
+    ├── NMSecretAgentCapabilities
+    ╰── NMSecretAgentGetSecretsFlags
 
@@ -165,7 +290,10 @@ enum -

Details

+

Functions

+
+
+

Types and Values

NM_DBUS_SERVICE

#define NM_DBUS_SERVICE                     "org.freedesktop.NetworkManager"
@@ -487,1320 +615,1449 @@ enum                
-

enum NMState

-
typedef enum {
-	NM_STATE_UNKNOWN          = 0,
-	NM_STATE_ASLEEP           = 10,
-	NM_STATE_DISCONNECTED     = 20,
-	NM_STATE_DISCONNECTING    = 30,
-	NM_STATE_CONNECTING       = 40,
-	NM_STATE_CONNECTED_LOCAL  = 50,
-	NM_STATE_CONNECTED_SITE   = 60,
-	NM_STATE_CONNECTED_GLOBAL = 70
-} NMState;
-
-

-NMState values indicate the current overall networking state. -

-

-(Corresponds to the NM_STATE type in nm-manager.xml.) -

-
+

enum NMState

+

NMState values indicate the current overall networking state.

+

(Corresponds to the NM_STATE type in nm-manager.xml.)

+
+

Members

+
--+++ - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + +

NM_STATE_UNKNOWN

networking state is unknown +

NM_STATE_UNKNOWN

+

networking state is unknown

 

NM_STATE_ASLEEP

networking is not enabled +

NM_STATE_ASLEEP

+

networking is not enabled

 

NM_STATE_DISCONNECTED

there is no active network connection +

NM_STATE_DISCONNECTED

+

there is no active network connection

 

NM_STATE_DISCONNECTING

network connections are being cleaned up +

NM_STATE_DISCONNECTING

+

network connections are being cleaned up

 

NM_STATE_CONNECTING

a network connection is being started +

NM_STATE_CONNECTING

+

a network connection is being started

 

NM_STATE_CONNECTED_LOCAL

there is only local IPv4 and/or IPv6 connectivity +

NM_STATE_CONNECTED_LOCAL

+

there is only local IPv4 and/or IPv6 connectivity

 

NM_STATE_CONNECTED_SITE

there is only site-wide IPv4 and/or IPv6 connectivity +

NM_STATE_CONNECTED_SITE

+

there is only site-wide IPv4 and/or IPv6 connectivity

 

NM_STATE_CONNECTED_GLOBAL

there is global IPv4 and/or IPv6 Internet connectivity +

NM_STATE_CONNECTED_GLOBAL

+

there is global IPv4 and/or IPv6 Internet connectivity

 
+

-

enum NMConnectivityState

-
typedef enum {
-	NM_CONNECTIVITY_UNKNOWN,
-	NM_CONNECTIVITY_NONE,
-	NM_CONNECTIVITY_PORTAL,
-	NM_CONNECTIVITY_LIMITED,
-	NM_CONNECTIVITY_FULL
-} NMConnectivityState;
-
-

-(Corresponds to the NM_CONNECTIVITY type in nm-manager.xml.) -

-
+

enum NMConnectivityState

+

(Corresponds to the NM_CONNECTIVITY type in nm-manager.xml.)

+
+

Members

+
--+++ - - + + - - + + - - + + - - + + - - + +

NM_CONNECTIVITY_UNKNOWN

Network connectivity is unknown. +

NM_CONNECTIVITY_UNKNOWN

+

Network connectivity is unknown.

 

NM_CONNECTIVITY_NONE

The host is not connected to any network. +

NM_CONNECTIVITY_NONE

+

The host is not connected to any network.

 

NM_CONNECTIVITY_PORTAL

The host is behind a captive portal and - cannot reach the full Internet. +

NM_CONNECTIVITY_PORTAL

+

The host is behind a captive portal and + cannot reach the full Internet.

 

NM_CONNECTIVITY_LIMITED

The host is connected to a network, but - does not appear to be able to reach the full Internet. +

NM_CONNECTIVITY_LIMITED

+

The host is connected to a network, but + does not appear to be able to reach the full Internet.

 

NM_CONNECTIVITY_FULL

The host is connected to a network, and - appears to be able to reach the full Internet. +

NM_CONNECTIVITY_FULL

+

The host is connected to a network, and + appears to be able to reach the full Internet.

 
+

-

enum NMDeviceType

-
typedef enum {
-	NM_DEVICE_TYPE_UNKNOWN    = 0,
-	NM_DEVICE_TYPE_ETHERNET   = 1,
-	NM_DEVICE_TYPE_WIFI       = 2,
-	NM_DEVICE_TYPE_UNUSED1    = 3,
-	NM_DEVICE_TYPE_UNUSED2    = 4,
-	NM_DEVICE_TYPE_BT         = 5,  /* Bluetooth */
-	NM_DEVICE_TYPE_OLPC_MESH  = 6,
-	NM_DEVICE_TYPE_WIMAX      = 7,
-	NM_DEVICE_TYPE_MODEM      = 8,
-	NM_DEVICE_TYPE_INFINIBAND = 9,
-	NM_DEVICE_TYPE_BOND       = 10,
-	NM_DEVICE_TYPE_VLAN       = 11,
-	NM_DEVICE_TYPE_ADSL       = 12,
-	NM_DEVICE_TYPE_BRIDGE     = 13,
-	NM_DEVICE_TYPE_GENERIC    = 14,
-	NM_DEVICE_TYPE_TEAM       = 15,
-} NMDeviceType;
-
-

-NMDeviceType values indicate the type of hardware represented by -an NMDevice. -

-

-(Corresponds to the NM_DEVICE_TYPE type in nm-device.xml.) -

-
+

enum NMDeviceType

+

NMDeviceType values indicate the type of hardware represented by +an NMDevice.

+

(Corresponds to the NM_DEVICE_TYPE type in nm-device.xml.)

+
+

Members

+
--+++ - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + +

NM_DEVICE_TYPE_UNKNOWN

unknown device +

NM_DEVICE_TYPE_UNKNOWN

+

unknown device

 

NM_DEVICE_TYPE_ETHERNET

a wired ethernet device +

NM_DEVICE_TYPE_ETHERNET

+

a wired ethernet device

 

NM_DEVICE_TYPE_WIFI

an 802.11 WiFi device +

NM_DEVICE_TYPE_WIFI

+

an 802.11 WiFi device

 

NM_DEVICE_TYPE_UNUSED1

not used +

NM_DEVICE_TYPE_UNUSED1

+

not used

 

NM_DEVICE_TYPE_UNUSED2

not used +

NM_DEVICE_TYPE_UNUSED2

+

not used

 

NM_DEVICE_TYPE_BT

a Bluetooth device supporting PAN or DUN access protocols +

NM_DEVICE_TYPE_BT

+

a Bluetooth device supporting PAN or DUN access protocols

 

NM_DEVICE_TYPE_OLPC_MESH

an OLPC XO mesh networking device +

NM_DEVICE_TYPE_OLPC_MESH

+

an OLPC XO mesh networking device

 

NM_DEVICE_TYPE_WIMAX

an 802.16e Mobile WiMAX broadband device +

NM_DEVICE_TYPE_WIMAX

+

an 802.16e Mobile WiMAX broadband device

 

NM_DEVICE_TYPE_MODEM

a modem supporting analog telephone, CDMA/EVDO, -GSM/UMTS, or LTE network access protocols +

NM_DEVICE_TYPE_MODEM

+

a modem supporting analog telephone, CDMA/EVDO, +GSM/UMTS, or LTE network access protocols

 

NM_DEVICE_TYPE_INFINIBAND

an IP-over-InfiniBand device +

NM_DEVICE_TYPE_INFINIBAND

+

an IP-over-InfiniBand device

 

NM_DEVICE_TYPE_BOND

a bond master interface +

NM_DEVICE_TYPE_BOND

+

a bond master interface

 

NM_DEVICE_TYPE_VLAN

an 802.1Q VLAN interface +

NM_DEVICE_TYPE_VLAN

+

an 802.1Q VLAN interface

 

NM_DEVICE_TYPE_ADSL

ADSL modem +

NM_DEVICE_TYPE_ADSL

+

ADSL modem

 

NM_DEVICE_TYPE_BRIDGE

a bridge master interface +

NM_DEVICE_TYPE_BRIDGE

+

a bridge master interface

 

NM_DEVICE_TYPE_GENERIC

generic support for unrecognized device types +

NM_DEVICE_TYPE_GENERIC

+

generic support for unrecognized device types

 

NM_DEVICE_TYPE_TEAM

a team master interface +

NM_DEVICE_TYPE_TEAM

+

a team master interface

 
+

-

enum NMDeviceCapabilities

-
typedef enum {
- /*< flags >*/
-	NM_DEVICE_CAP_NONE           = 0x00000000,
-	NM_DEVICE_CAP_NM_SUPPORTED   = 0x00000001,
-	NM_DEVICE_CAP_CARRIER_DETECT = 0x00000002,
-	NM_DEVICE_CAP_IS_SOFTWARE    = 0x00000004,
-} NMDeviceCapabilities;
-
-

-General device capability flags. -

-

-(Corresponds to the NM_DEVICE_CAP type in nm-device-wifi.xml.) -

-
+

enum NMDeviceCapabilities

+

General device capability flags.

+

(Corresponds to the NM_DEVICE_CAP type in nm-device-wifi.xml.)

+
+

Members

+
--+++ - - + + - - + + - - + + - - + +

NM_DEVICE_CAP_NONE

device has no special capabilities +

NM_DEVICE_CAP_NONE

+

device has no special capabilities

 

NM_DEVICE_CAP_NM_SUPPORTED

NetworkManager supports this device +

NM_DEVICE_CAP_NM_SUPPORTED

+

NetworkManager supports this device

 

NM_DEVICE_CAP_CARRIER_DETECT

this device can indicate carrier status +

NM_DEVICE_CAP_CARRIER_DETECT

+

this device can indicate carrier status

 

NM_DEVICE_CAP_IS_SOFTWARE

this device is a software device +

NM_DEVICE_CAP_IS_SOFTWARE

+

this device is a software device

 
+
-

enum NMDeviceWifiCapabilities

-
typedef enum {
- /*< flags >*/
-	NM_WIFI_DEVICE_CAP_NONE          = 0x00000000,
-	NM_WIFI_DEVICE_CAP_CIPHER_WEP40  = 0x00000001,
-	NM_WIFI_DEVICE_CAP_CIPHER_WEP104 = 0x00000002,
-	NM_WIFI_DEVICE_CAP_CIPHER_TKIP   = 0x00000004,
-	NM_WIFI_DEVICE_CAP_CIPHER_CCMP   = 0x00000008,
-	NM_WIFI_DEVICE_CAP_WPA           = 0x00000010,
-	NM_WIFI_DEVICE_CAP_RSN           = 0x00000020,
-	NM_WIFI_DEVICE_CAP_AP            = 0x00000040,
-	NM_WIFI_DEVICE_CAP_ADHOC         = 0x00000080
-} NMDeviceWifiCapabilities;
-
-

-802.11 specific device encryption and authentication capabilities. -

-

-(Corresponds to the NM_802_11_DEVICE_CAP type in nm-device-wifi.xml.) -

-
+

enum NMDeviceWifiCapabilities

+

802.11 specific device encryption and authentication capabilities.

+

(Corresponds to the NM_802_11_DEVICE_CAP type in nm-device-wifi.xml.)

+
+

Members

+
--+++ - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + + + + + + + + + + + + + + + +

NM_WIFI_DEVICE_CAP_NONE

device has no encryption/authentication capabilities +

NM_WIFI_DEVICE_CAP_NONE

+

device has no encryption/authentication capabilities

 

NM_WIFI_DEVICE_CAP_CIPHER_WEP40

device supports 40/64-bit WEP encryption +

NM_WIFI_DEVICE_CAP_CIPHER_WEP40

+

device supports 40/64-bit WEP encryption

 

NM_WIFI_DEVICE_CAP_CIPHER_WEP104

device supports 104/128-bit WEP encryption +

NM_WIFI_DEVICE_CAP_CIPHER_WEP104

+

device supports 104/128-bit WEP encryption

 

NM_WIFI_DEVICE_CAP_CIPHER_TKIP

device supports TKIP encryption +

NM_WIFI_DEVICE_CAP_CIPHER_TKIP

+

device supports TKIP encryption

 

NM_WIFI_DEVICE_CAP_CIPHER_CCMP

device supports AES/CCMP encryption +

NM_WIFI_DEVICE_CAP_CIPHER_CCMP

+

device supports AES/CCMP encryption

 

NM_WIFI_DEVICE_CAP_WPA

device supports WPA1 authentication +

NM_WIFI_DEVICE_CAP_WPA

+

device supports WPA1 authentication

 

NM_WIFI_DEVICE_CAP_RSN

device supports WPA2/RSN authentication +

NM_WIFI_DEVICE_CAP_RSN

+

device supports WPA2/RSN authentication

 

NM_WIFI_DEVICE_CAP_AP

device supports Access Point mode +

NM_WIFI_DEVICE_CAP_AP

+

device supports Access Point mode

 

NM_WIFI_DEVICE_CAP_ADHOC

device supports Ad-Hoc mode +

NM_WIFI_DEVICE_CAP_ADHOC

+

device supports Ad-Hoc mode

 

NM_WIFI_DEVICE_CAP_FREQ_VALID

+

device reports frequency capabilities

+
 

NM_WIFI_DEVICE_CAP_FREQ_2GHZ

+

device supports 2.4GHz frequencies

+
 

NM_WIFI_DEVICE_CAP_FREQ_5GHZ

+

device supports 5GHz frequencies

+
 
+
-

enum NM80211ApFlags

-
typedef enum {
- /*< underscore_name=nm_802_11_ap_flags, flags >*/
-	NM_802_11_AP_FLAGS_NONE    = 0x00000000,
-	NM_802_11_AP_FLAGS_PRIVACY = 0x00000001
-} NM80211ApFlags;
-
-

-802.11 access point flags. -

-

-(Corresponds to the NM_802_11_AP_FLAGS type in nm-access-point.xml.) -

-
+

enum NM80211ApFlags

+

802.11 access point flags.

+

(Corresponds to the NM_802_11_AP_FLAGS type in nm-access-point.xml.)

+
+

Members

+
--+++ - - + + - - + +

NM_802_11_AP_FLAGS_NONE

access point has no special capabilities +

NM_802_11_AP_FLAGS_NONE

+

access point has no special capabilities

 

NM_802_11_AP_FLAGS_PRIVACY

access point requires authentication and -encryption (usually means WEP) +

NM_802_11_AP_FLAGS_PRIVACY

+

access point requires authentication and +encryption (usually means WEP)

 
+
-

enum NM80211ApSecurityFlags

-
typedef enum {
- /*< underscore_name=nm_802_11_ap_security_flags, flags >*/
-	NM_802_11_AP_SEC_NONE            = 0x00000000,
-	NM_802_11_AP_SEC_PAIR_WEP40      = 0x00000001,
-	NM_802_11_AP_SEC_PAIR_WEP104     = 0x00000002,
-	NM_802_11_AP_SEC_PAIR_TKIP       = 0x00000004,
-	NM_802_11_AP_SEC_PAIR_CCMP       = 0x00000008,
-	NM_802_11_AP_SEC_GROUP_WEP40     = 0x00000010,
-	NM_802_11_AP_SEC_GROUP_WEP104    = 0x00000020,
-	NM_802_11_AP_SEC_GROUP_TKIP      = 0x00000040,
-	NM_802_11_AP_SEC_GROUP_CCMP      = 0x00000080,
-	NM_802_11_AP_SEC_KEY_MGMT_PSK    = 0x00000100,
-	NM_802_11_AP_SEC_KEY_MGMT_802_1X = 0x00000200
-} NM80211ApSecurityFlags;
-
-

-802.11 access point security and authentication flags. These flags describe +

enum NM80211ApSecurityFlags

+

802.11 access point security and authentication flags. These flags describe the current security requirements of an access point as determined from the -access point's beacon. -

-

-(Corresponds to the NM_802_11_AP_SEC type in nm-access-point.xml.) -

-
+access point's beacon.

+

(Corresponds to the NM_802_11_AP_SEC type in nm-access-point.xml.)

+
+

Members

+
--+++ - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + +

NM_802_11_AP_SEC_NONE

the access point has no special security requirements +

NM_802_11_AP_SEC_NONE

+

the access point has no special security requirements

 

NM_802_11_AP_SEC_PAIR_WEP40

40/64-bit WEP is supported for -pairwise/unicast encryption +

NM_802_11_AP_SEC_PAIR_WEP40

+

40/64-bit WEP is supported for +pairwise/unicast encryption

 

NM_802_11_AP_SEC_PAIR_WEP104

104/128-bit WEP is supported for -pairwise/unicast encryption +

NM_802_11_AP_SEC_PAIR_WEP104

+

104/128-bit WEP is supported for +pairwise/unicast encryption

 

NM_802_11_AP_SEC_PAIR_TKIP

TKIP is supported for pairwise/unicast encryption +

NM_802_11_AP_SEC_PAIR_TKIP

+

TKIP is supported for pairwise/unicast encryption

 

NM_802_11_AP_SEC_PAIR_CCMP

AES/CCMP is supported for pairwise/unicast encryption +

NM_802_11_AP_SEC_PAIR_CCMP

+

AES/CCMP is supported for pairwise/unicast encryption

 

NM_802_11_AP_SEC_GROUP_WEP40

40/64-bit WEP is supported for group/broadcast -encryption +

NM_802_11_AP_SEC_GROUP_WEP40

+

40/64-bit WEP is supported for group/broadcast +encryption

 

NM_802_11_AP_SEC_GROUP_WEP104

104/128-bit WEP is supported for -group/broadcast encryption +

NM_802_11_AP_SEC_GROUP_WEP104

+

104/128-bit WEP is supported for +group/broadcast encryption

 

NM_802_11_AP_SEC_GROUP_TKIP

TKIP is supported for group/broadcast encryption +

NM_802_11_AP_SEC_GROUP_TKIP

+

TKIP is supported for group/broadcast encryption

 

NM_802_11_AP_SEC_GROUP_CCMP

AES/CCMP is supported for group/broadcast -encryption +

NM_802_11_AP_SEC_GROUP_CCMP

+

AES/CCMP is supported for group/broadcast +encryption

 

NM_802_11_AP_SEC_KEY_MGMT_PSK

WPA/RSN Pre-Shared Key encryption is -supported +

NM_802_11_AP_SEC_KEY_MGMT_PSK

+

WPA/RSN Pre-Shared Key encryption is +supported

 

NM_802_11_AP_SEC_KEY_MGMT_802_1X

802.1x authentication and key management -is supported +

NM_802_11_AP_SEC_KEY_MGMT_802_1X

+

802.1x authentication and key management +is supported

 
+
-

enum NM80211Mode

-
typedef enum {
- /*< underscore_name=nm_802_11_mode >*/
-	NM_802_11_MODE_UNKNOWN = 0,
-	NM_802_11_MODE_ADHOC,
-	NM_802_11_MODE_INFRA,
-	NM_802_11_MODE_AP
-} NM80211Mode;
-
-

-Indicates the 802.11 mode an access point or device is currently in. -

-

-(Corresponds to the NM_802_11_MODE type in generic-types.xml.) -

-
+

enum NM80211Mode

+

Indicates the 802.11 mode an access point or device is currently in.

+

(Corresponds to the NM_802_11_MODE type in generic-types.xml.)

+
+

Members

+
--+++ - - + + - - + + - - + + - - + +

NM_802_11_MODE_UNKNOWN

the device or access point mode is unknown +

NM_802_11_MODE_UNKNOWN

+

the device or access point mode is unknown

 

NM_802_11_MODE_ADHOC

for both devices and access point objects, indicates +

NM_802_11_MODE_ADHOC

+

for both devices and access point objects, indicates the object is part of an Ad-Hoc 802.11 network without a central - coordinating access point. + coordinating access point.

 

NM_802_11_MODE_INFRA

the device or access point is in infrastructure mode. +

NM_802_11_MODE_INFRA

+

the device or access point is in infrastructure mode. For devices, this indicates the device is an 802.11 client/station. For access point objects, this indicates the object is an access point that - provides connectivity to clients. + provides connectivity to clients.

 

NM_802_11_MODE_AP

the device is an access point/hotspot. Not valid for - access point objects; used only for hotspot mode on the local machine. +

NM_802_11_MODE_AP

+

the device is an access point/hotspot. Not valid for + access point objects; used only for hotspot mode on the local machine.

 
+
-

enum NMBluetoothCapabilities

-
typedef enum {
- /*< flags >*/
-	NM_BT_CAPABILITY_NONE = 0x00000000,
-	NM_BT_CAPABILITY_DUN  = 0x00000001,
-	NM_BT_CAPABILITY_NAP  = 0x00000002,
-} NMBluetoothCapabilities;
-
-

-NMBluetoothCapabilities values indicate the usable capabilities of a -Bluetooth device. -

-

-(Corresponds to the NM_BT_CAPABILITY type in nm-device-bt.xml.) -

-
+

enum NMBluetoothCapabilities

+

NMBluetoothCapabilities values indicate the usable capabilities of a +Bluetooth device.

+

(Corresponds to the NM_BT_CAPABILITY type in nm-device-bt.xml.)

+
+

Members

+
--+++ - - + + - - + + - - + +

NM_BT_CAPABILITY_NONE

device has no usable capabilities +

NM_BT_CAPABILITY_NONE

+

device has no usable capabilities

 

NM_BT_CAPABILITY_DUN

device provides Dial-Up Networking capability +

NM_BT_CAPABILITY_DUN

+

device provides Dial-Up Networking capability

 

NM_BT_CAPABILITY_NAP

device provides Network Access Point capability +

NM_BT_CAPABILITY_NAP

+

device provides Network Access Point capability

 
+
-

enum NMDeviceModemCapabilities

-
typedef enum {
- /*< flags >*/
-	NM_DEVICE_MODEM_CAPABILITY_NONE      = 0x00000000,
-	NM_DEVICE_MODEM_CAPABILITY_POTS      = 0x00000001,
-	NM_DEVICE_MODEM_CAPABILITY_CDMA_EVDO = 0x00000002,
-	NM_DEVICE_MODEM_CAPABILITY_GSM_UMTS  = 0x00000004,
-	NM_DEVICE_MODEM_CAPABILITY_LTE       = 0x00000008,
-} NMDeviceModemCapabilities;
-
-

-NMDeviceModemCapabilities values indicate the generic radio access +

enum NMDeviceModemCapabilities

+

NMDeviceModemCapabilities values indicate the generic radio access technology families a modem device supports. For more information on the specific access technologies the device supports use the ModemManager D-Bus -API. -

-

-(Corresponds to the NM_DEVICE_MODEM_CAPABILITY type in nm-device-modem.xml.) -

-
+API.

+

(Corresponds to the NM_DEVICE_MODEM_CAPABILITY type in nm-device-modem.xml.)

+
+

Members

+
--+++ - - + + - - + + - - + + - - + + - - + +

NM_DEVICE_MODEM_CAPABILITY_NONE

modem has no usable capabilities +

NM_DEVICE_MODEM_CAPABILITY_NONE

+

modem has no usable capabilities

 

NM_DEVICE_MODEM_CAPABILITY_POTS

modem uses the analog wired telephone -network and is not a wireless/cellular device +

NM_DEVICE_MODEM_CAPABILITY_POTS

+

modem uses the analog wired telephone +network and is not a wireless/cellular device

 

NM_DEVICE_MODEM_CAPABILITY_CDMA_EVDO

modem supports at least one of CDMA -1xRTT, EVDO revision 0, EVDO revision A, or EVDO revision B +

NM_DEVICE_MODEM_CAPABILITY_CDMA_EVDO

+

modem supports at least one of CDMA +1xRTT, EVDO revision 0, EVDO revision A, or EVDO revision B

 

NM_DEVICE_MODEM_CAPABILITY_GSM_UMTS

modem supports at least one of GSM, -GPRS, EDGE, UMTS, HSDPA, HSUPA, or HSPA+ packet switched data capability +

NM_DEVICE_MODEM_CAPABILITY_GSM_UMTS

+

modem supports at least one of GSM, +GPRS, EDGE, UMTS, HSDPA, HSUPA, or HSPA+ packet switched data capability

 

NM_DEVICE_MODEM_CAPABILITY_LTE

modem has LTE data capability +

NM_DEVICE_MODEM_CAPABILITY_LTE

+

modem has LTE data capability

 
+
-

enum NMDeviceState

-
typedef enum {
-	NM_DEVICE_STATE_UNKNOWN      = 0,
-	NM_DEVICE_STATE_UNMANAGED    = 10,
-	NM_DEVICE_STATE_UNAVAILABLE  = 20,
-	NM_DEVICE_STATE_DISCONNECTED = 30,
-	NM_DEVICE_STATE_PREPARE      = 40,
-	NM_DEVICE_STATE_CONFIG       = 50,
-	NM_DEVICE_STATE_NEED_AUTH    = 60,
-	NM_DEVICE_STATE_IP_CONFIG    = 70,
-	NM_DEVICE_STATE_IP_CHECK     = 80,
-	NM_DEVICE_STATE_SECONDARIES  = 90,
-	NM_DEVICE_STATE_ACTIVATED    = 100,
-	NM_DEVICE_STATE_DEACTIVATING = 110,
-	NM_DEVICE_STATE_FAILED       = 120
-} NMDeviceState;
-
-

-(Corresponds to the NM_DEVICE_STATE type in nm-device.xml.) -

-
+

enum NMDeviceState

+

(Corresponds to the NM_DEVICE_STATE type in nm-device.xml.)

+
+

Members

+
--+++ - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + +

NM_DEVICE_STATE_UNKNOWN

the device's state is unknown +

NM_DEVICE_STATE_UNKNOWN

+

the device's state is unknown

 

NM_DEVICE_STATE_UNMANAGED

the device is recognized, but not managed by - NetworkManager +

NM_DEVICE_STATE_UNMANAGED

+

the device is recognized, but not managed by + NetworkManager

 

NM_DEVICE_STATE_UNAVAILABLE

the device is managed by NetworkManager, but +

NM_DEVICE_STATE_UNAVAILABLE

+

the device is managed by NetworkManager, but is not available for use. Reasons may include the wireless switched off, missing firmware, no ethernet carrier, missing supplicant or modem manager, - etc. + etc.

 

NM_DEVICE_STATE_DISCONNECTED

the device can be activated, but is currently - idle and not connected to a network. +

NM_DEVICE_STATE_DISCONNECTED

+

the device can be activated, but is currently + idle and not connected to a network.

 

NM_DEVICE_STATE_PREPARE

the device is preparing the connection to the +

NM_DEVICE_STATE_PREPARE

+

the device is preparing the connection to the network. This may include operations like changing the MAC address, setting physical link properties, and anything else required to connect - to the requested network. + to the requested network.

 

NM_DEVICE_STATE_CONFIG

the device is connecting to the requested network. +

NM_DEVICE_STATE_CONFIG

+

the device is connecting to the requested network. This may include operations like associating with the WiFi AP, dialing - the modem, connecting to the remote Bluetooth device, etc. + the modem, connecting to the remote Bluetooth device, etc.

 

NM_DEVICE_STATE_NEED_AUTH

the device requires more information to continue +

NM_DEVICE_STATE_NEED_AUTH

+

the device requires more information to continue connecting to the requested network. This includes secrets like WiFi - passphrases, login passwords, PIN codes, etc. + passphrases, login passwords, PIN codes, etc.

 

NM_DEVICE_STATE_IP_CONFIG

the device is requesting IPv4 and/or IPv6 - addresses and routing information from the network. +

NM_DEVICE_STATE_IP_CONFIG

+

the device is requesting IPv4 and/or IPv6 + addresses and routing information from the network.

 

NM_DEVICE_STATE_IP_CHECK

the device is checking whether further action is +

NM_DEVICE_STATE_IP_CHECK

+

the device is checking whether further action is required for the requested network connection. This may include checking whether only local network access is available, whether a captive portal - is blocking access to the Internet, etc. + is blocking access to the Internet, etc.

 

NM_DEVICE_STATE_SECONDARIES

the device is waiting for a secondary +

NM_DEVICE_STATE_SECONDARIES

+

the device is waiting for a secondary connection (like a VPN) which must activated before the device can be - activated + activated

 

NM_DEVICE_STATE_ACTIVATED

the device has a network connection, either local - or global. +

NM_DEVICE_STATE_ACTIVATED

+

the device has a network connection, either local + or global.

 

NM_DEVICE_STATE_DEACTIVATING

a disconnection from the current network +

NM_DEVICE_STATE_DEACTIVATING

+

a disconnection from the current network connection was requested, and the device is cleaning up resources used for - that connection. The network connection may still be valid. + that connection. The network connection may still be valid.

 

NM_DEVICE_STATE_FAILED

the device failed to connect to the requested - network and is cleaning up the connection request +

NM_DEVICE_STATE_FAILED

+

the device failed to connect to the requested + network and is cleaning up the connection request

 
+
-

enum NMDeviceStateReason

-
typedef enum {
-	NM_DEVICE_STATE_REASON_NONE = 0,
-	NM_DEVICE_STATE_REASON_UNKNOWN = 1,
-	NM_DEVICE_STATE_REASON_NOW_MANAGED = 2,
-	NM_DEVICE_STATE_REASON_NOW_UNMANAGED = 3,
-	NM_DEVICE_STATE_REASON_CONFIG_FAILED = 4,
-	NM_DEVICE_STATE_REASON_IP_CONFIG_UNAVAILABLE = 5,
-	NM_DEVICE_STATE_REASON_IP_CONFIG_EXPIRED = 6,
-	NM_DEVICE_STATE_REASON_NO_SECRETS = 7,
-	NM_DEVICE_STATE_REASON_SUPPLICANT_DISCONNECT = 8,
-	NM_DEVICE_STATE_REASON_SUPPLICANT_CONFIG_FAILED = 9,
-	NM_DEVICE_STATE_REASON_SUPPLICANT_FAILED = 10,
-	NM_DEVICE_STATE_REASON_SUPPLICANT_TIMEOUT = 11,
-	NM_DEVICE_STATE_REASON_PPP_START_FAILED = 12,
-	NM_DEVICE_STATE_REASON_PPP_DISCONNECT = 13,
-	NM_DEVICE_STATE_REASON_PPP_FAILED = 14,
-	NM_DEVICE_STATE_REASON_DHCP_START_FAILED = 15,
-	NM_DEVICE_STATE_REASON_DHCP_ERROR = 16,
-	NM_DEVICE_STATE_REASON_DHCP_FAILED = 17,
-	NM_DEVICE_STATE_REASON_SHARED_START_FAILED = 18,
-	NM_DEVICE_STATE_REASON_SHARED_FAILED = 19,
-	NM_DEVICE_STATE_REASON_AUTOIP_START_FAILED = 20,
-	NM_DEVICE_STATE_REASON_AUTOIP_ERROR = 21,
-	NM_DEVICE_STATE_REASON_AUTOIP_FAILED = 22,
-	NM_DEVICE_STATE_REASON_MODEM_BUSY = 23,
-	NM_DEVICE_STATE_REASON_MODEM_NO_DIAL_TONE = 24,
-	NM_DEVICE_STATE_REASON_MODEM_NO_CARRIER = 25,
-	NM_DEVICE_STATE_REASON_MODEM_DIAL_TIMEOUT = 26,
-	NM_DEVICE_STATE_REASON_MODEM_DIAL_FAILED = 27,
-	NM_DEVICE_STATE_REASON_MODEM_INIT_FAILED = 28,
-	NM_DEVICE_STATE_REASON_GSM_APN_FAILED = 29,
-	NM_DEVICE_STATE_REASON_GSM_REGISTRATION_NOT_SEARCHING = 30,
-	NM_DEVICE_STATE_REASON_GSM_REGISTRATION_DENIED = 31,
-	NM_DEVICE_STATE_REASON_GSM_REGISTRATION_TIMEOUT = 32,
-	NM_DEVICE_STATE_REASON_GSM_REGISTRATION_FAILED = 33,
-	NM_DEVICE_STATE_REASON_GSM_PIN_CHECK_FAILED = 34,
-	NM_DEVICE_STATE_REASON_FIRMWARE_MISSING = 35,
-	NM_DEVICE_STATE_REASON_REMOVED = 36,
-	NM_DEVICE_STATE_REASON_SLEEPING = 37,
-	NM_DEVICE_STATE_REASON_CONNECTION_REMOVED = 38,
-	NM_DEVICE_STATE_REASON_USER_REQUESTED = 39,
-	NM_DEVICE_STATE_REASON_CARRIER = 40,
-	NM_DEVICE_STATE_REASON_CONNECTION_ASSUMED = 41,
-	NM_DEVICE_STATE_REASON_SUPPLICANT_AVAILABLE = 42,
-	NM_DEVICE_STATE_REASON_MODEM_NOT_FOUND = 43,
-	NM_DEVICE_STATE_REASON_BT_FAILED = 44,
-	NM_DEVICE_STATE_REASON_GSM_SIM_NOT_INSERTED = 45,
-	NM_DEVICE_STATE_REASON_GSM_SIM_PIN_REQUIRED = 46,
-	NM_DEVICE_STATE_REASON_GSM_SIM_PUK_REQUIRED = 47,
-	NM_DEVICE_STATE_REASON_GSM_SIM_WRONG = 48,
-	NM_DEVICE_STATE_REASON_INFINIBAND_MODE = 49,
-	NM_DEVICE_STATE_REASON_DEPENDENCY_FAILED = 50,
-	NM_DEVICE_STATE_REASON_BR2684_FAILED = 51,
-	NM_DEVICE_STATE_REASON_MODEM_MANAGER_UNAVAILABLE = 52,
-	NM_DEVICE_STATE_REASON_SSID_NOT_FOUND = 53,
-	NM_DEVICE_STATE_REASON_SECONDARY_CONNECTION_FAILED = 54,
-	NM_DEVICE_STATE_REASON_DCB_FCOE_FAILED = 55,
-	NM_DEVICE_STATE_REASON_TEAMD_CONTROL_FAILED = 56,
-	NM_DEVICE_STATE_REASON_MODEM_FAILED = 57,
-	NM_DEVICE_STATE_REASON_MODEM_AVAILABLE = 58,
-	NM_DEVICE_STATE_REASON_SIM_PIN_INCORRECT = 59,
-} NMDeviceStateReason;
-
-

-Device state change reason codes -

-

-(Corresponds to the NM_DEVICE_STATE_REASON type in nm-device.xml.) -

-
+

enum NMDeviceStateReason

+

Device state change reason codes

+

(Corresponds to the NM_DEVICE_STATE_REASON type in nm-device.xml.)

+
+

Members

+
--+++ - - + + + + + + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + +

NM_DEVICE_STATE_REASON_NONE

No reason given +

NM_DEVICE_STATE_REASON_NONE

+

No reason given

+
 

NM_DEVICE_STATE_REASON_UNKNOWN

+

Unknown error

 

NM_DEVICE_STATE_REASON_UNKNOWN

Unknown error +

NM_DEVICE_STATE_REASON_NOW_MANAGED

+

Device is now managed

 

NM_DEVICE_STATE_REASON_NOW_MANAGED

Device is now managed +

NM_DEVICE_STATE_REASON_NOW_UNMANAGED

+

Device is now unmanaged

 

NM_DEVICE_STATE_REASON_NOW_UNMANAGED

Device is now unmanaged +

NM_DEVICE_STATE_REASON_CONFIG_FAILED

+

The device could not be readied for configuration

 

NM_DEVICE_STATE_REASON_CONFIG_FAILED

The device could not be readied for configuration +

NM_DEVICE_STATE_REASON_IP_CONFIG_UNAVAILABLE

+

IP configuration could not be reserved (no available address, timeout, etc)

 

NM_DEVICE_STATE_REASON_IP_CONFIG_UNAVAILABLE

IP configuration could not be reserved (no available address, timeout, etc) +

NM_DEVICE_STATE_REASON_IP_CONFIG_EXPIRED

+

The IP config is no longer valid

 

NM_DEVICE_STATE_REASON_IP_CONFIG_EXPIRED

The IP config is no longer valid +

NM_DEVICE_STATE_REASON_NO_SECRETS

+

Secrets were required, but not provided

 

NM_DEVICE_STATE_REASON_NO_SECRETS

Secrets were required, but not provided +

NM_DEVICE_STATE_REASON_SUPPLICANT_DISCONNECT

+

802.1x supplicant disconnected

 

NM_DEVICE_STATE_REASON_SUPPLICANT_DISCONNECT

802.1x supplicant disconnected +

NM_DEVICE_STATE_REASON_SUPPLICANT_CONFIG_FAILED

+

802.1x supplicant configuration failed

 

NM_DEVICE_STATE_REASON_SUPPLICANT_CONFIG_FAILED

802.1x supplicant configuration failed +

NM_DEVICE_STATE_REASON_SUPPLICANT_FAILED

+

802.1x supplicant failed

 

NM_DEVICE_STATE_REASON_SUPPLICANT_FAILED

802.1x supplicant failed +

NM_DEVICE_STATE_REASON_SUPPLICANT_TIMEOUT

+

802.1x supplicant took too long to authenticate

 

NM_DEVICE_STATE_REASON_SUPPLICANT_TIMEOUT

802.1x supplicant took too long to authenticate +

NM_DEVICE_STATE_REASON_PPP_START_FAILED

+

PPP service failed to start

 

NM_DEVICE_STATE_REASON_PPP_START_FAILED

PPP service failed to start +

NM_DEVICE_STATE_REASON_PPP_DISCONNECT

+

PPP service disconnected

 

NM_DEVICE_STATE_REASON_PPP_DISCONNECT

PPP service disconnected +

NM_DEVICE_STATE_REASON_PPP_FAILED

+

PPP failed

 

NM_DEVICE_STATE_REASON_PPP_FAILED

PPP failed +

NM_DEVICE_STATE_REASON_DHCP_START_FAILED

+

DHCP client failed to start

 

NM_DEVICE_STATE_REASON_DHCP_START_FAILED

DHCP client failed to start +

NM_DEVICE_STATE_REASON_DHCP_ERROR

+

DHCP client error

 

NM_DEVICE_STATE_REASON_DHCP_ERROR

DHCP client error +

NM_DEVICE_STATE_REASON_DHCP_FAILED

+

DHCP client failed

 

NM_DEVICE_STATE_REASON_DHCP_FAILED

DHCP client failed +

NM_DEVICE_STATE_REASON_SHARED_START_FAILED

+

Shared connection service failed to start

 

NM_DEVICE_STATE_REASON_SHARED_START_FAILED

Shared connection service failed to start +

NM_DEVICE_STATE_REASON_SHARED_FAILED

+

Shared connection service failed

 

NM_DEVICE_STATE_REASON_SHARED_FAILED

Shared connection service failed +

NM_DEVICE_STATE_REASON_AUTOIP_START_FAILED

+

AutoIP service failed to start

 

NM_DEVICE_STATE_REASON_AUTOIP_START_FAILED

AutoIP service failed to start +

NM_DEVICE_STATE_REASON_AUTOIP_ERROR

+

AutoIP service error

 

NM_DEVICE_STATE_REASON_AUTOIP_ERROR

AutoIP service error +

NM_DEVICE_STATE_REASON_AUTOIP_FAILED

+

AutoIP service failed

 

NM_DEVICE_STATE_REASON_AUTOIP_FAILED

AutoIP service failed +

NM_DEVICE_STATE_REASON_MODEM_BUSY

+

The line is busy

 

NM_DEVICE_STATE_REASON_MODEM_BUSY

The line is busy +

NM_DEVICE_STATE_REASON_MODEM_NO_DIAL_TONE

+

No dial tone

 

NM_DEVICE_STATE_REASON_MODEM_NO_DIAL_TONE

No dial tone +

NM_DEVICE_STATE_REASON_MODEM_NO_CARRIER

+

No carrier could be established

 

NM_DEVICE_STATE_REASON_MODEM_NO_CARRIER

No carrier could be established +

NM_DEVICE_STATE_REASON_MODEM_DIAL_TIMEOUT

+

The dialing request timed out

 

NM_DEVICE_STATE_REASON_MODEM_DIAL_TIMEOUT

The dialing request timed out +

NM_DEVICE_STATE_REASON_MODEM_DIAL_FAILED

+

The dialing attempt failed

 

NM_DEVICE_STATE_REASON_MODEM_DIAL_FAILED

The dialing attempt failed +

NM_DEVICE_STATE_REASON_MODEM_INIT_FAILED

+

Modem initialization failed

 

NM_DEVICE_STATE_REASON_MODEM_INIT_FAILED

Modem initialization failed +

NM_DEVICE_STATE_REASON_GSM_APN_FAILED

+

Failed to select the specified APN

 

NM_DEVICE_STATE_REASON_GSM_APN_FAILED

Failed to select the specified APN +

NM_DEVICE_STATE_REASON_GSM_REGISTRATION_NOT_SEARCHING

+

Not searching for networks

 

NM_DEVICE_STATE_REASON_GSM_REGISTRATION_NOT_SEARCHING

Not searching for networks +

NM_DEVICE_STATE_REASON_GSM_REGISTRATION_DENIED

+

Network registration denied

 

NM_DEVICE_STATE_REASON_GSM_REGISTRATION_DENIED

Network registration denied +

NM_DEVICE_STATE_REASON_GSM_REGISTRATION_TIMEOUT

+

Network registration timed out

 

NM_DEVICE_STATE_REASON_GSM_REGISTRATION_TIMEOUT

Network registration timed out +

NM_DEVICE_STATE_REASON_GSM_REGISTRATION_FAILED

+

Failed to register with the requested network

 

NM_DEVICE_STATE_REASON_GSM_REGISTRATION_FAILED

Failed to register with the requested network +

NM_DEVICE_STATE_REASON_GSM_PIN_CHECK_FAILED

+

PIN check failed

 

NM_DEVICE_STATE_REASON_GSM_PIN_CHECK_FAILED

PIN check failed +

NM_DEVICE_STATE_REASON_FIRMWARE_MISSING

+

Necessary firmware for the device may be missing

 

NM_DEVICE_STATE_REASON_FIRMWARE_MISSING

Necessary firmware for the device may be missing +

NM_DEVICE_STATE_REASON_REMOVED

+

The device was removed

 

NM_DEVICE_STATE_REASON_REMOVED

The device was removed +

NM_DEVICE_STATE_REASON_SLEEPING

+

NetworkManager went to sleep

 

NM_DEVICE_STATE_REASON_SLEEPING

NetworkManager went to sleep +

NM_DEVICE_STATE_REASON_CONNECTION_REMOVED

+

The device's active connection disappeared

 

NM_DEVICE_STATE_REASON_CONNECTION_REMOVED

The device's active connection disappeared +

NM_DEVICE_STATE_REASON_USER_REQUESTED

+

Device disconnected by user or client

 

NM_DEVICE_STATE_REASON_USER_REQUESTED

Device disconnected by user or client +

NM_DEVICE_STATE_REASON_CARRIER

+

Carrier/link changed

 

NM_DEVICE_STATE_REASON_CARRIER

Carrier/link changed +

NM_DEVICE_STATE_REASON_CONNECTION_ASSUMED

+

The device's existing connection was assumed

 

NM_DEVICE_STATE_REASON_CONNECTION_ASSUMED

The device's existing connection was assumed +

NM_DEVICE_STATE_REASON_SUPPLICANT_AVAILABLE

+

The supplicant is now available

 

NM_DEVICE_STATE_REASON_SUPPLICANT_AVAILABLE

The supplicant is now available +

NM_DEVICE_STATE_REASON_MODEM_NOT_FOUND

+

The modem could not be found

 

NM_DEVICE_STATE_REASON_MODEM_NOT_FOUND

The modem could not be found +

NM_DEVICE_STATE_REASON_BT_FAILED

+

The Bluetooth connection failed or timed out

 

NM_DEVICE_STATE_REASON_BT_FAILED

The Bluetooth connection failed or timed out +

NM_DEVICE_STATE_REASON_GSM_SIM_NOT_INSERTED

+

GSM Modem's SIM Card not inserted

 

NM_DEVICE_STATE_REASON_GSM_SIM_NOT_INSERTED

GSM Modem's SIM Card not inserted +

NM_DEVICE_STATE_REASON_GSM_SIM_PIN_REQUIRED

+

GSM Modem's SIM Pin required

 

NM_DEVICE_STATE_REASON_GSM_SIM_PIN_REQUIRED

GSM Modem's SIM Pin required +

NM_DEVICE_STATE_REASON_GSM_SIM_PUK_REQUIRED

+

GSM Modem's SIM Puk required

 

NM_DEVICE_STATE_REASON_GSM_SIM_PUK_REQUIRED

GSM Modem's SIM Puk required +

NM_DEVICE_STATE_REASON_GSM_SIM_WRONG

+

GSM Modem's SIM wrong

 

NM_DEVICE_STATE_REASON_GSM_SIM_WRONG

GSM Modem's SIM wrong +

NM_DEVICE_STATE_REASON_INFINIBAND_MODE

+

InfiniBand device does not support connected mode

 

NM_DEVICE_STATE_REASON_INFINIBAND_MODE

InfiniBand device does not support connected mode +

NM_DEVICE_STATE_REASON_DEPENDENCY_FAILED

+

A dependency of the connection failed

 

NM_DEVICE_STATE_REASON_DEPENDENCY_FAILED

A dependency of the connection failed +

NM_DEVICE_STATE_REASON_BR2684_FAILED

+

Problem with the RFC 2684 Ethernet over ADSL bridge

 

NM_DEVICE_STATE_REASON_BR2684_FAILED

Problem with the RFC 2684 Ethernet over ADSL bridge +

NM_DEVICE_STATE_REASON_MODEM_MANAGER_UNAVAILABLE

+

ModemManager not running

 

NM_DEVICE_STATE_REASON_MODEM_MANAGER_UNAVAILABLE

ModemManager not running +

NM_DEVICE_STATE_REASON_SSID_NOT_FOUND

+

The WiFi network could not be found

 

NM_DEVICE_STATE_REASON_SSID_NOT_FOUND

The WiFi network could not be found +

NM_DEVICE_STATE_REASON_SECONDARY_CONNECTION_FAILED

+

A secondary connection of the base connection failed

 

NM_DEVICE_STATE_REASON_SECONDARY_CONNECTION_FAILED

A secondary connection of the base connection failed +

NM_DEVICE_STATE_REASON_DCB_FCOE_FAILED

+

DCB or FCoE setup failed

 

NM_DEVICE_STATE_REASON_DCB_FCOE_FAILED

DCB or FCoE setup failed +

NM_DEVICE_STATE_REASON_TEAMD_CONTROL_FAILED

+

teamd control failed

 

NM_DEVICE_STATE_REASON_TEAMD_CONTROL_FAILED

teamd control failed +

NM_DEVICE_STATE_REASON_MODEM_FAILED

+

Modem failed or no longer available

 

NM_DEVICE_STATE_REASON_MODEM_FAILED

Modem failed or no longer available +

NM_DEVICE_STATE_REASON_MODEM_AVAILABLE

+

Modem now ready and available

 

NM_DEVICE_STATE_REASON_MODEM_AVAILABLE

Modem now ready and available +

NM_DEVICE_STATE_REASON_SIM_PIN_INCORRECT

+

SIM PIN was incorrect

 

NM_DEVICE_STATE_REASON_SIM_PIN_INCORRECT

SIM PIN was incorrect +

NM_DEVICE_STATE_REASON_NEW_ACTIVATION

+

New connection activation was enqueued

 
+
-

enum NMActiveConnectionState

-
typedef enum {
-	NM_ACTIVE_CONNECTION_STATE_UNKNOWN = 0,
-	NM_ACTIVE_CONNECTION_STATE_ACTIVATING,
-	NM_ACTIVE_CONNECTION_STATE_ACTIVATED,
-	NM_ACTIVE_CONNECTION_STATE_DEACTIVATING,
-	NM_ACTIVE_CONNECTION_STATE_DEACTIVATED
-} NMActiveConnectionState;
-
-

-NMActiveConnectionState values indicate the state of a connection to a +

enum NMActiveConnectionState

+

NMActiveConnectionState values indicate the state of a connection to a specific network while it is starting, connected, or disconnecting from that -network. -

-

-(Corresponds to the NM_ACTIVE_CONNECTION_STATE type in nm-active-connection.xml.) -

-
+network.

+

(Corresponds to the NM_ACTIVE_CONNECTION_STATE type in nm-active-connection.xml.)

+
+

Members

+
--+++ - - + + - - + + - - + + - - + + - - + +

NM_ACTIVE_CONNECTION_STATE_UNKNOWN

the state of the connection is unknown +

NM_ACTIVE_CONNECTION_STATE_UNKNOWN

+

the state of the connection is unknown

 

NM_ACTIVE_CONNECTION_STATE_ACTIVATING

a network connection is being prepared +

NM_ACTIVE_CONNECTION_STATE_ACTIVATING

+

a network connection is being prepared

 

NM_ACTIVE_CONNECTION_STATE_ACTIVATED

there is a connection to the network +

NM_ACTIVE_CONNECTION_STATE_ACTIVATED

+

there is a connection to the network

 

NM_ACTIVE_CONNECTION_STATE_DEACTIVATING

the network connection is being - torn down and cleaned up +

NM_ACTIVE_CONNECTION_STATE_DEACTIVATING

+

the network connection is being + torn down and cleaned up

 

NM_ACTIVE_CONNECTION_STATE_DEACTIVATED

the network connection is disconnected - and will be removed +

NM_ACTIVE_CONNECTION_STATE_DEACTIVATED

+

the network connection is disconnected + and will be removed

 
+
-

enum NMSecretAgentGetSecretsFlags

-
typedef enum {
- /*< flags >*/
-	NM_SECRET_AGENT_GET_SECRETS_FLAG_NONE = 0x0,
-	NM_SECRET_AGENT_GET_SECRETS_FLAG_ALLOW_INTERACTION = 0x1,
-	NM_SECRET_AGENT_GET_SECRETS_FLAG_REQUEST_NEW = 0x2,
-	NM_SECRET_AGENT_GET_SECRETS_FLAG_USER_REQUESTED = 0x4,
-
-	/* Internal to NM; not part of the D-Bus API */
-	NM_SECRET_AGENT_GET_SECRETS_FLAG_ONLY_SYSTEM = 0x80000000,
-	NM_SECRET_AGENT_GET_SECRETS_FLAG_NO_ERRORS = 0x40000000,
-} NMSecretAgentGetSecretsFlags;
-
-

-NMSecretAgentGetSecretsFlags values modify the behavior of a GetSecrets request. -

-

-(Corresponds to the NM_SECRET_AGENT_GET_SECRETS_FLAGS type in nm-secret-agent.xml.) -

-
+

enum NMSecretAgentGetSecretsFlags

+

NMSecretAgentGetSecretsFlags values modify the behavior of a GetSecrets request.

+

(Corresponds to the NM_SECRET_AGENT_GET_SECRETS_FLAGS type in nm-secret-agent.xml.)

+
+

Members

+
--+++ - - + + - - + + - - + + - - + + - - + + - - + +

NM_SECRET_AGENT_GET_SECRETS_FLAG_NONE

no special behavior; by default no +

NM_SECRET_AGENT_GET_SECRETS_FLAG_NONE

+

no special behavior; by default no user interaction is allowed and requests for secrets are fulfilled from - persistent storage, or if no secrets are available an error is returned. + persistent storage, or if no secrets are available an error is returned.

 

NM_SECRET_AGENT_GET_SECRETS_FLAG_ALLOW_INTERACTION

allows the request to +

NM_SECRET_AGENT_GET_SECRETS_FLAG_ALLOW_INTERACTION

+

allows the request to interact with the user, possibly prompting via UI for secrets if any are - required, or if none are found in persistent storage. + required, or if none are found in persistent storage.

 

NM_SECRET_AGENT_GET_SECRETS_FLAG_REQUEST_NEW

explicitly prompt for new +

NM_SECRET_AGENT_GET_SECRETS_FLAG_REQUEST_NEW

+

explicitly prompt for new secrets from the user. This flag signals that NetworkManager thinks any existing secrets are invalid or wrong. This flag implies that interaction - is allowed. + is allowed.

 

NM_SECRET_AGENT_GET_SECRETS_FLAG_USER_REQUESTED

set if the request was +

NM_SECRET_AGENT_GET_SECRETS_FLAG_USER_REQUESTED

+

set if the request was initiated by user-requested action via the D-Bus interface, as opposed to automatically initiated by NetworkManager in response to (for example) scan - results or carrier changes. + results or carrier changes.

 

NM_SECRET_AGENT_GET_SECRETS_FLAG_ONLY_SYSTEM

Internal flag, not part of - the D-Bus API. +

NM_SECRET_AGENT_GET_SECRETS_FLAG_ONLY_SYSTEM

+

Internal flag, not part of + the D-Bus API.

 

NM_SECRET_AGENT_GET_SECRETS_FLAG_NO_ERRORS

Internal flag, not part of - the D-Bus API. +

NM_SECRET_AGENT_GET_SECRETS_FLAG_NO_ERRORS

+

Internal flag, not part of + the D-Bus API.

 
+
-

enum NMSecretAgentCapabilities

-
typedef enum {
-	NM_SECRET_AGENT_CAPABILITY_NONE = 0x0,
-	NM_SECRET_AGENT_CAPABILITY_VPN_HINTS = 0x1,
-
-	/* boundary value */
-	NM_SECRET_AGENT_CAPABILITY_LAST = NM_SECRET_AGENT_CAPABILITY_VPN_HINTS
-} NMSecretAgentCapabilities;
-
-

-NMSecretAgentCapabilities indicate various capabilities of the agent. -

-

-(Corresponds to the NM_SECRET_AGENT_CAPABILITIES type in nm-secret-agent.xml.) -

-
+

enum NMSecretAgentCapabilities

+

NMSecretAgentCapabilities indicate various capabilities of the agent.

+

(Corresponds to the NM_SECRET_AGENT_CAPABILITIES type in nm-secret-agent.xml.)

+
+

Members

+
--+++ - - + + - - + + - - + +

NM_SECRET_AGENT_CAPABILITY_NONE

the agent supports no special capabilities +

NM_SECRET_AGENT_CAPABILITY_NONE

+

the agent supports no special capabilities

 

NM_SECRET_AGENT_CAPABILITY_VPN_HINTS

the agent supports passing hints to -VPN plugin authentication dialogs. +

NM_SECRET_AGENT_CAPABILITY_VPN_HINTS

+

the agent supports passing hints to +VPN plugin authentication dialogs.

 

NM_SECRET_AGENT_CAPABILITY_LAST

bounds checking value; should not be used. +

NM_SECRET_AGENT_CAPABILITY_LAST

+

bounds checking value; should not be used.

 
+ + Generated by GTK-Doc V1.21 \ No newline at end of file diff --git a/docs/libnm/html/libnm-nm-errors.html b/docs/libnm/html/libnm-nm-errors.html index 79a6365c..b62be03e 100644 --- a/docs/libnm/html/libnm-nm-errors.html +++ b/docs/libnm/html/libnm-nm-errors.html @@ -2,32 +2,27 @@ -nm-errors +libnm Reference Manual: nm-errors - + - - - - - - - - - - + + + + + + +
@@ -35,69 +30,169 @@

nm-errors

nm-errors

- +
-
-

Synopsis

-
enum                NMAgentManagerError;
-GQuark              nm_agent_manager_error_quark        (void);
-#define             NM_AGENT_MANAGER_ERROR
-enum                NMConnectionError;
-#define             NM_CONNECTION_ERROR
-GQuark              nm_connection_error_quark           (void);
-enum                NMCryptoError;
-#define             NM_CRYPTO_ERROR
-GQuark              nm_crypto_error_quark               (void);
-enum                NMDeviceError;
-#define             NM_DEVICE_ERROR
-GQuark              nm_device_error_quark               (void);
-enum                NMManagerError;
-GQuark              nm_manager_error_quark              (void);
-#define             NM_MANAGER_ERROR
-enum                NMSecretAgentError;
-GQuark              nm_secret_agent_error_quark         (void);
-#define             NM_SECRET_AGENT_ERROR
-enum                NMSettingsError;
-GQuark              nm_settings_error_quark             (void);
-#define             NM_SETTINGS_ERROR
-enum                NMVpnPluginError;
-#define             NM_VPN_PLUGIN_ERROR
-GQuark              nm_vpn_plugin_error_quark           (void);
-
+
+

Functions

+
++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+GQuark + +nm_agent_manager_error_quark () +
#defineNM_AGENT_MANAGER_ERROR
+GQuark + +nm_connection_error_quark () +
+GQuark + +nm_crypto_error_quark () +
+GQuark + +nm_device_error_quark () +
+GQuark + +nm_manager_error_quark () +
#defineNM_MANAGER_ERROR
+GQuark + +nm_secret_agent_error_quark () +
#defineNM_SECRET_AGENT_ERROR
+GQuark + +nm_settings_error_quark () +
#defineNM_SETTINGS_ERROR
#defineNM_VPN_PLUGIN_ERROR
+GQuark + +nm_vpn_plugin_error_quark () +
+
+
+

Types and Values

+
++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
enumNMAgentManagerError
enumNMConnectionError
#defineNM_CONNECTION_ERROR
enumNMCryptoError
#defineNM_CRYPTO_ERROR
enumNMDeviceError
#defineNM_DEVICE_ERROR
enumNMManagerError
enumNMSecretAgentError
enumNMSettingsError
enumNMVpnPluginError

Object Hierarchy

-
-  GEnum
-   +----NMAgentManagerError
-
-
-  GEnum
-   +----NMConnectionError
-
-
-  GEnum
-   +----NMCryptoError
-
-
-  GEnum
-   +----NMDeviceError
-
-
-  GEnum
-   +----NMManagerError
-
-
-  GEnum
-   +----NMSecretAgentError
-
-
-  GEnum
-   +----NMSettingsError
-
-
-  GEnum
-   +----NMVpnPluginError
+
    GEnum
+    ├── NMAgentManagerError
+    ├── NMConnectionError
+    ├── NMCryptoError
+    ├── NMDeviceError
+    ├── NMManagerError
+    ├── NMSecretAgentError
+    ├── NMSettingsError
+    ╰── NMVpnPluginError
 
@@ -106,175 +201,306 @@ enum -

Details

+

Functions

-

enum NMAgentManagerError

-
typedef enum {
-	NM_AGENT_MANAGER_ERROR_FAILED = 0,         /*< nick=Failed >*/
-	NM_AGENT_MANAGER_ERROR_PERMISSION_DENIED,  /*< nick=PermissionDenied >*/
-	NM_AGENT_MANAGER_ERROR_INVALID_IDENTIFIER, /*< nick=InvalidIdentifier >*/
-	NM_AGENT_MANAGER_ERROR_NOT_REGISTERED,     /*< nick=NotRegistered >*/
-	NM_AGENT_MANAGER_ERROR_NO_SECRETS,         /*< nick=NoSecrets >*/
-	NM_AGENT_MANAGER_ERROR_USER_CANCELED,      /*< nick=UserCanceled >*/
-} NMAgentManagerError;
+

nm_agent_manager_error_quark ()

+
GQuark
+nm_agent_manager_error_quark (void);
+

+

+
+

Returns

+

+
+
+
+
+

NM_AGENT_MANAGER_ERROR

+
#define NM_AGENT_MANAGER_ERROR (nm_agent_manager_error_quark ())
 

-Errors returned from the secret-agent manager.

+
+
+
+

nm_connection_error_quark ()

+
GQuark
+nm_connection_error_quark (void);
+

+

+
+

Returns

+

+
+
+
+
+

nm_crypto_error_quark ()

+
GQuark
+nm_crypto_error_quark (void);
+

+

+
+

Returns

+

+
+
+
+
+

nm_device_error_quark ()

+
GQuark
+nm_device_error_quark (void);
+

+

+
+

Returns

+

+
+
+
+
+

nm_manager_error_quark ()

+
GQuark
+nm_manager_error_quark (void);

-These errors may be returned from operations that could cause secrets to be -requested (such as nm_client_activate_connection()), and correspond to D-Bus -errors in the "org.freedesktop.NetworkManager.AgentManager" namespace.

-
+
+

Returns

+

+
+ +
+
+

NM_MANAGER_ERROR

+
#define NM_MANAGER_ERROR (nm_manager_error_quark ())
+
+

+

+
+
+
+

nm_secret_agent_error_quark ()

+
GQuark
+nm_secret_agent_error_quark (void);
+

+

+
+

Returns

+

+
+
+
+
+

NM_SECRET_AGENT_ERROR

+
#define NM_SECRET_AGENT_ERROR         (nm_secret_agent_error_quark ())
+
+

+

+
+
+
+

nm_settings_error_quark ()

+
GQuark
+nm_settings_error_quark (void);
+

+

+
+

Returns

+

+
+
+
+
+

NM_SETTINGS_ERROR

+
#define NM_SETTINGS_ERROR (nm_settings_error_quark ())
+
+

+

+
+
+
+

NM_VPN_PLUGIN_ERROR

+
#define NM_VPN_PLUGIN_ERROR      (nm_vpn_plugin_error_quark ())
+
+

+

+
+
+
+

nm_vpn_plugin_error_quark ()

+
GQuark
+nm_vpn_plugin_error_quark (void);
+

+

+
+

Returns

+

+
+
+ +
+

Types and Values

+
+

enum NMAgentManagerError

+

Errors returned from the secret-agent manager.

+

These errors may be returned from operations that could cause secrets to be +requested (such as nm_client_activate_connection()), and correspond to D-Bus +errors in the "org.freedesktop.NetworkManager.AgentManager" namespace.

+
+

Members

+
--+++ - - + + - - + + - - + + - - + + - - + + - - + +

NM_AGENT_MANAGER_ERROR_FAILED

unknown or unspecified error +

NM_AGENT_MANAGER_ERROR_FAILED

+

unknown or unspecified error

 

NM_AGENT_MANAGER_ERROR_PERMISSION_DENIED

The caller does not have permission +

NM_AGENT_MANAGER_ERROR_PERMISSION_DENIED

+

The caller does not have permission to register a secret agent, or is trying to register the same secret agent - twice. + twice.

 

NM_AGENT_MANAGER_ERROR_INVALID_IDENTIFIER

The identifier is not a valid - secret agent identifier. +

NM_AGENT_MANAGER_ERROR_INVALID_IDENTIFIER

+

The identifier is not a valid + secret agent identifier.

 

NM_AGENT_MANAGER_ERROR_NOT_REGISTERED

The caller tried to unregister an agent - that was not registered. +

NM_AGENT_MANAGER_ERROR_NOT_REGISTERED

+

The caller tried to unregister an agent + that was not registered.

 

NM_AGENT_MANAGER_ERROR_NO_SECRETS

No secret agent returned secrets for this - request +

NM_AGENT_MANAGER_ERROR_NO_SECRETS

+

No secret agent returned secrets for this + request

 

NM_AGENT_MANAGER_ERROR_USER_CANCELED

The user canceled the secrets request. +

NM_AGENT_MANAGER_ERROR_USER_CANCELED

+

The user canceled the secrets request.

 
-
-
-

nm_agent_manager_error_quark ()

-
GQuark              nm_agent_manager_error_quark        (void);
-

-

-
-
-
-

NM_AGENT_MANAGER_ERROR

-
#define NM_AGENT_MANAGER_ERROR (nm_agent_manager_error_quark ())
-
-

-


-

enum NMConnectionError

-
typedef enum {
-	NM_CONNECTION_ERROR_FAILED = 0,                   /*< nick=Failed >*/
-	NM_CONNECTION_ERROR_SETTING_NOT_FOUND,            /*< nick=SettingNotFound >*/
-	NM_CONNECTION_ERROR_PROPERTY_NOT_FOUND,           /*< nick=PropertyNotFound >*/
-	NM_CONNECTION_ERROR_PROPERTY_NOT_SECRET,          /*< nick=PropertyNotSecret >*/
-	NM_CONNECTION_ERROR_MISSING_SETTING,              /*< nick=MissingSetting >*/
-	NM_CONNECTION_ERROR_INVALID_SETTING,              /*< nick=InvalidSetting >*/
-	NM_CONNECTION_ERROR_MISSING_PROPERTY,             /*< nick=MissingProperty >*/
-	NM_CONNECTION_ERROR_INVALID_PROPERTY,             /*< nick=InvalidProperty >*/
-} NMConnectionError;
-
-

-Describes errors that may result from operations involving a NMConnection -or its NMSettings. -

-

-These errors may be returned directly from NMConnection and NMSetting +

enum NMConnectionError

+

Describes errors that may result from operations involving a NMConnection +or its NMSettings.

+

These errors may be returned directly from NMConnection and NMSetting methods, or may be returned from D-Bus operations (eg on NMClient or NMDevice), where they correspond to errors in the -"org.freedesktop.NetworkManager.Settings.Connection" namespace. -

-
+"org.freedesktop.NetworkManager.Settings.Connection" namespace.

+
+

Members

+
--+++ - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + +

NM_CONNECTION_ERROR_FAILED

unknown or unclassified error +

NM_CONNECTION_ERROR_FAILED

+

unknown or unclassified error

 

NM_CONNECTION_ERROR_SETTING_NOT_FOUND

the NMConnection object - did not contain the specified NMSetting object +

NM_CONNECTION_ERROR_SETTING_NOT_FOUND

+

the NMConnection object + did not contain the specified NMSetting object

 

NM_CONNECTION_ERROR_PROPERTY_NOT_FOUND

the NMConnection did not contain the - requested NMSetting property +

NM_CONNECTION_ERROR_PROPERTY_NOT_FOUND

+

the NMConnection did not contain the + requested NMSetting property

 

NM_CONNECTION_ERROR_PROPERTY_NOT_SECRET

an operation which requires a secret - was attempted on a non-secret property +

NM_CONNECTION_ERROR_PROPERTY_NOT_SECRET

+

an operation which requires a secret + was attempted on a non-secret property

 

NM_CONNECTION_ERROR_MISSING_SETTING

the NMConnection object is missing an +

NM_CONNECTION_ERROR_MISSING_SETTING

+

the NMConnection object is missing an NMSetting which is required for its configuration. The error message will always be prefixed with "<setting-name>: ", where "<setting-name>" is the - name of the setting that is missing. + name of the setting that is missing.

 

NM_CONNECTION_ERROR_INVALID_SETTING

the NMConnection object contains an +

NM_CONNECTION_ERROR_INVALID_SETTING

+

the NMConnection object contains an invalid or inappropriate NMSetting. The error message will always be prefixed with "<setting-name>: ", where "<setting-name>" is the name of the - setting that is invalid. + setting that is invalid.

 

NM_CONNECTION_ERROR_MISSING_PROPERTY

the NMConnection object is invalid +

NM_CONNECTION_ERROR_MISSING_PROPERTY

+

the NMConnection object is invalid because it is missing a required property. The error message will always be prefixed with "<setting-name>.<property-name>: ", where "<setting-name>" is the name of the setting with the missing property, and "<property-name>" is - the property that is missing. + the property that is missing.

 

NM_CONNECTION_ERROR_INVALID_PROPERTY

the NMConnection object is invalid +

NM_CONNECTION_ERROR_INVALID_PROPERTY

+

the NMConnection object is invalid because a property has an invalid value. The error message will always be prefixed with "<setting-name>.<property-name>: ", where "<setting-name>" is the name of the setting with the invalid property, and "<property-name>" is - the property that is invalid. + the property that is invalid.

 
+

NM_CONNECTION_ERROR

@@ -285,67 +511,65 @@ methods, or may be returned from D-Bus operations (eg on -

nm_connection_error_quark ()

-
GQuark              nm_connection_error_quark           (void);
-

-

-
-
-
-

enum NMCryptoError

-
typedef enum {
-	NM_CRYPTO_ERROR_FAILED = 0,
-	NM_CRYPTO_ERROR_INVALID_DATA,
-	NM_CRYPTO_ERROR_INVALID_PASSWORD,
-	NM_CRYPTO_ERROR_UNKNOWN_CIPHER,
-	NM_CRYPTO_ERROR_DECRYPTION_FAILED,
-	NM_CRYPTO_ERROR_ENCRYPTION_FAILED,
-} NMCryptoError;
-
-

-Cryptography-related errors that can be returned from some nm-utils methods, -and some NMSetting8021x operations. -

-
+

enum NMCryptoError

+

Cryptography-related errors that can be returned from some nm-utils methods, +and some NMSetting8021x operations.

+
+

Members

+
--+++ - - + + - - + + - - + + - - + + - - + + - - + +

NM_CRYPTO_ERROR_FAILED

generic failure +

NM_CRYPTO_ERROR_FAILED

+

generic failure

 

NM_CRYPTO_ERROR_INVALID_DATA

the certificate or key data provided - was invalid +

NM_CRYPTO_ERROR_INVALID_DATA

+

the certificate or key data provided + was invalid

 

NM_CRYPTO_ERROR_INVALID_PASSWORD

the password was invalid +

NM_CRYPTO_ERROR_INVALID_PASSWORD

+

the password was invalid

 

NM_CRYPTO_ERROR_UNKNOWN_CIPHER

the data uses an unknown cipher +

NM_CRYPTO_ERROR_UNKNOWN_CIPHER

+

the data uses an unknown cipher

 

NM_CRYPTO_ERROR_DECRYPTION_FAILED

decryption failed +

NM_CRYPTO_ERROR_DECRYPTION_FAILED

+

decryption failed

 

NM_CRYPTO_ERROR_ENCRYPTION_FAILED

encryption failed +

NM_CRYPTO_ERROR_ENCRYPTION_FAILED

+

encryption failed

 
+

NM_CRYPTO_ERROR

@@ -356,87 +580,85 @@ and some
-

nm_crypto_error_quark ()

-
GQuark              nm_crypto_error_quark               (void);
-

-

-
-
-
-

enum NMDeviceError

-
typedef enum {
-	NM_DEVICE_ERROR_FAILED = 0,                /*< nick=Failed >*/
-	NM_DEVICE_ERROR_CREATION_FAILED,           /*< nick=CreationFailed >*/
-	NM_DEVICE_ERROR_INVALID_CONNECTION,        /*< nick=InvalidConnection >*/
-	NM_DEVICE_ERROR_INCOMPATIBLE_CONNECTION,   /*< nick=IncompatibleConnection >*/
-	NM_DEVICE_ERROR_NOT_ACTIVE,                /*< nick=NotActive >*/
-	NM_DEVICE_ERROR_NOT_SOFTWARE,              /*< nick=NotSoftware >*/
-	NM_DEVICE_ERROR_NOT_ALLOWED,               /*< nick=NotAllowed >*/
-	NM_DEVICE_ERROR_SPECIFIC_OBJECT_NOT_FOUND, /*< nick=SpecificObjectNotFound >*/
-} NMDeviceError;
-
-

-Device-related errors. -

-

-These errors may be returned directly from NMDevice methods, or may be +

enum NMDeviceError

+

Device-related errors.

+

These errors may be returned directly from NMDevice methods, or may be returned from D-Bus operations (where they correspond to errors in the -"org.freedesktop.NetworkManager.Device" namespace). -

-
+"org.freedesktop.NetworkManager.Device" namespace).

+
+

Members

+
--+++ - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + +

NM_DEVICE_ERROR_FAILED

unknown or unclassified error +

NM_DEVICE_ERROR_FAILED

+

unknown or unclassified error

 

NM_DEVICE_ERROR_CREATION_FAILED

NetworkManager failed to create the device +

NM_DEVICE_ERROR_CREATION_FAILED

+

NetworkManager failed to create the device

 

NM_DEVICE_ERROR_INVALID_CONNECTION

the specified connection is not valid +

NM_DEVICE_ERROR_INVALID_CONNECTION

+

the specified connection is not valid

 

NM_DEVICE_ERROR_INCOMPATIBLE_CONNECTION

the specified connection is not - compatible with this device. +

NM_DEVICE_ERROR_INCOMPATIBLE_CONNECTION

+

the specified connection is not + compatible with this device.

 

NM_DEVICE_ERROR_NOT_ACTIVE

the device does not have an active connection +

NM_DEVICE_ERROR_NOT_ACTIVE

+

the device does not have an active connection

 

NM_DEVICE_ERROR_NOT_SOFTWARE

the requested operation is only valid on - software devices. +

NM_DEVICE_ERROR_NOT_SOFTWARE

+

the requested operation is only valid on + software devices.

 

NM_DEVICE_ERROR_NOT_ALLOWED

the requested operation is not allowed at - this time. +

NM_DEVICE_ERROR_NOT_ALLOWED

+

the requested operation is not allowed at + this time.

 

NM_DEVICE_ERROR_SPECIFIC_OBJECT_NOT_FOUND

the "specific object" in the +

NM_DEVICE_ERROR_SPECIFIC_OBJECT_NOT_FOUND

+

the "specific object" in the activation request (eg, the NMAccessPoint or NMWimaxNsp) was not - found. + found.

 
+

NM_DEVICE_ERROR

@@ -447,398 +669,358 @@ returned from D-Bus operations (where they correspond to errors in the

-

nm_device_error_quark ()

-
GQuark              nm_device_error_quark               (void);
-

-

-
-
-
-

enum NMManagerError

-
typedef enum {
-	NM_MANAGER_ERROR_FAILED = 0,                  /*< nick=Failed >*/
-	NM_MANAGER_ERROR_PERMISSION_DENIED,           /*< nick=PermissionDenied >*/
-	NM_MANAGER_ERROR_UNKNOWN_CONNECTION,          /*< nick=UnknownConnection >*/
-	NM_MANAGER_ERROR_UNKNOWN_DEVICE,              /*< nick=UnknownDevice >*/
-	NM_MANAGER_ERROR_CONNECTION_NOT_AVAILABLE,    /*< nick=ConnectionNotAvailable >*/
-	NM_MANAGER_ERROR_CONNECTION_NOT_ACTIVE,       /*< nick=ConnectionNotActive >*/
-	NM_MANAGER_ERROR_CONNECTION_ALREADY_ACTIVE,   /*< nick=ConnectionAlreadyActive >*/
-	NM_MANAGER_ERROR_DEPENDENCY_FAILED,           /*< nick=DependencyFailed >*/
-	NM_MANAGER_ERROR_ALREADY_ASLEEP_OR_AWAKE,     /*< nick=AlreadyAsleepOrAwake >*/
-	NM_MANAGER_ERROR_ALREADY_ENABLED_OR_DISABLED, /*< nick=AlreadyEnabledOrDisabled >*/
-	NM_MANAGER_ERROR_UNKNOWN_LOG_LEVEL,           /*< nick=UnknownLogLevel >*/
-	NM_MANAGER_ERROR_UNKNOWN_LOG_DOMAIN,          /*< nick=UnknownLogDomain >*/
-} NMManagerError;
-
-

-Errors related to the main "network management" interface of NetworkManager. +

enum NMManagerError

+

Errors related to the main "network management" interface of NetworkManager. These may be returned from NMClient methods that invoke D-Bus operations on the "org.freedesktop.NetworkManager" interface, and correspond to D-Bus -errors in that namespace. -

-
+errors in that namespace.

+
+

Members

+
--+++ - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + +

NM_MANAGER_ERROR_FAILED

unknown or unclassified error +

NM_MANAGER_ERROR_FAILED

+

unknown or unclassified error

 

NM_MANAGER_ERROR_PERMISSION_DENIED

Permission denied. +

NM_MANAGER_ERROR_PERMISSION_DENIED

+

Permission denied.

 

NM_MANAGER_ERROR_UNKNOWN_CONNECTION

The requested connection is not known. +

NM_MANAGER_ERROR_UNKNOWN_CONNECTION

+

The requested connection is not known.

 

NM_MANAGER_ERROR_UNKNOWN_DEVICE

The requested device is not known. +

NM_MANAGER_ERROR_UNKNOWN_DEVICE

+

The requested device is not known.

 

NM_MANAGER_ERROR_CONNECTION_NOT_AVAILABLE

The requested connection cannot be - activated at this time. +

NM_MANAGER_ERROR_CONNECTION_NOT_AVAILABLE

+

The requested connection cannot be + activated at this time.

 

NM_MANAGER_ERROR_CONNECTION_NOT_ACTIVE

The request could not be completed - because a required connection is not active. +

NM_MANAGER_ERROR_CONNECTION_NOT_ACTIVE

+

The request could not be completed + because a required connection is not active.

 

NM_MANAGER_ERROR_CONNECTION_ALREADY_ACTIVE

The connection to be activated was - already active on another device. +

NM_MANAGER_ERROR_CONNECTION_ALREADY_ACTIVE

+

The connection to be activated was + already active on another device.

 

NM_MANAGER_ERROR_DEPENDENCY_FAILED

An activation request failed due to a - dependency being unavailable. +

NM_MANAGER_ERROR_DEPENDENCY_FAILED

+

An activation request failed due to a + dependency being unavailable.

 

NM_MANAGER_ERROR_ALREADY_ASLEEP_OR_AWAKE

The manager is already in the requested - sleep/wake state. +

NM_MANAGER_ERROR_ALREADY_ASLEEP_OR_AWAKE

+

The manager is already in the requested + sleep/wake state.

 

NM_MANAGER_ERROR_ALREADY_ENABLED_OR_DISABLED

The network is already - enabled/disabled. +

NM_MANAGER_ERROR_ALREADY_ENABLED_OR_DISABLED

+

The network is already + enabled/disabled.

 

NM_MANAGER_ERROR_UNKNOWN_LOG_LEVEL

Unknown log level in SetLogging +

NM_MANAGER_ERROR_UNKNOWN_LOG_LEVEL

+

Unknown log level in SetLogging

 

NM_MANAGER_ERROR_UNKNOWN_LOG_DOMAIN

Unknown log domain in SetLogging +

NM_MANAGER_ERROR_UNKNOWN_LOG_DOMAIN

+

Unknown log domain in SetLogging

 
-
-
-

nm_manager_error_quark ()

-
GQuark              nm_manager_error_quark              (void);
-

-


-

NM_MANAGER_ERROR

-
#define NM_MANAGER_ERROR (nm_manager_error_quark ())
-
-

-

-
-
-
-

enum NMSecretAgentError

-
typedef enum {
-	NM_SECRET_AGENT_ERROR_FAILED = 0,         /*< nick=Failed >*/
-	NM_SECRET_AGENT_ERROR_PERMISSION_DENIED,  /*< nick=PermissionDenied >*/
-	NM_SECRET_AGENT_ERROR_INVALID_CONNECTION, /*< nick=InvalidConnection >*/
-	NM_SECRET_AGENT_ERROR_USER_CANCELED,      /*< nick=UserCanceled >*/
-	NM_SECRET_AGENT_ERROR_AGENT_CANCELED,     /*< nick=AgentCanceled >*/
-	NM_SECRET_AGENT_ERROR_NO_SECRETS,         /*< nick=NoSecrets >*/
-} NMSecretAgentError;
-
-

-NMSecretAgentError values are passed by secret agents back to NetworkManager +

enum NMSecretAgentError

+

NMSecretAgentError values are passed by secret agents back to NetworkManager when they encounter problems retrieving secrets on behalf of NM. They correspond to errors in the "org.freedesktop.NetworkManager.SecretManager" -namespace. -

-

-Client APIs such as nm_client_activate_connection() will not see these error +namespace.

+

Client APIs such as nm_client_activate_connection() will not see these error codes; instead, the secret agent manager will translate them to the -corresponding NMAgentManagerError codes. -

-
+corresponding NMAgentManagerError codes.

+
+

Members

+
--+++ - - + + - - + + - - + + - - + + - - + + - - + +

NM_SECRET_AGENT_ERROR_FAILED

unknown or unclassified error +

NM_SECRET_AGENT_ERROR_FAILED

+

unknown or unclassified error

 

NM_SECRET_AGENT_ERROR_PERMISSION_DENIED

the caller (ie, NetworkManager) is - not authorized to make this request +

NM_SECRET_AGENT_ERROR_PERMISSION_DENIED

+

the caller (ie, NetworkManager) is + not authorized to make this request

 

NM_SECRET_AGENT_ERROR_INVALID_CONNECTION

the connection for which secrets - were requested is invalid +

NM_SECRET_AGENT_ERROR_INVALID_CONNECTION

+

the connection for which secrets + were requested is invalid

 

NM_SECRET_AGENT_ERROR_USER_CANCELED

the request was canceled by the user +

NM_SECRET_AGENT_ERROR_USER_CANCELED

+

the request was canceled by the user

 

NM_SECRET_AGENT_ERROR_AGENT_CANCELED

the agent canceled the request - because it was requested to do so by NetworkManager +

NM_SECRET_AGENT_ERROR_AGENT_CANCELED

+

the agent canceled the request + because it was requested to do so by NetworkManager

 

NM_SECRET_AGENT_ERROR_NO_SECRETS

the agent cannot find any secrets for this - connection +

NM_SECRET_AGENT_ERROR_NO_SECRETS

+

the agent cannot find any secrets for this + connection

 
-
-
-

nm_secret_agent_error_quark ()

-
GQuark              nm_secret_agent_error_quark         (void);
-

-


-

NM_SECRET_AGENT_ERROR

-
#define NM_SECRET_AGENT_ERROR         (nm_secret_agent_error_quark ())
-
-

-

-
-
-
-

enum NMSettingsError

-
typedef enum {
-	NM_SETTINGS_ERROR_FAILED = 0,           /*< nick=Failed >*/
-	NM_SETTINGS_ERROR_PERMISSION_DENIED,    /*< nick=PermissionDenied >*/
-	NM_SETTINGS_ERROR_NOT_SUPPORTED,        /*< nick=NotSupported >*/
-	NM_SETTINGS_ERROR_INVALID_CONNECTION,   /*< nick=InvalidConnection >*/
-	NM_SETTINGS_ERROR_READ_ONLY_CONNECTION, /*< nick=ReadOnlyConnection >*/
-	NM_SETTINGS_ERROR_UUID_EXISTS,          /*< nick=UuidExists >*/
-	NM_SETTINGS_ERROR_INVALID_HOSTNAME,     /*< nick=InvalidHostname >*/
-} NMSettingsError;
-
-

-Errors related to the settings/persistent configuration interface of -NetworkManager. -

-

-These may be returned from NMClient methods that invoke D-Bus operations on +

enum NMSettingsError

+

Errors related to the settings/persistent configuration interface of +NetworkManager.

+

These may be returned from NMClient methods that invoke D-Bus operations on the "org.freedesktop.NetworkManager.Settings" interface, and correspond to -D-Bus errors in that namespace. -

-
+D-Bus errors in that namespace.

+
+

Members

+
--+++ - - + + - - + + - - + + - - + + - - + + - - + + - - + +

NM_SETTINGS_ERROR_FAILED

unknown or unclassified error +

NM_SETTINGS_ERROR_FAILED

+

unknown or unclassified error

 

NM_SETTINGS_ERROR_PERMISSION_DENIED

permission denied +

NM_SETTINGS_ERROR_PERMISSION_DENIED

+

permission denied

 

NM_SETTINGS_ERROR_NOT_SUPPORTED

the requested operation is not supported by any - active settings backend +

NM_SETTINGS_ERROR_NOT_SUPPORTED

+

the requested operation is not supported by any + active settings backend

 

NM_SETTINGS_ERROR_INVALID_CONNECTION

the connection was invalid +

NM_SETTINGS_ERROR_INVALID_CONNECTION

+

the connection was invalid

 

NM_SETTINGS_ERROR_READ_ONLY_CONNECTION

attempted to modify a read-only connection +

NM_SETTINGS_ERROR_READ_ONLY_CONNECTION

+

attempted to modify a read-only connection

 

NM_SETTINGS_ERROR_UUID_EXISTS

a connection with that UUID already exists +

NM_SETTINGS_ERROR_UUID_EXISTS

+

a connection with that UUID already exists

 

NM_SETTINGS_ERROR_INVALID_HOSTNAME

attempted to set an invalid hostname +

NM_SETTINGS_ERROR_INVALID_HOSTNAME

+

attempted to set an invalid hostname

 
-
-
-

nm_settings_error_quark ()

-
GQuark              nm_settings_error_quark             (void);
-

-

-
-
-
-

NM_SETTINGS_ERROR

-
#define NM_SETTINGS_ERROR (nm_settings_error_quark ())
-
-

-


-

enum NMVpnPluginError

-
typedef enum {
-	NM_VPN_PLUGIN_ERROR_FAILED,                    /*< nick=Failed >*/
-	NM_VPN_PLUGIN_ERROR_STARTING_IN_PROGRESS,      /*< nick=StartingInProgress >*/
-	NM_VPN_PLUGIN_ERROR_ALREADY_STARTED,           /*< nick=AlreadyStarted >*/
-	NM_VPN_PLUGIN_ERROR_STOPPING_IN_PROGRESS,      /*< nick=StoppingInProgress >*/
-	NM_VPN_PLUGIN_ERROR_ALREADY_STOPPED,           /*< nick=AlreadyStopped >*/
-	NM_VPN_PLUGIN_ERROR_WRONG_STATE,               /*< nick=WrongState >*/
-	NM_VPN_PLUGIN_ERROR_BAD_ARGUMENTS,             /*< nick=BadArguments >*/
-	NM_VPN_PLUGIN_ERROR_LAUNCH_FAILED,             /*< nick=LaunchFailed >*/
-	NM_VPN_PLUGIN_ERROR_INVALID_CONNECTION,        /*< nick=InvalidConnection >*/
-	NM_VPN_PLUGIN_ERROR_INTERACTIVE_NOT_SUPPORTED, /*< nick=InteractiveNotSupported >*/
-} NMVpnPluginError;
-
-

-Returned by the VPN service plugin to indicate errors. These codes correspond -to errors in the "org.freedesktop.NetworkManager.VPN.Error" namespace. -

-
+

enum NMVpnPluginError

+

Returned by the VPN service plugin to indicate errors. These codes correspond +to errors in the "org.freedesktop.NetworkManager.VPN.Error" namespace.

+
+

Members

+
--+++ - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + +

NM_VPN_PLUGIN_ERROR_FAILED

unknown or unclassified error +

NM_VPN_PLUGIN_ERROR_FAILED

+

unknown or unclassified error

 

NM_VPN_PLUGIN_ERROR_STARTING_IN_PROGRESS

the plugin is already starting, - and another connect request was received +

NM_VPN_PLUGIN_ERROR_STARTING_IN_PROGRESS

+

the plugin is already starting, + and another connect request was received

 

NM_VPN_PLUGIN_ERROR_ALREADY_STARTED

the plugin is already connected, and - another connect request was received +

NM_VPN_PLUGIN_ERROR_ALREADY_STARTED

+

the plugin is already connected, and + another connect request was received

 

NM_VPN_PLUGIN_ERROR_STOPPING_IN_PROGRESS

the plugin is already stopping, - and another stop request was received +

NM_VPN_PLUGIN_ERROR_STOPPING_IN_PROGRESS

+

the plugin is already stopping, + and another stop request was received

 

NM_VPN_PLUGIN_ERROR_ALREADY_STOPPED

the plugin is already stopped, and - another disconnect request was received +

NM_VPN_PLUGIN_ERROR_ALREADY_STOPPED

+

the plugin is already stopped, and + another disconnect request was received

 

NM_VPN_PLUGIN_ERROR_WRONG_STATE

the operation could not be performed in - this state +

NM_VPN_PLUGIN_ERROR_WRONG_STATE

+

the operation could not be performed in + this state

 

NM_VPN_PLUGIN_ERROR_BAD_ARGUMENTS

the operation could not be performed as +

NM_VPN_PLUGIN_ERROR_BAD_ARGUMENTS

+

the operation could not be performed as the request contained malformed arguments, or arguments of unexpected type. Usually means that one of the VPN setting data items or secrets was not of - the expected type (ie int, string, bool, etc). + the expected type (ie int, string, bool, etc).

 

NM_VPN_PLUGIN_ERROR_LAUNCH_FAILED

a child process failed to launch +

NM_VPN_PLUGIN_ERROR_LAUNCH_FAILED

+

a child process failed to launch

 

NM_VPN_PLUGIN_ERROR_INVALID_CONNECTION

the operation could not be performed +

NM_VPN_PLUGIN_ERROR_INVALID_CONNECTION

+

the operation could not be performed because the connection was invalid. Usually means that the connection's - VPN setting was missing some required data item or secret. + VPN setting was missing some required data item or secret.

 

NM_VPN_PLUGIN_ERROR_INTERACTIVE_NOT_SUPPORTED

the operation could not be +

NM_VPN_PLUGIN_ERROR_INTERACTIVE_NOT_SUPPORTED

+

the operation could not be performed as the plugin does not support interactive operations, such as - ConnectInteractive() or NewSecrets() + ConnectInteractive() or NewSecrets()

 
-
-
-

NM_VPN_PLUGIN_ERROR

-
#define NM_VPN_PLUGIN_ERROR      (nm_vpn_plugin_error_quark ())
-
-

-

-
-
-
-

nm_vpn_plugin_error_quark ()

-
GQuark              nm_vpn_plugin_error_quark           (void);
-

-

+ Generated by GTK-Doc V1.21 \ No newline at end of file diff --git a/docs/libnm/html/libnm-nm-utils.html b/docs/libnm/html/libnm-nm-utils.html index 4985188b..60eb603e 100644 --- a/docs/libnm/html/libnm-nm-utils.html +++ b/docs/libnm/html/libnm-nm-utils.html @@ -2,32 +2,27 @@ -nm-utils +libnm Reference Manual: nm-utils - + - - - - - - - - - - + + + + + + +
@@ -35,2008 +30,2605 @@

nm-utils

nm-utils — Utility functions

- +
-
-

Synopsis

-
gboolean            nm_utils_is_empty_ssid              (const guint8 *ssid,
-                                                         gsize len);
-const char *        nm_utils_escape_ssid                (const guint8 *ssid,
-                                                         gsize len);
-gboolean            nm_utils_same_ssid                  (const guint8 *ssid1,
-                                                         gsize len1,
-                                                         const guint8 *ssid2,
-                                                         gsize len2,
-                                                         gboolean ignore_trailing_null);
-char *              nm_utils_ssid_to_utf8               (const guint8 *ssid,
-                                                         gsize len);
-enum                NMUtilsSecurityType;
-gboolean            nm_utils_security_valid             (NMUtilsSecurityType type,
-                                                         NMDeviceWifiCapabilities wifi_caps,
-                                                         gboolean have_ap,
-                                                         gboolean adhoc,
-                                                         NM80211ApFlags ap_flags,
-                                                         NM80211ApSecurityFlags ap_wpa,
-                                                         NM80211ApSecurityFlags ap_rsn);
-gboolean            nm_utils_ap_mode_security_valid     (NMUtilsSecurityType type,
-                                                         NMDeviceWifiCapabilities wifi_caps);
-gboolean            nm_utils_wep_key_valid              (const char *key,
-                                                         NMWepKeyType wep_type);
-gboolean            nm_utils_wpa_psk_valid              (const char *psk);
-GVariant *          nm_utils_ip4_dns_to_variant         (char **dns);
-char **             nm_utils_ip4_dns_from_variant       (GVariant *value);
-GVariant *          nm_utils_ip4_addresses_to_variant   (GPtrArray *addresses,
-                                                         const char *gateway);
-GPtrArray *         nm_utils_ip4_addresses_from_variant (GVariant *value,
-                                                         char **out_gateway);
-GVariant *          nm_utils_ip4_routes_to_variant      (GPtrArray *routes);
-GPtrArray *         nm_utils_ip4_routes_from_variant    (GVariant *value);
-guint32             nm_utils_ip4_netmask_to_prefix      (guint32 netmask);
-guint32             nm_utils_ip4_prefix_to_netmask      (guint32 prefix);
-guint32             nm_utils_ip4_get_default_prefix     (guint32 ip);
-GVariant *          nm_utils_ip6_dns_to_variant         (char **dns);
-char **             nm_utils_ip6_dns_from_variant       (GVariant *value);
-GVariant *          nm_utils_ip6_addresses_to_variant   (GPtrArray *addresses,
-                                                         const char *gateway);
-GPtrArray *         nm_utils_ip6_addresses_from_variant (GVariant *value,
-                                                         char **out_gateway);
-GVariant *          nm_utils_ip6_routes_to_variant      (GPtrArray *routes);
-GPtrArray *         nm_utils_ip6_routes_from_variant    (GVariant *value);
-GVariant *          nm_utils_ip_addresses_to_variant    (GPtrArray *addresses);
-GPtrArray *         nm_utils_ip_addresses_from_variant  (GVariant *value,
-                                                         int family);
-GVariant *          nm_utils_ip_routes_to_variant       (GPtrArray *routes);
-GPtrArray *         nm_utils_ip_routes_from_variant     (GVariant *value,
-                                                         int family);
-char *              nm_utils_uuid_generate              (void);
-gboolean            nm_utils_file_is_certificate        (const char *filename);
-gboolean            nm_utils_file_is_private_key        (const char *filename,
-                                                         gboolean *out_encrypted);
-gboolean            nm_utils_file_is_pkcs12             (const char *filename);
-gboolean            (*NMUtilsFileSearchInPathsPredicate)
-                                                        (const char *filename,
-                                                         gpointer user_data);
-const char *        nm_utils_file_search_in_paths       (const char *progname,
-                                                         const char *try_first,
-                                                         const char *const *paths,
-                                                         GFileTest file_test_flags,
-                                                         NMUtilsFileSearchInPathsPredicate predicate,
-                                                         gpointer user_data,
-                                                         GError **error);
-guint32             nm_utils_wifi_freq_to_channel       (guint32 freq);
-guint32             nm_utils_wifi_channel_to_freq       (guint32 channel,
-                                                         const char *band);
-guint32             nm_utils_wifi_find_next_channel     (guint32 channel,
-                                                         int direction,
-                                                         char *band);
-gboolean            nm_utils_wifi_is_channel_valid      (guint32 channel,
-                                                         const char *band);
-const char *        nm_utils_wifi_strength_bars         (guint8 strength);
-#define             NM_UTILS_HWADDR_LEN_MAX
-gsize               nm_utils_hwaddr_len                 (int type);
-char *              nm_utils_hwaddr_ntoa                (gconstpointer addr,
-                                                         gsize length);
-GByteArray *        nm_utils_hwaddr_atoba               (const char *asc,
-                                                         gsize length);
-guint8 *            nm_utils_hwaddr_aton                (const char *asc,
-                                                         gpointer buffer,
-                                                         gsize length);
-gboolean            nm_utils_hwaddr_valid               (const char *asc,
-                                                         gssize length);
-char *              nm_utils_hwaddr_canonical           (const char *asc,
-                                                         gssize length);
-gboolean            nm_utils_hwaddr_matches             (gconstpointer hwaddr1,
-                                                         gssize hwaddr1_len,
-                                                         gconstpointer hwaddr2,
-                                                         gssize hwaddr2_len);
-char *              nm_utils_bin2hexstr                 (gconstpointer src,
-                                                         gsize len,
-                                                         int final_len);
-GBytes *            nm_utils_hexstr2bin                 (const char *hex);
-gboolean            nm_utils_iface_valid_name           (const char *name);
-gboolean            nm_utils_is_uuid                    (const char *str);
-#define             NM_UTILS_INET_ADDRSTRLEN
-const char *        nm_utils_inet4_ntop                 (in_addr_t inaddr,
-                                                         char *dst);
-const char *        nm_utils_inet6_ntop                 (const struct in6_addr *in6addr,
-                                                         char *dst);
-gboolean            nm_utils_ipaddr_valid               (int family,
-                                                         const char *ip);
-gboolean            nm_utils_check_virtual_device_compatibility
-                                                        (GType virtual_type,
-                                                         GType other_type);
-
-
-
-

Object Hierarchy

-
-  GEnum
-   +----NMUtilsSecurityType
-
-
-
-

Description

-

-A collection of utility functions for working with SSIDs, IP addresses, Wi-Fi -access points and devices, among other things. -

-
-

Details

-
-

nm_utils_is_empty_ssid ()

-
gboolean            nm_utils_is_empty_ssid              (const guint8 *ssid,
-                                                         gsize len);
-

-Different manufacturers use different mechanisms for not broadcasting the -AP's SSID. This function attempts to detect blank/empty SSIDs using a -number of known SSID-cloaking methods. -

-
+

Functions

+
--++ - - + - - + - - + + - -

ssid :

pointer to a buffer containing the SSID data. [array length=len] + +gboolean + +nm_utils_is_empty_ssid ()

len :

length of the SSID data in ssid +const char * + +nm_utils_escape_ssid ()

Returns :

-TRUE if the SSID is "empty", FALSE if it is not +gboolean + +nm_utils_same_ssid () +
-
-
-
-

nm_utils_escape_ssid ()

-
const char *        nm_utils_escape_ssid                (const guint8 *ssid,
-                                                         gsize len);
-

-This function does a quick printable character conversion of the SSID, simply -replacing embedded NULLs and non-printable characters with the hexadecimal -representation of that character. Intended for debugging only, should not -be used for display of SSIDs. -

-
---- - - - + - - + - - + + - -

ssid :

pointer to a buffer containing the SSID data. [array length=len] + +char * + +nm_utils_ssid_to_utf8 ()

len :

length of the SSID data in ssid + +gboolean + +nm_utils_security_valid ()

Returns :

pointer to the escaped SSID, which uses an internal static buffer -and will be overwritten by subsequent calls to this function +gboolean + +nm_utils_ap_mode_security_valid () +
-
-
-
-

nm_utils_same_ssid ()

-
gboolean            nm_utils_same_ssid                  (const guint8 *ssid1,
-                                                         gsize len1,
-                                                         const guint8 *ssid2,
-                                                         gsize len2,
-                                                         gboolean ignore_trailing_null);
-

-Earlier versions of the Linux kernel added a NULL byte to the end of the -SSID to enable easy printing of the SSID on the console or in a terminal, -but this behavior was problematic (SSIDs are simply byte arrays, not strings) -and thus was changed. This function compensates for that behavior at the -cost of some compatibility with odd SSIDs that may legitimately have trailing -NULLs, even though that is functionally pointless. -

-
---- - - - + - - + - - + - - + - - + + - - + + - -

ssid1 :

the first SSID to compare. [array length=len1] + +gboolean + +nm_utils_wep_key_valid ()

len1 :

length of the SSID data in ssid1 + +gboolean + +nm_utils_wpa_psk_valid ()

ssid2 :

the second SSID to compare. [array length=len2] + +GVariant * + +nm_utils_ip4_dns_to_variant ()

len2 :

length of the SSID data in ssid2 + +char ** + +nm_utils_ip4_dns_from_variant ()

ignore_trailing_null :

-TRUE to ignore one trailing NULL byte +GVariant * + +nm_utils_ip4_addresses_to_variant () +

Returns :

-TRUE if the SSIDs are the same, FALSE if they are not +GPtrArray * + +nm_utils_ip4_addresses_from_variant () +
-
-
-
-

nm_utils_ssid_to_utf8 ()

-
char *              nm_utils_ssid_to_utf8               (const guint8 *ssid,
-                                                         gsize len);
-

-Wi-Fi SSIDs are byte arrays, they are _not_ strings. Thus, an SSID may -contain embedded NULLs and other unprintable characters. Often it is -useful to print the SSID out for debugging purposes, but that should be the -_only_ use of this function. Do not use this function for any persistent -storage of the SSID, since the printable SSID returned from this function -cannot be converted back into the real SSID of the access point. -

-

-This function does almost everything humanly possible to convert the input -into a printable UTF-8 string, using roughly the following procedure: -

-

-1) if the input data is already UTF-8 safe, no conversion is performed -2) attempts to get the current system language from the LANG environment - variable, and depending on the language, uses a table of alternative - encodings to try. For example, if LANG=hu_HU, the table may first try - the ISO-8859-2 encoding, and if that fails, try the Windows-1250 encoding. - If all fallback encodings fail, replaces non-UTF-8 characters with '?'. -3) If the system language was unable to be determined, falls back to the - ISO-8859-1 encoding, then to the Windows-1251 encoding. -4) If step 3 fails, replaces non-UTF-8 characters with '?'. -

-

-Again, this function should be used for debugging and display purposes -_only_. -

-
---- - - - + - - + - - + - -

ssid :

pointer to a buffer containing the SSID data. [array length=len] + +GVariant * + +nm_utils_ip4_routes_to_variant ()

len :

length of the SSID data in ssid + +GPtrArray * + +nm_utils_ip4_routes_from_variant ()

Returns :

an allocated string containing a UTF-8 -representation of the SSID, which must be freed by the caller using g_free(). -Returns NULL on errors. [transfer full] + +guint32 + +nm_utils_ip4_netmask_to_prefix ()
-
-
-
-

enum NMUtilsSecurityType

-
typedef enum {
-	NMU_SEC_INVALID = 0,
-	NMU_SEC_NONE,
-	NMU_SEC_STATIC_WEP,
-	NMU_SEC_LEAP,
-	NMU_SEC_DYNAMIC_WEP,
-	NMU_SEC_WPA_PSK,
-	NMU_SEC_WPA_ENTERPRISE,
-	NMU_SEC_WPA2_PSK,
-	NMU_SEC_WPA2_ENTERPRISE
-} NMUtilsSecurityType;
-
-

-Describes generic security mechanisms that 802.11 access points may offer. -Used with nm_utils_security_valid() for checking whether a given access -point is compatible with a network device. -

-
---- - - - + - - + - - + - - + - - + - - + - - + - - + - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

NMU_SEC_INVALID

unknown or invalid security, placeholder and not used + +guint32 + +nm_utils_ip4_prefix_to_netmask ()

NMU_SEC_NONE

unencrypted and open + +guint32 + +nm_utils_ip4_get_default_prefix ()

NMU_SEC_STATIC_WEP

static WEP keys are used for encryption + +GVariant * + +nm_utils_ip6_dns_to_variant ()

NMU_SEC_LEAP

Cisco LEAP is used for authentication and for generating the -dynamic WEP keys automatically + +char ** + +nm_utils_ip6_dns_from_variant ()

NMU_SEC_DYNAMIC_WEP

standard 802.1x is used for authentication and -generating the dynamic WEP keys automatically + +GVariant * + +nm_utils_ip6_addresses_to_variant ()

NMU_SEC_WPA_PSK

WPA1 is used with Pre-Shared Keys (PSK) + +GPtrArray * + +nm_utils_ip6_addresses_from_variant ()

NMU_SEC_WPA_ENTERPRISE

WPA1 is used with 802.1x authentication + +GVariant * + +nm_utils_ip6_routes_to_variant ()

NMU_SEC_WPA2_PSK

WPA2/RSN is used with Pre-Shared Keys (PSK) + +GPtrArray * + +nm_utils_ip6_routes_from_variant ()

NMU_SEC_WPA2_ENTERPRISE

WPA2 is used with 802.1x authentication + +GVariant * + +nm_utils_ip_addresses_to_variant () +
+GPtrArray * + +nm_utils_ip_addresses_from_variant () +
+GVariant * + +nm_utils_ip_routes_to_variant () +
+GPtrArray * + +nm_utils_ip_routes_from_variant () +
+char * + +nm_utils_uuid_generate () +
+gboolean + +nm_utils_file_is_certificate () +
+gboolean + +nm_utils_file_is_private_key () +
+gboolean + +nm_utils_file_is_pkcs12 () +
+gboolean + +(*NMUtilsFileSearchInPathsPredicate) () +
const char * + +nm_utils_file_search_in_paths () +
+guint32 + +nm_utils_wifi_freq_to_channel () +
+guint32 + +nm_utils_wifi_channel_to_freq () +
+guint32 + +nm_utils_wifi_find_next_channel () +
+gboolean + +nm_utils_wifi_is_channel_valid () +
const char * + +nm_utils_wifi_strength_bars () +
+gsize + +nm_utils_hwaddr_len () +
+char * + +nm_utils_hwaddr_ntoa ()
+GByteArray * + +nm_utils_hwaddr_atoba () +
+guint8 * + +nm_utils_hwaddr_aton () +
+gboolean + +nm_utils_hwaddr_valid () +
+char * + +nm_utils_hwaddr_canonical () +
+gboolean + +nm_utils_hwaddr_matches () +
+char * + +nm_utils_bin2hexstr () +
+GBytes * + +nm_utils_hexstr2bin () +
+gboolean + +nm_utils_iface_valid_name () +
+gboolean + +nm_utils_is_uuid () +
const char * + +nm_utils_inet4_ntop () +
const char * + +nm_utils_inet6_ntop () +
+gboolean + +nm_utils_ipaddr_valid () +
+gboolean + +nm_utils_check_virtual_device_compatibility () +
+
+
+

Types and Values

+
++++ + + + + + + + + + + + + + + +
enumNMUtilsSecurityType
#defineNM_UTILS_HWADDR_LEN_MAX
#defineNM_UTILS_INET_ADDRSTRLEN
+
+
+

Object Hierarchy

+
    GEnum
+    ╰── NMUtilsSecurityType
+
+
+
+

Description

+

A collection of utility functions for working with SSIDs, IP addresses, Wi-Fi +access points and devices, among other things.

+
+
+

Functions

+
+

nm_utils_is_empty_ssid ()

+
gboolean
+nm_utils_is_empty_ssid (const guint8 *ssid,
+                        gsize len);
+

Different manufacturers use different mechanisms for not broadcasting the +AP's SSID. This function attempts to detect blank/empty SSIDs using a +number of known SSID-cloaking methods.

+
+

Parameters

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

ssid

pointer to a buffer containing the SSID data.

[array length=len]

len

length of the SSID data in ssid +

 
+
+

Returns

+

TRUE if the SSID is "empty", FALSE if it is not

+

+
+

-

nm_utils_security_valid ()

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

-Given a set of device capabilities, and a desired security type to check -against, determines whether the combination of device, desired security -type, and AP capabilities intersect. -

-

-NOTE: this function cannot handle checking security for AP/Hotspot mode; -use nm_utils_ap_mode_security_valid() instead. -

-
+

nm_utils_escape_ssid ()

+
const char *
+nm_utils_escape_ssid (const guint8 *ssid,
+                      gsize len);
+

This function does a quick printable character conversion of the SSID, simply +replacing embedded NULLs and non-printable characters with the hexadecimal +representation of that character. Intended for debugging only, should not +be used for display of SSIDs.

+
+

Parameters

+
--+++ - - + + + - - + + + + +

type :

the security type to check AP flags and device capabilties against, -e.g. NMU_SEC_STATIC_WEP -

ssid

pointer to a buffer containing the SSID data.

[array length=len]

wifi_caps :

bitfield of the capabilities of the specific Wi-Fi device, e.g. -NM_WIFI_DEVICE_CAP_CIPHER_WEP40 -

len

length of the SSID data in ssid +

 
+
+
+

Returns

+

pointer to the escaped SSID, which uses an internal static buffer +and will be overwritten by subsequent calls to this function

+

+
+
+
+
+

nm_utils_same_ssid ()

+
gboolean
+nm_utils_same_ssid (const guint8 *ssid1,
+                    gsize len1,
+                    const guint8 *ssid2,
+                    gsize len2,
+                    gboolean ignore_trailing_null);
+

Earlier versions of the Linux kernel added a NULL byte to the end of the +SSID to enable easy printing of the SSID on the console or in a terminal, +but this behavior was problematic (SSIDs are simply byte arrays, not strings) +and thus was changed. This function compensates for that behavior at the +cost of some compatibility with odd SSIDs that may legitimately have trailing +NULLs, even though that is functionally pointless.

+
+

Parameters

+
+++++ + - - + + + - - + + + - - + + + - - + + + - - + + + + + +

have_ap :

whether the ap_flags, ap_wpa, and ap_rsn arguments are valid

ssid1

the first SSID to compare.

[array length=len1]

adhoc :

whether the capabilities being tested are from an Ad-Hoc AP (IBSS)

len1

length of the SSID data in ssid1 +

 

ap_flags :

bitfield of AP capabilities, e.g. NM_802_11_AP_FLAGS_PRIVACY -

ssid2

the second SSID to compare.

[array length=len2]

ap_wpa :

bitfield of AP capabilties derived from the AP's WPA beacon, -e.g. (NM_802_11_AP_SEC_PAIR_TKIP | NM_802_11_AP_SEC_KEY_MGMT_PSK)

len2

length of the SSID data in ssid2 +

 

ap_rsn :

bitfield of AP capabilties derived from the AP's RSN/WPA2 beacon, -e.g. (NM_802_11_AP_SEC_PAIR_CCMP | NM_802_11_AP_SEC_PAIR_TKIP)

ignore_trailing_null

TRUE to ignore one trailing NULL byte

 
+
+
+

Returns

+

TRUE if the SSIDs are the same, FALSE if they are not

+

+
+
+
+
+

nm_utils_ssid_to_utf8 ()

+
char *
+nm_utils_ssid_to_utf8 (const guint8 *ssid,
+                       gsize len);
+

Wi-Fi SSIDs are byte arrays, they are _not_ strings. Thus, an SSID may +contain embedded NULLs and other unprintable characters. Often it is +useful to print the SSID out for debugging purposes, but that should be the +_only_ use of this function. Do not use this function for any persistent +storage of the SSID, since the printable SSID returned from this function +cannot be converted back into the real SSID of the access point.

+

This function does almost everything humanly possible to convert the input +into a printable UTF-8 string, using roughly the following procedure:

+

1) if the input data is already UTF-8 safe, no conversion is performed +2) attempts to get the current system language from the LANG environment + variable, and depending on the language, uses a table of alternative + encodings to try. For example, if LANG=hu_HU, the table may first try + the ISO-8859-2 encoding, and if that fails, try the Windows-1250 encoding. + If all fallback encodings fail, replaces non-UTF-8 characters with '?'. +3) If the system language was unable to be determined, falls back to the + ISO-8859-1 encoding, then to the Windows-1251 encoding. +4) If step 3 fails, replaces non-UTF-8 characters with '?'.

+

Again, this function should be used for debugging and display purposes +_only_.

+
+

Parameters

+
+++++ + + + + + - - + + +

ssid

pointer to a buffer containing the SSID data.

[array length=len]

Returns :

-TRUE if the device capabilities and AP capabilties intersect and are -compatible with the desired type, FALSE if they are not

len

length of the SSID data in ssid +

 
+
+

Returns

+

an allocated string containing a UTF-8 +representation of the SSID, which must be freed by the caller using g_free(). +Returns NULL on errors.

+

[transfer full]

+
+

-

nm_utils_ap_mode_security_valid ()

-
gboolean            nm_utils_ap_mode_security_valid     (NMUtilsSecurityType type,
-                                                         NMDeviceWifiCapabilities wifi_caps);
-

-Given a set of device capabilities, and a desired security type to check -against, determines whether the combination of device capabilities and -desired security type are valid for AP/Hotspot connections. -

-
+

nm_utils_security_valid ()

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

Given a set of device capabilities, and a desired security type to check +against, determines whether the combination of device, desired security +type, and AP capabilities intersect.

+

NOTE: this function cannot handle checking security for AP/Hotspot mode; +use nm_utils_ap_mode_security_valid() instead.

+
+

Parameters

+
--+++ - - + + + - - + + + + + + + + + + + + + + + + + + + + + + + - - + + +

type :

the security type to check device capabilties against, -e.g. NMU_SEC_STATIC_WEP -

type

the security type to check AP flags and device capabilties against, +e.g. NMU_SEC_STATIC_WEP

 

wifi_caps :

bitfield of the capabilities of the specific Wi-Fi device, e.g. -NM_WIFI_DEVICE_CAP_CIPHER_WEP40 -

wifi_caps

bitfield of the capabilities of the specific Wi-Fi device, e.g. +NM_WIFI_DEVICE_CAP_CIPHER_WEP40

 

have_ap

whether the ap_flags +, ap_wpa +, and ap_rsn +arguments are valid

 

adhoc

whether the capabilities being tested are from an Ad-Hoc AP (IBSS)

 

ap_flags

bitfield of AP capabilities, e.g. NM_802_11_AP_FLAGS_PRIVACY

 

ap_wpa

bitfield of AP capabilties derived from the AP's WPA beacon, +e.g. (NM_802_11_AP_SEC_PAIR_TKIP | NM_802_11_AP_SEC_KEY_MGMT_PSK)

 

Returns :

-TRUE if the device capabilities are compatible with the desired -type, FALSE if they are not.

ap_rsn

bitfield of AP capabilties derived from the AP's RSN/WPA2 beacon, +e.g. (NM_802_11_AP_SEC_PAIR_CCMP | NM_802_11_AP_SEC_PAIR_TKIP)

 
+
+

Returns

+

TRUE if the device capabilities and AP capabilties intersect and are +compatible with the desired type +, FALSE if they are not

+

+
+

-

nm_utils_wep_key_valid ()

-
gboolean            nm_utils_wep_key_valid              (const char *key,
-                                                         NMWepKeyType wep_type);
-

-Checks if key is a valid WEP key -

-
+

nm_utils_ap_mode_security_valid ()

+
gboolean
+nm_utils_ap_mode_security_valid (NMUtilsSecurityType type,
+                                 NMDeviceWifiCapabilities wifi_caps);
+

Given a set of device capabilities, and a desired security type to check +against, determines whether the combination of device capabilities and +desired security type are valid for AP/Hotspot connections.

+
+

Parameters

+
--+++ - - + + + - - - - - - + + +

key :

a string that might be a WEP key

type

the security type to check device capabilties against, +e.g. NMU_SEC_STATIC_WEP

 

wep_type :

the NMWepKeyType type of the WEP key

Returns :

-TRUE if key is a WEP key, FALSE if not

wifi_caps

bitfield of the capabilities of the specific Wi-Fi device, e.g. +NM_WIFI_DEVICE_CAP_CIPHER_WEP40

 
+
+

Returns

+

TRUE if the device capabilities are compatible with the desired +type +, FALSE if they are not.

+

+
+

-

nm_utils_wpa_psk_valid ()

-
gboolean            nm_utils_wpa_psk_valid              (const char *psk);
-

-Checks if psk is a valid WPA PSK -

-
+

nm_utils_wep_key_valid ()

+
gboolean
+nm_utils_wep_key_valid (const char *key,
+                        NMWepKeyType wep_type);
+

Checks if key + is a valid WEP key

+
+

Parameters

+
--+++ - - + + + - - + + +

psk :

a string that might be a WPA PSK

key

a string that might be a WEP key

 

Returns :

-TRUE if psk is a WPA PSK, FALSE if not

wep_type

the NMWepKeyType type of the WEP key

 
+
+

Returns

+

TRUE if key +is a WEP key, FALSE if not

+

+
+ +
+
+

nm_utils_wpa_psk_valid ()

+
gboolean
+nm_utils_wpa_psk_valid (const char *psk);
+

Checks if psk + is a valid WPA PSK

+
+

Parameters

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

psk

a string that might be a WPA PSK

 
+
+
+

Returns

+

TRUE if psk +is a WPA PSK, FALSE if not

+

+
+

-

nm_utils_ip4_dns_to_variant ()

-
GVariant *          nm_utils_ip4_dns_to_variant         (char **dns);
-

-Utility function to convert an array of IP address strings int a GVariant of -type 'au' representing an array of IPv4 addresses. -

-
+

nm_utils_ip4_dns_to_variant ()

+
GVariant *
+nm_utils_ip4_dns_to_variant (char **dns);
+

Utility function to convert an array of IP address strings int a GVariant of +type 'au' representing an array of IPv4 addresses.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

dns :

an array of IP address strings. [type utf8] -

Returns :

a new floating GVariant representing dns. [transfer none] -

dns

an array of IP address strings.

[type utf8]
+
+

Returns

+

a new floating GVariant representing dns +.

+

[transfer none]

+
+
-

nm_utils_ip4_dns_from_variant ()

-
char **             nm_utils_ip4_dns_from_variant       (GVariant *value);
-

-Utility function to convert a GVariant of type 'au' representing a list of -IPv4 addresses into an array of IP address strings. -

-
+

nm_utils_ip4_dns_from_variant ()

+
char **
+nm_utils_ip4_dns_from_variant (GVariant *value);
+

Utility function to convert a GVariant of type 'au' representing a list of +IPv4 addresses into an array of IP address strings.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

value :

a GVariant of type 'au'

Returns :

a NULL-terminated array of IP address strings. [transfer full][type utf8] -

value

a GVariant of type 'au'

 
+
+

Returns

+

a NULL-terminated array of IP address strings.

+

[transfer full][type utf8]

+
+
-

nm_utils_ip4_addresses_to_variant ()

-
GVariant *          nm_utils_ip4_addresses_to_variant   (GPtrArray *addresses,
-                                                         const char *gateway);
-

-Utility function to convert a GPtrArray of NMIPAddress objects representing -IPv4 addresses into a GVariant of type 'aau' representing an array of +

nm_utils_ip4_addresses_to_variant ()

+
GVariant *
+nm_utils_ip4_addresses_to_variant (GPtrArray *addresses,
+                                   const char *gateway);
+

Utility function to convert a GPtrArray of NMIPAddress objects representing +IPv4 addresses into a GVariant of type 'aau' representing an array of NetworkManager IPv4 addresses (which are tuples of address, prefix, and gateway). The "gateway" field of the first address will get the value of -gateway (if non-NULL). In all of the other addresses, that field will be 0. -

-
+gateway + (if non-NULL). In all of the other addresses, that field will be 0.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + +

addresses :

an array of NMIPAddress objects. [element-type NMIPAddress] -

gateway :

the gateway IP address. [allow-none] -

addresses

an array of NMIPAddress objects.

[element-type NMIPAddress]

Returns :

a new floating GVariant representing addresses. [transfer none] -

gateway

the gateway IP address.

[allow-none]
+
+

Returns

+

a new floating GVariant representing addresses +.

+

[transfer none]

+
+
-

nm_utils_ip4_addresses_from_variant ()

-
GPtrArray *         nm_utils_ip4_addresses_from_variant (GVariant *value,
-                                                         char **out_gateway);
-

-Utility function to convert a GVariant of type 'aau' representing a list of +

nm_utils_ip4_addresses_from_variant ()

+
GPtrArray *
+nm_utils_ip4_addresses_from_variant (GVariant *value,
+                                     char **out_gateway);
+

Utility function to convert a GVariant of type 'aau' representing a list of NetworkManager IPv4 addresses (which are tuples of address, prefix, and -gateway) into a GPtrArray of NMIPAddress objects. The "gateway" field of -the first address (if set) will be returned in out_gateway; the "gateway" fields -of the other addresses are ignored. -

-
+gateway) into a GPtrArray of NMIPAddress objects. The "gateway" field of +the first address (if set) will be returned in out_gateway +; the "gateway" fields +of the other addresses are ignored.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + +

value :

a GVariant of type 'aau'

out_gateway :

on return, will contain the IP gateway. [out][allow-none][transfer full] -

value

a GVariant of type 'aau'

 

Returns :

a newly allocated -GPtrArray of NMIPAddress objects. [transfer full][element-type NMIPAddress] -

out_gateway

on return, will contain the IP gateway.

[out][allow-none][transfer full]
+
+

Returns

+

a newly allocated +GPtrArray of NMIPAddress objects.

+

[transfer full][element-type NMIPAddress]

+
+
-

nm_utils_ip4_routes_to_variant ()

-
GVariant *          nm_utils_ip4_routes_to_variant      (GPtrArray *routes);
-

-Utility function to convert a GPtrArray of NMIPRoute objects representing -IPv4 routes into a GVariant of type 'aau' representing an array of +

nm_utils_ip4_routes_to_variant ()

+
GVariant *
+nm_utils_ip4_routes_to_variant (GPtrArray *routes);
+

Utility function to convert a GPtrArray of NMIPRoute objects representing +IPv4 routes into a GVariant of type 'aau' representing an array of NetworkManager IPv4 routes (which are tuples of route, prefix, next hop, and -metric). -

-
+metric).

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

routes :

an array of NMIP4Route objects. [element-type NMIPRoute] -

Returns :

a new floating GVariant representing routes. [transfer none] -

routes

an array of NMIP4Route objects.

[element-type NMIPRoute]
+
+

Returns

+

a new floating GVariant representing routes +.

+

[transfer none]

+
+
-

nm_utils_ip4_routes_from_variant ()

-
GPtrArray *         nm_utils_ip4_routes_from_variant    (GVariant *value);
-

-Utility function to convert a GVariant of type 'aau' representing an array +

nm_utils_ip4_routes_from_variant ()

+
GPtrArray *
+nm_utils_ip4_routes_from_variant (GVariant *value);
+

Utility function to convert a GVariant of type 'aau' representing an array of NetworkManager IPv4 routes (which are tuples of route, prefix, next hop, -and metric) into a GPtrArray of NMIPRoute objects. -

-
+and metric) into a GPtrArray of NMIPRoute objects.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

value :

-GVariant of type 'aau'

Returns :

a newly allocated -GPtrArray of NMIPRoute objects. [transfer full][element-type NMIPRoute] -

value

GVariant of type 'aau'

 
+
+

Returns

+

a newly allocated +GPtrArray of NMIPRoute objects.

+

[transfer full][element-type NMIPRoute]

+
+
-

nm_utils_ip4_netmask_to_prefix ()

-
guint32             nm_utils_ip4_netmask_to_prefix      (guint32 netmask);
-
+

nm_utils_ip4_netmask_to_prefix ()

+
guint32
+nm_utils_ip4_netmask_to_prefix (guint32 netmask);
+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

netmask :

an IPv4 netmask in network byte order

Returns :

the CIDR prefix represented by the netmask

netmask

an IPv4 netmask in network byte order

 
+
+

Returns

+

the CIDR prefix represented by the netmask

+

+
+
-

nm_utils_ip4_prefix_to_netmask ()

-
guint32             nm_utils_ip4_prefix_to_netmask      (guint32 prefix);
-
+

nm_utils_ip4_prefix_to_netmask ()

+
guint32
+nm_utils_ip4_prefix_to_netmask (guint32 prefix);
+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

prefix :

a CIDR prefix

Returns :

the netmask represented by the prefix, in network byte order

prefix

a CIDR prefix

 
+
+

Returns

+

the netmask represented by the prefix, in network byte order

+

+
+
-

nm_utils_ip4_get_default_prefix ()

-
guint32             nm_utils_ip4_get_default_prefix     (guint32 ip);
-

-When the Internet was originally set up, various ranges of IP addresses were +

nm_utils_ip4_get_default_prefix ()

+
guint32
+nm_utils_ip4_get_default_prefix (guint32 ip);
+

When the Internet was originally set up, various ranges of IP addresses were segmented into three network classes: A, B, and C. This function will return a prefix that is associated with the IP address specified defining where it -falls in the predefined classes. -

-
+falls in the predefined classes.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

ip :

an IPv4 address (in network byte order)

Returns :

the default class prefix for the given IP

ip

an IPv4 address (in network byte order)

 
+
+

Returns

+

the default class prefix for the given IP

+

+
+
-

nm_utils_ip6_dns_to_variant ()

-
GVariant *          nm_utils_ip6_dns_to_variant         (char **dns);
-

-Utility function to convert an array of IP address strings int a GVariant of -type 'aay' representing an array of IPv6 addresses. -

-
+

nm_utils_ip6_dns_to_variant ()

+
GVariant *
+nm_utils_ip6_dns_to_variant (char **dns);
+

Utility function to convert an array of IP address strings int a GVariant of +type 'aay' representing an array of IPv6 addresses.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

dns :

an array of IP address strings. [type utf8] -

Returns :

a new floating GVariant representing dns. [transfer none] -

dns

an array of IP address strings.

[type utf8]
+
+

Returns

+

a new floating GVariant representing dns +.

+

[transfer none]

+
+
-

nm_utils_ip6_dns_from_variant ()

-
char **             nm_utils_ip6_dns_from_variant       (GVariant *value);
-

-Utility function to convert a GVariant of type 'aay' representing a list of -IPv6 addresses into an array of IP address strings. -

-
+

nm_utils_ip6_dns_from_variant ()

+
char **
+nm_utils_ip6_dns_from_variant (GVariant *value);
+

Utility function to convert a GVariant of type 'aay' representing a list of +IPv6 addresses into an array of IP address strings.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

value :

a GVariant of type 'aay'

Returns :

a NULL-terminated array of IP address strings. [transfer full][type utf8] -

value

a GVariant of type 'aay'

 
+
+

Returns

+

a NULL-terminated array of IP address strings.

+

[transfer full][type utf8]

+
+
-

nm_utils_ip6_addresses_to_variant ()

-
GVariant *          nm_utils_ip6_addresses_to_variant   (GPtrArray *addresses,
-                                                         const char *gateway);
-

-Utility function to convert a GPtrArray of NMIPAddress objects representing -IPv6 addresses into a GVariant of type 'a(ayuay)' representing an array of +

nm_utils_ip6_addresses_to_variant ()

+
GVariant *
+nm_utils_ip6_addresses_to_variant (GPtrArray *addresses,
+                                   const char *gateway);
+

Utility function to convert a GPtrArray of NMIPAddress objects representing +IPv6 addresses into a GVariant of type 'a(ayuay)' representing an array of NetworkManager IPv6 addresses (which are tuples of address, prefix, and gateway). The "gateway" field of the first address will get the value of -gateway (if non-NULL). In all of the other addresses, that field will be -all 0s. -

-
+gateway + (if non-NULL). In all of the other addresses, that field will be +all 0s.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + +

addresses :

an array of NMIPAddress objects. [element-type NMIPAddress] -

gateway :

the gateway IP address. [allow-none] -

addresses

an array of NMIPAddress objects.

[element-type NMIPAddress]

Returns :

a new floating GVariant representing addresses. [transfer none] -

gateway

the gateway IP address.

[allow-none]
+
+

Returns

+

a new floating GVariant representing addresses +.

+

[transfer none]

+
+
-

nm_utils_ip6_addresses_from_variant ()

-
GPtrArray *         nm_utils_ip6_addresses_from_variant (GVariant *value,
-                                                         char **out_gateway);
-

-Utility function to convert a GVariant of type 'a(ayuay)' representing a +

nm_utils_ip6_addresses_from_variant ()

+
GPtrArray *
+nm_utils_ip6_addresses_from_variant (GVariant *value,
+                                     char **out_gateway);
+

Utility function to convert a GVariant of type 'a(ayuay)' representing a list of NetworkManager IPv6 addresses (which are tuples of address, prefix, -and gateway) into a GPtrArray of NMIPAddress objects. The "gateway" field -of the first address (if set) will be returned in out_gateway; the "gateway" -fields of the other addresses are ignored. -

-
+and gateway) into a GPtrArray of NMIPAddress objects. The "gateway" field +of the first address (if set) will be returned in out_gateway +; the "gateway" +fields of the other addresses are ignored.

+
+

Parameters

+
--+++ - - + + + - - - - - - + + +

value :

a GVariant of type 'a(ayuay)'

value

a GVariant of type 'a(ayuay)'

 

out_gateway :

on return, will contain the IP gateway. [out][allow-none][transfer full] -

Returns :

a newly allocated -GPtrArray of NMIPAddress objects. [transfer full][element-type NMIPAddress] -

out_gateway

on return, will contain the IP gateway.

[out][allow-none][transfer full]
+
+

Returns

+

a newly allocated +GPtrArray of NMIPAddress objects.

+

[transfer full][element-type NMIPAddress]

+
+
-

nm_utils_ip6_routes_to_variant ()

-
GVariant *          nm_utils_ip6_routes_to_variant      (GPtrArray *routes);
-

-Utility function to convert a GPtrArray of NMIPRoute objects representing -IPv6 routes into a GVariant of type 'a(ayuayu)' representing an array of +

nm_utils_ip6_routes_to_variant ()

+
GVariant *
+nm_utils_ip6_routes_to_variant (GPtrArray *routes);
+

Utility function to convert a GPtrArray of NMIPRoute objects representing +IPv6 routes into a GVariant of type 'a(ayuayu)' representing an array of NetworkManager IPv6 routes (which are tuples of route, prefix, next hop, and -metric). -

-
+metric).

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

routes :

an array of NMIPRoute objects. [element-type NMIPRoute] -

Returns :

a new floating GVariant representing routes. [transfer none] -

routes

an array of NMIPRoute objects.

[element-type NMIPRoute]
+
+

Returns

+

a new floating GVariant representing routes +.

+

[transfer none]

+
+
-

nm_utils_ip6_routes_from_variant ()

-
GPtrArray *         nm_utils_ip6_routes_from_variant    (GVariant *value);
-

-Utility function to convert a GVariant of type 'a(ayuayu)' representing an +

nm_utils_ip6_routes_from_variant ()

+
GPtrArray *
+nm_utils_ip6_routes_from_variant (GVariant *value);
+

Utility function to convert a GVariant of type 'a(ayuayu)' representing an array of NetworkManager IPv6 routes (which are tuples of route, prefix, next -hop, and metric) into a GPtrArray of NMIPRoute objects. -

-
+hop, and metric) into a GPtrArray of NMIPRoute objects.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

value :

-GVariant of type 'a(ayuayu)'

Returns :

a newly allocated -GPtrArray of NMIPRoute objects. [transfer full][element-type NMIPRoute] -

value

GVariant of type 'a(ayuayu)'

 
+
+

Returns

+

a newly allocated +GPtrArray of NMIPRoute objects.

+

[transfer full][element-type NMIPRoute]

+
+
-

nm_utils_ip_addresses_to_variant ()

-
GVariant *          nm_utils_ip_addresses_to_variant    (GPtrArray *addresses);
-

-Utility function to convert a GPtrArray of NMIPAddress objects representing -IPv4 or IPv6 addresses into a GVariant of type 'aa{sv}' representing an +

nm_utils_ip_addresses_to_variant ()

+
GVariant *
+nm_utils_ip_addresses_to_variant (GPtrArray *addresses);
+

Utility function to convert a GPtrArray of NMIPAddress objects representing +IPv4 or IPv6 addresses into a GVariant of type 'aa{sv}' representing an array of new-style NetworkManager IP addresses. All addresses will include "address" (an IP address string), and "prefix" (a uint). Some addresses may -include additional attributes. -

-
+include additional attributes.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

addresses :

an array of NMIPAddress objects. [element-type NMIPAddress] -

Returns :

a new floating GVariant representing addresses. [transfer none] -

addresses

an array of NMIPAddress objects.

[element-type NMIPAddress]
+
+

Returns

+

a new floating GVariant representing addresses +.

+

[transfer none]

+
+
-

nm_utils_ip_addresses_from_variant ()

-
GPtrArray *         nm_utils_ip_addresses_from_variant  (GVariant *value,
-                                                         int family);
-

-Utility function to convert a GVariant representing a list of new-style +

nm_utils_ip_addresses_from_variant ()

+
GPtrArray *
+nm_utils_ip_addresses_from_variant (GVariant *value,
+                                    int family);
+

Utility function to convert a GVariant representing a list of new-style NetworkManager IPv4 or IPv6 addresses (as described in the documentation for -nm_utils_ip_addresses_to_variant()) into a GPtrArray of NMIPAddress -objects. -

-
+nm_utils_ip_addresses_to_variant()) into a GPtrArray of NMIPAddress +objects.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + +

value :

a GVariant of type 'aa{sv}'

family :

an IP address family

value

a GVariant of type 'aa{sv}'

 

Returns :

a newly allocated -GPtrArray of NMIPAddress objects. [transfer full][element-type NMIPAddress] -

family

an IP address family

 
+
+

Returns

+

a newly allocated +GPtrArray of NMIPAddress objects.

+

[transfer full][element-type NMIPAddress]

+
+
-

nm_utils_ip_routes_to_variant ()

-
GVariant *          nm_utils_ip_routes_to_variant       (GPtrArray *routes);
-

-Utility function to convert a GPtrArray of NMIPRoute objects representing -IPv4 or IPv6 routes into a GVariant of type 'aa{sv}' representing an array +

nm_utils_ip_routes_to_variant ()

+
GVariant *
+nm_utils_ip_routes_to_variant (GPtrArray *routes);
+

Utility function to convert a GPtrArray of NMIPRoute objects representing +IPv4 or IPv6 routes into a GVariant of type 'aa{sv}' representing an array of new-style NetworkManager IP routes (which are tuples of destination, -prefix, next hop, metric, and additional attributes). -

-
+prefix, next hop, metric, and additional attributes).

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

routes :

an array of NMIPRoute objects. [element-type NMIPRoute] -

Returns :

a new floating GVariant representing routes. [transfer none] -

routes

an array of NMIPRoute objects.

[element-type NMIPRoute]
+
+

Returns

+

a new floating GVariant representing routes +.

+

[transfer none]

+
+
-

nm_utils_ip_routes_from_variant ()

-
GPtrArray *         nm_utils_ip_routes_from_variant     (GVariant *value,
-                                                         int family);
-

-Utility function to convert a GVariant representing a list of new-style +

nm_utils_ip_routes_from_variant ()

+
GPtrArray *
+nm_utils_ip_routes_from_variant (GVariant *value,
+                                 int family);
+

Utility function to convert a GVariant representing a list of new-style NetworkManager IPv4 or IPv6 addresses (which are tuples of destination, -prefix, next hop, metric, and additional attributes) into a GPtrArray of -NMIPRoute objects. -

-
+prefix, next hop, metric, and additional attributes) into a GPtrArray of +NMIPRoute objects.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + +

value :

a GVariant of type 'aa{sv}'

family :

an IP address family

value

a GVariant of type 'aa{sv}'

 

Returns :

a newly allocated -GPtrArray of NMIPRoute objects. [transfer full][element-type NMIPRoute] -

family

an IP address family

 
+
+

Returns

+

a newly allocated +GPtrArray of NMIPRoute objects.

+

[transfer full][element-type NMIPRoute]

+
+
-

nm_utils_uuid_generate ()

-
char *              nm_utils_uuid_generate              (void);
-
---- - - - - -

Returns :

a newly allocated UUID suitable for use as the NMSettingConnection -object's "id": property. Should be freed with g_free() -
+

nm_utils_uuid_generate ()

+
char *
+nm_utils_uuid_generate (void);
+
+

Returns

+

a newly allocated UUID suitable for use as the NMSettingConnection +object's “id”: property. Should be freed with g_free()

+

+

-

nm_utils_file_is_certificate ()

-
gboolean            nm_utils_file_is_certificate        (const char *filename);
-

-Tests if filename has a valid extension for an X.509 certificate file +

nm_utils_file_is_certificate ()

+
gboolean
+nm_utils_file_is_certificate (const char *filename);
+

Tests if filename + 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. -

-
+recognized by NetworkManager.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

filename :

name of the file to test

Returns :

-TRUE if the file is a certificate, FALSE if it is not

filename

name of the file to test

 
+
+

Returns

+

TRUE if the file is a certificate, FALSE if it is not

+

+
+
-

nm_utils_file_is_private_key ()

-
gboolean            nm_utils_file_is_private_key        (const char *filename,
-                                                         gboolean *out_encrypted);
-

-Tests if filename has a valid extension for an X.509 private key file +

nm_utils_file_is_private_key ()

+
gboolean
+nm_utils_file_is_private_key (const char *filename,
+                              gboolean *out_encrypted);
+

Tests if filename + 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. -

-
+recognized by NetworkManager.

+
+

Parameters

+
--+++ - - + + + - - - - - - + + +

filename :

name of the file to test

filename

name of the file to test

 

out_encrypted :

on return, whether the file is encrypted. [out] -

Returns :

-TRUE if the file is a private key, FALSE if it is not

out_encrypted

on return, whether the file is encrypted.

[out]
+
+

Returns

+

TRUE if the file is a private key, FALSE if it is not

+

+
+
-

nm_utils_file_is_pkcs12 ()

-
gboolean            nm_utils_file_is_pkcs12             (const char *filename);
-

-Tests if filename is a PKCS#12 file. -

-
+

nm_utils_file_is_pkcs12 ()

+
gboolean
+nm_utils_file_is_pkcs12 (const char *filename);
+

Tests if filename + is a PKCS#12 file.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

filename :

name of the file to test

Returns :

-TRUE if the file is PKCS#12, FALSE if it is not

filename

name of the file to test

 
+
+

Returns

+

TRUE if the file is PKCS#12, FALSE if it is not

+

+
+
-

NMUtilsFileSearchInPathsPredicate ()

-
gboolean            (*NMUtilsFileSearchInPathsPredicate)
-                                                        (const char *filename,
-                                                         gpointer user_data);
+

NMUtilsFileSearchInPathsPredicate ()

+
gboolean
+(*NMUtilsFileSearchInPathsPredicate) (const char *filename,
+                                      gpointer user_data);

+
+

Returns

+

+

-

nm_utils_file_search_in_paths ()

-
const char *        nm_utils_file_search_in_paths       (const char *progname,
-                                                         const char *try_first,
-                                                         const char *const *paths,
-                                                         GFileTest file_test_flags,
-                                                         NMUtilsFileSearchInPathsPredicate predicate,
-                                                         gpointer user_data,
-                                                         GError **error);
-

-Searches for a progname file in a list of search paths. -

-
+

nm_utils_file_search_in_paths ()

+
const char *
+nm_utils_file_search_in_paths (const char *progname,
+                               const char *try_first,
+                               const char *const *paths,
+                               GFileTest file_test_flags,
+                               NMUtilsFileSearchInPathsPredicate predicate,
+                               gpointer user_data,
+                               GError **error);
+

Searches for a progname + file in a list of search paths +.

+
+

Parameters

+
--+++ - - + + + - - + + + - - + + + - - + + + - - + - - - - +file_test_flags +. You cannot omit both file_test_flags +and predicate +.

+ - - + + + - - + + +

progname :

the helper program name, like "iptables" -Must be a non-empty string, without path separator (/).

progname

the helper program name, like "iptables" +Must be a non-empty string, without path separator (/).

 

try_first :

a custom path to try first before searching. -It is silently ignored if it is empty or not an absolute path. [allow-none] -

try_first

a custom path to try first before searching. +It is silently ignored if it is empty or not an absolute path.

[allow-none]

paths :

a NULL terminated list of search paths. -Can be empty or NULL, in which case only try_first is checked. [allow-none] -

paths

a NULL terminated list of search paths. +Can be empty or NULL, in which case only try_first +is checked.

[allow-none]

file_test_flags :

the flags passed to g_file_test() when searching -for progname. Set it to 0 to skip the g_file_test().

file_test_flags

the flags passed to g_file_test() when searching +for progname +. Set it to 0 to skip the g_file_test().

 

predicate :

if given, pass the file name to this function +

predicate

if given, pass the file name to this function for additional checks. This check is performed after the check for -file_test_flags. You cannot omit both file_test_flags and predicate. [scope call] -

user_data :

(allow-none): user data for predicate function. [closure] -[scope call]

error :

on failure, a "not found" error using error_domain and error_code -

user_data

(allow-none): user data for predicate +function.

[closure]

Returns :

the full path to the helper, if found, or NULL if not found. -The returned string is not owned by the caller, but later -invocations of the function might overwrite it. [transfer none] -

error

on failure, set a "not found" error G_IO_ERROR G_IO_ERROR_NOT_FOUND.

[allow-none]
+
+

Returns

+

the full path to the helper, if found, or NULL if not found. +The returned string is not owned by the caller, but later +invocations of the function might overwrite it.

+

[transfer none]

+
+
-

nm_utils_wifi_freq_to_channel ()

-
guint32             nm_utils_wifi_freq_to_channel       (guint32 freq);
-

-Utility function to translate a Wi-Fi frequency to its corresponding channel. -

-
+

nm_utils_wifi_freq_to_channel ()

+
guint32
+nm_utils_wifi_freq_to_channel (guint32 freq);
+

Utility function to translate a Wi-Fi frequency to its corresponding channel.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

freq :

frequency

Returns :

the channel represented by the frequency or 0

freq

frequency

 
+
+

Returns

+

the channel represented by the frequency or 0

+

+
+
-

nm_utils_wifi_channel_to_freq ()

-
guint32             nm_utils_wifi_channel_to_freq       (guint32 channel,
-                                                         const char *band);
-

-Utility function to translate a Wi-Fi channel to its corresponding frequency. -

-
+

nm_utils_wifi_channel_to_freq ()

+
guint32
+nm_utils_wifi_channel_to_freq (guint32 channel,
+                               const char *band);
+

Utility function to translate a Wi-Fi channel to its corresponding frequency.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + +

channel :

channel

band :

frequency band for wireless ("a" or "bg")

channel

channel

 

Returns :

the frequency represented by the channel of the band, -or -1 when the freq is invalid, or 0 when the band -is invalid

band

frequency band for wireless ("a" or "bg")

 
+
+

Returns

+

the frequency represented by the channel of the band, +or -1 when the freq is invalid, or 0 when the band +is invalid

+

+
+
-

nm_utils_wifi_find_next_channel ()

-
guint32             nm_utils_wifi_find_next_channel     (guint32 channel,
-                                                         int direction,
-                                                         char *band);
-

-Utility function to find out next/previous Wi-Fi channel for a channel. -

-
+

nm_utils_wifi_find_next_channel ()

+
guint32
+nm_utils_wifi_find_next_channel (guint32 channel,
+                                 int direction,
+                                 char *band);
+

Utility function to find out next/previous Wi-Fi channel for a channel.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + + - - + + +

channel :

current channel

direction :

whether going downward (0 or less) or upward (1 or more)

channel

current channel

 

band :

frequency band for wireless ("a" or "bg")

direction

whether going downward (0 or less) or upward (1 or more)

 

Returns :

the next channel in the specified direction or 0

band

frequency band for wireless ("a" or "bg")

 
+
+

Returns

+

the next channel in the specified direction or 0

+

+
+
-

nm_utils_wifi_is_channel_valid ()

-
gboolean            nm_utils_wifi_is_channel_valid      (guint32 channel,
-                                                         const char *band);
-

-Utility function to verify Wi-Fi channel validity. -

-
+

nm_utils_wifi_is_channel_valid ()

+
gboolean
+nm_utils_wifi_is_channel_valid (guint32 channel,
+                                const char *band);
+

Utility function to verify Wi-Fi channel validity.

+
+

Parameters

+
--+++ - - + + + - - - - - - + + +

channel :

channel

channel

channel

 

band :

frequency band for wireless ("a" or "bg")

Returns :

-TRUE or FALSE -

band

frequency band for wireless ("a" or "bg")

 
+
+

Returns

+

TRUE or FALSE

+

+
+
-

nm_utils_wifi_strength_bars ()

-
const char *        nm_utils_wifi_strength_bars         (guint8 strength);
-

-Converts strength into a 4-character-wide graphical representation of +

nm_utils_wifi_strength_bars ()

+
const char *
+nm_utils_wifi_strength_bars (guint8 strength);
+

Converts strength + into a 4-character-wide graphical representation of strength suitable for printing to stdout. If the current locale and terminal support it, this will use unicode graphics characters to represent -"bars". Otherwise it will use 0 to 4 asterisks. -

-
+"bars". Otherwise it will use 0 to 4 asterisks.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

strength :

the access point strength, from 0 to 100

Returns :

the graphical representation of the access point strength

strength

the access point strength, from 0 to 100

 
-
-
-

NM_UTILS_HWADDR_LEN_MAX

-
#define NM_UTILS_HWADDR_LEN_MAX 20 /* INFINIBAND_ALEN */
-
-

-The maximum length of hardware addresses handled by NetworkManager itself, -nm_utils_hwaddr_len(), and nm_utils_hwaddr_aton(). -

+
+

Returns

+

the graphical representation of the access point strength

+

+

-

nm_utils_hwaddr_len ()

-
gsize               nm_utils_hwaddr_len                 (int type);
-

-Returns the length in octets of a hardware address of type type. -

-

-It is an error to call this function with any value other than -ARPHRD_ETHER or ARPHRD_INFINIBAND. -

-
+

nm_utils_hwaddr_len ()

+
gsize
+nm_utils_hwaddr_len (int type);
+

Returns the length in octets of a hardware address of type type +.

+

It is an error to call this function with any value other than +ARPHRD_ETHER or ARPHRD_INFINIBAND.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

type :

the type of address; either ARPHRD_ETHER or -ARPHRD_INFINIBAND -

Returns :

the length.

type

the type of address; either ARPHRD_ETHER or +ARPHRD_INFINIBAND

 
+
+

Returns

+

the length.

+

+
+
-

nm_utils_hwaddr_ntoa ()

-
char *              nm_utils_hwaddr_ntoa                (gconstpointer addr,
-                                                         gsize length);
-

-Converts addr to textual form. -

-
+

nm_utils_hwaddr_ntoa ()

+
char *
+nm_utils_hwaddr_ntoa (gconstpointer addr,
+                      gsize length);
+

Converts addr + to textual form.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + +

addr :

a binary hardware address. [type guint8][array length=length] -

length :

the length of addr -

addr

a binary hardware address.

[type guint8][array length=length]

Returns :

the textual form of addr. [transfer full] -

length

the length of addr +

 
+
+

Returns

+

the textual form of addr +.

+

[transfer full]

+
+
-

nm_utils_hwaddr_atoba ()

-
GByteArray *        nm_utils_hwaddr_atoba               (const char *asc,
-                                                         gsize length);
-

-Parses asc and converts it to binary form in a GByteArray. See -nm_utils_hwaddr_aton() if you don't want a GByteArray. -

-
+

nm_utils_hwaddr_atoba ()

+
GByteArray *
+nm_utils_hwaddr_atoba (const char *asc,
+                       gsize length);
+

Parses asc + and converts it to binary form in a GByteArray. See +nm_utils_hwaddr_aton() if you don't want a GByteArray.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + +

asc :

the ASCII representation of a hardware address

length :

the expected length in bytes of the result

asc

the ASCII representation of a hardware address

 

Returns :

a new GByteArray, or NULL if asc couldn't -be parsed. [transfer full] -

length

the expected length in bytes of the result

 
+
+

Returns

+

a new GByteArray, or NULL if asc +couldn't +be parsed.

+

[transfer full]

+
+
-

nm_utils_hwaddr_aton ()

-
guint8 *            nm_utils_hwaddr_aton                (const char *asc,
-                                                         gpointer buffer,
-                                                         gsize length);
-

-Parses asc and converts it to binary form in buffer. -Bytes in asc can be sepatared by colons (:), or hyphens (-), but not mixed. -

-
+

nm_utils_hwaddr_aton ()

+
guint8 *
+nm_utils_hwaddr_aton (const char *asc,
+                      gpointer buffer,
+                      gsize length);
+

Parses asc + and converts it to binary form in buffer +. +Bytes in asc + can be sepatared by colons (:), or hyphens (-), but not mixed.

+
+

Parameters

+
--+++ - - + + + - - + + + - - - - - - + + +

asc :

the ASCII representation of a hardware address

asc

the ASCII representation of a hardware address

 

buffer :

buffer to store the result into

buffer

buffer to store the result into

 

length :

the expected length in bytes of the result and -the size of the buffer in bytes.

Returns :

-buffer, or NULL if asc couldn't be parsed -or would be shorter or longer than length.

length

the expected length in bytes of the result and +the size of the buffer in bytes.

 
+
+

Returns

+

buffer +, or NULL if asc +couldn't be parsed +or would be shorter or longer than length +.

+

+
+
-

nm_utils_hwaddr_valid ()

-
gboolean            nm_utils_hwaddr_valid               (const char *asc,
-                                                         gssize length);
-

-Parses asc to see if it is a valid hardware address of the given -length. -

-
+

nm_utils_hwaddr_valid ()

+
gboolean
+nm_utils_hwaddr_valid (const char *asc,
+                       gssize length);
+

Parses asc + to see if it is a valid hardware address of the given +length.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + +

asc :

the ASCII representation of a hardware address

length :

the length of address that asc is expected to convert to -(or -1 to accept any length up to NM_UTILS_HWADDR_LEN_MAX)

asc

the ASCII representation of a hardware address

 

Returns :

-TRUE if asc appears to be a valid hardware address -of the indicated length, FALSE if not.

length

the length of address that asc +is expected to convert to +(or -1 to accept any length up to NM_UTILS_HWADDR_LEN_MAX)

 
+
+

Returns

+

TRUE if asc +appears to be a valid hardware address +of the indicated length, FALSE if not.

+

+
+
-

nm_utils_hwaddr_canonical ()

-
char *              nm_utils_hwaddr_canonical           (const char *asc,
-                                                         gssize length);
-

-Parses asc to see if it is a valid hardware address of the given +

nm_utils_hwaddr_canonical ()

+
char *
+nm_utils_hwaddr_canonical (const char *asc,
+                           gssize length);
+

Parses asc + to see if it is a valid hardware address of the given length, and if so, returns it in canonical form (uppercase, with -leading 0s as needed, and with colons rather than hyphens). -

-
+leading 0s as needed, and with colons rather than hyphens).

+
+

Parameters

+
--+++ - - + + + - - - - - - + + +

asc :

the ASCII representation of a hardware address

asc

the ASCII representation of a hardware address

 

length :

the length of address that asc is expected to convert to -(or -1 to accept any length up to NM_UTILS_HWADDR_LEN_MAX)

Returns :

the canonicalized address if asc appears to -be a valid hardware address of the indicated length, NULL if not. [transfer full] -

length

the length of address that asc +is expected to convert to +(or -1 to accept any length up to NM_UTILS_HWADDR_LEN_MAX)

 
+
+

Returns

+

the canonicalized address if asc +appears to +be a valid hardware address of the indicated length, NULL if not.

+

[transfer full]

+
+
-

nm_utils_hwaddr_matches ()

-
gboolean            nm_utils_hwaddr_matches             (gconstpointer hwaddr1,
-                                                         gssize hwaddr1_len,
-                                                         gconstpointer hwaddr2,
-                                                         gssize hwaddr2_len);
-

-Generalized hardware address comparison function. Tests if hwaddr1 and -hwaddr2 "equal" (or more precisely, "equivalent"), with several advantages -over a simple memcmp(): -

-

- 1. If hwaddr1_len or hwaddr2_len is -1, then the corresponding address is - assumed to be ASCII rather than binary, and will be converted to binary - before being compared. -

-

- 2. If hwaddr1 or hwaddr2 is NULL, it is treated instead as though it was - a zero-filled buffer hwaddr1_len or hwaddr2_len bytes long. -

-

- 3. If hwaddr1 and hwaddr2 are InfiniBand hardware addresses (that is, if - they are INFINIBAND_ALEN bytes long in binary form) - then only the last 8 bytes are compared, since those are the only bytes - that actually identify the hardware. (The other 12 bytes will change - depending on the configuration of the InfiniBand fabric that the device - is connected to.) -

-

-If a passed-in ASCII hardware address cannot be parsed, or would parse to an +

nm_utils_hwaddr_matches ()

+
gboolean
+nm_utils_hwaddr_matches (gconstpointer hwaddr1,
+                         gssize hwaddr1_len,
+                         gconstpointer hwaddr2,
+                         gssize hwaddr2_len);
+

Generalized hardware address comparison function. Tests if hwaddr1 + and +hwaddr2 + "equal" (or more precisely, "equivalent"), with several advantages +over a simple memcmp():

+
    +
  1. If hwaddr1_len + or hwaddr2_len + is -1, then the corresponding address is + assumed to be ASCII rather than binary, and will be converted to binary + before being compared.

  2. +
  3. If hwaddr1 + or hwaddr2 + is NULL, it is treated instead as though it was + a zero-filled buffer hwaddr1_len + or hwaddr2_len + bytes long.

  4. +
  5. If hwaddr1 + and hwaddr2 + are InfiniBand hardware addresses (that is, if + they are INFINIBAND_ALEN bytes long in binary form) + then only the last 8 bytes are compared, since those are the only bytes + that actually identify the hardware. (The other 12 bytes will change + depending on the configuration of the InfiniBand fabric that the device + is connected to.)

  6. +
+

If a passed-in ASCII hardware address cannot be parsed, or would parse to an address larger than NM_UTILS_HWADDR_LEN_MAX, then it will silently fail to match. (This means that externally-provided address strings do not need to be sanity-checked before comparing them against known good addresses; they are -guaranteed to not match if they are invalid.) -

-
+guaranteed to not match if they are invalid.)

+
+

Parameters

+
--+++ - - - - - - + + + - - + + + - - + + + - - + + +

hwaddr1 :

pointer to a binary or ASCII hardware address, or NULL -

hwaddr1_len :

size of hwaddr1, or -1 if hwaddr1 is ASCII

hwaddr1

pointer to a binary or ASCII hardware address, or NULL

 

hwaddr2 :

pointer to a binary or ASCII hardware address, or NULL -

hwaddr1_len

size of hwaddr1 +, or -1 if hwaddr1 +is ASCII

 

hwaddr2_len :

size of hwaddr2, or -1 if hwaddr2 is ASCII

hwaddr2

pointer to a binary or ASCII hardware address, or NULL

 

Returns :

-TRUE if hwaddr1 and hwaddr2 are equivalent, FALSE if they are -different (or either of them is invalid).

hwaddr2_len

size of hwaddr2 +, or -1 if hwaddr2 +is ASCII

 
+
+

Returns

+

TRUE if hwaddr1 +and hwaddr2 +are equivalent, FALSE if they are +different (or either of them is invalid).

+

+
+
-

nm_utils_bin2hexstr ()

-
char *              nm_utils_bin2hexstr                 (gconstpointer src,
-                                                         gsize len,
-                                                         int final_len);
-

-Converts the byte array src into a hexadecimal string. If final_len is +

nm_utils_bin2hexstr ()

+
char *
+nm_utils_bin2hexstr (gconstpointer src,
+                     gsize len,
+                     int final_len);
+

Converts the byte array src + into a hexadecimal string. If final_len + is greater than -1, the returned string is terminated at that index -(returned_string[final_len] == '\0'), -

-
+(returned_string[final_len] == '\0'),

+
+

Parameters

+
--+++ - - - - - - + + + - - + + + - - + + +

src :

an array of bytes. [type guint8][array length=len] -

len :

the length of the src array

src

an array of bytes.

[type guint8][array length=len]

final_len :

an index where to cut off the returned string, or -1

len

the length of the src +array

 

Returns :

the textual form of bytes. [transfer full] -

final_len

an index where to cut off the returned string, or -1

 
+
+

Returns

+

the textual form of bytes +.

+

[transfer full]

+
+
-

nm_utils_hexstr2bin ()

-
GBytes *            nm_utils_hexstr2bin                 (const char *hex);
-

-Converts a hexadecimal string hex into an array of bytes. The optional +

nm_utils_hexstr2bin ()

+
GBytes *
+nm_utils_hexstr2bin (const char *hex);
+

Converts a hexadecimal string hex + into an array of bytes. The optional separator ':' may be used between single or pairs of hexadecimal characters, -eg "00:11" or "0:1". Any "0x" at the beginning of hex is ignored. hex -may not start or end with ':'. -

-
+eg "00:11" or "0:1". Any "0x" at the beginning of hex + is ignored. hex + +may not start or end with ':'.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

hex :

a string of hexadecimal characters with optional ':' separators

Returns :

the converted bytes, or NULL on error. [transfer full] -

hex

a string of hexadecimal characters with optional ':' separators

 
+
+

Returns

+

the converted bytes, or NULL on error.

+

[transfer full]

+
+
-

nm_utils_iface_valid_name ()

-
gboolean            nm_utils_iface_valid_name           (const char *name);
-

-This function is a 1:1 copy of the kernel's interface validation -function in net/core/dev.c. -

-
+

nm_utils_iface_valid_name ()

+
gboolean
+nm_utils_iface_valid_name (const char *name);
+

This function is a 1:1 copy of the kernel's interface validation +function in net/core/dev.c.

+
+

Parameters

+
--+++ - - - - - - - - - - + + + + +

name :

Name of interface

Returns :

-TRUE if interface name is valid, otherwise FALSE is returned.

name

Name of interface

 
+
+

Returns

+

TRUE if interface name is valid, otherwise FALSE is returned.

+

+
+
-

nm_utils_is_uuid ()

-
gboolean            nm_utils_is_uuid                    (const char *str);
-

-Checks if str is a UUID -

-
+

nm_utils_is_uuid ()

+
gboolean
+nm_utils_is_uuid (const char *str);
+

Checks if str + is a UUID

+
+

Parameters

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

str

a string that might be a UUID

 
+
+
+

Returns

+

TRUE if str +is a UUID, FALSE if not

+

+
+ +
+
+

nm_utils_inet4_ntop ()

+
const char *
+nm_utils_inet4_ntop (in_addr_t inaddr,
+                     char *dst);
+

Wrapper for inet_ntop.

+
+

Parameters

+
--+++ - - + + + - - + + +

str :

a string that might be a UUID

inaddr

the address that should be converted to string.

 

Returns :

-TRUE if str is a UUID, FALSE if not

dst

the destination buffer, it must contain at least +INET_ADDRSTRLEN or NM_UTILS_INET_ADDRSTRLEN +characters. If set to NULL, it will return a pointer to an internal, static +buffer (shared with nm_utils_inet6_ntop()). Beware, that the internal +buffer will be overwritten with ever new call of nm_utils_inet4_ntop() or +nm_utils_inet6_ntop() that does not provied it's own dst +buffer. Also, +using the internal buffer is not thread safe. When in doubt, pass your own +dst +buffer to avoid these issues.

 
-
-
-

NM_UTILS_INET_ADDRSTRLEN

-
#define NM_UTILS_INET_ADDRSTRLEN     INET6_ADDRSTRLEN
-
-

-Defines the minimal length for a char buffer that is suitable as dst argument -for both nm_utils_inet4_ntop() and nm_utils_inet6_ntop(). -

+
+

Returns

+

the input buffer dst +, or a pointer to an +internal, static buffer. This function cannot fail.

+

+

-

nm_utils_inet4_ntop ()

-
const char *        nm_utils_inet4_ntop                 (in_addr_t inaddr,
-                                                         char *dst);
-

-Wrapper for inet_ntop. -

-
+

nm_utils_inet6_ntop ()

+
const char *
+nm_utils_inet6_ntop (const struct in6_addr *in6addr,
+                     char *dst);
+

Wrapper for inet_ntop.

+
+

Parameters

+
--+++ - - + + + - - + - - - - +dst +buffer to avoid these issues.

+

inaddr :

the address that should be converted to string.

in6addr

the address that should be converted to string.

 

dst :

the destination buffer, it must contain at least -INET_ADDRSTRLEN or NM_UTILS_INET_ADDRSTRLEN -characters. If set to NULL, it will return a pointer to an internal, static -buffer (shared with nm_utils_inet6_ntop()). Beware, that the internal -buffer will be overwritten with ever new call of nm_utils_inet4_ntop() or -nm_utils_inet6_ntop() that does not provied it's own dst buffer. Also, +

dst

the destination buffer, it must contain at least +INET6_ADDRSTRLEN or NM_UTILS_INET_ADDRSTRLEN +characters. If set to NULL, it will return a pointer to an internal, static +buffer (shared with nm_utils_inet4_ntop()). Beware, that the internal +buffer will be overwritten with ever new call of nm_utils_inet4_ntop() or +nm_utils_inet6_ntop() that does not provied it's own dst +buffer. Also, using the internal buffer is not thread safe. When in doubt, pass your own -dst buffer to avoid these issues.

Returns :

the input buffer dst, or a pointer to an -internal, static buffer. This function cannot fail. 
+
+

Returns

+

the input buffer dst +, or a pointer to an +internal, static buffer. NULL is not allowed as in6addr +, +otherwise, this function cannot fail.

+

+
+

-

nm_utils_inet6_ntop ()

-
const char *        nm_utils_inet6_ntop                 (const struct in6_addr *in6addr,
-                                                         char *dst);
-

-Wrapper for inet_ntop. -

-
+

nm_utils_ipaddr_valid ()

+
gboolean
+nm_utils_ipaddr_valid (int family,
+                       const char *ip);
+

Checks if ip + contains a valid IP address of the given family.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + +

in6addr :

the address that should be converted to string.

dst :

the destination buffer, it must contain at least -INET6_ADDRSTRLEN or NM_UTILS_INET_ADDRSTRLEN -characters. If set to NULL, it will return a pointer to an internal, static -buffer (shared with nm_utils_inet4_ntop()). Beware, that the internal -buffer will be overwritten with ever new call of nm_utils_inet4_ntop() or -nm_utils_inet6_ntop() that does not provied it's own dst buffer. Also, -using the internal buffer is not thread safe. When in doubt, pass your own -dst buffer to avoid these issues.

family

AF_INET or AF_INET6, or +AF_UNSPEC to accept either

 

Returns :

the input buffer dst, or a pointer to an -internal, static buffer. NULL is not allowed as in6addr, -otherwise, this function cannot fail.

ip

an IP address

 
+
+

Returns

+

TRUE or FALSE

+

+
+
-

nm_utils_ipaddr_valid ()

-
gboolean            nm_utils_ipaddr_valid               (int family,
-                                                         const char *ip);
-

-Checks if ip contains a valid IP address of the given family. -

-
+

nm_utils_check_virtual_device_compatibility ()

+
gboolean
+nm_utils_check_virtual_device_compatibility
+                               (GType virtual_type,
+                                GType other_type);
+

Determines if a connection of type virtual_type + can (in the +general case) work with connections of type other_type +.

+

If virtual_type + is NM_TYPE_SETTING_VLAN, then this checks if +other_type + is a valid type for the parent of a VLAN.

+

If virtual_type + is a "master" type (eg, NM_TYPE_SETTING_BRIDGE), +then this checks if other_type + is a valid type for a slave of that +master.

+

Note that even if this returns TRUE it is not guaranteed that +every connection of type other_type + is +compatible with virtual_type +; it may depend on the exact +configuration of the two connections, or on the capabilities of an +underlying device driver.

+
+

Parameters

+
--+++ - - - - - - + + + - - + + +

family :

-AF_INET or AF_INET6, or -AF_UNSPEC to accept either

ip :

an IP address

virtual_type

a virtual connection type

 

Returns :

-TRUE or FALSE -

other_type

a connection type to test against virtual_type +

 
-
+
+

Returns

+

TRUE or FALSE

+

+
+ + +
+

Types and Values

-

nm_utils_check_virtual_device_compatibility ()

-
gboolean            nm_utils_check_virtual_device_compatibility
-                                                        (GType virtual_type,
-                                                         GType other_type);
-

-Determines if a connection of type virtual_type can (in the -general case) work with connections of type other_type. -

-

-If virtual_type is NM_TYPE_SETTING_VLAN, then this checks if -other_type is a valid type for the parent of a VLAN. -

-

-If virtual_type is a "master" type (eg, NM_TYPE_SETTING_BRIDGE), -then this checks if other_type is a valid type for a slave of that -master. -

-

-Note that even if this returns TRUE it is not guaranteed that -every connection of type other_type is -compatible with virtual_type; it may depend on the exact -configuration of the two connections, or on the capabilities of an -underlying device driver. -

-
+

enum NMUtilsSecurityType

+

Describes generic security mechanisms that 802.11 access points may offer. +Used with nm_utils_security_valid() for checking whether a given access +point is compatible with a network device.

+
+

Members

+
--+++ - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + - - + + - - + + + + + + +

virtual_type :

a virtual connection type

NMU_SEC_INVALID

+

unknown or invalid security, placeholder and not used

+
 

NMU_SEC_NONE

+

unencrypted and open

+
 

NMU_SEC_STATIC_WEP

+

static WEP keys are used for encryption

+
 

NMU_SEC_LEAP

+

Cisco LEAP is used for authentication and for generating the +dynamic WEP keys automatically

+
 

NMU_SEC_DYNAMIC_WEP

+

standard 802.1x is used for authentication and +generating the dynamic WEP keys automatically

+
 

NMU_SEC_WPA_PSK

+

WPA1 is used with Pre-Shared Keys (PSK)

+
 

other_type :

a connection type to test against virtual_type +

NMU_SEC_WPA_ENTERPRISE

+

WPA1 is used with 802.1x authentication

 

Returns :

-TRUE or FALSE +

NMU_SEC_WPA2_PSK

+

WPA2/RSN is used with Pre-Shared Keys (PSK)

 

NMU_SEC_WPA2_ENTERPRISE

+

WPA2 is used with 802.1x authentication

+
 
+
+
+

NM_UTILS_HWADDR_LEN_MAX

+
#define NM_UTILS_HWADDR_LEN_MAX 20 /* INFINIBAND_ALEN */
+
+

The maximum length of hardware addresses handled by NetworkManager itself, +nm_utils_hwaddr_len(), and nm_utils_hwaddr_aton().

+
+
+
+

NM_UTILS_INET_ADDRSTRLEN

+
#define NM_UTILS_INET_ADDRSTRLEN     INET6_ADDRSTRLEN
+
+

Defines the minimal length for a char buffer that is suitable as dst + argument +for both nm_utils_inet4_ntop() and nm_utils_inet6_ntop().

+
+ + Generated by GTK-Doc V1.21 \ No newline at end of file diff --git a/docs/libnm/html/libnm-nm-version.html b/docs/libnm/html/libnm-nm-version.html index a260fbea..7cbebd93 100644 --- a/docs/libnm/html/libnm-nm-version.html +++ b/docs/libnm/html/libnm-nm-version.html @@ -2,30 +2,26 @@ -nm-version +libnm Reference Manual: nm-version - + - - - - - - - - - - + + + + + + +
@@ -33,33 +29,109 @@

nm-version

nm-version

- +
-
-

Synopsis

-
#define             NM_MAJOR_VERSION
-#define             NM_MINOR_VERSION
-#define             NM_MICRO_VERSION
-#define             NM_CHECK_VERSION                    (major,
-                                                         minor,
-                                                         micro)
-#define             NM_ENCODE_VERSION                   (major,
-                                                         minor,
-                                                         micro)
-#define             NM_VERSION_0_9_8
-#define             NM_VERSION_0_9_10
-#define             NM_VERSION_1_0
-#define             NM_VERSION_CUR_STABLE
-#define             NM_VERSION_NEXT_STABLE
-#define             NM_VERSION_MIN_REQUIRED
-#define             NM_VERSION_MAX_ALLOWED
-#define             NM_DEPRECATED_IN_0_9_10
-#define             NM_DEPRECATED_IN_0_9_10_FOR         (f)
-#define             NM_DEPRECATED_IN_1_0
-#define             NM_DEPRECATED_IN_1_0_FOR            (f)
-#define             NM_AVAILABLE_IN_0_9_10
-#define             NM_AVAILABLE_IN_1_0
-
+
+

Functions

+
++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
#defineNM_MAJOR_VERSION
#defineNM_MINOR_VERSION
#defineNM_MICRO_VERSION
#define +NM_CHECK_VERSION() +
#define +NM_ENCODE_VERSION() +
#defineNM_VERSION_0_9_8
#defineNM_VERSION_0_9_10
#defineNM_VERSION_1_0
#defineNM_VERSION_MIN_REQUIRED
#defineNM_VERSION_MAX_ALLOWED
#define +NM_DEPRECATED_IN_0_9_10_FOR() +
#define +NM_DEPRECATED_IN_1_0_FOR() +
+
+
+

Types and Values

+
++++ + + + + + + + + + + + + + + + + + + + + + + + + + + +
#defineNM_VERSION_CUR_STABLE
#defineNM_VERSION_NEXT_STABLE
#defineNM_DEPRECATED_IN_0_9_10
#defineNM_DEPRECATED_IN_1_0
#defineNM_AVAILABLE_IN_0_9_10
#defineNM_AVAILABLE_IN_1_0

Description

@@ -67,67 +139,68 @@

-

Details

+

Functions

NM_MAJOR_VERSION

#define NM_MAJOR_VERSION (1)
 
-

-Evaluates to the major version number of NetworkManager which this source -is compiled against. -

+

Evaluates to the major version number of NetworkManager which this source +is compiled against.


NM_MINOR_VERSION

#define NM_MINOR_VERSION (0)
 
-

-Evaluates to the minor version number of NetworkManager which this source -is compiled against. -

+

Evaluates to the minor version number of NetworkManager which this source +is compiled against.


NM_MICRO_VERSION

-
#define NM_MICRO_VERSION (0)
+
#define NM_MICRO_VERSION (2)
 
-

-Evaluates to the micro version number of NetworkManager which this source -compiled against. -

+

Evaluates to the micro version number of NetworkManager which this source +compiled against.


NM_CHECK_VERSION()

#define             NM_CHECK_VERSION(major,minor,micro)
-
+
+

Parameters

+
--+++ - - + + + - - + + + - - - - - - + + +

major :

major version (e.g. 1 for version 1.2.5)

major

major version (e.g. 1 for version 1.2.5)

 

minor :

minor version (e.g. 2 for version 1.2.5)

minor

minor version (e.g. 2 for version 1.2.5)

 

micro :

micro version (e.g. 5 for version 1.2.5)

Returns :

-TRUE if the version of the NetworkManager header files -is the same as or newer than the passed-in version.

micro

micro version (e.g. 5 for version 1.2.5)

 
+
+

Returns

+

TRUE if the version of the NetworkManager header files +is the same as or newer than the passed-in version.

+

+
+

NM_ENCODE_VERSION()

@@ -162,64 +235,66 @@ is the same as or newer than the passed-in version.

-

NM_VERSION_CUR_STABLE

-
#define NM_VERSION_CUR_STABLE  NM_VERSION_0_9_10
+

NM_VERSION_MIN_REQUIRED

+
# define NM_VERSION_MIN_REQUIRED (NM_VERSION_CUR_STABLE)
 


-

NM_VERSION_NEXT_STABLE

-
#define NM_VERSION_NEXT_STABLE NM_VERSION_1_0
+

NM_VERSION_MAX_ALLOWED

+
# define NM_VERSION_MAX_ALLOWED (NM_VERSION_CUR_STABLE)
 


-

NM_VERSION_MIN_REQUIRED

-
# define NM_VERSION_MIN_REQUIRED (NM_VERSION_CUR_STABLE)
+

NM_DEPRECATED_IN_0_9_10_FOR()

+
# define NM_DEPRECATED_IN_0_9_10_FOR(f) G_DEPRECATED_FOR(f)
 


-

NM_VERSION_MAX_ALLOWED

-
# define NM_VERSION_MAX_ALLOWED (NM_VERSION_CUR_STABLE)
+

NM_DEPRECATED_IN_1_0_FOR()

+
# define NM_DEPRECATED_IN_1_0_FOR(f)    G_DEPRECATED_FOR(f)
 

-
+
+
+

Types and Values

-

NM_DEPRECATED_IN_0_9_10

-
# define NM_DEPRECATED_IN_0_9_10        G_DEPRECATED
+

NM_VERSION_CUR_STABLE

+
#define NM_VERSION_CUR_STABLE  NM_VERSION_1_0
 


-

NM_DEPRECATED_IN_0_9_10_FOR()

-
# define NM_DEPRECATED_IN_0_9_10_FOR(f) G_DEPRECATED_FOR(f)
+

NM_VERSION_NEXT_STABLE

+
#define NM_VERSION_NEXT_STABLE NM_VERSION_1_0
 


-

NM_DEPRECATED_IN_1_0

-
# define NM_DEPRECATED_IN_1_0           G_DEPRECATED
+

NM_DEPRECATED_IN_0_9_10

+
# define NM_DEPRECATED_IN_0_9_10        G_DEPRECATED
 


-

NM_DEPRECATED_IN_1_0_FOR()

-
# define NM_DEPRECATED_IN_1_0_FOR(f)    G_DEPRECATED_FOR(f)
+

NM_DEPRECATED_IN_1_0

+
# define NM_DEPRECATED_IN_1_0           G_DEPRECATED
 

@@ -244,6 +319,6 @@ is the same as or newer than the passed-in version.
+ Generated by GTK-Doc V1.21
\ No newline at end of file diff --git a/docs/libnm/html/libnm-nm-vpn-dbus-interface.html b/docs/libnm/html/libnm-nm-vpn-dbus-interface.html index 3460e107..d48bb1cd 100644 --- a/docs/libnm/html/libnm-nm-vpn-dbus-interface.html +++ b/docs/libnm/html/libnm-nm-vpn-dbus-interface.html @@ -2,32 +2,27 @@ -nm-vpn-dbus-interface +libnm Reference Manual: nm-vpn-dbus-interface - - + + - - - - - - - - - - + + + + + + +
@@ -35,91 +30,274 @@

nm-vpn-dbus-interface

nm-vpn-dbus-interface

- +
-
-

Synopsis

-
#define             NM_DBUS_PATH_VPN
-#define             NM_DBUS_INTERFACE_VPN
-#define             NM_DBUS_PATH_VPN_CONNECTION
-#define             NM_DBUS_INTERFACE_VPN_CONNECTION
-#define             NM_VPN_DBUS_PLUGIN_PATH
-#define             NM_VPN_DBUS_PLUGIN_INTERFACE
-#define             NM_DBUS_NO_ACTIVE_VPN_CONNECTION
-#define             NM_DBUS_NO_VPN_CONNECTIONS
-#define             NM_DBUS_INVALID_VPN_CONNECTION
-#define             NM_DBUS_VPN_ERROR_PREFIX
-#define             NM_DBUS_VPN_STARTING_IN_PROGRESS
-#define             NM_DBUS_VPN_ALREADY_STARTED
-#define             NM_DBUS_VPN_STOPPING_IN_PROGRESS
-#define             NM_DBUS_VPN_ALREADY_STOPPED
-#define             NM_DBUS_VPN_WRONG_STATE
-#define             NM_DBUS_VPN_BAD_ARGUMENTS
-#define             NM_DBUS_VPN_INTERACTIVE_NOT_SUPPORTED
-#define             NM_DBUS_VPN_SIGNAL_LOGIN_BANNER
-#define             NM_DBUS_VPN_SIGNAL_LOGIN_FAILED
-#define             NM_DBUS_VPN_SIGNAL_LAUNCH_FAILED
-#define             NM_DBUS_VPN_SIGNAL_CONNECT_FAILED
-#define             NM_DBUS_VPN_SIGNAL_VPN_CONFIG_BAD
-#define             NM_DBUS_VPN_SIGNAL_IP_CONFIG_BAD
-#define             NM_DBUS_VPN_SIGNAL_STATE_CHANGE
-#define             NM_DBUS_VPN_SIGNAL_IP4_CONFIG
-enum                NMVpnServiceState;
-enum                NMVpnConnectionState;
-enum                NMVpnConnectionStateReason;
-enum                NMVpnPluginFailure;
-#define             NM_VPN_PLUGIN_CONFIG_TUNDEV
-#define             NM_VPN_PLUGIN_CONFIG_BANNER
-#define             NM_VPN_PLUGIN_CONFIG_EXT_GATEWAY
-#define             NM_VPN_PLUGIN_CONFIG_MTU
-#define             NM_VPN_PLUGIN_CONFIG_HAS_IP4
-#define             NM_VPN_PLUGIN_CONFIG_HAS_IP6
-#define             NM_VPN_PLUGIN_CAN_PERSIST
-#define             NM_VPN_PLUGIN_IP4_CONFIG_INT_GATEWAY
-#define             NM_VPN_PLUGIN_IP4_CONFIG_ADDRESS
-#define             NM_VPN_PLUGIN_IP4_CONFIG_PTP
-#define             NM_VPN_PLUGIN_IP4_CONFIG_PREFIX
-#define             NM_VPN_PLUGIN_IP4_CONFIG_DNS
-#define             NM_VPN_PLUGIN_IP4_CONFIG_NBNS
-#define             NM_VPN_PLUGIN_IP4_CONFIG_MSS
-#define             NM_VPN_PLUGIN_IP4_CONFIG_DOMAIN
-#define             NM_VPN_PLUGIN_IP4_CONFIG_DOMAINS
-#define             NM_VPN_PLUGIN_IP4_CONFIG_ROUTES
-#define             NM_VPN_PLUGIN_IP4_CONFIG_NEVER_DEFAULT
-#define             NM_VPN_PLUGIN_IP4_CONFIG_GATEWAY
-#define             NM_VPN_PLUGIN_IP4_CONFIG_BANNER
-#define             NM_VPN_PLUGIN_IP4_CONFIG_EXT_GATEWAY
-#define             NM_VPN_PLUGIN_IP4_CONFIG_MTU
-#define             NM_VPN_PLUGIN_IP4_CONFIG_TUNDEV
-#define             NM_VPN_PLUGIN_IP6_CONFIG_INT_GATEWAY
-#define             NM_VPN_PLUGIN_IP6_CONFIG_ADDRESS
-#define             NM_VPN_PLUGIN_IP6_CONFIG_PTP
-#define             NM_VPN_PLUGIN_IP6_CONFIG_PREFIX
-#define             NM_VPN_PLUGIN_IP6_CONFIG_DNS
-#define             NM_VPN_PLUGIN_IP6_CONFIG_MSS
-#define             NM_VPN_PLUGIN_IP6_CONFIG_DOMAIN
-#define             NM_VPN_PLUGIN_IP6_CONFIG_DOMAINS
-#define             NM_VPN_PLUGIN_IP6_CONFIG_ROUTES
-#define             NM_VPN_PLUGIN_IP6_CONFIG_NEVER_DEFAULT
-
+
+

Types and Values

+
++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
#defineNM_DBUS_PATH_VPN
#defineNM_DBUS_INTERFACE_VPN
#defineNM_DBUS_PATH_VPN_CONNECTION
#defineNM_DBUS_INTERFACE_VPN_CONNECTION
#defineNM_VPN_DBUS_PLUGIN_PATH
#defineNM_VPN_DBUS_PLUGIN_INTERFACE
#defineNM_DBUS_NO_ACTIVE_VPN_CONNECTION
#defineNM_DBUS_NO_VPN_CONNECTIONS
#defineNM_DBUS_INVALID_VPN_CONNECTION
#defineNM_DBUS_VPN_ERROR_PREFIX
#defineNM_DBUS_VPN_STARTING_IN_PROGRESS
#defineNM_DBUS_VPN_ALREADY_STARTED
#defineNM_DBUS_VPN_STOPPING_IN_PROGRESS
#defineNM_DBUS_VPN_ALREADY_STOPPED
#defineNM_DBUS_VPN_WRONG_STATE
#defineNM_DBUS_VPN_BAD_ARGUMENTS
#defineNM_DBUS_VPN_INTERACTIVE_NOT_SUPPORTED
#defineNM_DBUS_VPN_SIGNAL_LOGIN_BANNER
#defineNM_DBUS_VPN_SIGNAL_LOGIN_FAILED
#defineNM_DBUS_VPN_SIGNAL_LAUNCH_FAILED
#defineNM_DBUS_VPN_SIGNAL_CONNECT_FAILED
#defineNM_DBUS_VPN_SIGNAL_VPN_CONFIG_BAD
#defineNM_DBUS_VPN_SIGNAL_IP_CONFIG_BAD
#defineNM_DBUS_VPN_SIGNAL_STATE_CHANGE
#defineNM_DBUS_VPN_SIGNAL_IP4_CONFIG
enumNMVpnServiceState
enumNMVpnConnectionState
enumNMVpnConnectionStateReason
enumNMVpnPluginFailure
#defineNM_VPN_PLUGIN_CONFIG_TUNDEV
#defineNM_VPN_PLUGIN_CONFIG_BANNER
#defineNM_VPN_PLUGIN_CONFIG_EXT_GATEWAY
#defineNM_VPN_PLUGIN_CONFIG_MTU
#defineNM_VPN_PLUGIN_CONFIG_HAS_IP4
#defineNM_VPN_PLUGIN_CONFIG_HAS_IP6
#defineNM_VPN_PLUGIN_CAN_PERSIST
#defineNM_VPN_PLUGIN_IP4_CONFIG_INT_GATEWAY
#defineNM_VPN_PLUGIN_IP4_CONFIG_ADDRESS
#defineNM_VPN_PLUGIN_IP4_CONFIG_PTP
#defineNM_VPN_PLUGIN_IP4_CONFIG_PREFIX
#defineNM_VPN_PLUGIN_IP4_CONFIG_DNS
#defineNM_VPN_PLUGIN_IP4_CONFIG_NBNS
#defineNM_VPN_PLUGIN_IP4_CONFIG_MSS
#defineNM_VPN_PLUGIN_IP4_CONFIG_DOMAIN
#defineNM_VPN_PLUGIN_IP4_CONFIG_DOMAINS
#defineNM_VPN_PLUGIN_IP4_CONFIG_ROUTES
#defineNM_VPN_PLUGIN_IP4_CONFIG_NEVER_DEFAULT
#defineNM_VPN_PLUGIN_IP4_CONFIG_GATEWAY
#defineNM_VPN_PLUGIN_IP4_CONFIG_BANNER
#defineNM_VPN_PLUGIN_IP4_CONFIG_EXT_GATEWAY
#defineNM_VPN_PLUGIN_IP4_CONFIG_MTU
#defineNM_VPN_PLUGIN_IP4_CONFIG_TUNDEV
#defineNM_VPN_PLUGIN_IP6_CONFIG_INT_GATEWAY
#defineNM_VPN_PLUGIN_IP6_CONFIG_ADDRESS
#defineNM_VPN_PLUGIN_IP6_CONFIG_PTP
#defineNM_VPN_PLUGIN_IP6_CONFIG_PREFIX
#defineNM_VPN_PLUGIN_IP6_CONFIG_DNS
#defineNM_VPN_PLUGIN_IP6_CONFIG_MSS
#defineNM_VPN_PLUGIN_IP6_CONFIG_DOMAIN
#defineNM_VPN_PLUGIN_IP6_CONFIG_DOMAINS
#defineNM_VPN_PLUGIN_IP6_CONFIG_ROUTES
#defineNM_VPN_PLUGIN_IP6_CONFIG_NEVER_DEFAULT

Object Hierarchy

-
-  GEnum
-   +----NMVpnServiceState
-
-
-  GEnum
-   +----NMVpnConnectionState
-
-
-  GEnum
-   +----NMVpnConnectionStateReason
-
-
-  GEnum
-   +----NMVpnPluginFailure
+
    GEnum
+    ├── NMVpnConnectionState
+    ├── NMVpnConnectionStateReason
+    ├── NMVpnPluginFailure
+    ╰── NMVpnServiceState
 
@@ -128,7 +306,10 @@ enum -

Details

+

Functions

+
+
+

Types and Values

NM_DBUS_PATH_VPN

#define NM_DBUS_PATH_VPN                  "/org/freedesktop/NetworkManager/VPN/Manager"
@@ -330,285 +511,303 @@ enum                
-

enum NMVpnServiceState

-
typedef enum {
-	NM_VPN_SERVICE_STATE_UNKNOWN = 0,
-	NM_VPN_SERVICE_STATE_INIT,
-	NM_VPN_SERVICE_STATE_SHUTDOWN,
-	NM_VPN_SERVICE_STATE_STARTING,
-	NM_VPN_SERVICE_STATE_STARTED,
-	NM_VPN_SERVICE_STATE_STOPPING,
-	NM_VPN_SERVICE_STATE_STOPPED
-} NMVpnServiceState;
-
-

-VPN daemon states -

-

-(Corresponds to the NM_VPN_SERVICE_STATE type in nm-vpn-connection.xml.) -

-
+

enum NMVpnServiceState

+

VPN daemon states

+

(Corresponds to the NM_VPN_SERVICE_STATE type in nm-vpn-connection.xml.)

+
+

Members

+
--+++ - - + + - - + + - - + + - - + + - - + + - - + + - - + +

NM_VPN_SERVICE_STATE_UNKNOWN

The state of the VPN plugin is unknown. +

NM_VPN_SERVICE_STATE_UNKNOWN

+

The state of the VPN plugin is unknown.

 

NM_VPN_SERVICE_STATE_INIT

The VPN plugin is initialized. +

NM_VPN_SERVICE_STATE_INIT

+

The VPN plugin is initialized.

 

NM_VPN_SERVICE_STATE_SHUTDOWN

Not used. +

NM_VPN_SERVICE_STATE_SHUTDOWN

+

Not used.

 

NM_VPN_SERVICE_STATE_STARTING

The plugin is attempting to connect to a VPN server. +

NM_VPN_SERVICE_STATE_STARTING

+

The plugin is attempting to connect to a VPN server.

 

NM_VPN_SERVICE_STATE_STARTED

The plugin has connected to a VPN server. +

NM_VPN_SERVICE_STATE_STARTED

+

The plugin has connected to a VPN server.

 

NM_VPN_SERVICE_STATE_STOPPING

The plugin is disconnecting from the VPN server. +

NM_VPN_SERVICE_STATE_STOPPING

+

The plugin is disconnecting from the VPN server.

 

NM_VPN_SERVICE_STATE_STOPPED

The plugin has disconnected from the VPN server. +

NM_VPN_SERVICE_STATE_STOPPED

+

The plugin has disconnected from the VPN server.

 
+

-

enum NMVpnConnectionState

-
typedef enum {
-	NM_VPN_CONNECTION_STATE_UNKNOWN = 0,
-	NM_VPN_CONNECTION_STATE_PREPARE,
-	NM_VPN_CONNECTION_STATE_NEED_AUTH,
-	NM_VPN_CONNECTION_STATE_CONNECT,
-	NM_VPN_CONNECTION_STATE_IP_CONFIG_GET,
-	NM_VPN_CONNECTION_STATE_ACTIVATED,
-	NM_VPN_CONNECTION_STATE_FAILED,
-	NM_VPN_CONNECTION_STATE_DISCONNECTED
-} NMVpnConnectionState;
-
-

-VPN connection states -

-

-(Corresponds to the NM_VPN_CONNECTION_STATE type in nm-vpn-connection.xml.) -

-
+

enum NMVpnConnectionState

+

VPN connection states

+

(Corresponds to the NM_VPN_CONNECTION_STATE type in nm-vpn-connection.xml.)

+
+

Members

+
--+++ - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + +

NM_VPN_CONNECTION_STATE_UNKNOWN

The state of the VPN connection is - unknown. +

NM_VPN_CONNECTION_STATE_UNKNOWN

+

The state of the VPN connection is + unknown.

 

NM_VPN_CONNECTION_STATE_PREPARE

The VPN connection is preparing to - connect. +

NM_VPN_CONNECTION_STATE_PREPARE

+

The VPN connection is preparing to + connect.

 

NM_VPN_CONNECTION_STATE_NEED_AUTH

The VPN connection needs authorization - credentials. +

NM_VPN_CONNECTION_STATE_NEED_AUTH

+

The VPN connection needs authorization + credentials.

 

NM_VPN_CONNECTION_STATE_CONNECT

The VPN connection is being established. +

NM_VPN_CONNECTION_STATE_CONNECT

+

The VPN connection is being established.

 

NM_VPN_CONNECTION_STATE_IP_CONFIG_GET

The VPN connection is getting an IP - address. +

NM_VPN_CONNECTION_STATE_IP_CONFIG_GET

+

The VPN connection is getting an IP + address.

 

NM_VPN_CONNECTION_STATE_ACTIVATED

The VPN connection is active. +

NM_VPN_CONNECTION_STATE_ACTIVATED

+

The VPN connection is active.

 

NM_VPN_CONNECTION_STATE_FAILED

The VPN connection failed. +

NM_VPN_CONNECTION_STATE_FAILED

+

The VPN connection failed.

 

NM_VPN_CONNECTION_STATE_DISCONNECTED

The VPN connection is disconnected. +

NM_VPN_CONNECTION_STATE_DISCONNECTED

+

The VPN connection is disconnected.

 
+

-

enum NMVpnConnectionStateReason

-
typedef enum {
-	NM_VPN_CONNECTION_STATE_REASON_UNKNOWN = 0,
-	NM_VPN_CONNECTION_STATE_REASON_NONE,
-	NM_VPN_CONNECTION_STATE_REASON_USER_DISCONNECTED,
-	NM_VPN_CONNECTION_STATE_REASON_DEVICE_DISCONNECTED,
-	NM_VPN_CONNECTION_STATE_REASON_SERVICE_STOPPED,
-	NM_VPN_CONNECTION_STATE_REASON_IP_CONFIG_INVALID,
-	NM_VPN_CONNECTION_STATE_REASON_CONNECT_TIMEOUT,
-	NM_VPN_CONNECTION_STATE_REASON_SERVICE_START_TIMEOUT,
-	NM_VPN_CONNECTION_STATE_REASON_SERVICE_START_FAILED,
-	NM_VPN_CONNECTION_STATE_REASON_NO_SECRETS,
-	NM_VPN_CONNECTION_STATE_REASON_LOGIN_FAILED,
-	NM_VPN_CONNECTION_STATE_REASON_CONNECTION_REMOVED
-} NMVpnConnectionStateReason;
-
-

-VPN connection state reasons -

-

-(Corresponds to the NM_VPN_CONNECTION_STATE_REASON type in nm-vpn-connection.xml.) -

-
+

enum NMVpnConnectionStateReason

+

VPN connection state reasons

+

(Corresponds to the NM_VPN_CONNECTION_STATE_REASON type in nm-vpn-connection.xml.)

+
+

Members

+
--+++ - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + +

NM_VPN_CONNECTION_STATE_REASON_UNKNOWN

The reason for the VPN connection - state change is unknown. +

NM_VPN_CONNECTION_STATE_REASON_UNKNOWN

+

The reason for the VPN connection + state change is unknown.

 

NM_VPN_CONNECTION_STATE_REASON_NONE

No reason was given for the VPN - connection state change. +

NM_VPN_CONNECTION_STATE_REASON_NONE

+

No reason was given for the VPN + connection state change.

 

NM_VPN_CONNECTION_STATE_REASON_USER_DISCONNECTED

The VPN connection changed - state because the user disconnected it. +

NM_VPN_CONNECTION_STATE_REASON_USER_DISCONNECTED

+

The VPN connection changed + state because the user disconnected it.

 

NM_VPN_CONNECTION_STATE_REASON_DEVICE_DISCONNECTED

The VPN connection - changed state because the device it was using was disconnected. +

NM_VPN_CONNECTION_STATE_REASON_DEVICE_DISCONNECTED

+

The VPN connection + changed state because the device it was using was disconnected.

 

NM_VPN_CONNECTION_STATE_REASON_SERVICE_STOPPED

The service providing the - VPN connection was stopped. +

NM_VPN_CONNECTION_STATE_REASON_SERVICE_STOPPED

+

The service providing the + VPN connection was stopped.

 

NM_VPN_CONNECTION_STATE_REASON_IP_CONFIG_INVALID

The IP config of the VPN - connection was invalid. +

NM_VPN_CONNECTION_STATE_REASON_IP_CONFIG_INVALID

+

The IP config of the VPN + connection was invalid.

 

NM_VPN_CONNECTION_STATE_REASON_CONNECT_TIMEOUT

The connection attempt to - the VPN service timed out. +

NM_VPN_CONNECTION_STATE_REASON_CONNECT_TIMEOUT

+

The connection attempt to + the VPN service timed out.

 

NM_VPN_CONNECTION_STATE_REASON_SERVICE_START_TIMEOUT

A timeout occurred - while starting the service providing the VPN connection. +

NM_VPN_CONNECTION_STATE_REASON_SERVICE_START_TIMEOUT

+

A timeout occurred + while starting the service providing the VPN connection.

 

NM_VPN_CONNECTION_STATE_REASON_SERVICE_START_FAILED

Starting the service - starting the service providing the VPN connection failed. +

NM_VPN_CONNECTION_STATE_REASON_SERVICE_START_FAILED

+

Starting the service + starting the service providing the VPN connection failed.

 

NM_VPN_CONNECTION_STATE_REASON_NO_SECRETS

Necessary secrets for the VPN - connection were not provided. +

NM_VPN_CONNECTION_STATE_REASON_NO_SECRETS

+

Necessary secrets for the VPN + connection were not provided.

 

NM_VPN_CONNECTION_STATE_REASON_LOGIN_FAILED

Authentication to the VPN - server failed. +

NM_VPN_CONNECTION_STATE_REASON_LOGIN_FAILED

+

Authentication to the VPN + server failed.

 

NM_VPN_CONNECTION_STATE_REASON_CONNECTION_REMOVED

The connection was - deleted from settings. +

NM_VPN_CONNECTION_STATE_REASON_CONNECTION_REMOVED

+

The connection was + deleted from settings.

 
+

-

enum NMVpnPluginFailure

-
typedef enum {
-	NM_VPN_PLUGIN_FAILURE_LOGIN_FAILED,
-	NM_VPN_PLUGIN_FAILURE_CONNECT_FAILED,
-	NM_VPN_PLUGIN_FAILURE_BAD_IP_CONFIG
-} NMVpnPluginFailure;
-
-

-VPN plugin failure reasons -

-

-(Corresponds to the NM_VPN_PLUGIN_FAILURE type in nm-vpn-plugin.xml.) -

-
+

enum NMVpnPluginFailure

+

VPN plugin failure reasons

+

(Corresponds to the NM_VPN_PLUGIN_FAILURE type in nm-vpn-plugin.xml.)

+
+

Members

+
--+++ - - + + - - + + - - + +

NM_VPN_PLUGIN_FAILURE_LOGIN_FAILED

Login failed. +

NM_VPN_PLUGIN_FAILURE_LOGIN_FAILED

+

Login failed.

 

NM_VPN_PLUGIN_FAILURE_CONNECT_FAILED

Connect failed. +

NM_VPN_PLUGIN_FAILURE_CONNECT_FAILED

+

Connect failed.

 

NM_VPN_PLUGIN_FAILURE_BAD_IP_CONFIG

Invalid IP configuration returned from - the VPN plugin. +

NM_VPN_PLUGIN_FAILURE_BAD_IP_CONFIG

+

Invalid IP configuration returned from + the VPN plugin.

 
+

NM_VPN_PLUGIN_CONFIG_TUNDEV

@@ -877,6 +1076,6 @@ VPN plugin failure reasons
+ Generated by GTK-Doc V1.21 \ No newline at end of file diff --git a/docs/libnm/html/libnm.devhelp2 b/docs/libnm/html/libnm.devhelp2 index d8530d82..58b5d8e4 100644 --- a/docs/libnm/html/libnm.devhelp2 +++ b/docs/libnm/html/libnm.devhelp2 @@ -71,13 +71,67 @@
- + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + @@ -102,145 +156,85 @@ - - - + + + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - - - - - - - - - - - - - - - - - - - + + + + + - - - - - - - - + + + + - - - - - - - - - - - + + + + - - + - - + - - + + + + + + + + + + + + @@ -281,109 +275,131 @@ - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + - - + + - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + + + + + @@ -403,48 +419,90 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + @@ -478,108 +536,46 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + @@ -593,35 +589,32 @@ - - - - - - - - - - - - - - - - - + + + + + + + + + + - - - - - - - + + + + + + + + + + + @@ -639,18 +632,15 @@ - - - - - - - - - - - - + + + + + + + + + @@ -659,54 +649,62 @@ - - - - - - - - - - - - - - - - - + + + + + + + + + + + - - - - - - - - - + + + + + + + + - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + + + + - + @@ -724,49 +722,33 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + - - - + + + + + + + + + + @@ -777,87 +759,104 @@ - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + @@ -871,54 +870,21 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + @@ -926,11 +892,9 @@ - - - - - + + + @@ -939,25 +903,38 @@ - - - - - - + + + + + + - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + @@ -977,160 +954,148 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + - - - - - - - - - - - + + + + + + + + + + - + - - - - - - - - - - - - - + + + + + + + - - - - - + + + - - - - - + + + + + + + + + + + + + - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + + + @@ -1143,42 +1108,40 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + @@ -1196,46 +1159,52 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - + @@ -1253,56 +1222,62 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + @@ -1326,182 +1301,130 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + + + - - - - + + + + - - - - - - - - + + + + + + - - - - - - - - + + + + + + - - - - - - - - + + + + + + + - - - - - - - - - - + + + + + - - - - - + + + + - - - - - - + + + + - - - - - - + + + + + - - - - - - - - + + + + + + - - - - - - - - + + + + + + + - - - - - - - - - - + + + + + + + + + + + + + + + @@ -1509,28 +1432,24 @@ - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + @@ -1539,27 +1458,31 @@ - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + + + @@ -1575,69 +1498,59 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + - - - - - - - + + + + + + + + + + + + + + + + + - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + @@ -1648,45 +1561,36 @@ - - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + - - - - - - - - - - - - - + + + + + + + + + + + + @@ -1695,87 +1599,77 @@ - - - - - - - - - - - - - - - - - - + + + + + + + + + + + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - - - - - - - - - - - - - - - @@ -1784,14 +1678,14 @@ - - - - + + + + @@ -1819,10 +1713,10 @@ - - - - + + + + @@ -1856,352 +1750,24 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + diff --git a/docs/libnm/html/object-tree.html b/docs/libnm/html/object-tree.html index 8013b082..514bd2b0 100644 --- a/docs/libnm/html/object-tree.html +++ b/docs/libnm/html/object-tree.html @@ -2,135 +2,138 @@ -Object Hierarchy +libnm Reference Manual: Object Hierarchy - + - + - - - - - - + + + + + +

Object Hierarchy

-    GObject
-        NMSetting
-            NMSetting8021x
-            NMSettingAdsl
-            NMSettingBluetooth
-            NMSettingBond
-            NMSettingBridgePort
-            NMSettingBridge
-            NMSettingCdma
-            NMSettingConnection
-            NMSettingDcb
-            NMSettingGeneric
-            NMSettingGsm
-            NMSettingInfiniband
-            NMSettingIPConfig
-                NMSettingIP4Config
-                NMSettingIP6Config
-            NMSettingOlpcMesh
-            NMSettingPpp
-            NMSettingPppoe
-            NMSettingSerial
-            NMSettingTeamPort
-            NMSettingTeam
-            NMSettingVlan
-            NMSettingVpn
-            NMSettingWimax
-            NMSettingWired
-            NMSettingWirelessSecurity
-            NMSettingWireless
-        NMObject
-            NMAccessPoint
-            NMActiveConnection
-                NMVpnConnection
-            NMDevice
-                NMDeviceAdsl
-                NMDeviceBond
-                NMDeviceBridge
-                NMDeviceBt
-                NMDeviceEthernet
-                NMDeviceGeneric
-                NMDeviceInfiniband
-                NMDeviceModem
-                NMDeviceOlpcMesh
-                NMDeviceTeam
-                NMDeviceVlan
-                NMDeviceWifi
-                NMDeviceWimax
-            NMDhcpConfig
-            NMIPConfig
-            NMRemoteConnection
-            NMWimaxNsp
-        NMClient
-        NMSecretAgentOld
-        NMSimpleConnection
-    GFlags
-        NM80211ApFlags
-        NM80211ApSecurityFlags
-        NMBluetoothCapabilities
-        NMConnectionSerializationFlags
-        NMDeviceCapabilities
-        NMDeviceModemCapabilities
-        NMDeviceWifiCapabilities
-        NMSecretAgentCapabilities
-        NMSecretAgentGetSecretsFlags
-        NMSettingDcbFlags
-        NMSettingSecretFlags
-        NMVlanFlags
-        NMVpnEditorPluginCapability
-    GEnum
-        NMAgentManagerError
-        NMConnectionError
-        NMDeviceError
-        NMManagerError
-        NMSecretAgentError
-        NMSettingsError
-        NMVpnPluginError
-        NM80211Mode
-        NMActiveConnectionState
-        NMClientError
-        NMClientPermission
-        NMClientPermissionResult
-        NMConnectivityState
-        NMCryptoError
-        NMDeviceState
-        NMDeviceStateReason
-        NMDeviceType
-        NMSetting8021xCKFormat
-        NMSetting8021xCKScheme
-        NMSettingCompareFlags
-        NMSettingDiffResult
-        NMSettingIP6ConfigPrivacy
-        NMSettingSerialParity
-        NMState
-        NMUtilsSecurityType
-        NMVlanPriorityMap
-        NMVpnConnectionState
-        NMVpnConnectionStateReason
-        NMVpnPluginFailure
-        NMVpnServiceState
-        NMWepKeyType
-        NMWimaxNspNetworkType
-    GBoxed
-        NMIPAddress
-        NMIPRoute
+    GObject
+    ├── NMSetting
+       ├── NMSetting8021x
+       ├── NMSettingAdsl
+       ├── NMSettingBluetooth
+       ├── NMSettingBond
+       ├── NMSettingBridgePort
+       ├── NMSettingBridge
+       ├── NMSettingCdma
+       ├── NMSettingConnection
+       ├── NMSettingDcb
+       ├── NMSettingGeneric
+       ├── NMSettingGsm
+       ├── NMSettingInfiniband
+       ├── NMSettingIPConfig
+          ├── NMSettingIP4Config
+          ╰── NMSettingIP6Config
+       ├── NMSettingOlpcMesh
+       ├── NMSettingPpp
+       ├── NMSettingPppoe
+       ├── NMSettingSerial
+       ├── NMSettingTeamPort
+       ├── NMSettingTeam
+       ├── NMSettingVlan
+       ├── NMSettingVpn
+       ├── NMSettingWimax
+       ├── NMSettingWired
+       ├── NMSettingWirelessSecurity
+       ╰── NMSettingWireless
+    ├── NMObject
+       ├── NMAccessPoint
+       ├── NMActiveConnection
+          ╰── NMVpnConnection
+       ├── NMDevice
+          ├── NMDeviceAdsl
+          ├── NMDeviceBond
+          ├── NMDeviceBridge
+          ├── NMDeviceBt
+          ├── NMDeviceEthernet
+          ├── NMDeviceGeneric
+          ├── NMDeviceInfiniband
+          ├── NMDeviceModem
+          ├── NMDeviceOlpcMesh
+          ├── NMDeviceTeam
+          ├── NMDeviceVlan
+          ├── NMDeviceWifi
+          ╰── NMDeviceWimax
+       ├── NMDhcpConfig
+       ├── NMIPConfig
+       ├── NMRemoteConnection
+       ╰── NMWimaxNsp
+    ├── NMClient
+    ├── NMSecretAgentOld
+    ╰── NMSimpleConnection
+    GInterface
+    ├── NMVpnEditor
+    ╰── NMVpnEditorPlugin
+    GFlags
+    ├── NM80211ApFlags
+    ├── NM80211ApSecurityFlags
+    ├── NMBluetoothCapabilities
+    ├── NMConnectionSerializationFlags
+    ├── NMDeviceCapabilities
+    ├── NMDeviceModemCapabilities
+    ├── NMDeviceWifiCapabilities
+    ├── NMSecretAgentCapabilities
+    ├── NMSecretAgentGetSecretsFlags
+    ├── NMSettingDcbFlags
+    ├── NMSettingSecretFlags
+    ├── NMVlanFlags
+    ╰── NMVpnEditorPluginCapability
+    GEnum
+    ├── NMAgentManagerError
+    ├── NMConnectionError
+    ├── NMDeviceError
+    ├── NMManagerError
+    ├── NMSecretAgentError
+    ├── NMSettingsError
+    ├── NMVpnPluginError
+    ├── NM80211Mode
+    ├── NMActiveConnectionState
+    ├── NMClientError
+    ├── NMClientPermission
+    ├── NMClientPermissionResult
+    ├── NMConnectivityState
+    ├── NMCryptoError
+    ├── NMDeviceState
+    ├── NMDeviceStateReason
+    ├── NMDeviceType
+    ├── NMSetting8021xCKFormat
+    ├── NMSetting8021xCKScheme
+    ├── NMSettingCompareFlags
+    ├── NMSettingDiffResult
+    ├── NMSettingIP6ConfigPrivacy
+    ├── NMSettingSerialParity
+    ├── NMState
+    ├── NMUtilsSecurityType
+    ├── NMVlanPriorityMap
+    ├── NMVpnConnectionState
+    ├── NMVpnConnectionStateReason
+    ├── NMVpnPluginFailure
+    ├── NMVpnServiceState
+    ├── NMWepKeyType
+    ╰── NMWimaxNspNetworkType
+    GBoxed
+    ├── NMIPAddress
+    ╰── NMIPRoute
 
+ Generated by GTK-Doc V1.21 \ No newline at end of file diff --git a/docs/libnm/html/ref-overview.html b/docs/libnm/html/ref-overview.html index febd374f..17883712 100644 --- a/docs/libnm/html/ref-overview.html +++ b/docs/libnm/html/ref-overview.html @@ -2,22 +2,22 @@ -Overview +libnm Reference Manual: Overview - + - - - - - - + + + + + +

@@ -43,6 +43,6 @@

+ Generated by GTK-Doc V1.21
\ No newline at end of file diff --git a/docs/libnm/html/right-insensitive.png b/docs/libnm/html/right-insensitive.png new file mode 100644 index 00000000..4c95785b Binary files /dev/null and b/docs/libnm/html/right-insensitive.png differ diff --git a/docs/libnm/html/right.png b/docs/libnm/html/right.png index 92832e3a..76260ec8 100644 Binary files a/docs/libnm/html/right.png and b/docs/libnm/html/right.png differ diff --git a/docs/libnm/html/style.css b/docs/libnm/html/style.css index d6f6c26e..c141ddd2 100644 --- a/docs/libnm/html/style.css +++ b/docs/libnm/html/style.css @@ -1,15 +1,23 @@ +body +{ + font-family: cantarell, sans-serif; +} .synopsis, .classsynopsis { /* tango:aluminium 1/2 */ background: #eeeeec; - border: solid 1px #d3d7cf; + background: rgba(238, 238, 236, 0.5); + border: solid 1px rgb(238, 238, 236); padding: 0.5em; } .programlisting { /* tango:sky blue 0/1 */ + /* fallback for no rgba support */ background: #e6f3ff; border: solid 1px #729fcf; + background: rgba(114, 159, 207, 0.1); + border: solid 1px rgba(114, 159, 207, 0.2); padding: 0.5em; } .variablelist @@ -22,89 +30,6 @@ vertical-align: top; } -@media screen { - sup a.footnote - { - position: relative; - top: 0em ! important; - - } - /* this is needed so that the local anchors are displayed below the naviagtion */ - div.footnote a[name], div.refnamediv a[name], div.refsect1 a[name], div.refsect2 a[name], div.index a[name], div.glossary a[name], div.sect1 a[name] - { - display: inline-block; - position: relative; - top:-5em; - } - /* this seems to be a bug in the xsl style sheets when generating indexes */ - div.index div.index - { - top: 0em; - } - /* make space for the fixed navigation bar and add space at the bottom so that - * link targets appear somewhat close to top - */ - body - { - padding-top: 3.2em; - padding-bottom: 20em; - } - /* style and size the navigation bar */ - table.navigation#top - { - position: fixed; - /* tango:scarlet red 0/1 */ - background: #ffe6e6; - border: solid 1px #ef2929; - margin-top: 0; - margin-bottom: 0; - top: 0; - left: 0; - height: 3em; - z-index: 10; - } - .navigation a, .navigation a:visited - { - /* tango:scarlet red 3 */ - color: #a40000; - } - .navigation a:hover - { - /* tango:scarlet red 1 */ - color: #ef2929; - } - td.shortcuts - { - /* tango:scarlet red 1 */ - color: #ef2929; - font-size: 80%; - white-space: nowrap; - } -} -@media print { - table.navigation { - visibility: collapse; - display: none; - } - div.titlepage table.navigation { - visibility: visible; - display: table; - /* tango:scarlet red 0/1 */ - background: #ffe6e6; - border: solid 1px #ef2929; - margin-top: 0; - margin-bottom: 0; - top: 0; - left: 0; - height: 3em; - } -} - -.navigation .title -{ - font-size: 200%; -} - div.gallery-float { float: left; @@ -132,6 +57,72 @@ a:hover color: #729fcf; } +div.informaltable table +{ + border-collapse: separate; + border-spacing: 1em 0.5em; + border: none; +} + +div.informaltable table td, div.informaltable table th +{ + vertical-align: top; +} + +.function_type, +.variable_type, +.property_type, +.signal_type, +.parameter_name, +.struct_member_name, +.union_member_name, +.define_keyword, +.datatype_keyword, +.typedef_keyword +{ + text-align: right; +} + +/* dim non-primary columns */ +.c_punctuation, +.function_type, +.variable_type, +.property_type, +.signal_type, +.define_keyword, +.datatype_keyword, +.typedef_keyword, +.property_flags, +.signal_flags, +.parameter_annotations, +.enum_member_annotations, +.struct_member_annotations, +.union_member_annotations +{ + color: #888a85; +} + +.function_type a, +.function_type a:visited, +.function_type a:hover, +.property_type a, +.property_type a:visited, +.property_type a:hover, +.signal_type a, +.signal_type a:visited, +.signal_type a:hover, +.signal_flags a, +.signal_flags a:visited, +.signal_flags a:hover +{ + color: #729fcf; +} + +td p +{ + margin: 0.25em; +} + div.table table { border-collapse: collapse; @@ -154,14 +145,43 @@ div.table table th background-color: #d3d7cf; } +h4 +{ + color: #555753; +} + hr { - /* tango:aluminium 3 */ - color: #babdb6; - background: #babdb6; + /* tango:aluminium 1 */ + color: #d3d7cf; + background: #d3d7cf; border: none 0px; height: 1px; clear: both; + margin: 2.0em 0em 2.0em 0em; +} + +dl.toc dt +{ + padding-bottom: 0.25em; +} + +dl.toc > dd > dl > dt +{ + padding-top: 0.25em; + padding-bottom: 0.25em; +} + +dl.toc > dt +{ + padding-top: 1em; + padding-bottom: 0.5em; + font-weight: bold; +} + +.parameter +{ + font-style: normal; } .footer @@ -173,31 +193,70 @@ hr font-size: 80%; } +.informalfigure, +.figure +{ + margin: 1em; +} + +.informalexample, +.example +{ + margin-top: 1em; + margin-bottom: 1em; +} + .warning { /* tango:orange 0/1 */ background: #ffeed9; + background: rgba(252, 175, 62, 0.1); border-color: #ffb04f; + border-color: rgba(252, 175, 62, 0.2); } .note { /* tango:chameleon 0/0.5 */ background: #d8ffb2; + background: rgba(138, 226, 52, 0.1); border-color: #abf562; + border-color: rgba(138, 226, 52, 0.2); } -.note, .warning +div.blockquote +{ + border-color: #eeeeec; +} +.note, .warning, div.blockquote { padding: 0.5em; border-width: 1px; border-style: solid; + margin: 2em; } -.note h3, .warning h3 +.note p, .warning p { - margin-top: 0.0em + margin: 0; } -.note p, .warning p + +div.warning h3.title, +div.note h3.title +{ + display: none; +} + +p + div.section { - margin-bottom: 0.0em + margin-top: 1em; +} + +div.refnamediv, +div.refsynopsisdiv, +div.refsect1, +div.refsect2, +div.toc, +div.section +{ + margin-bottom: 1em; } /* blob links */ @@ -210,33 +269,52 @@ h2 .extralinks, h3 .extralinks font-weight: normal; } +.lineart +{ + color: #d3d7cf; + font-weight: normal; +} + .annotation { /* tango:aluminium 5 */ color: #555753; - font-size: 80%; font-weight: normal; } +.structfield +{ + font-style: normal; + font-weight: normal; +} + +acronym,abbr +{ + border-bottom: 1px dotted gray; +} + /* code listings */ -.listing_code .programlisting .cbracket { color: #a40000; } /* tango: scarlet red 3 */ -.listing_code .programlisting .comment { color: #a1a39d; } /* tango: aluminium 4 */ -.listing_code .programlisting .function { color: #000000; font-weight: bold; } -.listing_code .programlisting .function a { color: #11326b; font-weight: bold; } /* tango: sky blue 4 */ -.listing_code .programlisting .keyword { color: #4e9a06; } /* tango: chameleon 3 */ +.listing_code .programlisting .normal, +.listing_code .programlisting .normal a, +.listing_code .programlisting .number, +.listing_code .programlisting .cbracket, +.listing_code .programlisting .symbol { color: #555753; } +.listing_code .programlisting .comment, .listing_code .programlisting .linenum { color: #babdb6; } /* tango: aluminium 3 */ -.listing_code .programlisting .normal { color: #000000; } -.listing_code .programlisting .number { color: #75507b; } /* tango: plum 2 */ +.listing_code .programlisting .function, +.listing_code .programlisting .function a, .listing_code .programlisting .preproc { color: #204a87; } /* tango: sky blue 3 */ -.listing_code .programlisting .string { color: #c17d11; } /* tango: chocolate 2 */ -.listing_code .programlisting .type { color: #000000; } -.listing_code .programlisting .type a { color: #11326b; } /* tango: sky blue 4 */ -.listing_code .programlisting .symbol { color: #ce5c00; } /* tango: orange 3 */ +.listing_code .programlisting .string { color: #ad7fa8; } /* tango: plum */ +.listing_code .programlisting .keyword, +.listing_code .programlisting .usertype, +.listing_code .programlisting .type, +.listing_code .programlisting .type a { color: #4e9a06; } /* tango: chameleon 3 */ .listing_frame { /* tango:sky blue 1 */ border: solid 1px #729fcf; + border: solid 1px rgba(114, 159, 207, 0.2); padding: 0px; } @@ -248,19 +326,151 @@ h2 .extralinks, h3 .extralinks .listing_lines { /* tango:sky blue 0.5 */ background: #a6c5e3; + background: rgba(114, 159, 207, 0.2); /* tango:aluminium 6 */ color: #2e3436; } .listing_code { /* tango:sky blue 0 */ background: #e6f3ff; + background: rgba(114, 159, 207, 0.1); } .listing_code .programlisting { /* override from previous */ border: none 0px; padding: 0px; + background: none; } .listing_lines pre, .listing_code pre { margin: 0px; } +@media screen { + sup a.footnote + { + position: relative; + top: 0em ! important; + } + /* this is needed so that the local anchors are displayed below the naviagtion */ + div.footnote a[name], div.refnamediv a[name], div.refsect1 a[name], div.refsect2 a[name], div.index a[name], div.glossary a[name], div.sect1 a[name] + { + display: inline-block; + position: relative; + top:-5em; + } + /* this seems to be a bug in the xsl style sheets when generating indexes */ + div.index div.index + { + top: 0em; + } + /* make space for the fixed navigation bar and add space at the bottom so that + * link targets appear somewhat close to top + */ + body + { + padding-top: 2.5em; + padding-bottom: 500px; + max-width: 60em; + } + p + { + max-width: 60em; + } + /* style and size the navigation bar */ + table.navigation#top + { + position: fixed; + background: #e2e2e2; + border-bottom: solid 1px #babdb6; + border-spacing: 5px; + margin-top: 0; + margin-bottom: 0; + top: 0; + left: 0; + z-index: 10; + } + table.navigation#top td + { + padding-left: 6px; + padding-right: 6px; + } + .navigation a, .navigation a:visited + { + /* tango:sky blue 3 */ + color: #204a87; + } + .navigation a:hover + { + /* tango:sky blue 2 */ + color: #3465a4; + } + td.shortcuts + { + /* tango:sky blue 2 */ + color: #3465a4; + font-size: 80%; + white-space: nowrap; + } + td.shortcuts .dim + { + color: #babdb6; + } + .navigation .title + { + font-size: 80%; + max-width: none; + margin: 0px; + font-weight: normal; + } +} +@media screen and (min-width: 60em) { + /* screen larger than 60em */ + body { margin: auto; } +} +@media screen and (max-width: 60em) { + /* screen less than 60em */ + #nav_hierarchy { display: none; } + #nav_interfaces { display: none; } + #nav_prerequisites { display: none; } + #nav_derived_interfaces { display: none; } + #nav_implementations { display: none; } + #nav_child_properties { display: none; } + #nav_style_properties { display: none; } + #nav_index { display: none; } + #nav_glossary { display: none; } + .gallery_image { display: none; } + .property_flags { display: none; } + .signal_flags { display: none; } + .parameter_annotations { display: none; } + .enum_member_annotations { display: none; } + .struct_member_annotations { display: none; } + .union_member_annotations { display: none; } + /* now that a column is hidden, optimize space */ + col.parameters_name { width: auto; } + col.parameters_description { width: auto; } + col.struct_members_name { width: auto; } + col.struct_members_description { width: auto; } + col.enum_members_name { width: auto; } + col.enum_members_description { width: auto; } + col.union_members_name { width: auto; } + col.union_members_description { width: auto; } + .listing_lines { display: none; } +} +@media print { + table.navigation { + visibility: collapse; + display: none; + } + div.titlepage table.navigation { + visibility: visible; + display: table; + background: #e2e2e2; + border: solid 1px #babdb6; + margin-top: 0; + margin-bottom: 0; + top: 0; + left: 0; + height: 3em; + } +} + diff --git a/docs/libnm/html/up-insensitive.png b/docs/libnm/html/up-insensitive.png new file mode 100644 index 00000000..f4049860 Binary files /dev/null and b/docs/libnm/html/up-insensitive.png differ diff --git a/docs/libnm/html/up.png b/docs/libnm/html/up.png index 85b3e2a2..80b4b37e 100644 Binary files a/docs/libnm/html/up.png and b/docs/libnm/html/up.png differ diff --git a/docs/libnm/libnm-sections.txt b/docs/libnm/libnm-sections.txt index 6c4eb981..947fea62 100644 --- a/docs/libnm/libnm-sections.txt +++ b/docs/libnm/libnm-sections.txt @@ -11,8 +11,6 @@ NM_ACCESS_POINT_MODE NM_ACCESS_POINT_MAX_BITRATE NM_ACCESS_POINT_STRENGTH NM_ACCESS_POINT_HW_ADDRESS -NMAccessPoint -NMAccessPointClass nm_access_point_get_flags nm_access_point_get_wpa_flags nm_access_point_get_rsn_flags @@ -25,6 +23,8 @@ nm_access_point_get_strength nm_access_point_filter_connections nm_access_point_connection_valid +NMAccessPoint +NMAccessPointClass NM_ACCESS_POINT NM_ACCESS_POINT_CLASS NM_ACCESS_POINT_GET_CLASS @@ -52,8 +52,6 @@ NM_ACTIVE_CONNECTION_IP6_CONFIG NM_ACTIVE_CONNECTION_DHCP6_CONFIG NM_ACTIVE_CONNECTION_VPN NM_ACTIVE_CONNECTION_MASTER -NMActiveConnection -NMActiveConnectionClass nm_active_connection_get_connection nm_active_connection_get_id nm_active_connection_get_uuid @@ -70,6 +68,8 @@ nm_active_connection_get_ip6_config nm_active_connection_get_dhcp6_config nm_active_connection_get_vpn +NMActiveConnection +NMActiveConnectionClass NM_ACTIVE_CONNECTION NM_ACTIVE_CONNECTION_CLASS NM_ACTIVE_CONNECTION_GET_CLASS @@ -111,8 +111,6 @@ NMClientPermissionResult NMClientError NM_CLIENT_ERROR nm_client_error_quark -NMClient -NMClientClass nm_client_new nm_client_new_async nm_client_new_finish @@ -167,6 +165,8 @@ nm_client_reload_connections nm_client_reload_connections_async nm_client_reload_connections_finish +NMClient +NMClientClass NM_CLIENT NM_CLIENT_CLASS NM_CLIENT_GET_CLASS @@ -418,8 +418,6 @@ NM_DEVICE_VENDOR NM_DEVICE_PRODUCT NM_DEVICE_PHYSICAL_PORT_ID NM_DEVICE_MTU -NMDevice -NMDeviceClass nm_device_get_iface nm_device_get_ip_iface nm_device_get_device_type @@ -460,6 +458,8 @@ nm_device_connection_valid nm_device_connection_compatible nm_device_get_setting_type +NMDevice +NMDeviceClass NM_DEVICE NM_DEVICE_CLASS NM_DEVICE_GET_CLASS @@ -473,10 +473,10 @@ nm_device_get_type nm-device-adsl NMDeviceAdsl NM_DEVICE_ADSL_CARRIER -NMDeviceAdsl -NMDeviceAdslClass nm_device_adsl_get_carrier +NMDeviceAdsl +NMDeviceAdslClass NM_DEVICE_ADSL NM_DEVICE_ADSL_CLASS NM_DEVICE_ADSL_GET_CLASS @@ -492,12 +492,12 @@ nm_device_adsl_get_type NM_DEVICE_BOND_HW_ADDRESS NM_DEVICE_BOND_CARRIER NM_DEVICE_BOND_SLAVES -NMDeviceBond -NMDeviceBondClass nm_device_bond_get_hw_address nm_device_bond_get_carrier nm_device_bond_get_slaves +NMDeviceBond +NMDeviceBondClass NM_DEVICE_BOND NM_DEVICE_BOND_CLASS NM_DEVICE_BOND_GET_CLASS @@ -513,12 +513,12 @@ nm_device_bond_get_type NM_DEVICE_BRIDGE_HW_ADDRESS NM_DEVICE_BRIDGE_CARRIER NM_DEVICE_BRIDGE_SLAVES -NMDeviceBridge -NMDeviceBridgeClass nm_device_bridge_get_hw_address nm_device_bridge_get_carrier nm_device_bridge_get_slaves +NMDeviceBridge +NMDeviceBridgeClass NM_DEVICE_BRIDGE NM_DEVICE_BRIDGE_CLASS NM_DEVICE_BRIDGE_GET_CLASS @@ -534,12 +534,12 @@ nm_device_bridge_get_type NM_DEVICE_BT_HW_ADDRESS NM_DEVICE_BT_NAME NM_DEVICE_BT_CAPABILITIES -NMDeviceBt -NMDeviceBtClass nm_device_bt_get_hw_address nm_device_bt_get_name nm_device_bt_get_capabilities +NMDeviceBt +NMDeviceBtClass NM_DEVICE_BT NM_DEVICE_BT_CLASS NM_DEVICE_BT_GET_CLASS @@ -556,13 +556,13 @@ NM_DEVICE_ETHERNET_HW_ADDRESS NM_DEVICE_ETHERNET_PERMANENT_HW_ADDRESS NM_DEVICE_ETHERNET_SPEED NM_DEVICE_ETHERNET_CARRIER -NMDeviceEthernet -NMDeviceEthernetClass nm_device_ethernet_get_hw_address nm_device_ethernet_get_permanent_hw_address nm_device_ethernet_get_speed nm_device_ethernet_get_carrier +NMDeviceEthernet +NMDeviceEthernetClass NM_DEVICE_ETHERNET NM_DEVICE_ETHERNET_CLASS NM_DEVICE_ETHERNET_GET_CLASS @@ -577,10 +577,10 @@ nm_device_ethernet_get_type NMDeviceGeneric NM_DEVICE_GENERIC_HW_ADDRESS NM_DEVICE_GENERIC_TYPE_DESCRIPTION -NMDeviceGeneric -NMDeviceGenericClass nm_device_generic_get_hw_address +NMDeviceGeneric +NMDeviceGenericClass NM_DEVICE_GENERIC NM_DEVICE_GENERIC_CLASS NM_DEVICE_GENERIC_GET_CLASS @@ -595,11 +595,11 @@ nm_device_generic_get_type NMDeviceInfiniband NM_DEVICE_INFINIBAND_HW_ADDRESS NM_DEVICE_INFINIBAND_CARRIER -NMDeviceInfiniband -NMDeviceInfinibandClass nm_device_infiniband_get_hw_address nm_device_infiniband_get_carrier +NMDeviceInfiniband +NMDeviceInfinibandClass NM_DEVICE_INFINIBAND NM_DEVICE_INFINIBAND_CLASS NM_DEVICE_INFINIBAND_GET_CLASS @@ -614,11 +614,11 @@ nm_device_infiniband_get_type NMDeviceModem NM_DEVICE_MODEM_MODEM_CAPABILITIES NM_DEVICE_MODEM_CURRENT_CAPABILITIES -NMDeviceModem -NMDeviceModemClass nm_device_modem_get_modem_capabilities nm_device_modem_get_current_capabilities +NMDeviceModem +NMDeviceModemClass NM_DEVICE_MODEM NM_DEVICE_MODEM_CLASS NM_DEVICE_MODEM_GET_CLASS @@ -634,12 +634,12 @@ nm_device_modem_get_type NM_DEVICE_OLPC_MESH_HW_ADDRESS NM_DEVICE_OLPC_MESH_COMPANION NM_DEVICE_OLPC_MESH_ACTIVE_CHANNEL -NMDeviceOlpcMesh -NMDeviceOlpcMeshClass nm_device_olpc_mesh_get_hw_address nm_device_olpc_mesh_get_companion nm_device_olpc_mesh_get_active_channel +NMDeviceOlpcMesh +NMDeviceOlpcMeshClass NM_DEVICE_OLPC_MESH NM_DEVICE_OLPC_MESH_CLASS NM_DEVICE_OLPC_MESH_GET_CLASS @@ -655,12 +655,12 @@ nm_device_olpc_mesh_get_type NM_DEVICE_TEAM_HW_ADDRESS NM_DEVICE_TEAM_CARRIER NM_DEVICE_TEAM_SLAVES -NMDeviceTeam -NMDeviceTeamClass nm_device_team_get_hw_address nm_device_team_get_carrier nm_device_team_get_slaves +NMDeviceTeam +NMDeviceTeamClass NM_DEVICE_TEAM NM_DEVICE_TEAM_CLASS NM_DEVICE_TEAM_GET_CLASS @@ -677,13 +677,13 @@ NM_DEVICE_VLAN_HW_ADDRESS NM_DEVICE_VLAN_CARRIER NM_DEVICE_VLAN_PARENT NM_DEVICE_VLAN_VLAN_ID -NMDeviceVlan -NMDeviceVlanClass nm_device_vlan_get_hw_address nm_device_vlan_get_carrier nm_device_vlan_get_parent nm_device_vlan_get_vlan_id +NMDeviceVlan +NMDeviceVlanClass NM_DEVICE_VLAN NM_DEVICE_VLAN_CLASS NM_DEVICE_VLAN_GET_CLASS @@ -703,8 +703,6 @@ NM_DEVICE_WIFI_BITRATE NM_DEVICE_WIFI_ACTIVE_ACCESS_POINT NM_DEVICE_WIFI_CAPABILITIES NM_DEVICE_WIFI_ACCESS_POINTS -NMDeviceWifi -NMDeviceWifiClass nm_device_wifi_get_hw_address nm_device_wifi_get_permanent_hw_address nm_device_wifi_get_mode @@ -717,6 +715,8 @@ nm_device_wifi_request_scan nm_device_wifi_request_scan_async nm_device_wifi_request_scan_finish +NMDeviceWifi +NMDeviceWifiClass NM_DEVICE_WIFI NM_DEVICE_WIFI_CLASS NM_DEVICE_WIFI_GET_CLASS @@ -737,8 +737,6 @@ NM_DEVICE_WIMAX_CINR NM_DEVICE_WIMAX_TX_POWER NM_DEVICE_WIMAX_BSID NM_DEVICE_WIMAX_NSPS -NMDeviceWimax -NMDeviceWimaxClass nm_device_wimax_get_hw_address nm_device_wimax_get_active_nsp nm_device_wimax_get_nsp_by_path @@ -749,6 +747,8 @@ nm_device_wimax_get_cinr nm_device_wimax_get_tx_power nm_device_wimax_get_bsid +NMDeviceWimax +NMDeviceWimaxClass NM_DEVICE_WIMAX NM_DEVICE_WIMAX_CLASS NM_DEVICE_WIMAX_GET_CLASS @@ -761,14 +761,14 @@ nm_device_wimax_get_type
nm-dhcp-config NMDhcpConfig -NMDhcpConfig -NMDhcpConfigClass NM_DHCP_CONFIG_FAMILY NM_DHCP_CONFIG_OPTIONS nm_dhcp_config_get_family nm_dhcp_config_get_options nm_dhcp_config_get_one_option +NMDhcpConfig +NMDhcpConfigClass NM_DHCP_CONFIG NM_DHCP_CONFIG_CLASS NM_IS_DHCP_CONFIG @@ -823,8 +823,6 @@ nm_vpn_plugin_error_quark
nm-ip-config NMIPConfig -NMIPConfig -NMIPConfigClass NM_IP_CONFIG_FAMILY NM_IP_CONFIG_GATEWAY NM_IP_CONFIG_ADDRESSES @@ -842,6 +840,8 @@ nm_ip_config_get_domains nm_ip_config_get_searches nm_ip_config_get_wins_servers +NMIPConfig +NMIPConfigClass NM_IP_CONFIG NM_IP_CONFIG_CLASS NM_IP_CONFIG_GET_CLASS @@ -856,10 +856,10 @@ nm_ip_config_get_type NMObject NM_OBJECT_PATH NM_OBJECT_DBUS_CONNECTION -NMObject -NMObjectClass nm_object_get_path +NMObject +NMObjectClass NM_IS_OBJECT NM_IS_OBJECT_CLASS NM_OBJECT @@ -876,8 +876,6 @@ NM_REMOTE_CONNECTION_DBUS_CONNECTION NM_REMOTE_CONNECTION_PATH NM_REMOTE_CONNECTION_UNSAVED NM_REMOTE_CONNECTION_VISIBLE -NMRemoteConnection -NMRemoteConnectionClass nm_remote_connection_commit_changes nm_remote_connection_commit_changes_async nm_remote_connection_commit_changes_finish @@ -893,6 +891,8 @@ nm_remote_connection_get_secrets_finish nm_remote_connection_get_unsaved nm_remote_connection_get_visible +NMRemoteConnection +NMRemoteConnectionClass NM_IS_REMOTE_CONNECTION NM_IS_REMOTE_CONNECTION_CLASS NM_REMOTE_CONNECTION @@ -909,11 +909,9 @@ NM_SECRET_AGENT_OLD_IDENTIFIER NM_SECRET_AGENT_OLD_AUTO_REGISTER NM_SECRET_AGENT_OLD_REGISTERED NM_SECRET_AGENT_OLD_CAPABILITIES -NMSecretAgentOld NMSecretAgentOldGetSecretsFunc NMSecretAgentOldSaveSecretsFunc NMSecretAgentOldDeleteSecretsFunc -NMSecretAgentOldClass nm_secret_agent_old_register nm_secret_agent_old_register_async nm_secret_agent_old_register_finish @@ -925,6 +923,8 @@ nm_secret_agent_old_get_secrets nm_secret_agent_old_save_secrets nm_secret_agent_old_delete_secrets +NMSecretAgentOld +NMSecretAgentOldClass NM_IS_SECRET_AGENT_OLD NM_IS_SECRET_AGENT_OLD_CLASS NM_SECRET_AGENT_OLD @@ -945,7 +945,6 @@ NMSettingSecretFlags NMSettingCompareFlags NMSetting NMSettingClearSecretsWithFlagsFn -NMSettingClass NMSettingValueIterFn nm_setting_lookup_type nm_setting_duplicate @@ -960,6 +959,7 @@ nm_setting_get_secret_flags nm_setting_set_secret_flags nm_setting_get_dbus_property_type +NMSettingClass NM_IS_SETTING NM_IS_SETTING_CLASS NM_SETTING @@ -1007,8 +1007,6 @@ NM_SETTING_802_1X_PHASE2_PRIVATE_KEY_PASSWORD_FLAGS NM_SETTING_802_1X_PIN NM_SETTING_802_1X_PIN_FLAGS NM_SETTING_802_1X_SYSTEM_CA_CERTS -NMSetting8021x -NMSetting8021xClass nm_setting_802_1x_new nm_setting_802_1x_get_num_eap_methods nm_setting_802_1x_get_eap_method @@ -1078,6 +1076,8 @@ nm_setting_802_1x_get_phase2_private_key_password nm_setting_802_1x_get_phase2_private_key_password_flags nm_setting_802_1x_get_phase2_private_key_format +NMSetting8021x +NMSetting8021xClass NM_IS_SETTING_802_1X NM_IS_SETTING_802_1X_CLASS NM_SETTING_802_1X @@ -1103,8 +1103,6 @@ NM_SETTING_ADSL_PROTOCOL_PPPOE NM_SETTING_ADSL_PROTOCOL_IPOATM NM_SETTING_ADSL_ENCAPSULATION_VCMUX NM_SETTING_ADSL_ENCAPSULATION_LLC -NMSettingAdsl -NMSettingAdslClass nm_setting_adsl_new nm_setting_adsl_get_username nm_setting_adsl_get_password @@ -1114,6 +1112,8 @@ nm_setting_adsl_get_vpi nm_setting_adsl_get_vci nm_setting_adsl_get_password_flags +NMSettingAdsl +NMSettingAdslClass NM_IS_SETTING_ADSL NM_IS_SETTING_ADSL_CLASS NM_SETTING_ADSL @@ -1131,12 +1131,12 @@ NM_SETTING_BLUETOOTH_BDADDR NM_SETTING_BLUETOOTH_TYPE NM_SETTING_BLUETOOTH_TYPE_DUN NM_SETTING_BLUETOOTH_TYPE_PANU -NMSettingBluetooth -NMSettingBluetoothClass nm_setting_bluetooth_new nm_setting_bluetooth_get_bdaddr nm_setting_bluetooth_get_connection_type +NMSettingBluetooth +NMSettingBluetoothClass NM_IS_SETTING_BLUETOOTH NM_IS_SETTING_BLUETOOTH_CLASS NM_SETTING_BLUETOOTH @@ -1166,8 +1166,6 @@ NM_SETTING_BOND_OPTION_AD_SELECT NM_SETTING_BOND_OPTION_XMIT_HASH_POLICY NM_SETTING_BOND_OPTION_RESEND_IGMP NM_SETTING_BOND_OPTION_LACP_RATE -NMSettingBond -NMSettingBondClass nm_setting_bond_new nm_setting_bond_get_num_options nm_setting_bond_get_option @@ -1178,6 +1176,8 @@ nm_setting_bond_validate_option nm_setting_bond_get_valid_options nm_setting_bond_get_option_default +NMSettingBond +NMSettingBondClass NM_IS_SETTING_BOND NM_IS_SETTING_BOND_CLASS NM_SETTING_BOND @@ -1198,8 +1198,6 @@ NM_SETTING_BRIDGE_FORWARD_DELAY NM_SETTING_BRIDGE_HELLO_TIME NM_SETTING_BRIDGE_MAX_AGE NM_SETTING_BRIDGE_AGEING_TIME -NMSettingBridge -NMSettingBridgeClass nm_setting_bridge_new nm_setting_bridge_get_mac_address nm_setting_bridge_get_stp @@ -1209,6 +1207,8 @@ nm_setting_bridge_get_hello_time nm_setting_bridge_get_max_age nm_setting_bridge_get_ageing_time +NMSettingBridge +NMSettingBridgeClass NM_IS_SETTING_BRIDGE NM_IS_SETTING_BRIDGE_CLASS NM_SETTING_BRIDGE @@ -1225,13 +1225,13 @@ NM_SETTING_BRIDGE_PORT_SETTING_NAME NM_SETTING_BRIDGE_PORT_PRIORITY NM_SETTING_BRIDGE_PORT_PATH_COST NM_SETTING_BRIDGE_PORT_HAIRPIN_MODE -NMSettingBridgePort -NMSettingBridgePortClass nm_setting_bridge_port_new nm_setting_bridge_port_get_priority nm_setting_bridge_port_get_path_cost nm_setting_bridge_port_get_hairpin_mode +NMSettingBridgePort +NMSettingBridgePortClass NM_IS_SETTING_BRIDGE_PORT NM_IS_SETTING_BRIDGE_PORT_CLASS NM_SETTING_BRIDGE_PORT @@ -1249,14 +1249,14 @@ NM_SETTING_CDMA_NUMBER NM_SETTING_CDMA_USERNAME NM_SETTING_CDMA_PASSWORD NM_SETTING_CDMA_PASSWORD_FLAGS -NMSettingCdma -NMSettingCdmaClass nm_setting_cdma_new nm_setting_cdma_get_number nm_setting_cdma_get_username nm_setting_cdma_get_password nm_setting_cdma_get_password_flags +NMSettingCdma +NMSettingCdmaClass NM_IS_SETTING_CDMA NM_IS_SETTING_CDMA_CLASS NM_SETTING_CDMA @@ -1288,7 +1288,6 @@ NM_SETTING_CONNECTION_SLAVE_TYPE NM_SETTING_CONNECTION_SECONDARIES NM_SETTING_CONNECTION_GATEWAY_PING_TIMEOUT NMSettingConnection -NMSettingConnectionClass nm_setting_connection_new nm_setting_connection_get_id nm_setting_connection_get_uuid @@ -1315,6 +1314,7 @@ nm_setting_connection_remove_secondary nm_setting_connection_remove_secondary_by_value nm_setting_connection_get_gateway_ping_timeout +NMSettingConnectionClass NM_IS_SETTING_CONNECTION NM_IS_SETTING_CONNECTION_CLASS NM_SETTING_CONNECTION @@ -1346,8 +1346,6 @@ NM_SETTING_DCB_PRIORITY_GROUP_BANDWIDTH NM_SETTING_DCB_PRIORITY_BANDWIDTH NM_SETTING_DCB_PRIORITY_STRICT_BANDWIDTH NM_SETTING_DCB_PRIORITY_TRAFFIC_CLASS -NMSettingDcb -NMSettingDcbClass nm_setting_dcb_new nm_setting_dcb_get_app_fcoe_flags nm_setting_dcb_get_app_fcoe_priority @@ -1371,6 +1369,8 @@ nm_setting_dcb_set_priority_strict_bandwidth nm_setting_dcb_get_priority_traffic_class nm_setting_dcb_set_priority_traffic_class +NMSettingDcb +NMSettingDcbClass NM_IS_SETTING_DCB NM_IS_SETTING_DCB_CLASS NM_SETTING_DCB @@ -1384,10 +1384,10 @@ nm_setting_dcb_get_type nm-setting-generic NMSettingGeneric NM_SETTING_GENERIC_SETTING_NAME -NMSettingGeneric -NMSettingGenericClass nm_setting_generic_new +NMSettingGeneric +NMSettingGenericClass NM_IS_SETTING_GENERIC NM_IS_SETTING_GENERIC_CLASS NM_SETTING_GENERIC @@ -1410,8 +1410,6 @@ NM_SETTING_GSM_NETWORK_ID NM_SETTING_GSM_PIN NM_SETTING_GSM_PIN_FLAGS NM_SETTING_GSM_HOME_ONLY -NMSettingGsm -NMSettingGsmClass nm_setting_gsm_new nm_setting_gsm_get_number nm_setting_gsm_get_username @@ -1423,6 +1421,8 @@ nm_setting_gsm_get_home_only nm_setting_gsm_get_pin_flags nm_setting_gsm_get_password_flags +NMSettingGsm +NMSettingGsmClass NM_IS_SETTING_GSM NM_IS_SETTING_GSM_CLASS NM_SETTING_GSM @@ -1441,8 +1441,6 @@ NM_SETTING_INFINIBAND_MTU NM_SETTING_INFINIBAND_TRANSPORT_MODE NM_SETTING_INFINIBAND_P_KEY NM_SETTING_INFINIBAND_PARENT -NMSettingInfiniband -NMSettingInfinibandClass nm_setting_infiniband_new nm_setting_infiniband_get_mac_address nm_setting_infiniband_get_mtu @@ -1451,6 +1449,8 @@ nm_setting_infiniband_get_p_key nm_setting_infiniband_get_parent nm_setting_infiniband_get_virtual_interface_name +NMSettingInfiniband +NMSettingInfinibandClass NM_IS_SETTING_INFINIBAND NM_IS_SETTING_INFINIBAND_CLASS NM_SETTING_INFINIBAND @@ -1463,7 +1463,6 @@ nm_setting_infiniband_get_type
nm-setting-ip-config NMSettingIPConfig -NMIPAddress nm_ip_address_new nm_ip_address_new_binary nm_ip_address_ref @@ -1480,7 +1479,6 @@ nm_ip_address_set_prefix nm_ip_address_get_attribute_names nm_ip_address_get_attribute nm_ip_address_set_attribute -NMIPRoute nm_ip_route_new nm_ip_route_new_binary nm_ip_route_ref @@ -1516,8 +1514,6 @@ NM_SETTING_IP_CONFIG_DHCP_HOSTNAME NM_SETTING_IP_CONFIG_DHCP_SEND_HOSTNAME NM_SETTING_IP_CONFIG_NEVER_DEFAULT NM_SETTING_IP_CONFIG_MAY_FAIL -NMSettingIPConfig -NMSettingIPConfigClass nm_setting_ip_config_get_method nm_setting_ip_config_get_num_dns nm_setting_ip_config_get_dns @@ -1552,6 +1548,10 @@ nm_setting_ip_config_get_dhcp_send_hostname nm_setting_ip_config_get_never_default nm_setting_ip_config_get_may_fail +NMIPAddress +NMIPRoute +NMSettingIPConfig +NMSettingIPConfigClass NM_IS_SETTING_IP_CONFIG NM_IS_SETTING_IP_CONFIG_CLASS NM_SETTING_IP_CONFIG @@ -1573,11 +1573,11 @@ NM_SETTING_IP4_CONFIG_METHOD_LINK_LOCAL NM_SETTING_IP4_CONFIG_METHOD_MANUAL NM_SETTING_IP4_CONFIG_METHOD_SHARED NM_SETTING_IP4_CONFIG_METHOD_DISABLED -NMSettingIP4Config -NMSettingIP4ConfigClass nm_setting_ip4_config_new nm_setting_ip4_config_get_dhcp_client_id +NMSettingIP4Config +NMSettingIP4ConfigClass NM_IS_SETTING_IP4_CONFIG NM_IS_SETTING_IP4_CONFIG_CLASS NM_SETTING_IP4_CONFIG @@ -1599,11 +1599,11 @@ NM_SETTING_IP6_CONFIG_METHOD_LINK_LOCAL NM_SETTING_IP6_CONFIG_METHOD_MANUAL NM_SETTING_IP6_CONFIG_METHOD_SHARED NMSettingIP6ConfigPrivacy -NMSettingIP6Config -NMSettingIP6ConfigClass nm_setting_ip6_config_new nm_setting_ip6_config_get_ip6_privacy +NMSettingIP6Config +NMSettingIP6ConfigClass NM_IS_SETTING_IP6_CONFIG NM_IS_SETTING_IP6_CONFIG_CLASS NM_SETTING_IP6_CONFIG @@ -1620,13 +1620,13 @@ NM_SETTING_OLPC_MESH_SETTING_NAME NM_SETTING_OLPC_MESH_SSID NM_SETTING_OLPC_MESH_CHANNEL NM_SETTING_OLPC_MESH_DHCP_ANYCAST_ADDRESS -NMSettingOlpcMesh -NMSettingOlpcMeshClass nm_setting_olpc_mesh_new nm_setting_olpc_mesh_get_ssid nm_setting_olpc_mesh_get_channel nm_setting_olpc_mesh_get_dhcp_anycast_address +NMSettingOlpcMesh +NMSettingOlpcMeshClass NM_IS_SETTING_OLPC_MESH NM_IS_SETTING_OLPC_MESH_CLASS NM_SETTING_OLPC_MESH @@ -1658,8 +1658,6 @@ NM_SETTING_PPP_MRU NM_SETTING_PPP_MTU NM_SETTING_PPP_LCP_ECHO_FAILURE NM_SETTING_PPP_LCP_ECHO_INTERVAL -NMSettingPpp -NMSettingPppClass nm_setting_ppp_new nm_setting_ppp_get_noauth nm_setting_ppp_get_refuse_eap @@ -1680,6 +1678,8 @@ nm_setting_ppp_get_mtu nm_setting_ppp_get_lcp_echo_failure nm_setting_ppp_get_lcp_echo_interval +NMSettingPpp +NMSettingPppClass NM_IS_SETTING_PPP NM_IS_SETTING_PPP_CLASS NM_SETTING_PPP @@ -1697,14 +1697,14 @@ NM_SETTING_PPPOE_SERVICE NM_SETTING_PPPOE_USERNAME NM_SETTING_PPPOE_PASSWORD NM_SETTING_PPPOE_PASSWORD_FLAGS -NMSettingPppoe -NMSettingPppoeClass nm_setting_pppoe_new nm_setting_pppoe_get_service nm_setting_pppoe_get_username nm_setting_pppoe_get_password nm_setting_pppoe_get_password_flags +NMSettingPppoe +NMSettingPppoeClass NM_IS_SETTING_PPPOE NM_IS_SETTING_PPPOE_CLASS NM_SETTING_PPPOE @@ -1724,8 +1724,6 @@ NM_SETTING_SERIAL_BITS NM_SETTING_SERIAL_PARITY NM_SETTING_SERIAL_STOPBITS NM_SETTING_SERIAL_SEND_DELAY -NMSettingSerial -NMSettingSerialClass nm_setting_serial_new nm_setting_serial_get_baud nm_setting_serial_get_bits @@ -1733,6 +1731,8 @@ nm_setting_serial_get_parity nm_setting_serial_get_stopbits nm_setting_serial_get_send_delay +NMSettingSerial +NMSettingSerialClass NM_IS_SETTING_SERIAL NM_IS_SETTING_SERIAL_CLASS NM_SETTING_SERIAL @@ -1747,11 +1747,11 @@ nm_setting_serial_get_type NMSettingTeam NM_SETTING_TEAM_SETTING_NAME NM_SETTING_TEAM_CONFIG -NMSettingTeam -NMSettingTeamClass nm_setting_team_new nm_setting_team_get_config +NMSettingTeam +NMSettingTeamClass NM_IS_SETTING_TEAM NM_IS_SETTING_TEAM_CLASS NM_SETTING_TEAM @@ -1766,11 +1766,11 @@ nm_setting_team_get_type NMSettingTeamPort NM_SETTING_TEAM_PORT_SETTING_NAME NM_SETTING_TEAM_PORT_CONFIG -NMSettingTeamPort -NMSettingTeamPortClass nm_setting_team_port_new nm_setting_team_port_get_config +NMSettingTeamPort +NMSettingTeamPortClass NM_IS_SETTING_TEAM_PORT NM_IS_SETTING_TEAM_PORT_CLASS NM_SETTING_TEAM_PORT @@ -1789,8 +1789,6 @@ NM_SETTING_VLAN_ID NM_SETTING_VLAN_FLAGS NM_SETTING_VLAN_INGRESS_PRIORITY_MAP NM_SETTING_VLAN_EGRESS_PRIORITY_MAP -NMSettingVlan -NMSettingVlanClass NMVlanPriorityMap NMVlanFlags nm_setting_vlan_new @@ -1806,6 +1804,8 @@ nm_setting_vlan_remove_priority_str_by_value nm_setting_vlan_clear_priorities nm_setting_vlan_add_priority_str +NMSettingVlan +NMSettingVlanClass NM_IS_SETTING_VLAN NM_IS_SETTING_VLAN_CLASS NM_SETTING_VLAN @@ -1824,8 +1824,6 @@ NM_SETTING_VPN_USER_NAME NM_SETTING_VPN_PERSISTENT NM_SETTING_VPN_DATA NM_SETTING_VPN_SECRETS -NMSettingVpn -NMSettingVpnClass NMVpnIterFunc nm_setting_vpn_new nm_setting_vpn_get_service_type @@ -1842,6 +1840,8 @@ nm_setting_vpn_get_secret nm_setting_vpn_remove_secret nm_setting_vpn_foreach_secret +NMSettingVpn +NMSettingVpnClass NM_IS_SETTING_VPN NM_IS_SETTING_VPN_CLASS NM_SETTING_VPN @@ -1857,12 +1857,12 @@ nm_setting_vpn_get_type NM_SETTING_WIMAX_SETTING_NAME NM_SETTING_WIMAX_NETWORK_NAME NM_SETTING_WIMAX_MAC_ADDRESS -NMSettingWimax -NMSettingWimaxClass nm_setting_wimax_new nm_setting_wimax_get_network_name nm_setting_wimax_get_mac_address +NMSettingWimax +NMSettingWimaxClass NM_IS_SETTING_WIMAX NM_IS_SETTING_WIMAX_CLASS NM_SETTING_WIMAX @@ -1887,8 +1887,6 @@ NM_SETTING_WIRED_MTU NM_SETTING_WIRED_S390_SUBCHANNELS NM_SETTING_WIRED_S390_NETTYPE NM_SETTING_WIRED_S390_OPTIONS -NMSettingWired -NMSettingWiredClass nm_setting_wired_new nm_setting_wired_get_port nm_setting_wired_get_speed @@ -1913,6 +1911,8 @@ nm_setting_wired_add_s390_option nm_setting_wired_remove_s390_option nm_setting_wired_get_valid_s390_options +NMSettingWired +NMSettingWiredClass NM_IS_SETTING_WIRED NM_IS_SETTING_WIRED_CLASS NM_SETTING_WIRED @@ -1942,8 +1942,6 @@ NM_SETTING_WIRELESS_HIDDEN NM_SETTING_WIRELESS_MODE_ADHOC NM_SETTING_WIRELESS_MODE_AP NM_SETTING_WIRELESS_MODE_INFRA -NMSettingWireless -NMSettingWirelessClass nm_setting_wireless_new nm_setting_wireless_get_ssid nm_setting_wireless_get_mode @@ -1968,6 +1966,8 @@ nm_setting_wireless_get_num_seen_bssids nm_setting_wireless_get_seen_bssid nm_setting_wireless_ap_security_compatible +NMSettingWireless +NMSettingWirelessClass NM_IS_SETTING_WIRELESS NM_IS_SETTING_WIRELESS_CLASS NM_SETTING_WIRELESS @@ -1999,8 +1999,6 @@ NM_SETTING_WIRELESS_SECURITY_PSK NM_SETTING_WIRELESS_SECURITY_PSK_FLAGS NM_SETTING_WIRELESS_SECURITY_LEAP_PASSWORD NM_SETTING_WIRELESS_SECURITY_LEAP_PASSWORD_FLAGS -NMSettingWirelessSecurity -NMSettingWirelessSecurityClass nm_setting_wireless_security_new nm_setting_wireless_security_get_key_mgmt nm_setting_wireless_security_get_num_protos @@ -2033,6 +2031,8 @@ nm_setting_wireless_security_get_auth_alg nm_setting_wireless_security_get_wep_key_flags nm_setting_wireless_security_get_wep_key_type +NMSettingWirelessSecurity +NMSettingWirelessSecurityClass NM_IS_SETTING_WIRELESS_SECURITY NM_IS_SETTING_WIRELESS_SECURITY_CLASS NM_SETTING_WIRELESS_SECURITY @@ -2045,12 +2045,12 @@ nm_setting_wireless_security_get_type
nm-simple-connection NMSimpleConnection -NMSimpleConnection -NMSimpleConnectionClass nm_simple_connection_new nm_simple_connection_new_from_dbus nm_simple_connection_new_clone +NMSimpleConnection +NMSimpleConnectionClass NM_IS_SIMPLE_CONNECTION NM_IS_SIMPLE_CONNECTION_CLASS NM_SIMPLE_CONNECTION @@ -2147,11 +2147,11 @@ NM_AVAILABLE_IN_1_0 NMVpnConnection NM_VPN_CONNECTION_VPN_STATE NM_VPN_CONNECTION_BANNER -NMVpnConnection -NMVpnConnectionClass nm_vpn_connection_get_vpn_state nm_vpn_connection_get_banner +NMVpnConnection +NMVpnConnectionClass NM_IS_VPN_CONNECTION NM_IS_VPN_CONNECTION_CLASS NM_TYPE_VPN_CONNECTION @@ -2230,7 +2230,6 @@ NM_VPN_PLUGIN_IP6_CONFIG_NEVER_DEFAULT
nm-vpn-editor-plugin NMVpnEditor -NMVpnEditorPlugin NMVpnEditorPluginFactory nm_vpn_editor_plugin_factory NMVpnEditorPluginCapability @@ -2247,6 +2246,8 @@ NMVpnEditorInterface nm_vpn_editor_get_widget nm_vpn_editor_update_connection +NMVpnEditor +NMVpnEditorPlugin NM_IS_VPN_EDITOR NM_IS_VPN_EDITOR_PLUGIN NM_TYPE_VPN_EDITOR @@ -2266,14 +2267,14 @@ NM_WIMAX_NSP_NAME NM_WIMAX_NSP_SIGNAL_QUALITY NM_WIMAX_NSP_NETWORK_TYPE NMWimaxNspNetworkType -NMWimaxNsp -NMWimaxNspClass nm_wimax_nsp_get_name nm_wimax_nsp_get_signal_quality nm_wimax_nsp_get_network_type nm_wimax_nsp_filter_connections nm_wimax_nsp_connection_valid +NMWimaxNsp +NMWimaxNspClass NM_IS_WIMAX_NSP NM_IS_WIMAX_NSP_CLASS NM_TYPE_WIMAX_NSP diff --git a/docs/libnm/tmpl/nm-access-point.sgml b/docs/libnm/tmpl/nm-access-point.sgml index 8673d766..8a5cd28c 100644 --- a/docs/libnm/tmpl/nm-access-point.sgml +++ b/docs/libnm/tmpl/nm-access-point.sgml @@ -92,69 +92,6 @@ NMAccessPoint - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -@parent: - diff --git a/docs/libnm/tmpl/nm-active-connection.sgml b/docs/libnm/tmpl/nm-active-connection.sgml index 0fe4bb39..77f7be1a 100644 --- a/docs/libnm/tmpl/nm-active-connection.sgml +++ b/docs/libnm/tmpl/nm-active-connection.sgml @@ -127,94 +127,6 @@ NMActiveConnection - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -@parent: - diff --git a/docs/libnm/tmpl/nm-client.sgml b/docs/libnm/tmpl/nm-client.sgml index 32d4edef..123aba73 100644 --- a/docs/libnm/tmpl/nm-client.sgml +++ b/docs/libnm/tmpl/nm-client.sgml @@ -244,160 +244,6 @@ NMClient @Returns: - - - - - - - - - - - -@nmclient: the object which received the signal. -@arg1: - - - - - - -@nmclient: the object which received the signal. -@arg1: - - - - - - -@nmclient: the object which received the signal. -@arg1: - - - - - - -@nmclient: the object which received the signal. -@arg1: - - - - - - -@nmclient: the object which received the signal. -@arg1: -@arg2: - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -@parent: -@device_added: -@device_removed: -@permission_changed: -@connection_added: -@connection_removed: - diff --git a/docs/libnm/tmpl/nm-dbus-interface.sgml b/docs/libnm/tmpl/nm-dbus-interface.sgml index 287ab8c7..127f117d 100644 --- a/docs/libnm/tmpl/nm-dbus-interface.sgml +++ b/docs/libnm/tmpl/nm-dbus-interface.sgml @@ -373,6 +373,9 @@ nm-dbus-interface @NM_WIFI_DEVICE_CAP_RSN: @NM_WIFI_DEVICE_CAP_AP: @NM_WIFI_DEVICE_CAP_ADHOC: +@NM_WIFI_DEVICE_CAP_FREQ_VALID: +@NM_WIFI_DEVICE_CAP_FREQ_2GHZ: +@NM_WIFI_DEVICE_CAP_FREQ_5GHZ: @@ -513,6 +516,7 @@ nm-dbus-interface @NM_DEVICE_STATE_REASON_MODEM_FAILED: @NM_DEVICE_STATE_REASON_MODEM_AVAILABLE: @NM_DEVICE_STATE_REASON_SIM_PIN_INCORRECT: +@NM_DEVICE_STATE_REASON_NEW_ACTIVATION: diff --git a/docs/libnm/tmpl/nm-device-adsl.sgml b/docs/libnm/tmpl/nm-device-adsl.sgml index 406c572c..a6ef7224 100644 --- a/docs/libnm/tmpl/nm-device-adsl.sgml +++ b/docs/libnm/tmpl/nm-device-adsl.sgml @@ -29,24 +29,6 @@ NMDeviceAdsl - - - - - - - - - - - - - - - - -@parent: - diff --git a/docs/libnm/tmpl/nm-device-bond.sgml b/docs/libnm/tmpl/nm-device-bond.sgml index b444ff3d..8feb3de6 100644 --- a/docs/libnm/tmpl/nm-device-bond.sgml +++ b/docs/libnm/tmpl/nm-device-bond.sgml @@ -43,34 +43,6 @@ NMDeviceBond - - - - - - - - - - - - - - - - - - - - - - - - - - -@parent: - diff --git a/docs/libnm/tmpl/nm-device-bridge.sgml b/docs/libnm/tmpl/nm-device-bridge.sgml index 4a0e1595..675fdb64 100644 --- a/docs/libnm/tmpl/nm-device-bridge.sgml +++ b/docs/libnm/tmpl/nm-device-bridge.sgml @@ -43,34 +43,6 @@ NMDeviceBridge - - - - - - - - - - - - - - - - - - - - - - - - - - -@parent: - diff --git a/docs/libnm/tmpl/nm-device-bt.sgml b/docs/libnm/tmpl/nm-device-bt.sgml index 5765f666..ff536c37 100644 --- a/docs/libnm/tmpl/nm-device-bt.sgml +++ b/docs/libnm/tmpl/nm-device-bt.sgml @@ -43,34 +43,6 @@ NMDeviceBt - - - - - - - - - - - - - - - - - - - - - - - - - - -@parent: - diff --git a/docs/libnm/tmpl/nm-device-ethernet.sgml b/docs/libnm/tmpl/nm-device-ethernet.sgml index 6a004bf0..9bb88cb3 100644 --- a/docs/libnm/tmpl/nm-device-ethernet.sgml +++ b/docs/libnm/tmpl/nm-device-ethernet.sgml @@ -50,39 +50,6 @@ NMDeviceEthernet - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -@parent: - diff --git a/docs/libnm/tmpl/nm-device-generic.sgml b/docs/libnm/tmpl/nm-device-generic.sgml index c93ed4cc..94f52f55 100644 --- a/docs/libnm/tmpl/nm-device-generic.sgml +++ b/docs/libnm/tmpl/nm-device-generic.sgml @@ -36,29 +36,6 @@ NMDeviceGeneric - - - - - - - - - - - - - - - - - - - - - -@parent: - diff --git a/docs/libnm/tmpl/nm-device-infiniband.sgml b/docs/libnm/tmpl/nm-device-infiniband.sgml index 626c0e3d..bc6e35af 100644 --- a/docs/libnm/tmpl/nm-device-infiniband.sgml +++ b/docs/libnm/tmpl/nm-device-infiniband.sgml @@ -36,29 +36,6 @@ NMDeviceInfiniband - - - - - - - - - - - - - - - - - - - - - -@parent: - diff --git a/docs/libnm/tmpl/nm-device-modem.sgml b/docs/libnm/tmpl/nm-device-modem.sgml index c582ddbd..042959ce 100644 --- a/docs/libnm/tmpl/nm-device-modem.sgml +++ b/docs/libnm/tmpl/nm-device-modem.sgml @@ -36,29 +36,6 @@ NMDeviceModem - - - - - - - - - - - - - - - - - - - - - -@parent: - diff --git a/docs/libnm/tmpl/nm-device-olpc-mesh.sgml b/docs/libnm/tmpl/nm-device-olpc-mesh.sgml index bcc857ae..8047c8f8 100644 --- a/docs/libnm/tmpl/nm-device-olpc-mesh.sgml +++ b/docs/libnm/tmpl/nm-device-olpc-mesh.sgml @@ -43,34 +43,6 @@ NMDeviceOlpcMesh - - - - - - - - - - - - - - - - - - - - - - - - - - -@parent: - diff --git a/docs/libnm/tmpl/nm-device-team.sgml b/docs/libnm/tmpl/nm-device-team.sgml index de047234..dd23f451 100644 --- a/docs/libnm/tmpl/nm-device-team.sgml +++ b/docs/libnm/tmpl/nm-device-team.sgml @@ -43,34 +43,6 @@ NMDeviceTeam - - - - - - - - - - - - - - - - - - - - - - - - - - -@parent: - diff --git a/docs/libnm/tmpl/nm-device-vlan.sgml b/docs/libnm/tmpl/nm-device-vlan.sgml index 8607d3e0..44f7d730 100644 --- a/docs/libnm/tmpl/nm-device-vlan.sgml +++ b/docs/libnm/tmpl/nm-device-vlan.sgml @@ -50,39 +50,6 @@ NMDeviceVlan - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -@parent: - diff --git a/docs/libnm/tmpl/nm-device-wifi.sgml b/docs/libnm/tmpl/nm-device-wifi.sgml index d1947631..57891ab3 100644 --- a/docs/libnm/tmpl/nm-device-wifi.sgml +++ b/docs/libnm/tmpl/nm-device-wifi.sgml @@ -71,72 +71,6 @@ NMDeviceWifi - - - - - - - - - - - -@nmdevicewifi: the object which received the signal. -@arg1: - - - - - - -@nmdevicewifi: the object which received the signal. -@arg1: - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -@parent: -@access_point_added: -@access_point_removed: - diff --git a/docs/libnm/tmpl/nm-device-wimax.sgml b/docs/libnm/tmpl/nm-device-wimax.sgml index fcbac1e5..71a3a039 100644 --- a/docs/libnm/tmpl/nm-device-wimax.sgml +++ b/docs/libnm/tmpl/nm-device-wimax.sgml @@ -78,77 +78,6 @@ NMDeviceWimax - - - - - - - - - - - -@nmdevicewimax: the object which received the signal. -@arg1: - - - - - - -@nmdevicewimax: the object which received the signal. -@arg1: - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -@parent: -@nsp_added: -@nsp_removed: - diff --git a/docs/libnm/tmpl/nm-device.sgml b/docs/libnm/tmpl/nm-device.sgml index 5bd99db5..9abbd944 100644 --- a/docs/libnm/tmpl/nm-device.sgml +++ b/docs/libnm/tmpl/nm-device.sgml @@ -183,149 +183,6 @@ NMDevice - - - - - - - - - - - -@nmdevice: the object which received the signal. -@arg1: -@arg2: -@arg3: - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -@parent: -@state_changed: -@connection_compatible: -@get_type_description: -@get_hw_address: -@get_setting_type: - diff --git a/docs/libnm/tmpl/nm-dhcp-config.sgml b/docs/libnm/tmpl/nm-dhcp-config.sgml index 6d5af6f0..9e5bb72a 100644 --- a/docs/libnm/tmpl/nm-dhcp-config.sgml +++ b/docs/libnm/tmpl/nm-dhcp-config.sgml @@ -22,29 +22,6 @@ NMDhcpConfig - - - - - - - - - - - - - - - - - - - - - -@parent: - diff --git a/docs/libnm/tmpl/nm-ip-config.sgml b/docs/libnm/tmpl/nm-ip-config.sgml index bc3ff563..2784a9b6 100644 --- a/docs/libnm/tmpl/nm-ip-config.sgml +++ b/docs/libnm/tmpl/nm-ip-config.sgml @@ -22,59 +22,6 @@ NMIPConfig - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -@parent: - diff --git a/docs/libnm/tmpl/nm-object.sgml b/docs/libnm/tmpl/nm-object.sgml index 53ed0566..98025f3d 100644 --- a/docs/libnm/tmpl/nm-object.sgml +++ b/docs/libnm/tmpl/nm-object.sgml @@ -36,36 +36,6 @@ NMObject - - - - - - - - - - - - - - - - - - - - - - - - - - -@parent: -@init_dbus: -@object_creation_failed: - diff --git a/docs/libnm/tmpl/nm-remote-connection.sgml b/docs/libnm/tmpl/nm-remote-connection.sgml index f51af61e..fb74dcc5 100644 --- a/docs/libnm/tmpl/nm-remote-connection.sgml +++ b/docs/libnm/tmpl/nm-remote-connection.sgml @@ -50,29 +50,6 @@ NMRemoteConnection - - - - - - - - - - - - - - - - - - - - - -@parent_class: - diff --git a/docs/libnm/tmpl/nm-secret-agent-old.sgml b/docs/libnm/tmpl/nm-secret-agent-old.sgml index 86953508..1e147551 100644 --- a/docs/libnm/tmpl/nm-secret-agent-old.sgml +++ b/docs/libnm/tmpl/nm-secret-agent-old.sgml @@ -50,32 +50,6 @@ NMSecretAgentOld - - - - - - - - - - - - - - - - - - - - - - - - - - @@ -110,17 +84,6 @@ NMSecretAgentOld @user_data: - - - - - -@parent: -@get_secrets: -@cancel_get_secrets: -@save_secrets: -@delete_secrets: - diff --git a/docs/libnm/tmpl/nm-setting-8021x.sgml b/docs/libnm/tmpl/nm-setting-8021x.sgml index b77deec6..f61f0874 100644 --- a/docs/libnm/tmpl/nm-setting-8021x.sgml +++ b/docs/libnm/tmpl/nm-setting-8021x.sgml @@ -272,179 +272,6 @@ NMSetting8021x - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -@parent: - diff --git a/docs/libnm/tmpl/nm-setting-adsl.sgml b/docs/libnm/tmpl/nm-setting-adsl.sgml index cac35e4d..8895e119 100644 --- a/docs/libnm/tmpl/nm-setting-adsl.sgml +++ b/docs/libnm/tmpl/nm-setting-adsl.sgml @@ -113,54 +113,6 @@ NMSettingAdsl - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -@parent: - diff --git a/docs/libnm/tmpl/nm-setting-bluetooth.sgml b/docs/libnm/tmpl/nm-setting-bluetooth.sgml index e4dc1397..6d1f1468 100644 --- a/docs/libnm/tmpl/nm-setting-bluetooth.sgml +++ b/docs/libnm/tmpl/nm-setting-bluetooth.sgml @@ -57,29 +57,6 @@ NMSettingBluetooth - - - - - - - - - - - - - - - - - - - - - -@parent: - diff --git a/docs/libnm/tmpl/nm-setting-bond.sgml b/docs/libnm/tmpl/nm-setting-bond.sgml index bbf1e8b0..25b94199 100644 --- a/docs/libnm/tmpl/nm-setting-bond.sgml +++ b/docs/libnm/tmpl/nm-setting-bond.sgml @@ -141,24 +141,6 @@ NMSettingBond - - - - - - - - - - - - - - - - -@parent: - diff --git a/docs/libnm/tmpl/nm-setting-bridge-port.sgml b/docs/libnm/tmpl/nm-setting-bridge-port.sgml index 4588abee..7fec001b 100644 --- a/docs/libnm/tmpl/nm-setting-bridge-port.sgml +++ b/docs/libnm/tmpl/nm-setting-bridge-port.sgml @@ -50,34 +50,6 @@ NMSettingBridgePort - - - - - - - - - - - - - - - - - - - - - - - - - - -@parent: - diff --git a/docs/libnm/tmpl/nm-setting-bridge.sgml b/docs/libnm/tmpl/nm-setting-bridge.sgml index 47629732..216c370a 100644 --- a/docs/libnm/tmpl/nm-setting-bridge.sgml +++ b/docs/libnm/tmpl/nm-setting-bridge.sgml @@ -78,54 +78,6 @@ NMSettingBridge - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -@parent: - diff --git a/docs/libnm/tmpl/nm-setting-cdma.sgml b/docs/libnm/tmpl/nm-setting-cdma.sgml index cd497fe1..2f02d707 100644 --- a/docs/libnm/tmpl/nm-setting-cdma.sgml +++ b/docs/libnm/tmpl/nm-setting-cdma.sgml @@ -57,39 +57,6 @@ NMSettingCdma - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -@parent: - diff --git a/docs/libnm/tmpl/nm-setting-connection.sgml b/docs/libnm/tmpl/nm-setting-connection.sgml index f4dbe24f..b8bb9b51 100644 --- a/docs/libnm/tmpl/nm-setting-connection.sgml +++ b/docs/libnm/tmpl/nm-setting-connection.sgml @@ -224,13 +224,6 @@ NMSettingConnection - - - - - -@parent: - diff --git a/docs/libnm/tmpl/nm-setting-dcb.sgml b/docs/libnm/tmpl/nm-setting-dcb.sgml index 38a875ce..be50bafa 100644 --- a/docs/libnm/tmpl/nm-setting-dcb.sgml +++ b/docs/libnm/tmpl/nm-setting-dcb.sgml @@ -158,94 +158,6 @@ NMSettingDcb - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -@parent: - diff --git a/docs/libnm/tmpl/nm-setting-generic.sgml b/docs/libnm/tmpl/nm-setting-generic.sgml index bb6d1902..339f99b5 100644 --- a/docs/libnm/tmpl/nm-setting-generic.sgml +++ b/docs/libnm/tmpl/nm-setting-generic.sgml @@ -29,19 +29,6 @@ NMSettingGeneric - - - - - - - - - - - -@parent: - diff --git a/docs/libnm/tmpl/nm-setting-gsm.sgml b/docs/libnm/tmpl/nm-setting-gsm.sgml index 1bc4a620..dd801247 100644 --- a/docs/libnm/tmpl/nm-setting-gsm.sgml +++ b/docs/libnm/tmpl/nm-setting-gsm.sgml @@ -92,64 +92,6 @@ NMSettingGsm - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -@parent: - diff --git a/docs/libnm/tmpl/nm-setting-infiniband.sgml b/docs/libnm/tmpl/nm-setting-infiniband.sgml index 41588b37..b6f86e3a 100644 --- a/docs/libnm/tmpl/nm-setting-infiniband.sgml +++ b/docs/libnm/tmpl/nm-setting-infiniband.sgml @@ -64,44 +64,6 @@ NMSettingInfiniband - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -@parent: - diff --git a/docs/libnm/tmpl/nm-setting-ip-config.sgml b/docs/libnm/tmpl/nm-setting-ip-config.sgml index 00a233ce..f7ae0e4a 100644 --- a/docs/libnm/tmpl/nm-setting-ip-config.sgml +++ b/docs/libnm/tmpl/nm-setting-ip-config.sgml @@ -22,12 +22,6 @@ NMSettingIPConfig - - - - - - @@ -179,12 +173,6 @@ NMSettingIPConfig @value: - - - - - - @@ -486,85 +474,6 @@ NMSettingIPConfig - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -@parent: -@padding: - diff --git a/docs/libnm/tmpl/nm-setting-ip4-config.sgml b/docs/libnm/tmpl/nm-setting-ip4-config.sgml index 3d1b3caa..4eabe034 100644 --- a/docs/libnm/tmpl/nm-setting-ip4-config.sgml +++ b/docs/libnm/tmpl/nm-setting-ip4-config.sgml @@ -71,24 +71,6 @@ NMSettingIP4Config - - - - - - - - - - - - - - - - -@parent: - diff --git a/docs/libnm/tmpl/nm-setting-ip6-config.sgml b/docs/libnm/tmpl/nm-setting-ip6-config.sgml index 82184963..3ba20ae0 100644 --- a/docs/libnm/tmpl/nm-setting-ip6-config.sgml +++ b/docs/libnm/tmpl/nm-setting-ip6-config.sgml @@ -88,24 +88,6 @@ NMSettingIP6Config @NM_SETTING_IP6_CONFIG_PRIVACY_PREFER_PUBLIC_ADDR: @NM_SETTING_IP6_CONFIG_PRIVACY_PREFER_TEMP_ADDR: - - - - - - - - - - - - - - - - -@parent: - diff --git a/docs/libnm/tmpl/nm-setting-olpc-mesh.sgml b/docs/libnm/tmpl/nm-setting-olpc-mesh.sgml index dfcc9e08..ec682d73 100644 --- a/docs/libnm/tmpl/nm-setting-olpc-mesh.sgml +++ b/docs/libnm/tmpl/nm-setting-olpc-mesh.sgml @@ -50,34 +50,6 @@ NMSettingOlpcMesh - - - - - - - - - - - - - - - - - - - - - - - - - - -@parent: - diff --git a/docs/libnm/tmpl/nm-setting-ppp.sgml b/docs/libnm/tmpl/nm-setting-ppp.sgml index 8ae7fa2b..d974da0f 100644 --- a/docs/libnm/tmpl/nm-setting-ppp.sgml +++ b/docs/libnm/tmpl/nm-setting-ppp.sgml @@ -155,109 +155,6 @@ NMSettingPpp - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -@parent: - diff --git a/docs/libnm/tmpl/nm-setting-pppoe.sgml b/docs/libnm/tmpl/nm-setting-pppoe.sgml index 932c4990..32d9e725 100644 --- a/docs/libnm/tmpl/nm-setting-pppoe.sgml +++ b/docs/libnm/tmpl/nm-setting-pppoe.sgml @@ -57,39 +57,6 @@ NMSettingPppoe - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -@parent: - diff --git a/docs/libnm/tmpl/nm-setting-serial.sgml b/docs/libnm/tmpl/nm-setting-serial.sgml index 2db0e5ce..d713db5c 100644 --- a/docs/libnm/tmpl/nm-setting-serial.sgml +++ b/docs/libnm/tmpl/nm-setting-serial.sgml @@ -73,44 +73,6 @@ NMSettingSerial - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -@parent: - diff --git a/docs/libnm/tmpl/nm-setting-team-port.sgml b/docs/libnm/tmpl/nm-setting-team-port.sgml index a8bb595b..809e1878 100644 --- a/docs/libnm/tmpl/nm-setting-team-port.sgml +++ b/docs/libnm/tmpl/nm-setting-team-port.sgml @@ -36,24 +36,6 @@ NMSettingTeamPort - - - - - - - - - - - - - - - - -@parent: - diff --git a/docs/libnm/tmpl/nm-setting-team.sgml b/docs/libnm/tmpl/nm-setting-team.sgml index ed6ea846..6c2cb1fa 100644 --- a/docs/libnm/tmpl/nm-setting-team.sgml +++ b/docs/libnm/tmpl/nm-setting-team.sgml @@ -36,24 +36,6 @@ NMSettingTeam - - - - - - - - - - - - - - - - -@parent: - diff --git a/docs/libnm/tmpl/nm-setting-vlan.sgml b/docs/libnm/tmpl/nm-setting-vlan.sgml index fa0915d0..756c0399 100644 --- a/docs/libnm/tmpl/nm-setting-vlan.sgml +++ b/docs/libnm/tmpl/nm-setting-vlan.sgml @@ -64,44 +64,6 @@ NMSettingVlan - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -@parent: - diff --git a/docs/libnm/tmpl/nm-setting-vpn.sgml b/docs/libnm/tmpl/nm-setting-vpn.sgml index e7aef771..2d5e70c9 100644 --- a/docs/libnm/tmpl/nm-setting-vpn.sgml +++ b/docs/libnm/tmpl/nm-setting-vpn.sgml @@ -64,44 +64,6 @@ NMSettingVpn - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -@parent: - diff --git a/docs/libnm/tmpl/nm-setting-wimax.sgml b/docs/libnm/tmpl/nm-setting-wimax.sgml index 51eb12de..a7f51a8e 100644 --- a/docs/libnm/tmpl/nm-setting-wimax.sgml +++ b/docs/libnm/tmpl/nm-setting-wimax.sgml @@ -43,29 +43,6 @@ NMSettingWimax - - - - - - - - - - - - - - - - - - - - - -@parent: - diff --git a/docs/libnm/tmpl/nm-setting-wired.sgml b/docs/libnm/tmpl/nm-setting-wired.sgml index 06cd9157..156ff4f1 100644 --- a/docs/libnm/tmpl/nm-setting-wired.sgml +++ b/docs/libnm/tmpl/nm-setting-wired.sgml @@ -106,74 +106,6 @@ NMSettingWired - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -@parent: - diff --git a/docs/libnm/tmpl/nm-setting-wireless-security.sgml b/docs/libnm/tmpl/nm-setting-wireless-security.sgml index 5cfed64c..4cb19ed3 100644 --- a/docs/libnm/tmpl/nm-setting-wireless-security.sgml +++ b/docs/libnm/tmpl/nm-setting-wireless-security.sgml @@ -158,104 +158,6 @@ NMSettingWirelessSecurity - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -@parent: - diff --git a/docs/libnm/tmpl/nm-setting-wireless.sgml b/docs/libnm/tmpl/nm-setting-wireless.sgml index 4a69fd77..f20aa114 100644 --- a/docs/libnm/tmpl/nm-setting-wireless.sgml +++ b/docs/libnm/tmpl/nm-setting-wireless.sgml @@ -141,84 +141,6 @@ NMSettingWireless - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -@parent: - diff --git a/docs/libnm/tmpl/nm-setting.sgml b/docs/libnm/tmpl/nm-setting.sgml index aec0ef91..88a4e99e 100644 --- a/docs/libnm/tmpl/nm-setting.sgml +++ b/docs/libnm/tmpl/nm-setting.sgml @@ -98,20 +98,6 @@ NMSetting @Returns: - - - - - -@parent: -@verify: -@need_secrets: -@update_one_secret: -@get_secret_flags: -@set_secret_flags: -@clear_secrets_with_flags: -@compare_property: - diff --git a/docs/libnm/tmpl/nm-simple-connection.sgml b/docs/libnm/tmpl/nm-simple-connection.sgml index 683461f8..8ef5406d 100644 --- a/docs/libnm/tmpl/nm-simple-connection.sgml +++ b/docs/libnm/tmpl/nm-simple-connection.sgml @@ -22,19 +22,6 @@ NMSimpleConnection - - - - - - - - - - - -@parent_class: - diff --git a/docs/libnm/tmpl/nm-vpn-connection.sgml b/docs/libnm/tmpl/nm-vpn-connection.sgml index 0b85b6f0..33b7ef29 100644 --- a/docs/libnm/tmpl/nm-vpn-connection.sgml +++ b/docs/libnm/tmpl/nm-vpn-connection.sgml @@ -36,39 +36,6 @@ NMVpnConnection - - - - - - - - - - - -@nmvpnconnection: the object which received the signal. -@arg1: -@arg2: - - - - - - - - - - - - - - - - -@parent: -@vpn_state_changed: - diff --git a/docs/libnm/tmpl/nm-vpn-editor-plugin.sgml b/docs/libnm/tmpl/nm-vpn-editor-plugin.sgml index f657e7e2..a945515b 100644 --- a/docs/libnm/tmpl/nm-vpn-editor-plugin.sgml +++ b/docs/libnm/tmpl/nm-vpn-editor-plugin.sgml @@ -1,5 +1,5 @@ -NMVpnEditorPlugin +NMVpnEditor diff --git a/docs/libnm/tmpl/nm-wimax-nsp.sgml b/docs/libnm/tmpl/nm-wimax-nsp.sgml index 12143f54..ceb02601 100644 --- a/docs/libnm/tmpl/nm-wimax-nsp.sgml +++ b/docs/libnm/tmpl/nm-wimax-nsp.sgml @@ -53,34 +53,6 @@ NMWimaxNsp @NM_WIMAX_NSP_NETWORK_TYPE_PARTNER: @NM_WIMAX_NSP_NETWORK_TYPE_ROAMING_PARTNER: - - - - - - - - - - - - - - - - - - - - - - - - - - -@parent: - diff --git a/docs/libnm/version.xml b/docs/libnm/version.xml index 3eefcb9d..6d7de6e6 100644 --- a/docs/libnm/version.xml +++ b/docs/libnm/version.xml @@ -1 +1 @@ -1.0.0 +1.0.2 diff --git a/examples/C/Makefile.in b/examples/C/Makefile.in index c3bdf7e6..f9eec797 100644 --- a/examples/C/Makefile.in +++ b/examples/C/Makefile.in @@ -1,7 +1,7 @@ -# Makefile.in generated by automake 1.13.4 from Makefile.am. +# Makefile.in generated by automake 1.15 from Makefile.am. # @configure_input@ -# Copyright (C) 1994-2013 Free Software Foundation, Inc. +# Copyright (C) 1994-2014 Free Software Foundation, Inc. # This Makefile.in is free software; the Free Software Foundation # gives unlimited permission to copy and/or distribute it, @@ -14,7 +14,17 @@ @SET_MAKE@ VPATH = @srcdir@ -am__is_gnu_make = test -n '$(MAKEFILE_LIST)' && test -n '$(MAKELEVEL)' +am__is_gnu_make = { \ + if test -z '$(MAKELEVEL)'; then \ + false; \ + elif test -n '$(MAKE_HOST)'; then \ + true; \ + elif test -n '$(MAKE_VERSION)' && test -n '$(CURDIR)'; then \ + true; \ + else \ + false; \ + fi; \ +} am__make_running_with_option = \ case $${target_option-} in \ ?) ;; \ @@ -79,7 +89,6 @@ build_triplet = @build@ host_triplet = @host@ @WITH_QT_TRUE@am__append_1 = qt subdir = examples/C -DIST_COMMON = $(srcdir)/Makefile.in $(srcdir)/Makefile.am ACLOCAL_M4 = $(top_srcdir)/aclocal.m4 am__aclocal_m4_deps = $(top_srcdir)/m4/ax_lib_readline.m4 \ $(top_srcdir)/m4/compiler_warnings.m4 \ @@ -96,6 +105,7 @@ am__aclocal_m4_deps = $(top_srcdir)/m4/ax_lib_readline.m4 \ $(top_srcdir)/m4/vapigen.m4 $(top_srcdir)/configure.ac am__configure_deps = $(am__aclocal_m4_deps) $(CONFIGURE_DEPENDENCIES) \ $(ACLOCAL_M4) +DIST_COMMON = $(srcdir)/Makefile.am $(am__DIST_COMMON) mkinstalldirs = $(install_sh) -d CONFIG_HEADER = $(top_builddir)/config.h CONFIG_CLEAN_FILES = @@ -155,6 +165,7 @@ am__define_uniq_tagged_files = \ ETAGS = etags CTAGS = ctags DIST_SUBDIRS = glib qt +am__DIST_COMMON = $(srcdir)/Makefile.in DISTFILES = $(DIST_COMMON) $(DIST_SOURCES) $(TEXINFOS) $(EXTRA_DIST) am__relativize = \ dir0=`pwd`; \ @@ -206,7 +217,6 @@ CXXCPP = @CXXCPP@ CXXDEPMODE = @CXXDEPMODE@ CXXFLAGS = @CXXFLAGS@ CYGPATH_W = @CYGPATH_W@ -DATADIRNAME = @DATADIRNAME@ DBUS_CFLAGS = @DBUS_CFLAGS@ DBUS_GLIB_100_CFLAGS = @DBUS_GLIB_100_CFLAGS@ DBUS_GLIB_100_LIBS = @DBUS_GLIB_100_LIBS@ @@ -241,6 +251,7 @@ GNUTLS_CFLAGS = @GNUTLS_CFLAGS@ GNUTLS_LIBS = @GNUTLS_LIBS@ GREP = @GREP@ GTKDOC_CHECK = @GTKDOC_CHECK@ +GTKDOC_CHECK_PATH = @GTKDOC_CHECK_PATH@ GTKDOC_DEPS_CFLAGS = @GTKDOC_DEPS_CFLAGS@ GTKDOC_DEPS_LIBS = @GTKDOC_DEPS_LIBS@ GTKDOC_MKPDF = @GTKDOC_MKPDF@ @@ -457,7 +468,6 @@ $(srcdir)/Makefile.in: @MAINTAINER_MODE_TRUE@ $(srcdir)/Makefile.am $(am__confi echo ' cd $(top_srcdir) && $(AUTOMAKE) --gnu examples/C/Makefile'; \ $(am__cd) $(top_srcdir) && \ $(AUTOMAKE) --gnu examples/C/Makefile -.PRECIOUS: Makefile Makefile: $(srcdir)/Makefile.in $(top_builddir)/config.status @case '$?' in \ *config.status*) \ @@ -752,6 +762,8 @@ uninstall-am: mostlyclean mostlyclean-generic mostlyclean-libtool pdf pdf-am \ ps ps-am tags tags-am uninstall uninstall-am +.PRECIOUS: Makefile + # Tell versions [3.59,3.63) of GNU make to not export all variables. # Otherwise a system limit (for SysV at least) may be exceeded. diff --git a/examples/C/glib/Makefile.in b/examples/C/glib/Makefile.in index d2790a7a..b404d0da 100644 --- a/examples/C/glib/Makefile.in +++ b/examples/C/glib/Makefile.in @@ -1,7 +1,7 @@ -# Makefile.in generated by automake 1.13.4 from Makefile.am. +# Makefile.in generated by automake 1.15 from Makefile.am. # @configure_input@ -# Copyright (C) 1994-2013 Free Software Foundation, Inc. +# Copyright (C) 1994-2014 Free Software Foundation, Inc. # This Makefile.in is free software; the Free Software Foundation # gives unlimited permission to copy and/or distribute it, @@ -15,7 +15,17 @@ @SET_MAKE@ VPATH = @srcdir@ -am__is_gnu_make = test -n '$(MAKEFILE_LIST)' && test -n '$(MAKELEVEL)' +am__is_gnu_make = { \ + if test -z '$(MAKELEVEL)'; then \ + false; \ + elif test -n '$(MAKE_HOST)'; then \ + true; \ + elif test -n '$(MAKE_VERSION)' && test -n '$(CURDIR)'; then \ + true; \ + else \ + false; \ + fi; \ +} am__make_running_with_option = \ case $${target_option-} in \ ?) ;; \ @@ -86,8 +96,6 @@ noinst_PROGRAMS = add-connection-gdbus$(EXEEXT) \ monitor-nm-running-gdbus$(EXEEXT) \ monitor-nm-state-gdbus$(EXEEXT) subdir = examples/C/glib -DIST_COMMON = $(srcdir)/Makefile.in $(srcdir)/Makefile.am \ - $(top_srcdir)/build-aux/depcomp ACLOCAL_M4 = $(top_srcdir)/aclocal.m4 am__aclocal_m4_deps = $(top_srcdir)/m4/ax_lib_readline.m4 \ $(top_srcdir)/m4/compiler_warnings.m4 \ @@ -104,6 +112,7 @@ am__aclocal_m4_deps = $(top_srcdir)/m4/ax_lib_readline.m4 \ $(top_srcdir)/m4/vapigen.m4 $(top_srcdir)/configure.ac am__configure_deps = $(am__aclocal_m4_deps) $(CONFIGURE_DEPENDENCIES) \ $(ACLOCAL_M4) +DIST_COMMON = $(srcdir)/Makefile.am $(am__DIST_COMMON) mkinstalldirs = $(install_sh) -d CONFIG_HEADER = $(top_builddir)/config.h CONFIG_CLEAN_FILES = @@ -218,6 +227,8 @@ am__define_uniq_tagged_files = \ done | $(am__uniquify_input)` ETAGS = etags CTAGS = ctags +am__DIST_COMMON = $(srcdir)/Makefile.in \ + $(top_srcdir)/build-aux/depcomp DISTFILES = $(DIST_COMMON) $(DIST_SOURCES) $(TEXINFOS) $(EXTRA_DIST) ACLOCAL = @ACLOCAL@ ALL_LINGUAS = @ALL_LINGUAS@ @@ -244,7 +255,6 @@ CXXCPP = @CXXCPP@ CXXDEPMODE = @CXXDEPMODE@ CXXFLAGS = @CXXFLAGS@ CYGPATH_W = @CYGPATH_W@ -DATADIRNAME = @DATADIRNAME@ DBUS_CFLAGS = @DBUS_CFLAGS@ DBUS_GLIB_100_CFLAGS = @DBUS_GLIB_100_CFLAGS@ DBUS_GLIB_100_LIBS = @DBUS_GLIB_100_LIBS@ @@ -279,6 +289,7 @@ GNUTLS_CFLAGS = @GNUTLS_CFLAGS@ GNUTLS_LIBS = @GNUTLS_LIBS@ GREP = @GREP@ GTKDOC_CHECK = @GTKDOC_CHECK@ +GTKDOC_CHECK_PATH = @GTKDOC_CHECK_PATH@ GTKDOC_DEPS_CFLAGS = @GTKDOC_DEPS_CFLAGS@ GTKDOC_DEPS_LIBS = @GTKDOC_DEPS_LIBS@ GTKDOC_MKPDF = @GTKDOC_MKPDF@ @@ -539,7 +550,6 @@ $(srcdir)/Makefile.in: @MAINTAINER_MODE_TRUE@ $(srcdir)/Makefile.am $(am__confi echo ' cd $(top_srcdir) && $(AUTOMAKE) --gnu examples/C/glib/Makefile'; \ $(am__cd) $(top_srcdir) && \ $(AUTOMAKE) --gnu examples/C/glib/Makefile -.PRECIOUS: Makefile Makefile: $(srcdir)/Makefile.in $(top_builddir)/config.status @case '$?' in \ *config.status*) \ @@ -619,14 +629,14 @@ distclean-compile: @am__fastdepCC_TRUE@ $(AM_V_at)$(am__mv) $(DEPDIR)/$*.Tpo $(DEPDIR)/$*.Po @AMDEP_TRUE@@am__fastdepCC_FALSE@ $(AM_V_CC)source='$<' object='$@' libtool=no @AMDEPBACKSLASH@ @AMDEP_TRUE@@am__fastdepCC_FALSE@ DEPDIR=$(DEPDIR) $(CCDEPMODE) $(depcomp) @AMDEPBACKSLASH@ -@am__fastdepCC_FALSE@ $(AM_V_CC@am__nodep@)$(COMPILE) -c $< +@am__fastdepCC_FALSE@ $(AM_V_CC@am__nodep@)$(COMPILE) -c -o $@ $< .c.obj: @am__fastdepCC_TRUE@ $(AM_V_CC)$(COMPILE) -MT $@ -MD -MP -MF $(DEPDIR)/$*.Tpo -c -o $@ `$(CYGPATH_W) '$<'` @am__fastdepCC_TRUE@ $(AM_V_at)$(am__mv) $(DEPDIR)/$*.Tpo $(DEPDIR)/$*.Po @AMDEP_TRUE@@am__fastdepCC_FALSE@ $(AM_V_CC)source='$<' object='$@' libtool=no @AMDEPBACKSLASH@ @AMDEP_TRUE@@am__fastdepCC_FALSE@ DEPDIR=$(DEPDIR) $(CCDEPMODE) $(depcomp) @AMDEPBACKSLASH@ -@am__fastdepCC_FALSE@ $(AM_V_CC@am__nodep@)$(COMPILE) -c `$(CYGPATH_W) '$<'` +@am__fastdepCC_FALSE@ $(AM_V_CC@am__nodep@)$(COMPILE) -c -o $@ `$(CYGPATH_W) '$<'` .c.lo: @am__fastdepCC_TRUE@ $(AM_V_CC)$(LTCOMPILE) -MT $@ -MD -MP -MF $(DEPDIR)/$*.Tpo -c -o $@ $< @@ -844,6 +854,8 @@ uninstall-am: mostlyclean-generic mostlyclean-libtool pdf pdf-am ps ps-am \ tags tags-am uninstall uninstall-am +.PRECIOUS: Makefile + # Tell versions [3.59,3.63) of GNU make to not export all variables. # Otherwise a system limit (for SysV at least) may be exceeded. diff --git a/examples/C/qt/Makefile.in b/examples/C/qt/Makefile.in index f6bb151c..3f89c11c 100644 --- a/examples/C/qt/Makefile.in +++ b/examples/C/qt/Makefile.in @@ -1,7 +1,7 @@ -# Makefile.in generated by automake 1.13.4 from Makefile.am. +# Makefile.in generated by automake 1.15 from Makefile.am. # @configure_input@ -# Copyright (C) 1994-2013 Free Software Foundation, Inc. +# Copyright (C) 1994-2014 Free Software Foundation, Inc. # This Makefile.in is free software; the Free Software Foundation # gives unlimited permission to copy and/or distribute it, @@ -15,7 +15,17 @@ @SET_MAKE@ VPATH = @srcdir@ -am__is_gnu_make = test -n '$(MAKEFILE_LIST)' && test -n '$(MAKELEVEL)' +am__is_gnu_make = { \ + if test -z '$(MAKELEVEL)'; then \ + false; \ + elif test -n '$(MAKE_HOST)'; then \ + true; \ + elif test -n '$(MAKE_VERSION)' && test -n '$(CURDIR)'; then \ + true; \ + else \ + false; \ + fi; \ +} am__make_running_with_option = \ case $${target_option-} in \ ?) ;; \ @@ -82,8 +92,6 @@ noinst_PROGRAMS = add-connection-wired$(EXEEXT) \ list-connections$(EXEEXT) change-ipv4-addresses$(EXEEXT) \ monitor-nm-running$(EXEEXT) subdir = examples/C/qt -DIST_COMMON = $(srcdir)/Makefile.in $(srcdir)/Makefile.am \ - $(top_srcdir)/build-aux/depcomp ACLOCAL_M4 = $(top_srcdir)/aclocal.m4 am__aclocal_m4_deps = $(top_srcdir)/m4/ax_lib_readline.m4 \ $(top_srcdir)/m4/compiler_warnings.m4 \ @@ -100,6 +108,7 @@ am__aclocal_m4_deps = $(top_srcdir)/m4/ax_lib_readline.m4 \ $(top_srcdir)/m4/vapigen.m4 $(top_srcdir)/configure.ac am__configure_deps = $(am__aclocal_m4_deps) $(CONFIGURE_DEPENDENCIES) \ $(ACLOCAL_M4) +DIST_COMMON = $(srcdir)/Makefile.am $(am__DIST_COMMON) mkinstalldirs = $(install_sh) -d CONFIG_HEADER = $(top_builddir)/config.h CONFIG_CLEAN_FILES = @@ -190,6 +199,8 @@ am__define_uniq_tagged_files = \ done | $(am__uniquify_input)` ETAGS = etags CTAGS = ctags +am__DIST_COMMON = $(srcdir)/Makefile.in \ + $(top_srcdir)/build-aux/depcomp DISTFILES = $(DIST_COMMON) $(DIST_SOURCES) $(TEXINFOS) $(EXTRA_DIST) ACLOCAL = @ACLOCAL@ ALL_LINGUAS = @ALL_LINGUAS@ @@ -216,7 +227,6 @@ CXXCPP = @CXXCPP@ CXXDEPMODE = @CXXDEPMODE@ CXXFLAGS = @CXXFLAGS@ CYGPATH_W = @CYGPATH_W@ -DATADIRNAME = @DATADIRNAME@ DBUS_CFLAGS = @DBUS_CFLAGS@ DBUS_GLIB_100_CFLAGS = @DBUS_GLIB_100_CFLAGS@ DBUS_GLIB_100_LIBS = @DBUS_GLIB_100_LIBS@ @@ -251,6 +261,7 @@ GNUTLS_CFLAGS = @GNUTLS_CFLAGS@ GNUTLS_LIBS = @GNUTLS_LIBS@ GREP = @GREP@ GTKDOC_CHECK = @GTKDOC_CHECK@ +GTKDOC_CHECK_PATH = @GTKDOC_CHECK_PATH@ GTKDOC_DEPS_CFLAGS = @GTKDOC_DEPS_CFLAGS@ GTKDOC_DEPS_LIBS = @GTKDOC_DEPS_LIBS@ GTKDOC_MKPDF = @GTKDOC_MKPDF@ @@ -504,7 +515,6 @@ $(srcdir)/Makefile.in: @MAINTAINER_MODE_TRUE@ $(srcdir)/Makefile.am $(am__confi echo ' cd $(top_srcdir) && $(AUTOMAKE) --gnu examples/C/qt/Makefile'; \ $(am__cd) $(top_srcdir) && \ $(AUTOMAKE) --gnu examples/C/qt/Makefile -.PRECIOUS: Makefile Makefile: $(srcdir)/Makefile.in $(top_builddir)/config.status @case '$?' in \ *config.status*) \ @@ -793,6 +803,8 @@ uninstall-am: mostlyclean-generic mostlyclean-libtool pdf pdf-am ps ps-am \ tags tags-am uninstall uninstall-am +.PRECIOUS: Makefile + monitor-nm-running.moc: monitor-nm-running.cpp $(AM_V_GEN) $(MOC) -i $< -o $@ diff --git a/examples/Makefile.in b/examples/Makefile.in index 6754f4e6..0228abd0 100644 --- a/examples/Makefile.in +++ b/examples/Makefile.in @@ -1,7 +1,7 @@ -# Makefile.in generated by automake 1.13.4 from Makefile.am. +# Makefile.in generated by automake 1.15 from Makefile.am. # @configure_input@ -# Copyright (C) 1994-2013 Free Software Foundation, Inc. +# Copyright (C) 1994-2014 Free Software Foundation, Inc. # This Makefile.in is free software; the Free Software Foundation # gives unlimited permission to copy and/or distribute it, @@ -14,7 +14,17 @@ @SET_MAKE@ VPATH = @srcdir@ -am__is_gnu_make = test -n '$(MAKEFILE_LIST)' && test -n '$(MAKELEVEL)' +am__is_gnu_make = { \ + if test -z '$(MAKELEVEL)'; then \ + false; \ + elif test -n '$(MAKE_HOST)'; then \ + true; \ + elif test -n '$(MAKE_VERSION)' && test -n '$(CURDIR)'; then \ + true; \ + else \ + false; \ + fi; \ +} am__make_running_with_option = \ case $${target_option-} in \ ?) ;; \ @@ -78,7 +88,6 @@ POST_UNINSTALL = : build_triplet = @build@ host_triplet = @host@ subdir = examples -DIST_COMMON = $(srcdir)/Makefile.in $(srcdir)/Makefile.am ACLOCAL_M4 = $(top_srcdir)/aclocal.m4 am__aclocal_m4_deps = $(top_srcdir)/m4/ax_lib_readline.m4 \ $(top_srcdir)/m4/compiler_warnings.m4 \ @@ -95,6 +104,7 @@ am__aclocal_m4_deps = $(top_srcdir)/m4/ax_lib_readline.m4 \ $(top_srcdir)/m4/vapigen.m4 $(top_srcdir)/configure.ac am__configure_deps = $(am__aclocal_m4_deps) $(CONFIGURE_DEPENDENCIES) \ $(ACLOCAL_M4) +DIST_COMMON = $(srcdir)/Makefile.am $(am__DIST_COMMON) mkinstalldirs = $(install_sh) -d CONFIG_HEADER = $(top_builddir)/config.h CONFIG_CLEAN_FILES = @@ -154,6 +164,7 @@ am__define_uniq_tagged_files = \ ETAGS = etags CTAGS = ctags DIST_SUBDIRS = $(SUBDIRS) +am__DIST_COMMON = $(srcdir)/Makefile.in DISTFILES = $(DIST_COMMON) $(DIST_SOURCES) $(TEXINFOS) $(EXTRA_DIST) am__relativize = \ dir0=`pwd`; \ @@ -205,7 +216,6 @@ CXXCPP = @CXXCPP@ CXXDEPMODE = @CXXDEPMODE@ CXXFLAGS = @CXXFLAGS@ CYGPATH_W = @CYGPATH_W@ -DATADIRNAME = @DATADIRNAME@ DBUS_CFLAGS = @DBUS_CFLAGS@ DBUS_GLIB_100_CFLAGS = @DBUS_GLIB_100_CFLAGS@ DBUS_GLIB_100_LIBS = @DBUS_GLIB_100_LIBS@ @@ -240,6 +250,7 @@ GNUTLS_CFLAGS = @GNUTLS_CFLAGS@ GNUTLS_LIBS = @GNUTLS_LIBS@ GREP = @GREP@ GTKDOC_CHECK = @GTKDOC_CHECK@ +GTKDOC_CHECK_PATH = @GTKDOC_CHECK_PATH@ GTKDOC_DEPS_CFLAGS = @GTKDOC_DEPS_CFLAGS@ GTKDOC_DEPS_LIBS = @GTKDOC_DEPS_LIBS@ GTKDOC_MKPDF = @GTKDOC_MKPDF@ @@ -462,7 +473,6 @@ $(srcdir)/Makefile.in: @MAINTAINER_MODE_TRUE@ $(srcdir)/Makefile.am $(am__confi echo ' cd $(top_srcdir) && $(AUTOMAKE) --gnu examples/Makefile'; \ $(am__cd) $(top_srcdir) && \ $(AUTOMAKE) --gnu examples/Makefile -.PRECIOUS: Makefile Makefile: $(srcdir)/Makefile.in $(top_builddir)/config.status @case '$?' in \ *config.status*) \ @@ -757,6 +767,8 @@ uninstall-am: mostlyclean mostlyclean-generic mostlyclean-libtool pdf pdf-am \ ps ps-am tags tags-am uninstall uninstall-am +.PRECIOUS: Makefile + # Tell versions [3.59,3.63) of GNU make to not export all variables. # Otherwise a system limit (for SysV at least) may be exceeded. diff --git a/examples/dispatcher/10-ifcfg-rh-routes.sh b/examples/dispatcher/10-ifcfg-rh-routes.sh new file mode 100755 index 00000000..75b8c5e5 --- /dev/null +++ b/examples/dispatcher/10-ifcfg-rh-routes.sh @@ -0,0 +1,34 @@ +#!/bin/sh + +# This ifcfg-rh-specific script runs +# /etc/sysconfig/network-scripts/ifup-routes when bringing up +# interfaces that have routing rules associated with them that can't +# be expressed by NMSettingIPConfig. (Eg, policy-based routing.) + +# This should be installed in both dispatcher.d/ and +# dispatcher.d/pre-up.d/ + +if [ "$2" != "pre-up" -a "$2" != "down" ]; then + exit 0 +fi + +dir=$(dirname "$CONNECTION_FILENAME") +if [ "$dir" != "/etc/sysconfig/network-scripts" ]; then + exit 0 +fi +profile=$(basename "$CONNECTION_FILENAME" | sed -ne 's/^ifcfg-//p') +if [ -z "$profile" ]; then + exit 0 +fi +if ! [ -f "$dir/rule-$profile" -o -f "$dir/rule6-$profile" ]; then + exit 0 +fi + +case "$2" in + pre-up) + /etc/sysconfig/network-scripts/ifup-routes "$DEVICE_IP_IFACE" "$profile" + ;; + down) + /etc/sysconfig/network-scripts/ifdown-routes "$DEVICE_IP_IFACE" "$profile" + ;; +esac diff --git a/examples/dispatcher/Makefile.am b/examples/dispatcher/Makefile.am index 0db71a0d..0089d5fe 100644 --- a/examples/dispatcher/Makefile.am +++ b/examples/dispatcher/Makefile.am @@ -1,3 +1,4 @@ EXTRA_DIST = \ + 10-ifcfg-rh-routes.sh \ 70-wifi-wired-exclusive.sh diff --git a/examples/dispatcher/Makefile.in b/examples/dispatcher/Makefile.in index 7e1686ad..96174d84 100644 --- a/examples/dispatcher/Makefile.in +++ b/examples/dispatcher/Makefile.in @@ -1,7 +1,7 @@ -# Makefile.in generated by automake 1.13.4 from Makefile.am. +# Makefile.in generated by automake 1.15 from Makefile.am. # @configure_input@ -# Copyright (C) 1994-2013 Free Software Foundation, Inc. +# Copyright (C) 1994-2014 Free Software Foundation, Inc. # This Makefile.in is free software; the Free Software Foundation # gives unlimited permission to copy and/or distribute it, @@ -14,7 +14,17 @@ @SET_MAKE@ VPATH = @srcdir@ -am__is_gnu_make = test -n '$(MAKEFILE_LIST)' && test -n '$(MAKELEVEL)' +am__is_gnu_make = { \ + if test -z '$(MAKELEVEL)'; then \ + false; \ + elif test -n '$(MAKE_HOST)'; then \ + true; \ + elif test -n '$(MAKE_VERSION)' && test -n '$(CURDIR)'; then \ + true; \ + else \ + false; \ + fi; \ +} am__make_running_with_option = \ case $${target_option-} in \ ?) ;; \ @@ -78,7 +88,6 @@ POST_UNINSTALL = : build_triplet = @build@ host_triplet = @host@ subdir = examples/dispatcher -DIST_COMMON = $(srcdir)/Makefile.in $(srcdir)/Makefile.am ACLOCAL_M4 = $(top_srcdir)/aclocal.m4 am__aclocal_m4_deps = $(top_srcdir)/m4/ax_lib_readline.m4 \ $(top_srcdir)/m4/compiler_warnings.m4 \ @@ -95,6 +104,7 @@ am__aclocal_m4_deps = $(top_srcdir)/m4/ax_lib_readline.m4 \ $(top_srcdir)/m4/vapigen.m4 $(top_srcdir)/configure.ac am__configure_deps = $(am__aclocal_m4_deps) $(CONFIGURE_DEPENDENCIES) \ $(ACLOCAL_M4) +DIST_COMMON = $(srcdir)/Makefile.am $(am__DIST_COMMON) mkinstalldirs = $(install_sh) -d CONFIG_HEADER = $(top_builddir)/config.h CONFIG_CLEAN_FILES = @@ -119,6 +129,7 @@ am__can_run_installinfo = \ *) (install-info --version) >/dev/null 2>&1;; \ esac am__tagged_files = $(HEADERS) $(SOURCES) $(TAGS_FILES) $(LISP) +am__DIST_COMMON = $(srcdir)/Makefile.in DISTFILES = $(DIST_COMMON) $(DIST_SOURCES) $(TEXINFOS) $(EXTRA_DIST) ACLOCAL = @ACLOCAL@ ALL_LINGUAS = @ALL_LINGUAS@ @@ -145,7 +156,6 @@ CXXCPP = @CXXCPP@ CXXDEPMODE = @CXXDEPMODE@ CXXFLAGS = @CXXFLAGS@ CYGPATH_W = @CYGPATH_W@ -DATADIRNAME = @DATADIRNAME@ DBUS_CFLAGS = @DBUS_CFLAGS@ DBUS_GLIB_100_CFLAGS = @DBUS_GLIB_100_CFLAGS@ DBUS_GLIB_100_LIBS = @DBUS_GLIB_100_LIBS@ @@ -180,6 +190,7 @@ GNUTLS_CFLAGS = @GNUTLS_CFLAGS@ GNUTLS_LIBS = @GNUTLS_LIBS@ GREP = @GREP@ GTKDOC_CHECK = @GTKDOC_CHECK@ +GTKDOC_CHECK_PATH = @GTKDOC_CHECK_PATH@ GTKDOC_DEPS_CFLAGS = @GTKDOC_DEPS_CFLAGS@ GTKDOC_DEPS_LIBS = @GTKDOC_DEPS_LIBS@ GTKDOC_MKPDF = @GTKDOC_MKPDF@ @@ -381,6 +392,7 @@ with_netconfig = @with_netconfig@ with_resolvconf = @with_resolvconf@ with_valgrind = @with_valgrind@ EXTRA_DIST = \ + 10-ifcfg-rh-routes.sh \ 70-wifi-wired-exclusive.sh all: all-am @@ -398,7 +410,6 @@ $(srcdir)/Makefile.in: @MAINTAINER_MODE_TRUE@ $(srcdir)/Makefile.am $(am__confi echo ' cd $(top_srcdir) && $(AUTOMAKE) --gnu examples/dispatcher/Makefile'; \ $(am__cd) $(top_srcdir) && \ $(AUTOMAKE) --gnu examples/dispatcher/Makefile -.PRECIOUS: Makefile Makefile: $(srcdir)/Makefile.in $(top_builddir)/config.status @case '$?' in \ *config.status*) \ @@ -573,6 +584,8 @@ uninstall-am: mostlyclean-generic mostlyclean-libtool pdf pdf-am ps ps-am \ tags-am uninstall uninstall-am +.PRECIOUS: Makefile + # Tell versions [3.59,3.63) of GNU make to not export all variables. # Otherwise a system limit (for SysV at least) may be exceeded. diff --git a/examples/python/Makefile.in b/examples/python/Makefile.in index fd0edd1c..071e0791 100644 --- a/examples/python/Makefile.in +++ b/examples/python/Makefile.in @@ -1,7 +1,7 @@ -# Makefile.in generated by automake 1.13.4 from Makefile.am. +# Makefile.in generated by automake 1.15 from Makefile.am. # @configure_input@ -# Copyright (C) 1994-2013 Free Software Foundation, Inc. +# Copyright (C) 1994-2014 Free Software Foundation, Inc. # This Makefile.in is free software; the Free Software Foundation # gives unlimited permission to copy and/or distribute it, @@ -14,7 +14,17 @@ @SET_MAKE@ VPATH = @srcdir@ -am__is_gnu_make = test -n '$(MAKEFILE_LIST)' && test -n '$(MAKELEVEL)' +am__is_gnu_make = { \ + if test -z '$(MAKELEVEL)'; then \ + false; \ + elif test -n '$(MAKE_HOST)'; then \ + true; \ + elif test -n '$(MAKE_VERSION)' && test -n '$(CURDIR)'; then \ + true; \ + else \ + false; \ + fi; \ +} am__make_running_with_option = \ case $${target_option-} in \ ?) ;; \ @@ -78,7 +88,6 @@ POST_UNINSTALL = : build_triplet = @build@ host_triplet = @host@ subdir = examples/python -DIST_COMMON = $(srcdir)/Makefile.in $(srcdir)/Makefile.am ACLOCAL_M4 = $(top_srcdir)/aclocal.m4 am__aclocal_m4_deps = $(top_srcdir)/m4/ax_lib_readline.m4 \ $(top_srcdir)/m4/compiler_warnings.m4 \ @@ -95,6 +104,7 @@ am__aclocal_m4_deps = $(top_srcdir)/m4/ax_lib_readline.m4 \ $(top_srcdir)/m4/vapigen.m4 $(top_srcdir)/configure.ac am__configure_deps = $(am__aclocal_m4_deps) $(CONFIGURE_DEPENDENCIES) \ $(ACLOCAL_M4) +DIST_COMMON = $(srcdir)/Makefile.am $(am__DIST_COMMON) mkinstalldirs = $(install_sh) -d CONFIG_HEADER = $(top_builddir)/config.h CONFIG_CLEAN_FILES = @@ -154,6 +164,7 @@ am__define_uniq_tagged_files = \ ETAGS = etags CTAGS = ctags DIST_SUBDIRS = $(SUBDIRS) +am__DIST_COMMON = $(srcdir)/Makefile.in DISTFILES = $(DIST_COMMON) $(DIST_SOURCES) $(TEXINFOS) $(EXTRA_DIST) am__relativize = \ dir0=`pwd`; \ @@ -205,7 +216,6 @@ CXXCPP = @CXXCPP@ CXXDEPMODE = @CXXDEPMODE@ CXXFLAGS = @CXXFLAGS@ CYGPATH_W = @CYGPATH_W@ -DATADIRNAME = @DATADIRNAME@ DBUS_CFLAGS = @DBUS_CFLAGS@ DBUS_GLIB_100_CFLAGS = @DBUS_GLIB_100_CFLAGS@ DBUS_GLIB_100_LIBS = @DBUS_GLIB_100_LIBS@ @@ -240,6 +250,7 @@ GNUTLS_CFLAGS = @GNUTLS_CFLAGS@ GNUTLS_LIBS = @GNUTLS_LIBS@ GREP = @GREP@ GTKDOC_CHECK = @GTKDOC_CHECK@ +GTKDOC_CHECK_PATH = @GTKDOC_CHECK_PATH@ GTKDOC_DEPS_CFLAGS = @GTKDOC_DEPS_CFLAGS@ GTKDOC_DEPS_LIBS = @GTKDOC_DEPS_LIBS@ GTKDOC_MKPDF = @GTKDOC_MKPDF@ @@ -456,7 +467,6 @@ $(srcdir)/Makefile.in: @MAINTAINER_MODE_TRUE@ $(srcdir)/Makefile.am $(am__confi echo ' cd $(top_srcdir) && $(AUTOMAKE) --gnu examples/python/Makefile'; \ $(am__cd) $(top_srcdir) && \ $(AUTOMAKE) --gnu examples/python/Makefile -.PRECIOUS: Makefile Makefile: $(srcdir)/Makefile.in $(top_builddir)/config.status @case '$?' in \ *config.status*) \ @@ -751,6 +761,8 @@ uninstall-am: mostlyclean mostlyclean-generic mostlyclean-libtool pdf pdf-am \ ps ps-am tags tags-am uninstall uninstall-am +.PRECIOUS: Makefile + # Tell versions [3.59,3.63) of GNU make to not export all variables. # Otherwise a system limit (for SysV at least) may be exceeded. diff --git a/examples/python/dbus/Makefile.in b/examples/python/dbus/Makefile.in index a505993c..3b886251 100644 --- a/examples/python/dbus/Makefile.in +++ b/examples/python/dbus/Makefile.in @@ -1,7 +1,7 @@ -# Makefile.in generated by automake 1.13.4 from Makefile.am. +# Makefile.in generated by automake 1.15 from Makefile.am. # @configure_input@ -# Copyright (C) 1994-2013 Free Software Foundation, Inc. +# Copyright (C) 1994-2014 Free Software Foundation, Inc. # This Makefile.in is free software; the Free Software Foundation # gives unlimited permission to copy and/or distribute it, @@ -14,7 +14,17 @@ @SET_MAKE@ VPATH = @srcdir@ -am__is_gnu_make = test -n '$(MAKEFILE_LIST)' && test -n '$(MAKELEVEL)' +am__is_gnu_make = { \ + if test -z '$(MAKELEVEL)'; then \ + false; \ + elif test -n '$(MAKE_HOST)'; then \ + true; \ + elif test -n '$(MAKE_VERSION)' && test -n '$(CURDIR)'; then \ + true; \ + else \ + false; \ + fi; \ +} am__make_running_with_option = \ case $${target_option-} in \ ?) ;; \ @@ -78,7 +88,6 @@ POST_UNINSTALL = : build_triplet = @build@ host_triplet = @host@ subdir = examples/python/dbus -DIST_COMMON = $(srcdir)/Makefile.in $(srcdir)/Makefile.am ACLOCAL_M4 = $(top_srcdir)/aclocal.m4 am__aclocal_m4_deps = $(top_srcdir)/m4/ax_lib_readline.m4 \ $(top_srcdir)/m4/compiler_warnings.m4 \ @@ -95,6 +104,7 @@ am__aclocal_m4_deps = $(top_srcdir)/m4/ax_lib_readline.m4 \ $(top_srcdir)/m4/vapigen.m4 $(top_srcdir)/configure.ac am__configure_deps = $(am__aclocal_m4_deps) $(CONFIGURE_DEPENDENCIES) \ $(ACLOCAL_M4) +DIST_COMMON = $(srcdir)/Makefile.am $(am__DIST_COMMON) mkinstalldirs = $(install_sh) -d CONFIG_HEADER = $(top_builddir)/config.h CONFIG_CLEAN_FILES = @@ -119,6 +129,7 @@ am__can_run_installinfo = \ *) (install-info --version) >/dev/null 2>&1;; \ esac am__tagged_files = $(HEADERS) $(SOURCES) $(TAGS_FILES) $(LISP) +am__DIST_COMMON = $(srcdir)/Makefile.in DISTFILES = $(DIST_COMMON) $(DIST_SOURCES) $(TEXINFOS) $(EXTRA_DIST) ACLOCAL = @ACLOCAL@ ALL_LINGUAS = @ALL_LINGUAS@ @@ -145,7 +156,6 @@ CXXCPP = @CXXCPP@ CXXDEPMODE = @CXXDEPMODE@ CXXFLAGS = @CXXFLAGS@ CYGPATH_W = @CYGPATH_W@ -DATADIRNAME = @DATADIRNAME@ DBUS_CFLAGS = @DBUS_CFLAGS@ DBUS_GLIB_100_CFLAGS = @DBUS_GLIB_100_CFLAGS@ DBUS_GLIB_100_LIBS = @DBUS_GLIB_100_LIBS@ @@ -180,6 +190,7 @@ GNUTLS_CFLAGS = @GNUTLS_CFLAGS@ GNUTLS_LIBS = @GNUTLS_LIBS@ GREP = @GREP@ GTKDOC_CHECK = @GTKDOC_CHECK@ +GTKDOC_CHECK_PATH = @GTKDOC_CHECK_PATH@ GTKDOC_DEPS_CFLAGS = @GTKDOC_DEPS_CFLAGS@ GTKDOC_DEPS_LIBS = @GTKDOC_DEPS_LIBS@ GTKDOC_MKPDF = @GTKDOC_MKPDF@ @@ -410,7 +421,6 @@ $(srcdir)/Makefile.in: @MAINTAINER_MODE_TRUE@ $(srcdir)/Makefile.am $(am__confi echo ' cd $(top_srcdir) && $(AUTOMAKE) --gnu examples/python/dbus/Makefile'; \ $(am__cd) $(top_srcdir) && \ $(AUTOMAKE) --gnu examples/python/dbus/Makefile -.PRECIOUS: Makefile Makefile: $(srcdir)/Makefile.in $(top_builddir)/config.status @case '$?' in \ *config.status*) \ @@ -585,6 +595,8 @@ uninstall-am: mostlyclean-generic mostlyclean-libtool pdf pdf-am ps ps-am \ tags-am uninstall uninstall-am +.PRECIOUS: Makefile + # Tell versions [3.59,3.63) of GNU make to not export all variables. # Otherwise a system limit (for SysV at least) may be exceeded. diff --git a/examples/python/gi/Makefile.in b/examples/python/gi/Makefile.in index 0f8e3e58..980390a1 100644 --- a/examples/python/gi/Makefile.in +++ b/examples/python/gi/Makefile.in @@ -1,7 +1,7 @@ -# Makefile.in generated by automake 1.13.4 from Makefile.am. +# Makefile.in generated by automake 1.15 from Makefile.am. # @configure_input@ -# Copyright (C) 1994-2013 Free Software Foundation, Inc. +# Copyright (C) 1994-2014 Free Software Foundation, Inc. # This Makefile.in is free software; the Free Software Foundation # gives unlimited permission to copy and/or distribute it, @@ -14,7 +14,17 @@ @SET_MAKE@ VPATH = @srcdir@ -am__is_gnu_make = test -n '$(MAKEFILE_LIST)' && test -n '$(MAKELEVEL)' +am__is_gnu_make = { \ + if test -z '$(MAKELEVEL)'; then \ + false; \ + elif test -n '$(MAKE_HOST)'; then \ + true; \ + elif test -n '$(MAKE_VERSION)' && test -n '$(CURDIR)'; then \ + true; \ + else \ + false; \ + fi; \ +} am__make_running_with_option = \ case $${target_option-} in \ ?) ;; \ @@ -78,7 +88,6 @@ POST_UNINSTALL = : build_triplet = @build@ host_triplet = @host@ subdir = examples/python/gi -DIST_COMMON = $(srcdir)/Makefile.in $(srcdir)/Makefile.am ACLOCAL_M4 = $(top_srcdir)/aclocal.m4 am__aclocal_m4_deps = $(top_srcdir)/m4/ax_lib_readline.m4 \ $(top_srcdir)/m4/compiler_warnings.m4 \ @@ -95,6 +104,7 @@ am__aclocal_m4_deps = $(top_srcdir)/m4/ax_lib_readline.m4 \ $(top_srcdir)/m4/vapigen.m4 $(top_srcdir)/configure.ac am__configure_deps = $(am__aclocal_m4_deps) $(CONFIGURE_DEPENDENCIES) \ $(ACLOCAL_M4) +DIST_COMMON = $(srcdir)/Makefile.am $(am__DIST_COMMON) mkinstalldirs = $(install_sh) -d CONFIG_HEADER = $(top_builddir)/config.h CONFIG_CLEAN_FILES = @@ -119,6 +129,7 @@ am__can_run_installinfo = \ *) (install-info --version) >/dev/null 2>&1;; \ esac am__tagged_files = $(HEADERS) $(SOURCES) $(TAGS_FILES) $(LISP) +am__DIST_COMMON = $(srcdir)/Makefile.in DISTFILES = $(DIST_COMMON) $(DIST_SOURCES) $(TEXINFOS) $(EXTRA_DIST) ACLOCAL = @ACLOCAL@ ALL_LINGUAS = @ALL_LINGUAS@ @@ -145,7 +156,6 @@ CXXCPP = @CXXCPP@ CXXDEPMODE = @CXXDEPMODE@ CXXFLAGS = @CXXFLAGS@ CYGPATH_W = @CYGPATH_W@ -DATADIRNAME = @DATADIRNAME@ DBUS_CFLAGS = @DBUS_CFLAGS@ DBUS_GLIB_100_CFLAGS = @DBUS_GLIB_100_CFLAGS@ DBUS_GLIB_100_LIBS = @DBUS_GLIB_100_LIBS@ @@ -180,6 +190,7 @@ GNUTLS_CFLAGS = @GNUTLS_CFLAGS@ GNUTLS_LIBS = @GNUTLS_LIBS@ GREP = @GREP@ GTKDOC_CHECK = @GTKDOC_CHECK@ +GTKDOC_CHECK_PATH = @GTKDOC_CHECK_PATH@ GTKDOC_DEPS_CFLAGS = @GTKDOC_DEPS_CFLAGS@ GTKDOC_DEPS_LIBS = @GTKDOC_DEPS_LIBS@ GTKDOC_MKPDF = @GTKDOC_MKPDF@ @@ -405,7 +416,6 @@ $(srcdir)/Makefile.in: @MAINTAINER_MODE_TRUE@ $(srcdir)/Makefile.am $(am__confi echo ' cd $(top_srcdir) && $(AUTOMAKE) --gnu examples/python/gi/Makefile'; \ $(am__cd) $(top_srcdir) && \ $(AUTOMAKE) --gnu examples/python/gi/Makefile -.PRECIOUS: Makefile Makefile: $(srcdir)/Makefile.in $(top_builddir)/config.status @case '$?' in \ *config.status*) \ @@ -580,6 +590,8 @@ uninstall-am: mostlyclean-generic mostlyclean-libtool pdf pdf-am ps ps-am \ tags-am uninstall uninstall-am +.PRECIOUS: Makefile + # Tell versions [3.59,3.63) of GNU make to not export all variables. # Otherwise a system limit (for SysV at least) may be exceeded. diff --git a/examples/ruby/Makefile.in b/examples/ruby/Makefile.in index fa8d7c73..626b5ed3 100644 --- a/examples/ruby/Makefile.in +++ b/examples/ruby/Makefile.in @@ -1,7 +1,7 @@ -# Makefile.in generated by automake 1.13.4 from Makefile.am. +# Makefile.in generated by automake 1.15 from Makefile.am. # @configure_input@ -# Copyright (C) 1994-2013 Free Software Foundation, Inc. +# Copyright (C) 1994-2014 Free Software Foundation, Inc. # This Makefile.in is free software; the Free Software Foundation # gives unlimited permission to copy and/or distribute it, @@ -14,7 +14,17 @@ @SET_MAKE@ VPATH = @srcdir@ -am__is_gnu_make = test -n '$(MAKEFILE_LIST)' && test -n '$(MAKELEVEL)' +am__is_gnu_make = { \ + if test -z '$(MAKELEVEL)'; then \ + false; \ + elif test -n '$(MAKE_HOST)'; then \ + true; \ + elif test -n '$(MAKE_VERSION)' && test -n '$(CURDIR)'; then \ + true; \ + else \ + false; \ + fi; \ +} am__make_running_with_option = \ case $${target_option-} in \ ?) ;; \ @@ -78,7 +88,6 @@ POST_UNINSTALL = : build_triplet = @build@ host_triplet = @host@ subdir = examples/ruby -DIST_COMMON = $(srcdir)/Makefile.in $(srcdir)/Makefile.am ACLOCAL_M4 = $(top_srcdir)/aclocal.m4 am__aclocal_m4_deps = $(top_srcdir)/m4/ax_lib_readline.m4 \ $(top_srcdir)/m4/compiler_warnings.m4 \ @@ -95,6 +104,7 @@ am__aclocal_m4_deps = $(top_srcdir)/m4/ax_lib_readline.m4 \ $(top_srcdir)/m4/vapigen.m4 $(top_srcdir)/configure.ac am__configure_deps = $(am__aclocal_m4_deps) $(CONFIGURE_DEPENDENCIES) \ $(ACLOCAL_M4) +DIST_COMMON = $(srcdir)/Makefile.am $(am__DIST_COMMON) mkinstalldirs = $(install_sh) -d CONFIG_HEADER = $(top_builddir)/config.h CONFIG_CLEAN_FILES = @@ -119,6 +129,7 @@ am__can_run_installinfo = \ *) (install-info --version) >/dev/null 2>&1;; \ esac am__tagged_files = $(HEADERS) $(SOURCES) $(TAGS_FILES) $(LISP) +am__DIST_COMMON = $(srcdir)/Makefile.in DISTFILES = $(DIST_COMMON) $(DIST_SOURCES) $(TEXINFOS) $(EXTRA_DIST) ACLOCAL = @ACLOCAL@ ALL_LINGUAS = @ALL_LINGUAS@ @@ -145,7 +156,6 @@ CXXCPP = @CXXCPP@ CXXDEPMODE = @CXXDEPMODE@ CXXFLAGS = @CXXFLAGS@ CYGPATH_W = @CYGPATH_W@ -DATADIRNAME = @DATADIRNAME@ DBUS_CFLAGS = @DBUS_CFLAGS@ DBUS_GLIB_100_CFLAGS = @DBUS_GLIB_100_CFLAGS@ DBUS_GLIB_100_LIBS = @DBUS_GLIB_100_LIBS@ @@ -180,6 +190,7 @@ GNUTLS_CFLAGS = @GNUTLS_CFLAGS@ GNUTLS_LIBS = @GNUTLS_LIBS@ GREP = @GREP@ GTKDOC_CHECK = @GTKDOC_CHECK@ +GTKDOC_CHECK_PATH = @GTKDOC_CHECK_PATH@ GTKDOC_DEPS_CFLAGS = @GTKDOC_DEPS_CFLAGS@ GTKDOC_DEPS_LIBS = @GTKDOC_DEPS_LIBS@ GTKDOC_MKPDF = @GTKDOC_MKPDF@ @@ -400,7 +411,6 @@ $(srcdir)/Makefile.in: @MAINTAINER_MODE_TRUE@ $(srcdir)/Makefile.am $(am__confi echo ' cd $(top_srcdir) && $(AUTOMAKE) --gnu examples/ruby/Makefile'; \ $(am__cd) $(top_srcdir) && \ $(AUTOMAKE) --gnu examples/ruby/Makefile -.PRECIOUS: Makefile Makefile: $(srcdir)/Makefile.in $(top_builddir)/config.status @case '$?' in \ *config.status*) \ @@ -575,6 +585,8 @@ uninstall-am: mostlyclean-generic mostlyclean-libtool pdf pdf-am ps ps-am \ tags-am uninstall uninstall-am +.PRECIOUS: Makefile + # Tell versions [3.59,3.63) of GNU make to not export all variables. # Otherwise a system limit (for SysV at least) may be exceeded. diff --git a/examples/shell/Makefile.in b/examples/shell/Makefile.in index 327b4949..f6f09052 100644 --- a/examples/shell/Makefile.in +++ b/examples/shell/Makefile.in @@ -1,7 +1,7 @@ -# Makefile.in generated by automake 1.13.4 from Makefile.am. +# Makefile.in generated by automake 1.15 from Makefile.am. # @configure_input@ -# Copyright (C) 1994-2013 Free Software Foundation, Inc. +# Copyright (C) 1994-2014 Free Software Foundation, Inc. # This Makefile.in is free software; the Free Software Foundation # gives unlimited permission to copy and/or distribute it, @@ -14,7 +14,17 @@ @SET_MAKE@ VPATH = @srcdir@ -am__is_gnu_make = test -n '$(MAKEFILE_LIST)' && test -n '$(MAKELEVEL)' +am__is_gnu_make = { \ + if test -z '$(MAKELEVEL)'; then \ + false; \ + elif test -n '$(MAKE_HOST)'; then \ + true; \ + elif test -n '$(MAKE_VERSION)' && test -n '$(CURDIR)'; then \ + true; \ + else \ + false; \ + fi; \ +} am__make_running_with_option = \ case $${target_option-} in \ ?) ;; \ @@ -78,7 +88,6 @@ POST_UNINSTALL = : build_triplet = @build@ host_triplet = @host@ subdir = examples/shell -DIST_COMMON = $(srcdir)/Makefile.in $(srcdir)/Makefile.am ACLOCAL_M4 = $(top_srcdir)/aclocal.m4 am__aclocal_m4_deps = $(top_srcdir)/m4/ax_lib_readline.m4 \ $(top_srcdir)/m4/compiler_warnings.m4 \ @@ -95,6 +104,7 @@ am__aclocal_m4_deps = $(top_srcdir)/m4/ax_lib_readline.m4 \ $(top_srcdir)/m4/vapigen.m4 $(top_srcdir)/configure.ac am__configure_deps = $(am__aclocal_m4_deps) $(CONFIGURE_DEPENDENCIES) \ $(ACLOCAL_M4) +DIST_COMMON = $(srcdir)/Makefile.am $(am__DIST_COMMON) mkinstalldirs = $(install_sh) -d CONFIG_HEADER = $(top_builddir)/config.h CONFIG_CLEAN_FILES = @@ -119,6 +129,7 @@ am__can_run_installinfo = \ *) (install-info --version) >/dev/null 2>&1;; \ esac am__tagged_files = $(HEADERS) $(SOURCES) $(TAGS_FILES) $(LISP) +am__DIST_COMMON = $(srcdir)/Makefile.in DISTFILES = $(DIST_COMMON) $(DIST_SOURCES) $(TEXINFOS) $(EXTRA_DIST) ACLOCAL = @ACLOCAL@ ALL_LINGUAS = @ALL_LINGUAS@ @@ -145,7 +156,6 @@ CXXCPP = @CXXCPP@ CXXDEPMODE = @CXXDEPMODE@ CXXFLAGS = @CXXFLAGS@ CYGPATH_W = @CYGPATH_W@ -DATADIRNAME = @DATADIRNAME@ DBUS_CFLAGS = @DBUS_CFLAGS@ DBUS_GLIB_100_CFLAGS = @DBUS_GLIB_100_CFLAGS@ DBUS_GLIB_100_LIBS = @DBUS_GLIB_100_LIBS@ @@ -180,6 +190,7 @@ GNUTLS_CFLAGS = @GNUTLS_CFLAGS@ GNUTLS_LIBS = @GNUTLS_LIBS@ GREP = @GREP@ GTKDOC_CHECK = @GTKDOC_CHECK@ +GTKDOC_CHECK_PATH = @GTKDOC_CHECK_PATH@ GTKDOC_DEPS_CFLAGS = @GTKDOC_DEPS_CFLAGS@ GTKDOC_DEPS_LIBS = @GTKDOC_DEPS_LIBS@ GTKDOC_MKPDF = @GTKDOC_MKPDF@ @@ -402,7 +413,6 @@ $(srcdir)/Makefile.in: @MAINTAINER_MODE_TRUE@ $(srcdir)/Makefile.am $(am__confi echo ' cd $(top_srcdir) && $(AUTOMAKE) --gnu examples/shell/Makefile'; \ $(am__cd) $(top_srcdir) && \ $(AUTOMAKE) --gnu examples/shell/Makefile -.PRECIOUS: Makefile Makefile: $(srcdir)/Makefile.in $(top_builddir)/config.status @case '$?' in \ *config.status*) \ @@ -577,6 +587,8 @@ uninstall-am: mostlyclean-generic mostlyclean-libtool pdf pdf-am ps ps-am \ tags-am uninstall uninstall-am +.PRECIOUS: Makefile + # Tell versions [3.59,3.63) of GNU make to not export all variables. # Otherwise a system limit (for SysV at least) may be exceeded. diff --git a/examples/shell/active-wifi.sh b/examples/shell/active-wifi.sh index 1c9466b7..2ff54190 100755 --- a/examples/shell/active-wifi.sh +++ b/examples/shell/active-wifi.sh @@ -76,7 +76,7 @@ show_active_ssids() BSSID=`get_property $ACTIVE_AP $ACCESS_POINT_IFACE "HwAddress"` echo "Device '$INTERFACE' is connected to '$SSID' (BSSID=$BSSID)" else - echo "No active AP on device '$INTERFACE'" + echo "No active AP on device '$INTERFACE'" >&2 fi fi done diff --git a/examples/shell/disconnect-device.sh b/examples/shell/disconnect-device.sh index 045d64d7..e8af42fc 100755 --- a/examples/shell/disconnect-device.sh +++ b/examples/shell/disconnect-device.sh @@ -61,7 +61,7 @@ disconnect_device () fi done - echo "Device with interface '$1' not found." + echo "Device with interface '$1' not found." >&2 return 1 } @@ -70,7 +70,7 @@ disconnect_device () if [ ! -n "$1" ]; then echo "Usage: `basename $0` " exit 2 -fi +fi # disconnect device disconnect_device $1 diff --git a/gtk-doc.make b/gtk-doc.make index 3b5bed0e..dd319930 100644 --- a/gtk-doc.make +++ b/gtk-doc.make @@ -49,9 +49,13 @@ REPORT_FILES = \ $(DOC_MODULE)-undeclared.txt \ $(DOC_MODULE)-unused.txt -CLEANFILES = $(SCANOBJ_FILES) $(REPORT_FILES) $(DOC_STAMPS) +gtkdoc-check.test: Makefile + $(AM_V_GEN)echo "#!/bin/sh -e" > $@; \ + echo "$(GTKDOC_CHECK_PATH) || exit 1" >> $@; \ + chmod +x $@ + +CLEANFILES = $(SCANOBJ_FILES) $(REPORT_FILES) $(DOC_STAMPS) gtkdoc-check.test -if ENABLE_GTK_DOC if GTK_DOC_BUILD_HTML HTML_BUILD_STAMP=html-build.stamp else @@ -63,9 +67,11 @@ else PDF_BUILD_STAMP= endif -all-local: $(HTML_BUILD_STAMP) $(PDF_BUILD_STAMP) -else -all-local: +all-gtk-doc: $(HTML_BUILD_STAMP) $(PDF_BUILD_STAMP) +.PHONY: all-gtk-doc + +if ENABLE_GTK_DOC +all-local: all-gtk-doc endif docs: $(HTML_BUILD_STAMP) $(PDF_BUILD_STAMP) @@ -83,12 +89,14 @@ setup-build.stamp: files=`echo $(SETUP_FILES) $(expand_content_files) $(DOC_MODULE).types`; \ if test "x$$files" != "x" ; then \ for file in $$files ; do \ + destdir=`dirname $(abs_builddir)/$$file` ;\ + test -d "$$destdir" || mkdir -p "$$destdir"; \ test -f $(abs_srcdir)/$$file && \ - cp -pu $(abs_srcdir)/$$file $(abs_builddir)/$$file || true; \ + cp -pf $(abs_srcdir)/$$file $(abs_builddir)/$$file || true; \ done; \ fi; \ test -d $(abs_srcdir)/tmpl && \ - { cp -rp $(abs_srcdir)/tmpl $(abs_builddir)/; \ + { cp -pR $(abs_srcdir)/tmpl $(abs_builddir)/; \ chmod -R u+w $(abs_builddir)/tmpl; } \ fi $(AM_V_at)touch setup-build.stamp @@ -103,7 +111,7 @@ GTK_DOC_V_INTROSPECT=$(GTK_DOC_V_INTROSPECT_$(V)) GTK_DOC_V_INTROSPECT_=$(GTK_DOC_V_INTROSPECT_$(AM_DEFAULT_VERBOSITY)) GTK_DOC_V_INTROSPECT_0=@echo " DOC Introspecting gobjects"; -scan-build.stamp: $(HFILE_GLOB) $(CFILE_GLOB) +scan-build.stamp: setup-build.stamp $(HFILE_GLOB) $(CFILE_GLOB) $(GTK_DOC_V_SCAN)_source_dir='' ; \ for i in $(DOC_SOURCE_DIR) ; do \ _source_dir="$${_source_dir} --source-dir=$$i" ; \ @@ -139,7 +147,7 @@ tmpl-build.stamp: setup-build.stamp $(DOC_MODULE)-decl.txt $(SCANOBJ_FILES) $(DO $(GTK_DOC_V_TMPL)gtkdoc-mktmpl --module=$(DOC_MODULE) $(MKTMPL_OPTIONS) $(AM_V_at)if test "$(abs_srcdir)" != "$(abs_builddir)" ; then \ if test -w $(abs_srcdir) ; then \ - cp -rp $(abs_builddir)/tmpl $(abs_srcdir)/; \ + cp -pR $(abs_builddir)/tmpl $(abs_srcdir)/; \ fi \ fi $(AM_V_at)touch tmpl-build.stamp @@ -157,7 +165,7 @@ GTK_DOC_V_XML_=$(GTK_DOC_V_XML_$(AM_DEFAULT_VERBOSITY)) GTK_DOC_V_XML_0=@echo " DOC Building XML"; sgml-build.stamp: tmpl.stamp $(DOC_MODULE)-sections.txt $(srcdir)/tmpl/*.sgml $(expand_content_files) - $(GTK_DOC_V_XML)-chmod -R u+w $(srcdir) && _source_dir='' ; \ + -$(GTK_DOC_V_XML)chmod -R u+w $(srcdir) && _source_dir='' ; \ for i in $(DOC_SOURCE_DIR) ; do \ _source_dir="$${_source_dir} --source-dir=$$i" ; \ done ; \ @@ -235,6 +243,9 @@ pdf-build.stamp: sgml.stamp $(DOC_MAIN_SGML_FILE) $(content_files) clean-local: @rm -f *~ *.bak @rm -rf .libs + @if echo $(SCAN_OPTIONS) | grep -q "\-\-rebuild-types" ; then \ + rm -f $(DOC_MODULE).types; \ + fi distclean-local: @rm -rf xml html $(REPORT_FILES) $(DOC_MODULE).pdf \ @@ -280,15 +291,17 @@ uninstall-local: # # Require gtk-doc when making dist # -if ENABLE_GTK_DOC +if HAVE_GTK_DOC dist-check-gtkdoc: docs else dist-check-gtkdoc: - @echo "*** gtk-doc must be installed and enabled in order to make dist" + @echo "*** gtk-doc is needed to run 'make dist'. ***" + @echo "*** gtk-doc was not found when 'configure' ran. ***" + @echo "*** please install gtk-doc and rerun 'configure'. ***" @false endif -dist-hook: dist-check-gtkdoc dist-hook-local +dist-hook: dist-check-gtkdoc all-gtk-doc dist-hook-local @mkdir $(distdir)/tmpl @mkdir $(distdir)/html @-cp ./tmpl/*.sgml $(distdir)/tmpl diff --git a/include/Makefile.in b/include/Makefile.in index 07ade2fb..016710b6 100644 --- a/include/Makefile.in +++ b/include/Makefile.in @@ -1,7 +1,7 @@ -# Makefile.in generated by automake 1.13.4 from Makefile.am. +# Makefile.in generated by automake 1.15 from Makefile.am. # @configure_input@ -# Copyright (C) 1994-2013 Free Software Foundation, Inc. +# Copyright (C) 1994-2014 Free Software Foundation, Inc. # This Makefile.in is free software; the Free Software Foundation # gives unlimited permission to copy and/or distribute it, @@ -14,7 +14,17 @@ @SET_MAKE@ VPATH = @srcdir@ -am__is_gnu_make = test -n '$(MAKEFILE_LIST)' && test -n '$(MAKELEVEL)' +am__is_gnu_make = { \ + if test -z '$(MAKELEVEL)'; then \ + false; \ + elif test -n '$(MAKE_HOST)'; then \ + true; \ + elif test -n '$(MAKE_VERSION)' && test -n '$(CURDIR)'; then \ + true; \ + else \ + false; \ + fi; \ +} am__make_running_with_option = \ case $${target_option-} in \ ?) ;; \ @@ -78,7 +88,6 @@ POST_UNINSTALL = : build_triplet = @build@ host_triplet = @host@ subdir = include -DIST_COMMON = $(srcdir)/Makefile.in $(srcdir)/Makefile.am ACLOCAL_M4 = $(top_srcdir)/aclocal.m4 am__aclocal_m4_deps = $(top_srcdir)/m4/ax_lib_readline.m4 \ $(top_srcdir)/m4/compiler_warnings.m4 \ @@ -95,6 +104,7 @@ am__aclocal_m4_deps = $(top_srcdir)/m4/ax_lib_readline.m4 \ $(top_srcdir)/m4/vapigen.m4 $(top_srcdir)/configure.ac am__configure_deps = $(am__aclocal_m4_deps) $(CONFIGURE_DEPENDENCIES) \ $(ACLOCAL_M4) +DIST_COMMON = $(srcdir)/Makefile.am $(am__DIST_COMMON) mkinstalldirs = $(install_sh) -d CONFIG_HEADER = $(top_builddir)/config.h CONFIG_CLEAN_FILES = @@ -119,6 +129,7 @@ am__can_run_installinfo = \ *) (install-info --version) >/dev/null 2>&1;; \ esac am__tagged_files = $(HEADERS) $(SOURCES) $(TAGS_FILES) $(LISP) +am__DIST_COMMON = $(srcdir)/Makefile.in DISTFILES = $(DIST_COMMON) $(DIST_SOURCES) $(TEXINFOS) $(EXTRA_DIST) ACLOCAL = @ACLOCAL@ ALL_LINGUAS = @ALL_LINGUAS@ @@ -145,7 +156,6 @@ CXXCPP = @CXXCPP@ CXXDEPMODE = @CXXDEPMODE@ CXXFLAGS = @CXXFLAGS@ CYGPATH_W = @CYGPATH_W@ -DATADIRNAME = @DATADIRNAME@ DBUS_CFLAGS = @DBUS_CFLAGS@ DBUS_GLIB_100_CFLAGS = @DBUS_GLIB_100_CFLAGS@ DBUS_GLIB_100_LIBS = @DBUS_GLIB_100_LIBS@ @@ -180,6 +190,7 @@ GNUTLS_CFLAGS = @GNUTLS_CFLAGS@ GNUTLS_LIBS = @GNUTLS_LIBS@ GREP = @GREP@ GTKDOC_CHECK = @GTKDOC_CHECK@ +GTKDOC_CHECK_PATH = @GTKDOC_CHECK_PATH@ GTKDOC_DEPS_CFLAGS = @GTKDOC_DEPS_CFLAGS@ GTKDOC_DEPS_LIBS = @GTKDOC_DEPS_LIBS@ GTKDOC_MKPDF = @GTKDOC_MKPDF@ @@ -404,7 +415,6 @@ $(srcdir)/Makefile.in: @MAINTAINER_MODE_TRUE@ $(srcdir)/Makefile.am $(am__confi echo ' cd $(top_srcdir) && $(AUTOMAKE) --gnu include/Makefile'; \ $(am__cd) $(top_srcdir) && \ $(AUTOMAKE) --gnu include/Makefile -.PRECIOUS: Makefile Makefile: $(srcdir)/Makefile.in $(top_builddir)/config.status @case '$?' in \ *config.status*) \ @@ -580,6 +590,8 @@ uninstall-am: mostlyclean-generic mostlyclean-libtool pdf pdf-am ps ps-am \ tags-am uninstall uninstall-am +.PRECIOUS: Makefile + # Tell versions [3.59,3.63) of GNU make to not export all variables. # Otherwise a system limit (for SysV at least) may be exceeded. diff --git a/include/gsystem-local-alloc.h b/include/gsystem-local-alloc.h index 68b12274..51b62519 100644 --- a/include/gsystem-local-alloc.h +++ b/include/gsystem-local-alloc.h @@ -43,22 +43,6 @@ G_BEGIN_DECLS * 1) Take a pointer to the location (typically itself a pointer). * 2) Provide %NULL-safety where it doesn't exist already (e.g. g_object_unref) */ -GS_DEFINE_CLEANUP_FUNCTION0(GArray*, gs_local_array_unref, g_array_unref) -GS_DEFINE_CLEANUP_FUNCTION0(GBytes*, gs_local_bytes_unref, g_bytes_unref) -GS_DEFINE_CLEANUP_FUNCTION0(GChecksum*, gs_local_checksum_free, g_checksum_free) -GS_DEFINE_CLEANUP_FUNCTION0(GKeyFile*, gs_local_keyfile_unref, g_key_file_unref) -GS_DEFINE_CLEANUP_FUNCTION0(GError*, gs_local_free_error, g_error_free) -GS_DEFINE_CLEANUP_FUNCTION0(GHashTable*, gs_local_hashtable_unref, g_hash_table_unref) -GS_DEFINE_CLEANUP_FUNCTION(GList*, gs_local_free_list, g_list_free) -GS_DEFINE_CLEANUP_FUNCTION(GSList*, gs_local_free_slist, g_slist_free) -GS_DEFINE_CLEANUP_FUNCTION0(GObject*, gs_local_obj_unref, g_object_unref) -GS_DEFINE_CLEANUP_FUNCTION0(GPtrArray*, gs_local_ptrarray_unref, g_ptr_array_unref) -GS_DEFINE_CLEANUP_FUNCTION0(GVariant*, gs_local_variant_unref, g_variant_unref) -GS_DEFINE_CLEANUP_FUNCTION0(GVariantBuilder*, gs_local_variant_builder_unref, g_variant_builder_unref) -GS_DEFINE_CLEANUP_FUNCTION0(GVariantIter*, gs_local_variant_iter_free, g_variant_iter_free) - -GS_DEFINE_CLEANUP_FUNCTION(char**, gs_local_strfreev, g_strfreev) -GS_DEFINE_CLEANUP_FUNCTION(void*, gs_local_free, g_free) /** * gs_free: @@ -66,6 +50,7 @@ GS_DEFINE_CLEANUP_FUNCTION(void*, gs_local_free, g_free) * Call g_free() on a variable location when it goes out of scope. */ #define gs_free __attribute__ ((cleanup(gs_local_free))) +GS_DEFINE_CLEANUP_FUNCTION(void*, gs_local_free, g_free) /** * gs_unref_object: @@ -75,6 +60,7 @@ GS_DEFINE_CLEANUP_FUNCTION(void*, gs_local_free, g_free) * %NULL. */ #define gs_unref_object __attribute__ ((cleanup(gs_local_obj_unref))) +GS_DEFINE_CLEANUP_FUNCTION0(GObject*, gs_local_obj_unref, g_object_unref) /** * gs_unref_variant: @@ -84,6 +70,7 @@ GS_DEFINE_CLEANUP_FUNCTION(void*, gs_local_free, g_free) * %NULL. */ #define gs_unref_variant __attribute__ ((cleanup(gs_local_variant_unref))) +GS_DEFINE_CLEANUP_FUNCTION0(GVariant*, gs_local_variant_unref, g_variant_unref) /** * gs_free_variant_iter: @@ -92,6 +79,7 @@ GS_DEFINE_CLEANUP_FUNCTION(void*, gs_local_free, g_free) * scope. */ #define gs_free_variant_iter __attribute__ ((cleanup(gs_local_variant_iter_free))) +GS_DEFINE_CLEANUP_FUNCTION0(GVariantIter*, gs_local_variant_iter_free, g_variant_iter_free) /** * gs_free_variant_builder: @@ -100,6 +88,7 @@ GS_DEFINE_CLEANUP_FUNCTION(void*, gs_local_free, g_free) * scope. */ #define gs_unref_variant_builder __attribute__ ((cleanup(gs_local_variant_builder_unref))) +GS_DEFINE_CLEANUP_FUNCTION0(GVariantBuilder*, gs_local_variant_builder_unref, g_variant_builder_unref) /** * gs_unref_array: @@ -110,6 +99,7 @@ GS_DEFINE_CLEANUP_FUNCTION(void*, gs_local_free, g_free) */ #define gs_unref_array __attribute__ ((cleanup(gs_local_array_unref))) +GS_DEFINE_CLEANUP_FUNCTION0(GArray*, gs_local_array_unref, g_array_unref) /** * gs_unref_ptrarray: @@ -120,6 +110,7 @@ GS_DEFINE_CLEANUP_FUNCTION(void*, gs_local_free, g_free) */ #define gs_unref_ptrarray __attribute__ ((cleanup(gs_local_ptrarray_unref))) +GS_DEFINE_CLEANUP_FUNCTION0(GPtrArray*, gs_local_ptrarray_unref, g_ptr_array_unref) /** * gs_unref_hashtable: @@ -129,6 +120,7 @@ GS_DEFINE_CLEANUP_FUNCTION(void*, gs_local_free, g_free) * be %NULL. */ #define gs_unref_hashtable __attribute__ ((cleanup(gs_local_hashtable_unref))) +GS_DEFINE_CLEANUP_FUNCTION0(GHashTable*, gs_local_hashtable_unref, g_hash_table_unref) /** * gs_free_list: @@ -137,6 +129,7 @@ GS_DEFINE_CLEANUP_FUNCTION(void*, gs_local_free, g_free) * of scope. */ #define gs_free_list __attribute__ ((cleanup(gs_local_free_list))) +GS_DEFINE_CLEANUP_FUNCTION(GList*, gs_local_free_list, g_list_free) /** * gs_free_slist: @@ -145,6 +138,7 @@ GS_DEFINE_CLEANUP_FUNCTION(void*, gs_local_free, g_free) * of scope. */ #define gs_free_slist __attribute__ ((cleanup(gs_local_free_slist))) +GS_DEFINE_CLEANUP_FUNCTION(GSList*, gs_local_free_slist, g_slist_free) /** * gs_free_checksum: @@ -154,6 +148,7 @@ GS_DEFINE_CLEANUP_FUNCTION(void*, gs_local_free, g_free) * be %NULL. */ #define gs_free_checksum __attribute__ ((cleanup(gs_local_checksum_free))) +GS_DEFINE_CLEANUP_FUNCTION0(GChecksum*, gs_local_checksum_free, g_checksum_free) /** * gs_unref_bytes: @@ -163,6 +158,7 @@ GS_DEFINE_CLEANUP_FUNCTION(void*, gs_local_free, g_free) * be %NULL. */ #define gs_unref_bytes __attribute__ ((cleanup(gs_local_bytes_unref))) +GS_DEFINE_CLEANUP_FUNCTION0(GBytes*, gs_local_bytes_unref, g_bytes_unref) /** * gs_strfreev: @@ -170,6 +166,7 @@ GS_DEFINE_CLEANUP_FUNCTION(void*, gs_local_free, g_free) * Call g_strfreev() on a variable location when it goes out of scope. */ #define gs_strfreev __attribute__ ((cleanup(gs_local_strfreev))) +GS_DEFINE_CLEANUP_FUNCTION(char**, gs_local_strfreev, g_strfreev) /** * gs_free_error: @@ -177,6 +174,34 @@ GS_DEFINE_CLEANUP_FUNCTION(void*, gs_local_free, g_free) * Call g_error_free() on a variable location when it goes out of scope. */ #define gs_free_error __attribute__ ((cleanup(gs_local_free_error))) +GS_DEFINE_CLEANUP_FUNCTION0(GError*, gs_local_free_error, g_error_free) + +/** + * gs_unref_keyfile: + * + * Call g_key_file_unref() on a variable location when it goes out of scope. + */ +#define gs_unref_keyfile __attribute__ ((cleanup(gs_local_keyfile_unref))) +GS_DEFINE_CLEANUP_FUNCTION0(GKeyFile*, gs_local_keyfile_unref, g_key_file_unref) + +static inline void +gs_cleanup_close_fdp (int *fdp) +{ + int fd; + + g_assert (fdp); + + fd = *fdp; + if (fd != -1) + (void) close (fd); +} + +/** + * gs_fd_close: + * + * Call close() on a variable location when it goes out of scope. + */ +#define gs_fd_close __attribute__((cleanup(gs_cleanup_close_fdp))) G_END_DECLS diff --git a/include/nm-test-utils.h b/include/nm-test-utils.h index dcfa46eb..5f83d09d 100644 --- a/include/nm-test-utils.h +++ b/include/nm-test-utils.h @@ -21,6 +21,66 @@ #ifndef __NM_TEST_UTILS_H__ #define __NM_TEST_UTILS_H__ +/******************************************************************************* + * HOWTO run tests. + * + * Our tests (make check) include this header-only file nm-test-utils.h. + * + * Logging: + * In tests, nm-logging redirects to glib logging. By default, glib suppresses all debug + * messages unless you set G_MESSAGES_DEBUG. To enable debug logging, you can explicitly set + * G_MESSAGES_DEBUG. Otherwise, nm-test will set G_MESSAGES_DEBUG=all in debug mode (see below). + * For nm-logging, you can configure the log-level and domains via NMTST_DEBUG environment + * variable. + * + * Assert-logging: + * Some tests assert against logged messages (g_test_expect_message()). + * By specifying no-expect-message in NMTST_DEBUG, you can disable assert logging + * and g_test_assert_expected_messages() will not fail. + * + * NMTST_SEED_RAND environment variable: + * Tests that use random numbers from nmtst_get_rand() get seeded randomly at each start. + * You can specify the seed by setting NMTST_SEED_RAND. Also, tests will print the seed + * to stdout, so that you know the choosen seed. + * + * + * NMTST_DEBUG environment variable: + * + * "debug", "no-debug": when at test is run in debug mode, it might behave differently, + * depending on the test. See nmtst_is_debug(). + * Known differences: + * - a test might leave the logging level unspecified. In this case, running in + * debug mode, will turn on DEBUG logging, otherwise WARN logging only. + * - if G_MESSAGES_DEBUG is unset, nm-test will set G_MESSAGES_DEBUG=all + * for tests that don't do assert-logging. + * Debug mode is determined as follows (highest priority first): + * - command line option --debug/--no-debug + * - NMTST_DEBUG=debug/no-debug + * - setting NMTST_DEBUG implies debugging turned on + * - g_test_verbose() + * + * "no-expect-message": for tests that would assert against log messages, disable + * those asserts. + * + * "log-level=LEVEL", "log-domains=DOMAIN": reset the log level and domain for tests. + * It only has an effect for nm-logging messages. + * This has no effect if the test asserts against logging (unless no-expect-message), + * otherwise, changing the logging would break tests. + * If you set the level to DEBUG or TRACE, it also sets G_MESSAGES_DEBUG=all (unless + * in assert-logging mode and unless G_MESSAGES_DEBUG is already defined). + * + * "sudo-cmd=PATH": when running root tests as normal user, the test will execute + * itself by invoking sudo at PATH. + * For example + * NMTST_DEBUG="sudo-cmd=$PWD/tools/test-sudo-wrapper.sh" make -C src/platform/tests/ check + * + * "slow|quick|thorough": enable/disable long-running tests. This sets nmtst_test_quick(). + * Whether long-running tests are enabled is determined as follows (highest priority first): + * - specifying the value in NMTST_DEBUG has highest priority + * - respect g_test_quick(), if the command line contains '-mslow', '-mquick', '-mthorough'. + * - use compile time default + * + *******************************************************************************/ #include #include @@ -32,10 +92,14 @@ #include #include "nm-utils.h" +#include "nm-utils-internal.h" #include "nm-glib-compat.h" #include "gsystem-local-alloc.h" +/* Analog to EXIT_SUCCESS and EXIT_FAILURE. */ +#define EXIT_SKIP (77) + /*******************************************************************************/ /* general purpose functions that have no dependency on other nmtst functions */ @@ -68,6 +132,7 @@ struct __nmtst_internal gboolean is_debug; gboolean assert_logging; gboolean no_expect_message; + gboolean test_quick; char *sudo_cmd; char **orig_argv; }; @@ -75,7 +140,15 @@ struct __nmtst_internal extern struct __nmtst_internal __nmtst_internal; #define NMTST_DEFINE() \ - struct __nmtst_internal __nmtst_internal = { 0 }; +struct __nmtst_internal __nmtst_internal = { 0 }; \ +\ +__attribute__ ((destructor)) static void \ +_nmtst_exit (void) \ +{ \ + __nmtst_internal.assert_logging = FALSE; \ + g_test_assert_expected_messages (); \ + nmtst_free (); \ +} inline static gboolean @@ -84,13 +157,13 @@ nmtst_initialized (void) return !!__nmtst_internal.rand0; } -#define __NMTST_LOG(cmd, fmt, ...) \ +#define __NMTST_LOG(cmd, ...) \ G_STMT_START { \ g_assert (nmtst_initialized ()); \ if (!__nmtst_internal.assert_logging || __nmtst_internal.no_expect_message) { \ - cmd (fmt, __VA_ARGS__); \ + cmd (__VA_ARGS__); \ } else { \ - printf (fmt "\n", __VA_ARGS__); \ + printf (_NM_UTILS_MACRO_FIRST (__VA_ARGS__) "\n" _NM_UTILS_MACRO_REST (__VA_ARGS__)); \ } \ } G_STMT_END @@ -161,9 +234,8 @@ nmtst_free (void) } inline static void -__nmtst_init (int *argc, char ***argv, gboolean assert_logging, const char *log_level, const char *log_domains) +__nmtst_init (int *argc, char ***argv, gboolean assert_logging, const char *log_level, const char *log_domains, gboolean *out_set_logging) { - static gsize atexit_registered = 0; const char *nmtst_debug; gboolean is_debug = FALSE; char *c_log_level = NULL, *c_log_domains = NULL; @@ -171,6 +243,14 @@ __nmtst_init (int *argc, char ***argv, gboolean assert_logging, const char *log_ GArray *debug_messages = g_array_new (TRUE, FALSE, sizeof (char *)); int i; gboolean no_expect_message = FALSE; + gboolean _out_set_logging; + gboolean test_quick = FALSE; + gboolean test_quick_set = FALSE; + gboolean test_quick_argv = FALSE; + + if (!out_set_logging) + out_set_logging = &_out_set_logging; + *out_set_logging = FALSE; g_assert (!nmtst_initialized ()); @@ -231,6 +311,12 @@ __nmtst_init (int *argc, char ***argv, gboolean assert_logging, const char *log_ sudo_cmd = g_strdup (&debug[strlen ("sudo-cmd=")]); } else if (!g_ascii_strcasecmp (debug, "no-expect-message")) { no_expect_message = TRUE; + } else if (!g_ascii_strcasecmp (debug, "slow") || !g_ascii_strcasecmp (debug, "thorough")) { + test_quick = FALSE; + test_quick_set = TRUE; + } else if (!g_ascii_strcasecmp (debug, "quick")) { + test_quick = TRUE; + test_quick_set = TRUE; } else { char *msg = g_strdup_printf (">>> nmtst: ignore unrecognized NMTST_DEBUG option \"%s\"", debug); @@ -242,15 +328,35 @@ __nmtst_init (int *argc, char ***argv, gboolean assert_logging, const char *log_ g_free (nmtst_debug_copy); } - if (argv && *argv) { - char **a = *argv; + if (__nmtst_internal.orig_argv) { + char **a = __nmtst_internal.orig_argv; - for (; *a; a++) { + for (; *a; a++) { if (!g_ascii_strcasecmp (*a, "--debug")) is_debug = TRUE; else if (!g_ascii_strcasecmp (*a, "--no-debug")) is_debug = FALSE; - } + else if ( !strcmp (*a, "-m=slow") + || !strcmp (*a, "-m=thorough") + || !strcmp (*a, "-m=quick") + || (!strcmp (*a, "-m") && *(a+1) + && ( !strcmp (*(a+1), "quick") + || !strcmp (*(a+1), "slow") + || !strcmp (*(a+1), "thorough")))) + test_quick_argv = TRUE; + } + } + + if (test_quick_set) + __nmtst_internal.test_quick = test_quick; + else if (test_quick_argv) + __nmtst_internal.test_quick = g_test_quick (); + else { +#ifdef NMTST_TEST_QUICK + __nmtst_internal.test_quick = NMTST_TEST_QUICK; +#else + __nmtst_internal.test_quick = FALSE; +#endif } __nmtst_internal.is_debug = is_debug; @@ -268,6 +374,7 @@ __nmtst_init (int *argc, char ***argv, gboolean assert_logging, const char *log_ gboolean success = TRUE; #ifdef __NETWORKMANAGER_LOGGING_H__ success = nm_logging_setup (log_level, log_domains, NULL, NULL); + *out_set_logging = TRUE; #endif g_assert (success); } else if (__nmtst_internal.no_expect_message) { @@ -275,6 +382,19 @@ __nmtst_init (int *argc, char ***argv, gboolean assert_logging, const char *log_ * This transforms g_test_expect_message() into a NOP, but we also have to relax * g_log_set_always_fatal(), which was set by g_test_init(). */ g_log_set_always_fatal (G_LOG_FATAL_MASK); +#ifdef __NETWORKMANAGER_LOGGING_H__ + if (c_log_domains || c_log_level) { + /* Normally, tests with assert_logging do not overwrite the logging level/domains because + * the logging statements are part of the assertions. But if the test is run with + * no-expect-message *and* the logging is set explicitly via environment variables, + * we still reset the logging. */ + gboolean success; + + success = nm_logging_setup (log_level, log_domains, NULL, NULL); + *out_set_logging = TRUE; + g_assert (success); + } +#endif } else { #if GLIB_CHECK_VERSION(2,34,0) /* We were called not to set logging levels. This means, that the user @@ -287,7 +407,7 @@ __nmtst_init (int *argc, char ***argv, gboolean assert_logging, const char *log_ } if ((!__nmtst_internal.assert_logging || (__nmtst_internal.assert_logging && __nmtst_internal.no_expect_message)) && - (is_debug || (log_level && !g_ascii_strcasecmp (log_level, "DEBUG"))) && + (is_debug || (c_log_level && (!g_ascii_strcasecmp (c_log_level, "DEBUG") || !g_ascii_strcasecmp (c_log_level, "TRACE")))) && !g_getenv ("G_MESSAGES_DEBUG")) { /* if we are @is_debug or @log_level=="DEBUG" and @@ -307,11 +427,6 @@ __nmtst_init (int *argc, char ***argv, gboolean assert_logging, const char *log_ g_free (c_log_level); g_free (c_log_domains); - if (g_once_init_enter (&atexit_registered)) { - atexit (nmtst_free); - g_once_init_leave (&atexit_registered, 1); - } - #ifdef __NETWORKMANAGER_UTILS_H__ /* ensure that monotonic timestamp is called (because it initially logs a line) */ nm_utils_get_monotonic_timestamp_s (); @@ -322,18 +437,27 @@ __nmtst_init (int *argc, char ***argv, gboolean assert_logging, const char *log_ inline static void nmtst_init_with_logging (int *argc, char ***argv, const char *log_level, const char *log_domains) { - __nmtst_init (argc, argv, FALSE, log_level, log_domains); + __nmtst_init (argc, argv, FALSE, log_level, log_domains, NULL); } inline static void -nmtst_init_assert_logging (int *argc, char ***argv) +nmtst_init_assert_logging (int *argc, char ***argv, const char *log_level, const char *log_domains) { - __nmtst_init (argc, argv, TRUE, NULL, NULL); + gboolean set_logging; + + __nmtst_init (argc, argv, TRUE, NULL, NULL, &set_logging); + + if (!set_logging) { + gboolean success; + + success = nm_logging_setup (log_level, log_domains, NULL, NULL); + g_assert (success); + } } #else inline static void nmtst_init (int *argc, char ***argv, gboolean assert_logging) { - __nmtst_init (argc, argv, assert_logging, NULL, NULL); + __nmtst_init (argc, argv, assert_logging, NULL, NULL, NULL); } #endif @@ -344,19 +468,42 @@ nmtst_is_debug (void) return __nmtst_internal.is_debug; } +inline static gboolean +nmtst_test_quick (void) +{ + g_assert (nmtst_initialized ()); + return __nmtst_internal.test_quick; +} + #if GLIB_CHECK_VERSION(2,34,0) #undef g_test_expect_message #define g_test_expect_message(...) \ G_STMT_START { \ g_assert (nmtst_initialized ()); \ if (__nmtst_internal.assert_logging && __nmtst_internal.no_expect_message) { \ - g_debug ("nmtst: swallow g_test_expect_message %s", G_STRINGIFY ((__VA_ARGS__))); \ + g_debug ("nmtst: assert-logging: g_test_expect_message %s", G_STRINGIFY ((__VA_ARGS__))); \ } else { \ G_GNUC_BEGIN_IGNORE_DEPRECATIONS \ g_test_expect_message (__VA_ARGS__); \ G_GNUC_END_IGNORE_DEPRECATIONS \ } \ } G_STMT_END +#undef g_test_assert_expected_messages_internal +#define g_test_assert_expected_messages_internal(domain, file, line, func) \ + G_STMT_START { \ + const char *_domain = (domain); \ + const char *_file = (file); \ + const char *_func = (func); \ + int _line = (line); \ + \ + g_assert (nmtst_initialized ()); \ + if (__nmtst_internal.assert_logging && __nmtst_internal.no_expect_message) \ + g_debug ("nmtst: assert-logging: g_test_assert_expected_messages(%s, %s:%d, %s)", _domain?:"", _file?:"", _line, _func?:""); \ + \ + G_GNUC_BEGIN_IGNORE_DEPRECATIONS \ + g_test_assert_expected_messages_internal (_domain, _file, _line, _func); \ + G_GNUC_END_IGNORE_DEPRECATIONS \ + } G_STMT_END #endif inline static GRand * @@ -380,7 +527,7 @@ nmtst_get_rand (void) gint64 i; i = g_ascii_strtoll (str, &s, 0); - g_assert (s[0] == '\0' && i >= 0 && i < G_MAXINT32); + g_assert (s[0] == '\0' && i >= 0 && i < G_MAXUINT32); seed = i; __nmtst_internal.rand = g_rand_new_with_seed (seed); @@ -392,7 +539,7 @@ nmtst_get_rand (void) } __nmtst_internal.rand_seed = seed; - __NMTST_LOG (g_message, ">> initialize nmtst_get_rand() with seed=%u", seed); + g_print ("\nnmtst: initialize nmtst_get_rand() with NMTST_SEED_RAND=%u\n", seed); } return __nmtst_internal.rand; } @@ -623,14 +770,28 @@ nmtst_platform_ip6_route_full (const char *network, guint plen, const char *gate return route; } +inline static int +_nmtst_platform_ip4_routes_equal_sort (gconstpointer a, gconstpointer b, gpointer user_data) +{ + return nm_platform_ip4_route_cmp ((const NMPlatformIP4Route *) a, (const NMPlatformIP4Route *) b); +} + inline static void -nmtst_platform_ip4_routes_equal (const NMPlatformIP4Route *a, const NMPlatformIP4Route *b, gsize len) +nmtst_platform_ip4_routes_equal (const NMPlatformIP4Route *a, const NMPlatformIP4Route *b, gsize len, gboolean ignore_order) { gsize i; + gs_free const NMPlatformIP4Route *c_a = NULL, *c_b = NULL; g_assert (a); g_assert (b); + if (ignore_order) { + a = c_a = g_memdup (a, sizeof (NMPlatformIP4Route) * len); + b = c_b = g_memdup (b, sizeof (NMPlatformIP4Route) * len); + g_qsort_with_data (c_a, len, sizeof (NMPlatformIP4Route), _nmtst_platform_ip4_routes_equal_sort, NULL); + g_qsort_with_data (c_b, len, sizeof (NMPlatformIP4Route), _nmtst_platform_ip4_routes_equal_sort, NULL); + } + for (i = 0; i < len; i++) { if (nm_platform_ip4_route_cmp (&a[i], &b[i]) != 0) { g_error ("Error comparing IPv4 route[%lu]: %s vs %s", (long unsigned) i, @@ -644,14 +805,28 @@ nmtst_platform_ip4_routes_equal (const NMPlatformIP4Route *a, const NMPlatformIP } } +inline static int +_nmtst_platform_ip6_routes_equal_sort (gconstpointer a, gconstpointer b, gpointer user_data) +{ + return nm_platform_ip6_route_cmp ((const NMPlatformIP6Route *) a, (const NMPlatformIP6Route *) b); +} + inline static void -nmtst_platform_ip6_routes_equal (const NMPlatformIP6Route *a, const NMPlatformIP6Route *b, gsize len) +nmtst_platform_ip6_routes_equal (const NMPlatformIP6Route *a, const NMPlatformIP6Route *b, gsize len, gboolean ignore_order) { gsize i; + gs_free const NMPlatformIP6Route *c_a = NULL, *c_b = NULL; g_assert (a); g_assert (b); + if (ignore_order) { + a = c_a = g_memdup (a, sizeof (NMPlatformIP6Route) * len); + b = c_b = g_memdup (b, sizeof (NMPlatformIP6Route) * len); + g_qsort_with_data (c_a, len, sizeof (NMPlatformIP6Route), _nmtst_platform_ip6_routes_equal_sort, NULL); + g_qsort_with_data (c_b, len, sizeof (NMPlatformIP6Route), _nmtst_platform_ip6_routes_equal_sort, NULL); + } + for (i = 0; i < len; i++) { if (nm_platform_ip6_route_cmp (&a[i], &b[i]) != 0) { g_error ("Error comparing IPv6 route[%lu]: %s vs %s", (long unsigned) i, @@ -824,18 +999,21 @@ nmtst_assert_connection_equals (NMConnection *a, gboolean normalize_a, NMConnect b = b2 = nmtst_connection_duplicate_and_normalize (b); compare = nm_connection_diff (a, b, NM_SETTING_COMPARE_FLAG_EXACT, &out_settings); - if (!compare && out_settings) { + if (!compare || out_settings) { const char *name, *pname; GHashTable *setting; GHashTableIter iter, iter2; - g_hash_table_iter_init (&iter, out_settings); - while (g_hash_table_iter_next (&iter, (gpointer *) &name, (gpointer *) &setting)) { - __NMTST_LOG (g_message, ">>> differences in setting '%s':", name); + __NMTST_LOG (g_message, ">>> ASSERTION nmtst_assert_connection_equals() fails"); + if (out_settings) { + g_hash_table_iter_init (&iter, out_settings); + while (g_hash_table_iter_next (&iter, (gpointer *) &name, (gpointer *) &setting)) { + __NMTST_LOG (g_message, ">>> differences in setting '%s':", name); - g_hash_table_iter_init (&iter2, out_settings); - while (g_hash_table_iter_next (&iter2, (gpointer *) &pname, NULL)) - __NMTST_LOG (g_message, ">>> differences in setting '%s.%s':", name, pname); + g_hash_table_iter_init (&iter2, setting); + while (g_hash_table_iter_next (&iter2, (gpointer *) &pname, NULL)) + __NMTST_LOG (g_message, ">>> differences in setting '%s.%s'", name, pname); + } } } g_assert (compare); @@ -1053,8 +1231,8 @@ typedef enum { g_variant_builder_add (&__setting_builder, "{sv}", \ __cur_property_name, \ __property_val); \ - } else \ - g_variant_unref (__property_val); \ + } \ + g_variant_unref (__property_val); \ } \ \ if (__cur_setting_name) \ diff --git a/include/nm-utils-internal.h b/include/nm-utils-internal.h index c002b6c1..227a210b 100644 --- a/include/nm-utils-internal.h +++ b/include/nm-utils-internal.h @@ -100,4 +100,77 @@ _found; \ }) +/*****************************************************************************/ + +#define NM_DEFINE_SINGLETON_INSTANCE(TYPE) \ +static TYPE *singleton_instance + +#define NM_DEFINE_SINGLETON_WEAK_REF(TYPE) \ +NM_DEFINE_SINGLETON_INSTANCE (TYPE); \ +static void \ +_singleton_instance_weak_ref_cb (gpointer data, \ + GObject *where_the_object_was) \ +{ \ + nm_log_dbg (LOGD_CORE, "disposing %s singleton (%p)", G_STRINGIFY (TYPE), singleton_instance); \ + singleton_instance = NULL; \ +} \ +static inline void \ +nm_singleton_instance_weak_ref_register (void) \ +{ \ + g_object_weak_ref (G_OBJECT (singleton_instance), _singleton_instance_weak_ref_cb, NULL); \ +} + +#define NM_DEFINE_SINGLETON_DESTRUCTOR(TYPE) \ +NM_DEFINE_SINGLETON_INSTANCE (TYPE); \ +static void __attribute__((destructor)) \ +_singleton_destructor (void) \ +{ \ + if (singleton_instance) { \ + if (G_OBJECT (singleton_instance)->ref_count > 1) \ + nm_log_dbg (LOGD_CORE, "disown %s singleton (%p)", G_STRINGIFY (TYPE), singleton_instance); \ + g_object_unref (singleton_instance); \ + } \ +} + +/* By default, the getter will assert that the singleton will be created only once. You can + * change this by redefining NM_DEFINE_SINGLETON_ALLOW_MULTIPLE. */ +#ifndef NM_DEFINE_SINGLETON_ALLOW_MULTIPLE +#define NM_DEFINE_SINGLETON_ALLOW_MULTIPLE FALSE +#endif + +#define NM_DEFINE_SINGLETON_GETTER(TYPE, GETTER, GTYPE, ...) \ +NM_DEFINE_SINGLETON_INSTANCE (TYPE); \ +NM_DEFINE_SINGLETON_WEAK_REF (TYPE); \ +TYPE * \ +GETTER (void) \ +{ \ + if (G_UNLIKELY (!singleton_instance)) { \ + static char _already_created = FALSE; \ +\ + g_assert (!_already_created || (NM_DEFINE_SINGLETON_ALLOW_MULTIPLE)); \ + _already_created = TRUE;\ + singleton_instance = (g_object_new (GTYPE, ##__VA_ARGS__, NULL)); \ + g_assert (singleton_instance); \ + nm_singleton_instance_weak_ref_register (); \ + nm_log_dbg (LOGD_CORE, "create %s singleton (%p)", G_STRINGIFY (TYPE), singleton_instance); \ + } \ + return singleton_instance; \ +} \ +NM_DEFINE_SINGLETON_DESTRUCTOR(TYPE) + +/*****************************************************************************/ + +static inline gboolean +nm_clear_g_source (guint *id) +{ + if (id && *id) { + g_source_remove (*id); + *id = 0; + return TRUE; + } + return FALSE; +} + +/*****************************************************************************/ + #endif diff --git a/introspection/Makefile.in b/introspection/Makefile.in index f31fafcc..1f358d47 100644 --- a/introspection/Makefile.in +++ b/introspection/Makefile.in @@ -1,7 +1,7 @@ -# Makefile.in generated by automake 1.13.4 from Makefile.am. +# Makefile.in generated by automake 1.15 from Makefile.am. # @configure_input@ -# Copyright (C) 1994-2013 Free Software Foundation, Inc. +# Copyright (C) 1994-2014 Free Software Foundation, Inc. # This Makefile.in is free software; the Free Software Foundation # gives unlimited permission to copy and/or distribute it, @@ -15,7 +15,17 @@ @SET_MAKE@ VPATH = @srcdir@ -am__is_gnu_make = test -n '$(MAKEFILE_LIST)' && test -n '$(MAKELEVEL)' +am__is_gnu_make = { \ + if test -z '$(MAKELEVEL)'; then \ + false; \ + elif test -n '$(MAKE_HOST)'; then \ + true; \ + elif test -n '$(MAKE_VERSION)' && test -n '$(CURDIR)'; then \ + true; \ + else \ + false; \ + fi; \ +} am__make_running_with_option = \ case $${target_option-} in \ ?) ;; \ @@ -79,8 +89,6 @@ POST_UNINSTALL = : build_triplet = @build@ host_triplet = @host@ subdir = introspection -DIST_COMMON = $(srcdir)/Makefile.in $(srcdir)/Makefile.am \ - $(srcdir)/all.xml.in $(top_srcdir)/build-aux/depcomp ACLOCAL_M4 = $(top_srcdir)/aclocal.m4 am__aclocal_m4_deps = $(top_srcdir)/m4/ax_lib_readline.m4 \ $(top_srcdir)/m4/compiler_warnings.m4 \ @@ -97,6 +105,7 @@ am__aclocal_m4_deps = $(top_srcdir)/m4/ax_lib_readline.m4 \ $(top_srcdir)/m4/vapigen.m4 $(top_srcdir)/configure.ac am__configure_deps = $(am__aclocal_m4_deps) $(CONFIGURE_DEPENDENCIES) \ $(ACLOCAL_M4) +DIST_COMMON = $(srcdir)/Makefile.am $(am__DIST_COMMON) mkinstalldirs = $(install_sh) -d CONFIG_HEADER = $(top_builddir)/config.h CONFIG_CLEAN_FILES = all.xml @@ -182,6 +191,8 @@ am__define_uniq_tagged_files = \ done | $(am__uniquify_input)` ETAGS = etags CTAGS = ctags +am__DIST_COMMON = $(srcdir)/Makefile.in $(srcdir)/all.xml.in \ + $(top_srcdir)/build-aux/depcomp DISTFILES = $(DIST_COMMON) $(DIST_SOURCES) $(TEXINFOS) $(EXTRA_DIST) ACLOCAL = @ACLOCAL@ ALL_LINGUAS = @ALL_LINGUAS@ @@ -208,7 +219,6 @@ CXXCPP = @CXXCPP@ CXXDEPMODE = @CXXDEPMODE@ CXXFLAGS = @CXXFLAGS@ CYGPATH_W = @CYGPATH_W@ -DATADIRNAME = @DATADIRNAME@ DBUS_CFLAGS = @DBUS_CFLAGS@ DBUS_GLIB_100_CFLAGS = @DBUS_GLIB_100_CFLAGS@ DBUS_GLIB_100_LIBS = @DBUS_GLIB_100_LIBS@ @@ -243,6 +253,7 @@ GNUTLS_CFLAGS = @GNUTLS_CFLAGS@ GNUTLS_LIBS = @GNUTLS_LIBS@ GREP = @GREP@ GTKDOC_CHECK = @GTKDOC_CHECK@ +GTKDOC_CHECK_PATH = @GTKDOC_CHECK_PATH@ GTKDOC_DEPS_CFLAGS = @GTKDOC_DEPS_CFLAGS@ GTKDOC_DEPS_LIBS = @GTKDOC_DEPS_LIBS@ GTKDOC_MKPDF = @GTKDOC_MKPDF@ @@ -572,7 +583,6 @@ $(srcdir)/Makefile.in: @MAINTAINER_MODE_TRUE@ $(srcdir)/Makefile.am $(am__confi echo ' cd $(top_srcdir) && $(AUTOMAKE) --gnu introspection/Makefile'; \ $(am__cd) $(top_srcdir) && \ $(AUTOMAKE) --gnu introspection/Makefile -.PRECIOUS: Makefile Makefile: $(srcdir)/Makefile.in $(top_builddir)/config.status @case '$?' in \ *config.status*) \ @@ -648,14 +658,14 @@ distclean-compile: @am__fastdepCC_TRUE@ $(AM_V_at)$(am__mv) $(DEPDIR)/$*.Tpo $(DEPDIR)/$*.Po @AMDEP_TRUE@@am__fastdepCC_FALSE@ $(AM_V_CC)source='$<' object='$@' libtool=no @AMDEPBACKSLASH@ @AMDEP_TRUE@@am__fastdepCC_FALSE@ DEPDIR=$(DEPDIR) $(CCDEPMODE) $(depcomp) @AMDEPBACKSLASH@ -@am__fastdepCC_FALSE@ $(AM_V_CC@am__nodep@)$(COMPILE) -c $< +@am__fastdepCC_FALSE@ $(AM_V_CC@am__nodep@)$(COMPILE) -c -o $@ $< .c.obj: @am__fastdepCC_TRUE@ $(AM_V_CC)$(COMPILE) -MT $@ -MD -MP -MF $(DEPDIR)/$*.Tpo -c -o $@ `$(CYGPATH_W) '$<'` @am__fastdepCC_TRUE@ $(AM_V_at)$(am__mv) $(DEPDIR)/$*.Tpo $(DEPDIR)/$*.Po @AMDEP_TRUE@@am__fastdepCC_FALSE@ $(AM_V_CC)source='$<' object='$@' libtool=no @AMDEPBACKSLASH@ @AMDEP_TRUE@@am__fastdepCC_FALSE@ DEPDIR=$(DEPDIR) $(CCDEPMODE) $(depcomp) @AMDEPBACKSLASH@ -@am__fastdepCC_FALSE@ $(AM_V_CC@am__nodep@)$(COMPILE) -c `$(CYGPATH_W) '$<'` +@am__fastdepCC_FALSE@ $(AM_V_CC@am__nodep@)$(COMPILE) -c -o $@ `$(CYGPATH_W) '$<'` .c.lo: @am__fastdepCC_TRUE@ $(AM_V_CC)$(LTCOMPILE) -MT $@ -MD -MP -MF $(DEPDIR)/$*.Tpo -c -o $@ $< @@ -874,6 +884,8 @@ uninstall-am: mostlyclean-generic mostlyclean-libtool pdf pdf-am ps ps-am \ tags tags-am uninstall uninstall-am +.PRECIOUS: Makefile + define _make_nmdbus_rule $(1): $(patsubst nmdbus-%.c,nm-%.xml,$(1)) diff --git a/introspection/nm-device-wifi.xml b/introspection/nm-device-wifi.xml index 2476fd7d..d1c5313e 100644 --- a/introspection/nm-device-wifi.xml +++ b/introspection/nm-device-wifi.xml @@ -37,7 +37,7 @@ - Options of scan + Options of scan (currently unused argument). @@ -151,6 +151,23 @@ The device supports Ad-Hoc mode. + + + The device properly reports information about supported + frequencies and thus both NM_802_11_DEVICE_CAP_FREQ_2GHZ and + NM_802_11_DEVICE_CAP_FREQ_5GHZ are valid. + + + + + The device supports 2.4GHz frequencies. + + + + + The device supports 5GHz frequencies. + + diff --git a/libnm-core/Makefile.in b/libnm-core/Makefile.in index 8ec1414e..7ceb3cfa 100644 --- a/libnm-core/Makefile.in +++ b/libnm-core/Makefile.in @@ -1,7 +1,7 @@ -# Makefile.in generated by automake 1.13.4 from Makefile.am. +# Makefile.in generated by automake 1.15 from Makefile.am. # @configure_input@ -# Copyright (C) 1994-2013 Free Software Foundation, Inc. +# Copyright (C) 1994-2014 Free Software Foundation, Inc. # This Makefile.in is free software; the Free Software Foundation # gives unlimited permission to copy and/or distribute it, @@ -20,7 +20,17 @@ VPATH = @srcdir@ -am__is_gnu_make = test -n '$(MAKEFILE_LIST)' && test -n '$(MAKELEVEL)' +am__is_gnu_make = { \ + if test -z '$(MAKELEVEL)'; then \ + false; \ + elif test -n '$(MAKE_HOST)'; then \ + true; \ + elif test -n '$(MAKE_VERSION)' && test -n '$(CURDIR)'; then \ + true; \ + else \ + false; \ + fi; \ +} am__make_running_with_option = \ case $${target_option-} in \ ?) ;; \ @@ -83,9 +93,6 @@ PRE_UNINSTALL = : POST_UNINSTALL = : build_triplet = @build@ host_triplet = @host@ -DIST_COMMON = $(srcdir)/Makefile.libnm-core $(srcdir)/Makefile.in \ - $(srcdir)/Makefile.am $(srcdir)/nm-version.h.in \ - $(top_srcdir)/build-aux/depcomp $(libnminclude_HEADERS) @WITH_GNUTLS_TRUE@am__append_1 = $(LIBGCRYPT_CFLAGS) $(GNUTLS_CFLAGS) @WITH_GNUTLS_TRUE@am__append_2 = crypto_gnutls.c @WITH_GNUTLS_TRUE@am__append_3 = $(LIBGCRYPT_LIBS) $(GNUTLS_LIBS) @@ -109,6 +116,8 @@ am__aclocal_m4_deps = $(top_srcdir)/m4/ax_lib_readline.m4 \ $(top_srcdir)/m4/vapigen.m4 $(top_srcdir)/configure.ac am__configure_deps = $(am__aclocal_m4_deps) $(CONFIGURE_DEPENDENCIES) \ $(ACLOCAL_M4) +DIST_COMMON = $(srcdir)/Makefile.am $(libnminclude_HEADERS) \ + $(am__DIST_COMMON) mkinstalldirs = $(install_sh) -d CONFIG_HEADER = $(top_builddir)/config.h CONFIG_CLEAN_FILES = nm-version.h @@ -274,6 +283,8 @@ am__define_uniq_tagged_files = \ ETAGS = etags CTAGS = ctags DIST_SUBDIRS = $(SUBDIRS) +am__DIST_COMMON = $(srcdir)/Makefile.in $(srcdir)/Makefile.libnm-core \ + $(srcdir)/nm-version.h.in $(top_srcdir)/build-aux/depcomp DISTFILES = $(DIST_COMMON) $(DIST_SOURCES) $(TEXINFOS) $(EXTRA_DIST) am__relativize = \ dir0=`pwd`; \ @@ -325,7 +336,6 @@ CXXCPP = @CXXCPP@ CXXDEPMODE = @CXXDEPMODE@ CXXFLAGS = @CXXFLAGS@ CYGPATH_W = @CYGPATH_W@ -DATADIRNAME = @DATADIRNAME@ DBUS_CFLAGS = @DBUS_CFLAGS@ DBUS_GLIB_100_CFLAGS = @DBUS_GLIB_100_CFLAGS@ DBUS_GLIB_100_LIBS = @DBUS_GLIB_100_LIBS@ @@ -360,6 +370,7 @@ GNUTLS_CFLAGS = @GNUTLS_CFLAGS@ GNUTLS_LIBS = @GNUTLS_LIBS@ GREP = @GREP@ GTKDOC_CHECK = @GTKDOC_CHECK@ +GTKDOC_CHECK_PATH = @GTKDOC_CHECK_PATH@ GTKDOC_DEPS_CFLAGS = @GTKDOC_DEPS_CFLAGS@ GTKDOC_DEPS_LIBS = @GTKDOC_DEPS_LIBS@ GTKDOC_MKPDF = @GTKDOC_MKPDF@ @@ -684,7 +695,6 @@ $(srcdir)/Makefile.in: @MAINTAINER_MODE_TRUE@ $(srcdir)/Makefile.am $(srcdir)/Ma echo ' cd $(top_srcdir) && $(AUTOMAKE) --gnu libnm-core/Makefile'; \ $(am__cd) $(top_srcdir) && \ $(AUTOMAKE) --gnu libnm-core/Makefile -.PRECIOUS: Makefile Makefile: $(srcdir)/Makefile.in $(top_builddir)/config.status @case '$?' in \ *config.status*) \ @@ -693,7 +703,7 @@ Makefile: $(srcdir)/Makefile.in $(top_builddir)/config.status echo ' cd $(top_builddir) && $(SHELL) ./config.status $(subdir)/$@ $(am__depfiles_maybe)'; \ cd $(top_builddir) && $(SHELL) ./config.status $(subdir)/$@ $(am__depfiles_maybe);; \ esac; -$(srcdir)/Makefile.libnm-core: +$(srcdir)/Makefile.libnm-core $(am__empty): $(top_builddir)/config.status: $(top_srcdir)/configure $(CONFIG_STATUS_DEPENDENCIES) cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh @@ -769,14 +779,14 @@ distclean-compile: @am__fastdepCC_TRUE@ $(AM_V_at)$(am__mv) $(DEPDIR)/$*.Tpo $(DEPDIR)/$*.Po @AMDEP_TRUE@@am__fastdepCC_FALSE@ $(AM_V_CC)source='$<' object='$@' libtool=no @AMDEPBACKSLASH@ @AMDEP_TRUE@@am__fastdepCC_FALSE@ DEPDIR=$(DEPDIR) $(CCDEPMODE) $(depcomp) @AMDEPBACKSLASH@ -@am__fastdepCC_FALSE@ $(AM_V_CC@am__nodep@)$(COMPILE) -c $< +@am__fastdepCC_FALSE@ $(AM_V_CC@am__nodep@)$(COMPILE) -c -o $@ $< .c.obj: @am__fastdepCC_TRUE@ $(AM_V_CC)$(COMPILE) -MT $@ -MD -MP -MF $(DEPDIR)/$*.Tpo -c -o $@ `$(CYGPATH_W) '$<'` @am__fastdepCC_TRUE@ $(AM_V_at)$(am__mv) $(DEPDIR)/$*.Tpo $(DEPDIR)/$*.Po @AMDEP_TRUE@@am__fastdepCC_FALSE@ $(AM_V_CC)source='$<' object='$@' libtool=no @AMDEPBACKSLASH@ @AMDEP_TRUE@@am__fastdepCC_FALSE@ DEPDIR=$(DEPDIR) $(CCDEPMODE) $(depcomp) @AMDEPBACKSLASH@ -@am__fastdepCC_FALSE@ $(AM_V_CC@am__nodep@)$(COMPILE) -c `$(CYGPATH_W) '$<'` +@am__fastdepCC_FALSE@ $(AM_V_CC@am__nodep@)$(COMPILE) -c -o $@ `$(CYGPATH_W) '$<'` .c.lo: @am__fastdepCC_TRUE@ $(AM_V_CC)$(LTCOMPILE) -MT $@ -MD -MP -MF $(DEPDIR)/$*.Tpo -c -o $@ $< @@ -1343,6 +1353,8 @@ uninstall-am: uninstall-libnmincludeHEADERS pdf pdf-am ps ps-am tags tags-am uninstall uninstall-am \ uninstall-libnmincludeHEADERS +.PRECIOUS: Makefile + include $(GLIB_MAKEFILE) # Tell versions [3.59,3.63) of GNU make to not export all variables. diff --git a/libnm-core/nm-connection.c b/libnm-core/nm-connection.c index 907713bd..acdc8b89 100644 --- a/libnm-core/nm-connection.c +++ b/libnm-core/nm-connection.c @@ -30,6 +30,7 @@ #include "nm-utils.h" #include "nm-setting-private.h" #include "nm-core-internal.h" +#include "gsystem-local-alloc.h" /** * SECTION:nm-connection @@ -304,6 +305,8 @@ nm_connection_replace_settings (NMConnection *connection, for (s = settings; s; s = s->next) _nm_connection_add_setting (connection, s->data); + g_slist_free (settings); + if (changed) g_signal_emit (connection, signals[CHANGED], 0); return TRUE; @@ -723,6 +726,27 @@ _normalize_infiniband_mtu (NMConnection *self, GHashTable *parameters) return FALSE; } +static gboolean +_normalize_bond_mode (NMConnection *self, GHashTable *parameters) +{ + NMSettingBond *s_bond = nm_connection_get_setting_bond (self); + + /* Convert mode from numeric to string notation */ + if (s_bond) { + const char *mode = nm_setting_bond_get_option_by_name (s_bond, NM_SETTING_BOND_OPTION_MODE); + int mode_int = nm_utils_bond_mode_string_to_int (mode); + + if (mode_int != -1) { + const char *mode_new = nm_utils_bond_mode_int_to_string (mode_int); + if (g_strcmp0 (mode_new, mode) != 0) { + nm_setting_bond_add_option (s_bond, NM_SETTING_BOND_OPTION_MODE, mode_new); + return TRUE; + } + } + } + return FALSE; +} + /** * nm_connection_verify: * @connection: the #NMConnection to verify @@ -936,6 +960,7 @@ nm_connection_normalize (NMConnection *connection, was_modified |= _normalize_connection_slave_type (connection); was_modified |= _normalize_ip_config (connection, parameters); was_modified |= _normalize_infiniband_mtu (connection, parameters); + was_modified |= _normalize_bond_mode (connection, parameters); /* Verify anew. */ success = _nm_connection_verify (connection, error); @@ -1282,6 +1307,19 @@ nm_connection_is_type (NMConnection *connection, const char *type) return (g_strcmp0 (type2, type) == 0); } +static int +_for_each_sort (NMSetting **p_a, NMSetting **p_b, void *unused) +{ + NMSetting *a = *p_a; + NMSetting *b = *p_b; + int c; + + c = _nm_setting_compare_priority (a, b); + if (c != 0) + return c; + return strcmp (nm_setting_get_name (a), nm_setting_get_name (b)); +} + /** * nm_connection_for_each_setting_value: * @connection: the #NMConnection @@ -1296,15 +1334,39 @@ nm_connection_for_each_setting_value (NMConnection *connection, NMSettingValueIterFn func, gpointer user_data) { + NMConnectionPrivate *priv; + gs_free NMSetting **arr_free = NULL; + NMSetting *arr_temp[20], **arr; GHashTableIter iter; gpointer value; + guint i, size; g_return_if_fail (NM_IS_CONNECTION (connection)); g_return_if_fail (func != NULL); - g_hash_table_iter_init (&iter, NM_CONNECTION_GET_PRIVATE (connection)->settings); - while (g_hash_table_iter_next (&iter, NULL, &value)) - nm_setting_enumerate_values (NM_SETTING (value), func, user_data); + priv = NM_CONNECTION_GET_PRIVATE (connection); + + size = g_hash_table_size (priv->settings); + if (!size) + return; + + if (size > G_N_ELEMENTS (arr_temp)) + arr = arr_free = g_new (NMSetting *, size); + else + arr = arr_temp; + + g_hash_table_iter_init (&iter, priv->settings); + for (i = 0; g_hash_table_iter_next (&iter, NULL, &value); i++) + arr[i] = NM_SETTING (value); + g_assert (i == size); + + /* sort the settings. This has an effect on the order in which keyfile + * prints them. */ + if (size > 1) + g_qsort_with_data (arr, size, sizeof (NMSetting *), (GCompareDataFunc) _for_each_sort, NULL); + + for (i = 0; i < size; i++) + nm_setting_enumerate_values (arr[i], func, user_data); } /** diff --git a/libnm-core/nm-core-enum-types.c b/libnm-core/nm-core-enum-types.c index d7d4291b..e4cf177c 100644 --- a/libnm-core/nm-core-enum-types.c +++ b/libnm-core/nm-core-enum-types.c @@ -180,6 +180,9 @@ nm_device_wifi_capabilities_get_type (void) { NM_WIFI_DEVICE_CAP_RSN, "NM_WIFI_DEVICE_CAP_RSN", "rsn" }, { NM_WIFI_DEVICE_CAP_AP, "NM_WIFI_DEVICE_CAP_AP", "ap" }, { NM_WIFI_DEVICE_CAP_ADHOC, "NM_WIFI_DEVICE_CAP_ADHOC", "adhoc" }, + { NM_WIFI_DEVICE_CAP_FREQ_VALID, "NM_WIFI_DEVICE_CAP_FREQ_VALID", "freq-valid" }, + { NM_WIFI_DEVICE_CAP_FREQ_2GHZ, "NM_WIFI_DEVICE_CAP_FREQ_2GHZ", "freq-2ghz" }, + { NM_WIFI_DEVICE_CAP_FREQ_5GHZ, "NM_WIFI_DEVICE_CAP_FREQ_5GHZ", "freq-5ghz" }, { 0, NULL, NULL } }; GType g_define_type_id = @@ -397,6 +400,7 @@ nm_device_state_reason_get_type (void) { NM_DEVICE_STATE_REASON_MODEM_FAILED, "NM_DEVICE_STATE_REASON_MODEM_FAILED", "modem-failed" }, { NM_DEVICE_STATE_REASON_MODEM_AVAILABLE, "NM_DEVICE_STATE_REASON_MODEM_AVAILABLE", "modem-available" }, { NM_DEVICE_STATE_REASON_SIM_PIN_INCORRECT, "NM_DEVICE_STATE_REASON_SIM_PIN_INCORRECT", "sim-pin-incorrect" }, + { NM_DEVICE_STATE_REASON_NEW_ACTIVATION, "NM_DEVICE_STATE_REASON_NEW_ACTIVATION", "new-activation" }, { 0, NULL, NULL } }; GType g_define_type_id = diff --git a/libnm-core/nm-core-internal.h b/libnm-core/nm-core-internal.h index 5af90267..9f4b33e3 100644 --- a/libnm-core/nm-core-internal.h +++ b/libnm-core/nm-core-internal.h @@ -132,4 +132,8 @@ GByteArray *nm_utils_rsa_key_encrypt (const guint8 *data, char **out_password, GError **error); +/* These are public API in NM 1.2, but private on nm-1-0. */ +int nm_utils_bond_mode_string_to_int (const char *mode); +const char *nm_utils_bond_mode_int_to_string (int mode); + #endif diff --git a/libnm-core/nm-dbus-interface.h b/libnm-core/nm-dbus-interface.h index dd2b70a0..9bab80f3 100644 --- a/libnm-core/nm-dbus-interface.h +++ b/libnm-core/nm-dbus-interface.h @@ -199,6 +199,9 @@ typedef enum { /*< flags >*/ * @NM_WIFI_DEVICE_CAP_RSN: device supports WPA2/RSN authentication * @NM_WIFI_DEVICE_CAP_AP: device supports Access Point mode * @NM_WIFI_DEVICE_CAP_ADHOC: device supports Ad-Hoc mode + * @NM_WIFI_DEVICE_CAP_FREQ_VALID: device reports frequency capabilities + * @NM_WIFI_DEVICE_CAP_FREQ_2GHZ: device supports 2.4GHz frequencies + * @NM_WIFI_DEVICE_CAP_FREQ_5GHZ: device supports 5GHz frequencies * * 802.11 specific device encryption and authentication capabilities. * @@ -213,7 +216,10 @@ typedef enum { /*< flags >*/ NM_WIFI_DEVICE_CAP_WPA = 0x00000010, NM_WIFI_DEVICE_CAP_RSN = 0x00000020, NM_WIFI_DEVICE_CAP_AP = 0x00000040, - NM_WIFI_DEVICE_CAP_ADHOC = 0x00000080 + NM_WIFI_DEVICE_CAP_ADHOC = 0x00000080, + NM_WIFI_DEVICE_CAP_FREQ_VALID = 0x00000100, + NM_WIFI_DEVICE_CAP_FREQ_2GHZ = 0x00000200, + NM_WIFI_DEVICE_CAP_FREQ_5GHZ = 0x00000400, } NMDeviceWifiCapabilities; @@ -460,6 +466,7 @@ typedef enum { * @NM_DEVICE_STATE_REASON_MODEM_FAILED: Modem failed or no longer available * @NM_DEVICE_STATE_REASON_MODEM_AVAILABLE: Modem now ready and available * @NM_DEVICE_STATE_REASON_SIM_PIN_INCORRECT: SIM PIN was incorrect + * @NM_DEVICE_STATE_REASON_NEW_ACTIVATION: New connection activation was enqueued * * Device state change reason codes * @@ -526,6 +533,7 @@ typedef enum { NM_DEVICE_STATE_REASON_MODEM_FAILED = 57, NM_DEVICE_STATE_REASON_MODEM_AVAILABLE = 58, NM_DEVICE_STATE_REASON_SIM_PIN_INCORRECT = 59, + NM_DEVICE_STATE_REASON_NEW_ACTIVATION = 60, } NMDeviceStateReason; diff --git a/libnm-core/nm-errors.c b/libnm-core/nm-errors.c index 229f14a0..3b1b1bc9 100644 --- a/libnm-core/nm-errors.c +++ b/libnm-core/nm-errors.c @@ -85,6 +85,6 @@ _nm_dbus_errors_init (void) NM_DBUS_INTERFACE_SETTINGS, NM_TYPE_SETTINGS_ERROR); register_error_domain (NM_VPN_PLUGIN_ERROR, - NM_VPN_DBUS_PLUGIN_INTERFACE, + NM_DBUS_VPN_ERROR_PREFIX, NM_TYPE_VPN_PLUGIN_ERROR); } diff --git a/libnm-core/nm-setting-8021x.c b/libnm-core/nm-setting-8021x.c index f739f2c7..41559e0c 100644 --- a/libnm-core/nm-setting-8021x.c +++ b/libnm-core/nm-setting-8021x.c @@ -1884,6 +1884,7 @@ nm_setting_802_1x_get_private_key_format (NMSetting8021x *setting) g_error_free (error); return NM_SETTING_802_1X_CK_FORMAT_UNKNOWN; } + g_error_free (error); return NM_SETTING_802_1X_CK_FORMAT_RAW_KEY; default: break; @@ -2164,6 +2165,7 @@ nm_setting_802_1x_get_phase2_private_key_format (NMSetting8021x *setting) g_error_free (error); return NM_SETTING_802_1X_CK_FORMAT_UNKNOWN; } + g_error_free (error); return NM_SETTING_802_1X_CK_FORMAT_RAW_KEY; default: break; @@ -3258,8 +3260,8 @@ nm_setting_802_1x_class_init (NMSetting8021xClass *setting_class) * no verification of the server certificate's altSubjectName is performed. **/ /* ---ifcfg-rh--- - * property: altubject-matches - * variable: IEEE_8021X_AlTSUBJECT_MATCHES(+) + * property: altsubject-matches + * variable: IEEE_8021X_ALTSUBJECT_MATCHES(+) * description: List of strings to be matched against the altSubjectName. * example: IEEE_8021X_ALTSUBJECT_MATCHES="s1.domain.cc" * ---end--- diff --git a/libnm-core/nm-setting-adsl.c b/libnm-core/nm-setting-adsl.c index 00bcef54..2e71f8e7 100644 --- a/libnm-core/nm-setting-adsl.c +++ b/libnm-core/nm-setting-adsl.c @@ -199,15 +199,6 @@ verify (NMSetting *setting, NMConnection *connection, GError **error) return FALSE; } - if (priv->password && !strlen (priv->password)) { - g_set_error_literal (error, - NM_CONNECTION_ERROR, - NM_CONNECTION_ERROR_INVALID_PROPERTY, - _("property is empty")); - g_prefix_error (error, "%s.%s: ", NM_SETTING_ADSL_SETTING_NAME, NM_SETTING_ADSL_PASSWORD); - return FALSE; - } - if ( !priv->protocol || ( strcmp (priv->protocol, NM_SETTING_ADSL_PROTOCOL_PPPOA) && strcmp (priv->protocol, NM_SETTING_ADSL_PROTOCOL_PPPOE) @@ -242,7 +233,7 @@ need_secrets (NMSetting *setting) NMSettingAdslPrivate *priv = NM_SETTING_ADSL_GET_PRIVATE (setting); GPtrArray *secrets = NULL; - if (priv->password) + if (priv->password && *priv->password) return NULL; if (!(priv->password_flags & NM_SETTING_SECRET_FLAG_NOT_REQUIRED)) { diff --git a/libnm-core/nm-setting-bond.c b/libnm-core/nm-setting-bond.c index bb053125..5441a090 100644 --- a/libnm-core/nm-setting-bond.c +++ b/libnm-core/nm-setting-bond.c @@ -440,15 +440,8 @@ verify (NMSetting *setting, NMConnection *connection, GError **error) NMSettingBondPrivate *priv = NM_SETTING_BOND_GET_PRIVATE (setting); GHashTableIter iter; const char *key, *value; - const char *valid_modes[] = { "balance-rr", - "active-backup", - "balance-xor", - "broadcast", - "802.3ad", - "balance-tlb", - "balance-alb", - NULL }; - int miimon = 0, arp_interval = 0; + int mode, miimon = 0, arp_interval = 0; + const char *mode_orig, *mode_new; const char *arp_ip_target = NULL; const char *lacp_rate; const char *primary; @@ -484,7 +477,8 @@ verify (NMSetting *setting, NMConnection *connection, GError **error) g_prefix_error (error, "%s.%s: ", NM_SETTING_BOND_SETTING_NAME, NM_SETTING_BOND_OPTIONS); } - value = g_hash_table_lookup (priv->options, NM_SETTING_BOND_OPTION_MODE); + /* Verify bond mode */ + mode_orig = value = g_hash_table_lookup (priv->options, NM_SETTING_BOND_OPTION_MODE); if (!value) { g_set_error (error, NM_CONNECTION_ERROR, @@ -494,7 +488,8 @@ verify (NMSetting *setting, NMConnection *connection, GError **error) g_prefix_error (error, "%s.%s: ", NM_SETTING_BOND_SETTING_NAME, NM_SETTING_BOND_OPTIONS); return FALSE; } - if (!_nm_utils_string_in_list (value, valid_modes)) { + mode = nm_utils_bond_mode_string_to_int (value); + if (mode == -1) { g_set_error (error, NM_CONNECTION_ERROR, NM_CONNECTION_ERROR_INVALID_PROPERTY, @@ -503,6 +498,7 @@ verify (NMSetting *setting, NMConnection *connection, GError **error) g_prefix_error (error, "%s.%s: ", NM_SETTING_BOND_SETTING_NAME, NM_SETTING_BOND_OPTIONS); return FALSE; } + mode_new = value = nm_utils_bond_mode_int_to_string (mode); /* Make sure mode is compatible with other settings */ if ( strcmp (value, "balance-alb") == 0 @@ -645,7 +641,22 @@ verify (NMSetting *setting, NMConnection *connection, GError **error) return FALSE; } - return _nm_connection_verify_required_interface_name (connection, error); + if (!_nm_connection_verify_required_interface_name (connection, error)) + return FALSE; + + /* *** errors above here should be always fatal, below NORMALIZABLE_ERROR *** */ + + if (g_strcmp0 (mode_orig, mode_new) != 0) { + g_set_error (error, + NM_CONNECTION_ERROR, + NM_CONNECTION_ERROR_INVALID_PROPERTY, + _("'%s' option should be string"), + NM_SETTING_BOND_OPTION_MODE); + g_prefix_error (error, "%s.%s: ", NM_SETTING_BOND_SETTING_NAME, NM_SETTING_BOND_OPTIONS); + return NM_SETTING_VERIFY_NORMALIZABLE; + } + + return TRUE; } static void diff --git a/libnm-core/nm-setting-bridge.c b/libnm-core/nm-setting-bridge.c index 51c6ac5a..d00271b7 100644 --- a/libnm-core/nm-setting-bridge.c +++ b/libnm-core/nm-setting-bridge.c @@ -196,10 +196,14 @@ static inline gboolean check_range (guint32 val, guint32 min, guint32 max, + gboolean zero, const char *prop, GError **error) { - if ((val != 0) && (val < min || val > max)) { + if (zero && val == 0) + return TRUE; + + if (val < min || val > max) { g_set_error (error, NM_CONNECTION_ERROR, NM_CONNECTION_ERROR_INVALID_PROPERTY, @@ -228,6 +232,7 @@ verify (NMSetting *setting, NMConnection *connection, GError **error) if (!check_range (priv->forward_delay, BR_MIN_FORWARD_DELAY, BR_MAX_FORWARD_DELAY, + !priv->stp, NM_SETTING_BRIDGE_FORWARD_DELAY, error)) return FALSE; @@ -235,6 +240,7 @@ verify (NMSetting *setting, NMConnection *connection, GError **error) if (!check_range (priv->hello_time, BR_MIN_HELLO_TIME, BR_MAX_HELLO_TIME, + !priv->stp, NM_SETTING_BRIDGE_HELLO_TIME, error)) return FALSE; @@ -242,6 +248,7 @@ verify (NMSetting *setting, NMConnection *connection, GError **error) if (!check_range (priv->max_age, BR_MIN_MAX_AGE, BR_MAX_MAX_AGE, + !priv->stp, NM_SETTING_BRIDGE_MAX_AGE, error)) return FALSE; @@ -249,6 +256,7 @@ verify (NMSetting *setting, NMConnection *connection, GError **error) if (!check_range (priv->ageing_time, BR_MIN_AGEING_TIME, BR_MAX_AGEING_TIME, + !priv->stp, NM_SETTING_BRIDGE_AGEING_TIME, error)) return FALSE; diff --git a/libnm-core/nm-setting-cdma.c b/libnm-core/nm-setting-cdma.c index ebbbda74..ecc387c8 100644 --- a/libnm-core/nm-setting-cdma.c +++ b/libnm-core/nm-setting-cdma.c @@ -160,15 +160,6 @@ verify (NMSetting *setting, NMConnection *connection, GError **error) return FALSE; } - if (priv->password && !strlen (priv->password)) { - g_set_error_literal (error, - NM_CONNECTION_ERROR, - NM_CONNECTION_ERROR_INVALID_PROPERTY, - _("property is empty")); - g_prefix_error (error, "%s.%s: ", NM_SETTING_CDMA_SETTING_NAME, NM_SETTING_CDMA_PASSWORD); - return FALSE; - } - return TRUE; } @@ -178,7 +169,7 @@ need_secrets (NMSetting *setting) NMSettingCdmaPrivate *priv = NM_SETTING_CDMA_GET_PRIVATE (setting); GPtrArray *secrets = NULL; - if (priv->password) + if (priv->password && *priv->password) return NULL; if (priv->username) { diff --git a/libnm-core/nm-setting-connection.c b/libnm-core/nm-setting-connection.c index 01f5d423..7bc927bc 100644 --- a/libnm-core/nm-setting-connection.c +++ b/libnm-core/nm-setting-connection.c @@ -968,8 +968,9 @@ find_virtual_interface_name (GVariant *connection_dict) /* All of the deprecated virtual interface name properties were named "interface-name". */ if (!g_variant_lookup (setting_dict, "interface-name", "&s", &interface_name)) - return NULL; + interface_name = NULL; + g_variant_unref (setting_dict); return interface_name; } diff --git a/libnm-core/nm-setting-dcb.c b/libnm-core/nm-setting-dcb.c index a4fa00c8..915cc41f 100644 --- a/libnm-core/nm-setting-dcb.c +++ b/libnm-core/nm-setting-dcb.c @@ -50,7 +50,7 @@ NM_SETTING_REGISTER_TYPE (NM_TYPE_SETTING_DCB) typedef struct { NMSettingDcbFlags app_fcoe_flags; gint app_fcoe_priority; - const char * app_fcoe_mode; + char * app_fcoe_mode; NMSettingDcbFlags app_iscsi_flags; gint app_iscsi_priority; @@ -793,6 +793,7 @@ set_property (GObject *object, guint prop_id, priv->app_fcoe_priority = g_value_get_int (value); break; case PROP_APP_FCOE_MODE: + g_free (priv->app_fcoe_mode); priv->app_fcoe_mode = g_value_dup_string (value); break; case PROP_APP_ISCSI_FLAGS: @@ -896,6 +897,16 @@ get_property (GObject *object, guint prop_id, } } +static void +finalize (GObject *object) +{ + NMSettingDcbPrivate *priv = NM_SETTING_DCB_GET_PRIVATE (object); + + g_free (priv->app_fcoe_mode); + + G_OBJECT_CLASS (nm_setting_dcb_parent_class)->finalize (object); +} + static void nm_setting_dcb_class_init (NMSettingDcbClass *setting_class) { @@ -907,6 +918,7 @@ nm_setting_dcb_class_init (NMSettingDcbClass *setting_class) /* virtual methods */ object_class->set_property = set_property; object_class->get_property = get_property; + object_class->finalize = finalize; parent_class->verify = verify; /* Properties */ diff --git a/libnm-core/nm-setting-gsm.c b/libnm-core/nm-setting-gsm.c index 22f8cdba..36557a25 100644 --- a/libnm-core/nm-setting-gsm.c +++ b/libnm-core/nm-setting-gsm.c @@ -285,15 +285,6 @@ verify (NMSetting *setting, NMConnection *connection, GError **error) return FALSE; } - if (priv->password && !strlen (priv->password)) { - g_set_error_literal (error, - NM_CONNECTION_ERROR, - NM_CONNECTION_ERROR_INVALID_PROPERTY, - _("property is empty")); - g_prefix_error (error, "%s.%s: ", NM_SETTING_GSM_SETTING_NAME, NM_SETTING_GSM_USERNAME); - return FALSE; - } - if (priv->network_id) { guint32 nid_len = strlen (priv->network_id); guint32 i; @@ -331,7 +322,7 @@ need_secrets (NMSetting *setting) NMSettingGsmPrivate *priv = NM_SETTING_GSM_GET_PRIVATE (setting); GPtrArray *secrets = NULL; - if (priv->password) + if (priv->password && *priv->password) return NULL; if (priv->username) { diff --git a/libnm-core/nm-setting-ip4-config.c b/libnm-core/nm-setting-ip4-config.c index 68619267..81cc1f88 100644 --- a/libnm-core/nm-setting-ip4-config.c +++ b/libnm-core/nm-setting-ip4-config.c @@ -571,6 +571,15 @@ nm_setting_ip4_config_class_init (NMSettingIP4ConfigClass *ip4_class) * ---end--- */ + /* ---ifcfg-rh--- + * property: route-metric + * variable: IPV4_ROUTE_METRIC(+) + * default: -1 + * description: IPV4_ROUTE_METRIC is the default IPv4 metric for routes on this connection. + * If set to -1, a default metric based on the device type is used. + * ---end--- + */ + /** * NMSettingIP4Config:dhcp-client-id: * diff --git a/libnm-core/nm-setting-ip6-config.c b/libnm-core/nm-setting-ip6-config.c index f5d90334..29ca5515 100644 --- a/libnm-core/nm-setting-ip6-config.c +++ b/libnm-core/nm-setting-ip6-config.c @@ -488,6 +488,15 @@ nm_setting_ip6_config_class_init (NMSettingIP6ConfigClass *ip6_class) * ---end--- */ + /* ---ifcfg-rh--- + * property: route-metric + * variable: IPV6_ROUTE_METRIC(+) + * default: -1 + * description: IPV6_ROUTE_METRIC is the default IPv6 metric for routes on this connection. + * If set to -1, a default metric based on the device type is used. + * ---end--- + */ + /** * NMSettingIP6Config:ip6-privacy: * diff --git a/libnm-core/nm-setting-team-port.c b/libnm-core/nm-setting-team-port.c index b5125753..7fbf8620 100644 --- a/libnm-core/nm-setting-team-port.c +++ b/libnm-core/nm-setting-team-port.c @@ -130,6 +130,7 @@ set_property (GObject *object, guint prop_id, switch (prop_id) { case PROP_CONFIG: + g_free (priv->config); priv->config = g_value_dup_string (value); break; default: @@ -154,6 +155,16 @@ get_property (GObject *object, guint prop_id, } } +static void +finalize (GObject *object) +{ + NMSettingTeamPortPrivate *priv = NM_SETTING_TEAM_PORT_GET_PRIVATE (object); + + g_free (priv->config); + + G_OBJECT_CLASS (nm_setting_team_port_parent_class)->finalize (object); +} + static void nm_setting_team_port_class_init (NMSettingTeamPortClass *setting_class) { @@ -165,6 +176,7 @@ nm_setting_team_port_class_init (NMSettingTeamPortClass *setting_class) /* virtual methods */ object_class->set_property = set_property; object_class->get_property = get_property; + object_class->finalize = finalize; parent_class->verify = verify; /* Properties */ diff --git a/libnm-core/nm-setting-wired.c b/libnm-core/nm-setting-wired.c index ac143e45..2a747940 100644 --- a/libnm-core/nm-setting-wired.c +++ b/libnm-core/nm-setting-wired.c @@ -434,27 +434,24 @@ nm_setting_wired_get_s390_option (NMSettingWired *setting, const char **out_key, const char **out_value) { - NMSettingWiredPrivate *priv; - guint32 num_keys; - GList *keys; - const char *_key = NULL, *_value = NULL; + const char *_key, *_value; + GHashTableIter iter; + guint i = 0; g_return_val_if_fail (NM_IS_SETTING_WIRED (setting), FALSE); - priv = NM_SETTING_WIRED_GET_PRIVATE (setting); - - num_keys = nm_setting_wired_get_num_s390_options (setting); - g_return_val_if_fail (idx < num_keys, FALSE); - - keys = g_hash_table_get_keys (priv->s390_options); - _key = g_list_nth_data (keys, idx); - _value = g_hash_table_lookup (priv->s390_options, _key); - - if (out_key) - *out_key = _key; - if (out_value) - *out_value = _value; - return TRUE; + g_hash_table_iter_init (&iter, NM_SETTING_WIRED_GET_PRIVATE (setting)->s390_options); + while (g_hash_table_iter_next (&iter, (gpointer) &_key, (gpointer) &_value)) { + if (i == idx) { + if (out_key) + *out_key = _key; + if (out_value) + *out_value = _value; + return TRUE; + } + i++; + } + g_return_val_if_reached (FALSE); } /** diff --git a/libnm-core/nm-setting-wireless-security.c b/libnm-core/nm-setting-wireless-security.c index c95f9243..a56a8e97 100644 --- a/libnm-core/nm-setting-wireless-security.c +++ b/libnm-core/nm-setting-wireless-security.c @@ -822,7 +822,7 @@ need_secrets (NMSetting *setting) if ( priv->auth_alg && !strcmp (priv->auth_alg, "leap") && !strcmp (priv->key_mgmt, "ieee8021x")) { - if (!priv->leap_password || !strlen (priv->leap_password)) { + if (!priv->leap_password || !*priv->leap_password) { g_ptr_array_add (secrets, NM_SETTING_WIRELESS_SECURITY_LEAP_PASSWORD); return secrets; } @@ -893,14 +893,6 @@ verify (NMSetting *setting, NMConnection *connection, GError **error) g_prefix_error (error, "%s.%s: ", NM_SETTING_WIRELESS_SECURITY_SETTING_NAME, NM_SETTING_WIRELESS_SECURITY_LEAP_USERNAME); return FALSE; } - if (priv->leap_password && !strlen (priv->leap_password)) { - g_set_error_literal (error, - NM_CONNECTION_ERROR, - NM_CONNECTION_ERROR_MISSING_PROPERTY, - _("property is empty")); - g_prefix_error (error, "%s.%s: ", NM_SETTING_WIRELESS_SECURITY_SETTING_NAME, NM_SETTING_WIRELESS_SECURITY_LEAP_PASSWORD); - return FALSE; - } } else { if ( (strcmp (priv->key_mgmt, "ieee8021x") == 0) || (strcmp (priv->key_mgmt, "wpa-eap") == 0)) { @@ -945,39 +937,6 @@ verify (NMSetting *setting, NMConnection *connection, GError **error) return FALSE; } - if (priv->wep_key0 && !nm_utils_wep_key_valid (priv->wep_key0, priv->wep_key_type)) { - g_set_error_literal (error, - NM_CONNECTION_ERROR, - NM_CONNECTION_ERROR_INVALID_PROPERTY, - _("property is invalid")); - g_prefix_error (error, "%s.%s: ", NM_SETTING_WIRELESS_SECURITY_SETTING_NAME, NM_SETTING_WIRELESS_SECURITY_WEP_KEY0); - return FALSE; - } - if (priv->wep_key1 && !nm_utils_wep_key_valid (priv->wep_key1, priv->wep_key_type)) { - g_set_error_literal (error, - NM_CONNECTION_ERROR, - NM_CONNECTION_ERROR_INVALID_PROPERTY, - _("property is invalid")); - g_prefix_error (error, "%s.%s: ", NM_SETTING_WIRELESS_SECURITY_SETTING_NAME, NM_SETTING_WIRELESS_SECURITY_WEP_KEY1); - return FALSE; - } - if (priv->wep_key2 && !nm_utils_wep_key_valid (priv->wep_key2, priv->wep_key_type)) { - g_set_error_literal (error, - NM_CONNECTION_ERROR, - NM_CONNECTION_ERROR_INVALID_PROPERTY, - _("property is invalid")); - g_prefix_error (error, "%s.%s: ", NM_SETTING_WIRELESS_SECURITY_SETTING_NAME, NM_SETTING_WIRELESS_SECURITY_WEP_KEY2); - return FALSE; - } - if (priv->wep_key3 && !nm_utils_wep_key_valid (priv->wep_key3, priv->wep_key_type)) { - g_set_error_literal (error, - NM_CONNECTION_ERROR, - NM_CONNECTION_ERROR_INVALID_PROPERTY, - _("property is invalid")); - g_prefix_error (error, "%s.%s: ", NM_SETTING_WIRELESS_SECURITY_SETTING_NAME, NM_SETTING_WIRELESS_SECURITY_WEP_KEY3); - return FALSE; - } - if (priv->auth_alg && !_nm_utils_string_in_list (priv->auth_alg, valid_auth_algs)) { g_set_error_literal (error, NM_CONNECTION_ERROR, @@ -987,15 +946,6 @@ verify (NMSetting *setting, NMConnection *connection, GError **error) return FALSE; } - if (priv->psk && !nm_utils_wpa_psk_valid (priv->psk)) { - g_set_error_literal (error, - NM_CONNECTION_ERROR, - NM_CONNECTION_ERROR_INVALID_PROPERTY, - _("property is invalid")); - g_prefix_error (error, "%s.%s: ", NM_SETTING_WIRELESS_SECURITY_SETTING_NAME, NM_SETTING_WIRELESS_SECURITY_PSK); - return FALSE; - } - if (priv->proto && !_nm_utils_string_slist_validate (priv->proto, valid_protos)) { g_set_error_literal (error, NM_CONNECTION_ERROR, diff --git a/libnm-core/nm-setting.c b/libnm-core/nm-setting.c index 037baa6b..b78d9376 100644 --- a/libnm-core/nm-setting.c +++ b/libnm-core/nm-setting.c @@ -660,17 +660,40 @@ get_property_for_dbus (NMSetting *setting, return dbus_value; } -static void -set_property_from_dbus (const NMSettingProperty *property, GVariant *src_value, GValue *dst_value) +static gboolean +set_property_from_dbus (const NMSettingProperty *property, + GVariant *src_value, + GValue *dst_value) { - g_return_if_fail (property->param_spec != NULL); + g_return_val_if_fail (property->param_spec != NULL, FALSE); + + if (property->from_dbus) { + if (!g_variant_type_equal (g_variant_get_type (src_value), property->dbus_type)) + return FALSE; - if (property->from_dbus) property->from_dbus (src_value, dst_value); - else if (dst_value->g_type == G_TYPE_BYTES) + } else if (dst_value->g_type == G_TYPE_BYTES) { + if (!g_variant_is_of_type (src_value, G_VARIANT_TYPE_BYTESTRING)) + return FALSE; + _nm_utils_bytes_from_dbus (src_value, dst_value); - else - g_dbus_gvariant_to_gvalue (src_value, dst_value); + } else { + GValue tmp = G_VALUE_INIT; + + g_dbus_gvariant_to_gvalue (src_value, &tmp); + if (G_VALUE_TYPE (&tmp) == G_VALUE_TYPE (dst_value)) + *dst_value = tmp; + else { + gboolean success; + + success = g_value_transform (&tmp, dst_value); + g_value_unset (&tmp); + if (!success) + return FALSE; + } + } + + return TRUE; } @@ -766,7 +789,6 @@ _nm_setting_new_from_dbus (GType setting_type, GVariant *connection_dict, GError **error) { - NMSettingClass *class; NMSetting *setting; const NMSettingProperty *properties; guint n_properties; @@ -781,11 +803,6 @@ _nm_setting_new_from_dbus (GType setting_type, if (connection_dict) g_return_val_if_fail (g_variant_is_of_type (connection_dict, NM_VARIANT_TYPE_CONNECTION), NULL); - /* g_type_class_ref() ensures the setting class is created if it hasn't - * already been used. - */ - class = g_type_class_ref (setting_type); - /* Build the setting object from the properties we know about; we assume * that any propreties in @setting_dict that we don't know about can * either be ignored or else has a backward-compatibility equivalent @@ -793,12 +810,33 @@ _nm_setting_new_from_dbus (GType setting_type, */ setting = (NMSetting *) g_object_new (setting_type, NULL); - properties = nm_setting_class_get_properties (class, &n_properties); + properties = nm_setting_class_get_properties (NM_SETTING_GET_CLASS (setting), &n_properties); for (i = 0; i < n_properties; i++) { const NMSettingProperty *property = &properties[i]; - GVariant *value = g_variant_lookup_value (setting_dict, property->name, NULL); + GVariant *value; + + if (property->param_spec && !(property->param_spec->flags & G_PARAM_WRITABLE)) + continue; + + value = g_variant_lookup_value (setting_dict, property->name, NULL); if (value && property->set_func) { + if (!g_variant_type_equal (g_variant_get_type (value), property->dbus_type)) { + property_type_error: + g_set_error (error, NM_CONNECTION_ERROR, NM_CONNECTION_ERROR_INVALID_PROPERTY, + _("can't set property of type '%s' from value of type '%s'"), + property->dbus_type ? + g_variant_type_peek_string (property->dbus_type) : + property->param_spec ? + g_type_name (property->param_spec->value_type) : "(unknown)", + g_variant_get_type_string (value)); + g_prefix_error (error, "%s.%s: ", nm_setting_get_name (setting), property->name); + + g_variant_unref (value); + g_object_unref (setting); + return NULL; + } + property->set_func (setting, connection_dict, property->name, @@ -810,11 +848,10 @@ _nm_setting_new_from_dbus (GType setting_type, } else if (value && property->param_spec) { GValue object_value = { 0, }; - if (!(property->param_spec->flags & G_PARAM_WRITABLE)) - continue; - g_value_init (&object_value, property->param_spec->value_type); - set_property_from_dbus (property, value, &object_value); + if (!set_property_from_dbus (property, value, &object_value)) + goto property_type_error; + g_object_set_property (G_OBJECT (setting), property->param_spec->name, &object_value); g_value_unset (&object_value); } @@ -823,8 +860,6 @@ _nm_setting_new_from_dbus (GType setting_type, g_variant_unref (value); } - g_type_class_unref (class); - return setting; } @@ -1279,6 +1314,33 @@ nm_setting_diff (NMSetting *a, return !(*results); } +#define CMP_AND_RETURN(n_a, n_b, name) \ + G_STMT_START { \ + gboolean _is = (strcmp (n_a, ""name) == 0); \ + \ + if (_is || (strcmp (n_b, ""name) == 0)) \ + return _is ? -1 : 1; \ + } G_STMT_END + +static int +_enumerate_values_sort (GParamSpec **p_a, GParamSpec **p_b, GType *p_type) +{ + const char *n_a = (*p_a)->name; + const char *n_b = (*p_b)->name; + int c = strcmp (n_a, n_b); + + if (c) { + if (*p_type == NM_TYPE_SETTING_CONNECTION) { + /* for [connection], report first id, uuid, type in that order. */ + CMP_AND_RETURN (n_a, n_b, NM_SETTING_CONNECTION_ID); + CMP_AND_RETURN (n_a, n_b, NM_SETTING_CONNECTION_UUID); + CMP_AND_RETURN (n_a, n_b, NM_SETTING_CONNECTION_TYPE); + } + } + return c; +} +#undef CMP_AND_RETURN + /** * nm_setting_enumerate_values: * @setting: the #NMSetting @@ -1296,11 +1358,19 @@ nm_setting_enumerate_values (NMSetting *setting, GParamSpec **property_specs; guint n_property_specs; int i; + GType type; g_return_if_fail (NM_IS_SETTING (setting)); g_return_if_fail (func != NULL); property_specs = g_object_class_list_properties (G_OBJECT_GET_CLASS (setting), &n_property_specs); + + /* sort the properties. This has an effect on the order in which keyfile + * prints them. */ + type = G_OBJECT_TYPE (setting); + g_qsort_with_data (property_specs, n_property_specs, sizeof (gpointer), + (GCompareDataFunc) _enumerate_values_sort, &type); + for (i = 0; i < n_property_specs; i++) { GParamSpec *prop_spec = property_specs[i]; GValue value = G_VALUE_INIT; diff --git a/libnm-core/nm-utils.c b/libnm-core/nm-utils.c index e14775ff..5d4f1163 100644 --- a/libnm-core/nm-utils.c +++ b/libnm-core/nm-utils.c @@ -998,9 +998,13 @@ nm_utils_wep_key_valid (const char *key, NMWepKeyType wep_type) if (!key) return FALSE; + if (wep_type == NM_WEP_KEY_TYPE_UNKNOWN) { + return nm_utils_wep_key_valid (key, NM_WEP_KEY_TYPE_KEY) || + nm_utils_wep_key_valid (key, NM_WEP_KEY_TYPE_PASSPHRASE); + } + keylen = strlen (key); - if ( wep_type == NM_WEP_KEY_TYPE_KEY - || wep_type == NM_WEP_KEY_TYPE_UNKNOWN) { + if (wep_type == NM_WEP_KEY_TYPE_KEY) { if (keylen == 10 || keylen == 26) { /* Hex key */ for (i = 0; i < keylen; i++) { @@ -1015,7 +1019,6 @@ nm_utils_wep_key_valid (const char *key, NMWepKeyType wep_type) } } else return FALSE; - } else if (wep_type == NM_WEP_KEY_TYPE_PASSPHRASE) { if (!keylen || keylen > 64) return FALSE; @@ -1802,6 +1805,7 @@ nm_utils_ip_addresses_from_variant (GVariant *value, g_variant_unref (attr_val); } + g_variant_unref (addr_var); g_ptr_array_add (addresses, addr); } @@ -2218,7 +2222,7 @@ nm_utils_file_is_pkcs12 (const char *filename) * for additional checks. This check is performed after the check for * @file_test_flags. You cannot omit both @file_test_flags and @predicate. * @user_data: (closure): (allow-none): user data for @predicate function. - * @error: on failure, a "not found" error using @error_domain and @error_code + * @error: (allow-none): on failure, set a "not found" error %G_IO_ERROR %G_IO_ERROR_NOT_FOUND. * * Searches for a @progname file in a list of search @paths. * @@ -2771,7 +2775,7 @@ nm_utils_hwaddr_canonical (const char *asc, gssize length) if (nm_utils_hwaddr_aton (asc, buf, length) == NULL) return NULL; - return g_strdup (nm_utils_hwaddr_ntoa (buf, length)); + return nm_utils_hwaddr_ntoa (buf, length); } /* This is used to possibly canonicalize values passed to MAC address property @@ -3213,3 +3217,64 @@ nm_utils_check_virtual_device_compatibility (GType virtual_type, GType other_typ return FALSE; } } + +typedef struct { + const char *str; + const char *num; +} BondMode; + +static BondMode bond_mode_table[] = { + [0] = { "balance-rr", "0" }, + [1] = { "active-backup", "1" }, + [2] = { "balance-xor", "2" }, + [3] = { "broadcast", "3" }, + [4] = { "802.3ad", "4" }, + [5] = { "balance-tlb", "5" }, + [6] = { "balance-alb", "6" }, +}; + +/** + * nm_utils_bond_mode_int_to_string: + * @mode: bonding mode as a numeric value + * + * Convert bonding mode from integer value to descriptive name. + * See https://www.kernel.org/doc/Documentation/networking/bonding.txt for + * available modes. + * + * Returns: bonding mode string, or NULL on error +*/ + +const char * +nm_utils_bond_mode_int_to_string (int mode) +{ + if (mode >= 0 && mode < G_N_ELEMENTS (bond_mode_table)) + return bond_mode_table[mode].str; + return NULL; +} + +/** + * nm_utils_bond_mode_string_to_int: + * @mode: bonding mode as string + * + * Convert bonding mode from string representation to numeric value. + * See https://www.kernel.org/doc/Documentation/networking/bonding.txt for + * available modes. + * The @mode string can be either a descriptive name or a number (as string). + * + * Returns: numeric bond mode, or -1 on error +*/ +int +nm_utils_bond_mode_string_to_int (const char *mode) +{ + int i; + + if (!mode || !*mode) + return -1; + + for (i = 0; i < G_N_ELEMENTS (bond_mode_table); i++) { + if ( strcmp (mode, bond_mode_table[i].str) == 0 + || strcmp (mode, bond_mode_table[i].num) == 0) + return i; + } + return -1; +} diff --git a/libnm-core/nm-version.h b/libnm-core/nm-version.h index 39cfd63f..46103544 100644 --- a/libnm-core/nm-version.h +++ b/libnm-core/nm-version.h @@ -43,7 +43,7 @@ * Evaluates to the micro version number of NetworkManager which this source * compiled against. */ -#define NM_MICRO_VERSION (0) +#define NM_MICRO_VERSION (2) /** * NM_CHECK_VERSION: @@ -68,7 +68,7 @@ #define NM_VERSION_0_9_10 (NM_ENCODE_VERSION (0, 9, 10)) #define NM_VERSION_1_0 (NM_ENCODE_VERSION (1, 0, 0)) -#define NM_VERSION_CUR_STABLE NM_VERSION_0_9_10 +#define NM_VERSION_CUR_STABLE NM_VERSION_1_0 #define NM_VERSION_NEXT_STABLE NM_VERSION_1_0 #if !defined (NM_VERSION_MIN_REQUIRED) || (NM_VERSION_MIN_REQUIRED == 0) diff --git a/libnm-core/nm-version.h.in b/libnm-core/nm-version.h.in index 0a33ac29..bbbf993a 100644 --- a/libnm-core/nm-version.h.in +++ b/libnm-core/nm-version.h.in @@ -68,7 +68,7 @@ #define NM_VERSION_0_9_10 (NM_ENCODE_VERSION (0, 9, 10)) #define NM_VERSION_1_0 (NM_ENCODE_VERSION (1, 0, 0)) -#define NM_VERSION_CUR_STABLE NM_VERSION_0_9_10 +#define NM_VERSION_CUR_STABLE NM_VERSION_1_0 #define NM_VERSION_NEXT_STABLE NM_VERSION_1_0 #if !defined (NM_VERSION_MIN_REQUIRED) || (NM_VERSION_MIN_REQUIRED == 0) diff --git a/libnm-core/tests/Makefile.am b/libnm-core/tests/Makefile.am index a21c131c..79aa73db 100644 --- a/libnm-core/tests/Makefile.am +++ b/libnm-core/tests/Makefile.am @@ -24,6 +24,7 @@ LDADD = \ $(top_builddir)/libnm-core/libnm-core.la \ $(GLIB_LIBS) +@VALGRIND_RULES@ TESTS = $(noinst_PROGRAMS) endif diff --git a/libnm-core/tests/Makefile.in b/libnm-core/tests/Makefile.in index b62df8b4..c2b15c6a 100644 --- a/libnm-core/tests/Makefile.in +++ b/libnm-core/tests/Makefile.in @@ -1,7 +1,7 @@ -# Makefile.in generated by automake 1.13.4 from Makefile.am. +# Makefile.in generated by automake 1.15 from Makefile.am. # @configure_input@ -# Copyright (C) 1994-2013 Free Software Foundation, Inc. +# Copyright (C) 1994-2014 Free Software Foundation, Inc. # This Makefile.in is free software; the Free Software Foundation # gives unlimited permission to copy and/or distribute it, @@ -15,7 +15,17 @@ @SET_MAKE@ VPATH = @srcdir@ -am__is_gnu_make = test -n '$(MAKEFILE_LIST)' && test -n '$(MAKELEVEL)' +am__is_gnu_make = { \ + if test -z '$(MAKELEVEL)'; then \ + false; \ + elif test -n '$(MAKE_HOST)'; then \ + true; \ + elif test -n '$(MAKE_VERSION)' && test -n '$(CURDIR)'; then \ + true; \ + else \ + false; \ + fi; \ +} am__make_running_with_option = \ case $${target_option-} in \ ?) ;; \ @@ -85,8 +95,6 @@ host_triplet = @host@ @ENABLE_TESTS_TRUE@ test-setting-dcb$(EXEEXT) \ @ENABLE_TESTS_TRUE@ test-settings-defaults$(EXEEXT) subdir = libnm-core/tests -DIST_COMMON = $(srcdir)/Makefile.in $(srcdir)/Makefile.am \ - $(top_srcdir)/build-aux/depcomp ACLOCAL_M4 = $(top_srcdir)/aclocal.m4 am__aclocal_m4_deps = $(top_srcdir)/m4/ax_lib_readline.m4 \ $(top_srcdir)/m4/compiler_warnings.m4 \ @@ -103,6 +111,7 @@ am__aclocal_m4_deps = $(top_srcdir)/m4/ax_lib_readline.m4 \ $(top_srcdir)/m4/vapigen.m4 $(top_srcdir)/configure.ac am__configure_deps = $(am__aclocal_m4_deps) $(CONFIGURE_DEPENDENCIES) \ $(ACLOCAL_M4) +DIST_COMMON = $(srcdir)/Makefile.am $(am__DIST_COMMON) mkinstalldirs = $(install_sh) -d CONFIG_HEADER = $(top_builddir)/config.h CONFIG_CLEAN_FILES = @@ -241,6 +250,8 @@ am__tty_colors = { \ std=''; \ fi; \ } +am__DIST_COMMON = $(srcdir)/Makefile.in \ + $(top_srcdir)/build-aux/depcomp DISTFILES = $(DIST_COMMON) $(DIST_SOURCES) $(TEXINFOS) $(EXTRA_DIST) ACLOCAL = @ACLOCAL@ ALL_LINGUAS = @ALL_LINGUAS@ @@ -267,7 +278,6 @@ CXXCPP = @CXXCPP@ CXXDEPMODE = @CXXDEPMODE@ CXXFLAGS = @CXXFLAGS@ CYGPATH_W = @CYGPATH_W@ -DATADIRNAME = @DATADIRNAME@ DBUS_CFLAGS = @DBUS_CFLAGS@ DBUS_GLIB_100_CFLAGS = @DBUS_GLIB_100_CFLAGS@ DBUS_GLIB_100_LIBS = @DBUS_GLIB_100_LIBS@ @@ -302,6 +312,7 @@ GNUTLS_CFLAGS = @GNUTLS_CFLAGS@ GNUTLS_LIBS = @GNUTLS_LIBS@ GREP = @GREP@ GTKDOC_CHECK = @GTKDOC_CHECK@ +GTKDOC_CHECK_PATH = @GTKDOC_CHECK_PATH@ GTKDOC_DEPS_CFLAGS = @GTKDOC_DEPS_CFLAGS@ GTKDOC_DEPS_LIBS = @GTKDOC_DEPS_LIBS@ GTKDOC_MKPDF = @GTKDOC_MKPDF@ @@ -559,7 +570,6 @@ $(srcdir)/Makefile.in: @MAINTAINER_MODE_TRUE@ $(srcdir)/Makefile.am $(am__confi echo ' cd $(top_srcdir) && $(AUTOMAKE) --gnu libnm-core/tests/Makefile'; \ $(am__cd) $(top_srcdir) && \ $(AUTOMAKE) --gnu libnm-core/tests/Makefile -.PRECIOUS: Makefile Makefile: $(srcdir)/Makefile.in $(top_builddir)/config.status @case '$?' in \ *config.status*) \ @@ -634,14 +644,14 @@ distclean-compile: @am__fastdepCC_TRUE@ $(AM_V_at)$(am__mv) $(DEPDIR)/$*.Tpo $(DEPDIR)/$*.Po @AMDEP_TRUE@@am__fastdepCC_FALSE@ $(AM_V_CC)source='$<' object='$@' libtool=no @AMDEPBACKSLASH@ @AMDEP_TRUE@@am__fastdepCC_FALSE@ DEPDIR=$(DEPDIR) $(CCDEPMODE) $(depcomp) @AMDEPBACKSLASH@ -@am__fastdepCC_FALSE@ $(AM_V_CC@am__nodep@)$(COMPILE) -c $< +@am__fastdepCC_FALSE@ $(AM_V_CC@am__nodep@)$(COMPILE) -c -o $@ $< .c.obj: @am__fastdepCC_TRUE@ $(AM_V_CC)$(COMPILE) -MT $@ -MD -MP -MF $(DEPDIR)/$*.Tpo -c -o $@ `$(CYGPATH_W) '$<'` @am__fastdepCC_TRUE@ $(AM_V_at)$(am__mv) $(DEPDIR)/$*.Tpo $(DEPDIR)/$*.Po @AMDEP_TRUE@@am__fastdepCC_FALSE@ $(AM_V_CC)source='$<' object='$@' libtool=no @AMDEPBACKSLASH@ @AMDEP_TRUE@@am__fastdepCC_FALSE@ DEPDIR=$(DEPDIR) $(CCDEPMODE) $(depcomp) @AMDEPBACKSLASH@ -@am__fastdepCC_FALSE@ $(AM_V_CC@am__nodep@)$(COMPILE) -c `$(CYGPATH_W) '$<'` +@am__fastdepCC_FALSE@ $(AM_V_CC@am__nodep@)$(COMPILE) -c -o $@ `$(CYGPATH_W) '$<'` .c.lo: @am__fastdepCC_TRUE@ $(AM_V_CC)$(LTCOMPILE) -MT $@ -MD -MP -MF $(DEPDIR)/$*.Tpo -c -o $@ $< @@ -953,6 +963,10 @@ uninstall-am: mostlyclean-generic mostlyclean-libtool pdf pdf-am ps ps-am \ tags tags-am uninstall uninstall-am +.PRECIOUS: Makefile + + +@ENABLE_TESTS_TRUE@@VALGRIND_RULES@ # Tell versions [3.59,3.63) of GNU make to not export all variables. # Otherwise a system limit (for SysV at least) may be exceeded. diff --git a/libnm-core/tests/test-crypto.c b/libnm-core/tests/test-crypto.c index 1c8ae477..e4ca8086 100644 --- a/libnm-core/tests/test-crypto.c +++ b/libnm-core/tests/test-crypto.c @@ -98,7 +98,7 @@ out: static void test_cert (gconstpointer test_data) { - char *path; + gs_free char *path = NULL; GByteArray *array; NMCryptoFileFormat format = NM_CRYPTO_FILE_FORMAT_UNKNOWN; GError *error = NULL; @@ -226,6 +226,7 @@ test_is_pkcs12 (const char *path, gboolean expect_fail) if (expect_fail) { g_assert_error (error, NM_CRYPTO_ERROR, NM_CRYPTO_ERROR_INVALID_DATA); g_assert (!is_pkcs12); + g_clear_error (&error); } else { g_assert_no_error (error); g_assert (is_pkcs12); diff --git a/libnm-core/tests/test-general.c b/libnm-core/tests/test-general.c index d309c800..7df4e57a 100644 --- a/libnm-core/tests/test-general.c +++ b/libnm-core/tests/test-general.c @@ -25,6 +25,7 @@ #include #include +#include "gsystem-local-alloc.h" #include "nm-setting-private.h" #include "nm-utils.h" @@ -648,7 +649,7 @@ test_setting_ip4_config_address_data (void) static void test_setting_gsm_apn_spaces (void) { - NMSettingGsm *s_gsm; + gs_unref_object NMSettingGsm *s_gsm = NULL; const char *tmp; s_gsm = (NMSettingGsm *) nm_setting_gsm_new (); @@ -676,7 +677,7 @@ test_setting_gsm_apn_spaces (void) static void test_setting_gsm_apn_bad_chars (void) { - NMSettingGsm *s_gsm; + gs_unref_object NMSettingGsm *s_gsm = NULL; s_gsm = (NMSettingGsm *) nm_setting_gsm_new (); ASSERT (s_gsm != NULL, @@ -714,7 +715,7 @@ test_setting_gsm_apn_bad_chars (void) static void test_setting_gsm_apn_underscore (void) { - NMSettingGsm *s_gsm; + gs_unref_object NMSettingGsm *s_gsm = NULL; s_gsm = (NMSettingGsm *) nm_setting_gsm_new (); g_assert (s_gsm); @@ -729,7 +730,7 @@ test_setting_gsm_apn_underscore (void) static void test_setting_gsm_without_number (void) { - NMSettingGsm *s_gsm; + gs_unref_object NMSettingGsm *s_gsm = NULL; s_gsm = (NMSettingGsm *) nm_setting_gsm_new (); g_assert (s_gsm); @@ -1140,6 +1141,183 @@ test_setting_new_from_dbus_enum (void) g_object_unref (s_serial); } +static void +test_setting_new_from_dbus_bad (void) +{ + NMSetting *setting; + NMConnection *conn; + GBytes *ssid; + GPtrArray *addrs; + GVariant *orig_dict, *dict; + GError *error = NULL; + + /* We want to test: + * - ordinary scalar properties + * - string properties + * - GBytes-valued properties (which are handled specially by set_property_from_dbus()) + * - enum/flags-valued properties + * - overridden properties + * - transformed properties + * + * No single setting class has examples of all of these, so we need two settings. + */ + + conn = nm_simple_connection_new (); + + setting = nm_setting_connection_new (); + g_object_set (setting, + NM_SETTING_CONNECTION_ID, "test", + NM_SETTING_CONNECTION_UUID, "83c5a841-1759-4cdb-bfce-8d4087956497", + NULL); + nm_connection_add_setting (conn, setting); + + setting = nm_setting_wireless_new (); + ssid = g_bytes_new ("my-ssid", 7); + g_object_set (setting, + /* scalar */ + NM_SETTING_WIRELESS_RATE, 100, + /* string */ + NM_SETTING_WIRELESS_MODE, NM_SETTING_WIRELESS_MODE_INFRA, + /* GBytes */ + NM_SETTING_WIRELESS_SSID, ssid, + /* transformed */ + NM_SETTING_WIRELESS_BSSID, "00:11:22:33:44:55", + NULL); + g_bytes_unref (ssid); + nm_connection_add_setting (conn, setting); + + setting = nm_setting_ip6_config_new (); + addrs = g_ptr_array_new_with_free_func ((GDestroyNotify) nm_ip_address_unref); + g_ptr_array_add (addrs, nm_ip_address_new (AF_INET6, "1234::5678", 64, NULL)); + g_object_set (setting, + /* enum */ + NM_SETTING_IP6_CONFIG_IP6_PRIVACY, NM_SETTING_IP6_CONFIG_PRIVACY_PREFER_PUBLIC_ADDR, + /* overridden */ + NM_SETTING_IP_CONFIG_ADDRESSES, addrs, + /* (needed in order to verify()) */ + NM_SETTING_IP_CONFIG_METHOD, NM_SETTING_IP6_CONFIG_METHOD_AUTO, + NULL); + g_ptr_array_unref (addrs); + nm_connection_add_setting (conn, setting); + + orig_dict = nm_connection_to_dbus (conn, NM_CONNECTION_SERIALIZE_ALL); + g_object_unref (conn); + + /* sanity-check */ + conn = nm_simple_connection_new_from_dbus (orig_dict, &error); + g_assert_no_error (error); + g_assert (conn); + g_object_unref (conn); + + /* Compatible mismatches */ + + dict = g_variant_ref (orig_dict); + NMTST_VARIANT_EDITOR (dict, + NMTST_VARIANT_CHANGE_PROPERTY (NM_SETTING_WIRELESS_SETTING_NAME, + NM_SETTING_WIRELESS_RATE, + "i", 10); + ); + conn = nm_simple_connection_new_from_dbus (dict, &error); + g_assert (conn); + g_assert_no_error (error); + setting = nm_connection_get_setting (conn, NM_TYPE_SETTING_WIRELESS); + g_assert (setting); + g_assert_cmpint (nm_setting_wireless_get_rate (NM_SETTING_WIRELESS (setting)), ==, 10); + g_object_unref (conn); + g_variant_unref (dict); + + dict = g_variant_ref (orig_dict); + NMTST_VARIANT_EDITOR (dict, + NMTST_VARIANT_CHANGE_PROPERTY (NM_SETTING_IP6_CONFIG_SETTING_NAME, + NM_SETTING_IP6_CONFIG_IP6_PRIVACY, + "i", NM_SETTING_IP6_CONFIG_PRIVACY_PREFER_TEMP_ADDR); + ); + conn = nm_simple_connection_new_from_dbus (dict, &error); + g_assert (conn); + g_assert_no_error (error); + setting = nm_connection_get_setting (conn, NM_TYPE_SETTING_IP6_CONFIG); + g_assert (setting); + g_assert_cmpint (nm_setting_ip6_config_get_ip6_privacy (NM_SETTING_IP6_CONFIG (setting)), ==, NM_SETTING_IP6_CONFIG_PRIVACY_PREFER_TEMP_ADDR); + g_object_unref (conn); + g_variant_unref (dict); + + /* Incompatible mismatches */ + + dict = g_variant_ref (orig_dict); + NMTST_VARIANT_EDITOR (dict, + NMTST_VARIANT_CHANGE_PROPERTY (NM_SETTING_WIRELESS_SETTING_NAME, + NM_SETTING_WIRELESS_RATE, + "s", "ten"); + ); + conn = nm_simple_connection_new_from_dbus (dict, &error); + g_assert_error (error, NM_CONNECTION_ERROR, NM_CONNECTION_ERROR_INVALID_PROPERTY); + g_assert (g_str_has_prefix (error->message, "802-11-wireless.rate:")); + g_clear_error (&error); + g_variant_unref (dict); + + dict = g_variant_ref (orig_dict); + NMTST_VARIANT_EDITOR (dict, + NMTST_VARIANT_CHANGE_PROPERTY (NM_SETTING_WIRELESS_SETTING_NAME, + NM_SETTING_WIRELESS_MODE, + "b", FALSE); + ); + conn = nm_simple_connection_new_from_dbus (dict, &error); + g_assert_error (error, NM_CONNECTION_ERROR, NM_CONNECTION_ERROR_INVALID_PROPERTY); + g_assert (g_str_has_prefix (error->message, "802-11-wireless.mode:")); + g_clear_error (&error); + g_variant_unref (dict); + + dict = g_variant_ref (orig_dict); + NMTST_VARIANT_EDITOR (dict, + NMTST_VARIANT_CHANGE_PROPERTY (NM_SETTING_WIRELESS_SETTING_NAME, + NM_SETTING_WIRELESS_SSID, + "s", "fred"); + ); + conn = nm_simple_connection_new_from_dbus (dict, &error); + g_assert_error (error, NM_CONNECTION_ERROR, NM_CONNECTION_ERROR_INVALID_PROPERTY); + g_assert (g_str_has_prefix (error->message, "802-11-wireless.ssid:")); + g_clear_error (&error); + g_variant_unref (dict); + + dict = g_variant_ref (orig_dict); + NMTST_VARIANT_EDITOR (dict, + NMTST_VARIANT_CHANGE_PROPERTY (NM_SETTING_WIRELESS_SETTING_NAME, + NM_SETTING_WIRELESS_BSSID, + "i", 42); + ); + conn = nm_simple_connection_new_from_dbus (dict, &error); + g_assert_error (error, NM_CONNECTION_ERROR, NM_CONNECTION_ERROR_INVALID_PROPERTY); + g_assert (g_str_has_prefix (error->message, "802-11-wireless.bssid:")); + g_clear_error (&error); + g_variant_unref (dict); + + dict = g_variant_ref (orig_dict); + NMTST_VARIANT_EDITOR (dict, + NMTST_VARIANT_CHANGE_PROPERTY (NM_SETTING_IP6_CONFIG_SETTING_NAME, + NM_SETTING_IP6_CONFIG_IP6_PRIVACY, + "s", "private"); + ); + conn = nm_simple_connection_new_from_dbus (dict, &error); + g_assert_error (error, NM_CONNECTION_ERROR, NM_CONNECTION_ERROR_INVALID_PROPERTY); + g_assert (g_str_has_prefix (error->message, "ipv6.ip6-privacy:")); + g_clear_error (&error); + g_variant_unref (dict); + + dict = g_variant_ref (orig_dict); + NMTST_VARIANT_EDITOR (dict, + NMTST_VARIANT_CHANGE_PROPERTY (NM_SETTING_IP6_CONFIG_SETTING_NAME, + NM_SETTING_IP_CONFIG_ADDRESSES, + "s", "1234::5678"); + ); + conn = nm_simple_connection_new_from_dbus (dict, &error); + g_assert_error (error, NM_CONNECTION_ERROR, NM_CONNECTION_ERROR_INVALID_PROPERTY); + g_assert (g_str_has_prefix (error->message, "ipv6.addresses:")); + g_clear_error (&error); + g_variant_unref (dict); + + g_variant_unref (orig_dict); +} + static NMConnection * new_test_connection (void) { @@ -1374,6 +1552,7 @@ test_connection_replace_settings_bad (void) connection = new_test_connection (); success = nm_connection_replace_settings (connection, new_settings, &error); g_assert_error (error, NM_CONNECTION_ERROR, NM_CONNECTION_ERROR_INVALID_SETTING); + g_clear_error (&error); g_assert (!success); g_assert (nm_connection_verify (connection, NULL)); @@ -2211,7 +2390,7 @@ test_connection_bad_base_types (void) static void test_setting_compare_id (void) { - NMSetting *old, *new; + gs_unref_object NMSetting *old = NULL, *new = NULL; gboolean success; old = nm_setting_connection_new (); @@ -2235,7 +2414,7 @@ test_setting_compare_id (void) static void test_setting_compare_timestamp (void) { - NMSetting *old, *new; + gs_unref_object NMSetting *old = NULL, *new = NULL; gboolean success; old = nm_setting_connection_new (); @@ -2280,7 +2459,7 @@ static void test_setting_compare_secrets (gconstpointer test_data) { const TestDataCompareSecrets *data = test_data; - NMSetting *old, *new; + gs_unref_object NMSetting *old = NULL, *new = NULL; gboolean success; /* Make sure that a connection with transient/unsaved secrets compares @@ -2311,7 +2490,7 @@ static void test_setting_compare_vpn_secrets (gconstpointer test_data) { const TestDataCompareSecrets *data = test_data; - NMSetting *old, *new; + gs_unref_object NMSetting *old = NULL, *new = NULL; gboolean success; /* Make sure that a connection with transient/unsaved secrets compares @@ -2587,7 +2766,7 @@ test_setting_connection_changed_signal (void) NMConnection *connection; gboolean changed = FALSE; NMSettingConnection *s_con; - char *uuid; + gs_free char *uuid = NULL; connection = nm_simple_connection_new (); g_signal_connect (connection, @@ -2993,7 +3172,7 @@ test_setting_802_1x_changed_signal (void) static void test_setting_old_uuid (void) { - NMSetting *setting; + gs_unref_object NMSetting *setting = NULL; /* NetworkManager-0.9.4.0 generated 40-character UUIDs with no dashes, * like this one. Test that we maintain compatibility. */ @@ -3702,6 +3881,7 @@ test_setting_ip6_gateway (void) value = g_variant_lookup_value (ip6_dict, NM_SETTING_IP_CONFIG_GATEWAY, G_VARIANT_TYPE_STRING); g_assert (value != NULL); g_assert_cmpstr (g_variant_get_string (value, NULL), ==, "abcd::1"); + g_variant_unref (value); value = g_variant_lookup_value (ip6_dict, NM_SETTING_IP_CONFIG_ADDRESSES, G_VARIANT_TYPE ("a(ayuay)")); g_assert (value != NULL); @@ -3798,6 +3978,7 @@ test_hexstr2bin (void) g_assert (b); g_assert_cmpint (g_bytes_get_size (b), ==, items[i].expected_len); g_assert (memcmp (g_bytes_get_data (b, NULL), items[i].expected, g_bytes_get_size (b)) == 0); + g_bytes_unref (b); } else g_assert (b == NULL); } @@ -3901,6 +4082,7 @@ int main (int argc, char **argv) g_test_add_func ("/core/general/test_setting_new_from_dbus", test_setting_new_from_dbus); g_test_add_func ("/core/general/test_setting_new_from_dbus_transform", test_setting_new_from_dbus_transform); g_test_add_func ("/core/general/test_setting_new_from_dbus_enum", test_setting_new_from_dbus_enum); + g_test_add_func ("/core/general/test_setting_new_from_dbus_bad", test_setting_new_from_dbus_bad); g_test_add_func ("/core/general/test_connection_replace_settings", test_connection_replace_settings); g_test_add_func ("/core/general/test_connection_replace_settings_from_connection", test_connection_replace_settings_from_connection); g_test_add_func ("/core/general/test_connection_replace_settings_bad", test_connection_replace_settings_bad); diff --git a/libnm-core/tests/test-secrets.c b/libnm-core/tests/test-secrets.c index 1254dfff..a915ae7d 100644 --- a/libnm-core/tests/test-secrets.c +++ b/libnm-core/tests/test-secrets.c @@ -176,6 +176,7 @@ test_need_tls_secrets_path (void) "need-tls-secrets-path-key-password", "expected to require private key password, but it wasn't"); + g_ptr_array_free (hints, TRUE); g_object_unref (connection); } @@ -219,6 +220,7 @@ test_need_tls_secrets_blob (void) "need-tls-secrets-blob-key-password", "expected to require private key password, but it wasn't"); + g_ptr_array_free (hints, TRUE); g_object_unref (connection); } @@ -345,6 +347,7 @@ test_need_tls_phase2_secrets_path (void) "need-tls-phase2-secrets-path-key-password", "expected to require private key password, but it wasn't"); + g_ptr_array_free (hints, TRUE); g_object_unref (connection); } @@ -389,6 +392,7 @@ test_need_tls_phase2_secrets_blob (void) "need-tls-phase2-secrets-blob-key-password", "expected to require private key password, but it wasn't"); + g_ptr_array_free (hints, TRUE); g_object_unref (connection); } @@ -559,8 +563,8 @@ test_update_secrets_wifi_bad_setting_name (void) g_assert_error (error, NM_CONNECTION_ERROR, NM_CONNECTION_ERROR_SETTING_NOT_FOUND); g_assert (success == FALSE); + g_clear_error (&error); g_variant_unref (secrets); - g_object_unref (connection); } @@ -668,6 +672,7 @@ test_update_secrets_whole_connection_bad_setting (void) g_assert_error (error, NM_CONNECTION_ERROR, NM_CONNECTION_ERROR_SETTING_NOT_FOUND); g_assert (success == FALSE); + g_clear_error (&error); g_variant_unref (copy); g_object_unref (connection); } diff --git a/libnm-core/tests/test-setting-8021x.c b/libnm-core/tests/test-setting-8021x.c index 637ab81c..992379c7 100644 --- a/libnm-core/tests/test-setting-8021x.c +++ b/libnm-core/tests/test-setting-8021x.c @@ -186,6 +186,7 @@ test_phase2_private_key_import (const char *path, g_object_get (s_8021x, NM_SETTING_802_1X_PHASE2_PRIVATE_KEY, &tmp_key, NULL); ASSERT (tmp_key != NULL, "phase2-private-key-import", "missing private key value"); check_scheme_path (tmp_key, path); + g_bytes_unref (tmp_key); } else g_assert_not_reached (); @@ -245,6 +246,7 @@ test_wrong_password_keeps_data (const char *path, const char *password) "wrong-password-keeps-data", "unexpected missing error"); ASSERT (format == NM_SETTING_802_1X_CK_FORMAT_UNKNOWN, "wrong-password-keeps-data", "unexpected success reading private key format"); + g_clear_error (&error); /* Make sure the password hasn't changed */ pw = nm_setting_802_1x_get_private_key_password (s_8021x); @@ -342,6 +344,7 @@ test_wrong_phase2_password_keeps_data (const char *path, const char *password) "wrong-phase2-password-keeps-data", "unexpected missing error"); ASSERT (format == NM_SETTING_802_1X_CK_FORMAT_UNKNOWN, "wrong-phase2-password-keeps-data", "unexpected success reading private key format"); + g_clear_error (&error); /* Make sure the password hasn't changed */ pw = nm_setting_802_1x_get_phase2_private_key_password (s_8021x); diff --git a/libnm-core/tests/test-setting-dcb.c b/libnm-core/tests/test-setting-dcb.c index 8adab8ce..f7554e81 100644 --- a/libnm-core/tests/test-setting-dcb.c +++ b/libnm-core/tests/test-setting-dcb.c @@ -28,6 +28,7 @@ #include "nm-setting-dcb.h" #include "nm-connection.h" #include "nm-errors.h" +#include "gsystem-local-alloc.h" #define DCB_FLAGS_ALL (NM_SETTING_DCB_FLAG_ENABLE | \ NM_SETTING_DCB_FLAG_ADVERTISE | \ @@ -36,7 +37,7 @@ static void test_dcb_flags_valid (void) { - NMSettingDcb *s_dcb; + gs_unref_object NMSettingDcb *s_dcb = NULL; GError *error = NULL; gboolean success; guint i; @@ -89,7 +90,7 @@ test_dcb_flags_valid (void) static void test_dcb_flags_invalid (void) { - NMSettingDcb *s_dcb; + gs_unref_object NMSettingDcb *s_dcb = NULL; GError *error = NULL; gboolean success; @@ -148,7 +149,7 @@ test_dcb_flags_invalid (void) static void test_dcb_app_priorities (void) { - NMSettingDcb *s_dcb; + gs_unref_object NMSettingDcb *s_dcb = NULL; GError *error = NULL; gboolean success; @@ -210,7 +211,7 @@ test_dcb_app_priorities (void) static void test_dcb_priorities_valid (void) { - NMSettingDcb *s_dcb; + gs_unref_object NMSettingDcb *s_dcb = NULL; GError *error = NULL; gboolean success; guint i; @@ -269,7 +270,7 @@ test_dcb_priorities_valid (void) static void test_dcb_bandwidth_sums (void) { - NMSettingDcb *s_dcb; + gs_unref_object NMSettingDcb *s_dcb = NULL; GError *error = NULL; gboolean success; diff --git a/libnm-glib/Makefile.in b/libnm-glib/Makefile.in index a6c5d03a..5c3254af 100644 --- a/libnm-glib/Makefile.in +++ b/libnm-glib/Makefile.in @@ -1,7 +1,7 @@ -# Makefile.in generated by automake 1.13.4 from Makefile.am. +# Makefile.in generated by automake 1.15 from Makefile.am. # @configure_input@ -# Copyright (C) 1994-2013 Free Software Foundation, Inc. +# Copyright (C) 1994-2014 Free Software Foundation, Inc. # This Makefile.in is free software; the Free Software Foundation # gives unlimited permission to copy and/or distribute it, @@ -18,7 +18,17 @@ VPATH = @srcdir@ -am__is_gnu_make = test -n '$(MAKEFILE_LIST)' && test -n '$(MAKELEVEL)' +am__is_gnu_make = { \ + if test -z '$(MAKELEVEL)'; then \ + false; \ + elif test -n '$(MAKE_HOST)'; then \ + true; \ + elif test -n '$(MAKE_VERSION)' && test -n '$(CURDIR)'; then \ + true; \ + else \ + false; \ + fi; \ +} am__make_running_with_option = \ case $${target_option-} in \ ?) ;; \ @@ -85,10 +95,6 @@ noinst_PROGRAMS = libnm-glib-test$(EXEEXT) @HAVE_INTROSPECTION_TRUE@am__append_1 = NMClient-1.0.gir @HAVE_INTROSPECTION_TRUE@am__append_2 = $(gir_DATA) $(typelib_DATA) subdir = libnm-glib -DIST_COMMON = $(srcdir)/Makefile.in $(srcdir)/Makefile.am \ - $(srcdir)/libnm-glib.pc.in $(srcdir)/libnm-glib-vpn.pc.in \ - $(top_srcdir)/build-aux/depcomp $(libdeprecated_HEADERS) \ - $(libnminclude_HEADERS) $(libnmvpn_HEADERS) ACLOCAL_M4 = $(top_srcdir)/aclocal.m4 am__aclocal_m4_deps = $(top_srcdir)/m4/ax_lib_readline.m4 \ $(top_srcdir)/m4/compiler_warnings.m4 \ @@ -105,6 +111,8 @@ am__aclocal_m4_deps = $(top_srcdir)/m4/ax_lib_readline.m4 \ $(top_srcdir)/m4/vapigen.m4 $(top_srcdir)/configure.ac am__configure_deps = $(am__aclocal_m4_deps) $(CONFIGURE_DEPENDENCIES) \ $(ACLOCAL_M4) +DIST_COMMON = $(srcdir)/Makefile.am $(libdeprecated_HEADERS) \ + $(libnminclude_HEADERS) $(libnmvpn_HEADERS) $(am__DIST_COMMON) mkinstalldirs = $(install_sh) -d CONFIG_HEADER = $(top_builddir)/config.h CONFIG_CLEAN_FILES = libnm-glib.pc libnm-glib-vpn.pc @@ -294,6 +302,8 @@ am__define_uniq_tagged_files = \ ETAGS = etags CTAGS = ctags DIST_SUBDIRS = $(SUBDIRS) +am__DIST_COMMON = $(srcdir)/Makefile.in $(srcdir)/libnm-glib-vpn.pc.in \ + $(srcdir)/libnm-glib.pc.in $(top_srcdir)/build-aux/depcomp DISTFILES = $(DIST_COMMON) $(DIST_SOURCES) $(TEXINFOS) $(EXTRA_DIST) am__relativize = \ dir0=`pwd`; \ @@ -345,7 +355,6 @@ CXXCPP = @CXXCPP@ CXXDEPMODE = @CXXDEPMODE@ CXXFLAGS = @CXXFLAGS@ CYGPATH_W = @CYGPATH_W@ -DATADIRNAME = @DATADIRNAME@ DBUS_CFLAGS = @DBUS_CFLAGS@ DBUS_GLIB_100_CFLAGS = @DBUS_GLIB_100_CFLAGS@ DBUS_GLIB_100_LIBS = @DBUS_GLIB_100_LIBS@ @@ -380,6 +389,7 @@ GNUTLS_CFLAGS = @GNUTLS_CFLAGS@ GNUTLS_LIBS = @GNUTLS_LIBS@ GREP = @GREP@ GTKDOC_CHECK = @GTKDOC_CHECK@ +GTKDOC_CHECK_PATH = @GTKDOC_CHECK_PATH@ GTKDOC_DEPS_CFLAGS = @GTKDOC_DEPS_CFLAGS@ GTKDOC_DEPS_LIBS = @GTKDOC_DEPS_LIBS@ GTKDOC_MKPDF = @GTKDOC_MKPDF@ @@ -776,7 +786,6 @@ $(srcdir)/Makefile.in: @MAINTAINER_MODE_TRUE@ $(srcdir)/Makefile.am $(am__confi echo ' cd $(top_srcdir) && $(AUTOMAKE) --gnu libnm-glib/Makefile'; \ $(am__cd) $(top_srcdir) && \ $(AUTOMAKE) --gnu libnm-glib/Makefile -.PRECIOUS: Makefile Makefile: $(srcdir)/Makefile.in $(top_builddir)/config.status @case '$?' in \ *config.status*) \ @@ -916,14 +925,14 @@ distclean-compile: @am__fastdepCC_TRUE@ $(AM_V_at)$(am__mv) $(DEPDIR)/$*.Tpo $(DEPDIR)/$*.Po @AMDEP_TRUE@@am__fastdepCC_FALSE@ $(AM_V_CC)source='$<' object='$@' libtool=no @AMDEPBACKSLASH@ @AMDEP_TRUE@@am__fastdepCC_FALSE@ DEPDIR=$(DEPDIR) $(CCDEPMODE) $(depcomp) @AMDEPBACKSLASH@ -@am__fastdepCC_FALSE@ $(AM_V_CC@am__nodep@)$(COMPILE) -c $< +@am__fastdepCC_FALSE@ $(AM_V_CC@am__nodep@)$(COMPILE) -c -o $@ $< .c.obj: @am__fastdepCC_TRUE@ $(AM_V_CC)$(COMPILE) -MT $@ -MD -MP -MF $(DEPDIR)/$*.Tpo -c -o $@ `$(CYGPATH_W) '$<'` @am__fastdepCC_TRUE@ $(AM_V_at)$(am__mv) $(DEPDIR)/$*.Tpo $(DEPDIR)/$*.Po @AMDEP_TRUE@@am__fastdepCC_FALSE@ $(AM_V_CC)source='$<' object='$@' libtool=no @AMDEPBACKSLASH@ @AMDEP_TRUE@@am__fastdepCC_FALSE@ DEPDIR=$(DEPDIR) $(CCDEPMODE) $(depcomp) @AMDEPBACKSLASH@ -@am__fastdepCC_FALSE@ $(AM_V_CC@am__nodep@)$(COMPILE) -c `$(CYGPATH_W) '$<'` +@am__fastdepCC_FALSE@ $(AM_V_CC@am__nodep@)$(COMPILE) -c -o $@ `$(CYGPATH_W) '$<'` .c.lo: @am__fastdepCC_TRUE@ $(AM_V_CC)$(LTCOMPILE) -MT $@ -MD -MP -MF $(DEPDIR)/$*.Tpo -c -o $@ $< @@ -1630,6 +1639,8 @@ uninstall-am: uninstall-girDATA uninstall-libLTLIBRARIES \ uninstall-libnmvpnHEADERS uninstall-pkgconfigDATA \ uninstall-typelibDATA +.PRECIOUS: Makefile + include $(GLIB_MAKEFILE) ##################################################### diff --git a/libnm-glib/nm-client.c b/libnm-glib/nm-client.c index a29664c6..d62a8b63 100644 --- a/libnm-glib/nm-client.c +++ b/libnm-glib/nm-client.c @@ -1420,7 +1420,7 @@ nm_client_get_connectivity (NMClient *client) { NMClientPrivate *priv; - g_return_val_if_fail (NM_IS_CLIENT (client), NM_STATE_UNKNOWN); + g_return_val_if_fail (NM_IS_CLIENT (client), NM_CONNECTIVITY_UNKNOWN); priv = NM_CLIENT_GET_PRIVATE (client); _nm_object_ensure_inited (NM_OBJECT (client)); @@ -1548,7 +1548,7 @@ nm_client_check_connectivity_async (NMClient *client, g_return_if_fail (NM_IS_CLIENT (client)); priv = NM_CLIENT_GET_PRIVATE (client); - ccd = g_slice_new (CheckConnectivityData); + ccd = g_slice_new0 (CheckConnectivityData); ccd->client = client; simple = g_simple_async_result_new (G_OBJECT (client), callback, user_data, diff --git a/libnm-glib/nm-remote-settings.c b/libnm-glib/nm-remote-settings.c index 74ed083f..d5f4ca67 100644 --- a/libnm-glib/nm-remote-settings.c +++ b/libnm-glib/nm-remote-settings.c @@ -511,6 +511,8 @@ connection_inited (GObject *source, GAsyncResult *result, gpointer user_data) priv->init_left--; if (priv->init_left == 0) g_signal_emit (self, signals[CONNECTIONS_READ], 0); + + g_object_unref (self); } static NMRemoteConnection * @@ -533,7 +535,7 @@ new_connection_cb (DBusGProxy *proxy, const char *path, gpointer user_data) if (connection) { g_async_initable_init_async (G_ASYNC_INITABLE (connection), G_PRIORITY_DEFAULT, NULL, - connection_inited, self); + connection_inited, g_object_ref (self)); /* Add the connection to the pending table to wait for it to retrieve * it's settings asynchronously over D-Bus. The connection isn't diff --git a/libnm-glib/tests/Makefile.am b/libnm-glib/tests/Makefile.am index 7b8f3627..cea3b79a 100644 --- a/libnm-glib/tests/Makefile.am +++ b/libnm-glib/tests/Makefile.am @@ -12,6 +12,11 @@ AM_CPPFLAGS = \ noinst_PROGRAMS = $(TESTS) +if WITH_VALGRIND +@VALGRIND_RULES@ --launch-dbus +else +TESTS_ENVIRONMENT = $(srcdir)/libnm-glib-test-launch.sh +endif TESTS = test-nm-client test-remote-settings-client ####### NMClient and non-settings tests ####### @@ -42,8 +47,6 @@ test_remote_settings_client_LDADD = \ ########################################### -TESTS_ENVIRONMENT = $(srcdir)/libnm-glib-test-launch.sh - endif EXTRA_DIST = libnm-glib-test-launch.sh diff --git a/libnm-glib/tests/Makefile.in b/libnm-glib/tests/Makefile.in index 7dd74031..82530978 100644 --- a/libnm-glib/tests/Makefile.in +++ b/libnm-glib/tests/Makefile.in @@ -1,7 +1,7 @@ -# Makefile.in generated by automake 1.13.4 from Makefile.am. +# Makefile.in generated by automake 1.15 from Makefile.am. # @configure_input@ -# Copyright (C) 1994-2013 Free Software Foundation, Inc. +# Copyright (C) 1994-2014 Free Software Foundation, Inc. # This Makefile.in is free software; the Free Software Foundation # gives unlimited permission to copy and/or distribute it, @@ -15,7 +15,17 @@ @SET_MAKE@ VPATH = @srcdir@ -am__is_gnu_make = test -n '$(MAKEFILE_LIST)' && test -n '$(MAKELEVEL)' +am__is_gnu_make = { \ + if test -z '$(MAKELEVEL)'; then \ + false; \ + elif test -n '$(MAKE_HOST)'; then \ + true; \ + elif test -n '$(MAKE_VERSION)' && test -n '$(CURDIR)'; then \ + true; \ + else \ + false; \ + fi; \ +} am__make_running_with_option = \ case $${target_option-} in \ ?) ;; \ @@ -82,8 +92,6 @@ host_triplet = @host@ @ENABLE_TESTS_TRUE@TESTS = test-nm-client$(EXEEXT) \ @ENABLE_TESTS_TRUE@ test-remote-settings-client$(EXEEXT) subdir = libnm-glib/tests -DIST_COMMON = $(srcdir)/Makefile.in $(srcdir)/Makefile.am \ - $(top_srcdir)/build-aux/depcomp ACLOCAL_M4 = $(top_srcdir)/aclocal.m4 am__aclocal_m4_deps = $(top_srcdir)/m4/ax_lib_readline.m4 \ $(top_srcdir)/m4/compiler_warnings.m4 \ @@ -100,6 +108,7 @@ am__aclocal_m4_deps = $(top_srcdir)/m4/ax_lib_readline.m4 \ $(top_srcdir)/m4/vapigen.m4 $(top_srcdir)/configure.ac am__configure_deps = $(am__aclocal_m4_deps) $(CONFIGURE_DEPENDENCIES) \ $(ACLOCAL_M4) +DIST_COMMON = $(srcdir)/Makefile.am $(am__DIST_COMMON) mkinstalldirs = $(install_sh) -d CONFIG_HEADER = $(top_builddir)/config.h CONFIG_CLEAN_FILES = @@ -215,6 +224,8 @@ am__tty_colors = { \ std=''; \ fi; \ } +am__DIST_COMMON = $(srcdir)/Makefile.in \ + $(top_srcdir)/build-aux/depcomp DISTFILES = $(DIST_COMMON) $(DIST_SOURCES) $(TEXINFOS) $(EXTRA_DIST) ACLOCAL = @ACLOCAL@ ALL_LINGUAS = @ALL_LINGUAS@ @@ -241,7 +252,6 @@ CXXCPP = @CXXCPP@ CXXDEPMODE = @CXXDEPMODE@ CXXFLAGS = @CXXFLAGS@ CYGPATH_W = @CYGPATH_W@ -DATADIRNAME = @DATADIRNAME@ DBUS_CFLAGS = @DBUS_CFLAGS@ DBUS_GLIB_100_CFLAGS = @DBUS_GLIB_100_CFLAGS@ DBUS_GLIB_100_LIBS = @DBUS_GLIB_100_LIBS@ @@ -276,6 +286,7 @@ GNUTLS_CFLAGS = @GNUTLS_CFLAGS@ GNUTLS_LIBS = @GNUTLS_LIBS@ GREP = @GREP@ GTKDOC_CHECK = @GTKDOC_CHECK@ +GTKDOC_CHECK_PATH = @GTKDOC_CHECK_PATH@ GTKDOC_DEPS_CFLAGS = @GTKDOC_DEPS_CFLAGS@ GTKDOC_DEPS_LIBS = @GTKDOC_DEPS_LIBS@ GTKDOC_MKPDF = @GTKDOC_MKPDF@ @@ -486,6 +497,7 @@ with_valgrind = @with_valgrind@ @ENABLE_TESTS_TRUE@ $(GLIB_CFLAGS) \ @ENABLE_TESTS_TRUE@ $(DBUS_CFLAGS) +@ENABLE_TESTS_TRUE@@WITH_VALGRIND_FALSE@TESTS_ENVIRONMENT = $(srcdir)/libnm-glib-test-launch.sh ####### NMClient and non-settings tests ####### @ENABLE_TESTS_TRUE@test_nm_client_SOURCES = \ @@ -514,7 +526,6 @@ with_valgrind = @with_valgrind@ ########################################### -@ENABLE_TESTS_TRUE@TESTS_ENVIRONMENT = $(srcdir)/libnm-glib-test-launch.sh EXTRA_DIST = libnm-glib-test-launch.sh all: all-am @@ -532,7 +543,6 @@ $(srcdir)/Makefile.in: @MAINTAINER_MODE_TRUE@ $(srcdir)/Makefile.am $(am__confi echo ' cd $(top_srcdir) && $(AUTOMAKE) --gnu libnm-glib/tests/Makefile'; \ $(am__cd) $(top_srcdir) && \ $(AUTOMAKE) --gnu libnm-glib/tests/Makefile -.PRECIOUS: Makefile Makefile: $(srcdir)/Makefile.in $(top_builddir)/config.status @case '$?' in \ *config.status*) \ @@ -583,14 +593,14 @@ distclean-compile: @am__fastdepCC_TRUE@ $(AM_V_at)$(am__mv) $(DEPDIR)/$*.Tpo $(DEPDIR)/$*.Po @AMDEP_TRUE@@am__fastdepCC_FALSE@ $(AM_V_CC)source='$<' object='$@' libtool=no @AMDEPBACKSLASH@ @AMDEP_TRUE@@am__fastdepCC_FALSE@ DEPDIR=$(DEPDIR) $(CCDEPMODE) $(depcomp) @AMDEPBACKSLASH@ -@am__fastdepCC_FALSE@ $(AM_V_CC@am__nodep@)$(COMPILE) -c $< +@am__fastdepCC_FALSE@ $(AM_V_CC@am__nodep@)$(COMPILE) -c -o $@ $< .c.obj: @am__fastdepCC_TRUE@ $(AM_V_CC)$(COMPILE) -MT $@ -MD -MP -MF $(DEPDIR)/$*.Tpo -c -o $@ `$(CYGPATH_W) '$<'` @am__fastdepCC_TRUE@ $(AM_V_at)$(am__mv) $(DEPDIR)/$*.Tpo $(DEPDIR)/$*.Po @AMDEP_TRUE@@am__fastdepCC_FALSE@ $(AM_V_CC)source='$<' object='$@' libtool=no @AMDEPBACKSLASH@ @AMDEP_TRUE@@am__fastdepCC_FALSE@ DEPDIR=$(DEPDIR) $(CCDEPMODE) $(depcomp) @AMDEPBACKSLASH@ -@am__fastdepCC_FALSE@ $(AM_V_CC@am__nodep@)$(COMPILE) -c `$(CYGPATH_W) '$<'` +@am__fastdepCC_FALSE@ $(AM_V_CC@am__nodep@)$(COMPILE) -c -o $@ `$(CYGPATH_W) '$<'` .c.lo: @am__fastdepCC_TRUE@ $(AM_V_CC)$(LTCOMPILE) -MT $@ -MD -MP -MF $(DEPDIR)/$*.Tpo -c -o $@ $< @@ -902,6 +912,10 @@ uninstall-am: mostlyclean-generic mostlyclean-libtool pdf pdf-am ps ps-am \ tags tags-am uninstall uninstall-am +.PRECIOUS: Makefile + + +@ENABLE_TESTS_TRUE@@WITH_VALGRIND_TRUE@@VALGRIND_RULES@ --launch-dbus # Tell versions [3.59,3.63) of GNU make to not export all variables. # Otherwise a system limit (for SysV at least) may be exceeded. diff --git a/libnm-glib/tests/test-remote-settings-client.c b/libnm-glib/tests/test-remote-settings-client.c index 237e287f..a109f8df 100644 --- a/libnm-glib/tests/test-remote-settings-client.c +++ b/libnm-glib/tests/test-remote-settings-client.c @@ -36,6 +36,7 @@ #include "nm-remote-settings.h" #include "common.h" +#include "gsystem-local-alloc.h" static NMTestServiceInfo *sinfo; static NMRemoteSettings *settings = NULL; @@ -63,7 +64,7 @@ add_cb (NMRemoteSettings *s, static void test_add_connection (void) { - NMConnection *connection; + gs_unref_object NMConnection *connection = NULL; NMSettingConnection *s_con; NMSettingWired *s_wired; char *uuid; @@ -256,6 +257,7 @@ test_make_visible (void) break; } } + g_slist_free (list); g_assert (found == TRUE); g_free (path); @@ -298,6 +300,7 @@ test_remove_connection (void) g_assert_cmpint (g_slist_length (list), >, 0); connection = NM_REMOTE_CONNECTION (list->data); + g_slist_free (list); g_assert (connection); g_assert (remote == connection); path = g_strdup (nm_connection_get_path (NM_CONNECTION (connection))); @@ -329,6 +332,7 @@ test_remove_connection (void) g_assert ((gpointer) connection != (gpointer) candidate); g_assert_cmpstr (path, ==, nm_connection_get_path (candidate)); } + g_slist_free (list); g_free (path); g_object_unref (proxy); diff --git a/libnm-util/Makefile.am b/libnm-util/Makefile.am index 3fdc79e5..fbf8c0b3 100644 --- a/libnm-util/Makefile.am +++ b/libnm-util/Makefile.am @@ -155,7 +155,6 @@ pkgconfigdir = $(libdir)/pkgconfig pkgconfig_DATA = libnm-util.pc DISTCLEANFILES = libnm-util.pc -CLEANFILES = nm-version.h EXTRA_DIST = libnm-util.pc.in libnm-util.ver nm-version.h.in @@ -183,7 +182,7 @@ gir_DATA = $(INTROSPECTION_GIRS) typelibdir = $(libdir)/girepository-1.0 typelib_DATA = $(INTROSPECTION_GIRS:.gir=.typelib) -CLEANFILES += $(gir_DATA) $(typelib_DATA) +CLEANFILES = $(gir_DATA) $(typelib_DATA) endif diff --git a/libnm-util/Makefile.in b/libnm-util/Makefile.in index 5dea1b42..87271131 100644 --- a/libnm-util/Makefile.in +++ b/libnm-util/Makefile.in @@ -1,7 +1,7 @@ -# Makefile.in generated by automake 1.13.4 from Makefile.am. +# Makefile.in generated by automake 1.15 from Makefile.am. # @configure_input@ -# Copyright (C) 1994-2013 Free Software Foundation, Inc. +# Copyright (C) 1994-2014 Free Software Foundation, Inc. # This Makefile.in is free software; the Free Software Foundation # gives unlimited permission to copy and/or distribute it, @@ -17,7 +17,17 @@ VPATH = @srcdir@ -am__is_gnu_make = test -n '$(MAKEFILE_LIST)' && test -n '$(MAKELEVEL)' +am__is_gnu_make = { \ + if test -z '$(MAKELEVEL)'; then \ + false; \ + elif test -n '$(MAKE_HOST)'; then \ + true; \ + elif test -n '$(MAKE_VERSION)' && test -n '$(CURDIR)'; then \ + true; \ + else \ + false; \ + fi; \ +} am__make_running_with_option = \ case $${target_option-} in \ ?) ;; \ @@ -91,12 +101,7 @@ host_triplet = @host@ @WITH_NSS_TRUE@am__append_9 = crypto_nss.c @WITH_NSS_TRUE@am__append_10 = $(NSS_LIBS) @HAVE_INTROSPECTION_TRUE@am__append_11 = NetworkManager-1.0.gir -@HAVE_INTROSPECTION_TRUE@am__append_12 = $(gir_DATA) $(typelib_DATA) subdir = libnm-util -DIST_COMMON = $(srcdir)/Makefile.in $(srcdir)/Makefile.am \ - $(srcdir)/libnm-util.pc.in $(srcdir)/nm-version.h.in \ - $(top_srcdir)/build-aux/depcomp $(libnm_util_include_HEADERS) \ - COPYING ACLOCAL_M4 = $(top_srcdir)/aclocal.m4 am__aclocal_m4_deps = $(top_srcdir)/m4/ax_lib_readline.m4 \ $(top_srcdir)/m4/compiler_warnings.m4 \ @@ -113,6 +118,8 @@ am__aclocal_m4_deps = $(top_srcdir)/m4/ax_lib_readline.m4 \ $(top_srcdir)/m4/vapigen.m4 $(top_srcdir)/configure.ac am__configure_deps = $(am__aclocal_m4_deps) $(CONFIGURE_DEPENDENCIES) \ $(ACLOCAL_M4) +DIST_COMMON = $(srcdir)/Makefile.am $(libnm_util_include_HEADERS) \ + $(am__DIST_COMMON) mkinstalldirs = $(install_sh) -d CONFIG_HEADER = $(top_builddir)/config.h CONFIG_CLEAN_FILES = libnm-util.pc nm-version.h @@ -285,6 +292,9 @@ am__define_uniq_tagged_files = \ ETAGS = etags CTAGS = ctags DIST_SUBDIRS = $(SUBDIRS) +am__DIST_COMMON = $(srcdir)/Makefile.in $(srcdir)/libnm-util.pc.in \ + $(srcdir)/nm-version.h.in $(top_srcdir)/build-aux/depcomp \ + COPYING DISTFILES = $(DIST_COMMON) $(DIST_SOURCES) $(TEXINFOS) $(EXTRA_DIST) am__relativize = \ dir0=`pwd`; \ @@ -336,7 +346,6 @@ CXXCPP = @CXXCPP@ CXXDEPMODE = @CXXDEPMODE@ CXXFLAGS = @CXXFLAGS@ CYGPATH_W = @CYGPATH_W@ -DATADIRNAME = @DATADIRNAME@ DBUS_CFLAGS = @DBUS_CFLAGS@ DBUS_GLIB_100_CFLAGS = @DBUS_GLIB_100_CFLAGS@ DBUS_GLIB_100_LIBS = @DBUS_GLIB_100_LIBS@ @@ -371,6 +380,7 @@ GNUTLS_CFLAGS = @GNUTLS_CFLAGS@ GNUTLS_LIBS = @GNUTLS_LIBS@ GREP = @GREP@ GTKDOC_CHECK = @GTKDOC_CHECK@ +GTKDOC_CHECK_PATH = @GTKDOC_CHECK_PATH@ GTKDOC_DEPS_CFLAGS = @GTKDOC_DEPS_CFLAGS@ GTKDOC_DEPS_LIBS = @GTKDOC_DEPS_LIBS@ GTKDOC_MKPDF = @GTKDOC_MKPDF@ @@ -682,7 +692,6 @@ libtest_crypto_la_LIBADD = $(GLIB_LIBS) $(am__append_8) \ pkgconfigdir = $(libdir)/pkgconfig pkgconfig_DATA = libnm-util.pc DISTCLEANFILES = libnm-util.pc -CLEANFILES = nm-version.h $(am__append_12) EXTRA_DIST = libnm-util.pc.in libnm-util.ver nm-version.h.in INTROSPECTION_GIRS = $(am__append_11) INTROSPECTION_SCANNER_ARGS = --add-include-path=$(srcdir) @@ -699,6 +708,7 @@ INTROSPECTION_COMPILER_ARGS = --includedir=$(srcdir) @HAVE_INTROSPECTION_TRUE@gir_DATA = $(INTROSPECTION_GIRS) @HAVE_INTROSPECTION_TRUE@typelibdir = $(libdir)/girepository-1.0 @HAVE_INTROSPECTION_TRUE@typelib_DATA = $(INTROSPECTION_GIRS:.gir=.typelib) +@HAVE_INTROSPECTION_TRUE@CLEANFILES = $(gir_DATA) $(typelib_DATA) all: $(BUILT_SOURCES) $(MAKE) $(AM_MAKEFLAGS) all-recursive @@ -716,7 +726,6 @@ $(srcdir)/Makefile.in: @MAINTAINER_MODE_TRUE@ $(srcdir)/Makefile.am $(am__confi echo ' cd $(top_srcdir) && $(AUTOMAKE) --gnu libnm-util/Makefile'; \ $(am__cd) $(top_srcdir) && \ $(AUTOMAKE) --gnu libnm-util/Makefile -.PRECIOUS: Makefile Makefile: $(srcdir)/Makefile.in $(top_builddir)/config.status @case '$?' in \ *config.status*) \ @@ -838,14 +847,14 @@ distclean-compile: @am__fastdepCC_TRUE@ $(AM_V_at)$(am__mv) $(DEPDIR)/$*.Tpo $(DEPDIR)/$*.Po @AMDEP_TRUE@@am__fastdepCC_FALSE@ $(AM_V_CC)source='$<' object='$@' libtool=no @AMDEPBACKSLASH@ @AMDEP_TRUE@@am__fastdepCC_FALSE@ DEPDIR=$(DEPDIR) $(CCDEPMODE) $(depcomp) @AMDEPBACKSLASH@ -@am__fastdepCC_FALSE@ $(AM_V_CC@am__nodep@)$(COMPILE) -c $< +@am__fastdepCC_FALSE@ $(AM_V_CC@am__nodep@)$(COMPILE) -c -o $@ $< .c.obj: @am__fastdepCC_TRUE@ $(AM_V_CC)$(COMPILE) -MT $@ -MD -MP -MF $(DEPDIR)/$*.Tpo -c -o $@ `$(CYGPATH_W) '$<'` @am__fastdepCC_TRUE@ $(AM_V_at)$(am__mv) $(DEPDIR)/$*.Tpo $(DEPDIR)/$*.Po @AMDEP_TRUE@@am__fastdepCC_FALSE@ $(AM_V_CC)source='$<' object='$@' libtool=no @AMDEPBACKSLASH@ @AMDEP_TRUE@@am__fastdepCC_FALSE@ DEPDIR=$(DEPDIR) $(CCDEPMODE) $(depcomp) @AMDEPBACKSLASH@ -@am__fastdepCC_FALSE@ $(AM_V_CC@am__nodep@)$(COMPILE) -c `$(CYGPATH_W) '$<'` +@am__fastdepCC_FALSE@ $(AM_V_CC@am__nodep@)$(COMPILE) -c -o $@ `$(CYGPATH_W) '$<'` .c.lo: @am__fastdepCC_TRUE@ $(AM_V_CC)$(LTCOMPILE) -MT $@ -MD -MP -MF $(DEPDIR)/$*.Tpo -c -o $@ $< @@ -1264,6 +1273,8 @@ uninstall-am: uninstall-girDATA uninstall-libLTLIBRARIES \ uninstall-nodist_libnm_util_includeHEADERS \ uninstall-pkgconfigDATA uninstall-typelibDATA +.PRECIOUS: Makefile + include $(GLIB_MAKEFILE) -include $(INTROSPECTION_MAKEFILE) diff --git a/libnm-util/NetworkManager.h b/libnm-util/NetworkManager.h index 08b4e6cf..5a98b8e4 100644 --- a/libnm-util/NetworkManager.h +++ b/libnm-util/NetworkManager.h @@ -204,6 +204,9 @@ typedef enum { * @NM_WIFI_DEVICE_CAP_RSN: device supports WPA2/RSN authentication * @NM_WIFI_DEVICE_CAP_AP: device supports Access Point mode * @NM_WIFI_DEVICE_CAP_ADHOC: device supports Ad-Hoc mode + * @NM_WIFI_DEVICE_CAP_FREQ_VALID: device reports frequency capabilities + * @NM_WIFI_DEVICE_CAP_FREQ_2GHZ: device supports 2.4GHz frequencies + * @NM_WIFI_DEVICE_CAP_FREQ_5GHZ: device supports 5GHz frequencies * * 802.11 specific device encryption and authentication capabilities. * @@ -218,7 +221,10 @@ typedef enum { NM_WIFI_DEVICE_CAP_WPA = 0x00000010, NM_WIFI_DEVICE_CAP_RSN = 0x00000020, NM_WIFI_DEVICE_CAP_AP = 0x00000040, - NM_WIFI_DEVICE_CAP_ADHOC = 0x00000080 + NM_WIFI_DEVICE_CAP_ADHOC = 0x00000080, + NM_WIFI_DEVICE_CAP_FREQ_VALID = 0x00000100, + NM_WIFI_DEVICE_CAP_FREQ_2GHZ = 0x00000200, + NM_WIFI_DEVICE_CAP_FREQ_5GHZ = 0x00000400, } NMDeviceWifiCapabilities; @@ -465,6 +471,7 @@ typedef enum { * @NM_DEVICE_STATE_REASON_MODEM_FAILED: Modem failed or no longer available * @NM_DEVICE_STATE_REASON_MODEM_AVAILABLE: Modem now ready and available * @NM_DEVICE_STATE_REASON_SIM_PIN_INCORRECT: SIM PIN was incorrect + * @NM_DEVICE_STATE_REASON_NEW_ACTIVATION: New connection activation was enqueued * * Device state change reason codes * @@ -531,6 +538,7 @@ typedef enum { NM_DEVICE_STATE_REASON_MODEM_FAILED = 57, NM_DEVICE_STATE_REASON_MODEM_AVAILABLE = 58, NM_DEVICE_STATE_REASON_SIM_PIN_INCORRECT = 59, + NM_DEVICE_STATE_REASON_NEW_ACTIVATION = 60, NM_DEVICE_STATE_REASON_LAST = 0xFFFF } NMDeviceStateReason; diff --git a/libnm-util/nm-connection.c b/libnm-util/nm-connection.c index a1350f54..3a929b04 100644 --- a/libnm-util/nm-connection.c +++ b/libnm-util/nm-connection.c @@ -1241,7 +1241,7 @@ nm_connection_to_hash (NMConnection *connection, NMSettingHashFlags flags) g_return_val_if_fail (NM_IS_CONNECTION (connection), NULL); ret = g_hash_table_new_full (g_str_hash, g_str_equal, - g_free, (GDestroyNotify) g_hash_table_destroy); + g_free, (GDestroyNotify) g_hash_table_unref); priv = NM_CONNECTION_GET_PRIVATE (connection); diff --git a/libnm-util/nm-setting-adsl.c b/libnm-util/nm-setting-adsl.c index 601ebc2b..5355011c 100644 --- a/libnm-util/nm-setting-adsl.c +++ b/libnm-util/nm-setting-adsl.c @@ -219,15 +219,6 @@ verify (NMSetting *setting, GSList *all_settings, GError **error) return FALSE; } - if (priv->password && !strlen (priv->password)) { - g_set_error_literal (error, - NM_SETTING_ADSL_ERROR, - NM_SETTING_ADSL_ERROR_INVALID_PROPERTY, - _("property is empty")); - g_prefix_error (error, "%s.%s: ", NM_SETTING_ADSL_SETTING_NAME, NM_SETTING_ADSL_PASSWORD); - return FALSE; - } - if ( !priv->protocol || ( strcmp (priv->protocol, NM_SETTING_ADSL_PROTOCOL_PPPOA) && strcmp (priv->protocol, NM_SETTING_ADSL_PROTOCOL_PPPOE) @@ -262,7 +253,7 @@ need_secrets (NMSetting *setting) NMSettingAdslPrivate *priv = NM_SETTING_ADSL_GET_PRIVATE (setting); GPtrArray *secrets = NULL; - if (priv->password) + if (priv->password && *priv->password) return NULL; if (!(priv->password_flags & NM_SETTING_SECRET_FLAG_NOT_REQUIRED)) { diff --git a/libnm-util/nm-setting-cdma.c b/libnm-util/nm-setting-cdma.c index 44a893c7..53f886ec 100644 --- a/libnm-util/nm-setting-cdma.c +++ b/libnm-util/nm-setting-cdma.c @@ -181,15 +181,6 @@ verify (NMSetting *setting, GSList *all_settings, GError **error) return FALSE; } - if (priv->password && !strlen (priv->password)) { - g_set_error_literal (error, - NM_SETTING_CDMA_ERROR, - NM_SETTING_CDMA_ERROR_INVALID_PROPERTY, - _("property is empty")); - g_prefix_error (error, "%s.%s: ", NM_SETTING_CDMA_SETTING_NAME, NM_SETTING_CDMA_PASSWORD); - return FALSE; - } - return TRUE; } @@ -199,7 +190,7 @@ need_secrets (NMSetting *setting) NMSettingCdmaPrivate *priv = NM_SETTING_CDMA_GET_PRIVATE (setting); GPtrArray *secrets = NULL; - if (priv->password) + if (priv->password && *priv->password) return NULL; if (priv->username) { diff --git a/libnm-util/nm-setting-connection.c b/libnm-util/nm-setting-connection.c index 162ae7cb..bda89d63 100644 --- a/libnm-util/nm-setting-connection.c +++ b/libnm-util/nm-setting-connection.c @@ -882,19 +882,21 @@ verify (NMSetting *setting, GSList *all_settings, GError **error) if (is_slave) { if (!priv->master) { - g_set_error_literal (error, - NM_SETTING_CONNECTION_ERROR, - NM_SETTING_CONNECTION_ERROR_MISSING_PROPERTY, - _("Slave connections need a valid '" NM_SETTING_CONNECTION_MASTER "' property")); + g_set_error (error, + NM_SETTING_CONNECTION_ERROR, + NM_SETTING_CONNECTION_ERROR_MISSING_PROPERTY, + _("Slave connections need a valid '%s' property"), + NM_SETTING_CONNECTION_MASTER); g_prefix_error (error, "%s.%s: ", NM_SETTING_CONNECTION_SETTING_NAME, NM_SETTING_CONNECTION_MASTER); return NM_SETTING_VERIFY_ERROR; } } else { if (priv->master) { - g_set_error_literal (error, - NM_SETTING_CONNECTION_ERROR, - NM_SETTING_CONNECTION_ERROR_MISSING_PROPERTY, - _("Cannot set '" NM_SETTING_CONNECTION_MASTER "' without '" NM_SETTING_CONNECTION_SLAVE_TYPE "'")); + g_set_error (error, + NM_SETTING_CONNECTION_ERROR, + NM_SETTING_CONNECTION_ERROR_MISSING_PROPERTY, + _("Cannot set '%s' without '%s'"), + NM_SETTING_CONNECTION_MASTER, NM_SETTING_CONNECTION_SLAVE_TYPE); g_prefix_error (error, "%s.%s: ", NM_SETTING_CONNECTION_SETTING_NAME, NM_SETTING_CONNECTION_SLAVE_TYPE); return NM_SETTING_VERIFY_ERROR; } diff --git a/libnm-util/nm-setting-dcb.c b/libnm-util/nm-setting-dcb.c index 2376581e..89ee3878 100644 --- a/libnm-util/nm-setting-dcb.c +++ b/libnm-util/nm-setting-dcb.c @@ -78,7 +78,7 @@ NM_SETTING_REGISTER_TYPE (NM_TYPE_SETTING_DCB) typedef struct { NMSettingDcbFlags app_fcoe_flags; gint app_fcoe_priority; - const char * app_fcoe_mode; + char * app_fcoe_mode; NMSettingDcbFlags app_iscsi_flags; gint app_iscsi_priority; @@ -833,6 +833,7 @@ set_property (GObject *object, guint prop_id, priv->app_fcoe_priority = g_value_get_int (value); break; case PROP_APP_FCOE_MODE: + g_free (priv->app_fcoe_mode); priv->app_fcoe_mode = g_value_dup_string (value); break; case PROP_APP_ISCSI_FLAGS: @@ -944,6 +945,16 @@ get_property (GObject *object, guint prop_id, } } +static void +finalize (GObject *object) +{ + NMSettingDcbPrivate *priv = NM_SETTING_DCB_GET_PRIVATE (object); + + g_free (priv->app_fcoe_mode); + + G_OBJECT_CLASS (nm_setting_dcb_parent_class)->finalize (object); +} + static void nm_setting_dcb_class_init (NMSettingDcbClass *setting_class) { @@ -955,6 +966,7 @@ nm_setting_dcb_class_init (NMSettingDcbClass *setting_class) /* virtual methods */ object_class->set_property = set_property; object_class->get_property = get_property; + object_class->finalize = finalize; parent_class->verify = verify; /* Properties */ diff --git a/libnm-util/nm-setting-gsm.c b/libnm-util/nm-setting-gsm.c index a17d18b7..e422c92e 100644 --- a/libnm-util/nm-setting-gsm.c +++ b/libnm-util/nm-setting-gsm.c @@ -342,15 +342,6 @@ verify (NMSetting *setting, GSList *all_settings, GError **error) return FALSE; } - if (priv->password && !strlen (priv->password)) { - g_set_error_literal (error, - NM_SETTING_GSM_ERROR, - NM_SETTING_GSM_ERROR_INVALID_PROPERTY, - _("property is empty")); - g_prefix_error (error, "%s.%s: ", NM_SETTING_GSM_SETTING_NAME, NM_SETTING_GSM_USERNAME); - return FALSE; - } - if (priv->network_id) { guint32 nid_len = strlen (priv->network_id); guint32 i; @@ -388,7 +379,7 @@ need_secrets (NMSetting *setting) NMSettingGsmPrivate *priv = NM_SETTING_GSM_GET_PRIVATE (setting); GPtrArray *secrets = NULL; - if (priv->password) + if (priv->password && *priv->password) return NULL; if (priv->username) { diff --git a/libnm-util/nm-setting-ip4-config.c b/libnm-util/nm-setting-ip4-config.c index 532231ab..4db43cbc 100644 --- a/libnm-util/nm-setting-ip4-config.c +++ b/libnm-util/nm-setting-ip4-config.c @@ -959,16 +959,6 @@ verify (NMSetting *setting, GSList *all_settings, GError **error) NMIP4Route *route = (NMIP4Route *) iter->data; guint32 prefix = nm_ip4_route_get_prefix (route); - if (!nm_ip4_route_get_dest (route)) { - g_set_error (error, - NM_SETTING_IP4_CONFIG_ERROR, - NM_SETTING_IP4_CONFIG_ERROR_INVALID_PROPERTY, - _("%d. route is invalid"), - i+1); - g_prefix_error (error, "%s.%s: ", NM_SETTING_IP4_CONFIG_SETTING_NAME, NM_SETTING_IP4_CONFIG_ROUTES); - return FALSE; - } - if (!prefix || prefix > 32) { g_set_error (error, NM_SETTING_IP4_CONFIG_ERROR, diff --git a/libnm-util/nm-setting-ip6-config.c b/libnm-util/nm-setting-ip6-config.c index 654f0496..4e69a072 100644 --- a/libnm-util/nm-setting-ip6-config.c +++ b/libnm-util/nm-setting-ip6-config.c @@ -825,6 +825,8 @@ static gboolean verify (NMSetting *setting, GSList *all_settings, GError **error) { NMSettingIP6ConfigPrivate *priv = NM_SETTING_IP6_CONFIG_GET_PRIVATE (setting); + GSList *iter; + int i; if (!priv->method) { g_set_error_literal (error, @@ -899,6 +901,48 @@ verify (NMSetting *setting, GSList *all_settings, GError **error) return FALSE; } + /* Validate addresses */ + for (iter = priv->addresses, i = 0; iter; iter = g_slist_next (iter), i++) { + NMIP6Address *addr = (NMIP6Address *) iter->data; + guint32 prefix = nm_ip6_address_get_prefix (addr); + + if (IN6_IS_ADDR_UNSPECIFIED (nm_ip6_address_get_address (addr))) { + g_set_error (error, + NM_SETTING_IP6_CONFIG_ERROR, + NM_SETTING_IP6_CONFIG_ERROR_INVALID_PROPERTY, + _("%d. IPv6 address is invalid"), + i+1); + g_prefix_error (error, "%s.%s: ", NM_SETTING_IP6_CONFIG_SETTING_NAME, NM_SETTING_IP6_CONFIG_ADDRESSES); + return FALSE; + } + + if (!prefix || prefix > 128) { + g_set_error (error, + NM_SETTING_IP6_CONFIG_ERROR, + NM_SETTING_IP6_CONFIG_ERROR_INVALID_PROPERTY, + _("%d. IPv6 address has invalid prefix"), + i+1); + g_prefix_error (error, "%s.%s: ", NM_SETTING_IP6_CONFIG_SETTING_NAME, NM_SETTING_IP6_CONFIG_ADDRESSES); + return FALSE; + } + } + + /* Validate routes */ + for (iter = priv->routes, i = 0; iter; iter = g_slist_next (iter), i++) { + NMIP6Route *route = (NMIP6Route *) iter->data; + guint32 prefix = nm_ip6_route_get_prefix (route); + + if (!prefix || prefix > 128) { + g_set_error (error, + NM_SETTING_IP6_CONFIG_ERROR, + NM_SETTING_IP6_CONFIG_ERROR_INVALID_PROPERTY, + _("%d. route has invalid prefix"), + i+1); + g_prefix_error (error, "%s.%s: ", NM_SETTING_IP6_CONFIG_SETTING_NAME, NM_SETTING_IP6_CONFIG_ROUTES); + return FALSE; + } + } + return TRUE; } diff --git a/libnm-util/nm-setting-team-port.c b/libnm-util/nm-setting-team-port.c index 6bc71c98..9992f58a 100644 --- a/libnm-util/nm-setting-team-port.c +++ b/libnm-util/nm-setting-team-port.c @@ -130,6 +130,7 @@ set_property (GObject *object, guint prop_id, switch (prop_id) { case PROP_CONFIG: + g_free (priv->config); priv->config = g_value_dup_string (value); break; default: @@ -154,6 +155,16 @@ get_property (GObject *object, guint prop_id, } } +static void +finalize (GObject *object) +{ + NMSettingTeamPortPrivate *priv = NM_SETTING_TEAM_PORT_GET_PRIVATE (object); + + g_free (priv->config); + + G_OBJECT_CLASS (nm_setting_team_port_parent_class)->finalize (object); +} + static void nm_setting_team_port_class_init (NMSettingTeamPortClass *setting_class) { @@ -165,6 +176,7 @@ nm_setting_team_port_class_init (NMSettingTeamPortClass *setting_class) /* virtual methods */ object_class->set_property = set_property; object_class->get_property = get_property; + object_class->finalize = finalize; parent_class->verify = verify; /* Properties */ diff --git a/libnm-util/nm-setting-wired.c b/libnm-util/nm-setting-wired.c index 8d927921..aba5fb98 100644 --- a/libnm-util/nm-setting-wired.c +++ b/libnm-util/nm-setting-wired.c @@ -474,27 +474,24 @@ nm_setting_wired_get_s390_option (NMSettingWired *setting, const char **out_key, const char **out_value) { - NMSettingWiredPrivate *priv; - guint32 num_keys; - GList *keys; - const char *_key = NULL, *_value = NULL; + const char *_key, *_value; + GHashTableIter iter; + guint i = 0; g_return_val_if_fail (NM_IS_SETTING_WIRED (setting), FALSE); - priv = NM_SETTING_WIRED_GET_PRIVATE (setting); - - num_keys = nm_setting_wired_get_num_s390_options (setting); - g_return_val_if_fail (idx < num_keys, FALSE); - - keys = g_hash_table_get_keys (priv->s390_options); - _key = g_list_nth_data (keys, idx); - _value = g_hash_table_lookup (priv->s390_options, _key); - - if (out_key) - *out_key = _key; - if (out_value) - *out_value = _value; - return TRUE; + g_hash_table_iter_init (&iter, NM_SETTING_WIRED_GET_PRIVATE (setting)->s390_options); + while (g_hash_table_iter_next (&iter, (gpointer) &_key, (gpointer) &_value)) { + if (i == idx) { + if (out_key) + *out_key = _key; + if (out_value) + *out_value = _value; + return TRUE; + } + i++; + } + g_return_val_if_reached (FALSE); } /** diff --git a/libnm-util/nm-setting-wireless-security.c b/libnm-util/nm-setting-wireless-security.c index 5e3456ce..574ff3bd 100644 --- a/libnm-util/nm-setting-wireless-security.c +++ b/libnm-util/nm-setting-wireless-security.c @@ -852,7 +852,7 @@ need_secrets (NMSetting *setting) if ( priv->auth_alg && !strcmp (priv->auth_alg, "leap") && !strcmp (priv->key_mgmt, "ieee8021x")) { - if (!priv->leap_password || !strlen (priv->leap_password)) { + if (!priv->leap_password || !*priv->leap_password) { g_ptr_array_add (secrets, NM_SETTING_WIRELESS_SECURITY_LEAP_PASSWORD); return secrets; } @@ -923,14 +923,6 @@ verify (NMSetting *setting, GSList *all_settings, GError **error) g_prefix_error (error, "%s.%s: ", NM_SETTING_WIRELESS_SECURITY_SETTING_NAME, NM_SETTING_WIRELESS_SECURITY_LEAP_USERNAME); return FALSE; } - if (priv->leap_password && !strlen (priv->leap_password)) { - g_set_error_literal (error, - NM_SETTING_WIRELESS_SECURITY_ERROR, - NM_SETTING_WIRELESS_SECURITY_ERROR_INVALID_PROPERTY, - _("property is empty")); - g_prefix_error (error, "%s.%s: ", NM_SETTING_WIRELESS_SECURITY_SETTING_NAME, NM_SETTING_WIRELESS_SECURITY_LEAP_PASSWORD); - return FALSE; - } } else { if ( (strcmp (priv->key_mgmt, "ieee8021x") == 0) || (strcmp (priv->key_mgmt, "wpa-eap") == 0)) { @@ -975,39 +967,6 @@ verify (NMSetting *setting, GSList *all_settings, GError **error) return FALSE; } - if (priv->wep_key0 && !nm_utils_wep_key_valid (priv->wep_key0, priv->wep_key_type)) { - g_set_error_literal (error, - NM_SETTING_WIRELESS_SECURITY_ERROR, - NM_SETTING_WIRELESS_SECURITY_ERROR_INVALID_PROPERTY, - _("property is invalid")); - g_prefix_error (error, "%s.%s: ", NM_SETTING_WIRELESS_SECURITY_SETTING_NAME, NM_SETTING_WIRELESS_SECURITY_WEP_KEY0); - return FALSE; - } - if (priv->wep_key1 && !nm_utils_wep_key_valid (priv->wep_key1, priv->wep_key_type)) { - g_set_error_literal (error, - NM_SETTING_WIRELESS_SECURITY_ERROR, - NM_SETTING_WIRELESS_SECURITY_ERROR_INVALID_PROPERTY, - _("property is invalid")); - g_prefix_error (error, "%s.%s: ", NM_SETTING_WIRELESS_SECURITY_SETTING_NAME, NM_SETTING_WIRELESS_SECURITY_WEP_KEY1); - return FALSE; - } - if (priv->wep_key2 && !nm_utils_wep_key_valid (priv->wep_key2, priv->wep_key_type)) { - g_set_error_literal (error, - NM_SETTING_WIRELESS_SECURITY_ERROR, - NM_SETTING_WIRELESS_SECURITY_ERROR_INVALID_PROPERTY, - _("property is invalid")); - g_prefix_error (error, "%s.%s: ", NM_SETTING_WIRELESS_SECURITY_SETTING_NAME, NM_SETTING_WIRELESS_SECURITY_WEP_KEY2); - return FALSE; - } - if (priv->wep_key3 && !nm_utils_wep_key_valid (priv->wep_key3, priv->wep_key_type)) { - g_set_error_literal (error, - NM_SETTING_WIRELESS_SECURITY_ERROR, - NM_SETTING_WIRELESS_SECURITY_ERROR_INVALID_PROPERTY, - _("property is invalid")); - g_prefix_error (error, "%s.%s: ", NM_SETTING_WIRELESS_SECURITY_SETTING_NAME, NM_SETTING_WIRELESS_SECURITY_WEP_KEY3); - return FALSE; - } - if (priv->auth_alg && !_nm_utils_string_in_list (priv->auth_alg, valid_auth_algs)) { g_set_error_literal (error, NM_SETTING_WIRELESS_SECURITY_ERROR, @@ -1017,15 +976,6 @@ verify (NMSetting *setting, GSList *all_settings, GError **error) return FALSE; } - if (priv->psk && !nm_utils_wpa_psk_valid (priv->psk)) { - g_set_error_literal (error, - NM_SETTING_WIRELESS_SECURITY_ERROR, - NM_SETTING_WIRELESS_SECURITY_ERROR_INVALID_PROPERTY, - _("property is invalid")); - g_prefix_error (error, "%s.%s: ", NM_SETTING_WIRELESS_SECURITY_SETTING_NAME, NM_SETTING_WIRELESS_SECURITY_PSK); - return FALSE; - } - if (priv->proto && !_nm_utils_string_slist_validate (priv->proto, valid_protos)) { g_set_error_literal (error, NM_SETTING_WIRELESS_SECURITY_ERROR, diff --git a/libnm-util/nm-utils.c b/libnm-util/nm-utils.c index 203803f2..022fa70f 100644 --- a/libnm-util/nm-utils.c +++ b/libnm-util/nm-utils.c @@ -1756,7 +1756,7 @@ nm_utils_file_is_pkcs12 (const char *filename) * for additional checks. This check is performed after the check for * @file_test_flags. You cannot omit both @file_test_flags and @predicate. * @user_data: (closure): (allow-none): user data for @predicate function. - * @error: on failure, a "not found" error using @error_domain and @error_code + * @error: (allow-none): on failure, set a "not found" error %G_IO_ERROR %G_IO_ERROR_NOT_FOUND. * * Searches for a @progname file in a list of search @paths. * diff --git a/libnm-util/nm-version.h.in b/libnm-util/nm-version.h.in index 0a33ac29..bbbf993a 100644 --- a/libnm-util/nm-version.h.in +++ b/libnm-util/nm-version.h.in @@ -68,7 +68,7 @@ #define NM_VERSION_0_9_10 (NM_ENCODE_VERSION (0, 9, 10)) #define NM_VERSION_1_0 (NM_ENCODE_VERSION (1, 0, 0)) -#define NM_VERSION_CUR_STABLE NM_VERSION_0_9_10 +#define NM_VERSION_CUR_STABLE NM_VERSION_1_0 #define NM_VERSION_NEXT_STABLE NM_VERSION_1_0 #if !defined (NM_VERSION_MIN_REQUIRED) || (NM_VERSION_MIN_REQUIRED == 0) diff --git a/libnm-util/tests/Makefile.am b/libnm-util/tests/Makefile.am index 690bdbf6..16a7f8f3 100644 --- a/libnm-util/tests/Makefile.am +++ b/libnm-util/tests/Makefile.am @@ -10,6 +10,7 @@ AM_CPPFLAGS = \ -DBUILD_DIR=\"$(abs_builddir)\" \ -DTEST_CERT_DIR=\"$(top_srcdir)/libnm-core/tests/certs/\" +@VALGRIND_RULES@ TESTS = \ test-settings-defaults \ test-crypto \ diff --git a/libnm-util/tests/Makefile.in b/libnm-util/tests/Makefile.in index 9ef02e8c..5ef0d87b 100644 --- a/libnm-util/tests/Makefile.in +++ b/libnm-util/tests/Makefile.in @@ -1,7 +1,7 @@ -# Makefile.in generated by automake 1.13.4 from Makefile.am. +# Makefile.in generated by automake 1.15 from Makefile.am. # @configure_input@ -# Copyright (C) 1994-2013 Free Software Foundation, Inc. +# Copyright (C) 1994-2014 Free Software Foundation, Inc. # This Makefile.in is free software; the Free Software Foundation # gives unlimited permission to copy and/or distribute it, @@ -15,7 +15,17 @@ @SET_MAKE@ VPATH = @srcdir@ -am__is_gnu_make = test -n '$(MAKEFILE_LIST)' && test -n '$(MAKELEVEL)' +am__is_gnu_make = { \ + if test -z '$(MAKELEVEL)'; then \ + false; \ + elif test -n '$(MAKE_HOST)'; then \ + true; \ + elif test -n '$(MAKE_VERSION)' && test -n '$(CURDIR)'; then \ + true; \ + else \ + false; \ + fi; \ +} am__make_running_with_option = \ case $${target_option-} in \ ?) ;; \ @@ -86,8 +96,6 @@ host_triplet = @host@ @ENABLE_TESTS_TRUE@noinst_PROGRAMS = $(am__EXEEXT_1) \ @ENABLE_TESTS_TRUE@ test-libnm-linking$(EXEEXT) subdir = libnm-util/tests -DIST_COMMON = $(srcdir)/Makefile.in $(srcdir)/Makefile.am \ - $(top_srcdir)/build-aux/depcomp ACLOCAL_M4 = $(top_srcdir)/aclocal.m4 am__aclocal_m4_deps = $(top_srcdir)/m4/ax_lib_readline.m4 \ $(top_srcdir)/m4/compiler_warnings.m4 \ @@ -104,6 +112,7 @@ am__aclocal_m4_deps = $(top_srcdir)/m4/ax_lib_readline.m4 \ $(top_srcdir)/m4/vapigen.m4 $(top_srcdir)/configure.ac am__configure_deps = $(am__aclocal_m4_deps) $(CONFIGURE_DEPENDENCIES) \ $(ACLOCAL_M4) +DIST_COMMON = $(srcdir)/Makefile.am $(am__DIST_COMMON) mkinstalldirs = $(install_sh) -d CONFIG_HEADER = $(top_builddir)/config.h CONFIG_CLEAN_FILES = @@ -254,6 +263,8 @@ am__tty_colors = { \ std=''; \ fi; \ } +am__DIST_COMMON = $(srcdir)/Makefile.in \ + $(top_srcdir)/build-aux/depcomp DISTFILES = $(DIST_COMMON) $(DIST_SOURCES) $(TEXINFOS) $(EXTRA_DIST) ACLOCAL = @ACLOCAL@ ALL_LINGUAS = @ALL_LINGUAS@ @@ -280,7 +291,6 @@ CXXCPP = @CXXCPP@ CXXDEPMODE = @CXXDEPMODE@ CXXFLAGS = @CXXFLAGS@ CYGPATH_W = @CYGPATH_W@ -DATADIRNAME = @DATADIRNAME@ DBUS_CFLAGS = @DBUS_CFLAGS@ DBUS_GLIB_100_CFLAGS = @DBUS_GLIB_100_CFLAGS@ DBUS_GLIB_100_LIBS = @DBUS_GLIB_100_LIBS@ @@ -315,6 +325,7 @@ GNUTLS_CFLAGS = @GNUTLS_CFLAGS@ GNUTLS_LIBS = @GNUTLS_LIBS@ GREP = @GREP@ GTKDOC_CHECK = @GTKDOC_CHECK@ +GTKDOC_CHECK_PATH = @GTKDOC_CHECK_PATH@ GTKDOC_DEPS_CFLAGS = @GTKDOC_DEPS_CFLAGS@ GTKDOC_DEPS_LIBS = @GTKDOC_DEPS_LIBS@ GTKDOC_MKPDF = @GTKDOC_MKPDF@ @@ -599,7 +610,6 @@ $(srcdir)/Makefile.in: @MAINTAINER_MODE_TRUE@ $(srcdir)/Makefile.am $(am__confi echo ' cd $(top_srcdir) && $(AUTOMAKE) --gnu libnm-util/tests/Makefile'; \ $(am__cd) $(top_srcdir) && \ $(AUTOMAKE) --gnu libnm-util/tests/Makefile -.PRECIOUS: Makefile Makefile: $(srcdir)/Makefile.in $(top_builddir)/config.status @case '$?' in \ *config.status*) \ @@ -674,14 +684,14 @@ distclean-compile: @am__fastdepCC_TRUE@ $(AM_V_at)$(am__mv) $(DEPDIR)/$*.Tpo $(DEPDIR)/$*.Po @AMDEP_TRUE@@am__fastdepCC_FALSE@ $(AM_V_CC)source='$<' object='$@' libtool=no @AMDEPBACKSLASH@ @AMDEP_TRUE@@am__fastdepCC_FALSE@ DEPDIR=$(DEPDIR) $(CCDEPMODE) $(depcomp) @AMDEPBACKSLASH@ -@am__fastdepCC_FALSE@ $(AM_V_CC@am__nodep@)$(COMPILE) -c $< +@am__fastdepCC_FALSE@ $(AM_V_CC@am__nodep@)$(COMPILE) -c -o $@ $< .c.obj: @am__fastdepCC_TRUE@ $(AM_V_CC)$(COMPILE) -MT $@ -MD -MP -MF $(DEPDIR)/$*.Tpo -c -o $@ `$(CYGPATH_W) '$<'` @am__fastdepCC_TRUE@ $(AM_V_at)$(am__mv) $(DEPDIR)/$*.Tpo $(DEPDIR)/$*.Po @AMDEP_TRUE@@am__fastdepCC_FALSE@ $(AM_V_CC)source='$<' object='$@' libtool=no @AMDEPBACKSLASH@ @AMDEP_TRUE@@am__fastdepCC_FALSE@ DEPDIR=$(DEPDIR) $(CCDEPMODE) $(depcomp) @AMDEPBACKSLASH@ -@am__fastdepCC_FALSE@ $(AM_V_CC@am__nodep@)$(COMPILE) -c `$(CYGPATH_W) '$<'` +@am__fastdepCC_FALSE@ $(AM_V_CC@am__nodep@)$(COMPILE) -c -o $@ `$(CYGPATH_W) '$<'` .c.lo: @am__fastdepCC_TRUE@ $(AM_V_CC)$(LTCOMPILE) -MT $@ -MD -MP -MF $(DEPDIR)/$*.Tpo -c -o $@ $< @@ -993,6 +1003,10 @@ uninstall-am: mostlyclean-generic mostlyclean-libtool pdf pdf-am ps ps-am \ tags tags-am uninstall uninstall-am +.PRECIOUS: Makefile + + +@ENABLE_TESTS_TRUE@@VALGRIND_RULES@ # Tell versions [3.59,3.63) of GNU make to not export all variables. # Otherwise a system limit (for SysV at least) may be exceeded. diff --git a/libnm-util/tests/test-crypto.c b/libnm-util/tests/test-crypto.c index 4bf2b3be..8055facf 100644 --- a/libnm-util/tests/test-crypto.c +++ b/libnm-util/tests/test-crypto.c @@ -96,7 +96,7 @@ out: static void test_cert (gconstpointer test_data) { - char *path; + gs_free char *path = NULL; GByteArray *array; NMCryptoFileFormat format = NM_CRYPTO_FILE_FORMAT_UNKNOWN; GError *error = NULL; @@ -153,6 +153,7 @@ test_load_private_key (const char *path, "unexpected failure determining private key file '%s' " "type with invalid password (expected %d, got %d)", path, NM_CRYPTO_KEY_TYPE_UNKNOWN, key_type); + g_clear_error (&error); return; } @@ -183,6 +184,7 @@ test_load_private_key (const char *path, g_byte_array_free (decrypted, TRUE); } + g_clear_error (&error); g_byte_array_free (array, TRUE); } @@ -207,6 +209,7 @@ test_load_pkcs12 (const char *path, "%d): %d %s", path, NM_CRYPTO_FILE_FORMAT_PKCS12, format, error->code, error->message); } + g_clear_error (&error); } static void diff --git a/libnm-util/tests/test-general.c b/libnm-util/tests/test-general.c index f748fcf5..d8f9dcc4 100644 --- a/libnm-util/tests/test-general.c +++ b/libnm-util/tests/test-general.c @@ -30,6 +30,7 @@ #include #include +#include "gsystem-local-alloc.h" #include "nm-setting-private.h" #include "nm-setting-connection.h" @@ -310,6 +311,13 @@ test_setting_vpn_modify_during_foreach (void) g_object_unref (s_vpn); } +static void +_g_value_array_free (void *ptr) +{ + if (ptr) + g_value_array_free ((GValueArray *) ptr); +} + #define OLD_DBUS_TYPE_G_IP6_ADDRESS (dbus_g_type_get_struct ("GValueArray", DBUS_TYPE_G_UCHAR_ARRAY, G_TYPE_UINT, G_TYPE_INVALID)) #define OLD_DBUS_TYPE_G_ARRAY_OF_IP6_ADDRESS (dbus_g_type_get_collection ("GPtrArray", OLD_DBUS_TYPE_G_IP6_ADDRESS)) @@ -338,7 +346,7 @@ test_setting_ip6_config_old_address_array (void) g_value_init (&written_value, OLD_DBUS_TYPE_G_ARRAY_OF_IP6_ADDRESS); - addresses = g_ptr_array_new (); + addresses = g_ptr_array_new_full (0, _g_value_array_free); array = g_value_array_new (3); /* IP address */ @@ -398,6 +406,7 @@ test_setting_ip6_config_old_address_array (void) ASSERT (memcmp (ba->data, &gw[0], sizeof (gw)) == 0, "ip6-old-addr", "unexpected failure comparing gateways"); + g_ptr_array_unref (addresses); g_value_unset (&written_value); g_value_unset (&read_value); g_object_unref (s_ip6); @@ -406,7 +415,7 @@ test_setting_ip6_config_old_address_array (void) static void test_setting_gsm_apn_spaces (void) { - NMSettingGsm *s_gsm; + gs_unref_object NMSettingGsm *s_gsm = NULL; const char *tmp; s_gsm = (NMSettingGsm *) nm_setting_gsm_new (); @@ -434,7 +443,7 @@ test_setting_gsm_apn_spaces (void) static void test_setting_gsm_apn_bad_chars (void) { - NMSettingGsm *s_gsm; + gs_unref_object NMSettingGsm *s_gsm = NULL; s_gsm = (NMSettingGsm *) nm_setting_gsm_new (); ASSERT (s_gsm != NULL, @@ -472,7 +481,7 @@ test_setting_gsm_apn_bad_chars (void) static void test_setting_gsm_apn_underscore (void) { - NMSettingGsm *s_gsm; + gs_unref_object NMSettingGsm *s_gsm = NULL; GError *error = NULL; gboolean success; @@ -491,7 +500,7 @@ test_setting_gsm_apn_underscore (void) static void test_setting_gsm_without_number (void) { - NMSettingGsm *s_gsm; + gs_unref_object NMSettingGsm *s_gsm = NULL; GError *error = NULL; gboolean success; @@ -1573,6 +1582,7 @@ test_connection_good_base_types (void) NM_SETTING_GSM_APN, "metered.billing.sucks", NULL); nm_connection_add_setting (connection, setting); + g_clear_object (&connection); /* CDMA connection */ connection = nm_connection_new (); @@ -1671,7 +1681,7 @@ test_connection_bad_base_types (void) static void test_setting_compare_id (void) { - NMSetting *old, *new; + gs_unref_object NMSetting *old = NULL, *new = NULL; gboolean success; old = nm_setting_connection_new (); @@ -1697,7 +1707,7 @@ test_setting_compare_secrets (NMSettingSecretFlags secret_flags, NMSettingCompareFlags comp_flags, gboolean remove_secret) { - NMSetting *old, *new; + gs_unref_object NMSetting *old = NULL, *new = NULL; gboolean success; /* Make sure that a connection with transient/unsaved secrets compares @@ -1729,7 +1739,7 @@ test_setting_compare_vpn_secrets (NMSettingSecretFlags secret_flags, NMSettingCompareFlags comp_flags, gboolean remove_secret) { - NMSetting *old, *new; + gs_unref_object NMSetting *old = NULL, *new = NULL; gboolean success; /* Make sure that a connection with transient/unsaved secrets compares @@ -1908,7 +1918,7 @@ test_setting_connection_changed_signal (void) NMConnection *connection; gboolean changed = FALSE; NMSettingConnection *s_con; - char *uuid; + gs_free char *uuid = NULL; connection = nm_connection_new (); g_signal_connect (connection, @@ -2318,7 +2328,7 @@ static void test_setting_old_uuid (void) { GError *error = NULL; - NMSetting *setting; + gs_unref_object NMSetting *setting = NULL; gboolean success; /* NetworkManager-0.9.4.0 generated 40-character UUIDs with no dashes, diff --git a/libnm-util/tests/test-secrets.c b/libnm-util/tests/test-secrets.c index fb0ad4c7..a22edb0f 100644 --- a/libnm-util/tests/test-secrets.c +++ b/libnm-util/tests/test-secrets.c @@ -176,6 +176,7 @@ test_need_tls_secrets_path (void) "need-tls-secrets-path-key-password", "expected to require private key password, but it wasn't"); + g_ptr_array_free (hints, TRUE); g_object_unref (connection); } @@ -219,6 +220,7 @@ test_need_tls_secrets_blob (void) "need-tls-secrets-blob-key-password", "expected to require private key password, but it wasn't"); + g_ptr_array_free (hints, TRUE); g_object_unref (connection); } @@ -345,6 +347,7 @@ test_need_tls_phase2_secrets_path (void) "need-tls-phase2-secrets-path-key-password", "expected to require private key password, but it wasn't"); + g_ptr_array_free (hints, TRUE); g_object_unref (connection); } @@ -389,6 +392,7 @@ test_need_tls_phase2_secrets_blob (void) "need-tls-phase2-secrets-blob-key-password", "expected to require private key password, but it wasn't"); + g_ptr_array_free (hints, TRUE); g_object_unref (connection); } @@ -507,6 +511,7 @@ test_update_secrets_wifi_single_setting (void) tmp = nm_setting_wireless_security_get_wep_key (s_wsec, 0); g_assert_cmpstr (tmp, ==, wepkey); + g_hash_table_unref (secrets); g_object_unref (connection); } @@ -547,6 +552,7 @@ test_update_secrets_wifi_full_hash (void) tmp = nm_setting_wireless_security_get_wep_key (s_wsec, 0); g_assert_cmpstr (tmp, ==, wepkey); + g_hash_table_unref (all); g_object_unref (connection); } @@ -577,6 +583,8 @@ test_update_secrets_wifi_bad_setting_name (void) g_assert_error (error, NM_CONNECTION_ERROR, NM_CONNECTION_ERROR_SETTING_NOT_FOUND); g_assert (success == FALSE); + g_clear_error (&error); + g_hash_table_unref (secrets); g_object_unref (connection); } @@ -600,7 +608,7 @@ test_update_secrets_whole_connection (void) secrets = nm_connection_to_hash (connection, NM_SETTING_HASH_FLAG_ALL); wsec_hash = g_hash_table_lookup (secrets, NM_SETTING_WIRELESS_SECURITY_SETTING_NAME); g_assert (wsec_hash); - g_hash_table_insert (wsec_hash, NM_SETTING_WIRELESS_SECURITY_WEP_KEY0, string_to_gvalue (wepkey)); + g_hash_table_insert (wsec_hash, g_strdup (NM_SETTING_WIRELESS_SECURITY_WEP_KEY0), string_to_gvalue (wepkey)); success = nm_connection_update_secrets (connection, NULL, secrets, &error); g_assert_no_error (error); @@ -610,6 +618,7 @@ test_update_secrets_whole_connection (void) g_assert (s_wsec); g_assert_cmpstr (nm_setting_wireless_security_get_wep_key (s_wsec, 0), ==, wepkey); + g_hash_table_unref (secrets); g_object_unref (connection); } @@ -629,6 +638,7 @@ test_update_secrets_whole_connection_empty_hash (void) g_assert_no_error (error); g_assert (success == TRUE); g_object_unref (connection); + g_hash_table_unref (secrets); } static void @@ -650,20 +660,23 @@ test_update_secrets_whole_connection_bad_setting (void) secrets = nm_connection_to_hash (connection, NM_SETTING_HASH_FLAG_ALL); wsec_hash = g_hash_table_lookup (secrets, NM_SETTING_WIRELESS_SECURITY_SETTING_NAME); g_assert (wsec_hash); - g_hash_table_insert (wsec_hash, NM_SETTING_WIRELESS_SECURITY_WEP_KEY0, string_to_gvalue (wepkey)); + g_hash_table_insert (wsec_hash, g_strdup (NM_SETTING_WIRELESS_SECURITY_WEP_KEY0), string_to_gvalue (wepkey)); /* Steal the wsec setting hash so it's not deallocated, and stuff it back * in with a different name so we ensure libnm-util is returning the right * error when it finds an entry in the connection hash that doesn't match * any setting in the connection. */ - g_hash_table_steal (secrets, NM_SETTING_WIRELESS_SECURITY_SETTING_NAME); - g_hash_table_insert (secrets, "asdfasdfasdfasdf", wsec_hash); + g_hash_table_ref (wsec_hash); + g_hash_table_remove (secrets, NM_SETTING_WIRELESS_SECURITY_SETTING_NAME); + g_hash_table_insert (secrets, g_strdup ("asdfasdfasdfasdf"), wsec_hash); success = nm_connection_update_secrets (connection, NULL, secrets, &error); g_assert_error (error, NM_CONNECTION_ERROR, NM_CONNECTION_ERROR_SETTING_NOT_FOUND); g_assert (success == FALSE); + g_clear_error (&error); + g_hash_table_destroy (secrets); g_object_unref (connection); } @@ -716,6 +729,7 @@ test_update_secrets_null_setting_name_with_setting_hash (void) g_assert_error (error, NM_CONNECTION_ERROR, NM_CONNECTION_ERROR_SETTING_NOT_FOUND); g_assert (!success); + g_clear_error (&error); g_hash_table_destroy (secrets); g_object_unref (connection); } diff --git a/libnm-util/tests/test-setting-8021x.c b/libnm-util/tests/test-setting-8021x.c index 4b37d92b..dfc07a80 100644 --- a/libnm-util/tests/test-setting-8021x.c +++ b/libnm-util/tests/test-setting-8021x.c @@ -188,6 +188,7 @@ test_phase2_private_key_import (const char *path, g_object_get (s_8021x, NM_SETTING_802_1X_PHASE2_PRIVATE_KEY, &tmp_key, NULL); ASSERT (tmp_key != NULL, "phase2-private-key-import", "missing private key value"); check_scheme_path (tmp_key, path); + g_byte_array_free (tmp_key, TRUE); } else g_assert_not_reached (); @@ -249,6 +250,7 @@ test_wrong_password_keeps_data (const char *path, const char *password) "wrong-password-keeps-data", "unexpected missing error"); ASSERT (format == NM_SETTING_802_1X_CK_FORMAT_UNKNOWN, "wrong-password-keeps-data", "unexpected success reading private key format"); + g_clear_error (&error); /* Make sure the password hasn't changed */ pw = nm_setting_802_1x_get_private_key_password (s_8021x); @@ -346,6 +348,7 @@ test_wrong_phase2_password_keeps_data (const char *path, const char *password) "wrong-phase2-password-keeps-data", "unexpected missing error"); ASSERT (format == NM_SETTING_802_1X_CK_FORMAT_UNKNOWN, "wrong-phase2-password-keeps-data", "unexpected success reading private key format"); + g_clear_error (&error); /* Make sure the password hasn't changed */ pw = nm_setting_802_1x_get_phase2_private_key_password (s_8021x); diff --git a/libnm-util/tests/test-setting-dcb.c b/libnm-util/tests/test-setting-dcb.c index 1c7d78b8..36192cd3 100644 --- a/libnm-util/tests/test-setting-dcb.c +++ b/libnm-util/tests/test-setting-dcb.c @@ -26,6 +26,7 @@ #include #include #include "nm-setting-dcb.h" +#include "gsystem-local-alloc.h" #define DCB_FLAGS_ALL (NM_SETTING_DCB_FLAG_ENABLE | \ NM_SETTING_DCB_FLAG_ADVERTISE | \ @@ -34,7 +35,7 @@ static void test_dcb_flags_valid (void) { - NMSettingDcb *s_dcb; + gs_unref_object NMSettingDcb *s_dcb = NULL; GError *error = NULL; gboolean success; guint i; @@ -87,7 +88,7 @@ test_dcb_flags_valid (void) static void test_dcb_flags_invalid (void) { - NMSettingDcb *s_dcb; + gs_unref_object NMSettingDcb *s_dcb = NULL; GError *error = NULL; gboolean success; @@ -146,7 +147,7 @@ test_dcb_flags_invalid (void) static void test_dcb_app_priorities (void) { - NMSettingDcb *s_dcb; + gs_unref_object NMSettingDcb *s_dcb = NULL; GError *error = NULL; gboolean success; @@ -208,7 +209,7 @@ test_dcb_app_priorities (void) static void test_dcb_priorities_valid (void) { - NMSettingDcb *s_dcb; + gs_unref_object NMSettingDcb *s_dcb = NULL; GError *error = NULL; gboolean success; guint i; @@ -267,7 +268,7 @@ test_dcb_priorities_valid (void) static void test_dcb_bandwidth_sums (void) { - NMSettingDcb *s_dcb; + gs_unref_object NMSettingDcb *s_dcb = NULL; GError *error = NULL; gboolean success; diff --git a/libnm/Makefile.in b/libnm/Makefile.in index 6e1fad47..dd9a5952 100644 --- a/libnm/Makefile.in +++ b/libnm/Makefile.in @@ -1,7 +1,7 @@ -# Makefile.in generated by automake 1.13.4 from Makefile.am. +# Makefile.in generated by automake 1.15 from Makefile.am. # @configure_input@ -# Copyright (C) 1994-2013 Free Software Foundation, Inc. +# Copyright (C) 1994-2014 Free Software Foundation, Inc. # This Makefile.in is free software; the Free Software Foundation # gives unlimited permission to copy and/or distribute it, @@ -21,7 +21,17 @@ VPATH = @srcdir@ -am__is_gnu_make = test -n '$(MAKEFILE_LIST)' && test -n '$(MAKELEVEL)' +am__is_gnu_make = { \ + if test -z '$(MAKELEVEL)'; then \ + false; \ + elif test -n '$(MAKE_HOST)'; then \ + true; \ + elif test -n '$(MAKE_VERSION)' && test -n '$(CURDIR)'; then \ + true; \ + else \ + false; \ + fi; \ +} am__make_running_with_option = \ case $${target_option-} in \ ?) ;; \ @@ -84,10 +94,6 @@ PRE_UNINSTALL = : POST_UNINSTALL = : build_triplet = @build@ host_triplet = @host@ -DIST_COMMON = $(top_srcdir)/libnm-core/Makefile.libnm-core \ - $(srcdir)/Makefile.in $(srcdir)/Makefile.am \ - $(srcdir)/libnm.pc.in $(top_srcdir)/build-aux/depcomp \ - $(libnminclude_HEADERS) @HAVE_INTROSPECTION_TRUE@am__append_1 = NM-1.0.gir @HAVE_INTROSPECTION_TRUE@am__append_2 = $(gir_DATA) $(typelib_DATA) @BUILD_SETTING_DOCS_TRUE@am__append_3 = $(noinst_DATA) @@ -109,6 +115,8 @@ am__aclocal_m4_deps = $(top_srcdir)/m4/ax_lib_readline.m4 \ $(top_srcdir)/m4/vapigen.m4 $(top_srcdir)/configure.ac am__configure_deps = $(am__aclocal_m4_deps) $(CONFIGURE_DEPENDENCIES) \ $(ACLOCAL_M4) +DIST_COMMON = $(srcdir)/Makefile.am $(libnminclude_HEADERS) \ + $(am__DIST_COMMON) mkinstalldirs = $(install_sh) -d CONFIG_HEADER = $(top_builddir)/config.h CONFIG_CLEAN_FILES = libnm.pc @@ -251,6 +259,9 @@ am__define_uniq_tagged_files = \ ETAGS = etags CTAGS = ctags DIST_SUBDIRS = $(SUBDIRS) +am__DIST_COMMON = $(srcdir)/Makefile.in $(srcdir)/libnm.pc.in \ + $(top_srcdir)/build-aux/depcomp \ + $(top_srcdir)/libnm-core/Makefile.libnm-core DISTFILES = $(DIST_COMMON) $(DIST_SOURCES) $(TEXINFOS) $(EXTRA_DIST) am__relativize = \ dir0=`pwd`; \ @@ -302,7 +313,6 @@ CXXCPP = @CXXCPP@ CXXDEPMODE = @CXXDEPMODE@ CXXFLAGS = @CXXFLAGS@ CYGPATH_W = @CYGPATH_W@ -DATADIRNAME = @DATADIRNAME@ DBUS_CFLAGS = @DBUS_CFLAGS@ DBUS_GLIB_100_CFLAGS = @DBUS_GLIB_100_CFLAGS@ DBUS_GLIB_100_LIBS = @DBUS_GLIB_100_LIBS@ @@ -337,6 +347,7 @@ GNUTLS_CFLAGS = @GNUTLS_CFLAGS@ GNUTLS_LIBS = @GNUTLS_LIBS@ GREP = @GREP@ GTKDOC_CHECK = @GTKDOC_CHECK@ +GTKDOC_CHECK_PATH = @GTKDOC_CHECK_PATH@ GTKDOC_DEPS_CFLAGS = @GTKDOC_DEPS_CFLAGS@ GTKDOC_DEPS_LIBS = @GTKDOC_DEPS_LIBS@ GTKDOC_MKPDF = @GTKDOC_MKPDF@ @@ -806,7 +817,6 @@ $(srcdir)/Makefile.in: @MAINTAINER_MODE_TRUE@ $(srcdir)/Makefile.am $(top_srcdir echo ' cd $(top_srcdir) && $(AUTOMAKE) --gnu libnm/Makefile'; \ $(am__cd) $(top_srcdir) && \ $(AUTOMAKE) --gnu libnm/Makefile -.PRECIOUS: Makefile Makefile: $(srcdir)/Makefile.in $(top_builddir)/config.status @case '$?' in \ *config.status*) \ @@ -815,7 +825,7 @@ Makefile: $(srcdir)/Makefile.in $(top_builddir)/config.status echo ' cd $(top_builddir) && $(SHELL) ./config.status $(subdir)/$@ $(am__depfiles_maybe)'; \ cd $(top_builddir) && $(SHELL) ./config.status $(subdir)/$@ $(am__depfiles_maybe);; \ esac; -$(top_srcdir)/libnm-core/Makefile.libnm-core: +$(top_srcdir)/libnm-core/Makefile.libnm-core $(am__empty): $(top_builddir)/config.status: $(top_srcdir)/configure $(CONFIG_STATUS_DEPENDENCIES) cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh @@ -913,14 +923,14 @@ distclean-compile: @am__fastdepCC_TRUE@ $(AM_V_at)$(am__mv) $(DEPDIR)/$*.Tpo $(DEPDIR)/$*.Po @AMDEP_TRUE@@am__fastdepCC_FALSE@ $(AM_V_CC)source='$<' object='$@' libtool=no @AMDEPBACKSLASH@ @AMDEP_TRUE@@am__fastdepCC_FALSE@ DEPDIR=$(DEPDIR) $(CCDEPMODE) $(depcomp) @AMDEPBACKSLASH@ -@am__fastdepCC_FALSE@ $(AM_V_CC@am__nodep@)$(COMPILE) -c $< +@am__fastdepCC_FALSE@ $(AM_V_CC@am__nodep@)$(COMPILE) -c -o $@ $< .c.obj: @am__fastdepCC_TRUE@ $(AM_V_CC)$(COMPILE) -MT $@ -MD -MP -MF $(DEPDIR)/$*.Tpo -c -o $@ `$(CYGPATH_W) '$<'` @am__fastdepCC_TRUE@ $(AM_V_at)$(am__mv) $(DEPDIR)/$*.Tpo $(DEPDIR)/$*.Po @AMDEP_TRUE@@am__fastdepCC_FALSE@ $(AM_V_CC)source='$<' object='$@' libtool=no @AMDEPBACKSLASH@ @AMDEP_TRUE@@am__fastdepCC_FALSE@ DEPDIR=$(DEPDIR) $(CCDEPMODE) $(depcomp) @AMDEPBACKSLASH@ -@am__fastdepCC_FALSE@ $(AM_V_CC@am__nodep@)$(COMPILE) -c `$(CYGPATH_W) '$<'` +@am__fastdepCC_FALSE@ $(AM_V_CC@am__nodep@)$(COMPILE) -c -o $@ `$(CYGPATH_W) '$<'` .c.lo: @am__fastdepCC_TRUE@ $(AM_V_CC)$(LTCOMPILE) -MT $@ -MD -MP -MF $(DEPDIR)/$*.Tpo -c -o $@ $< @@ -1312,6 +1322,8 @@ uninstall-am: uninstall-girDATA uninstall-libLTLIBRARIES \ uninstall-libLTLIBRARIES uninstall-libnmincludeHEADERS \ uninstall-pkgconfigDATA uninstall-typelibDATA +.PRECIOUS: Makefile + include $(GLIB_MAKEFILE) -include $(INTROSPECTION_MAKEFILE) diff --git a/libnm/libnm.pc.in b/libnm/libnm.pc.in index 6392799a..5fe26b6a 100644 --- a/libnm/libnm.pc.in +++ b/libnm/libnm.pc.in @@ -6,7 +6,7 @@ includedir=@includedir@ Name: libnm Description: Convenience library for clients of NetworkManager Version: @VERSION@ -Requires: gio-2.0 dbus-glib-1 +Requires: gio-2.0 Cflags: -I${includedir}/libnm Libs: -L${libdir} -lnm diff --git a/libnm/nm-client.c b/libnm/nm-client.c index ef73e329..e0a2a7b4 100644 --- a/libnm/nm-client.c +++ b/libnm/nm-client.c @@ -471,7 +471,7 @@ nm_client_get_permission_result (NMClient *client, NMClientPermission permission NMConnectivityState nm_client_get_connectivity (NMClient *client) { - g_return_val_if_fail (NM_IS_CLIENT (client), NM_STATE_UNKNOWN); + g_return_val_if_fail (NM_IS_CLIENT (client), NM_CONNECTIVITY_UNKNOWN); return nm_manager_get_connectivity (NM_CLIENT_GET_PRIVATE (client)->manager); } diff --git a/libnm/nm-dbus-helpers.c b/libnm/nm-dbus-helpers.c index 7a99e70d..6bfd4bbd 100644 --- a/libnm/nm-dbus-helpers.c +++ b/libnm/nm-dbus-helpers.c @@ -349,6 +349,7 @@ _nm_dbus_bind_properties (gpointer object, gpointer skeleton) skeleton, properties[i]->name, G_BINDING_BIDIRECTIONAL | G_BINDING_SYNC_CREATE); } + g_free (properties); } static char * diff --git a/libnm/nm-dhcp6-config.c b/libnm/nm-dhcp6-config.c index 0bd924c4..3b2e81f8 100644 --- a/libnm/nm-dhcp6-config.c +++ b/libnm/nm-dhcp6-config.c @@ -23,7 +23,7 @@ #include "nm-dhcp6-config.h" #include "nm-object-private.h" -G_DEFINE_TYPE (NMDhcp6Config, nm_dhcp6_config, NM_TYPE_OBJECT) +G_DEFINE_TYPE (NMDhcp6Config, nm_dhcp6_config, NM_TYPE_DHCP_CONFIG) static void nm_dhcp6_config_init (NMDhcp6Config *config) diff --git a/libnm/nm-ifcfg-rh-docs.xml b/libnm/nm-ifcfg-rh-docs.xml index 96ecfde8..438f4b71 100644 --- a/libnm/nm-ifcfg-rh-docs.xml +++ b/libnm/nm-ifcfg-rh-docs.xml @@ -11,7 +11,7 @@ - + @@ -146,6 +146,8 @@ but in route-* file instead."/> should not be assigned the default route. DEFROUTE has the opposite meaning as 'never-default' property."/> + @@ -166,6 +168,8 @@ but in route6-* file instead in the form of command line for 'ip route add& should not be assigned the default IPv6 route. IPV6_DEFROUTE has the opposite meaning as 'never-default' property."/> + diff --git a/libnm/nm-manager.c b/libnm/nm-manager.c index 1abb5130..003d6b87 100644 --- a/libnm/nm-manager.c +++ b/libnm/nm-manager.c @@ -568,7 +568,7 @@ nm_manager_get_permission_result (NMManager *manager, NMClientPermission permiss NMConnectivityState nm_manager_get_connectivity (NMManager *manager) { - g_return_val_if_fail (NM_IS_MANAGER (manager), NM_STATE_UNKNOWN); + g_return_val_if_fail (NM_IS_MANAGER (manager), NM_CONNECTIVITY_UNKNOWN); return NM_MANAGER_GET_PRIVATE (manager)->connectivity; } diff --git a/libnm/nm-object.c b/libnm/nm-object.c index 391166b2..fbdbc1f6 100644 --- a/libnm/nm-object.c +++ b/libnm/nm-object.c @@ -625,7 +625,7 @@ typedef struct { GObject **objects; int length, remaining; - gboolean array; + GPtrArray *array; const char *property_name; } ObjectCreatedData; @@ -671,7 +671,8 @@ object_property_complete (ObjectCreatedData *odata) gboolean different = TRUE; if (odata->array) { - GPtrArray *old = *((GPtrArray **) pi->field); + GPtrArray *pi_old = *((GPtrArray **) pi->field); + GPtrArray *old = odata->array; GPtrArray *new; int i; @@ -684,16 +685,11 @@ object_property_complete (ObjectCreatedData *odata) GPtrArray *added = g_ptr_array_sized_new (3); GPtrArray *removed = g_ptr_array_sized_new (3); - if (old) { - /* Find objects in 'old' that do not exist in 'new' */ - array_diff (old, new, removed); + /* Find objects in 'old' that do not exist in 'new' */ + array_diff (old, new, removed); - /* Find objects in 'new' that do not exist in old */ - array_diff (new, old, added); - } else { - for (i = 0; i < new->len; i++) - g_ptr_array_add (added, g_ptr_array_index (new, i)); - } + /* Find objects in 'new' that do not exist in old */ + array_diff (new, old, added); *((GPtrArray **) pi->field) = new; @@ -726,8 +722,8 @@ object_property_complete (ObjectCreatedData *odata) /* Free old array last since it will release references, thus freeing * any objects in the 'removed' array. */ - if (old) - g_ptr_array_unref (old); + if (pi_old) + g_ptr_array_unref (pi_old); } else { GObject **obj_p = pi->field; @@ -745,6 +741,8 @@ object_property_complete (ObjectCreatedData *odata) g_object_unref (self); g_free (odata->objects); + if (odata->array) + g_ptr_array_unref (odata->array); g_slice_free (ObjectCreatedData, odata); } @@ -781,7 +779,7 @@ handle_object_property (NMObject *self, const char *property_name, GVariant *val odata->pi = pi; odata->objects = g_new (GObject *, 1); odata->length = odata->remaining = 1; - odata->array = FALSE; + odata->array = NULL; odata->property_name = property_name; priv->reload_remaining++; @@ -820,6 +818,7 @@ handle_object_array_property (NMObject *self, const char *property_name, GVarian GPtrArray **array = pi->field; const char *path; ObjectCreatedData *odata; + guint i, len = *array ? (*array)->len : 0; npaths = g_variant_n_children (value); @@ -828,9 +827,13 @@ handle_object_array_property (NMObject *self, const char *property_name, GVarian odata->pi = pi; odata->objects = g_new0 (GObject *, npaths); odata->length = odata->remaining = npaths; - odata->array = TRUE; odata->property_name = property_name; + /* Objects known at this point. */ + odata->array = g_ptr_array_new_full (len, g_object_unref); + for (i = 0; i < len; i++) + g_ptr_array_add (odata->array, g_object_ref (g_ptr_array_index (*array, i))); + priv->reload_remaining++; if (npaths == 0) { diff --git a/libnm/nm-property-docs.xml b/libnm/nm-property-docs.xml index 1520e0f9..5c84b7db 100644 --- a/libnm/nm-property-docs.xml +++ b/libnm/nm-property-docs.xml @@ -55,7 +55,7 @@ - + @@ -106,14 +106,14 @@ - - + + - + - - - + + + @@ -139,7 +139,7 @@ - + @@ -153,10 +153,10 @@ - + - + @@ -170,7 +170,7 @@ - + @@ -231,10 +231,10 @@ - + - + @@ -253,7 +253,7 @@ - + diff --git a/libnm/nm-secret-agent-old.c b/libnm/nm-secret-agent-old.c index 606c4099..5da8ef65 100644 --- a/libnm/nm-secret-agent-old.c +++ b/libnm/nm-secret-agent-old.c @@ -556,7 +556,7 @@ nm_secret_agent_old_register (NMSecretAgentOld *self, */ if (nmdbus_agent_manager_call_register_sync (priv->manager_proxy, priv->identifier, - cancellable, NULL)) + cancellable, error)) goto success; /* Failure */ diff --git a/libnm/nm-setting-docs.xml b/libnm/nm-setting-docs.xml index 50acecf1..2e9814f8 100644 --- a/libnm/nm-setting-docs.xml +++ b/libnm/nm-setting-docs.xml @@ -56,7 +56,7 @@ - + @@ -108,14 +108,14 @@ - - + + - + - - - + + + @@ -142,7 +142,7 @@ - + @@ -157,11 +157,11 @@ - + - + @@ -176,7 +176,7 @@ - + @@ -239,10 +239,10 @@ - + - + @@ -261,7 +261,7 @@ - + diff --git a/libnm/tests/Makefile.am b/libnm/tests/Makefile.am index 38449fad..56dd17d5 100644 --- a/libnm/tests/Makefile.am +++ b/libnm/tests/Makefile.am @@ -17,6 +17,11 @@ LDADD = \ noinst_PROGRAMS = $(TESTS) +if WITH_VALGRIND +@VALGRIND_RULES@ --launch-dbus +else +TESTS_ENVIRONMENT = $(srcdir)/libnm-test-launch.sh +endif TESTS = test-nm-client test-remote-settings-client test-secret-agent test_nm_client_SOURCES = \ @@ -33,9 +38,6 @@ test_secret_agent_SOURCES = \ common.c \ common.h \ test-secret-agent.c - -TESTS_ENVIRONMENT = $(srcdir)/libnm-test-launch.sh - endif EXTRA_DIST = libnm-test-launch.sh diff --git a/libnm/tests/Makefile.in b/libnm/tests/Makefile.in index ab5f794c..631e3c53 100644 --- a/libnm/tests/Makefile.in +++ b/libnm/tests/Makefile.in @@ -1,7 +1,7 @@ -# Makefile.in generated by automake 1.13.4 from Makefile.am. +# Makefile.in generated by automake 1.15 from Makefile.am. # @configure_input@ -# Copyright (C) 1994-2013 Free Software Foundation, Inc. +# Copyright (C) 1994-2014 Free Software Foundation, Inc. # This Makefile.in is free software; the Free Software Foundation # gives unlimited permission to copy and/or distribute it, @@ -15,7 +15,17 @@ @SET_MAKE@ VPATH = @srcdir@ -am__is_gnu_make = test -n '$(MAKEFILE_LIST)' && test -n '$(MAKELEVEL)' +am__is_gnu_make = { \ + if test -z '$(MAKELEVEL)'; then \ + false; \ + elif test -n '$(MAKE_HOST)'; then \ + true; \ + elif test -n '$(MAKE_VERSION)' && test -n '$(CURDIR)'; then \ + true; \ + else \ + false; \ + fi; \ +} am__make_running_with_option = \ case $${target_option-} in \ ?) ;; \ @@ -83,8 +93,6 @@ host_triplet = @host@ @ENABLE_TESTS_TRUE@ test-remote-settings-client$(EXEEXT) \ @ENABLE_TESTS_TRUE@ test-secret-agent$(EXEEXT) subdir = libnm/tests -DIST_COMMON = $(srcdir)/Makefile.in $(srcdir)/Makefile.am \ - $(top_srcdir)/build-aux/depcomp ACLOCAL_M4 = $(top_srcdir)/aclocal.m4 am__aclocal_m4_deps = $(top_srcdir)/m4/ax_lib_readline.m4 \ $(top_srcdir)/m4/compiler_warnings.m4 \ @@ -101,6 +109,7 @@ am__aclocal_m4_deps = $(top_srcdir)/m4/ax_lib_readline.m4 \ $(top_srcdir)/m4/vapigen.m4 $(top_srcdir)/configure.ac am__configure_deps = $(am__aclocal_m4_deps) $(CONFIGURE_DEPENDENCIES) \ $(ACLOCAL_M4) +DIST_COMMON = $(srcdir)/Makefile.am $(am__DIST_COMMON) mkinstalldirs = $(install_sh) -d CONFIG_HEADER = $(top_builddir)/config.h CONFIG_CLEAN_FILES = @@ -228,6 +237,8 @@ am__tty_colors = { \ std=''; \ fi; \ } +am__DIST_COMMON = $(srcdir)/Makefile.in \ + $(top_srcdir)/build-aux/depcomp DISTFILES = $(DIST_COMMON) $(DIST_SOURCES) $(TEXINFOS) $(EXTRA_DIST) ACLOCAL = @ACLOCAL@ ALL_LINGUAS = @ALL_LINGUAS@ @@ -254,7 +265,6 @@ CXXCPP = @CXXCPP@ CXXDEPMODE = @CXXDEPMODE@ CXXFLAGS = @CXXFLAGS@ CYGPATH_W = @CYGPATH_W@ -DATADIRNAME = @DATADIRNAME@ DBUS_CFLAGS = @DBUS_CFLAGS@ DBUS_GLIB_100_CFLAGS = @DBUS_GLIB_100_CFLAGS@ DBUS_GLIB_100_LIBS = @DBUS_GLIB_100_LIBS@ @@ -289,6 +299,7 @@ GNUTLS_CFLAGS = @GNUTLS_CFLAGS@ GNUTLS_LIBS = @GNUTLS_LIBS@ GREP = @GREP@ GTKDOC_CHECK = @GTKDOC_CHECK@ +GTKDOC_CHECK_PATH = @GTKDOC_CHECK_PATH@ GTKDOC_DEPS_CFLAGS = @GTKDOC_DEPS_CFLAGS@ GTKDOC_DEPS_LIBS = @GTKDOC_DEPS_LIBS@ GTKDOC_MKPDF = @GTKDOC_MKPDF@ @@ -504,6 +515,7 @@ with_valgrind = @with_valgrind@ @ENABLE_TESTS_TRUE@ $(top_builddir)/libnm/libnm.la \ @ENABLE_TESTS_TRUE@ $(GLIB_LIBS) +@ENABLE_TESTS_TRUE@@WITH_VALGRIND_FALSE@TESTS_ENVIRONMENT = $(srcdir)/libnm-test-launch.sh @ENABLE_TESTS_TRUE@test_nm_client_SOURCES = \ @ENABLE_TESTS_TRUE@ common.c \ @ENABLE_TESTS_TRUE@ common.h \ @@ -519,7 +531,6 @@ with_valgrind = @with_valgrind@ @ENABLE_TESTS_TRUE@ common.h \ @ENABLE_TESTS_TRUE@ test-secret-agent.c -@ENABLE_TESTS_TRUE@TESTS_ENVIRONMENT = $(srcdir)/libnm-test-launch.sh EXTRA_DIST = libnm-test-launch.sh all: all-am @@ -537,7 +548,6 @@ $(srcdir)/Makefile.in: @MAINTAINER_MODE_TRUE@ $(srcdir)/Makefile.am $(am__confi echo ' cd $(top_srcdir) && $(AUTOMAKE) --gnu libnm/tests/Makefile'; \ $(am__cd) $(top_srcdir) && \ $(AUTOMAKE) --gnu libnm/tests/Makefile -.PRECIOUS: Makefile Makefile: $(srcdir)/Makefile.in $(top_builddir)/config.status @case '$?' in \ *config.status*) \ @@ -593,14 +603,14 @@ distclean-compile: @am__fastdepCC_TRUE@ $(AM_V_at)$(am__mv) $(DEPDIR)/$*.Tpo $(DEPDIR)/$*.Po @AMDEP_TRUE@@am__fastdepCC_FALSE@ $(AM_V_CC)source='$<' object='$@' libtool=no @AMDEPBACKSLASH@ @AMDEP_TRUE@@am__fastdepCC_FALSE@ DEPDIR=$(DEPDIR) $(CCDEPMODE) $(depcomp) @AMDEPBACKSLASH@ -@am__fastdepCC_FALSE@ $(AM_V_CC@am__nodep@)$(COMPILE) -c $< +@am__fastdepCC_FALSE@ $(AM_V_CC@am__nodep@)$(COMPILE) -c -o $@ $< .c.obj: @am__fastdepCC_TRUE@ $(AM_V_CC)$(COMPILE) -MT $@ -MD -MP -MF $(DEPDIR)/$*.Tpo -c -o $@ `$(CYGPATH_W) '$<'` @am__fastdepCC_TRUE@ $(AM_V_at)$(am__mv) $(DEPDIR)/$*.Tpo $(DEPDIR)/$*.Po @AMDEP_TRUE@@am__fastdepCC_FALSE@ $(AM_V_CC)source='$<' object='$@' libtool=no @AMDEPBACKSLASH@ @AMDEP_TRUE@@am__fastdepCC_FALSE@ DEPDIR=$(DEPDIR) $(CCDEPMODE) $(depcomp) @AMDEPBACKSLASH@ -@am__fastdepCC_FALSE@ $(AM_V_CC@am__nodep@)$(COMPILE) -c `$(CYGPATH_W) '$<'` +@am__fastdepCC_FALSE@ $(AM_V_CC@am__nodep@)$(COMPILE) -c -o $@ `$(CYGPATH_W) '$<'` .c.lo: @am__fastdepCC_TRUE@ $(AM_V_CC)$(LTCOMPILE) -MT $@ -MD -MP -MF $(DEPDIR)/$*.Tpo -c -o $@ $< @@ -912,6 +922,10 @@ uninstall-am: mostlyclean-generic mostlyclean-libtool pdf pdf-am ps ps-am \ tags tags-am uninstall uninstall-am +.PRECIOUS: Makefile + + +@ENABLE_TESTS_TRUE@@WITH_VALGRIND_TRUE@@VALGRIND_RULES@ --launch-dbus # Tell versions [3.59,3.63) of GNU make to not export all variables. # Otherwise a system limit (for SysV at least) may be exceeded. diff --git a/libnm/tests/test-remote-settings-client.c b/libnm/tests/test-remote-settings-client.c index 8f9dc27f..15590fac 100644 --- a/libnm/tests/test-remote-settings-client.c +++ b/libnm/tests/test-remote-settings-client.c @@ -370,7 +370,7 @@ add_remove_cb (GObject *s, { NMRemoteConnection *connection; gboolean *done = user_data; - GError *error = NULL; + gs_free_error GError *error = NULL; connection = nm_client_add_connection_finish (client, result, &error); g_assert_error (error, NM_CLIENT_ERROR, NM_CLIENT_ERROR_OBJECT_CREATION_FAILED); @@ -426,7 +426,7 @@ add_bad_cb (GObject *s, gpointer user_data) { gboolean *done = user_data; - GError *error = NULL; + gs_free_error GError *error = NULL; remote = nm_client_add_connection_finish (client, result, &error); g_assert_error (error, NM_CONNECTION_ERROR, NM_CONNECTION_ERROR_INVALID_PROPERTY); @@ -469,7 +469,7 @@ save_hostname_cb (GObject *s, gpointer user_data) { gboolean *done = user_data; - GError *error = NULL; + gs_free_error GError *error = NULL; nm_client_save_hostname_finish (client, result, &error); g_assert_no_error (error); diff --git a/libnm/tests/test-secret-agent.c b/libnm/tests/test-secret-agent.c index 0424b74e..037b5a81 100644 --- a/libnm/tests/test-secret-agent.c +++ b/libnm/tests/test-secret-agent.c @@ -354,7 +354,7 @@ connection_activated_none_cb (GObject *c, { TestSecretAgentData *sadata = user_data; NMActiveConnection *ac; - GError *error = NULL; + gs_free_error GError *error = NULL; ac = nm_client_activate_connection_finish (sadata->client, result, &error); g_assert_error (error, NM_AGENT_MANAGER_ERROR, NM_AGENT_MANAGER_ERROR_NO_SECRETS); @@ -399,8 +399,8 @@ connection_activated_no_secrets_cb (GObject *c, gpointer user_data) { TestSecretAgentData *sadata = user_data; - NMActiveConnection *ac; - GError *error = NULL; + gs_unref_object NMActiveConnection *ac = NULL; + gs_free_error GError *error = NULL; ac = nm_client_activate_connection_finish (sadata->client, result, &error); g_assert_error (error, NM_AGENT_MANAGER_ERROR, NM_AGENT_MANAGER_ERROR_NO_SECRETS); @@ -434,8 +434,8 @@ connection_activated_cancel_cb (GObject *c, gpointer user_data) { TestSecretAgentData *sadata = user_data; - NMActiveConnection *ac; - GError *error = NULL; + gs_unref_object NMActiveConnection *ac = NULL; + gs_free_error GError *error = NULL; ac = nm_client_activate_connection_finish (sadata->client, result, &error); g_assert_error (error, NM_AGENT_MANAGER_ERROR, NM_AGENT_MANAGER_ERROR_USER_CANCELED); diff --git a/m4/compiler_warnings.m4 b/m4/compiler_warnings.m4 index c05a26d0..5c8d2077 100644 --- a/m4/compiler_warnings.m4 +++ b/m4/compiler_warnings.m4 @@ -1,3 +1,24 @@ +dnl Check whether a particular compiler flag works with code provided, +dnl disable it in CFLAGS if the check fails. +AC_DEFUN([NM_COMPILER_WARNING], [ + CFLAGS_SAVED="$CFLAGS" + CFLAGS="$CFLAGS -Werror -W$1" + AC_MSG_CHECKING(whether -W$1 works) + + AC_COMPILE_IFELSE([AC_LANG_SOURCE([[]])], [ + AC_COMPILE_IFELSE([AC_LANG_SOURCE([[$2]])], [ + AC_MSG_RESULT(yes) + CFLAGS="$CFLAGS_SAVED -W$1" + ],[ + AC_MSG_RESULT(no) + CFLAGS="$CFLAGS_SAVED -Wno-$1" + ]) + ],[ + AC_MSG_RESULT(not supported) + CFLAGS="$CFLAGS_SAVED" + ]) +]) + AC_DEFUN([NM_COMPILER_WARNINGS], [AC_ARG_ENABLE(more-warnings, AS_HELP_STRING([--enable-more-warnings], [Possible values: no/yes/error]), @@ -5,22 +26,26 @@ AC_DEFUN([NM_COMPILER_WARNINGS], AC_MSG_CHECKING(for more warnings) if test "$GCC" = "yes" -a "$set_more_warnings" != "no"; then AC_MSG_RESULT(yes) + + dnl This is enabled in clang by default, makes little sense, + dnl and causes the build to abort with -Werror. CFLAGS_SAVED="$CFLAGS" - CFLAGS_MORE_WARNINGS="-Wall -std=gnu89" + CFLAGS="$CFLAGS -Qunused-arguments" + AC_COMPILE_IFELSE([AC_LANG_SOURCE([])], [], CFLAGS="$CFLAGS_SAVED") + unset CFLAGS_SAVED dnl clang only warns about unknown warnings, unless dnl called with "-Werror=unknown-warning-option" dnl Test if the compiler supports that, and if it does dnl attach it to the CFLAGS. - CFLAGS_EXTRA="-Werror=unknown-warning-option" - CFLAGS="$CFLAGS_MORE_WARNINGS $CFLAGS_EXTRA $CFLAGS_SAVED" - AC_TRY_COMPILE([], [], - has_option=yes, - has_option=no,) - if test $has_option = no; then - CFLAGS_EXTRA= + NM_COMPILER_WARNING([unknown-warning-option], []) + + CFLAGS_SAVED="$CFLAGS" + CFLAGS_MORE_WARNINGS="-Wall -std=gnu89" + + if test "x$set_more_warnings" = xerror; then + CFLAGS_MORE_WARNINGS="$CFLAGS_MORE_WARNINGS -Werror" fi - unset has_option for option in -Wshadow -Wmissing-declarations -Wmissing-prototypes \ -Wdeclaration-after-statement -Wformat-security \ @@ -29,9 +54,10 @@ if test "$GCC" = "yes" -a "$set_more_warnings" != "no"; then -fno-strict-aliasing -Wno-unused-but-set-variable \ -Wundef -Wimplicit-function-declaration \ -Wpointer-arith -Winit-self \ - -Wmissing-include-dirs; do - CFLAGS="$CFLAGS_MORE_WARNINGS $CFLAGS_EXTRA $option $CFLAGS_SAVED" - AC_MSG_CHECKING([whether gcc understands $option]) + -Wmissing-include-dirs -Wno-pragmas; do + dnl GCC 4.4 does not warn when checking for -Wno-* flags (https://gcc.gnu.org/wiki/FAQ#wnowarning) + CFLAGS="$CFLAGS_MORE_WARNINGS $(printf '%s' "$option" | sed 's/^-Wno-/-W/') $CFLAGS_SAVED" + AC_MSG_CHECKING([whether compiler understands $option]) AC_TRY_COMPILE([], [], has_option=yes, has_option=no,) @@ -42,12 +68,38 @@ if test "$GCC" = "yes" -a "$set_more_warnings" != "no"; then unset has_option done unset option - unset CFLAGS_EXTRA - if test "x$set_more_warnings" = xerror; then - CFLAGS_MORE_WARNINGS="$CFLAGS_MORE_WARNINGS -Werror" - fi - CFLAGS="$CFLAGS_MORE_WARNINGS $CFLAGS_SAVED" + + CFLAGS="$CFLAGS_SAVED" unset CFLAGS_SAVED + + dnl Disable warnings triggered by known compiler problems + + dnl https://bugzilla.gnome.org/show_bug.cgi?id=745821 + NM_COMPILER_WARNING([unknown-attributes], [#include ]) + + dnl https://bugzilla.gnome.org/show_bug.cgi?id=744473 + NM_COMPILER_WARNING([typedef-redefinition], [#include ]) + + dnl https://llvm.org/bugs/show_bug.cgi?id=21614 + NM_COMPILER_WARNING([array-bounds], + [#include ] + [void f () { strcmp ("something", "0"); }] + ) + + dnl https://llvm.org/bugs/show_bug.cgi?id=22949 + NM_COMPILER_WARNING([parentheses-equality], + [#include ] + [void f () { if (WIFCONTINUED(0)) return; }] + ) + + dnl systemd-dhcp's log_internal macro and our handle_warn are sometimes + dnl used in void context,u sometimes in int. Makes clang unhappy. + NM_COMPILER_WARNING([unused-value], + [#define yolo ({ (666 + 666); })] + [int f () { int i = yolo; yolo; return i; }] + ) + + CFLAGS="$CFLAGS_MORE_WARNINGS $CFLAGS" else AC_MSG_RESULT(no) fi diff --git a/m4/gtk-doc.m4 b/m4/gtk-doc.m4 index ac2eccb4..36755432 100644 --- a/m4/gtk-doc.m4 +++ b/m4/gtk-doc.m4 @@ -1,6 +1,6 @@ dnl -*- mode: autoconf -*- -# serial 1 +# serial 2 dnl Usage: dnl GTK_DOC_CHECK([minimum-gtk-doc-version]) @@ -10,8 +10,24 @@ AC_DEFUN([GTK_DOC_CHECK], AC_BEFORE([AC_PROG_LIBTOOL],[$0])dnl setup libtool first AC_BEFORE([AM_PROG_LIBTOOL],[$0])dnl setup libtool first + ifelse([$1],[],[gtk_doc_requires="gtk-doc"],[gtk_doc_requires="gtk-doc >= $1"]) + AC_MSG_CHECKING([for gtk-doc]) + PKG_CHECK_EXISTS([$gtk_doc_requires],[have_gtk_doc=yes],[have_gtk_doc=no]) + AC_MSG_RESULT($have_gtk_doc) + + if test "$have_gtk_doc" = "no"; then + AC_MSG_WARN([ + You will not be able to create source packages with 'make dist' + because $gtk_doc_requires is not found.]) + fi + dnl check for tools we added during development - AC_PATH_PROG([GTKDOC_CHECK],[gtkdoc-check]) + dnl Use AC_CHECK_PROG to avoid the check target using an absolute path that + dnl may not be writable by the user. Currently, automake requires that the + dnl test name must end in '.test'. + dnl https://bugzilla.gnome.org/show_bug.cgi?id=701638 + AC_CHECK_PROG([GTKDOC_CHECK],[gtkdoc-check],[gtkdoc-check.test]) + AC_PATH_PROG([GTKDOC_CHECK_PATH],[gtkdoc-check]) AC_PATH_PROGS([GTKDOC_REBASE],[gtkdoc-rebase],[true]) AC_PATH_PROG([GTKDOC_MKPDF],[gtkdoc-mkpdf]) @@ -28,22 +44,22 @@ AC_DEFUN([GTK_DOC_CHECK], [use gtk-doc to build documentation [[default=no]]]),, [enable_gtk_doc=no]) - if test x$enable_gtk_doc = xyes; then - ifelse([$1],[], - [PKG_CHECK_EXISTS([gtk-doc],, - AC_MSG_ERROR([gtk-doc not installed and --enable-gtk-doc requested]))], - [PKG_CHECK_EXISTS([gtk-doc >= $1],, - AC_MSG_ERROR([You need to have gtk-doc >= $1 installed to build $PACKAGE_NAME]))]) - dnl don't check for glib if we build glib - if test "x$PACKAGE_NAME" != "xglib"; then - dnl don't fail if someone does not have glib - PKG_CHECK_MODULES(GTKDOC_DEPS, glib-2.0 >= 2.10.0 gobject-2.0 >= 2.10.0,,[:]) - fi - fi - AC_MSG_CHECKING([whether to build gtk-doc documentation]) AC_MSG_RESULT($enable_gtk_doc) + if test "x$enable_gtk_doc" = "xyes" && test "$have_gtk_doc" = "no"; then + AC_MSG_ERROR([ + You must have $gtk_doc_requires installed to build documentation for + $PACKAGE_NAME. Please install gtk-doc or disable building the + documentation by adding '--disable-gtk-doc' to '[$]0'.]) + fi + + dnl don't check for glib if we build glib + if test "x$PACKAGE_NAME" != "xglib"; then + dnl don't fail if someone does not have glib + PKG_CHECK_MODULES(GTKDOC_DEPS, glib-2.0 >= 2.10.0 gobject-2.0 >= 2.10.0,,[:]) + fi + dnl enable/disable output formats AC_ARG_ENABLE([gtk-doc-html], AS_HELP_STRING([--enable-gtk-doc-html], @@ -63,6 +79,7 @@ AC_DEFUN([GTK_DOC_CHECK], fi AC_SUBST([AM_DEFAULT_VERBOSITY]) + AM_CONDITIONAL([HAVE_GTK_DOC], [test x$have_gtk_doc = xyes]) AM_CONDITIONAL([ENABLE_GTK_DOC], [test x$enable_gtk_doc = xyes]) AM_CONDITIONAL([GTK_DOC_BUILD_HTML], [test x$enable_gtk_doc_html = xyes]) AM_CONDITIONAL([GTK_DOC_BUILD_PDF], [test x$enable_gtk_doc_pdf = xyes]) diff --git a/m4/intltool.m4 b/m4/intltool.m4 index 33353eda..c25b7b1a 100644 --- a/m4/intltool.m4 +++ b/m4/intltool.m4 @@ -155,31 +155,6 @@ fi # Substitute ALL_LINGUAS so we can use it in po/Makefile AC_SUBST(ALL_LINGUAS) -# Set DATADIRNAME correctly if it is not set yet -# (copied from glib-gettext.m4) -if test -z "$DATADIRNAME"; then - AC_LINK_IFELSE( - [AC_LANG_PROGRAM([[]], - [[extern int _nl_msg_cat_cntr; - return _nl_msg_cat_cntr]])], - [DATADIRNAME=share], - [case $host in - *-*-solaris*) - dnl On Solaris, if bind_textdomain_codeset is in libc, - dnl GNU format message catalog is always supported, - dnl since both are added to the libc all together. - dnl Hence, we'd like to go with DATADIRNAME=share - dnl in this case. - AC_CHECK_FUNC(bind_textdomain_codeset, - [DATADIRNAME=share], [DATADIRNAME=lib]) - ;; - *) - [DATADIRNAME=lib] - ;; - esac]) -fi -AC_SUBST(DATADIRNAME) - IT_PO_SUBDIR([po]) ]) diff --git a/man/Makefile.in b/man/Makefile.in index 503b900c..01a94a34 100644 --- a/man/Makefile.in +++ b/man/Makefile.in @@ -1,7 +1,7 @@ -# Makefile.in generated by automake 1.13.4 from Makefile.am. +# Makefile.in generated by automake 1.15 from Makefile.am. # @configure_input@ -# Copyright (C) 1994-2013 Free Software Foundation, Inc. +# Copyright (C) 1994-2014 Free Software Foundation, Inc. # This Makefile.in is free software; the Free Software Foundation # gives unlimited permission to copy and/or distribute it, @@ -14,7 +14,17 @@ @SET_MAKE@ VPATH = @srcdir@ -am__is_gnu_make = test -n '$(MAKEFILE_LIST)' && test -n '$(MAKELEVEL)' +am__is_gnu_make = { \ + if test -z '$(MAKELEVEL)'; then \ + false; \ + elif test -n '$(MAKE_HOST)'; then \ + true; \ + elif test -n '$(MAKE_VERSION)' && test -n '$(CURDIR)'; then \ + true; \ + else \ + false; \ + fi; \ +} am__make_running_with_option = \ case $${target_option-} in \ ?) ;; \ @@ -91,11 +101,6 @@ host_triplet = @host@ @ENABLE_GTK_DOC_FALSE@@INSTALL_PREGEN_MANPAGES_TRUE@ $(docbook_autogenerated_man_pages) subdir = man -DIST_COMMON = $(srcdir)/Makefile.in $(srcdir)/Makefile.am \ - $(srcdir)/NetworkManager.conf.xml.in \ - $(srcdir)/nm-system-settings.conf.5.in \ - $(srcdir)/nm-online.1.in $(srcdir)/nmcli.1.in \ - $(srcdir)/nmtui.1.in ACLOCAL_M4 = $(top_srcdir)/aclocal.m4 am__aclocal_m4_deps = $(top_srcdir)/m4/ax_lib_readline.m4 \ $(top_srcdir)/m4/compiler_warnings.m4 \ @@ -112,6 +117,7 @@ am__aclocal_m4_deps = $(top_srcdir)/m4/ax_lib_readline.m4 \ $(top_srcdir)/m4/vapigen.m4 $(top_srcdir)/configure.ac am__configure_deps = $(am__aclocal_m4_deps) $(CONFIGURE_DEPENDENCIES) \ $(ACLOCAL_M4) +DIST_COMMON = $(srcdir)/Makefile.am $(am__DIST_COMMON) mkinstalldirs = $(install_sh) -d CONFIG_HEADER = $(top_builddir)/config.h CONFIG_CLEAN_FILES = NetworkManager.conf.xml nm-system-settings.conf.5 \ @@ -171,6 +177,10 @@ man8dir = $(mandir)/man8 NROFF = nroff MANS = $(man_MANS) am__tagged_files = $(HEADERS) $(SOURCES) $(TAGS_FILES) $(LISP) +am__DIST_COMMON = $(srcdir)/Makefile.in \ + $(srcdir)/NetworkManager.conf.xml.in $(srcdir)/nm-online.1.in \ + $(srcdir)/nm-system-settings.conf.5.in $(srcdir)/nmcli.1.in \ + $(srcdir)/nmtui.1.in DISTFILES = $(DIST_COMMON) $(DIST_SOURCES) $(TEXINFOS) $(EXTRA_DIST) ACLOCAL = @ACLOCAL@ ALL_LINGUAS = @ALL_LINGUAS@ @@ -197,7 +207,6 @@ CXXCPP = @CXXCPP@ CXXDEPMODE = @CXXDEPMODE@ CXXFLAGS = @CXXFLAGS@ CYGPATH_W = @CYGPATH_W@ -DATADIRNAME = @DATADIRNAME@ DBUS_CFLAGS = @DBUS_CFLAGS@ DBUS_GLIB_100_CFLAGS = @DBUS_GLIB_100_CFLAGS@ DBUS_GLIB_100_LIBS = @DBUS_GLIB_100_LIBS@ @@ -232,6 +241,7 @@ GNUTLS_CFLAGS = @GNUTLS_CFLAGS@ GNUTLS_LIBS = @GNUTLS_LIBS@ GREP = @GREP@ GTKDOC_CHECK = @GTKDOC_CHECK@ +GTKDOC_CHECK_PATH = @GTKDOC_CHECK_PATH@ GTKDOC_DEPS_CFLAGS = @GTKDOC_DEPS_CFLAGS@ GTKDOC_DEPS_LIBS = @GTKDOC_DEPS_LIBS@ GTKDOC_MKPDF = @GTKDOC_MKPDF@ @@ -483,7 +493,6 @@ $(srcdir)/Makefile.in: @MAINTAINER_MODE_TRUE@ $(srcdir)/Makefile.am $(am__confi echo ' cd $(top_srcdir) && $(AUTOMAKE) --gnu man/Makefile'; \ $(am__cd) $(top_srcdir) && \ $(AUTOMAKE) --gnu man/Makefile -.PRECIOUS: Makefile Makefile: $(srcdir)/Makefile.in $(top_builddir)/config.status @case '$?' in \ *config.status*) \ @@ -807,6 +816,8 @@ uninstall-man: uninstall-man1 uninstall-man5 uninstall-man8 ps ps-am tags-am uninstall uninstall-am uninstall-hook \ uninstall-man uninstall-man1 uninstall-man5 uninstall-man8 +.PRECIOUS: Makefile + @ENABLE_GTK_DOC_TRUE@%.8: %.xml @ENABLE_GTK_DOC_TRUE@ $(AM_V_GEN) xsltproc $(XSLTPROC_MAN_FLAGS) $< diff --git a/man/NetworkManager.8 b/man/NetworkManager.8 index 483f61a4..9f8840d0 100644 --- a/man/NetworkManager.8 +++ b/man/NetworkManager.8 @@ -2,7 +2,7 @@ .\" Title: NetworkManager .\" Author: .\" Generator: DocBook XSL Stylesheets v1.78.1 -.\" Date: 12/19/2014 +.\" Date: 05/05/2015 .\" Manual: Network management daemons .\" Source: NetworkManager 1.0 .\" Language: English @@ -110,6 +110,11 @@ The UUID of the connection profile\&. The name (ID) of the connection profile\&. .RE .PP +\fICONNECTION_FILENAME\fR +.RS 4 +The backing file name of the connection profile (if any)\&. +.RE +.PP \fIDEVICE_IFACE\fR .RS 4 The interface name of the device\&. diff --git a/man/NetworkManager.conf.5 b/man/NetworkManager.conf.5 index f34fa63a..9cfcc93f 100644 --- a/man/NetworkManager.conf.5 +++ b/man/NetworkManager.conf.5 @@ -2,7 +2,7 @@ .\" Title: NetworkManager.conf .\" Author: .\" Generator: DocBook XSL Stylesheets v1.78.1 -.\" Date: 12/19/2014 +.\" Date: 05/05/2015 .\" Manual: Configuration .\" Source: NetworkManager 1.0 .\" Language: English @@ -163,10 +163,8 @@ Note that the "carrier" property of NMDevices and device D\-Bus interfaces will .PP \fIconfigure\-and\-quit\fR .RS 4 -When set to -true, NetworkManager quits after performing initial network configuration but spawns small helpers to preserve DHCP leases and IPv6 addresses\&. This is useful in environments where network setup is more or less static or it is desirable to save process time but still handle some dynamic configurations\&. When this option is -true, network configuration for WiFi, WWAN, Bluetooth, ADSL, and PPPoE interfaces cannot be preserved due to their use of external services, and these devices will be deconfigured when NetworkManager quits even though other interface\*(Aqs configuration may be preserved\&. The default value is -false, meaning that NetworkManager will continue running after initial network configuration and continue responding to system and hardware events, D\-Bus requests, and user commands\&. +When set to \*(Aqtrue\*(Aq, NetworkManager quits after performing initial network configuration but spawns small helpers to preserve DHCP leases and IPv6 addresses\&. This is useful in environments where network setup is more or less static or it is desirable to save process time but still handle some dynamic configurations\&. When this option is +true, network configuration for WiFi, WWAN, Bluetooth, ADSL, and PPPoE interfaces cannot be preserved due to their use of external services, and these devices will be deconfigured when NetworkManager quits even though other interface\*(Aqs configuration may be preserved\&. Also, to preserve DHCP addresses the \*(Aqdhcp\*(Aq option must be set to \*(Aqinternal\*(Aq\&. The default value of the \*(Aqconfigure\-and\-quit\*(Aq option is \*(Aqfalse\*(Aq, meaning that NetworkManager will continue running after initial network configuration and continue responding to system and hardware events, D\-Bus requests, and user commands\&. .RE .PP \fIdns\fR @@ -191,7 +189,9 @@ none: NetworkManager will not modify resolv\&.conf\&. Comma separated list of options to aid debugging\&. This value will be combined with the environment variable NM_DEBUG\&. Currently the following values are supported: .sp -RLIMIT_CORE: set ulimit \-c unlimited to write out core dumps\&. +RLIMIT_CORE: set ulimit \-c unlimited to write out core dumps\&. Beware, that a core dump can contain sensitive information such as passwords or configuration settings\&. +.sp +fatal\-warnings: set g_log_set_always_fatal() to core dump on warning messages from glib\&. This is equivalent to the \-\-g\-fatal\-warnings command line option\&. .RE .SH "KEYFILE SECTION" .PP diff --git a/man/NetworkManager.conf.xml.in b/man/NetworkManager.conf.xml.in index d9d51b84..7c6b9551 100644 --- a/man/NetworkManager.conf.xml.in +++ b/man/NetworkManager.conf.xml.in @@ -209,7 +209,7 @@ Copyright 2010 - 2014 Red Hat, Inc. configure-and-quit - When set to true, NetworkManager quits after + When set to 'true', NetworkManager quits after performing initial network configuration but spawns small helpers to preserve DHCP leases and IPv6 addresses. This is useful in environments where network setup is more or less static or it is @@ -219,10 +219,12 @@ Copyright 2010 - 2014 Red Hat, Inc. interfaces cannot be preserved due to their use of external services, and these devices will be deconfigured when NetworkManager quits even though other interface's configuration may be preserved. - The default value is false, meaning that - NetworkManager will continue running after initial network - configuration and continue responding to system and hardware events, - D-Bus requests, and user commands. + Also, to preserve DHCP addresses the 'dhcp' option + must be set to 'internal'. The default value of + the 'configure-and-quit' option is + 'false', meaning that NetworkManager will continue + running after initial network configuration and continue responding + to system and hardware events, D-Bus requests, and user commands. @@ -256,7 +258,13 @@ Copyright 2010 - 2014 Red Hat, Inc. values are supported: RLIMIT_CORE: set ulimit -c unlimited - to write out core dumps. + to write out core dumps. Beware, that a core dump can contain + sensitive information such as passwords or configuration settings. + + + fatal-warnings: set g_log_set_always_fatal() + to core dump on warning messages from glib. This is equivalent + to the --g-fatal-warnings command line option. diff --git a/man/nm-settings-ifcfg-rh.5 b/man/nm-settings-ifcfg-rh.5 index 6dea364c..6d394e91 100644 --- a/man/nm-settings-ifcfg-rh.5 +++ b/man/nm-settings-ifcfg-rh.5 @@ -2,12 +2,12 @@ .\" Title: nm-settings-ifcfg-rh .\" Author: [see the "AUTHOR" section] .\" Generator: DocBook XSL Stylesheets v1.78.1 -.\" Date: 19 December 2014 +.\" Date: 05 May 2015 .\" Manual: Configuration -.\" Source: NetworkManager 1.0.0 +.\" Source: NetworkManager 1.0.2 .\" Language: English .\" -.TH "NM\-SETTINGS\-IFCFG\" "5" "" "NetworkManager 1\&.0\&.0" "Configuration" +.TH "NM\-SETTINGS\-IFCFG\" "5" "" "NetworkManager 1\&.0\&.2" "Configuration" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -287,6 +287,27 @@ PEERDNS ONBOOT \- initscripts use ONBOOT=yes to mark the devices that are to be activated during boot\&. NetworkManager extents this to also mean that this profile can be used for auto\-connecting at any time\&. .RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +BOOTPROTO +\- NetworkManager supports traditional values +\fInone\fR +(static), +\fIdhcp\fR\&. But it also allows additional values to enable new addressing methods\&. They are +\fIautoip\fR +for IPv4 link\-local addressing using Avahi daemon and +\fIshared\fR +for connection sharing\&. When +\fIshared\fR +is used, NetworkManager assigns the interface 10\&.42\&.0\&.1, or it uses the first static address, if configured\&. +.RE .RE .PP See the next section for detailed mapping of NetworkManager properties and @@ -423,9 +444,9 @@ Substring to match subject of server certificate against\&.\fB Example: \fRIEEE_8021X_SUBJECT_MATCH="Red Hat" T} T{ -altubject\-matches +altsubject\-matches T}:T{ -IEEE_8021X_AlTSUBJECT_MATCHES\fI(+)\fR +IEEE_8021X_ALTSUBJECT_MATCHES\fI(+)\fR T}:T{ \ \& T}:T{ @@ -1304,6 +1325,7 @@ l l l l l l l l l l l l l l l l +l l l l l l l l. T{ method @@ -1422,6 +1444,15 @@ T}:T{ IPV4_FAILURE_FATAL has the opposite meaning as \*(Aqmay\-fail\*(Aq property\&. T} T{ +route\-metric +T}:T{ +IPV4_ROUTE_METRIC\fI(+)\fR +T}:T{ +\-1 +T}:T{ +IPV4_ROUTE_METRIC is the default IPv4 metric for routes on this connection\&. If set to \-1, a default metric based on the device type is used\&. +T} +T{ dhcp\-client\-id T}:T{ DHCP_CLIENT_ID\fI(+)\fR @@ -1464,6 +1495,7 @@ l l l l l l l l l l l l l l l l +l l l l l l l l. T{ method @@ -1569,6 +1601,15 @@ T}:T{ IPV6_FAILURE_FATAL has the opposite meaning as \*(Aqmay\-fail\*(Aq property\&. T} T{ +route\-metric +T}:T{ +IPV6_ROUTE_METRIC\fI(+)\fR +T}:T{ +\-1 +T}:T{ +IPV6_ROUTE_METRIC is the default IPv6 metric for routes on this connection\&. If set to \-1, a default metric based on the device type is used\&. +T} +T{ ip6\-privacy T}:T{ IPV6_PRIVACY, IPV6_PRIVACY_PREFER_PUBLIC_IP\fI(+)\fR diff --git a/man/nm-settings-ifcfg-rh.xml b/man/nm-settings-ifcfg-rh.xml index e578442a..362bd68b 100644 --- a/man/nm-settings-ifcfg-rh.xml +++ b/man/nm-settings-ifcfg-rh.xml @@ -1,6 +1,6 @@ -19 December 2014nm-settings-ifcfg-rh5NetworkManagerConfiguration1.0.0nm-settings-ifcfg-rhDescription of ifcfg-rh settings pluginDESCRIPTION +05 May 2015nm-settings-ifcfg-rh5NetworkManagerConfiguration1.0.2nm-settings-ifcfg-rhDescription of ifcfg-rh settings pluginDESCRIPTION NetworkManager is based on the concept of connection profiles that contain network configuration (see nm-settings5 for details). The profiles can be stored in various formats. NetworkManager uses plugins for reading and writing @@ -154,7 +154,14 @@ DEVICETYPE=TeamPort nameservers to resolv.conf".ONBOOT - initscripts use ONBOOT=yes to mark the devices that are to be activated during boot. NetworkManager extents this to also mean that this profile - can be used for auto-connecting at any time. + can be used for auto-connecting at any time.BOOTPROTO - + NetworkManager supports traditional values none (static), + dhcp. But it also allows additional values to + enable new addressing methods. They are autoip for IPv4 + link-local addressing using Avahi daemon and shared for + connection sharing. When shared is used, NetworkManager + assigns the interface 10.42.0.1, or it uses the first static address, + if configured. See the next section for detailed mapping of NetworkManager properties and ifcfg-rh variables. Variable names, format and usage differences in NetworkManager and initscripts are documented in the tables bellow. @@ -172,7 +179,7 @@ Example: IEEE_8021X_PAC_FILE=/home/joe/my-fast.pac Example: IEEE_8021X_CA_CERT=/home/joe/cacert.crtca-path(none)The property is not handled by ifcfg-rh plugin.subject-matchIEEE_8021X_SUBJECT_MATCH(+)Substring to match subject of server certificate against. -Example: IEEE_8021X_SUBJECT_MATCH="Red Hat"altubject-matchesIEEE_8021X_AlTSUBJECT_MATCHES(+)List of strings to be matched against the altSubjectName. +Example: IEEE_8021X_SUBJECT_MATCH="Red Hat"altsubject-matchesIEEE_8021X_ALTSUBJECT_MATCHES(+)List of strings to be matched against the altSubjectName. Example: IEEE_8021X_ALTSUBJECT_MATCHES="s1.domain.cc"client-certIEEE_8021X_CLIENT_CERT(+)Client certificate for EAP. @@ -267,13 +274,13 @@ Example: DNS1=1.2.3.4 DNS2=10.0.0.254 DNS3=8.8.8.8 Example: IPADDR=10.5.5.23 PREFIX=24 IPADDR1=1.1.1.2 PREFIX1=16gatewayGATEWAYGateway IP address. -Example: GATEWAY=10.5.5.1routesADDRESS1, NETMASK1, GATEWAY1, METRIC1, ...List of static routes. They are not stored in ifcfg-* file, but in route-* file instead.ignore-auto-routesPEERROUTES(+)yesPEERROUTES has the opposite meaning as 'ignore-auto-routes' property.ignore-auto-dnsPEERDNSyesPEERDNS has the opposite meaning as 'ignore-auto-dns' property.dhcp-send-hostnameDHCP_SEND_HOSTNAME(+)yesWhether DHCP_HOSTNAME should be sent to the DHCP server.dhcp-hostnameDHCP_HOSTNAMEHostname to send to the DHCP server.never-defaultDEFROUTE (GATEWAYDEV in /etc/sysconfig/network)yesDEFROUTE=no tells NetworkManager that this connection should not be assigned the default route. DEFROUTE has the opposite meaning as 'never-default' property.may-failIPV4_FAILURE_FATAL(+)noIPV4_FAILURE_FATAL has the opposite meaning as 'may-fail' property.dhcp-client-idDHCP_CLIENT_ID(+)A string sent to the DHCP server to identify the local machine. +Example: GATEWAY=10.5.5.1routesADDRESS1, NETMASK1, GATEWAY1, METRIC1, ...List of static routes. They are not stored in ifcfg-* file, but in route-* file instead.ignore-auto-routesPEERROUTES(+)yesPEERROUTES has the opposite meaning as 'ignore-auto-routes' property.ignore-auto-dnsPEERDNSyesPEERDNS has the opposite meaning as 'ignore-auto-dns' property.dhcp-send-hostnameDHCP_SEND_HOSTNAME(+)yesWhether DHCP_HOSTNAME should be sent to the DHCP server.dhcp-hostnameDHCP_HOSTNAMEHostname to send to the DHCP server.never-defaultDEFROUTE (GATEWAYDEV in /etc/sysconfig/network)yesDEFROUTE=no tells NetworkManager that this connection should not be assigned the default route. DEFROUTE has the opposite meaning as 'never-default' property.may-failIPV4_FAILURE_FATAL(+)noIPV4_FAILURE_FATAL has the opposite meaning as 'may-fail' property.route-metricIPV4_ROUTE_METRIC(+)-1IPV4_ROUTE_METRIC is the default IPv4 metric for routes on this connection. If set to -1, a default metric based on the device type is used.dhcp-client-idDHCP_CLIENT_ID(+)A string sent to the DHCP server to identify the local machine. Example: DHCP_CLIENT_ID=ax-srv-1ipv6 settingPropertyIfcfg-rh VariableDefaultDescriptionmethodIPV6INIT, IPV6FORWARDING, IPV6_AUTOCONF, DHCPV6CIPV6INIT=yes; IPV6FORWARDING=no; IPV6_AUTOCONF=!IPV6FORWARDING, DHCPV6=noMethod used for IPv6 protocol configuration. ignore ~ IPV6INIT=no; auto ~ IPV6_AUTOCONF=yes; dhcp ~ IPV6_AUTOCONF=no and DHCPV6C=yesdnsDNS1, DNS2, ...List of DNS servers. NetworkManager uses the variables both for IPv4 and IPv6.dns-searchDOMAINList of DNS search domains.addressesIPV6ADDR, IPV6ADDR_SECONDARIESList of static IP addresses. Example: IPV6ADDR=ab12:9876::1 IPV6ADDR_SECONDARIES="ab12:9876::2 ab12:9876::3"gatewayIPV6_DEFAULTGWGateway IP address. -Example: IPV6_DEFAULTGW=abbe::1routes(none)List of static routes. They are not stored in ifcfg-* file, but in route6-* file instead in the form of command line for 'ip route add'.ignore-auto-routesIPV6_PEERROUTES(+)yesIPV6_PEERROUTES has the opposite meaning as 'ignore-auto-routes' property.ignore-auto-dnsIPV6_PEERDNS(+)yesIPV6_PEERDNS has the opposite meaning as 'ignore-auto-dns' property.dhcp-hostnameDHCP_HOSTNAMEHostname to send the DHCP server.never-defaultIPV6_DEFROUTE(+), (and IPV6_DEFAULTGW, IPV6_DEFAULTDEV in /etc/sysconfig/network)IPV6_DEFROUTE=yes (when no variable specified)IPV6_DEFROUTE=no tells NetworkManager that this connection should not be assigned the default IPv6 route. IPV6_DEFROUTE has the opposite meaning as 'never-default' property.may-failIPV6_FAILURE_FATAL(+)noIPV6_FAILURE_FATAL has the opposite meaning as 'may-fail' property.ip6-privacyIPV6_PRIVACY, IPV6_PRIVACY_PREFER_PUBLIC_IP(+)noConfigure IPv6 Privacy Extensions for SLAAC (RFC4941). +Example: IPV6_DEFAULTGW=abbe::1routes(none)List of static routes. They are not stored in ifcfg-* file, but in route6-* file instead in the form of command line for 'ip route add'.ignore-auto-routesIPV6_PEERROUTES(+)yesIPV6_PEERROUTES has the opposite meaning as 'ignore-auto-routes' property.ignore-auto-dnsIPV6_PEERDNS(+)yesIPV6_PEERDNS has the opposite meaning as 'ignore-auto-dns' property.dhcp-hostnameDHCP_HOSTNAMEHostname to send the DHCP server.never-defaultIPV6_DEFROUTE(+), (and IPV6_DEFAULTGW, IPV6_DEFAULTDEV in /etc/sysconfig/network)IPV6_DEFROUTE=yes (when no variable specified)IPV6_DEFROUTE=no tells NetworkManager that this connection should not be assigned the default IPv6 route. IPV6_DEFROUTE has the opposite meaning as 'never-default' property.may-failIPV6_FAILURE_FATAL(+)noIPV6_FAILURE_FATAL has the opposite meaning as 'may-fail' property.route-metricIPV6_ROUTE_METRIC(+)-1IPV6_ROUTE_METRIC is the default IPv6 metric for routes on this connection. If set to -1, a default metric based on the device type is used.ip6-privacyIPV6_PRIVACY, IPV6_PRIVACY_PREFER_PUBLIC_IP(+)noConfigure IPv6 Privacy Extensions for SLAAC (RFC4941). Example: IPV6_PRIVACY=rfc3041 IPV6_PRIVACY_PREFER_PUBLIC_IP=yes diff --git a/man/nm-settings-ifcfg-rh.xsl b/man/nm-settings-ifcfg-rh.xsl index f76dee75..e0e3eb9a 100644 --- a/man/nm-settings-ifcfg-rh.xsl +++ b/man/nm-settings-ifcfg-rh.xsl @@ -243,11 +243,21 @@ DEVICETYPE=TeamPort nameservers to resolv.conf". - ONBOOT - + ONBOOT - initscripts use ONBOOT=yes to mark the devices that are to be activated during boot. NetworkManager extents this to also mean that this profile can be used for auto-connecting at any time. + + BOOTPROTO - + NetworkManager supports traditional values none (static), + dhcp. But it also allows additional values to + enable new addressing methods. They are autoip for IPv4 + link-local addressing using Avahi daemon and shared for + connection sharing. When shared is used, NetworkManager + assigns the interface 10.42.0.1, or it uses the first static address, + if configured. + diff --git a/man/nm-settings-keyfile.5 b/man/nm-settings-keyfile.5 index 53e9165f..ba6f6311 100644 --- a/man/nm-settings-keyfile.5 +++ b/man/nm-settings-keyfile.5 @@ -2,12 +2,12 @@ .\" Title: nm-settings-keyfile .\" Author: [see the "AUTHOR" section] .\" Generator: DocBook XSL Stylesheets v1.78.1 -.\" Date: 19 December 2014 +.\" Date: 05 May 2015 .\" Manual: Configuration -.\" Source: NetworkManager 1.0.0 +.\" Source: NetworkManager 1.0.2 .\" Language: English .\" -.TH "NM\-SETTINGS\-KEYFIL" "5" "" "NetworkManager 1\&.0\&.0" "Configuration" +.TH "NM\-SETTINGS\-KEYFIL" "5" "" "NetworkManager 1\&.0\&.2" "Configuration" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- diff --git a/man/nm-settings-keyfile.xml b/man/nm-settings-keyfile.xml index 45bc472b..8f49a8fc 100644 --- a/man/nm-settings-keyfile.xml +++ b/man/nm-settings-keyfile.xml @@ -1,6 +1,6 @@ -19 December 2014nm-settings-keyfile5NetworkManagerConfiguration1.0.0nm-settings-keyfileDescription of keyfile settings pluginDESCRIPTION +05 May 2015nm-settings-keyfile5NetworkManagerConfiguration1.0.2nm-settings-keyfileDescription of keyfile settings pluginDESCRIPTION NetworkManager is based on the concept of connection profiles that contain network configuration (see nm-settings5 for details). The profiles can be stored in various formats. NetworkManager uses plugins for reading and writing diff --git a/man/nm-settings.5 b/man/nm-settings.5 index 0a90098a..2e1d1be9 100644 --- a/man/nm-settings.5 +++ b/man/nm-settings.5 @@ -2,12 +2,12 @@ .\" Title: nm-settings .\" Author: [see the "AUTHOR" section] .\" Generator: DocBook XSL Stylesheets v1.78.1 -.\" Date: 19 December 2014 +.\" Date: 05 May 2015 .\" Manual: Configuration -.\" Source: NetworkManager 1.0.0 +.\" Source: NetworkManager 1.0.2 .\" Language: English .\" -.TH "NM\-SETTINGS" "5" "" "NetworkManager 1\&.0\&.0" "Configuration" +.TH "NM\-SETTINGS" "5" "" "NetworkManager 1\&.0\&.2" "Configuration" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -606,7 +606,7 @@ options T}:T{ dict of string to string T}:T{ -\ \& +{\*(Aqmode\*(Aq: \*(Aqbalance\-rr\*(Aq} T}:T{ Dictionary of key/value pairs of bonding options\&. Both keys and values must be strings\&. Option names must contain only alphanumeric characters (ie, [a\-zA\-Z0\-9])\&. T} @@ -1138,7 +1138,7 @@ priority\-bandwidth T}:T{ array of uint32 T}:T{ -\ \& +[0, 0, 0, 0, 0, 0, 0, 0] T}:T{ An array of 8 uint values, where the array index corresponds to the User Priority (0 \- 7) and the value indicates the percentage of bandwidth of the priority\*(Aqs assigned group that the priority may use\&. The sum of all percentages for priorities which belong to the same group must total 100 percent\&. T} @@ -1147,7 +1147,7 @@ priority\-flow\-control T}:T{ array of uint32 T}:T{ -\ \& +[0, 0, 0, 0, 0, 0, 0, 0] T}:T{ An array of 8 boolean values, where the array index corresponds to the User Priority (0 \- 7) and the value indicates whether or not the corresponding priority should transmit priority pause\&. T} @@ -1165,7 +1165,7 @@ priority\-group\-bandwidth T}:T{ array of uint32 T}:T{ -\ \& +[0, 0, 0, 0, 0, 0, 0, 0] T}:T{ An array of 8 uint values, where the array index corresponds to the Priority Group ID (0 \- 7) and the value indicates the percentage of link bandwidth allocated to that group\&. Allowed values are 0 \- 100, and the sum of all values must total 100 percent\&. T} @@ -1183,7 +1183,7 @@ priority\-group\-id T}:T{ array of uint32 T}:T{ -\ \& +[0, 0, 0, 0, 0, 0, 0, 0] T}:T{ An array of 8 uint values, where the array index corresponds to the User Priority (0 \- 7) and the value indicates the Priority Group ID\&. Allowed Priority Group ID values are 0 \- 7 or 15 for the unrestricted group\&. T} @@ -1192,7 +1192,7 @@ priority\-strict\-bandwidth T}:T{ array of uint32 T}:T{ -\ \& +[0, 0, 0, 0, 0, 0, 0, 0] T}:T{ An array of 8 boolean values, where the array index corresponds to the User Priority (0 \- 7) and the value indicates whether or not the priority may use all of the bandwidth allocated to its assigned group\&. T} @@ -1201,7 +1201,7 @@ priority\-traffic\-class T}:T{ array of uint32 T}:T{ -\ \& +[0, 0, 0, 0, 0, 0, 0, 0] T}:T{ An array of 8 uint values, where the array index corresponds to the User Priority (0 \- 7) and the value indicates the traffic class (0 \- 7) to which the priority is mapped\&. T} @@ -1490,7 +1490,7 @@ addresses T}:T{ array of array of uint32 T}:T{ -\ \& +[] T}:T{ Deprecated in favor of the \*(Aqaddress\-data\*(Aq and \*(Aqgateway\*(Aq properties, but this can be used for backward\-compatibility with older daemons\&. Note that if you send this property the daemon will ignore \*(Aqaddress\-data\*(Aq and \*(Aqgateway\*(Aq\&. Array of IPv4 address structures\&. Each IPv4 address structure is composed of 3 32\-bit values; the first being the IPv4 address (network byte order), the second the prefix (1 \- 32), and last the IPv4 gateway (network byte order)\&. The gateway may be left as 0 if no gateway exists for that subnet\&. T} @@ -1625,7 +1625,7 @@ routes T}:T{ array of array of uint32 T}:T{ -\ \& +[] T}:T{ Deprecated in favor of the \*(Aqroute\-data\*(Aq property, but this can be used for backward\-compatibility with older daemons\&. Note that if you send this property the daemon will ignore \*(Aqroute\-data\*(Aq\&. Array of IPv4 route structures\&. Each IPv4 route structure is composed of 4 32\-bit values; the first being the destination IPv4 network or address (network byte order), the second the destination network or address prefix (1 \- 32), the third being the next\-hop (network byte order) if any, and the fourth being the route metric\&. If the metric is 0, NM will choose an appropriate default metric for the device\&. (There is no way to explicitly specify an actual metric of 0 with this property\&.) T} @@ -1681,7 +1681,7 @@ addresses T}:T{ array of legacy IPv6 address struct (a(ayuay)) T}:T{ -\ \& +[] T}:T{ Deprecated in favor of the \*(Aqaddress\-data\*(Aq and \*(Aqgateway\*(Aq properties, but this can be used for backward\-compatibility with older daemons\&. Note that if you send this property the daemon will ignore \*(Aqaddress\-data\*(Aq and \*(Aqgateway\*(Aq\&. Array of IPv6 address structures\&. Each IPv6 address structure is composed of an IPv6 address, a prefix length (1 \- 128), and an IPv6 gateway address\&. The gateway may be zeroed out if no gateway exists for that subnet\&. T} @@ -1816,7 +1816,7 @@ routes T}:T{ array of legacy IPv6 route struct (a(ayuayu)) T}:T{ -\ \& +[] T}:T{ Deprecated in favor of the \*(Aqroute\-data\*(Aq property, but this can be used for backward\-compatibility with older daemons\&. Note that if you send this property the daemon will ignore \*(Aqroute\-data\*(Aq\&. Array of IPv6 route structures\&. Each IPv6 route structure is composed of an IPv6 address, a prefix length (1 \- 128), an IPv6 next hop address (which may be zeroed out if there is no next hop), and a metric\&. If the metric is 0, NM will choose an appropriate default metric for the device\&. T} @@ -2459,7 +2459,7 @@ data T}:T{ dict of string to string T}:T{ -\ \& +{} T}:T{ Dictionary of key/value pairs of VPN plugin specific data\&. Both keys and values must be strings\&. T} @@ -2486,7 +2486,7 @@ secrets T}:T{ dict of string to string T}:T{ -\ \& +{} T}:T{ Dictionary of key/value pairs of VPN plugin specific secrets like passwords or private keys\&. Both keys and values must be strings\&. T} @@ -2678,7 +2678,7 @@ s390\-options T}:T{ dict of string to string T}:T{ -\ \& +{} T}:T{ Dictionary of key/value pairs of s390\-specific device options\&. Both keys and values must be strings\&. Allowed keys include "portno", "layer2", "portname", "protocol", among others\&. Key names must contain only alphanumeric characters (ie, [a\-zA\-Z0\-9])\&. T} diff --git a/man/nm-settings.xml b/man/nm-settings.xml index 7c3dd96a..d70b1771 100644 --- a/man/nm-settings.xml +++ b/man/nm-settings.xml @@ -1,6 +1,6 @@ -19 December 2014nm-settings5NetworkManagerConfiguration1.0.0nm-settingsDescription of settings and properties of NetworkManager connection profilesDESCRIPTION +05 May 2015nm-settings5NetworkManagerConfiguration1.0.2nm-settingsDescription of settings and properties of NetworkManager connection profilesDESCRIPTION NetworkManager is based on a concept of connection profiles, sometimes referred to as connections only. These connection profiles contain a network configuration. When NetworkManager activates a connection profile on a network device the configuration will @@ -86,7 +86,7 @@
bond settingKey NameValue TypeDefault ValueValue Descriptioninterface-namestringDeprecated in favor of connection.interface-name, but can be used for backward-compatibility with older daemons, to set the bond's interface name.namestringbondThe setting's name, which uniquely identifies the setting within the connection. Each setting type has a name unique to that type, for example "ppp" or "wireless" or "wired". - optionsdict of string to stringDictionary of key/value pairs of bonding options. Both keys and values must be strings. Option names must contain only alphanumeric characters (ie, [a-zA-Z0-9]). + optionsdict of string to string{'mode': 'balance-rr'}Dictionary of key/value pairs of bonding options. Both keys and values must be strings. Option names must contain only alphanumeric characters (ie, [a-zA-Z0-9]).
bridge settingKey NameValue TypeDefault ValueValue Descriptionageing-timeuint32300The Ethernet MAC address aging time, in seconds. @@ -138,14 +138,14 @@ app-iscsi-flagsNMSettingDcbFlags (uint32)Specifies the NMSettingDcbFlags for the DCB iSCSI application. Flags may be any combination of NM_SETTING_DCB_FLAG_ENABLE (0x1), NM_SETTING_DCB_FLAG_ADVERTISE (0x2), and NM_SETTING_DCB_FLAG_WILLING (0x4).app-iscsi-priorityint32-1The highest User Priority (0 - 7) which iSCSI frames should use, or -1 for default priority. Only used when the "app-iscsi-flags" property includes the NM_SETTING_DCB_FLAG_ENABLE (0x1) flag.namestringdcbThe setting's name, which uniquely identifies the setting within the connection. Each setting type has a name unique to that type, for example "ppp" or "wireless" or "wired". - priority-bandwidtharray of uint32An array of 8 uint values, where the array index corresponds to the User Priority (0 - 7) and the value indicates the percentage of bandwidth of the priority's assigned group that the priority may use. The sum of all percentages for priorities which belong to the same group must total 100 percent. - priority-flow-controlarray of uint32An array of 8 boolean values, where the array index corresponds to the User Priority (0 - 7) and the value indicates whether or not the corresponding priority should transmit priority pause. + priority-bandwidtharray of uint32[0, 0, 0, 0, 0, 0, 0, 0]An array of 8 uint values, where the array index corresponds to the User Priority (0 - 7) and the value indicates the percentage of bandwidth of the priority's assigned group that the priority may use. The sum of all percentages for priorities which belong to the same group must total 100 percent. + priority-flow-controlarray of uint32[0, 0, 0, 0, 0, 0, 0, 0]An array of 8 boolean values, where the array index corresponds to the User Priority (0 - 7) and the value indicates whether or not the corresponding priority should transmit priority pause.priority-flow-control-flagsNMSettingDcbFlags (uint32)Specifies the NMSettingDcbFlags for DCB Priority Flow Control (PFC). Flags may be any combination of NM_SETTING_DCB_FLAG_ENABLE (0x1), NM_SETTING_DCB_FLAG_ADVERTISE (0x2), and NM_SETTING_DCB_FLAG_WILLING (0x4). - priority-group-bandwidtharray of uint32An array of 8 uint values, where the array index corresponds to the Priority Group ID (0 - 7) and the value indicates the percentage of link bandwidth allocated to that group. Allowed values are 0 - 100, and the sum of all values must total 100 percent. + priority-group-bandwidtharray of uint32[0, 0, 0, 0, 0, 0, 0, 0]An array of 8 uint values, where the array index corresponds to the Priority Group ID (0 - 7) and the value indicates the percentage of link bandwidth allocated to that group. Allowed values are 0 - 100, and the sum of all values must total 100 percent.priority-group-flagsNMSettingDcbFlags (uint32)Specifies the NMSettingDcbFlags for DCB Priority Groups. Flags may be any combination of NM_SETTING_DCB_FLAG_ENABLE (0x1), NM_SETTING_DCB_FLAG_ADVERTISE (0x2), and NM_SETTING_DCB_FLAG_WILLING (0x4). - priority-group-idarray of uint32An array of 8 uint values, where the array index corresponds to the User Priority (0 - 7) and the value indicates the Priority Group ID. Allowed Priority Group ID values are 0 - 7 or 15 for the unrestricted group. - priority-strict-bandwidtharray of uint32An array of 8 boolean values, where the array index corresponds to the User Priority (0 - 7) and the value indicates whether or not the priority may use all of the bandwidth allocated to its assigned group. - priority-traffic-classarray of uint32An array of 8 uint values, where the array index corresponds to the User Priority (0 - 7) and the value indicates the traffic class (0 - 7) to which the priority is mapped. + priority-group-idarray of uint32[0, 0, 0, 0, 0, 0, 0, 0]An array of 8 uint values, where the array index corresponds to the User Priority (0 - 7) and the value indicates the Priority Group ID. Allowed Priority Group ID values are 0 - 7 or 15 for the unrestricted group. + priority-strict-bandwidtharray of uint32[0, 0, 0, 0, 0, 0, 0, 0]An array of 8 boolean values, where the array index corresponds to the User Priority (0 - 7) and the value indicates whether or not the priority may use all of the bandwidth allocated to its assigned group. + priority-traffic-classarray of uint32[0, 0, 0, 0, 0, 0, 0, 0]An array of 8 uint values, where the array index corresponds to the User Priority (0 - 7) and the value indicates the traffic class (0 - 7) to which the priority is mapped.
generic settingKey NameValue TypeDefault ValueValue DescriptionnamestringgenericThe setting's name, which uniquely identifies the setting within the connection. Each setting type has a name unique to that type, for example "ppp" or "wireless" or "wired". @@ -172,7 +172,7 @@
ipv4 settingKey NameValue TypeDefault ValueValue Descriptionaddress-dataarray of vardictArray of IPv4 addresses. Each address dictionary contains at least 'address' and 'prefix' entries, containing the IP address as a string, and the prefix length as a uint32. Additional attributes may also exist on some addresses. - addressesarray of array of uint32Deprecated in favor of the 'address-data' and 'gateway' properties, but this can be used for backward-compatibility with older daemons. Note that if you send this property the daemon will ignore 'address-data' and 'gateway'. Array of IPv4 address structures. Each IPv4 address structure is composed of 3 32-bit values; the first being the IPv4 address (network byte order), the second the prefix (1 - 32), and last the IPv4 gateway (network byte order). The gateway may be left as 0 if no gateway exists for that subnet. + addressesarray of array of uint32[]Deprecated in favor of the 'address-data' and 'gateway' properties, but this can be used for backward-compatibility with older daemons. Note that if you send this property the daemon will ignore 'address-data' and 'gateway'. Array of IPv4 address structures. Each IPv4 address structure is composed of 3 32-bit values; the first being the IPv4 address (network byte order), the second the prefix (1 - 32), and last the IPv4 gateway (network byte order). The gateway may be left as 0 if no gateway exists for that subnet.dhcp-client-idstringA string sent to the DHCP server to identify the local machine which the DHCP server may use to customize the DHCP lease and options.dhcp-hostnamestringIf the "dhcp-send-hostname" property is TRUE, then the specified name will be sent to the DHCP server when acquiring a lease.dhcp-send-hostnamebooleanTRUEIf TRUE, a hostname is sent to the DHCP server when acquiring a lease. Some DHCP servers use this hostname to update DNS databases, essentially providing a static hostname for the computer. If the "dhcp-hostname" property is NULL and this property is TRUE, the current persistent hostname of the computer is sent. @@ -187,11 +187,11 @@ never-defaultbooleanFALSEIf TRUE, this connection will never be the default connection for this IP type, meaning it will never be assigned the default route by NetworkManager.route-dataarray of vardictArray of IPv4 routes. Each route dictionary contains at least 'dest' and 'prefix' entries, containing the destination IP address as a string, and the prefix length as a uint32. Most routes will also have a 'gateway' entry, containing the gateway IP address as a string. If the route has a 'metric' entry (containing a uint32), that will be used as the metric for the route (otherwise NM will pick a default value appropriate to the device). Additional attributes may also exist on some routes.route-metricint64-1The default metric for routes that don't explicitly specify a metric. The default value -1 means that the metric is choosen automatically based on the device type. The metric applies to dynamic routes, manual (static) routes that don't have an explicit metric setting, address prefix routes, and the default route. Note that for IPv6, the kernel accepts zero (0) but coerces it to 1024 (user default). Hence, setting this property to zero effectively mean setting it to 1024. For IPv4, zero is a regular value for the metric. - routesarray of array of uint32Deprecated in favor of the 'route-data' property, but this can be used for backward-compatibility with older daemons. Note that if you send this property the daemon will ignore 'route-data'. Array of IPv4 route structures. Each IPv4 route structure is composed of 4 32-bit values; the first being the destination IPv4 network or address (network byte order), the second the destination network or address prefix (1 - 32), the third being the next-hop (network byte order) if any, and the fourth being the route metric. If the metric is 0, NM will choose an appropriate default metric for the device. (There is no way to explicitly specify an actual metric of 0 with this property.) + routesarray of array of uint32[]Deprecated in favor of the 'route-data' property, but this can be used for backward-compatibility with older daemons. Note that if you send this property the daemon will ignore 'route-data'. Array of IPv4 route structures. Each IPv4 route structure is composed of 4 32-bit values; the first being the destination IPv4 network or address (network byte order), the second the destination network or address prefix (1 - 32), the third being the next-hop (network byte order) if any, and the fourth being the route metric. If the metric is 0, NM will choose an appropriate default metric for the device. (There is no way to explicitly specify an actual metric of 0 with this property.)
ipv6 settingKey NameValue TypeDefault ValueValue Descriptionaddress-dataarray of vardictArray of IPv6 addresses. Each address dictionary contains at least 'address' and 'prefix' entries, containing the IP address as a string, and the prefix length as a uint32. Additional attributes may also exist on some addresses. - addressesarray of legacy IPv6 address struct (a(ayuay))Deprecated in favor of the 'address-data' and 'gateway' properties, but this can be used for backward-compatibility with older daemons. Note that if you send this property the daemon will ignore 'address-data' and 'gateway'. Array of IPv6 address structures. Each IPv6 address structure is composed of an IPv6 address, a prefix length (1 - 128), and an IPv6 gateway address. The gateway may be zeroed out if no gateway exists for that subnet. + addressesarray of legacy IPv6 address struct (a(ayuay))[]Deprecated in favor of the 'address-data' and 'gateway' properties, but this can be used for backward-compatibility with older daemons. Note that if you send this property the daemon will ignore 'address-data' and 'gateway'. Array of IPv6 address structures. Each IPv6 address structure is composed of an IPv6 address, a prefix length (1 - 128), and an IPv6 gateway address. The gateway may be zeroed out if no gateway exists for that subnet.dhcp-hostnamestringIf the "dhcp-send-hostname" property is TRUE, then the specified name will be sent to the DHCP server when acquiring a lease.dhcp-send-hostnamebooleanTRUEIf TRUE, a hostname is sent to the DHCP server when acquiring a lease. Some DHCP servers use this hostname to update DNS databases, essentially providing a static hostname for the computer. If the "dhcp-hostname" property is NULL and this property is TRUE, the current persistent hostname of the computer is sent.dnsarray of byte array[]Array of IP addresses of DNS servers (in network byte order) @@ -206,7 +206,7 @@ never-defaultbooleanFALSEIf TRUE, this connection will never be the default connection for this IP type, meaning it will never be assigned the default route by NetworkManager.route-dataarray of vardictArray of IPv6 routes. Each route dictionary contains at least 'dest' and 'prefix' entries, containing the destination IP address as a string, and the prefix length as a uint32. Most routes will also have a 'next-hop' entry, containing the next hop IP address as a string. If the route has a 'metric' entry (containing a uint32), that will be used as the metric for the route (otherwise NM will pick a default value appropriate to the device). Additional attributes may also exist on some routes.route-metricint64-1The default metric for routes that don't explicitly specify a metric. The default value -1 means that the metric is choosen automatically based on the device type. The metric applies to dynamic routes, manual (static) routes that don't have an explicit metric setting, address prefix routes, and the default route. Note that for IPv6, the kernel accepts zero (0) but coerces it to 1024 (user default). Hence, setting this property to zero effectively mean setting it to 1024. For IPv4, zero is a regular value for the metric. - routesarray of legacy IPv6 route struct (a(ayuayu))Deprecated in favor of the 'route-data' property, but this can be used for backward-compatibility with older daemons. Note that if you send this property the daemon will ignore 'route-data'. Array of IPv6 route structures. Each IPv6 route structure is composed of an IPv6 address, a prefix length (1 - 128), an IPv6 next hop address (which may be zeroed out if there is no next hop), and a metric. If the metric is 0, NM will choose an appropriate default metric for the device. + routesarray of legacy IPv6 route struct (a(ayuayu))[]Deprecated in favor of the 'route-data' property, but this can be used for backward-compatibility with older daemons. Note that if you send this property the daemon will ignore 'route-data'. Array of IPv6 route structures. Each IPv6 route structure is composed of an IPv6 address, a prefix length (1 - 128), an IPv6 next hop address (which may be zeroed out if there is no next hop), and a metric. If the metric is 0, NM will choose an appropriate default metric for the device.
802-11-olpc-mesh settingKey NameValue TypeDefault ValueValue Descriptionchanneluint320Channel on which the mesh network to join is located. @@ -269,10 +269,10 @@ parentstringIf given, specifies the parent interface name or parent connection UUID from which this VLAN interface should be created. If this property is not specified, the connection must contain an "802-3-ethernet" setting with a "mac-address" property.
vpn settingKey NameValue TypeDefault ValueValue Description - datadict of string to stringDictionary of key/value pairs of VPN plugin specific data. Both keys and values must be strings. + datadict of string to string{}Dictionary of key/value pairs of VPN plugin specific data. Both keys and values must be strings.namestringvpnThe setting's name, which uniquely identifies the setting within the connection. Each setting type has a name unique to that type, for example "ppp" or "wireless" or "wired".persistentbooleanFALSEIf the VPN service supports persistence, and this property is TRUE, the VPN will attempt to stay connected across link changes and outages, until explicitly disconnected. - secretsdict of string to stringDictionary of key/value pairs of VPN plugin specific secrets like passwords or private keys. Both keys and values must be strings. + secretsdict of string to string{}Dictionary of key/value pairs of VPN plugin specific secrets like passwords or private keys. Both keys and values must be strings.service-typestringD-Bus service name of the VPN plugin that this setting uses to connect to its network. i.e. org.freedesktop.NetworkManager.vpnc for the vpnc plugin.user-namestringIf the VPN connection requires a user name for authentication, that name should be provided here. If the connection is available to more than one user, and the VPN requires each user to supply a different name, then leave this property empty. If this property is empty, NetworkManager will automatically supply the username of the user which requested the VPN connection.
@@ -291,7 +291,7 @@ namestring802-3-ethernetThe setting's name, which uniquely identifies the setting within the connection. Each setting type has a name unique to that type, for example "ppp" or "wireless" or "wired". portstringSpecific port type to use if multiple the device supports multiple attachment methods. One of "tp" (Twisted Pair), "aui" (Attachment Unit Interface), "bnc" (Thin Ethernet) or "mii" (Media Independent Interface. If the device supports only one port type, this setting is ignored. s390-nettypestrings390 network device type; one of "qeth", "lcs", or "ctc", representing the different types of virtual network devices available on s390 systems. - s390-optionsdict of string to stringDictionary of key/value pairs of s390-specific device options. Both keys and values must be strings. Allowed keys include "portno", "layer2", "portname", "protocol", among others. Key names must contain only alphanumeric characters (ie, [a-zA-Z0-9]). + s390-optionsdict of string to string{}Dictionary of key/value pairs of s390-specific device options. Both keys and values must be strings. Allowed keys include "portno", "layer2", "portname", "protocol", among others. Key names must contain only alphanumeric characters (ie, [a-zA-Z0-9]). s390-subchannelsarray of string[]Identifies specific subchannels that this network device uses for communication with z/VM or s390 host. Like the "mac-address" property for non-z/VM devices, this property can be used to ensure this connection only applies to the network device that uses these subchannels. The list should contain exactly 3 strings, and each string may only be composed of hexadecimal characters and the period (.) character. speeduint320If non-zero, request that the device use only the specified speed. In Mbit/s, ie 100 == 100Mbit/s. diff --git a/man/nmcli.1.in b/man/nmcli.1.in index c9a69cb9..f6df1b0a 100644 --- a/man/nmcli.1.in +++ b/man/nmcli.1.in @@ -136,7 +136,7 @@ if it is required for connecting to a network. .TP .B \-w, \-\-wait This option sets a timeout period for which \fInmcli\fP will wait for \fINetworkManager\fP -to finsh operations. It is especially useful for commands that may take a longer time to +to finish operations. It is especially useful for commands that may take a longer time to complete, e.g. connection activation. Specifying a value of \fB0\fP instructs \fInmcli\fP not to wait but to exit immediately with a status of success. The default value depends on the executed command. diff --git a/po/Makefile.in.in b/po/Makefile.in.in index 06a8cfe9..fcd2c3b7 100644 --- a/po/Makefile.in.in +++ b/po/Makefile.in.in @@ -33,8 +33,7 @@ exec_prefix = @exec_prefix@ datadir = @datadir@ datarootdir = @datarootdir@ libdir = @libdir@ -DATADIRNAME = @DATADIRNAME@ -itlocaledir = $(prefix)/$(DATADIRNAME)/locale +localedir = @localedir@ subdir = po install_sh = @install_sh@ # Automake >= 1.8 provides @mkdir_p@. @@ -80,7 +79,7 @@ INTLTOOL__v_MSGFMT_0 = @echo " MSGFMT" $@; .po.pox: $(MAKE) $(GETTEXT_PACKAGE).pot - $(MSGMERGE) $< $(GETTEXT_PACKAGE).pot -o $*.pox + $(MSGMERGE) $* $(GETTEXT_PACKAGE).pot -o $*.pox .po.mo: $(INTLTOOL_V_MSGFMT)$(MSGFMT) -o $@ $< @@ -108,7 +107,7 @@ install-data-no: all install-data-yes: all linguas="$(USE_LINGUAS)"; \ for lang in $$linguas; do \ - dir=$(DESTDIR)$(itlocaledir)/$$lang/LC_MESSAGES; \ + dir=$(DESTDIR)$(localedir)/$$lang/LC_MESSAGES; \ $(mkdir_p) $$dir; \ if test -r $$lang.gmo; then \ $(INSTALL_DATA) $$lang.gmo $$dir/$(GETTEXT_PACKAGE).mo; \ @@ -142,8 +141,8 @@ install-exec installcheck: uninstall: linguas="$(USE_LINGUAS)"; \ for lang in $$linguas; do \ - rm -f $(DESTDIR)$(itlocaledir)/$$lang/LC_MESSAGES/$(GETTEXT_PACKAGE).mo; \ - rm -f $(DESTDIR)$(itlocaledir)/$$lang/LC_MESSAGES/$(GETTEXT_PACKAGE).mo.m; \ + rm -f $(DESTDIR)$(localedir)/$$lang/LC_MESSAGES/$(GETTEXT_PACKAGE).mo; \ + rm -f $(DESTDIR)$(localedir)/$$lang/LC_MESSAGES/$(GETTEXT_PACKAGE).mo.m; \ done check: all $(GETTEXT_PACKAGE).pot diff --git a/po/POTFILES.skip b/po/POTFILES.skip index f611e4ce..3fc7b521 100644 --- a/po/POTFILES.skip +++ b/po/POTFILES.skip @@ -6,3 +6,5 @@ vpn-daemons/openvpn vpn-daemons/pptp vpn-daemons/vpnc contrib/fedora/rpm/ +# https://bugs.launchpad.net/intltool/+bug/1117944 +sub/policy/org.freedesktop.NetworkManager.policy.in diff --git a/po/de.po b/po/de.po index 06f8a369..eed36080 100644 --- a/po/de.po +++ b/po/de.po @@ -14,22 +14,22 @@ # Wolfgang Stöggl , 2012, 2013. # Christian Kirbach , 2009-2014. # Benjamin Steinwender , 2014. -# Hedda Peters , 2014. +# Hedda Peters , 2014, 2015. msgid "" msgstr "" "Project-Id-Version: NetworkManager HEAD\n" -"Report-Msgid-Bugs-To: http://bugzilla.gnome.org/enter_bug.cgi?" -"product=NetworkManager&keywords=I18N+L10N&component=Translations\n" +"Report-Msgid-Bugs-To: http://bugzilla.gnome.org/enter_bug." +"cgi?product=NetworkManager&keywords=I18N+L10N&component=Translations\n" "POT-Creation-Date: 2014-08-01 22:08+0000\n" -"PO-Revision-Date: 2014-07-27 17:44+0100\n" -"Last-Translator: Benjamin Steinwender \n" -"Language-Team: Deutsch \n" +"PO-Revision-Date: 2015-02-03 16:15+0000\n" +"Last-Translator: \n" +"Language-Team: American English \n" "Language: de\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" "Plural-Forms: nplurals=2; plural=(n != 1);\n" -"X-Generator: Poedit 1.6.7\n" +"X-Generator: Lokalize 1.0\n" #: ../clients/cli/common.c:38 ../clients/cli/common.c:50 #: ../clients/cli/common.c:58 ../clients/cli/common.c:69 @@ -2935,12 +2935,6 @@ msgstr "Datei »%s« konnte nicht geladen werden\n" msgid "Error: '%s' is not valid 'connection' command." msgstr "Fehler: »%s« ist kein aktiver Verbindungsbefehl." -#: ../clients/cli/connections.c:8658 ../clients/cli/network-manager.c:613 -#, fuzzy, c-format -#| msgid "Error: Could not get system settings." -msgid "Error: Could not get system settings: %s." -msgstr "Fehler: Systemeinstellungen konnten nicht ermittelt werden." - #: ../clients/cli/connections.c:8669 #, c-format msgid "Error: Can't obtain connections: settings service is not running." @@ -3021,7 +3015,7 @@ msgstr "IP-IFACE" #. 2 #: ../clients/cli/devices.c:70 ../clients/cli/devices.c:98 msgid "IS-SOFTWARE" -msgstr "" +msgstr "IS-SOFTWARE" #. 14 #: ../clients/cli/devices.c:71 @@ -4446,10 +4440,9 @@ msgid "Failed to create signal handling thread: %d\n" msgstr "Erstellen des Threads für die Signalbehandlung schlug fehl: %d\n" #: ../clients/cli/nmcli.c:399 ../clients/nm-online.c:197 -#, fuzzy, c-format -#| msgid "Error: Could not create NMClient object." +#, c-format msgid "Error: Could not create NMClient object: %s." -msgstr "Fehler: NMClient-Objekt konnte nicht erstellt werden." +msgstr "Fehler: NMClient-Objekt konnte nicht erstellt werden: %s." #: ../clients/cli/nmcli.c:416 msgid "Success" @@ -4735,14 +4728,15 @@ msgid "the property doesn't contain EAP method '%s'" msgstr "Die Eigenschaft enthält nicht die EAP-Methode »%s«" #: ../clients/cli/settings.c:2585 -#, fuzzy, c-format +#, c-format msgid "the property doesn't contain alternative subject match '%s'" -msgstr "die Eigenschaft enthält kein alternative Themen passend zu »%s«" +msgstr "die Eigenschaft enthält keine alternativen Themen passend zu »%s«" #: ../clients/cli/settings.c:2614 -#, fuzzy, c-format +#, c-format msgid "the property doesn't contain \"phase2\" alternative subject match '%s'" -msgstr "die Eigenschaft enthält nicht die Berechtigung »%s«" +msgstr "" +"die Eigenschaft enthält nicht »phase2«, alternative Themen passend zu »%s«" #: ../clients/cli/settings.c:2640 msgid "" @@ -6109,10 +6103,10 @@ msgid "Could not parse arguments" msgstr "Parameter konnten nicht verarbeitet werden" #: ../clients/tui/nmtui.c:248 ../clients/tui/nmtui.c:259 -#, fuzzy, c-format +#, c-format #| msgid "Could not activate connection: %s" msgid "Could not contact NetworkManager: %s.\n" -msgstr "Verbindungen konnte nicht aktiviert werden: %s" +msgstr "NetworkManager konnte nicht erreicht werden: %s.\n" #: ../clients/tui/nmtui.c:253 msgid "NetworkManager is not running." @@ -6717,16 +6711,14 @@ msgstr "Unbekannter Sklaventyp »%s«" #: ../libnm-core/nm-setting-connection.c:869 #: ../libnm-util/nm-setting-connection.c:886 -#, fuzzy #| msgid "Shared connection service failed" msgid "Slave connections need a valid '" -msgstr "Es muss ein gültiger Server-Pfad eingegeben werden" +msgstr "Slave-Verbindungen benötigen eine gültige '" #: ../libnm-core/nm-setting-connection.c:878 #: ../libnm-util/nm-setting-connection.c:895 -#, fuzzy msgid "Cannot set '" -msgstr " ' kann nicht gesetzt werden" +msgstr "' kann nicht gesetzt werden" #: ../libnm-core/nm-setting-dcb.c:544 ../libnm-util/nm-setting-dcb.c:593 msgid "flags invalid" @@ -7012,13 +7004,12 @@ msgstr "Durch D-Bus getrennt" #: ../libnm/nm-object.c:149 msgid "Caller did not specify D-Bus path for object" -msgstr "" +msgstr "Aufrufer gab keinen D-Bus-Pfad für Objekt an" #: ../libnm/nm-vpn-plugin.c:751 -#, fuzzy #| msgid "Error: No interface specified." msgid "No service name specified" -msgstr "Fehler: Es muss eine Schnittstelle angegeben werden." +msgstr "Kein Dienstname angegeben" #: ../policy/org.freedesktop.NetworkManager.policy.in.in.h:1 msgid "Enable or disable system networking" diff --git a/po/gu.po b/po/gu.po index efa234d3..87b0ff26 100644 --- a/po/gu.po +++ b/po/gu.po @@ -5,21 +5,21 @@ # Ankit Patel , 2004. # Sweta Kothari , 2009, 2010, 2012, 2013. # swkothar , 2013. -# Ankit Patel , 2014. +# Ankit Patel , 2014, 2015. msgid "" msgstr "" "Project-Id-Version: \n" -"Report-Msgid-Bugs-To: http://bugzilla.gnome.org/enter_bug.cgi?" -"product=NetworkManager&keywords=I18N+L10N&component=general\n" +"Report-Msgid-Bugs-To: http://bugzilla.gnome.org/enter_bug." +"cgi?product=NetworkManager&keywords=I18N+L10N&component=general\n" "POT-Creation-Date: 2014-02-02 23:50+0000\n" -"PO-Revision-Date: 2014-02-03 17:21+0630\n" -"Last-Translator: Ankit Patel \n" +"PO-Revision-Date: 2015-02-03 11:51+0530\n" +"Last-Translator: \n" "Language-Team: American English \n" "Language: gu\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" -"X-Generator: Lokalize 1.5\n" +"X-Generator: Lokalize 1.0\n" "Plural-Forms: nplurals=2; plural=(n!=1);\n" #: ../cli/src/common.c:34 ../cli/src/common.c:46 ../cli/src/common.c:54 @@ -707,6 +707,27 @@ msgid "" "When --active option is specified, only the active profiles are taken into\n" "account.\n" msgstr "" +"વપરાશ: nmcli connection show { ARGUMENTS | help }\n" +"\n" +"ARGUMENTS := [--active]\n" +"\n" +"મેમરીમાં અથવા ડિસ્ક જોડાણ રૂપરેખા પર, જેમાંથી અમુક સક્રિય હોઇ\n" +"શકે છે જો ઉપકરણ એ તે જોડાણ રૂપરેખાને વાપરી રહ્યુ હોય. પરિમાણ વગર, " +"બધી\n" +"રૂપરેખા યાદી થયેલ છે. જ્યારે --active વિકલ્પ સ્પષ્ટ થયેલ છે, ફક્ત સક્રિય\n" +"રૂપરેખા બતાવેલ છે.\n" +"\n" +"ARGUMENTS := [--active] [id | uuid | path | apath] ...\n" +"\n" +"ખાસ જોડાણો માટે વિગતોને બતાવો. મૂળભૂત રીતે, બંને સ્થિર " +"રૂપરેખાંકન\n" +"અને સક્રિય જોડાણ માહિતીને દર્શાવેલ છે. તે વૈશ્ર્વિક '--fields' વિકલ્પની મદદથી " +"આઉટપુટને ફિલ્ટર " +"કરવાનું\n" +"શક્ય છે. વધારે જાણકારી માટે પુસ્તિકા " +"પાનાંનો સંદર્ભ લો.\n" +"જ્યારે --active વિકલ્પ સ્પષ્ટ થયેલ હોય તો, ફક્ત સક્રિય રૂપરેખા એ ખાતામાં\n" +"લાવેલ છે.\n" #: ../cli/src/connections.c:305 #, c-format @@ -1512,8 +1533,7 @@ msgstr "સેવા [કંઇ નહિ]: " #. Ask for optional 'gsm' or 'cdma' arguments. #: ../cli/src/connections.c:2989 #, c-format -msgid "" -"There are 2 optional arguments for 'mobile broadband' connection type.\n" +msgid "There are 2 optional arguments for 'mobile broadband' connection type.\n" msgstr "ત્યાં 'મોબાઇલ બ્રોડબેન્ડ' જોડાણ પ્રકાર માટે 2 વૈકલ્પિક દલીલો છે.\n" #: ../cli/src/connections.c:2997 ../cli/src/connections.c:3442 @@ -2149,6 +2169,19 @@ msgid "" "connection\n" "profile must be deleted.\n" msgstr "" +"સંગ્રહો [persistent|temporary] :: જોડાણને સંગ્રહો\n" +"\n" +"NetworkManager માં જોડાણ રૂપરેખાને મોકલે છે કે જે ક્યાંતો કાયમ માટે તેને\n" +"સંગ્રહશે, અથવા મેમરીમાં તેને ફક્ત રાખશે. દલીલ વગર 'સંગ્રહ'\n" +"તેનો મતલબ એ છે કે 'કાયમ માટે સંગ્રહો'.\n" +"નોંધો કે એકવાર તમે કાયમ માટે રૂપરેખાને સંગ્રહો પેલા સુયોજનો રિબુટ અથવા " +"પુન:શરૂ કરીને\n" +"સંગ્રહે છે.વારાફરથી ફેરફારો એ પણ કાયમી અથવા\n" +"વારંવાર હોઇ શકે છે, પરંતુ કોઇફણ કામચલાઉ ફેરફારો એ રિબુટ અથવા પુન:શરૂ કરવા તરફ " +"કાયમી હશે\n" +"નહિં. જો તમે કાયમ માટે જોડાણને સંપૂર્ણપણે દૂર કરવા માંગો તો, જોડાણ " +"રૂપરેખા\n" +"ને કાઢી નાંખવી જ જોઇએ.\n" #: ../cli/src/connections.c:6039 #, c-format @@ -5878,8 +5911,7 @@ msgstr "" #: ../src/main.c:412 #, c-format msgid "%s. Please use --help to see a list of valid options.\n" -msgstr "" -"%s. મહેરબાની કરીને યોગ્ય વિકલ્પોની યાદીને જોવા માટે --help ને વાપરો.\n" +msgstr "%s. મહેરબાની કરીને યોગ્ય વિકલ્પોની યાદીને જોવા માટે --help ને વાપરો.\n" #: ../src/main.c:417 #, c-format @@ -6102,8 +6134,7 @@ msgstr "નેટલિંકને સંભાળવાનો શ્રેય #: ../src/nm-netlink-monitor.c:320 ../src/nm-netlink-monitor.c:382 #, c-format msgid "unable to allocate netlink handle for monitoring link status: %s" -msgstr "" -"કડી સ્થિતિને મોનિટર કરવા માટે નેટલિંકને સંભાળવાનું ફાળવવામાં અસમર્થ: %s" +msgstr "કડી સ્થિતિને મોનિટર કરવા માટે નેટલિંકને સંભાળવાનું ફાળવવામાં અસમર્થ: %s" #: ../src/nm-netlink-monitor.c:470 #, c-format @@ -6711,8 +6742,7 @@ msgstr "વાયરલેસ નેટવર્ક માટે સત્તા msgid "" "Passwords or encryption keys are required to access the wireless network " "'%s'." -msgstr "" -"વાયરલેસ નેટવર્ક '%s' વાપરવા માટે પાસવર્ડો અથવા એનક્રિપ્શન કીઓ જરૂરી છે." +msgstr "વાયરલેસ નેટવર્ક '%s' વાપરવા માટે પાસવર્ડો અથવા એનક્રિપ્શન કીઓ જરૂરી છે." #: ../tui/nmt-secret-agent.c:349 msgid "Wired 802.1X authentication" diff --git a/po/it.po b/po/it.po index 00f56fbe..8ab03540 100644 --- a/po/it.po +++ b/po/it.po @@ -1,16 +1,18 @@ # Italian translation for NetworkManager -# Copyright (C) 2004 - 2011, 2012, 2013, 2014 the NetworkManager CopyRight Holder +# Copyright (C) 2004 - 2011, 2012, 2013, 2014, 2015 the NetworkManager CopyRight Holder # This file is distributed under the same license as the NetworkManager package. # Francesco Marletta , 2004, 2005, 2006, 2007, 2008, 2009, 2010. # Vincenzo Reale , 2011. -# Milo Casagrande , 2011, 2012, 2013, 2014. +# Milo Casagrande , 2011, 2012, 2013, 2014, 2015. # +#: ../src/nm-iface-helper.c:307 msgid "" msgstr "" "Project-Id-Version: network-manager\n" -"Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2014-01-10 09:21+0100\n" -"PO-Revision-Date: 2014-03-09 17:07+0100\n" +"Report-Msgid-Bugs-To: http://bugzilla.gnome.org/enter_bug.cgi?" +"product=NetworkManager&keywords=I18N+L10N&component=Translations\n" +"POT-Creation-Date: 2015-02-22 23:29+0000\n" +"PO-Revision-Date: 2015-02-23 09:41+0100\n" "Last-Translator: Milo Casagrande \n" "Language-Team: Italian \n" "Language: it\n" @@ -19,440 +21,571 @@ msgstr "" "Content-Transfer-Encoding: 8bit\n" "Plural-Forms: nplurals=2; plural=(n!=1);\n" "X-Launchpad-Export-Date: 2011-10-23 16:25+0000\n" -"X-Generator: Poedit 1.6.4\n" +"X-Generator: Poedit 1.7.4\n" -#: ../cli/src/common.c:34 ../cli/src/common.c:46 ../cli/src/common.c:54 -#: ../cli/src/common.c:65 ../cli/src/connections.c:174 -#: ../cli/src/connections.c:200 +#: ../clients/cli/agent.c:42 +#, c-format +msgid "" +"Usage: nmcli agent { COMMAND | help }\n" +"\n" +"COMMAND := { secret | polkit | all }\n" +"\n" +msgstr "" +"Uso: nmcli agent { COMANDO | help }\n" +"\n" +"COMANDO := { secret | polkit | all }\n" +"\n" + +#: ../clients/cli/agent.c:50 +#, c-format +msgid "" +"Usage: nmcli agent secret { help }\n" +"\n" +"Runs nmcli as NetworkManager secret agent. When NetworkManager requires\n" +"a password it asks registered agents for it. This command keeps nmcli " +"running\n" +"and if a password is required asks the user for it.\n" +"\n" +msgstr "" +"Uso: nmcli agent secret { help }\n" +"\n" +"Esegue nmcli come gestore di segreti per NetworkManager.\n" +"Quando NetworkManager necessita di una password, inoltra una\n" +"richiesta agli agenti registrati. Questo comando mantiene nmcli\n" +"in esecuzione e quando è necessaria una password, questa viene\n" +"richiesta all'utente.\n" +"\n" + +#: ../clients/cli/agent.c:60 +#, c-format +msgid "" +"Usage: nmcli agent polkit { help }\n" +"\n" +"Registers nmcli as a polkit action for the user session.\n" +"When a polkit daemon requires an authorization, nmcli asks the user and " +"gives\n" +"the response back to polkit.\n" +"\n" +msgstr "" +"Uso: nmcli agent polkit { help }\n" +"\n" +"Registra nmcli come azione polkit per la sessione utente.\n" +"Quando un demone polkit richiede un'autorizzazione, nmcli\n" +"interpella l'utente e riporta la risposta a polkit.\n" +"\n" + +#: ../clients/cli/agent.c:70 +#, c-format +msgid "" +"Usage: nmcli agent all { help }\n" +"\n" +"Runs nmcli as both NetworkManager secret and a polkit agent.\n" +"\n" +msgstr "" +"Uso: nmcli agent all { help }\n" +"\n" +"Esegue nmcli sia come gestore di segreti per NetworkManager sia come agente " +"polkit.\n" +"\n" + +#: ../clients/cli/agent.c:152 +#, c-format +msgid "nmcli successfully registered as a NetworkManager's secret agent.\n" +msgstr "" +"nmcli registrato con successo come gestore di segreti per NetworkManager.\n" + +#: ../clients/cli/agent.c:154 +#, c-format +msgid "Error: secret agent initialization failed" +msgstr "Errore: inizializzazione agente dei segreti non riuscita" + +#: ../clients/cli/agent.c:169 +#, c-format +msgid "Error: polkit agent initialization failed: %s" +msgstr "Errore: inizializzazione agente polkit non riuscita: %s" + +#: ../clients/cli/agent.c:177 +#, c-format +msgid "nmcli successfully registered as a polkit agent.\n" +msgstr "nmcli registrato con successo come agente polkit.\n" + +#: ../clients/cli/agent.c:209 ../clients/cli/connections.c:8779 +#: ../clients/cli/connections.c:8805 ../clients/cli/connections.c:8943 +#: ../clients/cli/devices.c:2832 ../clients/cli/general.c:325 +#: ../clients/cli/general.c:463 +#, c-format +msgid "Error: NetworkManager is not running." +msgstr "Errore: NetworkManager non è in esecuzione." + +#: ../clients/cli/agent.c:245 +#, c-format +msgid "Error: 'agent' command '%s' is not valid." +msgstr "Errore: comando «agent» «%s» non valido." + +#: ../clients/cli/common.c:40 ../clients/cli/common.c:53 +#: ../clients/cli/common.c:61 ../clients/cli/common.c:73 +#: ../clients/cli/connections.c:172 ../clients/cli/connections.c:194 msgid "GROUP" msgstr "GRUPPO" #. 0 -#: ../cli/src/common.c:35 ../cli/src/common.c:55 +#: ../clients/cli/common.c:41 ../clients/cli/common.c:62 msgid "ADDRESS" msgstr "INDIRIZZO" #. 1 -#: ../cli/src/common.c:36 ../cli/src/common.c:56 +#. 2 +#: ../clients/cli/common.c:42 ../clients/cli/common.c:63 +#: ../clients/cli/connections.c:197 +msgid "GATEWAY" +msgstr "GATEWAY" + +#. 2 +#: ../clients/cli/common.c:43 ../clients/cli/common.c:64 msgid "ROUTE" msgstr "INSTRADAMENTO" -#. 2 -#: ../cli/src/common.c:37 ../cli/src/common.c:57 +#. 3 +#: ../clients/cli/common.c:44 ../clients/cli/common.c:65 msgid "DNS" msgstr "DNS" -#. 3 -#: ../cli/src/common.c:38 ../cli/src/common.c:58 +#. 4 +#: ../clients/cli/common.c:45 ../clients/cli/common.c:66 msgid "DOMAIN" msgstr "DOMINIO" -#. 4 -#: ../cli/src/common.c:39 +#. 5 +#: ../clients/cli/common.c:46 msgid "WINS" msgstr "WINS" #. 0 -#: ../cli/src/common.c:47 ../cli/src/common.c:66 +#: ../clients/cli/common.c:54 ../clients/cli/common.c:74 msgid "OPTION" msgstr "OPZIONE" -#: ../cli/src/common.c:404 ../cli/src/settings.c:2808 -#, c-format -msgid "invalid IPv4 address '%s'" -msgstr "indirizzo IPv4 «%s» non valido" - -#: ../cli/src/common.c:412 -#, c-format -msgid "invalid prefix '%s'; <1-32> allowed" -msgstr "prefisso «%s» non valido; consentito <1-32>" - -#: ../cli/src/common.c:419 ../cli/src/common.c:472 +#: ../clients/cli/common.c:378 ../clients/cli/common.c:438 #, c-format -msgid "invalid gateway '%s'" -msgstr "gateway «%s» non valido" +msgid "invalid prefix '%s'; <1-%d> allowed" +msgstr "prefisso «%s» non valido; consentito <1-%d>" -#: ../cli/src/common.c:457 ../cli/src/settings.c:3054 +#: ../clients/cli/common.c:386 #, c-format -msgid "invalid IPv6 address '%s'" -msgstr "indirizzo IPv6 «%s» non valido" - -#: ../cli/src/common.c:465 -#, c-format -msgid "invalid prefix '%s'; <1-128> allowed" -msgstr "prefisso «%s» non valido; consentito <1-128>" - -#: ../cli/src/common.c:512 -#, c-format -msgid "invalid IPv4 route '%s'" -msgstr "instradamento IPv4 «%s» non valido" - -#: ../cli/src/common.c:520 -#, c-format -msgid "invalid prefix '%s'; <0-32> allowed" -msgstr "prefisso «%s» non valido; consentito <0-32>" +msgid "invalid IP address: %s" +msgstr "indirizzo IP non valido: %s" -#: ../cli/src/common.c:527 ../cli/src/common.c:590 +#: ../clients/cli/common.c:450 #, c-format -msgid "invalid next hop address '%s'" -msgstr "indirizzo hop successivo «%s» non valido" +msgid "" +"the second component of route ('%s') is neither a next hop address nor a " +"metric" +msgstr "" +"il secondo componente di route («%s») non è né l'indirizzo di un hop " +"successivo né una metrica" -#: ../cli/src/common.c:534 ../cli/src/common.c:598 +#: ../clients/cli/common.c:459 #, c-format msgid "invalid metric '%s'" msgstr "metrica «%s» non valida" -#: ../cli/src/common.c:575 +#: ../clients/cli/common.c:467 #, c-format -msgid "invalid IPv6 route '%s'" -msgstr "instradamento IPv6 «%s» non valido" +msgid "invalid route: %s" +msgstr "instradamento non valido: %s" -#: ../cli/src/common.c:583 -#, c-format -msgid "invalid prefix '%s'; <0-128> allowed" -msgstr "prefisso «%s» non valido; consentito <1-128>" +#: ../clients/cli/common.c:479 +msgid "default route cannot be added (NetworkManager handles it by itself)" +msgstr "" +"impossibile aggiungere instradamento predefinito (NetworkManager lo gestisce " +"automaticamente)" -#: ../cli/src/common.c:619 +#: ../clients/cli/common.c:496 msgid "unmanaged" msgstr "non gestito" -#: ../cli/src/common.c:621 +#: ../clients/cli/common.c:498 msgid "unavailable" msgstr "non disponibile" -#: ../cli/src/common.c:623 ../cli/src/network-manager.c:276 +#: ../clients/cli/common.c:500 ../clients/cli/general.c:260 msgid "disconnected" -msgstr "scollegato" +msgstr "disconnesso" -#: ../cli/src/common.c:625 +#: ../clients/cli/common.c:502 msgid "connecting (prepare)" msgstr "connessione in corso (preparazione)" -#: ../cli/src/common.c:627 +#: ../clients/cli/common.c:504 msgid "connecting (configuring)" msgstr "connessione in corso (configurazione)" -#: ../cli/src/common.c:629 +#: ../clients/cli/common.c:506 msgid "connecting (need authentication)" msgstr "connessione in corso (autenticazione necessaria)" -#: ../cli/src/common.c:631 +#: ../clients/cli/common.c:508 msgid "connecting (getting IP configuration)" msgstr "connessione in corso (acquisizione configurazione IP)" -#: ../cli/src/common.c:633 +#: ../clients/cli/common.c:510 msgid "connecting (checking IP connectivity)" msgstr "connessione in corso (verifica connettività IP)" -#: ../cli/src/common.c:635 +#: ../clients/cli/common.c:512 msgid "connecting (starting secondary connections)" msgstr "connessione in corso (avvio connessioni secondarie)" -#: ../cli/src/common.c:637 ../cli/src/network-manager.c:272 +#: ../clients/cli/common.c:514 ../clients/cli/general.c:256 msgid "connected" msgstr "collegato" -#: ../cli/src/common.c:639 ../cli/src/connections.c:732 +#: ../clients/cli/common.c:516 ../clients/cli/connections.c:538 msgid "deactivating" msgstr "disattivazione" -#: ../cli/src/common.c:641 +#: ../clients/cli/common.c:518 msgid "connection failed" msgstr "connessione non riuscita" -#: ../cli/src/common.c:643 ../cli/src/connections.c:737 -#: ../cli/src/connections.c:760 ../cli/src/connections.c:1462 -#: ../cli/src/devices.c:827 ../cli/src/devices.c:2252 -#: ../cli/src/network-manager.c:279 ../cli/src/network-manager.c:297 -#: ../cli/src/network-manager.c:360 ../cli/src/network-manager.c:363 -#: ../cli/src/network-manager.c:373 ../cli/src/network-manager.c:375 -#: ../cli/src/network-manager.c:432 ../cli/src/network-manager.c:448 -#: ../cli/src/settings.c:732 ../cli/src/settings.c:760 -#: ../cli/src/settings.c:822 ../cli/src/settings.c:1137 -#: ../cli/src/utils.c:1080 ../src/main.c:470 ../src/main.c:498 +#: ../clients/cli/common.c:520 ../clients/cli/connections.c:543 +#: ../clients/cli/connections.c:566 ../clients/cli/connections.c:1705 +#: ../clients/cli/devices.c:878 ../clients/cli/general.c:263 +#: ../clients/cli/general.c:281 ../clients/cli/general.c:411 +#: ../clients/cli/general.c:427 ../clients/cli/settings.c:717 +#: ../clients/cli/settings.c:779 ../clients/cli/settings.c:1072 +#: ../clients/cli/utils.c:1145 ../src/main.c:309 ../src/main.c:337 msgid "unknown" msgstr "sconosciuto" -#: ../cli/src/common.c:652 +#: ../clients/cli/common.c:529 msgid "No reason given" msgstr "Nessun motivo specificato" -#: ../cli/src/common.c:655 ../cli/src/connections.c:2258 +#: ../clients/cli/common.c:532 ../clients/cli/connections.c:2705 #, c-format msgid "Unknown error" msgstr "Errore sconosciuto" -#: ../cli/src/common.c:658 +#: ../clients/cli/common.c:535 msgid "Device is now managed" msgstr "Il dispositivo è ora gestito" -#: ../cli/src/common.c:661 +#: ../clients/cli/common.c:538 msgid "Device is now unmanaged" msgstr "Il dispositivo non è più gestito" -#: ../cli/src/common.c:664 +#: ../clients/cli/common.c:541 msgid "The device could not be readied for configuration" msgstr "Impossibile preparare il dispositivo per la configurazione" -#: ../cli/src/common.c:667 +#: ../clients/cli/common.c:544 msgid "" "IP configuration could not be reserved (no available address, timeout, etc.)" msgstr "" "La configurazione IP non può essere riservata (nessun indirizzo disponibile, " "timeout...)" -#: ../cli/src/common.c:670 +#: ../clients/cli/common.c:547 msgid "The IP configuration is no longer valid" msgstr "La configurazione IP non è più valida" -#: ../cli/src/common.c:673 +#: ../clients/cli/common.c:550 msgid "Secrets were required, but not provided" msgstr "Erano richiesti dei segreti, ma non ne sono stati forniti" -#: ../cli/src/common.c:676 +#: ../clients/cli/common.c:553 msgid "802.1X supplicant disconnected" msgstr "Supplicant 802.1X scollegato" -#: ../cli/src/common.c:679 +#: ../clients/cli/common.c:556 msgid "802.1X supplicant configuration failed" msgstr "Configurazione supplicant 802.1X non riuscita" -#: ../cli/src/common.c:682 +#: ../clients/cli/common.c:559 msgid "802.1X supplicant failed" msgstr "Supplicant 802.1X non riuscito" -#: ../cli/src/common.c:685 +#: ../clients/cli/common.c:562 msgid "802.1X supplicant took too long to authenticate" msgstr "L'autenticazione del supplicant 802.1X ha impiegato troppo tempo" -#: ../cli/src/common.c:688 +#: ../clients/cli/common.c:565 msgid "PPP service failed to start" msgstr "Avvio del servizio PPP non riuscito" -#: ../cli/src/common.c:691 +#: ../clients/cli/common.c:568 msgid "PPP service disconnected" msgstr "Servizio PPP non connesso" -#: ../cli/src/common.c:694 +#: ../clients/cli/common.c:571 msgid "PPP failed" msgstr "Errore PPP" -#: ../cli/src/common.c:697 +#: ../clients/cli/common.c:574 msgid "DHCP client failed to start" msgstr "Avvio del client DHCP non riuscito" -#: ../cli/src/common.c:700 +#: ../clients/cli/common.c:577 msgid "DHCP client error" msgstr "Errore client DHCP" -#: ../cli/src/common.c:703 +#: ../clients/cli/common.c:580 msgid "DHCP client failed" msgstr "Client DHCP non riuscito" -#: ../cli/src/common.c:706 +#: ../clients/cli/common.c:583 msgid "Shared connection service failed to start" msgstr "Avvio del servizio di connessione condivisa non riuscito" -#: ../cli/src/common.c:709 +#: ../clients/cli/common.c:586 msgid "Shared connection service failed" msgstr "Servizio connessione condivisa non riuscito" -#: ../cli/src/common.c:712 +#: ../clients/cli/common.c:589 msgid "AutoIP service failed to start" msgstr "Avvio del servizio AutoIP non riuscito" -#: ../cli/src/common.c:715 +#: ../clients/cli/common.c:592 msgid "AutoIP service error" msgstr "Errore servizio AutoIP" -#: ../cli/src/common.c:718 +#: ../clients/cli/common.c:595 msgid "AutoIP service failed" msgstr "Servizio AutoIP non riuscito" -#: ../cli/src/common.c:721 +#: ../clients/cli/common.c:598 msgid "The line is busy" msgstr "La linea è occupata" -#: ../cli/src/common.c:724 +#: ../clients/cli/common.c:601 msgid "No dial tone" msgstr "Nessun segnale di chiamata" -#: ../cli/src/common.c:727 +#: ../clients/cli/common.c:604 msgid "No carrier could be established" msgstr "Impossibile stabilire alcuna portante" -#: ../cli/src/common.c:730 +#: ../clients/cli/common.c:607 msgid "The dialing request timed out" msgstr "La richiesta di selezione è scaduta" -#: ../cli/src/common.c:733 +#: ../clients/cli/common.c:610 msgid "The dialing attempt failed" msgstr "Il tentativo di selezione non è riuscito" -#: ../cli/src/common.c:736 +#: ../clients/cli/common.c:613 msgid "Modem initialization failed" msgstr "Inizializzazione modem non riuscita" -#: ../cli/src/common.c:739 +#: ../clients/cli/common.c:616 msgid "Failed to select the specified APN" msgstr "Selezione dell'APN specificato non riuscita" -#: ../cli/src/common.c:742 +#: ../clients/cli/common.c:619 msgid "Not searching for networks" msgstr "Nessuna ricerca attiva di reti" -#: ../cli/src/common.c:745 +#: ../clients/cli/common.c:622 msgid "Network registration denied" msgstr "Registrazione di rete non consentita" -#: ../cli/src/common.c:748 +#: ../clients/cli/common.c:625 msgid "Network registration timed out" msgstr "Registrazione di rete scaduta" -#: ../cli/src/common.c:751 +#: ../clients/cli/common.c:628 msgid "Failed to register with the requested network" msgstr "Registrazione con la rete richiesta non riuscita" -#: ../cli/src/common.c:754 +#: ../clients/cli/common.c:631 msgid "PIN check failed" msgstr "Verifica PIN non riuscita" -#: ../cli/src/common.c:757 +#: ../clients/cli/common.c:634 msgid "Necessary firmware for the device may be missing" msgstr "" "Il firmware necessario per il dispositivo potrebbe non essere disponibile" -#: ../cli/src/common.c:760 +#: ../clients/cli/common.c:637 msgid "The device was removed" msgstr "Il dispositivo è stato rimosso" -#: ../cli/src/common.c:763 +#: ../clients/cli/common.c:640 msgid "NetworkManager went to sleep" msgstr "NetworkManager è entrato in pausa" -#: ../cli/src/common.c:766 +#: ../clients/cli/common.c:643 msgid "The device's active connection disappeared" msgstr "La connessione attiva del dispositivo è scomparsa" -#: ../cli/src/common.c:769 +#: ../clients/cli/common.c:646 msgid "Device disconnected by user or client" msgstr "Dispositivo scollegato dall'utente o dal client" -#: ../cli/src/common.c:772 +#: ../clients/cli/common.c:649 msgid "Carrier/link changed" msgstr "Modifica di portante/collegamento" -#: ../cli/src/common.c:775 +#: ../clients/cli/common.c:652 msgid "The device's existing connection was assumed" msgstr "Considerata la connessione attiva del dispositivo" -#: ../cli/src/common.c:778 +#: ../clients/cli/common.c:655 msgid "The supplicant is now available" msgstr "Il supplicant è ora disponibile" -#: ../cli/src/common.c:781 +#: ../clients/cli/common.c:658 msgid "The modem could not be found" msgstr "Impossibile trovare il modem" -#: ../cli/src/common.c:784 +#: ../clients/cli/common.c:661 msgid "The Bluetooth connection failed or timed out" msgstr "Il collegamento Bluetooth non è riuscito o è scaduto" -#: ../cli/src/common.c:787 +#: ../clients/cli/common.c:664 msgid "GSM Modem's SIM card not inserted" msgstr "La scheda SIM non è inserita nel modem GSM" -#: ../cli/src/common.c:790 +#: ../clients/cli/common.c:667 msgid "GSM Modem's SIM PIN required" msgstr "Richiesto il PIN della SIM del modem GSM" -#: ../cli/src/common.c:793 +#: ../clients/cli/common.c:670 msgid "GSM Modem's SIM PUK required" msgstr "Richiesto il PUK della SIM del modem GSM" -#: ../cli/src/common.c:796 +#: ../clients/cli/common.c:673 msgid "GSM Modem's SIM wrong" msgstr "SIM del modem GSM errata" -#: ../cli/src/common.c:799 +#: ../clients/cli/common.c:676 msgid "InfiniBand device does not support connected mode" msgstr "Il dispositivo InfiniBand non supporta la modalità collegata" -#: ../cli/src/common.c:802 +#: ../clients/cli/common.c:679 msgid "A dependency of the connection failed" msgstr "Una dipendenza della connessione ha causato un errore" -#: ../cli/src/common.c:805 +#: ../clients/cli/common.c:682 msgid "A problem with the RFC 2684 Ethernet over ADSL bridge" msgstr "Un problema col bridge RFC 2684 Ethernet su ADSL" -#: ../cli/src/common.c:808 +#: ../clients/cli/common.c:685 msgid "ModemManager is unavailable" msgstr "ModemManager non è disponibile" -#: ../cli/src/common.c:811 +#: ../clients/cli/common.c:688 msgid "The Wi-Fi network could not be found" msgstr "Impossibile trovare la rete Wi-Fi" -#: ../cli/src/common.c:814 +#: ../clients/cli/common.c:691 msgid "A secondary connection of the base connection failed" msgstr "" "Si è verificato un errore in una connessione secondaria di quella di base" -#: ../cli/src/common.c:817 +#: ../clients/cli/common.c:694 msgid "DCB or FCoE setup failed" msgstr "Setup di DCB o FCoE non riuscito" -#: ../cli/src/common.c:820 +#: ../clients/cli/common.c:697 msgid "teamd control failed" msgstr "controllo teamd non riuscito" +#: ../clients/cli/common.c:700 +msgid "Modem failed or no longer available" +msgstr "Inizializzazione modem non riuscita o non più disponibile" + +#: ../clients/cli/common.c:703 +msgid "Modem now ready and available" +msgstr "Modem pronto e disponibile" + +#: ../clients/cli/common.c:706 +msgid "SIM PIN was incorrect" +msgstr "PIN della SIM non corretto" + #. TRANSLATORS: Unknown reason for a device state change (NMDeviceStateReason) -#: ../cli/src/common.c:824 ../cli/src/devices.c:634 ../tui/nm-ui-utils.c:359 +#: ../clients/cli/common.c:710 ../clients/cli/devices.c:619 +#: ../libnm-glib/nm-device.c:1813 ../libnm/nm-device.c:1635 msgid "Unknown" msgstr "Sconosciuto" -#: ../cli/src/common.c:866 +#: ../clients/cli/common.c:752 #, c-format msgid "invalid priority map '%s'" msgstr "mappa priorità «%s» non valida" -#: ../cli/src/common.c:873 ../cli/src/common.c:879 +#: ../clients/cli/common.c:759 ../clients/cli/common.c:765 #, c-format msgid "priority '%s' is not valid (<0-%ld>)" msgstr "priorità «%s» non valida (<0-%ld>)" -#: ../cli/src/common.c:935 +#: ../clients/cli/common.c:832 #, c-format msgid "'%s' is not a valid team configuration or file name." msgstr "«%s» non è una configurazione di team o un nome di file valido." +#: ../clients/cli/common.c:933 +#, c-format +msgid "" +"Warning: password for '%s' not given in 'passwd-file' and nmcli cannot ask " +"without '--ask' option.\n" +msgstr "" +"Attenzione: password per «%s» non fornita in «passwd-file» e nmcli non può " +"richiederla senza l'opzione «--ask».\n" + #. define some prompts for connection editor -#: ../cli/src/connections.c:62 +#: ../clients/cli/connections.c:42 msgid "Setting name? " msgstr "Nome impostazione? " -#: ../cli/src/connections.c:63 +#: ../clients/cli/connections.c:43 msgid "Property name? " msgstr "Nome proprietà? " -#: ../cli/src/connections.c:64 +#: ../clients/cli/connections.c:44 msgid "Enter connection type: " msgstr "Digitare il tipo di connessione:" +#. define some other prompts +#: ../clients/cli/connections.c:47 +msgid "Connection type: " +msgstr "Tipo di connessione: " + +#: ../clients/cli/connections.c:48 +msgid "VPN type: " +msgstr "Tipo di VPN: " + +#: ../clients/cli/connections.c:49 +msgid "Bond master: " +msgstr "Bond master: " + +#: ../clients/cli/connections.c:50 +msgid "Team master: " +msgstr "Team master: " + +#: ../clients/cli/connections.c:51 +msgid "Bridge master: " +msgstr "Bridge master: " + +#: ../clients/cli/connections.c:52 +msgid "Connection (name, UUID, or path): " +msgstr "Connessione (nome, UUID o percorso): " + #. 0 -#. used only for 'GENERAL' group listing -#: ../cli/src/connections.c:68 ../cli/src/connections.c:175 -#: ../cli/src/devices.c:86 ../cli/src/devices.c:114 ../cli/src/devices.c:124 -#: ../cli/src/devices.c:134 ../cli/src/devices.c:143 ../cli/src/devices.c:158 -#: ../cli/src/devices.c:171 ../cli/src/devices.c:197 ../cli/src/devices.c:212 -#: ../cli/src/devices.c:221 +#: ../clients/cli/connections.c:60 ../clients/cli/connections.c:173 +#: ../clients/cli/devices.c:57 ../clients/cli/devices.c:86 +#: ../clients/cli/devices.c:96 ../clients/cli/devices.c:107 +#: ../clients/cli/devices.c:116 ../clients/cli/devices.c:131 +#: ../clients/cli/devices.c:144 ../clients/cli/devices.c:170 +#: ../clients/cli/devices.c:185 ../clients/cli/devices.c:194 +#: ../clients/cli/devices.c:204 msgid "NAME" msgstr "NOME" #. 0 #. 1 -#: ../cli/src/connections.c:69 ../cli/src/connections.c:176 +#: ../clients/cli/connections.c:61 ../clients/cli/connections.c:174 msgid "UUID" msgstr "UUID" @@ -460,150 +593,179 @@ msgstr "UUID" #. 0 #. 1 #. 2 -#: ../cli/src/connections.c:70 ../cli/src/connections.c:201 -#: ../cli/src/devices.c:72 ../cli/src/devices.c:88 ../cli/src/devices.c:200 +#: ../clients/cli/connections.c:62 ../clients/cli/connections.c:195 +#: ../clients/cli/devices.c:43 ../clients/cli/devices.c:59 +#: ../clients/cli/devices.c:173 msgid "TYPE" msgstr "TIPO" #. 2 -#: ../cli/src/connections.c:71 +#: ../clients/cli/connections.c:63 msgid "TIMESTAMP" msgstr "TIMESTAMP" #. 3 -#: ../cli/src/connections.c:72 +#: ../clients/cli/connections.c:64 msgid "TIMESTAMP-REAL" msgstr "TIMESTAMP-REALE" #. 4 -#. 14 -#: ../cli/src/connections.c:73 ../cli/src/devices.c:101 +#. 15 +#: ../clients/cli/connections.c:65 ../clients/cli/devices.c:73 msgid "AUTOCONNECT" msgstr "CONN-AUTOMATICA" #. 5 -#: ../cli/src/connections.c:74 +#: ../clients/cli/connections.c:66 +msgid "AUTOCONNECT-PRIORITY" +msgstr "PRIORITÀ-CONN-AUTOMATICA" + +#. 6 +#: ../clients/cli/connections.c:67 msgid "READONLY" msgstr "SOLO LETTURA" -#. 6 +#. 7 #. 8 #. 2 #. 15 #. 5 -#: ../cli/src/connections.c:75 ../cli/src/connections.c:183 -#: ../cli/src/devices.c:74 ../cli/src/devices.c:187 ../cli/src/devices.c:203 +#: ../clients/cli/connections.c:68 ../clients/cli/connections.c:181 +#: ../clients/cli/devices.c:45 ../clients/cli/devices.c:160 +#: ../clients/cli/devices.c:176 msgid "DBUS-PATH" msgstr "PERCORSO-DBUS" -#. 2 -#: ../cli/src/connections.c:177 -msgid "DEVICES" -msgstr "DISPOSITIVI" +#. 8 +#. 13 +#. 4 +#: ../clients/cli/connections.c:69 ../clients/cli/devices.c:158 +#: ../clients/cli/devices.c:175 +msgid "ACTIVE" +msgstr "ATTIVO" + +#. 9 +#. 0 +#. 12 +#. 3 +#: ../clients/cli/connections.c:70 ../clients/cli/devices.c:42 +#: ../clients/cli/devices.c:58 ../clients/cli/devices.c:157 +#: ../clients/cli/devices.c:174 +msgid "DEVICE" +msgstr "DEVICE" +#. 10 #. 3 #. 1 #. 9 #. 1 -#: ../cli/src/connections.c:178 ../cli/src/devices.c:73 -#: ../cli/src/devices.c:96 ../cli/src/network-manager.c:39 +#: ../clients/cli/connections.c:71 ../clients/cli/connections.c:176 +#: ../clients/cli/devices.c:44 ../clients/cli/devices.c:67 +#: ../clients/cli/general.c:37 msgid "STATE" msgstr "STATO" +#. 11 +#: ../clients/cli/connections.c:72 +msgid "ACTIVE-PATH" +msgstr "PERCORSO-ATTIVO" + +#. 2 +#: ../clients/cli/connections.c:175 +msgid "DEVICES" +msgstr "DISPOSITIVI" + #. 4 -#: ../cli/src/connections.c:179 +#: ../clients/cli/connections.c:177 msgid "DEFAULT" msgstr "PREDEFINITO" #. 5 -#: ../cli/src/connections.c:180 +#: ../clients/cli/connections.c:178 msgid "DEFAULT6" msgstr "PREDEFINITO6" #. 6 -#: ../cli/src/connections.c:181 +#: ../clients/cli/connections.c:179 msgid "SPEC-OBJECT" msgstr "SPEC-OGGETTO" #. 7 #. 4 -#: ../cli/src/connections.c:182 ../cli/src/connections.c:224 -#: ../tui/nm-editor-utils.c:243 ../tui/nmt-connect-connection-list.c:344 +#. Ask for optional 'vpn' arguments. +#: ../clients/cli/connections.c:180 ../clients/cli/connections.c:218 +#: ../clients/cli/connections.c:3816 ../clients/tui/nm-editor-utils.c:234 +#: ../clients/tui/nmt-connect-connection-list.c:406 msgid "VPN" msgstr "VPN" #. 9 #. 5 -#. 18 -#: ../cli/src/connections.c:184 ../cli/src/devices.c:77 -#: ../cli/src/devices.c:105 +#. 19 +#: ../clients/cli/connections.c:182 ../clients/cli/devices.c:48 +#: ../clients/cli/devices.c:77 msgid "CON-PATH" msgstr "PERCORSO-CON" #. 10 -#: ../cli/src/connections.c:185 +#: ../clients/cli/connections.c:183 msgid "ZONE" msgstr "ZONA" #. 11 -#: ../cli/src/connections.c:186 +#: ../clients/cli/connections.c:184 msgid "MASTER-PATH" msgstr "PERCORSO-MASTER" #. 1 -#: ../cli/src/connections.c:202 +#: ../clients/cli/connections.c:196 msgid "USERNAME" msgstr "NOMEUTENTE" -#. 2 -#: ../cli/src/connections.c:203 -msgid "GATEWAY" -msgstr "GATEWAY" - #. 3 -#: ../cli/src/connections.c:204 +#: ../clients/cli/connections.c:198 msgid "BANNER" msgstr "BANNER" #. 4 -#: ../cli/src/connections.c:205 +#: ../clients/cli/connections.c:199 msgid "VPN-STATE" msgstr "STATO-VPN" #. 5 -#: ../cli/src/connections.c:206 +#: ../clients/cli/connections.c:200 msgid "CFG" msgstr "CFG" -#: ../cli/src/connections.c:219 ../cli/src/devices.c:236 +#: ../clients/cli/connections.c:213 ../clients/cli/devices.c:219 msgid "GENERAL" msgstr "GENERALE" #. 0 #. 6 -#: ../cli/src/connections.c:220 ../cli/src/devices.c:243 +#: ../clients/cli/connections.c:214 ../clients/cli/devices.c:226 msgid "IP4" msgstr "IP4" #. 1 #. 7 -#: ../cli/src/connections.c:221 ../cli/src/devices.c:244 +#: ../clients/cli/connections.c:215 ../clients/cli/devices.c:227 msgid "DHCP4" msgstr "DHCP4" #. 2 #. 8 -#: ../cli/src/connections.c:222 ../cli/src/devices.c:245 +#: ../clients/cli/connections.c:216 ../clients/cli/devices.c:228 msgid "IP6" msgstr "IP6" #. 3 #. 9 -#: ../cli/src/connections.c:223 ../cli/src/devices.c:246 +#: ../clients/cli/connections.c:217 ../clients/cli/devices.c:229 msgid "DHCP6" msgstr "DHCP6" -#: ../cli/src/connections.c:255 +#: ../clients/cli/connections.c:251 #, c-format msgid "" "Usage: nmcli connection { COMMAND | help }\n" @@ -611,18 +773,20 @@ msgid "" "COMMAND := { show | up | down | add | modify | edit | delete | reload | " "load }\n" "\n" -" show configured [[id | uuid | path] ]\n" -" show active [[id | uuid | path | apath] ]\n" +" show [--active] [[--show-secrets] [id | uuid | path | apath] ] ...\n" "\n" -" up [[id | uuid | path] ] [ifname ] [ap ] [nsp ]\n" +" up [[id | uuid | path] ] [ifname ] [ap ] [nsp ] " +"[passwd-file ]\n" "\n" -" up [[id | uuid | path] ] [ifname ] [ap ]\n" +" up [[id | uuid | path] ] [ifname ] [ap ] [passwd-file " +"]\n" "\n" -" down [id | uuid | path | apath] \n" +" down [id | uuid | path | apath] ...\n" "\n" " add COMMON_OPTIONS TYPE_SPECIFIC_OPTIONS IP_OPTIONS\n" "\n" -" modify [id | uuid | path] . \n" +" modify [--temporary] [id | uuid | path] ([+|-]. " +")+\n" "\n" " edit [id | uuid | path] \n" " edit [type ] [con-name ]\n" @@ -636,20 +800,23 @@ msgid "" msgstr "" "Uso: mmcli connection { COMANDO | help }\n" "\n" -" COMANDO := { show | up | down | delete }\n" +" COMANDO := { show | up | down | add | modify | edit | delete | reload | " +"load }\n" "\n" -" show configured [[id | uuid | path ] ]\n" -" show active [[id | uuid | path | apath] ]\n" +" show [--active] [[--show-secrets] [id | uuid | path | apath] ] ...\n" "\n" -" up [id | uuid | path] [ifname ] [ap ] [nsp ]\n" +" up [[id | uuid | path] ] [ifname ] [ap ] [nsp ] " +"[passwd-file ]\n" "\n" -" up [id | uuid | path] [ifname ] [ap ]\n" +" up [[id | uuid | path] ] [ifname ] [ap ] [passwd-file " +"]\n" "\n" -" down [id | uuid | path | apath] \n" +" down [id | uuid | path | apath] ...\n" "\n" " add OPZIONI_COMUNI OPZIONI_SPECIFICHE OPZIONI_IP\n" "\n" -" modify [id | uuid | path] . \n" +" modify [--temporary] [id | uuid | path] ([+|-]." +" )+\n" "\n" " edit [id | uuid | path] \n" " edit [type ] [con-name ]\n" @@ -661,92 +828,106 @@ msgstr "" " load [...]\n" "\n" -#: ../cli/src/connections.c:278 +#: ../clients/cli/connections.c:272 #, c-format msgid "" "Usage: nmcli connection show { ARGUMENTS | help }\n" "\n" -"ARGUMENTS := active [[id | uuid | path | apath] ]\n" -"\n" -"Show connections which are currently used by a device to connect to a " -"network.\n" -"Without a parameter, all active connections are listed. When is " -"provided,\n" -"the connection details are displayed instead.\n" +"ARGUMENTS := [--active]\n" "\n" -"ARGUMENTS := configured [[id | uuid | path] ]\n" +"List in-memory and on-disk connection profiles, some of which may also be\n" +"active if a device is using that connection profile. Without a parameter, " +"all\n" +"profiles are listed. When --active option is specified, only the active\n" +"profiles are shown.\n" "\n" -"Show in-memory and on-disk connections, some of which may also be active if\n" -"a device is using that connection profile. Without a parameter, all " -"profiles\n" -"are listed. When is provided, the profile details are displayed " -"instead.\n" +"ARGUMENTS := [--active] [--show-secrets] [id | uuid | path | apath] " +" ...\n" "\n" +"Show details for specified connections. By default, both static " +"configuration\n" +"and active connection data are displayed. It is possible to filter the " +"output\n" +"using global '--fields' option. Refer to the manual page for more " +"information.\n" +"When --active option is specified, only the active profiles are taken into\n" +"account. --show-secrets option will reveal associated secrets as well.\n" msgstr "" -"Uso: mmcli connection show { ARGOMENTI | help }\n" +"Uso: nmcli connection show { ARGOMENTI | help }\n" "\n" -"ARGOMENTI := active [[id | uuid | path | apath] ]\n" +"ARGOMENTI := [--active]\n" "\n" -"Mostra le connessione che sono usate da un device per connettersi a una " -"rete.\n" -"Senza alcun parametro, vengono mostrate tutte le connessioni attive. Quando\n" -"viene specificato , vengono mostrati i dettagli per quella connessione.\n" +"Elenca i profili di connessione presenti in memoria o sul disco: alcuni di\n" +"questi potrebbero anche essere attivi se un dispositivo sta usando quel \n" +"particolare profilo di connessione. Senza alcun parametro, vengono elencati\n" +"tutti i profili. Se viene usato solo --active, vengono mostrati solamente i\n" +"profili attivi.\n" "\n" -"ARGOMENTI := configured [[id | uuid | path] ]\n" -"\n" -"Mostra le connessioni in memoria e sul disco: alcune possono essere attive " -"se\n" -"un device sta usando quel profilo di connessione. Senza alcun parametro, " -"sono\n" -"mostrati tutti i profili. Quando viene specificato , vengono mostrati i\n" -"dettagli del profilo.\n" +"ARGOMENTI := [--active] [--show-secrets] [id | uuid | path | apath] " +" ...\n" "\n" +"Mostra dettagli per le connessioni specificate: come impostazione " +"predefinita\n" +"vengono visualizzate sia le configurazioni statiche che le connessioni " +"attive.\n" +"È possibile filtrare l'output utilizzando l'opzione «--fields». Per " +"maggiori\n" +"informazioni fare riferimento alla pagina di manuale. Quando viene usata\n" +"l'opzione --active, vengono presi in considerazione solo i profili attivi;\n" +"l'opzione --show-secrets mostra anche i segreti associati.\n" -#: ../cli/src/connections.c:297 +#: ../clients/cli/connections.c:293 #, c-format msgid "" "Usage: nmcli connection up { ARGUMENTS | help }\n" "\n" "ARGUMENTS := [id | uuid | path] [ifname ] [ap ] [nsp " -"]\n" +"] [passwd-file ]\n" "\n" "Activate a connection on a device. The profile to activate is identified by " "its\n" "name, UUID or D-Bus path.\n" "\n" -"ARGUMENTS := ifname [ap ] [nsp ]\n" +"ARGUMENTS := ifname [ap ] [nsp ] [passwd-file ]\n" "\n" "Activate a device with a connection. The connection profile is selected\n" "automatically by NetworkManager.\n" "\n" -"ifname - specifies the device to active the connection on\n" -"ap - specifies AP to connect to (only valid for Wi-Fi)\n" -"nsp - specifies NSP to connect to (only valid for WiMAX)\n" +"ifname - specifies the device to active the connection on\n" +"ap - specifies AP to connect to (only valid for Wi-Fi)\n" +"nsp - specifies NSP to connect to (only valid for WiMAX)\n" +"passwd-file - file with password(s) required to activate the connection\n" "\n" msgstr "" "Uso: mmcli connection up { ARGOMENTI | help }\n" "\n" "ARGOMENTI := [id | uuid | path] [ifname ] [ap ]\n" -" [nsp ]\n" -"Attiva una connessione su un device. Il profilo da attivare è identificato\n" +" [nsp ] [passwd-file ]\n" +"\n" +"Attiva una connessione su un dispositivo. Il profilo da attivare è " +"identificato\n" "tramite il suo nome, UUID o percorso D-Bus.\n" "\n" "ARGOMENTI := ifname [ap ] [nsp ]\n" +" [passwd-file ]\n" "\n" -"Attiva un device con una connessione. Il profilo della connessione viene\n" +"Attiva un dispositivo con una connessione. Il profilo della connessione " +"viene\n" "selezionato automaticamente.\n" "\n" -"nomeif - Indica il device su cui attivare la connessione\n" -"ap - Indica lo access point a cui connettersi (solo per Wi-Fi)\n" -"nsp - Indica lo NSP a cui connettersi (solo per WiMAX)\n" +"nomeif - Indica il dispositivo su cui attivare la connessione\n" +"ap - Indica lo access point a cui connettersi (solo per Wi-Fi)\n" +"nsp - Indica lo NSP a cui connettersi (solo per WiMAX)\n" +"passwd-file - File con le password richieste per attivare la connessione\n" "\n" -#: ../cli/src/connections.c:318 +#: ../clients/cli/connections.c:314 #, c-format msgid "" "Usage: nmcli connection down { ARGUMENTS | help }\n" "\n" -"ARGUMENTS := [id | uuid | path | apath] \n" +"ARGUMENTS := [id | uuid | path | apath] ...\n" "\n" "Deactivate a connection from a device (without preventing the device from\n" "further auto-activation). The profile to deactivate is identified by its " @@ -756,15 +937,14 @@ msgid "" msgstr "" "Uso: mmcli connection down { ARGOMENTI | help }\n" "\n" -"ARGOMENTI := [id | uuid | path | apath] \n" +"ARGOMENTI := [id | uuid | path | apath] ...\n" "\n" -"Disattiva una connessione da un device (facendo in modo che il device non " -"possa\n" +"Disattiva una connessione da un dispositivo (facendo in modo che non possa\n" "più connettersi automaticamente). Il profilo da disattivare è identificato\n" "tramite il suo nome, UUID o percorso D-Bus.\n" "\n" -#: ../cli/src/connections.c:331 +#: ../clients/cli/connections.c:326 #, c-format msgid "" "Usage: nmcli connection add { ARGUMENTS | help }\n" @@ -777,6 +957,8 @@ msgid "" " [con-name ]\n" " [autoconnect yes|no]\n" "\n" +" [save yes|no]\n" +"\n" " TYPE_SPECIFIC_OPTIONS:\n" " ethernet: [mac ]\n" " [cloned-mac ]\n" @@ -786,6 +968,7 @@ msgid "" " [mac ]\n" " [cloned-mac ]\n" " [mtu ]\n" +" [mode infrastructure|ap|adhoc]\n" "\n" " wimax: [mac ]\n" " [nsp ]\n" @@ -829,12 +1012,13 @@ msgid "" " [updelay ]\n" " [arp-interval ]\n" " [arp-ip-target ]\n" +" [lacp-rate slow (0) | fast (1)]\n" "\n" -" bond-slave: master \n" +" bond-slave: master \n" "\n" " team: [config |]\n" "\n" -" team-slave: master \n" +" team-slave: master \n" " [config |]\n" "\n" " bridge: [stp yes|no]\n" @@ -843,13 +1027,15 @@ msgid "" " [hello-time <1-10>]\n" " [max-age <6-40>]\n" " [ageing-time <0-1000000>]\n" +" [mac ]\n" "\n" -" bridge-slave: master \n" +" bridge-slave: master \n" " [priority <0-63>]\n" " [path-cost <1-65535>]\n" " [hairpin yes|no]\n" "\n" -" vpn: vpn-type vpnc|openvpn|pptp|openconnect|openswan\n" +" vpn: vpn-type vpnc|openvpn|pptp|openconnect|openswan|libreswan|" +"ssh|l2tp|iodine|...\n" " [user ]\n" "\n" " olpc-mesh: ssid \n" @@ -861,9 +1047,9 @@ msgid "" " [ip6 ] [gw6 ]\n" "\n" msgstr "" -"Uso: mmcli connection add { OPZIONI | help }\n" +"Uso: mmcli connection add { ARGOMENTI | help }\n" "\n" -" OPZIONI := OPZIONI_COMUNI OPZIONI_SPECIFICHE OPZIONI_IP\n" +"ARGOMENTI := OPZIONI_COMUNI OPZIONI_SPECIFICHE OPZIONI_IP\n" "\n" " OPZIONI_COMUNI:\n" " type \n" @@ -871,6 +1057,8 @@ msgstr "" " [con-name ]\n" " [autoconnect yes|no]\n" "\n" +" [save yes|no]\n" +"\n" " OPZIONI_SPECIFICHE:\n" " ethernet: [mac ]\n" " [cloned-mac ]\n" @@ -880,6 +1068,7 @@ msgstr "" " [mac ]\n" " [cloned-mac ]\n" " [mtu ]\n" +" [mode infrastructure|ap|adhoc]\n" "\n" " wimax: [mac ]\n" " [nsp ]\n" @@ -899,16 +1088,16 @@ msgstr "" "\n" " infiniband: [mac ]\n" " [mtu ]\n" -" [transport-mode ]\n" -" [parent ]\n" +" [transport-mode datagram | connected]\n" +" [parent ]\n" " [p-key ]\n" "\n" " bluetooth: [addr ]\n" " [bt-type panu|dun-gsm|dun-cdma]\n" "\n" -" vlan: dev ]\n" +" id \n" " [flags ]\n" " [ingress ]\n" " [egress ]\n" @@ -925,12 +1114,13 @@ msgstr "" " [updelay ]\n" " [arp_interval ]\n" " [arp_ip_traget ]\n" +" [lacp-rate slow (0) | fast (1)]\n" "\n" -" bond-slave: master ]\n" +" team: [config |]\n" "\n" -" team-slave: master |]\n" "\n" " bridge: [stp yes|no>]\n" @@ -939,13 +1129,16 @@ msgstr "" " [hello-time <1-10>]\n" " [max-age <6-40>]\n" " [ageing-time <0-1000000>]\n" +" [mac ]\n" "\n" -" bridge-slave: master ]\n" " [path-cost <1-65535>]\n" " [hairpin yes|no]\n" "\n" -" vpn: vpn-type vpnc|openvpn|pptp|openconnect|openswan\n" +" vpn: vpn-type vpnc|openvpn|pptp|openconnect|openswan|" +"libreswan|\n" +" ssh|l2tp|iodine|...\n" " [user ]\n" "\n" " olpc-mesh: ssid \n" @@ -957,27 +1150,54 @@ msgstr "" " [ip6 ] [gw6 ]\n" "\n" -#: ../cli/src/connections.c:408 +#: ../clients/cli/connections.c:406 #, c-format msgid "" "Usage: nmcli connection modify { ARGUMENTS | help }\n" "\n" -"ARGUMENTS := [id | uuid | path] . " -"[]\n" +"ARGUMENTS := [id | uuid | path] ([+|-]. )+\n" "\n" -"Modify a single property in the connection profile.\n" -"The profile is identified by its name, UUID or D-Bus path.\n" +"Modify one or more properties of the connection profile.\n" +"The profile is identified by its name, UUID or D-Bus path. For multi-valued\n" +"properties you can use optional '+' or '-' prefix to the property name.\n" +"The '+' sign allows appending items instead of overwriting the whole value.\n" +"The '-' sign allows removing selected items instead of the whole value.\n" +"\n" +"Examples:\n" +"nmcli con mod home-wifi wifi.ssid rakosnicek\n" +"nmcli con mod em1-1 ipv4.method manual ipv4.addr \"192.168.1.2/24, " +"10.10.1.5/8\"\n" +"nmcli con mod em1-1 +ipv4.dns 8.8.4.4\n" +"nmcli con mod em1-1 -ipv4.dns 1\n" +"nmcli con mod em1-1 -ipv6.addr \"abbe::cafe/56\"\n" +"nmcli con mod bond0 +bond.options mii=500\n" +"nmcli con mod bond0 -bond.options downdelay\n" "\n" msgstr "" -"Uso: mmcli connection modify { ARGOMENTI | help }\n" +"Uso: nmcli connection modify { ARGOMENTI | help }\n" "\n" -"ARGOMENTI := [id | uuid | path] . []\n" +"ARGOMENTI := [id | uuid | path] ([+|-]. )+\n" "\n" -"Modifica una proprietà nel profilo di connessione.\n" -"Il profilo viene identificato tramite il suo nome, UUID o percorso D-Bus.\n" +"Modifica una o più proprietà del profilo di connessione.\n" +"Il profilo è identificato tramite il suo nome, UUID o percorso D-Bus. Per\n" +"proprietà multi-valore, usare il prefisso opzionale «+» o «-» col nome " +"della\n" +"proprietà. Il simbolo «+» consente di aggiungere elementi invece che\n" +"sovrascriverne il valore; il simbolo «-» consente di rimuovere gli elementi\n" +"selezionati invece che rimuovere l'intero valore.\n" +"\n" +"Esempi:\n" +"nmcli con mod home-wifi wifi.ssid rakosnicek\n" +"nmcli con mod em1-1 ipv4.method manual ipv4.addr \"192.168.1.2/24, " +"10.10.1.5/8\"\n" +"nmcli con mod em1-1 +ipv4.dns 8.8.4.4\n" +"nmcli con mod em1-1 -ipv4.dns 1\n" +"nmcli con mod em1-1 -ipv6.addr \"abbe::cafe/56\"\n" +"nmcli con mod bond0 +bond.options mii=500\n" +"nmcli con mod bond0 -bond.options downdelay\n" "\n" -#: ../cli/src/connections.c:420 +#: ../clients/cli/connections.c:429 #, c-format msgid "" "Usage: nmcli connection edit { ARGUMENTS | help }\n" @@ -1004,7 +1224,7 @@ msgstr "" "Aggiunge un nuovo profilo di connessione con un editor interattivo.\n" "\n" -#: ../cli/src/connections.c:436 +#: ../clients/cli/connections.c:444 #, c-format msgid "" "Usage: nmcli connection delete { ARGUMENTS | help }\n" @@ -1023,7 +1243,7 @@ msgstr "" "Il profilo viene identificato tramite il suo nome, UUID o percorso D-Bus.\n" "\n" -#: ../cli/src/connections.c:448 +#: ../clients/cli/connections.c:455 #, c-format msgid "" "Usage: nmcli connection reload { help }\n" @@ -1036,7 +1256,7 @@ msgstr "" "Ricarica tutti i file della connessione dal disco.\n" "\n" -#: ../cli/src/connections.c:457 +#: ../clients/cli/connections.c:463 #, c-format msgid "" "Usage: nmcli connection load { ARGUMENTS | help }\n" @@ -1059,834 +1279,872 @@ msgstr "" "NetworkManager consideri le nuove modifiche.\n" "\n" -#: ../cli/src/connections.c:515 -#, c-format -msgid "Error: 'list configured': %s" -msgstr "Errore: «list configured»: %s" - -#. Main header -#: ../cli/src/connections.c:523 -msgid "Connection details" -msgstr "Dettagli connessione" - -#: ../cli/src/connections.c:589 -msgid "never" -msgstr "mai" - -#. "CAPABILITIES" -#: ../cli/src/connections.c:590 ../cli/src/connections.c:591 -#: ../cli/src/connections.c:833 ../cli/src/connections.c:834 -#: ../cli/src/connections.c:836 ../cli/src/connections.c:6112 -#: ../cli/src/devices.c:604 ../cli/src/devices.c:654 ../cli/src/devices.c:796 -#: ../cli/src/devices.c:797 ../cli/src/devices.c:798 ../cli/src/devices.c:831 -#: ../cli/src/devices.c:860 ../cli/src/devices.c:861 ../cli/src/devices.c:862 -#: ../cli/src/devices.c:863 ../cli/src/devices.c:864 ../cli/src/devices.c:865 -#: ../cli/src/devices.c:866 ../cli/src/network-manager.c:442 -msgid "yes" -msgstr "sì" - -#: ../cli/src/connections.c:590 ../cli/src/connections.c:591 -#: ../cli/src/connections.c:833 ../cli/src/connections.c:834 -#: ../cli/src/connections.c:836 ../cli/src/connections.c:6112 -#: ../cli/src/devices.c:604 ../cli/src/devices.c:654 ../cli/src/devices.c:796 -#: ../cli/src/devices.c:797 ../cli/src/devices.c:798 ../cli/src/devices.c:831 -#: ../cli/src/devices.c:860 ../cli/src/devices.c:861 ../cli/src/devices.c:862 -#: ../cli/src/devices.c:863 ../cli/src/devices.c:864 ../cli/src/devices.c:865 -#: ../cli/src/devices.c:866 ../cli/src/network-manager.c:444 -msgid "no" -msgstr "no" - -#. Add headers -#: ../cli/src/connections.c:667 -msgid "List of configured connections" -msgstr "Elenco delle connessioni configurate" - -#: ../cli/src/connections.c:684 ../cli/src/connections.c:1225 -#: ../cli/src/connections.c:1785 ../cli/src/connections.c:1801 -#: ../cli/src/connections.c:1810 ../cli/src/connections.c:1820 -#: ../cli/src/connections.c:1916 ../cli/src/connections.c:7503 -#: ../cli/src/connections.c:7678 ../cli/src/devices.c:1628 -#: ../cli/src/devices.c:1636 ../cli/src/devices.c:2023 -#: ../cli/src/devices.c:2030 ../cli/src/devices.c:2044 -#: ../cli/src/devices.c:2051 ../cli/src/devices.c:2068 -#: ../cli/src/devices.c:2076 ../cli/src/devices.c:2272 -#: ../cli/src/devices.c:2368 ../cli/src/devices.c:2375 -#, c-format -msgid "Error: %s argument is missing." -msgstr "Errore: manca l'argomento %s." - -#: ../cli/src/connections.c:698 -#, c-format -msgid "Error: %s - no such connection." -msgstr "Errore: %s - la connessione non esiste." - -#: ../cli/src/connections.c:710 -#, c-format -msgid "Error: 'show configured': %s" -msgstr "Errore: «show configured»: %s" - -#: ../cli/src/connections.c:715 ../cli/src/connections.c:1853 -#: ../cli/src/connections.c:7744 ../cli/src/connections.c:7785 -#: ../cli/src/connections.c:7937 ../cli/src/devices.c:2251 -#: ../cli/src/devices.c:2625 ../cli/src/network-manager.c:539 -#: ../cli/src/network-manager.c:582 ../cli/src/network-manager.c:599 -#: ../cli/src/network-manager.c:645 ../cli/src/network-manager.c:659 -#: ../cli/src/network-manager.c:776 ../cli/src/network-manager.c:820 -#: ../cli/src/network-manager.c:840 -#, c-format -msgid "Error: %s." -msgstr "Errore: %s." - -#: ../cli/src/connections.c:728 +#: ../clients/cli/connections.c:534 msgid "activating" msgstr "attivazione" -#: ../cli/src/connections.c:730 +#: ../clients/cli/connections.c:536 msgid "activated" msgstr "attivata" -#: ../cli/src/connections.c:734 +#: ../clients/cli/connections.c:540 msgid "deactivated" msgstr "disattivata" -#: ../cli/src/connections.c:746 +#: ../clients/cli/connections.c:552 msgid "VPN connecting (prepare)" msgstr "Connessione VPN (preparazione)" -#: ../cli/src/connections.c:748 +#: ../clients/cli/connections.c:554 msgid "VPN connecting (need authentication)" msgstr "Connessione VPN (autenticazione necessaria)" -#: ../cli/src/connections.c:750 +#: ../clients/cli/connections.c:556 msgid "VPN connecting" msgstr "Connessione VPN" -#: ../cli/src/connections.c:752 +#: ../clients/cli/connections.c:558 msgid "VPN connecting (getting IP configuration)" msgstr "Connessione VPN (acquisizione configurazione IP)" -#: ../cli/src/connections.c:754 +#: ../clients/cli/connections.c:560 msgid "VPN connected" msgstr "Connessi alla VPN" -#: ../cli/src/connections.c:756 +#: ../clients/cli/connections.c:562 msgid "VPN connection failed" msgstr "Connessione VPN non riuscita" -#: ../cli/src/connections.c:758 +#: ../clients/cli/connections.c:564 msgid "VPN disconnected" msgstr "Disconnessi dalla VPN" -#: ../cli/src/connections.c:829 ../cli/src/connections.c:839 -#: ../cli/src/devices.c:594 -msgid "N/A" -msgstr "N/D" +#: ../clients/cli/connections.c:634 +#, c-format +msgid "Error updating secrets for %s: %s\n" +msgstr "Errore nell'aggiornare i segreti per %s: %s\n" + +#: ../clients/cli/connections.c:654 +msgid "Connection profile details" +msgstr "Dettagli profilo connessione" -#: ../cli/src/connections.c:1012 +#: ../clients/cli/connections.c:666 ../clients/cli/connections.c:1075 #, c-format -msgid "Error: 'list active': %s" -msgstr "Errore: «list active»: %s" +msgid "Error: 'connection show': %s" +msgstr "Errore: «connection show»: %s" -# [NdT] si tratta di un messaggio che descrive un’azione -#. Main header -#: ../cli/src/connections.c:1020 -msgid "Active connection details" -msgstr "Dettagli connessione attiva" - -#: ../cli/src/connections.c:1177 ../cli/src/connections.c:1840 -#: ../cli/src/connections.c:1899 ../cli/src/connections.c:7532 -#: ../cli/src/connections.c:7647 ../cli/src/connections.c:7738 -#: ../cli/src/connections.c:7766 ../cli/src/devices.c:1195 -#: ../cli/src/devices.c:1242 ../cli/src/devices.c:1398 -#: ../cli/src/devices.c:1533 ../cli/src/devices.c:1670 -#: ../cli/src/devices.c:2110 ../cli/src/devices.c:2409 -#: ../cli/src/network-manager.c:484 +#: ../clients/cli/connections.c:812 +msgid "never" +msgstr "mai" + +#. "CAPABILITIES" +#: ../clients/cli/connections.c:813 ../clients/cli/connections.c:815 +#: ../clients/cli/connections.c:817 ../clients/cli/connections.c:849 +#: ../clients/cli/connections.c:916 ../clients/cli/connections.c:917 +#: ../clients/cli/connections.c:919 ../clients/cli/connections.c:3111 +#: ../clients/cli/connections.c:6949 ../clients/cli/connections.c:6950 +#: ../clients/cli/devices.c:589 ../clients/cli/devices.c:639 +#: ../clients/cli/devices.c:846 ../clients/cli/devices.c:847 +#: ../clients/cli/devices.c:848 ../clients/cli/devices.c:849 +#: ../clients/cli/devices.c:882 ../clients/cli/devices.c:884 +#: ../clients/cli/devices.c:912 ../clients/cli/devices.c:913 +#: ../clients/cli/devices.c:914 ../clients/cli/devices.c:915 +#: ../clients/cli/devices.c:916 ../clients/cli/devices.c:917 +#: ../clients/cli/devices.c:918 ../clients/cli/general.c:421 +msgid "yes" +msgstr "sì" + +#: ../clients/cli/connections.c:813 ../clients/cli/connections.c:815 +#: ../clients/cli/connections.c:817 ../clients/cli/connections.c:916 +#: ../clients/cli/connections.c:917 ../clients/cli/connections.c:919 +#: ../clients/cli/connections.c:3112 ../clients/cli/connections.c:6949 +#: ../clients/cli/connections.c:6950 ../clients/cli/devices.c:589 +#: ../clients/cli/devices.c:639 ../clients/cli/devices.c:846 +#: ../clients/cli/devices.c:847 ../clients/cli/devices.c:848 +#: ../clients/cli/devices.c:849 ../clients/cli/devices.c:882 +#: ../clients/cli/devices.c:884 ../clients/cli/devices.c:912 +#: ../clients/cli/devices.c:913 ../clients/cli/devices.c:914 +#: ../clients/cli/devices.c:915 ../clients/cli/devices.c:916 +#: ../clients/cli/devices.c:917 ../clients/cli/devices.c:918 +#: ../clients/cli/general.c:423 +msgid "no" +msgstr "no" + +#: ../clients/cli/connections.c:1063 +msgid "Activate connection details" +msgstr "Attiva dettagli connessione" + +#: ../clients/cli/connections.c:1299 #, c-format -msgid "Error: NetworkManager is not running." -msgstr "Errore: NetworkManager non è in esecuzione." +msgid "invalid field '%s'; allowed fields: %s and %s, or %s,%s" +msgstr "campo «%s» non valido; campi consentiti: %s e %s oppure %s,%s" + +#: ../clients/cli/connections.c:1314 ../clients/cli/connections.c:1322 +#, c-format +msgid "'%s' has to be alone" +msgstr "«%s» deve essere isolato" #. Add headers -#: ../cli/src/connections.c:1203 -msgid "List of active connections" -msgstr "Elenco delle connessioni attive" +#: ../clients/cli/connections.c:1377 +msgid "NetworkManager active profiles" +msgstr "Profili NetworkManager attivi" + +#: ../clients/cli/connections.c:1378 +msgid "NetworkManager connection profiles" +msgstr "Profili connessione NetworkManager" + +#: ../clients/cli/connections.c:1418 ../clients/cli/connections.c:2145 +#: ../clients/cli/connections.c:2167 ../clients/cli/connections.c:2176 +#: ../clients/cli/connections.c:2186 ../clients/cli/connections.c:2196 +#: ../clients/cli/connections.c:2346 ../clients/cli/connections.c:8499 +#: ../clients/cli/connections.c:8716 ../clients/cli/devices.c:1909 +#: ../clients/cli/devices.c:1917 ../clients/cli/devices.c:2233 +#: ../clients/cli/devices.c:2240 ../clients/cli/devices.c:2254 +#: ../clients/cli/devices.c:2261 ../clients/cli/devices.c:2278 +#: ../clients/cli/devices.c:2286 ../clients/cli/devices.c:2474 +#: ../clients/cli/devices.c:2570 ../clients/cli/devices.c:2577 +#, c-format +msgid "Error: %s argument is missing." +msgstr "Errore: manca l'argomento %s." -#: ../cli/src/connections.c:1239 ../cli/src/connections.c:1926 +#: ../clients/cli/connections.c:1433 #, c-format -msgid "Error: '%s' is not an active connection." -msgstr "Errore: «%s» non è una connessione attiva." +msgid "Error: %s - no such connection profile." +msgstr "Errore: %s - profilo di connessione inesistente." -#: ../cli/src/connections.c:1251 +#: ../clients/cli/connections.c:1492 ../clients/cli/connections.c:2219 +#: ../clients/cli/connections.c:9016 ../clients/cli/devices.c:2453 +#: ../clients/cli/devices.c:2921 ../clients/cli/general.c:518 +#: ../clients/cli/general.c:567 ../clients/cli/general.c:584 +#: ../clients/cli/general.c:623 ../clients/cli/general.c:637 +#: ../clients/cli/general.c:755 ../clients/cli/general.c:802 +#: ../clients/cli/general.c:822 #, c-format -msgid "Error: 'show active': %s" -msgstr "Errore: «show active»: %s" +msgid "Error: %s." +msgstr "Errore: %s." -#: ../cli/src/connections.c:1344 +#: ../clients/cli/connections.c:1587 #, c-format msgid "no active connection on device '%s'" msgstr "nessuna connessione attiva sul dispositivo «%s»" -#: ../cli/src/connections.c:1352 +#: ../clients/cli/connections.c:1595 msgid "no active connection or device" msgstr "nessuna connessione o dispositivo attivo" -#: ../cli/src/connections.c:1423 +#: ../clients/cli/connections.c:1666 #, c-format msgid "device '%s' not compatible with connection '%s'" msgstr "dispositivo «%s» non compatibile con la connessione «%s»" -#: ../cli/src/connections.c:1426 +#: ../clients/cli/connections.c:1669 #, c-format msgid "no device found for connection '%s'" msgstr "nessun dispositivo trovato per la connessione «%s»" -#: ../cli/src/connections.c:1438 +#: ../clients/cli/connections.c:1681 msgid "unknown reason" msgstr "motivo sconosciuto" -#: ../cli/src/connections.c:1440 ../cli/src/network-manager.c:288 +#: ../clients/cli/connections.c:1683 ../clients/cli/general.c:272 msgid "none" msgstr "nessuno" -#: ../cli/src/connections.c:1442 +#: ../clients/cli/connections.c:1685 msgid "the user was disconnected" msgstr "l'utente è stato scollegato" -#: ../cli/src/connections.c:1444 +#: ../clients/cli/connections.c:1687 msgid "the base network connection was interrupted" msgstr "la connessione di rete di base è stata interrotta" -#: ../cli/src/connections.c:1446 +#: ../clients/cli/connections.c:1689 msgid "the VPN service stopped unexpectedly" msgstr "il servizio VPN si è arrestato inaspettatamente" -#: ../cli/src/connections.c:1448 +#: ../clients/cli/connections.c:1691 msgid "the VPN service returned invalid configuration" msgstr "il servizio VPN ha restituito una configurazione non valida" -#: ../cli/src/connections.c:1450 +#: ../clients/cli/connections.c:1693 msgid "the connection attempt timed out" msgstr "il tentativo di connessione è scaduto" -#: ../cli/src/connections.c:1452 +#: ../clients/cli/connections.c:1695 msgid "the VPN service did not start in time" msgstr "il servizio VPN non è stato avviato in tempo" -#: ../cli/src/connections.c:1454 +#: ../clients/cli/connections.c:1697 msgid "the VPN service failed to start" msgstr "l'avvio del servizio VPN non è riuscito" -#: ../cli/src/connections.c:1456 +#: ../clients/cli/connections.c:1699 msgid "no valid VPN secrets" msgstr "nessun segreto VPN valido" -#: ../cli/src/connections.c:1458 +#: ../clients/cli/connections.c:1701 msgid "invalid VPN secrets" msgstr "segreti VPN non validi" -#: ../cli/src/connections.c:1460 +#: ../clients/cli/connections.c:1703 msgid "the connection was removed" msgstr "la connessione è stata rimossa" -#: ../cli/src/connections.c:1477 ../cli/src/connections.c:1633 -#: ../cli/src/connections.c:6016 +#: ../clients/cli/connections.c:1725 ../clients/cli/connections.c:1753 +#: ../clients/cli/connections.c:1914 ../clients/cli/connections.c:6840 #, c-format msgid "Connection successfully activated (D-Bus active path: %s)\n" msgstr "Connessione attivata con successo (percorso D-Bus attivo: %s)\n" -#: ../cli/src/connections.c:1482 +#: ../clients/cli/connections.c:1732 +#, c-format +msgid "" +"Connection successfully activated (master waiting for slaves) (D-Bus active " +"path: %s)\n" +msgstr "" +"Connessione attivata con successo (master in attesa di slave) (percorso D-" +"Bus attivo: %s)\n" + +#: ../clients/cli/connections.c:1736 ../clients/cli/connections.c:1758 #, c-format msgid "Error: Connection activation failed." msgstr "Errore: attivazione connessione non riuscita." -#: ../cli/src/connections.c:1507 +#: ../clients/cli/connections.c:1809 #, c-format msgid "VPN connection successfully activated (D-Bus active path: %s)\n" msgstr "Connessione VPN attivata con successo (percorso D-Bus attivo: %s)\n" -#: ../cli/src/connections.c:1514 +#: ../clients/cli/connections.c:1817 #, c-format msgid "Error: Connection activation failed: %s." msgstr "Errore: attivazione connessione non riuscita: %s." -#: ../cli/src/connections.c:1532 ../cli/src/devices.c:1289 +#: ../clients/cli/connections.c:1836 ../clients/cli/devices.c:1322 #, c-format msgid "Error: Timeout %d sec expired." msgstr "Errore: timeout, sono trascorsi %d secondi." -#: ../cli/src/connections.c:1597 -#, c-format -msgid "" -"Error: Device '%s' is waiting for slaves before proceeding with activation." -msgstr "" -"Errore: il dispositivo «%s» è in attesa degli slave prima di poter procedere " -"con l'attivazione." - -#: ../cli/src/connections.c:1617 +#: ../clients/cli/connections.c:1896 #, c-format msgid "Error: Connection activation failed: %s" msgstr "Errore: attivazione connessione non riuscita: %s" -#: ../cli/src/connections.c:1722 ../cli/src/connections.c:1854 +#: ../clients/cli/connections.c:1981 +#, c-format +msgid "failed to read passwd-file '%s': %s" +msgstr "Lettura del passwd-file «%s» non riuscita: %s" + +#: ../clients/cli/connections.c:1993 +#, c-format +msgid "missing colon in 'password' entry '%s'" +msgstr "mancano i due punti nella voce «password» «%s»" + +#: ../clients/cli/connections.c:2001 +#, c-format +msgid "missing dot in 'password' entry '%s'" +msgstr "manca il punto nella voce «password» «%s»" + +#: ../clients/cli/connections.c:2014 +#, c-format +msgid "invalid setting name in 'password' entry '%s'" +msgstr "nome impostazione non valido nelle voce «password» «%s»" + +#: ../clients/cli/connections.c:2061 ../clients/cli/connections.c:2220 msgid "unknown error" msgstr "errore sconosciuto" -#: ../cli/src/connections.c:1730 +#: ../clients/cli/connections.c:2070 #, c-format msgid "unknown device '%s'." msgstr "dispositivo «%s» sconosciuto." -#: ../cli/src/connections.c:1735 +#: ../clients/cli/connections.c:2075 msgid "neither a valid connection nor device given" msgstr "non sono stati forniti un dispositivo e una connessione validi" -#: ../cli/src/connections.c:1773 ../cli/src/connections.c:1884 -#: ../cli/src/connections.c:7654 -msgid "Connection (name, UUID, or path): " -msgstr "Connessione (nome, UUID o percorso): " +#: ../clients/cli/connections.c:2158 +#, c-format +msgid "Error: Connection '%s' does not exist." +msgstr "Errore: la connessione «%s» non esiste." -#: ../cli/src/connections.c:1829 ../cli/src/devices.c:1169 -#: ../cli/src/devices.c:1642 ../cli/src/devices.c:2087 -#: ../cli/src/devices.c:2381 +#: ../clients/cli/connections.c:2204 ../clients/cli/devices.c:1221 +#: ../clients/cli/devices.c:1923 ../clients/cli/devices.c:2297 +#: ../clients/cli/devices.c:2583 #, c-format msgid "Unknown parameter: %s\n" msgstr "Parametro sconosciuto: %s\n" -#: ../cli/src/connections.c:1862 +#: ../clients/cli/connections.c:2228 msgid "preparing" msgstr "preparazione" -#: ../cli/src/connections.c:1889 ../cli/src/connections.c:7659 -#: ../cli/src/connections.c:7772 +#: ../clients/cli/connections.c:2267 +#, c-format +msgid "Connection '%s' successfully deactivated (D-Bus active path: %s)\n" +msgstr "" +"Connessione «%s» disattivata con successo (percorso D-Bus attivo: %s)\n" + +#: ../clients/cli/connections.c:2325 ../clients/cli/connections.c:8697 +#: ../clients/cli/connections.c:8811 #, c-format msgid "Error: No connection specified." msgstr "Errore: nessuna connessione specificata." -#: ../cli/src/connections.c:2237 ../cli/src/utils.c:490 +#: ../clients/cli/connections.c:2356 +#, c-format +msgid "Error: '%s' is not an active connection.\n" +msgstr "Errore: «%s» non è una connessione attiva.\n" + +#: ../clients/cli/connections.c:2357 +#, c-format +msgid "Error: not all active connections found." +msgstr "Errore: non tutte le connessioni attive sono state trovate." + +#: ../clients/cli/connections.c:2366 +#, c-format +msgid "Error: no active connection provided." +msgstr "Errore: nessuna connessione attiva fornita." + +#: ../clients/cli/connections.c:2684 ../clients/cli/utils.c:516 #, c-format msgid "'%s' not among [%s]" msgstr "«%s» non tra [%s]" -#: ../cli/src/connections.c:2319 +#: ../clients/cli/connections.c:2763 #, c-format msgid "Error: '%s': '%s' is not a valid %s MAC address." msgstr "Errore: «%s»: «%s» non è un indirizzo MAC %s valido." -#: ../cli/src/connections.c:2320 ../tui/nm-editor-utils.c:173 -#: ../tui/nm-ui-utils.c:347 +#. Ask for optional arguments +#: ../clients/cli/connections.c:2764 ../clients/cli/connections.c:3226 +#: ../clients/tui/nm-editor-utils.c:164 ../libnm-core/nm-connection.c:1573 +#: ../libnm-glib/nm-device.c:1801 ../libnm/nm-device.c:1623 msgid "InfiniBand" msgstr "InfiniBand" -#: ../cli/src/connections.c:2320 ../tui/nm-editor-utils.c:156 -#: ../tui/nm-ui-utils.c:335 +#: ../clients/cli/connections.c:2764 ../clients/tui/nm-editor-utils.c:147 +#: ../libnm-glib/nm-device.c:1789 ../libnm/nm-device.c:1611 msgid "Ethernet" msgstr "Ethernet" -#: ../cli/src/connections.c:2343 +#: ../clients/cli/connections.c:2784 #, c-format msgid "Error: 'mtu': '%s' is not a valid MTU." msgstr "Errore: «mtu»: «%s» non è un MTU valido." -#: ../cli/src/connections.c:2359 +#: ../clients/cli/connections.c:2800 #, c-format msgid "Error: 'parent': '%s' is not a valid interface name." msgstr "Errore: «parent»: «%s» non è un'interfaccia valida." -#: ../cli/src/connections.c:2380 +#: ../clients/cli/connections.c:2821 #, c-format msgid "Error: 'p-key': '%s' is not a valid InfiniBand P_KEY." msgstr "Errore: «p-key»: «%s» non è un P_KEY InfiniBand valido." -#: ../cli/src/connections.c:2396 +#: ../clients/cli/connections.c:2866 #, c-format -msgid "" -"Error: 'mode': '%s' is not a valid InfiniBand transport mode [datagram, " -"connected]." -msgstr "" -"Error: «mode»: «%s» non è una modalità di trasporto InfiniBand valida " -"[datagram, connected]." +msgid "Error: '%s': '%s' is not a valid %s %s." +msgstr "Errore: «%s»: «%s» non è «%s» valido %s." + +#: ../clients/cli/connections.c:2879 +msgid "Wi-Fi mode" +msgstr "Modalità Wi-Fi" + +#: ../clients/cli/connections.c:2888 +msgid "InfiniBand transport mode" +msgstr "Modalità trasporto InfiniBand" -#: ../cli/src/connections.c:2412 +#: ../clients/cli/connections.c:2901 #, c-format msgid "Error: 'flags': '%s' is not valid; use <0-7>." msgstr "Errore: «flags»: «%s» non è valido; usare <0-7>." -#: ../cli/src/connections.c:2434 +#: ../clients/cli/connections.c:2923 #, c-format msgid "Error: '%s': '%s' is not valid; %s " msgstr "Errore: «%s»: «%s» non è valido; %s " -#: ../cli/src/connections.c:2541 +#: ../clients/cli/connections.c:3102 #, c-format msgid "Error: '%s': '%s' is not valid; use <%u-%u>." msgstr "Errore: «%s»: «%s» non è valido; usare <%u-%u>." -#: ../cli/src/connections.c:2555 -msgid "ethernet" -msgstr "ethernet" - -#: ../cli/src/connections.c:2555 ../tui/nm-editor-utils.c:164 -#: ../tui/nm-ui-utils.c:337 -msgid "Wi-Fi" -msgstr "Wi-Fi" +#. Ask for optional arguments. +#: ../clients/cli/connections.c:3158 +#, c-format +msgid "There is %d optional argument for '%s' connection type.\n" +msgid_plural "There are %d optional arguments for '%s' connection type.\n" +msgstr[0] "C'è %d argomento opzionale per il tipo di connessione «%s».\n" +msgstr[1] "Ci sono %d argomenti opzionali per il tipo di connessione «%s».\n" -#. Ask for optional arguments -#: ../cli/src/connections.c:2558 +#: ../clients/cli/connections.c:3161 #, c-format -msgid "There are 3 optional arguments for '%s' connection type.\n" -msgstr "Ci sono 3 argomenti opzionali per il tipo di connessione «%s».\n" +msgid "Do you want to provide it? %s" +msgid_plural "Do you want to provide them? %s" +msgstr[0] "Fornirlo ora?" +msgstr[1] "Fornirli ora? %s" -#: ../cli/src/connections.c:2559 ../cli/src/connections.c:2613 -#: ../cli/src/connections.c:2735 ../cli/src/connections.c:2781 -#: ../cli/src/connections.c:2841 ../cli/src/connections.c:2909 -#: ../cli/src/connections.c:3072 ../cli/src/connections.c:3168 -#: ../cli/src/connections.c:3250 -msgid "Do you want to provide them? (yes/no) [yes] " -msgstr "Fornirli? (sì/no) [sì] " +#. Ask for optional arguments +#: ../clients/cli/connections.c:3178 +msgid "ethernet" +msgstr "ethernet" -#: ../cli/src/connections.c:2567 ../cli/src/connections.c:2621 -#: ../cli/src/connections.c:2748 ../cli/src/connections.c:2849 +#: ../clients/cli/connections.c:3183 ../clients/cli/connections.c:3231 +#: ../clients/cli/connections.c:3365 ../clients/cli/connections.c:3444 msgid "MTU [auto]: " msgstr "MTU [auto]: " -#: ../cli/src/connections.c:2578 ../cli/src/connections.c:2632 -#: ../cli/src/connections.c:2711 ../cli/src/connections.c:2759 +#: ../clients/cli/connections.c:3194 ../clients/cli/connections.c:3242 +#: ../clients/cli/connections.c:3337 ../clients/cli/connections.c:3376 +#: ../clients/cli/connections.c:3748 msgid "MAC [none]: " msgstr "MAC [nessuno]: " -#: ../cli/src/connections.c:2589 +#: ../clients/cli/connections.c:3205 msgid "Cloned MAC [none]: " msgstr "MAC clonato [nessuno]: " -#. Ask for optional arguments -#: ../cli/src/connections.c:2612 +#: ../clients/cli/connections.c:3253 #, c-format -msgid "There are 5 optional arguments for 'InfiniBand' connection type.\n" -msgstr "" -"Ci sono 5 argomenti opzionali per il tipo di connessione «InfiniBand».\n" +msgid "Transport mode %s" +msgstr "Modalità trasporto %s" -#: ../cli/src/connections.c:2643 -msgid "Transport mode (datagram or connected) [datagram]: " -msgstr "Modalità trasporto (datagram o connected) [datagram]: " - -#: ../cli/src/connections.c:2656 +#: ../clients/cli/connections.c:3266 msgid "Parent interface [none]: " msgstr "Interfaccia genitore [nessuna]: " -#: ../cli/src/connections.c:2667 +#: ../clients/cli/connections.c:3277 msgid "P_KEY [none]: " msgstr "P_KEY [nessuno]: " -#: ../cli/src/connections.c:2677 +#: ../clients/cli/connections.c:3287 #, c-format msgid "Error: 'p-key' is mandatory when 'parent' is specified.\n" msgstr "Errore: «p-key» è obbligatorio quanto «parent» è specificato.\n" -#. Ask for optional 'wimax' arguments. -#: ../cli/src/connections.c:2702 +#. Ask for optional arguments +#: ../clients/cli/connections.c:3304 ../clients/tui/nm-editor-utils.c:155 +#: ../libnm-glib/nm-device.c:1791 ../libnm/nm-device.c:1613 +msgid "Wi-Fi" +msgstr "Wi-Fi" + +#: ../clients/cli/connections.c:3312 #, c-format -msgid "There is 1 optional argument for 'WiMax' connection type.\n" -msgstr "C'è un argomento opzionale per il tipo di connessione «WiMax».\n" +msgid "Mode %s" +msgstr "Modalità %s" -#: ../cli/src/connections.c:2703 ../cli/src/connections.c:2805 -#: ../cli/src/connections.c:3024 ../cli/src/connections.c:3226 -msgid "Do you want to provide it? (yes/no) [yes] " -msgstr "Fornirlo? (sì/no) [sì] " +#. Ask for optional 'wimax' arguments. +#: ../clients/cli/connections.c:3332 ../libnm-glib/nm-device.c:1797 +#: ../libnm/nm-device.c:1619 +msgid "WiMAX" +msgstr "WiMAX" #. Ask for optional 'pppoe' arguments. -#: ../cli/src/connections.c:2734 -#, c-format -msgid "There are 4 optional arguments for 'PPPoE' connection type.\n" -msgstr "Ci sono 4 argomenti opzionali per il tipo di connessione «PPPoE».\n" +#: ../clients/cli/connections.c:3355 +msgid "PPPoE" +msgstr "PPPoE" -#: ../cli/src/connections.c:2742 ../cli/src/connections.c:2790 +#: ../clients/cli/connections.c:3359 ../clients/cli/connections.c:3397 msgid "Password [none]: " msgstr "Password [nessuna]: " -#: ../cli/src/connections.c:2744 +#: ../clients/cli/connections.c:3361 msgid "Service [none]: " msgstr "Servizio [nessuno]: " #. Ask for optional 'gsm' or 'cdma' arguments. -#: ../cli/src/connections.c:2780 -#, c-format -msgid "" -"There are 2 optional arguments for 'mobile broadband' connection type.\n" -msgstr "" -"Ci sono 2 argomenti opzionali per il tipo di connessione «mobile " -"broadband».\n" +#: ../clients/cli/connections.c:3391 +msgid "mobile broadband" +msgstr "banda larga mobile" -#: ../cli/src/connections.c:2788 ../cli/src/connections.c:3233 +#: ../clients/cli/connections.c:3395 ../clients/cli/connections.c:3820 msgid "Username [none]: " msgstr "Nome utente [nessuno]: " #. Ask for optional 'bluetooth' arguments. -#: ../cli/src/connections.c:2804 -#, c-format -msgid "There is 1 optional argument for 'bluetooth' connection type.\n" -msgstr "C'è un argomento opzionale per il tipo di connessione «Bluetooth».\n" +#: ../clients/cli/connections.c:3410 +msgid "bluetooth" +msgstr "bluetooth" -#: ../cli/src/connections.c:2813 -msgid "Bluetooth type (panu, dun-gsm or dun-cdma) [panu]: " -msgstr "Tipo di Bluetooth (panu, dun-gsm o dun-cdma) [panu]: " +#: ../clients/cli/connections.c:3417 +#, c-format +msgid "Bluetooth type %s" +msgstr "Bluetooth tipo %s" -#: ../cli/src/connections.c:2821 +#: ../clients/cli/connections.c:3423 #, c-format msgid "Error: 'bt-type': '%s' is not a valid bluetooth type.\n" msgstr "Errore: «bt-type»: «%s» non è una tipologia di Bluetooth valida.\n" #. Ask for optional 'vlan' arguments. -#: ../cli/src/connections.c:2840 -#, c-format -msgid "There are 4 optional arguments for 'VLAN' connection type.\n" -msgstr "Ci sono 4 argomenti opzionali per il tipo di connessione «VLAN».\n" +#. 13 +#: ../clients/cli/connections.c:3439 ../clients/cli/devices.c:233 +#: ../clients/tui/nm-editor-utils.c:218 ../clients/tui/nmt-page-vlan.c:97 +#: ../libnm-core/nm-connection.c:1571 ../libnm-glib/nm-device.c:1809 +#: ../libnm-util/nm-connection.c:1614 ../libnm/nm-device.c:1631 +msgid "VLAN" +msgstr "VLAN" -#: ../cli/src/connections.c:2860 +#: ../clients/cli/connections.c:3455 msgid "VLAN flags (<0-7>) [none]: " msgstr "Flag VLAN (<0-7>) [nessuno]: " -#: ../cli/src/connections.c:2871 +#: ../clients/cli/connections.c:3466 msgid "Ingress priority maps [none]: " msgstr "Mappe priorità ingress [nessuna]: " -#: ../cli/src/connections.c:2882 +#: ../clients/cli/connections.c:3477 msgid "Egress priority maps [none]: " msgstr "Mappe priorità egress [nessuna]: " -#. Ask for optional 'bond' arguments. -#: ../cli/src/connections.c:2908 -#, c-format -msgid "There are optional arguments for 'bond' connection type.\n" -msgstr "Ci sono argomenti opzionali per il tipo di connessione «bond».\n" - -#: ../cli/src/connections.c:2918 +#: ../clients/cli/connections.c:3488 msgid "Bonding mode [balance-rr]: " msgstr "Modalità di aggregazione [balance-rr]: " -#: ../cli/src/connections.c:2934 +#. Ask for optional 'bond' arguments. +#: ../clients/cli/connections.c:3504 +msgid "bond" +msgstr "bond" + +#: ../clients/cli/connections.c:3526 msgid "Bonding primary interface [none]: " msgstr "Interfaccia principale di aggregazione [nessuna]: " -#: ../cli/src/connections.c:2937 +#: ../clients/cli/connections.c:3529 #, c-format msgid "Error: 'primary': '%s' is not a valid interface name.\n" msgstr "Errore: «primary»: «%s» non è un nome d'interfaccia valido.\n" -#: ../cli/src/connections.c:2945 -msgid "Bonding monitoring mode (miimon or arp) [miimon]: " -msgstr "Modalità monitoraggio di aggregazione (miimon o arp) [miimon]: " +#: ../clients/cli/connections.c:3537 +#, c-format +msgid "Bonding monitoring mode %s" +msgstr "Modalità monitoraggio di aggregazione %s" -#: ../cli/src/connections.c:2950 +#: ../clients/cli/connections.c:3543 #, c-format msgid "Error: '%s' is not a valid monitoring mode; use '%s' or '%s'.\n" msgstr "" "Errore: «%s» non è una modalità di monitoraggio valida; usare «%s» o «%s».\n" -#: ../cli/src/connections.c:2959 +#: ../clients/cli/connections.c:3552 msgid "Bonding miimon [100]: " msgstr "Miimon di aggregazione [100]: " -#: ../cli/src/connections.c:2962 +#: ../clients/cli/connections.c:3555 #, c-format msgid "Error: 'miimon': '%s' is not a valid number <0-%u>.\n" msgstr "Errore: «miimon»: «%s» non è un numero valido <0-%u>.\n" -#: ../cli/src/connections.c:2970 +#: ../clients/cli/connections.c:3563 msgid "Bonding downdelay [0]: " msgstr "Downdelay di aggregazione [0]: " -#: ../cli/src/connections.c:2973 +#: ../clients/cli/connections.c:3566 #, c-format msgid "Error: 'downdelay': '%s' is not a valid number <0-%u>.\n" msgstr "Errore: «downdelay»: «%s» non è un numero valido <0-%u>.\n" -#: ../cli/src/connections.c:2981 +#: ../clients/cli/connections.c:3574 msgid "Bonding updelay [0]: " msgstr "Updelay di aggregazione [0]: " -#: ../cli/src/connections.c:2984 +#: ../clients/cli/connections.c:3577 #, c-format msgid "Error: 'updelay': '%s' is not a valid number <0-%u>.\n" msgstr "Errore: «updelay»: «%s» non è un numero valido <0-%u>.\n" -#: ../cli/src/connections.c:2993 +#: ../clients/cli/connections.c:3586 msgid "Bonding arp-interval [0]: " msgstr "Arp-interval di aggregazione [0]: " -#: ../cli/src/connections.c:2996 +#: ../clients/cli/connections.c:3589 #, c-format msgid "Error: 'arp-interval': '%s' is not a valid number <0-%u>.\n" msgstr "Errore: «arp-interval»: «%s» non è un numero valido <0-%u>.\n" #. FIXME: verify the string -#: ../cli/src/connections.c:3004 +#: ../clients/cli/connections.c:3597 msgid "Bonding arp-ip-target [none]: " msgstr "Arp-ip-target di aggregazione [nessuno]: " -#. Ask for optional 'team' arguments. -#: ../cli/src/connections.c:3023 +#: ../clients/cli/connections.c:3604 +msgid "LACP rate ('slow' or 'fast') [slow]: " +msgstr "Velocità LACP («slow» o «fast») [slow]: " + +#: ../clients/cli/connections.c:3610 #, c-format -msgid "There is 1 optional argument for '%s' connection type.\n" -msgstr "C'è un argomento opzionale per il tipo di connessione «%s».\n" +msgid "Error: 'lacp_rate': '%s' is invalid ('slow' or 'fast').\n" +msgstr "Errore: «lacp_rate»: «%s» non è valido («slow» o «fast»).\n" -#: ../cli/src/connections.c:3032 +#: ../clients/cli/connections.c:3633 msgid "Team JSON configuration [none]: " msgstr "Configurazione JSON team [nessuna]: " -#: ../cli/src/connections.c:3051 +#: ../clients/cli/connections.c:3650 msgid "team" msgstr "team" -#: ../cli/src/connections.c:3057 +#: ../clients/cli/connections.c:3656 msgid "team-slave" msgstr "team-slave" #. Ask for optional 'bridge' arguments. -#: ../cli/src/connections.c:3071 -#, c-format -msgid "There are 6 optional arguments for 'bridge' connection type.\n" -msgstr "Ci sono 6 argomenti opzionali per il tipo di connessione «bridge».\n" +#: ../clients/cli/connections.c:3668 +msgid "bridge" +msgstr "bridge" -#: ../cli/src/connections.c:3081 -msgid "Enable STP (yes/no) [yes]: " -msgstr "Abilitare STP (sì/no) [sì]: " +#: ../clients/cli/connections.c:3674 +#, c-format +msgid "Enable STP %s" +msgstr "Abilitare STP %s" -#: ../cli/src/connections.c:3085 +#: ../clients/cli/connections.c:3679 #, c-format -msgid "Error: 'stp': '%s'.\n" -msgstr "Errore: «stp»: «%s».\n" +msgid "Error: 'stp': %s.\n" +msgstr "Errore: «stp»: %s.\n" -#: ../cli/src/connections.c:3093 -msgid "STP priority [128]: " -msgstr "Priorità STP [128]: " +#: ../clients/cli/connections.c:3687 +msgid "STP priority [32768]: " +msgstr "Priorità STP [32768]: " -#: ../cli/src/connections.c:3097 +#: ../clients/cli/connections.c:3691 #, c-format msgid "Error: 'priority': '%s' is not a valid number <0-%d>.\n" msgstr "Errore: «priority»: «%s» non è un numero valido <0-%d>.\n" -#: ../cli/src/connections.c:3105 +#: ../clients/cli/connections.c:3699 msgid "Forward delay [15]: " msgstr "Forward delay [15]: " -#: ../cli/src/connections.c:3109 +#: ../clients/cli/connections.c:3703 #, c-format msgid "Error: 'forward-delay': '%s' is not a valid number <2-30>.\n" msgstr "Errore: «forward-dealy»: «%s» non è un numero valido <2-30>.\n" -#: ../cli/src/connections.c:3118 +#: ../clients/cli/connections.c:3712 msgid "Hello time [2]: " msgstr "Hello time [2]: " -#: ../cli/src/connections.c:3122 +#: ../clients/cli/connections.c:3716 #, c-format msgid "Error: 'hello-time': '%s' is not a valid number <1-10>.\n" msgstr "Errore: «hello-time»: «%s» non è un numero valido <1-10>.\n" -#: ../cli/src/connections.c:3130 +#: ../clients/cli/connections.c:3724 msgid "Max age [20]: " msgstr "Età massima [20]: " -#: ../cli/src/connections.c:3134 +#: ../clients/cli/connections.c:3728 #, c-format msgid "Error: 'max-age': '%s' is not a valid number <6-40>.\n" msgstr "Errore: «max-age»: «%s» non è un numero valido <6-40>.\n" -#: ../cli/src/connections.c:3142 +#: ../clients/cli/connections.c:3736 msgid "MAC address ageing time [300]: " msgstr "Tempo invecchiamento indirizzo MAC [300]: " -#: ../cli/src/connections.c:3146 +#: ../clients/cli/connections.c:3740 #, c-format msgid "Error: 'ageing-time': '%s' is not a valid number <0-1000000>.\n" msgstr "Errore: «ageing-time»: «%s» non è un numero valido <0-1000000>.\n" #. Ask for optional 'bridge-slave' arguments. -#: ../cli/src/connections.c:3167 -#, c-format -msgid "There are 3 optional arguments for 'bridge-slave' connection type.\n" -msgstr "" -"Ci sono 3 argomenti opzionali per il tipo di connessione «bridge-slave».\n" +#: ../clients/cli/connections.c:3767 +msgid "bridge-slave" +msgstr "bridge-slave" -#: ../cli/src/connections.c:3176 +#: ../clients/cli/connections.c:3772 msgid "Bridge port priority [32]: " msgstr "Priorità porta bridge [32]: " -#: ../cli/src/connections.c:3189 +#: ../clients/cli/connections.c:3785 msgid "Bridge port STP path cost [100]: " msgstr "Costo percorso STP porta bridge [100]: " -#: ../cli/src/connections.c:3203 -msgid "Hairpin (yes/no) [yes]: " -msgstr "Hairpin (sì/no) [sì]: " - -#: ../cli/src/connections.c:3207 +#: ../clients/cli/connections.c:3799 #, c-format -msgid "Error: 'hairpin': '%s'.\n" -msgstr "Errore: «hairpin»: «%s».\n" +msgid "Hairpin %s" +msgstr "Hairpin %s" -#. Ask for optional 'vpn' arguments. -#: ../cli/src/connections.c:3225 +#: ../clients/cli/connections.c:3804 #, c-format -msgid "There is 1 optional argument for 'VPN' connection type.\n" -msgstr "C'è un argomento opzionale per il tipo di connessione «VPN».\n" +msgid "Error: 'hairpin': %s.\n" +msgstr "Errore: «hairpin»: «%s».\n" #. Ask for optional 'olpc' arguments. -#: ../cli/src/connections.c:3249 -#, c-format -msgid "There are 2 optional arguments for 'OLPC Mesh' connection type.\n" -msgstr "" -"Ci sono 2 argomenti opzionali per il tipo di connessione «Mesh OLPC».\n" +#: ../clients/cli/connections.c:3831 ../libnm-glib/nm-device.c:1795 +#: ../libnm/nm-device.c:1617 +msgid "OLPC Mesh" +msgstr "Mesh OLPC" -#: ../cli/src/connections.c:3258 +#: ../clients/cli/connections.c:3836 msgid "OLPC Mesh channel [1]: " msgstr "Canale mesh OLPC [1]: " -#: ../cli/src/connections.c:3261 +#: ../clients/cli/connections.c:3839 #, c-format msgid "Error: 'channel': '%s' is not a valid number <1-13>.\n" msgstr "Errore: «channel»: «%s» non è un numero valido <1-13>.\n" -#: ../cli/src/connections.c:3269 +#: ../clients/cli/connections.c:3847 msgid "DHCP anycast MAC address [none]: " msgstr "Indirizzo MAC DHCP anycast [nessuno]: " -#: ../cli/src/connections.c:3317 -msgid "IPv4 address (IP[/plen] [gateway]) [none]: " -msgstr "Indirizzo IPv4 (IP[/plen] [gateway]) [nessuno]: " +#: ../clients/cli/connections.c:3889 +msgid "IPv4 address (IP[/plen]) [none]: " +msgstr "Indirizzo IPv4 (IP[/plen]) [nessuno]: " -#: ../cli/src/connections.c:3319 -msgid "IPv6 address (IP[/plen] [gateway]) [none]: " -msgstr "Indirizzo IPv6 (IP[/plen] [gateway]) [nessuno]: " +#: ../clients/cli/connections.c:3891 +msgid "IPv6 address (IP[/plen]) [none]: " +msgstr "Indirizzo IPv6 (IP[/plen]) [nessuno]: " -#: ../cli/src/connections.c:3337 +#: ../clients/cli/connections.c:3905 #, c-format -msgid " Address successfully added: %s %s\n" -msgstr " Indirizzo aggiunto con successo: %s %s\n" +msgid " Address successfully added: %s\n" +msgstr " Indirizzo aggiunto con successo: %s\n" -#: ../cli/src/connections.c:3339 +#: ../clients/cli/connections.c:3907 #, c-format -msgid " Warning: address already present: %s %s\n" -msgstr " Attenzione: indirizzo già presente: %s %s\n" +msgid " Warning: address already present: %s\n" +msgstr " Attenzione: indirizzo già presente: %s\n" -#: ../cli/src/connections.c:3341 +#: ../clients/cli/connections.c:3909 #, c-format msgid " Warning: ignoring garbage at the end: '%s'\n" msgstr " Attenzione: ignorati i dati non necessari alla fine: «%s»\n" -#: ../cli/src/connections.c:3343 ../cli/src/connections.c:4192 -#: ../cli/src/connections.c:4247 ../cli/src/connections.c:4646 -#: ../cli/src/connections.c:4656 +#: ../clients/cli/connections.c:3911 ../clients/cli/connections.c:4791 +#: ../clients/cli/connections.c:4852 ../clients/cli/connections.c:5253 +#: ../clients/cli/connections.c:5286 msgid "Error: " msgstr "Errore: " +#: ../clients/cli/connections.c:3931 +msgid "IPv4 gateway [none]: " +msgstr "Gateway IPv4 [nessuno]: " + +#: ../clients/cli/connections.c:3934 +msgid "IPv6 gateway [none]: " +msgstr "Gateway IPv6 [nessuno]: " + +#: ../clients/cli/connections.c:3954 +#, c-format +msgid "Error: invalid gateway address '%s'\n" +msgstr "Errore: indirizzo gateway «%s» non valido\n" + #. Ask for IP addresses -#: ../cli/src/connections.c:3361 -msgid "Do you want to add IP addresses? (yes/no) [yes] " -msgstr "Aggiungere indirizzi IP? (sì/no) [sì]" +#: ../clients/cli/connections.c:3967 +#, c-format +msgid "Do you want to add IP addresses? %s" +msgstr "Aggiungere indirizzi IP? %s" -#: ../cli/src/connections.c:3367 +#: ../clients/cli/connections.c:3975 #, c-format msgid "Press to finish adding addresses.\n" msgstr "Premere Invio per terminare l'immissione di indirizzi.\n" -#: ../cli/src/connections.c:3513 +#: ../clients/cli/connections.c:4113 #, c-format msgid "Error: 'parent': not valid without 'p-key'." msgstr "Errore: «parent»: non valido senza «p-key»." -#: ../cli/src/connections.c:3569 ../cli/src/connections.c:4562 +#: ../clients/cli/connections.c:4168 ../clients/cli/connections.c:5173 msgid "SSID: " msgstr "SSID: " -#: ../cli/src/connections.c:3572 ../cli/src/connections.c:4565 +#: ../clients/cli/connections.c:4171 ../clients/cli/connections.c:5176 msgid "Error: 'ssid' is required." msgstr "Errore: è richiesto «ssid»." -#: ../cli/src/connections.c:3636 +#: ../clients/cli/connections.c:4235 msgid "WiMAX NSP name: " msgstr "Nome NSP WiMAX: " -#: ../cli/src/connections.c:3639 +#: ../clients/cli/connections.c:4238 msgid "Error: 'nsp' is required." msgstr "Errore: è richiesto «nsp»." -#: ../cli/src/connections.c:3694 +#: ../clients/cli/connections.c:4290 msgid "PPPoE username: " msgstr "Nome utente PPPoE:" -#: ../cli/src/connections.c:3697 +#: ../clients/cli/connections.c:4293 msgid "Error: 'username' is required." msgstr "Errore: è richiesto «username»." -#: ../cli/src/connections.c:3768 +#: ../clients/cli/connections.c:4362 msgid "APN: " msgstr "APN: " -#: ../cli/src/connections.c:3771 +#: ../clients/cli/connections.c:4365 msgid "Error: 'apn' is required." msgstr "Errore: è richiesto «apn»." -#: ../cli/src/connections.c:3830 +#: ../clients/cli/connections.c:4423 msgid "Bluetooth device address: " msgstr "Indirizzo dispositivo Bluetooth: " -#: ../cli/src/connections.c:3833 +#: ../clients/cli/connections.c:4426 msgid "Error: 'addr' is required." msgstr "Errore: è richiesto «addr»." -#: ../cli/src/connections.c:3876 +#: ../clients/cli/connections.c:4467 #, c-format msgid "Error: 'bt-type': '%s' not valid; use [%s, %s (%s), %s]." msgstr "Errore: «bt-type»: «%s» non valido; usare [%s, %s (%s), %s]." -#: ../cli/src/connections.c:3921 +#: ../clients/cli/connections.c:4511 msgid "VLAN parent device or connection UUID: " msgstr "Dispositivo genitore VLAN o UUID di connessione:" -#: ../cli/src/connections.c:3924 +#: ../clients/cli/connections.c:4514 msgid "Error: 'dev' is required." msgstr "Errore: è richiesto «dev»." -#: ../cli/src/connections.c:3928 +#: ../clients/cli/connections.c:4518 msgid "VLAN ID <0-4095>: " msgstr "ID VLAN <0-4095>: " -#: ../cli/src/connections.c:3931 +#: ../clients/cli/connections.c:4521 msgid "Error: 'id' is required." msgstr "Errore: è richiesto «id»." -#: ../cli/src/connections.c:3937 +#: ../clients/cli/connections.c:4527 #, c-format msgid "Error: 'id': '%s' is not valid; use <0-4095>." msgstr "Errore: «id»: «%s» non è valido; usare <0-4095>." -#: ../cli/src/connections.c:3947 +#: ../clients/cli/connections.c:4537 #, c-format msgid "Error: 'dev': '%s' is neither UUID, interface name, nor MAC." msgstr "" "Errore: «dev»: «%s» non è né uno UUID né il nome di un'interfaccia né un MAC." -#: ../cli/src/connections.c:4082 +#: ../clients/cli/connections.c:4671 #, c-format msgid "Error: 'mode': %s." msgstr "Errore: «mode»: %s" -#: ../cli/src/connections.c:4091 +#: ../clients/cli/connections.c:4680 #, c-format msgid "Error: 'primary': '%s' is not a valid interface name." msgstr "Errore: «primary»: «%s» non è un nome valido di interfaccia." -#: ../cli/src/connections.c:4134 -msgid "Bond master: " -msgstr "Bond master: " - -#: ../cli/src/connections.c:4137 ../cli/src/connections.c:4229 -#: ../cli/src/connections.c:4416 +#: ../clients/cli/connections.c:4732 ../clients/cli/connections.c:4830 +#: ../clients/cli/connections.c:5032 msgid "Error: 'master' is required." msgstr "Errore: è richiesto «master»." -#: ../cli/src/connections.c:4142 ../cli/src/connections.c:4239 -#: ../cli/src/connections.c:4427 +#: ../clients/cli/connections.c:4738 ../clients/cli/connections.c:4836 +#: ../clients/cli/connections.c:5038 +#, c-format +msgid "Warning: master='%s' doesn't refer to any existing profile.\n" +msgstr "Attenzione: master=«%s» non si riferisce ad alcun profilo esistente.\n" + +#: ../clients/cli/connections.c:4741 ../clients/cli/connections.c:4844 +#: ../clients/cli/connections.c:5041 #, c-format msgid "" "Warning: 'type' is currently ignored. We only support ethernet slaves for " @@ -1895,96 +2153,110 @@ msgstr "" "Attenzione: «type» è attualmente ignorato. Al momento sono supportati " "solamente slave Ethernet.\n" -#: ../cli/src/connections.c:4226 -msgid "Team master: " -msgstr "Team master: " - -#: ../cli/src/connections.c:4329 +#: ../clients/cli/connections.c:4938 #, c-format msgid "Error: 'stp': %s." msgstr "Errore: «stp»: %s." -#: ../cli/src/connections.c:4413 -msgid "Bridge master: " -msgstr "Bridge master: " - -#: ../cli/src/connections.c:4421 -#, c-format -msgid "Error: 'master': '%s' is not valid UUID nor interface." -msgstr "Errore: «master»: «%s» non è né un UUID né un'interfaccia valido" - -#: ../cli/src/connections.c:4454 +#: ../clients/cli/connections.c:5068 #, c-format msgid "Error: 'hairpin': %s." msgstr "Errore: «hairpin»: %s." -#: ../cli/src/connections.c:4506 -msgid "VPN type: " -msgstr "Tipo di VPN: " - -#: ../cli/src/connections.c:4509 +#: ../clients/cli/connections.c:5121 msgid "Error: 'vpn-type' is required." msgstr "Errore: è richiesto «vpn-type»." -#: ../cli/src/connections.c:4520 +#: ../clients/cli/connections.c:5128 #, c-format -msgid "Error: 'vpn-type': %s." -msgstr "Errore: «vpn-type»: %s." +msgid "Warning: 'vpn-type': %s not known.\n" +msgstr "Attenzione: «vpn-type»: %s sconosciuto.\n" -#: ../cli/src/connections.c:4578 +#: ../clients/cli/connections.c:5189 #, c-format msgid "Error: 'channel': '%s' is not valid; use <1-13>." msgstr "Errore: «channel»: «%s» non è valido; usare <1-13>." -#: ../cli/src/connections.c:4613 +#: ../clients/cli/connections.c:5221 #, c-format msgid "Error: '%s' is not a valid connection type." msgstr "Errore: «%s» non è tipo di connessione valido." -#: ../cli/src/connections.c:4711 +#: ../clients/cli/connections.c:5265 +#, c-format +msgid "Error: IPv4 gateway specified without IPv4 addresses" +msgstr "Errore: gateway IPv4 specificato senza indirizzo IPv4" + +#: ../clients/cli/connections.c:5269 +#, c-format +msgid "Error: multiple IPv4 gateways specified" +msgstr "Errore: molteplici gateway IPv4 specificati" + +#: ../clients/cli/connections.c:5273 +#, c-format +msgid "Error: Invalid IPv4 gateway '%s'" +msgstr "Errore: gateway IPv4 «%s» non valido" + +#: ../clients/cli/connections.c:5298 +#, c-format +msgid "Error: IPv6 gateway specified without IPv6 addresses" +msgstr "Errore: gateway IPv6 specificato senza indirizzo IPv6" + +#: ../clients/cli/connections.c:5302 +#, c-format +msgid "Error: multiple IPv6 gateways specified" +msgstr "Errore: molteplici gateway IPv6 specificati" + +#: ../clients/cli/connections.c:5306 +#, c-format +msgid "Error: Invalid IPv6 gateway '%s'" +msgstr "Errore: gateway IPv6 «%s» non valido" + +#: ../clients/cli/connections.c:5366 #, c-format -msgid "Error: Failed to add '%s' connection: (%d) %s" -msgstr "Errore: aggiunta della connessione «%s» non riuscita: (%d) %s" +msgid "Error: Failed to add '%s' connection: %s" +msgstr "Errore: aggiunta della connessione «%s» non riuscita: %s" -#: ../cli/src/connections.c:4715 +#: ../clients/cli/connections.c:5371 #, c-format msgid "Connection '%s' (%s) successfully added.\n" msgstr "Connessione «%s» (%s) aggiunta con successo.\n" -#: ../cli/src/connections.c:4761 -msgid "Connection type: " -msgstr "Tipo di connessione:" - -#: ../cli/src/connections.c:4765 +#: ../clients/cli/connections.c:5591 #, c-format msgid "Error: 'type' argument is required." msgstr "Errore: è richiesto l'argomento «type»." -#: ../cli/src/connections.c:4771 +#: ../clients/cli/connections.c:5599 #, c-format msgid "Error: invalid connection type; %s." msgstr "Errore: tipo di connessione non valido; %s." -#: ../cli/src/connections.c:4780 +#: ../clients/cli/connections.c:5608 #, c-format msgid "Error: 'autoconnect': %s." msgstr "Errore: «autoconnect»: %s." -#: ../cli/src/connections.c:4796 +#: ../clients/cli/connections.c:5618 +#, c-format +msgid "Error: 'save': %s." +msgstr "Errore: «save»: %s." + +#: ../clients/cli/connections.c:5634 msgid "Interface name [*]: " msgstr "Nome interfaccia [*]: " -#: ../cli/src/connections.c:4801 +#: ../clients/cli/connections.c:5639 #, c-format msgid "Error: 'ifname' argument is required." msgstr "Errore: è richiesto l'argomento «ifname»." -#: ../cli/src/connections.c:4808 +#: ../clients/cli/connections.c:5646 #, c-format msgid "Error: 'ifname': '%s' is not a valid interface nor '*'." msgstr "Errore: «ifname»: «%s» e «*» non sono interfacce valide." -#: ../cli/src/connections.c:5627 +#: ../clients/cli/connections.c:6422 #, c-format msgid "['%s' setting values]\n" msgstr "[impostazione valori di «%s»]\n" @@ -1992,7 +2264,7 @@ msgstr "[impostazione valori di «%s»]\n" #. TRANSLATORS: do not translate command names and keywords before :: #. * However, you should translate terms enclosed in <>. #. -#: ../cli/src/connections.c:5708 +#: ../clients/cli/connections.c:6504 #, c-format msgid "" "---[ Main menu ]---\n" @@ -2001,9 +2273,9 @@ msgid "" "value\n" "set [. ] :: set property value\n" "describe [.] :: describe property\n" -"print [all] :: print the connection\n" -"verify [all] :: verify the connection\n" -"save :: save the connection\n" +"print [all | [.]] :: print the connection\n" +"verify [all | fix] :: verify the connection\n" +"save [persistent|temporary] :: save the connection\n" "activate [] [/|] :: activate the connection\n" "back :: go one level up (back)\n" "help/? [] :: print this help\n" @@ -2019,9 +2291,10 @@ msgstr "" "set [. ] :: Imposta il valore della " "proprietà\n" "describe [.] :: Descrive la proprietà\n" -"print [all] :: Stampa la connessione\n" -"verify [all] :: Verifica la connessione\n" -"save :: Salva la connessione\n" +"print [all | [.]\n" +" :: Stampa la connessione\n" +"verify [all | fix] :: Verifica la connessione\n" +"save [persistent|temporary] :: Salva la connessione\n" "activate [] [/|] :: Attiva la connessione\n" "back :: Va al livello superiore " "(indietro)\n" @@ -2029,7 +2302,7 @@ msgstr "" "mmcli :: Configurazione di nmcli\n" "quit :: Esce da nmcli\n" -#: ../cli/src/connections.c:5735 +#: ../clients/cli/connections.c:6531 #, c-format msgid "" "goto [.] | :: enter setting/property for editing\n" @@ -2049,7 +2322,7 @@ msgstr "" " nmcli connection> goto secondaries\n" " nmcli> goto ipv4.addresses\n" -#: ../cli/src/connections.c:5742 +#: ../clients/cli/connections.c:6538 #, c-format msgid "" "remove [.] :: remove setting or reset property value\n" @@ -2070,7 +2343,7 @@ msgstr "" "Esempi: nmcli> remove wifi-sec\n" " nmcli> remove eth.mtu\n" -#: ../cli/src/connections.c:5749 +#: ../clients/cli/connections.c:6545 #, c-format msgid "" "set [. ] :: set property value\n" @@ -2085,7 +2358,7 @@ msgstr "" "\n" "Esempio: nmcli> set con.id La mia connessione\n" -#: ../cli/src/connections.c:5754 +#: ../clients/cli/connections.c:6550 #, c-format msgid "" "describe [.] :: describe property\n" @@ -2100,7 +2373,7 @@ msgstr "" "impostazioni e proprietà di NM, consultare la pagina di manuale nm-" "settings(5).\n" -#: ../cli/src/connections.c:5759 +#: ../clients/cli/connections.c:6555 #, c-format msgid "" "print [all] :: print setting or connection values\n" @@ -2115,37 +2388,62 @@ msgstr "" "\n" "Esempio: nmcli ipv4> print all\n" -#: ../cli/src/connections.c:5764 +#: ../clients/cli/connections.c:6560 #, c-format msgid "" -"verify [all] :: verify setting or connection validity\n" +"verify [all | fix] :: verify setting or connection validity\n" "\n" -"Verifies whether the setting or connection is valid and can be saved later. " -"It indicates invalid values on error.\n" +"Verifies whether the setting or connection is valid and can be saved later.\n" +"It indicates invalid values on error. Some errors may be fixed " +"automatically\n" +"by 'fix' option.\n" "\n" "Examples: nmcli> verify\n" +" nmcli> verify fix\n" " nmcli bond> verify\n" msgstr "" -"verify [all] :: Verifica la validità dell'impostazione o della connessione\n" +"verify [all | fix] :: Verifica la validità dell'impostazione o della " +"connessione\n" "\n" "Verifica se l'impostazione o la connessione è valida e può essere salvata.\n" -"Indica i valori non validi in caso di errore.\n" +"Indica i valori non validi in caso di errore; alcuni errori possono essere\n" +"corretti automaticamente\n" "\n" "Esempi: nmcli> verify\n" +" nmcli> verify fix\n" " nmcli bond> verify\n" -#: ../cli/src/connections.c:5771 +#: ../clients/cli/connections.c:6569 #, c-format msgid "" -"save :: save the connection\n" -"\n" -"Sends the connection to NetworkManager that will save it.\n" -msgstr "" -"save :: Salva la connessione\n" -"\n" -"Invia la connessione a NetworkManager per salvarla.\n" - -#: ../cli/src/connections.c:5775 +"save [persistent|temporary] :: save the connection\n" +"\n" +"Sends the connection profile to NetworkManager that either will save it\n" +"persistently, or will only keep it in memory. 'save' without an argument\n" +"means 'save persistent'.\n" +"Note that once you save the profile persistently those settings are saved\n" +"across reboot or restart. Subsequent changes can also be temporary or\n" +"persistent, but any temporary changes will not persist across reboot or\n" +"restart. If you want to fully remove the persistent connection, the " +"connection\n" +"profile must be deleted.\n" +msgstr "" +"save [persistent|temporary] :: Salva la connessione\n" +"\n" +"Invia il profilo della connessione a NetworkManager per salvarla in modo\n" +"permanente o per tenerla in memoria. «save» senza alcun argomento indica\n" +"«save persistent».\n" +"Una volta salvato permanentemente il profilo, le impostazioni vengono " +"mantenute\n" +"ai successivi riavvii. Ulteriori modifiche possono essere anch'esse " +"temporanee\n" +"o permanenti, ma tutte quelle temporanee non verrano mantenute tra i " +"riavvii.\n" +"Per rimuovere completamente la connessione permanente, è necessario " +"eliminare\n" +"definitivamente il profilo.\n" + +#: ../clients/cli/connections.c:6580 #, c-format msgid "" "activate [] [/|] :: activate the connection\n" @@ -2166,7 +2464,7 @@ msgstr "" "/| - AP (Wi-Fi) o NSP (WiMAX) (iniziare con / quando " " non è specificato)\n" -#: ../cli/src/connections.c:5782 ../cli/src/connections.c:5932 +#: ../clients/cli/connections.c:6587 ../clients/cli/connections.c:6745 #, c-format msgid "" "back :: go to upper menu level\n" @@ -2175,7 +2473,7 @@ msgstr "" "back :: Va al livello superiore del menù\n" "\n" -#: ../cli/src/connections.c:5785 +#: ../clients/cli/connections.c:6590 #, c-format msgid "" "help/? [] :: help for the nmcli commands\n" @@ -2184,7 +2482,7 @@ msgstr "" "help/? [] :: Aiuto per i comandi nmcli\n" "\n" -#: ../cli/src/connections.c:5788 +#: ../clients/cli/connections.c:6593 #, c-format msgid "" "nmcli [ ] :: nmcli configuration\n" @@ -2192,6 +2490,7 @@ msgid "" "Configures nmcli. The following options are available:\n" "status-line yes | no [default: no]\n" "save-confirmation yes | no [default: yes]\n" +"show-secrets yes | no [default: no]\n" "prompt-color <0-8> [default: 0]\n" " 0 = normal\n" " 1 = black\n" @@ -2209,25 +2508,26 @@ msgid "" msgstr "" "nmcli [ ] :: Configurazione di nmcli\n" "\n" -"Configure nmcli. Sono disponibile le seguenti opzioni:\n" +"Configura nmcli. Sono disponibili le seguenti opzioni:\n" "status-line yes | no [predefinito: no]\n" "save-confirmation yes | no [predefinito: yes]\n" +"show-secrets yes | no [predefinito: no]\n" "prompt-color <0-8> [predefinito: 0]\n" -" 0 = normale\n" -" 1 = nero\n" -" 2 = rosso\n" -" 3 = verde\n" -" 4 = giallo\n" -" 5 = blu\n" +" 0 = normal\n" +" 1 = black\n" +" 2 = red\n" +" 3 = green\n" +" 4 = yellow\n" +" 5 = blue\n" " 6 = magenta\n" -" 7 = ciano\n" -" 8 = wbianco\n" +" 7 = cyan\n" +" 8 = white\n" "\n" "Esempi: nmcli> nmcli status-line yes\n" " nmcli> nmcli save-confirmation no\n" " nmcli> nmcli prompt-color 3\n" -#: ../cli/src/connections.c:5808 ../cli/src/connections.c:5938 +#: ../clients/cli/connections.c:6614 ../clients/cli/connections.c:6751 #, c-format msgid "" "quit :: exit nmcli\n" @@ -2241,8 +2541,8 @@ msgstr "" "salvata,\n" "viene richiesto di confermare l'azione.\n" -#: ../cli/src/connections.c:5813 ../cli/src/connections.c:5943 -#: ../cli/src/connections.c:6285 ../cli/src/connections.c:7106 +#: ../clients/cli/connections.c:6619 ../clients/cli/connections.c:6756 +#: ../clients/cli/connections.c:7167 ../clients/cli/connections.c:8083 #, c-format msgid "Unknown command: '%s'\n" msgstr "Comando sconosciuto «%s»\n" @@ -2250,7 +2550,7 @@ msgstr "Comando sconosciuto «%s»\n" #. TRANSLATORS: do not translate command names and keywords before :: #. * However, you should translate terms enclosed in <>. #. -#: ../cli/src/connections.c:5879 +#: ../clients/cli/connections.c:6685 #, c-format msgid "" "---[ Property menu ]---\n" @@ -2280,7 +2580,7 @@ msgstr "" " comando\n" "quit :: Esce da nmcli\n" -#: ../cli/src/connections.c:5904 +#: ../clients/cli/connections.c:6710 #, c-format msgid "" "set [] :: set new value\n" @@ -2291,23 +2591,22 @@ msgstr "" "\n" "Questo comando imposta il fornito a questa proprietà.\n" -#: ../cli/src/connections.c:5908 +#: ../clients/cli/connections.c:6714 #, c-format msgid "" -"add [] :: add new option to the property\n" +"add [] :: append new value to the property\n" "\n" -"This command add provided to this property, if the property is of a " -"container type. For single-valued properties it replaces the value (same as " -"'set').\n" +"This command adds provided to this property, if the property is of a " +"container type. For single-valued properties the property value is replaced " +"(same as 'set').\n" msgstr "" -"add [] :: Aggiunge una nuova opzione alla proprietà\n" +"add [] :: Aggiunge un nuovo valore alla proprietà\n" "\n" -"Questo comando aggiunge il fornito a questa proprietà, se essa è " -"di\n" -"tipo contenitore. Per proprietà a valore singolo rimpiazza il valore\n" -"(come il comando «set»).\n" +"Questo comando aggiunge il fornito a questa proprietà, se essa è di " +"tipo contenitore. Per proprietà a valore singolo rimpiazza il valore (come " +"il comando «set»).\n" -#: ../cli/src/connections.c:5914 +#: ../clients/cli/connections.c:6720 #, c-format msgid "" "change :: change current value\n" @@ -2318,18 +2617,43 @@ msgstr "" "\n" "Visualizza il valore attuale e consente di modificarlo.\n" -#: ../cli/src/connections.c:5918 +#: ../clients/cli/connections.c:6724 #, c-format msgid "" -"remove [|