man read (2): odczyt z deskryptora pliku

SKŁADNIA

#include <unistd.h>

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

OPIS

Uwaga! To tłumaczenie może być nieaktualne!

read() próbuje odczytać maksymalnie count bajtów z deskryptora plików fd do bufora, którego początek znajduje się w buf.

Jeśli count jest równe zero, read() zwraca zero i nic więcej się nie dzieje. Jeśli count jest większe niż SSIZE_MAX, wynik jest nieokreślony.

WARTOŚĆ ZWRACANA

Po pomyślnym zakończeniu zwracana jest liczba odczytanych bajtów (zero oznacza koniec pliku), oraz o tę wartość przesuwana jest pozycja w pliku. Nie jest błędem, jeśli liczba ta jest mniejsza niż liczba żądanych bajtów; może się to zdarzyć np. ponieważ chwilowo dostępnych jest mniej bajtów (może z powodu bliskości końca plików, a może z powodu czytania z potoku lub z terminala), lub ponieważ read() zostało przerwane sygnałem. Po błędzie zwracane jest -1 i odpowiednio ustawiane errno. W tym wypadku nie jest określone czy pozycja w pliku się zmieni.

BŁĘDY

EINTR: Wywołanie zostało przerwane sygnałem przed odczytaniem danych.
EAGAIN: Przy użyciu O_NONBLOCK wybrano nieblokujące we/wy, a nie ma akurat danych dostępnych do odczytania natychmiast.
EIO: Błąd we/wy. Zdarza się to na przykład, gdy proces jest w grupie procesów tła próbuje czytać z kontrolującego tty, i blokuje lub ignoruje sygnał SIGTTIN, lub jego grupa procesów jest osierocona. Może się to również zdarzyć, gdy wystąpi niskopoziomowy błąd we/wy podczas odczytu z dysku lub taśmy.
EISDIR: fd odnosi się do katalogu.
EBADF: fd nie jest prawidłowym deskryptorem pliku, lub nie jest otwarty dla odczytu.
EINVAL: fd wskazuje na obiekt nieodpowiedni do odczytu.
EINVAL: fd jest skojarzony z obiektem, który nie jest odpowiedni dla odczytu.
EFAULT: buf wskazuje poza dostępną dla użytkownika przestrzeń adresową.

Mogą się pojawić inne błędy, zależnie od obiektu skojarzonego z fd. POSIX zezwala by read którego przerwano po odczytaniu fragmentu danych zwrócił -1 (z errno ustawionym na EINTR) lub by zwróćił ilość odczytanych bajtów.

ZGODNE Z

SVr4, SVID, AT&T, POSIX, X/OPEN, BSD 4.3

OGRANICZENIA

Na systemach plików NFS, odczytanie niewielkiej ilości danych spowoduje uaktualnienie znacznika czasu tylko za pierwszym razem. Następne wywołania tego nie uczynią. Jest to związana z buforowaniem atrybutów po stronie klienta, gdyż większość (jeżeli nie wszystkie) klienty NFS pozostawiają uaktualnianie atime serwerowi, a odczyty po stronie klienta, odbywające się z buforów klienta nie spowodują uaktualnienia atime na serwerze, gdyż nie ma wówczas odczytów po stronie serwera. Semantykę UNIX-a można uzyskać poprzez wyłączenie buforowania atrybutów po stronie klienta. Jednakże, w większości przypadków spowoduje to istotny wzrost obciążenia serwera i zmniejszy wydajność.

Wiele systemów plików i dysków jest uważane za dostatecznie szybkie, aby implementacja O_NONBLOCK była uważana za zbędną. Tak więc, O_NONBLOCK może nie być dostępne dla plików i/lub dysków.

INFORMACJE O TŁUMACZENIU

Powyższe tłumaczenie pochodzi z nieistniejącego już Projektu Tłumaczenia Manuali i może nie być aktualne. W razie zauważenia różnic między powyższym opisem a rzeczywistym zachowaniem opisywanego programu lub funkcji, prosimy o zapoznanie się z oryginalną (angielską) wersją strony podręcznika za pomocą polecenia:

: man --locale=C 2 read

Prosimy o pomoc w aktualizacji stron man - więcej informacji można znaleźć pod adresem http://sourceforge.net/projects/manpages-pl/.