Add telephony feature for all APIs

Change-Id: I6c9e479c6dab21ad42db2adce5d98b5f9a3a8c8f
Signed-off-by: Jongkyu Koo <jk.koo@samsung.com>

diff --git a/client/phnc-blocking_rule.c b/client/phnc-blocking_rule.c
index a43f8b916626fd130442dc6b4b5bb7147e1ae7c3..ee73d3cb77c97443a3837ba7d28ca607524daf4a 100644 (file)
--- a/client/phnc-blocking_rule.c
+++ b/client/phnc-blocking_rule.c
@@ -23,6 +23,7 @@
 
 API int phone_number_blocking_rule_create(phone_number_blocking_rule_h *rule)
 {
+       CHECK_FEATURE_SUPPORTED(TELEPHONY_FEATURE);
        int ret;
        RETV_IF(NULL == rule, PHONE_NUMBER_ERROR_INVALID_PARAMETER);
        ret = phn_record_create(rule);
@@ -36,12 +37,14 @@ API int phone_number_blocking_rule_create(phone_number_blocking_rule_h *rule)
 
 API int phone_number_blocking_rule_destroy(phone_number_blocking_rule_h rule)
 {
+       CHECK_FEATURE_SUPPORTED(TELEPHONY_FEATURE);
        RETV_IF(NULL == rule, PHONE_NUMBER_ERROR_INVALID_PARAMETER);
        return phn_record_destroy(rule);
 }
 
 API int phone_number_blocking_rule_get_number(phone_number_blocking_rule_h rule, char** number)
 {
+       CHECK_FEATURE_SUPPORTED(TELEPHONY_FEATURE);
        RETV_IF(NULL == rule, PHONE_NUMBER_ERROR_INVALID_PARAMETER);
        RETV_IF(NULL == number, PHONE_NUMBER_ERROR_INVALID_PARAMETER);
        return phn_record_get_str(rule, PHN_PROPERTY_BLOCKING_RULE_NUMBER, number);
@@ -49,6 +52,7 @@ API int phone_number_blocking_rule_get_number(phone_number_blocking_rule_h rule,
 
 API int phone_number_blocking_rule_get_match_type(phone_number_blocking_rule_h rule, phone_number_blocking_rule_match_type_e *match_type)
 {
+       CHECK_FEATURE_SUPPORTED(TELEPHONY_FEATURE);
        RETV_IF(NULL == rule, PHONE_NUMBER_ERROR_INVALID_PARAMETER);
        RETV_IF(NULL == match_type, PHONE_NUMBER_ERROR_INVALID_PARAMETER);
        return phn_record_get_int(rule, PHN_PROPERTY_BLOCKING_RULE_MATCH_TYPE, (int*)match_type);
@@ -56,6 +60,7 @@ API int phone_number_blocking_rule_get_match_type(phone_number_blocking_rule_h r
 
 API int phone_number_blocking_rule_set_number(phone_number_blocking_rule_h rule, const char* number)
 {
+       CHECK_FEATURE_SUPPORTED(TELEPHONY_FEATURE);
        RETV_IF(NULL == rule, PHONE_NUMBER_ERROR_INVALID_PARAMETER);
        RETV_IF(NULL == number, PHONE_NUMBER_ERROR_INVALID_PARAMETER);
        return phn_record_set_str(rule, PHN_PROPERTY_BLOCKING_RULE_NUMBER, number);
@@ -63,6 +68,7 @@ API int phone_number_blocking_rule_set_number(phone_number_blocking_rule_h rule,
 
 API int phone_number_blocking_rule_set_match_type(phone_number_blocking_rule_h rule, phone_number_blocking_rule_match_type_e match_type)
 {
+       CHECK_FEATURE_SUPPORTED(TELEPHONY_FEATURE);
        RETV_IF(NULL == rule, PHONE_NUMBER_ERROR_INVALID_PARAMETER);
        RETV_IF((match_type < PHONE_NUMBER_MATCH_TYPE_EXACTLY || PHONE_NUMBER_MATCH_TYPE_ENDS_WITH < match_type),
                                PHONE_NUMBER_ERROR_INVALID_PARAMETER);

diff --git a/client/phnc.c b/client/phnc.c
index 2f688ccb1099418359bdb954bc90ae640e315ce6..6527af4a451892c935794147eeaa805711778413 100644 (file)
--- a/client/phnc.c
+++ b/client/phnc.c
@@ -29,35 +29,6 @@
 #include "phnc-dbus.h"
 #include "phnc.h"
 
-#define PHN_FEATURE_TELEPHONY "http://tizen.org/feature/network.telephony"
-
-#define PHN_FEATURE_TELEPHONY_NOT_CHECKED -1
-#define PHN_FEATURE_TELEPHONY_NOT_SUPPORTED 0
-#define PHN_FEATURE_TELEPHONY_SUPPORTED 1
-
-static int _phn_is_support_telephony_feature()
-{
-       int err;
-       bool is_support;
-       static int _phn_telephony_feature_support = PHN_FEATURE_TELEPHONY_NOT_CHECKED;
-
-       if (PHN_FEATURE_TELEPHONY_NOT_CHECKED != _phn_telephony_feature_support)
-               return _phn_telephony_feature_support;
-
-       err  = system_info_get_platform_bool(PHN_FEATURE_TELEPHONY, &is_support);
-       if (SYSTEM_INFO_ERROR_NONE != err) {
-               /* LCOV_EXCL_START */
-               DBG("Error system_info_get_platform_bool : %d", err);
-               return PHONE_NUMBER_ERROR_SYSTEM;
-               /* LCOV_EXCL_STOP */
-       }
-
-       _phn_telephony_feature_support =
-               is_support ? PHN_FEATURE_TELEPHONY_SUPPORTED : PHN_FEATURE_TELEPHONY_NOT_SUPPORTED;
-
-       return _phn_telephony_feature_support;
-}
-
 #define PHNC_SYSTEM_SLICE "system.slice"
 
 int phnc_get_uid(void)
@@ -97,6 +68,7 @@ int phnc_get_uid(void)
 
 API int phone_number_connect(void)
 {
+       CHECK_FEATURE_SUPPORTED(TELEPHONY_FEATURE);
        FN_CALL;
        return phnc_dbus_connect();
 }
@@ -104,12 +76,14 @@ API int phone_number_connect(void)
 
 API int phone_number_disconnect(void)
 {
+       CHECK_FEATURE_SUPPORTED(TELEPHONY_FEATURE);
        return phnc_dbus_disconnect();
 }
 
 API int phone_number_get_location_from_number(const char *number,
                phone_number_region_e region, phone_number_lang_e lang, char **location)
 {
+       CHECK_FEATURE_SUPPORTED(TELEPHONY_FEATURE);
        FN_CALL;
 
        RETV_IF(NULL == number, PHONE_NUMBER_ERROR_INVALID_PARAMETER);
@@ -126,6 +100,7 @@ API int phone_number_get_location_from_number(const char *number,
 API int phone_number_get_formatted_number(const char *number,
                phone_number_region_e region, char **formatted_number)
 {
+       CHECK_FEATURE_SUPPORTED(TELEPHONY_FEATURE);
        FN_CALL;
 
        RETV_IF(NULL == number, PHONE_NUMBER_ERROR_INVALID_PARAMETER);
@@ -139,14 +114,10 @@ API int phone_number_get_formatted_number(const char *number,
 
 API int phone_number_get_normalized_number(const char *number, char **normalized_number)
 {
+       CHECK_FEATURE_SUPPORTED(TELEPHONY_FEATURE);
        FN_CALL;
 
        int ret = 0;
-
-       ret = _phn_is_support_telephony_feature();
-       RETV_IF(PHONE_NUMBER_ERROR_SYSTEM == ret, PHONE_NUMBER_ERROR_SYSTEM);
-       RETV_IF(PHN_FEATURE_TELEPHONY_NOT_SUPPORTED == ret, PHONE_NUMBER_ERROR_NOT_SUPPORTED);
-
        RETV_IF(NULL == number, PHONE_NUMBER_ERROR_INVALID_PARAMETER);
        RETV_IF('\0' == *number, PHONE_NUMBER_ERROR_INVALID_PARAMETER);
        RETV_IF(NULL == normalized_number, PHONE_NUMBER_ERROR_INVALID_PARAMETER);
@@ -156,15 +127,16 @@ API int phone_number_get_normalized_number(const char *number, char **normalized
 
 API int phone_number_add_blocking_rule(phone_number_blocking_rule_h rule)
 {
+       CHECK_FEATURE_SUPPORTED(TELEPHONY_FEATURE);
        FN_CALL;
        RETV_IF(NULL == rule, PHONE_NUMBER_ERROR_INVALID_PARAMETER);
 
-       return phnc_dbus_add_blocking_rule
-(rule);
+       return phnc_dbus_add_blocking_rule(rule);
 }
 
 API int phone_number_remove_blocking_rule(phone_number_blocking_rule_h rule)
 {
+       CHECK_FEATURE_SUPPORTED(TELEPHONY_FEATURE);
        FN_CALL;
        RETV_IF(NULL == rule, PHONE_NUMBER_ERROR_INVALID_PARAMETER);
        int id = 0;
@@ -178,6 +150,7 @@ API int phone_number_remove_blocking_rule(phone_number_blocking_rule_h rule)
 
 API int phone_number_get_blocking_rules(int offset, int limit, phone_number_blocking_rule_h **rules, int *length)
 {
+       CHECK_FEATURE_SUPPORTED(TELEPHONY_FEATURE);
        FN_CALL;
        RETV_IF(offset < 0, PHONE_NUMBER_ERROR_INVALID_PARAMETER);
        RETV_IF(limit < 0, PHONE_NUMBER_ERROR_INVALID_PARAMETER);
@@ -189,6 +162,7 @@ API int phone_number_get_blocking_rules(int offset, int limit, phone_number_bloc
 
 API int phone_number_get_blocking_rules_related(const char *number, phone_number_blocking_rule_h **rules, int *length)
 {
+       CHECK_FEATURE_SUPPORTED(TELEPHONY_FEATURE);
        FN_CALL;
        RETV_IF(number == NULL, PHONE_NUMBER_ERROR_INVALID_PARAMETER);
        RETV_IF(NULL == rules, PHONE_NUMBER_ERROR_INVALID_PARAMETER);
@@ -199,6 +173,7 @@ API int phone_number_get_blocking_rules_related(const char *number, phone_number
 
 API int phone_number_check_blocking(const char *number, bool* is_blocked)
 {
+       CHECK_FEATURE_SUPPORTED(TELEPHONY_FEATURE);
        FN_CALL;
        RETV_IF(NULL == number, PHONE_NUMBER_ERROR_INVALID_PARAMETER);
        RETV_IF('\0' == *number, PHONE_NUMBER_ERROR_INVALID_PARAMETER);

diff --git a/common/phn-log.h b/common/phn-log.h
index 7a30c61bda7a2ddbbc9e024cca6428dce4e521f5..6b3e7e23dd6c03459ae89e7dfa63612ac4445e1c 100644 (file)
--- a/common/phn-log.h
+++ b/common/phn-log.h
@@ -46,6 +46,7 @@
 
 #define LOG_TAG "PHN_UTILS"
 #include <dlog.h>
+#include <system_info.h>
 
 #ifdef PHN_DAEMON_LOG
 
@@ -137,4 +138,19 @@
                } \
        } while (0)
 
+#define TELEPHONY_FEATURE "http://tizen.org/feature/network.telephony"
+#define CHECK_FEATURE_SUPPORTED(feature_name) \
+                       do { \
+                               bool is_supported = false; \
+                               if (!system_info_get_platform_bool(feature_name, &is_supported)) { \
+                                       if (is_supported == false) { \
+                                               LOGE("[%s] feature is disabled", feature_name); \
+                                               return PHONE_NUMBER_ERROR_NOT_SUPPORTED; \
+                                       } \
+                               } else { \
+                                       LOGE("Error - Feature getting from System Info"); \
+                                       return PHONE_NUMBER_ERROR_SYSTEM; \
+                               } \
+                       } while (0)
+
 #endif /* __PHONENUMBER_UTILS_LOG_H__ */

diff --git a/doc/phnumber_doc.h b/doc/phnumber_doc.h
index f4738adbc377909bb29575daf6c9dc38e4395d70..e3fa6bd37321743cb156a3f5f629697e1ef8877e 100644 (file)
--- a/doc/phnumber_doc.h
+++ b/doc/phnumber_doc.h
@@ -33,7 +33,7 @@
  *
  * @section CAPI_TELEPHONY_INFORMATION_SIM_FEATURE Related Features
  * This API is related with the following feature:\n
- * - http://tizen.org/feature/network.telephony
+ * - http://tizen.org/feature/network.telephony\n
  * It is recommended to design feature related codes in your application for reliability.\n
  * You can check if a device supports the related features for this API by using @ref CAPI_SYSTEM_SYSTEM_INFO_MODULE, thereby controlling the procedure of your application.\n
  * To ensure your application is only running on the device with specific features, please define the features in your manifest file using the manifest editor in the SDK.\n

diff --git a/include/phone_number.h b/include/phone_number.h
index 936c2aebd9f83b5de7a4a95927edfa654b58ed34..7657c96cf38f253cf350680e4010a9cbf004b28c 100644 (file)
--- a/include/phone_number.h
+++ b/include/phone_number.h
@@ -48,6 +48,7 @@ extern "C"
  * @return @c 0 on success,
  *         otherwise a negative error value
  * @retval #PHONE_NUMBER_ERROR_NONE Successful
+ * @retval #PHONE_NUMBER_ERROR_NOT_SUPPORTED Not supported
  * @retval #PHONE_NUMBER_ERROR_SYSTEM Internal error
  * @see phone_number_disconnect()
  */
@@ -60,6 +61,7 @@ int phone_number_connect(void);
  * @return @c 0 on success,
  *         otherwise a negative error value
  * @retval #PHONE_NUMBER_ERROR_NONE Successful
+ * @retval #PHONE_NUMBER_ERROR_NOT_SUPPORTED Not supported
  * @retval #PHONE_NUMBER_ERROR_SYSTEM Internal error
  * @see phone_number_connect()
  */
@@ -85,6 +87,7 @@ int phone_number_disconnect(void);
  * @retval #PHONE_NUMBER_ERROR_PERMISSION_DENIED Permission denied
  * @retval #PHONE_NUMBER_ERROR_NOT_SUPPORTED Not supported
  * @retval #PHONE_NUMBER_ERROR_NO_DATA Requested data does not exist
+ * @retval #PHONE_NUMBER_ERROR_SYSTEM Internal error
  * @pre phone_number_connect() should be called to open a connection to the phonenumber-utils service. (Since 3.0)
  * @post phone_number_disconnect() should be called to close a connection to the phonenumber-utils service. (Since 3.0)
  */
@@ -110,6 +113,7 @@ int phone_number_get_location_from_number(const char *number,
  * @retval #PHONE_NUMBER_ERROR_PERMISSION_DENIED Permission denied
  * @retval #PHONE_NUMBER_ERROR_NOT_SUPPORTED Not supported
  * @retval #PHONE_NUMBER_ERROR_NO_DATA Requested data does not exist
+ * @retval #PHONE_NUMBER_ERROR_SYSTEM Internal error
  * @pre phone_number_connect() should be called to open a connection to the phonenumber-utils service. (Since 3.0)
  * @post phone_number_disconnect() should be called to close a connection to the phonenumber-utils service. (Since 3.0)
  */
@@ -133,9 +137,9 @@ int phone_number_get_formatted_number(const char *number, phone_number_region_e
  *         otherwise a negative error value
  * @retval #PHONE_NUMBER_ERROR_NONE Successful
  * @retval #PHONE_NUMBER_ERROR_OUT_OF_MEMORY Out of memory
- * @retval #PHONE_NUMBER_ERROR_NOT_SUPPORTED Not supported
  * @retval #PHONE_NUMBER_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #PHONE_NUMBER_ERROR_PERMISSION_DENIED Permission denied
+ * @retval #PHONE_NUMBER_ERROR_NOT_SUPPORTED Not supported
  * @retval #PHONE_NUMBER_ERROR_NO_DATA Requested data does not exist
  * @retval #PHONE_NUMBER_ERROR_SYSTEM Internal error
  * @pre phone_number_connect() should be called to open a connection to the phonenumber-utils service. (Since 3.0)
@@ -155,12 +159,14 @@ int phone_number_get_normalized_number(const char *number, char **normalized_num
  *
  * @return  @c 0 on success,
  *          otherwise a negative error value
- * @retval  #PHONE_NUMBER_ERROR_NONE                Successful
- * @retval  #PHONE_NUMBER_ERROR_INVALID_PARAMETER   Invalid parameter
- * @retval  #PHONE_NUMBER_ERROR_DB_FAILED           Database operation failure
- * @retval  #PHONE_NUMBER_ERROR_PERMISSION_DENIED   Permission denied. This application does not have the privilege to call this method.
- * @retval  #PHONE_NUMBER_ERROR_IPC                 Unknown IPC error
- * @retval  #PHONE_NUMBER_ERROR_OUT_OF_MEMORY       Out of memory
+ * @retval #PHONE_NUMBER_ERROR_NONE                Successful
+ * @retval #PHONE_NUMBER_ERROR_INVALID_PARAMETER   Invalid parameter
+ * @retval #PHONE_NUMBER_ERROR_DB_FAILED           Database operation failure
+ * @retval #PHONE_NUMBER_ERROR_PERMISSION_DENIED   Permission denied. This application does not have the privilege to call this method.
+ * @retval #PHONE_NUMBER_ERROR_NOT_SUPPORTED Not supported
+ * @retval #PHONE_NUMBER_ERROR_IPC                 Unknown IPC error
+ * @retval #PHONE_NUMBER_ERROR_OUT_OF_MEMORY       Out of memory
+ * @retval #PHONE_NUMBER_ERROR_SYSTEM Internal error
  * @pre phone_number_connect() should be called to open a connection to the phonenumber-utils service.
  * @post phone_number_disconnect() should be called to close a connection to the phonenumber-utils service.
  * @see phone_number_remove_blocking_rule()
@@ -181,12 +187,14 @@ int phone_number_add_blocking_rule(phone_number_blocking_rule_h rule);
  *
  * @return  @c 0 on success,
  *          otherwise a negative error value
- * @retval  #PHONE_NUMBER_ERROR_NONE                Successful
- * @retval  #PHONE_NUMBER_ERROR_INVALID_PARAMETER   Invalid parameter
- * @retval  #PHONE_NUMBER_ERROR_DB_FAILED           Database operation failure
- * @retval  #PHONE_NUMBER_ERROR_PERMISSION_DENIED   Permission denied. This application does not have the privilege to call this method.
- * @retval  #PHONE_NUMBER_ERROR_IPC                 Unknown IPC error
- * @retval  #PHONE_NUMBER_ERROR_OUT_OF_MEMORY       Out of memory
+ * @retval #PHONE_NUMBER_ERROR_NONE                Successful
+ * @retval #PHONE_NUMBER_ERROR_INVALID_PARAMETER   Invalid parameter
+ * @retval #PHONE_NUMBER_ERROR_DB_FAILED           Database operation failure
+ * @retval #PHONE_NUMBER_ERROR_PERMISSION_DENIED   Permission denied. This application does not have the privilege to call this method.
+ * @retval #PHONE_NUMBER_ERROR_NOT_SUPPORTED Not supported
+ * @retval #PHONE_NUMBER_ERROR_IPC                 Unknown IPC error
+ * @retval #PHONE_NUMBER_ERROR_OUT_OF_MEMORY       Out of memory
+ * @retval #PHONE_NUMBER_ERROR_SYSTEM Internal error
  * @pre phone_number_connect() should be called to open a connection to the phonenumber-utils service.
  * @post phone_number_disconnect() should be called to close a connection to the phonenumber-utils service.
  * @see phone_number_add_blocking_rule()
@@ -210,13 +218,15 @@ int phone_number_remove_blocking_rule(phone_number_blocking_rule_h rule);
  *
  * @return  @c 0 on success,
  *          otherwise a negative error value
- * @retval  #PHONE_NUMBER_ERROR_NONE                Successful
- * @retval  #PHONE_NUMBER_ERROR_OUT_OF_MEMORY       Out of memory
- * @retval  #PHONE_NUMBER_ERROR_INVALID_PARAMETER   Invalid parameter
- * @retval  #PHONE_NUMBER_ERROR_DB_FAILED           Database operation failure
- * @retval  #PHONE_NUMBER_ERROR_PERMISSION_DENIED   Permission denied. This application does not have the privilege to call this method.
- * @retval  #PHONE_NUMBER_ERROR_IPC                 Unknown IPC error
- * @retval  #PHONE_NUMBER_ERROR_NO_DATA             Data does not exist
+ * @retval #PHONE_NUMBER_ERROR_NONE                Successful
+ * @retval #PHONE_NUMBER_ERROR_OUT_OF_MEMORY       Out of memory
+ * @retval #PHONE_NUMBER_ERROR_INVALID_PARAMETER   Invalid parameter
+ * @retval #PHONE_NUMBER_ERROR_DB_FAILED           Database operation failure
+ * @retval #PHONE_NUMBER_ERROR_PERMISSION_DENIED   Permission denied. This application does not have the privilege to call this method.
+ * @retval #PHONE_NUMBER_ERROR_NOT_SUPPORTED Not supported
+ * @retval #PHONE_NUMBER_ERROR_IPC                 Unknown IPC error
+ * @retval #PHONE_NUMBER_ERROR_NO_DATA             Data does not exist
+ * @retval #PHONE_NUMBER_ERROR_SYSTEM Internal error
  * @pre phone_number_connect() should be called to open a connection to the phonenumber-utils service.
  * @post phone_number_disconnect() should be called to close a connection to the phonenumber-utils service.
  */
@@ -238,13 +248,15 @@ int phone_number_get_blocking_rules(int offset, int limit, phone_number_blocking
  *
  * @return  @c 0 on success,
  *          otherwise a negative error value
- * @retval  #PHONE_NUMBER_ERROR_NONE                Successful
- * @retval  #PHONE_NUMBER_ERROR_OUT_OF_MEMORY       Out of memory
- * @retval  #PHONE_NUMBER_ERROR_INVALID_PARAMETER   Invalid parameter
- * @retval  #PHONE_NUMBER_ERROR_DB_FAILED           Database operation failure
- * @retval  #PHONE_NUMBER_ERROR_PERMISSION_DENIED   Permission denied. This application does not have the privilege to call this method.
- * @retval  #PHONE_NUMBER_ERROR_IPC                 Unknown IPC error
- * @retval  #PHONE_NUMBER_ERROR_NO_DATA             Data does not exist
+ * @retval #PHONE_NUMBER_ERROR_NONE                Successful
+ * @retval #PHONE_NUMBER_ERROR_OUT_OF_MEMORY       Out of memory
+ * @retval #PHONE_NUMBER_ERROR_INVALID_PARAMETER   Invalid parameter
+ * @retval #PHONE_NUMBER_ERROR_DB_FAILED           Database operation failure
+ * @retval #PHONE_NUMBER_ERROR_PERMISSION_DENIED   Permission denied. This application does not have the privilege to call this method.
+ * @retval #PHONE_NUMBER_ERROR_NOT_SUPPORTED Not supported
+ * @retval #PHONE_NUMBER_ERROR_IPC                 Unknown IPC error
+ * @retval #PHONE_NUMBER_ERROR_NO_DATA             Data does not exist
+ * @retval #PHONE_NUMBER_ERROR_SYSTEM Internal error
  * @pre phone_number_connect() should be called to open a connection to the phonenumber-utils service.
  * @post phone_number_disconnect() should be called to close a connection to the phonenumber-utils service.
  */
@@ -263,11 +275,13 @@ int phone_number_get_blocking_rules_related(const char *number, phone_number_blo
  *
  * @return  @c 0 on success,
  *          otherwise a negative error value
- * @retval  #PHONE_NUMBER_ERROR_NONE                Successful
- * @retval  #PHONE_NUMBER_ERROR_INVALID_PARAMETER   Invalid parameter
- * @retval  #PHONE_NUMBER_ERROR_DB_FAILED           Database operation failure
- * @retval  #PHONE_NUMBER_ERROR_PERMISSION_DENIED   Permission denied. This application does not have the privilege to call this method.
- * @retval  #PHONE_NUMBER_ERROR_IPC                 Unknown IPC error
+ * @retval #PHONE_NUMBER_ERROR_NONE                Successful
+ * @retval #PHONE_NUMBER_ERROR_INVALID_PARAMETER   Invalid parameter
+ * @retval #PHONE_NUMBER_ERROR_DB_FAILED           Database operation failure
+ * @retval #PHONE_NUMBER_ERROR_PERMISSION_DENIED   Permission denied. This application does not have the privilege to call this method.
+ * @retval #PHONE_NUMBER_ERROR_NOT_SUPPORTED Not supported
+ * @retval #PHONE_NUMBER_ERROR_IPC                 Unknown IPC error
+ * @retval #PHONE_NUMBER_ERROR_SYSTEM Internal error
  * @pre phone_number_connect() should be called to open a connection to the phonenumber-utils service.
  * @post phone_number_disconnect() should be called to close a connection to the phonenumber-utils service.
  */

diff --git a/include/phone_number_blocking_rule.h b/include/phone_number_blocking_rule.h
index 6ff2870fcb7c776af2186dc8b0c48771871c1e4a..591671bdee5e2bf54b4cd99c368ed9e1ce6384f2 100644 (file)
--- a/include/phone_number_blocking_rule.h
+++ b/include/phone_number_blocking_rule.h
@@ -44,9 +44,11 @@ extern "C" {
  *
  * @return  @c 0 on success,
  *          otherwise a negative error value
- * @retval  #PHONE_NUMBER_ERROR_NONE                Successful
- * @retval  #PHONE_NUMBER_ERROR_OUT_OF_MEMORY       Out of memory
- * @retval  #PHONE_NUMBER_ERROR_INVALID_PARAMETER   Invalid parameter
+ * @retval #PHONE_NUMBER_ERROR_NONE                Successful
+ * @retval #PHONE_NUMBER_ERROR_OUT_OF_MEMORY       Out of memory
+ * @retval #PHONE_NUMBER_ERROR_INVALID_PARAMETER   Invalid parameter
+ * @retval #PHONE_NUMBER_ERROR_NOT_SUPPORTED Not supported
+ * @retval #PHONE_NUMBER_ERROR_SYSTEM Internal error
  *
  * @pre     phone_number_connect() should be called to initialize.
  *
@@ -64,8 +66,10 @@ int phone_number_blocking_rule_create(phone_number_blocking_rule_h *rule);
  *
  * @return  @c 0 on success,
  *          otherwise a negative error value
- * @retval  #PHONE_NUMBER_ERROR_NONE                 Successful
- * @retval  #PHONE_NUMBER_ERROR_INVALID_PARAMETER    Invalid parameter
+ * @retval #PHONE_NUMBER_ERROR_NONE                 Successful
+ * @retval #PHONE_NUMBER_ERROR_INVALID_PARAMETER    Invalid parameter
+ * @retval #PHONE_NUMBER_ERROR_NOT_SUPPORTED Not supported
+ * @retval #PHONE_NUMBER_ERROR_SYSTEM Internal error
  *
  * @see phone_number_blocking_rule_create()
  */
@@ -84,8 +88,10 @@ int phone_number_blocking_rule_destroy(phone_number_blocking_rule_h rule);
  *
  * @return @c 0 on success,
  *         otherwise a negative error value
- * @retval  #PHONE_NUMBER_ERROR_NONE                Successful
- * @retval  #PHONE_NUMBER_ERROR_INVALID_PARAMETER   Invalid parameter
+ * @retval #PHONE_NUMBER_ERROR_NONE                Successful
+ * @retval #PHONE_NUMBER_ERROR_INVALID_PARAMETER   Invalid parameter
+ * @retval #PHONE_NUMBER_ERROR_NOT_SUPPORTED Not supported
+ * @retval #PHONE_NUMBER_ERROR_SYSTEM Internal error
  *
  * @see phone_number_blocking_rule_set_number()
  */
@@ -102,8 +108,10 @@ int phone_number_blocking_rule_get_number(phone_number_blocking_rule_h rule, cha
  *
  * @return @c 0 on success,
  *         otherwise a negative error value
- * @retval  #PHONE_NUMBER_ERROR_NONE                Successful
- * @retval  #PHONE_NUMBER_ERROR_INVALID_PARAMETER   Invalid parameter
+ * @retval #PHONE_NUMBER_ERROR_NONE                Successful
+ * @retval #PHONE_NUMBER_ERROR_INVALID_PARAMETER   Invalid parameter
+ * @retval #PHONE_NUMBER_ERROR_NOT_SUPPORTED Not supported
+ * @retval #PHONE_NUMBER_ERROR_SYSTEM Internal error
  *
  * @see phone_number_blocking_rule_set_match_type()
  */
@@ -120,8 +128,10 @@ int phone_number_blocking_rule_get_match_type(phone_number_blocking_rule_h rule,
  *
  * @return @c 0 on success,
  *         otherwise a negative error value
- * @retval  #PHONE_NUMBER_ERROR_NONE                Successful
- * @retval  #PHONE_NUMBER_ERROR_INVALID_PARAMETER   Invalid parameter
+ * @retval #PHONE_NUMBER_ERROR_NONE                Successful
+ * @retval #PHONE_NUMBER_ERROR_INVALID_PARAMETER   Invalid parameter
+ * @retval #PHONE_NUMBER_ERROR_NOT_SUPPORTED Not supported
+ * @retval #PHONE_NUMBER_ERROR_SYSTEM Internal error
  *
  * @see phone_number_blocking_rule_get_number()
  */
@@ -138,8 +148,10 @@ int phone_number_blocking_rule_set_number(phone_number_blocking_rule_h rule, con
  *
  * @return      @c 0 on success,
  *              otherwise a negative error value
- * @retval      #PHONE_NUMBER_ERROR_NONE                  Successful
- * @retval      #PHONE_NUMBER_ERROR_INVALID_PARAMETER     Invalid parameter
+ * @retval #PHONE_NUMBER_ERROR_NONE                  Successful
+ * @retval #PHONE_NUMBER_ERROR_INVALID_PARAMETER     Invalid parameter
+ * @retval #PHONE_NUMBER_ERROR_NOT_SUPPORTED Not supported
+ * @retval #PHONE_NUMBER_ERROR_SYSTEM Internal error
  *
  * @see phone_number_blocking_rule_get_match_type()
  */