BEZEICHNUNG¶

ÜBERSICHT¶

#include <unistd.h>

ssize_t read(int fd, void *buf, size_t count);

BESCHREIBUNG¶

Bei Dateien, die das Durchsuchen unterstützen, beginnt der Lesevorgang am Offset der Datei, wobei der Datei-Offset durch die Anzahl der gelesenen Bytes erhöht wird. Falls der Datei-Offset am Ende oder hinter dem Ende der Datei liegt, werden keine Bytes gelesen und read() gibt Null zurück.

Falls count Null ist, kann read() eventuell die nachfolgend beschriebenen Fehler erkennen. Ohne jegliche Fehlermeldungen, oder wenn read() nicht auf Fehler prüft, gibt ein Aufruf von read() und wenn count 0 ist, Null zurück und hat keine weiteren Auswirkungen.

Laut POSIX.1 hängt das Ergebnis von der Implementierung ab, falls count größer als SSIZE_MAX ist; siehe ANMERKUNGEN für die Obergrenze unter Linux.

RÜCKGABEWERT¶

Im Fehlerfall wird -1 zurückgegeben und errno wird entsprechend gesetzt. In diesem Fall ist nicht festgelegt, ob die Position in der Datei (wenn es überhaupt eine gibt) geändert wird.

FEHLER¶

EAGAIN

Der Dateideskriptor fd bezieht sich auf eine Datei, die kein Socket ist, und wurde als nicht blockierend (O_NONBLOCK) markiert und das Lesen würde blockieren. Siehe open(2) für weitere Details über den Schalter O_NONBLOCK.

EAGAIN oder EWOULDBLOCK

Der Dateideskriptor fd bezieht sich auf ein Socket und wurde als nicht blockierend (O_NONBLOCK) markiert und das Lesen würde blockieren. POSIX.1-2001 erlaubt in diesem Fall, dass eine der beiden Fehlermeldungen zurückgeliefert wird und verlangt nicht, dass beide Konstanten den gleichen Wert haben. Daher sollten portable Anwendungen auf beide Möglichkeiten prüfen.

EBADF

fd ist kein gültiger Deskriptor oder ist nicht zum Lesen geöffnet.

EFAULT

buf liegt außerhalb Ihres adressierbaren Adressraums.

EINTR

Der Aufruf wurde durch ein Signal unterbrochen, bevor Daten gelesen wurden; siehe signal(7).

EINVAL

fd ist einem Objekt zugeordnet, aus dem nicht gelesen werden kann; oder die Datei wurde mit dem Schalter O_DIRECT geöffnet und entweder die in buf angegebene Adresse, der in count angegebene Wert oder der Datei-Offset ist nicht entsprechend ausgerichtet.

EINVAL

fd wurde über einen Aufruf von timerfd_create(2) erstellt und der falsche Größenpuffer wurde an read() übergeben; siehe timerfd_create(2) für weitere Informationen.

EIO

E/A-Fehler. Dies wird zum Beispiel passieren, wenn der Prozess zu einer Hintergrund-Prozessgruppe gehört und versucht, von seinem steuernden Terminal zu lesen und er entweder SIGTTIN ignoriert oder sperrt oder seine Prozessgruppe verwaist ist. Es kann auch durch einen Low-Level-E/A-Fehler während des Lesens von einer Platte oder einem Band gesetzt werden. Ein weitere mögliche Ursache von EIO bei Netzwerkdateisystemen sind empfohlene Sperren, die aus dem Dateideskriptor herausgenommen wurden, und diese Sperre dann verloren gegangen ist. Siehe den Abschnitt Verlorene Sperren von fcntl(2) für weitere Details.

EISDIR

fd referenziert ein Verzeichnis.

Abhängig von dem mit fd verbundenen Objekt können andere Fehler auftreten.

KONFORM ZU¶

ANMERKUNGEN¶

Unter Linux wird read() (und ähnliche Systemaufrufe) höchstens 0x7ffff000 (2.147.479.552) Byte übertragen und die Anzahl der tatsächlich übertragenen Bytes zurückliefern. Dies trifft sowohl auf 32- als auch auf 64-Bit-Systemen zu.

Auf NFS-Dateisystemen aktualisiert das Lesen kleiner Datenmengen den Zeitstempel nur beim ersten Mal, nachfolgende Anrufe können das nicht tun. Dies wird durch das clientseitige »attribute caching« (Zwischenspeichern der Attribute) verursacht, weil die meisten, wenn nicht alle NFS-Clients die Aktualisierung von st_atime (die letzte Zugriffszeit) dem Server überlassen und Leseaktionen auf Clientseite, die aus seinem Cache bedient werden, st_atime nicht aktualisieren, weil nicht vom Server gelesen wird. UNIX-Semantik kann durch Deaktivieren des clientseitigen attribute cachings erhalten werden, aber in den meisten Fällen wird dadurch die Serverlast deutlich erhöht und die Leistung verringert.

FEHLER¶

Unter den im Folgenden aufgeführten APIs sind read() und readv(2). Und unter den Effekten, die über Threads (und Prozesse) hinweg atomar sein sollten, ist die Aktualisierung des Dateiversatzes. Unter Linux vor Version 3.14 war das allerdings nicht der Fall: Falls zwei Prozesse, die eine offene Dateideskription gemeinsam nutzten (siehe open(2)) gleichzeitig einen read() (oder readv(2)) durchführten, waren die E/A-Aktionen im Hinblick auf die Aktualisierung des Dateiversatzes nicht atomar. Das Ergebnis war, dass beim Lesen erhaltene Datenblöcken in den zwei Prozessen sich (inkorrekterweise) überlappten. Dieses Problem wurde in Linux 3.14 behoben.

SIEHE AUCH¶

KOLOPHON¶

ÜBERSETZUNG¶

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>.