From 063e75b01d83aa7800384251dc44ee2a0abe1966 Mon Sep 17 00:00:00 2001
From: Eric Espie <eric.espie@combodo.com>
Date: Wed, 1 Apr 2026 09:16:30 +0200
Subject: [PATCH] Cron extensibility

---
 .../Cron/CronProcessesManagementException.php | 12 ++++
 .../Cron/CronProcessesNotStoppedException.php | 12 ++++
 .../Cron/iCronProcessesManagement.php         | 63 +++++++++++++++++++
 3 files changed, 87 insertions(+)
 create mode 100644 sources/Application/Cron/CronProcessesManagementException.php
 create mode 100644 sources/Application/Cron/CronProcessesNotStoppedException.php
 create mode 100644 sources/Application/Cron/iCronProcessesManagement.php

diff --git a/sources/Application/Cron/CronProcessesManagementException.php b/sources/Application/Cron/CronProcessesManagementException.php
new file mode 100644
index 0000000000..b50ac25daf
--- /dev/null
+++ b/sources/Application/Cron/CronProcessesManagementException.php
@@ -0,0 +1,12 @@
+<?php
+
+/*
+ * @copyright   Copyright (C) 2010-2026 Combodo SAS
+ * @license     http://opensource.org/licenses/AGPL-3.0
+ */
+
+namespace Combodo\iTop\Application\Cron;
+
+class CronProcessesManagementException extends \Exception
+{
+}
diff --git a/sources/Application/Cron/CronProcessesNotStoppedException.php b/sources/Application/Cron/CronProcessesNotStoppedException.php
new file mode 100644
index 0000000000..b419740efb
--- /dev/null
+++ b/sources/Application/Cron/CronProcessesNotStoppedException.php
@@ -0,0 +1,12 @@
+<?php
+
+/*
+ * @copyright   Copyright (C) 2010-2026 Combodo SAS
+ * @license     http://opensource.org/licenses/AGPL-3.0
+ */
+
+namespace Combodo\iTop\Application\Cron;
+
+class CronProcessesNotStoppedException extends CronProcessesManagementException
+{
+}
diff --git a/sources/Application/Cron/iCronProcessesManagement.php b/sources/Application/Cron/iCronProcessesManagement.php
new file mode 100644
index 0000000000..787451d081
--- /dev/null
+++ b/sources/Application/Cron/iCronProcessesManagement.php
@@ -0,0 +1,63 @@
+<?php
+
+/*
+ * @copyright   Copyright (C) 2010-2026 Combodo SAS
+ * @license     http://opensource.org/licenses/AGPL-3.0
+ */
+
+namespace Combodo\iTop\Application\Cron;
+
+/**
+ * Interface for managing cron processes, providing methods to retrieve and set
+ * the number of allowed processes, as well as enabling or disabling cron functionality.
+ *
+ * @api
+ * @since 3.x.0
+ */
+interface iCronProcessesManagement
+{
+	/**
+	 * @return array
+	 */
+	public function GetRunningProcesses(): array;
+
+	/**
+	 * Get the current running cron processes count
+	 *
+	 * @return int Number of cron processes currently running
+	 */
+	public function GetRunningProcessesCount(): int;
+
+	/**
+	 * Get the maximum number of processes allowed in parallel
+	 *
+	 * @return int The maximum number of processes allowed in parallel
+	 */
+	public function GetMaxRunningProcesses(): int;
+
+	/**
+	 * Set the maximum number of processes allowed in parallel
+	 *
+	 * @param int $iMaxRunningProcesses The max number of parallel cron allowed
+	 */
+	public function SetMaxRunningProcesses(int $iMaxRunningProcesses): void;
+
+	/**
+	 * Stop the cron on all servers.
+	 * The method only returns when all the processes are stopped even if
+	 * multiple calls are done to this method on multiple servers.
+	 *
+	 * @param int $iWaitLimitInSec Max time in seconds to wait for termination
+	 *
+	 * @return void
+	 * @throws \Combodo\iTop\Application\Cron\CronProcessesNotStoppedException when "wait time limit" is exceeded
+	 */
+	public function StopAndWaitCronTermination(int $iWaitLimitInSec): void;
+
+	/**
+	 * Enables the cron processes to run.
+	 *
+	 * @return void
+	 */
+	public function StartCron(): void;
+}