CIV. セマフォおよび共有メモリ関数(semaphore)

導入

このモジュールは、System V IPC関連の関数へのラッパーを提供します。

セマフォは、マシーン上のリソースへの排他的アクセス機能や、同時にあるリソースを使用することができるプロセスの数を制限するために使用することができます。

このモジュールは、システム V 共有メモリを使用して共有メモリ関数も提供します。共有メモリは、グローバル変数へのアクセス手段を提供するために使用することが可能です。別の httpd デーモンおよび (Perl, C, ... のような)他のプログラムさえ、グローバルデータ交換を提供するこのデータにアクセスすることが可能です。共有メモリは、同時アクセスに関して安全ではないということを覚えておいて下さい。同期をとるには、セマフォを使用して下さい。

表 1. Unix OS による共有メモリの制限

SHMMAX	共有メモリの最大サイズ。通常は 131072 バイト
SHMMIN	共有メモリの最小サイズ。通常は 1 バイト
SHMMNI	共有メモリセグメントの最大数。通常は 100
SHMSEG	プロセス毎の共有メモリの最大数。通常は 6

メッセージング関数は、他のプロセスと相互にメッセージを送受信するために使用することができます。これにより簡単で効率的なプロセス間のデータ交換が可能であり、 UNIXドメインソケットを用いる場合のような設定は不要です。

注意: この拡張モジュールはWindows環境では利用できません。

要件

これらの関数は、標準モジュールの一部として利用可能であり、常に使用できます。

インストール手順

この関数はデフォルトでは有効になってはいません。System Vセマフォサポートを有効にするには、オプション --enable-sysvsemを指定してPHPをコンパイルする必要があります。System V共有メモリサポートを有効にするには、オプション--enable-sysvshmを指定してPHPをコンパイルする必要があります。System Vメッセージを有効にするには、オプション--enable-sysvmsgを指定してPHPをコンパイルします。

実行用の設定

これらの関数の動作は、php.iniの設定により変化します。

表 2. セマフォ設定オプション

名前	デフォルト	変更の可否
sysvmsg.value	"42"	PHP_INI_ALL
sysvmsg.string	"foobar"	PHP_INI_ALL

PHP_INI_* 定数の詳細と定義については、 ini_set()を参照して下さい。

リソース型

定義済みの定数

この拡張モジュールは定数を全く定義しません。

目次
ftok -- パス名とプロジェクトIDをSystem V IPCキーに変換する
msg_get_queue -- Create or attach to a message queue
msg_receive -- Receive a message from a message queue
msg_remove_queue -- Destroy a message queue
msg_send -- Send a message to a message queue
msg_set_queue -- Set information in the message queue data structure
msg_stat_queue -- Returns information from the message queue data structure
sem_acquire -- セマフォを得ます
sem_get -- セマフォ ID を得ます
sem_release -- セマフォを解放します
sem_remove -- セマフォを削除する
shm_attach -- 共有メモリセグメントを作成またはオープンします
shm_detach -- 共有メモリセグメントへの接続を閉じます
shm_get_var -- 共有メモリから変数を返す
shm_put_var -- 共有メモリの変数を挿入または更新します
shm_remove_var -- 共有メモリから変数を削除します
shm_remove -- UNIX システムから共有メモリを削除する

add a note User Contributed Notes
セマフォおよび共有メモリ関数(semaphore)

05-Feb-2004 04:25


Here is an article/tutorial on the subject:

hcuevas at galenicom dot com
23-Oct-2003 02:49


Don't use semaphores to serialize access to an undefined number of resources. There is no way (yet) to know before locking if a semaphore is already locked, thus not being able to fully release the semaphore and occupying a semaphore resource for an undefined time. 



A possible solution is to build a shared mem pool and store there the current number of locks for a semaphore id. 



Cheers,

Horaci Cuevas

david () php net
09-Jul-2003 08:45


Here is a quick utility to dump the contents of a shm_ format memory segment:

Roman Laptev <tmp at laptev dot org>
02-Apr-2003 02:50


If you going to work with semaphore, which was created by some external program, you can try the following code for this program (C example):



#define SVSEM_MODE (SEM_R | SEM_A | SEM_R>>3 | SEM_R>>6) /* 0644 */

#define PHP_SEM_NEED_NUMBER 3



/*.......*/

int semid, semflag = SVSEM_MODE | IPC_CREAT | IPC_EXCL;

struct sembuf semptr;

union semun semopts;

/*.......*/

if( (semid = semget(sempath, PHP_SEM_NEED_NUMBER, semflag)) >= 0 ) {

  semopts.val = 1; /* initial value for sem */

  if( semctl( semid, 0, SETVAL, semopts) < 0 ) {/*error*/}

  if( semctl( semid, 1, SETVAL, semopts) < 0 ) {/*error*/}

  /* PHP wanna zero for its own semget at third sem.

   * look at ./PHP_SOURCE_PATH/ext/sysvsem/sysvsem.c

   */

  semopts.val = 0;

  if( semctl( semid, 2, SETVAL, semopts) < 0 ) {/*error*/}

}

else if(errno == EEXIST) { /* connect only  */

  if( (semid = semget(sempath, PHP_SEM_NEED_NUMBER, SVSEM_MODE | IPC_CREAT)) < 0 ) {/*error*/}

}

else {/*error*/}



/*.......*/

/* If you want acquire the sem */

  semptr.sem_num = 0;

  semptr.sem_op = -1; /* lock it */

  semptr.sem_flg = SEM_UNDO;

  while( semop(semid, &semptr, 1) < 0 ) {/*error*/}

/*.......*/



Thanks,

Roma

elran70 at hotmail dot com
22-Jun-2002 05:54


Samlpe code for using most of the functions here:



    $MEMSIZE    =   512;//  size of shared memory to allocate

    $SEMKEY     =   1;  //  Semaphore key

    $SHMKEY     =   2;  //  Shared memory key



    echo "Start.\n";

    // Get semaphore

    $sem_id = sem_get($SEMKEY, 1);

    if ($sem_id === false)

    {

        echo "Fail to get semaphore";

        exit;

    }

    else

        echo "Got semaphore $sem_id.\n";



    // Accuire semaphore

    if (! sem_acquire($sem_id))

    {

        echo "Fail to aquire semaphore $sem_id.\n";

        sem_remove($sem_id);

        exit;

    }

    else

        echo "Success aquire semaphore $sem_id.\n";



    $shm_id =   shm_attach($SHMKEY, $MEMSIZE);

    if ($shm_id === false)

    {

        echo "Fail to attach shared memory.\n";

        sem_remove($sem_id);

        exit;

    }

    else

        echo "Success to attach shared memory : $shm_id.\n";



    // Write variable 1

    if (!shm_put_var($shm_id, 1, "Variable 1"))

    {

        echo "Fail to put var 1 on shared memory $shm_id.\n";

        sem_remove($sem_id);

        shm_remove ($shm_id);

        exit;

    }

    else

        echo "Write var1 to shared memory.\n";



    // Write variable 2

    if (!shm_put_var($shm_id, 2, "Variable 2"))

    {

        echo "Fail to put var 2 on shared memory $shm_id.\n";

        sem_remove($sem_id);

        shm_remove ($shm_id);

        exit;

    }

    else

        echo "Write var2 to shared memory.\n";



    // Read variable 1

    $var1   =   shm_get_var ($shm_id, 1);

    if ($var1 === false)

    {

        echo "Fail to retrive Var 1 from Shared memory $shm_id, return value=$var1.\n";

    }

    else

        echo "Read var1=$var1.\n";



    // Read variable 1

    $var2   =   shm_get_var ($shm_id, 2);

    if ($var1 === false)

    {

        echo "Fail to retrive Var 2 from Shared memory $shm_id, return value=$var2.\n";

    }

    else

        echo "Read var2=$var2.\n";



    // Release semaphore

    if (!sem_release($sem_id))

        echo "Fail to release $sem_id semaphore.\n";

    else

        echo "Semaphore $sem_id released.\n";



    // remove shared memory segmant from SysV

    if (shm_remove ($shm_id))

        echo "Shared memory successfully removed from SysV.\n";

    else

        echo "Fail to remove $shm_id shared memory from SysV.\n";



    // Remove semaphore

    if (sem_remove($sem_id))

        echo "semaphore removed successfully from SysV.\n";

    else

        echo "Fail to remove $sem_id semaphore from SysV.\n";

    echo "End.\n";

mikew at php dot net
01-Jun-2001 04:46


As for security,   please look at the perm argument to shm_get.   Shared Memory blocks has the same permission semantics as unix user/group/other file permissions.   As long as your webserver is running as a user that no other users can script to..  and as long as the permissions are set to 600,  you should be fine and have no security concerns.

php at stolt dot de
21-Sep-2000 06:58


The integer keys for sem_get() and shm_attach() have to be systemwide unique. There is no method to ensure that no other process on the system will use your specific key (security! and possible malfunction). Also shared memory is very seldom used there are possibilities for conflicts! To see the used id's you can use the program 'ipcs' (at least under SuseLinux;) ). Thanks Christian C.

add a note


	downloads \| documentation \| faq \| getting help \| mailing lists \| \| php.net sites \| links \| my php.net

search for in the