Main Page | Modules | Alphabetical List | Data Structures | File List | Data Fields | Globals | Related Pages

Not included


Defines

#define LOG_D   __FILE__,__LINE__,LOG_DEBUG

Functions

osso_return_t osso_tasknav_mail_add (osso_context_t *osso, guint id, const gchar *subject, const gchar *sender, gboolean attachment, const gchar *date)
osso_return_t osso_tasknav_mail_del (osso_context_t *osso, guint id)
osso_return_t osso_tasknav_mail_set_outbox_count (osso_context_t *osso, guint count)
void osso_log (int level, const char *format,...)
void d_log (const char *file, int line, int level, const char *format,...)
gpointer osso_get_dbus_connection (osso_context_t *osso)
gpointer osso_get_sys_dbus_connection (osso_context_t *osso)
osso_context_tosso_application_initialize (const gchar *application, const gchar *version, osso_application_top_cb_f *cb, gpointer callback_data)

Detailed Description

Note:
these functions will NOT be part of libosso, since they are used just by email application. The functions here are presented as a proposal for what the email app could use.

Define Documentation

#define LOG_D   __FILE__,__LINE__,LOG_DEBUG
 


Function Documentation

void d_log const char *  file,
int  line,
int  level,
const char *  format,
  ...
[inline]
 

Funcion to log debug info to the syslog. Will be empty with DEBUG not defined hoping that compiler will eliminate the call.

The first four arguments can be replaced with LOG_D

Parameters:
file the file this came from
line the linenumber this came from
level Log level. Set to CRIT , ERR, WARN or INFO. Usage in similar manner as for syscall(2)
format Printf styled format string, see printf(2) for details
... arguments for the format string.

osso_context_t* osso_application_initialize const gchar *  application,
const gchar *  version,
osso_application_top_cb_f cb,
gpointer  callback_data
 

Osso initialisation routine for applications to call. This ensures that the environment variables are transferred correctly before the gtk_init();

Parameters:
application The name that this application is known as. This is not the name that a user sees, but rather the name that other applications use as an address to communicate with this program.
version The version string of the application. It mus be simply comparable with strcmp().
cb The callback function to used when application is topped.
callback_data An arbitrary pointer to some application specific data to pass to the top callback

gpointer osso_get_dbus_connection osso_context_t osso  ) 
 

Returns dbus session bus connection used by osso

Parameters:
osso osso context as returned by osso_initialize
Returns:
pointer to DBusConnection on a gpointer
FIXME Have to returen gpointer now since due to errors in dbus.h it can not be included to every software.

gpointer osso_get_sys_dbus_connection osso_context_t osso  ) 
 

Returns dbus system bus connection used by osso

Parameters:
osso osso context as returned by osso_initialize
Returns:
pointer to DBusConnection on a gpointer
FIXME Have to return a gpointer now since due to errors in dbus.h it can not be included to every software.

void osso_log int  level,
const char *  format,
  ...
 

Funcion to log to the syslog.

Parameters:
level Log level. Set to LOG_CRIT , LOG_ERR, LOG_WARNING or LOG_INFO. Usage in similar manner as for syscall(2)
format Printf styled format string, see printf(2) for details
... arguments for the format string.

osso_return_t osso_tasknav_mail_add osso_context_t osso,
guint  id,
const gchar *  subject,
const gchar *  sender,
gboolean  attachment,
const gchar *  date
 

This function adds a mail to be displayed in the mail popup of the tasknavigator.

Parameters:
osso The osso library context returned by osso_initialize
id unique identifier for the mail
subject the subject string of the email
sender the email address of the sender of the mail
attachment true iff the mail has an attatchment
date the date the mail was received.
Returns:
OSSO_OK on success, OSSO_ERROR in case of an error, OSSO_INVALID if a parameter is invalid.

osso_return_t osso_tasknav_mail_del osso_context_t osso,
guint  id
 

This function removes an email message from the navigator.

Parameters:
osso The osso library context returned by osso_initialize
id unique identifier of the mail to be destroyed
Returns:
OSSO_OK on success, OSSO_ERROR in case of an error, OSSO_INVALID if a paramter is invalid.

osso_return_t osso_tasknav_mail_set_outbox_count osso_context_t osso,
guint  count
 

This function updates the outbox message count in the task navigator mail window.

Parameters:
osso The osso library context returned by osso_initialize
count New number of messages in outbox
Returns:
OSSO_OK on success, OSSO_ERROR in case of an error, OSSO_INVALID if a paramter is invalid.


Generated on Mon May 23 03:17:49 2005 for LibOSSO by doxygen 1.3.7