Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
ENC(4)			     Kernel Interfaces Manual			  ENC(4)

NAME
     enc -- Encapsulating Interface

SYNOPSIS
     To compile this driver into the kernel, place the following line in your
     kernel configuration file:

	   device enc

     Alternatively, to load the driver as a module at boot time, place the
     following line in loader.conf(5):

	   if_enc_load="YES"

DESCRIPTION
     The  enc  interface  is  a software loopback mechanism that allows hosts or
     firewalls to filter ipsec(4) traffic using any firewall package that  hooks
     in via the pfil(9) framework.

     The  enc  interface  allows  an  administrator to see incoming and outgoing
     packets before and after they will be or have been  processed  by	ipsec(4)
     via tcpdump(1).

     The  "enc0"  interface  inherits all IPsec traffic.  Thus all IPsec traffic
     can be filtered based on "enc0", and all IPsec traffic could be seen by in-
     voking tcpdump(1) on the "enc0" interface.

     What can be seen with tcpdump(1) and what will be passed on  to  the  fire-
     walls  via  the pfil(9) framework can be independently controlled using the
     following sysctl(8) variables:

     Name			      Defaults	    Suggested
     net.enc.out.ipsec_bpf_mask       0x00000003    0x00000001
     net.enc.out.ipsec_filter_mask    0x00000001    0x00000001
     net.enc.in.ipsec_bpf_mask	      0x00000001    0x00000002
     net.enc.in.ipsec_filter_mask     0x00000001    0x00000002

     For the incoming path a value of 0x1 means "before stripping off the  outer
     header" and 0x2 means "after stripping off the outer header".  For the out-
     going path 0x1 means "with only the inner header" and 0x2 means "with outer
     and inner headers".

     incoming path					    |------|
     ---- IPsec processing ---- (before) ---- (after) ----> |	   |
							    | Host |
     <--- IPsec processing ---- (after) ----- (before) ---- |	   |
     outgoing path					    |------|

     Most   people   will   want   to	run  with  the	suggested  defaults  for
     ipsec_filter_mask and rely on the security policy database  for  the  outer
     headers.

     Note that packets are captured by BPF before firewall processing.	The spe-
     cial  value 0x4 can be configured in the ipsec_bpf_mask and packets will be
     also captured after firewall processing.

EXAMPLES
     To see the packets processed via ipsec(4), adjust the  sysctl(8)  variables
     according to your need and run:

	   tcpdump -i enc0

SEE ALSO
     tcpdump(1), bpf(4), ipf(4), ipfw(4), ipsec(4), pf(4)

FreeBSD ports 15.1		 August 9, 2017 			  ENC(4)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=enc&sektion=4&manpath=FreeBSD+15.1-RELEASE+and+Ports>

home | help