-'\" t
+.\" t
.\" Hey Emacs! This file is -*- nroff -*- source.
.\"
.\" Copyright (C) 2006 Michael Kerrisk <mtk.manpages@gmail.com>
.\" Formatted or processed versions of this manual, if unaccompanied by
.\" the source, must acknowledge the copyright and authors of this work.
.\"
-.\" Japanese Version Copyright (c) 2006 Akihiro MOTOKI all rights reserved.
-.\" Translated 2006-04-18, Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>
-.\" Updated 2009-02-23, Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>, LDP v3.19
+.\"*******************************************************************
.\"
-.TH SEM_OPEN 3 2009-02-20 "Linux" "Linux Programmer's Manual"
+.\" This file was generated with po4a. Translate the source file.
+.\"
+.\"*******************************************************************
+.TH SEM_OPEN 3 2009\-02\-20 Linux "Linux Programmer's Manual"
.SH 名前
sem_open \- 名前付きセマフォを初期化し、オープンする
.SH 書式
.nf
-.BR "#include <fcntl.h>" " /* For O_* constants */"
-.BR "#include <sys/stat.h>" " /* For mode constants */"
-.B #include <semaphore.h>
+\fB#include <fcntl.h>\fP /* For O_* constants */
+\fB#include <sys/stat.h>\fP /* For mode constants */
+\fB#include <semaphore.h>\fP
.sp
-.BI "sem_t *sem_open(const char *" name ", int " oflag );
-.BI "sem_t *sem_open(const char *" name ", int " oflag ", "
-.BI " mode_t " mode ", unsigned int " value );
+\fBsem_t *sem_open(const char *\fP\fIname\fP\fB, int \fP\fIoflag\fP\fB);\fP
+\fBsem_t *sem_open(const char *\fP\fIname\fP\fB, int \fP\fIoflag\fP\fB, \fP
+\fB mode_t \fP\fImode\fP\fB, unsigned int \fP\fIvalue\fP\fB);\fP
.fi
.sp
\fI\-lrt\fP または \fI\-pthread\fP でリンクする。
.SH 説明
-.BR sem_open ()
-は、新規の POSIX セマフォを作成するか、既存のセマフォのオープンを行う。
-セマフォは
-.I name
-で識別される。
-.I name
-の構成の詳細は
-.BR sem_overview (7)
-を参照。
+\fBsem_open\fP() は、新規の POSIX セマフォを作成するか、既存のセマフォのオープンを行う。 セマフォは \fIname\fP で識別される。
+\fIname\fP の構成の詳細は \fBsem_overview\fP(7) を参照。
-.I oflag
-引き数には、
-.BR sem_open ()
-の動作を制御するフラグを指定する
-(oflag の値の定義は
-.I <fcntl.h>
-のインクルードにより得られる)。
-.I oflag
-に
-.B O_CREAT
-が指定されると、まだ存在しない場合にはそのセマフォが作成される。
-セマフォの所有者 (ユーザ ID)、グループ所有権 (グループ ID) には、
-それぞれ呼び出し元プロセスの実効 UID、実効 GID が設定される。
-.\" 実際は、Linux ではファイルシステム ID が使用される。
-.I oflag
-に
-.B O_CREAT
-と
-.B O_EXCL
-の両方が指定された場合、指定された名前
-.I name
-のセマフォがすでに存在するとエラーが返される。
+.\" In reality the file system IDs are used on Linux.
+\fIoflag\fP 引き数には、 \fBsem_open\fP() の動作を制御するフラグを指定する (oflag の値の定義は
+\fI<fcntl.h>\fP のインクルードにより得られる)。 \fIoflag\fP に \fBO_CREAT\fP
+が指定されると、まだ存在しない場合にはそのセマフォが作成される。 セマフォの所有者 (ユーザ ID)、グループ所有権 (グループ ID) には、
+それぞれ呼び出し元プロセスの実効 UID、実効 GID が設定される。 \fIoflag\fP に \fBO_CREAT\fP と \fBO_EXCL\fP
+の両方が指定された場合、指定された名前 \fIname\fP のセマフォがすでに存在するとエラーが返される。
.PP
-.I oflag
-に
-.B O_CREAT
-を指定する場合、さらに引き数が 2 つ必要である。
-.I mode
-引き数は、
-.BR open (2)
-と同じように、新しいセマフォに設定されるアクセス許可 (permission) を
-指定する。許可設定はプロセスの umask でマスクされる
-(許可ビットのシンボル定義は
-.I <sys/stat.h>
-のインクルードにより得られる)。
-セマフォにアクセスしようとするユーザは、読み出し許可と書き込み許可の
-両方を得る必要がある。
-.I value
-引き数は新しいセマフォの初期値を指定する。
-.B O_CREAT
-が指定され、指定した名前
-.I name
-のセマフォがすでに存在する場合、
-.I mode
-と
-.I value
-は無視される。
+\fIoflag\fP に \fBO_CREAT\fP を指定する場合、さらに引き数が 2 つ必要である。 \fImode\fP 引き数は、 \fBopen\fP(2)
+と同じように、新しいセマフォに設定されるアクセス許可 (permission) を 指定する。許可設定はプロセスの umask でマスクされる
+(許可ビットのシンボル定義は \fI<sys/stat.h>\fP のインクルードにより得られる)。
+セマフォにアクセスしようとするユーザは、読み出し許可と書き込み許可の 両方を得る必要がある。 \fIvalue\fP
+引き数は新しいセマフォの初期値を指定する。 \fBO_CREAT\fP が指定され、指定した名前 \fIname\fP のセマフォがすでに存在する場合、
+\fImode\fP と \fIvalue\fP は無視される。
.SH 返り値
-成功すると、
-.BR sem_open ()
-は新しいセマフォのアドレスを返す。
-このアドレスは他のセマフォ関連の関数を呼び出す際に使用される。
-エラーの場合、
-.BR sem_open ()
-は
-.B SEM_FAILED
-を返し、
-.I errno
-にエラーを示す値をセットする。
+成功すると、 \fBsem_open\fP() は新しいセマフォのアドレスを返す。 このアドレスは他のセマフォ関連の関数を呼び出す際に使用される。
+エラーの場合、 \fBsem_open\fP() は \fBSEM_FAILED\fP を返し、 \fIerrno\fP にエラーを示す値をセットする。
.SH エラー
-.TP
-.B EACCES
-そのセマフォが存在するが、呼び出し元にはそのセマフォをオープンする
-許可がない。
-.TP
-.B EEXIST
-.I oflag
-に
-.B O_CREAT
-と
-.B O_EXCL
-の両方が指定されたが、
-.I name
-という名前のセマフォはすでに存在する。
-.TP
-.B EINVAL
-.I value
-が
-.B SEM_VALUE_MAX
-よりも大きい。
-.TP
-.B EINVAL
-.I name
-が "/" だけで構成され、その後ろに他の文字が続いていなかった。
-.TP
-.B EMFILE
+.TP
+\fBEACCES\fP
+そのセマフォが存在するが、呼び出し元にはそのセマフォをオープンする 許可がない。
+.TP
+\fBEEXIST\fP
+\fIoflag\fP に \fBO_CREAT\fP と \fBO_EXCL\fP の両方が指定されたが、 \fIname\fP という名前のセマフォはすでに存在する。
+.TP
+\fBEINVAL\fP
+\fIvalue\fP が \fBSEM_VALUE_MAX\fP よりも大きい。
+.TP
+\fBEINVAL\fP
+\fIname\fP が "/" だけで構成され、その後ろに他の文字が続いていなかった。
+.TP
+\fBEMFILE\fP
オープンされたファイル数がすでにそのプロセスにおける上限に達している。
-.TP
-.B ENAMETOOLONG
-.I name
-が長すぎる。
-.TP
-.B ENFILE
+.TP
+\fBENAMETOOLONG\fP
+\fIname\fP が長すぎる。
+.TP
+\fBENFILE\fP
オープンされたファイル総数がシステム全体での上限に達している。
-.TP
-.B ENOENT
-.I oflag
-に
-.B O_CREAT
-フラグが指定されておらず、
-.I name
-という名前のセマフォも存在しない。
-または、
+.TP
+\fBENOENT\fP
.\" this error can occur if we have a name of the (nonportable) form
.\" /dir/name, and the directory /dev/shm/dir does not exist.
-.B O_CREAT
-が指定されたが、
-.I name
-が適切な形式ではなかった。
-.TP
-.B ENOMEM
+\fIoflag\fP に \fBO_CREAT\fP フラグが指定されておらず、 \fIname\fP という名前のセマフォも存在しない。 または、
+\fBO_CREAT\fP が指定されたが、 \fIname\fP が適切な形式ではなかった。
+.TP
+\fBENOMEM\fP
十分なメモリがない。
.SH 準拠
-POSIX.1-2001.
+POSIX.1\-2001.
.SH 関連項目
-.BR sem_close (3),
-.BR sem_getvalue (3),
-.BR sem_post (3),
-.BR sem_unlink (3),
-.BR sem_wait (3),
-.BR sem_overview (7)
+\fBsem_close\fP(3), \fBsem_getvalue\fP(3), \fBsem_post\fP(3), \fBsem_unlink\fP(3),
+\fBsem_wait\fP(3), \fBsem_overview\fP(7)
OSDN Git Service
