State Name Reference Routines; Xact_Find_Wildcard_State_Name - Intel IXP2400 User Manual

®
Intel IXP2400/IXP2800 Network Processors
Simulator APIs
Table 12. XACT API Functions (Continued) (Sheet 3 of 3)
XACT_init_gui_console
XACT__gui_execute_command
XACT_Define_Callback_Output_Message
XACT_Define_Callback_Set_Prompt
XACT_Define_Callback_Get_Console_Input
XACT_start_console
XACT_initialize
XACT_CTRL_C_SWITCH
XACT_stop_execution
XACT_stop_execution_at_clk
XACT_exit_transactor
XACT_gui_interface
9.3

State Name Reference Routines

9.3.1

XACT_find_wildcard_state_name

This function can be iteratively called to return all state names that match the wildcard name spec
("*" is the wildcard character that can match 0 or more characters). A non-NULL wildcard name
spec indicates that a new wildcard name search is initiated; a NULL wildcard name spec indicates
that the next name to match the previously initiated wildcard search should be returned. Each
matching state name is returned in rtn_name_buf provided that the specified
rtn_name_buf_length is large enough to hold the name.
Synopsis
Returns
260
Function Name
XACTAPI XACT find_wildcard_state_name(char
*wildcard_name_spec, char *rtn_name_buf,
unsigned int rtn_name_buf_length)
0 if no match is found
1 if match is found
-1 if match is found but not returned due to size of rtn_name_buf
Function Description
Initializes the command line parsing done by
XACT_gui_execute_command
Executes a command line in a gui (e.g. Developer
Workbench) environment
Passes transactor output strings to callback function.
Registers the callback to pass the transactor prompt to
an external command line
Registers the callback necessary for the transactor
console function to fetch console input from an external
source
Starts the transactor console
Initializes the transactor for operation when the
transactor function is accessed via a library
Enables or disables the transactor CTRL-C function
Stops simulation at the end of the next simulation cycle
Stops simulation at the end of the next simulation cycle
that aligns to the specified clock cycle
Forces termination of the transactor after the next input
command
Returns TRUE if the GUI interface is connected to the
transactor
Development Tools User's Guide