process.h

Go to the documentation of this file.

#pragma once
 
 
 
#include <cx/closure/closure.h>
#include <cx/container/hashtable.h>
#include <cx/container/sarray.h>
#include <cx/cx.h>
#include <cx/sys/processobj.h>
 
CX_C_BEGIN
 
 
typedef int64 ProcessID;
 
#define PROCESS_InvalidID ((ProcessID)-1)
 
#define PROC_ExitCodeUnknown ((int32)-1)
 
typedef struct ProcessInfo {
    ProcessID pid;    
    ProcessID ppid;   
    string name;      
    string exepath;   
} ProcessInfo;
 
stDeclare(ProcessInfo);
saDeclare(ProcessInfo);
#define SType_ProcessInfo                         ProcessInfo*
#define STStorageType_ProcessInfo                 ProcessInfo
#define STypeArg_ProcessInfo(type, val)           stgeneric(opaque, &(val))
#define STypeArgPtr_ProcessInfo(type, val)        &stgeneric(opaque, (val))
#define STypeCheckedArg_ProcessInfo(type, val)    stType(type), stArg(type, val)
#define STypeCheckedPtrArg_ProcessInfo(type, val) stType(type), stArgPtr(type, val)
 
enum ProcEnumFlags {
    PROC_EnumFullPath = 0x0001,
};
 
void procInfoInit(_Out_ ProcessInfo* info);
 
void procInfoDestroy(_Inout_ ProcessInfo* info);
 
void procInfoCopy(_Inout_ ProcessInfo* dest, _In_ const ProcessInfo* src);
 
bool procEnum(_Inout_ sa_ProcessInfo* out, flags_t flags);
 
bool procFind(_Inout_ sa_ProcessInfo* out, _In_ strref name, flags_t flags);
 
bool procGetInfoByID(_Inout_ ProcessInfo* out, ProcessID pid, flags_t flags);
 
bool procGetInfo(_Inout_ ProcessInfo* out, _In_ Process* proc, flags_t flags);
 
ProcessID procCurrentID(void);
 
typedef enum ProcStdioEnum {
    PROC_StdioInherit = 0,   
    PROC_StdioNull,          
 
    PROC_StdioFile,
} ProcStdio;
 
enum ProcLaunchFlags {
    PROC_Detached = 0x0001,
 
    PROC_NewGroup = 0x0002,
 
    PROC_NoWindow = 0x0004,
 
    PROC_NewConsole = 0x0008,
};
 
typedef struct ProcessOpts {
    string workdir;      
    ProcStdio stdio;     
    string stdioPath;    
    hashtable env;       
    sa_string envUnset;  
    flags_t flags;       
} ProcessOpts;
 
void procOptsInit(_Out_ ProcessOpts* opts);
 
void procOptsDestroy(_Inout_ ProcessOpts* opts);
 
void procOptsSetEnv(_Inout_ ProcessOpts* opts, _In_ strref name, _In_opt_ strref val);
 
void procOptsUnsetEnv(_Inout_ ProcessOpts* opts, _In_ strref name);
 
_Ret_opt_valid_ Process* procLaunch(_In_ strref exe, sa_string args, _In_opt_ ProcessOpts* opts);
 
_Ret_opt_valid_ Process* procOpen(ProcessID pid);
 
#define procRelease(pproc) objRelease(pproc)
 
ProcessID procID(_In_ Process* proc);
 
bool procRunning(_In_ Process* proc);
 
bool procWait(_In_ Process* proc, int64 timeout);
 
bool procExitCode(_In_ Process* proc, _Out_ int32* code);
 
bool procTerminate(_In_ Process* proc, bool force);
 
bool procNotifyExit(_In_ Process* proc, _In_ closure cls);
 
void procNotifyCancel(_In_ Process* proc);
 
bool procName(_In_ Process* proc, _Inout_ string* out);
 
bool procExePath(_In_ Process* proc, _Inout_ string* out);
 
CX_C_END