Used to expire recordings to make space for new recordings. More...

#include <mythbackend/autoexpire.h>

Inheritance diagram for AutoExpire:

Collaboration diagram for AutoExpire:

Public Member Functions
	AutoExpire (QMap< int, EncoderLink * > *tvList)
	Creates AutoExpire class, starting the thread. More...

	AutoExpire ()=default

	~AutoExpire () override
	AutoExpire destructor stops auto delete thread if it is running. More...

void	CalcParams (void)
	Calculates how much space needs to be cleared, and how often. More...

void	PrintExpireList (const QString &expHost="ALL")
	Prints a summary of the files that can be deleted. More...

uint64_t	GetDesiredSpace (int fsID) const
	Used by the scheduler to select the next recording dir. More...

void	GetAllExpiring (QStringList &strList)
	Gets the full list of programs that can expire in expiration order. More...

void	GetAllExpiring (pginfolist_t &list)
	Gets the full list of programs that can expire in expiration order. More...

void	SetMainServer (MainServer *ms)

Static Public Member Functions
static void	ClearExpireList (pginfolist_t &expireList, bool deleteProg=true)
	Clears expireList, freeing any ProgramInfo's if necessary. More...

static void	Update (int encoder, int fsID, bool immediately)
	This is used to update the global AutoExpire instance "expirer". More...

static void	Update (bool immediately)

Public Attributes
QMap< int, EncoderLink * > *	m_encoderList {nullptr}

Protected Member Functions
void	RunExpirer (void)
	This contains the main loop for the auto expire process. More...

Private Member Functions
void	ExpireLiveTV (int type)
	This expires LiveTV programs. More...

void	ExpireOldDeleted (void)
	This expires deleted programs older than DeletedMaxAge. More...

void	ExpireQuickDeleted (void)
	This expires deleted programs within a few minutes. More...

void	ExpireRecordings (void)
	This expires normal recordings. More...

void	ExpireEpisodesOverMax (void)
	This deletes programs exceeding the maximum number of episodes of that program desired. More...

void	FillExpireList (pginfolist_t &expireList)
	Uses the "AutoExpireMethod" setting in the database to fill the list of files that are deletable. More...

void	FillDBOrdered (pginfolist_t &expireList, int expMethod)
	Creates a list of programs to delete using the database to order list. More...

void	Sleep (std::chrono::milliseconds sleepTime)
	Sleeps for sleepTime milliseconds; unless the expire thread is told to quit. More...

void	UpdateDontExpireSet (void)

bool	IsInDontExpireSet (uint chanid, const QDateTime &recstartts) const

Static Private Member Functions
static void	SendDeleteMessages (pginfolist_t &deleteList)
	This sends delete message to main event thread. More...

static bool	IsInExpireList (const pginfolist_t &expireList, uint chanid, const QDateTime &recstartts)

Private Attributes
QSet< QString >	m_dontExpireSet

ExpireThread *	m_expireThread {nullptr}

uint	m_desiredFreq {15}

bool	m_expireThreadRun {false}

QMap< int, int64_t >	m_desiredSpace

QMap< int, int >	m_usedEncoders

QMutex	m_instanceLock

QWaitCondition	m_instanceCond

MainServer *	m_mainServer {nullptr}

QMutex	m_updateLock

QQueue< UpdateEntry >	m_updateQueue

Friends
class	ExpireThread

Detailed Description

Used to expire recordings to make space for new recordings.

Definition at line 59 of file autoexpire.h.

Constructor & Destructor Documentation

◆ AutoExpire() [1/2]

AutoExpire::AutoExpire ( QMap< int, EncoderLink * > * tvList )

explicit

Creates AutoExpire class, starting the thread.

Parameters

tvList EncoderLink list of all recorders

Definition at line 74 of file autoexpire.cpp.

◆ AutoExpire() [2/2]

AutoExpire::AutoExpire ( )

default

◆ ~AutoExpire()

AutoExpire::~AutoExpire ( )

override

AutoExpire destructor stops auto delete thread if it is running.

Definition at line 86 of file autoexpire.cpp.

Member Function Documentation

◆ CalcParams()

void AutoExpire::CalcParams ( void )

Calculates how much space needs to be cleared, and how often.

Definition at line 124 of file autoexpire.cpp.

Referenced by RunExpirer(), and Update().

◆ ClearExpireList()

void AutoExpire::ClearExpireList	(	pginfolist_t &	expireList,
		bool	deleteProg = `true`
	)

static

Clears expireList, freeing any ProgramInfo's if necessary.

Definition at line 888 of file autoexpire.cpp.

Referenced by ExpireLiveTV(), ExpireOldDeleted(), ExpireQuickDeleted(), ExpireRecordings(), FillExpireList(), Scheduler::FillRecordingDir(), GetAllExpiring(), and PrintExpireList().

◆ ExpireEpisodesOverMax()

void AutoExpire::ExpireEpisodesOverMax ( void )

private

This deletes programs exceeding the maximum number of episodes of that program desired.

Excludes recordings in the LiveTV Recording Group.

Definition at line 662 of file autoexpire.cpp.

Referenced by RunExpirer().

◆ ExpireLiveTV()

void AutoExpire::ExpireLiveTV ( int type )

private

This expires LiveTV programs.

Definition at line 364 of file autoexpire.cpp.

Referenced by RunExpirer().

◆ ExpireOldDeleted()

void AutoExpire::ExpireOldDeleted ( void )

private

This expires deleted programs older than DeletedMaxAge.

Definition at line 377 of file autoexpire.cpp.

Referenced by RunExpirer().

◆ ExpireQuickDeleted()

void AutoExpire::ExpireQuickDeleted ( void )

private

This expires deleted programs within a few minutes.

Definition at line 390 of file autoexpire.cpp.

Referenced by RunExpirer().

◆ ExpireRecordings()

void AutoExpire::ExpireRecordings ( void )

private

This expires normal recordings.

Definition at line 404 of file autoexpire.cpp.

Referenced by RunExpirer().

◆ FillDBOrdered()

void AutoExpire::FillDBOrdered	(	pginfolist_t &	expireList,
		int	expMethod
	)

private

Creates a list of programs to delete using the database to order list.

Definition at line 907 of file autoexpire.cpp.

Referenced by ExpireLiveTV(), ExpireOldDeleted(), ExpireQuickDeleted(), FillExpireList(), and GetAllExpiring().

◆ FillExpireList()

void AutoExpire::FillExpireList ( pginfolist_t & expireList )

private

Uses the "AutoExpireMethod" setting in the database to fill the list of files that are deletable.

Definition at line 781 of file autoexpire.cpp.

Referenced by ExpireRecordings(), and PrintExpireList().

◆ GetAllExpiring() [1/2]

void AutoExpire::GetAllExpiring ( pginfolist_t & list )

Gets the full list of programs that can expire in expiration order.

Definition at line 866 of file autoexpire.cpp.

◆ GetAllExpiring() [2/2]

void AutoExpire::GetAllExpiring ( QStringList & strList )

Gets the full list of programs that can expire in expiration order.

Definition at line 842 of file autoexpire.cpp.

Referenced by Scheduler::FillRecordingDir(), V2Dvr::GetExpiringList(), and MainServer::HandleGetExpiringRecordings().

◆ GetDesiredSpace()

uint64_t AutoExpire::GetDesiredSpace ( int fsID ) const

Used by the scheduler to select the next recording dir.

Returns: the desired free space for each file system

Definition at line 113 of file autoexpire.cpp.

Referenced by Scheduler::FillRecordingDir().

◆ IsInDontExpireSet()

bool AutoExpire::IsInDontExpireSet	(	uint	chanid,
		const QDateTime &	recstartts
	)		const

private

Definition at line 1116 of file autoexpire.cpp.

Referenced by ExpireEpisodesOverMax(), and FillDBOrdered().

◆ IsInExpireList()

bool AutoExpire::IsInExpireList	(	const pginfolist_t &	expireList,
		uint	chanid,
		const QDateTime &	recstartts
	)

staticprivate

Definition at line 1125 of file autoexpire.cpp.

Referenced by FillDBOrdered().

◆ PrintExpireList()

void AutoExpire::PrintExpireList ( const QString & expHost = "ALL" )

Prints a summary of the files that can be deleted.

Definition at line 803 of file autoexpire.cpp.

Referenced by handle_command().

◆ RunExpirer()

void AutoExpire::RunExpirer ( void )

protected

This contains the main loop for the auto expire process.

Responsible for cleanup of old LiveTV programs as well as deleting as many recordings that are expirable as necessary to maintain enough free space on all directories in MythTV Storage Groups. The thread deletes short LiveTV programs every 2 minutes and long LiveTV and regular programs as needed every "desired_freq" minutes.

Definition at line 271 of file autoexpire.cpp.

◆ SendDeleteMessages()

void AutoExpire::SendDeleteMessages ( pginfolist_t & deleteList )

staticprivate

This sends delete message to main event thread.

Definition at line 625 of file autoexpire.cpp.

Referenced by ExpireLiveTV(), ExpireOldDeleted(), ExpireQuickDeleted(), and ExpireRecordings().

◆ SetMainServer()

void AutoExpire::SetMainServer ( MainServer * ms )

inline

Definition at line 81 of file autoexpire.h.

Referenced by MainServer::MainServer(), and MainServer::Stop().

◆ Sleep()

void AutoExpire::Sleep ( std::chrono::milliseconds sleepTime )

private

Sleeps for sleepTime milliseconds; unless the expire thread is told to quit.

Must be called with instance_lock held.

Note: Will release instance_lock!

Definition at line 347 of file autoexpire.cpp.

Referenced by RunExpirer().

◆ Update() [1/2]

static void AutoExpire::Update ( bool immediately )

inlinestatic

Definition at line 79 of file autoexpire.h.

Referenced by Update().

◆ Update() [2/2]

void AutoExpire::Update	(	int	encoder,
		int	fsID,
		bool	immediately
	)

static

This is used to update the global AutoExpire instance "expirer".

Parameters

encoder	This recorder starts a recording now
fsID	file system ID of the writing directory
immediately	If true CalcParams() is called directly. If false, a thread is spawned to call CalcParams(), this is for use in the MainServer event thread where calling CalcParams() directly would deadlock the event thread.

Definition at line 1046 of file autoexpire.cpp.

Referenced by MainServer::autoexpireUpdate(), Scheduler::GetNextLiveTVDir(), Scheduler::HandleRecording(), and MainServer::MainServer().

◆ UpdateDontExpireSet()

void AutoExpire::UpdateDontExpireSet ( void )

private

Definition at line 1081 of file autoexpire.cpp.

Referenced by GetAllExpiring(), and RunExpirer().

Friends And Related Function Documentation

◆ ExpireThread

friend class ExpireThread

friend

Definition at line 63 of file autoexpire.h.

Member Data Documentation

◆ m_desiredFreq

uint AutoExpire::m_desiredFreq {15}

private

Definition at line 112 of file autoexpire.h.

Referenced by CalcParams(), and RunExpirer().

◆ m_desiredSpace

QMap<int, int64_t> AutoExpire::m_desiredSpace

private

Definition at line 115 of file autoexpire.h.

Referenced by CalcParams(), ExpireRecordings(), and GetDesiredSpace().

◆ m_dontExpireSet

QSet<QString> AutoExpire::m_dontExpireSet

private

Definition at line 110 of file autoexpire.h.

Referenced by IsInDontExpireSet(), and UpdateDontExpireSet().

◆ m_encoderList

QMap<int, EncoderLink *>* AutoExpire::m_encoderList {nullptr}

Definition at line 87 of file autoexpire.h.

Referenced by CalcParams(), and ExpireRecordings().

◆ m_expireThread

ExpireThread* AutoExpire::m_expireThread {nullptr}

private

Definition at line 111 of file autoexpire.h.

Referenced by AutoExpire(), and ~AutoExpire().

◆ m_expireThreadRun

bool AutoExpire::m_expireThreadRun {false}

private

Definition at line 113 of file autoexpire.h.

Referenced by RunExpirer(), Sleep(), and ~AutoExpire().

◆ m_instanceCond

QWaitCondition AutoExpire::m_instanceCond

private

Definition at line 119 of file autoexpire.h.

Referenced by Sleep(), Update(), and ~AutoExpire().

◆ m_instanceLock

QMutex AutoExpire::m_instanceLock

mutableprivate

Definition at line 118 of file autoexpire.h.

Referenced by CalcParams(), GetAllExpiring(), GetDesiredSpace(), RunExpirer(), SetMainServer(), Sleep(), Update(), and ~AutoExpire().

◆ m_mainServer

MainServer* AutoExpire::m_mainServer {nullptr}

private

Definition at line 121 of file autoexpire.h.

Referenced by CalcParams(), ExpireRecordings(), and SetMainServer().

◆ m_updateLock

QMutex AutoExpire::m_updateLock

private

Definition at line 124 of file autoexpire.h.

Referenced by RunExpirer(), Update(), and ~AutoExpire().

◆ m_updateQueue

QQueue<UpdateEntry> AutoExpire::m_updateQueue

private

Definition at line 125 of file autoexpire.h.

Referenced by RunExpirer(), Update(), and ~AutoExpire().

◆ m_usedEncoders

QMap<int, int> AutoExpire::m_usedEncoders

private

Definition at line 116 of file autoexpire.h.

Referenced by CalcParams(), RunExpirer(), and Update().

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

mythtv/programs/mythbackend/autoexpire.h
mythtv/programs/mythbackend/autoexpire.cpp

Public Member Functions

Static Public Member Functions

Public Attributes

Protected Member Functions

Private Member Functions

Static Private Member Functions

Private Attributes

Friends

Detailed Description

Constructor & Destructor Documentation

◆ AutoExpire() [1/2]

◆ AutoExpire() [2/2]

◆ ~AutoExpire()

Member Function Documentation

◆ CalcParams()

◆ ClearExpireList()

◆ ExpireEpisodesOverMax()

◆ ExpireLiveTV()

◆ ExpireOldDeleted()

◆ ExpireQuickDeleted()

◆ ExpireRecordings()

◆ FillDBOrdered()

◆ FillExpireList()

◆ GetAllExpiring() [1/2]

◆ GetAllExpiring() [2/2]

◆ GetDesiredSpace()

◆ IsInDontExpireSet()

◆ IsInExpireList()

◆ PrintExpireList()

◆ RunExpirer()

◆ SendDeleteMessages()

◆ SetMainServer()

◆ Sleep()

◆ Update() [1/2]

◆ Update() [2/2]

◆ UpdateDontExpireSet()

Friends And Related Function Documentation

◆ ExpireThread

Member Data Documentation

◆ m_desiredFreq

◆ m_desiredSpace

◆ m_dontExpireSet

◆ m_encoderList

◆ m_expireThread

◆ m_expireThreadRun

◆ m_instanceCond

◆ m_instanceLock

◆ m_mainServer

◆ m_updateLock

◆ m_updateQueue

◆ m_usedEncoders