--- libaitsched/inc/aitsched.h	2022/11/28 23:30:41	1.29.10.3
+++ libaitsched/inc/aitsched.h	2026/05/20 03:07:51	1.35.2.1
@@ -3,7 +3,7 @@
 *  by Michael Pounov <misho@openbsd-bg.org>
 *
 * $Author: misho $
-* $Id: aitsched.h,v 1.29.10.3 2022/11/28 23:30:41 misho Exp $
+* $Id: aitsched.h,v 1.35.2.1 2026/05/20 03:07:51 misho Exp $
 *
 **************************************************************************
 The ELWIX and AITNET software is distributed under the following
@@ -12,7 +12,7 @@ terms:
 All of the documentation and software included in the ELWIX and AITNET
 Releases is copyrighted by ELWIX - Sofia/Bulgaria <info@elwix.org>
 
-Copyright 2004 - 2022
+Copyright 2004 - 2026
 	by Michael Pounov <misho@elwix.org>.  All rights reserved.
 
 Redistribution and use in source and binary forms, with or without
@@ -57,6 +57,14 @@ SUCH DAMAGE.
 #ifdef EVFILT_LIO
 #include <aio.h>
 #endif
+#ifdef ATOMIC_SUPPORT
+#ifndef __cplusplus
+        #include <stdatomic.h>
+#else
+        #include <atomic>
+        #define _Atomic(X) std::atomic<X>
+#endif
+#endif
 
 
 /* criteria type */
@@ -146,6 +154,8 @@ struct sched_HooksTask {
 		sched_hook_func_t	exception;
 		/* condition(sched_root_task_t *root, intptr_t *stopValue) -> int */
 		sched_hook_func_t	condition;
+		/* profile(sched_task_t *root, intptr_t *stageValue) -> int */
+		sched_hook_func_t	profile;
 	}	hook_exec;
 	struct {
 		/* init(sched_root_task_t *root, void *data) -> int */
@@ -202,7 +212,7 @@ struct sched_Task {
 #define TASK_DATA(x)	(x)->task_data.iov_base
 #define TASK_DATLEN(x)	(x)->task_data.iov_len
 
-	void				*task_harg;
+	unsigned long			task_harg;
 #define TASK_HARG(x)	(x)->task_harg
 
 	TAILQ_ENTRY(sched_Task)		task_node;
@@ -224,6 +234,12 @@ struct sched_RootTask {
 	unsigned long	root_miss;
 	intptr_t	root_cond[1];
 	void		*root_ret;
+#ifdef HAVE_LIBPTHREAD
+	pthread_mutex_t	root_sigmtx;
+	pthread_t	root_sigthr;
+	sigset_t	root_sigset;
+	sigset_t	root_oldset;
+#endif
 
 	pthread_mutex_t	root_mtx[taskMAX];
 
@@ -252,7 +268,11 @@ struct sched_RootTask {
 };
 #define ROOT_QUEUE_EMPTY(x, _q)	TAILQ_EMPTY(&((x)->root_##_q))
 #define ROOT_RETURN(x)	(x)->root_ret
+#define ROOT_PROFILING(x, _cb) (x)->root_hooks.hook_exec.profile = (_cb)
 
+#ifdef __cplusplus
+extern "C" {
+#endif
 
 int sched_GetErrno();
 const char *sched_GetError();
@@ -372,10 +392,18 @@ int schedQuery(sched_task_t * __restrict task);
  * 	[ CRITERIA_ANY|CRITERIA_CALL|CRITERIA_ARG|CRITERIA_FD|CRITERIA_VAL|
  * 		CRITERIA_ID|CRITERIA_TS|CRITERIA_DATA|CRITERIA_DATLEN ]
  * @param = search parameter
- * return: -1 error, 0 found or 1 not found
+ * return: NULL not found or !=NULL task
  */
-int schedQueryby(sched_root_task_t * __restrict root, sched_task_type_t type, 
+sched_task_t *schedQueryby(sched_root_task_t * __restrict root, sched_task_type_t type, 
 		unsigned char criteria, void *param);
+/*
+ * schedSignalDispatch() - Activate or Deactivate signal dispatcher
+ *
+ * @root = root task
+ * @on = Activate or =0 deactivate
+ * return: -1 error, 1 already started, 2 another thread already started or 0 ok
+ */
+int schedSignalDispatch(sched_root_task_t * __restrict root, int on);
 
 
 /*
@@ -408,6 +436,20 @@ sched_task_t *schedRead(sched_root_task_t * __restrict
 #define schedReadSelf(x)	schedReadExt(TASK_ROOT((x)), TASK_FUNC((x)), TASK_ARG((x)), \
 		TASK_FD((x)), TASK_DATA((x)), TASK_DATLEN((x)), TASK_HARG((x)))
 /*
+ * schedWriteExt() - Add WRITE I/O task to scheduler queue with custom event mask
+ *
+ * @root = root task
+ * @func = task execution function
+ * @arg = 1st func argument
+ * @fd = fd handle
+ * @opt_data = Optional data
+ * @opt_dlen = Optional data length
+ * @mask = Event mask
+ * return: NULL error or !=NULL new queued task
+ */
+sched_task_t *schedWriteExt(sched_root_task_t * __restrict root, sched_task_func_t func, void *arg, 
+		int fd, void *opt_data, size_t opt_dlen, unsigned long mask);
+/*
  * schedWrite() - Add WRITE I/O task to scheduler queue
  *
  * @root = root task
@@ -420,8 +462,8 @@ sched_task_t *schedRead(sched_root_task_t * __restrict
  */
 sched_task_t *schedWrite(sched_root_task_t * __restrict root, sched_task_func_t func, void *arg, 
 		int fd, void *opt_data, size_t opt_dlen);
-#define schedWriteSelf(x)	schedWrite(TASK_ROOT((x)), TASK_FUNC((x)), TASK_ARG((x)), \
-		TASK_FD((x)), TASK_DATA((x)), TASK_DATLEN((x)))
+#define schedWriteSelf(x)	schedWriteExt(TASK_ROOT((x)), TASK_FUNC((x)), TASK_ARG((x)), \
+		TASK_FD((x)), TASK_DATA((x)), TASK_DATLEN((x)), TASK_HARG((x)))
 /*
  * schedAlarm() - Add ALARM task to scheduler queue
  *
@@ -739,5 +781,8 @@ void *sched_taskExit(sched_task_t *task, intptr_t retc
  */
 #define taskExit(t, x)		return sched_taskExit((t), (intptr_t) (x))
 
+#ifdef __cplusplus
+}
+#endif
 
 #endif