Linux Man на русском

  User    Syst    Libr    Device    Files    Other    Admin  



   getcpu - определяет ЦП и узел NUMA, на котором выполняется вызывающая нить

getcpu(2) определяет ЦП и узел NUMA, на котором выполняется вызывающая нить


ОБЗОР

#include <linux/getcpu.h>


int getcpu(unsigned *cpu, unsigned *node, struct getcpu_cache *tcache);

Замечание: в glibc нет обёрточной функции для данного системного вызова; смотрите


ЗАМЕЧАНИЯ.


ОПИСАНИЕ

Системный вызов getcpu() определяет процессор и узел, на котором вызывающая нить или процесс выполняются в данный момент и записывает их в виде целых чисел в память, на которую указывают аргументы cpu и node. Процессор представляется в виде уникального малого целого числа, закреплённого за определённым ЦП. Узел представляется в виде уникального идентификатора, закреплённого за определённым узлом NUMA. Если значение cpu или node равно NULL, то по соответствующему указателю ничего не записывается.

Третий аргумент этого системного вызова в настоящее время не используется и указываться как NULL, не требуется переносимость на Linux 2.6.23 или более младшие версии (смотрите


ЗАМЕЧАНИЯ).

Информация, помещаемая в cpu, будет находиться там только на время вызова: unless the CPU affinity has been fixed using sched_setaffinity(2), the kernel might change the CPU at any time. (Normally this does not happen because the scheduler tries to minimize movements between CPUs to keep caches hot, but it is possible.) Достоверность информации, помещаемой в cpu, гарантируется только на момент вызова: если привязка ЦП не была изменена с помощью sched_setaffinity(2), то ядро может сменить ЦП в любой момент (обычно этого не происходит, так как планировщик пытается минимизировать перемещения задач между процессорами для поддержания актуальности кэша,но всё же это возможно). Вызывающий должен быть готов к ситуации, что информация, возвращённая в cpu и node, может потерять актуальность уже после возврата из вызова.


ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ

При успешном выполнении возвращается 0. В случае ошибки возвращается -1, а errno устанавливается в соответствующее значение.


ОШИБКИ

EFAULT Аргументы указывают за пределы адресного пространства вызывающего процесса.

ВЕРСИИ

Вызов getcpu() был добавлен в ядро 2.6.19 для x86_64 и i386.


СООТВЕТСТВИЕ СТАНДАРТАМ

Вызов getcpu() есть только в Linux.


ЗАМЕЧАНИЯ

Linux старается выполнить данный вызов как можно быстрее. Предназначение getcpu() — позволить программам оптимизировать обработку данных на разных ЦП или выполнить оптимизации NUMA.

В glibc нет обёртки для данного системного вызова; выполняйте его с помощью syscall(2); или используйте вместо него sched_getcpu(3).

Аргумент tcache не используется начиная с Linux 2.6.24. В более старых ядрах, если этот аргумент не равнялся NULL, то в нём задавался указатель на буфер, выделяемый вызывающим в локальном хранилище нити, который использовался для работы механизма кэширования getcpu(). Использование кэша могло бы увеличить скорость работы getcpu(), и расплатой за это было бы возникновение очень маленькой вероятности, что возвращаемая информация устарела. Кэширующий механизм стал рассматриваться как вызывающий проблемы при перемещения нитей между ЦП, и поэтому теперь этот аргумент игнорируется.