.TH RECVMSG 2
.SH NAME
recvmsg \- receive a message through a socket
.SH SYNOPSIS
.ft B
#include <sys/socket.h>

.in +5
.ti -5
ssize_t recvmsg(int \fIsd\fP, struct msghdr * \fImsg\fP, int \fIflags\fP);
.br
.ft P
.SH DESCRIPTION
recvfrom() receives a message from another socket. It may be
used with connectionless and connection oriented sockets.
At present, minix doesn't support setting \fIflags\fP to any
value other than 0.
.SH RETURN VALUES
On success, this function returns 0. On error, -1 is returned and
\fIerrno\fP is set.
.SH ERRORS
.TP 15
[ENOSYS]
The operation is not implemented for the given socket.
.TP 15
[EPIPE]
The socket is shutdown for reading.
.TP 15
[EFAULT]
\fImsg\fP is NULL.
.SH SEE ALSO
.BR socket(2),
.BR recvfrom(2),
.BR readv(2),
.BR sendmsg(2)
.SH HISTORY
This function first appeared in Minix 3.1.8.