= Apps that do network communication =

== Requesting network connection == #network

If your application needs to do network communication and it appears that there is no physical network connection
(e.g. `gethostbyname()` fails for a valid name) then:

  * Call `boinc_need_network()`. This will alert the user that a network connection is needed.
  * Periodically call `boinc_network_poll()` until it returns zero.
  * Do whatever communication is needed.
  * When done, call `boinc_network_done()`. This enables the hangup of a modem connection, if needed. 

{{{
#!c++
void boinc_need_network();
int boinc_network_poll();
void boinc_network_done();
}}}