System
[Developer routines]

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.
int	et_system_close (et_sys_id id)
	This routine closes or shuts down an ET system.

---

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_sys_config_t::bcastaddrs, et_station_t::conductor, et_system_t::config, et_list_t::cread, et_station_t::data, et_id_t::debug, ET_DEBUG_ERROR, ET_ERROR, et_id_destroy(), et_logmsg(), ET_MON_NSEC, ET_MON_SEC, ET_OK, ET_STATION_UNUSED, ET_SYS, ET_THREAD_KILL, et_id_t::grandcentral, et_station_t::list_out, et_sys_config_t::mcastaddrs, 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::tid_hb, et_system_t::tid_hm, and et_system_t::tid_srv.

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_netthread_t::config, et_id_t::data, et_id_t::debug, err_abort, et_id_t::esize, ET_BEAT_NSEC, ET_BEAT_SEC, et_cast_thread(), ET_DEBUG_ERROR, ET_DEBUG_INFO, ET_ERROR, ET_ERROR_EXISTS, ET_EXTRA_THREADS, et_id_destroy(), et_id_init(), et_init_histogram(), ET_INITIAL_SHARED_MEM_DATA_BYTES, et_logmsg(), et_mem_attach(), et_mem_create(), et_mem_remove(), et_mem_write_first_block(), ET_MON_NSEC, ET_MON_SEC, 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::stats, et_id_t::sys, et_system_t::tid_hm, et_mem_t::totalSize, and et_mem_t::usedSize.