XFINDPROXY(1)	X Version 11 (Release 6.4)	 XFINDPROXY(1)



     NAME    [Toc]    [Back]
	  xfindproxy - locate proxy services

     SYNOPSIS    [Toc]    [Back]
	  xfindproxy -manager managerAddr -name	serviceName -server
	  serverAddr [-auth] [-host hostAddr] [-options	opts]

     DESCRIPTION    [Toc]    [Back]
	  xfindproxy is	a program used to locate available proxy
	  services.  It	utilizes the Proxy Management Protocol to
	  communicate with a proxy manager.  The proxy manager keeps
	  track	of all available proxy services, starts	new proxies
	  when necessary, and makes sure that proxies are shared
	  whenever possible.

	  The -manager argument	is required, and it specifies the
	  network address of the proxy manager.	 The format of the
	  address is a standard	ICE network id (for example,
	  "tcp/blah.x.org:6500").

	  The -name argument is	required, and it specifies the name of
	  the desired proxy service (for example, "LBX").  The name is
	  case insensitive.

	  The -server argument is also required, and it	specifies the
	  address of the target	server.	 The format of the address is
	  specific to the proxy	service	specified with the -name
	  argument.  For example, for a	proxy service of "LBX",	the
	  address would	be an X	display	address	(e.g, "blah.x.org:0").

	  The -auth argument is	optional.  If specified, xfindproxy
	  will read 2 lines from standard input.  The first line is an
	  authorization/authentication name.  The second line is the
	  authorization/authentication data in hex format (the same
	  format used by xauth).  xfindproxy will pass this auth data
	  to the proxy,	and in most cases, will	be used	by the proxy
	  to authorize/authenticate itself to the target server.

	  The -host argument is	optional.  If xfindproxy starts	a new
	  proxy	service, it will pass the host specified.  The proxy
	  may choose to	restrict all connections to this host.	In the
	  event	that xfindproxy	locates	an already existing proxy, the
	  host will be passed, but the semantics of how	the proxy uses
	  this host are	undefined.

	  The -options argument	is optional.  If xfindproxy starts a
	  new proxy service, it	will pass any options specified.  The
	  semantics of the options are specific	to each	proxy server
	  and are not defined here.  In	the event that xfindproxy
	  locates an already existing proxy, the options will be
	  passed, but the semantics of how the proxy uses these
	  options are undefined.



     Page 1					     (printed 10/9/01)






     XFINDPROXY(1)	X Version 11 (Release 6.4)	 XFINDPROXY(1)



	  If xfindproxy	is successful in obtaining a proxy address, it
	  will print it	to stdout.  The	format of the proxy address is
	  specific to the proxy	service	being used.  For example, for
	  a proxy service of "LBX", the	proxy address would be the X
	  display address of the proxy (e.g, "blah.x.org:63").

	  If xfindproxy	is unsuccessful	in obtaining a proxy address,
	  it will print	an error to stderr.

     SEE ALSO    [Toc]    [Back]
	  proxymngr (1), Proxy Management Protocol spec	V1.0

     AUTHOR    [Toc]    [Back]
	  Ralph	Mor, X Consortium









































     Page 2					     (printed 10/9/01)