beautypg.com

Zgate_add_udp_port – Zilog EZ80F91GA User Manual

Page 87

background image

UM024502-1012

ZGATE Logging Page

ZGATE Embedded Security Development Kit

User Manual

75

ZGATE_add_udp_port

Function Prototype

INT16 ZGATE_add_udp_port( INT32 PortNumber );

Parameters

PortNumber

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

PortNumber

must be between 0 and 65535.

Return Value

TRUE

PortNumber

was successfully added to the UDP port static fil-

tering list.

FALSE

PortNumber

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

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

Description

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