![]() |
![]() |
![]() |
libnm-glib Reference Manual | ![]() |
---|---|---|---|---|
Top | Description | Object Hierarchy | Implemented Interfaces | Properties |
#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
);
"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
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;
GObject * nm_active_connection_new (DBusGConnection *connection
,const char *path
);
Creates a new NMActiveConnection.
|
the DBusGConnection |
|
the DBus object path of the device |
Returns : |
a new active connection. [transfer full] |
const char * nm_active_connection_get_connection (NMActiveConnection *connection
);
Gets the NMConnection's DBus object path.
|
a NMActiveConnection |
Returns : |
the object path of the NMConnection inside of NMActiveConnection. This is the internal string used by the connection, and must not be modified. |
const char * nm_active_connection_get_id (NMActiveConnection *connection
);
Gets the NMConnection's ID.
|
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
const char * nm_active_connection_get_uuid (NMActiveConnection *connection
);
Gets the NMConnection's UUID.
|
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. |
const char * nm_active_connection_get_connection_type
(NMActiveConnection *connection
);
Gets the NMConnection's type.
|
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
const char * nm_active_connection_get_specific_object
(NMActiveConnection *connection
);
Gets the "specific object" used at the activation.
|
a NMActiveConnection |
Returns : |
the specific object's DBus path. This is the internal string used by the connection, and must not be modified. |
const GPtrArray * nm_active_connection_get_devices (NMActiveConnection *connection
);
Gets the NMDevices used for the active connections.
|
a NMActiveConnection |
Returns : |
the GPtrArray containing NMDevices. This is the internal copy used by the connection, and must not be modified. [element-type NMClient.Device] |
NMActiveConnectionState nm_active_connection_get_state (NMActiveConnection *connection
);
Gets the active connection's state.
|
a NMActiveConnection |
Returns : |
the state |
const char * nm_active_connection_get_master (NMActiveConnection *connection
);
Gets the path to the master NMDevice of the 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. |
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).
|
a NMActiveConnection |
Returns : |
TRUE if the active connection is the default IPv4 connection |
NMIP4Config * nm_active_connection_get_ip4_config (NMActiveConnection *connection
);
Gets the current NMIP4Config associated with the NMActiveConnection.
|
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
NMDHCP4Config * nm_active_connection_get_dhcp4_config
(NMActiveConnection *connection
);
Gets the current NMDHCP4Config (if any) associated with the NMActiveConnection.
|
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
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).
|
a NMActiveConnection |
Returns : |
TRUE if the active connection is the default IPv6 connection |
NMIP6Config * nm_active_connection_get_ip6_config (NMActiveConnection *connection
);
Gets the current NMIP6Config associated with the NMActiveConnection.
|
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
NMDHCP6Config * nm_active_connection_get_dhcp6_config
(NMActiveConnection *connection
);
Gets the current NMDHCP6Config (if any) associated with the NMActiveConnection.
|
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
gboolean nm_active_connection_get_vpn (NMActiveConnection *connection
);
Whether the active connection is a VPN connection.
|
a NMActiveConnection |
Returns : |
TRUE if the active connection is a VPN connection |
Since 0.9.10
"connection"
property"connection" gchar* : Read
The connection's path of the active connection.
Default value: NULL
"default"
property"default" gboolean : Read
Whether the active connection is the default IPv4 one.
Default value: FALSE
"default6"
property"default6" gboolean : Read
Whether the active connection is the default IPv6 one.
Default value: FALSE
"dhcp4-config"
property"dhcp4-config" NMDHCP4Config* : Read
The NMDHCP4Config of the connection.
Since 0.9.10
"dhcp6-config"
property"dhcp6-config" NMDHCP6Config* : Read
The NMDHCP6Config of the connection.
Since 0.9.10
"ip4-config"
property"ip4-config" NMIP4Config* : Read
The NMIP4Config of the connection.
Since 0.9.10
"ip6-config"
property"ip6-config" NMIP6Config* : Read
The NMIP6Config of the connection.
Since 0.9.10
"master"
property"master" gchar* : Read
The path of the master device if one exists.
Default value: NULL
"specific-object"
property"specific-object" gchar* : Read
The specific object's path of the active connection.
Default value: NULL
"state"
property"state" guint : Read
The state of the active connection.
Allowed values: <= 3
Default value: 0
"type"
property"type" gchar* : Read
The active connection's type
Default value: NULL
Since 0.9.10
"vpn"
property"vpn" gboolean : Read
Whether the active connection is a VPN connection.
Default value: FALSE
Since 0.9.10