From cc9647aa557f359ac0f1c5389da6f42f31a41181 Mon Sep 17 00:00:00 2001 From: Hwankyu Jhun Date: Tue, 28 Mar 2017 19:04:16 +0900 Subject: [PATCH] Fix the description about aul_launch_app_async API Change-Id: I5892455bd5c5692bc1fc427001e41e2660e5b293 Signed-off-by: Hwankyu Jhun --- include/aul.h | 56 ++++++++++++++++++++------------------------------------ 1 file changed, 20 insertions(+), 36 deletions(-) diff --git a/include/aul.h b/include/aul.h index 1c69db6..2b0769b 100644 --- a/include/aul.h +++ b/include/aul.h @@ -2757,58 +2757,42 @@ int aul_unset_default_app_by_operation(const char *app_id); /** * @par Description: - * This API launches application with the given bundle asynchronously. - * If the application is not running or a multiple-instance one, this API launches with the given bundle. - * If the application is running, this API sends a RESET event to the App. - * While the application is running, if the application cannot receive the RESET event, - * this API returns a general error(AUL_R_ERROR).\n - * @par Purpose: - * This API is for caller. - * This API's purpose is to launch/reset application with given bundle. - * @par Typical use case: - * If you know the target application's pkgname and bundle types, - * you can use this API to launch/reset the application. + * Sends the launch request asynchronously. * - * @param[in] pkgname package name to be run as callee - * @param[in] kb bundle to be passed to callee - * @return 0 if success, negative value(<0) if fail - * @retval AUL_R_OK - success - * @retval AUL_R_EINVAL - invaild package name - * @retval AUL_R_ECOM - internal AUL IPC error - * @retval AUL_R_ERROR - general error + * @param[in] appid The application ID + * @param[in] kb The Bundle data + * @return a pid of the callee on success, + * otherwise a negative error value + * @retval AUL_R_OK - Successful + * @retval AUL_R_EINVAL - Invalid parameter + * @retval AUL_R_ECOM - Internal AUL IPC error + * @retval AUL_R_ERROR - General error * * @remark * This API is only available in User Session. * This API doesn't check whether the callee application is executed successfully. + * If the caller application is equal to the callee application, this API can return AUL_R_OK. */ int aul_launch_app_async(const char *appid, bundle *kb); /** * @par Description: - * This API launches application with the given bundle asynchronously. - * If the application is not running or a multiple-instance one, this API launches with the given bundle. - * If the application is running, this API sends a RESET event to the App. - * While the application is running, if the application cannot receive the RESET event, - * this API returns a general error(AUL_R_ERROR).\n - * @par Purpose: - * This API is for caller. - * This API's purpose is to launch/reset application with given bundle. - * @par Typical use case: - * If you know the target application's pkgname and bundle types, - * you can use this API to launch/reset the application. + * Sends the launch request asynchronously. * - * @param[in] pkgname package name to be run as callee - * @param[in] kb bundle to be passed to callee + * @param[in] appid The application ID + * @param[in] kb The Bundle data * @param[in] uid User ID - * @return 0 if success, negative value(<0) if fail - * @retval AUL_R_OK - success - * @retval AUL_R_EINVAL - invaild package name - * @retval AUL_R_ECOM - internal AUL IPC error - * @retval AUL_R_ERROR - general error + * @return a pid of the callee on success, + * otherwise a negative error value + * @retval AUL_R_OK - Successful + * @retval AUL_R_EINVAL - Invalid parameter + * @retval AUL_R_ECOM - Internal AUL IPC error + * @retval AUL_R_ERROR - General error * * @remark * This API is only available to System user. * This API doesn't check whether the callee application is executed successfully. + * If the caller application is equal to the callee application, this API can return AUL_R_OK. */ int aul_launch_app_async_for_uid(const char *appid, bundle *kb, uid_t uid); -- 2.7.4