cnping

commit 6b4dd44b6a7d86ddf0f2fea2e9de11bada8f33f1
parent dab665d732902fa3d3fe697af5ae8d46045909f0
Author: CNLohr <charles@cnlohr.com>
Date:   Sat, 17 Feb 2018 03:19:31 -0500

Update README.md
Diffstat:
M
README.md
 | 
15
++++++++++++---

1 file changed, 12 insertions(+), 3 deletions(-)
diff --git a/README.md b/README.md
@@ -1,11 +1,11 @@
 cnping
 ======
 
-Minimal Graphical IPV4 Ping Tool.  (also comes with searchnet, like nmap but smaller and simpler).  It uses rawdraw so it is OS independent.
+Minimal Graphical IPV4 Ping/HTTP Ping Tool.  (also comes with searchnet, like nmap but smaller and simpler).  It uses rawdraw so it is OS independent.
 ```
 Usage: cnping [host] [period] [extra size] [y-axis scaling] [window title]
 
-	 [host]                 -- domain or IP address of ping target
+	 [host]                 -- domain or IP address of ICMP ping target, or http://[host] i.e. http://google.com
 	 [period]               -- period in seconds (optional), default 0.02
 	 [extra size]           -- ping packet extra size (above 12), optional, default = 0
 	 [const y-axis scaling] -- use a fixed scaling factor instead of auto scaling (optional)
@@ -15,6 +15,12 @@ Picture:
 
 <IMG SRC=cnping.png>
 
+If an http host is listed, the default request is ```HEAD /favicon.ico HTTP/1.1``` since this is usually a very fast, easy operation for the server.  If a specific file or uri is requested, that will be requested instead, i.e. http://github.com/cnlohr will request ```HEAD /cnlohr HTTP/1.1```.
+
+If a regular hostname is requested instead, ICMP (regular ping) will be used.
+
+This allows cnping to be operated in environments where ICMP is prohibited by local computer or network policies.
+
 ## Installation:  
 
 ### Ubuntu:  
@@ -24,12 +30,15 @@ sudo apt install libxinerama-dev libxext-dev libx11-dev build-essential
 make linuxinstall
 ```
 
-'linuxinstall' builds the tool and copies it to your usr/local/bin folder, and sets the sticky bit allowing it to run as though it were root, allowing it to create raw sockets.
+'linuxinstall' builds the tool and copies it to your usr/local/bin folder, and sets the sticky bit or appropriate permissions allowing it to run as though it were root, allowing it to create raw sockets.
 
 ```
 sudo cp cnping /usr/local/bin/
 sudo chmod +s /usr/local/bin/cnping
 ```
+
+Note that if only http pinging is requested, you do not need root access.
+
 ### Archlinux:
 
  [cnping-git](https://aur.archlinux.org/packages/cnping-git/) in the [Arch User Repository](https://wiki.archlinux.org/index.php/Arch_User_Repository)