參數
sockfd:標識一個已連線套接口的描述字。
buf:接收數據緩衝區。
len:緩衝區長度。
flags:調用操作方式。是以下一個或者多個標誌的組合體,可通過“ | ”操作符連在一起:
MSG_DONTWAIT:操作不會被阻塞。
MSG_ERRQUEUE: 指示應該從套接字的錯誤佇列上接收錯誤值,依據不同的協定,錯誤值以某種輔佐性訊息的方式傳遞進來,使用者應該提供足夠大的緩衝區。導致錯誤的原封包通過msg_iovec作為一般的數據來傳遞。導致錯誤的數據報原目標地址作為msg_name被提供。錯誤以sock_extended_err結構形態被使用,定義如下
#define SO_EE_ORIGIN_NONE 0
#define SO_EE_ORIGIN_LOCAL 1
#define SO_EE_ORIGIN_ICMP 2
#define SO_EE_ORIGIN_ICMP6 3
struct sock_extended_err
{
u_int32_t ee_errno;
u_int8_t ee_origin;
u_int8_t ee_type;
u_int8_t ee_code;
u_int8_t ee_pad;
u_int32_t ee_info;
u_int32_t ee_data;
};
MSG_PEEK:指示數據接收後,在接收佇列中保留原數據,不將其刪除,隨後的讀操作還可以接收相同的數據。
MSG_TRUNC:返回封包的實際長度,即使它比所提供的緩衝區更長, 只對packet套接字有效。
MSG_WAITALL:要求阻塞操作,直到請求得到完整的滿足。然而,如果捕捉到信號,錯誤或者連線斷開發生,或者下次被接收的數據類型不同,仍會返回少於請求量的數據。
MSG_EOR:指示記錄的結束,返回的數據完成一個記錄。
MSG_TRUNC:指明數據報尾部數據已被丟棄,因為它比所提供的緩衝區需要更多的空間。
MSG_CTRUNC:指明由於緩衝區空間不足,一些控制數據已被丟棄。
MSG_OOB:指示接收到out-of-band數據(即需要優先處理的數據)。
MSG_ERRQUEUE:指示除了來自套接字錯誤佇列的錯誤外,沒有接收到其它數據。
from:(可選)指針,指向裝有源地址的緩衝區。
fromlen:(可選)指針,指向from緩衝區長度值。
返回值
如果正確接收返回接收到的位元組數,失敗返回-1.
相關函式 recv,recvmsg,send,sendto,socket
函式說明:recvfrom()用來接收遠程主機經指定的socket傳來的數據,並把數據傳到由參數buf指向的記憶體空間,參數len為可接收數據的最大長度.參數flags一般設0,其他數值定義參考recv().參數from用來指定欲傳送的網路地址,結構sockaddr請參考bind()函式.參數fromlen為sockaddr的結構長度.
返回值:成功則返回接收到的字元數,失敗返回-1.
錯誤代碼
EBADF 參數s非合法的socket處理代碼
EFAULT 參數中有一指針指向無法存取的記憶體空間。
ENOTSOCK 參數s為一檔案描述詞,非socket。
EINTR 被信號所中斷。
EAGAIN 此動作會令進程阻斷,但參數s的socket為不可阻斷。
ENOBUFS 系統的緩衝記憶體不足
ENOMEM 核心記憶體不足
EINVAL 傳給系統調用的參數不正確。