freeswan/klips/utils/klipsdebug.5

   1 .TH IPSEC_KLIPSDEBUG 5 "26 Jun 2000"
   2 .\"
   3 .\" RCSID $Id: klipsdebug.5,v 1.4 2000/10/10 20:10:19 rgb Exp $
   4 .\"
   5 .SH NAME
   6 ipsec_klipsdebug \- list KLIPS (kernel IPSEC support) debug features and level
   7 .SH SYNOPSIS
   8 .B ipsec
   9 .B klipsdebug
  10 .PP
  11 .B cat
  12 .B /proc/net/ipsec_klipsdebug
  13 .SH DESCRIPTION
  14 .I /proc/net/ipsec_klipsdebug
  15 lists flags that control various parts of the debugging output of Klips
  16 (the kernel portion of FreeS/WAN IPSEC).
  17 At this point it is a read-only file.
  18 .PP
  19 A table entry consists of:
  20 .IP + 3
  21 a KLIPS debug variable
  22 .IP +
  23 a '=' separator for visual and automated parsing between the variable
  24 name and its current value
  25 .IP +
  26 hexadecimal bitmap of variable's flags.
  27 .PP
  28 The variable names roughly describe the scope of the debugging variable.
  29 Currently, no flags are documented or individually accessible yet except
  30 tunnel-xmit.
  31 .ne 5
  32 .PP
  33 The variable names are:
  34 .TP 8
  35 .B tunnel
  36 tunnelling code
  37 .TP
  38 .B netlink
  39 userspace communication code (obsolete)
  40 .TP
  41 .B xform
  42 transform selection and manipulation code
  43 .TP
  44 .B eroute
  45 eroute table manipulation code
  46 .TP
  47 .B spi
  48 SA table manipulation code
  49 .TP
  50 .B radij
  51 radij tree manipulation code
  52 .TP
  53 .B esp
  54 encryptions transforms code
  55 .TP
  56 .B ah
  57 authentication transforms code
  58 .TP
  59 .B rcv
  60 receive code
  61 .TP
  62 .B ipcomp
  63 ip compression transforms code
  64 .TP
  65 .B verbose
  66 give even more information, beware this will probably trample the 4k kernel printk buffer giving inaccurate output
  67 .PP
  68 All KLIPS debug output appears as
  69 .B kernel.info
  70 messages to
  71 .IR syslogd (8).
  72 Most systems are set up
  73 to log these messages to
  74 .IR /var/log/messages .
  75 .PP
  76 .SH EXAMPLES
  77 .LP
  78 .B debug_tunnel=00000010.
  79 .br
  80 .B debug_netlink=00000000.
  81 .br
  82 .B debug_xform=00000000.
  83 .br
  84 .B debug_eroute=00000000.
  85 .br
  86 .B debug_spi=00000000.
  87 .br
  88 .B debug_radij=00000000.
  89 .br
  90 .B debug_esp=00000000.
  91 .br
  92 .B debug_ah=00000000.
  93 .br
  94 .B debug_rcv=00000000.
  95 .br
  96 .B debug_pfkey=ffffffff.
  97 .LP
  98 means that one
  99 .B tunnel
 100 flag has been set (tunnel-xmit),
 101 full
 102 .B pfkey
 103 sockets debugging has been set and everything else is not set.
 104 .LP
 105 .SH FILES
 106 /proc/net/ipsec_klipsdebug, /usr/local/bin/ipsec
 107 .SH "SEE ALSO"
 108 ipsec(8), ipsec_manual(8), ipsec_tncfg(8), ipsec_eroute(8),
 109 ipsec_spi(8), ipsec_spigrp(8), ipsec_klipsdebug(5), ipsec_version(5),
 110 ipsec_pf_key(5)
 111 .SH HISTORY
 112 Written for the Linux FreeS/WAN project
 113 <http://www.freeswan.org/>
 114 by Richard Guy Briggs.
 115 .\"
 116 .\" $Log: klipsdebug.5,v $
 117 .\" Revision 1.4  2000/10/10 20:10:19  rgb
 118 .\" Added support for debug_ipcomp and debug_verbose to klipsdebug.
 119 .\"
 120 .\" Revision 1.3  2000/06/30 18:21:55  rgb
 121 .\" Update SEE ALSO sections to include ipsec_version(5) and ipsec_pf_key(5)
 122 .\" and correct FILES sections to no longer refer to /dev/ipsec which has
 123 .\" been removed since PF_KEY does not use it.
 124 .\"
 125 .\" Revision 1.2  2000/06/28 12:44:12  henry
 126 .\" format touchup
 127 .\"
 128 .\" Revision 1.1  2000/06/28 05:43:00  rgb
 129 .\" Added manpages for all 5 klips utils.
 130 .\"
 131 .\"
 132 .\"