/**
 * Nodes
 *
 * The S2SS server connects multiple nodes.
 * There are multiple types of nodes:
 *  - simulators
 *  - servers
 *  - workstations
 *
 * @author Steffen Vogel <stvogel@eonerc.rwth-aachen.de>
 * @copyright 2014, Institute for Automation of Complex Power Systems, EONERC
 */

#ifndef _NODE_H_
#define _NODE_H_

#include <sys/socket.h>
#include <netinet/in.h>

enum node_type
{
	NODE_INVALID,
	NODE_SERVER,
	NODE_WORKSTATION,
	NODE_SIM_OPAL,
	NODE_SIM_RTDS,
	NODE_SIM_DSP
};

struct node
{
	/// The socket descriptor
	int sd;

	/// Reference counter
	int ref_cnt;

	// Local address of the socket
	struct sockaddr_in local;

	// Remote address of the socket
	struct sockaddr_in remote;

	/// The type of this node
	enum node_type type;

	/// A short identifier of the node
	const char *name;
};

struct msg; /* forward decl */

/**
 * @brief Create a new node
 *
 * Memory is allocated dynamically and has to be freed by node_destroy()
 *
 * @param n A pointer to the node structure
 * @param name An acroynm, describing the node
 * @param type The type of a node (server, simulator, workstation)
 * @return
 *  - 0 on success
 *  - otherwise on error occured
 */
int node_create(struct node *n, const char *name, enum node_type type,
	struct sockaddr_in local, struct sockaddr_in remote);

/**
 * @brief Delete a node created by node_create()
 *
 * @param p A pointer to the node struct
 */
void node_destroy(struct node *n);

/**
 * @brief Connect and bind the UDP socket of this node
 *
 * @param n A pointer to the node structure
 * @return
 *  - 0 on success
 *  - otherwise on error occured
 */
int node_connect(struct node *n);

/**
 * @brief Disconnect the UDP socket of this node
 *
 * @param n A pointer to the node structure
 * @return
 *  - 0 on success
 *  - otherwise on error occured
 */
int node_disconnect(struct node *n);

/**
 * @brief Lookup node type from string
 *
 * @param str The string containing the node type
 * @return The node type enumeration value
 */
enum node_type node_lookup_type(const char *str);

/**
 * @brief Search list of nodes for a name
 *
 * @param str The name of the wanted node
 * @param nodes A pointer to the first list element
 * @param len Length of the node list
 * @return A pointer to the node or NULL if not found
 */
struct node* node_lookup_name(const char *str, struct node *nodes, int len);

#endif /* _NODE_H_ */