BUG

Section: User Commands (1)
Index Return to Main Contents
 

NAME

bug - listen and transcribe communication on a socket  

SYNOPSIS

bug input_port output_port machine client_file server_file  

DESCRIPTION

bug is used to listen on a specified input_port and write an exact duplicate out to the output_port on a specified machine. It also writes a transcript of everything that is said on either port to seperate files. Each piece of communication is seperated by a MARK, which is #defined in the code as "<MARK>".

The naming scheme for the output files is client_file (for communication received from the input_port) or server_file (for communication received from the output_port) followed by a period ('.') followed by the process id of the bug program followed by a period ('.') followed by the process id of the child of bug which actually does the monitoring. Thus, for every connection made to the input_port, there will be two (unique) files created.

The output files are probably best read by using od(1) with the "-c" or "-cx" options.  

EXAMPLE

bug 3000 2999 moosebreath cl se

This invocation will create, for every connection to port 3000 on the current machine, two files (cl.pid.cpid and se.pid.cpid). Every communication to port 3000 is repeated verbatim to port 2999 on machine "moosebreath" and written to the first file. All responses are written to the second file.  

FILES


creates files based on client_file and server_file  

SEE ALSO

od(1), socket(2) [and friends], fork(2).  

AUTHOR

Matthew Merzbacher, bugs/comments - matthew@cs.ucla.edu  

BUGS

Goodness knows what systems this will actually run on. Any BSD or BSD-derived system SHOULD work.

There should be an option to change the MARK.


 

Index

NAME
SYNOPSIS
DESCRIPTION
EXAMPLE
FILES
SEE ALSO
AUTHOR
BUGS

This document was created by man2html, using the manual pages.
Time: 10:10:14 GMT, December 12, 2024