Provides test code access to CacheManager internal symbols. More...

Inheritance diagram for CacheManagerInternals:

Collaboration diagram for CacheManagerInternals:

[legend]

Public Types
typedef std::vector< Mgr::ActionProfilePointer >	Menu

Public Member Functions
void	testValidUrl (const AnyP::Uri &)
	checks CacheManager parsing of the given valid URL More...

void	testInvalidUrl (const AnyP::Uri &, const char *problem)

void	registerProfile (char const action, char const desc, OBJH *handler, int pw_req_flag, int atomic)

void	registerProfile (char const action, char const desc, Mgr::ClassActionCreationHandler *handler, int pw_req_flag, int atomic)

Mgr::ActionProfilePointer	findAction (char const *action) const

Mgr::Action::Pointer	createNamedAction (const char *actionName)

Mgr::Action::Pointer	createRequestedAction (const Mgr::ActionParams &)

const Menu &	menu () const

void	start (const Comm::ConnectionPointer &client, HttpRequest request, StoreEntry entry, const AccessLogEntryPointer &ale)

const char *	ActionProtection (const Mgr::ActionProfilePointer &profile)

Static Public Member Functions
static const SBuf &	WellKnownUrlPathPrefix ()
	initial URL path characters that identify cache manager requests More...

static CacheManager *	GetInstance ()

static void	PutCommonResponseHeaders (HttpReply &, const char *httpOrigin)

Protected Member Functions
void	registerProfile (const Mgr::ActionProfilePointer &profile)
	Registers new profiles, ignoring attempts to register a duplicate. More...

Mgr::CommandPointer	ParseUrl (const AnyP::Uri &)

void	ParseHeaders (const HttpRequest *request, Mgr::ActionParams &params)

int	CheckPassword (const Mgr::Command &cmd)

char *	PasswdGet (Mgr::ActionPasswordList , const char )

Protected Attributes
Menu	menu_

Detailed Description

Definition at line 39 of file testCacheManager.cc.

Member Typedef Documentation

◆ Menu

typedef std::vector<Mgr::ActionProfilePointer> CacheManager::Menu

inherited

Definition at line 35 of file CacheManager.h.

Member Function Documentation

◆ ActionProtection()

const char * CacheManager::ActionProtection ( const Mgr::ActionProfilePointer & profile )

inherited

Definition at line 409 of file cache_manager.cc.

References assert, Config, SquidConfig::passwd_list, and CacheManager::PasswdGet().

Referenced by Mgr::MenuAction::dump(), and CacheManager::ParseUrl().

◆ CheckPassword()

int CacheManager::CheckPassword ( const Mgr::Command & cmd )

protectedinherited

Return values

0	if mgr->password is good or "none"
1	if mgr->password is "disable"
!0	if mgr->password does not match configured password

Definition at line 265 of file cache_manager.cc.

References action(), assert, Config, debugs, Mgr::Command::params, SquidConfig::passwd_list, CacheManager::PasswdGet(), Mgr::ActionParams::password, Mgr::Command::profile, and String::size().

Referenced by CacheManager::start().

◆ createNamedAction()

Mgr::Action::Pointer CacheManager::createNamedAction ( const char * actionName )

inherited

Definition at line 133 of file cache_manager.cc.

References CacheManager::findAction(), and Must.

Referenced by Mgr::Response::Response(), and TestCacheManager::testRegister().

◆ createRequestedAction()

Mgr::Action::Pointer CacheManager::createRequestedAction ( const Mgr::ActionParams & params )

inherited

Definition at line 146 of file cache_manager.cc.

References Mgr::ActionParams::actionName, CacheManager::findAction(), Must, and String::termedBuf().

Referenced by Ipc::Coordinator::handleCacheMgrRequest(), and Ipc::Strand::handleCacheMgrRequest().

◆ findAction()

Mgr::ActionProfile::Pointer CacheManager::findAction ( char const * action ) const

inherited

Locates an action in the actions registry ActionsList.

Return values

NULL	if Action not found
CacheManagerAction*	if the action was found

Definition at line 115 of file cache_manager.cc.

References action(), debugs, CacheManager::menu_, and Must.

Referenced by CacheManager::createNamedAction(), CacheManager::createRequestedAction(), CacheManager::ParseUrl(), and CacheManager::registerProfile().

◆ GetInstance()

CacheManager * CacheManager::GetInstance ( )

staticinherited

Definition at line 472 of file cache_manager.cc.

References CacheManager::CacheManager(), debugs, instance, and Mgr::RegisterBasics().

Referenced by Mgr::Response::Response(), Mgr::MenuAction::dump(), Ipc::Coordinator::handleCacheMgrRequest(), Ipc::Strand::handleCacheMgrRequest(), internalStart(), Mgr::RegisterAction(), TestCacheManager::testCreate(), TestCacheManager::testParseUrl(), and TestCacheManager::testRegister().

◆ menu()

const Menu & CacheManager::menu ( ) const

inlineinherited

Definition at line 49 of file CacheManager.h.

References CacheManager::menu_.

Referenced by Mgr::MenuAction::dump().

◆ ParseHeaders()

void CacheManager::ParseHeaders	(	const HttpRequest *	request,
		Mgr::ActionParams &	params
	)

protectedinherited

Definition at line 225 of file cache_manager.cc.

References assert, Http::AUTHORIZATION, DBG_IMPORTANT, debugs, HttpRequest::flags, HttpHeader::getAuthToken(), Http::Message::header, Mgr::ActionParams::httpFlags, Mgr::ActionParams::httpMethod, HttpRequestMethod::id(), HttpRequest::method, SBuf::npos, Mgr::ActionParams::password, SBufToString(), and Mgr::ActionParams::userName.

Referenced by CacheManager::start().

◆ ParseUrl()

Mgr::Command::Pointer CacheManager::ParseUrl ( const AnyP::Uri & uri )

protectedinherited

Parses the action requested by the user and checks via CacheManager::ActionProtection() that the item is accessible by the user.

Syntax:

[ scheme "://" authority ] '/squid-internal-mgr' path-absolute [ "?" query ] [ "#" fragment ]

see RFC 3986 for definitions of scheme, authority, path-absolute, query

Returns: Mgr::Command object with action to perform and parameters it might use

Definition at line 175 of file cache_manager.cc.

References AnyP::Uri::absolute(), action(), CacheManager::ActionProtection(), Assure, CharacterSet::complement(), debugs, CacheManager::findAction(), Here, AnyP::Uri::host(), Mgr::QueryParams::Parse(), AnyP::Uri::path(), SBufToString(), ToSBuf(), and CacheManager::WellKnownUrlPathPrefix().

Referenced by CacheManager::start(), testInvalidUrl(), and testValidUrl().

◆ PasswdGet()

char * CacheManager::PasswdGet	(	Mgr::ActionPasswordList *	a,
		const char *	action
	)

protectedinherited

Definition at line 432 of file cache_manager.cc.

References action(), Mgr::ActionPasswordList::actions, Mgr::ActionPasswordList::next, and Mgr::ActionPasswordList::passwd.

Referenced by CacheManager::ActionProtection(), and CacheManager::CheckPassword().

◆ PutCommonResponseHeaders()

void CacheManager::PutCommonResponseHeaders	(	HttpReply &	response,
		const char *	httpOrigin
	)

staticinherited

Add HTTP response headers specific/common to all cache manager replies, including cache manager errors and Action reports.

Parameters

httpOrigin the value of Origin header in the trigger HTTP request (or nil)

Definition at line 451 of file cache_manager.cc.

References Http::Message::header, HttpHdrCc::noCache(), HttpHdrCc::noStore(), Http::Message::putCc(), and HttpHeader::putExt().

Referenced by Mgr::Action::fillEntry(), Mgr::Inquirer::start(), and CacheManager::start().

◆ registerProfile() [1/3]

void CacheManager::registerProfile	(	char const *	action,
		char const *	desc,
		Mgr::ClassActionCreationHandler *	handler,
		int	pw_req_flag,
		int	atomic
	)

inherited

◆ registerProfile() [2/3]

void CacheManager::registerProfile	(	char const *	action,
		char const *	desc,
		OBJH *	handler,
		int	pw_req_flag,
		int	atomic
	)

inherited

Registers a C-style action, which is implemented as a pointer to a function taking as argument a pointer to a StoreEntry and returning void. Implemented via CacheManagerActionLegacy.

Definition at line 84 of file cache_manager.cc.

References action(), debugs, handler(), and CacheManager::registerProfile().

Referenced by Mgr::RegisterAction(), CacheManager::registerProfile(), and TestCacheManager::testRegister().

◆ registerProfile() [3/3]

void CacheManager::registerProfile ( const Mgr::ActionProfilePointer & profile )

protectedinherited

Definition at line 66 of file cache_manager.cc.

References debugs, CacheManager::findAction(), CacheManager::menu_, and Must.

◆ start()

void CacheManager::start	(	const Comm::ConnectionPointer &	client,
		HttpRequest *	request,
		StoreEntry *	entry,
		const AccessLogEntryPointer &	ale
	)

inherited

Main entry point in the Cache Manager's activity. Gets called as part of the forward chain if the right URL is detected there. Initiates all needed internal work and renders the response.

Definition at line 295 of file cache_manager.cc.

References action(), HttpReply::body, ErrorState::BuildHttpReply(), CacheManager::CheckPassword(), StoreEntry::complete(), HttpBody::content(), CurrentException(), DBG_IMPORTANT, debugs, ERR_CACHE_MGR_ACCESS_DENIED, ERR_INVALID_URL, errorAppendEntry(), StoreEntry::expires, HttpHeader::getStr(), HttpHeader::has(), Http::Message::header, Here, IamWorkerProcess(), MGR_INDEX, Must, Http::ORIGIN, CacheManager::ParseHeaders(), CacheManager::ParseUrl(), Http::ProtocolVersion(), HttpHeader::putAuth(), CacheManager::PutCommonResponseHeaders(), StoreEntry::replaceHttpReply(), Http::scNotFound, Http::scOkay, Http::scUnauthorized, Http::StatusLine::set(), HttpReply::sline, squid_curtime, AsyncJob::Start(), ErrorState::url, HttpRequest::url, StoreEntry::url(), UsingSmp(), and xstrdup.

Referenced by internalStart().

◆ testInvalidUrl()

void CacheManagerInternals::testInvalidUrl	(	const AnyP::Uri &	url,
		const char *	problem
	)

checks CacheManager parsing of the given invalid URL

Parameters

problem a bad part of the URL or its description

Definition at line 63 of file testCacheManager.cc.

References Debug::Extra(), and CacheManager::ParseUrl().

◆ testValidUrl()

void CacheManagerInternals::testValidUrl ( const AnyP::Uri & url )

Definition at line 51 of file testCacheManager.cc.

References CurrentException(), Debug::Extra(), and CacheManager::ParseUrl().

◆ WellKnownUrlPathPrefix()

const SBuf & CacheManager::WellKnownUrlPathPrefix ( )

staticinherited

Definition at line 156 of file cache_manager.cc.

Referenced by ForSomeCacheManager(), CacheManager::ParseUrl(), and TestCacheManager::testParseUrl().

Member Data Documentation

◆ menu_

Menu CacheManager::menu_

protectedinherited

Definition at line 71 of file CacheManager.h.

Referenced by CacheManager::findAction(), CacheManager::menu(), and CacheManager::registerProfile().

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

src/tests/testCacheManager.cc

squid-cache.org

Optimising Web Delivery

Public Types

Public Member Functions

Static Public Member Functions

Protected Member Functions

Protected Attributes

Detailed Description

Member Typedef Documentation

◆ Menu

Member Function Documentation

◆ ActionProtection()

◆ CheckPassword()

◆ createNamedAction()

◆ createRequestedAction()

◆ findAction()

◆ GetInstance()

◆ menu()

◆ ParseHeaders()

◆ ParseUrl()

◆ PasswdGet()

◆ PutCommonResponseHeaders()

◆ registerProfile() [1/3]

◆ registerProfile() [2/3]

◆ registerProfile() [3/3]

◆ start()

◆ testInvalidUrl()

◆ testValidUrl()

◆ WellKnownUrlPathPrefix()

Member Data Documentation

◆ menu_

Introduction

Documentation

Support

Miscellaneous

Web Site Translations

Mirrors