2 * IRC - Internet Relay Chat, ircd/m_names.c
3 * Copyright (C) 1990 Jarkko Oikarinen and
4 * University of Oulu, Computing Center
6 * See file AUTHORS in IRC package for additional names of
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 1, or (at your option)
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., 675 Mass Ave, Cambridge, MA 02139, USA.
23 * $Id: m_names.c 1845 2007-11-25 02:42:54Z entrope $
27 * m_functions execute protocol messages on this server:
29 * cptr is always NON-NULL, pointing to a *LOCAL* client
30 * structure (with an open socket connected!). This
31 * identifies the physical socket where the message
32 * originated (or which caused the m_function to be
33 * executed--some m_functions may call others...).
35 * sptr is the source of the message, defined by the
36 * prefix part of the message if present. If not
37 * or prefix not found, then sptr==cptr.
39 * (!IsServer(cptr)) => (cptr == sptr), because
40 * prefixes are taken *only* from servers...
43 * (sptr == cptr) => the message didn't
46 * (sptr != cptr && IsServer(sptr) means
47 * the prefix specified servername. (?)
49 * (sptr != cptr && !IsServer(sptr) means
50 * that message originated from a remote
55 * (!IsServer(sptr)) means that, sptr can safely
56 * taken as defining the target structure of the
57 * message in this server.
59 * *Always* true (if 'parse' and others are working correct):
61 * 1) sptr->from == cptr (note: cptr->from == cptr)
63 * 2) MyConnect(sptr) <=> sptr == cptr (e.g. sptr
64 * *cannot* be a local connection, unless it's
65 * actually cptr!). [MyConnect(x) should probably
66 * be defined as (x == x->from) --msa ]
68 * parc number of variable parameter strings (if zero,
69 * parv is allowed to be NULL)
71 * parv a NULL terminated list of parameter pointers,
73 * parv[0], sender (prefix string), if not present
74 * this points to an empty string.
75 * parv[1]...parv[parc-1]
76 * pointers to additional parameters
77 * parv[parc] == NULL, *always*
79 * note: it is guaranteed that parv[0]..parv[parc-1] are all
89 #include "ircd_reply.h"
90 #include "ircd_string.h"
97 /* #include <assert.h> -- Now using assert in ircd_log.h */
101 * Sends a suitably formatted 'names' reply to 'sptr' consisting of nicks within
102 * 'chptr', depending on 'filter'.
104 * NAMES_ALL - Lists all users on channel.
105 * NAMES_VIS - Only list visible (-i) users. --Gte (04/06/2000).
106 * NAMES_DEL - Show join-delayed names list.
107 * NAMES_EON - When OR'd with the other two, adds an 'End of Names' numeric
109 * NAMES_OPS - Only list oped (+o) or voiced (+v) users
113 void do_names(struct Client* sptr, struct Channel* chptr, int filter)
121 struct Client *c2ptr;
122 struct Membership* member;
126 assert((filter&NAMES_ALL) != (filter&NAMES_VIS));
128 /* Tag Pub/Secret channels accordingly. */
131 if (PubChannel(chptr))
133 else if (SecretChannel(chptr))
136 len = strlen(chptr->chname);
137 strcpy(buf + 2, chptr->chname);
138 strcpy(buf + 2 + len, " :");
144 if (!ShowChannel(sptr, chptr)) /* Don't list private channels unless we are on them. */
147 /* Iterate over all channel members, and build up the list. */
149 mlen = strlen(cli_name(&me)) + 10 + strlen(cli_name(sptr));
151 for (member = chptr->members; member; member = member->next_member)
153 c2ptr = member->user;
155 if (((filter&NAMES_VIS)!=0) && IsInvisible(c2ptr))
158 if (IsZombie(member) && member->user != sptr)
161 if (IsDelayedJoin(member) && (member->user != sptr) && !(filter & NAMES_DEL))
164 if ((!IsDelayedJoin(member) || (member->user == sptr)) && (filter & NAMES_DEL))
167 if (IsInvisibleJoin(member) && member->user != sptr)
170 if (!IsChanOp(member) && !HasVoice(member) && member->user != sptr && (filter & NAMES_OPS))
176 if (IsZombie(member))
178 else if (IsChanOp(member))
180 else if (HasVoice(member))
182 strcpy(buf + idx, cli_name(c2ptr));
183 idx += strlen(cli_name(c2ptr));
185 if (mlen + idx + NICKLEN + 5 > BUFSIZE)
186 /* space, modifier, nick, \r \n \0 */
188 send_reply(sptr, (filter & NAMES_DEL) ? RPL_DELNAMREPLY : RPL_NAMREPLY, buf);
195 send_reply(sptr, (filter & NAMES_DEL) ? RPL_DELNAMREPLY : RPL_NAMREPLY, buf);
196 if (filter&NAMES_EON)
197 send_reply(sptr, RPL_ENDOFNAMES, chptr->chname);
201 * m_names - generic message handler
203 * parv[0] = sender prefix
207 int m_names(struct Client* cptr, struct Client* sptr, int parc, char* parv[])
209 struct Channel *chptr;
210 struct Channel *ch2ptr;
211 struct Client *c2ptr;
212 struct Membership* member;
214 char* para = parc > 1 ? parv[1] : 0;
215 int showingdelayed = 0;
217 if (parc > 1 && !ircd_strcmp(parv[1], "-D")) {
218 para = (parc > 2) ? parv[2] : 0;
219 showingdelayed = NAMES_DEL;
220 if (parc > 3 && hunt_server_cmd(sptr, CMD_NAMES, cptr, 1, "%s %s %C", 3, parc, parv))
222 } else if (parc > 2 && hunt_server_cmd(sptr, CMD_NAMES, cptr, 1, "%s %C", 2, parc, parv))
225 if (EmptyString(para)) {
226 send_reply(sptr, RPL_ENDOFNAMES, "*");
231 s = strchr(para, ',');
235 * Special Case 1: "/names 0".
236 * Full list as per RFC.
238 if ((*para == '0') || (*para == '\0'))
243 struct Channel *ch3ptr;
246 mlen = strlen(cli_name(&me)) + 10 + strlen(cli_name(sptr));
248 /* List all visible channels/visible members */
249 struct Membership *member;
250 for (ch2ptr = GlobalChannelList; ch2ptr; ch2ptr = ch2ptr->next)
252 if (!ShowChannel(sptr, ch2ptr))
253 continue; /* Don't show secret chans. */
254 else if ((member = find_channel_member(sptr, ch2ptr))) {
255 do_names(sptr, ch2ptr, showingdelayed|NAMES_ALL|((ch2ptr->mode.mode & MODE_AUDITORIUM) && !(member->status & MODE_CHANOP) ? NAMES_OPS : 0)); /* Full list if we're in this chan. */
257 do_names(sptr, ch2ptr, showingdelayed|NAMES_VIS|((ch2ptr->mode.mode & MODE_AUDITORIUM) ? NAMES_OPS : 0));
260 /* List all remaining users on channel '*' */
262 strcpy(buf, "* * :");
266 for (c2ptr = GlobalClientList; c2ptr; c2ptr = cli_next(c2ptr))
270 if (!IsUser(c2ptr) || (sptr != c2ptr && IsInvisible(c2ptr)))
273 member = cli_user(c2ptr)->channel;
277 ch3ptr = member->channel;
279 if (PubChannel(ch3ptr) || find_channel_member(sptr, ch3ptr))
282 member = member->next_channel;
285 if (showflag) /* Have we already shown them? */
288 strcpy(buf + idx, cli_name(c2ptr));
289 idx += strlen(cli_name(c2ptr));
293 if (mlen + idx + NICKLEN + 3 > BUFSIZE) /* space, \r\n\0 */
295 send_reply(sptr, RPL_NAMREPLY, buf);
296 strcpy(buf, "* * :");
302 send_reply(sptr, RPL_NAMREPLY, buf);
303 send_reply(sptr, RPL_ENDOFNAMES, "*");
305 else if ((chptr = FindChannel(para)) != NULL)
307 member = find_member_link(chptr, sptr);
311 * Special Case 2: User is on this channel, requesting full names list.
312 * (As performed with each /join) - ** High frequency usage **
314 do_names(sptr, chptr, showingdelayed|NAMES_ALL|NAMES_EON|((chptr->mode.mode & MODE_AUDITORIUM) && !(member->status & MODE_CHANOP) ? NAMES_OPS : 0));
319 * Special Case 3: User isn't on this channel, show all visible users, in
320 * non secret channels.
322 do_names(sptr, chptr, showingdelayed|NAMES_VIS|NAMES_EON|((chptr->mode.mode & MODE_AUDITORIUM) ? NAMES_OPS : 0));
326 send_reply(sptr, RPL_ENDOFNAMES, para);
327 } while ((para = s) != NULL);