← Back to branch summary

~ubuntu-branches/ubuntu/hardy/openswan/hardy-updates

« back to all changes in this revision

Viewing changes to programs/tncfg/tncfg.5.xml

  • Committer: Bazaar Package Importer
  • Author(s): Rene Mayrhofer
  • Date: 2005-01-27 16:10:11 UTC
  • mfrom: (1.1.1 upstream)
  • Revision ID: james.westby@ubuntu.com-20050127161011-idgybmyz3vwhpfiq
Tags: 2.3.0-2
http://bugs.debian.org/292458
http://bugs.debian.org/291143
Urgency HIGH due to security issue and problems with build-deps in sarge.
* Fix the security issue. Please see
  http://www.idefense.com/application/poi/display?id=190&
      type=vulnerabilities&flashstatus=false
  for more details. Thanks to Martin Schulze for informing me about
  this issue.
  Closes: #292458: Openswan XAUTH/PAM Buffer Overflow Vulnerability
* Added a Build-Dependency to lynx.
  Closes: #291143: openswan: FTBFS: Missing build dependency.

Show diffs side-by-side

added added

removed removed

Lines of Context:
programs/tncfg/tncfg.5.xml
 
1
<?xml version="1.0" encoding="ISO-8859-1"?>
 
2
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
 
3
                   "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
 
4
<!-- lifted from troff+man by doclifter -->
 
5
<refentry>
 
6
<refmeta>
 
7
<refentrytitle>IPSEC_TNCFG</refentrytitle>
 
8
<manvolnum>5</manvolnum>
 
9
<refmiscinfo class='date'>27 Jun 2000</refmiscinfo>
 
10
</refmeta>
 
11
<refnamediv id='name'>
 
12
<refname>ipsec_tncfg</refname>
 
13
<refpurpose>lists IPSEC virtual interfaces attached to real interfaces</refpurpose>
 
14
</refnamediv>
 
15
<!-- body begins here -->
 
16
<refsynopsisdiv id='synopsis'>
 
17
<cmdsynopsis>
 
18
  <command>ipsec</command>    
 
19
    <arg choice='plain'><replaceable>tncfg</replaceable></arg>
 
20
    <sbr/>
 
21
    <arg choice='plain'><replaceable>cat/proc/net/ipsec_tncfg</replaceable></arg>
 
22
</cmdsynopsis>
 
23
</refsynopsisdiv>
 
24
 
 
25
 
 
26
<refsect1 id='description'><title>DESCRIPTION</title>
 
27
<para><filename>/proc/net/ipsec_tncfg</filename>
 
28
is a read-only file which lists which IPSEC virtual interfaces are
 
29
attached to which real interfaces, through which packets will be
 
30
forwarded once processed by IPSEC.</para>
 
31
 
 
32
<para>Each line lists one ipsec I/F.
 
33
A table entry consists of:</para>
 
34
<variablelist remap='IP'>
 
35
  <varlistentry>
 
36
  <term>+</term>
 
37
  <listitem>
 
38
<para>an ipsec virtual I/F name</para>
 
39
  </listitem>
 
40
  </varlistentry>
 
41
  <varlistentry>
 
42
  <term>+</term>
 
43
  <listitem>
 
44
<para>a visual and machine parsable separator '-&gt;', separating the virtual I/F
 
45
and the physical I/F,</para>
 
46
  </listitem>
 
47
  </varlistentry>
 
48
  <varlistentry>
 
49
  <term>+</term>
 
50
  <listitem>
 
51
<para>a physical I/F name, to which the ipsec virtual I/F is attached or NULL
 
52
if it is not attached,</para>
 
53
  </listitem>
 
54
  </varlistentry>
 
55
  <varlistentry>
 
56
  <term>+</term>
 
57
  <listitem>
 
58
<para>the keyword
 
59
<emphasis remap='B'>mtu=</emphasis>,</para>
 
60
  </listitem>
 
61
  </varlistentry>
 
62
  <varlistentry>
 
63
  <term>+</term>
 
64
  <listitem>
 
65
<para>the MTU of the ipsec virtual I/F,</para>
 
66
  </listitem>
 
67
  </varlistentry>
 
68
  <varlistentry>
 
69
  <term>+</term>
 
70
  <listitem>
 
71
<para>the automatically adjusted effective MTU for PMTU discovery, in brackets,</para>
 
72
  </listitem>
 
73
  </varlistentry>
 
74
  <varlistentry>
 
75
  <term>+</term>
 
76
  <listitem>
 
77
<para>a visual and machine parsable separator '-&gt;', separating the virtual I/F
 
78
MTU and the physical I/F MTU,</para>
 
79
  </listitem>
 
80
  </varlistentry>
 
81
  <varlistentry>
 
82
  <term>+</term>
 
83
  <listitem>
 
84
<para>the MTU of the attached physical I/F.</para>
 
85
<!-- bogus BR elided -->
 
86
  </listitem>
 
87
  </varlistentry>
 
88
</variablelist>
 
89
</refsect1>
 
90
 
 
91
<refsect1 id='examples'><title>EXAMPLES</title>
 
92
<variablelist remap='TP'>
 
93
  <varlistentry>
 
94
  <term><userinput>ipsec2 -&gt; eth3 mtu=16260(1443) -&gt; 1500</userinput></term>
 
95
  <listitem>
 
96
<para></para> <!-- FIXME: blank list item -->
 
97
  </listitem>
 
98
  </varlistentry>
 
99
</variablelist>
 
100
 
 
101
<para>shows that virtual device
 
102
<emphasis remap='B'>ipsec2</emphasis>
 
103
with an MTU of
 
104
<literal>16260</literal>
 
105
is connected to physical device
 
106
<emphasis remap='B'>eth3</emphasis>
 
107
with an MTU of
 
108
<literal>1500</literal>
 
109
and that the effective MTU as a result of PMTU discovery has been
 
110
automatically set to
 
111
<literal>1443.</literal></para>
 
112
<variablelist remap='TP'>
 
113
  <varlistentry>
 
114
  <term><userinput>ipsec0 -&gt; wvlan0 mtu=1400(16260) -&gt; 1500</userinput></term>
 
115
  <listitem>
 
116
<para></para> <!-- FIXME: blank list item -->
 
117
  </listitem>
 
118
  </varlistentry>
 
119
</variablelist>
 
120
 
 
121
<para>shows that virtual device
 
122
<emphasis remap='B'>ipsec0</emphasis>
 
123
with an MTU of
 
124
<literal>1400</literal>
 
125
is connected to physical device
 
126
<emphasis remap='B'>wvlan0</emphasis>
 
127
with an MTU of
 
128
<literal>1500</literal>
 
129
and no PMTU packets have gotten far enough to bump down the effective MTU
 
130
from its default of 16260.</para>
 
131
<variablelist remap='TP'>
 
132
  <varlistentry>
 
133
  <term><userinput>ipsec3 -&gt; NULL mtu=0(0) -&gt; 0</userinput></term>
 
134
  <listitem>
 
135
<para></para> <!-- FIXME: blank list item -->
 
136
  </listitem>
 
137
  </varlistentry>
 
138
</variablelist>
 
139
 
 
140
<para>shows that virtual device
 
141
<emphasis remap='B'>ipsec3</emphasis>
 
142
is not connected to any physical device.</para>
 
143
 
 
144
</refsect1>
 
145
 
 
146
<refsect1 id='files'><title>FILES</title>
 
147
<para>/proc/net/ipsec_tncfg, /usr/local/bin/ipsec</para>
 
148
</refsect1>
 
149
 
 
150
<refsect1 id='see_also'><title>SEE ALSO</title>
 
151
<para>ipsec(8), ipsec_manual(8), ipsec_eroute(5), ipsec_spi(5),
 
152
ipsec_spigrp(5), ipsec_klipsdebug(5), ipsec_tncfg(8), ipsec_version(5),
 
153
ipsec_pf_key(5)</para>
 
154
</refsect1>
 
155
 
 
156
<refsect1 id='history'><title>HISTORY</title>
 
157
<para>Written for the Linux FreeS/WAN project
 
158
&lt;<ulink url='http://www.freeswan.org/'>http://www.freeswan.org/</ulink>&gt;
 
159
by Richard Guy Briggs.</para>
 
160
 
 
161
<!--  $Log: tncfg.5.xml,v $
 
162
<!--  Revision 1.1  2004/05/26 17:51:24  ken
 
163
<!--  Import XML version
 
164
<!-- -->
 
165
<!--  Revision 1.5  2002/04/24 07:35:41  mcr -->
 
166
<!--  Moved from ./klips/utils/tncfg.5,v -->
 
167
 
 
168
<!--  Revision 1.4  2001/05/29 05:15:53  rgb -->
 
169
<!--  Added PMTU to output format. -->
 
170
 
 
171
<!--  Revision 1.3  2000/06/30 18:21:55  rgb -->
 
172
<!--  Update SEE ALSO sections to include <citerefentry><refentrytitle>ipsec_version</refentrytitle><manvolnum>5</manvolnum></citerefentry> and <citerefentry><refentrytitle>ipsec_pf_key</refentrytitle><manvolnum>5</manvolnum></citerefentry> -->
 
173
<!--  and correct FILES sections to no longer refer to /dev/ipsec which has -->
 
174
<!--  been removed since PF_KEY does not use it. -->
 
175
 
 
176
<!--  Revision 1.2  2000/06/28 12:44:12  henry -->
 
177
<!--  format touchup -->
 
178
 
 
179
<!--  Revision 1.1  2000/06/28 05:43:01  rgb -->
 
180
<!--  Added manpages for all 5 klips utils. -->
 
181
 
 
182
 
 
183
</refsect1>
 
184
</refentry>
 
185