Subversion Repositories HelenOS

Rev

Rev 4728 | Go to most recent revision | Blame | Compare with Previous | Last modification | View Log | Download | RSS feed

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