| |
1 /* |
| |
2 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER. |
| |
3 * |
| |
4 * Copyright 2026 Olaf Wintermann. All rights reserved. |
| |
5 * |
| |
6 * Redistribution and use in source and binary forms, with or without |
| |
7 * modification, are permitted provided that the following conditions are met: |
| |
8 * |
| |
9 * 1. Redistributions of source code must retain the above copyright |
| |
10 * notice, this list of conditions and the following disclaimer. |
| |
11 * |
| |
12 * 2. Redistributions in binary form must reproduce the above copyright |
| |
13 * notice, this list of conditions and the following disclaimer in the |
| |
14 * documentation and/or other materials provided with the distribution. |
| |
15 * |
| |
16 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" |
| |
17 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE |
| |
18 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE |
| |
19 * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE |
| |
20 * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR |
| |
21 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF |
| |
22 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS |
| |
23 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN |
| |
24 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) |
| |
25 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE |
| |
26 * POSSIBILITY OF SUCH DAMAGE. |
| |
27 */ |
| |
28 |
| |
29 #ifndef UTIL_SOCKET_H |
| |
30 #define UTIL_SOCKET_H |
| |
31 |
| |
32 #ifdef __cplusplus |
| |
33 extern "C" { |
| |
34 #endif |
| |
35 |
| |
36 // Small socket utility functions for creating server or client sockets |
| |
37 // on localhost. Useful for testing. |
| |
38 |
| |
39 // creates a socket, binds it to localhost and optionally to the specified port |
| |
40 // port: if *port is 0, a random port is choosen |
| |
41 // returns the socket fd |
| |
42 int util_server_socket_local(short *port); |
| |
43 |
| |
44 // creates a socket and connects to localhost:<port> |
| |
45 // returns the socket fd |
| |
46 int util_socket_connect_local(short port); |
| |
47 |
| |
48 // enables/disables non-blocking mode the for specified socket |
| |
49 int util_socket_setnonblock(int fd, int nonblock); |
| |
50 |
| |
51 |
| |
52 #ifdef __cplusplus |
| |
53 } |
| |
54 #endif |
| |
55 |
| |
56 #endif /* UTIL_SOCKET_H */ |
| |
57 |