tools.h
Go to the documentation of this file.
1 /*
2  * Copyright (C) 1996-2023 The Squid Software Foundation and contributors
3  *
4  * Squid software is distributed under GPLv2+ license and includes
5  * contributions from numerous individuals and organizations.
6  * Please see the COPYING and CONTRIBUTORS files for details.
7  */
8 
9 /* DEBUG: section 21 Misc Functions */
10 
11 #ifndef SQUID_SRC_TOOLS_H
12 #define SQUID_SRC_TOOLS_H
13 
14 #include "sbuf/SBuf.h"
15 #include "typedefs.h"
16 
17 class MemBuf;
18 
19 extern int DebugSignal;
20 
23 extern SBuf service_name;
24 
25 void parseEtcHosts(void);
26 int getMyPort(void);
27 void setUmask(mode_t mask);
28 void strwordquote(MemBuf * mb, const char *str);
29 
30 class Packable;
31 
32 /* a common objPackInto interface; used by debugObj */
33 typedef void (*ObjPackMethod) (void *obj, Packable * p);
34 
35 /* packs, then prints an object using debugs() */
36 void debugObj(int section, int level, const char *label, void *obj, ObjPackMethod pm);
37 
39 typedef void SIGHDLR(int sig);
40 
41 const char *getMyHostname(void);
42 const char *uniqueHostname(void);
43 
44 void death(int sig);
45 void sigusr2_handle(int sig);
46 void sig_child(int sig);
47 void sig_shutdown(int sig);
48 void leave_suid(void);
49 void enter_suid(void);
50 void no_suid(void);
51 void setMaxFD(void);
52 void setSystemLimits(void);
53 void squid_signal(int sig, SIGHDLR *, int flags);
54 void keepCapabilities(void);
55 void BroadcastSignalIfAny(int& sig);
56 
58 bool IamMasterProcess();
63 bool IamPrimaryProcess();
67 bool IamWorkerProcess();
69 bool IamDiskProcess();
71 bool InDaemonMode(); // try using specific Iam*() checks above first
73 bool UsingSmp(); // try using specific Iam*() checks above first
75 int NumberOfKids();
78 
79 void debug_trap(const char *);
80 
81 void logsFlush(void);
82 
83 void squid_getrusage(struct rusage *r);
84 double rusage_cputime(struct rusage *r);
85 int rusage_maxrss(struct rusage *r);
86 int rusage_pagefaults(struct rusage *r);
87 void releaseServerSockets(void);
88 void PrintRusage(void);
89 void dumpMallocStats(void);
90 
91 typedef int PidStatus;
92 
99 pid_t WaitForOnePid(pid_t pid, PidStatus &status, int flags);
100 
107 inline pid_t WaitForAnyPid(PidStatus &status, int flags)
108 {
109  return WaitForOnePid(-1, status, flags);
110 }
111 
112 #if _SQUID_WINDOWS_ || _SQUID_MINGW_
113 SBuf WindowsErrorMessage(DWORD errorId);
115 #endif // _SQUID_WINDOWS_ || _SQUID_MINGW_
116 
117 #endif /* SQUID_SRC_TOOLS_H */
118 
void PrintRusage(void)
Definition: tools.cc:329
bool InDaemonMode()
Whether we are running in daemon mode.
Definition: tools.cc:690
void SIGHDLR(int sig)
callback type for signal handlers
Definition: tools.h:39
void setSystemLimits(void)
Definition: tools.cc:811
const char * getMyHostname(void)
Definition: tools.cc:467
int rusage_maxrss(struct rusage *r)
Definition: tools.cc:253
void setMaxFD(void)
Definition: tools.cc:762
void debugObj(int section, int level, const char *label, void *obj, ObjPackMethod pm)
Definition: tools.cc:938
void squid_getrusage(struct rusage *r)
Definition: tools.cc:180
void setUmask(mode_t mask)
Definition: tools.cc:1069
SBuf service_name
Definition: SBuf.h:93
void debug_trap(const char *)
Definition: tools.cc:458
int getMyPort(void)
Definition: tools.cc:1041
bool IamCoordinatorProcess()
whether the current process coordinates worker processes
Definition: tools.cc:702
double rusage_cputime(struct rusage *r)
Definition: tools.cc:238
void no_suid(void)
Definition: tools.cc:646
void releaseServerSockets(void)
Definition: tools.cc:92
const char * uniqueHostname(void)
Definition: tools.cc:547
static pid_t pid
Definition: IcmpSquid.cc:34
void BroadcastSignalIfAny(int &sig)
Definition: tools.cc:418
void(* ObjPackMethod)(void *obj, Packable *p)
Definition: tools.h:33
void enter_suid(void)
Definition: tools.cc:623
Definition: MemBuf.h:23
void sig_shutdown(int sig)
handles shutdown notifications from kids
void sig_child(int sig)
Definition: main.cc:768
void leave_suid(void)
Definition: tools.cc:559
bool IamPrimaryProcess()
Definition: tools.cc:708
void parseEtcHosts(void)
Definition: tools.cc:949
int DebugSignal
Definition: stub_tools.cc:16
void death(int sig)
Definition: tools.cc:345
pid_t WaitForAnyPid(PidStatus &status, int flags)
Definition: tools.h:107
pid_t WaitForOnePid(pid_t pid, PidStatus &status, int flags)
Definition: tools.cc:1180
bool UsingSmp()
Whether there should be more than one worker process running.
Definition: tools.cc:696
void dumpMallocStats(void)
Definition: tools.cc:166
void keepCapabilities(void)
Definition: tools.cc:1122
bool IamMasterProcess()
whether the current process is the parent of all other Squid processes
Definition: tools.cc:668
int PidStatus
Definition: tools.h:91
unsigned short mode_t
Definition: types.h:129
int rusage_pagefaults(struct rusage *r)
Definition: tools.cc:274
int NumberOfKids()
number of Kid processes as defined in src/ipc/Kid.h
Definition: tools.cc:724
SBuf ProcessRoles()
a string describing this process roles such as worker or coordinator
Definition: tools.cc:739
bool IamDiskProcess()
whether the current process is dedicated to managing a cache_dir
Definition: tools.cc:684
void strwordquote(MemBuf *mb, const char *str)
Definition: tools.cc:1080
void squid_signal(int sig, SIGHDLR *, int flags)
Definition: tools.cc:873
bool IamWorkerProcess()
whether the current process handles HTTP transactions and such
Definition: stub_tools.cc:47
void logsFlush(void)
Definition: tools.cc:931
void sigusr2_handle(int sig)
Definition: tools.cc:433

 

Introduction

Documentation

Support

Miscellaneous