From e152ec7bf4ba252ff9d3eb13eabd417b931dac9a Mon Sep 17 00:00:00 2001
From: Iain Lane Registers an error quark for NMDevice if necessary. Creates a new NMDevice. connection the DBusGConnection the DBusGConnection Returns the numeric type of the NMDevice, ie Ethernet, Wi-Fi, etc. the current MAC of the device, or the current MAC of the device, or Since: 0.9.10 Gets the device' capabilities. Whether the NMDevice is managed by NetworkManager. Enables or disables management of NMDevice by NetworkManager. Whether the NMDevice can be autoconnected. Enables or disables automatic activation of the NMDevice. autoconnect Indicates that firmware required for the device's operation is likely
to be missing. the NMIP4Config or the NMIP4Config or [transfer none] the NMDHCP4Config or the NMDHCP4Config or [transfer none]
-GQuark
+GQuark
nm_device_error_quark ()
@@ -52,7 +52,7 @@
-GObject *
+GObject *
nm_device_new ()
@@ -74,7 +74,7 @@
-NMDeviceType
+NMDeviceType
nm_device_get_device_type ()
@@ -124,7 +124,7 @@
-NMDeviceCapabilities
+NMDeviceCapabilities
nm_device_get_capabilities ()
@@ -132,7 +132,7 @@
-gboolean
+gboolean
nm_device_get_managed ()
@@ -148,7 +148,7 @@
-gboolean
+gboolean
nm_device_get_autoconnect ()
@@ -164,7 +164,7 @@
-gboolean
+gboolean
nm_device_get_firmware_missing ()
@@ -204,7 +204,7 @@
-NMDeviceState
+NMDeviceState
nm_device_get_state ()
@@ -212,7 +212,7 @@
-NMDeviceState
+NMDeviceState
nm_device_get_state_reason ()
@@ -227,7 +227,7 @@
-
const GPtrArray *
+ const GPtrArray *
nm_device_get_available_connections ()
@@ -242,7 +242,7 @@
-guint32
+guint32
nm_device_get_mtu ()
@@ -250,7 +250,7 @@
-gboolean
+gboolean
nm_device_is_software ()
@@ -258,7 +258,7 @@
-gboolean
+gboolean
nm_device_is_real ()
@@ -319,7 +319,7 @@
-GSList *
+GSList *
nm_device_filter_connections ()
@@ -327,7 +327,7 @@
-gboolean
+gboolean
nm_device_connection_valid ()
@@ -335,7 +335,7 @@
-gboolean
+gboolean
nm_device_connection_compatible ()
@@ -343,7 +343,7 @@
-GType
+GType
nm_device_get_setting_type ()
@@ -376,7 +376,7 @@
Read
-
@@ -387,12 +387,12 @@
gboolean
+gboolean
autoconnect
Read / Write
Read
-
guint
+guint
capabilities
Read
-
@@ -410,36 +410,36 @@
guint
+guint
device-type
Read
-gchar *
+gchar *
driver
Read
-gchar *
+gchar *
driver-version
Read
-
gboolean
+gboolean
firmware-missing
Read
-gchar *
+gchar *
firmware-version
Read
-gchar *
+gchar *
interface
Read
@@ -456,34 +456,34 @@
-gchar *
+gchar *
ip-interface
Read
Read
-
gboolean
+gboolean
managed
Read
-
guint
+guint
mtu
Read
-gchar *
+gchar *
physical-port-id
Read
-gchar *
+gchar *
product
Read
-
gboolean
+gboolean
real
Read
-
@@ -494,13 +494,13 @@
guint
+guint
state
Read
-gchar *
+gchar *
udi
Read
@@ -518,7 +518,7 @@
-gchar *
+gchar *
vendor
Read
@@ -639,7 +639,7 @@
void
state-changed
-Run First
+Run First
Object Hierarchy
- GObject
+
GObject
╰── NMObject
╰── NMDevice
├── NMDeviceEthernet
@@ -664,7 +664,7 @@
Functions
nm_device_error_quark ()
-GQuark
+
GQuark
nm_device_error_quark (
void);void
nm_device_new ()
-GObject *
-nm_device_new (
DBusGConnection *connection,
+GObject *
+nm_device_new (
DBusGConnection *connection,
const char *path);
+
@@ -766,7 +766,7 @@ used by the device, and must not be modified.
@@ -1043,7 +1043,7 @@ nm_device_set_managed (
nm_device_get_device_type ()
-NMDeviceType
+
NMDeviceType
nm_device_get_device_type (
NMDevice *device);
Returns
-NULL.
+NULL.
This is the internal string used by the device, and must not be modified.
nm_device_get_capabilities ()
-NMDeviceCapabilities
+
NMDeviceCapabilities
nm_device_get_capabilities (
NMDevice *device);
nm_device_get_managed ()
-gboolean
+
gboolean
nm_device_get_managed (
NMDevice *device);
@@ -1014,7 +1014,7 @@ nm_device_get_managed (nm_device_set_managed ()
void
nm_device_set_managed (
+ NMDevice *device,
- gboolean managed);gboolean managed);
nm_device_get_autoconnect ()
-gboolean
+
gboolean
nm_device_get_autoconnect (
NMDevice *device);
@@ -1071,7 +1071,7 @@ nm_device_get_autoconnect (nm_device_set_autoconnect ()
void
nm_device_set_autoconnect (
+ NMDevice *device,
- gboolean autoconnect);gboolean autoconnect);Parameters
@@ -1089,7 +1089,7 @@ nm_device_set_autoconnect (
+TRUE to enable autoconnectingTRUE to enable autoconnecting
@@ -1099,7 +1099,7 @@ nm_device_set_autoconnect (
nm_device_get_firmware_missing ()
-gboolean
+
gboolean
nm_device_get_firmware_missing (
NMDevice *device);Returns
-NULL if the device is not activated. NULL if the device is not activated. Returns
-NULL if the device is not activated or not
+NULL if the device is not activated or not
using DHCP.
the NMIP6Config or NULL if the device is not activated.
the NMIP6Config or NULL if the device is not activated.
[transfer none]
the NMDHCP6Config or NULL if the device is not activated or not
+
the NMDHCP6Config or NULL if the device is not activated or not
using DHCP.
[transfer none]
NMDeviceState +NMDeviceState nm_device_get_state (NMDevice *device);Gets the current NMDevice state.
@@ -1275,9 +1275,9 @@ nm_device_get_state (nm_device_get_state_reason ()
-NMDeviceState +NMDeviceState nm_device_get_state_reason (+NMDevice *device, -NMDeviceStateReason *reason);NMDeviceStateReason *reason);Gets the current NMDevice state (return value) and the reason for entering the state (
@@ -1297,7 +1297,7 @@ the state (reasonargument).reason@@ -1331,7 +1331,7 @@ nm_device_get_active_connection ( - reason
+ location to store reason (NMDeviceStateReason), or
NULL.location to store reason (NMDeviceStateReason), or
NULL.[out][allow-none] @@ -1339,9 +1339,9 @@ not part of an active connection.Returns
-the NMActiveConnection or
NULLif the device is +the NMActiveConnection or
NULLif the device is not part of an active connection.[transfer none]
@@ -2073,7 +2073,7 @@ that can be used onnm_device_get_available_connections ()
-const GPtrArray * +const GPtrArray * nm_device_get_available_connections (-NMDevice *device);Gets the NMRemoteConnections currently known to the daemon that could +
Gets the NMRemoteConnections currently known to the daemon that could be activated on
device.@@ -1361,8 +1361,8 @@ be activated ondevice@@ -1373,9 +1373,9 @@ the connection, and must not be modified.Returns
-the GPtrArray -containing NMRemoteConnections. This is the internal copy used by +
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 +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 +seemingly-unrelated NMDevices are actually just different virtual ports on a single physical port. (Eg, NPAR / SR-IOV.)@@ -1403,7 +1403,7 @@ must not be modified.Returns
-the physical port ID of the device, or
NULLif the port +the physical port ID of the device, or
NULLif the port ID is unknown. This is the internal string used by the device and must not be modified.
nm_device_get_mtu ()
-guint32 +guint32 nm_device_get_mtu (NMDevice *device);Gets the MTU of the NMDevice.
@@ -1423,14 +1423,14 @@ nm_device_get_mtu (Returns
-the MTU of the device.
+the MTU of the device in bytes.
Since: 0.9.10
nm_device_is_software ()
-gboolean +gboolean nm_device_is_software (NMDevice *device);Whether the device is a software device.
@@ -1450,15 +1450,15 @@ nm_device_is_software (Returns
-+
TRUEifdevice-is a software device,FALSEif it is a hardware device.
TRUEifdevice+is a software device,FALSEif it is a hardware device.Since: 1.0
nm_device_is_real ()
-gboolean +gboolean nm_device_is_real (NMDevice *device);@@ -1611,8 +1611,8 @@ devices inParameters
@@ -1477,7 +1477,7 @@ nm_device_is_real (Returns
-
TRUEif the device exists, orFALSEif it is a placeholder device +
TRUEif the device exists, orFALSEif it is a placeholder device that could be automatically created by NetworkManager if one of its “available-connections” was activated.devicesNMDeviceCallbackFn ()
void (*NMDeviceCallbackFn) (+NMDevice *device, -GError *error, -gpointer user_data);GError *error, +gpointer user_data);
@@ -1620,7 +1620,7 @@ devices indevicesvoid nm_device_disconnect (+NMDevice *device,NMDeviceCallbackFn callback, -gpointer user_data);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.
@@ -1660,7 +1660,7 @@ operation completes.void nm_device_delete (+NMDevice *device,NMDeviceCallbackFn callback, -gpointer user_data);gpointer user_data);Deletes the software device. Hardware devices can't be deleted.
Parameters
@@ -1696,9 +1696,9 @@ operation completes.
nm_device_filter_connections ()
-GSList * +GSList * nm_device_filter_connections (+NMDevice *device, -const GSList *connections);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@@ -1725,7 +1725,7 @@ incompatible with the device. To get the full list of connections see@@ -1734,20 +1734,20 @@ incompatible with the device. To get the full list of connections see - connections
+ a list of NMConnection objects to filter.
a list of NMConnection objects to filter.
[element-type NMConnection] Returns
a -list of NMConnection objects that could be activated with the given
+be freed withdevice+list of NMConnection objects that could be activated with the givendevice. 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 withg_slist_free()when it is no longer required.g_slist_free()when it is no longer required.[transfer container][element-type NMConnection]
nm_device_connection_valid ()
-gboolean +gboolean nm_device_connection_valid (+NMDevice *device, -NMConnection *connection);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@@ -1773,7 +1773,7 @@ against@@ -1782,17 +1782,17 @@ against - connection
an NMConnection to validate against
device+an NMConnection to validate against
device
nm_device_connection_compatible ()
-gboolean +gboolean nm_device_connection_compatible (+NMDevice *device, -NMConnection *connection, -GError **error);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@@ -1821,13 +1821,13 @@ against- connection
an NMConnection to validate against
device+an NMConnection to validate against
device@@ -1835,16 +1835,16 @@ against - error
+
nm_device_get_setting_type ()
-GType +GType nm_device_get_setting_type (-NMDevice *device);Gets the (primary) NMSetting subtype associated with connections +
Gets the (primary) NMSetting subtype associated with connections that can be used on
device.@@ -1865,7 +1865,7 @@ that can be used on@@ -1874,8 +1874,8 @@ that can be used ondeviceSince: 0.9.10
deviceNMDeviceDeactivateFn ()
void (*NMDeviceDeactivateFn) (+NMDevice *device, -GError *error, -gpointer user_data);GError *error, +gpointer user_data);
NMDeviceDeactivateFnis deprecated and should not be used in newly-written code.device
The
-“autoconnect”property“autoconnect” gboolean+“autoconnect” gbooleanWhether the device can auto-activate a connection.
Flags: Read / Write
Default value: TRUE
@@ -2089,7 +2089,7 @@ that can be used ondevice
The
-“capabilities”property“capabilities” guint+“capabilities” guintThe capabilities of the device.
Flags: Read
Default value: 0
@@ -2097,7 +2097,7 @@ that can be used ondevice
The
-“device-type”property“device-type” guint+“device-type” guintThe numeric type of the device.
Flags: Read
Default value: 0
@@ -2119,7 +2119,7 @@ that can be used ondevice
The
-“driver”property“driver” gchar *+“driver” gchar *The driver of the device.
Flags: Read
Default value: NULL
@@ -2127,7 +2127,7 @@ that can be used ondevice
The
-“driver-version”property“driver-version” gchar *+“driver-version” gchar *The version of the device driver.
Flags: Read
Default value: NULL
@@ -2135,8 +2135,8 @@ that can be used ondevice
The
-“firmware-missing”property“firmware-missing” gboolean-When
TRUEindicates the device is likely missing firmware required +“firmware-missing” gboolean+When
TRUEindicates the device is likely missing firmware required for its operation.Flags: Read
Default value: FALSE
@@ -2144,7 +2144,7 @@ for its operation.
The
-“firmware-version”property“firmware-version” gchar *+“firmware-version” gchar *The firmware version of the device.
Flags: Read
Default value: NULL
@@ -2152,7 +2152,7 @@ for its operation.
The
-“interface”property“interface” gchar *+“interface” gchar *The interface of the device.
Flags: Read
Default value: NULL
@@ -2160,7 +2160,7 @@ for its operation.
The
-“ip-interface”property“ip-interface” gchar *+“ip-interface” gchar *The IP interface of the device which should be used for all IP-related operations like addressing and routing.
Flags: Read
@@ -2183,7 +2183,7 @@ operations like addressing and routing.
The
-“managed”property“managed” gboolean+“managed” gbooleanWhether the device is managed by NetworkManager.
Flags: Read
Default value: FALSE
@@ -2191,7 +2191,7 @@ operations like addressing and routing.
The
-“mtu”property“mtu” guint+“mtu” guintThe MTU of the device.
Flags: Read
Default value: 1500
@@ -2200,7 +2200,7 @@ operations like addressing and routing.
The
-“physical-port-id”property“physical-port-id” gchar *+“physical-port-id” gchar *The physical port ID of the device. (See
nm_device_get_physical_port_id().)Flags: Read
@@ -2210,7 +2210,7 @@ operations like addressing and routing.
The
-“product”property“product” gchar *+“product” gchar *The product string of the device.
Flags: Read
Default value: NULL
@@ -2218,7 +2218,7 @@ operations like addressing and routing.
+The
-“real”property“real” gboolean+“real” gbooleanWhether the device is real or is a placeholder device that could be created automatically by NetworkManager if one of its “available-connections” was activated.
@@ -2229,7 +2229,7 @@ be created automatically by NetworkManager if one of its
The
-“state”property“state” guint+“state” guintThe state of the device.
Flags: Read
Default value: 0
@@ -2244,7 +2244,7 @@ be created automatically by NetworkManager if one of its
The
-“udi”property“udi” gchar *+“udi” gchar *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) @@ -2257,7 +2257,7 @@ request more information about the device from those services.
-The
-“vendor”property“vendor” gchar *+“vendor” gchar *The vendor string of the device.
Flags: Read
Default value: NULL
@@ -2269,10 +2269,10 @@ request more information about the device from those services.The
“state-changed”signalvoid user_function (NMDevice *device, - guint new_state, - guint old_state, - guint reason, - gpointer user_data)+ guint new_state, + guint old_state, + guint reason, + gpointer user_data)Notifies the state change of a NMDevice.
Flags: Run First
+Flags: Run First
Generated by GTK-Doc V1.28