Gecko [ v99win.today ]

Name	Size	Permission
CREDITS	3.66 KB	-rw-r--r--
NEWS.Debian.gz	686 B	-rw-r--r--
README	603 B	-rw-r--r--
README.Debian	1.19 KB	-rw-r--r--
arch_dependencies.md.gz	2.23 KB	-rw-r--r--
autosetup.md.gz	1.82 KB	-rw-r--r--
boolean_dependencies.md	3.67 KB	-rw-r--r--
buildprocess.md	1.09 KB	-rw-r--r--
buildroot.md	3.54 KB	-rw-r--r--
changelog.Debian.gz	2.49 KB	-rw-r--r--
conditionalbuilds.md	1.69 KB	-rw-r--r--
copyright	1.86 KB	-rw-r--r--
dependencies.md.gz	3.73 KB	-rw-r--r--
dependency_generators.md.gz	3.49 KB	-rw-r--r--
file_triggers.md	3.97 KB	-rw-r--r--
format.md.gz	3.95 KB	-rw-r--r--
hregions.md	2.8 KB	-rw-r--r--
index.md	1.29 KB	-rw-r--r--
large_files.md	2.58 KB	-rw-r--r--
lua.md.gz	3.68 KB	-rw-r--r--
macros.md.gz	4.79 KB	-rw-r--r--
more_dependencies.md.gz	2.84 KB	-rw-r--r--
multiplebuilds.md	1.83 KB	-rw-r--r--
plugins.md.gz	1.7 KB	-rw-r--r--
queryformat.md.gz	2.34 KB	-rw-r--r--
relocatable.md	1.92 KB	-rw-r--r--
scriptlet_expansion.md.gz	2.05 KB	-rw-r--r--
signatures.md	2.46 KB	-rw-r--r--
signatures_digests.md	1.48 KB	-rw-r--r--
spec.md.gz	6.98 KB	-rw-r--r--
tags.md.gz	4.79 KB	-rw-r--r--
triggers.md.gz	1.94 KB	-rw-r--r--
tsort.md.gz	2.17 KB	-rw-r--r--

Code Editor : boolean_dependencies.md

---
layout: default
title: rpm.org - Boolean Dependencies
---
## Boolean Dependencies

Starting with rpm-4.13, RPM is able to process boolean expressions in all dependencies (Requires, Recommends, Suggests, Supplements, Enhances, Conflicts). Boolean Expressions are always enclosed with parenthesis. They are build out of "normal" dependencies: either name only or name, comparison and version description.

## Boolean Operators

The following operators were introduced in RPM 4.13:

* `and` - requires all operands to be fulfilled for the term to be True.
  * `Conflicts: (pkgA and pkgB)`
 * `or` - requires one of the operands to be fulfilled
  * `Requires: (pkgA >= 3.2 or pkgB)`
 * `if` - requires the first operand to be fulfilled if the second is (reverse implication)
  * `Recommends: (myPkg-langCZ if langsupportCZ)`
 * `if else` - same as above but requires the third operand to be fulfilled if the second is not
  * `Requires: (myPkg-backend-mariaDB if mariaDB else sqlite)`

The following additional operators were introduced in RPM 4.14:

* `with` - requires all operands to be fulfilled by the same package for the term to be True.
  * `Requires: (pkgA-foo with pkgA-bar)`
 * `without` - requires a single package that satisfies the first operand but not the second (set subtraction)
  * `Requires: (pkgA-foo without pkgA-bar)`
 * `unless` - requires the first operand to be fulfilled if the second is not (reverse negative implication)
  * `Conflicts: (myPkg-driverA unless driverB)`
 * `unless else` - same as above but requires the third operand to be fulfilled if the second is
  * `Conflicts: (myPkg-backend-SDL1 unless myPkg-backend-SDL2 else SDL2)`

The `if` operator cannot be used in the same context with `or` and the `unless` operator cannot be used in the same context with `and`.

## Nesting

Operands can be Boolean Expressions themselves. They also need to be surrounded by parenthesis. `and` and `or` operators may be chained together repeating the same operator with only one set of surrounding parenthesis.

Examples:

`Requires: (pkgA or pkgB or pkgC)`

`Requires: (pkgA or (pkgB and pkgC))`

`Supplements: (foo and (lang-support-cz or lang-support-all))`

`Requires: ((pkgA with capB) or (pkgB without capA))`

`Supplements: ((driverA and driverA-tools) unless driverB)`

`Recommends: ((myPkg-langCZ and (font1-langCZ or font2-langCZ)) if langsupportCZ)`

## Semantics

The Semantic of the dependencies stay unchanged but instead checking for one match all names are checked and the Boolean value of there being a match is then aggregated over the Boolean operators. For a conflict to not prevent an install the result has to be False for everything else it has to be True.

Note that '''Provides''' are not dependencies and '''cannot contain Boolean Expressions'''.

### Incompatible nesting of operators

Note that the `if` operator is also returning a Boolean value. This is close to what the intuitive reading in most cases. E.g:

`Requires: (pkgA if pkgB)`

is True (and everything is OK) if pkgB is not installed. But if the same term is used where the "default" is False things become complicated:

`Conflicts: (pkgA if pkgB)`

is a Conflict unless pkgB is installed and pkgA is not. So one might rather want to use

`Conflicts: (pkgA and pkgB)`

in this case. The same is true if the `if` operator is nested in `or` terms.

`Requires: ((pkgA if pkgB) or pkgC or pkg)`

As the `if` term is True if pkgB is not installed this also makes the whole term True. If pkgA only helps if pkgB is installed you should use `and` instead:

`Requires: ((pkgA and pkgB) or pkgC or pkg)`

To avoid this confusion rpm refuses nesting `if` in such `or` like contexts (including `Conflicts:`) and `unless` in `and` like contexts.

${this.title}

Code Editor : boolean_dependencies.md