OWAMP supports three reporting formats. A textual summary that was designed to be as similar to the results that ping produces as possible. A machine readable summary format (-M). And finally a raw format that prints out the data from each and every packet in as compact of a format as possible (-R). The textual summary also allows the information from each packet to be reported using the -v option. The default textual summary will be used if neither the -M or the -R options are specified. It includes:
This value is only used if reporting summary statistics.
Because a histogram to compute the median (and other percentiles of delay) the results can be misleading if the bucket_width is not appropriate. For example, if all of the delays in the sample are smaller than the value of bucket_width then the median will be reported as bucket_width, a value that is greater than the maximum delay in the sample. To avoid this, bucket_width should be picked to be smaller than (max - min). The default value was selected to be reasonable for most real network paths, it is not appropriate for tests to the localhost however.
This value is only used if reporting summary statistics.
The -M option is ignored if -Q is set.
This option is used to break down the summary statistics in smaller sample sizes than a complete owp file. This is useful when breaking up very long running sessions.
This option is only used for statistical output, and therefore has no effect on the -R output mode.
The available units are:
'n' | nanoseconds (ns) |
'u' | microseconds (us) |
'm' | milliseconds (ms) |
's' | seconds (s) |
This is only used for the human-readable summary statistics and the -v mode of reporting individual records. In particular, it is not used for the -R or -M output modes.
The summary filenames are in the format:
${START_TIME}_${END_TIME}.${FILETYPE}
STARTTIME and ENDTIME are the start and end timestamps for the session or sub-session. The timestamps are ASCII representation of 64 bit integers with the high-order 32 bits representing the number of seconds since Jan 1, 1900 and the low-order 32 bits representing fractional seconds. The FILETYPE is sum for -M summary files, and txt for the default human-readable summary information.
This option is ignored if the -R option is specified.
SEQNO SENDTIME SSYNC SERR RECVTIME RSYNC RERR TTL
SEQNO | Sequence number. |
SENDTIME | Send timestamp. |
SSYNC | Sending system synchronized (0 or 1). |
SERR | Estimate of SENDTIME error. |
RECVTIME | Receive timestamp. |
RSYNC | Receiving system synchronized (0 or 1). |
RERR | Estimate of RECVTIME error. |
TTL | TTL IP field. |
The timestamps are ASCII representation of 64 bit integers with the high-order 32 bits representing the number of seconds since Jan 1, 1900 and the low-order 32 bits representing fractional seconds. Lost packet records are indicated with a RECVTIME of 0 (zero). The sequence number is simply an integer. The error estimates are printed as floating-point numbers using scientific notation. TTL is the IP field from the packet. The TTL in sending packets should be initialized to 255, so the number of hops the packet traversed can be computed. If the receiving host is not able to determine the TTL field, this will be reported as 255. (Some socket API's do not expose the TTL field.)
The -R option implies -Q.
owstats datafile.owp
owstats -a 5,95 datafile.owp
owstats -R datafile.owp
owstats -v datafile.owp
owstats -M datafile.owp
owstats datafile1.owp datafile2.owp datafile3.owp