--- /dev/null
+/*
+ * Copyright (c) 2017 Samsung Electronics Co., Ltd All Rights Reserved
+ *
+ * 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.
+ */
+
+
+/**
+ * @file acta_error.h
+ * @brief Error enums and defines.
+ */
+
+
+#ifndef ACTA_ERROR_H
+#define ACTA_ERROR_H
+
+
+#include <errno.h>
+
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+
+#define ACTA_ERROR_BASE -0x01000000
+
+
+/**
+ * @brief Enumeration for ACTA error values.
+ */
+typedef enum {
+ ACTA_ERROR_NONE = 0,
+ ACTA_ERROR_INVALID_PARAMETER = -EINVAL,
+ ACTA_ERROR_OUT_OF_MEMORY = -ENOMEM,
+ ACTA_ERROR_INTERNAL = ACTA_ERROR_BASE | 0x01
+} acta_error_e;
+
+
+#ifdef __cplusplus
+} /* extern */
+#endif
+
+
+#endif /* ACTA_ERROR_H */
--- /dev/null
+/*
+ * Copyright (c) 2017 Samsung Electronics Co., Ltd All Rights Reserved
+ *
+ * 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.
+ */
+
+
+/**
+ * @file app-custom-trust-anchor.h
+ * @brief App custom trust anchor CAPI header.
+ */
+
+
+#ifndef APP_CUSTOM_TRUST_ANCHOR_H
+#define APP_CUSTOM_TRUST_ANCHOR_H
+
+
+#include <stddef.h>
+#include <sys/types.h>
+
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+
+/**
+ * @brief Install app custom trust anchor for global app.
+ * @details App custom certificates would be installed on system.
+ * This function should be called before acta_global_launch().
+ * @param[in] package_id Global package id
+ * @param[in] app_certificates_path App custom certificates path
+ * @param[in] with_system_certificates Whether system certificates use or not
+ * @return #ACTA_ERROR_NONE on success,
+ * negative on error
+ * @retval #ACTA_ERROR_NONE Successful
+ * @retval #ACTA_ERROR_OUT_OF_MEMORY Out of memory error
+ * @retval #ACTA_ERROR_INTERNAL Internal error
+ * @see acta_global_launch()
+ * @see acta_global_uninstall()
+ */
+int acta_global_install(const char *package_id,
+ const char *app_certificates_path,
+ bool with_system_certificates);
+
+
+/**
+ * @brief Install app custom trust anchor for user app.
+ * @details App custom certificates would be installed on system.
+ * This function should be called before acta_usr_launch().
+ * @param[in] package_id User package id
+ * @param[in] app_certificates_path App custom certificates path
+ * @param[in] uid user id
+ * @param[in] with_system_certificates Whether system certificates use or not
+ * @return #ACTA_ERROR_NONE on success,
+ * negative on error
+ * @retval #ACTA_ERROR_NONE Successful
+ * @retval #ACTA_ERROR_OUT_OF_MEMORY Out of memory error
+ * @retval #ACTA_ERROR_INTERNAL Internal error
+ * @see acta_usr_launch()
+ * @see acta_usr_uninstall()
+ */
+int acta_usr_install(const char *package_id,
+ const char *app_certificates_path,
+ uid_t uid,
+ bool with_system_certificates);
+
+
+/**
+ * @brief Launch app custom trust anchor for global app.
+ * @details After lauching app custom trust anchor, app can use custom certificates.
+ * @param[in] package_id Global package id
+ * @param[in] app_certificates_path App custom certificates path
+ * @param[in] with_system_certificates Whether system certificates use or not
+ * @return #ACTA_ERROR_NONE on success,
+ * negative on error
+ * @retval #ACTA_ERROR_NONE Successful
+ * @retval #ACTA_ERROR_OUT_OF_MEMORY Out of memory error
+ * @retval #ACTA_ERROR_INTERNAL Internal error
+ * @see acta_global_install()
+ */
+int acta_global_launch(const char *package_id,
+ const char *app_certificates_path,
+ bool with_system_certificates);
+
+
+/**
+ * @brief Launch app custom trust anchor for user app.
+ * @details After lauching app custom trust anchor, app can use custom certificates.
+ * @param[in] package_id User package id
+ * @param[in] app_certificates_path App custom certificates path
+ * @param[in] with_system_certificates Whether system certificates use or not
+ * @return #ACTA_ERROR_NONE on success,
+ * negative on error
+ * @retval #ACTA_ERROR_NONE Successful
+ * @retval #ACTA_ERROR_OUT_OF_MEMORY Out of memory error
+ * @retval #ACTA_ERROR_INTERNAL Internal error
+ * @see acta_global_install()
+ */
+int acta_usr_launch(const char *package_id,
+ const char *app_certificates_path,
+ uid_t uid,
+ bool with_system_certificates);
+
+
+/**
+ * @brief Uninstall app custom trust anchor for global app.
+ * @param[in] package_id Global package id
+ * @param[in] app_certificates_path App custom certificates path
+ * @return #ACTA_ERROR_NONE on success,
+ * negative on error
+ * @retval #ACTA_ERROR_NONE Successful
+ * @retval #ACTA_ERROR_OUT_OF_MEMORY Out of memory error
+ * @retval #ACTA_ERROR_INTERNAL Internal error
+ * @see acta_global_install()
+ */
+int acta_global_uninstall(const char *package_id,
+ const char *app_certificates_path);
+
+
+/**
+ * @brief Uninstall app custom trust anchor for user app.
+ * @param[in] package_id User package id
+ * @param[in] app_certificates_path App custom certificates path
+ * @return #ACTA_ERROR_NONE on success,
+ * negative on error
+ * @retval #ACTA_ERROR_NONE Successful
+ * @retval #ACTA_ERROR_OUT_OF_MEMORY Out of memory error
+ * @retval #ACTA_ERROR_INTERNAL Internal error
+ * @see acta_usr_install()
+ */
+int acta_usr_uninstall(const char *package_id,
+ const char *app_certificates_path,
+ uid_t uid);
+
+
+#ifdef __cplusplus
+} /* extern */
+#endif
+
+
+#endif /* APP_CUSTOM_TRUST_ANCHOR_H */