e_connman_service.c File Reference
+ Include dependency graph for e_connman_service.c:

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_Elemente_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

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
servicepath to get property.
auto_connectwhere to store the property value, must be a pointer to Eina_Bool (Eina_Bool *).
Returns
EINA_TRUE on success, EINA_FALSE otherwise.
See also
e_connman_service_auto_connect_set()

References e_connman_element_property_get_stringshared(), and e_connman_prop_auto_connect.

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
servicepath to get property.
countreturn the number of elements in array.
domainsarray 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.

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
servicepath to set property.
countnumber of elements in domain.
domainssorted list of the current domains. The first one has the highest priority and is used by default.
cbfunction to call when server replies or some error happens.
datadata to give to cb when it is called.
Returns
EINA_TRUE on success, EINA_FALSE otherwise.
See also
e_connman_service_domains_configuration_get()

References e_connman_element_property_array_set_full(), and e_connman_prop_domains_configuration.

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
servicepath to get property.
countreturn the number of elements in array.
domainsarray 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.

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
servicepath to get property.
errorwhere 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.

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
servicepath to get property.
addresswhere 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.

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
servicepath to get property.
duplexwhere 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.

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
servicepath to get property.
ifacewhere 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.

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
servicepath to get property.
methodwhere 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.

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
servicepath to get property.
gatewaywhere 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.

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
servicepath to get property.
speedwhere 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.

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
servicepath to get property.
favoritewhere 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.

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
servicepath to get property.
immutablewhere 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.

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
servicepath to get property.
addresswhere 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.

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
servicepath to get property.
addresswhere 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.

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
servicepath to get property.
gatewaywhere 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.

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
servicepath to get property.
methodwhere 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.

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
servicepath to get property.
netmaskwhere 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.

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
servicepath to set.
addressIPv4 address.
netmaskIPv4 netmask, or NULL for "/32".
gatewayIPv4 gateway address.
cbfunction to call when server replies or some error happens.
datadata 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.

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
servicepath to get property.
gatewaywhere 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.

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
servicepath to get property.
methodwhere 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.

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
servicepath to get property.
netmaskwhere 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.

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
servicepath to get property.
login_requiredwhere 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.

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
servicepath to call method on server.
cbfunction to call when server replies or some error happens.
datadata 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.

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
servicepath to call method on server.
object_pathobject service.
cbfunction to call when server replies or some error happens.
datadata 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.

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
servicepath to get property.
namewhere 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.

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
servicepath to get property.
countreturn the number of elements in array.
nameserversarray 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.

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
servicepath to set property.
nameserverssorted list of the current nameservers. The first one has the highest priority and is used by default.
cbfunction to call when server replies or some error happens.
datadata to give to cb when it is called.
Returns
EINA_TRUE on success, EINA_FALSE otherwise.
See also
e_connman_service_nameservers_configuration_get()

References e_connman_element_property_array_set_full(), and e_connman_prop_nameservers_configuration.

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
servicepath to get property.
countreturn the number of elements in array.
nameserversarray 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.

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
servicepath to get property.
passphrasewhere 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.
See also
e_connman_service_passphrase_set()

References e_connman_element_property_get_stringshared(), and e_connman_prop_passphrase.

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
servicepath to get property.
passphrase_requiredwhere 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.

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
servicepath to get property.
countreturn the number of elements in array.
excludesarray 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.

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
servicepath to get property.
methodwhere 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.

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
servicepath to get property.
countreturn the number of elements in array.
serversarray 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.

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
servicepath to get property.
urlwhere 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.

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
servicepath to get property.
countreturn the number of elements in array.
excludesarray 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.

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
servicepath to get property.
methodwhere 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.

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
servicepath to get property.
countreturn the number of elements in array.
serversarray 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.

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
servicepath to get property.
urlwhere 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.

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
servicepath to get property.
roamingwhere 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.

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
servicepath to get property.
countwhere to return the number of elements in security
securitywhere 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.

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
servicepath to get property.
statewhere 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.

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
servicepath to get property.
strengthwhere 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.

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
servicepath to get property.
typewhere 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.