/*

 * Copyright (c) 2007-2009, Novell Inc.

 *

 * This program is licensed under the BSD license, read LICENSE.BSD

 * for further information

 */

/*

 * transaction.h

 *

 */

#ifndef LIBSOLV_TRANSACTION_H

#define LIBSOLV_TRANSACTION_H

#include "pooltypes.h"

#include "queue.h"

#include "bitmap.h"

#ifdef __cplusplus

extern "C" {

#endif

struct s_Pool;

struct s_DUChanges;

struct s_TransactionOrderdata;

typedef struct s_Transaction {

  struct s_Pool *pool;		/* back pointer to pool */

  Queue steps;			/* the transaction steps */

#ifdef LIBSOLV_INTERNAL

  Queue transaction_info;

  Id *transaction_installed;

  Map transactsmap;

  Map multiversionmap;

  struct s_TransactionOrderdata *orderdata;

#endif

} Transaction;

/* step types */

#define SOLVER_TRANSACTION_IGNORE		0x00

#define SOLVER_TRANSACTION_ERASE		0x10

#define SOLVER_TRANSACTION_REINSTALLED		0x11

#define SOLVER_TRANSACTION_DOWNGRADED		0x12

#define SOLVER_TRANSACTION_CHANGED		0x13

#define SOLVER_TRANSACTION_UPGRADED		0x14

#define SOLVER_TRANSACTION_OBSOLETED		0x15

#define SOLVER_TRANSACTION_INSTALL		0x20

#define SOLVER_TRANSACTION_REINSTALL		0x21

#define SOLVER_TRANSACTION_DOWNGRADE		0x22

#define SOLVER_TRANSACTION_CHANGE		0x23

#define SOLVER_TRANSACTION_UPGRADE		0x24

#define SOLVER_TRANSACTION_OBSOLETES		0x25

#define SOLVER_TRANSACTION_MULTIINSTALL		0x30

#define SOLVER_TRANSACTION_MULTIREINSTALL	0x31

#define SOLVER_TRANSACTION_MAXTYPE		0x3f

/* modes */

#define SOLVER_TRANSACTION_SHOW_ACTIVE		(1 << 0)

#define SOLVER_TRANSACTION_SHOW_ALL		(1 << 1)

#define SOLVER_TRANSACTION_SHOW_OBSOLETES	(1 << 2)

#define SOLVER_TRANSACTION_SHOW_MULTIINSTALL	(1 << 3)

#define SOLVER_TRANSACTION_CHANGE_IS_REINSTALL	(1 << 4)

#define SOLVER_TRANSACTION_MERGE_VENDORCHANGES	(1 << 5)

#define SOLVER_TRANSACTION_MERGE_ARCHCHANGES	(1 << 6)

#define SOLVER_TRANSACTION_RPM_ONLY		(1 << 7)

#define SOLVER_TRANSACTION_KEEP_PSEUDO		(1 << 8)

#define SOLVER_TRANSACTION_OBSOLETE_IS_UPGRADE  (1 << 9)

/* extra classifications */

#define SOLVER_TRANSACTION_ARCHCHANGE		0x100

#define SOLVER_TRANSACTION_VENDORCHANGE		0x101

/* order flags */

#define SOLVER_TRANSACTION_KEEP_ORDERDATA	(1 << 0)

#define SOLVER_TRANSACTION_KEEP_ORDERCYCLES	(1 << 1)

/* cycle severities */

#define SOLVER_ORDERCYCLE_HARMLESS		0

#define SOLVER_ORDERCYCLE_NORMAL		1

#define SOLVER_ORDERCYCLE_CRITICAL		2

extern Transaction *transaction_create(struct s_Pool *pool);

extern Transaction *transaction_create_decisionq(struct s_Pool *pool, Queue *decisionq, Map *multiversionmap);

extern Transaction *transaction_create_clone(Transaction *srctrans);

extern void transaction_free(Transaction *trans);

/* if p is installed, returns with pkg(s) obsolete p */

/* if p is not installed, returns with pkg(s) we obsolete */

extern Id   transaction_obs_pkg(Transaction *trans, Id p);

extern void transaction_all_obs_pkgs(Transaction *trans, Id p, Queue *pkgs);

/* return step type of a transaction element */

extern Id   transaction_type(Transaction *trans, Id p, int mode);

/* return sorted collection of all step types */

/* classify_pkgs can be used to return all packages of a type */

extern void transaction_classify(Transaction *trans, int mode, Queue *classes);

extern void transaction_classify_pkgs(Transaction *trans, int mode, Id type, Id from, Id to, Queue *pkgs);

/* return all packages that will be installed after the transaction is run*/

/* The new packages are put at the head of the queue, the number of new

   packages is returned */

extern int transaction_installedresult(Transaction *trans, Queue *installedq);

long long transaction_calc_installsizechange(Transaction *trans);

void transaction_calc_duchanges(Transaction *trans, struct s_DUChanges *mps, int nmps);

/* order a transaction */

extern void transaction_order(Transaction *trans, int flags);

/* roll your own order funcion:

 * add pkgs free for installation to queue choices after chosen was

 * installed. start with chosen = 0

 * needs an ordered transaction created with SOLVER_TRANSACTION_KEEP_ORDERDATA */

extern int  transaction_order_add_choices(Transaction *trans, Id chosen, Queue *choices);

/* add obsoleted packages into transaction steps */

extern void transaction_add_obsoleted(Transaction *trans);

/* debug function, report problems found in the order */

extern void transaction_check_order(Transaction *trans);

/* order cycle introspection */

extern void transaction_order_get_cycleids(Transaction *trans, Queue *q, int minseverity);

extern int transaction_order_get_cycle(Transaction *trans, Id cid, Queue *q);

extern void transaction_free_orderdata(Transaction *trans);

extern void transaction_clone_orderdata(Transaction *trans, Transaction *srctrans);

#ifdef __cplusplus

}

#endif

#endif