DobbyLoggerBase Class Reference

Inheritance diagram for DobbyLoggerBase:

Collaboration diagram for DobbyLoggerBase:

Public Member Functions
virtual bool	postInstallation ()
virtual bool	preCreation ()
virtual bool	createRuntime ()
virtual bool	createContainer ()
virtual bool	postStart ()
virtual bool	postHalt ()
virtual bool	postStop ()
std::vector< std::string >	getDependencies () const override
	Should return the names of the plugins this plugin depends on. More...
Public Member Functions inherited from IDobbyRdkLoggingPlugin
virtual void	RegisterPollSources (int fd, std::shared_ptr< AICommon::IPollLoop > pollLoop)=0
virtual void	DumpToLog (const int bufferFd)=0
Public Member Functions inherited from IDobbyRdkPlugin
virtual std::string	name () const =0
	Should return the name of the plugin. More...
virtual unsigned	hookHints () const =0
	Should return a bitfield of the hook points implemented by the plugin. More...

Additional Inherited Members
Public Types inherited from IDobbyRdkPlugin
enum	HintFlags : unsigned {   PostInstallationFlag = (1 << 0) , PreCreationFlag = (1 << 1) , CreateRuntimeFlag = (1 << 2) , CreateContainerFlag = (1 << 3) ,   PostStartFlag = (1 << 5) , PostHaltFlag = (1 << 6) , PostStopFlag = (1 << 7) , Unknown = 0 }
	Bit flags that should be returned by hookHints. More...

Member Function Documentation

createContainer()

virtual bool DobbyLoggerBase::createContainer ( )

inlinevirtual

Hook Name: createContainer Hook Execution Namespace: container Hook Path Resolution: host

Execution: OCI Runtime (runc/crun)

Hook Description: Run during the create operation, after the runtime environment has been created and before the pivot root or any equivalent operation.

This would run before the pivot_root operation is executed but after the mount namespace was created and setup.

Implements IDobbyRdkPlugin.

createRuntime()

virtual bool DobbyLoggerBase::createRuntime ( )

inlinevirtual

Hook Name: createRuntime Hook Execution Namespace: host Hook Path Resolution: host

Execution: OCI Runtime (runc/crun)

Hook Description: Run during the create operation, after the runtime environment has been created and before the pivot root or any equivalent operation.

Called after the container namespaces are created, so provides an opportunity to customize the container (e.g. the network namespace could be specified in this hook).

Implements IDobbyRdkPlugin.

getDependencies()

std::vector<std::string> DobbyLoggerBase::getDependencies ( ) const

inlineoverridevirtual

Should return the names of the plugins this plugin depends on.

This can be used to determine the order in which the plugins should be processed when running hooks.

Returns

Names of the plugins this plugin depends on.

Implements IDobbyRdkPlugin.

Reimplemented in LoggingPlugin.

postHalt()

virtual bool DobbyLoggerBase::postHalt ( )

inlinevirtual

Hook Name: postHalt Hook Execution Namespace: host Hook Path Resolution: host

Execution: Dobby

Hook Description: When a SIGTERM signal is received from the container. Before the delete operation is called

For example, this hook could perform clean up when a container closes

Implements IDobbyRdkPlugin.

postInstallation()

virtual bool DobbyLoggerBase::postInstallation ( )

inlinevirtual

Hook Name: postInstallation Hook Execution Namespace: host Hook Path Resolution: host

Execution: Dobby

Hook Description: Runs after the OCI bundle has been downloaded to the client STB, before the runtime’s create operation is called. This hook is called only once in lifecycle of container.

Implements IDobbyRdkPlugin.

Reimplemented in LoggingPlugin.

postStart()

virtual bool DobbyLoggerBase::postStart ( )

inlinevirtual

Hook Name: postStart Hook Execution Namespace: host Hook Path Resolution: host

Execution: OCI Runtime (runc/crun)

Hook Description: Runs after the user-specified process is executed but before the start operation returns.

For example, this hook can notify the user that the container process is spawned.

Implements IDobbyRdkPlugin.

postStop()

virtual bool DobbyLoggerBase::postStop ( )

inlinevirtual

Hook Name: postStop Hook Execution Namespace: host Hook Path Resolution: host

Execution: OCI Runtime (runc/crun)

Hook Description: After the container is deleted but before the delete operation returns.

This hook has a confusing name due to to the stateless nature of OCI runtimes - is relates to the OCI DELETE operation so won't be run until crun delete is called

Implements IDobbyRdkPlugin.

preCreation()

virtual bool DobbyLoggerBase::preCreation ( )

inlinevirtual

Hook Name: preCreation Hook Execution Namespace: host Hook Path Resolution: host

Execution: Dobby

Hook Description: Runs before the runtime’s create operation is called. This hook runs every time container need to be created.

Implements IDobbyRdkPlugin.

---

The documentation for this class was generated from the following file:

• rdkPlugins/Common/include/DobbyLoggerBase.h