freeswan/doc/manpage.d/ipsec_look.8.html

   1 Content-type: text/html
   2
   3 <HTML><HEAD><TITLE>Manpage of IPSEC_BARF</TITLE>
   4 </HEAD><BODY>
   5 <H1>IPSEC_BARF</H1>
   6 Section: Maintenance Commands (8)<BR>Updated: 31 May 2001<BR><A HREF="#index">Index</A>
   7 <A HREF="http://localhost/cgi-bin/man/man2html">Return to Main Contents</A><HR>
   8
   9
  10 <A NAME="lbAB">&nbsp;</A>
  11 <H2>NAME</H2>
  12
  13 ipsec barf - spew out collected IPsec debugging information
  14 <BR>
  15
  16 ipsec look - show minimal debugging information
  17 <A NAME="lbAC">&nbsp;</A>
  18 <H2>SYNOPSIS</H2>
  19
  20 <B>ipsec</B>
  21
  22 <B>barf</B>
  23
  24 [
  25 <B>--short</B>
  26
  27 ]
  28 <P>
  29 <B>ipsec</B>
  30
  31 <B>look</B>
  32
  33 <A NAME="lbAD">&nbsp;</A>
  34 <H2>DESCRIPTION</H2>
  35
  36 <I>Barf</I>
  37
  38 outputs (on standard output) a collection of debugging information
  39 (contents of files, selections from logs, etc.)
  40 related to the IPsec encryption/authentication system.
  41 It is primarily a convenience for remote debugging,
  42 a single command which packages up (and labels) all information
  43 that might be relevant to diagnosing a problem in IPsec.
  44 <P>
  45
  46 <I>Look</I>
  47
  48 outputs a minimal subset of this,
  49 intended as a quick look at current connections and related information,
  50 in a somewhat less self-explanatory format optimized for terseness.
  51 <P>
  52
  53 The
  54 <B>--short</B>
  55
  56 option limits the length of
  57 the log portion of
  58 <I>barf</I>'s
  59
  60 output, which can otherwise be extremely voluminous
  61 if debug logging is turned on.
  62 <P>
  63
  64 <I>Barf</I>
  65
  66 censors its output,
  67 replacing keys
  68 and secrets with brief checksums to avoid revealing sensitive information.
  69 <I>Look</I>
  70
  71 output does not contain such information.
  72 <P>
  73
  74 Beware that the output of both commands is aimed at humans,
  75 not programs,
  76 and the output format is subject to change without warning.
  77 <A NAME="lbAE">&nbsp;</A>
  78 <H2>FILES</H2>
  79
  80 <PRE>
  81 /proc/net/*
  82 /var/log/*
  83 /etc/ipsec.conf
  84 /etc/ipsec.secrets
  85 </PRE>
  86
  87 <A NAME="lbAF">&nbsp;</A>
  88 <H2>HISTORY</H2>
  89
  90 Written for the Linux FreeS/WAN project
  91 &lt;<A HREF="http://www.freeswan.org">http://www.freeswan.org</A>&gt;
  92 by Henry Spencer.
  93 <A NAME="lbAG">&nbsp;</A>
  94 <H2>BUGS</H2>
  95
  96 <I>Barf</I>
  97
  98 uses heuristics to try to pick relevant material out of the logs,
  99 and relevant messages
 100 which are not labelled with any of the tags that
 101 <I>barf</I>
 102
 103 looks for will be lost.
 104 We think we've eliminated the last such case, but one never knows...
 105 <P>
 106
 107 Finding
 108 <I>updown</I>
 109
 110 scripts (so they can be included in output) is, in general, difficult.
 111 <I>Barf</I>
 112
 113 uses a very simple heuristic that is easily fooled.
 114 <P>
 115
 116 <HR>
 117 <A NAME="index">&nbsp;</A><H2>Index</H2>
 118 <DL>
 119 <DT><A HREF="#lbAB">NAME</A><DD>
 120 <DT><A HREF="#lbAC">SYNOPSIS</A><DD>
 121 <DT><A HREF="#lbAD">DESCRIPTION</A><DD>
 122 <DT><A HREF="#lbAE">FILES</A><DD>
 123 <DT><A HREF="#lbAF">HISTORY</A><DD>
 124 <DT><A HREF="#lbAG">BUGS</A><DD>
 125 </DL>
 126 <HR>
 127 This document was created by
 128 <A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
 129 using the manual pages.<BR>
 130 Time: 05:09:31 GMT, June 19, 2001
 131 </BODY>
 132 </HTML>