Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
owup(1)			    General Commands Manual		       owup(1)

       owup - Client application to query the server for uptime	information

       owup [options] servhost

       owup is a command line client application used to fetch uptime informa-
       tion from the server. The owampd	greeting message provides  uptime  in-
       formation. This can be useful information for clients that run long-du-
       ration test and for monitoring purposes.

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

	      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.

	      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.

	      Print a usage message and	exit.


   Connection/Authentication Options:
	      Forces OWAMP clients to use IPv4 addresses only.

		     Unset.  OWAMP  will  use  IPv4 or IPv6 address, but tries
		     IPv6 first.

	      Forces OWAMP clients to use IPv6 addresses only.

		     Unset. OWAMP will use IPv4	or  IPv6  address,  but	 tries
		     IPv6 first.

       -A authmode
	      Specify  the  authentication  modes the client is	willing	to use
	      for communication. authmode should be set	as a character	string
	      with any or all of the characters	"AEO". The modes are:

	      A	     [A]uthenticated.  This  mode encrypts the control connec-
		     tion and digitally	signs part of each test	packet.

	      E	     [E]ncrypted. This mode encrypts  the  control  connection
		     and  encrypts  each test packet in	full. This mode	forces
		     an	encryption step	between	the fetching  of  a  timestamp
		     and when the packet is sent. This adds more computational
		     delay to the time reported	by OWAMP for each packet.

	      O	     [O]pen. No	encryption of any kind is done.

	      The client can specify all the modes with	which it is willing to
	      communicate.   The  most	strict mode that both the OWAMP	server
	      and the OWAMP client are willing to use will  be	selected.  Au-
	      thenticated and Encrypted	modes require a	"shared	secret"	in the
	      form of a	pass-phrase that is used to generate the AES and HMAC-
	      SHA1 session keys.


       -k pfsfile
	      Use  the	pass-phrase in pfsfile for username to derive the sym-
	      metric AES key used for encryption.  username must have a	 valid
	      entry  in	pfsfile.  pfsfile can be generated as described	in the
	      pfstore(1) manual	page.

		     Unset. (If	the -u option was specified  without  the  -k,
		     the user will be prompted for a passphrase.)

       -S srcaddr
	      Bind  the	local address of the client socket to srcaddr. srcaddr
	      can be specified using a DNS name	or using standard textual  no-
	      tations for the IP addresses. (IPv6 addresses are	of course sup-

		     Unspecified (wild-card address selection).

       -u username
	      Specify the username that	identifies the	shared	secret	(pass-
	      phrase)  used  to	 derive	the AES	and HMAC-SHA1 session keys for
	      authenticated and	encrypted modes. If the	-k  option  is	speci-
	      fied,  the  pass-phrase is retrieved from	the pfsfile, otherwise
	      the user is prompted for a pass-phrase.



	      Contact host Fetch the uptime information and dis-
	      play it.

       owampd(8),     owping(1),     owstats(1),    aespasswd(1)    and	   the web site.

       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

	     $Date: 2007-03-06 17:02:45	-0500 (Tue, 06 Mar 2007) $     owup(1)


Want to link to this manual page? Use this URL:

home | help