Efl.Net.Session (class)

Description

Used by application to request network connectivity.

This API is targeted at applications that need access to the network, specifying the allowed bearer technologies to connect to the internet, as well as whether local networking is enough or validated internet access is required.

Some platforms may not implement the backend for this class. In this cases the system will report always Efl.Net.Session.state "online" (Efl.Net.Session_State.online) and other properties will be NULL, such as Efl.Net.Session.network_name, Efl.Net.Session.interface, Efl.Net.Session.ipv4 and Efl.Net.Session.ipv6; as well as Efl.Net.Session.technology is set to Efl.Net.Session_Technology.unknown. As such if you need to detect for an actual backend, check if the state is online but those properties are NULL or technology is unknown.

the Efl.Net.Session.connect method is subject to backend policy. For instance, ConnMan uses https://github.com/aldebaran/connman/blob/master/doc/session-policy-format.txt

Inheritance

Members

connect

Asks the session to be connected.
void efl_net_session_connect(Eo *obj, Eina_Bool online_required, Efl_Net_Session_Technology technologies_allowed);


constructor [Overridden from Efl.Object]

Implement this method to provide optional initialization code for your object.
Efl_Object *efl_constructor(Eo *obj);


destructor [Overridden from Efl.Object]

Implement this method to provide deinitialization code for your object if you need it.
void efl_destructor(Eo *obj);


disconnect

Indicates this session doesn't need a connection anymore.
void efl_net_session_disconnect(Eo *obj);


finalize [Overridden from Efl.Object]

Implement this method to finish the initialization of your object after all (if any) user-provided configuration methods have been executed.
Efl_Object *efl_finalize(Eo *obj);


interface (get)

const char *efl_net_session_interface_get(const Eo *obj);


ipv4 (get)

void efl_net_session_ipv4_get(const Eo *obj, const char **address, const char **netmask, const char **gateway);


ipv6 (get)

void efl_net_session_ipv6_get(const Eo *obj, const char **address, uint8_t *prefix_length, const char **netmask, const char **gateway);


network_name (get)

const char *efl_net_session_network_name_get(const Eo *obj);


state (get)

Efl_Net_Session_State efl_net_session_state_get(const Eo *obj);


technology (get)

Efl_Net_Session_Technology efl_net_session_technology_get(const Eo *obj);


Inherited

Efl.Loop_Consumer
future_rejected Creates a new future that is already rejected to a specified error using the Efl.Loop_Consumer.loop.get.
future_resolved Creates a new future that is already resolved to a value.
loop (get)
parent (get, set) The parent of an object.
promise_new Create a new promise with the scheduler coming from the loop provided by this object.
Efl.Object
allow_parent_unref (get, set) Allow an object to be deleted by unref even if it has a parent.
children_iterator_new Get an iterator on all children.
comment (get, set) A human readable comment for the object.
composite_attach Make an object a composite object of another.
composite_detach Detach a composite object from another object.
composite_part_is Check if an object is part of a composite object.
debug_name_override Build a read-only name for this object used for debugging.
event_callback_forwarder_del Remove an event callback forwarder for a specified event and object.
event_callback_forwarder_priority_add Add an event callback forwarder that will make this object emit an event whenever another object (source) emits it. The event is said to be forwarded from source to this object.
event_callback_stop Stop the current callback call.
event_freeze Freeze events of this object.
event_freeze_count (get)
static event_global_freeze Globally freeze events for ALL EFL OBJECTS.
static event_global_freeze_count (get)
static event_global_thaw Globally thaw events for ALL EFL OBJECTS.
event_thaw Thaw events of object.
finalized (get)
invalidate Implement this method to perform special actions when your object loses its parent, if you need to.
invalidated (get)
invalidating (get)
name (get, set) The name of the object.
name_find Find a child object with the given name and return it.
provider_find Searches upwards in the object tree for a provider which knows the given class/interface.
provider_register Will register a manager of a specific class to be answered by Efl.Object.provider_find.
provider_unregister Will unregister a manager of a specific class that was previously registered and answered by Efl.Object.provider_find.

Events

changed

Called when some properties were changed.
EFL_NET_SESSION_EVENT_CHANGED(void)


Inherited

Efl.Object
del Object is being deleted. See Efl.Object.destructor.
destruct Object has been fully destroyed. It can not be used beyond this point. This event should only serve to clean up any reference you keep to the object.
invalidate Object is being invalidated and losing its parent. See Efl.Object.invalidate.
noref Object has lost its last reference, only parent relationship is keeping it alive. Advanced usage.
ownership,shared Object has acquired a second reference. It has multiple owners now. Triggered whenever increasing the refcount from one to two, it will not trigger by further increasing the refcount beyond two.
ownership,unique Object has lost a reference and only one is left. It has just one owner now. Triggered whenever the refcount goes from two to one.