Pacman-dev
Threads by month
- ----- 2024 -----
- December
- November
- October
- September
- August
- July
- June
- May
- April
- March
- February
- January
- ----- 2023 -----
- December
- November
- October
- September
- August
- July
- June
- May
- April
- March
- February
- January
- ----- 2022 -----
- December
- November
- October
- September
- August
- July
- June
- May
- April
- March
- February
- January
- ----- 2021 -----
- December
- November
- October
- September
- August
- July
- June
- May
- April
- March
- February
- January
- ----- 2020 -----
- December
- November
- October
- September
- August
- July
- June
- May
- April
- March
- February
- January
- ----- 2019 -----
- December
- November
- October
- September
- August
- July
- June
- May
- April
- March
- February
- January
- ----- 2018 -----
- December
- November
- October
- September
- August
- July
- June
- May
- April
- March
- February
- January
- ----- 2017 -----
- December
- November
- October
- September
- August
- July
- June
- May
- April
- March
- February
- January
- ----- 2016 -----
- December
- November
- October
- September
- August
- July
- June
- May
- April
- March
- February
- January
- ----- 2015 -----
- December
- November
- October
- September
- August
- July
- June
- May
- April
- March
- February
- January
- ----- 2014 -----
- December
- November
- October
- September
- August
- July
- June
- May
- April
- March
- February
- January
- ----- 2013 -----
- December
- November
- October
- September
- August
- July
- June
- May
- April
- March
- February
- January
- ----- 2012 -----
- December
- November
- October
- September
- August
- July
- June
- May
- April
- March
- February
- January
- ----- 2011 -----
- December
- November
- October
- September
- August
- July
- June
- May
- April
- March
- February
- January
- ----- 2010 -----
- December
- November
- October
- September
- August
- July
- June
- May
- April
- March
- February
- January
- ----- 2009 -----
- December
- November
- October
- September
- August
- July
- June
- May
- April
- March
- February
- January
- ----- 2008 -----
- December
- November
- October
- September
- August
- July
- June
- May
- April
- March
- February
- January
- ----- 2007 -----
- December
- November
- October
- September
- August
- July
- June
- May
- April
- March
- February
- January
- ----- 2006 -----
- December
- November
- October
- September
- August
- July
- June
- May
- April
- March
- February
- January
- ----- 2005 -----
- December
- November
- October
February 2015
- 19 participants
- 41 discussions
[pacman-dev] Please make the colourised output exactly like that of "pacman-color"
by Xavion 29 Apr '16
by Xavion 29 Apr '16
29 Apr '16
Hi All,
It's great that "pacman" finally has native colour support in v4.1.0. It's
just a shame that it's not as good as that of "pacman-color". Without
meaning any offence, it falls way short of the mark IMHO.
I'm hoping you can just replicate the colourisation of "pacman-color". For
your convenience, I've attached the relevant files you'd need. I'm only
requesting this because "pacman-color" no longer exists.
--
Regards, Xavion.
10
60
[pacman-dev] [PATCH v2 1/1] libalpm: generate alpm.h on the fly and add version information
by Christian Hesse 29 Nov '15
by Christian Hesse 29 Nov '15
29 Nov '15
From: Christian Hesse <mail(a)eworm.de>
Programs linked against libalpm (for example packagekit) may want to use
preprocessor macros to check version and choose correct API. This adds
version information to alpm.h.
Signed-off-by: Christian Hesse <mail(a)eworm.de>
---
configure.ac | 13 +
lib/libalpm/.gitignore | 1 +
lib/libalpm/alpm.h | 1587 -----------------------------------------------
lib/libalpm/alpm.h.in | 1596 ++++++++++++++++++++++++++++++++++++++++++++++++
4 files changed, 1610 insertions(+), 1587 deletions(-)
delete mode 100644 lib/libalpm/alpm.h
create mode 100644 lib/libalpm/alpm.h.in
diff --git a/configure.ac b/configure.ac
index e0ed3cf..7b30d24 100644
--- a/configure.ac
+++ b/configure.ac
@@ -65,6 +65,10 @@ AM_SILENT_RULES([yes])
LT_INIT
LIB_VERSION=`expr lib_current - lib_age`.lib_age.lib_revision
+LIB_VERSION_CURRENT=lib_current
+LIB_VERSION_REVISION=lib_revision
+LIB_VERSION_AGE=lib_age
+LIB_VERSION_NUMBER=`printf 0x%02x%02x%02x lib_current lib_revision lib_age`
LIB_VERSION_INFO="lib_current:lib_revision:lib_age"
# Respect empty CFLAGS during compiler tests
@@ -76,7 +80,15 @@ fi
# and put LIB_VERSION in config.h
AC_SUBST(LIB_VERSION)
AC_SUBST(LIB_VERSION_INFO)
+AC_SUBST(LIB_VERSION_CURRENT)
+AC_SUBST(LIB_VERSION_REVISION)
+AC_SUBST(LIB_VERSION_AGE)
+AC_SUBST(LIB_VERSION_NUMBER)
AC_DEFINE_UNQUOTED([LIB_VERSION], ["$LIB_VERSION"], [libalpm version number])
+AC_DEFINE_UNQUOTED([LIB_VERSION_CURRENT], ["$LIB_VERSION_CURRENT"], [libalpm version number current])
+AC_DEFINE_UNQUOTED([LIB_VERSION_REVISION], ["$LIB_VERSION_REVISION"], [libalpm version number revision])
+AC_DEFINE_UNQUOTED([LIB_VERSION_AGE], ["$LIB_VERSION_AGE"], [libalpm version number age])
+AC_DEFINE_UNQUOTED([LIB_VERSION_NUMBER], ["$LIB_VERSION_NUMBER"], [libalpm version number hex])
# Help line for root directory
AC_ARG_WITH(root-dir,
@@ -498,6 +510,7 @@ AC_CONFIG_FILES([
lib/libalpm/Makefile
lib/libalpm/po/Makefile.in
lib/libalpm/libalpm.pc
+lib/libalpm/alpm.h
src/common/Makefile
src/pacman/Makefile
src/pacman/po/Makefile.in
diff --git a/lib/libalpm/.gitignore b/lib/libalpm/.gitignore
index 82318d3..5b94ed8 100644
--- a/lib/libalpm/.gitignore
+++ b/lib/libalpm/.gitignore
@@ -2,4 +2,5 @@
.libs
*.lo
*.la
+alpm.h
libalpm.pc
diff --git a/lib/libalpm/alpm.h b/lib/libalpm/alpm.h
deleted file mode 100644
index 91b9461..0000000
--- a/lib/libalpm/alpm.h
+++ /dev/null
@@ -1,1587 +0,0 @@
-/*
- * alpm.h
- *
- * Copyright (c) 2006-2014 Pacman Development Team <pacman-dev(a)archlinux.org>
- * Copyright (c) 2002-2006 by Judd Vinet <jvinet(a)zeroflux.org>
- * Copyright (c) 2005 by Aurelien Foret <orelien(a)chez.com>
- * Copyright (c) 2005 by Christian Hamar <krics(a)linuxforum.hu>
- * Copyright (c) 2005, 2006 by Miklos Vajna <vmiklos(a)frugalware.org>
- *
- * 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. If not, see <http://www.gnu.org/licenses/>.
- */
-#ifndef _ALPM_H
-#define _ALPM_H
-
-#ifdef __cplusplus
-extern "C" {
-#endif
-
-#include <stdint.h> /* int64_t */
-#include <sys/types.h> /* off_t */
-#include <stdarg.h> /* va_list */
-
-/* libarchive */
-#include <archive.h>
-#include <archive_entry.h>
-
-#include <alpm_list.h>
-
-/*
- * Arch Linux Package Management library
- */
-
-/*
- * Opaque Structures
- */
-typedef struct __alpm_handle_t alpm_handle_t;
-typedef struct __alpm_db_t alpm_db_t;
-typedef struct __alpm_pkg_t alpm_pkg_t;
-typedef struct __alpm_trans_t alpm_trans_t;
-
-/** @addtogroup alpm_api_errors Error Codes
- * @{
- */
-typedef enum _alpm_errno_t {
- ALPM_ERR_MEMORY = 1,
- ALPM_ERR_SYSTEM,
- ALPM_ERR_BADPERMS,
- ALPM_ERR_NOT_A_FILE,
- ALPM_ERR_NOT_A_DIR,
- ALPM_ERR_WRONG_ARGS,
- ALPM_ERR_DISK_SPACE,
- /* Interface */
- ALPM_ERR_HANDLE_NULL,
- ALPM_ERR_HANDLE_NOT_NULL,
- ALPM_ERR_HANDLE_LOCK,
- /* Databases */
- ALPM_ERR_DB_OPEN,
- ALPM_ERR_DB_CREATE,
- ALPM_ERR_DB_NULL,
- ALPM_ERR_DB_NOT_NULL,
- ALPM_ERR_DB_NOT_FOUND,
- ALPM_ERR_DB_INVALID,
- ALPM_ERR_DB_INVALID_SIG,
- ALPM_ERR_DB_VERSION,
- ALPM_ERR_DB_WRITE,
- ALPM_ERR_DB_REMOVE,
- /* Servers */
- ALPM_ERR_SERVER_BAD_URL,
- ALPM_ERR_SERVER_NONE,
- /* Transactions */
- ALPM_ERR_TRANS_NOT_NULL,
- ALPM_ERR_TRANS_NULL,
- ALPM_ERR_TRANS_DUP_TARGET,
- ALPM_ERR_TRANS_NOT_INITIALIZED,
- ALPM_ERR_TRANS_NOT_PREPARED,
- ALPM_ERR_TRANS_ABORT,
- ALPM_ERR_TRANS_TYPE,
- ALPM_ERR_TRANS_NOT_LOCKED,
- /* Packages */
- ALPM_ERR_PKG_NOT_FOUND,
- ALPM_ERR_PKG_IGNORED,
- ALPM_ERR_PKG_INVALID,
- ALPM_ERR_PKG_INVALID_CHECKSUM,
- ALPM_ERR_PKG_INVALID_SIG,
- ALPM_ERR_PKG_MISSING_SIG,
- ALPM_ERR_PKG_OPEN,
- ALPM_ERR_PKG_CANT_REMOVE,
- ALPM_ERR_PKG_INVALID_NAME,
- ALPM_ERR_PKG_INVALID_ARCH,
- ALPM_ERR_PKG_REPO_NOT_FOUND,
- /* Signatures */
- ALPM_ERR_SIG_MISSING,
- ALPM_ERR_SIG_INVALID,
- /* Deltas */
- ALPM_ERR_DLT_INVALID,
- ALPM_ERR_DLT_PATCHFAILED,
- /* Dependencies */
- ALPM_ERR_UNSATISFIED_DEPS,
- ALPM_ERR_CONFLICTING_DEPS,
- ALPM_ERR_FILE_CONFLICTS,
- /* Misc */
- ALPM_ERR_RETRIEVE,
- ALPM_ERR_INVALID_REGEX,
- /* External library errors */
- ALPM_ERR_LIBARCHIVE,
- ALPM_ERR_LIBCURL,
- ALPM_ERR_EXTERNAL_DOWNLOAD,
- ALPM_ERR_GPGME
-} alpm_errno_t;
-
-/** Returns the current error code from the handle. */
-alpm_errno_t alpm_errno(alpm_handle_t *handle);
-
-/** Returns the string corresponding to an error number. */
-const char *alpm_strerror(alpm_errno_t err);
-
-/* End of alpm_api_errors */
-/** @} */
-
-/** @addtogroup alpm_api Public API
- * The libalpm Public API
- * @{
- */
-
-typedef int64_t alpm_time_t;
-
-/*
- * Enumerations
- * These ones are used in multiple contexts, so are forward-declared.
- */
-
-/** Package install reasons. */
-typedef enum _alpm_pkgreason_t {
- /** Explicitly requested by the user. */
- ALPM_PKG_REASON_EXPLICIT = 0,
- /** Installed as a dependency for another package. */
- ALPM_PKG_REASON_DEPEND = 1
-} alpm_pkgreason_t;
-
-/** Location a package object was loaded from. */
-typedef enum _alpm_pkgfrom_t {
- ALPM_PKG_FROM_FILE = 1,
- ALPM_PKG_FROM_LOCALDB,
- ALPM_PKG_FROM_SYNCDB
-} alpm_pkgfrom_t;
-
-/** Method used to validate a package. */
-typedef 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)
-} alpm_pkgvalidation_t;
-
-/** Types of version constraints in dependency specs. */
-typedef enum _alpm_depmod_t {
- /** No version constraint */
- ALPM_DEP_MOD_ANY = 1,
- /** Test version equality (package=x.y.z) */
- ALPM_DEP_MOD_EQ,
- /** Test for at least a version (package>=x.y.z) */
- ALPM_DEP_MOD_GE,
- /** Test for at most a version (package<=x.y.z) */
- ALPM_DEP_MOD_LE,
- /** Test for greater than some version (package>x.y.z) */
- ALPM_DEP_MOD_GT,
- /** Test for less than some version (package<x.y.z) */
- ALPM_DEP_MOD_LT
-} alpm_depmod_t;
-
-/**
- * File conflict type.
- * Whether the conflict results from a file existing on the filesystem, or with
- * another target in the transaction.
- */
-typedef enum _alpm_fileconflicttype_t {
- ALPM_FILECONFLICT_TARGET = 1,
- ALPM_FILECONFLICT_FILESYSTEM
-} alpm_fileconflicttype_t;
-
-/** PGP signature verification options */
-typedef enum _alpm_siglevel_t {
- ALPM_SIG_PACKAGE = (1 << 0),
- ALPM_SIG_PACKAGE_OPTIONAL = (1 << 1),
- ALPM_SIG_PACKAGE_MARGINAL_OK = (1 << 2),
- ALPM_SIG_PACKAGE_UNKNOWN_OK = (1 << 3),
-
- ALPM_SIG_DATABASE = (1 << 10),
- ALPM_SIG_DATABASE_OPTIONAL = (1 << 11),
- ALPM_SIG_DATABASE_MARGINAL_OK = (1 << 12),
- ALPM_SIG_DATABASE_UNKNOWN_OK = (1 << 13),
-
- ALPM_SIG_PACKAGE_SET = (1 << 27),
- ALPM_SIG_PACKAGE_TRUST_SET = (1 << 28),
-
- ALPM_SIG_USE_DEFAULT = (1 << 31)
-} alpm_siglevel_t;
-
-/** PGP signature verification status return codes */
-typedef enum _alpm_sigstatus_t {
- ALPM_SIGSTATUS_VALID,
- ALPM_SIGSTATUS_KEY_EXPIRED,
- ALPM_SIGSTATUS_SIG_EXPIRED,
- ALPM_SIGSTATUS_KEY_UNKNOWN,
- ALPM_SIGSTATUS_KEY_DISABLED,
- ALPM_SIGSTATUS_INVALID
-} alpm_sigstatus_t;
-
-/** PGP signature verification status return codes */
-typedef enum _alpm_sigvalidity_t {
- ALPM_SIGVALIDITY_FULL,
- ALPM_SIGVALIDITY_MARGINAL,
- ALPM_SIGVALIDITY_NEVER,
- ALPM_SIGVALIDITY_UNKNOWN
-} alpm_sigvalidity_t;
-
-/*
- * Structures
- */
-
-/** Dependency */
-typedef struct _alpm_depend_t {
- char *name;
- char *version;
- char *desc;
- unsigned long name_hash;
- alpm_depmod_t mod;
-} alpm_depend_t;
-
-/** Missing dependency */
-typedef struct _alpm_depmissing_t {
- char *target;
- alpm_depend_t *depend;
- /* this is used only in the case of a remove dependency error */
- char *causingpkg;
-} alpm_depmissing_t;
-
-/** Conflict */
-typedef struct _alpm_conflict_t {
- unsigned long package1_hash;
- unsigned long package2_hash;
- char *package1;
- char *package2;
- alpm_depend_t *reason;
-} alpm_conflict_t;
-
-/** File conflict */
-typedef struct _alpm_fileconflict_t {
- char *target;
- alpm_fileconflicttype_t type;
- char *file;
- char *ctarget;
-} alpm_fileconflict_t;
-
-/** Package group */
-typedef struct _alpm_group_t {
- /** group name */
- char *name;
- /** list of alpm_pkg_t packages */
- alpm_list_t *packages;
-} alpm_group_t;
-
-/** Package upgrade delta */
-typedef struct _alpm_delta_t {
- /** filename of the delta patch */
- char *delta;
- /** md5sum of the delta file */
- char *delta_md5;
- /** filename of the 'before' file */
- char *from;
- /** filename of the 'after' file */
- char *to;
- /** filesize of the delta file */
- off_t delta_size;
- /** download filesize of the delta file */
- off_t download_size;
-} alpm_delta_t;
-
-/** File in a package */
-typedef struct _alpm_file_t {
- char *name;
- off_t size;
- mode_t mode;
-} alpm_file_t;
-
-/** Package filelist container */
-typedef struct _alpm_filelist_t {
- size_t count;
- alpm_file_t *files;
-} alpm_filelist_t;
-
-/** Local package or package file backup entry */
-typedef struct _alpm_backup_t {
- char *name;
- char *hash;
-} alpm_backup_t;
-
-typedef struct _alpm_pgpkey_t {
- void *data;
- char *fingerprint;
- char *uid;
- char *name;
- char *email;
- alpm_time_t created;
- alpm_time_t expires;
- unsigned int length;
- unsigned int revoked;
- char pubkey_algo;
-} alpm_pgpkey_t;
-
-/**
- * Signature result. Contains the key, status, and validity of a given
- * signature.
- */
-typedef struct _alpm_sigresult_t {
- alpm_pgpkey_t key;
- alpm_sigstatus_t status;
- alpm_sigvalidity_t validity;
-} alpm_sigresult_t;
-
-/**
- * Signature list. Contains the number of signatures found and a pointer to an
- * array of results. The array is of size count.
- */
-typedef struct _alpm_siglist_t {
- size_t count;
- alpm_sigresult_t *results;
-} alpm_siglist_t;
-
-/*
- * Logging facilities
- */
-
-/** Logging Levels */
-typedef enum _alpm_loglevel_t {
- ALPM_LOG_ERROR = 1,
- ALPM_LOG_WARNING = (1 << 1),
- ALPM_LOG_DEBUG = (1 << 2),
- ALPM_LOG_FUNCTION = (1 << 3)
-} alpm_loglevel_t;
-
-typedef void (*alpm_cb_log)(alpm_loglevel_t, const char *, va_list);
-
-int alpm_logaction(alpm_handle_t *handle, const char *prefix,
- const char *fmt, ...) __attribute__((format(printf, 3, 4)));
-
-/**
- * Type of events.
- */
-typedef enum _alpm_event_type_t {
- /** Dependencies will be computed for a package. */
- ALPM_EVENT_CHECKDEPS_START = 1,
- /** Dependencies were computed for a package. */
- ALPM_EVENT_CHECKDEPS_DONE,
- /** File conflicts will be computed for a package. */
- ALPM_EVENT_FILECONFLICTS_START,
- /** File conflicts were computed for a package. */
- ALPM_EVENT_FILECONFLICTS_DONE,
- /** Dependencies will be resolved for target package. */
- ALPM_EVENT_RESOLVEDEPS_START,
- /** Dependencies were resolved for target package. */
- ALPM_EVENT_RESOLVEDEPS_DONE,
- /** Inter-conflicts will be checked for target package. */
- ALPM_EVENT_INTERCONFLICTS_START,
- /** Inter-conflicts were checked for target package. */
- ALPM_EVENT_INTERCONFLICTS_DONE,
- /** Package will be installed/upgraded/downgraded/re-installed/removed; See
- * alpm_event_package_operation_t for arguments. */
- ALPM_EVENT_PACKAGE_OPERATION_START,
- /** Package was installed/upgraded/downgraded/re-installed/removed; See
- * alpm_event_package_operation_t for arguments. */
- ALPM_EVENT_PACKAGE_OPERATION_DONE,
- /** Target package's integrity will be checked. */
- ALPM_EVENT_INTEGRITY_START,
- /** Target package's integrity was checked. */
- ALPM_EVENT_INTEGRITY_DONE,
- /** Target package will be loaded. */
- ALPM_EVENT_LOAD_START,
- /** Target package is finished loading. */
- ALPM_EVENT_LOAD_DONE,
- /** Target delta's integrity will be checked. */
- ALPM_EVENT_DELTA_INTEGRITY_START,
- /** Target delta's integrity was checked. */
- ALPM_EVENT_DELTA_INTEGRITY_DONE,
- /** Deltas will be applied to packages. */
- ALPM_EVENT_DELTA_PATCHES_START,
- /** Deltas were applied to packages. */
- ALPM_EVENT_DELTA_PATCHES_DONE,
- /** Delta patch will be applied to target package; See
- * alpm_event_delta_patch_t for arguments.. */
- ALPM_EVENT_DELTA_PATCH_START,
- /** Delta patch was applied to target package. */
- ALPM_EVENT_DELTA_PATCH_DONE,
- /** Delta patch failed to apply to target package. */
- ALPM_EVENT_DELTA_PATCH_FAILED,
- /** Scriptlet has printed information; See alpm_event_scriptlet_info_t for
- * arguments. */
- ALPM_EVENT_SCRIPTLET_INFO,
- /** Files will be downloaded from a repository. */
- ALPM_EVENT_RETRIEVE_START,
- /** Files were downloaded from a repository. */
- ALPM_EVENT_RETRIEVE_DONE,
- /** Not all files were successfully downloaded from a repository. */
- ALPM_EVENT_RETRIEVE_FAILED,
- /** A file will be downloaded from a repository; See alpm_event_pkgdownload_t
- * for arguments */
- ALPM_EVENT_PKGDOWNLOAD_START,
- /** A file was downloaded from a repository; See alpm_event_pkgdownload_t
- * for arguments */
- ALPM_EVENT_PKGDOWNLOAD_DONE,
- /** A file failed to be downloaded from a repository; See
- * alpm_event_pkgdownload_t for arguments */
- ALPM_EVENT_PKGDOWNLOAD_FAILED,
- /** Disk space usage will be computed for a package. */
- ALPM_EVENT_DISKSPACE_START,
- /** Disk space usage was computed for a package. */
- ALPM_EVENT_DISKSPACE_DONE,
- /** An optdepend for another package is being removed; See
- * alpm_event_optdep_removal_t for arguments. */
- ALPM_EVENT_OPTDEP_REMOVAL,
- /** A configured repository database is missing; See
- * alpm_event_database_missing_t for arguments. */
- ALPM_EVENT_DATABASE_MISSING,
- /** Checking keys used to create signatures are in keyring. */
- ALPM_EVENT_KEYRING_START,
- /** Keyring checking is finished. */
- ALPM_EVENT_KEYRING_DONE,
- /** Downloading missing keys into keyring. */
- ALPM_EVENT_KEY_DOWNLOAD_START,
- /** Key downloading is finished. */
- ALPM_EVENT_KEY_DOWNLOAD_DONE,
- /** A .pacnew file was created; See alpm_event_pacnew_created_t for arguments. */
- ALPM_EVENT_PACNEW_CREATED,
- /** A .pacsave file was created; See alpm_event_pacsave_created_t for
- * arguments */
- ALPM_EVENT_PACSAVE_CREATED,
- /** A .pacorig file was created; See alpm_event_pacorig_created_t for
- * arguments */
- ALPM_EVENT_PACORIG_CREATED
-} alpm_event_type_t;
-
-typedef struct _alpm_event_any_t {
- /** Type of event. */
- alpm_event_type_t type;
-} alpm_event_any_t;
-
-typedef enum _alpm_package_operation_t {
- /** Package (to be) installed. (No oldpkg) */
- ALPM_PACKAGE_INSTALL = 1,
- /** Package (to be) upgraded */
- ALPM_PACKAGE_UPGRADE,
- /** Package (to be) re-installed. */
- ALPM_PACKAGE_REINSTALL,
- /** Package (to be) downgraded. */
- ALPM_PACKAGE_DOWNGRADE,
- /** Package (to be) removed. (No newpkg) */
- ALPM_PACKAGE_REMOVE
-} alpm_package_operation_t;
-
-typedef struct _alpm_event_package_operation_t {
- /** Type of event. */
- alpm_event_type_t type;
- /** Type of operation. */
- alpm_package_operation_t operation;
- /** Old package. */
- alpm_pkg_t *oldpkg;
- /** New package. */
- alpm_pkg_t *newpkg;
-} alpm_event_package_operation_t;
-
-typedef struct _alpm_event_optdep_removal_t {
- /** Type of event. */
- alpm_event_type_t type;
- /** Package with the optdep. */
- alpm_pkg_t *pkg;
- /** Optdep being removed. */
- alpm_depend_t *optdep;
-} alpm_event_optdep_removal_t;
-
-typedef struct _alpm_event_delta_patch_t {
- /** Type of event. */
- alpm_event_type_t type;
- /** Delta info */
- alpm_delta_t *delta;
-} alpm_event_delta_patch_t;
-
-typedef struct _alpm_event_scriptlet_info_t {
- /** Type of event. */
- alpm_event_type_t type;
- /** Line of scriptlet output. */
- const char *line;
-} alpm_event_scriptlet_info_t;
-
-typedef struct _alpm_event_database_missing_t {
- /** Type of event. */
- alpm_event_type_t type;
- /** Name of the database. */
- const char *dbname;
-} alpm_event_database_missing_t;
-
-typedef struct _alpm_event_pkgdownload_t {
- /** Type of event. */
- alpm_event_type_t type;
- /** Name of the file */
- const char *file;
-} alpm_event_pkgdownload_t;
-
-typedef struct _alpm_event_pacnew_created_t {
- /** Type of event. */
- alpm_event_type_t type;
- /** Whether the creation was result of a NoUpgrade or not */
- int from_noupgrade;
- /** Old package. */
- alpm_pkg_t *oldpkg;
- /** New Package. */
- alpm_pkg_t *newpkg;
- /** Filename of the file without the .pacnew suffix */
- const char *file;
-} alpm_event_pacnew_created_t;
-
-typedef struct _alpm_event_pacsave_created_t {
- /** Type of event. */
- alpm_event_type_t type;
- /** Old package. */
- alpm_pkg_t *oldpkg;
- /** Filename of the file without the .pacsave suffix. */
- const char *file;
-} alpm_event_pacsave_created_t;
-
-typedef struct _alpm_event_pacorig_created_t {
- /** Type of event. */
- alpm_event_type_t type;
- /** New package. */
- alpm_pkg_t *newpkg;
- /** Filename of the file without the .pacorig suffix. */
- const char *file;
-} alpm_event_pacorig_created_t;
-
-/** Events.
- * This is an union passed to the callback, that allows the frontend to know
- * which type of event was triggered (via type). It is then possible to
- * typecast the pointer to the right structure, or use the union field, in order
- * to access event-specific data. */
-typedef union _alpm_event_t {
- alpm_event_type_t type;
- alpm_event_any_t any;
- alpm_event_package_operation_t package_operation;
- alpm_event_optdep_removal_t optdep_removal;
- alpm_event_delta_patch_t delta_patch;
- alpm_event_scriptlet_info_t scriptlet_info;
- alpm_event_database_missing_t database_missing;
- alpm_event_pkgdownload_t pkgdownload;
- alpm_event_pacnew_created_t pacnew_created;
- alpm_event_pacsave_created_t pacsave_created;
- alpm_event_pacorig_created_t pacorig_created;
-} alpm_event_t;
-
-/** Event callback. */
-typedef void (*alpm_cb_event)(alpm_event_t *);
-
-/**
- * Type of questions.
- * Unlike the events or progress enumerations, this enum has bitmask values
- * so a frontend can use a bitmask map to supply preselected answers to the
- * different types of questions.
- */
-typedef enum _alpm_question_type_t {
- ALPM_QUESTION_INSTALL_IGNOREPKG = (1 << 0),
- ALPM_QUESTION_REPLACE_PKG = (1 << 1),
- ALPM_QUESTION_CONFLICT_PKG = (1 << 2),
- ALPM_QUESTION_CORRUPTED_PKG = (1 << 3),
- ALPM_QUESTION_REMOVE_PKGS = (1 << 4),
- ALPM_QUESTION_SELECT_PROVIDER = (1 << 5),
- ALPM_QUESTION_IMPORT_KEY = (1 << 6)
-} alpm_question_type_t;
-
-typedef struct _alpm_question_any_t {
- /** Type of question. */
- alpm_question_type_t type;
- /** Answer. */
- int answer;
-} alpm_question_any_t;
-
-typedef struct _alpm_question_install_ignorepkg_t {
- /** Type of question. */
- alpm_question_type_t type;
- /** Answer: whether or not to install pkg anyway. */
- int install;
- /* Package in IgnorePkg/IgnoreGroup. */
- alpm_pkg_t *pkg;
-} alpm_question_install_ignorepkg_t;
-
-typedef struct _alpm_question_replace_t {
- /** Type of question. */
- alpm_question_type_t type;
- /** Answer: whether or not to replace oldpkg with newpkg. */
- int replace;
- /* Package to be replaced. */
- alpm_pkg_t *oldpkg;
- /* Package to replace with. */
- alpm_pkg_t *newpkg;
- /* DB of newpkg */
- alpm_db_t *newdb;
-} alpm_question_replace_t;
-
-typedef struct _alpm_question_conflict_t {
- /** Type of question. */
- alpm_question_type_t type;
- /** Answer: whether or not to remove conflict->package2. */
- int remove;
- /** Conflict info. */
- alpm_conflict_t *conflict;
-} alpm_question_conflict_t;
-
-typedef struct _alpm_question_corrupted_t {
- /** Type of question. */
- alpm_question_type_t type;
- /** Answer: whether or not to remove filepath. */
- int remove;
- /** Filename to remove */
- const char *filepath;
- /** Error code indicating the reason for package invalidity */
- alpm_errno_t reason;
-} alpm_question_corrupted_t;
-
-typedef struct _alpm_question_remove_pkgs_t {
- /** Type of question. */
- alpm_question_type_t type;
- /** Answer: whether or not to skip packages. */
- int skip;
- /** List of alpm_pkg_t* with unresolved dependencies. */
- alpm_list_t *packages;
-} alpm_question_remove_pkgs_t;
-
-typedef struct _alpm_question_select_provider_t {
- /** Type of question. */
- alpm_question_type_t type;
- /** Answer: which provider to use (index from providers). */
- int use_index;
- /** List of alpm_pkg_t* as possible providers. */
- alpm_list_t *providers;
- /** What providers provide for. */
- alpm_depend_t *depend;
-} alpm_question_select_provider_t;
-
-typedef struct _alpm_question_import_key_t {
- /** Type of question. */
- alpm_question_type_t type;
- /** Answer: whether or not to import key. */
- int import;
- /** The key to import. */
- alpm_pgpkey_t *key;
-} alpm_question_import_key_t;
-
-/**
- * Questions.
- * This is an union passed to the callback, that allows the frontend to know
- * which type of question was triggered (via type). It is then possible to
- * typecast the pointer to the right structure, or use the union field, in order
- * to access question-specific data. */
-typedef union _alpm_question_t {
- alpm_question_type_t type;
- alpm_question_any_t any;
- alpm_question_install_ignorepkg_t install_ignorepkg;
- alpm_question_replace_t replace;
- alpm_question_conflict_t conflict;
- alpm_question_corrupted_t corrupted;
- alpm_question_remove_pkgs_t remove_pkgs;
- alpm_question_select_provider_t select_provider;
- alpm_question_import_key_t import_key;
-} alpm_question_t;
-
-/** Question callback */
-typedef void (*alpm_cb_question)(alpm_question_t *);
-
-/** Progress */
-typedef enum _alpm_progress_t {
- ALPM_PROGRESS_ADD_START,
- ALPM_PROGRESS_UPGRADE_START,
- ALPM_PROGRESS_DOWNGRADE_START,
- ALPM_PROGRESS_REINSTALL_START,
- ALPM_PROGRESS_REMOVE_START,
- ALPM_PROGRESS_CONFLICTS_START,
- ALPM_PROGRESS_DISKSPACE_START,
- ALPM_PROGRESS_INTEGRITY_START,
- ALPM_PROGRESS_LOAD_START,
- ALPM_PROGRESS_KEYRING_START
-} alpm_progress_t;
-
-/** Progress callback */
-typedef void (*alpm_cb_progress)(alpm_progress_t, const char *, int, size_t, size_t);
-
-/*
- * Downloading
- */
-
-/** Type of download progress callbacks.
- * @param filename the name of the file being downloaded
- * @param xfered the number of transferred bytes
- * @param total the total number of bytes to transfer
- */
-typedef void (*alpm_cb_download)(const char *filename,
- off_t xfered, off_t total);
-
-typedef void (*alpm_cb_totaldl)(off_t total);
-
-/** A callback for downloading files
- * @param url the URL of the file to be downloaded
- * @param localpath the directory to which the file should be downloaded
- * @param force whether to force an update, even if the file is the same
- * @return 0 on success, 1 if the file exists and is identical, -1 on
- * error.
- */
-typedef int (*alpm_cb_fetch)(const char *url, const char *localpath,
- int force);
-
-/** Fetch a remote pkg.
- * @param handle the context handle
- * @param url URL of the package to download
- * @return the downloaded filepath on success, NULL on error
- */
-char *alpm_fetch_pkgurl(alpm_handle_t *handle, const char *url);
-
-/** @addtogroup alpm_api_options Options
- * Libalpm option getters and setters
- * @{
- */
-
-/** Returns the callback used for logging. */
-alpm_cb_log alpm_option_get_logcb(alpm_handle_t *handle);
-/** Sets the callback used for logging. */
-int alpm_option_set_logcb(alpm_handle_t *handle, alpm_cb_log cb);
-
-/** Returns the callback used to report download progress. */
-alpm_cb_download alpm_option_get_dlcb(alpm_handle_t *handle);
-/** Sets the callback used to report download progress. */
-int alpm_option_set_dlcb(alpm_handle_t *handle, alpm_cb_download cb);
-
-/** Returns the downloading callback. */
-alpm_cb_fetch alpm_option_get_fetchcb(alpm_handle_t *handle);
-/** Sets the downloading callback. */
-int alpm_option_set_fetchcb(alpm_handle_t *handle, alpm_cb_fetch cb);
-
-/** Returns the callback used to report total download size. */
-alpm_cb_totaldl alpm_option_get_totaldlcb(alpm_handle_t *handle);
-/** Sets the callback used to report total download size. */
-int alpm_option_set_totaldlcb(alpm_handle_t *handle, alpm_cb_totaldl cb);
-
-/** Returns the callback used for events. */
-alpm_cb_event alpm_option_get_eventcb(alpm_handle_t *handle);
-/** Sets the callback used for events. */
-int alpm_option_set_eventcb(alpm_handle_t *handle, alpm_cb_event cb);
-
-/** Returns the callback used for questions. */
-alpm_cb_question alpm_option_get_questioncb(alpm_handle_t *handle);
-/** Sets the callback used for questions. */
-int alpm_option_set_questioncb(alpm_handle_t *handle, alpm_cb_question cb);
-
-/** Returns the callback used for operation progress. */
-alpm_cb_progress alpm_option_get_progresscb(alpm_handle_t *handle);
-/** Sets the callback used for operation progress. */
-int alpm_option_set_progresscb(alpm_handle_t *handle, alpm_cb_progress cb);
-
-/** Returns the root of the destination filesystem. Read-only. */
-const char *alpm_option_get_root(alpm_handle_t *handle);
-
-/** Returns the path to the database directory. Read-only. */
-const char *alpm_option_get_dbpath(alpm_handle_t *handle);
-
-/** Get the name of the database lock file. Read-only. */
-const char *alpm_option_get_lockfile(alpm_handle_t *handle);
-
-/** @name Accessors to the list of package cache directories.
- * @{
- */
-alpm_list_t *alpm_option_get_cachedirs(alpm_handle_t *handle);
-int alpm_option_set_cachedirs(alpm_handle_t *handle, alpm_list_t *cachedirs);
-int alpm_option_add_cachedir(alpm_handle_t *handle, const char *cachedir);
-int alpm_option_remove_cachedir(alpm_handle_t *handle, const char *cachedir);
-/** @} */
-
-/** Returns the logfile name. */
-const char *alpm_option_get_logfile(alpm_handle_t *handle);
-/** Sets the logfile name. */
-int alpm_option_set_logfile(alpm_handle_t *handle, const char *logfile);
-
-/** Returns the path to libalpm's GnuPG home directory. */
-const char *alpm_option_get_gpgdir(alpm_handle_t *handle);
-/** Sets the path to libalpm's GnuPG home directory. */
-int alpm_option_set_gpgdir(alpm_handle_t *handle, const char *gpgdir);
-
-/** Returns whether to use syslog (0 is FALSE, TRUE otherwise). */
-int alpm_option_get_usesyslog(alpm_handle_t *handle);
-/** Sets whether to use syslog (0 is FALSE, TRUE otherwise). */
-int alpm_option_set_usesyslog(alpm_handle_t *handle, int usesyslog);
-
-/** @name Accessors to the list of no-upgrade files.
- * These functions modify the list of files which should
- * not be updated by package installation.
- * @{
- */
-alpm_list_t *alpm_option_get_noupgrades(alpm_handle_t *handle);
-int alpm_option_add_noupgrade(alpm_handle_t *handle, const char *path);
-int alpm_option_set_noupgrades(alpm_handle_t *handle, alpm_list_t *noupgrade);
-int alpm_option_remove_noupgrade(alpm_handle_t *handle, const char *path);
-int alpm_option_match_noupgrade(alpm_handle_t *handle, const char *path);
-/** @} */
-
-/** @name Accessors to the list of no-extract files.
- * These functions modify the list of filenames which should
- * be skipped packages which should
- * not be upgraded by a sysupgrade operation.
- * @{
- */
-alpm_list_t *alpm_option_get_noextracts(alpm_handle_t *handle);
-int alpm_option_add_noextract(alpm_handle_t *handle, const char *path);
-int alpm_option_set_noextracts(alpm_handle_t *handle, alpm_list_t *noextract);
-int alpm_option_remove_noextract(alpm_handle_t *handle, const char *path);
-int alpm_option_match_noextract(alpm_handle_t *handle, const char *path);
-/** @} */
-
-/** @name Accessors to the list of ignored packages.
- * These functions modify the list of packages that
- * should be ignored by a sysupgrade.
- * @{
- */
-alpm_list_t *alpm_option_get_ignorepkgs(alpm_handle_t *handle);
-int alpm_option_add_ignorepkg(alpm_handle_t *handle, const char *pkg);
-int alpm_option_set_ignorepkgs(alpm_handle_t *handle, alpm_list_t *ignorepkgs);
-int alpm_option_remove_ignorepkg(alpm_handle_t *handle, const char *pkg);
-/** @} */
-
-/** @name Accessors to the list of ignored groups.
- * These functions modify the list of groups whose packages
- * should be ignored by a sysupgrade.
- * @{
- */
-alpm_list_t *alpm_option_get_ignoregroups(alpm_handle_t *handle);
-int alpm_option_add_ignoregroup(alpm_handle_t *handle, const char *grp);
-int alpm_option_set_ignoregroups(alpm_handle_t *handle, alpm_list_t *ignoregrps);
-int alpm_option_remove_ignoregroup(alpm_handle_t *handle, const char *grp);
-/** @} */
-
-/** @name Accessors to the list of ignored dependencies.
- * These functions modify the list of dependencies that
- * should be ignored by a sysupgrade.
- * @{
- */
-alpm_list_t *alpm_option_get_assumeinstalled(alpm_handle_t *handle);
-int alpm_option_add_assumeinstalled(alpm_handle_t *handle, const alpm_depend_t *dep);
-int alpm_option_set_assumeinstalled(alpm_handle_t *handle, alpm_list_t *deps);
-int alpm_option_remove_assumeinstalled(alpm_handle_t *handle, const alpm_depend_t *dep);
-/** @} */
-
-/** Returns the targeted architecture. */
-const char *alpm_option_get_arch(alpm_handle_t *handle);
-/** Sets the targeted architecture. */
-int alpm_option_set_arch(alpm_handle_t *handle, const char *arch);
-
-double alpm_option_get_deltaratio(alpm_handle_t *handle);
-int alpm_option_set_deltaratio(alpm_handle_t *handle, double ratio);
-
-int alpm_option_get_checkspace(alpm_handle_t *handle);
-int alpm_option_set_checkspace(alpm_handle_t *handle, int checkspace);
-
-alpm_siglevel_t alpm_option_get_default_siglevel(alpm_handle_t *handle);
-int alpm_option_set_default_siglevel(alpm_handle_t *handle, alpm_siglevel_t level);
-
-alpm_siglevel_t alpm_option_get_local_file_siglevel(alpm_handle_t *handle);
-int alpm_option_set_local_file_siglevel(alpm_handle_t *handle, alpm_siglevel_t level);
-
-alpm_siglevel_t alpm_option_get_remote_file_siglevel(alpm_handle_t *handle);
-int alpm_option_set_remote_file_siglevel(alpm_handle_t *handle, alpm_siglevel_t level);
-
-/** @} */
-
-/** @addtogroup alpm_api_databases Database Functions
- * Functions to query and manipulate the database of libalpm.
- * @{
- */
-
-/** Get the database of locally installed packages.
- * The returned pointer points to an internal structure
- * of libalpm which should only be manipulated through
- * libalpm functions.
- * @return a reference to the local database
- */
-alpm_db_t *alpm_get_localdb(alpm_handle_t *handle);
-
-/** Get the list of sync databases.
- * Returns a list of alpm_db_t structures, one for each registered
- * sync database.
- * @param handle the context handle
- * @return a reference to an internal list of alpm_db_t structures
- */
-alpm_list_t *alpm_get_syncdbs(alpm_handle_t *handle);
-
-/** Register a sync database of packages.
- * @param handle the context handle
- * @param treename the name of the sync repository
- * @param level what level of signature checking to perform on the
- * database; note that this must be a '.sig' file type verification
- * @return an alpm_db_t* on success (the value), NULL on error
- */
-alpm_db_t *alpm_register_syncdb(alpm_handle_t *handle, const char *treename,
- alpm_siglevel_t level);
-
-/** Unregister all package databases.
- * @param handle the context handle
- * @return 0 on success, -1 on error (pm_errno is set accordingly)
- */
-int alpm_unregister_all_syncdbs(alpm_handle_t *handle);
-
-/** Unregister a package database.
- * @param db pointer to the package database to unregister
- * @return 0 on success, -1 on error (pm_errno is set accordingly)
- */
-int alpm_db_unregister(alpm_db_t *db);
-
-/** Get the name of a package database.
- * @param db pointer to the package database
- * @return the name of the package database, NULL on error
- */
-const char *alpm_db_get_name(const alpm_db_t *db);
-
-/** Get the signature verification level for a database.
- * Will return the default verification level if this database is set up
- * with ALPM_SIG_USE_DEFAULT.
- * @param db pointer to the package database
- * @return the signature verification level
- */
-alpm_siglevel_t alpm_db_get_siglevel(alpm_db_t *db);
-
-/** Check the validity of a database.
- * This is most useful for sync databases and verifying signature status.
- * If invalid, the handle error code will be set accordingly.
- * @param db pointer to the package database
- * @return 0 if valid, -1 if invalid (pm_errno is set accordingly)
- */
-int alpm_db_get_valid(alpm_db_t *db);
-
-/** @name Accessors to the list of servers for a database.
- * @{
- */
-alpm_list_t *alpm_db_get_servers(const alpm_db_t *db);
-int alpm_db_set_servers(alpm_db_t *db, alpm_list_t *servers);
-int alpm_db_add_server(alpm_db_t *db, const char *url);
-int alpm_db_remove_server(alpm_db_t *db, const char *url);
-/** @} */
-
-int alpm_db_update(int force, alpm_db_t *db);
-
-/** Get a package entry from a package database.
- * @param db pointer to the package database to get the package from
- * @param name of the package
- * @return the package entry on success, NULL on error
- */
-alpm_pkg_t *alpm_db_get_pkg(alpm_db_t *db, const char *name);
-
-/** Get the package cache of a package database.
- * @param db pointer to the package database to get the package from
- * @return the list of packages on success, NULL on error
- */
-alpm_list_t *alpm_db_get_pkgcache(alpm_db_t *db);
-
-/** Get a group entry from a package database.
- * @param db pointer to the package database to get the group from
- * @param name of the group
- * @return the groups entry on success, NULL on error
- */
-alpm_group_t *alpm_db_get_group(alpm_db_t *db, const char *name);
-
-/** Get the group cache of a package database.
- * @param db pointer to the package database to get the group from
- * @return the list of groups on success, NULL on error
- */
-alpm_list_t *alpm_db_get_groupcache(alpm_db_t *db);
-
-/** Searches a database with regular expressions.
- * @param db pointer to the package database to search in
- * @param needles a list of regular expressions to search for
- * @return the list of packages matching all regular expressions on success, NULL on error
- */
-alpm_list_t *alpm_db_search(alpm_db_t *db, const alpm_list_t *needles);
-
-typedef enum _alpm_db_usage_ {
- ALPM_DB_USAGE_SYNC = 1,
- ALPM_DB_USAGE_SEARCH = (1 << 1),
- ALPM_DB_USAGE_INSTALL = (1 << 2),
- ALPM_DB_USAGE_UPGRADE = (1 << 3),
- ALPM_DB_USAGE_ALL = (1 << 4) - 1,
-} alpm_db_usage_t;
-
-/** Sets the usage of a database.
- * @param db pointer to the package database to set the status for
- * @param usage a bitmask of alpm_db_usage_t values
- * @return 0 on success, or -1 on error
- */
-int alpm_db_set_usage(alpm_db_t *db, alpm_db_usage_t usage);
-
-/** Gets the usage of a database.
- * @param db pointer to the package database to get the status of
- * @param usage pointer to an alpm_db_usage_t to store db's status
- * @return 0 on success, or -1 on error
- */
-int alpm_db_get_usage(alpm_db_t *db, alpm_db_usage_t *usage);
-
-/** @} */
-
-/** @addtogroup alpm_api_packages Package Functions
- * Functions to manipulate libalpm packages
- * @{
- */
-
-/** 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().
- * @param handle the context handle
- * @param filename location of the package tarball
- * @param full whether to stop the load after metadata is read or continue
- * through the full archive
- * @param level what level of package signature checking to perform on the
- * package; note that this must be a '.sig' file type verification
- * @param pkg address of the package pointer
- * @return 0 on success, -1 on error (pm_errno is set accordingly)
- */
-int alpm_pkg_load(alpm_handle_t *handle, const char *filename, int full,
- alpm_siglevel_t level, alpm_pkg_t **pkg);
-
-/** Find a package in a list by name.
- * @param haystack a list of alpm_pkg_t
- * @param needle the package name
- * @return a pointer to the package if found or NULL
- */
-alpm_pkg_t *alpm_pkg_find(alpm_list_t *haystack, const char *needle);
-
-/** Free a package.
- * @param pkg package pointer to free
- * @return 0 on success, -1 on error (pm_errno is set accordingly)
- */
-int alpm_pkg_free(alpm_pkg_t *pkg);
-
-/** Check the integrity (with md5) of a package from the sync cache.
- * @param pkg package pointer
- * @return 0 on success, -1 on error (pm_errno is set accordingly)
- */
-int alpm_pkg_checkmd5sum(alpm_pkg_t *pkg);
-
-/** Compare two version strings and determine which one is 'newer'. */
-int alpm_pkg_vercmp(const char *a, const char *b);
-
-/** 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.
- * @param pkg a package
- * @return the list of packages requiring pkg
- */
-alpm_list_t *alpm_pkg_compute_requiredby(alpm_pkg_t *pkg);
-
-/** 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.
- * @param pkg a package
- * @return the list of packages optionally requiring pkg
- */
-alpm_list_t *alpm_pkg_compute_optionalfor(alpm_pkg_t *pkg);
-
-/** Test if a package should be ignored.
- * Checks if the package is ignored via IgnorePkg, or if the package is
- * in a group ignored via IgnoreGroup.
- * @param handle the context handle
- * @param pkg the package to test
- * @return 1 if the package should be ignored, 0 otherwise
- */
-int alpm_pkg_should_ignore(alpm_handle_t *handle, alpm_pkg_t *pkg);
-
-/** @name Package Property Accessors
- * Any pointer returned by these functions points to internal structures
- * allocated by libalpm. They should not be freed nor modified in any
- * way.
- * @{
- */
-
-/** Gets the name of the file from which the package was loaded.
- * @param pkg a pointer to package
- * @return a reference to an internal string
- */
-const char *alpm_pkg_get_filename(alpm_pkg_t *pkg);
-
-/** Returns the package base name.
- * @param pkg a pointer to package
- * @return a reference to an internal string
- */
-const char *alpm_pkg_get_base(alpm_pkg_t *pkg);
-
-/** Returns the package name.
- * @param pkg a pointer to package
- * @return a reference to an internal string
- */
-const char *alpm_pkg_get_name(alpm_pkg_t *pkg);
-
-/** 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.
- * @param pkg a pointer to package
- * @return a reference to an internal string
- */
-const char *alpm_pkg_get_version(alpm_pkg_t *pkg);
-
-/** Returns the origin of the package.
- * @return an alpm_pkgfrom_t constant, -1 on error
- */
-alpm_pkgfrom_t alpm_pkg_get_origin(alpm_pkg_t *pkg);
-
-/** Returns the package description.
- * @param pkg a pointer to package
- * @return a reference to an internal string
- */
-const char *alpm_pkg_get_desc(alpm_pkg_t *pkg);
-
-/** Returns the package URL.
- * @param pkg a pointer to package
- * @return a reference to an internal string
- */
-const char *alpm_pkg_get_url(alpm_pkg_t *pkg);
-
-/** Returns the build timestamp of the package.
- * @param pkg a pointer to package
- * @return the timestamp of the build time
- */
-alpm_time_t alpm_pkg_get_builddate(alpm_pkg_t *pkg);
-
-/** Returns the install timestamp of the package.
- * @param pkg a pointer to package
- * @return the timestamp of the install time
- */
-alpm_time_t alpm_pkg_get_installdate(alpm_pkg_t *pkg);
-
-/** Returns the packager's name.
- * @param pkg a pointer to package
- * @return a reference to an internal string
- */
-const char *alpm_pkg_get_packager(alpm_pkg_t *pkg);
-
-/** Returns the package's MD5 checksum as a string.
- * The returned string is a sequence of 32 lowercase hexadecimal digits.
- * @param pkg a pointer to package
- * @return a reference to an internal string
- */
-const char *alpm_pkg_get_md5sum(alpm_pkg_t *pkg);
-
-/** Returns the package's SHA256 checksum as a string.
- * The returned string is a sequence of 64 lowercase hexadecimal digits.
- * @param pkg a pointer to package
- * @return a reference to an internal string
- */
-const char *alpm_pkg_get_sha256sum(alpm_pkg_t *pkg);
-
-/** Returns the architecture for which the package was built.
- * @param pkg a pointer to package
- * @return a reference to an internal string
- */
-const char *alpm_pkg_get_arch(alpm_pkg_t *pkg);
-
-/** Returns the size of the package. This is only available for sync database
- * packages and package files, not those loaded from the local database.
- * @param pkg a pointer to package
- * @return the size of the package in bytes.
- */
-off_t alpm_pkg_get_size(alpm_pkg_t *pkg);
-
-/** Returns the installed size of the package.
- * @param pkg a pointer to package
- * @return the total size of files installed by the package.
- */
-off_t alpm_pkg_get_isize(alpm_pkg_t *pkg);
-
-/** Returns the package installation reason.
- * @param pkg a pointer to package
- * @return an enum member giving the install reason.
- */
-alpm_pkgreason_t alpm_pkg_get_reason(alpm_pkg_t *pkg);
-
-/** Returns the list of package licenses.
- * @param pkg a pointer to package
- * @return a pointer to an internal list of strings.
- */
-alpm_list_t *alpm_pkg_get_licenses(alpm_pkg_t *pkg);
-
-/** Returns the list of package groups.
- * @param pkg a pointer to package
- * @return a pointer to an internal list of strings.
- */
-alpm_list_t *alpm_pkg_get_groups(alpm_pkg_t *pkg);
-
-/** Returns the list of package dependencies as alpm_depend_t.
- * @param pkg a pointer to package
- * @return a reference to an internal list of alpm_depend_t structures.
- */
-alpm_list_t *alpm_pkg_get_depends(alpm_pkg_t *pkg);
-
-/** Returns the list of package optional dependencies.
- * @param pkg a pointer to package
- * @return a reference to an internal list of alpm_depend_t structures.
- */
-alpm_list_t *alpm_pkg_get_optdepends(alpm_pkg_t *pkg);
-
-/** Returns the list of packages conflicting with pkg.
- * @param pkg a pointer to package
- * @return a reference to an internal list of alpm_depend_t structures.
- */
-alpm_list_t *alpm_pkg_get_conflicts(alpm_pkg_t *pkg);
-
-/** Returns the list of packages provided by pkg.
- * @param pkg a pointer to package
- * @return a reference to an internal list of alpm_depend_t structures.
- */
-alpm_list_t *alpm_pkg_get_provides(alpm_pkg_t *pkg);
-
-/** Returns the list of available deltas for pkg.
- * @param pkg a pointer to package
- * @return a reference to an internal list of strings.
- */
-alpm_list_t *alpm_pkg_get_deltas(alpm_pkg_t *pkg);
-
-/** Returns the list of packages to be replaced by pkg.
- * @param pkg a pointer to package
- * @return a reference to an internal list of alpm_depend_t structures.
- */
-alpm_list_t *alpm_pkg_get_replaces(alpm_pkg_t *pkg);
-
-/** Returns the list of files installed by pkg.
- * The filenames are relative to the install root,
- * and do not include leading slashes.
- * @param pkg a pointer to package
- * @return a pointer to a filelist object containing a count and an array of
- * package file objects
- */
-alpm_filelist_t *alpm_pkg_get_files(alpm_pkg_t *pkg);
-
-/** Returns the list of files backed up when installing pkg.
- * @param pkg a pointer to package
- * @return a reference to a list of alpm_backup_t objects
- */
-alpm_list_t *alpm_pkg_get_backup(alpm_pkg_t *pkg);
-
-/** 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.
- * @param pkg a pointer to package
- * @return a pointer to the DB containing pkg, or NULL.
- */
-alpm_db_t *alpm_pkg_get_db(alpm_pkg_t *pkg);
-
-/** Returns the base64 encoded package signature.
- * @param pkg a pointer to package
- * @return a reference to an internal string
- */
-const char *alpm_pkg_get_base64_sig(alpm_pkg_t *pkg);
-
-/** Returns the method used to validate a package during install.
- * @param pkg a pointer to package
- * @return an enum member giving the validation method
- */
-alpm_pkgvalidation_t alpm_pkg_get_validation(alpm_pkg_t *pkg);
-
-/* End of alpm_pkg_t accessors */
-/* @} */
-
-/** 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.
- * @param pkg the package to read the changelog of (either file or db)
- * @return a 'file stream' to the package changelog
- */
-void *alpm_pkg_changelog_open(alpm_pkg_t *pkg);
-
-/** 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.
- * @param ptr a buffer to fill with raw changelog data
- * @param size the size of the buffer
- * @param pkg the package that the changelog is being read from
- * @param fp a 'file stream' to the package changelog
- * @return the number of characters read, or 0 if there is no more data or an
- * error occurred.
- */
-size_t alpm_pkg_changelog_read(void *ptr, size_t size,
- const alpm_pkg_t *pkg, void *fp);
-
-int alpm_pkg_changelog_close(const alpm_pkg_t *pkg, void *fp);
-
-/** Open a package mtree file for reading.
- * @param pkg the local package to read the changelog of
- * @return a archive structure for the package mtree file
- */
-struct archive *alpm_pkg_mtree_open(alpm_pkg_t *pkg);
-
-/** Read next entry from a package mtree file.
- * @param pkg the package that the mtree file is being read from
- * @param archive the archive structure reading from the mtree file
- * @param entry an archive_entry to store the entry header information
- * @return 0 if end of archive is reached, non-zero otherwise.
- */
-int alpm_pkg_mtree_next(const alpm_pkg_t *pkg, struct archive *archive,
- struct archive_entry **entry);
-
-int alpm_pkg_mtree_close(const alpm_pkg_t *pkg, struct archive *archive);
-
-/** Returns whether the package has an install scriptlet.
- * @return 0 if FALSE, TRUE otherwise
- */
-int alpm_pkg_has_scriptlet(alpm_pkg_t *pkg);
-
-/** Returns the size of download.
- * Returns the size of the files that will be downloaded to install a
- * package.
- * @param newpkg the new package to upgrade to
- * @return the size of the download
- */
-off_t alpm_pkg_download_size(alpm_pkg_t *newpkg);
-
-alpm_list_t *alpm_pkg_unused_deltas(alpm_pkg_t *pkg);
-
-/** 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.
- * @param pkg the package to update
- * @param reason the new install reason
- * @return 0 on success, -1 on error (pm_errno is set accordingly)
- */
-int alpm_pkg_set_reason(alpm_pkg_t *pkg, alpm_pkgreason_t reason);
-
-
-/* End of alpm_pkg */
-/** @} */
-
-/*
- * Filelists
- */
-
-/** Determines whether a package filelist contains a given path.
- * The provided path should be relative to the install root with no leading
- * slashes, e.g. "etc/localtime". When searching for directories, the path must
- * have a trailing slash.
- * @param filelist a pointer to a package filelist
- * @param path the path to search for in the package
- * @return a pointer to the matching file or NULL if not found
- */
-alpm_file_t *alpm_filelist_contains(alpm_filelist_t *filelist, const char *path);
-
-/*
- * Signatures
- */
-
-int alpm_pkg_check_pgp_signature(alpm_pkg_t *pkg, alpm_siglist_t *siglist);
-
-int alpm_db_check_pgp_signature(alpm_db_t *db, alpm_siglist_t *siglist);
-
-int alpm_siglist_cleanup(alpm_siglist_t *siglist);
-
-int alpm_decode_signature(const char *base64_data,
- unsigned char **data, size_t *data_len);
-
-int alpm_extract_keyid(alpm_handle_t *handle, const char *identifier,
- const unsigned char *sig, const size_t len, alpm_list_t **keys);
-
-/*
- * Groups
- */
-
-alpm_list_t *alpm_find_group_pkgs(alpm_list_t *dbs, const char *name);
-
-/*
- * Sync
- */
-
-alpm_pkg_t *alpm_sync_newversion(alpm_pkg_t *pkg, alpm_list_t *dbs_sync);
-
-/** @addtogroup alpm_api_trans Transaction Functions
- * Functions to manipulate libalpm transactions
- * @{
- */
-
-/** Transaction flags */
-typedef enum _alpm_transflag_t {
- /** Ignore dependency checks. */
- ALPM_TRANS_FLAG_NODEPS = 1,
- /** Ignore file conflicts and overwrite files. */
- ALPM_TRANS_FLAG_FORCE = (1 << 1),
- /** Delete files even if they are tagged as backup. */
- ALPM_TRANS_FLAG_NOSAVE = (1 << 2),
- /** Ignore version numbers when checking dependencies. */
- ALPM_TRANS_FLAG_NODEPVERSION = (1 << 3),
- /** Remove also any packages depending on a package being removed. */
- ALPM_TRANS_FLAG_CASCADE = (1 << 4),
- /** Remove packages and their unneeded deps (not explicitly installed). */
- ALPM_TRANS_FLAG_RECURSE = (1 << 5),
- /** Modify database but do not commit changes to the filesystem. */
- ALPM_TRANS_FLAG_DBONLY = (1 << 6),
- /* (1 << 7) flag can go here */
- /** Use ALPM_PKG_REASON_DEPEND when installing packages. */
- ALPM_TRANS_FLAG_ALLDEPS = (1 << 8),
- /** Only download packages and do not actually install. */
- ALPM_TRANS_FLAG_DOWNLOADONLY = (1 << 9),
- /** Do not execute install scriptlets after installing. */
- ALPM_TRANS_FLAG_NOSCRIPTLET = (1 << 10),
- /** Ignore dependency conflicts. */
- ALPM_TRANS_FLAG_NOCONFLICTS = (1 << 11),
- /* (1 << 12) flag can go here */
- /** Do not install a package if it is already installed and up to date. */
- ALPM_TRANS_FLAG_NEEDED = (1 << 13),
- /** Use ALPM_PKG_REASON_EXPLICIT when installing packages. */
- ALPM_TRANS_FLAG_ALLEXPLICIT = (1 << 14),
- /** Do not remove a package if it is needed by another one. */
- ALPM_TRANS_FLAG_UNNEEDED = (1 << 15),
- /** Remove also explicitly installed unneeded deps (use with ALPM_TRANS_FLAG_RECURSE). */
- ALPM_TRANS_FLAG_RECURSEALL = (1 << 16),
- /** Do not lock the database during the operation. */
- ALPM_TRANS_FLAG_NOLOCK = (1 << 17)
-} alpm_transflag_t;
-
-/** Returns the bitfield of flags for the current transaction.
- * @param handle the context handle
- * @return the bitfield of transaction flags
- */
-alpm_transflag_t alpm_trans_get_flags(alpm_handle_t *handle);
-
-/** Returns a list of packages added by the transaction.
- * @param handle the context handle
- * @return a list of alpm_pkg_t structures
- */
-alpm_list_t *alpm_trans_get_add(alpm_handle_t *handle);
-
-/** Returns the list of packages removed by the transaction.
- * @param handle the context handle
- * @return a list of alpm_pkg_t structures
- */
-alpm_list_t *alpm_trans_get_remove(alpm_handle_t *handle);
-
-/** Initialize the transaction.
- * @param handle the context handle
- * @param flags flags of the transaction (like nodeps, etc)
- * @return 0 on success, -1 on error (pm_errno is set accordingly)
- */
-int alpm_trans_init(alpm_handle_t *handle, alpm_transflag_t flags);
-
-/** Prepare a transaction.
- * @param handle the context handle
- * @param data the address of an alpm_list where a list
- * of alpm_depmissing_t objects is dumped (conflicting packages)
- * @return 0 on success, -1 on error (pm_errno is set accordingly)
- */
-int alpm_trans_prepare(alpm_handle_t *handle, alpm_list_t **data);
-
-/** Commit a transaction.
- * @param handle the context handle
- * @param data the address of an alpm_list where detailed description
- * of an error can be dumped (i.e. list of conflicting files)
- * @return 0 on success, -1 on error (pm_errno is set accordingly)
- */
-int alpm_trans_commit(alpm_handle_t *handle, alpm_list_t **data);
-
-/** Interrupt a transaction.
- * @param handle the context handle
- * @return 0 on success, -1 on error (pm_errno is set accordingly)
- */
-int alpm_trans_interrupt(alpm_handle_t *handle);
-
-/** Release a transaction.
- * @param handle the context handle
- * @return 0 on success, -1 on error (pm_errno is set accordingly)
- */
-int alpm_trans_release(alpm_handle_t *handle);
-/** @} */
-
-/** @name Common Transactions */
-/** @{ */
-
-/** Search for packages to upgrade and add them to the transaction.
- * @param handle the context handle
- * @param enable_downgrade allow downgrading of packages if the remote version is lower
- * @return 0 on success, -1 on error (pm_errno is set accordingly)
- */
-int alpm_sync_sysupgrade(alpm_handle_t *handle, int enable_downgrade);
-
-/** Add a package to the transaction.
- * If the package was loaded by alpm_pkg_load(), it will be freed upon
- * alpm_trans_release() invocation.
- * @param handle the context handle
- * @param pkg the package to add
- * @return 0 on success, -1 on error (pm_errno is set accordingly)
- */
-int alpm_add_pkg(alpm_handle_t *handle, alpm_pkg_t *pkg);
-
-/** Add a package removal action to the transaction.
- * @param handle the context handle
- * @param pkg the package to uninstall
- * @return 0 on success, -1 on error (pm_errno is set accordingly)
- */
-int alpm_remove_pkg(alpm_handle_t *handle, alpm_pkg_t *pkg);
-
-/** @} */
-
-/** @addtogroup alpm_api_depends Dependency Functions
- * Functions dealing with libalpm representation of dependency
- * information.
- * @{
- */
-
-alpm_list_t *alpm_checkdeps(alpm_handle_t *handle, alpm_list_t *pkglist,
- alpm_list_t *remove, alpm_list_t *upgrade, int reversedeps);
-alpm_pkg_t *alpm_find_satisfier(alpm_list_t *pkgs, const char *depstring);
-alpm_pkg_t *alpm_find_dbs_satisfier(alpm_handle_t *handle,
- alpm_list_t *dbs, const char *depstring);
-
-alpm_list_t *alpm_checkconflicts(alpm_handle_t *handle, alpm_list_t *pkglist);
-
-/** Returns a newly allocated string representing the dependency information.
- * @param dep a dependency info structure
- * @return a formatted string, e.g. "glibc>=2.12"
- */
-char *alpm_dep_compute_string(const alpm_depend_t *dep);
-
-/** Return a newly allocated dependency information parsed from a string
- * @param depstring a formatted string, e.g. "glibc=2.12"
- * @return a dependency info structure
- */
-alpm_depend_t *alpm_dep_from_string(const char *depstring);
-
-/** Free a dependency info structure
- * @param dep struct to free
- */
-void alpm_dep_free(alpm_depend_t *dep);
-
-/** @} */
-
-/** @} */
-
-/*
- * Helpers
- */
-
-/* checksums */
-char *alpm_compute_md5sum(const char *filename);
-char *alpm_compute_sha256sum(const char *filename);
-
-alpm_handle_t *alpm_initialize(const char *root, const char *dbpath,
- alpm_errno_t *err);
-int alpm_release(alpm_handle_t *handle);
-
-enum alpm_caps {
- ALPM_CAPABILITY_NLS = (1 << 0),
- ALPM_CAPABILITY_DOWNLOADER = (1 << 1),
- ALPM_CAPABILITY_SIGNATURES = (1 << 2)
-};
-
-const char *alpm_version(void);
-enum alpm_caps alpm_capabilities(void);
-
-void alpm_fileconflict_free(alpm_fileconflict_t *conflict);
-void alpm_depmissing_free(alpm_depmissing_t *miss);
-void alpm_conflict_free(alpm_conflict_t *conflict);
-
-/* End of alpm_api */
-/** @} */
-
-#ifdef __cplusplus
-}
-#endif
-#endif /* _ALPM_H */
-
-/* vim: set noet: */
diff --git a/lib/libalpm/alpm.h.in b/lib/libalpm/alpm.h.in
new file mode 100644
index 0000000..856220c
--- /dev/null
+++ b/lib/libalpm/alpm.h.in
@@ -0,0 +1,1596 @@
+/*
+ * alpm.h
+ *
+ * Copyright (c) 2006-2014 Pacman Development Team <pacman-dev(a)archlinux.org>
+ * Copyright (c) 2002-2006 by Judd Vinet <jvinet(a)zeroflux.org>
+ * Copyright (c) 2005 by Aurelien Foret <orelien(a)chez.com>
+ * Copyright (c) 2005 by Christian Hamar <krics(a)linuxforum.hu>
+ * Copyright (c) 2005, 2006 by Miklos Vajna <vmiklos(a)frugalware.org>
+ *
+ * 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. If not, see <http://www.gnu.org/licenses/>.
+ */
+#ifndef _ALPM_H
+#define _ALPM_H
+
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+#define ALPM_VERSION "@LIB_VERSION@"
+
+#define ALPM_VERSION_CURRENT @LIB_VERSION_CURRENT@
+#define ALPM_VERSION_REVISION @LIB_VERSION_REVISION@
+#define ALPM_VERSION_AGE @LIB_VERSION_AGE@
+
+#define ALPM_VERSION_NUMBER @LIB_VERSION_NUMBER@
+
+#include <stdint.h> /* int64_t */
+#include <sys/types.h> /* off_t */
+#include <stdarg.h> /* va_list */
+
+/* libarchive */
+#include <archive.h>
+#include <archive_entry.h>
+
+#include <alpm_list.h>
+
+/*
+ * Arch Linux Package Management library
+ */
+
+/*
+ * Opaque Structures
+ */
+typedef struct __alpm_handle_t alpm_handle_t;
+typedef struct __alpm_db_t alpm_db_t;
+typedef struct __alpm_pkg_t alpm_pkg_t;
+typedef struct __alpm_trans_t alpm_trans_t;
+
+/** @addtogroup alpm_api_errors Error Codes
+ * @{
+ */
+typedef enum _alpm_errno_t {
+ ALPM_ERR_MEMORY = 1,
+ ALPM_ERR_SYSTEM,
+ ALPM_ERR_BADPERMS,
+ ALPM_ERR_NOT_A_FILE,
+ ALPM_ERR_NOT_A_DIR,
+ ALPM_ERR_WRONG_ARGS,
+ ALPM_ERR_DISK_SPACE,
+ /* Interface */
+ ALPM_ERR_HANDLE_NULL,
+ ALPM_ERR_HANDLE_NOT_NULL,
+ ALPM_ERR_HANDLE_LOCK,
+ /* Databases */
+ ALPM_ERR_DB_OPEN,
+ ALPM_ERR_DB_CREATE,
+ ALPM_ERR_DB_NULL,
+ ALPM_ERR_DB_NOT_NULL,
+ ALPM_ERR_DB_NOT_FOUND,
+ ALPM_ERR_DB_INVALID,
+ ALPM_ERR_DB_INVALID_SIG,
+ ALPM_ERR_DB_VERSION,
+ ALPM_ERR_DB_WRITE,
+ ALPM_ERR_DB_REMOVE,
+ /* Servers */
+ ALPM_ERR_SERVER_BAD_URL,
+ ALPM_ERR_SERVER_NONE,
+ /* Transactions */
+ ALPM_ERR_TRANS_NOT_NULL,
+ ALPM_ERR_TRANS_NULL,
+ ALPM_ERR_TRANS_DUP_TARGET,
+ ALPM_ERR_TRANS_NOT_INITIALIZED,
+ ALPM_ERR_TRANS_NOT_PREPARED,
+ ALPM_ERR_TRANS_ABORT,
+ ALPM_ERR_TRANS_TYPE,
+ ALPM_ERR_TRANS_NOT_LOCKED,
+ /* Packages */
+ ALPM_ERR_PKG_NOT_FOUND,
+ ALPM_ERR_PKG_IGNORED,
+ ALPM_ERR_PKG_INVALID,
+ ALPM_ERR_PKG_INVALID_CHECKSUM,
+ ALPM_ERR_PKG_INVALID_SIG,
+ ALPM_ERR_PKG_MISSING_SIG,
+ ALPM_ERR_PKG_OPEN,
+ ALPM_ERR_PKG_CANT_REMOVE,
+ ALPM_ERR_PKG_INVALID_NAME,
+ ALPM_ERR_PKG_INVALID_ARCH,
+ ALPM_ERR_PKG_REPO_NOT_FOUND,
+ /* Signatures */
+ ALPM_ERR_SIG_MISSING,
+ ALPM_ERR_SIG_INVALID,
+ /* Deltas */
+ ALPM_ERR_DLT_INVALID,
+ ALPM_ERR_DLT_PATCHFAILED,
+ /* Dependencies */
+ ALPM_ERR_UNSATISFIED_DEPS,
+ ALPM_ERR_CONFLICTING_DEPS,
+ ALPM_ERR_FILE_CONFLICTS,
+ /* Misc */
+ ALPM_ERR_RETRIEVE,
+ ALPM_ERR_INVALID_REGEX,
+ /* External library errors */
+ ALPM_ERR_LIBARCHIVE,
+ ALPM_ERR_LIBCURL,
+ ALPM_ERR_EXTERNAL_DOWNLOAD,
+ ALPM_ERR_GPGME
+} alpm_errno_t;
+
+/** Returns the current error code from the handle. */
+alpm_errno_t alpm_errno(alpm_handle_t *handle);
+
+/** Returns the string corresponding to an error number. */
+const char *alpm_strerror(alpm_errno_t err);
+
+/* End of alpm_api_errors */
+/** @} */
+
+/** @addtogroup alpm_api Public API
+ * The libalpm Public API
+ * @{
+ */
+
+typedef int64_t alpm_time_t;
+
+/*
+ * Enumerations
+ * These ones are used in multiple contexts, so are forward-declared.
+ */
+
+/** Package install reasons. */
+typedef enum _alpm_pkgreason_t {
+ /** Explicitly requested by the user. */
+ ALPM_PKG_REASON_EXPLICIT = 0,
+ /** Installed as a dependency for another package. */
+ ALPM_PKG_REASON_DEPEND = 1
+} alpm_pkgreason_t;
+
+/** Location a package object was loaded from. */
+typedef enum _alpm_pkgfrom_t {
+ ALPM_PKG_FROM_FILE = 1,
+ ALPM_PKG_FROM_LOCALDB,
+ ALPM_PKG_FROM_SYNCDB
+} alpm_pkgfrom_t;
+
+/** Method used to validate a package. */
+typedef 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)
+} alpm_pkgvalidation_t;
+
+/** Types of version constraints in dependency specs. */
+typedef enum _alpm_depmod_t {
+ /** No version constraint */
+ ALPM_DEP_MOD_ANY = 1,
+ /** Test version equality (package=x.y.z) */
+ ALPM_DEP_MOD_EQ,
+ /** Test for at least a version (package>=x.y.z) */
+ ALPM_DEP_MOD_GE,
+ /** Test for at most a version (package<=x.y.z) */
+ ALPM_DEP_MOD_LE,
+ /** Test for greater than some version (package>x.y.z) */
+ ALPM_DEP_MOD_GT,
+ /** Test for less than some version (package<x.y.z) */
+ ALPM_DEP_MOD_LT
+} alpm_depmod_t;
+
+/**
+ * File conflict type.
+ * Whether the conflict results from a file existing on the filesystem, or with
+ * another target in the transaction.
+ */
+typedef enum _alpm_fileconflicttype_t {
+ ALPM_FILECONFLICT_TARGET = 1,
+ ALPM_FILECONFLICT_FILESYSTEM
+} alpm_fileconflicttype_t;
+
+/** PGP signature verification options */
+typedef enum _alpm_siglevel_t {
+ ALPM_SIG_PACKAGE = (1 << 0),
+ ALPM_SIG_PACKAGE_OPTIONAL = (1 << 1),
+ ALPM_SIG_PACKAGE_MARGINAL_OK = (1 << 2),
+ ALPM_SIG_PACKAGE_UNKNOWN_OK = (1 << 3),
+
+ ALPM_SIG_DATABASE = (1 << 10),
+ ALPM_SIG_DATABASE_OPTIONAL = (1 << 11),
+ ALPM_SIG_DATABASE_MARGINAL_OK = (1 << 12),
+ ALPM_SIG_DATABASE_UNKNOWN_OK = (1 << 13),
+
+ ALPM_SIG_PACKAGE_SET = (1 << 27),
+ ALPM_SIG_PACKAGE_TRUST_SET = (1 << 28),
+
+ ALPM_SIG_USE_DEFAULT = (1 << 31)
+} alpm_siglevel_t;
+
+/** PGP signature verification status return codes */
+typedef enum _alpm_sigstatus_t {
+ ALPM_SIGSTATUS_VALID,
+ ALPM_SIGSTATUS_KEY_EXPIRED,
+ ALPM_SIGSTATUS_SIG_EXPIRED,
+ ALPM_SIGSTATUS_KEY_UNKNOWN,
+ ALPM_SIGSTATUS_KEY_DISABLED,
+ ALPM_SIGSTATUS_INVALID
+} alpm_sigstatus_t;
+
+/** PGP signature verification status return codes */
+typedef enum _alpm_sigvalidity_t {
+ ALPM_SIGVALIDITY_FULL,
+ ALPM_SIGVALIDITY_MARGINAL,
+ ALPM_SIGVALIDITY_NEVER,
+ ALPM_SIGVALIDITY_UNKNOWN
+} alpm_sigvalidity_t;
+
+/*
+ * Structures
+ */
+
+/** Dependency */
+typedef struct _alpm_depend_t {
+ char *name;
+ char *version;
+ char *desc;
+ unsigned long name_hash;
+ alpm_depmod_t mod;
+} alpm_depend_t;
+
+/** Missing dependency */
+typedef struct _alpm_depmissing_t {
+ char *target;
+ alpm_depend_t *depend;
+ /* this is used only in the case of a remove dependency error */
+ char *causingpkg;
+} alpm_depmissing_t;
+
+/** Conflict */
+typedef struct _alpm_conflict_t {
+ unsigned long package1_hash;
+ unsigned long package2_hash;
+ char *package1;
+ char *package2;
+ alpm_depend_t *reason;
+} alpm_conflict_t;
+
+/** File conflict */
+typedef struct _alpm_fileconflict_t {
+ char *target;
+ alpm_fileconflicttype_t type;
+ char *file;
+ char *ctarget;
+} alpm_fileconflict_t;
+
+/** Package group */
+typedef struct _alpm_group_t {
+ /** group name */
+ char *name;
+ /** list of alpm_pkg_t packages */
+ alpm_list_t *packages;
+} alpm_group_t;
+
+/** Package upgrade delta */
+typedef struct _alpm_delta_t {
+ /** filename of the delta patch */
+ char *delta;
+ /** md5sum of the delta file */
+ char *delta_md5;
+ /** filename of the 'before' file */
+ char *from;
+ /** filename of the 'after' file */
+ char *to;
+ /** filesize of the delta file */
+ off_t delta_size;
+ /** download filesize of the delta file */
+ off_t download_size;
+} alpm_delta_t;
+
+/** File in a package */
+typedef struct _alpm_file_t {
+ char *name;
+ off_t size;
+ mode_t mode;
+} alpm_file_t;
+
+/** Package filelist container */
+typedef struct _alpm_filelist_t {
+ size_t count;
+ alpm_file_t *files;
+} alpm_filelist_t;
+
+/** Local package or package file backup entry */
+typedef struct _alpm_backup_t {
+ char *name;
+ char *hash;
+} alpm_backup_t;
+
+typedef struct _alpm_pgpkey_t {
+ void *data;
+ char *fingerprint;
+ char *uid;
+ char *name;
+ char *email;
+ alpm_time_t created;
+ alpm_time_t expires;
+ unsigned int length;
+ unsigned int revoked;
+ char pubkey_algo;
+} alpm_pgpkey_t;
+
+/**
+ * Signature result. Contains the key, status, and validity of a given
+ * signature.
+ */
+typedef struct _alpm_sigresult_t {
+ alpm_pgpkey_t key;
+ alpm_sigstatus_t status;
+ alpm_sigvalidity_t validity;
+} alpm_sigresult_t;
+
+/**
+ * Signature list. Contains the number of signatures found and a pointer to an
+ * array of results. The array is of size count.
+ */
+typedef struct _alpm_siglist_t {
+ size_t count;
+ alpm_sigresult_t *results;
+} alpm_siglist_t;
+
+/*
+ * Logging facilities
+ */
+
+/** Logging Levels */
+typedef enum _alpm_loglevel_t {
+ ALPM_LOG_ERROR = 1,
+ ALPM_LOG_WARNING = (1 << 1),
+ ALPM_LOG_DEBUG = (1 << 2),
+ ALPM_LOG_FUNCTION = (1 << 3)
+} alpm_loglevel_t;
+
+typedef void (*alpm_cb_log)(alpm_loglevel_t, const char *, va_list);
+
+int alpm_logaction(alpm_handle_t *handle, const char *prefix,
+ const char *fmt, ...) __attribute__((format(printf, 3, 4)));
+
+/**
+ * Type of events.
+ */
+typedef enum _alpm_event_type_t {
+ /** Dependencies will be computed for a package. */
+ ALPM_EVENT_CHECKDEPS_START = 1,
+ /** Dependencies were computed for a package. */
+ ALPM_EVENT_CHECKDEPS_DONE,
+ /** File conflicts will be computed for a package. */
+ ALPM_EVENT_FILECONFLICTS_START,
+ /** File conflicts were computed for a package. */
+ ALPM_EVENT_FILECONFLICTS_DONE,
+ /** Dependencies will be resolved for target package. */
+ ALPM_EVENT_RESOLVEDEPS_START,
+ /** Dependencies were resolved for target package. */
+ ALPM_EVENT_RESOLVEDEPS_DONE,
+ /** Inter-conflicts will be checked for target package. */
+ ALPM_EVENT_INTERCONFLICTS_START,
+ /** Inter-conflicts were checked for target package. */
+ ALPM_EVENT_INTERCONFLICTS_DONE,
+ /** Package will be installed/upgraded/downgraded/re-installed/removed; See
+ * alpm_event_package_operation_t for arguments. */
+ ALPM_EVENT_PACKAGE_OPERATION_START,
+ /** Package was installed/upgraded/downgraded/re-installed/removed; See
+ * alpm_event_package_operation_t for arguments. */
+ ALPM_EVENT_PACKAGE_OPERATION_DONE,
+ /** Target package's integrity will be checked. */
+ ALPM_EVENT_INTEGRITY_START,
+ /** Target package's integrity was checked. */
+ ALPM_EVENT_INTEGRITY_DONE,
+ /** Target package will be loaded. */
+ ALPM_EVENT_LOAD_START,
+ /** Target package is finished loading. */
+ ALPM_EVENT_LOAD_DONE,
+ /** Target delta's integrity will be checked. */
+ ALPM_EVENT_DELTA_INTEGRITY_START,
+ /** Target delta's integrity was checked. */
+ ALPM_EVENT_DELTA_INTEGRITY_DONE,
+ /** Deltas will be applied to packages. */
+ ALPM_EVENT_DELTA_PATCHES_START,
+ /** Deltas were applied to packages. */
+ ALPM_EVENT_DELTA_PATCHES_DONE,
+ /** Delta patch will be applied to target package; See
+ * alpm_event_delta_patch_t for arguments.. */
+ ALPM_EVENT_DELTA_PATCH_START,
+ /** Delta patch was applied to target package. */
+ ALPM_EVENT_DELTA_PATCH_DONE,
+ /** Delta patch failed to apply to target package. */
+ ALPM_EVENT_DELTA_PATCH_FAILED,
+ /** Scriptlet has printed information; See alpm_event_scriptlet_info_t for
+ * arguments. */
+ ALPM_EVENT_SCRIPTLET_INFO,
+ /** Files will be downloaded from a repository. */
+ ALPM_EVENT_RETRIEVE_START,
+ /** Files were downloaded from a repository. */
+ ALPM_EVENT_RETRIEVE_DONE,
+ /** Not all files were successfully downloaded from a repository. */
+ ALPM_EVENT_RETRIEVE_FAILED,
+ /** A file will be downloaded from a repository; See alpm_event_pkgdownload_t
+ * for arguments */
+ ALPM_EVENT_PKGDOWNLOAD_START,
+ /** A file was downloaded from a repository; See alpm_event_pkgdownload_t
+ * for arguments */
+ ALPM_EVENT_PKGDOWNLOAD_DONE,
+ /** A file failed to be downloaded from a repository; See
+ * alpm_event_pkgdownload_t for arguments */
+ ALPM_EVENT_PKGDOWNLOAD_FAILED,
+ /** Disk space usage will be computed for a package. */
+ ALPM_EVENT_DISKSPACE_START,
+ /** Disk space usage was computed for a package. */
+ ALPM_EVENT_DISKSPACE_DONE,
+ /** An optdepend for another package is being removed; See
+ * alpm_event_optdep_removal_t for arguments. */
+ ALPM_EVENT_OPTDEP_REMOVAL,
+ /** A configured repository database is missing; See
+ * alpm_event_database_missing_t for arguments. */
+ ALPM_EVENT_DATABASE_MISSING,
+ /** Checking keys used to create signatures are in keyring. */
+ ALPM_EVENT_KEYRING_START,
+ /** Keyring checking is finished. */
+ ALPM_EVENT_KEYRING_DONE,
+ /** Downloading missing keys into keyring. */
+ ALPM_EVENT_KEY_DOWNLOAD_START,
+ /** Key downloading is finished. */
+ ALPM_EVENT_KEY_DOWNLOAD_DONE,
+ /** A .pacnew file was created; See alpm_event_pacnew_created_t for arguments. */
+ ALPM_EVENT_PACNEW_CREATED,
+ /** A .pacsave file was created; See alpm_event_pacsave_created_t for
+ * arguments */
+ ALPM_EVENT_PACSAVE_CREATED,
+ /** A .pacorig file was created; See alpm_event_pacorig_created_t for
+ * arguments */
+ ALPM_EVENT_PACORIG_CREATED
+} alpm_event_type_t;
+
+typedef struct _alpm_event_any_t {
+ /** Type of event. */
+ alpm_event_type_t type;
+} alpm_event_any_t;
+
+typedef enum _alpm_package_operation_t {
+ /** Package (to be) installed. (No oldpkg) */
+ ALPM_PACKAGE_INSTALL = 1,
+ /** Package (to be) upgraded */
+ ALPM_PACKAGE_UPGRADE,
+ /** Package (to be) re-installed. */
+ ALPM_PACKAGE_REINSTALL,
+ /** Package (to be) downgraded. */
+ ALPM_PACKAGE_DOWNGRADE,
+ /** Package (to be) removed. (No newpkg) */
+ ALPM_PACKAGE_REMOVE
+} alpm_package_operation_t;
+
+typedef struct _alpm_event_package_operation_t {
+ /** Type of event. */
+ alpm_event_type_t type;
+ /** Type of operation. */
+ alpm_package_operation_t operation;
+ /** Old package. */
+ alpm_pkg_t *oldpkg;
+ /** New package. */
+ alpm_pkg_t *newpkg;
+} alpm_event_package_operation_t;
+
+typedef struct _alpm_event_optdep_removal_t {
+ /** Type of event. */
+ alpm_event_type_t type;
+ /** Package with the optdep. */
+ alpm_pkg_t *pkg;
+ /** Optdep being removed. */
+ alpm_depend_t *optdep;
+} alpm_event_optdep_removal_t;
+
+typedef struct _alpm_event_delta_patch_t {
+ /** Type of event. */
+ alpm_event_type_t type;
+ /** Delta info */
+ alpm_delta_t *delta;
+} alpm_event_delta_patch_t;
+
+typedef struct _alpm_event_scriptlet_info_t {
+ /** Type of event. */
+ alpm_event_type_t type;
+ /** Line of scriptlet output. */
+ const char *line;
+} alpm_event_scriptlet_info_t;
+
+typedef struct _alpm_event_database_missing_t {
+ /** Type of event. */
+ alpm_event_type_t type;
+ /** Name of the database. */
+ const char *dbname;
+} alpm_event_database_missing_t;
+
+typedef struct _alpm_event_pkgdownload_t {
+ /** Type of event. */
+ alpm_event_type_t type;
+ /** Name of the file */
+ const char *file;
+} alpm_event_pkgdownload_t;
+
+typedef struct _alpm_event_pacnew_created_t {
+ /** Type of event. */
+ alpm_event_type_t type;
+ /** Whether the creation was result of a NoUpgrade or not */
+ int from_noupgrade;
+ /** Old package. */
+ alpm_pkg_t *oldpkg;
+ /** New Package. */
+ alpm_pkg_t *newpkg;
+ /** Filename of the file without the .pacnew suffix */
+ const char *file;
+} alpm_event_pacnew_created_t;
+
+typedef struct _alpm_event_pacsave_created_t {
+ /** Type of event. */
+ alpm_event_type_t type;
+ /** Old package. */
+ alpm_pkg_t *oldpkg;
+ /** Filename of the file without the .pacsave suffix. */
+ const char *file;
+} alpm_event_pacsave_created_t;
+
+typedef struct _alpm_event_pacorig_created_t {
+ /** Type of event. */
+ alpm_event_type_t type;
+ /** New package. */
+ alpm_pkg_t *newpkg;
+ /** Filename of the file without the .pacorig suffix. */
+ const char *file;
+} alpm_event_pacorig_created_t;
+
+/** Events.
+ * This is an union passed to the callback, that allows the frontend to know
+ * which type of event was triggered (via type). It is then possible to
+ * typecast the pointer to the right structure, or use the union field, in order
+ * to access event-specific data. */
+typedef union _alpm_event_t {
+ alpm_event_type_t type;
+ alpm_event_any_t any;
+ alpm_event_package_operation_t package_operation;
+ alpm_event_optdep_removal_t optdep_removal;
+ alpm_event_delta_patch_t delta_patch;
+ alpm_event_scriptlet_info_t scriptlet_info;
+ alpm_event_database_missing_t database_missing;
+ alpm_event_pkgdownload_t pkgdownload;
+ alpm_event_pacnew_created_t pacnew_created;
+ alpm_event_pacsave_created_t pacsave_created;
+ alpm_event_pacorig_created_t pacorig_created;
+} alpm_event_t;
+
+/** Event callback. */
+typedef void (*alpm_cb_event)(alpm_event_t *);
+
+/**
+ * Type of questions.
+ * Unlike the events or progress enumerations, this enum has bitmask values
+ * so a frontend can use a bitmask map to supply preselected answers to the
+ * different types of questions.
+ */
+typedef enum _alpm_question_type_t {
+ ALPM_QUESTION_INSTALL_IGNOREPKG = (1 << 0),
+ ALPM_QUESTION_REPLACE_PKG = (1 << 1),
+ ALPM_QUESTION_CONFLICT_PKG = (1 << 2),
+ ALPM_QUESTION_CORRUPTED_PKG = (1 << 3),
+ ALPM_QUESTION_REMOVE_PKGS = (1 << 4),
+ ALPM_QUESTION_SELECT_PROVIDER = (1 << 5),
+ ALPM_QUESTION_IMPORT_KEY = (1 << 6)
+} alpm_question_type_t;
+
+typedef struct _alpm_question_any_t {
+ /** Type of question. */
+ alpm_question_type_t type;
+ /** Answer. */
+ int answer;
+} alpm_question_any_t;
+
+typedef struct _alpm_question_install_ignorepkg_t {
+ /** Type of question. */
+ alpm_question_type_t type;
+ /** Answer: whether or not to install pkg anyway. */
+ int install;
+ /* Package in IgnorePkg/IgnoreGroup. */
+ alpm_pkg_t *pkg;
+} alpm_question_install_ignorepkg_t;
+
+typedef struct _alpm_question_replace_t {
+ /** Type of question. */
+ alpm_question_type_t type;
+ /** Answer: whether or not to replace oldpkg with newpkg. */
+ int replace;
+ /* Package to be replaced. */
+ alpm_pkg_t *oldpkg;
+ /* Package to replace with. */
+ alpm_pkg_t *newpkg;
+ /* DB of newpkg */
+ alpm_db_t *newdb;
+} alpm_question_replace_t;
+
+typedef struct _alpm_question_conflict_t {
+ /** Type of question. */
+ alpm_question_type_t type;
+ /** Answer: whether or not to remove conflict->package2. */
+ int remove;
+ /** Conflict info. */
+ alpm_conflict_t *conflict;
+} alpm_question_conflict_t;
+
+typedef struct _alpm_question_corrupted_t {
+ /** Type of question. */
+ alpm_question_type_t type;
+ /** Answer: whether or not to remove filepath. */
+ int remove;
+ /** Filename to remove */
+ const char *filepath;
+ /** Error code indicating the reason for package invalidity */
+ alpm_errno_t reason;
+} alpm_question_corrupted_t;
+
+typedef struct _alpm_question_remove_pkgs_t {
+ /** Type of question. */
+ alpm_question_type_t type;
+ /** Answer: whether or not to skip packages. */
+ int skip;
+ /** List of alpm_pkg_t* with unresolved dependencies. */
+ alpm_list_t *packages;
+} alpm_question_remove_pkgs_t;
+
+typedef struct _alpm_question_select_provider_t {
+ /** Type of question. */
+ alpm_question_type_t type;
+ /** Answer: which provider to use (index from providers). */
+ int use_index;
+ /** List of alpm_pkg_t* as possible providers. */
+ alpm_list_t *providers;
+ /** What providers provide for. */
+ alpm_depend_t *depend;
+} alpm_question_select_provider_t;
+
+typedef struct _alpm_question_import_key_t {
+ /** Type of question. */
+ alpm_question_type_t type;
+ /** Answer: whether or not to import key. */
+ int import;
+ /** The key to import. */
+ alpm_pgpkey_t *key;
+} alpm_question_import_key_t;
+
+/**
+ * Questions.
+ * This is an union passed to the callback, that allows the frontend to know
+ * which type of question was triggered (via type). It is then possible to
+ * typecast the pointer to the right structure, or use the union field, in order
+ * to access question-specific data. */
+typedef union _alpm_question_t {
+ alpm_question_type_t type;
+ alpm_question_any_t any;
+ alpm_question_install_ignorepkg_t install_ignorepkg;
+ alpm_question_replace_t replace;
+ alpm_question_conflict_t conflict;
+ alpm_question_corrupted_t corrupted;
+ alpm_question_remove_pkgs_t remove_pkgs;
+ alpm_question_select_provider_t select_provider;
+ alpm_question_import_key_t import_key;
+} alpm_question_t;
+
+/** Question callback */
+typedef void (*alpm_cb_question)(alpm_question_t *);
+
+/** Progress */
+typedef enum _alpm_progress_t {
+ ALPM_PROGRESS_ADD_START,
+ ALPM_PROGRESS_UPGRADE_START,
+ ALPM_PROGRESS_DOWNGRADE_START,
+ ALPM_PROGRESS_REINSTALL_START,
+ ALPM_PROGRESS_REMOVE_START,
+ ALPM_PROGRESS_CONFLICTS_START,
+ ALPM_PROGRESS_DISKSPACE_START,
+ ALPM_PROGRESS_INTEGRITY_START,
+ ALPM_PROGRESS_LOAD_START,
+ ALPM_PROGRESS_KEYRING_START
+} alpm_progress_t;
+
+/** Progress callback */
+typedef void (*alpm_cb_progress)(alpm_progress_t, const char *, int, size_t, size_t);
+
+/*
+ * Downloading
+ */
+
+/** Type of download progress callbacks.
+ * @param filename the name of the file being downloaded
+ * @param xfered the number of transferred bytes
+ * @param total the total number of bytes to transfer
+ */
+typedef void (*alpm_cb_download)(const char *filename,
+ off_t xfered, off_t total);
+
+typedef void (*alpm_cb_totaldl)(off_t total);
+
+/** A callback for downloading files
+ * @param url the URL of the file to be downloaded
+ * @param localpath the directory to which the file should be downloaded
+ * @param force whether to force an update, even if the file is the same
+ * @return 0 on success, 1 if the file exists and is identical, -1 on
+ * error.
+ */
+typedef int (*alpm_cb_fetch)(const char *url, const char *localpath,
+ int force);
+
+/** Fetch a remote pkg.
+ * @param handle the context handle
+ * @param url URL of the package to download
+ * @return the downloaded filepath on success, NULL on error
+ */
+char *alpm_fetch_pkgurl(alpm_handle_t *handle, const char *url);
+
+/** @addtogroup alpm_api_options Options
+ * Libalpm option getters and setters
+ * @{
+ */
+
+/** Returns the callback used for logging. */
+alpm_cb_log alpm_option_get_logcb(alpm_handle_t *handle);
+/** Sets the callback used for logging. */
+int alpm_option_set_logcb(alpm_handle_t *handle, alpm_cb_log cb);
+
+/** Returns the callback used to report download progress. */
+alpm_cb_download alpm_option_get_dlcb(alpm_handle_t *handle);
+/** Sets the callback used to report download progress. */
+int alpm_option_set_dlcb(alpm_handle_t *handle, alpm_cb_download cb);
+
+/** Returns the downloading callback. */
+alpm_cb_fetch alpm_option_get_fetchcb(alpm_handle_t *handle);
+/** Sets the downloading callback. */
+int alpm_option_set_fetchcb(alpm_handle_t *handle, alpm_cb_fetch cb);
+
+/** Returns the callback used to report total download size. */
+alpm_cb_totaldl alpm_option_get_totaldlcb(alpm_handle_t *handle);
+/** Sets the callback used to report total download size. */
+int alpm_option_set_totaldlcb(alpm_handle_t *handle, alpm_cb_totaldl cb);
+
+/** Returns the callback used for events. */
+alpm_cb_event alpm_option_get_eventcb(alpm_handle_t *handle);
+/** Sets the callback used for events. */
+int alpm_option_set_eventcb(alpm_handle_t *handle, alpm_cb_event cb);
+
+/** Returns the callback used for questions. */
+alpm_cb_question alpm_option_get_questioncb(alpm_handle_t *handle);
+/** Sets the callback used for questions. */
+int alpm_option_set_questioncb(alpm_handle_t *handle, alpm_cb_question cb);
+
+/** Returns the callback used for operation progress. */
+alpm_cb_progress alpm_option_get_progresscb(alpm_handle_t *handle);
+/** Sets the callback used for operation progress. */
+int alpm_option_set_progresscb(alpm_handle_t *handle, alpm_cb_progress cb);
+
+/** Returns the root of the destination filesystem. Read-only. */
+const char *alpm_option_get_root(alpm_handle_t *handle);
+
+/** Returns the path to the database directory. Read-only. */
+const char *alpm_option_get_dbpath(alpm_handle_t *handle);
+
+/** Get the name of the database lock file. Read-only. */
+const char *alpm_option_get_lockfile(alpm_handle_t *handle);
+
+/** @name Accessors to the list of package cache directories.
+ * @{
+ */
+alpm_list_t *alpm_option_get_cachedirs(alpm_handle_t *handle);
+int alpm_option_set_cachedirs(alpm_handle_t *handle, alpm_list_t *cachedirs);
+int alpm_option_add_cachedir(alpm_handle_t *handle, const char *cachedir);
+int alpm_option_remove_cachedir(alpm_handle_t *handle, const char *cachedir);
+/** @} */
+
+/** Returns the logfile name. */
+const char *alpm_option_get_logfile(alpm_handle_t *handle);
+/** Sets the logfile name. */
+int alpm_option_set_logfile(alpm_handle_t *handle, const char *logfile);
+
+/** Returns the path to libalpm's GnuPG home directory. */
+const char *alpm_option_get_gpgdir(alpm_handle_t *handle);
+/** Sets the path to libalpm's GnuPG home directory. */
+int alpm_option_set_gpgdir(alpm_handle_t *handle, const char *gpgdir);
+
+/** Returns whether to use syslog (0 is FALSE, TRUE otherwise). */
+int alpm_option_get_usesyslog(alpm_handle_t *handle);
+/** Sets whether to use syslog (0 is FALSE, TRUE otherwise). */
+int alpm_option_set_usesyslog(alpm_handle_t *handle, int usesyslog);
+
+/** @name Accessors to the list of no-upgrade files.
+ * These functions modify the list of files which should
+ * not be updated by package installation.
+ * @{
+ */
+alpm_list_t *alpm_option_get_noupgrades(alpm_handle_t *handle);
+int alpm_option_add_noupgrade(alpm_handle_t *handle, const char *path);
+int alpm_option_set_noupgrades(alpm_handle_t *handle, alpm_list_t *noupgrade);
+int alpm_option_remove_noupgrade(alpm_handle_t *handle, const char *path);
+int alpm_option_match_noupgrade(alpm_handle_t *handle, const char *path);
+/** @} */
+
+/** @name Accessors to the list of no-extract files.
+ * These functions modify the list of filenames which should
+ * be skipped packages which should
+ * not be upgraded by a sysupgrade operation.
+ * @{
+ */
+alpm_list_t *alpm_option_get_noextracts(alpm_handle_t *handle);
+int alpm_option_add_noextract(alpm_handle_t *handle, const char *path);
+int alpm_option_set_noextracts(alpm_handle_t *handle, alpm_list_t *noextract);
+int alpm_option_remove_noextract(alpm_handle_t *handle, const char *path);
+int alpm_option_match_noextract(alpm_handle_t *handle, const char *path);
+/** @} */
+
+/** @name Accessors to the list of ignored packages.
+ * These functions modify the list of packages that
+ * should be ignored by a sysupgrade.
+ * @{
+ */
+alpm_list_t *alpm_option_get_ignorepkgs(alpm_handle_t *handle);
+int alpm_option_add_ignorepkg(alpm_handle_t *handle, const char *pkg);
+int alpm_option_set_ignorepkgs(alpm_handle_t *handle, alpm_list_t *ignorepkgs);
+int alpm_option_remove_ignorepkg(alpm_handle_t *handle, const char *pkg);
+/** @} */
+
+/** @name Accessors to the list of ignored groups.
+ * These functions modify the list of groups whose packages
+ * should be ignored by a sysupgrade.
+ * @{
+ */
+alpm_list_t *alpm_option_get_ignoregroups(alpm_handle_t *handle);
+int alpm_option_add_ignoregroup(alpm_handle_t *handle, const char *grp);
+int alpm_option_set_ignoregroups(alpm_handle_t *handle, alpm_list_t *ignoregrps);
+int alpm_option_remove_ignoregroup(alpm_handle_t *handle, const char *grp);
+/** @} */
+
+/** @name Accessors to the list of ignored dependencies.
+ * These functions modify the list of dependencies that
+ * should be ignored by a sysupgrade.
+ * @{
+ */
+alpm_list_t *alpm_option_get_assumeinstalled(alpm_handle_t *handle);
+int alpm_option_add_assumeinstalled(alpm_handle_t *handle, const alpm_depend_t *dep);
+int alpm_option_set_assumeinstalled(alpm_handle_t *handle, alpm_list_t *deps);
+int alpm_option_remove_assumeinstalled(alpm_handle_t *handle, const alpm_depend_t *dep);
+/** @} */
+
+/** Returns the targeted architecture. */
+const char *alpm_option_get_arch(alpm_handle_t *handle);
+/** Sets the targeted architecture. */
+int alpm_option_set_arch(alpm_handle_t *handle, const char *arch);
+
+double alpm_option_get_deltaratio(alpm_handle_t *handle);
+int alpm_option_set_deltaratio(alpm_handle_t *handle, double ratio);
+
+int alpm_option_get_checkspace(alpm_handle_t *handle);
+int alpm_option_set_checkspace(alpm_handle_t *handle, int checkspace);
+
+alpm_siglevel_t alpm_option_get_default_siglevel(alpm_handle_t *handle);
+int alpm_option_set_default_siglevel(alpm_handle_t *handle, alpm_siglevel_t level);
+
+alpm_siglevel_t alpm_option_get_local_file_siglevel(alpm_handle_t *handle);
+int alpm_option_set_local_file_siglevel(alpm_handle_t *handle, alpm_siglevel_t level);
+
+alpm_siglevel_t alpm_option_get_remote_file_siglevel(alpm_handle_t *handle);
+int alpm_option_set_remote_file_siglevel(alpm_handle_t *handle, alpm_siglevel_t level);
+
+/** @} */
+
+/** @addtogroup alpm_api_databases Database Functions
+ * Functions to query and manipulate the database of libalpm.
+ * @{
+ */
+
+/** Get the database of locally installed packages.
+ * The returned pointer points to an internal structure
+ * of libalpm which should only be manipulated through
+ * libalpm functions.
+ * @return a reference to the local database
+ */
+alpm_db_t *alpm_get_localdb(alpm_handle_t *handle);
+
+/** Get the list of sync databases.
+ * Returns a list of alpm_db_t structures, one for each registered
+ * sync database.
+ * @param handle the context handle
+ * @return a reference to an internal list of alpm_db_t structures
+ */
+alpm_list_t *alpm_get_syncdbs(alpm_handle_t *handle);
+
+/** Register a sync database of packages.
+ * @param handle the context handle
+ * @param treename the name of the sync repository
+ * @param level what level of signature checking to perform on the
+ * database; note that this must be a '.sig' file type verification
+ * @return an alpm_db_t* on success (the value), NULL on error
+ */
+alpm_db_t *alpm_register_syncdb(alpm_handle_t *handle, const char *treename,
+ alpm_siglevel_t level);
+
+/** Unregister all package databases.
+ * @param handle the context handle
+ * @return 0 on success, -1 on error (pm_errno is set accordingly)
+ */
+int alpm_unregister_all_syncdbs(alpm_handle_t *handle);
+
+/** Unregister a package database.
+ * @param db pointer to the package database to unregister
+ * @return 0 on success, -1 on error (pm_errno is set accordingly)
+ */
+int alpm_db_unregister(alpm_db_t *db);
+
+/** Get the name of a package database.
+ * @param db pointer to the package database
+ * @return the name of the package database, NULL on error
+ */
+const char *alpm_db_get_name(const alpm_db_t *db);
+
+/** Get the signature verification level for a database.
+ * Will return the default verification level if this database is set up
+ * with ALPM_SIG_USE_DEFAULT.
+ * @param db pointer to the package database
+ * @return the signature verification level
+ */
+alpm_siglevel_t alpm_db_get_siglevel(alpm_db_t *db);
+
+/** Check the validity of a database.
+ * This is most useful for sync databases and verifying signature status.
+ * If invalid, the handle error code will be set accordingly.
+ * @param db pointer to the package database
+ * @return 0 if valid, -1 if invalid (pm_errno is set accordingly)
+ */
+int alpm_db_get_valid(alpm_db_t *db);
+
+/** @name Accessors to the list of servers for a database.
+ * @{
+ */
+alpm_list_t *alpm_db_get_servers(const alpm_db_t *db);
+int alpm_db_set_servers(alpm_db_t *db, alpm_list_t *servers);
+int alpm_db_add_server(alpm_db_t *db, const char *url);
+int alpm_db_remove_server(alpm_db_t *db, const char *url);
+/** @} */
+
+int alpm_db_update(int force, alpm_db_t *db);
+
+/** Get a package entry from a package database.
+ * @param db pointer to the package database to get the package from
+ * @param name of the package
+ * @return the package entry on success, NULL on error
+ */
+alpm_pkg_t *alpm_db_get_pkg(alpm_db_t *db, const char *name);
+
+/** Get the package cache of a package database.
+ * @param db pointer to the package database to get the package from
+ * @return the list of packages on success, NULL on error
+ */
+alpm_list_t *alpm_db_get_pkgcache(alpm_db_t *db);
+
+/** Get a group entry from a package database.
+ * @param db pointer to the package database to get the group from
+ * @param name of the group
+ * @return the groups entry on success, NULL on error
+ */
+alpm_group_t *alpm_db_get_group(alpm_db_t *db, const char *name);
+
+/** Get the group cache of a package database.
+ * @param db pointer to the package database to get the group from
+ * @return the list of groups on success, NULL on error
+ */
+alpm_list_t *alpm_db_get_groupcache(alpm_db_t *db);
+
+/** Searches a database with regular expressions.
+ * @param db pointer to the package database to search in
+ * @param needles a list of regular expressions to search for
+ * @return the list of packages matching all regular expressions on success, NULL on error
+ */
+alpm_list_t *alpm_db_search(alpm_db_t *db, const alpm_list_t *needles);
+
+typedef enum _alpm_db_usage_ {
+ ALPM_DB_USAGE_SYNC = 1,
+ ALPM_DB_USAGE_SEARCH = (1 << 1),
+ ALPM_DB_USAGE_INSTALL = (1 << 2),
+ ALPM_DB_USAGE_UPGRADE = (1 << 3),
+ ALPM_DB_USAGE_ALL = (1 << 4) - 1,
+} alpm_db_usage_t;
+
+/** Sets the usage of a database.
+ * @param db pointer to the package database to set the status for
+ * @param usage a bitmask of alpm_db_usage_t values
+ * @return 0 on success, or -1 on error
+ */
+int alpm_db_set_usage(alpm_db_t *db, alpm_db_usage_t usage);
+
+/** Gets the usage of a database.
+ * @param db pointer to the package database to get the status of
+ * @param usage pointer to an alpm_db_usage_t to store db's status
+ * @return 0 on success, or -1 on error
+ */
+int alpm_db_get_usage(alpm_db_t *db, alpm_db_usage_t *usage);
+
+/** @} */
+
+/** @addtogroup alpm_api_packages Package Functions
+ * Functions to manipulate libalpm packages
+ * @{
+ */
+
+/** 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().
+ * @param handle the context handle
+ * @param filename location of the package tarball
+ * @param full whether to stop the load after metadata is read or continue
+ * through the full archive
+ * @param level what level of package signature checking to perform on the
+ * package; note that this must be a '.sig' file type verification
+ * @param pkg address of the package pointer
+ * @return 0 on success, -1 on error (pm_errno is set accordingly)
+ */
+int alpm_pkg_load(alpm_handle_t *handle, const char *filename, int full,
+ alpm_siglevel_t level, alpm_pkg_t **pkg);
+
+/** Find a package in a list by name.
+ * @param haystack a list of alpm_pkg_t
+ * @param needle the package name
+ * @return a pointer to the package if found or NULL
+ */
+alpm_pkg_t *alpm_pkg_find(alpm_list_t *haystack, const char *needle);
+
+/** Free a package.
+ * @param pkg package pointer to free
+ * @return 0 on success, -1 on error (pm_errno is set accordingly)
+ */
+int alpm_pkg_free(alpm_pkg_t *pkg);
+
+/** Check the integrity (with md5) of a package from the sync cache.
+ * @param pkg package pointer
+ * @return 0 on success, -1 on error (pm_errno is set accordingly)
+ */
+int alpm_pkg_checkmd5sum(alpm_pkg_t *pkg);
+
+/** Compare two version strings and determine which one is 'newer'. */
+int alpm_pkg_vercmp(const char *a, const char *b);
+
+/** 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.
+ * @param pkg a package
+ * @return the list of packages requiring pkg
+ */
+alpm_list_t *alpm_pkg_compute_requiredby(alpm_pkg_t *pkg);
+
+/** 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.
+ * @param pkg a package
+ * @return the list of packages optionally requiring pkg
+ */
+alpm_list_t *alpm_pkg_compute_optionalfor(alpm_pkg_t *pkg);
+
+/** Test if a package should be ignored.
+ * Checks if the package is ignored via IgnorePkg, or if the package is
+ * in a group ignored via IgnoreGroup.
+ * @param handle the context handle
+ * @param pkg the package to test
+ * @return 1 if the package should be ignored, 0 otherwise
+ */
+int alpm_pkg_should_ignore(alpm_handle_t *handle, alpm_pkg_t *pkg);
+
+/** @name Package Property Accessors
+ * Any pointer returned by these functions points to internal structures
+ * allocated by libalpm. They should not be freed nor modified in any
+ * way.
+ * @{
+ */
+
+/** Gets the name of the file from which the package was loaded.
+ * @param pkg a pointer to package
+ * @return a reference to an internal string
+ */
+const char *alpm_pkg_get_filename(alpm_pkg_t *pkg);
+
+/** Returns the package base name.
+ * @param pkg a pointer to package
+ * @return a reference to an internal string
+ */
+const char *alpm_pkg_get_base(alpm_pkg_t *pkg);
+
+/** Returns the package name.
+ * @param pkg a pointer to package
+ * @return a reference to an internal string
+ */
+const char *alpm_pkg_get_name(alpm_pkg_t *pkg);
+
+/** 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.
+ * @param pkg a pointer to package
+ * @return a reference to an internal string
+ */
+const char *alpm_pkg_get_version(alpm_pkg_t *pkg);
+
+/** Returns the origin of the package.
+ * @return an alpm_pkgfrom_t constant, -1 on error
+ */
+alpm_pkgfrom_t alpm_pkg_get_origin(alpm_pkg_t *pkg);
+
+/** Returns the package description.
+ * @param pkg a pointer to package
+ * @return a reference to an internal string
+ */
+const char *alpm_pkg_get_desc(alpm_pkg_t *pkg);
+
+/** Returns the package URL.
+ * @param pkg a pointer to package
+ * @return a reference to an internal string
+ */
+const char *alpm_pkg_get_url(alpm_pkg_t *pkg);
+
+/** Returns the build timestamp of the package.
+ * @param pkg a pointer to package
+ * @return the timestamp of the build time
+ */
+alpm_time_t alpm_pkg_get_builddate(alpm_pkg_t *pkg);
+
+/** Returns the install timestamp of the package.
+ * @param pkg a pointer to package
+ * @return the timestamp of the install time
+ */
+alpm_time_t alpm_pkg_get_installdate(alpm_pkg_t *pkg);
+
+/** Returns the packager's name.
+ * @param pkg a pointer to package
+ * @return a reference to an internal string
+ */
+const char *alpm_pkg_get_packager(alpm_pkg_t *pkg);
+
+/** Returns the package's MD5 checksum as a string.
+ * The returned string is a sequence of 32 lowercase hexadecimal digits.
+ * @param pkg a pointer to package
+ * @return a reference to an internal string
+ */
+const char *alpm_pkg_get_md5sum(alpm_pkg_t *pkg);
+
+/** Returns the package's SHA256 checksum as a string.
+ * The returned string is a sequence of 64 lowercase hexadecimal digits.
+ * @param pkg a pointer to package
+ * @return a reference to an internal string
+ */
+const char *alpm_pkg_get_sha256sum(alpm_pkg_t *pkg);
+
+/** Returns the architecture for which the package was built.
+ * @param pkg a pointer to package
+ * @return a reference to an internal string
+ */
+const char *alpm_pkg_get_arch(alpm_pkg_t *pkg);
+
+/** Returns the size of the package. This is only available for sync database
+ * packages and package files, not those loaded from the local database.
+ * @param pkg a pointer to package
+ * @return the size of the package in bytes.
+ */
+off_t alpm_pkg_get_size(alpm_pkg_t *pkg);
+
+/** Returns the installed size of the package.
+ * @param pkg a pointer to package
+ * @return the total size of files installed by the package.
+ */
+off_t alpm_pkg_get_isize(alpm_pkg_t *pkg);
+
+/** Returns the package installation reason.
+ * @param pkg a pointer to package
+ * @return an enum member giving the install reason.
+ */
+alpm_pkgreason_t alpm_pkg_get_reason(alpm_pkg_t *pkg);
+
+/** Returns the list of package licenses.
+ * @param pkg a pointer to package
+ * @return a pointer to an internal list of strings.
+ */
+alpm_list_t *alpm_pkg_get_licenses(alpm_pkg_t *pkg);
+
+/** Returns the list of package groups.
+ * @param pkg a pointer to package
+ * @return a pointer to an internal list of strings.
+ */
+alpm_list_t *alpm_pkg_get_groups(alpm_pkg_t *pkg);
+
+/** Returns the list of package dependencies as alpm_depend_t.
+ * @param pkg a pointer to package
+ * @return a reference to an internal list of alpm_depend_t structures.
+ */
+alpm_list_t *alpm_pkg_get_depends(alpm_pkg_t *pkg);
+
+/** Returns the list of package optional dependencies.
+ * @param pkg a pointer to package
+ * @return a reference to an internal list of alpm_depend_t structures.
+ */
+alpm_list_t *alpm_pkg_get_optdepends(alpm_pkg_t *pkg);
+
+/** Returns the list of packages conflicting with pkg.
+ * @param pkg a pointer to package
+ * @return a reference to an internal list of alpm_depend_t structures.
+ */
+alpm_list_t *alpm_pkg_get_conflicts(alpm_pkg_t *pkg);
+
+/** Returns the list of packages provided by pkg.
+ * @param pkg a pointer to package
+ * @return a reference to an internal list of alpm_depend_t structures.
+ */
+alpm_list_t *alpm_pkg_get_provides(alpm_pkg_t *pkg);
+
+/** Returns the list of available deltas for pkg.
+ * @param pkg a pointer to package
+ * @return a reference to an internal list of strings.
+ */
+alpm_list_t *alpm_pkg_get_deltas(alpm_pkg_t *pkg);
+
+/** Returns the list of packages to be replaced by pkg.
+ * @param pkg a pointer to package
+ * @return a reference to an internal list of alpm_depend_t structures.
+ */
+alpm_list_t *alpm_pkg_get_replaces(alpm_pkg_t *pkg);
+
+/** Returns the list of files installed by pkg.
+ * The filenames are relative to the install root,
+ * and do not include leading slashes.
+ * @param pkg a pointer to package
+ * @return a pointer to a filelist object containing a count and an array of
+ * package file objects
+ */
+alpm_filelist_t *alpm_pkg_get_files(alpm_pkg_t *pkg);
+
+/** Returns the list of files backed up when installing pkg.
+ * @param pkg a pointer to package
+ * @return a reference to a list of alpm_backup_t objects
+ */
+alpm_list_t *alpm_pkg_get_backup(alpm_pkg_t *pkg);
+
+/** 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.
+ * @param pkg a pointer to package
+ * @return a pointer to the DB containing pkg, or NULL.
+ */
+alpm_db_t *alpm_pkg_get_db(alpm_pkg_t *pkg);
+
+/** Returns the base64 encoded package signature.
+ * @param pkg a pointer to package
+ * @return a reference to an internal string
+ */
+const char *alpm_pkg_get_base64_sig(alpm_pkg_t *pkg);
+
+/** Returns the method used to validate a package during install.
+ * @param pkg a pointer to package
+ * @return an enum member giving the validation method
+ */
+alpm_pkgvalidation_t alpm_pkg_get_validation(alpm_pkg_t *pkg);
+
+/* End of alpm_pkg_t accessors */
+/* @} */
+
+/** 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.
+ * @param pkg the package to read the changelog of (either file or db)
+ * @return a 'file stream' to the package changelog
+ */
+void *alpm_pkg_changelog_open(alpm_pkg_t *pkg);
+
+/** 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.
+ * @param ptr a buffer to fill with raw changelog data
+ * @param size the size of the buffer
+ * @param pkg the package that the changelog is being read from
+ * @param fp a 'file stream' to the package changelog
+ * @return the number of characters read, or 0 if there is no more data or an
+ * error occurred.
+ */
+size_t alpm_pkg_changelog_read(void *ptr, size_t size,
+ const alpm_pkg_t *pkg, void *fp);
+
+int alpm_pkg_changelog_close(const alpm_pkg_t *pkg, void *fp);
+
+/** Open a package mtree file for reading.
+ * @param pkg the local package to read the changelog of
+ * @return a archive structure for the package mtree file
+ */
+struct archive *alpm_pkg_mtree_open(alpm_pkg_t *pkg);
+
+/** Read next entry from a package mtree file.
+ * @param pkg the package that the mtree file is being read from
+ * @param archive the archive structure reading from the mtree file
+ * @param entry an archive_entry to store the entry header information
+ * @return 0 if end of archive is reached, non-zero otherwise.
+ */
+int alpm_pkg_mtree_next(const alpm_pkg_t *pkg, struct archive *archive,
+ struct archive_entry **entry);
+
+int alpm_pkg_mtree_close(const alpm_pkg_t *pkg, struct archive *archive);
+
+/** Returns whether the package has an install scriptlet.
+ * @return 0 if FALSE, TRUE otherwise
+ */
+int alpm_pkg_has_scriptlet(alpm_pkg_t *pkg);
+
+/** Returns the size of download.
+ * Returns the size of the files that will be downloaded to install a
+ * package.
+ * @param newpkg the new package to upgrade to
+ * @return the size of the download
+ */
+off_t alpm_pkg_download_size(alpm_pkg_t *newpkg);
+
+alpm_list_t *alpm_pkg_unused_deltas(alpm_pkg_t *pkg);
+
+/** 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.
+ * @param pkg the package to update
+ * @param reason the new install reason
+ * @return 0 on success, -1 on error (pm_errno is set accordingly)
+ */
+int alpm_pkg_set_reason(alpm_pkg_t *pkg, alpm_pkgreason_t reason);
+
+
+/* End of alpm_pkg */
+/** @} */
+
+/*
+ * Filelists
+ */
+
+/** Determines whether a package filelist contains a given path.
+ * The provided path should be relative to the install root with no leading
+ * slashes, e.g. "etc/localtime". When searching for directories, the path must
+ * have a trailing slash.
+ * @param filelist a pointer to a package filelist
+ * @param path the path to search for in the package
+ * @return a pointer to the matching file or NULL if not found
+ */
+alpm_file_t *alpm_filelist_contains(alpm_filelist_t *filelist, const char *path);
+
+/*
+ * Signatures
+ */
+
+int alpm_pkg_check_pgp_signature(alpm_pkg_t *pkg, alpm_siglist_t *siglist);
+
+int alpm_db_check_pgp_signature(alpm_db_t *db, alpm_siglist_t *siglist);
+
+int alpm_siglist_cleanup(alpm_siglist_t *siglist);
+
+int alpm_decode_signature(const char *base64_data,
+ unsigned char **data, size_t *data_len);
+
+int alpm_extract_keyid(alpm_handle_t *handle, const char *identifier,
+ const unsigned char *sig, const size_t len, alpm_list_t **keys);
+
+/*
+ * Groups
+ */
+
+alpm_list_t *alpm_find_group_pkgs(alpm_list_t *dbs, const char *name);
+
+/*
+ * Sync
+ */
+
+alpm_pkg_t *alpm_sync_newversion(alpm_pkg_t *pkg, alpm_list_t *dbs_sync);
+
+/** @addtogroup alpm_api_trans Transaction Functions
+ * Functions to manipulate libalpm transactions
+ * @{
+ */
+
+/** Transaction flags */
+typedef enum _alpm_transflag_t {
+ /** Ignore dependency checks. */
+ ALPM_TRANS_FLAG_NODEPS = 1,
+ /** Ignore file conflicts and overwrite files. */
+ ALPM_TRANS_FLAG_FORCE = (1 << 1),
+ /** Delete files even if they are tagged as backup. */
+ ALPM_TRANS_FLAG_NOSAVE = (1 << 2),
+ /** Ignore version numbers when checking dependencies. */
+ ALPM_TRANS_FLAG_NODEPVERSION = (1 << 3),
+ /** Remove also any packages depending on a package being removed. */
+ ALPM_TRANS_FLAG_CASCADE = (1 << 4),
+ /** Remove packages and their unneeded deps (not explicitly installed). */
+ ALPM_TRANS_FLAG_RECURSE = (1 << 5),
+ /** Modify database but do not commit changes to the filesystem. */
+ ALPM_TRANS_FLAG_DBONLY = (1 << 6),
+ /* (1 << 7) flag can go here */
+ /** Use ALPM_PKG_REASON_DEPEND when installing packages. */
+ ALPM_TRANS_FLAG_ALLDEPS = (1 << 8),
+ /** Only download packages and do not actually install. */
+ ALPM_TRANS_FLAG_DOWNLOADONLY = (1 << 9),
+ /** Do not execute install scriptlets after installing. */
+ ALPM_TRANS_FLAG_NOSCRIPTLET = (1 << 10),
+ /** Ignore dependency conflicts. */
+ ALPM_TRANS_FLAG_NOCONFLICTS = (1 << 11),
+ /* (1 << 12) flag can go here */
+ /** Do not install a package if it is already installed and up to date. */
+ ALPM_TRANS_FLAG_NEEDED = (1 << 13),
+ /** Use ALPM_PKG_REASON_EXPLICIT when installing packages. */
+ ALPM_TRANS_FLAG_ALLEXPLICIT = (1 << 14),
+ /** Do not remove a package if it is needed by another one. */
+ ALPM_TRANS_FLAG_UNNEEDED = (1 << 15),
+ /** Remove also explicitly installed unneeded deps (use with ALPM_TRANS_FLAG_RECURSE). */
+ ALPM_TRANS_FLAG_RECURSEALL = (1 << 16),
+ /** Do not lock the database during the operation. */
+ ALPM_TRANS_FLAG_NOLOCK = (1 << 17)
+} alpm_transflag_t;
+
+/** Returns the bitfield of flags for the current transaction.
+ * @param handle the context handle
+ * @return the bitfield of transaction flags
+ */
+alpm_transflag_t alpm_trans_get_flags(alpm_handle_t *handle);
+
+/** Returns a list of packages added by the transaction.
+ * @param handle the context handle
+ * @return a list of alpm_pkg_t structures
+ */
+alpm_list_t *alpm_trans_get_add(alpm_handle_t *handle);
+
+/** Returns the list of packages removed by the transaction.
+ * @param handle the context handle
+ * @return a list of alpm_pkg_t structures
+ */
+alpm_list_t *alpm_trans_get_remove(alpm_handle_t *handle);
+
+/** Initialize the transaction.
+ * @param handle the context handle
+ * @param flags flags of the transaction (like nodeps, etc)
+ * @return 0 on success, -1 on error (pm_errno is set accordingly)
+ */
+int alpm_trans_init(alpm_handle_t *handle, alpm_transflag_t flags);
+
+/** Prepare a transaction.
+ * @param handle the context handle
+ * @param data the address of an alpm_list where a list
+ * of alpm_depmissing_t objects is dumped (conflicting packages)
+ * @return 0 on success, -1 on error (pm_errno is set accordingly)
+ */
+int alpm_trans_prepare(alpm_handle_t *handle, alpm_list_t **data);
+
+/** Commit a transaction.
+ * @param handle the context handle
+ * @param data the address of an alpm_list where detailed description
+ * of an error can be dumped (i.e. list of conflicting files)
+ * @return 0 on success, -1 on error (pm_errno is set accordingly)
+ */
+int alpm_trans_commit(alpm_handle_t *handle, alpm_list_t **data);
+
+/** Interrupt a transaction.
+ * @param handle the context handle
+ * @return 0 on success, -1 on error (pm_errno is set accordingly)
+ */
+int alpm_trans_interrupt(alpm_handle_t *handle);
+
+/** Release a transaction.
+ * @param handle the context handle
+ * @return 0 on success, -1 on error (pm_errno is set accordingly)
+ */
+int alpm_trans_release(alpm_handle_t *handle);
+/** @} */
+
+/** @name Common Transactions */
+/** @{ */
+
+/** Search for packages to upgrade and add them to the transaction.
+ * @param handle the context handle
+ * @param enable_downgrade allow downgrading of packages if the remote version is lower
+ * @return 0 on success, -1 on error (pm_errno is set accordingly)
+ */
+int alpm_sync_sysupgrade(alpm_handle_t *handle, int enable_downgrade);
+
+/** Add a package to the transaction.
+ * If the package was loaded by alpm_pkg_load(), it will be freed upon
+ * alpm_trans_release() invocation.
+ * @param handle the context handle
+ * @param pkg the package to add
+ * @return 0 on success, -1 on error (pm_errno is set accordingly)
+ */
+int alpm_add_pkg(alpm_handle_t *handle, alpm_pkg_t *pkg);
+
+/** Add a package removal action to the transaction.
+ * @param handle the context handle
+ * @param pkg the package to uninstall
+ * @return 0 on success, -1 on error (pm_errno is set accordingly)
+ */
+int alpm_remove_pkg(alpm_handle_t *handle, alpm_pkg_t *pkg);
+
+/** @} */
+
+/** @addtogroup alpm_api_depends Dependency Functions
+ * Functions dealing with libalpm representation of dependency
+ * information.
+ * @{
+ */
+
+alpm_list_t *alpm_checkdeps(alpm_handle_t *handle, alpm_list_t *pkglist,
+ alpm_list_t *remove, alpm_list_t *upgrade, int reversedeps);
+alpm_pkg_t *alpm_find_satisfier(alpm_list_t *pkgs, const char *depstring);
+alpm_pkg_t *alpm_find_dbs_satisfier(alpm_handle_t *handle,
+ alpm_list_t *dbs, const char *depstring);
+
+alpm_list_t *alpm_checkconflicts(alpm_handle_t *handle, alpm_list_t *pkglist);
+
+/** Returns a newly allocated string representing the dependency information.
+ * @param dep a dependency info structure
+ * @return a formatted string, e.g. "glibc>=2.12"
+ */
+char *alpm_dep_compute_string(const alpm_depend_t *dep);
+
+/** Return a newly allocated dependency information parsed from a string
+ * @param depstring a formatted string, e.g. "glibc=2.12"
+ * @return a dependency info structure
+ */
+alpm_depend_t *alpm_dep_from_string(const char *depstring);
+
+/** Free a dependency info structure
+ * @param dep struct to free
+ */
+void alpm_dep_free(alpm_depend_t *dep);
+
+/** @} */
+
+/** @} */
+
+/*
+ * Helpers
+ */
+
+/* checksums */
+char *alpm_compute_md5sum(const char *filename);
+char *alpm_compute_sha256sum(const char *filename);
+
+alpm_handle_t *alpm_initialize(const char *root, const char *dbpath,
+ alpm_errno_t *err);
+int alpm_release(alpm_handle_t *handle);
+
+enum alpm_caps {
+ ALPM_CAPABILITY_NLS = (1 << 0),
+ ALPM_CAPABILITY_DOWNLOADER = (1 << 1),
+ ALPM_CAPABILITY_SIGNATURES = (1 << 2)
+};
+
+const char *alpm_version(void);
+enum alpm_caps alpm_capabilities(void);
+
+void alpm_fileconflict_free(alpm_fileconflict_t *conflict);
+void alpm_depmissing_free(alpm_depmissing_t *miss);
+void alpm_conflict_free(alpm_conflict_t *conflict);
+
+/* End of alpm_api */
+/** @} */
+
+#ifdef __cplusplus
+}
+#endif
+#endif /* _ALPM_H */
+
+/* vim: set noet: */
--
2.2.1
3
3
This patch set is a cleaned up version of the the first attempt to add QNX
support. Changes from the first version include:
* Using Markus Kuhn's implementation of wcwidth and wcswidth
* Breaking the mkdtemp replacement into its own patch, with a proper configure
test instead of #ifdef __QNX__
* Cleaning up code style everywhere. Sorry!
Thanks again for taking the time to review my first attempt.
2
12
03 Mar '15
Paths from noupgrade, the transaction skip_remove, and package backup
lists were combined into a single list matched using fnmatch causing
paths with glob characters to match unrelated files.
Signed-off-by: Andrew Gregory <andrew.gregory.8(a)gmail.com>
---
lib/libalpm/remove.c | 82 ++++++++++--------------
test/pacman/tests/skip-remove-with-glob-chars.py | 19 ++++++
2 files changed, 52 insertions(+), 49 deletions(-)
create mode 100644 test/pacman/tests/skip-remove-with-glob-chars.py
diff --git a/lib/libalpm/remove.c b/lib/libalpm/remove.c
index f9b24ef..42978ae 100644
--- a/lib/libalpm/remove.c
+++ b/lib/libalpm/remove.c
@@ -317,20 +317,13 @@ static int dir_is_mountpoint(alpm_handle_t *handle, const char *directory,
*
* @param handle the context handle
* @param file file to be removed
- * @param skip_remove list of files that will not be removed
*
* @return 1 if the file can be deleted, 0 if it cannot be deleted
*/
-static int can_remove_file(alpm_handle_t *handle, const alpm_file_t *file,
- alpm_list_t *skip_remove)
+static int can_remove_file(alpm_handle_t *handle, const alpm_file_t *file)
{
char filepath[PATH_MAX];
- if(_alpm_fnmatch_patterns(skip_remove, file->name) == 0) {
- /* return success because we will never actually remove this file */
- return 1;
- }
-
snprintf(filepath, PATH_MAX, "%s%s", handle->root, file->name);
if(file->name[strlen(file->name) - 1] == '/' &&
@@ -433,30 +426,19 @@ cleanup:
* @param oldpkg the package being removed
* @param newpkg the package replacing \a oldpkg
* @param fileobj file to remove
- * @param skip_remove list of files that shouldn't be removed
* @param nosave whether files should be backed up
*
* @return 0 on success, -1 if there was an error unlinking the file, 1 if the
* file was skipped or did not exist
*/
static int unlink_file(alpm_handle_t *handle, alpm_pkg_t *oldpkg,
- alpm_pkg_t *newpkg, const alpm_file_t *fileobj, alpm_list_t *skip_remove,
- int nosave)
+ alpm_pkg_t *newpkg, const alpm_file_t *fileobj, int nosave)
{
struct stat buf;
char file[PATH_MAX];
snprintf(file, PATH_MAX, "%s%s", handle->root, fileobj->name);
- /* check the remove skip list before removing the file.
- * see the big comment block in db_find_fileconflicts() for an
- * explanation. */
- if(_alpm_fnmatch_patterns(skip_remove, fileobj->name) == 0) {
- _alpm_log(handle, ALPM_LOG_DEBUG,
- "%s is in skip_remove, skipping removal\n", file);
- return 1;
- }
-
if(llstat(file, &buf)) {
_alpm_log(handle, ALPM_LOG_DEBUG, "file %s does not exist\n", file);
return 1;
@@ -564,6 +546,24 @@ static int unlink_file(alpm_handle_t *handle, alpm_pkg_t *oldpkg,
}
/**
+ * @brief Check if a package file should be removed.
+ *
+ * @param handle the context handle
+ * @param newpkg the package replacing the current owner of \a path
+ * @param path file to be removed
+ *
+ * @return 1 if the file should be skipped, 0 if it should be removed
+ */
+static int _should_skip_file(alpm_handle_t *handle,
+ alpm_pkg_t *newpkg, const char *path)
+{
+ return _alpm_fnmatch_patterns(handle->noupgrade, path) == 0
+ || alpm_list_find_str(handle->trans->skip_remove, path)
+ || (newpkg && _alpm_needbackup(path, newpkg)
+ && alpm_filelist_contains(alpm_pkg_get_files(newpkg), path));
+}
+
+/**
* @brief Remove a package's files, optionally skipping its replacement's
* files.
*
@@ -580,44 +580,19 @@ static int remove_package_files(alpm_handle_t *handle,
alpm_pkg_t *oldpkg, alpm_pkg_t *newpkg,
size_t targ_count, size_t pkg_count)
{
- alpm_list_t *skip_remove;
alpm_filelist_t *filelist;
size_t i;
int err = 0;
int nosave = handle->trans->flags & ALPM_TRANS_FLAG_NOSAVE;
- if(newpkg) {
- alpm_filelist_t *newfiles;
- alpm_list_t *b;
- skip_remove = alpm_list_join(
- alpm_list_strdup(handle->trans->skip_remove),
- alpm_list_strdup(handle->noupgrade));
- /* Add files in the NEW backup array to the skip_remove array
- * so this removal operation doesn't kill them */
- /* old package backup list */
- newfiles = alpm_pkg_get_files(newpkg);
- for(b = alpm_pkg_get_backup(newpkg); b; b = b->next) {
- const alpm_backup_t *backup = b->data;
- /* safety check (fix the upgrade026 pactest) */
- if(!alpm_filelist_contains(newfiles, backup->name)) {
- continue;
- }
- _alpm_log(handle, ALPM_LOG_DEBUG, "adding %s to the skip_remove array\n",
- backup->name);
- skip_remove = alpm_list_add(skip_remove, strdup(backup->name));
- }
- } else {
- skip_remove = alpm_list_strdup(handle->trans->skip_remove);
- }
-
filelist = alpm_pkg_get_files(oldpkg);
for(i = 0; i < filelist->count; i++) {
alpm_file_t *file = filelist->files + i;
- if(!can_remove_file(handle, file, skip_remove)) {
+ if(!_should_skip_file(handle, newpkg, file->name)
+ && !can_remove_file(handle, file)) {
_alpm_log(handle, ALPM_LOG_DEBUG,
"not removing package '%s', can't remove all files\n",
oldpkg->name);
- FREELIST(skip_remove);
RET_ERR(handle, ALPM_ERR_PKG_CANT_REMOVE, -1);
}
}
@@ -633,7 +608,17 @@ static int remove_package_files(alpm_handle_t *handle,
/* iterate through the list backwards, unlinking files */
for(i = filelist->count; i > 0; i--) {
alpm_file_t *file = filelist->files + i - 1;
- if(unlink_file(handle, oldpkg, newpkg, file, skip_remove, nosave) < 0) {
+
+ /* check the remove skip list before removing the file.
+ * see the big comment block in db_find_fileconflicts() for an
+ * explanation. */
+ if(_should_skip_file(handle, newpkg, file->name)) {
+ _alpm_log(handle, ALPM_LOG_DEBUG,
+ "%s is in skip_remove, skipping removal\n", file->name);
+ continue;
+ }
+
+ if(unlink_file(handle, oldpkg, newpkg, file, nosave) < 0) {
err++;
}
@@ -644,7 +629,6 @@ static int remove_package_files(alpm_handle_t *handle,
percent, pkg_count, targ_count);
}
}
- FREELIST(skip_remove);
if(!newpkg) {
/* set progress to 100% after we finish unlinking files */
diff --git a/test/pacman/tests/skip-remove-with-glob-chars.py b/test/pacman/tests/skip-remove-with-glob-chars.py
new file mode 100644
index 0000000..039e150
--- /dev/null
+++ b/test/pacman/tests/skip-remove-with-glob-chars.py
@@ -0,0 +1,19 @@
+self.description = "transferred file with glob characters that match a removed file"
+
+lp = pmpkg("foo")
+lp.files = ["foo/b*r", "foo/bar"]
+self.addpkg2db("local", lp)
+
+sp1 = pmpkg("foo", "1.0-2")
+self.addpkg(sp1)
+
+sp2 = pmpkg("bar", "1.0-2")
+sp2.files = ["foo/b*r"]
+self.addpkg(sp2)
+
+self.args = "-U %s %s" % (sp1.filename(), sp2.filename())
+
+self.addrule("PKG_VERSION=foo|1.0-2")
+self.addrule("PKG_VERSION=bar|1.0-2")
+self.addrule("FILE_EXIST=foo/b*r")
+self.addrule("!FILE_EXIST=foo/bar")
--
2.1.3
2
3
03 Mar '15
If a transaction were actually in STATE_IDLE, which it should never be,
the handle would be stuck with a useless transaction and lock file that
it can't remove.
Signed-off-by: Andrew Gregory <andrew.gregory.8(a)gmail.com>
---
lib/libalpm/trans.c | 1 -
1 file changed, 1 deletion(-)
diff --git a/lib/libalpm/trans.c b/lib/libalpm/trans.c
index e5328c5..0c84bb0 100644
--- a/lib/libalpm/trans.c
+++ b/lib/libalpm/trans.c
@@ -222,7 +222,6 @@ int SYMEXPORT alpm_trans_release(alpm_handle_t *handle)
trans = handle->trans;
ASSERT(trans != NULL, RET_ERR(handle, ALPM_ERR_TRANS_NULL, -1));
- ASSERT(trans->state != STATE_IDLE, RET_ERR(handle, ALPM_ERR_TRANS_NULL, -1));
int nolock_flag = trans->flags & ALPM_TRANS_FLAG_NOLOCK;
--
1.9.1
2
1
03 Mar '15
Signed-off-by: Andrew Gregory <andrew.gregory.8(a)gmail.com>
---
lib/libalpm/sync.c | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/lib/libalpm/sync.c b/lib/libalpm/sync.c
index 44a0ba8..cf7f0a8 100644
--- a/lib/libalpm/sync.c
+++ b/lib/libalpm/sync.c
@@ -402,7 +402,7 @@ int _alpm_sync_prepare(alpm_handle_t *handle, alpm_list_t **data)
if(!(trans->flags & ALPM_TRANS_FLAG_NODEPS)) {
alpm_list_t *resolved = NULL;
- alpm_list_t *remove = NULL;
+ alpm_list_t *remove = alpm_list_copy(trans->remove);
alpm_list_t *localpkgs;
/* Build up list by repeatedly resolving each transaction package */
--
1.9.0
2
1
[pacman-dev] [PATCH 1/2] PKGBUILD.5.txt: Add note about functions starting in $srcdir
by Johannes Löthberg 03 Mar '15
by Johannes Löthberg 03 Mar '15
03 Mar '15
From: Johannes Löthberg <johannes(a)kyriasis.com>
Signed-off-by: Johannes Löthberg <johannes(a)kyriasis.com>
---
doc/PKGBUILD.5.txt | 3 +++
1 file changed, 3 insertions(+)
diff --git a/doc/PKGBUILD.5.txt b/doc/PKGBUILD.5.txt
index 10980ab..2dba100 100644
--- a/doc/PKGBUILD.5.txt
+++ b/doc/PKGBUILD.5.txt
@@ -374,6 +374,9 @@ variables for use during the build and install process:
*srcdir*::
This contains the directory where makepkg extracts, or copies, all source
files.
++
+All of the above defined packaging functions in PKGBUILDs are run from inside
+the `$srcdir`
*pkgdir*::
This contains the directory where makepkg bundles the installed package.
--
2.3.0
3
6
This patch set adds support for the QNX RTOS. The first four patches
are essentially workarounds for QNX's libc; the last patch implements the
QNX-specific sections in libalpm.
2
7
Hi,
I was reading the online HTML man page, and noticed a doc bug.
Here's the relevant section, verbatim, except I put **** around the bug:
=====
Using VCS Sources
Building a developmental version of a package using sources from a version
control system (VCS) is enabled by specifying the source in the form
source=('folder::url#fragment'). Currently makepkg supports the bzr, git, hg
and svn protocols.
The source URL is divided into three components:
folder
(optional) Specifies an alternate folder name for makepkg to download the
VCS source into.
url
The url to the VCS repo. This must include ****the the**** vcs in the URL
protocol for makepkg to recognize this as a VCS source. If the protocol does
not include the VCS name, it can be added by prefixing the URL with vcs+. For
example, using a git repository over http would have a source URL in the form
git+http://....
=====
A double 'the' is present.
Thanks,
Eric
--
Sent from my Android device.
--
Sent from my Android device.
2
1
24 Feb '15
Signed-off-by: Allan McRae <allan(a)archlinux.org>
---
lib/libalpm/diskspace.c | 7 ++++++-
1 file changed, 6 insertions(+), 1 deletion(-)
diff --git a/lib/libalpm/diskspace.c b/lib/libalpm/diskspace.c
index 3b496c2..aaa0036 100644
--- a/lib/libalpm/diskspace.c
+++ b/lib/libalpm/diskspace.c
@@ -235,7 +235,12 @@ static int calculate_removed_size(alpm_handle_t *handle,
const char *filename = file->name;
snprintf(path, PATH_MAX, "%s%s", handle->root, filename);
- llstat(path, &st);
+
+ if(llstat(path, &st) == -1) {
+ _alpm_log(handle, ALPM_LOG_WARNING,
+ _("could not get file information for %s\n"), filename);
+ continue;
+ }
/* skip directories and symlinks to be consistent with libarchive that
* reports them to be zero size */
--
2.3.0
1
0