Struct PkgDepCache 

pub struct PkgDepCache { /* private fields */ }

Implementations

impl PkgDepCache

pub fn init( &self, callback: Pin<&mut OperationProgress<'_>>, ) -> Result<(), Exception>

Clear any marked changes in the DepCache.

pub fn fix_broken(&self) -> bool

Autoinstall every broken package and run the problem resolver Returns false if the problem resolver fails.

pub unsafe fn action_group(&self) -> UniquePtr<ActionGroup>

Return a new ActionGroup of the current DepCache

ActionGroup will be released once it leaves scope or [‘ActionGroup::release’] is called

Safety

The returned UniquePtr cannot outlive the cache.

pub fn upgrade( &self, progress: Pin<&mut OperationProgress<'_>>, upgrade_mode: i32, ) -> Result<(), Exception>

Perform an Upgrade.

mark_auto:

• [0] = Remove and install new packages if necessary.
• [1] = New packages will be installed but nothing will be removed.
• [3] = Neither remove or install new packages.

pub fn is_upgradable(&self, pkg: &PkgIterator) -> bool

Check if the package is upgradable.

pub fn is_auto_installed(&self, pkg: &PkgIterator) -> bool

Is the Package auto installed? Packages marked as auto installed are usually dependencies.

pub fn is_garbage(&self, pkg: &PkgIterator) -> bool

Is the Package able to be auto removed?

pub fn marked_new_install(&self, pkg: &PkgIterator) -> bool

Is the Package marked NewInstall.

pub fn marked_install(&self, pkg: &PkgIterator) -> bool

Is the Package marked for install?

pub fn marked_upgrade(&self, pkg: &PkgIterator) -> bool

Is the Package marked for upgrade?

pub fn marked_purge(&self, pkg: &PkgIterator) -> bool

Is the Package marked to be purged?

pub fn marked_delete(&self, pkg: &PkgIterator) -> bool

Is the Package marked for removal?

pub fn marked_held(&self, pkg: &PkgIterator) -> bool

Is the Package held?

pub fn marked_keep(&self, pkg: &PkgIterator) -> bool

Is the Package marked for keep?

pub fn marked_downgrade(&self, pkg: &PkgIterator) -> bool

Is the Package marked for downgrade?

pub fn marked_reinstall(&self, pkg: &PkgIterator) -> bool

Is the Package marked for reinstall?

pub fn mark_auto(&self, pkg: &PkgIterator, mark_auto: bool)

Mark a package as automatically installed.

mark_auto:

• true = Mark the package as automatically installed.
• false = Mark the package as manually installed.

pub fn mark_keep(&self, pkg: &PkgIterator) -> bool

Mark a package for keep.

Returns:

• true if the mark was successful
• false if the mark was unsuccessful

This means that the package will not be changed from its current version. This will not stop a reinstall, but will stop removal, upgrades and downgrades

We don’t believe that there is any reason to unmark packages for keep. If someone has a reason, and would like it implemented, please put in a feature request.

pub fn mark_delete(&self, pkg: &PkgIterator, purge: bool) -> bool

Mark a package for removal.

Returns:

• true if the mark was successful
• false if the mark was unsuccessful

purge:

• true = Configuration files will be removed along with the package.
• false = Only the package will be removed.

pub fn mark_install( &self, pkg: &PkgIterator, auto_inst: bool, from_user: bool, ) -> bool

Mark a package for installation.

auto_inst:

• true = Additionally mark the dependencies for this package.
• false = Mark only this package.

from_user:

• true = The package will be marked manually installed.
• false = The package will be unmarked automatically installed.

Returns:

• true if the mark was successful
• false if the mark was unsuccessful

If a package is already installed, at the latest version, and you mark that package for install you will get true, but the package will not be altered. pkg.marked_install() will be false

pub fn set_candidate_version(&self, ver: &VerIterator)

Set a version to be the candidate of it’s package.

pub unsafe fn candidate_version( &self, pkg: &PkgIterator, ) -> UniquePtr<VerIterator>

Get a pointer to the version that is set to be installed.

Safety

If there is no candidate the inner pointer will be null. This will cause segfaults if methods are used on a Null Version.

Using crate::raw::IntoRawIter::make_safe to convert to an Option is recommended.

The returned UniquePtr cannot outlive the cache.

pub unsafe fn install_version( &self, pkg: &PkgIterator, ) -> UniquePtr<VerIterator>

Get a pointer to the version that is installed.

Safety

If there is no version the inner pointer will be null. This will cause segfaults if methods are used on a Null Version.

Using crate::raw::IntoRawIter::make_safe to convert to an Option is recommended.

The returned UniquePtr cannot outlive the cache.

pub fn dep_state(&self, dep: &DepIterator) -> u8

Returns the state of the dependency as u8

pub fn is_important_dep(&self, dep: &DepIterator) -> bool

Checks if the dependency is important.

Depends, PreDepends, Conflicts, Obsoletes, Breaks will return true.

Suggests, Recommends will return true if they are configured to be installed.

pub fn mark_reinstall(&self, pkg: &PkgIterator, reinstall: bool)

Mark a package for reinstallation.

Returns:

• true if the mark was successful
• false if the mark was unsuccessful

reinstall:

• true = The package will be marked for reinstall.
• false = The package will be unmarked for reinstall.

pub fn is_now_broken(&self, pkg: &PkgIterator) -> bool

Is the installed Package broken?

pub fn is_inst_broken(&self, pkg: &PkgIterator) -> bool

Is the Package to be installed broken?

pub fn install_count(&self) -> u32

The number of packages marked for installation.

pub fn delete_count(&self) -> u32

The number of packages marked for removal.

pub fn keep_count(&self) -> u32

The number of packages marked for keep.

pub fn broken_count(&self) -> u32

The number of packages with broken dependencies in the cache.

pub fn download_size(&self) -> u64

The size of all packages to be downloaded.

pub fn disk_size(&self) -> i64

The amount of space required for installing/removing the packages,“

i.e. the Installed-Size of all packages marked for installation“ minus the Installed-Size of all packages for removal.“

Trait Implementations

impl ExternType for PkgDepCache

type Kind = Opaque

Either cxx::kind::Opaque or cxx::kind::Trivial.

type Id

A type-level representation of the type’s C++ namespace and type name.

impl UniquePtrTarget for PkgDepCache