Mobile-C: /home/dko/Projects/mobilec/src/include/libmc.h Source File

00001 /* SVN FILE INFO
00002  * $Revision: 560 $ : Last Committed Revision
00003  * $Date: 2010-08-30 15:09:20 -0700 (Mon, 30 Aug 2010) $ : Last Committed Date */
00004 /*[
00005  * Copyright (c) 2007 Integration Engineering Laboratory
00006                       University of California, Davis
00007  *
00008  * Permission to use, copy, and distribute this software and its
00009  * documentation for any purpose with or without fee is hereby granted,
00010  * provided that the above copyright notice appear in all copies and
00011  * that both that copyright notice and this permission notice appear
00012  * in supporting documentation.
00013  *
00014  * Permission to modify the software is granted, but not the right to
00015  * distribute the complete modified source code.  Modifications are to
00016  * be distributed as patches to the released version.  Permission to
00017  * distribute binaries produced by compiling modified sources is granted,
00018  * provided you
00019  *   1. distribute the corresponding source modifications from the
00020  *    released version in the form of a patch file along with the binaries,
00021  *   2. add special version identification to distinguish your version
00022  *    in addition to the base release version number,
00023  *   3. provide your name and address as the primary contact for the
00024  *    support of your modified version, and
00025  *   4. retain our contact information in regard to use of the base
00026  *    software.
00027  * Permission to distribute the released version of the source code along
00028  * with corresponding source modifications in the form of a patch file is
00029  * granted with same provisions 2 through 4 for binary distributions.
00030  *
00031  * This software is provided "as is" without express or implied warranty
00032  * to the extent permitted by applicable law.
00033 ]*/
00034 
00052 /* Filename: libmc.h */
00053 /* Current functions implemented 
00054 MC_AclDestroy
00055 MC_AclNew
00056 MC_AclPost
00057 MC_AclReply
00058 MC_AclRetrieve
00059 MC_AclSend
00060 MC_AclWaitRetrieve
00061 MC_AddAgent 
00062 MC_Barrier 
00063 MC_BarrierInit 
00064 MC_BarrierDelete 
00065 MC_CallAgentFunc
00066 MC_ChInitializeOptions 
00067 MC_ComposeAgent
00068 MC_CondBroadcast 
00069 MC_CondSignal 
00070 MC_CondWait  
00071 MC_CondReset 
00072 MC_CopyAgent 
00073 MC_DeleteAgent 
00074 MC_DeregisterService
00075 MC_End 
00076 MC_FindAgentByName
00077 MC_FindAgentByID
00078 MC_GetAgentArrivalTime 
00079 MC_GetAgentStatus 
00080 MC_GetAgentXMLString 
00081 MC_GetAgentExecEngine 
00082 MC_GetAgentID
00083 MC_GetAgentName
00084 MC_GetAgentReturnData
00085 MC_GetAgentNumTasks 
00086 MC_GetAgentType 
00087 MC_GetAllAgents 
00088 MC_HaltAgency 
00089 MC_Initialize
00090 MC_InitializeAgencyOptions 
00091 MC_MutexLock 
00092 MC_MutexUnlock 
00093 MC_PrintAgentCode 
00094 MC_RegisterService
00095 MC_ResumeAgency 
00096 MC_RetrieveAgent 
00097 MC_RetrieveAgentCode 
00098 MC_ResetSignal 
00099 MC_SearchForService
00100 MC_SemaphorePost 
00101 MC_SemaphoreWait 
00102 MC_SendCh
00103 MC_SendAgentMigrationMessage
00104 MC_SendAgentMigrationMessageFile
00105 MC_SendSteerCommand 
00106 MC_SetAgentStatus 
00107 MC_SetDefaultAgentStatus
00108 MC_SetThreadOn 
00109 MC_SetThreadsAllOn
00110 MC_SetThreadOff 
00111 MC_SetThreadsAllOff
00112 MC_Steer
00113 MC_SteerControl 
00114 MC_SyncDelete 
00115 MC_SyncInit 
00116 MC_TerminateAgent 
00117 MC_MainLoop 
00118 MC_MainLoop
00119 MC_WaitAgent 
00120 MC_WaitRetrieveAgent 
00121 MC_WaitSignal 
00122 
00123    *** */
00124 
00125 #ifndef _MOBILEC_H_
00126 #define _MOBILEC_H_
00127 
00128 #ifdef _WIN32
00129 #include <windows.h>
00130 #endif
00131 
00132 #ifndef THREAD_T
00133 #ifdef _WIN32
00134 #define THREAD_T HANDLE
00135 #else
00136 #define THREAD_T pthread_t
00137 #endif
00138 #endif
00139 
00140 #ifdef WIN32
00141         #ifdef _MC_DLL
00142                 // Building a .dll - export functions as marked
00143                 #define EXPORTMC _declspec(dllexport)
00144         #else
00145                 // Not building a .dll - building .lib assumed - no export required
00146                 #define EXPORTMC
00147         #endif
00148 #else
00149         // Not windows
00150         #define EXPORTMC
00151 #endif
00152 
00153 /* The MC_Wait() function is deprecated as of version 1.9.4.
00154  * All calls to MC_Wait() should now be changed to MC_MainLoop() */
00155 #define MC_Wait(arg1) \
00156   MC_MainLoop(arg1)
00157 
00158 #include <embedch.h>
00159 #ifdef __cplusplus
00160 extern "C" {
00161 #endif
00162 
00163 #ifndef _ERROR_CODE_E_
00164 #define _ERROR_CODE_E_
00165 /*
00166  * Error Codes
00167  * NOTE: There is a copy of this enum in mc_error.h
00168  * */
00169 typedef enum error_code_e {
00170     MC_SUCCESS = 0,
00171     MC_ERR,
00172     MC_ERR_CONNECT,
00173     MC_ERR_PARSE,
00174     MC_ERR_EMPTY,
00175     MC_ERR_INVALID,
00176     MC_ERR_INVALID_ARGS,
00177     MC_ERR_NOT_FOUND,
00178     MC_ERR_MEMORY,
00179     MC_ERR_SEND,
00180     MC_WARN_DUPLICATE
00181 } error_code_t;
00182 #endif
00183 
00187 enum MC_ThreadIndex_e{ 
00188     MC_THREAD_DF=0,   
00189     MC_THREAD_AMS,    
00190     MC_THREAD_ACC,    
00191     MC_THREAD_CP,     
00192     MC_THREAD_AGENT,  
00193     MC_THREAD_ALL };
00194 
00195 
00199 typedef enum MC_SteerCommand_e {
00200   MC_RUN = 0,     
00201   MC_SUSPEND,     
00202   MC_RESTART,     
00203   MC_STOP         
00204 } MC_SteerCommand_t;
00205 
00214 enum MC_Signal_e{
00215     MC_NO_SIGNAL      =0x00, 
00216     MC_RECV_CONNECTION=0x01, 
00217     MC_RECV_MESSAGE   =0x02, 
00218     MC_RECV_AGENT     =0x04, 
00219     MC_RECV_RETURN    =0x08, 
00220     MC_EXEC_AGENT     =0x10, 
00221     MC_ALL_SIGNALS    =0x20  
00222 };
00223 
00227 typedef struct agency_s {
00228     int client;
00229     int server;
00230     char *hostName;                     
00231     char *filename;
00232     int portno;                         
00233     int portnoc;
00234     int initInterps;
00235     struct mc_platform_s* mc_platform;  
00236     int default_agentstatus;            
00237     int threads;                        
00238     int enable_security;                
00239     int stack_size[MC_THREAD_ALL];
00240     int bluetooth;
00241 
00242                 char* priv_key_filename;
00243                 char* known_host_filename;
00244     error_code_t last_error;
00245 } agency_t;
00246 typedef agency_t* agency_p;
00247 typedef agency_p MCAgency_t;
00248 
00252 typedef struct MCAgencyOptions_s{
00253     int threads;              
00254     int default_agent_status; 
00255     int modified;             
00256     int enable_security;      
00257     unsigned char passphrase[32]; 
00259     /* Following are some thread stack size options: unix/pthreads only! */
00260     int stack_size[MC_THREAD_ALL]; 
00262     char *known_host_filename;
00263     char *priv_key_filename;
00264     int initInterps;
00265     int bluetooth; /* Startup in bluetooth mode */
00266     ChOptions_t* ch_options;
00267 } MCAgencyOptions_t;
00268 
00269 typedef struct stationary_agent_info_s{
00270         void* args;
00271         struct agent_s* agent;
00272         MCAgency_t attr; /* DEPRECATED: Use the 'agency' member instead */
00273         MCAgency_t agency;
00274         THREAD_T thread;
00275 } stationary_agent_info_t;
00276 
00277 #ifndef AGENT_T
00278 #define AGENT_T
00279 typedef struct agent_s agent_t;
00280 typedef agent_t* MCAgent_t;
00281 typedef agent_t* agent_p;
00282 #endif
00283 
00284 enum MC_AgentType_e{ MC_NONE = -1, MC_REMOTE_AGENT = 0, MC_LOCAL_AGENT, MC_RETURN_AGENT };
00285 
00289 enum MC_AgentStatus_e{ 
00290         MC_NO_STATUS = -1,
00291     MC_WAIT_CH = 0,    
00292     MC_WAIT_MESSGSEND, 
00293     MC_AGENT_ACTIVE,   
00294     MC_AGENT_NEUTRAL,  
00295     MC_AGENT_SUSPENDED,
00296     MC_WAIT_FINISHED   
00297 };
00298 
00300 struct fipa_acl_message_s;
00301 #ifndef _FIPA_PERFORMATIVE_E_
00302 #define _FIPA_PERFORMATIVE_E_
00303 enum fipa_performative_e
00304 {
00305   FIPA_ERROR=-1,
00306   FIPA_ZERO,
00307   FIPA_ACCEPT_PROPOSAL,
00308   FIPA_AGREE,
00309   FIPA_CANCEL,
00310   FIPA_CALL_FOR_PROPOSAL,
00311   FIPA_CONFIRM,
00312   FIPA_DISCONFIRM,
00313   FIPA_FAILURE,
00314   FIPA_INFORM,
00315   FIPA_INFORM_IF,
00316   FIPA_INFORM_REF,
00317   FIPA_NOT_UNDERSTOOD,
00318   FIPA_PROPOGATE,
00319   FIPA_PROPOSE,
00320   FIPA_PROXY,
00321   FIPA_QUERY_IF,
00322   FIPA_QUERY_REF,
00323   FIPA_REFUSE,
00324   FIPA_REJECT_PROPOSAL,
00325   FIPA_REQUEST,
00326   FIPA_REQUEST_WHEN,
00327   FIPA_REQUEST_WHENEVER,
00328   FIPA_SUBSCRIBE
00329 };
00330 #endif
00331 
00339 EXPORTMC int 
00340 MC_AclDestroy(struct fipa_acl_message_s* message);
00341 
00347 EXPORTMC extern struct fipa_acl_message_s*
00348 MC_AclNew(void);
00349 
00358 EXPORTMC extern int MC_AclPost(MCAgent_t agent, struct fipa_acl_message_s* message);
00359 
00370 EXPORTMC extern struct fipa_acl_message_s*
00371 MC_AclReply(struct fipa_acl_message_s* acl_message);
00372 
00380 EXPORTMC extern struct fipa_acl_message_s* MC_AclRetrieve(MCAgent_t agent);
00381 
00390 EXPORTMC extern int MC_AclSend(MCAgency_t attr, struct fipa_acl_message_s* acl);
00391 
00399 EXPORTMC extern struct fipa_acl_message_s* MC_AclWaitRetrieve(MCAgent_t agent);
00400 
00401 /* ACL Helper Functions Here */
00402 enum fipa_performative_e;
00403 enum fipa_protocol_e;
00404 
00405 EXPORTMC enum fipa_protocol_e MC_AclGetProtocol(
00406     struct fipa_acl_message_s* acl);
00407 
00408 EXPORTMC char* MC_AclGetConversationID(
00409     struct fipa_acl_message_s* acl);
00410 
00411 EXPORTMC enum fipa_performative_e MC_AclGetPerformative(
00412     struct fipa_acl_message_s* acl);
00413 
00414 EXPORTMC int MC_AclGetSender(
00415     struct fipa_acl_message_s* acl,
00416     char** name, /* OUT: Will allocate a text string to be freed by the
00417                           user. */
00418     char** address /* OUT: Will allocate a text string to be freed by the user
00419                     */
00420     );
00421   
00422 EXPORTMC const char* MC_AclGetContent(
00423     struct fipa_acl_message_s* acl);
00424 
00425 EXPORTMC int MC_AclSetProtocol(
00426     struct fipa_acl_message_s* acl,
00427     enum fipa_protocol_e performative );
00428 
00429 EXPORTMC int MC_AclSetConversationID(
00430     struct fipa_acl_message_s* acl,
00431     char* id);
00432 
00433 EXPORTMC int MC_AclSetPerformative(
00434     struct fipa_acl_message_s* acl,
00435     enum fipa_performative_e performative );
00436 
00437 EXPORTMC int MC_AclSetSender(
00438     struct fipa_acl_message_s* acl,
00439     const char* name,
00440     const char* address );
00441   
00442 EXPORTMC int MC_AclAddReceiver(
00443     struct fipa_acl_message_s* acl,
00444     const char* name,
00445     const char* address );
00446 
00447 EXPORTMC int MC_AclAddReplyTo(
00448     struct fipa_acl_message_s* acl,
00449     const char* name,
00450     const char* address);
00451 
00452 EXPORTMC int MC_AclSetContent(
00453     struct fipa_acl_message_s* acl,
00454     const char* content );
00455 
00456 /* End ACL Helper Functions */
00457 
00458 
00467 EXPORTMC extern int MC_AddAgent( 
00468     MCAgency_t attr, 
00469     MCAgent_t agent);
00470 
00471 
00472 int MC_AddStationaryAgent(
00473     MCAgency_t agency, 
00474     void* (*agent_thread)(stationary_agent_info_t*), 
00475     const char* name, 
00476     void* agent_args);
00477 
00478 
00491 int MC_AgentAddTask(
00492     MCAgent_t agent, 
00493     const char* code, 
00494     const char* return_var_name, 
00495     const char* server,
00496     int persistent);
00497 
00510 int MC_AgentAddTaskFromFile(
00511     MCAgent_t agent, 
00512     const char* filename, 
00513     const char* return_var_name, 
00514     const char* server,
00515     int persistent);
00516 
00525 extern MCAgency_t 
00526 MC_AgentInfo_GetAgency(stationary_agent_info_t* stationary_agent_info);
00527 
00538 extern MCAgent_t 
00539 MC_AgentInfo_GetAgent(stationary_agent_info_t* stationary_agent_info);
00540 
00549 extern void*
00550 MC_AgentInfo_GetAgentArgs(stationary_agent_info_t* stationary_agent_info);
00551 
00560 extern int MC_AgentReturnArrayDim(
00561     MCAgent_t agent,
00562     int task_num );
00563 
00573 extern int MC_AgentReturnArrayExtent(
00574     MCAgent_t agent,
00575     int task_num,
00576     int index);
00577 
00587 extern int MC_AgentReturnArrayNum(
00588     MCAgent_t agent,
00589     int task_num);
00590 
00600 extern const void* MC_AgentReturnDataGetSymbolAddr(
00601     MCAgent_t agent,
00602     int task_num );
00603 
00612 extern size_t MC_AgentReturnDataSize(
00613     MCAgent_t agent,
00614     int task_num );
00615 
00625 extern int MC_AgentReturnDataType(
00626     MCAgent_t agent,
00627     int task_num );
00628 
00638 extern int MC_AgentReturnIsArray(
00639     MCAgent_t agent,
00640     int task_num );
00641 
00657 extern const void* 
00658 MC_AgentVariableRetrieve(
00659     MCAgent_t agent,
00660     const char* var_name,
00661     int task_num);
00662 
00677 int
00678 MC_AgentVariableRetrieveInfo(
00679     MCAgent_t agent,
00680     const char* var_name,
00681     int task_num,
00682     const void** data,
00683     int* dim,
00684     const int** extent
00685     );
00686 
00704 extern int 
00705 MC_AgentVariableSave(MCAgent_t agent, const char* var_name);
00706 
00707 EXPORTMC int 
00708 MC_Barrier(MCAgency_t attr, int id); 
00709 
00719 EXPORTMC extern int MC_BarrierDelete(MCAgency_t attr, int id);
00720 
00736 EXPORTMC extern int MC_BarrierInit(MCAgency_t attr, int id, int num_procs);
00737 
00746 #ifdef OBS
00747 EXPORTMC extern int MC_ChInitializeOptions(MCAgency_t attr, ChOptions_t *options);
00748 #endif
00749 
00750 
00766 EXPORTMC int
00767 MC_CallAgentFunc(
00768     MCAgent_t agent,
00769     const char* funcName,
00770     void* returnVal,
00771     int numArgs,
00772     ...);
00773 
00790 EXPORTMC extern int MC_CallAgentFuncArg(
00791         MCAgent_t agent,
00792         const char* funcName,
00793         void* returnVal,
00794         void* arg
00795         );
00796 
00807 EXPORTMC extern int MC_CallAgentFuncV(
00808     MCAgent_t agent,
00809     const char* funcName,
00810     void* returnVal,
00811     va_list ap);
00812 
00813   /*
00814     \brief          Calls a function defined in an agent
00815     \param agent    A Mobile-C Agent
00816     \param funcName The name of the function to call
00817     \param returnVal (output) Return value from the agent function
00818     \param arglist  Ch Variable Argument list to pass in
00819    */
00820 EXPORTMC extern int MC_CallAgentFuncVar
00821 (
00822  MCAgent_t agent,
00823  const char* funcName,
00824  void* returnVal,
00825  ChVaList_t arglist
00826  );
00827                                          
00828 
00842 EXPORTMC extern MCAgent_t
00843 MC_ComposeAgent(
00844     const char* name,
00845     const char* home,
00846     const char* owner, 
00847     const char* code,
00848     const char* return_var_name,
00849     const char* server,
00850     int persistent
00851     );
00852 
00869 EXPORTMC extern MCAgent_t
00870 MC_ComposeAgentS(
00871     const char* name,
00872     const char* home,
00873     const char* owner, 
00874     const char* code,
00875     const char* return_var_name,
00876     const char* server,
00877     int persistent,
00878                 const char* workgroup_code
00879     );
00880 
00896 EXPORTMC extern MCAgent_t
00897 MC_ComposeAgentWithWorkgroup(
00898     const char* name,
00899     const char* home,
00900     const char* owner, 
00901     const char* code,
00902     const char* return_var_name,
00903     const char* server,
00904     int persistent,
00905                 const char* workgroup_code
00906     );
00907 
00922 EXPORTMC extern MCAgent_t
00923 MC_ComposeAgentFromFile(
00924     const char* name,
00925     const char* home,
00926     const char* owner, 
00927     const char* filename,
00928     const char* return_var_name,
00929     const char* server,
00930     int persistent
00931     );
00932 
00950 EXPORTMC extern MCAgent_t
00951 MC_ComposeAgentFromFileS(
00952     const char* name,
00953     const char* home,
00954     const char* owner, 
00955     const char* filename,
00956     const char* return_var_name,
00957     const char* server,
00958     int persistent,
00959                 const char* workgroup_code
00960     );
00961 
00977 EXPORTMC extern MCAgent_t
00978 MC_ComposeAgentFromFileWithWorkgroup(
00979     const char* name,
00980     const char* home,
00981     const char* owner, 
00982     const char* filename,
00983     const char* return_var_name,
00984     const char* server,
00985     int persistent,
00986                 const char* workgroup_code
00987     );
00988 
00999 EXPORTMC extern int MC_CondBroadcast(MCAgency_t attr, int id);
01000 
01016 EXPORTMC extern int MC_CondSignal(MCAgency_t attr, int id);
01017 
01028 EXPORTMC extern int MC_CondReset(MCAgency_t attr, int id);
01029 
01043 EXPORTMC extern int MC_CondWait(MCAgency_t attr, int id);
01044 
01054 int MC_CopyAgent(MCAgent_t* agent_out, const MCAgent_t agent_in);
01055 
01064 EXPORTMC extern int MC_DeleteAgent(MCAgent_t agent);
01065 
01077 EXPORTMC extern int MC_DeleteAgentWG(MCAgent_t calling_agent, MCAgent_t agent);
01078 
01089 EXPORTMC extern int MC_End(MCAgency_t attr);
01090 
01101 int MC_DestroyServiceSearchResult(
01102     char** agentName,
01103     char** serviceName,
01104     int* agentID,
01105     int numResult);
01106 
01107 
01118 EXPORTMC extern MCAgent_t MC_FindAgentByName(MCAgency_t attr, const char *name);
01119 
01128 EXPORTMC extern MCAgent_t MC_FindAgentByID(MCAgency_t attr, int ID);
01129 
01138 EXPORTMC extern /*ChInterp_t*/ void* MC_GetAgentExecEngine(MCAgent_t agent);
01139 
01143 EXPORTMC extern int MC_GetAgentID(MCAgent_t agent);
01144 
01145 /*
01146  * \brief           Retrieve an agent's name
01147  *
01148  * \return          a malloc'd character string on success, or NULL on failure
01149  */
01150 EXPORTMC extern char* MC_GetAgentName(MCAgent_t agent);
01151 
01157 EXPORTMC extern int MC_GetAgentNumTasks(MCAgent_t agent);
01158 
01175 EXPORTMC extern int MC_GetAgentReturnData(
01176         MCAgent_t agent,
01177         int task_num,
01178         void **data,
01179         int *dim,
01180         int **extent);
01181 
01187 EXPORTMC extern int MC_GetAgentStatus(MCAgent_t agent);
01188 
01194 EXPORTMC extern enum MC_AgentType_e MC_GetAgentType(MCAgent_t agent);
01195 
01201 EXPORTMC extern char* MC_GetAgentXMLString(MCAgent_t agent);
01202 
01210 EXPORTMC extern int MC_HaltAgency(MCAgency_t agency);
01211 
01222 EXPORTMC extern MCAgency_t MC_Initialize(
01223         int port,
01224         MCAgencyOptions_t *options);
01225 
01238 EXPORTMC extern int MC_InitializeAgencyOptions(struct MCAgencyOptions_s* options);
01239 
01245  EXPORTMC extern int MC_MainLoop(MCAgency_t attr);
01246 
01255 EXPORTMC extern int MC_LoadAgentFromFile(MCAgency_t attr, const char* filename);
01256 
01266 EXPORTMC extern int MC_MigrateAgent(MCAgent_t agent, const char* hostname, int port);
01267 
01282 EXPORTMC extern int MC_MutexLock(MCAgency_t attr, int id); 
01283 
01284 /*
01285  * \brief           Unlocks a MobileC synchronization variable
01286  *
01287  * \param attr      a MobileC agency handle
01288  * \param id        the synchronization variable id to unlock
01289  *
01290  * \return          0 on success, error_code_t type on failure
01291  *
01292  * \see             MC_MutexLock()
01293  */
01294 EXPORTMC extern int MC_MutexUnlock(MCAgency_t attr, int id); 
01295 
01313 EXPORTMC extern int MC_RegisterService(
01314         MCAgency_t agency,
01315         /* Optional input args: Must input 
01316          * MCAgent_t OR
01317          * agentID AND agentName */
01318         MCAgent_t agent,
01319         int agentID,
01320         const char *agentName,
01321         char **serviceNames,
01322         int numServices);
01323 
01331 EXPORTMC extern int MC_ResumeAgency(MCAgency_t agency);
01332 
01338 EXPORTMC extern MCAgent_t MC_RetrieveAgent(MCAgency_t attr);
01339 
01351 EXPORTMC extern int MC_SemaphorePost(MCAgency_t attr, int id);
01352 
01366 EXPORTMC extern int MC_SemaphoreWait(MCAgency_t attr, int id);
01367 
01379 EXPORTMC extern int MC_SetDefaultAgentStatus(MCAgency_t agency, enum MC_AgentStatus_e status);
01380 
01394 EXPORTMC extern int MC_SetThreadOn(MCAgencyOptions_t *options, enum MC_ThreadIndex_e index);
01395 
01404 EXPORTMC extern int MC_SetThreadsAllOn(MCAgencyOptions_t* options);
01405 
01419 EXPORTMC extern int MC_SetThreadOff(MCAgencyOptions_t *options, enum MC_ThreadIndex_e index );
01420 
01429 EXPORTMC extern int MC_SetThreadsAllOff(MCAgencyOptions_t* options);
01430 
01436 EXPORTMC extern int MC_PrintAgentCode(MCAgent_t agent);
01437 
01443 EXPORTMC extern char * MC_RetrieveAgentCode(MCAgent_t agent);
01444 
01452 EXPORTMC extern int MC_ResetSignal(MCAgency_t attr);
01453 
01469 EXPORTMC extern int MC_SearchForService(
01470         /* Input args */
01471         MCAgency_t attr, 
01472         const char *searchString,
01473         /* Return Args */
01474         char*** agentNames,
01475         char*** serviceNames,
01476         int** agentIDs,
01477         int* numResults);
01478 
01485 EXPORTMC extern int MC_SendAgent(MCAgency_t attr,
01486         const char *message);
01487 
01494 EXPORTMC extern int MC_SendAgentFile(MCAgency_t attr, 
01495         const char *filename);
01496 
01505 EXPORTMC extern int MC_SendAgentMigrationMessage(MCAgency_t attr,
01506         const char *message,
01507         const char *hostname,
01508         int port);
01509 
01518 EXPORTMC extern int MC_SendAgentMigrationMessageFile(MCAgency_t attr, 
01519         const char *filename,
01520         const char *hostname,
01521         int port);
01522 
01531 EXPORTMC extern int MC_SetAgentStatus(MCAgent_t agent, enum MC_AgentStatus_e status);
01532 
01548 EXPORTMC extern int MC_Steer( MCAgency_t attr, int (*funcptr)(void* data), void *arg);
01549 
01558 EXPORTMC extern enum MC_SteerCommand_e MC_SteerControl(void);
01559 
01568 EXPORTMC extern int MC_SyncDelete(MCAgency_t attr, int id);
01569 
01585 EXPORTMC extern int MC_SyncInit(MCAgency_t attr, int id);
01586 
01592 EXPORTMC extern int MC_TerminateAgent(MCAgent_t agent);
01593 
01594 
01595 EXPORTMC extern int 
01596 MC_TerminateAgentWG(MCAgent_t calling_agent, MCAgent_t agent);
01602 /* EXPORTMC extern int MC_Wait(MCAgency_t attr); */
01603 
01610 EXPORTMC extern int MC_WaitAgent(MCAgency_t attr);
01611 
01620 EXPORTMC extern MCAgent_t MC_WaitRetrieveAgent(MCAgency_t attr);
01621 
01635 EXPORTMC extern int MC_WaitSignal(MCAgency_t attr, int signals);
01636 
01637 #ifdef __cplusplus
01638 }
01639 #endif
01640 
01641 #endif /* _MOBILEC_H_ */
01642