#include "base/Here.h"
#include "mem/AllocatorProxy.h"
#include <iostream>
#include <sstream>
#include <iomanip>

Include dependency graph for Debug.h:

Classes
class	Debug

class	Debug::Context
	meta-information for debugs() or a similar debugging call More...

class	Raw

class	RawPointerT< Pointer >
	debugs objects pointed by possibly nil pointers: label=object More...

class	AsHex< Integer >
	std::ostream manipulator to print integers as hex numbers prefixed by 0x More...

Macros
#define	assert(EX) ((EX)?((void)0):xassert("EX", __FILE__, __LINE__))

#define	MAX_DEBUG_SECTIONS 100

#define	DBG_CRITICAL 0

#define	DBG_IMPORTANT 1

#define	DBG_DATA 9

#define	DBG_PARSE_NOTE(x) (opt_parse_cfg_only?0:(x))

#define	debug_log DebugStream()
	change-avoidance macro; new code should call DebugStream() instead More...

#define	debugs(SECTION, LEVEL, CONTENT)

#define	MYNAME __FUNCTION__ << " "

Typedefs
typedef int	Ctx

Functions
Ctx	ctx_enter (const char *descr)

void	ctx_exit (Ctx ctx)

FILE *	DebugStream ()

void	StopUsingDebugLog ()
	start logging to stderr (instead of cache.log, if any) More...

void	ResyncDebugLog (FILE *newDestination)
	a hack for low-level file descriptor manipulations in ipcCreate() More...

std::ostream &	ForceAlert (std::ostream &s)

std::ostream &	HERE (std::ostream &s)

std::ostream &	operator<< (std::ostream &os, const uint8_t d)

void	_db_init (const char logfile, const char options)

void	_db_set_syslog (const char *facility)

void	_db_rotate_log (void)

std::ostream &	operator<< (std::ostream &os, const Raw &raw)

template<class Pointer >
RawPointerT< Pointer >	RawPointer (const char *label, const Pointer &ptr)
	convenience wrapper for creating RawPointerT<> objects More...

template<class Pointer >
std::ostream &	operator<< (std::ostream &os, const RawPointerT< Pointer > &pd)
	prints RawPointerT<>, dereferencing the raw pointer if possible More...

template<class Integer >
std::ostream &	operator<< (std::ostream &os, const AsHex< Integer > number)

template<class Integer >
AsHex< Integer >	asHex (const Integer n)
	a helper to ease AsHex object creation More...

Macro Definition Documentation

◆ assert

#define assert ( EX ) ((EX)?((void)0):xassert("EX", __FILE__, __LINE__))

Definition at line 33 of file Debug.h.

◆ DBG_CRITICAL

#define DBG_CRITICAL 0

critical messages always shown when they occur

Definition at line 45 of file Debug.h.

Referenced by aclDomainCompare(), aclParseAccessLine(), aclParseArpData(), aclParseDenyInfoLine(), aclParseEuiData(), MessageDelayPools::add(), esiSequence::addElement(), esiChoose::addElement(), Ftp::Gateway::appendSuccessHeader(), CpuAffinityMap::calculateSet(), Ipc::Inquirer::callException(), Ipc::Forwarder::callException(), Log::TcpLogger::canFit(), checkFailureRatio(), HttpHeader::clean(), ClientRequestContext::clientAccessCheck(), clientdbCutoffDenied(), clientFollowXForwardedForCheck(), clientHttpConnectionsOpen(), ClientRequestContext::clientRedirectDone(), DiskThreadsDiskFile::close(), IcmpSquid::Close(), comm_open_uds(), comm_openex(), comm_poll_tcp_incoming(), comm_reset_close(), comm_set_transparent(), comm_set_v6only(), commBind(), commSetCloseOnExec(), commSetNoLinger(), commSetNonBlocking(), commUnsetNonBlocking(), acl_httpstatus_data::compare(), ErrorState::compileLegacyCode(), compileRE(), compileUnoptimisedREs(), configDoConfigure(), constructHelperQuery(), Store::Disks::create(), Security::ServerOptions::createBlankContext(), MimeIcon::created(), Rock::SwapDir::createError(), createRemovalPolicy_heap(), Security::ServerOptions::createSigningContexts(), Security::ServerOptions::createStaticServerContext(), ctx_enter(), death(), debug_trap(), Eui::Eui48::decode(), acl_ip_data::DecodeMask(), Fs::Ufs::UFSSwapDir::DirClean(), IpcIoFile::DiskerHandleRequest(), DiskerOpen(), StoreMetaUnpacker::doOneEntry(), Fs::Ufs::UFSSwapDir::doubleCheck(), Mgr::ShutdownAction::dump(), dump_wccp2_amethod(), dump_wccp2_method(), Fs::Ufs::UFSSwapDir::dumpEntry(), Enqueue(), ErrorDynamicPageInfo::ErrorDynamicPageInfo(), examine_select(), StoreMeta::Factory(), acl_ip_data::FactoryParse(), Rock::Rebuild::failure(), fatal_common(), fdAdjustReserved(), Adaptation::AccessRule::finalize(), Adaptation::ServiceGroup::finalize(), Adaptation::Config::finalize(), sslBumpCfgRr::finalizeConfig(), Adaptation::ServiceGroup::finalizeMsg(), getMyHostname(), getMyPort(), GetPercentage(), Ip::Address::getReverseString(), Ip::Address::getSockAddr(), Adaptation::ServiceConfig::grokBool(), Adaptation::ServiceConfig::grokExtension(), Adaptation::ServiceConfig::grokLong(), Adaptation::ServiceConfig::grokOnOverload(), Adaptation::ServiceConfig::grokUri(), Mgr::Forwarder::handleError(), Adaptation::Ecap::ServiceRep::handleFinalizeFailure(), helper::handleKilledServer(), icp_common_t::handleReply(), helperDispatchWriteDone(), helperStatefulOpenServers(), htcpIncomingConnectionOpened(), htcpOpenPorts(), icpHandleIcpV2(), icpHandleIcpV3(), icpOpenPorts(), idnsAddNameserver(), Ipc::ImportFdIntoComm(), SharedMemory::init(), Ident::Init(), DiskdIOStrategy::init(), Rock::SwapDir::init(), ipc_thread_1(), ipcacheRelease(), ipcacheStatPrint(), ipcCreate(), ipcSend(), Ip::Intercept::IpfInterception(), leave_suid(), Acl::InnerNode::lineParse(), Ftp::Gateway::listenForDataChannel(), Ftp::Server::listenForDataConnection(), Security::ServerOptions::loadClientCaFile(), TemplateFile::loadDefault(), TemplateFile::loadFromFile(), logfile_mod_stdio_rotate(), Eui::Eui48::lookup(), Eui::Eui64::lookupNdp(), main(), mainChangeDir(), mainHandleCommandLineOption(), mainInitialize(), mainReconfigureFinish(), mainSetCwd(), Store::Controller::maintain(), Acl::Make(), mcastJoinGroups(), neighborsUdpAck(), neighborsUdpPing(), netdbDump(), acl_ip_data::NetworkCompare(), ConfigParser::NextKvPair(), ConfigParser::NextToken(), ACLChecklist::nonBlockingCheck(), ErrorState::noteBuildError_(), Comm::TcpAcceptor::okToAccept(), old_comm_reset_close(), OnTerminate(), IcmpPinger::Open(), Icmp6::Open(), Icmp4::Open(), DiskThreadsDiskFile::openDone(), Fs::Ufs::UFSStoreState::openDone(), Fs::Ufs::UFSSwapDir::openTmpSwapLog(), Snmp::Var::operator+=(), Snmp::Var::operator/=(), Snmp::Var::operator<(), Snmp::Var::operator>(), DelaySpec::parse(), ACLAdaptationServiceData::parse(), ACLRegexData::parse(), ACLSquidErrorData::parse(), ACLTimeData::parse(), ACLHasComponentData::parse(), ACLHTTPHeaderData::parse(), ACLIntRange::parse(), ACLRandom::parse(), ACLAnnotationData::parse(), ACLMaxConnection::parse(), Adaptation::ServiceConfig::parse(), Acl::ConnectionsEncrypted::parse(), ACLAtStepData::parse(), ACLCertificateData::parse(), Security::PeerOptions::parse(), Security::ServerOptions::parse(), Format::Token::parse(), AnyP::Uri::parse(), Auth::SchemeConfig::parse(), parse_access_log(), parse_address(), parse_authparam(), parse_AuthSchemes(), parse_cachedir(), parse_CpuAffinityMap(), parse_externalAclHelper(), parse_ftp_epsv(), parse_hostdomaintype(), parse_http_header_access(), parse_http_header_replace(), parse_icap_access_type(), parse_icap_class_type(), parse_icap_service_failure_limit(), parse_obsolete(), parse_on_unsupported_protocol(), parse_peer(), parse_peer_access(), parse_port_option(), parse_refreshpattern(), parse_sslproxy_cert_adapt(), parse_sslproxy_cert_sign(), parse_sslproxy_ssl_bump(), parse_UrlHelperTimeout(), parse_wccp2_amethod(), parse_wccp2_method(), parse_wccp2_service(), parse_wccp2_service_info(), ACL::ParseAclLine(), parseBytesLine(), parseBytesLine64(), parseBytesLineSigned(), parseBytesUnits(), ACLHasComponentData::parseComponent(), Helper::ChildConfig::parseConfig(), parseConfigFile(), Ip::Qos::Config::parseConfigLine(), Log::LogConfig::parseFormats(), XactionInitiator::ParseInitiators(), Notes::parseKvPair(), parseNeighborType(), ESIContext::parseOneBuffer(), parseOneConfigFile(), DelayConfig::parsePoolAccess(), DelayConfig::parsePoolClass(), ClientDelayConfig::parsePoolCount(), ClientDelayConfig::parsePoolId(), DelayConfig::parsePoolRates(), parsePortCfg(), parsePortSpecification(), Rock::SwapDir::parseRateOption(), ESIContext::parserComment(), MessageDelayConfig::parseResponseDelayPool(), MessageDelayConfig::parseResponseDelayPoolAccess(), Rock::SwapDir::parseSizeOption(), parseTimeLine(), Rock::SwapDir::parseTimeOption(), Fs::Ufs::UFSSwapDir::pathIsDirectory(), peerDigestSetCBlock(), peerDigestUseful(), peerDNSConfigure(), DelayPools::pools(), ACLMaxConnection::prepareForUse(), Ip::Intercept::ProbeForTproxy(), esiTry::process(), ESIContext::process(), clientReplyContext::processExpired(), clientReplyContext::processMiss(), store_client::readBody(), IcmpPinger::Recv(), Icmp6::Recv(), Icmp4::Recv(), redirectHandleReply(), ConfigParser::RegexPattern(), ConfigParser::RegexStrtokFile(), Format::FmtConfig::registerTokens(), StoreEntry::replaceHttpReply(), requirePathnameExists(), EventLoop::runOnce(), PeerSelector::selectSomeNeighbor(), Snmp::SendResponse(), IcmpPinger::SendResult(), setEffectiveUser(), Comm::TcpAcceptor::setListen(), setLogformat(), setMaxFD(), Security::SetSessionResumeData(), setSystemLimits(), sigusr2_handle(), snmpOpenPorts(), squid_signal(), squidaio_do_close(), squidaio_queue_request(), SquidLogLevel(), SquidMain(), SquidMainSafe(), ESIInclude::Start(), ConfigParser::CfgFile::startParse(), statAvgTick(), StatefulEnqueue(), Adaptation::Iterator::step(), ConfigParser::strtokFile(), statefulhelper::submit(), SupportedVersion(), StoreEntry::swapOut(), ConfigParser::TokenParse(), Ip::Address::toStr(), mem_hdr::unlink(), ConfigParser::UnQuote(), Security::ServerOptions::updateContextClientCa(), Security::ServerOptions::updateContextConfig(), Security::ServerOptions::updateContextEecdh(), ACLServerNameStrategy::valid(), ACLProxyAuth::valid(), ACLExternal::valid(), Notes::validateKey(), Rock::SwapDir::validateOptions(), StoreMeta::validLength(), StoreMeta::validType(), wccp2ConnectionOpen(), wccpConnectionOpen(), mem_hdr::write(), UFSCleanLog::write(), Fs::Ufs::UFSSwapDir::writeCleanDone(), BlockingFile::writeDone(), xassert(), and helper::~helper().

◆ DBG_DATA

#define DBG_DATA 9

output is a large data dump only necessary for advanced debugging

Definition at line 48 of file Debug.h.

Referenced by comm_connect_addr(), Http::One::RequestParser::doParse(), ForceAlert(), helperHandleRead(), helperStatefulHandleRead(), HttpStateData::maybeMakeSpaceAvailable(), ErrorState::noteBuildError_(), Http::One::ResponseParser::parse(), Http::One::TeChunkedParser::parse(), Http::One::RequestParser::parseRequestFirstLine(), Adaptation::Icap::OptXact::parseResponse(), Http::One::ResponseParser::parseResponseFirstLine(), Http::One::ResponseParser::parseResponseStatusAndReason(), Raw::print(), SBufToCstring(), SquidLogLevel(), helper::submit(), statefulhelper::submit(), Parser::Tokenizer::token(), and tunnelStartShoveling().

◆ DBG_IMPORTANT

#define DBG_IMPORTANT 1

important messages always shown when their section is being checked

Definition at line 46 of file Debug.h.

Referenced by _comm_close(), _db_rotate_log(), StoreEntry::abort(), accessLogInit(), aclDomainCompare(), aclMatchExternal(), esiTry::addElement(), ipcache_entry::addGood(), ESIContext::addLiteral(), addmember(), ESIContext::addStackElement(), aioCancel(), CpuAffinitySet::apply(), asHandleReply(), authDigestNonceUnlink(), Auth::UserRequest::authenticate(), AuthenticateAcl(), authenticateBasicStats(), Adaptation::Icap::ServiceRep::availableConnections(), AvoidSignalAction(), CollapsedForwarding::Broadcast(), clientReplyContext::buildReplyHeader(), clientReplyContext::cacheHit(), DiskdIOStrategy::callback(), ClientHttpRequest::callException(), Log::TcpLogger::canFit(), Ssl::chainCertificatesToSSLContext(), PeerSelector::checkAlwaysDirectDone(), StoreMetaURL::checkConsistency(), StoreMetaMD5::checkConsistency(), StoreMeta::checkConsistency(), StoreEntry::checkDisk(), PeerSelector::checkNeverDirectDone(), Adaptation::Icap::ServiceRep::checkOptions(), IpcIoFile::checkTimeouts(), Adaptation::Ecap::CheckUnusedAdapterServices(), Http::ContentLengthInterpreter::checkValue(), clientConnectionsClose(), clientdbGetInfo(), clientHttpConnectionsOpen(), clientHttpRequestStatus(), clientIfRangeMatch(), clientInterpretRequestHeaders(), clientLifetimeTimeout(), clientListenerConnectionOpened(), ClientRequestContext::clientRedirectDone(), ClientRequestContext::clientStoreIdDone(), IcmpSquid::Close(), DiskdFile::close(), File::close(), HelperServerBase::closePipesSafely(), Fs::Ufs::UFSSwapDir::closeTmpSwapLog(), HelperServerBase::closeWritePipeSafely(), comm_apply_flags(), comm_check_incoming_poll_handlers(), comm_check_incoming_select_handlers(), comm_local_port(), comm_open_uds(), comm_openex(), comm_set_transparent(), comm_set_v6only(), comm_udp_sendto(), commSetCloseOnExec(), commSetReuseAddr(), commSetTcpKeepalive(), commSetTcpRcvbuf(), compileOptimisedREs(), FwdState::completed(), configDoConfigure(), Adaptation::Icap::Options::configure(), Log::TcpLogger::connectDone(), FwdState::connectStart(), HttpStateData::continueAfterParsingHeader(), mem_hdr::copy(), MemStore::copyFromShmSlice(), CpuAffinityCheck(), DiskdFile::create(), Rock::SwapDir::create(), Auth::SchemeConfig::CreateAuthUser(), Fs::Ufs::UFSSwapDir::createDirectory(), createRemovalPolicy(), createRemovalPolicy_heap(), CreateSession(), Security::ServerOptions::createSigningContexts(), Security::ServerOptions::createStaticServerContext(), Fs::Ufs::UFSSwapDir::createSwapSubDirs(), Ftp::Client::dataRead(), DelayId::DelayClient(), IpcIoFile::DiskerHandleRequest(), diskerWriteAttempts(), Store::Disk::diskFull(), Rock::SwapDir::diskFull(), diskHandleRead(), diskHandleWrite(), FwdState::dispatch(), Adaptation::Icap::Xaction::dnsLookupDone(), StoreEntry::doAbandon(), SignalEngine::doShutdown(), Fs::Ufs::UFSStoreState::doWrite(), mem_hdr::dump(), MemObject::dump(), LeakFinder::dump(), Mgr::ReconfigureAction::dump(), Mgr::RotateAction::dump(), Mgr::OfflineToggleAction::dump(), Http::One::ErrorLevel(), esiBufferRecipient(), ESIInclude::ESIInclude(), esiWhen::esiWhen(), evalexpr(), evalliteral(), ESIExpression::Evaluate(), Adaptation::Icap::ModXact::expectIcapTrailers(), acl_ip_data::FactoryParse(), fd_open(), fdDumpOpen(), Ipc::FdNote(), FileRename(), Adaptation::Config::Finalize(), Adaptation::Ecap::ServiceRep::finalize(), Adaptation::ServiceGroup::finalize(), ClientDelayConfig::finalize(), Adaptation::Icap::ServiceRep::finalize(), MemStoreRr::finalizeConfig(), Adaptation::ServiceGroup::finalizeMsg(), fqdncacheAddEntryFromHosts(), fqdncacheParse(), fsBlockSize(), fsStats(), Ftp::Gateway::ftpAcceptDataConnection(), ftpReadPORT(), ftpReadTransferDone(), ftpReadWelcome(), ftpSendPORT(), ftpWriteTransferDone(), GetAvgStat(), Ip::Address::getInAddr(), GetInteger(), getMyHostname(), Fs::Ufs::RebuildState::getNextFile(), ConnStateData::getSslContextDone(), ConnStateData::getSslContextStart(), GetStrPool(), getsymbol(), Ip::Qos::getTosFromServer(), Fs::Ufs::UFSSwapLogParser::GetUFSSwapLogParser(), gopherReadReply(), gopherToHTML(), Ipc::Coordinator::handleCacheMgrRequest(), Ftp::Client::handleEpsvReply(), Adaptation::Ecap::ServiceRep::handleFinalizeFailure(), PeerSelector::handleHtcpParentMiss(), ConnStateData::handleIdleClientPinnedTlsRead(), helper::handleKilledServer(), HttpStateData::handleMoreRequestBodyAvailable(), Security::PeerConnector::handleNegotiateError(), CollapsedForwarding::HandleNewData(), Ftp::Client::handlePasvReply(), Ftp::Gateway::haveControlChannel(), helperDispatch(), helperHandleRead(), helperOpenServers(), helperReturnBuffer(), helper_server::HelperServerClosed(), helper_stateful_server::HelperServerClosed(), helperStatefulDispatch(), helperStatefulHandleRead(), helperStatefulOpenServers(), ClientRequestContext::hostHeaderVerifyFailed(), htcpClosePorts(), htcpIncomingConnectionOpened(), htcpOpenPorts(), htcpSocketShutdown(), HttpStateData::httpBuildRequestHeader(), httpsCreate(), icpClosePorts(), icpConnectionShutdown(), icpHandleUdp(), icpIncomingConnectionOpened(), idnsAddNameserver(), idnsALookup(), idnsGrokReply(), idnsInitVCConnected(), idnsParseNameservers(), idnsParseResolvConf(), idnsQueryID(), idnsRead(), idnsSendQuery(), idnsSendQueryVC(), Auth::Init(), DiskDaemonDiskIOModule::init(), Dns::Init(), Store::Disks::init(), MemStore::init(), Ssl::InitClientContext(), Security::PeerConnector::initialize(), ipcache_init(), ipcacheAddEntryFromHosts(), ipcacheHandleReply(), ipcacheUnlockEntry(), ipcCreate(), Ip::Intercept::IpfInterception(), issuerExistInCaDb(), HttpStateData::keepaliveAccounting(), ConnStateData::kick(), kq_update_events(), LoadableModulesConfigure(), Ssl::loadCerts(), Security::ServerOptions::loadDhParams(), TemplateFile::loadFor(), Security::KeyData::loadFromFiles(), LoadModule(), Rock::Rebuild::loadOneSlot(), Security::KeyData::loadX509CertFromFile(), Security::KeyData::loadX509ChainFromFile(), Security::KeyData::loadX509PrivateKeyFromFile(), logfile_mod_daemon_close(), logfile_mod_daemon_flush(), logfile_mod_daemon_open(), logfile_mod_daemon_rotate(), logfile_mod_daemon_writeline(), logfile_mod_stdio_open(), logfile_mod_stdio_rotate(), logfile_mod_udp_open(), logfile_mod_udp_write(), logfileClose(), logfileHandleWrite(), logfileOpen(), logfileRotate(), Ip::Intercept::Lookup(), Eui::Eui48::lookup(), Comm::ConnOpener::lookupLocalAddress(), main(), mainInitialize(), mainReconfigureStart(), mainSetCwd(), Fs::Ufs::UFSSwapDir::maintain(), Acl::ConnectionsEncrypted::match(), ACLMaxUserIP::match(), ACLIdent::match(), ACL::matches(), mcastJoinGroups(), mcastSetTtl(), membercompare(), memConfigure(), mimeInit(), Ipc::Mem::Segment::Name(), neighborIgnoreNonPeer(), neighbors_init(), neighborsHtcpReply(), neighborsUdpAck(), neighborsUdpPing(), netdbExchangeHandleReply(), netdbExchangeStart(), netdbReloadState(), netdbSaveState(), netdbSendPing(), Ip::Intercept::NetfilterInterception(), no_suid(), Adaptation::Icap::ServiceRep::noteAdaptationAnswer(), Security::PeerConnector::noteNegotiationError(), Security::PeerConnector::noteWantRead(), Comm::TcpAcceptor::oldAccept(), IcmpPinger::Open(), IcmpSquid::Open(), Log::TcpLogger::Open(), Icmp6::Open(), Icmp4::Open(), IpcIoFile::openCompleted(), DiskThreadsDiskFile::openDone(), Fs::Ufs::UFSSwapDir::openLog(), Fs::Ufs::UFSSwapDir::openTmpSwapLog(), Store::Disk::optionObjectSizeParse(), DiskdIOStrategy::optionQ1Parse(), DiskdIOStrategy::optionQ2Parse(), ACLRegexData::parse(), ACLRandom::parse(), ACLMaxUserIP::parse(), ACLProtocolData::parse(), Adaptation::ServiceConfig::parse(), Ssl::ErrorDetailFile::parse(), Security::ServerOptions::parse(), Format::Token::parse(), Format::Format::parse(), HttpHeaderEntry::parse(), AnyP::Uri::parse(), HttpHeader::parse(), Http::Message::parse(), Auth::SchemeConfig::parse(), parse_acl_tos(), parse_cachedir(), parse_externalAclHelper(), parse_onoff(), parse_peer(), parse_pipelinePrefetch(), parse_port_option(), parse_refreshpattern(), parse_tristate(), parse_wccp2_service(), parse_wccp2_service_info(), ACL::ParseAclLine(), Helper::ChildConfig::parseConfig(), Ip::Qos::Config::parseConfigLine(), parseEtcHosts(), HttpRequest::parseFirstLine(), Log::LogConfig::parseFormats(), CacheManager::ParseHeaders(), parseHttpRequest(), parseOneConfigFile(), Store::Disk::parseOptions(), Rock::SwapDir::parseRateOption(), Ssl::CertValidationMsg::parseResponse(), Rock::SwapDir::parseSize(), Fs::Ufs::UFSSwapDir::parseSizeL1L2(), Rock::SwapDir::parseSizeOption(), Rock::SwapDir::parseTimeOption(), parseTimeUnits(), CacheManager::ParseUrl(), peerAlive(), peerConnectFailed(), peerConnectFailedSilent(), peerCountMcastPeersDone(), peerDigestPDFinish(), peerDigestSetCBlock(), peerDigestSwapInHeaders(), peerDNSConfigure(), Ip::Intercept::PfInterception(), helper::prepSubmit(), ConnStateData::proxyProtocolError(), IpcIoFile::push(), DiskdFile::read(), IpcIoFile::readCompleted(), Ftp::Client::readControlReply(), DiskdFile::readDone(), Ftp::Relay::readGreeting(), Ftp::Gateway::readStor(), Ftp::Relay::readTransferDoneReply(), Fs::Ufs::RebuildState::rebuildFromDirectory(), Fs::Ufs::RebuildState::rebuildFromSwapLog(), Fs::Ufs::RebuildState::RebuildState(), Ipc::Strand::receive(), Ipc::Coordinator::receive(), IcmpPinger::Recv(), IcmpSquid::Recv(), redirectHandleReply(), BandwidthBucket::reduceBucket(), RemoveInstance(), removeUnnecessaryWildcards(), safeunlink(), Adaptation::Icap::ServiceRep::scheduleUpdate(), DiskdIOStrategy::SEND(), send_announce(), IcmpSquid::SendEcho(), Icmp6::SendEcho(), Icmp4::SendEcho(), Ftp::Client::sendPassive(), Client::sentRequestBody(), Comm::TcpAcceptor::setListen(), StoreEntry::setPublicKey(), Ip::Qos::setSockNfmark(), Ip::Qos::setSockTos(), setSystemLimits(), showDebugWarning(), Http::One::RequestParser::skipGarbageLines(), snmpClosePorts(), snmpDecodePacket(), snmpHandleUdp(), snmpOpenPorts(), snmpPortOpened(), squidaio_queue_request(), SquidLogLevel(), SquidShutdown(), ssl_ask_password(), ssl_get_attribute(), ssl_verify_cb(), ConnStateData::sslCrtdHandleReply(), sslCrtvdHandleReplyWrapper(), Security::PeerConnector::sslFinalized(), Rock::Rebuild::start(), CacheManager::start(), ESIInclude::start(), ConnStateData::start(), Ftp::StartListening(), store_client::startSwapin(), statByteHitRatio(), Ssl::ClientBio::stateChanged(), Mem::Stats(), Adaptation::Icap::History::stop(), Ip::Intercept::StopInterception(), Ftp::StopListening(), Ip::Intercept::StopTransparency(), storeCleanup(), StoreEntry::storeClientType(), storeDigestCalcCap(), storeDigestInit(), storeDigestRebuildStart(), storeDigestRewriteStart(), storeDirWriteCleanLogs(), MemObject::storeId(), storeLateRelease(), storeLogOpen(), storeRebuildComplete(), storeRebuildLoadEntry(), storeRebuildParseEntry(), storeRebuildProgress(), storeReplAdd(), storeSwapInStart(), Adaptation::Icap::ServiceRep::suspend(), Http::Tunneler::swanSong(), Security::PeerConnector::swanSong(), DiskdIOStrategy::sync(), helper::syncQueueStats(), Log::TcpLogger::TcpLogger(), Ftp::Gateway::timeout(), tlsAttemptHandshake(), Adaptation::Ecap::ServiceRep::tryConfigureAndStart(), FwdState::tunnelEstablishmentDone(), CpuAffinitySet::undo(), unlinkdClose(), unlinkdInit(), unlinkdUnlink(), DiskdIOStrategy::unlinkFile(), store_client::unpackHeader(), Security::PeerOptions::updateContextCa(), Security::PeerOptions::updateContextTrust(), Security::PeerOptions::updateSessionOptions(), urnFindMinRtt(), urnHandleReply(), varyEvaluateMatch(), IpcIoFile::WaitBeforePop(), wccp2_check_security(), wccp2ConnectionClose(), wccp2ConnectionOpen(), wccp2HandleUdp(), wccp2HereIam(), wccpConnectionClose(), wccpConnectionOpen(), wccpHandleUdp(), WIN32_IpAddrChangeMonitor(), WIN32_IpAddrChangeMonitorInit(), WIN32_svcHandler(), MmappedFile::write(), Comm::Write(), DiskdFile::write(), Fs::Ufs::UFSStoreState::write(), Ftp::Client::writeCommandCallback(), IpcIoFile::writeCompleted(), DiskdFile::writeDone(), Instance::WriteOurPid(), xatof(), xatoi(), xatol(), xatoll(), xatos(), xatoui(), ConnStateData::~ConnStateData(), Ftp::Gateway::~Gateway(), and PeerSelector::~PeerSelector().

◆ DBG_PARSE_NOTE

#define DBG_PARSE_NOTE ( x ) (opt_parse_cfg_only?0:(x))

output is always to be displayed on '-k parse' but at level-x normally.

Definition at line 50 of file Debug.h.

Referenced by configDoConfigure(), Store::Disks::create(), GetInteger(), Security::KeyData::loadX509ChainFromFile(), Store::Disk::maxObjectSize(), Store::Disk::optionReadOnlyParse(), ACLRandom::parse(), ACLUserData::parse(), Adaptation::ServiceConfig::parse(), Security::PeerOptions::parse(), Security::ServerOptions::parse(), Format::Token::parse(), Auth::SchemeConfig::parse(), parse_acl_tos(), parse_cachedir(), parse_cachemgrpasswd(), parse_externalAclHelper(), parse_memcachemode(), parse_onoff(), parse_peer(), parse_pipelinePrefetch(), parse_port_option(), parse_refreshpattern(), parse_tristate(), parse_uri_whitespace(), ACL::ParseAclLine(), Helper::ChildConfig::parseConfig(), Security::PeerOptions::parseFlags(), Log::LogConfig::parseFormats(), Security::PeerOptions::parseOptions(), Security::PeerOptions::updateTlsVersionLimits(), xatof(), xatoi(), xatol(), xatoll(), xatos(), and xatoui().

◆ debug_log

#define debug_log DebugStream()

Definition at line 110 of file Debug.h.

Referenced by _db_print(), _db_print_file(), _db_print_stderr(), clientNegotiateSSL(), death(), dumpMallocStats(), fdDumpOpen(), ipc_thread_1(), ipcCreate(), logsFlush(), PrintRusage(), and ssl_ask_password().

◆ debugs

#define debugs	(	SECTION,
		LEVEL,
		CONTENT
	)

Value:

do { \
        const int _dbg_level = (LEVEL); \
        if (Debug::Enabled((SECTION), _dbg_level)) { \
            std::ostream &_dbo = Debug::Start((SECTION), _dbg_level); \
            if (_dbg_level > DBG_IMPORTANT) { \
                _dbo << (SECTION) << ',' << _dbg_level << "| " \
                     << Here() << ": "; \
            } \
            _dbo << CONTENT; \
            Debug::Finish(); \
        } \
   } while (/*CONSTCOND*/ 0)

Definition at line 124 of file Debug.h.

◆ MAX_DEBUG_SECTIONS

#define MAX_DEBUG_SECTIONS 100

Definition at line 42 of file Debug.h.

Referenced by debugArg(), and Debug::parseOptions().

◆ MYNAME

#define MYNAME __FUNCTION__ << " "

Definition at line 166 of file Debug.h.

Referenced by comm_local_port(), comm_open_uds(), comm_openex(), comm_poll_tcp_incoming(), comm_set_transparent(), comm_set_v6only(), comm_udp_sendto(), commBind(), commSetCloseOnExec(), commSetNoLinger(), commSetNonBlocking(), commSetReuseAddr(), commSetTcpKeepalive(), commSetTcpRcvbuf(), commUnsetNonBlocking(), Fs::Ufs::UFSSwapDir::DirClean(), downloaderDetach(), downloaderRecipient(), Fs::Ufs::UFSStoreState::doWrite(), Fs::Ufs::RebuildState::getNextFile(), gopherReadReply(), idnsRead(), idnsSendQuery(), SharedMemory::init(), DiskdIOStrategy::init(), ConnStateData::kick(), TemplateFile::loadFromFile(), logfile_mod_stdio_open(), logfile_mod_stdio_rotate(), netdbExchangeStart(), netdbSaveState(), Comm::TcpAcceptor::oldAccept(), IcmpPinger::Open(), Icmp6::Open(), Icmp4::Open(), DiskThreadsDiskFile::openDone(), AnyP::Uri::parse(), Ip::Intercept::PfInterception(), Fs::Ufs::RebuildState::rebuildFromDirectory(), IcmpSquid::Recv(), DiskdIOStrategy::SEND(), IcmpSquid::SendEcho(), Icmp6::SendEcho(), Icmp4::SendEcho(), StoreMeta::validLength(), UFSCleanLog::write(), and Fs::Ufs::UFSSwapDir::writeCleanDone().

Typedef Documentation

◆ Ctx

typedef int Ctx

Definition at line 37 of file Debug.h.

Function Documentation

◆ _db_init()

void _db_init	(	const char *	logfile,
		const char *	options
	)

Definition at line 484 of file debug.cc.

References APP_SHORTNAME, debugOpenLog(), Debug::log_syslog, and Debug::parseOptions().

Referenced by main(), mainInitialize(), mainReconfigureFinish(), IcmpPinger::Open(), operator<<(), and parseConfigFileOrThrow().

◆ _db_rotate_log()

void _db_rotate_log ( void )

Definition at line 502 of file debug.cc.

References _db_print_stderr(), Debug::cache_log, DebugFile::clear(), DBG_IMPORTANT, debugOpenLog(), debugs, i, MAXPATHLEN, DebugFile::name, Debug::rotateNumber, and xstrerr().

Referenced by mainRotate(), and operator<<().

◆ _db_set_syslog()

void _db_set_syslog ( const char * facility )

Definition at line 55 of file stub_debug.cc.

Referenced by debugOpenLog(), mainHandleCommandLineOption(), and operator<<().

◆ asHex()

template<class Integer >

AsHex<Integer> asHex ( const Integer n )

inline

Definition at line 278 of file Debug.h.

Referenced by Ip::Qos::getTosFromServer(), Acl::ConnMark::match(), and operator<<().

◆ ctx_enter()

Ctx ctx_enter ( const char * descr )

Definition at line 715 of file debug.cc.

References Ctx_Current_Level, Ctx_Descrs, CTX_MAX_LEVEL, Ctx_Warn_Level, DBG_CRITICAL, and debugs.

Referenced by HttpStateData::haveParsedReplyHeaders(), HttpStateData::processReplyHeader(), and MemObject::~MemObject().

◆ ctx_exit()

void ctx_exit ( Ctx ctx )

Definition at line 731 of file debug.cc.

References assert, Ctx_Current_Level, and Ctx_Valid_Level.

Referenced by HttpStateData::haveParsedReplyHeaders(), HttpStateData::processReplyHeader(), and MemObject::~MemObject().

◆ DebugStream()

FILE* DebugStream ( )

cache.log FILE or, as the last resort, stderr stream; may be nil during static initialization and destruction!

Definition at line 77 of file debug.cc.

References DebugFile::file().

◆ ForceAlert()

std::ostream& ForceAlert ( std::ostream & s )

Does not change the stream being manipulated. Exists for its side effect: In a debugs() context, forces the message to become a syslog ALERT. Outside of debugs() context, has no effect and should not be used.

Definition at line 866 of file debug.cc.

References DBG_DATA, Debug::ForceAlert(), Raw::print(), and Debug::SectionLevel().

Referenced by death(), fatal_common(), and Debug::SectionLevel().

◆ HERE()

std::ostream& HERE ( std::ostream & s )

inline

stream manipulator which does nothing.

Deprecated:: Do not add to new code, and remove when editing old code

Its purpose is to inactivate calls made following previous debugs() guidelines such as debugs(1,2, HERE << "some message");

His former objective is now absorbed in the debugs call itself

Definition at line 153 of file Debug.h.

◆ operator<<() [1/4]

std::ostream& operator<<	(	std::ostream &	os,
		const uint8_t	d
	)

inline

Definition at line 170 of file Debug.h.

References _db_init(), _db_rotate_log(), _db_set_syslog(), and logfile.

◆ operator<<() [2/4]

std::ostream& operator<<	(	std::ostream &	os,
		const Raw &	raw
	)

inline

Definition at line 222 of file Debug.h.

References Raw::print().

◆ operator<<() [3/4]

template<class Pointer >

std::ostream& operator<<	(	std::ostream &	os,
		const RawPointerT< Pointer > &	pd
	)

inline

Definition at line 248 of file Debug.h.

References RawPointerT< Pointer >::label.

◆ operator<<() [4/4]

template<class Integer >

std::ostream& operator<<	(	std::ostream &	os,
		const AsHex< Integer >	number
	)

inline

Definition at line 268 of file Debug.h.

◆ RawPointer()

template<class Pointer >

RawPointerT<Pointer> RawPointer	(	const char *	label,
		const Pointer &	ptr
	)

inline

Definition at line 240 of file Debug.h.

Referenced by Security::PeerConnector::sslCrtvdHandleReply().

◆ ResyncDebugLog()

void ResyncDebugLog ( FILE * newDestination )

Definition at line 88 of file debug.cc.

References DebugFile::file_.

Referenced by ipcCreate().

◆ StopUsingDebugLog()

void StopUsingDebugLog ( )

Definition at line 82 of file debug.cc.

References DebugFile::clear().

Referenced by sendSignal().

squid-cache.org

Optimising Web Delivery

Classes

Macros

Typedefs

Functions

Macro Definition Documentation

◆ assert

◆ DBG_CRITICAL

◆ DBG_DATA

◆ DBG_IMPORTANT

◆ DBG_PARSE_NOTE

◆ debug_log

◆ debugs

◆ MAX_DEBUG_SECTIONS

◆ MYNAME

Typedef Documentation

◆ Ctx

Function Documentation

◆ _db_init()

◆ _db_rotate_log()

◆ _db_set_syslog()

◆ asHex()

◆ ctx_enter()

◆ ctx_exit()

◆ DebugStream()

◆ ForceAlert()

◆ HERE()

◆ operator<<() [1/4]

◆ operator<<() [2/4]

◆ operator<<() [3/4]

◆ operator<<() [4/4]

◆ RawPointer()

◆ ResyncDebugLog()

◆ StopUsingDebugLog()

Introduction

Documentation

Support

Miscellaneous

Web Site Translations

Mirrors