00001
00026 #ifndef LIBOSSO_H_
00027 #define LIBOSSO_H_
00028
00029 #include <glib.h>
00030 #include <time.h>
00031 #include <syslog.h>
00032
00033 #define DBUS_API_SUBJECT_TO_CHANGE
00034
00035 #include <dbus/dbus.h>
00036 #include <dbus/dbus-protocol.h>
00037
00038 G_BEGIN_DECLS
00039
00040
00044 typedef enum {
00045 OSSO_OK = 0,
00046 OSSO_ERROR = -1,
00047 OSSO_INVALID = -2,
00048 OSSO_RPC_ERROR = -4,
00049 OSSO_ERROR_NAME = -3,
00050 OSSO_ERROR_NO_STATE = -5,
00051 OSSO_ERROR_STATE_SIZE = -6
00053 } osso_return_t;
00054
00055
00063 typedef struct osso_af_context_t osso_context_t;
00064
00087 osso_context_t * osso_initialize(const gchar *application,
00088 const gchar* version,
00089 gboolean activation,
00090 GMainContext *context);
00098 void osso_deinitialize(osso_context_t *osso);
00099
00100
00101
00107
00108
00113 typedef struct {
00114 int type;
00115 union {
00116 guint32 u;
00117 gint32 i;
00118 gboolean b;
00119 gdouble d;
00120 gchar *s;
00121 } value;
00122 }
00123 osso_rpc_t;
00124
00139 void osso_rpc_free_val (osso_rpc_t *rpc);
00140
00159 typedef gint (osso_rpc_cb_f)(const gchar *interface, const gchar *method,
00160 GArray *arguments, gpointer data,
00161 osso_rpc_t *retval);
00162
00175 typedef void (osso_rpc_async_f)(const gchar *interface,
00176 const gchar *method,
00177 osso_rpc_t *retval, gpointer data);
00178
00228 osso_return_t osso_rpc_run (osso_context_t * osso, const gchar * service,
00229 const gchar * object_path,
00230 const gchar * interface, const gchar * method,
00231 osso_rpc_t * retval, int argument_type, ...);
00232
00239 typedef void osso_rpc_argfill (DBusMessage *msg, void *data);
00240
00256 osso_return_t osso_rpc_run_with_argfill (osso_context_t * osso,
00257 const gchar * service,
00258 const gchar * object_path,
00259 const gchar * interface,
00260 const gchar * method,
00261 osso_rpc_t * retval,
00262 osso_rpc_argfill *argfill,
00263 gpointer argfill_data);
00264
00269 osso_return_t osso_rpc_run_system (osso_context_t * osso, const gchar * service,
00270 const gchar * object_path,
00271 const gchar * interface, const gchar * method,
00272 osso_rpc_t * retval, int argument_type, ...);
00273
00274
00275
00276
00277
00278
00279
00280
00281 osso_return_t osso_rpc_run_system_with_argfill (osso_context_t * osso,
00282 const gchar * service,
00283 const gchar * object_path,
00284 const gchar * interface,
00285 const gchar * method,
00286 osso_rpc_t *retval,
00287 osso_rpc_argfill *argfill,
00288 gpointer argfill_data);
00289
00321 osso_return_t osso_rpc_run_with_defaults (osso_context_t * osso,
00322 const gchar * application,
00323 const gchar * method,
00324 osso_rpc_t * retval,
00325 int argument_type, ...);
00326
00355 osso_return_t osso_rpc_async_run (osso_context_t * osso,
00356 const gchar * service,
00357 const gchar * object_path,
00358 const gchar * interface,
00359 const gchar * method,
00360 osso_rpc_async_f * async_cb, gpointer data,
00361 int argument_type, ...);
00362
00378 osso_return_t osso_rpc_async_run_with_argfill (osso_context_t * osso,
00379 const gchar * service,
00380 const gchar * object_path,
00381 const gchar * interface,
00382 const gchar * method,
00383 osso_rpc_async_f * async_cb,
00384 gpointer data,
00385 osso_rpc_argfill *argfill,
00386 gpointer argfill_data);
00387
00417 osso_return_t osso_rpc_async_run_with_defaults (osso_context_t * osso,
00418 const gchar * application,
00419 const gchar * method,
00420 osso_rpc_async_f * async_cb,
00421 gpointer data,
00422 int argument_type, ...);
00423
00429 typedef void osso_rpc_retval_free_f (osso_rpc_t *retval);
00430
00451 osso_return_t osso_rpc_set_cb_f_with_free (osso_context_t * osso, const gchar * service,
00452 const gchar * object_path,
00453 const gchar * interface, osso_rpc_cb_f * cb,
00454 gpointer data,
00455 osso_rpc_retval_free_f *retval_free);
00456
00460 osso_return_t osso_rpc_set_cb_f (osso_context_t * osso, const gchar * service,
00461 const gchar * object_path,
00462 const gchar * interface, osso_rpc_cb_f * cb,
00463 gpointer data);
00464
00477 osso_return_t osso_rpc_set_default_cb_f_with_free (osso_context_t * osso,
00478 osso_rpc_cb_f * cb, gpointer data,
00479 osso_rpc_retval_free_f *retval_free);
00480
00484 osso_return_t osso_rpc_set_default_cb_f (osso_context_t * osso,
00485 osso_rpc_cb_f * cb, gpointer data);
00486
00487
00500 osso_return_t osso_rpc_unset_cb_f (osso_context_t * osso,
00501 const gchar * service,
00502 const gchar * object_path,
00503 const gchar * interface,
00504 osso_rpc_cb_f * cb, gpointer data);
00505
00515 osso_return_t osso_rpc_unset_default_cb_f (osso_context_t * osso,
00516 osso_rpc_cb_f * cb, gpointer data);
00517
00524 osso_return_t osso_rpc_get_timeout (osso_context_t * osso, gint * timeout);
00525
00532 osso_return_t osso_rpc_set_timeout(osso_context_t * osso, gint timeout);
00533
00534
00535
00620 osso_return_t osso_application_top(osso_context_t *osso,
00621 const gchar *application,
00622 const gchar *arguments);
00623
00635 typedef void(osso_application_top_cb_f)(const gchar *arguments,
00636 gpointer data);
00637
00650 osso_return_t osso_application_set_top_cb(osso_context_t *osso,
00651 osso_application_top_cb_f *cb,
00652 gpointer data);
00653
00666 osso_return_t osso_application_unset_top_cb(osso_context_t *osso,
00667 osso_application_top_cb_f *cb,
00668 gpointer data);
00669
00670
00671
00697
00703 typedef void(osso_application_autosave_cb_f)(gpointer data);
00704
00715 osso_return_t osso_application_set_autosave_cb(osso_context_t *osso,
00716 osso_application_autosave_cb_f *cb,
00717 gpointer data);
00718
00729 osso_return_t osso_application_unset_autosave_cb(osso_context_t *osso,
00730 osso_application_autosave_cb_f *cb,
00731 gpointer data);
00732
00744 osso_return_t osso_application_userdata_changed(osso_context_t *osso);
00745
00754 osso_return_t osso_application_autosave_force(osso_context_t *osso);
00755
00756
00757
00758
00759
00760
00761
00762 const gchar * osso_application_name_get(osso_context_t *osso);
00763
00764
00765
00766
00767
00768
00769
00770 const gchar * osso_application_version_get(osso_context_t *osso);
00771
00774
00778
00779
00799 osso_return_t osso_statusbar_send_event(osso_context_t *osso,
00800 const gchar *name,
00801 gint argument1, gint argument2,
00802 const gchar *argument3,
00803 osso_rpc_t *retval);
00804
00805
00809
00810
00815 typedef void(osso_time_cb_f)(gpointer data);
00816
00827 osso_return_t osso_time_set_notification_cb(osso_context_t *osso,
00828 osso_time_cb_f *cb,
00829 gpointer data);
00840 osso_return_t osso_time_set(osso_context_t *osso, time_t new_time);
00841
00842
00846
00847
00878 typedef void(osso_locale_change_cb_f)(const char *new_locale, gpointer data);
00879
00890 osso_return_t osso_locale_change_set_notification_cb(osso_context_t *osso,
00891 osso_locale_change_cb_f *cb,
00892 gpointer data);
00893
00904 osso_return_t osso_locale_set(osso_context_t *osso, char *new_locale);
00905
00906
00910
00911
00916 typedef enum {
00917 OSSO_GN_WARNING = 0,
00918 OSSO_GN_ERROR,
00919 OSSO_GN_NOTICE,
00920 OSSO_GN_WAIT
00921 } osso_system_note_type_t;
00922
00944 osso_return_t osso_system_note_dialog(osso_context_t *osso,
00945 const gchar *message,
00946 osso_system_note_type_t type,
00947 osso_rpc_t *retval);
00948
00964 osso_return_t osso_system_note_infoprint(osso_context_t *osso,
00965 const gchar *text,
00966 osso_rpc_t *retval);
00967
00968
00969
01080
01081
01085 typedef struct {
01086 guint32 state_size;
01087 gpointer state_data;
01088 } osso_state_t;
01089
01120 osso_return_t osso_state_write(osso_context_t *osso, osso_state_t *state);
01121
01160 osso_return_t osso_state_read(osso_context_t *osso, osso_state_t *state);
01161
01162
01163
01164
01168
01185 osso_return_t osso_cp_plugin_execute(osso_context_t *osso,
01186 const gchar *filename,
01187 gpointer data, gboolean user_activated);
01188
01199 osso_return_t osso_cp_plugin_save_state(osso_context_t *osso,
01200 const gchar *filename,
01201 gpointer data);
01202
01203
01210 typedef enum {
01211 OSSO_DEVMODE_NORMAL = 0,
01212 OSSO_DEVMODE_FLIGHT,
01213 OSSO_DEVMODE_OFFLINE,
01214 OSSO_DEVMODE_INVALID
01215 } osso_devmode_t;
01216
01217
01224 typedef struct {
01225 gboolean shutdown_ind;
01226 gboolean save_unsaved_data_ind;
01228 gboolean memory_low_ind;
01229 gboolean system_inactivity_ind;
01232 osso_devmode_t sig_device_mode_ind;
01233 } osso_hw_state_t;
01234
01235
01246 osso_return_t osso_display_state_on(osso_context_t *osso);
01247
01259 osso_return_t osso_display_blanking_pause(osso_context_t *osso);
01260
01268 typedef void (osso_hw_cb_f)(osso_hw_state_t *state, gpointer data);
01269
01285 osso_return_t osso_hw_set_event_cb(osso_context_t *osso,
01286 osso_hw_state_t *state,
01287 osso_hw_cb_f *cb, gpointer data);
01288
01297 osso_return_t osso_hw_unset_event_cb(osso_context_t *osso,
01298 osso_hw_state_t *state);
01299
01301
01306
01315 typedef void (osso_mime_cb_f)(gpointer data, int argc, gchar **argv);
01316
01329 osso_return_t osso_mime_set_cb(osso_context_t *osso, osso_mime_cb_f *cb,
01330 gpointer data);
01331
01340 osso_return_t osso_mime_unset_cb(osso_context_t *osso);
01341
01342 osso_return_t osso_mime_unset_cb_full(osso_context_t *osso,
01343 osso_mime_cb_f *cb, gpointer data);
01352 gpointer osso_get_dbus_connection(osso_context_t *osso);
01353
01354
01361 gpointer osso_get_sys_dbus_connection(osso_context_t *osso);
01362
01364 G_END_DECLS
01365
01366 #endif