From b55d9fcdb8a4ad0164f34f45d523bf165bcb496d Mon Sep 17 00:00:00 2001 From: Max Kellermann Date: Sat, 28 Feb 2009 15:12:24 +0100 Subject: socket_util: added function sockaddr_to_string() Create the socket_util.c library, the first function is sockaddr_to_string(): it converts a sockaddr struct to a string containing the IP address in a human-readable form. --- src/socket_util.h | 45 +++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 45 insertions(+) create mode 100644 src/socket_util.h (limited to 'src/socket_util.h') diff --git a/src/socket_util.h b/src/socket_util.h new file mode 100644 index 000000000..7182771cb --- /dev/null +++ b/src/socket_util.h @@ -0,0 +1,45 @@ +/* + * Copyright (C) 2003-2009 The Music Player Daemon Project + * http://www.musicpd.org + * + * This program is free software; you can redistribute it and/or modify + * it under the terms of the GNU General Public License as published by + * the Free Software Foundation; either version 2 of the License, or + * (at your option) any later version. + * + * This program is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU General Public License for more details. + * You should have received a copy of the GNU General Public License + * along with this program; if not, write to the Free Software + * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ + +/* + * This library provides easy helper functions for working with + * sockets. + * + */ + +#ifndef SOCKET_UTIL_H +#define SOCKET_UTIL_H + +#include + +struct sockaddr; + +/** + * Converts the specified socket address into a string in the form + * "IP:PORT". The return value must be freed with g_free() when you + * don't need it anymore. + * + * @param sa the sockaddr struct + * @param length the length of #sa in bytes + * @param error location to store the error occuring, or NULL to + * ignore errors + */ +char * +sockaddr_to_string(const struct sockaddr *sa, size_t length, GError **error); + +#endif -- cgit v1.2.3