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

FreeBSD Manual Pages

  
 
  

home | help
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.4.5				  2004.03.23			   DC_SNOOP(1)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | EXAMPLES | BUGS | SEE ALSO | AUTHOR

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=dc_snoop&sektion=1&manpath=FreeBSD+12.1-RELEASE+and+Ports>

home | help