+ /** Match CIDR, without matching username/nickname parts.
+ *
+ * This function will compare a human-readable address against a human-
+ * readable CIDR mask, for example 1.2.3.4 against 1.2.0.0/16. This
+ * method supports both IPV4 and IPV6 addresses.
+ * @param address The human readable address, e.g. 1.2.3.4
+ * @param cidr_mask The human readable mask, e.g. 1.2.0.0/16
+ * @return True if the mask matches the address
+ */
+ CoreExport bool MatchCIDR(const char* address, const char* cidr_mask);
+
+ /** Match CIDR, including an optional username/nickname part.
+ *
+ * This function will compare a human-readable address (plus
+ * optional username and nickname) against a human-readable
+ * CIDR mask, for example joe!bloggs\@1.2.3.4 against
+ * *!bloggs\@1.2.0.0/16. This method supports both IPV4 and
+ * IPV6 addresses.
+ * @param address The human readable address, e.g. fred\@1.2.3.4
+ * @param cidr_mask The human readable mask, e.g. *\@1.2.0.0/16
+ * @return True if the mask matches the address
+ */
+ CoreExport bool MatchCIDR(const char* address, const char* cidr_mask, bool match_with_username);
+
+ /** Convert an insp_inaddr into human readable form.
+ *
+ * @param n An insp_inaddr (IP address) structure
+ * @return A human-readable address. IPV6 addresses
+ * will be shortened to remove fields which are 0.
+ */
+ CoreExport const char* insp_ntoa(insp_inaddr n);
+
+ /** Convert a human-readable address into an insp_inaddr.
+ *
+ * @param a A human-readable address
+ * @param n An insp_inaddr struct which the result
+ * will be copied into on success.
+ * @return This method will return a negative value if address
+ * does not contain a valid address family. 0 if the address is
+ * does not contain a valid string representing a valid network
+ * address. A positive value is returned if the network address
+ * was successfully converted.
+
+ * or any other number upon failure.
+ */
+ CoreExport int insp_aton(const char* a, insp_inaddr* n);
+
+ /** Create a new valid file descriptor using socket()
+ * @return On return this function will return a value >= 0 for success,
+ * or a negative value upon failure (negative values are invalid file
+ * descriptors)
+ */
+ CoreExport int OpenTCPSocket(char* addr, int socktype = SOCK_STREAM);
+ }
+}
+
+/** This class handles incoming connections on client ports.
+ * It will create a new User for every valid connection
+ * and assign it a file descriptor.
+ */
+class CoreExport ListenSocket : public EventHandler
+{
+ protected:
+ /** The creator/owner of this object
+ */
+ InspIRCd* ServerInstance;
+ /** Socket description (shown in stats p) */
+ std::string desc;
+ /** Socket address family */
+ int family;
+ /** Address socket is bound to */
+ std::string bind_addr;
+ /** Port socket is bound to */
+ int bind_port;
+ public:
+ /** Create a new listening socket
+ */
+ ListenSocket(InspIRCd* Instance, int port, char* addr);
+ /** Handle an I/O event
+ */
+ void HandleEvent(EventType et, int errornum = 0);
+ /** Close the socket
+ */
+ ~ListenSocket();
+ /** Set descriptive text
+ */
+ void SetDescription(const std::string &description)
+ {
+ desc = description;
+ }
+ /** Get description for socket
+ */
+ const std::string& GetDescription()
+ {
+ return desc;
+ }
+ /** Get port number for socket
+ */
+ int GetPort()
+ {
+ return bind_port;
+ }
+ /** Get IP address socket is bound to
+ */
+ std::string &GetIP()
+ {
+ return bind_addr;
+ }
+};