git.infodrom.org Git - infodrom/manpages-de/blob - man2/shmget.2

   1 .\" Copyright (c) 1993 Luigi P. Bai (lpb@softint.com) Juliy 28, 1993
   2 .\"
   3 .\" Permission is granted to make and distribute verbatim copies of this
   4 .\" manual provided the copyright notice and this permission notice are
   5 .\" preserved on all copies.
   6 .\"
   7 .\" Permission is granted to copy and distribute modified versions of this
   8 .\" manual under the conditions for verbatim copying, provided that the
   9 .\" entire resulting derived work is distributed under the terms of a
  10 .\" permission notice identical to this one
  11 .\"
  12 .\" Since the Linux kernel and libraries are constantly changing, this
  13 .\" manual page may be incorrect or out-of-date.  The author(s) assume no
  14 .\" responsibility for errors or omissions, or for damages resulting from
  15 .\" the use of the information contained herein.  The author(s) may not
  16 .\" have taken the same level of care in the production of this manual,
  17 .\" which is licensed free of charge, as they might when working
  18 .\" professionally.
  19 .\"
  20 .\" Formatted or processed versions of this manual, if unaccompanied by
  21 .\" the source, must acknowledge the copyright and authors of this work.
  22 .\"
  23 .\" Modified Wed Juli 28 10:57:35 1993, Rik Faith <faith@cs.unc.edu>
  24 .\" Modified Sun November 28 16:43:30 1993, Rik Faith <faith@cs.unc.edu>
  25 .\"          with material from Giorgio Ciucci <giorgio@crcc.it>
  26 .\" Portions Copyright 1993 Giorgio Ciucci <giorgio@crcc.it>
  27 .\" Modified Tue Oktober 22 22:03:17 1996 by Eric S. Raymond <esr@thyrsus.com>
  28 .\"
  29 .\" Translated into German by Ralf Demmer, Translation & Consulting
  30 .\" rdemmer@rdemmer.de, http://www.rdemmer.de
  31 .\" Berlin, 29.1.1999
  32 .\"
  33 .TH SHMGET 2 "28. November 1993" "Linux 0.99.11" "Systemaufrufe"
  34 .SH BEZEICHNUNG
  35 shmget \- weist ein gemeinsames Speichersegment zu
  36 .SH "ÜBERSICHT"
  37 .ad l
  38 .B #include <sys/ipc.h>
  39 .sp
  40 .B #include <sys/shm.h>
  41 .sp
  42 .BI int shmget(key_t  key , int  size , int  shmflg );
  43 .ad b
  44 .SH BESCHREIBUNG
  45 .B shmget()
  46 gibt den Identifikator des gemeinsamen Speichersegments zurück, der dem
  47 Wert des Arguments
  48 .IR key
  49 zugewiesen ist.  Ein neues gemeinsames Speichersegment mit der um
  50 .I size
  51 auf ein mehrfaches von
  52 .BR PAGE_SIZE
  53 aufgerundeten Größe wird nur dann erstellt,
  54 .I key
  55 den Wert
  56 .B IPC_PRIVATE
  57 hat oder
  58 .I key
  59 nicht
  60 .BR IPC_PRIVATE
  61 ist, sonst wird dem Wert
  62 .IR key
  63 kein gemeinsames Speichersegment zugeordnet, und
  64 .B IPC_CREAT
  65 im
  66 .I shmflg
  67 wird gesetzt (d.h.
  68 .IB shmflg &IPC_CREAT
  69 ergibt nicht NULL).
  70 The presence in
  71 .PP
  72 .I shmflg
  73 besteht aus:
  74 .TP 12
  75 .B IPC_CREAT
  76 für das Erstellen eines neuen Segments.  Wenn dieses Flag nicht belegt wird,
  77 sucht
  78 .B shmget()
  79 das
  80 .I key
  81 zugeordnete Segment, prüft, ob der Benutzer die nötigen Rechte besitzt, um
  82 die dem Segment zugeordnete
  83 .I shmid
  84 zu erhalten und stellt sicher, dass das Segment nicht zum Löschen markiert ist.
  85 .TP
  86 .B IPC_EXCL
  87 sorgt im Verbund mit
  88 .B IPC_CREAT
  89 für eine Fehlermeldung, falls das Segment bereits existiert.
  90 .TP
  91 .B mode_flags (untere 9 Bit)
  92 legt die Rechte für den Eigentümer, die Benutzergruppe und den Rest der Welt
  93 fest.  Zurzeit werden die Ausführungsrechte vom System nicht verwendet.
  94 .PP
  95 Wenn ein neues Segment erstellt wird, werden die Zugriffsrechte von
  96 .I shmflg
  97 in den
  98 .I shm_perm
  99 -Teil des
 100 .I shmid_ds
 101 -Struktur kopiert, die das Segment definiert. Die
 102 .IR shmid_ds -Struktur:
 103 .PP
 104 .in +0.5i
 105 .nf
 106 struct shmid_ds {
 107         struct  ipc_perm shm_perm;      /* Rechte */
 108         int     shm_segsz;              /* Größe des Segments in Byte */
 109         time_t  shm_atime;              /* letzte Anhangszeitpunkt */
 110         time_t  shm_dtime;              /* letzter Entkopplungszeitpunkt */
 111         time_t  shm_ctime;              /* letzter Änderungszeitpunkt */
 112         unsigned short  shm_cpid;       /* PID des Erzeugers */
 113         unsigned short  shm_lpid;       /* PID des letzten Operators */
 114         short   shm_nattch;             /* Anzahl der momentanen Anhänge */
 115 };
 116 .fi
 117 .in -0.5i
 118 .PP
 119 .in +0.5i
 120 .nf
 121 struct ipc_perm
 122 {
 123   key_t  key;
 124   ushort uid;   /* Besitzer-euid und egid */
 125   ushort gid;
 126   ushort cuid;  /* Erzeuger-euid und egid */
 127   ushort cgid;
 128   ushort mode;  /* untere 9 Bit von \fIshmflg\fP */
 129   ushort seq;   /* Folgenummer */
 130 };
 131 .fi
 132 .PP
 133 Im weiteren initialisiert der Systemaufruf beim Erstellen die Systemdatenstruktur des gemeinsamen Speichersegments
 134 .B shmid_ds
 135 wie folgt:
 136 .IP
 137 .B shm_perm.cuid
 138 und
 139 .B shm_perm.uid
 140 werden mit den tatsächliche Benutzer\-ID des aufrufenden Prozesses belegt.
 141 .IP
 142 .B shm_perm.cgid
 143 und
 144 .B shm_perm.gid
 145 werden mit den tatsächliche Gruppen\-ID des aufrufenden Prozesses belegt.
 146 .IP
 147 Die niederwertigsten 9 Bit von
 148 .B shm_perm.mode
 149 werden den niederwertigsten 9 Bit von
 150 .IR shmflg
 151 gleichgesetzt.
 152 .IP
 153 .B shm_segsz
 154 wird mit dem Wert von
 155 .IR size.
 156 .IP
 157 .BR shm_lpid ,
 158 .BR shm_nattch ,
 159 .B shm_atime
 160 und
 161 .B shm_dtime
 162 werden auf
 163 .BR 0
 164 gesetzt.
 165 .IP
 166 .B shm_ctime
 167 wird auf die aktuelle Zeit gesetzt.
 168 .PP
 169 Wenn das gemeinsame Speichersegment bereits existiert, werden die
 170 Zugriffsrechte verglichen und überprüft, ob es zum Löschen freigegeben
 171 (bzw. markiert) wurde.
 172 .PP
 173 .SH SYSTEM CALLS
 174 .TP 0.8i
 175 .B fork()
 176 Nach einem
 177 .B fork()
 178 erbt der Kind-Prozess das angehängte gemeinsame Speichersegment.
 179 .TP
 180 .B exec()
 181 Nach einem
 182 .B exec()
 183 sind alle angehängten gemeinsamen Speichersegmente entkoppelt (nicht zerstört).
 184 .TP
 185 .B exit()
 186 Nach einem
 187 .B exit()
 188 sind alle angehängten gemeinsamen Speichersegmente entkoppelt (nicht zerstört).
 189 .PP
 190 .SH "RÜCKGABEWERT"
 191 Bei Erfolg wird ein gültiger Segment-Identifier zurückgegeben:
 192 .IR shmid ,
 193 bei Auftreten eines Fehlers \-1.
 194 .SH FEHLER
 195 Bei Auftreten eines Fehlers enthält
 196 .B errno
 197 einen der folgenden Werte:
 198 .TP 12
 199 .B EINVAL
 200 wird zurückgegeben, wenn
 201 .BR SHMMIN " >"
 202 .IR size " oder " size
 203 .RB " > " SHMMAX
 204 oder, wenn
 205 .I size
 206 größer als die Segmentgröße ist.
 207 .TP
 208 .B EEXIST
 209 wird zurückgegeben, wenn
 210 .B IPC_CREAT | IPC_EXCL
 211 angegeben wurde und das Segment existiert.
 212 .TP
 213 .B EIDRM
 214 wird zurückgegeben, wenn das Segment als zerstört markiert oder entfernt wurde.
 215 .TP
 216 .B ENOSPC
 217 wird zurückgegeben, wenn alle möglichen IDs für gemeinsame Speichersegmente
 218 .BR  ( SHMMNI )
 219 angenommen haben oder ein Segment der angeforderten
 220 .I Größe
 221 zu einer Überschreitung der systemweiten Speichergrenze für gemeinsame
 222 Speichersegmente führen würde.
 223 .BR  ( SHMALL ).
 224 .TP
 225 .B ENOENT
 226 wird zurückgegeben, wenn für den angegebenen
 227 .I key
 228 kein Segment existiert und
 229 .B IPC_CREAT
 230 nicht angegeben wurde.
 231 .TP
 232 .B EACCES
 233 wird zurückgegeben, wenn der Benutzer keine Zugriffsrechte auf das gemeinsame
 234 Speichersegment besitzt.
 235 .TP
 236 .B ENOMEM
 237 wird zurückgegeben, wenn kein Speicher für den Segment-Overhead bereitgestellt
 238 werden konnte.
 239 .SH ANMERKUNGEN
 240 .B IPC_PRIVATE
 241 ist kein Flag-Feld, sondern vom Typ
 242 .B key_t .
 243 Wenn dieser spezielle Wert für
 244 .IR key ,
 245 verwendet wird, ignoriert der Systemaufruf alles bis auf die unteren 9 Bit von
 246 .I shmflg
 247 und erstellt bei Erfolg ein neues gemeinsames Speichersegment.
 248 .PP
 249 Es gelten die folgenden Einschränkungen auf die Ressourven gemeinsamer
 250 Speichersegmente, die einen
 251 .B shmget
 252 -Aufruf betreffen:
 253 .TP 11
 254 .B SHMALL
 255 Systemweiter Maximalwert für gemeinsam genutzte Speicherblöcke: abhängig von
 256 der Politik.
 257 .TP
 258 .B SHMMAX
 259 Maximalgröße eines gemeinsamen Speichersegments in Byte: abhängig von der
 260 jeweiligen Umsetzung (momentan bei 4 MB).
 261 .TP
 262 .B SHMMIN
 263 Minimalgröße eines gemeinsamen Speichersegments: abhängig von der jeweiligen
 264 Umsetzung (momentan 1 byte, obwohl
 265 .B PAGE_SIZE
 266 die wirkliche Minimalgröße darstellt).
 267 .TP
 268 .B SHMMNI
 269 Systemweite maximale Anzahl von gemeinsamen Speichersegmenten: abhängig von
 270 der jeweiligen Umsetzung (momentan 4096).
 271 .PP
 272 Die jeweilige Umsetzung setzt keine Beschrängungen für die maximale Anzahl
 273 von gemeinsamen Speichersegmenten pro Prozess
 274 .RB ( SHMSEG ).
 275 .SH BUGS
 276 Die Verwendung von
 277 .B IPC_PRIVATE
 278 unterbindet nicht den Zugriff anderer Prozesse auf das zugeordnete gemeinsame
 279 Speichersegment.
 280 .PP
 281 Genau wie für Dateien, gibt es momentan keinen eigenständigen Weg für einen
 282 Prozess den ausschließlichen Zugriff auf ein gemeinsam genutztes
 283 Speichersegment sicherzustellen.  Die Zuweisung von
 284 .B IPC_CREAT
 285 und
 286 .B IPC_EXCL
 287 zu
 288 .I shmflg
 289 garantiert bei Erfolg nur die Erstellung eines neuen gemeinsamen
 290 Speichersegments, nicht aber den ausschließlichen Zugriff auf das Segment.
 291 .SH "KONFORM ZU"
 292 SVr4, SVID.  Unter SVr4 ist eine weitere Fehlerbedingung EEXIST dokumentiert.
 293 Weder SVr4 noch SVID enthalten eine Dokumentation zu EIDRM-Bedingungen.
 294 .SH "SIEHE AUCH"
 295 .BR ftok (3),
 296 .BR ipc (5),
 297 .BR shmctl (2),
 298 .BR shmat (2),
 299 .BR shmdt (2).
 300