blocxx

WaitpidThreadFix.hpp

Go to the documentation of this file.
00001 #ifndef BLOCXX_WAITPID_THREAD_FIX_HPP_20060418
00002 #define BLOCXX_WAITPID_THREAD_FIX_HPP_20060418
00003 
00004 /*******************************************************************************
00005 * Copyright (C) 2005, Quest Software, Inc. All rights reserved.
00006 * 
00007 * Redistribution and use in source and binary forms, with or without
00008 * modification, are permitted provided that the following conditions are met:
00009 * 
00010 *     * Redistributions of source code must retain the above copyright notice,
00011 *       this list of conditions and the following disclaimer.
00012 *     * Redistributions in binary form must reproduce the above copyright
00013 *       notice, this list of conditions and the following disclaimer in the
00014 *       documentation and/or other materials provided with the distribution.
00015 *     * Neither the name of Quest Software, Inc., nor the
00016 *       names of its contributors or employees may be used to endorse or promote
00017 *       products derived from this software without specific prior written
00018 *       permission.
00019 * 
00020 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
00021 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
00022 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
00023 * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
00024 * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
00025 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
00026 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
00027 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
00028 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
00029 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
00030 * POSSIBILITY OF SUCH DAMAGE.
00031 *******************************************************************************/
00032 
00037 #include "Types.hpp"
00038 #include "CommonFwd.hpp"
00039 #include "ThreadTypes.hpp"
00040 #include "blocxx/Process.hpp"
00041 
00042 namespace BLOCXX_NAMESPACE
00043 {
00044 
00045 /*******************************************************************************
00046 * Older linux threading libraries do not allow one thread to wait on the 
00047 * children of another thread. This class is used by Exec and Process to work
00048 * around that limitation by having all calls to fork() and waitpid() done 
00049 * by the same thread when BLOCXX_WAITPID_THREADING_PROBLEM is defined.
00050 *******************************************************************************/
00051 namespace WaitpidThreadFix
00052 {
00053 
00060    BLOCXX_COMMON_API bool setWaitpidThreadFixEnabled(bool enabled);
00061    
00062    /*******************************************************************************
00063    * Exec::spawn & Process::pollStatus will call this function
00064    * to determine if WaitpidThreadFix should be used.
00065    *******************************************************************************/
00066    BLOCXX_COMMON_API bool shouldUseWaitpidThreadFix();
00067    
00068    BLOCXX_COMMON_API ProcessRef spawnProcess(
00069       char const * exec_path, 
00070       char const * const argv[], 
00071       char const * const envp[], 
00072       Exec::PreExec & pre_exec
00073    );
00074 
00075    BLOCXX_COMMON_API Process::Status waitPid(const ProcId& pid);
00076 
00077 } // end namespace WaitpidThreadFix
00078 
00079 
00080 } // namespace BLOCXX_NAMESPACE
00081 
00082 #endif // BLOCXX_WAITPID_THREAD_FIX_HPP_20060418
00083