/**    
    @file     ipc_call.h
    @date     2008-06-30
    @author   오재경 freefrug@falinux.com
    @brief    프로세스간의 명령 전달을 구현한다.

    @modify   
    @todo    
    @bug     
    @remark   
    
    @warning 
*/
//
//  저작권    에프에이리눅스(주)
//            외부공개 금지
//
//----------------------------------------------------------------------------

#ifndef _IPC_CALL_H_
#define _IPC_CALL_H_

//#define		IPC_UDS_NAME_PREFIX			"ipc_uds."
#define		IPC_CALL_UDS_NAME_FORMAT		"/tmp/ipc_%03ld.uds"

#define		IPC_CALL_PACKET_HEADER_LEN	(16)
#define		IPC_CALL_BUF_LEN			(4096-IPC_CALL_PACKET_HEADER_LEN)

#define     IPC_CALL_TIMEOUT_UNLIMIT    0xffffffff    /// 

/// IPC CALL 에서의 데이타 수신시 호출되는 사용자 이벤트 함수 형태
typedef void (*ipc_call_func_t)(unsigned long src_id, unsigned long msg_type, void *buf, int len );

/// @{
/// @brief  IPC CALL에서 사용하는 통신 패킷 

typedef struct {

	unsigned long dst_id;					/// 수신지 ID 
	unsigned long src_id;					/// 송신지 ID
	unsigned long msg_type;					/// 메시지 형식 ( BIN, XML, ASC )
	unsigned long size;						/// 전송 메시지의 크기
	char buf[IPC_CALL_BUF_LEN];				/// 메시지 버퍼

} ipc_call_packet_t;

/// @}


#define 	IPC_CALL_OK 	     	 	0
#define 	IPC_CALL_E_AGAIN     		-1
#define     IPC_CALL_E_TIME_OUT  		-2 
#define     IPC_CALL_E_BUSY      		-3
#define     IPC_CALL_E_NO_ID     		-4
#define     IPC_CALL_E_EMPTY     		-5


#define   	IPC_CALL_GET_GROUP(x)    	(((x)>>16)&0xFFFF)
#define   	IPC_CALL_GET_PORT(x)       	(((x)>> 0)&0xFFFF)

#define		IPC_CALL_METHOD_FABIND		0
#define		IPC_CALL_METHOD_UDS			1
#define		IPC_CALL_METHOD_UDP			2
#define		IPC_CALL_METHOD_NONE		-1

#define		IPC_CALL_MSG_TYPE_BIN	    0
#define		IPC_CALL_MSG_TYPE_XML	    1
#define		IPC_CALL_MSG_TYPE_ASC	    2


#define		IPC_CALL_LEVEL_DEFAULT		0
#define		IPC_CALL_TIMEOUT_DEFAULT	1000

#ifdef __cplusplus 
extern "C" { 
#endif 	

/// @{
/// @brief  외부에서 사용할수 있는 객체함수 리스트 



int			ipc_call_create			( unsigned long id  	); 									/// IPC_CALL 을 생성한다.
int			ipc_call_free			( unsigned long id  	); 									/// IPC_CALL 을 해제한다.
                                                                							
int			ipc_call_method			( unsigned long method	); 									/// IPC_CALL 의 수행 방식을 정한다.
                                                                							
int			ipc_call_level			( unsigned long level	); 									/// IPC_CALL 의 시간 초과를 설정한다.
int			ipc_call_level_default	( unsigned long level	); 									/// IPC_CALL 의 시간 초과를 설정한다.
                                                                							
int			ipc_call_timeout		( unsigned long msec	); 									/// IPC_CALL 의 시간 초과를 설정한다.
int			ipc_call_timeout_default( unsigned long msec	); 									/// IPC_CALL 의 시간 초과를 설정한다.
                                    
// int			ipc_call_on_read	( void (*func)( unsigned long msg_type, void *priv ) ); 	/// IPC_CALL 의 읽기에 대한 이벤트를 지정한다.
int			ipc_call_on_read		( ipc_call_func_t *func );

                                    
int			ipc_call_read			( void *buf, int len ); 									/// IPC_CALL 의 수신된 버퍼의 내용을 BIN 형식으로 읽는다.

// int			ipc_call_read_xml	( void *buf, int len ); 									/// IPC_CALL 의 수신된 버퍼의 내용을 XML 형식으로 읽는다.
//int			ipc_call_read_asc	( void *buf, int len ); 									/// IPC_CALL 의 수신된 버퍼의 내용을 ASC 형식으로 읽는다.
                              	    
int			ipc_call_send			( unsigned long dest, void *buf, int len, unsigned long msg_type ); 				/// IPC_CALL 의 BIN 형식으로 데이터를 전송한다.
int			ipc_call_send_xml		( unsigned long dest, char *buf, int len ); 				/// IPC_CALL 의 XML 형식으로 데이터를 전송한다.
int			ipc_call_send_asc		( unsigned long dest, char *buf, int len ); 				/// IPC_CALL 의 ASC 형식으로 데이터를 전송한다.
                              	    
int			ipc_call_rpc			( unsigned long dest, void *tbuf, int tlen , void *rbuf, int rlen ); 	/// IPC_CALL 의 BIN 형식으로 데이터를 전송하고 수신한다.
int			ipc_call_rpc_xml		( unsigned long dest, void *tbuf, int tlen , void *rbuf, int rlen ); 	/// IPC_CALL 의 XML 형식으로 데이터를 전송하고 수신한다.
int			ipc_call_rpc_asc		( unsigned long dest, void *tbuf, int tlen , void *rbuf, int rlen ); 	/// IPC_CALL 의 ASC 형식으로 데이터를 전송하고 수신한다.


/// @}

#ifdef __cplusplus 
}
#endif 

#endif