ext/pcntl: pcntl_getqos_class/pcntl_setqos_class addition.

Introducting macOs Quality Of Service through those two calls.
on macOs arm64/M*, there is no concept of individual cores, thus
the old thread policy for cpu affinity does not work here.
Instead, the user can apply to the current process the level of
 performance/energy consumption they wish from the highest
QOS_CLASS_USER_INTERACTIVE to QOS_CLASS_BACKGROUND.

Author: devnexen

ext/pcntl/config.m4

@@ -7,7 +7,7 @@ if test "$PHP_PCNTL" != "no"; then
   AC_CHECK_FUNCS([fork], [], [AC_MSG_ERROR([pcntl: fork() not supported by this platform])])
   AC_CHECK_FUNCS([waitpid], [], [AC_MSG_ERROR([pcntl: waitpid() not supported by this platform])])
   AC_CHECK_FUNCS([sigaction], [], [AC_MSG_ERROR([pcntl: sigaction() not supported by this platform])])
-  AC_CHECK_FUNCS([getpriority setpriority wait3 wait4 sigwaitinfo sigtimedwait unshare rfork forkx pidfd_open sched_setaffinity])
+  AC_CHECK_FUNCS([getpriority setpriority wait3 wait4 sigwaitinfo sigtimedwait unshare rfork forkx pidfd_open sched_setaffinity pthread_set_qos_class_self_np])
 
   dnl if unsupported, -1 means automatically ENOSYS in this context
   AC_MSG_CHECKING([if sched_getcpu is supported])

ext/pcntl/pcntl.c

@@ -51,6 +51,10 @@ typedef cpuset_t cpu_set_t;
 #endif
 #endif
 
+#if defined(HAVE_PTHREAD_SET_QOS_CLASS_SELF_NP)
+#include <pthread/qos.h>
+#endif
+
 #ifdef HAVE_PIDFD_OPEN
 #include <sys/syscall.h>
 #endif
@@ -1622,6 +1626,43 @@ PHP_FUNCTION(pcntl_getcpu)
 }
 #endif
 
+#if defined(HAVE_PTHREAD_SET_QOS_CLASS_SELF_NP)
+PHP_FUNCTION(pcntl_getqos_class)
+{
+	qos_class_t qos_class;
+
+	ZEND_PARSE_PARAMETERS_NONE();
+
+	if (UNEXPECTED(pthread_get_qos_class_np(pthread_self(), &qos_class, NULL) != 0))
+	{
+		// unlikely unless an external tool set the QOS class with a wrong value
+		PCNTL_G(last_error) = errno;
+		zend_value_error("invalid QOS class %u", qos_class);
+		RETURN_THROWS();
+	}
+
+	RETURN_LONG((zend_long)qos_class);
+}
+
+PHP_FUNCTION(pcntl_setqos_class)
+{
+	zend_long qos_class = QOS_CLASS_DEFAULT;
+
+	ZEND_PARSE_PARAMETERS_START(1, 1)
+		Z_PARAM_LONG(qos_class)
+	ZEND_PARSE_PARAMETERS_END();
+
+	if (pthread_set_qos_class_self_np((qos_class_t)qos_class, 0) != 0)
+	{
+		PCNTL_G(last_error) = errno;
+		zend_argument_value_error(1, "must be between QOS_CLASS_USER_INTERACTIVE and QOS_CLASS_BLACKGROUND");
+		RETURN_THROWS();
+	}
+
+	RETURN_TRUE;
+}
+#endif
+
 static void pcntl_interrupt_function(zend_execute_data *execute_data)
 {
 	pcntl_signal_dispatch();

ext/pcntl/pcntl.stub.php

@@ -905,6 +905,39 @@
 const PCNTL_ECAPMODE = UNKNOWN;
 #endif
 
+#ifdef HAVE_PTHREAD_SET_QOS_CLASS_SELF_NP
+/**
+ * @var int
+ * @cvalue QOS_CLASS_USER_INTERACTIVE
+ */
+const QOS_CLASS_USER_INTERACTIVE = UNKNOWN;
+/**
+ * @var int
+ * @cvalue QOS_CLASS_USER_INITIATED
+ */
+const QOS_CLASS_USER_INITIATED = UNKNOWN;
+/**
+ * @var int
+ * @cvalue QOS_CLASS_DEFAULT
+ */
+const QOS_CLASS_DEFAULT = UNKNOWN;
+/**
+ * @var int
+ * @cvalue QOS_CLASS_UTILITY
+ */
+const QOS_CLASS_UTILITY = UNKNOWN;
+/**
+ * @var int
+ * @cvalue QOS_CLASS_BACKGROUND
+ */
+const QOS_CLASS_BACKGROUND = UNKNOWN;
+/**
+ * @var int
+ * @cvalue QOS_CLASS_UNSPECIFIED
+ */
+const QOS_CLASS_UNSPECIFIED = UNKNOWN;
+#endif
+
 function pcntl_fork(): int {}
 
 /**
@@ -1003,3 +1036,8 @@ function pcntl_setcpuaffinity(?int $process_id = null, array $cpu_ids = []): boo
 #ifdef HAVE_SCHED_GETCPU
 function pcntl_getcpu(): int {}
 #endif
+
+#ifdef HAVE_PTHREAD_SET_QOS_CLASS_SELF_NP
+function pcntl_getqos_class(): int {}
+function pcntl_setqos_class(int $qos_class = QOS_CLASS_DEFAULT): bool {}
+#endif

ext/pcntl/pcntl_arginfo.h

@@ -0,0 +1,28 @@
+--TEST--
+pcntl_getqos_class()/pcntl_setqos_class()
+--EXTENSIONS--
+pcntl
+--SKIPIF--
+<?php
+if (!function_exists("pcntl_getqos_class")) die("skip pcntl_getqos_class() is not available");
+if (getenv('SKIP_REPEAT')) die("skip Not repeatable");
+?>
+--FILE--
+<?php
+var_dump(pcntl_setqos_class(QOS_CLASS_DEFAULT));
+var_dump(QOS_CLASS_DEFAULT === pcntl_getqos_class());
+
+try {
+	pcntl_setqos_class(QOS_CLASS_UNSPECIFIED);
+} catch (\ValueError $e) {
+	echo $e->getMessage() . PHP_EOL;
+}
+var_dump(pcntl_setqos_class(QOS_CLASS_BACKGROUND));
+var_dump(QOS_CLASS_BACKGROUND === pcntl_getqos_class());
+?>
+--EXPECT--
+bool(true)
+bool(true)
+pcntl_setqos_class(): Argument #1 ($qos_class) must be between QOS_CLASS_USER_INTERACTIVE and QOS_CLASS_BLACKGROUND
+bool(true)
+bool(true)