freeswan/testing/utils/ikeping/ikeping.8

   1 .TH IPSEC_IKEPING 8 "23 Feb 2002"
   2 .\" RCSID $Id: ikeping.8,v 1.2 2002/03/12 19:49:42 rgb Exp $
   3 .SH NAME
   4 ipsec ikeping \- send/receive ISAKMP/IKE echo requests/replies
   5 .SH SYNOPSIS
   6 .B ipsec
   7 .B ikeping
   8 [
   9 .B \-\-listen
  10 ] [
  11 .B \-\-verbose
  12 ] [
  13 .B \-\-wait
  14 time ] [
  15 .B \-\-exchangenum
  16 num ] [
  17 .B \-\-ikeport
  18 localport ] [
  19 .B \-\-ikeaddress
  20 address ] [
  21 .B \-\-inet
  22 ] [
  23 .B \-\-inet6
  24 ] destaddr[/dstport] ...
  25 .SH DESCRIPTION
  26 .I Ikeping
  27 sends and receives ISAKMP/IKE echo request and echo reply packets. These
  28 packets are intended for diagnostics purposes, in a manner similar to
  29 .IR ping (8)
  30 does for ICMP echo request/reply packets.
  31 .PP
  32 At the time of this writing, the ISAKMP echo request/reply exchange is still
  33 an internet-draft, and is therefore completely non-standard.
  34 .PP
  35 .I Ikeping
  36 will bind to the local address given by
  37 .B \-\-ikeaddress
  38 and the port number given by
  39 .B \-\-ikeport
  40 defaulting to the wildcard address and the ISAKMP port 500. An ISAKMP
  41 exchange of type 244 (a private use number) is sent to each of the
  42 address/ports listed on the command line. The exchange number may be
  43 overridden by the
  44 .B \-\-exchangenum
  45 option.
  46 .PP
  47 .I Ikeping
  48 then listens for replies, printing them as they are received. Replies
  49 are of exchange type 245 or the specified exchange number plus 1.
  50 .I Ikeping
  51 will keep listening until it either receives as many echo responses as it sent,
  52 or until the timeout period (10 seconds) has been reached. Receipt of a
  53 packet will reset the timer. The
  54 .B \-\-wait
  55 option can be used to specify a different timeout period.
  56 .PP
  57 If the
  58 .B \-\-listen
  59 option is given, then
  60 .I ikeping
  61 will not send any packets. Instead, it will listen for them and reply to
  62 each request received.
  63 .SH FILES
  64 no external files
  65 .SH SEE ALSO
  66 ping(8), ipsec_pluto(8)
  67 .SH HISTORY
  68 Written for the Linux FreeS/WAN project
  69 <http://www.freeswan.org>
  70 by Michael Richardson.
  71 .SH BUGS