38 lines
831 B
Groff
38 lines
831 B
Groff
|
.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.
|