diff options
| author |   Alexander Bersenev <bay@hackerdom.ru> | 2011-08-03 02:35:28 +0000 |
|---|---|---|
| committer | Alexander Bersenev <bay@hackerdom.ru> | 2011-08-03 02:35:28 +0000 |
| commit | 24cc5cf722f06b219ffbc5246c45e9a1de1a2f87 (patch) | |
| tree | 37db497aaabefd70f38bce9af7c753eb59ea950b /docs/build | |
| parent | hooklib: hide blocked files in directories (diff) | |
| download | autodep-24cc5cf722f06b219ffbc5246c45e9a1de1a2f87.tar.gz autodep-24cc5cf722f06b219ffbc5246c45e9a1de1a2f87.tar.bz2 autodep-24cc5cf722f06b219ffbc5246c45e9a1de1a2f87.zip | |
small docs changes
Diffstat (limited to 'docs/build')
21 files changed, 376 insertions, 103 deletions
diff --git a/docs/build/doctrees/api.doctree b/docs/build/doctrees/api.doctree Binary files differindex c9fac92..bfb5a6d 100644 --- a/docs/build/doctrees/api.doctree +++ b/docs/build/doctrees/api.doctree diff --git a/docs/build/doctrees/environment.pickle b/docs/build/doctrees/environment.pickle Binary files differindex 3f1e1b1..3f806c9 100644 --- a/docs/build/doctrees/environment.pickle +++ b/docs/build/doctrees/environment.pickle diff --git a/docs/build/doctrees/intro.doctree b/docs/build/doctrees/intro.doctree Binary files differindex e59e70e..314b99e 100644 --- a/docs/build/doctrees/intro.doctree +++ b/docs/build/doctrees/intro.doctree diff --git a/docs/build/doctrees/man.doctree b/docs/build/doctrees/man.doctree Binary files differindex 5343497..a6ca5c2 100644 --- a/docs/build/doctrees/man.doctree +++ b/docs/build/doctrees/man.doctree diff --git a/docs/build/html/_modules/index.html b/docs/build/html/_modules/index.html index 9bb0382..a676437 100644 --- a/docs/build/html/_modules/index.html +++ b/docs/build/html/_modules/index.html @@ -86,7 +86,7 @@ </div> <div class="footer"> © Copyright 2011, Alexander Bersenev. - Last updated on Jul 25, 2011. + Last updated on Aug 03, 2011. Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.0.7. </div> </body> diff --git a/docs/build/html/_modules/logfs/fstracer.html b/docs/build/html/_modules/logfs/fstracer.html index fc474a1..0214fa6 100644 --- a/docs/build/html/_modules/logfs/fstracer.html +++ b/docs/build/html/_modules/logfs/fstracer.html @@ -327,7 +327,7 @@ </div> <div class="footer"> © Copyright 2011, Alexander Bersenev. - Last updated on Jul 25, 2011. + Last updated on Aug 03, 2011. Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.0.7. </div> </body> diff --git a/docs/build/html/_modules/package_utils/portage_log_parser.html b/docs/build/html/_modules/package_utils/portage_log_parser.html index 47f92b6..2c02aa7 100644 --- a/docs/build/html/_modules/package_utils/portage_log_parser.html +++ b/docs/build/html/_modules/package_utils/portage_log_parser.html @@ -170,7 +170,7 @@ </div> <div class="footer"> © Copyright 2011, Alexander Bersenev. - Last updated on Jul 25, 2011. + Last updated on Aug 03, 2011. Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.0.7. </div> </body> diff --git a/docs/build/html/_modules/package_utils/portage_misc_functions.html b/docs/build/html/_modules/package_utils/portage_misc_functions.html index d95ce7d..637694c 100644 --- a/docs/build/html/_modules/package_utils/portage_misc_functions.html +++ b/docs/build/html/_modules/package_utils/portage_misc_functions.html @@ -188,7 +188,7 @@ </div> <div class="footer"> © Copyright 2011, Alexander Bersenev. - Last updated on Jul 25, 2011. + Last updated on Aug 03, 2011. Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.0.7. </div> </body> diff --git a/docs/build/html/_modules/package_utils/portage_utils.html b/docs/build/html/_modules/package_utils/portage_utils.html index 94f8a00..58064e7 100644 --- a/docs/build/html/_modules/package_utils/portage_utils.html +++ b/docs/build/html/_modules/package_utils/portage_utils.html @@ -158,7 +158,7 @@ </div> <div class="footer"> © Copyright 2011, Alexander Bersenev. - Last updated on Jul 25, 2011. + Last updated on Aug 03, 2011. Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.0.7. </div> </body> diff --git a/docs/build/html/_sources/intro.txt b/docs/build/html/_sources/intro.txt index 5ee0dd5..82278ac 100644 --- a/docs/build/html/_sources/intro.txt +++ b/docs/build/html/_sources/intro.txt @@ -5,7 +5,8 @@ Introduction Overview =================================== Auto dependency builder is a tool for analysis files accessed during -building a package. It also can be used for runtime dependencies analysis. +building a package. It also can be used for buildtime and runtime dependency +analysis. The tool can block an access to files of defined packages. @@ -23,17 +24,21 @@ Installing Running =================================== -.. program:: showfsevents.py +.. program:: autodep .. code-block:: none - showfsevents.py [options] <command> + autodep [options] <command> .. cmdoption:: --help, -h show this help message and exit -.. cmdoption:: -b PACKAGES, --block=PACKAGES +.. cmdoption:: -b, --block + + strict mode: deny all access to non-dependency packages + +.. cmdoption:: --blockpkgs=PACKAGES block an access to files from this packages @@ -95,28 +100,28 @@ Examples .. code-block:: none - showfsevents.py emerge xchat + autodep emerge xchat .. rubric:: 2. Get the potential dependencies of a xchat package, blocking x11-misc/util-macros package: .. code-block:: none - showfsevents.py emerge --block x11-misc/util-macros emerge xchat + autodep emerge --block x11-misc/util-macros emerge xchat .. rubric:: 3. Get the potential dependencies of a xchat package, and show files accessed: .. code-block:: none - showfsevents.py --files emerge xchat + autodep --files emerge xchat .. rubric:: 4. Get the runtime dependencies of a xchat and show files accessed: .. code-block:: none - showfsevents.py --fusefs --files xchat + autodep --fusefs --files xchat diff --git a/docs/build/html/_sources/man.txt b/docs/build/html/_sources/man.txt index ca7fdab..b49fb54 100644 --- a/docs/build/html/_sources/man.txt +++ b/docs/build/html/_sources/man.txt @@ -5,7 +5,7 @@ USER COMMANDS SYNOPSIS ======== -**showfsevents.py** [options] <command> +**autodep** [options] <command> DESCRIPTION =========== @@ -18,13 +18,17 @@ The tool can block an access to files of defined packages. OPTIONS ======= -.. program:: showfsevents.py +.. program:: autodep .. cmdoption:: --help, -h show this help message and exit -.. cmdoption:: -b PACKAGES, --block=PACKAGES +.. cmdoption:: -b, --block + + strict mode: deny all access to non-dependency packages + +.. cmdoption:: --blockpkgs=PACKAGES block an access to files from this packages @@ -79,17 +83,17 @@ Examples Get the potential dependencies of a xchat package: ----------------------------------------------------- -showfsevents.py emerge xchat +autodep emerge xchat Get the potential dependencies of a xchat package, blocking x11-misc/util-macros package: -------------------------------------------------------------------------------------------- -showfsevents.py emerge --block x11-misc/util-macros emerge xchat +autodep emerge --block x11-misc/util-macros emerge xchat Get the potential dependencies of a xchat package, and show files accessed: ------------------------------------------------------------------------------ -showfsevents.py --files emerge xchat +autodep --files emerge xchat Get the runtime dependencies of a xchat and show files accessed: ------------------------------------------------------------------- -showfsevents.py --fusefs --files xchat +autodep --fusefs --files xchat diff --git a/docs/build/html/api.html b/docs/build/html/api.html index cbbdce2..c5963a3 100644 --- a/docs/build/html/api.html +++ b/docs/build/html/api.html @@ -56,7 +56,7 @@ handling dependency logic.</p> <p>It can be used to launch a program and get all file events</p> <dl class="function"> <dt id="logfs.fstracer.getfsevents"> -<tt class="descclassname">logfs.fstracer.</tt><tt class="descname">getfsevents</tt><big>(</big><em>prog_name</em>, <em>arguments</em>, <em>approach='hooklib'</em>, <em>filterproc=<function defaultfilter at 0x19e7b18></em><big>)</big><a class="reference internal" href="_modules/logfs/fstracer.html#getfsevents"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#logfs.fstracer.getfsevents" title="Permalink to this definition">¶</a></dt> +<tt class="descclassname">logfs.fstracer.</tt><tt class="descname">getfsevents</tt><big>(</big><em>prog_name</em>, <em>arguments</em>, <em>approach='hooklib'</em>, <em>filterproc=<function defaultfilter at 0x1dbdb90></em><big>)</big><a class="reference internal" href="_modules/logfs/fstracer.html#getfsevents"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#logfs.fstracer.getfsevents" title="Permalink to this definition">¶</a></dt> <dd><p>Launches a program and gets file access events</p> <table class="docutils field-list" frame="void" rules="none"> <col class="field-name" /> @@ -113,6 +113,20 @@ Stage can be <em>‘unknown’</em></p> </dd></dl> <span class="target" id="module-package_utils.portage_utils"></span><dl class="function"> +<dt id="package_utils.portage_utils.get_all_packages_files"> +<tt class="descclassname">package_utils.portage_utils.</tt><tt class="descname">get_all_packages_files</tt><big>(</big><big>)</big><a class="headerlink" href="#package_utils.portage_utils.get_all_packages_files" title="Permalink to this definition">¶</a></dt> +<dd><p>Memory-hungry operation</p> +<table class="docutils field-list" frame="void" rules="none"> +<col class="field-name" /> +<col class="field-body" /> +<tbody valign="top"> +<tr class="field"><th class="field-name">Returns:</th><td class="field-body"><strong>set</strong> of all files that belongs to package</td> +</tr> +</tbody> +</table> +</dd></dl> + +<dl class="function"> <dt id="package_utils.portage_utils.getfilesbypackage"> <tt class="descclassname">package_utils.portage_utils.</tt><tt class="descname">getfilesbypackage</tt><big>(</big><em>packagename</em><big>)</big><a class="reference internal" href="_modules/package_utils/portage_utils.html#getfilesbypackage"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#package_utils.portage_utils.getfilesbypackage" title="Permalink to this definition">¶</a></dt> <dd><table class="docutils field-list" frame="void" rules="none"> @@ -148,9 +162,38 @@ package it not returned as key of this dictionary</td> <em class="property">class </em><tt class="descclassname">package_utils.portage_misc_functions.</tt><tt class="descname">portage_api</tt><a class="reference internal" href="_modules/package_utils/portage_misc_functions.html#portage_api"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#package_utils.portage_misc_functions.portage_api" title="Permalink to this definition">¶</a></dt> <dd><p>class for accessing the portage api</p> <dl class="method"> +<dt id="package_utils.portage_misc_functions.portage_api.get_best_visible_pkg"> +<tt class="descname">get_best_visible_pkg</tt><big>(</big><em>pkg</em><big>)</big><a class="headerlink" href="#package_utils.portage_misc_functions.portage_api.get_best_visible_pkg" title="Permalink to this definition">¶</a></dt> +<dd><p>Gets best candidate on installing. Returns empty string if no found</p> +</dd></dl> + +<dl class="method"> +<dt id="package_utils.portage_misc_functions.portage_api.get_dep"> +<tt class="descname">get_dep</tt><big>(</big><em>pkg, dep_type=['RDEPEND', 'DEPEND']</em><big>)</big><a class="headerlink" href="#package_utils.portage_misc_functions.portage_api.get_dep" title="Permalink to this definition">¶</a></dt> +<dd><p>Gets current dependencies of a package. Looks in portage db</p> +<table class="docutils field-list" frame="void" rules="none"> +<col class="field-name" /> +<col class="field-body" /> +<tbody valign="top"> +<tr class="field"><th class="field-name">Parameters:</th><td class="field-body"><ul class="first simple"> +<li><strong>pkg</strong> – name of package</li> +<li><strong>dep_type</strong> – type of dependencies to recurse. Can be [“DEPEND”] or +[“RDEPEND”, “DEPEND”]</li> +</ul> +</td> +</tr> +<tr class="field"><th class="field-name">Returns:</th><td class="field-body"><p class="first last"><strong>set</strong> of packages names</p> +</td> +</tr> +</tbody> +</table> +</dd></dl> + +<dl class="method"> <dt id="package_utils.portage_misc_functions.portage_api.get_deps"> <tt class="descname">get_deps</tt><big>(</big><em>pkg, dep_type=['RDEPEND', 'DEPEND']</em><big>)</big><a class="reference internal" href="_modules/package_utils/portage_misc_functions.html#portage_api.get_deps"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#package_utils.portage_misc_functions.portage_api.get_deps" title="Permalink to this definition">¶</a></dt> -<dd><p>Gets current dependencies of a package on any depth</p> +<dd><p>Gets current dependencies of a package on any depth +All dependencies <strong>must</strong> be installed</p> <table class="docutils field-list" frame="void" rules="none"> <col class="field-name" /> <col class="field-body" /> @@ -170,6 +213,14 @@ package it not returned as key of this dictionary</td> </dd></dl> <dl class="method"> +<dt id="package_utils.portage_misc_functions.portage_api.get_merge_list"> +<tt class="descname">get_merge_list</tt><big>(</big><em>emergeargs</em><big>)</big><a class="headerlink" href="#package_utils.portage_misc_functions.portage_api.get_merge_list" title="Permalink to this definition">¶</a></dt> +<dd><p>Gets list of packages that emerge with emergeargs-arguments will merge +This function uses very internal functions of portage so +it may be unreliable in various portage versions</p> +</dd></dl> + +<dl class="method"> <dt id="package_utils.portage_misc_functions.portage_api.get_system_packages_list"> <tt class="descname">get_system_packages_list</tt><big>(</big><big>)</big><a class="reference internal" href="_modules/package_utils/portage_misc_functions.html#portage_api.get_system_packages_list"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#package_utils.portage_misc_functions.portage_api.get_system_packages_list" title="Permalink to this definition">¶</a></dt> <dd><p>returns all packages from system set. They are always implicit dependencies</p> @@ -262,7 +313,7 @@ list)</td> </div> <div class="footer"> © Copyright 2011, Alexander Bersenev. - Last updated on Jul 25, 2011. + Last updated on Aug 03, 2011. Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.0.7. </div> </body> diff --git a/docs/build/html/genindex.html b/docs/build/html/genindex.html index b1a69d7..e44ab7a 100644 --- a/docs/build/html/genindex.html +++ b/docs/build/html/genindex.html @@ -47,52 +47,76 @@ <h1 id="index">Index</h1> <div class="genindex-jumpbox"> - <a href="#Symbols"><strong>Symbols</strong></a> | <a href="#G"><strong>G</strong></a> | <a href="#L"><strong>L</strong></a> | <a href="#P"><strong>P</strong></a> | <a href="#S"><strong>S</strong></a> + <a href="#Symbols"><strong>Symbols</strong></a> | <a href="#A"><strong>A</strong></a> | <a href="#G"><strong>G</strong></a> | <a href="#L"><strong>L</strong></a> | <a href="#P"><strong>P</strong></a> </div> <h2 id="Symbols">Symbols</h2> <table style="width: 100%" class="indextable genindextable"><tr> <td style="width: 33%" valign="top"><dl> + <dt>--blockpkgs=PACKAGES</dt> + <dd><dl> + <dt><a href="intro.html#cmdoption-autodep--blockpkgs">autodep command line option</a>, <a href="man.html#cmdoption-autodep--blockpkgs">[1]</a></dt> + </dl></dd> <dt>--fusefs</dt> <dd><dl> - <dt><a href="intro.html#cmdoption-showfsevents.py--fusefs">showfsevents.py command line option</a>, <a href="man.html#cmdoption-showfsevents.py--fusefs">[1]</a></dt> + <dt><a href="intro.html#cmdoption-autodep--fusefs">autodep command line option</a>, <a href="man.html#cmdoption-autodep--fusefs">[1]</a></dt> </dl></dd> <dt>--help, -h</dt> <dd><dl> - <dt><a href="intro.html#cmdoption-showfsevents.py--help">showfsevents.py command line option</a>, <a href="man.html#cmdoption-showfsevents.py--help">[1]</a></dt> + <dt><a href="intro.html#cmdoption-autodep--help">autodep command line option</a>, <a href="man.html#cmdoption-autodep--help">[1]</a></dt> </dl></dd> <dt>--hooklib</dt> <dd><dl> - <dt><a href="intro.html#cmdoption-showfsevents.py--hooklib">showfsevents.py command line option</a>, <a href="man.html#cmdoption-showfsevents.py--hooklib">[1]</a></dt> + <dt><a href="intro.html#cmdoption-autodep--hooklib">autodep command line option</a>, <a href="man.html#cmdoption-autodep--hooklib">[1]</a></dt> </dl></dd> <dt>--nocolor, -C</dt> <dd><dl> - <dt><a href="man.html#cmdoption-showfsevents.py--nocolor">showfsevents.py command line option</a></dt> + <dt><a href="man.html#cmdoption-autodep--nocolor">autodep command line option</a></dt> </dl></dd> - <dt>-b PACKAGES, --block=PACKAGES</dt> + <dt>-b, --block</dt> <dd><dl> - <dt><a href="intro.html#cmdoption-showfsevents.py-b">showfsevents.py command line option</a>, <a href="man.html#cmdoption-showfsevents.py-b">[1]</a></dt> + <dt><a href="intro.html#cmdoption-autodep-b">autodep command line option</a>, <a href="man.html#cmdoption-autodep-b">[1]</a></dt> </dl></dd> </dl></td> <td style="width: 33%" valign="top"><dl> <dt>-C , --nocolor</dt> <dd><dl> - <dt><a href="intro.html#cmdoption-showfsevents.py-C">showfsevents.py command line option</a></dt> + <dt><a href="intro.html#cmdoption-autodep-C">autodep command line option</a></dt> </dl></dd> <dt>-f , --files</dt> <dd><dl> - <dt><a href="intro.html#cmdoption-showfsevents.py-f">showfsevents.py command line option</a></dt> + <dt><a href="intro.html#cmdoption-autodep-f">autodep command line option</a></dt> </dl></dd> <dt>-f, --files</dt> <dd><dl> - <dt><a href="man.html#cmdoption-showfsevents.py-f">showfsevents.py command line option</a></dt> + <dt><a href="man.html#cmdoption-autodep-f">autodep command line option</a></dt> </dl></dd> <dt>-v , --verbose</dt> <dd><dl> - <dt><a href="intro.html#cmdoption-showfsevents.py-v">showfsevents.py command line option</a></dt> + <dt><a href="intro.html#cmdoption-autodep-v">autodep command line option</a></dt> </dl></dd> <dt>-v, --verbose</dt> <dd><dl> - <dt><a href="man.html#cmdoption-showfsevents.py-v">showfsevents.py command line option</a></dt> + <dt><a href="man.html#cmdoption-autodep-v">autodep command line option</a></dt> + </dl></dd> +</dl></td> +</tr></table> + +<h2 id="A">A</h2> +<table style="width: 100%" class="indextable genindextable"><tr> + <td style="width: 33%" valign="top"><dl> + <dt>autodep command line option</dt> + <dd><dl> + <dt><a href="intro.html#cmdoption-autodep--blockpkgs">--blockpkgs=PACKAGES</a>, <a href="man.html#cmdoption-autodep--blockpkgs">[1]</a></dt> + <dt><a href="intro.html#cmdoption-autodep--fusefs">--fusefs</a>, <a href="man.html#cmdoption-autodep--fusefs">[1]</a></dt> + <dt><a href="intro.html#cmdoption-autodep--help">--help, -h</a>, <a href="man.html#cmdoption-autodep--help">[1]</a></dt> + <dt><a href="intro.html#cmdoption-autodep--hooklib">--hooklib</a>, <a href="man.html#cmdoption-autodep--hooklib">[1]</a></dt> + <dt><a href="man.html#cmdoption-autodep--nocolor">--nocolor, -C</a></dt> + <dt><a href="intro.html#cmdoption-autodep-C">-C , --nocolor</a></dt> + <dt><a href="intro.html#cmdoption-autodep-b">-b, --block</a>, <a href="man.html#cmdoption-autodep-b">[1]</a></dt> + <dt><a href="intro.html#cmdoption-autodep-f">-f , --files</a></dt> + <dt><a href="man.html#cmdoption-autodep-f">-f, --files</a></dt> + <dt><a href="intro.html#cmdoption-autodep-v">-v , --verbose</a></dt> + <dt><a href="man.html#cmdoption-autodep-v">-v, --verbose</a></dt> </dl></dd> </dl></td> </tr></table> @@ -100,11 +124,15 @@ <h2 id="G">G</h2> <table style="width: 100%" class="indextable genindextable"><tr> <td style="width: 33%" valign="top"><dl> + <dt><a href="api.html#package_utils.portage_utils.get_all_packages_files">get_all_packages_files() (in module package_utils.portage_utils)</a></dt> + <dt><a href="api.html#package_utils.portage_misc_functions.portage_api.get_best_visible_pkg">get_best_visible_pkg() (package_utils.portage_misc_functions.portage_api method)</a></dt> + <dt><a href="api.html#package_utils.portage_misc_functions.portage_api.get_dep">get_dep() (package_utils.portage_misc_functions.portage_api method)</a></dt> <dt><a href="api.html#package_utils.portage_misc_functions.portage_api.get_deps">get_deps() (package_utils.portage_misc_functions.portage_api method)</a></dt> <dt><a href="api.html#package_utils.portage_log_parser.get_list_of_merged_packages">get_list_of_merged_packages() (in module package_utils.portage_log_parser)</a></dt> - <dt><a href="api.html#package_utils.portage_misc_functions.portage_api.get_system_packages_list">get_system_packages_list() (package_utils.portage_misc_functions.portage_api method)</a></dt> </dl></td> <td style="width: 33%" valign="top"><dl> + <dt><a href="api.html#package_utils.portage_misc_functions.portage_api.get_merge_list">get_merge_list() (package_utils.portage_misc_functions.portage_api method)</a></dt> + <dt><a href="api.html#package_utils.portage_misc_functions.portage_api.get_system_packages_list">get_system_packages_list() (package_utils.portage_misc_functions.portage_api method)</a></dt> <dt><a href="api.html#package_utils.portage_utils.getfilesbypackage">getfilesbypackage() (in module package_utils.portage_utils)</a></dt> <dt><a href="api.html#logfs.fstracer.getfsevents">getfsevents() (in module logfs.fstracer)</a></dt> <dt><a href="api.html#package_utils.portage_utils.getpackagesbyfiles">getpackagesbyfiles() (in module package_utils.portage_utils)</a></dt> @@ -131,25 +159,6 @@ </dl></td> </tr></table> -<h2 id="S">S</h2> -<table style="width: 100%" class="indextable genindextable"><tr> - <td style="width: 33%" valign="top"><dl> - <dt>showfsevents.py command line option</dt> - <dd><dl> - <dt><a href="intro.html#cmdoption-showfsevents.py--fusefs">--fusefs</a>, <a href="man.html#cmdoption-showfsevents.py--fusefs">[1]</a></dt> - <dt><a href="intro.html#cmdoption-showfsevents.py--help">--help, -h</a>, <a href="man.html#cmdoption-showfsevents.py--help">[1]</a></dt> - <dt><a href="intro.html#cmdoption-showfsevents.py--hooklib">--hooklib</a>, <a href="man.html#cmdoption-showfsevents.py--hooklib">[1]</a></dt> - <dt><a href="man.html#cmdoption-showfsevents.py--nocolor">--nocolor, -C</a></dt> - <dt><a href="intro.html#cmdoption-showfsevents.py-C">-C , --nocolor</a></dt> - <dt><a href="intro.html#cmdoption-showfsevents.py-b">-b PACKAGES, --block=PACKAGES</a>, <a href="man.html#cmdoption-showfsevents.py-b">[1]</a></dt> - <dt><a href="intro.html#cmdoption-showfsevents.py-f">-f , --files</a></dt> - <dt><a href="man.html#cmdoption-showfsevents.py-f">-f, --files</a></dt> - <dt><a href="intro.html#cmdoption-showfsevents.py-v">-v , --verbose</a></dt> - <dt><a href="man.html#cmdoption-showfsevents.py-v">-v, --verbose</a></dt> - </dl></dd> -</dl></td> -</tr></table> - </div> @@ -191,7 +200,7 @@ </div> <div class="footer"> © Copyright 2011, Alexander Bersenev. - Last updated on Jul 25, 2011. + Last updated on Aug 03, 2011. Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.0.7. </div> </body> diff --git a/docs/build/html/index.html b/docs/build/html/index.html index 6fc6a22..b56bed7 100644 --- a/docs/build/html/index.html +++ b/docs/build/html/index.html @@ -136,7 +136,7 @@ </div> <div class="footer"> © Copyright 2011, Alexander Bersenev. - Last updated on Jul 25, 2011. + Last updated on Aug 03, 2011. Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.0.7. </div> </body> diff --git a/docs/build/html/intro.html b/docs/build/html/intro.html index 75211da..18e7294 100644 --- a/docs/build/html/intro.html +++ b/docs/build/html/intro.html @@ -56,7 +56,8 @@ <div class="section" id="overview"> <h2>Overview<a class="headerlink" href="#overview" 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> +building a package. It also can be used for buildtime and runtime dependency +analysis.</p> <p>The tool can block an access to files of defined packages.</p> <p>It is released under GNU GPL license.</p> </div> @@ -73,48 +74,54 @@ building a package. It also can be used for runtime dependencies analysis.</p> </div> <div class="section" id="running"> <h2>Running<a class="headerlink" href="#running" title="Permalink to this headline">¶</a></h2> -<div class="highlight-none"><div class="highlight"><pre>showfsevents.py [options] <command> +<div class="highlight-none"><div class="highlight"><pre>autodep [options] <command> </pre></div> </div> <dl class="cmdoption"> -<dt id="cmdoption-showfsevents.py--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-showfsevents.py--help" title="Permalink to this definition">¶</a></dt> +<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></dl> <dl class="cmdoption"> -<dt id="cmdoption-showfsevents.py-b"> -<tt class="descname">-b</tt><tt class="descclassname"> PACKAGES</tt><tt class="descclassname">, </tt><tt class="descname">--block</tt><tt class="descclassname">=PACKAGES</tt><a class="headerlink" href="#cmdoption-showfsevents.py-b" title="Permalink to this definition">¶</a></dt> +<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></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></dl> <dl class="cmdoption"> -<dt id="cmdoption-showfsevents.py-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-showfsevents.py-f" title="Permalink to this definition">¶</a></dt> +<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></dl> <dl class="cmdoption"> -<dt id="cmdoption-showfsevents.py-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-showfsevents.py-v" title="Permalink to this definition">¶</a></dt> +<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></dl> <dl class="cmdoption"> -<dt id="cmdoption-showfsevents.py-C"> -<tt class="descname">-C</tt><tt class="descclassname"> </tt><tt class="descclassname">, </tt><tt class="descname">--nocolor</tt><tt class="descclassname"></tt><a class="headerlink" href="#cmdoption-showfsevents.py-C" title="Permalink to this definition">¶</a></dt> +<dt id="cmdoption-autodep-C"> +<tt class="descname">-C</tt><tt class="descclassname"> </tt><tt class="descclassname">, </tt><tt class="descname">--nocolor</tt><tt class="descclassname"></tt><a class="headerlink" href="#cmdoption-autodep-C" title="Permalink to this definition">¶</a></dt> <dd><p>don’t output color</p> </dd></dl> <dl class="cmdoption"> -<dt id="cmdoption-showfsevents.py--hooklib"> -<tt class="descname">--hooklib</tt><tt class="descclassname"></tt><a class="headerlink" href="#cmdoption-showfsevents.py--hooklib" title="Permalink to this definition">¶</a></dt> +<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></dl> <dl class="cmdoption"> -<dt id="cmdoption-showfsevents.py--fusefs"> -<tt class="descname">--fusefs</tt><tt class="descclassname"></tt><a class="headerlink" href="#cmdoption-showfsevents.py--fusefs" title="Permalink to this definition">¶</a></dt> +<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></dl> @@ -186,22 +193,22 @@ while launching, so this will take more time than usual.</td></tr> <div class="section" id="examples"> <h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2> <p class="rubric">1. Get the potential dependencies of a xchat package:</p> -<div class="highlight-none"><div class="highlight"><pre>showfsevents.py emerge xchat +<div class="highlight-none"><div class="highlight"><pre>autodep emerge xchat </pre></div> </div> <p class="rubric">2. Get the potential dependencies of a xchat package, blocking x11-misc/util-macros package:</p> -<div class="highlight-none"><div class="highlight"><pre>showfsevents.py emerge --block x11-misc/util-macros emerge xchat +<div class="highlight-none"><div class="highlight"><pre>autodep emerge --block x11-misc/util-macros emerge xchat </pre></div> </div> <p class="rubric">3. Get the potential dependencies of a xchat package, and show files accessed:</p> -<div class="highlight-none"><div class="highlight"><pre>showfsevents.py --files emerge xchat +<div class="highlight-none"><div class="highlight"><pre>autodep --files emerge xchat </pre></div> </div> <p class="rubric">4. Get the runtime dependencies of a xchat and show files accessed:</p> -<div class="highlight-none"><div class="highlight"><pre>showfsevents.py --fusefs --files xchat +<div class="highlight-none"><div class="highlight"><pre>autodep --fusefs --files xchat </pre></div> </div> </div> @@ -283,7 +290,7 @@ accessed:</p> </div> <div class="footer"> © Copyright 2011, Alexander Bersenev. - Last updated on Jul 25, 2011. + Last updated on Aug 03, 2011. Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.0.7. </div> </body> diff --git a/docs/build/html/man.html b/docs/build/html/man.html index f2b221a..734bd1f 100644 --- a/docs/build/html/man.html +++ b/docs/build/html/man.html @@ -47,7 +47,7 @@ <h1>USER COMMANDS<a class="headerlink" href="#user-commands" title="Permalink to this headline">¶</a></h1> <div class="section" id="synopsis"> <h2>SYNOPSIS<a class="headerlink" href="#synopsis" title="Permalink to this headline">¶</a></h2> -<p><strong>showfsevents.py</strong> [options] <command></p> +<p><strong>autodep</strong> [options] <command></p> </div> <div class="section" id="description"> <h2>DESCRIPTION<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2> @@ -58,44 +58,50 @@ building a package. It also can be used for runtime dependencies analysis.</p> <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-showfsevents.py--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-showfsevents.py--help" title="Permalink to this definition">¶</a></dt> +<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></dl> <dl class="cmdoption"> -<dt id="cmdoption-showfsevents.py-b"> -<tt class="descname">-b</tt><tt class="descclassname"> PACKAGES</tt><tt class="descclassname">, </tt><tt class="descname">--block</tt><tt class="descclassname">=PACKAGES</tt><a class="headerlink" href="#cmdoption-showfsevents.py-b" title="Permalink to this definition">¶</a></dt> +<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></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></dl> <dl class="cmdoption"> -<dt id="cmdoption-showfsevents.py-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-showfsevents.py-f" title="Permalink to this definition">¶</a></dt> +<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></dl> <dl class="cmdoption"> -<dt id="cmdoption-showfsevents.py-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-showfsevents.py-v" title="Permalink to this definition">¶</a></dt> +<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></dl> <dl class="cmdoption"> -<dt id="cmdoption-showfsevents.py--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-showfsevents.py--nocolor" title="Permalink to this definition">¶</a></dt> +<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></dl> <dl class="cmdoption"> -<dt id="cmdoption-showfsevents.py--hooklib"> -<tt class="descname">--hooklib</tt><tt class="descclassname"></tt><a class="headerlink" href="#cmdoption-showfsevents.py--hooklib" title="Permalink to this definition">¶</a></dt> +<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></dl> <dl class="cmdoption"> -<dt id="cmdoption-showfsevents.py--fusefs"> -<tt class="descname">--fusefs</tt><tt class="descclassname"></tt><a class="headerlink" href="#cmdoption-showfsevents.py--fusefs" title="Permalink to this definition">¶</a></dt> +<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></dl> @@ -167,19 +173,19 @@ while launching, so this will take more time than usual.</td></tr> <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>showfsevents.py emerge xchat</p> +<p>autodep emerge 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>showfsevents.py emerge –block x11-misc/util-macros emerge xchat</p> +<p>autodep emerge –block x11-misc/util-macros emerge 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>showfsevents.py –files emerge xchat</p> +<p>autodep –files emerge 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> -<p>showfsevents.py –fusefs –files xchat</p> +<p>autodep –fusefs –files xchat</p> </div> </div> </div> @@ -244,7 +250,7 @@ while launching, so this will take more time than usual.</td></tr> </div> <div class="footer"> © Copyright 2011, Alexander Bersenev. - Last updated on Jul 25, 2011. + Last updated on Aug 03, 2011. Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.0.7. </div> </body> diff --git a/docs/build/html/objects.inv b/docs/build/html/objects.inv index a2f3148..20cf75f 100644 --- a/docs/build/html/objects.inv +++ b/docs/build/html/objects.inv @@ -2,5 +2,10 @@ # Project: Autodep # Version: 0.1 # The remainder of this file is compressed using zlib. -xڭTN0`uDL HH<Ī"SۓIP˘}wPz<.jȞX6Z EP'pnx$tG Eij +RFz4 |*AY/`ݓnC ^T5~-[x1(f';B' ͘LJ~bGŭFT4o'A@ 6q+tvt?.(&z16nm% 1 ]zy $ -12ЀdVjc$͞/`W)y5Øz#'te
\ No newline at end of file +xڭTOo SlWN;,Y@ J!<l淟t[;DJkk +<ZmɁ`0eR[{&tGih\SaM
Ky +"2mlFhBt~ݖG +?Htb$(L^NJ^b\ R M}!ܩDH;.ƺ4ay;`{(Lv{YQ +N +U
htPrh{qXPT^cKaL;Tl&% ڰg\k6`2*yOf;mnHqI +CyP`V&r- 꿗=0OlWx]A$4G̼+ V7C
\ No newline at end of file diff --git a/docs/build/html/py-modindex.html b/docs/build/html/py-modindex.html index a2e022c..42ac89a 100644 --- a/docs/build/html/py-modindex.html +++ b/docs/build/html/py-modindex.html @@ -132,7 +132,7 @@ </div> <div class="footer"> © Copyright 2011, Alexander Bersenev. - Last updated on Jul 25, 2011. + Last updated on Aug 03, 2011. Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.0.7. </div> </body> diff --git a/docs/build/html/search.html b/docs/build/html/search.html index dfff3e8..2da6a37 100644 --- a/docs/build/html/search.html +++ b/docs/build/html/search.html @@ -96,7 +96,7 @@ </div> <div class="footer"> © Copyright 2011, Alexander Bersenev. - Last updated on Jul 25, 2011. + Last updated on Aug 03, 2011. Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.0.7. </div> </body> diff --git a/docs/build/html/searchindex.js b/docs/build/html/searchindex.js index 9d5cacb..8c5fbdb 100644 --- a/docs/build/html/searchindex.js +++ b/docs/build/html/searchindex.js @@ -1 +1 @@ -Search.setIndex({objects:{"":{"-f":[4,0,1],"-C":[2,0,1],"-b":[4,0,1],"--hooklib":[4,0,1],"--fusefs":[4,0,1],"-v":[4,0,1],"--nocolor":[4,0,1],"--help":[4,0,1]},"package_utils.portage_misc_functions":{portage_api:[1,4,1]},"package_utils.portage_log_parser":{get_list_of_merged_packages:[1,2,1]},logfs:{fstracer:[1,1,1]},"package_utils.portage_utils":{getfilesbypackage:[1,2,1],getpackagesbyfiles:[1,2,1]},"logfs.fstracer":{getfsevents:[1,2,1]},"package_utils.portage_misc_functions.portage_api":{get_deps:[1,3,1],get_system_packages_list:[1,3,1],parse_emerge_args:[1,3,1]},package_utils:{portage_misc_functions:[1,1,1],portage_utils:[1,1,1],portage_log_parser:[1,1,1]}},terms:{load:[2,3,4],all:[1,2,3,4],code:3,help:[2,4],chain:1,show:[2,4],over:3,rootf:3,mnt:3,time:[1,2,3,4],pkg:1,rdepend:1,environ:3,find:1,dynam:[2,3,4],paramet:1,xml:3,prog_nam:1,onli:[2,4],cut:3,depend:[1,2,3,4],execut:3,field:3,"true":1,activ:2,dep_typ:1,should:1,cowsai:2,ebuild:2,program:[1,2,3,4],under:2,els:3,parse_emerge_arg:1,main:3,analys:3,logic:1,take:[1,2,3,4],filterproc:1,sock_seqpacket:3,sourc:1,"return":[1,3],string:1,thei:1,get:[1,2,4],fals:1,big:[2,4],between:1,util:[2,3,4],lib32:3,got:3,increas:3,"0x19e7b18":1,recurs:1,hooker:3,requir:[2,4],introduct:[0,2],tri:3,builder:[2,4],name:[1,3],success:1,level:1,approach:[0,1,2,3,4],package_util:[0,1],list:[1,3],nocolor:[2,4],api:[0,1],each:1,userspac:3,found:[1,2,3,4],get_list_of_merged_packag:1,emerg:[1,2,4],kernel:[2,4],domain:3,set:1,slower:[2,4],often:3,protect:3,linux:3,idea:3,packet:3,shm:3,logf:[0,1],second:1,cost:3,sec:3,result:3,pass:1,fail:1,further:3,successfulli:1,todo:2,event:[0,1,2,3,4],librari:[2,3,4],variabl:3,index:2,statu:[0,2],servic:1,network:3,compar:3,bind:3,normal:[2,4],unknown:[1,2,3,4],access:[0,1,2,3,4],autodep:[0,2],exit:[2,4],directori:3,overlai:2,"new":3,lib64:3,content:0,proc:3,reciev:3,after:3,run:[0,2,3],depth:1,kei:1,contain:1,slow:[2,4],believ:3,starttim:1,x11:[2,4],releas:2,argument:1,portage_api:1,sinc:[1,3],bash:2,xchat:[2,4],both:1,fstracer:[0,1],socket:3,thread:3,registar:3,libc:3,current:1,page:2,portage_log_pars:1,registrar:3,includ:3,getfsev:1,action:1,mani:[2,4],chang:3,lsof:2,licens:2,block:[1,2,3,4],first:1,origin:3,via:3,dictionari:1,packagenam:1,color:[2,4],overview:[0,2],modul:[1,2,3],misc:[2,4],system:[1,2,3,4],ld_preload:[2,3,4],ask:3,unix:3,defaultfilt:1,send:3,heurist:3,instal:[0,2,3],desktop:3,open:[1,3],merg:1,gpl:2,get_dep:1,getpackagesbyfil:1,fusef:[0,1,2,3,4],from:[1,2,3,4],log:[1,2,4],wai:3,errno:3,showfsev:[2,4],doesn:1,two:1,messag:[2,3,4],implicit:[1,3],verbos:[2,4],start:1,much:3,call:[1,3],usr:3,handl:1,"var":3,overhead:[2,4],stage:[1,2,3,4],type:[1,3],low:1,analysi:[0,2,3,4],allow:[1,2,3,4],linker:3,option:[1,2,4],unexpect:3,getfilesbypackag:1,tupl:1,tool:[2,4],copi:3,tmp:3,search:[1,2],direct:[2,4],postrm:3,modifi:3,endtim:1,portag:[1,3],atom:1,arg:1,than:[2,4],must:[2,4],also:[1,2,3,4],scheme:3,portage_util:1,err:3,gnu:2,"default":[1,2,4],mount:3,launch:[1,2,3,4],intern:[0,3],dev:3,charact:3,defin:[2,4],"while":[2,3,4],bridg:1,can:[1,2,3,4],behavior:3,error:3,about:3,more:[2,4],root:[2,4],delimit:3,connect:3,pre:[2,4],"function":[1,3],parser:1,creat:3,portage_misc_funct:1,dure:[2,4],registr:3,filenam:1,non:[2,4],indic:[0,2],high:1,packag:[1,2,3,4],befor:3,inform:[1,3],file:[0,1,2,3,4],tabl:[0,2],synopsi:4,"import":[2,4],work:[0,1,3],check:3,unus:3,filter:1,profil:3,chroot:3,end:[1,3],get_system_packages_list:1,output:[2,4],perform:[2,3,4],anoth:3,make:2,belong:1,when:[2,3,4],detail:3,same:3,accuraci:3,note:[2,3,4],how:[0,3],other:3,read:[1,2,3,4],build:[2,3,4],which:1,auto:[2,4],answer:3,instead:[1,3],document:0,simpl:3,prepar:3,enabl:[2,4],fork:3,map:3,loggabl:3,extern:3,thi:[1,2,3,4],see:3,alwai:1,recomend:[2,4],who:[2,4],what:[2,4],most:[2,4],buildtim:[2,4],fuse:[2,3,4],user:[2,4],share:3,phase:3,develop:2,"class":1,man:3,don:[2,4],write:[1,3],syscal:[2,4],ani:[1,2,3,4],macro:[2,4],reliabl:[2,4],acloc:3,descript:4,rule:3,element:1,hooklib:[0,1,2,3,4],deni:3,exampl:[0,2,4],command:[2,4],runtim:[2,3,4],potenti:[2,4],filesystem:3,format:3,pars:1,stagenam:3,futher:[0,3],usual:[2,3,4]},objtypes:{"0":"std:option","1":"py:module","2":"py:function","3":"py:method","4":"py:class"},titles:["Autodep’s documentation","API","Introduction","Internals","USER COMMANDS"],objnames:{"0":"option","1":"Python module","2":"Python function","3":"Python method","4":"Python class"},filenames:["index","api","intro","architecture","man"]})
\ No newline at end of file +Search.setIndex({objects:{"":{"-v":[4,0,1],"-f":[4,0,1],"-C":[2,0,1],"-b":[4,0,1],"--hooklib":[4,0,1],"--fusefs":[4,0,1],"--blockpkgs":[4,0,1],"--nocolor":[4,0,1],"--help":[4,0,1]},"package_utils.portage_misc_functions":{portage_api:[1,4,1]},"package_utils.portage_log_parser":{get_list_of_merged_packages:[1,3,1]},logfs:{fstracer:[1,1,1]},"package_utils.portage_utils":{getfilesbypackage:[1,3,1],getpackagesbyfiles:[1,3,1],get_all_packages_files:[1,3,1]},"logfs.fstracer":{getfsevents:[1,3,1]},"package_utils.portage_misc_functions.portage_api":{get_dep:[1,2,1],get_system_packages_list:[1,2,1],get_best_visible_pkg:[1,2,1],get_deps:[1,2,1],get_merge_list:[1,2,1],parse_emerge_args:[1,2,1]},package_utils:{portage_misc_functions:[1,1,1],portage_utils:[1,1,1],portage_log_parser:[1,1,1]}},terms:{oper:1,all:[1,2,3,4],code:3,help:[2,4],chain:1,show:[2,4],futher:[0,3],over:3,rootf:3,mnt:3,veri:1,pkg:1,accuraci:3,find:1,dynam:[2,3,4],paramet:1,xml:3,prog_nam:1,onli:[2,4],cut:3,depend:[1,2,3,4],execut:3,field:3,activ:2,dep_typ:1,should:1,cowsai:2,ebuild:2,program:[1,2,3,4],under:2,els:3,parse_emerge_arg:1,main:3,analys:3,getfsev:1,build:[2,3,4],filterproc:1,deni:[2,3,4],sock_seqpacket:3,sourc:1,"return":[1,3],string:1,variou:1,get:[1,2,4],fals:1,big:[2,4],overlai:2,util:[2,3,4],than:[2,4],candid:1,command:[2,4],"new":3,increas:3,potenti:[2,4],"0x19e7b18":[],recurs:1,lib64:3,requir:[2,4],introduct:[0,2],tri:3,document:0,name:[1,3],success:1,level:1,proc:3,gnu:2,list:[1,3],nocolor:[2,4],exampl:[0,2,4],phase:3,mode:[2,4],man:3,each:1,userspac:3,found:[1,2,3,4],shm:3,kernel:[2,4],domain:3,set:1,slower:[2,4],often:3,map:3,heurist:3,idea:3,packet:3,logf:[0,1],second:1,cost:3,sec:3,result:3,pass:1,fail:1,further:3,successfulli:1,todo:2,event:[0,1,2,3,4],librari:[2,3,4],variabl:3,index:2,statu:[0,2],servic:1,network:3,compar:3,bind:3,develop:2,unknown:[1,2,3,4],best:1,access:[0,1,2,3,4],version:1,exit:[2,4],between:1,got:3,hooker:3,content:0,approach:[0,1,2,3,4],unus:3,gpl:2,who:[2,4],run:[0,2,3],kei:1,arg:1,contain:1,get_all_packages_fil:1,slow:[2,4],believ:3,starttim:1,x11:[2,4],releas:2,hooklib:[0,1,2,3,4],portage_api:1,sinc:[1,3],bash:2,get_best_visible_pkg:1,both:1,search:[1,2],socket:3,thread:3,registar:3,libc:3,current:1,page:2,portage_log_pars:1,registrar:3,reliabl:[2,4],logic:1,action:1,mani:[2,4],chang:3,share:3,lsof:2,other:3,block:[1,2,3,4],first:1,load:[2,3,4],via:3,dictionari:1,packagenam:1,color:[2,4],overview:[0,2],modul:[1,2,3],defaultfilt:1,misc:[2,4],get_merge_list:1,usual:[2,3,4],two:1,ld_preload:[2,3,4],ask:3,unix:3,api:[0,1],non:[2,4],send:3,linux:3,instal:[0,1,2,3],desktop:3,open:[1,3],stage:[1,2,3,4],merg:1,reciev:3,get_dep:1,most:[2,4],from:[1,2,3,4],log:[1,2,4],fusef:[0,1,2,3,4],memori:1,profil:3,modifi:3,licens:2,doesn:1,system:[1,2,3,4],messag:[2,3,4],implicit:[1,3],verbos:[2,4],start:1,much:3,call:[1,3],includ:3,handl:1,autodep:[0,2,4],overhead:[2,4],xchat:[2,4],type:[1,3],strict:[2,4],usr:3,fork:3,parser:1,errno:3,unexpect:3,fstracer:[0,1],tupl:1,tool:[2,4],copi:3,protect:3,direct:[2,4],"var":3,postrm:3,pars:1,low:1,portag:[1,3],atom:1,filesystem:3,"true":1,getfilesbypackag:1,origin:3,must:[1,2,4],also:[1,2,3,4],scheme:3,portage_util:1,err:3,package_util:[0,1],"default":[1,2,4],mount:3,launch:[1,2,3,4],intern:[0,1,3],dev:3,charact:3,showfsev:2,defin:[2,4],lib32:3,bridg:1,can:[1,2,3,4],behavior:3,error:3,about:3,more:[2,4],root:[2,4],delimit:3,loggabl:3,connect:3,pre:[2,4],"function":[1,3],empti:1,creat:3,look:1,descript:4,dure:[2,4],linker:3,filenam:1,argument:1,indic:[0,2],get_list_of_merged_packag:1,high:1,packag:[1,2,3,4],inform:[1,3],unreli:1,file:[0,1,2,3,4],tabl:[0,2],synopsi:4,"import":[2,4],work:[0,1,3],check:3,option:[1,2,4],filter:1,write:[1,3],chroot:3,emergearg:1,thei:1,output:[2,4],perform:[2,3,4],anoth:3,make:2,belong:1,when:[2,3,4],detail:3,same:3,"while":[2,3,4],note:[2,3,4],how:[0,3],wai:3,read:[1,2,3,4],take:[1,2,3,4],which:1,auto:[2,4],answer:3,instead:[1,3],tmp:3,simpl:3,prepar:3,enabl:[2,4],analysi:[0,2,3,4],getpackagesbyfil:1,get_system_packages_list:1,extern:3,thi:[1,2,3,4],see:3,normal:[2,4],recomend:[2,4],after:3,what:[2,4],befor:3,buildtim:[2,4],fuse:[2,3,4],user:[2,4],blockpkg:[2,4],mai:1,end:[1,3],"class":1,"0x1dbdb90":1,don:[2,4],ani:[1,2,3,4],syscal:[2,4],directori:3,macro:[2,4],builder:[2,4],acloc:3,portage_misc_funct:1,rule:3,element:1,alwai:1,registr:3,depth:1,emerg:[1,2,4],environ:3,runtim:[2,3,4],allow:[1,2,3,4],time:[1,2,3,4],format:3,endtim:1,stagenam:3,hungri:1,rdepend:1},objtypes:{"0":"std:option","1":"py:module","2":"py:method","3":"py:function","4":"py:class"},titles:["Autodep’s documentation","API","Introduction","Internals","USER COMMANDS"],objnames:{"0":"option","1":"Python module","2":"Python method","3":"Python function","4":"Python class"},filenames:["index","api","intro","architecture","man"]})
\ No newline at end of file diff --git a/docs/build/man/autodep.1 b/docs/build/man/autodep.1 new file mode 100644 index 0000000..da9aa10 --- /dev/null +++ b/docs/build/man/autodep.1 @@ -0,0 +1,186 @@ +.TH "AUTODEP" "1" "August 03, 2011" "0.1" "Autodep" +.SH NAME +autodep \- auto dependency builder for Gentoo +. +.nr rst2man-indent-level 0 +. +.de1 rstReportMargin +\\$1 \\n[an-margin] +level \\n[rst2man-indent-level] +level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] +- +\\n[rst2man-indent0] +\\n[rst2man-indent1] +\\n[rst2man-indent2] +.. +.de1 INDENT +.\" .rstReportMargin pre: +. RS \\$1 +. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin] +. nr rst2man-indent-level +1 +.\" .rstReportMargin post: +.. +.de UNINDENT +. RE +.\" indent \\n[an-margin] +.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]] +.nr rst2man-indent-level -1 +.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] +.in \\n[rst2man-indent\\n[rst2man-indent-level]]u +.. +.\" Man page generated from reStructeredText. +. +.SH SYNOPSIS +.sp +\fBautodep\fP [options] <command> +.SH DESCRIPTION +.sp +Auto dependency builder is a tool for analysis files accessed during +building a package. It also can be used for runtime dependencies analysis. +.sp +The tool can block an access to files of defined packages. +.SH OPTIONS +.INDENT 0.0 +.TP +.B \-\-help, \-h +.sp +show this help message and exit +.UNINDENT +.INDENT 0.0 +.TP +.B \-b, \-\-block +.sp +strict mode: deny all access to non\-dependency packages +.UNINDENT +.INDENT 0.0 +.TP +.B \-\-blockpkgs=PACKAGES +.sp +block an access to files from this packages +.UNINDENT +.INDENT 0.0 +.TP +.B \-f, \-\-files +.sp +show accessed files and not founded files +.UNINDENT +.INDENT 0.0 +.TP +.B \-v, \-\-verbose +.sp +show non\-important packages, show unknown package and unknown stage +.UNINDENT +.INDENT 0.0 +.TP +.B \-\-nocolor, \-C +.sp +don\(aqt output color +.UNINDENT +.INDENT 0.0 +.TP +.B \-\-hooklib +. +use ld_preload logging approach(default) +.UNINDENT +.INDENT 0.0 +.TP +.B \-\-fusefs +. +use fuse logging approach(slow, but reliable) +.UNINDENT +.SH HOOKLIB VS FUSEFS +.TS +center; +|l|l|l|. +_ +T{ +T} T{ +Hooklib +T} T{ +Fusefs +T} +_ +T{ +Who can use this approach? +T} T{ +\fBAny user\fP +T} T{ +Only root +T} +_ +T{ +Is approach allows blocking an access to files? +T} T{ +\fBYES\fP +T} T{ +\fBYES\fP +T} +_ +T{ +Is overhead in performance big? +T} T{ +\fBNO\fP +T} T{ +YES [1] +T} +_ +T{ +What events are logged? +T} T{ +Most [2] +T} T{ +\fBALL\fP +T} +_ +T{ +When is it recomended to use an approach? +T} T{ +For analysis +of +\fIbuildtime\fP +dependencies +T} T{ +For analysis +of \fIruntime\fP +dependencies +T} +_ +T{ +Is any pre\-requirements for using an approach? +T} T{ +\fBNO\fP +T} T{ +FUSE must be +enabled in +kernel +T} +_ +.TE +Notes +.IP [1] 5 +. +Fuse file system is slower than normal one. Program reads many files +while launching, so this will take more time than usual. +.IP [2] 5 +. +Loading of dynamic libraries and direct syscalls will not be logged. +.SH EXAMPLES +.SS Get the potential dependencies of a xchat package: +.sp +autodep emerge xchat +.SS Get the potential dependencies of a xchat package, blocking x11\-misc/util\-macros package: +.sp +autodep emerge \-\-block x11\-misc/util\-macros emerge xchat +.SS Get the potential dependencies of a xchat package, and show files accessed: +.sp +autodep \-\-files emerge xchat +.SS Get the runtime dependencies of a xchat and show files accessed: +.sp +autodep \-\-fusefs \-\-files xchat +.SH AUTHOR +Alexander Bersenev +.SH COPYRIGHT +2011, Alexander Bersenev +.\" Generated by docutils manpage writer. +.\" +. |