beautypg.com

Zgate shell command reference – Zilog EZ80F91GA User Manual

Page 58

background image

ZGATE Shell Command Reference

UM024502-1012

46

ZGATE Embedded Security Development Kit
User Manual

ZGATE Shell Command Reference

The ZGATE Demo program includes source code to a set of shell commands that can be
used to modify the behavior of ZGATE at run time. These shell commands are available
on the ZTP console, which is accessed through a PC terminal emulation program such as
Tera Term or HyperTerminal via a serial cable connected to the ZGATE Embedded Secu-
rity Development Kit. These shell commands are also available through a PC-based Telnet
client (provided that ZTP’s Telnet server has been enabled). The ZGATE shell commands
provide a superset of the functionality of the web interface.

Some of the commands described in this section will not operate if the corresponding
ZGATE feature is either disabled or not included in the ZGATE device. For example, if
Ethernet address filtering is disabled, the shell command to add an entry to the Ethernet
Address filtering list will not function. As another example, because threshold filtering is
only available on select ZGATE devices, the shell command to alter the threshold filtering
parameters will not function on all ZGATE devices.

The ZGATE shell commands cannot be used to enable a filtering feature that has been dis-
abled in the start-up configuration settings. Similarly, the shell commands cannot be used
to change the filtering mode of a filtering list from/to whitelist filtering to/from blacklist
filtering.

From within the ZTP console, entering

help

followed by the name of the ZGATE shell

command will display a description of the command’s function. Entering the name of a
command followed by

?

will display the syntax rules for the command.

The ZGATE shell commands implemented in the ZGATE demo program make use of the
ZGATE configuration API (see the chapter titled

ZGATE API Reference

, on page 54 for

more information).