tools.h

Go to the documentation of this file.

/*
 * Copyright (C) 1996-2025 The Squid Software Foundation and contributors
 *
 * Squid software is distributed under GPLv2+ license and includes
 * contributions from numerous individuals and organizations.
 * Please see the COPYING and CONTRIBUTORS files for details.
 */
 
/* DEBUG: section 21    Misc Functions */
 
#ifndef SQUID_SRC_TOOLS_H
#define SQUID_SRC_TOOLS_H
 
#include "sbuf/SBuf.h"
#include "typedefs.h"
 
class MemBuf;
 
extern int DebugSignal;
 
extern SBuf service_name;
 
void parseEtcHosts(void);
int getMyPort(void);
void setUmask(mode_t mask);
void strwordquote(MemBuf * mb, const char *str);
 
class Packable;
 
/* a common objPackInto interface; used by debugObj */
typedef void (*ObjPackMethod) (void *obj, Packable * p);
 
/* packs, then prints an object using debugs() */
void debugObj(int section, int level, const char *label, void *obj, ObjPackMethod pm);
 
typedef void SIGHDLR(int sig);
 
const char *getMyHostname(void);
const char *uniqueHostname(void);
 
void death(int sig);
void sigusr2_handle(int sig);
void sig_child(int sig);
void sig_shutdown(int sig); 
void leave_suid(void);
void enter_suid(void);
void no_suid(void);
void setMaxFD(void);
void setSystemLimits(void);
void squid_signal(int sig, SIGHDLR *, int flags);
void keepCapabilities(void);
void BroadcastSignalIfAny(int& sig);
 
bool IamMasterProcess();
bool IamPrimaryProcess();
bool IamCoordinatorProcess();
bool IamWorkerProcess();
bool IamDiskProcess();
bool InDaemonMode(); // try using specific Iam*() checks above first
bool UsingSmp(); // try using specific Iam*() checks above first
int NumberOfKids();
SBuf ProcessRoles();
 
void debug_trap(const char *);
 
void logsFlush(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 releaseServerSockets(void);
void PrintRusage(void);
void dumpMallocStats(void);
 
typedef int PidStatus;
 
pid_t WaitForOnePid(pid_t pid, PidStatus &status, int flags);
 
inline pid_t WaitForAnyPid(PidStatus &status, int flags)
{
    return WaitForOnePid(-1, status, flags);
}
 
#if _SQUID_WINDOWS_ || _SQUID_MINGW_
SBuf WindowsErrorMessage(DWORD errorId);
#endif // _SQUID_WINDOWS_ || _SQUID_MINGW_
 
#endif /* SQUID_SRC_TOOLS_H */