Add HOOKTYPE_IS_HANDSHAKE_FINISHED: if a module returns 0 then register_user()

will not be called. This is used, for example, by m_cap when the CAP LS
handshake is still in progress. Modules can add their own requirements
as they see fit.
Note that, as for (CAP) functionality, this adds nothing new, it just
implements it in a cleaner way, rather than all over the place,
like in UnrealIRCd 4.x.

src/modules/m_cap.c

@@ -38,6 +38,7 @@ ModuleHeader MOD_HEADER(m_cap)
 	};
 
 /* Forward declarations */
+int cap_is_handshake_finished(aClient *acptr);
 int cap_never_visible(aClient *acptr);
 
 /* Variables */
@@ -93,6 +94,8 @@ MOD_INIT(m_cap)
 	c.name = "extended-join";
 	ClientCapabilityAdd(modinfo->handle, &c, &CAP_EXTENDED_JOIN);
 
+	HookAdd(modinfo->handle, HOOKTYPE_IS_HANDSHAKE_FINISHED, 0, cap_is_handshake_finished);
+
 	return MOD_SUCCESS;
 }
 
@@ -369,6 +372,15 @@ int cap_never_visible(aClient *acptr)
 	return 0;
 }
 
+/** Is our handshake done? */
+int cap_is_handshake_finished(aClient *acptr)
+{
+	if (HasCapabilityFast(acptr, CAP_IN_PROGRESS))
+		return 0; /* We are in CAP LS stage, waiting for a CAP END */
+
+	return 1;
+}
+
 CMD_FUNC(m_cap)
 {
 	struct clicap_cmd *cmd;

src/modules/m_nick.c

@@ -1095,7 +1095,7 @@ CMD_FUNC(m_nick)
 		}
 		/* This had to be copied here to avoid problems.. */
 		strlcpy(sptr->name, nick, sizeof(sptr->name));
-		if (user_ready_for_register(sptr))
+		if (is_handshake_finished(sptr))
 		{
 			/*
 			   ** USER already received, now we have NICK.

src/modules/m_pingpong.c

@@ -135,7 +135,7 @@ CMD_FUNC(m_nospoof)
 		sendto_one(sptr, NULL, ":IRC!IRC@%s PRIVMSG %s :\1VERSION\1",
 			   me.name, sptr->name);
 
-	if (user_ready_for_register(sptr))
+	if (is_handshake_finished(sptr))
 		return register_user(cptr, sptr, sptr->name,
 		    sptr->user->username, NULL, NULL, NULL);
 	return 0;

src/modules/m_user.c

@@ -169,7 +169,7 @@ CMD_FUNC(m_user)
 
 	strlcpy(sptr->info, realname, sizeof(sptr->info));
 	if (*sptr->name &&
-		(IsServer(cptr) || user_ready_for_register(cptr))
+		(IsServer(cptr) || is_handshake_finished(cptr))
            )
 		/* NICK and no-spoof already received, now we have USER... */
 	{

src/s_user.c

@@ -835,18 +835,27 @@ void set_targmax_defaults(void)
 	setmaxtargets("WATCH", MAXTARGETS_MAX); // not configurable
 }
 
-/** Can register_user() be called?
- * In other words:
- * - we have a NICK
- * - we have a USER
- * - there is no client capability negotiation in progress
- * - the nospoof cookie has been received (if enabled)
+/** Is the user handshake finished and can register_user() be called?
+ * This checks things like: do we have a NICK, USER, nospoof,
+ * and any other things modules may add:
+ * eg: the cap module checks if client capability negotiation
+ * is in progress
  */
-int user_ready_for_register(aClient *sptr)
+int is_handshake_finished(aClient *sptr)
 {
-#define PROTO_CLICAP 0x1000000
-// TEST: FIXME
-	if (sptr->user && *sptr->user->username && sptr->name[0] && !CHECKPROTO(sptr, PROTO_CLICAP) && IsNotSpoof(sptr))
+	Hook *h;
+	int n;
+
+	for (h = Hooks[HOOKTYPE_IS_HANDSHAKE_FINISHED]; h; h = h->next)
+	{
+		n = (*(h->func.intfunc))(sptr);
+		if (n == 0)
+			return 0; /* We can stop already */
+	}
+
+	/* I figured these can be here, in the core: */
+	if (sptr->user && *sptr->user->username && sptr->name[0] && IsNotSpoof(sptr))
 		return 1;
+
 	return 0;
 }