mirror of
https://gitlab.gnome.org/GNOME/glib.git
synced 2026-10-24 00:49:00 +03:00
016829559e
g_type_ensure has a large comment saying _get_type shouldn't be marked with G_GNUC_CONST because it has side-effects on the first run, but it's OK if you consistently call g_type_ensure first. Unfortunately, this isn't accurate. GCC trunk (observed at r17-1725-ge259a182e1f100) now analyses points-to information more effectively and propagates its findings, so it sees the function modifies some global state, concludes that can't be possible (because of the const attribute), and deletes the stores. pure unfortunately is unsuitable for *_get_type too as it has a side-effect (writes to global memory). Mesa had a similar issue which I fixed recently [0]. glib and glibmm likely want the (not-yet-implemented) 'idempotent' attribute instead [1]. In fact, this exact problem is what motivated that request! :) ebassi mentions an alternative to the current setup as well, using atomics [2]. This problem has gone back many years but the compiler has finally fully outsmarted us here, so give in. [0] https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/42361 [1] https://gcc.gnu.org/PR32911 [2] https://gitlab.gnome.org/GNOME/glib/-/merge_requests/4249#note_2583110 Fixes: https://gitlab.gnome.org/GNOME/glib/-/work_items/3984 Signed-off-by: Sam James <sam@gentoo.org>
344 lines
17 KiB
C
344 lines
17 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);
|
|
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_2_80
|
|
GBytes * g_socket_receive_bytes (GSocket *socket,
|
|
gsize size,
|
|
gint64 timeout_us,
|
|
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_2_80
|
|
GBytes * g_socket_receive_bytes_from (GSocket *socket,
|
|
GSocketAddress **address,
|
|
gsize size,
|
|
gint64 timeout_us,
|
|
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__ */
|