application.h

/*
 * Copyright (c) 2000-2017 Samsung Electronics Co., Ltd All Rights Reserved
 *
 * PROPRIETARY/CONFIDENTIAL
 *
 * This software is the confidential and proprietary information of
 * SAMSUNG ELECTRONICS ("Confidential Information").
 * You shall not disclose such Confidential Information and shall
 * use it only in accordance with the terms of the license agreement
 * you entered into with SAMSUNG ELECTRONICS.
 * SAMSUNG make no representations or warranties about the suitability
 * of the software, either express or implied, including but not
 * limited to the implied warranties of merchantability, fitness for
 * a particular purpose, or non-infringement.
 * SAMSUNG shall not be liable for any damages suffered by licensee as
 * a result of using, modifying or distributing this software or its derivatives.
 */

#ifndef LIBMDM_MDM_APPLICATION_H
#define LIBMDM_MDM_APPLICATION_H

#include "mdm_client_type.h"
#include "stdbool.h"

typedef enum _mdm_app_status {
    MDM_APP_ENABLE  = 1, 
    MDM_APP_DISABLE = 0, 
} mdm_app_status_t;

typedef struct {
    char *       pkg_name; 
    unsigned int usage;    
} app_usage_t;

typedef struct {
    char *        pkg_name; 
    unsigned long usage;    
} app_data_usage_t;

typedef struct {
    int   type;     
    char *pkg_name; 
    long  bytes;    
} app_network_stats_t;

typedef struct {
    int   client_id; 
    void *list;      
} app_control_info_t;

/*
 * @brief Type of struct passed as argument to the Application appstore install/update callbacks.
 * @since_tizen 2.3.2.3
 */
typedef enum {
    MDM_APPSTORE_STATUS_SUCCESS          = TIZEN_ERROR_NONE,
    MDM_APPSTORE_UNKNOWN_ERROR           = TIZEN_ERROR_UNKNOWN,
    MDM_APPSTORE_APP_NOT_AVAILABLE_ERROR = TIZEN_ERROR_INVALID_PARAMETER,
    MDM_APPSTORE_APP_ALREADY_UPDATED     = TIZEN_ERROR_PACKAGE_MANAGER | 0x73,
    MDM_APPSTORE_SERVER_RESPONSE_ERROR   = TIZEN_ERROR_CONNECTION_TIME_OUT,
    MDM_APPSTORE_CONNECTION_ERROR        = TIZEN_ERROR_NETWORK_UNREACHABLE,
    MDM_APPSTORE_APP_DOWNLOAD_ERROR      = TIZEN_ERROR_DOWNLOAD,
    MDM_APPSTORE_APP_INSTALL_ERROR       = TIZEN_ERROR_PACKAGE_MANAGER,
    MDM_APPSTORE_APP_NOT_FOUND_ON_DEVICE = TIZEN_ERROR_APPLICATION | 0x21,
    MDM_APPSTORE_APP_ALREADY_INSTALLED   = TIZEN_ERROR_PACKAGE_MANAGER | 0x72,
} mdm_appstore_error_e;

/*
 * @brief Type of struct passed as argument to the Application appstore install/update callbacks.
 * @since_tizen 2.3.2.3
 * @see mdm_install_application_by_url
 * @see mdm_update_application_by_url
 */
typedef struct {
    mdm_appstore_error_e error_code;        
    char *               error_description; 
    char *               app_name;          
} mdm_appstore_error_info_s;

#ifdef __cplusplus
extern "C" {
#endif


mdm_result_t mdm_install_application(const char *pkg_path);

mdm_result_t mdm_update_application(const char *pkg_path);

mdm_result_t mdm_disable_application(const char *pkg_name);

mdm_result_t mdm_enable_application(const char *pkg_name);

mdm_result_t mdm_uninstall_application(const char *pkg_name);

mdm_status_t mdm_get_application_state(const char *pkg_name);

mdm_data_t *mdm_uninstall_applications(GList *pkg_list);

mdm_result_t mdm_set_application_installation_disabled(const char *pkg_name);

mdm_result_t mdm_set_application_installation_enabled(const char *pkg_name);

mdm_status_t mdm_get_application_installation_disabled(const char *pkg_name);

mdm_result_t mdm_set_application_uninstallation_disabled(const char *pkg_name);

mdm_result_t mdm_set_application_uninstallation_enabled(const char *pkg_name);

mdm_status_t mdm_get_application_uninstallation_disabled(const char *pkg_name);

mdm_result_t mdm_set_application_state(const char *pkg_name, mdm_app_status_t state);

/*
 * @brief API to check if any of privileges on the list is blocked.
 *
 * @since_mdm 1.1.0
 * @since_tizen 2.3.2.3
 *
 * @feature %http://developer.samsung.com/tizen/feature/mdm
 *
 * @par Usage:
 * The function takes a GList argument containing a set of privileges that are checked.
 * If any of them is blocked MDM_TRUE is returned.
 * If all of them are unblocked MDM_FALSE is returned.
 * In case when NULL-list is passed or another error happened MDM_STATUS_ERROR is returned.
 *
 * @code{.c}

    GList *privilege_list = NULL;
    privilege_list = g_list_append(privilege_list, "http://developer.samsung.com/tizen/privilege/mdm.misc");
    privilege_list = g_list_append(privilege_list, "http://developer.samsung.com/tizen/privilege/mdm.restriction");
    privilege_list = g_list_append(privilege_list, "http://developer.samsung.com/tizen/privilege/mdm.kiosk");

    mdm_status_t stat = mdm_is_app_privilege_blocked(privilege_list);

    if (stat == MDM_TRUE)
    {
        // At least one of the privileges is blocked.
    }
    else if (stat == MDM_FALSE)
    {
        // All of the privileges are not blocked.
    }
    else
    {
        // Error occured.
    }

    g_list_free(privilege_list);

 * @endcode
 *
 * @param[in] privilege_list GList contaning strings with privileges to be examined.
 *
 * @return #mdm_status_t : One of below values:
 *
 * @retval @c #MDM_TRUE At least one of the privileges is blocked
 * @retval @c #MDM_FALSE All privileges are not blocked
 * @retval @c #MDM_STATUS_ERROR An error occured
 *
 * @see mdm_get_app_blocked_privileges
 */
mdm_status_t mdm_is_app_privilege_blocked(GList *privilege_list);

/*
 * @brief API to check if a given signature is blocked.
 *
 * @since_mdm 1.1.0
 * @since_tizen 2.3.2.3
 *
 * @feature %http://developer.samsung.com/tizen/feature/mdm
 *
 * @par Usage:
 * The function takes a string argument containing a signature which is checked.
 * If signature is blocked MDM_TRUE is returned.
 * If signature is unblocked MDM_FALSE is returned.
 * In case when NULL-string is passed or another error happened MDM_STATUS_ERROR is returned.
 *
 * @code{.c}

    mdm_status_t stat = mdm_is_app_signature_blocked("com.samsung.ebook");

    if (stat == MDM_TRUE)
    {
        // The signaturee is blocked.
    }
    else if (stat == MDM_FALSE)
    {
        // The signature is not blocked.
    }
    else
    {
        // Error occured.
    }

 * @endcode
 *
 * @param[in] signature Signature to be examined.
 *
 * @return #mdm_status_t : One of below values:
 *
 * @retval @c #MDM_TRUE signature is blocked
 * @retval @c #MDM_FALSE Signature is not blocked
 * @retval @c #MDM_STATUS_ERROR An error occured
 *
 * @see mdm_get_app_blocked_signatures
 */
mdm_status_t mdm_is_app_signature_blocked(const char *signature);

mdm_status_t mdm_is_application_installed(const char *pkg_name);

mdm_status_t mdm_is_application_running(const char *app_id);

mdm_data_t *mdm_get_application_name(const char *pkg_name);

mdm_data_t *mdm_get_application_version(const char *pkg_name);

mdm_data_t *mdm_get_installed_applications_list(void);


mdm_result_t mdm_start_application(const char *app_id);

mdm_result_t mdm_stop_application(const char *app_id);

mdm_data_t *mdm_set_application_state_list(GList *pkg_list, mdm_app_status_t state);

mdm_data_t *mdm_get_application_state_list(mdm_app_status_t state);

mdm_result_t mdm_set_application_installation_mode(mdm_status_t state);

mdm_status_t mdm_get_application_installation_mode(void);

mdm_data_t *mdm_get_application_code_size(const char *pkg_name);

mdm_data_t *mdm_get_application_data_size(const char *pkg_name);

mdm_data_t *mdm_get_application_total_size(const char *pkg_name);

mdm_result_t mdm_get_application_memory_usage(const char *app_id, unsigned int *usage);

mdm_result_t mdm_get_application_cpu_usage(const char *app_id, unsigned long *usage);

mdm_data_t *mdm_get_most_cpu_usage_apps(int appCount, mdm_status_t showAllProcess);

mdm_data_t *mdm_get_most_memory_usage_apps(int appCount, mdm_status_t showAllProcess);

MDM_DEPRECATED_API mdm_data_t *mdm_get_most_data_usage_apps(int appCount);

/*
 * @brief API to add a privilege to the application privilege blacklist.
 *
 * @since_mdm 1.0.0
 *
 * @since_tizen 2.3.2.3
 *
 * @feature %http://developer.samsung.com/tizen/feature/mdm
 *
 * @par Usage:
 * Use this API to blacklist third party applications based on the privileges
 * requested by those applications.
 * Applications with matching privileges will be prevented from being installed.
 * This will not affect existing third party applications that have blacklisted
 * privileges.
 *
 * @remarks
 * The privilege name is added to the installation blacklist and treated as Perl-compatible regular expression
 * (refer to http://www.pcre.org for more details).
 *
 *
 * @code{.c}
    mdm_result_t ret = mdm_add_app_privilege_to_blacklist("http://tizen.org/privilege/camera");
    if (ret == MDM_RESULT_SUCCESS) {
        // Successfully added
    } else {
        // Failed to add
    }

 * @endcode
 *
 * @privlevel public
 * @privilege %http://developer.samsung.com/tizen/privilege/mdm.application
 *
 * @param[in] appPermission  The application privilege to add to the blacklist.
 *
 * @return #mdm_result_t : MDM_RESULT_SUCCESS on success, an error code on error
 *
 * @retval #MDM_RESULT_SUCCESS Successful
 * @retval #MDM_RESULT_FAIL General failure
 * @retval #MDM_RESULT_NOT_SUPPORTED Not supported
 * @retval #MDM_RESULT_INVALID_PARAM Invalid parameter
 * @retval #MDM_RESULT_ACCESS_DENIED The application does not have the privilege to call this function.
 *
 * @par Permission:
 * Usage of this API is restricted to registered clients only.
 *
 * @see mdm_remove_app_privilege_from_blacklist
 *
 */
mdm_result_t mdm_add_app_privilege_to_blacklist(const char *appPermission);

/*
 * @brief API to remove a privilege from the application privilege blacklist.
 *
 * @since_mdm 1.0.0
 *
 * @since_tizen 2.3.2.3
 *
 * @feature %http://developer.samsung.com/tizen/feature/mdm
 *
 * @par Usage:
 * Use this API to remove application privileges from the blacklist.
 *
 * @code{.c}
    mdm_result_t ret = mdm_remove_app_privilege_from_blacklist("http://tizen.org/privilege/camera");
    if (ret == MDM_RESULT_SUCCESS) {
        // Removed the privilege from the blacklist
    } else {
        // Failed to remove the privilege
    }

 * @endcode
 *
 * @privlevel public
 * @privilege %http://developer.samsung.com/tizen/privilege/mdm.application
 *
 * @param[in] appPermission  The application privilege to remove from the
 *                           blacklist.
 *
 * @return #mdm_result_t : MDM_RESULT_SUCCESS on success, an error code on error
 *
 * @retval #MDM_RESULT_SUCCESS Successful
 * @retval #MDM_RESULT_FAIL General failure
 * @retval #MDM_RESULT_NOT_SUPPORTED Not supported
 * @retval #MDM_RESULT_INVALID_PARAM Invalid parameter
 * @retval #MDM_RESULT_ACCESS_DENIED The application does not have the privilege to call this function.
 *
 * @par Permission:
 * Usage of this API is restricted to registered clients only.
 *
 * @see mdm_add_app_privilege_to_blacklist
 *
 */
mdm_result_t mdm_remove_app_privilege_from_blacklist(const char *appPermission);

/*
 * @brief API to add a privilege to the application privilege whitelist.
 *
 * @since_mdm 1.0.0
 *
 * @since_tizen 2.3.2.3
 *
 * @feature %http://developer.samsung.com/tizen/feature/mdm
 *
 * @par Usage:
 * Use this API to whitelist third party applications based on the privileges
 * requested by those applications.
 * Applications with matching privileges will be allowed to be installed on the device.
 * Whitelist takes precedence over the blacklist so if applications with matching privilege
 * are already in the blacklist then the installation is allowed.
 *
 * @remarks
 * The privilege is added to the installation whitelist and treated as Perl-compatible regular expression
 * (refer to http://www.pcre.org for more details). An application with a matching privilege in the whitelist
 * is an exception to the configured privilege blacklist and therefore will be allowed to be installed.
 * Installation is not forbidden as long as the privilege (matching regex-pattern) is not added to the blacklist.
 *
 * @code{.c}
        mdm_result_t ret = mdm_add_app_privilege_to_whitelist("http://tizen.org/privilege/camera");
        if (ret == MDM_RESULT_SUCCESS) {
                // Successfully added
        } else {
                // Failed to add
        }

 * @endcode
 *
 * @privlevel public
 * @privilege %http://developer.samsung.com/tizen/privilege/mdm.application
 *
 * @param[in] app_permission  The application privilege to add to the whitelist.
 *
 * @return #mdm_result_t : MDM_RESULT_SUCCESS on success, an error code on error
 *
 * @retval #MDM_RESULT_SUCCESS Successful
 * @retval #MDM_RESULT_FAIL General failure
 * @retval #MDM_RESULT_NOT_SUPPORTED Not supported
 * @retval #MDM_RESULT_INVALID_PARAM Invalid parameter
 * @retval #MDM_RESULT_ACCESS_DENIED The application does not have the privilege to call this function.
 *
 * @par Permission:
 * Usage of this API is restricted to registered clients only.
 *
 * @see mdm_remove_app_privilege_from_whitelist
 *
 */
mdm_result_t mdm_add_app_privilege_to_whitelist(const char *app_permission);

/*
 * @brief API to remove a privilege from the application privilege whitelist.
 *
 * @since_mdm 1.0.0
 *
 * @since_tizen 2.3.2.3
 *
 * @feature %http://developer.samsung.com/tizen/feature/mdm
 *
 * @par Usage:
 * Use this API to remove application privileges from the whitelist.
 *
 * @code{.c}
        mdm_result_t ret = mdm_remove_app_privilege_from_whitelist("http://tizen.org/privilege/camera");
        if (ret == MDM_RESULT_SUCCESS) {
                // Removed the privilege from the blacklist
        } else {
                // Failed to remove the privilege
        }

 * @endcode
 *
 * @privlevel public
 * @privilege %http://developer.samsung.com/tizen/privilege/mdm.application
 *
 * @param[in] app_permission  The application privilege to remove from the
 *                           whitelist.
 *
 * @return #mdm_result_t : MDM_RESULT_SUCCESS on success, an error code on error
 *
 * @retval #MDM_RESULT_SUCCESS Successful
 * @retval #MDM_RESULT_FAIL General failure
 * @retval #MDM_RESULT_NOT_SUPPORTED Not supported
 * @retval #MDM_RESULT_INVALID_PARAM Invalid parameter
 * @retval #MDM_RESULT_ACCESS_DENIED The application does not have the privilege to call this function.
 *
 * @par Permission:
 * Usage of this API is restricted to registered clients only.
 *
 * @see mdm_add_app_privilege_to_whitelist
 *
 */
mdm_result_t mdm_remove_app_privilege_from_whitelist(const char *app_permission);

/*
 * @brief API to add a signature to the application signature blacklist.
 *
 * @since_mdm 1.0.0
 *
 * @since_tizen 2.3.2.3
 *
 * @feature %http://developer.samsung.com/tizen/feature/mdm
 *
 * @par Usage:
 * Use this API to blacklist third party applications based on the signatures of
 * those applications.
 * Applications that have matching signatures will be prevented from being
 * installed. This will not affect existing third party applications that have
 * blacklisted signatures.
 *
 * @remarks
 * The administrator can use wildcard character "*" instead of specifying a signature
 *
 * @code{.c}
    mdm_result_t ret = mdm_add_app_signature_to_blacklist("sckQjBcGhFQFHc9p3knEkBVecd...");
    if (ret == MDM_RESULT_SUCCESS) {
        // Successfully added
    } else {
        // Failed to add
    }

 * @endcode
 *
 * @privlevel public
 * @privilege %http://developer.samsung.com/tizen/privilege/mdm.application
 *
 * @param[in] appSignature  The application signature to add to the blacklist.
 *
 * @return #mdm_result_t : MDM_RESULT_SUCCESS on success, an error code on error
 *
 * @retval #MDM_RESULT_SUCCESS Successful
 * @retval #MDM_RESULT_FAIL General failure
 * @retval #MDM_RESULT_NOT_SUPPORTED Not supported
 * @retval #MDM_RESULT_INVALID_PARAM Invalid parameter
 * @retval #MDM_RESULT_ACCESS_DENIED The application does not have the privilege to call this function.
 *
 * @par Permission:
 * Usage of this API is restricted to registered clients only.
 *
 * @see mdm_remove_app_signature_from_blacklist
 *
 */
mdm_result_t mdm_add_app_signature_to_blacklist(const char *appSignature);

/*
 * @brief API to remove a signature from the application signature blacklist.
 *
 * @since_mdm 1.0.0
 *
 * @since_tizen 2.3.2.3
 *
 * @feature %http://developer.samsung.com/tizen/feature/mdm
 *
 * @par Usage:
 * Use this API to remove an application signature from the blacklist.
 * Applications with a matching signature are now allowed to be installed.
 *
 * @code{.c}
    mdm_result_t ret = mdm_remove_app_signature_from_blacklist("sckQjBcGhFQFHc9p3knEkBVecd...");
    if (ret == MDM_RESULT_SUCCESS) {
        // Successfully removed
    } else {
        // Failed to remove
    }

 * @endcode
 *
 * @privlevel public
 * @privilege %http://developer.samsung.com/tizen/privilege/mdm.application
 *
 * @param[in] appSignature  The application signature to remove from the
 *                          blacklist.
 *
 * @return #mdm_result_t : MDM_RESULT_SUCCESS on success, an error code on error
 *
 * @retval #MDM_RESULT_SUCCESS Successful
 * @retval #MDM_RESULT_FAIL General failure
 * @retval #MDM_RESULT_NOT_SUPPORTED Not supported
 * @retval #MDM_RESULT_INVALID_PARAM Invalid parameter
 * @retval #MDM_RESULT_ACCESS_DENIED The application does not have the privilege to call this function.
 *
 * @par Permission:
 * Usage of this API is restricted to registered clients only.
 *
 * @see mdm_add_app_signature_to_blacklist
 *
 */
mdm_result_t mdm_remove_app_signature_from_blacklist(const char *appSignature);

/*
 * @brief API to add a signature to the application signature whitelist.
 *
 * @since_mdm 1.0.0
 *
 * @since_tizen 2.3.2.3
 *
 * @feature %http://developer.samsung.com/tizen/feature/mdm
 *
 * @par Usage:
 * Use this API to whitelist third party applications based on the signatures of
 * those applications.
 * Applications that have matching signatures will be allowed to be installed on the device.
 * Whitelist takes precedence over the blacklist so if applications with matching signatures
 * are already in the blacklist then the installation is allowed.
 *
 * @code{.c}
        mdm_result_t ret = mdm_add_app_signature_to_whitelist("sckQjBcGhFQFHc9p3knEkBVecd...");
        if (ret == MDM_RESULT_SUCCESS) {
                // Successfully added
        } else {
                // Failed to add
        }

 * @endcode
 *
 * @privlevel public
 * @privilege %http://developer.samsung.com/tizen/privilege/mdm.application
 *
 * @param[in] app_signature  The application signature to add to the whitelist.
 *
 * @return #mdm_result_t : MDM_RESULT_SUCCESS on success, an error code on error
 *
 * @retval #MDM_RESULT_SUCCESS Successful
 * @retval #MDM_RESULT_FAIL General failure
 * @retval #MDM_RESULT_NOT_SUPPORTED Not supported
 * @retval #MDM_RESULT_INVALID_PARAM Invalid parameter
 * @retval #MDM_RESULT_ACCESS_DENIED The application does not have the privilege to call this function.
 *
 * @par Permission:
 * Usage of this API is restricted to registered clients only.
 *
 * @see mdm_remove_app_signature_from_whitelist
 *
 */
mdm_result_t mdm_add_app_signature_to_whitelist(const char *app_signature);

/*
 * @brief API to remove a signature from the application signature whitelist.
 *
 * @since_mdm 1.0.0
 *
 * @since_tizen 2.3.2.3
 *
 * @feature %http://developer.samsung.com/tizen/feature/mdm
 *
 * @par Usage:
 * Use this API to remove an application signature from the whitelist.
 *
 * @code{.c}
        mdm_result_t ret = mdm_remove_app_signature_from_whitelist("sckQjBcGhFQFHc9p3knEkBVecd...");
        if (ret == MDM_RESULT_SUCCESS) {
                // Successfully removed
        } else {
                // Failed to remove
        }

 * @endcode
 *
 * @privlevel public
 * @privilege %http://developer.samsung.com/tizen/privilege/mdm.application
 *
 * @param[in] app_signature  The application signature to remove from the
 *                          whitelist.
 *
 * @return #mdm_result_t : MDM_RESULT_SUCCESS on success, an error code on error
 *
 * @retval #MDM_RESULT_SUCCESS Successful
 * @retval #MDM_RESULT_FAIL General failure
 * @retval #MDM_RESULT_NOT_SUPPORTED Not supported
 * @retval #MDM_RESULT_INVALID_PARAM Invalid parameter
 * @retval #MDM_RESULT_ACCESS_DENIED The application does not have the privilege to call this function.
 *
 * @par Permission:
 * Usage of this API is restricted to registered clients only.
 *
 * @see mdm_add_app_signature_to_whitelist
 *
 */
mdm_result_t mdm_remove_app_signature_from_whitelist(const char *app_signature);

mdm_data_t *mdm_get_application_network_status_list(void);

mdm_result_t mdm_add_app_package_name_to_whitelist(const char *pkg_name);

mdm_data_t *mdm_get_app_package_names_all_whitelist(void);

mdm_result_t mdm_remove_app_package_name_from_whitelist(const char *pkg_name);

mdm_result_t mdm_clear_all_app_package_names_from_installation_whitelist(void);

mdm_result_t mdm_clear_all_app_package_names_from_uninstallation_whitelist(void);

mdm_result_t mdm_add_app_package_name_to_blacklist(const char *pkg_name);

mdm_data_t *mdm_get_app_package_names_all_blacklist(void);

mdm_result_t mdm_remove_app_package_name_from_blacklist(const char *pkg_name);

mdm_result_t mdm_clear_all_app_package_names_from_installation_blacklist(void);

mdm_result_t mdm_clear_all_app_package_names_from_uninstallation_blacklist(void);

/*
 * @brief API to get the list of blacklisted application privileges.
 *
 * @since_mdm 1.1.0
 *
 * @since_tizen 2.3.1.5
 *
 * @feature %http://developer.samsung.com/tizen/feature/mdm
 *
 * @par Usage:
 * Use this API to get the list of privileges that are blacklisted.
 * The applications with matching privileges will be prevented from being installed.
 *
 * @code{.c}
     mdm_data_t *lp_data = mdm_get_app_privilege_blacklist();
     if (lp_data){
        // success
        GList *blacklist = (GList *)lp_data->data;
        while(blacklist) {
            char *privlege = (char *)blacklist->data;
            // check privilege and block installation
            blacklist = g_list_next(blacklist);
        }

        // Free after use
        mdm_free_data(lp_data);
     } else {
        // fail
     }

 * @endcode
 *
 * @return A list that contains all of the blacklisted privileges for the
 *         calling admin, if successful. Otherwise, return NULL.
 *
 * @see mdm_add_app_privilege_to_blacklist, mdm_remove_app_privilege_from_blacklist,
        mdm_get_app_privilege_all_blacklists
 *
 */
mdm_data_t *mdm_get_app_privilege_blacklist(void);

/*
 * @brief API to get the list of whitelisted application privileges.
 *
 * @since_mdm 1.1.0
 *
 * @since_tizen 2.3.2.3
 *
 * @feature %http://developer.samsung.com/tizen/feature/mdm
 *
 * @par Usage:
 * Use this API to get the list of privileges that are whitelisted.
 * The applications with matching privileges will be allowed to be installed on the device.
 *
 * @code{.c}
         mdm_data_t *lp_data = mdm_get_app_privilege_whitelist();
         if (lp_data){
                // success
                GList *whitelist = (GList *)lp_data->data;
                while(whitelist) {
                        char *privlege = (char *)whitelist->data;
                        // check privilege and allow installation
                        whitelist = g_list_next(whitelist);
                }

        // Free after use
        mdm_free_data(lp_data);
     } else {
        // fail
     }

 * @endcode
 *
 * @return A list that contains all of the whitelisted privileges for the
 *         calling admin, if successful. Otherwise, return NULL.
 *
 * @see mdm_add_app_privilege_to_whitelist, mdm_remove_app_privilege_from_whitelist
 *
 */
mdm_data_t *mdm_get_app_privilege_whitelist(void);

/*
 * @brief API to get the list of blacklisted application signatures.
 *
 * @since_mdm 1.0.0
 *
 * @since_tizen 2.3.2.3
 *
 * @feature %http://developer.samsung.com/tizen/feature/mdm
 *
 * @par Usage:
 * Use this API to get the list of signatures that are blacklisted.
 * Applications with matching signatures are prevented from being installed.
 *
 * @code{.c}
     mdm_data_t *lp_data = mdm_get_app_signature_blacklist();
     if (lp_data){
        // success
        GList *blacklist = (GList *)lp_data->data;
        while(blacklist) {
            char *signature  = (char *)blacklist->data;
            // check signature and block installation
            blacklist = g_list_next(blacklist);
        }
        // Free after use
        mdm_free_data(lp_data);
     } else {
        // fail
     }

 * @endcode
 *
 * @return A list that contains all of the blacklisted signatures, if
 *         successful. Otherwise, return NULL.
 *
 * @see mdm_add_app_signature_to_blacklist, mdm_remove_app_signature_from_blacklist,
        mdm_get_app_signature_all_blacklists
 *
 */
mdm_data_t *mdm_get_app_signature_blacklist(void);

/*
 * @brief API to get the list of whitelisted application signatures.
 *
 * @since_mdm 1.1.0
 *
 * @since_tizen 2.3.2.3
 *
 * @feature %http://developer.samsung.com/tizen/feature/mdm
 *
 * @par Usage:
 * Use this API to get the list of signatures that are whitelisted.
 * Applications with matching signatures are allowed to be installed on the device.
 *
 * @code{.c}
         mdm_data_t *lp_data = mdm_get_app_signature_whitelist();
         if (lp_data){
                // success
                GList *whitelist = (GList *)lp_data->data;
                while(whitelist) {
                        char *signature  = (char *)whitelist->data;
                        // check signature and allow installation
                        whitelist = g_list_next(whitelist);
                }
                // Free after use
                mdm_free_data(lp_data);
         } else {
                // fail
         }

 * @endcode
 *
 * @return A list that contains all of the whitelisted signatures, if
 *         successful. Otherwise, return NULL.
 *
 * @see mdm_add_app_signature_to_whitelist, mdm_remove_app_signature_from_whitelist
 *
 */
mdm_data_t *mdm_get_app_signature_whitelist(void);

/*
 * @brief API to get the list of blacklisted application package privileges for all admins.
 *
 * @since_mdm 1.0.0
 *
 * @since_tizen 2.3.2.3
 *
 * @feature %http://developer.samsung.com/tizen/feature/mdm
 *
 * @par Usage:
 * Use this API to get the list of privileges that are blacklisted.
 * Applications with matching privileges are prevented from being installed.
 * Existing applications on the device with matching privileges will not be
 * disabled.
 *
 * @code{.c}
    mdm_data_t *lp_data = mdm_get_app_privilege_all_blacklists();

    if(lp_data) {
        // success
        list = (GList *)lp_data->data;
        if(list) {
            GList *current = g_list_first(list);
            GList *blacklist = NULL;
            while(current && current->data) {
                app_control_info_t *app_control_info = (app_control_info_t *)current->data;
                printf("client_id : %d", app_control_info->client_id);
                blacklist = (GList *)app_control_info->list;
                while(blacklist && blacklist->data) {
                    char *privilege = (char *)blacklist->data;
                    printf("privielge : %s", privilege);
                    blacklist = g_list_next(blacklist);
                }
                current = g_list_next(current);
            }
        } else {
            // Nothing in the blacklist.
        }
        mdm_free_data(lp_data);
    } else {
        // fail
    }

 * @endcode
 *
 * @return A list that contains all of the blacklisted privileges with the
 *         controlling admin application package name, if successful. Otherwise,
 *         returns NULL.
 *
 * @see mdm_add_app_privilege_to_blacklist
 * @see mdm_remove_app_privilege_from_blacklist
 *
 */
mdm_data_t *mdm_get_app_privilege_all_blacklists(void);

/*
 * @brief API to get the list of whitelisted application privileges for all admins.
 *
 * @since_mdm 1.1.0
 *
 * @since_tizen 2.3.2.3
 *
 * @feature %http://developer.samsung.com/tizen/feature/mdm
 *
 * @par Usage:
 * Use this API to get the list of privileges that are whitelisted.
 * Applications with matching privileges are allowed to be installed on the device.
 *
 * @code{.c}
        mdm_data_t *lp_data = mdm_get_app_privilege_all_whitelists();

    if(lp_data) {
        // success
        list = (GList *)lp_data->data;
        if(list) {
            GList *current = g_list_first(list);
            GList *whitelist = NULL;
            while(current && current->data) {
                app_control_info_t *app_control_info = (app_control_info_t *)current->data;
                printf("client_id : %d", app_control_info->client_id);
                whitelist = (GList *)app_control_info->list;
                while(whitelist && whitelist->data) {
                    char *privilege = (char *)whitelist->data;
                    printf("privielge : %s", privilege);
                    whitelist = g_list_next(whitelist);
                }
                current = g_list_next(current);
            }
        } else {
            // Nothing in the whitelist.
        }
        mdm_free_data(lp_data);
    } else {
        // fail
    }

 * @endcode
 *
 * @return A list that contains all of the whitelisted privileges with the
 *         controlling admin application package name, if successful. Otherwise,
 *         returns NULL.
 *
 * @see mdm_add_app_privilege_to_whitelist
 * @see mdm_remove_app_privilege_from_whitelist
 *
 */
mdm_data_t *mdm_get_app_privilege_all_whitelists(void);

/*
 * @brief API to get the list of blacklisted application package signatures for all admins.
 *
 * @since_mdm 1.0.0
 *
 * @since_tizen 2.3.2.3
 *
 * @feature %http://developer.samsung.com/tizen/feature/mdm
 *
 * @par Usage:
 * Use this API to get the list of signatures that are blacklisted.
 * Existing application packages on the device with matching signatures will not
 * be disabled.
 *
 * @code{.c}
    mdm_data_t *lp_data = mdm_get_app_signature_all_blacklists();

    if(lp_data) {
        // success
        list = (GList *)lp_data->data;
        if(list) {
            GList *current = g_list_first(list);
            GList *blacklist = NULL;
            while(current && current->data) {
                app_control_info_t *app_control_info = (app_control_info_t *)current->data;
                printf("client_id : %d", app_control_info->client_id);
                blacklist = (GList *)app_control_info->list;
                while(blacklist && blacklist->data) {
                    char *signature = (char *)blacklist->data;
                    printf("signature : %s", signature);
                    blacklist = g_list_next(blacklist);
                }
                current = g_list_next(current);
            }
        } else {
            // Nothing in the blacklist.
        }
        mdm_free_data(lp_data);
    } else {
        // fail
    }

 * @endcode
 *
 * @return A list that contains all of the blacklisted signatures for all
 *         the admins on the device, if successful. Otherwise, returns NULL.
 *
 * @see mdm_add_app_signature_to_blacklist, mdm_remove_app_signature_from_blacklist,
 *      mdm_get_app_signature_blacklist
 *
 */
mdm_data_t *mdm_get_app_signature_all_blacklists(void);

/*
 * @brief API to get the list of whitelisted application signatures for all admins.
 *
 * @since_mdm 1.1.0
 *
 * @since_tizen 2.3.2.3
 *
 * @feature %http://developer.samsung.com/tizen/feature/mdm
 *
 * @par Usage:
 * Use this API to get the list of signatures that are allowed.
 * Application packages with matching signatures are allowed to be installed on the device.
 *
 * @code{.c}
        mdm_data_t *lp_data = mdm_get_app_signature_all_whitelists();

    if(lp_data) {
        // success
        list = (GList *)lp_data->data;
        if(list) {
            GList *current = g_list_first(list);
            GList *whitelist = NULL;
            while(current && current->data) {
                app_control_info_t *app_control_info = (app_control_info_t *)current->data;
                printf("client_id : %d", app_control_info->client_id);
                whitelist = (GList *)app_control_info->list;
                while(whitelist && whitelist->data) {
                    char *signature = (char *)whitelist->data;
                    printf("signature : %s", signature);
                    whitelist = g_list_next(whitelist);
                }
                current = g_list_next(current);
            }
        } else {
            // Nothing in the blacklist.
        }
        mdm_free_data(lp_data);
    } else {
        // fail
    }

 * @endcode
 *
 * @return A list that contains all of the whitelisted signatures for all
 *         the admins on the device, if successful. Otherwise, returns NULL.
 *
 * @see mdm_add_app_signature_to_whitelist, mdm_remove_app_signature_from_whitelist
 *
 */
mdm_data_t *mdm_get_app_signature_all_whitelists(void);

/*
 * @brief API to get the list of blocked application privileges.
 *
 * @since_mdm 1.1.0
 *
 * @since_tizen 2.3.2.3
 *
 * @feature %http://developer.samsung.com/tizen/feature/mdm
 *
 * @par Usage:
 * Use this API to get the list of privileges that are blocked.
 * Application packages with matching privileges are prevented from being
 * installed on the device.
 * Existing application packages on the device with matching privileges will not
 * be disabled.
 *
 * @code{.c}
         mdm_data_t *lp_data = mdm_get_blocked_app_privileges();
         if (lp_data){
                // success
                GList *blockedlist = (GList *)lp_data->data;
                while(blockedlist) {
                        char *privilege  = (char *)blockedlist->data;
                        // check privilege and block installation
                        blockedlist = g_list_next(blockedlist);
                }
                // Free after use
                mdm_free_data(lp_data);
         } else {
                // fail
         }

 * @endcode
 *
 * @return A list that contains all the blocked privileges, if
 *         successful. Otherwise, return NULL.
 *
 * @see mdm_add_app_privilege_to_blacklist
 * @see mdm_add_app_privilege_to_whitelist
 * @see mdm_remove_app_privilege_from_blacklist
 * @see mdm_remove_app_privilege_from_whitelist
 *
 */
mdm_data_t *mdm_get_app_blocked_privileges(void);

/*
 * @brief API to get the list of blocked application signatures.
 *
 * @since_mdm 1.1.0
 *
 * @since_tizen 2.3.2.3
 *
 * @feature %http://developer.samsung.com/tizen/feature/mdm
 *
 * @par Usage:
 * Use this API to get the list of signatures that are blocked.
 * Application packages with matching signatures are prevented from being
 * installed on the device.
 * Existing application packages on the device with matching signatures will not
 * be disabled.
 *
 * @code{.c}
         mdm_data_t *lp_data = mdm_get_blocked_app_signatures();
         if (lp_data){
                // success
                GList *blockedlist = (GList *)lp_data->data;
                while(blockedlist) {
                        char *signatures  = (char *)blockedlist->data;
                        // check signature and block installation
                        blockedlist = g_list_next(blockedlist);
                }
                // Free after use
                mdm_free_data(lp_data);
         } else {
                // fail
         }

 * @endcode
 *
 * @return A list that contains all the blocked signatures, if
 *         successful. Otherwise, return NULL.
 *
 * @see mdm_add_app_signature_to_blacklist
 * @see mdm_add_app_signature_to_whitelist
 * @see mdm_remove_app_signature_from_blacklist
 * @see mdm_remove_app_signature_from_whitelist
 *
 */
mdm_data_t *mdm_get_app_blocked_signatures(void);

/*
 * @brief API to clear the application privilege blacklist.
 *
 * @since_mdm 1.1.0
 *
 * @since_tizen 2.3.2.3
 *
 * @feature %http://developer.samsung.com/tizen/feature/mdm
 *
 * @par Usage:
 * Use this API remove all the elements in the application privilege blacklist.
 *
 * @code{.c}
        mdm_result_t ret = mdm_clear_app_privilege_blacklist();
        if (ret == MDM_RESULT_SUCCESS){
                // Blacklist cleared.
        } else {
                // Call failed.
        }
 * @endcode
 *
 * @privlevel public
 * @privilege %http://developer.samsung.com/tizen/privilege/mdm.application
 *
 * @return #mdm_result_t : MDM_RESULT_SUCCESS on success, an error code on error
 *
 * @retval #MDM_RESULT_SUCCESS Successful
 * @retval #MDM_RESULT_FAIL General failure
 * @retval #MDM_RESULT_NOT_SUPPORTED Not supported
 * @retval #MDM_RESULT_INVALID_PARAM Invalid parameter
 * @retval #MDM_RESULT_ACCESS_DENIED The application does not have the privilege to call this function.
 *
 * @par Permission:
 * Usage of this API is restricted to registered clients only.
 *
 */
mdm_result_t mdm_clear_app_privilege_blacklist(void);

/*
 * @brief API to clear the application privilege whitelist.
 *
 * @since_mdm 1.1.0
 *
 * @since_tizen 2.3.2.3
 *
 * @feature %http://developer.samsung.com/tizen/feature/mdm
 *
 * @par Usage:
 * Use this API remove all the elements in the application privilege whitelist.
 *
 * @code{.c}
        mdm_result_t ret = mdm_clear_app_privilege_whitelist();
        if (ret == MDM_RESULT_SUCCESS){
                // Whitelist cleared.
        } else {
                // Call failed.
        }
 * @endcode
 *
 * @privlevel public
 * @privilege %http://developer.samsung.com/tizen/privilege/mdm.application
 *
 * @return #mdm_result_t : MDM_RESULT_SUCCESS on success, an error code on error
 *
 * @retval #MDM_RESULT_SUCCESS Successful
 * @retval #MDM_RESULT_FAIL General failure
 * @retval #MDM_RESULT_NOT_SUPPORTED Not supported
 * @retval #MDM_RESULT_INVALID_PARAM Invalid parameter
 * @retval #MDM_RESULT_ACCESS_DENIED The application does not have the privilege to call this function.
 *
 * @par Permission:
 * Usage of this API is restricted to registered clients only.
 *
 */
mdm_result_t mdm_clear_app_privilege_whitelist(void);

/*
 * @brief API to clear the application signature blacklist.
 *
 * @since_mdm 1.1.0
 *
 * @since_tizen 2.3.2.3
 *
 * @feature %http://developer.samsung.com/tizen/feature/mdm
 *
 * @par Usage:
 * Use this API remove all the elements in the application signature blacklist.
 *
 * @code{.c}
        mdm_result_t ret = mdm_clear_app_signature_blacklist();
        if (ret == MDM_RESULT_SUCCESS){
                // Blacklist cleared.
        } else {
                // Call failed.
        }
 * @endcode
 *
 * @privlevel public
 * @privilege %http://developer.samsung.com/tizen/privilege/mdm.application
 *
 * @return #mdm_result_t : MDM_RESULT_SUCCESS on success, an error code on error
 *
 * @retval #MDM_RESULT_SUCCESS Successful
 * @retval #MDM_RESULT_FAIL General failure
 * @retval #MDM_RESULT_NOT_SUPPORTED Not supported
 * @retval #MDM_RESULT_INVALID_PARAM Invalid parameter
 * @retval #MDM_RESULT_ACCESS_DENIED The application does not have the privilege to call this function.
 *
 * @par Permission:
 * Usage of this API is restricted to registered clients only.
 *
 */
mdm_result_t mdm_clear_app_signature_blacklist(void);

/*
 * @brief API to clear the application signature whitelist.
 *
 * @since_mdm 1.1.0
 *
 * @since_tizen 2.3.2.3
 *
 * @feature %http://developer.samsung.com/tizen/feature/mdm
 *
 * @par Usage:
 * Use this API remove all the elements in the application signature whitelist.
 *
 * @code{.c}
        mdm_result_t ret = mdm_clear_app_signature_whitelist();
        if (ret == MDM_RESULT_SUCCESS){
                // Whitelist cleared.
        } else {
                // Call failed.
        }
 * @endcode
 *
 * @privlevel public
 * @privilege %http://developer.samsung.com/tizen/privilege/mdm.application
 *
 * @return #mdm_result_t : MDM_RESULT_SUCCESS on success, an error code on error
 *
 * @retval #MDM_RESULT_SUCCESS Successful
 * @retval #MDM_RESULT_FAIL General failure
 * @retval #MDM_RESULT_NOT_SUPPORTED Not supported
 * @retval #MDM_RESULT_INVALID_PARAM Invalid parameter
 * @retval #MDM_RESULT_ACCESS_DENIED The application does not have the privilege to call this function.
 *
 * @par Permission:
 * Usage of this API is restricted to registered clients only.
 *
 */
mdm_result_t mdm_clear_app_signature_whitelist(void);

mdm_result_t mdm_set_application_uninstallation_mode(mdm_status_t value);

mdm_status_t mdm_get_application_uninstallation_mode(void);

/*
 * @brief API to install an application from appstore.
 *
 * @since_mdm 1.0.0
 *
 * @since_tizen 2.3.2.3
 *
 * @feature %http://developer.samsung.com/tizen/feature/mdm
 *
 * @par Usage:
 * The admin can call this API to silently download and install an application
 * without user interaction from appstore.
 *
 * @code{.c}

    //
    // Application appstore callback
    //
    static void __appstore_install_callback__(void *cb_data, void *user_data)
    {
        mdm_appstore_error_info_s *cb_info = (mdm_appstore_error_info_s *)cb_data;

        if(cb_info->error_code == MDM_APPSTORE_STATUS_SUCCESS)
        {
            // Installation success
            // ...
        }
        else
        {
            // Installation failed
            // ...
        }
    }

    int fun()
    {
        // Connect to the MDM
        mdm_get_service();

        mdm_result_t ret = mdm_install_application_by_url(NULL, "com.samsung.example", __appstore_install_callback__,
 NULL);

        if (ret == MDM_RESULT_SUCCESS) {
            // installation from appstore started
        } else {
            // error occured
        }
    }

 * @endcode
 *
 * @privlevel public
 * @privilege %http://developer.samsung.com/tizen/privilege/mdm.application
 *
 * @param[in] store_url         Path of url to appstore, without scheme. If value is set to NULL then default appstore
 location is used.
 * @param[in] app_name          Name of the application to install from appstore.
 * @param[in] cb_function       Callback function
 * @param[in] user_data         User data that is passed to the callback function
 *
 * @return #mdm_result_t : MDM_RESULT_SUCCESS on success, an error code on error
 *
 * @retval #MDM_RESULT_SUCCESS Successful
 * @retval #MDM_RESULT_FAIL General failure
 * @retval #MDM_RESULT_NOT_SUPPORTED Not supported
 * @retval #MDM_RESULT_INVALID_PARAM Invalid parameter
 * @retval #MDM_RESULT_ACCESS_DENIED The application does not have the privilege to call this function.
 *
 * @see mdm_update_application_by_url
 */
mdm_result_t mdm_install_application_by_url(const char *store_url, const char *app_name,
                                            mdm_client_callback_function_ext cb_function, void *user_data);

/*
 * @brief API to update an application from appstore.
 *
 * @since_mdm 1.0.0
 *
 * @since_tizen 2.3.2.3
 *
 * @feature %http://developer.samsung.com/tizen/feature/mdm
 *
 * @par Usage:
 * The admin can call this API to silently update an application
 * without user interaction from appstore.
 *
 * @code{.c}

    //
    // Application appstore callback
    //
    static void __appstore_update_callback__(void *cb_data, void *user_data)
    {
        mdm_appstore_error_info_s *error_info = (mdm_appstore_error_info_s *)cb_data;

        if(cb_info->error_code == MDM_APPSTORE_STATUS_SUCCESS)
        {
            // Update success
            // ...
        }
        else
        {
            // Update failed
            // ...
        }
    }

    int fun()
    {
        // Connect to the MDM
        mdm_get_service();

        mdm_result_t ret = mdm_update_application_by_url(NULL, "com.samsung.example", __appstore_update_callback__,
 NULL);

        if (ret == MDM_RESULT_SUCCESS) {
            // update from appstore started
        } else {
            // error occured
        }
    }

 * @endcode
 *
 * @privlevel public
 * @privilege %http://developer.samsung.com/tizen/privilege/mdm.application
 *
 * @param[in] store_url         Path of url to appstore, without scheme. If value is set to NULL then default appstore
 location is used.
 * @param[in] app_name          Name of the application to update from appstore url.
 * @param[in] cb_function       Callback function
 * @param[in] user_data         User data that is passed to the callback function
 *
 * @return #mdm_result_t : MDM_RESULT_SUCCESS on success, an error code on error
 *
 * @retval #MDM_RESULT_SUCCESS Successful
 * @retval #MDM_RESULT_FAIL General failure
 * @retval #MDM_RESULT_NOT_SUPPORTED Not supported
 * @retval #MDM_RESULT_INVALID_PARAM Invalid parameter
 * @retval #MDM_RESULT_ACCESS_DENIED The application does not have the privilege to call this function.
 *
 * @see mdm_install_application_by_url
 */
mdm_result_t mdm_update_application_by_url(const char *store_url, const char *app_name,
                                           mdm_client_callback_function_ext cb_function, void *user_data);

mdm_result_t knox_mdm_add_privacy_permission_state_for_package(const char *package_name, const char *privilege,
            mdm_privacy_permission_state_t state);

mdm_result_t knox_mdm_remove_privacy_permissions_from_packages(const char *package_name_pattern,
            const char *privilege_pattern);

mdm_result_t knox_mdm_get_privacy_permission_state_for_package(const char *package_name,
            const char *privilege, bool all_admins, mdm_privacy_permission_state_t *state);

mdm_data_t *knox_mdm_get_privacy_permission_data(const char *package_name_pattern, const char *privilege_pattern,
            bool all_admins, mdm_privacy_permission_state_t state_pattern);

mdm_status_t knox_mdm_widget_board_get_edit_permission(bool all_admins);

mdm_result_t knox_mdm_widget_board_set_edit_permission(mdm_status_t status);

#ifdef __cplusplus
}
#endif

#endif //LIBMDM_MDM_APPLICATION_H