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(SysvMessageQueue $queue): array|false

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:

Die Array-Struktur für msg_stat_queue
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

add a note add a note

User Contributed Notes

There are no user contributed notes for this page.
To Top