Ubuntu Manpage: shmat, shmdt - System-V-Operationen mit gemeinsam benutztem Speicher

BEZEICHNUNG

       shmat, shmdt - System-V-Operationen mit gemeinsam benutztem Speicher

ÜBERSICHT

       #include <sys/types.h>
       #include <sys/shm.h>

       void *shmat(int shmid, const void *shmaddr, int shmflg);

       int shmdt(const void *shmaddr);

BESCHREIBUNG

shmat() blendet das durch shmid bezeichnete gemeinsame System-V-Speichersegment in den
Adressraum des aufrufenden Prozesses ein. Die Adresse der Einblendung wird durch shmaddr
nach einem der folgenden Kriterien bestimmt:

Falls shmaddr NULL ist, wählt das System eine geeignete (freie) Adresse, an der das
Segment eingeblendet wird.

Wenn shmaddr nicht NULL ist und SHM_RND in shmflg angegeben ist, wird die Adresse durch
Abrundung von shmaddr als Vielfaches von SHMLBA bestimmt. Andernfalls muss shmaddr eine an
einer Speicherseite ausgerichtete Adresse sein, an welcher das Einblenden beginnt.

Ist SHM_RDONLY in shmflg gesetzt, wird das Segment zum Lesen eingeblendet und der Prozess
muss die Berechtigung für Lesezugriffe auf das Segment besitzen. Andernfalls wird das
Segment zum Lesen und Schreiben eingeblendet und der Prozess muss die Berechtigung für
Lese- und Schreibzugriffe auf das Segment besitzen. Ein gemeinsames Speichersegment mit
reinem Schreibzugriff ist nicht vorgesehen.

Mit dem (Linux-spezifischen) Schalter SHM_REMAP in shmflag können Sie bestimmen, dass das
Abbilden des Segments jede vorhandene Abbildung im Bereich von shmaddr bis zum Ende des
Segments ersetzt. (Falls bereits eine Abbildung in diesem Adressbereich existiert, würde
dies normalerweise zu dem Fehler EINVAL führen.) In diesem Fall darf shmaddr nicht NULL
sein.

Der brk(2)-Wert des aufrufenden Prozesses wird durch das Einblenden nicht verändert. Das
Segment wird bei Beenden des Prozesses automatisch abgetrennt. Das gleiche Segment kann
mit Lese- sowie mit Lese- und Schreibzugriff einmal oder mehrfach an den Adressraum des
Prozesses eingeblendet werden.

Nach einem erfolgreichen shmat()-Aufruf aktualisiert das System die Bestandteile der dem
Speichersegment zugeordneten shmid_ds-Struktur (siehe shmctl(2)) wie folgt:

shm_atime wird auf die aktuelle Zeit gesetzt.

shm_lpid wird auf die Prozess-ID des aufrufenden Prozesses gesetzt.

shm_nattch wird um eins erhöht.

shmdt() löst das gemeinsame Speichersegment, das an der Adresse shmaddr liegt aus dem
Adressraum des aufrufenden Prozesses. Das zu entfernende gemeinsame Speichersegment muss
momentan mit shmaddr eingeblendet sein, das dem Rückgabewert des einbendenden
shat()-Aufrufs entspricht.

Nach einem erfolgreichen shmdt()-Aufruf aktualisiert das System die Bestandteile der dem
Speichersegment zugeordneten Struktur shmid_ds wie folgt:

shm_dtime wird auf die aktuelle Zeit gesetzt.

shm_lpid wird auf die Prozess-ID des aufrufenden Prozesses gesetzt.

shm_nattch wird um eins verringert. Wenn es dabei zu 0 wird und das Segment zum
Löschen markiert ist, wird es gelöscht.

Nach einem fork(2) erbt der Kindprozess das eingeblendete gemeinsame Speichersegment.

Nach einem exec(2) sind alle eingeblendeten gemeinsamen Speichersegmente vom Prozess
abgelöst.

Bei einem exit(2) sind alle eingeblendeten gemeinsamen Speichersegmente vom Prozess
abgelöst.

RÜCKGABEWERT

       Bei  Erfolg  gibt  shmat()  die  Adresse  des  eingeblendeten gemeinsamen Speichersegments
       zurück; bei einem Fehler wird (void *) -1 zurückgegeben und errno so gesetzt, dass es  den
       Grund des Fehlers anzeigt.

       Bei  Erfolg  gibt  shmdt()  0  zurück; bei einem Fehler wird -1 zurückgegeben und errno so
       gesetzt, dass es den Grund des Fehlers anzeigt.

FEHLER

       Wenn shmat fehlschlägt, wird errno mit einem der folgenden Werte belegt:

       EACCES Dem aufrufenden Prozess fehlen die nötigen  Zugriffsrechte  für  den  angeforderten
              Einblendetyp und die CAP_IPC_OWNER-Fähigkeit.

       EIDRM  shmid zeigt auf einen entfernten Bezeichner.

       EINVAL ungültiger   shmid-Wert,  nicht  ausgerichteter  (d.h.  nicht  an  die  Seitengröße
              angepasst und SHM_RND wurde nicht angegeben) oder ungültiger shmaddr-Wert  oder  es
              wurde SHM_REMAP angegeben und shmaddr war NULL.

       ENOMEM Es  konnte  kein  Speicher  für  den  Deskriptor oder die Seitentabellen reserviert
              werden.

       Wenn shmat() fehlschlägt, ist errno mit einem der folgenden Werte belegt:

       EINVAL Es ist kein gemeinsames Speichersegment an shmaddr eingeblendet  oder  shmaddr  ist
              nicht an der Seitengrenze ausgerichtet.

KONFORM ZU

       SVr4, POSIX.1-2001.

       In SVID 3 (oder vielleicht früher) wurde der Typ des Arguments shmaddr von char * in const
       void * und der von shmat() zurückgegebene Typ von char * in void * geändert.  (Linux-Libc4
       und -Libc5 haben die char *-Prototypen, Glibc2 hat void *.)

ANMERKUNGEN

       Die  bevorzugte,  portierbare  Möglichkeit  ein  gemeinsames  Speichersegment einzublenden
       besteht darin, shmat() mit shmaddr gleich NULL zu benutzen. Sie sollten wissen,  dass  das
       eingeblendete  gemeinsame  Speichersegment  auf  diese Art an unterschiedliche Adressen in
       unterschiedlichen Prozessen eingeblendet werden kann. Deshalb müssen  alle  innerhalb  des
       gemeinsamen  Speichers  verwalteten  Zeiger  relativ  (typischerweise zur Startadresse des
       Segments) statt absolut sein.

       Auf Linux ist es möglich, sogar ein  gemeinsames  Speichersegment  einzublenden,  wenn  es
       bereits  zum Löschen markiert ist. POSIX.1-2001 spezifiziert dieses Verhalten jedoch nicht
       und andere Implementierungen unterstützen es nicht.

       Der folgende Systemparameter beeinflusst shmat():

       SHMLBA Adress-Multiplikator  der  Segmentuntergrenze.  Muss  seitenkonform  sein.  In  der
              aktuellen Implemtentierung ist der Wert von SHMBLA gleich PAGE_SIZE.

       Die  Implemtentierung  hat  keinen  wesentlichen  Einschränkungen der maximalen Anzahl von
       gemeinsamen Speichersegmenten pro Prozess (SHMSEG)

SIEHE AUCH

       brk(2), mmap(2), shmctl(2), shmget(2), capabilities(7), shm_overview(7), svipc(7)

KOLOPHON

       This page is part of release 3.54 of the Linux man-pages project.  A  description  of  the
       project,     and    information    about    reporting    bugs,    can    be    found    at
       http://www.kernel.org/doc/man-pages/.

ÜBERSETZUNG

       Die deutsche Übersetzung dieser Handbuchseite wurde von Ralf  Demmer  <rdemmer@rdemmer.de>
       und Chris Leick <c.leick@vollbio.de> erstellt.

       Diese  Übersetzung  ist  Freie  Dokumentation;  lesen  Sie  die GNU General Public License
       Version  3  oder  neuer  bezüglich  der  Copyright-Bedingungen.  Es  wird  KEINE   HAFTUNG
       übernommen.

       Wenn Sie Fehler in der Übersetzung dieser Handbuchseite finden, schicken Sie bitte eine E-
       Mail an <debian-l10n-german@lists.debian.org>.