mirror of
https://github.com/latentPrion/libspinscale.git
synced 2026-01-11 12:19:36 +00:00
69 lines
2.2 KiB
C++
69 lines
2.2 KiB
C++
#ifndef PUPPET_APPLICATION_H
|
|
#define PUPPET_APPLICATION_H
|
|
|
|
#include <config.h>
|
|
#include <functional>
|
|
#include <memory>
|
|
#include <vector>
|
|
#include <spinscale/callback.h>
|
|
#include <spinscale/componentThread.h>
|
|
|
|
namespace sscl {
|
|
|
|
class PuppetApplication
|
|
: public std::enable_shared_from_this<PuppetApplication>
|
|
{
|
|
public:
|
|
PuppetApplication(
|
|
const std::vector<std::shared_ptr<PuppetThread>> &threads);
|
|
~PuppetApplication() = default;
|
|
|
|
// Thread management methods
|
|
typedef std::function<void()> puppetThreadLifetimeMgmtOpCbFn;
|
|
void joltAllPuppetThreadsReq(
|
|
Callback<puppetThreadLifetimeMgmtOpCbFn> callback);
|
|
void startAllPuppetThreadsReq(
|
|
Callback<puppetThreadLifetimeMgmtOpCbFn> callback);
|
|
void pauseAllPuppetThreadsReq(
|
|
Callback<puppetThreadLifetimeMgmtOpCbFn> callback);
|
|
void resumeAllPuppetThreadsReq(
|
|
Callback<puppetThreadLifetimeMgmtOpCbFn> callback);
|
|
void exitAllPuppetThreadsReq(
|
|
Callback<puppetThreadLifetimeMgmtOpCbFn> callback);
|
|
|
|
// CPU distribution method
|
|
void distributeAndPinThreadsAcrossCpus();
|
|
|
|
protected:
|
|
// Collection of PuppetThread instances
|
|
std::vector<std::shared_ptr<PuppetThread>> componentThreads;
|
|
|
|
/**
|
|
* Indicates whether all puppet threads have been JOLTed at least once.
|
|
*
|
|
* JOLTing serves two critical purposes:
|
|
*
|
|
* 1. **Global Constructor Sequencing**: Since pthreads begin executing while
|
|
* global constructors are still being executed, globally defined pthreads
|
|
* cannot depend on global objects having been constructed. JOLTing is done
|
|
* by the CRT's main thread within main(), which provides a sequencing
|
|
* guarantee that global constructors have been called.
|
|
*
|
|
* 2. **shared_from_this Safety**: shared_from_this() requires a prior
|
|
* shared_ptr handle to be established. The global list of
|
|
* shared_ptr<ComponentThread> guarantees that at least one shared_ptr to
|
|
* each ComponentThread has been initialized before JOLTing occurs.
|
|
*
|
|
* This flag ensures that JOLTing happens exactly once and provides
|
|
* a synchronization point for the entire system initialization.
|
|
*/
|
|
bool threadsHaveBeenJolted = false;
|
|
|
|
private:
|
|
class PuppetThreadLifetimeMgmtOp;
|
|
};
|
|
|
|
} // namespace sscl
|
|
|
|
#endif // PUPPET_APPLICATION_H
|