libzypp
13.10.6
|
Interface to the rpm program. More...
#include <RpmDb.h>
Public Types | |
enum | SyncTrustedKeyBits { SYNC_TO_KEYRING = 1<<0, SYNC_FROM_KEYRING = 1<<1, SYNC_BOTH = SYNC_TO_KEYRING | SYNC_FROM_KEYRING } |
Sync mode for syncTrustedKeys. More... | |
enum | checkPackageResult { CHK_OK = 0, CHK_NOTFOUND = 1, CHK_FAIL = 2, CHK_NOTTRUSTED = 3, CHK_NOKEY = 4, CHK_ERROR = 5 } |
checkPackage result More... | |
typedef class InstTargetError | Error |
Default error class. More... | |
typedef std::set< std::string > | FileList |
Public Member Functions | |
RpmDb () | |
Constructor. More... | |
~RpmDb () | |
Destructor. More... | |
Date | timestamp () const |
timestamp of the rpm database (last modification) More... | |
const Pathname & | root () const |
const Pathname & | dbPath () const |
bool | initialized () const |
void | initDatabase (Pathname root_r=Pathname(), Pathname dbPath_r=Pathname(), bool doRebuild_r=false) |
Prepare access to the rpm database. More... | |
void | closeDatabase () |
Block further access to the rpm database and go back to uninitialized state. More... | |
void | rebuildDatabase () |
Rebuild the rpm database (rpm –rebuilddb). More... | |
void | importPubkey (const PublicKey &pubkey_r) |
Import ascii armored public key in file pubkey_r. More... | |
void | removePubkey (const PublicKey &pubkey_r) |
Remove a public key from the rpm database. More... | |
std::list< PublicKey > | pubkeys () const |
Return the long ids of all installed public keys. More... | |
std::set< Edition > | pubkeyEditions () const |
Return the edition of all installed public keys. More... | |
std::list< FileInfo > | fileList (const std::string &name_r, const Edition &edition_r) const |
return complete file list for installed package name_r (in FileInfo.filename) if edition_r != Edition::noedition, check for exact edition if full==true, fill all attributes of FileInfo More... | |
bool | hasFile (const std::string &file_r, const std::string &name_r="") const |
Return true if at least one package owns a certain file (name_r empty) Return true if package name_r owns file file_r (name_r nonempty). More... | |
std::string | whoOwnsFile (const std::string &file_r) const |
Return name of package owning file or empty string if no installed package owns file. More... | |
bool | hasProvides (const std::string &tag_r) const |
Return true if at least one package provides a certain tag. More... | |
bool | hasRequiredBy (const std::string &tag_r) const |
Return true if at least one package requires a certain tag. More... | |
bool | hasConflicts (const std::string &tag_r) const |
Return true if at least one package conflicts with a certain tag. More... | |
bool | hasPackage (const std::string &name_r) const |
Return true if package is installed. More... | |
bool | hasPackage (const std::string &name_r, const Edition &ed_r) const |
Return true if package is installed in a certain edition. More... | |
void | getData (const std::string &name_r, RpmHeader::constPtr &result_r) const |
Get an installed packages data from rpmdb. More... | |
void | getData (const std::string &name_r, const Edition &ed_r, RpmHeader::constPtr &result_r) const |
Get an installed packages data from rpmdb. More... | |
void | syncTrustedKeys (SyncTrustedKeyBits mode_r=SYNC_BOTH) |
Sync trusted keys stored in rpm database and zypp trusted keyring. More... | |
void | importZyppKeyRingTrustedKeys () |
iterates through zypp keyring and import all non existant keys into rpm keyring More... | |
void | exportTrustedKeysInZyppKeyRing () |
insert all rpm trusted keys into zypp trusted keyring More... | |
checkPackageResult | checkPackage (const Pathname &path_r) |
Check signature of rpm file on disk. More... | |
void | installPackage (const Pathname &filename, RpmInstFlags flags=RPMINST_NONE) |
install rpm package More... | |
void | removePackage (const std::string &name_r, RpmInstFlags flags=RPMINST_NONE) |
remove rpm package More... | |
void | removePackage (Package::constPtr package, RpmInstFlags flags=RPMINST_NONE) |
Pathname | getBackupPath (void) |
get backup dir for rpm config files More... | |
bool | backupPackage (const std::string &packageName) |
create tar.gz of all changed files in a Package More... | |
bool | backupPackage (const Pathname &filename) |
queries file for name and then calls above backupPackage function. More... | |
void | setBackupPath (const Pathname &path) |
set path where package backups are stored More... | |
void | createPackageBackups (bool yes) |
whether to create package backups during install or removal More... | |
bool | queryChangedFiles (FileList &fileList, const std::string &packageName) |
determine which files of an installed package have been modified. More... | |
virtual std::ostream & | dumpOn (std::ostream &str) const |
Dump debug info. More... | |
Public Member Functions inherited from zypp::base::ReferenceCounted | |
ReferenceCounted () | |
Default ctor. More... | |
ReferenceCounted (const ReferenceCounted &rhs) | |
Copy ctor. More... | |
virtual | ~ReferenceCounted () |
Dtor. More... | |
ReferenceCounted & | operator= (const ReferenceCounted &) |
Assignment. More... | |
unsigned | refCount () const |
Return reference counter value. More... | |
void | ref () const |
Add a reference. More... | |
void | unref () const |
Release a reference. More... | |
Protected Member Functions | |
void | doRemovePackage (const std::string &name_r, RpmInstFlags flags, callback::SendReport< RpmRemoveReport > &report) |
void | doInstallPackage (const Pathname &filename, RpmInstFlags flags, callback::SendReport< RpmInstallReport > &report) |
void | doRebuildDatabase (callback::SendReport< RebuildDBReport > &report) |
Protected Member Functions inherited from zypp::base::ReferenceCounted | |
virtual void | ref_to (unsigned) const |
Trigger derived classes after refCount was increased. More... | |
virtual void | unref_to (unsigned) const |
Trigger derived classes after refCount was decreased. More... | |
Private Types | |
enum | DbStateInfoBits { DbSI_NO_INIT = 0x0000, DbSI_HAVE_V4 = 0x0001, DbSI_MADE_V4 = 0x0002, DbSI_MODIFIED_V4 = 0x0004, DbSI_HAVE_V3 = 0x0008, DbSI_HAVE_V3TOV4 = 0x0010, DbSI_MADE_V3TOV4 = 0x0020 } |
typedef std::vector< const char * > | RpmArgVec |
Private Member Functions | |
void | dbsi_set (DbStateInfoBits &val_r, const unsigned &bits_r) const |
void | dbsi_clr (DbStateInfoBits &val_r, const unsigned &bits_r) const |
bool | dbsi_has (const DbStateInfoBits &val_r, const unsigned &bits_r) const |
void | internal_initDatabase (const Pathname &root_r, const Pathname &dbPath_r, DbStateInfoBits &info_r) |
Internal helper for initDatabase. More... | |
void | modifyDatabase () |
Called before the database is modified by installPackage/removePackage. More... | |
void | run_rpm (const RpmArgVec &options, ExternalProgram::Stderr_Disposition stderr_disp=ExternalProgram::Stderr_To_Stdout) |
Run rpm with the specified arguments and handle stderr. More... | |
bool | systemReadLine (std::string &line) |
Read a line from the general rpm query. More... | |
int | systemStatus () |
Return the exit status of the general rpm process, closing the connection if not already done. More... | |
void | systemKill () |
Forcably kill the system process. More... | |
void | processConfigFiles (const std::string &line, const std::string &name, const char *typemsg, const char *difffailmsg, const char *diffgenmsg) |
handle rpm messages like "/etc/testrc saved as /etc/testrc.rpmorig" More... | |
Static Private Member Functions | |
static void | removeV4 (const Pathname &dbdir_r, bool v3backup_r) |
Remove the rpm4 database in dbdir_r and optionally any backup created on conversion. More... | |
static void | removeV3 (const Pathname &dbdir_r, bool v3backup_r) |
Remove the rpm3 database in dbdir_r. More... | |
Private Attributes | |
DbStateInfoBits | _dbStateInfo |
Internal state info. More... | |
Pathname | _root |
Root directory for all operations. More... | |
Pathname | _dbPath |
Directory that contains the rpmdb. More... | |
ExternalProgram * | process |
The connection to the rpm process. More... | |
int | exit_code |
The exit code of the rpm process, or -1 if not yet known. More... | |
std::string | error_message |
Error message from running rpm as external program. More... | |
Pathname | _backuppath |
/var/adm/backup More... | |
bool | _packagebackups |
create package backups? More... | |
bool | _warndirexists |
whether <_root>/<WARNINGMAILPATH> was already created More... | |
Friends | |
std::ostream & | operator<< (std::ostream &str, const DbStateInfoBits &obj) |
Additional Inherited Members | |
Static Public Member Functions inherited from zypp::base::ReferenceCounted | |
static void | add_ref (const ReferenceCounted *ptr_r) |
Called by zypp::intrusive_ptr to add a reference. More... | |
static void | release (const ReferenceCounted *ptr_r) |
Called by zypp::intrusive_ptr to add a reference. More... | |
Related Functions inherited from zypp::base::ReferenceCounted | |
void | intrusive_ptr_add_ref (const ReferenceCounted *ptr_r) |
void | intrusive_ptr_release (const ReferenceCounted *ptr_r) |
std::ostream & | operator<< (std::ostream &str, const ReferenceCounted &obj) |
typedef class InstTargetError zypp::target::rpm::RpmDb::Error |
|
private |
typedef std::set<std::string> zypp::target::rpm::RpmDb::FileList |
|
private |
Sync mode for syncTrustedKeys.
Enumerator | |
---|---|
SYNC_TO_KEYRING | |
SYNC_FROM_KEYRING |
export rpm trusted keys into zypp trusted keyring |
SYNC_BOTH |
import zypp trusted keys into rpm database. |
checkPackage result
Enumerator | |
---|---|
CHK_OK |
Signature is OK. |
CHK_NOTFOUND |
Signature is unknown type. |
CHK_FAIL |
Signature does not verify. |
CHK_NOTTRUSTED |
Signature is OK, but key is not trusted. |
CHK_NOKEY |
Public key is unavailable. |
CHK_ERROR |
File does not exist or can't be opened. |
zypp::target::rpm::RpmDb::RpmDb | ( | ) |
Constructor.
There's no rpmdb access until initDatabase was called.
|
inlineprivate |
|
inlineprivate |
|
inlineprivate |
|
private |
|
staticprivate |
|
staticprivate |
|
private |
Date zypp::target::rpm::RpmDb::timestamp | ( | ) | const |
|
inline |
|
inline |
|
inline |
void zypp::target::rpm::RpmDb::initDatabase | ( | Pathname | root_r = Pathname() , |
Pathname | dbPath_r = Pathname() , |
||
bool | doRebuild_r = false |
||
) |
Prepare access to the rpm database.
Optional arguments may denote the root directory for all operations and the directory (below root) that contains the rpmdb (usg. you won't need to set this).
On empty Pathnames the default is used:
root: / dbPath: /var/lib/rpm
Calling initDatabase a second time with different arguments will return an error but leave the database in it's original state.
Converting an old batabase is done if necessary. On update: The converted database will be removed by closeDatabase, if it was not modified (no packages were installed or deleted). Otherwise the new database is kept, and the old one is removed.
If the database alredy exists and doRebuild_r
is true, rebuildDatabase is called.
RpmException |
void zypp::target::rpm::RpmDb::closeDatabase | ( | ) |
Block further access to the rpm database and go back to uninitialized state.
On update: Decides what to do with any converted database (see initDatabase).
RpmException |
void zypp::target::rpm::RpmDb::rebuildDatabase | ( | ) |
Rebuild the rpm database (rpm –rebuilddb).
RpmException |
void zypp::target::rpm::RpmDb::importPubkey | ( | const PublicKey & | pubkey_r | ) |
Import ascii armored public key in file pubkey_r.
RpmException |
void zypp::target::rpm::RpmDb::removePubkey | ( | const PublicKey & | pubkey_r | ) |
Remove a public key from the rpm database.
RpmException |
list< PublicKey > zypp::target::rpm::RpmDb::pubkeys | ( | ) | const |
set< Edition > zypp::target::rpm::RpmDb::pubkeyEditions | ( | ) | const |
list< FileInfo > zypp::target::rpm::RpmDb::fileList | ( | const std::string & | name_r, |
const Edition & | edition_r | ||
) | const |
return complete file list for installed package name_r (in FileInfo.filename) if edition_r != Edition::noedition, check for exact edition if full==true, fill all attributes of FileInfo
bool zypp::target::rpm::RpmDb::hasFile | ( | const std::string & | file_r, |
const std::string & | name_r = "" |
||
) | const |
string zypp::target::rpm::RpmDb::whoOwnsFile | ( | const std::string & | file_r | ) | const |
bool zypp::target::rpm::RpmDb::hasProvides | ( | const std::string & | tag_r | ) | const |
bool zypp::target::rpm::RpmDb::hasRequiredBy | ( | const std::string & | tag_r | ) | const |
bool zypp::target::rpm::RpmDb::hasConflicts | ( | const std::string & | tag_r | ) | const |
bool zypp::target::rpm::RpmDb::hasPackage | ( | const std::string & | name_r | ) | const |
Return true if package is installed.
bool zypp::target::rpm::RpmDb::hasPackage | ( | const std::string & | name_r, |
const Edition & | ed_r | ||
) | const |
Return true if package is installed in a certain edition.
void zypp::target::rpm::RpmDb::getData | ( | const std::string & | name_r, |
RpmHeader::constPtr & | result_r | ||
) | const |
Get an installed packages data from rpmdb.
Package is identified by name. Data returned via result are NULL, if packge is not installed (PMError is not set), or RPM database could not be read (PMError is set).
RpmException | FIXME this and following comment |
void zypp::target::rpm::RpmDb::getData | ( | const std::string & | name_r, |
const Edition & | ed_r, | ||
RpmHeader::constPtr & | result_r | ||
) | const |
Get an installed packages data from rpmdb.
Package is identified by name and edition. Data returned via result are NULL, if packge is not installed (PMError is not set), or RPM database could not be read (PMError is set).
RpmException |
void zypp::target::rpm::RpmDb::syncTrustedKeys | ( | SyncTrustedKeyBits | mode_r = SYNC_BOTH | ) |
void zypp::target::rpm::RpmDb::importZyppKeyRingTrustedKeys | ( | ) |
void zypp::target::rpm::RpmDb::exportTrustedKeysInZyppKeyRing | ( | ) |
|
private |
Run rpm with the specified arguments and handle stderr.
n_opts | The number of arguments |
options | Array of the arguments, n_opts elements |
stderr_disp | How to handle stderr, merged with stdout by default |
RpmException |
|
private |
|
private |
|
private |
|
private |
handle rpm messages like "/etc/testrc saved as /etc/testrc.rpmorig"
line | rpm output starting with warning: |
name | name of package, appears in subject line |
typemsg | " saved as " or " created as " |
difffailmsg | what to put into mail if diff failed, must contain two s for the two files |
diffgenmsg | what to put into mail if diff succeeded, must contain two s for the two files |
RpmDb::checkPackageResult zypp::target::rpm::RpmDb::checkPackage | ( | const Pathname & | path_r | ) |
void zypp::target::rpm::RpmDb::installPackage | ( | const Pathname & | filename, |
RpmInstFlags | flags = RPMINST_NONE |
||
) |
install rpm package
filename | file to install |
flags | which rpm options to use |
RpmException |
void zypp::target::rpm::RpmDb::removePackage | ( | const std::string & | name_r, |
RpmInstFlags | flags = RPMINST_NONE |
||
) |
remove rpm package
name_r | Name of the rpm package to remove. |
iflags | which rpm options to use |
RpmException |
void zypp::target::rpm::RpmDb::removePackage | ( | Package::constPtr | package, |
RpmInstFlags | flags = RPMINST_NONE |
||
) |
|
inline |
bool zypp::target::rpm::RpmDb::backupPackage | ( | const std::string & | packageName | ) |
create tar.gz of all changed files in a Package
packageName | name of the Package to backup |
bool zypp::target::rpm::RpmDb::backupPackage | ( | const Pathname & | filename | ) |
void zypp::target::rpm::RpmDb::setBackupPath | ( | const Pathname & | path | ) |
set path where package backups are stored
|
inline |
bool zypp::target::rpm::RpmDb::queryChangedFiles | ( | FileList & | fileList, |
const std::string & | packageName | ||
) |
|
virtual |
Dump debug info.
Reimplemented from zypp::base::ReferenceCounted.
|
protected |
|
protected |
|
protected |
|
friend |
|
private |
|
private |
|
private |
|
private |
|
private |
|
private |
|
private |
|
private |
|
private |