http://www.jwz.org/xscreensaver/xscreensaver-5.07.tar.gz
[xscreensaver] / hacks / sonar.man
index 8dca55bc3407fb8d5a867a912e050b69dd5d6364..36a3539d3564ca936ad10671fb24b7e0fd964f16 100644 (file)
@@ -33,6 +33,7 @@ sonar - display a sonar scope
 [\-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
@@ -122,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
@@ -167,16 +171,21 @@ 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
+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.  
@@ -205,7 +214,7 @@ implied warranty.
 Stephen Martin <smartin@canada.com>, 3-nov-98.
 
 Thanks to Tom Kelly for suggesting a modular approach to the sensor
-amoung other things.
+among other things.
 
 Thomas Bahls <thommy@cs.tu-berlin.de> hacked the "ttl" option, 12-jul-98.