OS_NS_sys_wait.h File Reference

#include "ace/config-all.h"
#include "ace/os_include/sys/os_wait.h"
#include "ace/ACE_export.h"
#include "ace/OS_NS_sys_wait.inl"

Include dependency graph for OS_NS_sys_wait.h:

This graph shows which files directly or indirectly include this file:

Namespaces
namespace	ACE_OS
Defines
#define	ACE_EXPORT_MACRO   ACE_Export
#define	ACE_INLINE   inline
Functions
ACE_NAMESPACE_INLINE_FUNCTION pid_t	wait (int *=0)
ACE_NAMESPACE_INLINE_FUNCTION pid_t	wait (pid_t pid, ACE_exitcode *status, int wait_options=0, ACE_HANDLE handle=0)
ACE_NAMESPACE_INLINE_FUNCTION pid_t	waitpid (pid_t pid, ACE_exitcode *status=0, int wait_options=0, ACE_HANDLE handle=0)

---

Detailed Description

Id

OS_NS_sys_wait.h,v 1.4 2005/10/28 16:14:54 ossama Exp

Author:

Douglas C. Schmidt <schmidt@cs.wustl.edu>

Jesper S. M|ller<stophph@diku.dk>

and a cast of thousands...

Originally in OS.h.

---

Define Documentation

#define ACE_EXPORT_MACRO   ACE_Export

#define ACE_INLINE   inline

---

Function Documentation

ACE_INLINE pid_t ACE_OS::wait (  pid_t  pid, ACE_exitcode *  status, int  wait_options = 0, ACE_HANDLE  handle = 0 )

Calls <::WaitForSingleObject> on Win32 and <ACE::waitpid> otherwise. Returns the passed in <pid_t> on success and -1 on failure. On Win32, <pid> is ignored if the <handle> is not equal to 0. Passing the process <handle> is prefer on Win32 because using <pid> to wait on the project doesn't always work correctly if the waited process has already terminated.

ACE_BEGIN_VERSIONED_NAMESPACE_DECL ACE_INLINE pid_t ACE_OS::wait (  int *  = 0  )

Calls OS <wait> function, so it's only portable to UNIX/POSIX platforms.

ACE_INLINE pid_t ACE_OS::waitpid (  pid_t  pid, ACE_exitcode *  status = 0, int  wait_options = 0, ACE_HANDLE  handle = 0 )

Calls <waitpid> on UNIX/POSIX platforms and <::await> on Chorus. Does not work on Vxworks, or pSoS. On Win32, <pid> is ignored if the <handle> is not equal to 0. Passing the process <handle> is prefer on Win32 because using <pid> to wait on the project doesn't always work correctly if the waited process has already terminated.

---