--- /dev/null
+
+
+
+Sonar(1) Sonar(1)
+
+
+N\bNA\bAM\bME\bE
+ sonar - display a sonar scope
+
+S\bSY\bYN\bNO\bOP\bPS\bSI\bIS\bS
+ s\bso\bon\bna\bar\br [-background _\bc_\bo_\bl_\bo_\br] [-sweep-color _\bc_\bo_\bl_\bo_\br] [-low-color
+ _\bc_\bo_\bl_\bo_\br] [-scope-color _\bc_\bo_\bl_\bo_\br] [-grid-color _\bc_\bo_\bl_\bo_\br]
+ [-text-color _\bc_\bo_\bl_\bo_\br] [-ttl _\bi_\bn_\bt_\be_\bg_\be_\br] [-mode ping] [-font
+ _\bf_\bo_\bn_\bt] [-ping-timeout _\bi_\bn_\bt] [-ping-source list | file | sub-
+ net ] [-ping-file _\bh_\bo_\bs_\bt_\bs_\b-_\bf_\bi_\bl_\be] [-ping-list _\bh_\bo_\bs_\bt_\b-_\bn_\ba_\bm_\be_\b-_\bl_\bi_\bs_\bt]
+ [-team-a-name _\bs_\bt_\br_\bi_\bn_\bg] [-team-b-name _\bs_\bt_\br_\bi_\bn_\bg] [-team-a-count
+ _\bi_\bn_\bt] [-team-b-count _\bi_\bn_\bt]
+
+D\bDE\bES\bSC\bCR\bRI\bIP\bPT\bTI\bIO\bON\bN
+ The _\bs_\bo_\bn_\ba_\br program displays a sonar scope on the computer's
+ screen. This scope polls a sensor as the sweep goes
+ around the scope and displays what it finds as bogies on
+ the screen. The program is designed to support different
+ modes representing different types of sensors. Currently
+ the only implemented sensors are a simulator, and a net-
+ work ping function that pings hosts and plots the results
+ on the scope.
+
+O\bOP\bPT\bTI\bIO\bON\bNS\bS
+ _\bs_\bo_\bn_\ba_\br understands the following options:
+
+ -\b-b\bba\bac\bck\bkg\bgr\bro\bou\bun\bnd\bd _\bC_\bo_\bl_\bo_\br
+ The background Color of the screen not covered by
+ the scope.
+
+ -\b-s\bsw\bwe\bee\bep\bp-\b-c\bco\bol\blo\bor\br _\bC_\bo_\bl_\bo_\br
+ The color of the brightest part of the sweep.
+
+ -\b-s\bsc\bco\bop\bpe\be-\b-c\bco\bol\blo\bor\br _\bC_\bo_\bl_\bo_\br
+ The color of the circular part of the scope.
+
+ -\b-g\bgr\bri\bid\bd-\b-c\bco\bol\blo\bor\br _\bC_\bo_\bl_\bo_\br
+ The color to the grid lines overlaying the scope.
+
+ -\b-t\bte\bex\bxt\bt-\b-c\bco\bol\blo\bor\br _\bC_\bo_\bl_\bo_\br
+ The color of the text identifying bogies on the
+ scope.
+
+ -\b-t\btt\btl\bl _\bi_\bn_\bt_\be_\bg_\be_\br
+ "Time to live": visible time of a Bogie. Try val-
+ ues between 10 (very short) and 100.
+
+ -\b-m\bmo\bod\bde\be _\bs_\bi_\bm_\bu_\bl_\ba_\bt_\bi_\bo_\bn _\b| _\bp_\bi_\bn_\bg
+ The sensor mode to use, the currently supported
+ modes _\bs_\bi_\bm_\bu_\bl_\ba_\bt_\be (the default) and _\bp_\bi_\bn_\bg.
+
+ -\b-f\bfo\bon\bnt\bt _\bf_\bo_\bn_\bt
+ The font used to display text on the scope.
+ Default "fixed".
+
+
+
+
+X Version 11 3-Nov-98 1
+
+
+
+
+
+Sonar(1) Sonar(1)
+
+
+ -\b-p\bpi\bin\bng\bg-\b-t\bti\bim\bme\beo\bou\but\bt _\bi_\bn_\bt
+ The amount of time in milliseconds the program
+ will wait for an answer to a ping.
+
+ -\b-p\bpi\bin\bng\bg-\b-s\bso\bou\bur\brc\bce\be l\bli\bis\bst\bt |\b| f\bfi\bil\ble\be |\b| s\bsu\bub\bbn\bne\bet\bt
+ Th source of the list of hosts to ping. Valid val-
+ ues are: _\bl_\bi_\bs_\bt, _\bf_\bi_\bl_\be, _\bs_\bu_\bb_\bn_\be_\bt. The first two values
+ are described below; and _\bs_\bu_\bb_\bn_\be_\bt indicates that the
+ sonar should ping all hosts in the same subnet as
+ the current machine. (All addresses are treated
+ as class C nets, therefore this will at most ping
+ 254 hosts.)
+
+ -\b-p\bpi\bin\bng\bg-\b-f\bfi\bil\ble\be _\bf_\bi_\bl_\be_\bn_\ba_\bm_\be
+ The path to a file listing the hosts to ping.
+ This file can be in the format used by _\b/_\be_\bt_\bc_\b/_\bh_\bo_\bs_\bt_\bs,
+ or it can be any file that has host names as the
+ first element on each line. If you use ssh, try
+ this:
+
+ sonar -mode ping -ping-file $HOME/.ssh/known_hosts
+
+ This is used only used when _\bp_\bi_\bn_\bg_\bS_\bo_\bu_\br_\bc_\be is set to
+ f\bfi\bil\ble\be.
+
+ -\b-p\bpi\bin\bng\bg-\b-l\bli\bis\bst\bt _\bl_\bi_\bs_\bt
+ A comma separated list of hostnames, eg
+ _\b"_\bp_\bi_\bn_\bk_\by_\b,_\bb_\br_\ba_\bi_\bn_\b,_\bd_\bo_\bt_\b". Only used when _\bp_\bi_\bn_\bg_\bS_\bo_\bu_\br_\bc_\be is
+ set to l\bli\bis\bst\bt.
+
+ -\b-t\bte\bea\bam\bm-\b-a\ba-\b-n\bna\bam\bme\be _\bs_\bt_\br_\bi_\bn_\bg
+ The name of team A, in simulation-mode.
+
+ -\b-t\bte\bea\bam\bm-\b-b\bb-\b-n\bna\bam\bme\be _\bs_\bt_\br_\bi_\bn_\bg
+ The name of team B, in simulation-mode.
+
+ -\b-t\bte\bea\bam\bm-\b-a\ba-\b-c\bco\bou\bun\bnt\bt _\bi_\bn_\bt
+ The number of bogies on team A, in simulation-
+ mode.
+
+ -\b-t\bte\bea\bam\bm-\b-b\bb-\b-c\bco\bou\bun\bnt\bt _\bi_\bn_\bt
+ The number of bogies on team B, in simulation-
+ mode.
+
+R\bRE\bES\bSO\bOU\bUR\bRC\bCE\bES\bS
+ Configuration of the targets to ping is best done by set-
+ ting X Resources.
+
+
+ b\bba\bac\bck\bkg\bgr\bro\bou\bun\bnd\bd _\b(_\bC_\bo_\bl_\bo_\br_\b)
+ See option -background, above; default value is
+ _\bb_\bl_\ba_\bc_\bk.
+
+
+
+
+
+X Version 11 3-Nov-98 2
+
+
+
+
+
+Sonar(1) Sonar(1)
+
+
+ s\bsw\bwe\bee\bep\bpC\bCo\bol\blo\bor\br _\b(_\bC_\bo_\bl_\bo_\br_\b)
+ See option -sweep-color, above; default value is
+ _\b#_\b0_\b0_\bf_\bf_\b0_\b0.
+
+ s\bsc\bco\bop\bpe\beC\bCo\bol\blo\bor\br _\b(_\bC_\bo_\bl_\bo_\br_\b)
+ See option -scope-color, above; default value is
+ _\b#_\b0_\b0_\b3_\b3_\b0_\b0.
+
+ g\bgr\bri\bid\bdC\bCo\bol\blo\bor\br _\b(_\bC_\bo_\bl_\bo_\br_\b)
+ See option -grid-color, above; default value is
+ _\b#_\b0_\b0_\ba_\ba_\b0_\b0.
+
+ t\bte\bex\bxt\btC\bCo\bol\blo\bor\br _\b(_\bC_\bo_\bl_\bo_\br_\b)
+ See option -text-color, above; default value is
+ _\b#_\bf_\bf_\bf_\bf_\b0_\b0.
+
+ t\btt\btl\bl _\b(_\bi_\bn_\bt_\be_\bg_\be_\br_\b)
+ See option -ttl, above; default value is _\b9_\b0 or one
+ sweep.
+
+ m\bmo\bod\bde\be _\b(_\bp_\bi_\bn_\bg_\b)
+ See option -mode, above. If set to d\bde\bef\bfa\bau\bul\blt\bt, it
+ will ping hosts if possible, otherwise, will run
+ in simulation-mode.
+
+ f\bfo\bon\bnt\bt _\b(_\bf_\bo_\bn_\bt_\b)
+ See option -font, above; default value is _\bf_\bi_\bx_\be_\bd.
+
+ p\bpi\bin\bng\bgT\bTi\bim\bme\beo\bou\but\bt _\b(_\bI_\bn_\bt_\be_\bg_\be_\br_\b)
+ See option -pingtimeout, above; default value is
+ 3000.
+
+ p\bpi\bin\bng\bgS\bSo\bou\bur\brc\bce\be _\bl_\bi_\bs_\bt _\b| _\bf_\bi_\bl_\be _\b| _\bs_\bu_\bb_\bn_\be_\bt
+ See option -ping-source, above. Default value is
+ _\bf_\bi_\bl_\be.
+
+ p\bpi\bin\bng\bgF\bFi\bil\ble\be _\bp_\ba_\bt_\bh_\bn_\ba_\bm_\be
+ See option -ping-file, above. Default value is
+ _\b/_\be_\bt_\bc_\b/_\bh_\bo_\bs_\bt_\bs.
+
+ p\bpi\bin\bng\bgL\bLi\bis\bst\bt _\bh_\bo_\bs_\bt_\b,_\bh_\bo_\bs_\bt_\b,_\bh_\bo_\bs_\bt_\b._\b._\b.
+ See option -ping-list, above; default value is
+ l\blo\boc\bca\bal\blh\bho\bos\bst\bt.
+
+ t\bte\bea\bam\bmA\bAN\bNa\bam\bme\be _\bs_\bt_\br_\bi_\bn_\bg
+ See option -team-a-name, above. Default value is
+ F\bF1\b18\b8.
+
+ t\bte\bea\bam\bmB\bBN\bNa\bam\bme\be _\bs_\bt_\br_\bi_\bn_\bg
+ See option -teamBName, above. Default value is
+ M\bMI\bIG\bG.
+
+ t\bte\bea\bam\bmA\bAC\bCo\bou\bun\bnt\bt _\bi_\bn_\bt
+ See option -teamACount, above. Default value is
+
+
+
+X Version 11 3-Nov-98 3
+
+
+
+
+
+Sonar(1) Sonar(1)
+
+
+ 4.
+
+ t\bte\bea\bam\bmB\bBC\bCo\bou\bun\bnt\bt _\bi_\bn_\bt
+ See option -teamBCount, above. Default value is
+ 4.
+
+N\bNO\bOT\bTE\bES\bS
+ In order to use the ping sensor, this program must be
+ installed as setuid root, so that it can create an ICMP
+ socket.
+
+S\bSE\bEE\bE A\bAL\bLS\bSO\bO
+ X\bX(1), x\bxs\bsc\bcr\bre\bee\ben\bns\bsa\bav\bve\ber\br(1), p\bpi\bin\bng\bg(8)
+
+C\bCO\bOP\bPY\bYR\bRI\bIG\bGH\bHT\bT
+ Copyright (C) 1998 by Stephen Martin. (smartin@canada.com)
+
+ Permission to use, copy, modify, distribute, and sell this
+ software and its documentation for any purpose is hereby
+ granted without fee, provided that the above copyright
+ notice appear in all copies and that both that copyright
+ notice and this permission notice appear in supporting
+ documentation. No representations are made about the
+ suitability of this software for any purpose. It is pro-
+ vided "as is" without express or implied warranty.
+
+
+A\bAU\bUT\bTH\bHO\bOR\bRS\bS
+ Stephen Martin <smartin@canada.com>, 3-nov-98.
+
+ Thanks to Tom Kelly for suggesting a modular approach to
+ the sensor amoung other things.
+
+ Thomas Bahls <thommy@cs.tu-berlin.de> hacked the "ttl"
+ option, 12-jul-98.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+X Version 11 3-Nov-98 4
+
+