Merge "[ACR-876] Support Ultra Data Save Status Get/Change CB API" into tizen
[platform/core/api/system-settings.git] / include / system_settings_private.h
1 /*
2  * Copyright (c) 2011 Samsung Electronics Co., Ltd All Rights Reserved
3  *
4  * Licensed under the Apache License, Version 2.0 (the License);
5  * you may not use this file except in compliance with the License.
6  * You may obtain a copy of the License at
7  *
8  * http://www.apache.org/licenses/LICENSE-2.0
9  *
10  * Unless required by applicable law or agreed to in writing, software
11  * distributed under the License is distributed on an AS IS BASIS,
12  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13  * See the License for the specific language governing permissions and
14  * limitations under the License.
15  */
16
17
18 #ifndef __TIZEN_SYSTEM_SETTING_PRIVATE_H__
19 #define __TIZEN_SYSTEM_SETTING_PRIVATE_H__
20
21 #ifdef __cplusplus
22 extern "C"
23 {
24 #endif
25
26 #include <dlog.h>
27 #include <system_settings.h>
28
29 #ifdef LOG_TAG
30 #undef LOG_TAG
31 #endif
32
33 #define LOG_TAG "SYSTEM-SETTINGS"
34
35 #define SYSTEM_SETTINGS_ENABLE_TRACE
36
37 #ifdef SYSTEM_SETTINGS_ENABLE_TRACE
38
39
40 #define SETTING_TRACE_DEBUG(fmt, arg...) \
41         do {\
42                 SECURE_LOGD("\033[0;32mDEBUG: " fmt "\033[0m\n", ##arg);\
43         } while (0);
44
45 #define SETTING_TRACE(fmt, arg...) \
46         do {\
47                 SECURE_LOGI("\033[0;36m" fmt "\033[0m\n", ##arg);\
48         } while (0);
49
50 #define SETTING_TRACE_BEGIN do {\
51                 SECURE_LOGD("\033[0;35mENTER FUNCTION: %s. \033[0m\n", __FUNCTION__);\
52         } while (0);
53
54 #define SETTING_TRACE_END  do {\
55                 SECURE_LOGD("\033[0;35mEXIT FUNCTION: %s. \033[0m\n", __FUNCTION__);\
56         } while (0);
57 #else
58 #define SETTING_TRACE_DEBUG(fmt, arg...)
59 #define SETTING_TRACE(fmt, arg...)
60 #define SETTING_TRACE_BEGIN
61 #define SETTING_TRACE_END
62 #endif
63
64
65
66 /**
67  * @internal
68  * @since_tizen 2.3
69  * Enumeration for data type of internal getter/setter.
70  */
71 typedef enum {
72         SYSTEM_SETTING_DATA_TYPE_STRING,        /**< string */
73         SYSTEM_SETTING_DATA_TYPE_INT,           /**< integer */
74         SYSTEM_SETTING_DATA_TYPE_BOOL,          /**< boolean */
75 #if 0
76         /*SYSTEM_SETTING_DATA_TYPE_FLOAT, */
77         /*SYSTEM_SETTING_DATA_TYPE_DOULBE, */
78 #endif
79 }
80 system_setting_data_type_e;
81
82
83 /**
84  * @internal
85  * @since_tizen 2.3
86  * @return      0 on success, otherwise a negative error value
87  * @retval      #SYSTEM_SETTINGS_ERROR_NONE Successful
88  * @retval      #SYSTEM_SETTINGS_ERROR_INVALID_PARAMETER Invalid parameter
89  * @retval      #SYSTEM_SETTINGS_ERROR_IO_ERROR Internal I/O error
90  * @retval      #SYSTEM_SETTINGS_ERROR_PERMISSION_DENIED Permission violation error
91  */
92 typedef int (*system_setting_get_value_cb)(system_settings_key_e key, system_setting_data_type_e data_type, void **value);
93
94 /**
95  * @internal
96  * @since_tizen 2.3
97  * @return      0 on success, otherwise a negative error value
98  * @retval      #SYSTEM_SETTINGS_ERROR_NONE Successful
99  * @retval      #SYSTEM_SETTINGS_ERROR_INVALID_PARAMETER Invalid parameter
100  * @retval      #SYSTEM_SETTINGS_ERROR_IO_ERROR Internal I/O error
101  * @retval      #SYSTEM_SETTINGS_ERROR_PERMISSION_DENIED Permission violation error
102  */
103 typedef int (*system_setting_set_value_cb)(system_settings_key_e key, system_setting_data_type_e data_type, void *value);
104
105 typedef int (*system_setting_add_value_cb)(system_settings_key_e key, system_setting_data_type_e data_type, void *value);
106 typedef int (*system_setting_del_value_cb)(system_settings_key_e key, system_setting_data_type_e data_type, void *value);
107 typedef int (*system_setting_list_value_cb)(system_settings_key_e key, system_setting_data_type_e data_type, system_settings_iter_cb callback, void *user_data);
108
109 /**
110  * @internal
111  * @since_tizen 2.3
112  * @return      0 on success, otherwise a negative error value
113  * @retval      #SYSTEM_SETTINGS_ERROR_NONE Successful
114  * @retval      #SYSTEM_SETTINGS_ERROR_INVALID_PARAMETER Invalid parameter
115  * @retval      #SYSTEM_SETTINGS_ERROR_IO_ERROR Internal I/O error
116  * @retval      #SYSTEM_SETTINGS_ERROR_PERMISSION_DENIED Permission violation error
117  */
118 typedef int (*system_setting_set_changed_callback_cb)(system_settings_key_e key, system_settings_changed_cb callback, void *user_data);
119
120 /**
121  * @internal
122  * @since_tizen 2.3
123  * @return      0 on success, otherwise a negative error value
124  * @retval      #SYSTEM_SETTINGS_ERROR_NONE Successful
125  * @retval      #SYSTEM_SETTINGS_ERROR_INVALID_PARAMETER Invalid parameter
126  * @retval      #SYSTEM_SETTINGS_ERROR_IO_ERROR Internal I/O error
127  * @retval      #SYSTEM_SETTINGS_ERROR_PERMISSION_DENIED Permission violation error
128  */
129 typedef int (*system_setting_unset_changed_callback_cb)(system_settings_key_e key);
130
131
132 /**
133  * @internal
134  * @since_tizen 2.3
135  * @return      0 on success, otherwise a negative error value
136  * @retval      #SYSTEM_SETTINGS_ERROR_NONE Successful
137  * @retval      #SYSTEM_SETTINGS_ERROR_INVALID_PARAMETER Invalid parameter
138  * @retval      #SYSTEM_SETTINGS_ERROR_IO_ERROR Internal I/O error
139  */
140 typedef struct {
141         system_settings_key_e key;                                                                              /**< key */
142         system_setting_data_type_e data_type;                                                   /**< data type */
143         system_setting_get_value_cb get_value_cb;                                               /**< function pointer for getter */
144         system_setting_set_value_cb set_value_cb;                                               /**< function pointer for setter */
145
146         system_setting_set_changed_callback_cb set_changed_cb;                  /**< function pointer to register for notification callback */
147         system_setting_unset_changed_callback_cb unset_changed_cb ;             /**< function pointer to un-register for notification callback */
148         system_settings_changed_cb changed_cb;                                                  /* registered by user application */
149
150         system_setting_add_value_cb add_value_cb;
151         system_setting_del_value_cb del_value_cb;
152         system_setting_list_value_cb list_value_cb;
153
154         void *user_data;                                                                                                /* user_data */
155
156 } system_setting_s;
157
158 typedef system_setting_s *system_setting_h;
159
160
161 /**
162  * @internal
163  * @since_tizen 2.3
164  * @return      0 on success, otherwise a negative error value
165  * @retval      #SYSTEM_SETTINGS_ERROR_NONE Successful
166  * @retval      #SYSTEM_SETTINGS_ERROR_INVALID_PARAMETER Invalid parameter
167  * @retval      #SYSTEM_SETTINGS_ERROR_IO_ERROR Internal I/O error
168  * @retval      #SYSTEM_SETTINGS_ERROR_PERMISSION_DENIED Permission violation error
169  */
170 int system_settings_get_item(system_settings_key_e key, system_setting_h *item);
171
172
173 /* get */
174
175 /**
176  * @internal
177  * @brief get vconf of in type value
178  * @since_tizen 2.3
179  *
180  * @param[in] vconf_key string
181  * @param[out] value get the integer type value
182  *
183  * @return 0 on success, -1 on error
184  * @retval      #SYSTEM_SETTINGS_ERROR_PERMISSION_DENIED Permission violation error
185  */
186 int system_setting_vconf_get_value_int(const char *vconf_key, int *value);
187
188 /**
189  * @internal
190  * @brief get vconf of in bool value
191  * @since_tizen 2.3
192  *
193  * @param[in] vconf_key string
194  * @param[out] value get the bool type value
195  *
196  * @return 0 on success, -1 on error
197  * @retval      #SYSTEM_SETTINGS_ERROR_PERMISSION_DENIED Permission violation error
198  */
199 int system_setting_vconf_get_value_bool(const char *vconf_key, bool *value);
200
201 /**
202  * @internal
203  * @brief get vconf of string type value
204  * @since_tizen 2.3
205  *
206  * @param[in] vconf_key string
207  * @param[out] value get the string(char*) type value
208  *
209  * @return 0 on success, -1 on error
210  * @retval      #SYSTEM_SETTINGS_ERROR_PERMISSION_DENIED Permission violation error
211  */
212 int system_setting_vconf_get_value_string(const char *vconf_key, char **value);
213
214 /**
215  * @internal
216  * @brief set the int type vconf value
217  * @since_tizen 2.3
218  *
219  * @param[in] vconf_key key name
220  * @param[in] value int type value
221  *
222  * @return 0 on success, -1 on error
223  * @retval      #SYSTEM_SETTINGS_ERROR_PERMISSION_DENIED Permission violation error
224  */
225 int system_setting_vconf_set_value_int(const char *vconf_key, int value);
226
227 /**
228  * @internal
229  * @brief set the bool type vconf value
230  * @since_tizen 2.3
231  *
232  * @param[in] vconf_key key name
233  * @param[in] value bool type value
234  *
235  * @return 0 on success, -1 on error
236  * @retval      #SYSTEM_SETTINGS_ERROR_PERMISSION_DENIED Permission violation error
237  */
238 int system_setting_vconf_set_value_bool(const char *vconf_key, bool value);
239
240 /**
241  * @internal
242  * @brief set the string type vconf value
243  * @since_tizen 2.3
244  *
245  * @param[in] vconf_key key name
246  * @param[in] value string type value
247  *
248  * @return 0 on success, -1 on error
249  * @retval      #SYSTEM_SETTINGS_ERROR_PERMISSION_DENIED Permission violation error
250  */
251 int system_setting_vconf_set_value_string(const char *vconf_key, char *value);
252
253 /**
254  * @internal
255  * @brief Set the system settings notification callback
256  * @since_tizen 2.3
257  * @param[in] vconf_key
258  * @param[in] key
259  * @param[in] slot internal slot to set the key (0~4)
260  * @param[in] user_data user data
261  * @return      0 on success, otherwise a negative error value
262  * @retval      #SYSTEM_SETTINGS_ERROR_NONE Successful
263  * @retval      #SYSTEM_SETTINGS_ERROR_IO_ERROR Internal I/O error
264  * @retval      #SYSTEM_SETTINGS_ERROR_PERMISSION_DENIED Permission violation error
265  */
266 int system_setting_vconf_set_changed_cb(const char *vconf_key, system_settings_key_e key, int slot, void *user_data);
267
268 /**
269  * @internal
270  * @brief Unset the system settings notification callback
271  * @since_tizen 2.3
272  * @param[in] vconf_key vconf key name used in the code
273  * @param[in] slot internal slot to set the key (0~4)
274  * @return      0 on success, otherwise a negative error value
275  * @retval      #SYSTEM_SETTINGS_ERROR_NONE Successful
276  * @retval      #SYSTEM_SETTINGS_ERROR_IO_ERROR Internal I/O error
277  * @retval      #SYSTEM_SETTINGS_ERROR_PERMISSION_DENIED Permission violation error
278  */
279 int system_setting_vconf_unset_changed_cb(const char *vconf_key, int slot);
280
281 /**
282  * @internal
283  * @brief get current font size
284  * @since_tizen 2.3
285  * @param[in] key key name should be SYSTEM_SETTINGS_KEY_FONT_SIZE
286  * @param[in] datatype should be SYSTEM_SETTING_DATA_TYPE_INT
287  * @return      0 on success, otherwise a negative error value
288  * @retval      #SYSTEM_SETTINGS_ERROR_NONE Successful
289  * @retval      #SYSTEM_SETTINGS_ERROR_IO_ERROR Internal I/O error
290  * @retval      #SYSTEM_SETTINGS_ERROR_PERMISSION_DENIED Permission violation error
291  */
292 int system_setting_get_font_size(system_settings_key_e key, system_setting_data_type_e data_type, void **value);
293
294 /**
295  * @internal
296  * @brief set current font size
297  * @since_tizen 2.3
298  * @param[in] key key name should be SYSTEM_SETTINGS_KEY_FONT_SIZE
299  * @param[in] datatype should be SYSTEM_SETTING_DATA_TYPE_INT
300  * @param[out] value the font size
301  * @return      0 on success, otherwise a negative error value
302  * @retval      #SYSTEM_SETTINGS_ERROR_NONE Successful
303  * @retval      #SYSTEM_SETTINGS_ERROR_IO_ERROR Internal I/O error
304  * @retval      #SYSTEM_SETTINGS_ERROR_PERMISSION_DENIED Permission violation error
305  */
306 int system_setting_set_font_size(system_settings_key_e key, system_setting_data_type_e data_type, void *value);
307
308 /**
309  * @internal
310  * @since_tizen 2.3
311  * @retval      #SYSTEM_SETTINGS_ERROR_PERMISSION_DENIED Permission violation error
312  */
313 int system_setting_set_changed_callback_font_size(system_settings_key_e key, system_settings_changed_cb callback, void *user_data);
314
315 /**
316  * @internal
317  * @since_tizen 2.3
318  * @retval      #SYSTEM_SETTINGS_ERROR_PERMISSION_DENIED Permission violation error
319  */
320 int system_setting_unset_changed_callback_font_size(system_settings_key_e key);
321
322
323
324 /**
325  * @internal
326  * @since_tizen 2.3
327  * @retval      #SYSTEM_SETTINGS_ERROR_PERMISSION_DENIED Permission violation error
328  */
329 int system_setting_get_incoming_call_ringtone(system_settings_key_e key, system_setting_data_type_e data_type, void **value);
330
331 /**
332  * @internal
333  * @brief set current path of the ringtone
334  * @since_tizen 2.3
335  * @param[in] key key name should be SYSTEM_SETTINGS_KEY_INCOMING_CALL_RINGTONE
336  * @param[in] datatype should be SYSTEM_SETTING_DATA_TYPE_STRING
337  * @param[out] value the ringtone
338  * @return      0 on success, otherwise a negative error value
339  * @retval      #SYSTEM_SETTINGS_ERROR_NONE Successful
340  * @retval      #SYSTEM_SETTINGS_ERROR_IO_ERROR Internal I/O error
341  * @retval      #SYSTEM_SETTINGS_ERROR_PERMISSION_DENIED Permission violation error
342  */
343 int system_setting_set_incoming_call_ringtone(system_settings_key_e key, system_setting_data_type_e data_type, void *value);
344
345
346 /**
347  * @todo add comment here
348  */
349 int system_setting_add_incoming_call_ringtone(system_settings_key_e key, system_setting_data_type_e data_type, void *value);
350
351
352 /**
353  * @todo add comment here
354  */
355 int system_setting_del_incoming_call_ringtone(system_settings_key_e key, system_setting_data_type_e data_type, void *value);
356
357
358 /**
359  * @todo add comment here
360  */
361 int system_setting_list_incoming_call_ringtone(system_settings_key_e key, system_setting_data_type_e data_type, system_settings_iter_cb callback, void *data);
362
363 /**
364  * @internal
365  * @since_tizen 2.3
366  * @retval      #SYSTEM_SETTINGS_ERROR_PERMISSION_DENIED Permission violation error
367  */
368 int system_setting_set_changed_callback_incoming_call_ringtone(system_settings_key_e key, system_settings_changed_cb callback, void *user_data);
369
370 /**
371  * @internal
372  * @since_tizen 2.3
373  * @retval      #SYSTEM_SETTINGS_ERROR_PERMISSION_DENIED Permission violation error
374  */
375 int system_setting_unset_changed_callback_incoming_call_ringtone(system_settings_key_e key);
376
377
378 /**
379  * @internal
380  * @since_tizen 2.3
381  * @retval      #SYSTEM_SETTINGS_ERROR_PERMISSION_DENIED Permission violation error
382  */
383 int system_setting_get_email_alert_ringtone(system_settings_key_e key, system_setting_data_type_e data_type, void **value);
384
385 /**
386  * @internal
387  * @brief set current path of the email-alert
388  * @since_tizen 2.3
389  * @param[in] key key name should be SYSTEM_SETTINGS_KEY_EMAIL_ALERT_RINGTONE
390  * @param[in] datatype should be SYSTEM_SETTING_DATA_TYPE_STRING
391  * @param[out] value the alert ringtone
392  * @return      0 on success, otherwise a negative error value
393  * @retval      #SYSTEM_SETTINGS_ERROR_NONE Successful
394  * @retval      #SYSTEM_SETTINGS_ERROR_IO_ERROR Internal I/O error
395  * @retval      #SYSTEM_SETTINGS_ERROR_PERMISSION_DENIED Permission violation error
396  */
397 int system_setting_set_email_alert_ringtone(system_settings_key_e key, system_setting_data_type_e data_type, void *value);
398
399 /**
400  * @internal
401  * @since_tizen 2.3
402  * @retval      #SYSTEM_SETTINGS_ERROR_PERMISSION_DENIED Permission violation error
403  */
404 int system_setting_set_changed_callback_email_alert_ringtone(system_settings_key_e key, system_settings_changed_cb callback, void *user_data);
405
406 /**
407  * @internal
408  * @since_tizen 2.3
409  * @retval      #SYSTEM_SETTINGS_ERROR_PERMISSION_DENIED Permission violation error
410  */
411 int system_setting_unset_changed_callback_email_alert_ringtone(system_settings_key_e key);
412
413
414
415 /**
416  * @internal
417  * @since_tizen 2.3
418  * @retval      #SYSTEM_SETTINGS_ERROR_PERMISSION_DENIED Permission violation error
419  */
420 int system_setting_get_wallpaper_home_screen(system_settings_key_e key, system_setting_data_type_e data_type, void **value);
421
422 /**
423  * @internal
424  * @brief set current path of the wallpaper
425  * @since_tizen 2.3
426  * @param[in] key key name should be SYSTEM_SETTINGS_KEY_WALLPAPER_HOME_SCREEN
427  * @param[in] datatype should be SYSTEM_SETTING_DATA_TYPE_STRING
428  * @param[out] value the wallpaper
429  * @return      0 on success, otherwise a negative error value
430  * @retval      #SYSTEM_SETTINGS_ERROR_NONE Successful
431  * @retval      #SYSTEM_SETTINGS_ERROR_IO_ERROR Internal I/O error
432  * @retval      #SYSTEM_SETTINGS_ERROR_PERMISSION_DENIED Permission violation error
433  */
434 int system_setting_set_wallpaper_home_screen(system_settings_key_e key, system_setting_data_type_e data_type, void *value);
435
436 /**
437  * @internal
438  * @since_tizen 2.3
439  * @retval      #SYSTEM_SETTINGS_ERROR_PERMISSION_DENIED Permission violation error
440  */
441 int system_setting_set_changed_callback_wallpaper_home_screen(system_settings_key_e key, system_settings_changed_cb callback, void *user_data);
442
443 /**
444  * @internal
445  * @since_tizen 2.3
446  * @retval      #SYSTEM_SETTINGS_ERROR_PERMISSION_DENIED Permission violation error
447  */
448 int system_setting_unset_changed_callback_wallpaper_home_screen(system_settings_key_e key);
449
450
451
452 /**
453  * @internal
454  * @since_tizen 2.3
455  * @retval      #SYSTEM_SETTINGS_ERROR_PERMISSION_DENIED Permission violation error
456  */
457 int system_setting_get_wallpaper_lock_screen(system_settings_key_e key, system_setting_data_type_e data_type, void **value);
458
459 /**
460  * @internal
461  * @brief set current path of the bg image of the lock screen
462  * @since_tizen 2.3
463  * @param[in] key key name should be SYSTEM_SETTINGS_KEY_WALLPAPER_LOCK_SCREEN
464  * @param[in] datatype should be SYSTEM_SETTING_DATA_TYPE_STRING
465  * @param[out] value the lock screen
466  * @return      0 on success, otherwise a negative error value
467  * @retval      #SYSTEM_SETTINGS_ERROR_NONE Successful
468  * @retval      #SYSTEM_SETTINGS_ERROR_IO_ERROR Internal I/O error
469  * @retval      #SYSTEM_SETTINGS_ERROR_PERMISSION_DENIED Permission violation error
470  */
471 int system_setting_set_wallpaper_lock_screen(system_settings_key_e key, system_setting_data_type_e data_type, void *value);
472
473 /**
474  * @internal
475  * @since_tizen 2.3
476  * @retval      #SYSTEM_SETTINGS_ERROR_PERMISSION_DENIED Permission violation error
477  */
478 int system_setting_set_changed_callback_wallpaper_lock_screen(system_settings_key_e key, system_settings_changed_cb callback, void *user_data);
479
480 /**
481  * @internal
482  * @since_tizen 2.3
483  * @retval      #SYSTEM_SETTINGS_ERROR_PERMISSION_DENIED Permission violation error
484  */
485 int system_setting_unset_changed_callback_wallpaper_lock_screen(system_settings_key_e key);
486
487
488 /**
489  * @internal
490  * @since_tizen 2.3
491  * @retval      #SYSTEM_SETTINGS_ERROR_PERMISSION_DENIED Permission violation error
492  */
493 int system_setting_get_default_font_type(system_settings_key_e key, system_setting_data_type_e data_type, void **value);
494
495
496 /**
497  * @internal
498  * @since_tizen 2.3
499  * @retval      #SYSTEM_SETTINGS_ERROR_PERMISSION_DENIED Permission violation error
500  */
501 int system_setting_get_font_type(system_settings_key_e key, system_setting_data_type_e data_type, void **value);
502
503 /**
504  * @internal
505  * @brief set name of the font name
506  * @since_tizen 2.3
507  * @param[in] key key name should be SYSTEM_SETTINGS_KEY_FONT_TYPE
508  * @param[in] datatype should be SYSTEM_SETTING_DATA_TYPE_STRING
509  * @param[out] value the font type
510  * @return      0 on success, otherwise a negative error value
511  * @retval      #SYSTEM_SETTINGS_ERROR_NONE Successful
512  * @retval      #SYSTEM_SETTINGS_ERROR_IO_ERROR Internal I/O error
513  * @retval      #SYSTEM_SETTINGS_ERROR_PERMISSION_DENIED Permission violation error
514  */
515 int system_setting_set_font_type(system_settings_key_e key, system_setting_data_type_e data_type, void *value);
516
517 /**
518  * @internal
519  * @since_tizen 2.3
520  * @retval      #SYSTEM_SETTINGS_ERROR_PERMISSION_DENIED Permission violation error
521  */
522 int system_setting_set_changed_callback_font_type(system_settings_key_e key, system_settings_changed_cb callback, void *user_data);
523
524 /**
525  * @internal
526  * @since_tizen 2.3
527  * @retval      #SYSTEM_SETTINGS_ERROR_PERMISSION_DENIED Permission violation error
528  */
529 int system_setting_unset_changed_callback_font_type(system_settings_key_e key);
530
531
532 /**
533  * @internal
534  * @since_tizen 2.3
535  * @retval      #SYSTEM_SETTINGS_ERROR_PERMISSION_DENIED Permission violation error
536  */
537 int system_setting_get_motion_activation(system_settings_key_e key, system_setting_data_type_e data_type, void **value);
538
539 /**
540  * @internal
541  * @brief set on/off of the motion activation
542  * @since_tizen 2.3
543  * @param[in] key key name should be SYSTEM_SETTINGS_KEY_MOTION_ACTIVATION
544  * @param[in] datatype should be SYSTEM_SETTING_DATA_TYPE_BOOL
545  * @param[out] value the motion activation
546  * @return      0 on success, otherwise a negative error value
547  * @retval      #SYSTEM_SETTINGS_ERROR_NONE Successful
548  * @retval      #SYSTEM_SETTINGS_ERROR_IO_ERROR Internal I/O error
549  * @retval      #SYSTEM_SETTINGS_ERROR_PERMISSION_DENIED Permission violation error
550  */
551 int system_setting_set_motion_activation(system_settings_key_e key, system_setting_data_type_e data_type, void *value);
552
553 /**
554  * @internal
555  * @since_tizen 2.3
556  * @retval      #SYSTEM_SETTINGS_ERROR_PERMISSION_DENIED Permission violation error
557  */
558 int system_setting_set_changed_callback_motion_activation(system_settings_key_e key, system_settings_changed_cb callback, void *user_data);
559
560 /**
561  * @internal
562  * @since_tizen 2.3
563  * @retval      #SYSTEM_SETTINGS_ERROR_PERMISSION_DENIED Permission violation error
564  */
565 int system_setting_unset_changed_callback_motion_activation(system_settings_key_e key);
566
567
568 /**
569  * @internal
570  * @since_tizen 2.3
571  * @retval      #SYSTEM_SETTINGS_ERROR_PERMISSION_DENIED Permission violation error
572  */
573 int system_setting_get_usb_debugging_option(system_settings_key_e key, system_setting_data_type_e data_type, void **value);
574
575 /**
576  * @internal
577  * @brief set on/off of the debugging options
578  * @since_tizen 2.3
579  * @param[in] key key name should be SYSTEM_SETTINGS_KEY_USB_DEBUGGING_ENABLED
580  * @param[in] datatype should be SYSTEM_SETTING_DATA_TYPE_BOOL
581  * @param[out] value the usb debug option
582  * @return      0 on success, otherwise a negative error value
583  * @retval      #SYSTEM_SETTINGS_ERROR_NONE Successful
584  * @retval      #SYSTEM_SETTINGS_ERROR_IO_ERROR Internal I/O error
585  * @retval      #SYSTEM_SETTINGS_ERROR_PERMISSION_DENIED Permission violation error
586  */
587 int system_setting_set_usb_debugging_option(system_settings_key_e key, system_setting_data_type_e data_type, void *value);
588
589 /**
590  * @internal
591  * @since_tizen 2.3
592  * @retval      #SYSTEM_SETTINGS_ERROR_PERMISSION_DENIED Permission violation error
593  */
594 int system_setting_set_changed_callback_usb_debugging_option(system_settings_key_e key, system_settings_changed_cb callback, void *user_data);
595
596 /**
597  * @internal
598  * @since_tizen 2.3
599  * @retval      #SYSTEM_SETTINGS_ERROR_PERMISSION_DENIED Permission violation error
600  */
601 int system_setting_unset_changed_callback_usb_debugging_option(system_settings_key_e key);
602
603
604 /**
605  * @internal
606  * @since_tizen 2.3
607  * @retval      #SYSTEM_SETTINGS_ERROR_PERMISSION_DENIED Permission violation error
608  */
609 int system_setting_get_3g_data_network(system_settings_key_e key, system_setting_data_type_e data_type, void **value);
610
611 /**
612  * @internal
613  * @brief set on/off of the 3G data network option
614  * @since_tizen 2.3
615  * @param[in] key key name should be SYSTEM_SETTINGS_KEY_3G_DATA_NETWORK_ENABLED
616  * @param[in] datatype should be SYSTEM_SETTING_DATA_TYPE_BOOL
617  * @param[out] value the 3G data network option
618  * @return      0 on success, otherwise a negative error value
619  * @retval      #SYSTEM_SETTINGS_ERROR_NONE Successful
620  * @retval      #SYSTEM_SETTINGS_ERROR_IO_ERROR Internal I/O error
621  * @retval      #SYSTEM_SETTINGS_ERROR_PERMISSION_DENIED Permission violation error
622  */
623 int system_setting_set_3g_data_network(system_settings_key_e key, system_setting_data_type_e data_type, void *value);
624
625 /**
626  * @internal
627  * @since_tizen 2.3
628  * @return      0 on success, otherwise a negative error value
629  * @retval      #SYSTEM_SETTINGS_ERROR_NONE Successful
630  * @retval      #SYSTEM_SETTINGS_ERROR_IO_ERROR Internal I/O error
631  * @retval      #SYSTEM_SETTINGS_ERROR_PERMISSION_DENIED Permission violation error
632  */
633 int system_setting_set_changed_callback_3g_data_network(system_settings_key_e key, system_settings_changed_cb callback, void *user_data);
634
635 /**
636  * @internal
637  * @since_tizen 2.3
638  * @return      0 on success, otherwise a negative error value
639  * @retval      #SYSTEM_SETTINGS_ERROR_NONE Successful
640  * @retval      #SYSTEM_SETTINGS_ERROR_IO_ERROR Internal I/O error
641  * @retval      #SYSTEM_SETTINGS_ERROR_PERMISSION_DENIED Permission violation error
642  */
643 int system_setting_unset_changed_callback_3g_data_network(system_settings_key_e key);
644
645 /**
646  * @internal
647  * @since_tizen 2.3
648  * @return      0 on success, otherwise a negative error value
649  * @retval      #SYSTEM_SETTINGS_ERROR_NONE Successful
650  * @retval      #SYSTEM_SETTINGS_ERROR_IO_ERROR Internal I/O error
651  * @retval      #SYSTEM_SETTINGS_ERROR_PERMISSION_DENIED Permission violation error
652  */
653 int system_setting_get_tap_and_hold_delay(system_settings_key_e key, system_setting_data_type_e data_type, void **value);
654
655 /**
656  * @internal
657  * @since_tizen 2.3
658  * @return      0 on success, otherwise a negative error value
659  * @retval      #SYSTEM_SETTINGS_ERROR_NONE Successful
660  * @retval      #SYSTEM_SETTINGS_ERROR_IO_ERROR Internal I/O error
661  * @retval      #SYSTEM_SETTINGS_ERROR_PERMISSION_DENIED Permission violation error
662  */
663 int system_setting_set_tap_and_hold_delay(system_settings_key_e key, system_setting_data_type_e data_type, void *value);
664
665 /**
666  * @internal
667  * @since_tizen 2.3
668  * @return      0 on success, otherwise a negative error value
669  * @retval      #SYSTEM_SETTINGS_ERROR_NONE Successful
670  * @retval      #SYSTEM_SETTINGS_ERROR_IO_ERROR Internal I/O error
671  * @retval      #SYSTEM_SETTINGS_ERROR_PERMISSION_DENIED Permission violation error
672  */
673 int system_setting_set_changed_callback_tap_and_hold_delay(system_settings_key_e key, system_settings_changed_cb callback, void *user_data);
674
675 /**
676  * @internal
677  * @since_tizen 2.3
678  * @return      0 on success, otherwise a negative error value
679  * @retval      #SYSTEM_SETTINGS_ERROR_NONE Successful
680  * @retval      #SYSTEM_SETTINGS_ERROR_IO_ERROR Internal I/O error
681  * @retval      #SYSTEM_SETTINGS_ERROR_PERMISSION_DENIED Permission violation error
682  */
683 int system_setting_unset_changed_callback_tap_and_hold_delay(system_settings_key_e key);
684
685 /**
686  * @internal
687  * @since_tizen 2.3
688  * @return      0 on success, otherwise a negative error value
689  * @retval      #SYSTEM_SETTINGS_ERROR_NONE Successful
690  * @retval      #SYSTEM_SETTINGS_ERROR_IO_ERROR Internal I/O error
691  * @retval      #SYSTEM_SETTINGS_ERROR_PERMISSION_DENIED Permission violation error
692  */
693 int system_setting_get_lockscreen_app(system_settings_key_e key, system_setting_data_type_e data_type, void **value);
694
695 /**
696  * @internal
697  * @since_tizen 2.3
698  * @return      0 on success, otherwise a negative error value
699  * @retval      #SYSTEM_SETTINGS_ERROR_NONE Successful
700  * @retval      #SYSTEM_SETTINGS_ERROR_IO_ERROR Internal I/O error
701  * @retval      #SYSTEM_SETTINGS_ERROR_PERMISSION_DENIED Permission violation error
702  */
703 int system_setting_set_lockscreen_app(system_settings_key_e key, system_setting_data_type_e data_type, void *value);
704
705 /**
706  * @internal
707  * @since_tizen 2.3
708  * @return      0 on success, otherwise a negative error value
709  * @retval      #SYSTEM_SETTINGS_ERROR_NONE Successful
710  * @retval      #SYSTEM_SETTINGS_ERROR_IO_ERROR Internal I/O error
711  * @retval      #SYSTEM_SETTINGS_ERROR_PERMISSION_DENIED Permission violation error
712  */
713 int system_setting_set_changed_callback_lockscreen_app(system_settings_key_e key, system_settings_changed_cb callback, void *user_data);
714
715 /**
716  * @internal
717  * @since_tizen 2.3
718  * @return      0 on success, otherwise a negative error value
719  * @retval      #SYSTEM_SETTINGS_ERROR_NONE Successful
720  * @retval      #SYSTEM_SETTINGS_ERROR_IO_ERROR Internal I/O error
721  * @retval      #SYSTEM_SETTINGS_ERROR_PERMISSION_DENIED Permission violation error
722  */
723 int system_setting_unset_changed_callback_lockscreen_app(system_settings_key_e key);
724
725 /**
726  * @internal
727  * @since_tizen 2.3
728  * @return      0 on success, otherwise a negative error value
729  * @retval      #SYSTEM_SETTINGS_ERROR_NONE Successful
730  * @retval      #SYSTEM_SETTINGS_ERROR_IO_ERROR Internal I/O error
731  * @retval      #SYSTEM_SETTINGS_ERROR_PERMISSION_DENIED Permission violation error
732  */
733 int system_setting_get_locale_country(system_settings_key_e key, system_setting_data_type_e data_type, void **value);
734 /**
735  * @internal
736  * @since_tizen 2.3
737  * @return      0 on success, otherwise a negative error value
738  * @retval      #SYSTEM_SETTINGS_ERROR_NONE Successful
739  * @retval      #SYSTEM_SETTINGS_ERROR_IO_ERROR Internal I/O error
740  * @retval      #SYSTEM_SETTINGS_ERROR_PERMISSION_DENIED Permission violation error
741  */
742 int system_setting_set_locale_country(system_settings_key_e key, system_setting_data_type_e data_type, void *value);
743 /**
744  * @internal
745  * @since_tizen 2.3
746  * @return      0 on success, otherwise a negative error value
747  * @retval      #SYSTEM_SETTINGS_ERROR_NONE Successful
748  * @retval      #SYSTEM_SETTINGS_ERROR_IO_ERROR Internal I/O error
749  * @retval      #SYSTEM_SETTINGS_ERROR_PERMISSION_DENIED Permission violation error
750  */
751 int system_setting_set_changed_callback_locale_country(system_settings_key_e key, system_settings_changed_cb callback, void *user_data);
752 /**
753  * @internal
754  * @since_tizen 2.3
755  * @return      0 on success, otherwise a negative error value
756  * @retval      #SYSTEM_SETTINGS_ERROR_NONE Successful
757  * @retval      #SYSTEM_SETTINGS_ERROR_IO_ERROR Internal I/O error
758  * @retval      #SYSTEM_SETTINGS_ERROR_PERMISSION_DENIED Permission violation error
759  */
760 int system_setting_unset_changed_callback_locale_country(system_settings_key_e key);
761
762 /**
763  * @internal
764  * @since_tizen 2.3
765  * @return      0 on success, otherwise a negative error value
766  * @retval      #SYSTEM_SETTINGS_ERROR_NONE Successful
767  * @retval      #SYSTEM_SETTINGS_ERROR_IO_ERROR Internal I/O error
768  * @retval      #SYSTEM_SETTINGS_ERROR_PERMISSION_DENIED Permission violation error
769  */
770 int system_setting_get_locale_language(system_settings_key_e key, system_setting_data_type_e data_type, void **value);
771 /**
772  * @internal
773  * @since_tizen 2.3
774  * @return      0 on success, otherwise a negative error value
775  * @retval      #SYSTEM_SETTINGS_ERROR_NONE Successful
776  * @retval      #SYSTEM_SETTINGS_ERROR_IO_ERROR Internal I/O error
777  * @retval      #SYSTEM_SETTINGS_ERROR_PERMISSION_DENIED Permission violation error
778  */
779 int system_setting_set_locale_language(system_settings_key_e key, system_setting_data_type_e data_type, void *value);
780 /**
781  * @internal
782  * @since_tizen 2.3
783  * @return      0 on success, otherwise a negative error value
784  * @retval      #SYSTEM_SETTINGS_ERROR_NONE Successful
785  * @retval      #SYSTEM_SETTINGS_ERROR_IO_ERROR Internal I/O error
786  * @retval      #SYSTEM_SETTINGS_ERROR_PERMISSION_DENIED Permission violation error
787  */
788 int system_setting_set_changed_callback_locale_language(system_settings_key_e key, system_settings_changed_cb callback, void *user_data);
789 /**
790  * @internal
791  * @since_tizen 2.3
792  * @return      0 on success, otherwise a negative error value
793  * @retval      #SYSTEM_SETTINGS_ERROR_NONE Successful
794  * @retval      #SYSTEM_SETTINGS_ERROR_IO_ERROR Internal I/O error
795  * @retval      #SYSTEM_SETTINGS_ERROR_PERMISSION_DENIED Permission violation error
796  */
797 int system_setting_unset_changed_callback_locale_language(system_settings_key_e key);
798
799 /**
800  * @internal
801  * @since_tizen 2.3
802  * @return      0 on success, otherwise a negative error value
803  * @retval      #SYSTEM_SETTINGS_ERROR_NONE Successful
804  * @retval      #SYSTEM_SETTINGS_ERROR_IO_ERROR Internal I/O error
805  * @retval      #SYSTEM_SETTINGS_ERROR_PERMISSION_DENIED Permission violation error
806  */
807 int system_setting_get_locale_timeformat_24hour(system_settings_key_e key, system_setting_data_type_e data_type, void **value);
808 /**
809  * @internal
810  * @since_tizen 2.3
811  * @return      0 on success, otherwise a negative error value
812  * @retval      #SYSTEM_SETTINGS_ERROR_NONE Successful
813  * @retval      #SYSTEM_SETTINGS_ERROR_IO_ERROR Internal I/O error
814  * @retval      #SYSTEM_SETTINGS_ERROR_PERMISSION_DENIED Permission violation error
815  */
816 int system_setting_set_locale_timeformat_24hour(system_settings_key_e key, system_setting_data_type_e data_type, void *value);
817 /**
818  * @internal
819  * @since_tizen 2.3
820  * @return      0 on success, otherwise a negative error value
821  * @retval      #SYSTEM_SETTINGS_ERROR_NONE Successful
822  * @retval      #SYSTEM_SETTINGS_ERROR_IO_ERROR Internal I/O error
823  * @retval      #SYSTEM_SETTINGS_ERROR_PERMISSION_DENIED Permission violation error
824  */
825 int system_setting_set_changed_callback_locale_timeformat_24hour(system_settings_key_e key, system_settings_changed_cb callback, void *user_data);
826 /**
827  * @internal
828  * @since_tizen 2.3
829  * @return      0 on success, otherwise a negative error value
830  * @retval      #SYSTEM_SETTINGS_ERROR_NONE Successful
831  * @retval      #SYSTEM_SETTINGS_ERROR_IO_ERROR Internal I/O error
832  * @retval      #SYSTEM_SETTINGS_ERROR_PERMISSION_DENIED Permission violation error
833  */
834 int system_setting_unset_changed_callback_locale_timeformat_24hour(system_settings_key_e key);
835
836 /**
837  * @internal
838  * @since_tizen 2.3
839  * @return      0 on success, otherwise a negative error value
840  * @retval      #SYSTEM_SETTINGS_ERROR_NONE Successful
841  * @retval      #SYSTEM_SETTINGS_ERROR_IO_ERROR Internal I/O error
842  * @retval      #SYSTEM_SETTINGS_ERROR_PERMISSION_DENIED Permission violation error
843  */
844 int system_setting_get_locale_timezone(system_settings_key_e key, system_setting_data_type_e data_type, void **value);
845
846 /**
847  * @internal
848  * @since_tizen 3.0
849  * @return      0 on success, otherwise a negative error value
850  * @retval      #SYSTEM_SETTINGS_ERROR_NONE Successful
851  * @retval      #SYSTEM_SETTINGS_ERROR_IO_ERROR Internal I/O error
852  * @retval      #SYSTEM_SETTINGS_ERROR_PERMISSION_DENIED Permission violation error
853  */
854 int system_setting_set_locale_timezone(system_settings_key_e key, system_setting_data_type_e data_type, void *value);
855
856 /**
857  * @internal
858  * @since_tizen 3.0
859  * @return      0 on success, otherwise a negative error value
860  * @retval      #SYSTEM_SETTINGS_ERROR_NONE Successful
861  * @retval      #SYSTEM_SETTINGS_ERROR_IO_ERROR Internal I/O error
862  * @retval      #SYSTEM_SETTINGS_ERROR_PERMISSION_DENIED Permission violation error
863  */
864 int system_setting_set_changed_callback_locale_timezone(system_settings_key_e key, system_settings_changed_cb callback, void *user_data);
865
866 /**
867  * @internal
868  * @since_tizen 3.0
869  * @return      0 on success, otherwise a negative error value
870  * @retval      #SYSTEM_SETTINGS_ERROR_NONE Successful
871  * @retval      #SYSTEM_SETTINGS_ERROR_IO_ERROR Internal I/O error
872  * @retval      #SYSTEM_SETTINGS_ERROR_PERMISSION_DENIED Permission violation error
873  */
874 int system_setting_unset_changed_callback_locale_timezone(system_settings_key_e key);
875
876
877
878 /**
879  * @internal
880  * @since_tizen 2.3
881  * @return      0 on success, otherwise a negative error value
882  * @retval      #SYSTEM_SETTINGS_ERROR_NONE Successful
883  * @retval      #SYSTEM_SETTINGS_ERROR_IO_ERROR Internal I/O error
884  * @retval      #SYSTEM_SETTINGS_ERROR_PERMISSION_DENIED Permission violation error
885  */
886 int system_setting_set_changed_callback_locale_timezone_changed(system_settings_key_e key, system_settings_changed_cb callback, void *user_data);
887 /**
888  * @internal
889  * @since_tizen 2.3
890  * @return      0 on success, otherwise a negative error value
891  * @retval      #SYSTEM_SETTINGS_ERROR_NONE Successful
892  * @retval      #SYSTEM_SETTINGS_ERROR_IO_ERROR Internal I/O error
893  * @retval      #SYSTEM_SETTINGS_ERROR_PERMISSION_DENIED Permission violation error
894  */
895 int system_setting_unset_changed_callback_locale_timezone_changed(system_settings_key_e key);
896
897 /**
898  * @internal
899  * @since_tizen 2.3
900  * @return      0 on success, otherwise a negative error value
901  * @retval      #SYSTEM_SETTINGS_ERROR_NONE Successful
902  * @retval      #SYSTEM_SETTINGS_ERROR_IO_ERROR Internal I/O error
903  * @retval      #SYSTEM_SETTINGS_ERROR_PERMISSION_DENIED Permission violation error
904  */
905 int system_setting_get_time_changed(system_settings_key_e key, system_setting_data_type_e data_type, void **value);
906 /**
907  * @internal
908  * @since_tizen 2.3
909  * @return      0 on success, otherwise a negative error value
910  * @retval      #SYSTEM_SETTINGS_ERROR_NONE Successful
911  * @retval      #SYSTEM_SETTINGS_ERROR_IO_ERROR Internal I/O error
912  * @retval      #SYSTEM_SETTINGS_ERROR_PERMISSION_DENIED Permission violation error
913  */
914 int system_setting_set_changed_callback_time_changed(system_settings_key_e key, system_settings_changed_cb callback, void *user_data);
915 /**
916  * @internal
917  * @since_tizen 2.3
918  * @return      0 on success, otherwise a negative error value
919  * @retval      #SYSTEM_SETTINGS_ERROR_NONE Successful
920  * @retval      #SYSTEM_SETTINGS_ERROR_IO_ERROR Internal I/O error
921  * @retval      #SYSTEM_SETTINGS_ERROR_PERMISSION_DENIED Permission violation error
922  */
923 int system_setting_unset_changed_callback_time_changed(system_settings_key_e key);
924
925
926 /**
927  * @internal
928  * @since_tizen 2.3
929  * @return      0 on success, otherwise a negative error value
930  * @retval      #SYSTEM_SETTINGS_ERROR_NONE Successful
931  * @retval      #SYSTEM_SETTINGS_ERROR_IO_ERROR Internal I/O error
932  * @retval      #SYSTEM_SETTINGS_ERROR_PERMISSION_DENIED Permission violation error
933  */
934 int system_setting_get_sound_lock(system_settings_key_e key, system_setting_data_type_e data_type, void **value);
935 /**
936  * @internal
937  * @since_tizen 2.3
938  * @return      0 on success, otherwise a negative error value
939  * @retval      #SYSTEM_SETTINGS_ERROR_NONE Successful
940  * @retval      #SYSTEM_SETTINGS_ERROR_IO_ERROR Internal I/O error
941  * @retval      #SYSTEM_SETTINGS_ERROR_PERMISSION_DENIED Permission violation error
942  */
943 int system_setting_set_changed_callback_sound_lock(system_settings_key_e key, system_settings_changed_cb callback, void *user_data);
944 /**
945  * @internal
946  * @since_tizen 2.3
947  * @return      0 on success, otherwise a negative error value
948  * @retval      #SYSTEM_SETTINGS_ERROR_NONE Successful
949  * @retval      #SYSTEM_SETTINGS_ERROR_IO_ERROR Internal I/O error
950  * @retval      #SYSTEM_SETTINGS_ERROR_PERMISSION_DENIED Permission violation error
951  */
952 int system_setting_unset_changed_callback_sound_lock(system_settings_key_e key);
953
954 /**
955  * @internal
956  * @since_tizen 2.3
957  * @return      0 on success, otherwise a negative error value
958  * @retval      #SYSTEM_SETTINGS_ERROR_NONE Successful
959  * @retval      #SYSTEM_SETTINGS_ERROR_IO_ERROR Internal I/O error
960  * @retval      #SYSTEM_SETTINGS_ERROR_PERMISSION_DENIED Permission violation error
961  */
962 int system_setting_get_sound_silent_mode(system_settings_key_e key, system_setting_data_type_e data_type, void **value);
963
964 /**
965  * @internal
966  * @since_tizen 2.3
967  * @return      0 on success, otherwise a negative error value
968  * @retval      #SYSTEM_SETTINGS_ERROR_NONE Successful
969  * @retval      #SYSTEM_SETTINGS_ERROR_IO_ERROR Internal I/O error
970  * @retval      #SYSTEM_SETTINGS_ERROR_PERMISSION_DENIED Permission violation error
971  */
972 int system_setting_set_sound_silent_mode(system_settings_key_e key, system_setting_data_type_e data_type, void *value);
973
974 /**
975  * @internal
976  * @since_tizen 2.3
977  * @return      0 on success, otherwise a negative error value
978  * @retval      #SYSTEM_SETTINGS_ERROR_NONE Successful
979  * @retval      #SYSTEM_SETTINGS_ERROR_IO_ERROR Internal I/O error
980  * @retval      #SYSTEM_SETTINGS_ERROR_PERMISSION_DENIED Permission violation error
981  */
982 int system_setting_set_changed_callback_sound_silent_mode(system_settings_key_e key, system_settings_changed_cb callback, void *user_data);
983 /**
984  * @internal
985  * @since_tizen 2.3
986  * @return      0 on success, otherwise a negative error value
987  * @retval      #SYSTEM_SETTINGS_ERROR_NONE Successful
988  * @retval      #SYSTEM_SETTINGS_ERROR_IO_ERROR Internal I/O error
989  * @retval      #SYSTEM_SETTINGS_ERROR_PERMISSION_DENIED Permission violation error
990  */
991 int system_setting_unset_changed_callback_sound_silent_mode(system_settings_key_e key);
992
993 /**
994  * @internal
995  * @since_tizen 2.3
996  * @return      0 on success, otherwise a negative error value
997  * @retval      #SYSTEM_SETTINGS_ERROR_NONE Successful
998  * @retval      #SYSTEM_SETTINGS_ERROR_IO_ERROR Internal I/O error
999  * @retval      #SYSTEM_SETTINGS_ERROR_PERMISSION_DENIED Permission violation error
1000  */
1001 int system_setting_get_sound_touch(system_settings_key_e key, system_setting_data_type_e data_type, void **value);
1002 /**
1003  * @internal
1004  * @since_tizen 2.3
1005  * @return      0 on success, otherwise a negative error value
1006  * @retval      #SYSTEM_SETTINGS_ERROR_NONE Successful
1007  * @retval      #SYSTEM_SETTINGS_ERROR_IO_ERROR Internal I/O error
1008  * @retval      #SYSTEM_SETTINGS_ERROR_PERMISSION_DENIED Permission violation error
1009  */
1010 int system_setting_set_changed_callback_sound_touch(system_settings_key_e key, system_settings_changed_cb callback, void *user_data);
1011 /**
1012  * @internal
1013  * @since_tizen 2.3
1014  * @return      0 on success, otherwise a negative error value
1015  * @retval      #SYSTEM_SETTINGS_ERROR_NONE Successful
1016  * @retval      #SYSTEM_SETTINGS_ERROR_IO_ERROR Internal I/O error
1017  * @retval      #SYSTEM_SETTINGS_ERROR_PERMISSION_DENIED Permission violation error
1018  */
1019 int system_setting_unset_changed_callback_sound_touch(system_settings_key_e key);
1020
1021 /**
1022  * @internal
1023  * @since_tizen 2.3
1024  * @return      0 on success, otherwise a negative error value
1025  * @retval      #SYSTEM_SETTINGS_ERROR_NONE Successful
1026  * @retval      #SYSTEM_SETTINGS_ERROR_IO_ERROR Internal I/O error
1027  * @retval      #SYSTEM_SETTINGS_ERROR_PERMISSION_DENIED Permission violation error
1028  */
1029 int system_setting_get_auto_rotation_mode(system_settings_key_e key, system_setting_data_type_e data_type, void **value);
1030 /**
1031  * @internal
1032  * @since_tizen 2.3
1033  * @return      0 on success, otherwise a negative error value
1034  * @retval      #SYSTEM_SETTINGS_ERROR_NONE Successful
1035  * @retval      #SYSTEM_SETTINGS_ERROR_IO_ERROR Internal I/O error
1036  * @retval      #SYSTEM_SETTINGS_ERROR_PERMISSION_DENIED Permission violation error
1037  */
1038 int system_setting_set_auto_rotation_mode(system_settings_key_e key, system_setting_data_type_e data_type, void *value);
1039 /**
1040  * @internal
1041  * @since_tizen 2.3
1042  * @return      0 on success, otherwise a negative error value
1043  * @retval      #SYSTEM_SETTINGS_ERROR_NONE Successful
1044  * @retval      #SYSTEM_SETTINGS_ERROR_IO_ERROR Internal I/O error
1045  * @retval      #SYSTEM_SETTINGS_ERROR_PERMISSION_DENIED Permission violation error
1046  */
1047 int system_setting_set_changed_callback_auto_rotation_mode(system_settings_key_e key, system_settings_changed_cb callback, void *user_data);
1048 /**
1049  * @internal
1050  * @since_tizen 2.3
1051  * @return      0 on success, otherwise a negative error value
1052  * @retval      #SYSTEM_SETTINGS_ERROR_NONE Successful
1053  * @retval      #SYSTEM_SETTINGS_ERROR_IO_ERROR Internal I/O error
1054  * @retval      #SYSTEM_SETTINGS_ERROR_PERMISSION_DENIED Permission violation error
1055  */
1056 int system_setting_unset_changed_callback_auto_rotation_mode(system_settings_key_e key);
1057
1058 /**
1059  * @internal
1060  * @since_tizen 2.3
1061  * @return      0 on success, otherwise a negative error value
1062  * @retval      #SYSTEM_SETTINGS_ERROR_NONE Successful
1063  * @retval      #SYSTEM_SETTINGS_ERROR_IO_ERROR Internal I/O error
1064  * @retval      #SYSTEM_SETTINGS_ERROR_PERMISSION_DENIED Permission violation error
1065  */
1066 int system_setting_get_screen_backlight_time(system_settings_key_e key, system_setting_data_type_e data_type, void **value);
1067 /**
1068  * @internal
1069  * @since_tizen 2.3
1070  * @return      0 on success, otherwise a negative error value
1071  * @retval      #SYSTEM_SETTINGS_ERROR_NONE Successful
1072  * @retval      #SYSTEM_SETTINGS_ERROR_IO_ERROR Internal I/O error
1073  * @retval      #SYSTEM_SETTINGS_ERROR_PERMISSION_DENIED Permission violation error
1074  */
1075 int system_setting_set_screen_backlight_time(system_settings_key_e key, system_setting_data_type_e data_type, void *value);
1076 /**
1077  * @internal
1078  * @since_tizen 2.3
1079  * @return      0 on success, otherwise a negative error value
1080  * @retval      #SYSTEM_SETTINGS_ERROR_NONE Successful
1081  * @retval      #SYSTEM_SETTINGS_ERROR_IO_ERROR Internal I/O error
1082  * @retval      #SYSTEM_SETTINGS_ERROR_PERMISSION_DENIED Permission violation error
1083  */
1084 int system_setting_set_changed_callback_screen_backlight_time(system_settings_key_e key, system_settings_changed_cb callback, void *user_data);
1085 /**
1086  * @internal
1087  * @since_tizen 2.3
1088  * @return      0 on success, otherwise a negative error value
1089  * @retval      #SYSTEM_SETTINGS_ERROR_NONE Successful
1090  * @retval      #SYSTEM_SETTINGS_ERROR_IO_ERROR Internal I/O error
1091  * @retval      #SYSTEM_SETTINGS_ERROR_PERMISSION_DENIED Permission violation error
1092  */
1093 int system_setting_unset_changed_callback_screen_backlight_time(system_settings_key_e key);
1094
1095 /**
1096  * @internal
1097  * @since_tizen 2.3
1098  * @return      0 on success, otherwise a negative error value
1099  * @retval      #SYSTEM_SETTINGS_ERROR_NONE Successful
1100  * @retval      #SYSTEM_SETTINGS_ERROR_IO_ERROR Internal I/O error
1101  * @retval      #SYSTEM_SETTINGS_ERROR_PERMISSION_DENIED Permission violation error
1102  */
1103 int system_setting_get_sound_notification(system_settings_key_e key, system_setting_data_type_e data_type, void **value);
1104 /**
1105  * @internal
1106  * @since_tizen 2.3
1107  * @return      0 on success, otherwise a negative error value
1108  * @retval      #SYSTEM_SETTINGS_ERROR_NONE Successful
1109  * @retval      #SYSTEM_SETTINGS_ERROR_IO_ERROR Internal I/O error
1110  * @retval      #SYSTEM_SETTINGS_ERROR_PERMISSION_DENIED Permission violation error
1111  */
1112 int system_setting_set_sound_notification(system_settings_key_e key, system_setting_data_type_e data_type, void *value);
1113 /**
1114  * @internal
1115  * @since_tizen 2.3
1116  * @return      0 on success, otherwise a negative error value
1117  * @retval      #SYSTEM_SETTINGS_ERROR_NONE Successful
1118  * @retval      #SYSTEM_SETTINGS_ERROR_IO_ERROR Internal I/O error
1119  * @retval      #SYSTEM_SETTINGS_ERROR_PERMISSION_DENIED Permission violation error
1120  */
1121 int system_setting_set_changed_callback_sound_notification(system_settings_key_e key, system_settings_changed_cb callback, void *user_data);
1122 /**
1123  * @internal
1124  * @since_tizen 2.3
1125  * @return      0 on success, otherwise a negative error value
1126  * @retval      #SYSTEM_SETTINGS_ERROR_NONE Successful
1127  * @retval      #SYSTEM_SETTINGS_ERROR_IO_ERROR Internal I/O error
1128  * @retval      #SYSTEM_SETTINGS_ERROR_PERMISSION_DENIED Permission violation error
1129  */
1130 int system_setting_unset_changed_callback_sound_notification(system_settings_key_e key);
1131
1132 /**
1133  * @internal
1134  * @since_tizen 2.3
1135  * @return      0 on success, otherwise a negative error value
1136  * @retval      #SYSTEM_SETTINGS_ERROR_NONE Successful
1137  * @retval      #SYSTEM_SETTINGS_ERROR_IO_ERROR Internal I/O error
1138  * @retval      #SYSTEM_SETTINGS_ERROR_PERMISSION_DENIED Permission violation error
1139  */
1140 int system_setting_get_notification_repetition_period(system_settings_key_e key, system_setting_data_type_e data_type, void **value);
1141 /**
1142  * @internal
1143  * @since_tizen 2.3
1144  * @return      0 on success, otherwise a negative error value
1145  * @retval      #SYSTEM_SETTINGS_ERROR_NONE Successful
1146  * @retval      #SYSTEM_SETTINGS_ERROR_IO_ERROR Internal I/O error
1147  * @retval      #SYSTEM_SETTINGS_ERROR_PERMISSION_DENIED Permission violation error
1148  */
1149 int system_setting_set_notification_repetition_period(system_settings_key_e key, system_setting_data_type_e data_type, void *value);
1150 /**
1151  * @internal
1152  * @since_tizen 2.3
1153  * @return      0 on success, otherwise a negative error value
1154  * @retval      #SYSTEM_SETTINGS_ERROR_NONE Successful
1155  * @retval      #SYSTEM_SETTINGS_ERROR_IO_ERROR Internal I/O error
1156  * @retval      #SYSTEM_SETTINGS_ERROR_PERMISSION_DENIED Permission violation error
1157  */
1158 int system_setting_set_changed_callback_notification_repetition_period(system_settings_key_e key, system_settings_changed_cb callback, void *user_data);
1159 /**
1160  * @internal
1161  * @since_tizen 2.3
1162  * @return      0 on success, otherwise a negative error value
1163  * @retval      #SYSTEM_SETTINGS_ERROR_NONE Successful
1164  * @retval      #SYSTEM_SETTINGS_ERROR_IO_ERROR Internal I/O error
1165  * @retval      #SYSTEM_SETTINGS_ERROR_PERMISSION_DENIED Permission violation error
1166  */
1167 int system_setting_unset_changed_callback_notification_repetition_period(system_settings_key_e key);
1168
1169 /**
1170  * @internal
1171  * @since_tizen 2.3
1172  * @return      0 on success, otherwise a negative error value
1173  * @retval      #SYSTEM_SETTINGS_ERROR_NONE Successful
1174  * @retval      #SYSTEM_SETTINGS_ERROR_IO_ERROR Internal I/O error
1175  * @retval      #SYSTEM_SETTINGS_ERROR_PERMISSION_DENIED Permission violation error
1176  */
1177 int system_setting_get_device_name(system_settings_key_e key, system_setting_data_type_e data_type, void **value);
1178 /**
1179  * @internal
1180  * @since_tizen 2.3
1181  * @return      0 on success, otherwise a negative error value
1182  * @retval      #SYSTEM_SETTINGS_ERROR_NONE Successful
1183  * @retval      #SYSTEM_SETTINGS_ERROR_IO_ERROR Internal I/O error
1184  * @retval      #SYSTEM_SETTINGS_ERROR_PERMISSION_DENIED Permission violation error
1185  */
1186 int system_setting_set_changed_callback_device_name(system_settings_key_e key, system_settings_changed_cb callback, void *user_data);
1187
1188 /**
1189  * @internal
1190  * @since_tizen 2.3
1191  * @return      0 on success, otherwise a negative error value
1192  * @retval      #SYSTEM_SETTINGS_ERROR_NONE Successful
1193  * @retval      #SYSTEM_SETTINGS_ERROR_IO_ERROR Internal I/O error
1194  * @retval      #SYSTEM_SETTINGS_ERROR_PERMISSION_DENIED Permission violation error
1195  */
1196 int system_setting_unset_changed_callback_device_name(system_settings_key_e key);
1197
1198 /**
1199  * @internal
1200  * @since_tizen 2.3
1201  * @return      0 on success, otherwise a negative error value
1202  * @retval      #SYSTEM_SETTINGS_ERROR_NONE Successful
1203  * @retval      #SYSTEM_SETTINGS_ERROR_IO_ERROR Internal I/O error
1204  * @retval      #SYSTEM_SETTINGS_ERROR_PERMISSION_DENIED Permission violation error
1205  */
1206 int system_setting_get_network_flight_mode(system_settings_key_e key, system_setting_data_type_e data_type, void **value);
1207
1208 /**
1209  * @internal
1210  * @since_tizen 2.3
1211  * @return      0 on success, otherwise a negative error value
1212  * @retval      #SYSTEM_SETTINGS_ERROR_NONE Successful
1213  * @retval      #SYSTEM_SETTINGS_ERROR_IO_ERROR Internal I/O error
1214  * @retval      #SYSTEM_SETTINGS_ERROR_PERMISSION_DENIED Permission violation error
1215  */
1216 int system_setting_set_changed_callback_network_flight_mode(system_settings_key_e key, system_settings_changed_cb callback, void *user_data);
1217
1218 /**
1219  * @internal
1220  * @since_tizen 2.3
1221  * @return      0 on success, otherwise a negative error value
1222  * @retval      #SYSTEM_SETTINGS_ERROR_NONE Successful
1223  * @retval      #SYSTEM_SETTINGS_ERROR_IO_ERROR Internal I/O error
1224  * @retval      #SYSTEM_SETTINGS_ERROR_PERMISSION_DENIED Permission violation error
1225  */
1226 int system_setting_unset_changed_callback_network_flight_mode(system_settings_key_e key);
1227
1228
1229
1230 /**
1231  * @internal
1232  * @since_tizen 2.3
1233  * @return      0 on success, otherwise a negative error value
1234  * @retval      #SYSTEM_SETTINGS_ERROR_NONE Successful
1235  * @retval      #SYSTEM_SETTINGS_ERROR_IO_ERROR Internal I/O error
1236  * @retval      #SYSTEM_SETTINGS_ERROR_PERMISSION_DENIED Permission violation error
1237  */
1238 int system_setting_get_network_wifi_notification(system_settings_key_e key, system_setting_data_type_e data_type, void **value);
1239
1240 /**
1241  * @internal
1242  * @since_tizen 2.3
1243  * @return      0 on success, otherwise a negative error value
1244  * @retval      #SYSTEM_SETTINGS_ERROR_NONE Successful
1245  * @retval      #SYSTEM_SETTINGS_ERROR_IO_ERROR Internal I/O error
1246  * @retval      #SYSTEM_SETTINGS_ERROR_PERMISSION_DENIED Permission violation error
1247  */
1248 int system_setting_set_changed_callback_network_wifi_notification(system_settings_key_e key, system_settings_changed_cb callback, void *user_data);
1249
1250 /**
1251  * @internal
1252  * @since_tizen 2.3
1253  * @return      0 on success, otherwise a negative error value
1254  * @retval      #SYSTEM_SETTINGS_ERROR_NONE Successful
1255  * @retval      #SYSTEM_SETTINGS_ERROR_IO_ERROR Internal I/O error
1256  * @retval      #SYSTEM_SETTINGS_ERROR_PERMISSION_DENIED Permission violation error
1257  */
1258 int system_setting_unset_changed_callback_network_wifi_notification(system_settings_key_e key);
1259
1260
1261 /**
1262  * @internal
1263  * @brief get current Idle Lock State
1264  * @since_tizen 2.3.1
1265  * @return      0 on success, otherwise a negative error value
1266  * @retval      #SYSTEM_SETTINGS_ERROR_NONE Successful
1267  * @retval      #SYSTEM_SETTINGS_ERROR_IO_ERROR Internal I/O error
1268  * @retval      #SYSTEM_SETTINGS_ERROR_PERMISSION_DENIED Permission violation error
1269  */
1270 int system_setting_get_lock_state(system_settings_key_e key, system_setting_data_type_e data_type, void **value);
1271
1272 /**
1273  * @internal
1274  * @since_tizen 2.3
1275  * @return      0 on success, otherwise a negative error value
1276  * @retval      #SYSTEM_SETTINGS_ERROR_NONE Successful
1277  * @retval      #SYSTEM_SETTINGS_ERROR_IO_ERROR Internal I/O error
1278  * @retval      #SYSTEM_SETTINGS_ERROR_PERMISSION_DENIED Permission violation error
1279  */
1280 int system_setting_set_lock_state(system_settings_key_e key, system_setting_data_type_e data_type, void *value);
1281
1282 /**
1283  * @internal
1284  * @since_tizen 2.3
1285  * @return      0 on success, otherwise a negative error value
1286  * @retval      #SYSTEM_SETTINGS_ERROR_NONE Successful
1287  * @retval      #SYSTEM_SETTINGS_ERROR_IO_ERROR Internal I/O error
1288  * @retval      #SYSTEM_SETTINGS_ERROR_PERMISSION_DENIED Permission violation error
1289  */
1290 int system_setting_set_changed_callback_lock_state(system_settings_key_e key, system_settings_changed_cb callback, void *user_data);
1291
1292 /**
1293  * @internal
1294  * @since_tizen 2.3
1295  * @return      0 on success, otherwise a negative error value
1296  * @retval      #SYSTEM_SETTINGS_ERROR_NONE Successful
1297  * @retval      #SYSTEM_SETTINGS_ERROR_IO_ERROR Internal I/O error
1298  * @retval      #SYSTEM_SETTINGS_ERROR_PERMISSION_DENIED Permission violation error
1299  */
1300 int system_setting_unset_changed_callback_lock_state(system_settings_key_e key);
1301
1302 /**
1303  * @internal
1304  * @brief get current ADS ID
1305  * @since_tizen 3.0
1306  * @return      0 on success, otherwise a negative error value
1307  * @retval      #SYSTEM_SETTINGS_ERROR_NONE Successful
1308  * @retval      #SYSTEM_SETTINGS_ERROR_IO_ERROR Internal I/O error
1309  * @retval      #SYSTEM_SETTINGS_ERROR_PERMISSION_DENIED Permission violation error
1310  */
1311 int system_setting_get_ads_id(system_settings_key_e key, system_setting_data_type_e data_type, void **value);
1312
1313 /**
1314  * @internal
1315  * @brief set ADS ID
1316  * @since_tizen 3.0
1317  * @return      0 on success, otherwise a negative error value
1318  * @retval      #SYSTEM_SETTINGS_ERROR_NONE Successful
1319  * @retval      #SYSTEM_SETTINGS_ERROR_IO_ERROR Internal I/O error
1320  * @retval      #SYSTEM_SETTINGS_ERROR_PERMISSION_DENIED Permission violation error
1321  */
1322 int system_setting_set_ads_id(system_settings_key_e key, system_setting_data_type_e data_type, void *value);
1323
1324 /**
1325  * @internal
1326  * @since_tizen 3.0
1327  * @return      0 on success, otherwise a negative error value
1328  * @retval      #SYSTEM_SETTINGS_ERROR_NONE Successful
1329  * @retval      #SYSTEM_SETTINGS_ERROR_IO_ERROR Internal I/O error
1330  * @retval      #SYSTEM_SETTINGS_ERROR_PERMISSION_DENIED Permission violation error
1331  */
1332 int system_setting_set_changed_callback_ads_id(system_settings_key_e key, system_settings_changed_cb callback, void *user_data);
1333
1334 /**
1335  * @internal
1336  * @since_tizen 3.0
1337  * @return      0 on success, otherwise a negative error value
1338  * @retval      #SYSTEM_SETTINGS_ERROR_NONE Successful
1339  * @retval      #SYSTEM_SETTINGS_ERROR_IO_ERROR Internal I/O error
1340  * @retval      #SYSTEM_SETTINGS_ERROR_PERMISSION_DENIED Permission violation error
1341  */
1342 int system_setting_unset_changed_callback_ads_id(system_settings_key_e key);
1343
1344 /**
1345  * @internal
1346  * @brief get current UDS status
1347  * @since_tizen 3.0
1348  * @return      0 on success, otherwise a negative error value
1349  * @retval      #SYSTEM_SETTINGS_ERROR_NONE Successful
1350  * @retval      #SYSTEM_SETTINGS_ERROR_IO_ERROR Internal I/O error
1351  * @retval      #SYSTEM_SETTINGS_ERROR_PERMISSION_DENIED Permission violation error
1352  */
1353 int system_setting_get_uds_state(system_settings_key_e key, system_setting_data_type_e data_type, void **value);
1354
1355 /**
1356  * @internal
1357  * @since_tizen 3.0
1358  * @return      0 on success, otherwise a negative error value
1359  * @retval      #SYSTEM_SETTINGS_ERROR_NONE Successful
1360  * @retval      #SYSTEM_SETTINGS_ERROR_IO_ERROR Internal I/O error
1361  * @retval      #SYSTEM_SETTINGS_ERROR_PERMISSION_DENIED Permission violation error
1362  */
1363 int system_setting_set_changed_callback_uds_state(system_settings_key_e key, system_settings_changed_cb callback, void *user_data);
1364
1365 /**
1366  * @internal
1367  * @since_tizen 3.0
1368  * @return      0 on success, otherwise a negative error value
1369  * @retval      #SYSTEM_SETTINGS_ERROR_NONE Successful
1370  * @retval      #SYSTEM_SETTINGS_ERROR_IO_ERROR Internal I/O error
1371  * @retval      #SYSTEM_SETTINGS_ERROR_PERMISSION_DENIED Permission violation error
1372  */
1373 int system_setting_unset_changed_callback_uds_state(system_settings_key_e key);
1374
1375
1376 /**
1377  * @internal
1378  * @since_tizen 3.0
1379  * @return      0 on success, otherwise a negative error value
1380  * @retval      #SYSTEM_SETTINGS_ERROR_NONE Successful
1381  * @retval      #SYSTEM_SETTINGS_ERROR_IO_ERROR Internal I/O error
1382  * @retval      #SYSTEM_SETTINGS_ERROR_PERMISSION_DENIED Permission violation error
1383  */
1384 int system_setting_set_changed_callback_uds_pkg_list(system_settings_key_e key, system_settings_changed_cb callback, void *user_data);
1385
1386
1387
1388 /**
1389  * @internal
1390  * @since_tizen 3.0
1391  * @return      0 on success, otherwise a negative error value
1392  * @retval      #SYSTEM_SETTINGS_ERROR_NONE Successful
1393  * @retval      #SYSTEM_SETTINGS_ERROR_IO_ERROR Internal I/O error
1394  * @retval      #SYSTEM_SETTINGS_ERROR_PERMISSION_DENIED Permission violation error
1395  */
1396 int system_setting_unset_changed_callback_uds_pkg_list(system_settings_key_e key);
1397
1398 /*// */
1399
1400
1401 #ifdef __cplusplus
1402 }
1403 #endif
1404
1405 #endif /* __TIZEN_SYSTEM_SETTING_PRIVATE_H__ */
1406
1407
1408