Provided by:
manpages-de-dev_0.8-1_all 
BEZEICHNUNG
read - von einer Datei lesen
Diese Handbuchseite ist eventuell veraltet. Im Zweifelsfall ziehen Sie
die englischsprachige Handbuchseite zu Rate, indem Sie
man -LC 2 read
eingeben.
SYNOPSIS
#include <unistd.h>
ssize_t read(int fd, void *buf, size_t count);
BESCHREIBUNG
read versucht aus der fd zugeordneten Datei count Bytes in den Puffer,
auf den buf zeigt, zu schreiben. POSIX fordert, dass ein nachweisbar
nach der Ruckkehr von write() liegendes read() die neuen Daten liefern
muss. Es sollte jedoch beachtet werden, dass nicht alle Dateisysteme
POSIX-konform sind.
R"UCKGABEWERT
Bei Erfolg wird die Anzahl von gelesenen Bytes zuruckgegeben. Dies
konnen weniger als count Bytes sein, falls in einer regularen Datei ab
der aktuellen Position nur noch weniger Bytes vorhanden sind, read()
durch ein Signal unterbrochen wurde oder falls von einer nicht-
regularen Datei ohne Verzogerung nicht mehr Bytes gelesen werden
konnen. Im Fehlerfalle wird -1 zuruckgegeben und errno wird
entsprechend gesetzt.
FEHLER
EINTR Der Aufruf wurde durch ein Signal unterbrochen bevor Daten
gelesen wurden.
EAGAIN Mit O_NONBLOCK wurde nicht-blockierende Ein-/Ausgabe gewahlt und
es lagen keine Daten zum sofortigen Lesen an.
EISDIR fd referenziert ein Verzeichnis.
EBADF fd Ist keine gultige Dateikennzahl oder wurde nicht zum Lesen
geoffnet.
EINVAL fd gehort zu einer Datei, welche nicht zum Lesen geeignet ist.
EFAULT buf ist auBerhalb Deines ansprechbaren Adressraumes.
Abhangig vom Objekt, welches mit fd verbunden ist, konnen auch andere
Fehler auftreten. POSIX spezifiziert nicht die Position in der Datei,
nachdem ein Fehlers auftrat. Falls read() bereits einige Bytes gelesen
hat und dann ein Signal auftritt, so ist nicht spezifiziert, ob es erst
mit der Anzahl der Bytes oder mit -1 zuruckkehrt.
KONFORM ZU
SVID, AT&T, POSIX, X/OPEN, BSD 4.3
SIEHE AUCH
readdir(2), write(2), write(2), fcntl(2), close(2), lseek(2),
select(2), readlink(2), ioctl(2), fread(3).