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 copyright10 * notice, this list of conditions and the following disclaimer.11 *12 * 2. Redistributions in binary form must reproduce the above copyright13 * notice, this list of conditions and the following disclaimer in the14 * 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, THE18 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE19 * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE20 * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR21 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF22 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS23 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN24 * 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 THE26 * POSSIBILITY OF SUCH DAMAGE.27 */28 29 #ifndefUTIL_SOCKET_H30 #defineUTIL_SOCKET_H31 32 #ifdef __cplusplus
33 extern"C" {
34 #endif35 36 // Small socket utility functions for creating server or client sockets37 // on localhost. Useful for testing.38 39 // creates a socket, binds it to localhost and optionally to the specified port40 // port: if *port is 0, a random port is choosen41 // returns the socket fd42 int util_server_socket_local(short *port);
43 44 // creates a socket and connects to localhost:<port>45 // returns the socket fd46 int util_socket_connect_local(short port);
47 48 // creates a connected socket pair (domain AF_UNIX, type SOCK_STREAM)49 // returns 0 on success, -1 on error50 int util_socketpair(int fds[2]);
51 52 // enables/disables non-blocking mode the for specified socket53 int util_socket_setnonblock(int fd, int nonblock);
54 55 56 #ifdef __cplusplus
57 }
58 #endif59 60 #endif/* UTIL_SOCKET_H */61 62