receivedip(1)

NAME

receivedIP - list the IP addresses in "Received: " records

in the headers 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 encountered 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 head

ers are printed to stout.

The input e-mail file name(s) may be supplied as addition

al optional command line arguments, or redirected to the program

via stdin for compatibility with procmail(1), and other e-mail

scripting agents.

The program contains less than 200 lines of declarations

and statements, all of which are documented with in line com

ments.

The program has been compiled and tested on SunOS, So

laris, 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 at

tempts at handling the situation-it just detects it, prints an

error message, and exits.

SEE ALSO

receivedIP(1), receivedIPdb(1), receivedIPdbdedup(1), re

ceivedIPdbrm(1), receivedIPdbusort(1), bsearchtext(1), re

ceivedAddress(1), receivedTodb(1), receivedMSGIDdb(1), receive

dUnknowndb(1), tolower(1), toupper(1), bsorttext(1) receivedIP

forgedb(1), hsearchtext(1), bsearchbody(1)

DIAGNOSTICS

Error messages for incompatible arguments, failure to al

locate memory, inaccessible files, opening and closing files, in

put 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 PUR

POSE. 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 Re

served.

Comments and/or bug reports should be addressed to:

john@email.johncon.com (John Conover)

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

January 16, 2007

RECEIVEDIP(1)