From 81836c2d44802b4cca833d7775dd627e0797a7e2 Mon Sep 17 00:00:00 2001 From: Michael Biebl Date: Fri, 28 Aug 2015 01:13:48 +0200 Subject: Imported Upstream version 1.0.6 --- docs/api/html/index.html | 2 +- docs/api/html/ref-settings.html | 18 +++ docs/api/html/spec.html | 41 ++++- docs/api/settings-spec.xml | 3 + docs/api/spec.html | 41 ++++- docs/api/version.xml | 2 +- docs/libnm-glib/html/NMAccessPoint.html | 76 ++++++++- docs/libnm-glib/html/NMActiveConnection.html | 8 +- docs/libnm-glib/html/NMSecretAgent.html | 2 +- docs/libnm-glib/html/api-index-full.html | 12 ++ docs/libnm-glib/html/index.html | 2 +- docs/libnm-glib/html/index.sgml | 3 + docs/libnm-glib/html/libnm-glib.devhelp2 | 3 + docs/libnm-glib/libnm-glib-sections.txt | 2 + docs/libnm-glib/version.xml | 2 +- docs/libnm-util/html/index.html | 2 +- docs/libnm-util/version.xml | 2 +- docs/libnm/Makefile.am | 3 +- docs/libnm/Makefile.in | 3 +- docs/libnm/html/NMAccessPoint.html | 72 ++++++++- docs/libnm/html/NMClient.html | 30 +++- docs/libnm/html/NMDevice.html | 99 +++++++++--- docs/libnm/html/NMDeviceWifi.html | 141 ++++++++++++++++- docs/libnm/html/NMSettingConnection.html | 60 +++++++- docs/libnm/html/NMSettingWired.html | 221 ++++++++++++++++++++++++++- docs/libnm/html/api-index-full.html | 127 +++++++++++++++ docs/libnm/html/index.html | 2 +- docs/libnm/html/index.sgml | 45 +++++- docs/libnm/html/libnm-nm-dbus-interface.html | 64 +++++++- docs/libnm/html/libnm-nm-utils.html | 208 +++++++++++++++++++++---- docs/libnm/html/libnm-nm-version.html | 48 ++++-- docs/libnm/html/libnm.devhelp2 | 45 +++++- docs/libnm/html/object-tree.html | 2 + docs/libnm/libnm-sections.txt | 35 ++++- docs/libnm/libnm.types | 2 + docs/libnm/version.xml | 2 +- 36 files changed, 1322 insertions(+), 108 deletions(-) (limited to 'docs') diff --git a/docs/api/html/index.html b/docs/api/html/index.html index c2c59933..5656932f 100644 --- a/docs/api/html/index.html +++ b/docs/api/html/index.html @@ -14,7 +14,7 @@
-

Version 1.0.4 +

Version 1.0.6

diff --git a/docs/api/html/ref-settings.html b/docs/api/html/ref-settings.html index 10405a35..501656bc 100644 --- a/docs/api/html/ref-settings.html +++ b/docs/api/html/ref-settings.html @@ -625,6 +625,12 @@ Interface name of the master device or UUID of the master connection. +
metered
+
NMMetered (int32)
+

+Whether the connection is metered.
+
+
 
name
string
connection
@@ -1800,6 +1806,18 @@
0
If non-zero, request that the device use only the specified speed. In Mbit/s, ie 100 == 100Mbit/s. + +
wake-on-lan
+
uint32
+
1
+The NMSettingWiredWakeOnLan options to enable. Not all devices support all options. May be any combination of NM_SETTING_WIRED_WAKE_ON_LAN_PHY (0x2), NM_SETTING_WIRED_WAKE_ON_LAN_UNICAST (0x4), NM_SETTING_WIRED_WAKE_ON_LAN_MULTICAST (0x8), NM_SETTING_WIRED_WAKE_ON_LAN_BROADCAST (0x10), NM_SETTING_WIRED_WAKE_ON_LAN_ARP (0x20), NM_SETTING_WIRED_WAKE_ON_LAN_MAGIC (0x40). + + +
wake-on-lan-password
+
string
+

+If specified, the password used with magic-packet-based Wake-on-LAN, represented as an Ethernet MAC address.  If NULL, no password will be required.
+
 
 
diff --git a/docs/api/html/spec.html b/docs/api/html/spec.html index bcd634dd..7f7559c5 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.4

NetworkManager D-Bus Interface Specification

Version 1.0.4

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

NetworkManager D-Bus Interface Specification

Version 1.0.6

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 @@ -381,6 +381,14 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.

Metered - + u - + (read) + (NM_METERED) +
+ Wheter the connectivity is metered. This is equivalent to the + metered property of the device associated with the primary + connection.
ActivatingConnection - o - (read)
@@ -478,7 +486,13 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.u - (read)
The maximum bitrate this access point is capable of, in kilobits/second (Kb/s).
Strength - y - - (read)
The current signal quality of the access point, in percent.

Sets of flags:

NM_802_11_AP_FLAGS

+ (read)
The current signal quality of the access point, in percent.
LastSeen - + i - + (read)
+ The timestamp (in CLOCK_BOOTTIME seconds) for the last time the access + point was found in scan results. A value of -1 means the access point + has never been found in scan results. +

Sets of flags:

NM_802_11_AP_FLAGS

Flags describing the general capabilities of the access point.
NM_802_11_AP_FLAGS_NONE = 0x0
Null capability - says nothing about the access point.
NM_802_11_AP_FLAGS_PRIVACY = 0x1
Access point supports privacy measures.

NM_802_11_AP_SEC

Flags describing the security capabilities of the access point. @@ -635,6 +649,13 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.u - (read)
The device MTU (maximum transmission unit). +
Metered - + u - + (read) + (NM_METERED) +
+ Whether the amount of traffic flowing through the device is + subject to limitations, for example set by service providers.

Enumerated types:

NM_DEVICE_STATE

NM_DEVICE_STATE_UNKNOWN = 0
The device is in an unknown state.
NM_DEVICE_STATE_UNMANAGED = 10
@@ -817,6 +838,16 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
NM_DEVICE_STATE_REASON_PARENT_MANAGED_CHANGED = 62
The device parent's management changed. +

NM_METERED

NM_METERED_UNKNOWN = 0
+ The device metered status is unknown. +
NM_METERED_YES = 1
+ The device is metered and the value was statically set. +
NM_METERED_NO = 2
+ The device is not metered and the value was statically set. +
NM_METERED_GUESS_YES = 3
+ The device is metered and the value was guessed. +
NM_METERED_GUESS_NO = 4
+ The device is not metered and the value was guessed.

Sets of flags:

NM_DEVICE_CAP

NM_DEVICE_CAP_NONE = 0x0
Null capability.
NM_DEVICE_CAP_NM_SUPPORTED = 0x1
The device is supported by NetworkManager.
NM_DEVICE_CAP_CARRIER_DETECT = 0x2
The device supports carrier detection.

Structure types:

NM_DEVICE_STATE_REASON_STRUCT - ( u: state, u: reason ) @@ -885,7 +916,8 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.

Parameters

options - a{sv}
- Options of scan (currently unused argument). + Options of scan. + Currently 'ssids' option with value of "aay" type is supported.

Signals:

PropertiesChanged ( a{sv}: properties )

@@ -2372,6 +2404,7 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  • NM_DEVICE_STATE_REASON_STRUCT - ( u, u )
  • NM_DEVICE_TYPE + - u
  • NM_METERED - u
  • NM_SECRET_AGENT_CAPABILITIES - u
  • NM_SECRET_AGENT_GET_SECRETS_FLAGS - u
  • NM_STATE diff --git a/docs/api/settings-spec.xml b/docs/api/settings-spec.xml index f1b507fe..6f8645a7 100644 --- a/docs/api/settings-spec.xml +++ b/docs/api/settings-spec.xml @@ -88,6 +88,7 @@ idstringA human readable unique identifier for the connection, like "Work Wi-Fi" or "T-Mobile 3G". interface-namestringThe 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. masterstringInterface name of the master device or UUID of the master connection. + meteredNMMetered (int32)Whether the connection is metered. namestringconnectionThe 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". permissionsarray of string[]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. read-onlybooleanFALSEFALSE 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. @@ -263,6 +264,8 @@ 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. + wake-on-lanuint321The NMSettingWiredWakeOnLan options to enable. Not all devices support all options. May be any combination of NM_SETTING_WIRED_WAKE_ON_LAN_PHY (0x2), NM_SETTING_WIRED_WAKE_ON_LAN_UNICAST (0x4), NM_SETTING_WIRED_WAKE_ON_LAN_MULTICAST (0x8), NM_SETTING_WIRED_WAKE_ON_LAN_BROADCAST (0x10), NM_SETTING_WIRED_WAKE_ON_LAN_ARP (0x20), NM_SETTING_WIRED_WAKE_ON_LAN_MAGIC (0x40). + wake-on-lan-passwordstringIf specified, the password used with magic-packet-based Wake-on-LAN, represented as an Ethernet MAC address. If NULL, no password will be required. 802-11-wireless settingKey NameValue TypeDefault ValueValue Descriptionbandstring802.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. diff --git a/docs/api/spec.html b/docs/api/spec.html index bcd634dd..7f7559c5 100644 --- a/docs/api/spec.html +++ b/docs/api/spec.html @@ -1,4 +1,4 @@ -NetworkManager D-Bus Interface Specification version 1.0.4

    NetworkManager D-Bus Interface Specification

    Version 1.0.4

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

    NetworkManager D-Bus Interface Specification

    Version 1.0.6

    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 @@ -381,6 +381,14 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.

    Metered - + u - + (read) + (NM_METERED) +
    + Wheter the connectivity is metered. This is equivalent to the + metered property of the device associated with the primary + connection.
    ActivatingConnection - o - (read)
    @@ -478,7 +486,13 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.u - (read)
    The maximum bitrate this access point is capable of, in kilobits/second (Kb/s).
    Strength - y - - (read)
    The current signal quality of the access point, in percent.

    Sets of flags:

    NM_802_11_AP_FLAGS

    + (read)
    The current signal quality of the access point, in percent.
    LastSeen - + i - + (read)
    + The timestamp (in CLOCK_BOOTTIME seconds) for the last time the access + point was found in scan results. A value of -1 means the access point + has never been found in scan results. +

    Sets of flags:

    NM_802_11_AP_FLAGS

    Flags describing the general capabilities of the access point.
    NM_802_11_AP_FLAGS_NONE = 0x0
    Null capability - says nothing about the access point.
    NM_802_11_AP_FLAGS_PRIVACY = 0x1
    Access point supports privacy measures.

    NM_802_11_AP_SEC

    Flags describing the security capabilities of the access point. @@ -635,6 +649,13 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.u - (read)
    The device MTU (maximum transmission unit). +
    Metered - + u - + (read) + (NM_METERED) +
    + Whether the amount of traffic flowing through the device is + subject to limitations, for example set by service providers.

    Enumerated types:

    NM_DEVICE_STATE

    NM_DEVICE_STATE_UNKNOWN = 0
    The device is in an unknown state.
    NM_DEVICE_STATE_UNMANAGED = 10
    @@ -817,6 +838,16 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
    NM_DEVICE_STATE_REASON_PARENT_MANAGED_CHANGED = 62
    The device parent's management changed. +

    NM_METERED

    NM_METERED_UNKNOWN = 0
    + The device metered status is unknown. +
    NM_METERED_YES = 1
    + The device is metered and the value was statically set. +
    NM_METERED_NO = 2
    + The device is not metered and the value was statically set. +
    NM_METERED_GUESS_YES = 3
    + The device is metered and the value was guessed. +
    NM_METERED_GUESS_NO = 4
    + The device is not metered and the value was guessed.

    Sets of flags:

    NM_DEVICE_CAP

    NM_DEVICE_CAP_NONE = 0x0
    Null capability.
    NM_DEVICE_CAP_NM_SUPPORTED = 0x1
    The device is supported by NetworkManager.
    NM_DEVICE_CAP_CARRIER_DETECT = 0x2
    The device supports carrier detection.

    Structure types:

    NM_DEVICE_STATE_REASON_STRUCT - ( u: state, u: reason ) @@ -885,7 +916,8 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.

    Parameters

    options - a{sv}
    - Options of scan (currently unused argument). + Options of scan. + Currently 'ssids' option with value of "aay" type is supported.

    Signals:

    PropertiesChanged ( a{sv}: properties )

    @@ -2372,6 +2404,7 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  • NM_DEVICE_STATE_REASON_STRUCT - ( u, u )
  • NM_DEVICE_TYPE + - u
  • NM_METERED - u
  • NM_SECRET_AGENT_CAPABILITIES - u
  • NM_SECRET_AGENT_GET_SECRETS_FLAGS - u
  • NM_STATE diff --git a/docs/api/version.xml b/docs/api/version.xml index ee90284c..af0b7ddb 100644 --- a/docs/api/version.xml +++ b/docs/api/version.xml @@ -1 +1 @@ -1.0.4 +1.0.6 diff --git a/docs/libnm-glib/html/NMAccessPoint.html b/docs/libnm-glib/html/NMAccessPoint.html index 9182a27a..b6e6a378 100644 --- a/docs/libnm-glib/html/NMAccessPoint.html +++ b/docs/libnm-glib/html/NMAccessPoint.html @@ -121,6 +121,14 @@
  • + + + + + + + + + @@ -256,6 +269,10 @@ + + + + @@ -546,6 +563,35 @@ nm_access_point_get_strength ( +

    nm_access_point_get_last_seen ()

    +
    gint32
    +nm_access_point_get_last_seen (NMAccessPoint *ap);
    +

    Returns the timestamp (in CLOCK_BOOTTIME seconds) for the last time the +access point was found in scan results. A value of -1 means the access +point has not been found in a scan.

    +
    +

    Parameters

    +
    +gint32 + +nm_access_point_get_last_seen () +
    GSList * @@ -177,6 +185,11 @@ Read
    gintlast-seenRead
    guint max-bitrate Read
    #defineNM_ACCESS_POINT_LAST_SEEN
    #define NM_ACCESS_POINT_HW_ADDRESS
    +++++ + + + + + +

    ap

    a NMAccessPoint

     
  • +
    +
    +

    Returns

    +

    the last seen time in seconds

    +
    +

    Since: 1.0.6

    +
    +
    +

    nm_access_point_filter_connections ()

    GSList *
     nm_access_point_filter_connections (NMAccessPoint *ap,
    @@ -560,7 +606,7 @@ use NMDevice using nm_device_filter_connections() and finally
     filter that list with this function.

    -

    Parameters

    +

    Parameters

    @@ -583,7 +629,7 @@ filter that list with this function.

    -

    Returns

    +

    Returns

    a list of NMConnection objects that could be activated with the given ap . @@ -605,7 +651,7 @@ the connection may be activated with that AP. The connection must match the 's SSID, (if given) BSSID, and other attributes like security settings, channel, band, etc.

    -

    Parameters

    +

    Parameters

    @@ -629,7 +675,7 @@ against

    -

    Returns

    +

    Returns

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

    @@ -645,7 +691,7 @@ nm_access_point_get_hw_address (

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

    -

    Parameters

    +

    Parameters

    @@ -660,7 +706,7 @@ nm_access_point_get_hw_address (
    -

    Returns

    +

    Returns

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

    @@ -723,6 +769,12 @@ access point and must not be modified.


    +

    NM_ACCESS_POINT_LAST_SEEN

    +
    #define NM_ACCESS_POINT_LAST_SEEN   "last-seen"
    +
    +
    +
    +

    NM_ACCESS_POINT_HW_ADDRESS

    #define NM_ACCESS_POINT_HW_ADDRESS  "hw-address"
     
    @@ -765,6 +817,18 @@ access point and must not be modified.


    +

    The “last-seen” property

    +
      “last-seen”                gint
    +

    The timestamp (in CLOCK_BOOTTIME seconds) for the last time the +access point was found in scan results. A value of -1 means the +access point has not been found in a scan.

    +

    Flags: Read

    +

    Allowed values: >= -1

    +

    Default value: -1

    +

    Since: 1.0.6

    +
    +
    +

    The “max-bitrate” property

      “max-bitrate”              guint

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

    diff --git a/docs/libnm-glib/html/NMActiveConnection.html b/docs/libnm-glib/html/NMActiveConnection.html index 51037dca..e14a0408 100644 --- a/docs/libnm-glib/html/NMActiveConnection.html +++ b/docs/libnm-glib/html/NMActiveConnection.html @@ -655,7 +655,7 @@ nm_active_connection_get_ip4_config (

    Returns

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

    [transfer none]

    @@ -687,7 +687,7 @@ nm_active_connection_get_dhcp4_config (

    Returns

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

    +NM_ACTIVE_CONNECTION_STATE_ACTIVATED state.

    [transfer none]

    Since: 0.9.10

    @@ -743,7 +743,7 @@ nm_active_connection_get_ip6_config (

    Returns

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

    [transfer none]

    @@ -775,7 +775,7 @@ nm_active_connection_get_dhcp6_config (

    Returns

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

    +NM_ACTIVE_CONNECTION_STATE_ACTIVATED state.

    [transfer none]

    Since: 0.9.10

    diff --git a/docs/libnm-glib/html/NMSecretAgent.html b/docs/libnm-glib/html/NMSecretAgent.html index 8acd02c1..354c1209 100644 --- a/docs/libnm-glib/html/NMSecretAgent.html +++ b/docs/libnm-glib/html/NMSecretAgent.html @@ -289,7 +289,7 @@ something like this:

    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); +secrets_hash = nm_connection_to_hash (secrets, NM_SETTING_HASH_FLAG_ALL); (call the NMSecretAgentGetSecretsFunc with secrets_hash) diff --git a/docs/libnm-glib/html/api-index-full.html b/docs/libnm-glib/html/api-index-full.html index 1f09388c..e11ae148 100644 --- a/docs/libnm-glib/html/api-index-full.html +++ b/docs/libnm-glib/html/api-index-full.html @@ -56,6 +56,10 @@
    +NMAccessPoint:last-seen, object property in NMAccessPoint +
    +
    +
    NMAccessPoint:max-bitrate, object property in NMAccessPoint
    @@ -116,6 +120,10 @@
    +nm_access_point_get_last_seen, function in NMAccessPoint +
    +
    +
    nm_access_point_get_max_bitrate, function in NMAccessPoint
    @@ -144,6 +152,10 @@
    +NM_ACCESS_POINT_LAST_SEEN, macro in NMAccessPoint +
    +
    +
    NM_ACCESS_POINT_MAX_BITRATE, macro in NMAccessPoint
    diff --git a/docs/libnm-glib/html/index.html b/docs/libnm-glib/html/index.html index bec4797c..6a134292 100644 --- a/docs/libnm-glib/html/index.html +++ b/docs/libnm-glib/html/index.html @@ -15,7 +15,7 @@

    - for libnm-glib 1.0.4 + for libnm-glib 1.0.6 The latest version of this documentation can be found on-line at https://developer.gnome.org/libnm-glib/0.9/. diff --git a/docs/libnm-glib/html/index.sgml b/docs/libnm-glib/html/index.sgml index 5b020fd0..80069edb 100644 --- a/docs/libnm-glib/html/index.sgml +++ b/docs/libnm-glib/html/index.sgml @@ -678,6 +678,7 @@ + @@ -691,12 +692,14 @@ + + diff --git a/docs/libnm-glib/html/libnm-glib.devhelp2 b/docs/libnm-glib/html/libnm-glib.devhelp2 index 00b0f075..017e1861 100644 --- a/docs/libnm-glib/html/libnm-glib.devhelp2 +++ b/docs/libnm-glib/html/libnm-glib.devhelp2 @@ -467,6 +467,7 @@ + @@ -479,11 +480,13 @@ + + diff --git a/docs/libnm-glib/libnm-glib-sections.txt b/docs/libnm-glib/libnm-glib-sections.txt index d21040d2..420d1610 100644 --- a/docs/libnm-glib/libnm-glib-sections.txt +++ b/docs/libnm-glib/libnm-glib-sections.txt @@ -10,6 +10,7 @@ NM_ACCESS_POINT_FREQUENCY NM_ACCESS_POINT_MODE NM_ACCESS_POINT_MAX_BITRATE NM_ACCESS_POINT_STRENGTH +NM_ACCESS_POINT_LAST_SEEN NM_ACCESS_POINT_HW_ADDRESS nm_access_point_new nm_access_point_get_flags @@ -21,6 +22,7 @@ nm_access_point_get_frequency nm_access_point_get_mode nm_access_point_get_max_bitrate nm_access_point_get_strength +nm_access_point_get_last_seen nm_access_point_filter_connections nm_access_point_connection_valid nm_access_point_get_hw_address diff --git a/docs/libnm-glib/version.xml b/docs/libnm-glib/version.xml index ee90284c..af0b7ddb 100644 --- a/docs/libnm-glib/version.xml +++ b/docs/libnm-glib/version.xml @@ -1 +1 @@ -1.0.4 +1.0.6 diff --git a/docs/libnm-util/html/index.html b/docs/libnm-util/html/index.html index 7be22883..453e0d98 100644 --- a/docs/libnm-util/html/index.html +++ b/docs/libnm-util/html/index.html @@ -15,7 +15,7 @@

    - for libnm-util 1.0.4 + for libnm-util 1.0.6 The latest version of this documentation can be found on-line at https://developer.gnome.org/libnm-util/0.9/. diff --git a/docs/libnm-util/version.xml b/docs/libnm-util/version.xml index ee90284c..af0b7ddb 100644 --- a/docs/libnm-util/version.xml +++ b/docs/libnm-util/version.xml @@ -1 +1 @@ -1.0.4 +1.0.6 diff --git a/docs/libnm/Makefile.am b/docs/libnm/Makefile.am index 28938f89..2525856d 100644 --- a/docs/libnm/Makefile.am +++ b/docs/libnm/Makefile.am @@ -53,7 +53,8 @@ IGNORE_HFILES= \ nm-setting-private.h \ nm-types.h \ nm-utils-private.h \ - nm-vpn-plugin-old.h + nm-vpn-plugin-old.h \ + nm-core-tests-enum-types.h # Images to copy into HTML directory. HTML_IMAGES = libnm.png diff --git a/docs/libnm/Makefile.in b/docs/libnm/Makefile.in index 54ad3287..bb41ba14 100644 --- a/docs/libnm/Makefile.in +++ b/docs/libnm/Makefile.in @@ -455,7 +455,8 @@ IGNORE_HFILES = \ nm-setting-private.h \ nm-types.h \ nm-utils-private.h \ - nm-vpn-plugin-old.h + nm-vpn-plugin-old.h \ + nm-core-tests-enum-types.h # Images to copy into HTML directory. diff --git a/docs/libnm/html/NMAccessPoint.html b/docs/libnm/html/NMAccessPoint.html index 1daa7c01..4aa880dc 100644 --- a/docs/libnm/html/NMAccessPoint.html +++ b/docs/libnm/html/NMAccessPoint.html @@ -114,6 +114,14 @@ +gint + + +nm_access_point_get_last_seen () + + + + GPtrArray * @@ -163,6 +171,11 @@ Read +gint +last-seen +Read + + guint max-bitrate Read @@ -242,6 +255,10 @@ #define +NM_ACCESS_POINT_LAST_SEEN + + +#define NM_ACCESS_POINT_HW_ADDRESS @@ -498,6 +515,35 @@ nm_access_point_get_strength ( +

    nm_access_point_get_last_seen ()

    +
    gint
    +nm_access_point_get_last_seen (NMAccessPoint *ap);
    +

    Returns the timestamp (in CLOCK_BOOTTIME seconds) for the last time the +access point was found in scan results. A value of -1 means the access +point has not been found in a scan.

    +
    +

    Parameters

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

    ap

    a NMAccessPoint

     
    +
    +
    +

    Returns

    +

    the last seen time in seconds

    +
    +

    Since: 1.0.6

    +
    +
    +

    nm_access_point_filter_connections ()

    GPtrArray *
     nm_access_point_filter_connections (NMAccessPoint *ap,
    @@ -512,7 +558,7 @@ use NMDevice using nm_device_filter_connections() and finally filter that list
     with this function.

    -

    Parameters

    +

    Parameters

    @@ -535,7 +581,7 @@ filter.

    -

    Returns

    +

    Returns

    an array of NMConnections that could be activated with the given ap . The array should @@ -555,7 +601,7 @@ the connection may be activated with that AP. The connection must match the 's SSID, (if given) BSSID, and other attributes like security settings, channel, band, etc.

    -

    Parameters

    +

    Parameters

    @@ -579,7 +625,7 @@ against

    -

    Returns

    +

    Returns

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

    @@ -642,6 +688,12 @@ against


    +

    NM_ACCESS_POINT_LAST_SEEN

    +
    #define NM_ACCESS_POINT_LAST_SEEN   "last-seen"
    +
    +
    +
    +

    NM_ACCESS_POINT_HW_ADDRESS

    #define NM_ACCESS_POINT_HW_ADDRESS  "hw-address"
     
    @@ -686,6 +738,18 @@ against


    +

    The “last-seen” property

    +
      “last-seen”                gint
    +

    The timestamp (in CLOCK_BOOTTIME seconds) for the last time the +access point was found in scan results. A value of -1 means the +access point has not been found in a scan.

    +

    Flags: Read

    +

    Allowed values: >= -1

    +

    Default value: -1

    +

    Since: 1.0.6

    +
    +
    +

    The “max-bitrate” property

      “max-bitrate”              guint

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

    diff --git a/docs/libnm/html/NMClient.html b/docs/libnm/html/NMClient.html index 950d7251..1914ba7b 100644 --- a/docs/libnm/html/NMClient.html +++ b/docs/libnm/html/NMClient.html @@ -523,6 +523,11 @@ Read +guint +metered +Read + + gboolean networking-enabled Read / Write @@ -710,6 +715,10 @@ #define +NM_CLIENT_METERED + + +#define NM_CLIENT_DEVICE_ADDED @@ -2989,6 +2998,12 @@ nm_client_reload_connections_finish (
    +

    NM_CLIENT_METERED

    +
    #define NM_CLIENT_METERED "metered"
    +
    +
    +
    +

    NM_CLIENT_DEVICE_ADDED

    #define NM_CLIENT_DEVICE_ADDED "device-added"
     
    @@ -3023,7 +3038,7 @@ nm_client_reload_connections_finish (NMClientPermission values indicate various permissions that NetworkManager clients can obtain to perform certain tasks on behalf of the current user.

    -

    Members

    +

    Members

    @@ -3143,7 +3158,7 @@ clients can obtain to perform certain tasks on behalf of the current user.

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

    -

    Members

    +

    Members

    @@ -3192,7 +3207,7 @@ the user requires to obtain a given NMManagerError, NMSettingsError, NMAgentManagerError, and NMConnectionError.

    -

    Members

    +

    Members

    @@ -3299,6 +3314,15 @@ modified by calling
    +

    The “metered” property

    +
      “metered”                  guint
    +

    Whether the connectivity is metered.

    +

    Flags: Read

    +

    Default value: 0

    +

    Since: 1.0.6

    +
    +
    +

    The “networking-enabled” property

      “networking-enabled”       gboolean

    Whether networking is enabled.

    diff --git a/docs/libnm/html/NMDevice.html b/docs/libnm/html/NMDevice.html index 8065247c..ff38ac07 100644 --- a/docs/libnm/html/NMDevice.html +++ b/docs/libnm/html/NMDevice.html @@ -255,6 +255,14 @@
    + + + + + + + + + @@ -601,6 +614,10 @@ + + + +
    +NMMetered + +nm_device_get_metered () +
    char ** @@ -446,6 +454,11 @@
    guintmeteredRead
    guint mtu Read
    #define NM_DEVICE_MTU
    #defineNM_DEVICE_METERED
    @@ -1410,6 +1427,33 @@ product name is unknown, this returns the interface name.


    +

    nm_device_get_metered ()

    +
    NMMetered
    +nm_device_get_metered (NMDevice *device);
    +

    Gets the metered setting of a NMDevice.

    +
    +

    Parameters

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

    device

    a NMDevice

     
    +
    +
    +

    Returns

    +

    the metered setting.

    +
    +

    Since: 1.0.6

    +
    +
    +

    nm_device_disambiguate_names ()

    char **
     nm_device_disambiguate_names (NMDevice **devices,
    @@ -1418,7 +1462,7 @@ nm_device_disambiguate_names (devices
     .

    -

    Parameters

    +

    Parameters

    @@ -1441,7 +1485,7 @@ devices in devices
    -

    Returns

    +

    Returns

    the device names.

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

    @@ -1457,7 +1501,7 @@ nm_device_disconnect ( -

    Parameters

    +

    Parameters

    @@ -1484,7 +1528,7 @@ request.

    -

    Returns

    +

    Returns

    TRUE on success, FALSE on error, in which case error will be set.

    @@ -1501,7 +1545,7 @@ nm_device_disconnect_async ( -

    Parameters

    +

    Parameters

    @@ -1543,7 +1587,7 @@ nm_device_disconnect_finish (GError **error);

    Gets the result of a call to nm_device_disconnect_async().

    -

    Parameters

    +

    Parameters

    @@ -1570,7 +1614,7 @@ nm_device_disconnect_finish ( -

    Returns

    +

    Returns

    TRUE on success, FALSE on error, in which case error will be set.

    @@ -1584,7 +1628,7 @@ nm_device_delete (GError **error);

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

    -

    Parameters

    +

    Parameters

    @@ -1611,7 +1655,7 @@ nm_device_delete ( -

    Returns

    +

    Returns

    TRUE on success, FALSE on error, in which case error will be set.

    @@ -1627,7 +1671,7 @@ nm_device_delete_async ( -

    Parameters

    +

    Parameters

    @@ -1669,7 +1713,7 @@ nm_device_delete_finish (GError **error);

    Gets the result of a call to nm_device_delete_async().

    -

    Parameters

    +

    Parameters

    @@ -1696,7 +1740,7 @@ nm_device_delete_finish ( -

    Returns

    +

    Returns

    TRUE on success, FALSE on error, in which case error will be set.

    @@ -1718,7 +1762,7 @@ 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().

    -

    Parameters

    +

    Parameters

    @@ -1740,7 +1784,7 @@ incompatible with the device. To get the full list of connections see
    -

    Returns

    +

    Returns

    an array of NMConnections that could be activated with the given device . The array @@ -1763,7 +1807,7 @@ 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.

    -

    Parameters

    +

    Parameters

    @@ -1787,7 +1831,7 @@ against

    -

    Returns

    +

    Returns

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

    @@ -1811,7 +1855,7 @@ device.

    compatibility of the given device and connection. But, in addition, it sets GError when FALSE is returned.

    -

    Parameters

    +

    Parameters

    @@ -1840,7 +1884,7 @@ against

    -

    Returns

    +

    Returns

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

    @@ -1854,7 +1898,7 @@ nm_device_get_setting_type (device .

    -

    Parameters

    +

    Parameters

    @@ -1869,7 +1913,7 @@ that can be used on device
    -

    Returns

    +

    Returns

    device 's associated NMSetting type

    @@ -2014,6 +2058,12 @@ that can be used on device
    #define NM_DEVICE_MTU "mtu"
     
    +
    +
    +

    NM_DEVICE_METERED

    +
    #define NM_DEVICE_METERED "metered"
    +
    +

    Property Details

    @@ -2142,6 +2192,15 @@ operations like addressing and routing.


    +

    The “metered” property

    +
      “metered”                  guint
    +

    Whether the device is metered.

    +

    Flags: Read

    +

    Default value: 0

    +

    Since: 1.0.6

    +
    +
    +

    The “mtu” property

      “mtu”                      guint

    The MTU of the device.

    diff --git a/docs/libnm/html/NMDeviceWifi.html b/docs/libnm/html/NMDeviceWifi.html index db0dca47..776aba14 100644 --- a/docs/libnm/html/NMDeviceWifi.html +++ b/docs/libnm/html/NMDeviceWifi.html @@ -113,6 +113,14 @@ +gboolean + + +nm_device_wifi_request_scan_options () + + + + void @@ -121,6 +129,14 @@ +void + + +nm_device_wifi_request_scan_options_async () + + + + gboolean @@ -527,6 +543,64 @@ set.


    +

    nm_device_wifi_request_scan_options ()

    +
    gboolean
    +nm_device_wifi_request_scan_options (NMDeviceWifi *device,
    +                                     GVariant *options,
    +                                     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. +This is the same as nm_device_wifi_request_scan + except it accepts options + +for the scanning. The argument is the dictionary passed to RequestScan() +D-Bus call. Valid otions inside the dictionary are: +'ssids' => array of SSIDs (saay)

    +
    +

    Parameters

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

    device

    a NMDeviceWifi

     

    options

    dictionary with options for RequestScan(), or NULL

     

    cancellable

    a GCancellable, or NULL

     

    error

    location for a GError, or NULL

     
    +
    +
    +

    Returns

    +

    TRUE on success, FALSE on error, in which case error +will be +set.

    +
    +

    Since: 1.0.6

    +
    +
    +

    nm_device_wifi_request_scan_async ()

    void
     nm_device_wifi_request_scan_async (NMDeviceWifi *device,
    @@ -539,7 +613,7 @@ nm_device_wifi_request_scan_async (
     
    -

    Parameters

    +

    Parameters

    @@ -574,6 +648,67 @@ that for the scan to complete.


    +

    nm_device_wifi_request_scan_options_async ()

    +
    void
    +nm_device_wifi_request_scan_options_async
    +                               (NMDeviceWifi *device,
    +                                GVariant *options,
    +                                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. +This is the same as nm_device_wifi_request_scan_async + except it accepts options + +for the scanning. The argument is the dictionary passed to RequestScan() +D-Bus call. Valid otions inside the dictionary are: +'ssids' => array of SSIDs (saay)

    +
    +

    Parameters

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

    device

    a NMDeviceWifi

     

    options

    dictionary with options for RequestScan(), or NULL

     

    cancellable

    a GCancellable, or NULL

     

    callback

    callback to be called when the scan has been requested

     

    user_data

    caller-specific data passed to callback +

     
    +
    +

    Since: 1.0.6

    +
    +
    +

    nm_device_wifi_request_scan_finish ()

    gboolean
     nm_device_wifi_request_scan_finish (NMDeviceWifi *device,
    @@ -581,7 +716,7 @@ nm_device_wifi_request_scan_finish (GError **error);

    Gets the result of a call to nm_device_wifi_request_scan_async().

    -

    Parameters

    +

    Parameters

    @@ -608,7 +743,7 @@ nm_device_wifi_request_scan_finish (
    -

    Returns

    +

    Returns

    TRUE on success, FALSE on error, in which case error will be set.

    diff --git a/docs/libnm/html/NMSettingConnection.html b/docs/libnm/html/NMSettingConnection.html index f33e2b88..aef02658 100644 --- a/docs/libnm/html/NMSettingConnection.html +++ b/docs/libnm/html/NMSettingConnection.html @@ -241,6 +241,14 @@ nm_setting_connection_get_gateway_ping_timeout () +
    + + +
    +NMMetered + +nm_setting_connection_get_metered () +
    @@ -292,6 +300,11 @@ Read / Write +NMMetered +metered +Read / Write + + GStrv permissions Read / Write @@ -423,6 +436,10 @@ NM_SETTING_CONNECTION_GATEWAY_PING_TIMEOUT +#define +NM_SETTING_CONNECTION_METERED + + enum NMSettingConnectionAutoconnectSlaves @@ -1264,6 +1281,32 @@ nm_setting_connection_get_gateway_ping_timeout property.

    +
    +
    +

    nm_setting_connection_get_metered ()

    +
    NMMetered
    +nm_setting_connection_get_metered (NMSettingConnection *setting);
    +
    +

    Parameters

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

    setting

    the NMSettingConnection

     
    +
    +
    +

    Returns

    +

    the “metered” property of the setting.

    +
    +

    Since: 1.0.6

    +

    Types and Values

    @@ -1382,11 +1425,17 @@ property.


    +

    NM_SETTING_CONNECTION_METERED

    +
    #define NM_SETTING_CONNECTION_METERED        "metered"
    +
    +
    +
    +

    enum NMSettingConnectionAutoconnectSlaves

    NMSettingConnectionAutoconnectSlaves values indicate whether slave connections should be activated when master is activated.

    -

    Members

    +

    Members

    @@ -1512,6 +1561,15 @@ connection may be applied to the wrong interface.


    +

    The “metered” property

    +
      “metered”                  NMMetered
    +

    Whether the connection is metered.

    +

    Flags: Read / Write

    +

    Default value: NM_METERED_UNKNOWN

    +

    Since: 1.0.6

    +
    +
    +

    The “permissions” property

      “permissions”              GStrv

    An array of strings defining what access a given user has to this diff --git a/docs/libnm/html/NMSettingWired.html b/docs/libnm/html/NMSettingWired.html index 6255f6c8..1ee7de44 100644 --- a/docs/libnm/html/NMSettingWired.html +++ b/docs/libnm/html/NMSettingWired.html @@ -215,6 +215,21 @@ nm_setting_wired_get_valid_s390_options () +

    + + + + + + +
    +NMSettingWiredWakeOnLan + +nm_setting_wired_get_wake_on_lan () +
    const char * + +nm_setting_wired_get_wake_on_lan_password () +
    @@ -288,6 +303,17 @@ speed Read / Write / Construct + +guint +wake-on-lan +Read / Write / Construct + + + +gchar * +wake-on-lan-password +Read / Write +
    @@ -304,6 +330,10 @@ NM_SETTING_WIRED_SETTING_NAME +enum +NMSettingWiredWakeOnLan + + #define NM_SETTING_WIRED_PORT @@ -347,12 +377,22 @@ #define NM_SETTING_WIRED_S390_OPTIONS + +#define +NM_SETTING_WIRED_WAKE_ON_LAN + + +#define +NM_SETTING_WIRED_WAKE_ON_LAN_PASSWORD +

    Object Hierarchy

    -
        GObject
    +
        GFlags
    +    ╰── NMSettingWiredWakeOnLan
    +    GObject
         ╰── NMSetting
             ╰── NMSettingWired
     
    @@ -1055,6 +1095,62 @@ nm_setting_wired_get_valid_s390_options

    [transfer none]

    +
    +
    +

    nm_setting_wired_get_wake_on_lan ()

    +
    NMSettingWiredWakeOnLan
    +nm_setting_wired_get_wake_on_lan (NMSettingWired *setting);
    +

    Returns the Wake-on-LAN options enabled for the connection

    +
    +

    Parameters

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

    setting

    the NMSettingWired

     
    +
    +
    +

    Returns

    +

    the Wake-on-LAN options

    +
    +

    Since: 1.0.6

    +
    +
    +
    +

    nm_setting_wired_get_wake_on_lan_password ()

    +
    const char *
    +nm_setting_wired_get_wake_on_lan_password
    +                               (NMSettingWired *setting);
    +

    Returns the Wake-on-LAN password. This only applies to +NM_SETTING_WIRED_WAKE_ON_LAN_MAGIC.

    +
    +

    Parameters

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

    setting

    the NMSettingWired

     
    +
    +
    +

    Returns

    +

    the Wake-on-LAN setting password, or NULL if there is no password.

    +
    +

    Since: 1.0.6

    +

    Types and Values

    @@ -1065,6 +1161,93 @@ nm_setting_wired_get_valid_s390_options

    +

    enum NMSettingWiredWakeOnLan

    +

    Options for “wake-on-lan”. Note that not all options +are supported by all devices.

    +
    +

    Members

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

    NM_SETTING_WIRED_WAKE_ON_LAN_NONE

    +

    Wake-on-LAN disabled

    +
     

    NM_SETTING_WIRED_WAKE_ON_LAN_DEFAULT

    +

    Use the default value

    +
     

    NM_SETTING_WIRED_WAKE_ON_LAN_PHY

    +

    Wake on PHY activity

    +
     

    NM_SETTING_WIRED_WAKE_ON_LAN_UNICAST

    +

    Wake on unicast messages

    +
     

    NM_SETTING_WIRED_WAKE_ON_LAN_MULTICAST

    +

    Wake on multicast messages

    +
     

    NM_SETTING_WIRED_WAKE_ON_LAN_BROADCAST

    +

    Wake on broadcast messages

    +
     

    NM_SETTING_WIRED_WAKE_ON_LAN_ARP

    +

    Wake on ARP

    +
     

    NM_SETTING_WIRED_WAKE_ON_LAN_MAGIC

    +

    Wake on magic packet

    +
     

    _NM_SETTING_WIRED_WAKE_ON_LAN_LAST

      

    NM_SETTING_WIRED_WAKE_ON_LAN_ALL

    +

    Wake on all events

    +
     
    +
    +

    Since: 1.0.6

    +
    +
    +

    NM_SETTING_WIRED_PORT

    #define NM_SETTING_WIRED_PORT "port"
     
    @@ -1129,6 +1312,18 @@ nm_setting_wired_get_valid_s390_options
    #define NM_SETTING_WIRED_S390_OPTIONS "s390-options"
     
    +
    +
    +

    NM_SETTING_WIRED_WAKE_ON_LAN

    +
    #define NM_SETTING_WIRED_WAKE_ON_LAN "wake-on-lan"
    +
    +
    +
    +
    +

    NM_SETTING_WIRED_WAKE_ON_LAN_PASSWORD

    +
    #define NM_SETTING_WIRED_WAKE_ON_LAN_PASSWORD "wake-on-lan-password"
    +
    +

    Property Details

    @@ -1241,6 +1436,30 @@ Mbit/s, ie 100 == 100Mbit/s.

    Flags: Read / Write / Construct

    Default value: 0

    +
    +
    +

    The “wake-on-lan” property

    +
      “wake-on-lan”              guint
    +

    The NMSettingWiredWakeOnLan options to enable. Not all devices support all options. +May be any combination of NM_SETTING_WIRED_WAKE_ON_LAN_PHY, +NM_SETTING_WIRED_WAKE_ON_LAN_UNICAST, NM_SETTING_WIRED_WAKE_ON_LAN_MULTICAST, +NM_SETTING_WIRED_WAKE_ON_LAN_BROADCAST, NM_SETTING_WIRED_WAKE_ON_LAN_ARP, +NM_SETTING_WIRED_WAKE_ON_LAN_MAGIC.

    +

    Flags: Read / Write / Construct

    +

    Default value: 1

    +

    Since: 1.0.6

    +
    +
    +
    +

    The “wake-on-lan-password” property

    +
      “wake-on-lan-password”     gchar *
    +

    If specified, the password used with magic-packet-based +Wake-on-LAN, represented as an Ethernet MAC address. If NULL, +no password will be required.

    +

    Flags: Read / Write

    +

    Default value: NULL

    +

    Since: 1.0.6

    +