Connecting to other Clusters

X-Git-Url: http://dxcluster.org/gitweb/gitweb.cgi?a=blobdiff_plain;f=html%2Fconnect.html;h=f4f6308af90c6987252c0195335ac12a3eb05a19;hb=4647d4d8a9a97117b29c7b3a0477de2e76c01194;hp=ebc9ce88e3624f89f02652e42622cb3720d64911;hpb=7a64dbf69ead057f2fd3fef1df05e30cef339485;p=spider.git diff --git a/html/connect.html b/html/connect.html index ebc9ce88..f4f6308a 100644 --- a/html/connect.html +++ b/html/connect.html @@ -2,35 +2,66 @@ Connecting to other Clusters + + + - -

Connecting to other Clusters

- -

Dirk Koopman G1TLH

+ + +

Connecting to other Clusters

+ + + +

Dirk Koopman G1TLH

- - -Last modified: Mon Dec 14 00:29:00 GMT 1998 + + +Last modified: Fri Jan 8 14:27:18 GMT 1999

At the moment, anybody can connect inwards at any time from outside, either by ax25 or by telnet (assuming you have followed the instructions in installation instructions. However, in order to connect outwards, you will need to create connect scripts. - +

Connect scripts live in the /spider/connect directory and are simple ascii scripts that are written using a normal editor. There are a couple of examples in the issue directory. - -

Here are a couple of basic types, first a telnet connection:- + +

Here are a few of basic types, first a telnet connection where the + client is set up in the passwd file thus:- +

+    gb7djk:x:1372:1291::/home/gb7djk:/usr/bin/perl /spider/perl/client.pl gb7djk telnet
+

+ and the connect script would be:-

     timeout 15
     # this is a comment
     connect telnet dirkl.tobit.co.uk
     'login' 'gb7djk'
     'word' 'gb7djk'
-    client /usr/bin/perl /spider/perl/client.pl gb7djk-1 telnet
+    client gb7djk telnet
+

For a connect that requires a login and execution of the programs + from a normal shell, do:- + +

+    timeout 15
+    connect telnet dirkl.tobit.co.uk
+    'login' 'gb7djk'
+    'word' 'gb7djk'
+    '\$' 'cd /spider/perl'
+    # set the line to prevent echoing, leaving this out will
+    # confuse whole networks for hours!
+    '\$' 'stty -echo raw'
+    # tell GB7DJK that you are GB7DJK-1
+    '\$' 'client.pl gb7djk-1 telnet'
+    # tell GB7DJK-1 that it is connected to GB7DJK
+    # you can leave this out if you call this script 'gb7djk'
+    client gb7djk telnet

and an ax25 example:- + +

and finally an ax25 example:-

     timeout 60
     abort (Busy|Sorry|Fail)
@@ -40,17 +71,18 @@ Last modified: Mon Dec 14 00:29:00 GMT 1998
     'Connect' 'c np7'
     'Connect' 'c gb7dxm'
     'Connect' ''
-    client /usr/bin/perl /spider/perl/client.pl gb7dxm ax25
+    # you can leave this out if you call the script 'gb7dxm'
+    client gb7dxm ax25

- +

A connection is started manually by typing in connect on a sysop enabled client.pl session. For example:-

     G1TLH de GB7DJK 13-Dec-1998 2041Z > connect gb7djk-1
     connection to GB7DJK-1 started
     G1TLH de GB7DJK 13-Dec-1998 2043Z > 
-

- + +

You can watch the progress of the connection (if you have the standard debugging enabled) on the cluster.pl screen and you should see something like this:-

@@ -81,33 +113,70 @@ Last modified: Mon Dec 14 00:29:00 GMT 1998
     <- D GB7DJK-1 PC38^GB7DJK-1^~
     <- D GB7DJK-1 PC18^ 1 nodes, 0 local / 1 total users  Max users 0  Uptime 0 00:00^5447^~
     etc
-

+ + +

The connect scripts consist of lines which start with the + following keywords or symbols:- -

The connect scripts consist of lines which start with the following keywords or symbols:-

# All lines starting with a # are ignored, as are wholly blank lines. -
timeout followed by a number is the number of seconds to wait for a command - to complete. If there is no timeout specified in the script then the default is 60 seconds. -
abort is a regular expression containing one or more strings to look for to abort a - connection. This is a perl regular expression and is executed ignoring case. -
connect followed by ax25 or telnet and some type dependent information. In - the case of a telnet connection, there can be up to two parameters, the first is the ip - address or hostname of the computer you wish to connect to and the second is the port number you - want to use (this can be left out if it is a normal telnet session). -
In the case of an ax25 session then this would normally be a call to ax25_call - or netrom_call as in the example above. It is your responsibility to get your node - and other ax25 parameters to work before going down this route! -
' or " are the delimiting characters for a chat type script. They normally - come in pairs, either can be empty. Each line reads input from the connection until it sees the string - (or perl regular expression) contained in the left hand string. If the left hand string is empty then - it doesn't read or wait for anything. The comparison is done ignoring case. -
When the left hand string has found what it is looking (if it is) then the right hand string is - sent to the connection. + +
# All lines starting with a # are + ignored, as are wholly blank lines. + +
timeout followed by a number is the number of + seconds to wait for a command to complete. If there is no + timeout specified in the script then the default is 60 + seconds. + +
abort is a regular expression containing one or + more strings to look for to abort a connection. This is a perl + regular expression and is executed ignoring case. + +
connect followed by ax25 or telnet + and some type dependent information. In the case of a + telnet connection, there can be up to two parameters, + the first is the ip address or hostname of the computer you + wish to connect to and the second is the port number you want + to use (this can be left out if it is a normal telnet + session). + +
In the case of an ax25 session then this would + normally be a call to ax25_call or + netrom_call as in the example above. It is your + responsibility to get your node and other ax25 parameters to + work before going down this route! + +
' is the delimiting character for a word or + phrase of an expect/send line in a chat type + script. The words/phrases normally come in pairs, either can + be empty. Each line reads input from the connection until it + sees the string (or perl regular expression) contained in the + left hand string. If the left hand string is empty then it + doesn't read or wait for anything. The comparison is done + ignoring case. + +
When the left hand string has found what it is looking (if + it is) then the right hand string is sent to the connection. +
This process is repeated for every line of chat script. -
client starts the client program and should be exactly as you would want it with an incoming - connection. + +
client starts the connection, put the arguments + you would want here if you were starting the client program + manually. You only need this if the script has a different + name to the callsign you are trying to connect to (i.e. you + have a script called other which actually connects to + GB7DJK-1 [instead of a script called + gb7djk-1]). +

$Id$

+ + +