This file is indexed.

/usr/share/gtk-doc/html/gnet/gnet-developers-async.html is in libgnet-dev 2.0.8-2.2.

This file is owned by root:root, with mode 0o644.

The actual contents of the file can be viewed below.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
<title>Hiding blocking</title>
<meta name="generator" content="DocBook XSL Stylesheets V1.72.0">
<link rel="start" href="index.html" title="GNet Network Library Reference Manual">
<link rel="up" href="gnet-developers.html" title="GNet for developers">
<link rel="prev" href="gnet-developers-tips.html" title="Tips and tricks">
<link rel="next" href="gnet-examples.html" title="GNet Examples">
<meta name="generator" content="GTK-Doc V1.8 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
<link rel="chapter" href="gnet-overview.html" title="GNet Overview">
<link rel="chapter" href="gnet-developers.html" title="GNet for developers">
<link rel="chapter" href="gnet-examples.html" title="GNet Examples">
<link rel="chapter" href="libgnet-reference.html" title="GNet Library Reference">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle">
<td><a accesskey="p" href="gnet-developers-tips.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
<td><a accesskey="u" href="gnet-developers.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
<th width="100%" align="center">GNet Network Library Reference Manual</th>
<td><a accesskey="n" href="gnet-examples.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
</tr></table>
<div class="sect1" lang="en">
<div class="titlepage"><div><div><h2 class="title" style="clear: both">
<a name="gnet-developers-async"></a>Hiding blocking</h2></div></div></div>
<p>
	Many GNet functions block.  That is, they do not return
	immediately.  For example
	<code class="function">gnet_inetaddr_new</code> performs a DNS lookup
	that may take several seconds.  This is acceptable for many
	programs.  But, it is not tolerable in interactive GUI
	programs or high-performance servers.  
      </p>
<p>
	There are two ways to hide blocking.  The first is to use
	threads.  GLib 2.0 includes thread support (GThread).  The
	second method is to use asynchronous functions.  Asynchronous
	functions return immediately and call a callback when the
	operation is completed.  For example,
	<code class="function">gnet_inetaddr_new_async</code> begins an
	asynchronous DNS lookup and returns immediately.  When the
	lookup is complete, a callback is called with the GInetAddr.
	Most blocking function in GNet have an asynchronous
	counterpart.
      </p>
<p>
	To use GNet's asynchronous functions, you must also use the
	GLib main event loop.  Most GTK and Gnome program already do
	this.
      </p>
<p>
	Another common blocking operation is reading or writing to a
	GIOChannel (a GLib object).
	<code class="function">g_io_channel_read</code> blocks until there is
	data available to read.
	<code class="function">g_io_channel_write</code> blocks until there is
	OS buffer space to write to.  To determine when a GIOChannel
	can be read to or written from without blocking, use GLib's
	<code class="function">g_io_add_watch</code> to set a watch.  A
	callback is called when the GIOChannel becomes readable or
	writable.  See the GLib documentation for more information and
	GNet's echoclient-async and echoserver-async for an example.
      </p>
</div>
</body>
</html>