Zahn - Unix-Netzwerkprogramminerung mit Threads, Sockets und SSL

2.2 Ein- und Ausgabe 25
Die Funktion read() versucht, genau nbyte Bytes über den spezifizierten
Dateideskriptor in den übergebenen Puffer buf einzulesen. Die Maximalgröße
für nbyte wird vom System über die Konstante SSIZE_MAX festgelegt. Im
Erfolgsfall liefert read() eine nicht-negative ganze Zahl, nämlich die Anzahl
der tatsächlich eingelesenen Bytes zurück. Wird der Wert 0 zurückgeliefert,
so ist das Ende der Datei bzw. des Datenstroms erreicht. Ein Rückgabewert
von -1 signalisiert, daß beim Lesen der Daten ein Fehler aufgetreten ist. Die
genaue Fehlerursache findet sich in diesem Fall in errno.
Selbstverständlich ist die Anzahl der gelesenen Bytes niemals größer als nbyte.
Es kann aber durchaus vorkommen, daß weniger als nbyte Bytes gelesen werden,
z. B. wenn read() durch ein Signal unterbrochen wurde 2 oder wenn die
zu lesende Datei nicht mehr so viele Daten enthält wie eingelesen werden sollen.
Beispiel: Eine Datei enthält 50 Zeichen, das Programm versucht aber,
100 Zeichen einzulesen. Auch beim Lesen von speziellen Geräten wie Terminal
oder Bandlaufwerk kann es vorkommen, daß weniger Bytes als gefordert
gelesen werden. Mehr dazu in den Beispielen 2.3 und 2.4.
Mit der Funktion write() können Daten über einen Dateideskriptor in eine
zuvor geöffnete Datei geschrieben werden. write() hat die gleichen Parameter
wie die read()-Funktion, nur dient diesmal der Puffer als Quelle und der
Dateideskriptor als Ziel.
#include
ssize_t write( int fildes , const void *buf,
size_t nbyte );
Aus dem übergebenen Puffer buf werden genau nbyte Bytes über den Dateideskriptor
ausgegeben. Wurde die Datei mit dem Attribut O_APPEND geöffnet,
so werden die Daten jeweils ans Dateiende angefügt. Auch hier ist die Maximalgröße
für nbyte vom System über die Konstante SSIZE_MAX festgelegt. Im
Erfolgsfall gibt write() die Anzahl der tatsächlich ausgegebenen Bytes als
ganze Zahl größer 0 zurück. Ein Rückgabewert von -1 signalisiert, daß beim
Schreiben der Daten ein Fehler aufgetreten ist. Die genaue Fehlerursache findet
sich dann in errno.
Auch bei write() ist die Anzahl der geschriebenen Bytes niemals größer als
nbyte. Wie bei read() kann es bei write() natürlich ebenfalls vorkommen,
daß weniger als nbyte Bytes geschrieben werden, z. B. wenn write() durch
2 In früheren Versionen des Standards war es optional, ob read() in diesem Fall
die Anzahl der bereits eingelesenen Bytes liefert, oder den Fehlerwert -1 zurück
gibt und errno auf EINTR setzt.