Log MySQL Errors

.gitignore

@@ -66,3 +66,4 @@ perf.data.old
 .idea/
 .vscode/
 centrallix-os/tmp/*
+centrallix-os/datasets/

centrallix-doc/Widgets/onepage.html

@@ -5976,7 +5976,7 @@ <h3 class="childproperties">Child Properties:</h3>
 <tr>
 <td class="name">type</td>
 <td class="type">string</td>
-<td class="description">The type of the column: "text", "check", or "image".  "text" is a normal column, and displays the textual value of the data element.  "check" displays a checkmark if the data is non-zero (integers) or for strings if the value is non-empty and not "N" or "No".  "image" displays the image referred to by the pathname contained in the data value.</td>
+<td class="description">The type of the column: "text", "check", "image", or "progress".  "text" is a normal column, and displays the textual value of the data element.  "check" displays a checkmark if the data is non-zero (integers) or for strings if the value is non-empty and not "N" or "No".  "image" displays the image referred to by the pathname contained in the data value. "progress" displays a progress bar, with additional fields such as bar_color, bar_textcollor, and bar_padding.</td>
 </tr>
 <tr>
 <td class="name">width</td>

centrallix-doc/Widgets/table.html

@@ -329,7 +329,7 @@ <h3 class="childproperties">Child Properties:</h3>
 <tr>
 <td class="name">type</td>
 <td class="type">string</td>
-<td class="description">The type of the column: "text", "check", or "image".  "text" is a normal column, and displays the textual value of the data element.  "check" displays a checkmark if the data is non-zero (integers) or for strings if the value is non-empty and not "N" or "No".  "image" displays the image referred to by the pathname contained in the data value.</td>
+<td class="description">The type of the column: "text", "check", "image", or "progress".  "text" is a normal column, and displays the textual value of the data element.  "check" displays a checkmark if the data is non-zero (integers) or for strings if the value is non-empty and not "N" or "No".  "image" displays the image referred to by the pathname contained in the data value. "progress" displays a progress bar, with additional fields such as bar_color, bar_textcollor, and bar_padding.</td>
 </tr>
 <tr>
 <td class="name">width</td>

centrallix-doc/Widgets/widgets.xml

@@ -3735,7 +3735,7 @@ myTabControl "widget/tab"
 
 				<childproperty name="title" type="string">The title of the column to be displayed in the header row.</childproperty>
 
-				<childproperty name="type" type="string">The type of the column: "text", "check", or "image".  "text" is a normal column, and displays the textual value of the data element.  "check" displays a checkmark if the data is non-zero (integers) or for strings if the value is non-empty and not "N" or "No".  "image" displays the image referred to by the pathname contained in the data value.</childproperty>
+				<childproperty name="type" type="string">The type of the column: "text", "check", "image", or "progress".  "text" is a normal column, and displays the textual value of the data element.  "check" displays a checkmark if the data is non-zero (integers) or for strings if the value is non-empty and not "N" or "No".  "image" displays the image referred to by the pathname contained in the data value. "progress" displays a progress bar, with additional fields such as bar_color, bar_textcollor, and bar_padding.</childproperty>
 
 				<childproperty name="width" type="integer">width of the column.</childproperty>
 

centrallix-lib/Makefile.in

@@ -59,14 +59,14 @@ LIBS = @LIBS@ -lm
 ##
 PROFILE=@PROFILE@
 COVERAGE=@COVERAGE@
-CFLAGS=@CFLAGS@ @DEFS@ -Iinclude -DCXLIB_INTERNAL -DNM_USE_SYSMALLOC -Wall $(PROFILE) $(COVERAGE) -g
+CFLAGS=@CFLAGS@ @DEFS@ -Iinclude -DCXLIB_INTERNAL -DNM_USE_SYSMALLOC -Wall $(PROFILE) $(COVERAGE) -g -lm
 MTCFLAGS=@CFLAGS@ @DEFS@ -Iinclude -DCXLIB_INTERNAL -DNM_USE_SYSMALLOC -Wall $(PROFILE) $(COVERAGE) -g -O0
 TCFLAGS=$(patsubst -DNDEBUG,,$(CFLAGS))
 
-XSTATICFILES=mtask.o mtlexer.o memstr.o xarray.o xhash.o xstring.o mtsession.o newmalloc.o xhashqueue.o bdqs_transport.o xhandle.o xringqueue.o cxsec.o smmalloc.o qprintf.o strtcpy.o util.o
+XSTATICFILES=mtask.o mtlexer.o memstr.o xarray.o xhash.o xstring.o mtsession.o newmalloc.o xhashqueue.o bdqs_transport.o xhandle.o xringqueue.o cxsec.o smmalloc.o clusters.o qprintf.o strtcpy.o util.o timer.o check.o range.o
 STATICFILES=$(patsubst %,src/%,$(XSTATICFILES))
 
-XDYNAMICFILES=mtask.lo mtlexer.lo memstr.lo xarray.lo xhash.lo xstring.lo mtsession.lo newmalloc.lo xhashqueue.lo bdqs_transport.lo xhandle.lo xringqueue.lo cxsec.lo smmalloc.lo qprintf.lo strtcpy.lo util.lo
+XDYNAMICFILES=mtask.lo mtlexer.lo memstr.lo xarray.lo xhash.lo xstring.lo mtsession.lo newmalloc.lo xhashqueue.lo bdqs_transport.lo xhandle.lo xringqueue.lo cxsec.lo smmalloc.lo clusters.lo qprintf.lo strtcpy.lo util.lo timer.lo check.lo range.lo
 DYNAMICFILES=$(patsubst %,src/%,$(XDYNAMICFILES))
 
 INCLUDEFILES:=$(wildcard include/*.h)

centrallix-lib/configure

@@ -3355,6 +3355,45 @@ _ACEOF
 
 fi
 
+{ $as_echo "$as_me:${as_lineno-$LINENO}: checking for main in -lm" >&5
+$as_echo_n "checking for main in -lm... " >&6; }
+if ${ac_cv_lib_m_main+:} false; then :
+  $as_echo_n "(cached) " >&6
+else
+  ac_check_lib_save_LIBS=$LIBS
+LIBS="-lm  $LIBS"
+cat confdefs.h - <<_ACEOF >conftest.$ac_ext
+/* end confdefs.h.  */
+
+
+int
+main ()
+{
+return main ();
+  ;
+  return 0;
+}
+_ACEOF
+if ac_fn_c_try_link "$LINENO"; then :
+  ac_cv_lib_m_main=yes
+else
+  ac_cv_lib_m_main=no
+fi
+rm -f core conftest.err conftest.$ac_objext \
+    conftest$ac_exeext conftest.$ac_ext
+LIBS=$ac_check_lib_save_LIBS
+fi
+{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $ac_cv_lib_m_main" >&5
+$as_echo "$ac_cv_lib_m_main" >&6; }
+if test "x$ac_cv_lib_m_main" = xyes; then :
+  cat >>confdefs.h <<_ACEOF
+#define HAVE_LIBM 1
+_ACEOF
+
+  LIBS="-lm $LIBS"
+
+fi
+
 
 ac_ext=c
 ac_cpp='$CPP $CPPFLAGS'

centrallix-lib/configure.ac

@@ -18,6 +18,7 @@ dnl Checks for libraries.
 dnl Replace `main' with a function in -lz:
 AC_CHECK_LIB(z, main)
 AC_CHECK_LIB(crypt, main)
+AC_CHECK_LIB(m, main)
 
 dnl Checks for header files.
 AC_HEADER_STDC

centrallix-lib/include/check.h

@@ -0,0 +1,100 @@
+#ifndef CHECK_H
+#define	CHECK_H
+
+/************************************************************************/
+/* Centrallix Application Server System                                 */
+/* Centrallix Base Library                                              */
+/*                                                                      */
+/* Copyright (C) 1998-2026 LightSys Technology Services, Inc.           */
+/*                                                                      */
+/* You may use these files and this library under the terms of the      */
+/* GNU Lesser General Public License, Version 2.1, contained in the     */
+/* included file "COPYING".                                             */
+/*                                                                      */
+/* Module:      check.c, check.h                                        */
+/* Author:      Israel Fuller                                           */
+/* Date:        October 13, 2025                                        */
+/* Description: A utility to help with error checking on function       */
+/*              return values, especially for library functions.        */
+/************************************************************************/
+
+#include <errno.h>
+#include <math.h>
+#include <string.h>
+
+#include "expect.h"
+
+/** File name macro, expanding functionality like __FILE__ and __LINE__. **/
+#define __FILENAME__ \
+    ({ \
+    const char* last_directory = strrchr(__FILE__, '/'); \
+    ((last_directory != NULL) ? last_directory + 1 : __FILE__); \
+    })
+
+/** Internal error printer (forward declaration). **/
+void printErrInternal(const int error_code, const char* c_str, const char* file_name, const int line_number);
+
+#define printErr(error_code, c_str) printErrInternal(error_code, (c_str), __FILE__, __LINE__)
+#define printFail(c_str) do { errno = 0; printErr(-1, (c_str)); } while (0)
+
+/*** Ensures that developer diagnostics are printed if the result of the
+ *** passed function call is not zero.  Not intended for user errors.
+ *** 
+ *** @param result The expression to check.  The text of this expression is
+ *** 	included in the error message if an error occurs.
+ *** @returns The result of the checked expression.
+ ***/
+#define check(result) \
+    ({ \
+	errno = 0; /* Reset errno to prevent confusion. */ \
+	int _r = (result); \
+	if (UNLIKELY(_r != 0)) printErr(_r, #result" failed"); \
+	_r; \
+    })
+
+/*** Ensures that developer diagnostics are printed if the result of the
+ *** passed function call is negative. Not intended for user errors.
+ *** 
+ *** @param result The expression to check.  The text of this expression is
+ *** 	included in the error message if an error occurs.
+ *** @returns The result of the checked expression.
+ ***/
+#define checkNeg(result) \
+    ({ \
+	errno = 0; /* Reset errno to prevent confusion. */ \
+	int _r = (result); \
+	if (UNLIKELY(_r < 0)) printErr(_r, #result" failed"); \
+	_r; \
+    })
+
+/*** Ensures that developer diagnostics are printed if the result of the
+ *** passed function call is a NAN double. Not intended for user errors.
+ *** 
+ *** @param result The expression to check.  The text of this expression is
+ *** 	included in the error message if an error occurs.
+ *** @returns The result of the checked expression.
+ ***/
+#define checkDouble(result) \
+    ({ \
+	errno = 0; /* Reset errno to prevent confusion. */ \
+	double _r = (result); \
+	if (UNLIKELY(isnan(_r))) printErr(-1, #result" failed"); \
+	_r; \
+    })
+
+/*** Ensures that developer diagnostics are printed if the result of the
+ *** passed function call is a NULL pointer. Not intended for user errors.
+ *** 
+ *** @param result The expression to check.  The text of this expression is
+ *** 	included in the error message if an error occurs.
+ *** @returns The result of the checked expression.
+ ***/
+#define checkPtr(result) \
+    ({ \
+	errno = 0; /* Reset errno to prevent confusion. */ \
+	void* _r = (result); \
+	if (UNLIKELY(_r == NULL)) printErr(-1, #result" failed"); \
+	_r; \
+    })
+
+#endif	/* CHECK_H */

centrallix-lib/include/clusters.h

@@ -0,0 +1,161 @@
+#ifndef CLUSTERS_H
+#define	CLUSTERS_H
+
+/************************************************************************/
+/* Centrallix Application Server System					*/
+/* Centrallix Core							*/
+/* 									*/
+/* Copyright (C) 1998-2026 LightSys Technology Services, Inc.		*/
+/* 									*/
+/* This program is free software; you can redistribute it and/or modify	*/
+/* it under the terms of the GNU General Public License as published by	*/
+/* the Free Software Foundation; either version 2 of the License, or	*/
+/* (at your option) any later version.					*/
+/* 									*/
+/* This program is distributed in the hope that it will be useful,	*/
+/* but WITHOUT ANY WARRANTY; without even the implied warranty of	*/
+/* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the	*/
+/* GNU General Public License for more details.				*/
+/* 									*/
+/* You should have received a copy of the GNU General Public License	*/
+/* along with this program; if not, write to the Free Software		*/
+/* Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA		*/
+/* 02111-1307  USA							*/
+/* 									*/
+/* A copy of the GNU General Public License has been included in this	*/
+/* distribution in the file "COPYING".					*/
+/* 									*/
+/* Module:	lib_cluster.c, lib_cluster.h				*/
+/* Author:	Israel Fuller						*/
+/* Creation:	September 29, 2025					*/
+/* Description	Clustering library used to cluster and search data with	*/
+/*		cosine or Levenshtein (aka. edit distance) similarity 	*/
+/*		measures. Used by the "clustering driver".		*/
+/*		For more information on how to use this library, see	*/
+/*		string-similarity.md in the centrallix-sysdoc folder.	*/
+/************************************************************************/
+
+#include <stdlib.h>
+#include <stdbool.h>
+
+#ifdef CXLIB_INTERNAL
+#include "xarray.h"
+#else
+#include "cxlib/xarray.h"
+#endif
+
+/** This file has additional documentation in string_similarity.md. **/
+
+
+/*** This value defines the number of dimensions used for a sparse
+ *** vector.  The higher the number, the fewer collisions will be
+ *** encountered when using these vectors for cosine comparisons.
+ *** This is also called the vector table size, if viewing the
+ *** vector as a hash table of character pairs.
+ *** 
+ *** 2147483647 is the signed int max, and is also a prime number.
+ *** Using this value ensures that the longest run of 0s will not
+ *** cause an int underflow with the current encoding scheme.
+ *** 
+ *** Unfortunately, we can't use a number this large yet because
+ *** kmeans algorithm creates densely allocated centroids with
+ *** `CA_NUM_DIMS` dimensions, so a large number causes it to fail.
+ *** This, we use 251 as the largest prime number less than 256,
+ *** giving us a decent balance between collision reduction and
+ *** kmeans centroid performance/memory overhead.
+ ***/
+#define CA_NUM_DIMS 251
+
+/*** The character used to create a pair with the first and last characters
+ *** of a string.  Currently set to 96, the character just before 'a' (97)
+ *** in the ASCII table.
+ ***/
+#define CA_BOUNDARY_CHAR ((unsigned char)('a' - 1))
+
+/** Types. **/
+typedef int* pVector;      /* Sparse vector. */
+typedef double* pCentroid; /* Dense centroid. */
+#define CENTROID_SIZE (CA_NUM_DIMS * sizeof(double))
+
+/*** Information about detected matching pairs.
+ ***
+ *** @param i The index into the provided data for the first element of the pair.
+ *** @param j The index into the provided data for the second element of the pair.
+ *** @param similarity A number from 0 to 1, from a similarity function, showing
+ *** 	how similar the pairs are.
+ ***/
+typedef struct
+    {
+    unsigned int i, j;
+    double similarity;
+    }
+    Pair, *pPair;
+
+
+/** Edit distance function. **/
+int ca_edit_dist(const char* str1, const char* str2, const size_t str1_length, const size_t str2_length);
+
+/** Vector functions. **/
+pVector ca_build_vector(const char* str);
+unsigned int ca_sparse_len(const pVector vector);
+void ca_print_vector(const pVector vector);
+void ca_free_vector(pVector sparse_vector);
+
+/** k-means function. **/
+int ca_kmeans(
+    pVector* vectors,
+    const unsigned int num_vectors,
+    const unsigned int num_clusters,
+    const unsigned int max_iter,
+    const double min_improvement,
+    unsigned int* labels,
+    double* vector_sims,
+    bool auto_seed);
+
+/** Vector helper macros. **/
+#define ca_is_empty(vector) (vector[0] == -CA_NUM_DIMS)
+/*** Note: Given that CA_NUM_DIMS == 251, ca_build_vector("") will give the
+ *** vector we check for in the ca_has_no_pairs() macro, [-172, 11, -78],
+ *** which has a single pair of boundary characters.
+ *** If CA_NUM_DIMS is modified, this macro will need to be updated, hence the
+ *** compiler directive causing it to be undefined in this case, likely leading
+ *** to a lot of compiler or linker issues to remind the developer about this.
+ ***/
+#if CA_NUM_DIMS == 251
+#define ca_has_no_pairs(vector) \
+    ({ \
+	__typeof__ (vector) _v = (vector); \
+	_v[0] == -172 && _v[1] == 11 && _v[2] == -78; \
+    })
+#endif
+
+/** Comparison functions (see ca_search()). **/
+double ca_cos_compare(void* v1, void* v2);
+double ca_lev_compare(void* str1, void* str2);
+bool ca_eql(pVector v1, pVector v2);
+
+/** Similarity search functions. **/
+void* ca_most_similar(
+    void* target,
+    void** data,
+    const unsigned int num_data,
+    double (*similarity)(void*, void*),
+    const double threshold);
+pXArray ca_sliding_search(
+    void** data,
+    const unsigned int num_data,
+    const unsigned int window_size,
+    double (*similarity)(void*, void*),
+    const double threshold,
+    pXArray maybe_pairs);
+pXArray ca_complete_search(
+    void** data,
+    const unsigned int num_data,
+    double (*similarity)(void*, void*),
+    const double threshold,
+    pXArray maybe_pairs);
+
+/** Module management functions. **/
+void ca_init(void);
+
+#endif /* End of .h file. */

centrallix-lib/include/cxlibconfig-all.h.in

@@ -21,6 +21,9 @@
 /* Define to 1 if you have the `crypt' library (-lcrypt). */
 #undef HAVE_LIBCRYPT
 
+/* Define to 1 if you have the `m' library (-lm). */
+#undef HAVE_LIBM
+
 /* Define to 1 if you have the `z' library (-lz). */
 #undef HAVE_LIBZ