.\" Copyright 1993 Giorgio Ciucci (giorgio@crcc.it)
.\"
.\" Permission is granted to make and distribute verbatim copies of this
.\" manual provided the copyright notice and this permission notice are
.\" preserved on all copies.
.\"
.\" Permission is granted to copy and distribute modified versions of this
.\" manual under the conditions for verbatim copying, provided that the
.\" entire resulting derived work is distributed under the terms of a
.\" permission notice identical to this one
.\" 
.\" Since the Linux kernel and libraries are constantly changing, this
.\" manual page may be incorrect or out-of-date.  The author(s) assume no
.\" responsibility for errors or omissions, or for damages resulting from
.\" the use of the information contained herein.  The author(s) may not
.\" have taken the same level of care in the production of this manual,
.\" which is licensed free of charge, as they might when working
.\" professionally.
.\" 
.\" Formatted or processed versions of this manual, if unaccompanied by
.\" the source, must acknowledge the copyright and authors of this work.
.\" Translated into German by Mike Fengler (mike@krt3.krt-soft.de)
.\"
.TH IPC 5 "27. Dezember 1998" "Linux 0.99.13" "Dateiformate"
.SH BEZEICHNUNG
ipc \- System V Mechanismen fr Kommunikation zwischen Prozessen
.SH "BERSICHT"
.nf
.B
# include <sys/types.h>
.B
# include <sys/ipc.h>
.B
# include <sys/msg.h>
.B
# include <sys/sem.h>
.B
# include <sys/shm.h>
.SH BESCHREIBUNG
Diese Handbuchseite bezieht sich auf die System V Mechanismen fr 
Kommunikation zwischen Prozessen, wie sie in Linux verwirklicht
wurden: message queues, semaphore sets und shared memory segments.
(Zumindest einmal soll denn doch eine bersetzung versucht werden:
Nachrichten - Warteschlangen, Semaphoren (Sperr/Frei - Vermerke)
und gemeinsam genutzte Speicherbereiche. Oh Himmel. A.d.b.)
Im folgenden bedeutet das Wort 
.B Resource
eine konkrete Erscheinung (instantiation) einer dieser Mechanismen.
.SS Resource Zugriffsrechte
Fr jede Resource verwaltet das System in einer allgemeinen
Struktur des Typs
.BR "struct ipc_perm"
die Informationen, die zur Bestimmung der Rechte auf eine ipc - 
Operation notwendig sind.
Die
.B ipc_perm
Structur, definiert von der
.I <sys/ipc.h>
system header Datei, enthlt folgende Elemente:
.sp
.B
	ushort cuid;	
/* Benutzerkennung des Erzeugers */
.br
.B
	ushort cgid;	
/* Gruppenkennung des Erzeugers */
.br
.B
	ushort uid;
/* Kennung des Eigentmers */
.br
.B
	ushort gid;
/* Gruppenkennung des Eigentmers */
.br
.B
	ushort mode;
/* Lese/Schreib - Rechte */
.PP
Das
.B mode
Element der
.B ipc_perm
Struktur bestimmt mit seinen 9 niedrigstwertigen Bits die
Zugriffsrechte auf die Resource fr einen Proze, der einen
ipc Systemaufruf ausfhrt.  Die Rechte werden wie folgt interpretiert:
.sp
.nf
	0400	Eigentmer darf lesen
	0200	Eigentmer darf schreiben
.sp .5
	0040	Gruppe darf lesen
	0020	Gruppe darf schreiben
.sp .5
	0004	Andere drfen lesen
	0002	Andere drfen schreiben
.fi
.PP
Bits 0100, 0010 und 0001 (die Ausfhrungsbits) werden nicht benutzt.
Darberhinaus bedeutet "schreiben" eigentlich "verndern", soweit
es sich auf ein semaphore set bezieht.
.PP
Die selbe system header Datei definiert auch folgende symbolische
Konstanten:
.TP 14
.B IPC_CREAT
Eintrag erzeugen, wenn Schlssel nicht vorhanden.
.TP
.B IPC_EXCL
Mierfolg, wenn Schlssel vorhanden.
.TP
.B IPC_NOWAIT
Fehlermeldung, wenn die Anforderung warten mu.
.TP
.B IPC_PRIVATE
Privater Schlssel.
.TP
.B IPC_RMID
Resource beseitigen.
.TP
.B IPC_SET
Setzen von Optionen der Resource.
.TP
.B IPC_STAT
Ansehen der Optionen der Resource.
.PP
Beachten Sie, da
.B IPC_PRIVATE
vom Typ
.B key_t
ist. Alle anderen symbolischen Konstanten sind Flag - Felder, die
mit Variablen des Typs
.B int
ODER - verknpft werden knnen.
.SS Message Queues
Eine message queue wird eindeutig identifiziert ber einen
positiven Integerwert
.RI "(ihre " msqid )
und ist mit einer Datenstruktur verbunden, die vom Typ
.BR "struct msquid_ds" 
ist, definiert in
.IR <sys/msg.h> .
Diese hat folgende Elemente:
.sp
.B
	struct ipc_perm msg_perm;
.br
.B
	ushort msg_qnum;	
/* Anzahl wartende messages */
.br
.B
	ushort msg_qbytes;	
/* Bytes max in einer queue */
.br
.B
	ushort msg_lspid;	
/* pid des letzten msgsnd */
.br
.B
	ushort msg_lrpid;	
/* pid des letzten msgrcv */
.br
.B
	time_t msg_stime;	
/* Zeit des letzten msgsnd */
.br
.B
	time_t msg_rtime;	
/* Zeit des letzten  msgrcv */
.br
.B
	time_t msg_ctime;	
/* Zeit der letzten nderung */
.TP 11
.B msg_perm
.B ipc_perm
Struktur, die die Zugriffsrechte auf die message queue angibt.
.TP
.B msg_qnum
derzeitige Anzahl der Messages in der Queue.
.TP
.B msg_qbytes
Maximale Anzahl an Bytes Messagetext, die in der Message Queue
erlaubt sind.
.TP
.B msg_lspid
ID des Prozesses, der zuetzt den
.B msgsnd
Systemaufruf gettigt hat.
.TP
.B msg_lrpid
ID des Prozesses, der zuetzt den
.B msgrcv
Systemaufruf gettigt hat.
.TP
.B msg_stime
Zeitpunkt des letzten
.B msgsnd
Systemaufrufs.
.TP
.B msg_rtime
Zeitpunkt des letzten
.B msgcv
Systemaufrufs.
.TP
.B msg_ctime
Zeitpunkt des letzten Systemaufrufs, bei dem ein Element der
.B msqid_ds
Struktur gendert wurde.
.SS Semaphore Sets
Ein Semaphore Set wird eindeutig identifiziert durch einen
positiven Integerwert
.RI "(seine " semid )
und ist mit einer Datenstruktur vom Typ
.BR "struct semid_ds" ,
verbunden, definiert in
.IR <sys/sem.h> ,
die folgende Elemente enthlt:
.sp
.B
	struct ipc_perm sem_perm;
.br
.B
	time_t sem_otime;	
/* Zeit des letzten Aufrufs */
.br
.B
	time_t sem_ctime;	
/* Zeit der letzten derung */
.br
.B
	ushort sem_nsems;	
/* Anzahl Semaphoren im Set */
.TP 11
.B sem_perm
.B ipc_perm
Struktur fr die Zugriffsrechte auf das Semphorenset.
.TP
.B sem_otime
Zeitpunkt des letzten
.B semop
Systemaufrufs.
.TP
.B sem_ctime
Zeitpunkt des letzten
.B semctl
Systemaufrufs, der einen Eintrag o.g. Struktur oder eine zum Set 
gehrende Semaphore gendert hat.
.TP
.B sem_nsems
Anzahl der Semaphoren im Set. Jede Semaphore des Sets wird 
reprsentiert durch einen nicht negativen Integerwert zwischen
.B 0
und
.BR sem_nsems\-1 .
.PP
Eine Semaphore ist eine Datenstruktur des Typs
.B "struct sem"
mit folgenden Eintrgen:
.sp
.B
	ushort semval;	
/* Semaphorenwert */
.br
.B
	short sempid;	
/* pid des letzten Aufrufs */
.br
.B
	ushort semncnt;	
/* Anzahl Prozesse 1 (s.w.u.) */
.br
.B
	ushort semzcnt;	
/* Anzahl Prozesse 2 (s.w.u.) */
.TP 11
.B semval
Semaphorenwert: eine nicht - negativea Ganzzahl.
.TP
.B sempid
ID des letzten Prozesses, der mit dieser Semaphore eine
Semaphorenoperation ausfhrte.
.TP
.B semncnt
Anzahl Prozesse 1. Gemeint sind die Prozesse, die darauf warten,
da
.B semval
erhht wird.
.TP
.B semznt
Anzahl Prozesse 2. Gemeint sind die Prozesse, die darauf warten, da
.B semval
den Wert 0 annimmt.
.SS Shared Memory Segments
Ein Shared Memory Segment wird eindeutig identifiziert durch eine
positive Ganzzahl
.RI "(seine " shmid )
und ist verbunden mit einer Datenstruktur vom Typ
.BR "struct shmid_ds" ,
definiert in
.IR <sys/shm.h> ,
mit folgenden Eintrgen:
.sp
.B
	struct ipc_perm shm_perm;
.br
.B
	int shm_segsz;	
/* Gre des Segments */
.br
.B
	ushort shm_cpid;	
/* pid des Erzeugers */
.br
.B
	ushort shm_lpid;	
/* pid, letzte Operation */
.br
.B
	short shm_nattch;	
/* Anzahl derzeitiger Anbindungen */
.br
.B
	time_t shm_atime;	
/* Zeit der letzten Anbindung */
.br
.B
	time_t shm_dtime;	
/* Zeit der letzten Freigabe */
.br
.B
	time_t shm_ctime;	
/* Zeit der letzten nderung */
.TP 11
.B shm_perm
.B ipc_perm
Struktur, die die Zugriffsrechte auf das Shared Memory Segment
definiert.
.TP
.B shm_segsz
Gre des Segments in Bytes.
.TP
.B shm_cpid
ID des Prozesses, der das Shared Memory Segment erzeugt hat.
.TP
.B shm_lpid
ID des letzten Prozesses, der den
.B shmat
oder
.B shmdt
Systemaufruf ausgefhrt hat.
.TP
.B shm_nattch
Anzahl von Prozessen, die derzeit mit diesem Shared Memory Segment 
arbeiten (attaches).
.TP
.B shm_atime
Zeit des letzten
.B shmat
Systemaufrufs.
.TP
.B shm_dtime
Zeit des letzten
.B shmdt
Systemaufrufs.
.TP
.B shm_ctime
Zeit des letzten
.B shmctl
Systemaufrufs,der
.BR shmid_ds 
verndert hat.
.SH "SIEHE AUCH"
.BR ftok (3),
.BR msgctl (2),
.BR msgget (2),
.BR msgrcv (2),
.BR msgsnd (2),
.BR semctl (2),
.BR semget (2),
.BR semop (2),
.BR shmat (2),
.BR shmctl (2),
.BR shmget (2),
.BR shmdt (2).