Debian Codegraph @

html/usage3.html

raw
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 &mdash; 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>&nbsp;|&nbsp;PNG&nbsp;|&nbsp;<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>&nbsp;|&nbsp;PNG&nbsp;|&nbsp;<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>