RunnersRegistry.h

Go to the documentation of this file.

/*
 * Copyright (C) 1996-2023 The Squid Software Foundation and contributors
 *
 * Squid software is distributed under GPLv2+ license and includes
 * contributions from numerous individuals and organizations.
 * Please see the COPYING and CONTRIBUTORS files for details.
 */
 
#ifndef SQUID_BASE_RUNNERSREGISTRY_H
#define SQUID_BASE_RUNNERSREGISTRY_H
 
class RegisteredRunner
{
public:
    /* Related methods below are declared in their calling order */
 
    /* Configuration events */
 
    virtual void bootstrapConfig() {}
 
    virtual void finalizeConfig() {}
 
    virtual void claimMemoryNeeds() {}
 
    virtual void useConfig() {}
 
    /* Reconfiguration events */
 
    virtual void startReconfigure() {}
 
    virtual void syncConfig() {}
 
    /* Shutdown events */
 
    virtual void startShutdown() {}
 
    virtual void endingShutdown() {}
 
    virtual ~RegisteredRunner() {}
 
    virtual void finishShutdown() {}
 
    typedef void (RegisteredRunner::*Method)();
 
};
 
bool RegisterRunner(RegisteredRunner *rr);
 
void RunRegistered(const RegisteredRunner::Method &m);
 
class IndependentRunner: public RegisteredRunner
{
public:
    ~IndependentRunner() override { unregisterRunner(); }
 
protected:
    void registerRunner();
    void unregisterRunner(); 
};
 
#define RunRegisteredHere(m) \
    debugs(1, 2, "running " # m); \
    RunRegistered(&m)
 
bool UseThisStatic(const void *);
 
#define RunnerRegistrationEntry(Who) \
    static const bool Who ## _Registered_ = \
        RegisterRunner(new Who) > 0 && \
        UseThisStatic(& Who ## _Registered_);
 
#endif /* SQUID_BASE_RUNNERSREGISTRY_H */