f286f23b70
git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@52564 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
106 lines
3.4 KiB
C++
106 lines
3.4 KiB
C++
/////////////////////////////////////////////////////////////////////////////
|
|
// Name: unix/execute.h
|
|
// Purpose: private details of wxExecute() implementation
|
|
// Author: Vadim Zeitlin
|
|
// Id: $Id$
|
|
// Copyright: (c) 1998 Robert Roebling, Julian Smart, Vadim Zeitlin
|
|
// Licence: wxWindows licence
|
|
/////////////////////////////////////////////////////////////////////////////
|
|
|
|
#ifndef _WX_UNIX_EXECUTE_H
|
|
#define _WX_UNIX_EXECUTE_H
|
|
|
|
#include "wx/unix/pipe.h"
|
|
|
|
class WXDLLIMPEXP_FWD_BASE wxProcess;
|
|
class wxStreamTempInputBuffer;
|
|
|
|
// some ports have toolkit-specific implementations of wxAddProcessCallback()
|
|
// but by default we use a generic wxFDIOHandler-based mechanism under Unix
|
|
#if defined(__UNIX__) && \
|
|
!(defined(__WXGTK__) || defined(__WXMOTIF__) || defined(__WXMGL__))
|
|
#define wxHAS_GENERIC_PROCESS_CALLBACK 1
|
|
#endif
|
|
|
|
#ifdef wxHAS_GENERIC_PROCESS_CALLBACK
|
|
struct wxEndProcessFDIOHandler;
|
|
#endif
|
|
|
|
// if pid > 0, the execution is async and the data is freed in the callback
|
|
// executed when the process terminates, if pid < 0, the execution is
|
|
// synchronous and the caller (wxExecute) frees the data
|
|
struct wxEndProcessData
|
|
{
|
|
int pid; // pid of the process
|
|
int tag; // port dependent value
|
|
wxProcess *process; // if !NULL: notified on process termination
|
|
int exitcode; // the exit code
|
|
|
|
#ifdef wxHAS_GENERIC_PROCESS_CALLBACK
|
|
wxEndProcessFDIOHandler *fdioHandler;
|
|
#endif
|
|
};
|
|
|
|
// struct in which information is passed from wxExecute() to wxAppTraits
|
|
// methods
|
|
struct wxExecuteData
|
|
{
|
|
wxExecuteData()
|
|
{
|
|
flags =
|
|
pid = 0;
|
|
|
|
process = NULL;
|
|
|
|
#if wxUSE_STREAMS
|
|
bufOut =
|
|
bufErr = NULL;
|
|
#endif // wxUSE_STREAMS
|
|
}
|
|
|
|
// wxExecute() flags
|
|
int flags;
|
|
|
|
// the pid of the child process
|
|
int pid;
|
|
|
|
// the associated process object or NULL
|
|
wxProcess *process;
|
|
|
|
// pipe used for end process detection
|
|
wxPipe pipeEndProcDetect;
|
|
|
|
#if wxUSE_STREAMS
|
|
// the input buffer bufOut is connected to stdout, this is why it is
|
|
// called bufOut and not bufIn
|
|
wxStreamTempInputBuffer *bufOut,
|
|
*bufErr;
|
|
#endif // wxUSE_STREAMS
|
|
};
|
|
|
|
// this function is called when the process terminates from port specific
|
|
// callback function and is common to all ports (src/unix/utilsunx.cpp)
|
|
extern WXDLLIMPEXP_BASE void wxHandleProcessTermination(wxEndProcessData *proc_data);
|
|
|
|
// This function is called to associate the port-specific callback with the
|
|
// child process. The return valus is port-specific.
|
|
//
|
|
// The file descriptor 'fd' is descriptor of a dummy pipe opened between the
|
|
// parent and the child. No data are written to or read from this pipe, its
|
|
// sole purpose is that the child process will close it when it terminates and
|
|
// the parent will be notified about it if it looks at 'fd' (e.g. using
|
|
// select()).
|
|
//
|
|
// wxAddProcessCallback() does whatever is necessary to ensure that 'fd' is
|
|
// periodically (typically every event loop iteration) checked for its status
|
|
// and that wxHandleProcessTermination() is called once 'fd' indicates the
|
|
// child terminated.
|
|
extern WXDLLIMPEXP_CORE int wxAddProcessCallback(wxEndProcessData *proc_data, int fd);
|
|
|
|
#if defined(__WXMAC__) || defined(__WXCOCOA__)
|
|
// For ports (e.g. DARWIN) which can add callbacks based on the pid
|
|
extern int wxAddProcessCallbackForPid(wxEndProcessData *proc_data, int pid);
|
|
#endif
|
|
|
|
#endif // _WX_UNIX_EXECUTE_H
|