Provided by: manpages-ja-dev_0.5.0.0.20131015+dfsg-2_all bug

名前

       shmget - System V 共有メモリ・セグメントを割り当てる

書式

       #include <sys/ipc.h>
       #include <sys/shm.h>

       int shmget(key_t key, size_t size, int shmflg);

説明

       shmget()  は key 引き数に対応する System V 共有メモリ・セグメントの識別子を返す。 key の値
       が IPC_PRIVATE の場合、もしくは key に対応する共有メモリ・セグメントが存在せず、 shmflgIPC_CREAT が指定されていた場合、 新しい共有メモリ・セグメントを作成する。 作成される共有メ
       モリ・セグメントは、 size 引き数の値を PAGE_SIZE の倍数へと切り上げた (round up)  大きさと
       なる。

       shmflgIPC_CREATIPC_EXCL の両方が指定された場合、 key に対応する共有メモリ・セグメ
       ントが既に存在すると、 shmget()  は失敗し、 errnoEEXIST が設定される  (これは  open(2)
       に O_CREAT | O_EXCL を指定した場合の動作と同じである)。

       shmflg は以下の内容から構成される:

       IPC_CREAT   新しいセグメントを作成する。このフラグが指定されなかった場合、   shmget()   は
                   key に対応するセグメントを探し、  ユーザがそのセグメントにアクセスする許可があ
                   るかどうかをチェックする。

       IPC_EXCL    IPC_CREAT  と共に使用し、セグメントが既に存在した場合には 失敗することを保証す
                   る。

       mode_flags  (下位 9 ビット)  所有者、グループ、他人 (world) への許可を指定する。  これらの
                   ビットは  open(2)  の mode 引き数と同じ形式で同じ意味を持つ。 今のところ、シス
                   テムは実行 (execute) 許可を参照しない。

       SHM_HUGETLB (Linux 2.6 以降)
                   "ヒュージページ (huge page)" を使うセグメントを割り当てる。詳細な情報は、Linux
                   カーネルソースのファイル Documentation/vm/hugetlbpage.txt を参照。

       SHM_NORESERVE (Linux 2.6.15 以降)
                   このフラグは、 mmap(2)  の MAP_NORESERVE フラグと同じ役割を果たす。 このセグメ
                   ントに対するスワップ空間の予約を行わない。  スワップ空間を予約した場合は、その
                   セグメントの変更が必ず成功することが    保証される。スワップ空間の予約を行わな
                   かった場合は、物理メモリに空きが ないと書き込み時に SIGSEGV を受け取る可能性が
                   ある。 proc(5)  にある /proc/sys/vm/overcommit_memory ファイルに関する議論も参
                   照のこと。

       共有メモリ・セグメントが新たに作成される際、 共有メモリ・セグメントの内容は  0  で初期化さ
       れ、 関連情報を保持するデータ構造体 shmid_ds は以下のように初期化される。

              shm_perm.cuidshm_perm.uid に呼び出し元プロセスの実効 (effective) ユーザーID を
              設定する。

              shm_perm.cgidshm_perm.gid に呼び出し元プロセスの実効グループID を設定する。

              shm_perm.mode の下位 9 ビットに shmflg の下位 9 ビットを設定する。

              shm_segszsize の値を設定する。

              shm_lpid, shm_nattch, shm_atime, shm_dtime に 0 を設定する。

              shm_ctime に現在の時刻を設定する。

       共有メモリ・セグメントが既に存在する場合、アクセス許可の検査と、 破壊 (destruction) マーク
       がつけられていないかのチェックが行われる。

返り値

       成功の場合、有効な共有メモリ・セグメントの識別子が返される。  エラーの場合、  -1  が返り、
       error にエラーを示す値が設定される。

エラー

       失敗した場合は errno が以下のどれかに設定される:

       EACCES ユーザーはその共有メモリ・セグメントへのアクセス許可を持たず、 CAP_IPC_OWNER ケーパ
              ビリティも持っていない。

       EEXIST IPC_CREAT | IPC_EXCL が指定されていたが、そのセグメントが既に存在する。

       EINVAL 新しいセグメントを作成しようとした際に  size  <  SHMMIN または size > SHMMAX であっ
              た。 もしくは、指定されたキーに対応するセグメントが既に存在して、新しい  セグメント
              を作成しようとはしなかったが、size が存在するセグメントの サイズよりも大きかった。

       ENFILE システム全体でオープンされているファイルの総数が上限に達した。

       ENOENT 指定された key に対応するセグメントが存在せず、 IPC_CREAT も指定されていなかった。

       ENOMEM セグメントの管理情報 (overhead) に割り当てるメモリがなかった。

       ENOSPC システム全体の共有メモリ・セグメント数の制限  (SHMMNI)   に達した、または要求された
              size のセグメントの割り当てが システム全体の共有メモリサイズの制限 (SHMALL)  を超過
              した。

       EPERM  SHM_HUGETLB フラグが指定されたが、呼び出し元には権限がなかった (CAP_IPC_LOCK ケーパ
              ビリティを持っていなかった)。

準拠

       SVr4, POSIX.1-2001.

       SHM_HUGETLB は Linux での拡張であり、移植性はない。

注意

       Linux や POSIX の全てのバージョンでは、 <sys/types.h><sys/ipc.h>  のインクルードは必要
       ない。しかしながら、いくつかの古い実装ではこれらのヘッダファイルのインクルードが必要であ
       り、 SVID でもこれらのインクルードをするように記載されている。このような古いシステムへの移
       植性を意図したアプリケーションではこれらのファイルをインクルードする必要があるかもしれな
       い。

       IPC_PRIVATE はフラグではなく  key_t  型である。  この特別な値が  key  に使用された場合は、
       shmget() は shmflg の下位 9 ビットを除いた全てを無視し、 (成功すれば) 新しい共有メモリ・セ
       グメントを作成する。

       shmget()  コールに影響する共有メモリ・セグメント資源の制限は以下の通りである:

       SHMALL システム全体の共有メモリ・ページの最大数         (Linux          では、この上限値は
              /proc/sys/kernel/shmall 経由で参照したり、変更したりできる)。

       SHMMAX 共有メモリ・セグメントのバイト単位の大きさの上限:  方針依存 (Linux では、この上限値
              は /proc/sys/kernel/shmmax 経由で参照したり、変更したりできる)。

       SHMMIN 共有メモリ・セグメントのバイト単位の大きさの下限: 実装依存 (現在は 1 バイトだが、実
              質的な最小サイズは PAGE_SIZE である)。

       SHMMNI システム全体の共有メモリーの数の上限:  実装依存 (現在は 4096。Linux 2.3.99 より前で
              は 128。 Linux では、この上限値は /proc/sys/kernel/shmmni  経由で参照したり、変更し
              たりできる)。

       プロセス当りの共有メモリ・セグメントの個数の最大値 (SHMSEG)  に関する実装上の制限はない。

   Linux での注意
       バージョン   2.3.30  までは、Linux  は  削除が予定されている共有メモリ・セグメントに対して
       shmget()  が行われると EIDRM を返していた。

バグ

       IPC_PRIVATE という名前を選んだのはおそらく失敗であろう。 IPC_NEW  の方がより明確にその機能
       を表しているだろう。

関連項目

       shmat(2), shmctl(2), shmdt(2), ftok(3), capabilities(7), shm_overview(7), svipc(7)

この文書について

       この  man ページは Linux man-pages プロジェクトのリリース 3.54 の一部 である。プロジェクト
       の説明とバグ報告に関する情報は http://www.kernel.org/doc/man-pages/ に書かれている。