summaryrefslogtreecommitdiff
path: root/doc/external-dependency-solver-protocol.txt
diff options
context:
space:
mode:
authorStefano Zacchiroli <zack@upsilon.cc>2011-04-04 15:20:13 +0200
committerStefano Zacchiroli <zack@upsilon.cc>2011-04-04 15:20:13 +0200
commit1083e5c3dd59fedd6135e0af14882ce4b0491383 (patch)
tree2040de9c5a0aab31f7ef33e3d4d6ebe7658ed934 /doc/external-dependency-solver-protocol.txt
parent3facf96abc9d0b7a6d42c621f1cdad290e9a277d (diff)
add Dir::Bin::Solvers to enable customization of solver directory
EDSP version 0.4
Diffstat (limited to 'doc/external-dependency-solver-protocol.txt')
-rw-r--r--doc/external-dependency-solver-protocol.txt16
1 files changed, 10 insertions, 6 deletions
diff --git a/doc/external-dependency-solver-protocol.txt b/doc/external-dependency-solver-protocol.txt
index 8c13b185c..ae01fbc35 100644
--- a/doc/external-dependency-solver-protocol.txt
+++ b/doc/external-dependency-solver-protocol.txt
@@ -1,4 +1,4 @@
-# APT External Dependency Solver Protocol (EDSP) - version 0.3
+# APT External Dependency Solver Protocol (EDSP) - version 0.4
This document describes the communication protocol between APT and
external dependency solvers. The protocol is called APT EDSP, for "APT
@@ -26,10 +26,12 @@ internal solver, is reserved, and cannot be used by external solvers.
## Installation
-Each external solver is installed as a file under
-`/usr/lib/apt/solvers`. The naming scheme is
-`/usr/lib/apt/solvers/NAME`, where `NAME` is the name of the external
-solver.
+Each external solver is installed as a file under Dir::Bin::Solvers (see
+below), which defaults to `/usr/lib/apt/solvers`. We will assume in the
+remainder of this section that such a default value is in effect.
+
+The naming scheme is `/usr/lib/apt/solvers/NAME`, where `NAME` is the
+name of the external solver.
Each file under `/usr/lib/apt/solvers` corresponding to an external
solver must be executable.
@@ -57,6 +59,8 @@ configuration documentation for more, and more up to date, information.
when the solver NAME is in use. Check solver-specific documentation
for what is supported here. Defaults to the empty string.
+- **Dir::Bin::Solvers**: absolute path of the directory where to look for
+ external solvers. Defaults to `/usr/lib/apt/solvers`.
## Protocol
@@ -110,7 +114,7 @@ and followed by a mixture of action and preference fields.
The value of the **Request:** field is a string describing the EDSP
protocol which will be used to communicate. At present, the string must
-be `EDSP 0.3`.
+be `EDSP 0.4`.
a unique request identifier, such as an
UUID. Request fields are mainly used to identify the beginning of a