1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
|
/*
Plugin.h - header file for plugin. It contains mandatory macros
and common function for plugins
Copyright (C) 2009 Zdenek Prikryl (zprikryl@redhat.com)
Copyright (C) 2009 RedHat inc.
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.,
51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
*/
#ifndef PLUGIN_H_
#define PLUGIN_H_
#include "abrt_types.h"
#include "CrashTypes.h"
#if HAVE_CONFIG_H
#include <config.h>
#endif
#if ENABLE_NLS
#include <libintl.h>
#define _(S) gettext(S)
#else
#define _(S) (S)
#endif
#define PLUGINS_MAGIC_NUMBER 6
#define PLUGINS_CONF_EXTENSION "conf"
#define PLUGINS_LIB_EXTENSION "so"
#define PLUGINS_LIB_PREFIX "lib"
/**
* An abstract class. The class defines a common plugin interface. If a plugin
* has some settings, then a *Settings(*) method has to be written.
*/
class CPlugin
{
public:
/**
* A destructor.
*/
virtual ~CPlugin();
/**
* A method, which initializes a plugin. It is not mandatory method.
*/
virtual void Init();
/**
* A method, which deinitializes a plugin. It is not mandatory method.
*/
virtual void DeInit();
/**
* A method, which takes a settings and apply them. It is not a mandatory method.
* @param pSettings Plugin's settings
*/
virtual void SetSettings(const map_plugin_settings_t& pSettings);
/**
* A method, which return current settings. It is not mandatory method.
* @return Plugin's settings
*/
virtual map_plugin_settings_t GetSettings();
};
/**
* An enum of plugin types.
*/
typedef enum {
ANALYZER, /**< An analyzer plugin*/
ACTION, /**< An action plugin*/
REPORTER, /**< A reporter plugin*/
DATABASE /**< A database plugin*/
} plugin_type_t;
/**
* A struct contains all needed data about particular plugin.
*/
typedef struct SPluginInfo
{
const plugin_type_t m_Type; /**< Plugin type.*/
const char *const m_sName; /**< Plugin name.*/
const char *const m_sVersion; /**< Plugin version.*/
const char *const m_sDescription; /**< Plugin description.*/
const char *const m_sEmail; /**< Plugin author's email.*/
const char *const m_sWWW; /**< Plugin's home page.*/
const char *const m_sGTKBuilder; /**< Plugin's gui description.*/
const int m_nMagicNumber; /**< Plugin magical number.*/
} plugin_info_t;
#define PLUGIN_INFO(type, plugin_class, name, version, description, email, www, gtk_builder)\
extern "C" CPlugin* plugin_new()\
{\
return new plugin_class();\
}\
extern "C" const plugin_info_t plugin_info =\
{\
type,\
name,\
version,\
description,\
email,\
www,\
gtk_builder,\
PLUGINS_MAGIC_NUMBER,\
};
/* helper finctions */
std::string make_description_bz(const map_crash_report_t& pCrashReport);
std::string make_description_logger(const map_crash_report_t& pCrashReport);
#endif
|
