/*
 * sync-agent
 * Copyright (c) 2012 Samsung Electronics Co., Ltd.
 *
 * Licensed under the Apache License, Version 2.0 (the License);
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

#ifndef EXECUTOR_H_
#define EXECUTOR_H_

#include "common.h"

#ifdef __cplusplus
extern "C" {
#endif				/* __cplusplus */

/**
 * @file executor.h
 * @brief Defines device execution APIs
 */

/** @addtogroup device
 *	@{
 */

/**
 * @brief Executes device function under specific name defined in plug-in
 * @par Usage:
 * @code
 *
 * sync_agent_dev_return_e res = SYNC_AGENT_DEV_RETURN_SUCCESS;
 *
 * res = sync_agent_execute_dev_function(2, "reboot", 0);
 * if (res != SYNC_AGENT_DEV_RETURN_SUCCESS) {
 *    ...
 * }
 *
 * @endcode
 * @param[in] device_plugin_id Device PlugIn ID
 * @param[in] function_name Function name defined in plug-in
 * @param[in] args_cnt Number of following arguments which abbreviated
 * @param[in] ... Arguments which will be handed over plug-in specific for each function
 * @return Operation result
 * @retval SYNC_AGENT_DEV_RETURN_SUCCESS Successful
 * @retval error_value Operation failed
 *
 */
	sync_agent_dev_return_e sync_agent_execute_dev_function(int device_plugin_id, char *function_name, int args_cnt, ...);

/* TODO */
/*
sync_agent_dev_return_e DCI_Execute_Dev_App_Install(const char *platform, char *file_name, char *application_id);
sync_agent_dev_return_e DCI_Execute_Dev_App_UnInstall(const char *platform, char *application_id);
sync_agent_dev_return_e DCI_Execute_Dev_App_Activate(const char *platform, char *application_id, int activate_status);
*/

/**
 *	@}
 */
#ifdef __cplusplus
}
#endif				/* __cplusplus */
#endif				/* EXECUTOR_H_ */