/usr/share/gtk-doc/html/PackageKit/introduction-ideas-simultaneous.html is in packagekit-docs 0.7.6-3.
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 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 | <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>Simultaneous Mode</title>
<meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
<link rel="home" href="index.html" title="PackageKit Reference Manual">
<link rel="up" href="concepts.html" title="Important Concepts">
<link rel="prev" href="introduction-ideas-status.html" title="Status Values">
<link rel="next" href="backend-compiled.html" title="Compiled Backends">
<meta name="generator" content="GTK-Doc V1.18 (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="2"><tr valign="middle">
<td><a accesskey="p" href="introduction-ideas-status.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
<td><a accesskey="u" href="concepts.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">PackageKit Reference Manual</th>
<td><a accesskey="n" href="backend-compiled.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
</tr></table>
<div class="sect1">
<div class="titlepage"><div><div><h2 class="title" style="clear: both">
<a name="introduction-ideas-simultaneous"></a>Simultaneous Mode</h2></div></div></div>
<p>
By default, a packagekit backend operates in a mode where only one activity is done at one
time, for example, epiphany is downloaded and then installed.
Some backends are able to download or install multiple files at once, and this may need to
be conveyed to a GUI tool as a list of variable length, rather than just a package_id and
summary.
</p>
<p>
The function <code class="literal">pk_backend_set_simultaneous_mode(TRUE)</code> is used to turn on
the simultaneous operation, where the backend can control the finished status of the
<code class="literal">::Package()</code> calls.
This is not needed for a typical backend.
</p>
<p>
For instance, a typical non-simultaneous backend might do:
</p>
<div class="itemizedlist"><ul class="itemizedlist" type="disc">
<li class="listitem"><p>
1. <code class="literal">pk_backend_package(DOWNLOADING, "epiphany")</code>
</p></li>
<li class="listitem"><p>
2. <code class="literal">pk_backend_package(DOWNLOADING, "nautilus")</code>
</p></li>
<li class="listitem"><p>
3. <code class="literal">pk_backend_package(INSTALLING, "epiphany")</code>
</p></li>
<li class="listitem"><p>
4. <code class="literal">pk_backend_package(INSTALLING, "nautilus")</code>
</p></li>
<li class="listitem"><p>
5. <code class="literal">pk_backend_finished(SUCCESS)</code>
</p></li>
</ul></div>
<p>
This is translated by the daemon automatically into a coherent sequence that can be used to
update a GUI with the correct information.
This is done automatically and transparently from the backend.
The effective output from the daemon would be:
</p>
<div class="itemizedlist"><ul class="itemizedlist" type="disc">
<li class="listitem"><p>
1. <code class="literal">pk_backend_package(DOWNLOADING, "epiphany")</code>
</p></li>
<li class="listitem"><p>
2. <code class="literal">pk_backend_package(FINISHED, "epiphany")</code>
<code class="literal">pk_backend_package(DOWNLOADING, "nautilus")</code>
</p></li>
<li class="listitem"><p>
3. <code class="literal">pk_backend_package(FINISHED, "nautilus")</code>
<code class="literal">pk_backend_package(INSTALLING, "epiphany")</code>
</p></li>
<li class="listitem"><p>
4. <code class="literal">pk_backend_package(FINISHED, "epiphany")</code>
<code class="literal">pk_backend_package(INSTALLING, "nautilus")</code>
</p></li>
<li class="listitem"><p>
5. <code class="literal">pk_backend_package(FINISHED, "nautilus")</code>
<code class="literal">pk_backend_finished(SUCCESS)</code>
</p></li>
</ul></div>
<p>
For a simultaneous backend, the backend is in full control of the <code class="literal">FINISHED</code>
state of the package actions.
This way it is possible to show the status of multiple packages in the GUI programs.
</p>
<p>
For instance, a typical simultaneous backend might do:
</p>
<div class="itemizedlist"><ul class="itemizedlist" type="disc">
<li class="listitem"><p>
1. <code class="literal">pk_backend_set_simultaneous_mode(TRUE)</code>
</p></li>
<li class="listitem"><p>
2. <code class="literal">pk_backend_package(DOWNLOADING, "epiphany")</code>
</p></li>
<li class="listitem"><p>
3. <code class="literal">pk_backend_package(DOWNLOADING, "nautilus")</code>
</p></li>
<li class="listitem"><p>
4. <code class="literal">pk_backend_package(FINISHED, "nautilus")</code>
<code class="literal">pk_backend_package(INSTALLING, "nautilus")</code>
</p></li>
<li class="listitem"><p>
5. <code class="literal">pk_backend_package(FINISHED, "epiphany")</code>
<code class="literal">pk_backend_package(INSTALLING, "epiphany")</code>
</p></li>
<li class="listitem"><p>
6. <code class="literal">pk_backend_package(FINISHED, "nautilus")</code>
</p></li>
<li class="listitem"><p>
7. <code class="literal">pk_backend_package(FINISHED, "epiphany")</code>
<code class="literal">pk_backend_finished(SUCCESS)</code>
</p></li>
</ul></div>
</div>
<div class="footer">
<hr>
Generated by GTK-Doc V1.18</div>
</body>
</html>
|