Missing file :-(
authorbarbieri <barbieri@7cbeb6ba-43b4-40fd-8cce-4c39aea84d33>
Sun, 20 Dec 2009 00:05:49 +0000 (00:05 +0000)
committerbarbieri <barbieri@7cbeb6ba-43b4-40fd-8cce-4c39aea84d33>
Sun, 20 Dec 2009 00:05:49 +0000 (00:05 +0000)
git-svn-id: svn+ssh://svn.enlightenment.org/var/svn/e/trunk/e_dbus@44585 7cbeb6ba-43b4-40fd-8cce-4c39aea84d33

src/lib/connman/e_connman_service.c [new file with mode: 0644]

diff --git a/src/lib/connman/e_connman_service.c b/src/lib/connman/e_connman_service.c
new file mode 100644 (file)
index 0000000..de0b0a7
--- /dev/null
@@ -0,0 +1,895 @@
+#include "e_connman_private.h"
+
+E_Connman_Element *
+e_connman_service_get(const char *path)
+{
+   E_Connman_Element *service;
+
+   EINA_SAFETY_ON_NULL_RETURN_VAL(path, NULL);
+
+   service = e_connman_element_get(path);
+   if (!service)
+     return NULL;
+
+   if (!e_connman_element_is_service(service))
+     {
+       WRN("E-Dbus connman: path '%s' is not a service!", path);
+       return NULL;
+     }
+
+   return service;
+}
+
+/**
+ * Connect this service.
+ *
+ * Connect this service. It will attempt to connect
+ * WiFi, WiMAX or Bluetooth services.
+ *
+ * For Ethernet devices this method can only be used
+ * if it has previously been disconnected. Otherwise
+ * the plugging of a cable will trigger connecting
+ * automatically. If no cable is plugged in this method
+ * will fail.
+ *
+ * @param service_path to call method on server.
+ * @param cb function to call when server replies or some error happens.
+ * @param data data to give to cb when it is called.
+ *
+ * @return 1 on success, 0 otherwise.
+ */
+bool
+e_connman_service_connect(E_Connman_Element *service, E_DBus_Method_Return_Cb cb, const void *data)
+{
+   const char name[] = "Connect";
+
+   EINA_SAFETY_ON_NULL_RETURN_VAL(service, 0);
+   return e_connman_element_call_full
+     (service, name, NULL, &service->_pending.service_connect, cb, data);
+}
+
+/**
+ * Disconnect this service.
+ *
+ * Disconnect this service. If the service is not
+ * connected an error message will be generated.
+ *
+ * On Ethernet devices this will disconnect the IP
+ * details from the service. It will not magically
+ * unplug the cable. When no cable is plugged in this
+ * method will fail.
+ *
+ * This method can also be used to abort a previous
+ * connectiong attempt via the Connect method.
+ *
+ * @param service_path to call method on server.
+ * @param cb function to call when server replies or some error happens.
+ * @param data data to give to cb when it is called.
+ *
+ * @return 1 on success, 0 otherwise.
+ */
+bool
+e_connman_service_disconnect(E_Connman_Element *service, E_DBus_Method_Return_Cb cb, const void *data)
+{
+   const char name[] = "Disconnect";
+
+   EINA_SAFETY_ON_NULL_RETURN_VAL(service, 0);
+   return e_connman_element_call_full
+     (service, name, NULL, &service->_pending.service_disconnect, cb, data);
+}
+
+/**
+ * Remove this service.
+ *
+ * A successfully connected service with Favorite=true
+ * can be removed this way. If it is connected, it will
+ * be automatically disconnected first.
+ *
+ * If the service requires a passphrase it will be
+ * cleared and forgotten when removing.
+ *
+ * This is similar to setting the Favorite property
+ * to false, but that is currently not supported.
+ *
+ * In the case a connection attempt failed and the
+ * service is in the State=failure, this method can
+ * also be used to reset the service.
+ *
+ * Calling this method on Ethernet devices will cause
+ * an error message. It is not possible to remove these
+ * kind of devices.
+ *
+ * @param service_path to call method on server.
+ * @param cb function to call when server replies or some error happens.
+ * @param data data to give to cb when it is called.
+ *
+ * @return 1 on success, 0 otherwise.
+ */
+bool
+e_connman_service_remove(E_Connman_Element *service, E_DBus_Method_Return_Cb cb, const void *data)
+{
+   const char name[] = "Remove";
+
+   EINA_SAFETY_ON_NULL_RETURN_VAL(service, 0);
+   return e_connman_element_call_full
+     (service, name, NULL, &service->_pending.service_remove, cb, data);
+}
+
+/**
+ * Clears the value of the specified property.
+ *
+ *
+ * @param service_path to call method on server.
+ * @param property to be cleared.
+ * @param cb function to call when server replies or some error happens.
+ * @param data data to give to cb when it is called.
+ *
+ * @return 1 on success, 0 otherwise.
+ */
+ bool
+ e_connman_service_clear_property(E_Connman_Element *service, const char *property, E_DBus_Method_Return_Cb cb, const void *data)
+ {
+    const char name[] = "ClearProperty";
+
+    EINA_SAFETY_ON_NULL_RETURN_VAL(service, 0);
+    EINA_SAFETY_ON_NULL_RETURN_VAL(property, 0);
+    /* FIXME TODO */
+    return 0;
+ }
+
+/**
+ * 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.
+ *
+ * @param service_path to call method on server.
+ * @param object_path object service.
+ * @param cb function to call when server replies or some error happens.
+ * @param data data to give to cb when it is called.
+ *
+ * @return 1 on success, 0 otherwise.
+ */
+bool
+e_connman_service_move_before(E_Connman_Element *service, const char *object_path, E_DBus_Method_Return_Cb cb, const void *data)
+{
+   const char name[] = "MoveBefore";
+
+   EINA_SAFETY_ON_NULL_RETURN_VAL(service, 0);
+   EINA_SAFETY_ON_NULL_RETURN_VAL(object_path, 0);
+   return e_connman_element_call_with_path
+     (service, name, object_path, NULL,
+      &service->_pending.service_move_before, cb, 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.
+ *
+ * @param service_path to call method on server.
+ * @param cb function to call when server replies or some error happens.
+ * @param data data to give to cb when it is called.
+ *
+ * @return 1 on success, 0 otherwise.
+ */
+bool
+e_connman_service_move_after(E_Connman_Element *service, const char *object_path, E_DBus_Method_Return_Cb cb, const void *data)
+{
+   const char name[] = "MoveAfter";
+
+   EINA_SAFETY_ON_NULL_RETURN_VAL(service, 0);
+   EINA_SAFETY_ON_NULL_RETURN_VAL(object_path, 0);
+   return e_connman_element_call_with_path
+     (service, name, object_path, NULL,
+      &service->_pending.service_move_after, cb, data);
+}
+
+/**
+ * Get property "State" value.
+ *
+ * If this property isn't found then 0 is returned.
+ * If zero 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" and "ready".
+ *
+ * @param service_path to get property.
+ * @param 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.
+ *
+ * @return 1 on success, 0 otherwise.
+ */
+bool
+e_connman_service_state_get(const E_Connman_Element *service, const char **state)
+{
+   EINA_SAFETY_ON_NULL_RETURN_VAL(service, 0);
+   EINA_SAFETY_ON_NULL_RETURN_VAL(state, 0);
+   return e_connman_element_property_get_stringshared
+     (service, e_connman_prop_state, NULL, state);
+}
+
+/**
+ * Get property "Error" value.
+ *
+ * If this property isn't found then 0 is returned.
+ * If zero 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".
+ *
+ * @param service_path to get property.
+ * @param 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.
+ *
+ * @return 1 on success, 0 otherwise.
+ */
+bool
+e_connman_service_error_get(const E_Connman_Element *service, const char **error)
+{
+   EINA_SAFETY_ON_NULL_RETURN_VAL(service, 0);
+   EINA_SAFETY_ON_NULL_RETURN_VAL(error, 0);
+   return e_connman_element_property_get_stringshared
+     (service, e_connman_prop_error, NULL, error);
+}
+
+/**
+ * Get property "Name" value.
+ *
+ * If this property isn't found then 0 is returned.
+ * If zero 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.
+ *
+ * @param service_path to get property.
+ * @param 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.
+ *
+ * @return 1 on success, 0 otherwise.
+ */
+bool
+e_connman_service_name_get(const E_Connman_Element *service, const char **name)
+{
+   EINA_SAFETY_ON_NULL_RETURN_VAL(service, 0);
+   EINA_SAFETY_ON_NULL_RETURN_VAL(name, 0);
+   return e_connman_element_property_get_stringshared
+     (service, e_connman_prop_name, NULL, name);
+}
+
+/**
+ * Get property "Type" value.
+ *
+ * If this property isn't found then 0 is returned.
+ * If zero 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.
+ *
+ * @param service_path to get property.
+ * @param 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.
+ *
+ * @return 1 on success, 0 otherwise.
+ */
+bool
+e_connman_service_type_get(const E_Connman_Element *service, const char **type)
+{
+   EINA_SAFETY_ON_NULL_RETURN_VAL(service, 0);
+   EINA_SAFETY_ON_NULL_RETURN_VAL(type, 0);
+   return e_connman_element_property_get_stringshared
+     (service, e_connman_prop_type, NULL, type);
+}
+
+/**
+ * Get property "Mode" value.
+ *
+ * If this property isn't found then 0 is returned.
+ * If zero is returned, then this call failed and parameter-returned
+ * values shall be considered invalid.
+ *
+ * If the service type is WiFi or Cellular, then this
+ * property is present and contains the mode of the
+ * network.
+ *
+ * For WiFi services the possible values are "managed"
+ * and "adhoc". For Cellular services it describes the
+ * network technology. Possible values are "gprs", "edge"
+ * and "umts".
+ *
+ * This property might be only present for WiFi and
+ * Cellular services.
+ *
+ * @param service_path to get property.
+ * @param mode 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.
+ *
+ * @return 1 on success, 0 otherwise.
+ */
+bool
+e_connman_service_mode_get(const E_Connman_Element *service, const char **mode)
+{
+   EINA_SAFETY_ON_NULL_RETURN_VAL(service, 0);
+   EINA_SAFETY_ON_NULL_RETURN_VAL(mode, 0);
+   return e_connman_element_property_get_stringshared
+     (service, e_connman_prop_mode, NULL, mode);
+}
+
+/**
+ * Get property "Security" value.
+ *
+ * If this property isn't found then 0 is returned.
+ * If zero 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 security method or key
+ * management setting.
+ *
+ * Possible values are "none", "wep", "wpa" and "rsn".
+ *
+ * This property might be only present for WiFi
+ * services.
+ *
+ * @param service_path to get property.
+ * @param security 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.
+ *
+ * @return 1 on success, 0 otherwise.
+ */
+bool
+e_connman_service_security_get(const E_Connman_Element *service, const char **security)
+{
+   EINA_SAFETY_ON_NULL_RETURN_VAL(service, 0);
+   EINA_SAFETY_ON_NULL_RETURN_VAL(security, 0);
+   return e_connman_element_property_get_stringshared
+     (service, e_connman_prop_security, NULL, security);
+}
+
+/**
+ * Get property "Passphrase" value.
+ *
+ * If this property isn't found then 0 is returned.
+ * If zero 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.
+ *
+ * @param service_path to get property.
+ * @param 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.
+ *
+ * @return 1 on success, 0 otherwise.
+ * @see e_connman_service_passphrase_set()
+ */
+bool
+e_connman_service_passphrase_get(const E_Connman_Element *service, const char **passphrase)
+{
+   EINA_SAFETY_ON_NULL_RETURN_VAL(service, 0);
+   EINA_SAFETY_ON_NULL_RETURN_VAL(passphrase, 0);
+   return e_connman_element_property_get_stringshared
+     (service, e_connman_prop_passphrase, NULL, passphrase);
+}
+
+/**
+ * Set property "Passphrase" value.
+ *
+ * If this property isn't found then 0 is returned.
+ * If zero 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.
+ *
+ * @param service_path to get property.
+ * @param passphrase value to set.
+ * @param cb function to call when server replies or some error happens.
+ * @param data data to give to cb when it is called.
+ *
+ * @return 1 on success, 0 otherwise.
+ * @see e_connman_service_passphrase_get()
+ */
+bool
+e_connman_service_passphrase_set(E_Connman_Element *service, const char *passphrase, E_DBus_Method_Return_Cb cb, const void *data)
+{
+   EINA_SAFETY_ON_NULL_RETURN_VAL(service, 0);
+   return e_connman_element_property_set_full
+     (service, e_connman_prop_passphrase, DBUS_TYPE_STRING,
+      passphrase, cb, data);
+}
+
+/**
+ * Get property "PassphraseRequired" value.
+ *
+ * If this property isn't found then 0 is returned.
+ * If zero 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.
+ *
+ * @param service_path to get property.
+ * @param passphrase_required where to store the property value, must be a
+ *        pointer to boolean (bool *).
+ *
+ * @return 1 on success, 0 otherwise.
+ */
+bool
+e_connman_service_passphrase_required_get(const E_Connman_Element *service, bool *passphrase_required)
+{
+   EINA_SAFETY_ON_NULL_RETURN_VAL(service, 0);
+   EINA_SAFETY_ON_NULL_RETURN_VAL(passphrase_required, 0);
+   return e_connman_element_property_get_stringshared
+     (service, e_connman_prop_passphrase_required, NULL, passphrase_required);
+}
+
+/**
+ * Get property "Strength" value.
+ *
+ * If this property isn't found then 0 is returned.
+ * If zero 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.
+ *
+ * @param service_path to get property.
+ * @param strength where to store the property value, must be a pointer
+ *        to byte (unsigned char*).
+ *
+ * @return 1 on success, 0 otherwise.
+ */
+bool
+e_connman_service_strength_get(const E_Connman_Element *service, unsigned char *strength)
+{
+   EINA_SAFETY_ON_NULL_RETURN_VAL(service, 0);
+   EINA_SAFETY_ON_NULL_RETURN_VAL(strength, 0);
+   return e_connman_element_property_get_stringshared
+     (service, e_connman_prop_strengh, NULL, strength);
+}
+
+/**
+ * Get property "Favorite" value.
+ *
+ * If this property isn't found then 0 is returned.
+ * If zero 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.
+ *
+ * @param service_path to get property.
+ * @param favorite where to store the property value, must be a
+ *        pointer to boolean (bool *).
+ *
+ * @return 1 on success, 0 otherwise.
+ */
+bool
+e_connman_service_favorite_get(const E_Connman_Element *service, bool *favorite)
+{
+   EINA_SAFETY_ON_NULL_RETURN_VAL(service, 0);
+   EINA_SAFETY_ON_NULL_RETURN_VAL(favorite, 0);
+   return e_connman_element_property_get_stringshared
+     (service, e_connman_prop_favorite, NULL, favorite);
+}
+
+/**
+ * Get property "AutoConnect" value.
+ *
+ * If this property isn't found then 0 is returned.
+ * If zero 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.
+ *
+ * @param service_path to get property.
+ * @param auto_connect where to store the property value, must be a
+ *        pointer to boolean (bool *).
+ *
+ * @return 1 on success, 0 otherwise.
+ * @see e_connman_service_auto_connect_set()
+ */
+bool
+e_connman_service_auto_connect_get(const E_Connman_Element *service, bool *auto_connect)
+{
+   EINA_SAFETY_ON_NULL_RETURN_VAL(service, 0);
+   EINA_SAFETY_ON_NULL_RETURN_VAL(auto_connect, 0);
+   return e_connman_element_property_get_stringshared
+     (service, e_connman_prop_auto_connect, NULL, auto_connect);
+}
+
+/**
+ * Set property "AutoConnect" value.
+ *
+ * If this property isn't found then 0 is returned.
+ * If zero 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.
+ *
+ * @param service_path to get property.
+ * @param service_favorite where to store the property value, must be a
+ *        pointer to boolean (bool *).
+ *
+ * @return 1 on success, 0 otherwise.
+ * @see e_connman_service_auto_connect_get()
+ */
+bool
+e_connman_service_auto_connect_set(E_Connman_Element *service, bool auto_connect, E_DBus_Method_Return_Cb cb, const void *data)
+{
+   EINA_SAFETY_ON_NULL_RETURN_VAL(service, 0);
+   return e_connman_element_property_set_full
+     (service, e_connman_prop_auto_connect, DBUS_TYPE_BOOLEAN, &auto_connect, cb, data);
+}
+
+/**
+ * Get property "SetupRequired" value.
+ *
+ * If this property isn't found then 0 is returned.
+ * If zero is returned, then this call failed and parameter-returned
+ * values shall be considered invalid.
+ *
+ * If the service is Cellular, then this property
+ * indicates that some extra setup steps are required.
+ *
+ * In most cases it is required to fill in the APN
+ * details.
+ *
+ * @param service_path to get property.
+ * @param setup_required where to store the property value, must be a
+ *        pointer to boolean (bool *).
+ *
+ * @return 1 on success, 0 otherwise.
+ */
+bool
+e_connman_service_setup_required_get(const E_Connman_Element *service, bool *setup_required)
+{
+   EINA_SAFETY_ON_NULL_RETURN_VAL(service, 0);
+   EINA_SAFETY_ON_NULL_RETURN_VAL(setup_required, 0);
+   return e_connman_element_property_get_stringshared
+     (service, e_connman_prop_setup_required, NULL, setup_required);
+}
+
+/**
+ * Get property "APN" value.
+ *
+ * If this property isn't found then 0 is returned.
+ * If zero is returned, then this call failed and parameter-returned
+ * values shall be considered invalid.
+ *
+ * If the service is Cellular, then this property
+ * contains the APN details.
+ *
+ * The APN is network provider specific and even
+ * sometimes data plan specific. Possible examples
+ * are "isp.cingular" or "internet.t-mobile".
+ *
+ * This property might also not always be included
+ * since it is protected by a different security policy.
+ *
+ * @param service_path to get property.
+ * @param apn 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.
+ *
+ * @return 1 on success, 0 otherwise.
+ * @see e_connman_service_apn_set()
+ */
+bool
+e_connman_service_apn_get(const E_Connman_Element *service, const char **apn)
+{
+   EINA_SAFETY_ON_NULL_RETURN_VAL(service, 0);
+   EINA_SAFETY_ON_NULL_RETURN_VAL(apn, 0);
+   return e_connman_element_property_get_stringshared
+     (service, e_connman_prop_apn, NULL, apn);
+}
+
+/**
+ * Set property "APN" value.
+ *
+ * If this property isn't found then 0 is returned.
+ * If zero is returned, then this call failed and parameter-returned
+ * values shall be considered invalid.
+ *
+ * If the service is Cellular, then this property
+ * contains the APN details.
+ *
+ * The APN is network provider specific and even
+ * sometimes data plan specific. Possible examples
+ * are "isp.cingular" or "internet.t-mobile".
+ *
+ * This property might also not always be included
+ * since it is protected by a different security policy.
+ *
+ * @param service_path to get property.
+ * @param passphrase value to set.
+ * @param cb function to call when server replies or some error happens.
+ * @param data data to give to cb when it is called.
+ *
+ * @return 1 on success, 0 otherwise.
+ * @see e_connman_service_apn_get()
+ */
+bool
+e_connman_service_apn_set(E_Connman_Element *service, const char *apn, E_DBus_Method_Return_Cb cb, const void *data)
+{
+   EINA_SAFETY_ON_NULL_RETURN_VAL(service, 0);
+   return e_connman_element_property_set_full
+     (service, e_connman_prop_apn, DBUS_TYPE_STRING,
+      apn, cb, data);
+}
+
+/**
+ * Get property "MCC" value.
+ *
+ * If this property isn't found then 0 is returned.
+ * If zero is returned, then this call failed and parameter-returned
+ * values shall be considered invalid.
+ *
+ * If the service is Cellular, then this property
+ * contains the Mobile Country Code.
+ *
+ * @param service_path to get property.
+ * @param mcc 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.
+ *
+ * @return 1 on success, 0 otherwise.
+ */
+bool
+e_connman_service_mcc_get(const E_Connman_Element *service, const char **mcc)
+{
+   EINA_SAFETY_ON_NULL_RETURN_VAL(service, 0);
+   EINA_SAFETY_ON_NULL_RETURN_VAL(mcc, 0);
+   return e_connman_element_property_get_stringshared
+     (service, e_connman_prop_mcc, NULL, mcc);
+}
+
+/**
+ * Get property "MNC" value.
+ *
+ * If this property isn't found then 0 is returned.
+ * If zero is returned, then this call failed and parameter-returned
+ * values shall be considered invalid.
+ *
+ * If the service is Cellular, then this property
+ * contains the Mobile Network Code.
+ *
+ * @param service_path to get property.
+ * @param mnc 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.
+ *
+ * @return 1 on success, 0 otherwise.
+ */
+bool
+e_connman_service_mnc_get(const E_Connman_Element *service, const char **mnc)
+{
+   EINA_SAFETY_ON_NULL_RETURN_VAL(service, 0);
+   EINA_SAFETY_ON_NULL_RETURN_VAL(mnc, 0);
+   return e_connman_element_property_get_stringshared
+     (service, e_connman_prop_mnc, NULL, mnc);
+}
+
+/**
+ * Get property "Roaming" value.
+ *
+ * If this property isn't found then 0 is returned.
+ * If zero 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.
+ *
+ * @param service_path to get property.
+ * @param roaming where to store the property value, must be a
+ *        pointer to boolean (bool *).
+ *
+ * @return 1 on success, 0 otherwise.
+ */
+bool
+e_connman_service_roaming_get(const E_Connman_Element *service, bool *roaming)
+{
+   EINA_SAFETY_ON_NULL_RETURN_VAL(service, 0);
+   EINA_SAFETY_ON_NULL_RETURN_VAL(roaming, 0);
+   return e_connman_element_property_get_stringshared
+     (service, e_connman_prop_roaming, NULL, roaming);
+}
+
+/**
+ * Get property "IPv4.Method" value.
+ *
+ * If this property isn't found then 0 is returned.
+ * If zero is returned, then this call failed and parameter-returned
+ * values shall be considered invalid.
+ *
+ * The IPv4 configuration method. Possible values here
+ * are "dhcp" and "static".
+ *
+ * @param service_path to get property.
+ * @param 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.
+ *
+ * @return 1 on success, 0 otherwise.
+ * @see e_connman_service_ipv4_method_set()
+ */
+bool
+e_connman_service_ipv4_method_get(const E_Connman_Element *service, const char **method)
+{
+   EINA_SAFETY_ON_NULL_RETURN_VAL(service, 0);
+   EINA_SAFETY_ON_NULL_RETURN_VAL(method, 0);
+   return e_connman_element_property_get_stringshared
+     (service, e_connman_prop_ipv4_method, NULL, method);
+}
+
+/**
+ * Set property "IPv4.Method" value.
+ *
+ * If this property isn't found then 0 is returned.
+ * If zero is returned, then this call failed and parameter-returned
+ * values shall be considered invalid.
+ *
+ * The IPv4 configuration method. Possible values here
+ * are "dhcp" and "static".
+ *
+ * @param service_path to get property.
+ * @param method value to set.
+ * @param cb function to call when server replies or some error happens.
+ * @param data data to give to cb when it is called.
+ *
+ * @return 1 on success, 0 otherwise.
+ * @see e_connman_service_ipv4_method_get()
+ */
+bool
+e_connman_service_ipv4_method_set(E_Connman_Element *service, const char *method, E_DBus_Method_Return_Cb cb, const void *data)
+{
+   EINA_SAFETY_ON_NULL_RETURN_VAL(service, 0);
+   return e_connman_element_property_set_full
+     (service, e_connman_prop_ipv4_method, DBUS_TYPE_STRING,
+      method, cb, data);
+}
+
+/**
+ * Get property "IPv4.Address" value.
+ *
+ * If this property isn't found then 0 is returned.
+ * If zero is returned, then this call failed and parameter-returned
+ * values shall be considered invalid.
+ *
+ * The current configured IPv4 address.
+ *
+ * @param service_path to get property.
+ * @param 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.
+ *
+ * @return 1 on success, 0 otherwise.
+ * @see e_connman_service_ipv4_address_set()
+ */
+bool
+e_connman_service_ipv4_address_get(const E_Connman_Element *service, const char **address)
+{
+   EINA_SAFETY_ON_NULL_RETURN_VAL(service, 0);
+   EINA_SAFETY_ON_NULL_RETURN_VAL(address, 0);
+   return e_connman_element_property_get_stringshared
+     (service, e_connman_prop_ipv4_address, NULL, address);
+}
+
+/**
+ * Set property "IPv4.Address" value.
+ *
+ * If this property isn't found then 0 is returned.
+ * If zero is returned, then this call failed and parameter-returned
+ * values shall be considered invalid.
+ *
+ * The current configured IPv4 address.
+ *
+ * @param service_path to get property.
+ * @param address value to set.
+ * @param cb function to call when server replies or some error happens.
+ * @param data data to give to cb when it is called.
+ *
+ * @return 1 on success, 0 otherwise.
+ * @see e_connman_service_ipv4_address_get()
+ */
+bool
+e_connman_service_ipv4_address_set(E_Connman_Element *service, const char *address, E_DBus_Method_Return_Cb cb, const void *data)
+{
+   EINA_SAFETY_ON_NULL_RETURN_VAL(service, 0);
+   return e_connman_element_property_set_full
+     (service, e_connman_prop_ipv4_address, DBUS_TYPE_STRING,
+      address, cb, data);
+}