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