/* -*- mode: C; c-file-style: "gnu" -*- */

/* dbus-watch.h DBusWatch internal interfaces

 *

 * Copyright (C) 2002  Red Hat Inc.

 * Portion Copyright © 2008 Nokia Corporation and/or its subsidiary(-ies). All rights reserved.

 * Licensed under the Academic Free License version 2.1

 * 

 * This program is free software; you can redistribute it and/or modify

 * it under the terms of the GNU General Public License as published by

 * the Free Software Foundation; either version 2 of the License, or

 * (at your option) any later version.

 *

 * This program is distributed in the hope that it will be useful,

 * but WITHOUT ANY WARRANTY; without even the implied warranty of

 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

 * GNU General Public License for more details.

 * 

 * You should have received a copy of the GNU General Public License

 * along with this program; if not, write to the Free Software

 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA

 *

 */

#ifndef DBUS_WATCH_H

#define DBUS_WATCH_H

#ifdef __SYMBIAN32__

//these are not system headers in build time

#include "dbus-internals.h"

#include <dbus/dbus-connection.h>

#else

#include <dbus/dbus-internals.h>

#include <dbus/dbus-connection.h>

#endif

DBUS_BEGIN_DECLS

/**

 * @addtogroup DBusWatchInternals

 * @{

 */

/* Public methods on DBusWatch are in dbus-connection.h */

typedef struct DBusWatchList DBusWatchList;

/** function to run when the watch is handled */

typedef dbus_bool_t (* DBusWatchHandler) (DBusWatch    *watch,

                                          unsigned int  flags,

                                          void         *data);

#ifdef __SYMBIAN32__

IMPORT_C

#endif

DBusWatch* _dbus_watch_new                (int               fd,

                                           unsigned int      flags,

                                           dbus_bool_t       enabled,

                                           DBusWatchHandler  handler,

                                           void             *data,

                                           DBusFreeFunction  free_data_function);

DBusWatch* _dbus_watch_ref                (DBusWatch        *watch);

#ifdef __SYMBIAN32__

IMPORT_C

#endif

void       _dbus_watch_unref              (DBusWatch        *watch);

#ifdef __SYMBIAN32__

IMPORT_C

#endif

void       _dbus_watch_invalidate         (DBusWatch        *watch);

void       _dbus_watch_sanitize_condition (DBusWatch        *watch,

                                           unsigned int     *condition);

void       _dbus_watch_set_handler        (DBusWatch        *watch,

                                           DBusWatchHandler  handler,

                                           void             *data,

                                           DBusFreeFunction  free_data_function);

#ifdef __SYMBIAN32__

IMPORT_C

#endif

DBusWatchList* _dbus_watch_list_new           (void);

#ifdef __SYMBIAN32__

IMPORT_C

#endif

void           _dbus_watch_list_free          (DBusWatchList           *watch_list);

#ifdef __SYMBIAN32__

IMPORT_C

#endif

dbus_bool_t    _dbus_watch_list_set_functions (DBusWatchList           *watch_list,

                                               DBusAddWatchFunction     add_function,

                                               DBusRemoveWatchFunction  remove_function,

                                               DBusWatchToggledFunction toggled_function,

                                               void                    *data,

                                               DBusFreeFunction         free_data_function);

dbus_bool_t    _dbus_watch_list_add_watch     (DBusWatchList           *watch_list,

                                               DBusWatch               *watch);

void           _dbus_watch_list_remove_watch  (DBusWatchList           *watch_list,

                                               DBusWatch               *watch);

void           _dbus_watch_list_toggle_watch  (DBusWatchList           *watch_list,

                                               DBusWatch               *watch,

                                               dbus_bool_t              enabled);

/** @} */

DBUS_END_DECLS

#endif /* DBUS_WATCH_H */