Method
GioSocketListeneradd_socket
since: 2.22
Declaration
gboolean
g_socket_listener_add_socket (
GSocketListener* listener,
GSocket* socket,
GObject* source_object,
GError** error
)
Description
Adds socket to the set of sockets that we try to accept
new clients from. The socket must be bound to a local
address and listened to.
source_object will be passed out in the various calls
to accept to identify this particular source, which is
useful if you’re listening on multiple addresses and do
different things depending on what address is connected to.
The socket will not be automatically closed when the listener is finalized
unless the listener held the final reference to the socket. Before GLib 2.42,
the socket was automatically closed on finalization of the listener, even
if references to it were held elsewhere.
Available since: 2.22
Parameters
socket-
Type:
GSocketA listening
GSocket.The data is owned by the caller of the method. source_object-
Type:
GObjectOptional
GObjectidentifying this source.The argument can be NULL.The data is owned by the caller of the method. error-
Type:
GError **The return location for a recoverable error.
The argument can be NULL.If the return location is not NULL, then you must initialize it to aNULLGError*.The argument will be left initialized to NULLby the method if there are no errors.In case of error, the argument will be set to a newly allocated GError; the caller will take ownership of the data, and be responsible for freeing it.