INVREGEX TOOL
  Home
  Requirements
  Features
  Configuration
  Rule File Syntax
  Declude Configuration
  Download
  Purchase
  Support
  FAQ



Update Notifications
Would you like to be notified when this product is updated?

If so click here to subscribe to our mailing list.

Invariant Systems URI Lookup Tool

invRegEx - Release v1.0
invRegEx is a tool that can be used to execute regular expressions against an email message. Regular expressions are very powerful and more efficient to identify patterns in messages.

invRegEx will decode mime segments and skips searching attachments to make your pattern matching as effective and efficient as possible. In addition, invRegEx will allow you to search on specific parts of an email message such as just the from field in the headers.

invRegEx will work with any mail server product that can call an external program and process its return code. We have instructions on how to integrate invRegEx into several popular anti-spam products like Declude Junkmail.

invRegEx is a free utility for anyone to use and is offered "AS IS".

Requirements

invRegEx.exe has the following requirements
  • Microsoft .NET Framework Version 1.1

    • Features

  • Mime Decoding including Nested Mime Segments
  • Ability To Skip Processing Based On SKIP Weight
  • Skips Attachments
  • Ability to search specific parts of the email message

    • Configuration

    Command Line:
    invRegEx.exe <SKIPWEIGHT> <CURRENT WEIGHT> <rulefile=1> <PATH TO MESSAGE>

    Example:
    invRegEx.exe 30 0 rulefile=1 C:\SPOOL\MESSAGE.SMD

    We also have a configuration file (invRegEx.exe.config) where you can configure other options relating to logging and some other advanced settings. Below is a list of all the keys and the options associated with them.

    License_Key:
    Description: No license key is required for invRegEx to work.

    LogFile_Path:
    Description: Path to where the log file will be generated.
    Values: Empty or Path to where the logfile will be generated

    Log_Mode:
    Description: Determines the level of logging that will occur.
    Values: NONE, NORMAL, HIGH, VERBOSE.
    NONE - No logging will occur.
    NORMAL - Matches will be Logged.
    HIGH - More detail will be logged than normal.
    VERBOSE - Detailed logging information.

    Display_Match_In_Log_File:
    Description: Determines if invRegEx will log the line in the message that matches the Regular Expression.
    Values: True, False

    StopAtFirstHit:
    Description: Program will return after matching the first regular expression.
    Values: True, False

    RuleFileX:
    Description: This specifies the location of RuleFileX. You can create multiple rule files if you desire. Just change the "X" to a specific number. To use that RuleFile make sure you adjust your command line paramter "rulefile=X" as well.
    Values: Path/Filename of the additional rule file

    Return Codes

    Will return the sum of the weights from the invRegEx-Rules.txt file.

    Rule File Configuration

    Every rule must be formatted as follows:
    <FIELD><TAB CHARACTER><VALUE><TAB CHARACTER></><REGULAREXPRESSION>

    FIELD: SUBJECT, FROM, TO, REPLY-TO, MESSAGE-ID, DATE, HEADERS, RECEIVED, X-MAILER, CONTENT-TYPE, and BODY

    VALUE: Any numeric value. This is the value that the application returns when a regular expression was triggered. All values in the rule file that is included in the zip are set to Zero by default. If you do not use "STOPATFIRSTHIT" the value returned will the the sum of all the regular expressions that were triggered on.

    REGULAR EXPRESSION:Any valid regular expression. Please note this program requires that all regular expressions start with a "/" character. This just tells invREGEX that the following text is the regular expression. See the invRegEx-RUles.txt sample rule file included in the zip file for specific examples of syntax.

    Declude Configuration

    For users of Declude's anti spam product Declude Junkmail here is an example configuration that can be used in your Declude Junkmail "global.cfg".

    INV-REGEX external nonzero "E:\IMAIL\DECLUDE\INVREGEX\invRegEx.exe 200 %WEIGHT% rulefile=1" 0 0

    *Please make sure you update the paths to where you installed invRegEx.exe. Also, make sure you add an entry for this test into your $default$.junkmail file.

    Notes:
  • The above line is setup as a "nonzero" test which means any return code other than zero will cause this test to add 0 to the messages current weight. Please adjust the weight for your system


  • Please note with Declude you do not need to specify the <PATH> parameter. This is because Declude will automatically add it after the %WEIGHT% variable.

    • Download

    Latest Version: 1.0 (Updated 2/12/2005)
    To download click here

    There is no installer for this application. Just unzip the files contained in the zip into a folder on your system.

    Purchase

    The invRegEx download from our website is a fully functional program. It does not require a license key. It will not expire at some future date. You are NOT required to pay anything to use this program. However, if you find this program useful and would like to make a donation we would greatly appreciate that. Donations allow us to continue working to create useful tools. To make a donation for this product please see the following Link.

    Support

    This application is offered "AS IS". Support will only be provided to current customers of other Invariant Systems Products. If you find a bug or have a feature suggestion please contact us at our Or join our

    FAQ

    Q. How is invRegEx licensed?
    A. invRegEx is offered as an "AS IS" tool. You can run it on any server that you would like to for free.

    Q. How can I monitor what invRegEx.exe is doing?
    A. In the directory where you installed the application a text file will be created when each message is scanned. This also depends on what your current logging level is.

    Q. Do you intend to make another version not using the .Net framework?
    A. We are still in the process of considering future language support for this tool.