msgget(2)                                                         msgget(2)

NAME
     msgget - Kennung für Nachrichten-Warteschlangen bestimmen

SYNTAX
     #include <sys/msg.h>

     int msgget(keyt key, int msgflg);

BESCHREIBUNG
     msgget() gibt die key (Schlüssel) zugeordnete Kennung der
     Nachrichten-Warteschlange zurück.

     Eine Kennung der Nachrichten-Warteschlange sowie die zugehörige Nach-
     richten-Warteschlange und Datenstruktur werden für key (Schlüssel)
     erstellt, wenn einer der folgenden Punkte wahr ist:

     -  key ist gleich IPCPRIVATE .

     -  key wurde noch keine Kennung für eine Nachrichten-Warteschlange
        zugeordnet und (msgflg&IPCCREAT) ist wahr.

     Bei der Erzeugung wird die zur neuen Kennung der Nachrichten-
     Warteschlange gehörende Datenstruktur wie folgt initialisiert:

     -  msgperm.cuid, msgperm.uid, msgperm.cgid und msgperm.gid werden
        so gesetzt, daß sie gleich der effektiven Benutzernummer bzw.
        gleich der effektiven Gruppennummer des aufrufenden Prozesses sind.

     -  Die niederwertigen 9 Bits von msgperm.mode werden so gesetzt, daß
        sie den niederwertigen 9 Bits von msgflg entsprechen.

     -  msgqnum, msglspid, msglrpid, msgstime und msgrtime werden auf
        0 gesetzt.

     -  msgctime wird auf die aktuellen Uhrzeit gesetzt.

     -  msgqbytes wird auf den Systemgrenzwert gesetzt.

     msgget() ist erfolglos, wenn einer oder mehrere der nachstehenden
     Punkte zutreffen:

     EACCES    Eine Kennung der Nachrichten-Warteschlange ist für key vor-
               handen, jedoch wird entsprechend den niederwertigen 9 Bits
               von msgflg keine Zugriffserlaubnis erteilt.

     ENOENT    Für key ist keine Kennung der Nachrichten-Warteschlange vor-
               handen, und (msgflg&IPCCREAT) ist nicht wahr.








Seite 1                      Reliant UNIX 5.44               Gedruckt 11/98

msgget(2)                                                         msgget(2)

     ENOSPC    Es soll eine Kennung der Nachrichten-Warteschlange erstellt
               werden, jedoch wird die systembedingte Höchstzahl von insge-
               samt im System zulässigen Kennungen der Nachrichten-
               Warteschlangen überschritten.

     EEXIST    Für key ist eine Kennung der Nachrichten-Warteschlange vor-
               handen, jedoch sind (msgflg&IPCCREAT) und (msgflg&IPCEXCL)
               beide wahr.

ERGEBNIS
     Nach erfolgreicher Beendigung wird eine nicht negative ganze Zahl,
     d. h. eine Kennung der Nachrichten-Warteschlange, zurückgegeben.
     Andernfalls wird -1 zurückgegeben, und errno wird zur Anzeige des Feh-
     lers gesetzt.

SIEHE AUCH
     msgctl(2), msgop(2), stdipc(3C).





































Seite 2                      Reliant UNIX 5.44               Gedruckt 11/98