/var/data/www/opensync/code/opensync/plugin/opensync_plugin.h

/*
 * libopensync - A synchronization framework
 * Copyright (C) 2004-2005  Armin Bauer <armin.bauer@opensync.org>
 * 
 * This library is free software; you can redistribute it and/or
 * modify it under the terms of the GNU Lesser General Public
 * License as published by the Free Software Foundation; either
 * version 2.1 of the License, or (at your option) any later version.
 * 
 * This library 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
 * Lesser General Public License for more details.
 * 
 * You should have received a copy of the GNU Lesser General Public
 * License along with this library; if not, write to the Free Software
 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307  USA
 * 
 */

#ifndef _OPENSYNC_PLUGIN_H_
#define _OPENSYNC_PLUGIN_H_


typedef void * (* initialize_fn) (OSyncPlugin *plugin, OSyncPluginInfo *info, OSyncError **error);

typedef void (* finalize_fn) (void * plugin_data);

typedef osync_bool (* discover_fn) (OSyncPluginInfo *info, void * plugin_data, OSyncError **error);

typedef enum {
        OSYNC_PLUGIN_NO_CONFIGURATION = 0,
        OSYNC_PLUGIN_OPTIONAL_CONFIGURATION = 1,
        OSYNC_PLUGIN_NEEDS_CONFIGURATION = 2
} OSyncConfigurationType;

OSYNC_EXPORT OSyncPlugin *osync_plugin_new(OSyncError **error);

OSYNC_EXPORT void osync_plugin_unref(OSyncPlugin *plugin);

OSYNC_EXPORT OSyncPlugin *osync_plugin_ref(OSyncPlugin *plugin);


OSYNC_EXPORT const char *osync_plugin_get_name(OSyncPlugin *plugin);

OSYNC_EXPORT void osync_plugin_set_name(OSyncPlugin *plugin, const char *name);


OSYNC_EXPORT const char *osync_plugin_get_longname(OSyncPlugin *plugin);

OSYNC_EXPORT void osync_plugin_set_longname(OSyncPlugin *plugin, const char *longname);


OSYNC_EXPORT OSyncConfigurationType osync_plugin_get_config_type(OSyncPlugin *plugin);

OSYNC_EXPORT void osync_plugin_set_config_type(OSyncPlugin *plugin, OSyncConfigurationType type);


OSYNC_EXPORT OSyncStartType osync_plugin_get_start_type(OSyncPlugin *plugin);

OSYNC_EXPORT void osync_plugin_set_start_type(OSyncPlugin *plugin, OSyncStartType type);


OSYNC_EXPORT const char *osync_plugin_get_description(OSyncPlugin *plugin);

OSYNC_EXPORT void osync_plugin_set_description(OSyncPlugin *plugin, const char *description);


OSYNC_EXPORT void osync_plugin_set_initialize(OSyncPlugin *plugin, initialize_fn init);

OSYNC_EXPORT void osync_plugin_set_finalize(OSyncPlugin *plugin, finalize_fn fin);

OSYNC_EXPORT void osync_plugin_set_discover(OSyncPlugin *plugin, discover_fn discover);


OSYNC_EXPORT void *osync_plugin_get_data(OSyncPlugin *plugin);

OSYNC_EXPORT void osync_plugin_set_data(OSyncPlugin *plugin, void *data);

OSYNC_EXPORT void osync_plugin_set_discover_timeout(OSyncPlugin *plugin, unsigned int timeout);

OSYNC_EXPORT void osync_plugin_set_initialize_timeout(OSyncPlugin *plugin, unsigned int timeout);

OSYNC_EXPORT void osync_plugin_set_finalize_timeout(OSyncPlugin *plugin, unsigned int timeout);

OSYNC_EXPORT osync_bool osync_plugin_initialize(OSyncPlugin *plugin, void **plugin_data, OSyncPluginInfo *info, OSyncError **error);

OSYNC_EXPORT void osync_plugin_finalize(OSyncPlugin *plugin, void *data);

OSYNC_EXPORT osync_bool osync_plugin_discover(OSyncPlugin *plugin, void *data, OSyncPluginInfo *info, OSyncError **error);

#endif /* OPENSYNC_PLUGIN_H_ */

---