SBC_shell.h File Reference

SBC shell emulation services. More...

Functions
unsigned int	SBC_initialize (void)
	Startup SBC shell emulation.
unsigned int	SBC_shutdown (void)
	Shutdown SBC shell emulation.
unsigned int	SBC_shellLoad (const char *path)
	Load an application object module.
unsigned int	SBC_shellFunc (const char *name, unsigned int p0, unsigned int p1, unsigned int p2, unsigned int p3)
	Call an application initialization function.

---

Detailed Description

SBC shell emulation services.

Author:

D.L. Wood

These functions allow the secondary boot code loader and initializer to be used from the standard VxWorks target shell. These functions will not work under a Tornado configuration. SBC_initialize() must be called first to allocate static resources needed by the module loader.

---

Function Documentation

unsigned int SBC_initialize

(

void

)

Startup SBC shell emulation.

The entry point for the secondary boot code. This function should be run to start the SBC shell emulation services.

Returns:

A SBC MSG code.

References _SBC_Shell_Config::check, debugDiag, _SBC_Shell_Config::file_buf, _SBC_Shell_Config::func_count, _SBC_Shell_Config::module_count, SBC_error(), SBC_FILE_BUF_SIZE, SBC_mount(), SBC_TEMP_BUF_SIZE, and _SBC_Shell_Config::temp_buf.

unsigned int SBC_shellFunc	(	const char *	name,
		unsigned int	p0,
		unsigned int	p1,
		unsigned int	p2,
		unsigned int	p3
	)

Call an application initialization function.

Calls an application initialization function in SBC format.

Parameters:

	name	The function symbol name.
	p0	Function parameter 0.
	p1	Function parameter 1.
	p2	Function parameter 2.
	p3	Function parameter 3.

Returns:

A SBC MSG code.

References _SBC_Shell_Config::check, debugDiag, _SBC_Shell_Config::func_count, SBC_error(), and SBC_loadFunc().

unsigned int SBC_shellLoad

(

const char *

path

)

Load an application object module.

Loads an application ELF object module in SBC format. The object module data may be compressed.

Parameters:

path

The full path name of the object module file.

Returns:

A SBC MSG code.

References _SBC_Shell_Config::check, debugDiag, _SBC_Shell_Config::file_buf, _SBC_Shell_Config::module_count, SBC_error(), SBC_loadModule(), and _SBC_Shell_Config::temp_buf.

unsigned int SBC_shutdown

(

void

)

Shutdown SBC shell emulation.

Releases resources allocated during SBC_initialize().

Returns:

A SBC MSG code.

References _SBC_Shell_Config::check, debugDiag, _SBC_Shell_Config::file_buf, SBC_error(), and _SBC_Shell_Config::temp_buf.