/uClinux-dist/freeswan/doc/manpage.d/ipsec_barf.8.html

https://bitbucket.org/__wp__/mb-linux-msli · HTML · 132 lines · 100 code · 32 blank · 0 comment · 0 complexity · bc7a69d188d99b53d99a0165b06e3ed4 MD5 · raw file

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