Read the entire file readme-en.txt. For example, by the command tar xjOf fynpinger-0-0-0.tar.bz2 fynpinger/readme-en.txt | less.
Unpack the files fynpinger.perl and fynpinger.conf to any directory permitted to you for reading and writing; or unpack everything by the command tar xjpf fynpinger-0-0-0.tar.bz2. If needed, edit the file fynpinger.conf. Run the file fynpinger.perl in a terminal; for example: ./fynpinger.perl max=8 blocklist=+bad.com (it is just an example).
Command line and the configuration file can contain the following parameters, in any order. None of them is mandatory.
|name of parameter||values (default)||description|
|blocklist||The addresses not to test; comma separated. Address only (IPv4, IPv6, FQDN). If the node where the testing happens is on the list, add it to the value of that parameter: it will else seem to be the quickest.|
|hostnames||all, nocf, none (nocf)||Use or not the sign addresses (not only IP addresses; those from the list and indicated by the user): all; all except those applying Cloudflare (nocf); none.|
|ip||v4, v6, both (both)||IP versions (IPv4, IPv6, both), nodes with which the user searches.|
|lng||en, eo, ru||Language of outputted messages; supported are English (en), Esperanto (eo) and Russian (ru). If an unsupported language is indicated, English is used. If not indicated, the system language is used; and if it is not amongst the supported ones, then English.|
|max||1 – ∞ (12)||Maximally allowed ping (in seconds).|
|morehosts||Additional addresses (not from the list); comma separated. Address (IPv4, IPv6 in square brackets, FQDN) with protocol and port number.|
|offline||none, hour, day, all (none)||Test or not the network nodes, marked as inaccessible (offline): none; offline for hours (hour); offline for hours and days (day); all.|
|proto||tls, tcp, both (tls)||Protocol(s), nodes with which the user searches.|
|to||screen, file, both (screen)||Where to output a result of work of the programme: to screen, to file, to both.|
In the configuration file, empty lines and lines starting with the # sign are ignored (thus it is possible to enter a comment, and also turn a line off). Parameters on command line surpass parameters in the configuration file. If it is indicated lng=auto on command line, system language is used (and if it is not supported, then English).
On command line, if value of the parameter blocklist or morehosts starts with a plus, value from command line is added to the value from the configuration file; if any of those two parameters in command line has the value no, its value from the configuration file is ignored.
The programme outputs two lists: ‘Not replied’ and ‘Quick nodes’. The second one is more needed, but the first one is needed, too: the nodes on that list can be accessible, but set to not reply to ping; you can explore them with traceroute (tracepath) and whois.