RECEIVEDIP(1)							 RECEIVEDIP(1)



NAME
       receivedIP - list the IP addresses in "Received: " records in the head-
       ers of e-mail files

SYNOPSIS
       receivedIP [-v] [filename(s)]

DESCRIPTION
       ReceivedIP is for listing the IP addresses in "Received: "  records  in
       the headers of e-mail files to stdout. The order is the same as encoun-
       tered in the e-mail header.

       The program requires a Posix compatible regex(3) library to  parse  the
       IP  addresses.  The IP addresses from the e-mail headers are printed to
       stout.

       The input e-mail file name(s) may be supplied  as  additional  optional
       command line arguments, or redirected to the program via stdin for com-
       patibility with procmail(1), and other e-mail scripting agents.

       The program contains less than 200 lines  of  declarations  and	state-
       ments, all of which are documented with in line comments.

       The  program has been compiled and tested on SunOS, Solaris, and Linux,
       and may work on other brands of Unix.

       The program returns 0 if no error and IP addresses were	found  in  any
       "Received:  "  header  records,	1 if no error and no IP addresses were
       found; else returns a unique error code greater than 1 representing the
       error  encountered-which  will,	also,  print  an  error  diagnostic to
       stderr.

OPTIONS
       filename(s)
	      E-mail file name(s), (defaults to stdin).

       -v     Print the program's version information.

WARNINGS
       Under buffer overflow conditions, the program makes no attempts at han-
       dling  the  situation-it  just detects it, prints an error message, and
       exits.

SEE ALSO
       receivedIP(1),	       receivedIPdb(1), 	 receivedIPdbdedup(1),
       receivedIPdbrm(1),  receivedIPdbusort(1),  bsearchtext(1),  receivedAd-
       dress(1),  receivedTodb(1),  receivedMSGIDdb(1),  receivedUnknowndb(1),
       tolower(1),  toupper(1),  bsorttext(1)  receivedIPforgedb(1),  hsearch-
       text(1), bsearchbody(1)

DIAGNOSTICS
       Error messages for incompatible arguments, failure to allocate  memory,
       inaccessible  files,  opening  and  closing  files, input record buffer
       overflow, compiling regular expressions, and e-mail  header  format  or
       structure errors.

AUTHORS
       ----------------------------------------------------------------------

       A license is hereby granted to reproduce this software source code and
       to create executable versions from this source code for personal,
       non-commercial use.  The copyright notice included with the software
       must be maintained in all copies produced.

       THIS PROGRAM IS PROVIDED "AS IS". THE AUTHOR PROVIDES NO WARRANTIES
       WHATSOEVER, EXPRESSED OR IMPLIED, INCLUDING WARRANTIES OF
       MERCHANTABILITY, TITLE, OR FITNESS FOR ANY PARTICULAR PURPOSE.  THE
       AUTHOR DOES NOT WARRANT THAT USE OF THIS PROGRAM DOES NOT INFRINGE THE
       INTELLECTUAL PROPERTY RIGHTS OF ANY THIRD PARTY IN ANY COUNTRY.

       Copyright (c) 2001-2007, John Conover, All Rights Reserved.

       Comments and/or bug reports should be addressed to:

	   john@email.johncon.com (John Conover)

       ----------------------------------------------------------------------



			       January 16, 2007 		 RECEIVEDIP(1)