X-Git-Url: http://dxcluster.org/gitweb/gitweb.cgi?a=blobdiff_plain;f=html%2Fadminmanual-8.html;fp=html%2Fadminmanual-8.html;h=ada732b07a7109bef4d4720394577e784fa2972a;hb=e1f91307fae936112a25ed7ce08f47214ecec766;hp=2747eedf3a5d714afe11059072524c72d2e861d3;hpb=f71ce364c08e7e603d69ebfe0a94381a3adccb6c;p=spider.git diff --git a/html/adminmanual-8.html b/html/adminmanual-8.html index 2747eedf..ada732b0 100644 --- a/html/adminmanual-8.html +++ b/html/adminmanual-8.html @@ -2,569 +2,374 @@ - The DXSpider Installation and Administration Manual : Sysop commands + The DXSpider Installation and Administration Manual : Information, files and useful programs + -Next +Next Previous Contents
-

8. Sysop commands

+

8. Information, files and useful programs

-

Most maintenance tasks are automatic but there are some commands that are useful for a sysop. These are listed below in alphabetical order. The number in brackets following the command name is the permissions level needed to use the command. -

-

8.1 announce sysop (5) +

8.1 MOTD

-

announce sysop <text> -

-

Send an announcement to Sysops only +

One of the more important things a cluster sysop needs to do is to get information to his users. The simplest way to do +this is to have a banner that is sent to the user on login. This is know as a "message of the day" or "motd". To set this +up, simply create a file in /spider/data called motd and edit it to say whatever you want. It is purely a text file and +will be sent automatically to anyone logging in to the cluster.

-

8.2 connect (5) +

8.2 Downtime message

-

connect <callsign> Start a connection to another DX Cluster -

-

Start a connection process that will culminate in a new connection to the -DX cluster <callsign>. This process creates a new 'client' process which will -use the script in /spider/connect/<callsign> to effect the 'chat' exchange -necessary to traverse the network(s) to logon to the cluster <callsign>. +

If for any reason the cluster is down, maybe for upgrade or maintenance but the machine is still running, a message can be +sent to the user advising them of the fact. This message lives in the /spider/data directory and is called "offline". Simply +create the file and edit it to say whatever you wish. This file will be sent to a user attempting to log into the cluster +when DXSpider is not actually running.

-

-

8.3 catch (9) +

8.3 Other text messages

-

<node_call> All [<msgno> ...] Mark a message as sent -

-

When you send messages the fact that you have forwarded it to another node -is remembered so that it isn't sent again. When you have a new partner -node and you add their callsign to your /spider/msg/forward.pl file, all -outstanding non-private messages will be forwarded to them. This may well -be ALL the non-private messages. You can prevent this by using these -commmands:- -

catch GB7DJK all -catch GB7DJK 300 301 302 303 -

and to undo what you have just done:- -

uncatch GB7DJK all -uncatch GB7DJK 300 301 302 303 -

which will arrange for them to be forward candidates again. -

-

8.4 dbcreate (9) -

- -

dbcreate <name> Create a database entry
-dbcreate <name> chain <name> [<name>..] Create a chained database entry
-dbcreate <name> remote <node> Create a remote database entry
-

-

DBCREATE allows you to define a database in the system. It doesn't actually -create anything, just defines it. -

The databases that are created are simple DB_File hash databases, they are -therefore already 'indexed'. -

You can define a local database with the first form of the command eg: -

DBCREATE oblast -

You can also chain databases with the addition of the 'chain' keyword. -This will search each database one after the other. A typical example -is: -

DBCREATE sdx_qsl chain sql_ad -

No checking is done to see if the any of the chained databases exist, in -fact it is usually better to do the above statement first then do each of -the chained databases. -

Databases can exist offsite. To define a database that lives on another -node do: -

DBCREATE buckmaster remote gb7dxc -

Remote databases cannot be chained; however, the last database in a -a chain can be a remote database eg: -

DBCREATE qsl chain gb7dxc -

To see what databases have been defined do: -

DBAVAIL (or it will have been aliased to SHOW/COMMAND) -

It would be normal for you to add an entry into your local Aliases file -to allow people to use the 'SHOW/<dbname>' style syntax. So you would -need to add a line like:- +

You can set other text messages to be read by the user if they input the file name. This could be for news items or maybe +information for new users. To set this up, make a directory under /spider called packclus. Under this directory you +can create files called news or newuser for example. In fact you can create files with any names you like. +These can be listed by the user with the command ....

-  's' => [
-    ..
-    ..
-    '^sh\w*/buc', 'dbshow buckmaster', 'dbshow',
-    ..
-    ..
-   ],
+show/files
 
-

to allow -

SH/BUCK g1tlh -

to work as they may be used to. -

See DBIMPORT for the importing of existing AK1A format data to databases. -See DBSHOW for generic database enquiry -

-

8.5 dbimport (9) -

- -

dbimport <dbname> Import AK1A data into a database -

-

If you want to import or update data in bulk to a database you can use -this command. It will either create or update entries into an existing -database. For example:- -

DBIMPORT oblast /tmp/OBLAST.FUL -

will import the standard OBLAST database that comes with AK1A into the -oblast database held locally. -

-

8.6 dbremove (9) -

- -

dbremove <dbname> Delete a database -

-

DBREMOVE will completely remove a database entry and also delete any data -file that is associated with it. -

There is no warning, no comeback, no safety net. -

For example: -

DBREMOVE oblast -

will remove the oblast database from the system and it will also remove -the associated datafile. -

I repeat: -

There is no warning, no comeback, no safety net. -

You have been warned. -

-

8.7 debug (9) -

- -

debug Set the cluster program into debug mode -

-

Executing this command will only have an effect if you are running the cluster -in debug mode i.e. +

They can be read by the user by typing the command ....

-        perl -d cluster.pl
+type news
 
-

It will interrupt the cluster just after the debug command has finished. -

-

8.8 directory (5) -

- -

Works just like the user command except that sysops can see ALL messages. -

-

8.9 disconnect (8) -

- -

disconnect <call> [<call> ...] Disconnect a user or node -

-

Disconnect any <call> connected locally -

-

8.10 export (9) -

- -

export <msgno> <filename> Export a message to a file -

-

Export a message to a file. This command can only be executed on a local -console with a fully privileged user. The file produced will be in a form -ready to be imported back into the cluster by placing it in the import -directory (/spider/msg/import). -

This command cannot overwrite an existing file. This is to provide some -measure of security. Any files written will owned by the same user as the -main cluster, otherwise you can put the new files anywhere the cluster can -access. For example:- -

EXPORT 2345 /tmp/a -

-

8.11 forward/opername (1) -

- -

forward/opername <call> Send out information on this <call> to all clusters -

-

This command sends out any information held in the user file which can -be broadcast in PC41 protocol packets. This information is Name, QTH, Location -and Homenode. PC41s are only sent for the information that is available. -

-

8.12 init (5) -

- -

init <node call> Re-initialise a link to an AK1A compatible node -

-

This command attempts to re-initialise a link to a (usually) AK1A node -that has got confused, usually by a protocol loop of some kind. It may -work - but you usually will be better off simply disconnecting it (or -better, if it is a real AK1A node, doing an RCMD <node> DISC/F <your -node>). -

Best of luck - you will need it. -

-

8.13 kill (5) -

- -

kill <msgno> [<msgno> ...] Remove or erase a message from the system
-kill from <call> Remove all messages from a callsign
-kill to <call> Remove all messages to a callsign
-

-

You can get rid of any message to or originating from your callsign using -this command. You can remove more than one message at a time. -

As a sysop you can kill any message on the system. -

-

8.14 kill full (5) -kill full <msgno> [<msgno>] Delete a message from the whole cluster

- -

Delete a message (usually a 'bulletin') from the whole cluster system. -

This uses the subject field, so any messages that have exactly the same subject -will be deleted. Beware! -

-

8.15 load/aliases (9) -

- -

load/aliases Reload the command alias table -

-

Reload the /spider/cmd/Aliases file after you have editted it. You will need to -do this if you change this file whilst the cluster is running in order for the -changes to take effect. -

-

8.16 load/baddx (9) -load/baddx Reload the bad DX table

- -

Reload the /spider/data/baddx.pl file if you have changed it manually whilst -the cluster is running. This table contains the DX Calls that, if spotted, -will not be passed on. FR0G and TEST are classic examples. -

-

8.17 load/badmsg (9) -

- -

load/badmsg Reload the bad message table -

-

Reload the /spider/msg/badmsg.pl file if you have changed it manually whilst -the cluster is running. This table contains a number of perl regular -expressions which are searched for in the fields targetted of each message. -If any of them match then that message is immediately deleted on receipt. -

-

8.18 load/badwords (9) -

- -

load/badwords Reload the badwords file -

-

Reload the /spider/data/badwords file if you have changed it manually whilst -the cluster is running. This file contains a list of words which, if found -on certain text portions of PC protocol, will cause those protocol frames -to be rejected. It will all put out a message if any of these words are -used on the announce, dx and talk commands. The words can be one or -more on a line, lines starting with '#' are ignored. -

-

8.19 load/bands (9) -

- -

load/bands Reload the band limits table -

-

Reload the /spider/data/bands.pl file if you have changed it manually whilst -the cluster is running. -

-

8.20 load/cmd_cache (9) -

- -

load/cmd_cache Reload the automatic command cache -

-

Normally, if you change a command file in the cmd or local_cmd tree it will -automatially be picked up by the cluster program. Sometimes it can get confused -if you are doing a lot of moving commands about or delete a command in the -local_cmd tree and want to use the normal one again. Execute this command to -reset everything back to the state it was just after a cluster restart. -

-

8.21 load/forward (9) -

- -

load/forward Reload the msg forwarding routing table -

Reload the /spider/msg/forward.pl file if you have changed it -manually whilst the cluster is running. -

-

8.22 load/messages (9) -

- -

load/messages Reload the system messages file -

-

If you change the /spider/perl/Messages file (usually whilst fiddling/writing ne -commands) you can have them take effect during a cluster session by executing this -command. You need to do this if get something like :- -

unknown message 'xxxx' in lang 'en' -

-

8.23 load/prefixes (9) -

- -

load/prefixes Reload the prefix table -

-

Reload the /spider/data/prefix_data.pl file if you have changed it manually whilst -the cluster is running. -

-

8.24 merge (5) -

- -

merge <node> [<no spots>/<no wwv>] Ask for the latest spots and WWV -

-

MERGE allows you to bring your spot and wwv database up to date. By default -it will request the last 10 spots and 5 WWVs from the node you select. The -node must be connected locally. -

You can request any number of spots or wwv and although they will be appended -to your databases they will not duplicate any that have recently been added -(the last 2 days for spots and last month for WWV data). -

-

8.25 msg (9) -

- -

msg <cmd> <msgno> [data ...] Alter various message parameters +

If the file they want to read is called news. You could also set an alias for this in the Alias file to allow them +just to type news

-

Alter message parameters like To, From, Subject, whether private or bulletin -or return receipt (RR) is required or whether to keep this message from timing -out. +

You can also store other information in this directory, either directly or nested under directories. One use for this would +be to store DX bulletins such as the OPDX bulletins. These can be listed and read by the user. To keep things tidy, make a +directory under /spider/packclus called bulletins. Now copy any OPDX or similar bulletins into it. These can be +listed by the user in the same way as above using the show/files command with an extension for the bulletins +directory you have just created, like this ....

-  MSG TO <msgno> <call>     - change TO callsign to <call>
-  MSG FRom <msgno> <call>   - change FROM callsign to <call>
-  MSG PRrivate <msgno>      - set private flag
-  MSG NOPRrivate <msgno>    - unset private flag
-  MSG RR <msgno>            - set RR flag
-  MSG NORR <msgno>          - unset RR flag
-  MSG KEep <msgno>          - set the keep flag (message won't be deleted ever)
-  MSG NOKEep <msgno>        - unset the keep flag
-  MSG SUbject <msgno> <new> - change the subject to <new>
-  MSG WAittime <msgno>      - remove any waitting time for this message
-  MSG NOREad <msgno>        - mark message as unread
-  MSG REad <msgno>          - mark message as read
-  MSG QUeue                 - queue any outstanding bulletins
-  MSG QUeue 1               - queue any outstanding private messages
+show/files bulletins
 
-

You can look at the status of a message by using:- -

STAT/MSG <msgno> -

This will display more information on the message than DIR does.

-

8.26 pc (8) -

- -

pc <call> <text> Send text (eg PC Protocol) to <call> -

-

Send some arbitrary text to a locally connected callsign. No processing is done on -the text. This command allows you to send PC Protocol to unstick things if problems -arise (messages get stuck etc). eg:- -

pc gb7djk PC33^GB7TLH^GB7DJK^400^ -

You can also use in the same way as a talk command to a connected user but -without any processing, added of "from <blah> to <blah>" or whatever. -

pc G1TLH Try doing that properly!!! -

-

8.27 ping (1) -

- -

ping <node> Send a ping command to another cluster node -

-

This command is used to estimate the quality of the link to another cluster. -The time returned is the length of time taken for a PC51 to go to another -cluster and be returned. -

Any visible cluster node can be PINGed. -

-

8.28 rcmd (1) -

- -

rcmd <node call> <cmd> Send a command to another DX cluster -

-

This command allows you to send nearly any command to another DX Cluster -node that is connected to the system. -

Whether you get any output is dependant on a) whether the other system knows -that the node callsign of this cluster is in fact a node b) whether the -other system is allowing RCMDs from this node and c) whether you have -permission to send this command at all. -

-

8.29 read (5) -

- -

read <msgno> Read a message on the system -

-

As a sysop you may read any message on the system -

-

8.30 set/debug (9) -

- -

set/debug <name> Add a debug level to the debug set -

-

You can remove this level with unset/debug <name> -

-

8.31 set/isolate (9) -

- -

set/isolate <node call> Isolate a node from the rest of the network -

-

Connect a node to your system in such a way that you are a full protocol -member of its network and can see all spots on it, but nothing either leaks -out from it nor goes back into from the rest of the nodes connected to you. -

You can potentially connect several nodes in this way. -

You can see which nodes are isolated with the show/isolate (1) command. -

You can remove the isolation with the command unset/isolate. -

-

8.32 set/sys_location (9) -

- -

set/sys_location <lat & long> Set your cluster latitude and longitude -

-

In order to get accurate headings and such like you must tell the system -what your latitude and longitude is. If you have not yet done a SET/QRA -then this command will set your QRA locator for you. For example:- -

SET/LOCATION 52 22 N 0 57 E -

-

8.33 set/lockout (9) -

- -

set/lockout <call> Stop a callsign connecting to the cluster -

-

You can show who is locked out with the show/lockout (9) command. -

To allow the user to connect again, use the command unset/lockout -

-

8.34 set/node (9) -

- -

set/node <call> [<call> ...] Make the callsign an AK1A cluster -

-

Tell the system that the call(s) are to be treated as AK1A cluster and -fed PC Protocol rather normal user commands. -

From version 1.41 you can also set the following types of cluster +

An example would look like this ....

+

-set/spider
-set/dxnet
-set/clx
-set/arcluster
+sh/files
+bulletins      DIR 20-Dec-1999 1715Z news          1602 14-Dec-1999 1330Z
 
-

To see what your nodes are set to, use the show/nodes command. -

-

8.35 set/obscount (9) -

- -

set/obscount <count> <node call> Set the 'pump-up' obscelence counter -

-

From version 1.35 onwards neighbouring nodes are pinged at regular intervals (see -SET/PINGINTERVAL), usually 300 seconds or 5 minutes. There is a 'pump-up' -counter which is decremented on every outgoing ping and then reset to -the 'obscount' value on every incoming ping. The default value of this -parameter is 2. -

What this means is that a neighbouring node will be pinged twice at -(default) 300 second intervals and if no reply has been heard just before -what would be the third attempt, that node is disconnected. -

If a ping is heard then the obscount is reset to the full value. Using -default values, if a node has not responded to a ping within 15 minutes, -it is disconnected. -

-

8.36 set/pinginterval (9) -

- -

set/pinginterval <time> <node call> Set the ping time to neighbouring nodes -

-

As from version 1.35 all neighbouring nodes are pinged at regular intervals -in order to determine the rolling quality of the link and, in future, to -affect routing decisions. The default interval is 300 secs or 5 minutes. -

You can use this command to set a different interval. Please don't. -

But if you do the value you enter is treated as minutes up 60 and seconds -for numbers greater than that. -

This is used also to help determine when a link is down at the far end -(as certain cluster software doesn't always notice), see SET/OBSCOUNT -for more information. -

-

8.37 set/privilege (9) -

- -

set/privilege <n> <call> [<call> ...] Set the privilege level on a call -

-

Set the privilege level on a callsign. The privilege levels that pertain -to commands are as default:- +

+

You can see that in the files area (basically the packclus directory) there is a file called news and a directory +called bulletins. You can also see that dates they were created. In the case of the file news, you can +also see the time it was last modified, a good clue as to whether the file has been updated since you last read it. To read +the file called news you would simply issue the command ....

-  0 - normal user
-  1 - allow remote nodes normal user RCMDs
-  5 - various privileged commands (including shutdown, but not disc-
-      connect), the normal level for another node.
-  8 - more privileged commands (including disconnect)
-  9 - local sysop privilege. DO NOT SET ANY REMOTE USER OR NODE TO THIS
-      LEVEL.
+type news
 
-

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. -

-

8.38 set/password (9) -

- -

set/password <callsign> <string> 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 -spaces - but they won't appear in the password). You can see the -result with STAT/USER. The password is the usual 30 character baycom -type password. -

-

8.39 set/sys_qra (9) -

- -

set/sys_qra <locator> Set your cluster QRA locator +

To look what is in the bulletins directory you issue the command ....

-

8.40 show program (5) -

- -

show/program Show the locations of all the included program modules +

+
+show/files bulletins
+opdx390      21381 29-Nov-1999 1621Z opdx390.1     1670 29-Nov-1999 1621Z
+opdx390.2     2193 29-Nov-1999 1621Z opdx391      25045 29-Nov-1999 1621Z  
+opdx392      35969 29-Nov-1999 1621Z opdx393      15023 29-Nov-1999 1621Z  
+opdx394      33429 29-Nov-1999 1621Z opdx394.1     3116 29-Nov-1999 1621Z  
+opdx395      24319 29-Nov-1999 1621Z opdx396      32647 29-Nov-1999 1621Z
+opdx396.1     5537 29-Nov-1999 1621Z opdx396.2     6242 29-Nov-1999 1621Z
+opdx397      18433 29-Nov-1999 1621Z opdx398      19961 29-Nov-1999 1621Z  
+opdx399      17719 29-Nov-1999 1621Z opdx400      19600 29-Nov-1999 1621Z
+opdx401      27738 29-Nov-1999 1621Z opdx402      18698 29-Nov-1999 1621Z
+opdx403      24994 29-Nov-1999 1621Z opdx404      15685 29-Nov-1999 1621Z
+opdx405      13984 29-Nov-1999 1621Z opdx405.1     4166 29-Nov-1999 1621Z
+opdx406      28934 29-Nov-1999 1621Z opdx407      24153 29-Nov-1999 1621Z
+opdx408      15081 29-Nov-1999 1621Z opdx409      23234 29-Nov-1999 1621Z
+Press Enter to continue, A to abort (16 lines) >
+
+
+

You can now read any file in this directory using the type command, like this ....

-

Show the name and location where every program module was load from. This -is useful for checking where you think you have loaded a .pm file from. +

+
+type bulletins/opdx391
+Ohio/Penn DX Bulletin No. 391
+The Ohio/Penn Dx PacketCluster
+DX Bulletin No. 391
+BID: $OPDX.391
+January 11, 1999
+Editor Tedd Mirgliotta, KB8NW
+Provided by BARF-80 BBS Cleveland, Ohio
+Online at 440-237-8208 28.8k-1200 Baud 8/N/1 (New Area Code!)
+Thanks to the Northern Ohio Amateur Radio Society, Northern Ohio DX
+Association, Ohio/Penn PacketCluster Network, K1XN & Golist, WB2RAJ/WB2YQH
+& The 59(9) DXReport, W3UR & The Daily DX, K3TEJ, KN4UG, W4DC, NC6J, N6HR,
+Press Enter to continue, A to abort (508 lines) >
+
+
+

The page length will of course depend on what you have it set to!

-

8.41 shutdown (5) +

8.4 The Aliases file

-

shutdown Shutdown the cluster -

-

Shutdown the cluster and disconnect all the users. If you have Spider -set to respawn in /etc/inittab it will of course restart. +

You will find a file in /spider/cmd/ called Aliases. First, copy this file to /spider/local_cmd/Aliases and edit this file. +You will see something like this ...

-

8.42 spoof (9) -

+
+
 
-

spoof <callsign> <command> Run commands as another user -

-

This is a very simple yet powerful command for the sysop. It allows you to -issue commands as if you were a different user. This is very useful for the -kind of things that users seem to always get wrong.. like home_node for -example. +#!/usr/bin/perl + +# provide some standard aliases for commands for terminally +# helpless ak1a user (helpless in the sense that they never +# read nor understand help files) + +# This file is automagically reloaded if its modification time is +# later than the one stored in CmdAlias.pm + +# PLEASE make this file consistant with reality! (the patterns MUST +# match the filenames!) + +# Don't alter this file, copy it into the local_cmd tree and modify it. +# This file will be replaced everytime I issue a new release. + +# You only need to put aliases in here for commands that don't work as +# you desire naturally, e.g sh/dx on its own just works as you expect +# so you need not add it as an alias. + + + +package CmdAlias; + +%alias = ( + '?' => [ + '^\?', 'apropos', 'apropos', + ], + 'a' => [ + '^ann.*/full', 'announce full', 'announce', + '^ann.*/sysop', 'announce sysop', 'announce', + '^ann.*/(.*)$', 'announce $1', 'announce', + ], + 'b' => [ + ], + 'c' => [ + ], + 'd' => [ + '^del', 'kill', 'kill', + '^del\w*/fu', 'kill full', 'kill', + '^di\w*/a\w*', 'directory all', 'directory', + '^di\w*/b\w*', 'directory bulletins', 'directory', + '^di\w*/n\w*', 'directory new', 'directory', + '^di\w*/o\w*', 'directory own', 'directory', + '^di\w*/s\w*', 'directory subject', 'directory', + '^di\w*/t\w*', 'directory to', 'directory', + '^di\w*/f\w*', 'directory from', 'directory', + '^di\w*/(\d+)', 'directory $1', 'directory', + ], + 'e' => [ + ], + 'f' => [ + ], + 'g' => [ + ], + 'h' => [ + ], + 'i' => [ + ], + 'j' => [ + ], + 'k' => [ + ], + 'l' => [ + '^l$', 'directory', 'directory', + '^ll$', 'directory', 'directory', + '^ll/(\d+)', 'directory $1', 'directory', + ], + 'm' => [ + ], + 'n' => [ + '^news', 'type news', 'type', + ], + 'o' => [ + ], + 'p' => [ + ], + 'q' => [ + '^q', 'bye', 'bye', + ], + 'r' => [ + '^r$', 'read', 'read', + '^rcmd/(\S+)', 'rcmd $1', 'rcmd', + ], + 's' => [ + '^s/p$', 'send', 'send', + '^sb$', 'send noprivate', 'send', + '^set/home$', 'set/homenode', 'set/homenode', + '^set/nobe', 'unset/beep', 'unset/beep', + '^set/nohe', 'unset/here', 'unset/here', + '^set/noan', 'unset/announce', 'unset/announce', + '^set/nodx', 'unset/dx', 'unset/dx', + '^set/nota', 'unset/talk', 'unset/talk', + '^set/noww', 'unset/wwv', 'unset/wwv', + '^set/nowx', 'unset/wx', 'unset/wx', + '^sh$', 'show', 'show', + '^sh\w*/buck', 'dbshow buck', 'dbshow', + '^sh\w*/bu', 'show/files bulletins', 'show/files', + '^sh\w*/c/n', 'show/configuration nodes', 'show/configuration', + '^sh\w*/c$', 'show/configuration', 'show/configuration', + '^sh\w*/com', 'dbavail', 'dbavail', + '^sh\w*/dx/(\d+)-(\d+)', 'show/dx $1-$2', 'show/dx', + '^sh\w*/dx/(\d+)', 'show/dx $1', 'show/dx', + '^sh\w*/dx/d(\d+)', 'show/dx from $1', 'show/dx', + '^sh\w*/email', 'dbshow email', 'dbshow', + '^sh\w*/hftest', 'dbshow hftest', 'dbshow', + '^sh\w*/vhftest', 'dbshow vhftest', 'dbshow', + '^sh\w*/qsl', 'dbshow qsl', 'dbshow', + '^sh\w*/tnc', 'who', 'who', + '^sh\w*/up', 'show/cluster', 'show/cluster', + '^sh\w*/w\w*/(\d+)-(\d+)', 'show/wwv $1-$2', 'show/wwv', + '^sh\w*/w\w*/(\d+)', 'show/wwv $1', 'show/wwv', + '^sp$', 'send', 'send', + + ], + 't' => [ + '^ta$', 'talk', 'talk', + '^t$', 'talk', 'talk', + ], + 'u' => [ + ], + 'v' => [ + ], + 'w' => [ + '^wx/full', 'wx full', 'wx', + '^wx/sysop', 'wx sysop', 'wx', + ], + 'x' => [ + ], + 'y' => [ + ], + 'z' => [ + ], +) +

+
+

You can create aliases for commands at will. Beware though, these may not always turn out as you think. Care is needed +and you need to test the results once you have set an alias.

-

8.43 stat/db (5) +

8.5 Forward.pl

-

stat/db <dbname> Show the status of a database -

-

Show the internal status of a database descriptor. -

Depending on your privilege level you will see more or less information. -This command is unlikely to be of much use to anyone other than a sysop. +

DXSpider receives all and any mail sent to it without any alterations needed +in files. Because personal and bulletin mail are treated differently, there +is no need for a list of accepted bulletin addresses. It is necessary, however, +to tell the program which links accept which bulletins. For example, it is +pointless sending bulletins addresses to "UK" to any links other than UK +ones. The file that does this is called forward.pl and lives in /spider/msg. +At default, like other spider files it is named forward.pl.issue. Rename it +to forward.pl and edit the file to match your requirements. +The format is below ...

-

8.44 stat/channel (5) -

- -

stat/channel <callsign> Show the status of a channel on the cluster +

+
+#
+# this is an example message forwarding file for the system
+#
+# The format of each line is as follows
+#
+#     type    to/from/at pattern action  destinations
+#     P/B/F     T/F/A     regex   I/F    [ call [, call ...] ]
+#
+# type: P - private, B - bulletin (msg), F - file (ak1a bull)
+# to/from/at: T - to field, F - from field, A - home bbs, O - origin 
+# pattern: a perl regex on the field requested
+# action: I - ignore, F - forward
+# destinations: a reference to an array containing node callsigns
+#
+# if it is non-private and isn't in here then it won't get forwarded 
+#
+# Currently only type B msgs are affected by this code.
+# 
+# The list is read from the top down, the first pattern that matches
+# causes the action to be taken.
+#
+# The pattern can be undef or 0 in which case it will always be selected
+# for the action specified
+#
+# If the BBS list is undef or 0 and the action is 'F' (and it matches the
+# pattern) then it will always be forwarded to every node that doesn't have 
+# it (I strongly recommend you don't use this unless you REALLY mean it, if
+# you allow a new link with this on EVERY bull will be forwarded immediately
+# on first connection)
+#
+
+package DXMsg;
+
+@forward = (
+'B',    'T',    'LOCAL',        'F',    [ qw(GB7MBC) ],
+'B',    'T',    'ALL',          'F',    [ qw(GB7BAA GB7ADX PA4AB-14) ],
+'B',    'T',    'UK',           'F',    [ qw(GB7BAA GB7ADX) ],
+'B',    'T',    'QSL',          'F',    [ qw(GB7BAA GB7ADX PA4AB-14) ],
+'B',    'T',    'QSLINF',       'F',    [ qw(GB7BAA GB7ADX PA4AB-14) ],
+'B',    'T',    'DX',           'F',    [ qw(GB7BAA GB7ADX PA4AB-14) ],
+'B',    'T',    'DXINFO',       'F',    [ qw(GB7BAA GB7ADX PA4AB-14) ],
+'B',    'T',    'DXNEWS',       'F',    [ qw(GB7BAA GB7ADX PA4AB-14) ],
+'B',    'T',    'DXQSL',        'F',    [ qw(GB7BAA GB7ADX PA4AB-14) ],
+'B',    'T',    'SYSOP',        'F',    [ qw(GB7BAA GB7ADX) ],
+'B',    'T',    '50MHZ',        'F',    [ qw(GB7BAA GB7ADX PA4AB-14) ],
+);
+
+
+

Simply insert a bulletin address and state in the brackets where you wish +that mail to go. For example, you can see here that mail sent to "UK" will +only be sent to the UK links and not to PA4AB-14.

-

Show the internal status of the channel object either for the channel that -you are on or else for the callsign that you asked for. -

Only the fields that are defined (in perl term) will be displayed. +

To force the cluster to reread the file use load/forward

-

8.45 stat/msg (5) +

8.6 Distribution lists

-

stat/msg <msgno> Show the status of a message +

Distribution lists are simply a list of users to send certain types of +mail to. An example of this is mail you only wish to send to other +sysops. In /spider/msg there is a directory called distro. You +put any distibution lists in here. For example, here is a file called +SYSOP.pl that caters for the UK sysops.

-

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. +

+
+qw(GB7TLH GB7DJK GB7DXM GB7CDX GB7BPQ GB7DXN GB7MBC GB7MBC-6 GB7MDX
+   GB7NDX GB7SDX GB7TDX GB7UDX GB7YDX GB7ADX GB7BAA GB7DXA GB7DXH 
+   GB7DXK GB7DXI GB7DXS)
+
+
+

Any mail sent to "sysop" would only be sent to the callsigns in this list.

-

8.46 stat/user (5) +

8.7 Console.pl

-

stat/user <callsign> Show the full status of a user -

-

Shows the full contents of a user record including all the secret flags -and stuff. -

Only the fields that are defined (in perl term) will be displayed. -

+

In later versions of Spider a simple console program is provided for the sysop. This has a type ahead buffer with line +editing facilities and colour for spots, announces etc. +To use this program, simply use console.pl instead of client.pl.

+

To edit the colours, copy /spider/perl/Console.pl to /spider/local and edit the file with your favourite editor.


-Next +Next Previous Contents