Collaboration diagram for In-core package database management:

Data Structures
struct	dependency

struct	deppossi

struct	arbitraryfield

struct	conffile

struct	archivedetails

struct	pkgbin
	Node describing a binary package file. More...

struct	trigpend
	Node indicates that parent's Triggers-Pending mentions name. More...

struct	trigaw
	Node indicates that aw's Triggers-Awaited mentions pend. More...

struct	pkginfo
	Node describing an architecture package instance. More...

struct	pkgset
	Node describing a package set sharing the same package name. More...

Enumerations
enum	deptype { dep_suggests , dep_recommends , dep_depends , dep_predepends , dep_breaks , dep_conflicts , dep_provides , dep_replaces , dep_enhances }

enum	pkgmultiarch { PKG_MULTIARCH_NO , PKG_MULTIARCH_SAME , PKG_MULTIARCH_ALLOWED , PKG_MULTIARCH_FOREIGN }

enum	pkgwant { PKG_WANT_UNKNOWN , PKG_WANT_INSTALL , PKG_WANT_HOLD , PKG_WANT_DEINSTALL , PKG_WANT_PURGE , PKG_WANT_SENTINEL }

enum	pkgeflag { PKG_EFLAG_OK = 0 , PKG_EFLAG_REINSTREQ = 1 }

enum	pkgstatus { PKG_STAT_NOTINSTALLED , PKG_STAT_CONFIGFILES , PKG_STAT_HALFINSTALLED , PKG_STAT_UNPACKED , PKG_STAT_HALFCONFIGURED , PKG_STAT_TRIGGERSAWAITED , PKG_STAT_TRIGGERSPENDING , PKG_STAT_INSTALLED }

enum	pkgpriority { PKG_PRIO_REQUIRED , PKG_PRIO_IMPORTANT , PKG_PRIO_STANDARD , PKG_PRIO_OPTIONAL , PKG_PRIO_EXTRA , PKG_PRIO_OTHER , PKG_PRIO_UNKNOWN , PKG_PRIO_UNSET = -1 }

enum	versiondisplayepochwhen { vdew_never , vdew_nonambig , vdew_always }

enum	pkg_name_arch_when { pnaw_never , pnaw_nonambig , pnaw_same , pnaw_foreign , pnaw_always }

Functions
const char *	dpkg_db_set_dir (const char *dir)
	Set current on-disk database directory.

const char *	dpkg_db_get_dir (void)
	Get current on-disk database directory.

char *	dpkg_db_get_path (const char *pathpart)
	Get a pathname to the current on-disk database directory.

void	modstatdb_init (void)

void	modstatdb_done (void)

bool	modstatdb_is_locked (void)

bool	modstatdb_can_lock (void)

void	modstatdb_lock (void)

void	modstatdb_unlock (void)

enum modstatdb_rw	modstatdb_open (enum modstatdb_rw reqrwflags)

enum modstatdb_rw	modstatdb_get_status (void)

void	modstatdb_note (struct pkginfo *pkg)

void	modstatdb_note_ifwrite (struct pkginfo *pkg)

void	modstatdb_checkpoint (void)

void	modstatdb_shutdown (void)

void	pkgset_blank (struct pkgset *set)

int	pkgset_installed_instances (struct pkgset *set)
	Get the number of installed package instances in a package set.

void	pkg_blank (struct pkginfo *pp)

void	pkgbin_blank (struct pkgbin *pkgbin)

bool	pkg_is_informative (struct pkginfo pkg, struct pkgbin info)
	Check if a pkg is informative.

struct pkgset *	pkg_hash_find_set (const char *name)
	Return the package set with the given name.

struct pkginfo *	pkg_hash_get_singleton (struct pkgset *set)
	Return the singleton package instance from a package set.

struct pkginfo *	pkg_hash_find_singleton (const char *name)
	Return the singleton package instance with the given name.

struct pkginfo *	pkg_hash_get_pkg (struct pkgset set, const struct dpkg_arch arch)
	Return the package instance in a set with the given architecture.

struct pkginfo *	pkg_hash_find_pkg (const char name, const struct dpkg_arch arch)
	Return the package instance with the given name and architecture.

int	pkg_hash_count_set (void)
	Return the number of package sets available in the database.

int	pkg_hash_count_pkg (void)
	Return the number of package instances available in the database.

void	pkg_hash_reset (void)

struct pkg_hash_iter *	pkg_hash_iter_new (void)
	Create a new package iterator.

struct pkgset *	pkg_hash_iter_next_set (struct pkg_hash_iter *iter)

struct pkginfo *	pkg_hash_iter_next_pkg (struct pkg_hash_iter *iter)

void	pkg_hash_iter_free (struct pkg_hash_iter *iter)

void	pkg_hash_report (FILE *)

const char *	pkg_name_is_illegal (const char *p)

const struct fieldinfo *	find_field_info (const struct fieldinfo fields, const char fieldname)

const struct arbitraryfield *	find_arbfield_info (const struct arbitraryfield arbs, const char fieldname)

int	parsedb (const char filename, enum parsedbflags, struct pkginfo *donep)
	Parse a deb822 style file.

void	copy_dependency_links (struct pkginfo pkg, struct dependency updateme, struct dependency newdepends, bool available)
	Copy dependency links structures.

void	varbufversion (struct varbuf , const struct dpkg_version , enum versiondisplayepochwhen)

int	parseversion (struct dpkg_version version, const char , struct dpkg_error *err)
	Parse a version string and check for invalid syntax.

const char *	versiondescribe (const struct dpkg_version *, enum versiondisplayepochwhen)

const char *	versiondescribe_c (const struct dpkg_version *version, enum versiondisplayepochwhen vdew)

void	varbuf_add_pkgbin_name (struct varbuf vb, const struct pkginfo pkg, const struct pkgbin *pkgbin, enum pkg_name_arch_when pnaw)
	Add a string representation of the package name to a varbuf.

const char *	pkgbin_name_archqual (const struct pkginfo pkg, const struct pkgbin pkgbin)

const char *	pkgbin_name (struct pkginfo pkg, struct pkgbin pkgbin, enum pkg_name_arch_when pnaw)
	Return a string representation of the package name.

const char *	pkg_name (struct pkginfo *pkg, enum pkg_name_arch_when pnaw)
	Return a string representation of the installed package name.

const char *	pkgbin_name_const (const struct pkginfo pkg, const struct pkgbin pkgbin, enum pkg_name_arch_when pnaw)
	Return a string representation of the package name.

const char *	pkg_name_const (const struct pkginfo *pkg, enum pkg_name_arch_when pnaw)
	Return a string representation of the installed package name.

void	pkg_source_version (struct dpkg_version version, const struct pkginfo pkg, const struct pkgbin *pkgbin)

void	varbuf_add_source_version (struct varbuf vb, const struct pkginfo pkg, const struct pkgbin *pkgbin)
	Add a string representation of the source package version to a varbuf.

const char *	pkg_want_name (const struct pkginfo *pkg)
	Return a string representation of the package want status name.

const char *	pkg_status_name (const struct pkginfo *pkg)
	Return a string representation of the package current status name.

const char *	pkg_eflag_name (const struct pkginfo *pkg)
	Return a string representation of the package eflag status name.

const char *	pkg_priority_name (const struct pkginfo *pkg)
	Return a string representation of the package priority name.

void	write_stanza (FILE , const char , const struct pkginfo , const struct pkgbin )

void	writedb_stanzas (FILE fp, const char filename, enum writedb_flags flags)

void	writedb (const char *filename, enum writedb_flags flags)

void	varbuf_stanza (struct varbuf , const struct pkginfo , const struct pkgbin *)

void	varbufdependency (struct varbuf vb, struct dependency dep)

bool	versionsatisfied (struct pkgbin it, struct deppossi against)

bool	deparchsatisfied (struct pkgbin it, const struct dpkg_arch arch, struct deppossi *against)
	Check if the architecture qualifier in the dependency is satisfied.

bool	archsatisfied (struct pkgbin it, struct deppossi against)

bool	pkg_virtual_deppossi_satisfied (struct deppossi dependee, struct deppossi provider)
	Check if the dependency is satisfied by a virtual package.

void *	nfmalloc (size_t)

char *	nfstrsave (const char *)

char *	nfstrnsave (const char *, size_t)

void	nffreeall (void)

Variables
enum DPKG_ATTR_ENUM_FLAGS	conffile_flags

enum DPKG_ATTR_ENUM_FLAGS	modstatdb_rw

enum DPKG_ATTR_ENUM_FLAGS	parsedbflags

const struct namevalue	booleaninfos []

const struct namevalue	multiarchinfos []

const struct namevalue	priorityinfos []

const struct namevalue	statusinfos []

const struct namevalue	eflaginfos []

const struct namevalue	wantinfos []

enum DPKG_ATTR_ENUM_FLAGS	writedb_flags

Detailed Description

Enumeration Type Documentation

◆ deptype

enum deptype

Enumerator
dep_suggests
dep_recommends
dep_depends
dep_predepends
dep_breaks
dep_conflicts
dep_provides
dep_replaces
dep_enhances

◆ pkg_name_arch_when

enum pkg_name_arch_when

Enumerator
pnaw_never	Never display arch.
pnaw_nonambig	Display arch only when it's non-ambiguous.
pnaw_same	Display arch only when it's a Multi-Arch same package.
pnaw_foreign	Display arch only when it's a foreign one.
pnaw_always	Always display arch.

◆ pkgeflag

enum pkgeflag

Enumerator
PKG_EFLAG_OK
PKG_EFLAG_REINSTREQ

◆ pkgmultiarch

enum pkgmultiarch

Enumerator
PKG_MULTIARCH_NO
PKG_MULTIARCH_SAME
PKG_MULTIARCH_ALLOWED
PKG_MULTIARCH_FOREIGN

◆ pkgpriority

enum pkgpriority

Enumerator
PKG_PRIO_REQUIRED
PKG_PRIO_IMPORTANT
PKG_PRIO_STANDARD
PKG_PRIO_OPTIONAL
PKG_PRIO_EXTRA
PKG_PRIO_OTHER
PKG_PRIO_UNKNOWN
PKG_PRIO_UNSET

◆ pkgstatus

enum pkgstatus

Enumerator
PKG_STAT_NOTINSTALLED
PKG_STAT_CONFIGFILES
PKG_STAT_HALFINSTALLED
PKG_STAT_UNPACKED
PKG_STAT_HALFCONFIGURED
PKG_STAT_TRIGGERSAWAITED
PKG_STAT_TRIGGERSPENDING
PKG_STAT_INSTALLED

◆ pkgwant

enum pkgwant

Enumerator
PKG_WANT_UNKNOWN
PKG_WANT_INSTALL
PKG_WANT_HOLD
PKG_WANT_DEINSTALL
PKG_WANT_PURGE
PKG_WANT_SENTINEL	Not allowed except as special sentinel value in some places.

◆ versiondisplayepochwhen

enum versiondisplayepochwhen

Enumerator
vdew_never
vdew_nonambig
vdew_always

Function Documentation

◆ archsatisfied()

bool archsatisfied	(	struct pkgbin *	it,
		struct deppossi *	against
	)

References deparchsatisfied(), and dpkg_arch::type.

Referenced by deppossi_pkg_iter_next().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ copy_dependency_links()

void copy_dependency_links	(	struct pkginfo *	pkg,
		struct dependency **	updateme,
		struct dependency *	newdepends,
		bool	available
	)

Copy dependency links structures.

This routine is used to update the ‘reverse’ dependency pointers when new ‘forwards’ information has been constructed. It first removes all the links based on the old information. The old information starts in *updateme; after much brou-ha-ha the reverse structures are created and *updateme is set to the value from newdepends.

Parameters

pkg	The package we're doing this for. This is used to construct correct uplinks.
updateme	The forwards dependency pointer that we are to update. This starts out containing the old forwards info, which we use to unthread the old reverse links. After we're done it is updated.
newdepends	The value that we ultimately want to have in updateme.
available	The pkgbin to modify, available or installed.

It is likely that the backward pointer for the package in question (‘depended’) will be updated by this routine, but this will happen by the routine traversing the dependency data structures. It doesn't need to be told where to update that; just mentioned here as something that one should be cautious about.

References pkgset::available, pkgset::depended, deppossi::ed, pkgset::installed, dependency::list, dependency::next, deppossi::next, deppossi::rev_next, deppossi::rev_prev, dependency::type, and dependency::up.

◆ deparchsatisfied()

bool deparchsatisfied	(	struct pkgbin *	it,
		const struct dpkg_arch *	it_arch,
		struct deppossi *	against
	)

Check if the architecture qualifier in the dependency is satisfied.

The rules are supposed to be:

unqualified Depends/Pre-Depends/Recommends/Suggests are only satisfied by a package of a different architecture if the target package is Multi-Arch: foreign.
Depends/Pre-Depends/Recommends/Suggests on pkg:any are satisfied by a package of a different architecture if the target package is Multi-Arch: allowed.
all other Depends/Pre-Depends/Recommends/Suggests are only satisfied by packages of the same architecture.
Architecture: all packages are treated the same as packages of the native architecture.
Conflicts/Replaces/Breaks are assumed to apply to packages of any arch.

References dep_breaks, dep_conflicts, dep_replaces, DPKG_ARCH_ALL, dpkg_arch_get(), DPKG_ARCH_NATIVE, DPKG_ARCH_NONE, DPKG_ARCH_WILDCARD, PKG_MULTIARCH_ALLOWED, PKG_MULTIARCH_FOREIGN, and dpkg_arch::type.

Referenced by archsatisfied(), and dependencies_ok().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ dpkg_db_get_dir()

const char * dpkg_db_get_dir ( void )

Get current on-disk database directory.

This function will take care of initializing the directory if it has not been initialized before.

Returns: The current database directory.

Referenced by dpkg_arch_save_list(), dpkg_db_get_path(), main(), modstatdb_can_lock(), modstatdb_is_locked(), modstatdb_lock(), modstatdb_open(), set_instdir(), and updateavailable().

Here is the caller graph for this function:

◆ dpkg_db_get_path()

char * dpkg_db_get_path ( const char * pathpart )

Get a pathname to the current on-disk database directory.

This function returns an allocated string, which should be freed with free(2).

Parameters

pathpart The pathpart to append to the new pathname.

Returns: The newly allocated pathname.

References dpkg_db_get_dir(), and str_fmt().

Referenced by dpkg_arch_load_list(), dpkg_arch_save_list(), dpkg_db_reopen(), main(), modstatdb_init(), pkg_infodb_get_dir(), trig_incorporate(), trigdef_update_start(), and updateavailable().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ dpkg_db_set_dir()

const char * dpkg_db_set_dir ( const char * dir )

Set current on-disk database directory.

This function can be used to set the directory to a new value, or to reset it to a default value if dir is NULL.

Parameters

dir	The new database directory, or NULL to set to default.

Returns: The new database directory.

References m_strdup().

Referenced by set_admindir(), and set_root().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ find_arbfield_info()

const struct arbitraryfield * find_arbfield_info	(	const struct arbitraryfield *	arbs,
		const char *	fieldname
	)

References arbitraryfield::name, and arbitraryfield::next.

Referenced by pkg_format_print().

Here is the caller graph for this function:

◆ find_field_info()

const struct fieldinfo * find_field_info	(	const struct fieldinfo *	fields,
		const char *	fieldname
	)

References fieldinfo::name.

Referenced by pkg_format_print().

Here is the caller graph for this function:

◆ modstatdb_can_lock()

bool modstatdb_can_lock ( void )

References _, dpkg_db_get_dir(), and ohshite().

Referenced by modstatdb_lock().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ modstatdb_checkpoint()

void modstatdb_checkpoint ( void )

References _, varbuf::buf, dir_sync_path(), IMPORTANTFMT, IMPORTANTMAXLEN, internerr, msdbrw_write, ohshite(), varbuf_printf(), varbuf_rollback(), varbuf_rollback_len(), varbuf_rollback_start(), wdb_must_sync, and writedb().

Referenced by modstatdb_shutdown().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ modstatdb_done()

void modstatdb_done ( void )

References varbuf_destroy().

Referenced by modstatdb_shutdown(), and updateavailable().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ modstatdb_get_status()

enum modstatdb_rw modstatdb_get_status ( void )

Referenced by pkg_infodb_upgrade(), and post_postinst_tasks().

Here is the caller graph for this function:

◆ modstatdb_init()

void modstatdb_init ( void )

References dpkg_db_get_path(), IMPORTANTMAXLEN, varbuf_add_dir(), varbuf_init(), and varbuf_snapshot().

Referenced by modstatdb_open(), and updateavailable().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ modstatdb_is_locked()

bool modstatdb_is_locked ( void )

References _, dpkg_db_get_dir(), file_is_locked(), and ohshite().

Referenced by audit().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ modstatdb_lock()

void modstatdb_lock ( void )

References _, dpkg_db_get_dir(), file_lock(), FILE_LOCK_NOWAIT, modstatdb_can_lock(), and ohshit().

Referenced by modstatdb_open(), and updateavailable().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ modstatdb_note()

void modstatdb_note ( struct pkginfo * pkg )

References trigaw::aw, pkginfo::head, pkginfo::installed, log_message(), msdbrw_write, trigaw::next, onerr_abort, pkginfo::othertrigaw_head, pkg_name(), PKG_STAT_CONFIGFILES, PKG_STAT_TRIGGERSAWAITED, PKG_STAT_TRIGGERSPENDING, pkg_status_name(), pnaw_always, pnaw_nonambig, trigaw::sameaw, pkginfo::status, pkginfo::status_dirty, statusfd_send(), pkginfo::tail, trig_clear_awaiters(), pkginfo::trigaw, pkginfo::trigpend_head, vdew_nonambig, pkgbin::version, and versiondescribe_c().

Referenced by cu_preinstnew(), cu_preinstupgrade(), cu_preinstverynew(), deferred_configure(), deferred_remove(), modstatdb_note_ifwrite(), post_postinst_tasks(), process_archive(), removal_bulk(), trig_clear_awaiters(), and trigproc().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ modstatdb_note_ifwrite()

void modstatdb_note_ifwrite ( struct pkginfo * pkg )

References modstatdb_note(), and msdbrw_write.

Here is the call graph for this function:

◆ modstatdb_open()

enum modstatdb_rw modstatdb_open ( enum modstatdb_rw reqrwflags )

References _, dir_make_path(), dpkg_arch_load_list(), dpkg_db_get_dir(), internerr, modstatdb_init(), modstatdb_lock(), msdbrw_available_mask, msdbrw_available_readonly, msdbrw_needsuperuser, msdbrw_needsuperuserlockonly, msdbrw_readonly, msdbrw_write, msdbrw_writeifposs, ohshit(), ohshite(), parsedb(), pdb_parse_available, trig_fixup_awaiters(), trig_incorporate(), and varbuf_init().

Referenced by archivefiles(), audit(), clearselections(), getselections(), packages(), predeppackage(), setselections(), unpackchk(), and verify().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ modstatdb_shutdown()

void modstatdb_shutdown ( void )

References modstatdb_checkpoint(), modstatdb_done(), modstatdb_unlock(), msdbrw_available_write, msdbrw_needsuperuserlockonly, msdbrw_write, pkg_hash_reset(), varbuf_destroy(), wdb_dump_available, and writedb().

Referenced by archivefiles(), clearselections(), getselections(), packages(), setselections(), and verify().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ modstatdb_unlock()

void modstatdb_unlock ( void )

References ehflag_normaltidy, and pop_cleanup().

Referenced by modstatdb_shutdown(), and updateavailable().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ nffreeall()

void nffreeall ( void )

Referenced by pkg_hash_reset().

Here is the caller graph for this function:

◆ nfmalloc()

void * nfmalloc ( size_t size )

References OBSTACK_INIT.

Referenced by do_auto(), do_join(), ensure_diversions(), ensure_package_clientdata(), ensure_statoverrides(), f_archives(), f_conffiles(), f_dependency(), f_obs_revision(), fsys_hash_find_node(), pkg_files_add_file(), pkg_hash_find_set(), pkg_hash_get_pkg(), pkgbin_name_archqual(), process_archive(), statusfd_add(), trig_note_aw(), trig_note_pend_core(), and unpackchk().

Here is the caller graph for this function:

◆ nfstrnsave()

char * nfstrnsave	(	const char *	string,
		size_t	size
	)

References OBSTACK_INIT.

Referenced by do_split(), and parseversion().

Here is the caller graph for this function:

◆ nfstrsave()

char * nfstrsave ( const char * string )

References OBSTACK_INIT.

Referenced by ensure_statoverrides(), f_archives(), f_charfield(), f_obs_revision(), f_priority(), f_section(), f_trigpend(), pkg_hash_find_set(), and read_info().

Here is the caller graph for this function:

◆ parsedb()

int parsedb	(	const char *	filename,
		enum parsedbflags	flags,
		struct pkginfo **	pkgp
	)

Parse a deb822 style file.

donep may be NULL. If donep is not NULL only one package's information is expected.

References parsedb_state::filename, parsedb_state::flags, parsedb_close(), parsedb_load(), parsedb_open(), parsedb_parse(), and parsedb_state::type.

Referenced by do_showinfo(), modstatdb_open(), process_archive(), and updateavailable().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ parseversion()

int parseversion	(	struct dpkg_version *	rversion,
		const char *	string,
		struct dpkg_error *	err
	)

Parse a version string and check for invalid syntax.

Distinguish between lax (warnings) and strict (error) parsing.

Parameters

rversion	The parsed version.
string	The version string to parse.
err	The warning or error message if any.

Return values

0	On success.
-1	On failure, and err is set accordingly.

References _, dpkg_put_error(), dpkg_put_warn(), dpkg_version::epoch, nfstrnsave(), dpkg_version::revision, and dpkg_version::version.

Referenced by cmpversions(), parse_db_version(), pkg_source_version(), and validate_version().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ pkg_blank()

void pkg_blank ( struct pkginfo * pp )

References pkgbin::arch, pkginfo::archives, pkginfo::available, pkginfo::clientdata, pkginfo::configversion, dpkg_arch_get(), DPKG_ARCH_NONE, dpkg_version_blank(), pkginfo::eflag, pkginfo::files, pkginfo::files_list_phys_offs, pkginfo::files_list_valid, pkginfo::head, pkginfo::installed, pkgbin::multiarch, pkginfo::otherpriority, pkginfo::othertrigaw_head, PKG_EFLAG_OK, PKG_MULTIARCH_NO, PKG_PRIO_UNKNOWN, PKG_STAT_NOTINSTALLED, PKG_WANT_UNKNOWN, pkgbin_blank(), pkginfo::priority, pkginfo::section, pkginfo::status, pkginfo::status_dirty, pkginfo::tail, pkginfo::trigaw, pkginfo::trigpend_head, and pkginfo::want.

Referenced by pkg_hash_get_pkg(), pkgset_blank(), and process_archive().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ pkg_eflag_name()

const char * pkg_eflag_name ( const struct pkginfo * pkg )

Return a string representation of the package eflag status name.

Parameters

pkg	The package to consider.

Returns: The string representation.

References pkginfo::eflag, eflaginfos, and namevalue::name.

Referenced by w_status().

Here is the caller graph for this function:

◆ pkg_hash_count_pkg()

int pkg_hash_count_pkg ( void )

Return the number of package instances available in the database.

Returns: The number of package instances.

Referenced by ensure_allinstfiles_available(), and pkg_array_init_from_hash().

Here is the caller graph for this function:

◆ pkg_hash_count_set()

int pkg_hash_count_set ( void )

Return the number of package sets available in the database.

Returns: The number of package sets.

◆ pkg_hash_find_pkg()

struct pkginfo * pkg_hash_find_pkg	(	const char *	name,
		const struct dpkg_arch *	arch
	)

Return the package instance with the given name and architecture.

Parameters

name	The package name.
arch	The requested architecture.

Returns: The package instance.

References pkg_hash_find_set(), pkg_hash_get_pkg(), and pkginfo::set.

Here is the call graph for this function:

◆ pkg_hash_find_set()

struct pkgset * pkg_hash_find_set ( const char * inname )

Return the package set with the given name.

If the package already exists in the internal database, then it returns the existing structure. Otherwise it allocates a new one and will return it. The actual name associated to the package set is a lowercase version of the name given in parameter.

A package set (struct pkgset) can be composed of multiple package instances (struct pkginfo) where each instance is distinguished by its architecture (as recorded in pkg.installed.arch and pkg.available.arch).

Parameters

inname Name of the package set.

Returns: The package set.

References BINS, m_strdup(), pkgset::name, pkgset::next, nfmalloc(), nfstrsave(), pkgset_blank(), and str_fnv_hash().

Referenced by ensure_diversions(), f_dependency(), f_name(), pkg_hash_find_pkg(), pkg_hash_find_singleton(), pkg_spec_is_illegal(), and pkg_spec_iter_init().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ pkg_hash_find_singleton()

struct pkginfo * pkg_hash_find_singleton ( const char * name )

Return the singleton package instance with the given name.

Parameters

name	The package name.

Returns: The package instance.

References _, pkgset::name, ohshit(), pkg_hash_find_set(), pkg_hash_get_singleton(), and pkginfo::set.

Here is the call graph for this function:

◆ pkg_hash_get_pkg()

struct pkginfo * pkg_hash_get_pkg	(	struct pkgset *	set,
		const struct dpkg_arch *	arch
	)

Return the package instance in a set with the given architecture.

It traverse the various instances to find out whether there's one matching the given architecture. If found, it returns it. Otherwise it allocates a new instance and registers it in the package set before returning it.

Parameters

set	The package set to use.
arch	The requested architecture.

Returns: The package instance.

References pkgbin::arch, pkginfo::arch_next, pkginfo::available, DPKG_ARCH_NONE, pkginfo::installed, internerr, nfmalloc(), pkgset::pkg, pkg_blank(), pkginfo::set, and dpkg_arch::type.

Referenced by pkg_hash_find_pkg().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ pkg_hash_get_singleton()

struct pkginfo * pkg_hash_get_singleton ( struct pkgset * set )

Return the singleton package instance from a package set.

This means, if none are installed either an instance with native or all arch or the first if none found, the single installed instance, or NULL if more than one instance is installed.

Parameters

set	The package set to use.

Returns: The singleton package instance.

References pkgbin::arch, pkginfo::arch_next, pkginfo::available, DPKG_ARCH_ALL, DPKG_ARCH_NATIVE, internerr, pkgset::name, pkgset::pkg, PKG_STAT_NOTINSTALLED, pkgset_installed_instances(), pkginfo::set, pkginfo::status, and dpkg_arch::type.

Referenced by pkg_hash_find_singleton().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ pkg_hash_iter_free()

void pkg_hash_iter_free ( struct pkg_hash_iter * iter )

Referenced by clear_istobes(), clearselections(), findbreakcycle(), pkg_array_init_from_hash(), pkg_spec_iter_destroy(), predeppackage(), trigproc_populate_deferred(), unpackchk(), and verify().

Here is the caller graph for this function:

◆ pkg_hash_iter_new()

struct pkg_hash_iter * pkg_hash_iter_new ( void )

Create a new package iterator.

It can iterate either over package sets or over package instances.

Returns: The iterator.

References m_malloc(), pkg_hash_iter::nbinn, and pkg_hash_iter::pkg.

Referenced by clear_istobes(), clearselections(), findbreakcycle(), pkg_array_init_from_hash(), pkg_spec_iter_init(), predeppackage(), trigproc_populate_deferred(), unpackchk(), and verify().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ pkg_hash_iter_next_pkg()

struct pkginfo * pkg_hash_iter_next_pkg ( struct pkg_hash_iter * iter )

References pkginfo::arch_next, BINS, pkg_hash_iter::nbinn, pkgset::next, pkgset::pkg, pkg_hash_iter::pkg, and pkginfo::set.

Referenced by clear_istobes(), clearselections(), findbreakcycle(), pkg_array_init_from_hash(), predeppackage(), trigproc_populate_deferred(), unpackchk(), and verify().

Here is the caller graph for this function:

◆ pkg_hash_iter_next_set()

struct pkgset * pkg_hash_iter_next_set ( struct pkg_hash_iter * iter )

References BINS, pkg_hash_iter::nbinn, pkgset::next, pkgset::pkg, pkg_hash_iter::pkg, and pkginfo::set.

◆ pkg_hash_report()

void pkg_hash_report ( FILE * file )

References BINS, m_malloc(), m_output(), and pkgset::pkg.

Here is the call graph for this function:

◆ pkg_hash_reset()

void pkg_hash_reset ( void )

References dpkg_arch_reset_list(), and nffreeall().

Referenced by modstatdb_shutdown().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ pkg_is_informative()

bool pkg_is_informative	(	struct pkginfo *	pkg,
		struct pkgbin *	pkgbin
	)

Check if a pkg is informative.

Used by dselect and dpkg query options as an aid to decide whether to display things, and by dump to decide whether to write them out.

References pkgbin::arbs, pkgbin::bugs, pkgbin::conffiles, pkginfo::configversion, pkgbin::depends, pkgbin::description, dpkg_version_is_informative(), pkginfo::eflag, pkginfo::installed, pkgbin::installedsize, pkgbin::maintainer, pkgbin::origin, PKG_EFLAG_OK, PKG_STAT_NOTINSTALLED, PKG_WANT_UNKNOWN, pkgbin::source, pkginfo::status, pkgbin::version, and pkginfo::want.

Referenced by setselections(), and writedb_stanzas().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ pkg_name()

const char * pkg_name	(	struct pkginfo *	pkg,
		enum pkg_name_arch_when	pnaw
	)

Return a string representation of the installed package name.

This is equivalent to pkgbin_name() but just for its installed pkgbin.

Parameters

pkg	The package to consider.
pnaw	When to display the architecture qualifier.

Returns: The string representation.

References pkginfo::installed, and pkgbin_name().

Referenced by check_breaks(), check_conflict(), conffderef(), conffile_mark_obsolete(), cu_prermdeconfigure(), deferred_configure(), deferred_remove(), dependencies_ok(), depisok(), describedepcon(), dir_has_conffiles(), dir_is_used_by_others(), dir_is_used_by_pkg(), ensure_packagefiles_available(), filesavespackage(), maintscript_fallback(), maintscript_new(), md5hash(), modstatdb_note(), parse_filehash(), process_archive(), process_queue(), removal_bulk(), skip_due_to_hold(), tarobject(), trig_activate_packageprocessing(), trig_clear_awaiters(), trigproc(), trigproc_run_deferred(), unpackchk(), verify(), and wanttoinstall().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ pkg_name_const()

const char * pkg_name_const	(	const struct pkginfo *	pkg,
		enum pkg_name_arch_when	pnaw
	)

Return a string representation of the installed package name.

This is equivalent to pkgbin_name_const() but just for its installed pkgbin.

Parameters

pkg	The package to consider.
pnaw	When to display the architecture qualifier.

Returns: The string representation.

References pkginfo::installed, and pkgbin_name_const().

Here is the call graph for this function:

◆ pkg_name_is_illegal()

const char * pkg_name_is_illegal ( const char * p )

References _.

Referenced by f_dependency(), f_name(), pkg_spec_is_illegal(), and validate_pkgname().

Here is the caller graph for this function:

◆ pkg_priority_name()

const char * pkg_priority_name ( const struct pkginfo * pkg )

Return a string representation of the package priority name.

Parameters

pkg	The package to consider.

Returns: The string representation.

References namevalue::name, pkginfo::otherpriority, PKG_PRIO_OTHER, pkginfo::priority, and priorityinfos.

Referenced by w_priority().

Here is the caller graph for this function:

◆ pkg_source_version()

void pkg_source_version	(	struct dpkg_version *	version,
		const struct pkginfo *	pkg,
		const struct pkgbin *	pkgbin
	)

References _, ohshit(), parseversion(), pkgbin::source, dpkg_error::str, varbuf_add_buf(), varbuf_destroy(), VARBUF_INIT, varbuf_str(), pkgbin::version, and dpkg_version::version.

Referenced by varbuf_add_source_version().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ pkg_status_name()

const char * pkg_status_name ( const struct pkginfo * pkg )

Return a string representation of the package current status name.

Parameters

pkg	The package to consider.

Returns: The string representation.

References namevalue::name, pkginfo::status, and statusinfos.

Referenced by deferred_configure(), modstatdb_note(), process_archive(), process_queue(), trigproc(), w_status(), w_trigaw(), and w_trigpend().

Here is the caller graph for this function:

◆ pkg_virtual_deppossi_satisfied()

bool pkg_virtual_deppossi_satisfied	(	struct deppossi *	dependee,
		struct deppossi *	provider
	)

Check if the dependency is satisfied by a virtual package.

For versioned depends, we only check providers with DPKG_RELATION_EQ. It does not make sense to check ones without a version since we have nothing to verify against. Also, it is way too complex to allow anything but an equal in a provided version. A few examples below to deter you from trying:

pkg1 depends on virt (>= 0.6), pkg2 provides virt (<= 1.0). Should pass (easy enough).
pkg1 depends on virt (>= 0.7) and (<= 1.1), pkg2 provides virt (>= 1.2). Should fail (little harder).
pkg1 depends on virt (>= 0.4), pkg2 provides virt (<= 1.0) and (>= 0.5), IOW, inclusive of only those versions. This would require backchecking the other provided versions in the possi, which would make things sickly complex and overly time consuming. Should fail (very hard to implement).

This could be handled by switching to a SAT solver, but that would imply lots of work for very little gain. Packages can easily get around most of these by providing multiple DPKG_RELATION_EQ versions.

References DPKG_RELATION_EQ, DPKG_RELATION_NONE, dpkg_version_relate(), and dpkg_arch::type.

Referenced by depisok(), and predeppackage().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ pkg_want_name()

const char * pkg_want_name ( const struct pkginfo * pkg )

Return a string representation of the package want status name.

Parameters

pkg	The package to consider.

Returns: The string representation.

References namevalue::name, pkginfo::want, and wantinfos.

Referenced by w_status().

Here is the caller graph for this function:

◆ pkgbin_blank()

void pkgbin_blank ( struct pkgbin * pkgbin )

References pkgbin::arbs, pkgbin::bugs, pkgbin::conffiles, pkgbin::depends, pkgbin::description, dpkg_version_blank(), pkgbin::essential, pkgbin::installedsize, pkgbin::is_protected, pkgbin::maintainer, pkgbin::origin, pkgbin::pkgname_archqual, pkgbin::source, and pkgbin::version.

Referenced by cu_preinstverynew(), pkg_blank(), and removal_bulk().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ pkgbin_name()

const char * pkgbin_name	(	struct pkginfo *	pkg,
		struct pkgbin *	pkgbin,
		enum pkg_name_arch_when	pnaw
	)

Return a string representation of the package name.

The returned string must not be freed, and it's permanently allocated so can be used as long as the non-freeing memory pool has not been freed.

The pnaw parameter should be one of pnaw_never (never print arch), pnaw_foreign (print arch for foreign packages only), pnaw_nonambig (print arch for non ambiguous cases) or pnaw_always (always print arch),

Parameters

pkg	The package to consider.
pkgbin	The binary package instance to consider.
pnaw	When to display the architecture qualifier.

Returns: The string representation.

References pkgset::name, pkgbin_name_archqual(), pkgbin::pkgname_archqual, and pkginfo::set.

Referenced by check_breaks(), check_conflict(), cu_prermdeconfigure(), cu_prerminfavour(), depisok(), log_action(), namenodetouse(), pkg_infodb_foreach(), pkg_name(), predeppackage(), process_archive(), wanttoinstall(), and writedb_stanzas().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ pkgbin_name_archqual()

const char * pkgbin_name_archqual	(	const struct pkginfo *	pkg,
		const struct pkgbin *	pkgbin
	)

References pkgbin::arch, DPKG_ARCH_EMPTY, DPKG_ARCH_NONE, dpkg_arch::name, pkgset::name, nfmalloc(), pkginfo::set, str_concat(), and dpkg_arch::type.

Referenced by pkgbin_name(), and pkgbin_name_const().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ pkgbin_name_const()

const char * pkgbin_name_const	(	const struct pkginfo *	pkg,
		const struct pkgbin *	pkgbin,
		enum pkg_name_arch_when	pnaw
	)

Return a string representation of the package name.

The returned string must not be freed, and it's permanently allocated so can be used as long as the non-freeing memory pool has not been freed.

Note, that this const variant will "leak" a new non-freeing string on each call if the internal cache has not been previously initialized, so it is advised to use it only in error reporting code paths.

The pnaw parameter should be one of pnaw_never (never print arch), pnaw_foreign (print arch for foreign packages only), pnaw_nonambig (print arch for non ambiguous cases) or pnaw_always (always print arch),

Parameters

pkg	The package to consider.
pkgbin	The binary package instance to consider.
pnaw	When to display the architecture qualifier.

Returns: The string representation.

References pkgset::name, pkgbin_name_archqual(), pkgbin::pkgname_archqual, and pkginfo::set.

Referenced by pkg_name_const(), w_dependency(), w_priority(), w_status(), w_trigaw(), w_trigpend(), and write_stanza().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ pkgset_blank()

void pkgset_blank ( struct pkgset * set )

References pkginfo::arch_next, pkgset::available, pkgset::depended, pkgset::installed, pkgset::installed_instances, pkgset::name, pkgset::pkg, pkg_blank(), and pkginfo::set.

Referenced by parsedb_parse(), and pkg_hash_find_set().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ pkgset_installed_instances()

int pkgset_installed_instances ( struct pkgset * set )

Get the number of installed package instances in a package set.

Parameters

set	The package set to use.

Returns: The count of installed packages.

References pkgset::installed_instances.

Referenced by pkg_hash_get_singleton(), and pkg_spec_is_illegal().

Here is the caller graph for this function:

◆ varbuf_add_pkgbin_name()

void varbuf_add_pkgbin_name	(	struct varbuf *	vb,
		const struct pkginfo *	pkg,
		const struct pkgbin *	pkgbin,
		enum pkg_name_arch_when	pnaw
	)

Add a string representation of the package name to a varbuf.

Works exactly like pkgbin_name() but acts on the varbuf instead of returning a string. It NUL terminates the varbuf.

Parameters

vb	The varbuf struct to modify.
pkg	The package to consider.
pkgbin	The binary package instance to consider.
pnaw	When to display the architecture qualifier.

References pkgbin::arch, pkgset::name, pkginfo::set, varbuf_add_archqual(), and varbuf_add_str.

Referenced by dependencies_ok(), and w_trigaw().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ varbuf_add_source_version()

void varbuf_add_source_version	(	struct varbuf *	vb,
		const struct pkginfo *	pkg,
		const struct pkgbin *	pkgbin
	)

Add a string representation of the source package version to a varbuf.

It parses the Source field (if present), and extracts the optional version enclosed in parenthesis. Otherwise it falls back to use the binary package version. It NUL terminates the varbuf.

Parameters