beautypg.com

Zgate_add_tcp_port – Zilog EZ80F91GA User Manual

Page 85

background image

UM024502-1012

ZGATE Logging Page

ZGATE Embedded Security Development Kit

User Manual

73

ZGATE_add_tcp_port

Function Prototype

INT16 ZGATE_add_tcp_port( INT32 PortNumber );

Parameters

PortNumber

TCP port number to be added to the TCP port static filtering list.
The value of

PortNumber

must be between 0 and 65535.

Return Value

TRUE

PortNumber

was successfully added to the TCP port static filter-

ing list.

FALSE

PortNumber

is invalid, already exists in the TCP port static fil-

tering list, the list is full, or the TCP Port filter is disabled.

Description

When the TCP Port filter is operating in WHITELIST (forwarding) or BLACKLIST
(blocking) Mode, it extracts the destination TCP port number from inbound TCP data seg-
ments and compares the target port number to entries in the TCP port list. If a match is
found, the packet is forwarded to ZTP if the 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 TCP Port static filtering list. Entries cannot be
added to the TCP Port list if the TCP Port filter is disabled.