4 * Copyright (c) 2002-2014, Universite catholique de Louvain (UCL), Belgium
5 * Copyright (c) 2002-2014, Professor Benoit Macq
6 * Copyright (c) 2010-2011, Kaori Hagihara
9 * Redistribution and use in source and binary forms, with or without
10 * modification, are permitted provided that the following conditions
12 * 1. Redistributions of source code must retain the above copyright
13 * notice, this list of conditions and the following disclaimer.
14 * 2. Redistributions in binary form must reproduce the above copyright
15 * notice, this list of conditions and the following disclaimer in the
16 * documentation and/or other materials provided with the distribution.
18 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS `AS IS'
19 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
20 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
21 * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
22 * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
23 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
24 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
25 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
26 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
27 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
28 * POSSIBILITY OF SUCH DAMAGE.
31 #ifndef SOCK_MANAGER_H_
32 # define SOCK_MANAGER_H_
34 #include "byte_manager.h"
35 #include "opj_stdint.h"
46 * open listening socket
48 * @param port opening port number
51 SOCKET open_listeningsocket( uint16_t port);
54 * accept a new connection to the listenning socket
56 * @param listening_socket listenning socket
57 * @return connected socket (-1 if error occurs)
59 SOCKET accept_socket( SOCKET listening_socket);
63 * receive a string line (ending with '\n') from client
65 * @param [in] connected_socket file descriptor of the connected socket
66 * @param [out] buf string to be stored
69 OPJ_SIZE_T receive_line(SOCKET connected_socket, char *buf);
72 * receive a string line (ending with '\n') from client, return malloc string
74 * @param [in] connected_socket file descriptor of the connected socket
75 * @return pointer to the string (memory allocated)
77 char * receive_string( SOCKET connected_socket);
80 * receive data stream to client
82 * @param [in] connected_socket file descriptor of the connected socket
83 * @param [in] length length of the receiving stream
84 * @return pointer to the data stream (memory allocated), NULL if failed
86 void * receive_stream( SOCKET connected_socket, OPJ_SIZE_T length);
89 * send data stream to client
91 * @param [in] connected_socket file descriptor of the connected socket
92 * @param [in] stream data stream
93 * @param [in] length length of data stream
95 void send_stream( SOCKET connected_socket, const void *stream, OPJ_SIZE_T length);
100 * @param [in] sock closing socket
101 * @return 0 if succeed, -1 if failed
103 int close_socket( SOCKET sock);
105 #endif /* !SOCK_MANAGER_H_ */