2 * ircd-ratbox: A slightly useful ircd.
3 * modules.h: A header for the modules functions.
5 * Copyright (C) 1990 Jarkko Oikarinen and University of Oulu, Co Center
6 * Copyright (C) 1996-2002 Hybrid Development Team
7 * Copyright (C) 2002-2004 ircd-ratbox development team
9 * This program is free software; you can redistribute it and/or modify
10 * it under the terms of the GNU General Public License as published by
11 * the Free Software Foundation; either version 2 of the License, or
12 * (at your option) any later version.
14 * This program is distributed in the hope that it will be useful,
15 * but WITHOUT ANY WARRANTY; without even the implied warranty of
16 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
17 * GNU General Public License for more details.
19 * You should have received a copy of the GNU General Public License
20 * along with this program; if not, write to the Free Software
21 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
25 #ifndef INCLUDED_modules_h
26 #define INCLUDED_modules_h
32 #define MAPI_CHARYBDIS 2
43 const char *description
;
45 int core
; /* This is int for backwards compat reasons */
46 int origin
; /* Ditto */
48 void *mapi_header
; /* actually struct mapi_mheader_av<mapi_version> */
52 #define MAPI_MAGIC_HDR 0x4D410000
54 #define MAPI_V1 (MAPI_MAGIC_HDR | 0x1)
55 #define MAPI_V2 (MAPI_MAGIC_HDR | 0x2)
57 #define MAPI_MAGIC(x) ((x) & 0xffff0000)
58 #define MAPI_VERSION(x) ((x) & 0x0000ffff)
60 typedef struct Message
* mapi_clist_av1
;
64 const char *hapi_name
;
70 const char *hapi_name
;
75 #define MAPI_CAP_CLIENT 1
76 #define MAPI_CAP_SERVER 2
80 int cap_index
; /* Which cap index does this belong to? */
81 const char *cap_name
; /* Capability name */
82 void *cap_ownerdata
; /* Not used much but why not... */
83 unsigned int *cap_id
; /* May be set to non-NULL to store cap id */
86 struct mapi_mheader_av1
88 int mapi_version
; /* Module API version */
89 int (*mapi_register
)(void); /* Register function; ret -1 = failure (unload) */
90 void (*mapi_unregister
)(void); /* Unregister function. */
91 mapi_clist_av1
*mapi_command_list
; /* List of commands to add. */
92 mapi_hlist_av1
*mapi_hook_list
; /* List of hooks to add. */
93 mapi_hfn_list_av1
*mapi_hfn_list
; /* List of hook_add_hook's to do */
94 const char *mapi_module_version
; /* Module's version (freeform) */
97 #define MAPI_ORIGIN_UNKNOWN 0 /* Unknown provenance (AV1 etc.) */
98 #define MAPI_ORIGIN_EXTENSION 1 /* Charybdis extension */
99 #define MAPI_ORIGIN_CORE 2 /* Charybdis core module */
101 struct mapi_mheader_av2
103 int mapi_version
; /* Module API version */
104 int (*mapi_register
)(void); /* Register function; ret -1 = failure (unload) */
105 void (*mapi_unregister
)(void); /* Unregister function. */
106 mapi_clist_av1
*mapi_command_list
; /* List of commands to add. */
107 mapi_hlist_av1
*mapi_hook_list
; /* List of hooks to add. */
108 mapi_hfn_list_av1
*mapi_hfn_list
; /* List of hook_add_hook's to do */
109 mapi_cap_list_av2
*mapi_cap_list
; /* List of CAPs to add */
110 const char *mapi_module_version
; /* Module's version (freeform), replaced with ircd version if NULL */
111 const char *mapi_module_description
; /* Module's description (freeform) */
112 unsigned long int mapi_datecode
; /* Unix timestamp of module's build */
115 #define DECLARE_MODULE_AV1(name, reg, unreg, cl, hl, hfnlist, v) \
116 struct mapi_mheader_av1 _mheader = { MAPI_V1, reg, unreg, cl, hl, hfnlist, v}
118 #define DECLARE_MODULE_AV2(name, reg, unreg, cl, hl, hfnlist, caplist, v, desc) \
119 struct mapi_mheader_av2 _mheader = { MAPI_V2, reg, unreg, cl, hl, hfnlist, caplist, v, desc, DATECODE}
122 void mod_add_path(const char *path
);
123 void mod_clear_paths(void);
126 extern void load_module(char *path
);
128 /* load all modules */
129 extern void load_all_modules(bool warn
);
131 /* load core modules */
132 extern void load_core_modules(bool);
134 extern bool unload_one_module(const char *, bool);
135 extern bool load_one_module(const char *, int, bool);
136 extern bool load_a_module(const char *, bool, int, bool);
137 extern struct module *findmodule_byname(const char *);
138 extern void init_modules(void);
140 extern rb_dlink_list module_list
;
141 extern rb_dlink_list mod_paths
;
143 #endif /* INCLUDED_modules_h */