unstack - fix ipcvecs
[minix.git] / man / man2 / sendmsg.2
blob034f73735c04208da6fcf049df0caae87bc589f3
1 .TH SENDMSG 2
2 .SH NAME
3 sendmsg \- send 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 sendmsg(int \fIsd\fP, const struct msghdr * \fImsg\fP, int \fIflags\fP);
11 .br
12 .ft P
13 .SH DESCRIPTION
14 sendmsg() sends a message to another socket. It may be used with
15 connectionless and connection oriented sockets. At present, minix
16 doesn't support setting \fIflags\fP to any value other than 0.
17 .SH RETURN VALUES
18 On success, this function returns 0. On error, -1 is returned and
19 \fIerrno\fP is set.
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 [ENOTCONN]
27 The socket is not connected; there is no peer.
28 .TP 15
29 [EFAULT]
30 \fImsg\fP is NULL.
31 .TP 15
32 [EAFNOSUPPORT]
33 The address family is not supported by send().
34 .TP 15
35 [ENAMETOOLONG]
36 The length of sun_path is longer than UNIX_PATH_MAX.
37 .TP 15
38 [ENOENT]
39 The sun_path is null.
40 .TP 15
41 [EPIPE]
42 The socket is shutdown for writing.
43 .TP 15
44 [EMSGSIZE]
45 The message is too big.
46 .SH SEE ALSO
47 .BR socket(2),
48 .BR recvmsg(2),
49 .BR sendto(2),
50 .BR writev(2)
51 .SH HISTORY
52 This function first appeared in Minix 3.1.8.