From eec4ea22132c15b824f48513f40df75449b760fd Mon Sep 17 00:00:00 2001
From: slerena <slerena@gmail.com>
Date: Mon, 13 Oct 2008 14:44:49 +0000
Subject: [PATCH] 2008-10-13 Sancho Lerena <slerena@artica.es>
* include/help/en/help_tcp_send.php: Added mising help file.
git-svn-id: https://svn.code.sf.net/p/pandora/code/trunk@1146 c3f86ba8-e40f-0410-aaad-9ba5e7f4b01f
---
pandora_console/ChangeLog | 4 ++
.../include/help/en/help_tcp_send.php | 68 +++++++++++++++++++
2 files changed, 72 insertions(+)
create mode 100644 pandora_console/include/help/en/help_tcp_send.php
diff --git a/pandora_console/ChangeLog b/pandora_console/ChangeLog
index 98a971351f..bc32ba98a0 100644
--- a/pandora_console/ChangeLog
+++ b/pandora_console/ChangeLog
@@ -1,3 +1,7 @@
+2008-10-13 Sancho Lerena <slerena@artica.es>
+
+ * include/help/en/help_tcp_send.php: Added mising help file.
+
2008-10-13 Jorge Gonzalez <jorgegonz@artica.es>
* languages/cs.po, languages/pt_BR.po, languages/es.po,
diff --git a/pandora_console/include/help/en/help_tcp_send.php b/pandora_console/include/help/en/help_tcp_send.php
new file mode 100644
index 0000000000..e91f53b926
--- /dev/null
+++ b/pandora_console/include/help/en/help_tcp_send.php
@@ -0,0 +1,68 @@
+<h1>TCP Check</h1>
+<p>
+This module just send character strings to destination IP / port, wait for response and optionally match it's response with a predefined response. If TCP SEND / TCP RCV. fields are emply just check for an open port in destination.
+<br><br>
+You can use ^M string to send a carriage return, and also can use a multi request / multi response conversation. Several request and responses are separated with | character.
+<br><br>
+
+
+<h2>Example #1. Checking WEB service</h2>
+<p>
+Just imagine that you want to check that www.yahoo.com reply correctly to a HTTP request. Put this in TCP Send:<br><BR>
+GET / HTTP/1.0^M^M
+<BR><BR>
+And this on TCP receive:
+<br><br>
+200 OK
+<br><br>
+This should give OK if a correct HTTP request is possible.
+</p>
+
+
+<h2>Example #2. Checking SSH service</h2>
+<p>
+If you make a telnet to port 22 of a standard service you will see that after connecting they present you a banner like
+<br><br>
+SSH-2.0xxxxxxxxxx
+<br><br>
+If you type something, like "none" and press enter, they reply you the following string and close socket:
+<br><br>
+Protocol mismatch
+<br><br>
+So to "code" this conversation in a Pandora FMS TCP module, you need to put in TCP Send:
+<br><br>
+|none^M
+<br><br>
+And put in TCP Receive:
+<br><br>
+SSH-2.0|Protocol mismatch
+</p>
+
+<h3>Example #3. Checking a SMTP service</h3>
+<p>
+This is sample SMTP conversation:
+<pre>
+R: 220 mail.supersmtp.com Blah blah blah
+S: HELO myhostname.com
+R: 250 myhostname.com
+S: MAIL FROM: <pepito@myhostname.com>
+R: 250 OK
+S: RCPT TO: <Jones@supersmtp.com>
+R: 250 OK
+S: DATA
+R: 354 Start mail input; end with <CRLF>.<CRLF>
+S: .......your mail here........
+S: .
+R: 250 OK
+S: QUIT
+R: 221 mail.supersmtp.com Service closing blah blah blah
+</pre>
+<br>
+So if you want to check the first steps of conversation, the fields will be:
+<br><br>
+<b>TCP SEND </b>: HELO myhostname.com^M|MAIL FROM: <pepito@myhostname.com>^M| RCPT TO: <Jones@supersmtp.com>^M
+<br><br>
+<b>TCP SEND </b>: 250|250|250
+<br><br>
+If the first three steps of connections are "OK" then the SMTP seems to be ok, don't need to send a real mail (could be done, whatever!). This is a powerful TCP service checker that could be used to verify any TCP plain text service.
+</p>
\ No newline at end of file