Add extension APIs

[platform/core/api/alarm.git] / include / app_alarm_extension.h

diff --git a/include/app_alarm_extension.h b/include/app_alarm_extension.h
index b9abadf..2ea34e0 100644 (file)
--- a/include/app_alarm_extension.h
+++ b/include/app_alarm_extension.h
@@ -96,6 +96,51 @@ int alarm_schedule_service_once_after_delay(app_control_h app_control, int delay
 int alarm_schedule_service_once_at_date(app_control_h app_control, struct tm *date, int *alarm_id);
 
 /**
+ * @brief Changes the system time which tranferred by other module
+ * @since_tizen 3.0
+ * @privlevel  platform
+ * @privilege  %http://tizen.org/privilege/systemsettings.admin
+ *
+ * @param[in]  new_time epoch time to be set
+ * @return     @c 0 on success,
+ *          otherwise a negative error value
+ * @retval  #ALARM_ERROR_NONE   Successful
+ * @retval  #ALARM_ERROR_CONNECTION_FAIL Failed to connect to an alarm server
+ */
+int alarm_set_systime(int new_time);
+
+/**
+ * @brief Changes the system time and compensates the time using propagation delay
+ * @since_tizen 3.0
+ * @privlevel  platform
+ * @privilege  %http://tizen.org/privilege/systemsettings.admin
+ *
+ * @param[in]  new_time system time to be set (seconds, nanoseconds)
+ * @param[in]  req_time time to request to change the system time (seconds, nanoseconds)
+ * @return     @c 0 on success,
+ *          otherwise a negative error value
+ * @retval  #ALARM_ERROR_NONE   Successful
+ * @retval  #ALARM_ERROR_INVALID_PARAMETER  Invalid parameter
+ * @retval  #ALARM_ERROR_CONNECTION_FAIL Failed to connect to an alarm server
+ */
+int alarm_set_systime_with_propagation_delay(struct timespec new_time, struct timespec req_time);
+
+/**
+ * @brief Changes the timezone which tranferred by other module
+ * @since_tizen 3.0
+ * @privlevel  platform
+ * @privilege  %http://tizen.org/privilege/systemsettings.admin
+ *
+ * @param[in]  tzpath_str the path to timezone definition file
+ * @return     @c 0 on success,
+ *          otherwise a negative error value
+ * @retval  #ALARM_ERROR_NONE   Successful
+ * @retval  #ALARM_ERROR_INVALID_PARAMETER  Invalid parameter
+ * @retval  #ALARM_ERROR_CONNECTION_FAIL Failed to connect to an alarm server
+ */
+int alarm_set_timezone(char *tzpath_str);
+
+/**
  * @}
  */