High performance ping tool [Fork of github.com/schweikert/fping]
You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 
 
Go to file
Erik Auerswald 90ad83fbd0 Print cumulative stats with -Q SECS,cumulative
With -Q SECS, fping emits information for the just finished
interval.  This is good for long-running fping processes where
one would like to get an update on recent results, ignoring
missing responses from older intervals.  This seems appropriate
for use with other software like netdata or smokeping.

But for short(er)-running fping processes, e.g., during a change
window, it may be more interesting to get a status update since
the beginning of the change window, i.e., the start of fping.
Adding a comma followed by the keyword "cumulative" to -Q SECS
(i.e., -Q SECS,cumulative) changes the interim reports to output
the current per system overall statistics, unless -N is used, too.

The new syntax is documented in fping.pod and added to fping -h
output.

Four tests are added:

  1. Characters after SECS are ignored as before.
  2. Unknown keywords are ignored as before.
  2. Adding ",cumulative" changes -Q output.
  3. Adding ",cumulative" also affects the additional -o output.

This addresses issue #243.
6 months ago
.github/workflows Fix deprected github action ubuntu-18.04 to ubuntu-22.04 1 year ago
ci Print cumulative stats with -Q SECS,cumulative 6 months ago
contrib Add --fwmark/-k option for Linux 10 months ago
doc Print cumulative stats with -Q SECS,cumulative 6 months ago
src Print cumulative stats with -Q SECS,cumulative 6 months ago
.dockerignore Dockerfile for fping 1 year ago
.gitignore reformat 8 years ago
.travis.yml travis-ci: fix deploy stage 4 years ago
CHANGELOG.md Prepare v5.2 release. 7 months ago
COPYING Clarify COPYING 11 years ago
INSTALL Improve README and INSTALL 13 years ago
Makefile.am avoid including ci/build in dist tarball 4 years ago
README.md Add --fwmark/-k option for Linux 10 months ago
autoclean.sh add missing files to autoclean.sh 3 years ago
autogen.sh remove generated files 13 years ago
azure-pipelines.yml Update Azure Pipline add macOS pipline job 7 months ago
configure.ac Prepare v5.2 release. 7 months ago

README.md

Build Status Coverage Status Coverity Scan Build Status

fping

fping is a program to send ICMP echo probes to network hosts, similar to ping, but much better performing when pinging multiple hosts. fping has a long long story: Roland Schemers did publish a first version of it in 1992 and it has established itself since then as a standard tool.

Current maintainer:
David Schweikert <david@schweikert.ch>

Website:
https://fping.org/

Mailing-list:
https://groups.google.com/group/fping-users

Installation

If you want to install fping from source, proceed as follows:

  1. Run ./autogen.sh (only if you got the source from Github).
  2. Run ./configure with the correct arguments. (see: ./configure --help)
  3. Run make; make install.
  4. Make fping either setuid, or, if under Linux: sudo setcap cap_net_raw,cap_net_admin+ep fping

If you can't run fping as root or can't use the cap_net_raw capability, you can also run fping in unprivileged mode. This works on MacOS and also on Linux, provided that your GID is included in the range defined in /proc/sys/net/ipv4/ping_group_range. This is particularly useful for running fping in rootless / unprivileged containers. The --fwmark option needs root or cap_net_admin. setuid will not work for --fwmark.

Usage

Have a look at the fping(8) manual page for usage help. (fping -h will also give a minimal help output.)

Credits