0. Introduction

IMHear is a libpcap based concole application which carries out
a simple task, sniffing MSN sessions inside a local area network and
log essential all useful messages.

1. Commandline Arguments

IMHear takes one optional argument. If no argument is supplied when running
IMHear, it will scan all available network adapter installed and print them
out. Then you can run IMHear by specifing on which network adapter you want
IMHear to sniff. Usually the device name looks like like "eth0" or so. As
IMHear listed all network adapters, the first one in the list is referred
as device 0, the second one is referred as device 1 and so on. Hence if you
want IMHear to sniff on the second device, simply type in 

	hear 1

2. Output and Log File

IMHear will output everything it sniffed about any live MSN session and put
everything into log files in the subdirectory ./log. You need to create the
subdirectory ./log manauly, otherwise, no log will be generated. The
name of the log file is the x-x-x-x_y, where x-x-x-x is the local IP address
that has a connection to the MSN server, y is the port number adopted by the
TCP connection.

3. More Information

For more information on MSN protocol, refer to

	MSN Messenger Service 1.0 Protocol
	http://www.hypothetic.org/docs/msn/
	http://www.hypothetic.org/docs/msn/ietf_draft.php

Hai Huang
Sep 11st, 2002

# Note: Irrelevant sections of this file have been removed
# by the porter to suit the FreeBSD ports collection. The
# original readme file is available from:
#
# http://mathpost.la.asu.edu/~hai/hear/
#
# Nicolas Gieczewski
# nick@nixsoftware.com
