X-Git-Url: http://dxcluster.net/gitweb/gitweb.cgi?a=blobdiff_plain;f=cmd%2FCommands_en.hlp;h=10a4805cd2261165f0c5cb239fc86428ad8dc285;hb=d2c1a8cb2a31725e3b9084aee3ec43e585e3273f;hp=dbfa1770083c46529e9c00a20539b605fedcc002;hpb=0a92a4608d715cd9cd7eec3c120da651fbb4da5b;p=spider.git diff --git a/cmd/Commands_en.hlp b/cmd/Commands_en.hlp index dbfa1770..10a4805c 100644 --- a/cmd/Commands_en.hlp +++ b/cmd/Commands_en.hlp @@ -15,7 +15,7 @@ Create an 'accept this announce' line for a filter. An accept filter line means that if the announce matches this filter it is -passed onto the user. See HELP FILTERS for more info. Please read this +passed onto the user. See HELP FILTERING for more info. Please read this to understand how filters work - it will save a lot of grief later on. You can use any of the following things in this line:- @@ -23,12 +23,12 @@ You can use any of the following things in this line:- info eg: iota or qsl by eg: G,M,2 origin - origin_dxcc eg: 61,62 (from eg: sh/pre G) - origin_itu - origin_zone - by_dxcc - by_itu - by_zone + origin_dxcc eg: 61,62 (from eg: sh/pre G) + origin_itu or: G,GM,GW + origin_zone + by_dxcc + by_itu + by_zone channel wx 1 filter WX announces dest eg: 6MUK,WDX (distros) @@ -55,11 +55,39 @@ default for nodes and users eg:- accept/ann input node_default by G,M,2 accept/ann user_default by G,M,2 +=== 8^ACCEPT/ROUTE [0-9] ^Set an 'accept' filter line for routing +Create an 'accept this routing PC Protocol' line for a filter. + +An accept filter line means that if a PC16/17/19/21/24/41/50 matches this filter +it is passed thru that interface. See HELP FILTERING for more info. Please read this +to understand how filters work - it will save a lot of grief later on. + +You can use any of the following things in this line:- + + call the callsign of the thingy + call_dxcc eg: 61,62 (from eg: sh/pre G) + call_itu or: G,GM,GW + call_zone + origin really the interface it came in on + origin_dxcc eg: 61,62 (from eg: sh/pre G) + origin_itu or: G,GM,GW + origin_zone + +some examples:- + + acc/route gb7djk call_dxcc 61,38 (send only UK+EIRE nodes) + acc/route gb7djk call gb7djk (equiv to SET/ISOLATE) + +You can use the tag 'all' to accept everything eg: + + acc/route all + + === 0^ACCEPT/SPOTS [0-9] ^Set an 'accept' filter line for spots Create an 'accept this spot' line for a filter. An accept filter line means that if the spot matches this filter it is -passed onto the user. See HELP FILTERS for more info. Please read this +passed onto the user. See HELP FILTERING for more info. Please read this to understand how filters work - it will save a lot of grief later on. You can use any of the following things in this line:- @@ -69,12 +97,12 @@ You can use any of the following things in this line:- call eg: G,PA,HB9 info eg: iota or qsl by - call_dxcc eg: 61,62 (from eg: sh/pre G) - call_itu - call_zone - by_dxcc - by_itu - by_zone + call_dxcc eg: 61,62 (from eg: sh/pre G) + call_itu or: G,GM,GW + call_zone + by_dxcc + by_itu + by_zone origin channel @@ -95,6 +123,7 @@ You can use the tag 'all' to accept everything, eg: but this probably for advanced users... + === 8^ACCEPT/SPOTS [input] [0-9] ^Spot filter sysop version This version allows a sysop to set a filter for a callsign as well as the default for nodes and users eg:- @@ -111,12 +140,12 @@ filter on the following fields:- by eg: G,M,2 origin - origin_dxcc eg: 61,62 (from eg: sh/pre G) - origin_itu - origin_zone - by_dxcc - by_itu - by_zone + origin_dxcc eg: 61,62 (from eg: sh/pre G) + origin_itu or: G,GM,GW + origin_zone + by_dxcc + by_itu + by_zone channel There are no examples because WCY Broadcasts only come from one place and @@ -139,12 +168,12 @@ filter on the following fields:- by eg: G,M,2 origin - origin_dxcc eg: 61,62 (from eg: sh/pre G) - origin_itu - origin_zone - by_dxcc - by_itu - by_zone + origin_dxcc eg: 61,62 (from eg: sh/pre G) + origin_itu or: G,GM,GW + origin_zone + by_dxcc + by_itu + by_zone channel for example @@ -178,6 +207,26 @@ This will send your announcement cluster wide Search the help database for (it isn't case sensitive), and print the names of all the commands that may be relevant. +=== 0^BLANK [] []^Print nn (default 1) blank lines (or strings) +In its basic form this command prints one or more blank lines. However if +you pass it a string it will replicate the string for the width of the +screen (default 80) and then print that one or more times, so: + + blank 2 + +prints two blank lines + + blank - + +prints a row of - characters once. + + blank abc + +prints 'abcabcabcabcabcabc....' + +This is really only of any use in a script file and you can print a maximum +of 9 lines. + === 0^BYE^Exit from the cluster This will disconnect you from the cluster @@ -202,7 +251,27 @@ which will arrange for them to be forward candidates again. Order is not important. -=== 0^CLEAR/SPOTS [1|all]^Clear a spot filter line +=== 0^CLEAR/ANNOUNCE [1|all]^Clear a announce filter line +This command allows you to clear (remove) a line in a annouce filter or to +remove the whole filter. + +see CLEAR/SPOTS for a more detailed explanation. + +=== 8^CLEAR/ANNOUNCE [input] [0-9|all]^Clear a announce filter line +A sysop can clear an input or normal output filter for a user or the +node_default or user_default. + +=== 0^CLEAR/ROUTE [1|all]^Clear a route filter line +This command allows you to clear (remove) a line in a route filter or to +remove the whole filter. + +see CLEAR/SPOTS for a more detailed explanation. + +=== 8^CLEAR/ROUTE [input] [0-9|all]^Clear a route filter line +A sysop can clear an input or normal output filter for a user or the +node_default or user_default. + +=== 0^CLEAR/SPOTS [0-9|all]^Clear a spot filter line This command allows you to clear (remove) a line in a spot filter or to remove the whole filter. @@ -225,12 +294,43 @@ If you do: the filter will be completely removed. +=== 8^CLEAR/SPOTS [input] [0-9|all]^Clear a spot filter line +A sysop can clear an input or normal output filter for a user or the +node_default or user_default. + +=== 0^CLEAR/WCY [1|all]^Clear a WCY filter line +This command allows you to clear (remove) a line in a WCY filter or to +remove the whole filter. + +see CLEAR/SPOTS for a more detailed explanation. + +=== 8^CLEAR/WCY [input] [0-9|all]^Clear a WCY filter line +A sysop can clear an input or normal output filter for a user or the +node_default or user_default. + +=== 0^CLEAR/WWV [1|all]^Clear a WWV filter line +This command allows you to clear (remove) a line in a WWV filter or to +remove the whole filter. + +see CLEAR/SPOTS for a more detailed explanation. + +=== 8^CLEAR/WWV [input] [0-9|all]^Clear a WWV filter line +A sysop can clear an input or normal output filter for a user or the +node_default or user_default. + === 5^CONNECT ^Start a connection to another DX Cluster Start a connection process that will culminate in a new connection to the DX cluster . This process creates a new 'client' process which will use the script in /spider/connect/ to effect the 'chat' exchange necessary to traverse the network(s) to logon to the cluster . +=== 9^DELETE/USER ...^Delete this user from the User Database +This command will completely remove a one or more users from the database. + +There is NO SECOND CHANCE. + +It goes without saying that you should use this command CAREFULLY! + === 0^DBAVAIL^Show a list of all the Databases in the system Title says it all really, this command lists all the databases defined in the system. It is also aliased to SHOW/COMMAND. @@ -341,6 +441,7 @@ in debug mode i.e. perl -d cluster.pl It will interrupt the cluster just after the debug command has finished. + === 0^DIRECTORY^List messages === 0^DIRECTORY ALL^List all messages === 0^DIRECTORY OWN^List your own messages @@ -525,6 +626,12 @@ To remove the filter in its entirty:- clear/spots all +There are similar CLEAR commands for the other filters:- + + clear/announce + clear/wcy + clear/wwv + ADVANCED USERS:- Once you are happy with the results you get, you may like to experiment. @@ -738,7 +845,7 @@ As a sysop you may read any message on the system Create an 'reject this announce' line for a filter. A reject filter line means that if the announce matches this filter it is -passed onto the user. See HELP FILTERS for more info. Please read this +passed onto the user. See HELP FILTERING for more info. Please read this to understand how filters work - it will save a lot of grief later on. You can use any of the following things in this line:- @@ -746,12 +853,12 @@ You can use any of the following things in this line:- info eg: iota or qsl by eg: G,M,2 origin - origin_dxcc eg: 61,62 (from eg: sh/pre G) - origin_itu - origin_zone - by_dxcc - by_itu - by_zone + origin_dxcc eg: 61,62 (from eg: sh/pre G) + origin_itu or: G,GM,GW + origin_zone + by_dxcc + by_itu + by_zone channel wx 1 filter WX announces dest eg: 6MUK,WDX (distros) @@ -778,7 +885,7 @@ default for nodes and users eg:- Create a 'reject this spot' line for a filter. A reject filter line means that if the spot matches this filter it is -dumped (not passed on). See HELP FILTERS for more info. Please read this +dumped (not passed on). See HELP FILTERING for more info. Please read this to understand how filters work - it will save a lot of grief later on. You can use any of the following things in this line:- @@ -788,12 +895,12 @@ You can use any of the following things in this line:- call eg: G,PA,HB9 info eg: iota or qsl by - call_dxcc eg: 61,62 (from eg: sh/pre G) - call_itu - call_zone - by_dxcc - by_itu - by_zone + call_dxcc eg: 61,62 (from eg: sh/pre G) + call_itu or: G,GM,GW + call_zone + by_dxcc + by_itu + by_zone origin channel @@ -814,6 +921,32 @@ You can use the tag 'all' to reject everything eg: but this probably for advanced users... +=== 8^REJECT/ROUTE [0-9] ^Set an 'reject' filter line for routing +Create an 'reject this routing PC Protocol' line for a filter. + +An reject filter line means that if a PC16/17/19/21/24/41/50 matches this filter +it is NOT passed thru that interface. See HELP FILTERING for more info. Please +read this to understand how filters work - it will save a lot of grief later on. + +You can use any of the following things in this line:- + + call the callsign of the thingy + call_dxcc eg: 61,62 (from eg: sh/pre G) + call_itu or: G,GM,GW + call_zone + origin really the interface it came in on + origin_dxcc eg: 61,62 (from eg: sh/pre G) + origin_itu or: G,GM,GW + origin_zone + +some examples:- + + rej/route gb7djk call_dxcc 61,38 (everything except UK+EIRE nodes) + +You can use the tag 'all' to reject everything eg: + + rej/route all (equiv to [very] restricted mode) + === 8^REJECT/SPOTS [input] [0-9] ^Spot filter sysop version This version allows a sysop to set a filter for a callsign as well as the default for nodes and users eg:- @@ -830,12 +963,12 @@ filter on the following fields:- by eg: G,M,2 origin - origin_dxcc eg: 61,62 (from eg: sh/pre G) - origin_itu - origin_zone - by_dxcc - by_itu - by_zone + origin_dxcc eg: 61,62 (from eg: sh/pre G) + origin_itu or: G,GM,GW + origin_zone + by_dxcc + by_itu + by_zone channel There are no examples because WCY Broadcasts only come from one place and @@ -857,12 +990,12 @@ filter on the following fields:- by eg: G,M,2 origin - origin_dxcc eg: 61,62 (from eg: sh/pre G) - origin_itu - origin_zone - by_dxcc - by_itu - by_zone + origin_dxcc eg: 61,62 (from eg: sh/pre G) + origin_itu or: G,GM,GW + origin_zone + by_dxcc + by_itu + by_zone channel for example @@ -924,21 +1057,37 @@ SP is an alias for SEND PRIVATE === 0^SET/ANNOUNCE^Allow announce messages to come out on your terminal === 0^UNSET/ANNOUNCE^Stop announce messages coming out on your terminal +=== 0^SET/ANNTALK^Allow talk like announce messages on your terminal +=== 0^UNSET/ANNTALK^Stop talk like announce messages on your terminal +The announce system on legacy cluster nodes is used as a talk +substitute because the network is so poorly connected. If you: + + unset/anntalk + +you will suppress several of these announces, you may miss the odd +useful one as well, but you would probably miss them anyway in the +welter of useless ones. + + set/anntalk + +allows you to see them again. This is the default. + === 5^SET/ARCLUSTER [..]^Make the callsign an AR-Cluster node -=== 8^SET/BADDX ..^Stop spots for this callsign being propagated -=== 8^UNSET/BADDX ..^Allow spots for this callsign again -Setting a callsign as a 'baddx' will prevent spots of this callsign -going any further. They will not be displayed and they will not be -sent onto other nodes. +=== 8^SET/BADDX ..^Stop callsigns in a dx spot being propagated +=== 8^UNSET/BADDX ..^Propagate a dx spot with this callsign again +Setting a word as 'baddx' will prevent spots with that word in the +'spotted' field (as in: DX 14001.1 FR0G)of a DX spot from going any +further. They will not be displayed and they will not be sent onto +other nodes. -The call must be a full eg:- +The word must be written in full, no wild cards are allowed eg:- - set/baddx FORSALE VIDEO FR0G + set/baddx FORSALE VIDEO FR0G - unset/badnode VIDEO +To allow a word again, use the following command ... -will allow spots to that callsign again. + unset/baddx VIDEO === 8^SET/BADNODE ..^Stop spots from this node being propagated === 8^UNSET/BADNODE ..^Allow spots from this node again @@ -965,26 +1114,54 @@ Setting a callsign as a 'badspotter' will prevent spots from this callsign going any further. They will not be displayed and they will not be sent onto other nodes. -The call must be a full eg:- +The call must be written in full, no wild cards are allowed eg:- set/badspotter VE2STN will stop anything from VE2STN. If you want SSIDs as well then you must enter them specifically. - unset/badnode VE2STN + unset/badspotter VE2STN will allow spots from him again. -Use with extreme care. This command may well be superceeded by FILTERing. +Use with extreme care. This command may well be superceded by FILTERing. + +=== 8^SET/BADWORD ..^Stop things with this word being propagated +=== 8^UNSET/BADWORD ..^Propagate things with this word again +Setting a word as a 'badword' will prevent things like spots, +announces or talks with this word in the the text part from going any +further. They will not be displayed and they will not be sent onto +other nodes. + +The word must be written in full, no wild cards are allowed eg:- + + set/badword annihilate annihilated annihilation + +will stop anything with these words in the text. + + unset/badspotter annihilated + +will allow text with this word again. === 0^SET/BEEP^Add a beep to DX and other messages on your terminal === 0^UNSET/BEEP^Stop beeps for DX and other messages on your terminal +=== 5^SET/BBS [..]^Make the callsign a BBS + === 5^SET/CLX [..]^Make the callsign an CLX node === 9^SET/DEBUG ^Add a debug level to the debug set === 9^UNSET/DEBUG ^Remove a debug level from the debug set +You can choose to log several different levels. The levels are + +chan +state +msg +cron +connect + +You can show what levels you are logging with SHOW/DEBUG === 0^SET/DX^Allow DX messages to come out on your terminal === 0^UNSET/DX^Stop DX messages coming out on your terminal @@ -1019,7 +1196,7 @@ to you will normally find their way there should you not be connected. eg:- SET/HOMENODE gb7djk -=== 8^SET/HOPS ann|spots|wwv|wcy ^Set hop count +=== 8^SET/HOPS ann|spots|route|wwv|wcy ^Set hop count Set the hop count for a particular type of broadcast for a node. This command allows you to set up special hop counts for a node @@ -1138,6 +1315,12 @@ to commands are as default:- If you are a sysop and you come in as a normal user on a remote connection your privilege will automatically be set to 0. +=== 0^UNSET/PRIVILEGE^Remove any privilege for this session +You can use this command to 'protect' this session from unauthorised +use. If you want to get your normal privilege back you will need to +either logout and login again (if you are on a console) or use the +SYSOP command. + === 9^SET/PASSWORD ^Set a users password The password for a user can only be set by a full sysop. The string can contain any characters but any spaces are removed (you can type in @@ -1183,6 +1366,25 @@ for more information. Display all the bad spotter's callsigns in the system, see SET/BADSPOTTER for more information. +=== 1^SHOW/BADWORD^Show all the bad words in the system +Display all the bad words in the system, see SET/BADWORD +for more information. + +=== 0^SHOW/CONFIGURATION []^Show all the nodes and users visible +This command allows you to see all the users that can be seen +and the nodes to which they are connected. + +This command is normally abbreviated to: sh/c + +BE WARNED: the list that is returned can be VERY long + +=== 0^SHOW/CONFIGURATION/NODE^Show all the nodes connected locally +Show all the nodes connected to this node. + +=== 1^SHOW/CONNECT^Show all the active connections +This command shows information on all the active connections known to +the node. This command gives slightly more information than WHO. + === 0^SHOW/DATE [|]^Show the local time This is very nearly the same as SHOW/TIME, the only difference the format of the date string if no arguments are given. @@ -1192,6 +1394,8 @@ time and UTC as the computer has it right now. If you give some prefixes then it will show UTC and UTC + the local offset (not including DST) at the prefixes or callsigns that you specify. +=== 9^SHOW/DEBUG^Show what levels of debug information you are logging + === 0^SHOW/DX^Interrogate the spot database If you just type SHOW/DX you will get the last so many spots (sysop configurable, but usually 10). @@ -1249,6 +1453,9 @@ e.g. SH/DXCC G SH/DXCC W on 20m info iota +=== 0^SHOW/DXSTATS^Show the DX Statistics for last 31 days +Show the total DX spots for the last 31 days + === 0^SHOW/FILES [ []]^List the contents of a filearea SHOW/FILES on its own will show you a list of the various fileareas available on the system. To see the contents of a particular file @@ -1267,7 +1474,13 @@ See also TYPE - to see the contents of a file. Show the contents of all the filters that are set. This command displays all the filters set - for all the various categories. -=== 8^SHOW/HOPS [ann|spots|wcy|wwv]^Show the hop counts for a node +=== 0^SHOW/HFSTATS^Show the HF DX Statistics for last 31 days +Show the HF DX spots breakdown by band for the last 31 days + +=== 0^SHOW/HFTABLE^Show the HF DX Spotter Table for your country +Show the HF DX Spotter table for your country for the last 31 days + +=== 8^SHOW/HOPS [ann|spots|route|wcy|wwv]^Show the hop counts for a node This command shows the hop counts set up for a node. You can specify which category you want to see. If you leave the category out then all the categories will be listed. @@ -1276,6 +1489,11 @@ all the categories will be listed. === 9^SHOW/LOCKOUT^Show the list of locked out or excluded callsigns +=== 8^SHOW/LOG []^Show excerpts from the system log +This command outputs a short section of the system log. On its own +it will output a general logfile. With the optional callsign it will +show output from the log associated with that callsign. + === 0^SHOW/MOON [|]^Show Moon rise and set times Show the Moon rise and set times for a (list of) prefixes or callsigns, together with the azimuth and elevation of the sun currently at those @@ -1431,6 +1649,15 @@ So for example:- SH/SAT AO-10 SH/SAT FENGYUN1 12 2 +=== 6^SHOW/STATION ALL []^Show list of users in the system +=== 0^SHOW/STATION [ ..]^Show information about a callsign +Show the information known about a callsign and whether (and where) +that callsign is connected to the cluster. + + SH/ST G1TLH + +If no callsign is given then show the information for yourself. + === 0^SHOW/SUN [|]^Show sun rise and set times Show the sun rise and set times for a (list of) prefixes or callsigns, together with the azimuth and elevation of the sun currently at those @@ -1454,6 +1681,12 @@ time and UTC as the computer has it right now. If you give some prefixes then it will show UTC and UTC + the local offset (not including DST) at the prefixes or callsigns that you specify. +=== 0^SHOW/VHFSTATS^Show the VHF DX Statistics for last 31 days +Show the VHF DX spots breakdown by band for the last 31 days + +=== 0^SHOW/VHFTABLE^Show the VHF DX Spotter Table for your country +Show the VHF DX Spotter table for your country for the last 31 days + === 0^SHOW/WCY^Show last 10 WCY broadcasts === 0^SHOW/WCY ^Show last WCY broadcasts Display the most recent WCY information that has been received by the system @@ -1487,10 +1720,20 @@ you are on or else for the callsign that you asked for. Only the fields that are defined (in perl term) will be displayed. -=== 5^STAT/MSG ^Show the status of a message +=== 1^STAT/MSG^Show the status of the message system +=== 1^STAT/MSG ^Show the status of a message This command shows the internal status of a message and includes information such as to whom it has been forwarded, its size, origin etc etc. +If no message number is given then the status of the message system is +displayed. + +=== 5^STAT/ROUTE_NODE ^Show the data in a Route::Node object +=== 5^STAT/ROUTE_NODE all^Show list of all Route::Node objects + +=== 5^STAT/ROUTE_USER ^Show the data in a Route::User object +=== 5^STAT/ROUTE_USER all^Show list of all Route::User objects + === 5^STAT/USER []^Show the full status of a user Shows the full contents of a user record including all the secret flags and stuff.