StderrChannel Class Reference

DebugChannel managing messages destined for "standard error stream" (stderr) More...

Inheritance diagram for StderrChannel:

Collaboration diagram for StderrChannel:

Public Types
using	EarlyMessages = std::unique_ptr< CompiledDebugMessages >

Public Member Functions
	StderrChannel ()
void	takeOver (CacheLogChannel &)
	start to take care of past/saved and future cacheLovirtual gChannel messages More...
void	stopCoveringForCacheLog ()
	stop providing a cache_log replacement (if we were providing it) More...
bool	enabled (const int messageDebugLevel) const
bool	collectingEarlyMessages () const
	whether we are still expecting (and buffering) early messages More...
void	stopEarlyMessageCollection ()
	end early message buffering, logging any saved messages More...
EarlyMessages	releaseEarlyMessages ()
void	log (const DebugMessageHeader &, const CompiledDebugMessageBody &)

Protected Member Functions
bool	shouldWrite (const DebugMessageHeader &) const final
void	write (const DebugMessageHeader &, const CompiledDebugMessageBody &) final
	write the corresponding debugs() message into the channel More...
void	saveMessage (const DebugMessageHeader &, const CompiledDebugMessageBody &)
	stores the given early message (if possible) or forgets it (otherwise) More...
void	writeToStream (FILE &, const DebugMessageHeader &, const CompiledDebugMessageBody &)
	Formats a validated debugs() record and writes it to the given FILE. More...
void	noteWritten (const DebugMessageHeader &)
	reacts to a written a debugs() message More...

Static Protected Member Functions
static void	StopSavingAndLog (DebugChannel &, DebugChannel *=nullptr)
	stop saving and log() any "early" messages, in recordNumber order More...

Protected Attributes
const char *const	name = nullptr
	unique channel label for debugging More...
DebugRecordCount	written = 0
	the number of messages sent to the underlying channel so far More...
DebugRecordCount	lastWrittenRecordNumber = 0
	DebugMessageHeader::recordNumber of the last message we wrote. More...
EarlyMessages	earlyMessages

Private Attributes
bool	coveringForCacheLog = false
	whether we are the last resort for logging debugs() messages More...

Detailed Description

Definition at line 250 of file debug.cc.

Member Typedef Documentation

EarlyMessages

using DebugChannel::EarlyMessages = std::unique_ptr<CompiledDebugMessages>

inherited

Definition at line 150 of file debug.cc.

Constructor & Destructor Documentation

StderrChannel()

StderrChannel::StderrChannel ( )

inline

Definition at line 253 of file debug.cc.

Member Function Documentation

collectingEarlyMessages()

bool DebugChannel::collectingEarlyMessages ( ) const

inlineinherited

Definition at line 159 of file debug.cc.

References DebugChannel::earlyMessages.

Referenced by DebugModule::prepareToDie().

enabled()

bool StderrChannel::enabled

(

const int

messageDebugLevel

)

const

whether we should write() the corresponding debugs() message now (assumes some higher-level code applied cache.log section/level filter)

Definition at line 646 of file debug.cc.

References coveringForCacheLog, DefaultStderrLevel, and ExplicitStderrLevel.

Referenced by shouldWrite(), and Debug::StderrEnabled().

log()

void DebugChannel::log ( const DebugMessageHeader &  header, const CompiledDebugMessageBody &  body  )

inherited

Write the message to the channel if the channel accepts (such) messages. This writing may be delayed until the channel configuration is settled.

Definition at line 536 of file debug.cc.

References DebugChannel::lastWrittenRecordNumber, DebugMessageHeader::recordNumber, DebugChannel::saveMessage(), DebugChannel::shouldWrite(), DebugChannel::stopEarlyMessageCollection(), and DebugChannel::write().

Referenced by DebugModule::log().

noteWritten()

void DebugChannel::noteWritten ( const DebugMessageHeader &  header )

protectedinherited

Definition at line 622 of file debug.cc.

References DebugChannel::lastWrittenRecordNumber, DebugMessageHeader::recordNumber, and DebugChannel::written.

Referenced by DebugChannel::writeToStream().

releaseEarlyMessages()

EarlyMessages DebugChannel::releaseEarlyMessages ( )

inlineinherited

end early message buffering, without logging any saved messages

Returns

(a possibly empty container with) saved messages or nil

Definition at line 166 of file debug.cc.

References DebugChannel::earlyMessages.

Referenced by DebugChannel::StopSavingAndLog().

saveMessage()

void DebugChannel::saveMessage ( const DebugMessageHeader &  header, const CompiledDebugMessageBody &  body  )

protectedinherited

Definition at line 593 of file debug.cc.

References assert, DebugChannel::earlyMessages, EarlyMessagesLevel, and DebugMessageHeader::level.

Referenced by DebugChannel::log().

shouldWrite()

bool StderrChannel::shouldWrite ( const DebugMessageHeader &  ) const

finalprotectedvirtual

whether we should write() the corresponding debugs() message now (assumes some higher-level code applied cache.log section/level filter)

Implements DebugChannel.

Definition at line 660 of file debug.cc.

References enabled(), and DebugMessageHeader::level.

stopCoveringForCacheLog()

void StderrChannel::stopCoveringForCacheLog

(

)

Definition at line 682 of file debug.cc.

References coveringForCacheLog, DBG_IMPORTANT, and debugs.

Referenced by DebugModule::useCacheLog().

stopEarlyMessageCollection()

void DebugChannel::stopEarlyMessageCollection ( )

inherited

Definition at line 528 of file debug.cc.

References DebugChannel::earlyMessages, and DebugChannel::StopSavingAndLog().

Referenced by DebugChannel::log(), DebugModule::prepareToDie(), Debug::SettleStderr(), Debug::SettleSyslog(), Debug::StopCacheLogUse(), and DebugModule::useCacheLog().

StopSavingAndLog()

void DebugChannel::StopSavingAndLog ( DebugChannel &  channelA, DebugChannel *  channelBOrNil = nullptr  )

staticprotectedinherited

Definition at line 568 of file debug.cc.

References assert, debugs, CompiledDebugMessage::header, DebugChannel::name, DebugMessageHeader::recordNumber, DebugChannel::releaseEarlyMessages(), and DebugChannel::written.

Referenced by DebugChannel::stopEarlyMessageCollection(), and takeOver().

takeOver()

void StderrChannel::takeOver

(

CacheLogChannel &

cacheLogChannel

)

Definition at line 672 of file debug.cc.

References coveringForCacheLog, and DebugChannel::StopSavingAndLog().

Referenced by DebugModule::banCacheLogUse().

write()

void StderrChannel::write ( const DebugMessageHeader &  , const CompiledDebugMessageBody &    )

finalprotectedvirtual

Implements DebugChannel.

Definition at line 666 of file debug.cc.

References DebugChannel::writeToStream().

writeToStream()

void DebugChannel::writeToStream ( FILE &  destination, const DebugMessageHeader &  header, const CompiledDebugMessageBody &  body  )

protectedinherited

Definition at line 612 of file debug.cc.

References debugLogTime(), DebugChannel::noteWritten(), ProcessLabel, and DebugMessageHeader::timestamp.

Referenced by CacheLogChannel::write(), and write().

Member Data Documentation

coveringForCacheLog

bool StderrChannel::coveringForCacheLog = false

private

Definition at line 271 of file debug.cc.

Referenced by enabled(), stopCoveringForCacheLog(), and takeOver().

earlyMessages

EarlyMessages DebugChannel::earlyMessages

protectedinherited

debugs() messages waiting for the channel configuration to settle (and the channel to open) so that their eligibility for logging can be determined (and the messages can be actually written somewhere)

Definition at line 234 of file debug.cc.

Referenced by DebugChannel::collectingEarlyMessages(), DebugChannel::releaseEarlyMessages(), DebugChannel::saveMessage(), and DebugChannel::stopEarlyMessageCollection().

lastWrittenRecordNumber

DebugRecordCount DebugChannel::lastWrittenRecordNumber = 0

protectedinherited

Definition at line 229 of file debug.cc.

Referenced by DebugChannel::log(), and DebugChannel::noteWritten().

name

const char* const DebugChannel::name = nullptr

protectedinherited

Definition at line 223 of file debug.cc.

Referenced by DebugChannel::StopSavingAndLog().

written

DebugRecordCount DebugChannel::written = 0

protectedinherited

Definition at line 226 of file debug.cc.

Referenced by DebugChannel::noteWritten(), and DebugChannel::StopSavingAndLog().

---

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

• src/debug/debug.cc