alpm_api_trans man page

alpm_api_trans — Transaction Functions

Functions to manipulate libalpm transactions.

Typedefs

typedef enum _alpm_transflag_t alpm_transflag_t
Transaction flags.

Enumerations

enum _alpm_transflag_t { ALPM_TRANS_FLAG_NODEPS = 1, ALPM_TRANS_FLAG_FORCE = (1 << 1), ALPM_TRANS_FLAG_NOSAVE = (1 << 2), ALPM_TRANS_FLAG_NODEPVERSION = (1 << 3), ALPM_TRANS_FLAG_CASCADE = (1 << 4), ALPM_TRANS_FLAG_RECURSE = (1 << 5), ALPM_TRANS_FLAG_DBONLY = (1 << 6), ALPM_TRANS_FLAG_ALLDEPS = (1 << 8), ALPM_TRANS_FLAG_DOWNLOADONLY = (1 << 9), ALPM_TRANS_FLAG_NOSCRIPTLET = (1 << 10), ALPM_TRANS_FLAG_NOCONFLICTS = (1 << 11), ALPM_TRANS_FLAG_NEEDED = (1 << 13), ALPM_TRANS_FLAG_ALLEXPLICIT = (1 << 14), ALPM_TRANS_FLAG_UNNEEDED = (1 << 15), ALPM_TRANS_FLAG_RECURSEALL = (1 << 16), ALPM_TRANS_FLAG_NOLOCK = (1 << 17) } Transaction flags. "

Functions

alpm_transflag_t alpm_trans_get_flags (alpm_handle_t *handle)
Returns the bitfield of flags for the current transaction.
alpm_list_t * alpm_trans_get_add (alpm_handle_t *handle)
Returns a list of packages added by the transaction.
alpm_list_t * alpm_trans_get_remove (alpm_handle_t *handle)
Returns the list of packages removed by the transaction.
int alpm_trans_init (alpm_handle_t *handle, alpm_transflag_t flags)
Initialize the transaction.
int alpm_trans_prepare (alpm_handle_t *handle, alpm_list_t **data)
Prepare a transaction.
int alpm_trans_commit (alpm_handle_t *handle, alpm_list_t **data)
Commit a transaction.
int alpm_trans_interrupt (alpm_handle_t *handle)
Interrupt a transaction.
int alpm_trans_release (alpm_handle_t *handle)
Release a transaction.

Detailed Description

Functions to manipulate libalpm transactions.

Typedef Documentation

typedef enum _alpm_transflag_t alpm_transflag_t

Transaction flags.

Enumeration Type Documentation

enum _alpm_transflag_t

Transaction flags.

Enumerator

ALPM_TRANS_FLAG_NODEPS
Ignore dependency checks.
ALPM_TRANS_FLAG_FORCE
Ignore file conflicts and overwrite files.
ALPM_TRANS_FLAG_NOSAVE
Delete files even if they are tagged as backup.
ALPM_TRANS_FLAG_NODEPVERSION
Ignore version numbers when checking dependencies.
ALPM_TRANS_FLAG_CASCADE
Remove also any packages depending on a package being removed.
ALPM_TRANS_FLAG_RECURSE
Remove packages and their unneeded deps (not explicitly installed).
ALPM_TRANS_FLAG_DBONLY
Modify database but do not commit changes to the filesystem.
ALPM_TRANS_FLAG_ALLDEPS
Use ALPM_PKG_REASON_DEPEND when installing packages.
ALPM_TRANS_FLAG_DOWNLOADONLY
Only download packages and do not actually install.
ALPM_TRANS_FLAG_NOSCRIPTLET
Do not execute install scriptlets after installing.
ALPM_TRANS_FLAG_NOCONFLICTS
Ignore dependency conflicts.
ALPM_TRANS_FLAG_NEEDED
Do not install a package if it is already installed and up to date.
ALPM_TRANS_FLAG_ALLEXPLICIT
Use ALPM_PKG_REASON_EXPLICIT when installing packages.
ALPM_TRANS_FLAG_UNNEEDED
Do not remove a package if it is needed by another one.
ALPM_TRANS_FLAG_RECURSEALL
Remove also explicitly installed unneeded deps (use with ALPM_TRANS_FLAG_RECURSE).
ALPM_TRANS_FLAG_NOLOCK
Do not lock the database during the operation.

Function Documentation

int alpm_trans_commit (alpm_handle_t * handle, alpm_list_t ** data)

Commit a transaction.

Parameters:

handle the context handle
data the address of an alpm_list where detailed description of an error can be dumped (i.e. list of conflicting files)

Returns:

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

References ALPM_EVENT_TRANSACTION_DONE, ALPM_EVENT_TRANSACTION_START, alpm_logaction(), ALPM_TRANS_FLAG_DOWNLOADONLY, and ALPM_TRANS_FLAG_NOLOCK.

alpm_list_t* alpm_trans_get_add (alpm_handle_t * handle)

Returns a list of packages added by the transaction.

Parameters:

handle the context handle

Returns:

a list of alpm_pkg_t structures

alpm_transflag_t alpm_trans_get_flags (alpm_handle_t * handle)

Returns the bitfield of flags for the current transaction.

Parameters:

handle the context handle

Returns:

the bitfield of transaction flags

alpm_list_t* alpm_trans_get_remove (alpm_handle_t * handle)

Returns the list of packages removed by the transaction.

Parameters:

handle the context handle

Returns:

a list of alpm_pkg_t structures

int alpm_trans_init (alpm_handle_t * handle, alpm_transflag_t flags)

Initialize the transaction.

Parameters:

handle the context handle
flags flags of the transaction (like nodeps, etc)

Returns:

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

References alpm_list_add(), alpm_pkg_get_arch(), ALPM_TRANS_FLAG_NOLOCK, __alpm_list_t::data, and __alpm_list_t::next.

int alpm_trans_interrupt (alpm_handle_t * handle)

Interrupt a transaction.

Parameters:

handle the context handle

Returns:

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

Note:

Safe to call from inside signal handlers.

int alpm_trans_prepare (alpm_handle_t * handle, alpm_list_t ** data)

Prepare a transaction.

Parameters:

handle the context handle
data the address of an alpm_list where a list of alpm_depmissing_t objects is dumped (conflicting packages)

Returns:

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

References alpm_list_free(), and ALPM_TRANS_FLAG_NODEPS.

int alpm_trans_release (alpm_handle_t * handle)

Release a transaction.

Parameters:

handle the context handle

Returns:

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

References alpm_list_free(), alpm_list_free_inner(), and ALPM_TRANS_FLAG_NOLOCK.

Author

Generated automatically by Doxygen for libalpm from the source code.

Info

Thu Mar 31 2016 libalpm