<page xmlns="http://projectmallard.org/1.0/" xmlns:its="http://www.w3.org/2005/11/its" type="topic" style="task" id="overview-net" xml:lang="it">

  <info>

    <link type="guide" xref="index" group="net"/>

    <revision version="0.1" date="2013-08-06" status="review"/>

    <credit type="author copyright">

      <name>David King</name>

      <email its:translate="no">davidk@gnome.org</email>

      <years>2013</years>

    </credit>

    <include xmlns="http://www.w3.org/2001/XInclude" href="legal.xml"/>

    <desc>Client and server HTTP communication, portable socket-based networking IO, and network device management.</desc>

  </info>

<title>Low-level networking</title>

<list>

 <item>

  
Create powerful and flexible HTTP servers and clients

 </item>

 <item>

  
Use portable socket-based APIs in a UI without blocking

 </item>

 <item>

  
Detect and manage the network connection state

 </item>

</list>

Take advantage of the portable networking APIs for accessing network

services. Asynchronous IO keeps your application UI responsive while IO is in

progress. Detect changes in the system networking state, to make your

application respond appropriately when there is no Internet access.

<media type="image" mime="image/png" src="test_comm1.png" width="65%">

 
IMAGE

</media>

-->

<section id="what">

  <title>What can you do?</title>

  
To asynchronously access low-level networking APIs,

  use GIO networking.

  Higher-level API is available for resolving proxies and

  DNS records as well as using secure sockets

  (TLS).

  
Simple monitoring of network state is available in GIO, but

  NetworkManager provides

  comprehensive support for networking devices and

  network topologies.

  
Libsoup provides a flexible

  interface for HTTP servers and clients. Both

  synchronous and asynchronous APIs are provided.

</section>

<section id="samples">

 <title>Code samples</title>

 <list>

  <item>
A sample we should write
</item>

  <item>
<link xref="samples">More…</link>
</item>

 </list>

</section>

-->

<section id="realworld">

  <title>Real-world examples</title>

  
You can see lots of real-world applications of GNOME networking

  technologies in open source projects, like the examples given below.

  <list>

    <item>

      
Web is the GNOME browser, which uses libsoup

      to access HTTP services.

      
( <link href="https://wiki.gnome.org/Apps/Web">Website</link> | <link href="https://git.gnome.org/browse/epiphany/plain/data/screenshot.png">Screenshot</link> | <link href="https://git.gnome.org/browse/epiphany/">Source code</link> )

    </item>

    <item>

      
GNOME Shell is the user-visible GNOME desktop,

      which uses NetworkManager for the network status menu, including managing

      wired, wireless, 3G modem and VPN networking systems.

      
( <link href="https://wiki.gnome.org/Projects/GnomeShell">Website</link> | <link href="http://www.gnome.org/gnome-3/">Screenshot</link> | <link href="https://git.gnome.org/browse/gnome-shell/">Source Code</link> )

    </item>

  </list>

</section>

</page>