XFINDPROXY(1)						      General Commands Manual						     XFINDPROXY(1)

NAME

       xfindproxy - locate proxy services

SYNOPSIS

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

DESCRIPTION

       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	authoriza-
       tion/authentication  name.  The second line is the authorization/authentication data in hex format (the same format used by xauth).  xfind-
       proxy 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.

       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

       proxymngr (1), Proxy Management Protocol spec V1.0

AUTHOR

       Ralph Mor, X Consortium

XFree86 							   Version 4.7.0						     XFINDPROXY(1)