Annotation of win32/apache13/src/include/scoreboard.h, revision 1.1.1.1
1.1 parser 1: /* ====================================================================
2: * Copyright (c) 1995-1999 The Apache Group. All rights reserved.
3: *
4: * Redistribution and use in source and binary forms, with or without
5: * modification, are permitted provided that the following conditions
6: * are met:
7: *
8: * 1. Redistributions of source code must retain the above copyright
9: * notice, this list of conditions and the following disclaimer.
10: *
11: * 2. Redistributions in binary form must reproduce the above copyright
12: * notice, this list of conditions and the following disclaimer in
13: * the documentation and/or other materials provided with the
14: * distribution.
15: *
16: * 3. All advertising materials mentioning features or use of this
17: * software must display the following acknowledgment:
18: * "This product includes software developed by the Apache Group
19: * for use in the Apache HTTP server project (http://www.apache.org/)."
20: *
21: * 4. The names "Apache Server" and "Apache Group" must not be used to
22: * endorse or promote products derived from this software without
23: * prior written permission. For written permission, please contact
24: * apache@apache.org.
25: *
26: * 5. Products derived from this software may not be called "Apache"
27: * nor may "Apache" appear in their names without prior written
28: * permission of the Apache Group.
29: *
30: * 6. Redistributions of any form whatsoever must retain the following
31: * acknowledgment:
32: * "This product includes software developed by the Apache Group
33: * for use in the Apache HTTP server project (http://www.apache.org/)."
34: *
35: * THIS SOFTWARE IS PROVIDED BY THE APACHE GROUP ``AS IS'' AND ANY
36: * EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
37: * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
38: * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE APACHE GROUP OR
39: * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
40: * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
41: * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
42: * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
43: * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
44: * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
45: * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
46: * OF THE POSSIBILITY OF SUCH DAMAGE.
47: * ====================================================================
48: *
49: * This software consists of voluntary contributions made by many
50: * individuals on behalf of the Apache Group and was originally based
51: * on public domain software written at the National Center for
52: * Supercomputing Applications, University of Illinois, Urbana-Champaign.
53: * For more information on the Apache Group and the Apache HTTP server
54: * project, please see <http://www.apache.org/>.
55: *
56: */
57:
58: #ifndef APACHE_SCOREBOARD_H
59: #define APACHE_SCOREBOARD_H
60:
61: #ifdef __cplusplus
62: extern "C" {
63: #endif
64:
65: #ifndef WIN32
66: #if defined(TPF) || defined(NETWARE)
67: #include <time.h>
68: #else
69: #include <sys/times.h>
70: #endif /* TPF */
71: #endif
72:
73:
74: /* Scoreboard info on a process is, for now, kept very brief ---
75: * just status value and pid (the latter so that the caretaker process
76: * can properly update the scoreboard when a process dies). We may want
77: * to eventually add a separate set of long_score structures which would
78: * give, for each process, the number of requests serviced, and info on
79: * the current, or most recent, request.
80: *
81: * Status values:
82: */
83:
84: #define SERVER_DEAD 0
85: #define SERVER_STARTING 1 /* Server Starting up */
86: #define SERVER_READY 2 /* Waiting for connection (or accept() lock) */
87: #define SERVER_BUSY_READ 3 /* Reading a client request */
88: #define SERVER_BUSY_WRITE 4 /* Processing a client request */
89: #define SERVER_BUSY_KEEPALIVE 5 /* Waiting for more requests via keepalive */
90: #define SERVER_BUSY_LOG 6 /* Logging the request */
91: #define SERVER_BUSY_DNS 7 /* Looking up a hostname */
92: #define SERVER_GRACEFUL 8 /* server is gracefully finishing request */
93: #define SERVER_NUM_STATUS 9 /* number of status settings */
94:
95: /* A "virtual time" is simply a counter that indicates that a child is
96: * making progress. The parent checks up on each child, and when they have
97: * made progress it resets the last_rtime element. But when the child hasn't
98: * made progress in a time that's roughly timeout_len seconds long, it is
99: * sent a SIGALRM.
100: *
101: * vtime is an optimization that is used only when the scoreboard is in
102: * shared memory (it's not easy/feasible to do it in a scoreboard file).
103: * The essential observation is that timeouts rarely occur, the vast majority
104: * of hits finish before any timeout happens. So it really sucks to have to
105: * ask the operating system to set up and destroy alarms many times during
106: * a request.
107: */
108: typedef unsigned vtime_t;
109:
110: /* Type used for generation indicies. Startup and every restart cause a
111: * new generation of children to be spawned. Children within the same
112: * generation share the same configuration information -- pointers to stuff
113: * created at config time in the parent are valid across children. For
114: * example, the vhostrec pointer in the scoreboard below is valid in all
115: * children of the same generation.
116: *
117: * The safe way to access the vhost pointer is like this:
118: *
119: * short_score *ss = pointer to whichver slot is interesting;
120: * parent_score *ps = pointer to whichver slot is interesting;
121: * server_rec *vh = ss->vhostrec;
122: *
123: * if (ps->generation != ap_my_generation) {
124: * vh = NULL;
125: * }
126: *
127: * then if vh is not NULL it's valid in this child.
128: *
129: * This avoids various race conditions around restarts.
130: */
131: typedef int ap_generation_t;
132:
133: /* stuff which the children generally write, and the parent mainly reads */
134: typedef struct {
135: #ifdef OPTIMIZE_TIMEOUTS
136: vtime_t cur_vtime; /* the child's current vtime */
137: unsigned short timeout_len; /* length of the timeout */
138: #endif
139: unsigned char status;
140: unsigned long access_count;
141: unsigned long bytes_served;
142: unsigned long my_access_count;
143: unsigned long my_bytes_served;
144: unsigned long conn_bytes;
145: unsigned short conn_count;
146: #if defined(NO_GETTIMEOFDAY)
147: clock_t start_time;
148: clock_t stop_time;
149: #else
150: struct timeval start_time;
151: struct timeval stop_time;
152: #endif
153: #ifndef NO_TIMES
154: struct tms times;
155: #endif
156: #ifndef OPTIMIZE_TIMEOUTS
157: time_t last_used;
158: #endif
159: char client[32]; /* Keep 'em small... */
160: char request[64]; /* We just want an idea... */
161: server_rec *vhostrec; /* What virtual host is being accessed? */
162: /* SEE ABOVE FOR SAFE USAGE! */
163: } short_score;
164:
165: typedef struct {
166: ap_generation_t running_generation; /* the generation of children which
167: * should still be serving requests. */
168: } global_score;
169:
170: /* stuff which the parent generally writes and the children rarely read */
171: typedef struct {
172: pid_t pid;
173: #ifdef OPTIMIZE_TIMEOUTS
174: time_t last_rtime; /* time(0) of the last change */
175: vtime_t last_vtime; /* the last vtime the parent has seen */
176: #endif
177: ap_generation_t generation; /* generation of this child */
178: } parent_score;
179:
180: typedef struct {
181: short_score servers[HARD_SERVER_LIMIT];
182: parent_score parent[HARD_SERVER_LIMIT];
183: global_score global;
184: } scoreboard;
185:
186: #define SCOREBOARD_SIZE sizeof(scoreboard)
187: #ifdef TPF
188: #define SCOREBOARD_NAME "SCOREBRD"
189: #define SCOREBOARD_FRAMES SCOREBOARD_SIZE/4095 + 1
190: #endif
191:
192: API_EXPORT(void) ap_sync_scoreboard_image(void);
193: API_EXPORT(int) ap_exists_scoreboard_image(void);
194:
195: API_VAR_EXPORT extern scoreboard *ap_scoreboard_image;
196:
197: API_VAR_EXPORT extern ap_generation_t volatile ap_my_generation;
198:
199: /* for time_process_request() in http_main.c */
200: #define START_PREQUEST 1
201: #define STOP_PREQUEST 2
202:
203: #ifdef __cplusplus
204: }
205: #endif
206:
207: #endif /* !APACHE_SCOREBOARD_H */
E-mail:
![[BACK]](/cvsweb/icons/back.gif){kind=icon}
Return to scoreboard.h CVS log ![[TXT]](/cvsweb/icons/text.gif){kind=icon}
![[DIR]](/cvsweb/icons/dir.gif){kind=icon}
Up to [parser3project] / win32 / apache13 / src / include