#include "squid.h"
#include "anyp/PortCfg.h"
#include "base/Subscription.h"
#include "client_side.h"
#include "fatal.h"
#include "fde.h"
#include "fqdncache.h"
#include "fs_io.h"
#include "htcp.h"
#include "http/Stream.h"
#include "ICP.h"
#include "ip/Intercept.h"
#include "ip/QosConfig.h"
#include "ipc/Coordinator.h"
#include "ipc/Kids.h"
#include "ipcache.h"
#include "MemBuf.h"
#include "sbuf/Stream.h"
#include "SquidConfig.h"
#include "SquidMath.h"
#include "SquidTime.h"
#include "store/Disks.h"
#include "tools.h"
#include "wordlist.h"
#include <cerrno>

Include dependency graph for tools.cc:

Macros
#define	DEAD_MSG "\The Squid Cache (version %s) died.\n\\n\You've encountered a fatal error in the Squid Cache version %s.\n\If a core file was created (possibly in the swap directory),\n\please execute 'gdb squid core' or 'dbx squid core', then type 'where',\n\and report the trace back to squid-bugs@lists.squid-cache.org.\n\\n\Thanks!\n"

#define	HAVE_GETPAGESIZE 0

Functions
static void	mail_warranty (void)

static void	restoreCapabilities (bool keep)

void	releaseServerSockets (void)

static char *	dead_msg (void)

void	dumpMallocStats (void)

void	squid_getrusage (struct rusage *r)

double	rusage_cputime (struct rusage *r)

int	rusage_maxrss (struct rusage *r)

int	rusage_pagefaults (struct rusage *r)

void	PrintRusage (void)

void	death (int sig)

void	BroadcastSignalIfAny (int &sig)

void	sigusr2_handle (int sig)

void	debug_trap (const char *message)

const char *	getMyHostname (void)

const char *	uniqueHostname (void)

void	leave_suid (void)

void	enter_suid (void)

void	no_suid (void)

bool	IamMasterProcess ()
	whether the current process is the parent of all other Squid processes More...

bool	IamWorkerProcess ()
	whether the current process handles HTTP transactions and such More...

bool	IamDiskProcess ()
	whether the current process is dedicated to managing a cache_dir More...

bool	InDaemonMode ()
	Whether we are running in daemon mode. More...

bool	UsingSmp ()
	Whether there should be more than one worker process running. More...

bool	IamCoordinatorProcess ()
	whether the current process coordinates worker processes More...

bool	IamPrimaryProcess ()

int	NumberOfKids ()
	number of Kid processes as defined in src/ipc/Kid.h More...

SBuf	ProcessRoles ()
	a string describing this process roles such as worker or coordinator More...

void	setMaxFD (void)

void	setSystemLimits (void)

void	squid_signal (int sig, SIGHDLR *func, int flags)

void	logsFlush (void)

void	debugObj (int section, int level, const char label, void obj, ObjPackMethod pm)

void	parseEtcHosts (void)

int	getMyPort (void)

void	setUmask (mode_t mask)

void	strwordquote (MemBuf mb, const char str)

void	keepCapabilities (void)

pid_t	WaitForOnePid (pid_t pid, PidStatus &status, int flags)

Variables
int	DebugSignal = -1

SBuf	service_name (APP_SHORTNAME)

Macro Definition Documentation

◆ DEAD_MSG

#define DEAD_MSG "\The Squid Cache (version %s) died.\n\\n\You've encountered a fatal error in the Squid Cache version %s.\n\If a core file was created (possibly in the swap directory),\n\please execute 'gdb squid core' or 'dbx squid core', then type 'where',\n\and report the trace back to squid-bugs@lists.squid-cache.org.\n\\n\Thanks!\n"

Definition at line 53 of file tools.cc.

Referenced by dead_msg().

◆ HAVE_GETPAGESIZE

#define HAVE_GETPAGESIZE 0

Definition at line 238 of file tools.cc.

Function Documentation

◆ BroadcastSignalIfAny()

void BroadcastSignalIfAny ( int & sig )

Definition at line 363 of file tools.cc.

References Kids::count(), Kids::get(), i, IamMasterProcess(), and TheKids.

Referenced by masterCheckAndBroadcastSignals().

◆ dead_msg()

static char* dead_msg ( void )

static

Definition at line 97 of file tools.cc.

References DEAD_MSG, LOCAL_ARRAY, and version_string.

Referenced by death(), and mail_warranty().

◆ death()

void death ( int sig )

Definition at line 291 of file tools.cc.

Referenced by mainInitialize().

◆ debug_trap()

void debug_trap ( const char * message )

Definition at line 403 of file tools.cc.

References DBG_CRITICAL, debugs, fatal_dump(), and opt_catch_signals.

Referenced by EventScheduler::cancel(), clientdbEstablished(), clientdbUpdate(), neighborsUdpAck(), netdbHashDelete(), and unlinkdUnlink().

◆ debugObj()

void debugObj	(	int	section,
		int	level,
		const char *	label,
		void *	obj,
		ObjPackMethod	pm
	)

Definition at line 900 of file tools.cc.

References assert, MemBuf::buf, MemBuf::clean(), debugs, and MemBuf::init().

Referenced by clientInterpretRequestHeaders(), and internalStart().

◆ dumpMallocStats()

void dumpMallocStats ( void )

Definition at line 156 of file tools.cc.

References debug_log, and Math::intPercent().

Referenced by death(), fatal_common(), and SquidShutdown().

◆ enter_suid()

void enter_suid ( void )

Definition at line 575 of file tools.cc.

References Config, SquidConfig::coredump_dir, debugs, and xstrerr().

Referenced by comm_set_transparent(), htcpOpenPorts(), icpOpenPorts(), Ip::Intercept::IpfInterception(), mainReconfigureFinish(), File::open(), Ipc::Coordinator::openListenSocket(), parseConfigFileOrThrow(), Ip::Intercept::ProbeForTproxy(), RemoveInstance(), squid_getrusage(), SquidMain(), Ipc::StartListening(), and watch_child().

◆ getMyHostname()

const char* getMyHostname ( void )

◆ getMyPort()

int getMyPort ( void )

Definition at line 1003 of file tools.cc.

References DBG_CRITICAL, debugs, FtpPortList, HttpPortList, NULL, and p.

Referenced by clientReplyContext::buildReplyHeader(), clientProcessRequest(), ErrorState::compileLegacyCode(), internalLocalUri(), and send_announce().

◆ IamCoordinatorProcess()

bool IamCoordinatorProcess ( )

Definition at line 664 of file tools.cc.

References pkCoordinator, and TheProcessKind.

Referenced by IamPrimaryProcess(), IamWorkerProcess(), ProcessRoles(), and SquidMain().

◆ IamDiskProcess()

bool IamDiskProcess ( )

Definition at line 646 of file tools.cc.

References pkDisker, and TheProcessKind.

Referenced by ProcessRoles().

◆ IamMasterProcess()

bool IamMasterProcess ( )

Definition at line 630 of file tools.cc.

References KidIdentifier.

Referenced by BroadcastSignalIfAny(), SignalEngine::doShutdown(), ProcessRoles(), SquidMain(), and Ipc::Mem::RegisteredRunner::useConfig().

◆ IamPrimaryProcess()

bool IamPrimaryProcess ( )

whether the current process is dedicated to doing things that only a single process should do, such as PID file maintenance and WCCP

Definition at line 670 of file tools.cc.

References Config, IamCoordinatorProcess(), IamWorkerProcess(), NumberOfKids(), opt_no_daemon, and SquidConfig::workers.

Referenced by Mgr::InfoAction::dump(), IamWorkerProcess(), mainInitialize(), mainReconfigureFinish(), serverConnectionsClose(), serverConnectionsOpen(), and SquidMain().

◆ IamWorkerProcess()

bool IamWorkerProcess ( )

Definition at line 636 of file tools.cc.

References Config, IamCoordinatorProcess(), IamDiskProcess(), IamPrimaryProcess(), InDaemonMode(), logsFlush(), NumberOfKids(), opt_no_daemon, pkWorker, setMaxFD(), setSystemLimits(), squid_signal(), STUB, STUB_RETVAL, STUB_RETVAL_NOP, TheProcessKind, UsingSmp(), and SquidConfig::workers.

Referenced by IamPrimaryProcess(), and ProcessRoles().

◆ InDaemonMode()

bool InDaemonMode ( )

Definition at line 652 of file tools.cc.

References Config, opt_no_daemon, and SquidConfig::workers.

Referenced by configDoConfigure(), CpuAffinityCheck(), CpuAffinityInit(), IamWorkerProcess(), Rock::SwapDir::needsDiskStrand(), NumberOfKids(), SquidMain(), Ipc::Mem::RegisteredRunner::useConfig(), and UsingSmp().

◆ keepCapabilities()

void keepCapabilities ( void )

Definition at line 1084 of file tools.cc.

References Ip::Interceptor, and Ip::Intercept::StopTransparency().

◆ leave_suid()

void leave_suid ( void )

leave a priviliged section. (Give up any privilegies) Routines that need privilegies can rap themselves in enter_suid() and leave_suid() To give upp all posibilites to gain privilegies use no_suid()

Definition at line 504 of file tools.cc.

References Config, Config2, SquidConfig::coredump_dir, DBG_CRITICAL, debugs, SquidConfig::effectiveGroup, SquidConfig2::effectiveGroupID, SquidConfig::effectiveUser, SquidConfig2::effectiveUserID, fatalf(), initgroups(), NULL, restoreCapabilities(), and xstrerr().