One-way Ping (OWAMP)
The OWAMP specification has now been released as a Standards Track RFC: http://www.rfc-editor.org/rfc/rfc4656.txt.

owfetch(1)                                                          owfetch(1)

NAME

       owfetch - Client application to fetch buffered OWAMP session data.

SYNOPSIS

       owfetch [options] servhost [SID savefile]+

DESCRIPTION

       owfetch  is  a  command  line client application used to fetch buffered
       OWAMP session data.

       OWAMP one-way latency measurements send packets from a sending host  to
       a  receiving  host.  The receiving host is the only entity that ends up
       with the results of the test. When the owampd daemon is used to setup a
       receiving  endpoint, the daemon buffers that data. The owfetch applica-
       tion can  be  used  to  fetch  the  buffered  data.  (owping  typically
       retrieves this information immediately upon completion of the test mak-
       ing this unnecessary in most cases.)

       owfetch is a simple application that can be used to fetch this buffered
       data  from  a owampd process running on servhost if it was not saved as
       part of the owping execution.

       servhost can be specified using rfc2396 and  rfc2732  syntax  for  both
       host and port specification:

       node:port
              IPv4  syntax  where  node is either a DNS name or a numeric host
              address string consisting of a dotted decimal IPv4 address.  The
              port is an optional port specifier to contact servers running on
              a non-default port and can be left off in most cases.  This syn-
              tax also works for IPv6 addresses specified using DNS names.

       [node]:port
              IPv6  syntax  where  node is specified using a numeric IPv6 host
              address string. The []'s are required only if the optional  port
              port specifier is used.

       The SID (Session Identifier) is a hex number that uniquely identifies a
       single test session. savefile is the file in which the data  from  that
       test  session  will  be  saved. Any number of SID savefile pairs can be
       specified on the command-line to download more  than  one  session  per
       command  execution.  The  SID  is  printed  out  when a test session is
       requested by owping, unless output is suppressed with the -Q option.

       savefile can be specified as /dev/null on UNIX if there is no desire to
       actually save the session data.

       If  no  options  are  specified, owfetch retrieves the buffered session
       data from servhost, saves the data to the savefile, and prints  summary
       statistics.

OPTIONS

       -h
              Print a usage message and exit.

              Default:
                     Unset.

EXAMPLES

       owfetch somehost.com abcdef0123456789abcdef0123456789 save.owp

              Contact  host somehost.com. Fetch the test session identified by
              the   SID   abcdef0123456789abcdef0123456789.   Print    summary
              statistics on that file and save the data in save.owp.

       owfetch -R somehost.com abcdef0123456789abcdef0123456789 save.owp

              Contact  host somehost.com. Fetch the test session identified by
              the SID abcdef0123456789abcdef0123456789. Print the raw decoding
              of  the data in that file and save the session data in save.owp.

       owfetch -M somehost.com abcdef0123456789abcdef0123456789 save.owp

              Contact host somehost.com. Fetch the test session identified  by
              the  SID  abcdef0123456789abcdef0123456789.  Print  the  machine
              pars-able summary statistics for that session and save the  ses-
              sion data in save.owp.

       owfetch -v somehost.com abcdef0123456789abcdef0123456789 save.owp

              Contact  host somehost.com. Fetch the test session identified by
              the  SID  abcdef0123456789abcdef0123456789.   Print   individual
              delays  for each packet in human readable format. Print the sum-
              mary statistics.  Save the session data in save.owp.

       owfetch  -U  someuser   somehost.com   abcdef0123456789abcdef0123456789
       save.owp

              The  same  action  as the first example.  Authenticate using the
              identity someuser. owfetch will prompt for a passphrase.

SEE ALSO

       owampd(8),    owping(1),    owstats(1),    aespasswd(1)     and     the
       http://e2epi.internet2.edu/owamp/ web site.

ACKNOWLEDGMENTS

       This  material  is based in part on work supported by the National Sci-
       ence Foundation (NSF) under Grant No. ANI-0314723. Any opinions,  find-
       ings  and conclusions or recommendations expressed in this material are
       those of the author(s) and do not necessarily reflect the views of  the
       NSF.

                         $Date: 2007/02/24 12:21:54 $               owfetch(1)