Manpages - libalpm_packages.3

typedef struct __alpm_pkg_t alpm_pkg_t
A package.

enum alpm_pkgreason_t { ALPM_PKG_REASON_EXPLICIT = 0, ALPM_PKG_REASON_DEPEND = 1 }
Package install reasons.

enum alpm_pkgfrom_t { ALPM_PKG_FROM_FILE = 1, ALPM_PKG_FROM_LOCALDB, ALPM_PKG_FROM_SYNCDB }
Location a package object was loaded from.

enum alpm_pkgvalidation_t { ALPM_PKG_VALIDATION_UNKNOWN = 0, ALPM_PKG_VALIDATION_NONE = (1 << 0), ALPM_PKG_VALIDATION_MD5SUM = (1 << 1), ALPM_PKG_VALIDATION_SHA256SUM = (1 << 2), ALPM_PKG_VALIDATION_SIGNATURE = (1 << 3) }
Method used to validate a package.

int alpm_pkg_load (alpm_handle_t handle, const char *filename, int full, int level, *alpm_pkg_t **pkg)
Create a package from a file.

int alpm_fetch_pkgurl (alpm_handle_t handle, const *alpm_list_t urls, *alpm_list_t **fetched)
Fetch a list of remote packages.

alpm_pkg_t * alpm_pkg_find (alpm_list_t *haystack, const char *needle)
Find a package in a list by name.

int alpm_pkg_free (alpm_pkg_t *pkg)
Free a package.

int alpm_pkg_checkmd5sum (alpm_pkg_t *pkg)
Check the integrity (with md5) of a package from the sync cache.

int alpm_pkg_vercmp (const char *a, const char *b)
Compare two version strings and determine which one is ’newer’.

alpm_list_t * alpm_pkg_compute_requiredby (alpm_pkg_t *pkg)
Computes the list of packages requiring a given package.

alpm_list_t * alpm_pkg_compute_optionalfor (alpm_pkg_t *pkg)
Computes the list of packages optionally requiring a given package.

int alpm_pkg_should_ignore (alpm_handle_t handle, *alpm_pkg_t *pkg)
Test if a package should be ignored.

Any pointer returned by these functions points to internal structures allocated by libalpm.

They should not be freed nor modified in any way.

For loaded packages, they will be freed when alpm_pkg_free is called. For database packages, they will be freed when the database is unregistered.

const char * alpm_pkg_get_filename (alpm_pkg_t *pkg)
Gets the name of the file from which the package was loaded.

const char * alpm_pkg_get_base (alpm_pkg_t *pkg)
Returns the package base name.

const char * alpm_pkg_get_name (alpm_pkg_t *pkg)
Returns the package name.

const char * alpm_pkg_get_version (alpm_pkg_t *pkg)
Returns the package version as a string.

alpm_pkgfrom_t alpm_pkg_get_origin (alpm_pkg_t *pkg)
Returns the origin of the package.

const char * alpm_pkg_get_desc (alpm_pkg_t *pkg)
Returns the package description.

const char * alpm_pkg_get_url (alpm_pkg_t *pkg)
Returns the package URL.

alpm_time_t alpm_pkg_get_builddate (alpm_pkg_t *pkg)
Returns the build timestamp of the package.

alpm_time_t alpm_pkg_get_installdate (alpm_pkg_t *pkg)
Returns the install timestamp of the package.

const char * alpm_pkg_get_packager (alpm_pkg_t *pkg)
Returns the packager’s name.

const char * alpm_pkg_get_md5sum (alpm_pkg_t *pkg)
Returns the package’s MD5 checksum as a string.

const char * alpm_pkg_get_sha256sum (alpm_pkg_t *pkg)
Returns the package’s SHA256 checksum as a string.

const char * alpm_pkg_get_arch (alpm_pkg_t *pkg)
Returns the architecture for which the package was built.

off_t alpm_pkg_get_size (alpm_pkg_t *pkg)
Returns the size of the package.

off_t alpm_pkg_get_isize (alpm_pkg_t *pkg)
Returns the installed size of the package.

alpm_pkgreason_t alpm_pkg_get_reason (alpm_pkg_t *pkg)
Returns the package installation reason.

alpm_list_t * alpm_pkg_get_licenses (alpm_pkg_t *pkg)
Returns the list of package licenses.

alpm_list_t * alpm_pkg_get_groups (alpm_pkg_t *pkg)
Returns the list of package groups.

alpm_list_t * alpm_pkg_get_depends (alpm_pkg_t pkg)
Returns the list of package dependencies as *alpm_depend_t.

alpm_list_t * alpm_pkg_get_optdepends (alpm_pkg_t *pkg)
Returns the list of package optional dependencies.

alpm_list_t * alpm_pkg_get_checkdepends (alpm_pkg_t *pkg)
Returns a list of package check dependencies.

alpm_list_t * alpm_pkg_get_makedepends (alpm_pkg_t *pkg)
Returns a list of package make dependencies.

alpm_list_t * alpm_pkg_get_conflicts (alpm_pkg_t *pkg)
Returns the list of packages conflicting with pkg.

alpm_list_t * alpm_pkg_get_provides (alpm_pkg_t *pkg)
Returns the list of packages provided by pkg.

alpm_list_t * alpm_pkg_get_replaces (alpm_pkg_t *pkg)
Returns the list of packages to be replaced by pkg.

alpm_filelist_t * alpm_pkg_get_files (alpm_pkg_t *pkg)
Returns the list of files installed by pkg.

alpm_list_t * alpm_pkg_get_backup (alpm_pkg_t *pkg)
Returns the list of files backed up when installing pkg.

alpm_db_t * alpm_pkg_get_db (alpm_pkg_t *pkg)
Returns the database containing pkg.

const char * alpm_pkg_get_base64_sig (alpm_pkg_t *pkg)
Returns the base64 encoded package signature.

int alpm_pkg_get_sig (alpm_pkg_t *pkg, unsigned char **sig, size_t *sig_len)
Extracts package signature either from embedded package signature or if it is absent then reads data from detached signature file.

int alpm_pkg_get_validation (alpm_pkg_t *pkg)
Returns the method used to validate a package during install.

int alpm_pkg_has_scriptlet (alpm_pkg_t *pkg)
Returns whether the package has an install scriptlet.

off_t alpm_pkg_download_size (alpm_pkg_t *newpkg)
Returns the size of the files that will be downloaded to install a package.

int alpm_pkg_set_reason (alpm_pkg_t pkg, *alpm_pkgreason_t reason)
Set install reason for a package in the local database.

Functions for reading the changelog

void * alpm_pkg_changelog_open (alpm_pkg_t *pkg)
Open a package changelog for reading.

size_t alpm_pkg_changelog_read (void ptr, size_t size, const *alpm_pkg_t *pkg, void *fp)
Read data from an open changelog ’file stream’.

int alpm_pkg_changelog_close (const alpm_pkg_t *pkg, void *fp)
Close a package changelog for reading.

Functions for reading the mtree

struct archive * alpm_pkg_mtree_open (alpm_pkg_t *pkg)
Open a package mtree file for reading.

int alpm_pkg_mtree_next (const alpm_pkg_t *pkg, struct archive *archive, struct archive_entry **entry)
Read next entry from a package mtree file.

int alpm_pkg_mtree_close (const alpm_pkg_t *pkg, struct archive *archive)
Close a package mtree file.

A package. A package can be loaded from disk via alpm_pkg_load or retrieved from a database. Packages from databases are automatically freed when the database is unregistered. Packages loaded from a file must be freed manually.

Packages can then be queried for metadata or added to a *transaction * to be added or removed from the system.

Location a package object was loaded from.

Enumerator

/ALPM_PKG_FROM_FILE /

Loaded from a file via *alpm_pkg_load*/. /

/ALPM_PKG_FROM_LOCALDB /

From the local database.

/ALPM_PKG_FROM_SYNCDB /

From a sync database.

Package install reasons.

Enumerator

/ALPM_PKG_REASON_EXPLICIT /

Explicitly requested by the user.

/ALPM_PKG_REASON_DEPEND /

Installed as a dependency for another package.

Method used to validate a package.

Enumerator

/ALPM_PKG_VALIDATION_UNKNOWN /

The package’s validation type is unknown.

/ALPM_PKG_VALIDATION_NONE /

The package does not have any validation.

/ALPM_PKG_VALIDATION_MD5SUM /

The package is validated with md5.

/ALPM_PKG_VALIDATION_SHA256SUM /

The package is validated with sha256.

/ALPM_PKG_VALIDATION_SIGNATURE /

The package is validated with a PGP signature.

alpm_list_t * urls, alpm_list_t ** fetched)/ Fetch a list of remote packages.

Parameters

handle the context handle /
/urls list of package URLs to download /
/fetched list of filepaths to the fetched packages, each item corresponds to one in /=urls= list. This is an output parameter, the caller should provide a pointer to an empty list (*fetched = NULL) and the callee fills the list with data. /

Returns

0 on success or -1 on failure

Close a package changelog for reading.

Parameters

/pkg the package to close the changelog of (either file or db) /
/fp the ’file stream’ to the package changelog to close /

Returns

0 on success, -1 on error

Open a package changelog for reading. Similar to fopen in functionality, except that the returned ’file stream’ could really be from an archive as well as from the database.

Parameters

/pkg the package to read the changelog of (either file or db) /

Returns

a ’file stream’ to the package changelog

*alpm_pkg_t*/ * pkg, void * fp)/ Read data from an open changelog ’file stream’. Similar to fread in functionality, this function takes a buffer and amount of data to read. If an error occurs pm_errno will be set.

Parameters

/ptr a buffer to fill with raw changelog data /
/size the size of the buffer /
/pkg the package that the changelog is being read from /
/fp a ’file stream’ to the package changelog /

Returns

the number of characters read, or 0 if there is no more data or an error occurred.

Check the integrity (with md5) of a package from the sync cache.

Parameters

/pkg package pointer /

Returns

0 on success, -1 on error (pm_errno is set accordingly)

Computes the list of packages optionally requiring a given package. The return value of this function is a newly allocated list of package names (char*), it should be freed by the caller.

Parameters

/pkg a package /

Returns

the list of packages optionally requiring pkg

Computes the list of packages requiring a given package. The return value of this function is a newly allocated list of package names (char*), it should be freed by the caller.

Parameters

/pkg a package /

Returns

the list of packages requiring pkg

Returns the size of the files that will be downloaded to install a package.

Parameters

/newpkg the new package to upgrade to /

Returns

the size of the download

Free a package. Only packages loaded with *alpm_pkg_load*/ can be freed. Packages from databases will be freed by libalpm when they are unregistered. /

Parameters

/pkg package pointer to free /

Returns

0 on success, -1 on error (pm_errno is set accordingly)

Returns the architecture for which the package was built.

Parameters

/pkg a pointer to package /

Returns

a reference to an internal string

Returns the list of files backed up when installing pkg.

Parameters

/pkg a pointer to package /

Returns

a reference to a list of *alpm_backup_t*/ objects /

Returns the package base name.

Parameters

/pkg a pointer to package /

Returns

a reference to an internal string

Returns the base64 encoded package signature.

Parameters

/pkg a pointer to package /

Returns

a reference to an internal string

Returns the build timestamp of the package.

Parameters

/pkg a pointer to package /

Returns

the timestamp of the build time

Returns a list of package check dependencies.

Parameters

/pkg a pointer to package /

Returns

a reference to an internal list of *alpm_depend_t*/ structures. /

Returns the list of packages conflicting with pkg.

Parameters

/pkg a pointer to package /

Returns

a reference to an internal list of *alpm_depend_t*/ structures. /

Returns the database containing pkg. Returns a pointer to the alpm_db_t structure the package is originating from, or NULL if the package was loaded from a file.

Parameters

/pkg a pointer to package /

Returns

a pointer to the DB containing pkg, or NULL.

Returns the list of package dependencies as *alpm_depend_t*/. /

Parameters

/pkg a pointer to package /

Returns

a reference to an internal list of *alpm_depend_t*/ structures. /

Returns the package description.

Parameters

/pkg a pointer to package /

Returns

a reference to an internal string

Gets the name of the file from which the package was loaded.

Parameters

/pkg a pointer to package /

Returns

a reference to an internal string

Returns the list of files installed by pkg. The filenames are relative to the install root, and do not include leading slashes.

Parameters

/pkg a pointer to package /

Returns

a pointer to a filelist object containing a count and an array of package file objects

Returns the list of package groups.

Parameters

/pkg a pointer to package /

Returns

a pointer to an internal list of strings.

Returns the install timestamp of the package.

Parameters

/pkg a pointer to package /

Returns

the timestamp of the install time

Returns the installed size of the package.

Parameters

/pkg a pointer to package /

Returns

the total size of files installed by the package.

Returns the list of package licenses.

Parameters

/pkg a pointer to package /

Returns

a pointer to an internal list of strings.

Returns a list of package make dependencies.

Parameters

/pkg a pointer to package /

Returns

a reference to an internal list of *alpm_depend_t*/ structures. /

Returns the package’s MD5 checksum as a string. The returned string is a sequence of 32 lowercase hexadecimal digits.

Parameters

/pkg a pointer to package /

Returns

a reference to an internal string

Returns the package name.

Parameters

/pkg a pointer to package /

Returns

a reference to an internal string

Returns the list of package optional dependencies.

Parameters

/pkg a pointer to package /

Returns

a reference to an internal list of *alpm_depend_t*/ structures. /

Returns the origin of the package.

Returns

an alpm_pkgfrom_t constant, -1 on error

Returns the packager’s name.

Parameters

/pkg a pointer to package /

Returns

a reference to an internal string

Returns the list of packages provided by pkg.

Parameters

/pkg a pointer to package /

Returns

a reference to an internal list of *alpm_depend_t*/ structures. /

Returns the package installation reason.

Parameters

/pkg a pointer to package /

Returns

an enum member giving the install reason.

Returns the list of packages to be replaced by pkg.

Parameters

/pkg a pointer to package /

Returns

a reference to an internal list of *alpm_depend_t*/ structures. /

Returns the package’s SHA256 checksum as a string. The returned string is a sequence of 64 lowercase hexadecimal digits.

Parameters

/pkg a pointer to package /

Returns

a reference to an internal string

size_t * sig_len)/ Extracts package signature either from embedded package signature or if it is absent then reads data from detached signature file.

Parameters

/pkg a pointer to package. /
/sig output parameter for signature data. Callee function allocates a buffer needed for the signature data. Caller is responsible for freeing this buffer. /
/sig_len output parameter for the signature data length. /

Returns

0 on success, negative number on error.

Returns the size of the package. This is only available for sync database packages and package files, not those loaded from the local database.

Parameters

/pkg a pointer to package /

Returns

the size of the package in bytes.

Returns the package URL.

Parameters

/pkg a pointer to package /

Returns

a reference to an internal string

Returns the method used to validate a package during install.

Parameters

/pkg a pointer to package /

Returns

an enum member giving the validation method

Returns the package version as a string. This includes all available epoch, version, and pkgrel components. Use *alpm_pkg_vercmp()*/ to compare version strings if necessary. /

Parameters

/pkg a pointer to package /

Returns

a reference to an internal string

Returns whether the package has an install scriptlet.

Returns

0 if FALSE, TRUE otherwise

int full, int level, alpm_pkg_t ** pkg)/ Create a package from a file. If full is false, the archive is read only until all necessary metadata is found. If it is true, the entire archive is read, which serves as a verification of integrity and the filelist can be created. The allocated structure should be freed using *alpm_pkg_free()*/. /

Parameters

/handle the context handle /
/filename location of the package tarball /
/full whether to stop the load after metadata is read or continue through the full archive /
/level what level of package signature checking to perform on the package; note that this must be a ’.sig’ file type verification /
/pkg address of the package pointer /

Returns

0 on success, -1 on error (pm_errno is set accordingly)

archive)/ Close a package mtree file.

Parameters

/pkg the local package to close the mtree of /
/archive the archive to close /

archive, struct archive_entry ** entry)/ Read next entry from a package mtree file.

Parameters

/pkg the package that the mtree file is being read from /
/archive the archive structure reading from the mtree file /
/entry an archive_entry to store the entry header information /

Returns

0 on success, 1 if end of archive is reached, -1 otherwise.

Open a package mtree file for reading.

Parameters

/pkg the local package to read the mtree of /

Returns

an archive structure for the package mtree file

reason)/ Set install reason for a package in the local database. The provided package object must be from the local database or this method will fail. The write to the local database is performed immediately.

Parameters

/pkg the package to update /
/reason the new install reason /

Returns

0 on success, -1 on error (pm_errno is set accordingly)

Compare two version strings and determine which one is ’newer’. Returns a value comparable to the way strcmp works. Returns 1 if a is newer than b, 0 if a and b are the same version, or -1 if b is newer than a.

Different epoch values for version strings will override any further comparison. If no epoch is provided, 0 is assumed.

Keep in mind that the pkgrel is only compared if it is available on both versions handed to this function. For example, comparing 1.5-1 and 1.5 will yield 0; comparing 1.5-1 and 1.5-2 will yield -1 as expected. This is mainly for supporting versioned dependencies that do not include the pkgrel.