[pacman-dev] [PATCH v2 1/1] libalpm: generate alpm.h on the fly and add version information

[Christian Hesse]

From: Christian Hesse <mail at 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 at 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 at archlinux.org>
- *  Copyright (c) 2002-2006 by Judd Vinet <jvinet at zeroflux.org>
- *  Copyright (c) 2005 by Aurelien Foret <orelien at chez.com>
- *  Copyright (c) 2005 by Christian Hamar <krics at linuxforum.hu>
- *  Copyright (c) 2005, 2006 by Miklos Vajna <vmiklos at 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 at archlinux.org>
+ *  Copyright (c) 2002-2006 by Judd Vinet <jvinet at zeroflux.org>
+ *  Copyright (c) 2005 by Aurelien Foret <orelien at chez.com>
+ *  Copyright (c) 2005 by Christian Hamar <krics at linuxforum.hu>
+ *  Copyright (c) 2005, 2006 by Miklos Vajna <vmiklos at 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