Man page - pthread_attr_setaffinity_np(3)

Packages contains this manual

Available languages:

en fr ja ru ro de

Manual

PTHREAD_ATTR_SETAFFINITY_NP

名 前
書 åŧ
čĒŦ 明
čŋ” り 値
エ ナ ãƒŧ
バ ãƒŧ ジ ョ ãƒŗ
åąž 性
æē– 拠
æŗ¨ 意
é–ĸ é€Ŗ 項 į›Ž
こ ぎ 文 書 ãĢ つ い ãĻ

名 前

pthread_attr_setaffinity_np, pthread_attr_getaffinity_np - ã‚š ãƒŦ ッ ド åąž 性 ã‚Ē ブ ジ ェ ク ト ぎ CPU affinity åąž 性 ぎ 設 厚 /取 åž— を 行 う

書 åŧ

#define _GNU_SOURCE /* See feature_test_macros(7) */
#include <pthread.h>

int pthread_attr_setaffinity_np(pthread_attr_t * attr ,
size_t cpusetsize , const cpu_set_t * cpuset );
int pthread_attr_getaffinity_np(const pthread_attr_t * attr ,
size_t cpusetsize , cpu_set_t * cpuset );

-pthread で ã‚ŗ ãƒŗ パ イ ãƒĢ し ãĻ ãƒĒ ãƒŗ ク す る 。

čĒŦ 明

pthread_attr_setaffinity_np () é–ĸ 数 は 、 attr が 参 į…§ す る ã‚š ãƒŦ ッ ド åąž 性 ã‚Ē ブ ジ ェ ク ト ぎ CPU affinity マ ã‚š ク åąž 性 を cpuset で 指 厚 さ れ た 値 ãĢ 設 厚 す る 。 こ ぎ åąž 性 ãĢ よ り 、 ã‚š ãƒŦ ッ ド åąž 性 ã‚Ē ブ ジ ェ ク ト attr を äŊŋ ãŖ ãĻ äŊœ 成 さ れ た ã‚š ãƒŦ ッ ド ぎ CPU affinity マ ã‚š ク が æąē 厚 さ れ る 。

pthread_attr_getaffinity_np () é–ĸ 数 は 、 attr が 参 į…§ す る ã‚š ãƒŦ ッ ド åąž 性 ã‚Ē ブ ジ ェ ク ト ぎ CPU affinity マ ã‚š ク åąž 性 を cpuset が 指 す バ ッ フ ã‚Ą ãƒŧ ãĢ å…Ĩ れ ãĻ čŋ” す 。

cpusetsize åŧ• 数 は cpuset が 指 す バ ッ フ ã‚Ą ãƒŧ ぎ (バ イ ト 単 äŊ ぎ ) 大 き さ で あ る 。 通 常 は 、 こ ぎ åŧ• 数 ãĢ は sizeof(cpu_set_t) を 指 厚 す る こ と だ ろ う 。

CPU affinity マ ã‚š ク ぎ čŠŗ į´° ãĢ つ い ãĻ は 、 sched_setaffinity (2) を 参 į…§ し ãĻ ãģ し い 。 CPU 集 合 ぎ 操 äŊœ や 取 åž— を 行 う 際 ãĢ 刊 į”¨ で き る マ ク ロ įž¤ ぎ čĒŦ 明 は CPU_SET (3) を 参 į…§ し ãĻ ãģ し い 。

čŋ” り 値

成 功 す る と 、 こ れ ら ぎ é–ĸ 数 は 0 を čŋ” す 。 エ ナ ãƒŧ ぎ å ´ 合 、 0 äģĨ 外 ぎ エ ナ ãƒŧ į•Ē åˇ を čŋ” す 。

エ ナ ãƒŧ

EINVAL

( pthread_attr_setaffinity_np ()) cpuset が ã‚Ģ ãƒŧ ネ ãƒĢ が ã‚ĩ ポ ãƒŧ ト す る CPU 集 合 ãĢ ãĒ い CPU を 指 厚 し ãĻ い た 。 (CPU 集 合 を 襨 įž す る ぎ ãĢ äŊŋ わ れ る ã‚Ģ ãƒŧ ネ ãƒĢ ぎ デ ãƒŧ ã‚ŋ 型 が ã‚ĩ ポ ãƒŧ ト す る 集 合 ぎ į¯„ å›˛ は 、 ã‚Ģ ãƒŧ ネ ãƒĢ ぎ 設 厚 ã‚Ē プ ã‚ˇ ョ ãƒŗ CONFIG_NR_CPUS ãĢ よ り 厚 įžŠ さ れ る )。

EINVAL

( pthread_attr_getaffinity_np ()) attr が 参 į…§ す る ã‚š ãƒŦ ッ ド åąž 性 ã‚Ē ブ ジ ェ ク ト ぎ affinity マ ã‚š ク 内 ぎ CPU が 、 cpusetsize ãĢ よ り 指 厚 さ れ た į¯„ å›˛ ぎ 中 ãĢ ãĒ か ãŖ た (す ãĒ わ ãĄ 、 cpuset / cpusetsize が 小 さ す ぎ る )。

ENOMEM

( pthread_attr_setaffinity_np ()) ãƒĄ ãƒĸ ãƒĒ ãƒŧ を å‰˛ り åŊ“ ãĻ る こ と が で き ãĒ か ãŖ た 。

バ ãƒŧ ジ ョ ãƒŗ

こ れ ら ぎ é–ĸ 数 は glibc バ ãƒŧ ジ ョ ãƒŗ 2.3.4 äģĨ 降 で 提 供 さ れ ãĻ い る 。

åąž 性

こ ぎ į¯€ で äŊŋ į”¨ さ れ ãĻ い る į”¨ čĒž ぎ čĒŦ 明 ãĢ つ い ãĻ は 、 attributes (7) を 参 į…§ 。

Image grohtml-34086-1.png

æē– 拠

こ れ ら ぎ é–ĸ 数 は 非 標 æē– ぎ GNU ãĢ よ る æ‹Ą åŧĩ で あ る 。 そ ぎ た め 、 名 前 ãĢ "_np" (nonportable; į§ģ 植 性 が ãĒ い ) と い う æŽĨ å°ž 辞 が äģ˜ い ãĻ い る 。

æŗ¨ 意

(こ ぎ バ ãƒŧ ジ ョ ãƒŗ だ け で あ る が ) glibc 2.3.3 で は 、 こ れ ら ぎ é–ĸ 数 は cpusetsize åŧ• 数 を 持 ãŖ ãĻ い ãĒ か ãŖ た 。 内 部 で å‘ŧ ば れ る ã‚ˇ ã‚š テ ム ã‚ŗ ãƒŧ ãƒĢ ãĢ æ¸Ą さ れ る CPU ã‚ģ ッ ト ぎ 大 き さ は 常 ãĢ sizeof(cpu_set_t) で あ ãŖ た 。

é–ĸ é€Ŗ 項 į›Ž

sched_setaffinity (2), pthread_attr_init (3), pthread_setaffinity_np (3), cpuset (7), pthreads (7)

こ ぎ 文 書 ãĢ つ い ãĻ

こ ぎ man ペ ãƒŧ ジ は Linux man-pages プ ロ ジ ェ ク ト ぎ ãƒĒ ãƒĒ ãƒŧ ã‚š 5.10 ぎ 一 部 で あ る 。 プ ロ ジ ェ ク ト ぎ čĒŦ 明 と バ グ å ą 告 ãĢ é–ĸ す る 情 å ą は https://www.kernel.org/doc/man-pages/ ãĢ 書 か れ ãĻ い る 。