From: yeji01.kim Date: Mon, 17 Apr 2023 00:41:13 +0000 (+0900) Subject: Deprecate device policy manager APIs X-Git-Tag: accepted/tizen/unified/20230420.041544^0 X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=b07e0bb96b657e65dd65b832b5f741ae00435bbb;p=platform%2Fcore%2Fsecurity%2Fdevice-policy-client.git Deprecate device policy manager APIs Change-Id: I33b6f874f91a8994881c0b91eea8a6d3fba97f15 Signed-off-by: yeji01.kim --- diff --git a/libs/dpm/device-policy-manager.h b/libs/dpm/device-policy-manager.h index 7ab8494..fea852c 100644 --- a/libs/dpm/device-policy-manager.h +++ b/libs/dpm/device-policy-manager.h @@ -35,6 +35,7 @@ extern "C" { */ /** + * @deprecated Deprecated since 7.5. * @brief Called when a policy is changed. * @since_tizen 3.0 * @param[in] name The name of the policy @@ -46,6 +47,7 @@ extern "C" { typedef void (*dpm_policy_changed_cb)(const char* name, const char* state, void *user_data); /** + * @deprecated Deprecated since 7.5. * @brief The device policy manager handle * @details The device policy manager handle is an abstraction of the * logical connection between the device policy manager and @@ -62,6 +64,7 @@ typedef void (*dpm_policy_changed_cb)(const char* name, const char* state, void typedef void* device_policy_manager_h; /** + * @deprecated Deprecated since 7.5. * @brief Enumeration of device policy API errors * @since_tizen 3.0 */ @@ -78,6 +81,7 @@ typedef enum { } dpm_error_type_e; /** + * @deprecated Deprecated since 7.5. * @brief Creates the device policy manager handle. * @details This API creates device policy manager handle required to * the device policy APIs. @@ -95,9 +99,10 @@ typedef enum { * @see dpm_manager_destroy() * @see get_last_result() */ -device_policy_manager_h dpm_manager_create(void); +device_policy_manager_h dpm_manager_create(void) TIZEN_DEPRECATED_API; /** + * @deprecated Deprecated since 7.5. * @brief Releases the device policy manager handle. * @details This API must be called if interaction with the device * policy manager is no longer required. @@ -109,9 +114,10 @@ device_policy_manager_h dpm_manager_create(void); * @pre The handle must be created by dpm_manager_create(). * @see dpm_manager_create() */ -int dpm_manager_destroy(device_policy_manager_h handle); +int dpm_manager_destroy(device_policy_manager_h handle) TIZEN_DEPRECATED_API; /** + * @deprecated Deprecated since 7.5. * @brief Adds policy change callback to the device policy * manager. * @details This API can be used to subscribe policy change callback. @@ -136,8 +142,9 @@ int dpm_add_policy_changed_cb(device_policy_manager_h handle, const char* name, dpm_policy_changed_cb callback, void* user_data, - int* id); + int* id) TIZEN_DEPRECATED_API; /** + * @deprecated Deprecated since 7.5. * @brief Removes policy change callback from the device policy * manager. * @details This API should be called if policy change subscription is no longer @@ -154,8 +161,9 @@ int dpm_add_policy_changed_cb(device_policy_manager_h handle, * @see dpm_manager_create() * @see dpm_add_policy_changed_cb() */ -int dpm_remove_policy_changed_cb(device_policy_manager_h handle, int id); +int dpm_remove_policy_changed_cb(device_policy_manager_h handle, int id) TIZEN_DEPRECATED_API; /** + * @deprecated Deprecated since 7.5. * @brief Called when a zone raises a signal. * @since_tizen 3.0 * @param[in] name The zone name @@ -167,6 +175,7 @@ int dpm_remove_policy_changed_cb(device_policy_manager_h handle, int id); typedef void(*dpm_signal_cb)(const char* name, const char* object, void *user_data); /** + * @deprecated Deprecated since 7.5. * @brief Adds signal callback. * @details This API can be used to receive signals raised by the device policy manager. * The callback specified to this function is automatically called when @@ -188,9 +197,10 @@ typedef void(*dpm_signal_cb)(const char* name, const char* object, void *user_da * @see dpm_remove_signal_cb() */ int dpm_add_signal_cb(device_policy_manager_h handle, const char* signal, - dpm_signal_cb callback, void* user_data, int* id); + dpm_signal_cb callback, void* user_data, int* id) TIZEN_DEPRECATED_API; /** + * @deprecated Deprecated since 7.5. * @brief Removes signal callback. * @details This API removes signal callback. * @since_tizen 3.0 @@ -205,7 +215,7 @@ int dpm_add_signal_cb(device_policy_manager_h handle, const char* signal, * @see dpm_manager_destroy() * @see dpm_add_signal_cb() */ -int dpm_remove_signal_cb(device_policy_manager_h handle, int id); +int dpm_remove_signal_cb(device_policy_manager_h handle, int id) TIZEN_DEPRECATED_API; /** * @} */ diff --git a/libs/dpm/password.h b/libs/dpm/password.h index 76c361b..253f17a 100644 --- a/libs/dpm/password.h +++ b/libs/dpm/password.h @@ -34,6 +34,7 @@ extern "C" { */ /** + * @deprecated Deprecated since 7.5. * @brief Enumeration for dpm password quality type * @since_tizen 3.0 */ @@ -47,6 +48,7 @@ typedef enum { } dpm_password_quality_e; /** + * @deprecated Deprecated since 7.5. * @brief Enumeration for dpm password status type * @since_tizen 3.0 */ @@ -68,6 +70,7 @@ typedef enum { } dpm_password_status_e; /** + * @deprecated Deprecated since 7.5. * @partner * @brief Sets password quality. * @details An administrator can set the password restrictions it is imposing. @@ -87,9 +90,10 @@ typedef enum { * @pre The handle must be created by dpm_manager_create(). * @see dpm_manager_create() */ -int dpm_password_set_quality(device_policy_manager_h handle, int quality); +int dpm_password_set_quality(device_policy_manager_h handle, int quality) TIZEN_DEPRECATED_API; /** + * @deprecated Deprecated since 7.5. * @partner * @brief Gets password quality. * @details An administrator can get the password restrictions it is imposing. @@ -107,9 +111,10 @@ int dpm_password_set_quality(device_policy_manager_h handle, int quality); * @pre The handle must be created by dpm_manager_create(). * @see dpm_manager_create() */ -int dpm_password_get_quality(device_policy_manager_h handle, int *quality); +int dpm_password_get_quality(device_policy_manager_h handle, int *quality) TIZEN_DEPRECATED_API; /** + * @deprecated Deprecated since 7.5. * @partner * @brief Sets password minimum length. * @details Sets the minimum allowed password length. After setting this, @@ -129,9 +134,10 @@ int dpm_password_get_quality(device_policy_manager_h handle, int *quality); * @pre The handle must be created by dpm_manager_create(). * @see dpm_manager_create() */ -int dpm_password_set_minimum_length(device_policy_manager_h handle, int value); +int dpm_password_set_minimum_length(device_policy_manager_h handle, int value) TIZEN_DEPRECATED_API; /** + * @deprecated Deprecated since 7.5. * @partner * @brief Gets password minimum length. * @details Gets the minimum allowed password length. @@ -149,9 +155,10 @@ int dpm_password_set_minimum_length(device_policy_manager_h handle, int value); * @pre The handle must be created by dpm_manager_create(). * @see dpm_manager_create() */ -int dpm_password_get_minimum_length(device_policy_manager_h handle, int *value); +int dpm_password_get_minimum_length(device_policy_manager_h handle, int *value) TIZEN_DEPRECATED_API; /** + * @deprecated Deprecated since 7.5. * @partner * @brief Sets minimum complex char in password. * @details Complex characters are all non-alphabetic characters; @@ -171,9 +178,10 @@ int dpm_password_get_minimum_length(device_policy_manager_h handle, int *value); * @pre The handle must be created by dpm_manager_create(). * @see dpm_manager_create() */ -int dpm_password_set_min_complex_chars(device_policy_manager_h handle, int value); +int dpm_password_set_min_complex_chars(device_policy_manager_h handle, int value) TIZEN_DEPRECATED_API; /** + * @deprecated Deprecated since 7.5. * @partner * @brief Gets minimum complex char in password. * @details Complex characters are all non-alphabetic characters; @@ -192,9 +200,10 @@ int dpm_password_set_min_complex_chars(device_policy_manager_h handle, int value * @pre The handle must be created by dpm_manager_create(). * @see dpm_manager_create() */ -int dpm_password_get_min_complex_chars(device_policy_manager_h handle, int *value); +int dpm_password_get_min_complex_chars(device_policy_manager_h handle, int *value) TIZEN_DEPRECATED_API; /** + * @deprecated Deprecated since 7.5. * @partner * @brief Sets maximum number of failed attempts before device is wiped. * @details If user fails the last attempt, device will be wiped. @@ -212,9 +221,10 @@ int dpm_password_get_min_complex_chars(device_policy_manager_h handle, int *valu * @pre The handle must be created by dpm_manager_create(). * @see dpm_manager_create() */ -int dpm_password_set_maximum_failed_attempts_for_wipe(device_policy_manager_h handle, int value); +int dpm_password_set_maximum_failed_attempts_for_wipe(device_policy_manager_h handle, int value) TIZEN_DEPRECATED_API; /** + * @deprecated Deprecated since 7.5. * @partner * @brief Gets maximum number of failed attempts before device is wiped. * @details If user fails the last attempt, device will be wiped. @@ -232,9 +242,10 @@ int dpm_password_set_maximum_failed_attempts_for_wipe(device_policy_manager_h ha * @pre The handle must be created by dpm_manager_create(). * @see dpm_manager_create() */ -int dpm_password_get_maximum_failed_attempts_for_wipe(device_policy_manager_h handle, int *value); +int dpm_password_get_maximum_failed_attempts_for_wipe(device_policy_manager_h handle, int *value) TIZEN_DEPRECATED_API; /** + * @deprecated Deprecated since 7.5. * @partner * @brief Sets the number of days password expires. * @details An administrator can configure the password age to force @@ -253,9 +264,10 @@ int dpm_password_get_maximum_failed_attempts_for_wipe(device_policy_manager_h ha * @pre The handle must be created by dpm_manager_create(). * @see dpm_manager_create() */ -int dpm_password_set_expires(device_policy_manager_h handle, int value); +int dpm_password_set_expires(device_policy_manager_h handle, int value) TIZEN_DEPRECATED_API; /** + * @deprecated Deprecated since 7.5. * @partner * @brief Gets the number of days password expires. * @details An administrator can get the password age to force @@ -274,9 +286,10 @@ int dpm_password_set_expires(device_policy_manager_h handle, int value); * @pre The handle must be created by dpm_manager_create(). * @see dpm_manager_create() */ -int dpm_password_get_expires(device_policy_manager_h handle, int *value); +int dpm_password_get_expires(device_policy_manager_h handle, int *value) TIZEN_DEPRECATED_API; /** + * @deprecated Deprecated since 7.5. * @partner * @brief Sets the number of min password history to avoid previous password. * @details An administrator can configure the number of previous @@ -296,9 +309,10 @@ int dpm_password_get_expires(device_policy_manager_h handle, int *value); * @pre The handle must be created by dpm_manager_create(). * @see dpm_manager_create() */ -int dpm_password_set_history(device_policy_manager_h handle, int value); +int dpm_password_set_history(device_policy_manager_h handle, int value) TIZEN_DEPRECATED_API; /** + * @deprecated Deprecated since 7.5. * @partner * @brief Gets the number of min password history to avoid previous password. * @details An administrator can get the number of previous @@ -318,9 +332,10 @@ int dpm_password_set_history(device_policy_manager_h handle, int value); * @pre The handle must be created by dpm_manager_create(). * @see dpm_manager_create() */ -int dpm_password_get_history(device_policy_manager_h handle, int *value); +int dpm_password_get_history(device_policy_manager_h handle, int *value) TIZEN_DEPRECATED_API; /** + * @deprecated Deprecated since 7.5. * @partner * @brief Sets the required password pattern. * @details An administrator can force User to enter password based on @@ -343,9 +358,10 @@ int dpm_password_get_history(device_policy_manager_h handle, int *value); * @pre The handle must be created by dpm_manager_create(). * @see dpm_manager_create() */ -int dpm_password_set_pattern(device_policy_manager_h handle, const char *pattern); +int dpm_password_set_pattern(device_policy_manager_h handle, const char *pattern) TIZEN_DEPRECATED_API; /** + * @deprecated Deprecated since 7.5. * @partner * @brief Resets password. * @details This takes effect immediately to the device password. @@ -363,9 +379,10 @@ int dpm_password_set_pattern(device_policy_manager_h handle, const char *pattern * @pre The handle must be created by dpm_manager_create(). * @see dpm_manager_create() */ -int dpm_password_reset(device_policy_manager_h handle, const char *password); +int dpm_password_reset(device_policy_manager_h handle, const char *password) TIZEN_DEPRECATED_API; /** + * @deprecated Deprecated since 7.5. * @partner * @brief Enforces password change. * @details An administrator can enforce password change. PasswordPolicy @@ -383,9 +400,10 @@ int dpm_password_reset(device_policy_manager_h handle, const char *password); * @pre The handle must be created by dpm_manager_create(). * @see dpm_manager_create() */ -int dpm_password_enforce_change(device_policy_manager_h handle); +int dpm_password_enforce_change(device_policy_manager_h handle) TIZEN_DEPRECATED_API; /** + * @deprecated Deprecated since 7.5. * @partner * @brief Sets the maximum number of seconds of inactivity time * before the screen timeout occurs. @@ -408,9 +426,10 @@ int dpm_password_enforce_change(device_policy_manager_h handle); * @pre The handle must be created by dpm_manager_create(). * @see dpm_manager_create() */ -int dpm_password_set_max_inactivity_time_device_lock(device_policy_manager_h handle, int value); +int dpm_password_set_max_inactivity_time_device_lock(device_policy_manager_h handle, int value) TIZEN_DEPRECATED_API; /** + * @deprecated Deprecated since 7.5. * @partner * @brief Gets the maximum number of seconds of inactivity time * before the screen timeout occurs. @@ -430,9 +449,10 @@ int dpm_password_set_max_inactivity_time_device_lock(device_policy_manager_h han * @pre The handle must be created by dpm_manager_create(). * @see dpm_manager_create() */ -int dpm_password_get_max_inactivity_time_device_lock(device_policy_manager_h handle, int *value); +int dpm_password_get_max_inactivity_time_device_lock(device_policy_manager_h handle, int *value) TIZEN_DEPRECATED_API; /** + * @deprecated Deprecated since 7.5. * @partner * @brief Sets password status * @details An administrator can know password status for this API. @@ -450,9 +470,10 @@ int dpm_password_get_max_inactivity_time_device_lock(device_policy_manager_h han * @pre The handle must be created by dpm_manager_create(). * @see dpm_manager_create() */ -int dpm_password_set_status(device_policy_manager_h handle, dpm_password_status_e status); +int dpm_password_set_status(device_policy_manager_h handle, dpm_password_status_e status) TIZEN_DEPRECATED_API; /** + * @deprecated Deprecated since 7.5. * @partner * @brief Gets password status * @details An administrator can know password status for this API. @@ -466,10 +487,11 @@ int dpm_password_set_status(device_policy_manager_h handle, dpm_password_status_ * @pre The handle must be created by dpm_manager_create(). * @see dpm_manager_create() */ -int dpm_password_get_status(device_policy_manager_h handle, dpm_password_status_e *status); +int dpm_password_get_status(device_policy_manager_h handle, dpm_password_status_e *status) TIZEN_DEPRECATED_API; /** + * @deprecated Deprecated since 7.5. * @partner * @brief Removes all password patterns. * @details An administrator can remove all password patterns. @@ -486,9 +508,10 @@ int dpm_password_get_status(device_policy_manager_h handle, dpm_password_status_ * @pre The handle must be created by dpm_manager_create(). * @see dpm_manager_create() */ -int dpm_password_delete_pattern(device_policy_manager_h handle); +int dpm_password_delete_pattern(device_policy_manager_h handle) TIZEN_DEPRECATED_API; /** + * @deprecated Deprecated since 7.5. * @partner * @brief Gets password pattern. * @details This API can be used for applying complexity on new password value. @@ -508,9 +531,10 @@ int dpm_password_delete_pattern(device_policy_manager_h handle); * @pre The handle must be created by dpm_manager_create(). * @see dpm_manager_create() */ -int dpm_password_get_pattern(device_policy_manager_h handle, char **pattern); +int dpm_password_get_pattern(device_policy_manager_h handle, char **pattern) TIZEN_DEPRECATED_API; /** + * @deprecated Deprecated since 7.5. * @partner * @brief Sets the maximum number of times a character can occur in * the device password. @@ -535,9 +559,10 @@ int dpm_password_get_pattern(device_policy_manager_h handle, char **pattern); * @pre The handle must be created by dpm_manager_create(). * @see dpm_manager_create() */ -int dpm_password_set_maximum_character_occurrences(device_policy_manager_h handle, int value); +int dpm_password_set_maximum_character_occurrences(device_policy_manager_h handle, int value) TIZEN_DEPRECATED_API; /** + * @deprecated Deprecated since 7.5. * @partner * @brief Gets the maximum number of times a character can occur in * the device password. @@ -559,9 +584,10 @@ int dpm_password_set_maximum_character_occurrences(device_policy_manager_h handl * @pre The handle must be created by dpm_manager_create(). * @see dpm_manager_create() */ -int dpm_password_get_maximum_character_occurrences(device_policy_manager_h handle, int *value); +int dpm_password_get_maximum_character_occurrences(device_policy_manager_h handle, int *value) TIZEN_DEPRECATED_API; /** + * @deprecated Deprecated since 7.5. * @partner * @brief Sets the maximum length of the numeric sequence * which is allowed in the device password. @@ -591,9 +617,10 @@ int dpm_password_get_maximum_character_occurrences(device_policy_manager_h handl * @pre The handle must be created by dpm_manager_create(). * @see dpm_manager_create() */ -int dpm_password_set_maximum_numeric_sequence_length(device_policy_manager_h handle, int value); +int dpm_password_set_maximum_numeric_sequence_length(device_policy_manager_h handle, int value) TIZEN_DEPRECATED_API; /** + * @deprecated Deprecated since 7.5. * @partner * @brief Gets the maximum numeric sequence length allowed in * the device password. @@ -618,9 +645,10 @@ int dpm_password_set_maximum_numeric_sequence_length(device_policy_manager_h han * @pre The handle must be created by dpm_manager_create(). * @see dpm_manager_create() */ -int dpm_password_get_maximum_numeric_sequence_length(device_policy_manager_h handle, int *value); +int dpm_password_get_maximum_numeric_sequence_length(device_policy_manager_h handle, int *value) TIZEN_DEPRECATED_API; /** + * @deprecated Deprecated since 7.5. * @brief The password forbidden string list iterator handle * @since_tizen 3.0 * @see dpm_password_create_iterator() @@ -630,6 +658,7 @@ int dpm_password_get_maximum_numeric_sequence_length(device_policy_manager_h han typedef void *dpm_password_iterator_h; /** + * @deprecated Deprecated since 7.5. * @partner * @brief Creates a password forbidden string list iterator. * @details The password forbidden string list iterator can be used to get all forbidden strings. @@ -655,9 +684,10 @@ typedef void *dpm_password_iterator_h; * @see dpm_password_destroy_iterator() * @see get_last_result() */ -dpm_password_iterator_h dpm_password_create_iterator(device_policy_manager_h handle); +dpm_password_iterator_h dpm_password_create_iterator(device_policy_manager_h handle) TIZEN_DEPRECATED_API; /** + * @deprecated Deprecated since 7.5. * @partner * @brief Fetches a password forbidden string and forwards the iterator. * @details This API returns a password forbidden string indicated by the iterator, and then @@ -675,9 +705,10 @@ dpm_password_iterator_h dpm_password_create_iterator(device_policy_manager_h han * @see dpm_password_create_iterator() * @see dpm_password_destroy_iterator() */ -int dpm_password_iterator_next(dpm_password_iterator_h iter, const char **forbidden_string); +int dpm_password_iterator_next(dpm_password_iterator_h iter, const char **forbidden_string) TIZEN_DEPRECATED_API; /** + * @deprecated Deprecated since 7.5. * @partner * @brief Frees the password forbidden string iterator. * @details This API frees the password forbidden string iterator. This API must be called @@ -696,9 +727,10 @@ int dpm_password_iterator_next(dpm_password_iterator_h iter, const char **forbid * @see dpm_password_create_iterator() * @see dpm_password_iterator_next() */ -int dpm_password_destroy_iterator(dpm_password_iterator_h iter); +int dpm_password_destroy_iterator(dpm_password_iterator_h iter) TIZEN_DEPRECATED_API; /** + * @deprecated Deprecated since 7.5. * @partner * @brief Sets strings which are forbidden in the device password. * @details Called by an admin that is managing the device to set strings that are forbidden to be used in the device password. @@ -719,7 +751,7 @@ int dpm_password_destroy_iterator(dpm_password_iterator_h iter); * @pre The handle must be created by dpm_manager_create(). * @see dpm_manager_create() */ -int dpm_password_set_forbidden_strings(device_policy_manager_h handle, const char *strings[], int length); +int dpm_password_set_forbidden_strings(device_policy_manager_h handle, const char *strings[], int length) TIZEN_DEPRECATED_API; /** * @} diff --git a/libs/dpm/restriction.h b/libs/dpm/restriction.h index 5635ff4..bca740a 100644 --- a/libs/dpm/restriction.h +++ b/libs/dpm/restriction.h @@ -34,6 +34,7 @@ extern "C" { */ /** + * @deprecated Deprecated since 7.5. * @partner * @brief Allows or disallows the use of camera. * @details An administrator can use this API to set whether the use of camera @@ -53,9 +54,10 @@ extern "C" { * @see dpm_manager_create() * @see dpm_restriction_get_camera_state() */ -int dpm_restriction_set_camera_state(device_policy_manager_h handle, int allow); +int dpm_restriction_set_camera_state(device_policy_manager_h handle, int allow) TIZEN_DEPRECATED_API; /** + * @deprecated Deprecated since 7.5. * @brief Check whether the use of camera is allowed or not. * @details An administrator can use this API to check whether the use of camera * is allowed or not. @@ -70,9 +72,10 @@ int dpm_restriction_set_camera_state(device_policy_manager_h handle, int allow); * @see dpm_manager_create() * @see dpm_restriction_set_camera_state() */ -int dpm_restriction_get_camera_state(device_policy_manager_h handle, int *is_allowed); +int dpm_restriction_get_camera_state(device_policy_manager_h handle, int *is_allowed) TIZEN_DEPRECATED_API; /** + * @deprecated Deprecated since 7.5. * @partner * @brief Allows or disallows the use of microphone. * @details An administrator can use this API to set whether the use of microphone @@ -93,9 +96,10 @@ int dpm_restriction_get_camera_state(device_policy_manager_h handle, int *is_all * @see dpm_manager_create() * @see dpm_restriction_get_microphone_state() */ -int dpm_restriction_set_microphone_state(device_policy_manager_h handle, int allow); +int dpm_restriction_set_microphone_state(device_policy_manager_h handle, int allow) TIZEN_DEPRECATED_API; /** + * @deprecated Deprecated since 7.5. * @brief Checks whether the use of microphone is allowed or not. * @details An administrator can use this API to check whether the use of microphone * is allowed of not. @@ -110,9 +114,10 @@ int dpm_restriction_set_microphone_state(device_policy_manager_h handle, int all * @see dpm_manager_create() * @see dpm_restriction_set_microphone_state() */ -int dpm_restriction_get_microphone_state(device_policy_manager_h handle, int *is_allowed); +int dpm_restriction_get_microphone_state(device_policy_manager_h handle, int *is_allowed) TIZEN_DEPRECATED_API; /** + * @deprecated Deprecated since 7.5. * @partner * @brief Allows or disallows user to change the location state. * @details An administrator can use this API to allow or disallow user to change @@ -132,9 +137,10 @@ int dpm_restriction_get_microphone_state(device_policy_manager_h handle, int *is * @see dpm_manager_create() * @see dpm_restriction_get_location_state() */ -int dpm_restriction_set_location_state(device_policy_manager_h handle, int allow); +int dpm_restriction_set_location_state(device_policy_manager_h handle, int allow) TIZEN_DEPRECATED_API; /** + * @deprecated Deprecated since 7.5. * @brief Check whether user is allowed to change location state or not. * @details An administrator can use this API to check whether user is allowed to change * the location state or not. @@ -149,9 +155,10 @@ int dpm_restriction_set_location_state(device_policy_manager_h handle, int allow * @see dpm_manager_create() * @see dpm_restriction_set_location_state() */ -int dpm_restriction_get_location_state(device_policy_manager_h handle, int *is_allowed); +int dpm_restriction_get_location_state(device_policy_manager_h handle, int *is_allowed) TIZEN_DEPRECATED_API; /** + * @deprecated Deprecated since 7.5. * @partner * @brief Allows or disallows user to use usb mass storage. * @details An administrator can use this API to set whether the usb mass @@ -172,9 +179,10 @@ int dpm_restriction_get_location_state(device_policy_manager_h handle, int *is_a * @see dpm_manager_create() * @see dpm_restriction_get_external_storage_state() */ -int dpm_restriction_set_external_storage_state(device_policy_manager_h handle, int allow); +int dpm_restriction_set_external_storage_state(device_policy_manager_h handle, int allow) TIZEN_DEPRECATED_API; /** + * @deprecated Deprecated since 7.5. * @brief Checks whether the use of external storage is allowed or not. * @details An administrator can use this API to check whether the use of external storage is * allowed or not. @@ -189,7 +197,7 @@ int dpm_restriction_set_external_storage_state(device_policy_manager_h handle, i * @see dpm_manager_create() * @see dpm_restriction_set_external_storage_state() */ -int dpm_restriction_get_external_storage_state(device_policy_manager_h handle, int *is_allowed); +int dpm_restriction_get_external_storage_state(device_policy_manager_h handle, int *is_allowed) TIZEN_DEPRECATED_API; /** * @partner @@ -211,9 +219,10 @@ int dpm_restriction_get_external_storage_state(device_policy_manager_h handle, i * @see dpm_manager_create() * @see dpm_restriction_get_clipboard_state() */ -int dpm_restriction_set_clipboard_state(device_policy_manager_h handle, int allow); +int dpm_restriction_set_clipboard_state(device_policy_manager_h handle, int allow) TIZEN_DEPRECATED_API; /** + * @deprecated Deprecated since 7.5. * @brief Checks whether the clipboard access is allowed or not. * @details An administrator can use this API to check whether the clipboard access * is allowed or not. @@ -228,9 +237,10 @@ int dpm_restriction_set_clipboard_state(device_policy_manager_h handle, int allo * @see dpm_manager_create() * @see dpm_restriction_set_clipboard_state() */ -int dpm_restriction_get_clipboard_state(device_policy_manager_h handle, int *is_allowed); +int dpm_restriction_get_clipboard_state(device_policy_manager_h handle, int *is_allowed) TIZEN_DEPRECATED_API; /** + * @deprecated Deprecated since 7.5. * @partner * @brief Allows or disallows the usb debugging. * @details An administrator can use this API to set whether the usb debugging @@ -251,9 +261,10 @@ int dpm_restriction_get_clipboard_state(device_policy_manager_h handle, int *is_ * @see dpm_manager_create() * @see dpm_restriction_get_usb_debugging_state() */ -int dpm_restriction_set_usb_debugging_state(device_policy_manager_h handle, int allow); +int dpm_restriction_set_usb_debugging_state(device_policy_manager_h handle, int allow) TIZEN_DEPRECATED_API; /** + * @deprecated Deprecated since 7.5. * @brief Checks whether the usb debugging is allowed or not. * @details An administrator can use this API to check whether the usb debugging * is allowed or not. @@ -268,9 +279,10 @@ int dpm_restriction_set_usb_debugging_state(device_policy_manager_h handle, int * @see dpm_manager_create() * @see dpm_restriction_set_usb_debugging_state() */ -int dpm_restriction_get_usb_debugging_state(device_policy_manager_h handle, int *is_allowed); +int dpm_restriction_get_usb_debugging_state(device_policy_manager_h handle, int *is_allowed) TIZEN_DEPRECATED_API; /** + * @deprecated Deprecated since 7.5. * @partner * @brief Allows or disallows user to change the Wi-Fi state. * @details An administrator can use this API to allow or disallow user to @@ -292,9 +304,10 @@ int dpm_restriction_get_usb_debugging_state(device_policy_manager_h handle, int * @see dpm_manager_create() * @see dpm_restriction_get_wifi_state() */ -int dpm_restriction_set_wifi_state(device_policy_manager_h handle, int allow); +int dpm_restriction_set_wifi_state(device_policy_manager_h handle, int allow) TIZEN_DEPRECATED_API; /** + * @deprecated Deprecated since 7.5. * @brief Checks whether the Wi-Fi state change is allowed or not. * @details An administrator can use this API to check whether user is * allowed to change Wi-Fi state or not. @@ -309,9 +322,10 @@ int dpm_restriction_set_wifi_state(device_policy_manager_h handle, int allow); * @see dpm_manager_create() * @see dpm_restriction_set_wifi_state() */ -int dpm_restriction_get_wifi_state(device_policy_manager_h handle, int *is_allowed); +int dpm_restriction_get_wifi_state(device_policy_manager_h handle, int *is_allowed) TIZEN_DEPRECATED_API; /** + * @deprecated Deprecated since 7.5. * @partner * @brief Allows or disallows user to change Wi-Fi hotspot state change. * @details An administrator can use this API to allow or disallow user to change Wi-Fi @@ -333,9 +347,10 @@ int dpm_restriction_get_wifi_state(device_policy_manager_h handle, int *is_allow * @see dpm_manager_create() * @see dpm_restriction_get_wifi_hotspot_state() */ -int dpm_restriction_set_wifi_hotspot_state(device_policy_manager_h handle, int allow); +int dpm_restriction_set_wifi_hotspot_state(device_policy_manager_h handle, int allow) TIZEN_DEPRECATED_API; /** + * @deprecated Deprecated since 7.5. * @brief Checks whether the the Wi-Fi hotspot state change is allowed or not. * @details An administrator can use this API to check whether user is allowed to change * Wi-Fi hotspot state or not. @@ -352,9 +367,10 @@ int dpm_restriction_set_wifi_hotspot_state(device_policy_manager_h handle, int a * @see dpm_manager_create() * @see dpm_restriction_set_wifi_hotspot_state() */ -int dpm_restriction_get_wifi_hotspot_state(device_policy_manager_h handle, int *is_allowed); +int dpm_restriction_get_wifi_hotspot_state(device_policy_manager_h handle, int *is_allowed) TIZEN_DEPRECATED_API; /** + * @deprecated Deprecated since 7.5. * @partner * @brief Allows or disallows user to change the bluetooth tethering state. * @details An administrator can use this API to allow of disallow user @@ -376,9 +392,10 @@ int dpm_restriction_get_wifi_hotspot_state(device_policy_manager_h handle, int * * @see dpm_manager_create() * @see dpm_restriction_get_bluetooth_tethering_state() */ -int dpm_restriction_set_bluetooth_tethering_state(device_policy_manager_h handle, int allow); +int dpm_restriction_set_bluetooth_tethering_state(device_policy_manager_h handle, int allow) TIZEN_DEPRECATED_API; /** + * @deprecated Deprecated since 7.5. * @brief Checks whether the bluetooth tethering state change is allowed. * @details An administrator can use this API to check whether user is allowed * to change bluetooth tethering state. @@ -396,9 +413,10 @@ int dpm_restriction_set_bluetooth_tethering_state(device_policy_manager_h handle * @see dpm_manager_create() * @see dpm_restriction_set_bluetooth_tethering_state() */ -int dpm_restriction_get_bluetooth_tethering_state(device_policy_manager_h handle, int *is_allowed); +int dpm_restriction_get_bluetooth_tethering_state(device_policy_manager_h handle, int *is_allowed) TIZEN_DEPRECATED_API; /** + * @deprecated Deprecated since 7.5. * @partner * @brief Allows or disallows user to change USB tethering settings. * @details An administrator can use this API to allow or disallow user @@ -420,9 +438,10 @@ int dpm_restriction_get_bluetooth_tethering_state(device_policy_manager_h handle * @see dpm_manager_create() * @see dpm_restriction_get_usb_tethering_state() */ -int dpm_restriction_set_usb_tethering_state(device_policy_manager_h handle, int allow); +int dpm_restriction_set_usb_tethering_state(device_policy_manager_h handle, int allow) TIZEN_DEPRECATED_API; /** + * @deprecated Deprecated since 7.5. * @brief Checks whether the USB tethering state change is allowed. * @details An administrator can use this API to check whether the USB tethering state change * is allowed or not. @@ -439,9 +458,10 @@ int dpm_restriction_set_usb_tethering_state(device_policy_manager_h handle, int * @see dpm_manager_create() * @see dpm_restriction_set_usb_tethering_state() */ -int dpm_restriction_get_usb_tethering_state(device_policy_manager_h handle, int *is_allowed); +int dpm_restriction_get_usb_tethering_state(device_policy_manager_h handle, int *is_allowed) TIZEN_DEPRECATED_API; /** + * @deprecated Deprecated since 7.5. * @partner * @brief Allows or disallows user to change the bluetooth state. * @details An administrator can use this API to allow or disallow user @@ -463,9 +483,10 @@ int dpm_restriction_get_usb_tethering_state(device_policy_manager_h handle, int * @see dpm_manager_create() * @see dpm_restriction_get_bluetooth_mode_change_state() */ -int dpm_restriction_set_bluetooth_mode_change_state(device_policy_manager_h handle, int allow); +int dpm_restriction_set_bluetooth_mode_change_state(device_policy_manager_h handle, int allow) TIZEN_DEPRECATED_API; /** + * @deprecated Deprecated since 7.5. * @brief Checks whether the the bluetooth state change is allowed of not. * @details An administrator can use this API to check whether the bluetooth state change * is allowed or not. @@ -482,9 +503,10 @@ int dpm_restriction_set_bluetooth_mode_change_state(device_policy_manager_h hand * @see dpm_manager_create() * @see dpm_restriction_set_bluetooth_mode_change_state() */ -int dpm_restriction_get_bluetooth_mode_change_state(device_policy_manager_h handle, int *is_allowed); +int dpm_restriction_get_bluetooth_mode_change_state(device_policy_manager_h handle, int *is_allowed) TIZEN_DEPRECATED_API; /** + * @deprecated Deprecated since 7.5. * @partner * @brief Allows or disallows the bluetooth desktop connectivity. * @details An administrator can use this API to allow or disallow the bluetooth @@ -508,9 +530,10 @@ int dpm_restriction_get_bluetooth_mode_change_state(device_policy_manager_h hand * @see dpm_manager_create() * @see dpm_restriction_get_bluetooth_desktop_connectivity_state() */ -int dpm_restriction_set_bluetooth_desktop_connectivity_state(device_policy_manager_h handle, int allow); +int dpm_restriction_set_bluetooth_desktop_connectivity_state(device_policy_manager_h handle, int allow) TIZEN_DEPRECATED_API; /** + * @deprecated Deprecated since 7.5. * @brief Checks whether the the Bluetooth desktop connectivity is allowed or not. * @details An administrator can use this API to check whether the Bluetooth desktop * connectivity is allowed or not. @@ -527,9 +550,10 @@ int dpm_restriction_set_bluetooth_desktop_connectivity_state(device_policy_manag * @see dpm_manager_create() * @see dpm_restriction_set_bluetooth_desktop_connectivity_state() */ -int dpm_restriction_get_bluetooth_desktop_connectivity_state(device_policy_manager_h handle, int *is_allowed); +int dpm_restriction_get_bluetooth_desktop_connectivity_state(device_policy_manager_h handle, int *is_allowed) TIZEN_DEPRECATED_API; /** + * @deprecated Deprecated since 7.5. * @partner * @brief Allows or disallows user to change the bluetooth pairing. * @details An administrator can use this API to allow or disallow the bluetooth pairing. @@ -550,9 +574,10 @@ int dpm_restriction_get_bluetooth_desktop_connectivity_state(device_policy_manag * @see dpm_manager_create() * @see dpm_restriction_get_bluetooth_pairing_state() */ -int dpm_restriction_set_bluetooth_pairing_state(device_policy_manager_h handle, int allow); +int dpm_restriction_set_bluetooth_pairing_state(device_policy_manager_h handle, int allow) TIZEN_DEPRECATED_API; /** + * @deprecated Deprecated since 7.5. * @brief Checks whether the the bluetooth pairing is allowed or not. * @details An administrator can use this API to check whether the bluetooth * pairing is allowed or not. @@ -569,9 +594,10 @@ int dpm_restriction_set_bluetooth_pairing_state(device_policy_manager_h handle, * @see dpm_manager_create() * @see dpm_restriction_set_bluetooth_pairing_state() */ -int dpm_restriction_get_bluetooth_pairing_state(device_policy_manager_h handle, int *is_allowed); +int dpm_restriction_get_bluetooth_pairing_state(device_policy_manager_h handle, int *is_allowed) TIZEN_DEPRECATED_API; /** + * @deprecated Deprecated since 7.5. * @partner * @brief Allows or disallows user to use of SMS or text messaging. * @details An administrator can disable the text messaging capability @@ -592,9 +618,10 @@ int dpm_restriction_get_bluetooth_pairing_state(device_policy_manager_h handle, * @pre The handle must be created by dpm_manager_create(). * @see dpm_restriction_get_messaging_state() */ -int dpm_restriction_set_messaging_state(device_policy_manager_h handle, const char *sim_id, int allow); +int dpm_restriction_set_messaging_state(device_policy_manager_h handle, const char *sim_id, int allow) TIZEN_DEPRECATED_API; /** + * @deprecated Deprecated since 7.5. * @brief Checks whether the text messaging is allowed or not. * @details An administrator can use this API to check whether text messaging capability * is enabled or not. @@ -609,9 +636,10 @@ int dpm_restriction_set_messaging_state(device_policy_manager_h handle, const ch * @pre The handle must be created by dpm_manager_create(). * @see dpm_restriction_set_messaging_state() */ -int dpm_restriction_get_messaging_state(device_policy_manager_h handle, const char *sim_id, int *is_allowed); +int dpm_restriction_get_messaging_state(device_policy_manager_h handle, const char *sim_id, int *is_allowed) TIZEN_DEPRECATED_API; /** + * @deprecated Deprecated since 7.5. * @partner * @brief Allows or disallows the access to POP or IMAP email. * @details An administrator can disable the email capability without any user interaction @@ -629,9 +657,10 @@ int dpm_restriction_get_messaging_state(device_policy_manager_h handle, const ch * @pre The handle must be created by dpm_manager_create(). * @see dpm_restriction_get_popimap_email_state() */ -int dpm_restriction_set_popimap_email_state(device_policy_manager_h handle, int allow); +int dpm_restriction_set_popimap_email_state(device_policy_manager_h handle, int allow) TIZEN_DEPRECATED_API; /** + * @deprecated Deprecated since 7.5. * @brief Checks whether the access to POP or IMAP email is allowed or not. * @details An administrator can use this API to check the access to POP or IMAP email * is allowed or not. @@ -645,9 +674,10 @@ int dpm_restriction_set_popimap_email_state(device_policy_manager_h handle, int * @pre The handle must be created by dpm_manager_create(). * @see dpm_restriction_set_popimap_email_state() */ -int dpm_restriction_get_popimap_email_state(device_policy_manager_h handle, int *is_allowed); +int dpm_restriction_get_popimap_email_state(device_policy_manager_h handle, int *is_allowed) TIZEN_DEPRECATED_API; /** + * @deprecated Deprecated since 7.5. * @partner * @brief Allows or disallows the use of web browser. * @details An administrator can allows or disallow the use of web browser without @@ -667,9 +697,10 @@ int dpm_restriction_get_popimap_email_state(device_policy_manager_h handle, int * @pre The handle must be created by dpm_manager_create(). * @see dpm_restriction_get_browser_state() */ -int dpm_restriction_set_browser_state(device_policy_manager_h handle, int allow); +int dpm_restriction_set_browser_state(device_policy_manager_h handle, int allow) TIZEN_DEPRECATED_API; /** + * @deprecated Deprecated since 7.5. * @brief Checks whether the use of web browser is allowed or not. * @details An administrator can use this API to check whether the use of web browser * is allowed or not. @@ -683,7 +714,7 @@ int dpm_restriction_set_browser_state(device_policy_manager_h handle, int allow) * @pre The handle must be created by dpm_manager_create(). * @see dpm_restriction_set_browser_state() */ -int dpm_restriction_get_browser_state(device_policy_manager_h handle, int *is_allowed); +int dpm_restriction_get_browser_state(device_policy_manager_h handle, int *is_allowed) TIZEN_DEPRECATED_API; /** * @} diff --git a/libs/dpm/security.h b/libs/dpm/security.h index d122602..6e623bd 100644 --- a/libs/dpm/security.h +++ b/libs/dpm/security.h @@ -35,6 +35,7 @@ extern "C" { */ /** + * @deprecated Deprecated since 7.5. * @partner * @brief Locks device screen immediately. * @details An administrator can use this API to lock the device screen @@ -51,9 +52,10 @@ extern "C" { * @pre The handle must be created by dpm_manager_create(). * @see dpm_manager_create() */ -int dpm_security_lockout_screen(device_policy_manager_h handle); +int dpm_security_lockout_screen(device_policy_manager_h handle) TIZEN_DEPRECATED_API; /** + * @deprecated Deprecated since 7.5. * @partner * @brief Encrypts or decrypts internal storage. * @details An administrator can use this API to enable full device @@ -77,9 +79,10 @@ int dpm_security_lockout_screen(device_policy_manager_h handle); * @see dpm_manager_create() * @see dpm_security_is_internal_storage_encrypted() */ -int dpm_security_set_internal_storage_encryption(device_policy_manager_h handle, int encrypt); +int dpm_security_set_internal_storage_encryption(device_policy_manager_h handle, int encrypt) TIZEN_DEPRECATED_API; /** + * @deprecated Deprecated since 7.5. * @brief Checks the internal storage encryption state. * @details An administrator can use this API to check whether internal * storage encryption is enabled. @@ -95,9 +98,10 @@ int dpm_security_set_internal_storage_encryption(device_policy_manager_h handle, * @see dpm_manager_create() * @see dpm_security_set_internal_storage_encryption() */ -int dpm_security_is_internal_storage_encrypted(device_policy_manager_h handle, int *is_encrypted); +int dpm_security_is_internal_storage_encrypted(device_policy_manager_h handle, int *is_encrypted) TIZEN_DEPRECATED_API; /** + * @deprecated Deprecated since 7.5. * @partner * @brief Encrypts or decrypts external storage. * @details An administrator can use this API to enable external SD card @@ -120,9 +124,10 @@ int dpm_security_is_internal_storage_encrypted(device_policy_manager_h handle, i * @see dpm_manager_create() * @see dpm_security_is_external_storage_encrypted() */ -int dpm_security_set_external_storage_encryption(device_policy_manager_h handle, int encrypt); +int dpm_security_set_external_storage_encryption(device_policy_manager_h handle, int encrypt) TIZEN_DEPRECATED_API; /** + * @deprecated Deprecated since 7.5. * @brief Checks the external storage encryption state. * @details An administrator can use this API to check whether external * storage encryption is enabled. @@ -138,9 +143,10 @@ int dpm_security_set_external_storage_encryption(device_policy_manager_h handle, * @see dpm_manager_create() * @see dpm_security_set_external_storage_encryption() */ -int dpm_security_is_external_storage_encrypted(device_policy_manager_h handle, int *is_encrypted); +int dpm_security_is_external_storage_encrypted(device_policy_manager_h handle, int *is_encrypted) TIZEN_DEPRECATED_API; /** + * @deprecated Deprecated since 7.5. * @brief Enumeration for device wipe type. * @since_tizen 3.0 */ @@ -150,6 +156,7 @@ typedef enum { } dpm_security_wipe_type_e; /** + * @deprecated Deprecated since 7.5. * @partner * @brief Wipes external memory, internal memory, or both selectively. * @details Device Admin can use this API to wipe both SD card data @@ -168,7 +175,7 @@ typedef enum { * @pre The handle must be created by dpm_manager_create(). * @see dpm_manager_create() */ -int dpm_security_wipe_data(device_policy_manager_h handle, dpm_security_wipe_type_e type); +int dpm_security_wipe_data(device_policy_manager_h handle, dpm_security_wipe_type_e type) TIZEN_DEPRECATED_API; /** * @} diff --git a/libs/dpm/zone.h b/libs/dpm/zone.h index abc499b..ac3cb82 100644 --- a/libs/dpm/zone.h +++ b/libs/dpm/zone.h @@ -34,6 +34,7 @@ extern "C" { */ /** + * @deprecated Deprecated since 7.5. * @partner * @brief Creates a new zone. * @details An administrator can use this API to create a container. Once the container @@ -57,9 +58,10 @@ extern "C" { * @see dpm_manager_create() * @see dpm_zone_destroy() */ -int dpm_zone_create(device_policy_manager_h handle, const char* name, const char* pkgname); +int dpm_zone_create(device_policy_manager_h handle, const char* name, const char* pkgname) TIZEN_DEPRECATED_API; /** + * @deprecated Deprecated since 7.5. * @partner * @brief Removes existing zone. * @details Administrator can use this API to remove zone. All file system objects @@ -82,7 +84,7 @@ int dpm_zone_create(device_policy_manager_h handle, const char* name, const char * @see dpm_manager_create() * @see dpm_zone_create() */ -int dpm_zone_destroy(device_policy_manager_h handle, const char* name); +int dpm_zone_destroy(device_policy_manager_h handle, const char* name) TIZEN_DEPRECATED_API; /** * @brief Enumeration for zone state @@ -95,6 +97,7 @@ typedef enum { } dpm_zone_state_e; /** + * @deprecated Deprecated since 7.5. * @brief Gets the zone state. * @details This API can be used to get the state of the zone. The zone can * have one of the three states(running, locked). @@ -112,9 +115,10 @@ typedef enum { * @see dpm_zone_create() * @see dpm_zone_destroy() */ -int dpm_zone_get_state(device_policy_manager_h handle, const char* name, dpm_zone_state_e *state); +int dpm_zone_get_state(device_policy_manager_h handle, const char* name, dpm_zone_state_e *state) TIZEN_DEPRECATED_API; /** + * @deprecated Deprecated since 7.5. * @brief Called to get all the name of created zones. * @since_tizen 3.0 * @param[in] name The zone name @@ -125,6 +129,7 @@ int dpm_zone_get_state(device_policy_manager_h handle, const char* name, dpm_zon typedef bool(*dpm_zone_foreach_name_cb)(const char* name, void *user_data); /** + * @deprecated Deprecated since 7.5. * @brief Retrieves all the name of created zones * @details This API calls dpm_zone_foreach_cb() once for each zone name * with traversing the created zones list. @@ -144,7 +149,7 @@ typedef bool(*dpm_zone_foreach_name_cb)(const char* name, void *user_data); */ int dpm_zone_foreach_name(device_policy_manager_h handle, dpm_zone_state_e state, - dpm_zone_foreach_name_cb callback, void* user_data); + dpm_zone_foreach_name_cb callback, void* user_data) TIZEN_DEPRECATED_API; /**