From 952bc2f3d0ec7c7aa441ade9e75647a8e41270a1 Mon Sep 17 00:00:00 2001 From: g0vgs Date: Wed, 3 Jan 2001 22:57:30 +0000 Subject: [PATCH] Various documentation changes --- Changes | 1 + cmd/Commands_en.hlp | 16 ++-- html/adminmanual-1.html | 2 +- html/adminmanual.html | 35 +++---- sgml/adminmanual.sgml | 28 ++++-- txt/adminmanual.txt | 196 ++++++++++++++++++++-------------------- 6 files changed, 146 insertions(+), 132 deletions(-) diff --git a/Changes b/Changes index 96f875e4..bc179e72 100644 --- a/Changes +++ b/Changes @@ -1,5 +1,6 @@ 03Jan01======================================================================= 1. Added a txt directory for txt versions of manuals (g0vgs) +2. Various documentation changes 02Jan01======================================================================= 1. added a help file for forward/latlong and updated the admin manual to match. (g0vgs) diff --git a/cmd/Commands_en.hlp b/cmd/Commands_en.hlp index 257e1713..463d55e8 100644 --- a/cmd/Commands_en.hlp +++ b/cmd/Commands_en.hlp @@ -695,11 +695,6 @@ etc). eg:- or pc G1TLH Try doing that properly!!! -=== 1^PING ^Send a ping command to another cluster -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. - === 0^KILL [ ...]^Remove or erase a message from the system 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. @@ -720,10 +715,11 @@ PC protocol to connected nodes either for testing or to unstick things. You can also use in the same way as a talk command to a connected user but without any processing, added of "from to ^Find out the delays an a circuit to another node -This command will enable sysops to determine the speed of an inter-cluster -node. - +=== 1^PING ^Check the link quality between nodes +This command allows you to send a frame to another cluster node on +the network and get a return frame. The time it takes to do this +is a good indication of the quality of the link. The actual time +it takes is output to the console in seconds. Any visible cluster node can be PINGed. === 1^RCMD ^Send a command to another DX Cluster @@ -1353,7 +1349,7 @@ is provided for users of this software by http://www.qrz.com === 0^SHOW/ROUTE ...^Show the route to the callsign This command allows you to see which node the callsigns specified are -connected via. It is a sort of inverse sh/config. +connected. It is a sort of inverse sh/config. sh/route n2tly diff --git a/html/adminmanual-1.html b/html/adminmanual-1.html index cb0de65a..be8797f9 100644 --- a/html/adminmanual-1.html +++ b/html/adminmanual-1.html @@ -14,7 +14,7 @@ Previous

1. Installation (Original version by Iain Phillips, G0RDI)

-

Last modified: 02 January 2001 by Ian Maude, G0VGS +

Last modified: 03 January 2001 by Ian Maude, G0VGS

1.1 Introduction

diff --git a/html/adminmanual.html b/html/adminmanual.html index 86355288..d5fd935d 100644 --- a/html/adminmanual.html +++ b/html/adminmanual.html @@ -215,23 +215,24 @@ Contents
  • 11.112 show/program (5)
  • 11.113 show/qra (0)
  • 11.114 show/qrz (0) -
  • 11.115 show/satellite (0) -
  • 11.116 show/sun (0) -
  • 11.117 show/time (0) -
  • 11.118 show/wcy (0) -
  • 11.119 show/wwv (0) -
  • 11.120 shutdown (5) -
  • 11.121 spoof (9) -
  • 11.122 stat/db (5) -
  • 11.123 stat/channel (5) -
  • 11.124 stat/msg (5) -
  • 11.125 stat/user (5) -
  • 11.126 sysop (0) -
  • 11.127 talk (0) -
  • 11.128 type (0) -
  • 11.129 who (0) -
  • 11.130 wx (0) -
  • 11.131 wx (enhanced for sysops) (5) +
  • 11.115 show/route (0) +
  • 11.116 show/satellite (0) +
  • 11.117 show/sun (0) +
  • 11.118 show/time (0) +
  • 11.119 show/wcy (0) +
  • 11.120 show/wwv (0) +
  • 11.121 shutdown (5) +
  • 11.122 spoof (9) +
  • 11.123 stat/db (5) +
  • 11.124 stat/channel (5) +
  • 11.125 stat/msg (5) +
  • 11.126 stat/user (5) +
  • 11.127 sysop (0) +
  • 11.128 talk (0) +
  • 11.129 type (0) +
  • 11.130 who (0) +
  • 11.131 wx (0) +
  • 11.132 wx (enhanced for sysops) (5)
    Next diff --git a/sgml/adminmanual.sgml b/sgml/adminmanual.sgml index bd485b41..5ed2033b 100644 --- a/sgml/adminmanual.sgml +++ b/sgml/adminmanual.sgml @@ -19,7 +19,7 @@ A reference for SysOps of the DXSpider DXCluster program. Installation (Original version by Iain Phillips, G0RDI)

    -Last modified: 02 January 2001 by Ian Maude, G0VGS +Last modified: 03 January 2001 by Ian Maude, G0VGS Introduction @@ -2771,16 +2771,17 @@ without any processing, added of "from <blah> to <blah>" or whatever

    -ping <node> Send a ping command to another cluster node +ping <node> Check the link quality between nodes

    -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. - +his command allows you to send a frame to another cluster node on +the network and get a return frame. The time it takes to do this +is a good indication of the quality of the link. The actual time +it takes is output to the console in seconds. Any visible cluster node can be PINGed. + rcmd (1)

    @@ -4007,6 +4008,21 @@ This command queries the QRZ callbook server on the internet and returns any information available for that callsign. This service is provided for users of this software by http://www.qrz.com +show/route (0) + +

    + +show/route <callsign> Show the route to <callsign> + + +

    +This command allows you to see which node the callsigns specified are +connected. It is a sort of inverse sh/config. + + + sh/route n2tly + + show/satellite (0)

    diff --git a/txt/adminmanual.txt b/txt/adminmanual.txt index 1ffba6a8..ac193f58 100644 --- a/txt/adminmanual.txt +++ b/txt/adminmanual.txt @@ -241,30 +241,32 @@ 11.112 show/program (5) 11.113 show/qra (0) 11.114 show/qrz (0) - 11.115 show/satellite (0) - 11.116 show/sun (0) - 11.117 show/time (0) - 11.118 show/wcy (0) - 11.119 show/wwv (0) - 11.120 shutdown (5) - 11.121 spoof (9) - 11.122 stat/db (5) - 11.123 stat/channel (5) - 11.124 stat/msg (5) - 11.125 stat/user (5) - 11.126 sysop (0) - 11.127 talk (0) - 11.128 type (0) - 11.129 who (0) - 11.130 wx (0) - 11.131 wx (enhanced for sysops) (5) + 11.115 show/route (0) + 11.116 show/satellite (0) + 11.117 show/sun (0) + 11.118 show/time (0) + 11.119 show/wcy (0) + 11.120 show/wwv (0) + 11.121 shutdown (5) + 11.122 spoof (9) + 11.123 stat/db (5) + 11.124 stat/channel (5) + 11.125 stat/msg (5) + 11.126 stat/user (5) + 11.127 sysop (0) + 11.128 talk (0) + 11.129 type (0) + 11.130 who (0) + 11.131 wx (0) + 11.132 wx (enhanced for sysops) (5) + ______________________________________________________________________ 11.. IInnssttaallllaattiioonn ((OOrriiggiinnaall vveerrssiioonn bbyy IIaaiinn PPhhiilllliippss,, GG00RRDDII)) - Last modified: 02 January 2001 by Ian Maude, G0VGS + Last modified: 03 January 2001 by Ian Maude, G0VGS 11..11.. IInnttrroodduuccttiioonn @@ -328,6 +330,10 @@ _s_y_s_o_p. You can call it anything you wish. Depending on your security requirements you may wish to use an existing user, however this is your own choice. + + + + # adduser -m sysop @@ -388,10 +394,6 @@ # find . -type d -exec chmod 2775 {} \; # find . -type f -exec chmod 775 {} \; - - - - This last step allows various users of the group _s_p_i_d_e_r to have write access to all the directories. This is not really needed just yet but will be useful when web interfaces start to appear. @@ -458,7 +460,11 @@ - $ cd ../perl + $ cd ../perl + + + + Now type the following command which creates the basic user file with you as the sysop. @@ -520,10 +526,10 @@ If you do, congratulations! If not, look over the instructions again, you have probably missed something out. You can shut spider down again with the command .... + shutdown - shutdown and both the cluster and the client should return to Linux prompts. @@ -586,7 +592,8 @@ - killall -HUP inetd + killall -HUP inetd + @@ -658,7 +665,7 @@ - set/node gb7baa + set/node gb7baa @@ -717,13 +724,6 @@ - - - - - - - # All lines starting with a # are ignored, as are completely blank lines. @@ -3278,14 +3278,15 @@ 1111..4499.. ppiinngg ((11)) - ppiinngg <> Send a ping command to another cluster node + ppiinngg <> Check the link quality between nodes - 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. + his command allows you to send a frame to another cluster node on the + network and get a return frame. The time it takes to do this is a + good indication of the quality of the link. The actual time it takes + is output to the console in seconds. Any visible cluster node can be + PINGed. - Any visible cluster node can be PINGed. 1111..5500.. rrccmmdd ((11)) @@ -3296,6 +3297,7 @@ 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) @@ -3361,9 +3363,11 @@ You can use the tag 'all' to reject everything eg: + rej/ann all + but this probably for advanced users... @@ -3424,12 +3428,13 @@ some examples:- + + rej/spot 1 on hf rej/spot 2 on vhf and not (by_zone 14,15,16 or call_zone 14,15,16) - You can use the tag 'all' to reject everything eg: @@ -3489,13 +3494,14 @@ See HELP FILTER for information. + + 1111..5588.. rreejjeecctt//wwccyy ((eexxtteennddeedd ffoorr ssyyssooppss)) ((88)) rreejjeecctt//wwccyy <> [[iinnppuutt]] [[00--99]] <> WCY reject 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:- @@ -3554,6 +3560,8 @@ + + 1111..6611.. rreeppllyy ((00)) rreeppllyy Reply (privately) to the last message that you have read @@ -3562,6 +3570,7 @@ rreeppllyy NNOOPPrriivvaattee <> Reply as a Bulletin to the specified message rreeppllyy RRRR <> Reply to the specified message with read receipt + You can reply to a message and the subject will automatically have "Re:" inserted in front of it, if it isn't already present. @@ -3618,6 +3627,7 @@ Allow announce messages to arrive at your terminal. + 1111..6655.. sseett//aarrcclluusstteerr ((55)) sseett//aarrcclluusstteerr <> [[<> ......]] Make the node_call an AR- @@ -3627,7 +3637,6 @@ Set the node_call as an AR-Cluster type node - 1111..6666.. sseett//bbaaddnnooddee ((66)) sseett//bbaaddnnooddee <> Stop spots from this node_call being @@ -3683,6 +3692,8 @@ You can remove this level with unset/debug + + 1111..7700.. sseett//ddxx ((00)) sseett//ddxxAllow DX messages to arrive at your terminal @@ -3691,9 +3702,6 @@ You can stop DX messages with the _u_n_s_e_t_/_d_x command - - - 1111..7711.. sseett//ddxxggrriidd ((00)) sseett//ddxxggrriiddAllow grid squares on the end of DX messages @@ -3751,6 +3759,7 @@ connected. eg:- + SET/HOMENODE gb7djk @@ -3760,6 +3769,7 @@ sseett//hhooppss <> aannnn||ssppoottss||wwwwvv||wwccyy <> 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 for @@ -3816,8 +3826,6 @@ - - 1111..8800.. sseett//ssyyss__llooccaattiioonn ((99)) sseett//ssyyss__llooccaattiioonn <> Set your cluster latitude and longitude @@ -3892,6 +3900,7 @@ sseett//oobbssccoouunntt <> <> Set the 'pump-up' obsolescence 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 @@ -3958,6 +3967,7 @@ (as certain cluster software doesn't always notice), see SET/OBSCOUNT for more information. + 1111..8899.. sseett//pprriivviilleeggee ((99)) sseett//pprriivviilleeggee <> <> [[<> ......]] Set the privilege level on a @@ -4013,6 +4023,7 @@ + 1111..9933.. sseett//qqtthh ((00)) sseett//qqtthh <> Set your QTH @@ -4024,6 +4035,8 @@ set/qth East Dereham, Norfolk + + 1111..9944.. sseett//ttaallkk ((00)) sseett//ttaallkk Allow talk messages to be seen at your console @@ -4090,6 +4103,7 @@ If you just type SHOW/DX you will get the last so many spots (sysop configurable, but usually 10). + In addition you can add any number of these options in very nearly any order to the basic SHOW/DX command, they are:- @@ -4155,7 +4169,6 @@ - SH/DXCC G SH/DXCC W on 20m info iota @@ -4207,6 +4220,8 @@ A sysop can look at any filters that have been set. + + 1111..110055.. sshhooww//hhooppss ((88)) sshhooww//hhooppss <> [[aannnn||ssppoottss||wwccyy||wwwwvv||]] Show the hop counts for a @@ -4222,6 +4237,7 @@ sshhooww//iissoollaattee Show a list of isolated nodes + Show which nodes are currently set to be isolated. @@ -4272,7 +4288,6 @@ station with the prefix you have specified. The output assumes a modest power of 20dBW and receiver sensitivity of -123dBm (about 0.15muV/10dB SINAD) - The result predicts the most likely operating frequencies and signal levels for high frequency (shortwave) radio propagation paths on specified days of the year and hours of the day. It is most useful for @@ -4287,7 +4302,6 @@ than the programs used by major shortwave broadcasting organizations, such as the Voice of America. - The command will display some header information detailing its assumptions, together with the locations, latitude and longitudes and bearings. It will then show UTC (UT), local time at the other end @@ -4339,6 +4353,7 @@ propagation data. + SH/MUF W L 24 SH/MUF W 24 Long @@ -4425,7 +4440,21 @@ provided for users of this software by http://www.qrz.com - 1111..111155.. sshhooww//ssaatteelllliittee ((00)) + 1111..111155.. sshhooww//rroouuttee ((00)) + + sshhooww//rroouuttee <> Show the route to + + + This command allows you to see which node the callsigns specified are + connected. It is a sort of inverse sh/config. + + + sh/route n2tly + + + + + 1111..111166.. sshhooww//ssaatteelllliittee ((00)) sshhooww//ssaatteelllliittee <> [[<> <>]] Show satellite tracking data @@ -4456,7 +4485,8 @@ - 1111..111166.. sshhooww//ssuunn ((00)) + + 1111..111177.. sshhooww//ssuunn ((00)) sshhooww//ssuunn [[<>||<>]] Show sun rise and set times @@ -4481,7 +4511,7 @@ - 1111..111177.. sshhooww//ttiimmee ((00)) + 1111..111188.. sshhooww//ttiimmee ((00)) sshhooww//ttiimmee [[<>||<>]] Show the local time @@ -4492,7 +4522,7 @@ including DST) at the prefixes or callsigns that you specify. - 1111..111188.. sshhooww//wwccyy ((00)) + 1111..111199.. sshhooww//wwccyy ((00)) sshhooww//wwccyy Show the last 10 WCY broadcasts sshhooww//wwccyy <> Show the last WCY broadcasts @@ -4502,7 +4532,7 @@ system - 1111..111199.. sshhooww//wwwwvv ((00)) + 1111..112200.. sshhooww//wwwwvv ((00)) sshhooww//wwwwvv Show the last 10 WWV broadcasts sshhooww//wwwwvv <> Show the last WWV broadcasts @@ -4513,7 +4543,7 @@ - 1111..112200.. sshhuuttddoowwnn ((55)) + 1111..112211.. sshhuuttddoowwnn ((55)) sshhuuttddoowwnn Shutdown the cluster @@ -4522,7 +4552,7 @@ set to respawn in /etc/inittab it will of course restart. - 1111..112211.. ssppooooff ((99)) + 1111..112222.. ssppooooff ((99)) ssppooooff <> <> Run commands as another user @@ -4533,7 +4563,7 @@ like home_node for example. - 1111..112222.. ssttaatt//ddbb ((55)) + 1111..112233.. ssttaatt//ddbb ((55)) ssttaatt//ddbb <> Show the status of a database @@ -4545,17 +4575,18 @@ other than a sysop. - 1111..112233.. ssttaatt//cchhaannnneell ((55)) + 1111..112244.. ssttaatt//cchhaannnneell ((55)) ssttaatt//cchhaannnneell <> Show the status of a channel on the cluster 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. - 1111..112244.. ssttaatt//mmssgg ((55)) + 1111..112255.. ssttaatt//mmssgg ((55)) ssttaatt//mmssgg <> Show the status of a message @@ -4565,7 +4596,7 @@ etc etc. - 1111..112255.. ssttaatt//uusseerr ((55)) + 1111..112266.. ssttaatt//uusseerr ((55)) ssttaatt//uusseerr <> Show the full status of a user @@ -4576,7 +4607,7 @@ Only the fields that are defined (in perl term) will be displayed. - 1111..112266.. ssyyssoopp ((00)) + 1111..112277.. ssyyssoopp ((00)) ssyyssoopp Regain your privileges if you login remotely @@ -4587,7 +4618,6 @@ numbers are returned that are indexes into the character array that is your assigned password (see SET/PASSWORD). The indexes start from zero. - You are expected to return a string which contains the characters required in the correct order. You may intersperse those characters with others to obscure your reply for any watchers. For example (and @@ -4614,7 +4644,7 @@ case sensitive. - 1111..112277.. ttaallkk ((00)) + 1111..112288.. ttaallkk ((00)) ttaallkk <> Enter talk mode with ttaallkk <> <> Send a text message to @@ -4653,6 +4683,7 @@ + To leave talk mode type: @@ -4661,7 +4692,7 @@ - 1111..112288.. ttyyppee ((00)) + 1111..112299.. ttyyppee ((00)) ttyyppee <>//<> Look at a file in one of the fileareas @@ -4679,7 +4710,7 @@ content. - 1111..112299.. wwhhoo ((00)) + 1111..113300.. wwhhoo ((00)) wwhhoo Show who is physically connected locally @@ -4688,7 +4719,7 @@ what sort of connection they have - 1111..113300.. wwxx ((00)) + 1111..113311.. wwxx ((00)) wwxx <> Send a weather message to local users wwxx ffuullll <> Send a weather message to all cluster users @@ -4698,7 +4729,7 @@ extreme that may indicate enhanced conditions - 1111..113311.. wwxx ((eennhhaanncceedd ffoorr ssyyssooppss)) ((55)) + 1111..113322.. wwxx ((eennhhaanncceedd ffoorr ssyyssooppss)) ((55)) wwxx ssyyssoopp <> Send a weather message to other clusters only @@ -4719,34 +4750,3 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -- 2.34.1