noping(8)
NAME
oping - send ICMP ECHO_REQUEST to network hosts
SYNOPSIS
oping [-4 | -6] [-c count] [-i interval] host [host [host ...]] oping [-4 | -6] [-c count] [-i interval] -f filename noping [-4 | -6] [-c count] [-i interval] host [host [host ...]] noping [-4 | -6] [-c count] [-i interval] -f filename
DESCRIPTION
oping uses ICMPv4 or ICMPv6 ECHO_REQUEST packets to measure a hosts reachability and the network latency. In contrast to the original ping(8) utility oping can send ICMP packets to multiple hosts in parallel and wait for all ECHO_RESPONSE packets to arrive. In contrast to the fping utility (URL is listed in "SEE ALSO") oping can use both, IPv4 and IPv6 transparently and side by side. noping is an ncurses-based front-end to liboping which displays ping statistics online and highlights aberrant round-trip times if the terminal supports colors.
OPTIONS
-4 Force the use of IPv4.
-6 Force the use of IPv6.
-c count
Send (and receive) count ICMP packets, then stop and exit.
-i interval
Send one ICMP packet (per host) each interval seconds. This can be
a floating-point number to specify sub-second precision.
-w timeout
Specifies the time to wait for an "ECHO REPLY" packet before giving
up, in seconds. This can be a floating point number for sub-second
precision. Defaults to 1.0 seconds.
-t ttl
Set the IP Time to Live to ttl. This must be a number between (and
including) 1 and 255. If omitted, the value 64 is used.
-I address
Set the source address to use. You may either specify an IP number
or a hostname. You cannot pass the interface name, as you can with
GNU's ping(8) - use the -D option for that purpose.
-D interface name
Set the outgoing network device to use.
-f filename
Instead of specifying hostnames on the command line, read them from
filename. If filename is -, read from "STDIN".
If oping is installed with the SetUID-bit, it will set the
effective UID to the real UID before opening the file. In the
special (but common) case that oping is owned by the super-user
(UID 0), this means that privileges are temporarily dropped before
opening the file, in order to prevent users from reading arbitrary
files on the system.
If your system doesn't provide saved set-user IDs (this was an
optional feature before POSIX 2001), the behavior is different
because it is not possible to temporarily drop privileges. The
alternative behavior is: If the real user ID (as returned by
getuid(2)) and the effective user ID (as returned by geteuid(2))
differ, the only argument allowed for this option is "-" (i.e.
standard input).
-O filename
Write measurements in Comma Separated Values (CSV) format to
filename. This option writes three columns per row: wall clock
time in (fractional) seconds since epoch, hostname and the round
trip time in milliseconds.
-Q qos
Specify the Quality of Service (QoS) for outgoing packets. This is
a somewhat tricky option, since the meaning of the bits in the IPv4
header has been revised several times.
The currently recommended method is Differentiated Services which
is used in IPv6 headers as well. There are shortcuts for various
predefined per-hop behaviors (PHBs):
be Selects the Best Effort behavior. This is the default behavior.
ef Selects the Expedited Forwarding (EF) per-hop behavior, as
defined in RFC 3246. This PHB is characterised by low delay,
low loss and low jitter, i.e. high priority traffic.
va Selects the Voice Admitted (VA) per-hop behavior, as defined in
RFC 5865. This traffic class is meant for Voice over IP (VoIP)
traffic which uses Call Admission Control (CAC) for reserving
network capacity.
afcp
Selects one of 12 differentiated services code points (DSCPs),
which are organized in four classes with three priorities each.
Therefore, c must be a number between 1 through 4 and p must be
a number between 1 through 3, for example "af13", "af22" and
"af41". In each class, the lower priority number takes
precedence over the higher priority number.
csn Selects one of the eight Class Selector PHBs. n is a number
between 0 through 7. The class selectors have been defined to
be compatible to the Precedence field in the IPv4 header as
defined in RFC 791. Please note that "cs0" is synonymous to
"be".
The old definition of the same bits in the IPv4 header was as Type
of Service (ToS) field, specified in RFC 1349. It defined four
possible values which have appropriate aliases. Please note that
this use of the bits is deprecated and the meaning is limited to
IPv4!
lowdelay
Minimize delay
throughput
Maximize throughput
reliability
Maximize reliability
mincost
Minimize monetary cost
Alternatively, you can also specify the byte manually. You can use
either a decimal number (0-255), a hexadecimal number (0x00-0xff)
or an octal number (00-0377) using the usual "0x" and "0" prefixes
for hexadecimal and octal respectively.
The printed lines will contain information about the QoS field of
received packets if either a non-standard QoS setting was used on
outgoing packets or if the QoS byte of incoming packets is not
zero. In other words, the QoS information is omitted if both, the
outgoing and the incoming QoS bytes are zero. The received byte is
always interpreted as Differentiated Services Code Point (DSCP) and
Explicit Congestion Notification (ECN), even if the deprecated Type
of Service (ToS) aliases were used to specify the bits of outgoing
packets.
-m mark
Linux only Sets the mark (an integer number) on outgoing packets.
This can be used by iptables(8) and other networking infrastructure
for filtering and routing.
-u|-U
noping only -u forces UTF-8 output, -U disables UTF-8 output. If
neither is given, the codeset is automatically determined from the
locale.
-g none|prettyping|boxplot|histogram
noping only Selects the graph to display.
none
Do not show a graph.
prettyping
Show a graph with time on the x-axis, the y-axis shows the
round-trip time. This is the default graph.
If your terminal supports unicode and colors, they are used to
improve the precision of the data shown: a green box is drawn
for round-trip times up to one third of the configured timeout,
the height representing the RTT. Longer RTTs will start to fill
the box yellow (with a green background) and then red (with a
yellow background). Lost packages are drawn as a bold red
explamation mark.
boxplot
Show a box plot where the x-axis, i.e. the width of the window,
is the round-trip time. The entire width of the window it the
ping interval, set with the -i option.
The box is sized so it contains 50% of the replies. The
vertical line shows the median. The whiskers are sized to
contain 95% of the replies -- 2.5% below the whiskers and 2.5%
above.
|----------[#####|##########]--------------------------------------------|
^ ^ ^ ^ ^
2.5% 25% 50% 75% 97.5%
histogram
Show a histrogram of the round-trip times. The width of the
window is taken as round-trip time from 0ms on the left to the
interval (the -i option, default 1000ms) on the right.
The height of the graph is scaled so that the most-used buckets
vertically fills the line. The buckets are colored green up to
and including the 80th percentile, yellow up to and including
the 95th percentile and red for the remainder.
-b Audible bell. Print a ASCII BEL character (
or 0x07) when a
packet is received before the timeout occurs. This can be useful in
order to monitory hosts' connectivity without looking physically at
the console, for example to trace network cables (start audible
beep, disconnect cable N: if beep stops, the cable was in use) or
to tell when a host returns from a reboot.
This relies on the terminal bell to be functional. To enable the
terminal bell, use the following instructions.
* the visual bell is disabled in your terminal emulator, with the
+vb commandline flag or the following in your .Xresources:
XTerm*visualBell: false
* the PC speaker module is loaded in your kernel:
modprobe pcspkr
* X11 has the terminal bell enabled:
xset b on; xset b 100
* and finally, if you are using PulseAudio, that the
module-x11-bell module is loaded with a pre-loaded sample
defined in your pulseaudio configuration:
load-sample-lazy x11-bell /usr/share/sounds/freedesktop/stereo/complete.oga
load-module module-x11-bell sample=x11-bell
-P percent
Configures the latency percentile to report. percent must be a
number between zero and 100, exclusively in both cases. In general,
defaults to 95. If -c is given and a number less than 20, this
would be the same as the maximum. In this case the default is
chosen so that it excludes the maximum, e.g. if -c 5 is given, the
default is 80. The calculated percentile is based on the last 900
packets (15 minutes with the default interval).
-Z percent
If any hosts have a drop rate higher than percent, where percent is
a number between zero and 100 inclusively, exit with a non-zero
exit status. Since it is not possible to have a higher drop rate
than 100%, passing this limit will effectively disable the feature
(the default). Setting the option to zero means that the exit
status will only be zero if all replies for all hosts have been
received.
The exit status will indicate the number of hosts with more than
percent packets lost, up to a number of 255 failing hosts.
COLORS
If supported by the terminal, noping will highlight the round-trip times (RTT) using the colors green, yellow and red. Green signals RTTs that are in the "expected" range, yellow marks moderately unusual times and times that differ a lot from the expected value are printed in red. The information used to categorize round-trip times is the percentile. RTTs in the 80th percentile are considered to be "normal" and are printed in green. RTTs within the 95th percentile are considered "moderately unusual" and are printed in yellow. RTTs above that are considered to be "unusual" and are printed in red.
SEE ALSO
ping(8), <http://fping.org/>, liboping(3)
AUTHOR
liboping is written by Florian "octo" Forster <ff at octo.it>. Its homepage can be found at <http://noping.cc/>. Copyright (c) 2005-2016 by Florian "octo" Forster.
Opportunity
Personal Opportunity - Free software gives you access to billions of dollars of software at no cost. Use this software for your business, personal use or to develop a profitable skill. Access to source code provides access to a level of capabilities/information that companies protect though copyrights. Open source is a core component of the Internet and it is available to you. Leverage the billions of dollars in resources and capabilities to build a career, establish a business or change the world. The potential is endless for those who understand the opportunity.
Business Opportunity - Goldman Sachs, IBM and countless large corporations are leveraging open source to reduce costs, develop products and increase their bottom lines. Learn what these companies know about open source and how open source can give you the advantage.
Free Software
Free Software provides computer programs and capabilities at no cost but more importantly, it provides the freedom to run, edit, contribute to, and share the software. The importance of free software is a matter of access, not price. Software at no cost is a benefit but ownership rights to the software and source code is far more significant.
Free Office Software - The Libre Office suite provides top desktop productivity tools for free. This includes, a word processor, spreadsheet, presentation engine, drawing and flowcharting, database and math applications. Libre Office is available for Linux or Windows.
Free Books
The Free Books Library is a collection of thousands of the most popular public domain books in an online readable format. The collection includes great classical literature and more recent works where the U.S. copyright has expired. These books are yours to read and use without restrictions.
Source Code - Want to change a program or know how it works? Open Source provides the source code for its programs so that anyone can use, modify or learn how to write those programs themselves. Visit the GNU source code repositories to download the source.
Education
Study at Harvard, Stanford or MIT - Open edX provides free online courses from Harvard, MIT, Columbia, UC Berkeley and other top Universities. Hundreds of courses for almost all major subjects and course levels. Open edx also offers some paid courses and selected certifications.
Linux Manual Pages - A man or manual page is a form of software documentation found on Linux/Unix operating systems. Topics covered include computer programs (including library and system calls), formal standards and conventions, and even abstract concepts.
