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
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
|
/**
* @file initservice.C
*
* Implements Initialization Service for Host boot.
* See initservice.H for details
*
*/
#include <kernel/console.H>
#include <sys/vfs.h>
#include <sys/task.h>
#include <trace/interface.H>
#include <errl/errlentry.H>
#include <errl/errlmanager.H>
#include <sys/sync.h>
#include "initservice.H"
#include "initsvctasks.H"
namespace INITSERVICE
{
trace_desc_t *g_trac_initsvc = NULL;
TRAC_INIT(&g_trac_initsvc, "INITSERVICE", 4096);
/******************************************************************************/
// InitService::getTheInstance return the only instance
/******************************************************************************/
InitService& InitService::getTheInstance()
{
return Singleton<InitService>::instance();
}
/******************************************************************************/
// InitService::Initservice constructor
/******************************************************************************/
InitService::InitService()
{
}
/******************************************************************************/
// InitService::~InitService destructor
/******************************************************************************/
InitService::~InitService()
{
}
/**
* @todo mechanism to set taskcommand in TaskArgs struct
* @todo check taskreturncode inside of TaskArgs
* @todo test errorlog inside of Taskargs
*/
errlHndl_t InitService::startTask( const TaskInfo *i_ptask,
TaskArgs::TaskArgs *io_pargs,
errlHndl_t &io_rerrl ) const
{
tid_t tidrc = 0;
assert(i_ptask->taskflags.task_type == START_TASK);
tidrc = task_exec( i_ptask->taskname, io_pargs ); // launch the child
if ( static_cast<int16_t>(tidrc) < 0 )
{
// task failed to launch, post an errorlog and dump some trace
io_rerrl = new ERRORLOG::ErrlEntry(
ERRORLOG::ERRL_SEV_CRITICAL_SYS_TERM, // severity
i_ptask->taskflags.module_id, // moduleid
INITSERVICE::START_TASK_FAILED, // reason Code
tidrc, // user1 = tidrc
0
);
TRACDBIN( g_trac_initsvc,
"ERROR starting task:",
i_ptask->taskname,
strlen(i_ptask->taskname) );
TRACDCOMP( g_trac_initsvc,
"tidrc=%d, errlog p = %p" ,
(int16_t)tidrc, io_rerrl );
} // endif tidrc
else
{
// task launched OK.
TRACDBIN( g_trac_initsvc,
"Task finished OK :",
i_ptask->taskname,
strlen(i_ptask->taskname) );
TRACDCOMP( g_trac_initsvc,
"task number %d, errlog p = %p",
tidrc, io_rerrl );
if ( io_pargs )
{
io_pargs->waitParentSync(); // sync up childtask
}
}
return io_rerrl;
}
errlHndl_t InitService::executeFn( const TaskInfo *i_ptask,
TaskArgs *io_pargs
) const
{
tid_t tidrc = 0;
errlHndl_t errl = NULL;
if ( i_ptask->taskfn == NULL )
{
TRACDBIN( g_trac_initsvc,
"ERROR: NULL function pointer:",
i_ptask->taskname,
strlen(i_ptask->taskname) );
errl = new ERRORLOG::ErrlEntry(
ERRORLOG::ERRL_SEV_CRITICAL_SYS_TERM, // severity
i_ptask->taskflags.module_id, // moduleid
INITSERVICE::NULL_FN_PTR, // reason Code
0,
0 );
return errl;
}
// valid function, launch it
tidrc = task_create( i_ptask->taskfn, io_pargs );
if ( static_cast<int16_t>(tidrc) < 0 )
{
errl = new ERRORLOG::ErrlEntry(
ERRORLOG::ERRL_SEV_CRITICAL_SYS_TERM, // severity
i_ptask->taskflags.module_id, // moduleid
INITSERVICE::START_FN_FAILED, // reason Code
tidrc, // user1 = tidrc
0 );
TRACDBIN( g_trac_initsvc,
ENTER_MRK "ERROR starting function:",
i_ptask->taskname,
strlen(i_ptask->taskname) );
TRACDCOMP( g_trac_initsvc,
EXIT_MRK "tidrc=%d, errlog p = %p" ,
(int16_t)tidrc, errl );
} // endif tidrc
else
{
TRACDBIN( g_trac_initsvc,
ENTER_MRK "function launched OK :",
i_ptask->taskname,
strlen(i_ptask->taskname) );
TRACDCOMP( g_trac_initsvc,
EXIT_MRK "task number %d, errlog p = %p",
tidrc, errl );
// task launched OK.
if ( io_pargs )
{
io_pargs->waitParentSync(); // sync up parent task
}
}
return errl;
}
void InitService::reportError(errlHndl_t &io_rerrl ) const
{
if ( io_rerrl == NULL )
{
// this is OK, do nothing
}
else
{
TRACDCOMP( g_trac_initsvc,
"Committing the error log %p.",
io_rerrl
);
errlCommit( io_rerrl );
}
return;
}
/**
* @todo this will make a system call to post the error code.
*/
void InitService::setProgressCode( uint64_t &i_progresscode ) const
{
// do nothing for now
}
/**
* @note For task_type = NONE case, I'm assuming that trace will not crash
* if we have a NULL taskname string, printing it is useful for debug.
*/
void InitService::init( void *i_ptr )
{
errlHndl_t errl = NULL; // steps will return an error handle if failure
uint64_t nextTask = 0;
const TaskInfo *ptask = NULL;
TaskArgs::TaskArgs args;
TRACFCOMP( g_trac_initsvc,
ENTER_MRK "Initialization Service is starting." );
// ----------------------------------------------------------------
// loop through the task list and start up any tasks necessary
// ----------------------------------------------------------------
for ( nextTask=0;
nextTask<INITSERVICE::MAX_TASKS;
nextTask++ )
{
// make a local copy of the base image task
ptask = &(iv_taskinfolist[nextTask]);
if ( ptask->taskflags.task_type == END_TASK_LIST )
{
TRACDCOMP( g_trac_initsvc,
"End of Initialization Service task list.\n" );
break;
}
// dispatch tasks...
switch ( ptask->taskflags.task_type)
{
case NONE:
// task is a place holder, skip
TRACDBIN( g_trac_initsvc,
"task_type==NONE",
ptask->taskname,
strlen( ptask->taskname) );
break;
case START_TASK:
TRACDBIN( g_trac_initsvc,
"task_type==START_TASK",
ptask->taskname,
strlen( ptask->taskname) );
errl = startTask( ptask, // task struct
&args, // args
errl ); // errlog
break;
case START_FN:
TRACDCOMP( g_trac_initsvc,
"task_type==START_FN : %p",
ptask->taskfn );
// $$TODO
break;
case BARRIER:
TRACDCOMP( g_trac_initsvc,
"task_type==BARRIER" );
// $$TODO
break;
default:
TRACDCOMP( g_trac_initsvc,
"Invalid task_type %d: ",
ptask->taskflags.task_type );
errl = new ERRORLOG::ErrlEntry(
ERRORLOG::ERRL_SEV_CRITICAL_SYS_TERM, // severity
BASE_INITSVC_ERRL_ID, // moduleid
INVALID_TASK_TYPE, // reason Code
0, // user1 = tidrc
0 );
break;
} // endswitch
// report an error
reportError( errl );
} // endfor
// die if we drop out with an error
assert( errl == NULL);
TRACFCOMP( g_trac_initsvc,
EXIT_MRK "Initilization Service finished.");
// return to _start(), which may end the task or die.
return;
}
} // namespace INITSERVICE
|