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
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
|
// download_install_manager.h -*-c++-*-
//
// Copyright (C) 2005, 2008, 2010 Daniel Burrows
//
// This program is free software; you can redistribute it and/or
// modify it under the terms of the GNU General Public License as
// published by the Free Software Foundation; either version 2 of
// the License, or (at your option) any later version.
//
// This program is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
// General Public License for more details.
//
// You should have received a copy of the GNU General Public License
// along with this program; see the file COPYING. If not, write to
// the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
// Boston, MA 02111-1307, USA.
#ifndef DOWNLOAD_INSTALL_MANAGER_H
#define DOWNLOAD_INSTALL_MANAGER_H
#include "download_manager.h"
#include "apt.h"
#include <apt-pkg/packagemanager.h> // For OrderResult
#include <apt-pkg/pkgcache.h> // For logging
#include <apt-pkg/sourcelist.h>
#include <sigc++/signal.h>
#include <utility>
#include <vector>
/** \file download_install_manager.h
*/
// This complex slot-based mechanism is used so that we can still have
// a generic downloading framework (e.g., ui_download_manager).
// The type of a function that runs dpkg in a terminal. Its first
// argument is a function that invokes dpkg as currently appropriate,
// given the status file descriptor on which to invoke it (or -1 to
// discard status messages); it can be invoked in a background thread
// or a sub-process. Its second argument is a continuation to invoke
// after we finish running dpkg, and it should be invoked in a
// foreground thread.
typedef sigc::slot2<void,
sigc::slot1<pkgPackageManager::OrderResult, int>,
sigc::slot1<void, pkgPackageManager::OrderResult> > run_dpkg_in_terminal_func;
/** Manages downloading and installing packages. */
class download_install_manager : public download_manager
{
/** A signal log upon which Complete() should be called. */
download_signal_log *log;
/** If \b true, don't actually invoke the package manager. */
bool download_only;
/** The package manager object used when installing packages */
pkgPackageManager *pm;
/** The list of sources from which to download. */
pkgSourceList src_list;
/** How to run the actual install process. */
run_dpkg_in_terminal_func run_dpkg_in_terminal;
/** Actually run dpkg; this is the part of the installation
* that might run in a sub-process.
*/
pkgPackageManager::OrderResult run_dpkg(int status_fd);
/** \brief Invoke the part of finish() that runs after dpkg.
*
* This function must be invoked in the foreground thread.
*
* \param dpkg_result The return value of run_dpkg().
* \param progress An object to use in displaying the
* progress when reloading.
*
* \param k A continuation to invoke with the result of
* the install process; if the result is do_again,
* then the receiver should repeat the process
* beginning with do_download().
*/
void finish_post_dpkg(pkgPackageManager::OrderResult dpkg_result,
OpProgress *progress,
const sigc::slot1<void, result> &k);
/** \brief Invoke the part of finish() that runs before dpkg.
*
* This function must be invoked in the foreground thread.
*
* \param result The return value of do_download().
*
* \return success or failure; if success is returned, you may
* proceed to invoke finish_run_dpkg(). Otherwise,
* finish_post_dpkg() should be invoked with
* pkgPackageManager::Failed.
*/
result finish_pre_dpkg(pkgAcquire::RunResult result);
public:
/** \param _download_only if \b true, this download process will
* stop after downloading files (i.e., it won't run the package
* manager).
*
* \param _run_dpkg_in_terminal how to set up the terminal for dpkg.
*/
download_install_manager(bool _download_only,
const run_dpkg_in_terminal_func &_run_dpkg_in_terminal);
~download_install_manager();
/** Set up an install run. Does not take ownership of any of the
* arguments to the method.
*
* \param progress the progress object to use when
* saving the current cache state.
*
* \param _download_only if \b true, don't actually install packages.
*
* \param acqlog the status object to receive direct messages as
* the download proceeds.
*
* \param signallog an object upon which Complete() should be
* called once the entire install process is finished.
*
* \return \b true iff the preparation was successful.
*/
bool prepare(OpProgress &progress,
pkgAcquireStatus &acqlog,
download_signal_log *signallog);
/** If download_only is false, call the package manager to install
* or remove packages.
*
* The package manager will be invoked via run_dpkg_in_terminal.
*/
void finish(pkgAcquire::RunResult result,
OpProgress *progress,
const sigc::slot1<void, download_manager::result> &k);
/** Invoked after an automatic 'forget new' operation. */
sigc::signal0<void> post_forget_new_hook;
};
#endif
|
