This file is indexed.

/usr/share/gtk-doc/html/PackageKit/backend-compiled.html is in packagekit-docs 1.1.9-1ubuntu2.

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
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>Compiled Backends: PackageKit Reference Manual</title>
<meta name="generator" content="DocBook XSL Stylesheets V1.79.1">
<link rel="home" href="index.html" title="PackageKit Reference Manual">
<link rel="up" href="specification.html" title="PackageKit Specification">
<link rel="prev" href="introduction-ideas-status.html" title="Status Values">
<link rel="next" href="backend-spawn.html" title="Spawned Backends">
<meta name="generator" content="GTK-Doc V1.27 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
</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="5"><tr valign="middle">
<td width="100%" align="left" class="shortcuts"></td>
<td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
<td><a accesskey="u" href="specification.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
<td><a accesskey="p" href="introduction-ideas-status.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
<td><a accesskey="n" href="backend-spawn.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>
</tr></table>
<div class="chapter">
<div class="titlepage"><div><div><h2 class="title">
<a name="backend-compiled"></a>Compiled Backends</h2></div></div></div>
<p>
    If you have a C or C++ binding for your package system then
    you can use a compiled backend, which is more efficient than
    using helpers as described below.
    You can include the headers in the backend (with extra
    libraries) and then just write the simple code to interface
    with the methods of PackageKit.
    A C example can be found in <code class="literal">backends/box</code> and a
    C++ example in <code class="literal">backends/aptcc</code>.
  </p>
<p>
    You will have to use threading if your backend does not support async
    operation as requests have to return immediately.
    This is very important. Do any significant processing in a thread, and
    certainly don't return package results without creating a thread.
    By keeping the backends async we can make sure that there is no blocking
    which means the command line and UI do not freeze.
  </p>
</div>
<div class="footer">
<hr>Generated by GTK-Doc V1.27</div>
</body>
</html>