freeswan/doc/manpage.d/ipsec_eroute.5.html

   1 Content-type: text/html
   2
   3 <HTML><HEAD><TITLE>Manpage of IPSEC_EROUTE</TITLE>
   4 </HEAD><BODY>
   5 <H1>IPSEC_EROUTE</H1>
   6 Section: File Formats (5)<BR>Updated: 26 Jun 2000<BR><A HREF="#index">Index</A>
   7 <A HREF="http://localhost/cgi-bin/man/man2html">Return to Main Contents</A><HR>
   8
   9
  10
  11
  12 <A NAME="lbAB">&nbsp;</A>
  13 <H2>NAME</H2>
  14
  15 ipsec_eroute - list of existing eroutes
  16 <A NAME="lbAC">&nbsp;</A>
  17 <H2>SYNOPSIS</H2>
  18
  19 <B>ipsec</B>
  20
  21 <B>eroute</B>
  22
  23 <P>
  24
  25 <B>cat</B>
  26
  27 <B>/proc/net/ipsec_eroute</B>
  28
  29 <A NAME="lbAD">&nbsp;</A>
  30 <H2>DESCRIPTION</H2>
  31
  32 <I>/proc/net/ipsec_eroute</I>
  33
  34 lists the IPSEC extended routing tables,
  35 which control what (if any) processing is applied
  36 to non-encrypted packets arriving for IPSEC processing and forwarding.
  37 At this point it is a read-only file.
  38 <P>
  39
  40 A table entry consists of:
  41 <DL COMPACT>
  42 <DT>+<DD>
  43 packet count,
  44 <DT>+<DD>
  45 source address with mask,
  46 <DT>+<DD>
  47 a '-&gt;' separator for visual and automated parsing between src and dst
  48 <DT>+<DD>
  49 destination address with mask
  50 <DT>+<DD>
  51 a '=&gt;' separator for visual and automated parsing between selection
  52 criteria and SAID to use
  53 <DT>+<DD>
  54 SAID (Security Association IDentifier), comprised of:
  55 <DT>+<DD>
  56 protocol
  57 (<I>proto</I>),
  58 <DT>+<DD>
  59 address family
  60 (<I>af</I>),
  61 where '.' stands for IPv4 and ':' for IPv6
  62 <DT>+<DD>
  63 Security Parameters Index
  64 (<I>SPI</I>),
  65 <DT>+<DD>
  66 effective destination
  67 (<I>edst</I>),
  68 where the packet should be forwarded after processing
  69 (normally the other security gateway)
  70 together indicate which Security Association should be used to process the packet
  71 </DL>
  72 <P>
  73
  74 Addresses are written as IPv4 dotted quads or IPv6 coloned hex,
  75 protocol is one of &quot;ah&quot;, &quot;esp&quot;, &quot;comp&quot; or &quot;tun&quot;
  76 and
  77 SPIs are prefixed hexadecimal numbers where the prefix '.' is for IPv4 and the prefix ':' is for IPv6
  78 <P>
  79
  80 SAIDs are written as &quot;<A HREF="mailto:protoafSPI@edst">protoafSPI@edst</A>&quot;.  There are also 5
  81 &quot;magic&quot; SAIDs which have special meaning:
  82 <DL COMPACT>
  83 <DT>+<DD>
  84 <B>%drop</B>
  85
  86 means that matches are to be dropped
  87 <DT>+<DD>
  88 <B>%reject</B>
  89
  90 means that matches are to be dropped and an ICMP returned, if
  91 possible to inform
  92 <DT>+<DD>
  93 <B>%trap</B>
  94
  95 means that matches are to trigger an ACQUIRE message to the Key
  96 Management daemon(s) and a hold eroute will be put in place to
  97 prevent subsequent packets also triggering ACQUIRE messages.
  98 <DT>+<DD>
  99 <B>%hold</B>
 100
 101 means that matches are to stored until the eroute is replaced or
 102 until that eroute gets reaped
 103 <DT>+<DD>
 104 <B>%pass</B>
 105
 106 means that matches are to allowed to pass without IPSEC processing
 107 <BR>
 108
 109
 110 </DL>
 111 <A NAME="lbAE">&nbsp;</A>
 112 <H2>EXAMPLES</H2>
 113
 114 <P>
 115
 116 <B>1867     172.31.252.0/24    -&gt; 0.0.0.0/0          =&gt; <A HREF="mailto:tun.130@192.168.43.1">tun.130@192.168.43.1</A></B>
 117
 118 <P>
 119
 120 means that 1,867 packets have been sent to an
 121 <B>eroute</B>
 122
 123 that has been set up to protect traffic between the subnet
 124 <B>172.31.252.0</B>
 125
 126 with a subnet mask of
 127 <B>24</B>
 128
 129 bits and the default address/mask represented by an address of
 130 <B>0.0.0.0</B>
 131
 132 with a subnet mask of
 133 <B>0</B>
 134
 135 bits using the local machine as a security gateway on this end of the
 136 tunnel and the machine
 137 <B>192.168.43.1</B>
 138
 139 on the other end of the tunnel with a Security Association IDentifier of
 140 <B><A HREF="mailto:tun0x130@192.168.43.1">tun0x130@192.168.43.1</A></B>
 141
 142 which means that it is a tunnel mode connection (4, IPPROTO_IPIP) with a
 143 Security Parameters Index of
 144 <B>130</B>
 145
 146 in hexadecimal.
 147 <P>
 148
 149 <B>125      3049:1::/64    -&gt; 0:0/0          =&gt; tun:<A HREF="mailto:130@3058">130@3058</A>:4::5</B>
 150
 151 <P>
 152
 153 means that 125 packets have been sent to an
 154 <B>eroute</B>
 155
 156 that has been set up to protect traffic between the subnet
 157 <B>3049:1::</B>
 158
 159 with a subnet mask of
 160 <B>64</B>
 161
 162 bits and the default address/mask represented by an address of
 163 <B>0:0</B>
 164
 165 with a subnet mask of
 166 <B>0</B>
 167
 168 bits using the local machine as a security gateway on this end of the
 169 tunnel and the machine
 170 <B>3058:4::5</B>
 171
 172 on the other end of the tunnel with a Security Association IDentifier of
 173 <B>tun:<A HREF="mailto:130@3058">130@3058</A>:4::5</B>
 174
 175 which means that it is a tunnel mode connection with a
 176 Security Parameters Index of
 177 <B>130</B>
 178
 179 in hexadecimal.
 180 <P>
 181
 182 <B>42         192.168.6.0/24     -&gt; 192.168.7.0/24     =&gt; %passthrough</B>
 183
 184 <P>
 185
 186 means that 42 packets have been sent to an
 187 <B>eroute</B>
 188
 189 that has been set up to pass the traffic from the subnet
 190 <B>192.168.6.0</B>
 191
 192 with a subnet mask of
 193 <B>24</B>
 194
 195 bits and to subnet
 196 <B>192.168.7.0</B>
 197
 198 with a subnet mask of
 199 <B>24</B>
 200
 201 bits without any IPSEC processing.
 202 <P>
 203
 204 <B>2112     192.168.8.55/32    -&gt; 192.168.9.47/24    =&gt; %hold</B>
 205
 206 <P>
 207
 208 means that 2112 packets have been sent to an
 209 <B>eroute</B>
 210
 211 that has been set up to hold the traffic from the host
 212 <B>192.168.8.55</B>
 213
 214 and to host
 215 <B>192.168.9.47</B>
 216
 217 until a key exchange from a Key Management daemon
 218 succeeds and puts in an SA or fails and puts in a pass
 219 or drop eroute depending on the default configuration.
 220 <P>
 221
 222 <B>2001     192.168.2.110/32   -&gt; 192.168.2.120/32   =&gt; </B>
 223
 224 <BR>
 225
 226 <B>        <A HREF="mailto:esp.e6de@192.168.2.120">esp.e6de@192.168.2.120</A></B>
 227
 228 <P>
 229
 230 means that 2001 packets have been sent to an
 231 <B>eroute</B>
 232
 233 that has been set up to protect traffic between the host
 234 <B>192.168.2.110</B>
 235
 236 and the host
 237 <B>192.168.2.120</B>
 238
 239 using
 240 <B>192.168.2.110</B>
 241
 242 as a security gateway on this end of the
 243 connection and the machine
 244 <B>192.168.2.120</B>
 245
 246 on the other end of the connection with a Security Association IDentifier of
 247 <B><A HREF="mailto:esp.e6de@192.168.2.120">esp.e6de@192.168.2.120</A></B>
 248
 249 which means that it is a transport mode connection with a Security
 250 Parameters Index of
 251 <B>e6de</B>
 252
 253 in hexadecimal using Encapsuation Security Payload protocol (50,
 254 IPPROTO_ESP).
 255 <P>
 256
 257 <B>1984     3049:1::110/128   -&gt; 3049:1::120/128   =&gt; </B>
 258
 259 <BR>
 260
 261 <B>        ah:<A HREF="mailto:f5ed@3049">f5ed@3049</A>:1::120</B>
 262
 263 <P>
 264
 265 means that 1984 packets have been sent to an
 266 <B>eroute</B>
 267
 268 that has been set up to authenticate traffic between the host
 269 <B>3049:1::110</B>
 270
 271 and the host
 272 <B>3049:1::120</B>
 273
 274 using
 275 <B>3049:1::110</B>
 276
 277 as a security gateway on this end of the
 278 connection and the machine
 279 <B>3049:1::120</B>
 280
 281 on the other end of the connection with a Security Association IDentifier of
 282 <B>ah:<A HREF="mailto:f5ed@3049">f5ed@3049</A>:1::120</B>
 283
 284 which means that it is a transport mode connection with a Security
 285 Parameters Index of
 286 <B>f5ed</B>
 287
 288 in hexadecimal using Authentication Header protocol (51,
 289 IPPROTO_AH).
 290 <A NAME="lbAF">&nbsp;</A>
 291 <H2>FILES</H2>
 292
 293 /proc/net/ipsec_eroute, /usr/local/bin/ipsec
 294 <A NAME="lbAG">&nbsp;</A>
 295 <H2>SEE ALSO</H2>
 296
 297 <A HREF="ipsec.8.html">ipsec</A>(8), <A HREF="ipsec_manual.8.html">ipsec_manual</A>(8), <A HREF="ipsec_tncfg.5.html">ipsec_tncfg</A>(5), <A HREF="ipsec_spi.5.html">ipsec_spi</A>(5),
 298 <A HREF="ipsec_spigrp.5.html">ipsec_spigrp</A>(5), <A HREF="ipsec_klipsdebug.5.html">ipsec_klipsdebug</A>(5), <A HREF="ipsec_eroute.8.html">ipsec_eroute</A>(8), <A HREF="ipsec_version.5.html">ipsec_version</A>(5),
 299 <A HREF="ipsec_pf_key.5.html">ipsec_pf_key</A>(5)
 300 <A NAME="lbAH">&nbsp;</A>
 301 <H2>HISTORY</H2>
 302
 303 Written for the Linux FreeS/WAN project
 304 &lt;<A HREF="http://www.freeswan.org/">http://www.freeswan.org/</A>&gt;
 305 by Richard Guy Briggs.
 306
 307
 308
 309
 310
 311
 312
 313
 314
 315
 316
 317
 318
 319
 320
 321
 322
 323
 324
 325
 326
 327
 328
 329
 330
 331
 332
 333
 334
 335 <P>
 336
 337 <HR>
 338 <A NAME="index">&nbsp;</A><H2>Index</H2>
 339 <DL>
 340 <DT><A HREF="#lbAB">NAME</A><DD>
 341 <DT><A HREF="#lbAC">SYNOPSIS</A><DD>
 342 <DT><A HREF="#lbAD">DESCRIPTION</A><DD>
 343 <DT><A HREF="#lbAE">EXAMPLES</A><DD>
 344 <DT><A HREF="#lbAF">FILES</A><DD>
 345 <DT><A HREF="#lbAG">SEE ALSO</A><DD>
 346 <DT><A HREF="#lbAH">HISTORY</A><DD>
 347 </DL>
 348 <HR>
 349 This document was created by
 350 <A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
 351 using the manual pages.<BR>
 352 Time: 05:09:31 GMT, June 19, 2001
 353 </BODY>
 354 </HTML>