X-Git-Url: http://git.hungrycats.org/cgi-bin/gitweb.cgi?a=blobdiff_plain;f=hacks%2Fsonar.man;h=36a3539d3564ca936ad10671fb24b7e0fd964f16;hb=c1b9b55ad8d59dc05ef55e316aebf5863e7dfa56;hp=5327c46d75be08195828b6ecb6d3ec40be8c468f;hpb=3c58fb6311db49c46f1670922933b27c6ea0c065;p=xscreensaver diff --git a/hacks/sonar.man b/hacks/sonar.man index 5327c46d..36a3539d 100644 --- a/hacks/sonar.man +++ b/hacks/sonar.man @@ -30,7 +30,10 @@ sonar - display a sonar scope [\-team-b-name \fIstring\fP] [\-team-a-count \fIint\fP] [\-team-b-count \fIint\fP] +[\-no\-dns] +[\-no\-times] [\-debug] +[\-fps] .SH DESCRIPTION The \fIsonar\fP program displays a sonar scope on the computer's screen. This scope polls a sensor as the sweep goes around the scope and displays @@ -103,6 +106,12 @@ names as the first element on each line. If you use ssh, try this: sonar -ping $HOME/.ssh/known_hosts .RE .TP 8 +.B \-no\-dns +Do not attempt to resolve IP addresses to hostnames. +.TP 8 +.B \-no\-times +Do not display ping times beneath the host names. +.TP 8 .B \-team-a-name \fIstring\fP In simulation mode, the name of team A. .TP 8 @@ -114,6 +123,9 @@ In simulation mode, the number of bogies on team A. .TP 8 .B \-team-b-count \fIint\fP In simulation mode, the number of bogies on team B. +.TP 8 +.B \-fps +Display the current frame rate and CPU load. .SH RESOURCES Configuration of the targets to ping is best done by setting X Resources. .PP @@ -159,18 +171,36 @@ See option \-teamACount, above. Default value is 4. .B teamBCount \fIint\fP See option \-teamBCount, above. Default value is 4. .SH NOTES -In order to use the ping sensor, this program must be installed as -setuid root, so that it can create an ICMP socket. Root privileges -are disavowed shortly after startup (just after connecting to the -X server and reading the resource database) so this is \fIbelieved\fP -to be a safe thing to do, but it is usually recommended that you -have as few setuid programs around as possible, on general principles. +In order to use the ping sensor on most systems, this program must be +installed as setuid root, so that it can create an ICMP RAW socket. +Root privileges are disavowed shortly after startup (just after +connecting to the X server and reading the resource database) so this +is \fIbelieved\fP to be a safe thing to do, but it is usually +recommended that you have as few setuid programs around as possible, +on general principles. +.EX +chown root:root sonar +chmod u+s sonar +.EE +It is not necessary to make it setuid on MacOS systems, because on +those systems, unprivileged programs can ping by using ICMP DGRAM +sockets instead of ICMP RAW. + +In ping-mode, the display is a logarithmic scale, calibrated so that the +three rings represent ping times of approximately 2.5, 70 and 2,000 +milliseconds respectively. + +This means that if any the hosts you are pinging take longer than 2 +seconds to respond, they won't show up; and if you are pinging several +hosts with very fast response times, they will all appear close to the +center of the screen (making their names hard to read.) .SH SEE ALSO .BR X (1), .BR xscreensaver (1), .BR ping (8) .SH COPYRIGHT -Copyright \(co 1998 by Stephen Martin. (smartin@canada.com) +Copyright \(co 1998 by Stephen Martin. +Copyright \(co 2000-2004 by Jamie Zawinski Permission to use, copy, modify, distribute, and sell this software and its documentation for any purpose is hereby granted without fee, provided that @@ -184,7 +214,7 @@ implied warranty. Stephen Martin , 3-nov-98. Thanks to Tom Kelly for suggesting a modular approach to the sensor -amoung other things. +among other things. Thomas Bahls hacked the "ttl" option, 12-jul-98.