From: Sangyoon Jang Date: Wed, 24 Oct 2018 08:34:23 +0000 (+0900) Subject: Rename header file as capability_manager.h X-Git-Tag: submit/submit/tizen/20190214.065356/20190214.070335~9 X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=a3da96bf5dcb4e1d685610f46b27823ca6f4c50e;p=platform%2Fcore%2Fapi%2Fcapability-manager.git Rename header file as capability_manager.h Make it consistent as other native API headers. Change-Id: I6f346bd0ec9d6931817b114b3f10a5fd59f6b0c6 Signed-off-by: Sangyoon Jang --- diff --git a/include/capability-manager.h b/include/capability-manager.h deleted file mode 100644 index 41986c6..0000000 --- a/include/capability-manager.h +++ /dev/null @@ -1,589 +0,0 @@ -// Copyright (c) 2018 Samsung Electronics Co., Ltd All Rights Reserved -// Use of this source code is governed by a apache 2.0 license that can be -// found in the LICENSE file. - -#ifndef __TIZEN_APPFW_CAPABILITY_MANAGER_H__ -#define __TIZEN_APPFW_CAPABILITY_MANAGER_H__ - -#include - -#ifdef __cplusplus -extern "C" { -#endif - -/** - * @file capability-manager.h - */ - -/** - * @addtogroup CAPI_CAPABILITY_MANAGER_MODULE - * @{ - */ - -/** - * @brief Enumerations for Capability Manager Errors. - * @since_tizen 5.0 - */ -typedef enum { - CAPMGR_ERROR_NONE = TIZEN_ERROR_NONE, /**< Successful */ - CAPMGR_ERROR_INVALID_PARAMETER = TIZEN_ERROR_INVALID_PARAMETER, /**< Invalid parameter */ - CAPMGR_ERROR_OUT_OF_MEMORY = TIZEN_ERROR_OUT_OF_MEMORY, /**< Out of memory */ - CAPMGR_ERROR_IO_ERROR = TIZEN_ERROR_IO_ERROR, /**< Internal I/O error */ -} capmgr_error_e; - -/** - * @brief Enumerations for Capability Manager app control result type. - * @since_tizen 5.0 - */ -typedef enum { - CAPMGR_APP_CONTROL_RESULT_OK, /**< Successful */ -} capmgr_app_control_result_e; - -/** - * @brief Capability Manager device handle. - * @since_tizen 5.0 - */ -typedef struct capmgr_device_s* capmgr_device_h; - -/** - * @brief Capability Manager app control handle. - * @since_tizen 5.0 - */ -typedef struct capmgr_app_control_s* capmgr_app_control_h; - -/** - * @brief Capability Manager package info handle. - * @since_tizen 5.0 - */ -typedef struct capmgr_package_info_s* capmgr_package_info_h; - -/** - * @brief Called to retrieve information of devices currently discovered. - * @since_tizen 5.0 - * - * @remarks The @a device can be used only in the callback. To use outside, make a copy. - * @param[in] device Device handle - * @param[in] user_data The user data to be passed to the callback function - * @see capmgr_device_foreach_devices() - */ -typedef int (*capmgr_device_foreach_cb)(const capmgr_device_h device, - void* user_data); - -/** - * @brief Called when send app control request has finished. - * @since_tizen 5.0 - * - * @remarks The @a request, @reply can be used only in the callback. To use outside, make a copy. - * @param[in] request Capability Manager app control handle contains data to be sent - * @param[in] reply Capability Manager app control handle which contains - * reply for request - * @param[in] result App control send result - * @param[in] user_data The user data to be passed to the callback function - * @see capmgr_app_control_send() - */ -typedef int (*capmgr_app_control_reply_cb)(const capmgr_app_control_h request, - const capmgr_app_control_h reply, capmgr_app_control_result_e result, - void* user_data); - -/** - * @brief Called for each remote package info. - * @since_tizen 5.0 - * - * @remarks The @a remote_package_info can be used only in the callback. To use outside, make a copy. - * @param[in] remote_package_info Capability Manager package info handle - * @param[in] user_data The user data to be passed to the callback function - * @see capmgr_package_info_foreach_packages() - */ -typedef int (*capmgr_package_info_foreach_package_cb)( - const capmgr_package_info_h remote_package_info, void* user_data); - -/** - * @brief Called for each application of remote package. - * @since_tizen 5.0 - * - * @remarks The @a appid can be used only in the callback. To use outside, make a copy. - * @param[in] appid Application ID of remote application - * @param[in] user_data The user data to be passed to the callback function - * @see capmgr_package_info_foreach_applications() - */ -typedef int (*capmgr_package_info_foreach_app_cb)( - const char* appid, void* user_data); - -/** - * @brief Retrieves all remote device info stored on local device. - * @since_tizen 5.0 - * - * @param[in] cb The callback function to invoke - * @param[in] user_data The user data to be passed to the callback function - * @return @c 0 on success, - * otherwise a negative error value - * @retval #CAPMGR_ERROR_NONE Successful - * @retval #CAPMGR_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #CAPMGR_ERROR_IO_ERROR Internal I/O error - * @post This function invokes capmgr_device_foreach_cb() for each remote device information. - * @see capmgr_device_foreach_cb() - * - */ -int capmgr_device_foreach_devices(capmgr_device_foreach_cb cb, - void* user_data); - -/** - * @brief Clones the remote device information handle. - * @since_tizen 5.0 - * @param[in] device The remote device handle - * @param[out] device_clone A newly created remote device information handle, if successfully cloned - * @return @c 0 on success, - * otherwise a negative error value - * @retval #CAPMGR_ERROR_NONE Successful - * @retval #CAPMGR_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #CAPMGR_ERROR_OUT_OF_MEMORY Out of memory - */ -int capmgr_device_clone(const capmgr_device_h device, - capmgr_device_h* device_clone); - -/** - * @brief Destroys the remote device information handle and releases all its resources. - * @since_tizen 5.0 - * @param[in] device The remote device information handle - * @return @c 0 on success, - * otherwise a negative error value - * @retval #CAPMGR_ERROR_NONE Successful - * @retval #CAPMGR_ERROR_INVALID_PARAMETER Invalid parameter - * @see capmgr_device_clone() - * @see capmgr_device_foreach_devices() - */ -int capmgr_device_destroy(capmgr_device_h device); - -/** - * @brief Gets the device ID with the given remote device context. - * @since_tizen 5.0 - * @remarks You must release @a device_id using free(). - * @param[in] device The remote device information handle - * @param[out] device_id The remote device ID of the given remote device context - * @return @c 0 on success, - * otherwise a negative error value - * @retval #CAPMGR_ERROR_NONE Successful - * @retval #CAPMGR_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #CAPMGR_ERROR_OUT_OF_MEMORY Out of memory - * @see capmgr_device_clone() - * @see capmgr_device_foreach_devices() - */ -int capmgr_device_get_device_id(capmgr_device_h device, char** device_id); - -/** - * @brief Gets the model name with the given remote device context. - * @since_tizen 5.0 - * @remarks You must release @a model_name using free(). - * @param[in] device The remote device information handle - * @param[out] model_name The model name of the given remote device context - * @return @c 0 on success, - * otherwise a negative error value - * @retval #CAPMGR_ERROR_NONE Successful - * @retval #CAPMGR_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #CAPMGR_ERROR_OUT_OF_MEMORY Out of memory - * @see capmgr_device_clone() - * @see capmgr_device_foreach_devices() - */ -int capmgr_device_get_model_name(capmgr_device_h device, char** model_name); - -/** - * @brief Gets the device name with the given remote device context. - * @since_tizen 5.0 - * @remarks You must release @a device_name using free(). - * @param[in] device The remote device information handle - * @param[out] device_name The device name of the given remote device context - * @return @c 0 on success, - * otherwise a negative error value - * @retval #CAPMGR_ERROR_NONE Successful - * @retval #CAPMGR_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #CAPMGR_ERROR_OUT_OF_MEMORY Out of memory - * @see capmgr_device_clone() - * @see capmgr_device_foreach_devices() - */ -int capmgr_device_get_device_name(capmgr_device_h device, char** device_name); - -/** - * @brief Gets the platform verion with the given remote device context. - * @since_tizen 5.0 - * @remarks You must release @a platform_ver using free(). - * @param[in] device The remote device information handle - * @param[out] platform_ver The platform version of the given remote device context - * @return @c 0 on success, - * otherwise a negative error value - * @retval #CAPMGR_ERROR_NONE Successful - * @retval #CAPMGR_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #CAPMGR_ERROR_OUT_OF_MEMORY Out of memory - * @see capmgr_device_clone() - * @see capmgr_device_foreach_devices() - */ -int capmgr_device_get_platform_ver(capmgr_device_h device, char** platform_ver); - -/** - * @brief Gets the profile with the given remote device context. - * @since_tizen 5.0 - * @remarks You must release @a profile using free(). - * @param[in] device The remote device information handle - * @param[out] profile The profile value of the given remote device context - * @return @c 0 on success, - * otherwise a negative error value - * @retval #CAPMGR_ERROR_NONE Successful - * @retval #CAPMGR_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #CAPMGR_ERROR_OUT_OF_MEMORY Out of memory - * @see capmgr_device_clone() - * @see capmgr_device_foreach_devices() - */ -int capmgr_device_get_profile(capmgr_device_h device, char** profile); - -/** - * @brief Gets the software verion with the given remote device context. - * @since_tizen 5.0 - * @remarks You must release @a sw_ver using free(). - * @param[in] device The remote device information handle - * @param[out] sw_ver The software version of the given remote device context - * @return @c 0 on success, - * otherwise a negative error value - * @retval #CAPMGR_ERROR_NONE Successful - * @retval #CAPMGR_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #CAPMGR_ERROR_OUT_OF_MEMORY Out of memory - * @see capmgr_device_clone() - * @see capmgr_device_foreach_devices() - */ -int capmgr_device_get_sw_ver(capmgr_device_h device, char** sw_ver); - -/** - * @brief Creates a remote app control handle. - * @since_tizen 5.0 - * @remarks You must release @a app_control using capmgr_app_control_destroy(). - * - * @param[out] app_control The remote app control handle that is newly created on success - * - * @return @c 0 on success, - * otherwise a negative error value - * - * @retval #CAPMGR_ERROR_NONE Successful - * @retval #CAPMGR_ERROR_OUT_OF_MEMORY Out of memory - * @retval #CAPMGR_ERROR_INVALID_PARAMETER Invalid parameter - * @see capmgr_app_control_destroy() - */ -int capmgr_app_control_create(capmgr_app_control_h* app_control); - -/** - * @brief Clones the remote app control handle. - * @since_tizen 5.0 - * @param[in] app_control The remote app control handle - * @param[out] app_control_clone A newly created remote app control handle, if successfully cloned - * @return @c 0 on success, - * otherwise a negative error value - * @retval #CAPMGR_ERROR_NONE Successful - * @retval #CAPMGR_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #CAPMGR_ERROR_OUT_OF_MEMORY Out of memory - */ -int capmgr_app_control_clone(const capmgr_app_control_h app_control, - capmgr_app_control_h* app_control_clone); - -/** - * @brief Destroys the remote app control handle and releases all its resources. - * @since_tizen 5.0 - * @param[in] app_control The remote app control handle - * @return @c 0 on success, - * otherwise a negative error value - * @retval #CAPMGR_ERROR_NONE Successful - * @retval #CAPMGR_ERROR_INVALID_PARAMETER Invalid parameter - * @see capmgr_app_control_create() - */ -int capmgr_app_control_destroy(capmgr_app_control_h app_control); - -/** - * @brief Gets the remote device handle from the given app control context. - * @since_tizen 5.0 - * @remarks You must release @a device using capmgr_device_destroy(). - * @param[in] app_control The remote app control handle - * @param[out] device The remote device handle - * @return @c 0 on success, - * otherwise a negative error value - * @retval #CAPMGR_ERROR_NONE Successful - * @retval #CAPMGR_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #CAPMGR_ERROR_OUT_OF_MEMORY Out of memory - * @see capmgr_app_control_destroy() - */ -int capmgr_app_control_get_device(capmgr_app_control_h app_control, - capmgr_device_h* device); - -/** - * @brief Gets the operation value from the given remote app control context. - * @since_tizen 5.0 - * @remarks You must release @a operation using free(). - * @param[in] app_control The remote app control handle - * @param[out] operation The operation value - * @return @c 0 on success, - * otherwise a negative error value - * @retval #CAPMGR_ERROR_NONE Successful - * @retval #CAPMGR_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #CAPMGR_ERROR_OUT_OF_MEMORY Out of memory - * @see capmgr_app_control_destroy() - */ -int capmgr_app_control_get_operation(capmgr_app_control_h app_control, - char** operation); - -/** - * @brief Gets the URI value from the given remote app control context. - * @since_tizen 5.0 - * @remarks You must release @a uri using free(). - * @param[in] app_control The remote app control handle - * @param[out] uri The URI value - * @return @c 0 on success, - * otherwise a negative error value - * @retval #CAPMGR_ERROR_NONE Successful - * @retval #CAPMGR_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #CAPMGR_ERROR_OUT_OF_MEMORY Out of memory - * @see capmgr_app_control_destroy() - */ -int capmgr_app_control_get_uri(capmgr_app_control_h app_control, - char** uri); - -/** - * @brief Gets the MIME value from the given remote app control context. - * @since_tizen 5.0 - * @remarks You must release @a mime using free(). - * @param[in] app_control The remote app control handle - * @param[out] mime The MIME value - * @return @c 0 on success, - * otherwise a negative error value - * @retval #CAPMGR_ERROR_NONE Successful - * @retval #CAPMGR_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #CAPMGR_ERROR_OUT_OF_MEMORY Out of memory - * @see capmgr_app_control_destroy() - */ -int capmgr_app_control_get_mime(capmgr_app_control_h app_control, - char** mime); - -/** - * @brief Gets the application ID from the given remote app control context. - * @since_tizen 5.0 - * @remarks You must release @a appid using free(). - * @param[in] app_control The remote app control handle - * @param[out] appid The application ID - * @return @c 0 on success, - * otherwise a negative error value - * @retval #CAPMGR_ERROR_NONE Successful - * @retval #CAPMGR_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #CAPMGR_ERROR_OUT_OF_MEMORY Out of memory - * @see capmgr_app_control_destroy() - */ -int capmgr_app_control_get_appid(capmgr_app_control_h app_control, - char** appid); - -/** - * @brief Gets the extra data corresponding to given key from remote app control context. - * @since_tizen 5.0 - * @remarks You must release @a value using free(). - * @param[in] app_control The remote app control handle - * @param[in] key The key value - * @param[out] value The value related with given key - * @return @c 0 on success, - * otherwise a negative error value - * @retval #CAPMGR_ERROR_NONE Successful - * @retval #CAPMGR_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #CAPMGR_ERROR_OUT_OF_MEMORY Out of memory - * @see capmgr_app_control_destroy() - */ -int capmgr_app_control_get_extra_data(capmgr_app_control_h app_control, - const char* key, char** value); - -/** - * @brief Sets the target remote device to given remote app control context. - * @since_tizen 5.0 - * @param[in] app_control The remote app control handle - * @param[in] device The remote device handle to set - * @return @c 0 on success, - * otherwise a negative error value - * @retval #CAPMGR_ERROR_NONE Successful - * @retval #CAPMGR_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #CAPMGR_ERROR_OUT_OF_MEMORY Out of memory - */ -int capmgr_app_control_set_device(capmgr_app_control_h app_control, - const capmgr_device_h device); - -/** - * @brief Sets the operation value to given remote app control context. - * @since_tizen 5.0 - * @param[in] app_control The remote app control handle - * @param[in] operation The operation value to set - * @return @c 0 on success, - * otherwise a negative error value - * @retval #CAPMGR_ERROR_NONE Successful - * @retval #CAPMGR_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #CAPMGR_ERROR_OUT_OF_MEMORY Out of memory - */ -int capmgr_app_control_set_operation(capmgr_app_control_h app_control, - const char* operation); - -/** - * @brief Sets the URI value to given remote app control context. - * @since_tizen 5.0 - * @param[in] app_control The remote app control handle - * @param[in] uri The URI value to set - * @return @c 0 on success, - * otherwise a negative error value - * @retval #CAPMGR_ERROR_NONE Successful - * @retval #CAPMGR_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #CAPMGR_ERROR_OUT_OF_MEMORY Out of memory - */ -int capmgr_app_control_set_uri(capmgr_app_control_h app_control, - const char* uri); - -/** - * @brief Sets the MIME value to given remote app control context. - * @since_tizen 5.0 - * @param[in] app_control The remote app control handle - * @param[in] mime The MIME value to set - * @return @c 0 on success, - * otherwise a negative error value - * @retval #CAPMGR_ERROR_NONE Successful - * @retval #CAPMGR_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #CAPMGR_ERROR_OUT_OF_MEMORY Out of memory - */ -int capmgr_app_control_set_mime(capmgr_app_control_h app_control, - const char* mime); - -/** - * @brief Sets the application ID to given remote app control context. - * @since_tizen 5.0 - * @param[in] app_control The remote app control handle - * @param[in] appid The application ID to set - * @return @c 0 on success, - * otherwise a negative error value - * @retval #CAPMGR_ERROR_NONE Successful - * @retval #CAPMGR_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #CAPMGR_ERROR_OUT_OF_MEMORY Out of memory - */ -int capmgr_app_control_set_appid(capmgr_app_control_h app_control, - const char* appid); - -/** - * @brief Sets the extra data to given remote app control context. - * @since_tizen 5.0 - * @param[in] app_control The remote app control handle - * @param[in] key The key of extra data to set - * @param[in] value The value corresponding to key. - * @return @c 0 on success, - * otherwise a negative error value - * @retval #CAPMGR_ERROR_NONE Successful - * @retval #CAPMGR_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #CAPMGR_ERROR_OUT_OF_MEMORY Out of memory - */ -int capmgr_app_control_add_extra_data(capmgr_app_control_h app_control, - const char* key, const char* value); - -/** - * @brief Removes the extra data corresponding to given key at remote app control context. - * @since_tizen 5.0 - * @param[in] app_control The remote app control handle - * @param[in] key The key of extra data to remove - * @return @c 0 on success, - * otherwise a negative error value - * @retval #CAPMGR_ERROR_NONE Successful - * @retval #CAPMGR_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #CAPMGR_ERROR_OUT_OF_MEMORY Out of memory - */ -int capmgr_app_control_remove_extra_data(capmgr_app_control_h app_control, - const char* key); - -/** - * @brief Sends the app control to remote device specified at handle. - * @since_tizen 5.0 - * @param[in] app_control The remote app control handle - * @param[in] cb Callback to be invoked when send has done - * @param[in] user_data The user data to be passed to the callback function - * @return @c 0 on success, - * otherwise a negative error value - * @retval #CAPMGR_ERROR_NONE Successful - * @retval #CAPMGR_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #CAPMGR_ERROR_OUT_OF_MEMORY Out of memory - */ -int capmgr_app_control_send(capmgr_app_control_h app_control, - capmgr_app_control_reply_cb cb, void* user_data); - -/** - * @brief Retrieves all packages installed at specified remote device and invoke callback each of it. - * @since_tizen 5.0 - * @param[in] device The remote device handle - * @param[in] cb Callback to be invoked for each package - * @param[in] user_data The user data to be passed to the callback function - * @return @c 0 on success, - * otherwise a negative error value - * @retval #CAPMGR_ERROR_NONE Successful - * @retval #CAPMGR_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #CAPMGR_ERROR_IO_ERROR I/O error - * @retval #CAPMGR_ERROR_OUT_OF_MEMORY Out of memory - */ -int capmgr_package_info_foreach_packages(const capmgr_device_h device, - capmgr_package_info_foreach_package_cb cb, void* user_data); - -/** - * @brief Retrieves all applications belongs to given package and invoke callback each of it. - * @since_tizen 5.0 - * @param[in] remote_package_info The package information installed at specific remote device - * @param[in] cb Callback to be invoked for each application - * @param[in] user_data The user data to be passed to the callback function - * @return @c 0 on success, - * otherwise a negative error value - * @retval #CAPMGR_ERROR_NONE Successful - * @retval #CAPMGR_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #CAPMGR_ERROR_IO_ERROR I/O error - * @retval #CAPMGR_ERROR_OUT_OF_MEMORY Out of memory - */ -int capmgr_package_info_foreach_applications( - const capmgr_package_info_h remote_package_info, - capmgr_package_info_foreach_app_cb cb, void* user_data); - -/** - * @brief Gets the package ID from given remote package information. - * @since_tizen 5.0 - * @remarks You must release @a pkgid using free(). - * @param[in] remote_package_info The package information installed at specific remote device - * @param[in] pkgid The package ID - * @return @c 0 on success, - * otherwise a negative error value - * @retval #CAPMGR_ERROR_NONE Successful - * @retval #CAPMGR_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #CAPMGR_ERROR_OUT_OF_MEMORY Out of memory - */ -int capmgr_package_info_get_pkgid(capmgr_package_info_h remote_package_info, - char** pkgid); - -/** - * @brief Gets the label from given remote package information. - * @since_tizen 5.0 - * @remarks You must release @a label using free(). - * @param[in] remote_package_info The package information installed at specific remote device - * @param[in] label The label of package - * @return @c 0 on success, - * otherwise a negative error value - * @retval #CAPMGR_ERROR_NONE Successful - * @retval #CAPMGR_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #CAPMGR_ERROR_OUT_OF_MEMORY Out of memory - */ -int capmgr_package_info_get_label(capmgr_package_info_h remote_package_info, - char** label); - -/** - * @brief Gets the version from given remote package information. - * @since_tizen 5.0 - * @remarks You must release @a version using free(). - * @param[in] remote_package_info The package information installed at specific remote device - * @param[in] version The version of package - * @return @c 0 on success, - * otherwise a negative error value - * @retval #CAPMGR_ERROR_NONE Successful - * @retval #CAPMGR_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #CAPMGR_ERROR_OUT_OF_MEMORY Out of memory - */ -int capmgr_package_info_get_version(capmgr_package_info_h remote_package_info, - char** version); - -#ifdef __cplusplus -} -#endif - -#endif // __TIZEN_APPFW_CAPABILITY_MANAGER_H__ diff --git a/include/capability-manager_internal.h b/include/capability-manager_internal.h deleted file mode 100644 index ff3afdc..0000000 --- a/include/capability-manager_internal.h +++ /dev/null @@ -1,75 +0,0 @@ -// Copyright (c) 2018 Samsung Electronics Co., Ltd All Rights Reserved -// Use of this source code is governed by a apache 2.0 license that can be -// found in the LICENSE file. - -#ifndef INCLUDE_CAPABILITY_MANAGER_INTERNAL_H_ -#define INCLUDE_CAPABILITY_MANAGER_INTERNAL_H_ - -#include "include/capability-manager.h" - -#ifdef __cplusplus -extern "C" { -#endif - - -typedef struct capmgr_file_s* capmgr_file_h; - -typedef int (*capmgr_file_finish_cb)(capmgr_file_h file, - int result, void* user_data); - -typedef int (*capmgr_file_progress_cb)( - capmgr_file_h file, int64_t sent_size, int64_t total_size, - void* user_data); - -/** - * @brief - */ -int capmgr_file_create(capmgr_file_h* file); - -/** - * @brief - */ -int capmgr_file_destroy(capmgr_file_h file); - -/** - * @brief - */ -int capmgr_file_set_device(capmgr_file_h file, - const capmgr_device_h device); - -/** - * @brief - */ -int capmgr_file_set_path(capmgr_file_h file, - const char* file_path); - -/** - * @brief - */ -int capmgr_file_set_finish_cb(capmgr_file_h file, - capmgr_file_finish_cb cb, void* user_data); - -/** - * @brief - */ -int capmgr_file_set_progress_cb(capmgr_file_h file, - capmgr_file_progress_cb cb, void* user_data); - -/** - * @brief - */ -int capmgr_file_send(capmgr_file_h file); - -/* TODO(darrenh.jung) -int capmgr_file_abort(capmgr_file_h file); - -int capmgr_file_cleanup(capmgr_file_h file); - -int capmgr_file_resume(capmgr_file_h file); -*/ - -#ifdef __cplusplus -} -#endif - -#endif // INCLUDE_CAPABILITY_MANAGER_INTERNAL_H_ diff --git a/include/capability_manager.h b/include/capability_manager.h new file mode 100644 index 0000000..e7f1de5 --- /dev/null +++ b/include/capability_manager.h @@ -0,0 +1,589 @@ +// Copyright (c) 2018 Samsung Electronics Co., Ltd All Rights Reserved +// Use of this source code is governed by a apache 2.0 license that can be +// found in the LICENSE file. + +#ifndef __TIZEN_APPFW_CAPABILITY_MANAGER_H__ +#define __TIZEN_APPFW_CAPABILITY_MANAGER_H__ + +#include + +#ifdef __cplusplus +extern "C" { +#endif + +/** + * @file capability_manager.h + */ + +/** + * @addtogroup CAPI_CAPABILITY_MANAGER_MODULE + * @{ + */ + +/** + * @brief Enumerations for Capability Manager Errors. + * @since_tizen 5.0 + */ +typedef enum { + CAPMGR_ERROR_NONE = TIZEN_ERROR_NONE, /**< Successful */ + CAPMGR_ERROR_INVALID_PARAMETER = TIZEN_ERROR_INVALID_PARAMETER, /**< Invalid parameter */ + CAPMGR_ERROR_OUT_OF_MEMORY = TIZEN_ERROR_OUT_OF_MEMORY, /**< Out of memory */ + CAPMGR_ERROR_IO_ERROR = TIZEN_ERROR_IO_ERROR, /**< Internal I/O error */ +} capmgr_error_e; + +/** + * @brief Enumerations for Capability Manager app control result type. + * @since_tizen 5.0 + */ +typedef enum { + CAPMGR_APP_CONTROL_RESULT_OK, /**< Successful */ +} capmgr_app_control_result_e; + +/** + * @brief Capability Manager device handle. + * @since_tizen 5.0 + */ +typedef struct capmgr_device_s* capmgr_device_h; + +/** + * @brief Capability Manager app control handle. + * @since_tizen 5.0 + */ +typedef struct capmgr_app_control_s* capmgr_app_control_h; + +/** + * @brief Capability Manager package info handle. + * @since_tizen 5.0 + */ +typedef struct capmgr_package_info_s* capmgr_package_info_h; + +/** + * @brief Called to retrieve information of devices currently discovered. + * @since_tizen 5.0 + * + * @remarks The @a device can be used only in the callback. To use outside, make a copy. + * @param[in] device Device handle + * @param[in] user_data The user data to be passed to the callback function + * @see capmgr_device_foreach_devices() + */ +typedef int (*capmgr_device_foreach_cb)(const capmgr_device_h device, + void* user_data); + +/** + * @brief Called when send app control request has finished. + * @since_tizen 5.0 + * + * @remarks The @a request, @reply can be used only in the callback. To use outside, make a copy. + * @param[in] request Capability Manager app control handle contains data to be sent + * @param[in] reply Capability Manager app control handle which contains + * reply for request + * @param[in] result App control send result + * @param[in] user_data The user data to be passed to the callback function + * @see capmgr_app_control_send() + */ +typedef int (*capmgr_app_control_reply_cb)(const capmgr_app_control_h request, + const capmgr_app_control_h reply, capmgr_app_control_result_e result, + void* user_data); + +/** + * @brief Called for each remote package info. + * @since_tizen 5.0 + * + * @remarks The @a remote_package_info can be used only in the callback. To use outside, make a copy. + * @param[in] remote_package_info Capability Manager package info handle + * @param[in] user_data The user data to be passed to the callback function + * @see capmgr_package_info_foreach_packages() + */ +typedef int (*capmgr_package_info_foreach_package_cb)( + const capmgr_package_info_h remote_package_info, void* user_data); + +/** + * @brief Called for each application of remote package. + * @since_tizen 5.0 + * + * @remarks The @a appid can be used only in the callback. To use outside, make a copy. + * @param[in] appid Application ID of remote application + * @param[in] user_data The user data to be passed to the callback function + * @see capmgr_package_info_foreach_applications() + */ +typedef int (*capmgr_package_info_foreach_app_cb)( + const char* appid, void* user_data); + +/** + * @brief Retrieves all remote device info stored on local device. + * @since_tizen 5.0 + * + * @param[in] cb The callback function to invoke + * @param[in] user_data The user data to be passed to the callback function + * @return @c 0 on success, + * otherwise a negative error value + * @retval #CAPMGR_ERROR_NONE Successful + * @retval #CAPMGR_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #CAPMGR_ERROR_IO_ERROR Internal I/O error + * @post This function invokes capmgr_device_foreach_cb() for each remote device information. + * @see capmgr_device_foreach_cb() + * + */ +int capmgr_device_foreach_devices(capmgr_device_foreach_cb cb, + void* user_data); + +/** + * @brief Clones the remote device information handle. + * @since_tizen 5.0 + * @param[in] device The remote device handle + * @param[out] device_clone A newly created remote device information handle, if successfully cloned + * @return @c 0 on success, + * otherwise a negative error value + * @retval #CAPMGR_ERROR_NONE Successful + * @retval #CAPMGR_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #CAPMGR_ERROR_OUT_OF_MEMORY Out of memory + */ +int capmgr_device_clone(const capmgr_device_h device, + capmgr_device_h* device_clone); + +/** + * @brief Destroys the remote device information handle and releases all its resources. + * @since_tizen 5.0 + * @param[in] device The remote device information handle + * @return @c 0 on success, + * otherwise a negative error value + * @retval #CAPMGR_ERROR_NONE Successful + * @retval #CAPMGR_ERROR_INVALID_PARAMETER Invalid parameter + * @see capmgr_device_clone() + * @see capmgr_device_foreach_devices() + */ +int capmgr_device_destroy(capmgr_device_h device); + +/** + * @brief Gets the device ID with the given remote device context. + * @since_tizen 5.0 + * @remarks You must release @a device_id using free(). + * @param[in] device The remote device information handle + * @param[out] device_id The remote device ID of the given remote device context + * @return @c 0 on success, + * otherwise a negative error value + * @retval #CAPMGR_ERROR_NONE Successful + * @retval #CAPMGR_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #CAPMGR_ERROR_OUT_OF_MEMORY Out of memory + * @see capmgr_device_clone() + * @see capmgr_device_foreach_devices() + */ +int capmgr_device_get_device_id(capmgr_device_h device, char** device_id); + +/** + * @brief Gets the model name with the given remote device context. + * @since_tizen 5.0 + * @remarks You must release @a model_name using free(). + * @param[in] device The remote device information handle + * @param[out] model_name The model name of the given remote device context + * @return @c 0 on success, + * otherwise a negative error value + * @retval #CAPMGR_ERROR_NONE Successful + * @retval #CAPMGR_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #CAPMGR_ERROR_OUT_OF_MEMORY Out of memory + * @see capmgr_device_clone() + * @see capmgr_device_foreach_devices() + */ +int capmgr_device_get_model_name(capmgr_device_h device, char** model_name); + +/** + * @brief Gets the device name with the given remote device context. + * @since_tizen 5.0 + * @remarks You must release @a device_name using free(). + * @param[in] device The remote device information handle + * @param[out] device_name The device name of the given remote device context + * @return @c 0 on success, + * otherwise a negative error value + * @retval #CAPMGR_ERROR_NONE Successful + * @retval #CAPMGR_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #CAPMGR_ERROR_OUT_OF_MEMORY Out of memory + * @see capmgr_device_clone() + * @see capmgr_device_foreach_devices() + */ +int capmgr_device_get_device_name(capmgr_device_h device, char** device_name); + +/** + * @brief Gets the platform verion with the given remote device context. + * @since_tizen 5.0 + * @remarks You must release @a platform_ver using free(). + * @param[in] device The remote device information handle + * @param[out] platform_ver The platform version of the given remote device context + * @return @c 0 on success, + * otherwise a negative error value + * @retval #CAPMGR_ERROR_NONE Successful + * @retval #CAPMGR_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #CAPMGR_ERROR_OUT_OF_MEMORY Out of memory + * @see capmgr_device_clone() + * @see capmgr_device_foreach_devices() + */ +int capmgr_device_get_platform_ver(capmgr_device_h device, char** platform_ver); + +/** + * @brief Gets the profile with the given remote device context. + * @since_tizen 5.0 + * @remarks You must release @a profile using free(). + * @param[in] device The remote device information handle + * @param[out] profile The profile value of the given remote device context + * @return @c 0 on success, + * otherwise a negative error value + * @retval #CAPMGR_ERROR_NONE Successful + * @retval #CAPMGR_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #CAPMGR_ERROR_OUT_OF_MEMORY Out of memory + * @see capmgr_device_clone() + * @see capmgr_device_foreach_devices() + */ +int capmgr_device_get_profile(capmgr_device_h device, char** profile); + +/** + * @brief Gets the software verion with the given remote device context. + * @since_tizen 5.0 + * @remarks You must release @a sw_ver using free(). + * @param[in] device The remote device information handle + * @param[out] sw_ver The software version of the given remote device context + * @return @c 0 on success, + * otherwise a negative error value + * @retval #CAPMGR_ERROR_NONE Successful + * @retval #CAPMGR_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #CAPMGR_ERROR_OUT_OF_MEMORY Out of memory + * @see capmgr_device_clone() + * @see capmgr_device_foreach_devices() + */ +int capmgr_device_get_sw_ver(capmgr_device_h device, char** sw_ver); + +/** + * @brief Creates a remote app control handle. + * @since_tizen 5.0 + * @remarks You must release @a app_control using capmgr_app_control_destroy(). + * + * @param[out] app_control The remote app control handle that is newly created on success + * + * @return @c 0 on success, + * otherwise a negative error value + * + * @retval #CAPMGR_ERROR_NONE Successful + * @retval #CAPMGR_ERROR_OUT_OF_MEMORY Out of memory + * @retval #CAPMGR_ERROR_INVALID_PARAMETER Invalid parameter + * @see capmgr_app_control_destroy() + */ +int capmgr_app_control_create(capmgr_app_control_h* app_control); + +/** + * @brief Clones the remote app control handle. + * @since_tizen 5.0 + * @param[in] app_control The remote app control handle + * @param[out] app_control_clone A newly created remote app control handle, if successfully cloned + * @return @c 0 on success, + * otherwise a negative error value + * @retval #CAPMGR_ERROR_NONE Successful + * @retval #CAPMGR_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #CAPMGR_ERROR_OUT_OF_MEMORY Out of memory + */ +int capmgr_app_control_clone(const capmgr_app_control_h app_control, + capmgr_app_control_h* app_control_clone); + +/** + * @brief Destroys the remote app control handle and releases all its resources. + * @since_tizen 5.0 + * @param[in] app_control The remote app control handle + * @return @c 0 on success, + * otherwise a negative error value + * @retval #CAPMGR_ERROR_NONE Successful + * @retval #CAPMGR_ERROR_INVALID_PARAMETER Invalid parameter + * @see capmgr_app_control_create() + */ +int capmgr_app_control_destroy(capmgr_app_control_h app_control); + +/** + * @brief Gets the remote device handle from the given app control context. + * @since_tizen 5.0 + * @remarks You must release @a device using capmgr_device_destroy(). + * @param[in] app_control The remote app control handle + * @param[out] device The remote device handle + * @return @c 0 on success, + * otherwise a negative error value + * @retval #CAPMGR_ERROR_NONE Successful + * @retval #CAPMGR_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #CAPMGR_ERROR_OUT_OF_MEMORY Out of memory + * @see capmgr_app_control_destroy() + */ +int capmgr_app_control_get_device(capmgr_app_control_h app_control, + capmgr_device_h* device); + +/** + * @brief Gets the operation value from the given remote app control context. + * @since_tizen 5.0 + * @remarks You must release @a operation using free(). + * @param[in] app_control The remote app control handle + * @param[out] operation The operation value + * @return @c 0 on success, + * otherwise a negative error value + * @retval #CAPMGR_ERROR_NONE Successful + * @retval #CAPMGR_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #CAPMGR_ERROR_OUT_OF_MEMORY Out of memory + * @see capmgr_app_control_destroy() + */ +int capmgr_app_control_get_operation(capmgr_app_control_h app_control, + char** operation); + +/** + * @brief Gets the URI value from the given remote app control context. + * @since_tizen 5.0 + * @remarks You must release @a uri using free(). + * @param[in] app_control The remote app control handle + * @param[out] uri The URI value + * @return @c 0 on success, + * otherwise a negative error value + * @retval #CAPMGR_ERROR_NONE Successful + * @retval #CAPMGR_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #CAPMGR_ERROR_OUT_OF_MEMORY Out of memory + * @see capmgr_app_control_destroy() + */ +int capmgr_app_control_get_uri(capmgr_app_control_h app_control, + char** uri); + +/** + * @brief Gets the MIME value from the given remote app control context. + * @since_tizen 5.0 + * @remarks You must release @a mime using free(). + * @param[in] app_control The remote app control handle + * @param[out] mime The MIME value + * @return @c 0 on success, + * otherwise a negative error value + * @retval #CAPMGR_ERROR_NONE Successful + * @retval #CAPMGR_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #CAPMGR_ERROR_OUT_OF_MEMORY Out of memory + * @see capmgr_app_control_destroy() + */ +int capmgr_app_control_get_mime(capmgr_app_control_h app_control, + char** mime); + +/** + * @brief Gets the application ID from the given remote app control context. + * @since_tizen 5.0 + * @remarks You must release @a appid using free(). + * @param[in] app_control The remote app control handle + * @param[out] appid The application ID + * @return @c 0 on success, + * otherwise a negative error value + * @retval #CAPMGR_ERROR_NONE Successful + * @retval #CAPMGR_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #CAPMGR_ERROR_OUT_OF_MEMORY Out of memory + * @see capmgr_app_control_destroy() + */ +int capmgr_app_control_get_appid(capmgr_app_control_h app_control, + char** appid); + +/** + * @brief Gets the extra data corresponding to given key from remote app control context. + * @since_tizen 5.0 + * @remarks You must release @a value using free(). + * @param[in] app_control The remote app control handle + * @param[in] key The key value + * @param[out] value The value related with given key + * @return @c 0 on success, + * otherwise a negative error value + * @retval #CAPMGR_ERROR_NONE Successful + * @retval #CAPMGR_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #CAPMGR_ERROR_OUT_OF_MEMORY Out of memory + * @see capmgr_app_control_destroy() + */ +int capmgr_app_control_get_extra_data(capmgr_app_control_h app_control, + const char* key, char** value); + +/** + * @brief Sets the target remote device to given remote app control context. + * @since_tizen 5.0 + * @param[in] app_control The remote app control handle + * @param[in] device The remote device handle to set + * @return @c 0 on success, + * otherwise a negative error value + * @retval #CAPMGR_ERROR_NONE Successful + * @retval #CAPMGR_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #CAPMGR_ERROR_OUT_OF_MEMORY Out of memory + */ +int capmgr_app_control_set_device(capmgr_app_control_h app_control, + const capmgr_device_h device); + +/** + * @brief Sets the operation value to given remote app control context. + * @since_tizen 5.0 + * @param[in] app_control The remote app control handle + * @param[in] operation The operation value to set + * @return @c 0 on success, + * otherwise a negative error value + * @retval #CAPMGR_ERROR_NONE Successful + * @retval #CAPMGR_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #CAPMGR_ERROR_OUT_OF_MEMORY Out of memory + */ +int capmgr_app_control_set_operation(capmgr_app_control_h app_control, + const char* operation); + +/** + * @brief Sets the URI value to given remote app control context. + * @since_tizen 5.0 + * @param[in] app_control The remote app control handle + * @param[in] uri The URI value to set + * @return @c 0 on success, + * otherwise a negative error value + * @retval #CAPMGR_ERROR_NONE Successful + * @retval #CAPMGR_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #CAPMGR_ERROR_OUT_OF_MEMORY Out of memory + */ +int capmgr_app_control_set_uri(capmgr_app_control_h app_control, + const char* uri); + +/** + * @brief Sets the MIME value to given remote app control context. + * @since_tizen 5.0 + * @param[in] app_control The remote app control handle + * @param[in] mime The MIME value to set + * @return @c 0 on success, + * otherwise a negative error value + * @retval #CAPMGR_ERROR_NONE Successful + * @retval #CAPMGR_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #CAPMGR_ERROR_OUT_OF_MEMORY Out of memory + */ +int capmgr_app_control_set_mime(capmgr_app_control_h app_control, + const char* mime); + +/** + * @brief Sets the application ID to given remote app control context. + * @since_tizen 5.0 + * @param[in] app_control The remote app control handle + * @param[in] appid The application ID to set + * @return @c 0 on success, + * otherwise a negative error value + * @retval #CAPMGR_ERROR_NONE Successful + * @retval #CAPMGR_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #CAPMGR_ERROR_OUT_OF_MEMORY Out of memory + */ +int capmgr_app_control_set_appid(capmgr_app_control_h app_control, + const char* appid); + +/** + * @brief Sets the extra data to given remote app control context. + * @since_tizen 5.0 + * @param[in] app_control The remote app control handle + * @param[in] key The key of extra data to set + * @param[in] value The value corresponding to key. + * @return @c 0 on success, + * otherwise a negative error value + * @retval #CAPMGR_ERROR_NONE Successful + * @retval #CAPMGR_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #CAPMGR_ERROR_OUT_OF_MEMORY Out of memory + */ +int capmgr_app_control_add_extra_data(capmgr_app_control_h app_control, + const char* key, const char* value); + +/** + * @brief Removes the extra data corresponding to given key at remote app control context. + * @since_tizen 5.0 + * @param[in] app_control The remote app control handle + * @param[in] key The key of extra data to remove + * @return @c 0 on success, + * otherwise a negative error value + * @retval #CAPMGR_ERROR_NONE Successful + * @retval #CAPMGR_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #CAPMGR_ERROR_OUT_OF_MEMORY Out of memory + */ +int capmgr_app_control_remove_extra_data(capmgr_app_control_h app_control, + const char* key); + +/** + * @brief Sends the app control to remote device specified at handle. + * @since_tizen 5.0 + * @param[in] app_control The remote app control handle + * @param[in] cb Callback to be invoked when send has done + * @param[in] user_data The user data to be passed to the callback function + * @return @c 0 on success, + * otherwise a negative error value + * @retval #CAPMGR_ERROR_NONE Successful + * @retval #CAPMGR_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #CAPMGR_ERROR_OUT_OF_MEMORY Out of memory + */ +int capmgr_app_control_send(capmgr_app_control_h app_control, + capmgr_app_control_reply_cb cb, void* user_data); + +/** + * @brief Retrieves all packages installed at specified remote device and invoke callback each of it. + * @since_tizen 5.0 + * @param[in] device The remote device handle + * @param[in] cb Callback to be invoked for each package + * @param[in] user_data The user data to be passed to the callback function + * @return @c 0 on success, + * otherwise a negative error value + * @retval #CAPMGR_ERROR_NONE Successful + * @retval #CAPMGR_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #CAPMGR_ERROR_IO_ERROR I/O error + * @retval #CAPMGR_ERROR_OUT_OF_MEMORY Out of memory + */ +int capmgr_package_info_foreach_packages(const capmgr_device_h device, + capmgr_package_info_foreach_package_cb cb, void* user_data); + +/** + * @brief Retrieves all applications belongs to given package and invoke callback each of it. + * @since_tizen 5.0 + * @param[in] remote_package_info The package information installed at specific remote device + * @param[in] cb Callback to be invoked for each application + * @param[in] user_data The user data to be passed to the callback function + * @return @c 0 on success, + * otherwise a negative error value + * @retval #CAPMGR_ERROR_NONE Successful + * @retval #CAPMGR_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #CAPMGR_ERROR_IO_ERROR I/O error + * @retval #CAPMGR_ERROR_OUT_OF_MEMORY Out of memory + */ +int capmgr_package_info_foreach_applications( + const capmgr_package_info_h remote_package_info, + capmgr_package_info_foreach_app_cb cb, void* user_data); + +/** + * @brief Gets the package ID from given remote package information. + * @since_tizen 5.0 + * @remarks You must release @a pkgid using free(). + * @param[in] remote_package_info The package information installed at specific remote device + * @param[in] pkgid The package ID + * @return @c 0 on success, + * otherwise a negative error value + * @retval #CAPMGR_ERROR_NONE Successful + * @retval #CAPMGR_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #CAPMGR_ERROR_OUT_OF_MEMORY Out of memory + */ +int capmgr_package_info_get_pkgid(capmgr_package_info_h remote_package_info, + char** pkgid); + +/** + * @brief Gets the label from given remote package information. + * @since_tizen 5.0 + * @remarks You must release @a label using free(). + * @param[in] remote_package_info The package information installed at specific remote device + * @param[in] label The label of package + * @return @c 0 on success, + * otherwise a negative error value + * @retval #CAPMGR_ERROR_NONE Successful + * @retval #CAPMGR_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #CAPMGR_ERROR_OUT_OF_MEMORY Out of memory + */ +int capmgr_package_info_get_label(capmgr_package_info_h remote_package_info, + char** label); + +/** + * @brief Gets the version from given remote package information. + * @since_tizen 5.0 + * @remarks You must release @a version using free(). + * @param[in] remote_package_info The package information installed at specific remote device + * @param[in] version The version of package + * @return @c 0 on success, + * otherwise a negative error value + * @retval #CAPMGR_ERROR_NONE Successful + * @retval #CAPMGR_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #CAPMGR_ERROR_OUT_OF_MEMORY Out of memory + */ +int capmgr_package_info_get_version(capmgr_package_info_h remote_package_info, + char** version); + +#ifdef __cplusplus +} +#endif + +#endif // __TIZEN_APPFW_CAPABILITY_MANAGER_H__ diff --git a/include/capability_manager_internal.h b/include/capability_manager_internal.h new file mode 100644 index 0000000..e24a6ec --- /dev/null +++ b/include/capability_manager_internal.h @@ -0,0 +1,75 @@ +// Copyright (c) 2018 Samsung Electronics Co., Ltd All Rights Reserved +// Use of this source code is governed by a apache 2.0 license that can be +// found in the LICENSE file. + +#ifndef INCLUDE_CAPABILITY_MANAGER_INTERNAL_H_ +#define INCLUDE_CAPABILITY_MANAGER_INTERNAL_H_ + +#include "include/capability_manager.h" + +#ifdef __cplusplus +extern "C" { +#endif + + +typedef struct capmgr_file_s* capmgr_file_h; + +typedef int (*capmgr_file_finish_cb)(capmgr_file_h file, + int result, void* user_data); + +typedef int (*capmgr_file_progress_cb)( + capmgr_file_h file, int64_t sent_size, int64_t total_size, + void* user_data); + +/** + * @brief + */ +int capmgr_file_create(capmgr_file_h* file); + +/** + * @brief + */ +int capmgr_file_destroy(capmgr_file_h file); + +/** + * @brief + */ +int capmgr_file_set_device(capmgr_file_h file, + const capmgr_device_h device); + +/** + * @brief + */ +int capmgr_file_set_path(capmgr_file_h file, + const char* file_path); + +/** + * @brief + */ +int capmgr_file_set_finish_cb(capmgr_file_h file, + capmgr_file_finish_cb cb, void* user_data); + +/** + * @brief + */ +int capmgr_file_set_progress_cb(capmgr_file_h file, + capmgr_file_progress_cb cb, void* user_data); + +/** + * @brief + */ +int capmgr_file_send(capmgr_file_h file); + +/* TODO(darrenh.jung) +int capmgr_file_abort(capmgr_file_h file); + +int capmgr_file_cleanup(capmgr_file_h file); + +int capmgr_file_resume(capmgr_file_h file); +*/ + +#ifdef __cplusplus +} +#endif + +#endif // INCLUDE_CAPABILITY_MANAGER_INTERNAL_H_ diff --git a/packaging/capi-appfw-capmgr.spec b/packaging/capi-appfw-capmgr.spec index 37a2323..ae05be9 100644 --- a/packaging/capi-appfw-capmgr.spec +++ b/packaging/capi-appfw-capmgr.spec @@ -53,7 +53,7 @@ MAJORVER=`echo %{version} | awk 'BEGIN {FS="."}{print $1}'` %{_bindir}/capmgr-test %files devel -%{_includedir}/capability-manager.h -%{_includedir}/capability-manager_internal.h +%{_includedir}/capability_manager.h +%{_includedir}/capability_manager_internal.h %{_libdir}/pkgconfig/%{name}.pc %{_libdir}/lib%{name}.so diff --git a/src/client.cc b/src/client.cc index 4d94287..5356173 100644 --- a/src/client.cc +++ b/src/client.cc @@ -13,7 +13,7 @@ #include #include -#include "include/capability-manager.h" +#include "include/capability_manager.h" #include "src/dbus.h" #include "src/sql_connection.h" #include "src/sql_statement.h" diff --git a/src/client_internal.cc b/src/client_internal.cc index c6ba05e..172d7fd 100644 --- a/src/client_internal.cc +++ b/src/client_internal.cc @@ -10,8 +10,8 @@ #include #include -#include "include/capability-manager.h" -#include "include/capability-manager_internal.h" +#include "include/capability_manager.h" +#include "include/capability_manager_internal.h" #include "src/dbus.h" #include "src/dbus_signal.h" #include "src/utils/logging.h" diff --git a/src/dbus.h b/src/dbus.h index 83336a3..5053cd6 100644 --- a/src/dbus.h +++ b/src/dbus.h @@ -10,7 +10,7 @@ #include -#include "include/capability-manager.h" +#include "include/capability_manager.h" namespace capmgr { diff --git a/tools/capmgr_test.cc b/tools/capmgr_test.cc index d57b732..8c79856 100644 --- a/tools/capmgr_test.cc +++ b/tools/capmgr_test.cc @@ -9,8 +9,8 @@ #include -#include "include/capability-manager.h" -#include "include/capability-manager_internal.h" +#include "include/capability_manager.h" +#include "include/capability_manager_internal.h" namespace bpo = boost::program_options;