Top |
Functions
Properties
NMRemoteConnection * | connection | Read |
gboolean | default | Read |
gboolean | default6 | Read |
GPtrArray * | devices | Read |
NMDhcpConfig * | dhcp4-config | Read |
NMDhcpConfig * | dhcp6-config | Read |
gchar * | id | Read |
NMIPConfig * | ip4-config | Read |
NMIPConfig * | ip6-config | Read |
NMDevice * | master | Read |
gchar * | specific-object-path | Read |
NMActiveConnectionState | state | Read |
guint | state-flags | Read |
gchar * | type | Read |
gchar * | uuid | Read |
gboolean | vpn | Read |
Types and Values
#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_STATE_FLAGS |
#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 |
Functions
nm_active_connection_get_connection ()
NMRemoteConnection *
nm_active_connection_get_connection (NMActiveConnection *connection
);
Gets the NMRemoteConnection associated with connection
.
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.
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.
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.
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
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
connection, then the specific object will be an NMAccessPoint, and you can
resolve it with nm_device_wifi_get_access_point_by_path()
.)
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_state ()
NMActiveConnectionState
nm_active_connection_get_state (NMActiveConnection *connection
);
Gets the active connection's state.
nm_active_connection_get_state_flags ()
NMActivationStateFlags
nm_active_connection_get_state_flags (NMActiveConnection *connection
);
Gets the active connection's state flags.
Since: 1.10
nm_active_connection_get_state_reason ()
NMActiveConnectionStateReason
nm_active_connection_get_state_reason (NMActiveConnection *connection
);
Gets the reason for active connection's state.
Since: 1.8
nm_active_connection_get_master ()
NMDevice *
nm_active_connection_get_master (NMActiveConnection *connection
);
Gets the master NMDevice of the connection.
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_ip4_config ()
NMIPConfig *
nm_active_connection_get_ip4_config (NMActiveConnection *connection
);
Gets the current IPv4 NMIPConfig associated with the 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.
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_ip6_config ()
NMIPConfig *
nm_active_connection_get_ip6_config (NMActiveConnection *connection
);
Gets the current IPv6 NMIPConfig associated with the 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.
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.
Types and Values
NM_ACTIVE_CONNECTION_SPECIFIC_OBJECT_PATH
#define NM_ACTIVE_CONNECTION_SPECIFIC_OBJECT_PATH "specific-object-path"
Property Details
The “connection”
property
“connection” NMRemoteConnection *
The connection that this is an active instance of.
Flags: Read
The “default”
property
“default” gboolean
Whether the active connection is the default IPv4 one.
Flags: Read
Default value: FALSE
The “default6”
property
“default6” gboolean
Whether the active connection is the default IPv6 one.
Flags: Read
Default value: FALSE
The “devices”
property
“devices” GPtrArray *
The devices of the active connection.
Element-type: NMDevice
Flags: Read
The “dhcp4-config”
property
“dhcp4-config” NMDhcpConfig *
The IPv4 NMDhcpConfig of the connection.
Flags: Read
The “dhcp6-config”
property
“dhcp6-config” NMDhcpConfig *
The IPv6 NMDhcpConfig of the connection.
Flags: Read
The “ip4-config”
property
“ip4-config” NMIPConfig *
The IPv4 NMIPConfig of the connection.
Flags: Read
The “ip6-config”
property
“ip6-config” NMIPConfig *
The IPv6 NMIPConfig of the connection.
Flags: Read
The “specific-object-path”
property
“specific-object-path” gchar *
The path to the "specific object" of the active connection; see
nm_active_connection_get_specific_object_path()
for more details.
Flags: Read
Default value: NULL
The “state”
property
“state” NMActiveConnectionState
The state of the active connection.
Flags: Read
Default value: NM_ACTIVE_CONNECTION_STATE_UNKNOWN
The “state-flags”
property
“state-flags” guint
The state flags of the active connection.
Flags: Read
Default value: 0
Since: 1.10
The “vpn”
property
“vpn” gboolean
Whether the active connection is a VPN connection.
Flags: Read
Default value: FALSE
Signal Details
The “state-changed”
signal
void user_function (NMActiveConnection *nmactiveconnection, guint arg1, guint arg2, gpointer user_data)
Flags: Run First