X-Git-Url: http://dxcluster.net/gitweb/gitweb.cgi?a=blobdiff_plain;ds=inline;f=txt%2Fusermanual.txt;h=efe38ffd45f6c620797e5e05d6477bdbf062a22c;hb=f70b281ed9f65940d33827bbf36ab5bc4d9c87bb;hp=023783051c02cf1613df1a7c4120a182505315b9;hpb=efefa52cf2a2f34cf57fb202b558880e167a28a4;p=spider.git diff --git a/txt/usermanual.txt b/txt/usermanual.txt index 02378305..efe38ffd 100644 --- a/txt/usermanual.txt +++ b/txt/usermanual.txt @@ -1,6 +1,6 @@ - The DXSpider User Manual - Ian Maude, G0VGS, (ianmaude@btinternet.com) - Version 1.0, March 2001 + The DXSpider User Manual v1.50 + Ian Maude, G0VGS, (g0vgs@gb7mbc.net) + September 2002 revision 0.1 A complete reference for users of the DXSpider DXCluster program. ______________________________________________________________________ @@ -9,97 +9,33 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 1. Introduction - 1.1 What is a DX Cluster? 1.2 So what is DXSpider? 2. Logins and logouts. - 2.1 AX25 logins. 2.2 Netrom logins. 2.3 Telnet logins. 2.4 Logouts. 3. Setting your personal details. - 4. Getting and posting DX. - 4.1 Receiving DX. 4.2 Posting DX. 5. Headings and propagation - 5.1 Sun 5.2 Moon 5.3 Heading 6. Announcements. - 6.1 Making announcements. 6.2 Listing announcements. 7. Nodes and users. - 8. Talk mode. - 9. Mail. - 9.1 The "directory" command. 9.2 Reading mail. 9.3 Sending mail. @@ -107,16 +43,13 @@ 9.5 Deleting mail 10. Filtering (From version 1.45) - 10.1 General filter rules 10.2 Types of filter 10.3 Filter options 10.4 Advanced filtering 11. Hints, tips and common questions. - 12. The DXSpider command reference - 12.1 accept/announce 12.2 accept/spots 12.3 accept/wcy @@ -159,27 +92,29 @@ 12.40 set/wcy 12.41 set/wwv 12.42 set/wx - 12.43 show/date - 12.44 show/dx - 12.45 show/dxcc - 12.46 show/files - 12.47 show/filter - 12.48 show/moon - 12.49 show/muf - 12.50 show/prefix - 12.51 show/qra - 12.52 show/qrz - 12.53 show/route - 12.54 show/satellite - 12.55 show/sun - 12.56 show/time - 12.57 show/wcy - 12.58 show/wwv - 12.59 sysop - 12.60 talk - 12.61 type - 12.62 who - 12.63 wx + 12.43 show/configuration + 12.44 show/configuration/node + 12.45 show/date + 12.46 show/dx + 12.47 show/dxcc + 12.48 show/files + 12.49 show/filter + 12.50 show/moon + 12.51 show/muf + 12.52 show/prefix + 12.53 show/qra + 12.54 show/qrz + 12.55 show/route + 12.56 show/satellite + 12.57 show/sun + 12.58 show/time + 12.59 show/wcy + 12.60 show/wwv + 12.61 sysop + 12.62 talk + 12.63 type + 12.64 who + 12.65 wx ______________________________________________________________________ @@ -212,18 +147,19 @@ There are several new compatible cluster programs around now, including DXSpider. DXSpider is a clone of PacketCluster software - that runs under the Linux operating system. Linux is fast becoming - the choice for amateur radio stations because of it's flexibility, - reliability and the lack of the memory limitations of DOS. Linux - supports multitasking and is also multiuser. It has support for AX25, - ROSE, NetROM and TCPIP built in, making it the ideal choice for - amateur radio. It is also totally free! + that runs under several operating systems including Linux and Windows. + Linux is fast becoming the choice for amateur radio stations because + of it's flexibility, reliability and the lack of the memory + limitations of DOS. Linux supports multitasking and is also + multiuser. It has support for AX25, ROSE, NetROM and TCPIP built in, + making it the ideal choice for amateur radio. It is also totally + free! DXSpider was conceived and begun in 1998 by Dirk Koopman, G1TLH as an exercise in perl programming. It has developed rapidly and today is a very powerful cluster program. It was designed to be totally compatible with the AK1A program, although several commands have been - extended to try and improve functionality. + extended to improve functionality. This manual is designed to help you become familiar with the commands that DXSpider supports and to help you get the best from the program @@ -262,6 +198,8 @@ connect GB7MBC connect GB7MBC-1 + + 22..22.. NNeettrroomm llooggiinnss.. There are several possibilities here, dependant on how the sysop has @@ -280,16 +218,13 @@ - - 22..33.. TTeellnneett llooggiinnss.. - Because DXSpider runs under the Linux operating system, it is possible - to make a direct telnet connection into the cluster. With telnet - connections, the source callsign is not seen by DXSpider, so you will - be asked to login with your callsign. To telnet to DXSpider, you - would connect to a specific port. There is no standard at the moment - for a cluster telnet port but ask the sysop if you are unsure. + With telnet connections, the source callsign is not seen by DXSpider, + so you will be asked to login with your callsign. To telnet to + DXSpider, you would connect to a specific port. There is no standard + at the moment for a cluster telnet port but ask the sysop if you are + unsure. EExxaammppllee:: @@ -299,7 +234,6 @@ - All the above are possible ways of connecting to a DXSpider cluster. You may have some or all of these available to you. There may be one or two additional ways to connect dependant on the network local to @@ -314,11 +248,11 @@ command if you are connected via telnet. If you do not log out gracefully using one of the above commands, you may find you are unable to get a full connect next time. This may also happen if a - NETRom connection drops. You may get connected, but nothing else will + netrom connection drops. You may get connected, but nothing else will happen because the program thinks you are still connected and will not let you connect twice under the same call. However you could reconnect by adding a number to the end of your call, for example - G0YLM2. This can be done by either altering your MYCALL setting in + G0YLM-2. This can be done by either altering your MYCALL setting in the TNC or by altering your program configuration. @@ -350,8 +284,6 @@ - - 44.. GGeettttiinngg aanndd ppoossttiinngg DDXX.. When all is said and done, this is the main function of a DX cluster. @@ -387,20 +319,18 @@ - will show the last 10, 5 and 20 spots received by the cluster respectively. EExxaammpplleess + show/dx on 20m show/dx 10 on 20m show/dx 20 on 20m - - will show the last 5, 10 or 20 spots on 20 metres only. It is also possible to check for certain callsigns, or fragments of @@ -415,7 +345,6 @@ - would show the last 5 or 10 dx spots containing the callsign g0vgs. @@ -432,7 +361,6 @@ - would show the spots that arrived between 30 and 40 spots ago and any spots with the word _i_o_t_a in the comment field. The case of the comment is not important. @@ -448,7 +376,6 @@ - It is of course possible to specify multiple arguments. EExxaammppllee:: @@ -459,7 +386,6 @@ - This would show the last 20 spots posted by or about calls with the prefix 9a on vhf 30 days ago. @@ -467,7 +393,6 @@ sure whether something will work or not, try it and see! More information can be found in the Command Set section. - 44..22.. PPoossttiinngg DDXX.. To post DX you use the DDXX command. The syntax is shown below. @@ -480,7 +405,6 @@ - Where frequency is in kilohertz and the callsign is the callsign of the station you have worked or heard, (ie not your own callsign!). The remarks section allows you to add information like the operators @@ -495,7 +419,6 @@ - In fact, all the following will give the same result... @@ -506,7 +429,6 @@ - This posting, or callout as it is known, will be forwarded to all other connected stations both at the cluster you are connected to and other active clusters in the network. The callout will also be sent @@ -523,9 +445,6 @@ return the correct information. - - - 55..11.. SSuunn The SSHHOOWW//SSUUNN command can be used in three different ways. It can be @@ -536,8 +455,7 @@ - show/sun - + show/sun @@ -551,14 +469,10 @@ - - - sh/sun 5b4 - would look like this ... @@ -569,7 +483,6 @@ - You can also specify multiple arguments like this ... @@ -578,7 +491,6 @@ - and then the output would look like this ... @@ -592,6 +504,7 @@ ZS So-Africa-ZS6-ZS 03:59Z 16:42Z 277.6 35.0 + 55..22.. MMoooonn The SSHHOOWW//MMOOOONN command works in the same way as the SSHHOOWW//SSUUNN command. @@ -607,7 +520,6 @@ - The output from this command would look like this .. @@ -618,7 +530,6 @@ - You can see that the output is similar to the SSHHOOWW//SSUUNN command, with slightly different fields. @@ -637,7 +548,6 @@ - The output from this command would look like this .. @@ -650,8 +560,6 @@ - - 66.. AAnnnnoouunncceemmeennttss.. 66..11.. MMaakkiinngg aannnnoouunncceemmeennttss.. @@ -665,12 +573,10 @@ EExxaammppllee:: - announce 10 FM is open in IO84NB to europe. - That would let everyone know locally that this was the case, however it would not be forwarded to other nodes connected. To send announcements to other connected nodes as well, you would use the FFUULLLL @@ -684,7 +590,6 @@ - Be cautious in your use of announce full. There are many other tools available to get the information you require and the judicious use of this command is frowned upon as it creates a great deal of traffic @@ -706,8 +611,6 @@ - - 77.. NNooddeess aanndd uusseerrss.. You can check which nodes are connected in the network, who is logged @@ -720,15 +623,10 @@ - - - - - show/configuration - show/configuration/nodes - show/configuration (node_call) - show/configuration (prefix) - + show/configuration + show/configuration/nodes + show/configuration (node_call) + show/configuration (prefix) @@ -736,27 +634,26 @@ - sh/c - Node Callsigns - EI5TCR (7 users) - GB7ADX - GB7BAA G4FPV G8TIC - GB7BIG (GD0TEP) GD3UMW - GB7BPQ (G0INA) G0RCI G3AKU G3OCA - (GB7CDX) G3JNB G4ALR - GB7DJK G0FYD G0REK G1TLH G4PEL G4SOZ - G4TVR G7SQW K8AZ M0CTQ-1 MM1CXE-10 - ON7WP - GB7DXA G0RDI G8SJP - GB7DXC (G0HDB) G0WFK (G1FYC) G3KWK G3LME - G3OIL G4BGW G4FUJ (G4PDQ) GW7SMV - GB7DXE G1NNB - (GB7DXG) GU6EFB GU7DHI - GB7DXK G1NTW G3IBI G3NSM G3XAQ G4CUS - G4XQY G7GAN - GB7DXM G1EUC G3GAF G3LAS G4ZTR G8WXU - M0BCT M1EMF - + sh/c + Node Callsigns + EI5TCR (7 users) + GB7ADX + GB7BAA G4FPV G8TIC + GB7BIG (GD0TEP) GD3UMW + GB7BPQ (G0INA) G0RCI G3AKU G3OCA + (GB7CDX) G3JNB G4ALR + GB7DJK G0FYD G0REK G1TLH G4PEL G4SOZ + G4TVR G7SQW K8AZ M0CTQ-1 MM1CXE-10 + ON7WP + GB7DXA G0RDI G8SJP + GB7DXC (G0HDB) G0WFK (G1FYC) G3KWK G3LME + G3OIL G4BGW G4FUJ (G4PDQ) GW7SMV + GB7DXE G1NNB + (GB7DXG) GU6EFB GU7DHI + GB7DXK G1NTW G3IBI G3NSM G3XAQ G4CUS + G4XQY G7GAN + GB7DXM G1EUC G3GAF G3LAS G4ZTR G8WXU + M0BCT M1EMF @@ -784,19 +681,17 @@ - If we insert the node_call pi4tue-8 into the third example, then this would be the output, - Node Callsigns - PI4TUE-8 9A1CMA-6 DF6PW DL4FAY DL4KAK DL4WF-2 - F5NOD-2 F5PAC IZ0CSR N6CR OH2BLD - ON1LVL-13 ON4CBT ON4CJP ON5DXL-14 ON7NQ - PA0RCT PA3DYS PA3FDO PA5KW-4 PI4TUE-9 - YT1XX - + Node Callsigns + PI4TUE-8 9A1CMA-6 DF6PW DL4FAY DL4KAK DL4WF-2 + F5NOD-2 F5PAC IZ0CSR N6CR OH2BLD + ON1LVL-13 ON4CBT ON4CJP ON5DXL-14 ON7NQ + PA0RCT PA3DYS PA3FDO PA5KW-4 PI4TUE-9 + YT1XX @@ -821,7 +716,6 @@ - The output of this command would look like this, @@ -832,8 +726,6 @@ - - 88.. TTaallkk mmooddee.. You can send a single comment or start a dedicated talk session to @@ -852,10 +744,10 @@ - talk g0rdi Having a good day Iain? + This example would send the line "Having a good day Iain?" to the user g0rdi but would leave you in normal mode. @@ -866,8 +758,6 @@ Talk (G0RDI)> - - As you can see, you can still run commands whilst in talk mode. Simply prefix the command with a / like /sh/dx and you will get the expected output. If the user is connected to another node, you may @@ -879,7 +769,6 @@ - To exit talk mode, you issue the command //eexx. Whilst in talk mode you will still receive DX spots. This means that @@ -912,7 +801,6 @@ - Of course most of the time you will only want to list new mail sent to you personally since your last login. However you might also like to check for general mail received by the node. In fact if there is new @@ -934,8 +822,6 @@ - - The last option will only show mail from a callsign if it was sent to you personally or was sent as a bulletin. There are some additional commands and these can be found in the DXSpider Command Reference @@ -963,7 +849,6 @@ - The first column is the actual message number. If the message is a personal one to you, you will see a letter 'p' after this number. If the message has been read, there will be a '-' between the message @@ -983,11 +868,11 @@ - will read message number 25. However the mail will be displayed in it's entirety unless you specify a page length. You can set your page length to any number you like and when the message reaches that number of lines you will get a prompt giving you options. + EExxaammppllee:: @@ -996,9 +881,6 @@ - - - 99..33.. SSeennddiinngg mmaaiill.. Sending mail is done in the time honoured way. First you specify a @@ -1024,7 +906,6 @@ - At this point you can either hit return and enter /ex to send the message or use /abort at any time to abort it. You can now display the message in the normal way. There are several send options and @@ -1047,13 +928,13 @@ - - 99..55.. DDeelleettiinngg mmaaiill To delete a message, you use the _d_e_l_e_t_e command. You can only delete messages sent to or received by yourself. Bulletins are dealt with automatically or by the sysop. + + 1100.. FFiilltteerriinngg ((FFrroomm vveerrssiioonn 11..4455)) 1100..11.. GGeenneerraall ffiilltteerr rruulleess @@ -1077,13 +958,11 @@ - accept/spots ..... reject/spots ..... - where ..... are the specific commands for that type of filter. There are filters for spots, wwv, announce, wcy and (for sysops) connects. See each different accept or reject command reference for more @@ -1099,7 +978,6 @@ - There is clear/xxxx command for each type of filter. @@ -1107,19 +985,14 @@ - show/filter - - For now we are going to use spots for the examples, but you can apply the same principles to all types of filter. - - 1100..22.. TTyyppeess ooff ffiilltteerr There are two main types of filter, _a_c_c_e_p_t or _r_e_j_e_c_t. You can use @@ -1143,7 +1016,6 @@ - then you will _O_N_L_Y get VHF spots _f_r_o_m or _t_o CQ zones 14, 15 and 16. @@ -1155,7 +1027,6 @@ - Then you will get everything _E_X_C_E_P_T HF CW spots. You could make this single filter even more flexible. For example, if you are interested in IOTA and will work it even on CW even though normally you are not @@ -1167,7 +1038,6 @@ - But in that case you might only be interested in iota and say:- @@ -1176,7 +1046,6 @@ - which achieves exactly the same thing. You should choose one or the other until you are comfortable with the way it works. You can mix them if you wish (actually you can have an accept AND a reject on the @@ -1186,16 +1055,16 @@ You can arrange your filter lines into logical units, either for your own understanding or simply convenience. Here is an example ... + + + reject/spots 1 on hf/cw reject/spots 2 on 50000/1400000 not (by_zone 14,15,16 or call_zone 14,15,16) - What this does is to ignore all HF CW spots and also rejects any spots on VHF which don't either originate or spot someone in Europe. - - This is an example where you would use a line number (1 and 2 in this case), if you leave the digit out, the system assumes '1'. Digits '0'-'9' are available. This make it easier to see just what filters @@ -1217,7 +1086,6 @@ - The simple way to remember this is, if you use OR - use brackets. Whilst we are here CASE is not important. 'And BY_Zone' is just the same as 'and by_zone'. @@ -1233,7 +1101,6 @@ - would redefine our earlier example, or @@ -1242,7 +1109,6 @@ - To remove all the filter lines in the spot filter ... @@ -1251,13 +1117,13 @@ - 1100..33.. FFiilltteerr ooppttiioonnss You can filter in several different ways. The options are listed in the various helpfiles for accept, reject and filter. + 1100..44.. AAddvvaanncceedd ffiilltteerriinngg Once you are happy with the results you get, you may like to @@ -1275,7 +1141,6 @@ - Note that the first filter has not been specified with a number. This will automatically be assumed to be number 1. In this case, we have said _r_e_j_e_c_t _a_l_l _H_F _s_p_o_t_s _i_n _t_h_e _C_W _s_e_c_t_i_o_n _o_f _t_h_e _b_a_n_d_s _b_u_t _a_c_c_e_p_t _a_l_l @@ -1323,8 +1188,6 @@ AA..Use the SSEETT//BBEEEEPP command. You can find information on this in the "DXSpider Command Reference" section. - QQ..I keep getting disconnected from the cluster, what is happening and - how can I stop it? QQ..I got disconnected from the cluster and now I can't log back in again. What is wrong? @@ -1334,10 +1197,6 @@ again adding an ssid to your callsign as DXSpider treats G0YLM and G0YLM-1 as different users. - QQ..I notice that all the commands are shown in lower case in the main - section of this manual, but in upper case in the "DXSpider Command - Reference" section. Why is that? - QQ..How do I know if I have got the latest version of this user manual? AA..The latest and greatest will always be on the Website. It will also @@ -1382,8 +1241,6 @@ - - some examples:- @@ -1394,16 +1251,12 @@ - or - - acc/ann by G,M,2 - This filter would only allow announces that were posted buy UK stations. You can use the tag 'all' to accept everything eg: @@ -1413,13 +1266,12 @@ - but this probably for advanced users... 1122..22.. aacccceepptt//ssppoottss - aacccceepptt//aannnnoouunnccee [[00--99]] <
> Set an accept filter line for spots + aacccceepptt//ssppoottss [[00--99]] <
> Set an accept filter line for spots
Create an 'accept this spot' line for a filter.
@@ -1449,7 +1301,6 @@
-
For frequencies, you can use any of the band names defined in
SHOW/BANDS and you can use a subband name like: cw, rtty, data, ssb -
thus: hf/ssb. You can also just have a simple range like: 0/30000 -
@@ -1464,8 +1315,6 @@
acc/spot 2 on vhf and (by_zone 14,15,16 or call_zone 14,15,16)
-
-
You can use the tag 'all' to accept everything, eg:
@@ -1474,7 +1323,6 @@
-
but this probably for advanced users...
@@ -1500,8 +1348,6 @@
-
-
There are no examples because WCY Broadcasts only come from one place
and you either want them or not (see UNSET/WCY if you don't want
them).
@@ -1532,8 +1378,6 @@
channel > Set a reject filter for announce
+
Create an 'reject this announce' line for a filter.
An reject filter line means that if the announce matches this filter
@@ -1830,7 +1655,6 @@
-
some examples:-
@@ -1839,13 +1663,14 @@
-
You can use the tag 'all' to reject everything eg:
rej/ann all
+
+
but this probably for advanced users...
@@ -1865,20 +1690,19 @@
- freq > Set a reject WCY filter
@@ -1933,8 +1753,6 @@
channel >||< >||< > Interrogate the spot database by country
@@ -2371,17 +2176,12 @@
-
-
-
SH/DXCC G
SH/DXCC W on 20m info iota
-
-
- 1122..4466.. sshhooww//ffiilleess
+ 1122..4488.. sshhooww//ffiilleess
sshhooww//ffiilleess [[< >||< > [[< >||< >||<>]]]] List the contents of a filearea
@@ -2396,7 +2196,6 @@
-
where