shm_remove

(PHP 4, PHP 5, PHP 7, PHP 8)

shm_removeEntfernt einen gemeinsamen Speicherbereich unter UNIX

Beschreibung

shm_remove ( SysvSharedMemory $shm ) : bool

shm_remove() entfernt den durch shm angegebene gemeinsamen Speicherbereich. Die in diesem Bereich abgelegten Daten gehen dabei verloren.

Parameter-Liste

shm

Ein gemeinsamer Speicherbereich, wie er von shm_attach() zurückgegeben wurde.

Rückgabewerte

Gibt bei Erfolg true zurück. Im Fehlerfall wird false zurückgegeben.

Changelog

Version Beschreibung
8.0.0 shm erwartet nun eine SysvSharedMemory-Instanz; vorher wurde eine resource erwartet.

Siehe auch

add a note add a note

User Contributed Notes 3 notes

up
1
aaron DURP segura DURP gmail DURP com
14 years ago
It appears that you must be connected to the shm segment in order to remove it.

<?php
shm_remove
($shm);
shm_detach($shm);
?>

works, while

<?php
shm_detach
($shm);
shm_remove($shm);
?>

produces "Warning: shm_remove(): The parameter is not a valid shm_identifier ..."
up
0
HansRich
7 years ago
WARNING: this function WILL NOT destroy the memory segment if there are other processes attached to it, but it will return TRUE anyways!

You will have to try to access the segment again after destroying it to make sure it was relly destroyed.
up
-1
cu at ulakbim dot gov dot tr
21 years ago
Though it says **shm_identifier** in
  int shm_remove(int shm_identifier);
and
  shm_attach() returns an **id** that that can be used to access the System V...

a snippet like this:
<?php
  $key
= 1234;
 
$shm=shm_attach($key);
 
// do whatever...
 
shm_remove($shm);
?>

produces an error like
Warning: 2(which is the value of $shm) is not a existing SysV shared memory key in /usr/cu/web/sema.php on line 44...

The documentation confused me a bit. I thought shm_remove would get the shm handle/id that returns from shm_attach, not the key given to shm_attach. So, use instead:
  shm_remove($key);

which is what is intended indeed.
To Top