glib/docs/reference/gio/networking.md
Philip Withnall 708de2fc12 docs: Move the gnetworking SECTION
Move it to a separate page.

Signed-off-by: Philip Withnall <pwithnall@gnome.org>

Helps: #3037
2023-11-15 11:48:23 +00:00

1.1 KiB

Title: gnetworking.h SPDX-License-Identifier: LGPL-2.1-or-later SPDX-FileCopyrightText: 2010 Dan Winship

gnetworking.h

The <gio/gnetworking.h> header can be included to get various low-level networking-related system headers, automatically taking care of certain portability issues for you.

This can be used, for example, if you want to call setsockopt() on a [class@Gio.Socket].

Note that while WinSock has many of the same APIs as the traditional UNIX socket API, most of them behave at least slightly differently (particularly with respect to error handling). If you want your code to work under both UNIX and Windows, you will need to take these differences into account.

Also, under GNU libc, certain non-portable functions are only visible in the headers if you define _GNU_SOURCE before including them. Note that this symbol must be defined before including any headers, or it may not take effect.

There is one function provided specifically for initialising the networking APIs, which needs to be called only if they are being used before GLib initialises itself:

  • [func@Gio.networking_init]