ipsec_tncfg(8)

ipsec_tncfg8

Manipulate klips virtual interfaces

Usage

ipsec tncfg

ipsec tncfg --create virtual

ipsec tncfg --delete virtual

ipsec tncfg --attach --virtual virtual --physical physical

ipsec tncfg --detach --virtual virtual

ipsec tncfg --clear

ipsec tncfg --version

ipsec tncfg --help

Obsolete

Note that tncfg is only supported on the classic KLIPS stack. It is not supported on any other stack and will be completely removed in future versions. A replacement command still needs to be designed

Overview

The historical use of tncfg is to attach/detach IPsec virtual interfaces (e.g. ipsec0) to/from physical interfaces (e.g. eth0) through which packets will be forwarded once processed by KLIPS.

The modern use of tncfg is to create and delete virtual interfaces known as mastXXX. mast stands for Mooring and XXX.

The form with no additional arguments lists the contents of /proc/net/ipsec_tncfg. The format of /proc/net/ipsec_tncfg is discussed in ipsec_tncfg(5).

The --attach form attaches the virtual interface to the physical one.

The --detach form detaches the virtual interface from whichever physical interface it is attached to.

The --clear form clears all the virtual interfaces from whichever physical interfaces they were attached to.

Virtual interfaces typically have names like ipsec0 or mast0 while physical interfaces typically have names like eth0 or ppp0.

Examples

ipsec tncfg --create mast12

creates the mast12 device.

ipsec tncfg --create ipsec4

creates an ipsec4 device, but does not attach it.

ipsec tncfg --attach --virtual ipsec0 --physical eth0

attaches the ipsec0 virtual device to the eth0 physical device.

Files

/proc/net/ipsec_tncfg, /usr/local/bin/ipsec

Releases

4 releases since Debian 3.1 (Sarge); the text changed 3 times.

  1. 3.1
  2. 4.0
  3. 5.0
  4. 7

History

Written for the Linux FreeS/WAN project <http://www.freeswan.org/> by Richard Guy Briggs.

From openswan 1:2.6.37-3+deb7u1 in Debian 7 (Wheezy). Parsed by carta from the page's man source.