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
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
|
/*
* dpkg - main program for package management
* main.h - external definitions for this program
*
* Copyright © 1995 Ian Jackson <ian@chiark.greenend.org.uk>
* Copyright © 2006,2008-2014 Guillem Jover <guillem@debian.org>
*
* This 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 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. If not, see <https://www.gnu.org/licenses/>.
*/
#ifndef MAIN_H
#define MAIN_H
#include <dpkg/debug.h>
#include <dpkg/pkg-list.h>
/* These two are defined in filesdb.h. */
struct fileinlist;
struct filenamenode_queue;
struct filenamenode;
enum pkg_istobe {
PKG_ISTOBE_NORMAL,
PKG_ISTOBE_REMOVE,
PKG_ISTOBE_INSTALLNEW,
PKG_ISTOBE_DECONFIGURE,
PKG_ISTOBE_PREINSTALL,
};
enum pkg_cycle_color {
PKG_CYCLE_WHITE,
PKG_CYCLE_GRAY,
PKG_CYCLE_BLACK,
};
struct perpackagestate {
enum pkg_istobe istobe;
/** Used during cycle detection. */
enum pkg_cycle_color color;
/**
* filelistvalid files Meaning
* ------------- ----- -------
* false NULL Not read yet, must do so if want them.
* false !NULL Read, but rewritten and now out of date. If want
* info must throw away old and reread file.
* true !NULL Read, all is OK.
* true NULL Read OK, but, there were no files.
*/
bool fileslistvalid;
struct fileinlist *files;
int replacingfilesandsaid;
off_t listfile_phys_offs;
/** Non-NULL iff in trigproc.c:deferred. */
struct pkg_list *trigprocdeferred;
};
enum action {
act_unset,
act_unpack,
act_configure,
act_install,
act_triggers,
act_remove,
act_purge,
act_verify,
act_commandfd,
act_status,
act_listpackages,
act_listfiles,
act_searchfiles,
act_controlpath,
act_controllist,
act_controlshow,
act_cmpversions,
act_arch_add,
act_arch_remove,
act_printarch,
act_printinstarch,
act_printforeignarches,
act_assertpredep,
act_assertepoch,
act_assertlongfilenames,
act_assertmulticonrep,
act_assertmultiarch,
act_assertverprovides,
act_audit,
act_unpackchk,
act_predeppackage,
act_getselections,
act_setselections,
act_clearselections,
act_avail,
act_printavail,
act_avclear,
act_avreplace,
act_avmerge,
act_forgetold,
};
extern const char *const statusstrings[];
extern int f_pending, f_recursive, f_alsoselect, f_skipsame, f_noact;
extern int f_autodeconf, f_nodebsig;
extern int f_triggers;
extern int fc_downgrade, fc_configureany, fc_hold, fc_removereinstreq, fc_overwrite;
extern int fc_removeessential, fc_conflicts, fc_depends, fc_dependsversion;
extern int fc_breaks, fc_badpath, fc_overwritediverted, fc_architecture;
extern int fc_nonroot, fc_overwritedir, fc_conff_new, fc_conff_miss;
extern int fc_conff_old, fc_conff_def;
extern int fc_conff_ask;
extern int fc_badverify;
extern int fc_badversion;
extern int fc_unsafe_io;
extern bool abort_processing;
extern int errabort;
extern const char *instdir;
extern struct pkg_list *ignoredependss;
struct invoke_hook {
struct invoke_hook *next;
const char *command;
};
/* from archives.c */
int archivefiles(const char *const *argv);
void process_archive(const char *filename);
bool wanttoinstall(struct pkginfo *pkg);
struct fileinlist *
filenamenode_queue_push(struct filenamenode_queue *queue,
struct filenamenode *namenode);
/* from update.c */
int forgetold(const char *const *argv);
int updateavailable(const char *const *argv);
/* from enquiry.c */
int audit(const char *const *argv);
int unpackchk(const char *const *argv);
int assertepoch(const char *const *argv);
int assertpredep(const char *const *argv);
int assertlongfilenames(const char *const *argv);
int assertmulticonrep(const char *const *argv);
int assertmultiarch(const char *const *argv);
int assertverprovides(const char *const *argv);
int predeppackage(const char *const *argv);
int printarch(const char *const *argv);
int printinstarch(const char *const *argv);
int print_foreign_arches(const char *const *argv);
int cmpversions(const char *const *argv);
/* from verify.c */
int verify_set_output(const char *name);
int verify(const char *const *argv);
/* from select.c */
int getselections(const char *const *argv);
int setselections(const char *const *argv);
int clearselections(const char *const *argv);
/* from packages.c, remove.c and configure.c */
void md5hash(struct pkginfo *pkg, char *hashbuf, const char *fn);
void enqueue_package(struct pkginfo *pkg);
void process_queue(void);
int packages(const char *const *argv);
void removal_bulk(struct pkginfo *pkg);
int conffderef(struct pkginfo *pkg, struct varbuf *result, const char *in);
enum dep_check {
DEP_CHECK_HALT = 0,
DEP_CHECK_DEFER = 1,
DEP_CHECK_OK = 2,
};
enum dep_check dependencies_ok(struct pkginfo *pkg, struct pkginfo *removing,
struct varbuf *aemsgs);
enum dep_check breakses_ok(struct pkginfo *pkg, struct varbuf *aemsgs);
void deferred_remove(struct pkginfo *pkg);
void deferred_configure(struct pkginfo *pkg);
extern int sincenothing, dependtry;
/* from cleanup.c (most of these are declared in archives.h) */
void cu_prermremove(int argc, void **argv);
/* from errors.c */
void print_error_perpackage(const char *emsg, const void *data);
void print_error_perarchive(const char *emsg, const void *data);
void forcibleerr(int forceflag, const char *format, ...) DPKG_ATTR_PRINTF(2);
int reportbroken_retexitstatus(int ret);
bool skip_due_to_hold(struct pkginfo *pkg);
/* from help.c */
struct stat;
bool ignore_depends(struct pkginfo *pkg);
bool force_breaks(struct deppossi *possi);
bool force_depends(struct deppossi *possi);
bool force_conflicts(struct deppossi *possi);
void conffile_mark_obsolete(struct pkginfo *pkg, struct filenamenode *namenode);
void oldconffsetflags(const struct conffile *searchconff);
void ensure_pathname_nonexisting(const char *pathname);
int secure_unlink(const char *pathname);
int secure_unlink_statted(const char *pathname, const struct stat *stab);
void checkpath(void);
struct filenamenode *namenodetouse(struct filenamenode *namenode,
struct pkginfo *pkg, struct pkgbin *pkgbin);
int maintscript_installed(struct pkginfo *pkg, const char *scriptname,
const char *desc, ...) DPKG_ATTR_SENTINEL;
int maintscript_new(struct pkginfo *pkg,
const char *scriptname, const char *desc,
const char *cidir, char *cidirrest, ...)
DPKG_ATTR_SENTINEL;
int maintscript_fallback(struct pkginfo *pkg,
const char *scriptname, const char *desc,
const char *cidir, char *cidirrest,
const char *ifok, const char *iffallback);
/* Callers wanting to run the postinst use these two as they want to postpone
* trigger incorporation until after updating the package status. The effect
* is that a package can trigger itself. */
int maintscript_postinst(struct pkginfo *pkg, ...) DPKG_ATTR_SENTINEL;
void post_postinst_tasks(struct pkginfo *pkg, enum pkgstatus new_status);
void clear_istobes(void);
bool dir_is_used_by_others(struct filenamenode *namenode, struct pkginfo *pkg);
bool dir_is_used_by_pkg(struct filenamenode *namenode, struct pkginfo *pkg,
struct fileinlist *list);
bool dir_has_conffiles(struct filenamenode *namenode, struct pkginfo *pkg);
void log_action(const char *action, struct pkginfo *pkg, struct pkgbin *pkgbin);
/* from trigproc.c */
void trigproc_install_hooks(void);
void trigproc_run_deferred(void);
void trigproc_reset_cycle(void);
void trigproc(struct pkginfo *pkg);
void trig_activate_packageprocessing(struct pkginfo *pkg);
/* from depcon.c */
enum which_pkgbin {
wpb_installed,
wpb_available,
wpb_by_istobe,
};
struct deppossi_pkg_iterator;
struct deppossi_pkg_iterator *
deppossi_pkg_iter_new(struct deppossi *possi, enum which_pkgbin wpb);
struct pkginfo *
deppossi_pkg_iter_next(struct deppossi_pkg_iterator *iter);
void
deppossi_pkg_iter_free(struct deppossi_pkg_iterator *iter);
bool depisok(struct dependency *dep, struct varbuf *whynot,
struct pkginfo **fixbyrm, struct pkginfo **fixbytrigaw,
bool allowunconfigd);
struct cyclesofarlink;
bool findbreakcycle(struct pkginfo *pkg);
void describedepcon(struct varbuf *addto, struct dependency *dep);
#endif /* MAIN_H */
|