mirror of
				https://gitlab.gnome.org/GNOME/glib.git
				synced 2025-11-04 10:08:56 +01:00 
			
		
		
		
	
		
			
				
	
	
		
			331 lines
		
	
	
		
			16 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
			
		
		
	
	
			331 lines
		
	
	
		
			16 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
/*
 | 
						|
 * Copyright © 2008 Christian Kellner, Samuel Cormier-Iijima
 | 
						|
 * Copyright © 2009 Codethink Limited
 | 
						|
 *
 | 
						|
 * SPDX-License-Identifier: LGPL-2.1-or-later
 | 
						|
 *
 | 
						|
 * 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.1 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/>.
 | 
						|
 *
 | 
						|
 * Authors: Christian Kellner <gicmo@gnome.org>
 | 
						|
 *          Samuel Cormier-Iijima <sciyoshi@gmail.com>
 | 
						|
 *          Ryan Lortie <desrt@desrt.ca>
 | 
						|
 */
 | 
						|
 | 
						|
#ifndef __G_SOCKET_H__
 | 
						|
#define __G_SOCKET_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_SOCKET                                       (g_socket_get_type ())
 | 
						|
#define G_SOCKET(inst)                                      (G_TYPE_CHECK_INSTANCE_CAST ((inst),                     \
 | 
						|
                                                             G_TYPE_SOCKET, GSocket))
 | 
						|
#define G_SOCKET_CLASS(class)                               (G_TYPE_CHECK_CLASS_CAST ((class),                       \
 | 
						|
                                                             G_TYPE_SOCKET, GSocketClass))
 | 
						|
#define G_IS_SOCKET(inst)                                   (G_TYPE_CHECK_INSTANCE_TYPE ((inst),                     \
 | 
						|
                                                             G_TYPE_SOCKET))
 | 
						|
#define G_IS_SOCKET_CLASS(class)                            (G_TYPE_CHECK_CLASS_TYPE ((class),                       \
 | 
						|
                                                             G_TYPE_SOCKET))
 | 
						|
#define G_SOCKET_GET_CLASS(inst)                            (G_TYPE_INSTANCE_GET_CLASS ((inst),                      \
 | 
						|
                                                             G_TYPE_SOCKET, GSocketClass))
 | 
						|
 | 
						|
typedef struct _GSocketPrivate                              GSocketPrivate;
 | 
						|
typedef struct _GSocketClass                                GSocketClass;
 | 
						|
 | 
						|
struct _GSocketClass
 | 
						|
{
 | 
						|
  GObjectClass parent_class;
 | 
						|
 | 
						|
  /*< private >*/
 | 
						|
 | 
						|
  /* Padding for future expansion */
 | 
						|
  void (*_g_reserved1) (void);
 | 
						|
  void (*_g_reserved2) (void);
 | 
						|
  void (*_g_reserved3) (void);
 | 
						|
  void (*_g_reserved4) (void);
 | 
						|
  void (*_g_reserved5) (void);
 | 
						|
  void (*_g_reserved6) (void);
 | 
						|
  void (*_g_reserved7) (void);
 | 
						|
  void (*_g_reserved8) (void);
 | 
						|
  void (*_g_reserved9) (void);
 | 
						|
  void (*_g_reserved10) (void);
 | 
						|
};
 | 
						|
 | 
						|
struct _GSocket
 | 
						|
{
 | 
						|
  GObject parent_instance;
 | 
						|
  GSocketPrivate *priv;
 | 
						|
};
 | 
						|
 | 
						|
GIO_AVAILABLE_IN_ALL
 | 
						|
GType                  g_socket_get_type                (void) G_GNUC_CONST;
 | 
						|
GIO_AVAILABLE_IN_ALL
 | 
						|
GSocket *              g_socket_new                     (GSocketFamily            family,
 | 
						|
							 GSocketType              type,
 | 
						|
							 GSocketProtocol          protocol,
 | 
						|
							 GError                 **error);
 | 
						|
GIO_AVAILABLE_IN_ALL
 | 
						|
GSocket *              g_socket_new_from_fd             (gint                     fd,
 | 
						|
							 GError                 **error);
 | 
						|
GIO_AVAILABLE_IN_ALL
 | 
						|
int                    g_socket_get_fd                  (GSocket                 *socket);
 | 
						|
GIO_AVAILABLE_IN_ALL
 | 
						|
GSocketFamily          g_socket_get_family              (GSocket                 *socket);
 | 
						|
GIO_AVAILABLE_IN_ALL
 | 
						|
GSocketType            g_socket_get_socket_type         (GSocket                 *socket);
 | 
						|
GIO_AVAILABLE_IN_ALL
 | 
						|
GSocketProtocol        g_socket_get_protocol            (GSocket                 *socket);
 | 
						|
GIO_AVAILABLE_IN_ALL
 | 
						|
GSocketAddress *       g_socket_get_local_address       (GSocket                 *socket,
 | 
						|
							 GError                 **error);
 | 
						|
GIO_AVAILABLE_IN_ALL
 | 
						|
GSocketAddress *       g_socket_get_remote_address      (GSocket                 *socket,
 | 
						|
							 GError                 **error);
 | 
						|
GIO_AVAILABLE_IN_ALL
 | 
						|
void                   g_socket_set_blocking            (GSocket                 *socket,
 | 
						|
							 gboolean                 blocking);
 | 
						|
GIO_AVAILABLE_IN_ALL
 | 
						|
gboolean               g_socket_get_blocking            (GSocket                 *socket);
 | 
						|
GIO_AVAILABLE_IN_ALL
 | 
						|
void                   g_socket_set_keepalive           (GSocket                 *socket,
 | 
						|
							 gboolean                 keepalive);
 | 
						|
GIO_AVAILABLE_IN_ALL
 | 
						|
gboolean               g_socket_get_keepalive           (GSocket                 *socket);
 | 
						|
GIO_AVAILABLE_IN_ALL
 | 
						|
gint                   g_socket_get_listen_backlog      (GSocket                 *socket);
 | 
						|
GIO_AVAILABLE_IN_ALL
 | 
						|
void                   g_socket_set_listen_backlog      (GSocket                 *socket,
 | 
						|
							 gint                     backlog);
 | 
						|
GIO_AVAILABLE_IN_ALL
 | 
						|
guint                  g_socket_get_timeout             (GSocket                 *socket);
 | 
						|
GIO_AVAILABLE_IN_ALL
 | 
						|
void                   g_socket_set_timeout             (GSocket                 *socket,
 | 
						|
							 guint                    timeout);
 | 
						|
 | 
						|
GIO_AVAILABLE_IN_2_32
 | 
						|
guint                  g_socket_get_ttl                 (GSocket                 *socket);
 | 
						|
GIO_AVAILABLE_IN_2_32
 | 
						|
void                   g_socket_set_ttl                 (GSocket                 *socket,
 | 
						|
                                                         guint                    ttl);
 | 
						|
 | 
						|
GIO_AVAILABLE_IN_2_32
 | 
						|
gboolean               g_socket_get_broadcast           (GSocket                 *socket);
 | 
						|
GIO_AVAILABLE_IN_2_32
 | 
						|
void                   g_socket_set_broadcast           (GSocket                 *socket,
 | 
						|
                                                         gboolean		  broadcast);
 | 
						|
 | 
						|
GIO_AVAILABLE_IN_2_32
 | 
						|
gboolean               g_socket_get_multicast_loopback  (GSocket                 *socket);
 | 
						|
GIO_AVAILABLE_IN_2_32
 | 
						|
void                   g_socket_set_multicast_loopback  (GSocket                 *socket,
 | 
						|
                                                         gboolean		  loopback);
 | 
						|
GIO_AVAILABLE_IN_2_32
 | 
						|
guint                  g_socket_get_multicast_ttl       (GSocket                 *socket);
 | 
						|
GIO_AVAILABLE_IN_2_32
 | 
						|
void                   g_socket_set_multicast_ttl       (GSocket                 *socket,
 | 
						|
                                                         guint                    ttl);
 | 
						|
GIO_AVAILABLE_IN_ALL
 | 
						|
gboolean               g_socket_is_connected            (GSocket                 *socket);
 | 
						|
GIO_AVAILABLE_IN_ALL
 | 
						|
gboolean               g_socket_bind                    (GSocket                 *socket,
 | 
						|
							 GSocketAddress          *address,
 | 
						|
							 gboolean                 allow_reuse,
 | 
						|
							 GError                 **error);
 | 
						|
GIO_AVAILABLE_IN_2_32
 | 
						|
gboolean               g_socket_join_multicast_group    (GSocket                 *socket,
 | 
						|
                                                         GInetAddress            *group,
 | 
						|
                                                         gboolean                 source_specific,
 | 
						|
                                                         const gchar             *iface,
 | 
						|
                                                         GError                 **error);
 | 
						|
GIO_AVAILABLE_IN_2_32
 | 
						|
gboolean               g_socket_leave_multicast_group   (GSocket                 *socket,
 | 
						|
                                                         GInetAddress            *group,
 | 
						|
                                                         gboolean                 source_specific,
 | 
						|
                                                         const gchar             *iface,
 | 
						|
                                                         GError                 **error);
 | 
						|
GIO_AVAILABLE_IN_2_56
 | 
						|
gboolean               g_socket_join_multicast_group_ssm    (GSocket                 *socket,
 | 
						|
                                                             GInetAddress            *group,
 | 
						|
                                                             GInetAddress            *source_specific,
 | 
						|
                                                             const gchar             *iface,
 | 
						|
                                                             GError                 **error);
 | 
						|
GIO_AVAILABLE_IN_2_56
 | 
						|
gboolean               g_socket_leave_multicast_group_ssm   (GSocket                 *socket,
 | 
						|
                                                             GInetAddress            *group,
 | 
						|
                                                             GInetAddress            *source_specific,
 | 
						|
                                                             const gchar             *iface,
 | 
						|
                                                             GError                 **error);
 | 
						|
GIO_AVAILABLE_IN_ALL
 | 
						|
gboolean               g_socket_connect                 (GSocket                 *socket,
 | 
						|
							 GSocketAddress          *address,
 | 
						|
							 GCancellable            *cancellable,
 | 
						|
							 GError                 **error);
 | 
						|
GIO_AVAILABLE_IN_ALL
 | 
						|
gboolean               g_socket_check_connect_result    (GSocket                 *socket,
 | 
						|
							 GError                 **error);
 | 
						|
 | 
						|
GIO_AVAILABLE_IN_ALL
 | 
						|
gssize                 g_socket_get_available_bytes     (GSocket                 *socket);
 | 
						|
 | 
						|
GIO_AVAILABLE_IN_ALL
 | 
						|
GIOCondition           g_socket_condition_check         (GSocket                 *socket,
 | 
						|
							 GIOCondition             condition);
 | 
						|
GIO_AVAILABLE_IN_ALL
 | 
						|
gboolean               g_socket_condition_wait          (GSocket                 *socket,
 | 
						|
							 GIOCondition             condition,
 | 
						|
							 GCancellable            *cancellable,
 | 
						|
							 GError                 **error);
 | 
						|
GIO_AVAILABLE_IN_2_32
 | 
						|
gboolean               g_socket_condition_timed_wait    (GSocket                 *socket,
 | 
						|
							 GIOCondition             condition,
 | 
						|
							 gint64                   timeout_us,
 | 
						|
							 GCancellable            *cancellable,
 | 
						|
							 GError                 **error);
 | 
						|
GIO_AVAILABLE_IN_ALL
 | 
						|
GSocket *              g_socket_accept                  (GSocket                 *socket,
 | 
						|
							 GCancellable            *cancellable,
 | 
						|
							 GError                 **error);
 | 
						|
GIO_AVAILABLE_IN_ALL
 | 
						|
gboolean               g_socket_listen                  (GSocket                 *socket,
 | 
						|
							 GError                 **error);
 | 
						|
GIO_AVAILABLE_IN_ALL
 | 
						|
gssize                 g_socket_receive                 (GSocket                 *socket,
 | 
						|
							 gchar                   *buffer,
 | 
						|
							 gsize                    size,
 | 
						|
							 GCancellable            *cancellable,
 | 
						|
							 GError                 **error);
 | 
						|
GIO_AVAILABLE_IN_ALL
 | 
						|
gssize                 g_socket_receive_from            (GSocket                 *socket,
 | 
						|
							 GSocketAddress         **address,
 | 
						|
							 gchar                   *buffer,
 | 
						|
							 gsize                    size,
 | 
						|
							 GCancellable            *cancellable,
 | 
						|
							 GError                 **error);
 | 
						|
GIO_AVAILABLE_IN_ALL
 | 
						|
gssize                 g_socket_send                    (GSocket                 *socket,
 | 
						|
							 const gchar             *buffer,
 | 
						|
							 gsize                    size,
 | 
						|
							 GCancellable            *cancellable,
 | 
						|
							 GError                 **error);
 | 
						|
GIO_AVAILABLE_IN_ALL
 | 
						|
gssize                 g_socket_send_to                 (GSocket                 *socket,
 | 
						|
							 GSocketAddress          *address,
 | 
						|
							 const gchar             *buffer,
 | 
						|
							 gsize                    size,
 | 
						|
							 GCancellable            *cancellable,
 | 
						|
							 GError                 **error);
 | 
						|
GIO_AVAILABLE_IN_ALL
 | 
						|
gssize                 g_socket_receive_message         (GSocket                 *socket,
 | 
						|
							 GSocketAddress         **address,
 | 
						|
							 GInputVector            *vectors,
 | 
						|
							 gint                     num_vectors,
 | 
						|
							 GSocketControlMessage ***messages,
 | 
						|
							 gint                    *num_messages,
 | 
						|
							 gint                    *flags,
 | 
						|
							 GCancellable            *cancellable,
 | 
						|
							 GError                 **error);
 | 
						|
GIO_AVAILABLE_IN_ALL
 | 
						|
gssize                 g_socket_send_message            (GSocket                 *socket,
 | 
						|
							 GSocketAddress          *address,
 | 
						|
							 GOutputVector           *vectors,
 | 
						|
							 gint                     num_vectors,
 | 
						|
							 GSocketControlMessage  **messages,
 | 
						|
							 gint                     num_messages,
 | 
						|
							 gint                     flags,
 | 
						|
							 GCancellable            *cancellable,
 | 
						|
							 GError                 **error);
 | 
						|
 | 
						|
GIO_AVAILABLE_IN_2_48
 | 
						|
gint                   g_socket_receive_messages        (GSocket                 *socket,
 | 
						|
                                                         GInputMessage           *messages,
 | 
						|
                                                         guint                    num_messages,
 | 
						|
                                                         gint                     flags,
 | 
						|
                                                         GCancellable            *cancellable,
 | 
						|
                                                         GError                 **error);
 | 
						|
GIO_AVAILABLE_IN_2_44
 | 
						|
gint                   g_socket_send_messages           (GSocket                 *socket,
 | 
						|
							 GOutputMessage          *messages,
 | 
						|
							 guint                    num_messages,
 | 
						|
							 gint                     flags,
 | 
						|
							 GCancellable            *cancellable,
 | 
						|
							 GError                 **error);
 | 
						|
 | 
						|
GIO_AVAILABLE_IN_ALL
 | 
						|
gboolean               g_socket_close                   (GSocket                 *socket,
 | 
						|
							 GError                 **error);
 | 
						|
GIO_AVAILABLE_IN_ALL
 | 
						|
gboolean               g_socket_shutdown                (GSocket                 *socket,
 | 
						|
							 gboolean                 shutdown_read,
 | 
						|
							 gboolean                 shutdown_write,
 | 
						|
							 GError                 **error);
 | 
						|
GIO_AVAILABLE_IN_ALL
 | 
						|
gboolean               g_socket_is_closed               (GSocket                 *socket);
 | 
						|
GIO_AVAILABLE_IN_ALL
 | 
						|
GSource *              g_socket_create_source           (GSocket                 *socket,
 | 
						|
							 GIOCondition             condition,
 | 
						|
							 GCancellable            *cancellable);
 | 
						|
GIO_AVAILABLE_IN_ALL
 | 
						|
gboolean               g_socket_speaks_ipv4             (GSocket                 *socket);
 | 
						|
GIO_AVAILABLE_IN_ALL
 | 
						|
GCredentials          *g_socket_get_credentials         (GSocket                 *socket,
 | 
						|
                                                         GError                 **error);
 | 
						|
 | 
						|
GIO_AVAILABLE_IN_ALL
 | 
						|
gssize                 g_socket_receive_with_blocking   (GSocket                 *socket,
 | 
						|
							 gchar                   *buffer,
 | 
						|
							 gsize                    size,
 | 
						|
							 gboolean                 blocking,
 | 
						|
							 GCancellable            *cancellable,
 | 
						|
							 GError                 **error);
 | 
						|
GIO_AVAILABLE_IN_ALL
 | 
						|
gssize                 g_socket_send_with_blocking      (GSocket                 *socket,
 | 
						|
							 const gchar             *buffer,
 | 
						|
							 gsize                    size,
 | 
						|
							 gboolean                 blocking,
 | 
						|
							 GCancellable            *cancellable,
 | 
						|
							 GError                 **error);
 | 
						|
GIO_AVAILABLE_IN_2_60
 | 
						|
GPollableReturn        g_socket_send_message_with_timeout (GSocket                *socket,
 | 
						|
							   GSocketAddress         *address,
 | 
						|
							   const GOutputVector    *vectors,
 | 
						|
							   gint                    num_vectors,
 | 
						|
							   GSocketControlMessage **messages,
 | 
						|
							   gint                    num_messages,
 | 
						|
							   gint                    flags,
 | 
						|
							   gint64                  timeout_us,
 | 
						|
							   gsize                  *bytes_written,
 | 
						|
							   GCancellable           *cancellable,
 | 
						|
							   GError                **error);
 | 
						|
GIO_AVAILABLE_IN_2_36
 | 
						|
gboolean               g_socket_get_option              (GSocket                 *socket,
 | 
						|
							 gint                     level,
 | 
						|
							 gint                     optname,
 | 
						|
							 gint                    *value,
 | 
						|
							 GError                 **error);
 | 
						|
GIO_AVAILABLE_IN_2_36
 | 
						|
gboolean               g_socket_set_option              (GSocket                 *socket,
 | 
						|
							 gint                     level,
 | 
						|
							 gint                     optname,
 | 
						|
							 gint                     value,
 | 
						|
							 GError                 **error);
 | 
						|
 | 
						|
G_END_DECLS
 | 
						|
 | 
						|
#endif /* __G_SOCKET_H__ */
 |