process.h

Go to the documentation of this file.

#ifndef POSER_CORE_PROCESS_H
#define POSER_CORE_PROCESS_H
 
#include <poser/decl.h>
#include <sys/types.h>
 
#define PSC_ERR_EXEC 127
 
typedef enum PSC_StreamType
{
    PSC_ST_STDIN,   
    PSC_ST_STDOUT,  
    PSC_ST_STDERR   
} PSC_StreamType;
 
typedef enum PSC_StreamAction
{
    PSC_SA_LEAVE,   
    PSC_SA_CLOSE,   
    PSC_SA_NULL,    
    PSC_SA_PIPE     
} PSC_StreamAction;
 
C_CLASS_DECL(PSC_Process);
 
C_CLASS_DECL(PSC_ProcessOpts);
 
C_CLASS_DECL(PSC_EAProcessDone);
 
C_CLASS_DECL(PSC_Connection);
C_CLASS_DECL(PSC_Event);
 
typedef void (*PSC_StreamCallback)(void *obj,
    PSC_StreamType type, PSC_Connection *conn);
 
typedef int (*PSC_ProcessMain)(int argc, char **argv);
 
DECLEXPORT PSC_ProcessOpts *
PSC_ProcessOpts_create(void)
    ATTR_RETNONNULL;
 
DECLEXPORT void
PSC_ProcessOpts_setName(PSC_ProcessOpts *self, const char *name)
    CMETHOD ATTR_NONNULL((2));
 
DECLEXPORT void
PSC_ProcessOpts_addArg(PSC_ProcessOpts *self, const char *arg)
    CMETHOD ATTR_NONNULL((2));
 
DECLEXPORT int
PSC_ProcessOpts_streamAction(PSC_ProcessOpts *self, PSC_StreamType stream,
    PSC_StreamAction action)
    CMETHOD;
 
DECLEXPORT int
PSC_ProcessOpts_setExecError(PSC_ProcessOpts *self, int execError)
    CMETHOD;
 
DECLEXPORT void
PSC_ProcessOpts_destroy(PSC_ProcessOpts *self);
 
DECLEXPORT PSC_Process *
PSC_Process_create(const PSC_ProcessOpts *opts)
    ATTR_RETNONNULL;
 
DECLEXPORT int
PSC_Process_exec(PSC_Process *self, void *obj, PSC_StreamCallback cb,
    const char *path)
    CMETHOD ATTR_NONNULL((3));
 
DECLEXPORT int
PSC_Process_run(PSC_Process *self, void *obj, PSC_StreamCallback cb,
    PSC_ProcessMain main)
    CMETHOD ATTR_NONNULL((3));
 
DECLEXPORT int
PSC_Process_stop(PSC_Process *self, unsigned forceMs)
    CMETHOD;
 
DECLEXPORT PSC_Event *
PSC_Process_done(PSC_Process *self)
    CMETHOD ATTR_RETNONNULL;
 
DECLEXPORT pid_t
PSC_Process_pid(const PSC_Process *self)
    CMETHOD;
 
DECLEXPORT int
PSC_EAProcessDone_status(const PSC_EAProcessDone *self)
    CMETHOD;
 
DECLEXPORT int
PSC_EAProcessDone_signal(const PSC_EAProcessDone *self)
    CMETHOD;
 
#endif