From 9c5c74bed9033b48f68b17225f07466a211552f0 Mon Sep 17 00:00:00 2001 From: Mikhail Alferov Date: Mon, 15 Jun 2026 16:08:05 +0300 Subject: [PATCH 1/4] Update pcntl-getqos-class.xml to en --- .../pcntl/functions/pcntl-getqos-class.xml | 24 +++++++++++++------ 1 file changed, 17 insertions(+), 7 deletions(-) diff --git a/reference/pcntl/functions/pcntl-getqos-class.xml b/reference/pcntl/functions/pcntl-getqos-class.xml index 56cfd276e..f458d5fcd 100644 --- a/reference/pcntl/functions/pcntl-getqos-class.xml +++ b/reference/pcntl/functions/pcntl-getqos-class.xml @@ -1,10 +1,10 @@ - + pcntl_getqos_class - Получает текущий QoS-класс процесса + Получает QoS-класс текущего потока @@ -14,10 +14,11 @@ - Функция возвращает текущий класс качества обслуживания (англ. Quality of Service, сокр. QoS) вызывающего процесса. - Функция доступна только на macOS, которая управляет энергоэффективностью и производительностью - на основе QoS-класса. + Функция возвращает QoS-класс текущего потока. + + Функция доступна только на платформах Apple. + @@ -28,8 +29,16 @@ &reftitle.returnvalues; - Функция возвращает вариант перечисления Pcntl\QosClass, - который представляет текущий QoS-класс. + Функция возвращает вариант перечисления Pcntl\QosClass, + который соответствует QoS-классу текущего потока. + + + + + &reftitle.errors; + + Функция выбрасывает ошибку Error, если при вызове нижележащей функции + pthread_get_qos_class_np() возникла ошибка. @@ -37,6 +46,7 @@ &reftitle.seealso; pcntl_setqos_class + Pcntl\QosClass From 921aedc57f4cdc1289f8485668dfb4e576155c22 Mon Sep 17 00:00:00 2001 From: Mikhail Alferov Date: Mon, 15 Jun 2026 16:14:11 +0300 Subject: [PATCH 2/4] Update pcntl-setqos-class.xml to en --- .../pcntl/functions/pcntl-setqos-class.xml | 93 +++++++++++++++---- 1 file changed, 76 insertions(+), 17 deletions(-) diff --git a/reference/pcntl/functions/pcntl-setqos-class.xml b/reference/pcntl/functions/pcntl-setqos-class.xml index 1b2569b66..f4befbb43 100644 --- a/reference/pcntl/functions/pcntl-setqos-class.xml +++ b/reference/pcntl/functions/pcntl-setqos-class.xml @@ -1,22 +1,20 @@ - + pcntl_setqos_class - Устанавливает QoS-класс процесса + Устанавливает QoS-класс текущему потоку &reftitle.description; voidpcntl_setqos_class - Pcntl\QosClassqos_classPcntl\QosClass::Default + Pcntl\QosClassqos_classPcntl\QosClass::Default - Функция устанавливает класс качества обслуживания (англ. Quality of Service, сокр. QoS) вызывающего процесса. - Функция доступна только на macOS, которая управляет энергоэффективностью и производительностью - на основе QoS-класса. + Функция устанавливает QoS-класс текущему потоку. @@ -26,20 +24,72 @@ qos_class - - QoS-класс, который требуется установить. Параметр принимает вариант перечисления - Pcntl\QosClass: - - - Pcntl\QosClass::UserInteractive - Pcntl\QosClass::UserInitiated - Pcntl\QosClass::Default - Pcntl\QosClass::Utility - Pcntl\QosClass::Background - + + Класс качества обслуживания (англ. Quality of Service, сокр. QoS), который требуется назначить текущему потоку. + Операционная система опирается на класс как на подсказку для планирования процессорного времени, приоритета ввода-вывода + и энергопотребления, при этом более высокие классы вытесняют более низкие. + Доступные варианты классов качества описывает страница перечисления Pcntl\QosClass. + + + + + Pcntl\QosClass::UserInteractive + + + Наивысший приоритет. Приоритет указывают для задач, которые непосредственно влияют на пользовательский интерфейс + и требуют практически мгновенного завершения, чтобы пользователь не воспринимал промедление при отрисовке + или обработке задания как задержку. + + + + + Pcntl\QosClass::UserInitiated + + + Наивысший приоритет, но ниже приоритета UserInteractive. + Класс указывают для задачи, которую пользователь явно инициировал + и активно ожидает завершения в течение нескольких секунд. + + + + + Pcntl\QosClass::Default + + + Стандартный приоритет, который применяется, если не назначили более конкретный. + Задачи со стандартным приоритетом выполняются после задач с более высоким приоритетом, + но раньше задач с приоритетами Utility и Background. + + + + + Pcntl\QosClass::Utility + + + Более низкий приоритет, предназначен для длительных задач, о которых пользователь знает, + но которые активно не ожидает, например, загрузки, импорт или массовые вычисления. + Задачи с таким приоритетом планируются энергоэффективным способом. + + + + + Pcntl\QosClass::Background + + + Низший приоритет для фоновых задач наподобие предварительной загрузки, индексирования или технического обслуживания. + Приоритет до предела оптимизировали для повышения энергоэффективности, а система умеет откладывать запуск задач + с самым низким приоритетом, пока работает под нагрузкой. + + + + + + + Функция доступна только на платформах Apple. + @@ -49,10 +99,19 @@ + + &reftitle.errors; + + Функция выбрасывает ошибку Error, если при вызове нижележащей функции + pthread_set_qos_class_self_np() возникла ошибка. + + + &reftitle.seealso; pcntl_getqos_class + Pcntl\QosClass From edfd319d86280a742b42f8e084ab8627c7535f54 Mon Sep 17 00:00:00 2001 From: Mikhail Alferov Date: Mon, 15 Jun 2026 16:15:40 +0300 Subject: [PATCH 3/4] Delete reference/pcntl/functions/pcntl_getqos_class.xml --- .../pcntl/functions/pcntl_getqos_class.xml | 72 ------------------- 1 file changed, 72 deletions(-) delete mode 100644 reference/pcntl/functions/pcntl_getqos_class.xml diff --git a/reference/pcntl/functions/pcntl_getqos_class.xml b/reference/pcntl/functions/pcntl_getqos_class.xml deleted file mode 100644 index 1b8e7be9b..000000000 --- a/reference/pcntl/functions/pcntl_getqos_class.xml +++ /dev/null @@ -1,72 +0,0 @@ - - - - - - pcntl_getqos_class - Получает класс QoS текущего потока - - - - &reftitle.description; - - Pcntl\QosClasspcntl_getqos_class - - - - Функция возвращает QoS-класс текущего потока. - - - Функция доступна только на платформах Apple. - - - - - &reftitle.parameters; - &no.function.parameters; - - - - &reftitle.returnvalues; - - Функция возвращает вариант перечисления Pcntl\QosClass. - - - - - &reftitle.errors; - - Функция выбрасывает ошибку Error, если при вызове нижележащей функции - pthread_get_qos_class_np() возникла ошибка. - - - - - &reftitle.seealso; - - pcntl_setqos_class - Pcntl\QosClass - - - - - From 253885908cee1257d74fb7ee80fe3c6010b71df6 Mon Sep 17 00:00:00 2001 From: Mikhail Alferov Date: Mon, 15 Jun 2026 16:15:49 +0300 Subject: [PATCH 4/4] Delete reference/pcntl/functions/pcntl_setqos_class.xml --- .../pcntl/functions/pcntl_setqos_class.xml | 138 ------------------ 1 file changed, 138 deletions(-) delete mode 100644 reference/pcntl/functions/pcntl_setqos_class.xml diff --git a/reference/pcntl/functions/pcntl_setqos_class.xml b/reference/pcntl/functions/pcntl_setqos_class.xml deleted file mode 100644 index 064edf35d..000000000 --- a/reference/pcntl/functions/pcntl_setqos_class.xml +++ /dev/null @@ -1,138 +0,0 @@ - - - - - - pcntl_setqos_class - Устанавливает класс QoS для текущего потока - - - - &reftitle.description; - - voidpcntl_setqos_class - Pcntl\QosClassqos_classPcntl\QosClass::Default - - - Функция устанавливает QoS-класс для текущего потока. - - - - - &reftitle.parameters; - - - qos_class - - - Класс качества обслуживания (англ. Quality of Service, сокр. QoS), который требуется назначить текущему потоку. - Операционная система опирается на класс как на подсказку для планирования процессорного времени, приоритета ввода-вывода - и энергопотребления, при этом более высокие классы вытесняют более низкие. - Доступные варианты классов качества описывает страница перечисления Pcntl\QosClass. - - - - - Pcntl\QosClass::UserInteractive - - - Наивысший приоритет. Приоритет указывают для задач, которые непосредственно влияют на пользовательский интерфейс - и требуют практически мгновенного завершения, чтобы пользователь не воспринимал промедление при отрисовке - или обработке задания как задержку. - - - - - Pcntl\QosClass::UserInitiated - - - Наивысший приоритет, но ниже приоритета UserInteractive. - Класс указывают для задачи, которую пользователь явно инициировал - и активно ожидает завершения в течение нескольких секунд. - - - - - Pcntl\QosClass::Default - - - Стандартный приоритет, который применяется, если не назначили более конкретный. - Задачи со стандартным приоритетом выполняются после задач с более высоким приоритетом, - но раньше задач с приоритетами Utility и Background. - - - - - Pcntl\QosClass::Utility - - - Более низкий приоритет, предназначен для длительных задач, о которых пользователь знает, - но которые активно не ожидает, например, загрузки, импорт или массовые вычисления. - Задачи с таким приоритетом планируются энергоэффективным способом. - - - - - Pcntl\QosClass::Background - - - Низший приоритет для фоновых задач наподобие предварительной загрузки, индексирования или технического обслуживания. - Приоритет до предела оптимизировали для повышения энергоэффективности, а система умеет откладывать запуск задач - с самым низким приоритетом, пока работает под нагрузкой. - - - - - - - - - - Функция доступна только на платформах Apple. - - - - - &reftitle.returnvalues; - - &return.void; - - - - - &reftitle.errors; - - Функция выбрасывает ошибку Error, если при вызове нижележащей функции - pthread_set_qos_class_self_np() возникла ошибка. - - - - - &reftitle.seealso; - - pcntl_getqos_class - Pcntl\QosClass - - - - -