This function tests an IP against the GBUdb. This function returns very quickly and can be called as often as required without any follow-up actions as long as the SNF Engine is active (between startupSNF() and shutdownSNF()). This function is thread-safe and does not interfere with other scanning functions.

GBUdb gathers its statistics based on the message scans that are performed. Information about those scans is also shared with other SNF nodes approximately once every minute. No external queries are performed to gather GBUdb data. As a result GBUdb can only provide an IP reputation for IPs that sourced messages scanned by this SNF node.

Put another way - GBUdb does not work like a conventional real-time black list. Message scans must be performed in order for GBUdb to provide IP reputation information.

IPToCheck = The IP to test.

returns an integer representing the GBUdb Range associated with the IP if successful otherwise snf_ERROR_EXCEPTION.

GBUdb Range MNemonics from enum snfIPRange

Unknown, snf_IP_Unknown = 0

White, snf_IP_White = 1

Normal, snf_IP_Normal = 2

New, snf_IP_New = 3

Caution, snf_IP_Caution = 4

Black, snf_IP_Black = 5

Truncate, snf_IP_Truncate = 6