README.md (2247B)
1cnping 2====== 3 4Minimal Graphical IPV4 Ping/HTTP Ping Tool. (also comes with searchnet, like nmap but smaller and simpler). It uses rawdraw so it is OS independent. 5``` 6Usage: cnping [host] [period] [extra size] [y-axis scaling] [window title] 7 8 [host] -- domain or IP address of ICMP ping target, or http://[host] i.e. http://google.com 9 [period] -- period in seconds (optional), default 0.02 10 [extra size] -- ping packet extra size (above 12), optional, default = 0 11 [const y-axis scaling] -- use a fixed scaling factor instead of auto scaling (optional) 12 [window title] -- the title of the window (optional) 13``` 14<IMG SRC=https://i.imgur.com/Yj5coKN.gif> 15 16If 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```. 17 18If a regular hostname is requested instead, ICMP (regular ping) will be used. 19 20This allows cnping to be operated in environments where ICMP is prohibited by local computer or network policies. 21 22## Installation 23 24### Ubuntu 25 26``` 27sudo apt install libxinerama-dev libxext-dev libx11-dev build-essential mesa-common-dev libglvnd-dev 28git clone https://github.com/cntools/cnping.git 29cd cnping/ 30git submodule update --init --recursive 31make linuxinstall 32``` 33 34'linuxinstall' builds the tool, copies it to your /usr/local/bin folder, and sets the cap_net_raw capability allowing it to create raw sockets without being root. 35 36``` 37sudo cp cnping /usr/local/bin/ 38sudo setcap cap_net_raw+ep /usr/local/bin/cnping 39``` 40 41Note that if only http pinging is requested, you do not need cap_net_raw or root access. 42 43### Windows 44 45A Windows-exe can be cross compiled on Linux, just install the necessary dependencies and compile it: 46 47``` 48sudo apt install binutils-mingw-w64-i686 gcc-mingw-w64-i686 g++-mingw-w64-i686 49make cnping.exe 50``` 51 52### Other distributions 53 54See our Wiki page for information on more distributions, e.g. Arch, Void, Gentoo or Fedora: [Binary packages and distributions](https://github.com/cntools/cnping/wiki/Binary-packages-and-distributions)