64-bit VFS_LSEEK_OFF
[minix3.git] / man / man2 / recvmsg.2
blob2f3bbce1fb439423a4a6ef238ad7589f2d5cef93
1 .TH RECVMSG 2
2 .SH NAME
3 recvmsg \- receive a message through a socket
4 .SH SYNOPSIS
5 .ft B
6 #include <sys/socket.h>
8 .in +5
9 .ti -5
10 ssize_t recvmsg(int \fIsd\fP, struct msghdr * \fImsg\fP, int \fIflags\fP);
11 .br
12 .ft P
13 .SH DESCRIPTION
14 recvfrom() receives a message from another socket. It may be
15 used with connectionless and connection oriented sockets.
16 At present, minix doesn't support setting \fIflags\fP to any
17 value other than 0.
18 .SH RETURN VALUES
19 On success, this function returns 0. On error, -1 is returned and
20 \fIerrno\fP is set.
21 .SH ERRORS
22 .TP 15
23 [ENOSYS]
24 The operation is not implemented for the given socket.
25 .TP 15
26 [EPIPE]
27 The socket is shutdown for reading.
28 .TP 15
29 [EFAULT]
30 \fImsg\fP is NULL.
31 .SH SEE ALSO
32 .BR socket(2),
33 .BR recvfrom(2),
34 .BR readv(2),
35 .BR sendmsg(2)
36 .SH HISTORY
37 This function first appeared in Minix 3.1.8.