/mnt/hgfs/jamie_On_My_Mac/store/version_control/svn/integralive/library/trunk/src/server.c File Reference

#include <stdlib.h>
#include <stdio.h>
#include <string.h>
#include <assert.h>
#include <pthread.h>
#include "Integra/integra_bridge.h"
#include "Integra/integra_lua.h"
#include "Integra/integra_server.h"
#include "Integra/integra_value.h"
#include "Integra/integra_types.h"
#include "Integra/integra_error.h"
#include "Integra/integra_path.h"
#include "xmlrpc.h"
#include "debug.h"
#include "helper.h"
#include "memory.h"
#include "namespace.h"
#include "globals.h"
#include "luascripting.h"

Functions
ntg_definition *	ntg_get_definition_by_name (const ntg_server server, const char name)
char *	ntg_get_type_by_id (const ntg_server *server, const int id)
char	ntg_type_code_from_type_string (const char *type)
char *	ntg_get_scope_by_id (const ntg_server *server, const int id)
ntg_module_attribute *	ntg_get_module_attribute_by_id (const ntg_server *server, const int id)
ntg_default_value *	ntg_get_default_value_by_id (ntg_server *server, const int id)
char *	ntg_get_unit_by_id (ntg_server *server, const int id)
char *	ntg_get_scale_by_id (ntg_server *server, const int id)
char *	ntg_get_control_attribute_by_id (ntg_server *server, const int id)
char *	ntg_get_control_by_control_attribute_id (ntg_server *server, const int id)
ntg_class_list *	ntg_classlist (const ntg_server *server)
	Get the list of available classes from the server.
ntg_definition *	ntg_classinfo (ntg_server server, const char class_name)
	Get the definition for a given class.
ntg_attribute_list *	ntg_attributes (const ntg_server server, const char class_name)
	Get the attribute definitions for a given class.
ntg_error_code	ntg_runscript (ntg_server server, const char script)
	Evaluate a string containing script code.
ntg_node_list *	ntg_nodelist (const ntg_server server, const ntg_path path)
	Get the list of paths to instances on the server under a given node.
char *	ntg_connect (const ntg_server server, const char source_name, const char source_attribute, const char target_name, const char *target_attribute)
ntg_error_code	ntg_disconnect (const ntg_server server, const char source_name, const char source_attribute, const char target_name, const char *target_attribute)
char *	ntg_new (const ntg_server server, const char class_name, const char instance_name, const ntg_path path)
	Create a new instance of a class on the server.
ntg_error_code	ntg_delete (ntg_server server, const ntg_path path)
	Delete an instance of a class on the server.
ntg_error_code	ntg_rename (const ntg_server server, const ntg_path path, const char *name)
	Rename an instance of a class on the server.
ntg_error_code	ntg_save (const ntg_server server, const ntg_path path, const char *file_path)
	Save all nodes including and below a given node on the server to a path on the filesystem.
ntg_error_code	ntg_load (const ntg_server server, const char file_path, const ntg_path *path)
	Load all nodes including and below a given node from the filesystem beneath the path given to the given node on the server.
ntg_error_code	ntg_move (const ntg_server server, const ntg_path instance_path, const ntg_path *parent_path)
	Move an instance of a class on the server.
ntg_error_code	ntg_set (const ntg_server server, const ntg_path path, const ntg_value *value)
	Set the value of an attribute of an instance on the server.
ntg_value *	ntg_get (const ntg_server server, const ntg_path path)
	Get the value of an attribute of an instance on the server.
ntg_server *	ntg_server_new (void)
void	ntg_lock_server (void)
void	ntg_unlock_server (void)
void *	ntg_server_do (ntg_server_callback callback, const int argc,...)
ntg_bridge_callback	ntg_server_run (const char *bridge_file, const int port)
	Create a new Integra server.
ntg_instance *	ntg_server_get_root (const ntg_server *server)
	Get the root of the instance graph.
void	ntg_server_set_root (ntg_server server, ntg_instance root)
void *	server_receive_callback (ntg_id id, unsigned int port, const int argc, const ntg_value message, void(bridge_send_callback)(const ntg_port , const ntg_value ))
	Callback function corresponing to ih_callback in the bridge interface (see integra_bridge.h ntg_bridge_interface->ih_callback.
int	ntg_server_add_namespace (void server, ntg_bridge_interface p)
ntg_node_list *	ntg_server_get_nodelist (const ntg_server server, ntg_instance container, ntg_path parent_path, ntg_node_list nodelist)
	Get the list of nodes under a container instance as an array.
ntg_attribute_list *	ntg_server_get_class_attributes (const ntg_server server, const char class_name, ntg_attribute_list *attribute_list)
	Recursively get the attributes for a class.
ntg_error_code	ntg_server_update_connection (ntg_server server, const ntg_instance connection_instance, const ntg_instance_attribute *instance_attribute)
	Update a connection in the connection list.
ntg_error_code	ntg_server_delete_connection (ntg_server server, const ntg_instance connection_instance)
	Delete a connection in the connection list.
ntg_error_code	ntg_server_new_connection (ntg_server server, const ntg_instance connection_instance)
	New connection in the connection list.
ntg_error_code	ntg_server_delete_orphaned_connections (ntg_server *server)
	Delete orphaned connections on the server This function also disconnects the connection in the module host if needed.
int	ntg_server_instance_delete_r_ (ntg_server server, ntg_instance instance)
ntg_error_code	ntg_server_instance_delete (ntg_server server, ntg_instance instance)
	Remove an instance from the server.
ntg_error_code	ntg_server_fix_connections (ntg_server server, ntg_instance instance, const char *name)
	Fix connections that point to instance so that the point to 'name'.

Function Documentation

ntg_attribute_list* ntg_attributes	(	const ntg_server *	server,
		const char *	class_name
	)

Get the attribute definitions for a given class.

Parameters:

	*server,:	a pointer to a struct of type ntg_server
	*class_name,:	a NULL terminated string giving the name of the class

Returns:: a pointer to an ntg_attribute_list struct containing the attribute definition for all of the class's attributes a pointer to NULL is returned if an error occurs

References ntg_server_get_class_attributes().

Referenced by ntg_connect(), ntg_disconnect(), and ntg_new().

ntg_definition* ntg_classinfo	(	ntg_server *	server,
		const char *	class_name
	)

Get the definition for a given class.

Parameters:

	*server,:	a pointer to a struct of type ntg_server.
	*class_name,:	a NULL terminated string giving the name of the class

Returns:: a pointer to an ntg_definition struct containing data on the class a pointer to NULL is returned if an error occurs

References ntg_get_definition_by_name().

ntg_class_list* ntg_classlist ( const ntg_server * server )

Get the list of available classes from the server.

Parameters:

*server,:

a pointer to a struct of type ntg_server.

Returns:: a pointer to an ntg_class_list struct containing class list as strings a pointer to NULL is returned if an error occurs

References _ntg_model::allocated_definitions, ntg_class_list_::classes, ntg_server_::classlist, _ntg_model::definitions, ntg_server_::model, ntg_class_list_::n_classes, _ntg_model::n_definitions, and _ntg_definition::name.

Referenced by ntg_server_new().

char* ntg_connect	(	const ntg_server *	server,
		const char *	source_name,
		const char *	source_attribute,
		const char *	target_name,
		const char *	target_attribute
	)

ntg_error_code ntg_delete	(	ntg_server *	server,
		const ntg_path *	path
	)

Delete an instance of a class on the server.

Parameters:

	*server,:	a pointer to a struct of type ntg_server
	*path,:	a pointer to a struct of type ntg_path giving the elements in the path to the given instance. The path array must include the instance itself, i.e. if we are deleting an instance called 'FooBar1', the path array might be ['Project1', 'Block1', 'FooBar1']

Returns:: a struct of type ntg_error_code. If the function succeeded, the return value will be NTG_NO_ERROR possible return values for error status are given in integra_error.h

References ntg_server_::bridge, ntg_server_::connection_list, DB_SERVER, DEBUG_POST(), NTG_ERROR, ntg_instance_find_by_path(), NTG_NO_ERROR, ntg_server_delete_orphaned_connections(), ntg_server_get_root(), and ntg_server_instance_delete().

ntg_error_code ntg_disconnect	(	const ntg_server *	server,
		const char *	source_name,
		const char *	source_attribute,
		const char *	target_name,
		const char *	target_attribute
	)

ntg_value* ntg_get	(	const ntg_server *	server,
		const ntg_path *	path
	)

Get the value of an attribute of an instance on the server.

Parameters:

	*server,:	a pointer to a struct of type ntg_server in the path to the given instance. The path array must include the instance itself, i.e. if we are getting the value of an attribute in instance called 'FooBar1', the path array might be ['Project1', 'Block1', 'FooBar1']
	*path,:	a pointer to a struct of type ntg_path giving the elements in the path to the given attribute. The path array must include the attribute itself, i.e. if we are getting the value of an attribute called 'blah' in an instance called 'FooBar1', the path array might be ['Project1', 'Block1', 'FooBar1', 'blah']. If the path is invalid, or the final element doesn't correspond to an attribute an error code of NTG_PATH_ERROR will be returned

Returns:: a pointer to a struct of type ntg_value. The type (see integra_types.h) of the value returned is guaranteed to match the type of the attribute as given in the attribute definition a pointer to NULL is returned if an error occurs

References ntg_path_::elems, ntg_path_::n_elems, ntg_instance_attribute_find_by_name(), ntg_instance_find_by_path(), NTG_NO_ERROR, ntg_path_free(), ntg_path_pop_element(), ntg_path_validate(), ntg_print_error(), ntg_server_get_root(), and ntg_instance_attribute_::value.

char* ntg_get_control_attribute_by_id	(	ntg_server *	server,
		const int	id
	)

References _ntg_model::control_attributes, ntg_server_::model, and _ntg_control_attribute::name.

char* ntg_get_control_by_control_attribute_id	(	ntg_server *	server,
		const int	id
	)

References _ntg_model::control_attributes, _ntg_model::control_classs, _ntg_control_attribute::id_control_class, ntg_server_::model, and _ntg_control_class::name.

ntg_default_value* ntg_get_default_value_by_id	(	ntg_server *	server,
		const int	id
	)

References _ntg_model::default_values, and ntg_server_::model.

Referenced by ntg_new().

ntg_definition* ntg_get_definition_by_name	(	const ntg_server *	server,
		const char *	name
	)

References _ntg_model::allocated_definitions, _ntg_model::definitions, ntg_server_::model, and _ntg_definition::name.

Referenced by ntg_classinfo(), ntg_new(), and ntg_server_get_class_attributes().

ntg_module_attribute* ntg_get_module_attribute_by_id	(	const ntg_server *	server,
		const int	id
	)

References ntg_server_::model, and _ntg_model::module_attributes.

Referenced by ntg_new().

char* ntg_get_scale_by_id	(	ntg_server *	server,
		const int	id
	)

References _ntg_model::attribute_scales, ntg_server_::model, and _ntg_attribute_scale::name.

char* ntg_get_scope_by_id	(	const ntg_server *	server,
		const int	id
	)

References _ntg_model::attribute_scopes, ntg_server_::model, and _ntg_attribute_scope::name.

char* ntg_get_type_by_id	(	const ntg_server *	server,
		const int	id
	)

References _ntg_model::attribute_types, ntg_server_::model, and _ntg_attribute_type::name.

Referenced by ntg_new().

char* ntg_get_unit_by_id	(	ntg_server *	server,
		const int	id
	)

References _ntg_model::attribute_units, ntg_server_::model, and _ntg_attribute_unit::name.

ntg_error_code ntg_load	(	const ntg_server *	server,
		const char *	file_path,
		const ntg_path *	path
	)

Load all nodes including and below a given node from the filesystem beneath the path given to the given node on the server.

Parameters:

	*server,:	a pointer to a struct of type ntg_server
	*file_path,:	a pointer to a string representing the path to the file on the filesystem
	*path,:	a pointer to a struct of type ntg_path giving the elements in the path to the parent instance under which the new instance will be loaded. i.e. if we are loading an instance inside Project1 the path would be ['Project1']. A NULL value indicates that the new instance will be loaded under the server root node

Returns:: a struct of type ntg_error_code. If the function succeeded, the return value will be NTG_NO_ERROR possible return values for error status are given in integra_error.h

References NTG_FAILED.

void ntg_lock_server ( void )

Referenced by ntg_server_do().

ntg_error_code ntg_move	(	const ntg_server *	server,
		const ntg_path *	instance_path,
		const ntg_path *	parent_path
	)

Move an instance of a class on the server.

Parameters:

	*server,:	a pointer to a struct of type ntg_server
	*instance_path,:	a pointer to a struct of type ntg_path giving the elements in the path to the given instance. The path array must include the instance itself, i.e. if we are deleting an instance called 'FooBar1', the path array might be ['Project1', 'Block1', 'FooBar1']
	*parent_path,:	a pointer to the new parent path. the source instance and all children will be moved underneath the parent node

Returns:: a struct of type ntg_error_code. If the function succeeded, the return value will be NTG_NO_ERROR possible return values for error status are given in integra_error.h

References NTG_FAILED.

char* ntg_new	(	const ntg_server *	server,
		const char *	class_name,
		const char *	instance_name,
		const ntg_path *	path
	)

Create a new instance of a class on the server.

Parameters:

	*server,:	a pointer to a struct of type ntg_server
	*class_name,:	a string representing the name of the class to be instantiated
	*instance_name,:	the name of the new instance. Instance names must be unique within containing scope. If an aready exisiting instance name is provided, then an error code will be returned. If NULL is provided, a unique instance name will be generated and returned
	*path,:	the path for the containing scope. this identifies the instance names of the containers enclosing our new instance. e.g. ['Project1', 'Block1']

Returns:: a pointer to a char giving a NULL terminated string that represents the name of the new instance a pointer to NULL is returned if an error occurs

References ntg_attribute_list_::attributes, ntg_server_::bridge, DB_SERVER, DEBUG_POST(), ntg_path_::elems, _ntg_definition::id, _ntg_module_attribute::id_default_value, _ntg_attribute::id_module_attribute, _ntg_attribute::id_type, ntg_bridge_interface::module_load, ntg_attribute_list_::n_attributes, ntg_path_::n_elems, _ntg_attribute::name, _ntg_definition::name, ntg_instance_attribute_::next, ntg_attributes(), ntg_get_default_value_by_id(), ntg_get_definition_by_name(), ntg_get_module_attribute_by_id(), ntg_get_type_by_id(), ntg_instance_add(), ntg_instance_add_attributes(), ntg_instance_attribute_find_by_name(), ntg_instance_attribute_send_value(), ntg_instance_attribute_set_default_value(), ntg_instance_find_by_name(), ntg_instance_find_by_path(), ntg_instance_increment_count(), ntg_instance_new(), ntg_instance_set_class_id(), ntg_instance_set_name(), ntg_print_error(), ntg_server_get_root(), ntg_server_new_connection(), ntg_type_code_from_type_string(), ntg_bridge_interface::post, and _ntg_definition::system.

ntg_node_list* ntg_nodelist	(	const ntg_server *	server,
		const ntg_path *	path
	)

Get the list of paths to instances on the server under a given node.

Parameters:

	*server,:	a pointer to a struct of type ntg_server
	*path,:	a pointer to a struct of type ntg_path giving the elements in the path to the given parent. The path gives the root of the nodelist, so if we want ALL nodes on the server, an empty path should be given. For all nodes under the container: Project1, the path array should be ['Project1']

Returns:: a pointer to a struct of type ntg_node_list, which gives all of the paths under a given node as n_nodes ntg_path arrays a pointer to NULL is returned if an error occurs

References DB_SERVER, DEBUG_POST(), ntg_node_list_::n_nodes, ntg_node_list_::nodes, ntg_instance_find_by_path(), ntg_malloc(), ntg_print_error(), ntg_server_get_nodelist(), and ntg_server_get_root().

ntg_error_code ntg_rename	(	const ntg_server *	server,
		const ntg_path *	path,
		const char *	name
	)

Rename an instance of a class on the server.

Parameters:

	*server,:	a pointer to a struct of type ntg_server
	*path,:	a pointer to a struct of type ntg_path giving the elements in the path to the given instance. The path array must include the instance itself, i.e. if we are renaming an instance called 'FooBar1', the path array might be ['Project1', 'Block1', 'FooBar1']
	*name,:	a pointer to a string representing the new name of the instance

Returns:: a struct of type ntg_error_code. If the function succeeded, the return value will be NTG_NO_ERROR possible return values for error status are given in integra_error.h

References NTG_ERROR, ntg_instance_find_by_path(), ntg_instance_set_name(), NTG_NO_ERROR, ntg_server_fix_connections(), and ntg_server_get_root().

ntg_error_code ntg_runscript	(	ntg_server *	server,
		const char *	script
	)

Evaluate a string containing script code.

Connect two attributes on the server.

Note, the function returns immediately, and it doesn't matter whether the server is locked or not when calling.

Parameters:

	server	Server object created by ntg_server_new
	string	A string containing scripting code The string can contain several lines separated by lineshifts.

References DB_SERVER, DEBUG_POST(), NTG_ERROR, ntg_lua_eval(), NTG_NO_ERROR, and ntg_print_error().

ntg_error_code ntg_save	(	const ntg_server *	server,
		const ntg_path *	path,
		const char *	file_path
	)

Save all nodes including and below a given node on the server to a path on the filesystem.

Parameters:

	*server,:	a pointer to a struct of type ntg_server
	*path,:	a pointer to a struct of type ntg_path giving the elements in the path to the given instance. The path array must include the instance itself, i.e. if we are saving an instance called 'FooBar1', the path array might be ['Project1', 'Block1', 'FooBar1']
	*file_path,:	a pointer to a string representing the path to the file on the filesystem

Returns:: a struct of type ntg_error_code. If the function succeeded, the return value will be NTG_NO_ERROR possible return values for error status are given in integra_error.h

References NTG_FAILED.

int ntg_server_add_namespace	(	void *	server,
		ntg_bridge_interface *	p
	)

References NTG_NO_ERROR.

ntg_error_code ntg_server_delete_connection	(	ntg_server *	server,
		const ntg_instance *	connection_instance
	)

Delete a connection in the connection list.

References ntg_port_::attribute_name, ntg_server_::bridge, ntg_server_::connection_list, ntg_value_::ctype, ntg_connection_::id, ntg_bridge_interface::module_disconnect, ntg_port_::module_id, ntg_connection_::next, ntg_connection_free(), NTG_ERROR, ntg_instance_attribute_find_by_name(), ntg_instance_find_by_path(), NTG_NO_ERROR, ntg_path_from_string(), ntg_path_pop_element(), ntg_print_error(), ntg_value_::ctype_::s, and ntg_instance_attribute_::value.

Referenced by ntg_server_instance_delete().

ntg_error_code ntg_server_delete_orphaned_connections ( ntg_server * server )

Delete orphaned connections on the server This function also disconnects the connection in the module host if needed.

References ntg_server_::connection_list, ntg_connection_::id, ntg_port_::module_id, ntg_connection_::next, ntg_connection_free(), NTG_ERROR, ntg_instance_find_by_id_r(), NTG_NO_ERROR, ntg_port_free(), ntg_print_error(), ntg_server_get_root(), ntg_connection_::source, and ntg_connection_::target.

Referenced by ntg_delete().

void* ntg_server_do	(	ntg_server_callback	callback,
		const int	argc,
			...
	)

References __server__, ntg_lock_server(), and ntg_unlock_server().

ntg_error_code ntg_server_fix_connections	(	ntg_server *	server,
		ntg_instance *	instance,
		const char *	name
	)

Fix connections that point to instance so that the point to 'name'.

References ntg_server_::connection_list, ntg_connection_::id, ntg_port_::module_id, ntg_connection_::next, NTG_ERROR, ntg_instance_attribute_find_by_name(), ntg_instance_attribute_get_value(), ntg_instance_attribute_set_value(), ntg_instance_find_by_id(), NTG_NO_ERROR, ntg_print_error(), ntg_replace_substring(), NTG_STRING, ntg_value_get_string(), ntg_value_set(), ntg_connection_::source, and ntg_connection_::target.

Referenced by ntg_rename().

ntg_attribute_list* ntg_server_get_class_attributes	(	const ntg_server *	server,
		const char *	class_name,
		ntg_attribute_list *	attribute_list
	)

Recursively get the attributes for a class.

References _ntg_model::allocated_attributes, ntg_attribute_list_::attributes, _ntg_model::attributes, _ntg_model::definitions, _ntg_definition::id, _ntg_definition::id_parent, ntg_server_::model, ntg_attribute_list_::n_attributes, _ntg_model::n_attributes, _ntg_definition::name, ntg_get_definition_by_name(), and ntg_server_get_class_attributes().

Referenced by ntg_attributes(), and ntg_server_get_class_attributes().

ntg_node_list* ntg_server_get_nodelist	(	const ntg_server *	server,
		ntg_instance *	container,
		ntg_path *	parent_path,
		ntg_node_list *	nodelist
	)

Get the list of nodes under a container instance as an array.

References ntg_path_::elems, ntg_path_::n_elems, ntg_node_list_::n_nodes, ntg_node_list_::nodes, ntg_malloc(), ntg_path_new(), ntg_realloc(), ntg_server_get_nodelist(), and ntg_server_get_root().

Referenced by ntg_nodelist(), and ntg_server_get_nodelist().

ntg_instance* ntg_server_get_root ( const ntg_server * server )

Get the root of the instance graph.

References ntg_server_::root.

Referenced by ntg_connect(), ntg_delete(), ntg_disconnect(), ntg_get(), ntg_new(), ntg_nodelist(), ntg_rename(), ntg_server_delete_orphaned_connections(), ntg_server_get_nodelist(), ntg_server_update_connection(), and ntg_set().

ntg_error_code ntg_server_instance_delete	(	ntg_server *	server,
		ntg_instance *	instance
	)

Remove an instance from the server.

Parameters:

	*instance	a pointer to the instance to removed
	*container	a pointer to the containing instance

References ntg_server_::bridge, DB_INSTANCE, DEBUG_POST(), _ntg_model::definitions, ntg_server_::model, ntg_bridge_interface::module_remove, _ntg_definition::name, NTG_ERROR, ntg_instance_free(), NTG_NO_ERROR, ntg_print_error(), ntg_server_delete_connection(), ntg_server_instance_delete_r_(), and _ntg_definition::system.

Referenced by ntg_delete(), and ntg_server_instance_delete_r_().

int ntg_server_instance_delete_r_	(	ntg_server *	server,
		ntg_instance *	instance
	)

References NTG_ERROR, NTG_NO_ERROR, and ntg_server_instance_delete().

Referenced by ntg_server_instance_delete().

ntg_server* ntg_server_new ( void )

References __server__, ADMIN_URL, ntg_class_list_::classes, ntg_server_::classlist, ntg_server_::connection_list, init_luascripting(), ntg_server_::model, ntg_class_list_::n_classes, ntg_classlist(), ntg_populate(), ntg_server_::root, and server.

Referenced by ntg_server_run().

ntg_error_code ntg_server_new_connection	(	ntg_server *	server,
		const ntg_instance *	connection_instance
	)

New connection in the connection list.

References ntg_server_::bridge, ntg_server_::connection_list, ntg_connection_::id, ntg_connection_::next, ntg_connection_new(), NTG_ERROR, NTG_NO_ERROR, ntg_print_error(), and ntg_connection_::prev.

Referenced by ntg_new().

ntg_bridge_callback ntg_server_run	(	const char *	bridge_file,
		const int	port
	)

Create a new Integra server.

Returns a pointer to a callback that gets called when the module host passes data to the bridge.

Parameters:

bridge_file

the filename of the bridge being loaded

References ntg_server_::bridge, ntg_bridge_interface::bridge_callback, ntg_bridge_interface::bridge_init, DB_SERVER, DEBUG_POST(), ntg_bridge_load(), NTG_CWD, ntg_file_find(), ntg_free(), ntg_instance_new(), ntg_instance_set_name(), NTG_NTG_BRIDGE_PATH, ntg_print_error(), ntg_server_new(), ntg_server_set_root(), ntg_xmlrpc_server_run(), server, server_receive_callback(), ntg_bridge_interface::server_receive_callback, and xmlrpc_thread.

void ntg_server_set_root	(	ntg_server *	server,
		ntg_instance *	root
	)

References ntg_server_::root.

Referenced by ntg_server_run().

ntg_error_code ntg_server_update_connection	(	ntg_server *	server,
		const ntg_instance *	connection_instance,
		const ntg_instance_attribute *	instance_attribute
	)

ntg_error_code ntg_set	(	const ntg_server *	server,
		const ntg_path *	attribute_path,
		const ntg_value *	value
	)

Set the value of an attribute of an instance on the server.

Parameters:

	*server,:	a pointer to a struct of type ntg_server
	*path,:	a pointer to a struct of type ntg_path giving the elements in the path to the given attribute. The path array must include the attribute itself, i.e. if we are setting the value of an attribute called 'blah' in an instance called 'FooBar1', the path array might be ['Project1', 'Block1', 'FooBar1', 'blah']. If the path is invalid, or the final element doesn't correspond to an attribute an error code of NTG_PATH_ERROR will be returned
	*value,:	a pointer to a struct of type ntg_value containing the value we are setting the attribute to. The supported types for value are given in integra_model.h however, the type of *value must match the type of the attribute being set as given by the attribute definition. Otherwise an NTG_TYPE_ERROR will be returned

Returns:: a struct of type ntg_error_code. If the function succeeded, the return value will be NTG_NO_ERROR possible return values for error status are given in integra_error.h

References ntg_server_::bridge, _ntg_model::definitions, ntg_path_::elems, ntg_server_::model, ntg_path_::n_elems, _ntg_definition::name, NTG_ERROR, NTG_FAILED, ntg_instance_attribute_find_by_name(), ntg_instance_attribute_send_value(), ntg_instance_attribute_set_value(), ntg_instance_find_by_path(), NTG_NO_ERROR, ntg_path_free(), ntg_path_pop_element(), ntg_path_validate(), ntg_print_error(), ntg_server_get_root(), ntg_server_update_connection(), and _ntg_definition::system.

char ntg_type_code_from_type_string ( const char * type )

References NTG_BLOB, NTG_FLOAT, NTG_INTEGER, NTG_NIL, ntg_print_error(), and NTG_STRING.

Referenced by ntg_new().

void ntg_unlock_server ( void )

Referenced by ntg_server_do().

void* server_receive_callback	(	ntg_id	id,
		unsigned int	port,
		const int	argc,
		const ntg_value *	message,
		void()(const ntg_port , const ntg_value *)	bridge_send_callback
	)

Callback function corresponing to ih_callback in the bridge interface (see integra_bridge.h ntg_bridge_interface->ih_callback.

References ntg_port_::module_id.

Referenced by ntg_server_run().

/mnt/hgfs/jamie_On_My_Mac/store/version_control/svn/integralive/library/trunk/src/server.c File Reference

Functions

Function Documentation