.\" Hey Emacs! This file is -*- nroff -*- source. .\" .\" 1999 PTM Przemek Borys .\" Last update: A. Krzysztofowicz , Jan 2002, .\" manpages 1.47 .\" .\" .\" This manpage is Copyright (C) 1992 Drew Eckhardt; .\" 1993 Michael Haardt, Ian Jackson. .\" .\" 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. .\" .\" Modified Sat Jul 24 00:06:00 1993 by Rik Faith .\" Modified Wed Jan 17 16:02:32 1996 by Michael Haardt .\" .\" Modified Thu Apr 11 19:26:35 1996 by Andries Brouwer .\" Modified Sun Jul 21 18:59:33 1996 by Andries Brouwer .\" Modified Fri Jan 31 16:47:33 1997 by Eric S. Raymond .\" Modified Sat Jul 12 20:45:39 1997 by Michael Haardt .\" .\" .TH READ 2 1997-07-12 "Linux 2.0.32" "Podręcznik programisty Linuksa" .SH NAZWA read \- odczyt z deskryptora pliku .SH SKŁADNIA .nf .B #include .sp .BI "ssize_t read(int " fd ", void *" buf ", size_t " count ); .fi .SH OPIS \fI Uwaga! To tłumaczenie może być nieaktualne!\fP .PP .B read() próbuje odczytać maksymalnie .I count bajtów z deskryptora plików .I fd do bufora, którego początek znajduje się w .IR buf . .PP Jeśli .I count jest równe zero, \fBread()\fP zwraca zero i nic więcej się nie dzieje. Jeśli .I count jest większe niż SSIZE_MAX, wynik jest nieokreślony. .PP .SH "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ż \fBread()\fR zostało przerwane sygnałem. Po błędzie zwracane jest \-1 i odpowiednio ustawiane .IR errno . W tym wypadku nie jest określone czy pozycja w pliku się zmieni. .SH BŁĘDY .TP .B EINTR Wywołanie zostało przerwane sygnałem przed odczytaniem danych. .TP .B EAGAIN Przy użyciu .B O_NONBLOCK wybrano nieblokujące we/wy, a nie ma akurat danych dostępnych do odczytania natychmiast. .TP .B 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. .TP .B EISDIR .I fd odnosi się do katalogu. .TP .B EBADF .I fd nie jest prawidłowym deskryptorem pliku, lub nie jest otwarty dla odczytu. .TP .B EINVAL .I fd wskazuje na obiekt nieodpowiedni do odczytu. .TP .B EINVAL .I fd jest skojarzony z obiektem, który nie jest odpowiedni dla odczytu. .TP .B EFAULT .I buf wskazuje poza dostępną dla użytkownika przestrzeń adresową. .PP Mogą się pojawić inne błędy, zależnie od obiektu skojarzonego z .IR fd . POSIX zezwala by .B read którego przerwano po odczytaniu fragmentu danych zwrócił \-1 (z .I errno ustawionym na EINTR) lub by zwróćił ilość odczytanych bajtów. .SH "ZGODNE Z" SVr4, SVID, AT&T, POSIX, X/OPEN, BSD 4.3 .SH 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ść. .PP Wiele systemów plików i dysków jest uważane za dostatecznie szybkie, aby implementacja .B 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. .SH "ZOBACZ TAKŻE" .BR close (2), .BR fcntl (2), .BR ioctl (2), .BR lseek (2), .BR readdir (2), .BR readlink (2), .BR select (2), .BR write (2), .BR fread (3) .SH "INFORMACJE O TŁUMACZENIU" Powyższe tłumaczenie pochodzi z nieistniejącego już Projektu Tłumaczenia Manuali i \fImoże nie być aktualne\fR. 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: .IP man \-\-locale=C 2 read .PP Prosimy o pomoc w aktualizacji stron man \- więcej informacji można znaleźć pod adresem http://sourceforge.net/projects/manpages\-pl/.