Deprecate all service-adaptor APIs

Change-Id: I619de0b6420d93af071c8320b110a1642546424d
Signed-off-by: Younho Park <younho.park@samsung.com>

diff --git a/api/CMakeLists.txt b/api/CMakeLists.txt
index 82ca22c33388bfc37c9fab9942b7252f66c5eb59..224e698beced6b38e37b34529e10baa70b4720aa 100644 (file)
--- a/api/CMakeLists.txt
+++ b/api/CMakeLists.txt
@@ -13,7 +13,7 @@ MESSAGE(">>> Build type: ${CMAKE_BUILD_TYPE}")
 
 SET(VISIBILITY "-DEXPORT_API=\"__attribute__((visibility(\\\"default\\\")))\"")
 #SET(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} ${VISIBILITY} -fvisibility=hidden")
-SET(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -Wl,--gc-sections")
+SET(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -Wl,--gc-sections -Wno-error=deprecated-declarations")
 
 ADD_DEFINITIONS("-DSERVICE_ADAPTOR_DEBUGGING")
 ADD_DEFINITIONS("-D_SERVICE_ADAPTOR_IPC_CLIENT")

diff --git a/api/client/include/service_adaptor_client_log.h b/api/client/include/service_adaptor_client_log.h
index 08a8d0023a60522c5fd27cb622b3e9ec86369a2a..63a1fe694b5bd8ef27ad35fe42b684fbd50dc7b1 100644 (file)
--- a/api/client/include/service_adaptor_client_log.h
+++ b/api/client/include/service_adaptor_client_log.h
@@ -183,6 +183,10 @@ extern "C"
 #define FUNC_STOP()    do { sac_debug_func(FONT_COLOR_BOLDBLACK"<<==<<== Stop\n%s"FONT_COLOR_RESET, __FUNCTION__); } while (0)
 #define FUNC_END()     do { sac_debug_func(FONT_COLOR_BOLDBLACK"<<<<<<<< End\n%s"FONT_COLOR_RESET, __FUNCTION__); } while (0)
 
+#define DEPRECATED_LOG(api) do { \
+       LOGW("DEPRECATION WARNING: %s() is deprecated and will be removed " \
+               "from next release. Use %s() instead.", api); \
+       } while(0)
 
 #ifdef __cplusplus
 }

diff --git a/api/client/src/service_adaptor_client.c b/api/client/src/service_adaptor_client.c
index 422dce6774954f1214facca435deaebd6cab6f0e..86ea6a43edfa484f76c16252ea2276b10994fe8f 100644 (file)
--- a/api/client/src/service_adaptor_client.c
+++ b/api/client/src/service_adaptor_client.c
@@ -241,6 +241,7 @@ void _service_adaptor_set_last_result(int code, const char *message)
 
 int service_adaptor_get_last_result(int *err)
 {
+       DEPRECATED_LOG(__FUNCTION__);
        FUNC_START();
        int ret = SERVICE_ADAPTOR_ERROR_NONE;
 
@@ -255,6 +256,7 @@ int service_adaptor_get_last_result(int *err)
 
 int service_adaptor_get_last_error_message(char **message)
 {
+       DEPRECATED_LOG(__FUNCTION__);
        FUNC_START();
        int ret = SERVICE_ADAPTOR_ERROR_NONE;
 
@@ -278,6 +280,7 @@ int service_adaptor_get_last_error_message(char **message)
 SERVICE_ADAPTOR_CLIENT_PUBLIC_API
 int service_adaptor_create(service_adaptor_h *handle)
 {
+       DEPRECATED_LOG(__FUNCTION__);
        sac_api_start();
        int ret = SERVICE_ADAPTOR_ERROR_NONE;
        service_adaptor_h service = NULL;
@@ -343,6 +346,7 @@ int service_adaptor_create(service_adaptor_h *handle)
 SERVICE_ADAPTOR_CLIENT_PUBLIC_API
 int service_adaptor_destroy(service_adaptor_h handle)
 {
+       DEPRECATED_LOG(__FUNCTION__);
        sac_api_start();
        int ret = SERVICE_ADAPTOR_ERROR_NONE;
 
@@ -383,6 +387,7 @@ int service_adaptor_foreach_plugin(service_adaptor_h handle,
                                                service_adaptor_plugin_cb callback,
                                                void *user_data)
 {
+       DEPRECATED_LOG(__FUNCTION__);
        sac_api_start();
        int ret = SERVICE_ADAPTOR_ERROR_NONE;
        if (NULL == handle) {
@@ -424,6 +429,7 @@ int service_adaptor_create_plugin(service_adaptor_h handle,
                                                const char *plugin_uri,
                                                service_plugin_h *plugin)
 {
+       DEPRECATED_LOG(__FUNCTION__);
        sac_info("API Called <%s>", __FUNCTION__);
        sac_api_start();
        int ret = SERVICE_ADAPTOR_ERROR_NONE;
@@ -455,6 +461,7 @@ int service_adaptor_create_plugin(service_adaptor_h handle,
 
 int service_plugin_destroy(service_plugin_h plugin)
 {
+       DEPRECATED_LOG(__FUNCTION__);
        sac_api_start();
        int ret = SERVICE_ADAPTOR_ERROR_NONE;
        if (NULL == plugin) {
@@ -477,6 +484,7 @@ int service_plugin_add_property(service_plugin_h handle,
                                                const char *key,
                                                const char *value)
 {
+       DEPRECATED_LOG(__FUNCTION__);
        sac_api_start();
        int ret = SERVICE_ADAPTOR_ERROR_NONE;
        if ((NULL == handle) || (NULL == handle->optional_property)) {
@@ -496,6 +504,7 @@ int service_plugin_add_property(service_plugin_h handle,
 int service_plugin_remove_property(service_plugin_h handle,
                                                const char *key)
 {
+       DEPRECATED_LOG(__FUNCTION__);
        sac_api_start();
        int ret = SERVICE_ADAPTOR_ERROR_NONE;
        if ((NULL == handle) || (NULL == handle->optional_property)) {
@@ -514,6 +523,7 @@ int service_plugin_get_property(service_plugin_h handle,
                                                const char *key,
                                                char **value)
 {
+       DEPRECATED_LOG(__FUNCTION__);
        sac_api_start();
        int ret = SERVICE_ADAPTOR_ERROR_NONE;
        if (NULL == handle) {
@@ -537,6 +547,7 @@ int service_plugin_get_property(service_plugin_h handle,
 int service_plugin_start(service_plugin_h handle,
                                                int service_flag)
 {
+       DEPRECATED_LOG(__FUNCTION__);
        sac_api_start();
        int ret = SERVICE_ADAPTOR_ERROR_NONE;
        int app_ret = 0;
@@ -603,6 +614,7 @@ int service_plugin_start(service_plugin_h handle,
 
 int service_plugin_stop(service_plugin_h handle)
 {
+       DEPRECATED_LOG(__FUNCTION__);
        sac_api_start();
        int ret = SERVICE_ADAPTOR_ERROR_NONE;
        if (NULL == handle) {

diff --git a/api/client/src/service_adaptor_client_storage.c b/api/client/src/service_adaptor_client_storage.c
index 2f288267e4ff1c17b9c67d5c6c793044e6a7b949..fd4910ba3c3f997bde818c9ededf696c008dfe33 100644 (file)
--- a/api/client/src/service_adaptor_client_storage.c
+++ b/api/client/src/service_adaptor_client_storage.c
@@ -188,6 +188,7 @@ int service_storage_create_upload_task(service_plugin_h plugin,
                                                const char *upload_path,
                                                service_storage_task_h *task)
 {
+       DEPRECATED_LOG(__FUNCTION__);
        sac_api_start();
        int ret = SERVICE_ADAPTOR_ERROR_NONE;
        service_adaptor_error_s error;
@@ -260,6 +261,7 @@ int service_storage_create_download_task(service_plugin_h plugin,
                                                const char *download_path,
                                                service_storage_task_h *task)
 {
+       DEPRECATED_LOG(__FUNCTION__);
        sac_api_start();
        int ret = SERVICE_ADAPTOR_ERROR_NONE;
        service_adaptor_error_s error;
@@ -331,6 +333,7 @@ int service_storage_create_download_thumbnail_task(service_plugin_h plugin,
                                                int thumbnail_size,
                                                service_storage_task_h *task)
 {
+       DEPRECATED_LOG(__FUNCTION__);
        sac_api_start();
        int ret = SERVICE_ADAPTOR_ERROR_NONE;
        service_adaptor_error_s error;
@@ -404,6 +407,7 @@ int service_storage_create_download_thumbnail_task(service_plugin_h plugin,
 
 int service_storage_destroy_task(service_storage_task_h task)
 {
+       DEPRECATED_LOG(__FUNCTION__);
        sac_api_start();
        int ret = SERVICE_ADAPTOR_ERROR_NONE;
        service_adaptor_error_s error;
@@ -439,6 +443,7 @@ int service_storage_destroy_task(service_storage_task_h task)
 
 int service_storage_start_task(service_storage_task_h task)
 {
+       DEPRECATED_LOG(__FUNCTION__);
        sac_api_start();
        int ret = SERVICE_ADAPTOR_ERROR_NONE;
        service_adaptor_error_s error;
@@ -489,6 +494,7 @@ int service_storage_start_task(service_storage_task_h task)
 
 int service_storage_cancel_task(service_storage_task_h task)
 {
+       DEPRECATED_LOG(__FUNCTION__);
        sac_api_start();
        int ret = SERVICE_ADAPTOR_ERROR_NONE;
        service_adaptor_error_s error;
@@ -539,6 +545,7 @@ int service_storage_set_task_progress_cb(service_storage_task_h task,
                                                service_storage_task_progress_cb callback,
                                                void *user_data)
 {
+       DEPRECATED_LOG(__FUNCTION__);
        sac_api_start();
        int ret = SERVICE_ADAPTOR_ERROR_NONE;
 
@@ -556,6 +563,7 @@ int service_storage_set_task_progress_cb(service_storage_task_h task,
 
 int service_storage_unset_task_progress_cb(service_storage_task_h task)
 {
+       DEPRECATED_LOG(__FUNCTION__);
        sac_api_start();
        int ret = SERVICE_ADAPTOR_ERROR_NONE;
 
@@ -575,6 +583,7 @@ int service_storage_set_task_state_changed_cb(service_storage_task_h task,
                                                service_storage_task_state_cb callback,
                                                void *user_data)
 {
+       DEPRECATED_LOG(__FUNCTION__);
        sac_api_start();
        int ret = SERVICE_ADAPTOR_ERROR_NONE;
 
@@ -592,6 +601,7 @@ int service_storage_set_task_state_changed_cb(service_storage_task_h task,
 
 int service_storage_unset_task_state_changed_cb(service_storage_task_h task)
 {
+       DEPRECATED_LOG(__FUNCTION__);
        sac_api_start();
        int ret = SERVICE_ADAPTOR_ERROR_NONE;
 
@@ -676,6 +686,7 @@ int service_storage_get_file_list(service_plugin_h plugin,
                                                service_storage_file_list_cb callback,
                                                void *user_data)
 {
+       DEPRECATED_LOG(__FUNCTION__);
        int ret = SERVICE_ADAPTOR_ERROR_NONE;
 
        if ((NULL == plugin) || (NULL == callback) || (NULL == dir_path)) {
@@ -729,6 +740,7 @@ int service_storage_get_file_list(service_plugin_h plugin,
 int service_storage_file_list_clone(service_storage_file_list_h src_list,
                                                service_storage_file_list_h *dst_list)
 {
+       DEPRECATED_LOG(__FUNCTION__);
        sac_api_start();
        int ret = SERVICE_ADAPTOR_ERROR_NONE;
 
@@ -766,6 +778,7 @@ int service_storage_file_list_clone(service_storage_file_list_h src_list,
 
 int service_storage_file_list_destroy(service_storage_file_list_h list)
 {
+       DEPRECATED_LOG(__FUNCTION__);
        sac_api_start();
        int ret = SERVICE_ADAPTOR_ERROR_NONE;
 
@@ -787,6 +800,7 @@ int service_storage_file_list_destroy(service_storage_file_list_h list)
 int service_storage_file_clone(service_storage_file_h src_file,
                                                service_storage_file_h *dst_file)
 {
+       DEPRECATED_LOG(__FUNCTION__);
        sac_api_start();
        int ret = SERVICE_ADAPTOR_ERROR_NONE;
 
@@ -880,6 +894,7 @@ int service_storage_file_clone(service_storage_file_h src_file,
 
 int service_storage_file_destroy(service_storage_file_h file)
 {
+       DEPRECATED_LOG(__FUNCTION__);
        sac_api_start();
        int ret = SERVICE_ADAPTOR_ERROR_NONE;
 
@@ -896,6 +911,7 @@ int service_storage_file_destroy(service_storage_file_h file)
 int service_storage_file_list_get_length(service_storage_file_list_h list,
                                                int *length)
 {
+       DEPRECATED_LOG(__FUNCTION__);
        sac_api_start();
        int ret = SERVICE_ADAPTOR_ERROR_NONE;
 
@@ -914,6 +930,7 @@ int service_storage_file_list_foreach_file(service_storage_file_list_h list,
                                                service_storage_file_cb callback,
                                                void *user_data)
 {
+       DEPRECATED_LOG(__FUNCTION__);
        sac_api_start();
        int ret = SERVICE_ADAPTOR_ERROR_NONE;
 
@@ -941,6 +958,7 @@ int service_storage_file_list_foreach_file(service_storage_file_list_h list,
 int service_storage_file_get_logical_path(service_storage_file_h file,
                                                char **path)
 {
+       DEPRECATED_LOG(__FUNCTION__);
        sac_api_start();
        int ret = SERVICE_ADAPTOR_ERROR_NONE;
 
@@ -958,7 +976,7 @@ int service_storage_file_get_logical_path(service_storage_file_h file,
 int service_storage_file_get_physical_path(service_storage_file_h file,
                                                char **path)
 {
-
+       DEPRECATED_LOG(__FUNCTION__);
        sac_api_start();
        int ret = SERVICE_ADAPTOR_ERROR_NONE;
 
@@ -976,6 +994,7 @@ int service_storage_file_get_physical_path(service_storage_file_h file,
 int service_storage_file_is_dir(service_storage_file_h file,
                                                bool *is_dir)
 {
+       DEPRECATED_LOG(__FUNCTION__);
        sac_api_start();
        int ret = SERVICE_ADAPTOR_ERROR_NONE;
 
@@ -997,6 +1016,7 @@ int service_storage_file_is_dir(service_storage_file_h file,
 int service_storage_file_get_size(service_storage_file_h file,
                                                unsigned long long *size)
 {
+       DEPRECATED_LOG(__FUNCTION__);
        sac_api_start();
        int ret = SERVICE_ADAPTOR_ERROR_NONE;
 
@@ -1043,6 +1063,7 @@ int service_storage_remove(service_plugin_h plugin,
                                                service_storage_result_cb callback,
                                                void *user_data)
 {
+       DEPRECATED_LOG(__FUNCTION__);
        int ret = SERVICE_ADAPTOR_ERROR_NONE;
 
        if ((NULL == plugin) || (NULL == callback) || (NULL == remove_path)) {

diff --git a/doc/service_adaptor_doc.h b/doc/service_adaptor_doc.h
index 17edea708552a2ab910714c52cd60f94a44f6308..5d3d09e9aa61665732adf686da5a0381340fa201 100644 (file)
--- a/doc/service_adaptor_doc.h
+++ b/doc/service_adaptor_doc.h
@@ -20,7 +20,7 @@
 
 /**
  * @ingroup    CAPI_SOCIAL_FRAMEWORK
- * @defgroup   SERVICE_ADAPTOR_MODULE Service Adaptor
+ * @defgroup   SERVICE_ADAPTOR_MODULE Service Adaptor (Deprecated)
  * @brief      The @ref SERVICE_ADAPTOR_MODULE API provides developer with common interfaces like using local service for various service infra.
  *
  * @section    SERVICE_ADAPTOR_MODULE_HEADER Required Header

diff --git a/doc/service_adaptor_plugin_doc.h b/doc/service_adaptor_plugin_doc.h
index 103579eb0778c4839ea29e134e15a7b131852bc2..6f7e6ca70ac296e80b44c95e04c1ce9595b4b4f6 100644 (file)
--- a/doc/service_adaptor_plugin_doc.h
+++ b/doc/service_adaptor_plugin_doc.h
@@ -20,7 +20,7 @@
 
 /**
  * @ingroup    SERVICE_ADAPTOR_MODULE
- * @defgroup   SERVICE_PLUGIN_MODULE Service Plugin
+ * @defgroup   SERVICE_PLUGIN_MODULE Service Plugin (Deprecated)
  * @brief      The @ref SERVICE_PLUGIN_MODULE API provides functions to manage the <b>plugin set</b>'s property and state
  *
  * @section    SERVICE_PLUGIN_MODULE_HEADER Required Header

diff --git a/doc/service_adaptor_storage_doc.h b/doc/service_adaptor_storage_doc.h
index db75d23547ea28b866283596a14d339bd80ae975..5c521d7cc3bb46b05f3ec61fa6b4e20e82e6765b 100644 (file)
--- a/doc/service_adaptor_storage_doc.h
+++ b/doc/service_adaptor_storage_doc.h
@@ -20,7 +20,7 @@
 
 /**
  * @ingroup    SERVICE_PLUGIN_MODULE
- * @defgroup   SERVICE_ADAPTOR_STORAGE_MODULE Storage
+ * @defgroup   SERVICE_ADAPTOR_STORAGE_MODULE Storage (Deprecated)
  * @brief      Provide functions for access and managing storage service
  * @section    SERVICE_ADAPTOR_STORAGE_MODULE_HEADER Require Header
  * \#include <service_adaptor_client.h>

diff --git a/include/service_adaptor_client.h b/include/service_adaptor_client.h
index f9b91f2ddd148e08d5d3fae645315e7264a72d4b..a973de850a63c114059911d33521d3d041d69646 100644 (file)
--- a/include/service_adaptor_client.h
+++ b/include/service_adaptor_client.h
@@ -42,6 +42,7 @@ extern "C" {
 
 
 /**
+ * @deprecated Deprecated since 3.0
  * @brief Enumerations of result code for Service Adaptor
  */
 typedef enum {
@@ -59,6 +60,7 @@ typedef enum {
 } service_adaptor_error_e;
 
 /**
+* @deprecated Deprecated since 3.0
 * @brief The handle for connection and managing plugin handle of Service Adaptor
 * @details The handle can be created by service_adaptor_create()<br>
 *  When a handle is no longer needed, use service_adaptor_destroy()
@@ -68,6 +70,7 @@ typedef enum {
 typedef struct _service_adaptor_s *service_adaptor_h;
 
 /**
+* @deprecated Deprecated since 3.0
 * @brief Callback for service_adaptor_foreach_plugin API
 *
 * @param[in]   plugin_uri      The service plugin's unique uri, this value be set by plugin
@@ -91,6 +94,7 @@ typedef bool (*service_adaptor_plugin_cb)(char *plugin_uri,
 ==================================================================================================*/
 
 /**
+* @deprecated Deprecated since 3.0
 * @brief Create Service Adaptor
 * @since_tizen 2.4
 *
@@ -102,9 +106,10 @@ typedef bool (*service_adaptor_plugin_cb)(char *plugin_uri,
 * @retval #SERVICE_ADAPTOR_ERROR_INVALID_PARAMETER Invalid parameter
 * @retval #SERVICE_ADAPTOR_ERROR_UNKNOWN Unknown error
 */
-int service_adaptor_create(service_adaptor_h *service_adaptor);
+int service_adaptor_create(service_adaptor_h *service_adaptor) TIZEN_DEPRECATED_API;
 
 /**
+* @deprecated Deprecated since 3.0
 * @brief       Destroy Service Adaptor
 * @details     It must called after a program no longer needs any function of Service Adaptor
 * @since_tizen 2.4
@@ -117,9 +122,10 @@ int service_adaptor_create(service_adaptor_h *service_adaptor);
 * @retval #SERVICE_ADAPTOR_ERROR_UNKNOWN Unknown error
 * @pre @a service_adaptor must be issued by service_adaptor_create()
 */
-int service_adaptor_destroy(service_adaptor_h service_adaptor);
+int service_adaptor_destroy(service_adaptor_h service_adaptor) TIZEN_DEPRECATED_API;
 
 /**
+* @deprecated Deprecated since 3.0
 * @brief Foreach the list of plugin
 * @details Iterate to all installed plugin
 * @since_tizen 2.4
@@ -136,9 +142,10 @@ int service_adaptor_destroy(service_adaptor_h service_adaptor);
 */
 int service_adaptor_foreach_plugin(service_adaptor_h service_adaptor,
                                                service_adaptor_plugin_cb callback,
-                                               void *user_data);
+                                               void *user_data) TIZEN_DEPRECATED_API;
 
 /**
+* @deprecated Deprecated since 3.0
 * @brief Create service plugin handle
 * @details Create plugin handle using @a plugin_uri
 * @since_tizen 2.4
@@ -156,9 +163,10 @@ int service_adaptor_foreach_plugin(service_adaptor_h service_adaptor,
 */
 int service_adaptor_create_plugin(service_adaptor_h service_adaptor,
                                                const char *plugin_uri,
-                                               service_plugin_h *plugin);
+                                               service_plugin_h *plugin) TIZEN_DEPRECATED_API;
 
 /**
+* @deprecated Deprecated since 3.0
 * @brief Gets service specfic last result
 * @details This function retrieves the last error code that be issued from plugin.<br>
 *  When if API function returns #SERVICE_ADAPTOR_ERROR_PLUGIN_FAILED, gets using this function.
@@ -175,9 +183,10 @@ int service_adaptor_create_plugin(service_adaptor_h service_adaptor,
 * @retval #SERVICE_ADAPTOR_ERROR_NO_DATA There is no result
 * @retval #SERVICE_ADAPTOR_ERROR_UNKNOWN Unknown error
 */
-int service_adaptor_get_last_result(int *err);
+int service_adaptor_get_last_result(int *err) TIZEN_DEPRECATED_API;
 
 /**
+* @deprecated Deprecated since 3.0
 * @brief Gets service specfic last result error message
 * @details This function retrieves the last error code that be issued from plugin.<br>
 *  When if API function returns #SERVICE_ADAPTOR_ERROR_PLUGIN_FAILED, gets using this function.
@@ -194,9 +203,10 @@ int service_adaptor_get_last_result(int *err);
 * @retval #SERVICE_ADAPTOR_ERROR_NO_DATA There is no error message
 * @retval #SERVICE_ADAPTOR_ERROR_UNKNOWN Unknown error
 */
-int service_adaptor_get_last_error_message(char **message);
+int service_adaptor_get_last_error_message(char **message) TIZEN_DEPRECATED_API;
 
 /**
+* @deprecated Deprecated since 3.0
 * @brief Gets Plugin Property
 * @since_tizen 2.4
 *
@@ -216,7 +226,7 @@ int service_adaptor_get_last_error_message(char **message);
 */
 int service_plugin_get_property(service_plugin_h plugin,
                                                const char *key,
-                                               char **value);
+                                               char **value) TIZEN_DEPRECATED_API;
 
 /**
  * @}

diff --git a/include/service_adaptor_client_plugin.h b/include/service_adaptor_client_plugin.h
index 9019ce7abdebeeacb41d853372f991e5181d3590..246827443c78bd380a7b916cb81218665b7284e4 100644 (file)
--- a/include/service_adaptor_client_plugin.h
+++ b/include/service_adaptor_client_plugin.h
@@ -28,6 +28,7 @@ extern "C" {
  */
 
 /**
+ * @deprecated Deprecated since 3.0
  * @brief Type of service in plugin
  */
 typedef enum {
@@ -36,6 +37,7 @@ typedef enum {
 } service_plugin_service_type_e;
 
 /**
+* @deprecated Deprecated since 3.0
 * @brief Definition for the service_plugin property: The application id be issued from service provider for 3rd party developer.
 * @since_tizen 2.4
 * @see service_plugin_add_property()
@@ -45,6 +47,7 @@ typedef enum {
 #define SERVICE_PLUGIN_PROPERTY_APP_KEY                "http://tizen.org/service-adaptor/plugin/property/app_key"
 
 /**
+* @deprecated Deprecated since 3.0
 * @brief Definition for the service_plugin property: The application password be issued from service provider for 3rd party developer.
 * @since_tizen 2.4
 * @see service_plugin_add_property()
@@ -54,6 +57,7 @@ typedef enum {
 #define SERVICE_PLUGIN_PROPERTY_APP_SECRET     "http://tizen.org/service-adaptor/plugin/property/app_secret"
 
 /**
+* @deprecated Deprecated since 3.0
 * @brief Definition for the service_plugin property: The user id for using specific service.
 * @since_tizen 2.4
 * @see service_plugin_add_property()
@@ -64,6 +68,7 @@ typedef enum {
 
 
 /**
+* @deprecated Deprecated since 3.0
 * @brief The Plugn handle for Service Adaptor
 * @details The handle can be created by service_adaptor_create_plugin()<br>
 *  When a handle is no longer needed, use service_plugin_destroy()
@@ -73,6 +78,7 @@ typedef enum {
 typedef struct _service_plugin_s *service_plugin_h;
 
 /**
+* @deprecated Deprecated since 3.0
 * @brief       Destroy Service Adaptor
 * @details     It must called after a program no longer needs APIs of specfic plugin
 * @since_tizen 2.4
@@ -85,9 +91,10 @@ typedef struct _service_plugin_s *service_plugin_h;
 * @retval #SERVICE_ADAPTOR_ERROR_UNKNOWN Unknown error
 * @pre @a plugin must be issued by service_adaptor_create_plugin()
 */
-int service_plugin_destroy(service_plugin_h plugin);
+int service_plugin_destroy(service_plugin_h plugin) TIZEN_DEPRECATED_API;
 
 /**
+* @deprecated Deprecated since 3.0
 * @brief Add Plugin Property
 * @details The plguin property is used for plugin's basic or optional requirement.<br>
 *  This value is not used in Adaptor layer, but it can be uesd to important Key for plugin with service provider.<br>
@@ -110,9 +117,10 @@ int service_plugin_destroy(service_plugin_h plugin);
 */
 int service_plugin_add_property(service_plugin_h plugin,
                                                const char *key,
-                                               const char *value);
+                                               const char *value) TIZEN_DEPRECATED_API;
 
 /**
+* @deprecated Deprecated since 3.0
 * @brief Remove Plugin Property
 * @since_tizen 2.4
 *
@@ -128,9 +136,10 @@ int service_plugin_add_property(service_plugin_h plugin,
 * @see SERVICE_PLUGIN_PROPERTY_USER_ID
 */
 int service_plugin_remove_property(service_plugin_h plugin,
-                                               const char *key);
+                                               const char *key) TIZEN_DEPRECATED_API;
 
 /**
+* @deprecated Deprecated since 3.0
 * @brief Gets Plugin Property
 * @since_tizen 2.4
 *
@@ -151,9 +160,10 @@ int service_plugin_remove_property(service_plugin_h plugin,
 */
 int service_plugin_get_property(service_plugin_h plugin,
                                                const char *key,
-                                               char **value);
+                                               char **value) TIZEN_DEPRECATED_API;
 
 /**
+* @deprecated Deprecated since 3.0
 * @brief Requests start initalization for service plugin
 * @since_tizen 2.4
 *
@@ -177,9 +187,10 @@ int service_plugin_get_property(service_plugin_h plugin,
 * @retval #SERVICE_ADAPTOR_ERROR_UNKNOWN Unknown error
 */
 int service_plugin_start(service_plugin_h plugin,
-                                               int service_mask);
+                                               int service_mask) TIZEN_DEPRECATED_API;
 
 /**
+* @deprecated Deprecated since 3.0
 * @brief Requests stop manually for service plugin
 * @since_tizen 2.4
 *
@@ -195,7 +206,7 @@ int service_plugin_start(service_plugin_h plugin,
 * @retval #SERVICE_ADAPTOR_ERROR_UNKNOWN Unknown error
 * @pre service_plugin_start()
 */
-int service_plugin_stop(service_plugin_h plugin);
+int service_plugin_stop(service_plugin_h plugin) TIZEN_DEPRECATED_API;
 
 /**
  * @}

diff --git a/include/service_adaptor_client_storage.h b/include/service_adaptor_client_storage.h
index 126cce69b62be1943126c89dd7b6928481809b9d..2fe9ff9c3cbd70ca9f10a61107f7b3425304a3d0 100644 (file)
--- a/include/service_adaptor_client_storage.h
+++ b/include/service_adaptor_client_storage.h
@@ -47,6 +47,7 @@ extern "C" {
  */
 
 /**
+* @deprecated Deprecated since 3.0
 * @brief The handle of async task for storage service
 * @see #service_storage_create_download_task()
 * @see #service_storage_create_upload_task()
@@ -54,6 +55,7 @@ extern "C" {
 typedef struct _service_storage_task_s *service_storage_task_h;
 
 /**
+* @deprecated Deprecated since 3.0
 * @brief The handle of file or directory in storage
 * @see #service_storage_file_clone()
 * @see #service_storage_file_destroy()
@@ -61,6 +63,7 @@ typedef struct _service_storage_task_s *service_storage_task_h;
 typedef struct _service_storage_file_s *service_storage_file_h;
 
 /**
+* @deprecated Deprecated since 3.0
 * @brief The list handle of file or directory in storage
 * @see #service_storage_file_list_clone()
 * @see #service_storage_file_list_destroy()
@@ -68,6 +71,7 @@ typedef struct _service_storage_file_s *service_storage_file_h;
 typedef struct _service_storage_file_list_s *service_storage_file_list_h;
 
 /**
+ * @deprecated Deprecated since 3.0
  * @brief Type of storage task
  */
 typedef enum {
@@ -78,6 +82,7 @@ typedef enum {
 } service_storage_task_state_e;
 
 /**
+* @deprecated Deprecated since 3.0
 * @brief Callback for changing state of storage task
 *
 * @param[in]   state           The state of storage task
@@ -90,6 +95,7 @@ typedef void (*service_storage_task_state_cb)(service_storage_task_state_e state
                                                void *user_data);
 
 /**
+* @deprecated Deprecated since 3.0
 * @brief Callback for progress of storage task
 *
 * @param[in]   progress        The progressed amount of storage task
@@ -104,6 +110,7 @@ typedef void (*service_storage_task_progress_cb)(unsigned long long progress,
                                                void *user_data);
 
 /**
+* @deprecated Deprecated since 3.0
 * @brief Callback for getting async storage operation result
 *
 * @param[in]   result          Result code for storage async operation (see #service_adaptor_error_e)
@@ -124,6 +131,7 @@ typedef void (*service_storage_result_cb)(int result,
 
 
 /**
+* @deprecated Deprecated since 3.0
 * @brief Callback for getting file list API
 *
 * @param[in]   result          Result code for #service_storage_get_file_list() (see #service_adaptor_error_e)
@@ -145,6 +153,7 @@ typedef void (*service_storage_file_list_cb)(int result,
                                                void *user_data);
 
 /**
+* @deprecated Deprecated since 3.0
 * @brief Callback for service_storage_file_list_foreach_file API
 *
 * @param[in]   file            The handle of file
@@ -158,6 +167,7 @@ typedef bool (*service_storage_file_cb)(service_storage_file_h file,
                                                void *user_data);
 
 /**
+* @deprecated Deprecated since 3.0
 * @brief Gets file list from storage, asynchronously.
 * @since_tizen 2.4
 * @privlevel   public
@@ -187,9 +197,10 @@ typedef bool (*service_storage_file_cb)(service_storage_file_h file,
 int service_storage_get_file_list(service_plugin_h plugin,
                                                const char *dir_path,
                                                service_storage_file_list_cb callback,
-                                               void *user_data);
+                                               void *user_data) TIZEN_DEPRECATED_API;
 
 /**
+* @deprecated Deprecated since 3.0
 * @brief Removes file or directory in storage
 * @since_tizen 2.4
 * @privlevel   public
@@ -219,9 +230,10 @@ int service_storage_get_file_list(service_plugin_h plugin,
 int service_storage_remove(service_plugin_h plugin,
                                                const char *remove_path,
                                                service_storage_result_cb callback,
-                                               void *user_data);
+                                               void *user_data) TIZEN_DEPRECATED_API;
 
 /**
+* @deprecated Deprecated since 3.0
 * @brief Creates storage task for upload file to storage
 * @since_tizen 2.4
 * @privlevel   public
@@ -256,9 +268,10 @@ int service_storage_remove(service_plugin_h plugin,
 int service_storage_create_upload_task(service_plugin_h plugin,
                                                const char *file_path,
                                                const char *upload_path,
-                                               service_storage_task_h *task);
+                                               service_storage_task_h *task) TIZEN_DEPRECATED_API;
 
 /**
+* @deprecated Deprecated since 3.0
 * @brief Creates storage task for download file from storage
 * @since_tizen 2.4
 * @privlevel   public
@@ -293,9 +306,10 @@ int service_storage_create_upload_task(service_plugin_h plugin,
 int service_storage_create_download_task(service_plugin_h plugin,
                                                const char *storage_path,
                                                const char *download_path,
-                                               service_storage_task_h *task);
+                                               service_storage_task_h *task) TIZEN_DEPRECATED_API;
 
 /**
+* @deprecated Deprecated since 3.0
 * @brief Creates storage task for download thumbnail from storage
 * @since_tizen 2.4
 * @privlevel   public
@@ -334,9 +348,10 @@ int service_storage_create_download_thumbnail_task(service_plugin_h plugin,
                                                const char *storage_path,
                                                const char *download_path,
                                                int thumbnail_size,
-                                               service_storage_task_h *task);
+                                               service_storage_task_h *task) TIZEN_DEPRECATED_API;
 
 /**
+* @deprecated Deprecated since 3.0
 * @brief Destroys storage task
 * @since_tizen 2.4
 *
@@ -353,9 +368,10 @@ int service_storage_create_download_thumbnail_task(service_plugin_h plugin,
 * @retval #SERVICE_ADAPTOR_ERROR_PLUGIN_FAILED Failed in Plugin internal
 * @retval #SERVICE_ADAPTOR_ERROR_UNKNOWN Unknown error
 */
-int service_storage_destroy_task(service_storage_task_h task);
+int service_storage_destroy_task(service_storage_task_h task) TIZEN_DEPRECATED_API;
 
 /**
+* @deprecated Deprecated since 3.0
 * @brief Starts storage task, asynchronously.
 * @since_tizen 2.4
 *
@@ -373,9 +389,10 @@ int service_storage_destroy_task(service_storage_task_h task);
 * @retval #SERVICE_ADAPTOR_ERROR_PLUGIN_FAILED Failed in Plugin internal
 * @retval #SERVICE_ADAPTOR_ERROR_UNKNOWN Unknown error
 */
-int service_storage_start_task(service_storage_task_h task);
+int service_storage_start_task(service_storage_task_h task) TIZEN_DEPRECATED_API;
 
 /**
+* @deprecated Deprecated since 3.0
 * @brief Cancels storage task, asynchronously.
 * @since_tizen 2.4
 *
@@ -392,9 +409,10 @@ int service_storage_start_task(service_storage_task_h task);
 * @retval #SERVICE_ADAPTOR_ERROR_PLUGIN_FAILED Failed in Plugin internal
 * @retval #SERVICE_ADAPTOR_ERROR_UNKNOWN Unknown error
 */
-int service_storage_cancel_task(service_storage_task_h task);
+int service_storage_cancel_task(service_storage_task_h task) TIZEN_DEPRECATED_API;
 
 /**
+* @deprecated Deprecated since 3.0
 * @brief Sets a callback function to be invoked when progress of the task running.
 * @since_tizen 2.4
 *
@@ -416,9 +434,10 @@ int service_storage_cancel_task(service_storage_task_h task);
 */
 int service_storage_set_task_progress_cb(service_storage_task_h task,
                                                service_storage_task_progress_cb callback,
-                                               void *user_data);
+                                               void *user_data) TIZEN_DEPRECATED_API;
 
 /**
+* @deprecated Deprecated since 3.0
 * @brief Unsets the progress callback function.
 * @since_tizen 2.4
 *
@@ -430,10 +449,11 @@ int service_storage_set_task_progress_cb(service_storage_task_h task,
 * @retval #SERVICE_ADAPTOR_ERROR_NONE Successful
 * @retval #SERVICE_ADAPTOR_ERROR_INVALID_PARAMETER Invalid parameter
 */
-int service_storage_unset_task_progress_cb(service_storage_task_h task);
+int service_storage_unset_task_progress_cb(service_storage_task_h task) TIZEN_DEPRECATED_API;
 
 
 /**
+* @deprecated Deprecated since 3.0
 * @brief Sets a callback function to be invoked when change of the task running state.
 * @since_tizen 2.4
 *
@@ -455,9 +475,10 @@ int service_storage_unset_task_progress_cb(service_storage_task_h task);
 */
 int service_storage_set_task_state_changed_cb(service_storage_task_h task,
                                                service_storage_task_state_cb callback,
-                                               void *user_data);
+                                               void *user_data) TIZEN_DEPRECATED_API;
 
 /**
+* @deprecated Deprecated since 3.0
 * @brief Unsets the state changed callback function.
 * @since_tizen 2.4
 *
@@ -469,9 +490,10 @@ int service_storage_set_task_state_changed_cb(service_storage_task_h task,
 * @retval #SERVICE_ADAPTOR_ERROR_NONE Successful
 * @retval #SERVICE_ADAPTOR_ERROR_INVALID_PARAMETER Invalid parameter
 */
-int service_storage_unset_task_state_changed_cb(service_storage_task_h task);
+int service_storage_unset_task_state_changed_cb(service_storage_task_h task) TIZEN_DEPRECATED_API;
 
 /**
+* @deprecated Deprecated since 3.0
 * @brief Clones the file list handle
 * @since_tizen 2.4
 *
@@ -485,9 +507,10 @@ int service_storage_unset_task_state_changed_cb(service_storage_task_h task);
 * @retval #SERVICE_ADAPTOR_ERROR_INVALID_PARAMETER Invalid parameter
 */
 int service_storage_file_list_clone(service_storage_file_list_h src_list,
-                                               service_storage_file_list_h *dst_list);
+                                               service_storage_file_list_h *dst_list) TIZEN_DEPRECATED_API;
 
 /**
+* @deprecated Deprecated since 3.0
 * @brief Destroys the file list handle
 * @since_tizen 2.4
 *
@@ -499,9 +522,10 @@ int service_storage_file_list_clone(service_storage_file_list_h src_list,
 * @retval #SERVICE_ADAPTOR_ERROR_NONE Successful
 * @retval #SERVICE_ADAPTOR_ERROR_INVALID_PARAMETER Invalid parameter
 */
-int service_storage_file_list_destroy(service_storage_file_list_h list);
+int service_storage_file_list_destroy(service_storage_file_list_h list) TIZEN_DEPRECATED_API;
 
 /**
+* @deprecated Deprecated since 3.0
 * @brief Gets length of the file list handle
 * @since_tizen 2.4
 *
@@ -512,9 +536,10 @@ int service_storage_file_list_destroy(service_storage_file_list_h list);
 * @retval #SERVICE_ADAPTOR_ERROR_INVALID_PARAMETER Invalid parameter
 */
 int service_storage_file_list_get_length(service_storage_file_list_h list,
-                                               int *length);
+                                               int *length) TIZEN_DEPRECATED_API;
 
 /**
+* @deprecated Deprecated since 3.0
 * @brief Foreach All of the file from file list
 * @since_tizen 2.4
 *
@@ -529,9 +554,10 @@ int service_storage_file_list_get_length(service_storage_file_list_h list,
 */
 int service_storage_file_list_foreach_file(service_storage_file_list_h list,
                                                service_storage_file_cb callback,
-                                               void *user_data);
+                                               void *user_data) TIZEN_DEPRECATED_API;
 
 /**
+* @deprecated Deprecated since 3.0
 * @brief Clones the file handle
 * @since_tizen 2.4
 *
@@ -545,9 +571,10 @@ int service_storage_file_list_foreach_file(service_storage_file_list_h list,
 * @retval #SERVICE_ADAPTOR_ERROR_INVALID_PARAMETER Invalid parameter
 */
 int service_storage_file_clone(service_storage_file_h src_file,
-                                               service_storage_file_h *dst_file);
+                                               service_storage_file_h *dst_file) TIZEN_DEPRECATED_API;
 
 /**
+* @deprecated Deprecated since 3.0
 * @brief Destroys the file handle
 * @details This function must be used for cloned file handle.
 * @since_tizen 2.4
@@ -559,9 +586,10 @@ int service_storage_file_clone(service_storage_file_h src_file,
 * @retval #SERVICE_ADAPTOR_ERROR_NONE Successful
 * @retval #SERVICE_ADAPTOR_ERROR_INVALID_PARAMETER Invalid parameter
 */
-int service_storage_file_destroy(service_storage_file_h file);
+int service_storage_file_destroy(service_storage_file_h file) TIZEN_DEPRECATED_API;
 
 /**
+* @deprecated Deprecated since 3.0
 * @brief Gets whether directory or file for file handle
 * @since_tizen 2.4
 *
@@ -573,9 +601,10 @@ int service_storage_file_destroy(service_storage_file_h file);
 * @retval #SERVICE_ADAPTOR_ERROR_INVALID_PARAMETER Invalid parameter
 */
 int service_storage_file_is_dir(service_storage_file_h file,
-                                               bool *is_dir);
+                                               bool *is_dir) TIZEN_DEPRECATED_API;
 
 /**
+* @deprecated Deprecated since 3.0
 * @brief Gets size of handle
 * @since_tizen 2.4
 *
@@ -587,9 +616,10 @@ int service_storage_file_is_dir(service_storage_file_h file,
 * @retval #SERVICE_ADAPTOR_ERROR_INVALID_PARAMETER Invalid parameter
 */
 int service_storage_file_get_size(service_storage_file_h file,
-                                               unsigned long long *size);
+                                               unsigned long long *size) TIZEN_DEPRECATED_API;
 
 /**
+* @deprecated Deprecated since 3.0
 * @brief Gets logical path from file handle
 * @since_tizen 2.4
 *
@@ -604,9 +634,10 @@ int service_storage_file_get_size(service_storage_file_h file,
 * @retval #SERVICE_ADAPTOR_ERROR_NO_DATA There is no data
 */
 int service_storage_file_get_logical_path(service_storage_file_h file,
-                                               char **path);
+                                               char **path) TIZEN_DEPRECATED_API;
 
 /**
+* @deprecated Deprecated since 3.0
 * @brief Gets physical path from file handle
 * @since_tizen 2.4
 *
@@ -621,7 +652,7 @@ int service_storage_file_get_logical_path(service_storage_file_h file,
 * @retval #SERVICE_ADAPTOR_ERROR_NO_DATA There is no data
 */
 int service_storage_file_get_physical_path(service_storage_file_h file,
-                                               char **path);
+                                               char **path) TIZEN_DEPRECATED_API;
 
 /**
  * @}