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
|
// dump_packages.h -*-c++-*-
//
// Copyright (C) 2007 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 DUMP_PACKAGES_H
#define DUMP_PACKAGES_H
#include <apt-pkg/pkgcache.h>
#include <set>
#include <vector>
/** \brief Functions to write information about packages to a stream
* in Packages-file format.
*
* \file dump_packages.h
*/
namespace aptitude
{
namespace apt
{
/** \brief Write the given Packages file entry to the given
* stream.
*
* \param vf the Packages file entry to write.
* \param out the stream to which to write the entry.
*/
void dump_verfile(const pkgCache::VerFileIterator &vf,
std::ostream &out);
/** \brief Write all the entries associated with the given
* package version.
*
* \param ver the version whose entries should be written.
* \param out the stream to which the entries should be written.
*/
void dump_version(const pkgCache::VerIterator &ver,
std::ostream &out);
/** \brief Write all the entries associated with the given
* package versions.
*
* \param versions the versions whose Packages entries should
* be written.
* \param out the stream to which the Packages entries
* should be written.
*/
void dump_versions(const std::vector<pkgCache::VerIterator> &versions,
std::ostream &out);
/** \brief Write all the entries associated with the given
* packages, dropping outgoing dependencies.
*
* Dependencies that point to a package not in the given set
* will be stripped from the output file. This is used to
* drop irrelevant dependencies when generating resolver test
* cases.
*/
void dump_truncated_packages(const std::set<pkgCache::PkgIterator> &versions,
std::ostream &out);
/** Make a truncated state snapshot in the given directory.
*
* We need to copy:
*
* - $(Dir::State::lists)/
* - $(Dir::State::status)/
* - $(Dir::Etc::sourceparts)/
* - $(Dir::Etc::vendorlist)
* - $(Dir::Etc::vendorparts)/
* - $(Dir::Etc::main)
* - $(Dir::Etc::parts)/
* - $(Dir::Etc::preferences)
*
* Dir::State::* are truncated copies; the others are copied
* literally.
*
* \todo check that outDir doesn't exist.
*
* \note This calls _error in many places; instead it should
* throw exceptions (all else aside, _error isn't
* thread-safe!).
*
* \param out_dir the target directory, which should not
* exist.
* \param visited_packages the packages that should
* be contained in the truncated cache.
*/
void make_truncated_state_copy(const std::string &out_dir,
const std::set<pkgCache::PkgIterator> &visited_packages);
}
}
#endif
|
