ViewVC Help
View File | Revision Log | Show Annotations | View Changeset | Root Listing
root/svn/ircd-hybrid/contrib/example_module.c
Revision: 32
Committed: Sun Oct 2 20:41:23 2005 UTC (18 years, 5 months ago) by knight
Content type: text/x-csrc
File size: 7170 byte(s)
Log Message:
- svn:keywords

File Contents

# Content
1 /************************************************************************
2 * IRC - Internet Relay Chat, doc/example_module.c
3 * Copyright (C) 2001 Hybrid Development Team
4 *
5 * This program is free software; you can redistribute it and/or modify
6 * it under the terms of the GNU General Public License as published by
7 * the Free Software Foundation; either version 1, or (at your option)
8 * any later version.
9 *
10 * This program is distributed in the hope that it will be useful,
11 * but WITHOUT ANY WARRANTY; without even the implied warranty of
12 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13 * GNU General Public License for more details.
14 *
15 * You should have received a copy of the GNU General Public License
16 * along with this program; if not, write to the Free Software
17 * Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
18 *
19 * $Id$
20 */
21
22 /* List of ircd includes from ../include/
23 * These ones are necessary to build THIS module...
24 */
25
26 #include "stdinc.h" /* includes setup.h, for STATIC_MODULES */
27
28 #include "client.h" /* Required for IsClient, etc. */
29
30 #include "send.h" /* sendto_one, most useful function of all time */
31
32 #include "modules.h" /* includes msg.h; use for the msgtab */
33
34 #include "handlers.h" /* m_ignore */
35
36 /* OTHER USEFUL INCLUDES:
37 *
38 * #include "handlers.h" <-- include this file to be able to use default
39 * functions in place of your own 'Access Denied' kind of function
40 *
41 * #include "numeric.h" <-- include this file to be able to use form_str,
42 * standard message formats (see messages.tab and *.lang in messages/)
43 * Examples are strewn all across the ircd code, so just grep a bit to
44 * find one!
45 *
46 * #include "irc_string.h" <-- best to include this if you use *any*
47 * string comparison or parsing functions, although they may be available
48 * natively for your OS the prototypes in irc_string.h may be required for
49 * others. */
50
51 /* Declare the void's initially up here, as modules don't have an
52 * include file, we will normally have client_p, source_p, parc
53 * and parv[] where:
54 *
55 * client_p == client issuing command
56 * source_p == where the command came from
57 * parc == the number of parameters
58 * parv == an array of the parameters
59 */
60 static void mr_test(struct Client *, struct Client *, int, char *[]);
61 static void m_test(struct Client *, struct Client *, int, char *[]);
62 static void ms_test(struct Client *, struct Client *, int, char *[]);
63 static void mo_test(struct Client *, struct Client *, int, char *[]);
64
65 /*
66 * Show the commands this module can handle in a msgtab
67 * and give the msgtab a name, here its test_msgtab
68 */
69 struct Message test_msgtab = {
70
71 /* Fields are in order:
72 *-> "COMMAND", 0, 0, parc_count, maxparc, MFLG_SLOW, 0,
73 *
74 * where:
75 * COMMAND == the /command you want
76 * parc_count == the number of parameters needed
77 * (the clients name is one param, parv[0])
78 * maxparc == the maximum parameters we allow
79 * the 0's and MFLG_SLOW should not be changed..
80 */
81
82 /* This would add the command "TEST" which requires no additional
83 * parameters
84 */
85 "TEST", 0, 0, 1, 0, MFLG_SLOW, 0,
86
87 /* Fields are in order:
88 *-> {unregged, regged, remote, encap, oper, dummy}
89 *
90 * where:
91 * unregged == function to call for unregistered clients
92 * regged == function to call for normal users
93 * remote == function to call for servers/remote users
94 * encap == function to call for encap'd server/remote commands
95 * oper == function to call for operators
96 * dummy == function called when client is quarantined
97 *
98 * There are also some pre-coded functions for use:
99 * m_unregistered: prevent the client using this if unregistered
100 * m_not_oper: tell the client it requires being an operator
101 * m_ignore: ignore the command when it comes from certain types
102 * m_error: give an error when the command comes from certain types
103 */
104 { mr_test, m_test, ms_test, m_ignore, mo_test, m_ignore }
105
106 /* It is normal for unregistered functions to be prefixed with mr_
107 * " " normal users to be prefixed with m_
108 * " " remote clients to be prefixed with ms_
109 * " " operators to be prefixed with mo_
110 */
111 };
112 /* That's the msgtab finished */
113
114 #ifndef STATIC_MODULES
115 /* Here we tell it what to do when the module is loaded */
116 void
117 _modinit(void)
118 {
119 /* This will add the commands in test_msgtab (which is above) */
120 mod_add_cmd(&test_msgtab);
121 }
122
123 /* here we tell it what to do when the module is unloaded */
124 void
125 _moddeinit(void)
126 {
127 /* This will remove the commands in test_msgtab (which is above) */
128 mod_del_cmd(&test_msgtab);
129 }
130
131 /* When we last modified the file (shown in /modlist), this is usually:
132 */
133 const char *_version = "$Revision$";
134 #endif
135
136 /*
137 * mr_test
138 * parv[0] = sender prefix
139 * parv[1] = parameter
140 */
141
142 /* Here we have the functions themselves that we declared above,
143 * and the fairly normal C coding
144 */
145 static void
146 mr_test(struct Client *client_p, struct Client *source_p,
147 int parc, char *parv[])
148 {
149 if (parc == 1)
150 sendto_one(source_p, ":%s NOTICE %s :You are unregistered and sent no parameters",
151 me.name, source_p->name);
152 else
153 sendto_one(source_p, ":%s NOTICE %s :You are unregistered and sent parameter: %s",
154 me.name, source_p->name, parv[1]);
155 }
156
157 /*
158 * m_test
159 * parv[0] = sender prefix
160 * parv[1] = parameter
161 */
162 static void
163 m_test(struct Client *client_p, struct Client *source_p,
164 int parc, char *parv[])
165 {
166 if (parc == 1)
167 sendto_one(source_p, ":%s NOTICE %s :You are a normal user, and sent no parameters",
168 me.name, source_p->name);
169 else
170 sendto_one(source_p, ":%s NOTICE %s :You are a normal user, and send parameters: %s",
171 me.name, source_p->name, parv[1]);
172 }
173
174 /*
175 * ms_test
176 * parv[0] = sender prefix
177 * parv[1] = parameter
178 */
179 static void
180 ms_test(struct Client *client_p, struct Client *source_p,
181 int parc, char *parv[])
182 {
183 if (parc == 1)
184 {
185 if (IsServer(source_p))
186 sendto_one(source_p, ":%s NOTICE %s :You are a server, and sent no parameters",
187 me.name, source_p->name);
188 else
189 sendto_one(source_p, ":%s NOTICE %s :You are a remote client, and sent no parameters",
190 me.name, source_p->name);
191 }
192 else
193 {
194 if (IsServer(source_p))
195 sendto_one(source_p, ":%s NOTICE %s :You are a server, and sent parameters: %s",
196 me.name, source_p->name, parv[1]);
197 else
198 sendto_one(source_p, ":%s NOTICE %s :You are a remote client, and sent parameters: %s",
199 me.name, source_p->name, parv[1]);
200 }
201 }
202
203 /*
204 * mo_test
205 * parv[0] = sender prefix
206 * parv[1] = parameter
207 */
208 static void
209 mo_test(struct Client *client_p, struct Client *source_p,
210 int parc, char *parv[])
211 {
212 if (parc == 1)
213 sendto_one(source_p, ":%s NOTICE %s :You are an operator, and sent no parameters",
214 me.name, source_p->name);
215 else
216 sendto_one(source_p, ":%s NOTICE %s :You are an operator, and sent parameters: %s",
217 me.name, source_p->name, parv[1]);
218 }
219
220 /* END OF EXAMPLE MODULE */

Properties

Name Value
svn:eol-style native
svn:keywords Revision