other languages
other sections
READ(2) | Linux Programmer's Manual | READ(2) |
NAME¶
read - 在檔案描述符上執行讀操作概述¶
#include <unistd.h> ssize_t read(int fd, void *buf, size_t count);
描述¶
read() 從檔案描述符 fd 中讀取 count 字節的數據並放入從 buf 開始的緩沖區中. 如果 count 為零, read()返回0,不執行其他任何操作. 如果 count 大於SSIZE_MAX,那麼結果將不可預料.返回值¶
成功時返回讀取到的字節數(為零表示讀到檔案描述符), 此返回值受檔案剩餘字節數限制.當返回值小於指定的字節數時 並不意味著錯誤;這可能是因為當前可讀取的字節數小於指定的 字節數(比如已經接近檔案結尾,或者正在從管道或者終端讀取數 據,或者 read()被信號中斷). 發生錯誤時返回-1,並置 errno 為相應值.在這種情況下無法得知檔案偏移位置是否有變化.錯誤代碼¶
- EINTR
- 在讀取到數據以前調用被信號所中斷.
- EAGAIN
- 使用 O_NONBLOCK 標誌指定了非阻塞式輸入輸出,但當前沒有數據可讀.
- EIO
- 輸入輸出錯誤.可能是正處於背景進程組進程試圖讀取其 控制終端,但讀操作無效,或者被信號SIGTTIN所阻塞, 或者其進程組是孤兒進程組.也可能執行的是讀磁碟或者 磁帶機這樣的底層輸入輸出錯誤.
- EISDIR
- fd 指向一個目錄.
- EBADF
- fd 不是一個合法的檔案描述符,或者不是為讀操作而打開.
- EINVAL
- fd 所連接的對象不可讀.
- EFAULT
- buf 超出使用者可訪問的地址空間.
相容於¶
SVr4, SVID, AT&T, POSIX, X/OPEN, BSD 4.3限制¶
在NFS檔案系統中,讀取小塊數據僅更新時間標記,之後的調用 不再讀取伺服器端的數據.這是因為客戶端把數據放在緩存裏. 由於大多數情況下不存在NFS伺服器向客戶端的讀操作, 所以NFS客戶必須將更新時間標記的操作放在伺服器端,而 數據可以放在客戶端的緩存裏留待以後更新.UNIX也可以禁用 客戶端的緩存,但那樣的話大多數情況下會導致伺服器性能下降.參見¶
close(2), fcntl(2), ioctl(2), lseek(2), readdir(2), readlink(2), select(2), write(2), fread(3)[中文版維護人]¶
byeyear <love_my_love@263.net >[中文版最新更新]¶
2002.02.02《中國linux論壇man手冊頁翻譯計劃》:¶
http://cmpp.linuxforum.netJuly 12, 1997 | Linux 2.0.32 |