UNIXworkcode

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 // creates a connected socket pair (domain AF_UNIX, type SOCK_STREAM) 49 // returns 0 on success, -1 on error 50 int util_socketpair(int fds[2]); 51 52 // enables/disables non-blocking mode the for specified socket 53 int util_socket_setnonblock(int fd, int nonblock); 54 55 56 #ifdef __cplusplus 57 } 58 #endif 59 60 #endif /* UTIL_SOCKET_H */ 61 62