testprogs/win32/rpcecho/README

   1 This directory contains two win32 programs to test large RPC requests
   2 and responses.  The two programs are:
   3
   4   server        A command line RPC server that listens and processes
   5                 RPC requests on the \pipe\rpcecho named pipe.
   6
   7   client        A command line RPC client program that
   8
   9 Samba also implements the client and server sides of the rpcecho pipe
  10 if the --enable-developer option to configure has been used.  The
  11 rpcclient(1) program is used to implement the client side RPC
  12 operations.
  13
  14 There are currently four RPC calls defined in the rpcecho pipe.  They
  15 are:
  16
  17   AddOne        Adds one to an integer sent by the client
  18
  19   EchoData      The client sends an array of bytes and it is echoed
  20                 back by the server.
  21
  22   SourceData    The client sends an array of bytes and it is discarded
  23                 by the server.
  24
  25   SinkData      The server returns an array of bytes.
  26
  27 The Ethereal network protocol decoder (http://www.ethereal.com/) also
  28 contains support for the rpcecho pipe as part of its DCERPC for
  29 Windows.
  30
  31 Starting the win32 server program is easy.  Just run server.exe in a
  32 command window.  The win32 client program is also run from a command
  33 window.  The usage information is shown below:
  34
  35   Usage: client hostname cmd [args]
  36
  37   Where hostname is the name of the host to connect to,
  38   and cmd is the command to execute with optional args:
  39
  40         addone num      Add one to num and return the result
  41         echodata size   Send an array of size bytes and receive it back
  42         sinkdata size   Send an array of size bytes
  43         sourcedata size Receive an array of size bytes
  44
  45 Tim Potter
  46 tpot@samba.org