System

These routines are called by a programmer wishing to create or destroy an ET system. More...

Functions
int	et_system_start (et_sys_id *id, et_sysconfig sconfig)
	This routine creates an ET system. More...
int	et_system_close (et_sys_id id)
	This routine closes or shuts down an ET system. More...

Detailed Description

These routines are called by a programmer wishing to create or destroy an ET system.

Function Documentation

int et_system_close

(

et_sys_id

id

)

This routine closes or shuts down an ET system.

Parameters

id	ET system id.

Returns

ET_OK if successful.

ET_ERROR if not called by ET system process.

References et_system_t::asthread, et_station_t::conductor, et_system_t::config, et_list_t::cread, et_station_t::data, et_id_t::debug, ET_CLOSE_NSEC, ET_CLOSE_SEC, ET_DEBUG_ERROR, ET_ERROR, et_id_destroy(), et_logmsg(), ET_OK, ET_STATION_UNUSED, ET_SYS, ET_THREAD_KILL, et_id_t::grandcentral, et_station_t::list_out, et_id_t::memsize, et_sys_config_t::nstations, et_id_t::pmap, et_id_t::proc, et_system_t::statadd, et_stat_data_t::status, et_id_t::sys, et_system_t::tcpFd, et_system_t::tid_hb, et_system_t::tid_hm, et_system_t::tid_mul, et_system_t::tid_srv, and et_system_t::udpFd.

int et_system_start	(	et_sys_id *	id,
		et_sysconfig	sconfig
	)

This routine creates an ET system.

The process that executes this routine becomes the ET system process. A good example of its use is in the et_start.c file.

Parameters

id	pointer to ET system id - a value-result argument - in which is returned the id of the new system which gets created.
sconfig	desired configuration of the new ET system (set by routines starting with et_system_config_ ...).

Returns

ET_OK if successful.

ET_ERROR if ET system could not be created.

References et_id_t::alive, et_system_t::config, et_netthread_t::config, et_id_t::data, et_id_t::debug, err_abort, et_id_t::esize, et_cast_thread(), ET_DEBUG_ERROR, ET_DEBUG_INFO, ET_ERROR, ET_ERROR_EXISTS, et_id_destroy(), et_id_init(), et_init_histogram(), ET_INITIAL_SHARED_MEM_DATA_BYTES, ET_IS_ALIVE_NSEC, ET_IS_ALIVE_SEC, et_logmsg(), et_mem_attach(), et_mem_create(), et_mem_remove(), et_mem_write_first_block(), et_netserver(), ET_OK, ET_WAIT_FOR_THREADS, et_id_t::events, et_id_t::grandcentral, et_system_t::heartbeat, et_id_t::histogram, et_system_t::hz, et_netthread_t::id, et_id_t::memsize, et_id_t::nevents, et_id_t::offset, et_system_t::pmap, et_id_t::pmap, et_id_t::race, et_id_t::stats, et_id_t::sys, et_system_t::tid_as, et_system_t::tid_hb, et_system_t::tid_hm, et_system_t::tid_mul, et_system_t::tid_srv, and et_mem_t::totalSize.