beautypg.com

Zgate_add_ip_prot – Zilog EZ80F91GA User Manual

Page 95

background image

UM024502-1012

ZGATE Logging Page

ZGATE Embedded Security Development Kit

User Manual

83

ZGATE_add_ip_prot

Function Prototype

INT16 ZGATE_add_ip_prot( INT32 IP_Prot );

Parameters

IP_Prot

IP protocol number to be added to the IP Protocol number static
filtering list. The value of

IP_Prot

must be between 1 and 254.

Return Value

TRUE

IP_Prot

was successfully added to the IP Protocol number static

filtering list.

FALSE

IP_Prot

is invalid, already exists in the IP Protocol static filter-

ing list, the list is full or the IP Protocol filter is disabled.

Description

When the IP Protocol filter is operating in WHITELIST (forwarding) or BLACKLIST
(blocking) Mode, it extracts the IP protocol field from inbound IP packets and compares it
to entries in the IP Protocol number static filtering list. If a match is found, the frame is
forwarded to ZTP if the IP Protocol filter operates in WHITELIST Mode and blocked
from TCP if the filter operates in BLACKLIST Mode.

This API is used to add an entry to the IP protocol static filtering list. Entries cannot be
added to the list if the IP protocol filter is disabled.