#include "e_connman_private.h"

Functions | |
Eina_Bool | e_connman_service_auto_connect_get (const E_Connman_Element *service, Eina_Bool *auto_connect) |
Eina_Bool | e_connman_service_auto_connect_set (E_Connman_Element *service, Eina_Bool auto_connect, E_DBus_Method_Return_Cb cb, const void *data) |
Eina_Bool | e_connman_service_clear_property (E_Connman_Element *service, const char *property, E_DBus_Method_Return_Cb cb, const void *data) |
Eina_Bool | e_connman_service_connect (E_Connman_Element *service, E_DBus_Method_Return_Cb cb, const void *data) |
Eina_Bool | e_connman_service_disconnect (E_Connman_Element *service, E_DBus_Method_Return_Cb cb, const void *data) |
Eina_Bool | e_connman_service_domains_configuration_get (const E_Connman_Element *service, unsigned int *count, const char ***domains) |
Eina_Bool | e_connman_service_domains_configuration_set (E_Connman_Element *service, unsigned int count, const char **domains, E_DBus_Method_Return_Cb cb, const void *data) |
Eina_Bool | e_connman_service_domains_get (const E_Connman_Element *service, unsigned int *count, const char ***domains) |
Eina_Bool | e_connman_service_error_get (const E_Connman_Element *service, const char **error) |
Eina_Bool | e_connman_service_ethernet_address_get (const E_Connman_Element *service, const char **address) |
Eina_Bool | e_connman_service_ethernet_duplex_get (const E_Connman_Element *service, const char **duplex) |
Eina_Bool | e_connman_service_ethernet_interface_get (const E_Connman_Element *service, const char **iface) |
Eina_Bool | e_connman_service_ethernet_method_get (const E_Connman_Element *service, const char **method) |
Eina_Bool | e_connman_service_ethernet_mtu_get (const E_Connman_Element *service, unsigned short *mtu) |
Eina_Bool | e_connman_service_ethernet_speed_get (const E_Connman_Element *service, unsigned short *speed) |
Eina_Bool | e_connman_service_favorite_get (const E_Connman_Element *service, Eina_Bool *favorite) |
E_Connman_Element * | e_connman_service_get (const char *path) |
Eina_Bool | e_connman_service_immutable_get (const E_Connman_Element *service, Eina_Bool *immutable) |
Eina_Bool | e_connman_service_ipv4_address_get (const E_Connman_Element *service, const char **address) |
Eina_Bool | e_connman_service_ipv4_configuration_address_get (const E_Connman_Element *service, const char **address) |
Eina_Bool | e_connman_service_ipv4_configuration_gateway_get (const E_Connman_Element *service, const char **gateway) |
Eina_Bool | e_connman_service_ipv4_configuration_method_get (const E_Connman_Element *service, const char **method) |
Eina_Bool | e_connman_service_ipv4_configuration_netmask_get (const E_Connman_Element *service, const char **netmask) |
Eina_Bool | e_connman_service_ipv4_configure_dhcp (E_Connman_Element *service, E_DBus_Method_Return_Cb cb, const void *data) |
Eina_Bool | e_connman_service_ipv4_configure_manual (E_Connman_Element *service, const char *address, const char *netmask, const char *gateway, E_DBus_Method_Return_Cb cb, const void *data) |
Eina_Bool | e_connman_service_ipv4_gateway_get (const E_Connman_Element *service, const char **gateway) |
Eina_Bool | e_connman_service_ipv4_method_get (const E_Connman_Element *service, const char **method) |
Eina_Bool | e_connman_service_ipv4_netmask_get (const E_Connman_Element *service, const char **netmask) |
Eina_Bool | e_connman_service_login_required_get (const E_Connman_Element *service, Eina_Bool *login_required) |
Eina_Bool | e_connman_service_move_after (E_Connman_Element *service, const char *object_path, E_DBus_Method_Return_Cb cb, const void *data) |
Eina_Bool | e_connman_service_move_before (E_Connman_Element *service, const char *object_path, E_DBus_Method_Return_Cb cb, const void *data) |
Eina_Bool | e_connman_service_name_get (const E_Connman_Element *service, const char **name) |
Eina_Bool | e_connman_service_nameservers_configuration_get (const E_Connman_Element *service, unsigned int *count, const char ***nameservers) |
Eina_Bool | e_connman_service_nameservers_configuration_set (E_Connman_Element *service, unsigned int count, const char **nameservers, E_DBus_Method_Return_Cb cb, const void *data) |
Eina_Bool | e_connman_service_nameservers_get (const E_Connman_Element *service, unsigned int *count, const char ***nameservers) |
Eina_Bool | e_connman_service_passphrase_get (const E_Connman_Element *service, const char **passphrase) |
Eina_Bool | e_connman_service_passphrase_required_get (const E_Connman_Element *service, Eina_Bool *passphrase_required) |
Eina_Bool | e_connman_service_passphrase_set (E_Connman_Element *service, const char *passphrase, E_DBus_Method_Return_Cb cb, const void *data) |
Eina_Bool | e_connman_service_proxy_configuration_excludes_get (const E_Connman_Element *service, unsigned int *count, const char ***excludes) |
Eina_Bool | e_connman_service_proxy_configuration_method_get (const E_Connman_Element *service, const char **method) |
Eina_Bool | e_connman_service_proxy_configuration_servers_get (const E_Connman_Element *service, unsigned int *count, const char ***servers) |
Eina_Bool | e_connman_service_proxy_configuration_url_get (const E_Connman_Element *service, const char **url) |
Eina_Bool | e_connman_service_proxy_excludes_get (const E_Connman_Element *service, unsigned int *count, const char ***excludes) |
Eina_Bool | e_connman_service_proxy_method_get (const E_Connman_Element *service, const char **method) |
Eina_Bool | e_connman_service_proxy_servers_get (const E_Connman_Element *service, unsigned int *count, const char ***servers) |
Eina_Bool | e_connman_service_proxy_url_get (const E_Connman_Element *service, const char **url) |
Eina_Bool | e_connman_service_remove (E_Connman_Element *service, E_DBus_Method_Return_Cb cb, const void *data) |
Eina_Bool | e_connman_service_roaming_get (const E_Connman_Element *service, Eina_Bool *roaming) |
Eina_Bool | e_connman_service_security_get (const E_Connman_Element *service, unsigned int *count, const char ***security) |
Eina_Bool | e_connman_service_state_get (const E_Connman_Element *service, const char **state) |
Eina_Bool | e_connman_service_strength_get (const E_Connman_Element *service, unsigned char *strength) |
Eina_Bool | e_connman_service_type_get (const E_Connman_Element *service, const char **type) |
Function Documentation
◆ e_connman_service_auto_connect_get()
Eina_Bool e_connman_service_auto_connect_get | ( | const E_Connman_Element * | service, |
Eina_Bool * | auto_connect | ||
) |
Get property "AutoConnect" value.
If this property isn't found then EINA_FALSE
is returned. If EINA_FALSE
is returned, then this call failed and parameter-returned values shall be considered invalid.
If set to true, this service will auto-connect when not other connection is available.
For favorite services it is possible to change this value to prevent or permit automatic connection attempts.
- Parameters
-
service path to get property. auto_connect where to store the property value, must be a pointer to Eina_Bool (Eina_Bool *).
- Returns
EINA_TRUE
on success,EINA_FALSE
otherwise.
References e_connman_element_property_get_stringshared(), and e_connman_prop_auto_connect.
◆ e_connman_service_domains_configuration_get()
Eina_Bool e_connman_service_domains_configuration_get | ( | const E_Connman_Element * | service, |
unsigned int * | count, | ||
const char *** | domains | ||
) |
Get property "Domains.Configuration" value.
If this property isn't found then EINA_FALSE
is returned. If EINA_FALSE
is returned, then this call failed and parameter-returned values shall be considered invalid. The list of currently active domains for this service. If the server is not in READY or ONLINE state than this list will be empty.
Unlike Domains, this is the user-set value, rather than the actual value.
- Parameters
-
service path to get property. count return the number of elements in array. domains array with pointers to internal strings. These strings are not copied in any way, and they are granted to be eina_stringshare instances, so one can use eina_stringshare_ref() if he wants to save memory and cpu to get an extra reference. The array itself is also NOT allocated or copied, do not modify it. This pointer is just set if return is EINA_TRUE
.
- Returns
EINA_TRUE
on success,EINA_FALSE
otherwise.
References e_connman_element_strings_array_get_stringshared(), and e_connman_prop_domains_configuration.
◆ e_connman_service_domains_configuration_set()
Eina_Bool e_connman_service_domains_configuration_set | ( | E_Connman_Element * | service, |
unsigned int | count, | ||
const char ** | domains, | ||
E_DBus_Method_Return_Cb | cb, | ||
const void * | data | ||
) |
Set property "Domains.Configuration" value.
If this property isn't found then EINA_FALSE
is returned. If EINA_FALSE
is returned, then this call failed and parameter-returned values shall be considered invalid.
Unlike Domains, this is the user-set value, rather than the actual value. It allows user to override the default setting. When using manual configuration and no global domains are configured, then it is useful to configure this setting as well.
This list is sorted by priority and the first entry represents the nameserver with the highest priority.
Changes to the domain name servers can be done at any time. It will not cause a disconnect of the service. However there might be small window where name resolution might fail.
- Parameters
-
service path to set property. count number of elements in domain. domains sorted list of the current domains. The first one has the highest priority and is used by default. cb function to call when server replies or some error happens. data data to give to cb when it is called.
- Returns
EINA_TRUE
on success,EINA_FALSE
otherwise.
References e_connman_element_property_array_set_full(), and e_connman_prop_domains_configuration.
◆ e_connman_service_domains_get()
Eina_Bool e_connman_service_domains_get | ( | const E_Connman_Element * | service, |
unsigned int * | count, | ||
const char *** | domains | ||
) |
Get property "Domains" value.
If this property isn't found then EINA_FALSE
is returned. If EINA_FALSE
is returned, then this call failed and parameter-returned values shall be considered invalid. The list of currently active domains for this service. If the server is not in READY or ONLINE state than this list will be empty.
The list of currently used search domains.
- Parameters
-
service path to get property. count return the number of elements in array. domains array with pointers to internal strings. These strings are not copied in any way, and they are granted to be eina_stringshare instances, so one can use eina_stringshare_ref() if he wants to save memory and cpu to get an extra reference. The array itself is also NOT allocated or copied, do not modify it. This pointer is just set if return is EINA_TRUE
.
- Returns
EINA_TRUE
on success,EINA_FALSE
otherwise.
References e_connman_element_strings_array_get_stringshared(), and e_connman_prop_domains.
◆ e_connman_service_error_get()
Eina_Bool e_connman_service_error_get | ( | const E_Connman_Element * | service, |
const char ** | error | ||
) |
Get property "Error" value.
If this property isn't found then EINA_FALSE
is returned. If EINA_FALSE
is returned, then this call failed and parameter-returned values shall be considered invalid.
The service error status details.
When error occur during connection or disconnection the detailed information are represented in this property to help the user interface to present the user with alternate options.
This property is only valid when the service is in the "failure" state. Otherwise it might be empty or not present at all.
Current defined error code is "dhcp-failed".
- Parameters
-
service path to get property. error where to store the property value, must be a pointer to string (const char **), it will not be allocated or copied and references will be valid until element changes, so copy it if you want to use it later.
- Returns
EINA_TRUE
on success,EINA_FALSE
otherwise.
References e_connman_element_property_get_stringshared(), and e_connman_prop_error.
◆ e_connman_service_ethernet_address_get()
Eina_Bool e_connman_service_ethernet_address_get | ( | const E_Connman_Element * | service, |
const char ** | address | ||
) |
Get property "Ethernet.Address" value.
If this property isn't found then EINA_FALSE
is returned. If EINA_FALSE
is returned, then this call failed and parameter-returned values shall be considered invalid.
The current configured Ethernet address (mac-address).
- Parameters
-
service path to get property. address where to store the property value, must be a pointer to string (const char **), it will not be allocated or copied and references will be valid until element changes, so copy it if you want to use it later.
- Returns
EINA_TRUE
on success,EINA_FALSE
otherwise.
References e_connman_element_property_dict_get_stringshared(), e_connman_prop_address, and e_connman_prop_ethernet.
◆ e_connman_service_ethernet_duplex_get()
Eina_Bool e_connman_service_ethernet_duplex_get | ( | const E_Connman_Element * | service, |
const char ** | duplex | ||
) |
Get property "Ethernet.Duplex" value.
If this property isn't found then EINA_FALSE
is returned. If EINA_FALSE
is returned, then this call failed and parameter-returned values shall be considered invalid.
Selected duplex settings of the line. Possible values are "half" and "full". This information might not always be available.
- Parameters
-
service path to get property. duplex where to store the property value, must be a pointer to string (const char **), it will not be allocated or copied and references will be valid until element changes, so copy it if you want to use it later.
- Returns
EINA_TRUE
on success,EINA_FALSE
otherwise.
References e_connman_element_property_dict_get_stringshared(), e_connman_prop_duplex, and e_connman_prop_ethernet.
◆ e_connman_service_ethernet_interface_get()
Eina_Bool e_connman_service_ethernet_interface_get | ( | const E_Connman_Element * | service, |
const char ** | iface | ||
) |
Get property "Ethernet.Interface" value.
If this property isn't found then EINA_FALSE
is returned. If EINA_FALSE
is returned, then this call failed and parameter-returned values shall be considered invalid.
Interface name (for example eth0).
- Parameters
-
service path to get property. iface where to store the property value, must be a pointer to string (const char **), it will not be allocated or copied and references will be valid until element changes, so copy it if you want to use it later.
- Returns
EINA_TRUE
on success,EINA_FALSE
otherwise.
References e_connman_element_property_dict_get_stringshared(), e_connman_prop_ethernet, and e_connman_prop_interface.
◆ e_connman_service_ethernet_method_get()
Eina_Bool e_connman_service_ethernet_method_get | ( | const E_Connman_Element * | service, |
const char ** | method | ||
) |
Get property "Ethernet.Method" value.
If this property isn't found then EINA_FALSE
is returned. If EINA_FALSE
is returned, then this call failed and parameter-returned values shall be considered invalid.
The Ethernet configuration method. Possible values here "auto" and "manual".
- Parameters
-
service path to get property. method where to store the property value, must be a pointer to string (const char **), it will not be allocated or copied and references will be valid until element changes, so copy it if you want to use it later.
- Returns
EINA_TRUE
on success,EINA_FALSE
otherwise.
References e_connman_element_property_dict_get_stringshared(), e_connman_prop_ethernet, and e_connman_prop_method.
◆ e_connman_service_ethernet_mtu_get()
Eina_Bool e_connman_service_ethernet_mtu_get | ( | const E_Connman_Element * | service, |
unsigned short * | mtu | ||
) |
Get property "Ethernet.MTU" value.
If this property isn't found then EINA_FALSE
is returned. If EINA_FALSE
is returned, then this call failed and parameter-returned values shall be considered invalid.
The current configured Ethernet MTU.
- Parameters
-
service path to get property. gateway where to store the property value, must be a pointer to string (const char **), it will not be allocated or copied and references will be valid until element changes, so copy it if you want to use it later.
- Returns
EINA_TRUE
on success,EINA_FALSE
otherwise.
References e_connman_element_property_dict_get_stringshared(), e_connman_prop_ethernet, and e_connman_prop_mtu.
◆ e_connman_service_ethernet_speed_get()
Eina_Bool e_connman_service_ethernet_speed_get | ( | const E_Connman_Element * | service, |
unsigned short * | speed | ||
) |
Get property "Ethernet.Speed" value.
If this property isn't found then EINA_FALSE
is returned. If EINA_FALSE
is returned, then this call failed and parameter-returned values shall be considered invalid.
Selected speed of the line. This information might not always be available.
- Parameters
-
service path to get property. speed where to store the property value.
- Returns
EINA_TRUE
on success,EINA_FALSE
otherwise.
References e_connman_element_property_dict_get_stringshared(), e_connman_prop_ethernet, and e_connman_prop_speed.
◆ e_connman_service_favorite_get()
Eina_Bool e_connman_service_favorite_get | ( | const E_Connman_Element * | service, |
Eina_Bool * | favorite | ||
) |
Get property "Favorite" value.
If this property isn't found then EINA_FALSE
is returned. If EINA_FALSE
is returned, then this call failed and parameter-returned values shall be considered invalid.
Will be true if a cable is plugged in or the user selected and successfully connected to this service.
This value is automatically changed and to revert it back to false the Remove() method needs to be used.
- Parameters
-
service path to get property. favorite where to store the property value, must be a pointer to Eina_Bool (Eina_Bool *).
- Returns
EINA_TRUE
on success,EINA_FALSE
otherwise.
References e_connman_element_property_get_stringshared(), and e_connman_prop_favorite.
◆ e_connman_service_immutable_get()
Eina_Bool e_connman_service_immutable_get | ( | const E_Connman_Element * | service, |
Eina_Bool * | immutable | ||
) |
Get property "Immutable" value.
This value will be set to true if the service is configured externally via a configuration file.
The only valid operation are e_connman_service_connect() and e_connman_service_disconnect(). The e_connman_service_remove() method will result in an error.
- Parameters
-
service path to get property. immutable where to store the property value, must be a pointer to Eina_Bool (Eina_Bool *).
- Returns
EINA_TRUE
on success,EINA_FALSE
otherwise.
References e_connman_element_property_get_stringshared(), and e_connman_prop_immutable.
◆ e_connman_service_ipv4_address_get()
Eina_Bool e_connman_service_ipv4_address_get | ( | const E_Connman_Element * | service, |
const char ** | address | ||
) |
Get property "IPv4.Address" value.
If this property isn't found then EINA_FALSE
is returned. If EINA_FALSE
is returned, then this call failed and parameter-returned values shall be considered invalid.
The current IPv4 address.
- Parameters
-
service path to get property. address where to store the property value, must be a pointer to string (const char **), it will not be allocated or copied and references will be valid until element changes, so copy it if you want to use it later.
- Returns
EINA_TRUE
on success,EINA_FALSE
otherwise.
References e_connman_element_property_dict_get_stringshared(), e_connman_prop_address, and e_connman_prop_ipv4.
◆ e_connman_service_ipv4_configuration_address_get()
Eina_Bool e_connman_service_ipv4_configuration_address_get | ( | const E_Connman_Element * | service, |
const char ** | address | ||
) |
Get property "IPv4.Configuration.Address" value.
Unlike IPv4.Address, this is the user-set value, rather than the actual value.
If this property isn't found then EINA_FALSE
is returned. If EINA_FALSE
is returned, then this call failed and parameter-returned values shall be considered invalid.
The current configured IPv4 address.
- Parameters
-
service path to get property. address where to store the property value, must be a pointer to string (const char **), it will not be allocated or copied and references will be valid until element changes, so copy it if you want to use it later.
- Returns
EINA_TRUE
on success,EINA_FALSE
otherwise.
References e_connman_element_property_dict_get_stringshared(), e_connman_prop_address, and e_connman_prop_ipv4_configuration.
◆ e_connman_service_ipv4_configuration_gateway_get()
Eina_Bool e_connman_service_ipv4_configuration_gateway_get | ( | const E_Connman_Element * | service, |
const char ** | gateway | ||
) |
Get property "IPv4.Configuration.Gateway" value.
Unlike IPv4.Gateway, this is the user-set value, rather than the actual value.
If this property isn't found then EINA_FALSE
is returned. If EINA_FALSE
is returned, then this call failed and parameter-returned values shall be considered invalid.
The current configured IPv4 gateway.
- Parameters
-
service path to get property. gateway where to store the property value, must be a pointer to string (const char **), it will not be allocated or copied and references will be valid until element changes, so copy it if you want to use it later.
- Returns
EINA_TRUE
on success,EINA_FALSE
otherwise.
References e_connman_element_property_dict_get_stringshared(), e_connman_prop_gateway, and e_connman_prop_ipv4_configuration.
◆ e_connman_service_ipv4_configuration_method_get()
Eina_Bool e_connman_service_ipv4_configuration_method_get | ( | const E_Connman_Element * | service, |
const char ** | method | ||
) |
Get property "IPv4.Configuration.Method" value.
Unlike IPv4.Method, this is the user-set value, rather than the actual value.
If this property isn't found then EINA_FALSE
is returned. If EINA_FALSE
is returned, then this call failed and parameter-returned values shall be considered invalid.
The IPv4 configured method. Possible values here are "dhcp" and "static".
- Parameters
-
service path to get property. method where to store the property value, must be a pointer to string (const char **), it will not be allocated or copied and references will be valid until element changes, so copy it if you want to use it later.
- Returns
EINA_TRUE
on success,EINA_FALSE
otherwise.
References e_connman_element_property_dict_get_stringshared(), e_connman_prop_ipv4_configuration, and e_connman_prop_method.
◆ e_connman_service_ipv4_configuration_netmask_get()
Eina_Bool e_connman_service_ipv4_configuration_netmask_get | ( | const E_Connman_Element * | service, |
const char ** | netmask | ||
) |
Get property "IPv4.Configuration.Netmask" value.
Unlike IPv4.Netmask, this is the user-set value, rather than the actual value.
If this property isn't found then EINA_FALSE
is returned. If EINA_FALSE
is returned, then this call failed and parameter-returned values shall be considered invalid.
The current configured IPv4 netmask.
- Parameters
-
service path to get property. netmask where to store the property value, must be a pointer to string (const char **), it will not be allocated or copied and references will be valid until element changes, so copy it if you want to use it later.
- Returns
EINA_TRUE
on success,EINA_FALSE
otherwise.
References e_connman_element_property_dict_get_stringshared(), e_connman_prop_ipv4_configuration, and e_connman_prop_netmask.
◆ e_connman_service_ipv4_configure_manual()
Eina_Bool e_connman_service_ipv4_configure_manual | ( | E_Connman_Element * | service, |
const char * | address, | ||
const char * | netmask, | ||
const char * | gateway, | ||
E_DBus_Method_Return_Cb | cb, | ||
const void * | data | ||
) |
Set IPv4 to connect using manually set parameters.
- Parameters
-
service path to set. address IPv4 address. netmask IPv4 netmask, or NULL
for "/32".gateway IPv4 gateway address. cb function to call when server replies or some error happens. data data to give to cb when it is called.
- Returns
EINA_TRUE
on success,EINA_FALSE
otherwise.
References _E_Connman_Element::_pending, e_connman_element_message_send(), e_connman_prop_address, e_connman_prop_gateway, e_connman_prop_ipv4_configuration, e_connman_prop_method, e_connman_prop_netmask, e_connman_system_bus_name_get(), ERR, _E_Connman_Element::interface, _E_Connman_Element::path, and _E_Connman_Element::property_set.
◆ e_connman_service_ipv4_gateway_get()
Eina_Bool e_connman_service_ipv4_gateway_get | ( | const E_Connman_Element * | service, |
const char ** | gateway | ||
) |
Get property "IPv4.Gateway" value.
If this property isn't found then EINA_FALSE
is returned. If EINA_FALSE
is returned, then this call failed and parameter-returned values shall be considered invalid.
The current IPv4 gateway.
- Parameters
-
service path to get property. gateway where to store the property value, must be a pointer to string (const char **), it will not be allocated or copied and references will be valid until element changes, so copy it if you want to use it later.
- Returns
EINA_TRUE
on success,EINA_FALSE
otherwise.
References e_connman_element_property_dict_get_stringshared(), e_connman_prop_gateway, and e_connman_prop_ipv4.
◆ e_connman_service_ipv4_method_get()
Eina_Bool e_connman_service_ipv4_method_get | ( | const E_Connman_Element * | service, |
const char ** | method | ||
) |
Get property "IPv4.Method" value.
If this property isn't found then EINA_FALSE
is returned. If EINA_FALSE
is returned, then this call failed and parameter-returned values shall be considered invalid.
The IPv4 method in use. Possible values here are "dhcp" and "static".
- Parameters
-
service path to get property. method where to store the property value, must be a pointer to string (const char **), it will not be allocated or copied and references will be valid until element changes, so copy it if you want to use it later.
- Returns
EINA_TRUE
on success,EINA_FALSE
otherwise.
References e_connman_element_property_dict_get_stringshared(), e_connman_prop_ipv4, and e_connman_prop_method.
◆ e_connman_service_ipv4_netmask_get()
Eina_Bool e_connman_service_ipv4_netmask_get | ( | const E_Connman_Element * | service, |
const char ** | netmask | ||
) |
Get property "IPv4.Netmask" value.
If this property isn't found then EINA_FALSE
is returned. If EINA_FALSE
is returned, then this call failed and parameter-returned values shall be considered invalid.
The current IPv4 netmask.
- Parameters
-
service path to get property. netmask where to store the property value, must be a pointer to string (const char **), it will not be allocated or copied and references will be valid until element changes, so copy it if you want to use it later.
- Returns
EINA_TRUE
on success,EINA_FALSE
otherwise.
References e_connman_element_property_dict_get_stringshared(), e_connman_prop_ipv4, and e_connman_prop_netmask.
◆ e_connman_service_login_required_get()
Eina_Bool e_connman_service_login_required_get | ( | const E_Connman_Element * | service, |
Eina_Bool * | login_required | ||
) |
Get property "LoginRequired" value.
If this property isn't found then EINA_FALSE
is returned. If EINA_FALSE
is returned, then this call failed and parameter-returned values shall be considered invalid.
Indicates that a manual configuration must be done to login the user, likely access an website using a browser.
If a login has been set already or if no login is needed, then this property will be set to false.
- Parameters
-
service path to get property. login_required where to store the property value, must be a pointer to Eina_Bool (Eina_Bool *).
- Returns
EINA_TRUE
on success,EINA_FALSE
otherwise.
- Since
- 1.1.0
References e_connman_element_property_get_stringshared(), and e_connman_prop_login_required.
◆ e_connman_service_move_after()
Eina_Bool e_connman_service_move_after | ( | E_Connman_Element * | service, |
const char * | object_path, | ||
E_DBus_Method_Return_Cb | cb, | ||
const void * | data | ||
) |
Move service after in favorites list.
Call method MoveAfter(object service) at the given service on server.
If a service has been used before, this allows a reorder of the favorite services.
The target service object must be part of this profile. Moving between profiles is not supported.
- Parameters
-
service path to call method on server. cb function to call when server replies or some error happens. data data to give to cb when it is called.
- Returns
EINA_TRUE
on success,EINA_FALSE
otherwise.
References _E_Connman_Element::_pending, e_connman_element_call_with_path(), and _E_Connman_Element::service_move_after.
◆ e_connman_service_move_before()
Eina_Bool e_connman_service_move_before | ( | E_Connman_Element * | service, |
const char * | object_path, | ||
E_DBus_Method_Return_Cb | cb, | ||
const void * | data | ||
) |
Move service before in favorites list.
Call method MoveBefore(object service) at the given service on server.
If a service has been used before, this allows a reorder of the favorite services.
The target service object must be part of this profile. Moving between profiles is not supported.
- Parameters
-
service path to call method on server. object_path object service. cb function to call when server replies or some error happens. data data to give to cb when it is called.
- Returns
EINA_TRUE
on success,EINA_FALSE
otherwise.
References _E_Connman_Element::_pending, e_connman_element_call_with_path(), and _E_Connman_Element::service_move_before.
◆ e_connman_service_name_get()
Eina_Bool e_connman_service_name_get | ( | const E_Connman_Element * | service, |
const char ** | name | ||
) |
Get property "Name" value.
If this property isn't found then EINA_FALSE
is returned. If EINA_FALSE
is returned, then this call failed and parameter-returned values shall be considered invalid.
The service name (for example "Wireless" etc.)
This name can be used for directly displaying it in the application. It has pure informational purpose.
For Ethernet devices and hidden WiFi networks it is not guaranteed that this property is present.
- Parameters
-
service path to get property. name where to store the property value, must be a pointer to string (const char **), it will not be allocated or copied and references will be valid until element changes, so copy it if you want to use it later.
- Returns
EINA_TRUE
on success,EINA_FALSE
otherwise.
References e_connman_element_property_get_stringshared(), and e_connman_prop_name.
◆ e_connman_service_nameservers_configuration_get()
Eina_Bool e_connman_service_nameservers_configuration_get | ( | const E_Connman_Element * | service, |
unsigned int * | count, | ||
const char *** | nameservers | ||
) |
Get property "Nameservers.Configuration" value.
If this property isn't found then EINA_FALSE
is returned. If EINA_FALSE
is returned, then this call failed and parameter-returned values shall be considered invalid. The list of currently active nameservers for this service. If the server is not in READY or ONLINE state than this list will be empty.
Unlike Nameservers, this is the user-set value, rather than the actual value.
- Parameters
-
service path to get property. count return the number of elements in array. nameservers array with pointers to internal strings. These strings are not copied in any way, and they are granted to be eina_stringshare instances, so one can use eina_stringshare_ref() if he wants to save memory and cpu to get an extra reference. The array itself is also NOT allocated or copied, do not modify it. This pointer is just set if return is EINA_TRUE
.
- Returns
EINA_TRUE
on success,EINA_FALSE
otherwise.
References e_connman_element_strings_array_get_stringshared(), and e_connman_prop_nameservers_configuration.
◆ e_connman_service_nameservers_configuration_set()
Eina_Bool e_connman_service_nameservers_configuration_set | ( | E_Connman_Element * | service, |
unsigned int | count, | ||
const char ** | nameservers, | ||
E_DBus_Method_Return_Cb | cb, | ||
const void * | data | ||
) |
Set property "Nameservers.Configuration" value.
If this property isn't found then EINA_FALSE
is returned. If EINA_FALSE
is returned, then this call failed and parameter-returned values shall be considered invalid.
Unlike Nameservers, this is the user-set value, rather than the actual value. It allows user to override the default setting. When using manual configuration and no global nameservers are configured, then it is useful to configure this setting as well.
This list is sorted by priority and the first entry represents the nameserver with the highest priority.
Changes to the domain name servers can be done at any time. It will not cause a disconnect of the service. However there might be small window where name resolution might fail.
- Parameters
-
service path to set property. nameservers sorted list of the current nameservers. The first one has the highest priority and is used by default. cb function to call when server replies or some error happens. data data to give to cb when it is called.
- Returns
EINA_TRUE
on success,EINA_FALSE
otherwise.
References e_connman_element_property_array_set_full(), and e_connman_prop_nameservers_configuration.
◆ e_connman_service_nameservers_get()
Eina_Bool e_connman_service_nameservers_get | ( | const E_Connman_Element * | service, |
unsigned int * | count, | ||
const char *** | nameservers | ||
) |
Get property "Nameservers" value.
If this property isn't found then EINA_FALSE
is returned. If EINA_FALSE
is returned, then this call failed and parameter-returned values shall be considered invalid. The list of currently active nameservers for this service. If the server is not in READY or ONLINE state than this list will be empty.
Global nameservers are automatically added to this list.
The array represents a sorted list of the current nameservers. The first one has the highest priority and is used by default.
When using DHCP this array represents the nameservers provided by the network. In case of manual settings, the ones from Nameservers.Configuration are used.
- Parameters
-
service path to get property. count return the number of elements in array. nameservers array with pointers to internal strings. These strings are not copied in any way, and they are granted to be eina_stringshare instances, so one can use eina_stringshare_ref() if he wants to save memory and cpu to get an extra reference. The array itself is also NOT allocated or copied, do not modify it. This pointer is just set if return is EINA_TRUE
.
- Returns
EINA_TRUE
on success,EINA_FALSE
otherwise.
References e_connman_element_strings_array_get_stringshared(), and e_connman_prop_nameservers.
◆ e_connman_service_passphrase_get()
Eina_Bool e_connman_service_passphrase_get | ( | const E_Connman_Element * | service, |
const char ** | passphrase | ||
) |
Get property "Passphrase" value.
If this property isn't found then EINA_FALSE
is returned. If EINA_FALSE
is returned, then this call failed and parameter-returned values shall be considered invalid.
If the service type is WiFi, then this property can be used to store a passphrase.
No PropertyChanged signals will be send for this property. The PassphraseRequired property should be monitored instead.
This property might also not always be included since it is protected by a different security policy.
- Parameters
-
service path to get property. passphrase where to store the property value, must be a pointer to string (const char **), it will not be allocated or copied and references will be valid until element changes, so copy it if you want to use it later.
- Returns
EINA_TRUE
on success,EINA_FALSE
otherwise.
References e_connman_element_property_get_stringshared(), and e_connman_prop_passphrase.
◆ e_connman_service_passphrase_required_get()
Eina_Bool e_connman_service_passphrase_required_get | ( | const E_Connman_Element * | service, |
Eina_Bool * | passphrase_required | ||
) |
Get property "PassphraseRequired" value.
If this property isn't found then EINA_FALSE
is returned. If EINA_FALSE
is returned, then this call failed and parameter-returned values shall be considered invalid.
If the service type is WiFi, then this property indicates if a passphrase is required.
If a passphrase has been set already or if no passphrase is needed, then this property will be set to false.
- Parameters
-
service path to get property. passphrase_required where to store the property value, must be a pointer to Eina_Bool (Eina_Bool *).
- Returns
EINA_TRUE
on success,EINA_FALSE
otherwise.
References e_connman_element_property_get_stringshared(), and e_connman_prop_passphrase_required.
◆ e_connman_service_proxy_configuration_excludes_get()
Eina_Bool e_connman_service_proxy_configuration_excludes_get | ( | const E_Connman_Element * | service, |
unsigned int * | count, | ||
const char *** | excludes | ||
) |
Get property "Proxy.Configuration.Excludes" value.
Unlike Proxy.Excludes, this is the user-set value, rather than the actual value.
If this property isn't found then EINA_FALSE
is returned. If EINA_FALSE
is returned, then this call failed and parameter-returned values shall be considered invalid.
List of hosts which can be accessed directly.
Used when "manual" method is set.
- Parameters
-
service path to get property. count return the number of elements in array. excludes array with pointers to internal strings. These strings are not copied in any way, and they are granted to be eina_stringshare instances, so one can use eina_stringshare_ref() if he wants to save memory and cpu to get an extra reference. The array itself is also NOT allocated or copied, do not modify it. This pointer is just set if return is EINA_TRUE
.
- Returns
EINA_TRUE
on success,EINA_FALSE
otherwise.
References e_connman_element_property_dict_strings_array_get_stringshared(), e_connman_prop_excludes, and e_connman_prop_proxy_configuration.
◆ e_connman_service_proxy_configuration_method_get()
Eina_Bool e_connman_service_proxy_configuration_method_get | ( | const E_Connman_Element * | service, |
const char ** | method | ||
) |
Get property "Proxy.Configuration.Method" value.
Unlike Proxy.Configuration.Method, this is the user-set value, rather than the actual value.
If this property isn't found then EINA_FALSE
is returned. If EINA_FALSE
is returned, then this call failed and parameter-returned values shall be considered invalid.
Possible values are "direct", "auto" and "manual".
- Parameters
-
service path to get property. method where to store the property value, must be a pointer to string (const char **), it will not be allocated or copied and references will be valid until element changes, so copy it if you want to use it later.
- Returns
EINA_TRUE
on success,EINA_FALSE
otherwise.
References e_connman_element_property_dict_get_stringshared(), e_connman_prop_method, and e_connman_prop_proxy_configuration.
◆ e_connman_service_proxy_configuration_servers_get()
Eina_Bool e_connman_service_proxy_configuration_servers_get | ( | const E_Connman_Element * | service, |
unsigned int * | count, | ||
const char *** | servers | ||
) |
Get property "Proxy.Configuration.Servers" value.
Unlike Proxy.Servers, this is the user-set value, rather than the actual value.
If this property isn't found then EINA_FALSE
is returned. If EINA_FALSE
is returned, then this call failed and parameter-returned values shall be considered invalid.
List of proxy URIs. The URI without a protocol will be interpreted as the generic proxy URI. All others will target a specific protocol and only once. Example of generic proxy server entry would be like this: "server.example.com:911".
Used when "manual" method is set.
- Parameters
-
service path to get property. count return the number of elements in array. servers array with pointers to internal strings. These strings are not copied in any way, and they are granted to be eina_stringshare instances, so one can use eina_stringshare_ref() if he wants to save memory and cpu to get an extra reference. The array itself is also NOT allocated or copied, do not modify it. This pointer is just set if return is EINA_TRUE
.
- Returns
EINA_TRUE
on success,EINA_FALSE
otherwise.
References e_connman_element_property_dict_strings_array_get_stringshared(), e_connman_prop_proxy_configuration, and e_connman_prop_servers.
◆ e_connman_service_proxy_configuration_url_get()
Eina_Bool e_connman_service_proxy_configuration_url_get | ( | const E_Connman_Element * | service, |
const char ** | url | ||
) |
Get property "Proxy.Configuration.URL" value.
Unlike Proxy.URL, this is the user-set value, rather than the actual value.
If this property isn't found then EINA_FALSE
is returned. If EINA_FALSE
is returned, then this call failed and parameter-returned values shall be considered invalid.
Automatic proxy configuration URL. Used by "auto" method.
- Parameters
-
service path to get property. url where to store the property value, must be a pointer to string (const char **), it will not be allocated or copied and references will be valid until element changes, so copy it if you want to use it later.
- Returns
EINA_TRUE
on success,EINA_FALSE
otherwise.
References e_connman_element_property_dict_get_stringshared(), e_connman_prop_proxy_configuration, and e_connman_prop_url.
◆ e_connman_service_proxy_excludes_get()
Eina_Bool e_connman_service_proxy_excludes_get | ( | const E_Connman_Element * | service, |
unsigned int * | count, | ||
const char *** | excludes | ||
) |
Get property "Proxy.Excludes" value.
If this property isn't found then EINA_FALSE
is returned. If EINA_FALSE
is returned, then this call failed and parameter-returned values shall be considered invalid.
List of hosts which can be accessed directly.
Used when "manual" method is set.
- Parameters
-
service path to get property. count return the number of elements in array. excludes array with pointers to internal strings. These strings are not copied in any way, and they are granted to be eina_stringshare instances, so one can use eina_stringshare_ref() if he wants to save memory and cpu to get an extra reference. The array itself is also NOT allocated or copied, do not modify it. This pointer is just set if return is EINA_TRUE
.
- Returns
EINA_TRUE
on success,EINA_FALSE
otherwise.
References e_connman_element_property_dict_strings_array_get_stringshared(), e_connman_prop_excludes, and e_connman_prop_proxy.
◆ e_connman_service_proxy_method_get()
Eina_Bool e_connman_service_proxy_method_get | ( | const E_Connman_Element * | service, |
const char ** | method | ||
) |
Get property "Proxy.Method" value.
If this property isn't found then EINA_FALSE
is returned. If EINA_FALSE
is returned, then this call failed and parameter-returned values shall be considered invalid.
Possible values are "direct", "auto" and "manual".
- Parameters
-
service path to get property. method where to store the property value, must be a pointer to string (const char **), it will not be allocated or copied and references will be valid until element changes, so copy it if you want to use it later.
- Returns
EINA_TRUE
on success,EINA_FALSE
otherwise.
References e_connman_element_property_dict_get_stringshared(), e_connman_prop_method, and e_connman_prop_proxy.
◆ e_connman_service_proxy_servers_get()
Eina_Bool e_connman_service_proxy_servers_get | ( | const E_Connman_Element * | service, |
unsigned int * | count, | ||
const char *** | servers | ||
) |
Get property "Proxy.Servers" value.
If this property isn't found then EINA_FALSE
is returned. If EINA_FALSE
is returned, then this call failed and parameter-returned values shall be considered invalid.
List of proxy URIs. The URI without a protocol will be interpreted as the generic proxy URI. All others will target a specific protocol and only once. Example of generic proxy server entry would be like this: "server.example.com:911".
Used when "manual" method is set.
- Parameters
-
service path to get property. count return the number of elements in array. servers array with pointers to internal strings. These strings are not copied in any way, and they are granted to be eina_stringshare instances, so one can use eina_stringshare_ref() if he wants to save memory and cpu to get an extra reference. The array itself is also NOT allocated or copied, do not modify it. This pointer is just set if return is EINA_TRUE
.
- Returns
EINA_TRUE
on success,EINA_FALSE
otherwise.
References e_connman_element_property_dict_strings_array_get_stringshared(), e_connman_prop_proxy, and e_connman_prop_servers.
◆ e_connman_service_proxy_url_get()
Eina_Bool e_connman_service_proxy_url_get | ( | const E_Connman_Element * | service, |
const char ** | url | ||
) |
Get property "Proxy.URL" value.
If this property isn't found then EINA_FALSE
is returned. If EINA_FALSE
is returned, then this call failed and parameter-returned values shall be considered invalid.
Automatic proxy configuration URL. Used by "auto" method.
- Parameters
-
service path to get property. url where to store the property value, must be a pointer to string (const char **), it will not be allocated or copied and references will be valid until element changes, so copy it if you want to use it later.
- Returns
EINA_TRUE
on success,EINA_FALSE
otherwise.
References e_connman_element_property_dict_get_stringshared(), e_connman_prop_proxy, and e_connman_prop_url.
◆ e_connman_service_roaming_get()
Eina_Bool e_connman_service_roaming_get | ( | const E_Connman_Element * | service, |
Eina_Bool * | roaming | ||
) |
Get property "Roaming" value.
If this property isn't found then EINA_FALSE
is returned. If EINA_FALSE
is returned, then this call failed and parameter-returned values shall be considered invalid.
This property indicates if this service is roaming.
In the case of Cellular services this normally indicates connections to a foreign provider when traveling abroad.
- Parameters
-
service path to get property. roaming where to store the property value, must be a pointer to Eina_Bool (Eina_Bool *).
- Returns
EINA_TRUE
on success,EINA_FALSE
otherwise.
References e_connman_element_property_get_stringshared(), and e_connman_prop_roaming.
◆ e_connman_service_security_get()
Eina_Bool e_connman_service_security_get | ( | const E_Connman_Element * | service, |
unsigned int * | count, | ||
const char *** | security | ||
) |
Get property "Security" value.
If this property isn't found then EINA_FALSE
is returned. If EINA_FALSE
is returned, then this call failed and parameter-returned values shall be considered invalid.
If the service type is WiFi, then this property is present and contains the list of security method or key management setting.
Possible values are "none", "wep", "wpa", "rsn", "psk", "ieee8021x" and "wps"
This property might be only present for WiFi services.
- Parameters
-
service path to get property. count where to return the number of elements in security security where to store the property value, must be a pointer to array of strings, it will not be allocated or copied and references will be valid until element changes, so copy it if you want to use it later.
- Returns
EINA_TRUE
on success,EINA_FALSE
otherwise.
References e_connman_element_strings_array_get_stringshared(), and e_connman_prop_security.
◆ e_connman_service_state_get()
Eina_Bool e_connman_service_state_get | ( | const E_Connman_Element * | service, |
const char ** | state | ||
) |
Get property "State" value.
If this property isn't found then EINA_FALSE
is returned. If EINA_FALSE
is returned, then this call failed and parameter-returned values shall be considered invalid.
The service state information.
Valid states are "idle", "failure", "association", "configuration", "ready", "login" and "online".
- Parameters
-
service path to get property. state where to store the property value, must be a pointer to string (const char **), it will not be allocated or copied and references will be valid until element changes, so copy it if you want to use it later.
- Returns
EINA_TRUE
on success,EINA_FALSE
otherwise.
References e_connman_element_property_get_stringshared(), and e_connman_prop_state.
◆ e_connman_service_strength_get()
Eina_Bool e_connman_service_strength_get | ( | const E_Connman_Element * | service, |
unsigned char * | strength | ||
) |
Get property "Strength" value.
If this property isn't found then EINA_FALSE
is returned. If EINA_FALSE
is returned, then this call failed and parameter-returned values shall be considered invalid.
Indicates the signal strength of the service. This is a normalized value between 0 and 100.
This property will not be present for Ethernet devices.
- Parameters
-
service path to get property. strength where to store the property value, must be a pointer to byte (unsigned char*).
- Returns
EINA_TRUE
on success,EINA_FALSE
otherwise.
References e_connman_element_property_get_stringshared(), and e_connman_prop_strength.
◆ e_connman_service_type_get()
Eina_Bool e_connman_service_type_get | ( | const E_Connman_Element * | service, |
const char ** | type | ||
) |
Get property "Type" value.
If this property isn't found then EINA_FALSE
is returned. If EINA_FALSE
is returned, then this call failed and parameter-returned values shall be considered invalid.
The service type (for example "ethernet", "wifi" etc.)
This information should only be used to determine advanced properties or showing the correct icon to the user.
- Parameters
-
service path to get property. type where to store the property value, must be a pointer to string (const char **), it will not be allocated or copied and references will be valid until element changes, so copy it if you want to use it later.
- Returns
EINA_TRUE
on success,EINA_FALSE
otherwise.
References e_connman_element_property_get_stringshared(), and e_connman_prop_type.