| 1 |
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> |
| 2 |
<html lang="en"> |
| 3 |
<head> |
| 4 |
<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> |
| 5 |
<title>debtree - Package dependency graphs</title> |
| 6 |
</head> |
| 7 |
|
| 8 |
<body> |
| 9 |
<h1>debtree — package dependency graphs on steroids</h1> |
| 10 |
|
| 11 |
<table> |
| 12 |
<tbody valign="top"> |
| 13 |
<tr> |
| 14 |
<td> |
| 15 |
<h3><a href="index.html">Introduction</a></h3> |
| 16 |
|
| 17 |
<h3>Advanced usage examples</h3> |
| 18 |
|
| 19 |
<ol> |
| 20 |
<li><a href="usage1.html">Create a build dependency graph</a></li> |
| 21 |
<li><a href="usage2.html">Visualize what would happen when installing a package</a></li> |
| 22 |
<li><b>Dependencies on virtual packages</b></li> |
| 23 |
<li><a href="usage4.html">Reverse dependencies</a></li> |
| 24 |
</ol> |
| 25 |
<hr /> |
| 26 |
|
| 27 |
<p> |
| 28 |
The top graph for <tt>pident</tt> incudes three dependencies on virtual |
| 29 |
packages and shows how virtual packages and the packages that provide |
| 30 |
them can be displayed. |
| 31 |
</p><p> |
| 32 |
The first is a fairly common dependency on <tt>debconf | debconf-2.0</tt> |
| 33 |
where the latter is a virtual package provided by either <tt>debconf</tt> |
| 34 |
or <tt>cdebconf</tt>. <tt>debconf</tt> has square brackets because it is |
| 35 |
also included in the alternative dependencies; <tt>cdebconf</tt> has curly |
| 36 |
brackets because its dependencies are not included anywhere in the graph. |
| 37 |
</p><p> |
| 38 |
The second is the virtual package <tt>inet-superserver</tt>. Because the |
| 39 |
maximum number of providers was set to 5 and there are 4 packages that |
| 40 |
actually provide this virtual package, all providing packages are shown. |
| 41 |
<tt>openbsd-inetd</tt> has square brackets because it was also displayed |
| 42 |
as the preferred alternative; for the others no dependencies are shown |
| 43 |
and thus their names have curly brackets. |
| 44 |
</p><p> |
| 45 |
The third is the virtual package <tt>ident-server</tt>. There are 7 packages |
| 46 |
that provide this virtual package, which is more than the maximum that was |
| 47 |
set. Therefore no individual providing packages are shown, but the total |
| 48 |
number of providing packages is shown alongside the arrow for the |
| 49 |
relationship. Note that the requested package <tt>pidentd</tt> is one of |
| 50 |
the providing package. |
| 51 |
</p><p> |
| 52 |
Adding the option <tt>-I</tt> (show installed packages) when generating this |
| 53 |
graph, could result in the bottom graph, which has the following changes: |
| 54 |
</p> |
| 55 |
<ul> |
| 56 |
<li> |
| 57 |
as <tt>debconf</tt> is installed, <tt>debconf-2.0</tt> is no longer |
| 58 |
shown and thus the providing packages are not shown either; the ellipsis in |
| 59 |
the second row indicates there are other packages that can satisfy the |
| 60 |
alternative dependency |
| 61 |
</li><li> |
| 62 |
as <tt>openbsd-inetd</tt> is installed, only that providing package is shown |
| 63 |
as alternative and thus again <tt>inet-superserver</tt> and its providing |
| 64 |
packages are no longer included |
| 65 |
</li><li> |
| 66 |
as <tt>pidentd</tt> is installed, only that providing package is shown for |
| 67 |
<tt>ident-server</tt>; as <tt>ident-server</tt> is provided by the requested |
| 68 |
package, this virtual package is still shown; the ellipsis in the second row |
| 69 |
indicates there are other (undisplayed) providing packages |
| 70 |
</li> |
| 71 |
</ul> |
| 72 |
|
| 73 |
<p>Note that for this second graph the option <tt>--max-providers<tt> is no |
| 74 |
longer relevant.</p> |
| 75 |
|
| 76 |
</td> |
| 77 |
<td width="10" /> |
| 78 |
<td width="400"> |
| 79 |
|
| 80 |
<p><tt><font size="-1"> |
| 81 |
$ debtree --max-providers=5 pident |
| 82 |
</font></tt></p> |
| 83 |
<hr /> |
| 84 |
<img src="thumbs/usage3.1.png" alt="Dependency graph for pidentd" /> |
| 85 |
<hr /> |
| 86 |
<table> |
| 87 |
<tr> |
| 88 |
<td>Generated .dot file:</td> |
| 89 |
<td><a href="usage3.1.dot">DOT</a></td> |
| 90 |
</tr><tr> |
| 91 |
<td>Full-sized images:</td> |
| 92 |
<td><a href="usage3.1.ps" target="_blank">PS</a> | PNG | <a href="usage3.1.svg" target="_blank">SVG</a></td> |
| 93 |
</tr> |
| 94 |
</table> |
| 95 |
|
| 96 |
<br /> |
| 97 |
|
| 98 |
<p><tt><font size="-1"> |
| 99 |
$ debtree -I pident |
| 100 |
</font></tt></p> |
| 101 |
<hr /> |
| 102 |
<img src="thumbs/usage3.2.png" alt="Dependency graph for pidentd (with installed packages)" /> |
| 103 |
<hr /> |
| 104 |
<table> |
| 105 |
<tr> |
| 106 |
<td>Generated .dot file:</td> |
| 107 |
<td><a href="usage3.2.dot">DOT</a></td> |
| 108 |
</tr><tr> |
| 109 |
<td>Full-sized images:</td> |
| 110 |
<td><a href="usage3.2.ps" target="_blank">PS</a> | PNG | <a href="usage3.2.svg" target="_blank">SVG</a></td> |
| 111 |
</tr> |
| 112 |
</table> |
| 113 |
|
| 114 |
</td> |
| 115 |
</tr> |
| 116 |
</tbody> |
| 117 |
</table> |
| 118 |
|
| 119 |
</body> |
| 120 |
</html> |