ipsec_klipsdebug(8)

ipsec_klipsdebug8

Set klips and mast debug features and level. other stacks are not supported.

Usage

ipsec klipsdebug

ipsec klipsdebug --set flagname

ipsec klipsdebug --clear flagname

ipsec klipsdebug --all

ipsec klipsdebug --none

ipsec klipsdebug --help

ipsec klipsdebug --version

Overview

Klipsdebug sets and clears flags that control various parts of the debugging output of Klips (the kernel portion of FreeS/WAN IPSEC). The form with no additional arguments lists the present contents of /proc/net/ipsec_klipsdebug. The --set form turns the specified flag on, while the --clear form turns the specified flag off. The --all form turns all flags on except verbose, while the --none form turns all flags off.

The current flag names are:

tunnel

tunnelling code

tunnel-xmit

tunnelling transmit only code

pfkey

userspace communication code

xform

transform selection and manipulation code

eroute

eroute table manipulation code

spi

SA table manipulation code

radij

radij tree manipulation code

esp

encryptions transforms code

ah

authentication transforms code rcv receive code

ipcomp

ip compression transforms code

verbose

give even more information, BEWARE: a)this will print authentication and encryption keys in the logs b)this will probably trample the 4k kernel printk buffer giving inaccurate output

All Klips debug output appears as kernel.info messages to syslogd(8). Most systems are set up to log these messages to /var/log/messages. Beware that klipsdebug --all produces a lot of output and the log file will grow quickly.

The file format for /proc/net/ipsec_klipsdebug is discussed in ipsec_klipsdebug(5).

Examples

klipsdebug --all

turns on all KLIPS debugging except verbose.

klipsdebug --clear tunnel

turns off only the tunnel debugging messages.

Files

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

Releases

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

  1. 3.1–4.0
  2. 5.0
  3. 7

History

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

Bugs

It really ought to be possible to set or unset selective combinations of flags.

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