.\" the source, must acknowledge the copyright and authors of this work.
.\"
.\" FIXME . Add an example to this page
+.\"*******************************************************************
.\"
-.\" Japanese Version Copyright (c) 2002 Akihiro MOTOKI, all rights reserved.
-.\" Translated Mon Feb 2 2003 by Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>
-.\" Updated 2009-02-23, Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>, LDP v3.19
+.\" This file was generated with po4a. Translate the source file.
.\"
-.TH SHM_OPEN 3 2009-02-25 "Linux" "Linux Programmer's Manual"
+.\"*******************************************************************
+.TH SHM_OPEN 3 2009\-02\-25 Linux "Linux Programmer's Manual"
.SH 名前
-shm_open, shm_unlink \- POSIX 共有メモリ・オブジェクトの作成/オープン、
-削除を行う
+shm_open, shm_unlink \- POSIX 共有メモリ・オブジェクトの作成/オープン、 削除を行う
.SH 書式
-.B #include <sys/mman.h>
+\fB#include <sys/mman.h>\fP
.br
-.BR "#include <sys/stat.h>" " /* mode 定数用 */"
+\fB#include <sys/stat.h>\fP /* mode 定数用 */
.br
-.BR "#include <fcntl.h>" " /* O_* 定数の定義用 */"
+\fB#include <fcntl.h>\fP /* O_* 定数の定義用 */
.sp
-.BI "void * shm_open(const char *" name ", int " oflag ", mode_t " mode );
+\fBvoid * shm_open(const char *\fP\fIname\fP\fB, int \fP\fIoflag\fP\fB, mode_t
+\fP\fImode\fP\fB);\fP
.sp
-.BI "int shm_unlink(const char *" name );
+\fBint shm_unlink(const char *\fP\fIname\fP\fB);\fP
.sp
\fI\-lrt\fP でリンクする。
.SH 説明
-.BR shm_open ()
-は、POSIX 共有メモリ・オブジェクトを新規に作成/オープンしたり、
-すでに存在するオブジェクトをオープンしたりする。
-POSIX 共有メモリ・オブジェクトは、実際には、関係のないプロセスが
-共有メモリの同じ領域を
-.BR mmap (2)
-するために使用することができる手段である。
-.BR shm_unlink ()
-は、逆の操作、つまり以前に
-.BR shm_open ()
+\fBshm_open\fP() は、POSIX 共有メモリ・オブジェクトを新規に作成/オープンしたり、 すでに存在するオブジェクトをオープンしたりする。
+POSIX 共有メモリ・オブジェクトは、実際には、関係のないプロセスが 共有メモリの同じ領域を \fBmmap\fP(2)
+するために使用することができる手段である。 \fBshm_unlink\fP() は、逆の操作、つまり以前に \fBshm_open\fP()
で作成されたオブジェクトの削除を行う。
.LP
-.BR shm_open ()
-の動作は
-.BR open (2)
-とよく似ている。
-.I name
-で作成したりオープンしたりする共有メモリ・オブジェクトを指定する。
-移植性を持たせるためには、共有メモリ・オブジェクトは
-.I /somename
-という形式の名前で識別し、
-その名前は、最大で
-.B NAME_MAX
-(すなわち 255) 文字の NULL 終端された文字列で、
.\" glibc allows the initial slash to be omitted, and makes
.\" multiple initial slashes equivalent to a single slash.
.\" This differs from the implementation of POSIX message queues.
-スラッシュで始まり、スラッシュ以外の文字が 1 文字以上続く形式
-にすべきである。
.\" glibc allows subdirectory components in the name, in which
.\" case the subdirectory must exist under /dev/shm, and allow the
.\" required permissions if a user wants to create a shared memory
.\" object in that subdirectory.
+\fBshm_open\fP() の動作は \fBopen\fP(2) とよく似ている。 \fIname\fP
+で作成したりオープンしたりする共有メモリ・オブジェクトを指定する。 移植性を持たせるためには、共有メモリ・オブジェクトは \fI/somename\fP
+という形式の名前で識別し、 その名前は、最大で \fBNAME_MAX\fP (すなわち 255) 文字の NULL 終端された文字列で、
+スラッシュで始まり、スラッシュ以外の文字が 1 文字以上続く形式 にすべきである。
.LP
-.I oflag
-はビットマスクで、
-.B O_RDONLY
-と
-.B O_RDWR
-のいずれか一方と、以下に述べる他のフラグの論理和をとったもの
+\fIoflag\fP はビットマスクで、 \fBO_RDONLY\fP と \fBO_RDWR\fP のいずれか一方と、以下に述べる他のフラグの論理和をとったもの
を指定する。
-.TP 1.1i
-.B O_RDONLY
-読み出しアクセス用にオブジェクトをオープンする。
-このフラグを指定してオープンされた共有メモリ・オブジェクトは、
-読み出し (\fBPROT_READ\fP) アクセスでのみ
-.BR mmap (2)
-することができる。
-.TP
-.B O_RDWR
+.TP 1.1i
+\fBO_RDONLY\fP
+読み出しアクセス用にオブジェクトをオープンする。 このフラグを指定してオープンされた共有メモリ・オブジェクトは、 読み出し (\fBPROT_READ\fP)
+アクセスでのみ \fBmmap\fP(2) することができる。
+.TP
+\fBO_RDWR\fP
読み書きアクセス用にオブジェクトをオープンする。
-.TP
-.B O_CREAT
-存在しない場合、共有メモリ・オブジェクトを作成する。
-オブジェクトのユーザとグループの所有権は、
-呼び出し元プロセスの対応する実効 ID が使われ、
-.\" 本当は、Linux ではファイルシステム ID が使われるのだが、
-.\" その値はほとんどいつも実効 ID と同じである。 (MTK, Jul 05)
-オブジェクトの許可ビットは
-.I mode
-の下位 9 ビットに基づいて設定される。ただし、
-ファイルモード作成マスク
-.RB ( umask (2)
-参照) に設定されている値は、新規オブジェクトに関してはクリアされる。
-.I mode
-を定義するために使用できるマクロ定数(群)は
-.BR open (2)
-に記載されている
-(これらの定数のシンボル定義は
-.I <sys/stat.h>
+.TP
+\fBO_CREAT\fP
+.\" In truth it is actually the file system IDs on Linux, but these
+.\" are nearly always the same as the effective IDs. (MTK, Jul 05)
+存在しない場合、共有メモリ・オブジェクトを作成する。 オブジェクトのユーザとグループの所有権は、 呼び出し元プロセスの対応する実効 ID が使われ、
+オブジェクトの許可ビットは \fImode\fP の下位 9 ビットに基づいて設定される。ただし、 ファイルモード作成マスク (\fBumask\fP(2)
+参照) に設定されている値は、新規オブジェクトに関してはクリアされる。 \fImode\fP を定義するために使用できるマクロ定数(群)は
+\fBopen\fP(2) に記載されている (これらの定数のシンボル定義は \fI<sys/stat.h>\fP
のインクルードにより得られる)。
.sp
-新規に作成された共有メモリ・オブジェクトは長さ 0 で初期化される。
-オブジェクトの大きさは
-.BR ftruncate (2)
-を使って設定できる。
-共有メモリ・オブジェクトとして新規に確保されたバイトは自動的に
-0 に初期化される。
-.TP
-.B O_EXCL
-.B O_CREAT
-が一緒に指定されており、
-.I name
-で指定された共有メモリ・オブジェクトが既に存在した場合、
-エラーを返す。
-オブジェクトの存在確認と、存在しなかった場合のオブジェクト作成は、
-必ず一連の操作として実行される (performed atomically)。
-.TP
-.B O_TRUNC
-共有メモリ・オブジェクトがすでに存在した場合、
-そのオブジェクトを 0 バイトに切り詰める。
+新規に作成された共有メモリ・オブジェクトは長さ 0 で初期化される。 オブジェクトの大きさは \fBftruncate\fP(2) を使って設定できる。
+共有メモリ・オブジェクトとして新規に確保されたバイトは自動的に 0 に初期化される。
+.TP
+\fBO_EXCL\fP
+\fBO_CREAT\fP が一緒に指定されており、 \fIname\fP で指定された共有メモリ・オブジェクトが既に存在した場合、 エラーを返す。
+オブジェクトの存在確認と、存在しなかった場合のオブジェクト作成は、 必ず一連の操作として実行される (performed atomically)。
+.TP
+\fBO_TRUNC\fP
+共有メモリ・オブジェクトがすでに存在した場合、 そのオブジェクトを 0 バイトに切り詰める。
.LP
-これらのフラグ値の定義は
-.I <fcntl.h>
-のインクルードにより得られる。
+これらのフラグ値の定義は \fI<fcntl.h>\fP のインクルードにより得られる。
.LP
-成功して完了した場合、
-.BR shm_open ()
-は共有メモリ・オブジェクトを参照する新しいファイル・ディスクリプタを返す。
-このファイル・ディスクリプタは、そのプロセス内で過去にオープンされていない
-ファイル・ディスクリプタの中で最も小さな数になることが保証される。
-.B FD_CLOEXEC
-フラグ
-.RB ( fcntl (2)
-を参照) が、このファイル・ディスクリプタに設定される。
-.PP
-通常、これらのファイル・ディスクリプタは、この後続けて実行される
-.BR ftruncate (2)
-(新規に作成されたオブジェクトの場合のみ) と
-.BR mmap (2)
-の呼び出しに使用される。
-.BR mmap (2)
-を呼び出した後は、ファイル・ディスクリプタをクローズしてもよく、
+成功して完了した場合、 \fBshm_open\fP() は共有メモリ・オブジェクトを参照する新しいファイル・ディスクリプタを返す。
+このファイル・ディスクリプタは、そのプロセス内で過去にオープンされていない ファイル・ディスクリプタの中で最も小さな数になることが保証される。
+\fBFD_CLOEXEC\fP フラグ (\fBfcntl\fP(2) を参照) が、このファイル・ディスクリプタに設定される。
+
+通常、これらのファイル・ディスクリプタは、この後続けて実行される \fBftruncate\fP(2) (新規に作成されたオブジェクトの場合のみ) と
+\fBmmap\fP(2) の呼び出しに使用される。 \fBmmap\fP(2) を呼び出した後は、ファイル・ディスクリプタをクローズしてもよく、
クローズしてもメモリ・マッピングに影響を与えることはない。
-.PP
-.BR shm_unlink ()
-の動作は
-.BR unlink (2)
-とよく似ている:
-共有メモリ・オブジェクト名を削除し、すべてのプロセスが処理対象の
-オブジェクトをアンマップした時点でオブジェクトの割り当てを解除し、
-対応するメモリ領域の内容を破棄する。
-.BR shm_unlink ()
-が成功した後で、同じ
-.I name
-を持つオブジェクトに対して
-.BR shm_open ()
-を行うと、
-.RB ( O_CREAT
-が指定されていない場合) 失敗する。
-.RB ( O_CREAT
+
+\fBshm_unlink\fP() の動作は \fBunlink\fP(2) とよく似ている:
+共有メモリ・オブジェクト名を削除し、すべてのプロセスが処理対象の オブジェクトをアンマップした時点でオブジェクトの割り当てを解除し、
+対応するメモリ領域の内容を破棄する。 \fBshm_unlink\fP() が成功した後で、同じ \fIname\fP を持つオブジェクトに対して
+\fBshm_open\fP() を行うと、 (\fBO_CREAT\fP が指定されていない場合) 失敗する。 (\fBO_CREAT\fP
が指定されている場合、新しく別のオブジェクトが作成される)。
.SH 返り値
-成功した場合、
-.BR shm_open ()
-は非負のファイル・ディスクリプタを返す。
-失敗した場合、
-.BR shm_open ()
-は \-1 を返す。
-.BR shm_unlink ()
-は、成功した場合 0 を、エラーが起こった場合 \-1 を返す。
+成功した場合、 \fBshm_open\fP() は非負のファイル・ディスクリプタを返す。 失敗した場合、 \fBshm_open\fP() は \-1 を返す。
+\fBshm_unlink\fP() は、成功した場合 0 を、エラーが起こった場合 \-1 を返す。
.SH エラー
-失敗した場合、エラーの原因を示すため
-.I errno
-が設定される。
-.I errno
-に設定される値は以下の通りである:
-.TP
-.B EACCES
-共有メモリオブジェクトを
-.BR shm_unlink ()
-する権限がなかった。
-.TP
-.B EACCES
-指定された
-.I mode
-で
-.I name
-を
-.BR shm_open ()
-する権限がなかった。もしくは、
-.B O_TRUNC
-が指定されたが、呼び出し元にはそのオブジェクトに対する書き込み権限が
-なかった。
-.TP
-.B EEXIST
-.B O_CREAT
-と
-.B O_EXCL
-の両方が
-.BR shm_open ()
-に指定されたが、
-.I name
+失敗した場合、エラーの原因を示すため \fIerrno\fP が設定される。 \fIerrno\fP に設定される値は以下の通りである:
+.TP
+\fBEACCES\fP
+共有メモリオブジェクトを \fBshm_unlink\fP() する権限がなかった。
+.TP
+\fBEACCES\fP
+指定された \fImode\fP で \fIname\fP を \fBshm_open\fP() する権限がなかった。もしくは、 \fBO_TRUNC\fP
+が指定されたが、呼び出し元にはそのオブジェクトに対する書き込み権限が なかった。
+.TP
+\fBEEXIST\fP
+\fBO_CREAT\fP と \fBO_EXCL\fP の両方が \fBshm_open\fP() に指定されたが、 \fIname\fP
で指定された共有メモリ・オブジェクトが既に存在した。
-.TP
-.B EINVAL
-.BR shm_open ()
-に与えられた
-.I name
-引き数が不正であった。
-.TP
-.B EMFILE
+.TP
+\fBEINVAL\fP
+\fBshm_open\fP() に与えられた \fIname\fP 引き数が不正であった。
+.TP
+\fBEMFILE\fP
プロセスがオープン可能なファイル数の上限にすでに達していた。
-.TP
-.B ENAMETOOLONG
-.I name
-の長さが
-.B PATH_MAX
-を越えている。
-.TP
-.B ENFILE
+.TP
+\fBENAMETOOLONG\fP
+\fIname\fP の長さが \fBPATH_MAX\fP を越えている。
+.TP
+\fBENFILE\fP
ファイルシステムでオープンできるファイル数の上限に達した。
-.TP
-.B ENOENT
-存在していない
-.I name
-のオブジェクトを
-.BR shm_open ()
-しようとしたが、
-.B O_CREAT
-が指定されていなかった。
-.TP
-.B ENOENT
-存在しない
-.I name
-のオブジェクトを
-.BR shm_unlink ()
-しようとした。
+.TP
+\fBENOENT\fP
+存在していない \fIname\fP のオブジェクトを \fBshm_open\fP() しようとしたが、 \fBO_CREAT\fP が指定されていなかった。
+.TP
+\fBENOENT\fP
+存在しない \fIname\fP のオブジェクトを \fBshm_unlink\fP() しようとした。
.SH バージョン
これらの関数は glibc 2.2 以降で提供されている。
.SH 準拠
-POSIX.1-2001.
+POSIX.1\-2001.
.LP
-POSIX.1-2001 には、新規に作成される共有メモリオブジェクトのグループ所有権は、
-呼び出し元プロセスの実効グループ ID か 「システムのデフォルトのグループ ID」
-のどちらかに設定される、と書かれている。
+POSIX.1\-2001 には、新規に作成される共有メモリオブジェクトのグループ所有権は、 呼び出し元プロセスの実効グループ ID か
+「システムのデフォルトのグループ ID」 のどちらかに設定される、と書かれている。
.SH 注意
.LP
-POSIX は
-.B O_RDONLY
-と
-.B O_TRUNC
-が一緒に指定された場合の動作を未定義にしている。Linux では、
-既存の共有メモリ・オブジェクトに対する切り詰め (truncate) は成功する。
-しかし、他の UNIX システムでも同じであるとは限らない。
+POSIX は \fBO_RDONLY\fP と \fBO_TRUNC\fP が一緒に指定された場合の動作を未定義にしている。Linux では、
+既存の共有メモリ・オブジェクトに対する切り詰め (truncate) は成功する。 しかし、他の UNIX システムでも同じであるとは限らない。
.LP
-Linux 2.4 における POSIX 共有メモリ・オブジェクトの実装は
-専用のファイルシステムを使用する。そのファイルシステムは通常
-.I /dev/shm
-にマウントされる。
+Linux 2.4 における POSIX 共有メモリ・オブジェクトの実装は 専用のファイルシステムを使用する。そのファイルシステムは通常
+\fI/dev/shm\fP にマウントされる。
.SH 関連項目
-.BR close (2),
-.BR fchmod (2),
-.BR fchown (2),
-.BR fcntl (2),
-.BR fstat (2),
-.BR ftruncate (2),
-.BR mmap (2),
-.BR open (2),
-.BR umask (2),
-.BR shm_overview (7)
+\fBclose\fP(2), \fBfchmod\fP(2), \fBfchown\fP(2), \fBfcntl\fP(2), \fBfstat\fP(2),
+\fBftruncate\fP(2), \fBmmap\fP(2), \fBopen\fP(2), \fBumask\fP(2), \fBshm_overview\fP(7)
OSDN Git Service
