le_appProc_interface.h
Go to the documentation of this file.
45 //--------------------------------------------------------------------------------------------------49 //--------------------------------------------------------------------------------------------------52 //--------------------------------------------------------------------------------------------------55 * Connect the current client thread to the service providing this API. Block until the service is59 * called before any other functions in this API. Normally, ConnectService is automatically called64 //--------------------------------------------------------------------------------------------------70 //--------------------------------------------------------------------------------------------------73 * Try to connect the current client thread to the service providing this API. Return with an error77 * called before any other functions in this API. Normally, ConnectService is automatically called86 * - LE_NOT_PERMITTED if the client interface is not bound to any service (doesn't have a binding).89 //--------------------------------------------------------------------------------------------------95 //--------------------------------------------------------------------------------------------------99 * When a server connection is lost, call this handler then exit with LE_FATAL. If a program wants102 //--------------------------------------------------------------------------------------------------109 //--------------------------------------------------------------------------------------------------115 * longer a connection to the service, and the functions in this API can't be used. For details, see120 //--------------------------------------------------------------------------------------------------127 //--------------------------------------------------------------------------------------------------131 //--------------------------------------------------------------------------------------------------135 //--------------------------------------------------------------------------------------------------139 //--------------------------------------------------------------------------------------------------156 //--------------------------------------------------------------------------------------------------160 //--------------------------------------------------------------------------------------------------164 //--------------------------------------------------------------------------------------------------168 //--------------------------------------------------------------------------------------------------170 (177 //--------------------------------------------------------------------------------------------------187 * Parameters can be overridden by the other functions in this API such as AddArg(), SetPriority(),201 * @note If the application or process names pointers are null or if their strings are empty or of204 //--------------------------------------------------------------------------------------------------216 //--------------------------------------------------------------------------------------------------224 //--------------------------------------------------------------------------------------------------234 //--------------------------------------------------------------------------------------------------242 //--------------------------------------------------------------------------------------------------252 //--------------------------------------------------------------------------------------------------260 //--------------------------------------------------------------------------------------------------270 //--------------------------------------------------------------------------------------------------276 //--------------------------------------------------------------------------------------------------287 //--------------------------------------------------------------------------------------------------291 //--------------------------------------------------------------------------------------------------298 //--------------------------------------------------------------------------------------------------302 * If the application process is a configured process adding any argument means no arguments from305 * Adding an empty argument validates the argument list but does not acutally add an argument. This310 //--------------------------------------------------------------------------------------------------320 //--------------------------------------------------------------------------------------------------322 * Deletes and invalidates the cmd-line arguments to a process and use the configured arguments if328 //--------------------------------------------------------------------------------------------------335 //--------------------------------------------------------------------------------------------------343 //--------------------------------------------------------------------------------------------------353 //--------------------------------------------------------------------------------------------------355 * Clears the application process's priority and use either the configured priority or the default.360 //--------------------------------------------------------------------------------------------------367 //--------------------------------------------------------------------------------------------------374 //--------------------------------------------------------------------------------------------------383 //--------------------------------------------------------------------------------------------------385 * Clears the application process's fault action and use either the configured fault action or the391 //--------------------------------------------------------------------------------------------------398 //--------------------------------------------------------------------------------------------------400 * Starts the application process. If the application was not running this function will start it410 //--------------------------------------------------------------------------------------------------417 //--------------------------------------------------------------------------------------------------424 //--------------------------------------------------------------------------------------------------void le_appProc_SetServerDisconnectHandler(le_appProc_DisconnectHandler_t disconnectHandler, void *contextPtr)void le_appProc_ClearPriority(le_appProc_RefRef_t appProcRef)void le_appProc_SetStdOut(le_appProc_RefRef_t appProcRef, int stdOutFd)void(* le_appProc_StopHandlerFunc_t)(int32_t exitCode, void *contextPtr)Definition: le_appProc_interface.h:170void le_appProc_ClearFaultAction(le_appProc_RefRef_t appProcRef)void le_appProc_SetFaultAction(le_appProc_RefRef_t appProcRef, le_appProc_FaultAction_t action)void le_appProc_ConnectService(void)le_result_t le_appProc_TryConnectService(void)The application should be restarted.Definition: le_appProc_interface.h:146void le_appProc_SetPriority(le_appProc_RefRef_t appProcRef, const char *priority)void le_appProc_AddArg(le_appProc_RefRef_t appProcRef, const char *arg)void le_appProc_DisconnectService(void)void le_appProc_Delete(le_appProc_RefRef_t appProcRef)A fault occured but no further action is required.Definition: le_appProc_interface.h:142void le_appProc_SetStdErr(le_appProc_RefRef_t appProcRef, int stdErrFd)struct le_appProc_StopHandler * le_appProc_StopHandlerRef_tDefinition: le_appProc_interface.h:161The application should be terminated.Definition: le_appProc_interface.h:148void le_appProc_SetStdIn(le_appProc_RefRef_t appProcRef, int stdInFd)le_result_t le_appProc_Start(le_appProc_RefRef_t appProcRef)le_appProc_StopHandlerRef_t le_appProc_AddStopHandler(le_appProc_RefRef_t appProcRef, le_appProc_StopHandlerFunc_t handlerPtr, void *contextPtr)void le_appProc_RemoveStopHandler(le_appProc_StopHandlerRef_t handlerRef)void le_appProc_ClearArgs(le_appProc_RefRef_t appProcRef)struct le_appProc_Ref * le_appProc_RefRef_tDefinition: le_appProc_interface.h:132le_appProc_RefRef_t le_appProc_Create(const char *appName, const char *procName, const char *execPath)The process should be restarted.Definition: le_appProc_interface.h:144void(* le_appProc_DisconnectHandler_t)(void *)Definition: le_appProc_interface.h:50