1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
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
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
|
// $Id$
// ============================================================================
//
// = LIBRARY
// ace
//
// = FILENAME
// Thread_Adapter.h
//
// = AUTHOR
// Carlos O'Ryan <coryan@uci.edu>
//
// ============================================================================
#ifndef ACE_THREAD_ADAPTER_H
#define ACE_THREAD_ADAPTER_H
#include "ace/pre.h"
#include "ace/config-all.h"
#if !defined (ACE_LACKS_PRAGMA_ONCE)
# pragma once
#endif /* ACE_LACKS_PRAGMA_ONCE */
#include "ace/OS.h"
// Run the thread entry point for the <ACE_Thread_Adapter>. This must
// be an extern "C" to make certain compilers happy...
#if defined (ACE_PSOS)
extern "C" void ace_thread_adapter (unsigned long args);
#else /* ! defined (ACE_PSOS) */
extern "C" ACE_Export void *ace_thread_adapter (void *args);
#endif /* ACE_PSOS */
class ACE_OS_Thread_Descriptor
{
// = TITLE
// Parent class of all ACE_Thread_Descriptor classes.
//
// =
// Container for ACE_Thread_Descriptor members that are
// used in ACE_OS.
public:
long flags (void) const;
// Get the thread creation flags.
protected:
ACE_OS_Thread_Descriptor (long flags = 0);
// For use by ACE_Thread_Descriptor.
long flags_;
// Keeps track of whether this thread was created "detached" or not.
// If a thread is *not* created detached then if someone calls
// <ACE_Thread_Manager::wait>, we need to join with that thread (and
// close down the handle).
};
// Forward decl.
class ACE_Thread_Manager;
class ACE_Thread_Descriptor;
class ACE_Export ACE_Thread_Adapter
{
// = TITLE
// Converts a C++ function into a function <ace_thread_adapter>
// function that can be called from a thread creation routine
// (e.g., <pthread_create> or <_beginthreadex>) that expects an
// extern "C" entry point. This class also makes it possible to
// transparently provide hooks to register a thread with an
// <ACE_Thread_Manager>.
//
// = DESCRIPTION
// This class is used in <ACE_OS::thr_create>. In general, the
// thread that creates an object of this class is different from
// the thread that calls <invoke> on this object. Therefore,
// the <invoke> method is responsible for deleting itself.
public:
ACE_Thread_Adapter (ACE_THR_FUNC user_func,
void *arg,
ACE_THR_C_FUNC entry_point = (ACE_THR_C_FUNC) ace_thread_adapter,
ACE_Thread_Manager *thr_mgr = 0,
ACE_Thread_Descriptor *td = 0
# if defined (ACE_HAS_WIN32_STRUCTURAL_EXCEPTIONS)
, ACE_SEH_EXCEPT_HANDLER selector = 0,
ACE_SEH_EXCEPT_HANDLER handler = 0
# endif /* ACE_HAS_WIN32_STRUCTURAL_EXCEPTIONS */
);
// Constructor.
void *invoke (void);
// Execute the <user_func_> with the <arg>. This function deletes
// <this>, thereby rendering the object useless after the call
// returns.
ACE_Thread_Manager *thr_mgr (void);
// Accessor for the optional <Thread_Manager>.
ACE_THR_C_FUNC entry_point (void);
// Accessor for the C entry point function to the OS thread creation
// routine.
static void close_log_msg (void);
// Invoke the close_log_msg_hook, if it is present
static void sync_log_msg (const ACE_TCHAR *prog_name);
// Invoke the sync_log_msg_hook, if it is present
private:
~ACE_Thread_Adapter (void);
// Ensure that this object must be allocated on the heap.
void inherit_log_msg (void);
// Inherit the logging features if the parent thread has an
// <ACE_Log_Msg>.
static ACE_INIT_LOG_MSG_HOOK init_log_msg_hook_;
static ACE_INHERIT_LOG_MSG_HOOK inherit_log_msg_hook_;
static ACE_CLOSE_LOG_MSG_HOOK close_log_msg_hook_;
static ACE_SYNC_LOG_MSG_HOOK sync_log_msg_hook_;
// The hooks to inherit and cleanup the Log_Msg attributes
static void set_log_msg_hooks (ACE_INIT_LOG_MSG_HOOK init_hook,
ACE_INHERIT_LOG_MSG_HOOK inherit_hook,
ACE_CLOSE_LOG_MSG_HOOK close_hook,
ACE_SYNC_LOG_MSG_HOOK sync_hook);
// Set the Log_Msg hooks
friend class ACE_Log_Msg;
// Allow the ACE_Log_Msg class to set its hooks.
private:
ACE_THR_FUNC user_func_;
// Thread startup function passed in by the user (C++ linkage).
void *arg_;
// Argument to thread startup function.
ACE_THR_C_FUNC entry_point_;
// Entry point to the underlying OS thread creation call (C
// linkage).
ACE_Thread_Manager *thr_mgr_;
// Optional thread manager.
ACE_OS_Thread_Descriptor *thr_desc_;
// Optional thread descriptor. Passing this pointer in will force
// the spawned thread to cache this location in <Log_Msg> and wait
// until <Thread_Manager> fills in all information in thread
// descriptor.
void *log_msg_attributes_;
// The ACE_Log_Msg attributes.
friend class ACE_Thread_Adapter_Has_Private_Destructor;
// Friend declaration to avoid compiler warning: only defines a private
// destructor and has no friends.
};
# if defined (ACE_HAS_INLINED_OSCALLS)
# if defined (ACE_INLINE)
# undef ACE_INLINE
# endif /* ACE_INLINE */
# define ACE_INLINE inline
# include "ace/Thread_Adapter.inl"
# endif /* ACE_HAS_INLINED_OSCALLS */
#include "ace/post.h"
#endif /* ACE_THREAD_ADAPTER_H */
|
