beautypg.com

Zgate_remove_tcp_port – Zilog EZ80F91GA User Manual

Page 86

background image

ZGATE API Reference

UM024502-1012

74

ZGATE Embedded Security Development Kit
User Manual

ZGATE_remove_tcp_port

Function Prototype

INT16 ZGATE_remove_tcp_port( INT32 value );

Parameters

PortNumber

The TCP port number to be removed from the TCP port static fil-
tering list. The value of

PortNumber

must be between 0 and

65535.

Return Value

TRUE

PortNumber

was successfully removed from the TCP port static

filtering list.

FALSE

PortNumber

is invalid, does not exist in the TCP port static fil-

tering list, 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 remove an entry from the TCP Port static filtering list. Entries cannot
be removed from the TCP Port list if the TCP Port filter is disabled.