001:
002:
003:
004:
005:
006:
007:
008:
009:
010:
011:
012:
013:
014:
015:
016:
017:
018:
019:
020:
021:
022:
023:
024:
025:
026:
027:
028:
029:
030:
031:
032:
033:
034:
035:
036:
037:
038:
039:
040:
041:
042:
043:
044:
045:
046:
047:
048:
049:
050:
051:
052:
053:
054:
055:
056:
057:
058:
059:
060:
061:
062:
063:
064:
065:
066:
067:
068:
069:
070:
071:
072:
073:
074:
075:
076:
077:
078:
079:
080:
081:
082:
083:
084:
085:
086:
087:
088:
089:
090:
091:
092:
093:
094:
095:
096:
097:
098:
099:
100:
101:
102:
103:
104:
105:
106:
107:
108:
109:
110:
111:
112:
113:
114:
115:
116:
117:
118:
119:
120:
121:
122:
123:
124:
125:
126:
127:
128:
/*
* Copyright (c), Zeriph Enterprises
* All rights reserved.
*
* Contributor(s):
* Zechariah Perez, omni (at) zeriph (dot) com
*
* THIS SOFTWARE IS PROVIDED BY ZERIPH AND CONTRIBUTORS "AS IS" AND ANY
* EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
* WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
* DISCLAIMED. IN NO EVENT SHALL ZERIPH AND CONTRIBUTORS BE LIABLE FOR ANY
* DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
* (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
* LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
* ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
* (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
* SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
*/
#if !defined(OMNI_RUNNABLE_HPP)
#define OMNI_RUNNABLE_HPP 1
#include <omni/sync/runnable.hpp>
#include <omni/types/thread_t.hpp>
#include <omni/sync/spin.hpp>
#if defined(OMNI_SAFE_RUNNABLE_THREAD)
#include <omni/sync/basic_lock.hpp>
#endif
namespace omni {
namespace sync {
class runnable_thread : virtual public omni::sync::runnable
{
public:
typedef omni::delegate2<void, const omni::sync::runnable_thread&, omni::sync::thread_state::enum_t> state_delegate;
typedef omni::event2<void, const omni::sync::runnable_thread&, omni::sync::thread_state::enum_t> state_event;
// Methods
runnable_thread();
runnable_thread(const omni::sync::runnable_thread& cp);
explicit runnable_thread(const omni::sync::runnable& obj);
explicit runnable_thread(const omni::sync::thread_flags& ops);
explicit runnable_thread(std::size_t max_stack_sz);
runnable_thread(const omni::sync::runnable& obj, std::size_t max_stack_sz);
runnable_thread(omni::sync::thread_option::enum_t op, omni::sync::thread_union_t val);
virtual ~runnable_thread();
void abort(); // request end nicely
bool abort_join();
bool abort_join(unsigned long timeout);
const omni::sync::thread_union_t get_option(omni::sync::thread_option::enum_t op) const;
omni::sync::thread_flags get_options() const;
const omni::sync::thread_handle_t handle() const;
const omni::sync::thread_t id() const;
bool is_alive() const;
bool join(); // default of infinite timeout
bool join(unsigned long timeout);
//TODO: add bool join(const omni::timespan& t); when omni::timespan complete
bool kill(); // Terminate 'immediately'
virtual void run(omni::sync::thread_arg_t parm) { OMNI_UNUSED(parm); } // default empty run
bool reset();
bool restart();
bool restart(omni::sync::thread_arg_t args);
omni::sync::thread_state status() const;
omni::sync::thread_t start();
omni::sync::thread_t start(omni::sync::thread_arg_t args);
void set_option(omni::sync::thread_option::enum_t op, omni::sync::thread_union_t val);
void set_options(unsigned char op, bool val);
void set_options(const omni::sync::thread_flags& ops);
void swap(omni::sync::runnable_thread& other);
omni::sync::runnable_thread& operator=(const omni::sync::runnable_thread& other);
using omni::sync::runnable::operator==;
using omni::sync::runnable::operator!=;
bool operator==(const omni::sync::runnable_thread& other) const;
bool operator!=(const omni::sync::runnable_thread& other) const;
#if defined(OMNI_NON_PORTABLE)
omni::sync::thread_priority priority() const;
void set_priority(omni::sync::thread_priority::enum_t p);
#endif
omni::sync::runnable_thread::state_event state_changed;
// disposing,name,type(),hash()
OMNI_MEMBERS_FW(omni::sync::runnable_thread)
protected:
virtual void state_update(omni::sync::thread_state::enum_t old_state) { OMNI_UNUSED(old_state); }
private:
// Methods
void _close_handle();
void _hreset(bool force = false);
bool _hvalid() const;
bool _state_running() const;
void _state_changed(omni::sync::thread_state::enum_t nstate);
void _set_context(const omni::sync::runnable_thread& t2);
#if defined(OMNI_NON_PORTABLE)
void _set_prio();
#endif
static OMNI_THREAD_FNPTR_T OMNI_THREAD_CALL_T _start(void* param);
// Members
#if defined(OMNI_SAFE_RUNNABLE_THREAD)
mutable omni::sync::basic_lock m_mtx;
#endif
omni::sync::thread_arg_t m_args;
omni::sync::runnable* m_iface;
omni::sync::thread_t m_tid;
omni::sync::thread_handle_t m_thread;
omni::sync::thread_flags m_ops;
omni::sync::thread_state m_state;
#if defined(OMNI_NON_PORTABLE)
omni::sync::thread_priority m_priority;
#endif
volatile bool m_isjoined;
};
} // namespace sync
} // namespace omni
namespace std {
inline void swap(omni::sync::runnable_thread& ot1, omni::sync::runnable_thread& ot2)
{
ot1.swap(ot2);
}
}
#endif // OMNI_RUNNABLE_HPP