2 * ircd-ratbox: A slightly useful ircd.
3 * m_help.c: Provides help information to a user/operator.
5 * Copyright (C) 1990 Jarkko Oikarinen and University of Oulu, Co Center
6 * Copyright (C) 1996-2002 Hybrid Development Team
7 * Copyright (C) 2002-2005 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
38 #include "irc_dictionary.h"
40 static int m_help(struct Client
*, struct Client
*, int, const char **);
41 static int mo_help(struct Client
*, struct Client
*, int, const char **);
42 static int mo_uhelp(struct Client
*, struct Client
*, int, const char **);
43 static void dohelp(struct Client
*, int, const char *);
45 struct Message help_msgtab
= {
46 "HELP", 0, 0, 0, MFLG_SLOW
,
47 {mg_unreg
, {m_help
, 0}, mg_ignore
, mg_ignore
, mg_ignore
, {mo_help
, 0}}
49 struct Message uhelp_msgtab
= {
50 "UHELP", 0, 0, 0, MFLG_SLOW
,
51 {mg_unreg
, {m_help
, 0}, mg_ignore
, mg_ignore
, mg_ignore
, {mo_uhelp
, 0}}
54 mapi_clist_av1 help_clist
[] = { &help_msgtab
, &uhelp_msgtab
, NULL
};
55 DECLARE_MODULE_AV1(help
, NULL
, NULL
, help_clist
, NULL
, NULL
, "$Revision: 254 $");
58 * m_help - HELP message handler
61 m_help(struct Client
*client_p
, struct Client
*source_p
, int parc
, const char *parv
[])
63 dohelp(source_p
, HELP_USER
, parc
> 1 ? parv
[1] : NULL
);
69 * mo_help - HELP message handler
72 mo_help(struct Client
*client_p
, struct Client
*source_p
, int parc
, const char *parv
[])
74 dohelp(source_p
, HELP_OPER
, parc
> 1 ? parv
[1] : NULL
);
79 * mo_uhelp - HELP message handler
80 * This is used so that opers can view the user help file without deopering
83 mo_uhelp(struct Client
*client_p
, struct Client
*source_p
, int parc
, const char *parv
[])
85 dohelp(source_p
, HELP_USER
, parc
> 1 ? parv
[1] : NULL
);
90 dohelp(struct Client
*source_p
, int flags
, const char *topic
)
92 static const char ntopic
[] = "index";
93 struct cachefile
*hptr
;
94 struct cacheline
*lineptr
;
98 if(EmptyString(topic
))
101 if(!EmptyString(ServerInfo
.helpchan
))
102 sendto_one(source_p
, ":%s 525 %s :Official Help Channel: %s",
103 me
.name
, source_p
->name
, ServerInfo
.helpchan
);
104 if(!EmptyString(ServerInfo
.helpurl
))
105 sendto_one(source_p
, ":%s 526 %s :Official Help URL: %s",
106 me
.name
, source_p
->name
, ServerInfo
.helpurl
);
109 hptr
= irc_dictionary_retrieve(flags
& HELP_OPER
? help_dict_oper
: help_dict_user
, topic
);
111 if(hptr
== NULL
|| !(hptr
->flags
& flags
))
113 sendto_one(source_p
, form_str(ERR_HELPNOTFOUND
),
114 me
.name
, source_p
->name
, topic
);
118 fptr
= hptr
->contents
.head
;
119 lineptr
= fptr
->data
;
121 /* first line cant be empty */
122 sendto_one(source_p
, form_str(RPL_HELPSTART
),
123 me
.name
, source_p
->name
, topic
, lineptr
->data
);
125 RB_DLINK_FOREACH(ptr
, fptr
->next
)
129 sendto_one(source_p
, form_str(RPL_HELPTXT
),
130 me
.name
, source_p
->name
, topic
, lineptr
->data
);
133 sendto_one(source_p
, form_str(RPL_ENDOFHELP
),
134 me
.name
, source_p
->name
, topic
);