X-Git-Url: http://git.hungrycats.org/cgi-bin/gitweb.cgi?p=xscreensaver;a=blobdiff_plain;f=hacks%2Fglx%2Fsonar.man;fp=hacks%2Fglx%2Fsonar.man;h=0000000000000000000000000000000000000000;hp=9927b3bb56cfbc7e1eaba3aabc04c54e446cb308;hb=019de959b265701cd0c3fccbb61f2b69f06bf9ee;hpb=2762a7d7cf8d83e68b8f635941f6609119d630ae diff --git a/hacks/glx/sonar.man b/hacks/glx/sonar.man deleted file mode 100644 index 9927b3bb..00000000 --- a/hacks/glx/sonar.man +++ /dev/null @@ -1,169 +0,0 @@ -.de EX \"Begin example -.ne 5 -.if n .sp 1 -.if t .sp .5 -.nf -.in +.5i -.. -.de EE -.fi -.in -.5i -.if n .sp 1 -.if t .sp .5 -.. -.TH Sonar 1 "12-Aug-08" "X Version 11" -.SH NAME -sonar - display a sonar scope -.SH SYNOPSIS -.B sonar -[\-ping \fIhosts-or-subnets\fP] -[\-ping\-timeout \fIint\fP] -[\-delay \fIusecs\fP] -[\-speed \fIratio\fP] -[\-sweep-size \fIratio\fP] -[\-font-size \fIpoints\fP] -[\-team-a-name \fIstring\fP] -[\-team-b-name \fIstring\fP] -[\-team-a-count \fIint\fP] -[\-team-b-count \fIint\fP] -[\-no\-dns] -[\-no\-times] -[\-no\-wobble] -[\-debug] -[\-fps] -.SH DESCRIPTION -This draws a sonar screen that pings (get it?) the hosts on -your local network, and plots their distance (response time) from you. -The three rings represent ping times of approximately 2.5, 70 and 2,000 -milliseconds respectively. - -Alternately, it can run a simulation that doesn't involve hosts. -.SH OPTIONS -.I sonar -understands the following options: -.TP 8 -.B \-ping \fIhosts-or-subnets\fP -The list of things to ping, separated by commas or spaces. -Elements of this list may be: -.RS 8 -.TP 12 -.B simulation -Run in simulation mode instead of pinging real hosts. -.TP 12 -.I hostname -Ping the given host. -.TP 12 -.I A.B.C.D -Ping the given IPv4 address. -.TP 12 -.B subnet -Ping the local subnet. On systems where we can determine the local -network mask, we use that; otherwise, we assume Class C (254 hosts). -.TP 12 -.B subnet/\fINN\fP -Ping a different-sized local subnet: e.g., \fBsubnet/28\fP would ping -a 4-bit subnet (the nearest 14 addresses). On systems where we can -determine the local network mask, we always use that. -.TP 12 -.I A.B.C.D/NN -Ping an arbitrary other IPv4 subnet. The address specifies -the base address, and the part after the slash is how wide the -subnet is. Typical values are /24 (for 254 addresses) and /28 (for -14 addresses). -.TP 12 -.I filename -Ping the hosts listed in the given file. This file can be in the -format used by \fI/etc/hosts\fP, or it can be any file that has host -names as the first or second element on each line. If you use ssh, -try this: - - sonar -ping $HOME/.ssh/known_hosts -.RE -.TP 8 -.B \-ping\-timeout \fIint\fP -The amount of time in milliseconds the program will wait for an answer -to a ping. -.TP 8 -.B \-delay \fIint\fP -Delay between frames, in microseconds. Default 20000. -.TP 8 -.B \-speed \fIratio\fP -Less than 1 for slower, greater than 1 for faster. Default 1. -.TP 8 -.B \-sweep-size \fIratio\fP -How big the glowing sweep area should be. Default 0.3. -.TP 8 -.B \-font-size \fIpoints\fP -How large the text should be. Default 10 points. -.TP 8 -.B \-no\-wobble -Keep the display stationary instead of very slowly wobbling back and forth. -.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 -.B \-team-b-name \fIstring\fP -In simulation mode, the name of team B. -.TP 8 -.B \-team-a-count \fIint\fP -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, polygon count, and CPU load. -.SH NOTES -On most Unix systems, this program must be installed as setuid root -in order to ping hosts. This is because root privileges are needed -to create an ICMP RAW socket. Privileges are disavowed shortly after -startup (just after connecting to the X server) so this is believed -to be safe: -.EX -chown root:root sonar -chmod u+s sonar -.EE -It is not necessary to make it setuid on MacOS systems, because on -MacOS, 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 BUGS -Does not support IPv6. -.SH SEE ALSO -.BR X (1), -.BR xscreensaver (1), -.BR ping (8), -.BR ping6 (8) -.SH COPYRIGHT -Copyright \(co 2000-2012 by Jamie Zawinski -.RE -Copyright \(co 1998 by Stephen Martin. - -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 provided "as is" without express or -implied warranty. - -.SH AUTHORS -Stephen Martin , 3-nov-1998. - -Subnet support, etc. added by Jamie Zawinski, 17-Jul-2000. - -Rewritten using OpenGL instead of X11 by Jamie Zawinski, 12-Aug-2008.