日本語 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
PTHREAD_CREATE(3) FreeBSD ライブラリ関数マニュアル PTHREAD_CREATE(3)
名称
pthread_create -- 新しいスレッドを作成する
ライブラリ
POSIX スレッドライブラリ (libpthread, -lpthread)
書式
#include <pthread.h>
int
pthread_create(pthread_t *restrict thread,
const pthread_attr_t *restrict attr, void *(*start_routine)(void *),
void *restrict arg);
解説
pthread_create() 関数は、プロセス内で attr によって指定された属性で新しい
スレッドを作成するために使用されます。attr が NULL であるなら、デフォルト
の属性が使用されます。attr によって指定された属性が後で修正されても、ス
レッドの属性は、影響されません。成功して完了すると、pthread_create() は、
thread によって指定された場所に作成されたスレッドの ID を格納します。
スレッドは、唯一の引数として arg を付けて start_routine を実行して作成さ
れます。start_routine が返るなら、効果は、あたかも終了ステータスのように
start_routine の返り値を使用する pthread_exit() への暗黙の呼び出しがあっ
たかのようになります。main() が最初に呼び出されたスレッドは、これと異なる
ことに注意してください。main() から返るとき、効果は、あたかも終了ステータ
スのように main() の返り値を使用する exit() への暗黙の呼び出しがあったか
のようになります。
新しいスレッドのシグナル状態は、次のように初期化されます:
• シグナルマスクは、作成するスレッドから継承されます。
• 新しいスレッドのための保留中 (pending) のシグナルのセットは、空
です。
戻り値
成功したなら、pthread_create() 関数は、0 を返します。そうでなければ、エ
ラー番号がエラーを示すために返されます。
エラー
pthread_create() 関数は、次のエラーのいずれかを返すかもしれません:
[ENOMEM] システムが、別のスレッドを作成するために、必要なリソー
スを欠いています。
[EAGAIN] プロセス [PTHREAD_THREADS_MAX] のスレッドの合計の数で
システムで強制されている制限を越えています。
[EAGAIN] RACCT_NTHR 制限を越えています。racct(2) を参照してくだ
さい。
[EPERM] 呼び出し側に、必要なスケジューリングパラメータまたはス
ケジューリングポリシを設定するためのパーミッションがあ
りません。
[EINVAL] attr によって指定された値が無効です。
[EDEADLK] attr によって指定された CPU セットが、あらゆる CPU で
スレッドを実行することを防止しています。
[EFAULT] attr によって指定されたスタックベースが、無効である
か、または、カーネルが、スタックに必要な初期のデータを
置くことができませんでした。
関連項目
cpuset_setaffinity(2), fork(2), racct(2), thr_new(2), pthread_attr(3),
pthread_cancel(3), pthread_cleanup_pop(3), pthread_cleanup_push(3),
pthread_exit(3), pthread_join(3)
規格
pthread_create() 関数は、ISO/IEC 9945-1:1996 (``POSIX.1'') に適合していま
す。
FreeBSD 11.4 August 17, 2018 FreeBSD 11.4