mirror of
https://gitlab.gnome.org/GNOME/glib.git
synced 2024-12-27 16:06:16 +01:00
64f9bf96fd
This is a convenience method for creating a GNetworkAddress which is guaranteed to return IPv4 and IPv6 loopback addresses. The program cannot guarantee that 'localhost' will resolve to both types of address, so programs which wish to connect to a local service over either IPv4 or IPv6 must currently manually create an IPv4 and another IPv6 socket, and detect which of the two are working. This new API allows the existing GSocketConnectable machinery to be used to automate that. Based on a patch from Philip Withnall. https://bugzilla.gnome.org/show_bug.cgi?id=732317
81 lines
2.9 KiB
C
81 lines
2.9 KiB
C
/* GIO - GLib Input, Output and Streaming Library
|
|
*
|
|
* Copyright (C) 2008 Red Hat, Inc.
|
|
*
|
|
* This library is free software; you can redistribute it and/or
|
|
* modify it under the terms of the GNU Lesser General Public
|
|
* License as published by the Free Software Foundation; either
|
|
* version 2 of the License, or (at your option) any later version.
|
|
*
|
|
* This library 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
|
|
* Lesser General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU Lesser General
|
|
* Public License along with this library; if not, see <http://www.gnu.org/licenses/>.
|
|
*/
|
|
|
|
#ifndef __G_NETWORK_ADDRESS_H__
|
|
#define __G_NETWORK_ADDRESS_H__
|
|
|
|
#if !defined (__GIO_GIO_H_INSIDE__) && !defined (GIO_COMPILATION)
|
|
#error "Only <gio/gio.h> can be included directly."
|
|
#endif
|
|
|
|
#include <gio/giotypes.h>
|
|
|
|
G_BEGIN_DECLS
|
|
|
|
#define G_TYPE_NETWORK_ADDRESS (g_network_address_get_type ())
|
|
#define G_NETWORK_ADDRESS(o) (G_TYPE_CHECK_INSTANCE_CAST ((o), G_TYPE_NETWORK_ADDRESS, GNetworkAddress))
|
|
#define G_NETWORK_ADDRESS_CLASS(k) (G_TYPE_CHECK_CLASS_CAST((k), G_TYPE_NETWORK_ADDRESS, GNetworkAddressClass))
|
|
#define G_IS_NETWORK_ADDRESS(o) (G_TYPE_CHECK_INSTANCE_TYPE ((o), G_TYPE_NETWORK_ADDRESS))
|
|
#define G_IS_NETWORK_ADDRESS_CLASS(k) (G_TYPE_CHECK_CLASS_TYPE ((k), G_TYPE_NETWORK_ADDRESS))
|
|
#define G_NETWORK_ADDRESS_GET_CLASS(o) (G_TYPE_INSTANCE_GET_CLASS ((o), G_TYPE_NETWORK_ADDRESS, GNetworkAddressClass))
|
|
|
|
typedef struct _GNetworkAddressClass GNetworkAddressClass;
|
|
typedef struct _GNetworkAddressPrivate GNetworkAddressPrivate;
|
|
|
|
struct _GNetworkAddress
|
|
{
|
|
GObject parent_instance;
|
|
|
|
/*< private >*/
|
|
GNetworkAddressPrivate *priv;
|
|
};
|
|
|
|
struct _GNetworkAddressClass
|
|
{
|
|
GObjectClass parent_class;
|
|
|
|
};
|
|
|
|
GLIB_AVAILABLE_IN_ALL
|
|
GType g_network_address_get_type (void) G_GNUC_CONST;
|
|
|
|
GLIB_AVAILABLE_IN_ALL
|
|
GSocketConnectable *g_network_address_new (const gchar *hostname,
|
|
guint16 port);
|
|
GLIB_AVAILABLE_IN_2_44
|
|
GSocketConnectable *g_network_address_new_loopback (guint16 port);
|
|
GLIB_AVAILABLE_IN_ALL
|
|
GSocketConnectable *g_network_address_parse (const gchar *host_and_port,
|
|
guint16 default_port,
|
|
GError **error);
|
|
GLIB_AVAILABLE_IN_ALL
|
|
GSocketConnectable *g_network_address_parse_uri (const gchar *uri,
|
|
guint16 default_port,
|
|
GError **error);
|
|
GLIB_AVAILABLE_IN_ALL
|
|
const gchar *g_network_address_get_hostname (GNetworkAddress *addr);
|
|
GLIB_AVAILABLE_IN_ALL
|
|
guint16 g_network_address_get_port (GNetworkAddress *addr);
|
|
GLIB_AVAILABLE_IN_ALL
|
|
const gchar *g_network_address_get_scheme (GNetworkAddress *addr);
|
|
|
|
|
|
G_END_DECLS
|
|
|
|
#endif /* __G_NETWORK_ADDRESS_H__ */
|