Rev 4712 | Rev 4726 | Go to most recent revision | Only display areas with differences | Ignore whitespace | Details | Blame | Last modification | View Log | RSS feed
Rev 4712 | Rev 4720 | ||
---|---|---|---|
1 | /* |
1 | /* |
2 | * Copyright (c) 2009 Lukas Mejdrech |
2 | * Copyright (c) 2009 Lukas Mejdrech |
3 | * All rights reserved. |
3 | * All rights reserved. |
4 | * |
4 | * |
5 | * Redistribution and use in source and binary forms, with or without |
5 | * Redistribution and use in source and binary forms, with or without |
6 | * modification, are permitted provided that the following conditions |
6 | * modification, are permitted provided that the following conditions |
7 | * are met: |
7 | * are met: |
8 | * |
8 | * |
9 | * - Redistributions of source code must retain the above copyright |
9 | * - Redistributions of source code must retain the above copyright |
10 | * notice, this list of conditions and the following disclaimer. |
10 | * notice, this list of conditions and the following disclaimer. |
11 | * - Redistributions in binary form must reproduce the above copyright |
11 | * - Redistributions in binary form must reproduce the above copyright |
12 | * notice, this list of conditions and the following disclaimer in the |
12 | * notice, this list of conditions and the following disclaimer in the |
13 | * documentation and/or other materials provided with the distribution. |
13 | * documentation and/or other materials provided with the distribution. |
14 | * - The name of the author may not be used to endorse or promote products |
14 | * - The name of the author may not be used to endorse or promote products |
15 | * derived from this software without specific prior written permission. |
15 | * derived from this software without specific prior written permission. |
16 | * |
16 | * |
17 | * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR |
17 | * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR |
18 | * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES |
18 | * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES |
19 | * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. |
19 | * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. |
20 | * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, |
20 | * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, |
21 | * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT |
21 | * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT |
22 | * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, |
22 | * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, |
23 | * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY |
23 | * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY |
24 | * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT |
24 | * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT |
25 | * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF |
25 | * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF |
26 | * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. |
26 | * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. |
27 | */ |
27 | */ |
28 | 28 | ||
29 | /** @addtogroup socket |
29 | /** @addtogroup socket |
30 | * @{ |
30 | * @{ |
31 | */ |
31 | */ |
32 | 32 | ||
33 | /** @file |
33 | /** @file |
34 | * Socket application program interface (API). |
34 | * Socket application program interface (API). |
35 | * This is a part of the network application library. |
35 | * This is a part of the network application library. |
36 | * Based on the linux src/include/linux/socket.h header file and BSD socket interface. |
36 | * Based on the linux src/include/linux/socket.h header file and BSD socket interface. |
37 | */ |
37 | */ |
38 | 38 | ||
39 | #ifndef __NET_SOCKET_H__ |
39 | #ifndef __NET_SOCKET_H__ |
40 | #define __NET_SOCKET_H__ |
40 | #define __NET_SOCKET_H__ |
41 | 41 | ||
42 | #include "byteorder.h" |
42 | #include "byteorder.h" |
43 | #include "in.h" |
43 | #include "in.h" |
44 | #include "inet.h" |
44 | #include "inet.h" |
45 | 45 | ||
46 | #include "socket_codes.h" |
46 | #include "socket_codes.h" |
- | 47 | #include "socket_errno.h" |
|
47 | 48 | ||
48 | /** @name Socket application programming interface |
49 | /** @name Socket application programming interface |
49 | */ |
50 | */ |
50 | /*@{*/ |
51 | /*@{*/ |
51 | 52 | ||
52 | /** Creates a new socket. |
53 | /** Creates a new socket. |
53 | * @param domain The socket protocol family. Input parameter. |
54 | * @param domain The socket protocol family. Input parameter. |
54 | * @param type Socket type. Input parameter. |
55 | * @param type Socket type. Input parameter. |
55 | * @param protocol Socket protocol. Input parameter. |
56 | * @param protocol Socket protocol. Input parameter. |
56 | * @returns The socket identifier on success. |
57 | * @returns The socket identifier on success. |
57 | * @returns EPFNOTSUPPORT if the protocol family is not supported. |
58 | * @returns EPFNOTSUPPORT if the protocol family is not supported. |
58 | * @returns ESOCKNOTSUPPORT if the socket type is not supported. |
59 | * @returns ESOCKNOTSUPPORT if the socket type is not supported. |
59 | * @returns EPROTONOSUPPORT if the protocol is not supported. |
60 | * @returns EPROTONOSUPPORT if the protocol is not supported. |
60 | * @returns ENOMEM if there is not enough memory left. |
61 | * @returns ENOMEM if there is not enough memory left. |
61 | * @returns Other error codes as defined for the NET_SOCKET message. |
62 | * @returns Other error codes as defined for the NET_SOCKET message. |
62 | */ |
63 | */ |
63 | int socket( int domain, int type, int protocol ); |
64 | int socket( int domain, int type, int protocol ); |
64 | 65 | ||
65 | /** Binds the socket to a port address. |
66 | /** Binds the socket to a port address. |
66 | * @param socket_id Socket identifier. Input parameter. |
67 | * @param socket_id Socket identifier. Input parameter. |
67 | * @param my_addr The port address. Input parameter. |
68 | * @param my_addr The port address. Input parameter. |
68 | * @param addrlen The address length. Input parameter. |
69 | * @param addrlen The address length. Input parameter. |
69 | * @returns EOK on success. |
70 | * @returns EOK on success. |
70 | * @returns ENOTSOCK if the socket is not found. |
71 | * @returns ENOTSOCK if the socket is not found. |
71 | * @returns EBADMEM if the my_addr parameter is NULL. |
72 | * @returns EBADMEM if the my_addr parameter is NULL. |
72 | * @returns NO_DATA if the addlen parameter is zero (0). |
73 | * @returns NO_DATA if the addlen parameter is zero (0). |
73 | * @returns Other error codes as defined for the NET_SOCKET_BIND message. |
74 | * @returns Other error codes as defined for the NET_SOCKET_BIND message. |
74 | */ |
75 | */ |
75 | int bind( int socket_id, const struct sockaddr * my_addr, socklen_t addrlen ); |
76 | int bind( int socket_id, const struct sockaddr * my_addr, socklen_t addrlen ); |
76 | 77 | ||
77 | /** Sets the number of connections waiting to be accepted. |
78 | /** Sets the number of connections waiting to be accepted. |
78 | * @param socket_id Socket identifier. Input parameter. |
79 | * @param socket_id Socket identifier. Input parameter. |
79 | * @param backlog The maximum number of waiting sockets to be accepted. Input parameter. |
80 | * @param backlog The maximum number of waiting sockets to be accepted. Input parameter. |
80 | * @returns EOK on success. |
81 | * @returns EOK on success. |
81 | * @returns EINVAL if the backlog parameter is not positive (<=0). |
82 | * @returns EINVAL if the backlog parameter is not positive (<=0). |
82 | * @returns ENOTSOCK if the socket is not found. |
83 | * @returns ENOTSOCK if the socket is not found. |
83 | * @returns Other error codes as defined for the NET_SOCKET_LISTEN message. |
84 | * @returns Other error codes as defined for the NET_SOCKET_LISTEN message. |
84 | */ |
85 | */ |
85 | int listen( int socket_id, int backlog ); |
86 | int listen( int socket_id, int backlog ); |
86 | 87 | ||
87 | /** Accepts waiting socket. |
88 | /** Accepts waiting socket. |
88 | * Blocks until such a socket exists. |
89 | * Blocks until such a socket exists. |
89 | * @param socket_id Socket identifier. Input parameter. |
90 | * @param socket_id Socket identifier. Input parameter. |
90 | * @param cliaddr The remote client address. Output parameter. |
91 | * @param cliaddr The remote client address. Output parameter. |
91 | * @param addrlen The address length. Input parameter. |
92 | * @param addrlen The address length. Input parameter. |
92 | * @returns EOK on success. |
93 | * @returns EOK on success. |
93 | * @returns EBADMEM if the cliaddr or addrlen parameter is NULL. |
94 | * @returns EBADMEM if the cliaddr or addrlen parameter is NULL. |
94 | * @returns EINVAL if the backlog parameter is not positive (<=0). |
95 | * @returns EINVAL if the backlog parameter is not positive (<=0). |
95 | * @returns ENOTSOCK if the socket is not found. |
96 | * @returns ENOTSOCK if the socket is not found. |
96 | * @returns Other error codes as defined for the NET_SOCKET_ACCEPT message. |
97 | * @returns Other error codes as defined for the NET_SOCKET_ACCEPT message. |
97 | */ |
98 | */ |
98 | int accept( int socket_id, struct sockaddr * cliaddr, socklen_t * addrlen ); |
99 | int accept( int socket_id, struct sockaddr * cliaddr, socklen_t * addrlen ); |
99 | 100 | ||
100 | /** Connects socket to the remote server. |
101 | /** Connects socket to the remote server. |
101 | * @param socket_id Socket identifier. Input parameter. |
102 | * @param socket_id Socket identifier. Input parameter. |
102 | * @param serv_addr The remote server address. Input parameter. |
103 | * @param serv_addr The remote server address. Input parameter. |
103 | * @param addrlen The address length. Input parameter. |
104 | * @param addrlen The address length. Input parameter. |
104 | * @returns EOK on success. |
105 | * @returns EOK on success. |
105 | * @returns EBADMEM if the serv_addr parameter is NULL. |
106 | * @returns EBADMEM if the serv_addr parameter is NULL. |
106 | * @returns NO_DATA if the addlen parameter is zero (0). |
107 | * @returns NO_DATA if the addlen parameter is zero (0). |
107 | * @returns ENOTSOCK if the socket is not found. |
108 | * @returns ENOTSOCK if the socket is not found. |
108 | * @returns Other error codes as defined for the NET_SOCKET_CONNECT message. |
109 | * @returns Other error codes as defined for the NET_SOCKET_CONNECT message. |
109 | */ |
110 | */ |
110 | int connect( int socket_id, const struct sockaddr * serv_addr, socklen_t addrlen ); |
111 | int connect( int socket_id, const struct sockaddr * serv_addr, socklen_t addrlen ); |
111 | 112 | ||
112 | /** Closes the socket. |
113 | /** Closes the socket. |
113 | * @param socket_id Socket identifier. Input parameter. |
114 | * @param socket_id Socket identifier. Input parameter. |
114 | * @returns EOK on success. |
115 | * @returns EOK on success. |
115 | * @returns ENOTSOCK if the socket is not found. |
116 | * @returns ENOTSOCK if the socket is not found. |
116 | * @returns Other error codes as defined for the NET_SOCKET_CLOSE message. |
117 | * @returns Other error codes as defined for the NET_SOCKET_CLOSE message. |
117 | */ |
118 | */ |
118 | int closesocket( int socket_id ); |
119 | int closesocket( int socket_id ); |
119 | 120 | ||
120 | /** Sends data via the socket. |
121 | /** Sends data via the socket. |
121 | * @param socket_id Socket identifier. Input parameter. |
122 | * @param socket_id Socket identifier. Input parameter. |
122 | * @param data The data to be sent. Input parameter. |
123 | * @param data The data to be sent. Input parameter. |
123 | * @param datalength The data length. Input parameter. |
124 | * @param datalength The data length. Input parameter. |
124 | * @param flags Various send flags. Input parameter. |
125 | * @param flags Various send flags. Input parameter. |
125 | * @returns EOK on success. |
126 | * @returns EOK on success. |
126 | * @returns ENOTSOCK if the socket is not found. |
127 | * @returns ENOTSOCK if the socket is not found. |
127 | * @returns EBADMEM if the data parameter is NULL. |
128 | * @returns EBADMEM if the data parameter is NULL. |
128 | * @returns NO_DATA if the datalength parameter is zero (0). |
129 | * @returns NO_DATA if the datalength parameter is zero (0). |
129 | * @returns Other error codes as defined for the NET_SOCKET_SEND message. |
130 | * @returns Other error codes as defined for the NET_SOCKET_SEND message. |
130 | */ |
131 | */ |
131 | int send( int socket_id, void * data, size_t datalength, int flags ); |
132 | int send( int socket_id, void * data, size_t datalength, int flags ); |
132 | 133 | ||
133 | /** Sends data via the socket to the remote address. |
134 | /** Sends data via the socket to the remote address. |
134 | * Binds the socket to a free port if not already connected/bound. |
135 | * Binds the socket to a free port if not already connected/bound. |
135 | * @param socket_id Socket identifier. Input parameter. |
136 | * @param socket_id Socket identifier. Input parameter. |
136 | * @param data The data to be sent. Input parameter. |
137 | * @param data The data to be sent. Input parameter. |
137 | * @param datalength The data length. Input parameter. |
138 | * @param datalength The data length. Input parameter. |
138 | * @param flags Various send flags. Input parameter. |
139 | * @param flags Various send flags. Input parameter. |
139 | * @param toaddr The destination address. Input parameter. |
140 | * @param toaddr The destination address. Input parameter. |
140 | * @param addrlen The address length. Input parameter. |
141 | * @param addrlen The address length. Input parameter. |
141 | * @returns EOK on success. |
142 | * @returns EOK on success. |
142 | * @returns ENOTSOCK if the socket is not found. |
143 | * @returns ENOTSOCK if the socket is not found. |
143 | * @returns EBADMEM if the data or toaddr parameter is NULL. |
144 | * @returns EBADMEM if the data or toaddr parameter is NULL. |
144 | * @returns NO_DATA if the datalength or the addrlen parameter is zero (0). |
145 | * @returns NO_DATA if the datalength or the addrlen parameter is zero (0). |
145 | * @returns Other error codes as defined for the NET_SOCKET_SENDTO message. |
146 | * @returns Other error codes as defined for the NET_SOCKET_SENDTO message. |
146 | */ |
147 | */ |
147 | int sendto( int socket_id, const void * data, size_t datalength, int flags, const struct sockaddr * toaddr, socklen_t addrlen ); |
148 | int sendto( int socket_id, const void * data, size_t datalength, int flags, const struct sockaddr * toaddr, socklen_t addrlen ); |
148 | 149 | ||
149 | /** Receives data via the socket. |
150 | /** Receives data via the socket. |
150 | * @param socket_id Socket identifier. Input parameter. |
151 | * @param socket_id Socket identifier. Input parameter. |
151 | * @param data The data buffer to be filled. Output parameter. |
152 | * @param data The data buffer to be filled. Output parameter. |
152 | * @param datalength The data length. Input parameter. |
153 | * @param datalength The data length. Input parameter. |
153 | * @param flags Various receive flags. Input parameter. |
154 | * @param flags Various receive flags. Input parameter. |
154 | * @returns EOK on success. |
155 | * @returns EOK on success. |
155 | * @returns ENOTSOCK if the socket is not found. |
156 | * @returns ENOTSOCK if the socket is not found. |
156 | * @returns EBADMEM if the data parameter is NULL. |
157 | * @returns EBADMEM if the data parameter is NULL. |
157 | * @returns NO_DATA if the datalength parameter is zero (0). |
158 | * @returns NO_DATA if the datalength parameter is zero (0). |
158 | * @returns Other error codes as defined for the NET_SOCKET_RECV message. |
159 | * @returns Other error codes as defined for the NET_SOCKET_RECV message. |
159 | */ |
160 | */ |
160 | int recv( int socket_id, void * data, size_t datalength, int flags ); |
161 | int recv( int socket_id, void * data, size_t datalength, int flags ); |
161 | 162 | ||
162 | /** Receives data via the socket. |
163 | /** Receives data via the socket. |
163 | * @param socket_id Socket identifier. Input parameter. |
164 | * @param socket_id Socket identifier. Input parameter. |
164 | * @param data The data buffer to be filled. Output parameter. |
165 | * @param data The data buffer to be filled. Output parameter. |
165 | * @param datalength The data length. Input parameter. |
166 | * @param datalength The data length. Input parameter. |
166 | * @param flags Various receive flags. Input parameter. |
167 | * @param flags Various receive flags. Input parameter. |
167 | * @param fromaddr The source address. Output parameter. |
168 | * @param fromaddr The source address. Output parameter. |
168 | * @param addrlen The address length. The maximum address length is read. The actual address length is set. Input/output parameter. |
169 | * @param addrlen The address length. The maximum address length is read. The actual address length is set. Input/output parameter. |
169 | * @returns EOK on success. |
170 | * @returns EOK on success. |
170 | * @returns ENOTSOCK if the socket is not found. |
171 | * @returns ENOTSOCK if the socket is not found. |
171 | * @returns EBADMEM if the data or fromaddr parameter is NULL. |
172 | * @returns EBADMEM if the data or fromaddr parameter is NULL. |
172 | * @returns NO_DATA if the datalength or addrlen parameter is zero (0). |
173 | * @returns NO_DATA if the datalength or addrlen parameter is zero (0). |
173 | * @returns Other error codes as defined for the NET_SOCKET_RECVFROM message. |
174 | * @returns Other error codes as defined for the NET_SOCKET_RECVFROM message. |
174 | */ |
175 | */ |
175 | int recvfrom( int socket_id, void * data, size_t datalength, int flags, struct sockaddr * fromaddr, socklen_t * addrlen ); |
176 | int recvfrom( int socket_id, void * data, size_t datalength, int flags, struct sockaddr * fromaddr, socklen_t * addrlen ); |
176 | 177 | ||
177 | /** Gets socket option. |
178 | /** Gets socket option. |
178 | * @param socket_id Socket identifier. Input parameter. |
179 | * @param socket_id Socket identifier. Input parameter. |
179 | * @param level The socket options level. Input parameter. |
180 | * @param level The socket options level. Input parameter. |
180 | * @param optname The socket option to be get. Input parameter. |
181 | * @param optname The socket option to be get. Input parameter. |
181 | * @param value The value buffer to be filled. Output parameter. |
182 | * @param value The value buffer to be filled. Output parameter. |
182 | * @param optlen The value buffer length. The maximum length is read. The actual length is set. Input/output parameter. |
183 | * @param optlen The value buffer length. The maximum length is read. The actual length is set. Input/output parameter. |
183 | * @returns EOK on success. |
184 | * @returns EOK on success. |
184 | * @returns ENOTSOCK if the socket is not found. |
185 | * @returns ENOTSOCK if the socket is not found. |
185 | * @returns EBADMEM if the value or optlen parameter is NULL. |
186 | * @returns EBADMEM if the value or optlen parameter is NULL. |
186 | * @returns NO_DATA if the optlen parameter is zero (0). |
187 | * @returns NO_DATA if the optlen parameter is zero (0). |
187 | * @returns Other error codes as defined for the NET_SOCKET_GETSOCKOPT message. |
188 | * @returns Other error codes as defined for the NET_SOCKET_GETSOCKOPT message. |
188 | */ |
189 | */ |
189 | int getsockopt( int socket_id, int level, int optname, void * value, size_t * optlen ); |
190 | int getsockopt( int socket_id, int level, int optname, void * value, size_t * optlen ); |
190 | 191 | ||
191 | /** Sets socket option. |
192 | /** Sets socket option. |
192 | * @param socket_id Socket identifier. Input parameter. |
193 | * @param socket_id Socket identifier. Input parameter. |
193 | * @param level The socket options level. Input parameter. |
194 | * @param level The socket options level. Input parameter. |
194 | * @param optname The socket option to be set. Input parameter. |
195 | * @param optname The socket option to be set. Input parameter. |
195 | * @param value The value to be set. Input parameter. |
196 | * @param value The value to be set. Input parameter. |
196 | * @param optlen The value length. Input parameter. |
197 | * @param optlen The value length. Input parameter. |
197 | * @returns EOK on success. |
198 | * @returns EOK on success. |
198 | * @returns ENOTSOCK if the socket is not found. |
199 | * @returns ENOTSOCK if the socket is not found. |
199 | * @returns EBADMEM if the value parameter is NULL. |
200 | * @returns EBADMEM if the value parameter is NULL. |
200 | * @returns NO_DATA if the optlen parameter is zero (0). |
201 | * @returns NO_DATA if the optlen parameter is zero (0). |
201 | * @returns Other error codes as defined for the NET_SOCKET_SETSOCKOPT message. |
202 | * @returns Other error codes as defined for the NET_SOCKET_SETSOCKOPT message. |
202 | */ |
203 | */ |
203 | int setsockopt( int socket_id, int level, int optname, const void * value, size_t optlen ); |
204 | int setsockopt( int socket_id, int level, int optname, const void * value, size_t optlen ); |
204 | 205 | ||
205 | /*@}*/ |
206 | /*@}*/ |
206 | 207 | ||
207 | #endif |
208 | #endif |
208 | 209 | ||
209 | /** @} |
210 | /** @} |
210 | */ |
211 | */ |
211 | 212 |