mms_vdom.h

ICCP Toolkit 是在 Tru64下开发Tase.2通信协议的开发包

/************************************************************************/
/* SISCO SOFTWARE MODULE HEADER *****************************************/
/************************************************************************/
/*   (c) Copyright Systems Integration Specialists Company, Inc.,	*/
/*      	  1986 - 1997, All Rights Reserved.		        */
/*									*/
/* MODULE NAME : mms_vdom.h						*/
/* PRODUCT(S)  : MMSEASE						*/
/*									*/
/* MODULE DESCRIPTION : 						*/
/*	This module contains data and function definitions associated	*/
/*	with the MMS virtual machine domain operations.			*/
/*									*/
/* MODIFICATION LOG :							*/
/*  Date     Who   Rev			Comments			*/
/* --------  ---  ------   -------------------------------------------	*/
/* 04/02/97  DTL   7.00    MMSEASE 7.0 release. See MODL70.DOC for	*/
/*			   history.					*/
/************************************************************************/

#ifndef MMS_VDOM_INCLUDED
#define MMS_VDOM_INCLUDED

#include "mms_pdom.h"

#ifdef __cplusplus
extern "C" {
#endif

/************************************************************************/
/************************************************************************/
/* Definitions used by the VM for Domain Upload and Download		*/
/************************************************************************/
#define MEMDOM		1	/* memory resident domains		*/
#define FILDOM		2	/* domains contianed in files		*/
#define FUNDOM		3	/* domains returned via user functions	*/

/* This structure contains information used in the process of a VM 	*/
/* domain download.  Users may access this information via the 		*/
/* req_info_ptr of the MMSPEND_REQ * returned from mv_download		*/

struct mv_dl_req_info
  {
  ST_LONG asn1_byte_count;	/* number of bytes downloaded	*/
  ST_INT type;	   		/* 1 of the types defined above	*/
  ST_INT dl_block_size;		/* max size of each block sent	*/
  union				/* union for each of the types	*/
    {
    struct			/* union member for MEMDOM	*/
      {
      ST_LONG bytes_left;		/* bytes left to download	*/
      ST_UCHAR *buffer;			/* ptr to memory resident dom	*/
      } bufinfo;			
    struct				/* union member for FILDOM	*/
      {
      FILE *fp;				/* ptr to dom file handle	*/
      ST_UCHAR *filebuf;			/* ptr to VM buffer		*/
      } fileinfo;

    ST_CHAR *(*dom_data_fun) (ST_INT max_len, ST_INT *ret_len_ptr, 
 		  	    ST_CHAR *more_follows_ptr);
    } i;
  };
typedef struct mv_dl_req_info MV_DL_REQ_INFO;

/* This structure contains information used in the process of a VM 	*/
/* domain upload.  Users may access this information via the 		*/
/* req_info_ptr of the MMSPEND_REQ * returned from mv_upload		*/

struct mv_ul_req_info
  {
  ST_LONG  asn1_byte_count;		/* number of bytes uploaded	*/
  ST_INT   type;			/* 1 of the types defined above	*/
  ST_INT32 ulsmid;			/* ulsmid for upload seg reqs 	*/
  ST_INT   num_of_capab; 		/* number of capabilities	*/
  union
    {
    struct				/* union for MEMDOM		*/
      {		
      ST_LONG bytes_left;		/* bytes left in users buffer	*/
      ST_UCHAR *buffer;			/* ptr to domain being filled	*/
      } bufinfo;
    struct				/* union for FILDOM		*/
      {
      FILE *fp;				/* ptr to dom file handle	*/
      } fileinfo;			/* ptr to VM buffer		*/
    ST_RET (*dom_data_fun)(struct upload_resp_info *rsp_info);
    } i;
/*					   list of capabilities 	*/
/*  ST_CHAR *capab_list [num_of_capab];					*/
/*  SD_END_STRUCT */
  };
typedef struct mv_ul_req_info MV_UL_REQ_INFO;

/************************************************************************/
/* Declarations of Virtual Machine functions for DOMAIN MANAGEMENT 	*/
/************************************************************************/
extern ST_BOOLEAN mv_download_sharable;

MMSREQ_PEND *mv_forced_download (ST_INT chan, ST_CHAR *dom_name, 
				 ST_INT num_cap, ST_CHAR **cap, 
				 ST_INT src_type, ST_LONG src_len, ST_UCHAR *src);

MMSREQ_PEND *mv_download 	(ST_INT chan, ST_CHAR *dom_name, 
				 ST_INT num_cap, ST_CHAR **cap, 
				 ST_INT src_type, ST_LONG src_len, ST_UCHAR *src);

MMSREQ_PEND *mv_upload   (ST_INT chan, ST_CHAR *dom_name, 
			  ST_INT dest_type, ST_LONG dest_len, ST_UCHAR *dest);

ST_RET mv_getdom_resp (MMSREQ_IND *req_info);
ST_VOID ms_set_mv_download_sharable (ST_BOOLEAN val);


/************************************************************************/
/* Functions to manipulate Named Domains				*/
/************************************************************************/

NAMED_DOM_CTRL *ms_find_named_dom (ST_CHAR *name);
NAMED_DOM_CTRL *ms_add_named_dom (ST_CHAR *name, ST_UCHAR protection);
NAMED_DOM_CTRL *ms_add_named_domain (INITDOWN_REQ_INFO *dom, 
					    ST_UCHAR protection);
ST_VOID   ms_del_all_named_doms (NAMED_DOM_CTRL *dom_list);
ST_RET    ms_del_named_dom (ST_CHAR *dom);
ST_VOID   ms_del_domain_objs (DOMAIN_OBJS *objs);


#ifdef __cplusplus
}
#endif

#endif	/* #define MMS_VDOM_INCLUDED */