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