diff options
Diffstat (limited to 'docs/build/html/man.html')
-rw-r--r-- | docs/build/html/man.html | 71 |
1 files changed, 36 insertions, 35 deletions
diff --git a/docs/build/html/man.html b/docs/build/html/man.html index 734bd1f..2560335 100644 --- a/docs/build/html/man.html +++ b/docs/build/html/man.html @@ -51,58 +51,58 @@ </div> <div class="section" id="description"> <h2>DESCRIPTION<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2> -<p>Auto dependency builder is a tool for analysis files accessed during -building a package. It also can be used for runtime dependencies analysis.</p> -<p>The tool can block an access to files of defined packages.</p> +<p>Auto dependency (autodep) builder is a tool for the analysis of accessed files during +the build of a package. It also can be used for runtime dependencies analysis.</p> +<p>The tool can trace, log and block access to files of given packages.</p> </div> <div class="section" id="options"> <h2>OPTIONS<a class="headerlink" href="#options" title="Permalink to this headline">¶</a></h2> <dl class="cmdoption"> <dt id="cmdoption-autodep--help"> <tt class="descname">--help</tt><tt class="descclassname"></tt><tt class="descclassname">, </tt><tt class="descname">-h</tt><tt class="descclassname"></tt><a class="headerlink" href="#cmdoption-autodep--help" title="Permalink to this definition">¶</a></dt> -<dd><p>show this help message and exit</p> +<dd><p>Show this help message and exit.</p> </dd></dl> <dl class="cmdoption"> <dt id="cmdoption-autodep-b"> <tt class="descname">-b</tt><tt class="descclassname"></tt><tt class="descclassname">, </tt><tt class="descname">--block</tt><tt class="descclassname"></tt><a class="headerlink" href="#cmdoption-autodep-b" title="Permalink to this definition">¶</a></dt> -<dd><p>strict mode: deny all access to non-dependency packages</p> +<dd><p>strict mode: Deny all access to files from non-dependency packages.</p> </dd></dl> <dl class="cmdoption"> <dt id="cmdoption-autodep--blockpkgs"> <tt class="descname">--blockpkgs</tt><tt class="descclassname">=PACKAGES</tt><a class="headerlink" href="#cmdoption-autodep--blockpkgs" title="Permalink to this definition">¶</a></dt> -<dd><p>block an access to files from this packages</p> +<dd><p>Block access to files from this packages.</p> </dd></dl> <dl class="cmdoption"> <dt id="cmdoption-autodep-f"> <tt class="descname">-f</tt><tt class="descclassname"></tt><tt class="descclassname">, </tt><tt class="descname">--files</tt><tt class="descclassname"></tt><a class="headerlink" href="#cmdoption-autodep-f" title="Permalink to this definition">¶</a></dt> -<dd><p>show accessed files and not founded files</p> +<dd><p>Show all files, accessed and missing (not found).</p> </dd></dl> <dl class="cmdoption"> <dt id="cmdoption-autodep-v"> <tt class="descname">-v</tt><tt class="descclassname"></tt><tt class="descclassname">, </tt><tt class="descname">--verbose</tt><tt class="descclassname"></tt><a class="headerlink" href="#cmdoption-autodep-v" title="Permalink to this definition">¶</a></dt> -<dd><p>show non-important packages, show unknown package and unknown stage</p> +<dd><p>Show non-important packages, unknown packages and unknown building stages.</p> </dd></dl> <dl class="cmdoption"> <dt id="cmdoption-autodep--nocolor"> <tt class="descname">--nocolor</tt><tt class="descclassname"></tt><tt class="descclassname">, </tt><tt class="descname">-C</tt><tt class="descclassname"></tt><a class="headerlink" href="#cmdoption-autodep--nocolor" title="Permalink to this definition">¶</a></dt> -<dd><p>don’t output color</p> +<dd><p>Don’t colorize output</p> </dd></dl> <dl class="cmdoption"> <dt id="cmdoption-autodep--hooklib"> <tt class="descname">--hooklib</tt><tt class="descclassname"></tt><a class="headerlink" href="#cmdoption-autodep--hooklib" title="Permalink to this definition">¶</a></dt> -<dd><p>use ld_preload logging approach(default)</p> +<dd><p>Use LD_PRELOAD logging approach (default).</p> </dd></dl> <dl class="cmdoption"> <dt id="cmdoption-autodep--fusefs"> <tt class="descname">--fusefs</tt><tt class="descclassname"></tt><a class="headerlink" href="#cmdoption-autodep--fusefs" title="Permalink to this definition">¶</a></dt> -<dd><p>use fuse logging approach(slow, but reliable)</p> +<dd><p>Use FUSE logging approach (slow, but reliable).</p> </dd></dl> </div> @@ -117,7 +117,7 @@ building a package. It also can be used for runtime dependencies analysis.</p> <thead valign="bottom"> <tr><th class="head"> </th> <th class="head">Hooklib</th> -<th class="head">Fusefs</th> +<th class="head">FuseFS</th> </tr> </thead> <tbody valign="top"> @@ -125,11 +125,11 @@ building a package. It also can be used for runtime dependencies analysis.</p> <td><strong>Any user</strong></td> <td>Only root</td> </tr> -<tr><td>Is approach allows blocking an access to files?</td> +<tr><td>Does approach allows to block access to files?</td> <td><strong>YES</strong></td> <td><strong>YES</strong></td> </tr> -<tr><td>Is overhead in performance big?</td> +<tr><td>Is the overhead in performance noticeable?</td> <td><strong>NO</strong></td> <td>YES <a class="footnote-reference" href="#f1" id="id1">[1]</a></td> </tr> @@ -138,15 +138,16 @@ building a package. It also can be used for runtime dependencies analysis.</p> <td><strong>ALL</strong></td> </tr> <tr><td>When is it recomended to use an approach?</td> -<td>For analysis +<td>Analysis of <em>buildtime</em> dependencies</td> -<td>For analysis +<td>Analysis of <em>runtime</em> dependencies</td> </tr> -<tr><td>Is any pre-requirements for using an approach?</td> +<tr><td>Are there any pre-requirements +for using an approach?</td> <td><strong>NO</strong></td> <td>FUSE must be enabled in @@ -158,33 +159,33 @@ kernel</td> <table class="docutils footnote" frame="void" id="f1" rules="none"> <colgroup><col class="label" /><col /></colgroup> <tbody valign="top"> -<tr><td class="label"><a class="fn-backref" href="#id1">[1]</a></td><td>Fuse file system is slower than normal one. Program reads many files +<tr><td class="label"><a class="fn-backref" href="#id1">[1]</a></td><td>FUSE filesystems are slower than a normal one. A Program accesses many files while launching, so this will take more time than usual.</td></tr> </tbody> </table> <table class="docutils footnote" frame="void" id="f2" rules="none"> <colgroup><col class="label" /><col /></colgroup> <tbody valign="top"> -<tr><td class="label"><a class="fn-backref" href="#id2">[2]</a></td><td>Loading of dynamic libraries and direct syscalls will not be logged.</td></tr> +<tr><td class="label"><a class="fn-backref" href="#id2">[2]</a></td><td>Loading of Dynamic libraries and direct syscalls will not be logged.</td></tr> </tbody> </table> </div> <div class="section" id="examples"> <h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2> -<div class="section" id="get-the-potential-dependencies-of-a-xchat-package"> -<h3>Get the potential dependencies of a xchat package:<a class="headerlink" href="#get-the-potential-dependencies-of-a-xchat-package" title="Permalink to this headline">¶</a></h3> -<p>autodep emerge xchat</p> +<div class="section" id="get-the-potential-dependencies-for-net-irc-xchat"> +<h3>Get the potential dependencies for net-irc/xchat:<a class="headerlink" href="#get-the-potential-dependencies-for-net-irc-xchat" title="Permalink to this headline">¶</a></h3> +<p>autodep emerge net-irc/xchat</p> </div> -<div class="section" id="get-the-potential-dependencies-of-a-xchat-package-blocking-x11-misc-util-macros-package"> -<h3>Get the potential dependencies of a xchat package, blocking x11-misc/util-macros package:<a class="headerlink" href="#get-the-potential-dependencies-of-a-xchat-package-blocking-x11-misc-util-macros-package" title="Permalink to this headline">¶</a></h3> -<p>autodep emerge –block x11-misc/util-macros emerge xchat</p> +<div class="section" id="get-the-potential-dependencies-for-net-irc-xchat-blocking-files-from-x11-misc-util-macros-package"> +<h3>Get the potential dependencies for net-irc/xchat, blocking files from x11-misc/util-macros package:<a class="headerlink" href="#get-the-potential-dependencies-for-net-irc-xchat-blocking-files-from-x11-misc-util-macros-package" title="Permalink to this headline">¶</a></h3> +<p>autodep emerge –block x11-misc/util-macros emerge net-irc/xchat</p> </div> -<div class="section" id="get-the-potential-dependencies-of-a-xchat-package-and-show-files-accessed"> -<h3>Get the potential dependencies of a xchat package, and show files accessed:<a class="headerlink" href="#get-the-potential-dependencies-of-a-xchat-package-and-show-files-accessed" title="Permalink to this headline">¶</a></h3> -<p>autodep –files emerge xchat</p> +<div class="section" id="get-the-potential-dependencies-for-net-irc-xchat-package-and-show-accessed-files"> +<h3>Get the potential dependencies for net-irc/xchat package, and show accessed files:<a class="headerlink" href="#get-the-potential-dependencies-for-net-irc-xchat-package-and-show-accessed-files" title="Permalink to this headline">¶</a></h3> +<p>autodep –files emerge net-irc/xchat</p> </div> -<div class="section" id="get-the-runtime-dependencies-of-a-xchat-and-show-files-accessed"> -<h3>Get the runtime dependencies of a xchat and show files accessed:<a class="headerlink" href="#get-the-runtime-dependencies-of-a-xchat-and-show-files-accessed" title="Permalink to this headline">¶</a></h3> +<div class="section" id="get-the-runtime-dependencies-of-a-xchat-and-show-accessed-files"> +<h3>Get the runtime dependencies of a xchat and show accessed files:<a class="headerlink" href="#get-the-runtime-dependencies-of-a-xchat-and-show-accessed-files" title="Permalink to this headline">¶</a></h3> <p>autodep –fusefs –files xchat</p> </div> </div> @@ -204,10 +205,10 @@ while launching, so this will take more time than usual.</td></tr> <li><a class="reference internal" href="#options">OPTIONS</a></li> <li><a class="reference internal" href="#hooklib-vs-fusefs">HOOKLIB VS FUSEFS</a></li> <li><a class="reference internal" href="#examples">Examples</a><ul> -<li><a class="reference internal" href="#get-the-potential-dependencies-of-a-xchat-package">Get the potential dependencies of a xchat package:</a></li> -<li><a class="reference internal" href="#get-the-potential-dependencies-of-a-xchat-package-blocking-x11-misc-util-macros-package">Get the potential dependencies of a xchat package, blocking x11-misc/util-macros package:</a></li> -<li><a class="reference internal" href="#get-the-potential-dependencies-of-a-xchat-package-and-show-files-accessed">Get the potential dependencies of a xchat package, and show files accessed:</a></li> -<li><a class="reference internal" href="#get-the-runtime-dependencies-of-a-xchat-and-show-files-accessed">Get the runtime dependencies of a xchat and show files accessed:</a></li> +<li><a class="reference internal" href="#get-the-potential-dependencies-for-net-irc-xchat">Get the potential dependencies for net-irc/xchat:</a></li> +<li><a class="reference internal" href="#get-the-potential-dependencies-for-net-irc-xchat-blocking-files-from-x11-misc-util-macros-package">Get the potential dependencies for net-irc/xchat, blocking files from x11-misc/util-macros package:</a></li> +<li><a class="reference internal" href="#get-the-potential-dependencies-for-net-irc-xchat-package-and-show-accessed-files">Get the potential dependencies for net-irc/xchat package, and show accessed files:</a></li> +<li><a class="reference internal" href="#get-the-runtime-dependencies-of-a-xchat-and-show-accessed-files">Get the runtime dependencies of a xchat and show accessed files:</a></li> </ul> </li> </ul> @@ -250,7 +251,7 @@ while launching, so this will take more time than usual.</td></tr> </div> <div class="footer"> © Copyright 2011, Alexander Bersenev. - Last updated on Aug 03, 2011. + Last updated on Aug 20, 2011. Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.0.7. </div> </body> |