/usr/share/doc/python-iptables-doc/html/usage.html is in python-iptables-doc 0.12.0-1build1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 | <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>Usage — python-iptables 0.4.0-dev documentation</title>
<link rel="stylesheet" href="_static/classic.css" type="text/css" />
<link rel="stylesheet" href="_static/pygments.css" type="text/css" />
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT: './',
VERSION: '0.4.0-dev',
COLLAPSE_INDEX: false,
FILE_SUFFIX: '.html',
HAS_SOURCE: true,
SOURCELINK_SUFFIX: '.txt'
};
</script>
<script type="text/javascript" src="_static/jquery.js"></script>
<script type="text/javascript" src="_static/underscore.js"></script>
<script type="text/javascript" src="_static/doctools.js"></script>
<link rel="index" title="Index" href="genindex.html" />
<link rel="search" title="Search" href="search.html" />
<link rel="next" title="Examples" href="examples.html" />
<link rel="prev" title="Introduction" href="intro.html" />
</head>
<body role="document">
<div class="related" role="navigation" aria-label="related navigation">
<h3>Navigation</h3>
<ul>
<li class="right" style="margin-right: 10px">
<a href="genindex.html" title="General Index"
accesskey="I">index</a></li>
<li class="right" >
<a href="examples.html" title="Examples"
accesskey="N">next</a> |</li>
<li class="right" >
<a href="intro.html" title="Introduction"
accesskey="P">previous</a> |</li>
<li class="nav-item nav-item-0"><a href="index.html">python-iptables 0.4.0-dev documentation</a> »</li>
</ul>
</div>
<div class="document">
<div class="documentwrapper">
<div class="bodywrapper">
<div class="body" role="main">
<div class="section" id="usage">
<h1>Usage<a class="headerlink" href="#usage" title="Permalink to this headline">¶</a></h1>
<p>The python API in <code class="docutils literal"><span class="pre">python-iptables</span></code> tries to mimic the logic of iptables.
You have</p>
<blockquote>
<div><ul class="simple">
<li><strong>Tables</strong>, <strong>Table.FILTER</strong>, <strong>Table.NAT</strong>, <strong>Table.MANGLE</strong> and
<strong>Table.RAW</strong> for IPv4; <strong>Table6.FILTER</strong>, <strong>Table6.SECURITY</strong>,
<strong>Table6.MANGLE</strong> and <strong>Table6.RAW</strong> for IPv6. They can be used to
filter packets, do network address translation or modify packets in
various ways.</li>
<li><strong>Chains</strong> inside tables. Each table has a few built-in chains, but you
can also create your own chains and jump into them from other chains.
When you create your chains you should also specify which table it will
be used in. <strong>Chains</strong> have <strong>Policies</strong>, which tell what to do when the
end of a chain is reached.</li>
<li>Each chain has zero or more <strong>rules</strong>. A rule specifies what kind of
packets to match (matches, each rule can have zero, one or more matches)
and what to do with them (target, each rule has one of them). Iptables
implements a plethora of match and target extensions. For IPv4, the
class implementing this is called <em>Rule</em>, for IPv6 it is called <em>Rule6</em>.</li>
<li><strong>Matches</strong>, specifying when a rule needs to be applied to a packet. To
create a match object you also has to specify the rule to which it
belongs.</li>
<li><strong>Targets</strong>, specifying what to do when a rule is applied to a packet.
To create a target object you also has to specify the rule to which it
belongs.</li>
</ul>
</div></blockquote>
<p>The python API is quite high-level and hides the low-level details from the
user. Using only the classes <em>Table</em>, <em>Chain</em>, <em>Rule</em>, <em>Match</em> and <em>Target</em>
virtually anything can be achieved that you can do with iptables from the
command line.</p>
<div class="section" id="table">
<h2>Table<a class="headerlink" href="#table" title="Permalink to this headline">¶</a></h2>
</div>
<div class="section" id="table6">
<h2>Table6<a class="headerlink" href="#table6" title="Permalink to this headline">¶</a></h2>
</div>
<div class="section" id="chain">
<h2>Chain<a class="headerlink" href="#chain" title="Permalink to this headline">¶</a></h2>
</div>
<div class="section" id="policy">
<h2>Policy<a class="headerlink" href="#policy" title="Permalink to this headline">¶</a></h2>
</div>
<div class="section" id="match">
<h2>Match<a class="headerlink" href="#match" title="Permalink to this headline">¶</a></h2>
</div>
<div class="section" id="target">
<h2>Target<a class="headerlink" href="#target" title="Permalink to this headline">¶</a></h2>
</div>
<div class="section" id="rule">
<h2>Rule<a class="headerlink" href="#rule" title="Permalink to this headline">¶</a></h2>
</div>
<div class="section" id="rule6">
<h2>Rule6<a class="headerlink" href="#rule6" title="Permalink to this headline">¶</a></h2>
</div>
<div class="section" id="iptcerror">
<h2>IPTCError<a class="headerlink" href="#iptcerror" title="Permalink to this headline">¶</a></h2>
</div>
</div>
</div>
</div>
</div>
<div class="sphinxsidebar" role="navigation" aria-label="main navigation">
<div class="sphinxsidebarwrapper">
<h3><a href="index.html">Table Of Contents</a></h3>
<ul>
<li><a class="reference internal" href="#">Usage</a><ul>
<li><a class="reference internal" href="#table">Table</a></li>
<li><a class="reference internal" href="#table6">Table6</a></li>
<li><a class="reference internal" href="#chain">Chain</a></li>
<li><a class="reference internal" href="#policy">Policy</a></li>
<li><a class="reference internal" href="#match">Match</a></li>
<li><a class="reference internal" href="#target">Target</a></li>
<li><a class="reference internal" href="#rule">Rule</a></li>
<li><a class="reference internal" href="#rule6">Rule6</a></li>
<li><a class="reference internal" href="#iptcerror">IPTCError</a></li>
</ul>
</li>
</ul>
<h4>Previous topic</h4>
<p class="topless"><a href="intro.html"
title="previous chapter">Introduction</a></p>
<h4>Next topic</h4>
<p class="topless"><a href="examples.html"
title="next chapter">Examples</a></p>
<div role="note" aria-label="source link">
<h3>This Page</h3>
<ul class="this-page-menu">
<li><a href="_sources/usage.rst.txt"
rel="nofollow">Show Source</a></li>
</ul>
</div>
<div id="searchbox" style="display: none" role="search">
<h3>Quick search</h3>
<form class="search" action="search.html" method="get">
<div><input type="text" name="q" /></div>
<div><input type="submit" value="Go" /></div>
<input type="hidden" name="check_keywords" value="yes" />
<input type="hidden" name="area" value="default" />
</form>
</div>
<script type="text/javascript">$('#searchbox').show(0);</script>
</div>
</div>
<div class="clearer"></div>
</div>
<div class="related" role="navigation" aria-label="related navigation">
<h3>Navigation</h3>
<ul>
<li class="right" style="margin-right: 10px">
<a href="genindex.html" title="General Index"
>index</a></li>
<li class="right" >
<a href="examples.html" title="Examples"
>next</a> |</li>
<li class="right" >
<a href="intro.html" title="Introduction"
>previous</a> |</li>
<li class="nav-item nav-item-0"><a href="index.html">python-iptables 0.4.0-dev documentation</a> »</li>
</ul>
</div>
<div class="footer" role="contentinfo">
© Copyright 2010-2017, Vilmos Nebehaj.
Created using <a href="http://sphinx-doc.org/">Sphinx</a> 1.5.6.
</div>
</body>
</html>
|