Top | ![]() |
![]() |
![]() |
![]() |
NMActiveConnection * | active-connection | Read |
gboolean | autoconnect | Read / Write |
NMObjectArray * | available-connections | Read |
guint | capabilities | Read |
guint | device-type | Read |
NMDHCP4Config * | dhcp4-config | Read |
NMDHCP6Config * | dhcp6-config | Read |
gchar * | driver | Read |
gchar * | driver-version | Read |
gboolean | firmware-missing | Read |
gchar * | firmware-version | Read |
gchar * | interface | Read |
gchar * | ip-interface | Read |
NMIP4Config * | ip4-config | Read |
NMIP6Config * | ip6-config | Read |
gboolean | managed | Read |
gchar * | product | Read |
guint | state | Read |
GValueArray_guint+guint_* | state-reason | Read |
gchar * | udi | Read |
gchar * | vendor | Read |
#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 |
GObject ╰── NMObject ╰── NMDevice ├── NMDeviceEthernet ├── NMDeviceWifi ├── NMDeviceModem ├── NMDeviceBt ├── NMDeviceWimax ├── NMDeviceOlpcMesh ├── NMDeviceAdsl ├── NMDeviceInfiniband ├── NMDeviceBond ├── NMDeviceBridge ╰── NMDeviceVlan
GObject * nm_device_new (DBusGConnection *connection
,const char *path
);
Creates a new NMDevice.
const char *
nm_device_get_iface (NMDevice *device
);
Gets the interface name of the NMDevice.
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.
NMDeviceType
nm_device_get_device_type (NMDevice *device
);
Returns the numeric type of the NMDevice, ie ethernet, wifi, etc.
const char *
nm_device_get_udi (NMDevice *device
);
Gets the Unique Device Identifier of the NMDevice.
const char *
nm_device_get_driver (NMDevice *device
);
Gets the driver of the NMDevice.
const char *
nm_device_get_driver_version (NMDevice *device
);
Gets the driver version of the NMDevice.
const char *
nm_device_get_firmware_version (NMDevice *device
);
Gets the firmware version of the NMDevice.
NMDeviceCapabilities
nm_device_get_capabilities (NMDevice *device
);
Gets the device' capabilities.
gboolean
nm_device_get_managed (NMDevice *device
);
Whether the NMDevice is managed by NetworkManager.
gboolean
nm_device_get_autoconnect (NMDevice *device
);
Whether the NMDevice can be autoconnected.
void nm_device_set_autoconnect (NMDevice *device
,gboolean autoconnect
);
Enables or disables automatic activation of the NMDevice.
gboolean
nm_device_get_firmware_missing (NMDevice *device
);
Indicates that firmware required for the device's operation is likely to be missing.
NMIP4Config *
nm_device_get_ip4_config (NMDevice *device
);
Gets the current NMIP4Config associated with the NMDevice.
NMDHCP4Config *
nm_device_get_dhcp4_config (NMDevice *device
);
Gets the current NMDHCP4Config associated with the NMDevice.
NMIP6Config *
nm_device_get_ip6_config (NMDevice *device
);
Gets the current NMIP6Config associated with the NMDevice.
NMDHCP6Config *
nm_device_get_dhcp6_config (NMDevice *device
);
Gets the current NMDHCP6Config associated with the NMDevice.
NMDeviceState
nm_device_get_state (NMDevice *device
);
Gets the current NMDevice state.
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).
NMActiveConnection *
nm_device_get_active_connection (NMDevice *device
);
Gets the NMActiveConnection object which owns this device during activation.
the NMActiveConnection or NULL
if the device is
not part of an active connection.
[transfer none]
const GPtrArray *
nm_device_get_available_connections (NMDevice *device
);
Gets the NMRemoteConnections currently known to the daemon that could
be activated on device
.
the GPtrArray containing NMRemoteConnections. This is the internal copy used by the connection, and must not be modified.
[element-type NMClient.RemoteConnection]
Since 0.9.8
const char *
nm_device_get_product (NMDevice *device
);
Gets the product string of the NMDevice.
const char *
nm_device_get_vendor (NMDevice *device
);
Gets the vendor string of the NMDevice.
void (*NMDeviceDeactivateFn) (NMDevice *device
,GError *error
,gpointer user_data
);
void nm_device_disconnect (NMDevice *device
,NMDeviceDeactivateFn 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.
device |
a NMDevice |
|
callback |
callback to be called when disconnect operation completes. |
[scope async][allow-none] |
user_data |
caller-specific data passed to |
[closure] |
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 WiFi device that supports only WEP encryption, the returned list will
contain any WiFi connections in connections
that allow connection to
unencrypted or WEP-enabled SSIDs. The returned list will not contain
Ethernet, Bluetooth, WiFi 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()
.
device |
an NMDevice to filter connections for |
|
connections |
a list of NMConnection objects to filter. |
[element-type NetworkManager.Connection] |
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 NetworkManager.Connection]
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 WiFi device that supports only WEP encryption, the connection
will only be valid if it is a WiFi 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 |
an NMDevice to validate |
|
connection |
an NMConnection to validate against |
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 WiFi device that supports only WEP encryption, the connection
will only be valid if it is a WiFi 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
compatibility of the given device and connection. But, in addition, it sets
GError when FALSE is returned.
“active-connection”
property“active-connection” NMActiveConnection *
Active Connection.
Flags: Read
“autoconnect”
property“autoconnect” gboolean
Autoconnect.
Flags: Read / Write
Default value: TRUE
“available-connections”
property “available-connections” NMObjectArray *
Available Connections.
Flags: Read
Since 0.9.8
“device-type”
property“device-type” guint
Numeric device type (ie ethernet, wifi, etc).
Flags: Read
Default value: 0
“driver-version”
property“driver-version” gchar *
Driver Version.
Flags: Read
Default value: NULL
“firmware-missing”
property“firmware-missing” gboolean
Firmware missing.
Flags: Read
Default value: FALSE
“firmware-version”
property“firmware-version” gchar *
Firmware Version.
Flags: Read
Default value: NULL
“ip-interface”
property“ip-interface” gchar *
IP Interface name.
Flags: Read
Default value: NULL