sem_init -
名前なしセマフォを初期化する
#include <semaphore.h>
int sem_init(sem_t *sem, int pshared, unsigned int value);
-pthread とリンクする。
sem_init() は、
sem
が指すアドレスにある名前なしセマフォを初期化する。
value
引き数はそのセマフォの初期値を指定する。
pshared
引き数は、このセマフォがプロセス内のスレッド間で共有されるのか、
プロセス間で共有されるのか、を示す。
pshared が 0
の場合、セマフォはプロセス内のスレッド間で共有される。
セマフォはすべてのスレッドから参照可能なアドレスに配置すべきである
(例えば、大域変数や、ヒープ上に動的に割り当てられた変数など)。
pshared が 0
以外の場合、セマフォはプロセス間で共有される。セマフォは
共有メモリ領域に配置すべきである
(
shm_open(3),
mmap(2),
shmget(2)
参照)。 (
fork(2)
で生成された子プロセスは親プロセスのメモリマッピングを継承するため、
子プロセスもセマフォにアクセスできる。)
共有メモリ領域にアクセスできるプロセスならば、どのプロセスでも
sem_post(3) や
sem_wait(3)
などを使ってセマフォを操作できる。
すでに初期化済のセマフォを初期化した場合の挙動は定義されていない。
返り値¶
成功すると、
sem_init() は 0
を返す。エラーの場合、-1
を返し、
errno
にエラーを示す値をセットする。
エラー¶
- EINVAL
- value が SEM_VALUE_MAX
を超えている。
- ENOSYS
- pshared が 0
以外だが、システムがプロセス共有セマフォをサポートしていない
( sem_overview(7) 参照)。
マルチスレッディング (pthreads(7) 参照)¶
sem_init()
関数はスレッドセーフである。
POSIX.1-2001.
妙なことに、POSIX.1-2001 は
sem_init()
が成功した場合に返すべき値を規定していない。
POSIX.1-2008
ではこれが修正され、成功時には
0
を返すことが規定された。
関連項目¶
sem_destroy(3),
sem_post(3),
sem_wait(3),
sem_overview(7)
この文書について¶
この man ページは Linux
man-pages
プロジェクトのリリース
3.65 の一部
である。プロジェクトの説明とバグ報告に関する情報は
http://www.kernel.org/doc/man-pages/
に書かれている。