whois

Author: lws-team

CMakeLists-implied-options.txt

@@ -130,6 +130,7 @@ if (LWS_WITH_SELFDNS)
 	set(LWS_WITH_SYS_ASYNC_DNS 1)
 	set(LWS_WITH_SYS_ASYNC_DNS_DNSSEC 1)
 	set(LWS_WITH_AUTH_SERVER 1)
+	set(LWS_WITH_SYS_WHOIS 1)
 endif()
 
 if (LWS_WITH_AUTH_SERVER)

CMakeLists.txt

@@ -179,6 +179,7 @@ option(LWS_WITH_SYS_ASYNC_DNS "Nonblocking internal IPv4 + IPv6 DNS resolver" OF
 option(LWS_WITH_SYS_ASYNC_DNS_DNSSEC "Include DNSSEC parsing/validation in async-dns (requires crypto)" OFF)
 option(LWS_WITH_AUTHORITATIVE_DNS "Authoritative DNS zone signer / server" OFF)
 option(LWS_WITH_SYS_NTPCLIENT "Build in tiny ntpclient good for tls date validation and run via lws_system" OFF)
+option(LWS_WITH_SYS_WHOIS "Build in tiny recursive whois client run via lws_system" OFF)
 option(LWS_WITH_SYS_DHCP_CLIENT "Build in tiny DHCP client" OFF)
 option(LWS_WITH_HTTP_BASIC_AUTH "Support Basic Auth" ON)
 option(LWS_WITH_HTTP_DIGEST_AUTH "Support Digest Auth (caution deprecated crypto)" ON)

cmake/lws_config.h.in

@@ -257,6 +257,7 @@
 #cmakedefine LWS_WITH_SYS_FAULT_INJECTION
 #cmakedefine LWS_WITH_SYS_METRICS
 #cmakedefine LWS_WITH_SYS_NTPCLIENT
+#cmakedefine LWS_WITH_SYS_WHOIS
 #cmakedefine LWS_WITH_LATENCY
 #cmakedefine LWS_WITH_UPNG
 #cmakedefine LWS_WITH_SYS_STATE

include/libwebsockets.h

@@ -823,6 +823,7 @@ lws_fx_string(const lws_fx_t *a, char *buf, size_t size);
 
 #include <libwebsockets/lws-ota.h>
 #include <libwebsockets/lws-system.h>
+#include <libwebsockets/lws-whois.h>
 #include <libwebsockets/lws-callbacks.h>
 
 #if defined(LWS_WITH_NETWORK)

include/libwebsockets/lws-misc.h

@@ -798,6 +798,17 @@ LWS_VISIBLE LWS_EXTERN void
 lws_cmdline_option_handle_builtin(int argc, const char **argv,
 				  struct lws_context_creation_info *info);
 
+/**
+ * lws_parse_iso8601() - parse ISO8601 date string into unixtime
+ *
+ * \param ads: the date string to parse
+ *
+ * Returns the unixtime represented by the string, or 0 if parsing failed.
+ * Supports YYYY-MM-DDTHH:MM:SSZ and some common simple variations.
+ */
+LWS_VISIBLE LWS_EXTERN lws_usec_t
+lws_parse_iso8601(const char *ads);
+
 /**
  * lws_now_secs(): return seconds since 1970-1-1
  */

include/libwebsockets/lws-whois.h

@@ -0,0 +1,70 @@
+/*
+ * libwebsockets - small server side websockets and web server implementation
+ *
+ * Copyright (C) 2010 - 2026 Andy Green <andy@warmcat.com>
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to
+ * deal in the Software without restriction, including without limitation the
+ * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or
+ * sell copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+ * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
+ * IN THE SOFTWARE.
+ */
+
+/** \defgroup whois WHOIS Client
+ * ##WHOIS Client APIs
+ */
+///@{
+
+struct lws_whois_results {
+	lws_usec_t		creation_date;
+	lws_usec_t		expiry_date;
+	lws_usec_t		updated_date;
+	char			nameservers[256];
+	char			dnssec[64];
+	char			ds_data[512];
+};
+
+typedef void (*lws_whois_cb_t)(void *opaque, const struct lws_whois_results *res);
+
+struct lws_whois_args {
+	struct lws_context	*context;
+	/**< The lws context to run the query in */
+	const char		*domain;
+	/**< The domain name to query */
+	const char		*server;
+	/**< Optional: The WHOIS server to query directly. If NULL, recursive
+	 * lookup starting from whois.iana.org is performed. */
+	lws_whois_cb_t		cb;
+	/**< Callback to receive results. Called once when query completes or fails. */
+	void			*opaque;
+	/**< User-supplied pointer passed to the callback */
+};
+
+/**
+ * lws_whois_query() - Trigger a WHOIS query for a domain
+ *
+ * \param args: struct containing query parameters
+ *
+ * Returns 0 if the query was successfully initiated, or nonzero if failed.
+ * The results are delivered asynchronously via the callback in args.
+ */
+#if defined(LWS_WITH_SYS_WHOIS)
+LWS_VISIBLE LWS_EXTERN int
+lws_whois_query(const struct lws_whois_args *args);
+#else
+#define lws_whois_query(_a) (1)
+#endif
+
+///@}

lib/core/context.c

@@ -1433,6 +1433,9 @@ lws_create_context(const struct lws_context_creation_info *info)
 #if defined(LWS_WITH_SYS_DHCP_CLIENT)
 		extern const struct lws_protocols lws_system_protocol_dhcpc4;
 #endif
+#if defined(LWS_WITH_SYS_WHOIS)
+		extern const struct lws_protocols lws_system_protocol_whois;
+#endif
 #if !defined(LWS_PLAT_FREERTOS) && !defined(LWS_PLAT_BAREMETAL) && !defined(LWS_PLAT_ANDROID) && defined(LWS_WITH_NETWORK)
 		extern const struct lws_protocols lws_system_protocol_stdin;
 #endif
@@ -1453,6 +1456,9 @@ lws_create_context(const struct lws_context_creation_info *info)
 #if !defined(LWS_PLAT_FREERTOS) && !defined(LWS_PLAT_BAREMETAL) && !defined(LWS_PLAT_ANDROID) && defined(LWS_WITH_NETWORK)
 		pp[n++] = &lws_system_protocol_stdin;
 #endif
+#if defined(LWS_WITH_SYS_WHOIS)
+		pp[n++] = &lws_system_protocol_whois;
+#endif
 #if defined(LWS_WITH_DIR)
 		pp[n++] = &protocol_lws_dir_notify;
 #endif

lib/core/libwebsockets.c

@@ -2277,3 +2277,33 @@ lws_fx_string(const lws_fx_t *a, char *buf, size_t size)
 
 	return buf;
 }
+
+lws_usec_t
+lws_parse_iso8601(const char *ads)
+{
+	struct tm tm;
+	const char *p = ads;
+
+	if (!ads)
+		return 0;
+
+	memset(&tm, 0, sizeof(tm));
+
+	/* ISO8601 / WHOIS dates: YYYY-MM-DDTHH:MM:SSZ and variants */
+	if (sscanf(p, "%d-%d-%dT%d:%d:%d", &tm.tm_year, &tm.tm_mon, &tm.tm_mday,
+		   &tm.tm_hour, &tm.tm_min, &tm.tm_sec) < 3) {
+		/* Try with space instead of T */
+		if (sscanf(p, "%d-%d-%d %d:%d:%d", &tm.tm_year, &tm.tm_mon, &tm.tm_mday,
+			   &tm.tm_hour, &tm.tm_min, &tm.tm_sec) < 3)
+			return 0;
+	}
+
+	tm.tm_year -= 1900;
+	tm.tm_mon -= 1;
+
+#if defined(LWS_HAVE_TIMEGM)
+	return (lws_usec_t)timegm(&tm);
+#else
+	return (lws_usec_t)mktime(&tm); /* flawed but better than nothing */
+#endif
+}

lib/system/CMakeLists.txt

@@ -64,6 +64,11 @@ if (LWS_WITH_NETWORK)
 		list(APPEND SOURCES
 			system/ntpclient/ntpclient.c)
 	endif()
+	
+	if (LWS_WITH_SYS_WHOIS)
+		list(APPEND SOURCES
+			system/whois/whois.c)
+	endif()
 
 	if (LWS_WITH_SYS_DHCP_CLIENT)
 		list(APPEND SOURCES

lib/system/policy.c

@@ -72,7 +72,7 @@ policy_cb(struct lejp_ctx *ctx, char reason)
 
 static const char *default_policy =
 	"{\n"
-	"    \"dns_base_dir\": \"/etc/dnssec\",\n"
+	"    \"dns_base_dir\": \"/var/dnssec\",\n"
 	"    \"seeds\": [ \"selfdns.org\", \"uk1.selfdns.org\", \"asia1.selfdns.org\" ]\n"
 	"}\n";