gboolean g_socket_bind ( GSocket* socket, GSocketAddress* address, gboolean allow_reuse, GError** error )
When a socket is created it is attached to an address family, but it
doesn’t have an address in this family.
g_socket_bind() assigns the
address (sometimes called name) of the socket.
It is generally required to bind to a local address before you can
receive connections. (See
In certain situations, you may also want to bind a socket that will be
used to initiate connections, though this is not normally required.
socket is a TCP socket, then
allow_reuse controls the setting
SO_REUSEADDR socket option; normally it should be
server sockets (sockets that you will eventually call
g_socket_accept() on), and
FALSE for client sockets. (Failing to
set this flag on a server socket may cause
g_socket_bind() to return
G_IO_ERROR_ADDRESS_IN_USE if the server program is stopped and then
socket is a UDP socket, then
allow_reuse determines whether or
not other UDP sockets can be bound to the same address at the same
time. In particular, you can have several UDP sockets bound to the
same address, and they will all receive all of the multicast and
broadcast packets sent to that address. (The behavior of unicast
UDP packets to an address with multiple listeners is not defined.)
Available since: 2.22
GSocketAddressspecifying the local address.
The data is owned by the caller of the method.
Whether to allow reusing this address.
The return location for a recoverable error.
The argument can be
If the return location is not
NULL, then you must initialize it to a
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.