From: Michael Schroeder Date: Thu, 13 Jun 2013 15:09:32 +0000 (+0200) Subject: start with the libsolv-pool manpage X-Git-Tag: upstream/0.4.0~83 X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=6c5be3a8fbc640d01b232a1d8fd5179933ea33af;p=platform%2Fupstream%2Flibsolv.git start with the libsolv-pool manpage --- diff --git a/doc/libsolv-bindings.3 b/doc/libsolv-bindings.3 index 5b5ae59..3ac85c6 100644 --- a/doc/libsolv-bindings.3 +++ b/doc/libsolv-bindings.3 @@ -2,12 +2,12 @@ .\" Title: Libsolv-Bindings .\" Author: [see the "Author" section] .\" Generator: DocBook XSL Stylesheets v1.76.1 -.\" Date: 06/11/2013 +.\" Date: 06/13/2013 .\" Manual: LIBSOLV .\" Source: libsolv .\" Language: English .\" -.TH "LIBSOLV\-BINDINGS" "3" "06/11/2013" "libsolv" "LIBSOLV" +.TH "LIBSOLV\-BINDINGS" "3" "06/13/2013" "libsolv" "LIBSOLV" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -476,7 +476,7 @@ An implicit obsoletes is the internal mechanism to remove the old package on an .PP \fBPOOL_FLAG_OBSOLETEUSESCOLORS\fR .RS 4 -Rpm\(cqs multilib implementation (used in RedHat and Fedora) distinguishes between 32bit and 64bit packages (the terminology is that they have a different color)\&. If obsolteusescolors is set, packages with different colors will not obsolete each other\&. +Rpm\(cqs multilib implementation (used in RedHat and Fedora) distinguishes between 32bit and 64bit packages (the terminology is that they have a different color)\&. If obsoleteusescolors is set, packages with different colors will not obsolete each other\&. .RE .PP \fBPOOL_FLAG_IMPLICITOBSOLETEUSESCOLORS\fR diff --git a/doc/libsolv-bindings.txt b/doc/libsolv-bindings.txt index b77540c..e190cb3 100644 --- a/doc/libsolv-bindings.txt +++ b/doc/libsolv-bindings.txt @@ -262,7 +262,7 @@ Define which repository contains all the installed packages. *POOL_FLAG_OBSOLETEUSESCOLORS*:: Rpm's multilib implementation (used in RedHat and Fedora) distinguishes between 32bit and 64bit packages (the terminology - is that they have a different color). If obsolteusescolors is + is that they have a different color). If obsoleteusescolors is set, packages with different colors will not obsolete each other. *POOL_FLAG_IMPLICITOBSOLETEUSESCOLORS*:: diff --git a/doc/libsolv-pool.3 b/doc/libsolv-pool.3 new file mode 100644 index 0000000..2eec7f2 --- /dev/null +++ b/doc/libsolv-pool.3 @@ -0,0 +1,1242 @@ +'\" t +.\" Title: Libsolv-Pool +.\" Author: [see the "Author" section] +.\" Generator: DocBook XSL Stylesheets v1.76.1 +.\" Date: 06/13/2013 +.\" Manual: LIBSOLV +.\" Source: libsolv +.\" Language: English +.\" +.TH "LIBSOLV\-POOL" "3" "06/13/2013" "libsolv" "LIBSOLV" +.\" ----------------------------------------------------------------- +.\" * Define some portability stuff +.\" ----------------------------------------------------------------- +.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +.\" http://bugs.debian.org/507673 +.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html +.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +.ie \n(.g .ds Aq \(aq +.el .ds Aq ' +.\" ----------------------------------------------------------------- +.\" * set default formatting +.\" ----------------------------------------------------------------- +.\" disable hyphenation +.nh +.\" disable justification (adjust text to left margin only) +.ad l +.\" ----------------------------------------------------------------- +.\" * MAIN CONTENT STARTS HERE * +.\" ----------------------------------------------------------------- +.SH "NAME" +libsolv-pool \- Libsolv\*(Aqs pool object +.SH "PUBLIC ATTRIBUTES" +.PP +\fBvoid *appdata\fR +.RS 4 +A no\-purpose pointer free to use for the library user\&. Freeing the pool simply discards the pointer\&. +.RE +.PP +\fBStringpool ss\fR +.RS 4 +The pool of unified strings\&. +.RE +.PP +\fBReldep *rels\fR +.RS 4 +The pool of unified relation dependencies\&. +.RE +.PP +\fBint nrels\fR +.RS 4 +Number of allocated relation dependencies\&. +.RE +.PP +\fBRepo **repos\fR +.RS 4 +The array of repository pointers, indexed by repository Id\&. +.RE +.PP +\fBint nrepos\fR +.RS 4 +Number of allocated repository array elements, i\&.e\&. the size of the repos array\&. +.RE +.PP +\fBint urepos\fR +.RS 4 +Number of used (i\&.e\&. non\-zero) repository array elements\&. +.RE +.PP +\fBRepo *installed\fR +.RS 4 +Pointer to the repo holding the installed packages\&. You are free to read this attribute, but you should use pool_set_installed() if you want to change it\&. +.RE +.PP +\fBSolvable *solvables\fR +.RS 4 +The array of Solvable objects\&. +.RE +.PP +\fBint nsolvables\fR +.RS 4 +Number of Solvable objects, i\&.e\&. the size of the solvables array\&. Note that the array may contain freed solvables, in that case the repo pointer of the solvable will be zero\&. +.RE +.PP +\fBint disttype\fR +.RS 4 +The distribution type of your system, e\&.g\&. DISTTYPE_DEB\&. You are free to read this attribute, but you should use pool_setdisttype() if you want to change it\&. +.RE +.PP +\fBId *whatprovidesdata\fR +.RS 4 +Multi\-purpose Id storage holding zero terminated arrays of Ids\&. pool_whatprovides() returns an offset into this data\&. +.RE +.PP +\fBMap *considered\fR +.RS 4 +Optional bitmap that can make the library ignore solvables\&. If a bitmap is set, only solvables that have a set bit in the bitmap at their Id are considered usable\&. +.RE +.PP +\fBint debugmask\fR +.RS 4 +A mask that defines which debug events should be reported\&. pool_setdebuglevel() sets this mask\&. +.RE +.PP +\fBDatapos pos\fR +.RS 4 +An object storing some position in the repository data\&. Functions like dataiterator_set_pos() set this object, accessing data with a pseudo solvable Id of SOLVID_POS uses it\&. +.RE +.PP +\fBQueue pooljobs\fR +.RS 4 +A queue where fixed solver jobs can be stored\&. This jobs are automatically added when solver_solve() is called, they are useful to store configuration data like which packages should be multiversion installed\&. +.RE +.SH "CREATION AND DESTRUCTION" +.sp +.if n \{\ +.RS 4 +.\} +.nf +\fBPool *pool_create()\fR; +.fi +.if n \{\ +.RE +.\} +.sp +Create a new instance of a pool\&. +.sp +.if n \{\ +.RS 4 +.\} +.nf +\fBvoid pool_free(Pool *\fR\fIpool\fR\fB)\fR; +.fi +.if n \{\ +.RE +.\} +.sp +Free a pool and all of the data it contains, e\&.g\&. the solvables, repositories, strings\&. +.SH "DEBUGGING AND ERROR REPORTING" +.SS "Constants" +.PP +\fBSOLV_FATAL\fR +.RS 4 +Report the error and call \(lqexit(1)\(rq afterwards\&. You cannot mask this level\&. Reports to stderr instead of stdout\&. +.RE +.PP +\fBSOLV_ERROR\fR +.RS 4 +Used to report errors\&. Reports to stderr instead of stdout\&. +.RE +.PP +\fBSOLV_WARN\fR +.RS 4 +Used to report warnings\&. +.RE +.PP +\fBSOLV_DEBUG_STATS\fR +.RS 4 +Used to report statistical data\&. +.RE +.PP +\fBSOLV_DEBUG_RULE_CREATION\fR +.RS 4 +Used to report information about the solver\(cqs creation of rules\&. +.RE +.PP +\fBSOLV_DEBUG_PROPAGATE\fR +.RS 4 +Used to report information about the solver\(cqs unit rule propagation process\&. +.RE +.PP +\fBSOLV_DEBUG_ANALYZE\fR +.RS 4 +Used to report information about the solver\(cqs learnt rule generation mechanism\&. +.RE +.PP +\fBSOLV_DEBUG_UNSOLVABLE\fR +.RS 4 +Used to report information about the solver dealing with conflicting rules\&. +.RE +.PP +\fBSOLV_DEBUG_SOLUTIONS\fR +.RS 4 +Used to report information about the solver creating solutions to solve problems\&. +.RE +.PP +\fBSOLV_DEBUG_POLICY\fR +.RS 4 +Used to report information about the solver searching for an optimal solution\&. +.RE +.PP +\fBSOLV_DEBUG_RESULT\fR +.RS 4 +Used by the debug functions to output results\&. +.RE +.PP +\fBSOLV_DEBUG_JOB\fR +.RS 4 +Used to report information about the job rule generation process\&. +.RE +.PP +\fBSOLV_DEBUG_SOLVER\fR +.RS 4 +Used to report information about what the solver is currently doing\&. +.RE +.PP +\fBSOLV_DEBUG_TRANSACTION\fR +.RS 4 +Used to report information about the transaction generation and ordering process\&. +.RE +.PP +\fBSOLV_DEBUG_TO_STDERR\fR +.RS 4 +Write debug messages to stderr instead of stdout\&. +.RE +.SS "Functions" +.sp +.if n \{\ +.RS 4 +.\} +.nf +\fBvoid pool_debug(Pool *\fR\fIpool\fR\fB, int\fR \fItype\fR\fB, const char *\fR\fIformat\fR\fB, \&.\&.\&.)\fR; +.fi +.if n \{\ +.RE +.\} +.sp +Report a message of the type \fItype\fR\&. You can filter debug messages by setting a debug mask\&. +.sp +.if n \{\ +.RS 4 +.\} +.nf +\fBvoid pool_setdebuglevel(Pool *\fR\fIpool\fR\fB, int\fR \fIlevel\fR\fB)\fR; +.fi +.if n \{\ +.RE +.\} +.sp +Set a predefined debug mask\&. A higher level generally means more bits in the mask are set, thus more messages are printed\&. +.sp +.if n \{\ +.RS 4 +.\} +.nf +\fBvoid pool_setdebugmask(Pool *\fR\fIpool\fR\fB, int\fR \fImask\fR\fB)\fR; +.fi +.if n \{\ +.RE +.\} +.sp +Set the debug mask to filter debug messages\&. +.sp +.if n \{\ +.RS 4 +.\} +.nf +\fBint pool_error(Pool *\fR\fIpool\fR\fB, int\fR \fIret\fR\fB, const char *\fR\fIformat\fR\fB, \&.\&.\&.)\fR; +.fi +.if n \{\ +.RE +.\} +.sp +Set the pool\(cqs error string\&. The \fIret\fR value is simply used as a return value of the function so that you can write code like return pool_error(\&...);\&. If the debug mask contains the \fBSOLV_ERROR\fR bit, pool_debug() is also called with the message and type \fBSOLV_ERROR\fR\&. +.sp +.if n \{\ +.RS 4 +.\} +.nf +\fBextern char *pool_errstr(Pool *\fR\fIpool\fR\fB)\fR; +.fi +.if n \{\ +.RE +.\} +.sp +Return the current error string stored in the pool\&. Like with the libc\(cqs errno value, the string is only meaningful after a function returned an error\&. +.sp +.if n \{\ +.RS 4 +.\} +.nf +\fBvoid pool_setdebugcallback(Pool *\fR\fIpool\fR\fB, void (*\fR\fIdebugcallback\fR\fB)(Pool *, void *\fR\fIdata\fR\fB, int\fR \fItype\fR\fB, const char *\fR\fIstr\fR\fB), void *\fR\fIdebugcallbackdata\fR\fB)\fR; +.fi +.if n \{\ +.RE +.\} +.sp +Set a custom debug callback function\&. Instead of writing to stdout or stderr, the callback function will be called\&. +.SH "POOL CONFIGURATION" +.SS "Constants" +.PP +\fBDISTTYPE_RPM\fR +.RS 4 +Used for systems with use rpm as low level package manager\&. +.RE +.PP +\fBDISTTYPE_DEB\fR +.RS 4 +Used for systems with use dpkg as low level package manager\&. +.RE +.PP +\fBDISTTYPE_ARCH\fR +.RS 4 +Used for systems with use the arch linux package manager\&. +.RE +.PP +\fBDISTTYPE_HAIKU\fR +.RS 4 +Used for systems with use haiku packages\&. +.RE +.PP +\fBPOOL_FLAG_PROMOTEEPOCH\fR +.RS 4 +Promote the epoch of the providing dependency to the requesting dependency if it does not contain an epoch\&. Used at some time in old rpm versions, modern systems should never need this\&. +.RE +.PP +\fBPOOL_FLAG_FORBIDSELFCONFLICTS\fR +.RS 4 +Disallow the installation of packages that conflict with themselves\&. Debian always allows self\-conflicting packages, rpm used to forbid them but switched to also allowing them recently\&. +.RE +.PP +\fBPOOL_FLAG_OBSOLETEUSESPROVIDES\fR +.RS 4 +Make obsolete type dependency match against provides instead of just the name and version of packages\&. Very old versions of rpm used the name/version, then it got switched to provides and later switched back again to just name/version\&. +.RE +.PP +\fBPOOL_FLAG_IMPLICITOBSOLETEUSESPROVIDES\fR +.RS 4 +An implicit obsoletes is the internal mechanism to remove the old package on an update\&. The default is to remove all packages with the same name, rpm\-5 switched to also removing packages providing the same name\&. +.RE +.PP +\fBPOOL_FLAG_OBSOLETEUSESCOLORS\fR +.RS 4 +Rpm\(cqs multilib implementation (used in RedHat and Fedora) distinguishes between 32bit and 64bit packages (the terminology is that they have a different color)\&. If obsoleteusescolors is set, packages with different colors will not obsolete each other\&. +.RE +.PP +\fBPOOL_FLAG_IMPLICITOBSOLETEUSESCOLORS\fR +.RS 4 +Same as POOL_FLAG_OBSOLETEUSESCOLORS, but used to find out if packages of the same name can be installed in parallel\&. For current Fedora systems, POOL_FLAG_OBSOLETEUSESCOLORS should be false and POOL_FLAG_IMPLICITOBSOLETEUSESCOLORS should be true (this is the default if FEDORA is defined when libsolv is compiled)\&. +.RE +.PP +\fBPOOL_FLAG_NOINSTALLEDOBSOLETES\fR +.RS 4 +New versions of rpm consider the obsoletes of installed packages when checking for dependency, thus you may not install a package that is obsoleted by some other installed package, unless you also erase the other package\&. +.RE +.PP +\fBPOOL_FLAG_HAVEDISTEPOCH\fR +.RS 4 +Mandriva added a new field called distepoch that gets checked in version comparison if the epoch/version/release of two packages are the same\&. +.RE +.PP +\fBPOOL_FLAG_NOOBSOLETESMULTIVERSION\fR +.RS 4 +If a package is installed in multiversionmode, rpm used to ignore both the implicit obsoletes and the obsolete dependency of a package\&. This was changed to ignoring just the implicit obsoletes, thus you may install multiple versions of the same name, but obsoleted packages still get removed\&. +.RE +.PP +\fBPOOL_FLAG_ADDFILEPROVIDESFILTERED\fR +.RS 4 +Make the addfileprovides method only add files from the standard locations (i\&.e\&. the \(lqbin\(rq and \(lqetc\(rq directories)\&. This is useful if you have only few packages that use non\-standard file dependencies, but you still wand the fast speed that addfileprovides() generates\&. +.RE +.SS "Functions" +.sp +.if n \{\ +.RS 4 +.\} +.nf +\fBvoid pool_setdisttype(Pool *\fR\fIpool\fR\fB, int\fR \fIdisttype\fR\fB)\fR; +.fi +.if n \{\ +.RE +.\} +.sp +Set the package type of your system\&. The disttype is used for example to define package comparison semantics\&. Libsolv\(cqs default disttype should match the package manager of your system, so you only need to use this function if you want to use the library to solve packaging problems for different systems\&. +.sp +.if n \{\ +.RS 4 +.\} +.nf +\fBint pool_set_flag(Pool *\fR\fIpool\fR\fB, int\fR \fIflag\fR\fB, int\fR \fIvalue\fR\fB)\fR; +.fi +.if n \{\ +.RE +.\} +.sp +Set a flag to a new value\&. Returns the old value of the flag\&. +.sp +.if n \{\ +.RS 4 +.\} +.nf +\fBint pool_get_flag(Pool *\fR\fIpool\fR\fB, int\fR \fIflag\fR\fB)\fR; +.fi +.if n \{\ +.RE +.\} +.sp +Get the value of a pool flag\&. See the constants section about the meaning of the flags\&. +.sp +.if n \{\ +.RS 4 +.\} +.nf +\fBvoid pool_set_rootdir(Pool *\fR\fIpool\fR\fB, const char *\fR\fIrootdir\fR\fB)\fR; +.fi +.if n \{\ +.RE +.\} +.sp +Set a specific root directory\&. Some library functions support a flag that tells the function to prepend the rootdir to file and directory names\&. +.sp +.if n \{\ +.RS 4 +.\} +.nf +\fBconst char *pool_get_rootdir(Pool *\fR\fIpool\fR\fB)\fR; +.fi +.if n \{\ +.RE +.\} +.sp +Return the current value of the root directory\&. +.sp +.if n \{\ +.RS 4 +.\} +.nf +\fBchar *pool_prepend_rootdir(Pool *\fR\fIpool\fR\fB, const char *\fR\fIdir\fR\fB)\fR; +.fi +.if n \{\ +.RE +.\} +.sp +Prepend the root directory to the \fIdir\fR argument string\&. The returned string has been newly allocated and needs to be freed after use\&. +.sp +.if n \{\ +.RS 4 +.\} +.nf +\fBchar *pool_prepend_rootdir_tmp(Pool *\fR\fIpool\fR\fB, const char *\fR\fIdir\fR\fB)\fR; +.fi +.if n \{\ +.RE +.\} +.sp +Same as pool_prepend_rootdir, but uses the pool\(cqs temporary space for allocation\&. +.sp +.if n \{\ +.RS 4 +.\} +.nf +\fBvoid pool_set_installed(Pool *\fR\fIpool\fR\fB, Repo *\fR\fIrepo\fR\fB)\fR; +.fi +.if n \{\ +.RE +.\} +.sp +Set which repository should be treated as the \(lqinstalled\(rq repository, i\&.e\&. the one that holds information about the installed packages\&. +.sp +.if n \{\ +.RS 4 +.\} +.nf +\fBvoid pool_set_languages(Pool *\fR\fIpool\fR\fB, const char **\fR\fIlanguages\fR\fB, int\fR \fInlanguages\fR\fB)\fR; +.fi +.if n \{\ +.RE +.\} +.sp +Set the language of your system\&. The library provides lookup functions that return localized strings, for example for package descriptions\&. You can set an array of languages to provide a fallback mechanism if one language is not available\&. +.sp +.if n \{\ +.RS 4 +.\} +.nf +\fBvoid pool_setarch(Pool *\fR\fIpool\fR\fB, const char *\fR\fIarch\fR\fB)\fR; +.fi +.if n \{\ +.RE +.\} +.sp +Set the architecture of your system\&. The architecture is used to determine which packages are installable and which packages cannot be installed\&. The \fIarch\fR argument is normally the \(lqmachine\(rq value of the \(lquname\(rq system call\&. +.sp +.if n \{\ +.RS 4 +.\} +.nf +\fBvoid pool_setarchpolicy(Pool *, const char *)\fR; +.fi +.if n \{\ +.RE +.\} +.sp +Set the architecture policy for your system\&. This is the general version of pool_setarch (in fact pool_setarch calls pool_setarchpolicy internally)\&. See the section about architecture policies for more information\&. +.sp +.if n \{\ +.RS 4 +.\} +.nf +\fBvoid pool_addvendorclass(Pool *\fR\fIpool\fR\fB, const char **\fR\fIvendorclass\fR\fB)\fR; +.fi +.if n \{\ +.RE +.\} +.sp +Add a new vendor equivalence class to the system\&. A vendor equivalence class defines if an installed package of one vendor can be replaced by a package coming from a different vendor\&. The \fIvendorclass\fR argument must be a NULL terminated array of strings\&. See the section about vendor policies for more information\&. +.sp +.if n \{\ +.RS 4 +.\} +.nf +\fBvoid pool_setvendorclasses(Pool *\fR\fIpool\fR\fB, const char **\fR\fIvendorclasses\fR\fB)\fR; +.fi +.if n \{\ +.RE +.\} +.sp +Set all allowed vendor equivalences\&. The vendorclasses argument must be an NULL terminated array consisting of all allowed classes concatenated\&. Each class itself must be NULL terminated, thus the last class ends with two NULL elements, one to finish the class and one to finish the list of classes\&. +.sp +.if n \{\ +.RS 4 +.\} +.nf +\fBvoid pool_set_custom_vendorcheck(Pool *\fR\fIpool\fR\fB, int (*\fR\fIvendorcheck\fR\fB)(Pool *, Solvable *, Solvable *))\fR; +.fi +.if n \{\ +.RE +.\} +.sp +Define a custom vendor check mechanism\&. You can use this if libsolv\(cqs internal vendor equivalence class mechanism does not match your needs\&. +.sp +.if n \{\ +.RS 4 +.\} +.nf +\fBvoid pool_setloadcallback(Pool *\fR\fIpool\fR\fB, int (*\fR\fIcb\fR\fB)(Pool *, Repodata *, void *), void *\fR\fIloadcbdata\fR\fB)\fR; +.fi +.if n \{\ +.RE +.\} +.sp +Define a callback function that gets called when repository metadata needs to be loaded on demand\&. See the section about on demand loading in the libsolv\-repodata manual\&. +.sp +.if n \{\ +.RS 4 +.\} +.nf +\fBvoid pool_setnamespacecallback(Pool *\fR\fIpool\fR\fB, Id (*\fR\fIcb\fR\fB)(Pool *, void *,\fR \fIId\fR\fB,\fR \fIId\fR\fB), void *\fR\fInscbdata\fR\fB)\fR; +.fi +.if n \{\ +.RE +.\} +.sp +Define a callback function to implement custom namespace support\&. See the section about namespace dependencies\&. +.SH "ID POOL MANAGEMENT" +.SS "Constants" +.PP +\fBID_EMPTY\fR +.RS 4 +The Id of the empty string, it is always Id 1\&. +.RE +.PP +\fBREL_LT\fR +.RS 4 +Represents a \(lq<\(rq relation\&. +.RE +.PP +\fBREL_EQ\fR +.RS 4 +Represents a \(lq=\(rq relation\&. +.RE +.PP +\fBREL_GT\fR +.RS 4 +Represents a \(lq>\(rq relation\&. You can use combinations of REL_GT, REL_EQ and REL_LT or\-ed together to create any relation you like\&. +.RE +.PP +\fBREL_AND\fR +.RS 4 +A boolean AND operation, the \(lqname\(rq and \(lqevr\(rq parts of the relation can be two sub\-dependencies\&. Packages must match both parts of the dependency\&. +.RE +.PP +\fBREL_OR\fR +.RS 4 +A boolean OR operation, the \(lqname\(rq and \(lqevr\(rq parts of the relation can be two sub\-dependencies\&. Packages can match any part of the dependency\&. +.RE +.PP +\fBREL_WITH\fR +.RS 4 +Like REL_AND, but packages mast match both dependencies simultaneously\&. See the section about boolean dependencies about more information\&. +.RE +.PP +\fBREL_NAMESPACE\fR +.RS 4 +A special namespace relation\&. See the section about namespace dependencies for more information\&. +.RE +.PP +\fBREL_ARCH\fR +.RS 4 +A architecture filter dependency\&. The \(lqname\(rq part of the relation is a sub\-dependency, the \(lqevr\(rq part is the Id of an architecture that the matching packages must have (note that this is an exact match ignoring architecture policies)\&. +.RE +.PP +\fBREL_FILECONFLICT\fR +.RS 4 +An internal file conflict dependency used to represent file conflicts\&. See the pool_add_fileconflicts_deps() function\&. +.RE +.PP +\fBREL_COND\fR +.RS 4 +A conditional dependency, the \(lqname\(rq sub\-dependency is only considered if the \(lqevr\(rq sub\-dependency is fulfilled\&. See the section about boolean dependencies about more information\&. +.RE +.PP +\fBREL_COMPAT\fR +.RS 4 +A compat dependency used in Haiku to represent version ranges\&. The \(lqname\(rq part is the actual version, the \(lqevr\(rq part is the backwards compatibility version\&. +.RE +.SS "Functions" +.sp +.if n \{\ +.RS 4 +.\} +.nf +\fBId pool_str2id(Pool *\fR\fIpool\fR\fB, const char *\fR\fIstr\fR\fB, int\fR \fIcreate\fR\fB)\fR; +.fi +.if n \{\ +.RE +.\} +.sp +Add a string to the pool of unified strings, returning the Id of the string\&. If \fIcreate\fR is zero, new strings will not be added to the pool, instead Id 0 is returned\&. +.sp +.if n \{\ +.RS 4 +.\} +.nf +\fBId pool_strn2id(Pool *\fR\fIpool\fR\fB, const char *\fR\fIstr\fR\fB, unsigned int\fR \fIlen\fR\fB, int\fR \fIcreate\fR\fB)\fR; +.fi +.if n \{\ +.RE +.\} +.sp +Same as pool_str2id, but only \fIlen\fR characters of the string are used\&. This can be used to add substrings to the pool\&. +.sp +.if n \{\ +.RS 4 +.\} +.nf +\fBId pool_rel2id(Pool *\fR\fIpool\fR\fB, Id\fR \fIname\fR\fB, Id\fR \fIevr\fR\fB, int\fR \fIflags\fR\fB, int\fR \fIcreate\fR\fB)\fR; +.fi +.if n \{\ +.RE +.\} +.sp +Create a relational dependency from to other dependencies, \fIname\fR and \fIevr\fR, and a \fIflag\fR\&. See the \fBREL_\fR constants for the supported flags\&. As with pool_str2id, \fIcreate\fR defines if new dependencies will get added or Id zero will be returned instead\&. +.sp +.if n \{\ +.RS 4 +.\} +.nf +\fBId pool_id2langid(Pool *\fR\fIpool\fR\fB, Id\fR \fIid\fR\fB, const char *\fR\fIlang\fR\fB, int\fR \fIcreate\fR\fB)\fR; +.fi +.if n \{\ +.RE +.\} +.sp +Attach a language suffix to a string Id\&. This function can be used to create language keyname Ids from keynames, it is functional equivalent to converting the \fIid\fR argument to a string, adding a \(lq:\(rq character and the \fIlang\fR argument to the string and then converting the result back into an Id\&. +.sp +.if n \{\ +.RS 4 +.\} +.nf +\fBconst char *pool_id2str(const Pool *\fR\fIpool\fR\fB, Id\fR \fIid\fR\fB)\fR; +.fi +.if n \{\ +.RE +.\} +.sp +Convert an Id back into a string\&. If the Id is a relational Id, the \(lqname\(rq part will be converted instead\&. +.sp +.if n \{\ +.RS 4 +.\} +.nf +\fBconst char *pool_id2rel(const Pool *\fR\fIpool\fR\fB, Id\fR \fIid\fR\fB)\fR; +.fi +.if n \{\ +.RE +.\} +.sp +Return the relation string of a relational Id\&. Returns an empty string if the passed Id is not a relation\&. +.sp +.if n \{\ +.RS 4 +.\} +.nf +\fBconst char *pool_id2evr(const Pool *\fR\fIpool\fR\fB, Id\fR \fIid\fR\fB)\fR; +.fi +.if n \{\ +.RE +.\} +.sp +Return the \(lqevr\(rq part of a relational Id as string\&. Returns an empty string if the passed Id is not a relation\&. +.sp +.if n \{\ +.RS 4 +.\} +.nf +\fBconst char *pool_dep2str(Pool *\fR\fIpool\fR\fB, Id\fR \fIid\fR\fB)\fR; +.fi +.if n \{\ +.RE +.\} +.sp +Convert an Id back into a string\&. If the passed Id belongs to a relation, a string representing the relation is returned\&. Note that in that case the string is allocated on the pool\(cqs temporary space\&. +.sp +.if n \{\ +.RS 4 +.\} +.nf +\fBvoid pool_freeidhashes(Pool *\fR\fIpool\fR\fB)\fR; +.fi +.if n \{\ +.RE +.\} +.sp +Free the hashes used to unify strings and relations\&. You can use this function to save memory if you know that you will no longer create new strings and relations\&. +.SH "SOLVABLE FUNCTIONS" +.sp +.if n \{\ +.RS 4 +.\} +.nf +\fBSolvable *pool_id2solvable(const Pool *\fR\fIpool\fR\fB, Id\fR \fIp\fR\fB)\fR; +.fi +.if n \{\ +.RE +.\} +.sp +Convert a solvable Id into a pointer to the solvable data\&. Note that the pointer may become invalid if new solvables are created or old solvables deleted, because the array storing all solvables may get reallocated\&. +.sp +.if n \{\ +.RS 4 +.\} +.nf +\fBconst char *pool_solvid2str(Pool *\fR\fIpool\fR\fB, Id\fR \fIp\fR\fB)\fR; +.fi +.if n \{\ +.RE +.\} +.sp +Return a string representing the solvable with the Id \fIp\fR\&. The string will be some canonical representation of the solvable, usually a combination of the name, the version, and the architecture\&. +.sp +.if n \{\ +.RS 4 +.\} +.nf +\fBconst char *pool_solvable2str(Pool *\fR\fIpool\fR\fB, Solvable *\fR\fIs\fR\fB)\fR; +.fi +.if n \{\ +.RE +.\} +.sp +Same as pool_solvid2str, but instead of the Id, a pointer to the solvable is passed\&. +.SH "DEPENDENCY MATCHING" +.SS "Constants" +.PP +\fBEVRCMP_COMPARE\fR +.RS 4 +Compare all parts of the version, treat missing parts as empty strings\&. +.RE +.PP +\fBEVRCMP_MATCH_RELEASE\fR +.RS 4 +A special mode for rpm version string matching\&. If a version misses a release part, it matches all releases\&. In that case the special values \(lq\-2\(rq and \(lq2\(rq are returned, depending on which of the two versions did not have a release part\&. +.RE +.PP +\fBEVRCMP_MATCH\fR +.RS 4 +A generic match, missing parts always match\&. +.RE +.PP +\fBEVRCMP_COMPARE_EVONLY\fR +.RS 4 +Only compare the epoch and the version parts, ignore the release part\&. +.RE +.SS "Functions" +.sp +.if n \{\ +.RS 4 +.\} +.nf +\fBint pool_evrcmp(const Pool *\fR\fIpool\fR\fB, Id\fR \fIevr1id\fR\fB, Id\fR \fIevr2id\fR\fB, int\fR \fImode\fR\fB)\fR; +.fi +.if n \{\ +.RE +.\} +.sp +Compare two version Ids, return \-1 if the first version is less then the second version, 0 if they are identical, and 1 if the first version is bigger than the second one\&. +.sp +.if n \{\ +.RS 4 +.\} +.nf +\fBint pool_evrcmp_str(const Pool *\fR\fIpool\fR\fB, const char *\fR\fIevr1\fR\fB, const char *\fR\fIevr2\fR\fB, int\fR \fImode\fR\fB)\fR; +.fi +.if n \{\ +.RE +.\} +.sp +Same as pool_evrcmp(), but uses strings instead of Ids\&. +.sp +.if n \{\ +.RS 4 +.\} +.nf +\fBint pool_evrmatch(const Pool *\fR\fIpool\fR\fB, Id\fR \fIevrid\fR\fB, const char *\fR\fIepoch\fR\fB, const char *\fR\fIversion\fR\fB, const char *\fR\fIrelease\fR\fB)\fR; +.fi +.if n \{\ +.RE +.\} +.sp +Match a version Id against an epoch, a version and a release string\&. Passing NULL means that the part should match everything\&. +.sp +.if n \{\ +.RS 4 +.\} +.nf +\fBint pool_match_dep(Pool *\fR\fIpool\fR\fB, Id\fR \fId1\fR\fB, Id\fR \fId2\fR\fB)\fR; +.fi +.if n \{\ +.RE +.\} +.sp +Returns \(lq1\(rq if the dependency \fId1\fR (the provider) is matched by the dependency \fId2\fR, otherwise \(lq0\(rq is returned\&. For two dependencies to match, both the \(lqname\(rq parts must match and the version range described by the \(lqevr\(rq parts must overlap\&. +.sp +.if n \{\ +.RS 4 +.\} +.nf +\fBint pool_match_nevr(Pool *\fR\fIpool\fR\fB, Solvable *\fR\fIs\fR\fB, Id\fR \fId\fR\fB)\fR; +.fi +.if n \{\ +.RE +.\} +.sp +Like pool_match_dep, but the provider is the "self\-provides" dependency of the Solvable \fIs\fR, i\&.e\&. the dependency \(lqs→name = s→evr\(rq\&. +.SH "WHATPROVIDES INDEX" +.sp +.if n \{\ +.RS 4 +.\} +.nf +\fBvoid pool_createwhatprovides(Pool *\fR\fIpool\fR\fB)\fR; +.fi +.if n \{\ +.RE +.\} +.sp +Create a index that maps dependency Ids to sets of packages that provide the dependency\&. +.sp +.if n \{\ +.RS 4 +.\} +.nf +\fBvoid pool_freewhatprovides(Pool *\fR\fIpool\fR\fB)\fR; +.fi +.if n \{\ +.RE +.\} +.sp +Free the whatprovides index to save memory\&. +.sp +.if n \{\ +.RS 4 +.\} +.nf +\fBId pool_whatprovides(Pool *\fR\fIpool\fR\fB, Id\fR \fId\fR\fB)\fR; +.fi +.if n \{\ +.RE +.\} +.sp +Return an offset into the Pool\(cqs whatprovidesdata array\&. The solvables with the Ids stored starting at that offset provide the dependency \fId\fR\&. The solvable list is zero terminated\&. +.sp +.if n \{\ +.RS 4 +.\} +.nf +\fBId *pool_whatprovides_ptr(Pool *\fR\fIpool\fR\fB, Id\fR \fId\fR\fB)\fR; +.fi +.if n \{\ +.RE +.\} +.sp +Instead of returning the offset, return the pointer to the Ids stored at that offset\&. Note that this pointer has a very limit validity time, as any call that adds new values to the whatprovidesdata area may reallocate the array\&. +.sp +.if n \{\ +.RS 4 +.\} +.nf +\fBId pool_queuetowhatprovides(Pool *\fR\fIpool\fR\fB, Queue *\fR\fIq\fR\fB)\fR; +.fi +.if n \{\ +.RE +.\} +.sp +Add the contents of the Queue \fIq\fR to the end of the whatprovidesdata array, returning the offset into the array\&. +.sp +.if n \{\ +.RS 4 +.\} +.nf +\fBvoid pool_addfileprovides(Pool *\fR\fIpool\fR\fB)\fR; +.fi +.if n \{\ +.RE +.\} +.sp +Some package managers like rpm allow dependencies on files contained in other packages\&. To allow libsolv to deal with those dependencies in an efficient way, you need to call the addfileprovides method after creating and reading all repositories\&. This method will scan all dependency for file names and than scan all packages for matching files\&. If a filename has been matched, it will be added to the provides list of the corresponding package\&. +.sp +.if n \{\ +.RS 4 +.\} +.nf +\fBvoid pool_addfileprovides_queue(Pool *\fR\fIpool\fR\fB, Queue *\fR\fIidq\fR\fB, Queue *\fR\fIidqinst\fR\fB)\fR; +.fi +.if n \{\ +.RE +.\} +.sp +Same as pool_addfileprovides, but the added Ids are returned in two Queues, \fIidq\fR for all repositories except the one containing the \(lqinstalled\(rq packages, \fIidqinst\fR for the latter one\&. This information can be stored in the meta section of the repositories to speed up the next time the repository is loaded and addfileprovides is called +.sp +.if n \{\ +.RS 4 +.\} +.nf +\fBvoid pool_flush_namespaceproviders(Pool *\fR\fIpool\fR\fB, Id\fR \fIns\fR\fB, Id\fR \fIevr\fR\fB)\fR; +.fi +.if n \{\ +.RE +.\} +.sp +Clear the cache of the providers for namespace dependencies matching namespace \fIns\fR\&. If the \fIevr\fR argument is non\-zero, the namespace dependency for exactly that dependency is cleared, otherwise all matching namespace dependencies are cleared\&. See the section about Namespace dependencies for further information\&. +.sp +.if n \{\ +.RS 4 +.\} +.nf +\fBvoid pool_add_fileconflicts_deps(Pool *\fR\fIpool\fR\fB, Queue *\fR\fIconflicts\fR\fB)\fR; +.fi +.if n \{\ +.RE +.\} +.sp +Some package managers like rpm report conflicts when a package installation overwrites a file of another installed package with different content\&. As file content information is not stored in the repository metadata, those conflicts can only be detected after the packages are downloaded\&. Libsolv provides a function to check for such conflicts, pool_findfileconflicts()\&. If conflicts are found, they can be added as special \fBREL_FILECONFLICT\fR provides dependencies, so that the solver will know about the conflict when it is re\-run\&. +.SH "UTILITY FUNCTIONS" +.sp +.if n \{\ +.RS 4 +.\} +.nf +\fBchar *pool_alloctmpspace(Pool *\fR\fIpool\fR\fB, int\fR \fIlen\fR\fB)\fR; +.fi +.if n \{\ +.RE +.\} +.sp +Allocate space on the pool\(cqs temporary space area\&. This space has a limited lifetime, it will be automatically freed after a fixed amount (currently 16) of other pool_alloctmpspace() calls are done\&. +.sp +.if n \{\ +.RS 4 +.\} +.nf +\fBvoid pool_freetmpspace(Pool *\fR\fIpool\fR\fB, const char *\fR\fIspace\fR\fB)\fR; +.fi +.if n \{\ +.RE +.\} +.sp +Give the space allocated with pool_alloctmpspace back to the system\&. You do not have to use this function, as the space is automatically reclaimed, but it can be useful to extend the lifetime of other pointers to the pool\(cqs temporary space area\&. +.sp +.if n \{\ +.RS 4 +.\} +.nf +\fBconst char *pool_bin2hex(Pool *\fR\fIpool\fR\fB, const unsigned char *\fR\fIbuf\fR\fB, int\fR \fIlen\fR\fB)\fR; +.fi +.if n \{\ +.RE +.\} +.sp +Convert some binary data to hexadecimal, returning a string allocated in the pool\(cqs temporary space area\&. +.sp +.if n \{\ +.RS 4 +.\} +.nf +\fBchar *pool_tmpjoin(Pool *\fR\fIpool\fR\fB, const char *\fR\fIstr1\fR\fB, const char *\fR\fIstr2\fR\fB, const char *\fR\fIstr3\fR\fB)\fR; +.fi +.if n \{\ +.RE +.\} +.sp +Join three strings and return the result in the pool\(cqs temporary space area\&. You can use NULL arguments if you just want to join less strings\&. +.sp +.if n \{\ +.RS 4 +.\} +.nf +\fBchar *pool_tmpappend(Pool *\fR\fIpool\fR\fB, const char *\fR\fIstr1\fR\fB, const char *\fR\fIstr2\fR\fB, const char *\fR\fIstr3\fR\fB)\fR; +.fi +.if n \{\ +.RE +.\} +.sp +Like pool_tmpjoin(), but if the first argument is the last allocated space in the pool\(cqs temporary space area, it will be replaced with the result of the join and no new temporary space slot will be used\&. Thus you can join more then three strings by a combination of one pool_tmpjoin() and multiple pool_tmpappend() calls\&. Note that the \fIstr1\fR pointer is no longer usable after the call\&. +.SH "DATA LOOKUP" +.SS "Constants" +.PP +\fBSOLVID_POS\fR +.RS 4 +Use the data position stored in the pool for the lookup instead of looking up the data of a solvable\&. +.RE +.PP +\fBSOLVID_META\fR +.RS 4 +Use the data stored in the meta section of a repository (or repodata area) instead of looking up the data of a solvable\&. This constant does not work for the pool\(cqs lookup functions, use it for the repo\(cqs or repodata\(cqs lookup functions instead\&. It\(cqs just listed for completeness\&. +.RE +.SS "Functions" +.sp +.if n \{\ +.RS 4 +.\} +.nf +\fBconst char *pool_lookup_str(Pool *\fR\fIpool\fR\fB, Id\fR \fIsolvid\fR\fB, Id\fR \fIkeyname\fR\fB)\fR; +.fi +.if n \{\ +.RE +.\} +.sp +Return the string value stored under the attribute \fIkeyname\fR in solvable \fIsolvid\fR\&. +.sp +.if n \{\ +.RS 4 +.\} +.nf +\fBunsigned long long pool_lookup_num(Pool *\fR\fIpool\fR\fB, Id\fR \fIsolvid\fR\fB, Id\fR \fIkeyname\fR\fB, unsigned long long\fR \fInotfound\fR\fB)\fR; +.fi +.if n \{\ +.RE +.\} +.sp +Return the 64bit unsigned number stored under the attribute \fIkeyname\fR in solvable \fIsolvid\fR\&. If no such number is found, the value of the \fInotfound\fR argument is returned instead\&. +.sp +.if n \{\ +.RS 4 +.\} +.nf +\fBId pool_lookup_id(Pool *\fR\fIpool\fR\fB, Id\fR \fIsolvid\fR\fB, Id\fR \fIkeyname\fR\fB)\fR; +.fi +.if n \{\ +.RE +.\} +.sp +Return the Id stored under the attribute \fIkeyname\fR in solvable \fIsolvid\fR\&. +.sp +.if n \{\ +.RS 4 +.\} +.nf +\fBint pool_lookup_idarray(Pool *\fR\fIpool\fR\fB, Id\fR \fIsolvid\fR\fB, Id\fR \fIkeyname\fR\fB, Queue *\fR\fIq\fR\fB)\fR; +.fi +.if n \{\ +.RE +.\} +.sp +Fill the queue \fIq\fR with the content of the Id array stored under the attribute \fIkeyname\fR in solvable \fIsolvid\fR\&. Returns \(lq1\(rq if an array was found, otherwise the queue will be empty and \(lq0\(rq will be returned\&. +.sp +.if n \{\ +.RS 4 +.\} +.nf +\fBint pool_lookup_void(Pool *\fR\fIpool\fR\fB, Id\fR \fIsolvid\fR\fB, Id\fR \fIkeyname\fR\fB)\fR; +.fi +.if n \{\ +.RE +.\} +.sp +Returns \(lq1\(rq if a void value is stored under the attribute \fIkeyname\fR in solvable \fIsolvid\fR, otherwise \(lq0\(rq\&. +.sp +.if n \{\ +.RS 4 +.\} +.nf +\fBconst char *pool_lookup_checksum(Pool *\fR\fIpool\fR\fB, Id\fR \fIsolvid\fR\fB, Id\fR \fIkeyname\fR\fB, Id *\fR\fItypep\fR\fB)\fR; +.fi +.if n \{\ +.RE +.\} +.sp +Return the checksum that is stored under the attribute \fIkeyname\fR in solvable \fIsolvid\fR\&. The type of the checksum will be returned over the \fItypep\fR pointer\&. If no such checksum is found, NULL will be returned and the type will be set to zero\&. Note that the result is stored in the Pool\(cqs temporary space area\&. +.sp +.if n \{\ +.RS 4 +.\} +.nf +\fBconst unsigned char *pool_lookup_bin_checksum(Pool *\fR\fIpool\fR\fB, Id\fR \fIsolvid\fR\fB, Id\fR \fIkeyname\fR\fB, Id *\fR\fItypep\fR\fB)\fR; +.fi +.if n \{\ +.RE +.\} +.sp +Return the checksum that is stored under the attribute \fIkeyname\fR in solvable \fIsolvid\fR\&. Returns the checksum as binary data, you can use the returned type to calculate the length of the checksum\&. No temporary space area is needed\&. +.sp +.if n \{\ +.RS 4 +.\} +.nf +\fBconst char *pool_lookup_deltalocation(Pool *\fR\fIpool\fR\fB, Id\fR \fIsolvid\fR\fB, unsigned int *\fR\fImedianrp\fR\fB)\fR; +.fi +.if n \{\ +.RE +.\} +.sp +This is a utility lookup function to return the delta location for a delta rpm\&. As solvables cannot store deltas, you have to use SOLVID_POS as argument and set the Pool\(cqs datapos pointer to point to valid delta rpm data\&. +.sp +.if n \{\ +.RS 4 +.\} +.nf +\fBvoid pool_search(Pool *\fR\fIpool\fR\fB, Id\fR \fIsolvid\fR\fB, Id\fR \fIkeyname\fR\fB, const char *\fR\fImatch\fR\fB, int\fR \fIflags\fR\fB, int (*\fR\fIcallback\fR\fB)(void *\fR\fIcbdata\fR\fB, Solvable *\fR\fIs\fR\fB, Repodata *\fR\fIdata\fR\fB, Repokey *\fR\fIkey\fR\fB, KeyValue *\fR\fIkv\fR\fB), void *\fR\fIcbdata\fR\fB)\fR; +.fi +.if n \{\ +.RE +.\} +.sp +Perform a search on all data stored in the pool\&. You can limit the search area by using the \fIsolvid\fR and \fIkeyname\fR arguments\&. The values can be optionally matched against the \fImatch\fR argument, use NULL if you do not want this matching\&. See the Dataiterator manpage about the possible matches modes and the \fIflags\fR argument\&. For all (matching) values, the callback function is called with the \fIcbdata\fR callback argument and the data describing the value\&. +.SH "JOB AND SELECTION FUNCTIONS" +.sp +A Job consists of two Ids, \fIhow\fR and \fIwhat\fR\&. The \fIhow\fR part describes the action, the job flags, and the selection method while the \fIwhat\fR part is in input for the selection\&. A Selection is a queue consisting of multiple jobs (thus the number of elements in the queue must be a multiple of two)\&. See the Solver manpage for more information about jobs\&. +.sp +.if n \{\ +.RS 4 +.\} +.nf +\fBconst char *pool_job2str(Pool *\fR\fIpool\fR\fB, Id\fR \fIhow\fR\fB, Id\fR \fIwhat\fR\fB, Id\fR \fIflagmask\fR\fB)\fR; +.fi +.if n \{\ +.RE +.\} +.sp +Convert a job into a string\&. Useful for debugging purposes\&. The \fIflagmask\fR can be used to mask the flags of the job, use \(lq0\(rq if you do not want to see such flags, \(lq\-1\(rq to see all flags, or a combination of the flags you want to see\&. +.sp +.if n \{\ +.RS 4 +.\} +.nf +\fBvoid pool_job2solvables(Pool *\fR\fIpool\fR\fB, Queue *\fR\fIpkgs\fR\fB, Id\fR \fIhow\fR\fB, Id\fR \fIwhat\fR\fB)\fR; +.fi +.if n \{\ +.RE +.\} +.sp +Return a list of solvables that the specified job selects\&. +.sp +.if n \{\ +.RS 4 +.\} +.nf +\fBint pool_isemptyupdatejob(Pool *\fR\fIpool\fR\fB, Id\fR \fIhow\fR\fB, Id\fR \fIwhat\fR\fB)\fR; +.fi +.if n \{\ +.RE +.\} +.sp +Return \(lq1\(rq if the job is an update job that does not work with any installed package, i\&.e\&. the job is basically a no\-op\&. You can use this to turn no\-op update jobs into install jobs (as done by package managers like \(lqzypper\(rq)\&. +.sp +.if n \{\ +.RS 4 +.\} +.nf +\fBconst char *pool_selection2str(Pool *\fR\fIpool\fR\fB, Queue *\fR\fIselection\fR\fB, Id\fR \fIflagmask\fR\fB)\fR; +.fi +.if n \{\ +.RE +.\} +.sp +Convert a selection into a string\&. Useful for debugging purposes\&. See the pool_job2str() function for the \fIflagmask\fR argument\&. +.SH "ODDS AND ENDS" +.sp +.if n \{\ +.RS 4 +.\} +.nf +\fBvoid pool_freeallrepos(Pool *\fR\fIpool\fR\fB, int\fR \fIreuseids\fR\fB)\fR; +.fi +.if n \{\ +.RE +.\} +.sp +Free all repos from the pool (including all solvables)\&. If \fIreuseids\fR is true, all Ids of the solvables are free to be reused the next time solvables are created\&. +.sp +.if n \{\ +.RS 4 +.\} +.nf +\fBvoid pool_clear_pos(Pool *\fR\fIpool\fR\fB)\fR; +.fi +.if n \{\ +.RE +.\} +.sp +Clear the data position stored in the pool\&. +.SH "ARCHITECTURE POLICIES" +.sp +An architecture policy defines a list of architectures that can be installed on the system, and also the relationship between them (i\&.e\&. the ordering)\&. Architectures can be delimited with three different characters: +.PP +\fB\*(Aq:\*(Aq\fR +.RS 4 +No relationship between the architectures\&. A package of one architecture can not be replaced with one of the other architecture\&. +.RE +.PP +\fB\*(Aq>\*(Aq\fR +.RS 4 +The first architecture is better than the second one\&. An installed package of the second architecture may be replaced with one from the first architecture and vice versa\&. The solver will select the better architecture if the versions are the same\&. +.RE +.PP +\fB\*(Aq=\*(Aq\fR +.RS 4 +The two architectures are freely exchangeable\&. Used to define aliases for architectures\&. +.RE +.sp +An example would be \*(Aqx86_64:i686=athlon>i586\*(Aq\&. This means that x86_64 packages can only be replaced by other x86_64 packages, i686 packages can be replaced by i686 and i586 packages (but i686 packages will be preferred) and athlon is another name for the i686 architecture\&. +.SH "VENDOR POLICIES" +.sp +bla bla +.SH "BOOLEAN DEPENDENCIES" +.sp +bla bla +.SH "NAMESPACE DEPENDENCIES" +.sp +bla bla +.SH "AUTHOR" +.sp +Michael Schroeder diff --git a/doc/libsolv-pool.txt b/doc/libsolv-pool.txt new file mode 100644 index 0000000..018d87b --- /dev/null +++ b/doc/libsolv-pool.txt @@ -0,0 +1,800 @@ +Libsolv-Pool(3) +=============== +:man manual: LIBSOLV +:man source: libsolv + + +Name +---- +libsolv-pool - Libsolv's pool object + + +Public Attributes +----------------- + +*void *appdata*:: +A no-purpose pointer free to use for the library user. Freeing +the pool simply discards the pointer. + +*Stringpool ss*:: +The pool of unified strings. + +*Reldep *rels*:: +The pool of unified relation dependencies. + +*int nrels*:: +Number of allocated relation dependencies. + +*Repo **repos*:: +The array of repository pointers, indexed by repository Id. + +*int nrepos*:: +Number of allocated repository array elements, i.e. the size +of the repos array. + +*int urepos*:: +Number of used (i.e. non-zero) repository array elements. + +*Repo *installed*:: +Pointer to the repo holding the installed packages. You are free +to read this attribute, but you should use pool_set_installed() +if you want to change it. + +*Solvable *solvables*:: +The array of Solvable objects. + +*int nsolvables*:: +Number of Solvable objects, i.e. the size of the solvables array. +Note that the array may contain freed solvables, in that case +the repo pointer of the solvable will be zero. + +*int disttype*:: +The distribution type of your system, e.g. DISTTYPE_DEB. You are +free to read this attribute, but you should use pool_setdisttype() +if you want to change it. + +*Id *whatprovidesdata*:: +Multi-purpose Id storage holding zero terminated arrays of Ids. +pool_whatprovides() returns an offset into this data. + +*Map *considered*:: +Optional bitmap that can make the library ignore solvables. If a +bitmap is set, only solvables that have a set bit in the bitmap +at their Id are considered usable. + +*int debugmask*:: +A mask that defines which debug events should be reported. +pool_setdebuglevel() sets this mask. + +*Datapos pos*:: +An object storing some position in the repository data. Functions +like dataiterator_set_pos() set this object, accessing data with +a pseudo solvable Id of SOLVID_POS uses it. + +*Queue pooljobs*:: +A queue where fixed solver jobs can be stored. This jobs are +automatically added when solver_solve() is called, they are useful +to store configuration data like which packages should be multiversion +installed. + +Creation and Destruction +------------------------ + + Pool *pool_create(); + +Create a new instance of a pool. + + void pool_free(Pool *pool); + +Free a pool and all of the data it contains, e.g. the solvables, +repositories, strings. + + +Debugging and error reporting +----------------------------- + +=== Constants === + +*SOLV_FATAL*:: +Report the error and call ``exit(1)'' afterwards. You cannot mask +this level. Reports to stderr instead of stdout. + +*SOLV_ERROR*:: +Used to report errors. Reports to stderr instead of stdout. + +*SOLV_WARN*:: +Used to report warnings. + +*SOLV_DEBUG_STATS*:: +Used to report statistical data. + +*SOLV_DEBUG_RULE_CREATION*:: +Used to report information about the solver's creation of rules. + +*SOLV_DEBUG_PROPAGATE*:: +Used to report information about the solver's unit rule propagation +process. + +*SOLV_DEBUG_ANALYZE*:: +Used to report information about the solver's learnt rule generation +mechanism. + +*SOLV_DEBUG_UNSOLVABLE*:: +Used to report information about the solver dealing with conflicting +rules. + +*SOLV_DEBUG_SOLUTIONS*:: +Used to report information about the solver creating solutions to +solve problems. + +*SOLV_DEBUG_POLICY*:: +Used to report information about the solver searching for an +optimal solution. + +*SOLV_DEBUG_RESULT*:: +Used by the debug functions to output results. + +*SOLV_DEBUG_JOB*:: +Used to report information about the job rule generation process. + +*SOLV_DEBUG_SOLVER*:: +Used to report information about what the solver is currently +doing. + +*SOLV_DEBUG_TRANSACTION*:: +Used to report information about the transaction generation and +ordering process. + +*SOLV_DEBUG_TO_STDERR*:: +Write debug messages to stderr instead of stdout. + +=== Functions === + + void pool_debug(Pool *pool, int type, const char *format, ...); + +Report a message of the type _type_. You can filter debug messages by +setting a debug mask. + + void pool_setdebuglevel(Pool *pool, int level); + +Set a predefined debug mask. A higher level generally means more +bits in the mask are set, thus more messages are printed. + + void pool_setdebugmask(Pool *pool, int mask); + +Set the debug mask to filter debug messages. + + int pool_error(Pool *pool, int ret, const char *format, ...); + +Set the pool's error string. The _ret_ value is simply used as a +return value of the function so that you can write code like ++return pool_error(...);+. If the debug mask contains the *SOLV_ERROR* +bit, pool_debug() is also called with the message and type *SOLV_ERROR*. + + extern char *pool_errstr(Pool *pool); + +Return the current error string stored in the pool. Like with +the libc's errno value, the string is only meaningful after a +function returned an error. + + void pool_setdebugcallback(Pool *pool, void (*debugcallback)(Pool *, void *data, int type, const char *str), void *debugcallbackdata); + +Set a custom debug callback function. Instead of writing to stdout +or stderr, the callback function will be called. + + +Pool configuration +------------------ + +=== Constants === + +*DISTTYPE_RPM*:: + Used for systems with use rpm as low level package manager. + +*DISTTYPE_DEB*:: + Used for systems with use dpkg as low level package manager. + +*DISTTYPE_ARCH*:: + Used for systems with use the arch linux package manager. + +*DISTTYPE_HAIKU*:: + Used for systems with use haiku packages. + +*POOL_FLAG_PROMOTEEPOCH*:: + Promote the epoch of the providing dependency to the requesting + dependency if it does not contain an epoch. Used at some time + in old rpm versions, modern systems should never need this. + +*POOL_FLAG_FORBIDSELFCONFLICTS*:: + Disallow the installation of packages that conflict with themselves. + Debian always allows self-conflicting packages, rpm used to forbid + them but switched to also allowing them recently. + +*POOL_FLAG_OBSOLETEUSESPROVIDES*:: + Make obsolete type dependency match against provides instead of + just the name and version of packages. Very old versions of rpm + used the name/version, then it got switched to provides and later + switched back again to just name/version. + +*POOL_FLAG_IMPLICITOBSOLETEUSESPROVIDES*:: + An implicit obsoletes is the internal mechanism to remove the + old package on an update. The default is to remove all packages + with the same name, rpm-5 switched to also removing packages + providing the same name. + +*POOL_FLAG_OBSOLETEUSESCOLORS*:: + Rpm's multilib implementation (used in RedHat and Fedora) + distinguishes between 32bit and 64bit packages (the terminology + is that they have a different color). If obsoleteusescolors is + set, packages with different colors will not obsolete each other. + +*POOL_FLAG_IMPLICITOBSOLETEUSESCOLORS*:: + Same as POOL_FLAG_OBSOLETEUSESCOLORS, but used to find out if + packages of the same name can be installed in parallel. For + current Fedora systems, POOL_FLAG_OBSOLETEUSESCOLORS should be + false and POOL_FLAG_IMPLICITOBSOLETEUSESCOLORS should be true + (this is the default if FEDORA is defined when libsolv is + compiled). + +*POOL_FLAG_NOINSTALLEDOBSOLETES*:: + New versions of rpm consider the obsoletes of installed packages + when checking for dependency, thus you may not install a package + that is obsoleted by some other installed package, unless you + also erase the other package. + +*POOL_FLAG_HAVEDISTEPOCH*:: + Mandriva added a new field called distepoch that gets checked in + version comparison if the epoch/version/release of two packages + are the same. + +*POOL_FLAG_NOOBSOLETESMULTIVERSION*:: + If a package is installed in multiversionmode, rpm used to ignore + both the implicit obsoletes and the obsolete dependency of a + package. This was changed to ignoring just the implicit obsoletes, + thus you may install multiple versions of the same name, but + obsoleted packages still get removed. + +*POOL_FLAG_ADDFILEPROVIDESFILTERED*:: + Make the addfileprovides method only add files from the standard + locations (i.e. the ``bin'' and ``etc'' directories). This is + useful if you have only few packages that use non-standard file + dependencies, but you still wand the fast speed that addfileprovides() + generates. + + +=== Functions === + void pool_setdisttype(Pool *pool, int disttype); + +Set the package type of your system. The disttype is used for example +to define package comparison semantics. Libsolv's default disttype +should match the package manager of your system, so you only need to +use this function if you want to use the library to solve packaging +problems for different systems. + + int pool_set_flag(Pool *pool, int flag, int value); + +Set a flag to a new value. Returns the old value of the flag. + + int pool_get_flag(Pool *pool, int flag); + +Get the value of a pool flag. See the constants section about the +meaning of the flags. + + void pool_set_rootdir(Pool *pool, const char *rootdir); + +Set a specific root directory. Some library functions support a +flag that tells the function to prepend the rootdir to file +and directory names. + + const char *pool_get_rootdir(Pool *pool); + +Return the current value of the root directory. + + char *pool_prepend_rootdir(Pool *pool, const char *dir); + +Prepend the root directory to the _dir_ argument string. The +returned string has been newly allocated and needs to be +freed after use. + + char *pool_prepend_rootdir_tmp(Pool *pool, const char *dir); + +Same as pool_prepend_rootdir, but uses the pool's temporary space +for allocation. + + void pool_set_installed(Pool *pool, Repo *repo); + +Set which repository should be treated as the ``installed'' repository, +i.e. the one that holds information about the installed packages. + + void pool_set_languages(Pool *pool, const char **languages, int nlanguages); + +Set the language of your system. The library provides lookup functions +that return localized strings, for example for package descriptions. +You can set an array of languages to provide a fallback mechanism if +one language is not available. + + void pool_setarch(Pool *pool, const char *arch); + +Set the architecture of your system. The architecture is used to determine +which packages are installable and which packages cannot be installed. +The _arch_ argument is normally the ``machine'' value of the ``uname'' +system call. + + void pool_setarchpolicy(Pool *, const char *); + +Set the architecture policy for your system. This is the general version +of pool_setarch (in fact pool_setarch calls pool_setarchpolicy internally). +See the section about architecture policies for more information. + + void pool_addvendorclass(Pool *pool, const char **vendorclass); + +Add a new vendor equivalence class to the system. A vendor equivalence class +defines if an installed package of one vendor can be replaced by a package +coming from a different vendor. The _vendorclass_ argument must be a +NULL terminated array of strings. See the section about vendor policies for +more information. + + void pool_setvendorclasses(Pool *pool, const char **vendorclasses); + +Set all allowed vendor equivalences. The vendorclasses argument must be an +NULL terminated array consisting of all allowed classes concatenated. +Each class itself must be NULL terminated, thus the last class ends with +two NULL elements, one to finish the class and one to finish the list +of classes. + + void pool_set_custom_vendorcheck(Pool *pool, int (*vendorcheck)(Pool *, Solvable *, Solvable *)); + +Define a custom vendor check mechanism. You can use this if libsolv's +internal vendor equivalence class mechanism does not match your needs. + + void pool_setloadcallback(Pool *pool, int (*cb)(Pool *, Repodata *, void *), void *loadcbdata); + +Define a callback function that gets called when repository metadata needs to +be loaded on demand. See the section about on demand loading in the libsolv-repodata +manual. + + void pool_setnamespacecallback(Pool *pool, Id (*cb)(Pool *, void *, Id, Id), void *nscbdata); + +Define a callback function to implement custom namespace support. See +the section about namespace dependencies. + +Id pool management +------------------ +=== Constants === + +*ID_EMPTY*:: +The Id of the empty string, it is always Id 1. + +*REL_LT*:: +Represents a ``<'' relation. + +*REL_EQ*:: +Represents a ``='' relation. + +*REL_GT*:: +Represents a ``>'' relation. You can use combinations of REL_GT, +REL_EQ and REL_LT or-ed together to create any relation you +like. + +*REL_AND*:: +A boolean AND operation, the ``name'' and ``evr'' parts of the +relation can be two sub-dependencies. Packages must match both +parts of the dependency. + +*REL_OR*:: +A boolean OR operation, the ``name'' and ``evr'' parts of the +relation can be two sub-dependencies. Packages can match any +part of the dependency. + +*REL_WITH*:: +Like REL_AND, but packages mast match both dependencies +simultaneously. See the section about boolean dependencies +about more information. + +*REL_NAMESPACE*:: +A special namespace relation. See the section about namespace +dependencies for more information. + +*REL_ARCH*:: +A architecture filter dependency. The ``name'' part of the +relation is a sub-dependency, the ``evr'' part is the Id +of an architecture that the matching packages must have (note +that this is an exact match ignoring architecture policies). + +*REL_FILECONFLICT*:: +An internal file conflict dependency used to represent file +conflicts. See the pool_add_fileconflicts_deps() function. + +*REL_COND*:: +A conditional dependency, the ``name'' sub-dependency is only +considered if the ``evr'' sub-dependency is fulfilled. See the +section about boolean dependencies about more information. + +*REL_COMPAT*:: +A compat dependency used in Haiku to represent version ranges. +The ``name'' part is the actual version, the ``evr'' part is the +backwards compatibility version. + +=== Functions === + Id pool_str2id(Pool *pool, const char *str, int create); + +Add a string to the pool of unified strings, returning the Id of the string. +If _create_ is zero, new strings will not be added to the pool, instead +Id 0 is returned. + + Id pool_strn2id(Pool *pool, const char *str, unsigned int len, int create); + +Same as pool_str2id, but only _len_ characters of the string are used. This +can be used to add substrings to the pool. + + Id pool_rel2id(Pool *pool, Id name, Id evr, int flags, int create); + +Create a relational dependency from to other dependencies, _name_ and _evr_, +and a _flag_. See the *REL_* constants for the supported flags. As with +pool_str2id, _create_ defines if new dependencies will get added or Id zero +will be returned instead. + + Id pool_id2langid(Pool *pool, Id id, const char *lang, int create); + +Attach a language suffix to a string Id. This function can be used to +create language keyname Ids from keynames, it is functional equivalent +to converting the _id_ argument to a string, adding a ``:'' character +and the _lang_ argument to the string and then converting the result back +into an Id. + + const char *pool_id2str(const Pool *pool, Id id); + +Convert an Id back into a string. If the Id is a relational Id, the +``name'' part will be converted instead. + + const char *pool_id2rel(const Pool *pool, Id id); + +Return the relation string of a relational Id. Returns an empty string +if the passed Id is not a relation. + + const char *pool_id2evr(const Pool *pool, Id id); + +Return the ``evr'' part of a relational Id as string. Returns an empty string +if the passed Id is not a relation. + + const char *pool_dep2str(Pool *pool, Id id); + +Convert an Id back into a string. If the passed Id belongs to a relation, +a string representing the relation is returned. Note that in that case +the string is allocated on the pool's temporary space. + + void pool_freeidhashes(Pool *pool); + +Free the hashes used to unify strings and relations. You can use this function +to save memory if you know that you will no longer create new strings and +relations. + + +Solvable functions +------------------ + + Solvable *pool_id2solvable(const Pool *pool, Id p); + +Convert a solvable Id into a pointer to the solvable data. Note that the +pointer may become invalid if new solvables are created or old solvables +deleted, because the array storing all solvables may get reallocated. + + const char *pool_solvid2str(Pool *pool, Id p); + +Return a string representing the solvable with the Id _p_. The string will +be some canonical representation of the solvable, usually a combination of +the name, the version, and the architecture. + + const char *pool_solvable2str(Pool *pool, Solvable *s); + +Same as pool_solvid2str, but instead of the Id, a pointer to the solvable +is passed. + + +Dependency matching +------------------- + +=== Constants === +*EVRCMP_COMPARE*:: +Compare all parts of the version, treat missing parts as empty strings. + +*EVRCMP_MATCH_RELEASE*:: +A special mode for rpm version string matching. If a version misses a +release part, it matches all releases. In that case the special values +``-2'' and ``2'' are returned, depending on which of the two versions +did not have a release part. + +*EVRCMP_MATCH*:: +A generic match, missing parts always match. + +*EVRCMP_COMPARE_EVONLY*:: +Only compare the epoch and the version parts, ignore the release part. + +=== Functions === + int pool_evrcmp(const Pool *pool, Id evr1id, Id evr2id, int mode); + +Compare two version Ids, return -1 if the first version is less then the +second version, 0 if they are identical, and 1 if the first version is +bigger than the second one. + + int pool_evrcmp_str(const Pool *pool, const char *evr1, const char *evr2, int mode); + +Same as pool_evrcmp(), but uses strings instead of Ids. + + int pool_evrmatch(const Pool *pool, Id evrid, const char *epoch, const char *version, const char *release); + +Match a version Id against an epoch, a version and a release string. Passing +NULL means that the part should match everything. + + int pool_match_dep(Pool *pool, Id d1, Id d2); + +Returns ``1'' if the dependency _d1_ (the provider) is matched by the dependency +_d2_, otherwise ``0'' is returned. For two dependencies to match, both the +``name'' parts must match and the version range described by the ``evr'' parts +must overlap. + + int pool_match_nevr(Pool *pool, Solvable *s, Id d); + +Like pool_match_dep, but the provider is the "self-provides" dependency +of the Solvable _s_, i.e. the dependency ``s->name = s->evr''. + + +Whatprovides Index +------------------ + void pool_createwhatprovides(Pool *pool); + +Create a index that maps dependency Ids to sets of packages that provide the +dependency. + + void pool_freewhatprovides(Pool *pool); + +Free the whatprovides index to save memory. + + Id pool_whatprovides(Pool *pool, Id d); + +Return an offset into the Pool's whatprovidesdata array. The solvables with +the Ids stored starting at that offset provide the dependency _d_. The +solvable list is zero terminated. + + Id *pool_whatprovides_ptr(Pool *pool, Id d); + +Instead of returning the offset, return the pointer to the Ids stored at +that offset. Note that this pointer has a very limit validity time, as any +call that adds new values to the whatprovidesdata area may reallocate the +array. + + Id pool_queuetowhatprovides(Pool *pool, Queue *q); + +Add the contents of the Queue _q_ to the end of the whatprovidesdata array, +returning the offset into the array. + + void pool_addfileprovides(Pool *pool); + +Some package managers like rpm allow dependencies on files contained in other +packages. To allow libsolv to deal with those dependencies in an efficient way, +you need to call the addfileprovides method after creating and reading all +repositories. This method will scan all dependency for file names and than scan +all packages for matching files. If a filename has been matched, it will be +added to the provides list of the corresponding package. + + void pool_addfileprovides_queue(Pool *pool, Queue *idq, Queue *idqinst); + +Same as pool_addfileprovides, but the added Ids are returned in two Queues, +_idq_ for all repositories except the one containing the ``installed'' packages, +_idqinst_ for the latter one. This information can be stored in the meta section +of the repositories to speed up the next time the repository is loaded and +addfileprovides is called + + void pool_flush_namespaceproviders(Pool *pool, Id ns, Id evr); + +Clear the cache of the providers for namespace dependencies matching +namespace _ns_. If the _evr_ argument is non-zero, the namespace dependency +for exactly that dependency is cleared, otherwise all matching namespace +dependencies are cleared. See the section about Namespace dependencies +for further information. + + void pool_add_fileconflicts_deps(Pool *pool, Queue *conflicts); + +Some package managers like rpm report conflicts when a package installation +overwrites a file of another installed package with different content. As +file content information is not stored in the repository metadata, those +conflicts can only be detected after the packages are downloaded. Libsolv +provides a function to check for such conflicts, pool_findfileconflicts(). +If conflicts are found, they can be added as special *REL_FILECONFLICT* +provides dependencies, so that the solver will know about the conflict when +it is re-run. + + +Utility functions +----------------- + char *pool_alloctmpspace(Pool *pool, int len); + +Allocate space on the pool's temporary space area. This space has a +limited lifetime, it will be automatically freed after a fixed amount +(currently 16) of other pool_alloctmpspace() calls are done. + + void pool_freetmpspace(Pool *pool, const char *space); + +Give the space allocated with pool_alloctmpspace back to the system. +You do not have to use this function, as the space is automatically +reclaimed, but it can be useful to extend the lifetime of other +pointers to the pool's temporary space area. + + const char *pool_bin2hex(Pool *pool, const unsigned char *buf, int len); + +Convert some binary data to hexadecimal, returning a string allocated +in the pool's temporary space area. + + char *pool_tmpjoin(Pool *pool, const char *str1, const char *str2, const char *str3); + +Join three strings and return the result in the pool's temporary space +area. You can use NULL arguments if you just want to join less strings. + + char *pool_tmpappend(Pool *pool, const char *str1, const char *str2, const char *str3); + +Like pool_tmpjoin(), but if the first argument is the last allocated +space in the pool's temporary space area, it will be replaced with the +result of the join and no new temporary space slot will be used. +Thus you can join more then three strings by a combination of one +pool_tmpjoin() and multiple pool_tmpappend() calls. Note that the _str1_ +pointer is no longer usable after the call. + + +Data lookup +----------- +=== Constants === + +*SOLVID_POS*:: +Use the data position stored in the pool for the lookup instead of +looking up the data of a solvable. + +*SOLVID_META*:: +Use the data stored in the meta section of a repository (or repodata +area) instead of looking up the data of a solvable. This constant does +not work for the pool's lookup functions, use it for the repo's or +repodata's lookup functions instead. It's just listed for completeness. + +=== Functions === + const char *pool_lookup_str(Pool *pool, Id solvid, Id keyname); + +Return the string value stored under the attribute _keyname_ +in solvable _solvid_. + + unsigned long long pool_lookup_num(Pool *pool, Id solvid, Id keyname, unsigned long long notfound); + +Return the 64bit unsigned number stored under the attribute _keyname_ +in solvable _solvid_. If no such number is found, the value of the +_notfound_ argument is returned instead. + + Id pool_lookup_id(Pool *pool, Id solvid, Id keyname); + +Return the Id stored under the attribute _keyname_ in solvable _solvid_. + + int pool_lookup_idarray(Pool *pool, Id solvid, Id keyname, Queue *q); + +Fill the queue _q_ with the content of the Id array stored under the attribute +_keyname_ in solvable _solvid_. Returns ``1'' if an array was found, otherwise +the queue will be empty and ``0'' will be returned. + + int pool_lookup_void(Pool *pool, Id solvid, Id keyname); + +Returns ``1'' if a void value is stored under the attribute _keyname_ in solvable +_solvid_, otherwise ``0''. + + const char *pool_lookup_checksum(Pool *pool, Id solvid, Id keyname, Id *typep); + +Return the checksum that is stored under the attribute _keyname_ in solvable _solvid_. +The type of the checksum will be returned over the _typep_ pointer. If no such +checksum is found, NULL will be returned and the type will be set to zero. Note that +the result is stored in the Pool's temporary space area. + + const unsigned char *pool_lookup_bin_checksum(Pool *pool, Id solvid, Id keyname, Id *typep); + +Return the checksum that is stored under the attribute _keyname_ in solvable _solvid_. +Returns the checksum as binary data, you can use the returned type to calculate +the length of the checksum. No temporary space area is needed. + + const char *pool_lookup_deltalocation(Pool *pool, Id solvid, unsigned int *medianrp); + +This is a utility lookup function to return the delta location for a delta rpm. +As solvables cannot store deltas, you have to use SOLVID_POS as argument and +set the Pool's datapos pointer to point to valid delta rpm data. + + void pool_search(Pool *pool, Id solvid, Id keyname, const char *match, int flags, int (*callback)(void *cbdata, Solvable *s, Repodata *data, Repokey *key, KeyValue *kv), void *cbdata); + +Perform a search on all data stored in the pool. You can limit the search +area by using the _solvid_ and _keyname_ arguments. The values can be +optionally matched against the _match_ argument, use NULL if you do not +want this matching. See the Dataiterator manpage about the possible matches +modes and the _flags_ argument. For all (matching) values, the callback +function is called with the _cbdata_ callback argument and the data +describing the value. + + +Job and Selection functions +--------------------------- +A Job consists of two Ids, _how_ and _what_. The _how_ part describes the +action, the job flags, and the selection method while the _what_ part is +in input for the selection. A Selection is a queue consisting of multiple +jobs (thus the number of elements in the queue must be a multiple of two). +See the Solver manpage for more information about jobs. + + const char *pool_job2str(Pool *pool, Id how, Id what, Id flagmask); + +Convert a job into a string. Useful for debugging purposes. The _flagmask_ +can be used to mask the flags of the job, use ``0'' if you do not want to +see such flags, ``-1'' to see all flags, or a combination of the flags +you want to see. + + void pool_job2solvables(Pool *pool, Queue *pkgs, Id how, Id what); + +Return a list of solvables that the specified job selects. + + int pool_isemptyupdatejob(Pool *pool, Id how, Id what); + +Return ``1'' if the job is an update job that does not work with any +installed package, i.e. the job is basically a no-op. You can use this +to turn no-op update jobs into install jobs (as done by package managers +like ``zypper''). + + const char *pool_selection2str(Pool *pool, Queue *selection, Id flagmask); + +Convert a selection into a string. Useful for debugging purposes. +See the pool_job2str() function for the _flagmask_ argument. + + +Odds and Ends +------------- + void pool_freeallrepos(Pool *pool, int reuseids); + +Free all repos from the pool (including all solvables). If _reuseids_ is +true, all Ids of the solvables are free to be reused the next time +solvables are created. + + void pool_clear_pos(Pool *pool); + +Clear the data position stored in the pool. + + +Architecture Policies +--------------------- +An architecture policy defines a list of architectures that can be +installed on the system, and also the relationship between them (i.e. the +ordering). Architectures can be delimited with three different characters: + +*\':'*:: +No relationship between the architectures. A package of one architecture +can not be replaced with one of the other architecture. + +*\'>'*:: +The first architecture is better than the second one. An installed package +of the second architecture may be replaced with one from the first +architecture and vice versa. The solver will select the better architecture +if the versions are the same. + +*\'='*:: +The two architectures are freely exchangeable. Used to define aliases +for architectures. + +An example would be \'+x86_64:i686=athlon>i586+'. This means that x86_64 +packages can only be replaced by other x86_64 packages, i686 packages +can be replaced by i686 and i586 packages (but i686 packages will be +preferred) and athlon is another name for the i686 architecture. + +Vendor Policies +--------------- +bla bla + +Boolean Dependencies +-------------------- +bla bla + +Namespace Dependencies +---------------------- +bla bla + + +Author +------ +Michael Schroeder +