3 //**************************************************************************
4 //* This file is property of and copyright by the ALICE HLT Project *
5 //* ALICE Experiment at CERN, All rights reserved. *
7 //* Primary Authors: Matthias Richter <Matthias.Richter@ift.uib.no> *
8 //* for The ALICE HLT Project. *
10 //* Permission to use, copy, modify and distribute this software and its *
11 //* documentation strictly for non-commercial purposes is hereby granted *
12 //* without fee, provided that the above copyright notice appears in all *
13 //* copies and that both the copyright notice and this permission notice *
14 //* appear in the supporting documentation. The authors make no claims *
15 //* about the suitability of this software for any purpose. It is *
16 //* provided "as is" without express or implied warranty. *
17 //**************************************************************************
19 /** @file AliHLTSystem.cxx
20 @author Matthias Richter
22 @brief Implementation of HLT module management.
30 #include "AliHLTStdIncludes.h"
31 #include "AliHLTSystem.h"
32 #include "AliHLTComponentHandler.h"
33 #include "AliHLTComponent.h"
34 #include "AliHLTConfiguration.h"
35 #include "AliHLTConfigurationHandler.h"
36 #include "AliHLTTask.h"
37 #include "AliHLTModuleAgent.h"
38 #include "AliHLTOfflineInterface.h"
39 #include "AliHLTDataSource.h"
40 #include "AliHLTOUT.h"
41 #include "AliHLTOUTHandler.h"
42 #include "AliHLTOUTTask.h"
43 #include <TObjArray.h>
44 #include <TObjString.h>
45 #include <TStopwatch.h>
46 //#include <TSystem.h>
48 //#include <TInterpreter.h>
50 /** HLT default component libraries */
51 const char* AliHLTSystem::fgkHLTDefaultLibs[]= {
55 // "libAliHLTSample.so",
59 "libAliHLTTrigger.so",
63 /** ROOT macro for the implementation of ROOT specific class methods */
64 ClassImp(AliHLTSystem)
66 AliHLTSystem::AliHLTSystem(AliHLTComponentLogSeverity loglevel)
68 fpComponentHandler(AliHLTComponentHandler::CreateHandler()),
69 fpConfigurationHandler(AliHLTConfigurationHandler::CreateHandler()),
73 fStopwatches(new TObjArray),
76 fpChainHandlers(NULL),
78 fpProprietaryHandlers(NULL),
81 // see header file for class documentation
83 // refer to README to build package
85 // visit http://web.ift.uib.no/~kjeks/doc/alice-hlt
87 if (fgNofInstances++>0) {
88 // July 2008: multiple instances are now allowed
89 // AliHLTSystem is used in multiple instances for the kChain HLTOUT handler
90 //HLTWarning("multiple instances of AliHLTSystem, you should not use more than one at a time");
93 SetGlobalLoggingLevel(loglevel);
94 SetFrameworkLog(loglevel);
95 if (fpComponentHandler) {
96 AliHLTComponentEnvironment env;
97 memset(&env, 0, sizeof(AliHLTComponentEnvironment));
98 env.fAllocMemoryFunc=AliHLTSystem::AllocMemory;
99 env.fLoggingFunc=NULL;
100 fpComponentHandler->SetEnvironment(&env);
101 InitAliLogFunc(fpComponentHandler);
102 if (fgNofInstances==1) {
103 fpComponentHandler->AnnounceVersion();
106 HLTFatal("can not create Component Handler");
108 if (fpConfigurationHandler) {
109 AliHLTConfiguration::GlobalInit(fpConfigurationHandler);
111 HLTFatal("can not create Configuration Handler");
115 AliHLTSystem::~AliHLTSystem()
117 // see header file for class documentation
120 AliHLTConfiguration::GlobalDeinit(fpConfigurationHandler);
121 if (fpConfigurationHandler) {
122 fpConfigurationHandler->Destroy();
124 fpConfigurationHandler=NULL;
126 if (fpComponentHandler) {
127 fpComponentHandler->Destroy();
129 fpComponentHandler=NULL;
132 int AliHLTSystem::fgNofInstances=0;
134 int AliHLTSystem::AddConfiguration(AliHLTConfiguration* pConf)
136 // see header file for class documentation
137 HLTLogKeyword("configuration handling");
140 HLTError("function not yet implemented");
148 int AliHLTSystem::InsertConfiguration(AliHLTConfiguration* pConf, AliHLTConfiguration* pPrec)
150 // see header file for class documentation
151 HLTLogKeyword("configuration handling");
156 HLTError("function not yet implemented");
165 int AliHLTSystem::DeleteConfiguration(AliHLTConfiguration* pConf)
167 // see header file for class documentation
168 HLTLogKeyword("configuration handling");
171 HLTError("function not yet implemented");
179 int AliHLTSystem::BuildTaskList(const char* id)
181 // see header file for class documentation
184 if (fpConfigurationHandler) {
185 AliHLTConfiguration* pConf=fpConfigurationHandler->FindConfiguration(id);
187 iResult=BuildTaskList(pConf);
189 HLTError("unknown configuration \"%s\"", id);
201 int AliHLTSystem::BuildTaskList(AliHLTConfiguration* pConf)
203 // see header file for class documentation
206 AliHLTTask* pTask=NULL;
207 if ((pTask=FindTask(pConf->GetName()))!=NULL) {
208 if (pTask->GetConf()!=pConf) {
209 HLTError("configuration mismatch, there is already a task with configuration name \"%s\", but it is different. Most likely configuration %p is not registered properly", pConf->GetName(), pConf);
212 // task for this configuration exists, terminate
214 } else if (pConf->SourcesResolved(1)!=1) {
215 HLTError("configuration \"%s\" has unresolved sources, aborting ...", pConf->GetName());
218 pTask=new AliHLTTask(pConf);
222 pTask->SetLocalLoggingLevel(GetLocalLoggingLevel());
225 static int iterationLevel=0;
226 if (pTask && iResult>=0) {
227 // check for circular dependencies
228 if ((iResult=pConf->FollowDependency(pConf->GetName()))>0) {
229 HLTError("detected circular dependency for configuration \"%s\"", pTask->GetName());
230 pTask->PrintDependencyTree(pTask->GetName(), 1/*use the configuration list*/);
231 HLTError("aborted ...");
235 // check whether all dependencies are already in the task list
236 // create the missing ones
237 // this step is an iterative process which calls this function again for the missing
238 // configurations, in order to avoid the currently processed task to be created
239 // again it is added to the list temporarily and removed afterwards
240 // This is of high importance to preserve the order of the tasks. Furthermore, the
241 // InsertTask method has to be used in order to set all the cross links right
242 fTaskList.Add(pTask);
243 AliHLTConfiguration* pDep=pConf->GetFirstSource();
244 while (pDep!=NULL && iResult>=0) {
245 HLTDebug("iteration %d: checking dependency %s (%p)", iterationLevel, pDep->GetName(), pDep);
246 if (FindTask(pDep->GetName())==NULL) {
247 HLTDebug("iteration %d: building task list for configuration %s (%p)", iterationLevel, pDep->GetName(), pDep);
249 iResult=BuildTaskList(pDep);
252 pDep=pConf->GetNextSource();
254 // remove the temporarily added task
255 fTaskList.Remove(pTask);
257 // insert the task and set the cross-links
259 HLTDebug("iteration %d: inserting task %s (%p)", iterationLevel, pTask->GetName(), pTask);
260 iResult=InsertTask(pTask);
273 int AliHLTSystem::CleanTaskList()
275 // see header file for class documentation
278 while ((lnk=fTaskList.LastLink())!=NULL) {
279 delete (lnk->GetObject());
280 fTaskList.Remove(lnk);
285 int AliHLTSystem::InsertTask(AliHLTTask* pTask)
287 // see header file for class documentation
289 TObjLink *lnk = NULL;
290 if ((iResult=pTask->CheckDependencies())>0)
291 lnk=fTaskList.FirstLink();
292 while (lnk && iResult>0) {
293 AliHLTTask* pCurr = (AliHLTTask*)lnk->GetObject();
294 //HLTDebug("checking \"%s\"", pCurr->GetName());
295 iResult=pTask->Depends(pCurr);
297 iResult=pTask->SetDependency(pCurr);
298 pCurr->SetTarget(pTask);
299 HLTDebug("set dependency \"%s\" for configuration \"%s\"", pCurr->GetName(), pTask->GetName());
301 if (pCurr->Depends(pTask)) {
302 // circular dependency
303 HLTError("circular dependency: can not resolve dependencies for configuration \"%s\"", pTask->GetName());
305 } else if ((iResult=pTask->CheckDependencies())>0) {
311 fTaskList.AddAfter(lnk, pTask);
313 fTaskList.AddFirst(pTask);
315 HLTDebug("task \"%s\" (%p) inserted (size %d)", pTask->GetName(), pTask, sizeof(AliHLTTask));
316 } else if (iResult>0) {
317 HLTError("can not resolve dependencies for configuration \"%s\" (%d unresolved)", pTask->GetName(), iResult);
323 AliHLTTask* AliHLTSystem::FindTask(const char* id)
325 // see header file for class documentation
326 AliHLTTask* pTask=NULL;
328 pTask=dynamic_cast<AliHLTTask*>(fTaskList.FindObject(id));
333 void AliHLTSystem::PrintTaskList()
335 // see header file for class documentation
336 HLTLogKeyword("task list");
337 TObjLink *lnk = NULL;
338 HLTMessage("Task List");
339 lnk=fTaskList.FirstLink();
341 TObject* obj=lnk->GetObject();
343 HLTMessage(" %s - status:", obj->GetName());
344 AliHLTTask* pTask=(AliHLTTask*)obj;
345 pTask->PrintStatus();
352 int AliHLTSystem::Run(Int_t iNofEvents, int bStop)
354 // see header file for class documentation
357 SetStatusFlags(kRunning);
358 if (fEventCount>=0 || (iResult=InitTasks())>=0) {
359 if (fEventCount>=0 || (iResult=StartTasks())>=0) {
360 if (fEventCount==0) {
361 InitBenchmarking(fStopwatches);
363 ResumeBenchmarking(fStopwatches);
365 for (int i=fEventCount; i<fEventCount+iNofEvents && iResult>=0; i++) {
367 if (iNofEvents>1 && i==fEventCount) {
368 HLTWarning("can not add more than one event to the HLTOUT, skipping all but last block");
370 // reset and prepare for new data
371 fpHLTOUTTask->Reset();
373 if ((iResult=ProcessTasks(i))>=0) {
377 // TODO: define different running modes to either ignore errors in
378 // event processing or not
383 fEventCount+=iNofEvents;
384 if (bStop) StopTasks();
385 else PauseBenchmarking(fStopwatches);
387 if (bStop) DeinitTasks();
391 } else if (iResult==-126 /*ENOKEY*/) {
392 iResult=0; // do not propagate the error
394 ClearStatusFlags(kRunning);
398 int AliHLTSystem::InitTasks()
400 // see header file for class documentation
402 TObjLink *lnk=fTaskList.FirstLink();
405 HLTWarning("Task list is empty, skipping HLT");
406 return -126 /*ENOKEY*/;
408 while (lnk && iResult>=0) {
409 TObject* obj=lnk->GetObject();
411 AliHLTTask* pTask=(AliHLTTask*)obj;
412 iResult=pTask->Init(NULL, fpComponentHandler);
413 // ProcInfo_t ProcInfo;
414 // gSystem->GetProcInfo(&ProcInfo);
415 // HLTInfo("task %s initialized (%d), current memory usage %d %d", pTask->GetName(), iResult, ProcInfo.fMemResident, ProcInfo.fMemVirtual);
421 HLTError("can not initialize task list, error %d", iResult);
427 int AliHLTSystem::InitBenchmarking(TObjArray* pStopwatches)
429 // see header file for class documentation
431 if (pStopwatches==NULL) return 0;
433 for (int i=0; i<(int)AliHLTComponent::kSWTypeCount; i++) {
434 TStopwatch* pStopwatch= new TStopwatch;
437 pStopwatches->AddAt(pStopwatch, i);
444 TObjLink *lnk=fTaskList.FirstLink();
445 while (lnk && iResult>=0) {
446 TObject* obj=lnk->GetObject();
448 AliHLTTask* pTask=(AliHLTTask*)obj;
449 AliHLTComponent* pComp=NULL;
450 if (iResult>=0 && (pComp=pTask->GetComponent())!=NULL) {
451 switch (pComp->GetComponentType()) {
452 case AliHLTComponent::kProcessor:
453 pComp->SetStopwatches(pStopwatches);
455 case AliHLTComponent::kSource:
457 // this switch determines whether the time consumption of the
458 // AliHLTComponent base methods should be counted to the input
459 // stopwatch or base stopwatch.
460 //int inputBase=(int)AliHLTComponent::kSWBase;
461 int inputBase=(int)AliHLTComponent::kSWInput;
462 pComp->SetStopwatch(pStopwatches->At(inputBase), AliHLTComponent::kSWBase);
463 pComp->SetStopwatch(pStopwatches->At((int)AliHLTComponent::kSWInput), AliHLTComponent::kSWDA);
466 case AliHLTComponent::kSink:
468 // this switch determines whether the time consumption of the
469 // AliHLTComponent base methods should be counted to the output
470 // stopwatch or base stopwatch.
471 //int outputBase=(int)AliHLTComponent::kSWBase;
472 int outputBase=(int)AliHLTComponent::kSWOutput;
473 pComp->SetStopwatch(pStopwatches->At(outputBase), AliHLTComponent::kSWBase);
474 pComp->SetStopwatch(pStopwatches->At((int)AliHLTComponent::kSWOutput), AliHLTComponent::kSWDA);
478 HLTWarning("unknown component type %d", (int)pComp->GetComponentType());
488 int AliHLTSystem::PauseBenchmarking(TObjArray* pStopwatches) const
490 // see header file for class documentation
491 if (pStopwatches==NULL) return 0;
493 for (int i=0; i<(int)AliHLTComponent::kSWTypeCount; i++) {
494 if (!pStopwatches->At(i)) continue;
495 TStopwatch* pSw=dynamic_cast<TStopwatch*>(pStopwatches->At(i));
496 if (pSw) pSw->Stop();
501 int AliHLTSystem::ResumeBenchmarking(TObjArray* pStopwatches) const
503 // see header file for class documentation
504 if (pStopwatches==NULL) return 0;
506 for (int i=0; i<(int)AliHLTComponent::kSWTypeCount; i++) {
507 if (!pStopwatches->At(i)) continue;
508 TStopwatch* pSw=dynamic_cast<TStopwatch*>(pStopwatches->At(i));
509 if (pSw) pSw->Continue();
514 int AliHLTSystem::PrintBenchmarking(TObjArray* pStopwatches, int bClean) const
516 // see header file for class documentation
518 if (pStopwatches==NULL) return 0;
520 for (int i=0; i<(int)AliHLTComponent::kSWTypeCount; i++) {
521 if (!dynamic_cast<TStopwatch*>(pStopwatches->At(i))) {
527 if (iInitialized!=0) {
528 HLTImportant("HLT statistics:\n"
529 " base: R:%.3fs C:%.3fs\n"
530 " input: R:%.3fs C:%.3fs\n"
531 " output: R:%.3fs C:%.3fs\n"
532 " event processing : R:%.3fs C:%.3fs"
533 , dynamic_cast<TStopwatch*>(pStopwatches->At(AliHLTComponent::kSWBase))->RealTime()
534 , dynamic_cast<TStopwatch*>(pStopwatches->At(AliHLTComponent::kSWBase))->CpuTime()
535 , dynamic_cast<TStopwatch*>(pStopwatches->At(AliHLTComponent::kSWInput))->RealTime()
536 , dynamic_cast<TStopwatch*>(pStopwatches->At(AliHLTComponent::kSWInput))->CpuTime()
537 , dynamic_cast<TStopwatch*>(pStopwatches->At(AliHLTComponent::kSWOutput))->RealTime()
538 , dynamic_cast<TStopwatch*>(pStopwatches->At(AliHLTComponent::kSWOutput))->CpuTime()
539 , dynamic_cast<TStopwatch*>(pStopwatches->At(AliHLTComponent::kSWDA))->RealTime()
540 , dynamic_cast<TStopwatch*>(pStopwatches->At(AliHLTComponent::kSWDA))->CpuTime()
545 for (int i=0; i<(int)AliHLTComponent::kSWTypeCount; i++) {
546 TObject* pObj=pStopwatches->RemoveAt(i);
547 if (pObj) delete pObj;
553 int AliHLTSystem::StartTasks()
555 // see header file for class documentation
557 TObjLink *lnk=fTaskList.FirstLink();
558 while (lnk && iResult>=0) {
559 TObject* obj=lnk->GetObject();
561 AliHLTTask* pTask=(AliHLTTask*)obj;
562 iResult=pTask->StartRun();
563 // ProcInfo_t ProcInfo;
564 // gSystem->GetProcInfo(&ProcInfo);
565 // HLTInfo("task %s started (%d), current memory usage %d %d", pTask->GetName(), iResult, ProcInfo.fMemResident, ProcInfo.fMemVirtual);
571 HLTError("can not start task list, error %d", iResult);
573 SetStatusFlags(kStarted);
576 if ((iResult=SendControlEvent(kAliHLTDataTypeSOR))<0) {
577 HLTError("can not send SOR event");
583 int AliHLTSystem::ProcessTasks(Int_t eventNo)
585 // see header file for class documentation
587 HLTDebug("processing event no %d", eventNo);
588 TObjLink *lnk=fTaskList.FirstLink();
589 while (lnk && iResult>=0) {
590 TObject* obj=lnk->GetObject();
592 AliHLTTask* pTask=(AliHLTTask*)obj;
593 iResult=pTask->ProcessTask(eventNo);
594 // ProcInfo_t ProcInfo;
595 // gSystem->GetProcInfo(&ProcInfo);
596 // HLTInfo("task %s processed (%d), current memory usage %d %d", pTask->GetName(), iResult, ProcInfo.fMemResident, ProcInfo.fMemVirtual);
603 HLTImportant("Event %d successfully finished (%d)", eventNo, iResult);
606 HLTError("Processing of event %d failed (%d)", eventNo, iResult);
612 int AliHLTSystem::StopTasks()
614 // see header file for class documentation
616 if ((iResult=SendControlEvent(kAliHLTDataTypeEOR))<0) {
617 HLTError("can not send EOR event");
619 TObjLink *lnk=fTaskList.FirstLink();
621 TObject* obj=lnk->GetObject();
623 AliHLTTask* pTask=(AliHLTTask*)obj;
624 int locResult=pTask->EndRun();
625 if (iResult>=0 && locResult<0) iResult=locResult;
626 // ProcInfo_t ProcInfo;
627 // gSystem->GetProcInfo(&ProcInfo);
628 // HLTInfo("task %s stopped (%d), current memory usage %d %d", pTask->GetName(), iResult, ProcInfo.fMemResident, ProcInfo.fMemVirtual);
633 PrintBenchmarking(fStopwatches, 1 /*clean*/);
634 ClearStatusFlags(kStarted);
638 int AliHLTSystem::SendControlEvent(AliHLTComponentDataType dt)
640 // see header file for class documentation
642 // disabled for the moment
646 AliHLTRunDesc runDesc;
647 memset(&runDesc, 0, sizeof(AliHLTRunDesc));
648 runDesc.fStructSize=sizeof(AliHLTRunDesc);
649 AliHLTDataSource::AliSpecialEventGuard g(&runDesc, dt, kAliHLTVoidDataSpec);
650 HLTDebug("sending event %s, run descriptor %p", AliHLTComponent::DataType2Text(dt).c_str(), &runDesc);
651 TObjLink *lnk=fTaskList.FirstLink();
652 while (lnk && iResult>=0) {
653 TObject* obj=lnk->GetObject();
655 AliHLTTask* pTask=(AliHLTTask*)obj;
656 iResult=pTask->ProcessTask(-1);
661 HLTDebug("event %s done (%d)", AliHLTComponent::DataType2Text(dt).c_str(), iResult);
665 int AliHLTSystem::DeinitTasks()
667 // see header file for class documentation
669 TObjLink *lnk=fTaskList.FirstLink();
670 while (lnk && iResult>=0) {
671 TObject* obj=lnk->GetObject();
673 AliHLTTask* pTask=(AliHLTTask*)obj;
674 iResult=pTask->Deinit();
675 // ProcInfo_t ProcInfo;
676 // gSystem->GetProcInfo(&ProcInfo);
677 // HLTInfo("task %s cleaned (%d), current memory usage %d %d", pTask->GetName(), iResult, ProcInfo.fMemResident, ProcInfo.fMemVirtual);
688 void* AliHLTSystem::AllocMemory( void* /*param*/, unsigned long size )
690 // see header file for class documentation
693 p=(void*)new char[size];
697 log.LoggingVarargs(kHLTLogError, "AliHLTSystem" , "AllocMemory" , __FILE__ , __LINE__ , "exeption during memory allocation" );
702 int AliHLTSystem::Reconstruct(int nofEvents, AliRunLoader* runLoader,
703 AliRawReader* rawReader)
705 // see header file for class documentation
707 if (runLoader || rawReader || nofEvents==0) {
708 if (nofEvents>0) {HLTInfo("Run Loader %p, Raw Reader %p , %d event(s)", runLoader, rawReader, nofEvents);}
709 if (CheckStatus(kReady)) {
711 // special case to close the reconstruction
712 if (!CheckStatus(kError)) {
717 if ((iResult=AliHLTOfflineInterface::SetParamsToComponents(runLoader, rawReader))>=0) {
718 // the system always remains started after event processing, a specific
719 // call with nofEvents==0 is needed to execute the stop sequence
720 if ((iResult=Run(nofEvents, 0))<0) SetStatusFlags(kError);
724 HLTError("wrong state %#x, required flags %#x", GetStatusFlags(), kReady);
727 HLTError("missing RunLoader (%p)/RawReader (%p) instance", runLoader, rawReader);
733 int AliHLTSystem::FillESD(int eventNo, AliRunLoader* runLoader, AliESDEvent* esd)
735 // see header file for class documentation
737 if (runLoader || esd) {
738 HLTInfo("Event %d: Run Loader %p, ESD %p", eventNo, runLoader, esd);
739 iResult=AliHLTOfflineInterface::FillComponentESDs(eventNo, runLoader, esd);
741 HLTError("missing run loader/ESD instance(s)");
747 int AliHLTSystem::ProcessHLTOUT(AliHLTOUT* pHLTOUT, AliESDEvent* esd)
749 // see header file for class documentation
751 if (!pHLTOUT) return -EINVAL;
752 HLTDebug("processing %d HLT data blocks", pHLTOUT->GetNofDataBlocks());
754 // add the current HLTOUT task to the collection
756 AliHLTOUT* pTask=dynamic_cast<AliHLTOUT*>(fpHLTOUTTask);
757 if (pTask && (iResult=pTask->Init())>=0) {
758 if (pTask->GetNofDataBlocks()>0) {
759 pHLTOUT->AddSubCollection(pTask);
762 HLTWarning("can not initialize HLTOUT sub collection %s for reconstruction chain (%d), data blocks are lost", pTask?fpHLTOUTTask->GetName():"nil", iResult);
769 // process all kChain handlers first
771 if ((iResult=ProcessHLTOUTkChain(pHLTOUT))<0) {
772 HLTWarning("Processing of kChain-type data blocks failed with error code %d", iResult);
777 fpEsdHandlers=new AliHLTOUT::AliHLTOUTHandlerListEntryVector;
778 if (!fpProprietaryHandlers)
779 fpProprietaryHandlers=new AliHLTOUT::AliHLTOUTHandlerListEntryVector;
781 AliHLTOUT::AliHLTOUTHandlerListEntryVector* pEsdHandlers=reinterpret_cast<AliHLTOUT::AliHLTOUTHandlerListEntryVector*>(fpEsdHandlers);
782 AliHLTOUT::AliHLTOUTHandlerListEntryVector* pProprietaryHandlers=reinterpret_cast<AliHLTOUT::AliHLTOUTHandlerListEntryVector*>(fpProprietaryHandlers);
783 if (!pEsdHandlers || !pProprietaryHandlers) return -ENOMEM;
785 // invalidate all blocks
786 AliHLTOUT::InvalidateBlocks(*pEsdHandlers);
787 AliHLTOUT::InvalidateBlocks(*pProprietaryHandlers);
789 // first come first serve: the ESD of the first handler is also filled into
790 // the main ESD. Has to be changed later.
791 // currently, merging to the provided ESDs crashes at the level of the
792 // TTree::Fill in AliReconstruction, furthermore, the wrong ESD is passed
794 AliESDEvent* pMasterESD=NULL;
797 AliHLTComponentDataTypeList esdBlocks;
799 for (iResult=pHLTOUT->SelectFirstDataBlock();
801 iResult=pHLTOUT->SelectNextDataBlock()) {
802 AliHLTComponentDataType dt=kAliHLTVoidDataType;
803 AliHLTUInt32_t spec=kAliHLTVoidDataSpec;
804 pHLTOUT->GetDataBlockDescription(dt, spec);
805 AliHLTOUTHandler* pHandler=pHLTOUT->GetHandler();
806 AliHLTModuleAgent::AliHLTOUTHandlerType handlerType=pHLTOUT->GetDataBlockHandlerType();
808 // default handling for ESD data blocks does not require an explicite handler
809 if (!pHandler && (dt==kAliHLTDataTypeESDObject || dt==kAliHLTDataTypeESDTree)) {
810 handlerType=AliHLTModuleAgent::kEsd;
812 const char* pMsg="invalid";
813 switch (handlerType) {
814 case AliHLTModuleAgent::kEsd:
817 // schedule for later processing
818 pHLTOUT->InsertHandler(*pEsdHandlers, pHLTOUT->GetDataBlockHandlerDesc());
820 AliHLTComponentDataTypeList::iterator element=esdBlocks.begin();
821 for (; element!=esdBlocks.end(); element++) {
823 HLTWarning("multiple ESDs of identical data type %s, please add appropriate handler to merge ESDs", AliHLTComponent::DataType2Text(dt).c_str());
827 if (element==esdBlocks.end()) esdBlocks.push_back(dt);
830 const AliHLTUInt8_t* pBuffer=NULL;
831 AliHLTUInt32_t size=0;
832 if (pHLTOUT->GetDataBuffer(pBuffer, size)>=0) {
833 pHLTOUT->WriteESD(pBuffer, size, dt);
835 pHLTOUT->WriteESD(pBuffer, size, dt, pMasterESD);
838 pHLTOUT->ReleaseDataBuffer(pBuffer);
840 pHLTOUT->MarkDataBlockProcessed();
844 case AliHLTModuleAgent::kRawReader:
845 // handled in the AliRawReaderHLT
847 case AliHLTModuleAgent::kRawStream:
848 HLTWarning("HLTOUT handler type 'kRawStream' not yet implemented: agent %s, data type %s, specification %#x",
849 pMsg, pHLTOUT->GetAgent()?pHLTOUT->GetAgent()->GetModuleId():"invalid",
850 AliHLTComponent::DataType2Text(dt).c_str(), spec);
852 case AliHLTModuleAgent::kChain:
853 HLTWarning("HLTOUT handler type 'kChain' has already been processed: agent %s, data type %s, specification %#x\n"
854 "New block of this type added by the chain? Skipping data block ...",
855 pMsg, pHLTOUT->GetAgent()?pHLTOUT->GetAgent()->GetModuleId():"invalid",
856 AliHLTComponent::DataType2Text(dt).c_str(), spec);
858 case AliHLTModuleAgent::kProprietary:
859 HLTDebug("processing proprietary data: agent %s, data type %s, specification %#x",
860 pMsg, pHLTOUT->GetAgent()?pHLTOUT->GetAgent()->GetModuleId():"invalid",
861 AliHLTComponent::DataType2Text(dt).c_str(), spec);
863 AliHLTOUT::AliHLTOUTLockGuard g(pHLTOUT);
864 int res=pHandler->ProcessData(pHLTOUT);
866 HLTWarning("processing proprietary data failed (%d): agent %s, data type %s, specification %#x",
867 res, pMsg, pHLTOUT->GetAgent()?pHLTOUT->GetAgent()->GetModuleId():"invalid",
868 AliHLTComponent::DataType2Text(dt).c_str(), spec);
872 case AliHLTModuleAgent::kUnknownOutput:
874 // fall trough intended
876 HLTWarning("%s handler type: agent %s, data type %s, specification %#x, ... skipping data block",
877 pMsg, pHLTOUT->GetAgent()?pHLTOUT->GetAgent()->GetModuleId():"invalid",
878 AliHLTComponent::DataType2Text(dt).c_str(), spec);
881 // TODO: the return value of SelectFirst/NextDataBlock must be
882 // changed in order to avoid this check
883 if (iResult==-ENOENT) iResult=0;
885 AliHLTOUT::AliHLTOUTHandlerListEntryVector::iterator handler;
887 // process and write all esd data blocks
888 for (handler=pEsdHandlers->begin(); handler!=pEsdHandlers->end() && iResult>=0; handler++) {
889 AliHLTOUT::AliHLTOUTSelectionGuard g(pHLTOUT, &(*handler));
890 AliHLTOUTHandler* pHandler=*handler;
891 const AliHLTUInt8_t* pBuffer=NULL;
892 AliHLTUInt32_t size=0;
893 pHandler->ProcessData(pHLTOUT);
894 if ((size=pHandler->GetProcessedData(pBuffer))>0) {
895 AliHLTModuleAgent::AliHLTOUTHandlerDesc desc=*handler;
896 AliHLTComponentDataType dt=desc;
897 pHLTOUT->WriteESD(pBuffer, size, dt);
899 pHLTOUT->WriteESD(pBuffer, size, dt, pMasterESD);
902 pHandler->ReleaseProcessedData(pBuffer, size);
904 pHLTOUT->MarkDataBlocksProcessed(&(*handler));
907 // process all kProprietary data blocks
908 for (handler=pProprietaryHandlers->begin(); handler!=pProprietaryHandlers->end() && iResult>=0; handler++) {
909 AliHLTOUT::AliHLTOUTSelectionGuard g(pHLTOUT, &(*handler));
910 AliHLTOUTHandler* pHandler=*handler;
911 const AliHLTUInt8_t* pBuffer=NULL;
912 AliHLTUInt32_t size=0;
913 pHandler->ProcessData(pHLTOUT);
914 if ((size=pHandler->GetProcessedData(pBuffer))>0) {
915 HLTWarning("data produced by kProprietary handler ignored");
916 pHandler->ReleaseProcessedData(pBuffer, size);
918 pHLTOUT->MarkDataBlocksProcessed(&(*handler));
921 // remove all empty handlers form the list (handlers which did not get a block this time)
922 AliHLTOUT::RemoveEmptyDuplicateHandlers(*pEsdHandlers);
923 AliHLTOUT::RemoveEmptyDuplicateHandlers(*pProprietaryHandlers);
928 int AliHLTSystem::ProcessHLTOUTkChain(AliHLTOUT* pHLTOUT)
930 // see header file for class documentation
932 if (!pHLTOUT) return -EINVAL;
934 if (!fpChainHandlers)
935 fpChainHandlers=new AliHLTOUT::AliHLTOUTHandlerListEntryVector;
937 AliHLTOUT::AliHLTOUTHandlerListEntryVector* pChainHandlers=reinterpret_cast<AliHLTOUT::AliHLTOUTHandlerListEntryVector*>(fpChainHandlers);
938 if (!pChainHandlers) return -ENOMEM;
940 // invalidate all blocks
941 AliHLTOUT::InvalidateBlocks(*pChainHandlers);
944 pHLTOUT->FillHandlerList(*pChainHandlers, AliHLTModuleAgent::kChain);
946 // process all defined chain handlers
947 AliHLTOUT::AliHLTOUTHandlerListEntryVector::iterator chainHandler;
948 for (chainHandler=pChainHandlers->begin(); chainHandler!=pChainHandlers->end() && iResult>=0; chainHandler++) {
949 if (chainHandler->IsEmpty()) continue;
950 AliHLTOUT::AliHLTOUTSelectionGuard g(pHLTOUT, &(*chainHandler));
951 AliHLTOUTHandler* pHandler=*chainHandler;
952 const AliHLTUInt8_t* pBuffer=NULL;
953 AliHLTUInt32_t size=0;
954 pHandler->ProcessData(pHLTOUT);
955 if ((size=pHandler->GetProcessedData(pBuffer))>0) {
956 AliHLTModuleAgent::AliHLTOUTHandlerDesc desc=*chainHandler;
957 AliHLTComponentDataType dt=desc;
959 pHandler->ReleaseProcessedData(pBuffer, size);
961 pHLTOUT->MarkDataBlocksProcessed(&(*chainHandler));
964 // remove all empty handlers form the list (handlers which did not get a block this time)
965 AliHLTOUT::RemoveEmptyDuplicateHandlers(*pChainHandlers);
970 int AliHLTSystem::LoadComponentLibraries(const char* libraries)
972 // see header file for class documentation
975 if (fpComponentHandler) {
976 TString libs(libraries);
977 TObjArray* pTokens=libs.Tokenize(" ");
979 int iEntries=pTokens->GetEntries();
980 for (int i=0; i<iEntries && iResult>=0; i++) {
981 iResult=fpComponentHandler->LoadLibrary((((TObjString*)pTokens->At(i))->GetString()).Data());
986 SetStatusFlags(kLibrariesLoaded);
988 // lets see if we need this, probably not
989 //fpComponentHandler->UnloadLibraries();
990 ClearStatusFlags(kLibrariesLoaded);
994 HLTFatal("no component handler available");
1002 int AliHLTSystem::Configure(AliRunLoader* runloader)
1004 // see header file for class documentation
1005 return Configure(NULL, runloader);
1008 int AliHLTSystem::Configure(AliRawReader* rawReader, AliRunLoader* runloader)
1010 // see header file for class documentation
1012 if (CheckStatus(kRunning)) {
1013 HLTError("HLT system in running state, can not configure");
1016 ClearStatusFlags(kTaskListCreated);
1017 if (CheckFilter(kHLTLogDebug))
1018 AliHLTModuleAgent::PrintStatus();
1019 if (CheckStatus(kConfigurationLoaded)==0) {
1020 iResult=LoadConfigurations(rawReader, runloader);
1022 if (fChains.Length()==0) {
1023 HLTError("custom configuration(s) specified, but no configuration to run in local reconstruction, use \'chains=<chain,...>\' option");
1028 SetStatusFlags(kConfigurationLoaded);
1029 if (CheckFilter(kHLTLogDebug))
1030 fpConfigurationHandler->PrintConfigurations();
1031 iResult=BuildTaskListsFromReconstructionChains(rawReader, runloader);
1033 SetStatusFlags(kTaskListCreated);
1036 if (iResult<0) SetStatusFlags(kError);
1041 int AliHLTSystem::ScanOptions(const char* options)
1043 // see header file for class documentation
1046 //AliHLTComponentHandler::TLibraryMode libMode=AliHLTComponentHandler::kDynamic;
1048 TString alloptions(options);
1049 TObjArray* pTokens=alloptions.Tokenize(" ");
1051 int iEntries=pTokens->GetEntries();
1052 for (int i=0; i<iEntries; i++) {
1053 TString token=(((TObjString*)pTokens->At(i))->GetString());
1054 if (token.Contains("loglevel=")) {
1055 TString param=token.ReplaceAll("loglevel=", "");
1056 if (param.IsDigit()) {
1057 SetGlobalLoggingLevel((AliHLTComponentLogSeverity)param.Atoi());
1058 } else if (param.BeginsWith("0x") &&
1059 param.Replace(0,2,"",0).IsHex()) {
1061 sscanf(param.Data(),"%x", &severity);
1062 SetGlobalLoggingLevel((AliHLTComponentLogSeverity)severity);
1064 HLTWarning("wrong parameter for option \'loglevel=\', (hex) number expected");
1066 } else if (token.Contains("frameworklog=")) {
1067 TString param=token.ReplaceAll("frameworklog=", "");
1068 if (param.IsDigit()) {
1069 SetFrameworkLog((AliHLTComponentLogSeverity)param.Atoi());
1070 } else if (param.BeginsWith("0x") &&
1071 param.Replace(0,2,"",0).IsHex()) {
1073 sscanf(param.Data(),"%x", &severity);
1074 SetFrameworkLog((AliHLTComponentLogSeverity)severity);
1076 HLTWarning("wrong parameter for option \'loglevel=\', (hex) number expected");
1078 } else if (token.Contains("alilog=off")) {
1080 } else if (token.Contains("config=")) {
1081 TString param=token.ReplaceAll("config=", "");
1083 gROOT->Macro(param.Data(), &error);
1085 SetStatusFlags(kConfigurationLoaded);
1087 HLTError("can not execute macro \'%s\'", param.Data());
1090 } else if (token.Contains("chains=")) {
1091 TString param=token.ReplaceAll("chains=", "");
1092 fChains=param.ReplaceAll(",", " ");
1093 if (fChains.IsNull()) fChains=" "; // disable all chains
1094 } else if (token.Contains("libmode=")) {
1095 TString param=token.ReplaceAll("libmode=", "");
1096 param.ReplaceAll(",", " ");
1097 if (fpComponentHandler) {
1098 if (param.CompareTo("static")==0) {
1099 fpComponentHandler->SetLibraryMode(AliHLTComponentHandler::kStatic);
1100 } else if (param.CompareTo("dynamic")==0) {
1101 fpComponentHandler->SetLibraryMode(AliHLTComponentHandler::kDynamic);
1103 HLTWarning("wrong argument for option \'libmode=\', use \'static\' or \'dynamic\'");
1106 } else if (token.BeginsWith("lib") && token.EndsWith(".so")) {
1110 HLTWarning("unknown option \'%s\'", token.Data());
1117 if (libs.IsNull()) {
1118 const char** deflib=fgkHLTDefaultLibs;
1124 if ((!CheckStatus(AliHLTSystem::kLibrariesLoaded)) &&
1125 (LoadComponentLibraries(libs.Data())<0)) {
1126 HLTError("error while loading HLT libraries");
1134 int AliHLTSystem::Reset(int bForce)
1136 // see header file for class documentation
1138 if (!bForce && CheckStatus(kRunning)) {
1139 HLTError("HLT system in running state, can not configure");
1143 ClearStatusFlags(~kUninitialized);
1147 int AliHLTSystem::LoadConfigurations(AliRawReader* rawReader, AliRunLoader* runloader)
1149 // see header file for class documentation
1150 if (CheckStatus(kRunning)) {
1151 HLTError("HLT system in running state, can not configure");
1155 AliHLTModuleAgent* pAgent=AliHLTModuleAgent::GetFirstAgent();
1157 while (pAgent && iResult>=0) {
1158 const char* deplibs=pAgent->GetRequiredComponentLibraries();
1160 HLTDebug("required libraries \'%s\' for agent %s (%p)", deplibs, pAgent->GetName(), pAgent);
1164 HLTDebug("load configurations for agent %s (%p)", pAgent->GetName(), pAgent);
1165 pAgent->CreateConfigurations(fpConfigurationHandler, rawReader, runloader);
1166 pAgent=AliHLTModuleAgent::GetNextAgent();
1170 iResult=LoadComponentLibraries(extralibs.Data());
1176 int AliHLTSystem::BuildTaskListsFromReconstructionChains(AliRawReader* rawReader, AliRunLoader* runloader)
1178 // see header file for class documentation
1179 if (CheckStatus(kRunning)) {
1180 HLTError("HLT system in running state, can not configure");
1183 if (!CheckStatus(kConfigurationLoaded)) {
1184 HLTWarning("configurations not yet loaded");
1193 if (fChains.Length()>0) {
1195 HLTImportant("custom reconstruction chain: %s", chains.Data());
1197 AliHLTModuleAgent* pAgent=AliHLTModuleAgent::GetFirstAgent();
1198 while ((pAgent || fChains.Length()>0) && iResult>=0) {
1199 const char* agentchains=pAgent->GetReconstructionChains(rawReader, runloader);
1201 if (!chains.IsNull()) chains+=" ";
1202 chains+=agentchains;
1203 HLTInfo("reconstruction chains for agent %s (%p): %s", pAgent->GetName(), pAgent, agentchains);
1205 pAgent=AliHLTModuleAgent::GetNextAgent();
1209 // build task list for chains
1210 TObjArray* pTokens=chains.Tokenize(" ");
1212 int iEntries=pTokens->GetEntries();
1213 for (int i=0; i<iEntries && iResult>=0; i++) {
1214 const char* pCID=((TObjString*)pTokens->At(i))->GetString().Data();
1215 AliHLTConfiguration* pConf=fpConfigurationHandler->FindConfiguration(pCID);
1217 iResult=BuildTaskList(pConf);
1218 if (true) { // condition was deprecated but kept for sake of svn diff
1219 // bHaveOutput variable has to be set for both running modes
1220 // AliHLTSimulation and AliHLTReconstruction
1221 assert(fpComponentHandler!=NULL);
1222 TString cid=pConf->GetComponentID();
1223 if (runloader!=NULL && cid.CompareTo("HLTOUT")==0) {
1224 // remove from the input of a global HLTOUT configuration
1225 chains.ReplaceAll(pCID, "");
1226 } else if (bHaveOutput==0) {
1227 // check whether this configuration produces data output
1228 if ((bHaveOutput=fpComponentHandler->HasOutputData(cid.Data()))<0) {
1230 chains.ReplaceAll(pCID, "");
1235 HLTWarning("can not find configuration %s", pCID);
1241 // build HLTOUT for simulation
1242 if (iResult>=0 && runloader) {
1244 // there are components in the chain which produce data which need to be
1245 // piped to an HLTOUT
1246 if (fpComponentHandler->FindComponentIndex("HLTOUT")>=0 ||
1247 fpComponentHandler->LoadLibrary("libHLTsim.so")>=0) {
1248 AliHLTConfiguration globalout("_globalout_", "HLTOUT", chains.Data(), NULL);
1249 iResult=BuildTaskList("_globalout_");
1251 HLTError("can not load libHLTsim.so and HLTOUT component");
1257 // build HLTOUT task for reconstruction
1258 // Matthias 08.07.2008 the rawReader is never set when running embedded into
1259 // AliReconstruction. The system is configured during AliHLTReconstructor::Init
1260 // where the RawReader is not available. It is available in the first invocation
1263 // That means that policy is slightly changed:
1264 // - if the run loader is available -> AliSimulation
1265 // - no run loader available -> AliReconstruction
1266 if (iResult>=0 && !runloader) {
1268 // there are components in the chain which produce data which need to be
1269 // piped to an HLTOUT sub-collection
1270 if (!fpHLTOUTTask) {
1271 fpHLTOUTTask=new AliHLTOUTTask(chains.Data());
1273 if (fpHLTOUTTask->GetConf() && fpHLTOUTTask->GetConf()->SourcesResolved()>=0) {
1274 iResult=InsertTask(fpHLTOUTTask);
1276 HLTError("HLTOUT task (%s) sources not resolved", fpHLTOUTTask->GetName());
1284 if (iResult>=0) SetStatusFlags(kTaskListCreated);
1289 int AliHLTSystem::CheckStatus(int flag)
1291 // see header file for class documentation
1292 if (flag==kUninitialized && flag==fState) return 1;
1293 if ((fState&flag)==flag) return 1;
1297 int AliHLTSystem::GetStatusFlags()
1299 // see header file for class documentation
1303 int AliHLTSystem::SetStatusFlags(int flags)
1305 // see header file for class documentation
1310 int AliHLTSystem::ClearStatusFlags(int flags)
1312 // see header file for class documentation
1317 void* AliHLTSystem::FindDynamicSymbol(const char* library, const char* symbol)
1319 // see header file for class documentation
1320 if (fpComponentHandler==NULL) return NULL;
1321 return fpComponentHandler->FindSymbol(library, symbol);
1324 void AliHLTSystem::SetFrameworkLog(AliHLTComponentLogSeverity level)
1326 // see header file for class documentation
1327 SetLocalLoggingLevel(level);
1328 if (fpComponentHandler) fpComponentHandler->SetLocalLoggingLevel(level);
1329 if (fpConfigurationHandler) fpConfigurationHandler->SetLocalLoggingLevel(level);