msg_stat_queue
(PHP 4 >= 4.3.0, PHP 5, PHP 7, PHP 8)
msg_stat_queue — Liefert Informationen zur Datenstruktur einer Nachrichten-Warteschlange
Beschreibung
msg_stat_queue() liefert die Metadaten zu der mit
queue
angegebenen Nachrichten-Warteschlange. Diese
Informationen können z.B. genutzt werden, um herauszufinden welcher Prozess
eine gerade empfangene Nachricht gesendet hat.
Parameter-Liste
-
queue
-
Die Nachrichten-Warteschlange.
Rückgabewerte
Bei Erfolg ist der Rückgabewert ein Array, dessen Schlüssel und Werte die folgende Bedeutung haben:
msg_perm.uid |
Die Benutzer-ID des Besitzers der Warteschlange. |
msg_perm.gid |
Die Gruppen-ID des Besitzers der Warteschlange. |
msg_perm.mode |
Der Dateizugriffsmodus der Warteschlange. |
msg_stime |
Der Zeitpunkt, zu dem die letzte Nachricht an die Warteschlange gesendet wurde. |
msg_rtime |
Der Zeitpunkt, zu dem die letzte Nachricht von der Warteschlange empfangen wurde. |
msg_ctime |
Der Zeitpunkt, zu dem sich der Status der Warteschlange zuletzt geändert hat. |
msg_qnum |
Die Anzahl der Nachrichten, die sich zur Zeit noch in der Warteschlange befinden. |
msg_qbytes |
Die maximal erlaubte Anzahl von Bytes in einer Nachrichten-Warteschlange. Unter Linux kann dieser Wert über /proc/sys/kernel/msgmnb gelesen und verändert werden. |
msg_lspid |
Die Prozess-ID des Prozesses, der die letzte Nachricht an die Warteschlange gesendet hat. |
msg_lrpid |
Die Prozess-ID des Prozesses, der die letzte Nachricht aus der Warteschlange empfangen hat. |
Gibt bei Auftreten eines Fehlers false
zurück.
Changelog
Version | Beschreibung |
---|---|
8.0.0 |
queue erwartet nun eine
SysvMessageQueue-Instanz; vorher wurde eine
resource erwartet.
|
Siehe auch
- msg_remove_queue() - Entfernt eine Nachrichten-Warteschlange
- msg_receive() - Liest eine Nachricht aus einer Nachrichten-Warteschlange aus
- msg_get_queue() - Legt eine Nachrichten-Warteschlange an oder hängt sich an existierende an
- msg_set_queue() - Setzt Metadaten in der Datenstruktur der Nachrichten-Warteschlange