News: Downloadable PDA Demos

Introduction

Technical Description

How To

Documents

Product Brief

White Paper

Supported Platforms

Consulting

License Terms

NFL Demo

Downloads

Secure Travel Demo

FAQ's for Users
& Developers

Registration Form and License Agreement

SDK Access

Client Access

Feedback

Other Sprex Products/Services

Exit

DDD(1)           ddd[tm] 1.2: Man Page Version 2           DDD(1)



NAME
       ddd - distributed debugging/logging daemon

SYNOPSIS
       ddd [ -p port ] [ -f file ] [ -v N ] [ -mMah?V ]

DESCRIPTION
       ddd , or distributed debugging/logging daemon, is a server
       program with an  associated  five-function  API  (dd_init,
       dd_open, dd_log, dd_test, dd_close) for debugging and log-
       ging distributed processes (including logging for  perfor-
       mance  analysis).  ddd is a simple, iterative, connection-
       less server, which prints all the messages it recieves  on
       its  incoming  port  to its stdout or the specified output
       file, stamped with their remote IP  address  and  time  of
       receipt.   Certain  messages, in multi-file format (see -m
       below) can also be logged to additional files,  as  speci-
       fied  by  the  incoming  message.  For example, to use the
       system, run dd_init(IP,4200), then dd_log(string) to  send
       a message to ddd for logging, and dd_close() to finish up.
       Watch the output of ddd ; any number of clients  can  take
       turns sending debugging and logging trace info to ddd

       ddd  gets  its  port number with first preference from the
       command line, then from /etc/services (not  for  Windows),
       then from DEFAULT_DDD_PORT in dd.h.


OPTIONS
       -p  port     Port number to wait on.  Default port is from
       /etc/services, or if not there, then from DEFAULT_DDD_PORT
       in dd.h.

       -f   file      Filename  to  write to, instead of standard
       output [default: none].

       -v  verbosity     [optional] Verbosity of debugging output
       (0=low, 1=medium or 2=high) [default: normally 0].

       -m      Write also to multiple files, according to message
       received (if possible to the  filename  specified  in  the
       recieved  message between the first two "|" tag characters
       in a message (if there are two tag characters in the  mes-
       sage) [not default].

       -M      Write also to multiple files, according to message
       received.  This option is just like the -m  option  above,
       except  that if no filename is found between the first two
       "|" tag characters  in  the  message,  then  an  error  is
       reported to standard output, or to the primary output file
       (if -f file is used) [not default].

       -a     Auto-reply to incoming messages of the form  "Reply
       to  this!"   with  a  UDP  message  of  the  form "ddd-1.2
       040519".

       -h     Print out help information [not default].

       -?      Print out help information [not default].

       -V     Print out version information.


EXAMPLES
       To get a list of options and  their  explanation,  use  no
       options:

              example% ddd


       To accept connections on port 4100, and log inputs via ddd
       , with the multifile option:


              example% ddd -p 4100 -M



BUGS
       None known.  Please report bugs to tv@sprex.com Your feed-
       back on this document is solicited.


AUTHORS
       Tom  Veatch  and  Fred  Kaudel,  Sprex,  Inc.   All rights
       reserved.  ddd is licensed software, to be used only under
       a license agreement with Sprex.



Product of Sprex, Inc.      18 May 2004                    DDD(1)