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
112 void do_names(struct Client* sptr, struct Channel* chptr, int filter)
120 struct Client *c2ptr;
121 struct Membership* member;
125 assert((filter&NAMES_ALL) != (filter&NAMES_VIS));
127 /* Tag Pub/Secret channels accordingly. */
130 if (PubChannel(chptr))
132 else if (SecretChannel(chptr))
135 len = strlen(chptr->chname);
136 strcpy(buf + 2, chptr->chname);
137 strcpy(buf + 2 + len, " :");
143 if (!ShowChannel(sptr, chptr)) /* Don't list private channels unless we are on them. */
146 /* Iterate over all channel members, and build up the list. */
148 mlen = strlen(cli_name(&me)) + 10 + strlen(cli_name(sptr));
150 for (member = chptr->members; member; member = member->next_member)
152 c2ptr = member->user;
154 if (((filter&NAMES_VIS)!=0) && IsInvisible(c2ptr))
157 if (IsZombie(member) && member->user != sptr)
160 if (IsDelayedJoin(member) && (member->user != sptr) && !(filter & NAMES_DEL))
163 if ((!IsDelayedJoin(member) || (member->user == sptr)) && (filter & NAMES_DEL))
166 if (IsInvisibleJoin(member) && member->user != sptr)
172 if (IsZombie(member))
174 else if (IsChanOp(member))
176 else if (HasVoice(member))
178 strcpy(buf + idx, cli_name(c2ptr));
179 idx += strlen(cli_name(c2ptr));
181 if (mlen + idx + NICKLEN + 5 > BUFSIZE)
182 /* space, modifier, nick, \r \n \0 */
184 send_reply(sptr, (filter & NAMES_DEL) ? RPL_DELNAMREPLY : RPL_NAMREPLY, buf);
191 send_reply(sptr, (filter & NAMES_DEL) ? RPL_DELNAMREPLY : RPL_NAMREPLY, buf);
192 if (filter&NAMES_EON)
193 send_reply(sptr, RPL_ENDOFNAMES, chptr->chname);
197 * m_names - generic message handler
199 * parv[0] = sender prefix
203 int m_names(struct Client* cptr, struct Client* sptr, int parc, char* parv[])
205 struct Channel *chptr;
206 struct Channel *ch2ptr;
207 struct Client *c2ptr;
208 struct Membership* member;
210 char* para = parc > 1 ? parv[1] : 0;
211 int showingdelayed = 0;
213 if (parc > 1 && !ircd_strcmp(parv[1], "-D")) {
214 para = (parc > 2) ? parv[2] : 0;
215 showingdelayed = NAMES_DEL;
216 if (parc > 3 && hunt_server_cmd(sptr, CMD_NAMES, cptr, 1, "%s %s %C", 3, parc, parv))
218 } else if (parc > 2 && hunt_server_cmd(sptr, CMD_NAMES, cptr, 1, "%s %C", 2, parc, parv))
221 if (EmptyString(para)) {
222 send_reply(sptr, RPL_ENDOFNAMES, "*");
227 s = strchr(para, ',');
231 * Special Case 1: "/names 0".
232 * Full list as per RFC.
234 if ((*para == '0') || (*para == '\0'))
239 struct Channel *ch3ptr;
242 mlen = strlen(cli_name(&me)) + 10 + strlen(cli_name(sptr));
244 /* List all visible channels/visible members */
246 for (ch2ptr = GlobalChannelList; ch2ptr; ch2ptr = ch2ptr->next)
248 if (!ShowChannel(sptr, ch2ptr))
249 continue; /* Don't show secret chans. */
250 else if (find_channel_member(sptr, ch2ptr))
251 do_names(sptr, ch2ptr, showingdelayed|NAMES_ALL); /* Full list if we're in this chan. */
253 do_names(sptr, ch2ptr, showingdelayed|NAMES_VIS);
256 /* List all remaining users on channel '*' */
258 strcpy(buf, "* * :");
262 for (c2ptr = GlobalClientList; c2ptr; c2ptr = cli_next(c2ptr))
266 if (!IsUser(c2ptr) || (sptr != c2ptr && IsInvisible(c2ptr)))
269 member = cli_user(c2ptr)->channel;
273 ch3ptr = member->channel;
275 if (PubChannel(ch3ptr) || find_channel_member(sptr, ch3ptr))
278 member = member->next_channel;
281 if (showflag) /* Have we already shown them? */
284 strcpy(buf + idx, cli_name(c2ptr));
285 idx += strlen(cli_name(c2ptr));
289 if (mlen + idx + NICKLEN + 3 > BUFSIZE) /* space, \r\n\0 */
291 send_reply(sptr, RPL_NAMREPLY, buf);
292 strcpy(buf, "* * :");
298 send_reply(sptr, RPL_NAMREPLY, buf);
299 send_reply(sptr, RPL_ENDOFNAMES, "*");
301 else if ((chptr = FindChannel(para)) != NULL)
303 member = find_member_link(chptr, sptr);
307 * Special Case 2: User is on this channel, requesting full names list.
308 * (As performed with each /join) - ** High frequency usage **
310 do_names(sptr, chptr, showingdelayed|NAMES_ALL|NAMES_EON);
315 * Special Case 3: User isn't on this channel, show all visible users, in
316 * non secret channels.
318 do_names(sptr, chptr, showingdelayed|NAMES_VIS|NAMES_EON);
322 send_reply(sptr, RPL_ENDOFNAMES, para);
323 } while ((para = s) != NULL);