2 * DEBUG: section 84 Helper process maintenance
3 * AUTHOR: Harvest Derived?
5 * SQUID Web Proxy Cache http://www.squid-cache.org/
6 * ----------------------------------------------------------
8 * Squid is the result of efforts by numerous individuals from
9 * the Internet community; see the CONTRIBUTORS file for full
10 * details. Many organizations have provided support for Squid's
11 * development; see the SPONSORS file for full details. Squid is
12 * Copyrighted (C) 2001 by the Regents of the University of
13 * California; see the COPYRIGHT file for full details. Squid
14 * incorporates software developed and/or copyrighted by other
15 * sources; see the CREDITS file for full details.
17 * This program is free software; you can redistribute it and/or modify
18 * it under the terms of the GNU General Public License as published by
19 * the Free Software Foundation; either version 2 of the License, or
20 * (at your option) any later version.
22 * This program is distributed in the hope that it will be useful,
23 * but WITHOUT ANY WARRANTY; without even the implied warranty of
24 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
25 * GNU General Public License for more details.
27 * You should have received a copy of the GNU General Public License
28 * along with this program; if not, write to the Free Software
29 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111, USA.
33 #ifndef SQUID_HELPER_H
34 #define SQUID_HELPER_H
36 #include "base/AsyncCall.h"
37 #include "base/InstanceId.h"
39 #include "comm/forward.h"
41 #include "HelperChildConfig.h"
42 #include "HelperReply.h"
43 #include "ip/Address.h"
47 typedef void HLPCB(void *, const HelperReply
&reply
);
52 inline helper(const char *name
) :
59 memset(&stats
, 0, sizeof(stats
));
68 HelperChildConfig childs
; ///< Configuration settings for number running.
71 time_t last_queue_warn
;
73 char eom
; ///< The char which marks the end of (response) message, normally '\n'
83 CBDATA_CLASS2(helper
);
86 class statefulhelper
: public helper
89 inline statefulhelper(const char *name
) : helper(name
), datapool(NULL
), IsAvailable(NULL
), OnEmptyQueue(NULL
) {};
90 inline ~statefulhelper() {};
93 MemAllocator
*datapool
;
94 HLPSAVAIL
*IsAvailable
;
95 HLPSONEQ
*OnEmptyQueue
;
98 CBDATA_CLASS2(statefulhelper
);
102 * Fields shared between stateless and stateful helper servers.
104 class HelperServerBase
107 /** Closes pipes to the helper safely.
108 * Handles the case where the read and write pipes are the same FD.
110 void closePipesSafely();
112 /** Closes the reading pipe.
113 * If the read and write sockets are the same the write pipe will
114 * also be closed. Otherwise its left open for later handling.
116 void closeWritePipeSafely();
119 /// Helper program identifier; does not change when contents do,
120 /// including during assignment
121 const InstanceId
<HelperServerBase
> index
;
124 Comm::ConnectionPointer readPipe
;
125 Comm::ConnectionPointer writePipe
;
132 struct timeval dispatch_time
;
133 struct timeval answer_time
;
137 struct _helper_flags
{
146 uint64_t uses
; //< requests sent to this helper
147 uint64_t replies
; //< replies received from this helper
148 uint64_t pending
; //< queued lookups waiting to be sent to this helper
149 uint64_t releases
; //< times release() has been called on this helper (if stateful)
156 class helper_server
: public HelperServerBase
163 helper_request
**requests
;
166 CBDATA_CLASS2(helper_server
);
169 class helper_stateful_request
;
171 class helper_stateful_server
: public HelperServerBase
175 /* MemBuf writebuf; */
177 statefulhelper
*parent
;
178 helper_stateful_request
*request
;
180 void *data
; /* State data used by the calling routines */
183 CBDATA_CLASS2(helper_stateful_server
);
190 MEMPROXY_CLASS(helper_request
);
195 struct timeval dispatch_time
;
198 MEMPROXY_CLASS_INLINE(helper_request
);
200 class helper_stateful_request
204 MEMPROXY_CLASS(helper_stateful_request
);
207 int placeholder
; /* if 1, this is a dummy request waiting for a stateful helper to become available */
211 MEMPROXY_CLASS_INLINE(helper_stateful_request
);
214 void helperOpenServers(helper
* hlp
);
215 void helperStatefulOpenServers(statefulhelper
* hlp
);
216 void helperSubmit(helper
* hlp
, const char *buf
, HLPCB
* callback
, void *data
);
217 void helperStatefulSubmit(statefulhelper
* hlp
, const char *buf
, HLPCB
* callback
, void *data
, helper_stateful_server
* lastserver
);
218 void helperStats(StoreEntry
* sentry
, helper
* hlp
, const char *label
= NULL
);
219 void helperStatefulStats(StoreEntry
* sentry
, statefulhelper
* hlp
, const char *label
= NULL
);
220 void helperShutdown(helper
* hlp
);
221 void helperStatefulShutdown(statefulhelper
* hlp
);
222 void helperStatefulReleaseServer(helper_stateful_server
* srv
);
223 void *helperStatefulServerGetData(helper_stateful_server
* srv
);
225 #endif /* SQUID_HELPER_H */