日本語 man コマンド類 (ja-man-1.1j_5) と日本語 man ドキュメント (ja-man-doc-5.4 (5.4-RELEASE 用) など) をインストールすると、以下のような man コマンド閲覧、キーワード検索が コンソールからできるようになります。
4.11-RELEASE-K, 5.4-RELEASE-K, 5.5-RELEASE-K, 6.0-RELEASE-K から 6.4-RELEASE-K, 7.0-RELEASE-K から 7.4-RELEASE-K, 8.0-RELEASE-K から 8.4-RELEASE-K, 9.0-RELEASE-K から 9.3-RELEASE-K, 10.0-RELEASE-K から 10.3-RELEASE-K, 11.0-RELEASE-K から 11.4-RELEASE-K, 12.0-RELEASE-K, 12.1-RELEASE-K は、 プライベート版 (小金丸が編集してまとめたもの) ですが、 より多くの翻訳したファイルが含まれています。 (5.4-RELEASE-K から 6.4-RELEASE-K, 7.0-RELEASE-K から 7.4-RELEASE-K, 8.0-RELEASE-K から 8.4-RELEASE-K, 9.0-RELEASE-K から 9.3-RELEASE-K, 10.0-RELEASE-K から 10.3-RELEASE-K, 11.0-RELEASE-K から 11.4-RELEASE-K, 12.0-RELEASE-K から 12.4-RELEASE-K, 13.0-RELEASE-K から 13.3-RELEASE-K, 14.0-RELEASE-K から 14.1-RELEASE-K は、全翻訳済み)
13.3-STABLE-K, 15.0-CURRENT-K は現在、作成中で日々更新されています。
Table of Contents
CPUSET_GETAFFINITY(2) FreeBSD システムコールマニュアル CPUSET_GETAFFINITY(2)
名称
cpuset_getaffinity, cpuset_setaffinity -- CPU の類似性を管理する
ライブラリ
標準 C ライブラリ (libc, -lc)
書式
#include <sys/param.h>
#include <sys/cpuset.h>
int
cpuset_getaffinity(cpulevel_t level, cpuwhich_t which, id_t id,
size_t setsize, cpuset_t *mask);
int
cpuset_setaffinity(cpulevel_t level, cpuwhich_t which, id_t id,
size_t setsize, const cpuset_t *mask);
解説
cpuset_getaffinity() と cpuset_setaffinity() によって、プロセス、スレッ
ド、割り込み、jail と他のリソースに利用可能な CPU のセットの操作ができま
す。これらの関数は、単一のオブジェクトだけに影響する多くのプロセスまたは
オブジェクト毎の匿名のマスクを含む CPU のセットを操作します。
level と which 引数のための有効な値は、cpuset(2) に文書化されています。こ
れらの引数は、我々が参照するオブジェクトとオブジェクトのセットを指定しま
す。すべての可能な組み合わせが有効であるというわけではありません。例え
ば、プロセスだけが、CPU_LEVEL_CPUSET の level 引数によってアクセスされた
番号付けされたセットに属します。しかしながら、すべてのリソースには、
CPU_LEVEL_WHICH とともに操作されるマスクがあります。
タイプ cpuset_t のマスクは、CPU_SET マクロを使用して組み立てられます。
セットに指定されたすべての CPU が存在している限り、カーネルは、大きいセッ
トを許します。たとえ、結果のセットがユーザによって供給されたセットに適合
しても、カーネルの用途が cpuset_getaffinity() への呼び出しでエラーを生成
するより小さくセットします。cpuset_setaffinity() への呼び出しは、制限なし
で小さいセットを許します。
供給されたマスクには、setsize バイトのサイズがあるはずです。このサイズ
は、最終的に <sys/cpuset.h> で定義されるように CPU_SETSIZE の値によって決
定される、sizeof(mask) を呼び出すことによって通常、提供されます。
cpuset_getaffinity() は、level, which と id によって指定されたオブジェク
トからマスクを検索して、mask によって提供された空間ににそれを格納します。
cpuset_setaffinity() は、level, which と id によって指定されたオブジェク
トのためのマスクを mask 中の値に設定することを試みます。
戻り値
成功して終了したときには値 0 を返します。そうでない場合、値 -1 が返され、
グローバル変数 errno にエラーを示す値が設定されます。
エラー
次のエラーコードが、errno に設定されます:
[EINVAL] level または which 引数が有効な値ではありませんでし
た。
[EINVAL] cpuset_setaffinity() を呼び出すとき、指定された mask
引数が有効な値ではありませんでした。
[EDEADLK] cpuset_setaffinity() 呼び出しは、セットがスレッドの匿
名のマスクに重ならないので、実行している有効な CPU な
しでスレッドを残しています。
[EFAULT] 渡されたマスクポインタが、無効でした。
[ESRCH] id と which 引数によって指定されたオブジェクトを、見つ
けることができませんでした。
[ERANGE] cpusetsize が、カーネル設定サイズよりとんでもなく大き
いか、または小さかったです。
[EPERM] 呼び出しプロセスで、操作を完了するために要求された資格
証明がありませんでした。
[ECAPMODE] ケーパビリティモードの間に、それ自体以外のプロセスに作
用するために試みられた呼び出しプロセス。capsicum(4) を
参照してください。
関連項目
capsicum(4), cpuset(1), cpuset(2), cpuset_getid(2), cpuset_setid(2),
pthread_affinity_np(3), pthread_attr_affinity_np(3), cpuset(9)
歴史
cpuset_getaffinity システムコールファミリは、FreeBSD 7.1 ではじめて登場し
ました。
作者
Jeffrey Roberson <jeff@FreeBSD.org>
FreeBSD 11.4 May 23, 2017 FreeBSD 11.4