2005-03-14 20:51:43 -05:00
|
|
|
/*
|
|
|
|
* alpm.h
|
|
|
|
*
|
|
|
|
* Copyright (c) 2002-2005 by Judd Vinet <jvinet@zeroflux.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, write to the Free Software
|
|
|
|
* Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307,
|
|
|
|
* USA.
|
|
|
|
*/
|
|
|
|
#ifndef _ALPM_H
|
|
|
|
#define _ALPM_H
|
|
|
|
|
|
|
|
/*
|
|
|
|
* Arch Linux Package Management library
|
|
|
|
*/
|
|
|
|
|
2005-04-16 18:23:28 -04:00
|
|
|
#define PM_VERSION "0.1.0"
|
|
|
|
|
|
|
|
#define PM_ROOT "/"
|
|
|
|
#define PM_DBPATH "var/lib/pacman"
|
|
|
|
|
2005-03-16 15:59:14 -05:00
|
|
|
#define PM_EXT_PKG ".pkg.tar.gz"
|
|
|
|
#define PM_EXT_DB ".db.tar.gz"
|
|
|
|
|
2005-03-14 20:51:43 -05:00
|
|
|
/*
|
|
|
|
* Structures (opaque)
|
|
|
|
*/
|
|
|
|
|
|
|
|
typedef struct __pmlist_t PM_LIST;
|
|
|
|
typedef struct __pmdb_t PM_DB;
|
|
|
|
typedef struct __pmpkg_t PM_PKG;
|
|
|
|
typedef struct __pmgrp_t PM_GRP;
|
2005-04-06 14:29:17 -04:00
|
|
|
typedef struct __pmsyncpkg_t PM_SYNCPKG;
|
2005-03-14 20:51:43 -05:00
|
|
|
typedef struct __pmtrans_t PM_TRANS;
|
2005-03-29 15:31:03 -05:00
|
|
|
typedef struct __pmdepmissing_t PM_DEPMISS;
|
2005-03-14 20:51:43 -05:00
|
|
|
|
|
|
|
/*
|
|
|
|
* Library
|
|
|
|
*/
|
|
|
|
|
|
|
|
int alpm_initialize(char *root);
|
|
|
|
int alpm_release();
|
|
|
|
|
|
|
|
/*
|
|
|
|
* Logging facilities
|
|
|
|
*/
|
|
|
|
|
|
|
|
/* Levels */
|
|
|
|
#define PM_LOG_DEBUG 0x01
|
|
|
|
#define PM_LOG_ERROR 0x02
|
|
|
|
#define PM_LOG_WARNING 0x04
|
|
|
|
#define PM_LOG_FLOW1 0x08
|
|
|
|
#define PM_LOG_FLOW2 0x10
|
|
|
|
#define PM_LOG_FUNCTION 0x20
|
|
|
|
|
2005-03-16 15:46:30 -05:00
|
|
|
/* Log callback */
|
|
|
|
typedef void (*alpm_cb_log)(unsigned short, char *);
|
|
|
|
|
2005-03-14 20:51:43 -05:00
|
|
|
int alpm_logaction(char *fmt, ...);
|
|
|
|
|
|
|
|
/*
|
|
|
|
* Options
|
|
|
|
*/
|
|
|
|
|
|
|
|
/* Parameters */
|
|
|
|
enum {
|
|
|
|
PM_OPT_LOGCB = 1,
|
|
|
|
PM_OPT_LOGMASK,
|
|
|
|
PM_OPT_USESYSLOG,
|
|
|
|
PM_OPT_ROOT,
|
|
|
|
PM_OPT_DBPATH,
|
|
|
|
PM_OPT_LOGFILE,
|
|
|
|
PM_OPT_LOCALDB,
|
|
|
|
PM_OPT_SYNCDB,
|
|
|
|
PM_OPT_NOUPGRADE,
|
2005-10-07 19:29:49 -04:00
|
|
|
PM_OPT_NOEXTRACT,
|
2005-03-14 20:51:43 -05:00
|
|
|
PM_OPT_IGNOREPKG,
|
|
|
|
PM_OPT_HOLDPKG
|
|
|
|
};
|
|
|
|
|
|
|
|
int alpm_set_option(unsigned char parm, unsigned long data);
|
|
|
|
int alpm_get_option(unsigned char parm, long *data);
|
|
|
|
|
|
|
|
/*
|
|
|
|
* Databases
|
|
|
|
*/
|
|
|
|
|
2005-04-02 18:20:00 -05:00
|
|
|
/* Info parameters */
|
|
|
|
enum {
|
|
|
|
PM_DB_TREENAME = 1,
|
|
|
|
PM_DB_LASTUPDATE
|
|
|
|
};
|
|
|
|
|
2005-03-29 15:52:22 -05:00
|
|
|
PM_DB *alpm_db_register(char *treename);
|
2005-03-14 20:51:43 -05:00
|
|
|
int alpm_db_unregister(PM_DB *db);
|
|
|
|
|
2005-04-02 18:20:00 -05:00
|
|
|
void *alpm_db_getinfo(PM_DB *db, unsigned char parm);
|
|
|
|
|
2005-03-20 04:22:03 -05:00
|
|
|
int alpm_db_update(PM_DB *db, char *archive, char *ts);
|
2005-03-16 14:31:20 -05:00
|
|
|
|
2005-03-14 20:51:43 -05:00
|
|
|
PM_PKG *alpm_db_readpkg(PM_DB *db, char *name);
|
|
|
|
PM_LIST *alpm_db_getpkgcache(PM_DB *db);
|
|
|
|
|
|
|
|
PM_GRP *alpm_db_readgrp(PM_DB *db, char *name);
|
|
|
|
PM_LIST *alpm_db_getgrpcache(PM_DB *db);
|
|
|
|
|
|
|
|
/*
|
|
|
|
* Packages
|
|
|
|
*/
|
|
|
|
|
|
|
|
/* Info parameters */
|
|
|
|
enum {
|
|
|
|
/* Desc entry */
|
|
|
|
PM_PKG_NAME = 1,
|
|
|
|
PM_PKG_VERSION,
|
|
|
|
PM_PKG_DESC,
|
|
|
|
PM_PKG_GROUPS,
|
|
|
|
PM_PKG_URL,
|
|
|
|
PM_PKG_LICENSE,
|
|
|
|
PM_PKG_ARCH,
|
|
|
|
PM_PKG_BUILDDATE,
|
|
|
|
PM_PKG_INSTALLDATE,
|
|
|
|
PM_PKG_PACKAGER,
|
|
|
|
PM_PKG_SIZE,
|
|
|
|
PM_PKG_REASON,
|
|
|
|
PM_PKG_MD5SUM, /* Sync DB only */
|
|
|
|
/* Depends entry */
|
|
|
|
PM_PKG_DEPENDS,
|
|
|
|
PM_PKG_REQUIREDBY,
|
|
|
|
PM_PKG_CONFLICTS,
|
|
|
|
PM_PKG_PROVIDES,
|
2005-10-08 16:43:25 -04:00
|
|
|
PM_PKG_REPLACES, /* Sync DB only */
|
2005-03-14 20:51:43 -05:00
|
|
|
/* Files entry */
|
|
|
|
PM_PKG_FILES,
|
|
|
|
PM_PKG_BACKUP,
|
|
|
|
/* Sciplet */
|
2005-04-02 18:20:00 -05:00
|
|
|
PM_PKG_SCRIPLET,
|
|
|
|
/* Misc */
|
2005-04-16 18:23:28 -04:00
|
|
|
PM_PKG_DATA
|
2005-03-14 20:51:43 -05:00
|
|
|
};
|
|
|
|
|
|
|
|
/* reasons -- ie, why the package was installed */
|
2005-05-02 03:42:18 -04:00
|
|
|
#define PM_PKG_REASON_EXPLICIT 0 /* explicitly requested by the user */
|
|
|
|
#define PM_PKG_REASON_DEPEND 1 /* installed as a dependency for another package */
|
2005-03-14 20:51:43 -05:00
|
|
|
|
|
|
|
void *alpm_pkg_getinfo(PM_PKG *pkg, unsigned char parm);
|
|
|
|
int alpm_pkg_load(char *filename, PM_PKG **pkg);
|
2005-10-10 11:03:35 -04:00
|
|
|
int alpm_pkg_free(PM_PKG *pkg);
|
2005-03-14 20:51:43 -05:00
|
|
|
int alpm_pkg_vercmp(const char *ver1, const char *ver2);
|
|
|
|
|
|
|
|
/*
|
|
|
|
* Groups
|
|
|
|
*/
|
|
|
|
|
|
|
|
/* Info parameters */
|
|
|
|
enum {
|
|
|
|
PM_GRP_NAME = 1,
|
|
|
|
PM_GRP_PKGNAMES
|
|
|
|
};
|
|
|
|
|
|
|
|
void *alpm_grp_getinfo(PM_GRP *grp, unsigned char parm);
|
|
|
|
|
|
|
|
/*
|
|
|
|
* Sync
|
|
|
|
*/
|
|
|
|
|
|
|
|
/* Types */
|
|
|
|
enum {
|
2005-04-06 14:29:17 -04:00
|
|
|
PM_SYNC_TYPE_REPLACE = 1,
|
|
|
|
PM_SYNC_TYPE_UPGRADE,
|
|
|
|
PM_SYNC_TYPE_DEPEND
|
2005-03-14 20:51:43 -05:00
|
|
|
};
|
|
|
|
/* Info parameters */
|
|
|
|
enum {
|
|
|
|
PM_SYNC_TYPE = 1,
|
2005-04-16 18:23:28 -04:00
|
|
|
PM_SYNC_PKG,
|
|
|
|
PM_SYNC_DATA
|
2005-03-14 20:51:43 -05:00
|
|
|
};
|
|
|
|
|
2005-04-06 14:29:17 -04:00
|
|
|
void *alpm_sync_getinfo(PM_SYNCPKG *sync, unsigned char parm);
|
2005-03-14 20:51:43 -05:00
|
|
|
|
|
|
|
/*
|
|
|
|
* Transactions
|
|
|
|
*/
|
|
|
|
|
|
|
|
/* Types */
|
|
|
|
enum {
|
|
|
|
PM_TRANS_TYPE_ADD = 1,
|
|
|
|
PM_TRANS_TYPE_REMOVE,
|
|
|
|
PM_TRANS_TYPE_UPGRADE,
|
|
|
|
PM_TRANS_TYPE_SYNC
|
|
|
|
};
|
|
|
|
|
|
|
|
/* Flags */
|
|
|
|
#define PM_TRANS_FLAG_NODEPS 0x01
|
|
|
|
#define PM_TRANS_FLAG_FORCE 0x02
|
|
|
|
#define PM_TRANS_FLAG_NOSAVE 0x04
|
|
|
|
#define PM_TRANS_FLAG_FRESHEN 0x08
|
|
|
|
#define PM_TRANS_FLAG_CASCADE 0x10
|
|
|
|
#define PM_TRANS_FLAG_RECURSE 0x20
|
|
|
|
#define PM_TRANS_FLAG_DBONLY 0x40
|
|
|
|
|
2005-10-09 02:09:57 -04:00
|
|
|
/* Transaction Events */
|
2005-03-14 20:51:43 -05:00
|
|
|
enum {
|
2005-04-02 15:28:01 -05:00
|
|
|
PM_TRANS_EVT_CHECKDEPS_START = 1,
|
|
|
|
PM_TRANS_EVT_CHECKDEPS_DONE,
|
|
|
|
PM_TRANS_EVT_FILECONFLICTS_START,
|
|
|
|
PM_TRANS_EVT_FILECONFLICTS_DONE,
|
|
|
|
PM_TRANS_EVT_RESOLVEDEPS_START,
|
|
|
|
PM_TRANS_EVT_RESOLVEDEPS_DONE,
|
2005-04-13 15:59:04 -04:00
|
|
|
PM_TRANS_EVT_INTERCONFLICTS_START,
|
|
|
|
PM_TRANS_EVT_INTERCONFLICTS_DONE,
|
2005-03-15 13:41:02 -05:00
|
|
|
PM_TRANS_EVT_ADD_START,
|
|
|
|
PM_TRANS_EVT_ADD_DONE,
|
|
|
|
PM_TRANS_EVT_REMOVE_START,
|
|
|
|
PM_TRANS_EVT_REMOVE_DONE,
|
|
|
|
PM_TRANS_EVT_UPGRADE_START,
|
|
|
|
PM_TRANS_EVT_UPGRADE_DONE
|
2005-03-14 20:51:43 -05:00
|
|
|
};
|
|
|
|
|
2005-10-09 02:09:57 -04:00
|
|
|
/* Transaction Conversations (ie, questions) */
|
|
|
|
enum {
|
|
|
|
PM_TRANS_CONV_INSTALL_IGNOREPKG,
|
|
|
|
PM_TRANS_CONV_REPLACE_PKG,
|
|
|
|
PM_TRANS_CONV_LOCAL_NEWER,
|
|
|
|
PM_TRANS_CONV_LOCAL_UPTODATE
|
|
|
|
};
|
|
|
|
|
|
|
|
/* Transaction Event callback */
|
2005-05-04 15:55:23 -04:00
|
|
|
typedef void (*alpm_trans_cb_event)(unsigned char, void *, void *);
|
|
|
|
|
2005-10-09 02:09:57 -04:00
|
|
|
/* Transaction Conversation callback */
|
|
|
|
typedef void (*alpm_trans_cb_conv)(unsigned char, void *, void *, void *, int *);
|
2005-03-14 20:51:43 -05:00
|
|
|
|
|
|
|
/* Info parameters */
|
|
|
|
enum {
|
|
|
|
PM_TRANS_TYPE = 1,
|
|
|
|
PM_TRANS_FLAGS,
|
2005-04-02 15:28:01 -05:00
|
|
|
PM_TRANS_TARGETS,
|
2005-04-06 17:00:57 -04:00
|
|
|
PM_TRANS_PACKAGES
|
2005-03-14 20:51:43 -05:00
|
|
|
};
|
|
|
|
|
|
|
|
void *alpm_trans_getinfo(unsigned char parm);
|
2005-10-09 02:09:57 -04:00
|
|
|
int alpm_trans_init(unsigned char type, unsigned char flags, alpm_trans_cb_event cb_event, alpm_trans_cb_conv conv);
|
2005-04-16 18:23:28 -04:00
|
|
|
int alpm_trans_sysupgrade();
|
2005-03-14 20:51:43 -05:00
|
|
|
int alpm_trans_addtarget(char *target);
|
|
|
|
int alpm_trans_prepare(PM_LIST **data);
|
|
|
|
int alpm_trans_commit();
|
|
|
|
int alpm_trans_release();
|
|
|
|
|
2005-03-29 15:31:03 -05:00
|
|
|
/*
|
|
|
|
* Dependencies
|
|
|
|
*/
|
|
|
|
|
|
|
|
enum {
|
|
|
|
PM_DEP_MOD_ANY = 1,
|
|
|
|
PM_DEP_MOD_EQ,
|
|
|
|
PM_DEP_MOD_GE,
|
|
|
|
PM_DEP_MOD_LE
|
|
|
|
};
|
|
|
|
enum {
|
|
|
|
PM_DEP_TYPE_DEPEND = 1,
|
|
|
|
PM_DEP_TYPE_REQUIRED,
|
|
|
|
PM_DEP_TYPE_CONFLICT
|
|
|
|
};
|
|
|
|
/* Dependencies parameters */
|
|
|
|
enum {
|
|
|
|
PM_DEP_TARGET = 1,
|
|
|
|
PM_DEP_TYPE,
|
|
|
|
PM_DEP_MOD,
|
|
|
|
PM_DEP_NAME,
|
|
|
|
PM_DEP_VERSION
|
|
|
|
};
|
|
|
|
|
|
|
|
void *alpm_dep_getinfo(PM_DEPMISS *miss, unsigned char parm);
|
|
|
|
|
2005-03-14 20:51:43 -05:00
|
|
|
/*
|
|
|
|
* PM_LIST helpers
|
|
|
|
*/
|
|
|
|
PM_LIST *alpm_list_first(PM_LIST *list);
|
|
|
|
PM_LIST *alpm_list_next(PM_LIST *entry);
|
|
|
|
void *alpm_list_getdata(PM_LIST *entry);
|
|
|
|
int alpm_list_free(PM_LIST *entry);
|
|
|
|
|
|
|
|
/*
|
|
|
|
* Helpers
|
|
|
|
*/
|
|
|
|
|
|
|
|
char *alpm_get_md5sum(char *name);
|
|
|
|
|
|
|
|
/*
|
|
|
|
* Errors
|
|
|
|
*/
|
|
|
|
|
|
|
|
extern enum __pmerrno_t {
|
|
|
|
PM_ERR_NOERROR = 1,
|
|
|
|
PM_ERR_MEMORY,
|
|
|
|
PM_ERR_SYSTEM,
|
|
|
|
PM_ERR_BADPERMS,
|
|
|
|
PM_ERR_NOT_A_FILE,
|
|
|
|
PM_ERR_WRONG_ARGS,
|
|
|
|
/* Interface */
|
|
|
|
PM_ERR_HANDLE_NULL,
|
|
|
|
PM_ERR_HANDLE_NOT_NULL,
|
|
|
|
PM_ERR_HANDLE_LOCK,
|
|
|
|
/* Databases */
|
|
|
|
PM_ERR_DB_OPEN,
|
|
|
|
PM_ERR_DB_CREATE,
|
|
|
|
PM_ERR_DB_NULL,
|
|
|
|
PM_ERR_DB_NOT_NULL,
|
2005-10-08 19:40:49 -04:00
|
|
|
PM_ERR_DB_NOT_FOUND,
|
2005-03-14 20:51:43 -05:00
|
|
|
PM_ERR_DB_WRITE,
|
2005-03-22 15:14:49 -05:00
|
|
|
PM_ERR_DB_UPTODATE,
|
2005-03-14 20:51:43 -05:00
|
|
|
/* Cache */
|
|
|
|
PM_ERR_CACHE_NULL,
|
|
|
|
/* Configuration */
|
|
|
|
PM_ERR_OPT_LOGFILE,
|
|
|
|
PM_ERR_OPT_DBPATH,
|
|
|
|
PM_ERR_OPT_LOCALDB,
|
|
|
|
PM_ERR_OPT_SYNCDB,
|
|
|
|
PM_ERR_OPT_USESYSLOG,
|
|
|
|
/* Transactions */
|
|
|
|
PM_ERR_TRANS_NOT_NULL,
|
|
|
|
PM_ERR_TRANS_NULL,
|
|
|
|
PM_ERR_TRANS_DUP_TARGET,
|
|
|
|
PM_ERR_TRANS_INITIALIZED,
|
|
|
|
PM_ERR_TRANS_NOT_INITIALIZED,
|
|
|
|
PM_ERR_TRANS_NOT_PREPARED,
|
|
|
|
PM_ERR_TRANS_ABORT,
|
|
|
|
/* Packages */
|
|
|
|
PM_ERR_PKG_NOT_FOUND,
|
|
|
|
PM_ERR_PKG_INVALID,
|
|
|
|
PM_ERR_PKG_OPEN,
|
|
|
|
PM_ERR_PKG_LOAD,
|
|
|
|
PM_ERR_PKG_INSTALLED,
|
|
|
|
PM_ERR_PKG_CANT_FRESH,
|
2005-04-17 06:01:22 -04:00
|
|
|
PM_ERR_PKG_INVALID_NAME,
|
2005-03-14 20:51:43 -05:00
|
|
|
/* Groups */
|
|
|
|
PM_ERR_GRP_NOT_FOUND,
|
|
|
|
/* Dependencies */
|
|
|
|
PM_ERR_UNSATISFIED_DEPS,
|
|
|
|
PM_ERR_CONFLICTING_DEPS,
|
|
|
|
PM_ERR_UNRESOLVABLE_DEPS,
|
|
|
|
PM_ERR_FILE_CONFLICTS,
|
|
|
|
/* Misc */
|
|
|
|
PM_ERR_USER_ABORT,
|
2005-03-22 15:14:49 -05:00
|
|
|
PM_ERR_INTERNAL_ERROR,
|
|
|
|
PM_ERR_XXX
|
2005-03-14 20:51:43 -05:00
|
|
|
} pm_errno;
|
|
|
|
|
|
|
|
char *alpm_strerror(int err);
|
|
|
|
|
|
|
|
#endif /* _ALPM_H */
|
|
|
|
|
|
|
|
/* vim: set ts=2 sw=2 noet: */
|