beautypg.com

Zgate_initialize – Zilog EZ80F91GA User Manual

Page 68

background image

ZGATE API Reference

UM024502-1012

56

ZGATE Embedded Security Development Kit
User Manual

ZGATE_initialize

Function Prototype

void ZGATE_initialize( void );

Parameters

None.

Return Value

None.

Description

This function initializes the ZGATE memory pools and data structures and reads the
ZGATE filtering rules. These filtering rules are either read from a file in the file system or
placed in a C file that is linked to the ZTP application. ZGATE searches for a configura-
tion file containing the filtering rules in the following sequence:

1. Read the filtering rules from a file named

zg_rules.usr

in the root folder of the file

system. If this file is not found – or if ZFS is not enabled – then:

2. Read the filtering rules from a file named

zg_rules.def

in the root folder of the file

system. If this file is not found – or if ZFS is not enabled – then:

3. Read the filtering rules from a file named

ZGATE_Conf.c

that is linked to the ZTP

application.

ZGATE will not perform any packet filtering until the

ZGATE_initialize

function is

called. This API must be called before calling any other ZGATE API.