FreeBSD Manual Pages
DC_SNOOP(1) distcache DC_SNOOP(1) NAME dc_snoop - Distributed session cache traffic analysis SYNOPSIS dc_snoop -listen <address> -server <address> [options] DESCRIPTION dc_snoop runs as a transparent proxy supporting the distcache(8) proto- col and (in theory) should work when inserted between any compliant tools. Ie. this can be used to monitor cache operation requests and re- sponses between applications and dc_client, or between dc_client and dc_server. This tool is still in early stages of development and is provided very much ``as-is''. It is intended to be used by developers with access to the source code - for now, most configurable behaviour of dc_snoop is set in source code and can not be manipulated on the command-line. OPTIONS -listen address Configures the address on which dc_snoop should listen for incoming connections. The syntax is that defined by the libnal API. -server address -connect address These flags are identical, and specify the address dc_snoop should transparently proxy all incoming connections to. For each connec- tion accepted by dc_snoop (on the address specified by -listen) a corresponding connection is opened to the address specified by these flags. When either connection is closed, dc_snoop will corre- spondingly close the other connection. -h, -help, -? Any of these flags will cause dc_snoop to display a brief usage summary to the console and exit cleanly. Any other flags are ig- nored. EXAMPLES This example demonstrates the use of dc_snoop to monitor communications between an instance of dc_client and dc_server both running on the same machine using only unix domain sockets. Suppose the tools are started and tested using the following commands; # Start services dc_server -daemon -listen UNIX:/tmp/cacheserver dc_client -deamon -listen UNIX:/tmp/cacheclient \ -server UNIX:/tmp/cacheserver # Run some tests dc_test -connect UNIX:/tmp/cacheclient The following modification should be functionally equivalent (ignoring the additional latency and overhead of dc_snoop's involvement) and should generate a log file of all cache transactions to logfile. Note the change to the -server flag in dc_client; # Start services dc_server -daemon -listen UNIX:/tmp/cacheserver dc_client -deamon -listen UNIX:/tmp/cacheclient \ -server UNIX:/tmp/cachesnoop # Start dc_snoop logging to logfile in the background dc_snoop -listen UNIX:/tmp/cachesnoop \ -server UNIX:/tmp/cacheserver > logfile & # Run some tests dc_test -connect UNIX:/tmp/cacheclient BUGS This program is incomplete and not at all configurable on the com- mand-line. SEE ALSO dc_client(1) Distributed caching client proxy. dc_server(1) Distributed cache server. distcache(8) Overview of the distcache architecture. http://www.distcache.org/ Distcache home page. AUTHOR This toolkit was designed and implemented by Geoff Thorpe for Crypto- graphic Appliances Incorporated. Since the project was released into open source, it has a home page and a project environment where devel- opment, mailing lists, and releases are organised. For problems with the software or this man page please check for new releases at the project web-site below, mail the users mailing list described there, or contact the author at geoff@geoffthorpe.net. Home Page: http://www.distcache.org 1.5.1 2004.10.19 DC_SNOOP(1)
NAME | SYNOPSIS | DESCRIPTION | OPTIONS | EXAMPLES | BUGS | SEE ALSO | AUTHOR
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=dc_snoop&sektion=1&manpath=FreeBSD+Ports+14.3.quarterly>