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
|
/*
* dpkg - main program for package management
* filesdb.h - management of database of files installed on system
*
* Copyright © 1995 Ian Jackson <ijackson@chiark.greenend.org.uk>
* Copyright © 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 FILESDB_H
#define FILESDB_H
#include <dpkg/file.h>
/*
* Data structure here is as follows:
*
* For each package we have a ‘struct fileinlist *’, the head of a list of
* files in that package. They are in ‘forwards’ order. Each entry has a
* pointer to the ‘struct filenamenode’.
*
* The struct filenamenodes are in a hash table, indexed by name.
* (This hash table is not visible to callers.)
*
* Each filenamenode has a (possibly empty) list of ‘struct filepackage’,
* giving a list of the packages listing that filename.
*
* When we read files contained info about a particular package we set the
* ‘files’ member of the clientdata struct to the appropriate thing. When
* not yet set the files pointer is made to point to ‘fileslist_uninited’
* (this is available only internally, within filesdb.c - the published
* interface is ensure_*_available).
*/
struct pkginfo;
/**
* Flags to findnamenode().
*/
enum fnnflags {
/** Do not need to copy filename. */
fnn_nocopy = DPKG_BIT(0),
/** findnamenode may return NULL. */
fnn_nonew = DPKG_BIT(1),
};
enum filenamenode_flags {
/** In the newconffiles list. */
fnnf_new_conff = DPKG_BIT(0),
/** In the new filesystem archive. */
fnnf_new_inarchive = DPKG_BIT(1),
/** In the old package's conffiles list. */
fnnf_old_conff = DPKG_BIT(2),
/** Obsolete conffile. */
fnnf_obs_conff = DPKG_BIT(3),
/** Must remove from other packages' lists. */
fnnf_elide_other_lists = DPKG_BIT(4),
/** >= 1 instance is a dir, cannot rename over. */
fnnf_no_atomic_overwrite = DPKG_BIT(5),
/** New file has been placed on the disk. */
fnnf_placed_on_disk = DPKG_BIT(6),
fnnf_deferred_fsync = DPKG_BIT(7),
fnnf_deferred_rename = DPKG_BIT(8),
/** Path being filtered. */
fnnf_filtered = DPKG_BIT(9),
};
struct filenamenode {
struct filenamenode *next;
const char *name;
struct pkg_list *packages;
struct diversion *divert;
/** We allow the administrator to override the owner, group and mode of
* a file. If such an override is present we use that instead of the
* stat information stored in the archive.
*
* This functionality used to be in the suidmanager package. */
struct file_stat *statoverride;
/*
* Fields from here on are used by archives.c &c, and cleared by
* filesdbinit.
*/
/** Set to zero when a new node is created. */
enum filenamenode_flags flags;
/** Valid iff this namenode is in the newconffiles list. */
const char *oldhash;
/** Valid iff the file was unpacked and hashed on this run. */
const char *newhash;
struct stat *filestat;
struct trigfileint *trig_interested;
};
struct fileinlist {
struct fileinlist *next;
struct filenamenode *namenode;
};
/**
* Queue of filenamenode entries.
*/
struct filenamenode_queue {
struct fileinlist *head, **tail;
};
/**
* When we deal with an ‘overridden’ file, every package except the
* overriding one is considered to contain the other file instead. Both
* files have entries in the filesdb database, and they refer to each other
* via these diversion structures.
*
* The contested filename's filenamenode has an diversion entry with
* useinstead set to point to the redirected filename's filenamenode; the
* redirected filenamenode has camefrom set to the contested filenamenode.
* Both sides' diversion entries will have pkg set to the package (if any)
* which is allowed to use the contended filename.
*
* Packages that contain either version of the file will all refer to the
* contested filenamenode in their per-file package lists (both in core and
* on disk). References are redirected to the other filenamenode's filename
* where appropriate.
*/
struct diversion {
struct filenamenode *useinstead;
struct filenamenode *camefrom;
struct pkgset *pkgset;
/** The ‘contested’ halves are in this list for easy cleanup. */
struct diversion *next;
};
struct filepackages_iterator;
struct filepackages_iterator *filepackages_iter_new(struct filenamenode *fnn);
struct pkginfo *filepackages_iter_next(struct filepackages_iterator *iter);
void filepackages_iter_free(struct filepackages_iterator *iter);
void filesdbinit(void);
struct fileiterator;
struct fileiterator *files_db_iter_new(void);
struct filenamenode *files_db_iter_next(struct fileiterator *iter);
void files_db_iter_free(struct fileiterator *iter);
void ensure_package_clientdata(struct pkginfo *pkg);
void ensure_diversions(void);
enum statdb_parse_flags {
STATDB_PARSE_NORMAL = 0,
STATDB_PARSE_LAX = 1,
};
uid_t statdb_parse_uid(const char *str);
gid_t statdb_parse_gid(const char *str);
mode_t statdb_parse_mode(const char *str);
void ensure_statoverrides(enum statdb_parse_flags flags);
#define LISTFILE "list"
#define HASHFILE "md5sums"
void ensure_packagefiles_available(struct pkginfo *pkg);
void ensure_allinstfiles_available(void);
void ensure_allinstfiles_available_quiet(void);
void note_must_reread_files_inpackage(struct pkginfo *pkg);
struct filenamenode *findnamenode(const char *filename, enum fnnflags flags);
void parse_filehash(struct pkginfo *pkg, struct pkgbin *pkgbin);
void write_filelist_except(struct pkginfo *pkg, struct pkgbin *pkgbin,
struct fileinlist *list, enum filenamenode_flags mask);
void write_filehash_except(struct pkginfo *pkg, struct pkgbin *pkgbin,
struct fileinlist *list, enum filenamenode_flags mask);
struct reversefilelistiter { struct fileinlist *todo; };
void reversefilelist_init(struct reversefilelistiter *iterptr, struct fileinlist *files);
struct filenamenode *reversefilelist_next(struct reversefilelistiter *iterptr);
void reversefilelist_abort(struct reversefilelistiter *iterptr);
#endif /* FILESDB_H */
|
